@vendure/cloud 0.2.0 → 0.3.0

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

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

package/dist/dev/dev-worker.js

@@ -0,0 +1,11 @@
+import { bootstrapLocalWorker } from "../local-runtime.js";
+import { loadDevCloudConfig } from "./dev-config.js";
+import { reportDevProcessFailure } from "./dev-process.js";
+// The worker process `vendure dev` supervises, in place of the `src/index-worker.ts` a self-hosted
+// Vendure project writes. See `dev-server.ts` for why there is no customer file to start.
+async function main() {
+    const worker = await bootstrapLocalWorker(loadDevCloudConfig());
+    await worker.startJobQueue();
+}
+main().catch(reportDevProcessFailure);
+//# sourceMappingURL=dev-worker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev-worker.js","sourceRoot":"","sources":["../../src/dev/dev-worker.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,mGAAmG;AACnG,0FAA0F;AAE1F,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAChE,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;AAC/B,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC"}

package/dist/dev/local-services.d.ts

@@ -0,0 +1,23 @@
+import { type LocalCacheConnection } from "../local-cache.js";
+import { type LocalDatabaseConnection } from "../local-database.js";
+export interface LocalServices {
+    database: LocalDatabaseConnection;
+    cache: LocalCacheConnection;
+    stop(): Promise<void>;
+}
+export interface ProvisionLocalServicesOptions {
+    projectDir: string;
+    resetData?: boolean;
+    announce?: (message: string) => void;
+}
+export declare class LocalDevServicesUnavailableError extends Error {
+    constructor(detail: string, options?: ErrorOptions);
+}
+export declare function projectScope(projectDir: string): string;
+export declare function serviceNames(projectDir: string): {
+    database: string;
+    cache: string;
+    databaseVolume: string;
+};
+export declare function provisionLocalServices(options: ProvisionLocalServicesOptions): Promise<LocalServices>;
+//# sourceMappingURL=local-services.d.ts.map

package/dist/dev/local-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-services.d.ts","sourceRoot":"","sources":["../../src/dev/local-services.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,sBAAsB,CAAC;AA+B9B,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,uBAAuB,CAAC;IAClC,KAAK,EAAE,oBAAoB,CAAC;IAE5B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,MAAM,CAAC;IAGnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,qBAAa,gCAAiC,SAAQ,KAAK;gBAC7C,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAInD;AAKD,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM;;;;EAQ9C;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,aAAa,CAAC,CAmDxB"}

package/dist/dev/local-services.js

