hadars 0.1.36 → 0.1.38

package/cli-lib.ts

@@ -1,7 +1,7 @@
 import { existsSync } from 'node:fs'
 import { mkdir, writeFile, unlink } from 'node:fs/promises'
 import { resolve, join, dirname } from 'node:path'
-import { tmpdir } from 'node:os'
+import { fileURLToPath } from 'node:url'
 import * as Hadars from './src/build'
 import type { HadarsOptions } from './src/types/hadars'
 
@@ -70,11 +70,16 @@ async function bundleLambda(
 
     // 3. Write a temporary entry shim that statically imports the SSR module
     //    and the HTML template so esbuild can inline both.
-    const shimPath = join(tmpdir(), `hadars-lambda-shim-${Date.now()}.ts`)
+    // Write the shim inside cwd so esbuild's module resolution finds local
+    // node_modules when walking up from the shim's directory.
+    // Use the absolute path to lambda.js (sibling of the CLI in dist/) so the
+    // shim doesn't depend on package name resolution at all.
+    const lambdaModule = resolve(dirname(fileURLToPath(import.meta.url)), 'lambda.js')
+    const shimPath = join(cwd, `.hadars-lambda-shim-${Date.now()}.ts`)
     const shim = [
         `import * as ssrModule from ${JSON.stringify(ssrBundle)};`,
         `import outHtml from ${JSON.stringify(outHtml)};`,
-        `import { createLambdaHandler } from 'hadars/lambda';`,
+        `import { createLambdaHandler } from ${JSON.stringify(lambdaModule)};`,
         `import config from ${JSON.stringify(configPath)};`,
         `export const handler = createLambdaHandler(config as any, { ssrModule: ssrModule as any, outHtml });`,
     ].join('\n') + '\n'
@@ -93,16 +98,19 @@ async function bundleLambda(
             outfile: outputFile,
             sourcemap: false,
             loader: { '.html': 'text', '.tsx': 'tsx', '.ts': 'ts' },
-            // Node built-ins are available in Lambda — mark them all external.
-            packages: 'external',
-            // Keep React external so there's only one instance across the bundle.
-            external: ['react', 'react-dom', '@rspack/*'],
+            // @rspack/* contains native binaries and is build-time only —
+            // it is never imported at Lambda runtime, so mark it external.
+            // Everything else (React, hadars runtime, etc.) is bundled in to
+            // produce a truly self-contained single-file deployment.
+            external: ['@rspack/*'],
         })
         console.log(`Lambda bundle written to ${outputFile}`)
         console.log(`\nDeploy instructions:`)
-        console.log(`  1. Upload ${outputFile} as your Lambda function code`)
-        console.log(`  2. Set handler to: index.handler`)
-        console.log(`  3. Upload .hadars/static/ assets to S3 and serve them via CloudFront`)
+        console.log(`  1. Create a staging directory with just this file:`)
+        console.log(`       mkdir -p lambda-deploy && cp ${outputFile} lambda-deploy/lambda.mjs`)
+        console.log(`  2. Upload lambda-deploy/ as your Lambda function code`)
+        console.log(`  3. Set handler to: lambda.handler  (runtime: Node.js 20.x)`)
+        console.log(`  4. Upload .hadars/static/ assets to S3 and serve via CloudFront`)
         console.log(`     (the Lambda handler does not serve static JS/CSS — route those to S3)`)
     } finally {
         await unlink(shimPath).catch(() => {})

package/dist/{chunk-OID7K4D3.js → chunk-F7IIMM3J.js}

@@ -5,7 +5,7 @@ import {
   SLIM_ELEMENT,
   SUSPENSE_TYPE,
   createElement
-} from "./chunk-OZUZS2PD.js";
+} from "./chunk-OS3V4CPN.js";
 
 // src/slim-react/renderContext.ts
 var MAP_KEY = "__slimReactContextMap";
@@ -577,12 +577,12 @@ function renderHostElement(tag, props, writer, isSvg) {
   }
   writer.write(`</${tag}>`);
 }
