@book.dev/sdk 1.65.1 → 1.67.0

package/dist/notionImport.js

@@ -0,0 +1,539 @@
+/**
+ * **Notion "Markdown & CSV" export → import IR.** Ingests the zip Notion produces
+ * for *Export → Markdown & CSV* and emits the format-agnostic {@link ImportedDoc}
+ * (see `import.ts`), so {@link importDoc} can land the whole tree through the
+ * existing data paths (Strategy B — a bundle the server id-remaps, link-rewrites,
+ * and name-dedups as one graph).
+ *
+ * **Export shape.** Notion writes a forest of folders + files; every page/database
+ * filename is suffixed with the 32-hex Notion id (dashes stripped):
+ *
+ * ```
+ *  Export-<uuid>/                         ← transparent wrapper (any non-page dir)
+ *    Launch Plan <id>.md                  ← a page
+ *    Launch Plan <id>/                     ← its child pages live here
+ *      Sub Note <id>.md
+ *    Team Tasks <id>.csv                  ← a database (schema + rows)
+ *    Team Tasks <id>/                      ← the database's row pages (bodies)
+ *      Ship v1 <id>.md
+ * ```
+ *
+ *  - **Folder nesting → the page tree.** A `.md` at `A/B/C.md` whose sibling
+ *    folder `A/B/C/` holds more `.md`/`.csv` becomes an {@link ImportedPage} with
+ *    those as `children`. Titles drop the hash suffix.
+ *  - **Each `.md` → blocks** via the merged Markdown importer
+ *    ({@link markdownToImportedDoc}, T2) — reused verbatim, not reparsed.
+ *  - **A `.csv` → an {@link ImportedDatabase}.** Column property types are inferred
+ *    from the cell values (text / number / checkbox / date / select / multi_select
+ *    / url / email — a comma-bearing cell ⇒ multi_select); each row links to its
+ *    `.md` page in the sibling folder for the row body. **Scalar properties only**
+ *    — a CSV cannot encode relation/rollup/formula targets, so those degrade to a
+ *    plain scalar (never a dangling `relation`), the v1 owner decision.
+ *  - **Internal links** (the hash-suffixed relative `.md`/`.csv` path Notion
+ *    writes) resolve to an `@`-mention run when the target was imported; an
+ *    unresolved internal link keeps its visible text (never dropped). External
+ *    `http(s)`/`mailto:` links and file/asset refs are preserved as links.
+ *  - **Icon** — a leading emoji on the page title is lifted to `sys_icon`.
+ *  - **Images/files** — handled by the Markdown importer as the import core's
+ *    {@link imagePlaceholderBlock} / a link run that preserves the ref.
+ *  - **Toggles** — Notion flattens these to a heading/list in Markdown; the
+ *    content survives via T2 (we do not reconstruct an `accordion`, whose
+ *    structure does not survive the export).
+ *
+ * **Never silently drop.** Unknown constructs degrade to text (T2's contract);
+ * any `.md`/`.csv` the tree walk somehow misses is appended as a top-level page;
+ * a row with no matching body still lands with its properties.
+ */
+import { unzipSync, strFromU8 } from 'fflate';
+import { markdownToImportedDoc } from './markdownImport';
+import { IMAGE_PLACEHOLDER_PROP, } from './import';
+import { SELECT_COLORS, shortId, } from './database';
+// ── Path helpers ─────────────────────────────────────────────────────────────
+const baseName = (p) => {
+    const i = p.lastIndexOf('/');
+    return i < 0 ? p : p.slice(i + 1);
+};
+const dirOf = (p) => {
+    const i = p.lastIndexOf('/');
+    return i < 0 ? '' : p.slice(0, i);
+};
+/** Strip a trailing `.md` / `.csv` extension. */
+const stripExt = (p) => p.replace(/\.(md|csv)$/i, '');
+/** The 32-hex Notion id embedded in a file's name, if any (the last such run). */
+const NOTION_ID_G = /[0-9a-f]{32}/gi;
+const idOf = (p) => {
+    const m = stripExt(baseName(p)).match(NOTION_ID_G);
+    return m ? m[m.length - 1].toLowerCase() : null;
+};
+/** A bundle id pinned from a Notion id, so a mention and its target agree. */
+const syntheticId = (notionId) => `imp_n_${notionId}`;
+/** A human title: the basename minus its extension, a trailing `_all` view
+ *  marker (a database exported as its complete view; see {@link dbKeyOf}), and a
+ *  trailing ` <32hex>` Notion id. Stripping `_all` keeps the database name clean
+ *  ("Reading List", not "Reading List <id>_all") when the `_all` view is chosen. */
+const titleOf = (p) => {
+    const stem = stripExt(baseName(p)).replace(/_all$/i, '');
+    return stem.replace(/\s+[0-9a-f]{32}$/i, '').trim() || stem;
+};
+/** Junk the OS / Notion leaves in a zip that is not page content. */
+const isJunk = (p) => p.startsWith('__MACOSX/') || baseName(p) === '.DS_Store' || baseName(p).startsWith('._');
+// ── Leading-emoji icon ───────────────────────────────────────────────────────
+// A leading emoji (with any variation-selector / ZWJ-joined parts) then whitespace.
+const ICON_RE = /^(\p{Extended_Pictographic}(?:\uFE0F|\u200D\p{Extended_Pictographic})*)\s+([\s\S]+)$/u;
+/** Split a leading emoji off a title → `{icon, title}` (icon undefined if none). */
+function splitIcon(title) {
+    const m = ICON_RE.exec(title);
+    if (!m)
+        return { title };
+    return { icon: m[1], title: m[2].trim() };
+}
+// ── CSV parsing ──────────────────────────────────────────────────────────────
+/**
+ * RFC-4180-ish CSV → a matrix of rows. Handles quoted fields containing commas
+ * and newlines, doubled `""` escapes, and CRLF — everything Notion emits.
+ */
+export function parseCsv(text) {
+    const rows = [];
+    let row = [];
+    let field = '';
+    let quoted = false;
+    let i = text.charCodeAt(0) === 0xfeff ? 1 : 0; // skip a BOM
+    const n = text.length;
+    while (i < n) {
+        const ch = text[i];
+        if (quoted) {
+            if (ch === '"') {
+                if (text[i + 1] === '"') {
+                    field += '"';
+                    i += 2;
+                    continue;
+                }
+                quoted = false;
+                i += 1;
+                continue;
+            }
+            field += ch;
+            i += 1;
+            continue;
+        }
+        if (ch === '"') {
+            quoted = true;
+            i += 1;
+        }
+        else if (ch === ',') {
+            row.push(field);
+            field = '';
+            i += 1;
+        }
+        else if (ch === '\n') {
+            row.push(field);
+            rows.push(row);
+            row = [];
+            field = '';
+            i += 1;
+        }
+        else if (ch === '\r') {
+            i += 1;
+        }
+        else {
+            field += ch;
+            i += 1;
+        }
+    }
+    if (field !== '' || row.length > 0) {
+        row.push(field);
+        rows.push(row);
+    }
+    return rows;
+}
+// ── Column type inference ────────────────────────────────────────────────────
+const isBoolish = (v) => /^(yes|no|true|false)$/i.test(v);
+const isNumeric = (v) => /^[+-]?(\d+(\.\d+)?|\.\d+)$/.test(v);
+const isUrl = (v) => /^https?:\/\//i.test(v);
+const isEmail = (v) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(v);
+const isDateish = (v) => /^\d{4}-\d{2}-\d{2}([ T]\d{2}:\d{2})?$/.test(v) || /^[A-Za-z]{3,9}\.?\s+\d{1,2},\s+\d{4}/.test(v);
+const all = (xs, pred) => xs.length > 0 && xs.every(pred);
+/** Infer a scalar property type from a column's non-empty cell values. */
+function inferType(values) {
+    if (values.length === 0)
+        return 'text';
+    if (all(values, isBoolish))
+        return 'checkbox';
+    if (all(values, isNumeric))
+        return 'number';
+    if (all(values, isDateish))
+        return 'date';
+    if (all(values, isUrl))
+        return 'url';
+    if (all(values, isEmail))
+        return 'email';
+    // A comma-bearing cell is a multi-value list → multi_select.
+    if (values.some((v) => v.includes(',')))
+        return 'multi_select';
+    // Low-cardinality with repeats reads as a single-select; all-distinct is freeform.
+    const distinct = new Set(values);
+    if (distinct.size < values.length && distinct.size <= 25)
+        return 'select';
+    return 'text';
+}
+const splitMulti = (v) => v
+    .split(',')
+    .map((s) => s.trim())
+    .filter((s) => s !== '');
+/** Build {@link DatabaseSelectOption}s for a select/multi_select column. */
+function buildOptions(labels) {
+    return labels.map((label, i) => ({ id: shortId('opt'), label, color: SELECT_COLORS[i % SELECT_COLORS.length] }));
+}
+/** A normalised `YYYY-MM-DD` for a date cell, or the raw text if unparseable. */
+function toIsoDate(raw) {
+    const iso = /^(\d{4}-\d{2}-\d{2})/.exec(raw);
+    if (iso)
+        return iso[1];
+    const d = new Date(raw);
+    return Number.isNaN(d.getTime()) ? raw : d.toISOString().slice(0, 10);
+}
+function buildColumn(name, values) {
+    const nonEmpty = values.filter((v) => v !== '');
+    const type = inferType(nonEmpty);
+    const property = { id: shortId('prop'), name: name || 'Untitled', type };
+    const optionByLabel = new Map();
+    if (type === 'select' || type === 'multi_select') {
+        const labels = type === 'multi_select'
+            ? [...new Set(nonEmpty.flatMap(splitMulti))]
+            : [...new Set(nonEmpty.map((v) => v.trim()))];
+        property.options = buildOptions(labels);
+        for (const o of property.options)
+            optionByLabel.set(o.label, o.id);
+    }
+    return { property, optionByLabel };
+}
+/** Coerce a raw cell string into the stored value for its column's type. */
+function coerceCell(raw, col) {
+    const v = raw.trim();
+    if (v === '')
+        return undefined;
+    switch (col.property.type) {
+        case 'number':
+            return Number(v);
+        case 'checkbox':
+            return /^(yes|true)$/i.test(v);
+        case 'date':
+            return toIsoDate(v);
+        case 'select':
+            return col.optionByLabel.get(v);
+        case 'multi_select':
+            return splitMulti(v)
+                .map((label) => col.optionByLabel.get(label))
+                .filter((id) => typeof id === 'string');
+        default:
+            return v; // text / url / email
+    }
+}
+// ── Internal-link resolution ─────────────────────────────────────────────────
+/** A relative href has no URI scheme and is not an in-page anchor. */
+const isRelative = (href) => !/^[a-z][a-z0-9+.-]*:/i.test(href) && !href.startsWith('#');
+const safeDecode = (s) => {
+    try {
+        return decodeURIComponent(s);
+    }
+    catch {
+        return s;
+    }
+};
+/**
+ * Resolve a single href against the imported id set. `change:false` leaves the
+ * run as-is (external URL or file/asset ref — the link, and its ref, are kept).
+ * `change:true` rewrites it: to an `@`-mention when the target was imported, or
+ * to plain text (dropping a dead internal href) when it was not. `attrs` is the
+ * run's existing formatting (bold/italic/…), which is preserved either way.
+ */
+function resolveHref(attrs, href, knownIds, titleById) {
+    if (!isRelative(href))
+        return { change: false }; // external URL — leave as-is
+    const path = safeDecode(href).split('#')[0].split('?')[0];
+    const pointsAtPage = /\.(md|csv)$/i.test(path) || /[0-9a-f]{32}$/i.test(path);
+    if (!pointsAtPage)
+        return { change: false }; // file/asset ref — keep the link, preserve the ref
+    const ids = path.match(NOTION_ID_G);
+    const id = ids ? ids[ids.length - 1].toLowerCase() : null;
+    const rest = { ...attrs };
+    delete rest.a;
+    if (id && knownIds.has(id)) {
+        return { change: true, attrs: { ...rest, m: syntheticId(id) }, text: titleById.get(id) };
+    }
+    // Internal, but the target was not imported: keep the visible text, drop the
+    // dead relative href (never a click-to-nowhere link).
+    return { change: true, attrs: Object.keys(rest).length > 0 ? rest : undefined };
+}
+/** Rewrite link runs across a run list (mentions / preserved links). */
+function resolveRuns(runs, knownIds, titleById) {
+    return runs.map((run) => {
+        const href = run.a?.a;
+        if (!href)
+            return run;
+        const { change, attrs, text } = resolveHref(run.a, href, knownIds, titleById);
+        if (!change)
+            return run; // external URL / asset ref — keep the link + ref
+        const t = run.t !== '' ? run.t : text ?? run.t;
+        return attrs ? { t, a: attrs } : { t };
+    });
+}
+/** Resolve links throughout a block tree (skipping synthetic image placeholders). */
+function resolveLinks(blocks, knownIds, titleById) {
+    return blocks.map((b) => {
+        if (b.props?.[IMAGE_PLACEHOLDER_PROP])
+            return b; // the placeholder's link is a real ref, not a page link
+        const next = { ...b };
+        if (b.text)
+            next.text = resolveRuns(b.text, knownIds, titleById);
+        if (b.children)
+            next.children = resolveLinks(b.children, knownIds, titleById);
+        return next;
+    });
+}
+/** Resolve `rel` against directory `dir`, collapsing `.`/`..` (a tiny posix-join). */
+function joinPath(dir, rel) {
+    const out = [];
+    for (const part of (dir ? dir.split('/') : []).concat(rel.split('/'))) {
+        if (part === '' || part === '.')
+            continue;
+        if (part === '..')
+            out.pop();
+        else
+            out.push(part);
+    }
+    return out.join('/');
+}
+/**
+ * Rewrite each image placeholder's `ref` from the Markdown importer's relative
+ * `src` (e.g. `Page%20abc/image.png`) to the **absolute in-zip path** of the
+ * bytes (`Export-x/Page abc/image.png`), resolved against the source `.md`'s
+ * directory — but only when that entry actually exists in the zip. This lets the
+ * post-import rehydration pass ({@link notionAssetResolver}) find each image's
+ * bytes by a plain `entries[ref]` lookup. An external URL, or a relative ref that
+ * matches no entry, is left untouched (it degrades to a placeholder, ref intact).
+ */
+function resolveImageRefs(blocks, baseDir, hasEntry) {
+    for (const b of blocks) {
+        const meta = b.props?.[IMAGE_PLACEHOLDER_PROP];
+        if (meta?.ref && isRelative(meta.ref)) {
+            const decoded = safeDecode(meta.ref).split('#')[0].split('?')[0];
+            const candidate = joinPath(baseDir, decoded);
+            if (hasEntry(candidate))
+                meta.ref = candidate;
+            else if (hasEntry(decoded))
+                meta.ref = decoded;
+        }
+        if (b.children)
+            resolveImageRefs(b.children, baseDir, hasEntry);
+    }
+}
+/** The row folder a csv's rows live in (a `_all` view shares the plain folder). */
+const dbKeyOf = (csvPath) => stripExt(csvPath).replace(/_all$/i, '');
+/** Direct child `.md` pages of a folder. */
+const childMd = (c, folder) => c.mdPaths.filter((p) => dirOf(p) === folder);
+/** Direct child databases (chosen csvs) of a folder. */
+const childDb = (c, folder) => [...c.csvByKey.values()].filter((p) => dirOf(p) === folder);
+/** Parse a `.md` file → `{icon, title, blocks}` with links resolved. */
+function readPage(c, mdPath) {
+    c.consumed.add(mdPath);
+    const doc = markdownToImportedDoc(c.text(mdPath), { defaultTitle: titleOf(mdPath) });
+    const page = doc.pages[0];
+    const { icon, title } = splitIcon(page.title);
+    const blocks = resolveLinks(page.blocks, c.knownIds, c.titleById);
+    // Point each embedded image at its absolute in-zip path (relative to this .md),
+    // so its bytes can be rehydrated into the asset store after import.
+    resolveImageRefs(blocks, dirOf(mdPath), c.hasEntry);
+    return { icon, title, blocks };
+}
+/** A database row's body: its own blocks plus any sub-pages/sub-dbs flattened in
+ *  (so a row's nested content is never dropped, even though the row IR has no
+ *  child-page slot). */
+function rowBody(c, mdPath) {
+    const blocks = readPage(c, mdPath).blocks;
+    const folder = stripExt(mdPath);
+    for (const sub of childMd(c, folder)) {
+        const page = readPage(c, sub);
+        blocks.push({ type: 'divider' });
+        blocks.push({ type: 'heading', props: { level: 3 }, text: [{ t: page.title }] });
+        blocks.push(...page.blocks);
+    }
+    for (const csv of childDb(c, folder)) {
+        c.consumed.add(csv);
+        const { name, rows } = readDatabase(c, csv);
+        blocks.push({ type: 'heading', props: { level: 3 }, text: [{ t: name }] });
+        for (const r of rows)
+            blocks.push({ type: 'list', props: { kind: 'bullet' }, text: [{ t: r.title }] });
+    }
+    return blocks;
+}
+/** Parse a csv (+ its row folder) into a name, schema, and rows. */
+function readDatabase(c, csvPath) {
+    const name = titleOf(csvPath);
+    const matrix = parseCsv(c.text(csvPath));
+    const header = matrix[0] ?? [];
+    const dataRows = matrix.slice(1).filter((r) => r.some((cell) => cell.trim() !== ''));
+    // Columns: the first column is the row title; the rest become properties.
+    const columns = [];
+    for (let j = 1; j < header.length; j += 1) {
+        columns.push(buildColumn(header[j], dataRows.map((r) => r[j] ?? '')));
+    }
+    const properties = columns.map((col) => col.property);
+    const schema = {
+        properties,
+        views: [{ id: shortId('view'), name: 'Table', type: 'table', filters: [], sorts: [] }],
+    };
+    // Row bodies: the `.md` pages directly in the database's folder, matched by title.
+    const folder = dbKeyOf(csvPath);
+    const bodyByTitle = new Map();
+    for (const md of childMd(c, folder)) {
+        const key = titleOf(md).toLowerCase();
+        const list = bodyByTitle.get(key);
+        if (list)
+            list.push(md);
+        else
+            bodyByTitle.set(key, [md]);
+    }
+    const used = new Set();
+    const takeBody = (title) => {
+        const candidates = bodyByTitle.get(title.trim().toLowerCase());
+        const md = candidates?.find((p) => !used.has(p));
+        if (md)
+            used.add(md);
+        return md;
+    };
+    const rows = dataRows.map((r) => {
+        const title = (r[0] ?? '').trim();
+        const props = {};
+        columns.forEach((col, k) => {
+            const value = coerceCell(r[k + 1] ?? '', col);
+            if (value !== undefined && !(Array.isArray(value) && value.length === 0))
+                props[col.property.id] = value;
+        });
+        const md = takeBody(title);
+        const row = { title, properties: props, blocks: md ? rowBody(c, md) : [] };
+        const nid = md ? idOf(md) : null;
+        if (nid)
+            row.id = syntheticId(nid);
+        return row;
+    });
+    // Any row page with no CSV counterpart still lands (never dropped).
+    for (const md of childMd(c, folder)) {
+        if (used.has(md))
+            continue;
+        used.add(md);
+        const row = { title: titleOf(md), properties: {}, blocks: rowBody(c, md) };
+        const nid = idOf(md);
+        if (nid)
+            row.id = syntheticId(nid);
+        rows.push(row);
+    }
+    return { name, schema, rows };
+}
+/** Build a regular page node (recursing its child pages and databases). */
+function buildPage(c, mdPath) {
+    const { icon, title, blocks } = readPage(c, mdPath);
+    const folder = stripExt(mdPath);
+    const children = [
+        ...childMd(c, folder).map((p) => buildPage(c, p)),
+        ...childDb(c, folder).map((p) => buildDatabasePage(c, p)),
+    ];
+    const page = { title, blocks };
+    const nid = idOf(mdPath);
+    if (nid)
+        page.id = syntheticId(nid);
+    if (icon)
+        page.icon = icon;
+    if (children.length > 0)
+        page.children = children;
+    return page;
+}
+/** Build the host page that carries a database. */
+function buildDatabasePage(c, csvPath) {
+    c.consumed.add(csvPath);
+    const { name, schema, rows } = readDatabase(c, csvPath);
+    const database = { name, schema, rows };
+    const page = { title: name, blocks: [], database };
+    const nid = idOf(csvPath);
+    if (nid)
+        page.id = syntheticId(nid);
+    return page;
+}
+// ── Entry point ──────────────────────────────────────────────────────────────
+/**
+ * Parse a Notion *Markdown & CSV* export zip into an {@link ImportedDoc} ready for
+ * {@link importDoc}. Pure (no client, no I/O beyond the in-memory unzip), so it is
+ * directly unit-testable. Throws only when the bytes are not a readable zip.
+ */
+export function notionExportToImportedDoc(zipBytes) {
+    let entries;
+    try {
+        entries = unzipSync(zipBytes);
+    }
+    catch {
+        throw new Error('not a readable Notion export zip');
+    }
+    const paths = Object.keys(entries).filter((p) => !p.endsWith('/') && !isJunk(p));
+    const text = (path) => strFromU8(entries[path]);
+    const mdPaths = paths.filter((p) => /\.md$/i.test(p));
+    const csvPaths = paths.filter((p) => /\.csv$/i.test(p));
+    // One database per row folder; prefer a `_all` view (it carries every column).
+    const csvByKey = new Map();
+    for (const csv of csvPaths) {
+        const key = dbKeyOf(csv);
+        const current = csvByKey.get(key);
+        if (!current || /_all$/i.test(stripExt(csv)))
+            csvByKey.set(key, csv);
+    }
+    const pageFolders = new Set(mdPaths.map(stripExt));
+    const dbFolders = new Set(csvByKey.keys());
+    // A page/db is a "row descendant" (flattened into its row, not a standalone
+    // node) when it lives *below* a database's row folder rather than directly in
+    // it. Only standalone nodes are mention targets.
+    const isRowDescendant = (p) => [...dbFolders].some((d) => p.startsWith(`${d}/`) && dirOf(p) !== d);
+    const knownIds = new Set();
+    const titleById = new Map();
+    const addNode = (p) => {
+        const id = idOf(p);
+        if (!id)
+            return;
+        titleById.set(id, titleOf(p));
+        if (!isRowDescendant(p))
+            knownIds.add(id);
+    };
+    mdPaths.forEach(addNode);
+    for (const csv of csvByKey.values())
+        addNode(csv);
+    const consumed = new Set();
+    const hasEntry = (p) => Object.prototype.hasOwnProperty.call(entries, p);
+    const corpus = { text, mdPaths, csvByKey, knownIds, titleById, consumed, hasEntry };
+    // Roots: pages/dbs whose parent dir is neither a page folder nor a database
+    // folder — i.e. top-level items (a wrapper like `Export-<uuid>/` is transparent).
+    const isRoot = (p) => !pageFolders.has(dirOf(p)) && !dbFolders.has(dirOf(p));
+    const pages = [];
+    for (const md of mdPaths)
+        if (isRoot(md))
+            pages.push(buildPage(corpus, md));
+    for (const csv of csvByKey.values())
+        if (isRoot(csv))
+            pages.push(buildDatabasePage(corpus, csv));
+    // Safety net: never silently drop a page/db the walk somehow missed.
+    for (const md of mdPaths) {
+        if (consumed.has(md))
+            continue;
+        const { icon, title, blocks } = readPage(corpus, md);
+        const page = { title, blocks };
+        const nid = idOf(md);
+        if (nid)
+            page.id = syntheticId(nid);
+        if (icon)
+            page.icon = icon;
+        pages.push(page);
+    }
+    for (const csv of csvByKey.values()) {
+        if (!consumed.has(csv))
+            pages.push(buildDatabasePage(corpus, csv));
+    }
+    return { pages };
+}
+//# sourceMappingURL=notionImport.js.map

