@wenathlan/saddle 1.8.8 → 1.8.10

package/dist/scrape/scraper.js

@@ -0,0 +1,46 @@
+/**
+ * scraper composes robots policy cache transport and extraction without browser assumptions.
+ */
+import { transport } from "../adapters/transport.js";
+import { extracthtml } from "./extract.js";
+import { robotsallowed, robotsdelay, robotsrules } from "./robots.js";
+import { ttlcache } from "./cache.js";
+export function scraper(options = {}) {
+    const client = options.transport ?? transport({ fetcher: options.fetcher, timeout: options.timeout, attempts: options.attempts });
+    const cache = options.cache ?? ttlcache(options.cacheoptions);
+    const agent = options.agent ?? "*";
+    const policies = new Map();
+    return {
+        async robots(origin) {
+            if (policies.has(origin))
+                return policies.get(origin);
+            const url = new URL("/robots.txt", origin).href;
+            const response = await client.request(url);
+            const rules = robotsrules(response.ok ? await response.text() : "");
+            policies.set(origin, rules);
+            return rules;
+        },
+        async scrape(url) {
+            const target = new URL(url);
+            if (!["http:", "https:"].includes(target.protocol))
+                throw new TypeError("scraper accepts http and https only");
+            const rules = await this.robots(target.origin);
+            if (!robotsallowed(rules, target.href, agent))
+                throw new Error("robots policy disallows target");
+            const cached = cache.get(target.href);
+            if (cached)
+                return cached;
+            const wait = robotsdelay(rules, agent);
+            if (wait)
+                await new Promise((resolve) => setTimeout(resolve, wait * 1000));
+            const response = await client.request(target.href, { headers: options.headers });
+            if (!response.ok)
+                throw new Error(`scrape request failed with ${response.status}`);
+            const result = extracthtml(await response.text(), target.href);
+            cache.set(target.href, result, { ttl: options.ttl });
+            return result;
+        },
+        cache
+    };
+}
+//# sourceMappingURL=scraper.js.map

package/dist/scrape/scraper.js.map

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

package/dist/scrape/semantic.d.ts

@@ -0,0 +1,25 @@
+/**
+ * semantic extraction exposes bounded headings, landmarks, controls and links without evaluating page code.
+ */
+/** Extracts semantic page facts from HTML using safe built-in parsing heuristics. */
+export declare function extractsemantic(html: any, url: any): {
+    url: any;
+    title: string;
+    headings: {
+        level: number;
+        text: string;
+    }[];
+    landmarks: {
+        role: string;
+        label: any;
+    }[];
+    controls: {
+        ref: string;
+        role: any;
+        name: any;
+        type: any;
+    }[];
+    links: any;
+    semantictext: string;
+};
+//# sourceMappingURL=semantic.d.ts.map

package/dist/scrape/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../scrape/semantic.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,IAAI,KAAA,EAAE,GAAG,KAAA;;;;;;;;;;;;;;;;;;;EAWxC"}

package/dist/scrape/semantic.js

