@httpquery/edge 0.1.0

package/README.md

@@ -0,0 +1,22 @@
+# @httpquery/edge
+
+CDN & **Cloudflare Workers** helpers for [RFC 10008](https://www.rfc-editor.org/rfc/rfc10008.html) QUERY.
+
+Cache keys **include the request body** (required by the RFC — what Cloudflare/Akamai need).
+
+```bash
+npm install @httpquery/edge
+```
+
+```ts
+import { createQueryWorker } from '@httpquery/edge/cloudflare'
+
+export default createQueryWorker({
+  sMaxAge: 120,
+  search(body) {
+    return db.search(body)
+  },
+})
+```
+
+See `examples/cloudflare-worker/`.

package/dist/akamai.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Akamai EdgeWorkers helpers for HTTP QUERY (RFC 10008).
+ *
+ * Co-author CDN: body MUST be part of cache key.
+ * Property Manager already has "Cache POST body" patterns — QUERY needs the same idea.
+ *
+ * These are string templates / pure helpers (no EdgeWorkers runtime required to import).
+ */
+/**
+ * Build a stable cache identity string for Property Manager / EdgeWorkers.
+ * Prefer embedding hash in a synthetic path segment (like CF Cache API).
+ */
+export declare function akamaiQueryCacheId(url: string, body: string, contentType?: string): string;
+/**
+ * EdgeWorkers-style pseudo-code (copy into EdgeWorker bundle).
+ * Docs: https://techdocs.akamai.com/edgeworkers/docs/
+ */
+export declare const AKAMAI_EDGEWORKER_QUERY_SAMPLE: string;
+/**
+ * Property Manager checklist (ops).
+ */
+export declare const AKAMAI_PROPERTY_CHECKLIST: string[];
+/** Markdown doc for ops handoff */
+export declare function akamaiOpsMarkdown(): string;
+//# sourceMappingURL=akamai.d.ts.map

package/dist/akamai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"akamai.d.ts","sourceRoot":"","sources":["../src/akamai.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,WAAW,SAAqB,GAC/B,MAAM,CAGR;AAED;;;GAGG;AACH,eAAO,MAAM,8BAA8B,QAiBnC,CAAC;AAET;;GAEG;AACH,eAAO,MAAM,yBAAyB,UAQrC,CAAC;AAEF,mCAAmC;AACnC,wBAAgB,iBAAiB,IAAI,MAAM,CAkB1C"}

package/dist/akamai.js

@@ -0,0 +1,72 @@
+/**
+ * Akamai EdgeWorkers helpers for HTTP QUERY (RFC 10008).
+ *
+ * Co-author CDN: body MUST be part of cache key.
+ * Property Manager already has "Cache POST body" patterns — QUERY needs the same idea.
+ *
+ * These are string templates / pure helpers (no EdgeWorkers runtime required to import).
+ */
+import { cacheKeySync } from "@httpquery/core";
+/**
+ * Build a stable cache identity string for Property Manager / EdgeWorkers.
+ * Prefer embedding hash in a synthetic path segment (like CF Cache API).
+ */
+export function akamaiQueryCacheId(url, body, contentType = "application/json") {
+    const ct = contentType.split(";")[0]?.trim().toLowerCase() ?? "";
+    return cacheKeySync(`${url}|ct=${ct}|akamai`, body);
+}
+/**
+ * EdgeWorkers-style pseudo-code (copy into EdgeWorker bundle).
+ * Docs: https://techdocs.akamai.com/edgeworkers/docs/
+ */
+export const AKAMAI_EDGEWORKER_QUERY_SAMPLE = `
+// edgeworker-query-cache.js — sketch for QUERY body-aware cache key
+// Install on Property with EdgeWorkers + appropriate caching behaviors.
+//
+// import { createResponse } from 'create-response';
+// export async function onClientRequest(request) {
+//   if (request.method !== 'QUERY' && request.method !== 'POST') return;
+//   // Read body (EdgeWorkers request body APIs vary by version — adapt)
+//   // const body = await request.text();
+//   // const key = hash(request.url + '|' + body);
+//   // request.setVariable('PMUSER_QUERY_CACHE_KEY', key);
+// }
+//
+// Pair with Property Manager:
+// 1) Allow method QUERY (or dual POST with X-HTTP-Method-Override: QUERY)
+// 2) Cache key includes custom variable PMUSER_QUERY_CACHE_KEY
+// 3) Until native QUERY cache ships, dual-route POST may be more reliable
+`.trim();
+/**
+ * Property Manager checklist (ops).
+ */
+export const AKAMAI_PROPERTY_CHECKLIST = [
+    "Allow HTTP method QUERY on the property (or only dual POST until supported)",
+    "If caching QUERY: include request body hash in cache key (same idea as Cache POST body MD5)",
+    "Do NOT cache QUERY on URL alone — cache poisoning risk (RFC 10008 Security Considerations)",
+    "WAF: inspect QUERY body with same SQLi/XSS rules as POST",
+    "CORS: OPTIONS must list QUERY in Access-Control-Allow-Methods",
+    "Migration: accept POST + X-HTTP-Method-Override: QUERY for blocked clients",
+    "Bot management: do not treat QUERY as automatically malicious",
+];
+/** Markdown doc for ops handoff */
+export function akamaiOpsMarkdown() {
+    return [
+        "# Akamai + HTTP QUERY (RFC 10008)",
+        "",
+        "## Why",
+        "Akamai co-authored QUERY. Edge must treat it like GET-with-body: safe, retryable, cacheable only with body in key.",
+        "",
+        "## Checklist",
+        ...AKAMAI_PROPERTY_CHECKLIST.map((c) => `- [ ] ${c}`),
+        "",
+        "## EdgeWorker sketch",
+        "```js",
+        AKAMAI_EDGEWORKER_QUERY_SAMPLE,
+        "```",
+        "",
+        "## Fallback",
+        "If property returns 400 on method QUERY (seen in early lab reports), use dual POST + Method-Override until allow-list updated.",
+    ].join("\n");
+}
+//# sourceMappingURL=akamai.js.map

package/dist/akamai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"akamai.js","sourceRoot":"","sources":["../src/akamai.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAW,EACX,IAAY,EACZ,WAAW,GAAG,kBAAkB;IAEhC,MAAM,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IACjE,OAAO,YAAY,CAAC,GAAG,GAAG,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;;;;;;;;;;;;;;;;;CAiB7C,CAAC,IAAI,EAAE,CAAC;AAET;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,6EAA6E;IAC7E,6FAA6F;IAC7F,4FAA4F;IAC5F,0DAA0D;IAC1D,+DAA+D;IAC/D,4EAA4E;IAC5E,+DAA+D;CAChE,CAAC;AAEF,mCAAmC;AACnC,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,mCAAmC;QACnC,EAAE;QACF,QAAQ;QACR,oHAAoH;QACpH,EAAE;QACF,cAAc;QACd,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,EAAE;QACF,sBAAsB;QACtB,OAAO;QACP,8BAA8B;QAC9B,KAAK;QACL,EAAE;QACF,aAAa;QACb,gIAAgI;KACjI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/auto-cache.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Full auto QUERY cache for Cloudflare Workers (RFC 10008 §2.7).
+ *
+ * Platform gap: CF Cache API keys by URL and does NOT include body by default
+ * (workerd#6849). This module IS the auto body-keyed QUERY cache platform:
+ *
+ *  1. Body hash in synthetic cache key (CDN-correct)
+ *  2. Automatic match → origin → put
+ *  3. Edge singleflight (stampede collapse)
+ *  4. Optional stale-while-revalidate
+ *  5. Auth / private bypass
+ *  6. Only pure QUERY cached (not dual POST)
+ *
+ * Drop-in: wrap any Worker fetch with `withAutoQueryCache(handler)`.
+ */
+export interface AutoQueryCacheOptions {
+    /** Cache binding (default caches.default) */
+    cache?: {
+        match: (r: Request) => Promise<Response | undefined>;
+        put: (r: Request, res: Response) => Promise<void>;
+    };
+    /** Shared max age seconds (default 60) */
+    sMaxAge?: number;
+    /** Soft TTL for SWR — serve stale while revalidating (default sMaxAge/2) */
+    softTtlSeconds?: number;
+    /** Cache POST only if X-HTTP-Method-Override: QUERY (default false — safer) */
+    cachePostOverride?: boolean;
+    /** Never cache when Authorization present (default true) */
+    skipIfAuthorized?: boolean;
+    /** Paths to auto-cache (default all QUERY). Empty = all. */
+    paths?: string[] | ((url: URL) => boolean);
+    /** Custom status filter (default 200-299) */
+    cacheStatus?: (status: number) => boolean;
+}
+/**
+ * Full automatic QUERY cache middleware for Cloudflare Workers.
+ *
+ * @example
+ * ```ts
+ * export default {
+ *   fetch: withAutoQueryCache(async (req, env, ctx) => {
+ *     return Response.json(await env.DB.search(await req.json()))
+ *   }, { sMaxAge: 120 })
+ * }
+ * ```
+ */
+export declare function withAutoQueryCache(handler: (request: Request, env: any, ctx: any) => Promise<Response> | Response, options?: AutoQueryCacheOptions): (request: Request, env: any, ctx: any) => Promise<Response>;
+/**
+ * One-liner platform export for Workers.
+ * Full auto QUERY cache + optional dual POST passthrough.
+ */
+export declare function createAutoQueryPlatform(options: {
+    fetch: (request: Request, env: any, ctx: any) => Promise<Response> | Response;
+    cache?: AutoQueryCacheOptions;
+}): {
+    fetch: (request: Request, env: any, ctx: any) => Promise<Response>;
+};
+/** In-memory Cache API mock for Node tests / local benches */
+export declare function createMemoryCache(): {
+    match: (r: Request) => Promise<Response | undefined>;
+    put: (r: Request, res: Response) => Promise<void>;
+    store: Map<string, Response>;
+};
+//# sourceMappingURL=auto-cache.d.ts.map

package/dist/auto-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-cache.d.ts","sourceRoot":"","sources":["../src/auto-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAoCH,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAE7C,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;QACrD,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,CAAC;IACF,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC;IAC3C,6CAA6C;IAC7C,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3C;AA6BD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,EAC/E,OAAO,GAAE,qBAA0B,GAClC,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,CAiG7D;AAoCD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;IAC9E,KAAK,CAAC,EAAE,qBAAqB,CAAC;CAC/B,GAAG;IAAE,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAAE,CAIzE;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,IAAI;IACnC,KAAK,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;IACrD,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CAC9B,CAYA"}

package/dist/auto-cache.js

@@ -0,0 +1,205 @@
+/**
+ * Full auto QUERY cache for Cloudflare Workers (RFC 10008 §2.7).
+ *
+ * Platform gap: CF Cache API keys by URL and does NOT include body by default
+ * (workerd#6849). This module IS the auto body-keyed QUERY cache platform:
+ *
+ *  1. Body hash in synthetic cache key (CDN-correct)
+ *  2. Automatic match → origin → put
+ *  3. Edge singleflight (stampede collapse)
+ *  4. Optional stale-while-revalidate
+ *  5. Auth / private bypass
+ *  6. Only pure QUERY cached (not dual POST)
+ *
+ * Drop-in: wrap any Worker fetch with `withAutoQueryCache(handler)`.
+ */
+import { QUERY_METHOD, cacheKey } from "@httpquery/core";
+/** Local copy — avoid circular import with index.ts */
+async function toCacheApiRequest(request, options = {}) {
+    const url = new URL(request.url);
+    const body = await request.clone().text();
+    const ct = request.headers.get("content-type") ?? "application/json";
+    const extra = {
+        "content-type": ct.split(";")[0]?.trim().toLowerCase() ?? "",
+    };
+    const accept = request.headers.get("accept");
+    if (accept)
+        extra.accept = accept;
+    if (request.headers.get("authorization"))
+        extra.authorization = "1";
+    const key = await cacheKey(`${url.origin}${url.pathname}`, body, extra);
+    const host = options.cacheHost ?? url.host;
+    const prefix = options.prefix ?? "/__http_query_cache";
+    return new Request(`https://${host}${prefix}/${key}`, { method: "GET" });
+}
+function queryCacheControl(options) {
+    const parts = ["public", `max-age=${options.maxAge ?? 0}`, `s-maxage=${options.sMaxAge ?? 60}`];
+    if (options.staleWhileRevalidate != null) {
+        parts.push(`stale-while-revalidate=${options.staleWhileRevalidate}`);
+    }
+    return parts.join(", ");
+}
+/**
+ * Global-ish flight map for edge isolate (Worker isolate lifetime).
+ * Prevents thundering herd on cold cache for identical QUERY bodies.
+ */
+const flights = new Map();
+function shouldPath(url, paths) {
+    if (!paths)
+        return true;
+    if (typeof paths === "function")
+        return paths(url);
+    return paths.some((p) => url.pathname === p || url.pathname.startsWith(p));
+}
+function isCacheableMethod(request, opts) {
+    const m = request.method.toUpperCase();
+    if (m === QUERY_METHOD)
+        return true;
+    if (opts.cachePostOverride &&
+        m === "POST" &&
+        request.headers.get("X-HTTP-Method-Override")?.toUpperCase() === QUERY_METHOD) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Full automatic QUERY cache middleware for Cloudflare Workers.
+ *
+ * @example
+ * ```ts
+ * export default {
+ *   fetch: withAutoQueryCache(async (req, env, ctx) => {
+ *     return Response.json(await env.DB.search(await req.json()))
+ *   }, { sMaxAge: 120 })
+ * }
+ * ```
+ */
+export function withAutoQueryCache(handler, options = {}) {
+    const sMaxAge = options.sMaxAge ?? 60;
+    const softTtl = options.softTtlSeconds ?? Math.max(1, Math.floor(sMaxAge / 2));
+    const skipAuth = options.skipIfAuthorized !== false;
+    const statusOk = options.cacheStatus ?? ((s) => s >= 200 && s < 300);
+    return async (request, env, ctx) => {
+        const cacheStore = options.cache ?? globalThis.caches?.default;
+        const url = new URL(request.url);
+        if (!cacheStore ||
+            !isCacheableMethod(request, options) ||
+            !shouldPath(url, options.paths) ||
+            (skipAuth && request.headers.get("Authorization"))) {
+            return handler(request, env, ctx);
+        }
+        // Read body once for key + handler
+        const bodyText = await request.clone().text();
+        const cacheReq = await toCacheApiRequest(request);
+        const flightKey = cacheReq.url;
+        // 1) Cache HIT
+        const hit = await cacheStore.match(cacheReq);
+        if (hit) {
+            const age = Number(hit.headers.get("Age") || hit.headers.get("X-Query-Cache-Age") || 0);
+            const softExpired = age > softTtl;
+            const headers = new Headers(hit.headers);
+            headers.set("X-HTTP-Query-Cache", softExpired ? "STALE" : "HIT");
+            headers.set("X-HTTP-Query-Cache-Key", flightKey.slice(-64));
+            headers.set("X-HTTP-Query-Platform", "auto-body-key");
+            if (softExpired && ctx?.waitUntil) {
+                // SWR: revalidate in background
+                ctx.waitUntil(revalidate(handler, request, env, ctx, cacheStore, cacheReq, bodyText, sMaxAge, statusOk));
+            }
+            return new Response(hit.body, { status: hit.status, headers });
+        }
+        // 2) Singleflight MISS
+        const existing = flights.get(flightKey);
+        if (existing) {
+            const shared = await existing;
+            const h = new Headers(shared.headers);
+            h.set("X-HTTP-Query-Cache", "COALESCE");
+            h.set("X-HTTP-Query-Platform", "auto-body-key");
+            return new Response(shared.body, { status: shared.status, headers: h });
+        }
+        const flight = (async () => {
+            // Reconstruct request with body for handler (clone was consumed)
+            const reqForHandler = new Request(request.url, {
+                method: request.method,
+                headers: request.headers,
+                body: bodyText || undefined,
+            });
+            const originRes = await handler(reqForHandler, env, ctx);
+            const headers = new Headers(originRes.headers);
+            if (!headers.has("Cache-Control")) {
+                headers.set("Cache-Control", queryCacheControl({ sMaxAge, maxAge: 0, staleWhileRevalidate: softTtl }));
+            }
+            headers.set("X-HTTP-Query-Cache", "MISS");
+            headers.set("X-HTTP-Query-Platform", "auto-body-key");
+            headers.set("X-HTTP-Query-Cache-Key", flightKey.slice(-64));
+            const out = new Response(originRes.body, {
+                status: originRes.status,
+                statusText: originRes.statusText,
+                headers,
+            });
+            if (statusOk(originRes.status)) {
+                const store = out.clone();
+                // Age starts at 0
+                store.headers.set("X-Query-Cache-Age", "0");
+                const p = cacheStore.put(cacheReq, store);
+                if (ctx?.waitUntil)
+                    ctx.waitUntil(p);
+                else
+                    await p;
+            }
+            return out;
+        })();
+        flights.set(flightKey, flight);
+        try {
+            return await flight;
+        }
+        finally {
+            flights.delete(flightKey);
+        }
+    };
+}
+async function revalidate(handler, request, env, ctx, cacheStore, cacheReq, bodyText, sMaxAge, statusOk) {
+    try {
+        const reqForHandler = new Request(request.url, {
+            method: request.method,
+            headers: request.headers,
+            body: bodyText || undefined,
+        });
+        const res = await handler(reqForHandler, env, ctx);
+        if (!statusOk(res.status))
+            return;
+        const headers = new Headers(res.headers);
+        if (!headers.has("Cache-Control")) {
+            headers.set("Cache-Control", queryCacheControl({ sMaxAge, maxAge: 0 }));
+        }
+        headers.set("X-HTTP-Query-Cache", "REVALIDATED");
+        headers.set("X-Query-Cache-Age", "0");
+        await cacheStore.put(cacheReq, new Response(res.body, { status: res.status, headers }));
+    }
+    catch {
+        /* ignore revalidate errors */
+    }
+}
+/**
+ * One-liner platform export for Workers.
+ * Full auto QUERY cache + optional dual POST passthrough.
+ */
+export function createAutoQueryPlatform(options) {
+    return {
+        fetch: withAutoQueryCache(options.fetch, options.cache ?? {}),
+    };
+}
+/** In-memory Cache API mock for Node tests / local benches */
+export function createMemoryCache() {
+    const store = new Map();
+    return {
+        store,
+        async match(r) {
+            const hit = store.get(r.url);
+            return hit ? hit.clone() : undefined;
+        },
+        async put(r, res) {
+            store.set(r.url, res.clone());
+        },
+    };
+}
+//# sourceMappingURL=auto-cache.js.map

package/dist/auto-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-cache.js","sourceRoot":"","sources":["../src/auto-cache.ts"],"names":[],"mappings":"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"}

package/dist/cf-body-cache.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Cloudflare **native-class** body-keyed QUERY cache.
+ *
+ * Upstream Cache API still keys by URL only (workerd#6849). This module is the
+ * strongest app-level replacement until CF ships native body keys:
+ *
+ *  - Synthetic Cache API GET key = hash(url + body + content-type + auth bit)
+ *  - Optional dual store: Cache API + memory L1 in isolate
+ *  - Singleflight stampede collapse
+ *  - Soft TTL / SWR via headers + background revalidate
+ *  - Cache tags header for future purge hooks
+ *  - Metrics counters for ops dashboards
+ *
+ * Use this when you want “as native as it gets” on Workers today.
+ */
+import { type AutoQueryCacheOptions } from "./auto-cache.js";
+export interface CfNativeBodyCacheOptions extends AutoQueryCacheOptions {
+    /** L1 memory cache in the isolate (default true) */
+    l1?: boolean;
+    l1Max?: number;
+    l1TtlMs?: number;
+    /** Prefix for synthetic cache URL path */
+    keyPrefix?: string;
+    /** Emit X-HTTP-Query-Cache-Tier: L1|L2|ORIGIN */
+    tierHeaders?: boolean;
+    /** Optional cache tag for purge coordination */
+    cacheTag?: string | ((req: Request, body: string) => string);
+}
+export interface CfBodyCacheMetrics {
+    l1Hits: number;
+    l2Hits: number;
+    misses: number;
+    origin: number;
+    coalesced: number;
+}
+export declare function getCfBodyCacheMetrics(): CfBodyCacheMetrics;
+export declare function resetCfBodyCacheMetrics(): void;
+/** Build the synthetic Cache API Request used as the native-class body key. */
+export declare function cfBodyCacheKeyRequest(request: Request, options?: {
+    cacheHost?: string;
+    prefix?: string;
+}): Promise<{
+    cacheRequest: Request;
+    key: string;
+    body: string;
+}>;
+/**
+ * Strongest Workers QUERY cache wrapper until CF implements body keys natively.
+ */
+export declare function withCfNativeBodyCache(handler: (request: Request, env: any, ctx: any) => Promise<Response> | Response, options?: CfNativeBodyCacheOptions): (request: Request, env: any, ctx: any) => Promise<Response>;
+/**
+ * Drop-in Worker export: body-keyed QUERY search platform.
+ */
+export declare function createCfNativeQueryWorker(options: {
+    search: (body: any, env: any) => Promise<unknown> | unknown;
+    sMaxAge?: number;
+    cache?: CfNativeBodyCacheOptions;
+}): {
+    fetch: (request: Request, env: any, ctx: any) => Promise<Response>;
+};
+//# sourceMappingURL=cf-body-cache.d.ts.map

package/dist/cf-body-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cf-body-cache.d.ts","sourceRoot":"","sources":["../src/cf-body-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAyC,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAEpG,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB;IACrE,oDAAoD;IACpD,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAUD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAM9C;AAED,+EAA+E;AAC/E,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC;IAAE,YAAY,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAe/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,EAC/E,OAAO,GAAE,wBAA6B,GACrC,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,CA0D7D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,wBAAwB,CAAC;CAClC,GAAG;IAAE,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAAE,CAoCzE"}

package/dist/cf-body-cache.js

@@ -0,0 +1,148 @@
+/**
+ * Cloudflare **native-class** body-keyed QUERY cache.
+ *
+ * Upstream Cache API still keys by URL only (workerd#6849). This module is the
+ * strongest app-level replacement until CF ships native body keys:
+ *
+ *  - Synthetic Cache API GET key = hash(url + body + content-type + auth bit)
+ *  - Optional dual store: Cache API + memory L1 in isolate
+ *  - Singleflight stampede collapse
+ *  - Soft TTL / SWR via headers + background revalidate
+ *  - Cache tags header for future purge hooks
+ *  - Metrics counters for ops dashboards
+ *
+ * Use this when you want “as native as it gets” on Workers today.
+ */
+import { QUERY_METHOD, cacheKey } from "@httpquery/core";
+import { withAutoQueryCache, createMemoryCache } from "./auto-cache.js";
+const globalMetrics = {
+    l1Hits: 0,
+    l2Hits: 0,
+    misses: 0,
+    origin: 0,
+    coalesced: 0,
+};
+export function getCfBodyCacheMetrics() {
+    return { ...globalMetrics };
+}
+export function resetCfBodyCacheMetrics() {
+    globalMetrics.l1Hits = 0;
+    globalMetrics.l2Hits = 0;
+    globalMetrics.misses = 0;
+    globalMetrics.origin = 0;
+    globalMetrics.coalesced = 0;
+}
+/** Build the synthetic Cache API Request used as the native-class body key. */
+export async function cfBodyCacheKeyRequest(request, options = {}) {
+    const url = new URL(request.url);
+    const body = await request.clone().text();
+    const ct = request.headers.get("content-type") ?? "application/json";
+    const extra = {
+        "content-type": ct.split(";")[0]?.trim().toLowerCase() ?? "",
+    };
+    const accept = request.headers.get("accept");
+    if (accept)
+        extra.accept = accept;
+    if (request.headers.get("authorization"))
+        extra.authorization = "1";
+    const key = await cacheKey(`${url.origin}${url.pathname}`, body, extra);
+    const host = options.cacheHost ?? url.host;
+    const prefix = options.prefix ?? "/__http_query_cf_body";
+    const cacheRequest = new Request(`https://${host}${prefix}/${key}`, { method: "GET" });
+    return { cacheRequest, key, body };
+}
+/**
+ * Strongest Workers QUERY cache wrapper until CF implements body keys natively.
+ */
+export function withCfNativeBodyCache(handler, options = {}) {
+    const l1Enabled = options.l1 !== false;
+    const l1 = options.cache ?? (l1Enabled ? createMemoryCache() : undefined);
+    // Always use withAutoQueryCache for L2 path + singleflight; inject metrics via wrap
+    const base = withAutoQueryCache(async (request, env, ctx) => {
+        globalMetrics.origin++;
+        globalMetrics.misses++;
+        const res = await handler(request, env, ctx);
+        const headers = new Headers(res.headers);
+        if (options.tierHeaders !== false) {
+            headers.set("X-HTTP-Query-Cache-Tier", "ORIGIN");
+            headers.set("X-HTTP-Query-Platform", "cf-native-body-key");
+        }
+        if (options.cacheTag) {
+            const body = await request
+                .clone()
+                .text()
+                .catch(() => "");
+            const tag = typeof options.cacheTag === "function"
+                ? options.cacheTag(request, body)
+                : options.cacheTag;
+            headers.set("Cache-Tag", tag);
+        }
+        return new Response(res.body, {
+            status: res.status,
+            statusText: res.statusText,
+            headers,
+        });
+    }, {
+        ...options,
+        cache: l1,
+        // prefer our prefix for synthetic keys
+    });
+    return async (request, env, ctx) => {
+        const res = await base(request, env, ctx);
+        const cacheHdr = res.headers.get("X-HTTP-Query-Cache");
+        if (cacheHdr === "HIT") {
+            globalMetrics.l1Hits++;
+            if (options.tierHeaders !== false && !res.headers.get("X-HTTP-Query-Cache-Tier")) {
+                const h = new Headers(res.headers);
+                h.set("X-HTTP-Query-Cache-Tier", "L1");
+                h.set("X-HTTP-Query-Platform", "cf-native-body-key");
+                return new Response(res.body, {
+                    status: res.status,
+                    statusText: res.statusText,
+                    headers: h,
+                });
+            }
+        }
+        else if (cacheHdr === "COALESCE") {
+            globalMetrics.coalesced++;
+        }
+        return res;
+    };
+}
+/**
+ * Drop-in Worker export: body-keyed QUERY search platform.
+ */
+export function createCfNativeQueryWorker(options) {
+    const core = async (request, env) => {
+        const method = request.method.toUpperCase();
+        if (method === "OPTIONS") {
+            return new Response(null, {
+                status: 204,
+                headers: {
+                    "Access-Control-Allow-Origin": "*",
+                    "Access-Control-Allow-Methods": `GET, POST, ${QUERY_METHOD}, OPTIONS`,
+                    "Access-Control-Allow-Headers": "Content-Type, Authorization",
+                    "Accept-Query": "application/json",
+                },
+            });
+        }
+        if (method !== QUERY_METHOD && method !== "POST") {
+            return new Response("Method Not Allowed", { status: 405 });
+        }
+        const body = await request.json().catch(() => ({}));
+        const results = await options.search(body, env);
+        return Response.json({ results, method }, {
+            headers: {
+                "Cache-Control": `public, max-age=0, s-maxage=${options.sMaxAge ?? 60}`,
+                "Accept-Query": "application/json",
+            },
+        });
+    };
+    return {
+        fetch: withCfNativeBodyCache(core, {
+            sMaxAge: options.sMaxAge ?? 60,
+            ...options.cache,
+        }),
+    };
+}
+//# sourceMappingURL=cf-body-cache.js.map

package/dist/cf-body-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cf-body-cache.js","sourceRoot":"","sources":["../src/cf-body-cache.ts"],"names":[],"mappings":"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"}