@statewalker/cellb 0.0.0-stage → 0.1.0

package/dist/bucket/s3-object-store.js

@@ -0,0 +1,151 @@
+import { bytesToHex } from "@noble/hashes/utils";
+import { PreconditionFailedError } from "./object-store.js";
+const enc = new TextEncoder();
+const sha256 = async (data) => bytesToHex(new Uint8Array(await crypto.subtle.digest("SHA-256", typeof data === "string" ? enc.encode(data) : data)));
+const hmac = async (key, data) => {
+    const k = await crypto.subtle.importKey("raw", key, { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+    return new Uint8Array(await crypto.subtle.sign("HMAC", k, enc.encode(data)));
+};
+const uriEncode = (s, slash = true) => encodeURIComponent(s)
+    .replace(/[!'()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`)
+    .replace(slash ? /%2F/g : /$^/, "/");
+export async function signV4(method, url, headers, body, o, now = new Date()) {
+    const region = o.region ?? "auto";
+    const amzDate = now.toISOString().replace(/[:-]|\.\d{3}/g, "");
+    const day = amzDate.slice(0, 8);
+    const payloadHash = await sha256(body ?? new Uint8Array());
+    const h = {
+        ...Object.fromEntries(Object.entries(headers).map(([k, v]) => [k.toLowerCase(), v])),
+        host: url.host,
+        "x-amz-date": amzDate,
+        "x-amz-content-sha256": payloadHash,
+    };
+    if (o.sessionToken)
+        h["x-amz-security-token"] = o.sessionToken;
+    const names = Object.keys(h).sort();
+    const query = [...url.searchParams]
+        .map(([k, v]) => [uriEncode(k, false), uriEncode(v, false)])
+        .sort(([a, b], [c, d]) => (a === c ? (b < d ? -1 : 1) : a < c ? -1 : 1))
+        .map(([k, v]) => `${k}=${v}`)
+        .join("&");
+    const canonical = [
+        method,
+        uriEncode(decodeURIComponent(url.pathname)),
+        query,
+        ...names.map((n) => `${n}:${h[n].trim()}`),
+        "",
+        names.join(";"),
+        payloadHash,
+    ].join("\n");
+    const scope = `${day}/${region}/s3/aws4_request`;
+    const toSign = ["AWS4-HMAC-SHA256", amzDate, scope, await sha256(canonical)].join("\n");
+    let key = await hmac(enc.encode(`AWS4${o.secretAccessKey}`), day);
+    for (const part of [region, "s3", "aws4_request"])
+        key = await hmac(key, part);
+    const signature = bytesToHex(await hmac(key, toSign));
+    h.authorization = `AWS4-HMAC-SHA256 Credential=${o.accessKeyId}/${scope}, SignedHeaders=${names.join(";")}, Signature=${signature}`;
+    delete h.host; // set by fetch
+    return h;
+}
+export function s3ObjectStore(o) {
+    const f = o.fetch ?? fetch;
+    const base = `${o.endpoint.replace(/\/$/, "")}/${o.bucket}`;
+    const signBase = `${(o.signAs ?? o.endpoint).replace(/\/$/, "")}/${o.bucket}`;
+    const signed = (url) => (o.signAs ? new URL(signBase + url.href.slice(base.length)) : url);
+    // celld's `s3://BUCKET/PREFIX` puts keys under "PREFIX/": a prefix is a directory.
+    const root = o.prefix ? (o.prefix.endsWith("/") ? o.prefix : `${o.prefix}/`) : "";
+    const full = (key) => `${root}${key}`;
+    const call = async (method, url, headers = {}, body) => f(url, {
+        method,
+        headers: await signV4(method, signed(url), headers, body, o),
+        body: body,
+    });
+    return {
+        async get(key) {
+            const r = await call("GET", new URL(`${base}/${uriEncode(full(key))}`));
+            if (r.status === 404)
+                return undefined;
+            if (!r.ok)
+                throw new Error(`S3 GET ${key}: ${r.status} ${await r.text()}`);
+            const attrs = {};
+            for (const [field, header] of S3_HEADERS) {
+                const v = r.headers.get(header);
+                if (v !== null)
+                    attrs[field] = v;
+            }
+            for (const [h, v] of r.headers)
+                if (h.startsWith("x-amz-meta-")) {
+                    attrs.metadata = attrs.metadata ?? {};
+                    attrs.metadata[h.slice("x-amz-meta-".length)] = v;
+                }
+            const modified = r.headers.get("last-modified");
+            return {
+                body: new Uint8Array(await r.arrayBuffer()),
+                etag: r.headers.get("etag") ?? "",
+                attrs,
+                modifiedMs: modified ? Date.parse(modified) : undefined,
+            };
+        },
+        async put(key, body, cond, attrs) {
+            const headers = {};
+            // Content headers as headers, user metadata as x-amz-meta-* (celld's R2 record is
+            // the ASCII-escaped JSON under x-amz-meta-celld-r2).
+            for (const [field, header] of S3_HEADERS)
+                if (attrs?.[field])
+                    headers[header] = attrs[field];
+            for (const [name, value] of Object.entries(attrs?.metadata ?? {}))
+                headers[`x-amz-meta-${name.toLowerCase()}`] = value;
+            if (cond?.ifNoneMatch)
+                headers["if-none-match"] = "*";
+            if (cond?.ifMatch !== undefined)
+                headers["if-match"] = cond.ifMatch;
+            const r = await call("PUT", new URL(`${base}/${uriEncode(full(key))}`), headers, body);
+            // 409: a concurrent conditional write on some stores (R2, S3) — also a lost race.
+            if (r.status === 412 || r.status === 409)
+                throw new PreconditionFailedError(key);
+            if (!r.ok)
+                throw new Error(`S3 PUT ${key}: ${r.status} ${await r.text()}`);
+            return r.headers.get("etag") ?? "";
+        },
+        async list(prefix) {
+            const keys = [];
+            let token;
+            do {
+                const url = new URL(`${base}/`);
+                url.searchParams.set("list-type", "2");
+                url.searchParams.set("prefix", full(prefix));
+                if (token)
+                    url.searchParams.set("continuation-token", token);
+                const r = await call("GET", url);
+                if (!r.ok)
+                    throw new Error(`S3 LIST ${prefix}: ${r.status} ${await r.text()}`);
+                const xml = await r.text();
+                for (const m of xml.matchAll(/<Key>([^<]*)<\/Key>/g))
+                    keys.push(unxml(m[1]).slice(root.length));
+                token = /<IsTruncated>true<\/IsTruncated>/.test(xml)
+                    ? unxml(/<NextContinuationToken>([^<]*)<\/NextContinuationToken>/.exec(xml)?.[1] ?? "")
+                    : undefined;
+            } while (token);
+            return keys.sort();
+        },
+        async delete(key) {
+            const r = await call("DELETE", new URL(`${base}/${uriEncode(full(key))}`));
+            if (!r.ok && r.status !== 404)
+                throw new Error(`S3 DELETE ${key}: ${r.status}`);
+        },
+    };
+}
+const unxml = (s) => s
+    .replace(/&lt;/g, "<")
+    .replace(/&gt;/g, ">")
+    .replace(/&quot;/g, '"')
+    .replace(/&apos;/g, "'")
+    .replace(/&amp;/g, "&");
+const S3_HEADERS = [
+    ["contentType", "content-type"],
+    ["contentLanguage", "content-language"],
+    ["contentDisposition", "content-disposition"],
+    ["contentEncoding", "content-encoding"],
+    ["cacheControl", "cache-control"],
+];
+//# sourceMappingURL=s3-object-store.js.map

package/dist/bucket/s3-object-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-object-store.js","sourceRoot":"","sources":["../../src/bucket/s3-object-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { bytesToHex } from \"@noble/hashes/utils\";\nimport type { ObjectStore } from \"./object-store.js\";\nimport { type ObjectAttributes, PreconditionFailedError } from \"./object-store.js\";\n\n/**\n * An S3-compatible bucket over fetch with AWS Signature V4 (WebCrypto): Amazon S3, R2,\n * Tigris, MinIO… — the stores celld qualifies. Runs in browsers (the bucket needs a CORS\n * rule exposing ETag and allowing If-Match / If-None-Match) and on Node. Path-style URLs:\n * `${endpoint}/${bucket}/${key}`.\n */\nexport interface S3Options {\n  endpoint: string;\n  bucket: string;\n  region?: string;\n  accessKeyId: string;\n  secretAccessKey: string;\n  sessionToken?: string;\n  /** Key prefix inside the bucket (celld's `CELLD_BUCKET` path part). */\n  prefix?: string;\n  /**\n   * The S3 endpoint the requests are signed for, when `endpoint` is a proxy in front of it\n   * (a browser page reaching a local S3 through its dev server): SigV4 covers host and path.\n   */\n  signAs?: string;\n  fetch?: typeof fetch;\n}\n\nconst enc = new TextEncoder();\nconst sha256 = async (data: Uint8Array | string) =>\n  bytesToHex(\n    new Uint8Array(\n      await crypto.subtle.digest(\n        \"SHA-256\",\n        typeof data === \"string\" ? enc.encode(data) : (data as BufferSource),\n      ),\n    ),\n  );\nconst hmac = async (key: Uint8Array | ArrayBuffer, data: string) => {\n  const k = await crypto.subtle.importKey(\n    \"raw\",\n    key as BufferSource,\n    { name: \"HMAC\", hash: \"SHA-256\" },\n    false,\n    [\"sign\"],\n  );\n  return new Uint8Array(await crypto.subtle.sign(\"HMAC\", k, enc.encode(data)));\n};\nconst uriEncode = (s: string, slash = true) =>\n  encodeURIComponent(s)\n    .replace(/[!'()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`)\n    .replace(slash ? /%2F/g : /$^/, \"/\");\n\nexport async function signV4(\n  method: string,\n  url: URL,\n  headers: Record<string, string>,\n  body: Uint8Array | undefined,\n  o: Pick<S3Options, \"region\" | \"accessKeyId\" | \"secretAccessKey\" | \"sessionToken\">,\n  now = new Date(),\n): Promise<Record<string, string>> {\n  const region = o.region ?? \"auto\";\n  const amzDate = now.toISOString().replace(/[:-]|\\.\\d{3}/g, \"\");\n  const day = amzDate.slice(0, 8);\n  const payloadHash = await sha256(body ?? new Uint8Array());\n  const h: Record<string, string> = {\n    ...Object.fromEntries(Object.entries(headers).map(([k, v]) => [k.toLowerCase(), v])),\n    host: url.host,\n    \"x-amz-date\": amzDate,\n    \"x-amz-content-sha256\": payloadHash,\n  };\n  if (o.sessionToken) h[\"x-amz-security-token\"] = o.sessionToken;\n  const names = Object.keys(h).sort();\n  const query = [...url.searchParams]\n    .map(([k, v]) => [uriEncode(k, false), uriEncode(v, false)])\n    .sort(([a, b], [c, d]) => (a === c ? (b < d ? -1 : 1) : a < c ? -1 : 1))\n    .map(([k, v]) => `${k}=${v}`)\n    .join(\"&\");\n  const canonical = [\n    method,\n    uriEncode(decodeURIComponent(url.pathname)),\n    query,\n    ...names.map((n) => `${n}:${h[n].trim()}`),\n    \"\",\n    names.join(\";\"),\n    payloadHash,\n  ].join(\"\\n\");\n  const scope = `${day}/${region}/s3/aws4_request`;\n  const toSign = [\"AWS4-HMAC-SHA256\", amzDate, scope, await sha256(canonical)].join(\"\\n\");\n  let key: Uint8Array = await hmac(enc.encode(`AWS4${o.secretAccessKey}`), day);\n  for (const part of [region, \"s3\", \"aws4_request\"]) key = await hmac(key, part);\n  const signature = bytesToHex(await hmac(key, toSign));\n  h.authorization = `AWS4-HMAC-SHA256 Credential=${o.accessKeyId}/${scope}, SignedHeaders=${names.join(\";\")}, Signature=${signature}`;\n  delete h.host; // set by fetch\n  return h;\n}\n\nexport function s3ObjectStore(o: S3Options): ObjectStore {\n  const f = o.fetch ?? fetch;\n  const base = `${o.endpoint.replace(/\\/$/, \"\")}/${o.bucket}`;\n  const signBase = `${(o.signAs ?? o.endpoint).replace(/\\/$/, \"\")}/${o.bucket}`;\n  const signed = (url: URL) => (o.signAs ? new URL(signBase + url.href.slice(base.length)) : url);\n  // celld's `s3://BUCKET/PREFIX` puts keys under \"PREFIX/\": a prefix is a directory.\n  const root = o.prefix ? (o.prefix.endsWith(\"/\") ? o.prefix : `${o.prefix}/`) : \"\";\n  const full = (key: string) => `${root}${key}`;\n  const call = async (\n    method: string,\n    url: URL,\n    headers: Record<string, string> = {},\n    body?: Uint8Array,\n  ) =>\n    f(url, {\n      method,\n      headers: await signV4(method, signed(url), headers, body, o),\n      body: body as BodyInit | undefined,\n    });\n  return {\n    async get(key) {\n      const r = await call(\"GET\", new URL(`${base}/${uriEncode(full(key))}`));\n      if (r.status === 404) return undefined;\n      if (!r.ok) throw new Error(`S3 GET ${key}: ${r.status} ${await r.text()}`);\n      const attrs: ObjectAttributes = {};\n      for (const [field, header] of S3_HEADERS) {\n        const v = r.headers.get(header);\n        if (v !== null) attrs[field] = v;\n      }\n      for (const [h, v] of r.headers)\n        if (h.startsWith(\"x-amz-meta-\")) {\n          attrs.metadata = attrs.metadata ?? {};\n          attrs.metadata[h.slice(\"x-amz-meta-\".length)] = v;\n        }\n      const modified = r.headers.get(\"last-modified\");\n      return {\n        body: new Uint8Array(await r.arrayBuffer()),\n        etag: r.headers.get(\"etag\") ?? \"\",\n        attrs,\n        modifiedMs: modified ? Date.parse(modified) : undefined,\n      };\n    },\n    async put(key, body, cond, attrs) {\n      const headers: Record<string, string> = {};\n      // Content headers as headers, user metadata as x-amz-meta-* (celld's R2 record is\n      // the ASCII-escaped JSON under x-amz-meta-celld-r2).\n      for (const [field, header] of S3_HEADERS)\n        if (attrs?.[field]) headers[header] = attrs[field] as string;\n      for (const [name, value] of Object.entries(attrs?.metadata ?? {}))\n        headers[`x-amz-meta-${name.toLowerCase()}`] = value;\n      if (cond?.ifNoneMatch) headers[\"if-none-match\"] = \"*\";\n      if (cond?.ifMatch !== undefined) headers[\"if-match\"] = cond.ifMatch;\n      const r = await call(\"PUT\", new URL(`${base}/${uriEncode(full(key))}`), headers, body);\n      // 409: a concurrent conditional write on some stores (R2, S3) — also a lost race.\n      if (r.status === 412 || r.status === 409) throw new PreconditionFailedError(key);\n      if (!r.ok) throw new Error(`S3 PUT ${key}: ${r.status} ${await r.text()}`);\n      return r.headers.get(\"etag\") ?? \"\";\n    },\n    async list(prefix) {\n      const keys: string[] = [];\n      let token: string | undefined;\n      do {\n        const url = new URL(`${base}/`);\n        url.searchParams.set(\"list-type\", \"2\");\n        url.searchParams.set(\"prefix\", full(prefix));\n        if (token) url.searchParams.set(\"continuation-token\", token);\n        const r = await call(\"GET\", url);\n        if (!r.ok) throw new Error(`S3 LIST ${prefix}: ${r.status} ${await r.text()}`);\n        const xml = await r.text();\n        for (const m of xml.matchAll(/<Key>([^<]*)<\\/Key>/g))\n          keys.push(unxml(m[1]).slice(root.length));\n        token = /<IsTruncated>true<\\/IsTruncated>/.test(xml)\n          ? unxml(/<NextContinuationToken>([^<]*)<\\/NextContinuationToken>/.exec(xml)?.[1] ?? \"\")\n          : undefined;\n      } while (token);\n      return keys.sort();\n    },\n    async delete(key) {\n      const r = await call(\"DELETE\", new URL(`${base}/${uriEncode(full(key))}`));\n      if (!r.ok && r.status !== 404) throw new Error(`S3 DELETE ${key}: ${r.status}`);\n    },\n  };\n}\n\nconst unxml = (s: string) =>\n  s\n    .replace(/&lt;/g, \"<\")\n    .replace(/&gt;/g, \">\")\n    .replace(/&quot;/g, '\"')\n    .replace(/&apos;/g, \"'\")\n    .replace(/&amp;/g, \"&\");\n\nconst S3_HEADERS: [\n  \"contentType\" | \"contentLanguage\" | \"contentDisposition\" | \"contentEncoding\" | \"cacheControl\",\n  string,\n][] = [\n  [\"contentType\", \"content-type\"],\n  [\"contentLanguage\", \"content-language\"],\n  [\"contentDisposition\", \"content-disposition\"],\n  [\"contentEncoding\", \"content-encoding\"],\n  [\"cacheControl\", \"cache-control\"],\n];\n"]}

package/dist/bucket/sqlite-object-store.d.ts

@@ -0,0 +1,10 @@
+import type { ObjectStore } from "./object-store.js";
+/**
+ * celld dev's local bucket: `<project>/.celld/dev/objects.sqlite3` (objects(key, body, etag
+ * INTEGER, modified_ms, attributes) + store_sequence). Reading and writing it lets a
+ * cellb node and `celld dev` share one bucket, so cells move between them.
+ * Conditional writes are real (one SQLite transaction).
+ */
+export declare function sqliteObjectStore(file: string): ObjectStore & {
+    close(): void;
+};

package/dist/bucket/sqlite-object-store.js

@@ -0,0 +1,107 @@
+import { createRequire } from "node:module";
+import { PreconditionFailedError } from "./object-store.js";
+const { DatabaseSync } = createRequire(import.meta.url)("node:sqlite");
+/**
+ * celld dev's local bucket: `<project>/.celld/dev/objects.sqlite3` (objects(key, body, etag
+ * INTEGER, modified_ms, attributes) + store_sequence). Reading and writing it lets a
+ * cellb node and `celld dev` share one bucket, so cells move between them.
+ * Conditional writes are real (one SQLite transaction).
+ */
+export function sqliteObjectStore(file) {
+    const db = new DatabaseSync(file);
+    db.exec(`CREATE TABLE IF NOT EXISTS objects (
+    key TEXT PRIMARY KEY, body BLOB NOT NULL, etag INTEGER NOT NULL,
+    modified_ms INTEGER NOT NULL, attributes TEXT NOT NULL)`);
+    db.exec(`CREATE TABLE IF NOT EXISTS store_sequence (
+    singleton INTEGER PRIMARY KEY CHECK (singleton = 1), next_etag INTEGER NOT NULL)`);
+    db.exec("INSERT OR IGNORE INTO store_sequence (singleton, next_etag) VALUES (1, 1)");
+    db.exec("PRAGMA busy_timeout = 5000");
+    return {
+        async get(key) {
+            const r = db
+                .prepare("SELECT body, etag, modified_ms, attributes FROM objects WHERE key = ?")
+                .get(key);
+            return r
+                ? {
+                    body: new Uint8Array(r.body),
+                    etag: String(r.etag),
+                    modifiedMs: Number(r.modified_ms),
+                    attrs: fromAttributes(r.attributes),
+                }
+                : undefined;
+        },
+        async put(key, body, cond, attrs) {
+            db.exec("BEGIN IMMEDIATE");
+            try {
+                const cur = db.prepare("SELECT etag FROM objects WHERE key = ?").get(key);
+                if (cond?.ifNoneMatch === "*" && cur)
+                    throw new PreconditionFailedError(key);
+                if (cond?.ifMatch !== undefined && String(cur?.etag) !== cond.ifMatch)
+                    throw new PreconditionFailedError(key);
+                const { next_etag } = db
+                    .prepare("SELECT next_etag FROM store_sequence WHERE singleton = 1")
+                    .get();
+                db.prepare("UPDATE store_sequence SET next_etag = ? WHERE singleton = 1").run(next_etag + 1);
+                db.prepare("INSERT OR REPLACE INTO objects (key, body, etag, modified_ms, attributes) VALUES (?, ?, ?, ?, ?)").run(key, body, next_etag, Date.now(), toAttributes(attrs));
+                db.exec("COMMIT");
+                return String(next_etag);
+            }
+            catch (e) {
+                db.exec("ROLLBACK");
+                throw e;
+            }
+        },
+        async list(prefix) {
+            return db
+                .prepare("SELECT key FROM objects WHERE key >= ? AND key < ? ORDER BY key")
+                .all(prefix, `${prefix}\uffff`).map((r) => r.key);
+        },
+        async delete(key) {
+            db.prepare("DELETE FROM objects WHERE key = ?").run(key);
+        },
+        close() {
+            db.close();
+        },
+    };
+}
+const HEADERS = [
+    ["contentType", "content-type"],
+    ["contentLanguage", "content-language"],
+    ["contentDisposition", "content-disposition"],
+    ["contentEncoding", "content-encoding"],
+    ["cacheControl", "cache-control"],
+];
+function toAttributes(attrs) {
+    const out = [];
+    for (const [name, value] of Object.entries(attrs?.metadata ?? {}))
+        out.push({ kind: "metadata", name, value });
+    for (const [field, kind] of HEADERS) {
+        const v = attrs?.[field];
+        if (typeof v === "string")
+            out.push({ kind, name: null, value: v });
+    }
+    return JSON.stringify(out);
+}
+function fromAttributes(raw) {
+    let list;
+    try {
+        list = JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+    if (!Array.isArray(list) || !list.length)
+        return undefined;
+    const attrs = {};
+    for (const e of list) {
+        if (e.kind === "metadata" && e.name) {
+            attrs.metadata = attrs.metadata ?? {};
+            attrs.metadata[e.name] = e.value;
+        }
+        const h = HEADERS.find(([, kind]) => kind === e.kind);
+        if (h)
+            attrs[h[0]] = e.value;
+    }
+    return attrs;
+}
+//# sourceMappingURL=sqlite-object-store.js.map

package/dist/bucket/sqlite-object-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-object-store.js","sourceRoot":"","sources":["../../src/bucket/sqlite-object-store.ts"],"names":[],"mappings":"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","sourcesContent":["import { createRequire } from \"node:module\";\nimport type { ObjectAttributes, ObjectStore } from \"./object-store.js\";\nimport { PreconditionFailedError } from \"./object-store.js\";\n\nconst { DatabaseSync } = createRequire(import.meta.url)(\n  \"node:sqlite\",\n) as typeof import(\"node:sqlite\");\n\n/**\n * celld dev's local bucket: `<project>/.celld/dev/objects.sqlite3` (objects(key, body, etag\n * INTEGER, modified_ms, attributes) + store_sequence). Reading and writing it lets a\n * cellb node and `celld dev` share one bucket, so cells move between them.\n * Conditional writes are real (one SQLite transaction).\n */\nexport function sqliteObjectStore(file: string): ObjectStore & { close(): void } {\n  const db = new DatabaseSync(file);\n  db.exec(`CREATE TABLE IF NOT EXISTS objects (\n    key TEXT PRIMARY KEY, body BLOB NOT NULL, etag INTEGER NOT NULL,\n    modified_ms INTEGER NOT NULL, attributes TEXT NOT NULL)`);\n  db.exec(`CREATE TABLE IF NOT EXISTS store_sequence (\n    singleton INTEGER PRIMARY KEY CHECK (singleton = 1), next_etag INTEGER NOT NULL)`);\n  db.exec(\"INSERT OR IGNORE INTO store_sequence (singleton, next_etag) VALUES (1, 1)\");\n  db.exec(\"PRAGMA busy_timeout = 5000\");\n  return {\n    async get(key) {\n      const r = db\n        .prepare(\"SELECT body, etag, modified_ms, attributes FROM objects WHERE key = ?\")\n        .get(key) as\n        | { body: Uint8Array; etag: number; modified_ms: number; attributes: string }\n        | undefined;\n      return r\n        ? {\n            body: new Uint8Array(r.body),\n            etag: String(r.etag),\n            modifiedMs: Number(r.modified_ms),\n            attrs: fromAttributes(r.attributes),\n          }\n        : undefined;\n    },\n    async put(key, body, cond, attrs) {\n      db.exec(\"BEGIN IMMEDIATE\");\n      try {\n        const cur = db.prepare(\"SELECT etag FROM objects WHERE key = ?\").get(key) as\n          | { etag: number }\n          | undefined;\n        if (cond?.ifNoneMatch === \"*\" && cur) throw new PreconditionFailedError(key);\n        if (cond?.ifMatch !== undefined && String(cur?.etag) !== cond.ifMatch)\n          throw new PreconditionFailedError(key);\n        const { next_etag } = db\n          .prepare(\"SELECT next_etag FROM store_sequence WHERE singleton = 1\")\n          .get() as {\n          next_etag: number;\n        };\n        db.prepare(\"UPDATE store_sequence SET next_etag = ? WHERE singleton = 1\").run(\n          next_etag + 1,\n        );\n        db.prepare(\n          \"INSERT OR REPLACE INTO objects (key, body, etag, modified_ms, attributes) VALUES (?, ?, ?, ?, ?)\",\n        ).run(key, body, next_etag, Date.now(), toAttributes(attrs));\n        db.exec(\"COMMIT\");\n        return String(next_etag);\n      } catch (e) {\n        db.exec(\"ROLLBACK\");\n        throw e;\n      }\n    },\n    async list(prefix) {\n      return (\n        db\n          .prepare(\"SELECT key FROM objects WHERE key >= ? AND key < ? ORDER BY key\")\n          .all(prefix, `${prefix}\\uffff`) as {\n          key: string;\n        }[]\n      ).map((r) => r.key);\n    },\n    async delete(key) {\n      db.prepare(\"DELETE FROM objects WHERE key = ?\").run(key);\n    },\n    close() {\n      db.close();\n    },\n  };\n}\n\n// celld dev's `attributes` column: a JSON array of {kind, name, value} — \"metadata\" entries\n// (user metadata, name = key) and one entry per content header (\"content-type\", …).\ntype HeaderField =\n  | \"contentType\"\n  | \"contentLanguage\"\n  | \"contentDisposition\"\n  | \"contentEncoding\"\n  | \"cacheControl\";\nconst HEADERS: [HeaderField, string][] = [\n  [\"contentType\", \"content-type\"],\n  [\"contentLanguage\", \"content-language\"],\n  [\"contentDisposition\", \"content-disposition\"],\n  [\"contentEncoding\", \"content-encoding\"],\n  [\"cacheControl\", \"cache-control\"],\n];\nfunction toAttributes(attrs?: ObjectAttributes): string {\n  const out: { kind: string; name: string | null; value: string }[] = [];\n  for (const [name, value] of Object.entries(attrs?.metadata ?? {}))\n    out.push({ kind: \"metadata\", name, value });\n  for (const [field, kind] of HEADERS) {\n    const v = attrs?.[field];\n    if (typeof v === \"string\") out.push({ kind, name: null, value: v });\n  }\n  return JSON.stringify(out);\n}\nfunction fromAttributes(raw: string): ObjectAttributes | undefined {\n  let list: { kind: string; name: string | null; value: string }[];\n  try {\n    list = JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n  if (!Array.isArray(list) || !list.length) return undefined;\n  const attrs: ObjectAttributes = {};\n  for (const e of list) {\n    if (e.kind === \"metadata\" && e.name) {\n      attrs.metadata = attrs.metadata ?? {};\n      attrs.metadata[e.name] = e.value;\n    }\n    const h = HEADERS.find(([, kind]) => kind === e.kind);\n    if (h) (attrs as Record<string, unknown>)[h[0]] = e.value;\n  }\n  return attrs;\n}\n"]}

package/dist/core/alarms.d.ts

@@ -0,0 +1,27 @@
+import type { Clock, SyncSqlDriver } from "../ports.js";
+export interface AlarmEntry {
+    cellKey: string;
+    className: string;
+    idHex: string;
+    at: number;
+}
+/**
+ * Runtime-wide alarm scheduler. Every object's alarm lives in its own `_cf_METADATA`
+ * (the truth); this index — one small SQLite database next to the cells — lets a
+ * restarted runtime wake objects whose alarms are due without anyone touching them
+ * (catch-up after a crash, a closed tab or a frozen page).
+ */
+export declare class AlarmScheduler {
+    #private;
+    constructor(opts: {
+        clock: Clock;
+        openIndex?: () => SyncSqlDriver;
+        fire: (e: AlarmEntry) => Promise<void>;
+    });
+    /** Re-arms every alarm recorded in the index (due ones fire at once). */
+    restore(): void;
+    set(entry: Omit<AlarmEntry, "at">, at: number | null): void;
+    stop(): void;
+    /** Closes the index database (after the objects that record into it have closed). */
+    close(): void;
+}

package/dist/core/alarms.js

@@ -0,0 +1,88 @@
+/**
+ * Runtime-wide alarm scheduler. Every object's alarm lives in its own `_cf_METADATA`
+ * (the truth); this index — one small SQLite database next to the cells — lets a
+ * restarted runtime wake objects whose alarms are due without anyone touching them
+ * (catch-up after a crash, a closed tab or a frozen page).
+ */
+export class AlarmScheduler {
+    #timers = new Map();
+    #clock;
+    #openIndex;
+    #indexDb;
+    #fire;
+    constructor(opts) {
+        this.#clock = opts.clock;
+        this.#openIndex = opts.openIndex;
+        this.#fire = opts.fire;
+    }
+    /**
+     * The index is opened lazily and is best effort: if it cannot be opened (e.g. another
+     * process holds it in EXCLUSIVE locking mode) alarms still fire for live objects; only
+     * the catch-up after a restart is lost for this runtime.
+     */
+    get #index() {
+        if (this.#indexDb === undefined) {
+            try {
+                const db = this.#openIndex?.() ?? null;
+                db?.exec("CREATE TABLE IF NOT EXISTS alarms (cell_key TEXT PRIMARY KEY, class_name TEXT, id_hex TEXT, at INTEGER)", []);
+                this.#indexDb = db;
+            }
+            catch {
+                this.#indexDb = null;
+            }
+        }
+        return this.#indexDb ?? undefined;
+    }
+    /** Re-arms every alarm recorded in the index (due ones fire at once). */
+    restore() {
+        for (const [cellKey, className, idHex, at] of this.#index?.exec("SELECT * FROM alarms", [])
+            .rows ?? [])
+            this.#arm({
+                cellKey: String(cellKey),
+                className: String(className),
+                idHex: String(idHex),
+                at: Number(at),
+            });
+    }
+    set(entry, at) {
+        this.#clear(entry.cellKey);
+        if (at === null) {
+            this.#index?.exec("DELETE FROM alarms WHERE cell_key = ?", [entry.cellKey]);
+            return;
+        }
+        this.#index?.exec("INSERT OR REPLACE INTO alarms VALUES (?, ?, ?, ?)", [
+            entry.cellKey,
+            entry.className,
+            entry.idHex,
+            at,
+        ]);
+        this.#arm({ ...entry, at });
+    }
+    #arm(e) {
+        this.#clear(e.cellKey);
+        const delay = Math.max(0, e.at - this.#clock.now());
+        this.#timers.set(e.cellKey, this.#clock.setTimeout(() => {
+            this.#timers.delete(e.cellKey);
+            void this.#fire(e);
+        }, delay));
+    }
+    #clear(cellKey) {
+        const t = this.#timers.get(cellKey);
+        if (t !== undefined)
+            this.#clock.clearTimeout(t);
+        this.#timers.delete(cellKey);
+    }
+    stop() {
+        for (const t of this.#timers.values())
+            this.#clock.clearTimeout(t);
+        this.#timers.clear();
+    }
+    /** Closes the index database (after the objects that record into it have closed). */
+    close() {
+        this.stop();
+        const db = this.#indexDb;
+        this.#indexDb = null; // stays closed: later records are dropped
+        db?.close();
+    }
+}
+//# sourceMappingURL=alarms.js.map

