@microsoft/managed-apps-cli 0.5.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,33 @@
+/*!
+ * 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). On failure the captured
+     * stderr is included in the thrown AppError's message; stdout is used as a fallback
+     * when stderr is silent (some toolchains route diagnostics through stdout).
+     */
+    quiet?: boolean;
+    /**
+     * Per-stream tail cap (in bytes) for quiet-mode capture. Defaults to
+     * {@link CAPTURE_TAIL_CAP_BYTES} (8 KB). Override when a caller needs a smaller or
+     * larger diagnostic tail than the default (e.g. very chatty toolchains that flush a
+     * relevant stack trace beyond 8 KB, or extra-small callers writing to a constrained
+     * telemetry sink). Ignored when `quiet` is false.
+     */
+    captureTailCapBytes?: number;
+}
+/**
+ * Default per-stream tail cap for quiet-mode capture. A chatty `--verbose` build can
+ * spew tens or hundreds of MB; that whole payload would otherwise land in
+ * `AppError.message`, the JSON `errorMessage`, and the `trackErrorEvent` OneDS event.
+ * We keep only the tail — which is where the actual failure diagnostic lives — and
+ * prepend a marker line so the consumer knows truncation happened.
+ *
+ * 8 KB ≈ 8000 characters of mostly-ASCII tool output (~100 lines at 80 cols) — enough
+ * to capture a typical stack trace or compiler diagnostic without bloating telemetry.
+ */
+export declare const CAPTURE_TAIL_CAP_BYTES: number;
+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;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,QAAW,CAAC;AAuC/C,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/Utils/RunCommand.js

@@ -0,0 +1,83 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { spawn } from 'node:child_process';
+import { AppError } from '../Errors/CliError.js';
+/**
+ * Default per-stream tail cap for quiet-mode capture. A chatty `--verbose` build can
+ * spew tens or hundreds of MB; that whole payload would otherwise land in
+ * `AppError.message`, the JSON `errorMessage`, and the `trackErrorEvent` OneDS event.
+ * We keep only the tail — which is where the actual failure diagnostic lives — and
+ * prepend a marker line so the consumer knows truncation happened.
+ *
+ * 8 KB ≈ 8000 characters of mostly-ASCII tool output (~100 lines at 80 cols) — enough
+ * to capture a typical stack trace or compiler diagnostic without bloating telemetry.
+ */
+export const CAPTURE_TAIL_CAP_BYTES = 8 * 1024;
+function makeSink() {
+    return { chunks: [], bytes: 0, dropped: 0 };
+}
+function appendCapped(sink, chunk, cap) {
+    sink.chunks.push(chunk);
+    sink.bytes += chunk.length;
+    while (sink.bytes > cap) {
+        const overflow = sink.bytes - cap;
+        const head = sink.chunks[0];
+        if (head.length <= overflow) {
+            sink.chunks.shift();
+            sink.bytes -= head.length;
+            sink.dropped += head.length;
+        }
+        else {
+            sink.chunks[0] = head.subarray(overflow);
+            sink.bytes -= overflow;
+            sink.dropped += overflow;
+        }
+    }
+}
+function decodeSink(sink) {
+    // toString('utf8') on a sliced tail may yield a replacement char at byte 0 if the
+    // slice cut a multi-byte codepoint — acceptable for a diagnostic message; the
+    // surrounding context still reads correctly.
+    const tail = Buffer.concat(sink.chunks).toString('utf8').trimEnd();
+    if (sink.dropped === 0)
+        return tail;
+    return `[truncated earlier ${sink.dropped} bytes; showing last ${sink.bytes} bytes]\n${tail}`;
+}
+export function runCommandAsync(command, cwd, options = {}) {
+    return new Promise((resolve, reject) => {
+        const { quiet = false, captureTailCapBytes = CAPTURE_TAIL_CAP_BYTES } = options;
+        const child = spawn(command, {
+            cwd,
+            stdio: quiet ? ['ignore', 'pipe', 'pipe'] : 'inherit',
+            shell: true,
+        });
+        // Collect raw bytes (capped per stream) and decode once at close — avoids
+        // mojibake from a UTF-8 character split across two `data` chunks, and keeps
+        // both the envelope and the OneDS event size-bounded under chatty builds.
+        const stdoutSink = makeSink();
+        const stderrSink = makeSink();
+        if (quiet) {
+            child.stdout?.on('data', (c) => appendCapped(stdoutSink, c, captureTailCapBytes));
+            child.stderr?.on('data', (c) => appendCapped(stderrSink, c, captureTailCapBytes));
+        }
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            const base = `Command exited with code ${code}: ${command}`;
+            if (!quiet) {
+                reject(new AppError(base, code ?? 1));
+                return;
+            }
+            const stderr = decodeSink(stderrSink);
+            const stdout = decodeSink(stdoutSink);
+            const detail = stderr.length > 0 ? stderr : stdout;
+            const message = detail.length > 0 ? `${base}\n${detail}` : 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":"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"}

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/managed-apps-common/config';
+import { BuildArtifactTooLargeError, UsageError } from '@microsoft/managed-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"}