atomic-queues 1.4.1 → 1.6.0

package/dist/domain/interfaces/lock.interfaces.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Lock state for a resource
+ */
+export interface IResourceLock {
+    resourceId: string;
+    resourceType: string;
+    ownerId: string;
+    ownerType: string;
+    acquiredAt: Date;
+    expiresAt: Date;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Lock acquisition result
+ */
+export interface ILockResult {
+    acquired: boolean;
+    lock?: IResourceLock;
+    reason?: string;
+}
+/**
+ * Resource lock service interface for distributed locking
+ */
+export interface IResourceLockService {
+    /**
+     * Acquire a lock on a resource
+     */
+    acquireLock(resourceType: string, resourceId: string, ownerId: string, ownerType: string, ttlSeconds?: number, metadata?: Record<string, unknown>): Promise<ILockResult>;
+    /**
+     * Release a lock on a resource
+     */
+    releaseLock(resourceType: string, resourceId: string): Promise<boolean>;
+    /**
+     * Check if a resource is locked
+     */
+    isLocked(resourceType: string, resourceId: string): Promise<boolean>;
+    /**
+     * Get lock info for a resource
+     */
+    getLockInfo(resourceType: string, resourceId: string): Promise<IResourceLock | null>;
+    /**
+     * Get all locked resources of a type for an owner
+     */
+    getOwnerLocks(ownerType: string, ownerId: string): Promise<IResourceLock[]>;
+    /**
+     * Get available (unlocked) resource from a pool
+     */
+    getAvailableResource(resourceType: string, candidateIds: string[], ownerId: string, ownerType: string, ttlSeconds?: number): Promise<ILockResult>;
+    /**
+     * Extend lock TTL
+     */
+    extendLock(resourceType: string, resourceId: string, ttlSeconds: number): Promise<boolean>;
+}
+//# sourceMappingURL=lock.interfaces.d.ts.map

package/dist/domain/interfaces/lock.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.interfaces.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/lock.interfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,WAAW,CACT,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExE;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErE;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAErF;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAE5E;;OAEG;IACH,oBAAoB,CAClB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB;;OAEG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5F"}

package/dist/domain/interfaces/lock.interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lock.interfaces.js.map

package/dist/domain/interfaces/lock.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.interfaces.js","sourceRoot":"","sources":["../../../src/domain/interfaces/lock.interfaces.ts"],"names":[],"mappings":""}

package/dist/domain/interfaces/process.interfaces.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Atomic process status
+ */
+export type AtomicProcessStatus = 'pending' | 'processing' | 'completed' | 'failed';
+/**
+ * Atomic process state
+ */
+export interface IAtomicProcessState {
+    uuid: string;
+    status: AtomicProcessStatus;
+    entityId: string;
+    entityType: string;
+    commandName?: string;
+    createdAt: Date;
+    updatedAt: Date;
+    result?: unknown;
+    error?: string;
+}
+/**
+ * Atomic process status tracker interface
+ */
+export interface IAtomicProcessTracker {
+    /**
+     * Set process status
+     */
+    setStatus(uuid: string, status: AtomicProcessStatus): Promise<void>;
+    /**
+     * Get process status
+     */
+    getStatus(uuid: string): Promise<IAtomicProcessState | null>;
+    /**
+     * Set process result
+     */
+    setResult(uuid: string, result: unknown): Promise<void>;
+    /**
+     * Set process error
+     */
+    setError(uuid: string, error: string): Promise<void>;
+    /**
+     * Clean up old process states
+     */
+    cleanup(maxAgeMs?: number): Promise<number>;
+}
+//# sourceMappingURL=process.interfaces.d.ts.map

package/dist/domain/interfaces/process.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.interfaces.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/process.interfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IAE7D;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C"}

package/dist/domain/interfaces/process.interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=process.interfaces.js.map

package/dist/domain/interfaces/process.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.interfaces.js","sourceRoot":"","sources":["../../../src/domain/interfaces/process.interfaces.ts"],"names":[],"mappings":""}

package/dist/domain/interfaces/queue.interfaces.d.ts

@@ -0,0 +1,46 @@
+import { Queue, Job } from 'bullmq';
+import { IJobOptions } from './config.interfaces';
+/**
+ * Represents a managed queue instance
+ */
+export interface IManagedQueue {
+    name: string;
+    queue: Queue;
+    createdAt: Date;
+    entityId: string;
+    entityType: string;
+}
+/**
+ * Queue manager service interface for dynamic queue creation/destruction
+ */
+export interface IQueueManager {
+    /**
+     * Get or create a queue for the given name
+     */
+    getOrCreateQueue(queueName: string): Queue;
+    /**
+     * Get or create an entity-specific queue
+     */
+    getOrCreateEntityQueue(entityType: string, entityId: string): Queue;
+    /**
+     * Close and remove a specific queue
+     */
+    closeQueue(queueName: string): Promise<void>;
+    /**
+     * Close all managed queues
+     */
+    closeAllQueues(): Promise<void>;
+    /**
+     * Get all queue names
+     */
+    getQueueNames(): string[];
+    /**
+     * Delete a specific job from a queue
+     */
+    deleteJob(queueName: string, jobId: string): Promise<void>;
+    /**
+     * Add a job to a queue
+     */
+    addJob<T>(queueName: string, jobName: string, data: T, options?: IJobOptions): Promise<Job<T>>;
+}
+//# sourceMappingURL=queue.interfaces.d.ts.map

package/dist/domain/interfaces/queue.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.interfaces.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/queue.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC;IAE3C;;OAEG;IACH,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;IAEpE;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;OAEG;IACH,MAAM,CAAC,CAAC,EACN,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;CACpB"}

package/dist/domain/interfaces/queue.interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=queue.interfaces.js.map

package/dist/domain/interfaces/queue.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.interfaces.js","sourceRoot":"","sources":["../../../src/domain/interfaces/queue.interfaces.ts"],"names":[],"mappings":""}

package/dist/domain/interfaces/scaling.interfaces.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Worker scaling decision
+ */
+export interface IScalingDecision {
+    entityId: string;
+    entityType: string;
+    currentWorkers: number;
+    desiredWorkers: number;
+    action: 'spawn' | 'terminate' | 'none';
+    count: number;
+}
+/**
+ * Entity scaling configuration
+ */
+export interface IEntityScalingConfig {
+    entityType: string;
+    /** Function to get desired worker count for an entity */
+    getDesiredWorkerCount: (entityId: string) => Promise<number>;
+    /** Function to get all active entity IDs */
+    getActiveEntityIds: () => Promise<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;
+    /** Function called when spawning a worker */
+    onSpawnWorker?: (entityId: string) => Promise<void>;
+    /** Function called when terminating a worker */
+    onTerminateWorker?: (entityId: string, workerId: string) => Promise<void>;
+}
+/**
+ * Cron manager interface for worker lifecycle management
+ */
+export interface ICronManager {
+    /**
+     * Register an entity type for automatic scaling
+     */
+    registerEntityType(config: IEntityScalingConfig): void;
+    /**
+     * Run scaling cycle for all registered entity types
+     */
+    runScalingCycle(): Promise<IScalingDecision[]>;
+    /**
+     * Get current scaling state
+     */
+    getScalingState(): Promise<Map<string, IScalingDecision[]>>;
+    /**
+     * Start the cron manager
+     */
+    start(intervalMs?: number): void;
+    /**
+     * Stop the cron manager
+     */
+    stop(): void;
+    /**
+     * Check if cron manager is running
+     */
+    isRunning(): boolean;
+}
+//# sourceMappingURL=scaling.interfaces.d.ts.map

package/dist/domain/interfaces/scaling.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaling.interfaces.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/scaling.interfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,qBAAqB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7D,4CAA4C;IAC5C,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,iCAAiC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,6CAA6C;IAC7C,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAEvD;;OAEG;IACH,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAE/C;;OAEG;IACH,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;IAE5D;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC;CACtB"}

package/dist/domain/interfaces/scaling.interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=scaling.interfaces.js.map

package/dist/domain/interfaces/scaling.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaling.interfaces.js","sourceRoot":"","sources":["../../../src/domain/interfaces/scaling.interfaces.ts"],"names":[],"mappings":""}

package/dist/domain/interfaces/utility.types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Deep partial type utility
+ */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * Constructor type
+ */
+export type Constructor<T = unknown> = new (...args: unknown[]) => T;
+/**
+ * Async factory function type
+ */
+export type AsyncFactory<T> = () => Promise<T> | T;
+//# sourceMappingURL=utility.types.d.ts.map

package/dist/domain/interfaces/utility.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.types.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/utility.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAChE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC"}

package/dist/domain/interfaces/utility.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=utility.types.js.map

package/dist/domain/interfaces/utility.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.types.js","sourceRoot":"","sources":["../../../src/domain/interfaces/utility.types.ts"],"names":[],"mappings":""}

package/dist/domain/interfaces/worker.interfaces.d.ts

@@ -0,0 +1,120 @@
+import { Worker, Job } from 'bullmq';
+import { IWorkerConfig } from './config.interfaces';
+/**
+ * Worker state tracking
+ */
+export interface IWorkerState {
+    workerId: string;
+    workerName: string;
+    nodeId: string;
+    entityId?: string;
+    entityType?: string;
+    status: 'starting' | 'ready' | 'processing' | 'closing' | 'closed';
+    createdAt: Date;
+    lastHeartbeat: Date;
+}
+/**
+ * Worker lifecycle events
+ */
+export interface IWorkerEvents {
+    onReady?: (worker: Worker, workerName: string) => void | Promise<void>;
+    onCompleted?: (job: Job, workerName: string) => void | Promise<void>;
+    onFailed?: (job: Job | undefined, error: Error, workerName: string) => void | Promise<void>;
+    onProgress?: (job: Job, progress: number | object) => void | Promise<void>;
+    onStalled?: (jobId: string, workerName: string) => void | Promise<void>;
+    onClosing?: (workerName: string) => void | Promise<void>;
+    onClosed?: (workerName: string) => void | Promise<void>;
+}
+/**
+ * Worker creation options
+ */
+export interface IWorkerCreationOptions {
+    workerName: string;
+    queueName: string;
+    config?: IWorkerConfig;
+    events?: IWorkerEvents;
+    processor: (job: Job) => Promise<unknown>;
+}
+/**
+ * Worker manager service interface
+ */
+export interface IWorkerManager {
+    /**
+     * Create a new worker with automatic lifecycle management
+     */
+    createWorker(options: IWorkerCreationOptions): Promise<Worker>;
+    /**
+     * Check if a worker exists and is alive (across ALL nodes)
+     */
+    workerExists(workerName: string): Promise<boolean>;
+    /**
+     * Check if a worker exists on THIS node specifically
+     */
+    workerExistsOnThisNode(workerName: string): Promise<boolean>;
+    /**
+     * Get all running workers for current node
+     */
+    getNodeWorkers(): Promise<string[]>;
+    /**
+     * Get all running workers across all nodes
+     */
+    getAllWorkers(): Promise<string[]>;
+    /**
+     * Get all workers for a specific entity
+     */
+    getEntityWorkers(entityType: string, entityId: string): Promise<string[]>;
+    /**
+     * Signal a worker to close gracefully
+     */
+    signalWorkerClose(workerName: string): Promise<void>;
+    /**
+     * Signal all workers on current node to close
+     */
+    signalNodeWorkersClose(): Promise<void>;
+    /**
+     * Wait for all node workers to close
+     */
+    waitForWorkersToClose(timeoutMs?: number): Promise<void>;
+    /**
+     * Reset worker heartbeat TTL
+     */
+    resetWorkerHeartbeat(workerName: string): Promise<void>;
+    /**
+     * Remove worker heartbeat (mark as dead)
+     */
+    removeWorkerHeartbeat(workerName: string): Promise<void>;
+    /**
+     * Get the node ID for this instance
+     */
+    getNodeId(): string;
+    /**
+     * Mark that a worker has completed a job (resets idle counter).
+     * Called internally when job completes.
+     */
+    markWorkerActive(workerName: string): void;
+    /**
+     * Get the idle seconds counter for a worker.
+     * This is incremented by the heartbeat and reset when a job completes.
+     */
+    getWorkerIdleSeconds(workerName: string): Promise<number>;
+    /**
+     * Reset the idle counter for a worker (called when job completes).
+     */
+    resetWorkerIdleCounter(workerName: string): Promise<void>;
+    /**
+     * Increment the idle counter for a worker (called by heartbeat).
+     * Returns the new idle seconds value.
+     */
+    incrementWorkerIdleCounter(workerName: string, incrementBy?: number): Promise<number>;
+    /**
+     * Remove the idle counter for a worker (cleanup).
+     */
+    removeWorkerIdleCounter(workerName: string): Promise<void>;
+    /**
+     * Check if a worker is idle based on threshold.
+     * @param workerName - Worker name
+     * @param thresholdSeconds - Idle threshold in seconds (default: 15)
+     */
+    isWorkerIdle(workerName: string, thresholdSeconds?: number): Promise<boolean>;
+}
+//# sourceMappingURL=worker.interfaces.d.ts.map

package/dist/domain/interfaces/worker.interfaces.d.ts.map

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

package/dist/domain/interfaces/worker.interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=worker.interfaces.js.map

package/dist/domain/interfaces/worker.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.interfaces.js","sourceRoot":"","sources":["../../../src/domain/interfaces/worker.interfaces.ts"],"names":[],"mappings":""}

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;AAGxB,OAAO,EAAE,yBAAyB,EAAe,MAAM,WAAW,CAAC;AAqBnE;;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;AAsBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"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;AA0BnE;;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;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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

@@ -29,10 +29,15 @@ const CORE_SERVICES = [
     services_1.CronManagerService,
     services_1.ServiceQueueManager,
     services_1.ShutdownStateService,
+    services_1.ProcessorRegistry,
+    services_1.DecoratorDiscoveryService,
+    services_1.WorkerFactoryService,
+    services_1.ScalingRegistrationService,
     services_1.ProcessorDiscoveryService,
     services_1.CommandDiscoveryService,
     services_1.QueueBus,
     services_1.QueueEventsManagerService,
+    services_1.SpawnQueueService,
 ];
 /**
  * AtomicQueuesModule

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

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

package/dist/services/cron-manager/cron-manager.service.d.ts

@@ -152,6 +152,11 @@ export declare class CronManagerService implements ICronManager, OnModuleDestroy
      * Workers increment idle counter on heartbeat, reset on job completion.
      */
     private handleWorkerClosure;
+    /**
+     * Shared logic for terminating idle workers.
+     * Used by both handleIdleWorkersForActiveEntity and handleWorkerClosure.
+     */
+    private terminateIdleWorkers;
     /**
      * Check if a queue has any waiting or active jobs.
      * Uses BullMQ's internal key structure with the configured prefix.
@@ -190,9 +195,5 @@ export declare class CronManagerService implements ICronManager, OnModuleDestroy
      * Determine the scaling action based on current vs desired.
      */
     private determineAction;
-    /**
-     * Scan Redis keys matching a pattern.
-     */
-    private scanKeys;
 }
 //# sourceMappingURL=cron-manager.service.d.ts.map

