@microsoft/managed-apps-cli 0.9.1 → 0.10.0

package/dist/Utils/DownloadTemplate.js

@@ -0,0 +1,159 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { execFileSync } from 'child_process';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { UsageError } from '../Errors/CliError.js';
+/**
+ * Parses a template source. Accepted shapes:
+ *
+ *   github:<owner>/<repo>[/<subdir>...][#<ref>]
+ *   gh:<owner>/<repo>[/<subdir>...][#<ref>]            (shorthand)
+ *   <owner>/<repo>[/<subdir>...][#<ref>]               (prefix optional)
+ *   https://github.com/<owner>/<repo>[.git][#<ref>]
+ *   https://github.com/<owner>/<repo>/tree/<ref>[/<subdir>]
+ *
+ * Throws `UsageError` for any other shape — non-github providers (`gitlab:`,
+ * `bitbucket:`, …), arbitrary tarball URLs, and github file URLs (`/blob/...`).
+ * The CLI is intentionally github-only here: github is the only provider in
+ * real use, and authentication against private github repos already flows
+ * through the user's normal git credential setup.
+ */
+export function parseGithubTemplate(source) {
+    if (!source) {
+        throw new UsageError('Template source is empty. Use --template to specify one.');
+    }
+    // 1. Raw github.com URL — common when the user pastes from a browser
+    //    address bar. We use the WHATWG URL parser rather than regex so query
+    //    params (`?tab=readme`), mixed-case hosts, trailing slashes, embedded
+    //    userinfo, and percent-encoded segments all get normalised away
+    //    automatically. The path is then matched against the two shapes we
+    //    support: bare-repo (`/<owner>/<repo>[.git]`) and the web-UI subdir
+    //    form (`/<owner>/<repo>/tree/<branch>[/<subdir>...]`). `/blob/...`
+    //    (file URLs) and any other path shape are rejected with a clear error
+    //    so the failure isn't a confusing mid-flow clone failure.
+    if (/^https?:\/\//i.test(source)) {
+        let url;
+        try {
+            url = new URL(source);
+        }
+        catch {
+            throw new UsageError(`Template source '${source}' is not a valid URL.`);
+        }
+        if (url.hostname.toLowerCase() !== 'github.com') {
+            throw new UsageError(`Template source '${source}' uses host '${url.hostname}'; only github.com URLs are supported.`);
+        }
+        const segments = url.pathname.split('/').filter(Boolean);
+        if (segments.length < 2) {
+            throw new UsageError(`Template source '${source}' is missing the owner/repo path. ` +
+                `Use 'https://github.com/<owner>/<repo>'.`);
+        }
+        const [owner, rawRepo, ...rest] = segments;
+        const repo = rawRepo.endsWith('.git') ? rawRepo.slice(0, -'.git'.length) : rawRepo;
+        const hashRef = url.hash ? url.hash.slice(1) : undefined;
+        if (rest.length === 0) {
+            return { owner, repo, subdir: '', ref: hashRef };
+        }
+        // Web-UI subdir form: /<owner>/<repo>/tree/<branch>[/<subdir>...]. We can't
+        // disambiguate `branch` from `subdir` when the branch name contains a `/`
+        // (we'd need to look up refs on the server). The downloadTemplate
+        // subdir-not-found error tells the user to switch to the `#<ref>` shorthand.
+        if (rest[0].toLowerCase() === 'tree' && rest.length >= 2) {
+            return {
+                owner,
+                repo,
+                subdir: rest.slice(2).join('/'),
+                ref: hashRef ?? rest[1],
+            };
+        }
+        if (rest[0].toLowerCase() === 'blob') {
+            throw new UsageError(`Template source '${source}' points at a file ('/blob/...'). ` +
+                `Templates must be a directory — use the '/tree/<branch>/<subdir>' URL form instead.`);
+        }
+        throw new UsageError(`Template source '${source}' has an unrecognised path. Use ` +
+            `'https://github.com/<owner>/<repo>' or ` +
+            `'https://github.com/<owner>/<repo>/tree/<branch>/<subdir>'.`);
+    }
+    // 2. Reject any prefix other than `github:` or `gh:` up front so the failure
+    //    mode is a clear preflight error rather than a confusing clone failure.
+    const prefixMatch = /^([a-z][a-z0-9+.-]*):/i.exec(source);
+    if (prefixMatch) {
+        const prefix = prefixMatch[1].toLowerCase();
+        if (prefix !== 'github' && prefix !== 'gh') {
+            throw new UsageError(`Template source '${source}' uses unsupported provider prefix '${prefixMatch[1]}:'. ` +
+                `Only 'github:' (or 'gh:' shorthand) templates are supported.`);
+        }
+    }
+    // 3. Shorthand: 'github:owner/repo[/subdir][#ref]', 'gh:owner/repo[...]', or
+    //    bare 'owner/repo[...]'.
+    const stripped = source.replace(/^(?:github|gh):/i, '');
+    const [pathPart, ref] = stripped.split('#', 2);
+    const parts = pathPart.split('/').filter(Boolean);
+    if (parts.length < 2) {
+        throw new UsageError(`Template source '${source}' is missing the owner/repo path. ` +
+            `Expected 'github:<owner>/<repo>[/<subdir>]'.`);
+    }
+    const [owner, repo, ...subdirParts] = parts;
+    return { owner, repo, subdir: subdirParts.join('/'), ref: ref || undefined };
+}
+/**
+ * Downloads a github-hosted template into `dir`. Uses a shallow + partial +
+ * sparse clone so only the requested subdirectory is fetched, then copies the
+ * working tree into place via `fs.cpSync` and discards the temporary clone.
+ *
+ * Requires `git` on PATH; callers should run `ensureGitInstalled` in preflight
+ * so a missing-git failure surfaces before any server call. Authentication for
+ * private repos flows through the user's existing git credential setup
+ * (gh, GCM, SSH key, PAT) — the CLI does not inject tokens at this layer.
+ */
+export function downloadTemplate(source, options) {
+    const parsed = parseGithubTemplate(source);
+    const repoUrl = `https://github.com/${parsed.owner}/${parsed.repo}.git`;
+    const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'ms-template-'));
+    try {
+        // `--filter=blob:none` defers blob download until checkout; combined with
+        // `--sparse` it means we only ever fetch blobs inside the requested
+        // subdir. For no-subdir templates we still want `--depth=1` for a shallow
+        // clone but skip `--sparse` so the whole tree checks out.
+        const cloneArgs = ['clone', '--depth=1', '--filter=blob:none'];
+        if (parsed.subdir)
+            cloneArgs.push('--sparse');
+        if (parsed.ref)
+            cloneArgs.push('--branch', parsed.ref);
+        cloneArgs.push(repoUrl, tmp);
+        execFileSync('git', cloneArgs, { stdio: ['ignore', 'ignore', 'inherit'] });
+        if (parsed.subdir) {
+            execFileSync('git', ['-C', tmp, 'sparse-checkout', 'set', parsed.subdir], {
+                stdio: ['ignore', 'ignore', 'inherit'],
+            });
+        }
+        const checkoutSource = parsed.subdir ? path.join(tmp, parsed.subdir) : tmp;
+        if (!fs.existsSync(checkoutSource)) {
+            // Common cause when this fires from the `/tree/<branch>/<subdir>` URL form:
+            // the branch name contains a `/` (e.g. `feat/foo`), and the parser took the
+            // first segment after `/tree/` as the ref — so `subdir` ended up shifted
+            // and the requested path doesn't exist. The shorthand `#<ref>` form is
+            // unambiguous and the recommended workaround.
+            throw new UsageError(`Template subdirectory '${parsed.subdir}' was not found in ` +
+                `https://github.com/${parsed.owner}/${parsed.repo}` +
+                `${parsed.ref ? ` at ref '${parsed.ref}'` : ''}. ` +
+                `If the branch name contains '/', use the ` +
+                `'github:<owner>/<repo>/<subdir>#<branch>' form to disambiguate.`);
+        }
+        fs.mkdirSync(options.dir, { recursive: true });
+        fs.cpSync(checkoutSource, options.dir, {
+            recursive: true,
+            force: true,
+            // Skip `.git` when copying. With `--sparse` + subdir the .git lives at
+            // `tmp/.git` (outside the copy source), so this matters mainly for the
+            // no-subdir path where the copy source IS the clone root.
+            filter: (src) => path.basename(src) !== '.git',
+        });
+    }
+    finally {
+        fs.rmSync(tmp, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=DownloadTemplate.js.map

package/dist/Utils/DownloadTemplate.js.map

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

package/dist/Utils/EnvVars.d.ts

@@ -1,7 +1,7 @@
 /*!
  * Copyright (C) Microsoft Corporation. All rights reserved.
  */
-export type CliEnvVarName = 'USE_SP_AUTH' | 'SP_CLIENT_ID' | 'SP_CLIENT_SECRET' | 'SP_TENANT_ID' | 'USE_HTTP_FORWARD' | 'HTTP_FORWARD_URL' | 'HTTP_FORWARD_AUTH_TOKEN' | 'HTTP_FORWARD_TENANT_ID' | 'ENABLE_CONNECTOR_USER_CONSENT' | 'REMOTE_TELEMETRY' | 'CONSOLE_TELEMETRY' | 'ORIGIN' | 'USE_MMA_APP_ID' | 'CONFIG_DIR' | 'WORKING_DIRECTORY' | 'MAAF_DEBUG_ENVIRONMENT_ID' | 'MAAF_GRS_ENDPOINT_OVERRIDE' | 'ENVIRONMENT_ID' | 'APP_DISPLAY_NAME' | 'APP_DESCRIPTION' | 'APP_ID' | 'APP_TEMPLATE' | 'APP_REPOSITORY_ID' | 'APP_REPO' | 'LOCAL_APP_URL' | 'BUILD_PATH' | 'BUILD_COMMAND' | 'BUILD_ENTRY_POINT' | 'CONFIG_ONLY' | 'PORT' | 'CLOUD_INSTANCE' | 'API_ID' | 'CONNECTION_ID' | 'CONNECTION_REF' | 'CONNECTOR_ID' | 'CONNECTOR_SEARCH' | 'CONNECTOR_ACTION_SEARCH' | 'DATASET' | 'TABLE' | 'TABLE_NAME' | 'DATA_SOURCE_NAME' | 'SEARCH_TERM' | 'DATAVERSE_API_SEARCH_TERM' | 'SQL_STORED_PROCEDURE' | 'ENV_URL' | 'SOLUTION_ID' | 'ADD_CONNECTOR_AS' | 'FLOW_ID' | 'FLOW_SEARCH' | 'FLOW_DATA_SOURCE_NAME' | 'REMOVE_FLOW_ID' | 'MAAF_APP_NAME' | 'MAAF_APP_ACCESS' | 'MAAF_COMMIT_SHA' | 'MAAF_PLAY_MODE' | 'MAAF_ENVIRONMENT_ID' | 'MAAF_SHARE_LINK_ID' | 'MAAF_DEPLOY_ARTIFACT' | 'MAAF_GITHUB_REPO' | 'LIST_ENVIRONMENT_ID' | 'LIST_PERMISSION' | 'SKIP_CODEGEN' | 'USE_V1_CODEGEN' | 'APP_SHOW_HEADER';
+export type CliEnvVarName = 'USE_SP_AUTH' | 'SP_CLIENT_ID' | 'SP_CLIENT_SECRET' | 'SP_TENANT_ID' | 'USE_HTTP_FORWARD' | 'HTTP_FORWARD_URL' | 'HTTP_FORWARD_AUTH_TOKEN' | 'HTTP_FORWARD_TENANT_ID' | 'ENABLE_CONNECTOR_USER_CONSENT' | 'REMOTE_TELEMETRY' | 'CONSOLE_TELEMETRY' | 'ORIGIN' | 'CONFIG_DIR' | 'WORKING_DIRECTORY' | 'MAAF_DEBUG_ENVIRONMENT_ID' | 'MAAF_GRS_ENDPOINT_OVERRIDE' | 'ENVIRONMENT_ID' | 'APP_DISPLAY_NAME' | 'APP_DESCRIPTION' | 'APP_ID' | 'APP_TEMPLATE' | 'APP_REPOSITORY_ID' | 'APP_REPO' | 'LOCAL_APP_URL' | 'BUILD_PATH' | 'BUILD_COMMAND' | 'BUILD_ENTRY_POINT' | 'CONFIG_ONLY' | 'PORT' | 'CLOUD_INSTANCE' | 'CONNECTOR' | 'CONNECTION_ID' | 'CONNECTION_REF' | 'CONNECTOR_ID' | 'CONNECTOR_SEARCH' | 'CONNECTOR_ACTION_SEARCH' | 'DATASET' | 'TABLE' | 'TABLE_NAME' | 'DATA_SOURCE_NAME' | 'SEARCH_TERM' | 'DATAVERSE_API_SEARCH_TERM' | 'DATAVERSE_ENVIRONMENT_ID' | 'SQL_STORED_PROCEDURE' | 'ENV_URL' | 'SOLUTION_ID' | 'ADD_CONNECTOR_AS' | 'FLOW_ID' | 'FLOW_SEARCH' | 'FLOW_DATA_SOURCE_NAME' | 'REMOVE_FLOW_ID' | 'MAAF_APP_NAME' | 'MAAF_APP_ACCESS' | 'MAAF_COMMIT_SHA' | 'MAAF_PLAY_MODE' | 'MAAF_ENVIRONMENT_ID' | 'MAAF_SHARE_LINK_ID' | 'MAAF_DEPLOY_ARTIFACT' | 'MAAF_GITHUB_REPO' | 'LIST_ENVIRONMENT_ID' | 'LIST_PERMISSION' | 'SKIP_CODEGEN' | 'USE_V1_CODEGEN' | 'APP_SHOW_HEADER';
 export declare function cliEnvVarFullName(name: CliEnvVarName): string;
 export declare function getCliEnvVar(name: CliEnvVarName): string | undefined;
 export declare function getCliEnvVarBool(name: CliEnvVarName): boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"EnvVars.d.ts","sourceRoot":"","sources":["../../src/Utils/EnvVars.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,MAAM,aAAa,GAErB,aAAa,GACb,cAAc,GACd,kBAAkB,GAClB,cAAc,GAEd,kBAAkB,GAClB,kBAAkB,GAClB,yBAAyB,GACzB,wBAAwB,GAExB,+BAA+B,GAE/B,kBAAkB,GAClB,mBAAmB,GACnB,QAAQ,GAER,gBAAgB,GAChB,YAAY,GACZ,mBAAmB,GACnB,2BAA2B,GAC3B,4BAA4B,GAE5B,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,QAAQ,GACR,cAAc,GACd,mBAAmB,GACnB,UAAU,GACV,eAAe,GACf,YAAY,GACZ,eAAe,GACf,mBAAmB,GACnB,aAAa,GACb,MAAM,GACN,gBAAgB,GAEhB,QAAQ,GACR,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,kBAAkB,GAClB,yBAAyB,GACzB,SAAS,GACT,OAAO,GACP,YAAY,GACZ,kBAAkB,GAClB,aAAa,GACb,2BAA2B,GAC3B,sBAAsB,GACtB,SAAS,GACT,aAAa,GACb,kBAAkB,GAElB,SAAS,GACT,aAAa,GACb,uBAAuB,GACvB,gBAAgB,GAEhB,eAAe,GACf,iBAAiB,GACjB,iBAAiB,GACjB,gBAAgB,GAChB,qBAAqB,GACrB,oBAAoB,GACpB,sBAAsB,GAEtB,kBAAkB,GAElB,qBAAqB,GACrB,iBAAiB,GAEjB,cAAc,GACd,gBAAgB,GAEhB,iBAAiB,CAAC;AAEtB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAE7D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAEpE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAE7D;AAED,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAErE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEjE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,WAAW,IAAI,OAAO,OAAO,CAAC,GAAG,CAEhD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,OAAO,CAAC,GAAG,GAAG,IAAI,CAE7D"}
+{"version":3,"file":"EnvVars.d.ts","sourceRoot":"","sources":["../../src/Utils/EnvVars.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,MAAM,aAAa,GAErB,aAAa,GACb,cAAc,GACd,kBAAkB,GAClB,cAAc,GAEd,kBAAkB,GAClB,kBAAkB,GAClB,yBAAyB,GACzB,wBAAwB,GAExB,+BAA+B,GAE/B,kBAAkB,GAClB,mBAAmB,GACnB,QAAQ,GAER,YAAY,GACZ,mBAAmB,GACnB,2BAA2B,GAC3B,4BAA4B,GAE5B,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,QAAQ,GACR,cAAc,GACd,mBAAmB,GACnB,UAAU,GACV,eAAe,GACf,YAAY,GACZ,eAAe,GACf,mBAAmB,GACnB,aAAa,GACb,MAAM,GACN,gBAAgB,GAEhB,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,kBAAkB,GAClB,yBAAyB,GACzB,SAAS,GACT,OAAO,GACP,YAAY,GACZ,kBAAkB,GAClB,aAAa,GACb,2BAA2B,GAC3B,0BAA0B,GAC1B,sBAAsB,GACtB,SAAS,GACT,aAAa,GACb,kBAAkB,GAElB,SAAS,GACT,aAAa,GACb,uBAAuB,GACvB,gBAAgB,GAEhB,eAAe,GACf,iBAAiB,GACjB,iBAAiB,GACjB,gBAAgB,GAChB,qBAAqB,GACrB,oBAAoB,GACpB,sBAAsB,GAEtB,kBAAkB,GAElB,qBAAqB,GACrB,iBAAiB,GAEjB,cAAc,GACd,gBAAgB,GAEhB,iBAAiB,CAAC;AAEtB,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAE7D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAEpE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAE7D;AAED,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAErE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEjE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,WAAW,IAAI,OAAO,OAAO,CAAC,GAAG,CAEhD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,OAAO,CAAC,GAAG,GAAG,IAAI,CAE7D"}

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,CAmBzC"}

package/dist/Utils/GitVersionChecker.js

@@ -0,0 +1,61 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import { execFileSync } from 'child_process';
+import semver from 'semver';
+import packageJson from '../../package.json' with { type: 'json' };
+import { ConfigurationError } from '../Errors/CliError.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() {
+    let versionOutput;
+    try {
+        versionOutput = execFileSync('git', ['--version'], {
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).toString();
+    }
+    catch {
+        throw new ConfigurationError("'git' is required but was not found on PATH.");
+    }
+    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,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,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;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,aAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,aAAa,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE;YACjD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,kBAAkB,CAAC,8CAA8C,CAAC,CAAC;IAC/E,CAAC;IAED,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

@@ -0,0 +1,10 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+/**
+ * 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;
+//# sourceMappingURL=NodeVersionChecker.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +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 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;
+    // `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;
+    }
+    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

@@ -0,0 +1 @@
+{"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.

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;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BhB"}

package/dist/Utils/Paging.js

@@ -35,6 +35,35 @@ 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.

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/RepoOption.d.ts

@@ -0,0 +1,35 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { RepoType } from '@microsoft/managed-apps-common/config';
+/**
+ * Result of parsing the `--repo` flag value.
+ *
+ * - `native` (default): MAAF auto-provisions a platform-managed git repo, no remote URL.
+ * - `none`: source-control-free; no platform-managed repo, no remote URL.
+ * - `github`: bound to an external GitHub Enterprise repo at `remoteUrl`.
+ *
+ * `remoteUrl` is populated only when `repoType === 'github'`. This is a flat
+ * interface (not a discriminated union), so `if (repoType === 'github')` does NOT
+ * auto-narrow `remoteUrl` to `string`; github-branch use sites assert `remoteUrl!`.
+ */
+export interface RepoSelection {
+    repoType: RepoType;
+    remoteUrl: string | undefined;
+}
+/**
+ * Maps the raw `--repo` flag value to a `(repoType, remoteUrl)` pair.
+ * - omitted / empty → `native` (default GRS-backed flow)
+ * - `none` (case-insensitive) → `none` (no GRS, no local setup)
+ * - any other non-empty value → `github` (external GHE binding, the trimmed value
+ *   flows through as `remoteUrl` to the action and the eventual git clone)
+ *
+ * Runtime invariant: `remoteUrl` is set iff `repoType === 'github'`. Consumers
+ * branch on `repoType` and assert `remoteUrl!` at github use sites — see
+ * `RepoSelection` for why narrowing is not automatic.
+ *
+ * Lives in `Utils/` (not `Verbs/CreateMaafApp.ts`) so the lightweight `app init`
+ * verb can call it without pulling in `giget`/`child_process` from CreateMaafApp.
+ */
+export declare function parseRepoOption(rawRepoValue: string | undefined): RepoSelection;
+//# sourceMappingURL=RepoOption.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RepoOption.d.ts","sourceRoot":"","sources":["../../src/Utils/RepoOption.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uCAAuC,CAAC;AAWtE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAS/E"}