atomic-queues 1.4.1 → 1.6.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"naming.utils.d.ts","sourceRoot":"","sources":["../../src/utils/naming.utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAO,GACZ,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,SAAO,GACZ,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAUP"}

package/dist/utils/naming.utils.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_KEY_PREFIX = void 0;
+exports.resolveKeyPrefix = resolveKeyPrefix;
+exports.getEntityQueueName = getEntityQueueName;
+exports.getEntityWorkerName = getEntityWorkerName;
+exports.parseQueueName = parseQueueName;
+exports.DEFAULT_KEY_PREFIX = 'aq';
+function resolveKeyPrefix(config) {
+    return config.keyPrefix || exports.DEFAULT_KEY_PREFIX;
+}
+/**
+ * Generate a queue name for an entity.
+ */
+function getEntityQueueName(entityType, entityId, prefix = 'aq') {
+    return `${prefix}:${entityType}:${entityId}:queue`;
+}
+/**
+ * Generate a worker name for an entity.
+ */
+function getEntityWorkerName(entityType, entityId, prefix = 'aq') {
+    return `${prefix}:${entityType}:${entityId}:worker`;
+}
+/**
+ * Parse a queue name to extract entity info.
+ */
+function parseQueueName(queueName) {
+    const parts = queueName.split(':');
+    if (parts.length >= 4 && parts[3] === 'queue') {
+        return {
+            prefix: parts[0],
+            entityType: parts[1],
+            entityId: parts[2],
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=naming.utils.js.map

package/dist/utils/naming.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.utils.js","sourceRoot":"","sources":["../../src/utils/naming.utils.ts"],"names":[],"mappings":";;;AAEA,4CAEC;AAKD,gDAMC;AAKD,kDAMC;AAKD,wCAcC;AA7CY,QAAA,kBAAkB,GAAG,IAAI,CAAC;AAEvC,SAAgB,gBAAgB,CAAC,MAA8B;IAC7D,OAAO,MAAM,CAAC,SAAS,IAAI,0BAAkB,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAChC,UAAkB,EAClB,QAAgB,EAChB,MAAM,GAAG,IAAI;IAEb,OAAO,GAAG,MAAM,IAAI,UAAU,IAAI,QAAQ,QAAQ,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CACjC,UAAkB,EAClB,QAAgB,EAChB,MAAM,GAAG,IAAI;IAEb,OAAO,GAAG,MAAM,IAAI,UAAU,IAAI,QAAQ,SAAS,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,SAAiB;IAK9C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;QAC9C,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;YAChB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;YACpB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;SACnB,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/rate-limit.utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Debounce utility for functions.
+ */
+export declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, ms: number): (...args: Parameters<T>) => void;
+/**
+ * Throttle utility for functions.
+ */
+export declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, ms: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=rate-limit.utils.d.ts.map

package/dist/utils/rate-limit.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.utils.d.ts","sourceRoot":"","sources":["../../src/utils/rate-limit.utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,EAAE,EAAE,CAAC,EACL,EAAE,EAAE,MAAM,GACT,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CASlC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,EAAE,EAAE,CAAC,EACL,EAAE,EAAE,MAAM,GACT,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAUlC"}

package/dist/utils/rate-limit.utils.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debounce = debounce;
+exports.throttle = throttle;
+/**
+ * Debounce utility for functions.
+ */
+function debounce(fn, ms) {
+    let timeoutId = null;
+    return (...args) => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+        timeoutId = setTimeout(() => fn(...args), ms);
+    };
+}
+/**
+ * Throttle utility for functions.
+ */
+function throttle(fn, ms) {
+    let lastCall = 0;
+    return (...args) => {
+        const now = Date.now();
+        if (now - lastCall >= ms) {
+            lastCall = now;
+            fn(...args);
+        }
+    };
+}
+//# sourceMappingURL=rate-limit.utils.js.map

package/dist/utils/rate-limit.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.utils.js","sourceRoot":"","sources":["../../src/utils/rate-limit.utils.ts"],"names":[],"mappings":";;AAGA,4BAYC;AAKD,4BAaC;AAjCD;;GAEG;AACH,SAAgB,QAAQ,CACtB,EAAK,EACL,EAAU;IAEV,IAAI,SAAS,GAA0B,IAAI,CAAC;IAE5C,OAAO,CAAC,GAAG,IAAmB,EAAE,EAAE;QAChC,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;QACD,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,QAAQ,CACtB,EAAK,EACL,EAAU;IAEV,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,OAAO,CAAC,GAAG,IAAmB,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,QAAQ,IAAI,EAAE,EAAE,CAAC;YACzB,QAAQ,GAAG,GAAG,CAAC;YACf,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/redis.utils.d.ts

@@ -0,0 +1,3 @@
+import Redis from 'ioredis';
+export declare function scanKeys(redis: Redis, pattern: string, count?: number): Promise<string[]>;
+//# sourceMappingURL=redis.utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis.utils.d.ts","sourceRoot":"","sources":["../../src/utils/redis.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,SAAS,CAAC;AAE5B,wBAAsB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAS5F"}

package/dist/utils/redis.utils.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanKeys = scanKeys;
+async function scanKeys(redis, pattern, count = 100) {
+    let cursor = '0';
+    const keys = [];
+    do {
+        const [nextCursor, foundKeys] = await redis.scan(cursor, 'MATCH', pattern, 'COUNT', count);
+        cursor = nextCursor;
+        keys.push(...foundKeys);
+    } while (cursor !== '0');
+    return keys;
+}
+//# sourceMappingURL=redis.utils.js.map

package/dist/utils/redis.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.utils.js","sourceRoot":"","sources":["../../src/utils/redis.utils.ts"],"names":[],"mappings":";;AAEA,4BASC;AATM,KAAK,UAAU,QAAQ,CAAC,KAAY,EAAE,OAAe,EAAE,KAAK,GAAG,GAAG;IACvE,IAAI,MAAM,GAAG,GAAG,CAAC;IACjB,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,GAAG,CAAC;QACF,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3F,MAAM,GAAG,UAAU,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1B,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;IACzB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atomic-queues",
-  "version": "1.4.1",
+  "version": "1.6.0",
   "description": "A plug-and-play NestJS library for atomic process handling per entity with BullMQ, Redis distributed locking, and dynamic worker management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -42,39 +42,39 @@
   "author": "",
   "license": "MIT",
   "peerDependencies": {
-    "@nestjs/bullmq": ">=10.0.0",
     "@nestjs/common": ">=10.0.0",
     "@nestjs/core": ">=10.0.0",
     "@nestjs/cqrs": ">=10.0.0",
-    "bullmq": ">=5.0.0",
-    "ioredis": ">=5.0.0",
     "reflect-metadata": ">=0.1.13",
     "rxjs": ">=7.0.0"
   },
   "devDependencies": {
-    "@nestjs/bullmq": "^10.2.0",
-    "@nestjs/common": "^10.3.0",
-    "@nestjs/core": "^10.3.0",
-    "@nestjs/cqrs": "^10.2.0",
+    "@nestjs/bullmq": "^11.0.4",
+    "@nestjs/common": "^11.1.19",
+    "@nestjs/core": "^11.1.19",
+    "@nestjs/cqrs": "^11.0.3",
     "@types/jest": "^29.5.0",
-    "@types/node": "^20.0.0",
+    "@types/node": "^25.6.0",
     "@types/uuid": "^10.0.0",
     "@typescript-eslint/eslint-plugin": "^6.0.0",
     "@typescript-eslint/parser": "^6.0.0",
-    "bullmq": "^5.1.0",
+    "bullmq": "^5.74.1",
     "eslint": "^8.0.0",
-    "ioredis": "^5.3.0",
+    "ioredis": "^5.10.1",
     "jest": "^29.5.0",
     "reflect-metadata": "^0.1.13",
-    "rimraf": "^6.1.2",
-    "rxjs": "^7.8.0",
+    "rimraf": "^6.1.3",
+    "rxjs": "^7.8.2",
     "shx": "^0.4.0",
-    "ts-jest": "^29.1.0",
-    "typescript": "^5.3.0",
-    "uuid": "^9.0.0"
+    "ts-jest": "^29.4.9",
+    "typescript": "^5.9.3",
+    "uuid": "^9.0.1"
   },
   "dependencies": {
+    "@nestjs/bullmq": "^11.0.4",
+    "bullmq": "^5.74.1",
     "class-transformer": "^0.5.1",
-    "uuid": "^9.0.0"
+    "ioredis": "^5.10.1",
+    "uuid": "^9.0.1"
   }
 }

