@ethercorps/sveltekit-og 4.2.1 → 4.3.0-next.10

package/dist/helpers/error-handler.js

@@ -0,0 +1,75 @@
+export class ImageResponseError extends Error {
+    code;
+    originalError;
+    constructor(message, code, originalError) {
+        super(message);
+        this.code = code;
+        this.originalError = originalError;
+        this.name = "ImageResponseError";
+    }
+}
+/** Coerce anything thrown into an ImageResponseError, keeping existing ones as-is. */
+export function toImageResponseError(error) {
+    if (error instanceof ImageResponseError)
+        return error;
+    const err = error instanceof Error ? error : new Error(String(error));
+    return new ImageResponseError(err.message, ErrorCodes.UNKNOWN_ERROR, err);
+}
+export const ErrorCodes = {
+    FONT_LOAD_FAILED: "FONT_LOAD_FAILED",
+    VNODE_CREATION_FAILED: "VNODE_CREATION_FAILED",
+    SATORI_RENDER_FAILED: "SATORI_RENDER_FAILED",
+    RESVG_INIT_FAILED: "RESVG_INIT_FAILED",
+    RESVG_RENDER_FAILED: "RESVG_RENDER_FAILED",
+    SATORI_INIT_FAILED: "SATORI_INIT_FAILED",
+    EMOJI_LOAD_FAILED: "EMOJI_LOAD_FAILED",
+    TAKUMI_INIT_FAILED: "TAKUMI_INIT_FAILED",
+    TAKUMI_RENDER_FAILED: "TAKUMI_RENDER_FAILED",
+    UNKNOWN_ERROR: "UNKNOWN_ERROR",
+};
+/**
+ * Wraps an async operation with error handling and logging
+ */
+export async function handleAsync(operation, errorCode, errorMessage) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        throw new ImageResponseError(errorMessage, errorCode, err);
+    }
+}
+/**
+ * Wraps a sync operation with error handling and logging
+ */
+export function handleSync(operation, errorCode, errorMessage) {
+    try {
+        return operation();
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        throw new ImageResponseError(errorMessage, errorCode, err);
+    }
+}
+/**
+ * Wraps multiple async operations with error handling
+ */
+export async function handleAsyncAll(operations, errorCode, errorMessage) {
+    try {
+        return (await Promise.all(operations.map((op) => op())));
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        throw new ImageResponseError(errorMessage, errorCode, err);
+    }
+}
+/**
+ * Validates a response and throws if not ok
+ */
+export async function validateResponse(response, errorCode, errorMessage) {
+    if (!response.ok) {
+        throw new ImageResponseError(`${errorMessage} (HTTP ${response.status})`, errorCode);
+    }
+    const buffer = await response.arrayBuffer();
+    return buffer;
+}

package/dist/helpers/logger.d.ts

@@ -0,0 +1,7 @@
+export type Logger = ReturnType<typeof createLogger>;
+export declare function createLogger(debug: boolean): {
+    debug: (message: string, ...args: unknown[]) => void;
+    info: (message: string, ...args: unknown[]) => void;
+    warn: (message: string, ...args: unknown[]) => void;
+    error: (message: string, ...args: unknown[]) => void;
+};

package/dist/helpers/logger.js

@@ -0,0 +1,21 @@
+const PREFIX = '[SvelteKit-OG]';
+export function createLogger(debug) {
+    return {
+        debug: (message, ...args) => {
+            if (debug)
+                console.log(`${PREFIX} 🔍 ${message}`, ...args);
+        },
+        info: (message, ...args) => {
+            if (debug)
+                console.info(`${PREFIX} ℹ️ ${message}`, ...args);
+        },
+        warn: (message, ...args) => {
+            if (debug)
+                console.warn(`${PREFIX} ⚠️ ${message}`, ...args);
+        },
+        error: (message, ...args) => {
+            if (debug)
+                console.error(`${PREFIX} ❌ ${message}`, ...args);
+        }
+    };
+}

package/dist/helpers/response.d.ts

