@statewalker/cellb 0.0.0-stage → 0.1.1

package/dist/bindings/assets.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Static assets as celld serves them (docs/services/static-assets.md), checked against
+ * celld 0.6.2 by conformance/projects/assets-api:
+ * GET/HEAD only; `run_worker_first`; `_redirects` first (301/302/303/307/308 → Location,
+ * 200 → rewrite, `*` → `:splat`); `html_handling` auto-trailing-slash with 307 to canonical
+ * paths; `not_found_handling` (with a Worker, only for navigation requests); strong
+ * SHA-256 ETag, If-None-Match → 304, Range → 206/416, `_headers` rules,
+ * `Cache-Control: public, max-age=0, must-revalidate` by default; unknown extension → no
+ * Content-Type.
+ */
+export interface AssetsConfig {
+    directory?: string;
+    binding?: string;
+    html_handling?: "auto-trailing-slash" | "force-trailing-slash" | "drop-trailing-slash" | "none";
+    not_found_handling?: "single-page-application" | "404-page" | "none";
+    run_worker_first?: boolean | string[];
+}
+/** File path ("/about.html") → bytes. */
+export type AssetFiles = Map<string, Uint8Array>;
+export declare function createAssets(files: AssetFiles, config: AssetsConfig, hasWorker: boolean): {
+    route: (req: Request, viaBinding?: boolean) => Response | undefined;
+    /** The `env.ASSETS` binding. */
+    binding: {
+        fetch: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+    };
+};

package/dist/bindings/assets.js

