@tracepanel/js 0.3.4 → 0.4.1

package/dist/profile.js

@@ -0,0 +1,300 @@
+// Where a trace's time goes in code: V8's sampling profiler, through Node's inspector (the trace's `profile`, a flame
+// graph in the console). Nothing runs until a trace is profiled: the setting profiles every one, a request asks with
+// the X-Tracepanel-Profile: 1 header or the panel's tracepanel_profile=1 cookie.
+//
+// The profiler samples the whole thread, and one event loop runs every request of the process at once: a sample
+// can't tell which request a frame belongs to. So a profiled trace keeps the samples taken while it was the only trace
+// running here, as the Python SDK keeps a thread's samples only while it runs one trace; those taken while another
+// ran too are dropped and counted (`tracepanel.dropped_samples`). What the process did meanwhile outside any request
+// (a timer, the garbage collector) is in the profile too. Samples of an idle loop, the request waiting on I/O, are
+// left out: the profile is where the time went in code, on the CPU.
+//
+// One profile runs for as long as traces are profiled, so starting the next one costs next to nothing (the first
+// start reads every function V8 has compiled: tens of milliseconds); each trace's own profile is a console.profile()
+// under it, from its start to its end. It stops IDLE_MS after the last one.
+import { relative } from "node:path";
+import { createContextKey } from "@opentelemetry/api";
+import { call, connect, inspector } from "./inspector.js";
+import { headerValue, parseCookies } from "./request.js";
+import { inApp, libraryPath, ownFile, place } from "./stack.js";
+export const HEADER = "x-tracepanel-profile";
+export const COOKIE = "tracepanel_profile";
+/** On a request's root span: the request asked to be profiled. */
+export const ATTRIBUTE = "tracepanel.profile";
+/** In the context a framework starts the request's root span in (Next.js's): the request asked to be profiled. */
+export const ASKED = createContextKey("tracepanel.profile");
+// How deep a stack is kept: a recursion beyond it is cut, outermost frames kept.
+const MAX_DEPTH = 128;
+// Distinct stacks one trace keeps; the rest are counted as one "(other)" frame, so a profile stays small.
+const MAX_STACKS = 2000;
+// How long the profiler runs on with no trace profiled, ready for the next one.
+const IDLE_MS = 30_000;
+// A profiler running this long is started anew once no trace is profiled: its own samples pile up meanwhile.
+const RENEW_MS = 60_000;
+// V8's own entries: the loop waiting (no work to profile), and the root every stack starts from.
+const IDLE = "(idle)";
+const ROOT = "(root)";
+const OTHER = { function: "(other)", module: null, file: "", line: 0, in_app: false };
+/** Whether a request asks to be profiled: the X-Tracepanel-Profile header, or the cookie the panel's toggle sets. */
+export function requested(headers) {
+    if (headerValue(headers[HEADER])?.trim() === "1")
+        return true;
+    const cookies = headerValue(headers.cookie);
+    return (cookies?.includes(COOKIE) === true &&
+        parseCookies(cookies).some(([name, value]) => name === COOKIE && value === "1"));
+}
+/** Whether to profile a trace: the setting profiles every one, a request may ask; nothing when profiling is off. */
+export function wanted(config, asked) {
+    return config.profileEnabled && (config.profile || asked) && available();
+}
+/** Whether this runtime can profile: Node, with its inspector. */
+export function available() {
+    return inspector() !== null;
+}
+let next = 0;
+/** The app's profiler: the profile that runs while traces are profiled, and when each trace of the process ran. */
+export class Profiler {
+    root;
+    intervalMs;
+    session;
+    running = false;
+    runningSince = 0;
+    idle;
+    recordings = new Set();
+    /** Every trace of the process running now, and when it started. */
+    open = new Map();
+    /** Traces that ended while one was profiled: when each started and ended. */
+    ended = [];
+    /** The console profiles stopped, by title, as the inspector hands them over. */
+    finished = new Map();
+    constructor(root, intervalMs) {
+        this.root = root;
+        this.intervalMs = intervalMs;
+    }
+    /** A trace started (each one, profiled or not): a sample taken while it runs may be its. */
+    enter(trace) {
+        this.open.set(trace, performance.now());
+    }
+    /** A trace ended. */
+    leave(trace) {
+        const started = this.open.get(trace);
+        if (started === undefined)
+            return;
+        this.open.delete(trace);
+        if (this.recordings.size > 0)
+            this.ended.push([started, performance.now()]);
+    }
+    /** Begins profiling a trace that started (enter() first); undefined when the inspector can't. */
+    start(trace) {
+        const console = inspector()?.console;
+        if (!console || !this.ensure())
+            return undefined;
+        clearTimeout(this.idle);
+        next += 1;
+        const recording = { title: `tracepanel:${next}`, startedMs: performance.now(), trace };
+        console.profile(recording.title);
+        this.recordings.add(recording);
+        return recording;
+    }
+    /** Ends a trace's profile, before it leaves: what was sampled while it alone ran. */
+    stop(recording) {
+        if (!this.recordings.has(recording))
+            return { profile: undefined, dropped: 0 };
+        inspector()?.console.profileEnd(recording.title);
+        this.recordings.delete(recording);
+        const profile = this.finished.get(recording.title);
+        this.finished.delete(recording.title);
+        const result = profile ? this.document(recording, profile) : { profile: undefined, dropped: 0 };
+        if (this.recordings.size === 0)
+            this.rest();
+        else {
+            const oldest = Math.min(...[...this.recordings].map((other) => other.startedMs));
+            this.ended = this.ended.filter(([, end]) => end >= oldest);
+        }
+        return result;
+    }
+    /** The profile that runs under the traces' own: started with the first profiled trace. */
+    ensure() {
+        if (!this.session) {
+            const session = connect();
+            if (!session)
+                return false;
+            try {
+                call(session, "Profiler.enable");
+                call(session, "Profiler.setSamplingInterval", { interval: Math.round(this.intervalMs * 1000) });
+            }
+            catch {
+                session.disconnect();
+                return false;
+            }
+            session.on("Profiler.consoleProfileFinished", (message) => {
+                const { title, profile } = message.params;
+                // Only this profiler's: another session's console.profile() reaches every session.
+                if ([...this.recordings].some((recording) => recording.title === title))
+                    this.finished.set(title ?? "", profile);
+            });
+            this.session = session;
+        }
+        if (!this.running) {
+            try {
+                call(this.session, "Profiler.start");
+            }
+            catch {
+                return false;
+            }
+            this.running = true;
+            this.runningSince = performance.now();
+        }
+        return true;
+    }
+    /** No trace is profiled: the profile under them stops after a while, or now when it ran long. */
+    rest() {
+        this.ended = [];
+        if (performance.now() - this.runningSince > RENEW_MS) {
+            this.halt();
+            return;
+        }
+        clearTimeout(this.idle);
+        this.idle = setTimeout(() => this.halt(), IDLE_MS);
+        this.idle.unref();
+    }
+    halt() {
+        if (!this.session || !this.running || this.recordings.size > 0)
+            return;
+        this.running = false;
+        try {
+            call(this.session, "Profiler.stop");
+        }
+        catch {
+            // Stopped already.
+        }
+    }
+    /** Whether another trace than the recording's ran at `at` (performance.now()). */
+    shared(recording, at) {
+        for (const [trace, started] of this.open) {
+            if (trace !== recording.trace && started <= at)
+                return true;
+        }
+        return this.ended.some(([started, end]) => started <= at && at <= end);
+    }
+    /** The trace's `profile`: the functions its stacks name, each once, and each stack as indexes into them. */
+    document(recording, profile) {
+        const nodes = new Map(profile.nodes.map((node) => [node.id, node]));
+        const parents = new Map();
+        for (const node of profile.nodes)
+            for (const child of node.children ?? [])
+                parents.set(child, node.id);
+        const index = new Map();
+        const frames = [];
+        /** A node's stack as indexes into frames, outermost first; null for the idle loop. */
+        const stackOf = new Map();
+        const frameIndex = (callFrame) => {
+            const key = `${callFrame.url}:${callFrame.lineNumber}:${callFrame.columnNumber}:${callFrame.functionName}`;
+            const known = index.get(key);
+            if (known !== undefined)
+                return known;
+            const frame = this.frame(callFrame);
+            if (!frame)
+                return null;
+            index.set(key, frames.length);
+            frames.push(frame);
+            return frames.length - 1;
+        };
+        const stack = (id) => {
+            const known = stackOf.get(id);
+            if (known !== undefined)
+                return known;
+            const chain = [];
+            for (let at = id; at !== undefined; at = parents.get(at)) {
+                const node = nodes.get(at);
+                if (node && node.callFrame.functionName !== ROOT)
+                    chain.push(node.callFrame);
+            }
+            let found = null;
+            if (chain[0]?.functionName !== IDLE) {
+                found = [];
+                for (const callFrame of chain.reverse()) {
+                    if (found.length >= MAX_DEPTH)
+                        break;
+                    const at = frameIndex(callFrame);
+                    if (at !== null)
+                        found.push(at);
+                }
+            }
+            stackOf.set(id, found);
+            return found;
+        };
+        const counts = new Map();
+        let samples = 0;
+        let dropped = 0;
+        let time = profile.startTime;
+        const deltas = profile.timeDeltas ?? [];
+        (profile.samples ?? []).forEach((id, at) => {
+            time += deltas[at] ?? 0;
+            let keys = stack(id);
+            if (keys === null || keys.length === 0)
+                return;
+            // The profile's clock is V8's; it started as the recording did.
+            if (this.shared(recording, recording.startedMs + (time - profile.startTime) / 1000)) {
+                dropped += 1;
+                return;
+            }
+            let key = keys.join(",");
+            if (!counts.has(key) && counts.size >= MAX_STACKS) {
+                let other = index.get(OTHER.function);
+                if (other === undefined) {
+                    other = frames.length;
+                    index.set(OTHER.function, other);
+                    frames.push(OTHER);
+                }
+                keys = [other];
+                key = String(other);
+            }
+            const counted = counts.get(key);
+            if (counted)
+                counted.count += 1;
+            else
+                counts.set(key, { frames: keys, count: 1 });
+            samples += 1;
+        });
+        if (samples === 0)
+            return { profile: undefined, dropped };
+        // Only the frames the kept stacks name, in the order the most frequent stacks name them.
+        const stacks = [...counts.values()].sort((a, b) => b.count - a.count);
+        const kept = [];
+        const renumber = new Map();
+        for (const counted of stacks) {
+            counted.frames = counted.frames.map((frame) => {
+                let to = renumber.get(frame);
+                if (to === undefined) {
+                    to = kept.length;
+                    renumber.set(frame, to);
+                    kept.push(frames[frame]);
+                }
+                return to;
+            });
+        }
+        return {
+            profile: { interval_us: Math.round(this.intervalMs * 1000), samples, frames: kept, stacks },
+            dropped,
+        };
+    }
+    /** A function as the profile names it; null for this package's own. */
+    frame(callFrame) {
+        const name = callFrame.functionName || "(anonymous)";
+        if (!callFrame.url)
+            return { function: name, module: null, file: "", line: 0, in_app: false };
+        const found = place(callFrame.url, callFrame.lineNumber + 1, callFrame.columnNumber + 1);
+        if (ownFile(found.file))
+            return null;
+        const own = inApp(found.file, this.root);
+        return {
+            function: name,
+            module: null,
+            file: own ? relative(this.root, found.file) : libraryPath(found.file),
+            line: found.line,
+            in_app: own,
+        };
+    }
+}
+//# sourceMappingURL=profile.js.map