@@ -0,0 +1,27 @@
+/**
+ * semantic extraction exposes bounded headings, landmarks, controls and links without evaluating page code.
+ */
+/** Extracts semantic page facts from HTML using safe built-in parsing heuristics. */
+export function extractsemantic(html, url) {
+    const source = String(html ?? "");
+    const headings = [...source.matchAll(/<h([1-6])\b[^>]*>([\s\S]*?)<\/h\1>/gi)].slice(0, 100).map((match) => ({ level: Number(match[1]), text: clean(match[2]) })).filter((item) => item.text);
+    const landmarks = [...source.matchAll(/<(main|nav|header|footer|aside|section|article)\b([^>]*)>/gi)].slice(0, 100).map((match) => ({ role: match[1].toLowerCase(), label: attribute(match[2], "aria-label") ?? attribute(match[2], "id") ?? "" }));
+    const controls = [...source.matchAll(/<(button|input|textarea|select|a)\b([^>]*)>([\s\S]*?)<\/\1>|<(input)\b([^>]*)\/?\s*>/gi)].slice(0, 200).map((match, index) => {
+        const tag = (match[1] ?? match[4]).toLowerCase();
+        const attrs = match[2] ?? match[5] ?? "";
+        return { ref: `e${index + 1}`, role: attribute(attrs, "role") ?? tag, name: attribute(attrs, "aria-label") ?? attribute(attrs, "placeholder") ?? clean(match[3] ?? ""), type: attribute(attrs, "type") };
+    });
+    const links = [...source.matchAll(/<a\b([^>]*)href=["']([^"']+)["'][^>]*>([\s\S]*?)<\/a>/gi)].slice(0, 500).map((match) => ({ url: resolve(match[2], url), text: clean(match[3]), rel: attribute(match[1], "rel") })).filter((link) => link.url);
+    return { url, title: clean(source.match(/<title[^>]*>([\s\S]*?)<\/title>/i)?.[1] ?? ""), headings, landmarks, controls, links: dedupe(links, (item) => item.url), semantictext: clean(source.replace(/<script[\s\S]*?<\/script>/gi, " ").replace(/<style[\s\S]*?<\/style>/gi, " ").replace(/<[^>]+>/g, " ")).slice(0, 100000) };
+}
+function clean(value) { return String(value ?? "").replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").replaceAll("&amp;", "&").replaceAll("&lt;", "<").replaceAll("&gt;", ">").trim(); }
+function attribute(value, name) { return value.match(new RegExp(`${name}=["']([^"']*)["']`, "i"))?.[1] ?? null; }
+function resolve(value, base) { try {
+    return new URL(value, base).href;
+}
+catch {
+    return null;
+} }
+function dedupe(values, key) { const seen = new Set(); return values.filter((value) => { const item = key(value); if (seen.has(item))
+    return false; seen.add(item); return true; }); }
+//# sourceMappingURL=semantic.js.map

package/dist/scrape/semantic.js.map

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

package/dist/server/node.d.ts

@@ -0,0 +1,7 @@
+/** Creates a Node HTTP adapter with explicit host, port, and request handler. */
+export declare function nodeserver(options?: {}): {
+    server: import("http").Server<typeof import("http").IncomingMessage, typeof import("http").ServerResponse>;
+    listen(): Promise<unknown>;
+    close(): Promise<unknown>;
+};
+//# sourceMappingURL=node.d.ts.map

package/dist/server/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../server/node.ts"],"names":[],"mappings":"AAKA,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,OAAO,KAAK;;;;EA2BtC"}

package/dist/server/node.js

@@ -0,0 +1,38 @@
+/**
+ * node server is an optional adapter around the universal service contract.
+ */
+import { createServer } from "node:http";
+/** Creates a Node HTTP adapter with explicit host, port, and request handler. */
+export function nodeserver(options = {}) {
+    if (!options.host || !Number.isInteger(options.port) || options.port < 1)
+        throw new TypeError("node server requires host and port");
+    if (typeof options.handle !== "function")
+        throw new TypeError("node server requires handle");
+    /* Request translation stays inside the Node adapter. */
+    const server = createServer(async (request, response) => {
+        try {
+            const chunks = [];
+            for await (const chunk of request)
+                chunks.push(chunk);
+            const body = Buffer.concat(chunks).toString("utf8");
+            const headers = new Headers(request.headers);
+            const webrequest = new Request(new URL(request.url ?? "/", `http://${options.host}:${options.port}`), { method: request.method, headers, body: body || undefined });
+            const result = await options.handle(webrequest);
+            response.statusCode = result.status;
+            result.headers.forEach((value, key) => response.setHeader(key, value));
+            response.end(Buffer.from(await result.arrayBuffer()));
+        }
+        catch (error) {
+            response.statusCode = 500;
+            response.setHeader("content-type", "application/json");
+            response.end(JSON.stringify({ error: error.message }));
+        }
+    });
+    /* Lifecycle methods keep the server optional for library consumers. */
+    return {
+        server,
+        listen() { return new Promise((resolve, reject) => { server.once("error", reject); server.listen(options.port, options.host, () => resolve({ host: options.host, port: options.port })); }); },
+        close() { return new Promise((resolve, reject) => server.close((error) => error ? reject(error) : resolve())); }
+    };
+}
+//# sourceMappingURL=node.js.map

package/dist/server/node.js.map

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

package/dist/sessions/file.d.ts

@@ -0,0 +1,25 @@
+export declare function filesessions(root: any): {
+    save(session: any): Promise<{
+        version: number;
+        id: any;
+        agentname: any;
+        originurl: any;
+        seed: any;
+        status: any;
+        startedat: any;
+        finishedat: any;
+        events: any;
+    }>;
+    load(id: any): Promise<{
+        version: number;
+        id: any;
+        agentname: any;
+        originurl: any;
+        seed: any;
+        status: any;
+        startedat: any;
+        finishedat: any;
+        events: any;
+    }>;
+};
+//# sourceMappingURL=file.d.ts.map

package/dist/sessions/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../sessions/file.ts"],"names":[],"mappings":"AAOA,wBAAgB,YAAY,CAAC,IAAI,KAAA;;;;;;;;;;;;;;;;;;;;;;;EAKhC"}

package/dist/sessions/file.js

@@ -0,0 +1,13 @@
+/**
+ * file session persistence writes one validated JSON document per session.
+ */
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { validatesession } from "../domain/sessions.js";
+export function filesessions(root) {
+    return {
+        async save(session) { const valid = validatesession(session); const path = join(root, `${valid.id}.json`); await mkdir(dirname(path), { recursive: true }); await writeFile(path, JSON.stringify(valid, null, 2)); return valid; },
+        async load(id) { const value = JSON.parse(await readFile(join(root, `${id}.json`), "utf8")); return validatesession(value); }
+    };
+}
+//# sourceMappingURL=file.js.map

package/dist/sessions/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../sessions/file.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,UAAU,YAAY,CAAC,IAAI;IAC/B,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC;QAClO,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KAC9H,CAAC;AACJ,CAAC"}

package/dist/sessions/replay.d.ts

@@ -0,0 +1,9 @@
+/**
+ * replay maps validated session events to an injected browser adapter.
+ */
+export declare function replay(session: any, adapter: any, options?: {}): Promise<{
+    events: any;
+    duration: number;
+    contextswitches: number;
+}>;
+//# sourceMappingURL=replay.d.ts.map

package/dist/sessions/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../sessions/replay.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,MAAM,CAAC,OAAO,KAAA,EAAE,OAAO,KAAA,EAAE,OAAO,KAAK;;;;GAuB1D"}

package/dist/sessions/replay.js

@@ -0,0 +1,70 @@
+/**
+ * replay maps validated session events to an injected browser adapter.
+ */
+export async function replay(session, adapter, options = {}) {
+    if (!session?.events || typeof adapter?.move !== "function")
+        throw new TypeError("replay requires session events and browser adapter");
+    const speed = options.speed ?? 1;
+    let previous = 0;
+    let currentcontext = normalizecontext(options.initialcontext);
+    let contextswitches = 0;
+    for (const event of session.events) {
+        const wait = Math.max(0, (event.t - previous) / speed);
+        if (wait)
+            await delay(wait);
+        previous = event.t;
+        const eventcontext = normalizecontext(event.context ?? event);
+        if (eventcontext && contextchanged(currentcontext, eventcontext)) {
+            await restorecontext(adapter, eventcontext, currentcontext);
+            currentcontext = eventcontext;
+            contextswitches += 1;
+        }
+        if (event.type === "move")
+            await adapter.move(event);
+        else if (event.type === "click")
+            await adapter.click(event);
+        else if (event.type === "drag")
+            await adapter.drag(event);
+        else if (event.type === "scroll")
+            await adapter.scroll(event);
+        else if (event.type === "key")
+            await adapter.key(event);
+    }
+    return { events: session.events.length, duration: previous / speed, contextswitches };
+}
+function normalizecontext(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value !== "object" || Array.isArray(value))
+        throw new TypeError("replay context must be an object");
+    const context = {};
+    for (const name of ["windowid", "tabid", "frameid"])
+        if (value[name] !== undefined) {
+            if (typeof value[name] !== "string" || !value[name])
+                throw new TypeError(`replay ${name} must be a non-empty string`);
+            context[name] = value[name];
+        }
+    return Object.keys(context).length ? context : undefined;
+}
+function contextchanged(previous, next) {
+    return ["windowid", "tabid", "frameid"].some((name) => previous?.[name] !== next[name]);
+}
+async function restorecontext(adapter, next, previous) {
+    if (typeof adapter.restorecontext === "function") {
+        await adapter.restorecontext({ ...next }, previous ? { ...previous } : undefined);
+        return;
+    }
+    const methods = [["windowid", "selectwindow"], ["tabid", "selecttab"], ["frameid", "selectframe"]];
+    for (const [name, method] of methods)
+        if (next[name] !== undefined && previous?.[name] !== next[name]) {
+            if (typeof adapter[method] !== "function") {
+                const error = new Error(`replay adapter cannot restore ${name}`);
+                error.code = "REPLAY_CONTEXT_UNSUPPORTED";
+                error.context = name;
+                throw error;
+            }
+            await adapter[method](next[name], { ...next });
+        }
+}
+function delay(milliseconds) { return new Promise((resolve) => setTimeout(resolve, milliseconds)); }
+//# sourceMappingURL=replay.js.map

