@relkit/supervisor 0.0.0

package/dist/proxy.js

@@ -0,0 +1,125 @@
+import { drainResponse, forwardProxyRequest } from "./proxy-forward.js";
+import { validateSupervisorToken } from "./state-machine-telemetry.js";
+export { forwardProxyRequest } from "./proxy-forward.js";
+export const DEFAULT_SUPERVISOR_HOSTNAME = "127.0.0.1";
+export const DEFAULT_SUPERVISOR_PORT = 3_000;
+/** Stable development listener that synchronously selects one active target per request. */
+export class SupervisorProxy {
+    hostname;
+    configuredPort;
+    targetHostname;
+    fetcher;
+    track;
+    server;
+    stopping;
+    target;
+    constructor(options = {}) {
+        this.hostname = options.hostname ?? DEFAULT_SUPERVISOR_HOSTNAME;
+        this.configuredPort = validatePort(options.port ?? DEFAULT_SUPERVISOR_PORT, true);
+        this.targetHostname = options.targetHostname ?? DEFAULT_SUPERVISOR_HOSTNAME;
+        validateHostname(this.hostname, "hostname");
+        validateHostname(this.targetHostname, "targetHostname");
+        this.fetcher = options.fetch ?? fetch;
+        this.track = options.track;
+    }
+    get port() {
+        return this.server?.port ?? this.configuredPort;
+    }
+    get url() {
+        return this.server?.url;
+    }
+    get activeTarget() {
+        return this.target;
+    }
+    async listen() {
+        if (this.server !== undefined)
+            return this;
+        if (this.stopping !== undefined)
+            await this.stopping;
+        this.server = Bun.serve({
+            hostname: this.hostname,
+            port: this.configuredPort,
+            fetch: (request) => this.handle(request),
+        });
+        return this;
+    }
+    /** Replaces the target only when the expected active token still matches. */
+    compareAndSwitch(expected, next) {
+        if (this.stopping !== undefined)
+            return false;
+        const current = this.target;
+        if (!sameToken(current?.token, expected))
+            return false;
+        const normalized = normalizeTarget(next, this.targetHostname);
+        if (current !== undefined &&
+            (normalized.token.sourceToken <= current.token.sourceToken ||
+                normalized.token.generationToken <= current.token.generationToken))
+            return false;
+        this.target = normalized;
+        return true;
+    }
+    switchTarget(next, expected = this.target?.token) {
+        return this.compareAndSwitch(expected, next);
+    }
+    /** Reads the active reference before awaiting, so switched traffic cannot select a retired target. */
+    handle(request) {
+        const target = this.target;
+        if (target === undefined)
+            return Promise.resolve(new Response(JSON.stringify({ error: "No active RelKit generation." }), {
+                status: 503,
+                headers: { "cache-control": "no-store", "content-type": "application/json" },
+            }));
+        const lease = this.track?.(target.token);
+        if (this.track !== undefined && lease === undefined)
+            return Promise.resolve(drainResponse());
+        try {
+            return forwardProxyRequest(request, target, this.fetcher, lease).finally(() => lease?.release());
+        }
+        catch (error) {
+            lease?.release();
+            return Promise.reject(error);
+        }
+    }
+    stop() {
+        this.target = undefined;
+        const server = this.server;
+        this.server = undefined;
+        if (server === undefined)
+            return this.stopping ?? Promise.resolve();
+        this.stopping = server.stop().finally(() => {
+            this.stopping = undefined;
+        });
+        return this.stopping;
+    }
+}
+export function createSupervisorProxy(options = {}) {
+    return new SupervisorProxy(options);
+}
+function normalizeTarget(target, defaultHostname) {
+    validateSupervisorToken(target.token);
+    const port = validatePort(target.port, false);
+    const hostname = target.hostname ?? defaultHostname;
+    validateHostname(hostname, "target hostname");
+    return Object.freeze({
+        token: Object.freeze({ ...target.token }),
+        hostname,
+        port,
+    });
+}
+function sameToken(current, expected) {
+    return current === undefined
+        ? expected === undefined
+        : expected !== undefined &&
+            current.sourceToken === expected.sourceToken &&
+            current.generationToken === expected.generationToken;
+}
+function validatePort(port, allowZero) {
+    if (!Number.isSafeInteger(port) || port < (allowZero ? 0 : 1) || port > 65_535)
+        throw new RangeError("Supervisor proxy ports must be between 1 and 65535.");
+    return port;
+}
+function validateHostname(hostname, name) {
+    if (hostname.trim() === "" || /[\s/:]/.test(hostname))
+        throw new TypeError(`Supervisor proxy ${name} must be a hostname.`);
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

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

package/dist/state-machine-telemetry.d.ts

@@ -0,0 +1,14 @@
+import type { SupervisorCandidateToken, SupervisorOutcomeName, SupervisorPhase, SupervisorState, SupervisorTelemetry, SupervisorTelemetryListener } from "./state-machine-types.js";
+export declare class SupervisorTelemetryLog {
+    private sequence;
+    private readonly events;
+    private readonly listeners;
+    constructor(listener?: SupervisorTelemetryListener);
+    get records(): readonly SupervisorTelemetry[];
+    subscribe(listener: SupervisorTelemetryListener): () => void;
+    transition(from: SupervisorState, to: SupervisorState, token: SupervisorCandidateToken): void;
+    outcome(phase: SupervisorPhase, outcome: SupervisorOutcomeName, token: SupervisorCandidateToken, reason?: unknown, returnState?: SupervisorState, previousGeneration?: SupervisorCandidateToken): void;
+    private emit;
+}
+export declare function validateSupervisorToken(token: SupervisorCandidateToken): void;
+//# sourceMappingURL=state-machine-telemetry.d.ts.map

package/dist/state-machine-telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine-telemetry.d.ts","sourceRoot":"","sources":["../src/state-machine-telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EAErB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,0BAA0B,CAAC;AAElC,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;gBAExD,QAAQ,CAAC,EAAE,2BAA2B;IAIlD,IAAI,OAAO,IAAI,SAAS,mBAAmB,EAAE,CAE5C;IAED,SAAS,CAAC,QAAQ,EAAE,2BAA2B,GAAG,MAAM,IAAI;IAK5D,UAAU,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,wBAAwB,GAAG,IAAI;IAW7F,OAAO,CACL,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,wBAAwB,EAC/B,MAAM,CAAC,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,eAAe,EAC7B,kBAAkB,CAAC,EAAE,wBAAwB,GAC5C,IAAI;IAgBP,OAAO,CAAC,IAAI;CAUb;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAO7E"}

package/dist/state-machine-telemetry.js

@@ -0,0 +1,79 @@
+export class SupervisorTelemetryLog {
+    sequence = 0;
+    events = [];
+    listeners = new Set();
+    constructor(listener) {
+        if (listener !== undefined)
+            this.listeners.add(listener);
+    }
+    get records() {
+        return this.events.slice();
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    transition(from, to, token) {
+        this.emit({
+            type: "transition",
+            sequence: ++this.sequence,
+            from,
+            to,
+            sourceToken: token.sourceToken,
+            generationToken: token.generationToken,
+        });
+    }
+    outcome(phase, outcome, token, reason, returnState, previousGeneration) {
+        const error = reason === undefined ? undefined : errorDetails(reason);
+        const event = {
+            type: "outcome",
+            sequence: ++this.sequence,
+            phase,
+            outcome,
+            sourceToken: token.sourceToken,
+            generationToken: token.generationToken,
+            ...(previousGeneration === undefined ? {} : { previousGeneration }),
+            ...(returnState === undefined ? {} : { returnState }),
+            ...(error === undefined ? {} : { error }),
+        };
+        this.emit(event);
+    }
+    emit(event) {
+        this.events.push(Object.freeze(event));
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Telemetry consumers must not change lifecycle behavior.
+            }
+        }
+    }
+}
+export function validateSupervisorToken(token) {
+    if (!Number.isSafeInteger(token.sourceToken) || token.sourceToken < 1) {
+        throw new TypeError("Supervisor source tokens must be positive safe integers.");
+    }
+    if (!Number.isSafeInteger(token.generationToken) || token.generationToken < 1) {
+        throw new TypeError("Supervisor generation tokens must be positive safe integers.");
+    }
+}
+function errorDetails(reason) {
+    if (reason instanceof Error) {
+        const code = "code" in reason && typeof reason.code === "string" ? reason.code : undefined;
+        return { ...(code === undefined ? {} : { code }), message: reason.message };
+    }
+    if (typeof reason === "string")
+        return { message: reason };
+    if (typeof reason === "object" && reason !== null && "message" in reason) {
+        const value = reason;
+        if (typeof value.message === "string") {
+            return {
+                ...(typeof value.code === "string" ? { code: value.code } : {}),
+                message: value.message,
+            };
+        }
+    }
+    return { message: "Candidate lifecycle operation failed." };
+}
+//# sourceMappingURL=state-machine-telemetry.js.map

