@nestjs-redisx/idempotency 1.5.1 → 1.6.1

package/dist/idempotency/api/filters/idempotency-exception.filter.d.ts

@@ -22,6 +22,7 @@ export declare class IdempotencyExceptionFilter implements ExceptionFilter {
      * - Reused key with a different request -> 422 Unprocessable Entity
      * - Concurrent request still in progress (timeout) -> 409 Conflict
      * - Previous request with the same key failed -> 409 Conflict
+     * - In-flight record vanished mid-wait -> 409 Conflict (retryable)
      * - Anything else (unexpected) -> 500 Internal Server Error
      */
     private resolveStatus;

package/dist/idempotency/api/filters/idempotency-exception.filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"idempotency-exception.filter.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/api/filters/idempotency-exception.filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,eAAe,EAAE,aAAa,EAAsB,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAqH,MAAM,wBAAwB,CAAC;AAE7K;;;;;;;;;GASG;AACH,qBACa,0BAA2B,YAAW,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,eAAe;IAElF,KAAK,CAAC,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;IAmB7D;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,YAAY;CAYrB"}
+{"version":3,"file":"idempotency-exception.filter.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/api/filters/idempotency-exception.filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,eAAe,EAAE,aAAa,EAAsB,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAqJ,MAAM,wBAAwB,CAAC;AAE7M;;;;;;;;;GASG;AACH,qBACa,0BAA2B,YAAW,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,eAAe;IAElF,KAAK,CAAC,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;IAmB7D;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,YAAY;CAYrB"}

package/dist/idempotency/api/interceptors/idempotency.interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"idempotency.interceptor.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/api/interceptors/idempotency.interceptor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAkB,MAAM,gBAAgB,CAAC;AAC5G,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAM,MAAM,MAAM,CAAC;AAKtC,OAAO,EAAE,yBAAyB,EAAsB,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AAGvF,qBACa,sBAAuB,YAAW,eAAe;IAI7B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IANvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;gBAGlB,kBAAkB,EAAE,mBAAmB,EAChC,MAAM,EAAE,yBAAyB,EAClD,SAAS,EAAE,SAAS,EACd,WAAW,EAAE,eAAe;IAGlE,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAkE3F,OAAO,CAAC,UAAU;YAIJ,UAAU;YAWV,mBAAmB;IAmBjC,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,cAAc;CAWvB"}
+{"version":3,"file":"idempotency.interceptor.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/api/interceptors/idempotency.interceptor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAkB,MAAM,gBAAgB,CAAC;AAC5G,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAM,MAAM,MAAM,CAAC;AAKtC,OAAO,EAAE,yBAAyB,EAAsB,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AAcvF,qBACa,sBAAuB,YAAW,eAAe;IAI7B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW;IANvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;gBAGlB,kBAAkB,EAAE,mBAAmB,EAChC,MAAM,EAAE,yBAAyB,EAClD,SAAS,EAAE,SAAS,EACd,WAAW,EAAE,eAAe;IAGlE,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAsF3F,OAAO,CAAC,UAAU;YAIJ,UAAU;YAgBV,mBAAmB;IAmBjC,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,cAAc;CAWvB"}

package/dist/idempotency/application/ports/idempotency-service.port.d.ts

