@voyantjs/hono 0.80.2 → 0.80.3

package/dist/middleware/idempotency-key.d.ts

@@ -1,5 +1,5 @@
 import type { MiddlewareHandler } from "hono";
-import { type DbFactory, type VoyantBindings, type VoyantVariables } from "../types.js";
+import { type DbFactory, type VoyantBindings, type VoyantDb, type VoyantVariables } from "../types.js";
 /**
  * Twenty-four hours, in milliseconds. Default TTL for stored idempotency
  * keys. Tunable per middleware instance.
@@ -22,6 +22,13 @@ export interface IdempotencyKeyOptions {
      * working through a deprecation window.
      */
     required?: boolean;
+    /**
+     * Query parameters that affect the response contract and should be included
+     * in the idempotency fingerprint alongside the request body. Reusing the
+     * same key with different fingerprinted query values returns 409 instead of
+     * replaying a response captured under different request semantics.
+     */
+    fingerprintSearchParams?: readonly string[];
     /**
      * Optional callback that, given the response body that's about to be
      * stored, returns a `referenceId` (typically the booking id). Used for
@@ -57,9 +64,11 @@ declare module "hono" {
  * the `db` middleware that ships with `createApp`) — caller is responsible
  * for ordering this middleware after `db`.
  */
-export declare function idempotencyKey<TBindings extends VoyantBindings = VoyantBindings>(options?: IdempotencyKeyOptions): MiddlewareHandler<{
+export declare function idempotencyKey<TBindings extends object = VoyantBindings, TVariables extends {
+    db: VoyantDb;
+} = VoyantVariables>(options?: IdempotencyKeyOptions): MiddlewareHandler<{
     Bindings: TBindings;
-    Variables: VoyantVariables;
+    Variables: TVariables;
 }>;
 /**
  * Sweep expired idempotency rows. Call from a daily cron.

package/dist/middleware/idempotency-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"idempotency-key.d.ts","sourceRoot":"","sources":["../../src/middleware/idempotency-key.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAA;AAE7C,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,cAAc,EAEnB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAA;AAEpB;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAAsB,CAAA;AAmB7D,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAClE;AAED,UAAU,sBAAsB;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,kBAAmB,SAAQ,sBAAsB;KAAG;CAC/D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,SAAS,SAAS,cAAc,GAAG,cAAc,EAC9E,OAAO,GAAE,qBAA0B,GAClC,iBAAiB,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAA;IACnB,SAAS,EAAE,eAAe,CAAA;CAC3B,CAAC,CAoID;AAiBD;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAAC,SAAS,SAAS,cAAc,EAChF,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,EAC/B,GAAG,EAAE,SAAS,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAW9B"}
+{"version":3,"file":"idempotency-key.d.ts","sourceRoot":"","sources":["../../src/middleware/idempotency-key.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAA;AAE7C,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,eAAe,EACrB,MAAM,aAAa,CAAA;AAEpB;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAAsB,CAAA;AAmB7D,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAClE;AAED,UAAU,sBAAsB;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,kBAAmB,SAAQ,sBAAsB;KAAG;CAC/D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,SAAS,SAAS,MAAM,GAAG,cAAc,EACzC,UAAU,SAAS;IAAE,EAAE,EAAE,QAAQ,CAAA;CAAE,GAAG,eAAe,EAErD,OAAO,GAAE,qBAA0B,GAClC,iBAAiB,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAA;IACnB,SAAS,EAAE,UAAU,CAAA;CACtB,CAAC,CAuID;AAgCD;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAAC,SAAS,SAAS,cAAc,EAChF,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,EAC/B,GAAG,EAAE,SAAS,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAW9B"}

package/dist/middleware/idempotency-key.js

@@ -56,9 +56,10 @@ export function idempotencyKey(options = {}) {
         if (headerKey.length > 255) {
             return c.json({ error: `${HEADER_NAME} must be 255 characters or fewer` }, 400);
         }
-        const scope = options.scope ?? `${c.req.method} ${new URL(c.req.url).pathname}`;
+        const requestUrl = new URL(c.req.url);
+        const scope = options.scope ?? `${c.req.method} ${requestUrl.pathname}`;
         const rawBody = await c.req.text();
-        const bodyHash = await sha256Hex(rawBody);
+        const bodyHash = await sha256Hex(buildFingerprintInput(rawBody, requestUrl, options.fingerprintSearchParams));
         // The `db` middleware always unwraps a `DisposableDb` to a plain
         // `VoyantDb` before storing on context, so this cast is safe.
         const db = c.get("db");
@@ -152,6 +153,15 @@ export function idempotencyKey(options = {}) {
         }
     };
 }
+function buildFingerprintInput(rawBody, url, searchParamKeys) {
+    if (!searchParamKeys?.length)
+        return rawBody;
+    const queryFingerprint = searchParamKeys.map((key) => [key, url.searchParams.getAll(key).sort()]);
+    return JSON.stringify({
+        body: rawBody,
+        query: queryFingerprint,
+    });
+}
 function pickStringField(body, keys) {
     if (!body || typeof body !== "object")
         return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/hono",
-  "version": "0.80.2",
+  "version": "0.80.3",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -99,18 +99,18 @@
     "drizzle-orm": "^0.45.2",
     "hono": "^4.12.10",
     "zod": "^4.3.6",
-    "@voyantjs/core": "0.80.2",
-    "@voyantjs/db": "0.80.2",
-    "@voyantjs/types": "0.80.2",
-    "@voyantjs/utils": "0.80.2",
-    "@voyantjs/workflows": "0.80.2"
+    "@voyantjs/core": "0.80.3",
+    "@voyantjs/db": "0.80.3",
+    "@voyantjs/types": "0.80.3",
+    "@voyantjs/utils": "0.80.3",
+    "@voyantjs/workflows": "0.80.3"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20260426.1",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2",
     "@voyantjs/voyant-typescript-config": "0.1.0",
-    "@voyantjs/workflows-orchestrator": "0.80.2"
+    "@voyantjs/workflows-orchestrator": "0.80.3"
   },
   "files": [
     "dist"