atomic-queues 1.4.1 → 1.6.0

package/dist/decorators/worker.decorators.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkerProcessor = WorkerProcessor;
+exports.JobHandler = JobHandler;
+const constants_1 = require("./constants");
+/**
+ * @WorkerProcessor class decorator
+ *
+ * Marks a class as a worker processor for a specific entity type.
+ * Combined with @JobHandler method decorators, this enables declarative
+ * job processing with automatic worker creation and management.
+ *
+ * @example
+ * ```typescript
+ * @WorkerProcessor({
+ *   entityType: 'table',
+ *   queueName: (tableId) => `${tableId}-queue`,
+ *   workerName: (tableId) => `table-worker-${tableId}`,
+ *   workerConfig: {
+ *     concurrency: 1,
+ *     heartbeatTTL: 3,
+ *   }
+ * })
+ * @Injectable()
+ * export class TableWorkerProcessor {
+ *   constructor(private readonly commandBus: CommandBus) {}
+ *
+ *   @JobHandler('make-bet')
+ *   async handleMakeBet(job: Job<MakeBetData>, entityId: string) {
+ *     return this.commandBus.execute(new MakeBetCommand(entityId, job.data));
+ *   }
+ *
+ *   @JobHandler('*') // Wildcard handler for any unmatched job
+ *   async handleDynamic(job: Job, entityId: string) {
+ *     // Dynamic handling
+ *   }
+ * }
+ * ```
+ */
+function WorkerProcessor(options) {
+    return (target) => {
+        // Store the options with defaults
+        const metadata = {
+            ...options,
+            overrideDefaults: options.overrideDefaults ?? false,
+        };
+        Reflect.defineMetadata(constants_1.WORKER_PROCESSOR_METADATA, metadata, target);
+        // Mark as injectable if not already
+        if (!Reflect.hasMetadata('injectable', target)) {
+            Reflect.defineMetadata('injectable', true, target);
+        }
+    };
+}
+/**
+ * @JobHandler method decorator
+ *
+ * Marks a method as a handler for a specific job name.
+ * Use '*' as jobName to create a wildcard handler that catches
+ * any jobs not matched by specific handlers.
+ *
+ * @example
+ * ```typescript
+ * @JobHandler('make-bet')
+ * async handleMakeBet(job: Job<MakeBetData>, entityId: string) {
+ *   // Handle make-bet jobs
+ * }
+ *
+ * @JobHandler('*')
+ * async handleOther(job: Job, entityId: string) {
+ *   // Handle any other jobs
+ * }
+ * ```
+ */
+function JobHandler(jobName) {
+    return (target, propertyKey, descriptor) => {
+        const methodName = String(propertyKey);
+        const isWildcard = jobName === '*';
+        // Store handler metadata on the method
+        const metadata = {
+            jobName,
+            methodName,
+            isWildcard,
+        };
+        Reflect.defineMetadata(constants_1.JOB_HANDLER_METADATA, metadata, target, propertyKey);
+        // Collect all handlers on the class
+        const existingHandlers = Reflect.getMetadata(constants_1.JOB_HANDLER_METADATA, target.constructor) || [];
+        existingHandlers.push(metadata);
+        Reflect.defineMetadata(constants_1.JOB_HANDLER_METADATA, existingHandlers, target.constructor);
+        return descriptor;
+    };
+}
+//# sourceMappingURL=worker.decorators.js.map

