@lovrozagar/honey 0.6.5 → 0.7.0

package/dist/invoke-user.js

@@ -0,0 +1,73 @@
+/**
+ * Containment for user callbacks the framework calls outside a request's middleware chain
+ * (WebSocket and realtime events, adapter hooks). A sync throw or a rejection never escapes
+ * into the runtime, where it would be an uncaught exception or an unhandled rejection and,
+ * on Node, end the process.
+ */
+function logFailure(err, opts, phase) {
+    const fields = { ...opts.fields, err, phase };
+    try {
+        if (opts.log?.error) {
+            opts.log.error(fields, "callback failed");
+            return;
+        }
+    }
+    catch {
+        /* a broken logger must not take the callback's place as the thing that escapes */
+    }
+    console.error("honey: callback failed", fields);
+}
+function isThenable(value) {
+    return value !== null && typeof value === "object" && typeof value.then === "function";
+}
+/** Report `err` through `onError`, or log it. Never throws, never rejects. */
+export function reportUserError(err, opts) {
+    const onError = opts.onError;
+    if (!onError) {
+        logFailure(err, opts, opts.phase);
+        return;
+    }
+    try {
+        const r = onError(err);
+        if (isThenable(r))
+            r.then(undefined, (e) => logFailure(e, opts, "onError"));
+    }
+    catch (e) {
+        logFailure(e, opts, "onError");
+    }
+}
+/**
+ * Call `fn` and resolve once it settles. Resolves `true` when it succeeded and `false` when it
+ * threw or rejected (the error went to `onError` or the logger). Never rejects.
+ */
+export function invokeUser(fn, opts) {
+    try {
+        const r = fn();
+        if (isThenable(r)) {
+            return Promise.resolve(r).then(() => true, (e) => {
+                reportUserError(e, opts);
+                return false;
+            });
+        }
+        return Promise.resolve(true);
+    }
+    catch (e) {
+        reportUserError(e, opts);
+        return Promise.resolve(false);
+    }
+}
+/**
+ * One ordered event queue: each task starts after the previous one settled, and a failing task
+ * never stops the ones after it.
+ */
+export function createEventQueue() {
+    let tail = Promise.resolve();
+    return {
+        push(task) {
+            const next = tail.then(task).then(() => undefined, () => undefined);
+            tail = next;
+            return next;
+        },
+    };
+}
+//# sourceMappingURL=invoke-user.js.map

package/dist/invoke-user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke-user.js","sourceRoot":"","sources":["../src/invoke-user.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,SAAS,UAAU,CAAC,GAAY,EAAE,IAAmB,EAAE,KAAa;IACnE,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;IAC7C,IAAI,CAAC;QACJ,IAAI,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;YACzC,OAAM;QACP,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,kFAAkF;IACnF,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAA;AAChD,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IACjC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAQ,KAA4B,CAAC,IAAI,KAAK,UAAU,CAAA;AAC/G,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,eAAe,CAAC,GAAY,EAAE,IAAmB;IAChE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QACjC,OAAM;IACP,CAAC;IACD,IAAI,CAAC;QACJ,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QACtB,IAAI,UAAU,CAAC,CAAC,CAAC;YAAE,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAU,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAA;IACrF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAA;IAC/B,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,EAAiB,EAAE,IAAmB;IAChE,IAAI,CAAC;QACJ,MAAM,CAAC,GAAG,EAAE,EAAE,CAAA;QACd,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YACnB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAC7B,GAAG,EAAE,CAAC,IAAI,EACV,CAAC,CAAU,EAAE,EAAE;gBACd,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;gBACxB,OAAO,KAAK,CAAA;YACb,CAAC,CACD,CAAA;QACF,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QACxB,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC9B,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC/B,IAAI,IAAI,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAA;IAC3C,OAAO;QACN,IAAI,CAAC,IAAI;YACR,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAChC,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CACf,CAAA;YACD,IAAI,GAAG,IAAI,CAAA;YACX,OAAO,IAAI,CAAA;QACZ,CAAC;KACD,CAAA;AACF,CAAC"}

package/dist/ip-restrict.d.ts

