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

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-dispatcher.d.ts","sourceRoot":"","sources":["../../src/bus/command-dispatcher.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAGhC;;;;OAIG;IACH,cAAc,IAAI,SAAS,aAAa,EAAE,CAAC;IAE3C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}

package/dist/bus/command-dispatcher.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=command-dispatcher.js.map

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

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

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

@@ -0,0 +1,23 @@
+import { type ValidationError } from "@spine-event-engine/proto";
+/**
+ * Error raised when a command envelope payload fails command-bus validation.
+ */
+export declare class CommandValidationError extends Error {
+    /**
+     * Structured payload validation details from the command-bus boundary.
+     */
+    readonly validationError: ValidationError;
+    /**
+     * Creates a command-bus validation error with structured details.
+     *
+     * @param validationError the structured payload validation details.
+     */
+    constructor(validationError: ValidationError);
+    /**
+     * Creates a validation error for payloads that cannot be unpacked as the registered type.
+     *
+     * @returns the invalid-payload error.
+     */
+    static invalidPayload(): CommandValidationError;
+}
+//# sourceMappingURL=command-errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-errors.d.ts","sourceRoot":"","sources":["../../src/bus/command-errors.ts"],"names":[],"mappings":"AAgBA,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAG/C;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAE1C;;;;OAIG;gBACS,eAAe,EAAE,eAAe;IAO5C;;;;OAIG;IACH,MAAM,CAAC,cAAc,IAAI,sBAAsB;CAWhD"}

package/dist/bus/command-errors.js

