atomic-queues 1.6.2 → 2.0.1

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

@@ -1,44 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

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

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

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

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

@@ -1,46 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

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

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

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

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

@@ -1,62 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

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

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

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

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

@@ -1,120 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

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

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

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

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

@@ -1,199 +0,0 @@
-import { OnModuleDestroy } from '@nestjs/common';
-import Redis from 'ioredis';
-import { ICronManager, IEntityScalingConfig, IScalingDecision, IAtomicQueuesModuleConfig } from '../../domain';
-import { WorkerManagerService } from '../worker-manager';
-import { IndexManagerService } from '../index-manager';
-import { ServiceQueueManager } from '../service-queue';
-/**
- * CronManagerService
- *
- * Manages worker lifecycle through periodic scaling cycles.
- * Implements the patterns from both Whatsapi's CronqProcessor and
- * bl-blackjack-service's WorkerManagerProcessor.
- *
- * Key Features:
- * - Automatic worker spawning when jobs are queued
- * - Worker termination when queues are empty
- * - Concurrency limits based on entity configuration
- * - Queue cleanup after all work is done
- * - Excess worker handling
- *
- * Architecture:
- * - Runs on a configurable interval
- * - Each entity type can register its own scaling logic
- * - Supports per-entity concurrency limits
- * - Integrates with WorkerManager for worker lifecycle
- * - Integrates with IndexManager for state tracking
- *
- * @example
- * ```typescript
- * // Register entity scaling configuration
- * cronManager.registerEntityType({
- *   entityType: 'user',
- *   getDesiredWorkerCount: async (userId) => {
- *     const plan = await getUserPlan(userId);
- *     return planConcurrencyMap[plan];
- *   },
- *   getActiveEntityIds: async () => {
- *     return indexManager.getEntitiesWithJobs('user');
- *   },
- *   maxWorkersPerEntity: 5,
- *   onSpawnWorker: async (userId) => {
- *     await commandBus.execute(new CreateUserWorkerCommand(userId));
- *   },
- * });
- *
- * // Start the cron manager
- * cronManager.start(5000); // Run every 5 seconds
- * ```
- */
-export declare class CronManagerService implements ICronManager, OnModuleDestroy {
-    private readonly redis;
-    private readonly config;
-    private readonly workerManager;
-    private readonly indexManager;
-    private readonly serviceQueueManager?;
-    private readonly logger;
-    private readonly entityConfigs;
-    private cronInterval;
-    private running;
-    private readonly keyPrefix;
-    private readonly useServiceQueue;
-    private scalingHandlerRegistered;
-    constructor(redis: Redis, config: IAtomicQueuesModuleConfig, workerManager: WorkerManagerService, indexManager: IndexManagerService, serviceQueueManager?: ServiceQueueManager | undefined);
-    /**
-     * Register the scaling cycle handler with ServiceQueueManager.
-     * This ensures scaling cycles are processed atomically by the service worker.
-     */
-    private registerScalingHandler;
-    /**
-     * Register an entity type for automatic scaling.
-     */
-    registerEntityType(config: IEntityScalingConfig): void;
-    /**
-     * Unregister an entity type.
-     */
-    unregisterEntityType(entityType: string): void;
-    /**
-     * Run a scaling cycle for all registered entity types.
-     *
-     * When service queue is enabled, this triggers scaling cycles through the
-     * service queue to ensure atomic processing by the single service worker.
-     * This prevents race conditions in distributed deployments.
-     *
-     * IMPORTANT: Only the service worker owner node triggers scaling cycles.
-     * Other nodes skip the trigger to prevent duplicate jobs.
-     *
-     * This is the main logic that:
-     * 1. Gets entities with queued jobs
-     * 2. Gets entities with running workers
-     * 3. Calculates scaling decisions
-     * 4. Spawns missing workers
-     * 5. Terminates excess workers
-     * 6. Cleans up empty queues
-     */
-    runScalingCycle(): Promise<IScalingDecision[]>;
-    /**
-     * Trigger scaling cycles through the service queue.
-     * This ensures only the service worker processes scaling decisions.
-     */
-    private triggerScalingCyclesThroughServiceQueue;
-    /**
-     * Run scaling cycles directly (single instance or fallback mode).
-     */
-    private runScalingCycleDirectly;
-    /**
-     * Get current scaling state for all entity types.
-     */
-    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;
-    /**
-     * Cleanup on module destroy.
-     */
-    onModuleDestroy(): void;
-    /**
-     * Run scaling cycle for a specific entity type.
-     * This is the internal implementation called either directly or via service queue.
-     *
-     * Supports two modes:
-     * 1. Scaler mode: getActiveEntityIds returns active entities, workers spawn/terminate based on this
-     * 2. Scalerless mode: getActiveEntityIds returns empty, workers spawn via QueueEvents and terminate when idle
-     */
-    private runEntityScalingCycleInternal;
-    /**
-     * Handle worker spawning for an entity.
-     */
-    private handleEntitySpawning;
-    /**
-     * Handle excess workers for an entity.
-     */
-    private handleExcessWorkers;
-    /**
-     * Handle idle workers for ACTIVE entities.
-     * Even if an entity is active, if workers are idle beyond the threshold,
-     * they should be terminated to save resources. They'll be re-spawned
-     * on the next scaling cycle if the entity is still active.
-     */
-    private handleIdleWorkersForActiveEntity;
-    /**
-     * Handle worker closure for entities with no jobs.
-     * Uses worker self-reported idle time for reliable detection.
-     * 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.
-     *
-     * NOTE: This is kept as a backup/utility method, but idle detection
-     * now primarily uses worker self-reported idle counters.
-     *
-     * BullMQ v4+ key structure:
-     * - {prefix}:{queueName}:wait (list) - jobs waiting to be processed
-     * - {prefix}:{queueName}:active (list) - jobs currently being processed
-     * - {prefix}:{queueName}:delayed (sorted set) - jobs scheduled for future
-     * - {prefix}:{queueName}:paused (list) - jobs in paused queue
-     */
-    private checkQueueHasJobs;
-    /**
-     * Handle queue cleanup for entities with no jobs and no workers.
-     */
-    private handleQueueCleanup;
-    /**
-     * Queue worker termination via the entity's queue.
-     */
-    private queueWorkerTermination;
-    /**
-     * Get the number of workers for an entity.
-     * Uses the worker heartbeat TTL keys as the single source of truth.
-     * This is a direct Redis query - no service queue needed since we're just reading keys.
-     */
-    private getEntityWorkerCount;
-    /**
-     * Get all entities with workers.
-     * Uses the worker heartbeat TTL keys as the single source of truth.
-     * Worker names follow pattern: {entityId}-worker
-     */
-    private getEntitiesWithWorkers;
-    /**
-     * Determine the scaling action based on current vs desired.
-     */
-    private determineAction;
-}
-//# sourceMappingURL=cron-manager.service.d.ts.map

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

@@ -1 +0,0 @@
-{"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"}