@@ -0,0 +1,288 @@
+import { execFile } from "node:child_process";
+import { createHash } from "node:crypto";
+import { promisify } from "node:util";
+import { assertLocalCacheDriverAvailable, assertLocalCacheReachable, } from "../local-cache.js";
+import { assertLocalDatabaseDriverAvailable, } from "../local-database.js";
+// The PostgreSQL and Valkey a `vendure dev` run needs, provisioned and taken away again by the
+// command rather than by the developer.
+//
+// None of the mechanics below reach a developer's terminal. There is no compose file to run, no
+// service to create first, no port to choose and no connection variable to set, and when something
+// here fails what they read is one sentence about the database or the cache — every message in this
+// file goes through `LocalDevServicesUnavailableError`.
+const execFileAsync = promisify(execFile);
+// The same images the repository's own compose stack runs, so there is one answer in the tree to
+// which PostgreSQL and which Valkey local development uses. The PostgreSQL major matches the
+// managed target (ADR-0020), which is the property that makes a migration generated here apply
+// there.
+const POSTGRES_IMAGE = "postgres:17-alpine";
+const CACHE_IMAGE = "valkey/valkey:8-alpine";
+// Fixed rather than generated, and never printed. The database is published on loopback only, so
+// these authenticate a connection that cannot be made from off this machine. They are also written
+// into the volume the first time the database is created, so a per-run value would either have to
+// be stored beside the data or discard the data it no longer matches — and the data outliving the
+// run is the whole point of the volume.
+const POSTGRES_USER = "vendure";
+const POSTGRES_PASSWORD = "vendure";
+const POSTGRES_DATABASE = "vendure";
+const READINESS_TIMEOUT_MS = 120_000;
+const READINESS_POLL_MS = 250;
+export class LocalDevServicesUnavailableError extends Error {
+    constructor(detail, options) {
+        super(`Vendure Cloud: ${detail}`, options);
+        this.name = "LocalDevServicesUnavailableError";
+    }
+}
+// A name per project rather than per run, which is what makes the database the same one on the next
+// `vendure dev`. The directory path is hashed rather than used: it can be any length, hold
+// characters a container name cannot, and reveal where someone's code lives in `docker ps` output.
+export function projectScope(projectDir) {
+    return createHash("sha256").update(projectDir).digest("hex").slice(0, 12);
+}
+export function serviceNames(projectDir) {
+    const scope = projectScope(projectDir);
+    return {
+        database: `vendure-cloud-dev-${scope}-postgres`,
+        // Not named after a volume anywhere, because it never gets one.
+        cache: `vendure-cloud-dev-${scope}-cache`,
+        databaseVolume: `vendure-cloud-dev-${scope}-pgdata`,
+    };
+}
+export async function provisionLocalServices(options) {
+    // Reported before anything is started. Both are optional peer dependencies, and a tree without
+    // them produces our message here rather than a driver's resolution error part way through
+    // starting servers that would then have to be taken down again.
+    assertLocalDatabaseDriverAvailable();
+    assertLocalCacheDriverAvailable();
+    const cli = await resolveContainerCli();
+    const names = serviceNames(options.projectDir);
+    const announce = options.announce ?? (() => undefined);
+    if (options.resetData) {
+        await removeContainer(cli, names.database);
+        await removeVolume(cli, names.databaseVolume);
+    }
+    // Everything below this point can leave a server running behind a command that then failed, so
+    // each step puts back what it started. Both handlers stop the database rather than remove it: a
+    // run that gave up is not a reason to discard the project's data, and a stopped container is
+    // where the next run expects to find it.
+    let database;
+    try {
+        database = await startDatabase(cli, names, announce);
+    }
+    catch (error) {
+        await stopContainer(cli, names.database);
+        throw error;
+    }
+    let cache;
+    try {
+        cache = await startCache(cli, names);
+    }
+    catch (error) {
+        // The cache is the disposable one, so it is removed rather than stopped, and only this
+        // project's own cache is named.
+        await removeContainer(cli, names.cache);
+        await stopContainer(cli, names.database);
+        throw error;
+    }
+    return {
+        database,
+        cache,
+        stop: async () => {
+            // The database is stopped rather than removed, so its volume and everything in it survives
+            // until someone asks for it to be discarded. The cache is removed, because a cache that
+            // outlived the run would hand the next one entries from an application that has since
+            // changed.
+            await stopContainer(cli, names.database);
+            await removeContainer(cli, names.cache);
+        },
+    };
+}
+async function startDatabase(cli, names, announce) {
+    const existing = await containerState(cli, names.database);
+    if (existing === "missing") {
+        // Said only when there is something to wait for. Creating the database the first time has to
+        // fetch it and build it, which takes far longer than starting one that already exists, and a
+        // developer watching a silent terminal has no way to tell that apart from a command that has
+        // hung. Every later run reaches this function and prints nothing.
+        announce("Vendure Cloud: preparing this project's local database and cache for the first time. This can take a minute.");
+        await cli.run([
+            "run",
+            "--detach",
+            "--name",
+            names.database,
+            "--volume",
+            `${names.databaseVolume}:/var/lib/postgresql/data`,
+            // The host port is chosen by the operating system rather than by anyone, and read back
+            // below. Bound to loopback, so nothing off this machine can reach the database.
+            "--publish",
+            "127.0.0.1::5432",
+            "--env",
+            `POSTGRES_USER=${POSTGRES_USER}`,
+            "--env",
+            `POSTGRES_PASSWORD=${POSTGRES_PASSWORD}`,
+            "--env",
+            `POSTGRES_DB=${POSTGRES_DATABASE}`,
+            POSTGRES_IMAGE,
+        ]);
+    }
+    else if (existing === "stopped") {
+        await cli.run(["start", names.database]);
+    }
+    const connection = {
+        host: "127.0.0.1",
+        port: await publishedPort(cli, names.database, 5432, "database"),
+        database: POSTGRES_DATABASE,
+        username: POSTGRES_USER,
+        password: POSTGRES_PASSWORD,
+    };
+    await waitForDatabase(connection);
+    return connection;
+}
+async function startCache(cli, names) {
+    // Removed before it is created rather than reused. The cache holds nothing worth keeping, and
+    // starting from empty is what stops a run reading what an earlier one cached.
+    await removeContainer(cli, names.cache);
+    await cli.run([
+        "run",
+        "--detach",
+        "--name",
+        names.cache,
+        "--publish",
+        "127.0.0.1::6379",
+        CACHE_IMAGE,
+    ]);
+    const connection = {
+        host: "127.0.0.1",
+        port: await publishedPort(cli, names.cache, 6379, "cache"),
+        // No logical database index. One cache server per project already separates projects, so there
+        // is nothing for an index to separate and nothing for a developer to choose.
+    };
+    await waitForCache(connection);
+    return connection;
+}
+// Polled with the driver the application will use, against the database it will open, rather than
+// with a probe inside the container. What has to be true before a process starts is that this
+// connection works from here, and a check that runs anywhere else can pass while that is false.
+async function waitForDatabase(connection) {
+    const { Client } = await import("pg");
+    const deadline = Date.now() + READINESS_TIMEOUT_MS;
+    let lastError;
+    while (Date.now() < deadline) {
+        const client = new Client({
+            host: connection.host,
+            port: connection.port,
+            database: connection.database,
+            user: connection.username,
+            password: connection.password,
+            connectionTimeoutMillis: 5_000,
+        });
+        try {
+            await client.connect();
+            await client.query("SELECT 1");
+            await client.end();
+            return;
+        }
+        catch (error) {
+            lastError = error;
+            await client.end().catch(() => undefined);
+            await delay(READINESS_POLL_MS);
+        }
+    }
+    throw new LocalDevServicesUnavailableError([
+        "the local database did not become ready.",
+        `  It was given ${Math.round(READINESS_TIMEOUT_MS / 1000)} seconds to accept a connection and did not.`,
+        "  Run `vendure dev` again. If it keeps happening, `vendure dev --reset-local-data` starts the database from empty.",
+        "",
+    ].join("\n"), { cause: lastError });
+}
+// The cache is gated on the same check the runtime makes, so a refusal the runtime would report at
+// bootstrap is reported here instead, before any process starts. That includes a logical database
+// index the server refuses, which leaves a usable connection on database zero rather than failing.
+async function waitForCache(connection) {
+    const deadline = Date.now() + READINESS_TIMEOUT_MS;
+    let lastError;
+    while (Date.now() < deadline) {
+        try {
+            await assertLocalCacheReachable(connection);
+            return;
+        }
+        catch (error) {
+            lastError = error;
+            await delay(READINESS_POLL_MS);
+        }
+    }
+    throw new LocalDevServicesUnavailableError([
+        "the local cache did not become ready.",
+        `  It was given ${Math.round(READINESS_TIMEOUT_MS / 1000)} seconds to accept a connection and did not.`,
+        "  Run `vendure dev` again.",
+        "",
+    ].join("\n"), { cause: lastError });
+}
+// The runtimes this looks for, in the order it tries them. `docker` covers Docker itself and the
+// docker-compatible CLI that OrbStack, Colima and Rancher Desktop install. `podman` is named
+// separately because it is the one in common use that does not install that CLI, and it answers
+// every subcommand below under the same spellings.
+const CONTAINER_RUNTIMES = ["docker", "podman"];
+// Resolved once per run and then passed to everything that needs it, rather than each call reaching
+// for a binary name of its own — so a run cannot start a database under one runtime and look for it
+// under another.
+//
+// `ps` is the probe rather than `version`, because it has to establish that the runtime is running
+// and reachable rather than merely installed, and it means that on a runtime with a daemon and on
+// one without alike.
+async function resolveContainerCli() {
+    let lastFailure;
+    for (const binary of CONTAINER_RUNTIMES) {
+        try {
+            await execFileAsync(binary, ["ps", "--quiet"]);
+            return { run: (args) => execFileAsync(binary, args, { encoding: "utf-8" }) };
+        }
+        catch (cause) {
+            lastFailure = cause;
+        }
+    }
+    throw new LocalDevServicesUnavailableError([
+        "the local database and cache could not be started.",
+        "  `vendure dev` runs a database and a cache for you, and starting them needs a container runtime that is installed and running on this machine.",
+        `  It looked for: ${CONTAINER_RUNTIMES.join(", ")}. Start one of those, or install one, and run \`vendure dev\` again.`,
+        "",
+    ].join("\n"), { cause: lastFailure });
+}
+async function containerState(cli, name) {
+    try {
+        const { stdout } = await cli.run(["inspect", "--format", "{{.State.Running}}", name]);
+        return stdout.trim() === "true" ? "running" : "stopped";
+    }
+    catch {
+        return "missing";
+    }
+}
+// The host port the operating system gave the container, read back rather than remembered, because
+// a container that was created by an earlier run has a port this run never chose.
+async function publishedPort(cli, name, containerPort, label) {
+    const { stdout } = await cli.run(["port", name, `${containerPort}/tcp`]);
+    // `docker port` prints one line per binding, each `address:port`. Only loopback is published, so
+    // the last colon separates the port from an address that may itself contain colons.
+    const line = stdout.trim().split("\n")[0] ?? "";
+    const port = Number(line.slice(line.lastIndexOf(":") + 1));
+    if (!Number.isInteger(port) || port <= 0) {
+        throw new LocalDevServicesUnavailableError(`the local ${label} started but no address could be found for it. Run \`vendure dev\` again.`);
+    }
+    return port;
+}
+async function stopContainer(cli, name) {
+    await cli.run(["stop", name]).catch(() => undefined);
+}
+// `--volumes` discards the anonymous volumes this container was given, which is what keeps a cache
+// from leaving one behind on every run. It does not reach a named volume, so the database's data
+// survives this call and is only ever discarded by `removeVolume` naming it directly.
+async function removeContainer(cli, name) {
+    await cli.run(["rm", "--force", "--volumes", name]).catch(() => undefined);
+}
+async function removeVolume(cli, name) {
+    await cli.run(["volume", "rm", "--force", name]).catch(() => undefined);
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=local-services.js.map

package/dist/dev/local-services.js.map

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

package/dist/dev/project-layout.d.ts

@@ -0,0 +1,11 @@
+export interface CloudProjectLayout {
+    projectDir: string;
+    configPath: string;
+}
+export declare class CloudConfigNotFoundError extends Error {
+    constructor(projectDir: string);
+}
+export declare function resolveCloudProjectLayout(cwd: string): CloudProjectLayout;
+export declare function resolveVendureProjectDir(cwd: string): string;
+export declare function resolveCloudConfigPath(projectDir: string): string;
+//# sourceMappingURL=project-layout.d.ts.map

package/dist/dev/project-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-layout.d.ts","sourceRoot":"","sources":["../../src/dev/project-layout.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,kBAAkB;IAEjC,UAAU,EAAE,MAAM,CAAC;IAInB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,UAAU,EAAE,MAAM;CAW/B;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAGzE;AAMD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAMjE"}

package/dist/dev/project-layout.js

@@ -0,0 +1,89 @@
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+// Where the Vendure project is, and where its Cloud Config is inside it.
+//
+// Both answers have to match what Core's `dev` command would have decided, because the command is
+// extended rather than replaced: Core resolves the project directory again for itself, spawns the
+// child processes with it as their working directory, and checks that the entry paths this package
+// hands it exist relative to it. A directory resolved differently here would produce an entry path
+// that Core reports as missing. `test/dev-project-layout.test.ts` pins the cases.
+// The directories a monorepo keeps its packages in, in the order Core searches them
+// (`packages/cli/src/utilities/monorepo-utils.ts`, read against the `minor` branch at 214d3916a).
+const MONOREPO_PACKAGE_DIRS = ["packages", "apps", "libs", "services", "modules"];
+// The Cloud Config file names, in the order Core's own project check looks for them
+// (`packages/cli/src/shared/project-validation.ts`). A Cloud Config is TypeScript in the ordinary
+// case, and the compiled spellings are kept because the list is Core's rather than ours.
+const CONFIG_CANDIDATES = [
+    "src/vendure-config.ts",
+    "vendure-config.ts",
+    "src/vendure-config.js",
+    "vendure-config.js",
+];
+export class CloudConfigNotFoundError extends Error {
+    constructor(projectDir) {
+        super([
+            `Vendure Cloud: no Cloud Config was found in ${projectDir}.`,
+            "  A Vendure Cloud application is one configuration file that exports the result of defineCloudConfig(), and no entry point.",
+            `  Expected one of: ${CONFIG_CANDIDATES.join(", ")}.`,
+            "",
+        ].join("\n"));
+        this.name = "CloudConfigNotFoundError";
+    }
+}
+export function resolveCloudProjectLayout(cwd) {
+    const projectDir = resolveVendureProjectDir(cwd);
+    return { projectDir, configPath: resolveCloudConfigPath(projectDir) };
+}
+// Core's rule, mirrored: the working directory when it declares `@vendure/core` itself, otherwise
+// the first package under a monorepo directory that does. The search runs downward from the
+// working directory rather than upward, so running the command from a monorepo root finds the
+// application inside it.
+export function resolveVendureProjectDir(cwd) {
+    const here = resolve(cwd);
+    if (declaresVendureCore(join(here, "package.json")))
+        return here;
+    const packageJsonPath = findPackageJsonWithVendureCore(here);
+    return packageJsonPath ? dirname(packageJsonPath) : here;
+}
+export function resolveCloudConfigPath(projectDir) {
+    for (const candidate of CONFIG_CANDIDATES) {
+        const candidatePath = join(projectDir, candidate);
+        if (existsSync(candidatePath))
+            return candidatePath;
+    }
+    throw new CloudConfigNotFoundError(projectDir);
+}
+function findPackageJsonWithVendureCore(rootDir) {
+    const rootPackageJson = join(rootDir, "package.json");
+    if (declaresVendureCore(rootPackageJson))
+        return rootPackageJson;
+    for (const dir of MONOREPO_PACKAGE_DIRS) {
+        const monorepoDir = join(rootDir, dir);
+        if (!existsSync(monorepoDir))
+            continue;
+        for (const subDir of readdirSync(monorepoDir)) {
+            const packageJsonPath = join(monorepoDir, subDir, "package.json");
+            if (declaresVendureCore(packageJsonPath))
+                return packageJsonPath;
+        }
+    }
+    return null;
+}
+// Both sections, because ADR-0046 makes `@vendure/core` a development dependency of a Cloud
+// application while a self-hosted one keeps it a runtime dependency, and Core accepts either.
+function declaresVendureCore(packageJsonPath) {
+    if (!existsSync(packageJsonPath))
+        return false;
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    }
+    catch {
+        return false;
+    }
+    if (typeof parsed !== "object" || parsed === null)
+        return false;
+    const packageJson = parsed;
+    return Boolean(packageJson.dependencies?.["@vendure/core"] ?? packageJson.devDependencies?.["@vendure/core"]);
+}
+//# sourceMappingURL=project-layout.js.map

