@relkit/cli 0.0.0

package/dist/commands/env.js

@@ -0,0 +1,71 @@
+import { createExample, EnvCommandError, formatCheck, formatExplain, loadEnvDefinition, parseEnvArgs, resolveStatus, isRequired, } from "./env-support.js";
+import { projectEnv } from "@relkit/config";
+import { CLI_EXIT_CODES } from "../main-support.js";
+export { createExample, EnvCommandError, formatCheck, formatExplain, loadEnvDefinition, parseEnvArgs, resolveStatus, isRequired, };
+/** Runs the secret-safe environment command family through the shared reporter. */
+export async function runEnv(args, context, options = {}) {
+    try {
+        const parsed = parseEnvArgs(args);
+        const settings = {
+            ...options,
+            ...(parsed.projectRoot === undefined ? {} : { projectRoot: parsed.projectRoot }),
+            ...(parsed.environment === undefined ? {} : { environment: parsed.environment }),
+            ...(parsed.examplePath === undefined ? {} : { examplePath: parsed.examplePath }),
+        };
+        const definition = await loadEnvDefinition(settings);
+        const environment = settings.environment ?? process.env.NODE_ENV ?? "development";
+        const source = settings.source ?? process.env;
+        const fields = projectEnv(definition);
+        if (parsed.command === "example") {
+            const result = await createExample(fields, settings, parsed.write);
+            context.reporter.output(result, result.content);
+            return CLI_EXIT_CODES.success;
+        }
+        const resolution = resolveStatus(definition, fields, environment, source);
+        if (parsed.command === "check") {
+            const result = {
+                ok: resolution.ok,
+                command: "check",
+                environment,
+                items: resolution.items,
+                issues: resolution.issues,
+            };
+            context.reporter.output(result, formatCheck(result));
+            return resolution.ok ? CLI_EXIT_CODES.success : CLI_EXIT_CODES.failure;
+        }
+        if (parsed.command === "list") {
+            const result = {
+                ok: true,
+                command: "list",
+                environment,
+                items: resolution.items,
+            };
+            context.reporter.output(result, result.items.map((item) => `${item.name}: ${item.status}`).join("\n"));
+            return CLI_EXIT_CODES.success;
+        }
+        const field = fields.find(({ name }) => name === parsed.name);
+        if (field === undefined)
+            throw new EnvCommandError("RELKIT_ENV_UNKNOWN", `Unknown environment variable: ${parsed.name}`);
+        const result = {
+            ok: true,
+            command: "explain",
+            environment,
+            name: field.name,
+            type: field.type,
+            requiredIn: field.requiredIn,
+            required: isRequired(field, environment),
+            hasDefault: field.hasDefault,
+            optional: field.optional,
+            sensitive: field.sensitive,
+            ...(field.description === undefined ? {} : { description: field.description }),
+        };
+        context.reporter.output(result, formatExplain(result));
+        return CLI_EXIT_CODES.success;
+    }
+    catch (error) {
+        const code = error instanceof EnvCommandError ? error.code : "RELKIT_ENV_FAILED";
+        context.reporter.error(code, error instanceof Error ? error.message : String(error));
+        return code === "RELKIT_ENV_USAGE" ? CLI_EXIT_CODES.usage : CLI_EXIT_CODES.failure;
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/commands/env.js.map

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

package/dist/commands/graph-support.d.ts

@@ -0,0 +1,44 @@
+import { type ApplicationGraph, type GraphDiff } from "@relkit/graph";
+export declare class GraphCommandError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export interface GraphFileOptions {
+    readonly projectRoot?: string;
+    readonly graphPath?: string;
+}
+export interface GraphPrintResult {
+    readonly ok: true;
+    readonly command: "print";
+    readonly graphPath: string;
+    readonly graphHash: string;
+    readonly graph: ApplicationGraph;
+}
+export interface GraphCheckResult {
+    readonly ok: true;
+    readonly command: "check";
+    readonly graphPath: string;
+    readonly graphHash: string;
+    readonly expectedHash?: string;
+}
+export interface GraphDiffResult extends GraphDiff {
+    readonly ok: true;
+    readonly command: "diff";
+    readonly beforePath: string;
+    readonly afterPath: string;
+    readonly beforeHash: string;
+    readonly afterHash: string;
+}
+/** Reads and canonicalizes a graph artifact without loading source or runtime code. */
+export declare function readGraphFile(options?: GraphFileOptions): Promise<Readonly<{
+    path: string;
+    graph: ApplicationGraph;
+    hash: string;
+    json: string;
+}>>;
+export declare function printGraph(options?: GraphFileOptions): Promise<GraphPrintResult>;
+export declare function checkGraph(options?: GraphFileOptions & {
+    readonly expectedHash?: string;
+}): Promise<GraphCheckResult>;
+export declare function diffGraphFiles(beforePath: string, afterPath: string, options?: Omit<GraphFileOptions, "graphPath">): Promise<GraphDiffResult>;
+//# sourceMappingURL=graph-support.d.ts.map

package/dist/commands/graph-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-support.d.ts","sourceRoot":"","sources":["../../src/commands/graph-support.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACf,MAAM,eAAe,CAAC;AAKvB,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AACD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;CAClC;AACD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AACD,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,uFAAuF;AACvF,wBAAsB,aAAa,CAAC,OAAO,GAAE,gBAAqB;;;;;IA4BjE;AAED,wBAAsB,UAAU,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAS1F;AAED,wBAAsB,UAAU,CAC9B,OAAO,GAAE,gBAAgB,GAAG;IAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,OAAO,CAAC,gBAAgB,CAAC,CAiB3B;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAM,GAChD,OAAO,CAAC,eAAe,CAAC,CAa1B"}

package/dist/commands/graph-support.js

@@ -0,0 +1,93 @@
+import { readFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { GRAPH_VERSION } from "@relkit/contracts";
+import { canonicalGraphJson, canonicalizeGraph, diffGraph as diffCanonicalGraph, hashGraph, validateGraphShape, } from "@relkit/graph";
+const GRAPH_FILE = "application.graph.json";
+const HASH_PATTERN = /^sha256:[0-9a-f]{64}$/;
+export class GraphCommandError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "GraphCommandError";
+        this.code = code;
+    }
+}
+/** Reads and canonicalizes a graph artifact without loading source or runtime code. */
+export async function readGraphFile(options = {}) {
+    const root = resolve(options.projectRoot ?? process.cwd());
+    const path = resolve(root, options.graphPath ?? join(".relkit", "generated", GRAPH_FILE));
+    let value;
+    try {
+        value = JSON.parse(await readFile(path, "utf8"));
+    }
+    catch (error) {
+        const code = error instanceof Error && "code" in error && error.code === "ENOENT"
+            ? "RELKIT_GRAPH_NOT_FOUND"
+            : "RELKIT_GRAPH_INVALID";
+        const detail = code === "RELKIT_GRAPH_NOT_FOUND" ? "was not found" : "is not valid JSON";
+        throw new GraphCommandError(code, `Graph file ${detail}: ${path}`);
+    }
+    if (!isRecord(value))
+        invalid(path, "the root must be an object");
+    if (value.contractVersion !== GRAPH_VERSION) {
+        throw new GraphCommandError("RELKIT_GRAPH_VERSION_UNSUPPORTED", `Graph contract version ${String(value.contractVersion)} is unsupported; expected ${GRAPH_VERSION}: ${path}`);
+    }
+    try {
+        validateGraphShape(value, root);
+    }
+    catch (error) {
+        invalid(path, error instanceof Error ? error.message : String(error));
+    }
+    const graph = canonicalizeGraph(value, { projectRoot: root });
+    return Object.freeze({ path, graph, hash: hashGraph(graph), json: canonicalGraphJson(graph) });
+}
+export async function printGraph(options = {}) {
+    const loaded = await readGraphFile(options);
+    return Object.freeze({
+        ok: true,
+        command: "print",
+        graphPath: loaded.path,
+        graphHash: loaded.hash,
+        graph: loaded.graph,
+    });
+}
+export async function checkGraph(options = {}) {
+    const loaded = await readGraphFile(options);
+    if (options.expectedHash !== undefined) {
+        assertHash(options.expectedHash, "expected graph hash");
+        if (options.expectedHash !== loaded.hash)
+            throw new GraphCommandError("RELKIT_GRAPH_HASH_MISMATCH", `Expected graph hash ${JSON.stringify(options.expectedHash)} but calculated ${JSON.stringify(loaded.hash)}.`);
+    }
+    return Object.freeze({
+        ok: true,
+        command: "check",
+        graphPath: loaded.path,
+        graphHash: loaded.hash,
+        ...(options.expectedHash === undefined ? {} : { expectedHash: options.expectedHash }),
+    });
+}
+export async function diffGraphFiles(beforePath, afterPath, options = {}) {
+    const before = await readGraphFile({ ...options, graphPath: beforePath });
+    const after = await readGraphFile({ ...options, graphPath: afterPath });
+    const diff = diffCanonicalGraph(before.graph, after.graph);
+    return Object.freeze({
+        ok: true,
+        command: "diff",
+        beforePath: before.path,
+        afterPath: after.path,
+        beforeHash: before.hash,
+        afterHash: after.hash,
+        ...diff,
+    });
+}
+function assertHash(value, label) {
+    if (!HASH_PATTERN.test(value))
+        throw new GraphCommandError("RELKIT_GRAPH_HASH_INVALID", `${label} must use sha256:<64 lowercase hex>.`);
+}
+function invalid(path, detail) {
+    throw new GraphCommandError("RELKIT_GRAPH_INVALID", `Invalid graph ${path}: ${detail}`);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=graph-support.js.map

package/dist/commands/graph-support.js.map

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

package/dist/commands/graph.d.ts

@@ -0,0 +1,5 @@
+import { type CliCommandContext } from "../main-support.js";
+export * from "./graph-support.js";
+/** Runs `relkit graph print|check|diff` through the shared CLI reporter. */
+export declare function runGraph(args: readonly string[], context: Pick<CliCommandContext, "json" | "reporter">): Promise<number>;
+//# sourceMappingURL=graph.d.ts.map

package/dist/commands/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/commands/graph.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAU5E,cAAc,oBAAoB,CAAC;AAEnC,4EAA4E;AAC5E,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,UAAU,CAAC,GACpD,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/commands/graph.js

@@ -0,0 +1,82 @@
+import { canonicalGraphJson } from "@relkit/graph";
+import { CLI_EXIT_CODES } from "../main-support.js";
+import { checkGraph, diffGraphFiles, GraphCommandError, printGraph, } from "./graph-support.js";
+export * from "./graph-support.js";
+/** Runs `relkit graph print|check|diff` through the shared CLI reporter. */
+export async function runGraph(args, context) {
+    try {
+        const parsed = parseArgs(args);
+        if (parsed.command === "print") {
+            const result = await printGraph(fileOptions(parsed));
+            context.reporter.output(result, canonicalGraphJson(result.graph));
+            return CLI_EXIT_CODES.success;
+        }
+        if (parsed.command === "check") {
+            const result = await checkGraph({
+                ...fileOptions(parsed),
+                ...(parsed.expectedHash === undefined ? {} : { expectedHash: parsed.expectedHash }),
+            });
+            context.reporter.output(result, `Graph is valid. Hash: ${result.graphHash}`);
+            return CLI_EXIT_CODES.success;
+        }
+        const result = await diffGraphFiles(parsed.paths[0], parsed.paths[1], fileOptions(parsed));
+        context.reporter.output(result, formatDiff(result));
+        return CLI_EXIT_CODES.success;
+    }
+    catch (error) {
+        const code = error instanceof Error && "code" in error ? String(error.code) : "RELKIT_GRAPH_FAILED";
+        context.reporter.error(code, error instanceof Error ? error.message : String(error));
+        return code === "RELKIT_GRAPH_USAGE" ? CLI_EXIT_CODES.usage : CLI_EXIT_CODES.failure;
+    }
+}
+function parseArgs(args) {
+    const command = args[0];
+    if (command !== "print" && command !== "check" && command !== "diff")
+        throw new GraphCommandError("RELKIT_GRAPH_USAGE", "Usage: relkit graph print|check|diff [paths]");
+    const paths = [];
+    let expectedHash;
+    let projectRoot;
+    for (let i = 1; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === "--hash" || arg === "--project-root") {
+            const value = args[++i];
+            if (value === undefined || value.startsWith("-"))
+                throw new GraphCommandError("RELKIT_GRAPH_USAGE", `${arg} requires a value.`);
+            if (arg === "--hash")
+                expectedHash = value;
+            else
+                projectRoot = value;
+        }
+        else if (arg?.startsWith("-"))
+            throw new GraphCommandError("RELKIT_GRAPH_USAGE", `Unknown graph option: ${arg}`);
+        else if (arg !== undefined)
+            paths.push(arg);
+    }
+    const count = command === "diff" ? 2 : 1;
+    if (paths.length > count || (command === "diff" && paths.length !== count))
+        throw new GraphCommandError("RELKIT_GRAPH_USAGE", command === "diff"
+            ? "Graph diff requires before and after paths."
+            : `Expected at most ${count} graph path.`);
+    return {
+        command,
+        paths,
+        ...(expectedHash === undefined ? {} : { expectedHash }),
+        ...(projectRoot === undefined ? {} : { projectRoot }),
+    };
+}
+function fileOptions(args, index = 0) {
+    return {
+        ...(args.projectRoot === undefined ? {} : { projectRoot: args.projectRoot }),
+        ...(args.paths[index] === undefined ? {} : { graphPath: args.paths[index] }),
+    };
+}
+function formatDiff(result) {
+    const lines = [`Before: ${result.beforeHash}`, `After: ${result.afterHash}`];
+    if (result.changes.length === 0)
+        return [...lines, "No compatibility changes."].join("\n");
+    lines.push(`Highest classification: ${result.highestClassification ?? "none"}`);
+    for (const change of result.changes)
+        lines.push(`${change.classification}: ${change.category} ${change.id} (${change.change})`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=graph.js.map

package/dist/commands/graph.js.map

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

package/dist/commands/port-availability.d.ts

@@ -0,0 +1,2 @@
+export declare function assertPortAvailable(port: number, hostname: string, override: "--port" | "--inspector-port"): Promise<void>;
+//# sourceMappingURL=port-availability.d.ts.map

package/dist/commands/port-availability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-availability.d.ts","sourceRoot":"","sources":["../../src/commands/port-availability.ts"],"names":[],"mappings":"AAAA,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,GAAG,kBAAkB,GACtC,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/commands/port-availability.js

@@ -0,0 +1,38 @@
+export async function assertPortAvailable(port, hostname, override) {
+    if (port === 0)
+        return;
+    try {
+        const probe = Bun.serve({ hostname, port, fetch: () => new Response() });
+        await probe.stop(true);
+    }
+    catch (error) {
+        if (!isAddressInUse(error))
+            throw error;
+        const owner = await listeningProcess(port);
+        throw new Error(`Port ${port} on ${hostname} is already in use by ${owner}. Stop it or choose another with ${override}.`, { cause: error });
+    }
+}
+async function listeningProcess(port) {
+    try {
+        const child = Bun.spawn(["lsof", "-nP", `-iTCP:${port}`, "-sTCP:LISTEN"], {
+            stdout: "pipe",
+            stderr: "ignore",
+        });
+        const [output, exitCode] = await Promise.all([new Response(child.stdout).text(), child.exited]);
+        if (exitCode !== 0)
+            return "another process (PID unavailable)";
+        const columns = output.trim().split(/\r?\n/)[1]?.trim().split(/\s+/);
+        return columns?.[0] !== undefined && columns[1] !== undefined
+            ? `${columns[0]} (PID ${columns[1]})`
+            : "another process (PID unavailable)";
+    }
+    catch {
+        return "another process (PID unavailable)";
+    }
+}
+function isAddressInUse(error) {
+    return (error instanceof Error &&
+        (("code" in error && error.code === "EADDRINUSE") ||
+            /address already in use/i.test(error.message)));
+}
+//# sourceMappingURL=port-availability.js.map

package/dist/commands/port-availability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-availability.js","sourceRoot":"","sources":["../../src/commands/port-availability.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAY,EACZ,QAAgB,EAChB,QAAuC;IAEvC,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO;IACvB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,QAAQ,EAAE,EAAE,CAAC,CAAC;QACzE,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,QAAQ,IAAI,OAAO,QAAQ,yBAAyB,KAAK,oCAAoC,QAAQ,GAAG,EACxG,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,cAAc,CAAC,EAAE;YACxE,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAChG,IAAI,QAAQ,KAAK,CAAC;YAAE,OAAO,mCAAmC,CAAC;QAC/D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrE,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS;YAC3D,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,GAAG;YACrC,CAAC,CAAC,mCAAmC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,mCAAmC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,CACL,KAAK,YAAY,KAAK;QACtB,CAAC,CAAC,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC;YAC/C,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CACjD,CAAC;AACJ,CAAC"}

package/dist/commands/ports.d.ts

@@ -0,0 +1,8 @@
+export interface PortResolutionOptions {
+    readonly flag?: number;
+    readonly source?: Readonly<Record<string, string | undefined>>;
+    readonly configured?: number;
+}
+export declare function resolveApplicationPort(options?: PortResolutionOptions): number;
+export declare function resolveInspectorPort(options?: PortResolutionOptions): number;
+//# sourceMappingURL=ports.d.ts.map

package/dist/commands/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/commands/ports.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC/D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAElF;AAED,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAEhF"}

package/dist/commands/ports.js

@@ -0,0 +1,33 @@
+export function resolveApplicationPort(options = {}) {
+    return resolvePort(options, "PORT", 3000, true);
+}
+export function resolveInspectorPort(options = {}) {
+    return resolvePort(options, "RELKIT_INSPECTOR_PORT", 3210, false);
+}
+function resolvePort(options, environmentName, fallback, allowZero) {
+    if (options.flag !== undefined)
+        return valid(options.flag, `--${flagName(environmentName)}`, allowZero);
+    const environment = options.source?.[environmentName];
+    if (environment !== undefined) {
+        if (!/^\d+$/.test(environment)) {
+            throw new RangeError(`${environmentName} must be a valid port.`);
+        }
+        return valid(Number(environment), environmentName, allowZero);
+    }
+    return options.configured === undefined
+        ? fallback
+        : valid(options.configured, `${configName(environmentName)}.port`, false);
+}
+function valid(value, name, allowZero) {
+    if (!Number.isSafeInteger(value) || value < (allowZero ? 0 : 1) || value > 65_535) {
+        throw new RangeError(`${name} must be from ${allowZero ? 0 : 1} through 65535.`);
+    }
+    return value;
+}
+function flagName(environmentName) {
+    return environmentName === "PORT" ? "port" : "inspector-port";
+}
+function configName(environmentName) {
+    return environmentName === "PORT" ? "server" : "inspector";
+}
+//# sourceMappingURL=ports.js.map

package/dist/commands/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/commands/ports.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,sBAAsB,CAAC,UAAiC,EAAE;IACxE,OAAO,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAiC,EAAE;IACtE,OAAO,WAAW,CAAC,OAAO,EAAE,uBAAuB,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,WAAW,CAClB,OAA8B,EAC9B,eAAuB,EACvB,QAAgB,EAChB,SAAkB;IAElB,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAC5B,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,QAAQ,CAAC,eAAe,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC1E,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,eAAe,CAAC,CAAC;IACtD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,UAAU,CAAC,GAAG,eAAe,wBAAwB,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,OAAO,CAAC,UAAU,KAAK,SAAS;QACrC,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,IAAY,EAAE,SAAkB;IAC5D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,MAAM,EAAE,CAAC;QAClF,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,iBAAiB,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,eAAuB;IACvC,OAAO,eAAe,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC;AAChE,CAAC;AAED,SAAS,UAAU,CAAC,eAAuB;IACzC,OAAO,eAAe,KAAK,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC;AAC7D,CAAC"}

package/dist/commands/start-built.d.ts

@@ -0,0 +1,18 @@
+export interface BuiltManifest {
+    readonly contractVersion: number;
+    readonly generatorVersion: number;
+    readonly graphVersion: number;
+    readonly manifestVersion: number;
+    readonly graphHash: string;
+    readonly entrypoint: string;
+    readonly containerEntrypoint: string;
+    readonly runtimeManifestFile: string;
+    readonly server?: {
+        readonly port?: number;
+    };
+}
+export declare function readBuilt(buildDirectory: string): Promise<{
+    readonly graphHash: string;
+    readonly manifest: BuiltManifest;
+}>;
+//# sourceMappingURL=start-built.d.ts.map

package/dist/commands/start-built.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-built.d.ts","sourceRoot":"","sources":["../../src/commands/start-built.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,wBAAsB,SAAS,CAC7B,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;CAAE,CAAC,CAsC3E"}

package/dist/commands/start-built.js

@@ -0,0 +1,33 @@
+import { access, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { CONTRACT_VERSION, GENERATOR_VERSION, GRAPH_VERSION, MANIFEST_VERSION, } from "@relkit/contracts";
+import { assertProductionGraph, hashGraph } from "@relkit/graph";
+export async function readBuilt(buildDirectory) {
+    const graph = JSON.parse(await readFile(join(buildDirectory, "application.graph.json"), "utf8"));
+    assertProductionGraph(graph);
+    const manifest = JSON.parse(await readFile(join(buildDirectory, "manifest.json"), "utf8"));
+    if (graph.contractVersion !== GRAPH_VERSION ||
+        manifest.contractVersion !== CONTRACT_VERSION ||
+        manifest.graphVersion !== GRAPH_VERSION ||
+        manifest.manifestVersion !== MANIFEST_VERSION ||
+        manifest.generatorVersion !== GENERATOR_VERSION) {
+        throw new Error("Built graph or manifest version is unsupported.");
+    }
+    const graphHash = hashGraph(graph);
+    if (manifest.graphHash !== graphHash) {
+        throw new Error("Built graph and manifest hashes do not match.");
+    }
+    if (manifest.entrypoint !== "server/index.ts" ||
+        manifest.containerEntrypoint !== "server/index.js" ||
+        manifest.runtimeManifestFile !== "server/runtime.manifest.ts") {
+        throw new Error("Built manifest paths are invalid.");
+    }
+    await access(join(buildDirectory, manifest.entrypoint));
+    await access(join(buildDirectory, manifest.containerEntrypoint));
+    const runtimeManifest = await readFile(join(buildDirectory, manifest.runtimeManifestFile), "utf8");
+    if (!runtimeManifest.includes(`manifestGraphHash = ${JSON.stringify(graphHash)}`)) {
+        throw new Error("Built runtime manifest hash does not match the graph.");
+    }
+    return { graphHash, manifest };
+}
+//# sourceMappingURL=start-built.js.map

package/dist/commands/start-built.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-built.js","sourceRoot":"","sources":["../../src/commands/start-built.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAyB,MAAM,eAAe,CAAC;AAcxF,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,cAAsB;IAEtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CACtB,MAAM,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,wBAAwB,CAAC,EAAE,MAAM,CAAC,CACnD,CAAC;IACtB,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,MAAM,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAC7C,CAAC;IACnB,IACE,KAAK,CAAC,eAAe,KAAK,aAAa;QACvC,QAAQ,CAAC,eAAe,KAAK,gBAAgB;QAC7C,QAAQ,CAAC,YAAY,KAAK,aAAa;QACvC,QAAQ,CAAC,eAAe,KAAK,gBAAgB;QAC7C,QAAQ,CAAC,gBAAgB,KAAK,iBAAiB,EAC/C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,QAAQ,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IACD,IACE,QAAQ,CAAC,UAAU,KAAK,iBAAiB;QACzC,QAAQ,CAAC,mBAAmB,KAAK,iBAAiB;QAClD,QAAQ,CAAC,mBAAmB,KAAK,4BAA4B,EAC7D,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IACxD,MAAM,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC;IACjE,MAAM,eAAe,GAAG,MAAM,QAAQ,CACpC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,mBAAmB,CAAC,EAClD,MAAM,CACP,CAAC;IACF,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,uBAAuB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACjC,CAAC"}

package/dist/commands/start.d.ts

@@ -0,0 +1,25 @@
+export interface StartOptions {
+    readonly projectRoot?: string;
+    readonly buildDirectory?: string;
+    readonly hostname?: string;
+    readonly port?: number;
+    readonly healthTimeoutMs?: number;
+    readonly stopTimeoutMs?: number;
+    readonly environment?: Readonly<Record<string, string | undefined>>;
+    readonly signal?: AbortSignal;
+    readonly fetch?: typeof fetch;
+    readonly spawn?: typeof Bun.spawn;
+}
+export interface StartedProject {
+    readonly projectRoot: string;
+    readonly buildDirectory: string;
+    readonly hostname: string;
+    readonly port: number;
+    readonly process: Bun.ReadableSubprocess;
+    readonly exited: Promise<number>;
+    readonly stop: () => Promise<void>;
+}
+/** Validates the built graph/manifest, waits for health/readiness, and owns shutdown. */
+export declare function startProject(options?: StartOptions): Promise<StartedProject>;
+export declare function runStart(options?: StartOptions): Promise<number>;
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,CAAC,KAAK,CAAC;CACnC;AACD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,kBAAkB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AACD,yFAAyF;AACzF,wBAAsB,YAAY,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CA+EtF;AACD,wBAAsB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1E"}