package/dist/state-machine-telemetry.js.map

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

package/dist/state-machine-types.d.ts

@@ -0,0 +1,53 @@
+export declare const SUPERVISOR_STATES: readonly ["idle", "compiling-candidate", "starting-candidate", "verifying-hash-and-readiness", "switching", "draining-previous", "active"];
+export type SupervisorState = (typeof SUPERVISOR_STATES)[number];
+export type SupervisorPhase = "compile" | "start" | "verification" | "switch" | "drain";
+export type SupervisorOutcomeName = "compile-succeeded" | "compile-failed" | "start-succeeded" | "start-failed" | "verification-succeeded" | "verification-failed" | "switch-succeeded" | "switch-failed" | "drain-succeeded" | "drain-failed" | "candidate-stale";
+export interface SupervisorCandidateToken {
+    readonly sourceToken: number;
+    readonly generationToken: number;
+}
+export interface SupervisorTransitionTelemetry {
+    readonly type: "transition";
+    readonly sequence: number;
+    readonly from: SupervisorState;
+    readonly to: SupervisorState;
+    readonly sourceToken: number;
+    readonly generationToken: number;
+}
+export interface SupervisorOutcomeTelemetry {
+    readonly type: "outcome";
+    readonly sequence: number;
+    readonly phase: SupervisorPhase;
+    readonly outcome: SupervisorOutcomeName;
+    readonly sourceToken: number;
+    readonly generationToken: number;
+    readonly previousGeneration?: SupervisorCandidateToken;
+    readonly returnState?: SupervisorState;
+    readonly error?: {
+        readonly code?: string;
+        readonly message: string;
+    };
+}
+export type SupervisorTelemetry = SupervisorTransitionTelemetry | SupervisorOutcomeTelemetry;
+export type SupervisorTelemetryListener = (event: SupervisorTelemetry) => void;
+export interface SupervisorStateSnapshot {
+    readonly state: SupervisorState;
+    readonly sourceToken: number;
+    readonly generationToken: number;
+    readonly candidate: SupervisorCandidateToken | undefined;
+    readonly activeGeneration: SupervisorCandidateToken | undefined;
+    readonly previousGeneration: SupervisorCandidateToken | undefined;
+}
+export interface SupervisorStateMachineOptions {
+    readonly activeGeneration?: SupervisorCandidateToken;
+    readonly onTelemetry?: SupervisorTelemetryListener;
+}
+export type SupervisorCandidatePhase = Exclude<SupervisorPhase, "switch" | "drain">;
+export interface SupervisorCandidateStep {
+    readonly expected: SupervisorState;
+    readonly next: SupervisorState;
+    readonly success: SupervisorOutcomeName;
+    readonly failure: SupervisorOutcomeName;
+}
+export declare const SUPERVISOR_CANDIDATE_STEPS: Record<SupervisorCandidatePhase, SupervisorCandidateStep>;
+//# sourceMappingURL=state-machine-types.d.ts.map

