@httpquery/edge 0.1.0

package/dist/cloudflare.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Cloudflare Workers helpers for HTTP QUERY (RFC 10008).
+ *
+ * What Cloudflare/Akamai need: cache QUERY by URL+body, not URL alone.
+ */
+import { QUERY_METHOD } from "@httpquery/core";
+import { toCacheApiRequest, queryCacheControl, cdnCacheKey } from "./index.js";
+import { type AutoQueryCacheOptions } from "./auto-cache.js";
+export interface HandleQueryOptions {
+    /** Cache API binding (default caches.default). */
+    cache?: {
+        match: (r: Request) => Promise<Response | undefined>;
+        put: (r: Request, res: Response) => Promise<void>;
+    };
+    /** Shared cache TTL seconds. Default 60. */
+    sMaxAge?: number;
+    /** Accept-Query media types. */
+    acceptQuery?: string[];
+    /** Also accept POST as dual-route (migration). Default true. */
+    allowPost?: boolean;
+    /** CORS origin reflection. Default true. */
+    cors?: boolean;
+    /**
+     * Full auto body-keyed QUERY cache platform (RFC 10008 §2.7).
+     * Default true — closes CF Cache API gap (body not in default key).
+     */
+    autoCache?: boolean;
+    /** Extra options for auto platform */
+    autoCacheOptions?: Omit<AutoQueryCacheOptions, "cache" | "sMaxAge">;
+}
+/**
+ * Wrap a Worker handler with QUERY caching + CORS + dual POST.
+ *
+ * @example
+ * ```ts
+ * export default {
+ *   fetch: handleQuery(async (request, env, ctx) => {
+ *     const body = await request.json()
+ *     return Response.json({ results: search(body) })
+ *   }, { sMaxAge: 120 })
+ * }
+ * ```
+ */
+export declare function handleQuery(handler: (request: Request, env: any, ctx: any) => Promise<Response> | Response, options?: HandleQueryOptions): (request: Request, env: any, ctx: any) => Promise<Response>;
+/**
+ * Minimal Worker export factory for product search style APIs.
+ */
+export declare function createQueryWorker(options: {
+    search: (body: any, env: any) => Promise<unknown> | unknown;
+    sMaxAge?: number;
+    /** Full auto body-keyed cache (default true) */
+    autoCache?: boolean;
+}): {
+    fetch: (request: Request, env: any, ctx: any) => Promise<Response>;
+};
+export { toCacheApiRequest, cdnCacheKey, queryCacheControl, QUERY_METHOD };
+export { withAutoQueryCache, createAutoQueryPlatform, createMemoryCache } from "./auto-cache.js";
+//# sourceMappingURL=cloudflare.d.ts.map

package/dist/cloudflare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAA0C,MAAM,iBAAiB,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAsB,WAAW,EAAE,MAAM,YAAY,CAAC;AACnG,OAAO,EAAsB,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAElD,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,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,OAAO,GAAG,SAAS,CAAC,CAAC;CACrE;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,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,kBAAuB,GAC/B,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,CAyH7D;AAgCD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,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,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG;IAAE,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAAE,CAqBzE;AAED,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/cloudflare.js

