dax-optimizer-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hallipr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,113 @@
+# dax-optimizer-sdk
+
+Programmatic DAX Optimizer analysis for Power BI and Analysis Services models. Exports a model to VPAX format, uploads it to the [DAX Optimizer](https://daxoptimizer.com) service, and returns structured performance analysis results — all from a single function call.
+
+## Prerequisites
+
+Three CLI tools must be installed on the machine before using this library. If any are missing, the library throws a `PrerequisiteError` with the exact install command.
+
+| Tool | Purpose | Install |
+|------|---------|---------|
+| **.NET 6.0+** | Runtime for the DAX Optimizer CLI | [Download](https://dotnet.microsoft.com/download) |
+| **DAX Optimizer CLI 1.4.7+** | Uploads VPAX and runs analysis | `dotnet tool install --global Dax.Optimizer.CLI` |
+| **DAX Studio** | Exports models to VPAX format (`dscmd.exe`) | [Download](https://daxstudio.org/download/) or `choco install daxstudio` |
+
+You also need a [DAX Optimizer account](https://daxoptimizer.com) with a workspace ID.
+
+## Authentication
+
+Three auth modes are supported. Pass an `auth` object to choose:
+
+### PAT (Personal Access Token)
+Non-interactive. For CI/CD and automation. Requires Enterprise license.
+```ts
+auth: { method: 'pat', username: 'group:automation', token: process.env.TOKEN! }
+```
+
+### Interactive (Individual)
+Opens a browser for sign-in. Credentials are cached locally by the CLI — subsequent runs skip the browser.
+```ts
+auth: { method: 'interactive' }
+```
+
+### Group
+Opens a browser, then switches to a shared group account. Cached like interactive.
+```ts
+auth: { method: 'group', username: 'my-team' }
+```
+
+Use `isInteractive(auth)` to check if a mode may open a browser (useful for showing a "waiting for login" UI). Use `logout()` to clear cached credentials.
+
+## Quick start
+
+```ts
+import { analyzeDaxModel } from 'dax-optimizer-sdk'
+
+const result = await analyzeDaxModel({
+  // Authentication
+  auth: { method: 'pat', username: 'group:automation', token: process.env.TOKEN! },
+
+  // Connection to your Power BI Desktop / Analysis Services instance
+  server: 'localhost:65072',
+  databaseId: 'f97515be-bbb7-434b-83fc-b2599bf8a754',
+
+  // DAX Optimizer target
+  workspaceId: process.env.WORKSPACE_ID!,
+  modelName: 'My Model',
+  modelCreate: true,           // create if it doesn't exist yet
+  contractId: '...',           // required when modelCreate is true
+})
+
+console.log(`Version: ${result.version}`)
+console.log(`Messages: ${result.messages.length}`)
+console.log(`Rules triggered: ${result.rules.length}`)
+console.log(`Measures analyzed: ${result.objectAnalyses.length}`)
+```
+
+## Where do `server` and `databaseId` come from?
+
+This library does **not** include Power BI model discovery. The caller is responsible for providing the Analysis Services connection details. Common approaches:
+
+- **Power BI MCP Server** — use `connection_operations` → `ListLocalInstances` to discover running PBI Desktop instances, then `Connect` and `database_operations` → `List` to get the database ID.
+- **Manual** — find the port in `%LOCALAPPDATA%\Microsoft\Power BI Desktop\AnalysisServicesWorkspaces\*\Data\msmdsrv.port.txt`.
+
+## API
+
+### `analyzeDaxModel(options): Promise<DaxOptimizerResult>`
+
+End-to-end analysis: checks prerequisites, exports VPAX, runs analysis, returns results, cleans up temp files.
+
+### `checkPrerequisites(): PreflightResult`
+
+Returns `{ dotnet: boolean, daxoptimizer: boolean, dscmd: boolean }` without throwing.
+
+### `exportVpax(options): Promise<string>`
+
+Exports a model to VPAX format. Returns the path to the `.vpax` file.
+
+### `runAnalysis(options): Promise<DaxOptimizerResult>`
+
+Runs analysis on an existing VPAX file. Use this if you already have a `.vpax` and want to skip the export step.
+
+### `logout(): Promise<void>`
+
+Clears cached browser credentials from the DAX Optimizer CLI.
+
+### `isInteractive(auth): boolean`
+
+Returns `true` if the auth mode may open a browser (`interactive` or `group`).
+
+## Error handling
+
+| Error class | When |
+|-------------|------|
+| `AuthError` | Invalid auth configuration or login/logout failure |
+| `PrerequisiteError` | A required CLI tool is missing (includes install command) |
+| `VpaxExportError` | `dscmd.exe` failed to export the model |
+| `AnalysisError` | `daxoptimizer` CLI failed or results couldn't be parsed |
+
+All error classes include `stdout` / `stderr` from the failed process where available.
+
+## License
+
+MIT

package/dist/analyze.d.ts

@@ -0,0 +1,11 @@
+import { AnalyzeOptions, DaxOptimizerResult } from './types.js';
+/**
+ * Run DAX Optimizer analysis.
+ *
+ * Invokes: `daxoptimizer analyze <vpax> -u <user> -p <token> …`
+ * Then extracts `DaxOptimizer.json` from the output ZIP.
+ *
+ * @returns Parsed analysis result.
+ */
+export declare function runAnalysis(options: AnalyzeOptions): Promise<DaxOptimizerResult>;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../analyze.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAiB,kBAAkB,EAAE,MAAM,YAAY,CAAA;AA8C9E;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiFhF"}

package/dist/analyze.js

@@ -0,0 +1,121 @@
+// ---------------------------------------------------------------------------
+// DAX Optimizer – run analysis via `daxoptimizer` CLI and extract results
+// ---------------------------------------------------------------------------
+import { execFile } from 'node:child_process';
+import { readFileSync, unlinkSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { basename, join } from 'node:path';
+import { inflateRawSync } from 'node:zlib';
+import { AnalysisError } from './types.js';
+import { buildAuthArgs, isInteractive } from './auth.js';
+// Node.js ≥ 22 ships zlib + built-in zip helpers, but for broad compat we
+// use the `adm-zip` approach via the raw buffer.  The DAX Optimizer CLI
+// outputs a small ZIP containing `DaxOptimizer.json`.  We read it with the
+// built-in `node:zlib` + manual ZIP parsing to stay dependency-free.
+/**
+ * Minimal ZIP reader – extracts a single named entry from a ZIP buffer.
+ * Works for the small ZIPs produced by `daxoptimizer --output`.
+ */
+function extractFileFromZip(zipPath, entryName) {
+    const buf = readFileSync(zipPath);
+    // Scan for local file headers (PK\x03\x04)
+    let offset = 0;
+    while (offset < buf.length - 4) {
+        if (buf[offset] === 0x50 && buf[offset + 1] === 0x4b &&
+            buf[offset + 2] === 0x03 && buf[offset + 3] === 0x04) {
+            const nameLen = buf.readUInt16LE(offset + 26);
+            const extraLen = buf.readUInt16LE(offset + 28);
+            const compressedSize = buf.readUInt32LE(offset + 18);
+            const compressionMethod = buf.readUInt16LE(offset + 8);
+            const name = buf.subarray(offset + 30, offset + 30 + nameLen).toString('utf-8');
+            const dataStart = offset + 30 + nameLen + extraLen;
+            if (name === entryName) {
+                if (compressionMethod === 0) {
+                    // Stored (no compression)
+                    return buf.subarray(dataStart, dataStart + compressedSize);
+                }
+                // Deflate
+                return inflateRawSync(buf.subarray(dataStart, dataStart + compressedSize));
+            }
+            offset = dataStart + compressedSize;
+        }
+        else {
+            offset++;
+        }
+    }
+    throw new AnalysisError(`"${entryName}" not found in ZIP archive at ${zipPath}`);
+}
+/**
+ * Run DAX Optimizer analysis.
+ *
+ * Invokes: `daxoptimizer analyze <vpax> -u <user> -p <token> …`
+ * Then extracts `DaxOptimizer.json` from the output ZIP.
+ *
+ * @returns Parsed analysis result.
+ */
+export function runAnalysis(options) {
+    const { vpaxPath, auth, workspaceId, region = 'westeurope', modelName, modelId, modelCreate, contractId, waitTimeout = 10, failOnIssues, } = options;
+    if (!modelId && !modelName) {
+        throw new AnalysisError('Either modelId or modelName must be provided.');
+    }
+    const stem = basename(vpaxPath, '.vpax');
+    const outputZip = join(tmpdir(), `dax_optimizer_${stem}.zip`);
+    const args = [
+        'analyze', vpaxPath,
+        ...buildAuthArgs(auth),
+        '-r', region,
+        '-w', workspaceId,
+        '--wait-timeout', String(waitTimeout),
+        '--output', outputZip,
+    ];
+    if (modelId) {
+        args.push('-m', modelId);
+    }
+    else if (modelName) {
+        args.push('--model-name', modelName);
+    }
+    if (modelCreate) {
+        args.push('--model-create');
+        if (contractId)
+            args.push('--contract-id', contractId);
+    }
+    if (failOnIssues) {
+        args.push('--fail-on-issues');
+    }
+    // Interactive auth may need extra time for browser login
+    const authBuffer = isInteractive(auth) ? 5 : 2;
+    const timeoutMs = (waitTimeout + authBuffer) * 60_000;
+    return new Promise((resolve, reject) => {
+        execFile('daxoptimizer', args, { timeout: timeoutMs }, (error, stdout, stderr) => {
+            // Print CLI output for visibility
+            if (stdout)
+                console.log(stdout);
+            if (stderr)
+                console.error(stderr);
+            if (error) {
+                const detail = (stderr || stdout || '').trim().split('\n').slice(-5).join('\n');
+                const msg = error.code === 'ENOENT'
+                    ? 'daxoptimizer CLI not found. Install it with: dotnet tool install --global Dax.Optimizer.CLI'
+                    : `DAX Optimizer CLI failed (code ${error.code}): ${detail}`;
+                return reject(new AnalysisError(msg, typeof error.code === 'number' ? error.code : undefined, stdout, stderr));
+            }
+            // Extract result JSON from output ZIP
+            try {
+                const jsonBuf = extractFileFromZip(outputZip, 'DaxOptimizer.json');
+                // Strip UTF-8 BOM if present
+                const jsonStr = jsonBuf.toString('utf-8').replace(/^\uFEFF/, '');
+                const result = JSON.parse(jsonStr);
+                // Cleanup temp zip
+                try {
+                    unlinkSync(outputZip);
+                }
+                catch { /* ignore */ }
+                resolve(result);
+            }
+            catch (e) {
+                reject(e instanceof AnalysisError ? e : new AnalysisError(`Failed to extract results: ${e.message}`));
+            }
+        });
+    });
+}
+//# sourceMappingURL=analyze.js.map

package/dist/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../analyze.ts"],"names":[],"mappings":"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"}

package/dist/auth.d.ts

@@ -0,0 +1,20 @@
+import { DaxOptimizerAuth } from './types.js';
+/**
+ * Build CLI auth flags for the given credential.
+ *
+ * - `pat`         → `['-u', username, '-p', token]`
+ * - `interactive` → `[]` (CLI opens browser)
+ * - `group`       → `['-u', username]` (CLI opens browser, switches to group)
+ */
+export declare function buildAuthArgs(auth: DaxOptimizerAuth): string[];
+/**
+ * Whether this auth mode may open a browser and require user interaction.
+ * Useful for the host app to show a "waiting for login" UI or adjust timeouts.
+ */
+export declare function isInteractive(auth: DaxOptimizerAuth): boolean;
+/**
+ * Clear cached browser credentials from the DAX Optimizer CLI.
+ * Runs: `daxoptimizer logout`
+ */
+export declare function logout(): Promise<void>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../auth.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAa,MAAM,YAAY,CAAA;AAExD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAc9D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAE7D;AAED;;;GAGG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAatC"}

package/dist/auth.js

@@ -0,0 +1,55 @@
+// ---------------------------------------------------------------------------
+// DAX Optimizer – authentication helpers
+// ---------------------------------------------------------------------------
+import { execFile } from 'node:child_process';
+import { AuthError } from './types.js';
+/**
+ * Build CLI auth flags for the given credential.
+ *
+ * - `pat`         → `['-u', username, '-p', token]`
+ * - `interactive` → `[]` (CLI opens browser)
+ * - `group`       → `['-u', username]` (CLI opens browser, switches to group)
+ */
+export function buildAuthArgs(auth) {
+    switch (auth.method) {
+        case 'pat':
+            if (!auth.username)
+                throw new AuthError('PAT auth requires a username.');
+            if (!auth.token)
+                throw new AuthError('PAT auth requires a token.');
+            return ['-u', auth.username, '-p', auth.token];
+        case 'group':
+            if (!auth.username)
+                throw new AuthError('Group auth requires a username.');
+            return ['-u', auth.username];
+        case 'interactive':
+            return [];
+    }
+}
+/**
+ * Whether this auth mode may open a browser and require user interaction.
+ * Useful for the host app to show a "waiting for login" UI or adjust timeouts.
+ */
+export function isInteractive(auth) {
+    return auth.method === 'interactive' || auth.method === 'group';
+}
+/**
+ * Clear cached browser credentials from the DAX Optimizer CLI.
+ * Runs: `daxoptimizer logout`
+ */
+export function logout() {
+    return new Promise((resolve, reject) => {
+        execFile('daxoptimizer', ['logout'], { timeout: 15_000 }, (error, stdout, stderr) => {
+            if (stdout)
+                console.log(stdout);
+            if (error) {
+                const msg = error.code === 'ENOENT'
+                    ? 'daxoptimizer CLI not found. Install it with: dotnet tool install --global Dax.Optimizer.CLI'
+                    : `Logout failed: ${(stderr || stdout || error.message).trim()}`;
+                return reject(new AuthError(msg));
+            }
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../auth.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,yCAAyC;AACzC,8EAA8E;AAE9E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAoB,SAAS,EAAE,MAAM,YAAY,CAAA;AAExD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAsB;IAClD,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,KAAK;YACR,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAA;YACxE,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAK,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAA;YACrE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QAEhD,KAAK,OAAO;YACV,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAA;YAC1E,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;QAE9B,KAAK,aAAa;YAChB,OAAO,EAAE,CAAA;IACb,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAsB;IAClD,OAAO,IAAI,CAAC,MAAM,KAAK,aAAa,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,CAAA;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAClF,IAAI,MAAM;gBAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAC/B,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,GAAG,GAAI,KAA+B,CAAC,IAAI,KAAK,QAAQ;oBAC5D,CAAC,CAAC,6FAA6F;oBAC/F,CAAC,CAAC,kBAAkB,CAAC,MAAM,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAA;gBAClE,OAAO,MAAM,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAA;YACnC,CAAC;YACD,OAAO,EAAE,CAAA;QACX,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import { DaxOptimizerOptions, DaxOptimizerResult } from './types.js';
+/**
+ * End-to-end DAX Optimizer analysis.
+ *
+ * 1. Validates prerequisites (dscmd, daxoptimizer, dotnet).
+ * 2. Exports the model to a temporary VPAX file.
+ * 3. Uploads VPAX to DAX Optimizer and waits for results.
+ * 4. Cleans up temp files and returns the parsed result.
+ */
+export declare function analyzeDaxModel(options: DaxOptimizerOptions): Promise<DaxOptimizerResult>;
+export { checkPrerequisites } from './preflight.js';
+export { exportVpax, findDscmd } from './vpax-export.js';
+export { runAnalysis } from './analyze.js';
+export { logout, isInteractive, buildAuthArgs } from './auth.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAwBA,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAEnB,MAAM,YAAY,CAAA;AAKnB;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoC/F;AAGD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAChE,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,84 @@
+// ---------------------------------------------------------------------------
+// DAX Optimizer – public API
+// ---------------------------------------------------------------------------
+//
+// Usage:
+//   import { analyzeDaxModel, checkPrerequisites, logout } from 'dax-optimizer-sdk'
+//
+//   // PAT auth (CI/CD)
+//   const result = await analyzeDaxModel({
+//     auth: { method: 'pat', username: 'group:automation', token: '...' },
+//     server: 'localhost:65072',
+//     databaseId: '...',
+//     workspaceId: '...',
+//     modelName: 'My Model',
+//   })
+//
+//   // Interactive auth (local dev)
+//   const result2 = await analyzeDaxModel({
+//     auth: { method: 'interactive' },
+//     ...
+//   })
+// ---------------------------------------------------------------------------
+import { unlinkSync } from 'node:fs';
+import { PrerequisiteError, } from './types.js';
+import { checkPrerequisites } from './preflight.js';
+import { exportVpax } from './vpax-export.js';
+import { runAnalysis } from './analyze.js';
+/**
+ * End-to-end DAX Optimizer analysis.
+ *
+ * 1. Validates prerequisites (dscmd, daxoptimizer, dotnet).
+ * 2. Exports the model to a temporary VPAX file.
+ * 3. Uploads VPAX to DAX Optimizer and waits for results.
+ * 4. Cleans up temp files and returns the parsed result.
+ */
+export async function analyzeDaxModel(options) {
+    // ── 1. Preflight ──────────────────────────────────────────────────────
+    const pre = checkPrerequisites();
+    const missing = [];
+    if (!pre.dotnet)
+        missing.push('dotnet 6.0+');
+    if (!pre.daxoptimizer)
+        missing.push('daxoptimizer CLI (dotnet tool install --global Dax.Optimizer.CLI)');
+    if (!pre.dscmd)
+        missing.push('dscmd.exe (DAX Studio)');
+    if (missing.length)
+        throw new PrerequisiteError(missing);
+    // ── 2. Export VPAX ────────────────────────────────────────────────────
+    const vpaxPath = await exportVpax({
+        databaseId: options.databaseId,
+        server: options.server,
+        connectionString: options.connectionString,
+    });
+    // ── 3. Run analysis ───────────────────────────────────────────────────
+    try {
+        const result = await runAnalysis({
+            vpaxPath,
+            auth: options.auth,
+            workspaceId: options.workspaceId,
+            region: options.region ?? 'westeurope',
+            modelName: options.modelName ?? options.databaseId,
+            modelId: options.modelId,
+            modelCreate: options.modelCreate,
+            contractId: options.contractId,
+            waitTimeout: options.waitTimeout,
+            failOnIssues: options.failOnIssues,
+        });
+        return result;
+    }
+    finally {
+        // ── 4. Cleanup temp VPAX ────────────────────────────────────────────
+        try {
+            unlinkSync(vpaxPath);
+        }
+        catch { /* ignore */ }
+    }
+}
+// Re-export everything so callers can import from a single entry point
+export { checkPrerequisites } from './preflight.js';
+export { exportVpax, findDscmd } from './vpax-export.js';
+export { runAnalysis } from './analyze.js';
+export { logout, isInteractive, buildAuthArgs } from './auth.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAC9E,EAAE;AACF,SAAS;AACT,oFAAoF;AACpF,EAAE;AACF,wBAAwB;AACxB,2CAA2C;AAC3C,2EAA2E;AAC3E,iCAAiC;AACjC,yBAAyB;AACzB,0BAA0B;AAC1B,6BAA6B;AAC7B,OAAO;AACP,EAAE;AACF,oCAAoC;AACpC,4CAA4C;AAC5C,uCAAuC;AACvC,UAAU;AACV,OAAO;AACP,8EAA8E;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAGL,iBAAiB,GAClB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE1C;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA4B;IAChE,yEAAyE;IACzE,MAAM,GAAG,GAAG,kBAAkB,EAAE,CAAA;IAChC,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,IAAI,CAAC,GAAG,CAAC,MAAM;QAAQ,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAClD,IAAI,CAAC,GAAG,CAAC,YAAY;QAAE,OAAO,CAAC,IAAI,CAAC,mEAAmE,CAAC,CAAA;IACxG,IAAI,CAAC,GAAG,CAAC,KAAK;QAAS,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAA;IAC7D,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAExD,yEAAyE;IACzE,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;KAC3C,CAAC,CAAA;IAEF,yEAAyE;IACzE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;YAC/B,QAAQ;YACR,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,YAAY;YACtC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,UAAU;YAClD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,YAAY,EAAE,OAAO,CAAC,YAAY;SACnC,CAAC,CAAA;QAEF,OAAO,MAAM,CAAA;IACf,CAAC;YAAS,CAAC;QACT,uEAAuE;QACvE,IAAI,CAAC;YAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAChE,cAAc,YAAY,CAAA"}

package/dist/preflight.d.ts

@@ -0,0 +1,10 @@
+import { PreflightResult } from './types.js';
+/**
+ * Check whether all required CLI tools are available.
+ *
+ * - `dotnet` 6.0+
+ * - `daxoptimizer` (Dax.Optimizer.CLI .NET global tool)
+ * - `dscmd.exe` (DAX Studio CLI)
+ */
+export declare function checkPrerequisites(): PreflightResult;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../preflight.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAsB5C;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAMpD"}

package/dist/preflight.js

@@ -0,0 +1,39 @@
+// ---------------------------------------------------------------------------
+// DAX Optimizer – prerequisite checks
+// ---------------------------------------------------------------------------
+import { execFileSync } from 'node:child_process';
+import { findDscmd } from './vpax-export.js';
+function commandExists(cmd, args = ['--version']) {
+    try {
+        execFileSync(cmd, args, { encoding: 'utf-8', timeout: 10_000, stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function checkDotnet() {
+    try {
+        const out = execFileSync('dotnet', ['--version'], { encoding: 'utf-8', timeout: 10_000, stdio: 'pipe' });
+        const major = parseInt(out.trim().split('.')[0], 10);
+        return major >= 6;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check whether all required CLI tools are available.
+ *
+ * - `dotnet` 6.0+
+ * - `daxoptimizer` (Dax.Optimizer.CLI .NET global tool)
+ * - `dscmd.exe` (DAX Studio CLI)
+ */
+export function checkPrerequisites() {
+    return {
+        dotnet: checkDotnet(),
+        daxoptimizer: commandExists('daxoptimizer'),
+        dscmd: findDscmd() !== null,
+    };
+}
+//# sourceMappingURL=preflight.js.map

package/dist/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../preflight.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sCAAsC;AACtC,8EAA8E;AAE9E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE5C,SAAS,aAAa,CAAC,GAAW,EAAE,OAAiB,CAAC,WAAW,CAAC;IAChE,IAAI,CAAC;QACH,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QAC9E,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QACxG,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QACpD,OAAO,KAAK,IAAI,CAAC,CAAA;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,MAAM,EAAE,WAAW,EAAE;QACrB,YAAY,EAAE,aAAa,CAAC,cAAc,CAAC;QAC3C,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI;KAC5B,CAAA;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,170 @@
+/** Region endpoints supported by DAX Optimizer */
+export type DaxOptimizerRegion = 'australiaeast' | 'eastus' | 'westeurope';
+/** PAT auth — non-interactive, for CI/CD and automation (requires Enterprise license). */
+export interface PatAuth {
+    method: 'pat';
+    /** DAX Optimizer group account name */
+    username: string;
+    /** Personal access token */
+    token: string;
+}
+/** Interactive auth — opens browser for individual sign-in, credentials cached by CLI. */
+export interface InteractiveAuth {
+    method: 'interactive';
+}
+/** Group auth — opens browser, then switches to specified group account. */
+export interface GroupAuth {
+    method: 'group';
+    /** DAX Optimizer group account name */
+    username: string;
+}
+/**
+ * Authentication credential for DAX Optimizer.
+ *
+ * - `pat`: Non-interactive. App stores and passes username + token.
+ * - `interactive`: Browser login. CLI caches credentials locally.
+ * - `group`: Browser login + group switch. CLI caches credentials locally.
+ */
+export type DaxOptimizerAuth = PatAuth | InteractiveAuth | GroupAuth;
+/** Options for `analyzeDaxModel()` – everything the caller must supply. */
+export interface DaxOptimizerOptions {
+    /** Analysis Services server address, e.g. `localhost:65072` */
+    server: string;
+    /** Database / catalog ID on that server */
+    databaseId: string;
+    /** Authentication credential */
+    auth: DaxOptimizerAuth;
+    /** DAX Optimizer workspace ID */
+    workspaceId: string;
+    /** Workspace region (default: `westeurope`) */
+    region?: DaxOptimizerRegion;
+    /** Human-readable model name inside DAX Optimizer (default: databaseId) */
+    modelName?: string;
+    /** Existing model ID – use instead of modelName to target an exact model */
+    modelId?: string;
+    /** Create the model in DAX Optimizer if it doesn't exist yet */
+    modelCreate?: boolean;
+    /** Contract ID – required when `modelCreate` is true */
+    contractId?: string;
+    /** Max minutes to wait for analysis completion (default: 10) */
+    waitTimeout?: number;
+    /** Exit with error when critical issues are found */
+    failOnIssues?: boolean;
+    /** Optional: full MSOLAP connection string (overrides server + databaseId) */
+    connectionString?: string;
+}
+/** Subset of options needed just for VPAX export. */
+export interface VpaxExportOptions {
+    databaseId: string;
+    server: string;
+    connectionString?: string;
+    outputPath?: string;
+}
+/** Subset of options needed for the `daxoptimizer analyze` step. */
+export interface AnalyzeOptions {
+    vpaxPath: string;
+    auth: DaxOptimizerAuth;
+    workspaceId: string;
+    region: DaxOptimizerRegion;
+    modelName?: string;
+    modelId?: string;
+    modelCreate?: boolean;
+    contractId?: string;
+    waitTimeout?: number;
+    failOnIssues?: boolean;
+}
+export interface PreflightResult {
+    dotnet: boolean;
+    daxoptimizer: boolean;
+    dscmd: boolean;
+}
+export interface DaxOptimizerMessage {
+    category: number;
+    level: number;
+    text: string;
+    objectType: number;
+    objectName: string;
+    tableName?: string;
+}
+export interface RuleLocalization {
+    localeId: string;
+    title: string;
+    description: string;
+}
+export interface DaxOptimizerRule {
+    docId: string;
+    url: string;
+    localizations: RuleLocalization[];
+}
+export interface Recommendation {
+    ruleDocId: string;
+    weight: number;
+    cpuWeight: number;
+    materializationWeight: number;
+    fingerprint: string;
+    relatedNodes?: {
+        type: number;
+        from: number;
+        to: number;
+    }[];
+}
+export interface RecommendationNode {
+    type: number;
+    from: number;
+    to: number;
+    name: string;
+    tableName?: string;
+    recommendations: Recommendation[];
+}
+export interface MeasureReference {
+    type: number;
+    from: number;
+    to: number;
+    name: string;
+    tableName: string;
+}
+export interface ObjectAnalysis {
+    objectName: string;
+    objectType: number;
+    dax: string;
+    daxFingerprint: string;
+    weight: number;
+    cpuScore: number;
+    cpuOptimizability: number;
+    materializationScore: number;
+    materializationOptimizability: number;
+    directReferenceCount: number;
+    indirectReferenceCount: number;
+    totalExecutionCount: number;
+    maximumExecutionCount: number;
+    recommendationCount: number;
+    recommendationNodes: RecommendationNode[];
+    referencedMeasures: MeasureReference[];
+    syntaxTokens: unknown[];
+    syntaxTree: unknown;
+}
+export interface DaxOptimizerResult {
+    version: string;
+    messages: DaxOptimizerMessage[];
+    rules: DaxOptimizerRule[];
+    objectAnalyses: ObjectAnalysis[];
+}
+export declare class PrerequisiteError extends Error {
+    missing: string[];
+    constructor(missing: string[], message?: string);
+}
+export declare class AuthError extends Error {
+    constructor(message: string);
+}
+export declare class VpaxExportError extends Error {
+    stdout?: string | undefined;
+    stderr?: string | undefined;
+    constructor(message: string, stdout?: string | undefined, stderr?: string | undefined);
+}
+export declare class AnalysisError extends Error {
+    exitCode?: number | undefined;
+    stdout?: string | undefined;
+    stderr?: string | undefined;
+    constructor(message: string, exitCode?: number | undefined, stdout?: string | undefined, stderr?: string | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,41 @@
+// ---------------------------------------------------------------------------
+// DAX Optimizer – shared types
+// ---------------------------------------------------------------------------
+// ── Errors ──────────────────────────────────────────────────────────────────
+export class PrerequisiteError extends Error {
+    missing;
+    constructor(missing, message) {
+        super(message ?? `Missing prerequisites: ${missing.join(', ')}`);
+        this.missing = missing;
+        this.name = 'PrerequisiteError';
+    }
+}
+export class AuthError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AuthError';
+    }
+}
+export class VpaxExportError extends Error {
+    stdout;
+    stderr;
+    constructor(message, stdout, stderr) {
+        super(message);
+        this.stdout = stdout;
+        this.stderr = stderr;
+        this.name = 'VpaxExportError';
+    }
+}
+export class AnalysisError extends Error {
+    exitCode;
+    stdout;
+    stderr;
+    constructor(message, exitCode, stdout, stderr) {
+        super(message);
+        this.exitCode = exitCode;
+        this.stdout = stdout;
+        this.stderr = stderr;
+        this.name = 'AnalysisError';
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AA4K9E,+EAA+E;AAE/E,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACvB;IAAnB,YAAmB,OAAiB,EAAE,OAAgB;QACpD,KAAK,CAAC,OAAO,IAAI,0BAA0B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAD/C,YAAO,GAAP,OAAO,CAAU;QAElC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,WAAW,CAAA;IACzB,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACJ;IAAwB;IAA5D,YAAY,OAAe,EAAS,MAAe,EAAS,MAAe;QACzE,KAAK,CAAC,OAAO,CAAC,CAAA;QADoB,WAAM,GAAN,MAAM,CAAS;QAAS,WAAM,GAAN,MAAM,CAAS;QAEzE,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,KAAK;IACF;IAA0B;IAAwB;IAAtF,YAAY,OAAe,EAAS,QAAiB,EAAS,MAAe,EAAS,MAAe;QACnG,KAAK,CAAC,OAAO,CAAC,CAAA;QADoB,aAAQ,GAAR,QAAQ,CAAS;QAAS,WAAM,GAAN,MAAM,CAAS;QAAS,WAAM,GAAN,MAAM,CAAS;QAEnG,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;IAC7B,CAAC;CACF"}

package/dist/vpax-export.d.ts

@@ -0,0 +1,13 @@
+import { VpaxExportOptions } from './types.js';
+/** Locate dscmd.exe on PATH or at well-known install locations. */
+export declare function findDscmd(): string | null;
+/**
+ * Export a Power BI / Analysis Services model to VPAX format.
+ *
+ * Runs: `dscmd.exe vpax <outputPath> -s <server> -d <databaseId>`
+ *   or: `dscmd.exe vpax <outputPath> -c <connectionString>`
+ *
+ * @returns Absolute path to the exported .vpax file.
+ */
+export declare function exportVpax(options: VpaxExportOptions): Promise<string>;
+//# sourceMappingURL=vpax-export.d.ts.map

package/dist/vpax-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vpax-export.d.ts","sourceRoot":"","sources":["../vpax-export.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAmB,MAAM,YAAY,CAAA;AAM/D,mEAAmE;AACnE,wBAAgB,SAAS,IAAI,MAAM,GAAG,IAAI,CAYzC;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8CtE"}

package/dist/vpax-export.js

@@ -0,0 +1,69 @@
+// ---------------------------------------------------------------------------
+// DAX Optimizer – VPAX export via DAX Studio CLI (dscmd.exe)
+// ---------------------------------------------------------------------------
+import { execFile, execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, statSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { VpaxExportError } from './types.js';
+const KNOWN_DSCMD_PATHS = [
+    'C:\\Program Files\\DAX Studio\\dscmd.exe',
+];
+/** Locate dscmd.exe on PATH or at well-known install locations. */
+export function findDscmd() {
+    // Check PATH via `where` on Windows
+    try {
+        const result = execFileSync('where', ['dscmd.exe'], { encoding: 'utf-8', timeout: 5_000 });
+        const first = result.trim().split(/\r?\n/)[0];
+        if (first && existsSync(first))
+            return first;
+    }
+    catch { /* not on PATH */ }
+    for (const p of KNOWN_DSCMD_PATHS) {
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+/**
+ * Export a Power BI / Analysis Services model to VPAX format.
+ *
+ * Runs: `dscmd.exe vpax <outputPath> -s <server> -d <databaseId>`
+ *   or: `dscmd.exe vpax <outputPath> -c <connectionString>`
+ *
+ * @returns Absolute path to the exported .vpax file.
+ */
+export function exportVpax(options) {
+    const { databaseId, server, connectionString } = options;
+    const outputPath = options.outputPath ?? join(tmpdir(), `${databaseId}.vpax`);
+    const dscmd = findDscmd();
+    if (!dscmd) {
+        throw new VpaxExportError('dscmd.exe not found. Install DAX Studio from https://daxstudio.org/download/ or add it to PATH.');
+    }
+    // Ensure output directory exists
+    const dir = dirname(outputPath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    // Build command arguments
+    const args = ['vpax', outputPath];
+    if (connectionString) {
+        args.push('-c', connectionString);
+    }
+    else {
+        args.push('-s', server, '-d', databaseId);
+    }
+    return new Promise((resolve, reject) => {
+        execFile(dscmd, args, { timeout: 120_000 }, (error, stdout, stderr) => {
+            if (error) {
+                return reject(new VpaxExportError(`VPAX export failed: ${error.message}`, stdout, stderr));
+            }
+            if (!existsSync(outputPath)) {
+                return reject(new VpaxExportError('VPAX export completed but output file was not created.', stdout, stderr));
+            }
+            const sizeMb = (statSync(outputPath).size / (1024 * 1024)).toFixed(2);
+            console.log(`VPAX exported (${sizeMb} MB): ${outputPath}`);
+            resolve(outputPath);
+        });
+    });
+}
+//# sourceMappingURL=vpax-export.js.map

package/dist/vpax-export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vpax-export.js","sourceRoot":"","sources":["../vpax-export.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "dax-optimizer-sdk",
+  "version": "0.1.0",
+  "description": "Programmatic DAX Optimizer analysis for Power BI and Analysis Services models",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "preflight": "node dist/preflight.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "power-bi",
+    "dax",
+    "dax-optimizer",
+    "analysis-services",
+    "vpax",
+    "performance",
+    "semantic-model"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hallipr/dax-optimizer"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "typescript": "^6.0.2"
+  }
+}