package/dist/profile.js.map

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

package/dist/request.d.ts

@@ -0,0 +1,61 @@
+import type { Attrs } from "./model.js";
+/** How much of a body is kept, in characters. */
+export declare const MAX_BODY = 16384;
+export declare const MASK = "********";
+/** A name as one segment of an attribute's key (content-type -> content_type), as the trace format has keys. */
+export declare function key(name: string): string;
+/** Whether a secret goes under the name: x-api-key, csrftoken, sessionid, password. */
+export declare function sensitive(name: string): boolean;
+/** A header's value as one string: several values joined, as Node joins them. */
+export declare function headerValue(value: unknown): string | undefined;
+/** http.request.header.<name>, the name as a key; Cookie is read as cookies instead. */
+export declare function requestHeaders(entries: Iterable<[string, unknown]>): Attrs;
+/** http.response.header.<name>: several values joined, Set-Cookie masked. */
+export declare function responseHeaders(entries: Iterable<[string, unknown]>): Attrs;
+/** url.query: the query string, the values of sensitive parameters masked. */
+export declare function query(search: string): Attrs;
+/** The Cookie header's cookies by name, as they came. */
+export declare function parseCookies(header: string): [string, string][];
+/** http.request.cookie.<name>, from the Cookie header; a session id or a CSRF token masked. */
+export declare function cookies(header: string): Attrs;
+/** The request's headers by lower-case name, from Node's IncomingMessage or a fetch Request. */
+export type RequestHeaders = Record<string, string | string[] | undefined>;
+/** What the request carried before the app read it: its headers, query and cookies. */
+export declare function requestAttrs(requested: RequestHeaders, search: string): Attrs;
+/** The query string of a request's URL (/books?page=2 -> ?page=2). */
+export declare function searchOf(url: string): string;
+export declare function cut(text: string): Attrs;
+/** A JSON value with the values under sensitive keys masked, at any depth. */
+export declare function masked(value: unknown): unknown;
+/** A form's fields as they would have been sent, sensitive values masked, then its files by name and size. */
+export declare function formText(fields: Iterable<[string, unknown]>, files?: [string, string, number][]): string;
+export declare function kindOf(contentType: string): string;
+/**
+ * http.request.body from the bytes the app read, as far as it read them: JSON and forms with secrets masked, text as
+ * it is, binary not. `complete` is false when only the start of the body is at hand: JSON or a form can't be read
+ * (nor its secrets masked) from a part of it.
+ */
+export declare function readBody(contentType: string, data: Uint8Array, complete: boolean): Attrs;
+/** What a request's body parser left on it: `req.body`, and `req.file`/`req.files` of an upload. */
+export interface ParsedBody {
+    contentType: string;
+    body: unknown;
+    file?: unknown;
+    files?: unknown;
+}
+/**
+ * http.request.body from what the app's body parser read: JSON and forms with secrets masked, text as it is, an
+ * upload's files by name and size. Nothing when no parser read it.
+ */
+export declare function parsedBody({ contentType, body, file, files }: ParsedBody): Attrs;
+/** Whether a request came with a body: one declared by its size, or sent in chunks. */
+export declare function hasBody(requested: RequestHeaders): boolean;
+/**
+ * The requests that answered a page's navigation with a redirect, by id, on the way to the page the widget will see:
+ * its panel lists them before that page (a form's POST, then the page it redirected to).
+ */
+export declare const REDIRECTS = "tracepanel_redirect";
+/** Whether the browser asked for a page to show (a link, a form): not fetch() or an image. */
+export declare function navigated(requested: RequestHeaders): boolean;
+/** The Set-Cookie naming this request too, for a redirect that answers a page's navigation; undefined otherwise. */
+export declare function redirectCookie(id: string, status: number, requested: RequestHeaders): string | undefined;