@@ -0,0 +1,183 @@
+/**
+ * Cloudflare Workers helpers for HTTP QUERY (RFC 10008).
+ *
+ * What Cloudflare/Akamai need: cache QUERY by URL+body, not URL alone.
+ */
+import { QUERY_METHOD, ACCEPT_QUERY_HEADER, formatAcceptQuery } from "@httpquery/core";
+import { toCacheApiRequest, queryCacheControl, queryOriginHeaders, cdnCacheKey } from "./index.js";
+import { withAutoQueryCache } from "./auto-cache.js";
+function isQueryOrPost(method, allowPost) {
+    const m = method.toUpperCase();
+    return m === QUERY_METHOD || (allowPost && m === "POST");
+}
+/**
+ * Wrap a Worker handler with QUERY caching + CORS + dual POST.
+ *
+ * @example
+ * ```ts
+ * export default {
+ *   fetch: handleQuery(async (request, env, ctx) => {
+ *     const body = await request.json()
+ *     return Response.json({ results: search(body) })
+ *   }, { sMaxAge: 120 })
+ * }
+ * ```
+ */
+export function handleQuery(handler, options = {}) {
+    const allowPost = options.allowPost !== false;
+    const cors = options.cors !== false;
+    const acceptQuery = options.acceptQuery ?? ["application/json"];
+    const sMaxAge = options.sMaxAge ?? 60;
+    const core = async (request, env, ctx) => {
+        const method = request.method.toUpperCase();
+        // CORS preflight
+        if (method === "OPTIONS") {
+            return new Response(null, {
+                status: 204,
+                headers: corsHeaders(request, acceptQuery, cors),
+            });
+        }
+        if (!isQueryOrPost(method, allowPost)) {
+            return new Response("Method Not Allowed", {
+                status: 405,
+                headers: {
+                    Allow: `GET, HEAD, POST, ${QUERY_METHOD}, OPTIONS`,
+                    ...corsHeaders(request, acceptQuery, cors),
+                },
+            });
+        }
+        const response = await handler(request, env, ctx);
+        const headers = new Headers(response.headers);
+        const originHdrs = queryOriginHeaders({
+            acceptQuery,
+            cacheControl: queryCacheControl({ sMaxAge, maxAge: 0, staleWhileRevalidate: 30 }),
+        });
+        for (const [k, v] of Object.entries(originHdrs)) {
+            if (!headers.has(k))
+                headers.set(k, v);
+        }
+        applyCors(headers, request, cors);
+        if (!headers.has("X-HTTP-Query-Cache")) {
+            headers.set("X-HTTP-Query-Cache", "BYPASS");
+        }
+        return new Response(response.body, {
+            status: response.status,
+            statusText: response.statusText,
+            headers,
+        });
+    };
+    // Full auto body-keyed platform (default) — fills CF Cache API gap
+    if (options.autoCache !== false) {
+        return withAutoQueryCache(core, {
+            cache: options.cache,
+            sMaxAge,
+            softTtlSeconds: Math.max(1, Math.floor(sMaxAge / 2)),
+            ...options.autoCacheOptions,
+        });
+    }
+    // Legacy path without auto platform
+    return async (request, env, ctx) => {
+        const method = request.method.toUpperCase();
+        if (method === "OPTIONS") {
+            return new Response(null, {
+                status: 204,
+                headers: corsHeaders(request, acceptQuery, cors),
+            });
+        }
+        if (!isQueryOrPost(method, allowPost)) {
+            return new Response("Method Not Allowed", {
+                status: 405,
+                headers: {
+                    Allow: `GET, HEAD, POST, ${QUERY_METHOD}, OPTIONS`,
+                    ...corsHeaders(request, acceptQuery, cors),
+                },
+            });
+        }
+        const cacheable = method === QUERY_METHOD;
+        const cacheStore = options.cache ?? globalThis.caches?.default;
+        if (cacheable && cacheStore) {
+            const cacheReq = await toCacheApiRequest(request);
+            const hit = await cacheStore.match(cacheReq);
+            if (hit) {
+                const h = new Headers(hit.headers);
+                h.set("X-HTTP-Query-Cache", "HIT");
+                applyCors(h, request, cors);
+                return new Response(hit.body, { status: hit.status, headers: h });
+            }
+        }
+        const response = await handler(request, env, ctx);
+        const headers = new Headers(response.headers);
+        const originHdrs = queryOriginHeaders({
+            acceptQuery,
+            cacheControl: queryCacheControl({ sMaxAge, maxAge: 0, staleWhileRevalidate: 30 }),
+        });
+        for (const [k, v] of Object.entries(originHdrs)) {
+            if (!headers.has(k))
+                headers.set(k, v);
+        }
+        applyCors(headers, request, cors);
+        headers.set("X-HTTP-Query-Cache", "MISS");
+        const out = new Response(response.body, {
+            status: response.status,
+            statusText: response.statusText,
+            headers,
+        });
+        if (cacheable && cacheStore && response.ok) {
+            const cacheReq = await toCacheApiRequest(request);
+            const p = cacheStore.put(cacheReq, out.clone());
+            if (ctx?.waitUntil)
+                ctx.waitUntil(p);
+            else
+                await p;
+        }
+        return out;
+    };
+}
+function corsHeaders(request, acceptQuery, cors) {
+    const h = {
+        Allow: `GET, HEAD, POST, ${QUERY_METHOD}, OPTIONS`,
+        [ACCEPT_QUERY_HEADER]: formatAcceptQuery(acceptQuery),
+    };
+    if (cors) {
+        h["Access-Control-Allow-Origin"] = request.headers.get("Origin") ?? "*";
+        h["Access-Control-Allow-Methods"] = `GET, HEAD, POST, ${QUERY_METHOD}, OPTIONS`;
+        h["Access-Control-Allow-Headers"] =
+            "Content-Type, Accept, Authorization, X-HTTP-Method-Override, Accept-Query";
+        h["Access-Control-Expose-Headers"] =
+            "Accept-Query, Location, Content-Location, Allow, X-HTTP-Query-Cache";
+        h["Access-Control-Max-Age"] = "300";
+    }
+    return h;
+}
+function applyCors(headers, request, cors) {
+    if (!cors)
+        return;
+    const origin = request.headers.get("Origin");
+    if (origin)
+        headers.set("Access-Control-Allow-Origin", origin);
+    else if (!headers.has("Access-Control-Allow-Origin")) {
+        headers.set("Access-Control-Allow-Origin", "*");
+    }
+}
+/**
+ * Minimal Worker export factory for product search style APIs.
+ */
+export function createQueryWorker(options) {
+    return {
+        fetch: handleQuery(async (request, env) => {
+            const body = await request.json().catch(() => ({}));
+            const results = await options.search(body, env);
+            return Response.json({ results, method: request.method }, {
+                headers: {
+                    "Cache-Control": queryCacheControl({
+                        sMaxAge: options.sMaxAge ?? 60,
+                        maxAge: 0,
+                    }),
+                },
+            });
+        }, { sMaxAge: options.sMaxAge, autoCache: options.autoCache !== false }),
+    };
+}
+export { toCacheApiRequest, cdnCacheKey, queryCacheControl, QUERY_METHOD };
+export { withAutoQueryCache, createAutoQueryPlatform, createMemoryCache } from "./auto-cache.js";
+//# sourceMappingURL=cloudflare.js.map