-var REACT_MEMO = /* @__PURE__ */ Symbol.for("react.memo");
-var REACT_FORWARD_REF = /* @__PURE__ */ Symbol.for("react.forward_ref");
-var REACT_PROVIDER = /* @__PURE__ */ Symbol.for("react.provider");
-var REACT_CONTEXT = /* @__PURE__ */ Symbol.for("react.context");
-var REACT_CONSUMER = /* @__PURE__ */ Symbol.for("react.consumer");
-var REACT_LAZY = /* @__PURE__ */ Symbol.for("react.lazy");
+var REACT_MEMO = Symbol.for("react.memo");
+var REACT_FORWARD_REF = Symbol.for("react.forward_ref");
+var REACT_PROVIDER = Symbol.for("react.provider");
+var REACT_CONTEXT = Symbol.for("react.context");
+var REACT_CONSUMER = Symbol.for("react.consumer");
+var REACT_LAZY = Symbol.for("react.lazy");
 function renderComponent(type, props, writer, isSvg) {
   const typeOf = type?.$$typeof;
   if (typeOf === REACT_MEMO) {

package/dist/{chunk-OZUZS2PD.js → chunk-OS3V4CPN.js}

@@ -1,8 +1,8 @@
 // src/slim-react/types.ts
-var SLIM_ELEMENT = /* @__PURE__ */ Symbol.for("react.element");
-var REACT19_ELEMENT = /* @__PURE__ */ Symbol.for("react.transitional.element");
-var FRAGMENT_TYPE = /* @__PURE__ */ Symbol.for("react.fragment");
-var SUSPENSE_TYPE = /* @__PURE__ */ Symbol.for("react.suspense");
+var SLIM_ELEMENT = Symbol.for("react.element");
+var REACT19_ELEMENT = Symbol.for("react.transitional.element");
+var FRAGMENT_TYPE = Symbol.for("react.fragment");
+var SUSPENSE_TYPE = Symbol.for("react.suspense");
 
 // src/slim-react/jsx.ts
 var Fragment = FRAGMENT_TYPE;

package/dist/cli.js

@@ -6,8 +6,8 @@ import { spawn as spawn2 } from "node:child_process";
 // cli-lib.ts
 import { existsSync as existsSync3 } from "node:fs";
 import { mkdir, writeFile, unlink } from "node:fs/promises";
-import { resolve, join } from "node:path";
-import { tmpdir } from "node:os";
+import { resolve, join, dirname } from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // src/utils/proxyHandler.tsx
 var cloneHeaders = (headers) => {
@@ -1307,6 +1307,29 @@ var buildCompilerConfig = (entry, opts, includeHotPlugin) => {
     }
   }
   const extraPlugins = [];
+  if (!isServerBuild) {
+    extraPlugins.push({
+      apply(compiler) {
+        compiler.hooks.compilation.tap("HadarsWorkerChunkLoading", (compilation) => {
+          compilation.hooks.childCompiler.tap(
+            "HadarsWorkerChunkLoading",
+            (childCompiler) => {
+              const libType = childCompiler.options?.output?.library?.type;
+              if (libType === "module" || libType === "commonjs" || libType === "commonjs2") {
+                return;
+              }
+              if (childCompiler.options?.output) {
+                childCompiler.options.output.chunkLoading = "import-scripts";
+              }
+              if (childCompiler.options?.experiments) {
+                childCompiler.options.experiments.outputModule = false;
+              }
+            }
+          );
+        });
+      }
+    });
+  }
   const defineValues = { ...opts.define ?? {} };
   if (!isServerBuild && opts.reactMode !== void 0) {
     defineValues["process.env.NODE_ENV"] = JSON.stringify(opts.reactMode);
@@ -1383,7 +1406,8 @@ var buildCompilerConfig = (entry, opts, includeHotPlugin) => {
       },
       isDev && !isServerBuild && new ReactRefreshPlugin(),
       includeHotPlugin && isDev && !isServerBuild && new rspack.HotModuleReplacementPlugin(),
-      ...extraPlugins
+      ...extraPlugins,
+      ...opts.plugins ?? []
     ],
     ...localConfig,
     // Merge base resolve (modules, tsConfig, extensions) with per-build resolve
@@ -1983,6 +2007,7 @@ var dev = async (options) => {
     swcPlugins: options.swcPlugins,
     define: options.define,
     moduleRules: options.moduleRules,
+    plugins: options.plugins,
     reactMode: options.reactMode,
     htmlTemplate: resolvedHtmlTemplate
   });
@@ -2201,6 +2226,7 @@ var build = async (options) => {
       swcPlugins: options.swcPlugins,
       define: options.define,
       moduleRules: options.moduleRules,
+      plugins: options.plugins,
       optimization: options.optimization,
       reactMode: options.reactMode,
       htmlTemplate: resolvedHtmlTemplate
@@ -2218,7 +2244,8 @@ var build = async (options) => {
       mode: "production",
       swcPlugins: options.swcPlugins,
       define: options.define,
-      moduleRules: options.moduleRules
+      moduleRules: options.moduleRules,
+      plugins: options.plugins
     })
   ]);
   await fs.rm(tmpFilePath);
@@ -2374,11 +2401,12 @@ async function bundleLambda(config, configPath, outputFile, cwd) {
     console.error(`HTML template not found: ${outHtml}`);
     process.exit(1);
   }
-  const shimPath = join(tmpdir(), `hadars-lambda-shim-${Date.now()}.ts`);
+  const lambdaModule = resolve(dirname(fileURLToPath3(import.meta.url)), "lambda.js");
+  const shimPath = join(cwd, `.hadars-lambda-shim-${Date.now()}.ts`);
   const shim = [
     `import * as ssrModule from ${JSON.stringify(ssrBundle)};`,
     `import outHtml from ${JSON.stringify(outHtml)};`,
-    `import { createLambdaHandler } from 'hadars/lambda';`,
+    `import { createLambdaHandler } from ${JSON.stringify(lambdaModule)};`,
     `import config from ${JSON.stringify(configPath)};`,
     `export const handler = createLambdaHandler(config as any, { ssrModule: ssrModule as any, outHtml });`
   ].join("\n") + "\n";
