@lovrozagar/honey 0.6.8 → 0.7.1

package/dist/middleware.js

@@ -0,0 +1,253 @@
+/**
+ * Stamp a stable name on a middleware closure.
+ *
+ * `Function.prototype.name` is inferred by whatever transpiled the module — jiti (used by
+ * `honey generate`) and rollup (used by `vite build`) disagree about a closure returned from
+ * a factory, which made the generated manifest differ between the two. Naming shipped
+ * middleware explicitly makes the manifest deterministic, and "cors" reads better than
+ * "anonymous" besides.
+ */
+export function namedMiddleware(name, fn) {
+    Object.defineProperty(fn, "name", { configurable: true, value: name });
+    return fn;
+}
+/**
+ * Create middleware with error keys constrained to a factory.
+ * Error keys are stored on the function and auto-accumulated by .use().
+ */
+export function defineMiddleware(opts) {
+    const fn = opts.fn;
+    if (opts.errors) {
+        const [, ...keys] = opts.errors;
+        Object.defineProperty(fn, "errors", { value: keys });
+    }
+    if (opts.meta)
+        attachMiddlewareMeta(fn, opts.meta);
+    return fn;
+}
+/**
+ * `internal` decides whether a route appears in generated artifacts at all. A middleware that
+ * set it would silently remove routes from the document, which is not noticeable by reading
+ * either the route or the middleware — so it is the one key middleware may not contribute.
+ */
+function attachMiddlewareMeta(fn, meta) {
+    if ("internal" in meta) {
+        throw new Error('middleware meta cannot set "internal" — it controls whether routes appear in generated ' +
+            "artifacts; set it on the route with .meta({ internal: true })");
+    }
+    Object.defineProperty(fn, "meta", { value: Object.freeze({ ...meta }) });
+}
+/**
+ * Middleware factory — annotate ctx for TReqs, TAdds inferred from return type:
+ *   createMiddleware((ctx: { env: { DB: D1Database } }, next) => next({ db }))
+ */
+export function createMiddleware(fn, opts) {
+    if (opts?.meta)
+        attachMiddlewareMeta(fn, opts.meta);
+    return fn;
+}
+/**
+ * Merge meta contributed by a middleware chain, in run order (later wins). Resolved once when
+ * the app finalizes, from the chain the route runs — never per request.
+ */
+export function collectMiddlewareMeta(groups) {
+    let out;
+    for (const group of groups) {
+        for (const mw of group) {
+            const meta = mw.meta;
+            if (!meta)
+                continue;
+            if (out === undefined)
+                out = {};
+            Object.assign(out, meta);
+        }
+    }
+    return out ?? null;
+}
+/**
+ * Every name the framework owns on a request context — fields, lazy getters, methods and
+ * internal backing state. `next({ ... })` additions and `.context()` values may not use them:
+ * an addition would silently replace framework state, and a value assigned over a getter-only
+ * field throws on every request. TypeScript prevents most of this at compile time; this set
+ * is the runtime guard.
+ */
+export const RESERVED_CTX_KEYS = new Set([
+    "background",
+    "cookies",
+    "env",
+    "error",
+    "errors",
+    "executionCtx",
+    "headers",
+    "input",
+    "ip",
+    "meta",
+    "params",
+    "path",
+    "realtime",
+    "req",
+    "res",
+    "routePattern",
+    "search",
+    "searchAll",
+    "signal",
+    "tap",
+    "_ac",
+    "_errorToResponse",
+    "_isErrorResponse",
+    "_lzClient",
+    "_lzCookies",
+    "_lzHeaders",
+    "_lzSearch",
+    "_lzSearchAll",
+    "_lzUrlFn",
+    "_pendingTaps",
+    "_rq",
+    "_setErrors",
+]);
+const NO_RESPONSE_HANDLER = "handler must return a Response — did you forget 'return ctx.res...()'?";
+const NO_RESPONSE_MIDDLEWARE = "middleware must return a Response — did you forget 'return next(...)'?";
+/**
+ * Compile a middleware chain + handler into a single function, once.
+ *
+ * With `convert`, every `next()` boundary is an error boundary: whatever the handler or a
+ * middleware throws (or rejects with) becomes a Response at that layer, so the middleware
+ * around it always gets a Response back from `next()` and its post-`next()` code — headers,
+ * logging, timing — runs on error responses too. The compiled function never rejects as long
+ * as `convert` does not. Without `convert`, throws propagate (the bare executor).
+ */
+export function compileChain(middlewares, handler, convert) {
+    if (convert !== undefined)
+        return compileConverting(middlewares, handler, convert);
+    if (middlewares.length === 0) {
+        /* sync fast path — avoids microtask overhead for sync handlers */
+        return (ctx) => {
+            const result = handler(ctx);
+            if (result instanceof Promise) {
+                return result.then(validateResponse);
+            }
+            if (result === undefined || result === null) {
+                throw new Error(NO_RESPONSE_HANDLER);
+            }
+            return result;
+        };
+    }
+    if (middlewares.length === 1) {
+        const mw = middlewares[0];
+        if (!mw) {
+            throw new Error("middleware chain invariant violated");
+        }
+        return (ctx) => {
+            const mwCtx = ctx;
+            let called = false;
+            return Promise.resolve(mw(mwCtx, (additions) => {
+                if (called)
+                    throw new Error("next() called multiple times");
+                called = true;
+                if (additions)
+                    mergeAdditions(ctx, additions);
+                return Promise.resolve(handler(ctx)).then(validateResponse);
+            })).then(validateMiddlewareResponse);
+        };
+    }
+    /* general case — pre-bind middleware array, no per-request index tracking */
+    return (ctx) => executeChain(middlewares, ctx, handler);
+}
+function compileConverting(middlewares, handler, convert) {
+    const n = middlewares.length;
+    const runHandler = (ctx) => {
+        let result;
+        try {
+            result = handler(ctx);
+        }
+        catch (thrown) {
+            return convert(thrown, ctx);
+        }
+        if (result instanceof Promise) {
+            return result.then((value) => (value === undefined || value === null ? convert(new Error(NO_RESPONSE_HANDLER), ctx) : value), (thrown) => convert(thrown, ctx));
+        }
+        if (result === undefined || result === null)
+            return convert(new Error(NO_RESPONSE_HANDLER), ctx);
+        return result;
+    };
+    const step = (i, ctx) => {
+        if (i === n)
+            return runHandler(ctx);
+        const mw = middlewares[i];
+        let called = false;
+        const next = (additions) => {
+            if (called)
+                throw new Error("next() called multiple times");
+            called = true;
+            if (additions)
+                mergeAdditions(ctx, additions);
+            const downstream = step(i + 1, ctx);
+            return downstream instanceof Promise ? downstream : Promise.resolve(downstream);
+        };
+        let out;
+        try {
+            out = mw(ctx, next);
+        }
+        catch (thrown) {
+            return convert(thrown, ctx);
+        }
+        return Promise.resolve(out).then((value) => (value === undefined || value === null ? convert(new Error(NO_RESPONSE_MIDDLEWARE), ctx) : value), (thrown) => convert(thrown, ctx));
+    };
+    return (ctx) => step(0, ctx);
+}
+function mergeAdditions(ctx, additions) {
+    for (const key in additions) {
+        if (!RESERVED_CTX_KEYS.has(key)) {
+            ;
+            ctx[key] = additions[key];
+        }
+    }
+}
+function validateResponse(result) {
+    if (result === undefined || result === null) {
+        throw new Error(NO_RESPONSE_HANDLER);
+    }
+    return result;
+}
+function validateMiddlewareResponse(result) {
+    if (result === undefined || result === null) {
+        throw new Error(NO_RESPONSE_MIDDLEWARE);
+    }
+    return result;
+}
+export function executeChain(middlewares, ctx, handler) {
+    let index = 0;
+    /* middleware runtime type uses Record<string, unknown> — object satisfies at runtime */
+    const mwCtx = ctx;
+    function dispatch() {
+        if (index >= middlewares.length) {
+            return Promise.resolve(handler(ctx)).then((result) => {
+                if (result === undefined || result === null) {
+                    throw new Error("handler must return a Response — did you forget 'return ctx.res...()'?");
+                }
+                return result;
+            });
+        }
+        const mw = middlewares[index++];
+        if (!mw) {
+            throw new Error("middleware chain invariant violated");
+        }
+        let called = false;
+        return Promise.resolve(mw(mwCtx, (additions) => {
+            if (called) {
+                throw new Error("next() called multiple times");
+            }
+            called = true;
+            if (additions)
+                mergeAdditions(ctx, additions);
+            return dispatch();
+        })).then((result) => {
+            if (result === undefined || result === null) {
+                throw new Error("middleware must return a Response — did you forget 'return next(...)'?");
+            }
+            return result;
+        });
+    }
+    return dispatch();
+}
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

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

