@kernhq/module-quire 0.13.1 → 0.15.0

package/dist/server/export/markdown.d.ts

@@ -0,0 +1,51 @@
+/**
+ * A page as Markdown, written from the page document rather than from HTML.
+ *
+ * Two writers, one source. `renderPageDoc` next door draws the same document as HTML; this one draws
+ * it as Markdown, and both read the stored `PageDoc`. Converting the HTML instead would have been
+ * less code and would have thrown away everything a heading, a task and a table know about
+ * themselves — an `<h2>` is a heading, but a `<ul class="kern-tasks">` full of disabled checkboxes is
+ * not a task list to anything that reads it back.
+ *
+ * **Round-tripping is the requirement, not prettiness.** A heading, a list, a table, a code block, a
+ * callout and a task list have to come back as themselves when the file is imported again, so every
+ * one of them is written in the dialect an importer can recognise without guessing:
+ *
+ *   - tables and task lists are GitHub-flavoured Markdown, because that is what every reader
+ *     implements and what an import will parse;
+ *   - a callout is a blockquote with a GitHub alert marker — `> [!WARNING]` — carrying Quire's own
+ *     tone name, so it re-reads as the same callout here and degrades to an ordinary blockquote
+ *     anywhere else. A `<div data-callout>` would round-trip too and would be a raw HTML block in
+ *     every other reader;
+ *   - underline and highlight have no Markdown at all and are written as `<u>` and `<mark>`, which
+ *     is inline HTML a Markdown parser passes through rather than a syntax it will mangle.
+ *
+ * `PAGE_DOC_NODES` is the list this has to cover, the same list `render.ts` is held to, and
+ * `export.int.test.ts` compares this file's table against it in both directions. A node with no
+ * writer here does not degrade quietly — it would lose somebody's table.
+ */
+import type { PageDoc } from '@kernhq/ui/editor/page-doc';
+export interface MarkdownOptions {
+    /**
+     * Where the picture with this id sits *relative to the file being written* — `media/diagram.png`.
+     *
+     * Never a signed storage URL. A presigned GET is the object's key, so it carries the tenant's
+     * workspace uuid and the file's uuid, and it stops working an hour after it is minted: writing one
+     * into a file somebody keeps is both a leak and a broken picture. A picture with no answer here is
+     * dropped, exactly as the HTML renderer drops it.
+     */
+    fileSrc?: (fileId: string) => string | null;
+    /** Where another exported page sits relative to this one. Without one, a mention stays as text. */
+    pageHref?: (pageId: string) => string | null;
+}
+/** Every node type this file can write, for the test that compares it against `PAGE_DOC_NODES`. */
+export declare const MARKDOWN_NODES: readonly string[];
+/**
+ * A stored page as Markdown. An empty or unreadable document is an empty string, never a throw.
+ *
+ * The title is not written here. A page's title is a column, not a node in its document, so whether
+ * it becomes an `# H1` at the top is a decision about the file — and the file writer next door makes
+ * it, once, for both formats.
+ */
+export declare function pageDocToMarkdown(doc: PageDoc | null | undefined, options?: MarkdownOptions): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/server/export/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/server/export/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,OAAO,EAA4B,MAAM,4BAA4B,CAAA;AAEnF,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;IAC3C,mGAAmG;IACnG,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;CAC7C;AAgXD,mGAAmG;AACnG,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAE3C,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,CAKxG"}

package/dist/server/export/markdown.js

