@microsoft/apps-cli 0.0.1 → 0.4.0

package/dist/Utils/Paging.js

@@ -0,0 +1,67 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import chalk from 'chalk';
+import * as readline from 'readline';
+import { printTable } from './ConsoleOutput.js';
+export const PAGE_SIZE = 20;
+/**
+ * Waits for a keypress in raw TTY mode.
+ * Enter/Space = continue, Esc/q = exit, Ctrl+C = process exit.
+ */
+export async function waitForPageKey() {
+    return new Promise((resolve) => {
+        readline.emitKeypressEvents(process.stdin);
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(true);
+        }
+        process.stdin.resume();
+        const handler = (_str, key) => {
+            process.stdin.removeListener('keypress', handler);
+            if (process.stdin.isTTY) {
+                process.stdin.setRawMode(false);
+            }
+            process.stdin.pause();
+            if (key.ctrl && key.name === 'c') {
+                process.exit(0);
+            }
+            if (key.name === 'escape' || key.name === 'q') {
+                resolve('exit');
+            }
+            else {
+                resolve('continue');
+            }
+        };
+        process.stdin.on('keypress', handler);
+    });
+}
+/**
+ * Prints a paginated table in TTY mode (20 rows per page, Enter/Esc to navigate)
+ * or a single full table in non-TTY/piped mode.
+ */
+export async function printPagedTable(options) {
+    const { title, metadata, columns, rows, emptyMessage, totalLabel } = options;
+    const total = rows.length;
+    if (!process.stdout.isTTY) {
+        printTable({ title, metadata, columns, rows, emptyMessage });
+        console.log(chalk.dim(`  Showing ${total} of ${total} ${totalLabel}`));
+        return;
+    }
+    const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE));
+    for (let page = 0; page < totalPages; page++) {
+        const start = page * PAGE_SIZE;
+        const pageRows = rows.slice(start, start + PAGE_SIZE);
+        const isLastPage = page === totalPages - 1;
+        printTable({ title, metadata, columns, rows: pageRows, emptyMessage });
+        console.log(chalk.dim(`  Showing ${start + pageRows.length} of ${total} ${totalLabel}`));
+        if (!isLastPage) {
+            console.log(chalk.dim('  Press Enter for more, Esc or q to exit'));
+        }
+        if (isLastPage)
+            break;
+        const action = await waitForPageKey();
+        if (action === 'exit')
+            break;
+    }
+}
+//# sourceMappingURL=Paging.js.map

package/dist/Utils/Paging.js.map

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

package/dist/Utils/ReadPackageJson.d.ts

@@ -0,0 +1,9 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export interface PackageJson {
+    scripts?: Record<string, string>;
+    packageManager?: string;
+}
+export declare function readPackageJson(projectRoot: string): PackageJson;
+//# sourceMappingURL=ReadPackageJson.d.ts.map

package/dist/Utils/ReadPackageJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadPackageJson.d.ts","sourceRoot":"","sources":["../../src/Utils/ReadPackageJson.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAMhE"}

package/dist/Utils/ReadPackageJson.js

@@ -0,0 +1,13 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export function readPackageJson(projectRoot) {
+    const pkgPath = path.join(projectRoot, 'package.json');
+    if (!fs.existsSync(pkgPath)) {
+        return {};
+    }
+    return JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+}
+//# sourceMappingURL=ReadPackageJson.js.map

package/dist/Utils/ReadPackageJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadPackageJson.js","sourceRoot":"","sources":["../../src/Utils/ReadPackageJson.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAO7B,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAgB,CAAC;AACrE,CAAC"}

package/dist/Utils/ResolveCommand.d.ts