@@ -2395,17 +2423,20 @@ async function bundleLambda(config, configPath, outputFile, cwd) {
       outfile: outputFile,
       sourcemap: false,
       loader: { ".html": "text", ".tsx": "tsx", ".ts": "ts" },
-      // Node built-ins are available in Lambda — mark them all external.
-      packages: "external",
-      // Keep React external so there's only one instance across the bundle.
-      external: ["react", "react-dom", "@rspack/*"]
+      // @rspack/* contains native binaries and is build-time only —
+      // it is never imported at Lambda runtime, so mark it external.
+      // Everything else (React, hadars runtime, etc.) is bundled in to
+      // produce a truly self-contained single-file deployment.
+      external: ["@rspack/*"]
     });
     console.log(`Lambda bundle written to ${outputFile}`);
     console.log(`
 Deploy instructions:`);
-    console.log(`  1. Upload ${outputFile} as your Lambda function code`);
-    console.log(`  2. Set handler to: index.handler`);
-    console.log(`  3. Upload .hadars/static/ assets to S3 and serve them via CloudFront`);
+    console.log(`  1. Create a staging directory with just this file:`);
+    console.log(`       mkdir -p lambda-deploy && cp ${outputFile} lambda-deploy/lambda.mjs`);
+    console.log(`  2. Upload lambda-deploy/ as your Lambda function code`);
+    console.log(`  3. Set handler to: lambda.handler  (runtime: Node.js 20.x)`);
+    console.log(`  4. Upload .hadars/static/ assets to S3 and serve via CloudFront`);
     console.log(`     (the Lambda handler does not serve static JS/CSS \u2014 route those to S3)`);
   } finally {
     await unlink(shimPath).catch(() => {

package/dist/{hadars-ScRgKezP.d.cts → hadars-B3b_6sj2.d.cts}

@@ -137,6 +137,18 @@ interface HadarsOptions {
      * ]
      */
     moduleRules?: Record<string, any>[];
+    /**
+     * Additional rspack/webpack-compatible plugins applied to both the client
+     * and SSR bundles. Any object that implements the `apply(compiler)` method
+     * (the standard webpack/rspack plugin interface) is accepted.
+     *
+     * @example
+     * import { SubresourceIntegrityPlugin } from 'webpack-subresource-integrity';
+     * plugins: [new SubresourceIntegrityPlugin()]
+     */
+    plugins?: Array<{
+        apply(compiler: any): void;
+    }>;
     /**
      * SSR response cache for `run()` mode. Has no effect in `dev()` mode.
      *

package/dist/{hadars-ScRgKezP.d.ts → hadars-B3b_6sj2.d.ts}

@@ -137,6 +137,18 @@ interface HadarsOptions {
      * ]
      */
     moduleRules?: Record<string, any>[];
+    /**
+     * Additional rspack/webpack-compatible plugins applied to both the client
+     * and SSR bundles. Any object that implements the `apply(compiler)` method
+     * (the standard webpack/rspack plugin interface) is accepted.
+     *
+     * @example
+     * import { SubresourceIntegrityPlugin } from 'webpack-subresource-integrity';
+     * plugins: [new SubresourceIntegrityPlugin()]
+     */
+    plugins?: Array<{
+        apply(compiler: any): void;
+    }>;
     /**
      * SSR response cache for `run()` mode. Has no effect in `dev()` mode.
      *

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as React$1 from 'react';
 import React__default from 'react';
-import { A as AppContext } from './hadars-ScRgKezP.cjs';
-export { b as HadarsApp, H as HadarsEntryModule, c as HadarsGetAfterRenderProps, d as HadarsGetClientProps, e as HadarsGetFinalProps, f as HadarsGetInitialProps, a as HadarsOptions, g as HadarsProps, h as HadarsRequest } from './hadars-ScRgKezP.cjs';
+import { A as AppContext } from './hadars-B3b_6sj2.cjs';
+export { b as HadarsApp, H as HadarsEntryModule, c as HadarsGetAfterRenderProps, d as HadarsGetClientProps, e as HadarsGetFinalProps, f as HadarsGetInitialProps, a as HadarsOptions, g as HadarsProps, h as HadarsRequest } from './hadars-B3b_6sj2.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /** Call this before hydrating to seed the client cache from the server's data.

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as React$1 from 'react';
 import React__default from 'react';
-import { A as AppContext } from './hadars-ScRgKezP.js';
-export { b as HadarsApp, H as HadarsEntryModule, c as HadarsGetAfterRenderProps, d as HadarsGetClientProps, e as HadarsGetFinalProps, f as HadarsGetInitialProps, a as HadarsOptions, g as HadarsProps, h as HadarsRequest } from './hadars-ScRgKezP.js';
+import { A as AppContext } from './hadars-B3b_6sj2.js';
+export { b as HadarsApp, H as HadarsEntryModule, c as HadarsGetAfterRenderProps, d as HadarsGetClientProps, e as HadarsGetFinalProps, f as HadarsGetInitialProps, a as HadarsOptions, g as HadarsProps, h as HadarsRequest } from './hadars-B3b_6sj2.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /** Call this before hydrating to seed the client cache from the server's data.

package/dist/lambda.cjs

@@ -193,10 +193,10 @@ async function tryServeFile(filePath) {
 }
 
 // src/slim-react/types.ts
-var SLIM_ELEMENT = /* @__PURE__ */ Symbol.for("react.element");
-var REACT19_ELEMENT = /* @__PURE__ */ Symbol.for("react.transitional.element");
-var FRAGMENT_TYPE = /* @__PURE__ */ Symbol.for("react.fragment");
-var SUSPENSE_TYPE = /* @__PURE__ */ Symbol.for("react.suspense");
+var SLIM_ELEMENT = Symbol.for("react.element");
+var REACT19_ELEMENT = Symbol.for("react.transitional.element");
+var FRAGMENT_TYPE = Symbol.for("react.fragment");
+var SUSPENSE_TYPE = Symbol.for("react.suspense");
 
 // src/slim-react/jsx.ts
 function createElement(type, props, ...children) {
@@ -754,12 +754,12 @@ function renderHostElement(tag, props, writer, isSvg) {
   }
   writer.write(`</${tag}>`);
 }
-var REACT_MEMO = /* @__PURE__ */ Symbol.for("react.memo");
-var REACT_FORWARD_REF = /* @__PURE__ */ Symbol.for("react.forward_ref");
-var REACT_PROVIDER = /* @__PURE__ */ Symbol.for("react.provider");
-var REACT_CONTEXT = /* @__PURE__ */ Symbol.for("react.context");
-var REACT_CONSUMER = /* @__PURE__ */ Symbol.for("react.consumer");
-var REACT_LAZY = /* @__PURE__ */ Symbol.for("react.lazy");
+var REACT_MEMO = Symbol.for("react.memo");
+var REACT_FORWARD_REF = Symbol.for("react.forward_ref");
+var REACT_PROVIDER = Symbol.for("react.provider");
+var REACT_CONTEXT = Symbol.for("react.context");
+var REACT_CONSUMER = Symbol.for("react.consumer");
+var REACT_LAZY = Symbol.for("react.lazy");
 function renderComponent(type, props, writer, isSvg) {
   const typeOf = type?.$$typeof;
   if (typeOf === REACT_MEMO) {
@@ -1161,22 +1161,10 @@ var getReactResponse = async (req, opts) => {
 var HEAD_MARKER = '<meta name="HADARS_HEAD">';
 var BODY_MARKER = '<meta name="HADARS_BODY">';
 var encoder = new TextEncoder();
-async function buildSsrResponse(bodyHtml, clientProps, headHtml, status, getPrecontentHtml) {
-  const responseStream = new ReadableStream({
-    async start(controller) {
-      const [precontentHtml, postContent] = await getPrecontentHtml(headHtml);
-      controller.enqueue(encoder.encode(precontentHtml));
-      const scriptContent = JSON.stringify({ hadars: { props: clientProps } }).replace(/</g, "\\u003c");
-      controller.enqueue(encoder.encode(
-        `<div id="app">${bodyHtml}</div><script id="hadars" type="application/json">${scriptContent}</script>` + postContent
-      ));
-      controller.close();
-    }
-  });
-  return new Response(responseStream, {
-    headers: { "Content-Type": "text/html; charset=utf-8" },
-    status
-  });
+async function buildSsrHtml(bodyHtml, clientProps, headHtml, getPrecontentHtml) {
+  const [precontentHtml, postContent] = await getPrecontentHtml(headHtml);
+  const scriptContent = JSON.stringify({ hadars: { props: clientProps } }).replace(/</g, "\\u003c");
+  return precontentHtml + `<div id="app">${bodyHtml}</div><script id="hadars" type="application/json">${scriptContent}</script>` + postContent;
 }
 var makePrecontentHtmlGetter = (htmlFilePromise) => {
   let preHead = null;
@@ -1340,6 +1328,14 @@ function createLambdaHandler(options, bundled) {
   const fetchHandler = options.fetch;
   const handleProxy = createProxyHandler(options);
   const getPrecontentHtml = bundled ? makePrecontentHtmlGetter(Promise.resolve(bundled.outHtml)) : makePrecontentHtmlGetter(import_promises2.default.readFile(import_node_path.default.join(cwd, StaticPath, "out.html"), "utf-8"));
+  let ssrModulePromise = null;
+  const getSsrModule = () => {
+    if (bundled) return Promise.resolve(bundled.ssrModule);
+    if (!ssrModulePromise) {
+      ssrModulePromise = import((0, import_node_url.pathToFileURL)(import_node_path.default.resolve(cwd, HadarsFolder, SSR_FILENAME)).href);
+    }
+    return ssrModulePromise;
+  };
   const runHandler = async (req) => {
     const request = parseRequest(req);
     if (fetchHandler) {
@@ -1369,7 +1365,7 @@ function createLambdaHandler(options, bundled) {
         getInitProps,
         getAfterRenderProps,
         getFinalProps
-      } = bundled ? bundled.ssrModule : await import((0, import_node_url.pathToFileURL)(import_node_path.default.resolve(cwd, HadarsFolder, SSR_FILENAME)).href);
+      } = await getSsrModule();
       const { bodyHtml, clientProps, status, headHtml } = await getReactResponse(request, {
         document: {
           body: Component,
@@ -1386,7 +1382,11 @@ function createLambdaHandler(options, bundled) {
           headers: { "Content-Type": "application/json; charset=utf-8" }
         });
       }
-      return buildSsrResponse(bodyHtml, clientProps, headHtml, status, getPrecontentHtml);
+      const html = await buildSsrHtml(bodyHtml, clientProps, headHtml, getPrecontentHtml);
+      return new Response(html, {
+        status,
+        headers: { "Content-Type": "text/html; charset=utf-8" }
+      });
     } catch (err) {
       console.error("[hadars] SSR render error:", err);
       return new Response("Internal Server Error", { status: 500 });

package/dist/lambda.d.cts

@@ -1,4 +1,4 @@
-import { H as HadarsEntryModule, a as HadarsOptions } from './hadars-ScRgKezP.cjs';
+import { H as HadarsEntryModule, a as HadarsOptions } from './hadars-B3b_6sj2.cjs';
 import 'react';
 
 /**

package/dist/lambda.d.ts

@@ -1,4 +1,4 @@
-import { H as HadarsEntryModule, a as HadarsOptions } from './hadars-ScRgKezP.js';
+import { H as HadarsEntryModule, a as HadarsOptions } from './hadars-B3b_6sj2.js';
 import 'react';
 
 /**

package/dist/lambda.js

@@ -3,16 +3,16 @@ import {
 } from "./chunk-UNQSQIOO.js";
 import {
   renderToString
-} from "./chunk-OID7K4D3.js";
+} from "./chunk-F7IIMM3J.js";
 import {
   createElement
-} from "./chunk-OZUZS2PD.js";
+} from "./chunk-OS3V4CPN.js";
 
 // src/lambda.ts
 import "react";
-import pathMod from "path";
-import { pathToFileURL } from "url";
-import fs from "fs/promises";
+import pathMod from "node:path";
+import { pathToFileURL } from "node:url";
+import fs from "node:fs/promises";
 
 // src/utils/proxyHandler.tsx
 var cloneHeaders = (headers) => {
@@ -127,7 +127,7 @@ var parseRequest = (request) => {
 };
 
 // src/utils/staticFile.ts
-import { readFile, stat } from "fs/promises";
+import { readFile, stat } from "node:fs/promises";
 var MIME = {
   html: "text/html; charset=utf-8",
   htm: "text/html; charset=utf-8",
@@ -256,22 +256,10 @@ var getReactResponse = async (req, opts) => {
 var HEAD_MARKER = '<meta name="HADARS_HEAD">';
 var BODY_MARKER = '<meta name="HADARS_BODY">';
 var encoder = new TextEncoder();
-async function buildSsrResponse(bodyHtml, clientProps, headHtml, status, getPrecontentHtml) {
-  const responseStream = new ReadableStream({
-    async start(controller) {
-      const [precontentHtml, postContent] = await getPrecontentHtml(headHtml);
-      controller.enqueue(encoder.encode(precontentHtml));
-      const scriptContent = JSON.stringify({ hadars: { props: clientProps } }).replace(/</g, "\\u003c");
-      controller.enqueue(encoder.encode(
-        `<div id="app">${bodyHtml}</div><script id="hadars" type="application/json">${scriptContent}</script>` + postContent
-      ));
-      controller.close();
-    }
-  });
-  return new Response(responseStream, {
-    headers: { "Content-Type": "text/html; charset=utf-8" },
-    status
-  });
+async function buildSsrHtml(bodyHtml, clientProps, headHtml, getPrecontentHtml) {
+  const [precontentHtml, postContent] = await getPrecontentHtml(headHtml);
+  const scriptContent = JSON.stringify({ hadars: { props: clientProps } }).replace(/</g, "\\u003c");
+  return precontentHtml + `<div id="app">${bodyHtml}</div><script id="hadars" type="application/json">${scriptContent}</script>` + postContent;
 }
 var makePrecontentHtmlGetter = (htmlFilePromise) => {
   let preHead = null;
@@ -435,6 +423,14 @@ function createLambdaHandler(options, bundled) {
   const fetchHandler = options.fetch;
   const handleProxy = createProxyHandler(options);
   const getPrecontentHtml = bundled ? makePrecontentHtmlGetter(Promise.resolve(bundled.outHtml)) : makePrecontentHtmlGetter(fs.readFile(pathMod.join(cwd, StaticPath, "out.html"), "utf-8"));
+  let ssrModulePromise = null;
+  const getSsrModule = () => {
+    if (bundled) return Promise.resolve(bundled.ssrModule);
+    if (!ssrModulePromise) {
+      ssrModulePromise = import(pathToFileURL(pathMod.resolve(cwd, HadarsFolder, SSR_FILENAME)).href);
+    }
+    return ssrModulePromise;
+  };
   const runHandler = async (req) => {
     const request = parseRequest(req);
     if (fetchHandler) {
@@ -464,7 +460,7 @@ function createLambdaHandler(options, bundled) {
         getInitProps,
         getAfterRenderProps,
         getFinalProps
-      } = bundled ? bundled.ssrModule : await import(pathToFileURL(pathMod.resolve(cwd, HadarsFolder, SSR_FILENAME)).href);
+      } = await getSsrModule();
       const { bodyHtml, clientProps, status, headHtml } = await getReactResponse(request, {
         document: {
           body: Component,
@@ -481,7 +477,11 @@ function createLambdaHandler(options, bundled) {
           headers: { "Content-Type": "application/json; charset=utf-8" }
         });
       }
-      return buildSsrResponse(bodyHtml, clientProps, headHtml, status, getPrecontentHtml);
+      const html = await buildSsrHtml(bodyHtml, clientProps, headHtml, getPrecontentHtml);
+      return new Response(html, {
+        status,
+        headers: { "Content-Type": "text/html; charset=utf-8" }
+      });
     } catch (err) {
       console.error("[hadars] SSR render error:", err);
       return new Response("Internal Server Error", { status: 500 });

package/dist/slim-react/index.cjs

@@ -77,10 +77,10 @@ __export(slim_react_exports, {
 module.exports = __toCommonJS(slim_react_exports);
 
 // src/slim-react/types.ts
-var SLIM_ELEMENT = /* @__PURE__ */ Symbol.for("react.element");
-var REACT19_ELEMENT = /* @__PURE__ */ Symbol.for("react.transitional.element");
-var FRAGMENT_TYPE = /* @__PURE__ */ Symbol.for("react.fragment");
-var SUSPENSE_TYPE = /* @__PURE__ */ Symbol.for("react.suspense");
+var SLIM_ELEMENT = Symbol.for("react.element");
+var REACT19_ELEMENT = Symbol.for("react.transitional.element");
+var FRAGMENT_TYPE = Symbol.for("react.fragment");
+var SUSPENSE_TYPE = Symbol.for("react.suspense");
 
 // src/slim-react/jsx.ts
 var Fragment = FRAGMENT_TYPE;
@@ -679,12 +679,12 @@ function renderHostElement(tag, props, writer, isSvg) {
   }
   writer.write(`</${tag}>`);
 }
-var REACT_MEMO = /* @__PURE__ */ Symbol.for("react.memo");
-var REACT_FORWARD_REF = /* @__PURE__ */ Symbol.for("react.forward_ref");
-var REACT_PROVIDER = /* @__PURE__ */ Symbol.for("react.provider");
-var REACT_CONTEXT = /* @__PURE__ */ Symbol.for("react.context");
-var REACT_CONSUMER = /* @__PURE__ */ Symbol.for("react.consumer");
-var REACT_LAZY = /* @__PURE__ */ Symbol.for("react.lazy");
+var REACT_MEMO = Symbol.for("react.memo");
+var REACT_FORWARD_REF = Symbol.for("react.forward_ref");
+var REACT_PROVIDER = Symbol.for("react.provider");
+var REACT_CONTEXT = Symbol.for("react.context");
+var REACT_CONSUMER = Symbol.for("react.consumer");
+var REACT_LAZY = Symbol.for("react.lazy");
 function renderComponent(type, props, writer, isSvg) {
   const typeOf = type?.$$typeof;
   if (typeOf === REACT_MEMO) {

package/dist/slim-react/index.js

@@ -33,7 +33,7 @@ import {
   useSyncExternalStore,
   useTransition,
   version
-} from "../chunk-OID7K4D3.js";
+} from "../chunk-F7IIMM3J.js";
 import {
   FRAGMENT_TYPE,
   Fragment,
@@ -41,7 +41,7 @@ import {
   SUSPENSE_TYPE,
   createElement,
   jsx
-} from "../chunk-OZUZS2PD.js";
+} from "../chunk-OS3V4CPN.js";
 export {
   Children,
   Component,

package/dist/slim-react/jsx-runtime.cjs

@@ -28,8 +28,10 @@ __export(jsx_runtime_exports, {
 module.exports = __toCommonJS(jsx_runtime_exports);
 
 // src/slim-react/types.ts
-var SLIM_ELEMENT = /* @__PURE__ */ Symbol.for("react.element");
-var FRAGMENT_TYPE = /* @__PURE__ */ Symbol.for("react.fragment");
+var SLIM_ELEMENT = Symbol.for("react.element");
+var REACT19_ELEMENT = Symbol.for("react.transitional.element");
+var FRAGMENT_TYPE = Symbol.for("react.fragment");
+var SUSPENSE_TYPE = Symbol.for("react.suspense");
 
 // src/slim-react/jsx.ts
 var Fragment = FRAGMENT_TYPE;

package/dist/slim-react/jsx-runtime.js

@@ -1,7 +1,7 @@
 import {
   Fragment,
   jsx
-} from "../chunk-OZUZS2PD.js";
+} from "../chunk-OS3V4CPN.js";
 export {
   Fragment,
   jsx,

package/dist/ssr-watch.js

@@ -208,6 +208,29 @@ var buildCompilerConfig = (entry2, opts, includeHotPlugin) => {
     }
   }
   const extraPlugins = [];
+  if (!isServerBuild) {
+    extraPlugins.push({
+      apply(compiler) {
+        compiler.hooks.compilation.tap("HadarsWorkerChunkLoading", (compilation) => {
+          compilation.hooks.childCompiler.tap(
+            "HadarsWorkerChunkLoading",
+            (childCompiler) => {
+              const libType = childCompiler.options?.output?.library?.type;
+              if (libType === "module" || libType === "commonjs" || libType === "commonjs2") {
+                return;
+              }
+              if (childCompiler.options?.output) {
+                childCompiler.options.output.chunkLoading = "import-scripts";
+              }
+              if (childCompiler.options?.experiments) {
+                childCompiler.options.experiments.outputModule = false;
+              }
+            }
+          );
+        });
+      }
+    });
+  }
   const defineValues = { ...opts.define ?? {} };
   if (!isServerBuild && opts.reactMode !== void 0) {
     defineValues["process.env.NODE_ENV"] = JSON.stringify(opts.reactMode);
@@ -284,7 +307,8 @@ var buildCompilerConfig = (entry2, opts, includeHotPlugin) => {
       },
       isDev && !isServerBuild && new ReactRefreshPlugin(),
       includeHotPlugin && isDev && !isServerBuild && new rspack.HotModuleReplacementPlugin(),
-      ...extraPlugins
+      ...extraPlugins,
+      ...opts.plugins ?? []
     ],
     ...localConfig,
     // Merge base resolve (modules, tsConfig, extensions) with per-build resolve

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hadars",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "description": "Minimal SSR framework for React — rspack, HMR, TypeScript, Bun/Node/Deno",
   "module": "./dist/index.js",
   "type": "module",
@@ -79,7 +79,7 @@
     "@types/react-dom": "^19.2.3",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
-    "tsup": "^8.5.1",
+    "tsup": "^8.3.5",
     "typescript": "^5.9.3"
   },
   "dependencies": {

package/src/build.ts

@@ -341,6 +341,7 @@ export const dev = async (options: HadarsRuntimeOptions) => {
         swcPlugins: options.swcPlugins,
         define: options.define,
         moduleRules: options.moduleRules,
+        plugins: options.plugins,
         reactMode: options.reactMode,
         htmlTemplate: resolvedHtmlTemplate,
     });
@@ -596,6 +597,7 @@ export const build = async (options: HadarsRuntimeOptions) => {
             swcPlugins: options.swcPlugins,
             define: options.define,
             moduleRules: options.moduleRules,
+            plugins: options.plugins,
             optimization: options.optimization,
             reactMode: options.reactMode,
             htmlTemplate: resolvedHtmlTemplate,
@@ -614,6 +616,7 @@ export const build = async (options: HadarsRuntimeOptions) => {
             swcPlugins: options.swcPlugins,
             define: options.define,
             moduleRules: options.moduleRules,
+            plugins: options.plugins,
         }),
     ]);
     await fs.rm(tmpFilePath);

package/src/lambda.ts

@@ -24,7 +24,7 @@ import { createProxyHandler } from './utils/proxyHandler';
 import { parseRequest } from './utils/request';
 import { tryServeFile } from './utils/staticFile';
 import { getReactResponse } from './utils/response';
-import { buildSsrResponse, makePrecontentHtmlGetter, createRenderCache } from './utils/ssrHandler';
+import { buildSsrResponse, buildSsrHtml, makePrecontentHtmlGetter, createRenderCache } from './utils/ssrHandler';
 import type { HadarsOptions, HadarsEntryModule, HadarsProps } from './types/hadars';
 
 // ── Lambda event / response types ────────────────────────────────────────────
@@ -189,6 +189,21 @@ export function createLambdaHandler(options: HadarsOptions, bundled?: LambdaBund
         ? makePrecontentHtmlGetter(Promise.resolve(bundled.outHtml))
         : makePrecontentHtmlGetter(fs.readFile(pathMod.join(cwd, StaticPath, 'out.html'), 'utf-8'));
 
+    // Hoist the SSR module reference so it is resolved once, not on every
+    // request. In bundled mode the module is already in-memory; in file-based
+    // mode we lazily import it and cache the promise so Node's module cache is
+    // only consulted once.
+    let ssrModulePromise: Promise<HadarsEntryModule<any>> | null = null;
+    const getSsrModule = (): Promise<HadarsEntryModule<any>> => {
+        if (bundled) return Promise.resolve(bundled.ssrModule);
+        if (!ssrModulePromise) {
+            ssrModulePromise = import(
+                pathToFileURL(pathMod.resolve(cwd, HadarsFolder, SSR_FILENAME)).href
+            ) as Promise<HadarsEntryModule<any>>;
+        }
+        return ssrModulePromise;
+    };
+
     const runHandler = async (req: Request): Promise<Response> => {
         const request = parseRequest(req);
 
@@ -227,9 +242,7 @@ export function createLambdaHandler(options: HadarsOptions, bundled?: LambdaBund
                 getInitProps,
                 getAfterRenderProps,
                 getFinalProps,
-            } = bundled
-                ? bundled.ssrModule
-                : (await import(pathToFileURL(pathMod.resolve(cwd, HadarsFolder, SSR_FILENAME)).href)) as HadarsEntryModule<any>;
+            } = await getSsrModule();
 
             const { bodyHtml, clientProps, status, headHtml } = await getReactResponse(request, {
                 document: {
@@ -249,7 +262,13 @@ export function createLambdaHandler(options: HadarsOptions, bundled?: LambdaBund
                 });
             }
 
-            return buildSsrResponse(bodyHtml, clientProps, headHtml, status, getPrecontentHtml);
+            // Build the HTML string directly — avoids creating a ReadableStream
+            // that would immediately be drained by the Lambda response serialiser.
+            const html = await buildSsrHtml(bodyHtml, clientProps, headHtml, getPrecontentHtml);
+            return new Response(html, {
+                status,
+                headers: { 'Content-Type': 'text/html; charset=utf-8' },
+            });
         } catch (err: any) {
             console.error('[hadars] SSR render error:', err);
             return new Response('Internal Server Error', { status: 500 });

package/src/types/hadars.ts

@@ -142,6 +142,16 @@ export interface HadarsOptions {
      * ]
      */
     moduleRules?: Record<string, any>[];
+    /**
+     * Additional rspack/webpack-compatible plugins applied to both the client
+     * and SSR bundles. Any object that implements the `apply(compiler)` method
+     * (the standard webpack/rspack plugin interface) is accepted.
+     *
+     * @example
+     * import { SubresourceIntegrityPlugin } from 'webpack-subresource-integrity';
+     * plugins: [new SubresourceIntegrityPlugin()]
+     */
+    plugins?: Array<{ apply(compiler: any): void }>;
     /**
      * SSR response cache for `run()` mode. Has no effect in `dev()` mode.
      *

package/src/utils/rspack.ts

@@ -136,6 +136,8 @@ interface EntryOptions {
     optimization?: Record<string, unknown>;
     // additional module rules appended after the built-in rules
     moduleRules?: Record<string, any>[];
+    // additional rspack/webpack-compatible plugins (applied after built-in plugins)
+    plugins?: Array<{ apply(compiler: any): void }>;
     // force React runtime mode independently of build mode (client only)
     reactMode?: 'development' | 'production';
 }
@@ -264,6 +266,39 @@ const buildCompilerConfig = (
     }
 
     const extraPlugins: any[] = [];
+
+    // Built-in plugin: force classic chunk loading for web worker sub-compilations.
+    // Without this, worker child compilers inherit the parent's outputModule:true context
+    // and may emit ES module chunks that cannot be loaded inside classic workers
+    // via importScripts. Applied to client builds only — SSR doesn't spawn workers.
+    if (!isServerBuild) {
+        extraPlugins.push({
+            apply(compiler: any) {
+                compiler.hooks.compilation.tap('HadarsWorkerChunkLoading', (compilation: any) => {
+                    compilation.hooks.childCompiler.tap(
+                        'HadarsWorkerChunkLoading',
+                        (childCompiler: any) => {
+                            // Skip internal rspack child compilers that already have an
+                            // explicit library type (e.g. HtmlRspackPlugin template
+                            // compilations use library: { type: 'module', name: '' }).
+                            // Forcing outputModule:false on those triggers the rspack
+                            // ModuleLibraryPlugin "name can't be empty" panic in production.
+                            const libType = childCompiler.options?.output?.library?.type;
+                            if (libType === 'module' || libType === 'commonjs' || libType === 'commonjs2') {
+                                return;
+                            }
+                            if (childCompiler.options?.output) {
+                                childCompiler.options.output.chunkLoading = 'import-scripts';
+                            }
+                            if (childCompiler.options?.experiments) {
+                                childCompiler.options.experiments.outputModule = false;
+                            }
+                        },
+                    );
+                });
+            },
+        });
+    }
     const defineValues: Record<string, string> = { ...(opts.define ?? {}) };
     // When reactMode overrides the React runtime we must also set process.env.NODE_ENV
     // so React picks its dev/prod bundle, independently of the rspack build mode.
@@ -352,6 +387,7 @@ const buildCompilerConfig = (
             isDev && !isServerBuild && new ReactRefreshPlugin(),
             includeHotPlugin && isDev && !isServerBuild && new rspack.HotModuleReplacementPlugin(),
             ...extraPlugins,
+            ...(opts.plugins ?? []),
         ],
         ...localConfig,
         // Merge base resolve (modules, tsConfig, extensions) with per-build resolve

package/src/utils/ssrHandler.ts

@@ -36,6 +36,27 @@ export async function buildSsrResponse(
     });
 }
 
+/**
+ * Like {@link buildSsrResponse} but returns the complete HTML string directly
+ * instead of wrapping it in a streaming Response. Use this in environments
+ * where streaming is not beneficial (e.g. AWS Lambda) to avoid the
+ * ReadableStream allocation and the subsequent `.text()` drain overhead.
+ */
+export async function buildSsrHtml(
+    bodyHtml: string,
+    clientProps: Record<string, unknown>,
+    headHtml: string,
+    getPrecontentHtml: (headHtml: string) => Promise<[string, string]>,
+): Promise<string> {
+    const [precontentHtml, postContent] = await getPrecontentHtml(headHtml);
+    const scriptContent = JSON.stringify({ hadars: { props: clientProps } }).replace(/</g, '\\u003c');
+    return (
+        precontentHtml +
+        `<div id="app">${bodyHtml}</div><script id="hadars" type="application/json">${scriptContent}</script>` +
+        postContent
+    );
+}
+
 /**
  * Returns a function that parses `out.html` into pre-head, post-head, and
  * post-content segments and caches the result. Call the returned function with