package/dist/core/alarms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alarms.js","sourceRoot":"","sources":["../../src/core/alarms.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IAChB,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IACrC,MAAM,CAAQ;IACd,UAAU,CAAuB;IAC1C,QAAQ,CAAmC;IAClC,KAAK,CAAmC;IAEjD,YAAY,IAIX;QACC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,IAAI,MAAM;QACR,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,IAAI,CAAC;gBACvC,EAAE,EAAE,IAAI,CACN,yGAAyG,EACzG,EAAE,CACH,CAAC;gBACF,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC;IACpC,CAAC;IAED,yEAAyE;IACzE,OAAO;QACL,KAAK,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,sBAAsB,EAAE,EAAE,CAAC;aACxF,IAAI,IAAI,EAAE;YACX,IAAI,CAAC,IAAI,CAAC;gBACR,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;gBACxB,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC;gBAC5B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;gBACpB,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;aACf,CAAC,CAAC;IACP,CAAC;IAED,GAAG,CAAC,KAA6B,EAAE,EAAiB;QAClD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,uCAAuC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAC5E,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,mDAAmD,EAAE;YACrE,KAAK,CAAC,OAAO;YACb,KAAK,CAAC,SAAS;YACf,KAAK,CAAC,KAAK;YACX,EAAE;SACH,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,CAAa;QAChB,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,CAAC,GAAG,CACd,CAAC,CAAC,OAAO,EACT,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;YAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAC/B,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC,EAAE,KAAK,CAAC,CACV,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,OAAe;QACpB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI;QACF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,qFAAqF;IACrF,KAAK;QACH,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,0CAA0C;QAChE,EAAE,EAAE,KAAK,EAAE,CAAC;IACd,CAAC;CACF","sourcesContent":["import type { Clock, SyncSqlDriver } from \"../ports.js\";\n\nexport interface AlarmEntry {\n  cellKey: string;\n  className: string;\n  idHex: string;\n  at: number;\n}\n\n/**\n * Runtime-wide alarm scheduler. Every object's alarm lives in its own `_cf_METADATA`\n * (the truth); this index — one small SQLite database next to the cells — lets a\n * restarted runtime wake objects whose alarms are due without anyone touching them\n * (catch-up after a crash, a closed tab or a frozen page).\n */\nexport class AlarmScheduler {\n  readonly #timers = new Map<string, unknown>();\n  readonly #clock: Clock;\n  readonly #openIndex?: () => SyncSqlDriver;\n  #indexDb: SyncSqlDriver | null | undefined;\n  readonly #fire: (e: AlarmEntry) => Promise<void>;\n\n  constructor(opts: {\n    clock: Clock;\n    openIndex?: () => SyncSqlDriver;\n    fire: (e: AlarmEntry) => Promise<void>;\n  }) {\n    this.#clock = opts.clock;\n    this.#openIndex = opts.openIndex;\n    this.#fire = opts.fire;\n  }\n\n  /**\n   * The index is opened lazily and is best effort: if it cannot be opened (e.g. another\n   * process holds it in EXCLUSIVE locking mode) alarms still fire for live objects; only\n   * the catch-up after a restart is lost for this runtime.\n   */\n  get #index(): SyncSqlDriver | undefined {\n    if (this.#indexDb === undefined) {\n      try {\n        const db = this.#openIndex?.() ?? null;\n        db?.exec(\n          \"CREATE TABLE IF NOT EXISTS alarms (cell_key TEXT PRIMARY KEY, class_name TEXT, id_hex TEXT, at INTEGER)\",\n          [],\n        );\n        this.#indexDb = db;\n      } catch {\n        this.#indexDb = null;\n      }\n    }\n    return this.#indexDb ?? undefined;\n  }\n\n  /** Re-arms every alarm recorded in the index (due ones fire at once). */\n  restore(): void {\n    for (const [cellKey, className, idHex, at] of this.#index?.exec(\"SELECT * FROM alarms\", [])\n      .rows ?? [])\n      this.#arm({\n        cellKey: String(cellKey),\n        className: String(className),\n        idHex: String(idHex),\n        at: Number(at),\n      });\n  }\n\n  set(entry: Omit<AlarmEntry, \"at\">, at: number | null): void {\n    this.#clear(entry.cellKey);\n    if (at === null) {\n      this.#index?.exec(\"DELETE FROM alarms WHERE cell_key = ?\", [entry.cellKey]);\n      return;\n    }\n    this.#index?.exec(\"INSERT OR REPLACE INTO alarms VALUES (?, ?, ?, ?)\", [\n      entry.cellKey,\n      entry.className,\n      entry.idHex,\n      at,\n    ]);\n    this.#arm({ ...entry, at });\n  }\n\n  #arm(e: AlarmEntry): void {\n    this.#clear(e.cellKey);\n    const delay = Math.max(0, e.at - this.#clock.now());\n    this.#timers.set(\n      e.cellKey,\n      this.#clock.setTimeout(() => {\n        this.#timers.delete(e.cellKey);\n        void this.#fire(e);\n      }, delay),\n    );\n  }\n\n  #clear(cellKey: string): void {\n    const t = this.#timers.get(cellKey);\n    if (t !== undefined) this.#clock.clearTimeout(t);\n    this.#timers.delete(cellKey);\n  }\n\n  stop(): void {\n    for (const t of this.#timers.values()) this.#clock.clearTimeout(t);\n    this.#timers.clear();\n  }\n\n  /** Closes the index database (after the objects that record into it have closed). */\n  close(): void {\n    this.stop();\n    const db = this.#indexDb;\n    this.#indexDb = null; // stays closed: later records are dropped\n    db?.close();\n  }\n}\n"]}

