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

package/dist/browser/options.d.ts

@@ -0,0 +1,183 @@
+import type { AuthorizationPolicy, Clock, ContextResolver, OpaqueSessionCookies, SessionResolver, SubscriptionBindings } from "@spine-event-engine/auth";
+import type { TypeRegistryLookup } from "@spine-event-engine/core";
+import type { NodeDiscovery } from "@spine-event-engine/deployment";
+/**
+ * Selects exactly one admission mode and binding ownership for a browser host.
+ */
+export type BrowserAdmission = {
+    /**
+     * Resolves authenticated application sessions from incoming credentials.
+     */
+    readonly sessions: SessionResolver;
+    /**
+     * Excludes intentionally public admission from authenticated mode.
+     */
+    readonly publicAccess?: never;
+    /**
+     * Optionally supplies application-owned authenticated subscription bindings.
+     */
+    readonly bindings?: SubscriptionBindings;
+} | {
+    /**
+     * Excludes session resolution from framework-owned public admission.
+     */
+    readonly sessions?: never;
+    /**
+     * Enables intentionally public admission and framework-owned bindings.
+     */
+    readonly publicAccess: true;
+    /**
+     * Excludes bindings because public admission owns them process-locally.
+     */
+    readonly bindings?: never;
+};
+/**
+ * Describes one fixed backend or ordered fixed backend set for browser forwarding.
+ */
+export type BrowserBackend = {
+    /**
+     * Supplies one canonical HTTP(S) backend origin.
+     */
+    readonly baseUrl: string;
+    /**
+     * Excludes a multi-backend set when one backend is supplied.
+     */
+    readonly baseUrls?: never;
+} | {
+    /**
+     * Excludes a single backend when a fixed backend set is supplied.
+     */
+    readonly baseUrl?: never;
+    /**
+     * Supplies a non-empty ordered set of canonical HTTP(S) backend origins.
+     */
+    readonly baseUrls: readonly [string, ...string[]];
+};
+/**
+ * Collects collaborators and listener settings for a browser gateway.
+ */
+export interface BrowserServerCollaborators {
+    /**
+     * Public listener host; defaults to local loopback.
+     */
+    readonly host?: string;
+    /**
+     * Public listener port; defaults to an ephemeral port.
+     */
+    readonly port?: number;
+    /**
+     * Maximum accepted request bytes; defaults to 4 MiB.
+     */
+    readonly readMaxBytes?: number;
+    /**
+     * Maximum emitted response or auth callback bytes; defaults to 4 MiB.
+     */
+    readonly writeMaxBytes?: number;
+    /**
+     * Fixed canonical HTTP(S) backends for standalone forwarding.
+     */
+    readonly backend?: BrowserBackend;
+    /**
+     * Complete-snapshot backend discovery for standalone forwarding.
+     */
+    readonly discovery?: NodeDiscovery;
+    /**
+     * Exact, bounded application auth callbacks; never a general router.
+     */
+    readonly authRoutes?: readonly BrowserAuthRoute[];
+    /**
+     * Maximum concurrently admitted auth callbacks; defaults to 64.
+     */
+    readonly maxActiveAuthRequests?: number;
+    /**
+     * Exact canonical HTTP(S) origins permitted to call Spine RPCs.
+     */
+    readonly origins: readonly string[];
+    /**
+     * Registry used to decode requests before authorization.
+     */
+    readonly registry?: TypeRegistryLookup;
+    /**
+     * Authorizes every decoded operation after admission.
+     */
+    readonly authorize: AuthorizationPolicy["authorize"];
+    /**
+     * Rebuilds trusted actor and tenant facts independently of browser input.
+     */
+    readonly contexts: ContextResolver;
+    /**
+     * Trusted clock for gateway and durable-subscription decisions.
+     */
+    readonly clock: Clock;
+    /**
+     * Strict opaque-cookie extraction alongside exact bearer credentials.
+     */
+    readonly cookies?: OpaqueSessionCookies;
+}
+/**
+ * Supplies options for a combined loopback-native browser host or a standalone gateway.
+ */
+export type BrowserServerOptions = BrowserServerCollaborators & BrowserAdmission;
+/**
+ * Browser options for a gateway that does not wrap a local native server.
+ *
+ * A standalone gateway must forward to fixed backends or discovery; it can
+ * never expose an empty routing surface.
+ */
+export type StandaloneBrowserServerOptions = BrowserServerOptions & ({
+    /**
+     * Supplies fixed backends when discovery is optional.
+     */
+    readonly backend: BrowserBackend;
+    /**
+     * Optionally supplements the fixed backend set with discovery.
+     */
+    readonly discovery?: NodeDiscovery;
+} | {
+    /**
+     * Optionally supplies fixed backends alongside required discovery.
+     */
+    readonly backend?: BrowserBackend;
+    /**
+     * Supplies required discovery when no fixed backend is configured.
+     */
+    readonly discovery: NodeDiscovery;
+});
+/**
+ * Defines one bounded application authentication callback exposed by a browser gateway.
+ */
+export interface BrowserAuthRoute {
+    /**
+     * Accepted method; auth routes only support GET or POST.
+     */
+    readonly method: "GET" | "POST";
+    /**
+     * Exact canonical non-root path; reserved Spine RPC paths are forbidden.
+     */
+    readonly path: string;
+    /**
+     * Exact canonical origins allowed for this callback.
+     */
+    readonly origins: readonly string[];
+    /**
+     * Permits an origin-less OAuth callback only when explicitly enabled.
+     */
+    readonly allowMissingOrigin?: boolean;
+    /**
+     * Positive request-body limit, capped at the transport bound.
+     */
+    readonly maxRequestBytes: number;
+    /**
+     * Positive callback deadline in milliseconds.
+     */
+    readonly timeoutMs: number;
+    /**
+     * Invokes the bounded callback only after origin and body admission.
+     *
+     * @param request Admitted callback request.
+     * @param signal Aborts when the callback deadline expires or the client disconnects.
+     * @returns A bounded callback response.
+     */
+    readonly onRequest: (request: Request, signal: AbortSignal) => Response | Promise<Response>;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/browser/options.d.ts.map

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

package/dist/browser/options.js

@@ -0,0 +1,15 @@
+/*
+ * 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.
+ */
+export {};
+//# sourceMappingURL=options.js.map

package/dist/browser/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/browser/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/bus/command-bus.d.ts

@@ -0,0 +1,63 @@
+import { type Command } from "@spine-event-engine/proto";
+import type { CommandDispatcher } from "./command-dispatcher.js";
+interface CommandBusAccess {
+    postInternal(commandBus: CommandBus, command: Command): Promise<void>;
+    postInternalFollowUp(commandBus: CommandBus, command: Command): Promise<void>;
+    beginClose(commandBus: CommandBus): void;
+    drain(commandBus: CommandBus): Promise<void>;
+    finishClose(commandBus: CommandBus): Promise<void>;
+    abortClose(commandBus: CommandBus): void;
+    acceptedWorkCount(commandBus: CommandBus): number;
+}
+/**
+ * Small single-process unicast command bus.
+ *
+ * Commands are accepted asynchronously through `post()` and routed by enclosed
+ * message type URL to exactly one registered dispatcher.
+ */
+export declare class CommandBus {
+    #private;
+    /**
+     * Creates a bus and registers its initial dispatchers.
+     *
+     * @param dispatchers the dispatchers to register.
+     */
+    constructor(dispatchers?: Iterable<CommandDispatcher>);
+    /**
+     * Registers a dispatcher.
+     *
+     * @param dispatcher the dispatcher to register.
+     * @returns the registered dispatcher.
+     */
+    register<Dispatcher extends CommandDispatcher>(dispatcher: Dispatcher): Dispatcher;
+    /**
+     * Lists command type URLs accepted by registered dispatchers.
+     *
+     * @returns the accepted command type URLs.
+     */
+    acceptedCommandTypes(): readonly string[];
+    /**
+     * Posts a command for asynchronous dispatch.
+     *
+     * @param command the command envelope to post.
+     * @returns A promise that settles after queued command dispatch completes and may reject.
+     */
+    post(command: Command): Promise<void>;
+    /**
+     * Stops accepting new command work and waits for accepted work to settle.
+     *
+     * Close is idempotent and returns the same close outcome on repeated calls.
+     * Runtime close failures reject the returned promise.
+     * @returns A promise that settles after the command bus closes.
+     *
+     */
+    close(): Promise<void>;
+}
+/**
+ * Provides framework-owned command posting and coordinated close access.
+ *
+ * @internal
+ */
+export declare const commandBusAccess: CommandBusAccess;
+export {};
+//# sourceMappingURL=command-bus.d.ts.map

package/dist/bus/command-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-bus.d.ts","sourceRoot":"","sources":["../../src/bus/command-bus.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAUxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAUjE,UAAU,gBAAgB;IACxB,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,oBAAoB,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACzC,KAAK,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,UAAU,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACzC,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC;CACnD;AAID;;;;;GAKG;AACH,qBAAa,UAAU;;IAQrB;;;;OAIG;gBACS,WAAW,GAAE,QAAQ,CAAC,iBAAiB,CAAM;IAqBzD;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,SAAS,iBAAiB,EAAE,UAAU,EAAE,UAAU,GAAG,UAAU;IAKlF;;;;OAIG;IACH,oBAAoB,IAAI,SAAS,MAAM,EAAE;IAIzC;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrC;;;;;;;OAOG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA8FvB;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,gBAoE7B,CAAC"}

package/dist/bus/command-bus.js

@@ -0,0 +1,236 @@
+/*
+ * 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 { clone } from "@bufbuild/protobuf";
+import { ValidationException, Validate, AnyMessages } from "@spine-event-engine/core";
+import { CommandSchema } from "@spine-event-engine/proto";
+import { runtimeAccess, ServerRuntimeStateError, SingleProcessServerRuntime, } from "../runtime/runtime.js";
+import { CommandValidationError } from "./command-errors.js";
+import { ImplicitRequiredIds } from "../entity/implicit-required-id.js";
+import { CommandDispatcherRegistry } from "./command-dispatcher-registry.js";
+const internalCommandPosters = new WeakMap();
+const commandFollowUpPosters = new WeakMap();
+const commandBusCloseStarters = new WeakMap();
+const commandBusDrainers = new WeakMap();
+const commandBusCloseFinishers = new WeakMap();
+const commandBusAborters = new WeakMap();
+const commandBusWorkCounters = new WeakMap();
+/**
+ * Small single-process unicast command bus.
+ *
+ * Commands are accepted asynchronously through `post()` and routed by enclosed
+ * message type URL to exactly one registered dispatcher.
+ */
+export class CommandBus {
+    #registry = new CommandDispatcherRegistry();
+    #runtime = new SingleProcessServerRuntime();
+    #started;
+    #intakeState = "open";
+    #acceptedWorkCount = 0;
+    #closed;
+    /**
+     * Creates a bus and registers its initial dispatchers.
+     *
+     * @param dispatchers the dispatchers to register.
+     */
+    constructor(dispatchers = []) {
+        this.#started = this.#runtime.start();
+        internalCommandPosters.set(this, (command) => this.#postInternal(command));
+        commandFollowUpPosters.set(this, (command) => this.#postInternalFollowUp(command));
+        commandBusCloseStarters.set(this, () => {
+            this.#beginClose();
+        });
+        commandBusDrainers.set(this, () => {
+            return this.#drain();
+        });
+        commandBusCloseFinishers.set(this, () => this.#finishClose());
+        commandBusAborters.set(this, () => {
+            this.#abortClose();
+        });
+        commandBusWorkCounters.set(this, () => this.#acceptedWorkCount);
+        for (const dispatcher of dispatchers) {
+            this.register(dispatcher);
+        }
+    }
+    /**
+     * Registers a dispatcher.
+     *
+     * @param dispatcher the dispatcher to register.
+     * @returns the registered dispatcher.
+     */
+    register(dispatcher) {
+        this.#registry.register(dispatcher);
+        return dispatcher;
+    }
+    /**
+     * Lists command type URLs accepted by registered dispatchers.
+     *
+     * @returns the accepted command type URLs.
+     */
+    acceptedCommandTypes() {
+        return this.#registry.acceptedTypeUrls();
+    }
+    /**
+     * Posts a command for asynchronous dispatch.
+     *
+     * @param command the command envelope to post.
+     * @returns A promise that settles after queued command dispatch completes and may reject.
+     */
+    post(command) {
+        const accepted = clone(CommandSchema, command);
+        if (this.#intakeState !== "open") {
+            return Promise.reject(new ServerRuntimeStateError("enqueue", this.#intakeState));
+        }
+        return this.#enqueueAccepted(accepted);
+    }
+    /**
+     * Stops accepting new command work and waits for accepted work to settle.
+     *
+     * Close is idempotent and returns the same close outcome on repeated calls.
+     * Runtime close failures reject the returned promise.
+     * @returns A promise that settles after the command bus closes.
+     *
+     */
+    close() {
+        this.#closed ??= this.#closeOnce();
+        return this.#closed;
+    }
+    #postInternal(command) {
+        const accepted = clone(CommandSchema, command);
+        if (this.#intakeState === "closed") {
+            return Promise.reject(new ServerRuntimeStateError("enqueue", "closed"));
+        }
+        return this.#enqueueAccepted(accepted);
+    }
+    #postInternalFollowUp(command) {
+        const accepted = clone(CommandSchema, command);
+        if (this.#intakeState === "closed") {
+            return Promise.reject(new ServerRuntimeStateError("enqueue", "closed"));
+        }
+        this.#acceptedWorkCount++;
+        return this.#started.then(() => runtimeAccess.enqueueFollowUp(this.#runtime, () => this.#dispatch(accepted)));
+    }
+    #enqueueAccepted(command) {
+        this.#acceptedWorkCount++;
+        return this.#started.then(() => this.#runtime.enqueue(() => this.#dispatch(command)));
+    }
+    #beginClose() {
+        if (this.#intakeState === "open") {
+            this.#intakeState = "closing";
+        }
+    }
+    #drain() {
+        return this.#started.then(() => runtimeAccess.drain(this.#runtime));
+    }
+    #finishClose() {
+        this.#closed ??= this.#closeOnce();
+        return this.#closed;
+    }
+    #abortClose() {
+        this.#beginClose();
+        void this.#started.then(() => this.#runtime.close()).catch(() => undefined);
+        this.#intakeState = "closed";
+    }
+    async #closeOnce() {
+        this.#beginClose();
+        await this.#started;
+        await this.#runtime.close();
+        this.#intakeState = "closed";
+    }
+    async #dispatch(command) {
+        const packed = command.message;
+        if (packed === undefined || packed.typeUrl === "") {
+            throw new Error("CommandBus requires command.message.typeUrl.");
+        }
+        const typeUrl = packed.typeUrl;
+        const registration = this.#registry.find(typeUrl);
+        if (registration === undefined) {
+            throw new Error(`No command dispatcher registered for "${typeUrl}".`);
+        }
+        const message = AnyMessages.unpack(packed, registration.schema);
+        if (message === undefined) {
+            throw CommandValidationError.invalidPayload();
+        }
+        try {
+            Validate.check(registration.schema, message);
+        }
+        catch (error) {
+            if (error instanceof ValidationException) {
+                throw new CommandValidationError(error.asMessage());
+            }
+            throw error;
+        }
+        const implicitId = ImplicitRequiredIds.validateCommand(registration.schema, message);
+        if (!implicitId.valid) {
+            throw new CommandValidationError(implicitId.error);
+        }
+        await registration.dispatcher.dispatch(clone(CommandSchema, command));
+    }
+}
+/**
+ * Provides framework-owned command posting and coordinated close access.
+ *
+ * @internal
+ */
+export const commandBusAccess = Object.freeze({
+    postInternal(commandBus, command) {
+        const postInternal = internalCommandPosters.get(commandBus);
+        if (postInternal === undefined) {
+            throw new TypeError("Internal command post requires a CommandBus instance.");
+        }
+        return postInternal(command);
+    },
+    postInternalFollowUp(commandBus, command) {
+        const post = commandFollowUpPosters.get(commandBus);
+        if (post === undefined) {
+            throw new TypeError("Internal command follow-up requires a CommandBus instance.");
+        }
+        return post(command);
+    },
+    beginClose(commandBus) {
+        const beginClose = commandBusCloseStarters.get(commandBus);
+        if (beginClose === undefined) {
+            throw new TypeError("Command-bus close coordination requires a CommandBus instance.");
+        }
+        beginClose();
+    },
+    drain(commandBus) {
+        const drain = commandBusDrainers.get(commandBus);
+        if (drain === undefined) {
+            throw new TypeError("Command-bus drain requires a CommandBus instance.");
+        }
+        return drain();
+    },
+    finishClose(commandBus) {
+        const finishClose = commandBusCloseFinishers.get(commandBus);
+        if (finishClose === undefined) {
+            throw new TypeError("Command-bus close completion requires a CommandBus instance.");
+        }
+        return finishClose();
+    },
+    abortClose(commandBus) {
+        const abortClose = commandBusAborters.get(commandBus);
+        if (abortClose === undefined) {
+            throw new TypeError("Command-bus close coordination requires a CommandBus instance.");
+        }
+        abortClose();
+    },
+    acceptedWorkCount(commandBus) {
+        const acceptedWorkCount = commandBusWorkCounters.get(commandBus);
+        if (acceptedWorkCount === undefined) {
+            throw new TypeError("Command-bus work counting requires a CommandBus instance.");
+        }
+        return acceptedWorkCount();
+    },
+});
+//# sourceMappingURL=command-bus.js.map

