atomic-queues 1.4.1 → 1.6.0

package/dist/decorators/legacy.decorators.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @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()
+ * export class MessageProcessor {
+ *   @AtomicProcessor('send-message')
+ *   async handleSendMessage(job: Job<IAtomicJobData>) {
+ *     // Process the job
+ *   }
+ * }
+ * ```
+ */
+export declare const AtomicProcessor: (jobType: string) => 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;
+//# sourceMappingURL=legacy.decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.decorators.d.ts","sourceRoot":"","sources":["../../src/decorators/legacy.decorators.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,KAAG,eAEjD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,KAAG,eAEzC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,YAAY,MAAM,EAClB,WAAW,MAAM,KAChB,kBAsBF,CAAC"}

package/dist/decorators/legacy.decorators.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectAtomicQueue = exports.JobType = exports.AtomicProcessor = void 0;
+const common_1 = require("@nestjs/common");
+const constants_1 = require("./constants");
+// =============================================================================
+// LEGACY DECORATORS (Preserved for backward compatibility)
+// =============================================================================
+/**
+ * @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()
+ * export class MessageProcessor {
+ *   @AtomicProcessor('send-message')
+ *   async handleSendMessage(job: Job<IAtomicJobData>) {
+ *     // Process the job
+ *   }
+ * }
+ * ```
+ */
+const AtomicProcessor = (jobType) => {
+    return (0, common_1.SetMetadata)(constants_1.ATOMIC_PROCESSOR_METADATA, jobType);
+};
+exports.AtomicProcessor = AtomicProcessor;
+/**
+ * @JobType decorator (LEGACY)
+ *
+ * Specifies the job type for a processor method.
+ *
+ * @deprecated Use @JobHandler method decorator instead
+ */
+const JobType = (jobType) => {
+    return (0, common_1.SetMetadata)(constants_1.JOB_TYPE_METADATA, jobType);
+};
+exports.JobType = JobType;
+/**
+ * @InjectAtomicQueue decorator
+ *
+ * Custom parameter decorator for injecting a specific queue.
+ * Useful when you need direct access to a queue in a service.
+ */
+const InjectAtomicQueue = (entityType, entityId) => {
+    return (target, propertyKey, parameterIndex) => {
+        const existingParams = Reflect.getMetadata('atomic:inject-queue', target, propertyKey) || [];
+        existingParams.push({
+            type: entityType,
+            id: entityId,
+            index: parameterIndex,
+        });
+        Reflect.defineMetadata('atomic:inject-queue', existingParams, target, propertyKey);
+    };
+};
+exports.InjectAtomicQueue = InjectAtomicQueue;
+//# sourceMappingURL=legacy.decorators.js.map

package/dist/decorators/legacy.decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.decorators.js","sourceRoot":"","sources":["../../src/decorators/legacy.decorators.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAC7C,2CAA2E;AAE3E,gFAAgF;AAChF,2DAA2D;AAC3D,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AACI,MAAM,eAAe,GAAG,CAAC,OAAe,EAAmB,EAAE;IAClE,OAAO,IAAA,oBAAW,EAAC,qCAAyB,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC,CAAC;AAFW,QAAA,eAAe,mBAE1B;AAEF;;;;;;GAMG;AACI,MAAM,OAAO,GAAG,CAAC,OAAe,EAAmB,EAAE;IAC1D,OAAO,IAAA,oBAAW,EAAC,6BAAiB,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC,CAAC;AAFW,QAAA,OAAO,WAElB;AAEF;;;;;GAKG;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"}

package/dist/decorators/metadata-readers.d.ts

@@ -0,0 +1,31 @@
+import { Type } from '@nestjs/common';
+import { WorkerProcessorOptions, JobHandlerMetadata, EntityScalerOptions, JobCommandMetadata, JobQueryMetadata } from './interfaces';
+/**
+ * Get the entity type from a command/query class decorated with @EntityType or @QueueEntity
+ */
+export declare function getEntityType(target: Function): string | undefined;
+/**
+ * Get the entity ID property name from a class decorated with @QueueEntityId or @QueueEntity
+ */
+export declare function getEntityIdProperty(target: Function): string | undefined;
+/**
+ * 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;
+/**
+ * Get JobCommand metadata from a class
+ */
+export declare function getJobCommandMetadata(target: Function): JobCommandMetadata | undefined;
+/**
+ * Get JobQuery metadata from a class
+ */
+export declare function getJobQueryMetadata(target: Function): JobQueryMetadata | undefined;
+//# sourceMappingURL=metadata-readers.d.ts.map

