@relkit/cli 0.0.0

package/dist/commands/dev-activation.js

@@ -0,0 +1,163 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { hashGraph } from "@relkit/graph";
+import { createSupervisorDrain, startCandidate, verifyCandidate, } from "@relkit/supervisor";
+export async function activateCandidate(session, version, changedFiles) {
+    const token = session.stateMachine.requestSourceChange();
+    const controller = new AbortController();
+    session.controllers.add(controller);
+    const signal = AbortSignal.any([session.abortController.signal, controller.signal]);
+    let candidate;
+    try {
+        candidate = await startCandidate({
+            projectRoot: session.projectRoot,
+            token,
+            compile: session.options.compile,
+            port: 0,
+            signal,
+            ...(session.options.candidateHostname === undefined
+                ? {}
+                : { hostname: session.options.candidateHostname }),
+            ...(session.options.generatedDirectory === undefined
+                ? {}
+                : { generatedDirectory: session.options.generatedDirectory }),
+            ...(session.options.environment === undefined
+                ? {}
+                : { environment: session.options.environment }),
+            ...(session.options.maxStartupOutputBytes === undefined
+                ? {}
+                : { maxStartupOutputBytes: session.options.maxStartupOutputBytes }),
+            ...(session.options.candidateStopTimeoutMs === undefined
+                ? {}
+                : { stopTimeoutMs: session.options.candidateStopTimeoutMs }),
+            logger: (event) => session.log({
+                level: event.level,
+                event: event.event,
+                fields: {
+                    directory: event.directory,
+                    ...(event.stream === undefined ? {} : { stream: event.stream }),
+                    ...(event.output === undefined ? {} : { output: event.output }),
+                    ...(event.fields ?? {}),
+                },
+            }),
+        });
+        if (!session.stateMachine.compileSucceeded(token) ||
+            !session.stateMachine.startSucceeded(token)) {
+            await candidate.dispose();
+            return false;
+        }
+        const graphHash = await resolveGraphHash(session, candidate);
+        session.hashes.set(token.generationToken, graphHash);
+        await verifyCandidate({
+            candidate,
+            graphHash,
+            signal,
+            ...(session.options.healthTimeoutMs === undefined
+                ? {}
+                : { healthTimeoutMs: session.options.healthTimeoutMs }),
+        });
+        if (!session.stateMachine.verificationSucceeded(token)) {
+            await candidate.dispose();
+            return false;
+        }
+        if (session.isStopping) {
+            await candidate.dispose();
+            return false;
+        }
+        const previous = session.active;
+        const candidateKey = tokenKey(candidate.token);
+        session.drains.set(candidateKey, createSupervisorDrain({
+            token: candidate.token,
+            candidate,
+            ...(session.options.drainTimeoutMs === undefined
+                ? {}
+                : { deadlineMs: session.options.drainTimeoutMs }),
+        }));
+        if (!session.proxy.compareAndSwitch(previous?.token, candidate)) {
+            session.stateMachine.switchFailed(token, "The stable proxy target changed.");
+            session.drains.delete(candidateKey);
+            await candidate.dispose();
+            return false;
+        }
+        session.stateMachine.switchSucceeded(token);
+        session.active = candidate;
+        session.activeGraphHash = graphHash;
+        watchCandidate(session, candidate);
+        if (previous !== undefined)
+            await session.drain(previous, token);
+        session.log({
+            level: "info",
+            event: "dev.generation.active",
+            fields: { version, changedFiles: changedFiles.length },
+        });
+        return true;
+    }
+    catch (error) {
+        await candidate?.dispose().catch(() => undefined);
+        session.drains.delete(tokenKey(token));
+        failState(session, token, error);
+        session.log({
+            level: "error",
+            event: "dev.generation.failed",
+            fields: { message: errorMessage(error) },
+        });
+        return false;
+    }
+    finally {
+        session.controllers.delete(controller);
+    }
+}
+async function resolveGraphHash(session, candidate) {
+    const value = session.options.graphHash;
+    const graphHash = value === undefined
+        ? hashGraph(JSON.parse(await readFile(join(candidate.directory, "application.graph.json"), "utf8")))
+        : typeof value === "function"
+            ? await value(candidate)
+            : value;
+    if (typeof graphHash !== "string" || graphHash.trim() === "")
+        throw new TypeError("Development candidates require a graph hash.");
+    return graphHash;
+}
+export async function drainCandidate(session, previous, activeToken) {
+    const key = tokenKey(previous.token);
+    const drain = session.drains.get(key) ??
+        createSupervisorDrain({
+            token: previous.token,
+            candidate: previous,
+            ...(session.options.drainTimeoutMs === undefined
+                ? {}
+                : { deadlineMs: session.options.drainTimeoutMs }),
+        });
+    session.drains.set(key, drain);
+    const report = await drain.drain();
+    session.drains.delete(key);
+    if (report.outcome === "drained")
+        session.stateMachine.drainSucceeded(activeToken);
+    else
+        session.stateMachine.drainFailed(activeToken, report.outcome);
+}
+function watchCandidate(session, candidate) {
+    void candidate.exited.then((exitCode) => {
+        if (candidate !== session.active || session.isStopping)
+            return;
+        void session.stop(new Error(`Backend generation exited with code ${exitCode}.`));
+    });
+}
+function failState(session, token, error) {
+    const state = session.stateMachine.state;
+    if (state === "compiling-candidate")
+        session.stateMachine.compileFailed(token, error);
+    else if (state === "starting-candidate")
+        session.stateMachine.startFailed(token, error);
+    else if (state === "verifying-hash-and-readiness")
+        session.stateMachine.verificationFailed(token, error);
+    else if (state === "switching")
+        session.stateMachine.switchFailed(token, error);
+}
+function tokenKey(token) {
+    return `${token.sourceToken}:${token.generationToken}`;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=dev-activation.js.map

package/dist/commands/dev-activation.js.map

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

package/dist/commands/dev-inspector.d.ts

@@ -0,0 +1,14 @@
+import type { DevInspectorOptions } from "./dev-process.js";
+/** Returns the source inspector for a checkout, or the packaged inspector for installs. */
+export declare function defaultInspectorOptions(inspectorPort?: number): DevInspectorOptions;
+export declare function configuredInspectorOptions(projectRoot: string, inspectorPort?: number, source?: Readonly<Record<string, string | undefined>>): Promise<DevInspectorOptions>;
+export declare function developmentPorts(projectRoot: string, backendPort?: number, inspectorPort?: number, source?: Readonly<Record<string, string | undefined>>): Promise<{
+    readonly backend: number;
+    readonly inspector: DevInspectorOptions;
+}>;
+export declare function inspectorRoot(): string;
+export declare function resolveInspectorInstallation(baseDirectory?: string, source?: Readonly<Record<string, string | undefined>>): {
+    readonly root: string;
+    readonly command: readonly string[];
+};
+//# sourceMappingURL=dev-inspector.d.ts.map

package/dist/commands/dev-inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-inspector.d.ts","sourceRoot":"","sources":["../../src/commands/dev-inspector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAOnF;AAED,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,EACtB,MAAM,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GACjE,OAAO,CAAC,mBAAmB,CAAC,CAG9B;AAED,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,MAAM,EACtB,MAAM,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GACjE,OAAO,CAAC;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAoBhF;AAED,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,4BAA4B,CAC1C,aAAa,GAAE,MAAwB,EACvC,MAAM,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GACjE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAShE"}

package/dist/commands/dev-inspector.js

@@ -0,0 +1,56 @@
+import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { loadConfig } from "@relkit/compiler";
+import { resolveApplicationPort, resolveInspectorPort } from "./ports.js";
+/** Returns the source inspector for a checkout, or the packaged inspector for installs. */
+export function defaultInspectorOptions(inspectorPort) {
+    const installation = resolveInspectorInstallation();
+    return {
+        command: installation.command,
+        cwd: installation.root,
+        ...(inspectorPort === undefined ? {} : { port: inspectorPort }),
+    };
+}
+export async function configuredInspectorOptions(projectRoot, inspectorPort, source = process.env) {
+    const configured = await developmentPorts(projectRoot, undefined, inspectorPort, source);
+    return configured.inspector;
+}
+export async function developmentPorts(projectRoot, backendPort, inspectorPort, source = process.env) {
+    const configPath = join(projectRoot, "relkit.config.ts");
+    const loaded = (await import(`${pathToFileURL(configPath).href}?relkit_dev=${Date.now()}`));
+    const config = loadConfig(loaded.default ?? loaded, projectRoot);
+    return {
+        backend: resolveApplicationPort({
+            ...(backendPort === undefined ? {} : { flag: backendPort }),
+            source,
+            configured: config.server.port,
+        }),
+        inspector: defaultInspectorOptions(resolveInspectorPort({
+            ...(inspectorPort === undefined ? {} : { flag: inspectorPort }),
+            source,
+            configured: config.inspector.port,
+        })),
+    };
+}
+export function inspectorRoot() {
+    return resolveInspectorInstallation().root;
+}
+export function resolveInspectorInstallation(baseDirectory = import.meta.dir, source = process.env) {
+    const configured = source.RELKIT_INSPECTOR_ROOT;
+    if (configured !== undefined)
+        return sourceInstallation(configured);
+    const workspace = resolve(baseDirectory, "../../../../apps/inspector");
+    if (existsSync(join(workspace, "package.json")))
+        return sourceInstallation(workspace);
+    const packaged = resolve(baseDirectory, "../inspector");
+    if (existsSync(join(packaged, "server.js")))
+        return { root: packaged, command: ["node", "server.js"] };
+    throw new Error("The packaged RELKIT inspector is missing. Reinstall @relkit/cli.");
+}
+function sourceInstallation(root) {
+    if (!existsSync(join(root, "package.json")))
+        throw new Error(`RELKIT_INSPECTOR_ROOT does not contain an inspector app: ${root}`);
+    return { root, command: [process.execPath, "run", "dev"] };
+}
+//# sourceMappingURL=dev-inspector.js.map

package/dist/commands/dev-inspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-inspector.js","sourceRoot":"","sources":["../../src/commands/dev-inspector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE1E,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CAAC,aAAsB;IAC5D,MAAM,YAAY,GAAG,4BAA4B,EAAE,CAAC;IACpD,OAAO;QACL,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,GAAG,EAAE,YAAY,CAAC,IAAI;QACtB,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;KAChE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,WAAmB,EACnB,aAAsB,EACtB,SAAuD,OAAO,CAAC,GAAG;IAElE,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;IACzF,OAAO,UAAU,CAAC,SAAS,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,WAAoB,EACpB,aAAsB,EACtB,SAAuD,OAAO,CAAC,GAAG;IAElE,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC,IAAI,eAAe,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAEzF,CAAC;IACF,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,EAAE,WAAW,CAAC,CAAC;IACjE,OAAO;QACL,OAAO,EAAE,sBAAsB,CAAC;YAC9B,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YAC3D,MAAM;YACN,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;SAC/B,CAAC;QACF,SAAS,EAAE,uBAAuB,CAChC,oBAAoB,CAAC;YACnB,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;YAC/D,MAAM;YACN,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI;SAClC,CAAC,CACH;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,4BAA4B,EAAE,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,gBAAwB,MAAM,CAAC,IAAI,CAAC,GAAG,EACvC,SAAuD,OAAO,CAAC,GAAG;IAElE,MAAM,UAAU,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAChD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,EAAE,4BAA4B,CAAC,CAAC;IACvE,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAAE,OAAO,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACtF,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IACxD,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACzC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC;IAC5D,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IAItC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,4DAA4D,IAAI,EAAE,CAAC,CAAC;IACtF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;AAC7D,CAAC"}

package/dist/commands/dev-logger.d.ts

@@ -0,0 +1,3 @@
+import type { DevLog, DevOptions } from "./dev.js";
+export declare function createDevLogger(options: DevOptions): DevLog;
+//# sourceMappingURL=dev-logger.d.ts.map

package/dist/commands/dev-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-logger.d.ts","sourceRoot":"","sources":["../../src/commands/dev-logger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAe,UAAU,EAAE,MAAM,UAAU,CAAC;AAEhE,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAuC3D"}

package/dist/commands/dev-logger.js

@@ -0,0 +1,71 @@
+import { Effect } from "effect";
+import { admitObservabilityRecord, OBSERVABILITY_MODEL_VERSION } from "@relkit/observability";
+import { createLoggerLayer } from "@relkit/runtime-effect";
+export function createDevLogger(options) {
+    const human = { write: (line) => process.stderr.write(`${line}\n`) };
+    const loggerOptions = {
+        component: "cli.dev",
+        human: options.logger?.human ?? human,
+        json: options.logger?.json ?? false,
+        ...(options.logger?.minimumLevel === undefined
+            ? {}
+            : { minimumLevel: options.logger.minimumLevel }),
+        ...(options.logger?.collector === undefined ? {} : { collector: options.logger.collector }),
+        ...(options.logger?.redact === undefined ? {} : { redact: options.logger.redact }),
+    };
+    const layer = createLoggerLayer(loggerOptions);
+    const jsonLayer = createLoggerLayer({ ...loggerOptions, human: false });
+    return (event) => {
+        try {
+            const candidate = candidateOutput(event, options);
+            const safeEvent = candidate?.event ?? event;
+            options.onLog?.(safeEvent);
+            if (candidate !== undefined) {
+                writeCandidateOutput(candidate, options);
+                if (options.logger?.json === undefined || options.logger.json === false)
+                    return;
+            }
+            const effect = safeEvent.level === "error"
+                ? Effect.logError(safeEvent.event)
+                : safeEvent.level === "warn"
+                    ? Effect.logWarning(safeEvent.event)
+                    : Effect.logInfo(safeEvent.event);
+            Effect.runSync(effect.pipe(Effect.annotateLogs(safeEvent.fields ?? {}), Effect.provide(candidate === undefined ? layer : jsonLayer)));
+        }
+        catch {
+            // Logging must not change lifecycle cleanup.
+        }
+    };
+}
+function candidateOutput(event, options) {
+    if (event.event !== "candidate.startup-output" || typeof event.fields?.output !== "string")
+        return undefined;
+    const record = {
+        version: OBSERVABILITY_MODEL_VERSION,
+        signal: "log",
+        timestamp: new Date().toISOString(),
+        level: event.level,
+        component: "cli.dev",
+        message: event.fields.output,
+        fields: { stream: String(event.fields.stream ?? "stdout") },
+    };
+    const admitted = admitObservabilityRecord(options.logger?.redact?.(record) ?? record);
+    if (admitted?.signal !== "log")
+        throw new TypeError("Candidate output redaction failed.");
+    return {
+        event: { ...event, fields: { ...event.fields, output: admitted.message } },
+        output: admitted.message,
+        record: admitted,
+    };
+}
+function writeCandidateOutput(candidate, options) {
+    if (options.logger?.human === false)
+        return;
+    if (options.logger?.human !== undefined) {
+        options.logger.human.write(candidate.output.trimEnd(), candidate.record);
+        return;
+    }
+    const stream = candidate.record.fields.stream === "stderr" ? process.stderr : process.stdout;
+    stream.write(candidate.output);
+}
+//# sourceMappingURL=dev-logger.js.map

package/dist/commands/dev-logger.js.map

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

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

@@ -0,0 +1,18 @@
+import type { DevLog } from "./dev.js";
+export interface DevInspectorOptions {
+    readonly command: readonly string[];
+    readonly hostname?: string;
+    readonly port?: number;
+    readonly cwd?: string;
+    readonly environment?: Readonly<Record<string, string | undefined>>;
+    readonly maxOutputBytes?: number;
+    readonly stopTimeoutMs?: number;
+}
+export interface DevInspector {
+    readonly port: number;
+    readonly process: Bun.ReadableSubprocess;
+    readonly output: Promise<void>;
+    readonly stop: () => Promise<void>;
+}
+export declare function startInspector(options: DevInspectorOptions, backendPort: number, log: DevLog, spawn?: typeof Bun.spawn): Promise<DevInspector>;
+//# sourceMappingURL=dev-process.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dev-process.d.ts","sourceRoot":"","sources":["../../src/commands/dev-process.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,MAAM,EAAE,MAAM,UAAU,CAAC;AAGpD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,kBAAkB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,mBAAmB,EAC5B,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,OAAO,GAAG,CAAC,KAAiB,GAClC,OAAO,CAAC,YAAY,CAAC,CAsCvB"}

package/dist/commands/dev-process.js

@@ -0,0 +1,100 @@
+import { assertPortAvailable } from "./port-availability.js";
+export async function startInspector(options, backendPort, log, spawn = Bun.spawn) {
+    if (options.command.length === 0)
+        throw new TypeError("Inspector command cannot be empty.");
+    const hostname = options.hostname ?? "127.0.0.1";
+    const port = await resolvePort(options.port ?? 3210, hostname);
+    const stopTimeoutMs = options.stopTimeoutMs ?? 1_000;
+    if (!Number.isSafeInteger(stopTimeoutMs) || stopTimeoutMs < 0)
+        throw new RangeError("Inspector stop timeout must be a non-negative safe integer.");
+    const environment = {
+        ...Object.fromEntries(Object.entries(process.env).filter((entry) => entry[1] !== undefined)),
+        ...Object.fromEntries(Object.entries(options.environment ?? {}).filter((entry) => entry[1] !== undefined)),
+        PORT: String(port),
+        HOSTNAME: hostname,
+        RELKIT_INSPECTOR_PORT: String(port),
+        RELKIT_BACKEND_PORT: String(backendPort),
+        RELKIT_BACKEND_URL: `http://${hostname}:${backendPort}`,
+        NEXT_PUBLIC_RELKIT_BACKEND_URL: `http://${hostname}:${port}/_relkit/backend`,
+    };
+    const child = spawn([...options.command], {
+        ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
+        env: environment,
+        stdin: "ignore",
+        stdout: "pipe",
+        stderr: "pipe",
+    });
+    const output = Promise.all([
+        capture(child.stdout, "stdout", options.maxOutputBytes ?? 8 * 1024, log),
+        capture(child.stderr, "stderr", options.maxOutputBytes ?? 8 * 1024, log),
+    ]).then(() => undefined);
+    const stop = createStopper(child, stopTimeoutMs);
+    return Object.freeze({ port, process: child, output, stop });
+}
+async function resolvePort(port, hostname) {
+    if (!Number.isSafeInteger(port) || port < 0 || port > 65_535)
+        throw new RangeError("Inspector port must be between 0 and 65535.");
+    if (port !== 0) {
+        await assertPortAvailable(port, hostname, "--inspector-port");
+        return port;
+    }
+    const server = Bun.serve({ hostname, port: 0, fetch: () => new Response() });
+    const allocated = server.port;
+    await server.stop(true);
+    if (allocated === undefined)
+        throw new Error("Bun did not allocate an inspector port.");
+    return allocated;
+}
+async function capture(stream, channel, limit, log) {
+    const reader = stream.getReader();
+    let remaining = limit;
+    try {
+        while (true) {
+            const next = await reader.read();
+            if (next.done)
+                return;
+            const bytes = next.value.subarray(0, Math.max(0, remaining));
+            if (bytes.byteLength > 0) {
+                remaining -= bytes.byteLength;
+                log({
+                    level: channel === "stderr" ? "warn" : "info",
+                    event: "inspector.output",
+                    fields: { channel, output: new TextDecoder().decode(bytes) },
+                });
+            }
+        }
+    }
+    catch (error) {
+        log({
+            level: "warn",
+            event: "inspector.output.failed",
+            fields: { message: errorMessage(error) },
+        });
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+function createStopper(child, timeoutMs) {
+    let stopping;
+    return () => {
+        stopping ??= stopChild(child, timeoutMs);
+        return stopping;
+    };
+}
+async function stopChild(child, timeoutMs) {
+    if (child.exitCode === null)
+        child.kill("SIGTERM");
+    const exited = await Promise.race([
+        child.exited.then(() => true),
+        new Promise((resolve) => setTimeout(() => resolve(false), timeoutMs)),
+    ]);
+    if (!exited && child.exitCode === null) {
+        child.kill("SIGKILL");
+        await child.exited;
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=dev-process.js.map

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

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

package/dist/commands/dev-ready.d.ts

@@ -0,0 +1,3 @@
+import type { DevLog } from "./dev.js";
+export declare function logDevReady(log: DevLog, hostname: string, backendPort: number, inspectorPort?: number): void;
+//# sourceMappingURL=dev-ready.d.ts.map

package/dist/commands/dev-ready.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-ready.d.ts","sourceRoot":"","sources":["../../src/commands/dev-ready.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAYN"}

package/dist/commands/dev-ready.js

@@ -0,0 +1,14 @@
+export function logDevReady(log, hostname, backendPort, inspectorPort) {
+    const backend = `http://${hostname}:${backendPort}`;
+    log({
+        level: "info",
+        event: "dev.ready",
+        fields: {
+            backend,
+            openapi: `${backend}/_relkit/v1/openapi.json`,
+            apiReference: `${backend}/_relkit/v1/api-reference`,
+            ...(inspectorPort === undefined ? {} : { inspector: `http://127.0.0.1:${inspectorPort}` }),
+        },
+    });
+}
+//# sourceMappingURL=dev-ready.js.map

package/dist/commands/dev-ready.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-ready.js","sourceRoot":"","sources":["../../src/commands/dev-ready.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,QAAgB,EAChB,WAAmB,EACnB,aAAsB;IAEtB,MAAM,OAAO,GAAG,UAAU,QAAQ,IAAI,WAAW,EAAE,CAAC;IACpD,GAAG,CAAC;QACF,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE;YACN,OAAO;YACP,OAAO,EAAE,GAAG,OAAO,0BAA0B;YAC7C,YAAY,EAAE,GAAG,OAAO,2BAA2B;YACnD,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,oBAAoB,aAAa,EAAE,EAAE,CAAC;SAC3F;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/dev-session.d.ts

@@ -0,0 +1,49 @@
+import { type StartedCandidate, type SupervisorCandidateToken, type SupervisorGenerationDrain } from "@relkit/supervisor";
+import { type DevInspector } from "./dev-process.js";
+import type { DevLog, DevOptions } from "./dev.js";
+/** Owns the stable development proxy and every child generation it starts. */
+export declare class DevSession {
+    readonly stateMachine: import("@relkit/supervisor").SupervisorStateMachine;
+    readonly proxy: import("@relkit/supervisor").SupervisorProxy;
+    readonly projectRoot: string;
+    readonly options: DevOptions;
+    readonly abortController: AbortController;
+    readonly hashes: Map<number, string>;
+    readonly drains: Map<string, SupervisorGenerationDrain>;
+    readonly controllers: Set<AbortController>;
+    readonly log: DevLog;
+    readonly observability: import("@relkit/supervisor").SupervisorObservability;
+    private readonly shutdownPromise;
+    private resolveShutdown;
+    private activationTail;
+    private activeCandidate;
+    private activeHash;
+    private inspector;
+    private removeSignals;
+    private latestVersion;
+    private stopPromise;
+    private started;
+    private stopping;
+    constructor(options: DevOptions);
+    get backendPort(): number;
+    get inspectorPort(): number | undefined;
+    get activeTarget(): import("@relkit/supervisor").ActiveSupervisorProxyTarget | undefined;
+    start(): Promise<this>;
+    /** Queues one source version; newer versions obsolete queued work. */
+    activate(version?: number, changedFiles?: readonly string[]): Promise<boolean>;
+    notifySourceChange(version: number, changedFiles?: readonly string[]): Promise<boolean>;
+    waitForShutdown(): Promise<void>;
+    stop(reason?: unknown): Promise<void>;
+    drain(previous: StartedCandidate, activeToken: SupervisorCandidateToken): Promise<void>;
+    get active(): StartedCandidate | undefined;
+    set active(candidate: StartedCandidate | undefined);
+    get activeGraphHash(): string | undefined;
+    set activeGraphHash(value: string | undefined);
+    get isStopping(): boolean;
+    markStopping(): void;
+    get pendingActivations(): Promise<boolean>;
+    get inspectorChild(): DevInspector | undefined;
+    clearSignals(): void;
+    resolveShutdownPromise(): void;
+}
+//# sourceMappingURL=dev-session.d.ts.map

package/dist/commands/dev-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-session.d.ts","sourceRoot":"","sources":["../../src/commands/dev-session.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAQnD,8EAA8E;AAC9E,qBAAa,UAAU;IACrB,QAAQ,CAAC,YAAY,sDAAC;IACtB,QAAQ,CAAC,KAAK,+CAAC;IACf,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,eAAe,kBAAyB;IACjD,QAAQ,CAAC,MAAM,sBAA6B;IAC5C,QAAQ,CAAC,MAAM,yCAAgD;IAC/D,QAAQ,CAAC,WAAW,uBAA8B;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,aAAa,uDAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgB;IAChD,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,cAAc,CAA2C;IACjE,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,UAAU;IAkC/B,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAED,IAAI,YAAY,yEAEf;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC5B,sEAAsE;IACtE,QAAQ,CACN,OAAO,SAAyB,EAChC,YAAY,GAAE,SAAS,MAAM,EAAO,GACnC,OAAO,CAAC,OAAO,CAAC;IAgBnB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,GAAE,SAAS,MAAM,EAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3F,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAIhC,IAAI,CAAC,MAAM,GAAE,OAAmD,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1E,KAAK,CAAC,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7F,IAAI,MAAM,IAAI,gBAAgB,GAAG,SAAS,CAEzC;IAED,IAAI,MAAM,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS,EAEjD;IAED,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAExC;IAED,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAE5C;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,YAAY,IAAI,IAAI;IAGpB,IAAI,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAEzC;IAED,IAAI,cAAc,IAAI,YAAY,GAAG,SAAS,CAE7C;IACD,YAAY,IAAI,IAAI;IAKpB,sBAAsB,IAAI,IAAI;CAG/B"}