hono-idempotency 0.1.0 → 0.2.0

package/README.md

@@ -67,6 +67,56 @@ idempotency({
 
   // Custom fingerprint function (default: SHA-256 of method + path + body)
   fingerprint: (c) => `${c.req.method}:${c.req.path}`,
+
+  // Skip idempotency for specific requests
+  skipRequest: (c) => c.req.path === "/api/health",
+
+  // Namespace store keys for multi-tenant isolation
+  cacheKeyPrefix: (c) => c.req.header("X-Tenant-Id") ?? "default",
+
+  // Custom error response handler (default: RFC 9457 Problem Details)
+  onError: (error, c) => c.json({ error: error.title }, error.status),
+});
+```
+
+### skipRequest
+
+Skip idempotency processing for specific requests. Useful for health checks or internal endpoints.
+
+```ts
+idempotency({
+  store: memoryStore(),
+  skipRequest: (c) => c.req.path === "/api/health",
+});
+```
+
+### cacheKeyPrefix
+
+Namespace store keys to isolate idempotency state between tenants or environments.
+
+```ts
+idempotency({
+  store: memoryStore(),
+  // Static prefix
+  cacheKeyPrefix: "production",
+
+  // Or dynamic per-request prefix
+  cacheKeyPrefix: (c) => c.req.header("X-Tenant-Id") ?? "default",
+});
+```
+
+### onError
+
+Override the default RFC 9457 error responses with a custom handler.
+
+```ts
+import type { ProblemDetail } from "hono-idempotency";
+
+idempotency({
+  store: memoryStore(),
+  onError: (error: ProblemDetail, c) => {
+    return c.json({ code: error.status, message: error.title }, error.status);
+  },
 });
 ```
 
@@ -84,6 +134,50 @@ const store = memoryStore({
 });
 ```
 
+### Cloudflare KV Store
+
+For Cloudflare Workers with KV. TTL is handled automatically by KV expiration.
+
+```ts
+import { kvStore } from "hono-idempotency/stores/cloudflare-kv";
+
+type Bindings = { IDEMPOTENCY_KV: KVNamespace };
+
+const app = new Hono<{ Bindings: Bindings }>();
+
+app.use("/api/*", async (c, next) => {
+  const store = kvStore({
+    namespace: c.env.IDEMPOTENCY_KV,
+    ttl: 86400, // 24 hours in seconds (default)
+  });
+  return idempotency({ store })(c, next);
+});
+```
+
+> **Note:** KV is eventually consistent. In rare cases, concurrent requests to different edge locations may both acquire the lock. This is acceptable for most idempotency use cases.
+
+### Cloudflare D1 Store
+
+For Cloudflare Workers with D1. Uses SQL for strong consistency. Table is created automatically.
+
+```ts
+import { d1Store } from "hono-idempotency/stores/cloudflare-d1";
+
+type Bindings = { IDEMPOTENCY_DB: D1Database };
+
+const app = new Hono<{ Bindings: Bindings }>();
+
+app.use("/api/*", async (c, next) => {
+  const store = d1Store({
+    database: c.env.IDEMPOTENCY_DB,
+    tableName: "idempotency_keys", // default
+  });
+  return idempotency({ store })(c, next);
+});
+```
+
+> **Note:** D1 provides strong consistency, making `lock()` reliable for concurrent request protection. Consider adding a scheduled cleanup for expired rows.
+
 ### Custom Store
 
 Implement the `IdempotencyStore` interface:

package/dist/stores/cloudflare-d1.cjs

@@ -23,8 +23,53 @@ __export(cloudflare_d1_exports, {
   d1Store: () => d1Store
 });
 module.exports = __toCommonJS(cloudflare_d1_exports);
