@vendure/cloud 0.4.0 → 0.5.0-dev.20261014172655.g652e750

package/dist/cli/commands/deployment/deploy.js

@@ -1,15 +1,14 @@
 import * as prompts from "@clack/prompts";
-import { TERMINAL_STATUSES, cloudInvocation, createAuthenticatedClient, formatInlineUserFacingErrorReason, formatUserFacingErrorDetails, output, platformAddress, resolveEnvironment, shortSha, sleep, } from "../../index.js";
-// Imported directly rather than through `../../index.js`. That module carries the primitives every
-// family shares; these two are this family's own plumbing that happens to live under `lib/`.
+import { CLOUD_INVOCATION, TERMINAL_STATUSES, createAuthenticatedClient, formatInlineUserFacingErrorReason, formatUserFacingErrorDetails, output, platformAddress, resolveEnvironment, shortSha, sleep, } from "../../index.js";
+import { fetchConfigRevisionStatus, formatConfigRevisionChanges, parseConfigRevisionOption, } from "../../lib/config-revisions.js";
 import { formatEnvPreflightSkipped, formatMissingEnvVarsWarning, runEnvVarPreflight, } from "../../lib/env-preflight.js";
 import { consumeLogStream } from "../../lib/log-stream.js";
+import { logger } from "../../lib/logger.js";
 import { readNegatableOption, readStringOption } from "./options.js";
 import { fetchDeploymentRecovery, formatDeploymentRecovery } from "./recovery.js";
 import { requireBranchMapping } from "./source.js";
 const POLL_INTERVAL_MS = 3_000;