package/dist/decorators/metadata-readers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-readers.d.ts","sourceRoot":"","sources":["../../src/decorators/metadata-readers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAUtC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAElE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAExE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,sBAAsB,GAAG,SAAS,CAEhG;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,kBAAkB,EAAE,CAE7E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,mBAAmB,GAAG,SAAS,CAE1F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAEtF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,gBAAgB,GAAG,SAAS,CAElF"}

package/dist/decorators/metadata-readers.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEntityType = getEntityType;
+exports.getEntityIdProperty = getEntityIdProperty;
+exports.getWorkerProcessorMetadata = getWorkerProcessorMetadata;
+exports.getJobHandlerMetadata = getJobHandlerMetadata;
+exports.getEntityScalerMetadata = getEntityScalerMetadata;
+exports.getJobCommandMetadata = getJobCommandMetadata;
+exports.getJobQueryMetadata = getJobQueryMetadata;
+const constants_1 = require("./constants");
+/**
+ * Get the entity type from a command/query class decorated with @EntityType or @QueueEntity
+ */
+function getEntityType(target) {
+    return Reflect.getMetadata(constants_1.ENTITY_TYPE_METADATA, target);
+}
+/**
+ * Get the entity ID property name from a class decorated with @QueueEntityId or @QueueEntity
+ */
+function getEntityIdProperty(target) {
+    return Reflect.getMetadata(constants_1.ENTITY_ID_METADATA, target);
+}
+/**
+ * Get WorkerProcessor metadata from a class
+ */
+function getWorkerProcessorMetadata(target) {
+    return Reflect.getMetadata(constants_1.WORKER_PROCESSOR_METADATA, target);
+}
+/**
+ * Get all JobHandler metadata from a class
+ */
+function getJobHandlerMetadata(target) {
+    return Reflect.getMetadata(constants_1.JOB_HANDLER_METADATA, target) || [];
+}
+/**
+ * Get EntityScaler metadata from a class
+ */
+function getEntityScalerMetadata(target) {
+    return Reflect.getMetadata(constants_1.ENTITY_SCALER_METADATA, target);
+}
+/**
+ * Get JobCommand metadata from a class
+ */
+function getJobCommandMetadata(target) {
+    return Reflect.getMetadata(constants_1.JOB_COMMAND_METADATA, target);
+}
+/**
+ * Get JobQuery metadata from a class
+ */
+function getJobQueryMetadata(target) {
+    return Reflect.getMetadata(constants_1.JOB_QUERY_METADATA, target);
+}
+//# sourceMappingURL=metadata-readers.js.map

package/dist/decorators/metadata-readers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-readers.js","sourceRoot":"","sources":["../../src/decorators/metadata-readers.ts"],"names":[],"mappings":";;AAqBA,sCAEC;AAKD,kDAEC;AAKD,gEAEC;AAKD,sDAEC;AAKD,0DAEC;AAKD,sDAEC;AAKD,kDAEC;AAhED,2CAQqB;AASrB;;GAEG;AACH,SAAgB,aAAa,CAAC,MAAgB;IAC5C,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAoB,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,MAAgB;IAClD,OAAO,OAAO,CAAC,WAAW,CAAC,8BAAkB,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,SAAgB,0BAA0B,CAAC,MAAiB;IAC1D,OAAO,OAAO,CAAC,WAAW,CAAC,qCAAyB,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAiB;IACrD,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAoB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CAAC,MAAiB;IACvD,OAAO,OAAO,CAAC,WAAW,CAAC,kCAAsB,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAgB;IACpD,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAoB,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,MAAgB;IAClD,OAAO,OAAO,CAAC,WAAW,CAAC,8BAAkB,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC"}

