atomic-queues 1.0.15 → 1.1.0

package/dist/decorators/decorators.d.ts

@@ -1,15 +1,80 @@
+import { Type } from '@nestjs/common';
+import { IWorkerConfig } from '../domain';
 /**
  * Metadata keys for decorators
  */
 export declare const ATOMIC_PROCESSOR_METADATA = "atomic:processor";
 export declare const ENTITY_TYPE_METADATA = "atomic:entity-type";
 export declare const JOB_TYPE_METADATA = "atomic:job-type";
+export declare const WORKER_PROCESSOR_METADATA = "atomic:worker-processor";
+export declare const JOB_HANDLER_METADATA = "atomic:job-handler";
+export declare const ENTITY_SCALER_METADATA = "atomic:entity-scaler";
+export declare const GET_ACTIVE_ENTITIES_METADATA = "atomic:get-active-entities";
+export declare const GET_DESIRED_WORKER_COUNT_METADATA = "atomic:get-desired-worker-count";
+export declare const ON_SPAWN_WORKER_METADATA = "atomic:on-spawn-worker";
+export declare const ON_TERMINATE_WORKER_METADATA = "atomic:on-terminate-worker";
 /**
- * @AtomicProcessor decorator
+ * Options for @WorkerProcessor decorator
+ */
+export interface WorkerProcessorOptions {
+    /** Entity type this processor handles (e.g., 'table', 'user') */
+    entityType: string;
+    /** Function to generate queue name from entityId */
+    queueName?: string | ((entityId: string) => string);
+    /** Function to generate worker name from entityId */
+    workerName?: string | ((entityId: string) => string);
+    /** Worker configuration */
+    workerConfig?: IWorkerConfig;
+}
+/**
+ * Options for @EntityScaler decorator
+ */
+export interface EntityScalerOptions {
+    /** Entity type this scaler handles */
+    entityType: string;
+    /** Maximum workers per entity */
+    maxWorkersPerEntity?: number;
+}
+/**
+ * Stored job handler metadata
+ */
+export interface JobHandlerMetadata {
+    jobName: string;
+    methodName: string;
+    isWildcard: boolean;
+}
+/**
+ * Stored worker processor metadata
+ */
+export interface WorkerProcessorMetadata {
+    entityType: string;
+    queueNameFn: (entityId: string) => string;
+    workerNameFn: (entityId: string) => string;
+    workerConfig: IWorkerConfig;
+    targetClass: Type<any>;
+    jobHandlers: Map<string, JobHandlerMetadata>;
+    wildcardHandler?: JobHandlerMetadata;
+}
+/**
+ * Stored entity scaler metadata
+ */
+export interface EntityScalerMetadata {
+    entityType: string;
+    maxWorkersPerEntity: number;
+    targetClass: Type<any>;
+    getActiveEntitiesMethod?: string;
+    getDesiredWorkerCountMethod?: string;
+    onSpawnWorkerMethod?: string;
+    onTerminateWorkerMethod?: string;
+}
+/**
+ * @AtomicProcessor decorator (LEGACY)
  *
  * Marks a method as an atomic job processor.
  * Can be used on handler methods to auto-register them.
  *
+ * @deprecated Use @WorkerProcessor class decorator with @JobHandler method decorators instead
+ *
  * @example
  * ```typescript
  * @Injectable()
@@ -23,45 +88,165 @@ export declare const JOB_TYPE_METADATA = "atomic:job-type";
  */
 export declare const AtomicProcessor: (jobType: string) => MethodDecorator;
 /**
- * @EntityType decorator
+ * @EntityType decorator (LEGACY)
  *
  * Marks a class or method with an entity type for automatic registration.
  *
+ * @deprecated Use @WorkerProcessor or @EntityScaler class decorators instead
+ */
+export declare const EntityType: (entityType: string) => ClassDecorator & MethodDecorator;
+/**
+ * @JobType decorator (LEGACY)
+ *
+ * Specifies the job type for a processor method.
+ *
+ * @deprecated Use @JobHandler method decorator instead
+ */
+export declare const JobType: (jobType: string) => MethodDecorator;
+/**
+ * @InjectAtomicQueue decorator
+ *
+ * Custom parameter decorator for injecting a specific queue.
+ * Useful when you need direct access to a queue in a service.
+ */
+export declare const InjectAtomicQueue: (entityType: string, entityId?: string) => ParameterDecorator;
+/**
+ * @WorkerProcessor class decorator
+ *
+ * Marks a class as a worker processor for a specific entity type.
+ * Combined with @JobHandler method decorators, this enables declarative
+ * job processing with automatic worker creation and management.
+ *
  * @example
  * ```typescript
+ * @WorkerProcessor({
+ *   entityType: 'table',
+ *   queueName: (tableId) => `${tableId}-queue`,
+ *   workerName: (tableId) => `table-worker-${tableId}`,
+ *   workerConfig: {
+ *     concurrency: 1,
+ *     heartbeatTTL: 3,
+ *   }
+ * })
  * @Injectable()
- * @EntityType('user')
- * export class UserWorkerService {
- *   // All methods in this service are associated with 'user' entity type
+ * export class TableWorkerProcessor {
+ *   constructor(private readonly commandBus: CommandBus) {}
+ *
+ *   @JobHandler('make-bet')
+ *   async handleMakeBet(job: Job<MakeBetData>, entityId: string) {
+ *     return this.commandBus.execute(new MakeBetCommand(entityId, job.data));
+ *   }
+ *
+ *   @JobHandler('*') // Wildcard handler for any unmatched job
+ *   async handleDynamic(job: Job, entityId: string) {
+ *     // Dynamic handling
+ *   }
  * }
  * ```
  */