-// Compatibility fallback for an older control plane that does not yet expose
-// its phase timeout. Deliberately generous; the current API owns the deadline.
+// Fallback for a control plane that does not expose its phase timeout.
 const LEGACY_POLLING_TIMEOUT_MS = 60 * 60 * 1000;
 function waitPhase(deployment) {
     if (deployment.status === "PENDING") {
@@ -48,43 +47,48 @@ function spinnerMessage(status) {
             return "Waiting for build to start...";
     }
 }
-// The exit code is returned rather than set on `process.exitCode`, because the Vendure CLI host
-// calls `process.exit` with whatever an action answers. Nothing here ends the process itself: a
-// command that did would take that decision away from the host part-way through the run.
+// The exit code is returned because the Vendure CLI host calls `process.exit` with it.
 export async function deploy({ options, globals }) {
     const wait = readNegatableOption(options.wait);
     const json = globals.json === true;
     const { project, environment } = await resolveEnvironment(globals);
     if (!json) {
-        prompts.log.info(`Deploying ${project.slug} (${environment.slug})...`);
+        output.info(`Deploying ${project.slug} (${environment.slug})...`);
     }
-    const client = createAuthenticatedClient(globals);
+    const client = await createAuthenticatedClient(globals);
     const mapping = await requireBranchMapping(client, environment);
+    const { revision: configRevision, heldBack } = await chooseConfigRevision(client, environment, readStringOption(options.configRevision, "--config-revision <revision>"), json);
+    if (configRevision === CANCELLED) {
+        prompts.outro("Deploy cancelled.");
+        return;
+    }
     if (!json) {
-        const proceed = await warnOnMissingEnvVars(client, environment);
+        const proceed = await warnOnMissingEnvVars(client, environment, heldBack);
         if (!proceed) {
-            prompts.outro(`Deploy cancelled. Set the variables above, then re-run \`${cloudInvocation()} deploy\`.`);
+            prompts.outro(`Deploy cancelled. Set the variables above, then re-run \`${CLOUD_INVOCATION} deploy\`.`);
             return;
         }
     }
-    // `--commit` selects a commit that is not the branch's tip. The reference goes to the control
-    // plane exactly as given: only it can talk to the repository, so a tag or a short SHA is resolved
-    // there and comes back on the VC Deployment.
+    // `--commit` selects a commit other than the branch tip; the control plane resolves tags.
     const selectedRef = readStringOption(options.commit, "--commit <ref>");
-    const deployment = await startManagedBuild(client, environment.id, selectedRef ?? mapping.branch);
+    const deployment = await startManagedBuild(client, environment.id, selectedRef ?? mapping.branch, configRevision);
     if (selectedRef !== undefined && !json && deployment.commitHash !== null) {
         output.info(`Building commit ${shortSha(deployment.commitHash)}.`);
     }
+    if (!json && deployment.configRevision != null) {
+        output.info(`Configuration revision ${deployment.configRevision}.`);
+    }
     if (!wait) {
         if (json) {
             process.stdout.write(`${JSON.stringify({
                 deploymentId: deployment.id,
                 status: deployment.status,
                 commitHash: deployment.commitHash,
+                configRevision: deployment.configRevision ?? null,
             })}\n`);
         }
         else {
-            prompts.log.info(`VC Deployment ${deployment.id} started. Run \`${cloudInvocation()} deployment logs ${deployment.id} --follow\` to follow its Build Step.`);
+            output.info(`VC Deployment ${deployment.id} started. Run \`${CLOUD_INVOCATION} deployment logs ${deployment.id} --follow\` to follow its Build Step.`);
         }
         return;
     }
@@ -107,7 +111,7 @@ export async function deploy({ options, globals }) {
                 }
             }
             catch (error) {
-                prompts.log.warn(`Could not follow the Build Step Log; deployment monitoring continues. ${error instanceof Error ? error.message : String(error)}`);
+                output.warn(`Could not follow the Build Step Log; deployment monitoring continues. ${error instanceof Error ? error.message : String(error)}`);
             }
             current = await client.get(`/deployments/${deployment.id}`);
             if (!TERMINAL_STATUSES.has(current.status)) {
@@ -129,7 +133,7 @@ export async function deploy({ options, globals }) {
                 process.stdout.write(`${JSON.stringify({ deploymentId: current.id, status: current.status, timedOut: true })}\n`);
             }
             else {
-                prompts.log.warn(`${timeout.label} did not complete within ${timeout.ms / 60_000} minutes. It may still finish — run \`${cloudInvocation()} deployment list\` to check, or re-run \`${cloudInvocation()} deploy\`.`);
+                output.warn(`${timeout.label} did not complete within ${timeout.ms / 60_000} minutes. It may still finish — run \`${CLOUD_INVOCATION} deployment list\` to check, or re-run \`${CLOUD_INVOCATION} deploy\`.`);
             }
             return 1;
         }
@@ -140,7 +144,6 @@ export async function deploy({ options, globals }) {
     if (json) {
         process.stdout.write(`${JSON.stringify(current)}\n`);
         if (current.status !== "RUNNING" && current.status !== "SUCCEEDED") {
-            // `deployment show --json` is what carries the recovery for this id.
             return 1;
         }
         return;
@@ -148,40 +151,37 @@ export async function deploy({ options, globals }) {
     if (current.status === "RUNNING" || current.status === "SUCCEEDED") {
         spinner?.stop("Deploy complete");
         const liveUrl = resolveLiveUrl(environment, client);
-        prompts.log.info(formatDeploymentSummary(current.summary ?? null, {
+        output.info(formatDeploymentSummary(current.summary ?? null, {
             environmentSlug: environment.slug,
             liveUrl,
             projectSlug: project.slug,
         }));
-        // A cleanup failure is reported and still earns exit 1, but it does not end the run: the
-        // deployment itself succeeded, and the kept-resource warning and the outro below are part of
-        // telling the customer where that left them.
+        // A cleanup failure earns exit 1 but does not end the run; the kept-resource warning and the
+        // outro below still print.
         let exitCode;
         if (current.summary) {
             const cleanupFailures = current.summary.cleanup.failures;
             if (cleanupFailures.length > 0) {
-                prompts.log.warn(formatCleanupFailures(cleanupFailures, project.slug, environment.slug));
+                output.warn(formatCleanupFailures(cleanupFailures, project.slug, environment.slug));
                 exitCode = 1;
             }
         }
         const protectedResources = current.protectedResources ?? [];
         if (protectedResources.length > 0) {
             const lines = protectedResources.map((resource) => `  • ${resource.label}`).join("\n");
-            prompts.log.warn(`${protectedResources.length} data-bearing resource${protectedResources.length === 1 ? " was" : "s were"} kept:\n${lines}\nRun \`${cloudInvocation()} deploy teardown\` to remove ${protectedResources.length === 1 ? "it" : "them"}.`);
+            output.warn(`${protectedResources.length} data-bearing resource${protectedResources.length === 1 ? " was" : "s were"} kept:\n${lines}\nRun \`${CLOUD_INVOCATION} deploy teardown\` to remove ${protectedResources.length === 1 ? "it" : "them"}.`);
         }
         prompts.outro(`${project.slug} (${environment.slug}) is live`);
         return exitCode;
     }
     spinner?.stop("Deployment failed");
     if (current.errorDetails) {
-        prompts.log.error(formatUserFacingErrorDetails(current.errorDetails, {
+        output.error(formatUserFacingErrorDetails(current.errorDetails, {
             projectSlug: project.slug,
             environmentSlug: environment.slug,
         }));
     }
-    // What the failure leaves running, and the one action to take about it. Printed after the error
-    // rather than instead of it: the error says what went wrong and this says what to do, and only
-    // the second is composed from the stage the deployment reached.
+    // What the failure leaves running and the one action to take, composed from the stage reached.
     const { recovery, unavailableReason } = await fetchDeploymentRecovery(client, current);
     if (recovery)
         output.warn(formatDeploymentRecovery(recovery, current.id));
@@ -189,20 +189,18 @@ export async function deploy({ options, globals }) {
         output.warn(unavailableReason);
     return 1;
 }
-// Preflight: warn about env vars the local app references but that aren't set
-// on the target environment. Returns whether the deploy should proceed — an
-// interactive TTY is asked to confirm; non-interactive runs warn and continue.
-// A check that could not run prints a note and asks nothing: silence would read
-// as the environment already having everything the app needs.
-async function warnOnMissingEnvVars(client, environment) {
-    const preflight = await runEnvVarPreflight(client, environment.id);
+// Warns about env vars the local app references but the target environment lacks. Returns whether
+// to proceed: an interactive TTY confirms, other runs continue. A check that could not run prints a
+// note, because silence would read as a complete environment.
+async function warnOnMissingEnvVars(client, environment, heldBack) {
+    const preflight = await runEnvVarPreflight(client, environment.id, heldBack);
     if (preflight.status === "not-checked") {
-        prompts.log.info(formatEnvPreflightSkipped(preflight.reason));
+        output.info(formatEnvPreflightSkipped(preflight.reason));
         return true;
     }
     if (preflight.missing.length === 0)
         return true;
-    prompts.log.warn(formatMissingEnvVarsWarning(preflight.missing, environment.slug));
+    output.warn(formatMissingEnvVarsWarning(preflight.missing, environment.slug));
     if (!process.stdin.isTTY)
         return true;
     const proceed = await prompts.confirm({
@@ -211,8 +209,55 @@ async function warnOnMissingEnvVars(client, environment) {
     });
     return !prompts.isCancel(proceed) && proceed;
 }
-async function startManagedBuild(client, environmentId, ref) {
-    const result = await client.post(`/environments/${environmentId}/source-trigger`, { ref });
+const CANCELLED = Symbol("cancelled");
+async function chooseConfigRevision(client, environment, named, json) {
+    const requested = named === undefined ? undefined : parseConfigRevisionOption(named);
+    if (typeof requested === "number")
+        return { revision: requested };
+    if (requested === undefined && json)
+        return { revision: undefined };
+    let status;
+    try {
+        status = await fetchConfigRevisionStatus(client, environment.id);
+    }
+    catch (error) {
+        // `latest` cannot be resolved without it. Otherwise this is an offer, so a deploy goes ahead
+        // with the revision the environment runs, and says why it offered nothing.
+        if (requested === "latest")
+            throw error;
+        logger.warn(`Could not read the configuration revision status: ${error instanceof Error ? error.message : String(error)}`);
+        output.info("Could not check for a pending configuration revision. Deploying the one running.");
+        return { revision: undefined };
+    }
+    if (requested === "latest")
+        return { revision: status.latest?.number };
+    // An environment never deployed with a revision has nothing to hold back, so its first deploy
+    // takes the latest and there is no choice to offer.
+    if (!status.pending || !status.latest || !status.applied)
+        return { revision: undefined };
+    const latest = status.latest.number;
+    const changes = formatConfigRevisionChanges(status.changes);
+    if (process.stdin.isTTY) {
+        const apply = await prompts.confirm({
+            initialValue: true,
+            message: `Apply configuration revision ${latest} (${changes})?`,
+        });
+        if (prompts.isCancel(apply))
+            return { revision: CANCELLED };
+        if (apply)
+            return { revision: latest };
+    }
+    output.warn(`Configuration revision ${latest} (${changes}) is pending and is not part of this deploy, which keeps revision ${status.applied.number}. To apply it, run \`${CLOUD_INVOCATION} deploy --config-revision ${latest}\`.`);
+    return {
+        revision: undefined,
+        heldBack: {
+            added: status.changes.filter((change) => change.change === "added").map((c) => c.key),
+            removed: status.changes.filter((change) => change.change === "removed").map((c) => c.key),
+        },
+    };
+}
+async function startManagedBuild(client, environmentId, ref, configRevision) {
+    const result = await client.post(`/environments/${environmentId}/source-trigger`, configRevision === undefined ? { ref } : { ref, configRevision });
     return client.get(`/deployments/${result.deploymentId}`);
 }
 function formatDeploymentSummary(summary, context) {
@@ -265,11 +310,9 @@ function formatCleanupFailures(failures, projectSlug, environmentSlug) {
 function formatErrorReason(error, projectSlug, environmentSlug) {
     return formatInlineUserFacingErrorReason(error, { projectSlug, environmentSlug });
 }
-// An automation credential gets no address: the summary offers a link to click and a script has
-// nothing to click with. The client carries an organization only for the stored session, which is
-// the same signal `getAuthenticatedOrganizationSlug` reads.
+// An automation credential gets no address, because a script cannot follow a link.
 function resolveLiveUrl(environment, client) {
-    if (!client.organizationId)
+    if (client.credentialKind === "apiKey")
         return null;
     return platformAddress(environment);
 }

package/dist/cli/commands/deployment/deploy.js.map

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

package/dist/cli/commands/deployment/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deployment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,kBAAkB,CAAC;AAmG1B,eAAO,MAAM,kBAAkB,EAAE,gBAAgB,EA0GhD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deployment/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,kBAAkB,CAAC;AAsF1B,eAAO,MAAM,kBAAkB,EAAE,gBAAgB,EA6GhD,CAAC"}

package/dist/cli/commands/deployment/index.js

@@ -1,20 +1,9 @@
 import { defineCloudCommand, defineCloudCommandGroup, } from "../../command.js";
-// The hosted Cloud commands that put an application on the platform and then say what happened to
-// it: the deploy itself, the environment's current state, its runtime logs, its VC Deployment
-// history with the Build Step Log, and the rollback.
-//
-// This module declares the tree and nothing else. Every `run` reaches its implementation through
-// `await import(...)`, so the Vendure CLI host — which `require`s the plugin on every `vendure`
-// invocation, including the ones with nothing to do with Cloud — pays for this file and
-// `../../command.js`, not for `zod`, `picocolors`, the log stream or the authentication stack
-// behind them. `test/cli-deployment-tree.test.ts` holds that line.
-//
-// The commands are in the order `vcloud` registered them, so `vendure --help` lists them the way
-// `vcloud --help` did. The host has no equivalent of Commander's help groups, so the order is all
-// that survives of that grouping.
-// `vcloud` registers this group as `deployment` with a `deployments` alias. The Vendure CLI
-// extension API has no alias field, so only the primary name survives the port — the same trade the
-// identity family made for `key`/`keys`.
+// This module declares the tree only. Every `run` reaches its implementation through
+// `await import(...)`, so the Vendure CLI host, which `require`s the plugin on every `vendure`
+// invocation, loads this file and `../../command.js` but not `zod`, `picocolors`, the log stream or
+// the authentication stack. `test/cli-deployment-tree.test.ts` holds that line.
+// The Vendure CLI extension API has no alias field.
 const deploymentHistoryCommands = defineCloudCommandGroup({
     name: "deployment",
     description: "Deployment management",
@@ -61,15 +50,12 @@ const deploymentHistoryCommands = defineCloudCommandGroup({
         }),
     ],
 });
-// `deploy` carries its own action and these two subcommands, the shape `vcloud deploy` has always
-// had. The host registers it as a runnable parent: `vendure deploy` deploys, `vendure deploy plan`
-// and `vendure deploy teardown` run these, and a word that is neither — `vendure deploy palan` —
-// is refused as an unknown command rather than falling through into a deploy of the whole
+// `deploy` carries its own action and these two subcommands. The host registers it as a runnable
+// parent, and refuses an unknown word such as `vendure deploy palan` instead of deploying the whole
 // environment.
 //
-// That refusal is why `deploy` declares no positional argument and must not gain one. The host
-// rejects a node declaring both positional arguments and subcommands at plugin load, because the
-// first word after `deploy` would be ambiguous between a subcommand name and an argument value.
+// `deploy` must not declare a positional argument: the host rejects a node declaring both
+// positional arguments and subcommands at plugin load.
 const deploySubcommands = [
     defineCloudCommand({
         name: "plan",
@@ -82,7 +68,7 @@ const deploySubcommands = [
         options: [
             {
                 long: "--force",
-                description: "Delete all infrastructure for the project plus all related records",
+                description: "Force teardown of this environment. Not supported yet: the request is recorded as failed",
             },
             { long: "--yes", description: "Skip the confirmation prompt (for CI / non-interactive use)" },
             {
@@ -94,8 +80,7 @@ const deploySubcommands = [
     }),
 ];
 export const deploymentCommands = [
-    // Composed rather than declared through one helper: `defineCloudCommand` builds the runnable half,
-    // and the subcommands are attached to it. The host's own node type carries both.
+    // `defineCloudCommand` builds the runnable half and the subcommands are attached to it.
     {
         ...defineCloudCommand({
             name: "deploy",
@@ -106,10 +91,13 @@ export const deploymentCommands = [
                     description: "Start the deployment and exit without waiting for completion",
                 },
                 {
-                    // `required: true` is about the value rather than the option, the same as `--limit` and
-                    // `--lines` below: it keeps the host emitting `--commit <ref>` so that `--commit` with
-                    // nothing after it is an error. The option itself is optional, which is what the default
-                    // in the description describes.
+                    long: "--config-revision <revision>",
+                    description: "Configuration revision number, or latest, to apply (default: the revision the environment runs with)",
+                    required: true,
+                },
+                {
+                    // `required: true` makes the host emit `--commit <ref>`, so `--commit` with no value
+                    // is an error. The option itself is optional.
                     long: "--commit <ref>",
                     description: "Commit SHA, tag or branch to deploy (default: the environment's mapped branch)",
                     required: true,

package/dist/cli/commands/deployment/index.js.map

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

package/dist/cli/commands/deployment/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deployment/list.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,iBAAiB,EASvB,MAAM,gBAAgB,CAAC;AA6BxB,wBAAsB,eAAe,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+D5F"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deployment/list.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,iBAAiB,EASvB,MAAM,gBAAgB,CAAC;AA6BxB,wBAAsB,eAAe,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+D5F"}

package/dist/cli/commands/deployment/list.js

@@ -1,6 +1,6 @@
 import * as prompts from "@clack/prompts";
 import pc from "picocolors";
-import { FAILED_STATUSES, SUCCESS_STATUSES, cloudInvocation, createAuthenticatedClient, formatDateTime, resolveEnvironment, writeJson, } from "../../index.js";
+import { CLOUD_INVOCATION, FAILED_STATUSES, SUCCESS_STATUSES, createAuthenticatedClient, formatDateTime, output, resolveEnvironment, writeJson, } from "../../index.js";
 import { DEPLOYMENT_ID_LENGTH, DEPLOYMENT_ID_PREFIX_MIN_LENGTH, } from "../../lib/contract/wire-values.js";
 import { readIntegerOption, readNegatableOption } from "./options.js";
 function formatRunDuration(startedAt, completedAt) {
@@ -33,7 +33,7 @@ export async function listDeployments({ options, globals }) {
     const showFullIds = !readNegatableOption(options.trunc);
     const json = globals.json === true;
     const { environment } = await resolveEnvironment(globals);
-    const client = createAuthenticatedClient(globals);
+    const client = await createAuthenticatedClient(globals);
     const spinner = json ? undefined : prompts.spinner();
     spinner?.start("Fetching deployments...");
     const params = new URLSearchParams({
@@ -48,7 +48,7 @@ export async function listDeployments({ options, globals }) {
         return;
     }
     if (deployments.length === 0) {
-        prompts.log.info(`No deployments found. Run \`${cloudInvocation()} deploy\` to create one.`);
+        output.info(`No deployments found. Run \`${CLOUD_INVOCATION} deploy\` to create one.`);
         return;
     }
     const idWidth = showFullIds
@@ -62,7 +62,7 @@ export async function listDeployments({ options, globals }) {
         createdAt: "CREATED".padEnd(20),
         duration: "DURATION".padEnd(10),
     };
-    prompts.log.info(pc.bold(`${cols.id}${cols.status}${cols.trigger}${cols.by}${cols.createdAt}${cols.duration}`));
+    output.info(pc.bold(`${cols.id}${cols.status}${cols.trigger}${cols.by}${cols.createdAt}${cols.duration}`));
     for (const dep of deployments) {
         const id = (showFullIds ? dep.id : dep.id.slice(0, DEPLOYMENT_ID_PREFIX_MIN_LENGTH)).padEnd(idWidth);
         const statusPadded = dep.status.padEnd(12);
@@ -71,7 +71,7 @@ export async function listDeployments({ options, globals }) {
         const by = padCell(dep.triggeredBy?.name ?? "—", 24);
         const createdAt = formatDateTime(dep.createdAt).padEnd(20);
         const duration = formatRunDuration(dep.startedAt, dep.completedAt);
-        prompts.log.info(`${id}${status}${trigger}${by}${createdAt}${duration}`);
+        output.info(`${id}${status}${trigger}${by}${createdAt}${duration}`);
     }
 }
 //# sourceMappingURL=list.js.map

package/dist/cli/commands/deployment/list.js.map

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

package/dist/cli/commands/deployment/log-export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-export.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deployment/log-export.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,SAAS,EAOf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAa,eAAe,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAclG,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,mBAAmB,CAAC;IAChC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAwCvF"}
+{"version":3,"file":"log-export.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deployment/log-export.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,SAAS,EAOf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAa,eAAe,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAUlG,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,mBAAmB,CAAC;IAChC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAsCvF"}

package/dist/cli/commands/deployment/log-export.js

@@ -1,20 +1,15 @@
 import { access, writeFile } from "node:fs/promises";
 import { ApiError, formatBytes, formatDateTime, output, sleep, writeJson, } from "../../index.js";
 // The export half of `logs`: one query's whole answer as a file, produced by the control plane and
-// redeemed over an authenticated route (CLO-890, CLO-891).
-//
-// An export names a query and nothing else. Every filter, the window and the source belong to the
-// query it was created from, so the page a customer just read and the file they just downloaded are
-// the same records.
-// How long a caller waits for a file. Bounded rather than open: a wait that never ends is a command
-// that never returns, and the same window can be exported again.
+// redeemed over an authenticated route. An export names a query only; the filters, window and
+// source belong to that query, so the page a customer read and the file they downloaded match.
+// How long a caller waits for a file. The same window can be exported again.
 const EXPORT_POLL_INTERVAL_MS = 2_000;
 const EXPORT_POLL_ATTEMPTS = 60;
 export async function exportLogQuery(input) {
     const settled = await waitForExport(input, await createExport(input));
     if (settled.state !== "READY") {
-        // The record carries the state and the platform's own sentence for it, so `--json` reports the
-        // same failure the terminal does rather than nothing at all.
+        // `--json` reports the same failure the terminal does.
         if (input.json)
             writeJson({ export: settled, path: null });
         else
@@ -24,9 +19,8 @@ export async function exportLogQuery(input) {
     if (settled.download === null) {
         throw new Error("Vendure Cloud reported this log export as ready but gave nothing to download from. Export the query again.");
     }
-    // Checked before the body is asked for, so a caller who named an occupied path does not pay for
-    // the transfer first. The exclusive write below is still what decides it: this is one read of a
-    // path that anything could take in between.
+    // Fails early so a caller who named an occupied path does not pay for the transfer. The exclusive
+    // write below decides; anything could take the path in between.
     const path = input.outputPath ?? localFileName(settled);
     if (await exists(path))
         throw new Error(occupiedPathRefusal(path));
@@ -44,9 +38,8 @@ export async function exportLogQuery(input) {
     output.info(`The file Vendure Cloud holds is deleted at ${formatDateTime(settled.expiresAt)}; the copy you downloaded is yours to keep.`);
     return undefined;
 }
-// The permission is the one refusal worth naming rather than passing on as a status: exporting a
-// redacted extract of a whole window is a separate grant from reading a page of it, so a caller who
-// may read logs is not yet a caller who may export them.
+// Exporting a redacted extract of a whole window is a separate grant from reading a page of it, so
+// this refusal is named instead of passed on as a status.
 async function createExport(input) {
     try {
         return await input.client.post(`/projects/${input.projectId}/log-queries/${encodeURIComponent(input.queryId)}/export`, input.format === undefined ? {} : { format: input.format });
@@ -66,14 +59,11 @@ async function waitForExport(input, created) {
     }
     return current;
 }
-// The default branch is the same guard the result states have: a state added after this release
-// must read as a client too old to explain it rather than as a silent success.
+// The default branch keeps a state added after this release from reading as a silent success.
 function reportUnreadyExport(record) {
     switch (record.state) {
         case "PENDING":
-            // No option reads an existing export back, so running the command again produces a new one
-            // rather than collecting this one. Saying so is the difference between advice a customer can
-            // act on and advice that quietly does something else.
+            // No option reads an existing export back, so running the command again starts a new one.
             output.error("Vendure Cloud is still producing this log export. Running the command again starts a new export of the same window.");
             return;
         case "FAILED":
@@ -89,9 +79,7 @@ function reportUnreadyExport(record) {
             return;
     }
 }
-// Refuses to overwrite. An export is written under a name the customer did not choose unless they
-// passed `--output`, and silently replacing a file of that name is the one mistake this command
-// could make that destroys something.
+// Refuses to overwrite: the name is not the customer's choice unless they passed `--output`.
 async function writeExportFile(path, content) {
     try {
         await writeFile(path, content, { flag: "wx" });
@@ -108,10 +96,9 @@ function occupiedPathRefusal(path) {
 function isFileExistsError(error) {
     return (typeof error === "object" && error !== null && error.code === "EEXIST");
 }
-// Where an export lands when the customer named no path. Composed here rather than taken from the
-// download's `content-disposition`: that header is a value from the network, and a response is not
-// something this command should let choose a path on the customer's disk. It mirrors the name the
-// control plane sends, and the export's own id is what keeps two exports off each other.
+// Where an export lands when the customer named no path. Built here instead of from the download's
+// `content-disposition`, because a network response must not choose a path on the customer's disk.
+// It mirrors the control plane's name; the export id keeps two exports apart.
 function localFileName(record) {
     return `vendure-cloud-logs-${record.id}.${record.format === "TEXT" ? "log" : "jsonl"}`;
 }