package/dist/dev/project-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-layout.js","sourceRoot":"","sources":["../../src/dev/project-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEnD,yEAAyE;AACzE,EAAE;AACF,kGAAkG;AAClG,kGAAkG;AAClG,mGAAmG;AACnG,mGAAmG;AACnG,kFAAkF;AAElF,oFAAoF;AACpF,kGAAkG;AAClG,MAAM,qBAAqB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAU,CAAC;AAE3F,oFAAoF;AACpF,kGAAkG;AAClG,yFAAyF;AACzF,MAAM,iBAAiB,GAAG;IACxB,uBAAuB;IACvB,mBAAmB;IACnB,uBAAuB;IACvB,mBAAmB;CACpB,CAAC;AAWF,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,UAAkB;QAC5B,KAAK,CACH;YACE,+CAA+C,UAAU,GAAG;YAC5D,6HAA6H;YAC7H,sBAAsB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACrD,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACnD,MAAM,UAAU,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IACjD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,sBAAsB,CAAC,UAAU,CAAC,EAAE,CAAC;AACxE,CAAC;AAED,kGAAkG;AAClG,4FAA4F;AAC5F,8FAA8F;AAC9F,yBAAyB;AACzB,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjE,MAAM,eAAe,GAAG,8BAA8B,CAAC,IAAI,CAAC,CAAC;IAC7D,OAAO,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAkB;IACvD,KAAK,MAAM,SAAS,IAAI,iBAAiB,EAAE,CAAC;QAC1C,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAClD,IAAI,UAAU,CAAC,aAAa,CAAC;YAAE,OAAO,aAAa,CAAC;IACtD,CAAC;IACD,MAAM,IAAI,wBAAwB,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,8BAA8B,CAAC,OAAe;IACrD,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACtD,IAAI,mBAAmB,CAAC,eAAe,CAAC;QAAE,OAAO,eAAe,CAAC;IAEjE,KAAK,MAAM,GAAG,IAAI,qBAAqB,EAAE,CAAC;QACxC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,SAAS;QACvC,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;YAC9C,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;YAClE,IAAI,mBAAmB,CAAC,eAAe,CAAC;gBAAE,OAAO,eAAe,CAAC;QACnE,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4FAA4F;AAC5F,8FAA8F;AAC9F,SAAS,mBAAmB,CAAC,eAAuB;IAClD,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAChE,MAAM,WAAW,GAAG,MAGnB,CAAC;IACF,OAAO,OAAO,CACZ,WAAW,CAAC,YAAY,EAAE,CAAC,eAAe,CAAC,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC,eAAe,CAAC,CAC9F,CAAC;AACJ,CAAC"}

