@derive-to/artifacts 0.0.0-stage → 0.6.1

package/dist/host/client.d.ts

@@ -0,0 +1,168 @@
+import { type CallToolResult, type Tool } from "@modelcontextprotocol/client";
+import * as z from "zod/mini";
+import { type Actor, type Artifact, type ArtifactEvent, type ArtifactLayout, type Csp, type ErrorCode, type LinkRole, type Point, type Quote, type Role, type Sharing, type SharingAccess, type SpaceAccess, type TextEdit, type Thread, type ThreadState, type ToolSpec, type Version } from "../protocol/index.js";
+/** Tool contracts a host's client calls by key, such as a plugin's `defineToolSpec`s. */
+export type ToolSpecs = Readonly<Record<string, ToolSpec<z.ZodMiniObject, z.ZodMiniObject>>>;
+/** One typed call per spec: input and output as the spec declares them. */
+export type TypedTools<T extends ToolSpecs> = {
+    readonly [K in keyof T]: (args: z.input<T[K]["input"]>) => Promise<z.output<T[K]["output"]>>;
+};
+export interface ClientOptions<T extends ToolSpecs = ToolSpecs> {
+    /** Where the artifact server is mounted, e.g. `https://app.example.com/api`. */
+    baseUrl: string;
+    /** Defaults to the global fetch. Pass one that adds auth headers if you need them. */
+    fetch?: typeof fetch;
+    /** Defaults to "include" so cookie sessions work across origins. */
+    credentials?: RequestCredentials;
+    /** A live event arrived that this client cannot read (a server newer or broken). The event
+     *  is skipped and the stream stays open. Defaults to the platform's `reportError`. */
+    onError?: (error: unknown) => void;
+    /** Plugin tools to call as `client.tools.<key>(args)`, typed and checked both ways. */
+    tools?: T;
+}
+/** An error the server explained. `status` is the HTTP status. */
+export declare class ArtifactClientError extends Error {
+    readonly status: number;
+    /** The registered code, when the server sent one (see `ERRORS`). */
+    readonly code: ErrorCode | null;
+    constructor(status: number, message: string, code?: ErrorCode | null);
+}
+/** A typed client for `@derive-to/artifacts/server`. Every response is validated. */
+export declare const createArtifactClient: <T extends ToolSpecs = Readonly<Record<string, ToolSpec<z.ZodMiniObject<Readonly<{
+    [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}>, z.core.$strip>, z.ZodMiniObject<Readonly<{
+    [k: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}>, z.core.$strip>>>>>(options: ClientOptions<T>) => {
+    me: () => Promise<Actor | null>;
+    list: () => Promise<Artifact[]>;
+    /** One page, newest first; pass `next` back for the following page (null at the end). */
+    listPage: (page?: {
+        limit?: number;
+        cursor?: string;
+        search?: string;
+        mine?: boolean;
+    }) => Promise<{
+        artifacts: {
+            id: string;
+            title: string;
+            currentVersion: number;
+            createdAt: string;
+            updatedAt: string;
+            createdBy: {
+                id: string;
+                name: string;
+                avatarUrl?: string | undefined;
+            };
+            updatedBy: {
+                id: string;
+                name: string;
+                avatarUrl?: string | undefined;
+            };
+            summary: string;
+            kind: "page" | "slides";
+            activity: {
+                openThreads: number;
+                threads: number;
+                people: {
+                    id: string;
+                    name: string;
+                    avatarUrl?: string | undefined;
+                }[];
+            };
+            can: ("comment" | "edit" | "interact" | "manage" | "view")[];
+            features: string[];
+        }[];
+        next: string | null;
+    }>;
+    get: (id: string) => Promise<Artifact>;
+    create: (input: {
+        title: string;
+        html: string;
+        csp?: Csp;
+    }) => Promise<Artifact>;
+    /** Rename without a new version. Needs edit access. */
+    rename: (id: string, title: string) => Promise<Artifact>;
+    /** Delete for good, with its versions and comments. Needs manage access. */
+    remove: (id: string) => Promise<void>;
+    versions: (id: string) => Promise<Version[]>;
+    publish: (id: string, input: {
+        html: string;
+        csp?: Csp;
+        expected: number;
+    }) => Promise<{
+        n: number;
+        createdAt: string;
+        createdBy: {
+            id: string;
+            name: string;
+            avatarUrl?: string | undefined;
+        };
+        csp: {
+            connectDomains?: string[] | undefined;
+            resourceDomains?: string[] | undefined;
+            frameDomains?: string[] | undefined;
+            baseUriDomains?: string[] | undefined;
+        };
+    }>;
+    /** Publish version `n`'s content again as the newest version. */
+    restore: (id: string, n: number) => Promise<Version>;
+    content: (id: string, n: number) => Promise<{
+        html: string;
+        csp: Csp;
+    }>;
+    /** Download a saved edition as portable HTML. Uses the same authenticated transport. */
+    exportHtml: (id: string, n: number) => Promise<File>;
+    /** Whether this reader may change sharing, and the roles they may give. */
+    sharingAccess: (id: string) => Promise<SharingAccess>;
+    sharing: (id: string) => Promise<Sharing>;
+    setSharing: (id: string, change: {
+        spaceAccess?: SpaceAccess;
+        linkRole?: LinkRole;
+    }) => Promise<Sharing>;
+    grant: (id: string, actor: Actor, role: Role) => Promise<Sharing>;
+    revoke: (id: string, actorId: string) => Promise<Sharing>;
+    /** A new link token: everyone holding the old one loses access. */
+    resetLink: (id: string) => Promise<Sharing>;
+    threads: (id: string) => Promise<Thread[]>;
+    startThread: (id: string, input: {
+        body: string;
+        quote: Quote | null;
+        version: number;
+    }) => Promise<{
+        id: string;
+        state: "open" | "outdated" | "resolved";
+        comments: {
+            id: string;
+            threadId: string;
+            version: number;
+            quote: {
+                exact: string;
+                prefix: string;
+                suffix: string;
+                element?: string | undefined;
+                sourceSelector?: string | undefined;
+            } | null;
+            body: string;
+            author: {
+                id: string;
+                name: string;
+                avatarUrl?: string | undefined;
+            };
+            createdAt: string;
+        }[];
+    }>;
+    reply: (id: string, threadId: string, body: string) => Promise<Thread>;
+    setThreadState: (id: string, threadId: string, state: ThreadState) => Promise<Thread>;
+    listTools: () => Promise<Tool[]>;
+    callTool: (name: string, args: Record<string, unknown>) => Promise<CallToolResult>;
+    /** Save text edits as a new version (the editing plugin). Throws the server's reason. */
+    editText: (id: string, expected: number, edits: TextEdit[], layout?: ArtifactLayout) => Promise<Version>;
+    presence: (id: string, cursor: Point | null) => Promise<void>;
+    /** Live events for one artifact. Returns an unsubscribe. */
+    subscribe: (id: string, onEvent: (event: ArtifactEvent) => void) => (() => void);
+    tools: TypedTools<T>;
+};
+/** The client the kit's components take: every call but the typed tools, so a client built
+ *  with any `tools` fits. */
+export type ArtifactClient = Omit<ReturnType<typeof createArtifactClient>, "tools">;
+//# sourceMappingURL=client.d.ts.map

package/dist/host/client.d.ts.map

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

package/dist/host/client.js

@@ -0,0 +1,214 @@
+import { Client, StreamableHTTPClientTransport, } from "@modelcontextprotocol/client";
+import * as z from "zod/mini";
+import { actorSchema, artifactSchema, cspSchema, EXTENSION_VERSION, eventSchema, isErrorCode, sharingAccessSchema, sharingSchema, threadSchema, versionSchema, } from "../protocol/index.js";
+import { openStream } from "./sse.js";
+/** An error the server explained. `status` is the HTTP status. */
+export class ArtifactClientError extends Error {
+    status;
+    /** The registered code, when the server sent one (see `ERRORS`). */
+    code;
+    constructor(status, message, code = null) {
+        super(message);
+        this.name = "ArtifactClientError";
+        this.status = status;
+        this.code = code;
+    }
+}
+const errorBody = z.object({ error: z.string(), code: z.optional(z.string()) });
+const responseError = (response, body) => {
+    const parsed = errorBody.safeParse(body);
+    const code = parsed.success && isErrorCode(parsed.data.code) ? parsed.data.code : null;
+    return new ArtifactClientError(response.status, parsed.success ? parsed.data.error : response.statusText, code);
+};
+const transport = (options) => {
+    const base = options.baseUrl.replace(/\/$/, "");
+    const fetcher = options.fetch ?? globalThis.fetch.bind(globalThis);
+    const init = { credentials: options.credentials ?? "include" };
+    const path = (...parts) => `${base}/${parts.map((part) => encodeURIComponent(String(part))).join("/")}`;
+    /** One validated JSON call. Every response is parsed against its schema. */
+    const call = async (schema, url, method = "GET", body) => {
+        const request = { ...init, method };
+        if (body !== undefined) {
+            request.body = JSON.stringify(body);
+            request.headers = { "content-type": "application/json" };
+        }
+        const response = await fetcher(url, request);
+        const json = response.status === 204 ? {} : await response.json().catch(() => ({}));
+        if (!response.ok)
+            throw responseError(response, json);
+        return schema.parse(json);
+    };
+    const report = options.onError ?? ((error) => globalThis.reportError?.(error));
+    return { call, path, fetcher, init, base, report };
+};
+const one = z.object({ artifact: artifactSchema });
+const versionBody = z.object({ version: versionSchema });
+const contentBody = z.object({ html: z.string(), csp: cspSchema });
+const artifactCalls = ({ call, path, fetcher, init }) => ({
+    me: async () => (await call(z.object({ actor: z.nullable(actorSchema) }), path("me"))).actor,
+    list: async () => (await call(z.object({ artifacts: z.array(artifactSchema) }), path("artifacts"))).artifacts,
+    /** One page, newest first; pass `next` back for the following page (null at the end). */
+    listPage: (page = {}) => call(z.object({ artifacts: z.array(artifactSchema), next: z.nullable(z.string()) }), `${path("artifacts")}?${new URLSearchParams(Object.entries(page).map(([key, value]) => [key, String(value)]))}`),
+    get: async (id) => (await call(one, path("artifacts", id))).artifact,
+    create: async (input) => (await call(one, path("artifacts"), "POST", input)).artifact,
+    /** Rename without a new version. Needs edit access. */
+    rename: async (id, title) => (await call(one, path("artifacts", id), "PATCH", { title })).artifact,
+    /** Delete for good, with its versions and comments. Needs manage access. */
+    remove: async (id) => {
+        await call(z.object({}), path("artifacts", id), "DELETE");
+    },
+    versions: async (id) => (await call(z.object({ versions: z.array(versionSchema) }), path("artifacts", id, "versions")))
+        .versions,
+    publish: async (id, input) => (await call(versionBody, path("artifacts", id, "versions"), "POST", input)).version,
+    /** Publish version `n`'s content again as the newest version. */
+    restore: async (id, n) => (await call(versionBody, path("artifacts", id, "versions", n, "restore"), "POST", {})).version,
+    content: (id, n) => call(contentBody, path("artifacts", id, "versions", n, "content")),
+    /** Download a saved edition as portable HTML. Uses the same authenticated transport. */
+    exportHtml: async (id, n) => {
+        const response = await fetcher(path("artifacts", id, "versions", n, "export"), init);
+        if (!response.ok) {
+            throw responseError(response, await response.json().catch(() => ({})));
+        }
+        const encoded = response.headers
+            .get("content-disposition")
+            ?.match(/filename\*=UTF-8''([^;]+)/i)?.[1];
+        const name = encoded ? decodeURIComponent(encoded) : `artifact-v${n}.html`;
+        const blob = await response.blob();
+        return new File([blob], name, { type: blob.type });
+    },
+});
+const sharingBody = z.object({ sharing: sharingSchema });
+/** The sharing piece's routes (`@derive-to/artifacts/server/sharing`). Each answers with the
+ *  settings and grants as they now are, so a UI shows what the server holds. */
+const sharingCalls = ({ call, path }) => ({
+    /** Whether this reader may change sharing, and the roles they may give. */
+    sharingAccess: async (id) => call(sharingAccessSchema, path("artifacts", id, "sharing", "access")),
+    sharing: async (id) => (await call(sharingBody, path("artifacts", id, "sharing"))).sharing,
+    setSharing: async (id, change) => (await call(sharingBody, path("artifacts", id, "sharing"), "PATCH", change)).sharing,
+    grant: async (id, actor, role) => (await call(sharingBody, path("artifacts", id, "sharing", "grants", actor.id), "PUT", {
+        actor,
+        role,
+    })).sharing,
+    revoke: async (id, actorId) => (await call(sharingBody, path("artifacts", id, "sharing", "grants", actorId), "DELETE"))
+        .sharing,
+    /** A new link token: everyone holding the old one loses access. */
+    resetLink: async (id) => (await call(sharingBody, path("artifacts", id, "sharing", "link"), "POST")).sharing,
+});
+const threadBody = z.object({ thread: threadSchema });
+const threadCalls = ({ call, path }) => ({
+    threads: async (id) => (await call(z.object({ threads: z.array(threadSchema) }), path("artifacts", id, "threads")))
+        .threads,
+    startThread: async (id, input) => (await call(threadBody, path("artifacts", id, "threads"), "POST", input)).thread,
+    reply: async (id, threadId, body) => (await call(threadBody, path("artifacts", id, "threads", threadId, "comments"), "POST", {
+        body,
+    })).thread,
+    setThreadState: async (id, threadId, state) => (await call(threadBody, path("artifacts", id, "threads", threadId), "PATCH", { state })).thread,
+});
+/** The server's MCP tools, through the official client: the same door agents and other MCP
+ *  Apps hosts use, so a plugin's tools need no client code. Connects on first use. */
+const toolCalls = ({ base, fetcher, init }) => {
+    let connected = null;
+    let listed = null;
+    const connect = () => {
+        connected ??= (async () => {
+            const client = new Client({ name: "open-artifact-host", version: EXTENSION_VERSION });
+            const url = new URL(`${base}/mcp`, globalThis.location?.href);
+            await client.connect(new StreamableHTTPClientTransport(url, { fetch: fetcher, requestInit: init }));
+            return client;
+        })().catch((error) => {
+            connected = null;
+            throw error;
+        });
+        return connected;
+    };
+    return {
+        listTools: () => {
+            listed ??= connect()
+                .then(async (client) => (await client.listTools()).tools)
+                .catch((error) => {
+                listed = null;
+                throw error;
+            });
+            return listed;
+        },
+        callTool: async (name, args) => (await connect()).callTool({ name, arguments: args }),
+        /** Save text edits as a new version (the editing plugin). Throws the server's reason. */
+        editText: async (id, expected, edits, layout) => {
+            const result = await (await connect()).callTool({
+                name: "artifact_edit_text",
+                arguments: { artifactId: id, expected, edits, ...(layout ? { layout } : {}) },
+            });
+            if (result.isError) {
+                const first = result.content[0];
+                throw new ArtifactClientError(400, first?.type === "text" ? first.text : "Not saved.");
+            }
+            return versionBody.parse(result.structuredContent).version;
+        },
+    };
+};
+/** One live event, parsed; anything else is reported and skipped. */
+const readEvent = (data, report) => {
+    try {
+        return eventSchema.parse(JSON.parse(data));
+    }
+    catch (error) {
+        report(new Error("A live event could not be read; it was skipped.", { cause: error }));
+        return null;
+    }
+};
+const liveCalls = ({ call, path, fetcher, init, report }) => ({
+    presence: async (id, cursor) => {
+        await call(z.object({}), path("artifacts", id, "presence"), "POST", { cursor });
+    },
+    /** Live events for one artifact. Returns an unsubscribe. */
+    subscribe: (id, onEvent) => openStream({
+        url: path("artifacts", id, "events"),
+        init,
+        fetch: fetcher,
+        onData: (data) => {
+            const event = readEvent(data, report);
+            if (event)
+                onEvent(event);
+        },
+    }),
+});
+/** A refused tool call as the client's own error, with its registered code. */
+const toolError = (result) => {
+    const body = errorBody.safeParse(result.structuredContent);
+    const first = result.content[0];
+    const message = body.success
+        ? body.data.error
+        : first?.type === "text"
+            ? first.text
+            : "The tool refused.";
+    const code = body.success && isErrorCode(body.data.code) ? body.data.code : null;
+    return new ArtifactClientError(400, message, code);
+};
+/** `client.tools`: each spec's input is checked before it is sent, its output after. */
+const typedTools = (specs, call) => {
+    const entries = Object.entries(specs ?? {}).map(([key, spec]) => [
+        key,
+        async (args) => {
+            const result = await call(spec.name, spec.input.parse(args));
+            if (result.isError)
+                throw toolError(result);
+            return spec.output.parse(result.structuredContent);
+        },
+    ]);
+    // Object.fromEntries loses the pairing of each key with its spec that the map keeps.
+    return Object.fromEntries(entries);
+};
+/** A typed client for `@derive-to/artifacts/server`. Every response is validated. */
+export const createArtifactClient = (options) => {
+    const t = transport(options);
+    const tools = toolCalls(t);
+    return {
+        ...artifactCalls(t),
+        ...threadCalls(t),
+        ...sharingCalls(t),
+        ...tools,
+        ...liveCalls(t),
+        tools: typedTools(options.tools, tools.callTool),
+    };
+};
+//# sourceMappingURL=client.js.map

package/dist/host/client.js.map

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

package/dist/host/emitter.d.ts

@@ -0,0 +1,7 @@
+/** A minimal typed event emitter. */
+export declare const createEmitter: <Events extends Record<string, unknown>>() => {
+    on: <K extends keyof Events>(event: K, listener: (payload: Events[K]) => void) => () => boolean;
+    emit: <K extends keyof Events>(event: K, payload: Events[K]) => void;
+    clear: () => void;
+};
+//# sourceMappingURL=emitter.d.ts.map

package/dist/host/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/host/emitter.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,eAAO,MAAM,aAAa,GAAI,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAGhE,EAAE,GAAG,CAAC,SAAS,MAAM,MAAM,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;IAM7E,IAAI,GAAG,CAAC,SAAS,MAAM,MAAM,SAAS,CAAC,WAAW,MAAM,CAAC,CAAC,CAAC;IAI3D,KAAK;CAER,CAAA"}

package/dist/host/emitter.js

@@ -0,0 +1,18 @@
+/** A minimal typed event emitter. */
+export const createEmitter = () => {
+    const listeners = new Map();
+    return {
+        on: (event, listener) => {
+            const set = listeners.get(event) ?? new Set();
+            set.add(listener);
+            listeners.set(event, set);
+            return () => set.delete(listener);
+        },
+        emit: (event, payload) => {
+            for (const listener of listeners.get(event) ?? [])
+                listener(payload);
+        },
+        clear: () => listeners.clear(),
+    };
+};
+//# sourceMappingURL=emitter.js.map

package/dist/host/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/host/emitter.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,MAAM,CAAC,MAAM,aAAa,GAAG,GAA2C,EAAE;IACxE,MAAM,SAAS,GAAG,IAAI,GAAG,EAA+C,CAAA;IACxE,OAAO;QACL,EAAE,EAAE,CAAyB,KAAQ,EAAE,QAAsC,EAAE,EAAE;YAC/E,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,EAAE,CAAA;YAC7C,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACjB,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YACzB,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACnC,CAAC;QACD,IAAI,EAAE,CAAyB,KAAQ,EAAE,OAAkB,EAAE,EAAE;YAC7D,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;gBAC9C,QAAmC,CAAC,OAAO,CAAC,CAAA;QACjD,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE;KAC/B,CAAA;AACH,CAAC,CAAA"}

package/dist/host/index.d.ts

@@ -0,0 +1,7 @@
+export type { McpUiHostContext as HostContext } from "@modelcontextprotocol/ext-apps/app-bridge";
+export type { ViewEvents } from "./bridge.js";
+export { type ArtifactClient, ArtifactClientError, type ClientOptions, createArtifactClient, type ToolSpecs, type TypedTools, } from "./client.js";
+export { createLiveChannel, type LiveChannel, type LiveChannelOptions } from "./live.js";
+export { printHtml } from "./print.js";
+export { type ArtifactView, type ArtifactViewOptions, mountArtifact } from "./view.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/host/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/host/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,IAAI,WAAW,EAAE,MAAM,2CAA2C,CAAA;AAChG,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EACL,KAAK,cAAc,EACnB,mBAAmB,EACnB,KAAK,aAAa,EAClB,oBAAoB,EACpB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAA;AACxF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA"}

package/dist/host/index.js

@@ -0,0 +1,5 @@
+export { ArtifactClientError, createArtifactClient, } from "./client.js";
+export { createLiveChannel } from "./live.js";
+export { printHtml } from "./print.js";
+export { mountArtifact } from "./view.js";
+//# sourceMappingURL=index.js.map

package/dist/host/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/host/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,mBAAmB,EAEnB,oBAAoB,GAGrB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,iBAAiB,EAA6C,MAAM,WAAW,CAAA;AACxF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAA+C,aAAa,EAAE,MAAM,WAAW,CAAA"}

package/dist/host/live.d.ts

@@ -0,0 +1,18 @@
+import type { ArtifactEvent } from "../protocol/index.js";
+import type { ArtifactClient } from "./client.js";
+export interface LiveChannel {
+    subscribe(listener: (event: ArtifactEvent) => void): () => void;
+    /** Tell this page's listeners about a change it made itself, so the page updates without
+     *  waiting for the event stream, which some hosts cannot keep open. */
+    announce(event: ArtifactEvent): void;
+    close(): void;
+}
+export interface LiveChannelOptions {
+    /** Open the server's event stream. Off for a server without live updates (its artifacts
+     *  do not list the `live` feature): the channel then carries this page's own changes. */
+    stream?: boolean;
+}
+/** One event stream per artifact, shared by everything on the page that needs it. The
+ *  connection opens with the first subscriber and closes with the last. */
+export declare const createLiveChannel: (client: ArtifactClient, artifactId: string, { stream }?: LiveChannelOptions) => LiveChannel;
+//# sourceMappingURL=live.d.ts.map

package/dist/host/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/host/live.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAC/D;2EACuE;IACvE,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAA;IACpC,KAAK,IAAI,IAAI,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC;6FACyF;IACzF,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;2EAC2E;AAC3E,eAAO,MAAM,iBAAiB,WACpB,cAAc,cACV,MAAM,eACC,kBAAkB,KACpC,WAyBF,CAAA"}

package/dist/host/live.js

@@ -0,0 +1,32 @@
+/** One event stream per artifact, shared by everything on the page that needs it. The
+ *  connection opens with the first subscriber and closes with the last. */
+export const createLiveChannel = (client, artifactId, { stream = true } = {}) => {
+    const listeners = new Set();
+    let stop = null;
+    const dispatch = (event) => {
+        for (const each of listeners)
+            each(event);
+    };
+    const close = () => {
+        stop?.();
+        stop = null;
+    };
+    return {
+        subscribe: (listener) => {
+            listeners.add(listener);
+            if (stream)
+                stop ??= client.subscribe(artifactId, dispatch);
+            return () => {
+                listeners.delete(listener);
+                if (listeners.size === 0)
+                    close();
+            };
+        },
+        announce: dispatch,
+        close: () => {
+            listeners.clear();
+            close();
+        },
+    };
+};
+//# sourceMappingURL=live.js.map

package/dist/host/live.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.js","sourceRoot":"","sources":["../../src/host/live.ts"],"names":[],"mappings":"AAiBA;2EAC2E;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,MAAsB,EACtB,UAAkB,EAClB,EAAE,MAAM,GAAG,IAAI,EAAE,GAAuB,EAAE,EAC7B,EAAE;IACf,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAA;IAC3D,IAAI,IAAI,GAAwB,IAAI,CAAA;IACpC,MAAM,QAAQ,GAAG,CAAC,KAAoB,EAAE,EAAE;QACxC,KAAK,MAAM,IAAI,IAAI,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,CAAA;IAC3C,CAAC,CAAA;IACD,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,EAAE,EAAE,CAAA;QACR,IAAI,GAAG,IAAI,CAAA;IACb,CAAC,CAAA;IACD,OAAO;QACL,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YACtB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACvB,IAAI,MAAM;gBAAE,IAAI,KAAK,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;YAC3D,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;gBAC1B,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;oBAAE,KAAK,EAAE,CAAA;YACnC,CAAC,CAAA;QACH,CAAC;QACD,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,GAAG,EAAE;YACV,SAAS,CAAC,KAAK,EAAE,CAAA;YACjB,KAAK,EAAE,CAAA;QACT,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/host/print.d.ts

@@ -0,0 +1,3 @@
+/** Print saved HTML in an opaque sandbox. The browser offers Save as PDF. */
+export declare const printHtml: (file: Blob) => Promise<void>;
+//# sourceMappingURL=print.d.ts.map

package/dist/host/print.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.d.ts","sourceRoot":"","sources":["../../src/host/print.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,eAAO,MAAM,SAAS,SAAgB,IAAI,KAAG,OAAO,CAAC,IAAI,CAuDxD,CAAA"}

package/dist/host/print.js

@@ -0,0 +1,57 @@
+/** Print saved HTML in an opaque sandbox. The browser offers Save as PDF. */
+export const printHtml = async (file) => {
+    if (!file.type.startsWith("text/html"))
+        throw new Error("Expected an HTML export.");
+    const html = await file.text();
+    const frame = document.createElement("iframe");
+    const channel = crypto.randomUUID();
+    frame.title = "Print artifact";
+    frame.setAttribute("sandbox", "allow-scripts allow-modals");
+    frame.style.cssText = "position:fixed;left:-10000px;width:1280px;height:720px;border:0";
+    // The host waits for load before requesting print. Paint callbacks can pause offscreen.
+    const script = `<script>(()=>{const requestPrint=event=>{
+    if(event.source!==parent || event.data?.channel!==${JSON.stringify(channel)}) return;
+    removeEventListener('message',requestPrint);
+    document.querySelectorAll("details").forEach(detail=>{detail.open=true});
+    let started=false;
+    addEventListener('beforeprint',()=>{started=true},{once:true});
+    addEventListener('afterprint',()=>parent.postMessage({channel:${JSON.stringify(channel)},state:'done'},'*'),{once:true});
+    try { print(); if(!started) throw new Error('Printing is unavailable'); }
+    catch { parent.postMessage({channel:${JSON.stringify(channel)},state:'error'},'*'); }
+  };addEventListener('message',requestPrint);})();</script>`;
+    frame.srcdoc = html + script;
+    return new Promise((resolve, reject) => {
+        const cleanup = () => {
+            clearTimeout(timeout);
+            window.removeEventListener("message", receive);
+            frame.remove();
+        };
+        const fail = (message) => {
+            cleanup();
+            reject(new Error(message));
+        };
+        const receive = (event) => {
+            if (event.source !== frame.contentWindow || event.data?.channel !== channel)
+                return;
+            if (event.data.state === "done") {
+                cleanup();
+                resolve();
+            }
+            else if (event.data.state === "error") {
+                fail("Could not prepare the artifact for printing.");
+            }
+        };
+        let timeout = setTimeout(() => {
+            fail("The artifact took too long to prepare for printing.");
+        }, 30_000);
+        frame.addEventListener("load", () => {
+            // Native print blocks script execution. End preparation before opening its dialog.
+            clearTimeout(timeout);
+            timeout = setTimeout(() => fail("The print dialog did not finish. Try again."), 600_000);
+            frame.contentWindow?.postMessage({ channel }, "*");
+        }, { once: true });
+        window.addEventListener("message", receive);
+        document.body.append(frame);
+    });
+};
+//# sourceMappingURL=print.js.map

package/dist/host/print.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.js","sourceRoot":"","sources":["../../src/host/print.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,IAAU,EAAiB,EAAE;IAC3D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAA;IACnF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;IAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;IAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAA;IACnC,KAAK,CAAC,KAAK,GAAG,gBAAgB,CAAA;IAC9B,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,4BAA4B,CAAC,CAAA;IAC3D,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,iEAAiE,CAAA;IACvF,wFAAwF;IACxF,MAAM,MAAM,GAAG;wDACuC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;;;;;oEAKX,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;;0CAEjD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;4DACL,CAAA;IAC1D,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,MAAM,CAAA;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YAC9C,KAAK,CAAC,MAAM,EAAE,CAAA;QAChB,CAAC,CAAA;QACD,MAAM,IAAI,GAAG,CAAC,OAAe,EAAE,EAAE;YAC/B,OAAO,EAAE,CAAA;YACT,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;QAC5B,CAAC,CAAA;QACD,MAAM,OAAO,GAAG,CAAC,KAAmB,EAAE,EAAE;YACtC,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO;gBAAE,OAAM;YACnF,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;gBAChC,OAAO,EAAE,CAAA;gBACT,OAAO,EAAE,CAAA;YACX,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;gBACxC,IAAI,CAAC,8CAA8C,CAAC,CAAA;YACtD,CAAC;QACH,CAAC,CAAA;QACD,IAAI,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,qDAAqD,CAAC,CAAA;QAC7D,CAAC,EAAE,MAAM,CAAC,CAAA;QACV,KAAK,CAAC,gBAAgB,CACpB,MAAM,EACN,GAAG,EAAE;YACH,mFAAmF;YACnF,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,6CAA6C,CAAC,EAAE,OAAO,CAAC,CAAA;YACxF,KAAK,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAAA;QACpD,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,EAAE,CACf,CAAA;QACD,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAC3C,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7B,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/host/sse.d.ts

@@ -0,0 +1,11 @@
+/** Server-sent events over fetch, so requests carry the same headers and credentials as
+ *  every other call (EventSource cannot set headers). Reconnects with capped backoff. */
+export interface StreamOptions {
+    url: string;
+    init: RequestInit;
+    fetch: typeof fetch;
+    onData: (data: string) => void;
+}
+/** Open the stream; the returned function closes it for good. */
+export declare const openStream: ({ url, init, fetch, onData }: StreamOptions) => (() => void);
+//# sourceMappingURL=sse.d.ts.map

package/dist/host/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/host/sse.ts"],"names":[],"mappings":"AAAA;yFACyF;AACzF,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,WAAW,CAAA;IACjB,KAAK,EAAE,OAAO,KAAK,CAAA;IACnB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B;AA0BD,iEAAiE;AACjE,eAAO,MAAM,UAAU,iCAAkC,aAAa,KAAG,CAAC,MAAM,IAAI,CA0BnF,CAAA"}