@spine-event-engine/server 2.0.0-snapshot.2

package/dist/repository/state-update-routing.js

@@ -0,0 +1,91 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+import {} from "@spine-event-engine/core";
+import { RoutingDeclarations, } from "./routing-declarations.js";
+const states = new WeakMap();
+/**
+ * Mutable Entity-state route declarations snapshotted by repository construction.
+ */
+export class StateUpdateRouting {
+    constructor() {
+        states.set(this, RoutingDeclarations.create());
+    }
+    /**
+     * Creates empty Entity-state route declarations.
+     *
+     * @returns Mutable declarations for one repository.
+     */
+    static create() {
+        return new StateUpdateRouting();
+    }
+    /**
+     * Registers an exact generated Entity-state schema route or a nominal message-interface route.
+     *
+     * A schema route receives its exact state shape. An interface route receives
+     * {@link InterfaceRouteMessage}, the member-state union intersected with the
+     * declared interface. Routing selects an exact schema route first, then the
+     * first matching interface token in registration order, then the
+     * replacement/default route.
+     *
+     * Copied or malformed tokens fail during declaration. Every token member must
+     * be registered by the repository, or construction fails. The selected route
+     * runs once for an accepted admission; durable replay uses stored targets and
+     * does not run routing again.
+     *
+     * @param schemaOrToken Generated Entity-state schema or nominal message-interface token.
+     * @param via Route function to invoke.
+     * @returns These mutable declarations.
+     */
+    route(schemaOrToken, via) {
+        if (typeof via !== "function")
+            throw new TypeError("State-update routing requires a route function.");
+        const state = StateUpdateRoutingInternals.state(this);
+        if (RoutingDeclarations.isInterfaceTokenCandidate(schemaOrToken)) {
+            RoutingDeclarations.routeInterface(state, schemaOrToken, via, "State-update routing");
+        }
+        else {
+            RoutingDeclarations.exact(state, schemaOrToken, via, "State-update routing has a duplicate exact state-update route.");
+        }
+        return this;
+    }
+    /**
+     * Replaces the first-compatible-field default state route.
+     *
+     * @param via Replacement route function.
+     * @returns These mutable declarations.
+     */
+    replaceDefault(via) {
+        if (typeof via !== "function")
+            throw new TypeError("State-update routing requires a route function.");
+        RoutingDeclarations.default(StateUpdateRoutingInternals.state(this), via);
+        return this;
+    }
+}
+/**
+ * Internal access to state-routing declaration state.
+ *
+ * @internal Repository construction support.
+ */
+export const StateUpdateRoutingInternals = Object.freeze({
+    state(routing) {
+        return states.get(routing);
+    },
+    snapshot(routing) {
+        if (routing === undefined) {
+            return RoutingDeclarations.snapshot(RoutingDeclarations.create());
+        }
+        return RoutingDeclarations.snapshot(StateUpdateRoutingInternals.state(routing));
+    },
+});
+//# sourceMappingURL=state-update-routing.js.map

package/dist/repository/state-update-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-update-routing.js","sourceRoot":"","sources":["../../src/repository/state-update-routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAA6C,MAAM,0BAA0B,CAAC;AAErF,OAAO,EACL,mBAAmB,GAKpB,MAAM,2BAA2B,CAAC;AAsBnC,MAAM,MAAM,GAAG,IAAI,OAAO,EAA0B,CAAC;AAErD;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAC7B;QACE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,mBAAmB,CAAC,MAAM,EAAwB,CAAC,CAAC;IACvE,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,kBAAkB,EAAM,CAAC;IACtC,CAAC;IA6BD;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CACH,aAA8E,EAC9E,GAAyB;QAEzB,IAAI,OAAO,GAAG,KAAK,UAAU;YAC3B,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;QACzE,MAAM,KAAK,GAAG,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,mBAAmB,CAAC,yBAAyB,CAAC,aAAa,CAAC,EAAE,CAAC;YACjE,mBAAmB,CAAC,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,sBAAsB,CAAC,CAAC;QACxF,CAAC;aAAM,CAAC;YACN,mBAAmB,CAAC,KAAK,CACvB,KAAK,EACL,aAAa,EACb,GAAG,EACH,gEAAgE,CACjE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,GAAyB;QACtC,IAAI,OAAO,GAAG,KAAK,UAAU;YAC3B,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;QACzE,mBAAmB,CAAC,OAAO,CAAC,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAKnC,MAAM,CAAC,MAAM,CAAC;IACjB,KAAK,CAAK,OAA+B;QACvC,OAAO,MAAM,CAAC,GAAG,CAAC,OAAO,CAAc,CAAC;IAC1C,CAAC;IACD,QAAQ,CACN,OAA2C;QAE3C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,mBAAmB,CAAC,QAAQ,CAAC,mBAAmB,CAAC,MAAM,EAAwB,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,mBAAmB,CAAC,QAAQ,CAAC,2BAA2B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAClF,CAAC;CACF,CAAC,CAAC"}

