@microsoft/managed-apps-cli 0.9.2 → 0.11.0

package/dist/Utils/GitUtils.js

@@ -1,7 +1,8 @@
 /*!
  * Copyright (C) Microsoft Corporation. All rights reserved.
  */
-import { execSync } from 'child_process';
+import { execFileSync } from 'child_process';
+import { runGit } from './GitRunner.js';
 /**
  * Reads the current branch and commit SHA from the working directory's git repo.
  * Returns null when git is unavailable or the directory is not a git repo.
@@ -9,28 +10,89 @@ import { execSync } from 'child_process';
  * literal string 'HEAD' and callers should not treat it as a branch name.
  */
 export function resolveGitDefaults() {
-    try {
-        const commitSha = execSync('git rev-parse HEAD', { stdio: 'pipe' }).toString().trim();
-        const branch = execSync('git rev-parse --abbrev-ref HEAD', { stdio: 'pipe' }).toString().trim();
-        return { branch, commitSha, detached: branch === 'HEAD' };
-    }
-    catch {
+    const sha = runGit(['rev-parse', 'HEAD'], {
+        captureStdout: true,
+        allowFailure: true,
+        emitStderr: false,
+    });
+    if (!sha.success)
         return null;
-    }
+    const ref = runGit(['rev-parse', '--abbrev-ref', 'HEAD'], {
+        captureStdout: true,
+        allowFailure: true,
+        emitStderr: false,
+    });
+    if (!ref.success)
+        return null;
+    const commitSha = sha.stdout.trim();
+    const branch = ref.stdout.trim();
+    return { branch, commitSha, detached: branch === 'HEAD' };
 }
 /**
  * Reads the current git remote origin URL from the working directory's git repo.
  * Returns null when git is unavailable or the directory is not a git repo
  */
 export function getCurrentGitRemoteUrl() {
+    const result = runGit(['config', '--get', 'remote.origin.url'], {
+        captureStdout: true,
+        allowFailure: true,
+        emitStderr: false,
+    });
+    if (!result.success)
+        return undefined;
+    return result.stdout.trim() || undefined;
+}
+// Only allow transport schemes the platform actually returns: HTTPS clone URLs
+// (native Azure DevOps and GitHub HTTPS) and SSH clone URLs. This blocks git's
+// `ext::`, `fd::`, and similar protocols that can spawn external commands as
+// transport helpers without the shell ever being involved.
+const allowedGitRemoteSchemes = ['https://', 'ssh://', 'git@'];
+function isSafeGitRemoteUrl(remoteUrl) {
+    return (allowedGitRemoteSchemes.some((scheme) => remoteUrl.startsWith(scheme)) &&
+        remoteUrl.trim() === remoteUrl &&
+        !remoteUrl.startsWith('-') &&
+        !/[\r\n\0]/.test(remoteUrl));
+}
+// A failing `execFileSync` sets `error.message` to
+// "Command failed: git remote add origin <url>", embedding the remote URL
+// verbatim. If that URL ever carries credentials (e.g. https://<PAT>@host/...),
+// returning the raw message would leak the secret into telemetry. Redact any
+// userinfo segment before surfacing the error to callers.
+function scrubGitErrorMessage(message) {
+    return message.replace(/:\/\/[^@\s/]+@/g, '://[REDACTED]@');
+}
+/**
+ * Initializes a local git repository in the current working directory and
+ * optionally configures the origin remote in the supplied working directory.
+ * Returns true when `git init` succeeds, false when git is unavailable or the
+ * command fails for any reason (e.g. permissions). Callers should treat false as
+ * a soft failure — the app was already created; git can be initialized manually.
+ */
+export function initializeLocalGitRepo(remoteUrl, cwd = process.cwd()) {
     try {
-        const remoteUrl = execSync('git config --get remote.origin.url', { stdio: 'pipe' })
-            .toString()
-            .trim();
-        return remoteUrl || undefined;
+        if (remoteUrl !== undefined && !isSafeGitRemoteUrl(remoteUrl)) {
+            return {
+                success: false,
+                error: 'Unsafe git remote URL.',
+            };
+        }
+        execFileSync('git', ['init'], { stdio: 'pipe', windowsHide: true, cwd });
+        if (remoteUrl) {
+            execFileSync('git', ['remote', 'add', 'origin', remoteUrl], {
+                stdio: 'pipe',
+                windowsHide: true,
+                cwd,
+            });
+        }
+        return {
+            success: true,
+        };
     }
-    catch {
-        return undefined;
+    catch (error) {
+        return {
+            success: false,
+            error: scrubGitErrorMessage(error instanceof Error ? error.message : String(error)),
+        };
     }
 }
 /**
@@ -39,12 +101,13 @@ export function getCurrentGitRemoteUrl() {
  * the check rather than treat it as a clean tree.
  */
 export function hasUncommittedChanges() {
-    try {
-        const status = execSync('git status --porcelain', { stdio: 'pipe' }).toString().trim();
-        return status.length > 0;
-    }
-    catch {
+    const result = runGit(['status', '--porcelain'], {
+        captureStdout: true,
+        allowFailure: true,
+        emitStderr: false,
+    });
+    if (!result.success)
         return null;
-    }
+    return result.stdout.trim().length > 0;
 }
 //# sourceMappingURL=GitUtils.js.map

package/dist/Utils/GitUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"GitUtils.js","sourceRoot":"","sources":["../../src/Utils/GitUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAQzC;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,QAAQ,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QACtF,MAAM,MAAM,GAAG,QAAQ,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QAChG,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,QAAQ,CAAC,oCAAoC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;aAChF,QAAQ,EAAE;aACV,IAAI,EAAE,CAAC;QACV,OAAO,SAAS,IAAI,SAAS,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,wBAAwB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QACvF,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"GitUtils.js","sourceRoot":"","sources":["../../src/Utils/GitUtils.ts"],"names":[],"mappings":"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"}

package/dist/Utils/GitVersionChecker.d.ts

@@ -0,0 +1,38 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * Preflight guard for `ms app create`: throws `ConfigurationError` when `git` is
+ * missing from PATH, or present but older than this package's `engines.git`
+ * range. Runs ahead of any server call so a local-tooling misconfiguration fails
+ * fast and never leaves an orphaned MAAF app + GRS repo behind.
+ *
+ * The floor lives in `engines.git` (currently `>=2.27.0`), bound by
+ * `git clone --sparse` + `git sparse-checkout set` in cone-mode-by-default — both
+ * landed in git 2.27.0 (Jun 2020). Every other git invocation in the verb
+ * (init/add/commit/push/clone/fetch/checkout, plus `-C` and `--filter=blob:none`)
+ * needs older versions, so 2.27.0 is the cumulative floor.
+ *
+ * Note that `engines.git` is NOT a recognised key in npm / bun / yarn / pnpm —
+ * none of them check it at install time (the only `engines` keys with built-in
+ * enforcement are `node` and the package manager's own name, and even those
+ * default to warn-not-fail). The runtime check below is the sole enforcement
+ * point; the manifest entry is documentation and the source of truth this
+ * function reads back.
+ *
+ * Failure postures, by input source:
+ *   - `engines.git` lives in our own `package.json`, so a missing / invalid
+ *     value would be a CLI bug. The runtime silently no-ops in that case —
+ *     blocking a user over OUR misconfiguration would be the wrong trade.
+ *     The `GitVersionChecker.test.ts` "engines.git is non-empty and a valid
+ *     semver range" test fails the build if the manifest is broken, so the
+ *     misconfig never reaches production.
+ *   - `git --version` output comes from whatever git is on the user's PATH.
+ *     Real-world dialects include `git version 2.45.2.windows.1`, `git version
+ *     2.39.5 (Apple Git-154)`, RC/dev suffixes, etc. `semver.coerce` extracts
+ *     the leading `<major>.<minor>.<patch>` from any of them; if it can't, we
+ *     fail open so a non-standard distribution doesn't get blocked over a
+ *     format we couldn't predict.
+ */
+export declare function ensureGitInstalled(): void;
+//# sourceMappingURL=GitVersionChecker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GitVersionChecker.d.ts","sourceRoot":"","sources":["../../src/Utils/GitVersionChecker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAuBzC"}

package/dist/Utils/GitVersionChecker.js

@@ -0,0 +1,64 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import semver from 'semver';
+import packageJson from '../../package.json' with { type: 'json' };
+import { ConfigurationError } from '../Errors/CliError.js';
+import { runGit } from './GitRunner.js';
+/**
+ * Preflight guard for `ms app create`: throws `ConfigurationError` when `git` is
+ * missing from PATH, or present but older than this package's `engines.git`
+ * range. Runs ahead of any server call so a local-tooling misconfiguration fails
+ * fast and never leaves an orphaned MAAF app + GRS repo behind.
+ *
+ * The floor lives in `engines.git` (currently `>=2.27.0`), bound by
+ * `git clone --sparse` + `git sparse-checkout set` in cone-mode-by-default — both
+ * landed in git 2.27.0 (Jun 2020). Every other git invocation in the verb
+ * (init/add/commit/push/clone/fetch/checkout, plus `-C` and `--filter=blob:none`)
+ * needs older versions, so 2.27.0 is the cumulative floor.
+ *
+ * Note that `engines.git` is NOT a recognised key in npm / bun / yarn / pnpm —
+ * none of them check it at install time (the only `engines` keys with built-in
+ * enforcement are `node` and the package manager's own name, and even those
+ * default to warn-not-fail). The runtime check below is the sole enforcement
+ * point; the manifest entry is documentation and the source of truth this
+ * function reads back.
+ *
+ * Failure postures, by input source:
+ *   - `engines.git` lives in our own `package.json`, so a missing / invalid
+ *     value would be a CLI bug. The runtime silently no-ops in that case —
+ *     blocking a user over OUR misconfiguration would be the wrong trade.
+ *     The `GitVersionChecker.test.ts` "engines.git is non-empty and a valid
+ *     semver range" test fails the build if the manifest is broken, so the
+ *     misconfig never reaches production.
+ *   - `git --version` output comes from whatever git is on the user's PATH.
+ *     Real-world dialects include `git version 2.45.2.windows.1`, `git version
+ *     2.39.5 (Apple Git-154)`, RC/dev suffixes, etc. `semver.coerce` extracts
+ *     the leading `<major>.<minor>.<patch>` from any of them; if it can't, we
+ *     fail open so a non-standard distribution doesn't get blocked over a
+ *     format we couldn't predict.
+ */
+export function ensureGitInstalled() {
+    // `runGit` with allowFailure turns a missing-git spawn failure into a
+    // structured result instead of a throw; emitStderr is off because we own the
+    // user-facing message here (the raw "command not found" stderr would be noise).
+    const result = runGit(['--version'], {
+        captureStdout: true,
+        allowFailure: true,
+        emitStderr: false,
+    });
+    if (!result.success) {
+        throw new ConfigurationError("'git' is required but was not found on PATH.");
+    }
+    const versionOutput = result.stdout;
+    const required = packageJson.engines.git;
+    if (!semver.validRange(required))
+        return;
+    const found = semver.coerce(versionOutput);
+    if (!found)
+        return;
+    if (semver.satisfies(found, required))
+        return;
+    throw new ConfigurationError(`Git ${required} is required (found ${found.version}). Please upgrade git.`);
+}
+//# sourceMappingURL=GitVersionChecker.js.map

package/dist/Utils/GitVersionChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitVersionChecker.js","sourceRoot":"","sources":["../../src/Utils/GitVersionChecker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,kBAAkB;IAChC,sEAAsE;IACtE,6EAA6E;IAC7E,gFAAgF;IAChF,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,WAAW,CAAC,EAAE;QACnC,aAAa,EAAE,IAAI;QACnB,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,KAAK;KAClB,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAAC,8CAA8C,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IAEpC,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC;QAAE,OAAO;IAE9C,MAAM,IAAI,kBAAkB,CAC1B,OAAO,QAAQ,uBAAuB,KAAK,CAAC,OAAO,wBAAwB,CAC5E,CAAC;AACJ,CAAC"}

package/dist/Utils/MaafAppConfig.d.ts

@@ -0,0 +1,22 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { AppConfig, RepoType } from '@microsoft/managed-apps-common/config';
+interface BuildMaafAppConfigOptions {
+    appId: string;
+    appDisplayName: string;
+    description: string | null | undefined;
+    environmentId: string;
+    repoType: RepoType;
+    cloud: AppConfig['cloud'];
+    buildPath?: string;
+    buildCommand?: string;
+    buildEntryPoint?: string;
+    repositoryId?: string;
+    externalRepoUrl?: string;
+    appSettings?: AppConfig['appSettings'];
+    connectionReferences?: AppConfig['connectionReferences'];
+}
+export declare function buildMaafAppConfig(options: BuildMaafAppConfigOptions): AppConfig;
+export {};
+//# sourceMappingURL=MaafAppConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MaafAppConfig.d.ts","sourceRoot":"","sources":["../../src/Utils/MaafAppConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAGjF,UAAU,yBAAyB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;IACvC,oBAAoB,CAAC,EAAE,SAAS,CAAC,sBAAsB,CAAC,CAAC;CAC1D;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,SAAS,CA+BhF"}

package/dist/Utils/MaafAppConfig.js

@@ -0,0 +1,32 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { VERSION } from '@microsoft/managed-apps-common/config';
+export function buildMaafAppConfig(options) {
+    const appConfig = {
+        version: VERSION,
+        appId: options.appId,
+        appDisplayName: options.appDisplayName,
+        environmentId: options.environmentId,
+        description: options.description,
+        repoType: options.repoType,
+        cloud: options.cloud,
+        buildPath: options.buildPath ?? './dist',
+        buildCommand: options.buildCommand ?? 'npm run build',
+        buildEntryPoint: options.buildEntryPoint ?? 'index.html',
+    };
+    if (options.repositoryId) {
+        appConfig.repositoryId = options.repositoryId;
+    }
+    if (options.externalRepoUrl) {
+        appConfig.externalRepoUrl = options.externalRepoUrl;
+    }
+    if (options.connectionReferences !== undefined) {
+        appConfig.connectionReferences = options.connectionReferences;
+    }
+    if (options.appSettings !== undefined) {
+        appConfig.appSettings = options.appSettings;
+    }
+    return appConfig;
+}
+//# sourceMappingURL=MaafAppConfig.js.map

package/dist/Utils/MaafAppConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaafAppConfig.js","sourceRoot":"","sources":["../../src/Utils/MaafAppConfig.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAkBhE,MAAM,UAAU,kBAAkB,CAAC,OAAkC;IACnE,MAAM,SAAS,GAAc;QAC3B,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,cAAc,EAAE,OAAO,CAAC,cAAc;QACtC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,QAAQ;QACxC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,eAAe;QACrD,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,YAAY;KACzD,CAAC;IAEF,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzB,SAAS,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAChD,CAAC;IAED,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;QAC5B,SAAS,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IACtD,CAAC;IAED,IAAI,OAAO,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;QAC/C,SAAS,CAAC,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAChE,CAAC;IAED,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,SAAS,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAC9C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/Utils/NodeVersionChecker.d.ts

@@ -2,12 +2,9 @@
  * Copyright (C) Microsoft Corporation. All rights reserved.
  */
 /**
- * Best-effort guard: warn (never throw) when the running Node.js is older than the
- * minimum declared in this package's `engines.node`. Mirrors `scripts/check-bun-version.ts`.
- * Emits via `printWarning` — stderr, so it can't corrupt a `--json` stdout envelope, with
- * NO_COLOR/TTY handled by `styleText`.
+ * Best-effort guard: warn (never throw) when the running Node.js doesn't satisfy this package's
+ * `engines.node` range. Mirrors `scripts/check-bun-version.ts`. Emits via `printWarning` — stderr,
+ * so it can't corrupt a `--json` stdout envelope, with NO_COLOR/TTY handled by `styleText`.
  */
 export declare function warnIfNodeVersionUnsupported(): void;
-/** Parse the leading `major.minor.patch` out of a version or range string (`>=24.5.0` → `[24, 5, 0]`). */
-export declare function parseVersion(value: string): number[];
 //# sourceMappingURL=NodeVersionChecker.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"NodeVersionChecker.d.ts","sourceRoot":"","sources":["../../src/Utils/NodeVersionChecker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;;;GAKG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAWnD;AAED,0GAA0G;AAC1G,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAGpD"}
+{"version":3,"file":"NodeVersionChecker.d.ts","sourceRoot":"","sources":["../../src/Utils/NodeVersionChecker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAWnD"}

package/dist/Utils/NodeVersionChecker.js

@@ -1,38 +1,21 @@
 /*!
  * Copyright (C) Microsoft Corporation. All rights reserved.
  */
+import semver from 'semver';
 import packageJson from '../../package.json' with { type: 'json' };
 import { printWarning } from './ConsoleOutput.js';
 /**
- * Best-effort guard: warn (never throw) when the running Node.js is older than the
- * minimum declared in this package's `engines.node`. Mirrors `scripts/check-bun-version.ts`.
- * Emits via `printWarning` — stderr, so it can't corrupt a `--json` stdout envelope, with
- * NO_COLOR/TTY handled by `styleText`.
+ * Best-effort guard: warn (never throw) when the running Node.js doesn't satisfy this package's
+ * `engines.node` range. Mirrors `scripts/check-bun-version.ts`. Emits via `printWarning` — stderr,
+ * so it can't corrupt a `--json` stdout envelope, with NO_COLOR/TTY handled by `styleText`.
  */
 export function warnIfNodeVersionUnsupported() {
-    const required = packageJson.engines?.node;
-    if (!required)
+    const required = packageJson.engines.node;
+    // `semver` lets the engine be any valid range (e.g. `>=24.11.0`, or `^24 || >=26` to allow 24 and
+    // 26 but not 25). An invalid range counts as unsupported; the check never throws.
+    if (Boolean(semver.validRange(required)) && semver.satisfies(process.versions.node, required)) {
         return;
-    const requiredParts = parseVersion(required);
-    if (requiredParts.length === 0)
-        return;
-    if (!isVersionLower(parseVersion(process.versions.node), requiredParts))
-        return;
-    printWarning(`Warning: Your Node.js version ${process.versions.node} doesn't match required version ${required}; please upgrade Node.js.`);
-}
-/** Parse the leading `major.minor.patch` out of a version or range string (`>=24.5.0` → `[24, 5, 0]`). */
-export function parseVersion(value) {
-    const match = value.match(/(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
-    return match ? [Number(match[1]), Number(match[2] ?? 0), Number(match[3] ?? 0)] : [];
-}
-/** True when `actual` is strictly older than `required`, compared by major, then minor, then patch. */
-function isVersionLower(actual, required) {
-    for (let i = 0; i < 3; i++) {
-        const a = actual[i] ?? 0;
-        const r = required[i] ?? 0;
-        if (a !== r)
-            return a < r;
     }
-    return false;
+    printWarning(`Warning: Your Node.js version ${process.versions.node} doesn't match requirement ${required}; Please install a compatible Node.js version.`);
 }
 //# sourceMappingURL=NodeVersionChecker.js.map

package/dist/Utils/NodeVersionChecker.js.map

@@ -1 +1 @@
-{"version":3,"file":"NodeVersionChecker.js","sourceRoot":"","sources":["../../src/Utils/NodeVersionChecker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B;IAC1C,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC;IAC3C,IAAI,CAAC,QAAQ;QAAE,OAAO;IAEtB,MAAM,aAAa,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACvC,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;QAAE,OAAO;IAEhF,YAAY,CACV,iCAAiC,OAAO,CAAC,QAAQ,CAAC,IAAI,mCAAmC,QAAQ,2BAA2B,CAC7H,CAAC;AACJ,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACvF,CAAC;AAED,uGAAuG;AACvG,SAAS,cAAc,CAAC,MAAgB,EAAE,QAAkB;IAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"NodeVersionChecker.js","sourceRoot":"","sources":["../../src/Utils/NodeVersionChecker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,4BAA4B;IAC1C,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;IAC1C,kGAAkG;IAClG,kFAAkF;IAClF,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC9F,OAAO;IACT,CAAC;IAED,YAAY,CACV,iCAAiC,OAAO,CAAC,QAAQ,CAAC,IAAI,8BAA8B,QAAQ,gDAAgD,CAC7I,CAAC;AACJ,CAAC"}

package/dist/Utils/Paging.d.ts

@@ -8,6 +8,11 @@ export declare const PAGE_SIZE = 20;
  * Enter/Space = continue, Esc/q = exit, Ctrl+C = process exit.
  */
 export declare function waitForPageKey(): Promise<'continue' | 'exit'>;
+/**
+ * Prints a paginated text blob in TTY mode (PAGE_SIZE lines per page,
+ * Enter/Esc to navigate) or the full text in non-TTY/piped mode.
+ */
+export declare function printPagedText(text: string): Promise<void>;
 /**
  * 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.
@@ -19,5 +24,6 @@ export declare function printPagedTable(options: {
     rows: string[][];
     emptyMessage?: string;
     totalLabel: string;
+    hint?: string;
 }): Promise<void>;
 //# sourceMappingURL=Paging.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Paging.d.ts","sourceRoot":"","sources":["../../src/Utils/Paging.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,CA2BnE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BhB"}
+{"version":3,"file":"Paging.d.ts","sourceRoot":"","sources":["../../src/Utils/Paging.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,CA2BnE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BhE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAkChB"}

package/dist/Utils/Paging.js

@@ -35,16 +35,48 @@ export async function waitForPageKey() {
         process.stdin.on('keypress', handler);
     });
 }
+/**
+ * Prints a paginated text blob in TTY mode (PAGE_SIZE lines per page,
+ * Enter/Esc to navigate) or the full text in non-TTY/piped mode.
+ */
+export async function printPagedText(text) {
+    const lines = text.split(/\r?\n/);
+    if (!process.stdout.isTTY) {
+        for (const line of lines) {
+            console.log(line);
+        }
+        return;
+    }
+    const total = lines.length;
+    const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE));
+    for (let page = 0; page < totalPages; page++) {
+        const start = page * PAGE_SIZE;
+        const pageLines = lines.slice(start, start + PAGE_SIZE);
+        const isLastPage = page === totalPages - 1;
+        for (const line of pageLines) {
+            console.log(line);
+        }
+        if (isLastPage)
+            break;
+        console.log(styleText('dim', '  Press Enter for more, Esc or q to exit'));
+        const action = await waitForPageKey();
+        if (action === 'exit')
+            break;
+    }
+}
 /**
  * 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 { title, metadata, columns, rows, emptyMessage, totalLabel, hint } = options;
     const total = rows.length;
     if (!process.stdout.isTTY) {
         printTable({ title, metadata, columns, rows, emptyMessage });
         console.log(styleText('dim', `  Showing ${total} of ${total} ${totalLabel}`));
+        if (hint) {
+            console.log(styleText('dim', `  ${hint}`));
+        }
         return;
     }
     const totalPages = Math.max(1, Math.ceil(total / PAGE_SIZE));
@@ -54,6 +86,9 @@ export async function printPagedTable(options) {
         const isLastPage = page === totalPages - 1;
         printTable({ title, metadata, columns, rows: pageRows, emptyMessage });
         console.log(styleText('dim', `  Showing ${start + pageRows.length} of ${total} ${totalLabel}`));
+        if (hint) {
+            console.log(styleText('dim', `  ${hint}`));
+        }
         if (!isLastPage) {
             console.log(styleText('dim', '  Press Enter for more, Esc or q to exit'));
         }

package/dist/Utils/Paging.js.map

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

package/dist/Utils/PinCli.d.ts

@@ -0,0 +1,28 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * Pins the running CLI into an app's `package.json` as a `devDependency` at the
+ * exact version of the CLI executing the command (read from this package's own
+ * manifest, so it always matches the running CLI).
+ *
+ * Used by `ms app create` (right after the template is scaffolded) and `ms app
+ * init` (binding an existing project) so the app carries a project-local `ms` at
+ * the version it was set up with — which `npx ms` / `pnpm exec` / `bun x` resolve
+ * ahead of any globally-installed CLI. The app therefore keeps building and
+ * deploying against the CLI it was created with, even if the developer's global
+ * CLI later moves to an incompatible version.
+ *
+ * Best-effort and non-fatal — the server-side app already exists by the time this
+ * runs:
+ *   - No `package.json` in `appDir` (e.g. `ms app create` with a custom
+ *     `--template` that isn't an npm project) → nothing to pin; return quietly.
+ *   - Read / parse / write failure → warn (outside `--json` mode) and continue;
+ *     the user can add the pin by hand.
+ *
+ * The entry overwrites any existing CLI `devDependencies` entry, and
+ * `devDependencies` is re-sorted alphabetically to match the npm convention so a
+ * later `install --save` won't reshuffle the file.
+ */
+export declare function pinCliIntoAppPackageJson(appDir: string, jsonMode: boolean): void;
+//# sourceMappingURL=PinCli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PinCli.d.ts","sourceRoot":"","sources":["../../src/Utils/PinCli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAiChF"}

package/dist/Utils/PinCli.js

@@ -0,0 +1,58 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import packageJson from '../../package.json' with { type: 'json' };
+import { printWarning } from './ConsoleOutput.js';
+/**
+ * Pins the running CLI into an app's `package.json` as a `devDependency` at the
+ * exact version of the CLI executing the command (read from this package's own
+ * manifest, so it always matches the running CLI).
+ *
+ * Used by `ms app create` (right after the template is scaffolded) and `ms app
+ * init` (binding an existing project) so the app carries a project-local `ms` at
+ * the version it was set up with — which `npx ms` / `pnpm exec` / `bun x` resolve
+ * ahead of any globally-installed CLI. The app therefore keeps building and
+ * deploying against the CLI it was created with, even if the developer's global
+ * CLI later moves to an incompatible version.
+ *
+ * Best-effort and non-fatal — the server-side app already exists by the time this
+ * runs:
+ *   - No `package.json` in `appDir` (e.g. `ms app create` with a custom
+ *     `--template` that isn't an npm project) → nothing to pin; return quietly.
+ *   - Read / parse / write failure → warn (outside `--json` mode) and continue;
+ *     the user can add the pin by hand.
+ *
+ * The entry overwrites any existing CLI `devDependencies` entry, and
+ * `devDependencies` is re-sorted alphabetically to match the npm convention so a
+ * later `install --save` won't reshuffle the file.
+ */
+export function pinCliIntoAppPackageJson(appDir, jsonMode) {
+    const packageJsonPath = path.join(appDir, 'package.json');
+    // existsSync gate keeps the common "not an npm project" case off the warning
+    // path below — only genuine read/parse/write failures should warn.
+    if (!fs.existsSync(packageJsonPath)) {
+        return;
+    }
+    try {
+        const manifest = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        manifest.devDependencies = Object.fromEntries(Object.entries({
+            ...manifest.devDependencies,
+            [packageJson.name]: packageJson.version,
+            // Explicit 'en' locale keeps the sort order deterministic across hosts
+            // (a bare localeCompare follows the machine's default collation).
+        }).sort(([a], [b]) => a.localeCompare(b, 'en')));
+        // JSON.stringify drops the trailing newline every scaffolder emits; re-add it.
+        fs.writeFileSync(packageJsonPath, `${JSON.stringify(manifest, null, 2)}\n`);
+    }
+    catch (err) {
+        if (!jsonMode) {
+            printWarning(`Could not pin '${packageJson.name}' into ${packageJsonPath} ` +
+                `(${err instanceof Error ? err.message : String(err)}). Add ` +
+                `"${packageJson.name}": "${packageJson.version}" to devDependencies manually ` +
+                `to get a project-local CLI.`);
+        }
+    }
+}
+//# sourceMappingURL=PinCli.js.map

package/dist/Utils/PinCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PinCli.js","sourceRoot":"","sources":["../../src/Utils/PinCli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAc,EAAE,QAAiB;IACxE,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1D,6EAA6E;IAC7E,mEAAmE;IACnE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACpC,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAGnE,CAAC;QACF,QAAQ,CAAC,eAAe,GAAG,MAAM,CAAC,WAAW,CAC3C,MAAM,CAAC,OAAO,CAAC;YACb,GAAG,QAAQ,CAAC,eAAe;YAC3B,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC,OAAO;YACvC,uEAAuE;YACvE,kEAAkE;SACnE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAChD,CAAC;QACF,+EAA+E;QAC/E,EAAE,CAAC,aAAa,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,YAAY,CACV,kBAAkB,WAAW,CAAC,IAAI,UAAU,eAAe,GAAG;gBAC5D,IAAI,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS;gBAC7D,IAAI,WAAW,CAAC,IAAI,OAAO,WAAW,CAAC,OAAO,gCAAgC;gBAC9E,6BAA6B,CAChC,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/Utils/RepoDetails.d.ts

@@ -0,0 +1,29 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { MaafAppDefinition, ManagedAppRepoType } from '@microsoft/managed-apps-actions';
+/** Display-ready repository classification + clone URL derived from a `MaafAppDefinition`. */
+export type RepoDetails = {
+    /**
+     * Repository-type label for display. Known {@link ManagedAppRepoType} values
+     * are mapped to friendly labels; unknown/forward-compat values pass through
+     * as the raw server string (see {@link friendlyRepoType}).
+     */
+    repoType?: string;
+    /** Git clone URL for the backing repository, when applicable. */
+    cloneUrl?: string;
+};
+/**
+ * Maps the raw {@link ManagedAppRepoType} enum returned by the server to a
+ * human-friendly label for display. Unknown/forward-compat values fall through
+ * to the raw string; `undefined` (legacy apps with no source-control metadata)
+ * yields `undefined` so callers can omit the line entirely.
+ */
+export declare function friendlyRepoType(repoType: ManagedAppRepoType | undefined): string | undefined;
+/**
+ * Derives the display-ready {@link RepoDetails} from an app definition. Returns
+ * `undefined` when the app exposes no source-control metadata at all (no
+ * `repoType` and no `cloneUrl`), so callers can omit the lines entirely.
+ */
+export declare function toRepoDetails(app: Pick<MaafAppDefinition, 'repoType' | 'cloneUrl'>): RepoDetails | undefined;
+//# sourceMappingURL=RepoDetails.d.ts.map