@fluojs/cqrs 1.1.2 → 3.0.0

package/dist/buses/shutdown-deadline.js

@@ -0,0 +1,31 @@
+/** Coordinates one absolute CQRS shutdown deadline across lifecycle drain hooks. */
+export class CqrsShutdownDeadline {
+  deadlineMs;
+
+  /**
+   * Starts the shared deadline once.
+   *
+   * @param timeoutMs Configured CQRS shutdown drain duration.
+   */
+  start(timeoutMs) {
+    this.deadlineMs ??= Date.now() + timeoutMs;
+  }
+
+  /**
+   * Returns the remaining duration from the shared deadline.
+   *
+   * @returns Remaining duration in milliseconds, or `undefined` before shutdown starts.
+   */
+  remainingTimeoutMs() {
+    return this.deadlineMs === undefined ? undefined : Math.max(0, this.deadlineMs - Date.now());
+  }
+
+  /**
+   * Returns the absolute timestamp for the shared deadline.
+   *
+   * @returns Absolute deadline in milliseconds, or `undefined` before shutdown starts.
+   */
+  deadlineAtMs() {
+    return this.deadlineMs;
+  }
+}

package/dist/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,WAAW,EACX,aAAa,EAGb,SAAS,EAEV,MAAM,YAAY,CAAC;AAEpB,KAAK,kBAAkB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;AA0DpF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,kBAAkB,CAU3E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,kBAAkB,CAUrE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,aAAa,GAAG,kBAAkB,CAUzE;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,SAAS,aAAa,EAAE,GAAG,kBAAkB,CAYnG"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,WAAW,EACX,aAAa,EAGb,SAAS,EAEV,MAAM,YAAY,CAAC;AAEpB,KAAK,kBAAkB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;AA2EpF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,kBAAkB,CAU3E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,kBAAkB,CAUrE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,aAAa,GAAG,kBAAkB,CAUzE;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,SAAS,aAAa,EAAE,GAAG,kBAAkB,CAYnG"}

package/dist/decorators.js

@@ -31,6 +31,20 @@ function defineStandardSagaMetadata(metadata, sagaMetadata) {
     eventTypes: [...sagaMetadata.eventTypes]
   };
 }