package/dist/runtime/runtime.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Deterministic lifecycle states for the single-process server runtime kernel.
+ *
+ * Transitions are:
+ *
+ * - `created -> running` when `start()` is accepted;
+ * - `created -> closed` when `close()` happens before start;
+ * - `running -> closing -> closed` when close drains already accepted work;
+ * - `closing -> closed` once accepted work settles.
+ *
+ * `running -> running` through repeated `start()` and `closing|closed -> closed`
+ * through repeated `close()` are idempotent no-ops. Starting after close is
+ * rejected.
+ */
+export type ServerRuntimeState = "created" | "running" | "closing" | "closed";
+/**
+ * Explicit lifecycle contract for server-owned runtime parts.
+ */
+export interface ServerRuntimeLifecycle {
+    /**
+     * Current deterministic lifecycle state.
+     */
+    readonly state: ServerRuntimeState;
+    /**
+     * Starts accepting runtime work.
+     *
+     * Calling `start()` on an already running runtime is a no-op. Calling it while
+     * closing or after close rejects with `ServerRuntimeStateError`.
+     *
+     * @returns A promise that resolves after runtime work admission starts.
+     */
+    start(): Promise<void>;
+    /**
+     * Stops accepting new work and waits for already accepted work to settle.
+     *
+     * Closing is idempotent. The first close call owns the transition to
+     * `closed`; later calls return the same close outcome. Calling `close()` from
+     * active runtime work rejects with `ServerRuntimeStateError` and state
+     * `"running-work"`.
+     *
+     * @returns A promise that settles after accepted runtime work drains and closes.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Executes one trusted runtime work item accepted by the single-process queue.
+ *
+ * The queue provides no timeout, cancellation, fairness, queue bound, or
+ * hostile-callback protection; non-settling work can keep `close()` pending.
+ * Same-runtime enqueue during active work is rejected to avoid self-deadlock.
+ * This is the first server intake boundary, not a durable job, transport
+ * message, command, event, dispatch outcome, or repository operation.
+ *
+ * @returns nothing or a promise fulfilled after the work completes.
+ */
+export type ServerRuntimeWork = () => void | Promise<void>;
+/**
+ * Operation rejected by the runtime lifecycle state machine.
+ */
+export type ServerRuntimeStateOperation = "start" | "enqueue" | "close";
+/**
+ * Runtime condition that rejected a lifecycle operation.
+ */
+export type ServerRuntimeRejectedState = ServerRuntimeState | "running-work";
+/**
+ * Stable machine-readable code for runtime lifecycle state failures.
+ */
+export type RuntimeStateErrorCode = "INVALID_RUNTIME_STATE";
+/**
+ * Error raised when a lifecycle operation is not valid in the current state.
+ */
+export declare class ServerRuntimeStateError extends Error {
+    /**
+     * Stable taxonomy for invalid runtime lifecycle operations.
+     */
+    readonly code: RuntimeStateErrorCode;
+    /**
+     * Operation that was rejected.
+     */
+    readonly operation: ServerRuntimeStateOperation;
+    /**
+     * State that rejected the operation.
+     */
+    readonly state: ServerRuntimeRejectedState;
+    /**
+     * Creates an error for a rejected runtime operation.
+     *
+     * @param operation the rejected operation.
+     * @param state the state that rejected it.
+     */
+    constructor(operation: ServerRuntimeStateOperation, state: ServerRuntimeRejectedState);
+}
+/**
+ * Small server-owned single-process async runtime queue.
+ *
+ * The runtime has no global singleton and performs no import-time
+ * registration. `enqueue()` is an intake boundary: accepted work runs in a
+ * later microtask and is processed in FIFO order. Closing prevents new intake
+ * and waits for previously accepted work to settle. Enqueued callbacks must be
+ * trusted server-owned work; this kernel intentionally does not add timeout,
+ * cancellation, fairness, queue bounds, or hostile-callback isolation.
+ * Same-runtime reentrant enqueue during active work is rejected to avoid queue
+ * self-deadlocks.
+ */
+export declare class SingleProcessServerRuntime implements ServerRuntimeLifecycle {
+    #private;
+    /**
+     * Creates an idle single-process runtime.
+     *
+     */
+    constructor();
+    /**
+     * Returns the current lifecycle state.
+     *
+     * @returns the lifecycle state.
+     */
+    get state(): ServerRuntimeState;
+    /**
+     * Starts accepting runtime work.
+     *
+     * @returns A promise that resolves after runtime work admission starts.
+     */
+    start(): Promise<void>;
+    /**
+     * Accepts one unit of server runtime work for later single-process execution.
+     *
+     * The returned promise represents this work item's completion. A rejected
+     * work item rejects only its own promise and does not stop later queued work.
+     * Work callbacks are trusted server-owned callbacks only. There is no
+     * timeout, cancellation, fairness, queue bound, or protection from hostile or
+     * non-settling work; such work can keep `close()` pending. Same-runtime
+     * reentrant enqueue during active work is rejected to avoid queue self-deadlocks.
+     *
+     * @param work the trusted work to enqueue.
+     * @returns A promise that settles after the queued work completes.
+     */
+    enqueue(work: ServerRuntimeWork): Promise<void>;
+    /**
+     * Closes the runtime after accepted work drains.
+     *
+     * @returns A promise that settles after the runtime closes.
+     */
+    close(): Promise<void>;
+}
+interface RuntimeAccess {
+    enqueueFollowUp(runtime: SingleProcessServerRuntime, work: ServerRuntimeWork): Promise<void>;
+    drain(runtime: SingleProcessServerRuntime): Promise<void>;
+}
+/**
+ * Provides package-owned authority for framework follow-up work.
+ *
+ * @internal
+ */
+export declare const runtimeAccess: RuntimeAccess;
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IAGrC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IAEnC;;;;;;;OAOG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;;;;;;;OASG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE5D;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAGhD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAA2B;IAE/D;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,2BAA2B,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,0BAA0B,CAAC;IAE3C;;;;;OAKG;gBACS,SAAS,EAAE,2BAA2B,EAAE,KAAK,EAAE,0BAA0B;CAOtF;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,0BAA2B,YAAW,sBAAsB;;IAKvE;;;OAGG;;IAMH;;;;OAIG;IACH,IAAI,KAAK,IAAI,kBAAkB,CAE9B;IAED;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+B/C;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAsCvB;AAED,UAAU,aAAa;IACrB,eAAe,CAAC,OAAO,EAAE,0BAA0B,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7F,KAAK,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D;AAQD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,aAoB1B,CAAC"}

package/dist/runtime/runtime.js

@@ -0,0 +1,215 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+import { AsyncLocalStorage } from "node:async_hooks";
+/**
+ * Error raised when a lifecycle operation is not valid in the current state.
+ */
+export class ServerRuntimeStateError extends Error {
+    // prettier-ignore
+    /**
+     * Stable taxonomy for invalid runtime lifecycle operations.
+     */
+    code = "INVALID_RUNTIME_STATE";
+    /**
+     * Operation that was rejected.
+     */
+    operation;
+    /**
+     * State that rejected the operation.
+     */
+    state;
+    /**
+     * Creates an error for a rejected runtime operation.
+     *
+     * @param operation the rejected operation.
+     * @param state the state that rejected it.
+     */
+    constructor(operation, state) {
+        super(RuntimeValues.formatStateError(operation, state));
+        this.name = "ServerRuntimeStateError";
+        this.operation = operation;
+        this.state = state;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Small server-owned single-process async runtime queue.
+ *
+ * The runtime has no global singleton and performs no import-time
+ * registration. `enqueue()` is an intake boundary: accepted work runs in a
+ * later microtask and is processed in FIFO order. Closing prevents new intake
+ * and waits for previously accepted work to settle. Enqueued callbacks must be
+ * trusted server-owned work; this kernel intentionally does not add timeout,
+ * cancellation, fairness, queue bounds, or hostile-callback isolation.
+ * Same-runtime reentrant enqueue during active work is rejected to avoid queue
+ * self-deadlocks.
+ */
+export class SingleProcessServerRuntime {
+    #state = "created";
+    #tail = Promise.resolve();
+    #closePromise;
+    /**
+     * Creates an idle single-process runtime.
+     *
+     */
+    constructor() {
+        followUpEnqueuers.set(this, (work) => this.#enqueueFollowUp(work));
+        runtimeDrainers.set(this, () => this.#drain());
+    }
+    /**
+     * Returns the current lifecycle state.
+     *
+     * @returns the lifecycle state.
+     */
+    get state() {
+        return this.#state;
+    }
+    /**
+     * Starts accepting runtime work.
+     *
+     * @returns A promise that resolves after runtime work admission starts.
+     */
+    start() {
+        if (this.#state === "running") {
+            return Promise.resolve();
+        }
+        if (this.#state === "closing" || this.#state === "closed") {
+            return Promise.reject(new ServerRuntimeStateError("start", this.#state));
+        }
+        this.#state = "running";
+        return Promise.resolve();
+    }
+    /**
+     * Accepts one unit of server runtime work for later single-process execution.
+     *
+     * The returned promise represents this work item's completion. A rejected
+     * work item rejects only its own promise and does not stop later queued work.
+     * Work callbacks are trusted server-owned callbacks only. There is no
+     * timeout, cancellation, fairness, queue bound, or protection from hostile or
+     * non-settling work; such work can keep `close()` pending. Same-runtime
+     * reentrant enqueue during active work is rejected to avoid queue self-deadlocks.
+     *
+     * @param work the trusted work to enqueue.
+     * @returns A promise that settles after the queued work completes.
+     */
+    enqueue(work) {
+        return this.#enqueue(work, false);
+    }
+    #enqueueFollowUp(work) {
+        return this.#enqueue(work, true);
+    }
+    #enqueue(work, allowRunningWork) {
+        const runningWork = RuntimeValues.isRunningWork(this);
+        const acceptsDrainFollowUp = allowRunningWork && runningWork && this.#state === "closing";
+        if (this.#state !== "running" && !acceptsDrainFollowUp) {
+            throw new ServerRuntimeStateError("enqueue", this.#state);
+        }
+        if (!allowRunningWork && runningWork) {
+            throw new ServerRuntimeStateError("enqueue", "running-work");
+        }
+        const completion = this.#tail.then(async () => {
+            const frame = { runtime: this, active: true };
+            try {
+                await runtimeWork.run(frame, work);
+            }
+            finally {
+                frame.active = false;
+            }
+        });
+        this.#tail = completion.catch(() => undefined);
+        return completion;
+    }
+    /**
+     * Closes the runtime after accepted work drains.
+     *
+     * @returns A promise that settles after the runtime closes.
+     */
+    close() {
+        if (RuntimeValues.isRunningWork(this)) {
+            return Promise.reject(new ServerRuntimeStateError("close", "running-work"));
+        }
+        if (this.#closePromise !== undefined) {
+            return this.#closePromise;
+        }
+        if (this.#state === "closed") {
+            this.#closePromise = Promise.resolve();
+            return this.#closePromise;
+        }
+        if (this.#state === "created") {
+            this.#state = "closed";
+            this.#closePromise = Promise.resolve();
+            return this.#closePromise;
+        }
+        this.#state = "closing";
+        this.#closePromise = this.#drainAndClose();
+        return this.#closePromise;
+    }
+    async #drainAndClose() {
+        await this.#drain();
+        this.#state = "closed";
+    }
+    async #drain() {
+        let observedTail;
+        do {
+            observedTail = this.#tail;
+            await observedTail;
+        } while (this.#tail !== observedTail);
+    }
+}
+const followUpEnqueuers = new WeakMap();
+const runtimeDrainers = new WeakMap();
+/**
+ * Provides package-owned authority for framework follow-up work.
+ *
+ * @internal
+ */
+export const runtimeAccess = Object.freeze({
+    enqueueFollowUp(runtime, work) {
+        const enqueueFollowUp = followUpEnqueuers.get(runtime);
+        if (enqueueFollowUp === undefined) {
+            throw new TypeError("Runtime follow-up work requires a SingleProcessServerRuntime instance.");
+        }
+        return enqueueFollowUp(work);
+    },
+    drain(runtime) {
+        const drain = runtimeDrainers.get(runtime);
+        if (drain === undefined) {
+            throw new TypeError("Runtime drain requires a SingleProcessServerRuntime instance.");
+        }
+        return drain();
+    },
+});
+const runtimeWork = new AsyncLocalStorage();
+/**
+ * Private runtime state and execution helpers.
+ */
+const RuntimeValues = Object.freeze({
+    formatStateError(operation, state) {
+        if (operation === "start") {
+            return `Cannot start server runtime while it is ${state}.`;
+        }
+        if (state === "running-work" && operation === "close") {
+            return "Cannot close server runtime from an active runtime work item.";
+        }
+        if (state === "running-work") {
+            return "Cannot enqueue runtime work from an active runtime work item.";
+        }
+        return `Cannot enqueue runtime work while server runtime is ${state}.`;
+    },
+    isRunningWork(runtime) {
+        const frame = runtimeWork.getStore();
+        return frame?.runtime === runtime && frame.active;
+    },
+});
+//# sourceMappingURL=runtime.js.map

package/dist/runtime/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAgFrD;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,kBAAkB;IAElB;;OAEG;IACM,IAAI,GAA0B,uBAAuB,CAAC;IAE/D;;OAEG;IACM,SAAS,CAA8B;IAEhD;;OAEG;IACM,KAAK,CAA6B;IAE3C;;;;;OAKG;IACH,YAAY,SAAsC,EAAE,KAAiC;QACnF,KAAK,CAAC,aAAa,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,0BAA0B;IACrC,MAAM,GAAuB,SAAS,CAAC;IACvC,KAAK,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IACzC,aAAa,CAA4B;IAEzC;;;OAGG;IACH;QACE,iBAAiB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QACnE,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1D,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,IAAuB;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,gBAAgB,CAAC,IAAuB;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,QAAQ,CAAC,IAAuB,EAAE,gBAAyB;QACzD,MAAM,WAAW,GAAG,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,oBAAoB,GAAG,gBAAgB,IAAI,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;QAE1F,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACvD,MAAM,IAAI,uBAAuB,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,gBAAgB,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,IAAI,uBAAuB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC5C,MAAM,KAAK,GAAqB,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YAChE,IAAI,CAAC;gBACH,MAAM,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACrC,CAAC;oBAAS,CAAC;gBACT,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;YACvB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,uBAAuB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QAC9E,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;YACvB,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,MAAM;QACV,IAAI,YAA2B,CAAC;QAEhC,GAAG,CAAC;YACF,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC;YAC1B,MAAM,YAAY,CAAC;QACrB,CAAC,QAAQ,IAAI,CAAC,KAAK,KAAK,YAAY,EAAE;IACxC,CAAC;CACF;AAOD,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAGlC,CAAC;AACJ,MAAM,eAAe,GAAG,IAAI,OAAO,EAAmD,CAAC;AAEvF;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB,MAAM,CAAC,MAAM,CAAC;IACxD,eAAe,CAAC,OAAmC,EAAE,IAAuB;QAC1E,MAAM,eAAe,GAAG,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEvD,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,IAAI,SAAS,CAAC,wEAAwE,CAAC,CAAC;QAChG,CAAC;QAED,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAmC;QACvC,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAE3C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;QACvF,CAAC;QAED,OAAO,KAAK,EAAE,CAAC;IACjB,CAAC;CACF,CAAC,CAAC;AAOH,MAAM,WAAW,GAAG,IAAI,iBAAiB,EAAoB,CAAC;AAE9D;;GAEG;AACH,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,gBAAgB,CACd,SAAsC,EACtC,KAAiC;QAEjC,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;YAC1B,OAAO,2CAA2C,KAAK,GAAG,CAAC;QAC7D,CAAC;QAED,IAAI,KAAK,KAAK,cAAc,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;YACtD,OAAO,+DAA+D,CAAC;QACzE,CAAC;QAED,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;YAC7B,OAAO,+DAA+D,CAAC;QACzE,CAAC;QAED,OAAO,uDAAuD,KAAK,GAAG,CAAC;IACzE,CAAC;IAED,aAAa,CAAC,OAAmC;QAC/C,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;QACrC,OAAO,KAAK,EAAE,OAAO,KAAK,OAAO,IAAI,KAAK,CAAC,MAAM,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}

package/dist/runtime/signal-intake.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Write-side signal kinds accepted by the first intake-result seam.
+ */
+export type SignalKind = "command" | "event";
+/**
+ * Marker for intake that accepted responsibility for later asynchronous work.
+ */
+export type SignalIntakeAcceptedFor = "async-work";
+/**
+ * Stable machine-readable reason code for immediate signal intake failures.
+ */
+export type SignalIntakeFailureCode = "RUNTIME_NOT_ACCEPTING" | "MALFORMED_ENVELOPE" | "UNSUPPORTED_SIGNAL_KIND";
+/**
+ * Sanitized scalar diagnostic metadata for immediate signal intake failures.
+ */
+export type SignalIntakeFailureDiagnostics = Readonly<Record<string, string | number | boolean | null>>;
+/**
+ * Result returned when a write-side signal is accepted for later asynchronous work.
+ */
+export interface SignalIntakeAccepted<Kind extends SignalKind = SignalKind> {
+    /**
+     * Discriminant for accepted intake.
+     */
+    readonly status: "accepted";
+    /**
+     * Whether the accepted signal is a command or event.
+     */
+    readonly signalKind: Kind;
+    /**
+     * Accepted intake only promises future asynchronous work ownership.
+     */
+    readonly acceptedFor: SignalIntakeAcceptedFor;
+}
+/**
+ * Structured immediate failure details with sanitized diagnostics only.
+ */
+export interface SignalIntakeFailureDetails {
+    /**
+     * Stable machine-readable intake failure reason.
+     */
+    readonly code: SignalIntakeFailureCode;
+    /**
+     * Copy-safe scalar diagnostics; never a full signal, envelope, or message payload.
+     */
+    readonly diagnostics: SignalIntakeFailureDiagnostics;
+}
+/**
+ * Result returned when a write-side signal fails immediately at intake.
+ */
+export interface SignalIntakeFailure<Kind extends SignalKind = SignalKind> {
+    /**
+     * Discriminant for immediate intake failure.
+     */
+    readonly status: "failed";
+    /**
+     * Whether the rejected signal is a command or event.
+     */
+    readonly signalKind: Kind;
+    /**
+     * Stable failure reason and sanitized diagnostics.
+     */
+    readonly failure: SignalIntakeFailureDetails;
+}
+/**
+ * Write-side signal intake result value.
+ */
+export type SignalIntakeResult<Kind extends SignalKind = SignalKind> = SignalIntakeAccepted<Kind> | SignalIntakeFailure<Kind>;
+/**
+ * Creates an immutable accepted-for-async-work signal intake result.
+ *
+ * @param signalKind the kind of accepted signal.
+ * @returns the accepted intake result.
+ */
+export declare function acceptSignalIntake<Kind extends SignalKind>(signalKind: Kind): SignalIntakeAccepted<Kind>;
+/**
+ * Creates an immutable immediate signal intake failure result.
+ *
+ * @param signalKind the kind of rejected signal.
+ * @param code the stable intake failure code.
+ * @param diagnostics scalar diagnostic details to retain.
+ * @returns the failed intake result.
+ */
+export declare function failSignalIntake<Kind extends SignalKind>(signalKind: Kind, code: SignalIntakeFailureCode, diagnostics?: Readonly<Record<string, unknown>>): SignalIntakeFailure<Kind>;
+//# sourceMappingURL=signal-intake.d.ts.map

package/dist/runtime/signal-intake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-intake.d.ts","sourceRoot":"","sources":["../../src/runtime/signal-intake.ts"],"names":[],"mappings":"AAcA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,YAAY,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GACjC,uBAAuB,GAAG,oBAAoB,GAAG,yBAAyB,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CACnD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,IAAI,SAAS,UAAU,GAAG,UAAU;IAGxE;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IAGzC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,8BAA8B,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,IAAI,SAAS,UAAU,GAAG,UAAU;IAGvE;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,0BAA0B,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,IAAI,SAAS,UAAU,GAAG,UAAU,IACjE,oBAAoB,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;AAqBzD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,SAAS,UAAU,EACxD,UAAU,EAAE,IAAI,GACf,oBAAoB,CAAC,IAAI,CAAC,CAM5B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,UAAU,EACtD,UAAU,EAAE,IAAI,EAChB,IAAI,EAAE,uBAAuB,EAC7B,WAAW,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM,GAClD,mBAAmB,CAAC,IAAI,CAAC,CAS3B"}

package/dist/runtime/signal-intake.js

@@ -0,0 +1,94 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+const isProxy = process.getBuiltinModule("node:util").types.isProxy;
+const allowedDiagnosticKeys = new Set([
+    "attempt",
+    "boundedContext",
+    "messageType",
+    "reason",
+    "retryable",
+    "runtimeState",
+]);
+/**
+ * Creates an immutable accepted-for-async-work signal intake result.
+ *
+ * @param signalKind the kind of accepted signal.
+ * @returns the accepted intake result.
+ */
+export function acceptSignalIntake(signalKind) {
+    return Object.freeze({
+        status: "accepted",
+        signalKind,
+        acceptedFor: "async-work",
+    });
+}
+/**
+ * Creates an immutable immediate signal intake failure result.
+ *
+ * @param signalKind the kind of rejected signal.
+ * @param code the stable intake failure code.
+ * @param diagnostics scalar diagnostic details to retain.
+ * @returns the failed intake result.
+ */
+export function failSignalIntake(signalKind, code, diagnostics = {}) {
+    return Object.freeze({
+        status: "failed",
+        signalKind,
+        failure: Object.freeze({
+            code,
+            diagnostics: SignalIntakeValues.sanitizeDiagnostics(diagnostics),
+        }),
+    });
+}
+/**
+ * Private signal-intake diagnostic helpers.
+ */
+const SignalIntakeValues = Object.freeze({
+    sanitizeDiagnostics(diagnostics) {
+        const sanitized = {};
+        const descriptors = SignalIntakeValues.getOwnDiagnosticDescriptors(diagnostics);
+        if (descriptors === undefined) {
+            return Object.freeze(sanitized);
+        }
+        for (const key of allowedDiagnosticKeys) {
+            const descriptor = descriptors[key];
+            if (descriptor === undefined || !descriptor.enumerable || !("value" in descriptor)) {
+                continue;
+            }
+            const value = descriptor.value;
+            if (SignalIntakeValues.isDiagnosticScalar(value)) {
+                sanitized[key] = value;
+            }
+        }
+        return Object.freeze(sanitized);
+    },
+    getOwnDiagnosticDescriptors(diagnostics) {
+        if (isProxy(diagnostics)) {
+            return undefined;
+        }
+        try {
+            return Object.getOwnPropertyDescriptors(diagnostics);
+        }
+        catch {
+            return undefined;
+        }
+    },
+    isDiagnosticScalar(value) {
+        return (value === null ||
+            typeof value === "string" ||
+            typeof value === "number" ||
+            typeof value === "boolean");
+    },
+});
+//# sourceMappingURL=signal-intake.js.map

package/dist/runtime/signal-intake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-intake.js","sourceRoot":"","sources":["../../src/runtime/signal-intake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoGH,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;AAEpE,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,SAAS;IACT,gBAAgB;IAChB,aAAa;IACb,QAAQ;IACR,WAAW;IACX,cAAc;CACf,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAgB;IAEhB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,UAAU;QAClB,UAAU;QACV,WAAW,EAAE,YAAY;KAC1B,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAgB,EAChB,IAA6B,EAC7B,cAAiD,EAAE;IAEnD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,QAAQ;QAChB,UAAU;QACV,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;YACrB,IAAI;YACJ,WAAW,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,WAAW,CAAC;SACjE,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IACvC,mBAAmB,CACjB,WAA8C;QAE9C,MAAM,SAAS,GAAqD,EAAE,CAAC;QACvE,MAAM,WAAW,GAAG,kBAAkB,CAAC,2BAA2B,CAAC,WAAW,CAAC,CAAC;QAEhF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,qBAAqB,EAAE,CAAC;YACxC,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,EAAE,CAAC;gBACnF,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAY,UAAU,CAAC,KAAK,CAAC;YACxC,IAAI,kBAAkB,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,2BAA2B,CACzB,WAA8C;QAE9C,IAAI,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,CAAC,yBAAyB,CAAC,WAAW,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,kBAAkB,CAAC,KAAc;QAC/B,OAAO,CACL,KAAK,KAAK,IAAI;YACd,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAO,KAAK,KAAK,QAAQ;YACzB,OAAO,KAAK,KAAK,SAAS,CAC3B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}