@@ -0,0 +1,20 @@
+type ImageProducer = () => Promise<Uint8Array | string>;
+interface BuildOptions {
+    /** uppercased format, used in logs e.g. "PNG" */
+    label: string;
+    contentType: string;
+    debug: boolean;
+    headers?: Record<string, string>;
+    status?: number;
+    statusText?: string;
+}
+/**
+ * Shared body + response init for both engines' ImageResponse. Streams the image
+ * out as bytes (a Response stream can't take a raw string), with consistent
+ * cache headers and error handling.
+ */
+export declare function buildImageResponse(produce: ImageProducer, opts: BuildOptions): {
+    body: ReadableStream;
+    init: ResponseInit;
+};
+export {};

package/dist/helpers/response.js

@@ -0,0 +1,39 @@
+import { createLogger } from "./logger.js";
+import { handleAsync, toImageResponseError, ErrorCodes } from "./error-handler.js";
+import { formatBytes } from "./utils.js";
+/**
+ * Shared body + response init for both engines' ImageResponse. Streams the image
+ * out as bytes (a Response stream can't take a raw string), with consistent
+ * cache headers and error handling.
+ */
+export function buildImageResponse(produce, opts) {
+    const log = createLogger(opts.debug);
+    const body = new ReadableStream({
+        async start(controller) {
+            try {
+                const out = await handleAsync(produce, ErrorCodes.UNKNOWN_ERROR, `Failed to generate ${opts.label}`);
+                const bytes = typeof out === "string" ? new TextEncoder().encode(out) : out;
+                log.info(`Generated ${opts.label}: ${formatBytes(bytes.byteLength)}`);
+                controller.enqueue(bytes);
+                controller.close();
+            }
+            catch (error) {
+                const err = toImageResponseError(error);
+                log.error("Failed to create image response:", err.message);
+                controller.error(err);
+            }
+        },
+    });
+    const init = {
+        headers: {
+            "Content-Type": opts.contentType,
+            "Cache-Control": opts.debug
+                ? "no-cache, no-store"
+                : "public, immutable, no-transform, max-age=31536000",
+            ...opts.headers,
+        },
+        status: opts.status || 200,
+        statusText: opts.statusText || "Success",
+    };
+    return { body, init };
+}

package/dist/helpers/to-html.d.ts

@@ -0,0 +1,10 @@
+import type { Component } from "svelte";
+/**
+ * Render a Svelte component to its SSR html parts. Shared by both engines — satori
+ * feeds body+head to satori-html, takumi passes the html string straight in. Use
+ * `<svelte:options css="injected" />` to get component styles into `head`.
+ */
+export declare function renderComponentToHtml(component: Component<any>, props?: Record<string, unknown>): {
+    head: string;
+    body: string;
+};

package/dist/helpers/to-html.js

@@ -0,0 +1,10 @@
+import { render } from "svelte/server";
+import { handleSync, ErrorCodes } from "./error-handler.js";
+/**
+ * Render a Svelte component to its SSR html parts. Shared by both engines — satori
+ * feeds body+head to satori-html, takumi passes the html string straight in. Use
+ * `<svelte:options css="injected" />` to get component styles into `head`.
+ */
+export function renderComponentToHtml(component, props = {}) {
+    return handleSync(() => render(component, { props }), ErrorCodes.VNODE_CREATION_FAILED, "Failed to render Svelte component to HTML");
+}

package/dist/helpers/toJSX.d.ts

@@ -1,3 +1,3 @@
-import type { Component } from 'svelte';
-import type { ComponentOptions, VNode } from '../types.js';
+import type { Component } from "svelte";
+import type { ComponentOptions, VNode } from "../types.js";
 export declare function createVNode(element: string | Component, componentOptions?: ComponentOptions): VNode;

package/dist/helpers/toJSX.js