package/dist/cloudflare.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @httpquery/edge — CDN-correct cache keys for HTTP QUERY (RFC 10008 §2.7).
+ *
+ * Cloudflare / Akamai / Fastly need: cache key MUST include request body.
+ * This package builds those keys and helpers for edge runtimes.
+ */
+import { QUERY_METHOD, ACCEPT_QUERY_HEADER, cacheKey, cacheKeySync, formatAcceptQuery, parseAcceptQuery } from "@httpquery/core";
+export { QUERY_METHOD, ACCEPT_QUERY_HEADER, cacheKey, cacheKeySync, formatAcceptQuery, parseAcceptQuery, };
+export interface CdnCacheKeyInput {
+    /** Full request URL (or path + host). */
+    url: string | URL;
+    /** Raw body string or bytes. */
+    body?: string | ArrayBuffer | Uint8Array | null;
+    /** Content-Type (included in key — different formats ≠ same query). */
+    contentType?: string;
+    /** Optional Vary-like headers to fold into the key. */
+    varyHeaders?: Record<string, string | null | undefined>;
+}
+/**
+ * Build a CDN-safe cache key for a QUERY request.
+ * RFC 10008: key MUST incorporate request content + related metadata.
+ *
+ * Use as:
+ * - Cloudflare Cache API: `new Request(cacheUrl)` where cacheUrl embeds this key
+ * - Custom KV key
+ * - Redis key at origin
+ */
+export declare function cdnCacheKey(input: CdnCacheKeyInput): Promise<string>;
+/** Sync FNV variant for environments without crypto.subtle. */
+export declare function cdnCacheKeySync(input: CdnCacheKeyInput): string;
+/**
+ * Turn a QUERY request into a synthetic GET Request URL for Cache API.
+ * Many CDNs/Cache APIs key primarily on GET URL — we embed body hash in the path.
+ *
+ * @example
+ * ```ts
+ * const cacheReq = await toCacheApiRequest(request)
+ * const hit = await caches.default.match(cacheReq)
+ * ```
+ */
+export declare function toCacheApiRequest(request: Request, options?: {
+    cacheHost?: string;
+    prefix?: string;
+}): Promise<Request>;
+/**
+ * Recommended Cache-Control for QUERY responses at edge.
+ * - public + s-maxage: CDN may store
+ * - Vary note: body is in key already; still vary on Accept if you negotiate
+ */
+export declare function queryCacheControl(options?: {
+    /** Shared CDN max age seconds. Default 60. */
+    sMaxAge?: number;
+    /** Browser max age. Default 0 (revalidate). */
+    maxAge?: number;
+    /** private = only browser/app cache, not shared CDN */
+    private?: boolean;
+    /** Immutable-ish short lived search */
+    staleWhileRevalidate?: number;
+}): string;
+/** Headers a QUERY origin should set for CDN friendliness. */
+export declare function queryOriginHeaders(options?: {
+    acceptQuery?: string[];
+    cacheControl?: string;
+    location?: string;
+    contentLocation?: string;
+}): Record<string, string>;
+export { akamaiQueryCacheId, akamaiOpsMarkdown, AKAMAI_EDGEWORKER_QUERY_SAMPLE, AKAMAI_PROPERTY_CHECKLIST, } from "./akamai.js";
+export { OTEL_HTTP_METHOD_QUERY, querySpanAttributes, withQuerySpan, queryLogFields, } from "./otel.js";
+export { withAutoQueryCache, createAutoQueryPlatform, createMemoryCache, type AutoQueryCacheOptions, } from "./auto-cache.js";
+export { withCfNativeBodyCache, createCfNativeQueryWorker, cfBodyCacheKeyRequest, getCfBodyCacheMetrics, resetCfBodyCacheMetrics, type CfNativeBodyCacheOptions, type CfBodyCacheMetrics, } from "./cf-body-cache.js";
+//# 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":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,GACjB,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAClB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;IAChD,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;CACzD;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAW1E;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAqB/D;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC,OAAO,CAAC,CAiBlB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE;IACP,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC1B,GACL,MAAM,CAcR;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAChC,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CACrB,GACL,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB;AAGD,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EACb,cAAc,GACf,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,122 @@
+/**
+ * @httpquery/edge — CDN-correct cache keys for HTTP QUERY (RFC 10008 §2.7).
+ *
+ * Cloudflare / Akamai / Fastly need: cache key MUST include request body.
+ * This package builds those keys and helpers for edge runtimes.
+ */
+import { QUERY_METHOD, ACCEPT_QUERY_HEADER, cacheKey, cacheKeySync, formatAcceptQuery, parseAcceptQuery, } from "@httpquery/core";
+export { QUERY_METHOD, ACCEPT_QUERY_HEADER, cacheKey, cacheKeySync, formatAcceptQuery, parseAcceptQuery, };
+/**
+ * Build a CDN-safe cache key for a QUERY request.
+ * RFC 10008: key MUST incorporate request content + related metadata.
+ *
+ * Use as:
+ * - Cloudflare Cache API: `new Request(cacheUrl)` where cacheUrl embeds this key
+ * - Custom KV key
+ * - Redis key at origin
+ */
+export async function cdnCacheKey(input) {
+    const extra = {};
+    if (input.contentType) {
+        extra["content-type"] = input.contentType.split(";")[0]?.trim().toLowerCase() ?? "";
+    }
+    if (input.varyHeaders) {
+        for (const [k, v] of Object.entries(input.varyHeaders)) {
+            if (v != null && v !== "")
+                extra[k.toLowerCase()] = v;
+        }
+    }
+    return cacheKey(input.url, input.body ?? "", Object.keys(extra).length ? extra : undefined);
+}
+/** Sync FNV variant for environments without crypto.subtle. */
+export function cdnCacheKeySync(input) {
+    const ct = input.contentType?.split(";")[0]?.trim().toLowerCase() ?? "";
+    const body = typeof input.body === "string"
+        ? input.body
+        : input.body == null
+            ? ""
+            : new TextDecoder().decode(input.body instanceof ArrayBuffer ? new Uint8Array(input.body) : input.body);
+    const vary = input.varyHeaders
+        ? Object.entries(input.varyHeaders)
+            .filter(([, v]) => v != null && v !== "")
+            .map(([k, v]) => `${k.toLowerCase()}:${v}`)
+            .sort()
+            .join("&")
+        : "";
+    return cacheKeySync(`${typeof input.url === "string" ? input.url : input.url.toString()}|ct=${ct}|v=${vary}`, body);
+}
+/**
+ * Turn a QUERY request into a synthetic GET Request URL for Cache API.
+ * Many CDNs/Cache APIs key primarily on GET URL — we embed body hash in the path.
+ *
+ * @example
+ * ```ts
+ * const cacheReq = await toCacheApiRequest(request)
+ * const hit = await caches.default.match(cacheReq)
+ * ```
+ */
+export 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 key = await cdnCacheKey({
+        url: `${url.origin}${url.pathname}`,
+        body,
+        contentType: ct,
+        varyHeaders: {
+            accept: request.headers.get("accept"),
+            authorization: request.headers.get("authorization") ? "1" : "0",
+        },
+    });
+    const host = options.cacheHost ?? url.host;
+    const prefix = options.prefix ?? "/__http_query_cache";
+    const cacheUrl = `https://${host}${prefix}/${key}`;
+    return new Request(cacheUrl, { method: "GET" });
+}
+/**
+ * Recommended Cache-Control for QUERY responses at edge.
+ * - public + s-maxage: CDN may store
+ * - Vary note: body is in key already; still vary on Accept if you negotiate
+ */
+export function queryCacheControl(options = {}) {
+    const parts = [];
+    if (options.private) {
+        parts.push("private");
+        parts.push(`max-age=${options.maxAge ?? 0}`);
+    }
+    else {
+        parts.push("public");
+        parts.push(`max-age=${options.maxAge ?? 0}`);
+        parts.push(`s-maxage=${options.sMaxAge ?? 60}`);
+    }
+    if (options.staleWhileRevalidate != null) {
+        parts.push(`stale-while-revalidate=${options.staleWhileRevalidate}`);
+    }
+    return parts.join(", ");
+}
+/** Headers a QUERY origin should set for CDN friendliness. */
+export function queryOriginHeaders(options = {}) {
+    const h = {
+        "Cache-Control": options.cacheControl ?? queryCacheControl({ sMaxAge: 60, maxAge: 0 }),
+        // Body is part of key; Accept still matters for content negotiation
+        Vary: "Accept, Accept-Encoding",
+    };
+    if (options.acceptQuery?.length) {
+        h[ACCEPT_QUERY_HEADER] = formatAcceptQuery(options.acceptQuery);
+    }
+    if (options.location)
+        h.Location = options.location;
+    if (options.contentLocation)
+        h["Content-Location"] = options.contentLocation;
+    h.Allow = `GET, HEAD, POST, ${QUERY_METHOD}, OPTIONS`;
+    return h;
+}
+// Akamai ops + EdgeWorker sketches
+export { akamaiQueryCacheId, akamaiOpsMarkdown, AKAMAI_EDGEWORKER_QUERY_SAMPLE, AKAMAI_PROPERTY_CHECKLIST, } from "./akamai.js";
+// OpenTelemetry / logging attributes for QUERY
+export { OTEL_HTTP_METHOD_QUERY, querySpanAttributes, withQuerySpan, queryLogFields, } from "./otel.js";
+// Full auto body-keyed QUERY cache platform (CF Cache API gap closed)
+export { withAutoQueryCache, createAutoQueryPlatform, createMemoryCache, } from "./auto-cache.js";
+// Strongest Workers body-key platform until CF ships native body keys (workerd#6849)
+export { withCfNativeBodyCache, createCfNativeQueryWorker, cfBodyCacheKeyRequest, getCfBodyCacheMetrics, resetCfBodyCacheMetrics, } from "./cf-body-cache.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/otel.d.ts

