hono-idempotency 0.7.2 → 0.8.1

package/dist/stores/redis.js

@@ -1,3 +1,7 @@
+import {
+  RECORD_STATUS_COMPLETED
+} from "../chunk-C2JZZSOP.js";
+
 // src/stores/redis.ts
 var DEFAULT_TTL = 86400;
 function redisStore(options) {
@@ -6,19 +10,42 @@ function redisStore(options) {
     async get(key) {
       const raw = await client.get(key);
       if (!raw) return void 0;
-      return JSON.parse(raw);
+      try {
+        return JSON.parse(raw);
+      } catch {
+        return void 0;
+      }
     },
     async lock(key, record) {
-      const result = await client.set(key, JSON.stringify(record), { NX: true, EX: ttl });
+      let serialized;
+      try {
+        serialized = JSON.stringify(record);
+      } catch {
+        return false;
+      }
+      const result = await client.set(key, serialized, { NX: true, EX: ttl });
       return result === "OK";
     },
     async complete(key, response) {
       const raw = await client.get(key);
       if (!raw) return;
-      const record = JSON.parse(raw);
-      record.status = "completed";
+      let record;
+      try {
+        record = JSON.parse(raw);
+      } catch {
+        return;
+      }
+      record.status = RECORD_STATUS_COMPLETED;
       record.response = response;
-      await client.set(key, JSON.stringify(record), { EX: ttl });
+      const elapsed = Math.floor((Date.now() - record.createdAt) / 1e3);
+      const remaining = Math.max(1, ttl - elapsed);
+      let serialized;
+      try {
+        serialized = JSON.stringify(record);
+      } catch {
+        return;
+      }
+      await client.set(key, serialized, { EX: remaining });
     },
     async delete(key) {
       await client.del(key);

package/dist/stores/redis.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/stores/redis.ts"],"sourcesContent":["import type { IdempotencyRecord, StoredResponse } from \"../types.js\";\nimport type { IdempotencyStore } from \"./types.js\";\n\nconst DEFAULT_TTL = 86400; // 24 hours in seconds\n\n/** Minimal Redis client subset compatible with ioredis, node-redis, and @upstash/redis. */\nexport interface RedisClientLike {\n\tget(key: string): Promise<string | null>;\n\tset(key: string, value: string, options?: { NX?: boolean; EX?: number }): Promise<string | null>;\n\tdel(...keys: string[]): Promise<number>;\n}\n\nexport interface RedisStoreOptions {\n\t/** Redis client instance (ioredis, node-redis, or @upstash/redis). */\n\tclient: RedisClientLike;\n\t/** TTL in seconds (default: 86400 = 24h). Passed as Redis EX option. */\n\tttl?: number;\n}\n\nexport function redisStore(options: RedisStoreOptions): IdempotencyStore {\n\tconst { client, ttl = DEFAULT_TTL } = options;\n\n\treturn {\n\t\tasync get(key) {\n\t\t\tconst raw = await client.get(key);\n\t\t\tif (!raw) return undefined;\n\t\t\treturn JSON.parse(raw) as IdempotencyRecord;\n\t\t},\n\n\t\tasync lock(key, record) {\n\t\t\tconst result = await client.set(key, JSON.stringify(record), { NX: true, EX: ttl });\n\t\t\treturn result === \"OK\";\n\t\t},\n\n\t\tasync complete(key, response) {\n\t\t\tconst raw = await client.get(key);\n\t\t\tif (!raw) return;\n\t\t\tconst record = JSON.parse(raw) as IdempotencyRecord;\n\t\t\trecord.status = \"completed\";\n\t\t\trecord.response = response;\n\t\t\tawait client.set(key, JSON.stringify(record), { EX: ttl });\n\t\t},\n\n\t\tasync delete(key) {\n\t\t\tawait client.del(key);\n\t\t},\n\n\t\tasync purge() {\n\t\t\t// Redis handles expiration automatically via EX — no manual purge needed\n\t\t\treturn 0;\n\t\t},\n\t};\n}\n"],"mappings":";AAGA,IAAM,cAAc;AAgBb,SAAS,WAAW,SAA8C;AACxE,QAAM,EAAE,QAAQ,MAAM,YAAY,IAAI;AAEtC,SAAO;AAAA,IACN,MAAM,IAAI,KAAK;AACd,YAAM,MAAM,MAAM,OAAO,IAAI,GAAG;AAChC,UAAI,CAAC,IAAK,QAAO;AACjB,aAAO,KAAK,MAAM,GAAG;AAAA,IACtB;AAAA,IAEA,MAAM,KAAK,KAAK,QAAQ;AACvB,YAAM,SAAS,MAAM,OAAO,IAAI,KAAK,KAAK,UAAU,MAAM,GAAG,EAAE,IAAI,MAAM,IAAI,IAAI,CAAC;AAClF,aAAO,WAAW;AAAA,IACnB;AAAA,IAEA,MAAM,SAAS,KAAK,UAAU;AAC7B,YAAM,MAAM,MAAM,OAAO,IAAI,GAAG;AAChC,UAAI,CAAC,IAAK;AACV,YAAM,SAAS,KAAK,MAAM,GAAG;AAC7B,aAAO,SAAS;AAChB,aAAO,WAAW;AAClB,YAAM,OAAO,IAAI,KAAK,KAAK,UAAU,MAAM,GAAG,EAAE,IAAI,IAAI,CAAC;AAAA,IAC1D;AAAA,IAEA,MAAM,OAAO,KAAK;AACjB,YAAM,OAAO,IAAI,GAAG;AAAA,IACrB;AAAA,IAEA,MAAM,QAAQ;AAEb,aAAO;AAAA,IACR;AAAA,EACD;AACD;","names":[]}
+{"version":3,"sources":["../../src/stores/redis.ts"],"sourcesContent":["import { type IdempotencyRecord, RECORD_STATUS_COMPLETED, type StoredResponse } from \"../types.js\";\nimport type { IdempotencyStore } from \"./types.js\";\n\nconst DEFAULT_TTL = 86400; // 24 hours in seconds\n\n/** Minimal Redis client subset compatible with ioredis, node-redis, and @upstash/redis. */\nexport interface RedisClientLike {\n\tget(key: string): Promise<string | null>;\n\tset(key: string, value: string, options?: { NX?: boolean; EX?: number }): Promise<string | null>;\n\tdel(...keys: string[]): Promise<number>;\n}\n\nexport interface RedisStoreOptions {\n\t/** Redis client instance (ioredis, node-redis, or @upstash/redis). */\n\tclient: RedisClientLike;\n\t/** TTL in seconds (default: 86400 = 24h). Passed as Redis EX option. */\n\tttl?: number;\n}\n\nexport function redisStore(options: RedisStoreOptions): IdempotencyStore {\n\tconst { client, ttl = DEFAULT_TTL } = options;\n\n\treturn {\n\t\tasync get(key) {\n\t\t\tconst raw = await client.get(key);\n\t\t\tif (!raw) return undefined;\n\t\t\ttry {\n\t\t\t\treturn JSON.parse(raw) as IdempotencyRecord;\n\t\t\t} catch {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t},\n\n\t\tasync lock(key, record) {\n\t\t\tlet serialized: string;\n\t\t\ttry {\n\t\t\t\tserialized = JSON.stringify(record);\n\t\t\t} catch {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tconst result = await client.set(key, serialized, { NX: true, EX: ttl });\n\t\t\treturn result === \"OK\";\n\t\t},\n\n\t\tasync complete(key, response) {\n\t\t\tconst raw = await client.get(key);\n\t\t\tif (!raw) return;\n\t\t\tlet record: IdempotencyRecord;\n\t\t\ttry {\n\t\t\t\trecord = JSON.parse(raw) as IdempotencyRecord;\n\t\t\t} catch {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\trecord.status = RECORD_STATUS_COMPLETED;\n\t\t\trecord.response = response;\n\t\t\tconst elapsed = Math.floor((Date.now() - record.createdAt) / 1000);\n\t\t\tconst remaining = Math.max(1, ttl - elapsed);\n\t\t\tlet serialized: string;\n\t\t\ttry {\n\t\t\t\tserialized = JSON.stringify(record);\n\t\t\t} catch {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tawait client.set(key, serialized, { EX: remaining });\n\t\t},\n\n\t\tasync delete(key) {\n\t\t\tawait client.del(key);\n\t\t},\n\n\t\tasync purge() {\n\t\t\t// Redis handles expiration automatically via EX — no manual purge needed\n\t\t\treturn 0;\n\t\t},\n\t};\n}\n"],"mappings":";;;;;AAGA,IAAM,cAAc;AAgBb,SAAS,WAAW,SAA8C;AACxE,QAAM,EAAE,QAAQ,MAAM,YAAY,IAAI;AAEtC,SAAO;AAAA,IACN,MAAM,IAAI,KAAK;AACd,YAAM,MAAM,MAAM,OAAO,IAAI,GAAG;AAChC,UAAI,CAAC,IAAK,QAAO;AACjB,UAAI;AACH,eAAO,KAAK,MAAM,GAAG;AAAA,MACtB,QAAQ;AACP,eAAO;AAAA,MACR;AAAA,IACD;AAAA,IAEA,MAAM,KAAK,KAAK,QAAQ;AACvB,UAAI;AACJ,UAAI;AACH,qBAAa,KAAK,UAAU,MAAM;AAAA,MACnC,QAAQ;AACP,eAAO;AAAA,MACR;AACA,YAAM,SAAS,MAAM,OAAO,IAAI,KAAK,YAAY,EAAE,IAAI,MAAM,IAAI,IAAI,CAAC;AACtE,aAAO,WAAW;AAAA,IACnB;AAAA,IAEA,MAAM,SAAS,KAAK,UAAU;AAC7B,YAAM,MAAM,MAAM,OAAO,IAAI,GAAG;AAChC,UAAI,CAAC,IAAK;AACV,UAAI;AACJ,UAAI;AACH,iBAAS,KAAK,MAAM,GAAG;AAAA,MACxB,QAAQ;AACP;AAAA,MACD;AACA,aAAO,SAAS;AAChB,aAAO,WAAW;AAClB,YAAM,UAAU,KAAK,OAAO,KAAK,IAAI,IAAI,OAAO,aAAa,GAAI;AACjE,YAAM,YAAY,KAAK,IAAI,GAAG,MAAM,OAAO;AAC3C,UAAI;AACJ,UAAI;AACH,qBAAa,KAAK,UAAU,MAAM;AAAA,MACnC,QAAQ;AACP;AAAA,MACD;AACA,YAAM,OAAO,IAAI,KAAK,YAAY,EAAE,IAAI,UAAU,CAAC;AAAA,IACpD;AAAA,IAEA,MAAM,OAAO,KAAK;AACjB,YAAM,OAAO,IAAI,GAAG;AAAA,IACrB;AAAA,IAEA,MAAM,QAAQ;AAEb,aAAO;AAAA,IACR;AAAA,EACD;AACD;","names":[]}

package/dist/{types-C_OW_leh.d.cts → types-7IwFeI0l.d.cts}

@@ -8,6 +8,8 @@ interface ProblemDetail {
     detail: string;
     code: IdempotencyErrorCode;
 }
+/** Ensures status is a valid HTTP status code (200-599), defaults to 500. */
+declare function clampHttpStatus(status: number): number;
 declare function problemResponse(problem: ProblemDetail, extraHeaders?: Record<string, string>): Response;
 declare const IdempotencyErrors: {
     readonly missingKey: () => ProblemDetail;
@@ -50,6 +52,8 @@ interface IdempotencyStore {
     purge(): Promise<number>;
 }
 
+declare const RECORD_STATUS_PROCESSING: "processing";
+declare const RECORD_STATUS_COMPLETED: "completed";
 interface IdempotencyEnv extends Env {
     Variables: {
         idempotencyKey: string | undefined;
@@ -74,7 +78,7 @@ interface IdempotencyOptions {
     required?: boolean;
     methods?: string[];
     maxKeyLength?: number;
-    /** Maximum request body size in bytes. Checked via Content-Length header before reading the body. */
+    /** Maximum request body size in bytes. Pre-checked via Content-Length header, then enforced against actual body byte length. */
     maxBodySize?: number;
     /** Should be a lightweight, side-effect-free predicate. Avoid reading the request body. */
     skipRequest?: (c: Context) => boolean | Promise<boolean>;
@@ -95,4 +99,4 @@ interface IdempotencyOptions {
     onCacheMiss?: (key: string, c: Context) => void | Promise<void>;
 }
 
-export { type IdempotencyOptions as I, type ProblemDetail as P, type StoredResponse as S, type IdempotencyEnv as a, type IdempotencyErrorCode as b, IdempotencyErrors as c, type IdempotencyRecord as d, type IdempotencyStore as e, problemResponse as p };
+export { type IdempotencyOptions as I, type ProblemDetail as P, RECORD_STATUS_COMPLETED as R, type StoredResponse as S, type IdempotencyEnv as a, type IdempotencyErrorCode as b, IdempotencyErrors as c, type IdempotencyRecord as d, type IdempotencyStore as e, RECORD_STATUS_PROCESSING as f, clampHttpStatus as g, problemResponse as p };

package/dist/{types-C_OW_leh.d.ts → types-7IwFeI0l.d.ts}

@@ -8,6 +8,8 @@ interface ProblemDetail {
     detail: string;
     code: IdempotencyErrorCode;
 }
+/** Ensures status is a valid HTTP status code (200-599), defaults to 500. */
+declare function clampHttpStatus(status: number): number;
 declare function problemResponse(problem: ProblemDetail, extraHeaders?: Record<string, string>): Response;
 declare const IdempotencyErrors: {
     readonly missingKey: () => ProblemDetail;
@@ -50,6 +52,8 @@ interface IdempotencyStore {
     purge(): Promise<number>;
 }
 
+declare const RECORD_STATUS_PROCESSING: "processing";
+declare const RECORD_STATUS_COMPLETED: "completed";
 interface IdempotencyEnv extends Env {
     Variables: {
         idempotencyKey: string | undefined;
@@ -74,7 +78,7 @@ interface IdempotencyOptions {
     required?: boolean;
     methods?: string[];
     maxKeyLength?: number;
-    /** Maximum request body size in bytes. Checked via Content-Length header before reading the body. */
+    /** Maximum request body size in bytes. Pre-checked via Content-Length header, then enforced against actual body byte length. */
     maxBodySize?: number;
     /** Should be a lightweight, side-effect-free predicate. Avoid reading the request body. */
     skipRequest?: (c: Context) => boolean | Promise<boolean>;
@@ -95,4 +99,4 @@ interface IdempotencyOptions {
     onCacheMiss?: (key: string, c: Context) => void | Promise<void>;
 }
 
-export { type IdempotencyOptions as I, type ProblemDetail as P, type StoredResponse as S, type IdempotencyEnv as a, type IdempotencyErrorCode as b, IdempotencyErrors as c, type IdempotencyRecord as d, type IdempotencyStore as e, problemResponse as p };
+export { type IdempotencyOptions as I, type ProblemDetail as P, RECORD_STATUS_COMPLETED as R, type StoredResponse as S, type IdempotencyEnv as a, type IdempotencyErrorCode as b, IdempotencyErrors as c, type IdempotencyRecord as d, type IdempotencyStore as e, RECORD_STATUS_PROCESSING as f, clampHttpStatus as g, problemResponse as p };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hono-idempotency",
-  "version": "0.7.2",
+  "version": "0.8.1",
   "description": "Stripe-style Idempotency-Key middleware for Hono. IETF draft-ietf-httpapi-idempotency-key-header compliant.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -112,7 +112,7 @@
     "@changesets/cli": "2.29.8",
     "@vitest/coverage-v8": "3.2.4",
     "hono": "^4.7.0",
-    "hono-problem-details": "0.1.2",
+    "hono-problem-details": "0.1.4",
     "lefthook": "2.1.1",
     "tsup": "^8.0.0",
     "typescript": "^5.7.0",