effective-rsc 0.1.1 → 0.1.3

package/dist/server/html-renderer.js

@@ -1,6 +1,7 @@
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { jsx } from "react/jsx-runtime";
 import { Context, Effect, FiberSet, Layer, Schema } from "effect";
 import { use } from "react";
+import { preinit } from "react-dom";
 import { renderToReadableStream } from "react-dom/server.bun";
 import { createFromReadableStream } from "react-server-dom-rspack/client";
 import { RouteTree } from "../client/route-tree.js";
@@ -23,6 +24,8 @@ import { ServerConfig } from "./server-config.js";
 
 
 
+
+
 class HtmlRenderError extends Schema.TaggedError()('HtmlRenderError', {
     cause: Schema.Defect()
 }) {
@@ -38,22 +41,20 @@ class HtmlRenderer extends Context.Service()('ersc/server/html-renderer/HtmlRend
                 const [ssrFlightStream, browserFlightStream] = flight.stream.tee();
                 let payload = null;
                 function SsrRoot() {
+                    // Emit CSS without server-only siblings that shift hydration's useId paths.
+                    for (const href of clientStylesheets){
+                        preinit(href, {
+                            as: 'style',
+                            precedence: 'default'
+                        });
+                    }
                     const { routeTree } = use(payload ??= createFromReadableStream(ssrFlightStream));
                     return /*#__PURE__*/ jsx(RouteTree, {
                         root: routeTree
                     });
                 }
                 const htmlStream = yield* Effect.tryPromise({
-                    try: ()=>renderToReadableStream(/*#__PURE__*/ jsxs(Fragment, {
-                            children: [
-                                clientStylesheets.map((href)=>/*#__PURE__*/ jsx("link", {
-                                        rel: "stylesheet",
-                                        href: href,
-                                        precedence: "default"
-                                    }, href)),
-                                /*#__PURE__*/ jsx(SsrRoot, {})
-                            ]
-                        }), {
+                    try: ()=>renderToReadableStream(/*#__PURE__*/ jsx(SsrRoot, {}), {
                             bootstrapScripts: [
                                 ...clientBootstrapScripts
                             ],

package/dist/server/html-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"server/html-renderer.js","sources":["../../src/server/html-renderer.tsx"],"sourcesContent":["import { Context, Effect, FiberSet, Layer, Schema, type Scope } from 'effect';\nimport { use } from 'react';\nimport { renderToReadableStream } from 'react-dom/server.bun';\nimport { createFromReadableStream } from 'react-server-dom-rspack/client';\n\nimport { RouteTree } from '../client/route-tree';\nimport type { FlightPayload } from '../rsc/flight';\nimport { FlightHtmlInjector } from './flight-html-stream';\nimport type { FlightRender } from './flight-renderer';\nimport { ServerConfig } from './server-config';\n\ntype HtmlStream = ReadableStream<Uint8Array>;\n\nexport class HtmlRenderError extends Schema.TaggedError<HtmlRenderError>()('HtmlRenderError', {\n  cause: Schema.Defect(),\n}) {}\n\nexport class HtmlRenderer extends Context.Service<HtmlRenderer>()(\n  'ersc/server/html-renderer/HtmlRenderer',\n  {\n    make: Effect.gen(function* () {\n      const { clientBootstrapScripts, clientStylesheets } = yield* ServerConfig;\n      const flightHtmlInjector = yield* FlightHtmlInjector;\n\n      return {\n        render: Effect.fn('HtmlRenderer.render')(function* ({\n          flight,\n          formState,\n        }: {\n          readonly flight: FlightRender;\n          readonly formState: FlightPayload['formState'];\n        }): Effect.fn.Return<HtmlStream, HtmlRenderError, Scope.Scope> {\n          const signal = yield* Effect.abortSignal;\n          const runtime = yield* FiberSet.makeRuntimePromise<never>();\n          const [ssrFlightStream, browserFlightStream] = flight.stream.tee();\n          let payload: PromiseLike<FlightPayload> | null = null;\n\n          function SsrRoot() {\n            const { routeTree } = use(\n              (payload ??= createFromReadableStream<FlightPayload>(ssrFlightStream)),\n            );\n            return <RouteTree root={routeTree} />;\n          }\n\n          const htmlStream = yield* Effect.tryPromise({\n            try: () =>\n              renderToReadableStream(\n                <>\n                  {clientStylesheets.map((href) => (\n                    <link key={href} rel='stylesheet' href={href} precedence='default' />\n                  ))}\n                  <SsrRoot />\n                </>,\n                {\n                  bootstrapScripts: [...clientBootstrapScripts],\n                  formState,\n                  onError: (error, errorInfo) => {\n                    if (!signal.aborted && !flight.signal.aborted) {\n                      void runtime(\n                        Effect.logError('HTML render failed.', error, errorInfo.componentStack),\n                      );\n                    }\n                  },\n                  signal,\n                },\n              ),\n            catch: (cause) => new HtmlRenderError({ cause }),\n          });\n\n          return htmlStream.pipeThrough(flightHtmlInjector.inject(browserFlightStream));\n        }),\n      };\n    }),\n  },\n) {\n  static readonly layer = Layer.effect(this, this.make);\n}\n"],"names":["Context","Effect","FiberSet","Layer","Schema","use","renderToReadableStream","createFromReadableStream","RouteTree","FlightHtmlInjector","ServerConfig","HtmlRenderError","HtmlRenderer","clientBootstrapScripts","clientStylesheets","flightHtmlInjector","flight","formState","signal","runtime","ssrFlightStream","browserFlightStream","payload","SsrRoot","routeTree","htmlStream","href","error","errorInfo","cause"],"mappings":";;;;;;;;;;;;;;;;;;AAA8E;AAClD;AACkC;AACY;AAEzB;AAES;AAEX;AAIxC,MAAMW,eAAeA,SAASP,kBAAkB,GAAoB,mBAAmB;IAC5F,OAAOA,aAAa;AACtB;AAAI;AAEG,MAAMQ,YAAYA,SAASZ,eAAe,GAC/C,0CACA;IACE,MAAMC,UAAU,CAAC;QACf,MAAM,EAAEY,sBAAsB,EAAEC,iBAAiB,EAAE,GAAG,OAAOJ,YAAYA;QACzE,MAAMK,qBAAqB,OAAON,kBAAkBA;QAEpD,OAAO;YACL,QAAQR,SAAS,CAAC,uBAAuB,UAAW,EAClDe,MAAM,EACNC,SAAS,EAIV;gBACC,MAAMC,SAAS,OAAOjB,kBAAkB;gBACxC,MAAMkB,UAAU,OAAOjB,2BAA2B;gBAClD,MAAM,CAACkB,iBAAiBC,oBAAoB,GAAGL,OAAO,MAAM,CAAC,GAAG;gBAChE,IAAIM,UAA6C;gBAEjD,SAASC;oBACP,MAAM,EAAEC,SAAS,EAAE,GAAGnB,GAAGA,CACtBiB,YAAYf,wBAAwBA,CAAgBa;oBAEvD,qBAAO,IAACZ,SAASA;wBAAC,MAAMgB;;gBAC1B;gBAEA,MAAMC,aAAa,OAAOxB,iBAAiB,CAAC;oBAC1C,KAAK,IACHK,sBAAsBA,eACpB;;gCACGQ,kBAAkB,GAAG,CAAC,CAACY,qBACtB,IAAC;wCAAgB,KAAI;wCAAa,MAAMA;wCAAM,YAAW;uCAA9CA;8CAEb,IAACH;;4BAEH;4BACE,kBAAkB;mCAAIV;6BAAuB;4BAC7CI;4BACA,SAAS,CAACU,OAAOC;gCACf,IAAI,CAACV,OAAO,OAAO,IAAI,CAACF,OAAO,MAAM,CAAC,OAAO,EAAE;oCAC7C,KAAKG,QACHlB,eAAe,CAAC,uBAAuB0B,OAAOC,UAAU,cAAc;gCAE1E;4BACF;4BACAV;wBACF;oBAEJ,OAAO,CAACW,QAAU,IAAIlB,eAAeA,CAAC;4BAAEkB;wBAAM;gBAChD;gBAEA,OAAOJ,WAAW,WAAW,CAACV,mBAAmB,MAAM,CAACM;YAC1D;QACF;IACF;AACF;IAEA,OAAgB,QAAQlB,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;AACxD"}
+{"version":3,"file":"server/html-renderer.js","sources":["../../src/server/html-renderer.tsx"],"sourcesContent":["import { Context, Effect, FiberSet, Layer, Schema, type Scope } from 'effect';\nimport { use } from 'react';\nimport { preinit } from 'react-dom';\nimport { renderToReadableStream } from 'react-dom/server.bun';\nimport { createFromReadableStream } from 'react-server-dom-rspack/client';\n\nimport { RouteTree } from '../client/route-tree';\nimport type { FlightPayload } from '../rsc/flight';\nimport { FlightHtmlInjector } from './flight-html-stream';\nimport type { FlightRender } from './flight-renderer';\nimport { ServerConfig } from './server-config';\n\ntype HtmlStream = ReadableStream<Uint8Array>;\n\nexport class HtmlRenderError extends Schema.TaggedError<HtmlRenderError>()('HtmlRenderError', {\n  cause: Schema.Defect(),\n}) {}\n\nexport class HtmlRenderer extends Context.Service<HtmlRenderer>()(\n  'ersc/server/html-renderer/HtmlRenderer',\n  {\n    make: Effect.gen(function* () {\n      const { clientBootstrapScripts, clientStylesheets } = yield* ServerConfig;\n      const flightHtmlInjector = yield* FlightHtmlInjector;\n\n      return {\n        render: Effect.fn('HtmlRenderer.render')(function* ({\n          flight,\n          formState,\n        }: {\n          readonly flight: FlightRender;\n          readonly formState: FlightPayload['formState'];\n        }): Effect.fn.Return<HtmlStream, HtmlRenderError, Scope.Scope> {\n          const signal = yield* Effect.abortSignal;\n          const runtime = yield* FiberSet.makeRuntimePromise<never>();\n          const [ssrFlightStream, browserFlightStream] = flight.stream.tee();\n          let payload: PromiseLike<FlightPayload> | null = null;\n\n          function SsrRoot() {\n            // Emit CSS without server-only siblings that shift hydration's useId paths.\n            for (const href of clientStylesheets) {\n              preinit(href, { as: 'style', precedence: 'default' });\n            }\n            const { routeTree } = use(\n              (payload ??= createFromReadableStream<FlightPayload>(ssrFlightStream)),\n            );\n            return <RouteTree root={routeTree} />;\n          }\n\n          const htmlStream = yield* Effect.tryPromise({\n            try: () =>\n              renderToReadableStream(<SsrRoot />, {\n                bootstrapScripts: [...clientBootstrapScripts],\n                formState,\n                onError: (error, errorInfo) => {\n                  if (!signal.aborted && !flight.signal.aborted) {\n                    void runtime(\n                      Effect.logError('HTML render failed.', error, errorInfo.componentStack),\n                    );\n                  }\n                },\n                signal,\n              }),\n            catch: (cause) => new HtmlRenderError({ cause }),\n          });\n\n          return htmlStream.pipeThrough(flightHtmlInjector.inject(browserFlightStream));\n        }),\n      };\n    }),\n  },\n) {\n  static readonly layer = Layer.effect(this, this.make);\n}\n"],"names":["Context","Effect","FiberSet","Layer","Schema","use","preinit","renderToReadableStream","createFromReadableStream","RouteTree","FlightHtmlInjector","ServerConfig","HtmlRenderError","HtmlRenderer","clientBootstrapScripts","clientStylesheets","flightHtmlInjector","flight","formState","signal","runtime","ssrFlightStream","browserFlightStream","payload","SsrRoot","href","routeTree","htmlStream","error","errorInfo","cause"],"mappings":";;;;;;;;;;;;;;;;;;;;AAA8E;AAClD;AACQ;AAC0B;AACY;AAEzB;AAES;AAEX;AAIxC,MAAMY,eAAeA,SAASR,kBAAkB,GAAoB,mBAAmB;IAC5F,OAAOA,aAAa;AACtB;AAAI;AAEG,MAAMS,YAAYA,SAASb,eAAe,GAC/C,0CACA;IACE,MAAMC,UAAU,CAAC;QACf,MAAM,EAAEa,sBAAsB,EAAEC,iBAAiB,EAAE,GAAG,OAAOJ,YAAYA;QACzE,MAAMK,qBAAqB,OAAON,kBAAkBA;QAEpD,OAAO;YACL,QAAQT,SAAS,CAAC,uBAAuB,UAAW,EAClDgB,MAAM,EACNC,SAAS,EAIV;gBACC,MAAMC,SAAS,OAAOlB,kBAAkB;gBACxC,MAAMmB,UAAU,OAAOlB,2BAA2B;gBAClD,MAAM,CAACmB,iBAAiBC,oBAAoB,GAAGL,OAAO,MAAM,CAAC,GAAG;gBAChE,IAAIM,UAA6C;gBAEjD,SAASC;oBACP,4EAA4E;oBAC5E,KAAK,MAAMC,QAAQV,kBAAmB;wBACpCT,OAAOA,CAACmB,MAAM;4BAAE,IAAI;4BAAS,YAAY;wBAAU;oBACrD;oBACA,MAAM,EAAEC,SAAS,EAAE,GAAGrB,GAAGA,CACtBkB,YAAYf,wBAAwBA,CAAgBa;oBAEvD,qBAAO,IAACZ,SAASA;wBAAC,MAAMiB;;gBAC1B;gBAEA,MAAMC,aAAa,OAAO1B,iBAAiB,CAAC;oBAC1C,KAAK,IACHM,sBAAsBA,eAAC,IAACiB,cAAY;4BAClC,kBAAkB;mCAAIV;6BAAuB;4BAC7CI;4BACA,SAAS,CAACU,OAAOC;gCACf,IAAI,CAACV,OAAO,OAAO,IAAI,CAACF,OAAO,MAAM,CAAC,OAAO,EAAE;oCAC7C,KAAKG,QACHnB,eAAe,CAAC,uBAAuB2B,OAAOC,UAAU,cAAc;gCAE1E;4BACF;4BACAV;wBACF;oBACF,OAAO,CAACW,QAAU,IAAIlB,eAAeA,CAAC;4BAAEkB;wBAAM;gBAChD;gBAEA,OAAOH,WAAW,WAAW,CAACX,mBAAmB,MAAM,CAACM;YAC1D;QACF;IACF;AACF;IAEA,OAAgB,QAAQnB,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;AACxD"}

package/dist/server/serve.d.ts

@@ -0,0 +1,7 @@
+import { Effect } from 'effect';
+export type StartOptions = {
+    readonly hostname: string;
+    readonly port: number;
+    readonly root: string;
+};
+export declare const serve: (options: StartOptions) => Effect.Effect<void, import("../build/compiled-server.js").CompiledServerError | import("effect/Types").unhandled, import("effect/Scope").Scope>;

package/dist/server/serve.js

@@ -0,0 +1,31 @@
+import { Effect, Layer } from "effect";
+import { loadCompiledServer, makeRunnableServerLayer } from "../build/compiled-server.js";
+import { EnvironmentConfig } from "../build/contract.js";
+
+import * as __rspack_external__effect_platform_bun_BunServices_112addf2 from "@effect/platform-bun/BunServices";
+
+
+
+
+
+
+
+
+const resolveServerLayer = Effect.fnUntraced(function*({ hostname, port, root }) {
+    const bundle = yield* loadCompiledServer(root);
+    return yield* makeRunnableServerLayer({
+        bundle,
+        clientAssetsCacheControl: EnvironmentConfig.production.clientAssetsCacheControl,
+        clientOutputDir: EnvironmentConfig.production.clientOutputDir,
+        hostname,
+        port,
+        root
+    });
+});
+const serve = Effect.fn('ersc/server/serve')(function*(options) {
+    yield* Layer.build(Layer.unwrap(resolveServerLayer(options)).pipe(Layer.provide(__rspack_external__effect_platform_bun_BunServices_112addf2.layer)));
+});
+
+export { serve };
+
+//# sourceMappingURL=serve.js.map

package/dist/server/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server/serve.js","sources":["../../src/server/serve.ts"],"sourcesContent":["import * as BunServices from '@effect/platform-bun/BunServices';\nimport { Effect, Layer } from 'effect';\n\nimport { loadCompiledServer, makeRunnableServerLayer } from '../build/compiled-server';\nimport { EnvironmentConfig } from '../build/contract';\n\nexport type StartOptions = {\n  readonly hostname: string;\n  readonly port: number;\n  readonly root: string;\n};\n\nconst resolveServerLayer = Effect.fnUntraced(function* ({ hostname, port, root }: StartOptions) {\n  const bundle = yield* loadCompiledServer(root);\n  return yield* makeRunnableServerLayer({\n    bundle,\n    clientAssetsCacheControl: EnvironmentConfig.production.clientAssetsCacheControl,\n    clientOutputDir: EnvironmentConfig.production.clientOutputDir,\n    hostname,\n    port,\n    root,\n  });\n});\n\nexport const serve = Effect.fn('ersc/server/serve')(function* (options: StartOptions) {\n  yield* Layer.build(\n    Layer.unwrap(resolveServerLayer(options)).pipe(Layer.provide(BunServices.layer)),\n  );\n});\n"],"names":["BunServices","Effect","Layer","loadCompiledServer","makeRunnableServerLayer","EnvironmentConfig","resolveServerLayer","hostname","port","root","bundle","serve","options"],"mappings":";;;;;;;;;AAAgE;AACzB;AAEgD;AACjC;AAQtD,MAAMM,kBAAkBA,GAAGL,iBAAiB,CAAC,UAAW,EAAEM,QAAQ,EAAEC,IAAI,EAAEC,IAAI,EAAgB;IAC5F,MAAMC,SAAS,OAAOP,kBAAkBA,CAACM;IACzC,OAAO,OAAOL,uBAAuBA,CAAC;QACpCM;QACA,0BAA0BL,qDAAqD;QAC/E,iBAAiBA,4CAA4C;QAC7DE;QACAC;QACAC;IACF;AACF;AAEO,MAAME,KAAKA,GAAGV,SAAS,CAAC,qBAAqB,UAAWW,OAAqB;IAClF,OAAOV,WAAW,CAChBA,YAAY,CAACI,kBAAkBA,CAACM,UAAU,IAAI,CAACV,aAAa,CAACF,iEAAiB;AAElF,GAAG"}

package/dist/server/start.d.ts

@@ -0,0 +1,3 @@
+import { type StartOptions } from './serve.js';
+export type { StartOptions } from './serve.js';
+export declare const start: (options: StartOptions) => Promise<void>;

package/dist/server/start.js

@@ -0,0 +1,24 @@
+import { Deferred, Effect, Runtime } from "effect";
+import { serve } from "./serve.js";
+
+import * as __rspack_external__effect_platform_bun_BunRuntime_e8fbdd23 from "@effect/platform-bun/BunRuntime";
+
+
+
+
+
+
+const start = (options)=>{
+    const ready = Deferred.makeUnsafe();
+    __rspack_external__effect_platform_bun_BunRuntime_e8fbdd23.runMain(serve(options).pipe(Effect.tap(()=>Deferred.succeed(ready, undefined)), Effect.andThen(Effect.never), Effect.scoped, Effect.onExit((exit)=>Deferred.done(ready, exit))), {
+        // Let the caller observe readiness rejection before runMain exits the process.
+        teardown: (exit, onExit)=>{
+            setImmediate(()=>Runtime.defaultTeardown(exit, onExit));
+        }
+    });
+    return Effect.runPromise(Deferred["await"](ready));
+};
+
+export { start };
+
+//# sourceMappingURL=start.js.map

package/dist/server/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server/start.js","sources":["../../src/server/start.ts"],"sourcesContent":["import * as BunRuntime from '@effect/platform-bun/BunRuntime';\nimport { Deferred, Effect, Runtime } from 'effect';\n\nimport { serve, type StartOptions } from './serve';\n\nexport type { StartOptions } from './serve';\n\nexport const start = (options: StartOptions): Promise<void> => {\n  const ready = Deferred.makeUnsafe<void, Effect.Error<ReturnType<typeof serve>>>();\n\n  BunRuntime.runMain(\n    serve(options).pipe(\n      Effect.tap(() => Deferred.succeed(ready, undefined)),\n      Effect.andThen(Effect.never),\n      Effect.scoped,\n      Effect.onExit((exit) => Deferred.done(ready, exit)),\n    ),\n    {\n      // Let the caller observe readiness rejection before runMain exits the process.\n      teardown: (exit, onExit) => {\n        setImmediate(() => Runtime.defaultTeardown(exit, onExit));\n      },\n    },\n  );\n\n  return Effect.runPromise(Deferred.await(ready));\n};\n"],"names":["BunRuntime","Deferred","Effect","Runtime","serve","start","options","ready","undefined","exit","onExit","setImmediate"],"mappings":";;;;;;;AAA8D;AACX;AAEA;AAI5C,MAAMK,KAAKA,GAAG,CAACC;IACpB,MAAMC,QAAQN,mBAAmB;IAEjCD,kEAAkB,CAChBI,KAAKA,CAACE,SAAS,IAAI,CACjBJ,UAAU,CAAC,IAAMD,gBAAgB,CAACM,OAAOC,aACzCN,cAAc,CAACA,YAAY,GAC3BA,aAAa,EACbA,aAAa,CAAC,CAACO,OAASR,aAAa,CAACM,OAAOE,SAE/C;QACE,+EAA+E;QAC/E,UAAU,CAACA,MAAMC;YACfC,aAAa,IAAMR,uBAAuB,CAACM,MAAMC;QACnD;IACF;IAGF,OAAOR,iBAAiB,CAACD,iBAAc,CAACM;AAC1C,EAAE"}

package/docs/02-guides/06-deploying-to-vercel/index.md

@@ -0,0 +1,34 @@
+### Deploying to Vercel
+
+Deploy to Vercel with Bun 1.4+. Match the adapter version to `effective-rsc`.
+
+```sh
+bun add --dev @ersc/vercel
+```
+
+Set the build script in `package.json`:
+
+```json
+{
+  "scripts": {
+    "build": "ersc build --adapter @ersc/vercel"
+  }
+}
+```
+
+Commit `bun.lock`, connect your GitHub repository in Vercel, and set:
+
+| Setting          | Value                           |
+| ---------------- | ------------------------------- |
+| Framework Preset | Other                           |
+| Root Directory   | Application directory           |
+| Install Command  | `bun install --frozen-lockfile` |
+| Build Command    | `bun run --bun build`           |
+| Output Directory | Leave the override disabled     |
+
+Add your environment variables and deploy. The adapter generates `.vercel/output/`; no custom
+server entry or `vercel.json` is needed.
+
+For [monorepos](https://vercel.com/docs/monorepos/monorepo-faq), enable **Include source files outside
+of the Root Directory in the Build Step**. With Turborepo, use
+`bun run --bun turbo run build --filter=your-app` to build the app and its workspace dependencies.

package/docs/02-guides/index.md

@@ -9,3 +9,4 @@ Familiarity with React Server Components and Effect is assumed.
 - [Routing](./03-routing/index.md)
 - [Middleware](./04-middleware/index.md)
 - [Userland HTTP](./05-http/index.md)
+- [Deploying to Vercel](./06-deploying-to-vercel/index.md)

package/docs/03-advanced/02-client-navigation/index.md

@@ -2,9 +2,12 @@
 
 ERSC handles eligible document navigations through the browser Navigation API and
 `NavigationPrecommitController`. There is no History API fallback. A browser missing either one
-never hydrates: the streamed document stays as served and the application behaves as a plain
-multi-page application, with document navigations and natively submitted forms but no interactive
-Client Components.
+still hydrates Client Components and supports Server Functions and streamed current-page refreshes,
+including HMR. Links use full-page navigation instead of the client router. Without JavaScript,
+the server-rendered document retains working links and natively submitted forms.
+
+Development reports a missing navigation API in the console and a dismissible development-panel
+warning. The warning does not block interaction and is absent in production.
 
 An intercepted Page navigation has two milestones:
 

package/docs/03-advanced/04-production-startup/01_server.ts

@@ -0,0 +1,11 @@
+/**
+ * @title Server entry
+ * Save this as `server.ts` in the application root and run it with `bun server.ts` after building.
+ */
+import { start } from 'effective-rsc/server';
+
+await start({
+  hostname: 'localhost',
+  port: 18193,
+  root: import.meta.dir,
+});

package/docs/03-advanced/04-production-startup/index.md

@@ -0,0 +1,22 @@
+## Production startup
+
+Run `ersc build`, then `ersc start`. A custom Bun entry can await
+`start({ root, hostname, port })` from `effective-rsc/server`. All options are required;
+`root` is the application directory. Deploy its `.ersc/`, `public/`, and runtime dependencies.
+
+The Promise resolves when ready; startup failures reject and exit. ERSC owns signal handling
+and cleanup, so do not wrap it in `BunRuntime.runMain`.
+
+### Deployment adapters
+
+`ersc build --adapter <package>` runs an installed adapter after compilation; it does not upload.
+Without the flag, packaging is skipped and previous output remains.
+
+Adapters export `build: BuildHook` from `./build`, with types from `effective-rsc/build`.
+The hook receives absolute `root`, `serverDir`, `clientDir`, and `publicDir` paths and returns
+`Effect<void, Error, Scope>`. Inputs are read-only; adapters provide dependencies and ERSC owns
+cleanup/cancellation. Failures stop the build.
+
+<!-- source-navigation -->
+
+- [Deploying to Vercel](../../02-guides/06-deploying-to-vercel/index.md)

package/docs/03-advanced/index.md

@@ -9,3 +9,4 @@ before adopting them.
 - [Request runtime and lifetimes](./01-request-runtime-and-lifetimes/index.md)
 - [Client navigation](./02-client-navigation/index.md)
 - [Server Function execution and refresh](./03-server-function-execution-and-refresh/index.md)
+- [Production startup](./04-production-startup/index.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "effective-rsc",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "An experimental, Effect-native React Server Components framework for Bun.",
   "keywords": [
     "bun",
@@ -37,6 +37,14 @@
       "types": "./dist/index.d.ts",
       "react-server": "./dist/index.js",
       "default": "./dist/unsupported.js"
+    },
+    "./server": {
+      "types": "./dist/server/start.d.ts",
+      "default": "./dist/server/start.js"
+    },
+    "./build": {
+      "types": "./dist/build/hook.d.ts",
+      "default": "./dist/build/hook.js"
     }
   },
   "publishConfig": {
@@ -47,7 +55,6 @@
     "docs:check": "bun ../../scripts/generate-docs.ts --check",
     "prepack": "bun run build && bun run docs:check",
     "test": "bun run --bun vitest run",
-    "test:types": "tsc --noEmit -p tests/types/tsconfig.json",
     "test:watch": "bun run --bun vitest"
   },
   "dependencies": {