@@ -0,0 +1,40 @@
+/**
+ * OpenTelemetry helpers for HTTP QUERY.
+ *
+ * Many OTel agents map unknown methods to `_OTHER` — dashboards lose QUERY.
+ * Set these attributes so metrics/traces stay queryable.
+ */
+export declare const OTEL_HTTP_METHOD_QUERY: "QUERY";
+/**
+ * Semantic attributes for a QUERY span / metric dimension.
+ * Aligns with OTel HTTP semantic conventions + explicit method.
+ */
+export declare function querySpanAttributes(input: {
+    url: string;
+    statusCode?: number;
+    usedFallback?: boolean;
+    methodUsed?: string;
+    bodyBytes?: number;
+}): Record<string, string | number | boolean>;
+/**
+ * Wrap a QUERY call with a generic tracer-like API (no hard dep on @opentelemetry/api).
+ *
+ * @example
+ * ```ts
+ * await withQuerySpan(tracer, { name: 'QUERY /search', url }, () => queryJson(url, init))
+ * ```
+ */
+export declare function withQuerySpan<T>(tracer: {
+    startActiveSpan: (name: string, fn: (span: any) => Promise<T>) => Promise<T>;
+}, opts: {
+    name: string;
+    url: string;
+    bodyBytes?: number;
+}, fn: () => Promise<T>): Promise<T>;
+/** Log-line friendly label so log scrapers don't drop QUERY */
+export declare function queryLogFields(meta: {
+    methodUsed?: string;
+    status?: number;
+    usedFallback?: boolean;
+}): Record<string, unknown>;
+//# sourceMappingURL=otel.d.ts.map

