@vendure/cloud 0.2.0 → 0.3.0

package/README.md

@@ -16,15 +16,50 @@ from `src/index.ts`.
 
 ## Local development
 
-Build the application, then point the included runner at the compiled Cloud Config:
+This package declares a Vendure CLI plugin in `package.json#vendure.cliPlugin`, which a project
+turns on once with `vendure plugins add @vendure/cloud`. The plugin extends the `dev` command
+through the host's ordered command-extension API rather than replacing it, so Core keeps supervising
+the processes and a wrapper another plugin already applied still runs. What it adds before calling
+the next action is the two servers below, the migration chain, and the two entry points Core would
+otherwise have looked for in the customer's repository — which a Cloud Config application does not
+have (ADR-0043). `test/dev-e2e/run.sh` drives all of that from a registry install.
 
-```bash
-vendure-cloud server dist/vendure-config.js
-```
+`vendure dev` provisions the local PostgreSQL database and the local Valkey cache, and runs the
+included runner against them. The runner itself provisions nothing: `composeLocalConfig` takes each
+connection as `LocalRuntimeOptions.database` and `LocalRuntimeOptions.cache`, or reads
+`VENDURE_LOCAL_DATABASE_URL` and `VENDURE_LOCAL_CACHE_URL` when it was started as a child process,
+and refuses to compose without either.
+
+It supplies one substitute for every capability in the shared inventory `@vendure/cloud-config`
+holds: PostgreSQL, a Valkey the server and the worker share, the job queue inside the database, the
+default scheduler, the upstream Dashboard plugin against a Vite development server, and the upstream
+asset server against a project-local directory. It prints a startup warning naming each of them.
+
+The cache is a Valkey rather than `DefaultCachePlugin` because that plugin declares `CacheItem` and
+`CacheTag`, and a customer's migrations are generated from this composition: two tables the managed
+runtime never reads would reach their deployed database (CLO-645).
+`packages/cloud-runtime/test/entity-set.test.ts` compares the two entity sets whole, with nothing
+exempted on either side. The protocol work is Vendure's own `RedisCacheStrategy`; the platform's
+`PlatformCacheStrategy` is not reused, because everything it adds over that one — a SigV4 IAM token
+per connection, mandatory TLS, an RBAC-user key prefix — is production infrastructure, and
+`@vendure-cloud/cloud-runtime` is private and downstream of this package.
+
+The database is PostgreSQL because a deployed VC Environment runs one (ADR-0020) and TypeORM emits
+DDL for the engine it is connected to: a local runtime on another engine produces migrations the
+deployed database cannot apply. `composeLocalConfig` also holds `synchronize: false` and the
+declared migration chain, so a migration generated against it is a diff against what those
+migrations built.
+
+`runLocalMigrations` is the local `migrate` run mode. It runs the chain the Cloud Config declares
+and creates nothing outside it, and refuses with `NoDeclaredMigrationsError` when there is no chain
+— a project created by Vendure's own tooling ships a schema-creating initial migration, and one
+without any has no schema this runtime is willing to invent.
+`test/migration-chain.integration.test.ts` builds an empty database from a generated initial
+migration and then carries a second one through to a deployed-shaped database.
 
-The runner supplies a local SQLite database, database-backed cache and job queue, and the default
-scheduler. It prints a startup warning naming those substitutes. Install `sql.js` as a development
-dependency; it is intentionally absent from deployed images.
+Install `pg`, `ioredis` and `@vendure/dashboard` as development dependencies. All three are
+intentionally absent from deployed images, and none is reached until a local configuration is
+composed, so an application that never composes one pays nothing for them.
 
 If `VC_ENVIRONMENT_ID` is present, the local runner refuses to boot. A managed process must use the
 private platform entrypoint and cannot silently fall back to a local database.

package/dist/cli/arguments.d.ts

@@ -0,0 +1,5 @@
+import type { CloudCommandInput } from "./command.js";
+export declare function readSingleValue(value: unknown, label: string): string | undefined;
+export declare function requiredArgument(args: CloudCommandInput["args"], index: number, name: string): string;
+export declare function variadicArgument(args: CloudCommandInput["args"], index: number, name: string): readonly string[];
+//# sourceMappingURL=arguments.d.ts.map

