atomic-queues 1.6.2 → 2.0.1

package/dist/services/queue-bus/entity-target.js

@@ -1,109 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EntityTarget = void 0;
-const common_1 = require("@nestjs/common");
-const queue_bus_utils_1 = require("./queue-bus.utils");
-/**
- * EntityTarget - Fluent builder for targeting a specific entity type's queue
- * without needing a @WorkerProcessor class.
- *
- * This is the zero-boilerplate way to enqueue commands when you've configured
- * entity defaults in the module config.
- *
- * @example
- * await queueBus
- *   .forEntity('table')
- *   .enqueue(new MakeBetCommand(tableId, bets, player));
- */
-class EntityTarget {
-    constructor(queueManager, entityType, entityConfig, keyPrefix, queueEventsManager) {
-        this.queueManager = queueManager;
-        this.entityType = entityType;
-        this.entityConfig = entityConfig;
-        this.keyPrefix = keyPrefix;
-        this.queueEventsManager = queueEventsManager;
-        this.logger = new common_1.Logger(EntityTarget.name);
-    }
-    /**
-     * Get the queue name function from entity config or defaults
-     */
-    getQueueNameFn() {
-        if (this.entityConfig?.queueName) {
-            return this.entityConfig.queueName;
-        }
-        // Default: {keyPrefix}-{entityType}-{entityId}-queue
-        return (entityId) => `${this.keyPrefix}-${this.entityType}-${entityId}-queue`;
-    }
-    /**
-     * Extract entity ID using the priority chain (no processor-level default)
-     */
-    extractEntityId(commandOrQuery, data) {
-        return (0, queue_bus_utils_1.extractEntityIdExplicit)(commandOrQuery, data, undefined, // No processor default for forEntity()
-        this.entityConfig, this.logger);
-    }
-    /**
-     * Enqueue a command/query for processing
-     *
-     * @param commandOrQuery - The command or query instance
-     * @param options - Optional settings (entityId override, jobOptions)
-     * @returns The created BullMQ job
-     *
-     * @example
-     * await queueBus
-     *   .forEntity('table')
-     *   .enqueue(new MakeBetCommand(tableId, bets, player));
-     */
-    async enqueue(commandOrQuery, options) {
-        const jobName = (0, queue_bus_utils_1.getJobName)(commandOrQuery);
-        const data = (0, queue_bus_utils_1.extractData)(commandOrQuery);
-        const entityId = options?.entityId ?? this.extractEntityId(commandOrQuery, data);
-        const queueNameFn = this.getQueueNameFn();
-        const queueName = queueNameFn(entityId);
-        this.logger.debug(`[forEntity:${this.entityType}] Adding job ${jobName} to queue ${queueName}`);
-        // Get queue and ensure event listening
-        const queue = this.queueManager.getOrCreateQueue(queueName);
-        if (this.queueEventsManager) {
-            await this.queueEventsManager.ensureListening(queueName, this.entityType);
-        }
-        // Add job to queue
-        return queue.add(jobName, data, options?.jobOptions);
-    }
-    /**
-     * Enqueue and wait for result
-     */
-    async enqueueAndWait(commandOrQuery, options) {
-        const job = await this.enqueue(commandOrQuery, options);
-        const data = (0, queue_bus_utils_1.extractData)(commandOrQuery);
-        const entityId = options?.entityId ?? this.extractEntityId(commandOrQuery, data);
-        const queueNameFn = this.getQueueNameFn();
-        const queueName = queueNameFn(entityId);
-        const queueEvents = await this.queueManager.getQueueEvents(queueName);
-        return job.waitUntilFinished(queueEvents, options?.timeout);
-    }
-    /**
-     * Enqueue multiple commands/queries in bulk
-     */
-    async enqueueBulk(commandsOrQueries, options) {
-        if (commandsOrQueries.length === 0)
-            return [];
-        const firstCmd = commandsOrQueries[0];
-        const firstData = (0, queue_bus_utils_1.extractData)(firstCmd);
-        const entityId = options?.entityId ?? this.extractEntityId(firstCmd, firstData);
-        const queueNameFn = this.getQueueNameFn();
-        const queueName = queueNameFn(entityId);
-        const queue = this.queueManager.getOrCreateQueue(queueName);
-        // Ensure listening is set up for auto-spawn
-        if (this.queueEventsManager) {
-            await this.queueEventsManager.ensureListening(queueName, this.entityType);
-        }
-        const bulkJobs = commandsOrQueries.map((cmd) => ({
-            name: (0, queue_bus_utils_1.getJobName)(cmd),
-            data: (0, queue_bus_utils_1.extractData)(cmd),
-            opts: options?.jobOptions,
-        }));
-        this.logger.debug(`[forEntity:${this.entityType}] Adding ${bulkJobs.length} jobs to queue ${queueName}`);
-        return queue.addBulk(bulkJobs);
-    }
-}
-exports.EntityTarget = EntityTarget;
-//# sourceMappingURL=entity-target.js.map

