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

package/dist/handler/generated-handler-registry.d.ts

@@ -1,19 +1,16 @@
 import { type DescriptorMessageSchema } from "../entity/entity-metadata.js";
+import { AbstractAssignee, AbstractCommander, AbstractEventReactor, AbstractEventSubscriber } from "./standalone.js";
 import { HandlerMetadataRegistry, type EntityClass, type EntityHandlersMetadata, type HandlerMethodName, type HandlerOrigin, type WhereOptions } from "./handler-metadata.js";
 /**
- * Describes the generated handler registry module shape accepted by the framework ingestor.
+ * Generated registry metadata consumed by the framework.
  *
- * @internal
+ * Application code regenerates this data whenever the handler contract changes.
  */
 export interface GeneratedHandlerRegistry {
     /**
-     * Generated registry contract version.
+     * Unversioned Entity and standalone receiver declarations.
      */
-    readonly version: 3;
-    /**
-     * Entity handler groups declared by the generated module.
-     */
-    readonly entities: readonly GeneratedEntityHandlerGroup[];
+    readonly receivers: readonly GeneratedReceiver[];
 }
 /**
  * Framework-owned ingestion adapter for generated handler registries.
@@ -57,26 +54,24 @@ export declare class HandlerRegistryIngestionError extends Error {
 }
 /**
  * Describes handler categories supported by generated registry ingestion.
- *
- * @internal
  */
-export type GeneratedHandlerKind = "command-assignment" | "command-reaction" | "event-subscription" | "state-subscription" | "event-reaction";
+export type GeneratedHandlerKind = "command-assignment" | "command-substitution" | "command-reaction" | "event-subscription" | "state-subscription" | "event-reaction";
 /**
  * Describes public handler arity recorded by generated registry tooling.
- *
- * @internal
  */
 export type GeneratedHandlerParameterCount = 1 | 2;
 /**
- * Describes a type-erased generated entity group accepted by a top-level registry.
- *
- * @internal
+ * Describes a type-erased generated Entity group accepted by a top-level registry.
  */
 export interface GeneratedEntityHandlerGroup {
     /**
      * Entity class whose prototype owns the generated handler methods.
      */
-    readonly entityType: EntityClass;
+    readonly receiverKind: "entity";
+    /**
+     * Entity constructor matched to the generated receiver declaration.
+     */
+    readonly receiverType: EntityClass;
     /**
      * Generated Protobuf-ES schema for the entity state.
      */
@@ -86,16 +81,61 @@ export interface GeneratedEntityHandlerGroup {
      */
     readonly handlers: readonly GeneratedHandlerRecordInput[];
 }
+type StandaloneReceiver = AbstractAssignee | AbstractCommander | AbstractEventReactor | AbstractEventSubscriber;
+/**
+ * Constructor contract for a nominal standalone receiver.
+ *
+ * @typeParam Instance Concrete standalone receiver type.
+ */
+interface NominalStandaloneReceiverConstructor<Instance extends StandaloneReceiver> {
+    /**
+     * Prototype carrying the standalone receiver's nominal base-class brand.
+     */
+    readonly prototype: Instance;
+    /**
+     * Creates a standalone receiver instance.
+     *
+     * @param args Application-defined constructor arguments.
+     * @returns A nominal standalone receiver instance.
+     */
+    new (...args: any[]): Instance;
+}
+/**
+ * Nominal constructor for a supported standalone handler receiver.
+ */
+export type StandaloneReceiverConstructor = NominalStandaloneReceiverConstructor<AbstractAssignee> | NominalStandaloneReceiverConstructor<AbstractCommander> | NominalStandaloneReceiverConstructor<AbstractEventReactor> | NominalStandaloneReceiverConstructor<AbstractEventSubscriber>;
+/**
+ * Metadata for one decorated standalone application receiver.
+ */
+export interface GeneratedStandaloneHandlerGroup {
+    /**
+     * Marks this declaration as a standalone receiver.
+     */
+    readonly receiverKind: "standalone";
+    /**
+     * Constructor used to match a registered standalone application instance.
+     */
+    readonly receiverType: StandaloneReceiverConstructor;
+    /**
+     * Generated handler declarations in source order.
+     */
+    readonly handlers: readonly GeneratedHandlerRecordInput[];
+}
+/**
+ * One generated Entity or standalone receiver declaration.
+ */
+export type GeneratedReceiver = GeneratedEntityHandlerGroup | GeneratedStandaloneHandlerGroup;
 /**
  * Describes generated handler records for one entity class.
  *
- * @internal
+ * @typeParam Instance Entity receiver type.
+ * @typeParam StateSchema Generated Entity state schema type.
  */
 export interface GeneratedEntityHandlers<Instance extends object = object, StateSchema extends DescriptorMessageSchema = DescriptorMessageSchema> extends GeneratedEntityHandlerGroup {
     /**
      * Entity class whose prototype owns the generated handler methods.
      */
-    readonly entityType: EntityClass<Instance>;
+    readonly receiverType: EntityClass<Instance>;
     /**
      * Generated Protobuf-ES schema for the entity state.
      */
@@ -108,7 +148,6 @@ export interface GeneratedEntityHandlers<Instance extends object = object, State
 /**
  * Describes type-erased generated metadata for one decorated handler method.
  *
- * @internal
  */
 export interface GeneratedHandlerRecordInput {
     /**
@@ -116,34 +155,33 @@ export interface GeneratedHandlerRecordInput {
      */
     readonly kind: GeneratedHandlerKind;
     /**
-     * Entity instance method name selected by generated metadata.
+     * Receiver instance method name selected by generated metadata.
      */
     readonly methodName: string;
     /**
      * Generated Protobuf-ES schema accepted by the handler method.
      */
-    readonly signalSchema: DescriptorMessageSchema;
+    readonly input: {
+        readonly schema: DescriptorMessageSchema;
+        readonly origin: HandlerOrigin;
+        readonly where?: WhereOptions;
+    };
     /**
-     * Generated Protobuf-ES schemas emitted by the handler return type.
+     * Generated Protobuf-ES schemas returned normally or declared as thrown rejections.
      */
-    readonly emittedSchemas: readonly DescriptorMessageSchema[];
+    readonly outcomes: {
+        readonly returned: readonly DescriptorMessageSchema[];
+        readonly thrown: readonly DescriptorMessageSchema[];
+    };
     /**
      * Public method arity: `handler(signal)` or `handler(signal, context)`.
      */
     readonly parameterCount: GeneratedHandlerParameterCount;
-    /**
-     * Required origin inferred from the receptor's first parameter.
-     */
-    readonly origin: HandlerOrigin;
-    /**
-     * Optional generated Event field equality filter.
-     */
-    readonly where?: WhereOptions;
 }
 /**
  * Describes generated metadata for one decorated handler method on a concrete entity class.
  *
- * @internal
+ * @typeParam Instance Entity receiver type.
  */
 export interface GeneratedHandlerRecord<Instance extends object = object> extends GeneratedHandlerRecordInput {
     /**
@@ -151,4 +189,5 @@ export interface GeneratedHandlerRecord<Instance extends object = object> extend
      */
     readonly methodName: HandlerMethodName<Instance>;
 }
+export {};
 //# sourceMappingURL=generated-handler-registry.d.ts.map

package/dist/handler/generated-handler-registry.d.ts.map

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