-export declare const EntityType: (entityType: string) => ClassDecorator & MethodDecorator;
+export declare function WorkerProcessor(options: WorkerProcessorOptions): ClassDecorator;
 /**
- * @JobType decorator
+ * @JobHandler method decorator
  *
- * Specifies the job type for a processor method.
+ * Marks a method as a handler for a specific job name.
+ * Use '*' as jobName to create a wildcard handler that catches
+ * any jobs not matched by specific handlers.
+ *
+ * @example
+ * ```typescript
+ * @JobHandler('make-bet')
+ * async handleMakeBet(job: Job<MakeBetData>, entityId: string) {
+ *   // Handle make-bet jobs
+ * }
+ *
+ * @JobHandler('*')
+ * async handleOther(job: Job, entityId: string) {
+ *   // Handle any other jobs
+ * }
+ * ```
+ */
+export declare function JobHandler(jobName: string): MethodDecorator;
+/**
+ * @EntityScaler class decorator
+ *
+ * Marks a class as an entity scaler provider for a specific entity type.
+ * Methods decorated with @GetActiveEntities, @GetDesiredWorkerCount,
+ * @OnSpawnWorker, and @OnTerminateWorker define the scaling behavior.
  *
  * @example
  * ```typescript
+ * @EntityScaler({
+ *   entityType: 'table',
+ *   maxWorkersPerEntity: 1,
+ * })
  * @Injectable()
- * export class TableProcessor {
- *   @JobType('make-bet')
- *   async handleMakeBet(job: Job) {
- *     // Process bet
+ * export class TableEntityScaler {
+ *   constructor(private readonly redis: Redis) {}
+ *
+ *   @GetActiveEntities()
+ *   async getAllTables(): Promise<string[]> {
+ *     // Return all table IDs that need workers
+ *   }
+ *
+ *   @GetDesiredWorkerCount()
+ *   async getWorkerCount(entityId: string): Promise<number> {
+ *     return 1; // Each table gets 1 worker
+ *   }
+ *
+ *   @OnSpawnWorker()
+ *   async spawnWorker(entityId: string): Promise<void> {
+ *     // Called when a worker should be spawned
  *   }
  * }
  * ```
  */
-export declare const JobType: (jobType: string) => MethodDecorator;
+export declare function EntityScaler(options: EntityScalerOptions): ClassDecorator;
 /**
- * @InjectAtomicQueue decorator
+ * @GetActiveEntities method decorator
  *
- * Custom parameter decorator for injecting a specific queue.
- * Useful when you need direct access to a queue in a service.
+ * Marks a method that returns all active entity IDs for scaling decisions.
+ * Used within an @EntityScaler class.
+ */
+export declare function GetActiveEntities(): MethodDecorator;
+/**
+ * @GetDesiredWorkerCount method decorator
  *
- * Note: This is a placeholder - actual implementation would use
- * NestJS's custom parameter decorators with module injection.
+ * Marks a method that returns the desired worker count for an entity.
+ * Used within an @EntityScaler class.
  */