package/dist/core/async-context.d.ts

@@ -0,0 +1,34 @@
+/** Runs `fn` in an async context captured earlier. */
+export type AsyncRoot = <R>(fn: () => R) => R;
+type Fn<R = unknown> = (...args: any[]) => R;
+/** TC39 AsyncContext (Stage 2), the part cellb uses. */
+export interface NativeAsyncContext {
+    Variable: new <T>(options?: {
+        name?: string;
+        defaultValue?: T;
+    }) => {
+        get(): T | undefined;
+        run<R>(value: T, fn: Fn<R>, ...args: unknown[]): R;
+    };
+    Snapshot: {
+        new (): {
+            run<R>(fn: Fn<R>, ...args: unknown[]): R;
+        };
+        wrap<F extends Fn>(fn: F): F;
+    };
+}
+/**
+ * The engine's AsyncContext, when the realm has one: async context then follows every `await`
+ * natively, as in workerd, celld and Node, and code needs no lowering.
+ */
+export declare function nativeAsyncContext(): NativeAsyncContext | undefined;
+/**
+ * The async context current now, to start events in: on Cloudflare a call to a Durable Object is
+ * a new event, which sees no `AsyncLocalStorage` store its caller set. On Node it is every store
+ * (`AsyncLocalStorage.snapshot()`); in a browser with AsyncContext, an `AsyncContext.Snapshot`;
+ * in other browsers, the `node:async_hooks` polyfill's frame (a realm's polyfill copies share
+ * it), or its root frame if the polyfill loads later. Elsewhere events run in their caller's
+ * context, as before.
+ */
+export declare function asyncRoot(): AsyncRoot;
+export {};

