atomic-queues 2.3.0 → 3.0.0

package/dist/decorators/job.decorators.js

@@ -5,44 +5,14 @@ exports.JobQuery = JobQuery;
 const constants_1 = require("./constants");
 const utils_1 = require("./utils");
 /**
- * @JobCommand class decorator
- *
- * Marks a command class for automatic job routing. When a job with the
- * specified name arrives, the library will automatically instantiate
- * the command with entityId + job.data and execute it via CommandBus.
- *
- * This eliminates the need for @JobHandler boilerplate in processors.
- *
- * @example
- * ```typescript
- * // Option 1: Explicit job name
- * @JobCommand('make-bet')
- * export class MakeBetCommand {
- *   constructor(
- *     public readonly tableId: string,    // entityId (first param)
- *     public readonly playerId: string,
- *     public readonly amount: number,
- *   ) {}
- * }
- *
- * // Option 2: Auto-derived job name (MakeBetCommand -> 'make-bet')
- * @JobCommand()
- * export class MakeBetCommand { ... }
- *
- * // Option 3: With options
- * @JobCommand({
- *   name: 'place-bet',
- *   entityType: 'table',
- *   entityIdParam: 'tableId',  // or 0 for first param
- * })
- * export class PlaceBetCommand { ... }
- * ```
+ * @deprecated Use `@EntityType` + `@QueueEntityId` (or `@QueueEntity`) with standard `@nestjs/cqrs`
+ * `@CommandHandler` instead. This decorator will be removed in a future major version.
  */
 function JobCommand(options) {
     return (target) => {
         const opts = typeof options === 'string' ? { name: options } : options || {};
         const jobName = opts.name || (0, utils_1.deriveJobName)(target.name, 'Command');
-        const paramNames = (0, utils_1.getConstructorParamNames)(target);
+        const paramNames = opts.params ?? (0, utils_1.getConstructorParamNames)(target);
         const metadata = {
             jobName,
             entityType: opts.entityType,
@@ -54,32 +24,14 @@ function JobCommand(options) {
     };
 }
 /**
- * @JobQuery class decorator
- *
- * Marks a query class for automatic job routing. When a job with the
- * specified name arrives, the library will automatically instantiate
- * the query with entityId + job.data and execute it via QueryBus.
- *
- * @example
- * ```typescript
- * @JobQuery('get-score')
- * export class GetScoreQuery {
- *   constructor(
- *     public readonly tableId: string,
- *     public readonly seatIndex: number,
- *   ) {}
- * }
- *
- * // Auto-derived: GetTableStateQuery -> 'get-table-state'
- * @JobQuery()
- * export class GetTableStateQuery { ... }
- * ```
+ * @deprecated Use `@EntityType` + `@QueueEntityId` (or `@QueueEntity`) with standard `@nestjs/cqrs`
+ * `@QueryHandler` instead. This decorator will be removed in a future major version.
  */
 function JobQuery(options) {
     return (target) => {
         const opts = typeof options === 'string' ? { name: options } : options || {};
         const jobName = opts.name || (0, utils_1.deriveJobName)(target.name, 'Query');
-        const paramNames = (0, utils_1.getConstructorParamNames)(target);
+        const paramNames = opts.params ?? (0, utils_1.getConstructorParamNames)(target);
         const metadata = {
             jobName,
             entityType: opts.entityType,

package/dist/decorators/job.decorators.js.map

@@ -1 +1 @@
-{"version":3,"file":"job.decorators.js","sourceRoot":"","sources":["../../src/decorators/job.decorators.ts"],"names":[],"mappings":";;AA2CA,gCAiBC;AAwBD,4BAiBC;AArGD,2CAAuE;AAOvE,mCAAkE;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,SAAgB,UAAU,CAAC,OAAoC;IAC7D,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAsB,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;QAEhG,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAA,qBAAa,EAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,IAAA,gCAAwB,EAAC,MAAM,CAAC,CAAC;QAEpD,MAAM,QAAQ,GAAuB;YACnC,OAAO;YACP,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC;YACtC,WAAW,EAAE,MAAM;YACnB,UAAU;SACX,CAAC;QAEF,OAAO,CAAC,cAAc,CAAC,gCAAoB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,QAAQ,CAAC,OAAkC;IACzD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAoB,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;QAE9F,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAA,qBAAa,EAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,IAAA,gCAAwB,EAAC,MAAM,CAAC,CAAC;QAEpD,MAAM,QAAQ,GAAqB;YACjC,OAAO;YACP,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC;YACtC,WAAW,EAAE,MAAM;YACnB,UAAU;SACX,CAAC;QAEF,OAAO,CAAC,cAAc,CAAC,8BAAkB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"job.decorators.js","sourceRoot":"","sources":["../../src/decorators/job.decorators.ts"],"names":[],"mappings":";;AAaA,gCAiBC;AAMD,4BAiBC;AArDD,2CAAuE;AAOvE,mCAAkE;AAElE;;;GAGG;AACH,SAAgB,UAAU,CAAC,OAAoC;IAC7D,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAsB,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;QAEhG,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAA,qBAAa,EAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,IAAI,IAAA,gCAAwB,EAAC,MAAM,CAAC,CAAC;QAEnE,MAAM,QAAQ,GAAuB;YACnC,OAAO;YACP,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC;YACtC,WAAW,EAAE,MAAM;YACnB,UAAU;SACX,CAAC;QAEF,OAAO,CAAC,cAAc,CAAC,gCAAoB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,QAAQ,CAAC,OAAkC;IACzD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAoB,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;QAE9F,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAA,qBAAa,EAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,IAAI,IAAA,gCAAwB,EAAC,MAAM,CAAC,CAAC;QAEnE,MAAM,QAAQ,GAAqB;YACjC,OAAO;YACP,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC;YACtC,WAAW,EAAE,MAAM;YACnB,UAAU;SACX,CAAC;QAEF,OAAO,CAAC,cAAc,CAAC,8BAAkB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/metadata-readers.d.ts

@@ -1,8 +1,10 @@
 import { JobCommandMetadata, JobQueryMetadata } from './interfaces';
 export declare function getEntityType(target: Function): string | undefined;
 export declare function getEntityIdProperty(target: Function): string | undefined;
+/** @deprecated Part of the deprecated `@JobCommand` API. */
 export declare function getJobCommandMetadata(target: Function): JobCommandMetadata | undefined;
+/** @deprecated Part of the deprecated `@JobQuery` API. */
 export declare function getJobQueryMetadata(target: Function): JobQueryMetadata | undefined;
-export declare function getSchemaMetadata(target: Function): any | undefined;
-export declare function getReplySchemaMetadata(target: Function): any | undefined;
+export declare function getSchemaMetadata(target: Function): unknown | undefined;
+export declare function getReplySchemaMetadata(target: Function): unknown | undefined;
 //# sourceMappingURL=metadata-readers.d.ts.map

package/dist/decorators/metadata-readers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-readers.d.ts","sourceRoot":"","sources":["../../src/decorators/metadata-readers.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEpE,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAExE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAEtF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,gBAAgB,GAAG,SAAS,CAElF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG,GAAG,GAAG,SAAS,CAEnE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,GAAG,GAAG,SAAS,CAExE"}
+{"version":3,"file":"metadata-readers.d.ts","sourceRoot":"","sources":["../../src/decorators/metadata-readers.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEpE,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAElE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAExE;AAED,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,QAAQ,GAAG,kBAAkB,GAAG,SAAS,CAEtF;AAED,0DAA0D;AAC1D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,gBAAgB,GAAG,SAAS,CAElF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAEvE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAE5E"}

package/dist/decorators/metadata-readers.js

@@ -13,9 +13,11 @@ function getEntityType(target) {
 function getEntityIdProperty(target) {
     return Reflect.getMetadata(constants_1.ENTITY_ID_METADATA, target);
 }
+/** @deprecated Part of the deprecated `@JobCommand` API. */
 function getJobCommandMetadata(target) {
     return Reflect.getMetadata(constants_1.JOB_COMMAND_METADATA, target);
 }
+/** @deprecated Part of the deprecated `@JobQuery` API. */
 function getJobQueryMetadata(target) {
     return Reflect.getMetadata(constants_1.JOB_QUERY_METADATA, target);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"metadata-readers.js","sourceRoot":"","sources":["../../src/decorators/metadata-readers.ts"],"names":[],"mappings":";;AAUA,sCAEC;AAED,kDAEC;AAED,sDAEC;AAED,kDAEC;AAED,8CAEC;AAED,wDAEC;AAhCD,2CAOqB;AAGrB,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,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"}
+{"version":3,"file":"metadata-readers.js","sourceRoot":"","sources":["../../src/decorators/metadata-readers.ts"],"names":[],"mappings":";;AAUA,sCAEC;AAED,kDAEC;AAGD,sDAEC;AAGD,kDAEC;AAED,8CAEC;AAED,wDAEC;AAlCD,2CAOqB;AAGrB,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,4DAA4D;AAC5D,SAAgB,qBAAqB,CAAC,MAAgB;IACpD,OAAO,OAAO,CAAC,WAAW,CAAC,gCAAoB,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,0DAA0D;AAC1D,SAAgB,mBAAmB,CAAC,MAAgB;IAClD,OAAO,OAAO,CAAC,WAAW,CAAC,8BAAkB,EAAE,MAAM,CAAC,CAAC;AACzD,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

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

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

@@ -1 +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"}
+{"version":3,"file":"schema.decorators.d.ts","sourceRoot":"","sources":["../../src/decorators/schema.decorators.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,cAAc,CAOhF"}

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

@@ -1 +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"}
+{"version":3,"file":"schema.decorators.js","sourceRoot":"","sources":["../../src/decorators/schema.decorators.ts"],"names":[],"mappings":";;AAEA,wBAOC;AATD,2CAAqE;AAErE,SAAgB,MAAM,CAAC,SAAkB,EAAE,WAAqB;IAC9D,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/decorators/utils.d.ts

@@ -9,7 +9,7 @@ export declare function getConstructorParamName(constructor: Function, index: nu
 export declare function splitParams(paramsStr: string): string[];
 /**
  * Helper to convert class name to kebab-case job name
- * MakeBetCommand -> make-bet
+ * PlaceOrderCommand -> place-order
  * ProcessPaymentCommand -> process-payment
  */
 export declare function deriveJobName(className: string, suffix: string): string;

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/decorators/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuBhG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBvD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,CAenE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/decorators/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuBhG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBvD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,CAuBnE"}

package/dist/decorators/utils.js

@@ -61,7 +61,7 @@ function splitParams(paramsStr) {
 }
 /**
  * Helper to convert class name to kebab-case job name
- * MakeBetCommand -> make-bet
+ * PlaceOrderCommand -> place-order
  * ProcessPaymentCommand -> process-payment
  */
 function deriveJobName(className, suffix) {
@@ -88,6 +88,10 @@ function getConstructorParamNames(target) {
         if (name)
             names.push(name);
     }
+    if (names.length > 1 && names.every((n) => n.length <= 2)) {
+        throw new Error(`Constructor parameter names for ${target.name} appear minified (${names.join(', ')}). ` +
+            `Ensure constructor parameter names are not minified.`);
+    }
     return names;
 }
 //# sourceMappingURL=utils.js.map

package/dist/decorators/utils.js.map

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

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

@@ -13,7 +13,7 @@ export interface IRedisConfig {
  * Retry policy configuration
  */
 export interface IRetryPolicy {
-    /** Maximum number of attempts (default: 3) */
+    /** Maximum number of attempts (default: 1 — strictly once) */
     maxAttempts?: number;
     /** Backoff strategy */
     backoff?: 'fixed' | 'exponential';
@@ -28,57 +28,120 @@ export interface IRetryPolicy {
 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;
     /** Default timeout in ms for enqueueAndWait on this entity type */
     replyTimeout?: number;
+    /** Behavior when a message is found in "dispatched" state on recovery */
+    onInterrupt?: 'dead-letter' | 'retry';
+    /** Idle timeout in ms before worker teardown (default: 30000) */
+    workerIdleTimeout?: number;
+    /** Max pending messages per entity worker (0 = unbounded, default: 0) */
+    workerMaxQueueDepth?: number;
 }
 /**
- * Executor pool configuration
+ * gRPC RPC deadline configuration (all values in milliseconds)
  */
-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;
-    /** Global default timeout in ms for enqueueAndWait (default: gateTTL * 2 * 1000) */
-    defaultReplyTimeout?: number;
+export interface IGrpcDeadlines {
+    /** Deadline for fire-and-forget RPCs: forward(), petition(), enqueueToWorker() (default: 1500) */
+    forwardMs?: number;
+    /** Deadline for ping() RPC (default: 1000) */
+    pingMs?: number;
+    /** Default deadline for AndWait server-side handlers when no per-entity replyTimeout is set (default: 60000) */
+    andWaitMs?: number;
+    /** Deadline for listWorkers() during master table rebuild (default: 1000) */
+    syncMs?: number;
+    /** Deadline for peer connectivity watch loop re-arm (default: 30000) */
+    connectivityWatchMs?: number;
 }
 /**
- * Distributed registry configuration (optional, for cross-service)
+ * gRPC inter-server communication configuration
  */
-export interface IRegistryConfig {
-    /** Enable the distributed registry (default: false) */
+export interface IGrpcConfig {
+    /** Enable gRPC transport (default: false) */
     enabled?: 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;
+    /** gRPC listen address (default: '0.0.0.0:50051') */
+    listenAddress?: string;
+    /** Advertised address for other servers (default: os.hostname() + ':50051') */
+    advertisedAddress?: string;
+    /** Unique server ID (default: auto-generated UUID) */
+    serverId?: string;
+    /** Replica group name — identifies which replicas run the same code */
+    serviceGroup?: string;
+    /** TLS configuration */
+    tls?: {
+        certPath: string;
+        keyPath: string;
+        caPath?: string;
+    };
+    /** Max forwarding hops to prevent loops (default: 3) */
+    maxForwardHops?: number;
+    /** Heartbeat interval in ms (default: 400) */
+    heartbeatMs?: number;
+    /** Node considered dead after this many ms without heartbeat (default: 1500) */
+    nodeTTLMs?: number;
+    /** Leader lock TTL in ms (default: 2000) */
+    leaderTTLMs?: number;
+    /** Leader lock renewal interval in ms (default: 400) */
+    leaderRenewalMs?: number;
+    /** Leader acquisition poll interval in ms (default: 400) */
+    leaderAcquisitionMs?: number;
+    /** gRPC keepalive ping interval in ms (default: 10000, minimum enforced by grpc-js) */
+    keepaliveTimeMs?: number;
+    /** gRPC keepalive timeout in ms — connection dead if no response (default: 5000) */
+    keepaliveTimeoutMs?: number;
+    /** Enable gRPC peer connectivity monitoring for fast failure detection (default: true when grpc.enabled) */
+    peerMonitorEnabled?: boolean;
+    /** Debounce window in ms before declaring a peer suspected-dead (default: 500) */
+    peerSuspectDebounceMs?: number;
+    /** Redis PING health check interval in ms (default: 500) */
+    redisHealthCheckMs?: number;
+    /** Consecutive Redis PING failures before declaring degraded mode (default: 3) */
+    redisHealthFailureThreshold?: number;
+    /** Reconciliation interval in ms — how often to SCAN Redis for node changes (default: 2000) */
+    reconcileIntervalMs?: number;
+    /** Max concurrent petitions the master will process (default: 50, 0 = unbounded) */
+    maxConcurrentPetitions?: number;
+    /** Debounce window in ms for leader recomputation after ring changes (default: 800) */
+    leaderDebounceMs?: number;
+    /** RPC deadline overrides */
+    deadlines?: IGrpcDeadlines;
+    /** Circuit breaker: consecutive failures before opening circuit (default: 3) */
+    circuitBreakerFailureThreshold?: number;
+    /** Circuit breaker: cooldown in ms before half-open probe (default: 2000) */
+    circuitBreakerCooldownMs?: number;
 }
 /**
- * Main module configuration
+ * Write-ahead log configuration
+ */
+export interface IWalConfig {
+    /** Enable WAL persistence (default: true) */
+    enabled?: boolean;
+    /** Cleanup batch interval in ms (default: 5000) */
+    cleanupInterval?: number;
+    /** Safety TTL for WAL entries in seconds (default: 86400 = 24h) */
+    entryTTL?: number;
+}
+/**
+ * Main module configuration — v3
  */
 export interface IAtomicQueuesModuleConfig {
     /** Redis connection configuration */
     redis: IRedisConfig;
-    /** 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;
+    /** gRPC inter-server communication */
+    grpc?: IGrpcConfig;
+    /** Write-ahead log persistence */
+    wal?: IWalConfig;
     /** Prefix for all Redis keys (default: 'aq') */
     keyPrefix?: string;
+    /** Maximum total active workers across all entity types (default: 10000, 0 = unbounded) */
+    maxTotalWorkers?: number;
+    /** Maximum total queued messages across all workers (default: 100000, 0 = unbounded) */
+    maxTotalQueueDepth?: number;
     /** Enable verbose logging */
     verbose?: boolean;
     /** Auto-register commands from @nestjs/cqrs handlers (default: true) */

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":"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,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;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;IAC7B,oFAAoF;IACpF,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"}
+{"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/index.d.ts

@@ -3,4 +3,5 @@ export * from './job.interfaces';
 export * from './cqrs.interfaces';
 export * from './utility.types';
 export * from './reply.types';
+export * from './registry.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,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,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;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/dist/domain/interfaces/index.js

@@ -19,4 +19,5 @@ __exportStar(require("./job.interfaces"), exports);
 __exportStar(require("./cqrs.interfaces"), exports);
 __exportStar(require("./utility.types"), exports);
 __exportStar(require("./reply.types"), exports);
+__exportStar(require("./registry.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,mDAAiC;AACjC,oDAAkC;AAClC,kDAAgC;AAChC,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,mDAAiC;AACjC,oDAAkC;AAClC,kDAAgC;AAChC,gDAA8B;AAC9B,mDAAiC"}

package/dist/{services/registry → domain/interfaces}/registry.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.types.d.ts","sourceRoot":"","sources":["../../../src/services/registry/registry.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B"}
+{"version":3,"file":"registry.types.d.ts","sourceRoot":"","sources":["../../../src/domain/interfaces/registry.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B"}

package/dist/domain/interfaces/registry.types.js.map

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

package/dist/grpc/grpc-client-pool.service.d.ts

@@ -0,0 +1,71 @@
+import { OnModuleInit, OnApplicationShutdown } from '@nestjs/common';
+import { IAtomicQueuesModuleConfig, ISerializedMessage, IMessageRef } from '../domain';
+/** Minimal shape of a gRPC client instance (from @grpc/grpc-js). */
+interface GrpcCallOptions {
+    deadline?: Date;
+}
+interface GrpcClientInstance {
+    forward(envelope: Record<string, unknown>, options: GrpcCallOptions, callback: (err: Error | null, response: Record<string, unknown>) => void): void;
+    forwardAndWait(envelope: Record<string, unknown>): GrpcClientStream;
+    ping(request: Record<string, unknown>, options: GrpcCallOptions, callback: (err: Error | null, response: Record<string, unknown>) => void): void;
+    close(): void;
+}
+/** Minimal shape of a gRPC readable stream (from @grpc/grpc-js). */
+interface GrpcClientStream {
+    on(event: 'data', listener: (response: Record<string, unknown>) => void): void;
+    on(event: 'error', listener: (err: Error) => void): void;
+    on(event: 'end', listener: () => void): void;
+}
+/**
+ * gRPC Client Pool — maintains connections to peer servers.
+ *
+ * Provides `forward()` and `forwardAndWait()` methods that the
+ * MessageRouter calls when an entity is owned by a remote server.
+ */
+export declare class GrpcClientPool implements OnModuleInit, OnApplicationShutdown {
+    private readonly config;
+    private readonly logger;
+    private readonly clients;
+    private readonly circuitBreakers;
+    private readonly failureThreshold;
+    private readonly cooldownMs;
+    private grpcModule;
+    private protoDescriptor;
+    constructor(config: IAtomicQueuesModuleConfig);
+    onModuleInit(): Promise<void>;
+    onApplicationShutdown(): Promise<void>;
+    /**
+     * Ensure the gRPC module is loaded (lazy, for optional dependency).
+     */
+    private ensureLoaded;
+    /**
+     * Get or create a client connection to a peer server.
+     */
+    private checkCircuit;
+    recordSuccess(serverId: string): void;
+    recordFailure(serverId: string): void;
+    openCircuit(serverId: string): void;
+    closeCircuit(serverId: string): void;
+    getClient(serverId: string, address: string): Promise<GrpcClientInstance>;
+    /**
+     * Forward a message to a remote server (fire-and-forget).
+     */
+    forward(serverId: string, address: string, message: ISerializedMessage, originServerId: string, hops: number, senderEpoch?: number): Promise<IMessageRef>;
+    /**
+     * Forward a message to a remote server and wait for the result.
+     */
+    forwardAndWait<R = unknown>(serverId: string, address: string, message: ISerializedMessage, originServerId: string, hops: number, timeout: number, senderEpoch?: number): Promise<R>;
+    /**
+     * Ping a peer server.
+     */
+    ping(serverId: string, address: string): Promise<{
+        healthy: boolean;
+        queueDepth: number;
+    }>;
+    /**
+     * Remove a client connection.
+     */
+    removeClient(serverId: string): void;
+}
+export {};
+//# sourceMappingURL=grpc-client-pool.service.d.ts.map

package/dist/grpc/grpc-client-pool.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc-client-pool.service.d.ts","sourceRoot":"","sources":["../../src/grpc/grpc-client-pool.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,YAAY,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGjG,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGvF,oEAAoE;AACpE,UAAU,eAAe;IACvB,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB;AACD,UAAU,kBAAkB;IAC1B,OAAO,CACL,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GACvE,IAAI,CAAC;IACR,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB,CAAC;IACpE,IAAI,CACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GACvE,IAAI,CAAC;IACR,KAAK,IAAI,IAAI,CAAC;CACf;AAED,oEAAoE;AACpE,UAAU,gBAAgB;IACxB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/E,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;IACzD,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAC9C;AA2CD;;;;;GAKG;AACH,qBACa,cAAe,YAAW,YAAY,EAAE,qBAAqB;IAS9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IARjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0C;IAC1E,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,eAAe,CAAgC;gBAEI,MAAM,EAAE,yBAAyB;IAKtF,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7B,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5C;;OAEG;YACW,YAAY;IAqB1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQrC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAcrC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUnC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQ9B,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA4B/E;;OAEG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,EAC3B,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,SAAI,GACd,OAAO,CAAC,WAAW,CAAC;IA0CvB;;OAEG;IACG,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,kBAAkB,EAC3B,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,WAAW,SAAI,GACd,OAAO,CAAC,CAAC,CAAC;IAmDb;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAuBhG;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAYrC"}