package/dist/state-machine-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine-types.d.ts","sourceRoot":"","sources":["../src/state-machine-types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,4IAQpB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC;AACxF,MAAM,MAAM,qBAAqB,GAC7B,mBAAmB,GACnB,gBAAgB,GAChB,iBAAiB,GACjB,cAAc,GACd,wBAAwB,GACxB,qBAAqB,GACrB,kBAAkB,GAClB,eAAe,GACf,iBAAiB,GACjB,cAAc,GACd,iBAAiB,CAAC;AAEtB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AAED,MAAM,MAAM,mBAAmB,GAAG,6BAA6B,GAAG,0BAA0B,CAAC;AAC7F,MAAM,MAAM,2BAA2B,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAE/E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,wBAAwB,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,gBAAgB,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAChE,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,GAAG,SAAS,CAAC;CACnE;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,2BAA2B,CAAC;CACpD;AAED,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,eAAe,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC;AACpF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;CACzC;AACD,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,wBAAwB,EAAE,uBAAuB,CAoB9F,CAAC"}

package/dist/state-machine-types.js

@@ -0,0 +1,30 @@
+export const SUPERVISOR_STATES = [
+    "idle",
+    "compiling-candidate",
+    "starting-candidate",
+    "verifying-hash-and-readiness",
+    "switching",
+    "draining-previous",
+    "active",
+];
+export const SUPERVISOR_CANDIDATE_STEPS = {
+    compile: {
+        expected: "compiling-candidate",
+        next: "starting-candidate",
+        success: "compile-succeeded",
+        failure: "compile-failed",
+    },
+    start: {
+        expected: "starting-candidate",
+        next: "verifying-hash-and-readiness",
+        success: "start-succeeded",
+        failure: "start-failed",
+    },
+    verification: {
+        expected: "verifying-hash-and-readiness",
+        next: "switching",
+        success: "verification-succeeded",
+        failure: "verification-failed",
+    },
+};
+//# sourceMappingURL=state-machine-types.js.map

