@vendure/cloud 0.2.0 → 0.3.0

package/dist/cli/lib/types.d.ts

@@ -0,0 +1,58 @@
+import type { DeploymentApplicationSource, DeploymentSummary, EnvironmentSummaryResponse, ProtectedResource } from "./contract/wire-types.js";
+export type { DeploymentApplicationSource, DeploymentSummary, DeploymentSummaryAction, DeploymentSummaryCleanup, DeploymentSummaryCleanupFailure, DeploymentSummaryResourceRef, IdentityEnvironmentType, ProtectedResource, RuntimeIntent, RuntimeState, VcEnvironmentType, } from "./contract/wire-types.js";
+export interface Project {
+    id: string;
+    slug: string;
+    name: string;
+}
+export type Environment = EnvironmentSummaryResponse;
+export interface Deployment {
+    id: string;
+    environmentId?: string;
+    status: string;
+    trigger: string;
+    commitHash: string | null;
+    commitMessage: string | null;
+    applicationSource?: DeploymentApplicationSource | null;
+    hasBuildStep?: boolean;
+    errorDetails: string | null;
+    statusMessage: string | null;
+    pollingTimeoutSeconds?: number;
+    protectedResources?: ProtectedResource[] | null;
+    summary?: DeploymentSummary | null;
+    startedAt: string | null;
+    completedAt: string | null;
+    createdAt: string;
+    triggeredBy?: {
+        id: string;
+        name: string | null;
+    } | null;
+}
+export interface RollbackTarget {
+    id: string;
+    status: string;
+    trigger: string;
+    commitHash: string | null;
+    commitMessage: string | null;
+    completedAt: string | null;
+    createdAt: string;
+    eligible: boolean;
+    unavailableReason: string | null;
+}
+export interface PaginatedDeployments {
+    items: Deployment[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface EnvVarSummary {
+    key: string;
+    source: "user" | "managed";
+    updatedAt?: string;
+    scope?: "runtime" | "build" | "both";
+    sensitive?: boolean;
+}
+export declare const TERMINAL_STATUSES: Set<string>;
+export declare const FAILED_STATUSES: Set<string>;
+export declare const SUCCESS_STATUSES: Set<string>;
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAC3B,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAIlC,YAAY,EACV,2BAA2B,EAC3B,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,+BAA+B,EAC/B,4BAA4B,EAC5B,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,WAAW,GAAG,0BAA0B,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAC;IACvD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;IAChD,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,iBAAiB,aAM5B,CAAC;AACH,eAAO,MAAM,eAAe,aAA+C,CAAC;AAC5E,eAAO,MAAM,gBAAgB,aAAoC,CAAC"}

package/dist/cli/lib/types.js

@@ -0,0 +1,10 @@
+export const TERMINAL_STATUSES = new Set([
+    "RUNNING",
+    "SUCCEEDED",
+    "FAILED",
+    "DEGRADED",
+    "CANCELLED",
+]);
+export const FAILED_STATUSES = new Set(["FAILED", "DEGRADED", "CANCELLED"]);
+export const SUCCESS_STATUSES = new Set(["RUNNING", "SUCCEEDED"]);
+//# sourceMappingURL=types.js.map

package/dist/cli/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/lib/types.ts"],"names":[],"mappings":"AA8EA,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IACvC,SAAS;IACT,WAAW;IACX,QAAQ;IACR,UAAU;IACV,WAAW;CACZ,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC"}

package/dist/cli/root-options.d.ts

@@ -0,0 +1,14 @@
+import type { CloudCommandOption } from "./host-nodes.js";
+export declare const CLOUD_ROOT_OPTIONS: CloudCommandOption[];
+export interface GlobalOptions {
+    token?: string;
+    project?: string;
+    environment?: string;
+    json?: boolean;
+}
+export type CredentialOptions = Pick<GlobalOptions, "token">;
+export declare function readGlobalOptions(input: {
+    inheritedOptions: Record<string, unknown>;
+    options: Record<string, unknown>;
+}): GlobalOptions;
+//# sourceMappingURL=root-options.d.ts.map

package/dist/cli/root-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-options.d.ts","sourceRoot":"","sources":["../../src/cli/root-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAW1D,eAAO,MAAM,kBAAkB,EAAE,kBAAkB,EAsBlD,CAAC;AAGF,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAKD,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AAU7D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,GAAG,aAAa,CAQhB"}

package/dist/cli/root-options.js

@@ -0,0 +1,53 @@
+// The selectors every hosted Cloud command shares. They are declared once, as the plugin's
+// `rootOptions`, and the host puts them on the root `vendure` program and passes their values down
+// to every command it registers for this plugin. A command that needs one reads it from the
+// context; declaring it again is what the host refuses for a group and what would shadow the root
+// value for a leaf.
+//
+// `required: true` is about the value, not the option: it keeps the host emitting `--token <token>`
+// rather than `--token [token]`, so `--token` with nothing after it stays the error it is under
+// `vcloud` instead of quietly parsing as `true`.
+export const CLOUD_ROOT_OPTIONS = [
+    {
+        long: "--token <token>",
+        description: "API token for authentication",
+        required: true,
+    },
+    {
+        short: "-p",
+        long: "--project <slug-or-id>",
+        description: "VC Project slug or ID",
+        required: true,
+    },
+    {
+        short: "-e",
+        long: "--environment <slug-or-id>",
+        description: "VC Environment slug or ID",
+        required: true,
+    },
+    {
+        long: "--json",
+        description: "Write stable JSON to stdout",
+    },
+];
+// The one place the root option values are turned into a shape a command can rely on.
+//
+// Two sources, because the host has two. `inheritedOptions` carries the shared values from wherever
+// on the command line they were given, and it holds only the ones that were actually supplied. A
+// command's own parsed options carry a value when that command declares an option of the same name
+// — which the host allows for a leaf, and fills from the shared value when the leaf did not receive
+// its own. Reading the command's own value first and the inherited one second is therefore right
+// in both layouts.
+export function readGlobalOptions(input) {
+    const read = (key) => input.options[key] ?? input.inheritedOptions[key];
+    return {
+        token: readString(read("token")),
+        project: readString(read("project")),
+        environment: readString(read("environment")),
+        json: read("json") === true,
+    };
+}
+function readString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+//# sourceMappingURL=root-options.js.map

package/dist/cli/root-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-options.js","sourceRoot":"","sources":["../../src/cli/root-options.ts"],"names":[],"mappings":"AAEA,2FAA2F;AAC3F,mGAAmG;AACnG,4FAA4F;AAC5F,kGAAkG;AAClG,oBAAoB;AACpB,EAAE;AACF,oGAAoG;AACpG,gGAAgG;AAChG,iDAAiD;AACjD,MAAM,CAAC,MAAM,kBAAkB,GAAyB;IACtD;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,8BAA8B;QAC3C,QAAQ,EAAE,IAAI;KACf;IACD;QACE,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,uBAAuB;QACpC,QAAQ,EAAE,IAAI;KACf;IACD;QACE,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,2BAA2B;QACxC,QAAQ,EAAE,IAAI;KACf;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,6BAA6B;KAC3C;CACF,CAAC;AAeF,sFAAsF;AACtF,EAAE;AACF,oGAAoG;AACpG,iGAAiG;AACjG,mGAAmG;AACnG,oGAAoG;AACpG,iGAAiG;AACjG,mBAAmB;AACnB,MAAM,UAAU,iBAAiB,CAAC,KAGjC;IACC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACzF,OAAO;QACL,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,WAAW,EAAE,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5C,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI;KAC5B,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC"}

package/dist/cli-plugin.d.ts

@@ -0,0 +1,22 @@
+import type { CloudCommandNode, CloudCommandOption } from "./cli/command.js";
+import { type NextDevAction } from "./dev/dev-command.js";
+interface CliPluginLike {
+    id: string;
+    commands: CloudCommandNode[];
+    rootOptions: CloudCommandOption[];
+    extendCommands: Array<{
+        command: string;
+        description?: string;
+        options?: Array<{
+            long: string;
+            description: string;
+            required?: boolean;
+        }>;
+        decorate?: (input: {
+            next: NextDevAction;
+        }) => NextDevAction;
+    }>;
+}
+declare const cloudCliPlugin: CliPluginLike;
+export default cloudCliPlugin;
+//# sourceMappingURL=cli-plugin.d.ts.map

package/dist/cli-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-plugin.d.ts","sourceRoot":"","sources":["../src/cli-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAI7E,OAAO,EAAE,KAAK,aAAa,EAAe,MAAM,sBAAsB,CAAC;AAuBvE,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,cAAc,EAAE,KAAK,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAC3E,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;YAAE,IAAI,EAAE,aAAa,CAAA;SAAE,KAAK,aAAa,CAAC;KAC9D,CAAC,CAAC;CACJ;AAMD,QAAA,MAAM,cAAc,EAAE,aAwBrB,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/cli-plugin.js

@@ -0,0 +1,30 @@
+import { CLOUD_COMMANDS } from "./cli/commands/index.js";
+import { CLOUD_ROOT_OPTIONS } from "./cli/root-options.js";
+import { assertHostSupportsCommandExtensions } from "./dev/cli-host.js";
+import { runCloudDev } from "./dev/dev-command.js";
+// Checked as this file is loaded, rather than left to fail later. See `dev/cli-host.ts` for what
+// this can and cannot conclude.
+assertHostSupportsCommandExtensions();
+const cloudCliPlugin = {
+    id: "@vendure/cloud",
+    commands: CLOUD_COMMANDS,
+    // The four selectors every hosted Cloud command shares. The host puts them on the root `vendure`
+    // program and passes their values down, so they are declared here and nowhere else. Registered
+    // alongside the commands rather than before them: a `--project` on `vendure --help` with no Cloud
+    // command behind it would be worse than no flag at all.
+    rootOptions: CLOUD_ROOT_OPTIONS,
+    extendCommands: [
+        {
+            command: "dev",
+            options: [
+                {
+                    long: "--reset-local-data",
+                    description: "Discard this project's local database before starting, so it is built from your migrations again",
+                },
+            ],
+            decorate: ({ next }) => (...args) => runCloudDev(args, next),
+        },
+    ],
+};
+export default cloudCliPlugin;
+//# sourceMappingURL=cli-plugin.js.map

package/dist/cli-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-plugin.js","sourceRoot":"","sources":["../src/cli-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,mCAAmC,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAsB,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAmCvE,iGAAiG;AACjG,gCAAgC;AAChC,mCAAmC,EAAE,CAAC;AAEtC,MAAM,cAAc,GAAkB;IACpC,EAAE,EAAE,gBAAgB;IACpB,QAAQ,EAAE,cAAc;IACxB,iGAAiG;IACjG,+FAA+F;IAC/F,kGAAkG;IAClG,wDAAwD;IACxD,WAAW,EAAE,kBAAkB;IAC/B,cAAc,EAAE;QACd;YACE,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,oBAAoB;oBAC1B,WAAW,EACT,kGAAkG;iBACrG;aACF;YACD,QAAQ,EACN,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACb,CAAC,GAAG,IAAe,EAAE,EAAE,CACrB,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC;SAC5B;KACF;CACF,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/cloud-config-module.d.ts

@@ -0,0 +1,3 @@
+import { type CloudConfigHandle } from "@vendure/cloud-config";
+export declare function readCloudConfigHandle(loaded: unknown, source: string): CloudConfigHandle;
+//# sourceMappingURL=cloud-config-module.d.ts.map

package/dist/cloud-config-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-config-module.d.ts","sourceRoot":"","sources":["../src/cloud-config-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAuB,MAAM,uBAAuB,CAAC;AAMpF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAYxF"}

package/dist/cloud-config-module.js

@@ -0,0 +1,16 @@
+import { isCloudConfigHandle } from "@vendure/cloud-config";
+// The standalone runner imports compiled JavaScript; `vendure dev` requires the project's
+// TypeScript through the compiler hook its process was started with. They cannot share how the
+// module is loaded, but they agree on what it has to export, and that agreement lives here.
+export function readCloudConfigHandle(loaded, source) {
+    if (typeof loaded !== "object" || loaded === null) {
+        throw new Error(`Vendure Cloud: ${source} did not export a Cloud Config.`);
+    }
+    const exports = loaded;
+    const handle = exports.default ?? exports.config;
+    if (!isCloudConfigHandle(handle)) {
+        throw new Error(`Vendure Cloud: ${source} must export the result of defineCloudConfig() as default or config.`);
+    }
+    return handle;
+}
+//# sourceMappingURL=cloud-config-module.js.map

package/dist/cloud-config-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-config-module.js","sourceRoot":"","sources":["../src/cloud-config-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,0FAA0F;AAC1F,+FAA+F;AAC/F,4FAA4F;AAE5F,MAAM,UAAU,qBAAqB,CAAC,MAAe,EAAE,MAAc;IACnE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,kBAAkB,MAAM,iCAAiC,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,OAAO,GAAG,MAAiC,CAAC;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IACjD,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,sEAAsE,CAC/F,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/dev/cli-host.d.ts

@@ -0,0 +1,3 @@
+export declare function readCommandOptions(args: readonly unknown[]): Record<string, unknown>;
+export declare function assertHostSupportsCommandExtensions(): void;
+//# sourceMappingURL=cli-host.d.ts.map

package/dist/dev/cli-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-host.d.ts","sourceRoot":"","sources":["../../src/dev/cli-host.ts"],"names":[],"mappings":"AAiBA,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWpF;AAWD,wBAAgB,mCAAmC,IAAI,IAAI,CAQ1D"}

package/dist/dev/cli-host.js

@@ -0,0 +1,72 @@
+import { createRequire } from "node:module";
+// Reading what the CLI host passed a command action, and saying so when the host is too old to
+// call this package at all.
+//
+// Neither reads the host by name. `require("@vendure/cli")` answers with whichever copy sits
+// nearest this package, which in a workspace is not always the copy that is running, and acting on
+// the wrong one is worse than not looking. CLO-646 tracks removing the restatement this forces.
+// Where the host puts each value, counting back from the end of the argument list. It appends its
+// context after everything Commander supplies, so these offsets hold whatever positional arguments
+// the command declares — and a command extension cannot add one, because the host refuses it for
+// exactly this reason.
+const CONTEXT_FROM_END = 1;
+const COMMAND_FROM_END = 2;
+const OPTIONS_FROM_END = 3;
+export function readCommandOptions(args) {
+    const options = args[args.length - OPTIONS_FROM_END];
+    // Checked rather than assumed, because everything this extension does to the run is written onto
+    // this object. Reading the wrong one would leave the entry points unset and start the command
+    // against the customer entry points a Cloud application does not have.
+    if (!isPlainObject(options) || !looksLikeCommand(args) || !looksLikeContext(args)) {
+        throw new Error("Vendure Cloud: the `dev` command was called with arguments this version of @vendure/cloud does not recognise. Check that @vendure/cli and @vendure/cloud are compatible versions.");
+    }
+    return options;
+}
+// Best-effort, and it fails the plugin rather than the run. A host that predates command extensions
+// loads this plugin, ignores the one thing it declares, and then runs Core's built-in `dev` — which
+// looks for the entry points a Cloud application deliberately does not have and reports a missing
+// `src/index.ts` as though the application were malformed. Throwing here turns that into a sentence
+// about the version of the CLI, and the host keeps every built-in command working either way.
+//
+// When `@vendure/cli` cannot be resolved from here at all, nothing is claimed. That is a layout
+// where the nearest copy is not the running one, and a check against the wrong copy could refuse a
+// host that was going to work.
+export function assertHostSupportsCommandExtensions() {
+    const host = resolveHost();
+    if (host === undefined)
+        return;
+    if (typeof host.readCommandOptions !== "function") {
+        throw new Error("Vendure Cloud: the installed @vendure/cli does not support CLI plugin command extensions, so `vendure dev` cannot start a Cloud application. Install @vendure/cli 3.8 or newer.");
+    }
+}
+function resolveHost() {
+    // The project first, because that is where the running host was started from, then this package,
+    // which is the customer layout where the two are installed side by side.
+    for (const base of [process.cwd(), import.meta.url]) {
+        try {
+            const loaded = createRequire(base === import.meta.url ? base : `${base}/package.json`)("@vendure/cli");
+            if (isPlainObject(loaded))
+                return loaded;
+        }
+        catch {
+            // Try the next base, and claim nothing if neither resolves.
+        }
+    }
+    return undefined;
+}
+function looksLikeCommand(args) {
+    const command = args[args.length - COMMAND_FROM_END];
+    return (typeof command === "object" &&
+        command !== null &&
+        typeof command.opts === "function");
+}
+function looksLikeContext(args) {
+    const context = args[args.length - CONTEXT_FROM_END];
+    return (typeof context === "object" &&
+        context !== null &&
+        Array.isArray(context.commandPath));
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=cli-host.js.map

package/dist/dev/cli-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-host.js","sourceRoot":"","sources":["../../src/dev/cli-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,+FAA+F;AAC/F,4BAA4B;AAC5B,EAAE;AACF,6FAA6F;AAC7F,mGAAmG;AACnG,gGAAgG;AAEhG,kGAAkG;AAClG,mGAAmG;AACnG,iGAAiG;AACjG,uBAAuB;AACvB,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B,MAAM,UAAU,kBAAkB,CAAC,IAAwB;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC;IACrD,iGAAiG;IACjG,8FAA8F;IAC9F,uEAAuE;IACvE,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,KAAK,CACb,mLAAmL,CACpL,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,oGAAoG;AACpG,oGAAoG;AACpG,kGAAkG;AAClG,oGAAoG;AACpG,8FAA8F;AAC9F,EAAE;AACF,gGAAgG;AAChG,mGAAmG;AACnG,+BAA+B;AAC/B,MAAM,UAAU,mCAAmC;IACjD,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO;IAC/B,IAAI,OAAO,IAAI,CAAC,kBAAkB,KAAK,UAAU,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,iLAAiL,CAClL,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,WAAW;IAClB,iGAAiG;IACjG,yEAAyE;IACzE,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAY,aAAa,CACnC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,eAAe,CACzD,CAAC,cAAc,CAAC,CAAC;YAClB,IAAI,aAAa,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAwB;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC;IACrD,OAAO,CACL,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,OAAQ,OAA8B,CAAC,IAAI,KAAK,UAAU,CAC3D,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAwB;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC;IACrD,OAAO,CACL,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,KAAK,CAAC,OAAO,CAAE,OAAqC,CAAC,WAAW,CAAC,CAClE,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/dev/dev-command.d.ts

@@ -0,0 +1,7 @@
+import type { CloudCommandAction } from "../cli/host-nodes.js";
+export type NextDevAction = CloudCommandAction;
+export declare function runCloudDev(args: unknown[], next: NextDevAction): Promise<void | number>;
+export declare class DevMigrationFailedError extends Error {
+    constructor();
+}
+//# sourceMappingURL=dev-command.d.ts.map

package/dist/dev/dev-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-command.d.ts","sourceRoot":"","sources":["../../src/dev/dev-command.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAyB/D,MAAM,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAE/C,wBAAsB,WAAW,CAC/B,IAAI,EAAE,OAAO,EAAE,EACf,IAAI,EAAE,aAAa,GAElB,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CA8CxB;AAwCD,qBAAa,uBAAwB,SAAQ,KAAK;;CAOjD"}

package/dist/dev/dev-command.js

@@ -0,0 +1,122 @@
+import { spawn } from "node:child_process";
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { LOCAL_CACHE_URL_VAR } from "../local-cache.js";
+import { LOCAL_DATABASE_URL_VAR } from "../local-database.js";
+import { assertLocalRuntimeAllowed } from "../local-runtime-guard.js";
+import { readCommandOptions } from "./cli-host.js";
+import { DEV_CONFIG_PATH_VAR } from "./dev-config.js";
+import { provisionLocalServices } from "./local-services.js";
+import { resolveCloudProjectLayout } from "./project-layout.js";
+// What `@vendure/cloud` adds to the `dev` command.
+//
+// It wraps the composed command rather than replacing it, so Core still supervises the processes
+// and any other plugin that wrapped `dev` still runs. Everything below happens before `next` and is
+// undone after it: the two servers the application needs are started, the migration chain is run to
+// completion, and the two entry points Core would have looked for in the customer's own repository
+// are pointed at this package instead.
+// The targets that run the application. Core's other target, `dashboard`, is a Vite process reading
+// the customer's source and reaches neither the database nor the cache.
+const DEV_TARGETS_NEEDING_SERVICES = new Set(["all", "server", "worker"]);
+export async function runCloudDev(args, next) {
+    // ADR-0043's fail-closed rule, applied before anything is started. A process carrying managed
+    // configuration must not reach local substitutes, and refusing here means it never gets as far as
+    // creating a database for a store that is supposed to be running on the platform's own.
+    assertLocalRuntimeAllowed(process.env);
+    // Left as the map the host handed over, rather than annotated with a shape nothing checked. Only
+    // one value is read out of it, and it is compared against `true` rather than trusted to be a
+    // boolean; the other two are written, which is the point of holding it.
+    const options = readCommandOptions(args);
+    const target = typeof args[0] === "string" ? args[0] : "all";
+    // The Dashboard is a Vite process reading the customer's source. It needs no database and no
+    // cache, so `vendure dev dashboard` starts neither and works on a machine with no container
+    // runtime at all.
+    if (!DEV_TARGETS_NEEDING_SERVICES.has(target)) {
+        return next(...args);
+    }
+    const layout = resolveCloudProjectLayout(process.cwd());
+    process.env[DEV_CONFIG_PATH_VAR] = layout.configPath;
+    // Entry paths relative to the project directory, because that is what Core resolves them against
+    // — both when it checks that they exist and when it starts them. They point into this package
+    // rather than at anything the customer wrote, which is what makes an application with no entry
+    // point runnable.
+    const entryDir = dirname(fileURLToPath(import.meta.url));
+    options.serverEntry = relative(layout.projectDir, join(entryDir, "dev-server.js"));
+    options.workerEntry = relative(layout.projectDir, join(entryDir, "dev-worker.js"));
+    const services = await provisionLocalServices({
+        projectDir: layout.projectDir,
+        resetData: options.resetLocalData === true,
+        announce: (message) => process.stdout.write(`${message}\n`),
+    });
+    applyConnections(services);
+    try {
+        await runMigrations(layout.projectDir, join(entryDir, "dev-migrate.js"));
+        return await next(...args);
+    }
+    finally {
+        // Reached on an ordinary shutdown, on a signal, and on a failure in any supervised process.
+        // Core's supervisor stops its children and returns before this runs, so by here the only things
+        // still up are the two servers this command started.
+        await services.stop();
+    }
+}
+// Written onto this process's environment under the names `@vendure/cloud` already publishes for a
+// supplied connection, so the supervised processes resolve them the same way a process started any
+// other way resolves the ones a developer supplied.
+function applyConnections(services) {
+    process.env[LOCAL_DATABASE_URL_VAR] = databaseUrl(services.database);
+    process.env[LOCAL_CACHE_URL_VAR] = cacheUrl(services.cache);
+}
+function databaseUrl(connection) {
+    const credentials = `${encodeURIComponent(connection.username)}:${encodeURIComponent(connection.password)}`;
+    return `postgres://${credentials}@${connection.host}:${connection.port}/${encodeURIComponent(connection.database)}`;
+}
+function cacheUrl(connection) {
+    return `valkey://${connection.host}:${connection.port}`;
+}
+// The migration chain, run to completion before the supervisor starts anything. This is the order a
+// deploy uses, and locally it is also what makes the first run work at all: the database starts
+// empty, and a worker that reached it before the schema existed would take the whole run down.
+async function runMigrations(projectDir, migrateEntry) {
+    const exitCode = await new Promise((resolveExit, rejectExit) => {
+        const child = spawn(process.execPath, [resolveTsNodeBin(projectDir), migrateEntry], {
+            cwd: projectDir,
+            env: process.env,
+            stdio: "inherit",
+        });
+        child.once("error", rejectExit);
+        child.once("close", (code) => resolveExit(code ?? 1));
+    });
+    if (exitCode !== 0) {
+        // The migration process has already written why. Adding a second explanation here would put a
+        // sentence about the command in front of the one about the application.
+        throw new DevMigrationFailedError();
+    }
+}
+export class DevMigrationFailedError extends Error {
+    constructor() {
+        super("Vendure Cloud: the database migrations did not complete, so the application was not started. The error above is from the migration that stopped.");
+        this.name = "DevMigrationFailedError";
+    }
+}
+// Resolved from the project rather than from this package, so the migration runs under the same
+// compiler the supervisor starts the server and the worker with.
+function resolveTsNodeBin(projectDir) {
+    const require = createRequire(join(projectDir, "package.json"));
+    let packageJsonPath;
+    try {
+        packageJsonPath = require.resolve("ts-node/package.json");
+    }
+    catch (cause) {
+        throw new Error("Vendure Cloud: running a Vendure Cloud application locally requires ts-node. Install it as a development dependency.", { cause });
+    }
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    const bin = typeof packageJson.bin === "string" ? packageJson.bin : packageJson.bin?.["ts-node"];
+    if (bin === undefined) {
+        throw new Error("Vendure Cloud: the installed ts-node does not provide a ts-node binary. Reinstall it as a development dependency.");
+    }
+    return resolve(dirname(packageJsonPath), bin);
+}
+//# sourceMappingURL=dev-command.js.map

package/dist/dev/dev-command.js.map

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

package/dist/dev/dev-config.d.ts

@@ -0,0 +1,4 @@
+import type { CloudConfigHandle } from "@vendure/cloud-config";
+export declare const DEV_CONFIG_PATH_VAR = "VENDURE_CLOUD_DEV_CONFIG";
+export declare function loadDevCloudConfig(): CloudConfigHandle;
+//# sourceMappingURL=dev-config.d.ts.map

package/dist/dev/dev-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-config.d.ts","sourceRoot":"","sources":["../../src/dev/dev-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAY/D,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAE9D,wBAAgB,kBAAkB,IAAI,iBAAiB,CAkBtD"}

package/dist/dev/dev-config.js

@@ -0,0 +1,28 @@
+import { createRequire } from "node:module";
+import { readCloudConfigHandle } from "../cloud-config-module.js";
+// How the three processes `vendure dev` starts find the application they are running.
+//
+// The path is passed in rather than resolved again here. The command has already decided which file
+// is the Cloud Config, and a process that worked it out for itself could reach a different answer
+// in a repository holding more than one — so the command's answer is the only one.
+// Set by the `dev` command on the environment the supervisor passes to its children. The database
+// and cache connections travel the same way, under the names `@vendure/cloud` already publishes for
+// them, so nothing here has to know how they were provisioned.
+export const DEV_CONFIG_PATH_VAR = "VENDURE_CLOUD_DEV_CONFIG";
+export function loadDevCloudConfig() {
+    const configPath = process.env[DEV_CONFIG_PATH_VAR];
+    if (configPath === undefined || configPath === "") {
+        throw new Error([
+            "Vendure Cloud: this entry point is started by `vendure dev` and was run some other way.",
+            "  It expects the Cloud Config to have been chosen for it, and nothing chose one.",
+            "  Run `vendure dev` from your project instead.",
+            "",
+        ].join("\n"));
+    }
+    // `require` rather than `import`, because this is how the file gets compiled. The supervisor
+    // starts these processes through the project's TypeScript compiler hook, which registers itself
+    // against the CommonJS loader — so a dynamic `import()` of the same path would bypass it and ask
+    // Node to run TypeScript it cannot read.
+    return readCloudConfigHandle(createRequire(import.meta.url)(configPath), configPath);
+}
+//# sourceMappingURL=dev-config.js.map

package/dist/dev/dev-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-config.js","sourceRoot":"","sources":["../../src/dev/dev-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,sFAAsF;AACtF,EAAE;AACF,oGAAoG;AACpG,kGAAkG;AAClG,mFAAmF;AAEnF,kGAAkG;AAClG,oGAAoG;AACpG,+DAA+D;AAC/D,MAAM,CAAC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AAE9D,MAAM,UAAU,kBAAkB;IAChC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACpD,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb;YACE,yFAAyF;YACzF,kFAAkF;YAClF,gDAAgD;YAChD,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;IAED,6FAA6F;IAC7F,gGAAgG;IAChG,iGAAiG;IACjG,yCAAyC;IACzC,OAAO,qBAAqB,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,CAAC;AACvF,CAAC"}

package/dist/dev/dev-migrate.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dev-migrate.d.ts.map

package/dist/dev/dev-migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-migrate.d.ts","sourceRoot":"","sources":["../../src/dev/dev-migrate.ts"],"names":[],"mappings":""}

package/dist/dev/dev-migrate.js

@@ -0,0 +1,17 @@
+import { runLocalMigrations } from "../local-runtime.js";
+import { loadDevCloudConfig } from "./dev-config.js";
+import { reportDevProcessFailure } from "./dev-process.js";
+// The migration step `vendure dev` runs to completion before it starts the server and the worker.
+//
+// It is a process of its own for the same reason a deploy runs `migrate` as its own run mode: the
+// schema has to be finished before anything serves against it. Running it inside the server instead
+// would leave the worker racing a schema that is still being built, and on a first run that race is
+// lost every time because the database starts empty.
+async function main() {
+    // Silent, because this process exists only to prepare the database. The server and the worker
+    // each name their own substitutes as they start, which is where a developer reads what is
+    // running; a third copy of that list from a process that has already exited is noise.
+    await runLocalMigrations(loadDevCloudConfig(), { announce: () => undefined });
+}
+main().catch(reportDevProcessFailure);
+//# sourceMappingURL=dev-migrate.js.map

package/dist/dev/dev-migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-migrate.js","sourceRoot":"","sources":["../../src/dev/dev-migrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,kGAAkG;AAClG,EAAE;AACF,kGAAkG;AAClG,oGAAoG;AACpG,oGAAoG;AACpG,qDAAqD;AAErD,KAAK,UAAU,IAAI;IACjB,8FAA8F;IAC9F,0FAA0F;IAC1F,sFAAsF;IACtF,MAAM,kBAAkB,CAAC,kBAAkB,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC"}

package/dist/dev/dev-process.d.ts

@@ -0,0 +1,2 @@
+export declare function reportDevProcessFailure(error: unknown): void;
+//# sourceMappingURL=dev-process.d.ts.map

package/dist/dev/dev-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-process.d.ts","sourceRoot":"","sources":["../../src/dev/dev-process.ts"],"names":[],"mappings":"AASA,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAG5D"}

package/dist/dev/dev-process.js

@@ -0,0 +1,14 @@
+// What the three supervised entry points do with a failure.
+//
+// The message alone, and a non-zero exit code. Every error these processes raise is one this
+// package wrote and addressed to a developer — a cache that refused a connection, an application
+// with no migrations, managed configuration in a process that must not use substitutes — and a
+// stack trace through the composer adds nothing a reader of those messages needs.
+//
+// The exit code is what the supervisor reads. Core stops the sibling processes when one of them
+// exits non-zero, so this is also what takes the rest of the run down.
+export function reportDevProcessFailure(error) {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=dev-process.js.map

package/dist/dev/dev-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-process.js","sourceRoot":"","sources":["../../src/dev/dev-process.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,6FAA6F;AAC7F,iGAAiG;AACjG,+FAA+F;AAC/F,kFAAkF;AAClF,EAAE;AACF,gGAAgG;AAChG,uEAAuE;AACvE,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/dev/dev-server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dev-server.d.ts.map

package/dist/dev/dev-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../../src/dev/dev-server.ts"],"names":[],"mappings":""}

package/dist/dev/dev-server.js

@@ -0,0 +1,15 @@
+import { bootstrapLocalServer } from "../local-runtime.js";
+import { loadDevCloudConfig } from "./dev-config.js";
+import { reportDevProcessFailure } from "./dev-process.js";
+// The server process `vendure dev` supervises, in place of the `src/index.ts` a self-hosted Vendure
+// project writes. ADR-0043 takes the entry point out of the application, so there is no customer
+// file for the supervisor to start and this stands in its place.
+//
+// It does not run migrations. `vendure dev` runs the migration chain to completion before it starts
+// anything, which is the order a deploy uses, and is what keeps the worker from reaching a database
+// whose schema the server has not finished building.
+async function main() {
+    await bootstrapLocalServer(loadDevCloudConfig());
+}
+main().catch(reportDevProcessFailure);
+//# sourceMappingURL=dev-server.js.map

package/dist/dev/dev-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-server.js","sourceRoot":"","sources":["../../src/dev/dev-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,oGAAoG;AACpG,iGAAiG;AACjG,iEAAiE;AACjE,EAAE;AACF,oGAAoG;AACpG,oGAAoG;AACpG,qDAAqD;AAErD,KAAK,UAAU,IAAI;IACjB,MAAM,oBAAoB,CAAC,kBAAkB,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC"}

package/dist/dev/dev-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dev-worker.d.ts.map