@lovrozagar/honey 0.6.8 → 0.7.0

package/dist/curl-logger.js

@@ -0,0 +1,199 @@
+import { namedMiddleware } from "./middleware.js";
+import { shellQuote } from "./request-to-curl.js";
+const DEFAULT_BODY_CONTENT_TYPES = ["application/json", "application/x-www-form-urlencoded", "application/xml", "text/"];
+const DEFAULT_MAX_BODY_BYTES = 16_384;
+const REDACTED = "[REDACTED]";
+const SENSITIVE_HEADERS = new Set([
+    "authorization",
+    "cookie",
+    "proxy-authorization",
+    "set-cookie",
+    "x-api-key",
+    "x-auth-token",
+    "x-csrf-token",
+    "x-xsrf-token",
+]);
+const SENSITIVE_HEADER_RE = /(?:^|-)(?:token|secret|api-?key|password|session)(?:$|-)/i;
+const SENSITIVE_PARAM_RE = /(?:^|[_.-])(?:access_?token|refresh_?token|id_?token|token|secret|client_?secret|password|passwd|pwd|api_?key|apikey|key|sig|signature|auth|code|session|jwt)$/i;
+function defaultRedactHeader(name, value) {
+    const lower = name.toLowerCase();
+    if (SENSITIVE_HEADERS.has(lower) || SENSITIVE_HEADER_RE.test(lower))
+        return REDACTED;
+    return value;
+}
+function defaultRedactQueryParam(name, value) {
+    return SENSITIVE_PARAM_RE.test(name) ? REDACTED : value;
+}
+function defaultLog(data) {
+    console.log(data.curl);
+}
+function shouldIncludeBody(contentType, allowContentTypes) {
+    if (contentType === null || contentType.length === 0)
+        return false;
+    const lower = contentType.toLowerCase();
+    return allowContentTypes.some((allowed) => lower.startsWith(allowed.toLowerCase()));
+}
+function redactUrl(rawUrl, redactQueryParam) {
+    let url;
+    try {
+        url = new URL(rawUrl);
+    }
+    catch {
+        /* a malformed Host (Node builds the URL from it) must not fail the request */
+        return rawUrl.split("?")[0] ?? rawUrl;
+    }
+    if (url.search.length === 0)
+        return url.toString();
+    const params = new URLSearchParams();
+    for (const [name, value] of url.searchParams) {
+        const nextValue = redactQueryParam(name, value);
+        if (nextValue !== null)
+            params.append(name, nextValue);
+    }
+    url.search = params.toString();
+    return url.toString();
+}
+/**
+ * A second, independent reader of the request body. On Node the request is
+ * re-pointed at one branch of a tee (the same hook `bodyLimit` uses) rather
+ * than `clone()`d, so later body readers keep working.
+ */
+function teeBody(request) {
+    const body = request.body;
+    if (body === null)
+        return null;
+    const replaceBody = request[Symbol.for("honey.replaceBody")];
+    if (typeof replaceBody === "function") {
+        const [forRequest, forLog] = body.tee();
+        replaceBody.call(request, forRequest);
+        return forLog;
+    }
+    return request.clone().body;
+}
+/** Never rejects: a body that cannot be read is logged as omitted. */
+async function readBodyWithinLimit(request, maxBytes) {
+    try {
+        if (request.body === null)
+            return { body: null, omittedReason: "missing" };
+        const contentLength = request.headers.get("content-length");
+        if (contentLength !== null) {
+            const parsedLength = Number.parseInt(contentLength, 10);
+            if (!Number.isNaN(parsedLength) && parsedLength > maxBytes) {
+                return { body: null, omittedReason: "too-large" };
+            }
+        }
+        const stream = teeBody(request);
+        if (stream === null)
+            return { body: null, omittedReason: "missing" };
+        const reader = stream.getReader();
+        const chunks = [];
+        let totalBytes = 0;
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            totalBytes += value.byteLength;
+            if (totalBytes > maxBytes) {
+                await reader.cancel().catch(() => { });
+                return { body: null, omittedReason: "too-large" };
+            }
+            chunks.push(value);
+        }
+        const bytes = new Uint8Array(totalBytes);
+        let offset = 0;
+        for (const chunk of chunks) {
+            bytes.set(chunk, offset);
+            offset += chunk.byteLength;
+        }
+        return { body: new TextDecoder().decode(bytes), omittedReason: null };
+    }
+    catch {
+        return { body: null, omittedReason: "read-error" };
+    }
+}
+function formatCurl(request, body, opts) {
+    const parts = ["curl", "-X", shellQuote(request.method)];
+    for (const [name, value] of request.headers.entries()) {
+        const redactedValue = opts.redactHeader(name, value);
+        if (redactedValue === null)
+            continue;
+        parts.push("-H", shellQuote(`${name}: ${redactedValue}`));
+    }
+    if (body !== null && body.body !== null)
+        parts.push("--data-raw", shellQuote(body.body));
+    parts.push(shellQuote(redactUrl(request.url, opts.redactQueryParam)));
+    return parts.join(" ");
+}
+/** Start reading the body (if logged) now, before a handler consumes it. */
+function startBodyRead(request, body) {
+    if (body !== true && typeof body !== "object") {
+        return Promise.resolve({ body: null, omittedReason: "disabled" });
+    }
+    const bodyOptions = typeof body === "object" ? body : {};
+    const allowContentTypes = bodyOptions.allowContentTypes ?? DEFAULT_BODY_CONTENT_TYPES;
+    if (!shouldIncludeBody(request.headers.get("content-type"), allowContentTypes)) {
+        return Promise.resolve({ body: null, omittedReason: request.body === null ? "missing" : "content-type" });
+    }
+    return readBodyWithinLimit(request, bodyOptions.maxBytes ?? DEFAULT_MAX_BODY_BYTES);
+}
+async function buildCurlLogData(request, options) {
+    const resolved = {
+        redactHeader: options?.redactHeader ?? defaultRedactHeader,
+        redactQueryParam: options?.redactQueryParam ?? defaultRedactQueryParam,
+    };
+    const body = await startBodyRead(request, options?.body);
+    return {
+        bodyIncluded: body.body !== null,
+        bodyOmittedReason: body.omittedReason,
+        curl: formatCurl(request, body, resolved),
+    };
+}
+function curlLogger(options) {
+    const log = options?.log ?? defaultLog;
+    const skip = options?.skip;
+    const resolved = {
+        redactHeader: options?.redactHeader ?? defaultRedactHeader,
+        redactQueryParam: options?.redactQueryParam ?? defaultRedactQueryParam,
+    };
+    return namedMiddleware("curlLogger", async (ctx, next) => {
+        const start = performance.now();
+        const request = ctx.req;
+        const method = request.method;
+        const path = ctx.path;
+        const rid = ctx["requestId"] ?? null;
+        /* the only work before `next()`: the body must be teed before a handler reads it */
+        const bodyPromise = startBodyRead(request, options?.body);
+        const response = await next();
+        const skipData = {
+            duration: performance.now() - start,
+            method,
+            path,
+            requestId: rid,
+            status: response.status,
+        };
+        /* a failing redact callback, skip or sink never turns the response into a 500 */
+        try {
+            if (skip?.(skipData))
+                return response;
+            const body = await bodyPromise;
+            const data = {
+                ...skipData,
+                bodyIncluded: body.body !== null,
+                bodyOmittedReason: body.omittedReason,
+                curl: formatCurl(request, body, resolved),
+            };
+            if (options?.instance) {
+                options.instance.info({ ...data }, "request curl");
+            }
+            else {
+                log(data);
+            }
+        }
+        catch (err) {
+            console.error("curlLogger: failed to log request", err);
+        }
+        return response;
+    });
+}
+export { buildCurlLogData, curlLogger, defaultRedactHeader, defaultRedactQueryParam };
+//# sourceMappingURL=curl-logger.js.map