package/dist/decorators/worker.decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.decorators.js","sourceRoot":"","sources":["../../src/decorators/worker.decorators.ts"],"names":[],"mappings":";;AAqCA,0CAcC;AAsBD,gCAyBC;AAlGD,2CAA8E;AAG9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,SAAgB,eAAe,CAAC,OAA+B;IAC7D,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,kCAAkC;QAClC,MAAM,QAAQ,GAAG;YACf,GAAG,OAAO;YACV,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,KAAK;SACpD,CAAC;QACF,OAAO,CAAC,cAAc,CAAC,qCAAyB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEpE,oCAAoC;QACpC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,UAAU,CAAC,OAAe;IACxC,OAAO,CACL,MAAc,EACd,WAA4B,EAC5B,UAA8B,EAC9B,EAAE;QACF,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,OAAO,KAAK,GAAG,CAAC;QAEnC,uCAAuC;QACvC,MAAM,QAAQ,GAAuB;YACnC,OAAO;YACP,UAAU;YACV,UAAU;SACX,CAAC;QACF,OAAO,CAAC,cAAc,CAAC,gCAAoB,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAE5E,oCAAoC;QACpC,MAAM,gBAAgB,GACpB,OAAO,CAAC,WAAW,CAAC,gCAAoB,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACtE,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChC,OAAO,CAAC,cAAc,CAAC,gCAAoB,EAAE,gBAAgB,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAEnF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/dist/domain/interfaces/config.interfaces.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Redis connection configuration
+ */
+export interface IRedisConfig {
+    host?: string;
+    port?: number;
+    password?: string;
+    db?: number;
+    url?: string;
+    maxRetriesPerRequest?: number | null;
+}
+/**
+ * Worker configuration options
+ */
+export interface IWorkerConfig {
+    /** Number of concurrent jobs a worker can process */
+    concurrency?: number;
+    /** Interval in ms to check for stalled jobs */
+    stalledInterval?: number;
+    /** Duration in ms that a job lock is held */
+    lockDuration?: number;
+    /** Maximum number of times a job can be marked as stalled before failing */
+    maxStalledCount?: number;
+    /** Heartbeat TTL in seconds for worker liveness tracking */
+    heartbeatTTL?: number;
+    /** Interval in ms between heartbeat updates */
+    heartbeatInterval?: number;
+}
+/**
+ * Queue configuration options
+ */
+export interface IQueueConfig {
+    /** Default job options for the queue */
+    defaultJobOptions?: IJobOptions;
+    /** Limiter configuration for rate limiting */
+    limiter?: {
+        groupKey?: string;
+        max?: number;
+        duration?: number;
+    };
+}
+/**
+ * Job configuration options
+ */
+export interface IJobOptions {
+    /** Remove job from queue when completed */
+    removeOnComplete?: boolean | number;
+    /** Remove job from queue when failed */
+    removeOnFail?: boolean | number;
+    /** Number of attempts before marking as failed */
+    attempts?: number;
+    /** Backoff strategy for retries */
+    backoff?: {
+        type: 'fixed' | 'exponential';
+        delay: number;
+    };
+    /** Job priority (lower = higher priority) */
+    priority?: number;
+    /** Delay in ms before the job becomes available */
+    delay?: number;
+}
+/**
+ * Service queue configuration for global singleton operations
+ */
+export interface IServiceQueueConfig {
+    /** Whether to enable the service queue (default: true) */
+    enabled?: boolean;
+    /** Custom queue name (default: {keyPrefix}-service-queue) */
+    queueName?: string;
+    /** Custom worker name (default: {keyPrefix}-service-worker) */
+    workerName?: string;
+}
+/**
+ * Entity-specific configuration for per-entity queue defaults
+ * Used in module-level `entities` config to define defaults per entity type.
+ *
+ * When configured in the module, entities automatically get:
+ * - Worker spawning when jobs arrive (via QueueEvents)
+ * - Idle worker termination (via CronManager)
+ * - Job routing via CQRS CommandBus/QueryBus
+ *
+ * No @WorkerProcessor class needed!
+ *
+ * @example
+ * ```typescript
+ * AtomicQueuesModule.forRoot({
+ *   redis: { host: 'localhost', port: 6379 },
+ *   enableCronManager: true,
+ *   entities: {
+ *     account: {
+ *       queueName: (id) => `${id}-queue`,
+ *       workerName: (id) => `${id}-worker`,
+ *       maxWorkersPerEntity: 1,
+ *       idleTimeoutSeconds: 15,
+ *     },
+ *   },
+ * })
+ * ```
+ */
+export interface IEntityConfig {
+    /**
+     * Default property name to use for entity ID extraction.
+     * This is used when commands don't have an @QueueEntityId() decorator.
+     * Example: 'tableId', 'accountId', 'userId'
+     */
+    defaultEntityId?: string;
+    /**
+     * Custom queue name generator for this entity type.
+     * If not provided, uses: {keyPrefix}:{entityType}:{entityId}:queue
+     */
+    queueName?: (entityId: string) => string;
+    /**
+     * Custom worker name generator for this entity type.
+     * If not provided, uses: {keyPrefix}:{entityType}:{entityId}:worker
+     */
+    workerName?: (entityId: string) => string;
+    /** Worker configuration overrides for this entity type */
+    workerConfig?: Partial<IWorkerConfig>;
+    /**
+     * Maximum workers per entity (default: 1).
+     * Determines how many concurrent workers can process jobs for a single entity.
+     */
+    maxWorkersPerEntity?: number;
+    /**
+     * Idle timeout in seconds before a worker is terminated (default: 15).
+     * Workers are terminated when they have no jobs to process for this duration.
+     */
+    idleTimeoutSeconds?: number;
+    /**
+     * If true, workers are automatically spawned when jobs arrive (default: true).
+     * When enabled, no @WorkerProcessor or @EntityScaler is required.
+     */
+    autoSpawn?: boolean;
+}
+/**
+ * Main module configuration
+ */
+export interface IAtomicQueuesModuleConfig {
+    /** Redis connection configuration */
+    redis: IRedisConfig;
+    /** Default worker configuration */
+    workerDefaults?: IWorkerConfig;
+    /** Default queue configuration */
+    queueDefaults?: IQueueConfig;
+    /** Enable cron-based worker management */
+    enableCronManager?: boolean;
+    /** Cron interval in ms for worker management cycle */
+    cronInterval?: number;
+    /** Prefix for all Redis keys */
+    keyPrefix?: string;
+    /** Service queue configuration for global atomic operations */
+    serviceQueue?: IServiceQueueConfig;
+    /** Enable verbose logging (debug logs for service jobs, scaling cycles, etc.) */
+    verbose?: boolean;
+    /**
+     * Auto-register commands from @nestjs/cqrs handlers (default: true)
+     * When enabled, all @CommandHandler and @QueryHandler decorated classes
+     * are automatically discovered and registered with QueueBus.
+     */
+    autoRegisterCommands?: boolean;
+    /**
+     * Per-entity type configuration.
+     * Allows setting defaults for specific entity types (e.g., 'table', 'account').
+     * These defaults are merged with processor-level and command-level settings.
+     *
+     * Priority chain (highest to lowest):
+     * 1. @QueueEntityId() decorator on command property
+     * 2. @WorkerProcessor({ defaultEntityId })
+     * 3. entities[entityType].defaultEntityId
+     * 4. Error (no fallback to magic extraction)
+     *
+     * @example
+     * ```typescript
+     * entities: {
+     *   table: {
+     *     defaultEntityId: 'tableId',
+     *     workerConfig: { concurrency: 1 }
+     *   },
+     *   account: {
+     *     defaultEntityId: 'accountId',
+     *     queueName: (id) => `accounts-${id}-queue`
+     *   }
+     * }
+     * ```
+     */
+    entities?: Record<string, IEntityConfig>;
+}
+//# sourceMappingURL=config.interfaces.d.ts.map

