baraqex 2.0.7 → 2.0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baraqex",
-  "version": "2.0.7",
+  "version": "2.0.8",
   "description": "A full-stack WebAssembly framework for building fast, modern web applications.",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/templates/fullstack-app/build-wasm.js

@@ -43,9 +43,9 @@ function buildWasm() {
     execSync('go mod init wasm-example', { cwd: goDir, stdio: 'inherit' });
   }
 
-  // Compile with the js/wasm target
+  // Compile with the js/wasm target; -s -w strips debug info to shrink the module
   execSync(
-    `go build -o "${wasmFile}" main.go`,
+    'go build -ldflags="-s -w" -o "' + wasmFile + '" main.go',
     {
       cwd: goDir,
       stdio: 'inherit',

package/templates/fullstack-app/build.mjs

@@ -104,7 +104,7 @@ async function buildServer() {
     target: ['node18'],
     format: 'esm',
     outfile: path.join(outdir, 'server.js'),
-    external: ['express', 'cors', 'compression', 'socket.io', 'dotenv'],
+    external: ['express', 'cors', 'compression', 'socket.io', 'dotenv', 'postcss', 'tailwindcss', 'autoprefixer', 'chokidar'],
     plugins: [
       {
         name: 'external-all',
@@ -114,7 +114,8 @@ async function buildServer() {
       }
     ],
     define: { 'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV || 'development') },
-    sourcemap: false
+    sourcemap: false,
+    minify: process.env.NODE_ENV === 'production'
   });
   console.log('✅ Server build complete');
 }

package/templates/fullstack-app/package.json

@@ -8,7 +8,7 @@
     "start": "node dist/server.js",
     "prod": "npm run build && npm run start",
     "dev": "tsx server.ts",
-    "build": "node build.mjs",
+    "build": "cross-env NODE_ENV=production node build.mjs",
     "build:wasm": "node build-wasm.js",
     "build:all": "node build-wasm.js && node build.mjs"
   },

package/templates/fullstack-app/server.ts

@@ -28,7 +28,17 @@ const io = new SocketServer(httpServer, {
 
 app.use(express.json());
 app.use(express.urlencoded({ extended: true }));
-app.use(compression());
+app.use(compression({
+  filter: (req, res) => {
+    const type = res.getHeader('Content-Type');
+    if (type === undefined) return true;
+    // Compress text-like responses plus binary assets that gzip well (wasm, svg, fonts)
+    if (/^(text\/|application\/(json|javascript|xml|wasm)|image\/svg|font\/)/i.test(String(type))) {
+      return true;
+    }
+    return compression.filter(req, res);
+  }
+}));
 app.use(cors());
 
 // ---------------------------------------------------------------------------
@@ -78,9 +88,15 @@ app.get('/api/posts', (req: Request, res: Response) => {
 // ---------------------------------------------------------------------------
 // Static assets: built client bundle + public (incl. WASM output)
 // ---------------------------------------------------------------------------
-app.use('/build', express.static(path.join(__dirname, 'build')));
-app.use('/wasm', express.static(path.join(__dirname, 'public', 'wasm')));
-app.use(express.static(path.join(__dirname, 'public')));
+// Dev must never cache rebuilt bundles; prod can cache them briefly. WASM files
+// are rebuilt via `npm run build:wasm` and are safe to cache for a long time.
+const buildCache = isDev
+  ? { setHeaders: (res: Response) => res.setHeader('Cache-Control', 'no-store') }
+  : { maxAge: '1h' };
+const wasmCache = { maxAge: '1y', immutable: true };
+app.use('/build', express.static(path.join(__dirname, 'build'), buildCache));
+app.use('/wasm', express.static(path.join(__dirname, 'public', 'wasm'), wasmCache));
+app.use(express.static(path.join(__dirname, 'public'), buildCache));
 
 // ---------------------------------------------------------------------------
 // Dev mode: esbuild context (bundles src + rebuilds on change)
@@ -135,23 +151,18 @@ async function buildStyles() {
   console.log('✅ styles.css built');
 }
 
-// Build the Tailwind stylesheet used by the SSR-rendered page (both modes)
-await buildStyles();
-
-// In dev, bundle the client with esbuild (rebuilds on change via the watcher below)
-if (isDev) {
-  await setupEsbuild();
-}
+// Build the Tailwind stylesheet and (in dev) rebuild it on change. In prod the
+// file is already written by `npm run build`, so only (re)build when missing.
+await Promise.all([
+  isDev || !existsSync(path.join(__dirname, 'build', 'styles.css')) ? buildStyles() : Promise.resolve(),
+  isDev ? setupEsbuild() : Promise.resolve()
+]);
 
-// Only load the Go runtime scripts when the WASM module has been built
-// (`npm run build:wasm` requires Go). Off by default so dev works without Go.
+// Only used when the Go WASM module has been built (`npm run build:wasm`,
+// requires Go). Off by default so dev works without Go.
 const hasWasm = existsSync(path.join(__dirname, 'public', 'wasm', 'example.wasm'))
   && existsSync(path.join(__dirname, 'public', 'wasm', 'wasm_exec.js'));
 
-const wasmScripts = hasWasm
-  ? '<script src="/wasm/wasm_exec.js"></script>'
-  : '<script>console.warn("Go WASM not built — run `npm run build:wasm` (requires Go)");</script>';
-
 // ---------------------------------------------------------------------------
 // SSR: render the App on the server, then hydrate on the client
 // ---------------------------------------------------------------------------
@@ -166,11 +177,20 @@ app.get('*', async (req: Request, res: Response, next: NextFunction) => {
       route,
       serverTime: new Date().toISOString(),
       serverRendered: true,
-      users: store.users
+      users: store.users,
+      hasWasm
     };
 
     const content = await renderToString(jsx(App, { route, initialState }));
 
+    // Load the Go runtime only on the /wasm page — Home/About never pay for it.
+    // Direct visits get it server-side; SPA navigation loads it dynamically.
+    const wasmRuntimeScript = req.path.startsWith('/wasm')
+      ? (hasWasm
+          ? '<script src="/wasm/wasm_exec.js" defer></script>'
+          : '<script>console.warn("Go WASM not built — run `npm run build:wasm` (requires Go)");</script>')
+      : '';
+
     const html = `<!DOCTYPE html>
 <html lang="en">
 <head>
@@ -183,8 +203,8 @@ app.get('*', async (req: Request, res: Response, next: NextFunction) => {
 </head>
 <body>
   <div id="root">${content}</div>
-  ${wasmScripts}
-  ${isDev ? '<script src="/socket.io/socket.io.js"></script>' : ''}
+  ${wasmRuntimeScript}
+  ${isDev ? '<script src="/socket.io/socket.io.js" defer></script>' : ''}
   <script src="/build/main.js" type="module"></script>
 </body>
 </html>`;
@@ -215,6 +235,9 @@ if (isDev) {
   watcher.on('change', async (changedPath) => {
     console.log(`[Watcher] Changed: ${changedPath}`);
     try {
+      if (changedPath.endsWith('styles.css')) {
+        await buildStyles();
+      }
       await esbuildContext?.rebuild();
       io.emit('reload');
       console.log('[Watcher] Rebuild + reload sent');

package/templates/fullstack-app/src/App.tsx

@@ -67,7 +67,7 @@ export function App({ route, initialState }: AppProps) {
       <main className="flex-grow max-w-5xl w-full mx-auto px-4 py-8">
         {current === 'home' && <HomePage initialState={initialState} />}
         {current === 'about' && <AboutPage />}
-        {current === 'wasm' && <WasmDemo />}
+        {current === 'wasm' && <WasmDemo hasWasm={!!initialState?.hasWasm} />}
       </main>
 
       <footer className="bg-gray-800 text-white">

package/templates/fullstack-app/src/main.tsx

@@ -1,6 +1,5 @@
 import { hydrate, jsx } from 'baraqex';
 import { App } from './App';
-import './styles.css';
 
 declare global {
   interface Window {

package/templates/fullstack-app/src/pages/WasmDemo.tsx

@@ -1,19 +1,39 @@
 import { jsx, useState, useEffect, batchUpdates } from 'baraqex';
 import { loadGoWasm } from 'baraqex';
 
-export function WasmDemo() {
+/**
+ * Ensure the Go runtime (wasm_exec.js) is available before loading the module.
+ * The SSR page preloads it on direct visits; SPA navigation loads it on demand.
+ */
+function ensureWasmRuntime(): Promise<void> {
+  const w = window as any;
+  if (w.Go) return Promise.resolve();
+  return new Promise((resolve, reject) => {
+    const script = document.createElement('script');
+    script.src = '/wasm/wasm_exec.js';
+    script.async = true;
+    script.onload = () => resolve();
+    script.onerror = () => reject(new Error('/wasm/wasm_exec.js could not be loaded'));
+    document.head.appendChild(script);
+  });
+}
+
+export function WasmDemo({ hasWasm = false }: { hasWasm?: boolean }) {
   const [ready, setReady] = useState(false);
-  const [status, setStatus] = useState('Preparing Go WASM…');
-  const [output, setOutput] = useState('');
+  const [status, setStatus] = useState(hasWasm ? 'Preparing Go WASM…' : 'Go WASM not built');
+  const [output, setOutput] = useState(hasWasm ? '' : 'Run `npm run build:wasm` (requires Go) to enable this page.');
   const [a, setA] = useState('5');
   const [b, setB] = useState('7');
   const [n, setN] = useState('10');
 
   useEffect(() => {
+    if (!hasWasm) return;
     let cancelled = false;
     (async () => {
       try {
         setStatus('Loading Go WASM module…');
+        await ensureWasmRuntime();
+        if (cancelled) return;
         await loadGoWasm('/wasm/example.wasm');
         if (cancelled) return;
         batchUpdates(() => {