package/dist/state-machine-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine-types.js","sourceRoot":"","sources":["../src/state-machine-types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM;IACN,qBAAqB;IACrB,oBAAoB;IACpB,8BAA8B;IAC9B,WAAW;IACX,mBAAmB;IACnB,QAAQ;CACA,CAAC;AAmEX,MAAM,CAAC,MAAM,0BAA0B,GACrC;IACE,OAAO,EAAE;QACP,QAAQ,EAAE,qBAAqB;QAC/B,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,mBAAmB;QAC5B,OAAO,EAAE,gBAAgB;KAC1B;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,oBAAoB;QAC9B,IAAI,EAAE,8BAA8B;QACpC,OAAO,EAAE,iBAAiB;QAC1B,OAAO,EAAE,cAAc;KACxB;IACD,YAAY,EAAE;QACZ,QAAQ,EAAE,8BAA8B;QACxC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,wBAAwB;QACjC,OAAO,EAAE,qBAAqB;KAC/B;CACF,CAAC"}

package/dist/state-machine.d.ts

@@ -0,0 +1,36 @@
+export * from "./state-machine-types.js";
+import { type SupervisorCandidateToken, type SupervisorState, type SupervisorStateMachineOptions, type SupervisorStateSnapshot, type SupervisorTelemetry, type SupervisorTelemetryListener } from "./state-machine-types.js";
+/** Pure lifecycle state and token coordination for candidate activation. */
+export declare class SupervisorStateMachine {
+    private currentState;
+    private sourceSequence;
+    private generationSequence;
+    private candidate;
+    private activeGeneration;
+    private previousGeneration;
+    private readonly telemetryLog;
+    constructor(options?: SupervisorStateMachineOptions);
+    get state(): SupervisorState;
+    get sourceToken(): number;
+    get generationToken(): number;
+    get telemetry(): readonly SupervisorTelemetry[];
+    snapshot(): SupervisorStateSnapshot;
+    subscribe(listener: SupervisorTelemetryListener): () => void;
+    requestSourceChange(): SupervisorCandidateToken;
+    compileSucceeded(token: SupervisorCandidateToken): boolean;
+    compileFailed(token: SupervisorCandidateToken, reason: unknown): boolean;
+    startSucceeded(token: SupervisorCandidateToken): boolean;
+    startFailed(token: SupervisorCandidateToken, reason: unknown): boolean;
+    verificationSucceeded(token: SupervisorCandidateToken): boolean;
+    verificationFailed(token: SupervisorCandidateToken, reason: unknown): boolean;
+    switchSucceeded(token: SupervisorCandidateToken): boolean;
+    switchFailed(token: SupervisorCandidateToken, reason: unknown): boolean;
+    drainSucceeded(token: SupervisorCandidateToken): boolean;
+    drainFailed(token: SupervisorCandidateToken, reason: unknown): boolean;
+    private finishCandidate;
+    private finishDrain;
+    private check;
+    private transition;
+}
+export declare function createSupervisorStateMachine(options?: SupervisorStateMachineOptions): SupervisorStateMachine;
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,OAAO,EACL,KAAK,wBAAwB,EAI7B,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EACjC,MAAM,0BAA0B,CAAC;AAIlC,4EAA4E;AAC5E,qBAAa,sBAAsB;IACjC,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,SAAS,CAAuC;IACxD,OAAO,CAAC,gBAAgB,CAAuC;IAC/D,OAAO,CAAC,kBAAkB,CAAuC;IACjE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAE1C,OAAO,GAAE,6BAAkC;IAYvD,IAAI,KAAK,IAAI,eAAe,CAE3B;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,SAAS,IAAI,SAAS,mBAAmB,EAAE,CAE9C;IAED,QAAQ,IAAI,uBAAuB;IAWnC,SAAS,CAAC,QAAQ,EAAE,2BAA2B,GAAG,MAAM,IAAI;IAI5D,mBAAmB,IAAI,wBAAwB;IAU/C,gBAAgB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO;IAI1D,aAAa,CAAC,KAAK,EAAE,wBAAwB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO;IAIxE,cAAc,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO;IAIxD,WAAW,CAAC,KAAK,EAAE,wBAAwB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO;IAItE,qBAAqB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO;IAI/D,kBAAkB,CAAC,KAAK,EAAE,wBAAwB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO;IAI7E,eAAe,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO;IAWzD,YAAY,CAAC,KAAK,EAAE,wBAAwB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO;IAIvE,cAAc,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO;IAIxD,WAAW,CAAC,KAAK,EAAE,wBAAwB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO;IAItE,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,KAAK;IAuBb,OAAO,CAAC,UAAU;CAKnB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,CAAC,EAAE,6BAA6B,GACtC,sBAAsB,CAExB"}