package/dist/domain/interfaces/config.interfaces.d.ts.map

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

package/dist/domain/interfaces/config.interfaces.js

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

package/dist/domain/interfaces/config.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.interfaces.js","sourceRoot":"","sources":["../../../src/domain/interfaces/config.interfaces.ts"],"names":[],"mappings":""}

package/dist/domain/interfaces/cqrs.interfaces.d.ts

@@ -0,0 +1,7 @@
+export interface ICommandBus {
+    execute<T>(command: T): Promise<any>;
+}
+export interface IQueryBus {
+    execute<T>(query: T): Promise<any>;
+}
+//# sourceMappingURL=cqrs.interfaces.d.ts.map

package/dist/domain/interfaces/cqrs.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cqrs.interfaces.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/cqrs.interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACpC"}

package/dist/domain/interfaces/cqrs.interfaces.js

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

package/dist/domain/interfaces/cqrs.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cqrs.interfaces.js","sourceRoot":"","sources":["../../../src/domain/interfaces/cqrs.interfaces.ts"],"names":[],"mappings":""}

package/dist/domain/interfaces/event.interfaces.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Event types for pub/sub communication
+ */
+export type AtomicQueueEventType = 'worker:shutdown' | 'worker:ready' | 'worker:closed' | 'job:completed' | 'job:failed' | 'job:progress' | 'queue:closed' | 'custom';
+/**
+ * Event payload structure
+ */
+export interface IAtomicQueueEvent<T = unknown> {
+    type: AtomicQueueEventType;
+    nodeId: string;
+    workerId?: string;
+    entityId?: string;
+    entityType?: string;
+    timestamp: Date;
+    data?: T;
+}
+/**
+ * Event bus interface for internal pub/sub
+ */
+export interface IEventBus {
+    /**
+     * Publish an event
+     */
+    publish<T>(channel: string, event: IAtomicQueueEvent<T>): Promise<void>;
+    /**
+     * Subscribe to a channel
+     */
+    subscribe(channel: string, handler: (event: IAtomicQueueEvent) => void | Promise<void>): Promise<void>;
+    /**
+     * Unsubscribe from a channel
+     */
+    unsubscribe(channel: string): Promise<void>;
+    /**
+     * Subscribe to worker shutdown events for a specific worker
+     */
+    subscribeToWorkerShutdown(workerName: string, handler: () => void | Promise<void>): Promise<void>;
+}
+/**
+ * Socket connection tracking interface
+ */
+export interface IConnectionTracker {
+    /**
+     * Track a socket connection for an entity
+     */
+    trackConnection(entityType: string, entityId: string, socketId: string, nodeId: string): Promise<void>;
+    /**
+     * Untrack a socket connection
+     */
+    untrackConnection(entityType: string, entityId: string, socketId: string): Promise<void>;
+    /**
+     * Get all socket connections for an entity
+     */
+    getEntityConnections(entityType: string, entityId: string): Promise<string[]>;
+    /**
+     * Get entity connections for a specific node
+     */
+    getEntityNodeConnections(entityType: string, entityId: string, nodeId: string): Promise<string[]>;
+    /**
+     * Untrack all connections for current node
+     */
+    untrackNodeConnections(): Promise<void>;
+    /**
+     * Check if entity has active connections
+     */
+    hasActiveConnections(entityType: string, entityId: string): Promise<boolean>;
+    /**
+     * Get node ID for a socket connection
+     */
+    getNodeForSocket(entityType: string, entityId: string, socketId: string): Promise<string | null>;
+}
+//# sourceMappingURL=event.interfaces.d.ts.map