@@ -0,0 +1,26 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { CommandTree, NounKey, ResolvedCommand } from '../Types/Command.types.js';
+/**
+ * Resolves command-line tokens against the command tree.
+ *
+ * Every command lives under a noun, so the minimum match is 2 tokens (noun + verb).
+ * Typed subcommands match 3 tokens (noun + verb + type).
+ *
+ * @param argv - The full process.argv array (argv[0] = node, argv[1] = script)
+ * @param tree - The command tree to resolve against
+ * @returns The resolved command, or null if no match was found
+ */
+export declare function resolveCommand(argv: readonly string[], tree: CommandTree): ResolvedCommand | null;
+/**
+ * Checks whether the given token is a known noun in the command tree.
+ * Used to distinguish `ms app` (show noun help) from `ms nonexistent` (error).
+ */
+export declare function isKnownNoun(token: string, tree: CommandTree): token is NounKey;
+/**
+ * Checks whether the given noun + verb combination has typed subcommands.
+ * Used to show the type-picker help for `ms app add --help`.
+ */
+export declare function hasTypedSubcommands(noun: string, verb: string, tree: CommandTree): boolean;
+//# sourceMappingURL=ResolveCommand.d.ts.map

package/dist/Utils/ResolveCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolveCommand.d.ts","sourceRoot":"","sources":["../../src/Utils/ResolveCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGpF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,CAgCjG;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,KAAK,IAAI,OAAO,CAE9E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAK1F"}

package/dist/Utils/ResolveCommand.js

@@ -0,0 +1,62 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { isTypedVerbDef } from '../Types/Command.types.js';
+/**
+ * Resolves command-line tokens against the command tree.
+ *
+ * Every command lives under a noun, so the minimum match is 2 tokens (noun + verb).
+ * Typed subcommands match 3 tokens (noun + verb + type).
+ *
+ * @param argv - The full process.argv array (argv[0] = node, argv[1] = script)
+ * @param tree - The command tree to resolve against
+ * @returns The resolved command, or null if no match was found
+ */
+export function resolveCommand(argv, tree) {
+    const tokens = argv.slice(2);
+    // Skip if no tokens or first token looks like a flag
+    if (tokens.length === 0 || tokens[0].startsWith('-')) {
+        return null;
+    }
+    const [t0, t1, t2] = tokens;
+    if (!isKnownNoun(t0, tree))
+        return null;
+    const nounDef = tree[t0];
+    // Try 3-token match: noun verb type (e.g., 'app add table')
+    if (t1 && !t1.startsWith('-') && t2 && !t2.startsWith('-')) {
+        const verbEntry = nounDef.commands[t1];
+        if (isTypedVerbDef(verbEntry)) {
+            const leafDef = verbEntry.commands[t2];
+            if (leafDef) {
+                return { path: [t0, t1, t2], handler: leafDef.handler, tokensConsumed: 3 };
+            }
+        }
+    }
+    // Try 2-token match: noun verb (e.g., 'app init')
+    if (t1 && !t1.startsWith('-')) {
+        const verbEntry = nounDef.commands[t1];
+        if (verbEntry && !isTypedVerbDef(verbEntry)) {
+            return { path: [t0, t1], handler: verbEntry.handler, tokensConsumed: 2 };
+        }
+    }
+    return null;
+}
+/**
+ * Checks whether the given token is a known noun in the command tree.
+ * Used to distinguish `ms app` (show noun help) from `ms nonexistent` (error).
+ */
+export function isKnownNoun(token, tree) {
+    return token in tree;
+}
+/**
+ * Checks whether the given noun + verb combination has typed subcommands.
+ * Used to show the type-picker help for `ms app add --help`.
+ */
+export function hasTypedSubcommands(noun, verb, tree) {
+    if (!isKnownNoun(noun, tree))
+        return false;
+    const nounDef = tree[noun];
+    const verbEntry = nounDef.commands[verb];
+    return verbEntry !== undefined && isTypedVerbDef(verbEntry);
+}
+//# sourceMappingURL=ResolveCommand.js.map