@@ -1,10 +1,22 @@
 import type { MiddlewareFn } from "./middleware.ts";
 type IpRestrictOptions = {
+    /** Addresses and CIDR ranges allowed through. When set, everything else is rejected. */
     allowList?: string[];
+    /** Addresses and CIDR ranges rejected. Checked before `allowList`. */
     denyList?: string[];
+    /**
+     * Returns the client address, replacing `ctx.ip`. Leave it out to use `ctx.ip`, which the
+     * app's `trustProxy()` setting decides — the same address every other feature sees.
+     */
     getIp?: (req: Request) => string | null;
-    trustProxy?: boolean;
 };
+/**
+ * Allows or rejects requests by client address. Rules and addresses are compared in canonical
+ * numeric form, so `::ffff:203.0.113.7`, `203.0.113.7` and `203.0.113.7:51234` are one address.
+ *
+ * Fails closed: a request whose address is unknown or unparseable is rejected with 403, under
+ * a deny list as much as under an allow list.
+ */
 export declare function ipRestrict(opts: IpRestrictOptions): MiddlewareFn<{
     req: Request;
 }, {}>;

package/dist/ip-restrict.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ip-restrict.d.ts","sourceRoot":"","sources":["../src/ip-restrict.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGnD,KAAK,iBAAiB,GAAG;IACxB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAA;IACvC,UAAU,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAqJD,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,EAAE,EAAE,CAAC,CAiCtF"}
+{"version":3,"file":"ip-restrict.d.ts","sourceRoot":"","sources":["../src/ip-restrict.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGnD,KAAK,iBAAiB,GAAG;IACxB,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAA;CACvC,CAAA;AAmBD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,EAAE,EAAE,CAAC,CAoCtF"}

package/dist/ip-restrict.js

@@ -0,0 +1,60 @@
+import { namedMiddleware } from "./middleware.js";
+import { HoneyError } from "./error.js";
+import { ipInRange, parseIp, parseIpRange } from "./ip.js";
+import { EK, SK } from "./types.js";
+function parseRules(list, name) {
+    if (list === undefined)
+        return [];
+    return list.map((rule) => {
+        const range = typeof rule === "string" ? parseIpRange(rule) : null;
+        if (range === null)
+            throw new Error(`ipRestrict: ${name} entry ${JSON.stringify(rule)} is not an IP address or CIDR range`);
+        return range;
+    });
+}
+function throwForbidden() {
+    throw new HoneyError({
+        errorKey: EK.forbidden,
+        status: SK.forbidden,
+    });
+}
+/**
+ * Allows or rejects requests by client address. Rules and addresses are compared in canonical
+ * numeric form, so `::ffff:203.0.113.7`, `203.0.113.7` and `203.0.113.7:51234` are one address.
+ *
+ * Fails closed: a request whose address is unknown or unparseable is rejected with 403, under
+ * a deny list as much as under an allow list.
+ */
+export function ipRestrict(opts) {
+    const legacy = opts;
+    if (legacy.trustProxy !== undefined || legacy.trustCloudflare !== undefined) {
+        throw new Error("ipRestrict: `trustProxy` and `trustCloudflare` moved to the app. Call `app.trustProxy(1)` " +
+            "(one reverse proxy) or `app.trustProxy([...proxy ranges])`; on Cloudflare Workers `ctx.ip` " +
+            "already reads CF-Connecting-IP.");
+    }
+    if (opts.allowList !== undefined && opts.allowList.length === 0) {
+        throw new Error("ipRestrict: `allowList: []` would reject every request. Remove the middleware or list addresses.");
+    }
+    const denyRules = parseRules(opts.denyList, "denyList");
+    const allowRules = parseRules(opts.allowList, "allowList");
+    if (denyRules.length === 0 && allowRules.length === 0) {
+        throw new Error("ipRestrict: pass a non-empty `allowList` or `denyList`");
+    }
+    const getIp = opts.getIp;
+    const mw = (ctx, next) => {
+        const raw = getIp ? getIp(ctx.req) : (ctx.ip ?? null);
+        const addr = raw === null || raw === "" ? null : parseIp(raw);
+        /* fail closed: an unknown address can match neither list */
+        if (addr === null)
+            throwForbidden();
+        for (const rule of denyRules) {
+            if (ipInRange(addr, rule))
+                throwForbidden();
+        }
+        if (allowRules.length > 0 && !allowRules.some((rule) => ipInRange(addr, rule)))
+            throwForbidden();
+        return next();
+    };
+    return namedMiddleware("ipRestrict", mw);
+}
+//# sourceMappingURL=ip-restrict.js.map

package/dist/ip-restrict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip-restrict.js","sourceRoot":"","sources":["../src/ip-restrict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAgB,MAAM,SAAS,CAAA;AAExE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AAcnC,SAAS,UAAU,CAAC,IAAmC,EAAE,IAAY;IACpE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IACjC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAClE,IAAI,KAAK,KAAK,IAAI;YACjB,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,UAAU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAA;QACxG,OAAO,KAAK,CAAA;IACb,CAAC,CAAC,CAAA;AACH,CAAC;AAED,SAAS,cAAc;IACtB,MAAM,IAAI,UAAU,CAAC;QACpB,QAAQ,EAAE,EAAE,CAAC,SAAS;QACtB,MAAM,EAAE,EAAE,CAAC,SAAS;KACpB,CAAC,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAAuB;IACjD,MAAM,MAAM,GAAG,IAA2D,CAAA;IAC1E,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAC7E,MAAM,IAAI,KAAK,CACd,4FAA4F;YAC3F,6FAA6F;YAC7F,iCAAiC,CAClC,CAAA;IACF,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,kGAAkG,CAAC,CAAA;IACpH,CAAC;IACD,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IACvD,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;IAC1D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;IAC1E,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IAExB,MAAM,EAAE,GAAuC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QAC5D,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,GAA8B,CAAC,EAAE,IAAI,IAAI,CAAC,CAAA;QACjF,MAAM,IAAI,GAAG,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAE7D,4DAA4D;QAC5D,IAAI,IAAI,KAAK,IAAI;YAAE,cAAc,EAAE,CAAA;QAEnC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC9B,IAAI,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;gBAAE,cAAc,EAAE,CAAA;QAC5C,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAAE,cAAc,EAAE,CAAA;QAEhG,OAAO,IAAI,EAAE,CAAA;IACd,CAAC,CAAA;IAED,OAAO,eAAe,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;AACzC,CAAC"}

package/dist/ip.d.ts

@@ -0,0 +1,39 @@
+/**
+ * IP addresses in canonical numeric form. Every comparison the framework makes (`ipRestrict`
+ * rules, trusted proxy ranges) parses both sides here first, so `::ffff:203.0.113.7`,
+ * `203.0.113.7` and `203.0.113.7:51234` are one address and `2001:DB8::1` equals `2001:db8::1`.
+ */
+export type IpAddress = {
+    readonly v: 4;
+    readonly n: number;
+} | {
+    readonly v: 6;
+    readonly n: bigint;
+};
+export type IpRange = {
+    readonly v: 4;
+    readonly base: number;
+    readonly mask: number;
+} | {
+    readonly v: 6;
+    readonly base: bigint;
+    readonly mask: bigint;
+};
+/**
+ * Parses an address as a peer or a forwarding header writes it: brackets, an IPv6 zone
+ * (`%eth0`) and a port (`1.2.3.4:5678`, `[::1]:5678`) are accepted and dropped. Returns
+ * `null` for anything that is not exactly one address.
+ */
+export declare function parseIp(input: string): IpAddress | null;
+/** Canonical text: dotted IPv4, or RFC 5952 IPv6 (lowercase, longest zero run compressed). */
+export declare function formatIp(addr: IpAddress): string;
+/** `canonicalIp("::ffff:127.0.0.1")` is `"127.0.0.1"`; `null` when the input is not an address. */
+export declare function canonicalIp(input: string): string | null;
+/**
+ * Parses an address or CIDR rule (`10.0.0.0/8`, `2001:db8::/32`, `203.0.113.7`). Strict: no
+ * port, no zone, a prefix length that fits the family. An IPv4-mapped IPv6 range of `/96` or
+ * longer is the IPv4 range it maps. Returns `null` when the rule is invalid.
+ */
+export declare function parseIpRange(rule: string): IpRange | null;
+export declare function ipInRange(addr: IpAddress, range: IpRange): boolean;
+//# sourceMappingURL=ip.d.ts.map

package/dist/ip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip.d.ts","sourceRoot":"","sources":["../src/ip.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAErG,MAAM,MAAM,OAAO,GAChB;IAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAwElE;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAyBvD;AAED,8FAA8F;AAC9F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CA2BhD;AAED,mGAAmG;AACnG,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGxD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CA2BzD;AAOD,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAIlE"}

package/dist/ip.js

@@ -0,0 +1,209 @@
+/**
+ * IP addresses in canonical numeric form. Every comparison the framework makes (`ipRestrict`
+ * rules, trusted proxy ranges) parses both sides here first, so `::ffff:203.0.113.7`,
+ * `203.0.113.7` and `203.0.113.7:51234` are one address and `2001:DB8::1` equals `2001:db8::1`.
+ */
+const V4_MAPPED_PREFIX = 0xffffn << 32n;
+const V4_MAPPED_MASK = ~0xffffffffn & ((1n << 128n) - 1n);
+function parseIpv4(s) {
+    const parts = s.split(".");
+    if (parts.length !== 4)
+        return null;
+    let n = 0;
+    for (const part of parts) {
+        /* digits only, no leading zeros (`010` is octal to some parsers, decimal to others) */
+        if (part.length === 0 || part.length > 3 || !/^\d+$/.test(part))
+            return null;
+        if (part.length > 1 && part.charCodeAt(0) === 48)
+            return null;
+        const octet = Number(part);
+        if (octet > 255)
+            return null;
+        n = n * 256 + octet;
+    }
+    return n;
+}
+/** The `:`-separated hex groups of one side of `::`; `null` when a group is not 1–4 hex digits. */
+function groupsOf(part) {
+    if (part === "")
+        return [];
+    const groups = part.split(":");
+    for (const g of groups) {
+        if (!/^[0-9A-Fa-f]{1,4}$/.test(g))
+            return null;
+    }
+    return groups;
+}
+function parseIpv6(s) {
+    let addr = s;
+    let tail = [];
+    const lastColon = addr.lastIndexOf(":");
+    if (lastColon !== -1 && addr.indexOf(".", lastColon) !== -1) {
+        const v4 = parseIpv4(addr.slice(lastColon + 1));
+        if (v4 === null)
+            return null;
+        tail = [Math.floor(v4 / 65536), v4 % 65536];
+        addr = addr.slice(0, lastColon + 1);
+        /* "::1.2.3.4" leaves "::", "a::1.2.3.4" leaves "a::"; "a:1.2.3.4" leaves "a:" */
+        if (addr.endsWith(":") && !addr.endsWith("::"))
+            addr = addr.slice(0, -1);
+    }
+    const halves = addr.split("::");
+    if (halves.length > 2)
+        return null;
+    const left = groupsOf(halves[0]);
+    if (left === null)
+        return null;
+    let groups;
+    if (halves.length === 2) {
+        const right = groupsOf(halves[1]);
+        if (right === null)
+            return null;
+        const fill = 8 - left.length - right.length - tail.length;
+        if (fill < 1)
+            return null;
+        groups = [...left.map(hex), ...Array.from({ length: fill }, () => 0), ...right.map(hex), ...tail];
+    }
+    else {
+        groups = [...left.map(hex), ...tail];
+    }
+    if (groups.length !== 8)
+        return null;
+    let n = 0n;
+    for (const g of groups)
+        n = (n << 16n) | BigInt(g);
+    return n;
+}
+function hex(g) {
+    return Number.parseInt(g, 16);
+}
+/** An IPv4-mapped IPv6 address (`::ffff:a.b.c.d`) is the IPv4 address it maps. */
+function fromV6(n) {
+    if ((n & V4_MAPPED_MASK) === V4_MAPPED_PREFIX)
+        return { n: Number(n & 0xffffffffn), v: 4 };
+    return { n, v: 6 };
+}
+/**
+ * Parses an address as a peer or a forwarding header writes it: brackets, an IPv6 zone
+ * (`%eth0`) and a port (`1.2.3.4:5678`, `[::1]:5678`) are accepted and dropped. Returns
+ * `null` for anything that is not exactly one address.
+ */
+export function parseIp(input) {
+    let s = input.trim();
+    if (s.startsWith("[")) {
+        const close = s.indexOf("]");
+        if (close === -1)
+            return null;
+        const after = s.slice(close + 1);
+        if (after !== "" && !/^:\d{1,5}$/.test(after))
+            return null;
+        s = s.slice(1, close);
+    }
+    else if (s.indexOf(":") !== -1 && s.indexOf(":") === s.lastIndexOf(":") && s.includes(".")) {
+        /* "1.2.3.4:5678" — one colon and a dot can only be IPv4 with a port */
+        const [host, port] = s.split(":");
+        if (!/^\d{1,5}$/.test(port))
+            return null;
+        s = host;
+    }
+    const zone = s.indexOf("%");
+    if (zone !== -1) {
+        if (!s.includes(":"))
+            return null;
+        s = s.slice(0, zone);
+    }
+    if (s.includes(":")) {
+        const n = parseIpv6(s);
+        return n === null ? null : fromV6(n);
+    }
+    const n = parseIpv4(s);
+    return n === null ? null : { n, v: 4 };
+}
+/** Canonical text: dotted IPv4, or RFC 5952 IPv6 (lowercase, longest zero run compressed). */
+export function formatIp(addr) {
+    if (addr.v === 4) {
+        const n = addr.n;
+        return `${Math.floor(n / 16777216)}.${Math.floor(n / 65536) % 256}.${Math.floor(n / 256) % 256}.${n % 256}`;
+    }
+    const groups = [];
+    for (let i = 7; i >= 0; i--)
+        groups.push(Number((addr.n >> BigInt(i * 16)) & 0xffffn));
+    let bestStart = -1;
+    let bestLen = 1;
+    for (let i = 0; i < 8;) {
+        if (groups[i] !== 0) {
+            i++;
+            continue;
+        }
+        let j = i;
+        while (j < 8 && groups[j] === 0)
+            j++;
+        if (j - i > bestLen) {
+            bestStart = i;
+            bestLen = j - i;
+        }
+        i = j;
+    }
+    const text = groups.map((g) => g.toString(16));
+    if (bestStart === -1)
+        return text.join(":");
+    const head = text.slice(0, bestStart).join(":");
+    const tail = text.slice(bestStart + bestLen).join(":");
+    return `${head}::${tail}`;
+}
+/** `canonicalIp("::ffff:127.0.0.1")` is `"127.0.0.1"`; `null` when the input is not an address. */
+export function canonicalIp(input) {
+    const addr = parseIp(input);
+    return addr === null ? null : formatIp(addr);
+}
+/**
+ * Parses an address or CIDR rule (`10.0.0.0/8`, `2001:db8::/32`, `203.0.113.7`). Strict: no
+ * port, no zone, a prefix length that fits the family. An IPv4-mapped IPv6 range of `/96` or
+ * longer is the IPv4 range it maps. Returns `null` when the rule is invalid.
+ */
+export function parseIpRange(rule) {
+    const s = rule.trim();
+    const slash = s.indexOf("/");
+    const ipText = slash === -1 ? s : s.slice(0, slash);
+    if (ipText.startsWith("[") || ipText.includes("%"))
+        return null;
+    let bits = null;
+    if (slash !== -1) {
+        const bitsText = s.slice(slash + 1);
+        if (!/^\d{1,3}$/.test(bitsText))
+            return null;
+        bits = Number(bitsText);
+    }
+    if (ipText.includes(":")) {
+        const n = parseIpv6(ipText);
+        if (n === null)
+            return null;
+        const prefix = bits ?? 128;
+        if (prefix > 128)
+            return null;
+        if ((n & V4_MAPPED_MASK) === V4_MAPPED_PREFIX && prefix >= 96) {
+            return v4Range(Number(n & 0xffffffffn), prefix - 96);
+        }
+        const mask = prefix === 0 ? 0n : (((1n << BigInt(prefix)) - 1n) << BigInt(128 - prefix)) & ((1n << 128n) - 1n);
+        return { base: n & mask, mask, v: 6 };
+    }
+    const n = parseIpv4(ipText);
+    if (n === null)
+        return null;
+    const prefix = bits ?? 32;
+    if (prefix > 32)
+        return null;
+    return v4Range(n, prefix);
+}
+function v4Range(n, prefix) {
+    const mask = prefix === 0 ? 0 : (0xffffffff << (32 - prefix)) >>> 0;
+    return { base: (n & mask) >>> 0, mask, v: 4 };
+}
+export function ipInRange(addr, range) {
+    if (addr.v === 4 && range.v === 4)
+        return (addr.n & range.mask) >>> 0 === range.base;
+    if (addr.v === 6 && range.v === 6)
+        return (addr.n & range.mask) === range.base;
+    return false;
+}
+//# sourceMappingURL=ip.js.map

package/dist/ip.js.map

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

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAInD,KAAK,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AAavE,KAAK,cAAc,GAAG;IACrB,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAAA;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtD,KAAK,EAAE,QAAQ,CAAA;IACf,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtD,CAAA;AAED,KAAK,mBAAmB,GAAG;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B,CAAA;AAED,iBAAS,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,cAAc,CAgChE;AAID,KAAK,OAAO,GAAG;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,MAAM,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,aAAa,GAAG;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAC7B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAA;CACjC,CAAA;AAUD,iBAAS,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,EAAE;IAAE,GAAG,EAAE,cAAc,CAAA;CAAE,CAAC,CA8C9G;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,CAAA;AAC/B,YAAY,EAAE,mBAAmB,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAA"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAInD,KAAK,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AAavE,KAAK,cAAc,GAAG;IACrB,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,cAAc,CAAA;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvD,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtD,KAAK,EAAE,QAAQ,CAAA;IACf,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtD,CAAA;AAED,KAAK,mBAAmB,GAAG;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B,CAAA;AAuDD,iBAAS,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,cAAc,CAEhE;AAID,KAAK,OAAO,GAAG;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,MAAM,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,aAAa,GAAG;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAC7B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAA;CACjC,CAAA;AAUD,iBAAS,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,EAAE;IAAE,GAAG,EAAE,cAAc,CAAA;CAAE,CAAC,CAoD9G;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,CAAA;AAC/B,YAAY,EAAE,mBAAmB,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAA"}