package/dist/core/async-context.js

@@ -0,0 +1,50 @@
+const POLYFILL_STATE = Symbol.for("cellb.asyncContext.state");
+/**
+ * The engine's AsyncContext, when the realm has one: async context then follows every `await`
+ * natively, as in workerd, celld and Node, and code needs no lowering.
+ */
+export function nativeAsyncContext() {
+    const ac = globalThis.AsyncContext;
+    return typeof ac?.Variable === "function" && typeof ac.Snapshot === "function"
+        ? ac
+        : undefined;
+}
+/**
+ * The async context current now, to start events in: on Cloudflare a call to a Durable Object is
+ * a new event, which sees no `AsyncLocalStorage` store its caller set. On Node it is every store
+ * (`AsyncLocalStorage.snapshot()`); in a browser with AsyncContext, an `AsyncContext.Snapshot`;
+ * in other browsers, the `node:async_hooks` polyfill's frame (a realm's polyfill copies share
+ * it), or its root frame if the polyfill loads later. Elsewhere events run in their caller's
+ * context, as before.
+ */
+export function asyncRoot() {
+    const hooks = globalThis.process?.getBuiltinModule?.("node:async_hooks");
+    const snapshot = hooks?.AsyncLocalStorage?.snapshot?.();
+    const Resource = hooks?.AsyncResource;
+    // Each event in a resource of its own, made in the snapshot: it inherits the snapshot's stores,
+    // and a store an event sets (`run` writes it on the current resource, before Node's
+    // AsyncContextFrame) stays its own instead of reaching the next event started in the snapshot.
+    if (snapshot && Resource)
+        return (fn) => snapshot(() => new Resource("cellb.event").runInAsyncScope(fn));
+    const native = nativeAsyncContext();
+    if (native) {
+        const captured = new native.Snapshot();
+        return (fn) => captured.run(fn);
+    }
+    const realm = globalThis;
+    const captured = realm[POLYFILL_STATE]?.current;
+    return (fn) => {
+        const state = realm[POLYFILL_STATE];
+        if (!state)
+            return fn();
+        const prev = state.current;
+        state.current = captured ?? state.root;
+        try {
+            return fn();
+        }
+        finally {
+            state.current = prev;
+        }
+    };
+}
+//# sourceMappingURL=async-context.js.map