package/dist/Utils/ResolveCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResolveCommand.js","sourceRoot":"","sources":["../../src/Utils/ResolveCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,IAAuB,EAAE,IAAiB;IACvE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE7B,qDAAqD;IACrD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC;IAC5B,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAEzB,4DAA4D;IAC5D,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;YAC7E,CAAC;QACH,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,SAAS,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5C,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,IAAiB;IAC1D,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,IAAY,EAAE,IAAiB;IAC/E,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,SAAS,KAAK,SAAS,IAAI,cAAc,CAAC,SAAS,CAAC,CAAC;AAC9D,CAAC"}

package/dist/Utils/RunCommand.d.ts

@@ -0,0 +1,13 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export interface RunCommandOptions {
+    /**
+     * When true, the child process's stdout/stderr are captured rather than inherited so
+     * the parent's stdout stays clean (e.g. JSON-mode callers). Captured output is
+     * surfaced only on failure, included in the thrown AppError's message.
+     */
+    quiet?: boolean;
+}
+export declare function runCommandAsync(command: string, cwd: string, options?: RunCommandOptions): Promise<void>;
+//# sourceMappingURL=RunCommand.d.ts.map

package/dist/Utils/RunCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunCommand.d.ts","sourceRoot":"","sources":["../../src/Utils/RunCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/Utils/RunCommand.js

@@ -0,0 +1,35 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { spawn } from 'node:child_process';
+import { AppError } from '../Errors/CliError.js';
+export function runCommandAsync(command, cwd, options = {}) {
+    return new Promise((resolve, reject) => {
+        const quiet = options.quiet === true;
+        const child = spawn(command, {
+            cwd,
+            stdio: quiet ? ['ignore', 'pipe', 'pipe'] : 'inherit',
+            shell: true,
+        });
+        let captured = '';
+        if (quiet) {
+            child.stdout?.on('data', (chunk) => {
+                captured += chunk.toString();
+            });
+            child.stderr?.on('data', (chunk) => {
+                captured += chunk.toString();
+            });
+        }
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            const base = `Command exited with code ${code}: ${command}`;
+            const message = quiet && captured.length > 0 ? `${base}\n${captured.trimEnd()}` : base;
+            reject(new AppError(message, code ?? 1));
+        });
+        child.on('error', reject);
+    });
+}
+//# sourceMappingURL=RunCommand.js.map

package/dist/Utils/RunCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunCommand.js","sourceRoot":"","sources":["../../src/Utils/RunCommand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAW9C,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,GAAW,EACX,UAA6B,EAAE;IAE/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE;YAC3B,GAAG;YACH,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;YACrD,KAAK,EAAE,IAAI;SACZ,CAAC,CAAC;QACH,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;gBACjC,QAAQ,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC/B,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;gBACjC,QAAQ,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC/B,CAAC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,4BAA4B,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5D,MAAM,OAAO,GAAG,KAAK,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACvF,MAAM,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/Utils/Spinner.d.ts

@@ -0,0 +1,15 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+export declare class CliSpinner {
+    private _timer;
+    private _frameIndex;
+    private _restoreCursor;
+    private _handleSIGINT;
+    private _handleSIGTERM;
+    private _handleUncaughtException;
+    private _handleUnhandledRejection;
+    start(): void;
+    stop(): void;
+}
+//# sourceMappingURL=Spinner.d.ts.map

package/dist/Utils/Spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Spinner.d.ts","sourceRoot":"","sources":["../../src/Utils/Spinner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,WAAW,CAAK;IAGxB,OAAO,CAAC,cAAc,CAGpB;IAEF,OAAO,CAAC,aAAa,CAKnB;IAEF,OAAO,CAAC,cAAc,CAIpB;IAEF,OAAO,CAAC,wBAAwB,CAK9B;IAEF,OAAO,CAAC,yBAAyB,CAI/B;IAEF,KAAK,IAAI,IAAI;IAeb,IAAI,IAAI,IAAI;CAcb"}

package/dist/Utils/Spinner.js