@@ -26,7 +26,7 @@ export interface IIdempotencyService {
      * @param key - Idempotency key
      * @param error - Error message
      */
-    fail(key: string, error: string): Promise<void>;
+    fail(key: string, error: string, options?: IIdempotencyOptions): Promise<void>;
     /**
      * Get existing record by key.
      *

package/dist/idempotency/application/ports/idempotency-service.port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"idempotency-service.port.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/application/ports/idempotency-service.port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE/H;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;OAOG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEhH;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpG;;;;;OAKG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAErD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvC"}
+{"version":3,"file":"idempotency-service.port.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/application/ports/idempotency-service.port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE/H;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;OAOG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEhH;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpG;;;;;OAKG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/E;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAErD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvC"}

package/dist/idempotency/application/ports/idempotency-store.port.d.ts

@@ -12,6 +12,8 @@ export interface ICheckAndLockResult {
  * Data for completing a request
  */
 export interface ICompleteData {
+    /** Request fingerprint (persisted so replays keep matching after rewrites) */
+    fingerprint?: string;
     /** HTTP status code */
     statusCode: number;
     /** Response body (JSON string) */
@@ -33,7 +35,7 @@ export interface IIdempotencyStore {
      * @param lockTimeoutMs - Lock timeout in milliseconds
      * @returns Check result
      */
-    checkAndLock(key: string, fingerprint: string, lockTimeoutMs: number): Promise<ICheckAndLockResult>;
+    checkAndLock(key: string, fingerprint: string, lockTimeoutMs: number, validateFingerprint?: boolean): Promise<ICheckAndLockResult>;
     /**
      * Mark record as completed with response data.
      *
@@ -50,7 +52,7 @@ export interface IIdempotencyStore {
      * @param ttlSeconds - TTL in seconds after which the failed record expires,
      *   allowing a fresh attempt with the same key
      */
-    fail(key: string, error: string, ttlSeconds: number): Promise<void>;
+    fail(key: string, error: string, ttlSeconds: number, fingerprint?: string): Promise<void>;
     /**
      * Get record by key.
      *

package/dist/idempotency/application/ports/idempotency-store.port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"idempotency-store.port.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/application/ports/idempotency-store.port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,MAAM,EAAE,KAAK,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,sBAAsB,CAAC;IAE/E,uBAAuB;IACvB,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEpG;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9E;;;;;;;OAOG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAErD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvC"}
+{"version":3,"file":"idempotency-store.port.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/application/ports/idempotency-store.port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,MAAM,EAAE,KAAK,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,sBAAsB,CAAC;IAE/E,uBAAuB;IACvB,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEnI;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9E;;;;;;;OAOG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1F;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAErD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvC"}

package/dist/idempotency/application/services/idempotency.service.d.ts

@@ -16,9 +16,23 @@ export declare class IdempotencyService implements IIdempotencyService {
     checkAndLock(key: string, fingerprint: string, options?: IIdempotencyOptions): Promise<IIdempotencyCheckResult>;
     private recordDuration;
     complete(key: string, response: IIdempotencyResponse, options?: IIdempotencyOptions): Promise<void>;
-    fail(key: string, error: string): Promise<void>;
+    fail(key: string, error: string, options?: IIdempotencyOptions): Promise<void>;
     get(key: string): Promise<IIdempotencyRecord | null>;
     delete(key: string): Promise<boolean>;
+    /**
+     * Polls until the in-flight attempt completes or fails, bounded by
+     * waitTimeout.
+     *
+     * If the processing record VANISHES (the first attempt died between
+     * checkAndLock and complete, so its lock TTL expired), the waiter attempts
+     * an atomic takeover via checkAndLock: the winner returns 'takeover' (the
+     * caller executes the handler itself), losers keep waiting on the new
+     * owner's record. This turns a dead first attempt into a self-healing
+     * retry instead of surfacing an unexplained error to every waiter.
+     *
+     * @returns the completed/failed record to replay, or 'takeover' when this
+     *          caller now owns the key and must execute the request
+     */
     private waitForCompletion;
     private buildKey;
     private sleep;

package/dist/idempotency/application/services/idempotency.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"idempotency.service.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/application/services/idempotency.service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC1J,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAKpE,UAAU,eAAe;IACvB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CACtF;AAED;;GAEG;AACH,qBACa,kBAAmB,YAAW,mBAAmB;IAG1D,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACe,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAH7C,MAAM,EAAE,yBAAyB,EAEjC,KAAK,EAAE,iBAAiB,EACa,OAAO,CAAC,EAAE,eAAe,YAAA;IAG3E,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAiCzH,OAAO,CAAC,cAAc;IAKhB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAKpD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAK7B,iBAAiB;IAoB/B,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,KAAK;CAGd"}
+{"version":3,"file":"idempotency.service.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/application/services/idempotency.service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC1J,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAKpE,UAAU,eAAe;IACvB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CACtF;AAED;;GAEG;AACH,qBACa,kBAAmB,YAAW,mBAAmB;IAG1D,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACe,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAH7C,MAAM,EAAE,yBAAyB,EAEjC,KAAK,EAAE,iBAAiB,EACa,OAAO,CAAC,EAAE,eAAe,YAAA;IAG3E,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA2CzH,OAAO,CAAC,cAAc;IAKhB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBvG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAKpD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3C;;;;;;;;;;;;;OAaG;YACW,iBAAiB;IA+B/B,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,KAAK;CAGd"}

package/dist/idempotency/infrastructure/adapters/redis-idempotency-store.adapter.d.ts

@@ -13,9 +13,9 @@ export declare class RedisIdempotencyStoreAdapter implements IIdempotencyStore,
      * Pre-load Lua script on module initialization
      */
     onModuleInit(): Promise<void>;
-    checkAndLock(key: string, fingerprint: string, lockTimeoutMs: number): Promise<ICheckAndLockResult>;
+    checkAndLock(key: string, fingerprint: string, lockTimeoutMs: number, validateFingerprint?: boolean): Promise<ICheckAndLockResult>;
     complete(key: string, data: ICompleteData, ttlSeconds: number): Promise<void>;
-    fail(key: string, error: string, ttlSeconds: number): Promise<void>;
+    fail(key: string, error: string, ttlSeconds: number, fingerprint?: string): Promise<void>;
     get(key: string): Promise<IIdempotencyRecord | null>;
     delete(key: string): Promise<boolean>;
 }

package/dist/idempotency/infrastructure/adapters/redis-idempotency-store.adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis-idempotency-store.adapter.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/infrastructure/adapters/redis-idempotency-store.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gDAAgD,CAAC;AAGvH;;GAEG;AACH,qBACa,4BAA6B,YAAW,iBAAiB,EAAE,YAAY;IAGpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFrE,OAAO,CAAC,eAAe,CAAuB;gBAEiB,MAAM,EAAE,YAAY;IAEnF;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAqCnG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7E,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAmBpD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAI5C"}
+{"version":3,"file":"redis-idempotency-store.adapter.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/infrastructure/adapters/redis-idempotency-store.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gDAAgD,CAAC;AAGvH;;GAEG;AACH,qBACa,4BAA6B,YAAW,iBAAiB,EAAE,YAAY;IAGpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFrE,OAAO,CAAC,eAAe,CAAuB;gBAEiB,MAAM,EAAE,YAAY;IAEnF;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,mBAAmB,UAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAqC/H,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB7E,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAezF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAmBpD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAI5C"}

package/dist/idempotency/infrastructure/scripts/lua-scripts.d.ts

@@ -13,6 +13,7 @@
  * ARGV[1] = fingerprint
  * ARGV[2] = lock timeout (ms)
  * ARGV[3] = current timestamp (ms)
+ * ARGV[4] = validate fingerprint flag ('1' = compare fingerprints, '0' = skip)
  *
  * Returns:
  * - ['new'] - new request, lock acquired

package/dist/idempotency/infrastructure/scripts/lua-scripts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lua-scripts.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/infrastructure/scripts/lua-scripts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,QAuD1B,CAAC"}
+{"version":3,"file":"lua-scripts.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/infrastructure/scripts/lua-scripts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,qBAAqB,QAwD1B,CAAC"}

package/dist/idempotency.plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"idempotency.plugin.d.ts","sourceRoot":"","sources":["../src/idempotency.plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAoE,MAAM,qBAAqB,CAAC;AAQ3I,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAa3D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAOzC,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAW;IACnC,QAAQ,CAAC,WAAW,0EAA0E;IAE9F,OAAO,CAAC,YAAY,CAAC,CAAiD;gBAEzC,OAAO,GAAE,yBAA8B;IAEpE,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,mBAAmB,CAAC,yBAAyB,CAAC,GAAG,iBAAiB;IAMrG,OAAO,CAAC,MAAM,CAAC,aAAa;IAe5B,UAAU,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,aAAa,GAAG,gBAAgB,CAAC;IAIrE,YAAY,IAAI,QAAQ,EAAE;IAyC1B,UAAU,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;CAGhD"}
+{"version":3,"file":"idempotency.plugin.d.ts","sourceRoot":"","sources":["../src/idempotency.plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEjF,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAoE,MAAM,qBAAqB,CAAC;AAS3I,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAa3D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAOzC,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAW;IACnC,QAAQ,CAAC,WAAW,0EAA0E;IAE9F,OAAO,CAAC,YAAY,CAAC,CAAiD;gBAEzC,OAAO,GAAE,yBAA8B;IAEpE,MAAM,CAAC,aAAa,CAAC,YAAY,EAAE,mBAAmB,CAAC,yBAAyB,CAAC,GAAG,iBAAiB;IAMrG,OAAO,CAAC,MAAM,CAAC,aAAa;IA0B5B,UAAU,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,aAAa,GAAG,gBAAgB,CAAC;IAIrE,YAAY,IAAI,QAAQ,EAAE;IAyC1B,UAAU,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;CAGhD"}

package/dist/index.d.ts

@@ -5,6 +5,6 @@ export type { IIdempotencyStore } from './idempotency/application/ports/idempote
 export { Idempotent, type IIdempotentOptions, IDEMPOTENT_OPTIONS } from './idempotency/api/decorators/idempotent.decorator';
 export { IdempotencyInterceptor } from './idempotency/api/interceptors/idempotency.interceptor';
 export type { IIdempotencyPluginOptions, IIdempotencyRecord, IIdempotencyCheckResult, IIdempotencyResponse, IIdempotencyOptions } from './shared/types';
-export { IdempotencyError, IdempotencyKeyRequiredError, IdempotencyFingerprintMismatchError, IdempotencyTimeoutError, IdempotencyFailedError, IdempotencyRecordNotFoundError } from './shared/errors';
+export { IdempotencyError, IdempotencyKeyRequiredError, IdempotencyFingerprintMismatchError, IdempotencyTimeoutError, IdempotencyFailedError, IdempotencyRecordNotFoundError, IdempotencyConfigError } from './shared/errors';
 export { IDEMPOTENCY_PLUGIN_OPTIONS, IDEMPOTENCY_REDIS_DRIVER, IDEMPOTENCY_SERVICE, IDEMPOTENCY_STORE } from './shared/constants';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAC;AAG5F,YAAY,EAAE,mBAAmB,EAAE,MAAM,0DAA0D,CAAC;AACpG,YAAY,EAAE,iBAAiB,EAAE,MAAM,wDAAwD,CAAC;AAGhG,OAAO,EAAE,UAAU,EAAE,KAAK,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAG5H,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAGhG,YAAY,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGxJ,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,mCAAmC,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AAGtM,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAC;AAG5F,YAAY,EAAE,mBAAmB,EAAE,MAAM,0DAA0D,CAAC;AACpG,YAAY,EAAE,iBAAiB,EAAE,MAAM,wDAAwD,CAAC;AAGhG,OAAO,EAAE,UAAU,EAAE,KAAK,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAG5H,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAGhG,YAAY,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGxJ,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,mCAAmC,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAG9N,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -18,7 +18,7 @@ var __decorateClass = (decorators, target, key, kind) => {
 var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
 
 // package.json
-var version = "1.5.0";
+var version = "1.6.1";
 var IdempotencyError = class extends core$1.RedisXError {
   constructor(message, code, idempotencyKey, cause) {
     super(message, code, cause, { idempotencyKey });
@@ -50,6 +50,11 @@ var IdempotencyRecordNotFoundError = class extends IdempotencyError {
     super(`Idempotency record not found for key "${key}"`, core$1.ErrorCode.OP_KEY_NOT_FOUND, key);
   }
 };
+var IdempotencyConfigError = class extends IdempotencyError {
+  constructor(message) {
+    super(message, core$1.ErrorCode.CFG_INVALID, "");
+  }
+};
 
 // src/idempotency/api/filters/idempotency-exception.filter.ts
 var IdempotencyExceptionFilter = class {
@@ -78,6 +83,7 @@ var IdempotencyExceptionFilter = class {
    * - Reused key with a different request -> 422 Unprocessable Entity
    * - Concurrent request still in progress (timeout) -> 409 Conflict
    * - Previous request with the same key failed -> 409 Conflict
+   * - In-flight record vanished mid-wait -> 409 Conflict (retryable)
    * - Anything else (unexpected) -> 500 Internal Server Error
    */
   resolveStatus(exception) {
@@ -93,6 +99,9 @@ var IdempotencyExceptionFilter = class {
     if (exception instanceof IdempotencyFailedError) {
       return common.HttpStatus.CONFLICT;
     }
+    if (exception instanceof IdempotencyRecordNotFoundError) {
+      return common.HttpStatus.CONFLICT;
+    }
     return common.HttpStatus.INTERNAL_SERVER_ERROR;
   }
   reasonPhrase(status) {
@@ -124,6 +133,7 @@ function Idempotent(options = {}) {
 }
 
 // src/idempotency/api/interceptors/idempotency.interceptor.ts
+var IDEMPOTENCY_HANDLED = /* @__PURE__ */ Symbol("redisx.idempotencyHandled");
 exports.IdempotencyInterceptor = class IdempotencyInterceptor {
   constructor(idempotencyService, config, reflector, adapterHost) {
     this.idempotencyService = idempotencyService;
@@ -133,6 +143,10 @@ exports.IdempotencyInterceptor = class IdempotencyInterceptor {
   }
   logger = new common.Logger(exports.IdempotencyInterceptor.name);
   async intercept(context, next) {
+    const request = context.switchToHttp().getRequest();
+    if (request[IDEMPOTENCY_HANDLED]) {
+      return next.handle();
+    }
     const options = this.getOptions(context);
     const response = context.switchToHttp().getResponse();
     const key = await this.extractKey(context, options);
@@ -142,11 +156,13 @@ exports.IdempotencyInterceptor = class IdempotencyInterceptor {
     if (options.skip && await options.skip(context)) {
       return next.handle();
     }
+    request[IDEMPOTENCY_HANDLED] = true;
     const fingerprint = await this.generateFingerprint(context, options);
     let checkResult;
     try {
       checkResult = await this.idempotencyService.checkAndLock(key, fingerprint, {
-        ttl: options.ttl
+        ttl: options.ttl,
+        validateFingerprint: options.validateFingerprint
       });
     } catch (error) {
       if ((this.config.errorPolicy ?? "fail-closed") === "fail-open") {
@@ -168,18 +184,24 @@ exports.IdempotencyInterceptor = class IdempotencyInterceptor {
     return next.handle().pipe(
       operators.tap({
         next: (data) => {
-          void this.idempotencyService.complete(
-            key,
-            {
-              statusCode: response.statusCode,
-              body: data,
-              headers: this.extractHeaders(response, options)
-            },
-            { ttl: options.ttl }
-          );
+          Promise.resolve(
+            this.idempotencyService.complete(
+              key,
+              {
+                statusCode: response.statusCode,
+                body: data,
+                headers: this.extractHeaders(response, options)
+              },
+              { ttl: options.ttl, fingerprint }
+            )
+          ).catch((err) => {
+            this.logger.error(`Failed to persist idempotency completion for key "${key}": ${err.message}`);
+          });
         },
         error: (error) => {
-          void this.idempotencyService.fail(key, error.message);
+          Promise.resolve(this.idempotencyService.fail(key, error.message, { fingerprint })).catch((err) => {
+            this.logger.error(`Failed to persist idempotency failure for key "${key}": ${err.message}`);
+          });
         }
       })
     );
@@ -193,7 +215,11 @@ exports.IdempotencyInterceptor = class IdempotencyInterceptor {
     }
     const request = context.switchToHttp().getRequest();
     const headerName = this.config.headerName ?? "Idempotency-Key";
-    return request.headers[headerName.toLowerCase()] ?? null;
+    const value = request.headers[headerName.toLowerCase()];
+    if (Array.isArray(value)) {
+      return value[0] ?? null;
+    }
+    return value ?? null;
   }
   async generateFingerprint(context, options) {
     if (this.config.fingerprintGenerator) {
@@ -261,7 +287,8 @@ exports.IdempotencyService = class IdempotencyService {
     const startTime = Date.now();
     const fullKey = this.buildKey(key);
     const lockTimeout = options.lockTimeout ?? this.config.lockTimeout ?? 3e4;
-    const result = await this.store.checkAndLock(fullKey, fingerprint, lockTimeout);
+    const validateFingerprint = options.validateFingerprint ?? this.config.validateFingerprint ?? true;
+    const result = await this.store.checkAndLock(fullKey, fingerprint, lockTimeout, validateFingerprint);
     if (result.status === "new") {
       this.metrics?.incrementCounter("redisx_idempotency_requests_total", { status: "new" });
       this.recordDuration(startTime);
@@ -273,10 +300,15 @@ exports.IdempotencyService = class IdempotencyService {
       return { isNew: false, fingerprintMismatch: true };
     }
     if (result.status === "processing") {
-      const record = await this.waitForCompletion(fullKey);
+      const outcome = await this.waitForCompletion(fullKey, fingerprint, lockTimeout, validateFingerprint);
+      if (outcome === "takeover") {
+        this.metrics?.incrementCounter("redisx_idempotency_requests_total", { status: "takeover" });
+        this.recordDuration(startTime);
+        return { isNew: true };
+      }
       this.metrics?.incrementCounter("redisx_idempotency_requests_total", { status: "replay" });
       this.recordDuration(startTime);
-      return { isNew: false, record };
+      return { isNew: false, record: outcome };
     }
     this.metrics?.incrementCounter("redisx_idempotency_requests_total", { status: "replay" });
     this.recordDuration(startTime);
@@ -292,6 +324,7 @@ exports.IdempotencyService = class IdempotencyService {
     await this.store.complete(
       fullKey,
       {
+        fingerprint: options.fingerprint,
         statusCode: response.statusCode,
         response: JSON.stringify(response.body),
         headers: response.headers ? JSON.stringify(response.headers) : void 0,
@@ -300,10 +333,10 @@ exports.IdempotencyService = class IdempotencyService {
       ttl
     );
   }
-  async fail(key, error) {
+  async fail(key, error, options = {}) {
     const fullKey = this.buildKey(key);
     const ttlSeconds = Math.ceil((this.config.lockTimeout ?? 3e4) / 1e3);
-    await this.store.fail(fullKey, error, ttlSeconds);
+    await this.store.fail(fullKey, error, ttlSeconds, options.fingerprint);
   }
   async get(key) {
     const fullKey = this.buildKey(key);
@@ -313,15 +346,37 @@ exports.IdempotencyService = class IdempotencyService {
     const fullKey = this.buildKey(key);
     return this.store.delete(fullKey);
   }
-  async waitForCompletion(key) {
+  /**
+   * Polls until the in-flight attempt completes or fails, bounded by
+   * waitTimeout.
+   *
+   * If the processing record VANISHES (the first attempt died between
+   * checkAndLock and complete, so its lock TTL expired), the waiter attempts
+   * an atomic takeover via checkAndLock: the winner returns 'takeover' (the
+   * caller executes the handler itself), losers keep waiting on the new
+   * owner's record. This turns a dead first attempt into a self-healing
+   * retry instead of surfacing an unexplained error to every waiter.
+   *
+   * @returns the completed/failed record to replay, or 'takeover' when this
+   *          caller now owns the key and must execute the request
+   */
+  async waitForCompletion(key, fingerprint, lockTimeoutMs, validateFingerprint) {
     const waitTimeout = this.config.waitTimeout ?? 6e4;
     const startTime = Date.now();
     while (Date.now() - startTime < waitTimeout) {
       const record = await this.store.get(key);
       if (!record) {
-        throw new IdempotencyRecordNotFoundError(key);
-      }
-      if (record.status === "completed" || record.status === "failed") {
+        const retry = await this.store.checkAndLock(key, fingerprint, lockTimeoutMs, validateFingerprint);
+        if (retry.status === "new") {
+          return "takeover";
+        }
+        if (retry.status === "completed" || retry.status === "failed") {
+          return retry.record;
+        }
+        if (retry.status === "fingerprint_mismatch") {
+          throw new IdempotencyFingerprintMismatchError(key);
+        }
+      } else if (record.status === "completed" || record.status === "failed") {
         return record;
       }
       await this.sleep(POLL_INTERVAL_MS);
@@ -350,6 +405,7 @@ local key = KEYS[1]
 local fingerprint = ARGV[1]
 local lock_timeout = tonumber(ARGV[2])
 local now = tonumber(ARGV[3])
+local validate = ARGV[4] ~= '0'
 
 -- Check if key exists
 local existing = redis.call('HGETALL', key)
@@ -371,8 +427,8 @@ for i = 1, #existing, 2 do
   record[existing[i]] = existing[i + 1]
 end
 
--- Check fingerprint
-if record.fingerprint ~= fingerprint then
+-- Check fingerprint (skipped when validateFingerprint is disabled)
+if validate and record.fingerprint ~= fingerprint then
   return {'fingerprint_mismatch'}
 end
 
@@ -414,9 +470,9 @@ var RedisIdempotencyStoreAdapter = class {
   async onModuleInit() {
     this.checkAndLockSha = await this.driver.scriptLoad(CHECK_AND_LOCK_SCRIPT);
   }
-  async checkAndLock(key, fingerprint, lockTimeoutMs) {
+  async checkAndLock(key, fingerprint, lockTimeoutMs, validateFingerprint = true) {
     const now = Date.now();
-    const rawResult = await this.driver.evalsha(this.checkAndLockSha, [key], [fingerprint, lockTimeoutMs, now]);
+    const rawResult = await this.driver.evalsha(this.checkAndLockSha, [key], [fingerprint, lockTimeoutMs, now, validateFingerprint ? "1" : "0"]);
     const result = rawResult.map((v) => v === null || v === void 0 ? "" : String(v));
     const status = result[0];
     if (status === "new") {
@@ -444,21 +500,29 @@ var RedisIdempotencyStoreAdapter = class {
     };
   }
   async complete(key, data, ttlSeconds) {
-    await this.driver.hmset(key, {
+    const fields = {
       status: "completed",
       statusCode: String(data.statusCode),
       response: data.response,
       headers: data.headers || "",
       completedAt: String(data.completedAt)
-    });
+    };
+    if (data.fingerprint) {
+      fields.fingerprint = data.fingerprint;
+    }
+    await this.driver.hmset(key, fields);
     await this.driver.expire(key, ttlSeconds);
   }
-  async fail(key, error, ttlSeconds) {
-    await this.driver.hmset(key, {
+  async fail(key, error, ttlSeconds, fingerprint) {
+    const fields = {
       status: "failed",
       error,
       completedAt: String(Date.now())
-    });
+    };
+    if (fingerprint) {
+      fields.fingerprint = fingerprint;
+    }
+    await this.driver.hmset(key, fields);
     await this.driver.expire(key, ttlSeconds);
   }
   async get(key) {
@@ -468,12 +532,12 @@ var RedisIdempotencyStoreAdapter = class {
     }
     return {
       key,
-      fingerprint: data.fingerprint,
+      fingerprint: data.fingerprint ?? "",
       status: data.status,
       statusCode: data.statusCode ? parseInt(data.statusCode, 10) : void 0,
       response: data.response || void 0,
       headers: data.headers || void 0,
-      startedAt: parseInt(data.startedAt, 10),
+      startedAt: data.startedAt ? parseInt(data.startedAt, 10) : 0,
       completedAt: data.completedAt ? parseInt(data.completedAt, 10) : void 0,
       error: data.error || void 0
     };
@@ -513,7 +577,7 @@ var IdempotencyPlugin = class _IdempotencyPlugin {
     return plugin;
   }
   static mergeDefaults(options) {
-    return {
+    const merged = {
       client: options.client,
       defaultTtl: options.defaultTtl ?? DEFAULT_IDEMPOTENCY_CONFIG.defaultTtl,
       keyPrefix: options.keyPrefix ?? DEFAULT_IDEMPOTENCY_CONFIG.keyPrefix,
@@ -525,6 +589,13 @@ var IdempotencyPlugin = class _IdempotencyPlugin {
       errorPolicy: options.errorPolicy ?? DEFAULT_IDEMPOTENCY_CONFIG.errorPolicy,
       fingerprintGenerator: options.fingerprintGenerator
     };
+    for (const knob of ["defaultTtl", "lockTimeout", "waitTimeout"]) {
+      const value = merged[knob];
+      if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        throw new IdempotencyConfigError(`${knob} must be a positive number (got ${String(value)})`);
+      }
+    }
+    return merged;
   }
   getImports() {
     return this.asyncOptions?.imports ?? [];
@@ -576,6 +647,7 @@ exports.IDEMPOTENCY_REDIS_DRIVER = IDEMPOTENCY_REDIS_DRIVER;
 exports.IDEMPOTENCY_SERVICE = IDEMPOTENCY_SERVICE;
 exports.IDEMPOTENCY_STORE = IDEMPOTENCY_STORE;
 exports.IDEMPOTENT_OPTIONS = IDEMPOTENT_OPTIONS;
+exports.IdempotencyConfigError = IdempotencyConfigError;
 exports.IdempotencyError = IdempotencyError;
 exports.IdempotencyFailedError = IdempotencyFailedError;
 exports.IdempotencyFingerprintMismatchError = IdempotencyFingerprintMismatchError;