@book.dev/sdk 1.66.0 → 1.68.0

package/dist/importAssets.js

@@ -0,0 +1,332 @@
+/**
+ * **Import asset rehydration (Assets A4).** Turns the image *placeholders* the
+ * importers emit (see `import.ts` {@link imagePlaceholderBlock}) into real,
+ * rendering `image` blocks — the payoff of OB-ASSETS: an imported picture comes
+ * through for real, not as a callout.
+ *
+ * Two seams, because the bytes arrive two very different ways:
+ *
+ *  - **URL / `data:` images (Markdown · HTML).** These already carry a loadable
+ *    source, so no upload is needed — {@link rehydrateImageUrls} rewrites the
+ *    placeholder to an `image` block whose `src` is the original URL (kept as a
+ *    link) or the inline `data:` URL (which the editor's A2 on-load migration
+ *    then stores). Pure, DOM-free, no client — runnable *before* the doc is
+ *    landed, so the page lands already-correct.
+ *
+ *  - **Embedded bytes (Notion zip · opt-in URL download).** A Notion export holds
+ *    every image's bytes inside the zip; there is no URL to render. So — *after*
+ *    the page is created (we need its id to ref the asset's read-gate) —
+ *    {@link rehydrateStoredImages} resolves each placeholder's `ref` to bytes,
+ *    `putAsset`s them, and rewrites the placeholder to an `image` block holding
+ *    the returned `assetId`. Content-addressed dedup makes a re-import idempotent.
+ *
+ * **Never lose the reference.** If the bytes are missing, over the 10 MiB cap, or
+ * the upload fails, the block degrades rather than dropping: a loadable URL is
+ * preserved as a URL `image` block; anything else keeps its original placeholder
+ * (ref + alt intact). A big import's uploads are processed with bounded
+ * concurrency so the UI is never blocked, and only pages that actually contain a
+ * placeholder are re-read/re-saved (the writers report them in
+ * `ImportWriteResult.placeholderPageIds`).
+ */
+import { unzipSync } from 'fflate';
+import { IMAGE_PLACEHOLDER_PROP } from './import';
+/** The `image` block type — the native picture block the editor ships (A0/A2). */
+export const IMAGE_BLOCK_TYPE = 'image';
+/**
+ * Hard cap on an uploaded asset (10 MiB) — matches the server's asset bodyLimit
+ * (`app.ts` `ASSET_MAX_BYTES`). An import image over this stays a placeholder
+ * rather than failing the whole import.
+ */
+export const DEFAULT_MAX_ASSET_BYTES = 10 * 1024 * 1024;
+// ── ref classification ───────────────────────────────────────────────────────
+const HTTP_RE = /^https?:\/\//i;
+/** Is this an `http(s)` URL — a picture the `image` block can render from `src`? */
+export const isHttpUrl = (s) => HTTP_RE.test(s);
+/** Is this a `data:` URL — inline bytes the editor can render (and A2 migrates)? */
+export const isDataUrlRef = (s) => /^data:/i.test(s);
+/** A loadable source (URL or inline data) the `image` block renders directly. */
+const isLoadableSrc = (s) => isHttpUrl(s) || isDataUrlRef(s);
+/** Rough decoded byte size of a `data:` URL (base64 → 3/4; else the char count). */
+function dataUrlRawBytes(dataUrl) {
+    const comma = dataUrl.indexOf(',');
+    if (comma < 0)
+        return 0;
+    const payload = dataUrl.slice(comma + 1);
+    return /;base64/i.test(dataUrl.slice(0, comma)) ? Math.floor((payload.length * 3) / 4) : payload.length;
+}
+// ── mime from a ref ──────────────────────────────────────────────────────────
+const MIME_BY_EXT = {
+    png: 'image/png',
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+    gif: 'image/gif',
+    webp: 'image/webp',
+    svg: 'image/svg+xml',
+    avif: 'image/avif',
+    bmp: 'image/bmp',
+    ico: 'image/x-icon',
+    tif: 'image/tiff',
+    tiff: 'image/tiff',
+    heic: 'image/heic',
+    heif: 'image/heif',
+};
+/** Guess an image mime from a ref's file extension (defaults to octet-stream). */
+export function mimeFromRef(ref) {
+    const clean = ref.split('#')[0].split('?')[0];
+    const dot = clean.lastIndexOf('.');
+    const ext = dot >= 0 ? clean.slice(dot + 1).toLowerCase() : '';
+    return MIME_BY_EXT[ext] ?? 'application/octet-stream';
+}
+/** Read the {@link PlaceholderMeta} off a block, or `undefined` if it isn't a placeholder. */
+export function imagePlaceholderMeta(block) {
+    return block.props?.[IMAGE_PLACEHOLDER_PROP];
+}
+/**
+ * Rewrite an image *placeholder* into a real `image` block, carrying either the
+ * uploaded `assetId` or a renderable `src`. The placeholder's `alt` becomes the
+ * image alt, its `title` the caption; the deterministic block id is kept so the
+ * rewrite is stable across re-imports.
+ */
+export function importedImageBlock(placeholder, target) {
+    const meta = imagePlaceholderMeta(placeholder) ?? {};
+    const props = { ...target };
+    if (meta.alt)
+        props.alt = meta.alt;
+    if (meta.title)
+        props.caption = meta.title;
+    const block = { type: IMAGE_BLOCK_TYPE, props };
+    if (placeholder.id)
+        block.id = placeholder.id;
+    return block;
+}
+/** Convert an image placeholder to an `image` block when its ref is directly
+ *  loadable; otherwise leave it (recursing container children). */
+function preserveBlock(block, preserveHttp, maxData) {
+    const meta = imagePlaceholderMeta(block);
+    if (meta?.ref) {
+        const ref = meta.ref;
+        if (isHttpUrl(ref) && preserveHttp)
+            return importedImageBlock(block, { src: ref });
+        if (isDataUrlRef(ref) && dataUrlRawBytes(ref) <= maxData)
+            return importedImageBlock(block, { src: ref });
+        return block; // relative / zip-path / over-cap data: → leave for the upload pass
+    }
+    if (block.children && block.children.length > 0) {
+        return { ...block, children: block.children.map((c) => preserveBlock(c, preserveHttp, maxData)) };
+    }
+    return block;
+}
+const preserveRow = (row, preserveHttp, maxData) => ({
+    ...row,
+    ...(row.blocks ? { blocks: row.blocks.map((b) => preserveBlock(b, preserveHttp, maxData)) } : {}),
+    ...(row.children ? { children: row.children.map((c) => preserveRow(c, preserveHttp, maxData)) } : {}),
+});
+const preservePage = (page, preserveHttp, maxData) => ({
+    ...page,
+    blocks: page.blocks.map((b) => preserveBlock(b, preserveHttp, maxData)),
+    ...(page.children ? { children: page.children.map((c) => preservePage(c, preserveHttp, maxData)) } : {}),
+    ...(page.database
+        ? { database: { ...page.database, rows: page.database.rows.map((r) => preserveRow(r, preserveHttp, maxData)) } }
+        : {}),
+});
+/**
+ * **Pass 1 (pure).** Rewrite every image placeholder whose ref is a directly
+ * loadable source — an `http(s)` URL (preserved as a link) or an in-cap `data:`
+ * URL — into a real `image` block, throughout the doc (pages, children, database
+ * rows). No client, no I/O: run this on the IR *before* landing it so the page
+ * arrives already carrying real images. Idempotent (an `image` block isn't a
+ * placeholder, so a re-run is a no-op).
+ */
+export function rehydrateImageUrls(doc, opts = {}) {
+    const preserveHttp = opts.preserveHttpUrls !== false;
+    const maxData = opts.maxDataBytes ?? DEFAULT_MAX_ASSET_BYTES;
+    return { pages: doc.pages.map((p) => preservePage(p, preserveHttp, maxData)) };
+}
+/** Build a limiter that keeps at most `max` calls in flight at once (FIFO queue). */
+function createLimiter(max) {
+    let active = 0;
+    const queue = [];
+    const pump = () => {
+        if (active >= max)
+            return;
+        const run = queue.shift();
+        if (!run)
+            return;
+        active += 1;
+        run();
+    };
+    return (fn) => new Promise((resolve, reject) => {
+        queue.push(() => {
+            fn()
+                .then(resolve, reject)
+                .finally(() => {
+                active -= 1;
+                pump();
+            });
+        });
+        pump();
+    });
+}
+/** Rehydrate a single page's placeholder blocks in place (recursing children). */
+async function rehydratePage(client, pageId, resolve, maxBytes, stats, limit) {
+    let page;
+    try {
+        page = await client.getPage(pageId);
+    }
+    catch {
+        return; // a page we can't read — skip, never crash the import
+    }
+    if (!page)
+        return;
+    const blockdoc = page.data?.blockdoc;
+    const blocks = blockdoc?.blocks;
+    if (!blocks || blocks.length === 0)
+        return;
+    let changed = false;
+    // Resolve + upload one placeholder. Run through the shared `limit` so total
+    // in-flight uploads stay bounded regardless of how many images a page holds
+    // (an image-dense page must not fan out N uploads at once and flood the socket).
+    const rehydrateOne = async (block, ref) => {
+        let resolved = null;
+        try {
+            resolved = await resolve(ref);
+        }
+        catch {
+            resolved = null;
+        }
+        if (resolved && resolved.bytes.byteLength > 0 && resolved.bytes.byteLength <= maxBytes) {
+            try {
+                const { id } = await client.putAsset(resolved.bytes, resolved.mime, pageId);
+                changed = true;
+                stats.uploaded += 1;
+                return importedImageBlock(block, { assetId: id });
+            }
+            catch {
+                // Upload failed (transient / 413) — fall through to the degrade paths.
+            }
+        }
+        // Degrade without dropping: a loadable ref survives as a URL/data image
+        // block; anything else keeps its placeholder (ref + alt intact). An over-cap
+        // `data:` blob is NOT re-inlined — Pass 1 excluded it to protect the CRDT.
+        if (isLoadableSrc(ref) && !(isDataUrlRef(ref) && dataUrlRawBytes(ref) > maxBytes)) {
+            changed = true;
+            stats.preservedUrls += 1;
+            return importedImageBlock(block, { src: ref });
+        }
+        stats.keptPlaceholders += 1;
+        return block;
+    };
+    const mapBlock = async (block) => {
+        const meta = imagePlaceholderMeta(block);
+        if (meta?.ref) {
+            const ref = meta.ref;
+            return limit(() => rehydrateOne(block, ref));
+        }
+        if (block.children && block.children.length > 0) {
+            const kids = await Promise.all(block.children.map(mapBlock));
+            return { ...block, children: kids };
+        }
+        return block;
+    };
+    const next = await Promise.all(blocks.map(mapBlock));
+    if (!changed)
+        return;
+    const data = { ...page.data, blockdoc: { ...(blockdoc ?? {}), blocks: next } };
+    try {
+        await client.savePage({ id: page.id, name: page.name, data });
+    }
+    catch {
+        // A failed re-save leaves the placeholders in place — degraded, not lost.
+    }
+}
+/**
+ * **Pass 2 (post-import).** For each page id carrying an image placeholder (the
+ * writers report these in `ImportWriteResult.placeholderPageIds`), resolve every
+ * placeholder's bytes and — within the size cap — `putAsset` + rewrite it to an
+ * `assetId` `image` block, then re-save the page. A single shared limiter caps
+ * total in-flight uploads (across all pages and all images) so a large,
+ * image-dense import streams rather than flooding the socket. Degrades safely
+ * (never loses a ref); idempotent (a re-run finds real images, not placeholders,
+ * and content-addressed dedup returns the same `assetId`).
+ */
+export async function rehydrateStoredImages(client, pageIds, resolve, opts = {}) {
+    const maxBytes = opts.maxAssetBytes ?? DEFAULT_MAX_ASSET_BYTES;
+    const concurrency = Math.max(1, opts.concurrency ?? 4);
+    const stats = { uploaded: 0, preservedUrls: 0, keptPlaceholders: 0 };
+    const ids = [...new Set(pageIds)];
+    if (ids.length === 0)
+        return stats;
+    // ONE limiter shared across every page: it caps total in-flight uploads, so an
+    // image-dense page can't fan out N `putAsset`s at once (which would flood the
+    // IPC socket / server), independent of how pages/images are distributed.
+    const limit = createLimiter(concurrency);
+    let cursor = 0;
+    let done = 0;
+    const worker = async () => {
+        while (cursor < ids.length) {
+            const pageId = ids[cursor];
+            cursor += 1;
+            await rehydratePage(client, pageId, resolve, maxBytes, stats, limit);
+            done += 1;
+            opts.onProgress?.(done, ids.length);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(concurrency, ids.length) }, worker));
+    return stats;
+}
+// ── Resolvers ────────────────────────────────────────────────────────────────
+/**
+ * Build a resolver over a Notion export zip: a placeholder `ref` (rewritten by
+ * {@link notionExportToImportedDoc} to the absolute in-zip path) → its bytes +
+ * a mime guessed from the extension. Unzips lazily on first use (the import may
+ * land no images), and answers `null` for a ref with no matching entry.
+ */
+export function notionAssetResolver(zipBytes) {
+    let entries = null;
+    const ensure = () => {
+        if (!entries) {
+            try {
+                entries = unzipSync(zipBytes);
+            }
+            catch {
+                entries = {};
+            }
+        }
+        return entries;
+    };
+    return (ref) => {
+        const bytes = ensure()[ref];
+        if (!bytes)
+            return null;
+        return { bytes, mime: mimeFromRef(ref) };
+    };
+}
+/**
+ * Build a resolver that downloads an `http(s)` image `ref` into bytes — the
+ * opt-in "store a copy of each linked image" path. Uses the ambient `fetch` when
+ * no impl is passed. Answers `null` (→ the URL is preserved as a link) for a
+ * non-http ref, a non-OK response, an empty body, or any fetch error — a slow /
+ * failing / cross-origin link degrades rather than breaking the import.
+ */
+export function urlAssetResolver(fetchImpl) {
+    const doFetch = fetchImpl ?? (typeof fetch !== 'undefined' ? fetch : null);
+    return async (ref) => {
+        if (!isHttpUrl(ref) || !doFetch)
+            return null;
+        try {
+            const res = await doFetch(ref);
+            if (!res.ok)
+                return null;
+            const bytes = new Uint8Array(await res.arrayBuffer());
+            if (bytes.byteLength === 0)
+                return null;
+            const headerMime = res.headers?.get('content-type')?.split(';')[0]?.trim();
+            const mime = headerMime && headerMime.startsWith('image/') ? headerMime : mimeFromRef(ref);
+            return { bytes, mime };
+        }
+        catch {
+            return null;
+        }
+    };
+}
+//# sourceMappingURL=importAssets.js.map