@@ -0,0 +1,71 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+// SYNC: this file is duplicated in packages/power-apps-cli/src/Utils/Spinner.ts.
+// Changes here must be mirrored there until a shared CLI utilities package exists.
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+export class CliSpinner {
+    _timer = null;
+    _frameIndex = 0;
+    // Arrow functions so `this` is stable when passed to process.on/off.
+    _restoreCursor = () => {
+        process.stdout.write('\r\x1B[K'); // erase spinner line
+        process.stdout.write('\x1B[?25h'); // show cursor
+    };
+    _handleSIGINT = () => {
+        if (this._timer !== null)
+            clearInterval(this._timer);
+        this._restoreCursor();
+        // Re-raise so the process actually exits with the correct signal.
+        process.kill(process.pid, 'SIGINT');
+    };
+    _handleSIGTERM = () => {
+        if (this._timer !== null)
+            clearInterval(this._timer);
+        this._restoreCursor();
+        process.kill(process.pid, 'SIGTERM');
+    };
+    _handleUncaughtException = (error) => {
+        if (this._timer !== null)
+            clearInterval(this._timer);
+        this._restoreCursor();
+        // Re-throw so Node.js prints the error and exits with code 1.
+        throw error;
+    };
+    _handleUnhandledRejection = (reason) => {
+        if (this._timer !== null)
+            clearInterval(this._timer);
+        this._restoreCursor();
+        throw reason;
+    };
+    start() {
+        if (this._timer !== null)
+            return;
+        process.stdout.write('\x1B[?25l'); // hide cursor
+        // Restore cursor if the process exits before stop() is called normally.
+        process.once('exit', this._restoreCursor);
+        process.once('SIGINT', this._handleSIGINT);
+        process.once('SIGTERM', this._handleSIGTERM);
+        process.once('uncaughtException', this._handleUncaughtException);
+        process.once('unhandledRejection', this._handleUnhandledRejection);
+        this._timer = setInterval(() => {
+            process.stdout.write(`\r${SPINNER_FRAMES[this._frameIndex]}`);
+            this._frameIndex = (this._frameIndex + 1) % SPINNER_FRAMES.length;
+        }, 80);
+    }
+    stop() {
+        if (this._timer !== null) {
+            clearInterval(this._timer);
+            this._timer = null;
+            this._frameIndex = 0;
+            // Clean up exit handlers registered in start().
+            process.off('exit', this._restoreCursor);
+            process.off('SIGINT', this._handleSIGINT);
+            process.off('SIGTERM', this._handleSIGTERM);
+            process.off('uncaughtException', this._handleUncaughtException);
+            process.off('unhandledRejection', this._handleUnhandledRejection);
+            this._restoreCursor();
+        }
+    }
+}
+//# sourceMappingURL=Spinner.js.map

package/dist/Utils/Spinner.js.map

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

package/dist/Utils/zipBuildArtifact.d.ts

@@ -0,0 +1,35 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * Decision for a single `archiver` `'warning'` event:
+ *   - `'continue'`: log and proceed (ENOENT — vanished file or dangling symlink).
+ *   - `Error`: reject the archive with this error (anything else).
+ *
+ * Extracted from {@link zipBuildArtifact} so the policy can be unit-tested directly without
+ * needing to provoke real archiver warnings (non-ENOENT cases are hard to provoke
+ * cross-platform). The handler is intentionally pure: no I/O, no side effects.
+ */
+export declare function classifyArchiveWarning(err: unknown): 'continue' | Error;
+/**
+ * Formats the user-facing warning line for an ENOENT entry. Lives here so the test for the
+ * warning text doesn't have to import {@link zipBuildArtifact}'s internals.
+ */
+export declare function formatMissingEntryWarning(err: unknown): string;
+/**
+ * Zips the contents of `buildPath` (flattened — `buildPath`'s files appear at the zip root,
+ * not nested under a `build/` directory) and adds `ms.config.json` at the same root.
+ *
+ * The resulting `Buffer` is the entire zip in memory. When `maxBytes` is supplied, the helper
+ * counts emitted bytes as the archive streams and aborts as soon as the running total exceeds
+ * the cap — preventing OOM when the source tree is huge. Callers that don't enforce a cap can
+ * omit the option.
+ *
+ * The helper is a pure file-IO utility: it does not parse `ms.config.json`. Callers that
+ * need the schema (e.g. `appId`) should read it separately. ENOENT warnings during archiving
+ * (vanished files, dangling symlinks) are surfaced to stderr; non-ENOENT warnings reject.
+ */
+export declare function zipBuildArtifact(buildPath: string, appConfigPath: string, options?: {
+    maxBytes?: number;
+}): Promise<Buffer>;
+//# sourceMappingURL=zipBuildArtifact.d.ts.map

