@nestjs-redisx/idempotency 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NestJS RedisX Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/nestjs-redisx/nestjs-redisx/main/website/public/images/logo.png" alt="NestJS RedisX" />
+</p>
+
+# @nestjs-redisx/idempotency
+
+[![npm](https://img.shields.io/npm/v/@nestjs-redisx/idempotency)](https://www.npmjs.com/package/@nestjs-redisx/idempotency)
+[![npm downloads](https://img.shields.io/npm/dm/@nestjs-redisx/idempotency)](https://www.npmjs.com/package/@nestjs-redisx/idempotency)
+[![license](https://img.shields.io/npm/l/@nestjs-redisx/idempotency)](https://opensource.org/licenses/MIT)
+
+HTTP idempotency plugin for NestJS RedisX. Prevents duplicate request processing using the `@Idempotent` decorator with fingerprint validation and automatic response replay.
+
+## Installation
+
+```bash
+npm install @nestjs-redisx/core @nestjs-redisx/idempotency ioredis
+```
+
+## Quick Example
+
+```typescript
+import { RedisModule } from '@nestjs-redisx/core';
+import { IdempotencyPlugin, Idempotent } from '@nestjs-redisx/idempotency';
+
+@Module({
+  imports: [
+    RedisModule.forRoot({
+      clients: { host: 'localhost', port: 6379 },
+      plugins: [new IdempotencyPlugin({ defaultTtl: 86400 })],
+    }),
+  ],
+})
+export class AppModule {}
+
+@Controller('payments')
+export class PaymentsController {
+  @Post()
+  @Idempotent({ ttl: 3600 })
+  async createPayment(@Body() dto: CreatePaymentDto) {
+    // Executes once per Idempotency-Key header, replays cached response after
+    return this.paymentsService.create(dto);
+  }
+}
+```
+
+## Documentation
+
+Full documentation: [nestjs-redisx.dev/en/reference/idempotency/](https://nestjs-redisx.dev/en/reference/idempotency/)
+
+## License
+
+MIT

package/dist/idempotency/api/decorators/idempotent.decorator.d.ts

@@ -0,0 +1,12 @@
+import { ExecutionContext } from '@nestjs/common';
+export declare const IDEMPOTENT_OPTIONS: unique symbol;
+export interface IIdempotentOptions {
+    ttl?: number;
+    keyExtractor?: (context: ExecutionContext) => string | Promise<string>;
+    fingerprintFields?: ('method' | 'path' | 'body' | 'query')[];
+    validateFingerprint?: boolean;
+    cacheHeaders?: string[];
+    skip?: (context: ExecutionContext) => boolean | Promise<boolean>;
+}
+export declare function Idempotent(options?: IIdempotentOptions): MethodDecorator;
+//# sourceMappingURL=idempotent.decorator.d.ts.map

package/dist/idempotency/api/decorators/idempotent.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotent.decorator.d.ts","sourceRoot":"","sources":["../../../../src/idempotency/api/decorators/idempotent.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIjG,eAAO,MAAM,kBAAkB,eAAmC,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,iBAAiB,CAAC,EAAE,CAAC,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;IAC7D,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAClE;AAED,wBAAgB,UAAU,CAAC,OAAO,GAAE,kBAAuB,GAAG,eAAe,CAE5E"}

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

@@ -0,0 +1,19 @@
+import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { Reflector } from '@nestjs/core';
+import { Observable } from 'rxjs';
+import { IIdempotencyPluginOptions } from '../../../shared/types';
+import { IIdempotencyService } from '../../application/ports/idempotency-service.port';
+export declare class IdempotencyInterceptor implements NestInterceptor {
+    private readonly idempotencyService;
+    private readonly config;
+    private readonly reflector;
+    constructor(idempotencyService: IIdempotencyService, config: IIdempotencyPluginOptions, reflector: Reflector);
+    intercept(context: ExecutionContext, next: CallHandler): Promise<Observable<unknown>>;
+    private getOptions;
+    private extractKey;
+    private generateFingerprint;
+    private hash;
+    private replayResponse;
+    private extractHeaders;
+}
+//# sourceMappingURL=idempotency.interceptor.d.ts.map

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

@@ -0,0 +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,EAAU,MAAM,gBAAgB,CAAC;AACpG,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAM,MAAM,MAAM,CAAC;AAKtC,OAAO,EAAE,yBAAyB,EAAsB,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AAavF,qBACa,sBAAuB,YAAW,eAAe;IAE7B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFC,kBAAkB,EAAE,mBAAmB,EAChC,MAAM,EAAE,yBAAyB,EAClD,SAAS,EAAE,SAAS;IAGpD,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAsD3F,OAAO,CAAC,UAAU;YAIJ,UAAU;YAWV,mBAAmB;IAmBjC,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,cAAc;IActB,OAAO,CAAC,cAAc;CAWvB"}

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

@@ -0,0 +1,45 @@
+import { IIdempotencyRecord, IIdempotencyCheckResult, IIdempotencyResponse, IIdempotencyOptions } from '../../../shared/types';
+/**
+ * Service port for idempotency operations
+ */
+export interface IIdempotencyService {
+    /**
+     * Check if key exists and acquire lock if not.
+     *
+     * @param key - Idempotency key
+     * @param fingerprint - Request fingerprint hash
+     * @param options - Operation options
+     * @returns Check result with isNew flag and optional record
+     */
+    checkAndLock(key: string, fingerprint: string, options?: IIdempotencyOptions): Promise<IIdempotencyCheckResult>;
+    /**
+     * Store successful response.
+     *
+     * @param key - Idempotency key
+     * @param response - Response to store
+     * @param options - Operation options
+     */
+    complete(key: string, response: IIdempotencyResponse, options?: IIdempotencyOptions): Promise<void>;
+    /**
+     * Mark request as failed.
+     *
+     * @param key - Idempotency key
+     * @param error - Error message
+     */
+    fail(key: string, error: string): Promise<void>;
+    /**
+     * Get existing record by key.
+     *
+     * @param key - Idempotency key
+     * @returns Record or null if not found
+     */
+    get(key: string): Promise<IIdempotencyRecord | null>;
+    /**
+     * Delete record (for testing/admin).
+     *
+     * @param key - Idempotency key
+     * @returns True if deleted, false if not found
+     */
+    delete(key: string): Promise<boolean>;
+}
+//# sourceMappingURL=idempotency-service.port.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,67 @@
+import { IIdempotencyRecord } from '../../../shared/types';
+/**
+ * Result of check and lock operation
+ */
+export interface ICheckAndLockResult {
+    /** Status of the check */
+    status: 'new' | 'processing' | 'completed' | 'failed' | 'fingerprint_mismatch';
+    /** Record if exists */
+    record?: IIdempotencyRecord;
+}
+/**
+ * Data for completing a request
+ */
+export interface ICompleteData {
+    /** HTTP status code */
+    statusCode: number;
+    /** Response body (JSON string) */
+    response: string;
+    /** Response headers (JSON string) */
+    headers?: string;
+    /** Completion timestamp (ms) */
+    completedAt: number;
+}
+/**
+ * Store port for Redis operations
+ */
+export interface IIdempotencyStore {
+    /**
+     * Atomic check and lock operation using Lua script.
+     *
+     * @param key - Redis key
+     * @param fingerprint - Request fingerprint hash
+     * @param lockTimeoutMs - Lock timeout in milliseconds
+     * @returns Check result
+     */
+    checkAndLock(key: string, fingerprint: string, lockTimeoutMs: number): Promise<ICheckAndLockResult>;
+    /**
+     * Mark record as completed with response data.
+     *
+     * @param key - Redis key
+     * @param data - Completion data
+     * @param ttlSeconds - TTL in seconds
+     */
+    complete(key: string, data: ICompleteData, ttlSeconds: number): Promise<void>;
+    /**
+     * Mark record as failed.
+     *
+     * @param key - Redis key
+     * @param error - Error message
+     */
+    fail(key: string, error: string): Promise<void>;
+    /**
+     * Get record by key.
+     *
+     * @param key - Redis key
+     * @returns Record or null if not found
+     */
+    get(key: string): Promise<IIdempotencyRecord | null>;
+    /**
+     * Delete record.
+     *
+     * @param key - Redis key
+     * @returns True if deleted, false if not found
+     */
+    delete(key: string): Promise<boolean>;
+}
+//# sourceMappingURL=idempotency-store.port.d.ts.map

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

@@ -0,0 +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;;;;;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"}

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

@@ -0,0 +1,27 @@
+import { IIdempotencyPluginOptions, IIdempotencyRecord, IIdempotencyCheckResult, IIdempotencyResponse, IIdempotencyOptions } from '../../../shared/types';
+import { IIdempotencyService } from '../ports/idempotency-service.port';
+import { IIdempotencyStore } from '../ports/idempotency-store.port';
+interface IMetricsService {
+    incrementCounter(name: string, labels?: Record<string, string>, value?: number): void;
+    observeHistogram(name: string, value: number, labels?: Record<string, string>): void;
+}
+/**
+ * Idempotency service implementation
+ */
+export declare class IdempotencyService implements IIdempotencyService {
+    private readonly config;
+    private readonly store;
+    private readonly metrics?;
+    constructor(config: IIdempotencyPluginOptions, store: IIdempotencyStore, metrics?: IMetricsService | undefined);
+    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>;
+    get(key: string): Promise<IIdempotencyRecord | null>;
+    delete(key: string): Promise<boolean>;
+    private waitForCompletion;
+    private buildKey;
+    private sleep;
+}
+export {};
+//# sourceMappingURL=idempotency.service.d.ts.map

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

@@ -0,0 +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;IAK/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"}

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

@@ -0,0 +1,22 @@
+import { OnModuleInit } from '@nestjs/common';
+import { IRedisDriver } from '@nestjs-redisx/core';
+import { IIdempotencyRecord } from '../../../shared/types';
+import { IIdempotencyStore, ICheckAndLockResult, ICompleteData } from '../../application/ports/idempotency-store.port';
+/**
+ * Redis-based idempotency store implementation
+ */
+export declare class RedisIdempotencyStoreAdapter implements IIdempotencyStore, OnModuleInit {
+    private readonly driver;
+    private checkAndLockSha;
+    constructor(driver: IRedisDriver);
+    /**
+     * Pre-load Lua script on module initialization
+     */
+    onModuleInit(): Promise<void>;
+    checkAndLock(key: string, fingerprint: string, lockTimeoutMs: number): Promise<ICheckAndLockResult>;
+    complete(key: string, data: ICompleteData, ttlSeconds: number): Promise<void>;
+    fail(key: string, error: string): Promise<void>;
+    get(key: string): Promise<IIdempotencyRecord | null>;
+    delete(key: string): Promise<boolean>;
+}
+//# sourceMappingURL=redis-idempotency-store.adapter.d.ts.map

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

@@ -0,0 +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,EAAgB,MAAM,qBAAqB,CAAC;AAEjE,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;IAGhD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFzD,OAAO,CAAC,eAAe,CAAuB;gBAEK,MAAM,EAAE,YAAY;IAEvE;;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,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C,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

@@ -0,0 +1,24 @@
+/**
+ * Inline Lua scripts for idempotency operations.
+ *
+ * Scripts are stored as inline strings to avoid issues with file reading
+ * after build (dist directory doesn't contain .lua files).
+ */
+/**
+ * Check and Lock Lua script for idempotency
+ *
+ * This script atomically checks if an idempotency key exists and locks it if new.
+ *
+ * KEYS[1] = idempotency key
+ * ARGV[1] = fingerprint
+ * ARGV[2] = lock timeout (ms)
+ * ARGV[3] = current timestamp (ms)
+ *
+ * Returns:
+ * - ['new'] - new request, lock acquired
+ * - ['fingerprint_mismatch'] - same key, different fingerprint
+ * - ['processing'] - another request is processing
+ * - [status, statusCode, response, headers, error] - completed/failed record
+ */
+export declare const CHECK_AND_LOCK_SCRIPT: string;
+//# sourceMappingURL=lua-scripts.d.ts.map

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

@@ -0,0 +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"}

package/dist/idempotency.plugin.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Idempotency plugin for NestJS RedisX.
+ * Provides request deduplication with response replay for idempotent operations.
+ */
+import { Provider } from '@nestjs/common';
+import { IRedisXPlugin } from '@nestjs-redisx/core';
+import { IIdempotencyPluginOptions } from './shared/types';
+/**
+ * Idempotency plugin for NestJS RedisX.
+ *
+ * Provides request deduplication with response replay:
+ * - Prevents duplicate processing of same request
+ * - Replays successful responses
+ * - Handles concurrent requests
+ * - Validates request fingerprints
+ *
+ * @example
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     RedisModule.forRoot({
+ *       clients: { host: 'localhost', port: 6379 },
+ *       plugins: [
+ *         new IdempotencyPlugin({
+ *           defaultTtl: 86400,
+ *           headerName: 'Idempotency-Key',
+ *           validateFingerprint: true,
+ *         }),
+ *       ],
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export declare class IdempotencyPlugin implements IRedisXPlugin {
+    private readonly options;
+    readonly name = "idempotency";
+    readonly version = "0.1.0";
+    readonly description = "Request deduplication with response replay for idempotent operations";
+    constructor(options?: IIdempotencyPluginOptions);
+    getProviders(): Provider[];
+    getExports(): Array<string | symbol | Provider>;
+}
+//# sourceMappingURL=idempotency.plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.plugin.d.ts","sourceRoot":"","sources":["../src/idempotency.plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAa3D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,iBAAkB,YAAW,aAAa;IAKzC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,WAAW,0EAA0E;gBAEjE,OAAO,GAAE,yBAA8B;IAEpE,YAAY,IAAI,QAAQ,EAAE;IAuB1B,UAAU,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;CAGhD"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { IdempotencyPlugin } from './idempotency.plugin';
+export { IdempotencyService } from './idempotency/application/services/idempotency.service';
+export type { IIdempotencyService } from './idempotency/application/ports/idempotency-service.port';
+export type { IIdempotencyStore } from './idempotency/application/ports/idempotency-store.port';
+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 { IDEMPOTENCY_PLUGIN_OPTIONS, IDEMPOTENCY_SERVICE, IDEMPOTENCY_STORE } from './shared/constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}