@@ -1,9 +1,14 @@
-import { render } from 'svelte/server';
-import { html } from 'satori-html';
+import { html } from "satori-html";
+import { handleSync, ErrorCodes } from "./error-handler.js";
+import { renderComponentToHtml } from "./to-html.js";
 function svelteComponentToHTML(component, props = {}) {
-    const { body, head } = render(component, { props });
-    return html(body + head);
+    return handleSync(() => {
+        const { body, head } = renderComponentToHtml(component, props);
+        return html(body + head);
+    }, ErrorCodes.VNODE_CREATION_FAILED, "Failed to render Svelte component to HTML");
 }
 export function createVNode(element, componentOptions) {
-    return typeof element === 'string' ? html(element.replaceAll('\n', '').trim()) : svelteComponentToHTML(element, componentOptions?.props);
+    return handleSync(() => typeof element === "string"
+        ? html(element.replaceAll("\n", "").trim())
+        : svelteComponentToHTML(element, componentOptions?.props), ErrorCodes.VNODE_CREATION_FAILED, "Failed to create VNode");
 }

package/dist/helpers/utils.d.ts

@@ -0,0 +1,2 @@
+export declare const formatBytes: (bytes: number, decimals?: number) => string;
+export declare function importWasm(input: any): Promise<any>;

package/dist/helpers/utils.js

@@ -0,0 +1,25 @@
+const sizeFormats = ["Bytes", "KB", "MB", "GB"];
+const kbSize = 1024;
+export const formatBytes = (bytes, decimals = 2) => {
+    if (bytes === 0)
+        return "0 Bytes";
+    const decimalPoint = decimals < 0 ? 0 : decimals;
+    const sizeIndex = Math.min(Math.floor(Math.log(bytes) / Math.log(kbSize)), 3);
+    return (parseFloat((bytes / Math.pow(kbSize, sizeIndex)).toFixed(decimalPoint)) +
+        " " +
+        sizeFormats[sizeIndex]);
+};
+export async function importWasm(input) {
+    // may be a nested await for some reason
+    const _input = await input;
+    const _module = _input.default || _input;
+    // this is from rollup/wasm, it does some magic we need to recover from
+    if (typeof _module === "function") {
+        // empty input is to avoid instantiating the wasm module
+        // this will just compile it
+        const fnRes = await _module();
+        const _instance = fnRes.instance || fnRes;
+        return _instance.exports || _instance || _module;
+    }
+    return _module;
+}

package/dist/image-response.d.ts

@@ -1,5 +1,5 @@
-import type { Component, ComponentProps } from 'svelte';
-import type { ImageResponseOptions } from './types.js';
+import type { Component, ComponentProps } from "svelte";
+import type { ImageResponseOptions } from "./types.js";
 export declare class ImageResponse<T extends string | Component<any>> extends Response {
     constructor(element: T, options?: ImageResponseOptions, props?: T extends Component<any> ? ComponentProps<T> : never);
 }

package/dist/image-response.js

@@ -1,26 +1,19 @@
-import { DEFAULT_OPTIONS, DEFAULT_STATUS_CODE, DEFAULT_STATUS_TEXT } from './helpers/defaults.js';
-import { createPng, createSvg } from './helpers/create.js';
+import { DEFAULT_OPTIONS } from "./helpers/defaults.js";
+import { createPng, createSvg } from "./helpers/create.js";
+import { buildImageResponse } from "./helpers/response.js";
 export class ImageResponse extends Response {
     constructor(element, options, props) {
-        const extended_options = Object.assign({ ...DEFAULT_OPTIONS }, options);
-        const create_image_function = extended_options.format === 'png' ? createPng : createSvg;
-        const body = new ReadableStream({
-            async start(controller) {
-                const buffer = await create_image_function(element, extended_options, { props });
-                controller.enqueue(buffer);
-                controller.close();
-            }
-        });
-        super(body, {
-            headers: {
-                'Content-Type': `image/${extended_options.format}${extended_options.format === 'svg' ? '+xml' : ''}`,
-                'Cache-Control': extended_options.debug
-                    ? 'no-cache, no-store'
-                    : 'public, immutable, no-transform, max-age=31536000',
-                ...extended_options.headers
-            },
-            status: extended_options.status || DEFAULT_STATUS_CODE,
-            statusText: extended_options.statusText || DEFAULT_STATUS_TEXT
+        const opts = Object.assign({ ...DEFAULT_OPTIONS }, options);
+        const format = opts.format ?? "png";
+        const createImage = format === "png" ? createPng : createSvg;
+        const { body, init } = buildImageResponse(() => createImage(element, opts, { props }), {
+            label: format.toUpperCase(),
+            contentType: `image/${format}${format === "svg" ? "+xml" : ""}`,
+            debug: opts.debug ?? false,
+            headers: opts.headers,
+            status: opts.status,
+            statusText: opts.statusText,
         });
+        super(body, init);
     }
 }

package/dist/plugin.js

@@ -3,20 +3,20 @@ export function rollupWasm(options) {
     return unwasm({
         esmImport: true,
         lazy: true,
-        ...options
+        ...options,
     });
 }
 export function sveltekitOG(options) {
     return {
-        name: 'vite-plugin-sveltekit-og',
+        name: "vite-plugin-sveltekit-og",
         config() {
             return {
                 build: {
                     rollupOptions: {
-                        plugins: [rollupWasm(options)]
-                    }
-                }
+                        plugins: [rollupWasm(options)],
+                    },
+                },
             };
-        }
+        },
     };
 }