package/dist/request.js

@@ -0,0 +1,244 @@
+// What a request carried, as attributes of its trace: headers, query, cookies, the body the app read, the response's
+// headers; and the cookie that tells the widget which requests redirected to the page it is on.
+//
+// They stay on this machine (the agent keeps them out of what it sends anywhere), and the values under a sensitive
+// name are masked before they are recorded. A body is only what the app read itself, up to MAX_BODY characters: a
+// body parser's `req.body`, or the bytes the app's own reads took from the request's stream (body.ts). Tracepanel
+// never reads a request's stream for the app.
+/** How much of a body is kept, in characters. */
+export const MAX_BODY = 16_384;
+export const MASK = "********";
+const SENSITIVE = /pass(word|wd)?|secret|token|api_?key|auth|cookie|session|csrf|signature|private/i;
+/** A response's cookies are a session's keys, whatever their name. */
+const ALWAYS_MASKED = new Set(["set-cookie"]);
+/** A form as people read it: encoded, but its spaces, masks and file notes as they are. */
+const READABLE = /^[A-Za-z0-9_.~*<>,. /:@-]$/;
+/** A query's values: encoded as a form's, `+` for a space, masks and paths as they are. */
+const QUERY_SAFE = /^[A-Za-z0-9_.~*/:-]$/;
+/** A name as one segment of an attribute's key (content-type -> content_type), as the trace format has keys. */
+export function key(name) {
+    return name.toLowerCase().replace(/[^a-z0-9_]/g, "_") || "_";
+}
+/** Whether a secret goes under the name: x-api-key, csrftoken, sessionid, password. */
+export function sensitive(name) {
+    return SENSITIVE.test(name.replaceAll("-", "_"));
+}
+/** A header's value as one string: several values joined, as Node joins them. */
+export function headerValue(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    return Array.isArray(value) ? value.map(String).join(", ") : String(value);
+}
+function headers(prefix, entries) {
+    const found = {};
+    for (const [name, raw] of entries) {
+        const value = headerValue(raw);
+        if (!value)
+            continue;
+        const lowered = name.toLowerCase();
+        const attr = `${prefix}${key(lowered)}`;
+        if (ALWAYS_MASKED.has(lowered) || sensitive(lowered))
+            found[attr] = MASK;
+        else
+            found[attr] = attr in found ? `${found[attr]}, ${value}` : value;
+    }
+    return found;
+}
+/** http.request.header.<name>, the name as a key; Cookie is read as cookies instead. */
+export function requestHeaders(entries) {
+    return headers("http.request.header.", [...entries].filter(([name]) => name.toLowerCase() !== "cookie"));
+}
+/** http.response.header.<name>: several values joined, Set-Cookie masked. */
+export function responseHeaders(entries) {
+    return headers("http.response.header.", entries);
+}
+/** Percent-encoded but for the characters `safe` keeps; a space as `+` when `plus`. */
+function quote(text, safe, plus = false) {
+    let out = "";
+    for (const char of text) {
+        if (plus && char === " ")
+            out += "+";
+        else if (safe.test(char))
+            out += char;
+        else
+            for (const byte of Buffer.from(char))
+                out += `%${byte.toString(16).toUpperCase().padStart(2, "0")}`;
+    }
+    return out;
+}
+/** url.query: the query string, the values of sensitive parameters masked. */
+export function query(search) {
+    const raw = search.startsWith("?") ? search.slice(1) : search;
+    if (!raw)
+        return {};
+    const pairs = [...new URLSearchParams(raw)].map(([name, value]) => `${quote(name, QUERY_SAFE, true)}=${quote(sensitive(name) ? MASK : value, QUERY_SAFE, true)}`);
+    return { "url.query": pairs.join("&") };
+}
+/** The Cookie header's cookies by name, as they came. */
+export function parseCookies(header) {
+    const found = [];
+    for (const part of header.split(";")) {
+        const at = part.indexOf("=");
+        const name = part.slice(0, at).trim();
+        if (at >= 0 && name)
+            found.push([name, part.slice(at + 1).trim()]);
+    }
+    return found;
+}
+/** http.request.cookie.<name>, from the Cookie header; a session id or a CSRF token masked. */
+export function cookies(header) {
+    return Object.fromEntries(parseCookies(header).map(([name, value]) => [`http.request.cookie.${key(name)}`, sensitive(name) ? MASK : value]));
+}
+/** What the request carried before the app read it: its headers, query and cookies. */
+export function requestAttrs(requested, search) {
+    return {
+        ...requestHeaders(Object.entries(requested)),
+        ...query(search),
+        ...cookies(headerValue(requested.cookie) ?? ""),
+    };
+}
+/** The query string of a request's URL (/books?page=2 -> ?page=2). */
+export function searchOf(url) {
+    const at = url.indexOf("?");
+    return at < 0 ? "" : url.slice(at);
+}
+export function cut(text) {
+    if (text.length <= MAX_BODY)
+        return { "http.request.body": text };
+    return { "http.request.body": text.slice(0, MAX_BODY), "http.request.body.truncated": true };
+}
+/** A JSON value with the values under sensitive keys masked, at any depth. */
+export function masked(value) {
+    if (Array.isArray(value))
+        return value.map(masked);
+    if (value !== null && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([name, item]) => [name, sensitive(name) ? MASK : masked(item)]));
+    }
+    return value;
+}
+/** A form's fields as they would have been sent, sensitive values masked, then its files by name and size. */
+export function formText(fields, files = []) {
+    const pairs = [];
+    for (const [name, value] of fields) {
+        if (sensitive(name))
+            pairs.push([name, MASK]);
+        else if (Array.isArray(value))
+            for (const item of value)
+                pairs.push([name, plain(item)]);
+        else
+            pairs.push([name, plain(value)]);
+    }
+    for (const [field, name, size] of files)
+        pairs.push([field, `<file ${name}, ${size} bytes>`]);
+    return pairs.map(([name, value]) => `${quote(name, READABLE)}=${quote(value, READABLE)}`).join("&");
+}
+/** A form's value as text: a nested one (qs's `a[b]=c`) as JSON, its secrets masked. */
+function plain(value) {
+    return value !== null && typeof value === "object" ? JSON.stringify(masked(value)) : String(value ?? "");
+}
+export function kindOf(contentType) {
+    return (contentType.split(";", 1)[0] ?? "").trim().toLowerCase();
+}
+function isJson(kind) {
+    return kind === "application/json" || kind.endsWith("+json");
+}
+function isForm(kind) {
+    return kind === "application/x-www-form-urlencoded" || kind === "multipart/form-data";
+}
+/** A body read as text (a text or raw parser's): JSON and forms with secrets masked, text as it is, binary not. */
+function textBody(contentType, text) {
+    const kind = kindOf(contentType);
+    if (!text)
+        return {};
+    if (isJson(kind)) {
+        try {
+            return cut(JSON.stringify(masked(JSON.parse(text))));
+        }
+        catch {
+            return cut(text);
+        }
+    }
+    if (kind === "application/x-www-form-urlencoded")
+        return cut(formText(new URLSearchParams(text)));
+    if (kind.startsWith("text/") || kind === "application/xml" || kind === "application/graphql")
+        return cut(text);
+    return {};
+}
+/**
+ * http.request.body from the bytes the app read, as far as it read them: JSON and forms with secrets masked, text as
+ * it is, binary not. `complete` is false when only the start of the body is at hand: JSON or a form can't be read
+ * (nor its secrets masked) from a part of it.
+ */
+export function readBody(contentType, data, complete) {
+    const kind = kindOf(contentType);
+    if (data.length === 0 || (!complete && (isJson(kind) || isForm(kind))))
+        return {};
+    return textBody(contentType, Buffer.from(data.buffer, data.byteOffset, data.byteLength).toString("utf8"));
+}
+function uploads(file, files) {
+    const all = [];
+    if (file)
+        all.push(file);
+    if (Array.isArray(files))
+        all.push(...files);
+    else if (files && typeof files === "object")
+        for (const list of Object.values(files))
+            all.push(...[list].flat());
+    return all
+        .filter((item) => item !== null && typeof item === "object")
+        .map((item) => [String(item.fieldname ?? ""), String(item.originalname ?? ""), Number(item.size ?? 0)]);
+}
+/**
+ * http.request.body from what the app's body parser read: JSON and forms with secrets masked, text as it is, an
+ * upload's files by name and size. Nothing when no parser read it.
+ */
+export function parsedBody({ contentType, body, file, files }) {
+    const kind = kindOf(contentType);
+    const sent = uploads(file, files);
+    if (typeof body === "string")
+        return textBody(contentType, body);
+    if (body instanceof Uint8Array)
+        return textBody(contentType, Buffer.from(body).toString("utf8"));
+    if (body === undefined || body === null)
+        return sent.length > 0 ? cut(formText([], sent)) : {};
+    if (typeof body !== "object")
+        return cut(JSON.stringify(body));
+    if (isForm(kind)) {
+        const text = formText(Object.entries(body), sent);
+        return text ? cut(text) : {};
+    }
+    return cut(JSON.stringify(masked(body)));
+}
+/** Whether a request came with a body: one declared by its size, or sent in chunks. */
+export function hasBody(requested) {
+    const length = Number(headerValue(requested["content-length"]) ?? 0);
+    return length > 0 || (headerValue(requested["transfer-encoding"]) ?? "").toLowerCase().includes("chunked");
+}
+/**
+ * The requests that answered a page's navigation with a redirect, by id, on the way to the page the widget will see:
+ * its panel lists them before that page (a form's POST, then the page it redirected to).
+ */
+export const REDIRECTS = "tracepanel_redirect";
+/** How many redirects in a row are kept: a loop of them doesn't grow the cookie without end. */
+const MAX_REDIRECTS = 5;
+/** Whether the browser asked for a page to show (a link, a form): not fetch() or an image. */
+export function navigated(requested) {
+    const mode = headerValue(requested["sec-fetch-mode"]);
+    return mode !== undefined ? mode === "navigate" : (headerValue(requested.accept) ?? "").includes("text/html");
+}
+/** The Set-Cookie naming this request too, for a redirect that answers a page's navigation; undefined otherwise. */
+export function redirectCookie(id, status, requested) {
+    if (status < 300 || status >= 400 || !navigated(requested))
+        return undefined;
+    const sent = parseCookies(headerValue(requested.cookie) ?? "").find(([name]) => name === REDIRECTS)?.[1] ?? "";
+    let before;
+    try {
+        before = decodeURIComponent(sent).split(",").filter(Boolean);
+    }
+    catch {
+        before = [];
+    }
+    const value = encodeURIComponent([...before, id].slice(-MAX_REDIRECTS).join(","));
+    return `${REDIRECTS}=${value}; Max-Age=30; Path=/; SameSite=Lax`;
+}
+//# sourceMappingURL=request.js.map

package/dist/request.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,10 @@
+import type { Attrs } from "./model.js";
+/** session.<key> of a session's entries, under a prefix of its own when there are several (session.<name>.<key>). */
+export declare function sessionAttrs(entries: Iterable<[string, unknown]>, prefix?: string): Attrs;
+/**
+ * The session express-session or cookie-session put on an Express request, as the handler left it; none without one.
+ * express-session's `cookie` is the session cookie's settings, not what the app keeps in it.
+ */
+export declare function expressSession(session: unknown): Attrs;
+/** h3's sessions as the request left them (`event.context.sessions`), by name: those `useSession()` read. */
+export declare function h3Sessions(sessions: unknown): Attrs;