package/dist/services/queue-bus/entity-target.js.map

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

package/dist/services/queue-bus/queue-bus.types.d.ts

@@ -1,40 +0,0 @@
-import { Type } from '@nestjs/common';
-import { JobsOptions } from 'bullmq';
-/**
- * Options for QueueBus.execute()
- * @deprecated Use .forProcessor(ProcessorClass).enqueue(command) instead
- */
-export interface QueueBusExecuteOptions {
-    /**
-     * The entity ID to use for queue name resolution.
-     * If not provided, will try to extract from command properties:
-     * entityId, tableId, userId, id (in that order)
-     */
-    entityId?: string;
-    /**
-     * BullMQ job options (priority, delay, attempts, etc.)
-     */
-    jobOptions?: JobsOptions;
-}
-/**
- * Options for .enqueue()
- */
-export interface EnqueueOptions {
-    /**
-     * Override the auto-extracted entityId
-     */
-    entityId?: string;
-    /**
-     * BullMQ job options (priority, delay, attempts, etc.)
-     */
-    jobOptions?: JobsOptions;
-}
-/**
- * Registry entry for a command/query class
- */
-export interface CommandRegistryEntry {
-    className: string;
-    targetClass: Type<any>;
-    isQuery: boolean;
-}
-//# sourceMappingURL=queue-bus.types.d.ts.map

package/dist/services/queue-bus/queue-bus.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue-bus.types.d.ts","sourceRoot":"","sources":["../../../src/services/queue-bus/queue-bus.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/services/queue-bus/queue-bus.types.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=queue-bus.types.js.map

package/dist/services/queue-bus/queue-bus.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue-bus.types.js","sourceRoot":"","sources":["../../../src/services/queue-bus/queue-bus.types.ts"],"names":[],"mappings":""}

package/dist/services/queue-bus/queue-target.d.ts

@@ -1,61 +0,0 @@
-import { Type } from '@nestjs/common';
-import { Job } from 'bullmq';
-import { QueueManagerService } from '../queue-manager/queue-manager.service';
-import { QueueEventsManagerService } from '../queue-events-manager/queue-events-manager.service';
-import { WorkerProcessorOptions } from '../../decorators';
-import { IEntityConfig } from '../../domain/interfaces';
-import { EnqueueOptions } from './queue-bus.types';
-/**
- * QueueTarget - Fluent builder for targeting a specific processor's queue
- *
- * @example
- * await queueBus
- *   .forProcessor(TableWorkerProcessor)
- *   .enqueue(new MakeBetCommand(tableId, bets, player));
- */
-export declare class QueueTarget {
-    private readonly queueManager;
-    private readonly processorClass;
-    private readonly processorOptions;
-    private readonly entityConfig?;
-    private readonly queueEventsManager?;
-    private readonly logger;
-    constructor(queueManager: QueueManagerService, processorClass: Type<any>, processorOptions: WorkerProcessorOptions, entityConfig?: IEntityConfig | undefined, queueEventsManager?: QueueEventsManagerService | undefined);
-    /**
-     * Get the queue name function from the processor
-     */
-    private getQueueNameFn;
-    /**
-     * Extract entity ID using the priority chain
-     */
-    private extractEntityId;
-    /**
-     * Enqueue a command/query for processing
-     *
-     * @param commandOrQuery - The command or query instance
-     * @param options - Optional settings (entityId override, jobOptions)
-     * @returns The created BullMQ job
-     *
-     * @example
-     * await queueBus
-     *   .forProcessor(TableWorkerProcessor)
-     *   .enqueue(new MakeBetCommand(tableId, bets, player));
-     *
-     * // With job options
-     * await queueBus
-     *   .forProcessor(TableWorkerProcessor)
-     *   .enqueue(new DealCommand(tableId), { jobOptions: { delay: 5000 } });
-     */
-    enqueue<T extends object>(commandOrQuery: T, options?: EnqueueOptions): Promise<Job>;
-    /**
-     * Enqueue and wait for result
-     */
-    enqueueAndWait<T extends object, R = any>(commandOrQuery: T, options?: EnqueueOptions & {
-        timeout?: number;
-    }): Promise<R>;
-    /**
-     * Enqueue multiple commands/queries in bulk
-     */
-    enqueueBulk<T extends object>(commandsOrQueries: T[], options?: EnqueueOptions): Promise<Job[]>;
-}
-//# sourceMappingURL=queue-target.d.ts.map