-export declare const InjectAtomicQueue: (entityType: string, entityId?: string) => ParameterDecorator;
+export declare function GetDesiredWorkerCount(): MethodDecorator;
+/**
+ * @OnSpawnWorker method decorator
+ *
+ * Marks a method that is called when a worker should be spawned.
+ * Used within an @EntityScaler class.
+ */
+export declare function OnSpawnWorker(): MethodDecorator;
+/**
+ * @OnTerminateWorker method decorator
+ *
+ * Marks a method that is called when a worker should be terminated.
+ * Used within an @EntityScaler class.
+ */
+export declare function OnTerminateWorker(): MethodDecorator;
+/**
+ * Get WorkerProcessor metadata from a class
+ */
+export declare function getWorkerProcessorMetadata(target: Type<any>): WorkerProcessorOptions | undefined;
+/**
+ * Get all JobHandler metadata from a class
+ */
+export declare function getJobHandlerMetadata(target: Type<any>): JobHandlerMetadata[];
+/**
+ * Get EntityScaler metadata from a class
+ */
+export declare function getEntityScalerMetadata(target: Type<any>): EntityScalerOptions | undefined;
+/**
+ * Check if a class is a WorkerProcessor
+ */
+export declare function isWorkerProcessor(target: Type<any>): boolean;
+/**
+ * Check if a class is an EntityScaler
+ */
+export declare function isEntityScaler(target: Type<any>): boolean;
 //# sourceMappingURL=decorators.d.ts.map

package/dist/decorators/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/decorators/decorators.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,yBAAyB,qBAAqB,CAAC;AAC5D,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AACzD,eAAO,MAAM,iBAAiB,oBAAoB,CAAC;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,KAAG,eAEjD,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,GAAI,YAAY,MAAM,KAAG,cAAc,GAAG,eAEhE,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,KAAG,eAEzC,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAC5B,YAAY,MAAM,EAClB,WAAW,MAAM,KAChB,kBAsBF,CAAC"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/decorators/decorators.ts"],"names":[],"mappings":"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"}

package/dist/decorators/decorators.js

@@ -1,19 +1,46 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InjectAtomicQueue = exports.JobType = exports.EntityType = exports.AtomicProcessor = exports.JOB_TYPE_METADATA = exports.ENTITY_TYPE_METADATA = exports.ATOMIC_PROCESSOR_METADATA = void 0;
+exports.InjectAtomicQueue = exports.JobType = exports.EntityType = exports.AtomicProcessor = exports.ON_TERMINATE_WORKER_METADATA = exports.ON_SPAWN_WORKER_METADATA = exports.GET_DESIRED_WORKER_COUNT_METADATA = exports.GET_ACTIVE_ENTITIES_METADATA = exports.ENTITY_SCALER_METADATA = exports.JOB_HANDLER_METADATA = exports.WORKER_PROCESSOR_METADATA = exports.JOB_TYPE_METADATA = exports.ENTITY_TYPE_METADATA = exports.ATOMIC_PROCESSOR_METADATA = void 0;
+exports.WorkerProcessor = WorkerProcessor;
+exports.JobHandler = JobHandler;
+exports.EntityScaler = EntityScaler;
+exports.GetActiveEntities = GetActiveEntities;
+exports.GetDesiredWorkerCount = GetDesiredWorkerCount;
+exports.OnSpawnWorker = OnSpawnWorker;
+exports.OnTerminateWorker = OnTerminateWorker;
+exports.getWorkerProcessorMetadata = getWorkerProcessorMetadata;
+exports.getJobHandlerMetadata = getJobHandlerMetadata;
+exports.getEntityScalerMetadata = getEntityScalerMetadata;
+exports.isWorkerProcessor = isWorkerProcessor;
+exports.isEntityScaler = isEntityScaler;
 const common_1 = require("@nestjs/common");
+// =============================================================================
+// METADATA KEYS
+// =============================================================================
 /**
  * Metadata keys for decorators
  */
 exports.ATOMIC_PROCESSOR_METADATA = 'atomic:processor';
 exports.ENTITY_TYPE_METADATA = 'atomic:entity-type';
 exports.JOB_TYPE_METADATA = 'atomic:job-type';
