• Fixed #221 - include missing file

What's Changed

• [Breaking] Trusted endpoints - by default kusto will only connect to trusted endpoints
• Closeable clients, you can now free resources when you are done with a client
• Added Ignorefirstrecord ingestion property
• Quick start improvements
• Bump parse-url from 7.0.2 to 8.1.0

-Fixed bug with using the moment library that caused ingestion resources not to refresh.

• Version 3.4.0 introduced a bug that caused the wrong client id to be sent in Managed Identity scenarios. This version fixes it, and the old version is deprecated.

New

• Sample app - Bundled app to see and understand how ADX works

Fixes

• Better gz temp file creation, ensure deletion when it's done
• Fixed Userprompt not working when ran two times in a row
• Change default authority to "organizations", should solve some authentication issues
• Fixed issue of resources not being parsed correctly in other clouds
• Fixed issue of "unknown authorities" for authentiation"
• Updated dependencies to avoid security issues

New Contributors

• @ronmonetaMicro made their first contribution in https://github.com/Azure/azure-kusto-node/pull/197

Full Changelog: https://github.com/Azure/azure-kusto-node/compare/v3.3.2...v3.4.0

What's Changed

• Use retry mechanism on potentially throttled operations. by @alonadam in https://github.com/Azure/azure-kusto-node/pull/189
• Improve url parsing - supporting trailing slashes and port numbers by @AsafMah in https://github.com/Azure/azure-kusto-node/pull/190
• Fixed ToJSON accidental mutation, causing servertimeout to be wrong by @AsafMah in https://github.com/Azure/azure-kusto-node/pull/191

New Contributors

• @alonadam made their first contribution in https://github.com/Azure/azure-kusto-node/pull/189

Full Changelog: https://github.com/Azure/azure-kusto-node/compare/v3.3.1...v3.3.2

• Fixed bug in the package-lock.json file that caused the dependencies to be wrong.

What's Changed

• Moving to lerna - using lerna we are able to synchronize our dependcies and avoid issues like #185 and #184.
  As a consequence, both packages (azure-kusto-data and azure-kusto-ingest) had been relocated to the "packages" directory,
  And to bootstrap the project the command to run is now npx lerna bootstrap --hoist.
  See README.md and CONTRIBUTING.md for more information.

Full Changelog: https://github.com/Azure/azure-kusto-node/compare/v3.2.0...v3.3.0

What's Changed

• Fixed queries for newer kusto versions (the http datatype has become more strict)
• Added support for Inital Catalog/ Default Database by @AsafMah in https://github.com/Azure/azure-kusto-node/pull/180
• Fixed security warning by @AsafMah in https://github.com/Azure/azure-kusto-node/pull/182
• Documentation improvements - @seank-com

New Contributors

• @seank-com made their first contribution in https://github.com/Azure/azure-kusto-node/pull/173

Full Changelog: https://github.com/Azure/azure-kusto-node/compare/v3.1.0...v3.2.0

Features

• IngestionProperties accepting methods have been relaxed, and can now accept any object that adheres to the interface, and not just the specific class.
• WithConstant constructors can now accept any non-null non-undefined type as the constant, using their toString method.

Fixes

• Fixed bug that caused the wrong props to pass to ingest, if not providing a format when ingesting but do providing it as a default.
• Fixed bug that cause the wrong props to pass to managed streaming ingest.

Breaking Changes

• The minimum node.js version was bumped from 8 to 14, the earliest version still under support.
  This was required from dependent packages in order to keep up-to-date with security patches.
• Stricter checks on formats and mapping types. If your code breaks due to this, you had a bug. Includes providing a incompatible formats to the mappings or providing more than one type of mapping.
• IngestionProperties properties can no longer be null- they can now be their value, or undefined
• Added an option to create a Connection String without auth, to align with the other sdks.
  Before, not providing any auth defaulted to Device Code, now it will default to no auth.
• Device Code Login now requires useDeviceCodeAuth to be true. withAadDeviceAuthentication sets it automatically.
• Added the AAD Federated Security property to all With* methods of KustoConnectionStringBuilder by default. It's possible to turn off by setting the property aadFederatedSecurity to undefined.
• Renaming some of the properties in KustoConnectionStringBuilder, if you used the WithX methods there is nothing to change:
  • managedIdentity -> useManagedIdentityAuth
  • azLoginIdentity -> useAzLoginAuth