@@ -0,0 +1,260 @@
+import { sha256 } from "@noble/hashes/sha256";
+import { bytesToHex } from "@noble/hashes/utils";
+const TYPES = {
+    html: "text/html; charset=utf-8",
+    htm: "text/html; charset=utf-8",
+    css: "text/css; charset=utf-8",
+    js: "text/javascript; charset=utf-8",
+    mjs: "text/javascript; charset=utf-8",
+    json: "application/json; charset=utf-8",
+    txt: "text/plain; charset=utf-8",
+    xml: "application/xml; charset=utf-8",
+    svg: "image/svg+xml",
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    ico: "image/x-icon",
+    wasm: "application/wasm",
+    pdf: "application/pdf",
+    woff2: "font/woff2",
+    woff: "font/woff",
+};
+function globToRegExp(pattern) {
+    const names = [];
+    const src = pattern
+        .split(/(\*|:[A-Za-z_]\w*)/)
+        .map((part) => {
+        if (part === "*") {
+            names.push("splat");
+            return "(.*)";
+        }
+        if (part.startsWith(":")) {
+            names.push(part.slice(1));
+            return "([^/]+)";
+        }
+        return part.replace(/[.+?^${}()|[\]\\]/g, "\\$&");
+    })
+        .join("");
+    return { re: new RegExp(`^${src}$`), names };
+}
+function parseRedirects(text) {
+    const out = [];
+    for (const line of (text ?? "").split("\n")) {
+        const t = line.trim();
+        if (!t || t.startsWith("#"))
+            continue;
+        const [from, to, status] = t.split(/\s+/);
+        const { re, names } = globToRegExp(from);
+        out.push({ from: re, names, to, status: Number(status ?? 302) });
+    }
+    return out;
+}
+function parseHeaderRules(text) {
+    const rules = [];
+    for (const line of (text ?? "").split("\n")) {
+        if (!line.trim() || line.trim().startsWith("#"))
+            continue;
+        if (!/^\s/.test(line))
+            rules.push({ re: globToRegExp(line.trim()).re, headers: [] });
+        else {
+            const i = line.indexOf(":");
+            if (i > 0 && rules.length)
+                rules.at(-1).headers.push([line.slice(0, i).trim(), line.slice(i + 1).trim()]);
+        }
+    }
+    return rules;
+}
+const decoder = new TextDecoder();
+export function createAssets(files, config, hasWorker) {
+    const redirects = parseRedirects(files.has("/_redirects") ? decoder.decode(files.get("/_redirects")) : undefined);
+    const headerRules = parseHeaderRules(files.has("/_headers") ? decoder.decode(files.get("/_headers")) : undefined);
+    const etags = new Map();
+    const etagOf = (path) => {
+        let e = etags.get(path);
+        if (!e) {
+            e = `"${bytesToHex(sha256(files.get(path)))}"`;
+            etags.set(path, e);
+        }
+        return e;
+    };
+    const exists = (p) => files.has(p) && p !== "/_headers" && p !== "/_redirects";
+    const workerFirst = (path) => {
+        const r = config.run_worker_first;
+        if (r === true)
+            return true;
+        if (!Array.isArray(r))
+            return false;
+        let hit = false;
+        for (const p of r) {
+            const neg = p.startsWith("!");
+            if (globToRegExp(neg ? p.slice(1) : p).re.test(path))
+                hit = !neg;
+        }
+        return hit;
+    };
+    /** Resolves a URL path to a file, or a canonical redirect (auto-trailing-slash). */
+    const lookup = (path) => {
+        const mode = config.html_handling ?? "auto-trailing-slash";
+        if (mode === "none")
+            return exists(path) ? { file: path } : undefined;
+        if (mode === "force-trailing-slash" || mode === "drop-trailing-slash")
+            return lookupSlash(path, mode);
+        if (path.endsWith("/index.html")) {
+            if (exists(path))
+                return { redirect: path.slice(0, -"index.html".length) };
+        }
+        else if (path.endsWith(".html")) {
+            if (exists(path))
+                return { redirect: path.slice(0, -".html".length) };
+        }
+        if (path.endsWith("/")) {
+            // `/` and `/dir/` → index.html. (celld 0.6.2 serves only the root index here and
+            // falls through for nested ones — a celld bug; we follow Cloudflare, see docs/celld-compatibility.md.)
+            return exists(`${path}index.html`) ? { file: `${path}index.html` } : undefined;
+        }
+        if (exists(path))
+            return { file: path };
+        if (exists(`${path}.html`))
+            return { file: `${path}.html` };
+        if (exists(`${path}/index.html`))
+            return { redirect: `${path}/` };
+        return undefined;
+    };
+    /**
+     * force-trailing-slash: HTML pages live at `/x/` (x.html or x/index.html); `/x`, `/x.html`
+     * and `/x/index.html` redirect there. drop-trailing-slash: they live at `/x`; `/x/`,
+     * `/x.html` and `/x/index.html` redirect there. The root is `/` in both.
+     * (celld 0.6.2 answers 404 for any path ending in "/" other than the root, so in force
+     * mode it redirects to pages it then refuses — a celld bug; we follow Cloudflare.)
+     */
+    const lookupSlash = (path, mode) => {
+        if (path === "/")
+            return exists("/index.html") ? { file: "/index.html" } : undefined;
+        const page = (base) => exists(`${base}.html`)
+            ? `${base}.html`
+            : exists(`${base}/index.html`)
+                ? `${base}/index.html`
+                : undefined;
+        let base;
+        if (path.endsWith("/index.html"))
+            base = path.slice(0, -"/index.html".length);
+        else if (path.endsWith(".html"))
+            base = path.slice(0, -".html".length);
+        else if (path.endsWith("/"))
+            base = path.slice(0, -1);
+        if (base === "")
+            return exists(path) ? { redirect: "/" } : undefined;
+        const canonical = (b) => (mode === "force-trailing-slash" ? `${b}/` : b);
+        if (base !== undefined) {
+            const file = page(base);
+            if (!file)
+                return undefined;
+            return path === canonical(base) ? { file } : { redirect: canonical(base) };
+        }
+        if (exists(path))
+            return { file: path }; // non-HTML file
+        const file = page(path);
+        if (!file)
+            return undefined;
+        return mode === "drop-trailing-slash" ? { file } : { redirect: `${path}/` };
+    };
+    const serve = (req, file, status = 200) => {
+        const bytes = files.get(file);
+        const etag = etagOf(file);
+        const headers = new Headers();
+        const ext = file.split(".").pop()?.toLowerCase() ?? "";
+        for (const rule of headerRules)
+            if (rule.re.test(new URL(req.url).pathname))
+                for (const [k, v] of rule.headers)
+                    headers.set(k, v);
+        headers.set("etag", etag);
+        if (req.headers.get("if-none-match") === etag) {
+            headers.delete("cache-control");
+            return new Response(null, { status: 304, headers });
+        }
+        const range = /^bytes=(\d*)-(\d*)$/.exec(req.headers.get("range") ?? "");
+        if (range && status === 200) {
+            const size = bytes.byteLength;
+            let start = range[1] === "" ? size - Number(range[2]) : Number(range[1]);
+            let end = range[1] === "" ? size - 1 : range[2] === "" ? size - 1 : Number(range[2]);
+            if (start >= size || start < 0 || start > end) {
+                headers.set("content-range", `bytes */${size}`);
+                headers.set("content-length", "0");
+                headers.delete("cache-control");
+                return new Response(null, { status: 416, headers });
+            }
+            end = Math.min(end, size - 1);
+            start = Math.max(0, start);
+            if (TYPES[ext])
+                headers.set("content-type", TYPES[ext]);
+            headers.set("content-range", `bytes ${start}-${end}/${size}`);
+            headers.set("content-length", String(end - start + 1));
+            headers.delete("cache-control");
+            return new Response(req.method === "HEAD" ? null : bytes.slice(start, end + 1), { status: 206, headers });
+        }
+        if (TYPES[ext])
+            headers.set("content-type", TYPES[ext]);
+        if (!headers.has("cache-control"))
+            headers.set("cache-control", "public, max-age=0, must-revalidate");
+        headers.set("content-length", String(bytes.byteLength));
+        return new Response(req.method === "HEAD" ? null : bytes, { status, headers });
+    };
+    const redirectTo = (location, status) => new Response(null, { status, headers: { location, "content-length": "0" } });
+    /** The asset router. `undefined` = not an asset: hand the request to the Worker. */
+    const route = (req, viaBinding = false) => {
+        if (req.method !== "GET" && req.method !== "HEAD")
+            return undefined;
+        const url = new URL(req.url);
+        let path = decodeURIComponent(url.pathname);
+        if (!viaBinding && hasWorker && workerFirst(path))
+            return undefined;
+        for (const r of redirects) {
+            const m = r.from.exec(path);
+            if (!m)
+                continue;
+            let to = r.to;
+            for (const [i, n] of r.names.entries())
+                to = to.replace(`:${n}`, m[i + 1]);
+            if (r.status === 200) {
+                path = to;
+                break;
+            }
+            return redirectTo(to, r.status);
+        }
+        const hit = lookup(path);
+        if (hit && "redirect" in hit)
+            return redirectTo(`${hit.redirect}${url.search}`, 307);
+        if (hit)
+            return serve(req, hit.file);
+        // Miss: not_found_handling (with a Worker, only for navigation requests).
+        const nav = req.headers.get("sec-fetch-mode") === "navigate";
+        if (!hasWorker || nav || viaBinding) {
+            if (config.not_found_handling === "single-page-application" && exists("/index.html"))
+                return serve(req, "/index.html");
+            if (config.not_found_handling === "404-page") {
+                for (let dir = path.slice(0, path.lastIndexOf("/") + 1); dir; dir = dir.slice(0, dir.lastIndexOf("/", dir.length - 2) + 1)) {
+                    if (exists(`${dir}404.html`))
+                        return serve(req, `${dir}404.html`, 404);
+                    if (dir === "/")
+                        break;
+                }
+            }
+        }
+        if (hasWorker && !viaBinding)
+            return undefined;
+        return new Response("Not found", {
+            status: 404,
+            headers: { "content-type": "application/json" },
+        });
+    };
+    return {
+        route,
+        /** The `env.ASSETS` binding. */
+        binding: {
+            fetch: async (input, init) => route(new Request(input, init), true),
+        },
+    };
+}
+//# sourceMappingURL=assets.js.map