package/dist/services/queue-bus/queue-target.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue-target.d.ts","sourceRoot":"","sources":["../../../src/services/queue-bus/queue-target.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,sDAAsD,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnD;;;;;;;GAOG;AACH,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAPtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;gBAGpC,YAAY,EAAE,mBAAmB,EACjC,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,EACzB,gBAAgB,EAAE,sBAAsB,EACxC,YAAY,CAAC,EAAE,aAAa,YAAA,EAC5B,kBAAkB,CAAC,EAAE,yBAAyB,YAAA;IAGjE;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;;;;;;;;;;;;;;;OAgBG;IACG,OAAO,CAAC,CAAC,SAAS,MAAM,EAC5B,cAAc,EAAE,CAAC,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,GAAG,CAAC;IA0Bf;;OAEG;IACG,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,GAAG,GAAG,EAC5C,cAAc,EAAE,CAAC,EACjB,OAAO,CAAC,EAAE,cAAc,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9C,OAAO,CAAC,CAAC,CAAC;IAab;;OAEG;IACG,WAAW,CAAC,CAAC,SAAS,MAAM,EAChC,iBAAiB,EAAE,CAAC,EAAE,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,GAAG,EAAE,CAAC;CA6BlB"}

package/dist/services/queue-bus/queue-target.js

@@ -1,123 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueueTarget = void 0;
-const common_1 = require("@nestjs/common");
-const queue_bus_utils_1 = require("./queue-bus.utils");
-/**
- * QueueTarget - Fluent builder for targeting a specific processor's queue
- *
- * @example
- * await queueBus
- *   .forProcessor(TableWorkerProcessor)
- *   .enqueue(new MakeBetCommand(tableId, bets, player));
- */
-class QueueTarget {
-    constructor(queueManager, processorClass, processorOptions, entityConfig, queueEventsManager) {
-        this.queueManager = queueManager;
-        this.processorClass = processorClass;
-        this.processorOptions = processorOptions;
-        this.entityConfig = entityConfig;
-        this.queueEventsManager = queueEventsManager;
-        this.logger = new common_1.Logger(QueueTarget.name);
-    }
-    /**
-     * Get the queue name function from the processor
-     */
-    getQueueNameFn() {
-        const { queueName } = this.processorOptions;
-        if (typeof queueName === 'function') {
-            return queueName;
-        }
-        if (typeof queueName === 'string') {
-            // Static queue name or pattern with {entityId}
-            return (entityId) => queueName.replace('{entityId}', entityId);
-        }
-        // Check entity config for custom queue name function
-        if (this.entityConfig?.queueName) {
-            return this.entityConfig.queueName;
-        }
-        // Default: entityType-{entityId}-queue
-        const { entityType } = this.processorOptions;
-        return (entityId) => `${entityType}-${entityId}-queue`;
-    }
-    /**
-     * Extract entity ID using the priority chain
-     */
-    extractEntityId(commandOrQuery, data) {
-        return (0, queue_bus_utils_1.extractEntityIdExplicit)(commandOrQuery, data, this.processorOptions.defaultEntityId, this.entityConfig, this.logger);
-    }
-    /**
-     * Enqueue a command/query for processing
-     *
-     * @param commandOrQuery - The command or query instance
-     * @param options - Optional settings (entityId override, jobOptions)
-     * @returns The created BullMQ job
-     *
-     * @example
-     * await queueBus
-     *   .forProcessor(TableWorkerProcessor)
-     *   .enqueue(new MakeBetCommand(tableId, bets, player));
-     *
-     * // With job options
-     * await queueBus
-     *   .forProcessor(TableWorkerProcessor)
-     *   .enqueue(new DealCommand(tableId), { jobOptions: { delay: 5000 } });
-     */
-    async enqueue(commandOrQuery, options) {
-        const jobName = (0, queue_bus_utils_1.getJobName)(commandOrQuery);
-        const data = (0, queue_bus_utils_1.extractData)(commandOrQuery);
-        const entityId = options?.entityId ?? this.extractEntityId(commandOrQuery, data);
-        // Get queue name from processor's queueName function
-        const queueNameFn = this.getQueueNameFn();
-        const queueName = queueNameFn(entityId);
-        // Add job via QueueManager (which handles event listening setup)
-        const { entityType } = this.processorOptions;
-        this.logger.debug(`[${this.processorClass.name}] Adding job ${jobName} to queue ${queueName}`);
-        // Get queue and ensure event listening
-        const queue = this.queueManager.getOrCreateQueue(queueName);
-        if (this.queueEventsManager) {
-            await this.queueEventsManager.ensureListening(queueName, entityType);
-        }
-        // Add job to queue
-        return queue.add(jobName, data, options?.jobOptions);
-    }
-    /**
-     * Enqueue and wait for result
-     */
-    async enqueueAndWait(commandOrQuery, options) {
-        const job = await this.enqueue(commandOrQuery, options);
-        const data = (0, queue_bus_utils_1.extractData)(commandOrQuery);
-        const entityId = options?.entityId ?? this.extractEntityId(commandOrQuery, data);
-        const queueNameFn = this.getQueueNameFn();
-        const queueName = queueNameFn(entityId);
-        const queueEvents = await this.queueManager.getQueueEvents(queueName);
-        return job.waitUntilFinished(queueEvents, options?.timeout);
-    }
-    /**
-     * Enqueue multiple commands/queries in bulk
-     */
-    async enqueueBulk(commandsOrQueries, options) {
-        if (commandsOrQueries.length === 0)
-            return [];
-        const firstCmd = commandsOrQueries[0];
-        const firstData = (0, queue_bus_utils_1.extractData)(firstCmd);
-        const entityId = options?.entityId ?? this.extractEntityId(firstCmd, firstData);
-        const queueNameFn = this.getQueueNameFn();
-        const queueName = queueNameFn(entityId);
-        const queue = this.queueManager.getOrCreateQueue(queueName);
-        // Ensure listening is set up for auto-spawn
-        const { entityType } = this.processorOptions;
-        if (this.queueEventsManager) {
-            await this.queueEventsManager.ensureListening(queueName, entityType);
-        }
-        const bulkJobs = commandsOrQueries.map((cmd) => ({
-            name: (0, queue_bus_utils_1.getJobName)(cmd),
-            data: (0, queue_bus_utils_1.extractData)(cmd),
-            opts: options?.jobOptions,
-        }));
-        this.logger.debug(`[${this.processorClass.name}] Adding ${bulkJobs.length} jobs to queue ${queueName}`);
-        return queue.addBulk(bulkJobs);
-    }
-}
-exports.QueueTarget = QueueTarget;
-//# sourceMappingURL=queue-target.js.map