package/dist/logger.js

@@ -0,0 +1,113 @@
+import { namedMiddleware } from "./middleware.js";
+const LEVELS = {
+    debug: 20,
+    error: 50,
+    fatal: 60,
+    info: 30,
+    trace: 10,
+    warn: 40,
+};
+/* Methods live on the prototype: `logger()` makes a child per request, and a
+ * closure-per-level instance cost seven allocations each time. */
+class Logger {
+    level;
+    #threshold;
+    #write;
+    #base;
+    constructor(level, write, base) {
+        this.level = level;
+        this.#threshold = LEVELS[level];
+        this.#write = write;
+        this.#base = base;
+    }
+    child(bindings) {
+        return new Logger(this.level, this.#write, { ...this.#base, ...bindings });
+    }
+    trace(first, second) {
+        this.#emit(LEVELS.trace, first, second);
+    }
+    debug(first, second) {
+        this.#emit(LEVELS.debug, first, second);
+    }
+    info(first, second) {
+        this.#emit(LEVELS.info, first, second);
+    }
+    warn(first, second) {
+        this.#emit(LEVELS.warn, first, second);
+    }
+    error(first, second) {
+        this.#emit(LEVELS.error, first, second);
+    }
+    fatal(first, second) {
+        this.#emit(LEVELS.fatal, first, second);
+    }
+    #emit(level, first, second) {
+        if (level < this.#threshold)
+            return;
+        const obj = typeof first === "string"
+            ? { ...this.#base, level, msg: first, time: Date.now() }
+            : { ...this.#base, ...first, level, msg: second ?? "", time: Date.now() };
+        this.#write(JSON.stringify(obj));
+    }
+}
+function createLogger(opts) {
+    return new Logger(opts?.level ?? "info", opts?.write ?? ((line) => console.log(line)), opts?.base ?? {});
+}
+function defaultLog(data) {
+    const rid = data.requestId ? ` ${data.requestId}` : "";
+    console.log(`${data.method} ${data.path} ${data.status} ${data.duration.toFixed(2)}ms${rid}`);
+}
+const noop = () => { };
+const noopLogger = createLogger({ level: "fatal", write: noop });
+function logger(options) {
+    const log = options?.log ?? defaultLog;
+    const skip = options?.skip;
+    const instance = options?.instance;
+    return namedMiddleware("logger", async (ctx, next) => {
+        const start = performance.now();
+        const method = ctx.req.method;
+        const path = ctx.path;
+        const rid = ctx["requestId"] ?? null;
+        const child = instance
+            ? instance.child({
+                method,
+                path,
+                ...(rid ? { requestId: rid } : {}),
+            })
+            : noopLogger;
+        /* a failing sink never fails the request, on the way in or out */
+        if (instance) {
+            try {
+                child.info(`--> ${method} ${path}`);
+            }
+            catch (err) {
+                console.error("logger: failed to log request", err);
+            }
+        }
+        const response = await next({ log: child });
+        const duration = performance.now() - start;
+        const data = {
+            duration,
+            method,
+            path,
+            requestId: rid,
+            status: response.status,
+        };
+        try {
+            if (skip?.(data))
+                return response;
+            if (instance) {
+                child.info({ duration, status: response.status }, `<-- ${method} ${path}`);
+            }
+            else {
+                log(data);
+            }
+        }
+        catch (err) {
+            console.error("logger: failed to log request", err);
+        }
+        return response;
+    });
+}
+export { createLogger, logger };
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/media-type.d.ts

@@ -0,0 +1,30 @@
+/**
+ * One media-type parser (RFC 9110 §8.3.1) for every place that reads a `Content-Type`:
+ * input validation, `bodyLimit`, and the client. Type, subtype and parameter names are
+ * case-insensitive, so they are lowercased; parameter values keep their case.
+ *
+ * Pure and dependency-free: the client entry imports it too.
+ */
+export type MediaType = {
+    /** `type/subtype`, lowercased, without parameters */
+    essence: string;
+    /** parameters by lowercased name; a repeated name keeps the first value */
+    params: Record<string, string>;
+    subtype: string;
+    /** the structured-syntax suffix (`json` for `application/vnd.api+json`), or `null` */
+    suffix: string | null;
+    type: string;
+};
+/**
+ * Parses a `Content-Type` (or any media type) value. Returns `null` for an absent or
+ * malformed value, so a caller never mistakes `application/jsonx` or `json` for JSON.
+ */
+export declare function parseMediaType(value: string | null | undefined): MediaType | null;
+/** `application/json`, or any `+json` structured-syntax type (`application/problem+json`). */
+export declare function isJsonMediaType(mt: MediaType | null): boolean;
+/** Text-like bodies: `text/*`, `application/xml`, and any `+xml` type. */
+export declare function isTextMediaType(mt: MediaType | null): boolean;
+export type BodyParser = "json" | "multipart" | "urlencoded";
+/** Which body parser a request `Content-Type` selects, or `null` when none applies. */
+export declare function bodyParserFor(contentType: string | null | undefined): BodyParser | null;
+//# sourceMappingURL=media-type.d.ts.map

package/dist/media-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-type.d.ts","sourceRoot":"","sources":["../src/media-type.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,SAAS,GAAG;IACvB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAA;IACf,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,sFAAsF;IACtF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AASD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI,CAcjF;AAuCD,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAE7D;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,GAAG,OAAO,CAE7D;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,CAAA;AAE5D,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI,CAOvF"}