package/dist/bindings/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/bindings/assets.ts"],"names":[],"mappings":"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","sourcesContent":["import { sha256 } from \"@noble/hashes/sha256\";\nimport { bytesToHex } from \"@noble/hashes/utils\";\n\n/**\n * Static assets as celld serves them (docs/services/static-assets.md), checked against\n * celld 0.6.2 by conformance/projects/assets-api:\n * GET/HEAD only; `run_worker_first`; `_redirects` first (301/302/303/307/308 → Location,\n * 200 → rewrite, `*` → `:splat`); `html_handling` auto-trailing-slash with 307 to canonical\n * paths; `not_found_handling` (with a Worker, only for navigation requests); strong\n * SHA-256 ETag, If-None-Match → 304, Range → 206/416, `_headers` rules,\n * `Cache-Control: public, max-age=0, must-revalidate` by default; unknown extension → no\n * Content-Type.\n */\nexport interface AssetsConfig {\n  directory?: string;\n  binding?: string;\n  html_handling?: \"auto-trailing-slash\" | \"force-trailing-slash\" | \"drop-trailing-slash\" | \"none\";\n  not_found_handling?: \"single-page-application\" | \"404-page\" | \"none\";\n  run_worker_first?: boolean | string[];\n}\n\n/** File path (\"/about.html\") → bytes. */\nexport type AssetFiles = Map<string, Uint8Array>;\n\nconst TYPES: Record<string, string> = {\n  html: \"text/html; charset=utf-8\",\n  htm: \"text/html; charset=utf-8\",\n  css: \"text/css; charset=utf-8\",\n  js: \"text/javascript; charset=utf-8\",\n  mjs: \"text/javascript; charset=utf-8\",\n  json: \"application/json; charset=utf-8\",\n  txt: \"text/plain; charset=utf-8\",\n  xml: \"application/xml; charset=utf-8\",\n  svg: \"image/svg+xml\",\n  png: \"image/png\",\n  jpg: \"image/jpeg\",\n  jpeg: \"image/jpeg\",\n  gif: \"image/gif\",\n  webp: \"image/webp\",\n  ico: \"image/x-icon\",\n  wasm: \"application/wasm\",\n  pdf: \"application/pdf\",\n  woff2: \"font/woff2\",\n  woff: \"font/woff\",\n};\n\ninterface Redirect {\n  from: RegExp;\n  names: string[];\n  to: string;\n  status: number;\n}\n\nfunction globToRegExp(pattern: string): { re: RegExp; names: string[] } {\n  const names: string[] = [];\n  const src = pattern\n    .split(/(\\*|:[A-Za-z_]\\w*)/)\n    .map((part) => {\n      if (part === \"*\") {\n        names.push(\"splat\");\n        return \"(.*)\";\n      }\n      if (part.startsWith(\":\")) {\n        names.push(part.slice(1));\n        return \"([^/]+)\";\n      }\n      return part.replace(/[.+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n    })\n    .join(\"\");\n  return { re: new RegExp(`^${src}$`), names };\n}\n\nfunction parseRedirects(text: string | undefined): Redirect[] {\n  const out: Redirect[] = [];\n  for (const line of (text ?? \"\").split(\"\\n\")) {\n    const t = line.trim();\n    if (!t || t.startsWith(\"#\")) continue;\n    const [from, to, status] = t.split(/\\s+/);\n    const { re, names } = globToRegExp(from);\n    out.push({ from: re, names, to, status: Number(status ?? 302) });\n  }\n  return out;\n}\n\nfunction parseHeaderRules(text: string | undefined): { re: RegExp; headers: [string, string][] }[] {\n  const rules: { re: RegExp; headers: [string, string][] }[] = [];\n  for (const line of (text ?? \"\").split(\"\\n\")) {\n    if (!line.trim() || line.trim().startsWith(\"#\")) continue;\n    if (!/^\\s/.test(line)) rules.push({ re: globToRegExp(line.trim()).re, headers: [] });\n    else {\n      const i = line.indexOf(\":\");\n      if (i > 0 && rules.length)\n        rules.at(-1)!.headers.push([line.slice(0, i).trim(), line.slice(i + 1).trim()]);\n    }\n  }\n  return rules;\n}\n\nconst decoder = new TextDecoder();\n\nexport function createAssets(files: AssetFiles, config: AssetsConfig, hasWorker: boolean) {\n  const redirects = parseRedirects(\n    files.has(\"/_redirects\") ? decoder.decode(files.get(\"/_redirects\")) : undefined,\n  );\n  const headerRules = parseHeaderRules(\n    files.has(\"/_headers\") ? decoder.decode(files.get(\"/_headers\")) : undefined,\n  );\n  const etags = new Map<string, string>();\n  const etagOf = (path: string) => {\n    let e = etags.get(path);\n    if (!e) {\n      e = `\"${bytesToHex(sha256(files.get(path)!))}\"`;\n      etags.set(path, e);\n    }\n    return e;\n  };\n  const exists = (p: string) => files.has(p) && p !== \"/_headers\" && p !== \"/_redirects\";\n\n  const workerFirst = (path: string) => {\n    const r = config.run_worker_first;\n    if (r === true) return true;\n    if (!Array.isArray(r)) return false;\n    let hit = false;\n    for (const p of r) {\n      const neg = p.startsWith(\"!\");\n      if (globToRegExp(neg ? p.slice(1) : p).re.test(path)) hit = !neg;\n    }\n    return hit;\n  };\n\n  /** Resolves a URL path to a file, or a canonical redirect (auto-trailing-slash). */\n  const lookup = (path: string): { file: string } | { redirect: string } | undefined => {\n    const mode = config.html_handling ?? \"auto-trailing-slash\";\n    if (mode === \"none\") return exists(path) ? { file: path } : undefined;\n    if (mode === \"force-trailing-slash\" || mode === \"drop-trailing-slash\")\n      return lookupSlash(path, mode);\n    if (path.endsWith(\"/index.html\")) {\n      if (exists(path)) return { redirect: path.slice(0, -\"index.html\".length) };\n    } else if (path.endsWith(\".html\")) {\n      if (exists(path)) return { redirect: path.slice(0, -\".html\".length) };\n    }\n    if (path.endsWith(\"/\")) {\n      // `/` and `/dir/` → index.html. (celld 0.6.2 serves only the root index here and\n      // falls through for nested ones — a celld bug; we follow Cloudflare, see docs/celld-compatibility.md.)\n      return exists(`${path}index.html`) ? { file: `${path}index.html` } : undefined;\n    }\n    if (exists(path)) return { file: path };\n    if (exists(`${path}.html`)) return { file: `${path}.html` };\n    if (exists(`${path}/index.html`)) return { redirect: `${path}/` };\n    return undefined;\n  };\n\n  /**\n   * force-trailing-slash: HTML pages live at `/x/` (x.html or x/index.html); `/x`, `/x.html`\n   * and `/x/index.html` redirect there. drop-trailing-slash: they live at `/x`; `/x/`,\n   * `/x.html` and `/x/index.html` redirect there. The root is `/` in both.\n   * (celld 0.6.2 answers 404 for any path ending in \"/\" other than the root, so in force\n   * mode it redirects to pages it then refuses — a celld bug; we follow Cloudflare.)\n   */\n  const lookupSlash = (path: string, mode: \"force-trailing-slash\" | \"drop-trailing-slash\") => {\n    if (path === \"/\") return exists(\"/index.html\") ? { file: \"/index.html\" } : undefined;\n    const page = (base: string) =>\n      exists(`${base}.html`)\n        ? `${base}.html`\n        : exists(`${base}/index.html`)\n          ? `${base}/index.html`\n          : undefined;\n    let base: string | undefined;\n    if (path.endsWith(\"/index.html\")) base = path.slice(0, -\"/index.html\".length);\n    else if (path.endsWith(\".html\")) base = path.slice(0, -\".html\".length);\n    else if (path.endsWith(\"/\")) base = path.slice(0, -1);\n    if (base === \"\") return exists(path) ? { redirect: \"/\" } : undefined;\n    const canonical = (b: string) => (mode === \"force-trailing-slash\" ? `${b}/` : b);\n    if (base !== undefined) {\n      const file = page(base);\n      if (!file) return undefined;\n      return path === canonical(base) ? { file } : { redirect: canonical(base) };\n    }\n    if (exists(path)) return { file: path }; // non-HTML file\n    const file = page(path);\n    if (!file) return undefined;\n    return mode === \"drop-trailing-slash\" ? { file } : { redirect: `${path}/` };\n  };\n\n  const serve = (req: Request, file: string, status = 200): Response => {\n    const bytes = files.get(file)!;\n    const etag = etagOf(file);\n    const headers = new Headers();\n    const ext = file.split(\".\").pop()?.toLowerCase() ?? \"\";\n    for (const rule of headerRules)\n      if (rule.re.test(new URL(req.url).pathname))\n        for (const [k, v] of rule.headers) headers.set(k, v);\n    headers.set(\"etag\", etag);\n    if (req.headers.get(\"if-none-match\") === etag) {\n      headers.delete(\"cache-control\");\n      return new Response(null, { status: 304, headers });\n    }\n    const range = /^bytes=(\\d*)-(\\d*)$/.exec(req.headers.get(\"range\") ?? \"\");\n    if (range && status === 200) {\n      const size = bytes.byteLength;\n      let start = range[1] === \"\" ? size - Number(range[2]) : Number(range[1]);\n      let end = range[1] === \"\" ? size - 1 : range[2] === \"\" ? size - 1 : Number(range[2]);\n      if (start >= size || start < 0 || start > end) {\n        headers.set(\"content-range\", `bytes */${size}`);\n        headers.set(\"content-length\", \"0\");\n        headers.delete(\"cache-control\");\n        return new Response(null, { status: 416, headers });\n      }\n      end = Math.min(end, size - 1);\n      start = Math.max(0, start);\n      if (TYPES[ext]) headers.set(\"content-type\", TYPES[ext]);\n      headers.set(\"content-range\", `bytes ${start}-${end}/${size}`);\n      headers.set(\"content-length\", String(end - start + 1));\n      headers.delete(\"cache-control\");\n      return new Response(\n        req.method === \"HEAD\" ? null : (bytes.slice(start, end + 1) as BodyInit),\n        { status: 206, headers },\n      );\n    }\n    if (TYPES[ext]) headers.set(\"content-type\", TYPES[ext]);\n    if (!headers.has(\"cache-control\"))\n      headers.set(\"cache-control\", \"public, max-age=0, must-revalidate\");\n    headers.set(\"content-length\", String(bytes.byteLength));\n    return new Response(req.method === \"HEAD\" ? null : (bytes as BodyInit), { status, headers });\n  };\n\n  const redirectTo = (location: string, status: number) =>\n    new Response(null, { status, headers: { location, \"content-length\": \"0\" } });\n\n  /** The asset router. `undefined` = not an asset: hand the request to the Worker. */\n  const route = (req: Request, viaBinding = false): Response | undefined => {\n    if (req.method !== \"GET\" && req.method !== \"HEAD\") return undefined;\n    const url = new URL(req.url);\n    let path = decodeURIComponent(url.pathname);\n    if (!viaBinding && hasWorker && workerFirst(path)) return undefined;\n    for (const r of redirects) {\n      const m = r.from.exec(path);\n      if (!m) continue;\n      let to = r.to;\n      for (const [i, n] of r.names.entries()) to = to.replace(`:${n}`, m[i + 1]);\n      if (r.status === 200) {\n        path = to;\n        break;\n      }\n      return redirectTo(to, r.status);\n    }\n    const hit = lookup(path);\n    if (hit && \"redirect\" in hit) return redirectTo(`${hit.redirect}${url.search}`, 307);\n    if (hit) return serve(req, hit.file);\n    // Miss: not_found_handling (with a Worker, only for navigation requests).\n    const nav = req.headers.get(\"sec-fetch-mode\") === \"navigate\";\n    if (!hasWorker || nav || viaBinding) {\n      if (config.not_found_handling === \"single-page-application\" && exists(\"/index.html\"))\n        return serve(req, \"/index.html\");\n      if (config.not_found_handling === \"404-page\") {\n        for (\n          let dir = path.slice(0, path.lastIndexOf(\"/\") + 1);\n          dir;\n          dir = dir.slice(0, dir.lastIndexOf(\"/\", dir.length - 2) + 1)\n        ) {\n          if (exists(`${dir}404.html`)) return serve(req, `${dir}404.html`, 404);\n          if (dir === \"/\") break;\n        }\n      }\n    }\n    if (hasWorker && !viaBinding) return undefined;\n    return new Response(\"Not found\", {\n      status: 404,\n      headers: { \"content-type\": \"application/json\" },\n    });\n  };\n\n  return {\n    route,\n    /** The `env.ASSETS` binding. */\n    binding: {\n      fetch: async (input: RequestInfo | URL, init?: RequestInit) =>\n        route(new Request(input, init), true)!,\n    },\n  };\n}\n"]}

