atomic-queues 1.6.2 → 2.0.0

package/dist/decorators/metadata-readers.js

@@ -2,52 +2,35 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getEntityType = getEntityType;
 exports.getEntityIdProperty = getEntityIdProperty;
-exports.getWorkerProcessorMetadata = getWorkerProcessorMetadata;
-exports.getJobHandlerMetadata = getJobHandlerMetadata;
-exports.getEntityScalerMetadata = getEntityScalerMetadata;
 exports.getJobCommandMetadata = getJobCommandMetadata;
 exports.getJobQueryMetadata = getJobQueryMetadata;
+exports.getActorMetadata = getActorMetadata;
+exports.getActorHandlers = getActorHandlers;
+exports.getSchemaMetadata = getSchemaMetadata;
+exports.getReplySchemaMetadata = getReplySchemaMetadata;
 const constants_1 = require("./constants");
-/**
- * Get the entity type from a command/query class decorated with @EntityType or @QueueEntity
- */
 function getEntityType(target) {
     return Reflect.getMetadata(constants_1.ENTITY_TYPE_METADATA, target);
 }
-/**
- * Get the entity ID property name from a class decorated with @QueueEntityId or @QueueEntity
- */
 function getEntityIdProperty(target) {
     return Reflect.getMetadata(constants_1.ENTITY_ID_METADATA, target);
 }
-/**
- * Get WorkerProcessor metadata from a class
- */
-function getWorkerProcessorMetadata(target) {
-    return Reflect.getMetadata(constants_1.WORKER_PROCESSOR_METADATA, target);
-}
-/**
- * Get all JobHandler metadata from a class
- */
-function getJobHandlerMetadata(target) {
-    return Reflect.getMetadata(constants_1.JOB_HANDLER_METADATA, target) || [];
-}
-/**
- * Get EntityScaler metadata from a class
- */
-function getEntityScalerMetadata(target) {
-    return Reflect.getMetadata(constants_1.ENTITY_SCALER_METADATA, target);
-}
-/**
- * Get JobCommand metadata from a class
- */
 function getJobCommandMetadata(target) {
     return Reflect.getMetadata(constants_1.JOB_COMMAND_METADATA, target);
 }
-/**
- * Get JobQuery metadata from a class
- */
 function getJobQueryMetadata(target) {
     return Reflect.getMetadata(constants_1.JOB_QUERY_METADATA, target);
 }
+function getActorMetadata(target) {
+    return Reflect.getMetadata(constants_1.ACTOR_METADATA, target);
+}
+function getActorHandlers(target) {
+    return Reflect.getMetadata(constants_1.ACTOR_HANDLERS_METADATA, target) || [];
+}
+function getSchemaMetadata(target) {
+    return Reflect.getMetadata(constants_1.SCHEMA_METADATA, target);
+}
+function getReplySchemaMetadata(target) {
+    return Reflect.getMetadata(constants_1.REPLY_SCHEMA_METADATA, target);
+}
 //# sourceMappingURL=metadata-readers.js.map

