@vendure/cloud 0.2.0 → 0.3.1

package/dist/cli/lib/log-stream.js

@@ -0,0 +1,179 @@
+import * as prompts from "@clack/prompts";
+import { isLogEntry, isLogStreamErrorFrame, isLogStreamReconnectFrame, isLogStreamTerminalFrame, } from "./contract/logs.js";
+import { ApiError } from "./errors.js";
+// The SSE reader behind `logs --follow` and `deployment logs --follow`, and behind the build-log
+// follow that `deploy` does while it waits.
+//
+// It adds no contract of its own: every frame shape and every guard comes from
+// `./contract/logs.js`.
+//
+// Reached only through `await import(...)` from a command's `run`. It pulls in `@clack/prompts` and
+// the API client, which `test/cli-published-surface.test.ts` keeps off the cost of loading the
+// plugin.
+const UNEXPECTED_DISCONNECT_RETRY_MS = 1_000;
+function formatTimestamp(iso) {
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime()))
+        return iso;
+    if (date.toDateString() === new Date().toDateString()) {
+        return date.toISOString().slice(11, 23);
+    }
+    return date.toISOString();
+}
+// The dim is written as a raw escape rather than through `picocolors`, which is what `vcloud` does:
+// the timestamp is dimmed whether or not stdout is a terminal.
+export function printLogLine(entry) {
+    const timestamp = `\x1b[2m${formatTimestamp(entry.timestamp)}\x1b[0m`;
+    process.stdout.write(`${timestamp}  ${entry.message}\n`);
+}
+// Reads a log stream until it ends, and answers whether the customer interrupted it.
+//
+// `expectTerminalFrame` is the build-log case: that stream ends with a terminal frame when the
+// Build Step finishes, so anything else is a disconnect to reconnect through rather than the end of
+// the output. A runtime log stream has no such end, so a clean close there is the end of the
+// command.
+export async function consumeLogStream(client, path, options = {}) {
+    const controller = new AbortController();
+    const onSignal = () => controller.abort();
+    process.on("SIGINT", onSignal);
+    process.on("SIGTERM", onSignal);
+    try {
+        let resumeCursor;
+        while (!controller.signal.aborted) {
+            try {
+                const streamPath = withResumeCursor(path, resumeCursor);
+                const response = await client.stream(streamPath, controller.signal);
+                if (!response.body) {
+                    throw new Error("No response body received for log stream");
+                }
+                const reader = response.body.pipeThrough(new TextDecoderStream()).getReader();
+                let buffer = "";
+                let reconnect = false;
+                let terminal = false;
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    buffer += value;
+                    const lines = buffer.split("\n");
+                    buffer = lines.pop() ?? "";
+                    for (const rawLine of lines) {
+                        const frame = readFrame(rawLine);
+                        if (frame.kind === "skip")
+                            continue;
+                        if (frame.kind === "reconnect") {
+                            reconnect = true;
+                            break;
+                        }
+                        if (frame.kind === "terminal") {
+                            terminal = true;
+                            break;
+                        }
+                        printLogLine({ timestamp: frame.entry.timestamp ?? "", message: frame.entry.message });
+                        if (frame.entry.resumeCursor)
+                            resumeCursor = frame.entry.resumeCursor;
+                    }
+                    if (reconnect || terminal)
+                        break;
+                }
+                if (terminal) {
+                    await reader.cancel();
+                    return false;
+                }
+                if (reconnect) {
+                    await reader.cancel();
+                    continue;
+                }
+                if (!controller.signal.aborted && options.expectTerminalFrame) {
+                    prompts.log.warn("Build log stream disconnected. Reconnecting...");
+                    await waitForReconnect(controller.signal);
+                    continue;
+                }
+                if (!controller.signal.aborted) {
+                    prompts.log.warn("Log stream ended. Run the command again to reconnect.");
+                }
+                return controller.signal.aborted;
+            }
+            catch (error) {
+                if (controller.signal.aborted)
+                    return true;
+                if (options.expectTerminalFrame && isTransportError(error)) {
+                    prompts.log.warn("Build log stream disconnected. Reconnecting...");
+                    await waitForReconnect(controller.signal);
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return true;
+    }
+    catch (error) {
+        if (isAbortError(error))
+            return true;
+        throw error;
+    }
+    finally {
+        process.off("SIGINT", onSignal);
+        process.off("SIGTERM", onSignal);
+    }
+}
+// Decodes one raw SSE line into the action the reader loop takes for it. A malformed payload and a
+// typed error frame both throw here, so the caller only has to deal with the outcomes it can act
+// on.
+function readFrame(rawLine) {
+    const line = rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine;
+    if (!line.startsWith("data:"))
+        return { kind: "skip" };
+    const json = line.slice(5).trimStart();
+    if (!json)
+        return { kind: "skip" };
+    let payload;
+    try {
+        payload = JSON.parse(json);
+    }
+    catch {
+        throw new Error("Received malformed log stream data.");
+    }
+    if (isLogStreamErrorFrame(payload)) {
+        throw new ApiError(payload.streamError.statusCode, payload.streamError);
+    }
+    if (isLogStreamReconnectFrame(payload))
+        return { kind: "reconnect" };
+    if (isLogStreamTerminalFrame(payload))
+        return { kind: "terminal" };
+    if (!isLogEntry(payload)) {
+        throw new Error("Received malformed log stream data.");
+    }
+    return { kind: "entry", entry: payload };
+}
+function withResumeCursor(path, cursor) {
+    if (!cursor)
+        return path;
+    const separatorIndex = path.indexOf("?");
+    const pathname = separatorIndex === -1 ? path : path.slice(0, separatorIndex);
+    const query = new URLSearchParams(separatorIndex === -1 ? "" : path.slice(separatorIndex + 1));
+    query.set("cursor", cursor);
+    return `${pathname}?${query}`;
+}
+function isAbortError(error) {
+    return error instanceof DOMException && error.name === "AbortError";
+}
+function isTransportError(error) {
+    return (error instanceof TypeError || (error instanceof DOMException && error.name !== "AbortError"));
+}
+async function waitForReconnect(signal) {
+    if (signal.aborted)
+        return;
+    await new Promise((resolve) => {
+        const onAbort = () => {
+            clearTimeout(timer);
+            resolve();
+        };
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", onAbort);
+            resolve();
+        }, UNEXPECTED_DISCONNECT_RETRY_MS);
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=log-stream.js.map

package/dist/cli/lib/log-stream.js.map

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

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

@@ -0,0 +1,5 @@
+import pino from "pino";
+export declare const LOG_FILE_ENV_VAR = "VENDURE_CLOUD_LOG_FILE";
+export declare function resolveLogFile(): string;
+export declare const logger: pino.Logger<never, boolean>;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/logger.ts"],"names":[],"mappings":"AAEA,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,eAAO,MAAM,gBAAgB,2BAA2B,CAAC;AAIzD,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AA4CD,eAAO,MAAM,MAAM,6BAAmD,CAAC"}

package/dist/cli/lib/logger.js

@@ -0,0 +1,52 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import pino from "pino";
+import { CONFIG_DIR } from "./config.js";
+export const LOG_FILE_ENV_VAR = "VENDURE_CLOUD_LOG_FILE";
+// Resolved when the destination opens rather than at module load, so a test can
+// redirect the log after this module has been imported.
+export function resolveLogFile() {
+    const override = process.env[LOG_FILE_ENV_VAR]?.trim();
+    return override ? override : join(CONFIG_DIR, "cli.log");
+}
+// The log file is opened by the first line the CLI writes. Opening it while this
+// module is imported would reach ~/.vendure-cloud from anything that imports the
+// logger, down to a unit test that only wanted a module two imports away. The
+// truncate below would then destroy the log the developer was reading.
+function createLogDestination() {
+    let destination;
+    let target;
+    let stopped = false;
+    return {
+        write(line) {
+            if (stopped) {
+                return;
+            }
+            if (target === undefined) {
+                target = resolveLogFile();
+            }
+            try {
+                if (!destination) {
+                    mkdirSync(dirname(target), { recursive: true });
+                    // Each run of the CLI starts from an empty log.
+                    writeFileSync(target, "", "utf-8");
+                    destination = pino.destination({ dest: target, append: true, sync: true });
+                }
+                destination.write(line);
+            }
+            catch (error) {
+                // Failing the command the user asked for because its log file cannot be
+                // written would be worse than not logging. Saying nothing would be worse
+                // still: they would read a log that stops at an arbitrary point and take
+                // it for the whole run. The open and the write share this handler
+                // because a disk that fills mid-run costs the reader the same thing as
+                // one that was never writable.
+                stopped = true;
+                const reason = error instanceof Error ? error.message : String(error);
+                process.stderr.write(`Vendure Cloud: could not write the log file at ${target} (${reason}). The rest of this run is not being logged.\n`);
+            }
+        },
+    };
+}
+export const logger = pino({ level: "debug" }, createLogDestination());
+//# sourceMappingURL=logger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/cli/lib/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAEzD,gFAAgF;AAChF,wDAAwD;AACxD,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,CAAC;IACvD,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED,iFAAiF;AACjF,iFAAiF;AACjF,8EAA8E;AAC9E,uEAAuE;AACvE,SAAS,oBAAoB;IAC3B,IAAI,WAA+C,CAAC;IACpD,IAAI,MAA0B,CAAC;IAC/B,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO;QACL,KAAK,CAAC,IAAY;YAChB,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,GAAG,cAAc,EAAE,CAAC;YAC5B,CAAC;YACD,IAAI,CAAC;gBACH,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBAChD,gDAAgD;oBAChD,aAAa,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;oBACnC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC7E,CAAC;gBACD,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,wEAAwE;gBACxE,yEAAyE;gBACzE,yEAAyE;gBACzE,kEAAkE;gBAClE,uEAAuE;gBACvE,+BAA+B;gBAC/B,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kDAAkD,MAAM,KAAK,MAAM,gDAAgD,CACpH,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/cli/lib/open-browser.d.ts

@@ -0,0 +1,2 @@
+export declare function openBrowser(url: string): void;
+//# sourceMappingURL=open-browser.d.ts.map

package/dist/cli/lib/open-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/open-browser.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAK7C"}

package/dist/cli/lib/open-browser.js

@@ -0,0 +1,8 @@
+import { execFile } from "node:child_process";
+export function openBrowser(url) {
+    const parsed = new URL(url);
+    const platform = process.platform;
+    const cmd = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+    execFile(cmd, [parsed.href]);
+}
+//# sourceMappingURL=open-browser.js.map

package/dist/cli/lib/open-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser.js","sourceRoot":"","sources":["../../../src/cli/lib/open-browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,GAAG,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;IACzF,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ApiClient } from "./api-client.js";
+export declare function getAuthenticatedOrganizationSlug(client: ApiClient): Promise<string>;
+//# sourceMappingURL=organization.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"organization.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/organization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,wBAAsB,gCAAgC,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBzF"}

package/dist/cli/lib/organization.js

@@ -0,0 +1,20 @@
+import { readAuthConfig } from "./auth.js";
+import { cloudInvocation } from "./invocation.js";
+export async function getAuthenticatedOrganizationSlug(client) {
+    // The client sends an organization header only for the stored session, and
+    // the id it sends is the one the membership list is keyed on. Without it —
+    // an API key — only the control plane knows which organization this
+    // credential belongs to.
+    if (client.organizationId) {
+        const authConfig = readAuthConfig();
+        const activeOrganization = authConfig?.organizations.find((organization) => organization.id === client.organizationId);
+        if (activeOrganization)
+            return activeOrganization.slug;
+    }
+    const me = await client.get("/auth/me");
+    if (!me.dbOrganization?.slug) {
+        throw new Error(`No active organization. Run \`${cloudInvocation()} login\` or \`${cloudInvocation()} org switch\`.`);
+    }
+    return me.dbOrganization.slug;
+}
+//# sourceMappingURL=organization.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"organization.js","sourceRoot":"","sources":["../../../src/cli/lib/organization.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,gCAAgC,CAAC,MAAiB;IACtE,2EAA2E;IAC3E,2EAA2E;IAC3E,oEAAoE;IACpE,yBAAyB;IACzB,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;QACpC,MAAM,kBAAkB,GAAG,UAAU,EAAE,aAAa,CAAC,IAAI,CACvD,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,EAAE,KAAK,MAAM,CAAC,cAAc,CAC5D,CAAC;QACF,IAAI,kBAAkB;YAAE,OAAO,kBAAkB,CAAC,IAAI,CAAC;IACzD,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAyC,UAAU,CAAC,CAAC;IAChF,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,iCAAiC,eAAe,EAAE,iBAAiB,eAAe,EAAE,gBAAgB,CACrG,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC;AAChC,CAAC"}

package/dist/cli/lib/project-link.d.ts

@@ -0,0 +1,12 @@
+export declare const PROJECT_LINK_DIR = ".vendure-cloud";
+export declare const PROJECT_LINK_FILENAME = "project.json";
+export interface ProjectLink {
+    organization: string;
+    project: string;
+}
+export declare function findProjectLink(startDir?: string): string | null;
+export declare function findProjectRoot(startDir?: string): string | null;
+export declare function readProjectLink(startDir?: string): ProjectLink | null;
+export declare function writeProjectLink(rootDir: string, link: ProjectLink): string;
+export declare function removeProjectLink(startDir?: string): string | null;
+//# sourceMappingURL=project-link.d.ts.map

package/dist/cli/lib/project-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-link.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/project-link.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AACjD,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,QAAQ,SAAgB,GAAG,MAAM,GAAG,IAAI,CAUvE;AAMD,wBAAgB,eAAe,CAAC,QAAQ,SAAgB,GAAG,MAAM,GAAG,IAAI,CAGvE;AAED,wBAAgB,eAAe,CAAC,QAAQ,SAAgB,GAAG,WAAW,GAAG,IAAI,CAiB5E;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAM3E;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,SAAgB,GAAG,MAAM,GAAG,IAAI,CAKzE"}

package/dist/cli/lib/project-link.js

@@ -0,0 +1,69 @@
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join, parse, resolve } from "node:path";
+export const PROJECT_LINK_DIR = ".vendure-cloud";
+export const PROJECT_LINK_FILENAME = "project.json";
+export function findProjectLink(startDir = process.cwd()) {
+    let directory = resolve(startDir);
+    const root = parse(directory).root;
+    while (true) {
+        const candidate = join(directory, PROJECT_LINK_DIR, PROJECT_LINK_FILENAME);
+        if (existsSync(candidate))
+            return candidate;
+        if (directory === root)
+            return null;
+        directory = dirname(directory);
+    }
+}
+// Directory that owns the project link (`.vendure-cloud/project.json` lives in
+// its `.vendure-cloud/`), found by walking up from `startDir`. This is the
+// project root the CLI resolves context from, so commands can run from any
+// subdirectory; returns null when no link is found.
+export function findProjectRoot(startDir = process.cwd()) {
+    const link = findProjectLink(startDir);
+    return link ? dirname(dirname(link)) : null;
+}
+export function readProjectLink(startDir = process.cwd()) {
+    const file = findProjectLink(startDir);
+    if (!file)
+        return null;
+    let value;
+    try {
+        value = JSON.parse(readFileSync(file, "utf-8"));
+    }
+    catch {
+        throw new Error(`Invalid Vendure Cloud project link: ${file}`);
+    }
+    if (!isProjectLink(value)) {
+        throw new Error(`Invalid Vendure Cloud project link: ${file} must contain only organization and project slugs.`);
+    }
+    return value;
+}
+export function writeProjectLink(rootDir, link) {
+    const directory = join(resolve(rootDir), PROJECT_LINK_DIR);
+    const file = join(directory, PROJECT_LINK_FILENAME);
+    mkdirSync(directory, { recursive: true });
+    writeFileSync(file, `${JSON.stringify(link, null, 2)}\n`, "utf-8");
+    return file;
+}
+export function removeProjectLink(startDir = process.cwd()) {
+    const file = findProjectLink(startDir);
+    if (!file)
+        return null;
+    unlinkSync(file);
+    return file;
+}
+function isProjectLink(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const record = value;
+    const keys = Object.keys(record).sort();
+    return (keys.length === 2 &&
+        keys[0] === "organization" &&
+        keys[1] === "project" &&
+        isSlug(record.organization) &&
+        isSlug(record.project));
+}
+function isSlug(value) {
+    return typeof value === "string" && /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(value);
+}
+//# sourceMappingURL=project-link.js.map

package/dist/cli/lib/project-link.js.map

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

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

@@ -0,0 +1,20 @@
+import type { CredentialOptions, GlobalOptions } from "../root-options.js";
+import { type ApiClient } from "./api-client.js";
+import type { Environment, Project } from "./types.js";
+/**
+ * Takes the root options so an explicit `--token` reaches the client. Every
+ * command that talks to the control plane goes through here, and the parameter
+ * is required so a new one cannot quietly fall back to the stored session.
+ */
+export declare function createAuthenticatedClient(options: CredentialOptions): ApiClient;
+export declare function resolveProject(options: GlobalOptions): Promise<Project>;
+export declare function findProject(identifier: string, options: CredentialOptions): Promise<Project>;
+export declare function listProjects(client: ApiClient): Promise<Project[]>;
+export declare function findProjectOrNull(projects: readonly Project[], identifier: string): Project | null;
+export declare function listEnvironments(client: ApiClient, projectId: string): Promise<Environment[]>;
+export declare function findEnvironmentOrNull(environments: readonly Environment[], identifier: string): Environment | null;
+export declare function resolveEnvironment(options: GlobalOptions): Promise<{
+    project: Project;
+    environment: Environment;
+}>;
+//# sourceMappingURL=resolve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,iBAAiB,CAAC;AAOlE,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,CAwB/E;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAY7E;AAeD,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CASlB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAElE;AAED,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,UAAU,EAAE,MAAM,GACjB,OAAO,GAAG,IAAI,CAIhB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAE7F;AAED,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,SAAS,WAAW,EAAE,EACpC,UAAU,EAAE,MAAM,GACjB,WAAW,GAAG,IAAI,CAMpB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,CAAC,CAqBzD"}

package/dist/cli/lib/resolve.js

@@ -0,0 +1,88 @@
+import { createApiClient } from "./api-client.js";
+import { refreshAccessToken, resolveCredential } from "./auth.js";
+import { getApiUrl } from "./config.js";
+import { readContext } from "./context.js";
+import { cloudInvocation } from "./invocation.js";
+import { getAuthenticatedOrganizationSlug } from "./organization.js";
+import { readProjectLink } from "./project-link.js";
+/**
+ * Takes the root options so an explicit `--token` reaches the client. Every
+ * command that talks to the control plane goes through here, and the parameter
+ * is required so a new one cannot quietly fall back to the stored session.
+ */
+export function createAuthenticatedClient(options) {
+    const credential = resolveCredential(options);
+    if (!credential) {
+        throw new Error(`Not logged in. Run \`${cloudInvocation()} login\` to authenticate.`);
+    }
+    if (credential.kind === "apiKey") {
+        // No organization header: the control plane resolves an API key's own
+        // organization, so sending a locally selected one could only contradict
+        // it — and a machine running on a key alone has never selected one. No
+        // refresh callback either: the stored session's refresh token belongs to
+        // a different credential.
+        return createApiClient({ baseUrl: getApiUrl(), apiKey: credential.token });
+    }
+    if (!credential.organizationId) {
+        throw new Error(`No active organization. Run \`${cloudInvocation()} login\` to authenticate.`);
+    }
+    return createApiClient({
+        baseUrl: getApiUrl(),
+        token: credential.token,
+        organizationId: credential.organizationId,
+        onUnauthorized: (failedToken) => refreshAccessToken(failedToken),
+    });
+}
+export async function resolveProject(options) {
+    if (options.project)
+        return findProject(options.project, options);
+    const projectLink = readProjectLink();
+    if (projectLink) {
+        await assertActiveOrganization(projectLink.organization, options);
+        return findProject(projectLink.project, options);
+    }
+    throw new Error(`No project selected. Use --project <slug-or-id> or run \`${cloudInvocation()} project link <slug-or-id>\` in a Git repository.`);
+}
+async function assertActiveOrganization(expectedSlug, options) {
+    const client = createAuthenticatedClient(options);
+    const activeOrganizationSlug = await getAuthenticatedOrganizationSlug(client);
+    if (activeOrganizationSlug !== expectedSlug) {
+        throw new Error(`This repository is linked to organization "${expectedSlug}", but "${activeOrganizationSlug}" is active. Run \`${cloudInvocation()} org switch\`.`);
+    }
+}
+export async function findProject(identifier, options) {
+    const client = createAuthenticatedClient(options);
+    const project = findProjectOrNull(await listProjects(client), identifier);
+    if (!project) {
+        throw new Error(`Project "${identifier}" not found in your organization.`);
+    }
+    return project;
+}
+export function listProjects(client) {
+    return client.get("/projects");
+}
+export function findProjectOrNull(projects, identifier) {
+    return (projects.find((project) => project.slug === identifier || project.id === identifier) ?? null);
+}
+export function listEnvironments(client, projectId) {
+    return client.get(`/environments?projectId=${projectId}`);
+}
+export function findEnvironmentOrNull(environments, identifier) {
+    return (environments.find((environment) => environment.slug === identifier || environment.id === identifier) ?? null);
+}
+export async function resolveEnvironment(options) {
+    const project = await resolveProject(options);
+    const context = readContext();
+    const environmentIdentifier = options.environment ?? context.environmentsByProject?.[project.id];
+    if (!environmentIdentifier) {
+        throw new Error(`No environment specified. Use --environment <name> or run \`${cloudInvocation()} use <environment>\` to set a default.`);
+    }
+    const client = createAuthenticatedClient(options);
+    const environments = await listEnvironments(client, project.id);
+    const environment = findEnvironmentOrNull(environments, environmentIdentifier);
+    if (!environment) {
+        throw new Error(`Environment "${environmentIdentifier}" not found in project "${project.slug}". Available: ${environments.map((e) => e.slug).join(", ") || "none"}`);
+    }
+    return { project, environment };
+}
+//# sourceMappingURL=resolve.js.map

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

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

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

@@ -0,0 +1,2 @@
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/sleep.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/cli/lib/sleep.js

@@ -0,0 +1,4 @@
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=sleep.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../../src/cli/lib/sleep.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

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

@@ -0,0 +1,3 @@
+export declare function toSlug(name: string): string;
+export declare function slugToName(slug: string): string;
+//# sourceMappingURL=slug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/slug.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK3C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C"}

package/dist/cli/lib/slug.js

@@ -0,0 +1,13 @@
+export function toSlug(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "");
+}
+export function slugToName(slug) {
+    return slug
+        .split("-")
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}
+//# sourceMappingURL=slug.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../../src/cli/lib/slug.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI;SACR,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/cli/lib/source-repository-link.d.ts