package/dist/bus/command-bus.js.map

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

package/dist/bus/command-dispatcher-registry.d.ts

@@ -0,0 +1,33 @@
+import { type MessageSchema } from "@spine-event-engine/core";
+import type { CommandDispatcher } from "./command-dispatcher.js";
+interface RegisteredCommandDispatcher {
+    readonly dispatcher: CommandDispatcher;
+    readonly schema: MessageSchema;
+}
+/**
+ * Internal unicast registry keyed by canonical Spine command type URL.
+ */
+export declare class CommandDispatcherRegistry {
+    #private;
+    /**
+     * Registers a dispatcher and all of its distinct command schemas.
+     *
+     * @param dispatcher the dispatcher to register.
+     */
+    register(dispatcher: CommandDispatcher): void;
+    /**
+     * Finds the dispatcher registered for a canonical command type URL.
+     *
+     * @param typeUrl the canonical command type URL.
+     * @returns the registration, when one exists.
+     */
+    find(typeUrl: string): RegisteredCommandDispatcher | undefined;
+    /**
+     * Lists the canonical command type URLs accepted by this registry.
+     *
+     * @returns the registered type URLs.
+     */
+    acceptedTypeUrls(): readonly string[];
+}
+export {};
+//# sourceMappingURL=command-dispatcher-registry.d.ts.map