package/dist/decorators/metadata-readers.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-readers.js","sourceRoot":"","sources":["../../src/decorators/metadata-readers.ts"],"names":[],"mappings":";;AAqBA,sCAEC;AAKD,kDAEC;AAKD,gEAEC;AAKD,sDAEC;AAKD,0DAEC;AAKD,sDAEC;AAKD,kDAEC;AAhED,2CAQqB;AASrB;;GAEG;AACH,SAAgB,aAAa,CAAC,MAAgB;IAC5C,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAoB,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,MAAgB;IAClD,OAAO,OAAO,CAAC,WAAW,CAAC,8BAAkB,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,SAAgB,0BAA0B,CAAC,MAAiB;IAC1D,OAAO,OAAO,CAAC,WAAW,CAAC,qCAAyB,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAiB;IACrD,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAoB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,SAAgB,uBAAuB,CAAC,MAAiB;IACvD,OAAO,OAAO,CAAC,WAAW,CAAC,kCAAsB,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAgB;IACpD,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAoB,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,MAAgB;IAClD,OAAO,OAAO,CAAC,WAAW,CAAC,8BAAkB,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"metadata-readers.js","sourceRoot":"","sources":["../../src/decorators/metadata-readers.ts"],"names":[],"mappings":";;AAiBA,sCAEC;AAED,kDAEC;AAED,sDAEC;AAED,kDAEC;AAED,4CAEC;AAED,4CAEC;AAED,8CAEC;AAED,wDAEC;AA/CD,2CASqB;AAQrB,SAAgB,aAAa,CAAC,MAAgB;IAC5C,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAoB,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,SAAgB,mBAAmB,CAAC,MAAgB;IAClD,OAAO,OAAO,CAAC,WAAW,CAAC,8BAAkB,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED,SAAgB,qBAAqB,CAAC,MAAgB;IACpD,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAoB,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,SAAgB,mBAAmB,CAAC,MAAgB;IAClD,OAAO,OAAO,CAAC,WAAW,CAAC,8BAAkB,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED,SAAgB,gBAAgB,CAAC,MAAgB;IAC/C,OAAO,OAAO,CAAC,WAAW,CAAC,0BAAc,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,SAAgB,gBAAgB,CAAC,MAAgB;IAC/C,OAAO,OAAO,CAAC,WAAW,CAAC,mCAAuB,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACpE,CAAC;AAED,SAAgB,iBAAiB,CAAC,MAAgB;IAChD,OAAO,OAAO,CAAC,WAAW,CAAC,2BAAe,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,SAAgB,sBAAsB,CAAC,MAAgB;IACrD,OAAO,OAAO,CAAC,WAAW,CAAC,iCAAqB,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC"}

package/dist/decorators/schema.decorators.d.ts

@@ -0,0 +1,2 @@
+export declare function Schema(zodSchema: any, replySchema?: any): ClassDecorator;
+//# sourceMappingURL=schema.decorators.d.ts.map

package/dist/decorators/schema.decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.decorators.d.ts","sourceRoot":"","sources":["../../src/decorators/schema.decorators.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,GAAG,GAAG,cAAc,CAOxE"}

package/dist/decorators/schema.decorators.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Schema = Schema;
+const constants_1 = require("./constants");
+function Schema(zodSchema, replySchema) {
+    return (target) => {
+        Reflect.defineMetadata(constants_1.SCHEMA_METADATA, zodSchema, target);
+        if (replySchema) {
+            Reflect.defineMetadata(constants_1.REPLY_SCHEMA_METADATA, replySchema, target);
+        }
+    };
+}
+//# sourceMappingURL=schema.decorators.js.map

package/dist/decorators/schema.decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.decorators.js","sourceRoot":"","sources":["../../src/decorators/schema.decorators.ts"],"names":[],"mappings":";;AAEA,wBAOC;AATD,2CAAqE;AAErE,SAAgB,MAAM,CAAC,SAAc,EAAE,WAAiB;IACtD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,OAAO,CAAC,cAAc,CAAC,2BAAe,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAC3D,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,cAAc,CAAC,iCAAqB,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QACrE,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

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

@@ -10,127 +10,58 @@ export interface IRedisConfig {
     maxRetriesPerRequest?: number | null;
 }
 /**
- * Worker configuration options
+ * Retry policy configuration
  */
-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;
+export interface IRetryPolicy {
+    /** Maximum number of attempts (default: 3) */
+    maxAttempts?: number;
+    /** Backoff strategy */
+    backoff?: 'fixed' | 'exponential';
+    /** Base delay in ms (default: 1000) */
+    backoffDelay?: number;
+    /** Maximum delay in ms (default: 30000) */
+    maxDelay?: number;
 }
 /**
- * Queue configuration options
+ * Per-entity-type configuration
  */
