atomic-queues 1.0.13

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

@@ -0,0 +1,460 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var WorkerManagerService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkerManagerService = void 0;
+const common_1 = require("@nestjs/common");
+const bullmq_1 = require("bullmq");
+const ioredis_1 = __importDefault(require("ioredis"));
+const uuid_1 = require("uuid");
+const constants_1 = require("../constants");
+/**
+ * WorkerManagerService
+ *
+ * Manages worker lifecycle with features from both Whatsapi and bl-blackjack-service:
+ *
+ * - Dynamic worker creation per entity (user message queue workers, table workers)
+ * - Heartbeat-based liveness tracking with TTL
+ * - Graceful shutdown via Redis pub/sub
+ * - Node-aware worker tracking (multi-instance support)
+ * - Automatic cleanup on application shutdown
+ *
+ * Architecture Notes:
+ * - Each worker registers itself with a heartbeat TTL
+ * - Workers subscribe to their own shutdown channel
+ * - A cron process monitors worker health and spawns/terminates as needed
+ * - On application shutdown, all node workers are signaled to close gracefully
+ *
+ * @example
+ * ```typescript
+ * const worker = await workerManager.createWorker({
+ *   workerName: `user-${userId}-worker`,
+ *   queueName: `user-${userId}-queue`,
+ *   processor: async (job) => {
+ *     // Process job
+ *   },
+ * });
+ * ```
+ */
+let WorkerManagerService = WorkerManagerService_1 = class WorkerManagerService {
+    constructor(redis, config) {
+        this.redis = redis;
+        this.config = config;
+        this.logger = new common_1.Logger(WorkerManagerService_1.name);
+        this.workers = new Map();
+        this.workerStates = new Map();
+        this.heartbeatIntervals = new Map();
+        this.shutdownSubscriptions = new Map();
+        this.subscriberClient = null;
+        this.nodeId = this.generateNodeId();
+        this.keyPrefix = config.keyPrefix || 'aq';
+        this.logger.log(`WorkerManager initialized with nodeId: ${this.nodeId}`);
+    }
+    /**
+     * Initialize subscriber client for pub/sub communication.
+     */
+    onModuleInit() {
+        this.subscriberClient = this.createSubscriberClient();
+    }
+    /**
+     * Create a new worker with automatic lifecycle management.
+     *
+     * This method:
+     * 1. Creates a BullMQ Worker
+     * 2. Sets up heartbeat TTL tracking
+     * 3. Subscribes to shutdown channel for graceful termination
+     * 4. Registers lifecycle event handlers
+     */
+    async createWorker(options) {
+        const { workerName, queueName, config, events, processor } = options;
+        // Check if worker already exists
+        if (await this.workerExists(workerName)) {
+            this.logger.warn(`Worker ${workerName} already exists, skipping creation`);
+            const existingWorker = this.workers.get(workerName);
+            if (existingWorker)
+                return existingWorker;
+        }
+        this.logger.log(`Creating worker: ${workerName} for queue: ${queueName}`);
+        const workerConfig = this.mergeWorkerConfig(config);
+        // Create the BullMQ worker
+        const worker = new bullmq_1.Worker(queueName, processor, {
+            connection: this.redis.duplicate(),
+            concurrency: workerConfig.concurrency,
+            stalledInterval: workerConfig.stalledInterval,
+            lockDuration: workerConfig.lockDuration,
+            maxStalledCount: workerConfig.maxStalledCount,
+        });
+        // Store worker instance
+        this.workers.set(workerName, worker);
+        // Initialize worker state
+        const state = {
+            workerId: (0, uuid_1.v4)(),
+            workerName,
+            nodeId: this.nodeId,
+            status: 'starting',
+            createdAt: new Date(),
+            lastHeartbeat: new Date(),
+        };
+        this.workerStates.set(workerName, state);
+        // Set up heartbeat
+        this.setupHeartbeat(workerName, workerConfig.heartbeatTTL || 3);
+        // Set up shutdown subscription
+        await this.subscribeToShutdown(workerName, worker);
+        // Register event handlers
+        this.registerWorkerEvents(worker, workerName, events);
+        return worker;
+    }
+    /**
+     * Check if a worker exists and is alive (has valid heartbeat).
+     */
+    async workerExists(workerName) {
+        const key = this.getWorkerKey(workerName);
+        const exists = await this.redis.exists(key);
+        return exists === 1;
+    }
+    /**
+     * Get all running workers for the current node.
+     */
+    async getNodeWorkers() {
+        const pattern = `${this.keyPrefix}:worker:${this.nodeId}:*`;
+        const keys = await this.redis.keys(pattern);
+        return keys.map((key) => key.split(':').pop());
+    }
+    /**
+     * Get all running workers across all nodes.
+     */
+    async getAllWorkers() {
+        const pattern = `${this.keyPrefix}:worker:*:*`;
+        const keys = await this.redis.keys(pattern);
+        return keys.map((key) => key.split(':').pop());
+    }
+    /**
+     * Get all workers for a specific entity.
+     * Uses the worker heartbeat TTL keys as the single source of truth.
+     * Worker names follow the pattern: {entityId}-worker
+     */
+    async getEntityWorkers(entityType, entityId) {
+        // Worker heartbeat keys follow pattern: {prefix}:worker:{nodeId}:{workerName}
+        // Worker names follow pattern: {entityId}-worker
+        const workerName = `${entityId}-worker`;
+        const pattern = `${this.keyPrefix}:worker:*:${workerName}`;
+        const keys = await this.redis.keys(pattern);
+        return keys.map((key) => key.split(':').pop());
+    }
+    /**
+     * Signal a worker to close gracefully via pub/sub.
+     */
+    async signalWorkerClose(workerName) {
+        const channel = this.getWorkerShutdownChannel(workerName);
+        await this.redis.publish(channel, 'shutdown');
+        this.logger.log(`Sent shutdown signal to worker: ${workerName}`);
+    }
+    /**
+     * Signal all workers on current node to close.
+     */
+    async signalNodeWorkersClose() {
+        const workers = await this.getNodeWorkers();
+        this.logger.log(`Signaling ${workers.length} workers to close on node ${this.nodeId}`);
+        await Promise.all(workers.map((workerName) => this.signalWorkerClose(workerName)));
+    }
+    /**
+     * Close all workers managed by this instance.
+     * This is the public API for external callers to gracefully shutdown workers.
+     */
+    async closeAllWorkers(timeoutMs = 30000) {
+        this.logger.warn(`Closing all workers on node ${this.nodeId}`);
+        // Clear all heartbeat intervals
+        for (const [workerName, interval] of this.heartbeatIntervals) {
+            clearInterval(interval);
+            this.heartbeatIntervals.delete(workerName);
+        }
+        // Signal all workers to close
+        await this.signalNodeWorkersClose();
+        // Wait for workers to close
+        try {
+            await this.waitForWorkersToClose(timeoutMs);
+        }
+        catch (error) {
+            this.logger.warn(`Some workers did not close gracefully: ${error}`);
+        }
+    }
+    /**
+     * Wait for all node workers to close with timeout.
+     */
+    async waitForWorkersToClose(timeoutMs = 60000) {
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeoutMs) {
+            const workers = await this.getNodeWorkers();
+            if (workers.length === 0) {
+                this.logger.log(`All workers on node ${this.nodeId} have closed.`);
+                return;
+            }
+            this.logger.debug(`Waiting... ${workers.length} workers remaining.`);
+            await this.sleep(1000);
+        }
+        throw new Error(`Timeout reached while waiting for workers to close on node ${this.nodeId}`);
+    }
+    /**
+     * Reset worker heartbeat TTL.
+     */
+    async resetWorkerHeartbeat(workerName, ttlSeconds) {
+        const ttl = ttlSeconds || this.config.workerDefaults?.heartbeatTTL || 3;
+        const key = this.getWorkerKey(workerName);
+        const exists = await this.redis.exists(key);
+        if (exists) {
+            await this.redis.expire(key, ttl);
+        }
+        else {
+            await this.redis.set(key, '1', 'EX', ttl);
+        }
+        // Update local state
+        const state = this.workerStates.get(workerName);
+        if (state) {
+            state.lastHeartbeat = new Date();
+        }
+    }
+    /**
+     * Remove worker heartbeat (mark as dead).
+     */
+    async removeWorkerHeartbeat(workerName) {
+        const key = this.getWorkerKey(workerName);
+        await this.redis.del(key);
+        this.logger.debug(`Removed heartbeat for worker: ${workerName}`);
+    }
+    /**
+     * Get the node ID for this instance.
+     */
+    getNodeId() {
+        return this.nodeId;
+    }
+    /**
+     * Index a worker for an entity (for entity-based tracking).
+     */
+    async indexEntityWorker(entityType, entityId, workerId, ttlSeconds = 3) {
+        const key = `${this.keyPrefix}:entity-worker:${entityType}:${entityId}:${workerId}`;
+        await this.redis.set(key, '1', 'EX', ttlSeconds);
+    }
+    /**
+     * Remove entity worker index.
+     */
+    async removeEntityWorkerIndex(entityType, entityId, workerId) {
+        const key = `${this.keyPrefix}:entity-worker:${entityType}:${entityId}:${workerId}`;
+        await this.redis.del(key);
+    }
+    /**
+     * Get subscriber client for pub/sub operations.
+     */
+    getSubscriberClient() {
+        if (!this.subscriberClient) {
+            this.subscriberClient = this.createSubscriberClient();
+        }
+        return this.subscriberClient;
+    }
+    /**
+     * Graceful shutdown on application termination.
+     */
+    async onApplicationShutdown() {
+        this.logger.warn(`Application shutting down, closing workers on node ${this.nodeId}`);
+        // Clear all heartbeat intervals
+        for (const [workerName, interval] of this.heartbeatIntervals) {
+            clearInterval(interval);
+            this.heartbeatIntervals.delete(workerName);
+        }
+        // Signal all workers to close
+        await this.signalNodeWorkersClose();
+        // Wait for workers to close
+        try {
+            await this.waitForWorkersToClose(30000);
+        }
+        catch (error) {
+            this.logger.warn(`Some workers did not close gracefully: ${error}`);
+        }
+        // Close subscriber client
+        if (this.subscriberClient) {
+            await this.subscriberClient.quit();
+        }
+    }
+    // =========================================================================
+    // PRIVATE METHODS
+    // =========================================================================
+    /**
+     * Generate a unique node ID for this instance.
+     */
+    generateNodeId() {
+        return (0, uuid_1.v4)();
+    }
+    /**
+     * Create a subscriber client for pub/sub.
+     */
+    createSubscriberClient() {
+        return this.redis.duplicate();
+    }
+    /**
+     * Get the Redis key for a worker's heartbeat.
+     */
+    getWorkerKey(workerName) {
+        return `${this.keyPrefix}:worker:${this.nodeId}:${workerName}`;
+    }
+    /**
+     * Get the shutdown channel for a worker.
+     */
+    getWorkerShutdownChannel(workerName) {
+        return `${this.keyPrefix}:worker:${workerName}:shutdown`;
+    }
+    /**
+     * Merge worker config with defaults.
+     */
+    mergeWorkerConfig(config) {
+        const defaults = {
+            concurrency: 1,
+            stalledInterval: 1000,
+            lockDuration: 30000,
+            maxStalledCount: Number.MAX_SAFE_INTEGER,
+            heartbeatTTL: 3,
+            heartbeatInterval: 1000,
+        };
+        return { ...defaults, ...this.config.workerDefaults, ...config };
+    }
+    /**
+     * Set up heartbeat interval for a worker.
+     */
+    setupHeartbeat(workerName, ttlSeconds) {
+        const interval = setInterval(async () => {
+            try {
+                await this.resetWorkerHeartbeat(workerName, ttlSeconds);
+            }
+            catch (error) {
+                this.logger.error(`Failed to reset heartbeat for worker ${workerName}:`, error);
+            }
+        }, (ttlSeconds * 1000) / 2); // Update at half the TTL
+        this.heartbeatIntervals.set(workerName, interval);
+    }
+    /**
+     * Subscribe to shutdown channel for graceful termination.
+     */
+    async subscribeToShutdown(workerName, worker) {
+        const channel = this.getWorkerShutdownChannel(workerName);
+        const subscriber = this.getSubscriberClient();
+        await subscriber.subscribe(channel);
+        this.logger.debug(`Subscribed to shutdown channel: ${channel}`);
+        const messageHandler = async (msgChannel) => {
+            if (msgChannel === channel) {
+                this.logger.log(`Received shutdown signal for worker: ${workerName}`);
+                await this.closeWorker(workerName, worker);
+            }
+        };
+        subscriber.on('message', messageHandler);
+        // Store cleanup function
+        this.shutdownSubscriptions.set(workerName, () => {
+            subscriber.off('message', messageHandler);
+            subscriber.unsubscribe(channel).catch(() => { });
+        });
+    }
+    /**
+     * Close a worker and clean up resources.
+     */
+    async closeWorker(workerName, worker) {
+        // Clear heartbeat interval
+        const interval = this.heartbeatIntervals.get(workerName);
+        if (interval) {
+            clearInterval(interval);
+            this.heartbeatIntervals.delete(workerName);
+        }
+        // Unsubscribe from shutdown channel
+        const cleanup = this.shutdownSubscriptions.get(workerName);
+        if (cleanup) {
+            cleanup();
+            this.shutdownSubscriptions.delete(workerName);
+        }
+        // Remove heartbeat
+        await this.removeWorkerHeartbeat(workerName);
+        // Close worker
+        await worker.close();
+        // Remove from maps
+        this.workers.delete(workerName);
+        this.workerStates.delete(workerName);
+        this.logger.log(`Worker ${workerName} closed and cleaned up.`);
+    }
+    /**
+     * Register event handlers for a worker.
+     */
+    registerWorkerEvents(worker, workerName, events) {
+        worker.on('ready', async () => {
+            const state = this.workerStates.get(workerName);
+            if (state)
+                state.status = 'ready';
+            await this.resetWorkerHeartbeat(workerName);
+            this.logger.log(`Worker ${workerName} is ready.`);
+            if (events?.onReady) {
+                await events.onReady(worker, workerName);
+            }
+        });
+        worker.on('completed', async (job) => {
+            this.logger.debug(`Worker ${workerName} completed job: ${job.id}`);
+            if (events?.onCompleted) {
+                await events.onCompleted(job, workerName);
+            }
+        });
+        worker.on('failed', async (job, error) => {
+            this.logger.error(`Worker ${workerName} failed job ${job?.id}: ${error.message}`);
+            if (events?.onFailed) {
+                await events.onFailed(job, error, workerName);
+            }
+        });
+        worker.on('progress', async (job, progress) => {
+            this.logger.debug(`Worker ${workerName} job ${job.id} progress: ${JSON.stringify(progress)}`);
+            if (events?.onProgress) {
+                await events.onProgress(job, progress);
+            }
+        });
+        worker.on('stalled', async (jobId) => {
+            this.logger.warn(`Worker ${workerName} job ${jobId} stalled`);
+            if (events?.onStalled) {
+                await events.onStalled(jobId, workerName);
+            }
+        });
+        worker.on('closing', () => {
+            const state = this.workerStates.get(workerName);
+            if (state)
+                state.status = 'closing';
+            this.logger.log(`Worker ${workerName} is closing...`);
+            if (events?.onClosing) {
+                events.onClosing(workerName);
+            }
+        });
+        worker.on('closed', async () => {
+            this.logger.log(`Worker ${workerName} closed.`);
+            if (events?.onClosed) {
+                await events.onClosed(workerName);
+            }
+        });
+    }
+    /**
+     * Sleep utility.
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+};
+exports.WorkerManagerService = WorkerManagerService;
+exports.WorkerManagerService = WorkerManagerService = WorkerManagerService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(constants_1.ATOMIC_QUEUES_REDIS)),
+    __param(1, (0, common_1.Inject)(constants_1.ATOMIC_QUEUES_CONFIG)),
+    __metadata("design:paramtypes", [ioredis_1.default, Object])
+], WorkerManagerService);
+//# sourceMappingURL=worker-manager.service.js.map

package/dist/services/worker-manager/worker-manager.service.js.map

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

package/dist/utils/helpers.d.ts

@@ -0,0 +1,124 @@
+import { IAtomicJobData, IJobOptions } from '../domain';
+/**
+ * Create an atomic job data payload.
+ *
+ * @example
+ * ```typescript
+ * const jobData = createAtomicJobData({
+ *   entityType: 'user',
+ *   entityId: '123',
+ *   type: 'command',
+ *   commandName: 'SendMessageCommand',
+ *   payload: { message: 'Hello!' },
+ * });
+ *
+ * await queueManager.addJob('user-123-queue', 'send-message', jobData);
+ * ```
+ */
+export declare function createAtomicJobData<T = unknown>(options: {
+    entityType: string;
+    entityId: string;
+    type: 'command' | 'query' | 'custom';
+    commandName?: string;
+    payload: T;
+    metadata?: Record<string, unknown>;
+}): IAtomicJobData<T>;
+/**
+ * Create default job options with common settings.
+ *
+ * @example
+ * ```typescript
+ * const options = createDefaultJobOptions({
+ *   priority: 0, // Highest priority
+ *   attempts: 5,
+ * });
+ * ```
+ */
+export declare function createDefaultJobOptions(overrides?: Partial<IJobOptions>): IJobOptions;
+/**
+ * Create high-priority job options (for SIGTERM signals, etc.)
+ */
+export declare function createHighPriorityJobOptions(overrides?: Partial<IJobOptions>): IJobOptions;
+/**
+ * Sleep utility for async operations.
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Retry utility with exponential backoff.
+ *
+ * @example
+ * ```typescript
+ * const result = await retry(
+ *   () => someUnreliableOperation(),
+ *   { maxAttempts: 3, baseDelay: 1000 },
+ * );
+ * ```
+ */
+export declare function retry<T>(fn: () => Promise<T>, options: {
+    maxAttempts: number;
+    baseDelay: number;
+    maxDelay?: number;
+    exponential?: boolean;
+    onRetry?: (attempt: number, error: Error) => void;
+}): Promise<T>;
+/**
+ * Generate a queue name for an entity.
+ */
+export declare function getEntityQueueName(entityType: string, entityId: string, prefix?: string): string;
+/**
+ * Generate a worker name for an entity.
+ */
+export declare function getEntityWorkerName(entityType: string, entityId: string, prefix?: string): string;
+/**
+ * Parse a queue name to extract entity info.
+ */
+export declare function parseQueueName(queueName: string): {
+    prefix: string;
+    entityType: string;
+    entityId: string;
+} | null;
+/**
+ * Create a SIGTERM job payload for worker termination.
+ */
+export declare function createSigtermPayload<T = unknown>(entityType: string, entityId: string): IAtomicJobData<T>;
+/**
+ * Check if a job is a SIGTERM signal.
+ */
+export declare function isSigtermJob(data: IAtomicJobData): boolean;
+/**
+ * Batch utility for processing items in chunks.
+ *
+ * @example
+ * ```typescript
+ * await batch(items, 10, async (chunk) => {
+ *   await Promise.all(chunk.map(processItem));
+ * });
+ * ```
+ */
+export declare function batch<T>(items: T[], batchSize: number, processor: (batch: T[]) => Promise<void>): Promise<void>;
+/**
+ * Create a timeout promise that rejects after specified ms.
+ */
+export declare function createTimeout(ms: number, message?: string): Promise<never>;
+/**
+ * Run an operation with a timeout.
+ *
+ * @example
+ * ```typescript
+ * const result = await withTimeout(
+ *   someAsyncOperation(),
+ *   5000,
+ *   'Operation took too long',
+ * );
+ * ```
+ */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, message?: string): Promise<T>;
+/**
+ * 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=helpers.d.ts.map

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

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