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

package/dist/handler/event-handler-filter.js

@@ -0,0 +1,128 @@
+/*
+ * 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 { StringifierRegistry } from "@spine-event-engine/core";
+/**
+ * Compiles generated `@Where` metadata and selects one receptor at runtime.
+ *
+ * @internal
+ */
+export const EventHandlerFilters = Object.freeze({
+    compile(candidates, stringifiers = new StringifierRegistry()) {
+        const [first] = candidates;
+        if (first === undefined)
+            return EmptyFilterPlan;
+        const schema = first.schema;
+        const fallbacks = candidates.filter(({ where }) => where === undefined);
+        const filtered = candidates.filter((candidate) => candidate.where !== undefined);
+        const [firstFiltered] = filtered;
+        if (firstFiltered === undefined) {
+            return Object.freeze({
+                select: () => Object.freeze(fallbacks.map(({ value }) => value)),
+            });
+        }
+        if (fallbacks.length > 1) {
+            throw new Error("Event handler filtering has more than one unfiltered fallback.");
+        }
+        const path = firstFiltered.where.eventField;
+        if (filtered.some(({ where }) => where.eventField !== path)) {
+            throw new Error("Event handler filters for one receptor must use the same Event field path.");
+        }
+        if (candidates.some((candidate) => candidate.schema.typeName !== schema.typeName)) {
+            throw new Error("Event handler filtering candidates must consume the same Event type.");
+        }
+        const resolved = FilterPaths.resolve(schema, path, new StringifierRegistry(stringifiers));
+        const values = new Map();
+        for (const candidate of filtered) {
+            const parsed = resolved.stringifier.fromString(candidate.where.equals);
+            const canonical = resolved.stringifier.toString(parsed);
+            if (values.has(canonical)) {
+                throw new Error(`Event handler filtering has duplicate canonical value ${JSON.stringify(canonical)}.`);
+            }
+            values.set(canonical, Object.freeze({ value: candidate.value, canonical }));
+        }
+        const fallback = fallbacks[0]?.value;
+        return Object.freeze({
+            select(message) {
+                const actual = FilterPaths.read(message, resolved.fields);
+                if (actual.present) {
+                    const canonical = resolved.stringifier.toString(actual.value);
+                    const match = values.get(canonical);
+                    if (match !== undefined)
+                        return Object.freeze([match.value]);
+                }
+                return Object.freeze(fallback === undefined ? [] : [fallback]);
+            },
+        });
+    },
+});
+const EmptyFilterPlan = Object.freeze({
+    select: () => Object.freeze([]),
+});
+const FilterPaths = Object.freeze({
+    resolve(schema, path, stringifiers) {
+        const names = path.split(".");
+        if (names.some((name) => name.length === 0)) {
+            throw new Error(`Event handler filter path ${JSON.stringify(path)} is malformed.`);
+        }
+        const fields = [];
+        let message = schema;
+        names.forEach((name, index) => {
+            const field = message.fields.find((candidate) => candidate.name === name);
+            if (field === undefined) {
+                throw new Error(`Event handler filter path ${JSON.stringify(path)} has unknown field ${JSON.stringify(name)}.`);
+            }
+            if (field.fieldKind === "list" || field.fieldKind === "map") {
+                throw new Error(`Event handler filter path ${JSON.stringify(path)} has an unsupported repeated or map field.`);
+            }
+            fields.push(field);
+            if (index < names.length - 1) {
+                if (field.fieldKind !== "message") {
+                    throw new Error(`Event handler filter path ${JSON.stringify(path)} intermediate field must be a message.`);
+                }
+                message = field.message;
+            }
+        });
+        const terminal = fields.at(-1);
+        if (terminal === undefined) {
+            throw new Error("Event handler filter path must not be empty.");
+        }
+        return Object.freeze({
+            fields: Object.freeze(fields),
+            stringifier: stringifiers.forField(terminal),
+        });
+    },
+    read(message, fields) {
+        let current = message;
+        for (const field of fields) {
+            if (typeof current !== "object" || current === null)
+                return { present: false };
+            const record = current;
+            const value = field.oneof === undefined
+                ? record[field.localName]
+                : FilterPaths.oneofValue(record, field.oneof.localName, field.localName);
+            if (value === undefined)
+                return { present: false };
+            current = value;
+        }
+        return { present: true, value: current };
+    },
+    oneofValue(record, oneofName, fieldName) {
+        const oneof = record[oneofName];
+        if (typeof oneof !== "object" || oneof === null)
+            return undefined;
+        const value = oneof;
+        return value.case === fieldName ? value.value : undefined;
+    },
+});
+//# sourceMappingURL=event-handler-filter.js.map