package/dist/decorators/registry.d.ts

@@ -0,0 +1,2 @@
+export declare const queueEntityIdRegistry: Map<Function, string>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/decorators/registry.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}

package/dist/decorators/registry.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.queueEntityIdRegistry = void 0;
+// Registry to track @QueueEntityId usage per class (for duplicate detection)
+exports.queueEntityIdRegistry = new Map();
+//# sourceMappingURL=registry.js.map

package/dist/decorators/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/decorators/registry.ts"],"names":[],"mappings":";;;AAAA,6EAA6E;AAChE,QAAA,qBAAqB,GAAG,IAAI,GAAG,EAAoB,CAAC"}

package/dist/decorators/scaler.decorators.d.ts

@@ -0,0 +1,65 @@
+import { EntityScalerOptions } from './interfaces';
+/**
+ * @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
+ *   }
+ * }
+ * ```
+ */
+export declare function EntityScaler(options: EntityScalerOptions): ClassDecorator;
+/**
+ * @GetActiveEntities method decorator
+ *
+ * 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
+ *
+ * Marks a method that returns the desired worker count for an entity.
+ * Used within an @EntityScaler class.
+ */
+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;
+//# sourceMappingURL=scaler.decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaler.decorators.d.ts","sourceRoot":"","sources":["../../src/decorators/scaler.decorators.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc,CAQzE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,eAAe,CAcnD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAcvD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,eAAe,CAc/C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,eAAe,CAcnD"}

package/dist/decorators/scaler.decorators.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityScaler = EntityScaler;
+exports.GetActiveEntities = GetActiveEntities;
+exports.GetDesiredWorkerCount = GetDesiredWorkerCount;
+exports.OnSpawnWorker = OnSpawnWorker;
+exports.OnTerminateWorker = OnTerminateWorker;
+const constants_1 = require("./constants");
+/**
+ * @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(constants_1.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(constants_1.GET_ACTIVE_ENTITIES_METADATA, true, target, propertyKey);
+        Reflect.defineMetadata(constants_1.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(constants_1.GET_DESIRED_WORKER_COUNT_METADATA, true, target, propertyKey);
+        Reflect.defineMetadata(constants_1.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(constants_1.ON_SPAWN_WORKER_METADATA, true, target, propertyKey);
+        Reflect.defineMetadata(constants_1.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(constants_1.ON_TERMINATE_WORKER_METADATA, true, target, propertyKey);
+        Reflect.defineMetadata(constants_1.ON_TERMINATE_WORKER_METADATA + ':method', String(propertyKey), target.constructor);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=scaler.decorators.js.map

package/dist/decorators/scaler.decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaler.decorators.js","sourceRoot":"","sources":["../../src/decorators/scaler.decorators.ts"],"names":[],"mappings":";;AA2CA,oCAQC;AAQD,8CAcC;AAQD,sDAcC;AAQD,sCAcC;AAQD,8CAcC;AA3ID,2CAMqB;AAGrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,SAAgB,YAAY,CAAC,OAA4B;IACvD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,OAAO,CAAC,cAAc,CAAC,kCAAsB,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAEhE,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,CACL,MAAc,EACd,WAA4B,EAC5B,UAA8B,EAC9B,EAAE;QACF,OAAO,CAAC,cAAc,CAAC,wCAA4B,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAChF,OAAO,CAAC,cAAc,CACpB,wCAA4B,GAAG,SAAS,EACxC,MAAM,CAAC,WAAW,CAAC,EACnB,MAAM,CAAC,WAAW,CACnB,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB;IACnC,OAAO,CACL,MAAc,EACd,WAA4B,EAC5B,UAA8B,EAC9B,EAAE;QACF,OAAO,CAAC,cAAc,CAAC,6CAAiC,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACrF,OAAO,CAAC,cAAc,CACpB,6CAAiC,GAAG,SAAS,EAC7C,MAAM,CAAC,WAAW,CAAC,EACnB,MAAM,CAAC,WAAW,CACnB,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa;IAC3B,OAAO,CACL,MAAc,EACd,WAA4B,EAC5B,UAA8B,EAC9B,EAAE;QACF,OAAO,CAAC,cAAc,CAAC,oCAAwB,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC5E,OAAO,CAAC,cAAc,CACpB,oCAAwB,GAAG,SAAS,EACpC,MAAM,CAAC,WAAW,CAAC,EACnB,MAAM,CAAC,WAAW,CACnB,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB;IAC/B,OAAO,CACL,MAAc,EACd,WAA4B,EAC5B,UAA8B,EAC9B,EAAE;QACF,OAAO,CAAC,cAAc,CAAC,wCAA4B,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAChF,OAAO,CAAC,cAAc,CACpB,wCAA4B,GAAG,SAAS,EACxC,MAAM,CAAC,WAAW,CAAC,EACnB,MAAM,CAAC,WAAW,CACnB,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/type-guards.d.ts

@@ -0,0 +1,18 @@
+import { Type } from '@nestjs/common';
+/**
+ * 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;
+/**
+ * Check if a class is a JobCommand
+ */
+export declare function isJobCommand(target: Function): boolean;
+/**
+ * Check if a class is a JobQuery
+ */
+export declare function isJobQuery(target: Function): boolean;
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/decorators/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/decorators/type-guards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAQtC;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEpD"}