package/dist/cli/arguments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.d.ts","sourceRoot":"","sources":["../../src/cli/arguments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AA0BtD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMjF;AAID,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAC/B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,MAAM,CAMR;AAQD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAC/B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,SAAS,MAAM,EAAE,CASnB"}

package/dist/cli/arguments.js

@@ -0,0 +1,57 @@
+// Turns a declared position into the value a call site needs.
+//
+// The positional readers take `CloudCommandInput["args"]` itself rather than a restatement of its
+// element union. A narrower copy stays assignable *from* nothing, so widening the union breaks
+// every call site while the helper — the one place that reads a position — reports nothing.
+//
+// They live beside `command.ts` and take their type from `./command.js` rather than through
+// `./index.js`, so a module that declares commands can import them without pulling the foundation
+// into the plugin's static graph. `test/cli-published-surface.test.ts` counts a type-only import
+// the same as any other.
+//
+// `readSingleValue` is here rather than in a command family because a family's own copy of it is
+// what the hosted CLI grew three of: the same refusal, worded three ways, guarding the same thing.
+// What differs between the call sites is what an absent value means, so each keeps its own wrapper
+// and none keeps its own check.
+// One value where the declaration said one value, whether it came from a position or an option.
+//
+// A collected vector reaching a call site that declared a single value means the declaration and
+// the reader have drifted apart. It is refused rather than coerced, because a `string[]`
+// interpolated into a URL or a sentence becomes `npm,test`, which reads like a real identifier.
+//
+// The label is the caller's, so the message keeps naming the thing the customer typed: `<name>` for
+// a required position, `[name]` for an optional one, `--flag` for an option.
+export function readSingleValue(value, label) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string") {
+        throw new Error(`${label} takes a single value.`);
+    }
+    return value;
+}
+// A position the command declared as `<name>`. Commander refuses a missing required argument
+// before the action runs, so the value is there; what is missing is a type that says so.
+export function requiredArgument(args, index, name) {
+    const value = readSingleValue(args[index], `Argument <${name}>`);
+    if (value === undefined) {
+        throw new Error(`Missing required argument <${name}>.`);
+    }
+    return value;
+}
+// A position the command declared as variadic — a name ending in `...`, which the host registers as
+// `<name...>` or `[name...]`. It occupies one position and holds the whole collected vector.
+//
+// The vector is returned as it came, empty included: empty is a real answer for an optional
+// `[name...]`, and only the caller knows what to do with it. A required `<name...>` cannot arrive
+// empty, because Commander refuses that before the action runs.
+export function variadicArgument(args, index, name) {
+    const value = args[index];
+    if (value === undefined) {
+        throw new Error(`Missing required argument <${name}...>.`);
+    }
+    if (typeof value === "string") {
+        throw new Error(`Argument <${name}...> takes a list of values.`);
+    }
+    return value;
+}
+//# sourceMappingURL=arguments.js.map

package/dist/cli/arguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.js","sourceRoot":"","sources":["../../src/cli/arguments.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,EAAE;AACF,kGAAkG;AAClG,+FAA+F;AAC/F,4FAA4F;AAC5F,EAAE;AACF,4FAA4F;AAC5F,kGAAkG;AAClG,iGAAiG;AACjG,yBAAyB;AACzB,EAAE;AACF,iGAAiG;AACjG,mGAAmG;AACnG,mGAAmG;AACnG,gCAAgC;AAEhC,gGAAgG;AAChG,EAAE;AACF,iGAAiG;AACjG,yFAAyF;AACzF,gGAAgG;AAChG,EAAE;AACF,oGAAoG;AACpG,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,KAAa;IAC3D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,wBAAwB,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6FAA6F;AAC7F,yFAAyF;AACzF,MAAM,UAAU,gBAAgB,CAC9B,IAA+B,EAC/B,KAAa,EACb,IAAY;IAEZ,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,aAAa,IAAI,GAAG,CAAC,CAAC;IACjE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,IAAI,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,oGAAoG;AACpG,6FAA6F;AAC7F,EAAE;AACF,4FAA4F;AAC5F,kGAAkG;AAClG,gEAAgE;AAChE,MAAM,UAAU,gBAAgB,CAC9B,IAA+B,EAC/B,KAAa,EACb,IAAY;IAEZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,OAAO,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,8BAA8B,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cli/command.d.ts