package/dist/domain/interfaces/event.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.interfaces.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/event.interfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,iBAAiB,GACjB,cAAc,GACd,eAAe,GACf,eAAe,GACf,YAAY,GACZ,cAAc,GACd,cAAc,GACd,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,OAAO;IAC5C,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,CAAC,EAAE,CAAC,CAAC;CACV;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE;;OAEG;IACH,SAAS,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC1D,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;OAEG;IACH,yBAAyB,CACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzF;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE9E;;OAEG;IACH,wBAAwB,CACtB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAErB;;OAEG;IACH,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;OAEG;IACH,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7E;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAClG"}

package/dist/domain/interfaces/event.interfaces.js

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

package/dist/domain/interfaces/event.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.interfaces.js","sourceRoot":"","sources":["../../../src/domain/interfaces/event.interfaces.ts"],"names":[],"mappings":""}

package/dist/domain/interfaces/index-tracking.interfaces.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Index entry for tracking jobs, workers, queues
+ */
+export interface IIndexEntry {
+    id: string;
+    type: 'job' | 'worker' | 'queue' | 'death' | 'custom';
+    entityId: string;
+    entityType: string;
+    createdAt: Date;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Index manager interface for tracking various entities
+ */
+export interface IIndexManager {
+    /**
+     * Index a job for an entity
+     */
+    indexJob(entityType: string, entityId: string, jobId: string): Promise<void>;
+    /**
+     * Remove job index
+     */
+    removeJobIndex(entityType: string, entityId: string, jobId: string): Promise<void>;
+    /**
+     * Get all job IDs for an entity
+     */
+    getEntityJobs(entityType: string, entityId: string): Promise<string[]>;
+    /**
+     * Get all entities with jobs
+     */
+    getEntitiesWithJobs(entityType: string): Promise<Record<string, number>>;
+    /**
+     * Index a worker death signal
+     */
+    indexWorkerDeath(entityType: string, entityId: string, deathId: string): Promise<void>;
+    /**
+     * Remove worker death index
+     */
+    removeWorkerDeathIndex(entityType: string, entityId: string, deathId: string): Promise<void>;
+    /**
+     * Get queued worker deaths for an entity
+     */
+    getQueuedWorkerDeaths(entityType: string, entityId: string): Promise<string[]>;
+    /**
+     * Index entity queue
+     */
+    indexEntityQueue(entityType: string, entityId: string): Promise<void>;
+    /**
+     * Remove entity queue index
+     */
+    removeEntityQueueIndex(entityType: string, entityId: string): Promise<void>;
+    /**
+     * Get all entities with active queues
+     */
+    getEntitiesWithQueues(entityType: string): Promise<string[]>;
+    /**
+     * Index a queue death signal
+     */
+    indexQueueDeath(entityType: string, entityId: string): Promise<void>;
+    /**
+     * Remove queue death index
+     */
+    removeQueueDeathIndex(entityType: string, entityId: string): Promise<void>;
+    /**
+     * Get all entities with queued queue deaths
+     */
+    getEntitiesWithQueuedQueueDeaths(entityType: string): Promise<string[]>;
+}
+//# sourceMappingURL=index-tracking.interfaces.d.ts.map

package/dist/domain/interfaces/index-tracking.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-tracking.interfaces.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/index-tracking.interfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7E;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnF;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEvE;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEzE;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvF;;OAEG;IACH,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7F;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE/E;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtE;;OAEG;IACH,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE7D;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErE;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E;;OAEG;IACH,gCAAgC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACzE"}

package/dist/domain/interfaces/index-tracking.interfaces.js

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

package/dist/domain/interfaces/index-tracking.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-tracking.interfaces.js","sourceRoot":"","sources":["../../../src/domain/interfaces/index-tracking.interfaces.ts"],"names":[],"mappings":""}

package/dist/domain/interfaces/index.d.ts

@@ -0,0 +1,12 @@
+export * from './config.interfaces';
+export * from './queue.interfaces';
+export * from './worker.interfaces';
+export * from './lock.interfaces';
+export * from './job.interfaces';
+export * from './scaling.interfaces';
+export * from './index-tracking.interfaces';
+export * from './event.interfaces';
+export * from './process.interfaces';
+export * from './cqrs.interfaces';
+export * from './utility.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/domain/interfaces/index.js

@@ -0,0 +1,28 @@
+"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("./config.interfaces"), exports);
+__exportStar(require("./queue.interfaces"), exports);
+__exportStar(require("./worker.interfaces"), exports);
+__exportStar(require("./lock.interfaces"), exports);
+__exportStar(require("./job.interfaces"), exports);
+__exportStar(require("./scaling.interfaces"), exports);
+__exportStar(require("./index-tracking.interfaces"), exports);
+__exportStar(require("./event.interfaces"), exports);
+__exportStar(require("./process.interfaces"), exports);
+__exportStar(require("./cqrs.interfaces"), exports);
+__exportStar(require("./utility.types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/domain/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,qDAAmC;AACnC,sDAAoC;AACpC,oDAAkC;AAClC,mDAAiC;AACjC,uDAAqC;AACrC,8DAA4C;AAC5C,qDAAmC;AACnC,uDAAqC;AACrC,oDAAkC;AAClC,kDAAgC"}

package/dist/domain/interfaces/job.interfaces.d.ts

@@ -0,0 +1,76 @@
+import { Job } from 'bullmq';
+/**
+ * Job data structure for atomic processing
+ */
+export interface IAtomicJobData<T = unknown> {
+    /** Unique job identifier */
+    uuid: string;
+    /** Entity ID this job belongs to */
+    entityId: string;
+    /** Entity type (user, table, etc.) */
+    entityType: string;
+    /** Command/Query class name to execute */
+    commandName?: string;
+    /** Type of operation */
+    type: 'command' | 'query' | 'custom';
+    /** Payload data */
+    payload: T;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Job processing result
+ */
+export interface IJobResult<T = unknown> {
+    success: boolean;
+    result?: T;
+    error?: string;
+    processingTime: number;
+}
+/**
+ * Job processor function type
+ */
+export type JobProcessor<T = unknown, R = unknown> = (job: Job<IAtomicJobData<T>>) => Promise<R>;
+/**
+ * Job processor registry interface
+ */
+export interface IJobProcessorRegistry {
+    /**
+     * Register a processor for a job type
+     */
+    registerProcessor<T, R>(jobType: string, processor: JobProcessor<T, R>): void;
+    /**
+     * Get processor for a job type
+     */
+    getProcessor<T, R>(jobType: string): JobProcessor<T, R> | undefined;
+    /**
+     * Check if processor exists
+     */
+    hasProcessor(jobType: string): boolean;
+    /**
+     * Get all registered job types
+     */
+    getRegisteredTypes(): string[];
+}
+/**
+ * Dynamic command/query executor interface
+ */
+export interface IDynamicExecutor {
+    /**
+     * Execute a command by class name
+     */
+    executeCommand<T>(commandName: string, payload: T): Promise<unknown>;
+    /**
+     * Execute a query by class name
+     */
+    executeQuery<T>(queryName: string, payload: T): Promise<unknown>;
+    /**
+     * Register command module for dynamic loading
+     */
+    registerCommandModule(modulePath: string): void;
+    /**
+     * Register query module for dynamic loading
+     */
+    registerQueryModule(modulePath: string): void;
+}
+//# sourceMappingURL=job.interfaces.d.ts.map

package/dist/domain/interfaces/job.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.interfaces.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/job.interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrC,mBAAmB;IACnB,OAAO,EAAE,CAAC,CAAC;IACX,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,OAAO;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,CACnD,GAAG,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,KACxB,OAAO,CAAC,CAAC,CAAC,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,iBAAiB,CAAC,CAAC,EAAE,CAAC,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAC5B,IAAI,CAAC;IAER;;OAEG;IACH,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;IAEpE;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAEvC;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,cAAc,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErE;;OAEG;IACH,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjE;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhD;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C"}

package/dist/domain/interfaces/job.interfaces.js

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

package/dist/domain/interfaces/job.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.interfaces.js","sourceRoot":"","sources":["../../../src/domain/interfaces/job.interfaces.ts"],"names":[],"mappings":""}