package/dist/core/async-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-context.js","sourceRoot":"","sources":["../../src/core/async-context.ts"],"names":[],"mappings":"AAGA,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAoB9D;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,EAAE,GAAI,UAA6D,CAAC,YAAY,CAAC;IACvF,OAAO,OAAO,EAAE,EAAE,QAAQ,KAAK,UAAU,IAAI,OAAO,EAAE,CAAC,QAAQ,KAAK,UAAU;QAC5E,CAAC,CAAE,EAAyB;QAC5B,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,KAAK,GACT,UAGD,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC,kBAAkB,CAKnC,CAAC;IACd,MAAM,QAAQ,GAAG,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,EAAE,CAAC;IACxD,MAAM,QAAQ,GAAG,KAAK,EAAE,aAAa,CAAC;IACtC,gGAAgG;IAChG,oFAAoF;IACpF,+FAA+F;IAC/F,IAAI,QAAQ,IAAI,QAAQ;QACtB,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,QAAQ,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC;IACjF,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;IACpC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACvC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,KAAK,GAAG,UAA+C,CAAC;IAC9D,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAChD,OAAO,CAAC,EAAE,EAAE,EAAE;QACZ,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC;QAC3B,KAAK,CAAC,OAAO,GAAG,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC;QACvC,IAAI,CAAC;YACH,OAAO,EAAE,EAAE,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["/** Runs `fn` in an async context captured earlier. */\nexport type AsyncRoot = <R>(fn: () => R) => R;\n\nconst POLYFILL_STATE = Symbol.for(\"cellb.asyncContext.state\");\n\n// biome-ignore lint/suspicious/noExplicitAny: any function, called with its own arguments\ntype Fn<R = unknown> = (...args: any[]) => R;\n\n/** TC39 AsyncContext (Stage 2), the part cellb uses. */\nexport interface NativeAsyncContext {\n  Variable: new <T>(options?: {\n    name?: string;\n    defaultValue?: T;\n  }) => {\n    get(): T | undefined;\n    run<R>(value: T, fn: Fn<R>, ...args: unknown[]): R;\n  };\n  Snapshot: {\n    new (): { run<R>(fn: Fn<R>, ...args: unknown[]): R };\n    wrap<F extends Fn>(fn: F): F;\n  };\n}\n\n/**\n * The engine's AsyncContext, when the realm has one: async context then follows every `await`\n * natively, as in workerd, celld and Node, and code needs no lowering.\n */\nexport function nativeAsyncContext(): NativeAsyncContext | undefined {\n  const ac = (globalThis as { AsyncContext?: Partial<NativeAsyncContext> }).AsyncContext;\n  return typeof ac?.Variable === \"function\" && typeof ac.Snapshot === \"function\"\n    ? (ac as NativeAsyncContext)\n    : undefined;\n}\n\n/**\n * The async context current now, to start events in: on Cloudflare a call to a Durable Object is\n * a new event, which sees no `AsyncLocalStorage` store its caller set. On Node it is every store\n * (`AsyncLocalStorage.snapshot()`); in a browser with AsyncContext, an `AsyncContext.Snapshot`;\n * in other browsers, the `node:async_hooks` polyfill's frame (a realm's polyfill copies share\n * it), or its root frame if the polyfill loads later. Elsewhere events run in their caller's\n * context, as before.\n */\nexport function asyncRoot(): AsyncRoot {\n  const hooks = (\n    globalThis as {\n      process?: { getBuiltinModule?(id: string): unknown };\n    }\n  ).process?.getBuiltinModule?.(\"node:async_hooks\") as\n    | {\n        AsyncLocalStorage?: { snapshot?(): <R>(fn: () => R) => R };\n        AsyncResource?: new (type: string) => { runInAsyncScope<R>(fn: () => R): R };\n      }\n    | undefined;\n  const snapshot = hooks?.AsyncLocalStorage?.snapshot?.();\n  const Resource = hooks?.AsyncResource;\n  // Each event in a resource of its own, made in the snapshot: it inherits the snapshot's stores,\n  // and a store an event sets (`run` writes it on the current resource, before Node's\n  // AsyncContextFrame) stays its own instead of reaching the next event started in the snapshot.\n  if (snapshot && Resource)\n    return (fn) => snapshot(() => new Resource(\"cellb.event\").runInAsyncScope(fn));\n  const native = nativeAsyncContext();\n  if (native) {\n    const captured = new native.Snapshot();\n    return (fn) => captured.run(fn);\n  }\n  type State = { root: unknown; current: unknown };\n  const realm = globalThis as Record<symbol, State | undefined>;\n  const captured = realm[POLYFILL_STATE]?.current;\n  return (fn) => {\n    const state = realm[POLYFILL_STATE];\n    if (!state) return fn();\n    const prev = state.current;\n    state.current = captured ?? state.root;\n    try {\n      return fn();\n    } finally {\n      state.current = prev;\n    }\n  };\n}\n"]}