@@ -0,0 +1,26 @@
+import type { CloudCommand, CloudCommandArgument, CloudCommandGroupNode, CloudCommandNode, CloudCommandOption } from "./host-nodes.js";
+import { type GlobalOptions } from "./root-options.js";
+export type { CloudCommand, CloudCommandAction, CloudCommandArgument, CloudCommandGroupNode, CloudCommandNode, CloudCommandOption, } from "./host-nodes.js";
+export interface CloudCommandInput {
+    args: readonly (string | readonly string[] | undefined)[];
+    options: Record<string, unknown>;
+    globals: GlobalOptions;
+    commandPath: readonly string[];
+}
+export type CloudCommandRun = (input: CloudCommandInput) => Promise<void | number>;
+export interface CloudCommandDefinition {
+    name: string;
+    description: string;
+    arguments?: CloudCommandArgument[];
+    options?: CloudCommandOption[];
+    run: CloudCommandRun;
+}
+export interface CloudCommandGroup {
+    name: string;
+    description: string;
+    options?: CloudCommandOption[];
+    subcommands: CloudCommandNode[];
+}
+export declare function defineCloudCommand(definition: CloudCommandDefinition): CloudCommand;
+export declare function defineCloudCommandGroup(group: CloudCommandGroup): CloudCommandGroupNode;
+//# sourceMappingURL=command.d.ts.map

package/dist/cli/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/cli/command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,mBAAmB,CAAC;AAI1E,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,iBAAiB;IAUhC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC;IAE1D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGjC,OAAO,EAAE,aAAa,CAAC;IAEvB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AASD,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;AAOnF,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,GAAG,EAAE,eAAe,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC;AAcD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,sBAAsB,GAAG,YAAY,CAmCnF;AAID,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG,qBAAqB,CAEvF"}

package/dist/cli/command.js

