atomic-queues 1.0.13

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

@@ -0,0 +1,308 @@
+"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");
+const common_2 = require("@nestjs/common");
+/**
+ * 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.keyPrefix = config.keyPrefix || 'aq';
+    }
+    /**
+     * 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.
+     */
+    async addJob(queueName, jobName, data, options) {
+        const queue = this.getOrCreateQueue(queueName);
+        const mergedOptions = this.mergeJobOptions(options);
+        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));
+    }
+    // =========================================================================
+    // 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() {
+        await this.closeAllQueues();
+    }
+};
+exports.QueueManagerService = QueueManagerService;
+exports.QueueManagerService = QueueManagerService = QueueManagerService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_2.Inject)(constants_1.ATOMIC_QUEUES_REDIS)),
+    __param(1, (0, common_2.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

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

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

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

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

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

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

@@ -0,0 +1,124 @@
+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;
+    /**
+     * Scan Redis keys matching a pattern.
+     */
+    private scanKeys;
+    /**
+     * Fisher-Yates shuffle algorithm.
+     */
+    private shuffleArray;
+}
+//# sourceMappingURL=resource-lock.service.d.ts.map

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

@@ -0,0 +1 @@
+{"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;AAGtB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;YACW,QAAQ;IAmBtB;;OAEG;IACH,OAAO,CAAC,YAAY;CAOrB"}