@fluojs/cqrs 1.0.0-beta.1

package/dist/decorators.js

@@ -0,0 +1,127 @@
+import { metadataSymbol } from '@fluojs/core/internal';
+import { commandHandlerMetadataSymbol, eventHandlerMetadataSymbol, queryHandlerMetadataSymbol, sagaMetadataSymbol } from './metadata.js';
+function getStandardMetadataBag(metadata) {
+  void metadataSymbol;
+  if (typeof metadata !== 'object' || metadata === null) {
+    throw new Error('Decorator metadata is unavailable. Ensure standard decorators are enabled.');
+  }
+  return metadata;
+}
+function defineStandardCommandHandlerMetadata(metadata, handlerMetadata) {
+  const bag = getStandardMetadataBag(metadata);
+  bag[commandHandlerMetadataSymbol] = {
+    commandType: handlerMetadata.commandType
+  };
+}
+function defineStandardQueryHandlerMetadata(metadata, handlerMetadata) {
+  const bag = getStandardMetadataBag(metadata);
+  bag[queryHandlerMetadataSymbol] = {
+    queryType: handlerMetadata.queryType
+  };
+}
+function defineStandardEventHandlerMetadata(metadata, handlerMetadata) {
+  const bag = getStandardMetadataBag(metadata);
+  bag[eventHandlerMetadataSymbol] = {
+    eventType: handlerMetadata.eventType
+  };
+}
+function defineStandardSagaMetadata(metadata, sagaMetadata) {
+  const bag = getStandardMetadataBag(metadata);
+  bag[sagaMetadataSymbol] = {
+    eventTypes: [...sagaMetadata.eventTypes]
+  };
+}
+function normalizeSagaEventTypes(eventTypeOrTypes) {
+  const eventTypes = Array.isArray(eventTypeOrTypes) ? eventTypeOrTypes : [eventTypeOrTypes];
+  const uniqueEventTypes = Array.from(new Set(eventTypes));
+  if (uniqueEventTypes.length === 0) {
+    throw new Error('@Saga() requires at least one event type.');
+  }
+  for (const eventType of uniqueEventTypes) {
+    if (typeof eventType !== 'function') {
+      throw new Error('@Saga() event types must be class constructors.');
+    }
+  }
+  return uniqueEventTypes;
+}
+
+/**
+ * Associates a singleton provider class with one command type.
+ *
+ * @param commandType Command constructor handled by the decorated class.
+ * @returns A class decorator that stores command-handler metadata for discovery.
+ *
+ * @example
+ * ```ts
+ * import { CommandHandler, type ICommandHandler } from '@fluojs/cqrs';
+ *
+ * class CreateUserCommand {
+ *   constructor(public readonly name: string) {}
+ * }
+ *
+ * @CommandHandler(CreateUserCommand)
+ * export class CreateUserHandler implements ICommandHandler<CreateUserCommand, string> {
+ *   async execute(command: CreateUserCommand) {
+ *     return command.name;
+ *   }
+ * }
+ * ```
+ */
+export function CommandHandler(commandType) {
+  const decorator = (_value, context) => {
+    const metadata = {
+      commandType
+    };
+    defineStandardCommandHandlerMetadata(context.metadata, metadata);
+  };
+  return decorator;
+}
+
+/**
+ * Associates a singleton provider class with one query type.
+ *
+ * @param queryType Query constructor handled by the decorated class.
+ * @returns A class decorator that stores query-handler metadata for discovery.
+ */
+export function QueryHandler(queryType) {
+  const decorator = (_value, context) => {
+    const metadata = {
+      queryType
+    };
+    defineStandardQueryHandlerMetadata(context.metadata, metadata);
+  };
+  return decorator;
+}
+
+/**
+ * Associates a singleton provider class with one event type.
+ *
+ * @param eventType Event constructor handled by the decorated class.
+ * @returns A class decorator that stores event-handler metadata for discovery.
+ */
+export function EventHandler(eventType) {
+  const decorator = (_value, context) => {
+    const metadata = {
+      eventType
+    };
+    defineStandardEventHandlerMetadata(context.metadata, metadata);
+  };
+  return decorator;
+}
+
+/**
+ * Marks a singleton provider class as a saga listener for one or more event types.
+ *
+ * @param eventTypeOrTypes One event constructor or a list of constructors that should trigger the saga.
+ * @returns A class decorator that stores saga metadata for discovery.
+ */
+export function Saga(eventTypeOrTypes) {
+  const eventTypes = normalizeSagaEventTypes(eventTypeOrTypes);
+  const decorator = (_value, context) => {
+    const metadata = {
+      eventTypes
+    };
+    defineStandardSagaMetadata(context.metadata, metadata);
+  };
+  return decorator;
+}