package/dist/core/celld-schema.d.ts

@@ -0,0 +1,14 @@
+/**
+ * celld's internal tables, statement for statement (read from a database celld 0.6.2
+ * wrote): Durable Object KV in `_cf_KV(scope, k, v)` with V8-serialized values, the alarm in
+ * `_cf_ALARM`, the object's name in `_cf_METADATA(scope, actor_name)`, facets and wake-up
+ * bookkeeping. cellb uses the same tables, so a cell's database (and its LTX log)
+ * reads the same in both. `scope` is celld's cell name, `<Class>:<id hex>`.
+ */
+export declare const CELLD_SCHEMA: string[];
+/** cellb's own bookkeeping (not in celld): the transaction-log sequence number. */
+export declare const LOG_TABLE = "CREATE TABLE IF NOT EXISTS _cf_LOG (id INTEGER PRIMARY KEY CHECK (id = 1), seq INTEGER NOT NULL)";
+export declare const LOG_SEQ_READ = "SELECT seq FROM _cf_LOG WHERE id = 1";
+export declare const LOG_SEQ_WRITE = "INSERT OR REPLACE INTO _cf_LOG (id, seq) VALUES (1, ?)";
+/** celld's cell name for a cellb cell key ("Class/idhex" → "Class:idhex"). */
+export declare const scopeOf: (cellKey: string) => string;