package/dist/node-request.d.ts

@@ -1,7 +1,20 @@
 import type { IncomingMessage } from "node:http";
+import { TO_FETCH_REQUEST } from "./fetch-request.ts";
 import { NODE_OUTBOUND } from "./honey-response.ts";
+import { PEER_ADDRESS } from "./peer.ts";
 /** bodyLimit uses this to swap the inbound stream without `new Request(req)`. */
 export declare const REPLACE_BODY: unique symbol;
+/** The Node adapter calls this when the response closes before it finished (client disconnect, shutdown). */
+export declare const ABORT_REQUEST: unique symbol;
+/** True once a body read went over the adapter's `maxRequestBodySize`: the connection must not be reused. */
+export declare const BODY_OVERFLOW: unique symbol;
+export { DEFAULT_MAX_REQUEST_BODY } from "./request-limits.ts";
+export type NodeRequestOptions = {
+    /** Where the body bytes come from when not the IncomingMessage itself (an upgrade socket on old Node). */
+    bodySource?: AsyncIterable<Buffer | string> | null;
+    /** Largest body a read accepts, in bytes; over it the read throws a 413 `HoneyError`. `0` disables. */
+    maxBodySize?: number;
+};
 /**
  * Headers view over IncomingMessage. `get`/`has` read Node's already-parsed
  * map. A real `Headers` is built only if something iterates or mutates.
@@ -11,6 +24,11 @@ export declare class NodeHeaders {
     constructor(incoming: IncomingMessage);
     append(name: string, value: string): void;
     delete(name: string): void;
+    /**
+     * Every value of the header, joined the way Fetch joins them. Node's `headers` map keeps only
+     * the first `Authorization`, `Host`, … and drops the rest; `headersDistinct` keeps them all,
+     * so the answer is the same before and after something iterates the headers.
+     */
     get(name: string): string | null;
     getSetCookie(): string[];
     has(name: string): boolean;
