@fluojs/cqrs 1.0.0-beta.1

package/dist/metadata.js

@@ -0,0 +1,235 @@
+import { metadataSymbol } from '@fluojs/core/internal';
+const commandHandlerMetadataStore = new WeakMap();
+const queryHandlerMetadataStore = new WeakMap();
+const eventHandlerMetadataStore = new WeakMap();
+const sagaMetadataStore = new WeakMap();
+const standardCommandHandlerMetadataKey = Symbol.for('fluo.cqrs.standard.command-handler');
+const standardQueryHandlerMetadataKey = Symbol.for('fluo.cqrs.standard.query-handler');
+const standardEventHandlerMetadataKey = Symbol.for('fluo.cqrs.standard.event-handler');
+const standardSagaMetadataKey = Symbol.for('fluo.cqrs.standard.saga');
+function isObjectRecord(value) {
+  return typeof value === 'object' && value !== null;
+}
+function isCommandType(value) {
+  return typeof value === 'function';
+}
+function isQueryType(value) {
+  return typeof value === 'function';
+}
+function isEventType(value) {
+  return typeof value === 'function';
+}
+function isEventTypeList(value) {
+  return Array.isArray(value) && value.every(eventType => isEventType(eventType));
+}
+function getStandardMetadataBag(target) {
+  const metadata = target[metadataSymbol];
+  return isObjectRecord(metadata) ? metadata : undefined;
+}
+function cloneCommandHandlerMetadata(metadata) {
+  return {
+    commandType: metadata.commandType
+  };
+}
+function cloneQueryHandlerMetadata(metadata) {
+  return {
+    queryType: metadata.queryType
+  };
+}
+function cloneEventHandlerMetadata(metadata) {
+  return {
+    eventType: metadata.eventType
+  };
+}
+function cloneSagaMetadata(metadata) {
+  return {
+    eventTypes: [...metadata.eventTypes]
+  };
+}
+function getStandardCommandHandlerMetadata(target) {
+  const raw = getStandardMetadataBag(target)?.[standardCommandHandlerMetadataKey];
+  if (!isObjectRecord(raw) || !isCommandType(raw.commandType)) {
+    return undefined;
+  }
+  return {
+    commandType: raw.commandType
+  };
+}
+function getStandardQueryHandlerMetadata(target) {
+  const raw = getStandardMetadataBag(target)?.[standardQueryHandlerMetadataKey];
+  if (!isObjectRecord(raw) || !isQueryType(raw.queryType)) {
+    return undefined;
+  }
+  return {
+    queryType: raw.queryType
+  };
+}
+function getStandardEventHandlerMetadata(target) {
+  const raw = getStandardMetadataBag(target)?.[standardEventHandlerMetadataKey];
+  if (!isObjectRecord(raw) || !isEventType(raw.eventType)) {
+    return undefined;
+  }
+  return {
+    eventType: raw.eventType
+  };
+}
+function getStandardSagaMetadata(target) {
+  const raw = getStandardMetadataBag(target)?.[standardSagaMetadataKey];
+  if (!isObjectRecord(raw) || !isEventTypeList(raw.eventTypes)) {
+    return undefined;
+  }
+  return {
+    eventTypes: [...raw.eventTypes]
+  };
+}
+
+/**
+ * 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 function defineCommandHandlerMetadata(target, metadata) {
+  commandHandlerMetadataStore.set(target, cloneCommandHandlerMetadata(metadata));
+}
+
+/**
+ * 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 function getCommandHandlerMetadata(target) {
+  const stored = commandHandlerMetadataStore.get(target);
+  const standard = getStandardCommandHandlerMetadata(target);
+  if (!stored && !standard) {
+    return undefined;
+  }
+  return cloneCommandHandlerMetadata(stored ?? standard);
+}
+
+/**
+ * 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 function defineQueryHandlerMetadata(target, metadata) {
+  queryHandlerMetadataStore.set(target, cloneQueryHandlerMetadata(metadata));
+}
+
+/**
+ * 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 function getQueryHandlerMetadata(target) {
+  const stored = queryHandlerMetadataStore.get(target);
+  const standard = getStandardQueryHandlerMetadata(target);
+  if (!stored && !standard) {
+    return undefined;
+  }
+  return cloneQueryHandlerMetadata(stored ?? standard);
+}
+
+/**
+ * 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 function defineEventHandlerMetadata(target, metadata) {
+  eventHandlerMetadataStore.set(target, cloneEventHandlerMetadata(metadata));
+}
+
+/**
+ * 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 function getEventHandlerMetadata(target) {
+  const stored = eventHandlerMetadataStore.get(target);
+  const standard = getStandardEventHandlerMetadata(target);
+  if (!stored && !standard) {
+    return undefined;
+  }
+  return cloneEventHandlerMetadata(stored ?? standard);
+}
+
+/**
+ * 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 function defineSagaMetadata(target, metadata) {
+  sagaMetadataStore.set(target, cloneSagaMetadata(metadata));
+}
+
+/**
+ * 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 function getSagaMetadata(target) {
+  const stored = sagaMetadataStore.get(target);
+  const standard = getStandardSagaMetadata(target);
+  if (!stored && !standard) {
+    return undefined;
+  }
+  return cloneSagaMetadata(stored ?? standard);
+}
+
+/**
+ * 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 function getCommandHandlerMetadataEntry(target) {
+  const constructor = target.constructor;
+  if (!constructor) {
+    return undefined;
+  }
+  const metadata = getCommandHandlerMetadata(constructor);
+  if (!metadata) {
+    return undefined;
+  }
+  return {
+    metadata,
+    propertyKey: 'execute'
+  };
+}
+
+/**
+ * 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 function getQueryHandlerMetadataEntry(target) {
+  const constructor = target.constructor;
+  if (!constructor) {
+    return undefined;
+  }
+  const metadata = getQueryHandlerMetadata(constructor);
+  if (!metadata) {
+    return undefined;
+  }
+  return {
+    metadata,
+    propertyKey: 'execute'
+  };
+}
+
+/** Standard decorator metadata key used to store command-handler metadata. */
+export const commandHandlerMetadataSymbol = standardCommandHandlerMetadataKey;
+/** Standard decorator metadata key used to store query-handler metadata. */
+export const queryHandlerMetadataSymbol = standardQueryHandlerMetadataKey;
+/** Standard decorator metadata key used to store event-handler metadata. */
+export const eventHandlerMetadataSymbol = standardEventHandlerMetadataKey;
+/** Standard decorator metadata key used to store saga metadata. */
+export const sagaMetadataSymbol = standardSagaMetadataKey;

