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

package/dist/repository/state-update-routing.d.ts

@@ -7,7 +7,7 @@ import { type InterfaceRouteSchemas, type InterfaceRouteMessage, type RoutingDec
  * Calculates target Entity IDs for one accepted Entity state update.
  *
  * The route must be deterministic and side-effect-free. It runs once during
- * admission; durable replay uses the stored target instead.
+ * admission; durable Inbox delivery uses the stored target instead.
  *
  * @typeParam Id Entity ID type used by the receiving Projection repository.
  * @typeParam Schema Generated Entity state message schema.

package/dist/repository/state-update-routing.js

@@ -54,7 +54,7 @@ export class StateUpdateRouting {
      *
      * Copied or malformed tokens fail during declaration. Every token member must
      * be registered by the repository, or construction fails. The selected route
-     * runs once for an accepted admission; durable replay uses stored targets and
+     * runs once for an accepted admission; durable Inbox delivery uses stored targets and
      * does not run routing again.
      *
      * @param schemaOrToken Generated Entity-state schema or nominal message-interface token.

package/dist/runtime/signal-publisher.d.ts

@@ -2,13 +2,28 @@ import { type Command, type Event } from "@spine-event-engine/proto";
 import type { ILogLayer } from "loglayer";
 import { CommandBus } from "../bus/command-bus.js";
 import { EventBus } from "../bus/event-bus.js";
+/**
+ * Categories of produced-signal publication attempts.
+ */
 type PublicationKind = "command" | "event" | "rejection-event" | "system-event" | "stored-event";
+/**
+ * Observes produced signals in test fixtures without changing publication.
+ */
 interface ProducedSignalObserver {
+    /**
+     * Receives a produced Command.
+     */
     readonly onCommand?: (command: Readonly<Command>) => void;
+    /**
+     * Receives a produced Event.
+     */
     readonly onEvent?: (event: Readonly<Event>) => void;
 }
 /**
  * Publishes produced signals and contains their detached dispatch failures for one context.
+ * Completion follows each registered dispatcher's Promise. Repository-backed
+ * Entity recipients finish after Inbox receipt; custom dispatchers retain
+ * their own completion contract.
  *
  * @internal
  */
@@ -24,17 +39,17 @@ export declare class SignalPublisher {
      */
     constructor(commandBus: CommandBus, eventBus: EventBus, systemEventBus: EventBus, contextName: string);
     /**
-     * Publishes a produced Command for detached handling.
+     * Publishes a produced Command through one tracked bus handoff attempt.
      *
      * @param command The produced Command envelope.
-     * @returns A promise that settles after the Command is handled or its failure is contained.
+     * @returns Completion after registered dispatchers settle or a handoff failure is contained.
      */
     publishCommand(command: Command): Promise<void>;
     /**
-     * Publishes a produced Event for detached handling.
+     * Publishes a produced Event through one tracked bus handoff attempt.
      *
      * @param event The produced Event envelope.
-     * @returns A promise that settles after the Event is handled or its failure is contained.
+     * @returns Completion after registered dispatchers settle or a handoff failure is contained.
      */
     publishEvent(event: Event): Promise<void>;
     /**
@@ -42,25 +57,25 @@ export declare class SignalPublisher {
      *
      * @internal
      * @param event The rejection Event envelope.
-     * @returns A promise that settles after detached rejection handling is contained.
+     * @returns Completion after registered dispatchers settle or a handoff failure is contained.
      */
     publishRejectionEvent(event: Event): Promise<void>;
     /**
      * Dispatches a committed Entity Event once after persistence.
      * @param event The committed Event envelope.
-     * @returns Completion after dispatch or contained failure.
+     * @returns Completion after registered dispatchers settle or a handoff failure is contained.
      */
     publishCommittedEvent(event: Event): Promise<void>;
     /**
      * Dispatches a committed reactor or Process Manager Event once as follow-up work.
      * @param event The committed Event envelope.
-     * @returns Completion after dispatch or contained failure.
+     * @returns Completion after registered dispatchers settle or a handoff failure is contained.
      */
     publishReactorEvent(event: Event): Promise<void>;
     /**
      * Dispatches a produced System Event once, persisting it when configured.
      * @param event The produced System Event envelope.
-     * @returns Completion after dispatch or contained failure.
+     * @returns Completion after registered dispatchers settle or a handoff failure is contained.
      */
     publishSystemEvent(event: Event): Promise<void>;
     /**

package/dist/runtime/signal-publisher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signal-publisher.d.ts","sourceRoot":"","sources":["../../src/runtime/signal-publisher.ts"],"names":[],"mappings":"AAeA,OAAO,EAA8B,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACjG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,EAAoB,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAkB,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/D,KAAK,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,iBAAiB,GAAG,cAAc,GAAG,cAAc,CAAC;AAEjG,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;CACrD;AAED;;;;GAIG;AACH,qBAAa,eAAe;;IAyC1B;;;;;;;OAOG;gBAED,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,QAAQ,EACxB,WAAW,EAAE,MAAM;IAQrB;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC;;;;;;OAMG;IACH,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlD;;;;OAIG;IACH,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlD;;;;OAIG;IACH,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IA6B/F;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAItC;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;;OAGG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,aAAa,IAAI,IAAI;IAKrB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;KAAE;IA4CzE;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM;CAK7D"}
+{"version":3,"file":"signal-publisher.d.ts","sourceRoot":"","sources":["../../src/runtime/signal-publisher.ts"],"names":[],"mappings":"AAeA,OAAO,EAA8B,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACjG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,OAAO,EAAoB,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAkB,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/D;;GAEG;AACH,KAAK,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,iBAAiB,GAAG,cAAc,GAAG,cAAc,CAAC;AAOjG;;GAEG;AACH,UAAU,sBAAsB;IAC9B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAE1D;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;CACrD;AAED;;;;;;;GAOG;AACH,qBAAa,eAAe;;IAyC1B;;;;;;;OAOG;gBAED,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,QAAQ,EACxB,WAAW,EAAE,MAAM;IAQrB;;;;;OAKG;IACH,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC;;;;;;OAMG;IACH,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlD;;;;OAIG;IACH,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlD;;;;OAIG;IACH,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IA6B/F;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAItC;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;;OAGG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,aAAa,IAAI,IAAI;IAKrB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,sBAAsB,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;KAAE;IA4CzE;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM;CAK7D"}

package/dist/runtime/signal-publisher.js

@@ -18,6 +18,9 @@ import { eventBusAccess, EventBus } from "../bus/event-bus.js";
 import { emitServerError } from "../server/server-log.js";
 /**
  * Publishes produced signals and contains their detached dispatch failures for one context.
+ * Completion follows each registered dispatcher's Promise. Repository-backed
+ * Entity recipients finish after Inbox receipt; custom dispatchers retain
+ * their own completion contract.
  *
  * @internal
  */
@@ -69,19 +72,19 @@ export class SignalPublisher {
         this.#contextName = contextName;
     }
     /**
-     * Publishes a produced Command for detached handling.
+     * Publishes a produced Command through one tracked bus handoff attempt.
      *
      * @param command The produced Command envelope.
-     * @returns A promise that settles after the Command is handled or its failure is contained.
+     * @returns Completion after registered dispatchers settle or a handoff failure is contained.
      */
     publishCommand(command) {
         return this.#publish("command", command, () => commandBusAccess.postInternalFollowUp(this.#commandBus, command));
     }
     /**
-     * Publishes a produced Event for detached handling.
+     * Publishes a produced Event through one tracked bus handoff attempt.
      *
      * @param event The produced Event envelope.
-     * @returns A promise that settles after the Event is handled or its failure is contained.
+     * @returns Completion after registered dispatchers settle or a handoff failure is contained.
      */
     publishEvent(event) {
         return this.#publish("event", event, () => eventBusAccess.postFollowUp(this.#eventBus, event));
@@ -91,7 +94,7 @@ export class SignalPublisher {
      *
      * @internal
      * @param event The rejection Event envelope.
-     * @returns A promise that settles after detached rejection handling is contained.
+     * @returns Completion after registered dispatchers settle or a handoff failure is contained.
      */
     publishRejectionEvent(event) {
         return this.#publish("rejection-event", event, () => eventBusAccess.postFollowUp(this.#eventBus, event));
@@ -99,7 +102,7 @@ export class SignalPublisher {
     /**
      * Dispatches a committed Entity Event once after persistence.
      * @param event The committed Event envelope.
-     * @returns Completion after dispatch or contained failure.
+     * @returns Completion after registered dispatchers settle or a handoff failure is contained.
      */
     publishCommittedEvent(event) {
         const snapshot = clone(EventSchema, event);
@@ -108,7 +111,7 @@ export class SignalPublisher {
     /**
      * Dispatches a committed reactor or Process Manager Event once as follow-up work.
      * @param event The committed Event envelope.
-     * @returns Completion after dispatch or contained failure.
+     * @returns Completion after registered dispatchers settle or a handoff failure is contained.
      */
     publishReactorEvent(event) {
         const snapshot = clone(EventSchema, event);
@@ -117,7 +120,7 @@ export class SignalPublisher {
     /**
      * Dispatches a produced System Event once, persisting it when configured.
      * @param event The produced System Event envelope.
-     * @returns Completion after dispatch or contained failure.
+     * @returns Completion after registered dispatchers settle or a handoff failure is contained.
      */
     publishSystemEvent(event) {
         const snapshot = clone(EventSchema, event);

package/dist/runtime/signal-publisher.js.map

@@ -1 +1 @@
-{"version":3,"file":"signal-publisher.js","sourceRoot":"","sources":["../../src/runtime/signal-publisher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"signal-publisher.js","sourceRoot":"","sources":["../../src/runtime/signal-publisher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,WAAW,EAA4B,MAAM,2BAA2B,CAAC;AAGjG,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AA2B1D;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IAC1B;;OAEG;IACM,WAAW,CAAa;IAEjC;;OAEG;IACM,SAAS,CAAW;IAE7B;;OAEG;IACM,eAAe,CAAW;IAEnC;;OAEG;IACM,YAAY,CAAS;IAE9B;;OAEG;IACM,SAAS,GAAG,IAAI,GAAG,EAAiB,CAAC;IAE9C;;OAEG;IACM,UAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;IAExD;;OAEG;IACH,OAAO,CAAwB;IAE/B;;OAEG;IACH,MAAM,GAAmB,MAAM,CAAC;IAEhC;;;;;;;OAOG;IACH,YACE,UAAsB,EACtB,QAAkB,EAClB,cAAwB,EACxB,WAAmB;QAEnB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,OAAgB;QAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,CAC5C,gBAAgB,CAAC,oBAAoB,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CACjE,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,KAAY;QACvB,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IACjG,CAAC;IAED;;;;;;OAMG;IACH,qBAAqB,CAAC,KAAY;QAChC,OAAO,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,CAClD,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CACnD,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,qBAAqB,CAAC,KAAY;QAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAC3C,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CACpD,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,KAAY;QAC9B,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAC3C,cAAc,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAC5D,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,KAAY;QAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,EAAE,GAAG,EAAE,CAClD,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAC5D,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,IAAqB,EAAE,MAAmC,EAAE,KAAc;QACtF,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO;QACjC,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS,CAAC;QACjC,IAAI,CAAC;YACH,eAAe,CAAC,MAAM,EAAE,kCAAkC,EAAE;gBAC1D,WAAW,EAAE,IAAI,CAAC,YAAY;gBAC9B,GAAG,CAAC,KAAK;oBACP,CAAC,CAAC;wBACE,OAAO,EAAE,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC;wBACzC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,IAAI,SAAS;qBACjD;oBACH,CAAC,CAAC;wBACE,SAAS,EAAE,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC;wBAC3C,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,IAAI,SAAS;qBACnD,CAAC;gBACN,SAAS,EAAE,yBAAyB;gBACpC,UAAU,EAAE,iBAAiB;gBAC7B,SAAS,EACP,KAAK,YAAY,KAAK;oBACtB,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;oBACzE,CAAC,CAAC,KAAK,CAAC,IAAI;oBACZ,CAAC,CAAC,SAAS;aAChB,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,mFAAmF;QACrF,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,MAAiB;QAC7B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW;QACT,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;QACvB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,QAAgC;QACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,QAAQ,CACN,IAAqB,EACrB,MAAuB,EACvB,OAA4B;QAE5B,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;YACzE,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACrC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;YAC1C,CAAC,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE;aAC9B,IAAI,CAAC,GAAG,EAAE;YACT,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAC5E,OAAO,OAAO,EAAE,CAAC;QACnB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QACL,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5B,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,QAAQ,CAAC,IAAqB,EAAE,MAAuB;QACrD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,IAAI,IAAI,KAAK,SAAS;oBAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,MAAiB,CAAC,CAAC,CAAC;gBACtF,IAAI,IAAI,KAAK,OAAO;oBAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,MAAe,CAAC,CAAC,CAAC;YAChF,CAAC;YAAC,MAAM,CAAC;gBACP,iEAAiE;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAmC;QACjD,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC;QACtB,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACvC,OAAO,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC;IAC3C,CAAC;CACF"}

package/dist/server/managed-server-application.d.ts

@@ -1,6 +1,6 @@
 import { type ChildProcess } from "node:child_process";
 import { type RunningServer } from "./server.js";
-import { NodeCoordinator, type ReadyCoordinatorMember } from "./node-coordinator.js";
+import { NodeCoordinator, type NodeCoordinatorOptions, type ReadyCoordinatorMember } from "./node-coordinator.js";
 import { InMemorySubscriptionRegistry } from "../stand/subscription-registry.js";
 import type { Subscription } from "@spine-event-engine/proto/client";
 /**
@@ -94,6 +94,14 @@ export interface ManagedServerApplicationOptions {
      * @returns Completion after child-local prerequisites are established.
      */
     readonly synchronize?: () => Promise<void>;
+    /**
+     * Authenticates direct and forwarded requests at the managed Coordinator.
+     */
+    readonly readerAdmission?: NodeCoordinatorOptions["readerAdmission"];
+    /**
+     * Issues fresh operation-bound proofs from the Coordinator to children.
+     */
+    readonly forwardingProof?: NodeCoordinatorOptions["forwardingProof"];
     /**
      *
      * Configures bounded private process replacement.
@@ -124,10 +132,8 @@ export interface ManagedServerApplicationHandle {
  */
 export declare const ManagedServerApplication: Readonly<{
     /**
-     *
      * Starts a managed parent and complete-replica children without taking
      * process-signal handling.
-     *
      * The caller closes the returned handle. This is for an embedding host that
      * already handles `SIGINT` and `SIGTERM`.
      *
@@ -136,7 +142,6 @@ export declare const ManagedServerApplication: Readonly<{
      */
     start(options: ManagedServerApplicationOptions): Promise<ManagedServerApplicationHandle>;
     /**
-     *
      * Starts a managed parent and complete-replica children with process-signal
      * ownership.
      *
@@ -158,14 +163,12 @@ export interface ManagedServerCoordinatorDependencies {
      */
     readonly clock: {
         /**
-         *
          * Reads the current clock value.
          *
          * @returns The current time in milliseconds.
          */
         now(): number;
         /**
-         *
          * Schedules a timeout callback.
          *
          * @param onTimeout Runs when the requested delay elapses.
@@ -174,7 +177,6 @@ export interface ManagedServerCoordinatorDependencies {
          */
         setTimeout(onTimeout: () => void, delay: number): unknown;
         /**
-         *
          * Cancels a scheduled timeout.
          *
          * @param timer Identifies the timer to cancel.
@@ -204,6 +206,9 @@ export interface ManagedServerCoordinatorDependencies {
         readonly port?: number;
     }) => Promise<NodeCoordinator>;
 }
+/**
+ * Coordinator settings with a port assigned during managed startup.
+ */
 type ManagedServerCoordinatorOptions = Omit<ManagedServerApplicationOptions, "port"> & {
     readonly port?: number;
     readonly manageProcessSignals?: boolean;
@@ -217,7 +222,6 @@ type ManagedServerCoordinatorOptions = Omit<ManagedServerApplicationOptions, "po
 export declare class ManagedServerCoordinator {
     #private;
     /**
-     *
      * Creates a coordinator for one configured replica cohort.
      *
      * @param options Configures complete child application replicas.
@@ -225,21 +229,18 @@ export declare class ManagedServerCoordinator {
      */
     constructor(options: ManagedServerCoordinatorOptions, dependencies?: ManagedServerCoordinatorDependencies);
     /**
-     *
      * Starts every initial replica and waits until all report READY.
      *
      * @returns The handle for the started managed cohort.
      */
     start(): Promise<ManagedServerApplicationHandle>;
     /**
-     *
      * Stops managed children and prevents later replacement starts.
      *
      * @returns Completion after child and retired-child cleanup succeeds.
      */
     close(): Promise<void>;
     /**
-     *
      * Returns ready child facts to the next Coordinator slice.
      *
      * @returns The ready child topology facts.

package/dist/server/managed-server-application.d.ts.map

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

package/dist/server/managed-server-application.js

@@ -18,7 +18,7 @@ import { fileURLToPath } from "node:url";
 import { LogLayer, StructuredTransport } from "loglayer";
 import { runningServerAccess } from "./server.js";
 import { emitServerWarning } from "./server-log.js";
-import { NodeCoordinator } from "./node-coordinator.js";
+import { NodeCoordinator, } from "./node-coordinator.js";
 import { managedDeliveryGate } from "./managed-delivery-gate.js";
 import { managedChildSubscriptionAccess } from "./managed-child-subscription.js";
 import { InMemorySubscriptionRegistry } from "../stand/subscription-registry.js";
@@ -188,7 +188,6 @@ class ManagedChildLifecycle {
         this.#server = server;
     }
     /**
-     *
      * Starts the child and waits for Coordinator activation.
      *
      * @returns A child handle after the private READY notification.
@@ -220,7 +219,6 @@ class ManagedChildLifecycle {
         return { ready: true, close: () => this.close() };
     }
     /**
-     *
      * Closes Delivery before closing the child listener and its server.
      *
      * @returns The shared close attempt; a failed attempt may be retried.
@@ -233,7 +231,6 @@ class ManagedChildLifecycle {
         return this.#closing;
     }
     /**
-     *
      * Performs child shutdown and observes a failed completion notification.
      *
      * @returns Completion after the child server closes.
@@ -253,7 +250,6 @@ class ManagedChildLifecycle {
         }
     }
     /**
-     *
      * Stops new child Delivery work and awaits admitted effects.
      *
      * @returns Completion when admitted work drains.
@@ -267,7 +263,6 @@ class ManagedChildLifecycle {
         await runningServerAccess.drainDelivery(this.#server);
     }
     /**
-     *
      * Waits for parent relay cancellation before closing the child listener.
      *
      * @returns Completion after final server close.
@@ -280,7 +275,6 @@ class ManagedChildLifecycle {
         await this.#server.close();
     }
     /**
-     *
      * Sends one child lifecycle notification on the private IPC channel.
      *
      * @param type The lifecycle phase to report.
@@ -364,7 +358,6 @@ export class ManagedServerCoordinator {
     #onSignal;
     #nodeCoordinator;
     /**
-     *
      * Creates a coordinator for one configured replica cohort.
      *
      * @param options Configures complete child application replicas.
@@ -384,7 +377,6 @@ export class ManagedServerCoordinator {
         }));
     }
     /**
-     *
      * Starts every initial replica and waits until all report READY.
      *
      * @returns The handle for the started managed cohort.
@@ -398,11 +390,41 @@ export class ManagedServerCoordinator {
         for (const slot of this.#slots)
             this.#start(slot);
         await this.#ready;
+        await this.#openCoordinator();
+        /**
+         * Reports whether any managed replica has announced readiness.
+         */
+        const isReady = () => this.#slots.some((slot) => slot.replica?.readyAt !== undefined);
+        const handle = {
+            /**
+             * Checks whether a managed application has reached the ready state.
+             *
+             * @returns Whether the application is ready.
+             */ get ready() {
+                return isReady();
+            },
+            close: () => this.close(),
+        };
+        handleMembers.set(handle, this);
+        return handle;
+    }
+    /**
+     * Opens the reader-aware Coordinator after the first replica is ready.
+     *
+     * @returns Completion after the operation settles.
+     */
+    async #openCoordinator() {
         try {
             const openCoordinator = this.#dependencies.openCoordinator;
             if (openCoordinator !== undefined)
                 this.#nodeCoordinator = await openCoordinator({
                     members: this,
+                    ...(this.#options.readerAdmission === undefined
+                        ? {}
+                        : { readerAdmission: this.#options.readerAdmission }),
+                    ...(this.#options.forwardingProof === undefined
+                        ? {}
+                        : { forwardingProof: this.#options.forwardingProof }),
                     ...(this.#options.host === undefined ? {} : { host: this.#options.host }),
                     ...(this.#options.port === undefined ? {} : { port: this.#options.port }),
                 });
@@ -416,15 +438,6 @@ export class ManagedServerCoordinator {
             }
             throw error;
         }
-        const isReady = () => this.#slots.some((slot) => slot.replica?.readyAt !== undefined);
-        const handle = {
-            get ready() {
-                return isReady();
-            },
-            close: () => this.close(),
-        };
-        handleMembers.set(handle, this);
-        return handle;
     }
     /**
      * Starts a child for an available slot while respecting the concurrent-start limit.
@@ -689,7 +702,6 @@ export class ManagedServerCoordinator {
     }
     /**
      * Fills available concurrent-start capacity with unscheduled empty slots.
-     *
      */
     #drainStarts() {
         for (const slot of this.#slots) {
@@ -700,7 +712,6 @@ export class ManagedServerCoordinator {
         }
     }
     /**
-     *
      * Stops managed children and prevents later replacement starts.
      *
      * @returns Completion after child and retired-child cleanup succeeds.
@@ -719,6 +730,8 @@ export class ManagedServerCoordinator {
     }
     /**
      * Stops replacement starts and awaits all cleanup phases.
+     *
+     * @returns Completion after the operation settles.
      */
     async #closeGracefully() {
         this.#closing = true;
@@ -752,9 +765,11 @@ export class ManagedServerCoordinator {
     }
     /**
      * Cancels relays, releases children, and closes the Coordinator after a drain attempt.
+     *
      * @param replicas The active children being closed.
      * @param children The already-running bounded child close attempts.
      * @param failures Errors collected from the drain phase.
+     * @returns Completion after the operation settles.
      */
     async #finishClose(replicas, children, failures) {
         try {
@@ -880,7 +895,6 @@ export class ManagedServerCoordinator {
         return termination;
     }
     /**
-     *
      * Returns ready child facts to the next Coordinator slice.
      *
      * @returns The ready child topology facts.
@@ -1025,7 +1039,6 @@ export class ManagedServerCoordinator {
     }
     /**
      * Calls listeners after the available child membership changes.
-     *
      */
     #notifyReadyMembers() {
         for (const listener of this.#memberListeners)
@@ -1033,7 +1046,6 @@ export class ManagedServerCoordinator {
     }
     /**
      * Registers managed shutdown handlers for SIGINT and SIGTERM once.
-     *
      */
     #installSignalHandlers() {
         if (this.#onSignal !== undefined)
@@ -1057,7 +1069,6 @@ export class ManagedServerCoordinator {
     }
     /**
      * Unregisters managed shutdown handlers when the coordinator closes.
-     *
      */
     #removeSignalHandlers() {
         if (this.#onSignal === undefined)
@@ -1458,7 +1469,12 @@ const ManagedServerCoordinatorValues = Object.freeze({
         });
     },
 });
-function canonicalLoopbackEndpoint(value) {
+/**
+ * Accepts only a canonical local endpoint for a managed child.
+ *
+ * @param value Candidate managed-child endpoint URL.
+ * @returns The canonical endpoint, or undefined if invalid.
+ */ function canonicalLoopbackEndpoint(value) {
     if (Buffer.byteLength(value, "utf8") > endpointMaximumBytes)
         return undefined;
     try {