atomic-queues 1.6.2 → 2.0.1

package/dist/services/queue-bus/index.js

@@ -14,9 +14,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./queue-bus.types"), exports);
-__exportStar(require("./queue-bus.utils"), exports);
-__exportStar(require("./queue-target"), exports);
-__exportStar(require("./entity-target"), exports);
 __exportStar(require("./queue-bus.service"), exports);
 //# sourceMappingURL=index.js.map

package/dist/services/queue-bus/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/queue-bus/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,oDAAkC;AAClC,iDAA+B;AAC/B,kDAAgC;AAChC,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/queue-bus/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC"}

package/dist/services/queue-bus/queue-bus.service.d.ts

@@ -1,213 +1,59 @@
 import { Type } from '@nestjs/common';
-import { Job } from 'bullmq';
-import { QueueManagerService } from '../queue-manager/queue-manager.service';
-import { QueueEventsManagerService } from '../queue-events-manager/queue-events-manager.service';
-import { IAtomicQueuesModuleConfig } from '../../domain/interfaces';
-import { QueueBusExecuteOptions, EnqueueOptions, CommandRegistryEntry } from './queue-bus.types';
-import { QueueTarget } from './queue-target';
-import { EntityTarget } from './entity-target';
-/**
- * QueueBus
- *
- * A bus that works like CommandBus/QueryBus but instead of executing
- * commands/queries directly, it adds them to a BullMQ queue for
- * async processing by a worker.
- *
- * Key Features:
- * - No decorators needed on commands/queries
- * - Job name = class name (MakeBetCommand)
- * - Worker looks up class by name and instantiates from job.data
- * - Works with @nestjs/cqrs CommandBus/QueryBus on worker side
- * - Fluent API: queueBus.forProcessor(Processor).enqueue(command)
- * - Zero-boilerplate API: queueBus.forEntity('type').enqueue(command)
- * - Direct routing: queueBus.enqueue(command) with @EntityType decorator
- *
- * @example
- * ```typescript
- * // Option 1: With @WorkerProcessor class (full control)
- * await this.queueBus
- *   .forProcessor(TableWorkerProcessor)
- *   .enqueue(new MakeBetCommand(tableId, bets, player));
- *
- * // Option 2: With entity type (zero boilerplate)
- * await this.queueBus
- *   .forEntity('table')
- *   .enqueue(new MakeBetCommand(tableId, bets, player));
- *
- * // Option 3: Direct enqueue with @EntityType on command
- * @EntityType('table')
- * class MakeBetCommand { ... }
- *
- * await this.queueBus.enqueue(new MakeBetCommand(tableId, bets, player));
- * ```
- */
+import { IAtomicQueuesModuleConfig, IMessageRef } from '../../domain';
+import { LogService } from '../log';
+import { ExecutorPoolService } from '../executor-pool';
+import { HandlerExecutor } from '../handler-executor';
+import { ResultCollector } from '../result-collector';
+import { RegistryService } from '../registry';
 export declare class QueueBus {
-    private readonly queueManager;
-    private readonly queueEventsManager?;
-    private readonly logger;
-    /**
-     * Cache of processor options by class
-     */
-    private readonly processorCache;
-    /**
-     * Global registry of command/query classes
-     * Key: class name (e.g., 'MakeBetCommand')
-     * Value: registry entry with class reference
-     */
-    private static readonly globalRegistry;
-    /**
-     * Module config for entity defaults
-     */
     private readonly config;
-    constructor(queueManager: QueueManagerService, queueEventsManager?: QueueEventsManagerService | undefined, config?: IAtomicQueuesModuleConfig);
-    /**
-     * Get key prefix from config using resolveKeyPrefix utility
-     */
-    private get keyPrefix();
-    /**
-     * Get entity config from module config
-     */
-    private getEntityConfig;
-    /**
-     * Target a specific processor's queue for enqueueing commands.
-     * Use this when you have a @WorkerProcessor class with full config control.
-     *
-     * @param processorClass - The @WorkerProcessor decorated class
-     * @returns QueueTarget builder for fluent API
-     *
-     * @example
-     * await this.queueBus
-     *   .forProcessor(TableWorkerProcessor)
-     *   .enqueue(new MakeBetCommand(tableId, bets, player));
-     */
-    forProcessor(processorClass: Type<any>): QueueTarget;
-    /**
-     * Target a specific entity type's queue without needing a @WorkerProcessor class.
-     * This is the zero-boilerplate approach when you've configured entity defaults
-     * in the module config.
-     *
-     * @param entityType - The entity type (e.g., 'table', 'account')
-     * @returns EntityTarget builder for fluent API
-     *
-     * @example
-     * // With module config:
-     * // entities: { table: { defaultEntityId: 'tableId' } }
-     *
-     * await this.queueBus
-     *   .forEntity('table')
-     *   .enqueue(new MakeBetCommand(tableId, bets, player));
-     */
-    forEntity(entityType: string): EntityTarget;
-    /**
-     * Direct enqueue using @EntityType decorator on the command class.
-     * This is the most ergonomic approach for commands that have explicit routing.
-     *
-     * @param commandOrQuery - The command or query instance (must have @EntityType decorator)
-     * @param options - Optional settings (entityId override, jobOptions)
-     * @returns The created BullMQ job
-     *
-     * @example
-     * @EntityType('account')
-     * class WithdrawCommand {
-     *   @QueueEntityId()
-     *   accountId: string;
-     *   // ...
-     * }
-     *
-     * await this.queueBus.enqueue(new WithdrawCommand(accountId, amount));
-     */
-    enqueue<T extends object>(commandOrQuery: T, options?: EnqueueOptions): Promise<Job>;
-    /**
-     * Direct enqueue and wait using @EntityType decorator on the command class.
-     */
-    enqueueAndWait<T extends object, R = any>(commandOrQuery: T, options?: EnqueueOptions & {
+    private readonly logService;
+    private readonly executorPool;
+    private readonly handlerExecutor;
+    private readonly resultCollector;
+    private readonly registryService?;
+    private readonly logger;
+    private readonly keyPrefix;
+    constructor(config: IAtomicQueuesModuleConfig, logService: LogService, executorPool: ExecutorPoolService, handlerExecutor: HandlerExecutor, resultCollector: ResultCollector, registryService?: RegistryService | undefined);
+    enqueue<T extends object>(commandOrQuery: T, options?: {
+        entityId?: string;
+    }): Promise<IMessageRef>;
+    forEntity(entityType: string): {
+        enqueue<T extends object>(commandOrQuery: T, options?: {
+            entityId?: string;
+        }): Promise<IMessageRef>;
+        enqueueAndWait<T extends object, R = any>(commandOrQuery: T, options?: {
+            entityId?: string;
+            timeout?: number;
+        }): Promise<R>;
+        enqueueBulk<T extends object>(commands: T[], options?: {
+            entityId?: string;
+        }): Promise<IMessageRef[]>;
+    };
+    enqueueAndWait<T extends object, R = any>(commandOrQuery: T, options?: {
+        entityId?: string;
         timeout?: number;
     }): Promise<R>;
-    /**
-     * Register a command class for worker-side instantiation
-     *
-     * @example
-     * QueueBus.register(MakeBetCommand);
-     * QueueBus.register(GetTableStateQuery, true); // isQuery = true
-     */
+    private static readonly globalRegistry;
     static register(targetClass: Type<any>, isQuery?: boolean): void;
-    /**
-     * Register multiple commands at once
-     */
     static registerCommands(...commands: Type<any>[]): void;
-    /**
-     * Register multiple queries at once
-     */
     static registerQueries(...queries: Type<any>[]): void;
-    /**
-     * Get a registered class by name
-     */
-    static getRegistered(className: string): CommandRegistryEntry | undefined;
-    /**
-     * Check if a class name is registered
-     */
+    static getRegistered(className: string): {
+        className: string;
+        targetClass: Type<any>;
+        isQuery: boolean;
+    } | undefined;
     static isRegistered(className: string): boolean;
-    /**
-     * Get all registered entries
-     */
-    static getAllRegistered(): Map<string, CommandRegistryEntry>;
-    /**
-     * Auto-discover and register all commands/queries from CQRS handlers
-     *
-     * This method discovers all classes decorated with @CommandHandler and @QueryHandler
-     * from @nestjs/cqrs and automatically registers them with QueueBus.
-     *
-     * Call this during module init to enable zero-config command registration.
-     *
-     * @param discoveryService - NestJS DiscoveryService
-     * @returns Number of commands and queries discovered
-     *
-     * @example
-     * ```typescript
-     * @Module({})
-     * export class MyModule implements OnModuleInit {
-     *   constructor(private discoveryService: DiscoveryService) {}
-     *
-     *   onModuleInit() {
-     *     const { commands, queries } = QueueBus.discoverFromCqrs(this.discoveryService);
-     *     console.log(`Auto-registered ${commands} commands, ${queries} queries`);
-     *   }
-     * }
-     * ```
-     */
+    static getAllRegistered(): Map<string, {
+        className: string;
+        targetClass: Type<any>;
+        isQuery: boolean;
+    }>;
     static discoverFromCqrs(discoveryService: any): {
         commands: number;
         queries: number;
     };
-    /**
-     * Execute a command/query by adding it to a queue
-     *
-     * @deprecated Use .forProcessor(ProcessorClass).enqueue(command) instead
-     *
-     * @param queuePattern - Queue name pattern with {entityId} placeholder
-     * @param commandOrQuery - The command/query instance to execute
-     * @param options - Optional settings (entityId, jobOptions)
-     * @returns The created BullMQ job
-     */
-    execute<T extends object>(queuePattern: string, commandOrQuery: T, options?: QueueBusExecuteOptions): Promise<Job>;
-    /**
-     * Execute and wait for result (if supported by worker)
-     * Uses BullMQ's waitUntilFinished
-     *
-     * @deprecated Use .forProcessor(ProcessorClass).enqueueAndWait(command) instead
-     */
-    executeAndWait<T extends object, R = any>(queuePattern: string, commandOrQuery: T, options?: QueueBusExecuteOptions & {
-        timeout?: number;
-    }): Promise<R>;
-    /**
-     * Add multiple commands/queries to the same queue in bulk
-     *
-     * @deprecated Use .forProcessor(ProcessorClass).enqueueBulk(commands) instead
-     */
-    executeBulk<T extends object>(queuePattern: string, commandsOrQueries: T[], options?: QueueBusExecuteOptions): Promise<Job[]>;
-    /**
-     * Resolve queue name by replacing {entityId} placeholder
-     */
-    private resolveQueueName;
+    private _enqueue;
+    private _enqueueAndWait;
 }
 //# sourceMappingURL=queue-bus.service.d.ts.map

package/dist/services/queue-bus/queue-bus.service.d.ts.map

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