-export interface IQueueConfig {
-    /** Default job options for the queue */
-    defaultJobOptions?: IJobOptions;
-    /** Limiter configuration for rate limiting */
-    limiter?: {
-        groupKey?: string;
-        max?: number;
-        duration?: number;
-    };
+export interface IEntityConfig {
+    /** Default property name for entity ID extraction */
+    defaultEntityId?: string;
+    /** Gate TTL in seconds (default: 30) */
+    gateTTL?: number;
+    /** Retry policy for this entity type */
+    retry?: IRetryPolicy;
+    /** Idle timeout in ms before actor state is evicted from memory (default: 60000) */
+    actorIdleTimeout?: number;
+    /** Persist actor state to Redis on eviction (default: true) */
+    statePersistence?: boolean;
 }
 /**
- * Job configuration options
+ * Executor pool configuration
  */
-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;
+export interface IExecutorConfig {
+    /** Number of concurrent executors (default: 1) */
+    poolSize?: number;
+    /** Default gate TTL in seconds (default: 30) */
+    gateTTL?: number;
+    /** Gate refresh interval in ms (default: gateTTL * 500) */
+    gateRefreshInterval?: number;
 }
 /**
- * Service queue configuration for global singleton operations
+ * Distributed registry configuration (optional, for cross-service)
  */
-export interface IServiceQueueConfig {
-    /** Whether to enable the service queue (default: true) */
+export interface IRegistryConfig {
+    /** Enable the distributed registry (default: false) */
     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;
+    /** Service name for identification in the registry */
+    serviceName?: string;
+    /** Validate payload schemas on send (default: false) */
+    schemaValidation?: boolean;
+    /** Heartbeat interval in ms (default: 10000) */
+    heartbeatInterval?: number;
+    /** Registration TTL in seconds (default: 30) */
+    registrationTTL?: number;
 }
 /**
  * Main module configuration
@@ -138,51 +69,19 @@ export interface IEntityConfig {
 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 */
+    /** Executor pool configuration */
+    executor?: IExecutorConfig;
+    /** Default retry policy */
+    retry?: IRetryPolicy;
+    /** Per-entity-type overrides */
+    entities?: Record<string, IEntityConfig>;
+    /** Distributed registry (cross-service communication) */
+    registry?: IRegistryConfig;
+    /** Prefix for all Redis keys (default: 'aq') */
     keyPrefix?: string;
-    /** Service queue configuration for global atomic operations */
-    serviceQueue?: IServiceQueueConfig;
-    /** Enable verbose logging (debug logs for service jobs, scaling cycles, etc.) */
+    /** Enable verbose logging */
     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.
-     */
+    /** Auto-register commands from @nestjs/cqrs handlers (default: true) */
     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

@@ -1 +1 @@
-{"version":3,"file":"config.interfaces.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/config.interfaces.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.interfaces.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/config.interfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,OAAO,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;IAClC,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,qCAAqC;IACrC,KAAK,EAAE,YAAY,CAAC;IAEpB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAEzC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,wEAAwE;IACxE,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC"}

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

@@ -1,12 +1,5 @@
 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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/domain/interfaces/index.js

@@ -15,14 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 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

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,mDAAiC;AACjC,oDAAkC;AAClC,kDAAgC"}

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

@@ -1,76 +1,43 @@
-import { Job } from 'bullmq';
 /**
- * Job data structure for atomic processing
+ * Serialized message stored in the entity log
  */
-export interface IAtomicJobData<T = unknown> {
-    /** Unique job identifier */
-    uuid: string;
-    /** Entity ID this job belongs to */
-    entityId: string;
-    /** Entity type (user, table, etc.) */
+export interface ISerializedMessage {
+    /** Unique message ID */
+    id: string;
+    /** Message class name (e.g., 'WithdrawCommand') */
+    name: string;
+    /** Serialized message data */
+    data: Record<string, any>;
+    /** Entity type */
     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;
+    /** Entity ID */
+    entityId: string;
+    /** Whether this is a query (expects a reply) */
+    isQuery?: boolean;
+    /** Correlation ID for reply delivery */
+    correlationId?: string;
+    /** Timestamp when enqueued */
+    enqueuedAt: number;
+    /** Number of attempts so far */
+    attempts: number;
+    /** Max attempts allowed */
+    maxAttempts: number;
 }
 /**
- * Job processor function type
- */
-export type JobProcessor<T = unknown, R = unknown> = (job: Job<IAtomicJobData<T>>) => Promise<R>;
-/**
- * Job processor registry interface
+ * Reference returned from enqueue operations
  */
-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[];
+export interface IMessageRef {
+    /** Unique message ID */
+    id: string;
+    /** Entity key (entityType:entityId) */
+    entityKey: string;
 }
 /**
- * Dynamic command/query executor interface
+ * Result of a dispatched message
  */
-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;
+export interface IDispatchResult {
+    entityKey: string;
+    message: ISerializedMessage;
+    ownerToken: string;
 }
 //# sourceMappingURL=job.interfaces.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"job.interfaces.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/job.interfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/index.d.ts

@@ -1,37 +1,3 @@
-/**
- * =============================================================================
- * ATOMIC QUEUES
- * =============================================================================
- *
- * A plug-and-play NestJS library for atomic process handling per entity
- * with BullMQ, Redis distributed locking, and dynamic worker management.
- *
- * Features:
- * - Dynamic per-entity queue creation
- * - Worker lifecycle management with heartbeat TTL
- * - Distributed resource locking (Redis/Lua scripts)
- * - Graceful shutdown coordination via pub/sub
- * - Cron-based worker spawning/cleanup
- * - CQRS command/query dynamic execution
- * - Index tracking for jobs, workers, and queues
- *
- * @example
- * ```typescript
- * import { AtomicQueuesModule, QueueManagerService, WorkerManagerService } from 'atomic-queues';
- *
- * @Module({
- *   imports: [
- *     AtomicQueuesModule.forRoot({
- *       redis: { host: 'localhost', port: 6379 },
- *       enableCronManager: true,
- *     }),
- *   ],
- * })
- * export class AppModule {}
- * ```
- *
- * @packageDocumentation
- */
 export * from './domain';
 export * from './module';
 export * from './services';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,cAAc,UAAU,CAAC;AAGzB,cAAc,UAAU,CAAC;AAGzB,cAAc,YAAY,CAAC;AAG3B,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -1,38 +1,4 @@
 "use strict";
-/**
- * =============================================================================
- * ATOMIC QUEUES
- * =============================================================================
- *
- * A plug-and-play NestJS library for atomic process handling per entity
- * with BullMQ, Redis distributed locking, and dynamic worker management.
- *
- * Features:
- * - Dynamic per-entity queue creation
- * - Worker lifecycle management with heartbeat TTL
- * - Distributed resource locking (Redis/Lua scripts)
- * - Graceful shutdown coordination via pub/sub
- * - Cron-based worker spawning/cleanup
- * - CQRS command/query dynamic execution
- * - Index tracking for jobs, workers, and queues
- *
- * @example
- * ```typescript
- * import { AtomicQueuesModule, QueueManagerService, WorkerManagerService } from 'atomic-queues';
- *
- * @Module({
- *   imports: [
- *     AtomicQueuesModule.forRoot({
- *       redis: { host: 'localhost', port: 6379 },
- *       enableCronManager: true,
- *     }),
- *   ],
- * })
- * export class AppModule {}
- * ```
- *
- * @packageDocumentation
- */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -48,14 +14,9 @@ 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 });
-// Domain - Interfaces and Types
 __exportStar(require("./domain"), exports);
-// Module
 __exportStar(require("./module"), exports);
-// Services
 __exportStar(require("./services"), exports);
-// Decorators
 __exportStar(require("./decorators"), exports);
-// Utilities
 __exportStar(require("./utils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;;;;;;;;;;;;;;AAEH,gCAAgC;AAChC,2CAAyB;AAEzB,SAAS;AACT,2CAAyB;AAEzB,WAAW;AACX,6CAA2B;AAE3B,aAAa;AACb,+CAA6B;AAE7B,YAAY;AACZ,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,2CAAyB;AACzB,6CAA2B;AAC3B,+CAA6B;AAC7B,0CAAwB"}