package/dist/module.d.ts

@@ -0,0 +1,30 @@
+import type { Provider } from '@fluojs/di';
+import { type EventBusModuleOptions } from '@fluojs/event-bus';
+import { type ModuleType } from '@fluojs/runtime';
+import type { CommandHandlerClass, EventHandlerClass, QueryHandlerClass, SagaClass } from './types.js';
+/** Module options for registering first-party handler classes and event-bus integration. */
+export interface CqrsModuleOptions {
+    commandHandlers?: readonly CommandHandlerClass[];
+    eventBus?: EventBusModuleOptions;
+    eventHandlers?: readonly EventHandlerClass[];
+    queryHandlers?: readonly QueryHandlerClass[];
+    sagas?: readonly SagaClass[];
+}
+/**
+ * Creates the providers required for CQRS buses, compatibility aliases, and optional handler registration.
+ *
+ * @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.
+ */
+export declare function createCqrsProviders(options?: CqrsModuleOptions): Provider[];
+/** 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.
+     *
+     * @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?: CqrsModuleOptions): ModuleType;
+}
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAOhE,OAAO,KAAK,EACV,mBAAmB,EACnB,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,aAAa,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CAC9B;AAwBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,iBAAsB,GAAG,QAAQ,EAAE,CA8B/E;AAED,iFAAiF;AACjF,qBAAa,UAAU;IACrB;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU;CAiB5D"}

package/dist/module.js

@@ -0,0 +1,74 @@
+import { EventBusModule } from '@fluojs/event-bus';
+import { defineModule } from '@fluojs/runtime';
+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 { COMMAND_BUS, EVENT_BUS, QUERY_BUS } from './tokens.js';
+
+/** Module options for registering first-party handler classes and event-bus integration. */
+
+function collectOptionHandlerProviders(options) {
+  const providers = [];
+  for (const commandHandler of options.commandHandlers ?? []) {
+    providers.push(commandHandler);
+  }
+  for (const queryHandler of options.queryHandlers ?? []) {
+    providers.push(queryHandler);
+  }
+  for (const eventHandler of options.eventHandlers ?? []) {
+    providers.push(eventHandler);
+  }
+  for (const saga of options.sagas ?? []) {
+    providers.push(saga);
+  }
+  return providers;
+}
+
+/**
+ * Creates the providers required for CQRS buses, compatibility aliases, and optional handler registration.
+ *
+ * @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.
+ */
+export function createCqrsProviders(options = {}) {
+  return [CommandBusLifecycleService, {
+    inject: [CommandBusLifecycleService],
+    provide: COMMAND_BUS,
+    useFactory: service => ({
+      execute: command => service.execute(command)
+    })
+  }, QueryBusLifecycleService, {
+    inject: [QueryBusLifecycleService],
+    provide: QUERY_BUS,
+    useFactory: service => ({
+      execute: query => service.execute(query)
+    })
+  }, CqrsSagaLifecycleService, CqrsEventBusService, {
+    inject: [CqrsEventBusService],
+    provide: EVENT_BUS,
+    useFactory: service => ({
+      publish: event => service.publish(event),
+      publishAll: events => service.publishAll(events)
+    })
+  }, ...collectOptionHandlerProviders(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.
+   *
+   * @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 {}
+    return defineModule(CqrsModuleDefinition, {
+      exports: [CommandBusLifecycleService, QueryBusLifecycleService, CqrsEventBusService, COMMAND_BUS, QUERY_BUS, EVENT_BUS],
+      global: true,
+      imports: [EventBusModule.forRoot(options.eventBus)],
+      providers: createCqrsProviders(options)
+    });
+  }
+}

package/dist/status.d.ts

@@ -0,0 +1,17 @@
+import type { PlatformHealthReport, PlatformReadinessReport, PlatformSnapshot } from '@fluojs/runtime';
+export type CqrsLifecycleState = 'created' | 'discovering' | 'ready' | 'stopping' | 'stopped' | 'failed';
+export interface CqrsStatusAdapterInput {
+    eventHandlersDiscovered: number;
+    inFlightSagaExecutions: number;
+    lifecycleState: CqrsLifecycleState;
+    sagaLifecycleState: CqrsLifecycleState;
+    sagasDiscovered: number;
+}
+export interface CqrsPlatformStatusSnapshot {
+    readiness: PlatformReadinessReport;
+    health: PlatformHealthReport;
+    ownership: PlatformSnapshot['ownership'];
+    details: Record<string, unknown>;
+}
+export declare function createCqrsPlatformStatusSnapshot(input: CqrsStatusAdapterInput): CqrsPlatformStatusSnapshot;
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +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,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEzG,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,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,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;AA4ED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,sBAAsB,GAAG,0BAA0B,CAiB1G"}

package/dist/status.js

@@ -0,0 +1,69 @@
+function createReadiness(input) {
+  if (input.lifecycleState === 'ready' && input.sagaLifecycleState === 'ready') {
+    return {
+      critical: true,
+      status: 'ready'
+    };
+  }
+  if (input.lifecycleState === 'discovering' || input.sagaLifecycleState === 'discovering') {
+    return {
+      critical: true,
+      reason: 'CQRS handlers are still being discovered.',
+      status: 'degraded'
+    };
+  }
+  if (input.lifecycleState === 'stopping' || input.sagaLifecycleState === 'stopping') {
+    return {
+      critical: true,
+      reason: 'CQRS event/saga pipeline is draining.',
+      status: 'not-ready'
+    };
+  }
+  if (input.lifecycleState === 'failed' || input.sagaLifecycleState === 'failed' || input.lifecycleState === 'stopped' || input.sagaLifecycleState === 'stopped') {
+    return {
+      critical: true,
+      reason: 'CQRS event/saga pipeline is unavailable.',
+      status: 'not-ready'
+    };
+  }
+  return {
+    critical: true,
+    reason: 'CQRS event/saga pipeline has not started yet.',
+    status: 'not-ready'
+  };
+}
+function createHealth(input) {
+  if (input.lifecycleState === 'failed' || input.sagaLifecycleState === 'failed' || input.lifecycleState === 'stopped' || input.sagaLifecycleState === 'stopped') {
+    return {
+      reason: 'CQRS event/saga pipeline is unavailable.',
+      status: 'unhealthy'
+    };
+  }
+  if (input.lifecycleState === 'discovering' || input.sagaLifecycleState === 'discovering' || input.lifecycleState === 'stopping' || input.sagaLifecycleState === 'stopping') {
+    return {
+      reason: 'CQRS event/saga pipeline is transitioning lifecycle state.',
+      status: 'degraded'
+    };
+  }
+  return {
+    status: 'healthy'
+  };
+}
+export function createCqrsPlatformStatusSnapshot(input) {
+  return {
+    details: {
+      dependencies: ['event-bus.default'],
+      eventHandlersDiscovered: input.eventHandlersDiscovered,
+      inFlightSagaExecutions: input.inFlightSagaExecutions,
+      lifecycleState: input.lifecycleState,
+      sagaLifecycleState: input.sagaLifecycleState,
+      sagasDiscovered: input.sagasDiscovered
+    },
+    health: createHealth(input),
+    ownership: {
+      externallyManaged: false,
+      ownsResources: false
+    },
+    readiness: createReadiness(input)
+  };
+}

package/dist/tokens.d.ts

@@ -0,0 +1,9 @@
+import type { Token } from '@fluojs/core';
+import type { CommandBus, CqrsEventBus, QueryBus } from './types.js';
+/** Compatibility injection token for the command bus facade. */
+export declare const COMMAND_BUS: Token<CommandBus>;
+/** Compatibility injection token for the query bus facade. */
+export declare const QUERY_BUS: Token<QueryBus>;
+/** Compatibility injection token for the CQRS event bus facade. */
+export declare const EVENT_BUS: Token<CqrsEventBus>;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErE,gEAAgE;AAChE,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,UAAU,CAAuC,CAAC;AAClF,8DAA8D;AAC9D,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAqC,CAAC;AAC5E,mEAAmE;AACnE,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,YAAY,CAAqC,CAAC"}

package/dist/tokens.js

@@ -0,0 +1,6 @@
+/** Compatibility injection token for the command bus facade. */
+export const COMMAND_BUS = Symbol.for('fluo.cqrs.command-bus');
+/** Compatibility injection token for the query bus facade. */
+export const QUERY_BUS = Symbol.for('fluo.cqrs.query-bus');
+/** Compatibility injection token for the CQRS event bus facade. */
+export const EVENT_BUS = Symbol.for('fluo.cqrs.event-bus');

package/dist/types.d.ts

@@ -0,0 +1,161 @@
+import type { Token } from '@fluojs/core';
+/** Marker interface for command messages handled by {@link CommandBus}. */
+export interface ICommand {
+}
+/** Marker interface for query messages whose response type is carried in the generic parameter. */
+export interface IQuery<TResult = unknown> {
+    readonly __queryResultType__?: TResult;
+}
+/** Marker interface for events published through the CQRS event bus. */
+export interface IEvent {
+}
+/** Contract implemented by classes decorated with {@link CommandHandler}. */
+export interface ICommandHandler<TCommand extends ICommand, TResult = void> {
+    /**
+     * Executes one command instance.
+     *
+     * @param command Command payload to handle.
+     * @returns The handler result returned to the command bus caller.
+     */
+    execute(command: TCommand): TResult | Promise<TResult>;
+}
+/** Contract implemented by classes decorated with {@link QueryHandler}. */
+export interface IQueryHandler<TQuery extends IQuery<TResult>, TResult = unknown> {
+    /**
+     * Executes one query instance.
+     *
+     * @param query Query payload to handle.
+     * @returns The query result returned to the caller.
+     */
+    execute(query: TQuery): TResult | Promise<TResult>;
+}
+/** Contract implemented by classes decorated with {@link EventHandler}. */
+export interface IEventHandler<TEvent extends IEvent> {
+    /**
+     * Reacts to one published event instance.
+     *
+     * @param event Event payload dispatched by the event bus.
+     * @returns A promise or void once side effects complete.
+     */
+    handle(event: TEvent): void | Promise<void>;
+}
+/** Contract implemented by classes decorated with {@link Saga}. */
+export interface ISaga<TEvent extends IEvent = IEvent> {
+    /**
+     * Reacts to one event and typically emits follow-up commands.
+     *
+     * @param event Event payload that triggered the saga.
+     * @returns A promise or void once orchestration side effects complete.
+     */
+    handle(event: TEvent): void | Promise<void>;
+}
+/** Constructor type used to identify a command message class. */
+export interface CommandType<TCommand extends ICommand = ICommand> {
+    new (...args: never[]): TCommand;
+}
+/** Constructor type used to identify a query message class. */
+export interface QueryType<TResult = unknown, TQuery extends IQuery<TResult> = IQuery<TResult>> {
+    new (...args: never[]): TQuery;
+}
+/** Constructor type used to identify an event message class. */
+export interface CqrsEventType<TEvent extends IEvent = IEvent> {
+    new (...args: never[]): TEvent;
+}
+/** Class constructor accepted in {@link CqrsModuleOptions.commandHandlers}. */
+export interface CommandHandlerClass {
+    new (...args: never[]): object;
+}
+/** Class constructor accepted in {@link CqrsModuleOptions.queryHandlers}. */
+export interface QueryHandlerClass {
+    new (...args: never[]): object;
+}
+/** Class constructor accepted in {@link CqrsModuleOptions.eventHandlers}. */
+export interface EventHandlerClass {
+    new (...args: never[]): object;
+}
+/** Class constructor accepted in {@link CqrsModuleOptions.sagas}. */
+export interface SagaClass {
+    new (...args: never[]): object;
+}
+/** Metadata stored by {@link CommandHandler}. */
+export interface CommandHandlerMetadata {
+    commandType: CommandType;
+}
+/** Metadata stored by {@link QueryHandler}. */
+export interface QueryHandlerMetadata {
+    queryType: QueryType;
+}
+/** Metadata stored by {@link EventHandler}. */
+export interface EventHandlerMetadata {
+    eventType: CqrsEventType;
+}
+/** Metadata stored by {@link Saga}. */
+export interface SagaMetadata {
+    eventTypes: readonly CqrsEventType[];
+}
+/** Runtime descriptor for one discovered command handler. */
+export interface CommandHandlerDescriptor {
+    commandType: CommandType;
+    moduleName: string;
+    token: Token;
+    targetType: Function;
+}
+/** Runtime descriptor for one discovered query handler. */
+export interface QueryHandlerDescriptor {
+    moduleName: string;
+    queryType: QueryType;
+    token: Token;
+    targetType: Function;
+}
+/** Runtime descriptor for one discovered event handler. */
+export interface EventHandlerDescriptor {
+    eventType: CqrsEventType;
+    moduleName: string;
+    token: Token;
+    targetType: Function;
+}
+/** Runtime descriptor for one discovered saga listener. */
+export interface SagaDescriptor {
+    eventType: CqrsEventType;
+    moduleName: string;
+    token: Token;
+    targetType: Function;
+}
+/** Command dispatch facade exposed by the CQRS module. */
+export interface CommandBus {
+    /**
+     * Executes one command by resolving its discovered singleton handler.
+     *
+     * @param command Command instance to dispatch.
+     * @returns The handler result.
+     */
+    execute<TCommand extends ICommand, TResult = void>(command: TCommand): Promise<TResult>;
+}
+/** Query dispatch facade exposed by the CQRS module. */
+export interface QueryBus {
+    /**
+     * Executes one query by resolving its discovered singleton handler.
+     *
+     * @param query Query instance to dispatch.
+     * @returns The handler result.
+     */
+    execute<TQuery extends IQuery<TResult>, TResult = unknown>(query: TQuery): Promise<TResult>;
+}
+/** Event publishing facade exposed by the CQRS module. */
+export interface CqrsEventBus {
+    /**
+     * Publishes one event to the underlying event bus.
+     *
+     * @param event Event instance to publish.
+     * @returns A promise that resolves once publication completes.
+     */
+    publish<TEvent extends IEvent>(event: TEvent): Promise<void>;
+    /**
+     * Publishes a batch of events in order.
+     *
+     * @param events Event instances to publish.
+     * @returns A promise that resolves once all events are published.
+     */
+    publishAll<TEvent extends IEvent>(events: readonly TEvent[]): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,2EAA2E;AAC3E,MAAM,WAAW,QAAQ;CAAG;AAE5B,mGAAmG;AACnG,MAAM,WAAW,MAAM,CAAC,OAAO,GAAG,OAAO;IACvC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,wEAAwE;AACxE,MAAM,WAAW,MAAM;CAAG;AAE1B,6EAA6E;AAC7E,MAAM,WAAW,eAAe,CAAC,QAAQ,SAAS,QAAQ,EAAE,OAAO,GAAG,IAAI;IACxE;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACxD;AAED,2EAA2E;AAC3E,MAAM,WAAW,aAAa,CAAC,MAAM,SAAS,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO;IAC9E;;;;;OAKG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpD;AAED,2EAA2E;AAC3E,MAAM,WAAW,aAAa,CAAC,MAAM,SAAS,MAAM;IAClD;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,mEAAmE;AACnE,MAAM,WAAW,KAAK,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM;IACnD;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,iEAAiE;AACjE,MAAM,WAAW,WAAW,CAAC,QAAQ,SAAS,QAAQ,GAAG,QAAQ;IAC/D,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;CAClC;AAED,+DAA+D;AAC/D,MAAM,WAAW,SAAS,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,SAAS,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;IAC5F,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;CAChC;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM;IAC3D,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;CAChC;AAED,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB;IAClC,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;CAChC;AAED,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;CAChC;AAED,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;CACtC;AAED,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,QAAQ,CAAC;CACtB;AAED,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,QAAQ,CAAC;CACtB;AAED,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,aAAa,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,QAAQ,CAAC;CACtB;AAED,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,aAAa,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,QAAQ,CAAC;CACtB;AAED,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,SAAS,QAAQ,EAAE,OAAO,GAAG,IAAI,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzF;AAED,wDAAwD;AACxD,MAAM,WAAW,QAAQ;IACvB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,SAAS,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7F;AAED,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D;;;;;OAKG;IACH,UAAU,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};