package/dist/notionImport.js.map

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

package/dist/routes.d.ts

@@ -29,6 +29,36 @@ export declare const API: {
     readonly stream: "/api/stream";
     /** SSE stream of a single page's live updates + deletion. */
     readonly pageStream: (id: string) => string;
+    /**
+     * Live collaboration — incremental update ingest (Collab T1). `POST` an opaque
+     * base64 Yjs update `{update, clientId}`; the server fans it out to readers as a
+     * `yupdate` firehose frame (write-gated in, read-gated out) and folds it into an
+     * in-memory relay doc so a late joiner can catch up — but persists NOTHING. The
+     * debounced snapshot save (`PUT /api/pages/:id`) remains the sole durable
+     * checkpoint, so the relay is a best-effort live nudge, never a system of record.
+     */
+    readonly pageUpdates: (id: string) => string;
+    /**
+     * Live collaboration — late-joiner sync handshake (Collab T1). `POST {sv}` (the
+     * client's base64 Yjs state vector); the server replies `{update}` with exactly
+     * the ops the client is missing, computed from the relay doc (seeded from the
+     * durable snapshot + every relayed update since). Read-gated. This is what lets a
+     * client that connects mid-session converge to the CURRENT doc, not just future
+     * edits.
+     */
+    readonly pageSync: (id: string) => string;
+    /**
+     * Live collaboration — ephemeral awareness/presence (Collab T4). `POST` a base64
+     * `y-protocols/awareness` update `{update, clientId}` to publish this client's
+     * presence (cursor / selection); the server **re-stamps the identity** from the
+     * verified principal (so name/colour can't be spoofed via the body) and fans it
+     * out to readers as an `awareness` firehose frame. Unlike `/updates` this is
+     * **read-gated** — a viewer (read, not write) appears present, the T6 "viewers
+     * broadcast presence" behaviour. `GET` returns the current presence snapshot
+     * (`{updates: base64[]}`) so a late joiner sees who's here immediately. Persists
+     * NOTHING — never in the durable snapshot, never in the edit log.
+     */
+    readonly pageAwareness: (id: string) => string;
     /**
      * The multiplexed live stream: one SSE connection carrying every event (page
      * list, page updates/deletions, database rows). Clients open exactly one of
@@ -74,6 +104,23 @@ export declare const API: {
     readonly aiSkill: (name: string) => string;
     readonly plugins: "/api/plugins";
     readonly plugin: (id: string) => string;
+    /**
+     * Upload an asset: `POST /api/assets?pageId=<id>`. The body is the raw binary
+     * (its `Content-Type` header is the stored mime), or — for the in-webview
+     * transports whose bridge corrupts raw binary — a JSON `{data: base64, mime}`.
+     * Write-gated to `pageId` (a page the uploader can write); the asset is ref'd to
+     * that page so it's immediately reachable. 10 MiB cap (413 past it). Returns
+     * `{id}` — the SHA-256 content hash (byte-identical uploads dedup to one id).
+     */
+    readonly assets: "/api/assets";
+    /**
+     * Fetch an asset by its content-hash id. `GET /api/assets/:id` serves the raw
+     * binary with the stored `Content-Type`; `?encoding=base64` returns a JSON
+     * `{id, mime, size, data: base64}` for the in-webview transports. **Read-gated**:
+     * served only to a caller who can read at least one page that references the
+     * asset — otherwise 404 (no existence oracle).
+     */
+    readonly asset: (id: string) => string;
     /** A page's suggestions: `GET` (list, optionally `?status=open`) / `POST` (create). */
     readonly suggestions: (pageId: string) => string;
     /** A single suggestion: `PATCH` (status: accepted/rejected) / `DELETE`. */