package/dist/sessions/replay.js.map

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

package/dist/sessions/store.d.ts

@@ -0,0 +1,25 @@
+export declare function sessionstore(root: any): {
+    append(session: any): Promise<{
+        version: number;
+        id: any;
+        agentname: any;
+        originurl: any;
+        seed: any;
+        status: any;
+        startedat: any;
+        finishedat: any;
+        events: any;
+    }>;
+    read(id: any): Promise<{
+        version: number;
+        id: any;
+        agentname: any;
+        originurl: any;
+        seed: any;
+        status: any;
+        startedat: any;
+        finishedat: any;
+        events: any;
+    }[]>;
+};
+//# sourceMappingURL=store.d.ts.map

package/dist/sessions/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../sessions/store.ts"],"names":[],"mappings":"AAOA,wBAAgB,YAAY,CAAC,IAAI,KAAA;;;;;;;;;;;;;;;;;;;;;;;EAKhC"}

package/dist/sessions/store.js

@@ -0,0 +1,13 @@
+/**
+ * jsonl session storage keeps append only traces independent from browser adapters.
+ */
+import { appendFile, mkdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { validatesession } from "../domain/sessions.js";
+export function sessionstore(root) {
+    return {
+        async append(session) { const valid = validatesession(session); await mkdir(root, { recursive: true }); await appendFile(join(root, `${valid.id}.jsonl`), `${JSON.stringify(valid)}\n`); return valid; },
+        async read(id) { const text = await readFile(join(root, `${id}.jsonl`), "utf8"); return text.trim().split("\n").filter(Boolean).map((line) => validatesession(JSON.parse(line))); }
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/sessions/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../sessions/store.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,UAAU,YAAY,CAAC,IAAI;IAC/B,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,EAAE,QAAQ,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC;QACxM,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACpL,CAAC;AACJ,CAAC"}

package/dist/storage/adapter.d.ts

@@ -0,0 +1,5 @@
+/**
+ * storage adapters keep remote services out of the engine core.
+ */
+export declare function storageadapter(methods: any): any;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/storage/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../storage/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,KAAA,OAIrC"}

package/dist/storage/adapter.js

@@ -0,0 +1,11 @@
+/**
+ * storage adapters keep remote services out of the engine core.
+ */
+export function storageadapter(methods) {
+    const required = ["put", "get", "head", "delete", "list"];
+    for (const name of required)
+        if (typeof methods?.[name] !== "function")
+            throw new TypeError(`storage adapter requires ${name}`);
+    return methods;
+}
+//# sourceMappingURL=adapter.js.map

package/dist/storage/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../storage/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAO;IACpC,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1D,KAAK,MAAM,IAAI,IAAI,QAAQ;QAAE,IAAI,OAAO,OAAO,EAAE,CAAC,IAAI,CAAC,KAAK,UAAU;YAAE,MAAM,IAAI,SAAS,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;IAChI,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/storage/cache.d.ts

@@ -0,0 +1,23 @@
+/**
+ * tiered cache keeps a bounded hot tier and an optional persistent cold tier with stale-while-revalidate.
+ */
+/** Creates a cache with caller supplied encode, decode, clock and persistent storage policies. */
+export declare function tieredcache(options?: {}): {
+    get: (key: any, options?: {}) => Promise<any>;
+    set: (key: any, value: any, valueoptions?: {}) => Promise<any>;
+    getorload: (key: any, loader: any, options?: {}) => Promise<any>;
+    delete: (key: any) => Promise<void>;
+    clear: () => void;
+    inspect: () => {
+        hits: number;
+        misses: number;
+        stalehits: number;
+        evictions: number;
+        revalidations: number;
+        hotentries: number;
+        maxentries: number;
+        ttl: number;
+        stale: number;
+    };
+};
+//# sourceMappingURL=cache.d.ts.map

package/dist/storage/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../storage/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,OAAO,KAAK;;;;;;;;;;;;;;;;;EAgDvC"}

package/dist/storage/cache.js

@@ -0,0 +1,79 @@
+/**
+ * tiered cache keeps a bounded hot tier and an optional persistent cold tier with stale-while-revalidate.
+ */
+/** Creates a cache with caller supplied encode, decode, clock and persistent storage policies. */
+export function tieredcache(options = {}) {
+    const hot = new Map();
+    const maxentries = Number(options.maxentries ?? 256);
+    const ttl = Number(options.ttl ?? 300000);
+    const stale = Number(options.stale ?? ttl);
+    const now = options.now ?? (() => Date.now());
+    const cold = options.storage;
+    const encode = options.encode ?? ((value) => new TextEncoder().encode(JSON.stringify(value)));
+    const decode = options.decode ?? ((bytes) => JSON.parse(new TextDecoder().decode(bytes)));
+    const stats = { hits: 0, misses: 0, stalehits: 0, evictions: 0, revalidations: 0 };
+    function readhot(key) {
+        const item = hot.get(key);
+        if (!item)
+            return null;
+        const current = now();
+        if (current <= item.expires) {
+            stats.hits += 1;
+            return { value: item.value, fresh: true };
+        }
+        if (current <= item.stale) {
+            stats.stalehits += 1;
+            return { value: item.value, fresh: false };
+        }
+        hot.delete(key);
+        return null;
+    }
+    function writehot(key, value, options = {}) {
+        if (hot.size >= maxentries && !hot.has(key)) {
+            hot.delete(hot.keys().next().value);
+            stats.evictions += 1;
+        }
+        const current = now();
+        hot.set(key, { value, expires: current + Number(options.ttl ?? ttl), stale: current + Number(options.stale ?? stale) });
+        return value;
+    }
+    async function get(key, options = {}) {
+        const hotvalue = readhot(key);
+        if (hotvalue?.fresh || (hotvalue && options.allowstale !== false))
+            return hotvalue.value;
+        if (!cold) {
+            stats.misses += 1;
+            return null;
+        }
+        try {
+            const value = decode(await cold.get(key));
+            writehot(key, value, options);
+            return value;
+        }
+        catch {
+            stats.misses += 1;
+            return null;
+        }
+    }
+    async function set(key, value, valueoptions = {}) { writehot(key, value, valueoptions); if (cold)
+        await cold.put({ key, data: encode(value), contenttype: "application/json" }); return value; }
+    async function getorload(key, loader, options = {}) {
+        if (typeof loader !== "function")
+            throw new TypeError("cache loader must be a function");
+        const current = readhot(key);
+        if (current?.fresh)
+            return current.value;
+        if (current && options.allowstale !== false) {
+            stats.revalidations += 1;
+            Promise.resolve(loader()).then((value) => set(key, value, options)).catch(() => undefined);
+            return current.value;
+        }
+        const value = await loader();
+        return set(key, value, options);
+    }
+    async function remove(key) { hot.delete(key); await cold?.delete?.(key); }
+    function clear() { hot.clear(); }
+    function inspect() { return { ...stats, hotentries: hot.size, maxentries, ttl, stale }; }
+    return { get, set, getorload, delete: remove, clear, inspect };
+}
+//# sourceMappingURL=cache.js.map

package/dist/storage/cache.js.map

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

package/dist/storage/checksum.d.ts

@@ -0,0 +1,3 @@
+export { sha256 } from "../core/hash.js";
+export declare function collectbytes(input: any): Promise<Uint8Array<ArrayBufferLike>>;
+//# sourceMappingURL=checksum.d.ts.map

package/dist/storage/checksum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../../storage/checksum.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,wBAAsB,YAAY,CAAC,KAAK,KAAA,wCASvC"}

package/dist/storage/checksum.js

@@ -0,0 +1,19 @@
+export { sha256 } from "../core/hash.js";
+export async function collectbytes(input) {
+    if (input instanceof Uint8Array)
+        return input;
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of input) {
+        chunks.push(chunk);
+        size += chunk.byteLength;
+    }
+    const output = new Uint8Array(size);
+    let offset = 0;
+    for (const chunk of chunks) {
+        output.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return output;
+}
+//# sourceMappingURL=checksum.js.map

package/dist/storage/checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.js","sourceRoot":"","sources":["../../storage/checksum.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAK;IACtC,IAAI,KAAK,YAAY,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9C,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAAC,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC;IAAC,CAAC;IAClF,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAAC,CAAC;IACtF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/storage/chunked.d.ts

@@ -0,0 +1,21 @@
+export declare function chunkedstorage(storage: any, options?: {}): {
+    put(input: any): Promise<{
+        version: number;
+        key: any;
+        sizebytes: number;
+        chunks: any[];
+        chunkbytes: any;
+        sha256: string;
+        contenttype: any;
+        status: string;
+        completed: number;
+        updatedat: number;
+        metadata: any;
+    }>;
+    get(key: any): Promise<Uint8Array<any>>;
+    getrange(key: any, start: number, end: any): Promise<Uint8Array<ArrayBuffer>>;
+    head(key: any): Promise<any>;
+    delete(key: any): Promise<void>;
+    list(prefix: any): Promise<any>;
+};
+//# sourceMappingURL=chunked.d.ts.map

package/dist/storage/chunked.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunked.d.ts","sourceRoot":"","sources":["../../storage/chunked.ts"],"names":[],"mappings":"AAKA,wBAAgB,cAAc,CAAC,OAAO,KAAA,EAAE,OAAO,KAAK;;;;;;;;;;;;;;;;;;;EAoDnD"}