@microsoft/managed-apps-cli 0.20.0 → 0.21.0

package/dist/Verbs/CreateMaafApp.d.ts

@@ -1,100 +0,0 @@
-/*!
- * Copyright (C) Microsoft Corporation. All rights reserved.
- */
-import type { ArgumentProvider } from '../ArgumentProvider.js';
-/**
- * Result of `commitAndPushScaffoldAsync`. Carried into the `--json` success
- * envelope (as the `push` field) so automation can distinguish three states:
- * push succeeded, push failed (with retry command), or no push attempted
- * (field absent — e.g. `--repo none` where there is no remote).
- */
-interface PushOutcome {
-    success: boolean;
-    error?: Record<string, unknown>;
-    retryCommand?: string;
-}
-/**
- * Creates a new MAAF app and (where applicable) sets up local source control.
- *
- * Three repo flows, selected by `--repo`:
- * - `native` (default): server auto-provisions a GRS repo; local clone happens via GCM.
- * - `github`: external GitHub binding (`*.ghe.com` or `github.com`). Clones the user's repo locally. On the first
- *   `createAsync` call, a missing/expired server-side GitHub identity mapping is
- *   recoverable in-band: a single inline DCF run + exactly one `createAsync` retry.
- *   Any other error — or a second mapping failure after DCF — is a hard fail.
- * - `none`: no git binding at all (just the server record + template + ms.config.json).
- */
-export declare function createMaafAppAsync(argumentProvider: ArgumentProvider): Promise<void>;
-/**
- * Commits the scaffolded files and pushes to the remote. Called by both `native`
- * and `github` flows after writeRepoConfig.
- *
- * Failure is non-fatal: prints a warning with the retry command and returns
- * `{ success: false, ... }`. The server-side app and local scaffold are unchanged.
- *
- * All three git commands go through {@link runGit}, so stdin is ignored (the
- * child can never block waiting for input) and stdout is discarded (git's
- * progress prose stays out of our pretty output). Stderr handling follows the
- * runGit policy: the un-classified `add`/`commit` steps re-emit git's stderr on
- * failure, and the `push` step either streams stderr live (un-classified github
- * flow, `network: true`) or pipes it for classification (native flow) — either
- * way git's own error context reaches the user alongside our warning. A
- * classified push error is caught here, so its exit code never propagates;
- * classification only shapes the warning text and the `--json` error payload.
- *
- * Commit identity (user.name / user.email) is read by git itself from
- * local-then-global config — we pass nothing. Missing identity surfaces as
- * git's own descriptive commit error via runGit's stderr handling.
- */
-export declare function commitAndPushScaffoldAsync(appDir: string, jsonMode: boolean, nativeGitUrl?: string): Promise<PushOutcome>;
-interface CloneRepoOptions {
-    directory: string;
-    repoUrl: string;
-}
-/**
- * Clones the developer's external GitHub repo (`*.ghe.com` tenant or `github.com`) into `directory`.
- * Auth flows through the user's existing git credential setup — the CLI does not inject
- * tokens here. On failure, surfaces a CLI-friendly error pointing the user at the
- * GitHub App install prerequisite. Git's stderr is captured (via `runGit`, with
- * `emitStderr: false`) so it can be run through the access-failure classification,
- * and is re-emitted on failure so the underlying message still appears inline
- * above the wrapper.
- *
- * Targeting rules (mirrors `git clone` semantics):
- *   - directory non-existent → clone creates it
- *   - directory exists and is empty → clone fills it
- *   - directory exists and is non-empty → clone fails (caller's pre-network guard
- *     should reject this case earlier with a clearer message)
- */
-export declare function cloneRepo({ directory, repoUrl }: CloneRepoOptions): void;
-export { initializeLocalNativeGitRepo as initLocalRepo } from '../Utils/GitUtils.js';
-export declare function buildOrphanedAppRecoveryHint(serverAppId: string, environmentId: string): string;
-export declare function ensureTemplateSourceValid(source: string): void;
-export declare function ensureTargetDirectoryEmpty(appDir: string): void;
-export declare function ensureRepoTargetDirectoryEmpty(appDir: string): void;
-/**
- * Cheap pre-network probe to detect a non-empty remote BEFORE createAsync runs.
- *
- * Implementation: partial clone (`--depth=1 --filter=blob:none --no-checkout`)
- * into an OS temp dir, then `git ls-tree -r HEAD`. The clone pulls refs + the
- * tip commit + its tree objects only — no blob bytes, no working tree — so the
- * bandwidth on the rejection path is tens of KB even for a multi-GB repo. The
- * temp dir is removed in `finally`.
- *
- * Failure semantics:
- *   - Non-empty tree at HEAD → throws `UsageError` with the "is not empty" /
- *     "ms app init" actionable lead, BEFORE createAsync. Nothing created.
- *   - Empty tree (incl. the cleaned-up-repo edge case: commit1 add, commit2
- *     delete all) → ls-tree returns no lines → returns without throwing.
- *   - Clone fails with a recognizable access/auth signature (private repo
- *     hidden as "not found", missing local credentials, 403, …) → throws
- *     `ConfigurationError` BEFORE createAsync so we never create a server-side
- *     app the user can't clone.
- *   - Any other git error (network blip, server doesn't support --filter,
- *     temp-fs hiccup, …) → swallow and return (fail OPEN). The subsequent
- *     cloneRepo surfaces the friendlier message for the user-facing failure;
- *     we don't want this probe to become a parallel error-message surface.
- */
-export declare function ensureExternalRepoIsEmpty(repoUrl: string): void;
-export declare function ensureTargetDirectoryWritable(appDir: string): void;
-//# sourceMappingURL=CreateMaafApp.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"CreateMaafApp.d.ts","sourceRoot":"","sources":["../../src/Verbs/CreateMaafApp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAwC5D;;;;;GAKG;AACH,UAAU,WAAW;IACnB,OAAO,EAAE,OAAO,CAAC;IAKjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAub1F;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,WAAW,CAAC,CA2DtB;AAuDD,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAwED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,gBAAgB,GAAG,IAAI,CAuBxE;AAED,OAAO,EAAE,4BAA4B,IAAI,aAAa,EAAE,MAAM,mBAAmB,CAAC;AA0ClF,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAM/F;AAkGD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAO9D;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAc/D;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAanE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CA+D/D;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA8BlE"}