• Column Mappings now live in "./source/columnMappings". This shouldn't affect clients that import them from "azure-kusto-ingest" directly.

Deprecations

• Deprecated toJson methods on various type, they are now wrappers around the proper, compliant, toJSON methods.
• Creating a JsonColumnMapping or a CsvColumnMapping from the constructor has been deprecated. Use the new type-safe withX methods
• ingestionMappingType has been renamed to ingestionMappingKind. The original still exists, but is deprecated.
• ingestionMapping has been renamed to ingestionMappingColumns. The original still exists, but is deprecated.
• Importing IngestionPropertiesEnums has been deprecated, instead import classes directly from "azure-kusto-ingest"

Token Providers

Improvements

• Added UserPrompt token provider, which will pop-up a browser window and let you login from there. You can create it using withUserPrompt or setting useUserPromptAuth.
• Added withTokenProvider to create an authentication token from a custom function.
• Correctly pass scopes and authority url to all types based on cloud info.
• Added ToString() to KustoConnectionStringBuilder. It censors secrets by default, but it's possible to override with a parameter.
• Added authorityId and timeoutMs parameters to withAzLoginIdentity and withAadManagedIdentities
• Added more known aliases to connection string parts
• Added better errors for failed tokens with the type KustoAuthenticationError, which also includes context on the token provider.

Internal Fixes

• Added extensive tests to Connection Strings and token providers
• Some tests are now skipped based on environment variables:
  • AUTO_TEST - will skip tests that require manual run (for example, interactive log)
  • LOGIN_TEST- if not set, will skip tests that are related to logging in.
  • Some login tests require additional credentials as env variables.
• Simplified the KeywordMapping type and made it less prone to mistakes using the power of typescript
• Simplified TokenProvider code by using a better class hierarchy
• Removed useless checks that typescript already checks for

Managed Streaming Ingestion

• Adds a new type of ingestion client - ManagedStreamingIngestClient.
• Drop-in replacement for StreamingIngestClient
• The client will default to using streaming ingestion, but will be more robust to errors.
• If it fails to use streaming ingestion, it will fall back to queued when:
  • Retrying streaming ingest fails multiple times, getting transient errors
  • The size of the ingested object is more than 4MB

Type-safe Column Mappings

• There are now distinct types for each kind of column mappings (e.g AvroColumnMapping), that can only be constructed with their properties in a type safe way - e.g AvroColumnMapping.withField will define a column mapping from a field to a field, and AvroColumnMapping.withConstantValue will define a mapping with a constant value.
• Fixed issues with serialization that caused column mappings to not be sent correctly sometimes.
• Old constructors for Json and Csv column mappings have been deprecated.

Custom Parsers

By default, when working with KustoResultRow, the SDK will parse date and time fields to moment.js objects.

You can now override this behaviors, either from the constructor of KustoReesultRow, or the properties timeSpanParser and dateTimeParser of KustoResultTable.

This is useful for cases that the standard datetime objects do not support, such as significant nanoseconds.

Other Fixes

• IngestFromStream now accepts any readable
• IngestFromStream now supports Client Request ID
• Bumped azure-msal, azure-identity, axios and mocha to their latest versions, fixing security warnings
• Added docs to DataFormats
• toJson in rows and columns is now generic, for easier object conversion.

internal Changes

• The code has moved from the deprecated tslint to eslint, and now has more strict lints, including for types and headers.
• The code is now formatted, and enforces formatting using prettify

Breaking Changes:

• None

Features:

• None

Fixes:

• bump axios 0.21.1 -> 0.21.2
• bump uuid 3.4.0 -> 8.3.2
• move @types/mocha to devDependencies

Breaking Changes:

• None

Features:

• None

Fixes:

• Remove problematic dependencies (adal-node, xmldom)

Refactoring token acquiring and migrate from ADAL to MSAL

Add validateStatus and "Keep-Alive" for axios client

Now ts files aren't included in the npm package, as they should.
Also we moved typings from dev-dependencies, to normal dependencies.
These should stop issues when depending on this project on an already typescript codebase.

Add support for query V1

Breaking Changes:

• None

Features:

• Method executeQueryV1 for query V1 endpoint

Fixes:

• None