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

package/dist/handler/handler-metadata.js

@@ -0,0 +1,391 @@
+/*
+ * 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 { describeEntityMetadata, isEntitySchema } from "../entity/entity-metadata.js";
+/**
+ * Error thrown when explicit handler metadata cannot be defined.
+ */
+export class HandlerMetadataError extends Error {
+    // prettier-ignore
+    /**
+     * Stable code for callers/tests that need structured failure handling.
+     */
+    code;
+    /**
+     * Creates a registration error.
+     *
+     * @param code Stable failure code.
+     * @param message Human-readable failure detail.
+     */
+    constructor(code, message) {
+        super(message);
+        this.name = "HandlerMetadataError";
+        this.code = code;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Error thrown when a caller-owned handler metadata registry rejects metadata.
+ */
+export class HandlerMetadataRegistryError extends Error {
+    // prettier-ignore
+    /**
+     * Stable code for callers/tests that need structured failure handling.
+     */
+    code;
+    /**
+     * Creates a registry validation error.
+     *
+     * @param code Stable failure code.
+     * @param message Human-readable failure detail.
+     */
+    constructor(code, message) {
+        super(message);
+        this.name = "HandlerMetadataRegistryError";
+        this.code = code;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Caller-owned registry for lookup-only handler metadata and duplicate validation.
+ */
+export class HandlerMetadataRegistry {
+    #entityHandlers = [];
+    #handlerEntries = [];
+    #byEntityState = new Map();
+    #byKind = new Map();
+    #byMessage = new Map();
+    #commandAssignments = new Map();
+    #eventApplications = new Map();
+    /**
+     * Creates a caller-owned registry and optionally registers metadata.
+     *
+     * @param entityHandlers Entity metadata to register in iteration order.
+     */
+    constructor(entityHandlers = []) {
+        for (const metadata of entityHandlers) {
+            this.register(metadata);
+        }
+    }
+    /**
+     * Registers one entity handler metadata object.
+     *
+     * @param metadata Entity handler metadata to register.
+     * @returns The registered metadata unchanged.
+     */
+    register(metadata) {
+        const entries = metadata.handlers.map((handler) => this.#entry(metadata, handler));
+        const commandAssignments = new Map();
+        const eventApplications = new Map();
+        for (const entry of entries) {
+            if (entry.handler.kind === "command-assignment") {
+                const commandEntry = entry;
+                this.#validateAssignment(commandEntry, this.#commandAssignments.get(entry.handler.messageFullTypeName) ??
+                    commandAssignments.get(entry.handler.messageFullTypeName));
+                commandAssignments.set(entry.handler.messageFullTypeName, commandEntry);
+            }
+            if (entry.handler.kind === "event-application") {
+                const eventEntry = entry;
+                const key = this.#applicationKey(entry.entity.fullTypeName, entry.handler.messageFullTypeName);
+                this.#validateApplication(eventEntry, this.#eventApplications.get(key) ?? eventApplications.get(key));
+                eventApplications.set(key, eventEntry);
+            }
+        }
+        this.#entityHandlers.push(metadata);
+        this.#push(this.#byEntityState, metadata.entity.fullTypeName, metadata);
+        for (const entry of entries) {
+            this.#handlerEntries.push(entry);
+            this.#push(this.#byKind, entry.handler.kind, entry);
+            this.#push(this.#byMessage, entry.handler.messageFullTypeName, entry);
+        }
+        for (const [messageFullTypeName, entry] of commandAssignments) {
+            this.#commandAssignments.set(messageFullTypeName, entry);
+        }
+        for (const [key, entry] of eventApplications) {
+            this.#eventApplications.set(key, entry);
+        }
+        return metadata;
+    }
+    /**
+     * Returns registered entity handler metadata in registration order.
+     *
+     * @returns A fresh frozen metadata list.
+     */
+    listEntityHandlers() {
+        return Object.freeze([...this.#entityHandlers]);
+    }
+    /**
+     * Returns registered handler entries in registration and declaration order.
+     *
+     * @returns A fresh frozen registered-handler list.
+     */
+    listHandlers() {
+        return Object.freeze([...this.#handlerEntries]);
+    }
+    /**
+     * Finds entity handler metadata by state type name.
+     *
+     * @param stateTypeName Fully qualified entity state type name.
+     * @returns Matching metadata in registration order.
+     */
+    findByState(stateTypeName) {
+        return Object.freeze([...(this.#byEntityState.get(stateTypeName) ?? [])]);
+    }
+    /**
+     * Finds handler entries by handler role.
+     *
+     * @param kind Handler role.
+     * @returns Matching entries in registration and declaration order.
+     */
+    findHandlersByKind(kind) {
+        return Object.freeze([
+            ...(this.#byKind.get(kind) ?? []),
+        ]);
+    }
+    /**
+     * Finds handler entries by message type name.
+     *
+     * @param messageTypeName Fully qualified command or event type name.
+     * @returns Matching entries in registration and declaration order.
+     */
+    findByMessage(messageTypeName) {
+        return Object.freeze([...(this.#byMessage.get(messageTypeName) ?? [])]);
+    }
+    /**
+     * Finds the unique command assignment for a command type.
+     *
+     * @param commandTypeName Fully qualified command type name.
+     * @returns The assignment when registered.
+     */
+    findCommandAssignment(commandTypeName) {
+        return this.#commandAssignments.get(commandTypeName);
+    }
+    /**
+     * Finds the unique event applier for a state and event type.
+     *
+     * @param stateTypeName Fully qualified entity state type name.
+     * @param eventTypeName Fully qualified event type name.
+     * @returns The applier when registered.
+     */
+    findEventApplication(stateTypeName, eventTypeName) {
+        return this.#eventApplications.get(this.#applicationKey(stateTypeName, eventTypeName));
+    }
+    #entry(entityHandlers, handler) {
+        return Object.freeze({
+            entityHandlers,
+            entityType: entityHandlers.entityType,
+            entity: entityHandlers.entity,
+            handler,
+        });
+    }
+    #validateAssignment(entry, duplicate) {
+        if (duplicate !== undefined) {
+            throw new HandlerMetadataRegistryError("DUPLICATE_COMMAND_ASSIGNMENT", `Duplicate command assignment for "${entry.handler.messageFullTypeName}" declared by entity ` +
+                `"${entry.entity.fullTypeName}"; already declared by entity ` +
+                `"${duplicate.entity.fullTypeName}".`);
+        }
+    }
+    #validateApplication(entry, duplicate) {
+        if (duplicate !== undefined) {
+            throw new HandlerMetadataRegistryError("DUPLICATE_EVENT_APPLICATION", `Duplicate event application for entity "${entry.entity.fullTypeName}" and event ` +
+                `"${entry.handler.messageFullTypeName}"; already declared by method ` +
+                `"${duplicate.handler.methodName}".`);
+        }
+    }
+    #applicationKey(stateTypeName, eventTypeName) {
+        return `${stateTypeName}\u0000${eventTypeName}`;
+    }
+    #push(map, key, value) {
+        const values = map.get(key);
+        if (values === undefined) {
+            map.set(key, [value]);
+        }
+        else {
+            values.push(value);
+        }
+    }
+}
+/**
+ * Builds and validates metadata for one entity class.
+ */
+class EntityHandlersOwner {
+    #authentic = new WeakSet();
+    #emittedSchemas = new WeakMap();
+    /**
+     * Creates handler metadata without invoking entity methods.
+     *
+     * @param entityType Entity class whose prototype owns the methods.
+     * @param stateSchema Generated schema for the entity state.
+     * @param define Callback that registers handlers with the builder.
+     * @returns Frozen metadata for the entity class.
+     */
+    define(entityType, stateSchema, define) {
+        return this.#define(entityType, stateSchema, define, []);
+    }
+    /**
+     * Checks that metadata was created by this package.
+     *
+     * @param metadata Metadata to inspect.
+     * @returns Whether the metadata is package-authentic.
+     * @internal
+     */
+    isAuthentic(metadata) {
+        return this.#authentic.has(metadata);
+    }
+    /**
+     * Returns schemas emitted by generated handler metadata.
+     *
+     * @param handler Handler metadata to inspect.
+     * @returns Frozen emitted schemas.
+     * @internal
+     */
+    emittedSchemas(handler) {
+        return Object.freeze([...(this.#emittedSchemas.get(handler) ?? [])]);
+    }
+    /**
+     * Copies generated emitted-schema metadata between cloned handlers.
+     *
+     * @param source Source handler metadata.
+     * @param target Cloned target handler metadata.
+     * @internal
+     */
+    copyEmittedSchemas(source, target) {
+        const schemas = this.#emittedSchemas.get(source);
+        if (schemas !== undefined) {
+            this.#emittedSchemas.set(target, Object.freeze([...schemas]));
+        }
+    }
+    /**
+     * Creates handler metadata using generated arity metadata.
+     *
+     * @param entityType Entity class whose prototype owns the methods.
+     * @param stateSchema Generated schema for the entity state.
+     * @param define Callback that registers handlers with the builder.
+     * @param arities Generated arity metadata.
+     * @returns Frozen metadata for the entity class.
+     * @internal
+     */
+    defineArity(entityType, stateSchema, define, arities) {
+        return this.#define(entityType, stateSchema, define, arities);
+    }
+    #define(entityType, stateSchema, define, arities) {
+        const built = new WeakSet();
+        const builder = this.#builder(entityType, built, this.#arityMap(arities));
+        const handlers = Object.freeze([...define(builder)]);
+        this.#validateBuilt(handlers, built);
+        const metadata = {
+            entityType,
+            entity: describeEntityMetadata(stateSchema),
+            handlers,
+            commandAssignments: this.#ofKind(handlers, "command-assignment"),
+            commandReactions: this.#ofKind(handlers, "command-reaction"),
+            eventSubscriptions: this.#ofKind(handlers, "event-subscription"),
+            stateSubscriptions: this.#ofKind(handlers, "state-subscription"),
+            eventReactions: this.#ofKind(handlers, "event-reaction"),
+            eventApplications: this.#ofKind(handlers, "event-application"),
+        };
+        this.#authentic.add(metadata);
+        return Object.freeze(metadata);
+    }
+    #builder(entityType, built, arities) {
+        return Object.freeze({
+            assign: (schema, methodName) => this.#handler(entityType, "command-assignment", schema, methodName, built, arities),
+            command: (schema, methodName) => this.#handler(entityType, "command-reaction", schema, methodName, built, arities),
+            subscribe: (schema, methodName) => this.#handler(entityType, isEntitySchema(schema) ? "state-subscription" : "event-subscription", schema, methodName, built, arities),
+            react: (schema, methodName) => this.#handler(entityType, "event-reaction", schema, methodName, built, arities),
+            apply: (schema, methodName, options = {}) => {
+                const handler = Object.freeze({
+                    ...this.#handler(entityType, "event-application", schema, methodName, built),
+                    allowImport: options.allowImport ?? false,
+                });
+                built.add(handler);
+                return handler;
+            },
+        });
+    }
+    #handler(entityType, kind, schema, methodName, built, arities = new Map()) {
+        this.#validateMethod(entityType, methodName);
+        const generated = arities.get(this.#arityKey(kind, methodName));
+        const handler = Object.freeze({
+            kind,
+            schema,
+            descriptor: schema,
+            messageFullTypeName: schema.typeName,
+            methodName,
+            parameterCount: generated?.parameterCount ?? 1,
+            origin: generated?.origin ?? "domestic",
+            ...(generated?.where === undefined ? {} : { where: Object.freeze({ ...generated.where }) }),
+        });
+        if (generated?.emittedSchemas !== undefined) {
+            this.#emittedSchemas.set(handler, generated.emittedSchemas);
+        }
+        built.add(handler);
+        return handler;
+    }
+    #arityMap(arities) {
+        const result = new Map();
+        for (const arity of arities) {
+            result.set(this.#arityKey(arity.kind, arity.methodName), Object.freeze({
+                parameterCount: this.#parameterCount(arity.parameterCount),
+                origin: arity.origin ?? "domestic",
+                ...(arity.emittedSchemas === undefined
+                    ? {}
+                    : { emittedSchemas: Object.freeze([...arity.emittedSchemas]) }),
+                ...(arity.where === undefined ? {} : { where: Object.freeze({ ...arity.where }) }),
+            }));
+        }
+        return result;
+    }
+    #parameterCount(value) {
+        if (value === 1 || value === 2) {
+            return value;
+        }
+        throw new HandlerMetadataError("INVALID_PARAMETER_COUNT", `Handler metadata declares unsupported parameter count ${String(value)}.`);
+    }
+    #arityKey(kind, methodName) {
+        return `${kind}\u0000${methodName}`;
+    }
+    #validateBuilt(handlers, built) {
+        for (const handler of handlers) {
+            if (!built.has(handler)) {
+                throw new HandlerMetadataError("UNKNOWN_HANDLER_METHOD", "Handler metadata must be created by the registration builder.");
+            }
+        }
+    }
+    #validateMethod(entityType, methodName) {
+        const descriptor = Object.getOwnPropertyDescriptor(entityType.prototype, methodName);
+        if (methodName === "constructor" ||
+            descriptor === undefined ||
+            typeof descriptor.value !== "function") {
+            throw new HandlerMetadataError("UNKNOWN_HANDLER_METHOD", `Handler method "${methodName}" must be an own prototype data method declared with ` +
+                "normal class method syntax on the registered entity prototype.");
+        }
+    }
+    #ofKind(handlers, kind) {
+        return Object.freeze(handlers.filter((handler) => handler.kind === kind));
+    }
+}
+/**
+ * Internal metadata authority for handler registration, generated metadata, and cloning.
+ * @internal
+ */
+export const HandlerMetadataValues = Object.freeze(new EntityHandlersOwner());
+/**
+ * Defines metadata for explicitly registered entity handlers.
+ */
+export const EntityHandlers = Object.freeze({
+    define(entityType, stateSchema, define) {
+        return HandlerMetadataValues.define(entityType, stateSchema, define);
+    },
+});
+//# sourceMappingURL=handler-metadata.js.map

package/dist/handler/handler-metadata.js.map

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

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

@@ -0,0 +1,68 @@
+import type { EntityMetadata } from "../entity/entity-metadata.js";
+import type { EntityClass, EntityHandlersMetadata, HandlerMetadata, RegisteredHandlerMetadata } from "./handler-metadata.js";
+/**
+ * Frozen fields shared by a readiness entry and its registered handler.
+ */
+export interface ReadinessMetadataFields<Handler extends HandlerMetadata> {
+    /**
+     * Entity handler metadata that declared the handler.
+     */
+    readonly entityHandlers: EntityHandlersMetadata;
+    /**
+     * Entity class that owns the handler method.
+     */
+    readonly entityType: EntityClass;
+    /**
+     * Descriptor-derived metadata for the entity state.
+     */
+    readonly entity: EntityMetadata;
+    /**
+     * Handler metadata used by the readiness entry.
+     */
+    readonly handler: Handler;
+    /**
+     * Registered handler metadata used to create the entry.
+     */
+    readonly registeredHandler: RegisteredHandlerMetadata<Handler>;
+}
+/**
+ * Creates frozen readiness metadata without sharing mutable caller-owned records.
+ */
+declare class ReadinessMetadataOwner {
+    #private;
+    /**
+     * Compares fully qualified Protobuf type names in lexical order.
+     *
+     * @param left First type name.
+     * @param right Second type name.
+     * @returns A negative, zero, or positive comparison result.
+     */
+    compareTypeNames(left: string, right: string): number;
+    /**
+     * Creates cloned fields for a new readiness entry.
+     *
+     * @param registeredHandler Registered handler to clone.
+     * @returns Frozen fields with cloned metadata.
+     */
+    create<Handler extends HandlerMetadata>(registeredHandler: RegisteredHandlerMetadata<Handler>): ReadinessMetadataFields<Handler>;
+    /**
+     * Creates fields that retain already frozen registered metadata.
+     *
+     * @param registeredHandler Registered handler to retain.
+     * @returns Frozen fields sharing the registered metadata.
+     */
+    copy<Handler extends HandlerMetadata>(registeredHandler: RegisteredHandlerMetadata<Handler>): ReadinessMetadataFields<Handler>;
+    /**
+     * Copies map arrays into fresh frozen arrays.
+     *
+     * @param map Metadata arrays to copy.
+     * @returns A map containing fresh frozen arrays.
+     */
+    copyMap<Value>(map: ReadonlyMap<string, readonly Value[]>): ReadonlyMap<string, readonly Value[]>;
+}
+/**
+ * Creates frozen readiness metadata without sharing mutable caller-owned records.
+ */
+export declare const ReadinessMetadata: Readonly<ReadinessMetadataOwner>;
+export {};
+//# sourceMappingURL=registration-readiness-metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registration-readiness-metadata.d.ts","sourceRoot":"","sources":["../../src/handler/registration-readiness-metadata.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAGV,cAAc,EACf,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,yBAAyB,EAC1B,MAAM,uBAAuB,CAAC;AAG/B;;GAEG;AACH,MAAM,WAAW,uBAAuB,CAAC,OAAO,SAAS,eAAe;IAGtE;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,sBAAsB,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC,OAAO,CAAC,CAAC;CAChE;AAED;;GAEG;AACH,cAAM,sBAAsB;;IAG1B;;;;;;OAMG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAUrD;;;;;OAKG;IACH,MAAM,CAAC,OAAO,SAAS,eAAe,EACpC,iBAAiB,EAAE,yBAAyB,CAAC,OAAO,CAAC,GACpD,uBAAuB,CAAC,OAAO,CAAC;IAInC;;;;;OAKG;IACH,IAAI,CAAC,OAAO,SAAS,eAAe,EAClC,iBAAiB,EAAE,yBAAyB,CAAC,OAAO,CAAC,GACpD,uBAAuB,CAAC,OAAO,CAAC;IAInC;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EACX,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC,GACzC,WAAW,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;CAiLzC;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,sBAAsB,CAE9D,CAAC"}

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

@@ -0,0 +1,170 @@
+/*
+ * 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 { HandlerMetadataValues } from "./handler-metadata.js";
+/**
+ * Creates frozen readiness metadata without sharing mutable caller-owned records.
+ */
+class ReadinessMetadataOwner {
+    // prettier-ignore
+    /**
+     * Compares fully qualified Protobuf type names in lexical order.
+     *
+     * @param left First type name.
+     * @param right Second type name.
+     * @returns A negative, zero, or positive comparison result.
+     */
+    compareTypeNames(left, right) {
+        if (left < right) {
+            return -1;
+        }
+        if (left > right) {
+            return 1;
+        }
+        return 0;
+    }
+    /**
+     * Creates cloned fields for a new readiness entry.
+     *
+     * @param registeredHandler Registered handler to clone.
+     * @returns Frozen fields with cloned metadata.
+     */
+    create(registeredHandler) {
+        return this.#fields(this.#cloneRegistered(registeredHandler));
+    }
+    /**
+     * Creates fields that retain already frozen registered metadata.
+     *
+     * @param registeredHandler Registered handler to retain.
+     * @returns Frozen fields sharing the registered metadata.
+     */
+    copy(registeredHandler) {
+        return this.#fields(this.#copyRegistered(registeredHandler));
+    }
+    /**
+     * Copies map arrays into fresh frozen arrays.
+     *
+     * @param map Metadata arrays to copy.
+     * @returns A map containing fresh frozen arrays.
+     */
+    copyMap(map) {
+        const copy = new Map();
+        for (const [key, values] of map) {
+            copy.set(key, Object.freeze([...values]));
+        }
+        return copy;
+    }
+    #fields(registeredHandler) {
+        return Object.freeze({
+            entityHandlers: registeredHandler.entityHandlers,
+            entityType: registeredHandler.entityType,
+            entity: registeredHandler.entity,
+            handler: registeredHandler.handler,
+            registeredHandler,
+        });
+    }
+    #cloneRegistered(registeredHandler) {
+        const handlers = new Map();
+        const schemas = new WeakMap();
+        const fields = new Map();
+        const entity = this.#cloneEntity(registeredHandler.entity, schemas, fields);
+        const handler = this.#cloneHandler(registeredHandler.handler, handlers, schemas);
+        const entityHandlers = this.#cloneEntityHandlers(registeredHandler.entityHandlers, handlers, schemas, entity);
+        return Object.freeze({
+            entityHandlers,
+            entityType: registeredHandler.entityType,
+            entity,
+            handler,
+        });
+    }
+    #copyRegistered(registeredHandler) {
+        return Object.freeze({
+            entityHandlers: registeredHandler.entityHandlers,
+            entityType: registeredHandler.entityType,
+            entity: registeredHandler.entity,
+            handler: registeredHandler.handler,
+        });
+    }
+    #cloneEntityHandlers(entityHandlers, clonedHandlers, clonedSchemas, entity) {
+        return Object.freeze({
+            entityType: entityHandlers.entityType,
+            entity,
+            handlers: this.#cloneHandlers(entityHandlers.handlers, clonedHandlers, clonedSchemas),
+            commandAssignments: this.#cloneHandlers(entityHandlers.commandAssignments, clonedHandlers, clonedSchemas),
+            commandReactions: this.#cloneHandlers(entityHandlers.commandReactions, clonedHandlers, clonedSchemas),
+            eventSubscriptions: this.#cloneHandlers(entityHandlers.eventSubscriptions, clonedHandlers, clonedSchemas),
+            stateSubscriptions: this.#cloneHandlers(entityHandlers.stateSubscriptions, clonedHandlers, clonedSchemas),
+            eventReactions: this.#cloneHandlers(entityHandlers.eventReactions, clonedHandlers, clonedSchemas),
+            eventApplications: this.#cloneHandlers(entityHandlers.eventApplications, clonedHandlers, clonedSchemas),
+        });
+    }
+    #cloneHandlers(handlers, clonedHandlers, clonedSchemas) {
+        return Object.freeze(handlers.map((handler) => this.#cloneHandler(handler, clonedHandlers, clonedSchemas)));
+    }
+    #cloneHandler(handler, clonedHandlers, clonedSchemas) {
+        const existing = clonedHandlers.get(handler);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const clone = Object.freeze({
+            ...handler,
+            schema: this.#cloneSchema(handler.schema, clonedSchemas),
+            descriptor: this.#cloneSchema(handler.descriptor, clonedSchemas),
+        });
+        clonedHandlers.set(handler, clone);
+        HandlerMetadataValues.copyEmittedSchemas(handler, clone);
+        return clone;
+    }
+    #cloneEntity(entity, clonedSchemas, clonedFields) {
+        return Object.freeze({
+            ...entity,
+            schema: this.#cloneSchema(entity.schema, clonedSchemas),
+            descriptor: this.#cloneSchema(entity.descriptor, clonedSchemas),
+            idField: this.#cloneField(entity.idField, clonedFields),
+            firstFieldRoutingHint: Object.freeze({
+                ...entity.firstFieldRoutingHint,
+                field: this.#cloneField(entity.firstFieldRoutingHint.field, clonedFields),
+            }),
+            columns: Object.freeze(entity.columns.map((field) => this.#cloneField(field, clonedFields))),
+            setOnceFields: Object.freeze(entity.setOnceFields.map((field) => this.#cloneField(field, clonedFields))),
+        });
+    }
+    #cloneSchema(schema, clonedSchemas) {
+        const existing = clonedSchemas.get(schema);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const clone = this.#cloneFrozen(schema);
+        clonedSchemas.set(schema, clone);
+        return clone;
+    }
+    #cloneField(field, clonedFields) {
+        const existing = clonedFields.get(field);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const clone = Object.freeze({ ...field });
+        clonedFields.set(field, clone);
+        return clone;
+    }
+    #cloneFrozen(value) {
+        const clone = Object.create(Reflect.getPrototypeOf(value));
+        Object.defineProperties(clone, Object.getOwnPropertyDescriptors(value));
+        return Object.freeze(clone);
+    }
+}
+/**
+ * Creates frozen readiness metadata without sharing mutable caller-owned records.
+ */
+export const ReadinessMetadata = Object.freeze(new ReadinessMetadataOwner());
+//# sourceMappingURL=registration-readiness-metadata.js.map

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

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

package/dist/handler/rejection-source.d.ts

@@ -0,0 +1,11 @@
+interface RejectionSourceMatcher {
+    matches(sourceName: string): boolean;
+}
+/**
+ * Matches the two authored Proto filename forms reserved for domain rejections.
+ *
+ * @internal
+ */
+export declare const RejectionSources: Readonly<RejectionSourceMatcher>;
+export {};
+//# sourceMappingURL=rejection-source.d.ts.map