atomic-queues 1.6.2 → 2.0.0

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

@@ -1,348 +0,0 @@
-"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 QueueManagerService_1;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueueManagerService = void 0;
-const common_1 = require("@nestjs/common");
-const bullmq_1 = require("bullmq");
-const ioredis_1 = __importDefault(require("ioredis"));
-const constants_1 = require("../constants");
-/**
- * QueueManagerService
- *
- * Manages dynamic queue creation and destruction per entity.
- * This is the core service for creating queues on-demand for users, tables,
- * or any other entity type that requires atomic processing.
- *
- * Key Features:
- * - Dynamic queue creation with lazy initialization
- * - Entity-specific queue naming conventions
- * - Automatic cleanup on module destroy
- * - Job management (add, delete)
- * - Queue lifecycle management
- *
- * @example
- * ```typescript
- * // Get or create a queue for a user
- * const queue = queueManager.getOrCreateEntityQueue('user', '123');
- *
- * // Add a job to the queue
- * await queueManager.addJob('user-123-queue', 'process-message', { text: 'hello' });
- * ```
- */
-let QueueManagerService = QueueManagerService_1 = class QueueManagerService {
-    constructor(redis, config) {
-        this.redis = redis;
-        this.config = config;
-        this.logger = new common_1.Logger(QueueManagerService_1.name);
-        this.queues = new Map();
-        this.queueEvents = new Map();
-        // Optional reference to QueueEventsManager for auto-listening
-        this.queueEventsManager = null;
-        this.keyPrefix = config.keyPrefix || 'aq';
-    }
-    /**
-     * Set the QueueEventsManager reference.
-     * Called by ProcessorDiscoveryService after initialization.
-     */
-    setQueueEventsManager(manager) {
-        this.queueEventsManager = manager;
-    }
-    /**
-     * Get or create a queue by name.
-     * If the queue doesn't exist, it will be created with default configuration.
-     */
-    getOrCreateQueue(queueName) {
-        const normalizedName = this.normalizeQueueName(queueName);
-        if (this.queues.has(normalizedName)) {
-            return this.queues.get(normalizedName).queue;
-        }
-        this.logger.debug(`Creating new queue: ${normalizedName}`);
-        const queue = this.createQueue(normalizedName);
-        const managedQueue = {
-            name: normalizedName,
-            queue,
-            createdAt: new Date(),
-            entityId: '',
-            entityType: 'generic',
-        };
-        this.queues.set(normalizedName, managedQueue);
-        return queue;
-    }
-    /**
-     * Get or create an entity-specific queue.
-     * Uses naming convention: {entityType}-{entityId}-queue
-     */
-    getOrCreateEntityQueue(entityType, entityId) {
-        const queueName = this.getEntityQueueName(entityType, entityId);
-        if (this.queues.has(queueName)) {
-            return this.queues.get(queueName).queue;
-        }
-        this.logger.debug(`Creating entity queue: ${queueName}`);
-        const queue = this.createQueue(queueName);
-        const managedQueue = {
-            name: queueName,
-            queue,
-            createdAt: new Date(),
-            entityId,
-            entityType,
-        };
-        this.queues.set(queueName, managedQueue);
-        return queue;
-    }
-    /**
-     * Close and remove a specific queue.
-     * This will gracefully close the queue and clean up resources.
-     */
-    async closeQueue(queueName) {
-        const normalizedName = this.normalizeQueueName(queueName);
-        const managedQueue = this.queues.get(normalizedName);
-        if (!managedQueue) {
-            this.logger.warn(`Queue ${normalizedName} not found for closing.`);
-            return;
-        }
-        this.logger.debug(`Closing queue: ${normalizedName}`);
-        try {
-            await managedQueue.queue.close();
-            this.queues.delete(normalizedName);
-            this.logger.debug(`Closed queue: ${normalizedName}`);
-        }
-        catch (error) {
-            this.logger.error(`Error closing queue ${normalizedName}:`, error);
-            throw error;
-        }
-    }
-    /**
-     * Close all managed queues.
-     * Called automatically on module destroy.
-     */
-    async closeAllQueues() {
-        this.logger.debug('Closing all queues...');
-        const closePromises = Array.from(this.queues.entries()).map(async ([queueName, managedQueue]) => {
-            try {
-                await managedQueue.queue.close();
-                this.logger.debug(`Closed queue: ${queueName}`);
-            }
-            catch (error) {
-                this.logger.error(`Error closing queue ${queueName}:`, error);
-            }
-        });
-        await Promise.all(closePromises);
-        this.queues.clear();
-        this.logger.debug('All queues closed.');
-    }
-    /**
-     * Get all managed queue names.
-     */
-    getQueueNames() {
-        return Array.from(this.queues.keys());
-    }
-    /**
-     * Get all queues for a specific entity type.
-     */
-    getEntityTypeQueues(entityType) {
-        return Array.from(this.queues.values()).filter((q) => q.entityType === entityType);
-    }
-    /**
-     * Delete a specific job from a queue.
-     */
-    async deleteJob(queueName, jobId) {
-        try {
-            const queue = this.getOrCreateQueue(queueName);
-            const result = await queue.remove(jobId);
-            this.logger.debug(`Deleted job ${jobId} from queue ${queueName}, result: ${result}`);
-        }
-        catch (error) {
-            this.logger.error(`Error deleting job ${jobId} from queue ${queueName}:`, error);
-            throw error;
-        }
-    }
-    /**
-     * Add a job to a queue with optional configuration.
-     * If QueueEventsManager is available and entityType is provided,
-     * ensures we're listening for job events to trigger auto-spawning.
-     */
-    async addJob(queueName, jobName, data, options) {
-        const queue = this.getOrCreateQueue(queueName);
-        const mergedOptions = this.mergeJobOptions(options);
-        // Ensure we're listening for queue events (for auto-spawn functionality)
-        if (this.queueEventsManager && options?.entityType) {
-            await this.queueEventsManager.ensureListening(queueName, options.entityType);
-        }
-        try {
-            const job = await queue.add(jobName, data, mergedOptions);
-            this.logger.debug(`Added job ${job.id} (${jobName}) to queue ${queueName}`);
-            return job;
-        }
-        catch (error) {
-            this.logger.error(`Error adding job to queue ${queueName}:`, error);
-            throw error;
-        }
-    }
-    /**
-     * Obliterate a queue (remove all jobs and the queue itself).
-     * Use with caution - this is destructive.
-     */
-    async obliterateQueue(queueName) {
-        const normalizedName = this.normalizeQueueName(queueName);
-        const managedQueue = this.queues.get(normalizedName);
-        if (!managedQueue) {
-            this.logger.warn(`Queue ${normalizedName} not found for obliteration.`);
-            return;
-        }
-        this.logger.warn(`Obliterating queue: ${normalizedName}`);
-        try {
-            await managedQueue.queue.obliterate({ force: true });
-            this.queues.delete(normalizedName);
-            this.logger.debug(`Obliterated queue: ${normalizedName}`);
-        }
-        catch (error) {
-            this.logger.error(`Error obliterating queue ${normalizedName}:`, error);
-            throw error;
-        }
-    }
-    /**
-     * Get jobs from a queue by state.
-     */
-    async getJobs(queueName, states, start = 0, end = 100) {
-        const queue = this.getOrCreateQueue(queueName);
-        return queue.getJobs(states, start, end);
-    }
-    /**
-     * Get the job count for a queue.
-     */
-    async getJobCounts(queueName) {
-        const queue = this.getOrCreateQueue(queueName);
-        return queue.getJobCounts('waiting', 'active', 'completed', 'failed', 'delayed');
-    }
-    /**
-     * Pause a queue.
-     */
-    async pauseQueue(queueName) {
-        const queue = this.getOrCreateQueue(queueName);
-        await queue.pause();
-        this.logger.debug(`Paused queue: ${queueName}`);
-    }
-    /**
-     * Resume a paused queue.
-     */
-    async resumeQueue(queueName) {
-        const queue = this.getOrCreateQueue(queueName);
-        await queue.resume();
-        this.logger.debug(`Resumed queue: ${queueName}`);
-    }
-    /**
-     * Check if a queue exists.
-     */
-    hasQueue(queueName) {
-        return this.queues.has(this.normalizeQueueName(queueName));
-    }
-    /**
-     * Get managed queue info.
-     */
-    getManagedQueue(queueName) {
-        return this.queues.get(this.normalizeQueueName(queueName));
-    }
-    /**
-     * Get or create QueueEvents for a queue.
-     * Used for waitUntilFinished functionality.
-     */
-    async getQueueEvents(queueName) {
-        const normalizedName = this.normalizeQueueName(queueName);
-        if (this.queueEvents.has(normalizedName)) {
-            return this.queueEvents.get(normalizedName);
-        }
-        const events = new bullmq_1.QueueEvents(normalizedName, {
-            connection: this.redis.duplicate(),
-        });
-        this.queueEvents.set(normalizedName, events);
-        return events;
-    }
-    // =========================================================================
-    // PRIVATE METHODS
-    // =========================================================================
-    /**
-     * Create a new BullMQ Queue instance with configuration.
-     */
-    createQueue(queueName, config) {
-        const defaultConfig = this.config.queueDefaults || {};
-        const mergedConfig = { ...defaultConfig, ...config };
-        return new bullmq_1.Queue(queueName, {
-            connection: this.redis.duplicate(),
-            defaultJobOptions: mergedConfig.defaultJobOptions,
-            ...(mergedConfig.limiter && {
-                limiter: mergedConfig.limiter,
-            }),
-        });
-    }
-    /**
-     * Generate queue name for an entity.
-     */
-    getEntityQueueName(entityType, entityId) {
-        return `${this.keyPrefix}:${entityType}:${entityId}:queue`;
-    }
-    /**
-     * Normalize queue name to ensure consistency.
-     */
-    normalizeQueueName(queueName) {
-        // If already has prefix or is a full queue name, return as is
-        if (queueName.startsWith(this.keyPrefix) || queueName.includes(':')) {
-            return queueName;
-        }
-        // Otherwise, add suffix if not present
-        return queueName.endsWith('-queue') ? queueName : `${queueName}-queue`;
-    }
-    /**
-     * Merge job options with defaults.
-     */
-    mergeJobOptions(options) {
-        const defaults = {
-            removeOnComplete: true,
-            removeOnFail: false,
-            attempts: Number.MAX_SAFE_INTEGER,
-            backoff: {
-                type: 'fixed',
-                delay: 1000,
-            },
-        };
-        return { ...defaults, ...options };
-    }
-    /**
-     * Cleanup on module destroy.
-     */
-    async onModuleDestroy() {
-        // Close all QueueEvents
-        for (const [name, events] of this.queueEvents) {
-            try {
-                await events.close();
-            }
-            catch (error) {
-                this.logger.error(`Error closing QueueEvents ${name}:`, error);
-            }
-        }
-        this.queueEvents.clear();
-        await this.closeAllQueues();
-    }
-};
-exports.QueueManagerService = QueueManagerService;
-exports.QueueManagerService = QueueManagerService = QueueManagerService_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])
-], QueueManagerService);
-//# sourceMappingURL=queue-manager.service.js.map

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

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