package/dist/services/cron-manager/cron-manager.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cron-manager.service.d.ts","sourceRoot":"","sources":["../../../src/services/cron-manager/cron-manager.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,eAAe,EAAY,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,MAAM,SAAS,CAAC;AAC5B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EAC1B,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAwB,MAAM,kBAAkB,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBACa,kBAAmB,YAAW,YAAY,EAAE,eAAe;IAUvC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAEnD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IACjB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAdnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgD;IAC9E,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,wBAAwB,CAAS;gBAGO,KAAK,EAAE,KAAK,EAEzC,MAAM,EAAE,yBAAyB,EACjC,aAAa,EAAE,oBAAoB,EACnC,YAAY,EAAE,mBAAmB,EACrB,mBAAmB,CAAC,EAAE,mBAAmB,YAAA;IAUxE;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAKtD;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAK9C;;;;;;;;;;;;;;;;;OAiBG;IACG,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAepD;;;OAGG;YACW,uCAAuC;IAYrD;;OAEG;YACW,uBAAuB;IAoBrC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IA8BjE;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IA0BhC;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,eAAe,IAAI,IAAI;IAQvB;;;;;;;OAOG;YACW,6BAA6B;IAqF3C;;OAEG;YACW,oBAAoB;IA+ClC;;OAEG;YACW,mBAAmB;IAuCjC;;;;;OAKG;YACW,gCAAgC;IAoD9C;;;;OAIG;YACW,mBAAmB;IA8DjC;;;;;;;;;;;;OAYG;YACW,iBAAiB;IA8C/B;;OAEG;YACW,kBAAkB;IAqBhC;;OAEG;YACW,sBAAsB;IAapC;;;;OAIG;YACW,oBAAoB;IAYlC;;;;OAIG;YACW,sBAAsB;IAqBpC;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;YACW,QAAQ;CAkBvB"}
+{"version":3,"file":"cron-manager.service.d.ts","sourceRoot":"","sources":["../../../src/services/cron-manager/cron-manager.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,eAAe,EAAY,MAAM,gBAAgB,CAAC;AACvF,OAAO,KAAK,MAAM,SAAS,CAAC;AAC5B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EAC1B,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAwB,MAAM,kBAAkB,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBACa,kBAAmB,YAAW,YAAY,EAAE,eAAe;IAUvC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAEnD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IACjB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAdnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgD;IAC9E,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,wBAAwB,CAAS;gBAGO,KAAK,EAAE,KAAK,EAEzC,MAAM,EAAE,yBAAyB,EACjC,aAAa,EAAE,oBAAoB,EACnC,YAAY,EAAE,mBAAmB,EACrB,mBAAmB,CAAC,EAAE,mBAAmB,YAAA;IAUxE;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAKtD;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAK9C;;;;;;;;;;;;;;;;;OAiBG;IACG,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAepD;;;OAGG;YACW,uCAAuC;IAYrD;;OAEG;YACW,uBAAuB;IAoBrC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IA8BjE;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IA0BhC;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,eAAe,IAAI,IAAI;IAQvB;;;;;;;OAOG;YACW,6BAA6B;IAqF3C;;OAEG;YACW,oBAAoB;IA+ClC;;OAEG;YACW,mBAAmB;IAuCjC;;;;;OAKG;YACW,gCAAgC;IAQ9C;;;;OAIG;YACW,mBAAmB;IAQjC;;;OAGG;YACW,oBAAoB;IA0ElC;;;;;;;;;;;;OAYG;YACW,iBAAiB;IA8C/B;;OAEG;YACW,kBAAkB;IAqBhC;;OAEG;YACW,sBAAsB;IAapC;;;;OAIG;YACW,oBAAoB;IAYlC;;;;OAIG;YACW,sBAAsB;IAqBpC;;OAEG;IACH,OAAO,CAAC,eAAe;CASxB"}

package/dist/services/cron-manager/cron-manager.service.js

@@ -19,6 +19,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CronManagerService = void 0;
 const common_1 = require("@nestjs/common");
 const ioredis_1 = __importDefault(require("ioredis"));
+const utils_1 = require("../../utils");
 const constants_1 = require("../constants");
 const worker_manager_1 = require("../worker-manager");
 const index_manager_1 = require("../index-manager");
@@ -78,7 +79,7 @@ let CronManagerService = CronManagerService_1 = class CronManagerService {
         this.cronInterval = null;
         this.running = false;
         this.scalingHandlerRegistered = false;
-        this.keyPrefix = config.keyPrefix || 'aq';
+        this.keyPrefix = (0, utils_1.resolveKeyPrefix)(config);
         // Use service queue for atomic operations if enabled
         this.useServiceQueue = config.serviceQueue?.enabled !== false;
         // Register the scaling cycle handler with the service queue
@@ -381,43 +382,7 @@ let CronManagerService = CronManagerService_1 = class CronManagerService {
      * on the next scaling cycle if the entity is still active.
      */
     async handleIdleWorkersForActiveEntity(entityType, entityId, config) {
-        const workers = await this.workerManager.getEntityWorkers(entityType, entityId);
-        if (workers.length === 0) {
-            return null;
-        }
-        // Get idle timeout threshold (default: 15 seconds)
-        const idleTimeoutSeconds = config.idleTimeoutSeconds ?? 15;
-        // Check each worker's idle time
-        const idleWorkers = [];
-        for (const workerName of workers) {
-            const isIdle = await this.workerManager.isWorkerIdle(workerName, idleTimeoutSeconds);
-            if (isIdle) {
-                idleWorkers.push(workerName);
-            }
-        }
-        if (idleWorkers.length === 0) {
-            return null;
-        }
-        this.logger.log(`[handleIdleWorkers] Terminating ${idleWorkers.length} idle workers for active ${entityType}/${entityId} (idle >= ${idleTimeoutSeconds}s)`);
-        // Signal idle workers to close
-        for (const workerName of idleWorkers) {
-            const idleSeconds = await this.workerManager.getWorkerIdleSeconds(workerName);
-            this.logger.debug(`[handleIdleWorkers] Terminating idle worker: ${workerName} (idle: ${idleSeconds}s)`);
-            if (config.onTerminateWorker) {
-                await config.onTerminateWorker(entityId, workerName);
-            }
-            else {
-                await this.workerManager.signalWorkerClose(workerName);
-            }
-        }
-        return {
-            entityId,
-            entityType,
-            currentWorkers: workers.length,
-            desiredWorkers: workers.length - idleWorkers.length,
-            action: 'terminate',
-            count: idleWorkers.length,
-        };
+        return this.terminateIdleWorkers(entityType, entityId, config, 'active-entity');
     }
     /**
      * Handle worker closure for entities with no jobs.
@@ -425,12 +390,24 @@ let CronManagerService = CronManagerService_1 = class CronManagerService {
      * Workers increment idle counter on heartbeat, reset on job completion.
      */
     async handleWorkerClosure(entityType, entityId, config) {
+        return this.terminateIdleWorkers(entityType, entityId, config, 'orphaned-entity');
+    }
+    /**
+     * Shared logic for terminating idle workers.
+     * Used by both handleIdleWorkersForActiveEntity and handleWorkerClosure.
+     */
+    async terminateIdleWorkers(entityType, entityId, config, context) {
+        const logTag = context === 'active-entity' ? 'handleIdleWorkers' : 'handleWorkerClosure';
         const workers = await this.workerManager.getEntityWorkers(entityType, entityId);
         if (workers.length === 0) {
-            this.logger.debug(`[handleWorkerClosure] ${entityType}/${entityId} - No workers found, skipping`);
+            if (context === 'orphaned-entity') {
+                this.logger.debug(`[${logTag}] ${entityType}/${entityId} - No workers found, skipping`);
+            }
             return null;
         }
-        this.logger.debug(`[handleWorkerClosure] ${entityType}/${entityId} - Found ${workers.length} workers to potentially close: ${workers.join(', ')}`);
+        if (context === 'orphaned-entity') {
+            this.logger.debug(`[${logTag}] ${entityType}/${entityId} - Found ${workers.length} workers to potentially close: ${workers.join(', ')}`);
+        }
         // Get idle timeout threshold (default: 15 seconds)
         const idleTimeoutSeconds = config.idleTimeoutSeconds ?? 15;
         // Check each worker's idle time
@@ -442,14 +419,19 @@ let CronManagerService = CronManagerService_1 = class CronManagerService {
             }
         }
         if (idleWorkers.length === 0) {
-            this.logger.debug(`[handleWorkerClosure] ${entityType}/${entityId} - No idle workers (threshold: ${idleTimeoutSeconds}s), skipping termination`);
+            if (context === 'orphaned-entity') {
+                this.logger.debug(`[${logTag}] ${entityType}/${entityId} - No idle workers (threshold: ${idleTimeoutSeconds}s), skipping termination`);
+            }
             return null;
         }
-        this.logger.log(`[handleWorkerClosure] Closing ${idleWorkers.length} idle workers for ${entityType}/${entityId} (idle >= ${idleTimeoutSeconds}s)`);
+        const actionLabel = context === 'active-entity'
+            ? `Terminating ${idleWorkers.length} idle workers for active ${entityType}/${entityId}`
+            : `Closing ${idleWorkers.length} idle workers for ${entityType}/${entityId}`;
+        this.logger.log(`[${logTag}] ${actionLabel} (idle >= ${idleTimeoutSeconds}s)`);
         // Signal idle workers to close
         for (const workerName of idleWorkers) {
             const idleSeconds = await this.workerManager.getWorkerIdleSeconds(workerName);
-            this.logger.debug(`[handleWorkerClosure] Terminating worker: ${workerName} (idle: ${idleSeconds}s)`);
+            this.logger.debug(`[${logTag}] Terminating worker: ${workerName} (idle: ${idleSeconds}s)`);
             if (config.onTerminateWorker) {
                 await config.onTerminateWorker(entityId, workerName);
             }
@@ -562,7 +544,7 @@ let CronManagerService = CronManagerService_1 = class CronManagerService {
     async getEntitiesWithWorkers(entityType) {
         // Worker heartbeat keys follow pattern: {prefix}:worker:{nodeId}:{entityId}-worker
         const pattern = `${this.keyPrefix}:worker:*:*-worker`;
-        const keys = await this.scanKeys(pattern);
+        const keys = await (0, utils_1.scanKeys)(this.redis, pattern);
         const entities = new Set();
         for (const key of keys) {
             const parts = key.split(':');
@@ -587,19 +569,6 @@ let CronManagerService = CronManagerService_1 = class CronManagerService {
             return 'terminate';
         return 'none';
     }
-    /**
-     * Scan Redis keys matching a pattern.
-     */
-    async scanKeys(pattern) {
-        let cursor = '0';
-        const keys = [];
-        do {
-            const [nextCursor, scanKeys] = await this.redis.scan(cursor, 'MATCH', pattern, 'COUNT', 100);
-            cursor = nextCursor;
-            keys.push(...scanKeys);
-        } while (cursor !== '0');
-        return keys;
-    }
 };
 exports.CronManagerService = CronManagerService;
 exports.CronManagerService = CronManagerService = CronManagerService_1 = __decorate([