package/dist/bindings/cache.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The Workers Cache API as celld provides it (cloudflare-compat.md#cache): an always-miss
+ * cache, because there is no shared edge cache. `put()` validates and consumes the response
+ * but stores nothing, `match()` resolves to `undefined`, `delete()` to `false`.
+ * Substituted for the `caches` global of user code (browsers have a real CacheStorage).
+ */
+export declare class CellsCache {
+    put(request: RequestInfo | URL, response: Response): Promise<void>;
+    match(_request: RequestInfo | URL, _options?: unknown): Promise<Response | undefined>;
+    delete(_request: RequestInfo | URL, _options?: unknown): Promise<boolean>;
+}
+export declare class CellsCacheStorage {
+    readonly default: CellsCache;
+    open(_name: string): Promise<CellsCache>;
+}
+export declare const cellsCaches: CellsCacheStorage;

package/dist/bindings/cache.js

@@ -0,0 +1,34 @@
+/**
+ * The Workers Cache API as celld provides it (cloudflare-compat.md#cache): an always-miss
+ * cache, because there is no shared edge cache. `put()` validates and consumes the response
+ * but stores nothing, `match()` resolves to `undefined`, `delete()` to `false`.
+ * Substituted for the `caches` global of user code (browsers have a real CacheStorage).
+ */
+export class CellsCache {
+    async put(request, response) {
+        const req = request instanceof Request ? request : new Request(request);
+        if (req.method !== "GET")
+            throw new TypeError("Cache.put() only accepts GET requests");
+        if (!(response instanceof Response))
+            throw new TypeError("Cache.put() requires a Response");
+        if (response.status === 206)
+            throw new TypeError("Cache.put() cannot store a partial response");
+        if (response.headers.get("vary") === "*")
+            throw new TypeError("Cache.put() cannot store Vary: *");
+        await response.body?.cancel();
+    }
+    async match(_request, _options) {
+        return undefined;
+    }
+    async delete(_request, _options) {
+        return false;
+    }
+}
+export class CellsCacheStorage {
+    default = new CellsCache();
+    async open(_name) {
+        return new CellsCache();
+    }
+}
+export const cellsCaches = new CellsCacheStorage();
+//# sourceMappingURL=cache.js.map

package/dist/bindings/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/bindings/cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,OAAO,UAAU;IACrB,KAAK,CAAC,GAAG,CAAC,OAA0B,EAAE,QAAkB;QACtD,MAAM,GAAG,GAAG,OAAO,YAAY,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;QACxE,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK;YAAE,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;QACvF,IAAI,CAAC,CAAC,QAAQ,YAAY,QAAQ,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;QAC5F,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;YAAE,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;QAChG,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG;YACtC,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;QAC1D,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAChC,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,QAA2B,EAAE,QAAkB;QACzD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,QAA2B,EAAE,QAAkB;QAC1D,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,MAAM,OAAO,iBAAiB;IACnB,OAAO,GAAG,IAAI,UAAU,EAAE,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,KAAa;QACtB,OAAO,IAAI,UAAU,EAAE,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,iBAAiB,EAAE,CAAC","sourcesContent":["/**\n * The Workers Cache API as celld provides it (cloudflare-compat.md#cache): an always-miss\n * cache, because there is no shared edge cache. `put()` validates and consumes the response\n * but stores nothing, `match()` resolves to `undefined`, `delete()` to `false`.\n * Substituted for the `caches` global of user code (browsers have a real CacheStorage).\n */\nexport class CellsCache {\n  async put(request: RequestInfo | URL, response: Response): Promise<void> {\n    const req = request instanceof Request ? request : new Request(request);\n    if (req.method !== \"GET\") throw new TypeError(\"Cache.put() only accepts GET requests\");\n    if (!(response instanceof Response)) throw new TypeError(\"Cache.put() requires a Response\");\n    if (response.status === 206) throw new TypeError(\"Cache.put() cannot store a partial response\");\n    if (response.headers.get(\"vary\") === \"*\")\n      throw new TypeError(\"Cache.put() cannot store Vary: *\");\n    await response.body?.cancel();\n  }\n  async match(_request: RequestInfo | URL, _options?: unknown): Promise<Response | undefined> {\n    return undefined;\n  }\n  async delete(_request: RequestInfo | URL, _options?: unknown): Promise<boolean> {\n    return false;\n  }\n}\n\nexport class CellsCacheStorage {\n  readonly default = new CellsCache();\n  async open(_name: string): Promise<CellsCache> {\n    return new CellsCache();\n  }\n}\n\nexport const cellsCaches = new CellsCacheStorage();\n"]}

package/dist/bindings/celld-kv.d.ts

@@ -0,0 +1,26 @@
+import type { FilesApi } from "@statewalker/webrun-files";
+/**
+ * KV exactly as celld implements it: celld's own `services/kv.js` (namespace cell + binding
+ * client, Apache-2.0) on a cellb host. The limits are celld_logic::kv's constants;
+ * values above 1 MiB go to a FilesApi (celld: the fleet bucket) through the same
+ * prepare / put / get / sweep protocol.
+ */
+export declare const CELLD_KV_LIMITS: {
+    maxKeyBytes: number;
+    maxValueBytes: number;
+    maxInlineValueBytes: number;
+    maxMetadataBytes: number;
+    minExpirationTtlMs: number;
+    maxBulkKeys: number;
+    maxListLimit: number;
+    sweepBatchRows: number;
+    blobSweepMs: number;
+    sweepDisabled: boolean;
+    legacySchema: boolean;
+    failAfterBlobWrite: boolean;
+    raceSweepPut: boolean;
+};
+export declare function celldKv(files: FilesApi, root?: string): {
+    KvNamespaceCell: unknown;
+    KvNamespace: new (ns: () => unknown, cellName: string) => unknown;
+};

package/dist/bindings/celld-kv.js

@@ -0,0 +1,81 @@
+// @ts-expect-error — vendored JS (scripts/vendor-celld.mjs)
+import { kvService } from "../../vendor/celld/kv.js";
+import { DurableObject } from "../core/durable-object.js";
+/**
+ * KV exactly as celld implements it: celld's own `services/kv.js` (namespace cell + binding
+ * client, Apache-2.0) on a cellb host. The limits are celld_logic::kv's constants;
+ * values above 1 MiB go to a FilesApi (celld: the fleet bucket) through the same
+ * prepare / put / get / sweep protocol.
+ */
+export const CELLD_KV_LIMITS = {
+    maxKeyBytes: 512,
+    maxValueBytes: 25 * 1024 * 1024,
+    maxInlineValueBytes: 1024 * 1024,
+    maxMetadataBytes: 1024,
+    minExpirationTtlMs: 60_000,
+    maxBulkKeys: 100,
+    maxListLimit: 1000,
+    sweepBatchRows: 256,
+    blobSweepMs: 60_000,
+    sweepDisabled: false,
+    legacySchema: false,
+    failAfterBlobWrite: false,
+    raceSweepPut: false,
+};
+const b64 = (bytes) => {
+    let s = "";
+    for (let i = 0; i < bytes.length; i += 0x8000)
+        s += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
+    return btoa(s);
+};
+const unb64 = (text) => Uint8Array.from(atob(text), (c) => c.charCodeAt(0));
+async function readAll(files, path) {
+    if (!(await files.exists(path)))
+        return undefined;
+    const chunks = [];
+    for await (const c of files.read(path))
+        chunks.push(c);
+    const out = new Uint8Array(chunks.reduce((n, c) => n + c.byteLength, 0));
+    let o = 0;
+    for (const c of chunks) {
+        out.set(c, o);
+        o += c.byteLength;
+    }
+    return out;
+}
+export function celldKv(files, root = "/kv-blobs") {
+    const dirOf = (cell) => `${root}/${cell.ctx.id.toString()}`;
+    return kvService({
+        DurableObject,
+        limits: () => CELLD_KV_LIMITS,
+        blob: async (cell, request, value) => {
+            const dir = dirOf(cell);
+            switch (request.mode) {
+                case "prepare":
+                    return { reference: `${request.digest}-${crypto.randomUUID().replace(/-/g, "")}` };
+                case "put":
+                    await files.write(`${dir}/${request.reference}`, [value]);
+                    return { ok: true };
+                case "get": {
+                    const bytes = await readAll(files, `${dir}/${request.reference}`);
+                    return bytes ? { found: true, value: bytes } : { found: false };
+                }
+                case "sweep": {
+                    const live = new Set(request.live ?? []);
+                    if (await files.exists(dir))
+                        for await (const f of files.list(dir)) {
+                            const name = f.path.split("/").pop() ?? "";
+                            if (f.kind === "file" && !live.has(name))
+                                await files.remove(f.path);
+                        }
+                    return { ok: true };
+                }
+                default:
+                    throw new Error(`unknown KV blob mode ${request.mode}`);
+            }
+        },
+        btoa: (bytes) => b64(bytes),
+        atob: (text) => unb64(text),
+    });
+}
+//# sourceMappingURL=celld-kv.js.map

package/dist/bindings/celld-kv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"celld-kv.js","sourceRoot":"","sources":["../../src/bindings/celld-kv.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FilesApi } from \"@statewalker/webrun-files\";\n// @ts-expect-error — vendored JS (scripts/vendor-celld.mjs)\nimport { kvService } from \"../../vendor/celld/kv.js\";\nimport { DurableObject } from \"../core/durable-object.js\";\n\n/**\n * KV exactly as celld implements it: celld's own `services/kv.js` (namespace cell + binding\n * client, Apache-2.0) on a cellb host. The limits are celld_logic::kv's constants;\n * values above 1 MiB go to a FilesApi (celld: the fleet bucket) through the same\n * prepare / put / get / sweep protocol.\n */\nexport const CELLD_KV_LIMITS = {\n  maxKeyBytes: 512,\n  maxValueBytes: 25 * 1024 * 1024,\n  maxInlineValueBytes: 1024 * 1024,\n  maxMetadataBytes: 1024,\n  minExpirationTtlMs: 60_000,\n  maxBulkKeys: 100,\n  maxListLimit: 1000,\n  sweepBatchRows: 256,\n  blobSweepMs: 60_000,\n  sweepDisabled: false,\n  legacySchema: false,\n  failAfterBlobWrite: false,\n  raceSweepPut: false,\n};\n\nconst b64 = (bytes: Uint8Array) => {\n  let s = \"\";\n  for (let i = 0; i < bytes.length; i += 0x8000)\n    s += String.fromCharCode(...bytes.subarray(i, i + 0x8000));\n  return btoa(s);\n};\nconst unb64 = (text: string) => Uint8Array.from(atob(text), (c) => c.charCodeAt(0));\n\nasync function readAll(files: FilesApi, path: string): Promise<Uint8Array | undefined> {\n  if (!(await files.exists(path))) return undefined;\n  const chunks: Uint8Array[] = [];\n  for await (const c of files.read(path)) chunks.push(c);\n  const out = new Uint8Array(chunks.reduce((n, c) => n + c.byteLength, 0));\n  let o = 0;\n  for (const c of chunks) {\n    out.set(c, o);\n    o += c.byteLength;\n  }\n  return out;\n}\n\nexport function celldKv(files: FilesApi, root = \"/kv-blobs\") {\n  const dirOf = (cell: { ctx: { id: { toString(): string } } }) =>\n    `${root}/${cell.ctx.id.toString()}`;\n  return kvService({\n    DurableObject,\n    limits: () => CELLD_KV_LIMITS,\n    blob: async (cell: any, request: any, value?: Uint8Array) => {\n      const dir = dirOf(cell);\n      switch (request.mode) {\n        case \"prepare\":\n          return { reference: `${request.digest}-${crypto.randomUUID().replace(/-/g, \"\")}` };\n        case \"put\":\n          await files.write(`${dir}/${request.reference}`, [value as Uint8Array]);\n          return { ok: true };\n        case \"get\": {\n          const bytes = await readAll(files, `${dir}/${request.reference}`);\n          return bytes ? { found: true, value: bytes } : { found: false };\n        }\n        case \"sweep\": {\n          const live = new Set<string>(request.live ?? []);\n          if (await files.exists(dir))\n            for await (const f of files.list(dir)) {\n              const name = f.path.split(\"/\").pop() ?? \"\";\n              if (f.kind === \"file\" && !live.has(name)) await files.remove(f.path);\n            }\n          return { ok: true };\n        }\n        default:\n          throw new Error(`unknown KV blob mode ${request.mode}`);\n      }\n    },\n    btoa: (bytes: Uint8Array) => b64(bytes),\n    atob: (text: string) => unb64(text),\n  }) as {\n    KvNamespaceCell: unknown;\n    KvNamespace: new (ns: () => unknown, cellName: string) => unknown;\n  };\n}\n"]}

package/dist/bindings/celld-queues.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Queues exactly as celld implements them: celld's own queue cell, producer binding and
+ * consumer batch (harness.js, vendored unchanged, Apache-2.0) on a cellb host. The
+ * queue cell's SQLite layout (`__queue_messages`, `__queue_stats`, …) is therefore celld's, so
+ * a queue's pending messages move between celld and cellb with its cell.
+ *
+ * What the host supplies, as celld's engine does:
+ * - `__queue_policy`: celld_logic::queue (Rust) ported below — every deadline and lease rule;
+ * - `__queue_dispatch`: runs the consumer's `queue()` with celld's batch object, then posts the
+ *   settlement to the queue cell (`/__qSettle`), after the alarm that leased the batch;
+ * - limits, consumer configuration, lease duration (celld's defaults).
+ */
+/** celld_logic::queue and queue_batching defaults (celld 0.6.2). */
+export declare const CELLD_QUEUE_LIMITS: {
+    maxMessageBytes: number;
+    maxBatchBytes: number;
+    maxBatchMessages: number;
+    producerGroupMs: number;
+    maxConcurrency: number;
+    maxDelaySeconds: number;
+    retentionMs: number;
+    sweepBatchRows: number;
+};
+export interface QueueConsumerConfig {
+    queue: string;
+    max_batch_size?: number;
+    max_batch_timeout?: number;
+    max_retries?: number;
+    dead_letter_queue?: string;
+    max_concurrency?: number;
+    retry_delay?: number;
+}
+type J = Record<string, any>;
+export declare function queuePolicy(request: J): unknown;
+export declare function celldQueues(opts: {
+    /** The namespace of the `__Queue` cells (celld's fleet-wide namespace). */
+    namespace: () => {
+        getByName(name: string): {
+            fetch(req: Request): Promise<Response>;
+        };
+    };
+    consumers: QueueConsumerConfig[];
+    /** Runs the Worker's `queue(batch)` handler (celld: the consumer script's entrypoint). */
+    runConsumer: (batch: unknown) => Promise<void>;
+    /** Wrangler `compatibility_date` decides the default content type (json from 2024-03-18). */
+    compatibilityDate?: string;
+    /** Background work after the leasing alarm (the consumer runs outside the cell's event). */
+    defer?: (work: Promise<unknown>) => void;
+}): {
+    QueueCell: {
+        new (ctx: any, env: any): {};
+    };
+    /** The producer binding (celld: `__makeQueue(queue, cellName, deliveryDelay)`). */
+    producer: (queue: string, deliveryDelay?: number) => unknown;
+};
+export {};