package/dist/services/resource-lock/index.d.ts

@@ -1,2 +0,0 @@
-export * from './resource-lock.service';
-//# sourceMappingURL=index.d.ts.map

package/dist/services/resource-lock/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/resource-lock/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/services/resource-lock/index.js

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./resource-lock.service"), exports);
-//# sourceMappingURL=index.js.map

package/dist/services/resource-lock/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/resource-lock/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC"}

package/dist/services/resource-lock/resource-lock.service.d.ts

@@ -1,120 +0,0 @@
-import Redis from 'ioredis';
-import { IResourceLockService, IResourceLock, ILockResult, IAtomicQueuesModuleConfig } from '../../domain';
-/**
- * ResourceLockService
- *
- * Provides distributed resource locking using Redis.
- * Implements patterns from both Whatsapi (context locking) and bl-blackjack-service.
- *
- * Key Features:
- * - Atomic lock acquisition using Lua scripts
- * - TTL-based lock expiration
- * - Lock ownership verification
- * - Pool-based resource allocation (get first available from pool)
- * - Lock extension for long-running operations
- *
- * Use Cases:
- * - Whatsapi: Lock WhatsApp contexts for message sending
- * - Blackjack: Lock table resources for game operations
- * - General: Any resource that needs exclusive access
- *
- * @example
- * ```typescript
- * // Acquire a lock on a context
- * const result = await lockService.acquireLock(
- *   'context',
- *   'context-123',
- *   'user-456',
- *   'user',
- *   60, // 60 second TTL
- * );
- *
- * if (result.acquired) {
- *   // Do work with the context
- *   await lockService.releaseLock('context', 'context-123');
- * }
- *
- * // Get first available context from a pool
- * const available = await lockService.getAvailableResource(
- *   'context',
- *   ['ctx-1', 'ctx-2', 'ctx-3'],
- *   'user-456',
- *   'user',
- * );
- * ```
- */
-export declare class ResourceLockService implements IResourceLockService {
-    private readonly redis;
-    private readonly config;
-    private readonly logger;
-    private readonly keyPrefix;
-    private readonly ACQUIRE_LOCK_SCRIPT;
-    private readonly RELEASE_LOCK_SCRIPT;
-    private readonly EXTEND_LOCK_SCRIPT;
-    constructor(redis: Redis, config: IAtomicQueuesModuleConfig);
-    /**
-     * Acquire a lock on a resource.
-     *
-     * Uses Lua script for atomic check-and-set operation.
-     * The lock includes ownership information for later verification.
-     */
-    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>;
-    /**
-     * Release a lock with ownership verification.
-     * Only releases if the current owner matches the expected owner.
-     */
-    releaseOwnedLock(resourceType: string, resourceId: string, ownerId: 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 an available (unlocked) resource from a pool of candidates.
-     * Shuffles the pool for fair distribution.
-     * Atomically locks and returns the first available resource.
-     *
-     * This is the pattern used by Whatsapi to find an available WhatsApp context.
-     */
-    getAvailableResource(resourceType: string, candidateIds: string[], ownerId: string, ownerType: string, ttlSeconds?: number): Promise<ILockResult>;
-    /**
-     * Extend the TTL of an existing lock.
-     */
-    extendLock(resourceType: string, resourceId: string, ttlSeconds: number): Promise<boolean>;
-    /**
-     * Get all locks for a resource type.
-     */
-    getResourceTypeLocks(resourceType: string): Promise<{
-        locked: IResourceLock[];
-        free: string[];
-    }>;
-    /**
-     * Cross-verify that a lock is still held by the expected owner.
-     * Useful for operations that need to verify lock ownership mid-operation.
-     */
-    verifyLockOwnership(resourceType: string, resourceId: string, ownerId: string): Promise<boolean>;
-    /**
-     * Clear all locks for an owner (useful for cleanup).
-     */
-    clearOwnerLocks(ownerType: string, ownerId: string): Promise<number>;
-    /**
-     * Get the Redis key for a lock.
-     */
-    private getLockKey;
-    /**
-     * Fisher-Yates shuffle algorithm.
-     */
-    private shuffleArray;
-}
-//# sourceMappingURL=resource-lock.service.d.ts.map

package/dist/services/resource-lock/resource-lock.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resource-lock.service.d.ts","sourceRoot":"","sources":["../../../src/services/resource-lock/resource-lock.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,SAAS,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,WAAW,EACX,yBAAyB,EAC1B,MAAM,cAAc,CAAC;AAItB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBACa,mBAAoB,YAAW,oBAAoB;IAwD/B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAEnD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAzDzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAGnC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAalC;IAGF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAiBlC;IAGF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAYjC;gBAG8C,KAAK,EAAE,KAAK,EAEzC,MAAM,EAAE,yBAAyB;IAKpD;;;;;OAKG;IACG,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,SAAK,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC;IAiDvB;;OAEG;IACG,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC;IAgBnB;;;OAGG;IACG,gBAAgB,CACpB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC;IA+BnB;;OAEG;IACG,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM1E;;OAEG;IACG,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAkBhC;;OAEG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,EAAE,CAAC;IAyB3B;;;;;;OAMG;IACG,oBAAoB,CACxB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,SAAK,GACd,OAAO,CAAC,WAAW,CAAC;IA8BvB;;OAEG;IACG,UAAU,CACd,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC;IA2BnB;;OAEG;IACG,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QACxD,MAAM,EAAE,aAAa,EAAE,CAAC;QACxB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IAyBF;;;OAGG;IACG,mBAAmB,CACvB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC;IAKnB;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsB1E;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,YAAY;CAOrB"}