@@ -22,29 +40,50 @@ export declare class NodeHeaders {
     [Symbol.iterator](): IterableIterator<[string, string]>;
     get [Symbol.toStringTag](): string;
 }
+/**
+ * The request URL from what the client actually sent: scheme from the socket (TLS or not),
+ * authority from `Host` (or from an absolute-form target, which takes precedence per RFC 9112),
+ * path and query from the request target. Anything but an origin-form (`/path`) or http(s)
+ * absolute-form target, and any `Host` that is not `host[:port]`, returns `null`: the request
+ * gets 400. A target that needs it is parsed the way `new URL()` parses it, so the path matches
+ * what Bun, Deno and Workers hand the app for the same bytes.
+ */
+export declare function nodeRequestUrl(incoming: IncomingMessage): string | null;
 /**
  * Request-shaped wrapper around IncomingMessage. Avoids `new Request()`
  * until a body method needs the real Fetch object (formData / blob / clone).
  */
 export declare class NodeRequest {
     #private;
-    readonly [NODE_OUTBOUND] = true;
-    readonly cache: RequestCache;
-    readonly credentials: RequestCredentials;
-    readonly destination: RequestDestination;
     readonly headers: NodeHeaders;
-    readonly integrity = "";
-    readonly keepalive = false;
     readonly method: string;
-    readonly mode: RequestMode;
-    readonly redirect: RequestRedirect;
-    readonly referrer = "about:client";
-    readonly referrerPolicy: ReferrerPolicy;
     readonly url: string;
-    constructor(incoming: IncomingMessage);
+    /** @param url the request URL; `nodeRequestUrl(incoming)` when left out (throws if that is invalid) */
+    constructor(incoming: IncomingMessage, url?: string, opts?: NodeRequestOptions);
+    get [NODE_OUTBOUND](): true;
+    get cache(): RequestCache;
+    get credentials(): RequestCredentials;
+    get destination(): RequestDestination;
+    get integrity(): string;
+    get keepalive(): boolean;
+    get mode(): RequestMode;
+    get redirect(): RequestRedirect;
+    get referrer(): string;
+    get referrerPolicy(): ReferrerPolicy;
+    /** Set once a read went over `maxRequestBodySize`; the adapter then closes the connection. */
+    get [BODY_OVERFLOW](): boolean;
     get body(): ReadableStream<Uint8Array> | null;
+    /** The real Fetch `Request` behind this one: `new Request(x)`, `fetch(x)` and `instanceof` work on it. */
+    [TO_FETCH_REQUEST](): Request;
+    /** The socket peer, for `ctx.ip`. */
+    get [PEER_ADDRESS](): string | null;
     get bodyUsed(): boolean;
+    /**
+     * Aborts when the response closes before it finished: the client disconnected, or the
+     * server shut down. Reading the body does not end it (Node's `'aborted'` event did).
+     */
     get signal(): AbortSignal;
+    [ABORT_REQUEST](reason?: unknown): void;
     get duplex(): "half";
     [REPLACE_BODY](stream: ReadableStream<Uint8Array>): void;
     arrayBuffer(): Promise<ArrayBuffer>;
@@ -52,8 +91,14 @@ export declare class NodeRequest {
     bytes(): Promise<Uint8Array>;
     clone(): Request;
     formData(): Promise<FormData>;
+    /** As Fetch: an empty body is a `SyntaxError`, not `null`. */
     json(): Promise<unknown>;
     text(): Promise<string>;
 }
-export declare function incomingToNodeRequest(req: IncomingMessage): Request;
+/**
+ * A Request-shaped view of `req`. It is not a Fetch `Request` (`instanceof Request` is false, and
+ * platform code that reads a Request's internal state cannot take it): pass it through
+ * `toFetchRequest()` for `new Request(r)`, `fetch(r)` or a library that needs the real thing.
+ */
+export declare function incomingToNodeRequest(req: IncomingMessage, url?: string, opts?: NodeRequestOptions): Request;
 //# sourceMappingURL=node-request.d.ts.map

package/dist/node-request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-request.d.ts","sourceRoot":"","sources":["../src/node-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,iFAAiF;AACjF,eAAO,MAAM,YAAY,eAAkC,CAAA;AAE3D;;;GAGG;AACH,qBAAa,WAAW;;IAIvB,YAAY,QAAQ,EAAE,eAAe,EAEpC;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAExC;IAED,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEzB;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK/B;IAED,YAAY,IAAI,MAAM,EAAE,CAEvB;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGzB;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAErC;IAED,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAEhG;IAED,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAE/B;IAED,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAEjC;IAED,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE5C;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAEtD;IAED,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;CAcD;AAED;;;GAGG;AACH,qBAAa,WAAW;;IACvB,QAAQ,CAAC,CAAC,aAAa,CAAC,QAAO;IAC/B,QAAQ,CAAC,KAAK,EAAgB,YAAY,CAAA;IAC1C,QAAQ,CAAC,WAAW,EAAoB,kBAAkB,CAAA;IAC1D,QAAQ,CAAC,WAAW,EAAS,kBAAkB,CAAA;IAC/C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAC7B,QAAQ,CAAC,SAAS,MAAK;IACvB,QAAQ,CAAC,SAAS,SAAQ;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAa,WAAW,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAe,eAAe,CAAA;IAC/C,QAAQ,CAAC,QAAQ,kBAAiB;IAClC,QAAQ,CAAC,cAAc,EAAS,cAAc,CAAA;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IASpB,YAAY,QAAQ,EAAE,eAAe,EAOpC;IAED,IAAI,IAAI,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAO5C;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,MAAM,IAAI,WAAW,CAMxB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAIvD;IAEK,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAGxC;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;IAEK,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,CAGjC;IAED,KAAK,IAAI,OAAO,CAEf;IAEK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,CAElC;IAEK,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAG7B;IAEK,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAG5B;CA0BD;AA+BD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAEnE"}
+{"version":3,"file":"node-request.d.ts","sourceRoot":"","sources":["../src/node-request.ts"],"names":[],"mappings":"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"}