package/dist/handler/event-handler-filter.js.map

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

package/dist/handler/event-registration-readiness.d.ts

@@ -0,0 +1,196 @@
+import { type EntityClass, type EntityHandlersMetadata, type EventApplicationHandlerMetadata, type EventReactionHandlerMetadata, type EventSubscriptionHandlerMetadata, type HandlerMetadataRegistryLookup, type RegisteredHandlerMetadata } from "./handler-metadata.js";
+import type { EntityMetadata } from "../entity/entity-metadata.js";
+/**
+ * Event subscriber entry exposed by event registration readiness lookups.
+ */
+export interface EventRegistrationSubscriberMetadata {
+    /**
+     * Fully qualified event message type name subscribed to by one entity handler.
+     */
+    readonly eventFullTypeName: string;
+    /**
+     * Entity handler metadata object that declared the event subscriber.
+     */
+    readonly entityHandlers: EntityHandlersMetadata;
+    /**
+     * Entity class that owns the event subscriber method.
+     */
+    readonly entityType: EntityClass;
+    /**
+     * Descriptor-derived entity metadata for the subscriber state type.
+     */
+    readonly entity: EntityMetadata;
+    /**
+     * Event subscription handler metadata declared by the entity.
+     */
+    readonly handler: EventSubscriptionHandlerMetadata;
+    /**
+     * Original registered handler entry from the handler metadata registry.
+     */
+    readonly registeredHandler: RegisteredHandlerMetadata<EventSubscriptionHandlerMetadata>;
+}
+/**
+ * Event reactor entry exposed by event registration readiness lookups.
+ */
+export interface EventRegistrationReactorMetadata {
+    /**
+     * Fully qualified event message type name reacted to by one entity handler.
+     */
+    readonly eventFullTypeName: string;
+    /**
+     * Entity handler metadata object that declared the event reactor.
+     */
+    readonly entityHandlers: EntityHandlersMetadata;
+    /**
+     * Entity class that owns the event reactor method.
+     */
+    readonly entityType: EntityClass;
+    /**
+     * Descriptor-derived entity metadata for the reactor state type.
+     */
+    readonly entity: EntityMetadata;
+    /**
+     * Event reaction handler metadata declared by the entity.
+     */
+    readonly handler: EventReactionHandlerMetadata;
+    /**
+     * Original registered handler entry from the handler metadata registry.
+     */
+    readonly registeredHandler: RegisteredHandlerMetadata<EventReactionHandlerMetadata>;
+}
+/**
+ * Event applier entry exposed by event registration readiness lookups.
+ */
+export interface EventRegistrationApplicationMetadata {
+    /**
+     * Fully qualified event message type name applied by one entity handler.
+     */
+    readonly eventFullTypeName: string;
+    /**
+     * Entity state full type name that owns the event applier.
+     */
+    readonly stateTypeName: string;
+    /**
+     * Entity handler metadata object that declared the event applier.
+     */
+    readonly entityHandlers: EntityHandlersMetadata;
+    /**
+     * Entity class that owns the event applier method.
+     */
+    readonly entityType: EntityClass;
+    /**
+     * Descriptor-derived entity metadata for the applier state type.
+     */
+    readonly entity: EntityMetadata;
+    /**
+     * Event application handler metadata declared by the entity.
+     */
+    readonly handler: EventApplicationHandlerMetadata;
+    /**
+     * Original registered handler entry from the handler metadata registry.
+     */
+    readonly registeredHandler: RegisteredHandlerMetadata<EventApplicationHandlerMetadata>;
+}
+/**
+ * Read-only event registration readiness lookup surface.
+ */
+export interface EventRegistrationReadinessLookup {
+    /**
+     * Returns registered event message type names in deterministic order.
+     *
+     * @returns A fresh frozen list of event message type names.
+     */
+    eventTypeNames(): readonly string[];
+    /**
+     * Finds subscriber metadata for an event message type in registry order.
+     *
+     * @param eventTypeName Fully qualified event message type name.
+     * @returns A fresh frozen list of subscriber metadata.
+     */
+    findEventSubscribers(eventTypeName: string): readonly EventRegistrationSubscriberMetadata[];
+    /**
+     * Finds reactor metadata for an event message type in registry order.
+     *
+     * @param eventTypeName Fully qualified event message type name.
+     * @returns A fresh frozen list of reactor metadata.
+     */
+    findEventReactors(eventTypeName: string): readonly EventRegistrationReactorMetadata[];
+    /**
+     * Finds applier metadata for an event message type in registry order.
+     *
+     * @param eventTypeName Fully qualified event message type name.
+     * @returns A fresh frozen list of applier metadata.
+     */
+    findEventApplications(eventTypeName: string): readonly EventRegistrationApplicationMetadata[];
+}
+/**
+ * Metadata-only event registration readiness derived from handler metadata.
+ *
+ * The surface mirrors the JVM event-dispatcher registration shape only far
+ * enough for later runtime slices to ask which event message types have
+ * subscribers, reactors, or appliers. Subscribers and reactors intentionally
+ * preserve Spine fan-out semantics by returning all registered receivers for
+ * the event type. Event applier duplicate policy remains owned by
+ * `HandlerMetadataRegistry`, where uniqueness is per entity state and event
+ * type. The current TypeScript handler metadata does not identify external
+ * events, so domestic/external event classification is deferred.
+ *
+ * This surface does not publish, route, dispatch, invoke, store, import,
+ * deliver, subscribe to command results, or acknowledge events.
+ */
+export declare class EventRegistrationReadiness implements EventRegistrationReadinessLookup {
+    #private;
+    private constructor();
+    /**
+     * Builds readiness from an already validated handler metadata registry lookup.
+     *
+     * @param registry Source of entity handler metadata.
+     * @returns Frozen event registration readiness.
+     */
+    static fromRegistry(registry: HandlerMetadataRegistryLookup): EventRegistrationReadiness;
+    /**
+     * Builds readiness from entity handler metadata.
+     *
+     * Duplicate event application validation is intentionally delegated to
+     * `HandlerMetadataRegistry`. Subscriber and reactor fan-out is retained.
+     *
+     * @param entityHandlers Entity handler metadata to validate and index.
+     * @returns Frozen event registration readiness.
+     */
+    static fromEntityHandlers(entityHandlers: Iterable<EntityHandlersMetadata>): EventRegistrationReadiness;
+    /**
+     * Returns registered event message type names in deterministic order.
+     *
+     * @returns A fresh frozen list of event message type names.
+     */
+    eventTypeNames(): readonly string[];
+    /**
+     * Finds subscriber metadata for an event message type in registry order.
+     *
+     * @param eventTypeName Fully qualified event message type name.
+     * @returns A fresh frozen list of subscriber metadata.
+     */
+    findEventSubscribers(eventTypeName: string): readonly EventRegistrationSubscriberMetadata[];
+    /**
+     * Finds reactor metadata for an event message type in registry order.
+     *
+     * @param eventTypeName Fully qualified event message type name.
+     * @returns A fresh frozen list of reactor metadata.
+     */
+    findEventReactors(eventTypeName: string): readonly EventRegistrationReactorMetadata[];
+    /**
+     * Finds applier metadata for an event message type in registry order.
+     *
+     * @param eventTypeName Fully qualified event message type name.
+     * @returns A fresh frozen list of applier metadata.
+     */
+    findEventApplications(eventTypeName: string): readonly EventRegistrationApplicationMetadata[];
+    /**
+     * Checks whether a value was created by this module's readiness factories.
+     *
+     * @param value Value to test for readiness authenticity.
+     * @returns `true` when the value is an authentic event registration readiness instance.
+     */
+    static isAuthentic(value: unknown): value is EventRegistrationReadiness;
+}
+//# sourceMappingURL=event-registration-readiness.d.ts.map