@@ -0,0 +1,351 @@
+/**
+ * What a Markdown reader would otherwise take as syntax.
+ *
+ * Deliberately not every character CommonMark lists. Escaping `.`, `+`, `(` and `)` everywhere turns
+ * an ordinary sentence into a thicket of backslashes, and they are only meaningful at the start of a
+ * line or inside a link — both of which are handled where they arise. What is escaped here is what
+ * changes the meaning of a sentence wherever it appears.
+ */
+const escapeInline = (text) => text.replace(/([\\`*_[\]<>|~])/g, '\\$1');
+/**
+ * A line that would start a block if it were left alone — a paragraph beginning `- ` or `# `.
+ *
+ * The ordered-list case is separate because the escape goes in a different place. `\1. ` is not an
+ * escape at all: a backslash before anything that is not punctuation is a literal backslash, so it
+ * would print one and still start a list. `1\. ` is the one that works.
+ */
+const escapeLineStart = (line) => line
+    .replace(/^(\s*)(>|#{1,6}(?=\s)|[-*+](?=\s))/, '$1\\$2')
+    .replace(/^(\s*)(\d{1,9})([.)])(?=\s)/, '$1$2\\$3');
+/** Every character in the node, ignoring marks. What a fence and a `<pre>` want. */
+function textOf(node) {
+    if (typeof node.text === 'string')
+        return node.text;
+    return (node.content ?? []).map(textOf).join('');
+}
+/**
+ * The marks, applied so the result parses.
+ *
+ * Order matters and is not alphabetical. `code` goes on first because a code span's content is
+ * literal — `**bold**` inside backticks is four asterisks and a word — and `link` goes on last
+ * because a link's label may hold everything else and nothing may hold a link.
+ */
+function applyMarks(text, marks) {
+    const has = (type) => (marks ?? []).some((m) => m?.type === type);
+    let out = has('code') ? codeSpan(text) : escapeInline(text);
+    if (has('highlight'))
+        out = `<mark>${out}</mark>`;
+    if (has('strike'))
+        out = `~~${out}~~`;
+    if (has('underline'))
+        out = `<u>${out}</u>`;
+    if (has('italic'))
+        out = `*${out}*`;
+    if (has('bold'))
+        out = `**${out}**`;
+    const link = (marks ?? []).find((m) => m?.type === 'link');
+    if (link) {
+        const href = typeof link.attrs?.href === 'string' ? link.attrs.href : '';
+        if (href)
+            out = `[${out}](${encodeLinkTarget(href)})`;
+    }
+    return out;
+}
+/** A code span whose fence is longer than any run of backticks inside it, so it closes where it should. */
+function codeSpan(text) {
+    const longest = Math.max(0, ...[...text.matchAll(/`+/g)].map((m) => m[0].length));
+    const fence = '`'.repeat(longest + 1);
+    const pad = text.startsWith('`') || text.endsWith('`') ? ' ' : '';
+    return `${fence}${pad}${text}${pad}${fence}`;
+}
+/** Parentheses and whitespace are what break an inline link target; angle brackets fix both. */
+const encodeLinkTarget = (href) => /[\s()<>]/.test(href) ? `<${href.replaceAll('>', '%3E')}>` : href;
+function inline(nodes, options) {
+    return (nodes ?? [])
+        .map((node) => {
+        if (typeof node.text === 'string')
+            return applyMarks(node.text, node.marks);
+        const writer = INLINE_WRITERS[node.type ?? ''];
+        if (writer)
+            return writer(node, options);
+        // An inline node with no writer keeps its text rather than vanishing mid-sentence.
+        return escapeInline(textOf(node));
+    })
+        .join('');
+}
+const INLINE_WRITERS = {
+    // Two trailing spaces is the line break every Markdown reader implements; a backslash is CommonMark
+    // only, and an importer that is not CommonMark would keep the backslash as a character.
+    hardBreak: () => '  \n',
+    text: (node) => escapeInline(node.text ?? ''),
+    /**
+     * A person, as `@Ada` — **and this one does not come back.**
+     *
+     * Stated here because it is the one construct in the writer that is knowingly lossy, and a reader
+     * of this table would otherwise assume the pairing with `import/markdown.ts` is total. A page
+     * mention resolves against a path in the same archive, so the reader can rebuild it; a person
+     * resolves against a *user id*, which is a fact about the instance the export came from. The two
+     * spellings that would carry it are both worse than the loss: putting the id in the file makes an
+     * export identify people, and importing it would mint a mention of a stranger's id in a workspace
+     * that never had that person. So this writes what a mention reads as — the name — and it re-imports
+     * as prose. There is no report row for it either, because by then it is a run of text and nothing
+     * can tell it from one somebody typed.
+     */
+    mention: (node) => `@${escapeInline(String(node.attrs?.label ?? ''))}`,
+    pageMention: (node, options) => {
+        const label = escapeInline(String(node.attrs?.label ?? '') || 'Untitled');
+        const id = typeof node.attrs?.id === 'string' ? node.attrs.id : '';
+        const href = id ? (options.pageHref?.(id) ?? null) : null;
+        // A page that is not in this export cannot be linked to, and a dead link is worse than a name.
+        return href ? `[${label}](${encodeLinkTarget(href)})` : label;
+    },
+    image: (node, options) => {
+        const fileId = typeof node.attrs?.fileId === 'string' ? node.attrs.fileId : null;
+        const resolved = fileId ? (options.fileSrc?.(fileId) ?? null) : null;
+        const src = resolved ?? (typeof node.attrs?.src === 'string' ? node.attrs.src : null);
+        if (!src)
+            return '';
+        const alt = escapeInline(typeof node.attrs?.alt === 'string' ? node.attrs.alt : '');
+        const title = typeof node.attrs?.title === 'string' && node.attrs.title ? node.attrs.title : null;
+        return `![${alt}](${encodeLinkTarget(src)}${title ? ` "${title.replaceAll('"', '\\"')}"` : ''})`;
+    },
+};
+/**
+ * Prefix every line, including the blank ones — which is what makes a nested blockquote hold.
+ *
+ * A blank line gets the prefix trimmed (`>` rather than `> `) and a line with content does not, so
+ * the two trailing spaces that mean "line break" survive. Trimming every line would delete them and
+ * silently join two lines of an address.
+ */
+const prefixLines = (text, first, rest = first) => text
+    .split('\n')
+    .map((line, i) => line.length === 0 ? (i === 0 ? first : rest).trimEnd() : `${i === 0 ? first : rest}${line}`)
+    .join('\n');
+/** Blocks, separated by the blank line that keeps them separate blocks. */
+function blocks(nodes, options) {
+    return (nodes ?? [])
+        .map((node) => block(node, options))
+        .filter((text) => text.length > 0)
+        .join('\n\n');
+}
+function block(node, options) {
+    const writer = BLOCK_WRITERS[node.type ?? ''];
+    if (writer)
+        return writer(node, options);
+    // Unreachable while the test below holds, and correct if a newer image writes a node this one has
+    // never heard of: keep the children rather than losing a paragraph to an unknown wrapper.
+    return blocks(node.content, options);
+}
+/**
+ * A list, whose marker depends on the list and whose continuation depends on the marker.
+ *
+ * Every line after the first is indented by the marker's own width, or the reader ends the item and
+ * starts a paragraph — which is how a two-paragraph bullet becomes a bullet and an orphan.
+ */
+function list(node, options, markerFor) {
+    return (node.content ?? [])
+        .map((item, index) => {
+        const marker = markerFor(index);
+        const body = blocks(item.content, options);
+        // An empty bullet is still a bullet somebody typed, so the marker survives on its own.
+        return body ? prefixLines(body, marker, ' '.repeat(marker.length)) : marker.trimEnd();
+    })
+        .join('\n');
+}
+/** `info` | `note` | `success` | `warning` | `danger`, upper-cased into a GitHub alert marker. */
+const CALLOUT_TONES = new Set(['info', 'note', 'success', 'warning', 'danger']);
+/**
+ * Escape the pipes a cell still has, and only those.
+ *
+ * `escapeInline` already escaped every pipe in ordinary prose, so a blind `replaceAll` would double
+ * them — `Pipe \| here` becomes `Pipe \\| here`, which renders as a backslash and *then* ends the
+ * cell. What is left unescaped is a pipe inside a code span, where escaping is deliberately not
+ * applied — and GFM says a table cell escapes those too, code span or not. So this walks the string,
+ * steps over anything already escaped, and escapes what remains.
+ */
+function escapePipes(text) {
+    let out = '';
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (ch === '\\' && i + 1 < text.length) {
+            out += ch + text[i + 1];
+            i++;
+            continue;
+        }
+        out += ch === '|' ? '\\|' : ch;
+    }
+    return out;
+}
+/**
+ * One cell of a GFM table.
+ *
+ * A cell is inline only — the format has no way to hold a second paragraph — so a paragraph break
+ * becomes `<br><br>`. Losing the block structure inside a cell is the format's limit, and saying so
+ * here is better than a table that stops being a table at the first newline.
+ *
+ * The whitespace before each newline goes with it, and that is not tidiness. A hard break is written
+ * `  \n` — two spaces are what makes it a break in prose — so leaving them in front of the `<br>`
+ * hands the importer a cell whose text ends in two spaces it never had. They are invisible in every
+ * rendering and they *accumulate*: three export-import cycles turned `a` into `a` and six spaces.
+ */
+const tableCell = (cell, options) => escapePipes((blocks(cell.content, options) || '')
+    .replace(/[ \t]*\n{2,}/g, '<br><br>')
+    .replace(/[ \t]*\n/g, '<br>')
+    .trim());
+function table(node, options) {
+    const rows = (node.content ?? []).filter((row) => (row.content ?? []).length > 0);
+    if (rows.length === 0)
+        return '';
+    const width = Math.max(...rows.map((row) => (row.content ?? []).length));
+    const cellsOf = (row) => {
+        const cells = (row.content ?? []).map((cell) => tableCell(cell, options));
+        while (cells.length < width)
+            cells.push('');
+        return cells;
+    };
+    /*
+     * GFM has no table without a header row, so a table whose first row is ordinary cells still
+     * contributes one — its own first row. Emitting an empty header instead would put a blank band at
+     * the top of every table Quire exports, and shift every row's meaning by one on the way back in.
+     */
+    const [head, ...body] = rows;
+    const line = (cells) => `| ${cells.join(' | ')} |`;
+    return [
+        line(cellsOf(head)),
+        line(Array.from({ length: width }, () => '---')),
+        ...body.map((row) => line(cellsOf(row))),
+    ].join('\n');
+}
+const BLOCK_WRITERS = {
+    paragraph: (node, options) => escapeLineStart(inline(node.content, options)),
+    heading: (node, options) => {
+        const raw = Number(node.attrs?.level);
+        const level = Number.isInteger(raw) && raw >= 1 && raw <= 6 ? raw : 1;
+        return `${'#'.repeat(level)} ${inline(node.content, options)}`.trimEnd();
+    },
+    bulletList: (node, options) => list(node, options, () => '- '),
+    orderedList: (node, options) => {
+        const raw = Number(node.attrs?.start);
+        const start = Number.isInteger(raw) && raw > 0 ? raw : 1;
+        return list(node, options, (index) => `${start + index}. `);
+    },
+    listItem: (node, options) => blocks(node.content, options),
+    taskList: (node, options) => (node.content ?? [])
+        .map((item) => {
+        const marker = `- [${item.attrs?.checked === true ? 'x' : ' '}] `;
+        const body = blocks(item.content, options);
+        return body ? prefixLines(body, marker, ' '.repeat(marker.length)) : marker.trimEnd();
+    })
+        .join('\n'),
+    taskItem: (node, options) => blocks(node.content, options),
+    blockquote: (node, options) => prefixLines(blocks(node.content, options), '> '),
+    /**
+     * A GitHub alert: a blockquote whose first line names the tone.
+     *
+     * The tone is Quire's own word rather than GitHub's nearest equivalent, because the round trip
+     * matters more than the rendering on one website. `[!SUCCESS]` is not one of GitHub's five, so it
+     * renders there as a plain blockquote with a line of text at the top — which is a smaller loss
+     * than mapping `success` onto `TIP` and importing it back as the wrong colour.
+     */
+    callout: (node, options) => {
+        const tone = String(node.attrs?.tone ?? 'info');
+        const marker = CALLOUT_TONES.has(tone) ? tone : 'info';
+        return prefixLines(`[!${marker.toUpperCase()}]\n${blocks(node.content, options)}`, '> ');
+    },
+    codeBlock: (node) => {
+        const language = typeof node.attrs?.language === 'string' && /^[a-z0-9#+.-]{1,24}$/i.test(node.attrs.language)
+            ? node.attrs.language
+            : '';
+        const body = textOf(node);
+        // Longer than any run of backticks in the body, or a snippet about Markdown closes its own fence.
+        const longest = Math.max(2, ...[...body.matchAll(/^`{3,}/gm)].map((m) => m[0].length));
+        const fence = '`'.repeat(longest + 1);
+        return `${fence}${language}\n${body}\n${fence}`;
+    },
+    horizontalRule: () => '---',
+    table,
+    // A row or a cell reached on its own is inside a table that has already written it; reaching one
+    // here would mean a malformed document, and its text is better kept than dropped.
+    tableRow: (node, options) => blocks(node.content, options),
+    tableCell: (node, options) => blocks(node.content, options),
+    tableHeader: (node, options) => blocks(node.content, options),
+    /**
+     * A toggle, as the HTML block Markdown has no syntax for.
+     *
+     * The blank lines around the body are load-bearing: without them a Markdown reader treats
+     * everything between the tags as raw HTML and stops parsing the prose inside, so a bulleted list
+     * inside a toggle arrives as literal hyphens.
+     */
+    details: (node, options) => {
+        const summary = (node.content ?? []).find((child) => child.type === 'detailsSummary');
+        const rest = (node.content ?? []).filter((child) => child.type !== 'detailsSummary');
+        const title = summary ? inline(summary.content, options) : '';
+        return `<details>\n<summary>${title}</summary>\n\n${blocks(rest, options)}\n\n</details>`;
+    },
+    detailsSummary: (node, options) => inline(node.content, options),
+    detailsContent: (node, options) => blocks(node.content, options),
+    /*
+     * The macros.
+     *
+     * **A file is not a reader, so no macro that reads other pages writes anything here.** This
+     * writer is handed one document and nothing else — no principal, no publication, no resolver —
+     * which is exactly the state in which the HTML renderer next door draws an empty frame. Writing
+     * a placeholder sentence would be worse than the blank it replaces: an export is a file somebody
+     * keeps, and a line saying "children of this page" that will never fill in is a promise the file
+     * cannot keep. An exporter that grows an audience can pass one to `renderPageDoc` and write the
+     * result; until then the honest output is nothing.
+     *
+     * They are still listed rather than left to the unknown-node fallback, because that fallback
+     * writes a node's children — and `excerpt` has children that must be written, while the five
+     * atoms have none. Naming all eight is what `export.int.test.ts` holds this table to.
+     */
+    pageChildren: () => '',
+    excerptInclude: () => '',
+    includePage: () => '',
+    recentlyUpdated: () => '',
+    contributors: () => '',
+    /*
+     * An excerpt is this page's own prose, so it is written as itself. The marker is lost, which is
+     * the format's limit rather than a decision: Markdown has no way to say "this paragraph is the
+     * quotable one", and an HTML wrapper around it would be a raw block in every other reader.
+     */
+    excerpt: (node, options) => blocks(node.content, options),
+    /*
+     * An expand is a `<details>` like the toggle above it, and for the same reason — Markdown has no
+     * syntax for one. `open` is carried, because the writer stored that decision and a file that
+     * silently closes every section loses it.
+     */
+    expand: (node, options) => {
+        const summary = (node.content ?? []).find((child) => child.type === 'detailsSummary');
+        const rest = (node.content ?? []).filter((child) => child.type !== 'detailsSummary');
+        const title = summary ? inline(summary.content, options) : '';
+        const open = node.attrs?.open === true || node.attrs?.open === 'true' ? ' open' : '';
+        return `<details${open}>\n<summary>${title}</summary>\n\n${blocks(rest, options)}\n\n</details>`;
+    },
+    // Blocks in name only: all three are inline nodes that can also stand alone as a whole block.
+    image: (node, options) => INLINE_WRITERS.image(node, options),
+    hardBreak: () => '',
+    mention: (node, options) => INLINE_WRITERS.mention(node, options),
+    pageMention: (node, options) => INLINE_WRITERS.pageMention(node, options),
+    statusLozenge: (node, options) => INLINE_WRITERS.statusLozenge(node, options),
+    text: (node) => escapeInline(node.text ?? ''),
+};
+/** Every node type this file can write, for the test that compares it against `PAGE_DOC_NODES`. */
+export const MARKDOWN_NODES = [
+    ...new Set(['doc', ...Object.keys(BLOCK_WRITERS), ...Object.keys(INLINE_WRITERS)]),
+];
+/**
+ * A stored page as Markdown. An empty or unreadable document is an empty string, never a throw.
+ *
+ * The title is not written here. A page's title is a column, not a node in its document, so whether
+ * it becomes an `# H1` at the top is a decision about the file — and the file writer next door makes
+ * it, once, for both formats.
+ */
+export function pageDocToMarkdown(doc, options = {}) {
+    if (!doc || !Array.isArray(doc.content))
+        return '';
+    return `${blocks(doc.content, options)
+        .replace(/\n{3,}/g, '\n\n')
+        .trim()}\n`;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/server/export/markdown.js.map

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

package/dist/server/export/pdf.d.ts

@@ -0,0 +1,20 @@
+/** Where the compose stack puts it. `dev/compose.yml` publishes 3500 on the host. */
+export declare const DEFAULT_GOTENBERG_URL = "http://gotenberg:3000";
+export declare const gotenbergUrl: () => string;
+export interface PdfOptions {
+    /** overrides `GOTENBERG_URL`; the export job does not pass one, the test does */
+    url?: string;
+    timeoutMs?: number;
+    /** what Chromium prints in the footer's page numbers, and nothing else */
+    title?: string;
+}
+/**
+ * A complete PDF, or a throw.
+ *
+ * The HTML has to be self-contained. Gotenberg's Chromium fetches whatever the document references,
+ * from inside its own container — so a presigned storage URL in an `<img src>` is both a network
+ * dependency this has no business having and a workspace uuid handed to a process that did not need
+ * it. Pictures reach here as `data:` URIs, put there by the caller.
+ */
+export declare function htmlToPdf(html: string, options?: PdfOptions): Promise<Buffer>;
+//# sourceMappingURL=pdf.d.ts.map

package/dist/server/export/pdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../../src/server/export/pdf.ts"],"names":[],"mappings":"AA2BA,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,0BAA0B,CAAA;AAE5D,eAAO,MAAM,YAAY,QAAO,MAAoE,CAAA;AAQpG,MAAM,WAAW,UAAU;IACzB,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CA2DvF"}

package/dist/server/export/pdf.js

@@ -0,0 +1,91 @@
+/**
+ * HTML to PDF, through Gotenberg.
+ *
+ * Gotenberg is a Chromium in a container, and it is already in the stack: `selfhost/docker-compose.yml`
+ * starts it under `--profile preview`, `dev/compose.yml` publishes it on 3500. Nothing in Kern had
+ * ever called it, so this is the first caller and the first thing that has to answer the question
+ * every optional dependency raises — **what happens when it is not there.**
+ *
+ * The answer is one sentence with three parts, and every one of them is load-bearing:
+ *
+ *   - it never produces a half file. The bytes are read in full, in memory, before anything is
+ *     written anywhere; a refusal, a timeout or a closed port throws before the caller has an
+ *     artefact to store, so an export job goes to `failed` with `file_id` still null rather than to
+ *     `done` with a truncated PDF a reader would find out about by opening it;
+ *   - the failure names the URL it tried and the variable that changes it, because the person who
+ *     reads it is an operator looking at a stack, not a developer looking at a stack trace. "PDF
+ *     export could not reach Gotenberg at http://gotenberg:3000" is actionable; `ECONNREFUSED` is
+ *     not;
+ *   - it is bounded. Chromium rendering a five-hundred-page handbook can take minutes or can hang,
+ *     and a job that hangs holds a worker for ever. The request carries a timeout and gives up.
+ *
+ * The default points at the compose service name rather than at nothing, so an instance that has the
+ * `preview` profile on needs no configuration at all and one that does not gets a refusal naming
+ * `GOTENBERG_URL`.
+ */
+import { KernError } from '@kernhq/kernel';
+/** Where the compose stack puts it. `dev/compose.yml` publishes 3500 on the host. */
+export const DEFAULT_GOTENBERG_URL = 'http://gotenberg:3000';
+export const gotenbergUrl = () => process.env.GOTENBERG_URL?.trim() || DEFAULT_GOTENBERG_URL;
+/** Long enough for a big handbook, short enough that a wedged Chromium is not a wedged worker. */
+const DEFAULT_TIMEOUT_MS = 120_000;
+/** A refusal's body is a diagnostic, not a document: enough to act on, never a page of HTML in a log. */
+const REASON_LIMIT = 400;
+/**
+ * A complete PDF, or a throw.
+ *
+ * The HTML has to be self-contained. Gotenberg's Chromium fetches whatever the document references,
+ * from inside its own container — so a presigned storage URL in an `<img src>` is both a network
+ * dependency this has no business having and a workspace uuid handed to a process that did not need
+ * it. Pictures reach here as `data:` URIs, put there by the caller.
+ */
+export async function htmlToPdf(html, options = {}) {
+    const base = (options.url ?? gotenbergUrl()).replace(/\/+$/, '');
+    const endpoint = `${base}/forms/chromium/convert/html`;
+    const form = new FormData();
+    // The part *must* be named `index.html`; Gotenberg renders that file and treats the rest as assets.
+    form.append('files', new Blob([html], { type: 'text/html' }), 'index.html');
+    form.append('paperWidth', '8.27');
+    form.append('paperHeight', '11.7');
+    form.append('marginTop', '0.6');
+    form.append('marginBottom', '0.6');
+    form.append('marginLeft', '0.6');
+    form.append('marginRight', '0.6');
+    form.append('printBackground', 'true');
+    // Without this a callout's tint and a code block's ground are dropped and the page loses its shape.
+    form.append('preferCssPageSize', 'false');
+    if (options.title)
+        form.append('metadata', JSON.stringify({ Title: options.title, Creator: 'Kern Quire' }));
+    let response;
+    try {
+        response = await fetch(endpoint, {
+            method: 'POST',
+            body: form,
+            signal: AbortSignal.timeout(options.timeoutMs ?? DEFAULT_TIMEOUT_MS),
+        });
+    }
+    catch (err) {
+        const why = err instanceof Error && err.name === 'TimeoutError' ? 'did not answer in time' : 'is not reachable';
+        throw new KernError('UNAVAILABLE', `PDF export needs Gotenberg, and ${base} ${why}. Start it (the self-host stack has it under ` +
+            '`--profile preview`) or point GOTENBERG_URL at one that is running.', { service: 'gotenberg', url: base });
+    }
+    if (!response.ok) {
+        const reason = await response.text().catch(() => '');
+        throw new KernError('UNAVAILABLE', `Gotenberg at ${base} refused to render this page (HTTP ${response.status}). ` +
+            `${reason.slice(0, REASON_LIMIT) || 'It gave no reason.'}`, { service: 'gotenberg', url: base, status: response.status });
+    }
+    const bytes = Buffer.from(await response.arrayBuffer());
+    /*
+     * A zero-length 200 is a real Gotenberg failure mode when Chromium dies mid-render, and it is the
+     * one that would otherwise be stored: an empty file, a job marked `done`, and a person who finds
+     * out by double-clicking it. `%PDF` is four bytes and settles it.
+     */
+    if (bytes.length === 0 || bytes.subarray(0, 4).toString('latin1') !== '%PDF')
+        throw new KernError('UNAVAILABLE', `Gotenberg at ${base} returned something that is not a PDF`, {
+            service: 'gotenberg',
+            url: base,
+            bytes: bytes.length,
+        });
+    return bytes;
+}
+//# sourceMappingURL=pdf.js.map

package/dist/server/export/pdf.js.map

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

package/dist/server/export/zip.d.ts

@@ -0,0 +1,31 @@
+export declare function crc32(data: Uint8Array): number;
+export interface ZipEntry {
+    /** the path inside the archive, `/`-separated and never absolute or `..`-relative */
+    path: string;
+    data: Uint8Array;
+}
+/** What a caller may not exceed, so a refusal can name the number it broke. */
+export declare const ZIP_LIMITS: {
+    maxTotalBytes: number;
+    maxEntryBytes: number;
+    maxEntries: number;
+};
+/**
+ * A path that cannot escape the folder somebody unzips into.
+ *
+ * A page title becomes a folder name, and a title is user input: `../../etc/whatever` is a real
+ * archive somebody can be handed, and a tool that follows it writes outside the extraction
+ * directory. Every segment is cleaned rather than rejected, because refusing an export because
+ * somebody named a page `C:\` would be absurd — but the cleaning is total, so nothing survives that
+ * a reader could resolve upwards.
+ */
+export declare function safeZipPath(path: string): string;
+/**
+ * Every entry, in one buffer.
+ *
+ * Sizes are known before anything is written, so no entry carries a data descriptor and no reader
+ * has to seek backwards — which is what makes the output openable by the strictest tools as well as
+ * by the forgiving ones.
+ */
+export declare function writeZip(entries: ZipEntry[], now?: Date): Buffer;
+//# sourceMappingURL=zip.d.ts.map

package/dist/server/export/zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip.d.ts","sourceRoot":"","sources":["../../../src/server/export/zip.ts"],"names":[],"mappings":"AAqCA,wBAAgB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAI9C;AAkBD,MAAM,WAAW,QAAQ;IACvB,qFAAqF;IACrF,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,CAAA;CACjB;AAED,+EAA+E;AAC/E,eAAO,MAAM,UAAU;;;;CAA4E,CAAA;AAEnG;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAchD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,GAAG,OAAa,GAAG,MAAM,CA4EtE"}