package/dist/core/celld-schema.js

@@ -0,0 +1,34 @@
+/**
+ * celld's internal tables, statement for statement (read from a database celld 0.6.2
+ * wrote): Durable Object KV in `_cf_KV(scope, k, v)` with V8-serialized values, the alarm in
+ * `_cf_ALARM`, the object's name in `_cf_METADATA(scope, actor_name)`, facets and wake-up
+ * bookkeeping. cellb uses the same tables, so a cell's database (and its LTX log)
+ * reads the same in both. `scope` is celld's cell name, `<Class>:<id hex>`.
+ */
+export const CELLD_SCHEMA = [
+    "CREATE TABLE IF NOT EXISTS _cf_KV (scope TEXT, k TEXT, v TEXT, PRIMARY KEY(scope,k))",
+    "CREATE TABLE IF NOT EXISTS _cf_ALARM (scope TEXT PRIMARY KEY, at_ms INTEGER, retry INTEGER DEFAULT 0, counted_retry INTEGER NOT NULL DEFAULT 0, generation INTEGER NOT NULL DEFAULT 0)",
+    "CREATE TABLE IF NOT EXISTS _cf_METADATA (scope TEXT PRIMARY KEY, actor_name TEXT)",
+    "CREATE TABLE IF NOT EXISTS _cf_FACETS (scope TEXT NOT NULL, path TEXT NOT NULL, image BLOB NOT NULL, PRIMARY KEY(scope,path)) WITHOUT ROWID",
+    `CREATE TABLE IF NOT EXISTS _cf_WAKE (
+           scope TEXT PRIMARY KEY, epoch TEXT NOT NULL CHECK(length(epoch)=16),
+           sequence INTEGER NOT NULL CHECK(typeof(sequence)='integer' AND sequence>=0),
+           at_ms INTEGER
+         )`,
+    `CREATE TRIGGER IF NOT EXISTS _cf_WAKE_insert AFTER INSERT ON _cf_ALARM BEGIN
+               UPDATE _cf_WAKE SET sequence=sequence+1,at_ms=NEW.at_ms WHERE scope=NEW.scope;
+             END`,
+    `CREATE TRIGGER IF NOT EXISTS _cf_WAKE_update AFTER UPDATE OF at_ms,generation ON _cf_ALARM BEGIN
+               UPDATE _cf_WAKE SET sequence=sequence+1,at_ms=NEW.at_ms WHERE scope=NEW.scope;
+             END`,
+    `CREATE TRIGGER IF NOT EXISTS _cf_WAKE_delete AFTER DELETE ON _cf_ALARM BEGIN
+               UPDATE _cf_WAKE SET sequence=sequence+1,at_ms=NULL WHERE scope=OLD.scope;
+             END`,
+];
+/** cellb's own bookkeeping (not in celld): the transaction-log sequence number. */
+export const LOG_TABLE = "CREATE TABLE IF NOT EXISTS _cf_LOG (id INTEGER PRIMARY KEY CHECK (id = 1), seq INTEGER NOT NULL)";
+export const LOG_SEQ_READ = "SELECT seq FROM _cf_LOG WHERE id = 1";
+export const LOG_SEQ_WRITE = "INSERT OR REPLACE INTO _cf_LOG (id, seq) VALUES (1, ?)";
+/** celld's cell name for a cellb cell key ("Class/idhex" → "Class:idhex"). */
+export const scopeOf = (cellKey) => cellKey.replace("/", ":");
+//# sourceMappingURL=celld-schema.js.map