+function isConstructableClass(value) {
+  if (typeof value !== 'function') {
+    return false;
+  }
+  try {
+    Reflect.construct(Object, [], value);
+    return true;
+  } catch (error) {
+    if (error instanceof TypeError) {
+      return false;
+    }
+    throw error;
+  }
+}
 function normalizeSagaEventTypes(eventTypeOrTypes) {
   const eventTypes = Array.isArray(eventTypeOrTypes) ? eventTypeOrTypes : [eventTypeOrTypes];
   const uniqueEventTypes = Array.from(new Set(eventTypes));
@@ -38,7 +52,7 @@ function normalizeSagaEventTypes(eventTypeOrTypes) {
     throw new Error('@Saga() requires at least one event type.');
   }
   for (const eventType of uniqueEventTypes) {
-    if (typeof eventType !== 'function') {
+    if (!isConstructableClass(eventType)) {
       throw new Error('@Saga() event types must be class constructors.');
     }
   }

package/dist/discovery.d.ts

@@ -22,10 +22,26 @@ export interface DiscoveryCandidate {
 export declare function createDuplicateHandlerMessage(kind: 'command' | 'query' | 'event', messageType: Function, first: {
     moduleName: string;
     targetType: Function;
+    token: Token;
 }, second: {
     moduleName: string;
     targetType: Function;
+    token: Token;
 }): string;
+/**
+ * Checks whether two discovered handler candidates refer to the same provider registration.
+ *
+ * @param first The first handler registration.
+ * @param second The second handler registration.
+ * @returns Whether both target type and provider token match.
+ */
+export declare function isSameHandlerRegistration(first: {
+    targetType: Function;
+    token: Token;
+}, second: {
+    targetType: Function;
+    token: Token;
+}): boolean;
 /**
  * Represents the cqrs bus base.
  */
@@ -36,6 +52,8 @@ export declare abstract class CqrsBusBase {
     protected readonly handlerInstances: Map<Token, Promise<unknown>>;
     constructor(runtimeContainer: Container, compiledModules: readonly CompiledModule[], logger: ApplicationLogger);
     protected discoveryCandidates(): DiscoveryCandidate[];
+    private resolveProviderDiscoveryCandidate;
+    private createUnresolvedProviderDiscoveryCandidate;
     protected preloadHandlerInstance(token: Token): Promise<void>;
     protected resolveHandlerInstance(token: Token): Promise<unknown>;
 }

package/dist/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;IAC7C,UAAU,EAAE,QAAQ,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;CACd;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,EACnC,WAAW,EAAE,QAAQ,EACrB,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,QAAQ,CAAA;CAAE,EACnD,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,QAAQ,CAAA;CAAE,GACnD,MAAM,CAER;AAED;;GAEG;AACH,8BAAsB,WAAW;IAI7B,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,SAAS;IAC9C,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,SAAS,cAAc,EAAE;IAC7D,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB;IAL9C,SAAS,CAAC,QAAQ,CAAC,gBAAgB,+BAAsC;gBAGpD,gBAAgB,EAAE,SAAS,EAC3B,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,MAAM,EAAE,iBAAiB;IAG9C,SAAS,CAAC,mBAAmB,IAAI,kBAAkB,EAAE;cAsCrC,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;cAgBnD,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;CAiBvE"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAQzE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;IAC7C,UAAU,EAAE,QAAQ,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;CACd;AA4CD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,EACnC,WAAW,EAAE,QAAQ,EACrB,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,EACjE,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACjE,MAAM,CAER;AAMD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE;IAAE,UAAU,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,EAC7C,MAAM,EAAE;IAAE,UAAU,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAC7C,OAAO,CAET;AAED;;GAEG;AACH,8BAAsB,WAAW;IAI7B,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,SAAS;IAC9C,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,SAAS,cAAc,EAAE;IAC7D,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB;IAL9C,SAAS,CAAC,QAAQ,CAAC,gBAAgB,+BAAsC;gBAGpD,gBAAgB,EAAE,SAAS,EAC3B,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,MAAM,EAAE,iBAAiB;IAG9C,SAAS,CAAC,mBAAmB,IAAI,kBAAkB,EAAE;IA2CrD,OAAO,CAAC,iCAAiC;IA+CzC,OAAO,CAAC,0CAA0C;cAmBlC,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;cAgBnD,sBAAsB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;CAiBvE"}

package/dist/discovery.js

@@ -1,4 +1,9 @@
-import { getClassDiMetadata } from '@fluojs/core/internal';
+import { formatTokenName } from '@fluojs/core';
+import { getRuntimeClassDiMetadata } from '@fluojs/runtime/internal';
+import { getCommandHandlerMetadata } from './metadata.js';
+import { getEventHandlerMetadata } from './metadata.js';
+import { getQueryHandlerMetadata } from './metadata.js';
+import { getSagaMetadata } from './metadata.js';
 
 /**
  * Describes the discovery candidate contract.
@@ -6,16 +11,26 @@ import { getClassDiMetadata } from '@fluojs/core/internal';
 
 function scopeFromProvider(provider) {
   if (typeof provider === 'function') {
-    return getClassDiMetadata(provider)?.scope ?? 'singleton';
+    return getRuntimeClassDiMetadata(provider)?.scope ?? 'singleton';
   }
   if ('useClass' in provider) {
-    return provider.scope ?? getClassDiMetadata(provider.useClass)?.scope ?? 'singleton';
+    return provider.scope ?? getRuntimeClassDiMetadata(provider.useClass)?.scope ?? 'singleton';
   }
-  return 'scope' in provider ? provider.scope ?? 'singleton' : 'singleton';
+  if ('useFactory' in provider) {
+    const resolverClass = provider.resolverClass;
+    return provider.scope ?? (resolverClass ? getRuntimeClassDiMetadata(resolverClass)?.scope : undefined) ?? 'singleton';
+  }
+  return 'singleton';
 }
 function isClassProvider(provider) {
   return typeof provider === 'object' && provider !== null && 'useClass' in provider;
 }
+function isFactoryOrValueProvider(provider) {
+  return typeof provider === 'object' && provider !== null && ('useFactory' in provider || 'useValue' in provider);
+}
+function hasCqrsMetadata(targetType) {
+  return getCommandHandlerMetadata(targetType) !== undefined || getQueryHandlerMetadata(targetType) !== undefined || getEventHandlerMetadata(targetType) !== undefined || getSagaMetadata(targetType) !== undefined;
+}
 
 /**
  * Create duplicate handler message.
@@ -27,7 +42,21 @@ function isClassProvider(provider) {
  * @returns The create duplicate handler message result.
  */
 export function createDuplicateHandlerMessage(kind, messageType, first, second) {
-  return `Duplicate ${kind} handler for ${messageType.name} was discovered in ${first.moduleName}.${first.targetType.name} and ${second.moduleName}.${second.targetType.name}.`;
+  return `Duplicate ${kind} handler for ${messageType.name} was discovered in ${describeHandlerRegistration(first)} and ${describeHandlerRegistration(second)}.`;
+}
+function describeHandlerRegistration(registration) {
+  return `${registration.moduleName}.${registration.targetType.name} [token: ${formatTokenName(registration.token)}]`;
+}
+
+/**
+ * Checks whether two discovered handler candidates refer to the same provider registration.
+ *
+ * @param first The first handler registration.
+ * @param second The second handler registration.
+ * @returns Whether both target type and provider token match.
+ */
+export function isSameHandlerRegistration(first, second) {
+  return first.targetType === second.targetType && first.token === second.token;
 }
 
 /**
@@ -42,6 +71,7 @@ export class CqrsBusBase {
   }
   discoveryCandidates() {
     const candidates = [];
+    const providerCandidates = [];
     for (const compiledModule of this.compiledModules) {
       for (const provider of compiledModule.definition.providers ?? []) {
         if (typeof provider === 'function') {
@@ -60,19 +90,72 @@ export class CqrsBusBase {
             targetType: provider.useClass,
             token: provider.provide
           });
+          continue;
+        }
+        if (isFactoryOrValueProvider(provider)) {
+          providerCandidates.push({
+            moduleName: compiledModule.type.name,
+            provider
+          });
         }
       }
-      for (const controller of compiledModule.definition.controllers ?? []) {
-        candidates.push({
-          moduleName: compiledModule.type.name,
-          scope: scopeFromProvider(controller),
-          targetType: controller,
-          token: controller
-        });
+    }
+    for (const candidate of providerCandidates) {
+      const resolvedCandidate = this.resolveProviderDiscoveryCandidate(candidate);
+      if (resolvedCandidate) {
+        candidates.push(resolvedCandidate);
       }
     }
     return candidates;
   }
+  resolveProviderDiscoveryCandidate(candidate) {
+    const provider = candidate.provider;
+    if (!('provide' in provider)) {
+      return undefined;
+    }
+    const scope = scopeFromProvider(provider);
+    const token = provider.provide;
+    if (scope !== 'singleton') {
+      return this.createUnresolvedProviderDiscoveryCandidate(candidate.moduleName, token, scope);
+    }
+    if ('useValue' in provider) {
+      const instance = provider.useValue;
+      if (typeof instance !== 'object' || instance === null) {
+        return undefined;
+      }
+      const targetType = instance.constructor;
+      if (typeof targetType !== 'function' || !hasCqrsMetadata(targetType)) {
+        return undefined;
+      }
+      return {
+        moduleName: candidate.moduleName,
+        scope,
+        targetType,
+        token
+      };
+    }
+    if (typeof token !== 'function' || !hasCqrsMetadata(token)) {
+      return undefined;
+    }
+    return {
+      moduleName: candidate.moduleName,
+      scope,
+      targetType: token,
+      token
+    };
+  }
+  createUnresolvedProviderDiscoveryCandidate(moduleName, token, scope) {
+    const tokenType = typeof token === 'function' ? token : undefined;
+    if (!tokenType) {
+      return undefined;
+    }
+    return {
+      moduleName,
+      scope,
+      targetType: tokenType,
+      token
+    };
+  }
   async preloadHandlerInstance(token) {
     if (this.handlerInstances.has(token)) {
       return;

package/dist/dispatch-context.d.ts

@@ -0,0 +1,35 @@
+import type { Token } from '@fluojs/core';
+import type { SagaContinuationScope } from './buses/saga-continuation.js';
+import type { CqrsDispatchContext, CqrsEventType } from './types.js';
+/** One active saga route retained in private CQRS dispatch state. */
+export interface CqrsDispatchRoute {
+    readonly eventType: CqrsEventType;
+    readonly token: Token;
+}
+/** Private saga topology state associated with an opaque dispatch context. */
+export interface CqrsSagaTopologyState {
+    readonly activeRoutes: readonly CqrsDispatchRoute[];
+    readonly depth: number;
+    readonly path: readonly string[];
+}
+/** Private state carried by an internally created dispatch context. */
+export interface InternalCqrsDispatchContextState {
+    readonly publishDrainToken: symbol | undefined;
+    readonly sagaContinuationScope: SagaContinuationScope | undefined;
+    readonly sagaTopology: CqrsSagaTopologyState | undefined;
+}
+/**
+ * Creates an opaque immutable dispatch context and retains its state in a private weak map.
+ *
+ * @param state Internal publish-drain and saga-topology state.
+ * @returns A frozen fieldless context safe to pass through application handlers.
+ */
+export declare function createInternalCqrsDispatchContext(state: InternalCqrsDispatchContextState): CqrsDispatchContext;
+/**
+ * Reads private state only for context values created by CQRS internals.
+ *
+ * @param context Optional public dispatch context received from a handler or saga.
+ * @returns The immutable internal state, or `undefined` for caller-created values.
+ */
+export declare function getInternalCqrsDispatchContextState(context: CqrsDispatchContext | undefined): InternalCqrsDispatchContextState | undefined;
+//# sourceMappingURL=dispatch-context.d.ts.map

package/dist/dispatch-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-context.d.ts","sourceRoot":"","sources":["../src/dispatch-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAErE,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED,8EAA8E;AAC9E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,uEAAuE;AACvE,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,YAAY,EAAE,qBAAqB,GAAG,SAAS,CAAC;CAC1D;AAcD;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,gCAAgC,GAAG,mBAAmB,CAW9G;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,mBAAmB,GAAG,SAAS,GACvC,gCAAgC,GAAG,SAAS,CAE9C"}

package/dist/dispatch-context.js

@@ -0,0 +1,43 @@
+/** One active saga route retained in private CQRS dispatch state. */
+
+/** Private saga topology state associated with an opaque dispatch context. */
+
+/** Private state carried by an internally created dispatch context. */
+
+const internalContextStates = new WeakMap();
+function freezeSagaTopology(state) {
+  return Object.freeze({
+    activeRoutes: Object.freeze(state.activeRoutes.map(route => Object.freeze({
+      eventType: route.eventType,
+      token: route.token
+    }))),
+    depth: state.depth,
+    path: Object.freeze([...state.path])
+  });
+}
+
+/**
+ * Creates an opaque immutable dispatch context and retains its state in a private weak map.
+ *
+ * @param state Internal publish-drain and saga-topology state.
+ * @returns A frozen fieldless context safe to pass through application handlers.
+ */
+export function createInternalCqrsDispatchContext(state) {
+  const context = Object.freeze({});
+  internalContextStates.set(context, Object.freeze({
+    publishDrainToken: state.publishDrainToken,
+    sagaContinuationScope: state.sagaContinuationScope,
+    sagaTopology: state.sagaTopology ? freezeSagaTopology(state.sagaTopology) : undefined
+  }));
+  return context;
+}
+
+/**
+ * Reads private state only for context values created by CQRS internals.
+ *
+ * @param context Optional public dispatch context received from a handler or saga.
+ * @returns The immutable internal state, or `undefined` for caller-created values.
+ */
+export function getInternalCqrsDispatchContextState(context) {
+  return context ? internalContextStates.get(context) : undefined;
+}

package/dist/errors.d.ts

@@ -36,9 +36,11 @@ export declare class DuplicateQueryHandlerError extends FluoError {
     constructor(message: string);
 }
 /**
- * Raised when conflicting event-handler registrations break CQRS discovery invariants.
+ * Compatibility error type retained for existing imports.
  *
- * Ordinary multiple `@EventHandler(...)` providers for the same event are valid and fan out.
+ * Event-handler discovery does not throw this error. Repeated discovery of the same singleton provider token and event
+ * type is silently deduplicated, while distinct singleton provider tokens remain valid fan-out routes in discovery
+ * order.
  */
 export declare class DuplicateEventHandlerError extends FluoError {
     /**

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,wFAAwF;AACxF,qBAAa,+BAAgC,SAAQ,SAAS;IAC5D;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAG5B;AAED,iFAAiF;AACjF,qBAAa,4BAA6B,SAAQ,SAAS;IACzD;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAG5B;AAED,oFAAoF;AACpF,qBAAa,6BAA8B,SAAQ,SAAS;IAC1D;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAG5B;AAED,+EAA+E;AAC/E,qBAAa,0BAA2B,SAAQ,SAAS;IACvD;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAG5B;AAED;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,SAAS;IACvD;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAG5B;AAED,0EAA0E;AAC1E,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAG5B;AAED,8EAA8E;AAC9E,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAG5B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,wFAAwF;AACxF,qBAAa,+BAAgC,SAAQ,SAAS;IAC5D;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAG5B;AAED,iFAAiF;AACjF,qBAAa,4BAA6B,SAAQ,SAAS;IACzD;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAG5B;AAED,oFAAoF;AACpF,qBAAa,6BAA8B,SAAQ,SAAS;IAC1D;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAG5B;AAED,+EAA+E;AAC/E,qBAAa,0BAA2B,SAAQ,SAAS;IACvD;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAG5B;AAED;;;;;;GAMG;AACH,qBAAa,0BAA2B,SAAQ,SAAS;IACvD;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAG5B;AAED,0EAA0E;AAC1E,qBAAa,kBAAmB,SAAQ,SAAS;IAC/C;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAG5B;AAED,8EAA8E;AAC9E,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C;;;;OAIG;gBACS,OAAO,EAAE,MAAM;CAG5B"}

package/dist/errors.js

@@ -57,9 +57,11 @@ export class DuplicateQueryHandlerError extends FluoError {
 }
 
 /**
- * Raised when conflicting event-handler registrations break CQRS discovery invariants.
+ * Compatibility error type retained for existing imports.
  *
- * Ordinary multiple `@EventHandler(...)` providers for the same event are valid and fan out.
+ * Event-handler discovery does not throw this error. Repeated discovery of the same singleton provider token and event
+ * type is silently deduplicated, while distinct singleton provider tokens remain valid fan-out routes in discovery
+ * order.
  */
 export class DuplicateEventHandlerError extends FluoError {
   /**

package/dist/module.d.ts

@@ -18,7 +18,10 @@ export interface CqrsModuleOptions {
 /** Runtime module entrypoint for CQRS bus registration and handler discovery. */
 export declare class CqrsModule {
     /**
-     * Registers the CQRS buses globally and wires them to the event-bus integration.
+     * Registers CQRS buses and wires them to the event-bus integration.
+     *
+     * The exported buses are global by default. Set {@link CqrsModuleOptions.global} to `false` to
+     * keep them visible only through modules that import this module definition.
      *
      * @param options CQRS module options including explicit handler classes and event-bus settings.
      * @returns A module definition that exports the lifecycle services and compatibility tokens.

package/dist/module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAOhE,OAAO,KAAK,EACV,mBAAmB,EAEnB,iBAAiB,EAIjB,iBAAiB,EACjB,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,4FAA4F;AAC5F,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,aAAa,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B,8GAA8G;IAC9G,QAAQ,CAAC,EAAE;QACT,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAgGD,iFAAiF;AACjF,qBAAa,UAAU;IACrB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU;CAiB5D"}
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAQhE,OAAO,KAAK,EACV,mBAAmB,EAEnB,iBAAiB,EAIjB,iBAAiB,EACjB,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,4FAA4F;AAC5F,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,aAAa,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B,8GAA8G;IAC9G,QAAQ,CAAC,EAAE;QACT,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAkHD,iFAAiF;AACjF,qBAAa,UAAU;IACrB;;;;;;;;OAQG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU;CAkB5D"}

package/dist/module.js

@@ -4,6 +4,7 @@ import { CommandBusLifecycleService } from './buses/command-bus.js';
 import { CqrsEventBusService } from './buses/event-bus.js';
 import { QueryBusLifecycleService } from './buses/query-bus.js';
 import { CqrsSagaLifecycleService } from './buses/saga-bus.js';
+import { CqrsShutdownDeadline } from './buses/shutdown-deadline.js';
 import { COMMAND_BUS, CQRS_MODULE_OPTIONS, EVENT_BUS, QUERY_BUS } from './tokens.js';
 
 /** Module options for registering first-party handler classes and event-bus integration. */
@@ -24,6 +25,18 @@ function collectOptionHandlerProviders(options) {
   }
   return providers;
 }
+function resolveDelegatedEventBusOptions(options) {
+  const eventBusOptions = options.eventBus ?? {};
+  const eventBusShutdown = eventBusOptions.shutdown;
+  return {
+    ...eventBusOptions,
+    global: eventBusOptions.global ?? options.global ?? true,
+    shutdown: {
+      ...eventBusShutdown,
+      drainTimeoutMs: eventBusShutdown?.drainTimeoutMs ?? options.shutdown?.drainTimeoutMs
+    }
+  };
+}
 function assertCommandBusService(service) {
   if (!(service instanceof CommandBusLifecycleService)) {
     throw new TypeError('CQRS command bus alias expected CommandBusLifecycleService.');
@@ -46,10 +59,13 @@ function assertCqrsEventBusService(service) {
  * @param options CQRS module options including eager handler classes and event-bus configuration.
  * @returns Providers for the command, query, event, and saga runtimes plus compatibility tokens.
  */
-function createCqrsProviders(options = {}) {
+function createCqrsProviders(options, shutdownDeadline) {
   return [{
     provide: CQRS_MODULE_OPTIONS,
     useValue: options
+  }, {
+    provide: CqrsShutdownDeadline,
+    useValue: shutdownDeadline
   }, CommandBusLifecycleService, {
     inject: [CommandBusLifecycleService],
     provide: COMMAND_BUS,
@@ -84,18 +100,22 @@ function createCqrsProviders(options = {}) {
 /** Runtime module entrypoint for CQRS bus registration and handler discovery. */
 export class CqrsModule {
   /**
-   * Registers the CQRS buses globally and wires them to the event-bus integration.
+   * Registers CQRS buses and wires them to the event-bus integration.
+   *
+   * The exported buses are global by default. Set {@link CqrsModuleOptions.global} to `false` to
+   * keep them visible only through modules that import this module definition.
    *
    * @param options CQRS module options including explicit handler classes and event-bus settings.
    * @returns A module definition that exports the lifecycle services and compatibility tokens.
    */
   static forRoot(options = {}) {
     class CqrsModuleDefinition {}
+    const shutdownDeadline = new CqrsShutdownDeadline();
     return defineModule(CqrsModuleDefinition, {
       exports: [CommandBusLifecycleService, QueryBusLifecycleService, CqrsEventBusService, COMMAND_BUS, QUERY_BUS, EVENT_BUS],
       global: options.global ?? true,
-      imports: [EventBusModule.forRoot(options.eventBus)],
-      providers: createCqrsProviders(options)
+      imports: [EventBusModule.forRoot(resolveDelegatedEventBusOptions(options))],
+      providers: createCqrsProviders(options, shutdownDeadline)
     });
   }
 }

package/dist/status.d.ts

@@ -7,9 +7,13 @@ export type CqrsLifecycleState = 'created' | 'discovering' | 'ready' | 'stopping
  * Describes the cqrs status adapter input contract.
  */
 export interface CqrsStatusAdapterInput {
+    commandHandlersDiscovered?: number;
+    commandLifecycleState?: CqrsLifecycleState;
     eventHandlersDiscovered: number;
     inFlightSagaExecutions: number;
     lifecycleState: CqrsLifecycleState;
+    queryHandlersDiscovered?: number;
+    queryLifecycleState?: CqrsLifecycleState;
     sagaLifecycleState: CqrsLifecycleState;
     sagaShutdownDrainTimeouts: number;
     sagasDiscovered: number;

package/dist/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEvG;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEzG;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,kBAAkB,CAAC;IACnC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,yBAAyB,EAAE,MAAM,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,uBAAuB,CAAC;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAmFD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,sBAAsB,GAAG,0BAA0B,CAoB1G"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEvG;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEzG;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,qBAAqB,CAAC,EAAE,kBAAkB,CAAC;IAC3C,uBAAuB,EAAE,MAAM,CAAC;IAChC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,kBAAkB,CAAC;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mBAAmB,CAAC,EAAE,kBAAkB,CAAC;IACzC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,yBAAyB,EAAE,MAAM,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,uBAAuB,CAAC;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAmFD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,sBAAsB,GAAG,0BAA0B,CAwB1G"}

package/dist/status.js

@@ -45,6 +45,12 @@ function createReadiness(input) {
   };
 }
 function createHealth(input) {
+  if (input.shutdownDrainTimeouts > 0 || input.sagaShutdownDrainTimeouts > 0) {
+    return {
+      reason: 'CQRS event/saga pipeline reported bounded shutdown drain timeouts.',
+      status: 'degraded'
+    };
+  }
   if (input.lifecycleState === 'failed' || input.sagaLifecycleState === 'failed' || input.lifecycleState === 'stopped' || input.sagaLifecycleState === 'stopped') {
     return {
       reason: 'CQRS event/saga pipeline is unavailable.',
@@ -57,12 +63,6 @@ function createHealth(input) {
       status: 'degraded'
     };
   }
-  if (input.shutdownDrainTimeouts > 0 || input.sagaShutdownDrainTimeouts > 0) {
-    return {
-      reason: 'CQRS event/saga pipeline reported bounded shutdown drain timeouts.',
-      status: 'degraded'
-    };
-  }
   return {
     status: 'healthy'
   };
@@ -77,10 +77,14 @@ function createHealth(input) {
 export function createCqrsPlatformStatusSnapshot(input) {
   return {
     details: {
+      commandHandlersDiscovered: input.commandHandlersDiscovered ?? 0,
+      commandLifecycleState: input.commandLifecycleState ?? input.lifecycleState,
       dependencies: ['event-bus.default'],
       eventHandlersDiscovered: input.eventHandlersDiscovered,
       inFlightSagaExecutions: input.inFlightSagaExecutions,
       lifecycleState: input.lifecycleState,
+      queryHandlersDiscovered: input.queryHandlersDiscovered ?? 0,
+      queryLifecycleState: input.queryLifecycleState ?? input.lifecycleState,
       sagaLifecycleState: input.sagaLifecycleState,
       sagaShutdownDrainTimeouts: input.sagaShutdownDrainTimeouts,
       sagasDiscovered: input.sagasDiscovered,

package/dist/test-setup.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test-setup.d.ts.map

package/dist/test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../src/test-setup.ts"],"names":[],"mappings":""}

package/dist/test-setup.js

@@ -0,0 +1,4 @@
+import { afterEach, vi } from 'vitest';
+afterEach(() => {
+  vi.useRealTimers();
+});

package/dist/types.d.ts

@@ -59,7 +59,7 @@ export interface ISaga<TEvent extends IEvent = IEvent> {
  * CQRS passes this value to command handlers, query handlers, event handlers, and sagas when a
  * nested dispatch chain is active. Application code should pass the value through unchanged to
  * nested `execute(...)`, `publish(...)`, or `publishAll(...)` calls. The context intentionally
- * exposes no public topology fields and should not be inspected or constructed by callers.
+ * exposes no public topology fields, and caller-shaped objects cannot supply trusted runtime state.
  */
 export interface CqrsDispatchContext {
 }
@@ -141,6 +141,7 @@ export interface CommandBus {
      * Executes one command by resolving its discovered singleton handler.
      *
      * @param command Command instance to dispatch.
+     * @param context Optional CQRS dispatch context to pass through a nested dispatch.
      * @returns The handler result.
      */
     execute<TCommand extends ICommand, TResult = void>(command: TCommand, context?: CqrsDispatchContext): Promise<TResult>;
@@ -151,6 +152,7 @@ export interface QueryBus {
      * Executes one query by resolving its discovered singleton handler.
      *
      * @param query Query instance to dispatch.
+     * @param context Optional CQRS dispatch context to pass through a nested dispatch.
      * @returns The handler result.
      */
     execute<TQuery extends IQuery<TResult>, TResult = unknown>(query: TQuery, context?: CqrsDispatchContext): Promise<TResult>;

package/dist/types.d.ts.map

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

package/package.json

@@ -9,7 +9,7 @@
     "saga",
     "event-sourcing"
   ],
-  "version": "1.1.2",
+  "version": "3.0.0",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -18,7 +18,7 @@
     "directory": "packages/cqrs"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=24.0.0 <27"
   },
   "publishConfig": {
     "access": "public"
@@ -36,13 +36,13 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/core": "^1.0.3",
-    "@fluojs/di": "^1.1.0",
-    "@fluojs/event-bus": "^1.0.1",
-    "@fluojs/runtime": "^1.1.8"
+    "@fluojs/core": "^2.0.0",
+    "@fluojs/di": "^3.0.0",
+    "@fluojs/event-bus": "^3.0.0",
+    "@fluojs/runtime": "^3.0.0"
   },
   "devDependencies": {
-    "vitest": "^3.2.4"
+    "vitest": "^4.1.11"
   },
   "scripts": {
     "prebuild": "node ../../tooling/scripts/clean-dist.mjs",