package/dist/handler/event-registration-readiness.d.ts.map

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

package/dist/handler/event-registration-readiness.js

@@ -0,0 +1,187 @@
+/*
+ * 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 { HandlerMetadataRegistry, } from "./handler-metadata.js";
+import { ReadinessMetadata } from "./registration-readiness-metadata.js";
+const eventRegistrationReadinessToken = Symbol("eventRegistrationReadinessToken");
+const authenticEventRegistrationReadiness = new WeakSet();
+/**
+ * Metadata-only event registration readiness derived from handler metadata.
+ *
+ * The surface mirrors the JVM event-dispatcher registration shape only far
+ * enough for later runtime slices to ask which event message types have
+ * subscribers, reactors, or appliers. Subscribers and reactors intentionally
+ * preserve Spine fan-out semantics by returning all registered receivers for
+ * the event type. Event applier duplicate policy remains owned by
+ * `HandlerMetadataRegistry`, where uniqueness is per entity state and event
+ * type. The current TypeScript handler metadata does not identify external
+ * events, so domestic/external event classification is deferred.
+ *
+ * This surface does not publish, route, dispatch, invoke, store, import,
+ * deliver, subscribe to command results, or acknowledge events.
+ */
+export class EventRegistrationReadiness {
+    #eventFullTypeNames;
+    #subscribersByTypeName;
+    #reactorsByTypeName;
+    #applicationsByTypeName;
+    constructor(authenticityToken, eventFullTypeNames, subscribersByTypeName, reactorsByTypeName, applicationsByTypeName) {
+        if (authenticityToken !== eventRegistrationReadinessToken) {
+            throw new TypeError("EventRegistrationReadiness instances must be created by the package factory methods.");
+        }
+        this.#eventFullTypeNames = Object.freeze([...eventFullTypeNames]);
+        this.#subscribersByTypeName = ReadinessMetadata.copyMap(subscribersByTypeName);
+        this.#reactorsByTypeName = ReadinessMetadata.copyMap(reactorsByTypeName);
+        this.#applicationsByTypeName = ReadinessMetadata.copyMap(applicationsByTypeName);
+        authenticEventRegistrationReadiness.add(this);
+        Object.freeze(this);
+    }
+    /**
+     * Builds readiness from an already validated handler metadata registry lookup.
+     *
+     * @param registry Source of entity handler metadata.
+     * @returns Frozen event registration readiness.
+     */
+    static fromRegistry(registry) {
+        const validatedRegistry = new HandlerMetadataRegistry(registry.listEntityHandlers());
+        const eventFullTypeNames = new Set();
+        const subscribersByTypeName = new Map();
+        const reactorsByTypeName = new Map();
+        const applicationsByTypeName = new Map();
+        for (const entry of validatedRegistry.findHandlersByKind("event-subscription")) {
+            const eventFullTypeName = entry.handler.messageFullTypeName;
+            eventFullTypeNames.add(eventFullTypeName);
+            EventRegistrationReadiness.#push(subscribersByTypeName, eventFullTypeName, EventRegistrationReadiness.#createSubscriber(eventFullTypeName, entry));
+        }
+        for (const entry of validatedRegistry.findHandlersByKind("event-reaction")) {
+            const eventFullTypeName = entry.handler.messageFullTypeName;
+            eventFullTypeNames.add(eventFullTypeName);
+            EventRegistrationReadiness.#push(reactorsByTypeName, eventFullTypeName, EventRegistrationReadiness.#createReactor(eventFullTypeName, entry));
+        }
+        for (const entry of validatedRegistry.findHandlersByKind("event-application")) {
+            const eventFullTypeName = entry.handler.messageFullTypeName;
+            eventFullTypeNames.add(eventFullTypeName);
+            EventRegistrationReadiness.#push(applicationsByTypeName, eventFullTypeName, EventRegistrationReadiness.#createApplication(eventFullTypeName, entry));
+        }
+        return new EventRegistrationReadiness(eventRegistrationReadinessToken, [...eventFullTypeNames].sort((left, right) => ReadinessMetadata.compareTypeNames(left, right)), subscribersByTypeName, reactorsByTypeName, applicationsByTypeName);
+    }
+    /**
+     * Builds readiness from entity handler metadata.
+     *
+     * Duplicate event application validation is intentionally delegated to
+     * `HandlerMetadataRegistry`. Subscriber and reactor fan-out is retained.
+     *
+     * @param entityHandlers Entity handler metadata to validate and index.
+     * @returns Frozen event registration readiness.
+     */
+    static fromEntityHandlers(entityHandlers) {
+        return EventRegistrationReadiness.fromRegistry(new HandlerMetadataRegistry(entityHandlers));
+    }
+    /**
+     * Returns registered event message type names in deterministic order.
+     *
+     * @returns A fresh frozen list of event message type names.
+     */
+    eventTypeNames() {
+        return Object.freeze([...this.#eventFullTypeNames]);
+    }
+    /**
+     * Finds subscriber metadata for an event message type in registry order.
+     *
+     * @param eventTypeName Fully qualified event message type name.
+     * @returns A fresh frozen list of subscriber metadata.
+     */
+    findEventSubscribers(eventTypeName) {
+        return Object.freeze((this.#subscribersByTypeName.get(eventTypeName) ?? []).map((subscriber) => EventRegistrationReadiness.#copySubscriber(subscriber)));
+    }
+    /**
+     * Finds reactor metadata for an event message type in registry order.
+     *
+     * @param eventTypeName Fully qualified event message type name.
+     * @returns A fresh frozen list of reactor metadata.
+     */
+    findEventReactors(eventTypeName) {
+        return Object.freeze((this.#reactorsByTypeName.get(eventTypeName) ?? []).map((reactor) => EventRegistrationReadiness.#copyReactor(reactor)));
+    }
+    /**
+     * Finds applier metadata for an event message type in registry order.
+     *
+     * @param eventTypeName Fully qualified event message type name.
+     * @returns A fresh frozen list of applier metadata.
+     */
+    findEventApplications(eventTypeName) {
+        return Object.freeze((this.#applicationsByTypeName.get(eventTypeName) ?? []).map((application) => EventRegistrationReadiness.#copyApplication(application)));
+    }
+    /**
+     * Checks whether a value was created by this module's readiness factories.
+     *
+     * @param value Value to test for readiness authenticity.
+     * @returns `true` when the value is an authentic event registration readiness instance.
+     */
+    static isAuthentic(value) {
+        return (value !== null && typeof value === "object" && authenticEventRegistrationReadiness.has(value));
+    }
+    static #createSubscriber(eventFullTypeName, registeredHandler) {
+        const fields = ReadinessMetadata.create(registeredHandler);
+        return Object.freeze({
+            eventFullTypeName,
+            ...fields,
+        });
+    }
+    static #copySubscriber(subscriber) {
+        const fields = ReadinessMetadata.copy(subscriber.registeredHandler);
+        return Object.freeze({
+            eventFullTypeName: subscriber.eventFullTypeName,
+            ...fields,
+        });
+    }
+    static #createReactor(eventFullTypeName, registeredHandler) {
+        const fields = ReadinessMetadata.create(registeredHandler);
+        return Object.freeze({
+            eventFullTypeName,
+            ...fields,
+        });
+    }
+    static #copyReactor(reactor) {
+        const fields = ReadinessMetadata.copy(reactor.registeredHandler);
+        return Object.freeze({
+            eventFullTypeName: reactor.eventFullTypeName,
+            ...fields,
+        });
+    }
+    static #createApplication(eventFullTypeName, registeredHandler) {
+        const fields = ReadinessMetadata.create(registeredHandler);
+        return Object.freeze({
+            eventFullTypeName,
+            stateTypeName: fields.entity.fullTypeName,
+            ...fields,
+        });
+    }
+    static #copyApplication(application) {
+        const fields = ReadinessMetadata.copy(application.registeredHandler);
+        return Object.freeze({
+            eventFullTypeName: application.eventFullTypeName,
+            stateTypeName: application.stateTypeName,
+            ...fields,
+        });
+    }
+    static #push(map, key, value) {
+        const values = map.get(key);
+        if (values === undefined) {
+            map.set(key, [value]);
+            return;
+        }
+        values.push(value);
+    }
+}
+//# sourceMappingURL=event-registration-readiness.js.map

package/dist/handler/event-registration-readiness.js.map

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

package/dist/handler/external.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Marks the first parameter of a generated event receptor as accepting an
+ * event imported from another bounded context.
+ *
+ * This is deliberately a transparent type-only marker. The build-time handler
+ * analyzer records it in generated metadata; no runtime value or registration
+ * API is introduced.
+ */
+export type External<Value> = Value;
+//# sourceMappingURL=external.d.ts.map

package/dist/handler/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../src/handler/external.ts"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,CAAC,KAAK,IAAI,KAAK,CAAC"}

package/dist/handler/external.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=external.js.map

package/dist/handler/external.js.map

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