package/dist/entrypoint.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
-import { isCloudConfigHandle } from "@vendure/cloud-config";
-import { bootstrapLocalServer, bootstrapLocalWorker, runLocalMigrations } from "./local-runtime.js";
+import { readCloudConfigHandle } from "./cloud-config-module.js";
 import { assertLocalRuntimeAllowed } from "./local-runtime-guard.js";
+import { bootstrapLocalServer, bootstrapLocalWorker, runLocalMigrations } from "./local-runtime.js";
 const RUN_MODES = ["server", "worker", "migrate"];
 async function main() {
     assertLocalRuntimeAllowed(process.env);
@@ -22,16 +22,7 @@ async function main() {
     await runLocalMigrations(handle);
 }
 async function loadCloudConfig(configPath) {
-    const loaded = await import(pathToFileURL(configPath).href);
-    if (typeof loaded !== "object" || loaded === null) {
-        throw new Error(`Vendure Cloud: ${configPath} did not export a Cloud Config.`);
-    }
-    const exports = loaded;
-    const handle = exports.default ?? exports.config;
-    if (!isCloudConfigHandle(handle)) {
-        throw new Error(`Vendure Cloud: ${configPath} must export the result of defineCloudConfig() as default or config.`);
-    }
-    return handle;
+    return readCloudConfigHandle(await import(pathToFileURL(configPath).href), configPath);
 }
 function parseRunMode(value) {
     const mode = value ?? "server";

package/dist/entrypoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"entrypoint.js","sourceRoot":"","sources":["../src/entrypoint.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAA0B,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAG3D,KAAK,UAAU,IAAI;IACjB,yBAAyB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEvC,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,wBAAwB,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IAEjD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,UAAkB;IAC/C,MAAM,MAAM,GAAY,MAAM,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC;IACrE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,kBAAkB,UAAU,iCAAiC,CAAC,CAAC;IACjF,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,UAAU,sEAAsE,CACnG,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,KAAyB;IAC7C,MAAM,IAAI,GAAG,KAAK,IAAI,QAAQ,CAAC;IAC/B,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAe,CAAC;QAAE,OAAO,IAAe,CAAC;IAChE,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,uCAAuC,CAC/F,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,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,CAAC,CAAC"}
+{"version":3,"file":"entrypoint.js","sourceRoot":"","sources":["../src/entrypoint.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEpG,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAG3D,KAAK,UAAU,IAAI;IACjB,yBAAyB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEvC,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,wBAAwB,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC;IAEjD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,UAAkB;IAC/C,OAAO,qBAAqB,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,YAAY,CAAC,KAAyB;IAC7C,MAAM,IAAI,GAAG,KAAK,IAAI,QAAQ,CAAC;IAC/B,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAe,CAAC;QAAE,OAAO,IAAe,CAAC;IAChE,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,uCAAuC,CAC/F,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,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,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export * from "@vendure/cloud-config";
-export { bootstrapLocalServer, bootstrapLocalWorker, composeLocalConfig, runLocalMigrations, type LocalRuntimeOptions, } from "./local-runtime.js";
+export { bootstrapLocalServer, bootstrapLocalWorker, composeLocalConfig, LocalMigrationFailedError, NoDeclaredMigrationsError, runLocalMigrations, type LocalRuntimeOptions, } from "./local-runtime.js";
+export { LOCAL_CACHE_URL_VAR, LocalCacheUnavailableError, type LocalCacheConnection, } from "./local-cache.js";
+export { LOCAL_DATABASE_URL_VAR, LocalDatabaseUnavailableError, type LocalDatabaseConnection, } from "./local-database.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,kBAAkB,EAClB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -6,5 +6,7 @@
 // reaches a customer without a second edit here that nothing would catch if it were
 // forgotten.
 export * from "@vendure/cloud-config";
-export { bootstrapLocalServer, bootstrapLocalWorker, composeLocalConfig, runLocalMigrations, } from "./local-runtime.js";
+export { bootstrapLocalServer, bootstrapLocalWorker, composeLocalConfig, LocalMigrationFailedError, NoDeclaredMigrationsError, runLocalMigrations, } from "./local-runtime.js";
+export { LOCAL_CACHE_URL_VAR, LocalCacheUnavailableError, } from "./local-cache.js";
+export { LOCAL_DATABASE_URL_VAR, LocalDatabaseUnavailableError, } from "./local-database.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,4FAA4F;AAC5F,oFAAoF;AACpF,EAAE;AACF,yFAAyF;AACzF,oFAAoF;AACpF,aAAa;AACb,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,4FAA4F;AAC5F,oFAAoF;AACpF,EAAE;AACF,yFAAyF;AACzF,oFAAoF;AACpF,aAAa;AACb,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,yBAAyB,EACzB,yBAAyB,EACzB,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,GAE3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,sBAAsB,EACtB,6BAA6B,GAE9B,MAAM,qBAAqB,CAAC"}

package/dist/local-asset-server.d.ts

@@ -0,0 +1,4 @@
+import type { AssetServerOptions } from "@vendure/asset-server-plugin";
+import { type CloudAssetServerSettings } from "@vendure/cloud-config";
+export declare function localAssetServerOptions(settings: CloudAssetServerSettings, assetUploadDir: string): AssetServerOptions;
+//# sourceMappingURL=local-asset-server.d.ts.map

package/dist/local-asset-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-asset-server.d.ts","sourceRoot":"","sources":["../src/local-asset-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAqB,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAkBzF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,wBAAwB,EAClC,cAAc,EAAE,MAAM,GACrB,kBAAkB,CAMpB"}

package/dist/local-asset-server.js

@@ -0,0 +1,24 @@
+import { CLOUD_ASSET_ROUTE } from "@vendure/cloud-config";
+// The local substitute for the asset capability (ADR-0017). The plugin is the upstream
+// `AssetServerPlugin`, the same one the managed runtime composes, so a preset or a transform
+// strategy a customer declared behaves the same in both places. What differs is where the bytes
+// live: a directory inside the project rather than the environment's own bucket.
+// The whole option set the local runtime hands `AssetServerPlugin.init`: the customer's own
+// options, with the two the platform takes written over the top. Written in this order
+// deliberately — a customer's declaration cannot reach those keys through the type, and this is
+// what makes that true of a configuration compiled from JavaScript as well.
+//
+// `route` is the platform's fixed route rather than a local one, so an asset URL a developer sees
+// is the path a deployed store serves the same asset on.
+//
+// `storageStrategyFactory` and `assetUrlPrefix` are left unset, which is what selects the plugin's
+// own filesystem storage and its own request-derived URLs. The platform supplies both in a managed
+// process; off-platform there is no bucket to reach and no ingress in front to build a URL from.
+export function localAssetServerOptions(settings, assetUploadDir) {
+    return {
+        ...settings,
+        route: CLOUD_ASSET_ROUTE,
+        assetUploadDir,
+    };
+}
+//# sourceMappingURL=local-asset-server.js.map

package/dist/local-asset-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-asset-server.js","sourceRoot":"","sources":["../src/local-asset-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAiC,MAAM,uBAAuB,CAAC;AAEzF,uFAAuF;AACvF,6FAA6F;AAC7F,gGAAgG;AAChG,iFAAiF;AAEjF,4FAA4F;AAC5F,uFAAuF;AACvF,gGAAgG;AAChG,4EAA4E;AAC5E,EAAE;AACF,kGAAkG;AAClG,yDAAyD;AACzD,EAAE;AACF,mGAAmG;AACnG,mGAAmG;AACnG,iGAAiG;AACjG,MAAM,UAAU,uBAAuB,CACrC,QAAkC,EAClC,cAAsB;IAEtB,OAAO;QACL,GAAG,QAAQ;QACX,KAAK,EAAE,iBAAiB;QACxB,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/local-cache-plugin.d.ts

@@ -0,0 +1,5 @@
+import { type PluginLike } from "@vendure/cloud-config";
+import { type LocalCacheConnection } from "./local-cache.js";
+export declare const LOCAL_CACHE_NAMESPACE = "vendure-cloud-local";
+export declare function localCachePlugin(connection: LocalCacheConnection): PluginLike;
+//# sourceMappingURL=local-cache-plugin.d.ts.map

package/dist/local-cache-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-cache-plugin.d.ts","sourceRoot":"","sources":["../src/local-cache-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EAAE,KAAK,oBAAoB,EAA6B,MAAM,kBAAkB,CAAC;AAWxF,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AA4C3D,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,oBAAoB,GAAG,UAAU,CAc7E"}