@@ -0,0 +1,52 @@
+/*
+ * 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 { create } from "@bufbuild/protobuf";
+import { Validate } from "@spine-event-engine/core";
+import { ConstraintViolationSchema, TemplateStringSchema, } from "@spine-event-engine/proto";
+/**
+ * Error raised when a command envelope payload fails command-bus validation.
+ */
+export class CommandValidationError extends Error {
+    // prettier-ignore
+    /**
+     * Structured payload validation details from the command-bus boundary.
+     */
+    validationError;
+    /**
+     * Creates a command-bus validation error with structured details.
+     *
+     * @param validationError the structured payload validation details.
+     */
+    constructor(validationError) {
+        super("Command payload validation failed.");
+        this.name = "CommandValidationError";
+        this.validationError = validationError;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    /**
+     * Creates a validation error for payloads that cannot be unpacked as the registered type.
+     *
+     * @returns the invalid-payload error.
+     */
+    static invalidPayload() {
+        return new CommandValidationError(Validate.createError([
+            create(ConstraintViolationSchema, {
+                message: create(TemplateStringSchema, {
+                    withPlaceholders: "Command payload could not be decoded as the registered type.",
+                }),
+            }),
+        ]));
+    }
+}
+//# sourceMappingURL=command-errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"command-errors.js","sourceRoot":"","sources":["../../src/bus/command-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,GAErB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,kBAAkB;IAElB;;OAEG;IACM,eAAe,CAAkB;IAE1C;;;;OAIG;IACH,YAAY,eAAgC;QAC1C,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,cAAc;QACnB,OAAO,IAAI,sBAAsB,CAC/B,QAAQ,CAAC,WAAW,CAAC;YACnB,MAAM,CAAC,yBAAyB,EAAE;gBAChC,OAAO,EAAE,MAAM,CAAC,oBAAoB,EAAE;oBACpC,gBAAgB,EAAE,8DAA8D;iBACjF,CAAC;aACH,CAAC;SACH,CAAC,CACH,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,113 @@
+import { type MessageSchema } from "@spine-event-engine/core";
+import { type Event } from "@spine-event-engine/proto";
+import type { EventStore } from "@spine-event-engine/storage";
+import type { ILogLayer } from "loglayer";
+import type { EventDispatcher } from "./event-dispatcher.js";
+interface EventBusAccess {
+    /**
+     * Assembles a package-internal bus that owns no event store.
+     *
+     * @param dispatchers the initial dispatchers to register.
+     * @returns the assembled forgetting bus.
+     */
+    createForgettingBus(dispatchers?: Iterable<EventDispatcher>): EventBus;
+    createSystemBus(eventStore: EventStore | undefined, dispatchers?: Iterable<EventDispatcher>): EventBus;
+    postStored(eventBus: EventBus, event: Event): Promise<void>;
+    postStoredFollowUp(eventBus: EventBus, event: Event): Promise<void>;
+    postFollowUp(eventBus: EventBus, event: Event): Promise<void>;
+    runExclusive<Result>(eventBus: EventBus, work: () => Result | Promise<Result>): Promise<Result>;
+    subscribe(eventBus: EventBus, typeUrl: string, subscriber: EventSubscriber): EventSubscription;
+    eventSchemas(eventBus: EventBus): readonly MessageSchema[];
+    registerSchemas(eventBus: EventBus, schemas: Iterable<MessageSchema>): void;
+    unregister(eventBus: EventBus, dispatcher: EventDispatcher): void;
+    schema(eventBus: EventBus, typeUrl: string): MessageSchema | undefined;
+    beginClose(eventBus: EventBus): void;
+    drain(eventBus: EventBus): Promise<void>;
+    finishClose(eventBus: EventBus): Promise<void>;
+    abortClose(eventBus: EventBus): void;
+    acceptedWorkCount(eventBus: EventBus): number;
+    installLogger(eventBus: EventBus, logger: ILogLayer): void;
+    clearLogger(eventBus: EventBus): void;
+}
+/**
+ * Small single-process multicast event bus.
+ *
+ * Public construction creates a domain-only bus that stores domain events and
+ * rejects System schemas, dispatchers, and events. Internally assembled
+ * forgetting and System buses own no `EventStore` unless explicitly given one.
+ * Events with no matching dispatcher resolve without dispatch. Events with no
+ * registered schema reject deterministically before storage or dispatch.
+ */
+export declare class EventBus {
+    #private;
+    /**
+     * Creates a domain-only bus backed by an event store and initial dispatchers.
+     * System schemas and dispatchers are rejected; framework System events use
+     * the package-internal System-bus factory instead.
+     *
+     * @param eventStore the store that persists accepted events.
+     * @param dispatchers the dispatchers to register.
+     */
+    constructor(eventStore: EventStore, dispatchers?: Iterable<EventDispatcher>);
+    /**
+     * Registers an event dispatcher.
+     *
+     * @param dispatcher the dispatcher to register.
+     * @returns the registered dispatcher.
+     */
+    register<Dispatcher extends EventDispatcher>(dispatcher: Dispatcher): Dispatcher;
+    /**
+     * Posts an event for asynchronous dispatch.
+     *
+     * @param event the event envelope to post.
+     * @returns A promise that settles after admission and dispatch complete and may reject.
+     */
+    post(event: Event): Promise<void>;
+    /**
+     * Stops accepting new event work, drains accepted work, and closes an owned event store.
+     *
+     * Close is idempotent and returns the same close outcome on repeated calls.
+     * Runtime and event-store close hooks are both attempted; failures reject as
+     * an `AggregateError`.
+     *
+     * @returns A promise that settles after the event bus closes.
+     *
+     */
+    close(): Promise<void>;
+}
+/**
+ * Accepts events for framework service adapters.
+ *
+ * @internal
+ */
+export interface EventSubscriber {
+    /**
+     * Accepts a cloned dispatched event.
+     *
+     * @param event the event received by the subscription.
+     */
+    onEvent(event: Event): void;
+}
+/**
+ * Represents an explicit cleanup handle for framework event subscriptions.
+ *
+ * @internal
+ */
+export interface EventSubscription {
+    /**
+     * Indicates whether the subscription no longer receives events.
+     */
+    readonly closed: boolean;
+    /**
+     * Stops this subscription from receiving events.
+     */
+    unsubscribe(): void;
+}
+/**
+ * Provides package-internal EventBus access and assembly.
+ *
+ * @internal
+ */
+export declare const eventBusAccess: EventBusAccess;
+export {};
+//# sourceMappingURL=event-bus.d.ts.map

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

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