package/dist/services/queue-bus/queue-target.js.map

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

package/dist/services/queue-events-manager/index.d.ts

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

package/dist/services/queue-events-manager/index.d.ts.map

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

package/dist/services/queue-events-manager/index.js.map

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

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

@@ -1,120 +0,0 @@
-import { OnModuleDestroy } from '@nestjs/common';
-import Redis from 'ioredis';
-import { IAtomicQueuesModuleConfig } from '../../domain';
-import { WorkerManagerService } from '../worker-manager';
-import { ServiceQueueManager } from '../service-queue';
-import { SpawnQueueService } from '../spawn-queue';
-/**
- * Callback for spawning a worker for an entity.
- */
-export type OnJobArrivedCallback = (entityType: string, entityId: string, queueName: string) => Promise<void>;
-/**
- * QueueEventsManagerService
- *
- * Listens to BullMQ queue events using Redis pub/sub (ecological).
- * When a job is added to a queue and no worker exists, triggers worker spawning.
- *
- * This enables a "scalerless" architecture where:
- * - Workers are spawned on-demand when jobs arrive
- * - Workers terminate themselves when idle
- * - No need for @EntityScaler with @GetActiveEntities
- *
- * Key Features:
- * - Redis pub/sub based (ecological) - no polling
- * - Uses BullMQ's QueueEvents for reliable event delivery
- * - Checks for existing workers before spawning
- * - Integrates with ServiceQueue for distributed coordination
- *
- * @example
- * ```typescript
- * // Register a queue for event listening
- * queueEventsManager.registerQueue({
- *   queueName: 'aq:table:123:queue',
- *   entityType: 'table',
- *   extractEntityId: (qn) => qn.split(':')[2], // 123
- *   onJobArrived: async (entityType, entityId) => {
- *     await createWorkerForEntity(entityType, entityId);
- *   },
- * });
- * ```
- */
-export declare class QueueEventsManagerService implements OnModuleDestroy {
-    private readonly redis;
-    private readonly config;
-    private readonly workerManager;
-    private readonly spawnQueueService?;
-    private readonly serviceQueueManager?;
-    private readonly logger;
-    private readonly registeredQueues;
-    private readonly keyPrefix;
-    private readonly useServiceQueue;
-    private readonly entityPatterns;
-    private onJobArrivedCallback;
-    private readonly hotCache;
-    constructor(redis: Redis, config: IAtomicQueuesModuleConfig, workerManager: WorkerManagerService, spawnQueueService?: SpawnQueueService | undefined, serviceQueueManager?: ServiceQueueManager | undefined);
-    /**
-     * Register a callback to be called when a job arrives for any queue
-     * and no worker exists. Used by ProcessorDiscoveryService.
-     */
-    setOnJobArrivedCallback(callback: OnJobArrivedCallback): void;
-    /**
-     * Register an entity type pattern for automatic queue event listening.
-     * When a job is added to any queue matching this pattern, a worker spawn is triggered.
-     */
-    registerEntityPattern(entityType: string, queueNameFn: (entityId: string) => string, workerNameFn: (entityId: string) => string): void;
-    /**
-     * Listen for job arrivals on a specific queue.
-     * Creates a QueueEvents instance for the queue and listens for 'waiting' events.
-     *
-     * @param queueName The BullMQ queue name to listen to
-     * @param entityType The entity type (e.g., 'table')
-     * @param extractEntityId Function to extract entityId from queue name
-     */
-    listenToQueue(queueName: string, entityType: string, extractEntityId: (queueName: string) => string): Promise<void>;
-    /**
-     * Handle job arrival — ultra-low-latency path.
-     *
-     * Hot path (worker exists in cache): 0 Redis calls. Instant return.
-     * Warm path (worker exists in Redis): 1 Redis EXISTS call (O(1)).
-     * Cold path (no worker): 1 SET NX claim + direct local creation.
-     *
-     * This replaces the old flow of: KEYS scan → spawn queue enqueue →
-     * spawn queue dequeue → create worker (multiple seconds) with:
-     * cache hit → 0ms, or SET NX + local create → ~10ms.
-     */
-    private handleJobArrived;
-    /**
-     * Evict a worker from the hot cache.
-     * Called by SpawnQueueService when idle sweep closes a worker,
-     * so the next job arrival will trigger a fresh spawn.
-     */
-    evictFromHotCache(workerName: string): void;
-    /**
-     * Get the hot cache size (for diagnostics).
-     */
-    getHotCacheSize(): number;
-    /**
-     * Listen to all queues that match a pattern.
-     * Uses Redis SCAN to find existing queues and listens to them.
-     * Also sets up keyspace notifications for new queues (if enabled).
-     */
-    listenToEntityTypeQueues(entityType: string): Promise<void>;
-    /**
-     * Ensure we're listening to events for a specific queue.
-     * Call this when adding a job to ensure we catch the event.
-     */
-    ensureListening(queueName: string, entityType: string): Promise<void>;
-    /**
-     * Stop listening to a specific queue.
-     */
-    stopListening(queueName: string): Promise<void>;
-    /**
-     * Get all registered queue names.
-     */
-    getRegisteredQueues(): string[];
-    /**
-     * Cleanup on module destroy.
-     */
-    onModuleDestroy(): Promise<void>;
-}
-//# sourceMappingURL=queue-events-manager.service.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"queue-events-manager.service.d.ts","sourceRoot":"","sources":["../../../src/services/queue-events-manager/queue-events-manager.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,eAAe,EAEhB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,MAAM,SAAS,CAAC;AAE5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAwB,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,IAAI,CAAC,CAAC;AAYnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBACa,yBAA0B,YAAW,eAAe;IAyBhC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAEnD,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAClB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IA7BnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8C;IACrE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiD;IAClF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAG1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAIhB;IAGf,OAAO,CAAC,oBAAoB,CAAqC;IAQjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;gBAGH,KAAK,EAAE,KAAK,EAEzC,MAAM,EAAE,yBAAyB,EACjC,aAAa,EAAE,oBAAoB,EACvB,iBAAiB,CAAC,EAAE,iBAAiB,YAAA,EACrC,mBAAmB,CAAC,EAAE,mBAAmB,YAAA;IAMxE;;;OAGG;IACH,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAK7D;;;OAGG;IACH,qBAAqB,CACnB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,EACzC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GACzC,IAAI;IAyCP;;;;;;;OAOG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAC7C,OAAO,CAAC,IAAI,CAAC;IAiChB;;;;;;;;;;OAUG;YACW,gBAAgB;IA2D9B;;;;OAIG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI3C;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;OAIG;IACG,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0CjE;;;OAGG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB3E;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBrD;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAI/B;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;CAoBvC"}