package/dist/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,sBAAsB,EAAG,OAAgB,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAU5C;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,MAAM,EAAE;IAAE,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;CAAE,EACxF,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EACvD,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAuBZ;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO1B"}

package/dist/otel.js

@@ -0,0 +1,70 @@
+/**
+ * OpenTelemetry helpers for HTTP QUERY.
+ *
+ * Many OTel agents map unknown methods to `_OTHER` — dashboards lose QUERY.
+ * Set these attributes so metrics/traces stay queryable.
+ */
+export const OTEL_HTTP_METHOD_QUERY = "QUERY";
+/**
+ * Semantic attributes for a QUERY span / metric dimension.
+ * Aligns with OTel HTTP semantic conventions + explicit method.
+ */
+export function querySpanAttributes(input) {
+    return {
+        "http.request.method": input.methodUsed ?? OTEL_HTTP_METHOD_QUERY,
+        "http.request.method_original": OTEL_HTTP_METHOD_QUERY,
+        "url.full": input.url,
+        ...(input.statusCode != null ? { "http.response.status_code": input.statusCode } : {}),
+        "http.query.used_fallback": Boolean(input.usedFallback),
+        ...(input.bodyBytes != null ? { "http.request.body.size": input.bodyBytes } : {}),
+        "http.query.rfc": "10008",
+    };
+}
+/**
+ * Wrap a QUERY call with a generic tracer-like API (no hard dep on @opentelemetry/api).
+ *
+ * @example
+ * ```ts
+ * await withQuerySpan(tracer, { name: 'QUERY /search', url }, () => queryJson(url, init))
+ * ```
+ */
+export async function withQuerySpan(tracer, opts, fn) {
+    return tracer.startActiveSpan(opts.name, async (span) => {
+        const attrs = querySpanAttributes({
+            url: opts.url,
+            bodyBytes: opts.bodyBytes,
+        });
+        if (typeof span?.setAttributes === "function")
+            span.setAttributes(attrs);
+        else if (typeof span?.setAttribute === "function") {
+            for (const [k, v] of Object.entries(attrs))
+                span.setAttribute(k, v);
+        }
+        try {
+            const out = await fn();
+            if (typeof span?.end === "function")
+                span.end();
+            return out;
+        }
+        catch (e) {
+            if (typeof span?.recordException === "function")
+                span.recordException(e);
+            if (typeof span?.setStatus === "function") {
+                span.setStatus({ code: 2, message: String(e?.message || e) });
+            }
+            if (typeof span?.end === "function")
+                span.end();
+            throw e;
+        }
+    });
+}
+/** Log-line friendly label so log scrapers don't drop QUERY */
+export function queryLogFields(meta) {
+    return {
+        http_method: meta.methodUsed ?? "QUERY",
+        http_method_intended: "QUERY",
+        http_status: meta.status,
+        query_fallback: meta.usedFallback ?? false,
+    };
+}
+//# sourceMappingURL=otel.js.map

