rusty-ssr 0.1.0

High-performance SSR engine for Rust with V8 isolate pool and multi-tier caching
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154

#!/usr/bin/env node
/**
 * Example: Preact SSR Bundle Builder
 *
 * This example shows how to wrap a Preact SSR bundle for use with Rusty SSR.
 *
 * Prerequisites:
 *   1. Build your Preact app with Vite in IIFE format:
 *      vite.config.ts: build.rollupOptions.output.format = 'iife'
 *   2. Set IIFE name: build.rollupOptions.output.name = 'SSRBundle'
 *   3. Export renderToString from your entry point
 *
 * Usage:
 *   node examples/build-preact-bundle.js path/to/server-entry.js output/ssr-bundle.js
 *
 * Your Preact entry-server.tsx should look like:
 *
 *   import { h } from 'preact';
 *   import renderToString from 'preact-render-to-string';
 *   import App from './App';
 *
 *   export async function render(context) {
 *       const html = renderToString(<App url={context.url} data={context.data} />);
 *       return { html, head: '', initialData: context.data };
 *   }
 *
 *   // Re-export for IIFE bundle
 *   export { render as renderToString };
 */

import fs from 'fs';
import path from 'path';

// Parse arguments
const args = process.argv.slice(2);

if (args.length < 2) {
    console.log(`
Preact SSR Bundle Builder

Usage:
  node examples/build-preact-bundle.js <input> <output>

Arguments:
  input   Path to Vite SSR build output (IIFE format)
  output  Output path for Rusty SSR bundle

Example:
  node examples/build-preact-bundle.js dist/server/entry.js ssr-bundle.js
`);
    process.exit(1);
}

const inputPath = args[0];
const outputPath = args[1];

if (!fs.existsSync(inputPath)) {
    console.error(`Error: Input file not found: ${inputPath}`);
    process.exit(1);
}

// Read Vite SSR output (IIFE format)
const ssrCode = fs.readFileSync(inputPath, 'utf-8');

// Create wrapper that exposes renderPage globally
const wrappedBundle = `
// ============ Preact SSR Bundle ============
// Generated by: node examples/build-preact-bundle.js
// Source: ${inputPath}
// ============================================

${ssrCode}

// ============ Rusty SSR Integration ============

/**
 * Global render function called by Rust V8 engine
 *
 * @param {string} url - URL path to render
 * @param {object|string} data - Data from Rust (JSON)
 * @returns {string} Complete HTML document
 */
globalThis.renderPage = async function(url, data) {
    try {
        // Parse data if string
        const props = typeof data === 'string' ? JSON.parse(data) : (data || {});

        // Build context for Preact SSR
        const context = {
            url: url,
            data: props,
            headers: {},
            userAgent: 'Rusty-SSR/1.0',
        };

        // Call your SSR render function
        // Assumes SSRBundle.renderToString returns { html, head?, initialData? }
        const result = await SSRBundle.renderToString(context);

        // Build complete HTML document
        // CUSTOMIZE THIS for your project!
        const html = \`<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Preact App</title>
    \${result.head || ''}
    <!-- Add your CSS links here -->
</head>
<body>
    <div id="app">\${result.html}</div>
    <script>window.__INITIAL_DATA__ = \${JSON.stringify(result.initialData || props)}</script>
    <!-- Add your client bundle here -->
</body>
</html>\`;

        return html;
    } catch (error) {
        console.error('[Preact SSR] Error:', error);
        // Return error page instead of crashing
        return \`<!DOCTYPE html>
<html>
<head><title>SSR Error</title></head>
<body>
    <h1>Server Render Error</h1>
    <pre>\${error.stack || error.message}</pre>
</body>
</html>\`;
    }
};

console.log('[Preact SSR] Bundle loaded and ready');
`;

// Write output
const outputDir = path.dirname(outputPath);
if (outputDir && outputDir !== '.' && !fs.existsSync(outputDir)) {
    fs.mkdirSync(outputDir, { recursive: true });
}

fs.writeFileSync(outputPath, wrappedBundle);

console.log(`
Preact SSR Bundle Created
  Input:  ${inputPath} (${(ssrCode.length / 1024).toFixed(2)} KB)
  Output: ${outputPath} (${(wrappedBundle.length / 1024).toFixed(2)} KB)
  Global: renderPage(url, data)

Next steps:
  1. Customize the HTML template in the generated bundle
  2. Add your CSS/JS asset paths
  3. Start Rusty SSR: cargo run --example basic
`);