@@ -0,0 +1,84 @@
+import { readCommandContext, readCommandOptions } from "./host-arguments.js";
+import { readGlobalOptions } from "./root-options.js";
+// Turns a hosted Cloud command into a node the Vendure CLI host can register.
+//
+// Everything a command family would otherwise repeat lives here: reading the shared selectors,
+// turning a thrown error into the message a customer sees, and answering with an exit code instead
+// of ending the process. The last part is the one worth stating — the host calls `process.exit`
+// with whatever an action returns, and a command that exited itself would take that decision away
+// from the host part-way through the run.
+//
+// `run` should reach its implementation through `await import(...)`. The host loads this plugin
+// with a synchronous `require` on every `vendure` invocation, including the ones that have nothing
+// to do with Cloud, so a command family that imports its implementation statically puts that cost
+// on `vendure build`. `test/cli-published-surface.test.ts` is what holds that line.
+export function defineCloudCommand(definition) {
+    const { run, ...declaration } = definition;
+    return {
+        ...declaration,
+        // biome-ignore lint/suspicious/noConfusingVoidType: matches the host's `CliCommandAction`.
+        action: async (...args) => {
+            // Set before the work starts so the failure path can still honour `--json` when it was read,
+            // and fall back to the terminal when the run failed before that point.
+            let globals = {};
+            // Reading the host's arguments is inside the try, not before it. `readCommandContext` and
+            // `readCommandOptions` both throw when the tail they expect is not there, which is exactly
+            // what a host whose calling convention has moved would produce. Left outside, either one
+            // would escape the exit-code contract that every command family here depends on.
+            try {
+                // Before anything reads `process.env`: `getApiUrl` and `resolveCredential` both do, and the
+                // host does not load a project's `.env` for a plugin command the way `vcloud` does.
+                (await import("./lib/env-file.js")).loadProjectEnvFile();
+                const context = readCommandContext(args);
+                const options = readCommandOptions(args);
+                globals = readGlobalOptions({
+                    inheritedOptions: context.inheritedOptions,
+                    options,
+                });
+                return await run({
+                    args: positionalArguments(args, declaration.arguments?.length ?? 0),
+                    options,
+                    globals,
+                    commandPath: context.commandPath,
+                });
+            }
+            catch (error) {
+                const { reportCommandError } = await import("./lib/errors.js");
+                return reportCommandError(error, { json: globals.json });
+            }
+        },
+    };
+}
+// A group has no action of its own; the host refuses one that declares both. It exists so a family
+// can nest its commands, and so an option shared by only that family is declared in one place.
+export function defineCloudCommandGroup(group) {
+    return group;
+}
+// The host appends its own three values after everything Commander supplies, so the positional
+// arguments are what is left at the front. Counted from the declaration rather than sliced from
+// the end, because an optional argument the customer omitted is still passed, as `undefined`.
+function positionalArguments(args, declared) {
+    return args.slice(0, declared).map(readPositional);
+}
+// One declared position, in the shape `CloudCommandInput.args` describes. Anything that is neither
+// of those shapes reads as an argument that was not supplied, which is what an omitted optional one
+// already was.
+//
+// The vector is copied rather than passed through, because the array Commander supplies is the one
+// it goes on holding. A command that sorted or spliced its own arguments would otherwise be editing
+// the host's state part-way through the run.
+function readPositional(value) {
+    if (typeof value === "string")
+        return value;
+    if (!Array.isArray(value))
+        return undefined;
+    const entries = value;
+    const collected = [];
+    for (const entry of entries) {
+        if (typeof entry !== "string")
+            return undefined;
+        collected.push(entry);
+    }
+    return collected;
+}
+//# sourceMappingURL=command.js.map

package/dist/cli/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/cli/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAQ7E,OAAO,EAAsB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA+D1E,8EAA8E;AAC9E,EAAE;AACF,+FAA+F;AAC/F,mGAAmG;AACnG,gGAAgG;AAChG,kGAAkG;AAClG,0CAA0C;AAC1C,EAAE;AACF,gGAAgG;AAChG,mGAAmG;AACnG,kGAAkG;AAClG,oFAAoF;AACpF,MAAM,UAAU,kBAAkB,CAAC,UAAkC;IACnE,MAAM,EAAE,GAAG,EAAE,GAAG,WAAW,EAAE,GAAG,UAAU,CAAC;IAC3C,OAAO;QACL,GAAG,WAAW;QACd,2FAA2F;QAC3F,MAAM,EAAE,KAAK,EAAE,GAAG,IAAe,EAA0B,EAAE;YAC3D,6FAA6F;YAC7F,uEAAuE;YACvE,IAAI,OAAO,GAAkB,EAAE,CAAC;YAChC,0FAA0F;YAC1F,2FAA2F;YAC3F,yFAAyF;YACzF,iFAAiF;YACjF,IAAI,CAAC;gBACH,4FAA4F;gBAC5F,oFAAoF;gBACpF,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,kBAAkB,EAAE,CAAC;gBACzD,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBACzC,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBACzC,OAAO,GAAG,iBAAiB,CAAC;oBAC1B,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;oBAC1C,OAAO;iBACR,CAAC,CAAC;gBACH,OAAO,MAAM,GAAG,CAAC;oBACf,IAAI,EAAE,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC;oBACnE,OAAO;oBACP,OAAO;oBACP,WAAW,EAAE,OAAO,CAAC,WAAW;iBACjC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;gBAC/D,OAAO,kBAAkB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,+FAA+F;AAC/F,MAAM,UAAU,uBAAuB,CAAC,KAAwB;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+FAA+F;AAC/F,gGAAgG;AAChG,8FAA8F;AAC9F,SAAS,mBAAmB,CAC1B,IAAwB,EACxB,QAAgB;IAEhB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AACrD,CAAC;AAED,mGAAmG;AACnG,oGAAoG;AACpG,eAAe;AACf,EAAE;AACF,mGAAmG;AACnG,oGAAoG;AACpG,6CAA6C;AAC7C,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,OAAO,GAAuB,KAAK,CAAC;IAC1C,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAChD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/cli/commands/deployment/arguments.d.ts

