@canonical/react-ssr 0.27.1-experimental.0 → 0.28.0

package/dist/types/lib/server/viteFetchMiddleware.d.ts

@@ -0,0 +1,81 @@
+import { IncomingMessage, ServerResponse } from "node:http";
+/**
+ * Minimal structural type for the parts of Vite's dev server this helper uses.
+ *
+ * `vite` is an optional peer dependency of this package (it is only needed by
+ * consumers running a Vite-backed dev server). Typing structurally avoids a
+ * hard dependency on Vite's types while still describing the contract: a
+ * connect-style middleware stack `(req, res, next) => void`.
+ */
+export interface ViteMiddlewareServer {
+    middlewares: (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => void;
+}
+/**
+ * Bridge Vite's connect-style middleware into a `fetch`-style handler.
+ *
+ * Runtime SSR dev servers built on `Bun.serve` (or any Web `fetch` server)
+ * cannot mount Vite's `(req, res, next)` middleware directly: that stack
+ * expects Node's `http.IncomingMessage` / `ServerResponse`, while `fetch`
+ * deals in Web `Request` / `Response`. Without delegating to Vite, every
+ * request — including `/@vite/client`, `/src/**`, `/@id/**`, `/@fs/**`,
+ * `/@react-refresh`, and `/node_modules/.vite/**` — would have to be
+ * server-rendered, so client modules and HMR assets would be returned as the
+ * SSR HTML page with the wrong `Content-Type` (browsers then block them as
+ * modules and the page never hydrates).
+ *
+ * This helper adapts a Web `Request` into a Node `req`/`res` pair, runs Vite's
+ * middleware against it, and returns a Web `Response` if the middleware handled
+ * the request — or `null` if the stack called `next()` (a page route the
+ * caller should server-render).
+ *
+ * The bridge is **runtime-agnostic**: it depends only on `node:http` /
+ * `node:net` and Web globals (`Request`, `Response`), so it works under Bun,
+ * Node's own `fetch` servers, Deno, and Workers — not just Bun. The `vite`
+ * instance is injected, not imported, keeping this module free of a runtime
+ * Vite dependency.
+ *
+ * The response body is **buffered**: chunks written by the middleware are
+ * collected and the `Response` resolves on `end`, with `status` and `headers`
+ * read from the (by-then-final) `ServerResponse`. This is correct and robust
+ * for dev assets — transformed JS/CSS modules and source maps, which are small
+ * and already in memory when Vite writes them. Streaming would buy near-zero
+ * latency here (SSR render streaming goes through the renderer's
+ * `renderToReadableStream`, never this bridge) while introducing header-timing
+ * and backpressure hazards, so it is deliberately avoided.
+ *
+ * Headers set via `res.writeHead(status, headers)` are captured in addition to
+ * `res.getHeaders()` (Vite's static-file middleware sets `Content-Type` etc.
+ * that way for non-JS assets), and multi-value headers such as `set-cookie` are
+ * preserved as separate entries rather than comma-folded.
+ *
+ * Only `GET`/`HEAD` requests are bridged. A bare `IncomingMessage` carries no
+ * request body, so any middleware that reads one would hang; requests with a
+ * body (and other methods) return `null` so the caller handles them. This
+ * matches Vite's asset/module/HMR surface, which is entirely `GET`/`HEAD`.
+ *
+ * @param vite - A Vite dev server created with `middlewareMode: true`.
+ * @returns A function mapping a Web `Request` to a `Response` (Vite handled it)
+ *   or `null` (a page route, a non-`GET`/`HEAD` request — pass through to SSR).
+ *
+ * @example
+ * ```ts
+ * import { createServer as createViteServer } from "vite";
+ * import { viteFetchMiddleware } from "@canonical/react-ssr/server";
+ *
+ * const vite = await createViteServer({
+ *   server: { middlewareMode: true },
+ *   appType: "custom",
+ * });
+ * const handleAsset = viteFetchMiddleware(vite);
+ *
+ * Bun.serve({
+ *   async fetch(req) {
+ *     const asset = await handleAsset(req);
+ *     if (asset) return asset; // /@vite/client, /src/**, CSS, HMR …
+ *     return ssrRender(req); // page route
+ *   },
+ * });
+ * ```
+ */
+export declare function viteFetchMiddleware(vite: ViteMiddlewareServer): (request: Request) => Promise<Response | null>;
+//# sourceMappingURL=viteFetchMiddleware.d.ts.map

package/dist/types/lib/server/viteFetchMiddleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viteFetchMiddleware.d.ts","sourceRoot":"","sources":["../../../../src/lib/server/viteFetchMiddleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG5D;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,CACX,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,KAC1B,IAAI,CAAC;CACX;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,oBAAoB,GACzB,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAsGhD"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@canonical/react-ssr",
   "description": "TBD",
-  "version": "0.27.1-experimental.0",
+  "version": "0.28.0",
   "type": "module",
   "module": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
@@ -70,9 +70,9 @@
   },
   "devDependencies": {
     "@biomejs/biome": "2.4.9",
-    "@canonical/biome-config": "^0.27.1-experimental.0",
-    "@canonical/typescript-config-react": "^0.27.1-experimental.0",
-    "@canonical/webarchitect": "^0.27.1-experimental.0",
+    "@canonical/biome-config": "^0.28.0",
+    "@canonical/typescript-config-react": "^0.28.0",
+    "@canonical/webarchitect": "^0.28.0",
     "@types/express": "^5.0.6",
     "@types/node": "^24.12.0",
     "@types/react": "^19.2.14",
@@ -82,18 +82,22 @@
     "vitest": "^4.0.18"
   },
   "dependencies": {
-    "@canonical/utils": "^0.27.1-experimental.0",
+    "@canonical/utils": "^0.28.0",
     "htmlparser2": "^10.1.0",
     "react": "^19.2.4",
     "react-dom": "^19.2.4"
   },
   "peerDependencies": {
-    "express": "^5.2.1"
+    "express": "^5.2.1",
+    "vite": "^8.0.0"
   },
   "peerDependenciesMeta": {
     "express": {
       "optional": true
+    },
+    "vite": {
+      "optional": true
     }
   },
-  "gitHead": "d3f5b9aab7bec07fce40a12b45097d28d3cf0201"
+  "gitHead": "8297d72122bcba903f7e8833cb23ccbaa164ed56"
 }