package/dist/Utils/zipBuildArtifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zipBuildArtifact.d.ts","sourceRoot":"","sources":["../../src/Utils/zipBuildArtifact.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,GAAG,KAAK,CAIvE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAG9D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,OAAO,CAAC,MAAM,CAAC,CAuDjB"}

package/dist/Utils/zipBuildArtifact.js

@@ -0,0 +1,100 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { promises as fs } from 'node:fs';
+import { AppConfigFileName } from '@microsoft/apps-common/config';
+import { BuildArtifactTooLargeError, UsageError } from '@microsoft/apps-common/errors';
+import archiver from 'archiver';
+import { printWarning } from './ConsoleOutput.js';
+/**
+ * Decision for a single `archiver` `'warning'` event:
+ *   - `'continue'`: log and proceed (ENOENT — vanished file or dangling symlink).
+ *   - `Error`: reject the archive with this error (anything else).
+ *
+ * Extracted from {@link zipBuildArtifact} so the policy can be unit-tested directly without
+ * needing to provoke real archiver warnings (non-ENOENT cases are hard to provoke
+ * cross-platform). The handler is intentionally pure: no I/O, no side effects.
+ */
+export function classifyArchiveWarning(err) {
+    const code = err?.code;
+    if (code === 'ENOENT')
+        return 'continue';
+    return err instanceof Error ? err : new Error(String(err));
+}
+/**
+ * Formats the user-facing warning line for an ENOENT entry. Lives here so the test for the
+ * warning text doesn't have to import {@link zipBuildArtifact}'s internals.
+ */
+export function formatMissingEntryWarning(err) {
+    const path = err?.path ?? '<unknown>';
+    return `zipBuildArtifact: skipping missing entry: ${path}`;
+}
+/**
+ * Zips the contents of `buildPath` (flattened — `buildPath`'s files appear at the zip root,
+ * not nested under a `build/` directory) and adds `ms.config.json` at the same root.
+ *
+ * The resulting `Buffer` is the entire zip in memory. When `maxBytes` is supplied, the helper
+ * counts emitted bytes as the archive streams and aborts as soon as the running total exceeds
+ * the cap — preventing OOM when the source tree is huge. Callers that don't enforce a cap can
+ * omit the option.
+ *
+ * The helper is a pure file-IO utility: it does not parse `ms.config.json`. Callers that
+ * need the schema (e.g. `appId`) should read it separately. ENOENT warnings during archiving
+ * (vanished files, dangling symlinks) are surfaced to stderr; non-ENOENT warnings reject.
+ */
+export async function zipBuildArtifact(buildPath, appConfigPath, options) {
+    const buildStat = await fs.stat(buildPath).catch(() => null);
+    if (!buildStat) {
+        throw new UsageError(`buildPath not found: ${buildPath}`);
+    }
+    if (!buildStat.isDirectory()) {
+        throw new UsageError(`buildPath is not a directory: ${buildPath}`);
+    }
+    const configStat = await fs.stat(appConfigPath).catch(() => null);
+    if (!configStat || !configStat.isFile()) {
+        throw new UsageError(`appConfigPath does not point to a file: ${appConfigPath}`);
+    }
+    const maxBytes = options?.maxBytes;
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let totalBytes = 0;
+        let aborted = false;
+        const archive = archiver('zip', { zlib: { level: 9 } });
+        archive.on('data', (chunk) => {
+            if (aborted)
+                return;
+            totalBytes += chunk.length;
+            if (maxBytes !== undefined && totalBytes > maxBytes) {
+                aborted = true;
+                archive.abort();
+                reject(new BuildArtifactTooLargeError({ capBytes: maxBytes, bytes: totalBytes }));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        archive.on('warning', (err) => {
+            if (aborted)
+                return;
+            const decision = classifyArchiveWarning(err);
+            if (decision === 'continue') {
+                // Surface to stderr via the CLI's logger pipeline so the line is chalk-coloured
+                // alongside other CLI output, and so test seams can intercept it.
+                printWarning(formatMissingEntryWarning(err));
+                return;
+            }
+            reject(decision);
+        });
+        archive.on('error', (err) => {
+            if (!aborted)
+                reject(err);
+        });
+        archive.on('end', () => {
+            if (!aborted)
+                resolve(Buffer.concat(chunks));
+        });
+        archive.directory(buildPath, false);
+        archive.file(appConfigPath, { name: AppConfigFileName });
+        void archive.finalize();
+    });
+}
+//# sourceMappingURL=zipBuildArtifact.js.map

package/dist/Utils/zipBuildArtifact.js.map

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

package/dist/Verbs/AddAction.d.ts

@@ -0,0 +1,6 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { ArgumentProvider } from '../ArgumentProvider.js';
+export declare function addActionAsync(argumentProvider: ArgumentProvider): Promise<void>;
+//# sourceMappingURL=AddAction.d.ts.map

package/dist/Verbs/AddAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddAction.d.ts","sourceRoot":"","sources":["../../src/Verbs/AddAction.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAY5D,wBAAsB,cAAc,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDtF"}

package/dist/Verbs/AddAction.js

@@ -0,0 +1,87 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { addConnectorActionAsync, getPlayerServiceConfig } from '@microsoft/apps-actions';
+import { getCliLogger, getSettings } from '../CliSettings.js';
+import { createDefaultStringOption } from '../CliUtils.js';
+import { CLI_BINARY_NAME } from '../Constants/CliConstants.js';
+import { HelpStrings } from '../Constants/HelpStrings.js';
+import { printInfo, printSuccess } from '../Utils/ConsoleOutput.js';
+import { resolveConnectionInteractivelyAsync, runConnectorDlpPreflightAsync, } from './ConnectorHelpers.js';
+import { AddActionArguments, SharedArguments } from './VerbConstants.js';
+export async function addActionAsync(argumentProvider) {
+    const settings = getSettings();
+    const { fileConfig, cliFs } = settings;
+    createOptionSchema(argumentProvider);
+    await argumentProvider.runVerb();
+    const playerServiceConfig = getPlayerServiceConfig();
+    const authProvider = argumentProvider.getAuthenticationProvider();
+    const logger = getCliLogger();
+    // Commander converts kebab-case flags to camelCase attribute names — use camelCase here.
+    const apiId = await argumentProvider.getOption('apiId');
+    const connectionIdFlag = await argumentProvider.getOption('connectionId', true);
+    const skipCodegen = !!(await argumentProvider.getOption('skipCodegen', true));
+    const useV1Codegen = !!(await argumentProvider.getOption('useV1Codegen', true));
+    // ── Preflight: connector + DLP policy (throws on not-found or blocked) ────
+    const { connector } = await runConnectorDlpPreflightAsync(argumentProvider, apiId);
+    // ── Step 1: Does this connector require a connection? ─────────────────────
+    const needsConnection = (connector.properties.connectionParameterSets?.values?.length ?? 0) > 0 ||
+        connector.properties.metadata?.allowSharing === true;
+    // ── Step 2: Connection resolution ─────────────────────────────────────────
+    let connectionId = connectionIdFlag;
+    if (needsConnection && !connectionId) {
+        connectionId = await resolveConnectionInteractivelyAsync({
+            argumentProvider,
+            apiId,
+            connector,
+        });
+    }
+    // ── Step 3: Add the connector action ──────────────────────────────────────
+    const context = {
+        vfs: cliFs,
+        authProvider,
+        httpClient: argumentProvider.getHttpClient(),
+        region: playerServiceConfig.region,
+        environmentName: playerServiceConfig.environmentName,
+        actionsParams: { apiId, connectionId, skipCodegen, useV1Codegen },
+        localFilePaths: {
+            appConfigPath: fileConfig.appConfigPath,
+            schemaPath: fileConfig.schemaPath,
+            codeGenPath: fileConfig.codeGenPath,
+        },
+        logger,
+    };
+    await addConnectorActionAsync(context);
+    printSuccess(`Connector '${connector.properties.displayName ?? apiId}' added successfully.`);
+    printInfo(`Hint: Run 'npx ${CLI_BINARY_NAME} dev' to test locally, or 'npx ${CLI_BINARY_NAME} push' to deploy.`);
+}
+function createOptionSchema(argumentProvider) {
+    argumentProvider.setDescription(HelpStrings.app.add.action.description);
+    argumentProvider.addExamples(HelpStrings.app.add.action.examples);
+    argumentProvider.addOptions([
+        createDefaultStringOption({
+            flags: { key: SharedArguments.ApiId.name, alias: SharedArguments.ApiId.alias },
+            env: SharedArguments.ApiId.envVar,
+            message: SharedArguments.ApiId.promptMessage,
+            description: HelpStrings.app.add.action.options.apiId,
+        }),
+        {
+            flags: { key: SharedArguments.ConnectionId.name, alias: SharedArguments.ConnectionId.alias },
+            env: SharedArguments.ConnectionId.envVar,
+            description: HelpStrings.app.add.action.options.connectionId,
+            optionalInNonInteractive: true,
+        },
+    ]);
+    argumentProvider.addSwitch({
+        flags: { key: AddActionArguments.SkipCodegen.name },
+        env: AddActionArguments.SkipCodegen.env,
+        description: HelpStrings.app.add.action.options.skipCodegen,
+    });
+    argumentProvider.addSwitch({
+        flags: { key: AddActionArguments.UseV1Codegen.name },
+        env: AddActionArguments.UseV1Codegen.env,
+        description: 'Use V1 (legacy) code generation instead of V2.',
+        hidden: true,
+    });
+}
+//# sourceMappingURL=AddAction.js.map

package/dist/Verbs/AddAction.js.map

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

package/dist/Verbs/AddDataSource.d.ts

@@ -0,0 +1,19 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { ArgumentProvider } from '../ArgumentProvider.js';
+/**
+ * Adds a data source based on the provided environment variables.
+ * It supports both Dataverse and connector data sources.
+ * Expects the following environment variables:
+ * - MS_CLI_API_ID: The ID of the API (e.g., 'dataverse' or a connector ID)
+ * - MS_CLI_CONNECTION_ID?: The ID of the connection (for connector data sources)
+ * - MS_CLI_TABLE?: The table name for Dataverse or tabular connector data sources
+ * - MS_CLI_ENV_URL?: The environment URL for Dataverse data sources
+ * - MS_CLI_DATASET?: The dataset name for tabular/stored proc connector data sources
+ * - MS_CLI_SQL_STORED_PROCEDURE?: The name of the SQL stored procedure for connector data sources
+ * @param config - Local file paths configuration
+ * @returns Promise<void>
+ */
+export declare function addDataSourceAsync(argumentProvider: ArgumentProvider): Promise<void>;
+//# sourceMappingURL=AddDataSource.d.ts.map