@@ -0,0 +1,5 @@
+import type { ApiClient } from "./api-client.js";
+import type { SourceBranchMappingDetails, SourceRepositoryLinkDetails } from "./contract/source-repository.js";
+export declare function getRepositoryLinkOrNull(client: ApiClient, projectId: string): Promise<SourceRepositoryLinkDetails | null>;
+export declare function getBranchMappingOrNull(client: ApiClient, environmentId: string): Promise<SourceBranchMappingDetails | null>;
+//# sourceMappingURL=source-repository-link.d.ts.map

package/dist/cli/lib/source-repository-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-repository-link.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/source-repository-link.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EACV,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,iCAAiC,CAAC;AAczC,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,2BAA2B,GAAG,IAAI,CAAC,CAE7C;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,SAAS,EACjB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAE5C"}

package/dist/cli/lib/source-repository-link.js

@@ -0,0 +1,28 @@
+import { ApiError } from "./errors.js";
+// Reading a VC Project's Source Repository Link and a VC Environment's branch mapping.
+//
+// One implementation on the shared boundary because two families need it: the VC Project
+// configuration family's `init`, `source map`, `source status`, `source connect` and
+// `source disconnect`, and the VC Deployment family's `deploy` and `deploy plan`.
+//
+// A 404 is an answer, not a failure: the VC Project has no Source Repository Link, or the VC
+// Environment has no branch mapping. Every other status stays an error, so a 403 or a 500 is not
+// quietly read as "not configured" — which for `deploy` would replace an outage with the guidance
+// to run `source connect`.
+export async function getRepositoryLinkOrNull(client, projectId) {
+    return getOrNull(client, `/projects/${projectId}/source-repository-link`);
+}
+export async function getBranchMappingOrNull(client, environmentId) {
+    return getOrNull(client, `/environments/${environmentId}/source-branch-mapping`);
+}
+async function getOrNull(client, path) {
+    try {
+        return await client.get(path);
+    }
+    catch (error) {
+        if (error instanceof ApiError && error.status === 404)
+            return null;
+        throw error;
+    }
+}
+//# sourceMappingURL=source-repository-link.js.map

package/dist/cli/lib/source-repository-link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-repository-link.js","sourceRoot":"","sources":["../../../src/cli/lib/source-repository-link.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,uFAAuF;AACvF,EAAE;AACF,yFAAyF;AACzF,qFAAqF;AACrF,kFAAkF;AAClF,EAAE;AACF,6FAA6F;AAC7F,iGAAiG;AACjG,kGAAkG;AAClG,2BAA2B;AAE3B,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAiB,EACjB,SAAiB;IAEjB,OAAO,SAAS,CAAC,MAAM,EAAE,aAAa,SAAS,yBAAyB,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAiB,EACjB,aAAqB;IAErB,OAAO,SAAS,CAAC,MAAM,EAAE,iBAAiB,aAAa,wBAAwB,CAAC,CAAC;AACnF,CAAC;AAED,KAAK,UAAU,SAAS,CAAI,MAAiB,EAAE,IAAY;IACzD,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,GAAG,CAAI,IAAI,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QACnE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}