package/dist/decorators/type-guards.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWorkerProcessor = isWorkerProcessor;
+exports.isEntityScaler = isEntityScaler;
+exports.isJobCommand = isJobCommand;
+exports.isJobQuery = isJobQuery;
+const constants_1 = require("./constants");
+/**
+ * Check if a class is a WorkerProcessor
+ */
+function isWorkerProcessor(target) {
+    return Reflect.hasMetadata(constants_1.WORKER_PROCESSOR_METADATA, target);
+}
+/**
+ * Check if a class is an EntityScaler
+ */
+function isEntityScaler(target) {
+    return Reflect.hasMetadata(constants_1.ENTITY_SCALER_METADATA, target);
+}
+/**
+ * Check if a class is a JobCommand
+ */
+function isJobCommand(target) {
+    return Reflect.hasMetadata(constants_1.JOB_COMMAND_METADATA, target);
+}
+/**
+ * Check if a class is a JobQuery
+ */
+function isJobQuery(target) {
+    return Reflect.hasMetadata(constants_1.JOB_QUERY_METADATA, target);
+}
+//# sourceMappingURL=type-guards.js.map

package/dist/decorators/type-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.js","sourceRoot":"","sources":["../../src/decorators/type-guards.ts"],"names":[],"mappings":";;AAWA,8CAEC;AAKD,wCAEC;AAKD,oCAEC;AAKD,gCAEC;AAjCD,2CAKqB;AAErB;;GAEG;AACH,SAAgB,iBAAiB,CAAC,MAAiB;IACjD,OAAO,OAAO,CAAC,WAAW,CAAC,qCAAyB,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,MAAiB;IAC9C,OAAO,OAAO,CAAC,WAAW,CAAC,kCAAsB,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,MAAgB;IAC3C,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAoB,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU,CAAC,MAAgB;IACzC,OAAO,OAAO,CAAC,WAAW,CAAC,8BAAkB,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC"}

package/dist/decorators/utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Extract parameter name from constructor function by parsing its string representation.
+ * Works with TypeScript's 'public readonly paramName' shorthand.
+ */
+export declare function getConstructorParamName(constructor: Function, index: number): string | undefined;
+/**
+ * Split parameter string by commas, respecting nested structures
+ */
+export declare function splitParams(paramsStr: string): string[];
+/**
+ * Helper to convert class name to kebab-case job name
+ * MakeBetCommand -> make-bet
+ * ProcessPaymentCommand -> process-payment
+ */
+export declare function deriveJobName(className: string, suffix: string): string;
+/**
+ * Helper to extract constructor parameter names using reflection
+ */
+export declare function getConstructorParamNames(target: Function): string[];
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/decorators/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuBhG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBvD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,CAwBnE"}

