Browser react sample project

.eslintrc.js

@@ -27,11 +27,12 @@ module.exports = {
         "node_modules",
         "**/*.d.ts",
         "**/*.js",
-        "webpack.config.ts"
+        "webpack.config.ts",
+        "vite.config.ts"
     ],
     "parser": "@typescript-eslint/parser",
     "parserOptions": {
-        "project": ["tsconfig.json","packages/azure-kusto-data/tsconfig.json","packages/azure-kusto-ingest/tsconfig.json","packages/quick_start/tsconfig.json"],
+        "project": ["tsconfig.json","packages/azure-kusto-data/tsconfig.json","packages/azure-kusto-ingest/tsconfig.json","packages/quick_start/tsconfig.json","packages/quick_start-browser/tsconfig.json"],
         "sourceType": "module"
     },
     "plugins": [

.gitignore

@@ -327,8 +327,9 @@ __main.js
 *.d.ts.map
 *.d.ts
 
-# We still want example.js files
+# We still want example files
 !example.js
+!config-overrides.js
 
 **/.nyc_output
 **/coverage

lerna.json

@@ -1,3 +1,4 @@
 {
-  "version": "5.2.0"
+  "version": "5.2.0",
+  "useWorkspaces": true
 }

package.json

@@ -55,6 +55,7 @@
         "jsonwebtoken": "^9.0.0"
     },
     "workspaces": [
-        "packages/*"
+        "packages/azure-kusto-data",
+        "packages/azure-kusto-ingest"
     ]
 }

packages/azure-kusto-data/package.json

@@ -60,7 +60,6 @@
         "@azure/msal-common": "^7.3.0",
         "@types/uuid": "^8.3.4",
         "axios": "^0.27.2",
-        "crypto-browserify": "^3.12.0",
         "follow-redirects": "^1.15.1",
         "https-browserify": "^1.0.0",
         "stream-http": "^3.2.0",

packages/azure-kusto-data/src/index.ts

@@ -7,6 +7,7 @@ import CloudSettings from "./cloudSettings";
 import KustoConnectionStringBuilder from "./connectionBuilder";
 import * as KustoDataErrors from "./errors";
 import { kustoTrustedEndpoints, MatchRule } from "./kustoTrustedEndpoints";
+import { KustoResultColumn, KustoResultRow, KustoResultTable } from "./models";
 import { KustoResponseDataSet } from "./response";
 import { toMilliseconds } from "./timeUtils";
 
@@ -19,6 +20,9 @@ export {
     KustoConnectionStringBuilder,
     KustoDataErrors,
     KustoResponseDataSet,
+    KustoResultColumn,
+    KustoResultRow,
+    KustoResultTable,
     kustoTrustedEndpoints,
     MatchRule,
     TimeUtils,

packages/azure-kusto-ingest/src/index.ts

@@ -17,6 +17,7 @@ import {
     ValidationImplications,
     ValidationOptions,
     ValidationPolicy,
+    dataFormatMappingKind,
 } from "./ingestionProperties";
 
 import {
@@ -76,6 +77,7 @@ export {
     ValidationOptions,
     ValidationPolicy,
     W3CLogFileMapping,
+    dataFormatMappingKind,
 };
 
 /**

packages/quick_start-browser/README.md

@@ -0,0 +1,37 @@
+# Quickstart App
+
+The quickstart application is a **self-contained and runnable** example app that demonstrates authenticating, connecting to, administering, ingesting data
+into and querying Azure Data Explorer using the Azure Kusto JS SDK.
+You can use it as a baseline to write your own first kusto client application, altering the code as you go, or copy code sections out of it into your app.
+
+**Tip:** The app includes comments with tips on recommendations, coding best practices, links to reference materials and recommended TODO changes when adapting the code to your needs.
+
+## Using the App for the first time
+
+### Prerequisites
+
+1. Set up NodeJS version 14+ and npm on your machine. For instructions, consult a setup tutorial, like [this](https://docs.microsoft.com/en-us/windows/dev-environment/javascript/nodejs-on-windows)
+
+### Retrieving the app from GitHub
+
+1. Download the app files from this GitHub repository.
+2. You may modify the `kusto_sample_config.json` file, changing `kustoUri`, `ingestUri` and `databaseName` appropriately for your cluster.
+
+### Retrieving the app from OneClick
+
+Not yet available.
+
+### Run the app
+
+1. Open a command line window and navigate to the folder where you extracted the app.
+2. Either use an IDE of your choice to build and run the project, or execute the following using the command line window:
+    1. Run `npm install` in the sample folder
+    2. Run `npm run dev`
+
+#### Troubleshooting
+
+-   If you are having trouble running the app from your IDE, first check if the app runs from the command line, then consult the troubleshooting references of your IDE.
+
+#### Authenticaiton
+This example uses @azure/identity InteractiveBrowserCredential, the authentication app id used in this method is taken from the App id field, the app should be granted admin consent to Azure Data Explorer and allow the redirectUri of the url of the runing site. See steps [here](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity/test/manual/interactive-browser-credential)
+A production app should better authenticate users itself and use the "withTokenProvide" builder method of the Kusto client connectionStringBuilder. 

packages/quick_start-browser/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+    <head>
+        <meta charset="UTF-8" />
+        <link rel="icon" type="image/png" href="/download.png" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <title>Kusto Browser React Sample</title>
+    </head>
+    <body>
+        <div id="root"></div>
+        <script type="module" src="/src/main.tsx"></script>
+    </body>
+</html>