package/dist/curl-logger.js.map

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

package/dist/detect-runtime.js

@@ -0,0 +1,13 @@
+export function detectRuntime(g = globalThis) {
+    if (typeof g.Bun !== "undefined")
+        return "bun";
+    if (typeof g.Deno !== "undefined")
+        return "deno";
+    const ua = g.navigator?.userAgent ?? "";
+    if (ua.includes("Cloudflare-Workers") || ua.includes("workerd"))
+        return "cloudflare";
+    if (g.process?.versions?.node)
+        return "node";
+    throw new Error('Honey.serve() could not detect a runtime. Pass runtime: "bun" | "node" | "deno".');
+}
+//# sourceMappingURL=detect-runtime.js.map

package/dist/detect-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-runtime.js","sourceRoot":"","sources":["../src/detect-runtime.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,aAAa,CAAC,CAAC,GAAiB,UAAU;IACzD,IAAI,OAAO,CAAC,CAAC,GAAG,KAAK,WAAW;QAAE,OAAO,KAAK,CAAA;IAC9C,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,MAAM,CAAA;IAChD,MAAM,EAAE,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,IAAI,EAAE,CAAA;IACvC,IAAI,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,YAAY,CAAA;IACpF,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI;QAAE,OAAO,MAAM,CAAA;IAC5C,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAA;AACpG,CAAC"}