@@ -0,0 +1,3 @@
+import type { CloudCommandInput } from "../../command.js";
+export declare function optionalArgument(args: CloudCommandInput["args"], index: number, name: string): string | undefined;
+//# sourceMappingURL=arguments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deployment/arguments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAU1D,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAC/B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAEpB"}

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

@@ -0,0 +1,13 @@
+import { readSingleValue } from "../../arguments.js";
+// Reads a positional argument this family declared as optional.
+//
+// Every positional here is optional — `rollback`, `deployment show` and `deployment logs` each take
+// a deployment ID or fall back to a lookup — so an absent value is the ordinary case rather than
+// the error it is for `requiredArgument`.
+//
+// The parameter is `CloudCommandInput["args"]` itself, because a narrower restatement of it stays
+// assignable and so goes stale without failing here, which is the one place that reads a position.
+export function optionalArgument(args, index, name) {
+    return readSingleValue(args[index], `Argument [${name}]`);
+}
+//# sourceMappingURL=arguments.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.js","sourceRoot":"","sources":["../../../../src/cli/commands/deployment/arguments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,gEAAgE;AAChE,EAAE;AACF,oGAAoG;AACpG,iGAAiG;AACjG,0CAA0C;AAC1C,EAAE;AACF,kGAAkG;AAClG,mGAAmG;AACnG,MAAM,UAAU,gBAAgB,CAC9B,IAA+B,EAC/B,KAAa,EACb,IAAY;IAEZ,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,aAAa,IAAI,GAAG,CAAC,CAAC;AAC5D,CAAC"}

package/dist/cli/commands/deployment/build-logs.d.ts

@@ -0,0 +1,3 @@
+import { type CloudCommandInput } from "../../index.js";
+export declare function deploymentBuildLogs({ args, options, globals, }: CloudCommandInput): Promise<number | undefined>;
+//# sourceMappingURL=build-logs.d.ts.map

package/dist/cli/commands/deployment/build-logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-logs.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deployment/build-logs.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EAOvB,MAAM,gBAAgB,CAAC;AASxB,wBAAsB,mBAAmB,CAAC,EACxC,IAAI,EACJ,OAAO,EACP,OAAO,GACR,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA6CjD"}

package/dist/cli/commands/deployment/build-logs.js

