@obelism/content 0.0.0-stage → 0.1.0

package/dist/config-c6qktlz6.mjs

@@ -0,0 +1,8 @@
+const DEFAULT_URL = 'https://content.obelism.studio';
+const DELIVERY_PATH = '/api/delivery/v1';
+const DEFAULT_TIMEOUT = 10_000;
+// Origin only, without a trailing slash: what API paths are appended to and
+// what the bridge checks messages against.
+const normalizeUrl = (url)=>new URL(url).origin;
+
+export { DEFAULT_URL as D, DEFAULT_TIMEOUT as a, DELIVERY_PATH as b, normalizeUrl as n };

package/dist/config-ci2hxmas.js

@@ -0,0 +1,13 @@
+const DEFAULT_URL = 'https://content.obelism.studio';
+const DELIVERY_PATH = '/api/delivery/v1';
+const MANAGEMENT_PATH = '/api/management/v1';
+const DEFAULT_TIMEOUT = 10_000;
+// Origin only, without a trailing slash: what API paths are appended to and
+// what the bridge checks messages against.
+const normalizeUrl = (url)=>new URL(url).origin;
+
+exports.DEFAULT_TIMEOUT = DEFAULT_TIMEOUT;
+exports.DEFAULT_URL = DEFAULT_URL;
+exports.DELIVERY_PATH = DELIVERY_PATH;
+exports.MANAGEMENT_PATH = MANAGEMENT_PATH;
+exports.normalizeUrl = normalizeUrl;

package/dist/index.d.mts