package/dist/discovery.d.ts

@@ -0,0 +1,27 @@
+import { type Token } from '@fluojs/core';
+import type { Container } from '@fluojs/di';
+import type { ApplicationLogger, CompiledModule } from '@fluojs/runtime';
+export interface DiscoveryCandidate {
+    moduleName: string;
+    scope: 'request' | 'singleton' | 'transient';
+    targetType: Function;
+    token: Token;
+}
+export declare function createDuplicateHandlerMessage(kind: 'command' | 'query' | 'event', messageType: Function, first: {
+    moduleName: string;
+    targetType: Function;
+}, second: {
+    moduleName: string;
+    targetType: Function;
+}): string;
+export declare abstract class CqrsBusBase {
+    protected readonly runtimeContainer: Container;
+    protected readonly compiledModules: readonly CompiledModule[];
+    protected readonly logger: ApplicationLogger;
+    protected readonly handlerInstances: Map<Token, Promise<unknown>>;
+    constructor(runtimeContainer: Container, compiledModules: readonly CompiledModule[], logger: ApplicationLogger);
+    protected discoveryCandidates(): DiscoveryCandidate[];
+    protected preloadHandlerInstance(token: Token): Promise<void>;
+    protected resolveHandlerInstance(token: Token): Promise<unknown>;
+}
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +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,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,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,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"}

package/dist/discovery.js