@@ -0,0 +1,98 @@
+import * as prompts from "@clack/prompts";
+import { cloudInvocation, createAuthenticatedClient, resolveEnvironment, } from "../../index.js";
+import { consumeLogStream, printLogLine } from "../../lib/log-stream.js";
+import { optionalArgument } from "./arguments.js";
+import { readBooleanOption, readStringOption } from "./options.js";
+import { DEPLOYMENT_PAGE_SIZE, resolveDeploymentId } from "./shared.js";
+const BUILD_LOG_PAGE_SIZE = 1_000;
+export async function deploymentBuildLogs({ args, options, globals, }) {
+    if (globals.json) {
+        throw new Error("Build Step Logs are text output and do not support --json.");
+    }
+    const deploymentId = optionalArgument(args, 0, "deployment-id");
+    const follow = readBooleanOption(options.follow);
+    const lines = parseLineCount(readStringOption(options.lines, "--lines"));
+    const client = createAuthenticatedClient(globals);
+    const resolvedDeploymentId = deploymentId
+        ? await resolveDeploymentId(client, globals, deploymentId)
+        : await findLatestBuildDeploymentId(client, globals);
+    if (follow) {
+        const query = new URLSearchParams({ lines: String(lines) });
+        const interrupted = await consumeLogStream(client, `/deployments/${encodeURIComponent(resolvedDeploymentId)}/build-logs/stream?${query}`, { expectTerminalFrame: true });
+        return interrupted ? 130 : undefined;
+    }
+    let cursor;
+    let itemCount = 0;
+    do {
+        const query = new URLSearchParams({ limit: String(BUILD_LOG_PAGE_SIZE) });
+        if (cursor)
+            query.set("cursor", cursor);
+        const page = await client.get(`/deployments/${encodeURIComponent(resolvedDeploymentId)}/build-logs?${query}`);
+        if (page.status !== "AVAILABLE") {
+            printUnavailable(page.status, resolvedDeploymentId);
+            return;
+        }
+        for (const entry of page.items) {
+            printLogLine(entry);
+            itemCount += 1;
+        }
+        cursor = page.nextCursor ?? undefined;
+    } while (cursor);
+    if (itemCount === 0) {
+        prompts.log.warn("No Build Step Log output is available yet.");
+    }
+}
+async function findLatestBuildDeploymentId(client, options) {
+    const { environment } = await resolveEnvironment(options);
+    let offset = 0;
+    while (true) {
+        const query = new URLSearchParams({
+            environmentId: environment.id,
+            limit: String(DEPLOYMENT_PAGE_SIZE),
+            offset: String(offset),
+        });
+        const page = await client.get(`/deployments?${query}`);
+        const match = page.items.find((deployment) => deployment.hasBuildStep ?? deployment.applicationSource === "SOURCE_BUILD");
+        if (match)
+            return match.id;
+        offset += page.items.length;
+        if (offset >= page.total || page.items.length === 0)
+            break;
+    }
+    throw new Error(`No deployment with a Build Step Log found for VC Environment "${environment.slug}". Run \`${cloudInvocation()} deploy\` first or pass a deployment ID.`);
+}
+function parseLineCount(value) {
+    const lines = value === undefined ? Number.NaN : Number.parseInt(value, 10);
+    if (!Number.isInteger(lines) || lines < 1 || lines > 1_000) {
+        throw new Error("--lines must be an integer between 1 and 1000.");
+    }
+    return lines;
+}
+// The default branch matters as much as the cases. The status comes from a control plane that may
+// be newer than this client, so a status added after a release would otherwise print nothing and
+// exit zero, which reads as an empty log rather than as a client too old to explain the answer.
+function printUnavailable(status, deploymentId) {
+    switch (status) {
+        case "NOT_STARTED":
+            prompts.log.info("The Build Step has not started yet. Re-run with --follow to wait.");
+            return;
+        case "NO_BUILD_STEP":
+            prompts.log.info(`VC Deployment ${deploymentId} has no Build Step Log.`);
+            return;
+        case "NO_OUTPUT":
+            prompts.log.warn(`The Build Step produced no output. Run \`${cloudInvocation()} deployment show\` for why it failed.`);
+            return;
+        case "EXPIRED":
+            prompts.log.warn("This Build Step Log has expired after the 30-day retention window.");
+            return;
+        case "AVAILABLE":
+            return;
+        default:
+            // Names no package to update. The same code runs under `vendure`, where the artifact is
+            // `@vendure/cloud`, and under `vcloud`, where it is `@vendure/cloud-cli`, so any install
+            // command here is wrong on one of the two surfaces.
+            prompts.log.warn(`Vendure Cloud reported this Build Step Log as "${status}", which this version of the CLI does not recognise. Update the CLI to see it explained.`);
+            return;
+    }
+}
+//# sourceMappingURL=build-logs.js.map

package/dist/cli/commands/deployment/build-logs.js.map

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

package/dist/cli/commands/deployment/deploy.d.ts

@@ -0,0 +1,3 @@
+import { type CloudCommandInput } from "../../index.js";
+export declare function deploy({ options, globals }: CloudCommandInput): Promise<number | undefined>;
+//# sourceMappingURL=deploy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/deployment/deploy.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EAWvB,MAAM,gBAAgB,CAAC;AAkExB,wBAAsB,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoKjG"}