package/dist/bus/command-dispatcher-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-dispatcher-registry.d.ts","sourceRoot":"","sources":["../../src/bus/command-dispatcher-registry.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,aAAa,EAAY,MAAM,0BAA0B,CAAC;AAExE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,UAAU,2BAA2B;IACnC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED;;GAEG;AACH,qBAAa,yBAAyB;;IAIpC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAyB7C;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS;IAI9D;;;;OAIG;IACH,gBAAgB,IAAI,SAAS,MAAM,EAAE;CAoBtC"}

package/dist/bus/command-dispatcher-registry.js

@@ -0,0 +1,75 @@
+/*
+ * 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 { TypeUrls } from "@spine-event-engine/core";
+/**
+ * Internal unicast registry keyed by canonical Spine command type URL.
+ */
+export class CommandDispatcherRegistry {
+    #dispatchers = new Set();
+    #byTypeUrl = new Map();
+    /**
+     * Registers a dispatcher and all of its distinct command schemas.
+     *
+     * @param dispatcher the dispatcher to register.
+     */
+    register(dispatcher) {
+        if (this.#dispatchers.has(dispatcher)) {
+            return;
+        }
+        const registrations = CommandDispatcherRegistry.#registrations(dispatcher);
+        for (const registration of registrations) {
+            const registered = this.#byTypeUrl.get(registration.typeUrl);
+            if (registered !== undefined && registered.dispatcher !== dispatcher) {
+                throw new Error(`Duplicate command dispatcher for "${registration.typeUrl}".`);
+            }
+        }
+        this.#dispatchers.add(dispatcher);
+        for (const registration of registrations) {
+            this.#byTypeUrl.set(registration.typeUrl, {
+                dispatcher,
+                schema: registration.schema,
+            });
+        }
+    }
+    /**
+     * Finds the dispatcher registered for a canonical command type URL.
+     *
+     * @param typeUrl the canonical command type URL.
+     * @returns the registration, when one exists.
+     */
+    find(typeUrl) {
+        return this.#byTypeUrl.get(typeUrl);
+    }
+    /**
+     * Lists the canonical command type URLs accepted by this registry.
+     *
+     * @returns the registered type URLs.
+     */
+    acceptedTypeUrls() {
+        return Object.freeze([...this.#byTypeUrl.keys()]);
+    }
+    static #registrations(dispatcher) {
+        const registrations = [];
+        const seen = new Set();
+        for (const schema of dispatcher.messageSchemas()) {
+            const typeUrl = TypeUrls.derive(schema);
+            if (!seen.has(typeUrl)) {
+                seen.add(typeUrl);
+                registrations.push({ typeUrl, schema });
+            }
+        }
+        return Object.freeze(registrations);
+    }
+}
+//# sourceMappingURL=command-dispatcher-registry.js.map