package/dist/importAssets.js.map

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

package/dist/index.d.ts

@@ -10,18 +10,22 @@ export { evaluateFormula, formulaReferences, FormulaError, type FormulaValue, ty
 export { OWNER_PROPERTY_ID, VERIFICATION_PROPERTY_ID, BACKLINKS_PROPERTY_ID, THEME_PROPERTY_ID, COVER_PROPERTY_ID, FONTS_PROPERTY_ID, ICON_PROPERTY_ID, FULLWIDTH_PROPERTY_ID, SYSTEM_PAGE_PROPERTIES, isVerified, verificationExpired, isVerificationActive, makeVerification, extractMentionIds, propertiesReferencePage, type VerificationValue, } from './pageProperties';
 export { getServerUrlOverride, setServerUrlOverride, getServerTokenOverride, setServerTokenOverride, getIdentityCredential, setIdentityToken, setGuestName, getForwardingAudience, setForwardingAudience, isMixedContentBlocked } from './connection';
 export { AccountClient, AccountError, DEFAULT_ACCOUNT_URL, getAccountUrlOverride, setAccountUrlOverride, resolveAccountUrl, type AccountSettings, } from './account';
-export { guestPrincipal, localPrincipal, principalId, mintIdentityKeypair, signIdentity, decodeIdentity, verifyIdentity, verifyRevocations, signRevocations, principalFromClaims, unverifiedPrincipalFromClaims, type Principal, type PrincipalKind, type VerifiedVia, type IdentityHeader, type IdentityClaims, type Jwk, type Jwks, type RevocationEntry, type RevocationSet, type IdentityKeypair, type VerifyOptions, type VerifyResult, type VerifyFailure, } from './identity';
+export { guestPrincipal, localPrincipal, principalId, verifiedSubject, colorForIdentity, IDENTITY_COLORS, mintIdentityKeypair, signIdentity, decodeIdentity, verifyIdentity, verifyRevocations, signRevocations, principalFromClaims, unverifiedPrincipalFromClaims, type Principal, type PrincipalKind, type VerifiedVia, type IdentityHeader, type IdentityClaims, type Jwk, type Jwks, type RevocationEntry, type RevocationSet, type IdentityKeypair, type VerifyOptions, type VerifyResult, type VerifyFailure, } from './identity';
 export { DEFAULT_INSTANCE_CONFIG, type GuestAccess, type TrustedIssuerConfig, type InstanceConfig, type InstanceInfo, type StoredEdit, type WorkspaceBinding, type WorkspaceRoster, type WorkspaceRosterEntry, } from './provenance';
 export { authorize, isEmailAuthoritative, type Role, type EffectiveVisibility, type AclEntry, type AccessPage, type AccessCtx, type Decision, } from './authorize';
 export { snapshotText, paragraphBlocks, textSnapshot, appendTextToSnapshot, appendBlocksToSnapshot, type AppendBlock } from './content';
 export { snapshotBlocks, contentHash, computeBlockMtimes, stampSnapshotMtimes, latestBlockMtime, type BlockDigest, } from './mtime';
-export { computeBlockAuthors, stampSnapshotAuthors, latestSnapshotAuthor } from './authors';
+export { computeBlockAuthors, stampSnapshotAuthors, stampSnapshotAuthorsPerBlock, latestSnapshotAuthor, type BlockAuthorResolver, } from './authors';
 export { pageToBookHtml, bookHtmlToPage, readBookHtmlMeta, slugify, type BookPageRecord, } from './bookfile';
 export { spaceToBookFiles, parseBookFolder, SPACE_BUNDLE_FILE, type BookFolderFile, type SpaceSnapshot, } from './bookFolder';
 export { canonicalDigest, generateRegistryKeys, signPlugin, verifyPlugin, validateManifest, OPENBOOK_REGISTRY, type PluginManifest, type PluginAgentTool, type PluginPackage, type PluginSignature, type StoredPlugin, } from './plugins';
 export { buildSampleDocument, seedSampleDocument, SAMPLE_DOCUMENT_NAME } from './sampleDocument';
 export type { CommentRun, AuthoredIdentity, SuggestionAuthorKind, SuggestionKind, SuggestionStatus, SuggestionTarget, StoredSuggestion, SuggestionInput, SuggestionUpdate, StoredComment, CommentInput, } from './suggestions';
 export { PAGE_TEMPLATES, instantiateTemplate, type PageTemplate } from './templates';
+export { imagePlaceholderBlock, imagePlaceholderCell, importedBlocksToSnapshot, chooseStrategy, writeViaCreateApis, buildImportBundle, writeViaBundle, importDoc, IMAGE_PLACEHOLDER_KIND, IMAGE_PLACEHOLDER_PROP, type ImportInlineAttrs, type ImportTextRun, type ImportedBlock, type ImportedAsset, type ImportedRow, type ImportedDatabase, type ImportedPage, type ImportedDoc, type ImportStrategy, type ImportWriteClient, type ImportOptions, type BundleOptions, type ImportWriteResult, blocksHaveImagePlaceholder, } from './import';
+export { markdownToBlocks, markdownToImportedDoc, type MarkdownImportOptions } from './markdownImport';
+export { notionExportToImportedDoc, parseCsv } from './notionImport';
+export { rehydrateImageUrls, rehydrateStoredImages, importedImageBlock, imagePlaceholderMeta, mimeFromRef, notionAssetResolver, urlAssetResolver, isHttpUrl, isDataUrlRef, IMAGE_BLOCK_TYPE, DEFAULT_MAX_ASSET_BYTES, type RehydrateUrlOptions, type RehydrateStoredClient, type RehydrateStoredOptions, type RehydrateStoredResult, type ImportAssetResolver, type AssetBytes, } from './importAssets';
 export { BACKUP_VERSION, BACKUP_CADENCES, BACKUP_CADENCE_MS, DEFAULT_BACKUP_CONFIG, remapBundle, type SpaceBackup, type ImportMode, type ImportRequest, type ImportResult, type BackupCadence, type BackupConfig, type BackupCadenceStatus, type BackupStatus, } from './backup';
 export type { AgentChatEvent, AgentChatMessage, AgentChatOptions, AgentProposal, InterviewStep, AiProvider, AiConfig, AiProviderSettings, AiEffort, AiSkill, AiStatus, AiSearchResult, AiSearchResponse, AiTasksResponse, AiStreamEvent, } from './ai';
 export { providerSettings, isPaidProvider } from './ai';

package/dist/index.js

@@ -7,17 +7,21 @@ export { evaluateFormula, formulaReferences, FormulaError, } from './formula';
 export { OWNER_PROPERTY_ID, VERIFICATION_PROPERTY_ID, BACKLINKS_PROPERTY_ID, THEME_PROPERTY_ID, COVER_PROPERTY_ID, FONTS_PROPERTY_ID, ICON_PROPERTY_ID, FULLWIDTH_PROPERTY_ID, SYSTEM_PAGE_PROPERTIES, isVerified, verificationExpired, isVerificationActive, makeVerification, extractMentionIds, propertiesReferencePage, } from './pageProperties';
 export { getServerUrlOverride, setServerUrlOverride, getServerTokenOverride, setServerTokenOverride, getIdentityCredential, setIdentityToken, setGuestName, getForwardingAudience, setForwardingAudience, isMixedContentBlocked } from './connection';
 export { AccountClient, AccountError, DEFAULT_ACCOUNT_URL, getAccountUrlOverride, setAccountUrlOverride, resolveAccountUrl, } from './account';
-export { guestPrincipal, localPrincipal, principalId, mintIdentityKeypair, signIdentity, decodeIdentity, verifyIdentity, verifyRevocations, signRevocations, principalFromClaims, unverifiedPrincipalFromClaims, } from './identity';
+export { guestPrincipal, localPrincipal, principalId, verifiedSubject, colorForIdentity, IDENTITY_COLORS, mintIdentityKeypair, signIdentity, decodeIdentity, verifyIdentity, verifyRevocations, signRevocations, principalFromClaims, unverifiedPrincipalFromClaims, } from './identity';
 export { DEFAULT_INSTANCE_CONFIG, } from './provenance';
 export { authorize, isEmailAuthoritative, } from './authorize';
 export { snapshotText, paragraphBlocks, textSnapshot, appendTextToSnapshot, appendBlocksToSnapshot } from './content';
 export { snapshotBlocks, contentHash, computeBlockMtimes, stampSnapshotMtimes, latestBlockMtime, } from './mtime';
-export { computeBlockAuthors, stampSnapshotAuthors, latestSnapshotAuthor } from './authors';
+export { computeBlockAuthors, stampSnapshotAuthors, stampSnapshotAuthorsPerBlock, latestSnapshotAuthor, } from './authors';
 export { pageToBookHtml, bookHtmlToPage, readBookHtmlMeta, slugify, } from './bookfile';
 export { spaceToBookFiles, parseBookFolder, SPACE_BUNDLE_FILE, } from './bookFolder';
 export { canonicalDigest, generateRegistryKeys, signPlugin, verifyPlugin, validateManifest, OPENBOOK_REGISTRY, } from './plugins';
 export { buildSampleDocument, seedSampleDocument, SAMPLE_DOCUMENT_NAME } from './sampleDocument';
 export { PAGE_TEMPLATES, instantiateTemplate } from './templates';
+export { imagePlaceholderBlock, imagePlaceholderCell, importedBlocksToSnapshot, chooseStrategy, writeViaCreateApis, buildImportBundle, writeViaBundle, importDoc, IMAGE_PLACEHOLDER_KIND, IMAGE_PLACEHOLDER_PROP, blocksHaveImagePlaceholder, } from './import';
+export { markdownToBlocks, markdownToImportedDoc } from './markdownImport';
+export { notionExportToImportedDoc, parseCsv } from './notionImport';
+export { rehydrateImageUrls, rehydrateStoredImages, importedImageBlock, imagePlaceholderMeta, mimeFromRef, notionAssetResolver, urlAssetResolver, isHttpUrl, isDataUrlRef, IMAGE_BLOCK_TYPE, DEFAULT_MAX_ASSET_BYTES, } from './importAssets';
 export { BACKUP_VERSION, BACKUP_CADENCES, BACKUP_CADENCE_MS, DEFAULT_BACKUP_CONFIG, remapBundle, } from './backup';
 export { providerSettings, isPaidProvider } from './ai';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAC,iBAAiB,EAAE,iBAAiB,EAAC,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAC,GAAG,EAAoC,MAAM,UAAU,CAAC;AAEhE,OAAO,EAAC,cAAc,EAAC,MAAM,UAAU,CAAC;AACxC,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,GAQzB,MAAM,cAAc,CAAC;AAgDtB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,cAAc,EACd,aAAa,EACb,OAAO,EACP,qBAAqB,EACrB,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,cAAc,EACd,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,OAAO,EACP,QAAQ,EACR,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,UAAU,EACV,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,YAAY,GAGb,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,GAExB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAC,oBAAoB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,qBAAqB,EAAC,MAAM,cAAc,CAAC;AACpP,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,GAElB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,cAAc,EACd,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,6BAA6B,GAc9B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,GASxB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,oBAAoB,GAOrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAC,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAmB,MAAM,WAAW,CAAC;AACtI,OAAO,EACL,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GAEjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAC,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAC,MAAM,WAAW,CAAC;AAC1F,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,OAAO,GAER,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAGlB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,GAMlB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAC,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAC,MAAM,kBAAkB,CAAC;AAc/F,OAAO,EAAC,cAAc,EAAE,mBAAmB,EAAoB,MAAM,aAAa,CAAC;AACnF,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,GASZ,MAAM,UAAU,CAAC;AAkBlB,OAAO,EAAC,gBAAgB,EAAE,cAAc,EAAC,MAAM,MAAM,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAC,iBAAiB,EAAE,iBAAiB,EAAC,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAC,GAAG,EAAoC,MAAM,UAAU,CAAC;AAEhE,OAAO,EAAC,cAAc,EAAC,MAAM,UAAU,CAAC;AACxC,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,GAQzB,MAAM,cAAc,CAAC;AAgDtB,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,cAAc,EACd,aAAa,EACb,OAAO,EACP,qBAAqB,EACrB,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,cAAc,EACd,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,OAAO,EACP,QAAQ,EACR,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,UAAU,EACV,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,YAAY,GAGb,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,GAExB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAC,oBAAoB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,qBAAqB,EAAC,MAAM,cAAc,CAAC;AACpP,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,GAElB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,cAAc,EACd,cAAc,EACd,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,6BAA6B,GAc9B,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,uBAAuB,GASxB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,oBAAoB,GAOrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAC,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAmB,MAAM,WAAW,CAAC;AACtI,OAAO,EACL,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GAEjB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,4BAA4B,EAC5B,oBAAoB,GAErB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,OAAO,GAER,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAGlB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,GAMlB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAC,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAC,MAAM,kBAAkB,CAAC;AAc/F,OAAO,EAAC,cAAc,EAAE,mBAAmB,EAAoB,MAAM,aAAa,CAAC;AACnF,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EActB,0BAA0B,GAC3B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAC,gBAAgB,EAAE,qBAAqB,EAA6B,MAAM,kBAAkB,CAAC;AACrG,OAAO,EAAC,yBAAyB,EAAE,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,GAOxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,GASZ,MAAM,UAAU,CAAC;AAkBlB,OAAO,EAAC,gBAAgB,EAAE,cAAc,EAAC,MAAM,MAAM,CAAC"}

package/dist/markdownImport.d.ts

@@ -0,0 +1,79 @@
+/**
+ * **Markdown / GFM → blocks importer.** Turns a CommonMark + GFM source string
+ * into the format-agnostic {@link ImportedDoc} IR (see `import.ts`), so
+ * {@link importDoc} can land it through the existing data paths. A parser's only
+ * job is this transform; it never touches the store, the CRDT, or the wire.
+ *
+ * **Parser choice — `marked`.** It is pure JS with zero runtime dependencies,
+ * ships first-class GFM (tables, task lists, strikethrough, autolinks), and —
+ * crucially — exposes a structured token AST via {@link lexer} (block tokens
+ * carry their inline children in `.tokens`). That lets us map tokens → blocks
+ * directly, with NO DOM. The UI's `htmlToRuns`/`htmlToBlocks` are deliberately
+ * *not* reused: they are `document`-bound (they return stripped plain text when
+ * `document` is undefined) and live in `@book.dev/ui`, which depends on the SDK —
+ * importing them here would invert that dependency. We build runs from marked's
+ * inline tokens instead.
+ *
+ * **Block mapping** (shapes cited from `@book.dev/ui`'s `blockeditor/model.ts`):
+ *
+ *  | Markdown / GFM            | Block (`ImportedBlock`)                         |
+ *  | ------------------------- | ----------------------------------------------- |
+ *  | `# … ######` heading      | `heading` · `props.level` 1–3 (clamped, as editor)|
+ *  | paragraph                 | `paragraph`                                      |
+ *  | `-`/`*`/`+` list          | `list` · `props.kind:'bullet'`                   |
+ *  | `1.` ordered list         | `list` · `props.kind:'number'`                   |
+ *  | nested list item          | flat `list`/`todo` · `props.indent` = depth      |
+ *  | `- [ ]` / `- [x]` task     | `todo` · `props.checked`                         |
+ *  | `>` blockquote            | `quote` (block children folded to its rich text) |
+ *  | ```` ``` ```` fenced code  | `code` · `props.language`                        |
+ *  | GFM table                 | `table` → `row` → `cell` children                |
+ *  | `---` thematic break      | `divider`                                        |
+ *  | `**`/`*`/`~~`/`` ` ``/link | inline `runs` (`{b,i,s,c,a}`)                     |
+ *  | `![alt](src)` image       | {@link imagePlaceholderBlock} (block) / linked run (cell)|
+ *  | raw HTML / unknown        | degrades to a `paragraph` — never dropped        |
+ *
+ * **Images.** An image never vanishes: in body content it becomes the import
+ * core's {@link imagePlaceholderBlock} (preserving `src` + `alt` + `title`); in
+ * a table cell — which can hold only inline text — it becomes a link run to the
+ * `src` carrying the `alt`. **Unknown / unsupported constructs** degrade to a
+ * paragraph of their text, honoring the converter contract that import content
+ * is "never silently dropped" (`model.ts`).
+ *
+ * **Front-matter.** A leading `---` YAML block is read for `title:` (used as the
+ * page title); the remaining lines are passed through verbatim as a `yaml` code
+ * block rather than dropped.
+ */
+import { type ImportedBlock, type ImportedDoc } from './import';
+/** Options for {@link markdownToImportedDoc}. */
+export interface MarkdownImportOptions {
+    /** Explicit page title — overrides front-matter and any leading heading. */
+    title?: string;
+    /** Title used when none can be derived. Default `'Imported document'`. */
+    defaultTitle?: string;
+    /**
+     * When no explicit/front-matter title is given, promote a leading heading to
+     * the page title (consuming it from the body). Default `true`.
+     */
+    firstHeadingAsTitle?: boolean;
+}
+/**
+ * Parse a Markdown/GFM string into {@link ImportedBlock}s. Pure and DOM-free, so
+ * it is directly unit-testable and reusable wherever only the block list is
+ * wanted (e.g. importing a fragment into an existing page). Honors the
+ * "never silently drop content" contract: unknown constructs degrade to text,
+ * images become placeholders.
+ */
+export declare function markdownToBlocks(markdown: string): ImportedBlock[];
+/**
+ * Parse a full Markdown/GFM document into an {@link ImportedDoc} (a single page)
+ * ready for {@link importDoc}. The page title is resolved as:
+ *
+ *  1. `opts.title` (explicit), else
+ *  2. front-matter `title:`, else
+ *  3. a leading heading promoted to the title (consumed from the body) when
+ *     `opts.firstHeadingAsTitle !== false`, else
+ *  4. `opts.defaultTitle` (default `'Imported document'`).
+ *
+ * Any non-title front-matter is preserved as a leading `yaml` code block.
+ */
+export declare function markdownToImportedDoc(markdown: string, opts?: MarkdownImportOptions): ImportedDoc;