remix 3.0.0-beta.1 → 3.0.0-beta.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remix",
-  "version": "3.0.0-beta.1",
+  "version": "3.0.0-beta.2",
   "description": "The Remix web framework",
   "author": "Michael Jackson <mjijackson@gmail.com>",
   "license": "MIT",
@@ -261,10 +261,6 @@
       "types": "./dist/node-fetch-server/test.d.ts",
       "default": "./dist/node-fetch-server/test.js"
     },
-    "./node-serve": {
-      "types": "./dist/node-serve.d.ts",
-      "default": "./dist/node-serve.js"
-    },
     "./node-tsx": {
       "types": "./dist/node-tsx.d.ts",
       "default": "./dist/node-tsx.js"
@@ -473,51 +469,50 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@remix-run/async-context-middleware": "^0.3.0",
-    "@remix-run/assets": "^0.4.0",
-    "@remix-run/auth-middleware": "^0.2.0",
-    "@remix-run/auth": "^0.2.2",
-    "@remix-run/ui": "^0.1.2",
-    "@remix-run/compression-middleware": "^0.1.8",
-    "@remix-run/cors-middleware": "^0.1.3",
-    "@remix-run/cop-middleware": "^0.1.3",
-    "@remix-run/cookie": "^0.5.2",
+    "@remix-run/assets": "^0.4.1",
+    "@remix-run/async-context-middleware": "^0.3.1",
+    "@remix-run/auth": "^0.2.3",
+    "@remix-run/ui": "^0.2.0",
+    "@remix-run/cop-middleware": "^0.1.4",
+    "@remix-run/compression-middleware": "^0.1.9",
+    "@remix-run/cookie": "^0.5.3",
+    "@remix-run/auth-middleware": "^0.2.1",
+    "@remix-run/cors-middleware": "^0.1.4",
+    "@remix-run/csrf-middleware": "^0.1.4",
     "@remix-run/data-schema": "^0.3.0",
-    "@remix-run/csrf-middleware": "^0.1.3",
     "@remix-run/data-table": "^0.3.0",
     "@remix-run/data-table-mysql": "^0.4.0",
     "@remix-run/data-table-postgres": "^0.4.0",
     "@remix-run/data-table-sqlite": "^0.5.0",
-    "@remix-run/fetch-proxy": "^0.8.1",
-    "@remix-run/file-storage": "^0.13.4",
-    "@remix-run/file-storage-s3": "^0.1.1",
-    "@remix-run/fetch-router": "^0.19.0",
-    "@remix-run/form-data-parser": "^0.17.1",
-    "@remix-run/fs": "^0.4.3",
-    "@remix-run/form-data-middleware": "^0.3.0",
-    "@remix-run/headers": "^0.20.0",
-    "@remix-run/html-template": "^0.3.0",
-    "@remix-run/lazy-file": "^5.0.3",
+    "@remix-run/fetch-proxy": "^0.8.2",
+    "@remix-run/fetch-router": "^0.19.1",
+    "@remix-run/file-storage": "^0.13.5",
+    "@remix-run/form-data-middleware": "^0.3.1",
+    "@remix-run/form-data-parser": "^0.17.2",
+    "@remix-run/file-storage-s3": "^0.1.2",
+    "@remix-run/fs": "^0.4.4",
+    "@remix-run/html-template": "^0.3.1",
+    "@remix-run/headers": "^0.21.0",
+    "@remix-run/lazy-file": "^5.0.4",
+    "@remix-run/logger-middleware": "^0.3.1",
     "@remix-run/mime": "^0.4.1",
-    "@remix-run/multipart-parser": "^0.16.1",
-    "@remix-run/method-override-middleware": "^0.1.8",
-    "@remix-run/logger-middleware": "^0.3.0",
-    "@remix-run/node-fetch-server": "^0.13.2",
-    "@remix-run/node-tsx": "^0.1.0",
-    "@remix-run/response": "^0.3.4",
-    "@remix-run/session": "^0.4.1",
-    "@remix-run/session-middleware": "^0.3.0",
-    "@remix-run/route-pattern": "^0.21.0",
-    "@remix-run/session-storage-redis": "^0.1.0",
-    "@remix-run/static-middleware": "^0.4.9",
-    "@remix-run/session-storage-memcache": "^0.1.0",
-    "@remix-run/cli": "^0.3.0",
-    "@remix-run/assert": "^0.2.0",
-    "@remix-run/test": "^0.4.0",
+    "@remix-run/multipart-parser": "^0.16.2",
+    "@remix-run/method-override-middleware": "^0.1.9",
+    "@remix-run/node-fetch-server": "^0.13.3",
+    "@remix-run/node-tsx": "^0.1.1",
+    "@remix-run/route-pattern": "^0.21.1",
+    "@remix-run/session": "^0.4.2",
+    "@remix-run/response": "^0.3.5",
+    "@remix-run/session-middleware": "^0.3.1",
+    "@remix-run/session-storage-memcache": "^0.1.1",
+    "@remix-run/static-middleware": "^0.4.10",
+    "@remix-run/session-storage-redis": "^0.1.1",
     "@remix-run/tar-parser": "^0.7.1",
-    "@remix-run/terminal": "^0.1.0",
-    "@remix-run/render-middleware": "^0.1.0",
-    "@remix-run/node-serve": "^0.2.0"
+    "@remix-run/assert": "^0.2.1",
+    "@remix-run/cli": "^0.3.1",
+    "@remix-run/render-middleware": "^0.1.1",
+    "@remix-run/terminal": "^0.1.1",
+    "@remix-run/test": "^0.4.1"
   },
   "bin": {
     "remix": "./dist/cli-entry.js"

package/src/file-storage/README.md

@@ -7,7 +7,7 @@ Key/value storage interfaces for server-side [`File` objects](https://developer.
 - **Simple API** - Intuitive key/value API (like [Web Storage](https://developer.mozilla.org/en-US/docs/Web/API/Web_Storage_API), but for `File`s instead of strings)
 - **Multiple Backends** - Built-in filesystem and memory backends
 - **Streaming Support** - Stream file content to and from storage
-- **Metadata Preservation** - Preserves all `File` metadata including `file.name`, `file.type`, and `file.lastModified`
+- **Metadata Preservation** - Preserves all `File` metadata including `file.name`, `file.type`, `file.size`, and `file.lastModified`
 
 ## Installation
 
@@ -32,9 +32,15 @@ await storage.set(key, file)
 
 // Then, sometime later...
 let fileFromStorage = await storage.get(key)
-// All of the original file's metadata is intact
-fileFromStorage.name // 'hello.txt'
-fileFromStorage.type // 'text/plain'
+
+if (fileFromStorage != null) {
+  // All of the original file's metadata is intact
+  fileFromStorage.name // 'hello.txt'
+  fileFromStorage.type // 'text/plain'
+
+  // The filesystem backend returns a LazyFile, so you can stream it directly.
+  let response = new Response(fileFromStorage.stream())
+}
 
 // To remove from storage
 await storage.remove(key)

package/src/file-storage-s3/README.md

@@ -6,7 +6,7 @@ Use this package when you want the `FileStorage` API backed by AWS S3 or an S3-c
 ## Features
 
 - **S3-Compatible API** - Works with AWS S3 and S3-compatible APIs (e.g. MinIO, LocalStack)
-- **Metadata Preservation** - Preserves `File` metadata (`name`, `type`, `lastModified`)
+- **Metadata Preservation** - Preserves `File` metadata (`name`, `type`, `size`, `lastModified`)
 - **Runtime-Agnostic Signing** - Uses [`aws4fetch`](https://github.com/mhart/aws4fetch) for SigV4 signing
 
 ## Installation

package/src/form-data-parser/README.md

@@ -118,15 +118,15 @@ try {
 }
 ```
 
-If you're looking for a more flexible storage solution for `File` objects that are uploaded, this library pairs really well with [the `file-storage` library](https://github.com/remix-run/remix/tree/main/packages/file-storage) for keeping files in various storage backends.
+If you're looking for a more flexible storage solution for `FileUpload` objects, this library pairs really well with [the `file-storage` library](https://github.com/remix-run/remix/tree/main/packages/file-storage) for keeping files in various storage backends.
 
 ```ts
-import { LocalFileStorage } from 'remix/file-storage/local'
+import { createFsFileStorage } from 'remix/file-storage/fs'
 import type { FileUpload } from 'remix/form-data-parser'
 import { parseFormData } from 'remix/form-data-parser'
 
 // Set up storage for uploaded files
-const fileStorage = new LocalFileStorage('/uploads/user-avatars')
+const fileStorage = createFsFileStorage('/uploads/user-avatars')
 
 // Define how to handle incoming file uploads
 async function uploadHandler(fileUpload: FileUpload) {
@@ -134,11 +134,8 @@ async function uploadHandler(fileUpload: FileUpload) {
   if (fileUpload.fieldName === 'user-avatar') {
     let storageKey = `user-${user.id}-avatar`
 
-    // Put the file in storage
-    await fileStorage.set(storageKey, fileUpload)
-
-    // Return a lazy File object that can access the stored file when needed
-    return fileStorage.get(storageKey)
+    // Put the file in storage and return the stored LazyFile
+    return fileStorage.put(storageKey, fileUpload)
   }
 
   // Ignore unrecognized fields

package/src/headers/README.md

@@ -53,6 +53,26 @@ headers.get('Content-Type') // no typed parse needed
 headers.contentType.mediaType // parses Content-Type lazily
 ```
 
+Use `apply()` to apply a `SuperHeadersInit` value to an existing instance with header-aware semantics:
+
+```ts
+let headers = new Headers({
+  contentType: 'text/html',
+  setCookie: { name: 'session', value: 'abc' },
+  vary: 'Accept-Encoding',
+})
+
+headers.apply({
+  contentType: 'application/json',
+  setCookie: { name: 'theme', value: 'dark' },
+  vary: ['Accept-Encoding', 'Accept-Language'],
+})
+
+headers.get('Content-Type') // 'application/json'
+headers.get('Vary') // 'accept-encoding, accept-language'
+headers.getSetCookie() // ['session=abc', 'theme=dark']
+```
+
 ## Individual Header Utilities
 
 Each supported header has a class that represents the header value. Use the static `from()` method to parse header values. Each class has a `toString()` method that returns the header value as a string, which you can either call manually, or will be called automatically when the header class is used in a context that expects a string.
@@ -325,7 +345,7 @@ headers.set('Content-Type', new ContentType({ mediaType: 'text/html', charset: '
 
 Parse, manipulate and stringify [`Cookie` headers](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cookie).
 
-Implements `Map<name, value>`.
+Implements an ordered list of name/value pairs. Duplicate cookie names are preserved, such as when cookies with the same name were set for different paths.
 
 ```ts
 import { Cookie } from 'remix/headers'
@@ -334,6 +354,7 @@ import { Cookie } from 'remix/headers'
 let cookie = Cookie.from(request.headers.get('Cookie'))
 
 cookie.get('session_id') // 'abc123'
+cookie.getAll('session_id') // ['abc123']
 cookie.get('theme') // 'dark'
 cookie.has('session_id') // true
 cookie.size // 2
@@ -345,6 +366,7 @@ for (let [name, value] of cookie) {
 
 // Modify and set header
 cookie.set('theme', 'light')
+cookie.append('session_id', 'def456')
 cookie.delete('session_id')
 headers.set('Cookie', cookie)
 

package/src/node-fetch-server/README.md

@@ -291,7 +291,6 @@ The [`demos` directory](https://github.com/remix-run/remix/tree/main/packages/no
 
 ## Related Packages
 
-- [`node-serve`](https://github.com/remix-run/remix/tree/main/packages/node-serve) - Build high-performance Fetch API servers for Node.js
 - [`fetch-proxy`](https://github.com/remix-run/remix/tree/main/packages/fetch-proxy) - Build HTTP proxy servers using the web fetch API
 
 ## Benchmarks
@@ -322,7 +321,6 @@ Simple HTML response benchmarks without inspecting the incoming request.
 
 | Server                    |   Version | Requests/sec | Avg latency | Transfer/sec |
 | ------------------------- | --------: | -----------: | ----------: | -----------: |
-| `remix/node-serve`        |   `0.0.0` |     `62,225` |    `6.45ms` |     `9.85MB` |
 | `node:http`               | `24.15.0` |     `47,110` |   `10.66ms` |     `9.66MB` |
 | `remix/node-fetch-server` |  `0.13.0` |     `43,317` |   `11.69ms` |     `8.80MB` |
 | `express`                 |   `5.2.1` |     `39,752` |   `13.69ms` |     `9.59MB` |
@@ -333,7 +331,6 @@ POST benchmarks that read and print the request method, headers, and a small bod
 
 | Server                    |   Version | Requests/sec | Avg latency | Transfer/sec |
 | ------------------------- | --------: | -----------: | ----------: | -----------: |
-| `remix/node-serve`        |   `0.0.0` |     `31,213` |   `12.75ms` |     `4.94MB` |
 | `remix/node-fetch-server` |  `0.13.0` |     `25,430` |   `24.25ms` |     `5.17MB` |
 | `node:http`               | `24.15.0` |     `25,088` |   `23.89ms` |     `5.14MB` |
 | `express`                 |   `5.2.1` |     `22,845` |   `27.16ms` |     `5.51MB` |
@@ -344,7 +341,6 @@ POST benchmarks that read and print the request method, headers, and a 1 MB body
 
 | Server                    |   Version | Requests/sec | Avg latency | Transfer/sec |
 | ------------------------- | --------: | -----------: | ----------: | -----------: |
-| `remix/node-serve`        |   `0.0.0` |      `1,148` |  `327.72ms` |   `186.03KB` |
 | `remix/node-fetch-server` |  `0.13.0` |      `1,086` |  `217.69ms` |   `225.87KB` |
 | `node:http`               | `24.15.0` |      `1,079` |  `198.67ms` |   `226.54KB` |
 | `express`                 |   `5.2.1` |      `1,022` |  `216.07ms` |   `252.51KB` |

package/src/ui/README.md

@@ -135,13 +135,15 @@ let Theme = createTheme({
 Render the theme once near the top of your document:
 
 ```tsx
-function Layout(props: { children: RemixNode }) {
-  return (
+import type { Handle, RemixNode } from 'remix/ui'
+
+function Layout(handle: Handle<{ children: RemixNode }>) {
+  return () => (
     <html>
       <head>
         <Theme />
       </head>
-      <body>{props.children}</body>
+      <body>{handle.props.children}</body>
     </html>
   )
 }
@@ -168,13 +170,13 @@ let card = css({
 Render shared glyphs separately from the theme styles:
 
 ```tsx
-import type { RemixNode } from 'remix/ui'
+import type { Handle, RemixNode } from 'remix/ui'
 import { Button } from 'remix/ui/button'
 import { Glyph } from 'remix/ui/glyph'
 import { RMX_01, RMX_01_GLYPHS } from 'remix/ui/theme'
 
-function Layout(props: { children: RemixNode }) {
-  return (
+function Layout(handle: Handle<{ children: RemixNode }>) {
+  return () => (
     <html>
       <head>
         <RMX_01 />
@@ -184,7 +186,7 @@ function Layout(props: { children: RemixNode }) {
         <Button startIcon={<Glyph name="add" />} tone="primary">
           New project
         </Button>
-        {props.children}
+        {handle.props.children}
       </body>
     </html>
   )

package/src/ui/animation/README.md

@@ -52,12 +52,13 @@ function Toast() {
 `animateExit` keeps a removed keyed element in the DOM long enough to animate from its natural styles to the provided keyframe.
 
 ```tsx
+import type { Handle } from 'remix/ui'
 import { animateExit } from 'remix/ui/animation'
 
-function Item({ id, label }: { id: string; label: string }) {
+function Item(handle: Handle<{ id: string; label: string }>) {
   return () => (
     <li
-      key={id}
+      key={handle.props.id}
       mix={[
         animateExit({
           opacity: 0,
@@ -67,7 +68,7 @@ function Item({ id, label }: { id: string; label: string }) {
         }),
       ]}
     >
-      {label}
+      {handle.props.label}
     </li>
   )
 }
@@ -105,12 +106,13 @@ Exit animations can reclaim a removed keyed node if the same keyed element is re
 `animateLayout` animates layout changes with a FLIP-style transform projection. Use it on elements whose position or size can change between renders.
 
 ```tsx
+import type { Handle } from 'remix/ui'
 import { animateLayout, spring } from 'remix/ui/animation'
 
-function Card({ expanded }: { expanded: boolean }) {
+function Card(handle: Handle<{ expanded: boolean }>) {
   return () => (
     <section
-      class={expanded ? 'card expanded' : 'card'}
+      class={handle.props.expanded ? 'card expanded' : 'card'}
       mix={[
         animateLayout({
           ...spring('smooth'),

package/src/ui/combobox/README.md

@@ -8,7 +8,7 @@ Use it when the user should type draft text, filter a popup list, and still comm
 
 ```tsx
 import { css, type Handle } from 'remix/ui'
-import { Combobox, ComboboxOption, onComboboxChange } from 'remix/ui'
+import { Combobox, ComboboxOption, onComboboxChange } from 'remix/ui/combobox'
 
 let airports = [
   {

package/src/ui/server/README.md

@@ -1,6 +1,6 @@
 # Server
 
-Remix Component can render to HTML on the server using two APIs:
+Remix UI can render to HTML on the server using two APIs:
 
 - `renderToString` - Returns a complete HTML string. Simple, but buffers the entire response.
 - `renderToStream` - Returns a `ReadableStream<Uint8Array>`. Sends the initial HTML immediately and streams frame content as it resolves.
@@ -26,6 +26,7 @@ import { renderToStream } from 'remix/ui/server'
 
 let stream = renderToStream(<App />, {
   frameSrc: request.url,
+  signal: request.signal,
   resolveFrame(src, _target, context) {
     let frameUrl = new URL(src, context?.currentFrameSrc ?? request.url)
     return fetchHtml(frameUrl)
@@ -44,6 +45,7 @@ return new Response(stream, {
 
 - **`frameSrc`** - Seeds SSR frame state for the current render. When provided, server-rendered components can read `handle.frame.src` and `handle.frames.top.src` during SSR.
 - **`topFrameSrc`** - Overrides the root frame URL used for `handle.frames.top.src`. This is mainly useful when calling `renderToStream()` from inside `resolveFrame()` for a nested frame render.
+- **`signal`** - Cancels pending server rendering work. Pass `request.signal` so client disconnects can stop unresolved frame work without invoking `onError` for the disconnect itself.
 - **`resolveFrame(src, target, context)`** - Called when a `<Frame>` needs its content. Return a string of HTML, a `ReadableStream<Uint8Array>`, or a promise of either. `context.currentFrameSrc` is the URL for the frame that contains the `<Frame>`, and `context.topFrameSrc` is the outer document URL. Required if your component tree contains `<Frame>` elements.
 - **`onError(error)`** - Called when a rendering error occurs. If not provided, the stream rejects with the error.
 
@@ -80,7 +82,7 @@ function ProductPage() {
 
 ## CSS
 
-Components using the `css` prop have their styles collected during rendering and emitted as a single `<style>` tag in the `<head>`. No client-side style injection is needed for server-rendered content.
+Components using the `css(...)` mixin through `mix` have their styles collected during rendering and emitted as a single `<style>` tag in the `<head>`. No client-side style injection is needed for server-rendered content.
 
 ## See Also
 

package/dist/node-serve.d.ts

@@ -1,2 +0,0 @@
-export * from '@remix-run/node-serve';
-//# sourceMappingURL=node-serve.d.ts.map

package/dist/node-serve.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"node-serve.d.ts","sourceRoot":"","sources":["../src/node-serve.ts"],"names":[],"mappings":"AACA,cAAc,uBAAuB,CAAA"}

package/dist/node-serve.js

@@ -1,2 +0,0 @@
-// IMPORTANT: This file is auto-generated, please do not edit manually.
-export * from '@remix-run/node-serve';

package/src/node-serve/README.md

@@ -1,253 +0,0 @@
-# node-serve
-
-Build high-performance Node.js servers with web-standard Fetch API primitives. Use this package when you want Remix-style `Request`/`Response` handlers with a managed server optimized for production throughput.
-
-## Features
-
-- **Fetch API Handlers**: Serve standard [`Request`](https://developer.mozilla.org/en-US/docs/Web/API/Request) to [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response) request handlers
-- **High-Performance Node.js Server**: Start a fast managed server for Fetch API application code
-- **HTTPS Support**: Start a TLS server with certificate and key file paths
-- **Managed Server Lifecycle**: Start a server with `serve()`, wait for `server.ready`, and close it with `server.close()`
-- **Custom Hostname**: Override the host and protocol used to construct incoming `request.url` values
-- **Client Info**: Access client IP address, address family, and remote port when your handler accepts a second argument
-- **uWebSockets.js Setup**: Register native WebSocket routes and connection filters before the Fetch fallback starts listening
-- **Existing uWebSockets.js App Adapter**: Use `createUwsRequestHandler()` when you already own a uWebSockets.js app
-
-## Installation
-
-```sh
-npm i remix
-```
-
-`node-serve` includes uWebSockets.js as its native high-performance transport.
-
-## Usage
-
-Use `serve()` to start a Node.js server that calls your fetch handler for every incoming request:
-
-```ts
-import { serve } from 'remix/node-serve'
-
-let users = new Map([
-  ['1', { id: '1', name: 'Alice', email: 'alice@example.com' }],
-  ['2', { id: '2', name: 'Bob', email: 'bob@example.com' }],
-])
-
-async function handler(request: Request) {
-  let url = new URL(request.url)
-
-  if (url.pathname === '/' && request.method === 'GET') {
-    return new Response('Welcome to the User API! Try GET /api/users')
-  }
-
-  if (url.pathname === '/api/users' && request.method === 'GET') {
-    return Response.json(Array.from(users.values()))
-  }
-
-  let userMatch = url.pathname.match(/^\/api\/users\/(\w+)$/)
-  if (userMatch && request.method === 'GET') {
-    let user = users.get(userMatch[1])
-    if (user) return Response.json(user)
-    return new Response('User not found', { status: 404 })
-  }
-
-  return new Response('Not Found', { status: 404 })
-}
-
-let server = serve(handler, { port: 3000 })
-
-await server.ready
-console.log(`Server running at http://localhost:${server.port}`)
-```
-
-### uWebSockets.js Setup
-
-Use `setup(app)` when `serve()` should still manage the server lifecycle and Fetch fallback, but you need to configure native uWebSockets.js transport features before the server starts listening. The hook runs after the app is created and before `node-serve` registers its catch-all Fetch route.
-
-This example adds a native WebSocket endpoint next to a normal Fetch handler on the same port:
-
-```ts
-import { serve } from 'remix/node-serve'
-
-let server = serve(
-  (request) => {
-    let url = new URL(request.url)
-
-    if (url.pathname === '/') {
-      return new Response('Chat server')
-    }
-
-    return new Response('Not Found', { status: 404 })
-  },
-  {
-    port: 3000,
-    setup(app) {
-      app.ws('/ws/chat', {
-        open(ws) {
-          ws.subscribe('chat')
-        },
-        message(ws, message, isBinary) {
-          ws.publish('chat', message, isBinary)
-        },
-      })
-    },
-  },
-)
-
-await server.ready
-```
-
-`app.ws(pattern, ...)` uses uWebSockets.js route patterns, not Remix `route-pattern` syntax. uWS supports simple path params such as `/rooms/:room`, and those params are available during `upgrade` through `req.getParameter('room')` or `req.getParameter(0)`. If WebSocket handlers need params, copy them into uWS user data during `upgrade`, then read them with `ws.getUserData()`:
-
-```ts
-serve(handler, {
-  setup(app) {
-    app.ws<{ room: string }>('/rooms/:room', {
-      upgrade(res, req, context) {
-        res.upgrade(
-          { room: req.getParameter('room') ?? 'general' },
-          req.getHeader('sec-websocket-key'),
-          req.getHeader('sec-websocket-protocol'),
-          req.getHeader('sec-websocket-extensions'),
-          context,
-        )
-      },
-      open(ws) {
-        ws.subscribe(`room:${ws.getUserData().room}`)
-      },
-    })
-  },
-})
-```
-
-uWS patterns do not support the full `route-pattern` feature set, including partial-segment params like `v:version`, split params like `:file.:ext`, optionals like `/api(/v:version)`, host/protocol/search matching, or named multi-segment wildcard captures like `*path`. You can use a uWS pattern like `/files/*` as a catch-all, but it does not provide Remix-style named wildcard params.
-
-You can also register connection filters for low-level transport metrics or limits:
-
-```ts
-let activeConnections = 0
-
-serve(handler, {
-  setup(app) {
-    app.filter((_res, count) => {
-      activeConnections = Number(count)
-    })
-  },
-})
-```
-
-`app.filter()` observes low-level connection count changes. It is not Fetch response middleware and should not be used to mutate normal `Response` headers or bodies. Use Fetch handlers, middleware, or [`fetch-router`](https://github.com/remix-run/remix/tree/main/packages/fetch-router) for normal HTTP routing and response behavior; reserve `setup()` for uWebSockets.js transport features that must be configured before listening.
-
-### Custom Request URLs
-
-Use `host` and `protocol` when your server runs behind a proxy or load balancer and you need stable incoming request URLs:
-
-```ts
-import { serve } from 'remix/node-serve'
-
-let server = serve(handler, {
-  host: process.env.HOST ?? 'api.example.com',
-  protocol: 'https:',
-  port: 3000,
-})
-
-await server.ready
-```
-
-### HTTPS
-
-Pass `tls` options to start an HTTPS server. `keyFile` and `certFile` are file paths, not PEM contents:
-
-```ts
-import { serve } from 'remix/node-serve'
-
-let server = serve(handler, {
-  port: 443,
-  tls: {
-    keyFile: './certs/server.key',
-    certFile: './certs/server.crt',
-  },
-})
-
-await server.ready
-console.log(`Server running at https://localhost:${server.port}`)
-```
-
-When `tls` is present, `request.url` defaults to the `https:` protocol. You can still set `protocol` explicitly when the public URL differs from the local server transport.
-
-### Client Information
-
-Handlers that accept a second argument receive the remote client address:
-
-```ts
-import { type FetchHandler, serve } from 'remix/node-serve'
-
-let handler: FetchHandler = async (request, client) => {
-  console.log(`Request from ${client.address}:${client.port}`)
-
-  return Response.json({
-    path: new URL(request.url).pathname,
-    clientAddress: client.address,
-  })
-}
-
-serve(handler, { port: 3000 })
-```
-
-### Existing uWebSockets.js Apps
-
-Most apps should use `serve()`. Use `createUwsRequestHandler()` when you already have a uWebSockets.js app and want only part of the app to use a Fetch API handler:
-
-This example assumes `uWebSockets.js` is also a direct dependency of your app.
-
-```ts
-import { App } from 'uWebSockets.js'
-import { createUwsRequestHandler } from 'remix/node-serve'
-
-let app = App()
-
-async function handler(request: Request) {
-  let url = new URL(request.url)
-  return Response.json({ path: url.pathname })
-}
-
-app.get('/health', (res) => {
-  res.end('ok')
-})
-
-app.any('/api/*', createUwsRequestHandler(handler))
-
-app.listen(3000, (socket) => {
-  if (!socket) throw new Error('Could not listen on port 3000')
-})
-```
-
-For HTTPS with an existing uWebSockets.js app, create the SSL app yourself and pass `protocol: 'https:'` when you create the request handler:
-
-```ts
-import { SSLApp } from 'uWebSockets.js'
-import { createUwsRequestHandler } from 'remix/node-serve'
-
-let app = SSLApp({
-  key_file_name: './certs/server.key',
-  cert_file_name: './certs/server.crt',
-})
-
-app.any('/*', createUwsRequestHandler(handler, { protocol: 'https:' }))
-app.listen(443, (socket) => {
-  if (!socket) throw new Error('Could not listen on port 443')
-})
-```
-
-## Related Packages
-
-- [`node-fetch-server`](https://github.com/remix-run/remix/tree/main/packages/node-fetch-server) - Adapt Fetch API handlers to existing `node:http`, `node:https`, and `node:http2` servers
-- [`fetch-router`](https://github.com/remix-run/remix/tree/main/packages/fetch-router) - Route incoming `Request` objects to Fetch API handlers
-
-## Related Work
-
-- [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) - Web standard `Request` and `Response` primitives
-
-## License
-
-See [LICENSE](https://github.com/remix-run/remix/blob/main/LICENSE)

package/src/node-serve.ts

@@ -1,2 +0,0 @@
-// IMPORTANT: This file is auto-generated, please do not edit manually.
-export * from '@remix-run/node-serve'