+exports.WORKER_PROCESSOR_METADATA = 'atomic:worker-processor';
+exports.JOB_HANDLER_METADATA = 'atomic:job-handler';
+exports.ENTITY_SCALER_METADATA = 'atomic:entity-scaler';
+exports.GET_ACTIVE_ENTITIES_METADATA = 'atomic:get-active-entities';
+exports.GET_DESIRED_WORKER_COUNT_METADATA = 'atomic:get-desired-worker-count';
+exports.ON_SPAWN_WORKER_METADATA = 'atomic:on-spawn-worker';
+exports.ON_TERMINATE_WORKER_METADATA = 'atomic:on-terminate-worker';
+// =============================================================================
+// LEGACY DECORATORS (Preserved for backward compatibility)
+// =============================================================================
 /**
- * @AtomicProcessor decorator
+ * @AtomicProcessor decorator (LEGACY)
  *
  * Marks a method as an atomic job processor.
  * Can be used on handler methods to auto-register them.
  *
+ * @deprecated Use @WorkerProcessor class decorator with @JobHandler method decorators instead
+ *
  * @example
  * ```typescript
  * @Injectable()
@@ -30,38 +57,22 @@ const AtomicProcessor = (jobType) => {
 };
 exports.AtomicProcessor = AtomicProcessor;
 /**
- * @EntityType decorator
+ * @EntityType decorator (LEGACY)
  *
  * Marks a class or method with an entity type for automatic registration.
  *
- * @example
- * ```typescript
- * @Injectable()
- * @EntityType('user')
- * export class UserWorkerService {
- *   // All methods in this service are associated with 'user' entity type
- * }
- * ```
+ * @deprecated Use @WorkerProcessor or @EntityScaler class decorators instead
  */
 const EntityType = (entityType) => {
     return (0, common_1.SetMetadata)(exports.ENTITY_TYPE_METADATA, entityType);
 };
 exports.EntityType = EntityType;
 /**
- * @JobType decorator
+ * @JobType decorator (LEGACY)
  *
  * Specifies the job type for a processor method.
  *
- * @example
- * ```typescript
- * @Injectable()
- * export class TableProcessor {
- *   @JobType('make-bet')
- *   async handleMakeBet(job: Job) {
- *     // Process bet
- *   }
- * }
- * ```
+ * @deprecated Use @JobHandler method decorator instead
  */
 const JobType = (jobType) => {
     return (0, common_1.SetMetadata)(exports.JOB_TYPE_METADATA, jobType);
@@ -72,9 +83,6 @@ exports.JobType = JobType;
  *
  * Custom parameter decorator for injecting a specific queue.
  * Useful when you need direct access to a queue in a service.
- *
- * Note: This is a placeholder - actual implementation would use
- * NestJS's custom parameter decorators with module injection.
  */
 const InjectAtomicQueue = (entityType, entityId) => {
     return (target, propertyKey, parameterIndex) => {
@@ -88,4 +96,216 @@ const InjectAtomicQueue = (entityType, entityId) => {
     };
 };
 exports.InjectAtomicQueue = InjectAtomicQueue;
+// =============================================================================
+// NEW DECORATORS - Worker-First Architecture
+// =============================================================================
+/**
+ * @WorkerProcessor class decorator
+ *
+ * Marks a class as a worker processor for a specific entity type.
+ * Combined with @JobHandler method decorators, this enables declarative
+ * job processing with automatic worker creation and management.
+ *
+ * @example
+ * ```typescript
+ * @WorkerProcessor({
+ *   entityType: 'table',
+ *   queueName: (tableId) => `${tableId}-queue`,
+ *   workerName: (tableId) => `table-worker-${tableId}`,
+ *   workerConfig: {
+ *     concurrency: 1,
+ *     heartbeatTTL: 3,
+ *   }
+ * })
+ * @Injectable()
+ * export class TableWorkerProcessor {
+ *   constructor(private readonly commandBus: CommandBus) {}
+ *
+ *   @JobHandler('make-bet')
+ *   async handleMakeBet(job: Job<MakeBetData>, entityId: string) {
+ *     return this.commandBus.execute(new MakeBetCommand(entityId, job.data));
+ *   }
+ *
+ *   @JobHandler('*') // Wildcard handler for any unmatched job
+ *   async handleDynamic(job: Job, entityId: string) {
+ *     // Dynamic handling
+ *   }
+ * }
+ * ```
+ */
+function WorkerProcessor(options) {
+    return (target) => {
+        // Store the options on the class
+        Reflect.defineMetadata(exports.WORKER_PROCESSOR_METADATA, options, target);
+        // Mark as injectable if not already
+        if (!Reflect.hasMetadata('injectable', target)) {
+            Reflect.defineMetadata('injectable', true, target);
+        }
+    };
+}
+/**
+ * @JobHandler method decorator
+ *
+ * Marks a method as a handler for a specific job name.
+ * Use '*' as jobName to create a wildcard handler that catches
+ * any jobs not matched by specific handlers.
+ *
+ * @example
+ * ```typescript
+ * @JobHandler('make-bet')
+ * async handleMakeBet(job: Job<MakeBetData>, entityId: string) {
+ *   // Handle make-bet jobs
+ * }
+ *
+ * @JobHandler('*')
+ * async handleOther(job: Job, entityId: string) {
+ *   // Handle any other jobs
+ * }
+ * ```
+ */
+function JobHandler(jobName) {
+    return (target, propertyKey, descriptor) => {
+        const methodName = String(propertyKey);
+        const isWildcard = jobName === '*';
+        // Store handler metadata on the method
+        const metadata = {
+            jobName,
+            methodName,
+            isWildcard,
+        };
+        Reflect.defineMetadata(exports.JOB_HANDLER_METADATA, metadata, target, propertyKey);
+        // Collect all handlers on the class
+        const existingHandlers = Reflect.getMetadata(exports.JOB_HANDLER_METADATA, target.constructor) || [];
+        existingHandlers.push(metadata);
+        Reflect.defineMetadata(exports.JOB_HANDLER_METADATA, existingHandlers, target.constructor);
+        return descriptor;
+    };
+}
+/**
+ * @EntityScaler class decorator
+ *
+ * Marks a class as an entity scaler provider for a specific entity type.
+ * Methods decorated with @GetActiveEntities, @GetDesiredWorkerCount,
+ * @OnSpawnWorker, and @OnTerminateWorker define the scaling behavior.
+ *
+ * @example
+ * ```typescript
+ * @EntityScaler({
+ *   entityType: 'table',
+ *   maxWorkersPerEntity: 1,
+ * })
+ * @Injectable()
+ * export class TableEntityScaler {
+ *   constructor(private readonly redis: Redis) {}
+ *
+ *   @GetActiveEntities()
+ *   async getAllTables(): Promise<string[]> {
+ *     // Return all table IDs that need workers
+ *   }
+ *
+ *   @GetDesiredWorkerCount()
+ *   async getWorkerCount(entityId: string): Promise<number> {
+ *     return 1; // Each table gets 1 worker
+ *   }
+ *
+ *   @OnSpawnWorker()
+ *   async spawnWorker(entityId: string): Promise<void> {
+ *     // Called when a worker should be spawned
+ *   }
+ * }
+ * ```
+ */
+function EntityScaler(options) {
+    return (target) => {
+        Reflect.defineMetadata(exports.ENTITY_SCALER_METADATA, options, target);
+        if (!Reflect.hasMetadata('injectable', target)) {
+            Reflect.defineMetadata('injectable', true, target);
+        }
+    };
+}
+/**
+ * @GetActiveEntities method decorator
+ *
+ * Marks a method that returns all active entity IDs for scaling decisions.
+ * Used within an @EntityScaler class.
+ */
+function GetActiveEntities() {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(exports.GET_ACTIVE_ENTITIES_METADATA, true, target, propertyKey);
+        Reflect.defineMetadata(exports.GET_ACTIVE_ENTITIES_METADATA + ':method', String(propertyKey), target.constructor);
+        return descriptor;
+    };
+}
+/**
+ * @GetDesiredWorkerCount method decorator
+ *
+ * Marks a method that returns the desired worker count for an entity.
+ * Used within an @EntityScaler class.
+ */
+function GetDesiredWorkerCount() {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(exports.GET_DESIRED_WORKER_COUNT_METADATA, true, target, propertyKey);
+        Reflect.defineMetadata(exports.GET_DESIRED_WORKER_COUNT_METADATA + ':method', String(propertyKey), target.constructor);
+        return descriptor;
+    };
+}
+/**
+ * @OnSpawnWorker method decorator
+ *
+ * Marks a method that is called when a worker should be spawned.
+ * Used within an @EntityScaler class.
+ */
+function OnSpawnWorker() {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(exports.ON_SPAWN_WORKER_METADATA, true, target, propertyKey);
+        Reflect.defineMetadata(exports.ON_SPAWN_WORKER_METADATA + ':method', String(propertyKey), target.constructor);
+        return descriptor;
+    };
+}
+/**
+ * @OnTerminateWorker method decorator
+ *
+ * Marks a method that is called when a worker should be terminated.
+ * Used within an @EntityScaler class.
+ */
+function OnTerminateWorker() {
+    return (target, propertyKey, descriptor) => {
+        Reflect.defineMetadata(exports.ON_TERMINATE_WORKER_METADATA, true, target, propertyKey);
+        Reflect.defineMetadata(exports.ON_TERMINATE_WORKER_METADATA + ':method', String(propertyKey), target.constructor);
+        return descriptor;
+    };
+}
+// =============================================================================
+// UTILITY FUNCTIONS
+// =============================================================================
+/**
+ * Get WorkerProcessor metadata from a class
+ */
+function getWorkerProcessorMetadata(target) {
+    return Reflect.getMetadata(exports.WORKER_PROCESSOR_METADATA, target);
+}
+/**
+ * Get all JobHandler metadata from a class
+ */
+function getJobHandlerMetadata(target) {
+    return Reflect.getMetadata(exports.JOB_HANDLER_METADATA, target) || [];
+}
+/**
+ * Get EntityScaler metadata from a class
+ */
+function getEntityScalerMetadata(target) {
+    return Reflect.getMetadata(exports.ENTITY_SCALER_METADATA, target);
+}
+/**
+ * Check if a class is a WorkerProcessor
+ */
+function isWorkerProcessor(target) {
+    return Reflect.hasMetadata(exports.WORKER_PROCESSOR_METADATA, target);
+}
+/**
+ * Check if a class is an EntityScaler
+ */
+function isEntityScaler(target) {
+    return Reflect.hasMetadata(exports.ENTITY_SCALER_METADATA, target);
+}
 //# sourceMappingURL=decorators.js.map