@@ -0,0 +1,84 @@
+import { getClassDiMetadata } from '@fluojs/core/internal';
+function scopeFromProvider(provider) {
+  if (typeof provider === 'function') {
+    return getClassDiMetadata(provider)?.scope ?? 'singleton';
+  }
+  if ('useClass' in provider) {
+    return provider.scope ?? getClassDiMetadata(provider.useClass)?.scope ?? 'singleton';
+  }
+  return 'scope' in provider ? provider.scope ?? 'singleton' : 'singleton';
+}
+function isClassProvider(provider) {
+  return typeof provider === 'object' && provider !== null && 'useClass' in provider;
+}
+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}.`;
+}
+export class CqrsBusBase {
+  handlerInstances = new Map();
+  constructor(runtimeContainer, compiledModules, logger) {
+    this.runtimeContainer = runtimeContainer;
+    this.compiledModules = compiledModules;
+    this.logger = logger;
+  }
+  discoveryCandidates() {
+    const candidates = [];
+    for (const compiledModule of this.compiledModules) {
+      for (const provider of compiledModule.definition.providers ?? []) {
+        if (typeof provider === 'function') {
+          candidates.push({
+            moduleName: compiledModule.type.name,
+            scope: scopeFromProvider(provider),
+            targetType: provider,
+            token: provider
+          });
+          continue;
+        }
+        if (isClassProvider(provider)) {
+          candidates.push({
+            moduleName: compiledModule.type.name,
+            scope: scopeFromProvider(provider),
+            targetType: provider.useClass,
+            token: provider.provide
+          });
+        }
+      }
+      for (const controller of compiledModule.definition.controllers ?? []) {
+        candidates.push({
+          moduleName: compiledModule.type.name,
+          scope: scopeFromProvider(controller),
+          targetType: controller,
+          token: controller
+        });
+      }
+    }
+    return candidates;
+  }
+  async preloadHandlerInstance(token) {
+    if (this.handlerInstances.has(token)) {
+      return;
+    }
+    const resolving = this.runtimeContainer.resolve(token);
+    this.handlerInstances.set(token, resolving);
+    try {
+      await resolving;
+    } catch (error) {
+      this.handlerInstances.delete(token);
+      throw error;
+    }
+  }
+  async resolveHandlerInstance(token) {
+    const cached = this.handlerInstances.get(token);
+    if (cached) {
+      return await cached;
+    }
+    const resolving = this.runtimeContainer.resolve(token);
+    this.handlerInstances.set(token, resolving);
+    try {
+      return await resolving;
+    } catch (error) {
+      this.handlerInstances.delete(token);
+      throw error;
+    }
+  }
+}

package/dist/errors.d.ts

@@ -0,0 +1,65 @@
+import { FluoError } from '@fluojs/core';
+/** Raised when the command bus cannot find a handler for the requested command type. */
+export declare class CommandHandlerNotFoundException extends FluoError {
+    /**
+     * Creates a missing-command-handler error.
+     *
+     * @param message Human-readable failure description.
+     */
+    constructor(message: string);
+}
+/** Raised when two different singleton providers claim the same command type. */
+export declare class DuplicateCommandHandlerError extends FluoError {
+    /**
+     * Creates a duplicate-command-handler error.
+     *
+     * @param message Human-readable failure description.
+     */
+    constructor(message: string);
+}
+/** Raised when the query bus cannot find a handler for the requested query type. */
+export declare class QueryHandlerNotFoundException extends FluoError {
+    /**
+     * Creates a missing-query-handler error.
+     *
+     * @param message Human-readable failure description.
+     */
+    constructor(message: string);
+}
+/** Raised when two different singleton providers claim the same query type. */
+export declare class DuplicateQueryHandlerError extends FluoError {
+    /**
+     * Creates a duplicate-query-handler error.
+     *
+     * @param message Human-readable failure description.
+     */
+    constructor(message: string);
+}
+/** Raised when conflicting event-handler registrations break the CQRS discovery contract. */
+export declare class DuplicateEventHandlerError extends FluoError {
+    /**
+     * Creates a duplicate-event-handler error.
+     *
+     * @param message Human-readable failure description.
+     */
+    constructor(message: string);
+}
+/** Raised when a saga throws a non-Fluo error while handling an event. */
+export declare class SagaExecutionError extends FluoError {
+    /**
+     * Creates a saga-execution error.
+     *
+     * @param message Human-readable failure description.
+     */
+    constructor(message: string);
+}
+/** Raised when saga orchestration re-enters an unsafe in-process topology. */
+export declare class SagaTopologyError extends FluoError {
+    /**
+     * Creates a saga-topology guard error.
+     *
+     * @param message Human-readable failure description.
+     */
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +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,6FAA6F;AAC7F,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

@@ -0,0 +1,99 @@
+import { FluoError } from '@fluojs/core';
+
+/** Raised when the command bus cannot find a handler for the requested command type. */
+export class CommandHandlerNotFoundException extends FluoError {
+  /**
+   * Creates a missing-command-handler error.
+   *
+   * @param message Human-readable failure description.
+   */
+  constructor(message) {
+    super(message, {
+      code: 'CQRS_COMMAND_HANDLER_NOT_FOUND'
+    });
+  }
+}
+
+/** Raised when two different singleton providers claim the same command type. */
+export class DuplicateCommandHandlerError extends FluoError {
+  /**
+   * Creates a duplicate-command-handler error.
+   *
+   * @param message Human-readable failure description.
+   */
+  constructor(message) {
+    super(message, {
+      code: 'CQRS_DUPLICATE_COMMAND_HANDLER'
+    });
+  }
+}
+
+/** Raised when the query bus cannot find a handler for the requested query type. */
+export class QueryHandlerNotFoundException extends FluoError {
+  /**
+   * Creates a missing-query-handler error.
+   *
+   * @param message Human-readable failure description.
+   */
+  constructor(message) {
+    super(message, {
+      code: 'CQRS_QUERY_HANDLER_NOT_FOUND'
+    });
+  }
+}
+
+/** Raised when two different singleton providers claim the same query type. */
+export class DuplicateQueryHandlerError extends FluoError {
+  /**
+   * Creates a duplicate-query-handler error.
+   *
+   * @param message Human-readable failure description.
+   */
+  constructor(message) {
+    super(message, {
+      code: 'CQRS_DUPLICATE_QUERY_HANDLER'
+    });
+  }
+}
+
+/** Raised when conflicting event-handler registrations break the CQRS discovery contract. */
+export class DuplicateEventHandlerError extends FluoError {
+  /**
+   * Creates a duplicate-event-handler error.
+   *
+   * @param message Human-readable failure description.
+   */
+  constructor(message) {
+    super(message, {
+      code: 'CQRS_DUPLICATE_EVENT_HANDLER'
+    });
+  }
+}
+
+/** Raised when a saga throws a non-Fluo error while handling an event. */
+export class SagaExecutionError extends FluoError {
+  /**
+   * Creates a saga-execution error.
+   *
+   * @param message Human-readable failure description.
+   */
+  constructor(message) {
+    super(message, {
+      code: 'CQRS_SAGA_EXECUTION_FAILED'
+    });
+  }
+}
+
+/** Raised when saga orchestration re-enters an unsafe in-process topology. */
+export class SagaTopologyError extends FluoError {
+  /**
+   * Creates a saga-topology guard error.
+   *
+   * @param message Human-readable failure description.
+   */
+  constructor(message) {
+    super(message, {
+      code: 'CQRS_SAGA_UNSAFE_TOPOLOGY'
+    });
+  }
+}

package/dist/event-clone.d.ts

@@ -0,0 +1,10 @@
+import type { CqrsEventType, IEvent } from './types.js';
+/**
+ * Creates an isolated event instance by cloning the source payload before rehydrating the event prototype.
+ *
+ * @param eventType Event class whose prototype should back the isolated event.
+ * @param source Source payload to clone and assign onto the event instance.
+ * @returns A detached event instance with the requested event prototype.
+ */
+export declare function createIsolatedEvent<TEvent extends IEvent>(eventType: CqrsEventType<TEvent>, source: unknown): TEvent;
+//# sourceMappingURL=event-clone.d.ts.map

package/dist/event-clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-clone.d.ts","sourceRoot":"","sources":["../src/event-clone.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAQpH"}

package/dist/event-clone.js

@@ -0,0 +1,15 @@
+import { cloneWithFallback } from '@fluojs/core/internal';
+/**
+ * Creates an isolated event instance by cloning the source payload before rehydrating the event prototype.
+ *
+ * @param eventType Event class whose prototype should back the isolated event.
+ * @param source Source payload to clone and assign onto the event instance.
+ * @returns A detached event instance with the requested event prototype.
+ */
+export function createIsolatedEvent(eventType, source) {
+  const clonedPayload = cloneWithFallback(source);
+  if (typeof clonedPayload !== 'object' || clonedPayload === null) {
+    return clonedPayload;
+  }
+  return Object.assign(Object.create(eventType.prototype), clonedPayload);
+}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { CommandHandler, EventHandler, QueryHandler, Saga } from './decorators.js';
+export { DuplicateCommandHandlerError, DuplicateEventHandlerError, DuplicateQueryHandlerError, CommandHandlerNotFoundException, QueryHandlerNotFoundException, SagaExecutionError, SagaTopologyError, } from './errors.js';
+export { commandHandlerMetadataSymbol, defineCommandHandlerMetadata, defineEventHandlerMetadata, defineQueryHandlerMetadata, eventHandlerMetadataSymbol, getCommandHandlerMetadata, getCommandHandlerMetadataEntry, getEventHandlerMetadata, getQueryHandlerMetadata, getQueryHandlerMetadataEntry, queryHandlerMetadataSymbol, defineSagaMetadata, getSagaMetadata, sagaMetadataSymbol, } from './metadata.js';
+export { CqrsModule, type CqrsModuleOptions } from './module.js';
+export * from './status.js';
+export { CommandBusLifecycleService } from './buses/command-bus.js';
+export { CqrsEventBusService } from './buses/event-bus.js';
+export { QueryBusLifecycleService } from './buses/query-bus.js';
+export { COMMAND_BUS, EVENT_BUS, QUERY_BUS } from './tokens.js';
+export type { CommandBus, CommandHandlerClass, CommandHandlerDescriptor, CommandHandlerMetadata, CommandType, CqrsEventBus, CqrsEventType, EventHandlerDescriptor, EventHandlerClass, EventHandlerMetadata, ICommand, ICommandHandler, IEvent, IEventHandler, IQuery, IQueryHandler, ISaga, QueryBus, QueryHandlerClass, QueryHandlerDescriptor, QueryHandlerMetadata, QueryType, SagaClass, SagaDescriptor, SagaMetadata, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC1B,+BAA+B,EAC/B,6BAA6B,EAC7B,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,4BAA4B,EAC5B,4BAA4B,EAC5B,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,EACzB,8BAA8B,EAC9B,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjE,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,QAAQ,EACR,eAAe,EACf,MAAM,EACN,aAAa,EACb,MAAM,EACN,aAAa,EACb,KAAK,EACL,QAAQ,EACR,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,SAAS,EACT,SAAS,EACT,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { CommandHandler, EventHandler, QueryHandler, Saga } from './decorators.js';
+export { DuplicateCommandHandlerError, DuplicateEventHandlerError, DuplicateQueryHandlerError, CommandHandlerNotFoundException, QueryHandlerNotFoundException, SagaExecutionError, SagaTopologyError } from './errors.js';
+export { commandHandlerMetadataSymbol, defineCommandHandlerMetadata, defineEventHandlerMetadata, defineQueryHandlerMetadata, eventHandlerMetadataSymbol, getCommandHandlerMetadata, getCommandHandlerMetadataEntry, getEventHandlerMetadata, getQueryHandlerMetadata, getQueryHandlerMetadataEntry, queryHandlerMetadataSymbol, defineSagaMetadata, getSagaMetadata, sagaMetadataSymbol } from './metadata.js';
+export { CqrsModule } from './module.js';
+export * from './status.js';
+export { CommandBusLifecycleService } from './buses/command-bus.js';
+export { CqrsEventBusService } from './buses/event-bus.js';
+export { QueryBusLifecycleService } from './buses/query-bus.js';
+export { COMMAND_BUS, EVENT_BUS, QUERY_BUS } from './tokens.js';

package/dist/metadata.d.ts

@@ -0,0 +1,87 @@
+import { type MetadataPropertyKey } from '@fluojs/core';
+import type { CommandHandlerMetadata, EventHandlerMetadata, QueryHandlerMetadata, SagaMetadata } from './types.js';
+/**
+ * Stores command-handler metadata on a class for compatibility with manual metadata registration.
+ *
+ * @param target Handler class constructor receiving the metadata.
+ * @param metadata Command-handler metadata to store.
+ */
+export declare function defineCommandHandlerMetadata(target: Function, metadata: CommandHandlerMetadata): void;
+/**
+ * Reads command-handler metadata from either the compatibility store or standard decorator metadata.
+ *
+ * @param target Handler class constructor to inspect.
+ * @returns The resolved command-handler metadata, if present.
+ */
+export declare function getCommandHandlerMetadata(target: Function): CommandHandlerMetadata | undefined;
+/**
+ * Stores query-handler metadata on a class for compatibility with manual metadata registration.
+ *
+ * @param target Handler class constructor receiving the metadata.
+ * @param metadata Query-handler metadata to store.
+ */
+export declare function defineQueryHandlerMetadata(target: Function, metadata: QueryHandlerMetadata): void;
+/**
+ * Reads query-handler metadata from either the compatibility store or standard decorator metadata.
+ *
+ * @param target Handler class constructor to inspect.
+ * @returns The resolved query-handler metadata, if present.
+ */
+export declare function getQueryHandlerMetadata(target: Function): QueryHandlerMetadata | undefined;
+/**
+ * Stores event-handler metadata on a class for compatibility with manual metadata registration.
+ *
+ * @param target Handler class constructor receiving the metadata.
+ * @param metadata Event-handler metadata to store.
+ */
+export declare function defineEventHandlerMetadata(target: Function, metadata: EventHandlerMetadata): void;
+/**
+ * Reads event-handler metadata from either the compatibility store or standard decorator metadata.
+ *
+ * @param target Handler class constructor to inspect.
+ * @returns The resolved event-handler metadata, if present.
+ */
+export declare function getEventHandlerMetadata(target: Function): EventHandlerMetadata | undefined;
+/**
+ * Stores saga metadata on a class for compatibility with manual metadata registration.
+ *
+ * @param target Saga class constructor receiving the metadata.
+ * @param metadata Saga metadata to store.
+ */
+export declare function defineSagaMetadata(target: Function, metadata: SagaMetadata): void;
+/**
+ * Reads saga metadata from either the compatibility store or standard decorator metadata.
+ *
+ * @param target Saga class constructor to inspect.
+ * @returns The resolved saga metadata, if present.
+ */
+export declare function getSagaMetadata(target: Function): SagaMetadata | undefined;
+/**
+ * Returns the normalized command-handler metadata entry used by public-surface tests and tooling.
+ *
+ * @param target Handler instance or prototype whose constructor should be inspected.
+ * @returns The command-handler metadata entry for the canonical `execute` method, if present.
+ */
+export declare function getCommandHandlerMetadataEntry(target: object): {
+    metadata: CommandHandlerMetadata;
+    propertyKey: MetadataPropertyKey;
+} | undefined;
+/**
+ * Returns the normalized query-handler metadata entry used by public-surface tests and tooling.
+ *
+ * @param target Handler instance or prototype whose constructor should be inspected.
+ * @returns The query-handler metadata entry for the canonical `execute` method, if present.
+ */
+export declare function getQueryHandlerMetadataEntry(target: object): {
+    metadata: QueryHandlerMetadata;
+    propertyKey: MetadataPropertyKey;
+} | undefined;
+/** Standard decorator metadata key used to store command-handler metadata. */
+export declare const commandHandlerMetadataSymbol: symbol;
+/** Standard decorator metadata key used to store query-handler metadata. */
+export declare const queryHandlerMetadataSymbol: symbol;
+/** Standard decorator metadata key used to store event-handler metadata. */
+export declare const eventHandlerMetadataSymbol: symbol;
+/** Standard decorator metadata key used to store saga metadata. */
+export declare const sagaMetadataSymbol: symbol;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGxD,OAAO,KAAK,EACV,sBAAsB,EAGtB,oBAAoB,EACpB,oBAAoB,EAEpB,YAAY,EACb,MAAM,YAAY,CAAC;AA+GpB;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAErG;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,QAAQ,GAAG,sBAAsB,GAAG,SAAS,CAS9F;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAEjG;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,GAAG,oBAAoB,GAAG,SAAS,CAS1F;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAEjG;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,GAAG,oBAAoB,GAAG,SAAS,CAS1F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAS1E;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,GACb;IAAE,QAAQ,EAAE,sBAAsB,CAAC;IAAC,WAAW,EAAE,mBAAmB,CAAA;CAAE,GAAG,SAAS,CAiBpF;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,GACb;IAAE,QAAQ,EAAE,oBAAoB,CAAC;IAAC,WAAW,EAAE,mBAAmB,CAAA;CAAE,GAAG,SAAS,CAiBlF;AAED,8EAA8E;AAC9E,eAAO,MAAM,4BAA4B,QAAoC,CAAC;AAC9E,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,QAAkC,CAAC;AAC1E,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,QAAkC,CAAC;AAC1E,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,QAA0B,CAAC"}