@buenojs/bueno 0.8.5 → 0.8.7

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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"}