package/dist/decorators/decorators.d.ts

@@ -1,489 +0,0 @@
-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 ENTITY_ID_METADATA = "atomic:entity-id";
-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";
-export declare const JOB_COMMAND_METADATA = "atomic:job-command";
-export declare const JOB_QUERY_METADATA = "atomic:job-query";
-/**
- * Options for @WorkerProcessor decorator
- */
-export interface WorkerProcessorOptions {
-    /** Entity type this processor handles (e.g., 'table', 'user') */
-    entityType: string;
-    /** Default property name for entity ID extraction (optional) */
-    defaultEntityId?: 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;
-    /**
-     * If true, workerConfig fully replaces module workerDefaults (no merge).
-     * If false (default), workerConfig is merged with workerDefaults.
-     */
-    overrideDefaults?: boolean;
-    /**
-     * Maximum workers per entity (default: 1).
-     * Used when operating without an EntityScaler.
-     */
-    maxWorkersPerEntity?: number;
-    /**
-     * Idle timeout in seconds before a worker is considered idle and can be terminated.
-     * Workers self-report idle time via heartbeat. Default: 15 seconds.
-     * Used when operating without an EntityScaler.
-     */
-    idleTimeoutSeconds?: number;
-    /**
-     * If true, workers are automatically spawned when jobs arrive (scalerless mode).
-     * When enabled, no @EntityScaler is required - workers spawn on job arrival
-     * and terminate when idle. Default: true if no EntityScaler is registered.
-     */
-    autoSpawn?: boolean;
-}
-/**
- * Options for @EntityScaler decorator
- */
-export interface EntityScalerOptions {
-    /** Entity type this scaler handles */
-    entityType: string;
-    /** Maximum workers per entity */
-    maxWorkersPerEntity?: number;
-    /**
-     * Idle timeout in seconds before a worker is considered idle and can be terminated.
-     * Workers self-report idle time via heartbeat. Default: 15 seconds.
-     */
-    idleTimeoutSeconds?: number;
-}
-/**
- * Options for @JobCommand decorator
- */
-export interface JobCommandOptions {
-    /** Job name (defaults to kebab-case of class name without 'Command' suffix) */
-    name?: string;
-    /** Entity type this command belongs to (optional, for scoped routing) */
-    entityType?: string;
-    /** Which constructor parameter is the entityId (default: 0 = first param) */
-    entityIdParam?: number | string;
-}
-/**
- * Options for @JobQuery decorator
- */
-export interface JobQueryOptions {
-    /** Job name (defaults to kebab-case of class name without 'Query' suffix) */
-    name?: string;
-    /** Entity type this query belongs to (optional, for scoped routing) */
-    entityType?: string;
-    /** Which constructor parameter is the entityId (default: 0 = first param) */
-    entityIdParam?: number | string;
-}
-/**
- * Stored job command metadata
- */
-export interface JobCommandMetadata {
-    jobName: string;
-    entityType?: string;
-    entityIdParam: number | string;
-    targetClass: Function;
-    paramNames: string[];
-}
-/**
- * Stored job query metadata
- */
-export interface JobQueryMetadata {
-    jobName: string;
-    entityType?: string;
-    entityIdParam: number | string;
-    targetClass: Function;
-    paramNames: string[];
-}
-/**
- * Stored job handler metadata
- */
-export interface JobHandlerMetadata {
-    jobName: string;
-    methodName: string;
-    isWildcard: boolean;
-}
-/**
- * Stored worker processor metadata
- */
-export interface WorkerProcessorMetadata {
-    entityType: string;
-    defaultEntityId?: string;
-    queueNameFn: (entityId: string) => string;
-    workerNameFn: (entityId: string) => string;
-    workerConfig: IWorkerConfig;
-    overrideDefaults: boolean;
-    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()
- * export class MessageProcessor {
- *   @AtomicProcessor('send-message')
- *   async handleSendMessage(job: Job<IAtomicJobData>) {
- *     // Process the job
- *   }
- * }
- * ```
- */
-export declare const AtomicProcessor: (jobType: string) => MethodDecorator;
-/**
- * @EntityType decorator
- *
- * Marks a command/query class with its entity type for automatic routing.
- * When present, queueBus.enqueue(cmd) can auto-route without forEntity().
- *
- * @example
- * ```typescript
- * @EntityType('account')
- * export class WithdrawCommand {
- *   @QueueEntityId()
- *   public readonly accountId: string;
- *   public readonly amount: number;
- * }
- *
- * // Can now use direct enqueue:
- * await queueBus.enqueue(new WithdrawCommand(accountId, amount));
- * ```
- */
-export declare function EntityType(entityType: string): ClassDecorator;
-/**
- * @QueueEntityId decorator
- *
- * Marks a property OR constructor parameter as the entity ID for queue routing.
- * Only ONE @QueueEntityId() allowed per class (enforced at decoration time).
- * Overrides module-level defaultEntityId configuration.
- *
- * @example Property decorator:
- * ```typescript
- * export class TransferCommand {
- *   @QueueEntityId()
- *   public readonly sourceAccountId: string;
- *   public readonly amount: number;
- * }
- * ```
- *
- * @example Parameter decorator (recommended):
- * ```typescript
- * @QueueEntity('account')
- * export class TransferCommand {
- *   constructor(
- *     @QueueEntityId() public readonly sourceAccountId: string,
- *     public readonly amount: number,
- *   ) {}
- * }
- * ```
- */
-export declare function QueueEntityId(): PropertyDecorator & ParameterDecorator;
-/**
- * @deprecated Use @QueueEntityId() instead. This alias is provided for backwards compatibility.
- */
-export declare const EntityId: typeof QueueEntityId;
-/**
- * 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;
-/**
- * @QueueEntity decorator
- *
- * Single decorator that combines @EntityType and @QueueEntityId into one.
- * This is the recommended way to mark commands/queries for queue routing.
- *
- * @param entityType - The entity type for routing (e.g., 'table', 'account')
- * @param entityIdProperty - Optional property name containing the entity ID.
- *                           If omitted, uses module-level defaultEntityId from entities config.
- *
- * @example
- * // With explicit property name:
- * @QueueEntity('table', 'tableId')
- * export class MakeBetCommand {
- *   constructor(
- *     public readonly tableId: string,  // ← unchanged!
- *     public readonly amount: number,
- *   ) {}
- * }
- *
- * @example
- * // Using module default (entities config has defaultEntityId: 'tableId'):
- * @QueueEntity('table')
- * export class DealCommand {
- *   constructor(
- *     public readonly tableId: string,
- *     public readonly card: string,
- *   ) {}
- * }
- *
- * @example
- * // Then just enqueue directly:
- * await queueBus.enqueue(new MakeBetCommand(tableId, 100));
- */
-export declare function QueueEntity(entityType: string, entityIdProperty?: string): ClassDecorator;
-/**
- * @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()
- * 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;
-/**
- * @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;
-/**
- * @JobCommand class decorator
- *
- * Marks a command class for automatic job routing. When a job with the
- * specified name arrives, the library will automatically instantiate
- * the command with entityId + job.data and execute it via CommandBus.
- *
- * This eliminates the need for @JobHandler boilerplate in processors.
- *
- * @example
- * ```typescript
- * // Option 1: Explicit job name
- * @JobCommand('make-bet')
- * export class MakeBetCommand {
- *   constructor(
- *     public readonly tableId: string,    // entityId (first param)
- *     public readonly playerId: string,
- *     public readonly amount: number,
- *   ) {}
- * }
- *
- * // Option 2: Auto-derived job name (MakeBetCommand -> 'make-bet')
- * @JobCommand()
- * export class MakeBetCommand { ... }
- *
- * // Option 3: With options
- * @JobCommand({
- *   name: 'place-bet',
- *   entityType: 'table',
- *   entityIdParam: 'tableId',  // or 0 for first param
- * })
- * export class PlaceBetCommand { ... }
- * ```
- */
-export declare function JobCommand(options?: string | JobCommandOptions): ClassDecorator;
-/**
- * @JobQuery class decorator
- *
- * Marks a query class for automatic job routing. When a job with the
- * specified name arrives, the library will automatically instantiate
- * the query with entityId + job.data and execute it via QueryBus.
- *
- * @example
- * ```typescript
- * @JobQuery('get-score')
- * export class GetScoreQuery {
- *   constructor(
- *     public readonly tableId: string,
- *     public readonly seatIndex: number,
- *   ) {}
- * }
- *
- * // Auto-derived: GetTableStateQuery -> 'get-table-state'
- * @JobQuery()
- * export class GetTableStateQuery { ... }
- * ```
- */
-export declare function JobQuery(options?: string | JobQueryOptions): ClassDecorator;
-/**
- * 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;
-/**
- * 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;
-/**
- * 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