@buenojs/bueno 0.8.9 → 0.8.11

package/dist/frontend/ssr/react.js

@@ -0,0 +1,373 @@
+/**
+ * React SSR Renderer
+ *
+ * Provides server-side rendering for React components using:
+ * - renderToPipeableStream / renderToReadableStream for streaming
+ * - React Helmet for head management
+ * - Suspense boundary support
+ */
+// Head element storage (similar to React Helmet)
+let headElements = [];
+/**
+ * Reset head elements for a new render
+ */
+export function resetHead() {
+    headElements = [];
+}
+/**
+ * Get collected head elements
+ */
+export function getHeadElements() {
+    return [...headElements];
+}
+/**
+ * Add a head element
+ */
+export function addHeadElement(element) {
+    headElements.push(element);
+}
+/**
+ * Create a title element for head
+ */
+export function title(text) {
+    return {
+        tag: "title",
+        attrs: {},
+        children: [{ tag: "#text", attrs: {}, innerHTML: text }],
+    };
+}
+/**
+ * Create a meta element for head
+ */
+export function meta(attrs) {
+    return { tag: "meta", attrs };
+}
+/**
+ * Create a link element for head
+ */
+export function link(attrs) {
+    return { tag: "link", attrs };
+}
+/**
+ * Create a script element for head
+ */
+export function script(attrs, innerHTML) {
+    return { tag: "script", attrs, innerHTML };
+}
+/**
+ * Create a style element for head
+ */
+export function style(innerHTML, attrs) {
+    return { tag: "style", attrs: attrs || {}, innerHTML };
+}
+/**
+ * React SSR Renderer implementation
+ */
+export class ReactSSRRenderer {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    react = null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    reactDomServer = null;
+    initialized = false;
+    /**
+     * Initialize React modules
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        try {
+            this.react = await import("react");
+            this.reactDomServer = await import("react-dom/server");
+            this.initialized = true;
+        }
+        catch (error) {
+            throw new Error("React is not installed. Install it with: bun add react react-dom");
+        }
+    }
+    /**
+     * Render a component to HTML string
+     */
+    async renderToString(component, context) {
+        await this.init();
+        if (!this.reactDomServer) {
+            throw new Error("React DOM Server not initialized");
+        }
+        resetHead();
+        try {
+            // Use renderToString for non-streaming
+            const renderToStringFn = this.reactDomServer.renderToString;
+            const html = renderToStringFn(component);
+            return html;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error";
+            throw new Error(`React renderToString failed: ${errorMessage}`);
+        }
+    }
+    /**
+     * Render a component to a stream
+     */
+    renderToStream(component, context) {
+        // Create a promise-based initialization
+        const encoder = new TextEncoder();
+        return new ReadableStream({
+            start: async (controller) => {
+                try {
+                    await this.init();
+                    if (!this.reactDomServer) {
+                        controller.error(new Error("React DOM Server not initialized"));
+                        return;
+                    }
+                    resetHead();
+                    // Check if renderToReadableStream is available (modern API)
+                    if ("renderToReadableStream" in this.reactDomServer) {
+                        const stream = await this.reactDomServer.renderToReadableStream(component, {
+                            bootstrapScripts: [],
+                            onError: (error) => {
+                                console.error("React streaming error:", error);
+                            },
+                        });
+                        const reader = stream.getReader();
+                        while (true) {
+                            const { done, value } = await reader.read();
+                            if (done) {
+                                controller.close();
+                                break;
+                            }
+                            controller.enqueue(value);
+                        }
+                    }
+                    else {
+                        // Fallback to renderToString for older React versions
+                        const html = this.reactDomServer.renderToString(component);
+                        controller.enqueue(encoder.encode(html));
+                        controller.close();
+                    }
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : "Unknown error";
+                    controller.error(new Error(`React renderToStream failed: ${errorMessage}`));
+                }
+            },
+        });
+    }
+    /**
+     * Get head elements from component
+     */
+    getHeadElements(context) {
+        return getHeadElements();
+    }
+    /**
+     * Create the framework-specific component
+     */
+    createComponent(page, context) {
+        // Return the page render function wrapped in React context
+        return {
+            page,
+            context,
+        };
+    }
+    /**
+     * Render with Suspense support
+     */
+    async renderWithSuspense(component, context, fallback = "<div>Loading...</div>") {
+        await this.init();
+        if (!this.react || !this.reactDomServer) {
+            throw new Error("React not initialized");
+        }
+        resetHead();
+        try {
+            // Wrap with Suspense if available
+            const suspenseWrapper = this.react.createElement(this.react.Suspense, { fallback }, component);
+            const html = this.reactDomServer.renderToString(suspenseWrapper);
+            return html;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error";
+            throw new Error(`React renderWithSuspense failed: ${errorMessage}`);
+        }
+    }
+    /**
+     * Render to stream with all callbacks
+     */
+    async renderToStreamWithCallbacks(component, context, options = {}) {
+        await this.init();
+        if (!this.reactDomServer) {
+            throw new Error("React DOM Server not initialized");
+        }
+        resetHead();
+        const encoder = new TextEncoder();
+        return new ReadableStream({
+            start: async (controller) => {
+                try {
+                    if ("renderToReadableStream" in this.reactDomServer) {
+                        const stream = await this.reactDomServer.renderToReadableStream(component, {
+                            bootstrapScripts: [],
+                            onError: (error) => {
+                                options.onError?.(error);
+                                console.error("React streaming error:", error);
+                            },
+                        });
+                        // Wait for shell to be ready
+                        await stream.allReady;
+                        options.onAllReady?.();
+                        const reader = stream.getReader();
+                        while (true) {
+                            const { done, value } = await reader.read();
+                            if (done) {
+                                controller.close();
+                                break;
+                            }
+                            controller.enqueue(value);
+                        }
+                    }
+                    else {
+                        // Fallback
+                        const html = this.reactDomServer.renderToString(component);
+                        options.onAllReady?.();
+                        controller.enqueue(encoder.encode(html));
+                        controller.close();
+                    }
+                }
+                catch (error) {
+                    const err = error instanceof Error ? error : new Error("Unknown error");
+                    options.onShellError?.(err);
+                    controller.error(err);
+                }
+            },
+        });
+    }
+}
+/**
+ * Create a React SSR renderer
+ */
+export function createReactSSRRenderer() {
+    return new ReactSSRRenderer();
+}
+/**
+ * Convert SSRElement to HTML string
+ */
+export function ssrElementToString(element) {
+    if (element.tag === "#text") {
+        return escapeHtml(element.innerHTML || "");
+    }
+    const attrs = Object.entries(element.attrs)
+        .map(([key, value]) => `${key}="${escapeHtml(value)}"`)
+        .join(" ");
+    const openTag = attrs ? `<${element.tag} ${attrs}>` : `<${element.tag}>`;
+    if (element.innerHTML) {
+        return `${openTag}${element.innerHTML}</${element.tag}>`;
+    }
+    if (element.children && element.children.length > 0) {
+        const children = element.children.map(ssrElementToString).join("");
+        return `${openTag}${children}</${element.tag}>`;
+    }
+    // Self-closing tags
+    const voidElements = [
+        "area",
+        "base",
+        "br",
+        "col",
+        "embed",
+        "hr",
+        "img",
+        "input",
+        "link",
+        "meta",
+        "param",
+        "source",
+        "track",
+        "wbr",
+    ];
+    if (voidElements.includes(element.tag)) {
+        return attrs ? `<${element.tag} ${attrs}>` : `<${element.tag}>`;
+    }
+    return `${openTag}</${element.tag}>`;
+}
+/**
+ * Escape HTML special characters
+ */
+function escapeHtml(str) {
+    return str
+        .replace(/&/g, "\x26amp;")
+        .replace(/</g, "\x26lt;")
+        .replace(/>/g, "\x26gt;")
+        .replace(/"/g, "\x26quot;")
+        .replace(/'/g, "&#39;");
+}
+/**
+ * React Helmet-like head management
+ */
+export class ReactHelmet {
+    static instance;
+    title = "";
+    metaTags = [];
+    linkTags = [];
+    scriptTags = [];
+    styleTags = [];
+    static getInstance() {
+        if (!ReactHelmet.instance) {
+            ReactHelmet.instance = new ReactHelmet();
+        }
+        return ReactHelmet.instance;
+    }
+    setTitle(title) {
+        this.title = title;
+        addHeadElement({
+            tag: "title",
+            attrs: {},
+            children: [{ tag: "#text", attrs: {}, innerHTML: title }],
+        });
+        return this;
+    }
+    addMeta(attrs) {
+        this.metaTags.push({ tag: "meta", attrs });
+        addHeadElement({ tag: "meta", attrs });
+        return this;
+    }
+    addLink(attrs) {
+        this.linkTags.push({ tag: "link", attrs });
+        addHeadElement({ tag: "link", attrs });
+        return this;
+    }
+    addScript(attrs, innerHTML) {
+        this.scriptTags.push({ tag: "script", attrs, innerHTML });
+        addHeadElement({ tag: "script", attrs, innerHTML });
+        return this;
+    }
+    addStyle(innerHTML, attrs) {
+        this.styleTags.push({ tag: "style", attrs: attrs || {}, innerHTML });
+        addHeadElement({ tag: "style", attrs: attrs || {}, innerHTML });
+        return this;
+    }
+    reset() {
+        this.title = "";
+        this.metaTags = [];
+        this.linkTags = [];
+        this.scriptTags = [];
+        this.styleTags = [];
+        resetHead();
+    }
+    getTitle() {
+        return this.title;
+    }
+    getMetaTags() {
+        return [...this.metaTags];
+    }
+    getLinkTags() {
+        return [...this.linkTags];
+    }
+    getScriptTags() {
+        return [...this.scriptTags];
+    }
+    getStyleTags() {
+        return [...this.styleTags];
+    }
+}
+/**
+ * Get React Helmet instance
+ */
+export function helmet() {
+    return ReactHelmet.getInstance();
+}
+//# sourceMappingURL=react.js.map

package/dist/frontend/ssr/react.js.map

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

package/dist/frontend/ssr/solid.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Solid SSR Renderer
+ *
+ * Provides server-side rendering for Solid components using:
+ * - renderToString / renderToStringAsync from solid-js/web
+ * - Solid Meta for head management
+ * - Async rendering support
+ */
+import type { FrameworkSSRRenderer, SSRContext, SSRElement, SSRPage } from "../types.js";
+/**
+ * Reset head elements for a new render
+ */
+export declare function resetHead(): void;
+/**
+ * Get collected head elements
+ */
+export declare function getHeadElements(): SSRElement[];
+/**
+ * Add a head element
+ */
+export declare function addHeadElement(element: SSRElement): void;
+/**
+ * Solid SSR Renderer implementation
+ */
+export declare class SolidSSRRenderer implements FrameworkSSRRenderer {
+    private solidJs;
+    private solidWeb;
+    private initialized;
+    /**
+     * Initialize Solid modules
+     */
+    init(): Promise<void>;
+    /**
+     * Render a component to HTML string
+     */
+    renderToString(component: unknown, context: SSRContext): Promise<string>;
+    /**
+     * Render a component to a stream
+     */
+    renderToStream(component: unknown, context: SSRContext): ReadableStream<Uint8Array>;
+    /**
+     * Get head elements from component
+     */
+    getHeadElements(context: SSRContext): SSRElement[];
+    /**
+     * Create the framework-specific component
+     */
+    createComponent(page: SSRPage, context: SSRContext): unknown;
+    /**
+     * Wrap component with context provider
+     */
+    private wrapWithContext;
+    /**
+     * Render with async support
+     */
+    renderAsync(component: unknown, context: SSRContext): Promise<string>;
+    /**
+     * Render with suspense support
+     */
+    renderWithSuspense(component: unknown, context: SSRContext, fallback?: string): Promise<string>;
+}
+/**
+ * Create a Solid SSR renderer
+ */
+export declare function createSolidSSRRenderer(): SolidSSRRenderer;
+/**
+ * Solid Meta-like head management
+ */
+export declare class SolidMeta {
+    private static instance;
+    private title;
+    private metaTags;
+    private linkTags;
+    private scriptTags;
+    private styleTags;
+    static getInstance(): SolidMeta;
+    setTitle(title: string): this;
+    addMeta(attrs: Record<string, string>): this;
+    addLink(attrs: Record<string, string>): this;
+    addScript(attrs: Record<string, string>, innerHTML?: string): this;
+    addStyle(innerHTML: string, attrs?: Record<string, string>): this;
+    reset(): void;
+    getTitle(): string;
+    getMetaTags(): SSRElement[];
+    getLinkTags(): SSRElement[];
+    getScriptTags(): SSRElement[];
+    getStyleTags(): SSRElement[];
+}
+/**
+ * Get Solid Meta instance
+ */
+export declare function solidMeta(): SolidMeta;
+/**
+ * Convert SSRElement to HTML string
+ */
+export declare function ssrElementToString(element: SSRElement): string;
+/**
+ * Create Solid SSR context
+ */
+export declare function createSolidSSRContext(request: Request, initialState?: Record<string, unknown>): SSRContext;
+/**
+ * Solid Start-like route data helper
+ */
+export declare function createRouteData<T>(fetcher: () => Promise<T>, options?: {
+    key?: () => unknown[];
+    deferStream?: boolean;
+}): {
+    data: T | undefined;
+    loading: boolean;
+    error: Error | null;
+};
+/**
+ * Solid resource wrapper for SSR
+ */
+export declare class SolidResource<T> {
+    private data;
+    private error;
+    private loading;
+    private promise;
+    constructor(fetcher: () => Promise<T>);
+    load(): Promise<T>;
+    get(): T | undefined;
+    getState(): {
+        data: T | undefined;
+        loading: boolean;
+        error: Error | null;
+    };
+}
+/**
+ * Create a Solid resource
+ */
+export declare function createSolidResource<T>(fetcher: () => Promise<T>): SolidResource<T>;
+/**
+ * No hydration marker for solid
+ */
+export declare const NO_HYDRATE = "data-no-hydrate";
+/**
+ * Mark element as no-hydrate
+ */
+export declare function noHydrate(element: SSRElement): SSRElement;
+//# sourceMappingURL=solid.d.ts.map

package/dist/frontend/ssr/solid.d.ts.map

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