@spine-event-engine/server 2.0.0-snapshot.25 → 2.0.0-snapshot.26

package/dist/handler/handler-decorators.js

@@ -11,8 +11,7 @@
  * or implied. See the License for the specific language governing permissions and limitations under
  * the License.
  */
-import { EntityHandlers, } from "./handler-metadata.js";
-const handlerDecoratorMetadataKey = Symbol("@spine-event-engine/server.handlerDecorators");
+import {} from "./handler-metadata.js";
 /**
  * Validates declared domain rejections for build-time handler discovery.
  *
@@ -45,53 +44,44 @@ export function Throws(...declarations) {
         throw new TypeError("@Throws cannot declare the same rejection more than once.");
     }
     return (_value, context) => {
-        DecoratorMetadata.methodName(context);
+        DecoratorValidation.methodName(context);
     };
 }
 /**
- * Creates command-assignment decorator metadata or a schema-bearing decorator.
+ * Validates a bare command-assignment declaration.
  *
- * @param schemaOrValue Command schema or decorated method implementation.
- * @param context Standard decorator context for bare usage.
- * @returns A decorator for schema-bearing usage, or `undefined` after bare usage.
+ * @param value Decorated method implementation.
+ * @param context Standard decorator context.
  */
-export function Assign(schemaOrValue, context) {
-    return DecoratorMetadata.decorateOrCreate("command-assignment", schemaOrValue, context);
+export function Assign(value, context) {
+    DecoratorValidation.method(value, context);
 }
 /**
- * Creates command-handler decorator metadata or a schema-bearing decorator.
- * Command input declares a Process Manager command substitution; Event or rejection
- * input declares an Event Bus command reaction. Schema-bearing metadata cannot
- * provide declared returned schemas and is rejected during materialization.
+ * Validates a bare command handler declaration.
  *
- * @param schemaOrValue Generated Command, Event, or rejection schema, or
- * decorated method implementation.
- * @param context Standard decorator context for bare usage.
- * @returns A decorator for schema-bearing usage, or `undefined` after bare usage.
+ * @param value Decorated method implementation.
+ * @param context Standard decorator context.
  */
-export function Command(schemaOrValue, context) {
-    return DecoratorMetadata.decorateOrCreate("command-reaction", schemaOrValue, context);
+export function Command(value, context) {
+    DecoratorValidation.method(value, context);
 }
 /**
- * Creates subscriber decorator metadata or a schema-bearing decorator.
+ * Validates a bare event subscription declaration.
  *
- * @param schemaOrValue Event, rejection, or descriptor-marked Entity state
- * schema, or the decorated method implementation.
- * @param context Standard decorator context for bare usage.
- * @returns A decorator for schema-bearing usage, or `undefined` after bare usage.
+ * @param value Decorated method implementation.
+ * @param context Standard decorator context.
  */
-export function Subscribe(schemaOrValue, context) {
-    return DecoratorMetadata.decorateOrCreate("event-subscription", schemaOrValue, context);
+export function Subscribe(value, context) {
+    DecoratorValidation.method(value, context);
 }
 /**
- * Creates event-reaction decorator metadata or a schema-bearing decorator.
+ * Validates a bare event reaction declaration.
  *
- * @param schemaOrValue Event schema or decorated method implementation.
- * @param context Standard decorator context for bare usage.
- * @returns A decorator for schema-bearing usage, or `undefined` after bare usage.
+ * @param value Decorated method implementation.
+ * @param context Standard decorator context.
  */
-export function React(schemaOrValue, context) {
-    return DecoratorMetadata.decorateOrCreate("event-reaction", schemaOrValue, context);
+export function React(value, context) {
+    DecoratorValidation.method(value, context);
 }
 /**
  * Creates one Event field equality filter for an Event-consuming handler.
@@ -107,62 +97,14 @@ export function Where(options) {
     const snapshot = WhereValues.snapshot(options);
     return (_value, context) => {
         void snapshot;
-        DecoratorMetadata.methodName(context);
+        DecoratorValidation.methodName(context);
     };
 }
-/**
- * Builds schema-bearing decorator declarations for framework compatibility.
- *
- * The returned object is the same frozen `EntityHandlersMetadata` contract
- * produced by `EntityHandlers.define()` and accepted by
- * `HandlerMetadataRegistry`. Only own prototype methods of `entityType` are
- * inspected; inherited decorated methods are intentionally not materialized by
- * this per-class adapter.
- *
- * Application code must not call this function and must not provide its own
- * handler discovery/materialization. Generated framework registries own schema
- * inference for bare decorators; this adapter only supports legacy
- * schema-bearing decorator metadata.
- *
- * @typeParam Instance Entity instance on which the handlers run.
- * @typeParam StateSchema - Schema that describes the entity state.
- * @param entityType Entity class whose own decorated methods are read.
- * @param stateSchema Schema that describes the entity state.
- * @returns Frozen handler metadata for the decorated methods.
- */
-export function materializeDecoratedEntityHandlers(entityType, stateSchema) {
-    const decoratedHandlers = DecoratorMetadata.collect(entityType);
-    return EntityHandlers.define(entityType, stateSchema, (builder) => decoratedHandlers.map((handler) => DecoratorMetadata.materializeLegacyHandler(builder, handler)));
-}
-const DecoratorMetadata = Object.freeze({
+const DecoratorValidation = Object.freeze({
     /**
-     * Builds legacy schema-bearing metadata for one decorated Entity method.
-     *
-     * @typeParam Instance Entity receiver type.
-     * @param builder Entity handler registration builder.
-     * @param handler Decorated method record.
-     * @returns Canonical handler metadata.
-     */
-    materializeLegacyHandler(builder, handler) {
-        const methodName = handler.methodName;
-        switch (handler.kind) {
-            case "command-assignment":
-                return builder.assign(DecoratorMetadata.schema(handler), methodName);
-            case "command-substitution":
-                throw new TypeError("Command substitutions require generated registry metadata with emitted schemas.");
-            case "command-reaction":
-                throw new TypeError("@Command handlers require generated registry metadata with emitted schemas.");
-            case "event-subscription":
-                return builder.subscribe(DecoratorMetadata.schema(handler), methodName);
-            case "event-reaction":
-                return builder.react(DecoratorMetadata.schema(handler), methodName);
-        }
-    },
-    /**
-     * Validates a public instance method and reads its string name.
+     * Validates a public instance method with a string name.
      *
      * @param context TypeScript decorator context identifying the method.
-     * @returns The method name used in handler metadata.
      */
     methodName(context) {
         if (context.static || context.private) {
@@ -171,137 +113,19 @@ const DecoratorMetadata = Object.freeze({
         if (typeof context.name !== "string") {
             throw new TypeError("Spine handler decorators require string-named methods.");
         }
-        return context.name;
-    },
-    /**
-     * Applies a bare decorator or creates the internal schema-bearing form.
-     *
-     * @param kind Handler role recorded for the method.
-     * @param schemaOrValue Decorated method, or schema for the internal form.
-     * @param context Present when TypeScript invokes a bare decorator.
-     * @returns The internal decorator, or undefined after bare decoration.
-     */
-    decorateOrCreate(kind, schemaOrValue, context) {
-        if (context !== undefined) {
-            DecoratorMetadata.create(kind)(schemaOrValue, context);
-            return undefined;
-        }
-        return DecoratorMetadata.create(kind, schemaOrValue);
-    },
-    /**
-     * Creates a decorator that appends immutable metadata for one method.
-     *
-     * @param kind Handler role recorded for the method.
-     * @param schema Optional schema supplied by internal compatibility tooling.
-     * @returns A standard TypeScript method decorator.
-     */
-    create(kind, schema) {
-        return (_value, context) => {
-            const methodName = DecoratorMetadata.methodName(context);
-            const record = Object.freeze({
-                kind,
-                ...(schema === undefined ? {} : { schema }),
-                methodName,
-            });
-            const metadata = DecoratorMetadata.require(context);
-            const previous = DecoratorMetadata.read(metadata);
-            Object.defineProperty(metadata, handlerDecoratorMetadataKey, {
-                configurable: true,
-                enumerable: false,
-                value: Object.freeze([...previous, record]),
-                writable: true,
-            });
-        };
-    },
-    /**
-     * Reads a legacy declaration's schema, rejecting bare declarations.
-     *
-     * @param handler Decorator record being materialized.
-     * @returns Its explicitly supplied message schema.
-     */
-    schema(handler) {
-        if (handler.schema === undefined) {
-            throw new TypeError(`Decorated handler "${handler.methodName}" was declared without a schema; ` +
-                "use generated registry metadata or explicit EntityHandlers.define() registration.");
-        }
-        return handler.schema;
-    },
-    /**
-     * Reads handler declarations for methods defined on this class prototype.
-     *
-     * @typeParam Instance Entity instance represented by the constructor.
-     * @param entityType Constructor whose declared handlers are collected.
-     * @returns A frozen list of matching decorator records.
-     */
-    collect(entityType) {
-        const metadata = DecoratorMetadata.classMetadata(entityType);
-        if (metadata === undefined) {
-            return Object.freeze([]);
-        }
-        const records = DecoratorMetadata.read(metadata).filter((record) => {
-            const descriptor = Object.getOwnPropertyDescriptor(entityType.prototype, record.methodName);
-            return typeof descriptor?.value === "function";
-        });
-        return Object.freeze(records);
-    },
-    /**
-     * Initializes Symbol.metadata when the runtime does not yet supply it.
-     *
-     * @returns The existing or newly installed decorator metadata symbol.
-     */
-    installSymbol() {
-        const existingMetadata = Reflect.get(Symbol, "metadata");
-        if (typeof existingMetadata === "symbol") {
-            return existingMetadata;
-        }
-        const metadata = Symbol("Symbol.metadata");
-        Object.defineProperty(Symbol, "metadata", {
-            configurable: true,
-            enumerable: false,
-            value: metadata,
-            writable: false,
-        });
-        return metadata;
-    },
-    /**
-     * Reads TypeScript's class metadata object, rejecting missing support.
-     *
-     * @param context Decorator context with optional runtime metadata support.
-     * @returns The writable class metadata object.
-     */
-    require(context) {
-        if (context.metadata === undefined) {
-            throw new TypeError("Spine handler decorators require standard decorator metadata support.");
-        }
-        return context.metadata;
-    },
-    /**
-     * Reads metadata defined directly on the Entity constructor.
-     *
-     * @typeParam Instance Entity instance represented by the constructor.
-     * @param entityType Constructor whose metadata is inspected.
-     * @returns Its metadata object, or undefined when none is present.
-     */
-    classMetadata(entityType) {
-        const descriptor = Object.getOwnPropertyDescriptor(entityType, decoratorMetadataSymbol);
-        const metadata = descriptor?.value;
-        if (metadata === null || typeof metadata !== "object") {
-            return undefined;
-        }
-        return metadata;
     },
     /**
-     * Reads Spine handler records without inheriting a parent metadata array.
+     * Validates one bare method decorator invocation.
      *
-     * @param metadata Class metadata object to inspect.
-     * @returns Stored handler records, or an empty list when absent.
+     * @param value Decorated method implementation.
+     * @param context Standard method decorator context.
      */
-    read(metadata) {
-        if (!Object.hasOwn(metadata, handlerDecoratorMetadataKey)) {
-            return [];
+    method(value, context) {
+        const suppliedContext = context;
+        if (suppliedContext?.kind !== "method" || typeof value !== "function") {
+            throw new TypeError("Spine handler decorators require a standard method decorator context.");
         }
-        const value = metadata[handlerDecoratorMetadataKey];
-        return Array.isArray(value) ? value : [];
+        DecoratorValidation.methodName(context);
     },
 });
 const WhereValues = Object.freeze({
@@ -328,5 +152,4 @@ const WhereValues = Object.freeze({
         return Object.freeze({ eventField: options.eventField, equals: options.equals });
     },
 });
-const decoratorMetadataSymbol = DecoratorMetadata.installSymbol();
 //# sourceMappingURL=handler-decorators.js.map

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

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

package/dist/handler/spine-metadata-inventory.d.ts

@@ -0,0 +1,99 @@
+import type { Message } from "@bufbuild/protobuf";
+import type { GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { ProtoModule } from "@spine-event-engine/proto";
+import { type GeneratedHandlerRegistry } from "./generated-handler-registry.js";
+/**
+ * Passive model and handler descriptions emitted by one package.
+ */
+export interface SpineMetadata extends GeneratedHandlerRegistry {
+    /**
+     * Local model module registered through the ordinary Proto inventory.
+     */
+    readonly protoModule?: ProtoModule;
+    /**
+     * Passive application query implementations declared in this package.
+     */
+    readonly appQueries?: readonly AppQueryDescription[];
+    /**
+     * Returns metadata from direct participating runtime dependencies.
+     *
+     * The accessor runs only when bootstrap registration traverses and validates the graph.
+     *
+     * @returns Direct passive metadata values for validation.
+     */
+    readonly dependencies?: () => readonly unknown[];
+}
+/**
+ * Exact implementation constructor and generated request/result schemas.
+ */
+export interface AppQueryDescription {
+    /**
+     * Concrete handler class; registration does not construct it.
+     */
+    readonly handlerType: {
+        readonly name: string;
+        readonly prototype: object;
+    };
+    /**
+     * Generated request message name.
+     */
+    readonly queryTypeName: string;
+    /**
+     * Generated request schema.
+     */
+    readonly querySchema: GenMessage<Message>;
+    /**
+     * Generated result schema.
+     */
+    readonly responseSchema: GenMessage<Message>;
+}
+/**
+ * Runtime constructor identity used to index passive descriptions.
+ */
+interface ReceiverConstructor {
+    readonly name: string;
+    readonly prototype: unknown;
+}
+/**
+ * Registers validated passive descriptions without selecting application handlers.
+ *
+ * @param metadata Generated package descriptions.
+ * @param moduleId Generated metadata module identifier for diagnostics.
+ */
+export declare const SpineMetadataInventory: Readonly<{
+    /**
+     * Registers passive handler and query descriptions from one module.
+     */
+    register(metadata: SpineMetadata, moduleId: string): void;
+    /**
+     * Checks that one App Query description matches its generated pair.
+     */
+    validateQuery(query: AppQueryDescription): void;
+    /**
+     * Selects handlers registered for explicitly supplied constructors.
+     */
+    select(constructors: readonly ReceiverConstructor[]): GeneratedHandlerRegistry;
+    /**
+     * Selects App Query descriptions for explicitly supplied handler types.
+     */
+    selectQueries(constructors: readonly AppQueryDescription["handlerType"][]): readonly AppQueryDescription[];
+}>;
+/**
+ * Preserves compatibility with bootstraps emitted before grouped inventory registration.
+ */
+export declare const registerSpineMetadata: typeof SpineMetadataInventory.register;
+/**
+ * Preserves compatibility with direct inventory selection callers.
+ */
+export declare const spineMetadataFor: typeof SpineMetadataInventory.select;
+/**
+ * Test-facing reset for independent metadata assembly cases.
+ */
+export declare const spineMetadataTestAccess: Readonly<{
+    /**
+     * Clears registrations between independent metadata tests.
+     */
+    clear(): void;
+}>;
+export {};
+//# sourceMappingURL=spine-metadata-inventory.d.ts.map

package/dist/handler/spine-metadata-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spine-metadata-inventory.d.ts","sourceRoot":"","sources":["../../src/handler/spine-metadata-inventory.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,EAEL,KAAK,wBAAwB,EAE9B,MAAM,iCAAiC,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,wBAAwB;IAC7D;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAErD;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,SAAS,OAAO,EAAE,CAAC;CAClD;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAE5E;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CAC9C;AAUD;;GAEG;AACH,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAyCD;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC;IAC5C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1D;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAEhD;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,SAAS,mBAAmB,EAAE,GAAG,wBAAwB,CAAC;IAE/E;;OAEG;IACH,aAAa,CACX,YAAY,EAAE,SAAS,mBAAmB,CAAC,aAAa,CAAC,EAAE,GAC1D,SAAS,mBAAmB,EAAE,CAAC;CACnC,CAsGC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,OAAO,sBAAsB,CAAC,QACjC,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,OAAO,sBAAsB,CAAC,MAAsC,CAAC;AAEpG;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC;IAC7C;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf,CAQC,CAAC"}

package/dist/handler/spine-metadata-inventory.js

@@ -0,0 +1,162 @@
+/*
+ * 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 { AppQueryHandler } from "./app-query-handler.js";
+import { HandlerRegistryIngestor, } from "./generated-handler-registry.js";
+const receivers = new Map();
+const queries = new Map();
+const MetadataGraph = Object.freeze({
+    /**
+     * Collects and validates every passive metadata dependency before registration.
+     *
+     * @param root Root passive metadata value.
+     * @returns Validated metadata graph.
+     */
+    collect(root) {
+        const seen = new Set();
+        const pending = [root];
+        const collected = [];
+        while (pending.length > 0) {
+            const next = pending.pop();
+            if (typeof next !== "object" || next === null || Array.isArray(next))
+                throw new TypeError("Spine metadata dependency must be an object.");
+            const item = next;
+            if (seen.has(item))
+                continue;
+            seen.add(item);
+            collected.push(item);
+            const accessor = item.dependencies;
+            if (accessor !== undefined) {
+                if (typeof accessor !== "function")
+                    throw new TypeError("Spine metadata dependencies must be an accessor.");
+                const dependencies = accessor();
+                if (!Array.isArray(dependencies))
+                    throw new TypeError("Spine metadata dependencies must be an array.");
+                for (const dependency of dependencies)
+                    pending.push(dependency);
+            }
+        }
+        return collected;
+    },
+});
+/**
+ * Registers validated passive descriptions without selecting application handlers.
+ *
+ * @param metadata Generated package descriptions.
+ * @param moduleId Generated metadata module identifier for diagnostics.
+ */
+export const SpineMetadataInventory = Object.freeze({
+    /**
+     * Registers validated passive descriptions without selecting application handlers.
+     *
+     * @param metadata Generated package descriptions.
+     * @param moduleId Generated metadata module identifier for diagnostics.
+     */
+    register(metadata, moduleId) {
+        if (moduleId.trim().length === 0)
+            throw new TypeError("Spine metadata module ID is required.");
+        const collected = MetadataGraph.collect(metadata);
+        const stagedQueries = new Map();
+        const staged = new Map();
+        for (const item of collected) {
+            new HandlerRegistryIngestor().ingest(item);
+            for (const query of item.appQueries ?? []) {
+                SpineMetadataInventory.validateQuery(query);
+                const prior = stagedQueries.get(query.handlerType) ?? queries.get(query.handlerType)?.description;
+                if (prior !== undefined && prior !== query)
+                    throw new Error(`Spine App Query metadata for ${query.handlerType.name} conflicts.`);
+                stagedQueries.set(query.handlerType, query);
+            }
+            for (const receiver of item.receivers) {
+                const constructor = receiver.receiverType;
+                const prior = staged.get(constructor) ?? receivers.get(constructor);
+                if (prior !== undefined && prior.receiver !== receiver)
+                    throw new Error(`Spine metadata for ${constructor.name} conflicts between ${prior.moduleId} and ${moduleId}.`);
+                staged.set(constructor, { receiver, moduleId });
+            }
+        }
+        for (const [constructor, entry] of staged)
+            receivers.set(constructor, entry);
+        for (const [constructor, description] of stagedQueries)
+            queries.set(constructor, { description, moduleId });
+    },
+    /**
+     * Checks a passive query description before it enters process metadata.
+     *
+     * @param query Generated constructor and paired schema description.
+     */
+    validateQuery(query) {
+        const value = query;
+        if (value?.handlerType?.prototype === undefined ||
+            !(value.handlerType.prototype instanceof AppQueryHandler))
+            throw new TypeError("App Query metadata requires a concrete AppQueryHandler class.");
+        if (value.querySchema?.kind !== "message" ||
+            value.querySchema.typeName !== value.queryTypeName ||
+            !value.queryTypeName?.endsWith(".Query"))
+            throw new TypeError("App Query metadata requires its generated Query schema.");
+        const expected = `${value.queryTypeName.slice(0, -".Query".length)}.Response`;
+        if (value.responseSchema?.kind !== "message" || value.responseSchema.typeName !== expected)
+            throw new TypeError("App Query metadata requires its paired Response schema.");
+    },
+    /**
+     * Selects passive descriptions by exact constructor identity.
+     *
+     * @param constructors Entity and standalone constructors selected by an application.
+     * @returns Only descriptions for selected classes.
+     */
+    select(constructors) {
+        const selected = constructors.map((constructor) => {
+            const entry = receivers.get(constructor);
+            if (entry === undefined)
+                throw new Error(`Generated metadata for ${constructor.name} is missing. Generate and import the ` +
+                    `package's spine-bootstrap.js before BoundedContext assembly.`);
+            return entry.receiver;
+        });
+        return Object.freeze({ receivers: Object.freeze(selected) });
+    },
+    /**
+     * Selects passive query descriptions by exact implementation constructor.
+     *
+     * @param constructors Application-supplied handler classes.
+     * @returns Only matching descriptions in caller order.
+     */
+    selectQueries(constructors) {
+        return Object.freeze(constructors.map((constructor) => {
+            const query = queries.get(constructor);
+            if (query === undefined)
+                throw new Error(`Generated App Query metadata for ${constructor.name} is missing.`);
+            return query.description;
+        }));
+    },
+});
+/**
+ * Preserves compatibility with bootstraps emitted before grouped inventory registration.
+ */
+export const registerSpineMetadata = SpineMetadataInventory.register;
+/**
+ * Preserves compatibility with direct inventory selection callers.
+ */
+export const spineMetadataFor = SpineMetadataInventory.select;
+/**
+ * Test-facing reset for independent metadata assembly cases.
+ */
+export const spineMetadataTestAccess = Object.freeze({
+    /**
+     * Clears process-local descriptions between isolated tests.
+     */
+    clear() {
+        receivers.clear();
+        queries.clear();
+    },
+});
+//# sourceMappingURL=spine-metadata-inventory.js.map

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

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

package/dist/index.d.ts

@@ -2,14 +2,16 @@ export { BoundedContext, BoundedContextBuilder, type BoundedContextBuildOptions,
 export { ThirdPartyContext } from "./integration/third-party-context.js";
 export type { TenantIndex, TenantIndexCursor, TenantIndexPage, TenantIndexRead, TenantIndexSignal, } from "./context/tenant-index.js";
 export { TenantUnknownError } from "./context/tenant-unknown-error.js";
-export { Stand, type StandOptions, type StandReadOptions, type StandReadResult, type StandRegisterOptions, type StandSubscribeOptions, type StandSubscription, StandStateTypeError, type StandUpdate, type StandUpdateOptions, } from "./stand/stand.js";
+export { Stand, type StandOptions, type StandReadOptions, type StandReadResult, type StandRegisterOptions, type StandSubscribeOptions, type StandSubscription, type StandObserver, StandSubscriptionCapacityError, StandStateTypeError, type StandUpdate, type StandUpdateOptions, } from "./stand/stand.js";
 export { InMemorySubscriptionRegistry, StorageSubscriptionRegistry, StandConflictError, type StandActivateResult, type StandCleanupResult, type StandCreateResult, type StandDeleteResult, type StandSubscriptionEntry, type StandSubscriptionRegistry, } from "./stand/subscription-registry.js";
 export { SpineServices, type SpineServicesOptions } from "./services/spine-services.js";
-export { Server, type ListenerLifecycle, type RunningServer, type ServerOptions, } from "./server/server.js";
+export { Server, type ListenerLifecycle, type RunningServer, type ServerOptions, type ServerQueryExecutionContext, } from "./server/server.js";
 export { ManagedServerApplication, type ManagedServerApplicationHandle, type ManagedServerApplicationOptions, type ManagedServerRestartOptions, } from "./server/managed-server-application.js";
 export { Environment, EnvironmentType } from "./server/environment.js";
 export { ServerEnvironment, type ServerEnvironmentCloseable, type ServerEnvironmentDelivery, type ServerEnvironmentSettings, } from "./server/server-environment.js";
 export { CommandBus } from "./bus/command-bus.js";
+export { AppQueryHandler, type AppQueryContext } from "./handler/app-query-handler.js";
+export { ReadSideFilter, type ReadSideContext, type ReadSideField, type ReadSideOperation, } from "./stand/read-side-filter.js";
 export type { CommandDispatcher } from "./bus/command-dispatcher.js";
 export { EventBus } from "./bus/event-bus.js";
 export type { EventDispatcher } from "./bus/event-dispatcher.js";
@@ -39,7 +41,7 @@ export type { InterfaceRouteMessage } from "./repository/routing-declarations.js
 export { EventRouting, type EventRoute } from "./repository/event-routing.js";
 export { StateUpdateRouting, type StateUpdateRoute } from "./repository/state-update-routing.js";
 export { type AgentHistoryReader, type AgentReadScope, type ConcreteRepositoryEntityType, Repository, type RepositoryCommandRoute, type RepositoryEntityType, type RepositoryEntityId, type RepositoryEventRoute, RepositoryIdentityError, type RepositoryIdentityErrorCode, type RepositoryIdentitySnapshot, type RepositoryOptions, type RepositoryReadQueries, type RepositoryRouteInvocation, type RepositoryStateSchema, type RepositoryView, } from "./repository/repository.js";
-export { Assign, Command, type HandlerMethodDecorator, type HandlerMethodValue, React, Subscribe, Throws, Where, type RejectionDeclaration, type WhereOptions, materializeDecoratedEntityHandlers, } from "./handler/handler-decorators.js";
+export { Assign, Command, type HandlerMethodDecorator, type HandlerMethodValue, React, Subscribe, Throws, Where, type RejectionDeclaration, type WhereOptions, } from "./handler/handler-decorators.js";
 export type { External } from "./handler/external.js";
 export { AbstractAssignee, AbstractCommander, AbstractEventReactor, AbstractEventSubscriber, } from "./handler/standalone.js";
 export { GeneratedRegistryDiscovery, GeneratedRegistryDiscoveryError, type GeneratedRegistryDiscoveryOptions, type RegistryDiscoveryErrorCode, } from "./handler/generated-registry-discovery.js";