@buenojs/bueno 0.8.9 → 0.8.11

package/dist/frontend/ssr/vue.js

@@ -0,0 +1,385 @@
+/**
+ * Vue SSR Renderer
+ *
+ * Provides server-side rendering for Vue components using:
+ * - renderToString / renderToStream from vue/server-renderer
+ * - Vue Router integration
+ * - Vue Meta for head management
+ */
+// Head element storage
+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);
+}
+/**
+ * Vue SSR Renderer implementation
+ */
+export class VueSSRRenderer {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    vue = null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    vueServerRenderer = null;
+    initialized = false;
+    /**
+     * Initialize Vue modules
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        try {
+            this.vue = await import("vue");
+            this.vueServerRenderer = await import("vue/server-renderer");
+            this.initialized = true;
+        }
+        catch (error) {
+            throw new Error("Vue is not installed. Install it with: bun add vue");
+        }
+    }
+    /**
+     * Create a Vue SSR app instance
+     */
+    async createSSRApp(options) {
+        await this.init();
+        if (!this.vue) {
+            throw new Error("Vue not initialized");
+        }
+        const { createSSRApp } = this.vue;
+        const app = createSSRApp(options.component, options.props || {});
+        // Provide initial state for hydration
+        if (options.state) {
+            app.provide("__INITIAL_STATE__", options.state);
+        }
+        return app;
+    }
+    /**
+     * Render a component to HTML string
+     */
+    async renderToString(component, context) {
+        await this.init();
+        if (!this.vueServerRenderer) {
+            throw new Error("Vue Server Renderer not initialized");
+        }
+        resetHead();
+        try {
+            // If component is already a Vue app, render it directly
+            if (this.isVueApp(component)) {
+                component.ssrContext = context;
+                const html = await this.vueServerRenderer.renderToString(component);
+                return html;
+            }
+            // Otherwise create an app and render
+            const app = await this.createSSRApp({
+                component,
+                props: { context },
+            });
+            app.ssrContext = context;
+            const html = await this.vueServerRenderer.renderToString(app);
+            return html;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error";
+            throw new Error(`Vue renderToString failed: ${errorMessage}`);
+        }
+    }
+    /**
+     * Render a component to a stream
+     */
+    renderToStream(component, context) {
+        const encoder = new TextEncoder();
+        return new ReadableStream({
+            start: async (controller) => {
+                try {
+                    await this.init();
+                    if (!this.vueServerRenderer) {
+                        controller.error(new Error("Vue Server Renderer not initialized"));
+                        return;
+                    }
+                    resetHead();
+                    // Set SSR context
+                    if (this.isVueApp(component)) {
+                        component.ssrContext = context;
+                    }
+                    // Use renderToNodeStream equivalent via Web Streams
+                    const { renderToWebStream } = this.vueServerRenderer;
+                    if (renderToWebStream) {
+                        const stream = renderToWebStream(component);
+                        const reader = stream.getReader();
+                        while (true) {
+                            const { done, value } = await reader.read();
+                            if (done) {
+                                controller.close();
+                                break;
+                            }
+                            controller.enqueue(value);
+                        }
+                    }
+                    else {
+                        // Fallback to renderToString
+                        const html = await this.vueServerRenderer.renderToString(component);
+                        controller.enqueue(encoder.encode(html));
+                        controller.close();
+                    }
+                }
+                catch (error) {
+                    const errorMessage = error instanceof Error ? error.message : "Unknown error";
+                    controller.error(new Error(`Vue renderToStream failed: ${errorMessage}`));
+                }
+            },
+        });
+    }
+    /**
+     * Get head elements from component
+     */
+    getHeadElements(context) {
+        return getHeadElements();
+    }
+    /**
+     * Create the framework-specific component
+     */
+    createComponent(page, context) {
+        return {
+            page,
+            context,
+        };
+    }
+    /**
+     * Check if object is a Vue app instance
+     */
+    isVueApp(obj) {
+        return (typeof obj === "object" &&
+            obj !== null &&
+            "component" in obj &&
+            "use" in obj &&
+            "provide" in obj &&
+            "config" in obj);
+    }
+    /**
+     * Create Vue Router for SSR
+     */
+    async createRouter(routes) {
+        await this.init();
+        if (!this.vue) {
+            throw new Error("Vue not initialized");
+        }
+        try {
+            const vueRouter = await import("vue-router");
+            const { createMemoryHistory, createRouter } = vueRouter;
+            const router = createRouter({
+                history: createMemoryHistory(),
+                routes: routes,
+            });
+            const app = await this.createSSRApp({
+                component: {},
+            });
+            app.use(router);
+            return { router: router, app };
+        }
+        catch (error) {
+            throw new Error("Vue Router is not installed. Install it with: bun add vue-router");
+        }
+    }
+    /**
+     * Render with Vue Router
+     */
+    async renderWithRouter(app, router, url, context) {
+        await this.init();
+        if (!this.vueServerRenderer) {
+            throw new Error("Vue Server Renderer not initialized");
+        }
+        resetHead();
+        try {
+            // Push to router and wait for ready
+            await router.push(url);
+            await router.isReady();
+            // Set SSR context
+            app.ssrContext = context;
+            // Render
+            const html = await this.vueServerRenderer.renderToString(app);
+            return html;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : "Unknown error";
+            throw new Error(`Vue renderWithRouter failed: ${errorMessage}`);
+        }
+    }
+}
+/**
+ * Create a Vue SSR renderer
+ */
+export function createVueSSRRenderer() {
+    return new VueSSRRenderer();
+}
+/**
+ * Vue Meta-like head management
+ */
+export class VueMeta {
+    static instance;
+    title = "";
+    metaTags = [];
+    linkTags = [];
+    scriptTags = [];
+    styleTags = [];
+    static getInstance() {
+        if (!VueMeta.instance) {
+            VueMeta.instance = new VueMeta();
+        }
+        return VueMeta.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 Vue Meta instance
+ */
+export function vueMeta() {
+    return VueMeta.getInstance();
+}
+/**
+ * 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;");
+}
+/**
+ * Vue useHead composable-like function
+ */
+export function useHead(head) {
+    const meta = vueMeta();
+    if (head.title) {
+        meta.setTitle(head.title);
+    }
+    head.meta?.forEach((attrs) => meta.addMeta(attrs));
+    head.link?.forEach((attrs) => meta.addLink(attrs));
+    head.script?.forEach((attrs) => meta.addScript(attrs));
+    head.style?.forEach(({ innerHTML, attrs }) => meta.addStyle(innerHTML, attrs));
+}
+/**
+ * Create Vue SSR context with initial state
+ */
+export function createVueSSRContext(request, initialState = {}) {
+    const url = new URL(request.url);
+    return {
+        url: request.url,
+        request,
+        headers: new Headers(),
+        status: 200,
+        head: [],
+        body: [],
+        data: initialState,
+        modules: new Set(),
+        pathname: url.pathname,
+        query: url.searchParams,
+        params: {},
+    };
+}
+//# sourceMappingURL=vue.js.map

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

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

package/dist/frontend/ssr.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Server-Side Rendering (SSR) Implementation
+ *
+ * Provides a unified SSR system that supports:
+ * - React, Vue, Svelte, and Solid frameworks
+ * - Streaming SSR for faster TTFB
+ * - Client-side hydration
+ * - Server-side data fetching
+ * - Head management (title, meta, links)
+ */
+import type { FrontendFramework, PartialSSRConfig, PreloadLink, RenderResult, SSRConfig, SSRContext, SSRElement, SSRHydrationData, SSRRenderOptions } from "./types.js";
+/**
+ * Main SSR Renderer class
+ *
+ * Provides server-side rendering for all supported frameworks
+ * with streaming support and client hydration.
+ */
+export declare class SSRRenderer {
+    private config;
+    private logger;
+    private frameworkRenderer;
+    private pageCache;
+    constructor(config: PartialSSRConfig);
+    /**
+     * Normalize partial config to full config with defaults
+     */
+    private normalizeConfig;
+    /**
+     * Initialize the framework-specific renderer
+     */
+    init(): Promise<void>;
+    /**
+     * Create framework-specific renderer
+     */
+    private createFrameworkRenderer;
+    /**
+     * Render a page to HTML
+     */
+    render(url: string, request: Request): Promise<RenderResult>;
+    /**
+     * Render a page to a stream
+     */
+    renderToStream(url: string, request: Request): ReadableStream<Uint8Array>;
+    /**
+     * Render with options
+     */
+    renderWithOptions(options: SSRRenderOptions): Promise<RenderResult>;
+    /**
+     * Get client hydration script
+     */
+    getHydrationScript(): string;
+    /**
+     * Get preload links for modules
+     */
+    getPreloadLinks(modules: string[]): string;
+    /**
+     * Get CSS links for modules
+     */
+    getCSSLinks(modules: string[]): string;
+    /**
+     * Create SSR context
+     */
+    private createContext;
+    /**
+     * Load page module
+     */
+    private loadPage;
+    /**
+     * Render head elements to string
+     */
+    private renderHeadElements;
+    /**
+     * Convert SSR element to HTML string
+     */
+    private ssrElementToString;
+    /**
+     * Escape HTML special characters
+     */
+    private escapeHtml;
+    /**
+     * Render HTML preamble (opening tags)
+     */
+    private renderPreamble;
+    /**
+     * Render HTML footer (closing tags and scripts)
+     */
+    private renderFooter;
+    /**
+     * Render error page
+     */
+    private renderErrorPage;
+    /**
+     * Clear page cache
+     */
+    clearCache(): void;
+    /**
+     * Get configuration
+     */
+    getConfig(): SSRConfig;
+    /**
+     * Check if streaming is enabled
+     */
+    isStreamingEnabled(): boolean;
+    /**
+     * Get framework
+     */
+    getFramework(): FrontendFramework;
+}
+/**
+ * Create an SSR renderer
+ */
+export declare function createSSRRenderer(config: PartialSSRConfig): SSRRenderer;
+/**
+ * Create SSR context from request
+ */
+export declare function createSSRContext(request: Request, params?: Record<string, string>): SSRContext;
+/**
+ * Serialize data for hydration
+ */
+export declare function serializeHydrationData(data: SSRHydrationData): string;
+/**
+ * Deserialize hydration data
+ */
+export declare function deserializeHydrationData(json: string): SSRHydrationData;
+/**
+ * Generate HTML template
+ */
+export declare function generateHTML(options: {
+    head: string;
+    body: string;
+    data: Record<string, unknown>;
+    scripts: string[];
+    styles: string[];
+}): string;
+/**
+ * Create preload link tag
+ */
+export declare function createPreloadLink(link: PreloadLink): string;
+/**
+ * Merge multiple head element arrays
+ */
+export declare function mergeHeadElements(...arrays: SSRElement[][]): SSRElement[];
+export { createReactSSRRenderer, type ReactSSRRenderer } from "./ssr/react.js";
+export { createVueSSRRenderer, type VueSSRRenderer } from "./ssr/vue.js";
+export { createSvelteSSRRenderer, type SvelteSSRRenderer, } from "./ssr/svelte.js";
+export { createSolidSSRRenderer, type SolidSSRRenderer } from "./ssr/solid.js";
+//# sourceMappingURL=ssr.d.ts.map

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

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