package/dist/dict.d.ts

@@ -0,0 +1,11 @@
+/**
+ * An object for keys that come from request data: search params, form fields, header views,
+ * validation field maps. It has no prototype, so a key named `__proto__`, `constructor` or
+ * `toString` is plain data — it cannot hit `Object.prototype`, replace the object's prototype,
+ * or turn a missing key into a function.
+ *
+ * Read keys with `key in obj`, `obj[key] !== undefined` or `Object.hasOwn(obj, key)`; the
+ * object has no `hasOwnProperty` method of its own.
+ */
+export declare function dict<T>(): Record<string, T>;
+//# sourceMappingURL=dict.d.ts.map

package/dist/dict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dict.d.ts","sourceRoot":"","sources":["../src/dict.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAE3C"}

package/dist/dict.js

@@ -0,0 +1,13 @@
+/**
+ * An object for keys that come from request data: search params, form fields, header views,
+ * validation field maps. It has no prototype, so a key named `__proto__`, `constructor` or
+ * `toString` is plain data — it cannot hit `Object.prototype`, replace the object's prototype,
+ * or turn a missing key into a function.
+ *
+ * Read keys with `key in obj`, `obj[key] !== undefined` or `Object.hasOwn(obj, key)`; the
+ * object has no `hasOwnProperty` method of its own.
+ */
+export function dict() {
+    return Object.create(null);
+}
+//# sourceMappingURL=dict.js.map

package/dist/dict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dict.js","sourceRoot":"","sources":["../src/dict.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,IAAI;IACnB,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAsB,CAAA;AAChD,CAAC"}

package/dist/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAGvD,qBAAa,UAAW,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;IAE/C,YAAY,IAAI,EAAE;QACjB,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;QACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,MAAM,EAAE,SAAS,CAAA;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;KACtC,EASA;IAED,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBpD;CACD"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAGvD,qBAAa,UAAW,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;IAE/C,YAAY,IAAI,EAAE;QACjB,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAA;QACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,MAAM,EAAE,SAAS,CAAA;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;KACtC,EAWA;IAED,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBpD;CACD"}

package/dist/error.js

