atomic-queues 1.6.2 → 2.0.1

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

@@ -1,367 +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 ResourceLockService_1;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResourceLockService = void 0;
-const common_1 = require("@nestjs/common");
-const ioredis_1 = __importDefault(require("ioredis"));
-const utils_1 = require("../../utils");
-const constants_1 = require("../constants");
-/**
- * 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',
- * );
- * ```
- */
-let ResourceLockService = ResourceLockService_1 = class ResourceLockService {
-    constructor(redis, config) {
-        this.redis = redis;
-        this.config = config;
-        this.logger = new common_1.Logger(ResourceLockService_1.name);
-        // Lua script for atomic lock acquisition
-        this.ACQUIRE_LOCK_SCRIPT = `
-    local lockKey = KEYS[1]
-    local lockValue = ARGV[1]
-    local ttl = tonumber(ARGV[2])
-    
-    local current = redis.call("GET", lockKey)
-    
-    if not current then
-      redis.call("SET", lockKey, lockValue, "EX", ttl)
-      return 1  -- Lock acquired
-    else
-      return 0  -- Lock already held
-    end
-  `;
-        // Lua script for atomic lock release with ownership check
-        this.RELEASE_LOCK_SCRIPT = `
-    local lockKey = KEYS[1]
-    local expectedOwner = ARGV[1]
-    
-    local current = redis.call("GET", lockKey)
-    
-    if current then
-      local lockData = cjson.decode(current)
-      if lockData.ownerId == expectedOwner then
-        redis.call("DEL", lockKey)
-        return 1  -- Lock released
-      else
-        return 0  -- Not the owner
-      end
-    end
-    
-    return 1  -- Lock didn't exist
-  `;
-        // Lua script for extending lock TTL
-        this.EXTEND_LOCK_SCRIPT = `
-    local lockKey = KEYS[1]
-    local newTtl = tonumber(ARGV[1])
-    
-    local exists = redis.call("EXISTS", lockKey)
-    
-    if exists == 1 then
-      redis.call("EXPIRE", lockKey, newTtl)
-      return 1  -- TTL extended
-    else
-      return 0  -- Lock doesn't exist
-    end
-  `;
-        this.keyPrefix = (0, utils_1.resolveKeyPrefix)(config);
-    }
-    /**
-     * Acquire a lock on a resource.
-     *
-     * Uses Lua script for atomic check-and-set operation.
-     * The lock includes ownership information for later verification.
-     */
-    async acquireLock(resourceType, resourceId, ownerId, ownerType, ttlSeconds = 60, metadata) {
-        const lockKey = this.getLockKey(resourceType, resourceId);
-        const now = new Date();
-        const lockData = {
-            resourceId,
-            resourceType,
-            ownerId,
-            ownerType,
-            acquiredAt: now,
-            expiresAt: new Date(now.getTime() + ttlSeconds * 1000),
-            metadata,
-        };
-        try {
-            const result = await this.redis.eval(this.ACQUIRE_LOCK_SCRIPT, 1, lockKey, JSON.stringify(lockData), ttlSeconds.toString());
-            if (result === 1) {
-                this.logger.debug(`Lock acquired: ${resourceType}/${resourceId} by ${ownerType}/${ownerId}`);
-                return { acquired: true, lock: lockData };
-            }
-            this.logger.debug(`Lock not acquired (already held): ${resourceType}/${resourceId}`);
-            return {
-                acquired: false,
-                reason: 'Resource is already locked',
-            };
-        }
-        catch (error) {
-            this.logger.error(`Error acquiring lock for ${resourceType}/${resourceId}:`, error);
-            return {
-                acquired: false,
-                reason: `Error: ${error.message}`,
-            };
-        }
-    }
-    /**
-     * Release a lock on a resource.
-     */
-    async releaseLock(resourceType, resourceId) {
-        const lockKey = this.getLockKey(resourceType, resourceId);
-        try {
-            await this.redis.del(lockKey);
-            this.logger.debug(`Lock released: ${resourceType}/${resourceId}`);
-            return true;
-        }
-        catch (error) {
-            this.logger.error(`Error releasing lock for ${resourceType}/${resourceId}:`, error);
-            return false;
-        }
-    }
-    /**
-     * Release a lock with ownership verification.
-     * Only releases if the current owner matches the expected owner.
-     */
-    async releaseOwnedLock(resourceType, resourceId, ownerId) {
-        const lockKey = this.getLockKey(resourceType, resourceId);
-        try {
-            const result = await this.redis.eval(this.RELEASE_LOCK_SCRIPT, 1, lockKey, ownerId);
-            const released = result === 1;
-            if (released) {
-                this.logger.debug(`Lock released by owner: ${resourceType}/${resourceId}`);
-            }
-            else {
-                this.logger.warn(`Lock release failed (not owner): ${resourceType}/${resourceId}`);
-            }
-            return released;
-        }
-        catch (error) {
-            this.logger.error(`Error releasing owned lock for ${resourceType}/${resourceId}:`, error);
-            return false;
-        }
-    }
-    /**
-     * Check if a resource is locked.
-     */
-    async isLocked(resourceType, resourceId) {
-        const lockKey = this.getLockKey(resourceType, resourceId);
-        const exists = await this.redis.exists(lockKey);
-        return exists === 1;
-    }
-    /**
-     * Get lock info for a resource.
-     */
-    async getLockInfo(resourceType, resourceId) {
-        const lockKey = this.getLockKey(resourceType, resourceId);
-        const data = await this.redis.get(lockKey);
-        if (!data)
-            return null;
-        try {
-            const lock = JSON.parse(data);
-            // Convert date strings back to Date objects
-            lock.acquiredAt = new Date(lock.acquiredAt);
-            lock.expiresAt = new Date(lock.expiresAt);
-            return lock;
-        }
-        catch (error) {
-            this.logger.error(`Error parsing lock data for ${lockKey}:`, error);
-            return null;
-        }
-    }
-    /**
-     * Get all locked resources of a type for an owner.
-     */
-    async getOwnerLocks(ownerType, ownerId) {
-        // Scan for all locks and filter by owner
-        const pattern = `${this.keyPrefix}:lock:*`;
-        const keys = await (0, utils_1.scanKeys)(this.redis, pattern);
-        const locks = [];
-        for (const key of keys) {
-            const data = await this.redis.get(key);
-            if (data) {
-                try {
-                    const lock = JSON.parse(data);
-                    if (lock.ownerType === ownerType && lock.ownerId === ownerId) {
-                        lock.acquiredAt = new Date(lock.acquiredAt);
-                        lock.expiresAt = new Date(lock.expiresAt);
-                        locks.push(lock);
-                    }
-                }
-                catch {
-                    // Skip invalid entries
-                }
-            }
-        }
-        return locks;
-    }
-    /**
-     * 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.
-     */
-    async getAvailableResource(resourceType, candidateIds, ownerId, ownerType, ttlSeconds = 60) {
-        // Shuffle candidates for fair distribution
-        const shuffled = this.shuffleArray([...candidateIds]);
-        for (const resourceId of shuffled) {
-            const result = await this.acquireLock(resourceType, resourceId, ownerId, ownerType, ttlSeconds);
-            if (result.acquired) {
-                this.logger.debug(`Found available resource: ${resourceType}/${resourceId}`);
-                return result;
-            }
-        }
-        this.logger.debug(`No available resource found in pool for ${ownerType}/${ownerId}`);
-        return {
-            acquired: false,
-            reason: 'No available resources in pool',
-        };
-    }
-    /**
-     * Extend the TTL of an existing lock.
-     */
-    async extendLock(resourceType, resourceId, ttlSeconds) {
-        const lockKey = this.getLockKey(resourceType, resourceId);
-        try {
-            const result = await this.redis.eval(this.EXTEND_LOCK_SCRIPT, 1, lockKey, ttlSeconds.toString());
-            const extended = result === 1;
-            if (extended) {
-                this.logger.debug(`Lock TTL extended: ${resourceType}/${resourceId} to ${ttlSeconds}s`);
-            }
-            return extended;
-        }
-        catch (error) {
-            this.logger.error(`Error extending lock for ${resourceType}/${resourceId}:`, error);
-            return false;
-        }
-    }
-    /**
-     * Get all locks for a resource type.
-     */
-    async getResourceTypeLocks(resourceType) {
-        const pattern = `${this.keyPrefix}:lock:${resourceType}:*`;
-        const keys = await (0, utils_1.scanKeys)(this.redis, pattern);
-        const locked = [];
-        for (const key of keys) {
-            const data = await this.redis.get(key);
-            if (data) {
-                try {
-                    const lock = JSON.parse(data);
-                    lock.acquiredAt = new Date(lock.acquiredAt);
-                    lock.expiresAt = new Date(lock.expiresAt);
-                    locked.push(lock);
-                }
-                catch {
-                    // Skip invalid entries
-                }
-            }
-        }
-        return {
-            locked,
-            free: [], // This would need external resource registry to determine
-        };
-    }
-    /**
-     * Cross-verify that a lock is still held by the expected owner.
-     * Useful for operations that need to verify lock ownership mid-operation.
-     */
-    async verifyLockOwnership(resourceType, resourceId, ownerId) {
-        const lock = await this.getLockInfo(resourceType, resourceId);
-        return lock !== null && lock.ownerId === ownerId;
-    }
-    /**
-     * Clear all locks for an owner (useful for cleanup).
-     */
-    async clearOwnerLocks(ownerType, ownerId) {
-        const locks = await this.getOwnerLocks(ownerType, ownerId);
-        let cleared = 0;
-        for (const lock of locks) {
-            const released = await this.releaseLock(lock.resourceType, lock.resourceId);
-            if (released)
-                cleared++;
-        }
-        this.logger.debug(`Cleared ${cleared} locks for ${ownerType}/${ownerId}`);
-        return cleared;
-    }
-    // =========================================================================
-    // PRIVATE METHODS
-    // =========================================================================
-    /**
-     * Get the Redis key for a lock.
-     */
-    getLockKey(resourceType, resourceId) {
-        return `${this.keyPrefix}:lock:${resourceType}:${resourceId}`;
-    }
-    /**
-     * Fisher-Yates shuffle algorithm.
-     */
-    shuffleArray(array) {
-        for (let i = array.length - 1; i > 0; i--) {
-            const j = Math.floor(Math.random() * (i + 1));
-            [array[i], array[j]] = [array[j], array[i]];
-        }
-        return array;
-    }
-};
-exports.ResourceLockService = ResourceLockService;
-exports.ResourceLockService = ResourceLockService = ResourceLockService_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])
-], ResourceLockService);
-//# sourceMappingURL=resource-lock.service.js.map

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

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

