@vendure/cloud 0.0.0 → 0.3.0

package/dist/cli/commands/runtime-data/index.js

@@ -0,0 +1,206 @@
+import { defineCloudCommand, defineCloudCommandGroup, } from "../../command.js";
+// The hosted Cloud commands that operate a running VC Environment and move data in and out of it:
+// the VC Runtime Operations behind `resource`, the database backup, restore and tunnel commands,
+// and the named seed datasets an organization keeps.
+//
+// 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 the authentication stack, `zod` or `@clack/prompts` behind them.
+// `../../lib/contract/seeds.js` imports `zod`, which is the specific reason the seed commands
+// cannot be reached from here at module scope.
+//
+// `test/cli-published-surface.test.ts` holds that line by walking the static graph from
+// `cli-plugin.ts`, which reaches this file through the assembled inventory.
+//
+// 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.
+//
+// `deploy`, `status`, `logs` and `rollback` are not part of this family. They read a VC Deployment
+// rather than operate a resource, and CLO-688 owns them.
+const resourceCommands = defineCloudCommandGroup({
+    name: "resource",
+    description: "Inspect and control environment resources",
+    subcommands: [
+        runtimeOperation("stop", "Stop all or selected runtime services"),
+        runtimeOperation("start", "Start all or selected runtime services"),
+        runtimeOperation("restart", "Restart all or selected runtime services"),
+        defineCloudCommand({
+            name: "list",
+            description: "List managed resources",
+            run: async (input) => (await import("./resource.js")).listResources(input),
+        }),
+        defineCloudCommand({
+            name: "show",
+            description: "Show managed resource details",
+            arguments: [{ name: "resource", description: "Managed resource key", required: true }],
+            run: async (input) => (await import("./resource.js")).showResource(input),
+        }),
+    ],
+});
+// `backup db` both runs a backup and carries `list` and `status` beneath it, which is the shape
+// `vcloud backup db` has always had. The host registers it as a runnable parent: `backup db` backs
+// up, `backup db list` and `backup db status` run these, and a word that is neither is refused as
+// an unknown command rather than falling through into a backup.
+//
+// That refusal depends on `backup db` declaring no positional argument, and it must not gain one.
+// A runnable parent hands a token that falls inside one of its own declared slots to the action as
+// a value, so a parent with a slot to fill could take `lst` for data rather than for a misspelled
+// `list`. This one has no slot, so every operand it is given is spare. The host also refuses a node
+// declaring both positional arguments and subcommands outright, at plugin load.
+const backupSubcommands = [
+    defineCloudCommand({
+        name: "list",
+        description: "List database backups",
+        run: async (input) => (await import("./backup.js")).listBackups(input),
+    }),
+    defineCloudCommand({
+        name: "status",
+        description: "Show the status of a database backup",
+        arguments: [{ name: "backup-id", description: "Backup id", required: true }],
+        run: async (input) => (await import("./backup.js")).showBackupStatus(input),
+    }),
+];
+const backupCommands = defineCloudCommandGroup({
+    name: "backup",
+    description: "Back up an environment resource",
+    subcommands: [
+        // 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({
+                name: "db",
+                description: "Back up the environment database",
+                options: [
+                    {
+                        long: "--no-wait",
+                        description: "Trigger the backup and exit without waiting for completion",
+                    },
+                ],
+                run: async (input) => (await import("./backup.js")).createBackup(input),
+            }),
+            subcommands: backupSubcommands,
+        },
+    ],
+});
+const restoreCommands = defineCloudCommandGroup({
+    name: "restore",
+    description: "Restore an environment resource",
+    subcommands: [
+        defineCloudCommand({
+            name: "db",
+            description: "Restore the environment database from a backup, overwriting all current data (interactive by default)",
+            arguments: [
+                {
+                    name: "backup-id",
+                    description: "Backup id to restore from (see `backup db list`)",
+                    required: true,
+                },
+            ],
+            options: [
+                {
+                    long: "--i-know-this-destroys-data",
+                    description: "DANGEROUS. Overwrite this environment's database with no confirmation and no terminal. Every row written since the backup is lost. Only for a script that has already established which environment it is pointed at.",
+                },
+            ],
+            run: async (input) => (await import("./restore.js")).restoreDatabase(input),
+        }),
+    ],
+});
+const tunnelCommands = defineCloudCommandGroup({
+    name: "tunnel",
+    description: "Open a local tunnel to an environment resource",
+    subcommands: [
+        defineCloudCommand({
+            name: "db",
+            description: "Open a local tunnel to the environment database",
+            options: [
+                {
+                    // `required` is about the value: it keeps the host emitting `--port <port>` rather than
+                    // `--port [port]`, so `--port` with nothing after it stays the error it is under `vcloud`.
+                    long: "--port <port>",
+                    description: "Local port to listen on (defaults to 5432, falls back to a free port)",
+                    required: true,
+                },
+            ],
+            run: async (input) => (await import("./tunnel.js")).openDatabaseTunnel(input),
+        }),
+    ],
+});
+const seedCommands = defineCloudCommandGroup({
+    name: "seed",
+    description: "Manage named seed datasets",
+    subcommands: [
+        defineCloudCommand({
+            name: "push",
+            description: "Upload a gzipped plain-SQL dump as a named seed",
+            arguments: [
+                { name: "name", description: "Seed name (lowercase, hyphen-separated)", required: true },
+                {
+                    name: "file",
+                    description: "Path to the gzipped SQL dump (.gz or .sql.gz)",
+                    required: true,
+                },
+            ],
+            run: async (input) => (await import("./seeds.js")).pushSeed(input),
+        }),
+        defineCloudCommand({
+            name: "ls",
+            description: "List named seeds in your organization",
+            run: async (input) => (await import("./seeds.js")).listSeeds(input),
+        }),
+        defineCloudCommand({
+            name: "apply",
+            description: "Import a named seed into an environment's database (overwrites all current data)",
+            arguments: [{ name: "name", description: "Seed name to apply", required: true }],
+            options: [
+                {
+                    long: "--yes",
+                    description: "Skip the confirmation prompt (required for non-interactive use)",
+                },
+            ],
+            run: async (input) => (await import("./seeds.js")).applySeed(input),
+        }),
+        defineCloudCommand({
+            name: "rm",
+            description: "Delete a named seed from your organization",
+            arguments: [{ name: "name", description: "Seed name to delete", required: true }],
+            options: [{ long: "--yes", description: "Skip the confirmation prompt" }],
+            run: async (input) => (await import("./seeds.js")).removeSeed(input),
+        }),
+    ],
+});
+export const runtimeDataCommands = [
+    resourceCommands,
+    backupCommands,
+    restoreCommands,
+    tunnelCommands,
+    seedCommands,
+];
+// The three VC Runtime Operations differ only in the action they start and the words around it, so
+// they are declared once. The `[resources...]` argument is optional and variadic: it arrives as the
+// whole collected vector, and as `[]` when the customer named no resource, which is what
+// `resource.ts` reads as "all managed resources".
+//
+// The return type is read off `defineCloudCommand` rather than named, because naming it means
+// importing it from `@vendure/cli`, and resolving the host is one of the costs this module exists
+// to avoid.
+function runtimeOperation(name, description) {
+    return defineCloudCommand({
+        name,
+        description,
+        arguments: [
+            {
+                name: "resources...",
+                description: "Managed resource keys to act on, or none for all of them",
+            },
+        ],
+        options: [
+            { long: "--yes", description: "Skip the production confirmation prompt" },
+            { long: "--no-wait", description: `Start the ${name} operation and exit` },
+        ],
+        run: async (input) => (await import("./resource.js")).runResourceOperation(input, name),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/runtime-data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cli/commands/runtime-data/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,kGAAkG;AAClG,iGAAiG;AACjG,qDAAqD;AACrD,EAAE;AACF,iGAAiG;AACjG,gGAAgG;AAChG,wFAAwF;AACxF,+FAA+F;AAC/F,8FAA8F;AAC9F,+CAA+C;AAC/C,EAAE;AACF,wFAAwF;AACxF,4EAA4E;AAC5E,EAAE;AACF,iGAAiG;AACjG,kGAAkG;AAClG,kCAAkC;AAClC,EAAE;AACF,mGAAmG;AACnG,yDAAyD;AAEzD,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;IAC/C,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,2CAA2C;IACxD,WAAW,EAAE;QACX,gBAAgB,CAAC,MAAM,EAAE,uCAAuC,CAAC;QACjE,gBAAgB,CAAC,OAAO,EAAE,wCAAwC,CAAC;QACnE,gBAAgB,CAAC,SAAS,EAAE,0CAA0C,CAAC;QACvE,kBAAkB,CAAC;YACjB,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,wBAAwB;YACrC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC;SAC3E,CAAC;QACF,kBAAkB,CAAC;YACjB,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,+BAA+B;YAC5C,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,sBAAsB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACtF,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC;SAC1E,CAAC;KACH;CACF,CAAC,CAAC;AAEH,gGAAgG;AAChG,mGAAmG;AACnG,kGAAkG;AAClG,gEAAgE;AAChE,EAAE;AACF,kGAAkG;AAClG,mGAAmG;AACnG,kGAAkG;AAClG,oGAAoG;AACpG,gFAAgF;AAChF,MAAM,iBAAiB,GAAuB;IAC5C,kBAAkB,CAAC;QACjB,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,uBAAuB;QACpC,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC;KACvE,CAAC;IACF,kBAAkB,CAAC;QACjB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,sCAAsC;QACnD,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC5E,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC;KAC5E,CAAC;CACH,CAAC;AAEF,MAAM,cAAc,GAAG,uBAAuB,CAAC;IAC7C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,iCAAiC;IAC9C,WAAW,EAAE;QACX,6FAA6F;QAC7F,uFAAuF;QACvF;YACE,GAAG,kBAAkB,CAAC;gBACpB,IAAI,EAAE,IAAI;gBACV,WAAW,EAAE,kCAAkC;gBAC/C,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,WAAW;wBACjB,WAAW,EAAE,4DAA4D;qBAC1E;iBACF;gBACD,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC;aACxE,CAAC;YACF,WAAW,EAAE,iBAAiB;SAC/B;KACF;CACF,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,uBAAuB,CAAC;IAC9C,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,iCAAiC;IAC9C,WAAW,EAAE;QACX,kBAAkB,CAAC;YACjB,IAAI,EAAE,IAAI;YACV,WAAW,EACT,uGAAuG;YACzG,SAAS,EAAE;gBACT;oBACE,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,kDAAkD;oBAC/D,QAAQ,EAAE,IAAI;iBACf;aACF;YACD,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,6BAA6B;oBACnC,WAAW,EACT,uNAAuN;iBAC1N;aACF;YACD,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC;SAC5E,CAAC;KACH;CACF,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,uBAAuB,CAAC;IAC7C,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,gDAAgD;IAC7D,WAAW,EAAE;QACX,kBAAkB,CAAC;YACjB,IAAI,EAAE,IAAI;YACV,WAAW,EAAE,iDAAiD;YAC9D,OAAO,EAAE;gBACP;oBACE,wFAAwF;oBACxF,2FAA2F;oBAC3F,IAAI,EAAE,eAAe;oBACrB,WAAW,EAAE,uEAAuE;oBACpF,QAAQ,EAAE,IAAI;iBACf;aACF;YACD,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC;SAC9E,CAAC;KACH;CACF,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,uBAAuB,CAAC;IAC3C,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,4BAA4B;IACzC,WAAW,EAAE;QACX,kBAAkB,CAAC;YACjB,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,iDAAiD;YAC9D,SAAS,EAAE;gBACT,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,yCAAyC,EAAE,QAAQ,EAAE,IAAI,EAAE;gBACxF;oBACE,IAAI,EAAE,MAAM;oBACZ,WAAW,EAAE,+CAA+C;oBAC5D,QAAQ,EAAE,IAAI;iBACf;aACF;YACD,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;SACnE,CAAC;QACF,kBAAkB,CAAC;YACjB,IAAI,EAAE,IAAI;YACV,WAAW,EAAE,uCAAuC;YACpD,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;SACpE,CAAC;QACF,kBAAkB,CAAC;YACjB,IAAI,EAAE,OAAO;YACb,WAAW,EACT,kFAAkF;YACpF,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAChF,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,iEAAiE;iBAC/E;aACF;YACD,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;SACpE,CAAC;QACF,kBAAkB,CAAC;YACjB,IAAI,EAAE,IAAI;YACV,WAAW,EAAE,4CAA4C;YACzD,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACjF,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,8BAA8B,EAAE,CAAC;YACzE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC;SACrE,CAAC;KACH;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,gBAAgB;IAChB,cAAc;IACd,eAAe;IACf,cAAc;IACd,YAAY;CACb,CAAC;AAEF,mGAAmG;AACnG,oGAAoG;AACpG,yFAAyF;AACzF,kDAAkD;AAClD,EAAE;AACF,8FAA8F;AAC9F,kGAAkG;AAClG,YAAY;AACZ,SAAS,gBAAgB,CACvB,IAAkC,EAClC,WAAmB;IAEnB,OAAO,kBAAkB,CAAC;QACxB,IAAI;QACJ,WAAW;QACX,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,0DAA0D;aACxE;SACF;QACD,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,yCAAyC,EAAE;YACzE,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,IAAI,qBAAqB,EAAE;SAC3E;QACD,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC;KACxF,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/commands/runtime-data/resource.d.ts

@@ -0,0 +1,11 @@
+import { type CloudCommandInput } from "../../index.js";
+declare const OPERATION_ACTIONS: {
+    readonly stop: "STOP";
+    readonly start: "START";
+    readonly restart: "RESTART";
+};
+export declare function runResourceOperation({ args, options, globals }: CloudCommandInput, name: keyof typeof OPERATION_ACTIONS): Promise<number | undefined>;
+export declare function listResources({ globals }: CloudCommandInput): Promise<void>;
+export declare function showResource({ args, globals }: CloudCommandInput): Promise<void>;
+export {};
+//# sourceMappingURL=resource.d.ts.map

package/dist/cli/commands/runtime-data/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/runtime-data/resource.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,iBAAiB,EAQvB,MAAM,gBAAgB,CAAC;AAoBxB,QAAA,MAAM,iBAAiB;;;;CAIb,CAAC;AAEX,wBAAsB,oBAAoB,CACxC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,iBAAiB,EAC7C,IAAI,EAAE,MAAM,OAAO,iBAAiB,GACnC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA0D7B;AAED,wBAAsB,aAAa,CAAC,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAajF;AAED,wBAAsB,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBtF"}

package/dist/cli/commands/runtime-data/resource.js

@@ -0,0 +1,147 @@
+import * as prompts from "@clack/prompts";
+import { cloudInvocation, createAuthenticatedClient, requiredArgument, resolveEnvironment, sleep, variadicArgument, writeJson, } from "../../index.js";
+import { RUNTIME_OPERATION_TIMEOUT_MS, RuntimeOperationAction, RuntimeOperationStatus, isTerminalRuntimeOperationStatus, } from "../../lib/contract/runtime-operations.js";
+const POLL_INTERVAL_MS = 3_000;
+// `vcloud` kept its own terminal-status set and its own fifteen-minute ceiling, both identical to
+// the shared ones. `isTerminalRuntimeOperationStatus` is the contract's own guard over
+// `TERMINAL_RUNTIME_OPERATION_STATUSES`, so following an operation and giving up on one are both
+// read from the contract rather than from a copy that would keep polling forever if a status were
+// added. The ceiling is quoted in the sentence a customer reads, which is where a copy would show.
+// Which action each command name starts. Declared here rather than in the command tree so the
+// declaration module does not reach the contract, which is where `zod` starts.
+const OPERATION_ACTIONS = {
+    stop: RuntimeOperationAction.STOP,
+    start: RuntimeOperationAction.START,
+    restart: RuntimeOperationAction.RESTART,
+};
+export async function runResourceOperation({ args, options, globals }, name) {
+    const action = OPERATION_ACTIONS[name];
+    const resources = variadicArgument(args, 0, "resources");
+    // `--no-wait` is a negated boolean, so the host's Commander gives `wait` and defaults it to true.
+    // Anything other than the flag having been given reads as waiting, which is what `vcloud` did.
+    const wait = options.wait !== false;
+    const skipConfirmation = options.yes === true;
+    const { project, environment } = await resolveEnvironment(globals);
+    const json = globals.json === true;
+    const requiresConfirmation = environment.type === "PRODUCTION" && action !== RuntimeOperationAction.START;
+    const target = resources.length > 0 ? resources.join(", ") : "all managed resources";
+    if (json && requiresConfirmation && !skipConfirmation) {
+        throw new Error("--json requires --yes for production stop and restart commands.");
+    }
+    if (requiresConfirmation && !skipConfirmation) {
+        const verb = action.toLowerCase();
+        const confirmed = await prompts.confirm({
+            initialValue: false,
+            message: `${titleCase(verb)} ${target} for production environment "${project.slug}/${environment.slug}"?`,
+        });
+        if (prompts.isCancel(confirmed) || !confirmed) {
+            prompts.outro(`${titleCase(verb)} cancelled.`);
+            return undefined;
+        }
+    }
+    const client = createAuthenticatedClient(globals);
+    let operation = await client.post(`/environments/${environment.id}/resource-operations`, { action, ...(resources.length > 0 ? { resources } : {}) });
+    if (!wait || isTerminalRuntimeOperationStatus(operation.status)) {
+        return outputOperation(operation, json, project.slug, environment.slug);
+    }
+    const spinner = json ? null : prompts.spinner();
+    spinner?.start(`${titleCase(action.toLowerCase())} in progress...`);
+    const startedAt = Date.now();
+    while (!isTerminalRuntimeOperationStatus(operation.status)) {
+        if (Date.now() - startedAt > RUNTIME_OPERATION_TIMEOUT_MS) {
+            spinner?.stop("Resource operation is still running.");
+            const message = `Resource operation ${operation.id} is still running in the background after ${RUNTIME_OPERATION_TIMEOUT_MS / 60_000} minutes. Use ${cloudInvocation()} resource list to check current state.`;
+            if (json)
+                throw new Error(message);
+            prompts.log.warn(message);
+            return 1;
+        }
+        await sleep(POLL_INTERVAL_MS);
+        operation = await client.get(`/environments/${environment.id}/resource-operations/${operation.id}`);
+        spinner?.message(operation.status.toLowerCase());
+    }
+    spinner?.stop(runtimeCompletionMessage(operation));
+    return outputOperation(operation, json, project.slug, environment.slug);
+}
+export async function listResources({ globals }) {
+    const { environment } = await resolveEnvironment(globals);
+    const resources = await createAuthenticatedClient(globals).get(`/environments/${environment.id}/resources`);
+    if (globals.json === true) {
+        writeJson(resources);
+        return;
+    }
+    for (const resource of resources) {
+        const health = resource.health ? ` / ${resource.health}` : "";
+        prompts.log.info(`${resource.name} — ${resource.category} — ${resource.runtimeState}${health}`);
+    }
+}
+export async function showResource({ args, globals }) {
+    const resourceKey = requiredArgument(args, 0, "resource");
+    const { environment } = await resolveEnvironment(globals);
+    const resource = await createAuthenticatedClient(globals).get(`/environments/${environment.id}/resources/${encodeURIComponent(resourceKey)}`);
+    if (globals.json === true) {
+        writeJson(resource);
+        return;
+    }
+    prompts.log.info(`Resource:     ${resource.name}`);
+    prompts.log.info(`Category:     ${resource.category}`);
+    prompts.log.info(`Type:         ${resource.type}`);
+    prompts.log.info(`State:        ${resource.runtimeState}`);
+    prompts.log.info(`Health:       ${resource.health ?? "N/A"}`);
+    if (resource.stateReason)
+        prompts.log.info(`Reason:       ${resource.stateReason}`);
+    if (resource.observedAt)
+        prompts.log.info(`Observed:     ${resource.observedAt}`);
+    prompts.log.info(`Actions:      ${resource.supportedActions.join(", ") || "None"}`);
+    for (const [key, value] of Object.entries(resource.configuration)) {
+        if (value !== undefined)
+            prompts.log.info(`${formatConfigurationKey(key)}: ${value}`);
+    }
+}
+// Answers the exit code the operation earned: a partial or failed operation is a failure, and
+// everything else is not.
+function outputOperation(operation, json, projectSlug, environmentSlug) {
+    if (json) {
+        writeJson(operation);
+    }
+    else {
+        for (const result of operation.results ?? []) {
+            prompts.log.info(`${result.resource}: ${result.state} (${result.outcome})`);
+            if (result.errorDetails)
+                prompts.log.error(result.errorDetails);
+        }
+        if (operation.errorDetails)
+            prompts.log.error(operation.errorDetails);
+        prompts.outro(`${projectSlug} / ${environmentSlug}: ${operationSummary(operation)}`);
+    }
+    if (operation.status === RuntimeOperationStatus.PARTIAL ||
+        operation.status === RuntimeOperationStatus.FAILED) {
+        return 1;
+    }
+    return undefined;
+}
+function operationSummary(operation) {
+    const action = operation.action.toLowerCase();
+    if (operation.status === RuntimeOperationStatus.SUCCEEDED) {
+        return `${action} operation succeeded`;
+    }
+    if (operation.status === RuntimeOperationStatus.PARTIAL) {
+        return `${action} operation partially completed`;
+    }
+    return `${action} operation ${operation.status.toLowerCase()}`;
+}
+function runtimeCompletionMessage(operation) {
+    if (operation.status === RuntimeOperationStatus.SUCCEEDED)
+        return "Resource operation complete.";
+    if (operation.status === RuntimeOperationStatus.PARTIAL) {
+        return "Resource operation partially completed.";
+    }
+    return "Resource operation failed.";
+}
+function titleCase(value) {
+    return `${value.charAt(0).toUpperCase()}${value.slice(1)}`;
+}
+function formatConfigurationKey(value) {
+    return titleCase(value.replace(/([a-z0-9])([A-Z])/g, "$1 $2"));
+}
+//# sourceMappingURL=resource.js.map

package/dist/cli/commands/runtime-data/resource.js.map

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

package/dist/cli/commands/runtime-data/restore.d.ts

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

package/dist/cli/commands/runtime-data/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/runtime-data/restore.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EAQvB,MAAM,gBAAgB,CAAC;AA6CxB,wBAAsB,eAAe,CAAC,EACpC,IAAI,EACJ,OAAO,EACP,OAAO,GACR,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAqEjD"}

package/dist/cli/commands/runtime-data/restore.js

@@ -0,0 +1,119 @@
+import * as prompts from "@clack/prompts";
+import { cloudInvocation, createAuthenticatedClient, formatDateTime, formatDuration, requiredArgument, resolveEnvironment, sleep, } from "../../index.js";
+import { DB_OPERATION_FAILED_STATUSES, DB_OPERATION_SUCCESS_STATUS, } from "../../lib/contract/database.js";
+// A restore is two long operations back to back and neither reports a percentage, so the poll starts
+// quick enough to feel responsive on a small database and widens rather than asking every few
+// seconds for hours.
+const FIRST_POLL_INTERVAL_MS = 3_000;
+const MAX_POLL_INTERVAL_MS = 30_000;
+const POLL_BACKOFF_FACTOR = 2;
+// How much longer than the platform's own budget to keep watching. The budget comes back on the
+// start response and is derived from the size of this environment's own archive, so there is no
+// fixed number here to be wrong for a big tenant — this margin only covers the clock skew between
+// the two machines.
+const DEADLINE_MARGIN_MS = 60_000;
+// The flag that lets a destructive, unattended restore happen at all. Spelled out rather than
+// `--yes`, deliberately: every other `--yes` in this CLI skips a confirmation, and this one
+// authorises overwriting a production database from a script. A flag somebody can type by habit is
+// the wrong shape for that.
+const NON_INTERACTIVE_FLAG = "--i-know-this-destroys-data";
+// Built when it is shown rather than held as a constant, because it names the program the customer
+// ran and the compatibility executable names itself after this module has already been loaded.
+function migrationWarning() {
+    return `If this backup predates your latest deploy, the database schema may now be behind the running code. Run \`${cloudInvocation()} deploy\` to re-apply pending migrations.`;
+}
+// What each phase is called while a customer watches it. The safety backup has touched nothing yet
+// and the restore has, which is the one distinction worth spelling out on a spinner.
+const PHASE_MESSAGE = {
+    queued: "Waiting for Vendure Cloud to pick up the restore",
+    "safety-backup": "Taking a safety backup of the current data",
+    restoring: "Restoring the database",
+    completed: "Restore complete",
+    failed: "Restore failed",
+};
+export async function restoreDatabase({ args, options, globals, }) {
+    const backupId = requiredArgument(args, 0, "backup-id");
+    const confirmedByFlag = options.iKnowThisDestroysData === true;
+    // Checked before the environment is resolved, so a script that cannot proceed fails without a
+    // network call and without having named an environment it is about to overwrite.
+    if (!confirmedByFlag && !process.stdin.isTTY) {
+        throw new Error(`\`${cloudInvocation()} restore db\` overwrites this environment's database and requires an interactive terminal. Re-run with ${NON_INTERACTIVE_FLAG} to proceed without one.`);
+    }
+    const { project, environment } = await resolveEnvironment(globals);
+    const client = createAuthenticatedClient(globals);
+    const backup = await client.get(`/environments/${environment.id}/database/backups/${encodeURIComponent(backupId)}`);
+    if (!confirmedByFlag) {
+        const confirmed = await prompts.confirm({
+            initialValue: false,
+            message: `Restore the ${project.slug} / ${environment.slug} database from backup ${backup.id} (created ${formatDateTime(backup.createdAt)})? All current data will be overwritten.`,
+        });
+        if (prompts.isCancel(confirmed) || !confirmed) {
+            prompts.log.info("Restore cancelled.");
+            return undefined;
+        }
+    }
+    const spinner = prompts.spinner();
+    spinner.start("Starting the restore...");
+    let result;
+    try {
+        result = await client.post(`/environments/${environment.id}/database/backups/${encodeURIComponent(backupId)}/restore`);
+    }
+    catch (error) {
+        spinner.stop("Restore could not be started");
+        throw error;
+    }
+    // Said once, before the wait: the id is what recovers this environment if the restored data turns
+    // out to be the wrong choice, and a customer should have it whatever happens next — including a
+    // terminal that is closed while the restore is still running.
+    prompts.log.info(`A safety backup of the current data is being taken as ${result.safetyBackupId}. Restore it with \`${cloudInvocation()} restore db ${result.safetyBackupId}\` if you need the previous state back.`);
+    const current = await pollRestore(client, environment.id, result, spinner);
+    if (!current)
+        return 1;
+    if (current.status === DB_OPERATION_SUCCESS_STATUS) {
+        spinner.stop("Restore complete.");
+        prompts.log.success(`Database restored from backup ${backup.id}. A safety backup of the previous state was kept as ${result.safetyBackupId}.`);
+        prompts.log.warn(migrationWarning());
+        return undefined;
+    }
+    spinner.stop("Restore failed");
+    // The control plane's own sentence when it has one: it is written for a customer, names the safety
+    // backup and says what to do next. The status alone is the fallback.
+    prompts.log.error(current.errorDetails ??
+        `Restore ${result.restoreId} ended with status "${current.status}". The safety backup ${result.safetyBackupId} holds the data from before this attempt.`);
+    return 1;
+}
+// Polls until the restore settles, reporting each phase as it arrives. Returns null when the
+// platform's own deadline passed without the restore settling, which is reported here rather than
+// treated as a failure — the row is the record, and nothing local knows what became of the work.
+async function pollRestore(client, environmentId, result, spinner) {
+    const startedAt = Date.now();
+    // Derived from this environment's own archive by the control plane. Clamped below at one minute so
+    // a clock ahead of the platform's cannot make the client give up before it has polled once.
+    const deadline = Math.max(startedAt + FIRST_POLL_INTERVAL_MS, new Date(result.deadlineAt).getTime() + DEADLINE_MARGIN_MS);
+    let interval = FIRST_POLL_INTERVAL_MS;
+    let reportedPhase = null;
+    while (true) {
+        await sleep(Math.min(interval, Math.max(0, deadline - Date.now())));
+        const current = await client.get(`/environments/${environmentId}/database/restores/${result.restoreId}`);
+        if (current.phase !== reportedPhase) {
+            reportedPhase = current.phase;
+            spinner.message(`${PHASE_MESSAGE[current.phase]}...`);
+        }
+        else {
+            // The same phase, said again with how long it has been going. A destructive operation that
+            // says nothing for an hour is indistinguishable from one nobody is watching.
+            spinner.message(`${PHASE_MESSAGE[current.phase]} (${formatDuration(Date.now() - startedAt)} so far)...`);
+        }
+        if (current.status === DB_OPERATION_SUCCESS_STATUS ||
+            DB_OPERATION_FAILED_STATUSES.has(current.status)) {
+            return current;
+        }
+        if (Date.now() >= deadline) {
+            spinner.stop("Restore is taking longer than Vendure Cloud allows for it");
+            prompts.log.warn(`Restore ${result.restoreId} has not finished within the time Vendure Cloud allows for this environment's data. Vendure Cloud will finish or stop it on its own — check it with \`${cloudInvocation()} backup db list\` before deploying or restoring again. The safety backup ${result.safetyBackupId} holds the data from before this attempt.`);
+            return null;
+        }
+        interval = Math.min(MAX_POLL_INTERVAL_MS, interval * POLL_BACKOFF_FACTOR);
+    }
+}
+//# sourceMappingURL=restore.js.map

package/dist/cli/commands/runtime-data/restore.js.map

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

package/dist/cli/commands/runtime-data/seeds.d.ts

@@ -0,0 +1,6 @@
+import { type CloudCommandInput } from "../../index.js";
+export declare function pushSeed({ args, globals }: CloudCommandInput): Promise<void>;
+export declare function listSeeds({ globals }: CloudCommandInput): Promise<void>;
+export declare function applySeed({ args, options, globals }: CloudCommandInput): Promise<void>;
+export declare function removeSeed({ args, options, globals }: CloudCommandInput): Promise<void>;
+//# sourceMappingURL=seeds.d.ts.map

package/dist/cli/commands/runtime-data/seeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeds.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/runtime-data/seeds.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,iBAAiB,EASvB,MAAM,gBAAgB,CAAC;AAwBxB,wBAAsB,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+DlF;AAED,wBAAsB,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B7E;AAED,wBAAsB,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6E5F;AAED,wBAAsB,UAAU,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B7F"}