package/dist/decorators/decorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/decorators/decorators.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAE7C;;GAEG;AACU,QAAA,yBAAyB,GAAG,kBAAkB,CAAC;AAC/C,QAAA,oBAAoB,GAAG,oBAAoB,CAAC;AAC5C,QAAA,iBAAiB,GAAG,iBAAiB,CAAC;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACI,MAAM,eAAe,GAAG,CAAC,OAAe,EAAmB,EAAE;IAClE,OAAO,IAAA,oBAAW,EAAC,iCAAyB,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC,CAAC;AAFW,QAAA,eAAe,mBAE1B;AAEF;;;;;;;;;;;;;GAaG;AACI,MAAM,UAAU,GAAG,CAAC,UAAkB,EAAoC,EAAE;IACjF,OAAO,IAAA,oBAAW,EAAC,4BAAoB,EAAE,UAAU,CAAC,CAAC;AACvD,CAAC,CAAC;AAFW,QAAA,UAAU,cAErB;AAEF;;;;;;;;;;;;;;;GAeG;AACI,MAAM,OAAO,GAAG,CAAC,OAAe,EAAmB,EAAE;IAC1D,OAAO,IAAA,oBAAW,EAAC,yBAAiB,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC,CAAC;AAFW,QAAA,OAAO,WAElB;AAEF;;;;;;;;GAQG;AACI,MAAM,iBAAiB,GAAG,CAC/B,UAAkB,EAClB,QAAiB,EACG,EAAE;IACtB,OAAO,CACL,MAAc,EACd,WAAwC,EACxC,cAAsB,EACtB,EAAE;QACF,MAAM,cAAc,GAClB,OAAO,CAAC,WAAW,CAAC,qBAAqB,EAAE,MAAM,EAAE,WAAY,CAAC,IAAI,EAAE,CAAC;QAEzE,cAAc,CAAC,IAAI,CAAC;YAClB,IAAI,EAAE,UAAU;YAChB,EAAE,EAAE,QAAQ;YACZ,KAAK,EAAE,cAAc;SACtB,CAAC,CAAC;QAEH,OAAO,CAAC,cAAc,CACpB,qBAAqB,EACrB,cAAc,EACd,MAAM,EACN,WAAY,CACb,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC;AAzBW,QAAA,iBAAiB,qBAyB5B"}
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/decorators/decorators.ts"],"names":[],"mappings":"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"}