package/dist/services/service-queue/index.d.ts

@@ -1,3 +0,0 @@
-export * from './service-queue.service';
-export * from './service-queue.types';
-//# sourceMappingURL=index.d.ts.map

package/dist/services/service-queue/index.d.ts.map

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

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

@@ -1,19 +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("./service-queue.service"), exports);
-__exportStar(require("./service-queue.types"), exports);
-//# sourceMappingURL=index.js.map

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

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

package/dist/services/service-queue/service-queue.service.d.ts

@@ -1,199 +0,0 @@
-import { OnModuleInit, OnApplicationShutdown } from '@nestjs/common';
-import Redis from 'ioredis';
-import { IAtomicQueuesModuleConfig } from '../../domain';
-import { ServiceQueueJobNames } from './service-queue.types';
-export { ServiceQueueJobNames, IServiceQueueJobData } from './service-queue.types';
-/**
- * ServiceQueueManager
- *
- * Manages the global service-level queue for operations that MUST be atomic
- * across the entire distributed system. Unlike per-entity queues that can have
- * one worker per entity, the service queue has EXACTLY ONE worker globally.
- *
- * Use cases:
- * - Querying global worker counts (can't race with worker creation/deletion)
- * - Ownership verification for resources
- * - Global state mutations
- * - Cross-node coordination
- *
- * Architecture:
- * - Uses a distributed lock to ensure only ONE service worker exists globally
- * - The worker can run on ANY node
- * - If the worker dies, another node will acquire the lock and spawn it
- * - All operations go through the single queue for serialization
- *
- * @example
- * ```typescript
- * // Execute a global atomic operation
- * const workerCount = await serviceQueue.executeServiceOperation(
- *   ServiceQueueJobNames.GET_GLOBAL_WORKER_COUNT,
- *   { entityType: 'table' },
- * );
- * ```
- */
-export declare class ServiceQueueManager implements OnModuleInit, OnApplicationShutdown {
-    private readonly redis;
-    private readonly config;
-    private readonly logger;
-    private readonly keyPrefix;
-    private readonly serviceQueueName;
-    private readonly serviceWorkerName;
-    private readonly lockKey;
-    private readonly lockTTL;
-    private readonly lockRenewalInterval;
-    private serviceQueue;
-    private serviceWorker;
-    private lockRenewalTimer;
-    private subscriberClient;
-    private hasLock;
-    private readonly nodeId;
-    private readonly pendingOperations;
-    private readonly customProcessors;
-    private scalingCycleHandler;
-    constructor(redis: Redis, config: IAtomicQueuesModuleConfig);
-    /**
-     * Initialize on module start.
-     * Attempts to acquire the global service worker lock.
-     */
-    onModuleInit(): Promise<void>;
-    /**
-     * Cleanup on shutdown.
-     */
-    onApplicationShutdown(): Promise<void>;
-    /**
-     * Execute a service-level operation atomically.
-     * This queues the operation to the service queue and waits for the result.
-     *
-     * @param jobName The type of operation to execute
-     * @param payload The operation payload
-     * @param timeoutMs Timeout in milliseconds (default: 30000)
-     * @returns The operation result
-     */
-    executeServiceOperation<T, R>(jobName: ServiceQueueJobNames, payload: T, timeoutMs?: number): Promise<R>;
-    /**
-     * Queue a service operation without waiting for result (fire-and-forget).
-     */
-    queueServiceOperation<T>(jobName: ServiceQueueJobNames, payload: T): Promise<string>;
-    /**
-     * Register a custom processor for service-level operations.
-     * This allows the consuming application to add custom atomic operations.
-     */
-    registerCustomProcessor(name: string, processor: (payload: unknown) => Promise<unknown>): void;
-    /**
-     * Check if this node is the service worker owner.
-     */
-    isServiceWorkerOwner(): boolean;
-    /**
-     * Register the scaling cycle handler (called by CronManager).
-     * This allows CronManager to register its internal scaling logic to be
-     * executed atomically by the service worker.
-     */
-    registerScalingCycleHandler(handler: (entityType: string) => Promise<unknown>): void;
-    /**
-     * Spawn worker handler type - directly spawns a worker for a specific entity.
-     */
-    private spawnWorkerHandler?;
-    /**
-     * Register the spawn worker handler (called by CronManager or TableWorkerScalingService).
-     * This allows directly spawning a worker for a specific entity without waiting
-     * for the next scaling cycle.
-     */
-    registerSpawnWorkerHandler(handler: (entityType: string, entityId: string) => Promise<void>): void;
-    /**
-     * Trigger a scaling cycle for an entity type.
-     * This queues the job to the service queue - only the service worker will execute it.
-     */
-    triggerScalingCycle(entityType: string): Promise<void>;
-    /**
-     * Request spawning a worker for a specific entity.
-     * This is used when an entity (e.g., table) is opened and needs a worker immediately,
-     * without waiting for the next scaling cycle.
-     *
-     * The job is processed by the service worker to ensure atomic operation.
-     *
-     * @param entityType The type of entity (e.g., 'table')
-     * @param entityId The ID of the entity (e.g., tableId)
-     */
-    requestSpawnEntityWorker(entityType: string, entityId: string): Promise<void>;
-    /**
-     * Get the service queue name.
-     */
-    getQueueName(): string;
-    /**
-     * Get the service worker name.
-     */
-    getWorkerName(): string;
-    /**
-     * Get pending job count in the service queue.
-     */
-    getQueueDepth(): Promise<number>;
-    /**
-     * Try to acquire the global service worker lock.
-     */
-    private tryAcquireServiceWorkerLock;
-    /**
-     * Release the service worker lock.
-     */
-    private releaseLock;
-    /**
-     * Start periodic lock renewal.
-     */
-    private startLockRenewal;
-    /**
-     * Start periodic lock acquisition attempts.
-     * Retries more frequently initially, then backs off to lockTTL interval.
-     */
-    private startLockAcquisitionLoop;
-    /**
-     * Start the service worker.
-     */
-    private startServiceWorker;
-    /**
-     * Stop the service worker.
-     */
-    private stopServiceWorker;
-    /**
-     * Process a service queue job.
-     */
-    private processServiceJob;
-    /**
-     * Wait for a response on a channel.
-     */
-    private waitForResponse;
-    /**
-     * Get global worker count across all nodes.
-     */
-    private handleGetGlobalWorkerCount;
-    /**
-     * Get workers for a specific entity.
-     * Uses the worker heartbeat TTL keys as the single source of truth.
-     */
-    private handleGetEntityWorkers;
-    /**
-     * Verify ownership of a resource.
-     */
-    private handleVerifyOwnership;
-    /**
-     * Acquire a global lock atomically.
-     */
-    private handleAcquireGlobalLock;
-    /**
-     * Release a global lock atomically.
-     */
-    private handleReleaseGlobalLock;
-    /**
-     * Handle custom operation by delegating to registered processor.
-     */
-    private handleCustomOperation;
-    /**
-     * Handle scaling cycle request by delegating to registered CronManager handler.
-     */
-    private handleRunScalingCycle;
-    /**
-     * Handle spawn entity worker request.
-     * This directly spawns a worker for the specific entity, bypassing the scaling cycle.
-     * Used when opening a table/entity that needs a worker immediately.
-     */
-    private handleSpawnEntityWorker;
-}
-//# sourceMappingURL=service-queue.service.d.ts.map

package/dist/services/service-queue/service-queue.service.d.ts.map

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