package/dist/state-machine.js

@@ -0,0 +1,144 @@
+export * from "./state-machine-types.js";
+import {} from "./state-machine-types.js";
+import { SUPERVISOR_CANDIDATE_STEPS } from "./state-machine-types.js";
+import { SupervisorTelemetryLog, validateSupervisorToken } from "./state-machine-telemetry.js";
+/** Pure lifecycle state and token coordination for candidate activation. */
+export class SupervisorStateMachine {
+    currentState;
+    sourceSequence = 0;
+    generationSequence = 0;
+    candidate;
+    activeGeneration;
+    previousGeneration;
+    telemetryLog;
+    constructor(options = {}) {
+        const active = options.activeGeneration;
+        if (active !== undefined) {
+            validateSupervisorToken(active);
+            this.activeGeneration = Object.freeze({ ...active });
+            this.sourceSequence = active.sourceToken;
+            this.generationSequence = active.generationToken;
+        }
+        this.currentState = this.activeGeneration === undefined ? "idle" : "active";
+        this.telemetryLog = new SupervisorTelemetryLog(options.onTelemetry);
+    }
+    get state() {
+        return this.currentState;
+    }
+    get sourceToken() {
+        return this.sourceSequence;
+    }
+    get generationToken() {
+        return this.generationSequence;
+    }
+    get telemetry() {
+        return this.telemetryLog.records;
+    }
+    snapshot() {
+        return Object.freeze({
+            state: this.currentState,
+            sourceToken: this.sourceSequence,
+            generationToken: this.generationSequence,
+            candidate: this.candidate,
+            activeGeneration: this.activeGeneration,
+            previousGeneration: this.previousGeneration,
+        });
+    }
+    subscribe(listener) {
+        return this.telemetryLog.subscribe(listener);
+    }
+    requestSourceChange() {
+        const token = Object.freeze({
+            sourceToken: ++this.sourceSequence,
+            generationToken: ++this.generationSequence,
+        });
+        this.candidate = token;
+        this.transition("compiling-candidate", token);
+        return token;
+    }
+    compileSucceeded(token) {
+        return this.finishCandidate(token, "compile", true);
+    }
+    compileFailed(token, reason) {
+        return this.finishCandidate(token, "compile", false, reason);
+    }
+    startSucceeded(token) {
+        return this.finishCandidate(token, "start", true);
+    }
+    startFailed(token, reason) {
+        return this.finishCandidate(token, "start", false, reason);
+    }
+    verificationSucceeded(token) {
+        return this.finishCandidate(token, "verification", true);
+    }
+    verificationFailed(token, reason) {
+        return this.finishCandidate(token, "verification", false, reason);
+    }
+    switchSucceeded(token) {
+        if (!this.check(token, "switching", "switch"))
+            return false;
+        const previous = this.activeGeneration;
+        this.telemetryLog.outcome("switch", "switch-succeeded", token, undefined, undefined, previous);
+        this.activeGeneration = token;
+        this.candidate = undefined;
+        this.previousGeneration = previous;
+        this.transition(previous === undefined ? "active" : "draining-previous", token);
+        return true;
+    }
+    switchFailed(token, reason) {
+        return this.finishCandidate(token, "switch", false, reason);
+    }
+    drainSucceeded(token) {
+        return this.finishDrain(token, "drain-succeeded");
+    }
+    drainFailed(token, reason) {
+        return this.finishDrain(token, "drain-failed", reason);
+    }
+    finishCandidate(token, phase, success, reason) {
+        const step = phase === "switch" ? undefined : SUPERVISOR_CANDIDATE_STEPS[phase];
+        const expected = step?.expected ?? "switching";
+        if (!this.check(token, expected, phase))
+            return false;
+        const next = success
+            ? (step?.next ?? "active")
+            : this.activeGeneration === undefined
+                ? "idle"
+                : "active";
+        this.telemetryLog.outcome(phase, success ? (step?.success ?? "switch-succeeded") : (step?.failure ?? "switch-failed"), token, reason, success ? undefined : next);
+        if (!success)
+            this.candidate = undefined;
+        this.transition(next, token);
+        return true;
+    }
+    finishDrain(token, outcome, reason) {
+        if (!this.check(token, "draining-previous", "drain", "active"))
+            return false;
+        const previous = this.previousGeneration;
+        this.telemetryLog.outcome("drain", outcome, token, reason, undefined, previous);
+        this.previousGeneration = undefined;
+        this.transition("active", token);
+        return true;
+    }
+    check(token, expected, phase, owner = "candidate") {
+        validateSupervisorToken(token);
+        const current = owner === "candidate" ? this.candidate : this.activeGeneration;
+        if (current?.sourceToken !== token.sourceToken ||
+            current.generationToken !== token.generationToken) {
+            this.telemetryLog.outcome(phase, "candidate-stale", token);
+            return false;
+        }
+        if (this.currentState !== expected) {
+            throw new Error(`Supervisor cannot transition from ${this.currentState}; expected ${expected}.`);
+        }
+        return true;
+    }
+    transition(to, token) {
+        const from = this.currentState;
+        this.currentState = to;
+        this.telemetryLog.transition(from, to, token);
+    }
+}
+export function createSupervisorStateMachine(options) {
+    return new SupervisorStateMachine(options);
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/state-machine.js.map

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

package/dist/verification-http.d.ts

@@ -0,0 +1,4 @@
+import type { CandidateProbeResponse, CandidateVerificationOptions } from "./verification-types.js";
+/** Performs one bounded v1 probe without allowing a stalled backend to block activation. */
+export declare function requestProbe(options: CandidateVerificationOptions, path: string, deadline: number): Promise<CandidateProbeResponse | undefined>;
+//# sourceMappingURL=verification-http.d.ts.map

package/dist/verification-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-http.d.ts","sourceRoot":"","sources":["../src/verification-http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAGpG,4FAA4F;AAC5F,wBAAsB,YAAY,CAChC,OAAO,EAAE,4BAA4B,EACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAwC7C"}

package/dist/verification-http.js

@@ -0,0 +1,49 @@
+import { API_BASE_PATH } from "@relkit/contracts";
+import { CandidateVerificationError } from "./verification-types.js";
+/** Performs one bounded v1 probe without allowing a stalled backend to block activation. */
+export async function requestProbe(options, path, deadline) {
+    if (options.signal?.aborted)
+        throw options.signal.reason ?? new Error("Verification was aborted.");
+    const remaining = deadline - Date.now();
+    if (remaining <= 0)
+        return undefined;
+    const controller = new AbortController();
+    const forwardAbort = () => controller.abort(options.signal?.reason);
+    options.signal?.addEventListener("abort", forwardAbort, { once: true });
+    let timer;
+    const fetcher = options.fetch ?? fetch;
+    const url = `http://${options.hostname ?? "127.0.0.1"}:${options.candidate.port}${API_BASE_PATH}${path}`;
+    const responsePromise = fetcher(url, {
+        signal: controller.signal,
+    })
+        .then(async (response) => {
+        const payload = await response.json();
+        if (!isRecord(payload))
+            throw new CandidateVerificationError("RELKIT_CANDIDATE_RESPONSE_INVALID", "Candidate health response must be a JSON object.");
+        return { response, payload };
+    })
+        .catch((error) => {
+        if (error instanceof CandidateVerificationError)
+            throw error;
+        return undefined;
+    });
+    const timeoutPromise = new Promise((resolve) => {
+        timer = setTimeout(() => {
+            controller.abort();
+            resolve(undefined);
+        }, remaining);
+    });
+    try {
+        return await Promise.race([responsePromise, timeoutPromise]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        options.signal?.removeEventListener("abort", forwardAbort);
+        controller.abort();
+    }
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=verification-http.js.map

package/dist/verification-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-http.js","sourceRoot":"","sources":["../src/verification-http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAErE,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAqC,EACrC,IAAY,EACZ,QAAgB;IAEhB,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;QACzB,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACxC,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpE,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,IAAI,KAAgD,CAAC;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IACvC,MAAM,GAAG,GAAG,UAAU,OAAO,CAAC,QAAQ,IAAI,WAAW,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,GAAG,aAAa,GAAG,IAAI,EAAE,CAAC;IACzG,MAAM,eAAe,GAAgD,OAAO,CAAC,GAAG,EAAE;QAChF,MAAM,EAAE,UAAU,CAAC,MAAM;KAC1B,CAAC;SACC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAA+C,EAAE;QACpE,MAAM,OAAO,GAAY,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YACpB,MAAM,IAAI,0BAA0B,CAClC,mCAAmC,EACnC,kDAAkD,CACnD,CAAC;QACJ,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,IAAI,KAAK,YAAY,0BAA0B;YAAE,MAAM,KAAK,CAAC;QAC7D,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;IACL,MAAM,cAAc,GAAG,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,EAAE;QACxD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,CAAC,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC,CAAC;IAC/D,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,KAAK,SAAS;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;QAC7C,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC3D,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/verification-probe.d.ts

@@ -0,0 +1,12 @@
+import { type CandidateProbeResponse, type CandidateVerificationOptions, type CandidateVerificationResult } from "./verification-types.js";
+import type { SupervisorCandidateToken } from "./state-machine-types.js";
+export declare function requiredProbe(options: CandidateVerificationOptions, path: string, deadline: number): Promise<CandidateProbeResponse>;
+export declare function pollHealth(options: CandidateVerificationOptions, path: "/health/live" | "/health/ready", deadline: number, accepts: (probe: CandidateProbeResponse) => boolean): Promise<CandidateProbeResponse>;
+export declare function assertEnvelope(probe: CandidateProbeResponse): void;
+export declare function verifyIdentity(payload: Record<string, unknown>, expected: SupervisorCandidateToken): boolean;
+export declare function verifyGraph(payload: Record<string, unknown>, options: CandidateVerificationOptions): Omit<CandidateVerificationResult, "token" | "apiVersion" | "environmentReady" | "providerReady">;
+export declare function readinessState(payload: Record<string, unknown>): {
+    readonly environmentReady: boolean;
+    readonly providerReady: boolean;
+};
+//# sourceMappingURL=verification-probe.d.ts.map

package/dist/verification-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-probe.d.ts","sourceRoot":"","sources":["../src/verification-probe.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EACjC,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAGzE,wBAAsB,aAAa,CACjC,OAAO,EAAE,4BAA4B,EACrC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC,CAUjC;AAED,wBAAsB,UAAU,CAC9B,OAAO,EAAE,4BAA4B,EACrC,IAAI,EAAE,cAAc,GAAG,eAAe,EACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,OAAO,GAClD,OAAO,CAAC,sBAAsB,CAAC,CAyBjC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAWlE;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,wBAAwB,GACjC,OAAO,CAUT;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,4BAA4B,GACpC,IAAI,CACL,2BAA2B,EAC3B,OAAO,GAAG,YAAY,GAAG,kBAAkB,GAAG,eAAe,CAC9D,CAmDA;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAChE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,CAWA"}