package/dist/core/celld-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"celld-schema.js","sourceRoot":"","sources":["../../src/core/celld-schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,sFAAsF;IACtF,wLAAwL;IACxL,mFAAmF;IACnF,6IAA6I;IAC7I;;;;WAIS;IACT;;iBAEe;IACf;;iBAEe;IACf;;iBAEe;CAChB,CAAC;AAEF,mFAAmF;AACnF,MAAM,CAAC,MAAM,SAAS,GACpB,kGAAkG,CAAC;AACrG,MAAM,CAAC,MAAM,YAAY,GAAG,sCAAsC,CAAC;AACnE,MAAM,CAAC,MAAM,aAAa,GAAG,wDAAwD,CAAC;AAEtF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC","sourcesContent":["/**\n * celld's internal tables, statement for statement (read from a database celld 0.6.2\n * wrote): Durable Object KV in `_cf_KV(scope, k, v)` with V8-serialized values, the alarm in\n * `_cf_ALARM`, the object's name in `_cf_METADATA(scope, actor_name)`, facets and wake-up\n * bookkeeping. cellb uses the same tables, so a cell's database (and its LTX log)\n * reads the same in both. `scope` is celld's cell name, `<Class>:<id hex>`.\n */\nexport const CELLD_SCHEMA = [\n  \"CREATE TABLE IF NOT EXISTS _cf_KV (scope TEXT, k TEXT, v TEXT, PRIMARY KEY(scope,k))\",\n  \"CREATE TABLE IF NOT EXISTS _cf_ALARM (scope TEXT PRIMARY KEY, at_ms INTEGER, retry INTEGER DEFAULT 0, counted_retry INTEGER NOT NULL DEFAULT 0, generation INTEGER NOT NULL DEFAULT 0)\",\n  \"CREATE TABLE IF NOT EXISTS _cf_METADATA (scope TEXT PRIMARY KEY, actor_name TEXT)\",\n  \"CREATE TABLE IF NOT EXISTS _cf_FACETS (scope TEXT NOT NULL, path TEXT NOT NULL, image BLOB NOT NULL, PRIMARY KEY(scope,path)) WITHOUT ROWID\",\n  `CREATE TABLE IF NOT EXISTS _cf_WAKE (\n           scope TEXT PRIMARY KEY, epoch TEXT NOT NULL CHECK(length(epoch)=16),\n           sequence INTEGER NOT NULL CHECK(typeof(sequence)='integer' AND sequence>=0),\n           at_ms INTEGER\n         )`,\n  `CREATE TRIGGER IF NOT EXISTS _cf_WAKE_insert AFTER INSERT ON _cf_ALARM BEGIN\n               UPDATE _cf_WAKE SET sequence=sequence+1,at_ms=NEW.at_ms WHERE scope=NEW.scope;\n             END`,\n  `CREATE TRIGGER IF NOT EXISTS _cf_WAKE_update AFTER UPDATE OF at_ms,generation ON _cf_ALARM BEGIN\n               UPDATE _cf_WAKE SET sequence=sequence+1,at_ms=NEW.at_ms WHERE scope=NEW.scope;\n             END`,\n  `CREATE TRIGGER IF NOT EXISTS _cf_WAKE_delete AFTER DELETE ON _cf_ALARM BEGIN\n               UPDATE _cf_WAKE SET sequence=sequence+1,at_ms=NULL WHERE scope=OLD.scope;\n             END`,\n];\n\n/** cellb's own bookkeeping (not in celld): the transaction-log sequence number. */\nexport const LOG_TABLE =\n  \"CREATE TABLE IF NOT EXISTS _cf_LOG (id INTEGER PRIMARY KEY CHECK (id = 1), seq INTEGER NOT NULL)\";\nexport const LOG_SEQ_READ = \"SELECT seq FROM _cf_LOG WHERE id = 1\";\nexport const LOG_SEQ_WRITE = \"INSERT OR REPLACE INTO _cf_LOG (id, seq) VALUES (1, ?)\";\n\n/** celld's cell name for a cellb cell key (\"Class/idhex\" → \"Class:idhex\"). */\nexport const scopeOf = (cellKey: string) => cellKey.replace(\"/\", \":\");\n"]}