@@ -0,0 +1,44 @@
+import { EMPTY_FIELDS, statusKeyToCode } from "./types.js";
+export class HoneyError extends Error {
+    data;
+    errorKey;
+    fields;
+    headers;
+    status;
+    statusKey;
+    vars;
+    constructor(opts) {
+        super(opts.errorKey, opts.cause !== undefined ? { cause: opts.cause } : undefined);
+        this.data = opts.data;
+        this.errorKey = opts.errorKey;
+        this.headers = opts.headers;
+        /* an unknown status key must not turn an error into a 200 — it is a 500 */
+        const known = Object.hasOwn(statusKeyToCode, opts.status);
+        this.statusKey = known ? opts.status : "internal_server_error";
+        this.status = known ? statusKeyToCode[opts.status] : 500;
+        this.fields = opts.fields ?? EMPTY_FIELDS;
+        this.vars = opts.vars;
+    }
+    static serialize(e) {
+        if (!(e instanceof Error))
+            return { message: String(e) };
+        const obj = {
+            message: e.message,
+            name: e.name,
+            stack: e.stack,
+        };
+        if (e instanceof HoneyError) {
+            obj["errorKey"] = e.errorKey;
+            obj["status"] = e.status;
+            obj["statusKey"] = e.statusKey;
+            if (Object.keys(e.fields).length > 0)
+                obj["fields"] = e.fields;
+            if (e.vars)
+                obj["vars"] = e.vars;
+        }
+        if (e.cause)
+            obj["cause"] = HoneyError.serialize(e.cause);
+        return obj;
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE1D,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC3B,IAAI,CAAU;IACd,QAAQ,CAAQ;IAChB,MAAM,CAA8B;IACpC,OAAO,CAAyB;IAChC,MAAM,CAAQ;IACd,SAAS,CAAW;IACpB,IAAI,CAAkC;IAE/C,YAAY,IAQX;QACA,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QAClF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;QACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAA;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC3B,2EAA2E;QAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QACzD,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAA;QAC9D,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;QACxD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,YAAY,CAAA;QACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;IACtB,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,CAAU;QAC1B,IAAI,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;QAExD,MAAM,GAAG,GAA4B;YACpC,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK;SACd,CAAA;QAED,IAAI,CAAC,YAAY,UAAU,EAAE,CAAC;YAC7B,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAA;YAC5B,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,CAAA;YACxB,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,SAAS,CAAA;YAC9B,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,CAAA;YAC9D,IAAI,CAAC,CAAC,IAAI;gBAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAA;QACjC,CAAC;QAED,IAAI,CAAC,CAAC,KAAK;YAAE,GAAG,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QAEzD,OAAO,GAAG,CAAA;IACX,CAAC;CACD"}

package/dist/errors.js

@@ -0,0 +1,39 @@
+import { HoneyError } from "./error.js";
+export const ERROR_META = Symbol.for("honey.error.meta");
+export function defineErrors(map) {
+    const result = Object.create(null);
+    const meta = Object.create(null);
+    for (const [key, def] of Object.entries(map)) {
+        if (typeof def === "string") {
+            /* standard error — string status key */
+            meta[key] = { schema: null, statusKey: def };
+            result[key] = (opts) => new HoneyError({
+                cause: opts?.cause,
+                errorKey: key,
+                fields: opts?.fields,
+                headers: opts?.headers,
+                status: def,
+                vars: opts?.vars,
+            });
+        }
+        else {
+            /* custom schema error — { status, schema } */
+            meta[key] = { schema: def.schema, statusKey: def.status };
+            result[key] = (data, opts) => new HoneyError({
+                cause: opts?.cause,
+                data,
+                errorKey: key,
+                headers: opts?.headers,
+                status: def.status,
+            });
+        }
+    }
+    Object.defineProperty(result, ERROR_META, {
+        configurable: false,
+        enumerable: false,
+        value: meta,
+        writable: false,
+    });
+    return result;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AA8BvC,MAAM,CAAC,MAAM,UAAU,GAAkB,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;AAYvE,MAAM,UAAU,YAAY,CAG1B,GAAS;IACV,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAA4B,CAAA;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAmC,CAAA;IAElE,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC7B,wCAAwC;YACxC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAA;YAC5C,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAwD,EAAE,EAAE,CAC1E,IAAI,UAAU,CAAC;gBACd,KAAK,EAAE,IAAI,EAAE,KAAK;gBAClB,QAAQ,EAAE,GAAG;gBACb,MAAM,EAAE,IAAI,EAAE,MAAM;gBACpB,OAAO,EAAE,IAAI,EAAE,OAAO;gBACtB,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,IAAI,EAAE,IAAI;aAChB,CAAC,CAAA;QACJ,CAAC;aAAM,CAAC;YACP,8CAA8C;YAC9C,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,CAAA;YACzD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAa,EAAE,IAA4D,EAAE,EAAE,CAC7F,IAAI,UAAU,CAAC;gBACd,KAAK,EAAE,IAAI,EAAE,KAAK;gBAClB,IAAI;gBACJ,QAAQ,EAAE,GAAG;gBACb,OAAO,EAAE,IAAI,EAAE,OAAO;gBACtB,MAAM,EAAE,GAAG,CAAC,MAAM;aAClB,CAAC,CAAA;QACJ,CAAC;IACF,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE;QACzC,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,KAAK;KACf,CAAC,CAAA;IAEF,OAAO,MAAiD,CAAA;AACzD,CAAC"}

package/dist/etag.d.ts

@@ -2,6 +2,8 @@ import type { MiddlewareFn } from "./middleware.ts";
 type ETagOptions = {
     weak?: boolean;
 };
+/** RFC 9110 §13.1.2: `*` or a list of entity tags, compared weakly. */
+export declare function ifNoneMatchHits(header: string | null, etag: string): boolean;
 export declare function etag(options?: ETagOptions): MiddlewareFn<{
     req: Request;
 }, {}>;

package/dist/etag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"etag.d.ts","sourceRoot":"","sources":["../src/etag.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,KAAK,WAAW,GAAG;IAClB,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAeD,wBAAgB,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,EAAE,EAAE,CAAC,CAmD9E"}
+{"version":3,"file":"etag.d.ts","sourceRoot":"","sources":["../src/etag.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEnD,KAAK,WAAW,GAAG;IAClB,IAAI,CAAC,EAAE,OAAO,CAAA;CACd,CAAA;AAmBD,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ5E;AAED,wBAAgB,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,EAAE,EAAE,CAAC,CA2D9E"}

package/dist/etag.js

@@ -0,0 +1,82 @@
+import { bodyKind, rawBodyOf } from "./body-kind.js";
+import { replaceResponse } from "./honey-response.js";
+import { namedMiddleware } from "./middleware.js";
+const encoder = new TextEncoder();
+/** Base64url of the first 16 bytes of SHA-256: collision-resistant enough for a strong validator. */
+async function digest(data) {
+    const hash = new Uint8Array(await crypto.subtle.digest("SHA-256", data)).subarray(0, 16);
+    let binary = "";
+    for (let i = 0; i < hash.length; i++)
+        binary += String.fromCharCode(hash[i]);
+    return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+const ENTITY_TAG_RE = /(?:W\/)?"[^"]*"/g;
+/** Weak comparison (RFC 9110 §8.8.3.2): opaque tags match regardless of the `W/` prefix. */
+function opaque(tag) {
+    return tag.startsWith("W/") ? tag.slice(2) : tag;
+}
+/** RFC 9110 §13.1.2: `*` or a list of entity tags, compared weakly. */
+export function ifNoneMatchHits(header, etag) {
+    if (header === null)
+        return false;
+    if (header.trim() === "*")
+        return true;
+    const target = opaque(etag.trim());
+    for (const tag of header.match(ENTITY_TAG_RE) ?? []) {
+        if (opaque(tag) === target)
+            return true;
+    }
+    return false;
+}
+export function etag(options) {
+    const weak = options?.weak !== false;
+    const mw = async (ctx, next) => {
+        const method = ctx.req.method;
+        if (method !== "GET" && method !== "HEAD") {
+            return next();
+        }
+        const response = await next();
+        /* Only a 200 has a selected representation a 304 can stand in for. */
+        if (response.status !== 200)
+            return response;
+        const ifNoneMatch = ctx.req.headers.get("if-none-match");
+        /* A handler-set ETag is authoritative: never overwrite it or hash the body. */
+        const existing = response.headers.get("etag");
+        if (existing !== null) {
+            if (!ifNoneMatchHits(ifNoneMatch, existing))
+                return response;
+            await response.body?.cancel().catch(() => { });
+            return replaceResponse(response, { body: null, headers: response.headers, status: 304 });
+        }
+        /* Never buffer a stream: SSE and generate() can be endless. */
+        if (bodyKind(response) !== "buffered")
+            return response;
+        let bytes;
+        const raw = rawBodyOf(response);
+        if (raw !== null) {
+            bytes = typeof raw === "string" ? encoder.encode(raw) : new Uint8Array(raw);
+        }
+        else {
+            bytes = new Uint8Array(await response.arrayBuffer());
+        }
+        /* Nothing to validate; hand back a fresh body (the original may have been read). */
+        if (bytes.byteLength === 0) {
+            return raw === null ? replaceResponse(response, { body: bytes, headers: response.headers }) : response;
+        }
+        const hash = await digest(bytes);
+        const etagValue = weak ? `W/"${hash}"` : `"${hash}"`;
+        const headers = new Headers(response.headers);
+        headers.set("etag", etagValue);
+        if (ifNoneMatchHits(ifNoneMatch, etagValue)) {
+            return replaceResponse(response, { body: null, headers, status: 304 });
+        }
+        /* The original body was read (or is raw): always hand back a fresh one. */
+        return replaceResponse(response, {
+            body: typeof raw === "string" ? raw : bytes,
+            headers,
+            status: response.status,
+        });
+    };
+    return namedMiddleware("etag", mw);
+}
+//# sourceMappingURL=etag.js.map

package/dist/etag.js.map

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

package/dist/feature-detect.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Detects which optional honey features (`openapi`, `i18n`, `serve`) app code uses, so build
+ * tooling can import their entries ahead of the app. A bundle cannot follow the lazy, opaque
+ * feature imports honey uses at run time. Not a package export.
+ */
+export type HoneyFeature = "i18n" | "openapi" | "serve";
+export declare const FEATURES: readonly HoneyFeature[];
+/**
+ * Replaces comments and string, template and regex literal contents with spaces, keeping every
+ * newline so offsets and line numbers still line up. A scanner, not a parser; it is only accurate
+ * enough to keep `// app.serve(` in a comment from counting as a call.
+ */
+export declare function stripCommentsAndStrings(code: string): string;
+/** Feature calls in source text, ignoring comments and strings. */
+export declare function detectFeaturesInSource(code: string): Set<HoneyFeature>;
+/** Feature calls and import specifiers of an ESTree program. */
+export declare function scanProgram(program: unknown): {
+    features: Set<HoneyFeature>;
+    imports: string[];
+};
+/** `import { enableX } from "…"; enableX();` for each feature, on one line. */
+export declare function featurePrelude(features: Iterable<HoneyFeature>): string;
+/** True when `code` already imports the entry for `feature`. */
+export declare function importsFeatureEntry(code: string, feature: HoneyFeature): boolean;
+//# sourceMappingURL=feature-detect.d.ts.map

package/dist/feature-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-detect.d.ts","sourceRoot":"","sources":["../src/feature-detect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;AAEvD,eAAO,MAAM,QAAQ,EAAE,SAAS,YAAY,EAAiC,CAAA;AAsB7E;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgC5D;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAWtE;AAQD,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG;IAAE,QAAQ,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAwChG;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,MAAM,CAQvE;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAEhF"}

package/dist/feature-detect.js

@@ -0,0 +1,144 @@
+/**
+ * Detects which optional honey features (`openapi`, `i18n`, `serve`) app code uses, so build
+ * tooling can import their entries ahead of the app. A bundle cannot follow the lazy, opaque
+ * feature imports honey uses at run time. Not a package export.
+ */
+export const FEATURES = ["i18n", "openapi", "serve"];
+const FEATURE_ENTRY = {
+    i18n: { enable: "enableI18n", specifier: "@lovrozagar/honey/i18n" },
+    openapi: { enable: "enableOpenApi", specifier: "@lovrozagar/honey/openapi" },
+    serve: { enable: "enableServe", specifier: "@lovrozagar/honey/serve" },
+};
+const METHOD_FEATURE = {
+    errorI18n: "i18n",
+    manifest: "openapi",
+    openapi: "openapi",
+    serve: "serve",
+};
+/** Globals whose `.serve()` is the runtime's own server, not `Honey.serve()`. */
+const RUNTIME_SERVE_OWNERS = new Set(["Bun", "Deno"]);
+function blank(s) {
+    return s.replace(/[^\n]/g, " ");
+}
+/**
+ * Replaces comments and string, template and regex literal contents with spaces, keeping every
+ * newline so offsets and line numbers still line up. A scanner, not a parser; it is only accurate
+ * enough to keep `// app.serve(` in a comment from counting as a call.
+ */
+export function stripCommentsAndStrings(code) {
+    let out = "";
+    let i = 0;
+    while (i < code.length) {
+        const ch = code[i];
+        const next = code[i + 1];
+        if (ch === "/" && next === "/") {
+            const end = code.indexOf("\n", i);
+            const stop = end === -1 ? code.length : end;
+            out += blank(code.slice(i, stop));
+            i = stop;
+        }
+        else if (ch === "/" && next === "*") {
+            const end = code.indexOf("*/", i + 2);
+            const stop = end === -1 ? code.length : end + 2;
+            out += blank(code.slice(i, stop));
+            i = stop;
+        }
+        else if (ch === '"' || ch === "'" || ch === "`") {
+            let j = i + 1;
+            while (j < code.length && code[j] !== ch) {
+                if (code[j] === "\\")
+                    j++;
+                else if (ch !== "`" && code[j] === "\n")
+                    break;
+                j++;
+            }
+            const stop = Math.min(j + 1, code.length);
+            out += ch + blank(code.slice(i + 1, stop - 1)) + (stop - 1 > i ? (code[stop - 1] ?? "") : "");
+            i = stop;
+        }
+        else {
+            out += ch;
+            i++;
+        }
+    }
+    return out;
+}
+/** Feature calls in source text, ignoring comments and strings. */
+export function detectFeaturesInSource(code) {
+    const text = stripCommentsAndStrings(code);
+    const found = new Set();
+    const re = /(\b[A-Za-z_$][\w$]*\s*)?\.\s*(openapi|manifest|errorI18n|serve)\s*\(/g;
+    for (const m of text.matchAll(re)) {
+        const owner = m[1]?.trim();
+        const method = m[2];
+        if (method === "serve" && owner && RUNTIME_SERVE_OWNERS.has(owner))
+            continue;
+        found.add(METHOD_FEATURE[method]);
+    }
+    return found;
+}
+function isNode(value) {
+    return value !== null && typeof value === "object" && typeof value.type === "string";
+}
+/** Feature calls and import specifiers of an ESTree program. */
+export function scanProgram(program) {
+    const features = new Set();
+    const imports = [];
+    const stack = [program];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (Array.isArray(node)) {
+            stack.push(...node);
+            continue;
+        }
+        if (!isNode(node))
+            continue;
+        switch (node.type) {
+            case "ImportDeclaration":
+            case "ExportAllDeclaration":
+            case "ExportNamedDeclaration":
+            case "ImportExpression": {
+                const source = node.source;
+                if (source && typeof source.value === "string")
+                    imports.push(source.value);
+                break;
+            }
+            case "CallExpression": {
+                const callee = node.callee;
+                if (callee?.type === "MemberExpression" && !callee.computed) {
+                    const property = callee.property;
+                    const feature = typeof property.name === "string" ? METHOD_FEATURE[property.name] : undefined;
+                    const object = callee.object;
+                    const runtimeOwned = property.name === "serve" && object.type === "Identifier" && RUNTIME_SERVE_OWNERS.has(String(object.name));
+                    if (feature && !runtimeOwned)
+                        features.add(feature);
+                }
+                break;
+            }
+        }
+        for (const key in node) {
+            if (key === "type" || key === "start" || key === "end" || key === "loc" || key === "range")
+                continue;
+            const value = node[key];
+            if (value !== null && typeof value === "object")
+                stack.push(value);
+        }
+    }
+    return { features, imports };
+}
+/** `import { enableX } from "…"; enableX();` for each feature, on one line. */
+export function featurePrelude(features) {
+    const parts = [];
+    for (const feature of FEATURES) {
+        if (![...features].includes(feature))
+            continue;
+        const { enable, specifier } = FEATURE_ENTRY[feature];
+        parts.push(`import { ${enable} } from ${JSON.stringify(specifier)}; ${enable}();`);
+    }
+    return parts.join(" ");
+}
+/** True when `code` already imports the entry for `feature`. */
+export function importsFeatureEntry(code, feature) {
+    return code.includes(FEATURE_ENTRY[feature].specifier);
+}
+//# sourceMappingURL=feature-detect.js.map