package/dist/decorators/utils.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConstructorParamName = getConstructorParamName;
+exports.splitParams = splitParams;
+exports.deriveJobName = deriveJobName;
+exports.getConstructorParamNames = getConstructorParamNames;
+/**
+ * Extract parameter name from constructor function by parsing its string representation.
+ * Works with TypeScript's 'public readonly paramName' shorthand.
+ */
+function getConstructorParamName(constructor, index) {
+    const fnStr = constructor.toString();
+    // Match constructor parameters - handles various formats
+    const constructorMatch = fnStr.match(/constructor\s*\(([^)]*)\)/);
+    if (!constructorMatch)
+        return undefined;
+    const paramsStr = constructorMatch[1];
+    if (!paramsStr.trim())
+        return undefined;
+    // Split by comma, but be careful with nested generics/objects
+    const params = splitParams(paramsStr);
+    if (index >= params.length)
+        return undefined;
+    const param = params[index].trim();
+    // Extract the actual parameter name, handling:
+    // - @Decorator() public readonly paramName: Type
+    // - public readonly paramName: Type
+    // - paramName: Type
+    // - paramName
+    const nameMatch = param.match(/(?:@\w+\([^)]*\)\s*)*(?:public\s+)?(?:readonly\s+)?(\w+)/);
+    return nameMatch ? nameMatch[1] : undefined;
+}
+/**
+ * Split parameter string by commas, respecting nested structures
+ */
+function splitParams(paramsStr) {
+    const params = [];
+    let current = '';
+    let depth = 0;
+    for (const char of paramsStr) {
+        if (char === '(' || char === '<' || char === '{' || char === '[') {
+            depth++;
+            current += char;
+        }
+        else if (char === ')' || char === '>' || char === '}' || char === ']') {
+            depth--;
+            current += char;
+        }
+        else if (char === ',' && depth === 0) {
+            params.push(current);
+            current = '';
+        }
+        else {
+            current += char;
+        }
+    }
+    if (current.trim()) {
+        params.push(current);
+    }
+    return params;
+}
+/**
+ * Helper to convert class name to kebab-case job name
+ * MakeBetCommand -> make-bet
+ * ProcessPaymentCommand -> process-payment
+ */
+function deriveJobName(className, suffix) {
+    return className
+        .replace(new RegExp(`${suffix}$`), '')
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .toLowerCase();
+}
+/**
+ * Helper to extract constructor parameter names using reflection
+ */
+function getConstructorParamNames(target) {
+    const paramTypes = Reflect.getMetadata('design:paramtypes', target) || [];
+    // Try to extract parameter names from the constructor string
+    const constructorStr = target.toString();
+    const match = constructorStr.match(/constructor\s*\(([^)]*)\)/);
+    if (match && match[1]) {
+        return match[1]
+            .split(',')
+            .map((param) => {
+            // Handle various patterns:
+            // "public readonly tableId: string" -> "tableId"
+            // "tableId" -> "tableId"
+            // "private tableId: string" -> "tableId"
+            const cleaned = param.trim();
+            const nameMatch = cleaned.match(/(?:public\s+)?(?:private\s+)?(?:protected\s+)?(?:readonly\s+)?(\w+)/);
+            return nameMatch ? nameMatch[1] : cleaned;
+        })
+            .filter((name) => name.length > 0);
+    }
+    // Fallback: generate param0, param1, etc.
+    return paramTypes.map((_, i) => `param${i}`);
+}
+//# sourceMappingURL=utils.js.map

package/dist/decorators/utils.js.map

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

package/dist/decorators/worker.decorators.d.ts

@@ -0,0 +1,58 @@
+import { WorkerProcessorOptions } from './interfaces';
+/**
+ * @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
+ *   }
+ * }
+ * ```
+ */
+export declare function WorkerProcessor(options: WorkerProcessorOptions): ClassDecorator;
+/**
+ * @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
+ * }
+ * ```
+ */
+export declare function JobHandler(jobName: string): MethodDecorator;
+//# sourceMappingURL=worker.decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker.decorators.d.ts","sourceRoot":"","sources":["../../src/decorators/worker.decorators.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAsB,MAAM,cAAc,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,cAAc,CAc/E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAyB3D"}