atomic-queues 1.0.13

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

@@ -0,0 +1,379 @@
+"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 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 = config.keyPrefix || 'aq';
+    }
+    /**
+     * 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 this.scanKeys(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 this.scanKeys(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}`;
+    }
+    /**
+     * Scan Redis keys matching a pattern.
+     */
+    async scanKeys(pattern) {
+        let cursor = '0';
+        const keys = [];
+        do {
+            const [nextCursor, scanKeys] = await this.redis.scan(cursor, 'MATCH', pattern, 'COUNT', 100);
+            cursor = nextCursor;
+            keys.push(...scanKeys);
+        } while (cursor !== '0');
+        return keys;
+    }
+    /**
+     * 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

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

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

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

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

package/dist/services/service-queue/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("./service-queue.service"), exports);
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,232 @@
+import { OnModuleInit, OnApplicationShutdown } from '@nestjs/common';
+import Redis from 'ioredis';
+import { IAtomicQueuesModuleConfig } from '../../domain';
+/**
+ * Service-level job names for global atomic operations.
+ * These operations MUST be processed by exactly ONE worker across the entire distributed system.
+ */
+export declare enum ServiceQueueJobNames {
+    /** Get the count of all workers across all nodes */
+    GET_GLOBAL_WORKER_COUNT = "get-global-worker-count",
+    /** Get workers for a specific entity across all nodes */
+    GET_ENTITY_WORKERS = "get-entity-workers",
+    /** Verify ownership of a resource */
+    VERIFY_OWNERSHIP = "verify-ownership",
+    /** Acquire global lock */
+    ACQUIRE_GLOBAL_LOCK = "acquire-global-lock",
+    /** Release global lock */
+    RELEASE_GLOBAL_LOCK = "release-global-lock",
+    /** Run scaling cycle for CronManager - triggers worker spawn/terminate decisions */
+    RUN_SCALING_CYCLE = "run-scaling-cycle",
+    /** Spawn a worker for a specific entity - used when opening a table/entity */
+    SPAWN_ENTITY_WORKER = "spawn-entity-worker",
+    /** Custom service operation */
+    CUSTOM = "custom"
+}
+/**
+ * Job data for service queue operations
+ */
+export interface IServiceQueueJobData<T = unknown> {
+    uuid: string;
+    jobName: ServiceQueueJobNames;
+    payload: T;
+    responseChannel?: string;
+}
+/**
+ * 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;
+    /**
+     * Scan Redis keys matching a pattern.
+     */
+    private scanKeys;
+}
+//# sourceMappingURL=service-queue.service.d.ts.map

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

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