-function d1Store(_options) {
-  throw new Error("cloudflare-d1 store is not yet implemented. Coming in Phase 2.");
+var DEFAULT_TABLE = "idempotency_keys";
+function d1Store(options) {
+  const { database: db, tableName = DEFAULT_TABLE } = options;
+  let initialized = false;
+  const ensureTable = async () => {
+    if (initialized) return;
+    await db.prepare(
+      `CREATE TABLE IF NOT EXISTS ${tableName} (
+				key TEXT PRIMARY KEY,
+				fingerprint TEXT NOT NULL,
+				status TEXT NOT NULL,
+				response TEXT,
+				created_at INTEGER NOT NULL
+			)`
+    ).run();
+    initialized = true;
+  };
+  const toRecord = (row) => ({
+    key: row.key,
+    fingerprint: row.fingerprint,
+    status: row.status,
+    response: row.response ? JSON.parse(row.response) : void 0,
+    createdAt: row.created_at
+  });
+  return {
+    async get(key) {
+      await ensureTable();
+      const row = await db.prepare(`SELECT * FROM ${tableName} WHERE key = ?`).bind(key).first();
+      if (!row) return void 0;
+      return toRecord(row);
+    },
+    async lock(key, record) {
+      await ensureTable();
+      const result = await db.prepare(
+        `INSERT OR IGNORE INTO ${tableName} (key, fingerprint, status, response, created_at) VALUES (?, ?, ?, ?, ?)`
+      ).bind(key, record.fingerprint, record.status, null, record.createdAt).run();
+      return result.meta.changes > 0;
+    },
+    async complete(key, response) {
+      await ensureTable();
+      await db.prepare(`UPDATE ${tableName} SET status = ?, response = ? WHERE key = ?`).bind("completed", JSON.stringify(response), key).run();
+    },
+    async delete(key) {
+      await ensureTable();
+      await db.prepare(`DELETE FROM ${tableName} WHERE key = ?`).bind(key).run();
+    }
+  };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/stores/cloudflare-d1.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/stores/cloudflare-d1.ts"],"sourcesContent":["import type { IdempotencyStore } from \"./types.js\";\n\ninterface D1StoreOptions {\n\tbinding: string;\n\ttableName?: string;\n}\n\n// Phase 2: Cloudflare D1 store implementation\nexport function d1Store(_options: D1StoreOptions): IdempotencyStore {\n\tthrow new Error(\"cloudflare-d1 store is not yet implemented. Coming in Phase 2.\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQO,SAAS,QAAQ,UAA4C;AACnE,QAAM,IAAI,MAAM,gEAAgE;AACjF;","names":[]}
+{"version":3,"sources":["../../src/stores/cloudflare-d1.ts"],"sourcesContent":["import type { IdempotencyRecord, StoredResponse } from \"../types.js\";\nimport type { IdempotencyStore } from \"./types.js\";\n\nconst DEFAULT_TABLE = \"idempotency_keys\";\n\n/** Minimal D1Database subset used by d1Store (avoids @cloudflare/workers-types dependency). */\nexport interface D1DatabaseLike {\n\tprepare(sql: string): D1PreparedStatementLike;\n}\n\nexport interface D1PreparedStatementLike {\n\tbind(...params: unknown[]): D1PreparedStatementLike;\n\trun(): Promise<{ success: boolean; meta: { changes: number } }>;\n\tfirst(): Promise<Record<string, unknown> | null>;\n}\n\nexport interface D1StoreOptions {\n\t/** Cloudflare D1 database binding. */\n\tdatabase: D1DatabaseLike;\n\t/** Table name (default: \"idempotency_keys\"). */\n\ttableName?: string;\n}\n\nexport function d1Store(options: D1StoreOptions): IdempotencyStore {\n\tconst { database: db, tableName = DEFAULT_TABLE } = options;\n\tlet initialized = false;\n\n\tconst ensureTable = async (): Promise<void> => {\n\t\tif (initialized) return;\n\t\tawait db\n\t\t\t.prepare(\n\t\t\t\t`CREATE TABLE IF NOT EXISTS ${tableName} (\n\t\t\t\tkey TEXT PRIMARY KEY,\n\t\t\t\tfingerprint TEXT NOT NULL,\n\t\t\t\tstatus TEXT NOT NULL,\n\t\t\t\tresponse TEXT,\n\t\t\t\tcreated_at INTEGER NOT NULL\n\t\t\t)`,\n\t\t\t)\n\t\t\t.run();\n\t\tinitialized = true;\n\t};\n\n\tconst toRecord = (row: Record<string, unknown>): IdempotencyRecord => ({\n\t\tkey: row.key as string,\n\t\tfingerprint: row.fingerprint as string,\n\t\tstatus: row.status as \"processing\" | \"completed\",\n\t\tresponse: row.response ? (JSON.parse(row.response as string) as StoredResponse) : undefined,\n\t\tcreatedAt: row.created_at as number,\n\t});\n\n\treturn {\n\t\tasync get(key) {\n\t\t\tawait ensureTable();\n\t\t\tconst row = await db.prepare(`SELECT * FROM ${tableName} WHERE key = ?`).bind(key).first();\n\t\t\tif (!row) return undefined;\n\t\t\treturn toRecord(row);\n\t\t},\n\n\t\tasync lock(key, record) {\n\t\t\tawait ensureTable();\n\t\t\tconst result = await db\n\t\t\t\t.prepare(\n\t\t\t\t\t`INSERT OR IGNORE INTO ${tableName} (key, fingerprint, status, response, created_at) VALUES (?, ?, ?, ?, ?)`,\n\t\t\t\t)\n\t\t\t\t.bind(key, record.fingerprint, record.status, null, record.createdAt)\n\t\t\t\t.run();\n\t\t\treturn result.meta.changes > 0;\n\t\t},\n\n\t\tasync complete(key, response) {\n\t\t\tawait ensureTable();\n\t\t\tawait db\n\t\t\t\t.prepare(`UPDATE ${tableName} SET status = ?, response = ? WHERE key = ?`)\n\t\t\t\t.bind(\"completed\", JSON.stringify(response), key)\n\t\t\t\t.run();\n\t\t},\n\n\t\tasync delete(key) {\n\t\t\tawait ensureTable();\n\t\t\tawait db.prepare(`DELETE FROM ${tableName} WHERE key = ?`).bind(key).run();\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,IAAM,gBAAgB;AAoBf,SAAS,QAAQ,SAA2C;AAClE,QAAM,EAAE,UAAU,IAAI,YAAY,cAAc,IAAI;AACpD,MAAI,cAAc;AAElB,QAAM,cAAc,YAA2B;AAC9C,QAAI,YAAa;AACjB,UAAM,GACJ;AAAA,MACA,8BAA8B,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOxC,EACC,IAAI;AACN,kBAAc;AAAA,EACf;AAEA,QAAM,WAAW,CAAC,SAAqD;AAAA,IACtE,KAAK,IAAI;AAAA,IACT,aAAa,IAAI;AAAA,IACjB,QAAQ,IAAI;AAAA,IACZ,UAAU,IAAI,WAAY,KAAK,MAAM,IAAI,QAAkB,IAAuB;AAAA,IAClF,WAAW,IAAI;AAAA,EAChB;AAEA,SAAO;AAAA,IACN,MAAM,IAAI,KAAK;AACd,YAAM,YAAY;AAClB,YAAM,MAAM,MAAM,GAAG,QAAQ,iBAAiB,SAAS,gBAAgB,EAAE,KAAK,GAAG,EAAE,MAAM;AACzF,UAAI,CAAC,IAAK,QAAO;AACjB,aAAO,SAAS,GAAG;AAAA,IACpB;AAAA,IAEA,MAAM,KAAK,KAAK,QAAQ;AACvB,YAAM,YAAY;AAClB,YAAM,SAAS,MAAM,GACnB;AAAA,QACA,yBAAyB,SAAS;AAAA,MACnC,EACC,KAAK,KAAK,OAAO,aAAa,OAAO,QAAQ,MAAM,OAAO,SAAS,EACnE,IAAI;AACN,aAAO,OAAO,KAAK,UAAU;AAAA,IAC9B;AAAA,IAEA,MAAM,SAAS,KAAK,UAAU;AAC7B,YAAM,YAAY;AAClB,YAAM,GACJ,QAAQ,UAAU,SAAS,6CAA6C,EACxE,KAAK,aAAa,KAAK,UAAU,QAAQ,GAAG,GAAG,EAC/C,IAAI;AAAA,IACP;AAAA,IAEA,MAAM,OAAO,KAAK;AACjB,YAAM,YAAY;AAClB,YAAM,GAAG,QAAQ,eAAe,SAAS,gBAAgB,EAAE,KAAK,GAAG,EAAE,IAAI;AAAA,IAC1E;AAAA,EACD;AACD;","names":[]}

package/dist/stores/cloudflare-d1.d.cts

@@ -1,10 +1,26 @@
 import { c as IdempotencyStore } from '../types-YeEt4qLu.cjs';
 import 'hono';
 
+/** Minimal D1Database subset used by d1Store (avoids @cloudflare/workers-types dependency). */
+interface D1DatabaseLike {
+    prepare(sql: string): D1PreparedStatementLike;
+}
+interface D1PreparedStatementLike {
+    bind(...params: unknown[]): D1PreparedStatementLike;
+    run(): Promise<{
+        success: boolean;
+        meta: {
+            changes: number;
+        };
+    }>;
+    first(): Promise<Record<string, unknown> | null>;
+}
 interface D1StoreOptions {
-    binding: string;
+    /** Cloudflare D1 database binding. */
+    database: D1DatabaseLike;
+    /** Table name (default: "idempotency_keys"). */
     tableName?: string;
 }
-declare function d1Store(_options: D1StoreOptions): IdempotencyStore;
+declare function d1Store(options: D1StoreOptions): IdempotencyStore;
 
-export { d1Store };
+export { type D1DatabaseLike, type D1PreparedStatementLike, type D1StoreOptions, d1Store };

package/dist/stores/cloudflare-d1.d.ts

@@ -1,10 +1,26 @@
 import { c as IdempotencyStore } from '../types-YeEt4qLu.js';
 import 'hono';
 
+/** Minimal D1Database subset used by d1Store (avoids @cloudflare/workers-types dependency). */
+interface D1DatabaseLike {
+    prepare(sql: string): D1PreparedStatementLike;
+}
+interface D1PreparedStatementLike {
+    bind(...params: unknown[]): D1PreparedStatementLike;
+    run(): Promise<{
+        success: boolean;
+        meta: {
+            changes: number;
+        };
+    }>;
+    first(): Promise<Record<string, unknown> | null>;
+}
 interface D1StoreOptions {
-    binding: string;
+    /** Cloudflare D1 database binding. */
+    database: D1DatabaseLike;
+    /** Table name (default: "idempotency_keys"). */
     tableName?: string;
 }
-declare function d1Store(_options: D1StoreOptions): IdempotencyStore;
+declare function d1Store(options: D1StoreOptions): IdempotencyStore;
 
-export { d1Store };
+export { type D1DatabaseLike, type D1PreparedStatementLike, type D1StoreOptions, d1Store };

package/dist/stores/cloudflare-d1.js

@@ -1,6 +1,51 @@
 // src/stores/cloudflare-d1.ts
-function d1Store(_options) {
-  throw new Error("cloudflare-d1 store is not yet implemented. Coming in Phase 2.");
+var DEFAULT_TABLE = "idempotency_keys";
+function d1Store(options) {
+  const { database: db, tableName = DEFAULT_TABLE } = options;
+  let initialized = false;
+  const ensureTable = async () => {
+    if (initialized) return;
+    await db.prepare(
+      `CREATE TABLE IF NOT EXISTS ${tableName} (
+				key TEXT PRIMARY KEY,
+				fingerprint TEXT NOT NULL,
+				status TEXT NOT NULL,
+				response TEXT,
+				created_at INTEGER NOT NULL
+			)`
+    ).run();
+    initialized = true;
+  };
+  const toRecord = (row) => ({
+    key: row.key,
+    fingerprint: row.fingerprint,
+    status: row.status,
+    response: row.response ? JSON.parse(row.response) : void 0,
+    createdAt: row.created_at
+  });
+  return {
+    async get(key) {
+      await ensureTable();
+      const row = await db.prepare(`SELECT * FROM ${tableName} WHERE key = ?`).bind(key).first();
+      if (!row) return void 0;
+      return toRecord(row);
+    },
+    async lock(key, record) {
+      await ensureTable();
+      const result = await db.prepare(
+        `INSERT OR IGNORE INTO ${tableName} (key, fingerprint, status, response, created_at) VALUES (?, ?, ?, ?, ?)`
+      ).bind(key, record.fingerprint, record.status, null, record.createdAt).run();
+      return result.meta.changes > 0;
+    },
+    async complete(key, response) {
+      await ensureTable();
+      await db.prepare(`UPDATE ${tableName} SET status = ?, response = ? WHERE key = ?`).bind("completed", JSON.stringify(response), key).run();
+    },
+    async delete(key) {
+      await ensureTable();
+      await db.prepare(`DELETE FROM ${tableName} WHERE key = ?`).bind(key).run();
+    }
+  };
 }
 export {
   d1Store

package/dist/stores/cloudflare-d1.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/stores/cloudflare-d1.ts"],"sourcesContent":["import type { IdempotencyStore } from \"./types.js\";\n\ninterface D1StoreOptions {\n\tbinding: string;\n\ttableName?: string;\n}\n\n// Phase 2: Cloudflare D1 store implementation\nexport function d1Store(_options: D1StoreOptions): IdempotencyStore {\n\tthrow new Error(\"cloudflare-d1 store is not yet implemented. Coming in Phase 2.\");\n}\n"],"mappings":";AAQO,SAAS,QAAQ,UAA4C;AACnE,QAAM,IAAI,MAAM,gEAAgE;AACjF;","names":[]}
+{"version":3,"sources":["../../src/stores/cloudflare-d1.ts"],"sourcesContent":["import type { IdempotencyRecord, StoredResponse } from \"../types.js\";\nimport type { IdempotencyStore } from \"./types.js\";\n\nconst DEFAULT_TABLE = \"idempotency_keys\";\n\n/** Minimal D1Database subset used by d1Store (avoids @cloudflare/workers-types dependency). */\nexport interface D1DatabaseLike {\n\tprepare(sql: string): D1PreparedStatementLike;\n}\n\nexport interface D1PreparedStatementLike {\n\tbind(...params: unknown[]): D1PreparedStatementLike;\n\trun(): Promise<{ success: boolean; meta: { changes: number } }>;\n\tfirst(): Promise<Record<string, unknown> | null>;\n}\n\nexport interface D1StoreOptions {\n\t/** Cloudflare D1 database binding. */\n\tdatabase: D1DatabaseLike;\n\t/** Table name (default: \"idempotency_keys\"). */\n\ttableName?: string;\n}\n\nexport function d1Store(options: D1StoreOptions): IdempotencyStore {\n\tconst { database: db, tableName = DEFAULT_TABLE } = options;\n\tlet initialized = false;\n\n\tconst ensureTable = async (): Promise<void> => {\n\t\tif (initialized) return;\n\t\tawait db\n\t\t\t.prepare(\n\t\t\t\t`CREATE TABLE IF NOT EXISTS ${tableName} (\n\t\t\t\tkey TEXT PRIMARY KEY,\n\t\t\t\tfingerprint TEXT NOT NULL,\n\t\t\t\tstatus TEXT NOT NULL,\n\t\t\t\tresponse TEXT,\n\t\t\t\tcreated_at INTEGER NOT NULL\n\t\t\t)`,\n\t\t\t)\n\t\t\t.run();\n\t\tinitialized = true;\n\t};\n\n\tconst toRecord = (row: Record<string, unknown>): IdempotencyRecord => ({\n\t\tkey: row.key as string,\n\t\tfingerprint: row.fingerprint as string,\n\t\tstatus: row.status as \"processing\" | \"completed\",\n\t\tresponse: row.response ? (JSON.parse(row.response as string) as StoredResponse) : undefined,\n\t\tcreatedAt: row.created_at as number,\n\t});\n\n\treturn {\n\t\tasync get(key) {\n\t\t\tawait ensureTable();\n\t\t\tconst row = await db.prepare(`SELECT * FROM ${tableName} WHERE key = ?`).bind(key).first();\n\t\t\tif (!row) return undefined;\n\t\t\treturn toRecord(row);\n\t\t},\n\n\t\tasync lock(key, record) {\n\t\t\tawait ensureTable();\n\t\t\tconst result = await db\n\t\t\t\t.prepare(\n\t\t\t\t\t`INSERT OR IGNORE INTO ${tableName} (key, fingerprint, status, response, created_at) VALUES (?, ?, ?, ?, ?)`,\n\t\t\t\t)\n\t\t\t\t.bind(key, record.fingerprint, record.status, null, record.createdAt)\n\t\t\t\t.run();\n\t\t\treturn result.meta.changes > 0;\n\t\t},\n\n\t\tasync complete(key, response) {\n\t\t\tawait ensureTable();\n\t\t\tawait db\n\t\t\t\t.prepare(`UPDATE ${tableName} SET status = ?, response = ? WHERE key = ?`)\n\t\t\t\t.bind(\"completed\", JSON.stringify(response), key)\n\t\t\t\t.run();\n\t\t},\n\n\t\tasync delete(key) {\n\t\t\tawait ensureTable();\n\t\t\tawait db.prepare(`DELETE FROM ${tableName} WHERE key = ?`).bind(key).run();\n\t\t},\n\t};\n}\n"],"mappings":";AAGA,IAAM,gBAAgB;AAoBf,SAAS,QAAQ,SAA2C;AAClE,QAAM,EAAE,UAAU,IAAI,YAAY,cAAc,IAAI;AACpD,MAAI,cAAc;AAElB,QAAM,cAAc,YAA2B;AAC9C,QAAI,YAAa;AACjB,UAAM,GACJ;AAAA,MACA,8BAA8B,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOxC,EACC,IAAI;AACN,kBAAc;AAAA,EACf;AAEA,QAAM,WAAW,CAAC,SAAqD;AAAA,IACtE,KAAK,IAAI;AAAA,IACT,aAAa,IAAI;AAAA,IACjB,QAAQ,IAAI;AAAA,IACZ,UAAU,IAAI,WAAY,KAAK,MAAM,IAAI,QAAkB,IAAuB;AAAA,IAClF,WAAW,IAAI;AAAA,EAChB;AAEA,SAAO;AAAA,IACN,MAAM,IAAI,KAAK;AACd,YAAM,YAAY;AAClB,YAAM,MAAM,MAAM,GAAG,QAAQ,iBAAiB,SAAS,gBAAgB,EAAE,KAAK,GAAG,EAAE,MAAM;AACzF,UAAI,CAAC,IAAK,QAAO;AACjB,aAAO,SAAS,GAAG;AAAA,IACpB;AAAA,IAEA,MAAM,KAAK,KAAK,QAAQ;AACvB,YAAM,YAAY;AAClB,YAAM,SAAS,MAAM,GACnB;AAAA,QACA,yBAAyB,SAAS;AAAA,MACnC,EACC,KAAK,KAAK,OAAO,aAAa,OAAO,QAAQ,MAAM,OAAO,SAAS,EACnE,IAAI;AACN,aAAO,OAAO,KAAK,UAAU;AAAA,IAC9B;AAAA,IAEA,MAAM,SAAS,KAAK,UAAU;AAC7B,YAAM,YAAY;AAClB,YAAM,GACJ,QAAQ,UAAU,SAAS,6CAA6C,EACxE,KAAK,aAAa,KAAK,UAAU,QAAQ,GAAG,GAAG,EAC/C,IAAI;AAAA,IACP;AAAA,IAEA,MAAM,OAAO,KAAK;AACjB,YAAM,YAAY;AAClB,YAAM,GAAG,QAAQ,eAAe,SAAS,gBAAgB,EAAE,KAAK,GAAG,EAAE,IAAI;AAAA,IAC1E;AAAA,EACD;AACD;","names":[]}

package/dist/stores/cloudflare-kv.cjs

@@ -23,8 +23,33 @@ __export(cloudflare_kv_exports, {
   kvStore: () => kvStore
 });
 module.exports = __toCommonJS(cloudflare_kv_exports);
-function kvStore(_options) {
-  throw new Error("cloudflare-kv store is not yet implemented. Coming in Phase 2.");
+var DEFAULT_TTL = 86400;
+function kvStore(options) {
+  const { namespace: kv, ttl = DEFAULT_TTL } = options;
+  return {
+    async get(key) {
+      const record = await kv.get(key, { type: "json" });
+      return record ?? void 0;
+    },
+    async lock(key, record) {
+      const existing = await kv.get(key, { type: "json" });
+      if (existing) {
+        return false;
+      }
+      await kv.put(key, JSON.stringify(record), { expirationTtl: ttl });
+      return true;
+    },
+    async complete(key, response) {
+      const record = await kv.get(key, { type: "json" });
+      if (!record) return;
+      record.status = "completed";
+      record.response = response;
+      await kv.put(key, JSON.stringify(record), { expirationTtl: ttl });
+    },
+    async delete(key) {
+      await kv.delete(key);
+    }
+  };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/stores/cloudflare-kv.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/stores/cloudflare-kv.ts"],"sourcesContent":["import type { IdempotencyStore } from \"./types.js\";\n\ninterface KVStoreOptions {\n\tbinding: string;\n\tttl?: number;\n}\n\n// Phase 2: Cloudflare KV store implementation\nexport function kvStore(_options: KVStoreOptions): IdempotencyStore {\n\tthrow new Error(\"cloudflare-kv store is not yet implemented. Coming in Phase 2.\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQO,SAAS,QAAQ,UAA4C;AACnE,QAAM,IAAI,MAAM,gEAAgE;AACjF;","names":[]}
+{"version":3,"sources":["../../src/stores/cloudflare-kv.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 KVNamespace subset used by kvStore (avoids @cloudflare/workers-types dependency). */\nexport interface KVNamespaceLike {\n\tget(key: string, options: { type: \"json\" }): Promise<unknown>;\n\tput(key: string, value: string, options?: { expirationTtl?: number }): Promise<void>;\n\tdelete(key: string): Promise<void>;\n}\n\nexport interface KVStoreOptions {\n\t/** Cloudflare Workers KV namespace binding. */\n\tnamespace: KVNamespaceLike;\n\t/** TTL in seconds (default: 86400 = 24h). KV minimum is 60 seconds. */\n\tttl?: number;\n}\n\nexport function kvStore(options: KVStoreOptions): IdempotencyStore {\n\tconst { namespace: kv, ttl = DEFAULT_TTL } = options;\n\n\treturn {\n\t\tasync get(key) {\n\t\t\tconst record = (await kv.get(key, { type: \"json\" })) as IdempotencyRecord | null;\n\t\t\treturn record ?? undefined;\n\t\t},\n\n\t\tasync lock(key, record) {\n\t\t\tconst existing = (await kv.get(key, { type: \"json\" })) as IdempotencyRecord | null;\n\t\t\tif (existing) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tawait kv.put(key, JSON.stringify(record), { expirationTtl: ttl });\n\t\t\treturn true;\n\t\t},\n\n\t\tasync complete(key, response) {\n\t\t\tconst record = (await kv.get(key, { type: \"json\" })) as IdempotencyRecord | null;\n\t\t\tif (!record) return;\n\t\t\trecord.status = \"completed\";\n\t\t\trecord.response = response;\n\t\t\tawait kv.put(key, JSON.stringify(record), { expirationTtl: ttl });\n\t\t},\n\n\t\tasync delete(key) {\n\t\t\tawait kv.delete(key);\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,IAAM,cAAc;AAgBb,SAAS,QAAQ,SAA2C;AAClE,QAAM,EAAE,WAAW,IAAI,MAAM,YAAY,IAAI;AAE7C,SAAO;AAAA,IACN,MAAM,IAAI,KAAK;AACd,YAAM,SAAU,MAAM,GAAG,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC;AAClD,aAAO,UAAU;AAAA,IAClB;AAAA,IAEA,MAAM,KAAK,KAAK,QAAQ;AACvB,YAAM,WAAY,MAAM,GAAG,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC;AACpD,UAAI,UAAU;AACb,eAAO;AAAA,MACR;AACA,YAAM,GAAG,IAAI,KAAK,KAAK,UAAU,MAAM,GAAG,EAAE,eAAe,IAAI,CAAC;AAChE,aAAO;AAAA,IACR;AAAA,IAEA,MAAM,SAAS,KAAK,UAAU;AAC7B,YAAM,SAAU,MAAM,GAAG,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC;AAClD,UAAI,CAAC,OAAQ;AACb,aAAO,SAAS;AAChB,aAAO,WAAW;AAClB,YAAM,GAAG,IAAI,KAAK,KAAK,UAAU,MAAM,GAAG,EAAE,eAAe,IAAI,CAAC;AAAA,IACjE;AAAA,IAEA,MAAM,OAAO,KAAK;AACjB,YAAM,GAAG,OAAO,GAAG;AAAA,IACpB;AAAA,EACD;AACD;","names":[]}

package/dist/stores/cloudflare-kv.d.cts

@@ -1,10 +1,22 @@
 import { c as IdempotencyStore } from '../types-YeEt4qLu.cjs';
 import 'hono';
 
+/** Minimal KVNamespace subset used by kvStore (avoids @cloudflare/workers-types dependency). */
+interface KVNamespaceLike {
+    get(key: string, options: {
+        type: "json";
+    }): Promise<unknown>;
+    put(key: string, value: string, options?: {
+        expirationTtl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<void>;
+}
 interface KVStoreOptions {
-    binding: string;
+    /** Cloudflare Workers KV namespace binding. */
+    namespace: KVNamespaceLike;
+    /** TTL in seconds (default: 86400 = 24h). KV minimum is 60 seconds. */
     ttl?: number;
 }
-declare function kvStore(_options: KVStoreOptions): IdempotencyStore;
+declare function kvStore(options: KVStoreOptions): IdempotencyStore;
 
-export { kvStore };
+export { type KVNamespaceLike, type KVStoreOptions, kvStore };

package/dist/stores/cloudflare-kv.d.ts

@@ -1,10 +1,22 @@
 import { c as IdempotencyStore } from '../types-YeEt4qLu.js';
 import 'hono';
 
+/** Minimal KVNamespace subset used by kvStore (avoids @cloudflare/workers-types dependency). */
+interface KVNamespaceLike {
+    get(key: string, options: {
+        type: "json";
+    }): Promise<unknown>;
+    put(key: string, value: string, options?: {
+        expirationTtl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<void>;
+}
 interface KVStoreOptions {
-    binding: string;
+    /** Cloudflare Workers KV namespace binding. */
+    namespace: KVNamespaceLike;
+    /** TTL in seconds (default: 86400 = 24h). KV minimum is 60 seconds. */
     ttl?: number;
 }
-declare function kvStore(_options: KVStoreOptions): IdempotencyStore;
+declare function kvStore(options: KVStoreOptions): IdempotencyStore;
 
-export { kvStore };
+export { type KVNamespaceLike, type KVStoreOptions, kvStore };

package/dist/stores/cloudflare-kv.js

@@ -1,6 +1,31 @@
 // src/stores/cloudflare-kv.ts
-function kvStore(_options) {
-  throw new Error("cloudflare-kv store is not yet implemented. Coming in Phase 2.");
+var DEFAULT_TTL = 86400;
+function kvStore(options) {
+  const { namespace: kv, ttl = DEFAULT_TTL } = options;
+  return {
+    async get(key) {
+      const record = await kv.get(key, { type: "json" });
+      return record ?? void 0;
+    },
+    async lock(key, record) {
+      const existing = await kv.get(key, { type: "json" });
+      if (existing) {
+        return false;
+      }
+      await kv.put(key, JSON.stringify(record), { expirationTtl: ttl });
+      return true;
+    },
+    async complete(key, response) {
+      const record = await kv.get(key, { type: "json" });
+      if (!record) return;
+      record.status = "completed";
+      record.response = response;
+      await kv.put(key, JSON.stringify(record), { expirationTtl: ttl });
+    },
+    async delete(key) {
+      await kv.delete(key);
+    }
+  };
 }
 export {
   kvStore

package/dist/stores/cloudflare-kv.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/stores/cloudflare-kv.ts"],"sourcesContent":["import type { IdempotencyStore } from \"./types.js\";\n\ninterface KVStoreOptions {\n\tbinding: string;\n\tttl?: number;\n}\n\n// Phase 2: Cloudflare KV store implementation\nexport function kvStore(_options: KVStoreOptions): IdempotencyStore {\n\tthrow new Error(\"cloudflare-kv store is not yet implemented. Coming in Phase 2.\");\n}\n"],"mappings":";AAQO,SAAS,QAAQ,UAA4C;AACnE,QAAM,IAAI,MAAM,gEAAgE;AACjF;","names":[]}
+{"version":3,"sources":["../../src/stores/cloudflare-kv.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 KVNamespace subset used by kvStore (avoids @cloudflare/workers-types dependency). */\nexport interface KVNamespaceLike {\n\tget(key: string, options: { type: \"json\" }): Promise<unknown>;\n\tput(key: string, value: string, options?: { expirationTtl?: number }): Promise<void>;\n\tdelete(key: string): Promise<void>;\n}\n\nexport interface KVStoreOptions {\n\t/** Cloudflare Workers KV namespace binding. */\n\tnamespace: KVNamespaceLike;\n\t/** TTL in seconds (default: 86400 = 24h). KV minimum is 60 seconds. */\n\tttl?: number;\n}\n\nexport function kvStore(options: KVStoreOptions): IdempotencyStore {\n\tconst { namespace: kv, ttl = DEFAULT_TTL } = options;\n\n\treturn {\n\t\tasync get(key) {\n\t\t\tconst record = (await kv.get(key, { type: \"json\" })) as IdempotencyRecord | null;\n\t\t\treturn record ?? undefined;\n\t\t},\n\n\t\tasync lock(key, record) {\n\t\t\tconst existing = (await kv.get(key, { type: \"json\" })) as IdempotencyRecord | null;\n\t\t\tif (existing) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tawait kv.put(key, JSON.stringify(record), { expirationTtl: ttl });\n\t\t\treturn true;\n\t\t},\n\n\t\tasync complete(key, response) {\n\t\t\tconst record = (await kv.get(key, { type: \"json\" })) as IdempotencyRecord | null;\n\t\t\tif (!record) return;\n\t\t\trecord.status = \"completed\";\n\t\t\trecord.response = response;\n\t\t\tawait kv.put(key, JSON.stringify(record), { expirationTtl: ttl });\n\t\t},\n\n\t\tasync delete(key) {\n\t\t\tawait kv.delete(key);\n\t\t},\n\t};\n}\n"],"mappings":";AAGA,IAAM,cAAc;AAgBb,SAAS,QAAQ,SAA2C;AAClE,QAAM,EAAE,WAAW,IAAI,MAAM,YAAY,IAAI;AAE7C,SAAO;AAAA,IACN,MAAM,IAAI,KAAK;AACd,YAAM,SAAU,MAAM,GAAG,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC;AAClD,aAAO,UAAU;AAAA,IAClB;AAAA,IAEA,MAAM,KAAK,KAAK,QAAQ;AACvB,YAAM,WAAY,MAAM,GAAG,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC;AACpD,UAAI,UAAU;AACb,eAAO;AAAA,MACR;AACA,YAAM,GAAG,IAAI,KAAK,KAAK,UAAU,MAAM,GAAG,EAAE,eAAe,IAAI,CAAC;AAChE,aAAO;AAAA,IACR;AAAA,IAEA,MAAM,SAAS,KAAK,UAAU;AAC7B,YAAM,SAAU,MAAM,GAAG,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC;AAClD,UAAI,CAAC,OAAQ;AACb,aAAO,SAAS;AAChB,aAAO,WAAW;AAClB,YAAM,GAAG,IAAI,KAAK,KAAK,UAAU,MAAM,GAAG,EAAE,eAAe,IAAI,CAAC;AAAA,IACjE;AAAA,IAEA,MAAM,OAAO,KAAK;AACjB,YAAM,GAAG,OAAO,GAAG;AAAA,IACpB;AAAA,EACD;AACD;","names":[]}

package/dist/stores/memory.cjs

@@ -30,7 +30,17 @@ function memoryStore(options = {}) {
   const isExpired = (record) => {
     return Date.now() - record.createdAt >= ttl;
   };
+  const sweep = () => {
+    for (const [key, record] of map) {
+      if (isExpired(record)) {
+        map.delete(key);
+      }
+    }
+  };
   return {
+    get size() {
+      return map.size;
+    },
     async get(key) {
       const record = map.get(key);
       if (!record) return void 0;
@@ -41,6 +51,7 @@ function memoryStore(options = {}) {
       return record;
     },
     async lock(key, record) {
+      sweep();
       const existing = map.get(key);
       if (existing && !isExpired(existing)) {
         return false;

package/dist/stores/memory.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/stores/memory.ts"],"sourcesContent":["import type { IdempotencyRecord, StoredResponse } from \"../types.js\";\nimport type { IdempotencyStore } from \"./types.js\";\n\nconst DEFAULT_TTL = 24 * 60 * 60 * 1000; // 24 hours\n\ninterface MemoryStoreOptions {\n\tttl?: number;\n}\n\nexport function memoryStore(options: MemoryStoreOptions = {}): IdempotencyStore {\n\tconst ttl = options.ttl ?? DEFAULT_TTL;\n\tconst map = new Map<string, IdempotencyRecord>();\n\n\tconst isExpired = (record: IdempotencyRecord): boolean => {\n\t\treturn Date.now() - record.createdAt >= ttl;\n\t};\n\n\treturn {\n\t\tasync get(key) {\n\t\t\tconst record = map.get(key);\n\t\t\tif (!record) return undefined;\n\t\t\tif (isExpired(record)) {\n\t\t\t\tmap.delete(key);\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\treturn record;\n\t\t},\n\n\t\tasync lock(key, record) {\n\t\t\tconst existing = map.get(key);\n\t\t\tif (existing && !isExpired(existing)) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tmap.set(key, record);\n\t\t\treturn true;\n\t\t},\n\n\t\tasync complete(key, response) {\n\t\t\tconst record = map.get(key);\n\t\t\tif (record) {\n\t\t\t\trecord.status = \"completed\";\n\t\t\t\trecord.response = response;\n\t\t\t}\n\t\t},\n\n\t\tasync delete(key) {\n\t\t\tmap.delete(key);\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,IAAM,cAAc,KAAK,KAAK,KAAK;AAM5B,SAAS,YAAY,UAA8B,CAAC,GAAqB;AAC/E,QAAM,MAAM,QAAQ,OAAO;AAC3B,QAAM,MAAM,oBAAI,IAA+B;AAE/C,QAAM,YAAY,CAAC,WAAuC;AACzD,WAAO,KAAK,IAAI,IAAI,OAAO,aAAa;AAAA,EACzC;AAEA,SAAO;AAAA,IACN,MAAM,IAAI,KAAK;AACd,YAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,UAAI,CAAC,OAAQ,QAAO;AACpB,UAAI,UAAU,MAAM,GAAG;AACtB,YAAI,OAAO,GAAG;AACd,eAAO;AAAA,MACR;AACA,aAAO;AAAA,IACR;AAAA,IAEA,MAAM,KAAK,KAAK,QAAQ;AACvB,YAAM,WAAW,IAAI,IAAI,GAAG;AAC5B,UAAI,YAAY,CAAC,UAAU,QAAQ,GAAG;AACrC,eAAO;AAAA,MACR;AACA,UAAI,IAAI,KAAK,MAAM;AACnB,aAAO;AAAA,IACR;AAAA,IAEA,MAAM,SAAS,KAAK,UAAU;AAC7B,YAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,UAAI,QAAQ;AACX,eAAO,SAAS;AAChB,eAAO,WAAW;AAAA,MACnB;AAAA,IACD;AAAA,IAEA,MAAM,OAAO,KAAK;AACjB,UAAI,OAAO,GAAG;AAAA,IACf;AAAA,EACD;AACD;","names":[]}
+{"version":3,"sources":["../../src/stores/memory.ts"],"sourcesContent":["import type { IdempotencyRecord, StoredResponse } from \"../types.js\";\nimport type { IdempotencyStore } from \"./types.js\";\n\nconst DEFAULT_TTL = 24 * 60 * 60 * 1000; // 24 hours\n\ninterface MemoryStoreOptions {\n\tttl?: number;\n}\n\nexport interface MemoryStore extends IdempotencyStore {\n\t/** Number of entries currently in the store (including expired but not yet swept). */\n\treadonly size: number;\n}\n\nexport function memoryStore(options: MemoryStoreOptions = {}): MemoryStore {\n\tconst ttl = options.ttl ?? DEFAULT_TTL;\n\tconst map = new Map<string, IdempotencyRecord>();\n\n\tconst isExpired = (record: IdempotencyRecord): boolean => {\n\t\treturn Date.now() - record.createdAt >= ttl;\n\t};\n\n\tconst sweep = (): void => {\n\t\tfor (const [key, record] of map) {\n\t\t\tif (isExpired(record)) {\n\t\t\t\tmap.delete(key);\n\t\t\t}\n\t\t}\n\t};\n\n\treturn {\n\t\tget size() {\n\t\t\treturn map.size;\n\t\t},\n\n\t\tasync get(key) {\n\t\t\tconst record = map.get(key);\n\t\t\tif (!record) return undefined;\n\t\t\tif (isExpired(record)) {\n\t\t\t\tmap.delete(key);\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\treturn record;\n\t\t},\n\n\t\tasync lock(key, record) {\n\t\t\tsweep();\n\t\t\tconst existing = map.get(key);\n\t\t\tif (existing && !isExpired(existing)) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tmap.set(key, record);\n\t\t\treturn true;\n\t\t},\n\n\t\tasync complete(key, response) {\n\t\t\tconst record = map.get(key);\n\t\t\tif (record) {\n\t\t\t\trecord.status = \"completed\";\n\t\t\t\trecord.response = response;\n\t\t\t}\n\t\t},\n\n\t\tasync delete(key) {\n\t\t\tmap.delete(key);\n\t\t},\n\t};\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,IAAM,cAAc,KAAK,KAAK,KAAK;AAW5B,SAAS,YAAY,UAA8B,CAAC,GAAgB;AAC1E,QAAM,MAAM,QAAQ,OAAO;AAC3B,QAAM,MAAM,oBAAI,IAA+B;AAE/C,QAAM,YAAY,CAAC,WAAuC;AACzD,WAAO,KAAK,IAAI,IAAI,OAAO,aAAa;AAAA,EACzC;AAEA,QAAM,QAAQ,MAAY;AACzB,eAAW,CAAC,KAAK,MAAM,KAAK,KAAK;AAChC,UAAI,UAAU,MAAM,GAAG;AACtB,YAAI,OAAO,GAAG;AAAA,MACf;AAAA,IACD;AAAA,EACD;AAEA,SAAO;AAAA,IACN,IAAI,OAAO;AACV,aAAO,IAAI;AAAA,IACZ;AAAA,IAEA,MAAM,IAAI,KAAK;AACd,YAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,UAAI,CAAC,OAAQ,QAAO;AACpB,UAAI,UAAU,MAAM,GAAG;AACtB,YAAI,OAAO,GAAG;AACd,eAAO;AAAA,MACR;AACA,aAAO;AAAA,IACR;AAAA,IAEA,MAAM,KAAK,KAAK,QAAQ;AACvB,YAAM;AACN,YAAM,WAAW,IAAI,IAAI,GAAG;AAC5B,UAAI,YAAY,CAAC,UAAU,QAAQ,GAAG;AACrC,eAAO;AAAA,MACR;AACA,UAAI,IAAI,KAAK,MAAM;AACnB,aAAO;AAAA,IACR;AAAA,IAEA,MAAM,SAAS,KAAK,UAAU;AAC7B,YAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,UAAI,QAAQ;AACX,eAAO,SAAS;AAChB,eAAO,WAAW;AAAA,MACnB;AAAA,IACD;AAAA,IAEA,MAAM,OAAO,KAAK;AACjB,UAAI,OAAO,GAAG;AAAA,IACf;AAAA,EACD;AACD;","names":[]}

package/dist/stores/memory.d.cts

@@ -4,6 +4,10 @@ import 'hono';
 interface MemoryStoreOptions {
     ttl?: number;
 }
-declare function memoryStore(options?: MemoryStoreOptions): IdempotencyStore;
+interface MemoryStore extends IdempotencyStore {
+    /** Number of entries currently in the store (including expired but not yet swept). */
+    readonly size: number;
+}
+declare function memoryStore(options?: MemoryStoreOptions): MemoryStore;
 
-export { memoryStore };
+export { type MemoryStore, memoryStore };

package/dist/stores/memory.d.ts

@@ -4,6 +4,10 @@ import 'hono';
 interface MemoryStoreOptions {
     ttl?: number;
 }
-declare function memoryStore(options?: MemoryStoreOptions): IdempotencyStore;
+interface MemoryStore extends IdempotencyStore {
+    /** Number of entries currently in the store (including expired but not yet swept). */
+    readonly size: number;
+}
+declare function memoryStore(options?: MemoryStoreOptions): MemoryStore;
 
-export { memoryStore };
+export { type MemoryStore, memoryStore };

package/dist/stores/memory.js

@@ -6,7 +6,17 @@ function memoryStore(options = {}) {
   const isExpired = (record) => {
     return Date.now() - record.createdAt >= ttl;
   };
+  const sweep = () => {
+    for (const [key, record] of map) {
+      if (isExpired(record)) {
+        map.delete(key);
+      }
+    }
+  };
   return {
+    get size() {
+      return map.size;
+    },
     async get(key) {
       const record = map.get(key);
       if (!record) return void 0;
@@ -17,6 +27,7 @@ function memoryStore(options = {}) {
       return record;
     },
     async lock(key, record) {
+      sweep();
       const existing = map.get(key);
       if (existing && !isExpired(existing)) {
         return false;

package/dist/stores/memory.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/stores/memory.ts"],"sourcesContent":["import type { IdempotencyRecord, StoredResponse } from \"../types.js\";\nimport type { IdempotencyStore } from \"./types.js\";\n\nconst DEFAULT_TTL = 24 * 60 * 60 * 1000; // 24 hours\n\ninterface MemoryStoreOptions {\n\tttl?: number;\n}\n\nexport function memoryStore(options: MemoryStoreOptions = {}): IdempotencyStore {\n\tconst ttl = options.ttl ?? DEFAULT_TTL;\n\tconst map = new Map<string, IdempotencyRecord>();\n\n\tconst isExpired = (record: IdempotencyRecord): boolean => {\n\t\treturn Date.now() - record.createdAt >= ttl;\n\t};\n\n\treturn {\n\t\tasync get(key) {\n\t\t\tconst record = map.get(key);\n\t\t\tif (!record) return undefined;\n\t\t\tif (isExpired(record)) {\n\t\t\t\tmap.delete(key);\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\treturn record;\n\t\t},\n\n\t\tasync lock(key, record) {\n\t\t\tconst existing = map.get(key);\n\t\t\tif (existing && !isExpired(existing)) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tmap.set(key, record);\n\t\t\treturn true;\n\t\t},\n\n\t\tasync complete(key, response) {\n\t\t\tconst record = map.get(key);\n\t\t\tif (record) {\n\t\t\t\trecord.status = \"completed\";\n\t\t\t\trecord.response = response;\n\t\t\t}\n\t\t},\n\n\t\tasync delete(key) {\n\t\t\tmap.delete(key);\n\t\t},\n\t};\n}\n"],"mappings":";AAGA,IAAM,cAAc,KAAK,KAAK,KAAK;AAM5B,SAAS,YAAY,UAA8B,CAAC,GAAqB;AAC/E,QAAM,MAAM,QAAQ,OAAO;AAC3B,QAAM,MAAM,oBAAI,IAA+B;AAE/C,QAAM,YAAY,CAAC,WAAuC;AACzD,WAAO,KAAK,IAAI,IAAI,OAAO,aAAa;AAAA,EACzC;AAEA,SAAO;AAAA,IACN,MAAM,IAAI,KAAK;AACd,YAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,UAAI,CAAC,OAAQ,QAAO;AACpB,UAAI,UAAU,MAAM,GAAG;AACtB,YAAI,OAAO,GAAG;AACd,eAAO;AAAA,MACR;AACA,aAAO;AAAA,IACR;AAAA,IAEA,MAAM,KAAK,KAAK,QAAQ;AACvB,YAAM,WAAW,IAAI,IAAI,GAAG;AAC5B,UAAI,YAAY,CAAC,UAAU,QAAQ,GAAG;AACrC,eAAO;AAAA,MACR;AACA,UAAI,IAAI,KAAK,MAAM;AACnB,aAAO;AAAA,IACR;AAAA,IAEA,MAAM,SAAS,KAAK,UAAU;AAC7B,YAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,UAAI,QAAQ;AACX,eAAO,SAAS;AAChB,eAAO,WAAW;AAAA,MACnB;AAAA,IACD;AAAA,IAEA,MAAM,OAAO,KAAK;AACjB,UAAI,OAAO,GAAG;AAAA,IACf;AAAA,EACD;AACD;","names":[]}
+{"version":3,"sources":["../../src/stores/memory.ts"],"sourcesContent":["import type { IdempotencyRecord, StoredResponse } from \"../types.js\";\nimport type { IdempotencyStore } from \"./types.js\";\n\nconst DEFAULT_TTL = 24 * 60 * 60 * 1000; // 24 hours\n\ninterface MemoryStoreOptions {\n\tttl?: number;\n}\n\nexport interface MemoryStore extends IdempotencyStore {\n\t/** Number of entries currently in the store (including expired but not yet swept). */\n\treadonly size: number;\n}\n\nexport function memoryStore(options: MemoryStoreOptions = {}): MemoryStore {\n\tconst ttl = options.ttl ?? DEFAULT_TTL;\n\tconst map = new Map<string, IdempotencyRecord>();\n\n\tconst isExpired = (record: IdempotencyRecord): boolean => {\n\t\treturn Date.now() - record.createdAt >= ttl;\n\t};\n\n\tconst sweep = (): void => {\n\t\tfor (const [key, record] of map) {\n\t\t\tif (isExpired(record)) {\n\t\t\t\tmap.delete(key);\n\t\t\t}\n\t\t}\n\t};\n\n\treturn {\n\t\tget size() {\n\t\t\treturn map.size;\n\t\t},\n\n\t\tasync get(key) {\n\t\t\tconst record = map.get(key);\n\t\t\tif (!record) return undefined;\n\t\t\tif (isExpired(record)) {\n\t\t\t\tmap.delete(key);\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\treturn record;\n\t\t},\n\n\t\tasync lock(key, record) {\n\t\t\tsweep();\n\t\t\tconst existing = map.get(key);\n\t\t\tif (existing && !isExpired(existing)) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t\tmap.set(key, record);\n\t\t\treturn true;\n\t\t},\n\n\t\tasync complete(key, response) {\n\t\t\tconst record = map.get(key);\n\t\t\tif (record) {\n\t\t\t\trecord.status = \"completed\";\n\t\t\t\trecord.response = response;\n\t\t\t}\n\t\t},\n\n\t\tasync delete(key) {\n\t\t\tmap.delete(key);\n\t\t},\n\t};\n}\n"],"mappings":";AAGA,IAAM,cAAc,KAAK,KAAK,KAAK;AAW5B,SAAS,YAAY,UAA8B,CAAC,GAAgB;AAC1E,QAAM,MAAM,QAAQ,OAAO;AAC3B,QAAM,MAAM,oBAAI,IAA+B;AAE/C,QAAM,YAAY,CAAC,WAAuC;AACzD,WAAO,KAAK,IAAI,IAAI,OAAO,aAAa;AAAA,EACzC;AAEA,QAAM,QAAQ,MAAY;AACzB,eAAW,CAAC,KAAK,MAAM,KAAK,KAAK;AAChC,UAAI,UAAU,MAAM,GAAG;AACtB,YAAI,OAAO,GAAG;AAAA,MACf;AAAA,IACD;AAAA,EACD;AAEA,SAAO;AAAA,IACN,IAAI,OAAO;AACV,aAAO,IAAI;AAAA,IACZ;AAAA,IAEA,MAAM,IAAI,KAAK;AACd,YAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,UAAI,CAAC,OAAQ,QAAO;AACpB,UAAI,UAAU,MAAM,GAAG;AACtB,YAAI,OAAO,GAAG;AACd,eAAO;AAAA,MACR;AACA,aAAO;AAAA,IACR;AAAA,IAEA,MAAM,KAAK,KAAK,QAAQ;AACvB,YAAM;AACN,YAAM,WAAW,IAAI,IAAI,GAAG;AAC5B,UAAI,YAAY,CAAC,UAAU,QAAQ,GAAG;AACrC,eAAO;AAAA,MACR;AACA,UAAI,IAAI,KAAK,MAAM;AACnB,aAAO;AAAA,IACR;AAAA,IAEA,MAAM,SAAS,KAAK,UAAU;AAC7B,YAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,UAAI,QAAQ;AACX,eAAO,SAAS;AAChB,eAAO,WAAW;AAAA,MACnB;AAAA,IACD;AAAA,IAEA,MAAM,OAAO,KAAK;AACjB,UAAI,OAAO,GAAG;AAAA,IACf;AAAA,EACD;AACD;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hono-idempotency",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Stripe-style Idempotency-Key middleware for Hono. IETF draft-ietf-httpapi-idempotency-key-header compliant.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -98,6 +98,7 @@
     "lint:fix": "biome check --write .",
     "format": "biome format --write .",
     "typecheck": "tsc --noEmit",
-    "release": "pnpm build && changeset publish"
+    "release": "pnpm build && changeset publish",
+    "version-packages": "changeset version && pnpm lint:fix"
   }
 }