package/dist/providers/instances.d.ts

@@ -1,5 +1,5 @@
-import type _satori from 'satori';
-export declare function useResvg(): Promise<new (svg: Uint8Array | string, options?: import("@resvg/resvg-wasm").ResvgRenderOptions) => {
+import type _satori from "satori";
+export declare function useResvg(debug?: boolean): Promise<new (svg: Uint8Array | string, options?: import("@resvg/resvg-wasm").ResvgRenderOptions) => {
     free(): void;
     render(): {
         free(): void;
@@ -35,4 +35,4 @@ export declare function useResvg(): Promise<new (svg: Uint8Array | string, optio
     readonly height: number;
     readonly width: number;
 }>;
-export declare function useSatori(): Promise<typeof _satori>;
+export declare function useSatori(debug?: boolean): Promise<typeof _satori>;

package/dist/providers/instances.js

@@ -1,17 +1,44 @@
-import { isEdgeLight, isWorkerd } from 'std-env';
+import { isEdgeLight, isWorkerd } from "std-env";
+import { createLogger } from "../helpers/logger.js";
+import { handleAsync, ErrorCodes } from "../helpers/error-handler.js";
 // we keep instances alive to avoid re-importing them on every request, maybe not needed but
 // also helps with type inference
 // Code from vue-og-images
-const resvgInstance = { instance: undefined };
-const satoriInstance = { instance: undefined };
-export async function useResvg() {
-    const moduleImport = isEdgeLight || isWorkerd ? import(`./resvg/edge.js`) : import('./resvg/node.js');
-    resvgInstance.instance = resvgInstance.instance || await moduleImport.then(m => m.default);
-    await resvgInstance.instance.initWasmPromise;
+const resvgInstance = {
+    instance: undefined,
+};
+const satoriInstance = {
+    instance: undefined,
+};
+export async function useResvg(debug = false) {
+    const log = createLogger(debug);
+    if (resvgInstance.instance) {
+        return resvgInstance.instance.Resvg;
+    }
+    log.debug("Initializing ReSVG WASM");
+    const isWorkerLikeRuntime = isEdgeLight || isWorkerd;
+    log.info(`Detected runtime: ${isWorkerLikeRuntime ? "Edge Light or Workerd" : "Node.js"}`);
+    // workers take a precompiled `?module`; node takes raw wasm bytes. keep both
+    // as direct import() expressions so the bundler can emit the wasm chunk.
+    const moduleImport = isWorkerLikeRuntime
+        ? import("./resvg/edge.js")
+        : import("./resvg/node.js");
+    resvgInstance.instance = await handleAsync(() => moduleImport.then((m) => m.default), ErrorCodes.RESVG_INIT_FAILED, "Failed to import ReSVG module");
+    await handleAsync(() => resvgInstance.instance.initWasmPromise, ErrorCodes.RESVG_INIT_FAILED, "Failed to initialize ReSVG WASM");
     return resvgInstance.instance.Resvg;
 }
-export async function useSatori() {
-    satoriInstance.instance = satoriInstance.instance || await import(`./satori/node.js`).then(m => m.default);
-    await satoriInstance.instance.initWasmPromise;
+export async function useSatori(debug = false) {
+    const log = createLogger(debug);
+    if (satoriInstance.instance) {
+        return satoriInstance.instance.satori;
+    }
+    log.debug("Initializing Satori");
+    const isWorkerLikeRuntime = isEdgeLight || isWorkerd;
+    log.info(`Detected runtime: ${isWorkerLikeRuntime ? "Edge Light or Workerd" : "Node.js"}`);
+    const moduleImport = isWorkerLikeRuntime
+        ? import("./satori/edge.js")
+        : import("./satori/node.js");
+    satoriInstance.instance = await handleAsync(() => moduleImport.then((m) => m.default), ErrorCodes.SATORI_INIT_FAILED, "Failed to import Satori module");
+    await handleAsync(() => satoriInstance.instance.initWasmPromise, ErrorCodes.SATORI_INIT_FAILED, "Failed to initialize Satori WASM");
     return satoriInstance.instance.satori;
 }

package/dist/providers/resvg/edge.d.ts

@@ -3,4 +3,4 @@ declare namespace _default {
     export { _Resvg as Resvg };
 }
 export default _default;
-import { Resvg as _Resvg } from '@resvg/resvg-wasm';
+import { Resvg as _Resvg } from "@resvg/resvg-wasm";

package/dist/providers/resvg/edge.js

@@ -1,8 +1,12 @@
-import { Resvg as _Resvg, initWasm } from '@resvg/resvg-wasm'
+import { Resvg as _Resvg, initWasm } from "@resvg/resvg-wasm";
 
 export default {
-	// eslint-disable-next-line @typescript-eslint/ban-ts-comment
-  // @ts-ignore
-  initWasmPromise: initWasm(import('./resvg.wasm?module').then(r => r.default || r)),
-  Resvg: _Resvg,
-}
+	// load resvg's wasm from the dep (it exports ./index_bg.wasm) via ?module, so we
+	// don't vendor a copy. precompiled module works on node + workers alike.
+	initWasmPromise: initWasm(
+		// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+		// @ts-ignore
+		import("@resvg/resvg-wasm/index_bg.wasm?module").then((r) => r.default || r)
+	),
+	Resvg: _Resvg,
+};

package/dist/providers/resvg/node.d.ts

@@ -3,4 +3,4 @@ declare namespace _default {
     export { _Resvg as Resvg };
 }
 export default _default;
-import { Resvg as _Resvg } from '@resvg/resvg-wasm';
+import { Resvg as _Resvg } from "@resvg/resvg-wasm";

package/dist/providers/resvg/node.js

@@ -1,13 +1,22 @@
-import { Resvg as _Resvg, initWasm } from '@resvg/resvg-wasm';
+import { Resvg as _Resvg, initWasm } from "@resvg/resvg-wasm";
+import { readFile } from "node:fs/promises";
+import { createRequire } from "node:module";
 
-/**
- * Fetch will be called only once whenever you load this file.
- * In vercel serverless functions, fetch will run on cold start.
- * In Node.js (Stateful e.g. Linux servers), Fetch will run once when you start your server.
- * */
-const resvgWasm = fetch('https://unpkg.com/@resvg/resvg-wasm/index_bg.wasm')
+// prefer reading resvg's wasm straight from the installed dependency (no
+// network). some serverless bundlers (vercel/netlify via nft) don't trace the
+// sibling .wasm onto disk, so fall back to fetching it there. either way we hand
+// initWasm raw bytes / a Response — never a `?module` import, which node
+// serverless can't instantiate. runs once when this module first loads.
+async function loadResvgWasm() {
+	try {
+		const require = createRequire(import.meta.url);
+		return await readFile(require.resolve("@resvg/resvg-wasm/index_bg.wasm"));
+	} catch {
+		return fetch("https://unpkg.com/@resvg/resvg-wasm/index_bg.wasm");
+	}
+}
 
 export default {
-	initWasmPromise: initWasm(resvgWasm),
+	initWasmPromise: initWasm(loadResvgWasm()),
 	Resvg: _Resvg,
-}
+};

package/dist/providers/satori/edge.d.ts

@@ -0,0 +1,6 @@
+declare namespace _default {
+    export let initWasmPromise: Promise<void>;
+    export { _satori as satori };
+}
+export default _default;
+import _satori from "satori/standalone";

package/dist/providers/satori/edge.js

@@ -0,0 +1,12 @@
+import _satori, { init } from "satori/standalone";
+
+// the default satori entry compiles yoga's wasm at runtime, which workers block
+// ("Wasm code generation disallowed by embedder"). satori/standalone takes a
+// precompiled module via init(), so we hand it satori's own yoga wasm (it exports
+// ./yoga.wasm) through ?module — no vendored copy. mirrors providers/resvg.
+export default {
+	// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+	// @ts-ignore
+	initWasmPromise: init(import("satori/yoga.wasm?module").then((r) => r.default || r)),
+	satori: _satori,
+};

package/dist/providers/satori/node.d.ts

@@ -3,4 +3,4 @@ declare namespace _default {
     export { _satori as satori };
 }
 export default _default;
-import _satori from 'satori';
+import _satori from "satori";

package/dist/providers/satori/node.js

@@ -1,6 +1,6 @@
-import _satori from 'satori'
+import _satori from "satori";
 
 export default {
-  initWasmPromise: Promise.resolve(),
-  satori: _satori,
-}
+	initWasmPromise: Promise.resolve(),
+	satori: _satori,
+};

package/dist/takumi/fonts.d.ts

@@ -0,0 +1,16 @@
+import type { FontDetails } from "takumi-js/node";
+import { BaseFont } from "../fonts.js";
+import type { MayBePromise } from "../types.js";
+type ByteBuf = Uint8Array | ArrayBuffer | Buffer;
+/** Takumi-native font descriptor; data is the bytes or a lazy loader, like takumi-js wants. */
+export interface TakumiFontDescriptor {
+    name?: string;
+    data: ByteBuf | (() => MayBePromise<ByteBuf>);
+    weight?: number;
+    style?: FontDetails["style"];
+}
+/** What the takumi path accepts: our GoogleFont/CustomFont, or a raw takumi descriptor. */
+export type TakumiFontInput = BaseFont | TakumiFontDescriptor;
+/** Normalize mixed font inputs to FontDetails for registerFont, loaders run in parallel. */
+export declare function resolveTakumiFonts(fonts: TakumiFontInput[]): Promise<FontDetails[]>;
+export {};

package/dist/takumi/fonts.js

@@ -0,0 +1,15 @@
+import { BaseFont } from "../fonts.js";
+import { handleAsync, ErrorCodes } from "../helpers/error-handler.js";
+async function normalizeFont(font) {
+    if (font instanceof BaseFont) {
+        // our font classes lazily load + cache through the data getter
+        const data = (await font.data);
+        return { name: font.name, data, weight: font.weight, style: font.style };
+    }
+    const data = typeof font.data === "function" ? await font.data() : await font.data;
+    return { name: font.name, data, weight: font.weight, style: font.style };
+}
+/** Normalize mixed font inputs to FontDetails for registerFont, loaders run in parallel. */
+export async function resolveTakumiFonts(fonts) {
+    return handleAsync(() => Promise.all(fonts.map(normalizeFont)), ErrorCodes.FONT_LOAD_FAILED, "Failed to resolve fonts for Takumi");
+}

package/dist/takumi/image-response.d.ts

@@ -0,0 +1,6 @@
+import type { Component, ComponentProps } from "svelte";
+import type { TakumiImageResponseOptions } from "./types.js";
+/** OG image rendered by Takumi. Takes an HTML string or a Svelte component. */
+export declare class ImageResponse<T extends string | Component<any>> extends Response {
+    constructor(element: T, options?: TakumiImageResponseOptions, props?: T extends Component<any> ? ComponentProps<T> : never);
+}

package/dist/takumi/image-response.js

@@ -0,0 +1,33 @@
+import { createTakumiImage } from "./render.js";
+import { buildImageResponse } from "../helpers/response.js";
+const DEFAULT_OPTIONS = {
+    width: 1200,
+    height: 630,
+    format: "png",
+    emoji: "twemoji",
+    debug: false,
+};
+// takumi can also encode jpeg/webp/ico/raw, plus svg as text
+const CONTENT_TYPES = {
+    png: "image/png",
+    jpeg: "image/jpeg",
+    webp: "image/webp",
+    ico: "image/x-icon",
+    raw: "application/octet-stream",
+    svg: "image/svg+xml",
+};
+/** OG image rendered by Takumi. Takes an HTML string or a Svelte component. */
+export class ImageResponse extends Response {
+    constructor(element, options, props) {
+        const opts = { ...DEFAULT_OPTIONS, ...options };
+        const { body, init } = buildImageResponse(() => createTakumiImage(element, opts, props), {
+            label: opts.format.toUpperCase(),
+            contentType: CONTENT_TYPES[opts.format],
+            debug: opts.debug,
+            headers: opts.headers,
+            status: opts.status,
+            statusText: opts.statusText,
+        });
+        super(body, init);
+    }
+}

package/dist/takumi/index.d.ts

@@ -0,0 +1,5 @@
+export { ImageResponse } from "./image-response.js";
+export type { TakumiImageResponseOptions, TakumiImageOptions, TakumiResponseOptions, TakumiFormat, } from "./types.js";
+export type { TakumiFontInput, TakumiFontDescriptor } from "./fonts.js";
+export { resolveTakumiFonts } from "./fonts.js";
+export { GoogleFont, CustomFont, loadGoogleFont } from "../fonts.js";

package/dist/takumi/index.js

@@ -0,0 +1,4 @@
+export { ImageResponse } from "./image-response.js";
+export { resolveTakumiFonts } from "./fonts.js";
+// re-export the font helpers so the takumi path works from one import
+export { GoogleFont, CustomFont, loadGoogleFont } from "../fonts.js";

package/dist/takumi/render.d.ts

@@ -0,0 +1,4 @@
+import type { Component } from "svelte";
+import type { TakumiImageOptions } from "./types.js";
+/** Render an HTML string or Svelte component to image bytes (or an svg string). */
+export declare function createTakumiImage(element: string | Component, options: TakumiImageOptions, props?: Record<string, unknown>): Promise<Uint8Array | string>;

package/dist/takumi/render.js

@@ -0,0 +1,30 @@
+import { render as takumiRender, renderSvg } from "takumi-js";
+import { renderComponentToHtml } from "../helpers/to-html.js";
+import { useTakumiRenderer, registerTakumiFonts } from "./renderer.js";
+import { resolveTakumiFonts } from "./fonts.js";
+import { createLogger } from "../helpers/logger.js";
+import { handleAsync, handleSync, ErrorCodes } from "../helpers/error-handler.js";
+function elementToHtml(element, props) {
+    if (typeof element === "string")
+        return element.replaceAll("\n", "").trim();
+    // head carries css injected via <svelte:options css="injected" />, so it goes first
+    const { head, body } = renderComponentToHtml(element, props);
+    return head + body;
+}
+/** Render an HTML string or Svelte component to image bytes (or an svg string). */
+export async function createTakumiImage(element, options, props) {
+    const log = createLogger(options.debug ?? false);
+    const html = handleSync(() => elementToHtml(element, props), ErrorCodes.VNODE_CREATION_FAILED, "Failed to create HTML for Takumi");
+    const renderer = await useTakumiRenderer(options.debug);
+    if (options.fonts?.length) {
+        const fonts = await resolveTakumiFonts(options.fonts);
+        await registerTakumiFonts(renderer, fonts);
+    }
+    const { width, height, format = "png", quality, stylesheets, emoji } = options;
+    const shared = { renderer: renderer, width, height, stylesheets, emoji };
+    log.debug(`Rendering ${format.toUpperCase()} with Takumi`);
+    if (format === "svg") {
+        return handleAsync(() => renderSvg(html, shared), ErrorCodes.TAKUMI_RENDER_FAILED, "Failed to render SVG with Takumi");
+    }
+    return handleAsync(() => takumiRender(html, { ...shared, format, quality }), ErrorCodes.TAKUMI_RENDER_FAILED, "Failed to render image with Takumi");
+}