package/dist/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.js","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAgB,CAAC;AAEvD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAMnC;IACC,OAAO;QACL,qBAAqB,EAAE,KAAK,CAAC,UAAU,IAAI,sBAAsB;QACjE,8BAA8B,EAAE,sBAAsB;QACtD,UAAU,EAAE,KAAK,CAAC,GAAG;QACrB,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,2BAA2B,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,0BAA0B,EAAE,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC;QACvD,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,wBAAwB,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,gBAAgB,EAAE,OAAO;KAC1B,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAwF,EACxF,IAAuD,EACvD,EAAoB;IAEpB,OAAO,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtD,MAAM,KAAK,GAAG,mBAAmB,CAAC;YAChC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QACH,IAAI,OAAO,IAAI,EAAE,aAAa,KAAK,UAAU;YAAE,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;aACpE,IAAI,OAAO,IAAI,EAAE,YAAY,KAAK,UAAU,EAAE,CAAC;YAClD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,EAAE,CAAC;YACvB,IAAI,OAAO,IAAI,EAAE,GAAG,KAAK,UAAU;gBAAE,IAAI,CAAC,GAAG,EAAE,CAAC;YAChD,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,OAAO,IAAI,EAAE,eAAe,KAAK,UAAU;gBAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YACzE,IAAI,OAAO,IAAI,EAAE,SAAS,KAAK,UAAU,EAAE,CAAC;gBAC1C,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAE,CAAW,EAAE,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;YAC3E,CAAC;YACD,IAAI,OAAO,IAAI,EAAE,GAAG,KAAK,UAAU;gBAAE,IAAI,CAAC,GAAG,EAAE,CAAC;YAChD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,cAAc,CAAC,IAI9B;IACC,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,UAAU,IAAI,OAAO;QACvC,oBAAoB,EAAE,OAAO;QAC7B,WAAW,EAAE,IAAI,CAAC,MAAM;QACxB,cAAc,EAAE,IAAI,CAAC,YAAY,IAAI,KAAK;KAC3C,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@httpquery/edge",
+  "version": "0.1.0",
+  "description": "CDN / Cloudflare Workers helpers for HTTP QUERY (RFC 10008) — cache keys that include body.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cloudflare": {
+      "types": "./dist/cloudflare.d.ts",
+      "import": "./dist/cloudflare.js"
+    },
+    "./akamai": {
+      "types": "./dist/akamai.d.ts",
+      "import": "./dist/akamai.js"
+    },
+    "./otel": {
+      "types": "./dist/otel.d.ts",
+      "import": "./dist/otel.js"
+    },
+    "./auto-cache": {
+      "types": "./dist/auto-cache.d.ts",
+      "import": "./dist/auto-cache.js"
+    },
+    "./cf-body-cache": {
+      "types": "./dist/cf-body-cache.d.ts",
+      "import": "./dist/cf-body-cache.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --experimental-strip-types --test src/*.test.ts"
+  },
+  "dependencies": {
+    "@httpquery/core": "0.1.0"
+  },
+  "keywords": [
+    "http",
+    "query",
+    "rfc10008",
+    "cloudflare",
+    "workers",
+    "cdn",
+    "akamai",
+    "cache"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/http-query/http-query.git",
+    "directory": "packages/edge"
+  },
+  "bugs": {
+    "url": "https://github.com/http-query/http-query/issues"
+  },
+  "homepage": "https://http-query.com",
+  "engines": {
+    "node": ">=18"
+  },
+  "sideEffects": false
+}