package/dist/module/atomic-queues.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"atomic-queues.module.d.ts","sourceRoot":"","sources":["../../src/module/atomic-queues.module.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAIb,IAAI,EACL,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,yBAAyB,EAAe,MAAM,WAAW,CAAC;AAiBnE;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAE1B;;OAEG;IACH,UAAU,EAAE,CACV,GAAG,IAAI,EAAE,OAAO,EAAE,KACf,OAAO,CAAC,yBAAyB,CAAC,GAAG,yBAAyB,CAAC;IAEpE;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAEa,kBAAkB;IAC7B;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,yBAAyB,GAAG,aAAa;IAuBhE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,8BAA8B,GAAG,aAAa;IAmB3E;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,qBAAqB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7D,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,GAAG,aAAa;IAgBjB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAuBlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAUxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;CAqBxC"}
+{"version":3,"file":"atomic-queues.module.d.ts","sourceRoot":"","sources":["../../src/module/atomic-queues.module.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EAIb,IAAI,EACL,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,yBAAyB,EAAe,MAAM,WAAW,CAAC;AAkBnE;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAE1B;;OAEG;IACH,UAAU,EAAE,CACV,GAAG,IAAI,EAAE,OAAO,EAAE,KACf,OAAO,CAAC,yBAAyB,CAAC,GAAG,yBAAyB,CAAC;IAEpE;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,qBAEa,kBAAkB;IAC7B;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,yBAAyB,GAAG,aAAa;IA0BhE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,8BAA8B,GAAG,aAAa;IAyB3E;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,qBAAqB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7D,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,GAAG,aAAa;IAgBjB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAuBlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAUxC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;CAqBxC"}

package/dist/module/atomic-queues.module.js

@@ -12,6 +12,7 @@ var AtomicQueuesModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AtomicQueuesModule = void 0;
 const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
 const ioredis_1 = __importDefault(require("ioredis"));
 const services_1 = require("../services");
 /**
@@ -28,6 +29,7 @@ const CORE_SERVICES = [
     services_1.CronManagerService,
     services_1.ServiceQueueManager,
     services_1.ShutdownStateService,
+    services_1.ProcessorDiscoveryService,
 ];
 /**
  * AtomicQueuesModule
@@ -80,12 +82,15 @@ let AtomicQueuesModule = AtomicQueuesModule_1 = class AtomicQueuesModule {
             module: AtomicQueuesModule_1,
             // Note: CqrsModule should be imported by the consuming app, not here
             // to avoid duplicate CommandBus/QueryBus instances
+            imports: [core_1.DiscoveryModule],
             providers: [
                 {
                     provide: services_1.ATOMIC_QUEUES_CONFIG,
                     useValue: config,
                 },
                 redisProvider,
+                core_1.DiscoveryService,
+                core_1.MetadataScanner,
                 ...CORE_SERVICES,
             ],
             exports: [
@@ -105,8 +110,14 @@ let AtomicQueuesModule = AtomicQueuesModule_1 = class AtomicQueuesModule {
             module: AtomicQueuesModule_1,
             // Note: CqrsModule should be imported by the consuming app, not here
             // to avoid duplicate CommandBus/QueryBus instances
-            imports: [...(options.imports || [])],
-            providers: [configProvider, redisProvider, ...CORE_SERVICES],
+            imports: [core_1.DiscoveryModule, ...(options.imports || [])],
+            providers: [
+                configProvider,
+                redisProvider,
+                core_1.DiscoveryService,
+                core_1.MetadataScanner,
+                ...CORE_SERVICES,
+            ],
             exports: [
                 services_1.ATOMIC_QUEUES_CONFIG,
                 services_1.ATOMIC_QUEUES_REDIS,