package/dist/bus/command-dispatcher-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-dispatcher-registry.js","sourceRoot":"","sources":["../../src/bus/command-dispatcher-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAsB,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AASxE;;GAEG;AACH,MAAM,OAAO,yBAAyB;IAC3B,YAAY,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC5C,UAAU,GAAG,IAAI,GAAG,EAAuC,CAAC;IAErE;;;;OAIG;IACH,QAAQ,CAAC,UAA6B;QACpC,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QAED,MAAM,aAAa,GAAG,yBAAyB,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAE3E,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YAE7D,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACrE,MAAM,IAAI,KAAK,CAAC,qCAAqC,YAAY,CAAC,OAAO,IAAI,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAElC,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE;gBACxC,UAAU;gBACV,MAAM,EAAE,YAAY,CAAC,MAAM;aAC5B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,OAAe;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,gBAAgB;QACd,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,CAAC,cAAc,CACnB,UAA6B;QAE7B,MAAM,aAAa,GAAiD,EAAE,CAAC;QACvE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAE/B,KAAK,MAAM,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAExC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAClB,aAAa,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/bus/command-dispatcher.d.ts

@@ -0,0 +1,25 @@
+import type { Command } from "@spine-event-engine/proto";
+import type { MessageSchema } from "@spine-event-engine/core";
+/**
+ * Small unicast command-dispatch seam for bus and repository adapters.
+ *
+ * Dispatchers declare the command message schemas they accept and perform
+ * handling behind the bus seam. Repository-backed adapters own entity loading
+ * and method invocation; the bus only routes accepted command envelopes.
+ */
+export interface CommandDispatcher {
+    /**
+     * Lists generated command message schemas accepted by this dispatcher.
+     *
+     * @returns the accepted message schemas.
+     */
+    messageSchemas(): readonly MessageSchema[];
+    /**
+     * Dispatches one generated Spine command envelope.
+     *
+     * @param command the command envelope to dispatch.
+     * @returns A promise that resolves after the command is dispatched.
+     */
+    dispatch(command: Command): Promise<void>;
+}
+//# sourceMappingURL=command-dispatcher.d.ts.map