@@ -0,0 +1,93 @@
+import { R as RichTextFormat, E as Entry, a as EntryList, M as ModelFile, A as Asset, b as EntryStub, c as RichTextNode } from './types-pa96z6po.js';
+export { B as Block, C as ContentTypeDefinition, d as ContentTypeKind, e as Environment, F as FieldDefinition, f as FieldType, g as RichTextDocument, h as RichTextMark } from './types-pa96z6po.js';
+
+type ContentClientOptions = {
+    token: string;
+    url?: string | undefined;
+    locale?: string | undefined;
+    depth?: number | undefined;
+    richText?: RichTextFormat | undefined;
+    timeout?: number | undefined;
+    init?: RequestInit | undefined;
+    fetch?: typeof fetch | undefined;
+};
+type RequestOptions = {
+    locale?: string | undefined;
+    depth?: number | undefined;
+    richText?: RichTextFormat | undefined;
+    init?: RequestInit | undefined;
+};
+type EntriesQuery = RequestOptions & {
+    contentType?: string | undefined;
+    parentPath?: string | undefined;
+    limit?: number | undefined;
+    skip?: number | undefined;
+};
+declare class ContentClient {
+    #private;
+    readonly url: string;
+    constructor({ token, url, locale, depth, richText, timeout, init, fetch: fetchImpl, }: ContentClientOptions);
+    getPage: <TEntry extends Entry = Entry>(path: string, options?: RequestOptions) => Promise<TEntry | null>;
+    getEntry: <TEntry extends Entry = Entry>(id: string, options?: RequestOptions) => Promise<TEntry | null>;
+    getEntries: <TEntry extends Entry = Entry>({ contentType, parentPath, limit, skip, ...options }?: EntriesQuery) => Promise<EntryList<TEntry>>;
+    getAllEntries<TEntry extends Entry = Entry>(query?: Omit<EntriesQuery, 'skip'>): AsyncGenerator<TEntry, void, undefined>;
+    getContentModel: (options?: Pick<RequestOptions, "init">) => Promise<ModelFile>;
+}
+
+declare const DEFAULT_URL = "https://content.obelism.studio";
+
+declare const UID_ATTRIBUTE = "data-cms-uid";
+declare const ENTRY_ATTRIBUTE = "data-cms-entry";
+type Editable = {
+    'data-cms-uid'?: string;
+    'data-cms-entry'?: string;
+};
+declare const editable: (target: {
+    _uid?: string;
+} | {
+    id: string;
+    fields: unknown;
+} | null | undefined) => Editable;
+
+declare class ContentApiError extends Error {
+    readonly status: number;
+    readonly url: string;
+    readonly body: unknown;
+    constructor(status: number, url: string, body: unknown);
+}
+
+type ImageTransform = {
+    w?: number | undefined;
+    h?: number | undefined;
+    fit?: 'scale-down' | 'contain' | 'cover' | 'crop' | 'pad' | undefined;
+    format?: 'auto' | 'avif' | 'webp' | 'jpeg' | 'png' | undefined;
+    q?: number | undefined;
+};
+declare const imageUrl: (asset: Pick<Asset, "url"> | string, transform?: ImageTransform) => string;
+declare const imageSrcSet: (asset: Pick<Asset, "url"> | string, widths: number[], transform?: Omit<ImageTransform, "w">) => string;
+
+declare const PREVIEW_PARAMS: {
+    readonly preview: "cms_preview";
+    readonly entry: "cms_entry";
+    readonly environment: "cms_environment";
+};
+type PreviewParams = {
+    entryId: string | null;
+    environment: string | null;
+};
+type SearchParamsInput = URL | URLSearchParams | string | Record<string, string | string[] | undefined>;
+declare const readPreviewParams: (input: SearchParamsInput) => PreviewParams | null;
+
+declare const SAFE_HREF: RegExp;
+declare const escapeHtml: (value: string) => string;
+type RichTextHtmlOptions = {
+    renderEntry?: (entry: Entry | EntryStub, node: RichTextNode) => string;
+    renderAsset?: (asset: Asset, node: RichTextNode) => string;
+};
+declare const richTextToHtml: (doc: RichTextNode | null | undefined, { renderEntry, renderAsset }?: RichTextHtmlOptions) => string;
+declare const headingLevel: (node: RichTextNode) => 1 | 2 | 3 | 4 | 5 | 6;
+declare const richTextToPlainText: (doc: RichTextNode | null | undefined) => string;
+
+export { Asset, ContentApiError, ContentClient, DEFAULT_URL, ENTRY_ATTRIBUTE, Entry, EntryList, EntryStub, ModelFile, PREVIEW_PARAMS, RichTextFormat, RichTextNode, SAFE_HREF, UID_ATTRIBUTE, editable, escapeHtml, headingLevel, imageSrcSet, imageUrl, readPreviewParams, richTextToHtml, richTextToPlainText };
+export type { ContentClientOptions, EntriesQuery, ImageTransform, PreviewParams, RequestOptions, RichTextHtmlOptions };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sources":["../src/client.ts","../src/config.ts","../src/editable.ts","../src/errors.ts","../src/images.ts","../src/preview.ts","../src/richText.ts"],"mappings":";;;AACA,KAAK,oBAAoB;AACzB;AACA;AACA;AACA;AACA,eAAe,cAAc;AAC7B;AACA,WAAW,WAAW;AACtB,mBAAmB,KAAK;AACxB;AACA,KAAK,cAAc;AACnB;AACA;AACA,eAAe,cAAc;AAC7B,WAAW,WAAW;AACtB;AACA,KAAK,YAAY,GAAG,cAAc;AAClC;AACA;AACA;AACA;AACA;AACA,cAAc,aAAa;AAC3B;AACA;AACA,2FAA2F,oBAAoB;AAC/G,6BAA6B,KAAK,GAAG,KAAK,0BAA0B,cAAc,KAAK,OAAO;AAC9F,8BAA8B,KAAK,GAAG,KAAK,wBAAwB,cAAc,KAAK,OAAO;AAC7F,gCAAgC,KAAK,GAAG,KAAK,yDAAyD,YAAY,KAAK,OAAO,CAAC,SAAS;AACxI,iCAAiC,KAAK,GAAG,KAAK,UAAU,IAAI,CAAC,YAAY,YAAY,cAAc;AACnG,gCAAgC,IAAI,CAAC,cAAc,cAAc,OAAO,CAAC,SAAS;AAClF;;AChCA,cAAc,WAAW;;ACAzB,cAAc,aAAa;AAC3B,cAAc,eAAe;AAC7B,KAAK,QAAQ;AACb;AACA;AACA;AACA,cAAc,QAAQ;AACtB;AACA;AACA;AACA;AACA,yBAAyB,QAAQ;;ACXjC,cAAc,eAAe,SAAS,KAAK;AAC3C;AACA;AACA;AACA;AACA;;ACJA,KAAK,cAAc;AACnB;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,QAAQ,UAAU,IAAI,CAAC,KAAK,+BAA+B,cAAc;AACvF,cAAc,WAAW,UAAU,IAAI,CAAC,KAAK,iDAAiD,IAAI,CAAC,cAAc;;ACTjH,cAAc,cAAc;AAC5B;AACA;AACA;AACA;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA,KAAK,iBAAiB,GAAG,GAAG,GAAG,eAAe,YAAY,MAAM;AAChE,cAAc,iBAAiB,UAAU,iBAAiB,KAAK,aAAa;;ACT5E,cAAc,SAAS,EAAE,MAAM;AAC/B,cAAc,UAAU;AACxB,KAAK,mBAAmB;AACxB,0BAA0B,KAAK,GAAG,SAAS,QAAQ,YAAY;AAC/D,0BAA0B,KAAK,QAAQ,YAAY;AACnD;AACA,cAAc,cAAc,QAAQ,YAAY,oDAAoD,mBAAmB;AACvH,cAAc,YAAY,SAAS,YAAY;AAC/C,cAAc,mBAAmB,QAAQ,YAAY;;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,93 @@
+import { R as RichTextFormat, E as Entry, a as EntryList, M as ModelFile, A as Asset, b as EntryStub, c as RichTextNode } from './types-pa96z6po.js';
+export { B as Block, C as ContentTypeDefinition, d as ContentTypeKind, e as Environment, F as FieldDefinition, f as FieldType, g as RichTextDocument, h as RichTextMark } from './types-pa96z6po.js';
+
+type ContentClientOptions = {
+    token: string;
+    url?: string | undefined;
+    locale?: string | undefined;
+    depth?: number | undefined;
+    richText?: RichTextFormat | undefined;
+    timeout?: number | undefined;
+    init?: RequestInit | undefined;
+    fetch?: typeof fetch | undefined;
+};
+type RequestOptions = {
+    locale?: string | undefined;
+    depth?: number | undefined;
+    richText?: RichTextFormat | undefined;
+    init?: RequestInit | undefined;
+};
+type EntriesQuery = RequestOptions & {
+    contentType?: string | undefined;
+    parentPath?: string | undefined;
+    limit?: number | undefined;
+    skip?: number | undefined;
+};
+declare class ContentClient {
+    #private;
+    readonly url: string;
+    constructor({ token, url, locale, depth, richText, timeout, init, fetch: fetchImpl, }: ContentClientOptions);
+    getPage: <TEntry extends Entry = Entry>(path: string, options?: RequestOptions) => Promise<TEntry | null>;
+    getEntry: <TEntry extends Entry = Entry>(id: string, options?: RequestOptions) => Promise<TEntry | null>;
+    getEntries: <TEntry extends Entry = Entry>({ contentType, parentPath, limit, skip, ...options }?: EntriesQuery) => Promise<EntryList<TEntry>>;
+    getAllEntries<TEntry extends Entry = Entry>(query?: Omit<EntriesQuery, 'skip'>): AsyncGenerator<TEntry, void, undefined>;
+    getContentModel: (options?: Pick<RequestOptions, "init">) => Promise<ModelFile>;
+}
+
+declare const DEFAULT_URL = "https://content.obelism.studio";
+
+declare const UID_ATTRIBUTE = "data-cms-uid";
+declare const ENTRY_ATTRIBUTE = "data-cms-entry";
+type Editable = {
+    'data-cms-uid'?: string;
+    'data-cms-entry'?: string;
+};
+declare const editable: (target: {
+    _uid?: string;
+} | {
+    id: string;
+    fields: unknown;
+} | null | undefined) => Editable;
+
+declare class ContentApiError extends Error {
+    readonly status: number;
+    readonly url: string;
+    readonly body: unknown;
+    constructor(status: number, url: string, body: unknown);
+}
+
+type ImageTransform = {
+    w?: number | undefined;
+    h?: number | undefined;
+    fit?: 'scale-down' | 'contain' | 'cover' | 'crop' | 'pad' | undefined;
+    format?: 'auto' | 'avif' | 'webp' | 'jpeg' | 'png' | undefined;
+    q?: number | undefined;
+};
+declare const imageUrl: (asset: Pick<Asset, "url"> | string, transform?: ImageTransform) => string;
+declare const imageSrcSet: (asset: Pick<Asset, "url"> | string, widths: number[], transform?: Omit<ImageTransform, "w">) => string;
+
+declare const PREVIEW_PARAMS: {
+    readonly preview: "cms_preview";
+    readonly entry: "cms_entry";
+    readonly environment: "cms_environment";
+};
+type PreviewParams = {
+    entryId: string | null;
+    environment: string | null;
+};
+type SearchParamsInput = URL | URLSearchParams | string | Record<string, string | string[] | undefined>;
+declare const readPreviewParams: (input: SearchParamsInput) => PreviewParams | null;
+
+declare const SAFE_HREF: RegExp;
+declare const escapeHtml: (value: string) => string;
+type RichTextHtmlOptions = {
+    renderEntry?: (entry: Entry | EntryStub, node: RichTextNode) => string;
+    renderAsset?: (asset: Asset, node: RichTextNode) => string;
+};
+declare const richTextToHtml: (doc: RichTextNode | null | undefined, { renderEntry, renderAsset }?: RichTextHtmlOptions) => string;
+declare const headingLevel: (node: RichTextNode) => 1 | 2 | 3 | 4 | 5 | 6;
+declare const richTextToPlainText: (doc: RichTextNode | null | undefined) => string;
+
+export { Asset, ContentApiError, ContentClient, DEFAULT_URL, ENTRY_ATTRIBUTE, Entry, EntryList, EntryStub, ModelFile, PREVIEW_PARAMS, RichTextFormat, RichTextNode, SAFE_HREF, UID_ATTRIBUTE, editable, escapeHtml, headingLevel, imageSrcSet, imageUrl, readPreviewParams, richTextToHtml, richTextToPlainText };
+export type { ContentClientOptions, EntriesQuery, ImageTransform, PreviewParams, RequestOptions, RichTextHtmlOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sources":["../src/client.ts","../src/config.ts","../src/editable.ts","../src/errors.ts","../src/images.ts","../src/preview.ts","../src/richText.ts"],"mappings":";;;AACA,KAAK,oBAAoB;AACzB;AACA;AACA;AACA;AACA,eAAe,cAAc;AAC7B;AACA,WAAW,WAAW;AACtB,mBAAmB,KAAK;AACxB;AACA,KAAK,cAAc;AACnB;AACA;AACA,eAAe,cAAc;AAC7B,WAAW,WAAW;AACtB;AACA,KAAK,YAAY,GAAG,cAAc;AAClC;AACA;AACA;AACA;AACA;AACA,cAAc,aAAa;AAC3B;AACA;AACA,2FAA2F,oBAAoB;AAC/G,6BAA6B,KAAK,GAAG,KAAK,0BAA0B,cAAc,KAAK,OAAO;AAC9F,8BAA8B,KAAK,GAAG,KAAK,wBAAwB,cAAc,KAAK,OAAO;AAC7F,gCAAgC,KAAK,GAAG,KAAK,yDAAyD,YAAY,KAAK,OAAO,CAAC,SAAS;AACxI,iCAAiC,KAAK,GAAG,KAAK,UAAU,IAAI,CAAC,YAAY,YAAY,cAAc;AACnG,gCAAgC,IAAI,CAAC,cAAc,cAAc,OAAO,CAAC,SAAS;AAClF;;AChCA,cAAc,WAAW;;ACAzB,cAAc,aAAa;AAC3B,cAAc,eAAe;AAC7B,KAAK,QAAQ;AACb;AACA;AACA;AACA,cAAc,QAAQ;AACtB;AACA;AACA;AACA;AACA,yBAAyB,QAAQ;;ACXjC,cAAc,eAAe,SAAS,KAAK;AAC3C;AACA;AACA;AACA;AACA;;ACJA,KAAK,cAAc;AACnB;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,QAAQ,UAAU,IAAI,CAAC,KAAK,+BAA+B,cAAc;AACvF,cAAc,WAAW,UAAU,IAAI,CAAC,KAAK,iDAAiD,IAAI,CAAC,cAAc;;ACTjH,cAAc,cAAc;AAC5B;AACA;AACA;AACA;AACA,KAAK,aAAa;AAClB;AACA;AACA;AACA,KAAK,iBAAiB,GAAG,GAAG,GAAG,eAAe,YAAY,MAAM;AAChE,cAAc,iBAAiB,UAAU,iBAAiB,KAAK,aAAa;;ACT5E,cAAc,SAAS,EAAE,MAAM;AAC/B,cAAc,UAAU;AACxB,KAAK,mBAAmB;AACxB,0BAA0B,KAAK,GAAG,SAAS,QAAQ,YAAY;AAC/D,0BAA0B,KAAK,QAAQ,YAAY;AACnD;AACA,cAAc,cAAc,QAAQ,YAAY,oDAAoD,mBAAmB;AACvH,cAAc,YAAY,SAAS,YAAY;AAC/C,cAAc,mBAAmB,QAAQ,YAAY;;","names":[]}

package/dist/index.js

@@ -0,0 +1,300 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var config = require('./config-ci2hxmas.js');
+var preview = require('./preview-by8d54dt.js');
+
+// A response from the API that wasn't a success. `message` is the API's own
+// `error` text when it sent one.
+class ContentApiError extends Error {
+    constructor(status, url, body){
+        const apiMessage = typeof body === 'object' && body !== null && typeof body.error === 'string' ? body.error : null;
+        super(apiMessage ?? `Obelism Content answered ${status} for ${url}`);
+        this.name = 'ContentApiError';
+        this.status = status;
+        this.url = url;
+        this.body = body;
+    }
+}
+
+const trimSlashes = (path)=>path.replace(/^\/+|\/+$/g, '');
+// Reads one space environment's content through the delivery API. The token
+// decides the space, the environment and whether drafts are visible.
+//
+//   const content = new ContentClient({ token: process.env.CONTENT_TOKEN })
+//   const page = await content.getPage('blog/hello', { locale: 'nl' })
+class ContentClient {
+    #token;
+    #defaults;
+    #timeout;
+    #init;
+    #fetch;
+    constructor({ token, url, locale, depth, richText, timeout, init, fetch: fetchImpl }){
+        // The page at a path (`blog/hello`), or null when there is none. A site's
+        // catch-all route asks for this.
+        this.getPage = async (path, options = {})=>{
+            const trimmed = trimSlashes(path);
+            if (!trimmed) throw new Error('getPage needs a path');
+            const result = await this.#request('/pages', {
+                path: trimmed
+            }, options, {
+                notFound: true
+            });
+            return result?.entry ?? null;
+        };
+        // An entry by id, or null when there is none (or it isn't published, for a
+        // delivery token).
+        this.getEntry = async (id, options = {})=>{
+            const result = await this.#request(`/entries/${encodeURIComponent(id)}`, {}, options, {
+                notFound: true
+            });
+            return result?.entry ?? null;
+        };
+        // One page of entries, ordered as in the space's tree.
+        this.getEntries = ({ contentType, parentPath, limit, skip, ...options } = {})=>this.#request('/entries', {
+                contentType,
+                parentPath: parentPath === undefined ? undefined : trimSlashes(parentPath),
+                limit,
+                skip
+            }, options);
+        // The environment's content model, e.g. to generate types in a build.
+        this.getContentModel = (options = {})=>this.#request('/content-model', {}, options, {
+                defaults: false
+            });
+        this.url = config.normalizeUrl(url || config.DEFAULT_URL);
+        this.#token = token;
+        this.#defaults = {
+            locale,
+            depth,
+            richText
+        };
+        this.#timeout = timeout ?? config.DEFAULT_TIMEOUT;
+        this.#init = init;
+        this.#fetch = fetchImpl ?? ((...args)=>fetch(...args));
+    }
+    // Every entry matching the query, fetching pages of `limit` (default 100)
+    // as it goes.
+    //
+    //   for await (const post of content.getAllEntries({ contentType: 'post' }))
+    async *getAllEntries(query = {}) {
+        const limit = query.limit ?? 100;
+        let skip = 0;
+        while(true){
+            const page = await this.getEntries({
+                ...query,
+                limit,
+                skip
+            });
+            yield* page.items;
+            skip += page.items.length;
+            if (page.items.length === 0 || skip >= page.total) return;
+        }
+    }
+    // null for a 404 when `notFound` is set; throws ContentApiError otherwise.
+    async #request(path, query, { init, ...options }, { notFound = false, defaults = true } = {}) {
+        // Checked here rather than in the constructor, so a module creating a
+        // client still loads (and a build still runs) without the variable.
+        if (!this.#token) throw new Error('ContentClient needs a token');
+        const { locale, depth, richText } = {
+            ...defaults && this.#defaults,
+            ...withoutUndefined(options)
+        };
+        const params = new URLSearchParams();
+        const values = {
+            ...query,
+            locale,
+            depth,
+            richtext: richText
+        };
+        for (const [key, value] of Object.entries(values)){
+            if (value !== undefined) params.set(key, String(value));
+        }
+        const search = params.size > 0 ? `?${params}` : '';
+        const url = `${this.url}${config.DELIVERY_PATH}${path}${search}`;
+        const merged = {
+            ...this.#init,
+            ...init
+        };
+        const timeout = AbortSignal.timeout(this.#timeout);
+        const response = await this.#fetch(url, {
+            ...merged,
+            headers: {
+                ...headersToObject(merged.headers),
+                Accept: 'application/json',
+                Authorization: `Bearer ${this.#token}`
+            },
+            signal: merged.signal ? AbortSignal.any([
+                merged.signal,
+                timeout
+            ]) : timeout
+        });
+        if (notFound && response.status === 404) return null;
+        const text = await response.text();
+        let body = text;
+        try {
+            body = JSON.parse(text);
+        } catch  {
+        // Not JSON: keep the text for the error.
+        }
+        if (!response.ok) throw new ContentApiError(response.status, url, body);
+        return body;
+    }
+}
+const withoutUndefined = (value)=>Object.fromEntries(Object.entries(value).filter(([, entry])=>entry !== undefined));
+const headersToObject = (headers)=>headers ? Object.fromEntries(new Headers(headers)) : {};
+
+const KEYS = [
+    'w',
+    'h',
+    'fit',
+    'format',
+    'q'
+];
+// An asset's URL with a resize / re-encode query. PNG, JPEG, GIF, WebP and
+// AVIF are transformed; other files ignore the query.
+//
+//   imageUrl(asset, { w: 800 })
+const imageUrl = (asset, transform = {})=>{
+    const url = new URL(typeof asset === 'string' ? asset : asset.url);
+    for (const key of KEYS){
+        const value = transform[key];
+        if (value !== undefined) url.searchParams.set(key, String(value));
+    }
+    return url.toString();
+};
+// A `srcset` with one candidate per width.
+//
+//   <img src={imageUrl(asset, { w: 960 })}
+//        srcSet={imageSrcSet(asset, [480, 960, 1440])}
+//        sizes="(min-width: 60rem) 50vw, 100vw" />
+const imageSrcSet = (asset, widths, transform = {})=>widths.map((w)=>`${imageUrl(asset, {
+            ...transform,
+            w
+        })} ${w}w`).join(', ');
+
+// Links are only rendered for these; anything else (`javascript:` …) keeps its
+// text without the link. The same rule the CMS validates with.
+const SAFE_HREF = /^(https?:\/\/|mailto:|tel:|#|\/(?!\/))/i;
+const escapeHtml = (value)=>value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+const MARK_TAGS = {
+    bold: 'strong',
+    italic: 'em',
+    underline: 'u',
+    strike: 's',
+    code: 'code'
+};
+const defaultRenderAsset = (asset)=>{
+    const url = escapeHtml(asset.url);
+    if (asset.mimeType.startsWith('image/')) {
+        const alt = typeof asset.alt === 'string' ? asset.alt : '';
+        const size = asset.width && asset.height ? ` width="${asset.width}" height="${asset.height}"` : '';
+        return `<figure><img src="${url}" alt="${escapeHtml(alt)}"${size}></figure>`;
+    }
+    return `<p><a href="${url}">${escapeHtml(asset.filename)}</a></p>`;
+};
+// Rich text JSON (what the delivery API answers by default) to plain, safe
+// HTML — the same HTML the API renders with `richText: 'html'`, except that
+// embeds are up to you.
+const richTextToHtml = (doc, { renderEntry, renderAsset = defaultRenderAsset } = {})=>{
+    if (!doc) return '';
+    const marks = (node, html)=>(node.marks ?? []).reduceRight((inner, mark)=>{
+            if (mark.type === 'link') {
+                const href = String(mark.attrs?.href ?? '');
+                if (!SAFE_HREF.test(href)) return inner;
+                const target = mark.attrs?.target === '_blank' ? ' target="_blank" rel="noopener noreferrer"' : '';
+                const title = mark.attrs?.title ? ` title="${escapeHtml(String(mark.attrs.title))}"` : '';
+                return `<a href="${escapeHtml(href)}"${target}${title}>${inner}</a>`;
+            }
+            const tag = MARK_TAGS[mark.type];
+            return tag ? `<${tag}>${inner}</${tag}>` : inner;
+        }, html);
+    const render = (node)=>{
+        const children = ()=>(node.content ?? []).map(render).join('');
+        switch(node.type){
+            case 'doc':
+                return children();
+            case 'text':
+                return marks(node, escapeHtml(node.text ?? ''));
+            case 'hardBreak':
+                return '<br>';
+            case 'paragraph':
+                return `<p>${children()}</p>`;
+            case 'heading':
+                {
+                    const tag = `h${headingLevel(node)}`;
+                    return `<${tag}>${children()}</${tag}>`;
+                }
+            case 'blockquote':
+                return `<blockquote>${children()}</blockquote>`;
+            case 'bulletList':
+                return `<ul>${children()}</ul>`;
+            case 'orderedList':
+                {
+                    const start = Number(node.attrs?.start ?? 1);
+                    return `<ol${start !== 1 ? ` start="${start}"` : ''}>${children()}</ol>`;
+                }
+            case 'listItem':
+                return `<li>${children()}</li>`;
+            case 'codeBlock':
+                {
+                    const language = node.attrs?.language;
+                    const className = language ? ` class="language-${escapeHtml(String(language))}"` : '';
+                    return `<pre><code${className}>${children()}</code></pre>`;
+                }
+            case 'horizontalRule':
+                return '<hr>';
+            case 'embeddedEntry':
+                {
+                    const entry = node.attrs?.entry;
+                    return entry && renderEntry ? renderEntry(entry, node) : '';
+                }
+            case 'embeddedAsset':
+                {
+                    const asset = node.attrs?.asset;
+                    return asset ? renderAsset(asset, node) : '';
+                }
+            default:
+                return '';
+        }
+    };
+    return render(doc);
+};
+const headingLevel = (node)=>{
+    const level = Number(node.attrs?.level);
+    return level >= 1 && level <= 6 ? level : 2;
+};
+// The text of a document without any markup, e.g. for a meta description.
+const richTextToPlainText = (doc)=>{
+    if (!doc) return '';
+    const BLOCKS = new Set([
+        'paragraph',
+        'heading',
+        'blockquote',
+        'listItem',
+        'codeBlock'
+    ]);
+    const parts = [];
+    const walk = (node)=>{
+        if (node.type === 'text') parts.push(node.text ?? '');
+        else if (node.type === 'hardBreak') parts.push('\n');
+        node.content?.forEach(walk);
+        if (BLOCKS.has(node.type)) parts.push('\n');
+    };
+    walk(doc);
+    return parts.join('').replace(/\n+/g, '\n').trim();
+};
+
+exports.DEFAULT_URL = config.DEFAULT_URL;
+exports.ENTRY_ATTRIBUTE = preview.ENTRY_ATTRIBUTE;
+exports.PREVIEW_PARAMS = preview.PREVIEW_PARAMS;
+exports.UID_ATTRIBUTE = preview.UID_ATTRIBUTE;
+exports.editable = preview.editable;
+exports.readPreviewParams = preview.readPreviewParams;
+exports.ContentApiError = ContentApiError;
+exports.ContentClient = ContentClient;
+exports.SAFE_HREF = SAFE_HREF;
+exports.escapeHtml = escapeHtml;
+exports.headingLevel = headingLevel;
+exports.imageSrcSet = imageSrcSet;
+exports.imageUrl = imageUrl;
+exports.richTextToHtml = richTextToHtml;
+exports.richTextToPlainText = richTextToPlainText;