@jk2908/solas 0.13.2 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.14.0
+
+### Breaking
+
+- Runtime helpers moved out of `@jk2908/solas/adapters/*`: `serve` is now a named export from `@jk2908/solas/runtime/node`, and `createWorker`/`createCloudflareAssets` are now `@jk2908/solas/runtime/cloudflare`. The old `@jk2908/solas/adapters/node` and `@jk2908/solas/adapters/cloudflare/runtime` entries are removed. `@jk2908/solas/adapters/*` now contains build adapters only.
+
 ## 0.13.2
 
 ### Changed

package/README.md

@@ -659,18 +659,18 @@ Because workers have no filesystem, the Worker reads its own output through the
 `cloudflare()` forwards its `cloudflare` option to `@cloudflare/vite-plugin`. To build a Worker manually, `createWorker` composes the entry behaviour, and `createCloudflareAssets` builds the store directly:
 
 ```ts
-import { createCloudflareAssets } from '@jk2908/solas/adapters/cloudflare/runtime'
+import { createCloudflareAssets } from '@jk2908/solas/runtime/cloudflare'
 
 const assets = createCloudflareAssets(env)
 ```
 
 ## Node
 
-`vite dev` and `vite preview` already run the built handler in Node (via `@vitejs/plugin-rsc`'s default server handler), so nothing extra is needed locally. For a production Node server, use `@jk2908/solas/adapters/node`:
+`vite dev` and `vite preview` already run the built handler in Node (via `@vitejs/plugin-rsc`'s default server handler), so nothing extra is needed locally. For a production Node server, use `@jk2908/solas/runtime/node`:
 
 ```ts
 // server.ts
-import serve from '@jk2908/solas/adapters/node'
+import { serve } from '@jk2908/solas/runtime/node'
 
 await serve()
 ```
@@ -686,6 +686,8 @@ await serve()
 
 `serve()` loads the built RSC entry (`dist/rsc/index.js` by default) and forwards requests to its fetch handler, which already serves prerendered routes, client assets, and RSC/SSR responses. Options: `port` (defaults to `PORT` or `3000`), `host`, `outDir`, and `entry`. Run from the project root so the handler can resolve `dist`.
 
+`serve` is a runtime helper, not a build adapter: it starts an HTTP server and returns it, so it belongs in `server.ts`. Do not pass it to `solas({ adapter })`; that option expects an `Adapter` with `name` and `plugins`, such as `cloudflare()` or the static adapter.
+
 Bun and Deno do not need the helper. Their native servers pass the handler a `Request` directly and expect a `Response`, so the Node-specific HTTP-to-Fetch bridging (streams, `duplex`, backpressure) is not needed:
 
 ```ts
@@ -702,7 +704,7 @@ import handler from './dist/rsc/index.js'
 Deno.serve(request => handler.fetch(request))
 ```
 
-The handler reads `dist` through `node:fs`, which Bun and Deno (2.x, via Node compat) provide. Run from the project root. Bun can also run `@jk2908/solas/adapters/node` as-is, since it implements `node:http`.
+The handler reads `dist` through `node:fs`, which Bun and Deno (2.x, via Node compat) provide. Run from the project root. Bun can also run `@jk2908/solas/runtime/node` as-is, since it implements `node:http`.
 
 ## Static
 
@@ -731,7 +733,7 @@ Server actions and runtime endpoints also need a server, so the build warns when
 
 ## Runtime
 
-At request time Solas reads its output through an `Assets` interface (`exists`/`readText`/`readBuffer`/`mimeType`) injected into `createHandler`, defaulting to the Node standard library (which Bun runs natively). References are logical (`{ namespace, path }`), where the namespaces are `client` (Vite client output), `static` (full prerenders), and `artifact` (runtime manifest and ppr files). Platforms without a filesystem provide their own store; `@jk2908/solas/adapters/cloudflare/runtime` builds one around the `ASSETS` binding via `createWorker`. Build-time reads and writes use `node:fs` directly and are not abstracted.
+At request time Solas reads its output through an `Assets` interface (`exists`/`readText`/`readBuffer`/`mimeType`) injected into `createHandler`, defaulting to the Node standard library (which Bun runs natively). References are logical (`{ namespace, path }`), where the namespaces are `client` (Vite client output), `static` (full prerenders), and `artifact` (runtime manifest and ppr files). Platforms without a filesystem provide their own store; `@jk2908/solas/runtime/cloudflare` builds one around the `ASSETS` binding via `createWorker`. Build-time reads and writes use `node:fs` directly and are not abstracted.
 
 ## Scripts
 

package/dist/adapters/cloudflare/vite.js

@@ -4,7 +4,7 @@ import { cloudflare as cloudflareVitePlugin } from '@cloudflare/vite-plugin';
 import * as Config from '../../config.js';
 import { writeCloudflareEntry } from '../../internal/codegen/environments.js';
 import { setPrerenderImport, setRscEntry } from '../../internal/postbuild.js';
-import { NAMESPACE_PREFIX } from './assets.js';
+import { NAMESPACE_PREFIX } from '../../runtime/cloudflare/assets.js';
 import { withBindingsShim } from './bindings.js';
 const VIRTUAL_ENTRY = 'virtual:solas-cloudflare-entry';
 /**

package/dist/internal/codegen/environments.js

@@ -31,7 +31,7 @@ export function writeCloudflareEntry() {
     return source `
 		${AUTOGEN_MSG}
 
-		import { createWorker } from '${Config.PKG_NAME}/adapters/cloudflare/runtime'
+		import { createWorker } from '${Config.PKG_NAME}/runtime/cloudflare'
 
 		import { manifest } from './manifest.js'
 		import { importMap } from './maps.js'

package/dist/{adapters → runtime}/node.d.ts

@@ -38,7 +38,7 @@ export type Server = http.Server & AsyncDisposable;
  * Deno and Bun do not need this helper: use `Deno.serve(handler.fetch)` or
  * `Bun.serve({ fetch: handler.fetch })` directly.
  */
-declare function adapter(options?: ServeOptions): Promise<http.Server<typeof http.IncomingMessage, typeof http.ServerResponse> & {
+declare function serve(options?: ServeOptions): Promise<http.Server<typeof http.IncomingMessage, typeof http.ServerResponse> & {
     [Symbol.asyncDispose](): Promise<void>;
 }>;
-export { adapter as default };
+export { serve };

package/dist/{adapters → runtime}/node.js

@@ -151,7 +151,7 @@ async function sendResponse(res, response) {
  * Deno and Bun do not need this helper: use `Deno.serve(handler.fetch)` or
  * `Bun.serve({ fetch: handler.fetch })` directly.
  */
-async function adapter(options = {}) {
+async function serve(options = {}) {
     const outDir = options.outDir ?? 'dist';
     const entry = path.resolve(options.entry ?? path.join(outDir, 'rsc', 'index.js'));
     const port = options.port ?? (Number(process.env.PORT) || 3000);
@@ -194,4 +194,4 @@ async function adapter(options = {}) {
         },
     });
 }
-export { adapter as default };
+export { serve };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@jk2908/solas",
-	"version": "0.13.2",
+	"version": "0.14.0",
 	"description": "A Vite + React meta-framework exploring streaming, Server Components, and partial prerendering. Designed for simplicity and lightness",
 	"keywords": [
 		"framework",
@@ -73,17 +73,17 @@
 			"types": "./dist/adapters/cloudflare/index.d.ts",
 			"import": "./dist/adapters/cloudflare/index.js"
 		},
-		"./adapters/cloudflare/runtime": {
-			"types": "./dist/adapters/cloudflare/runtime.d.ts",
-			"import": "./dist/adapters/cloudflare/runtime.js"
-		},
-		"./adapters/node": {
-			"types": "./dist/adapters/node.d.ts",
-			"import": "./dist/adapters/node.js"
-		},
 		"./adapters/static": {
 			"types": "./dist/adapters/static.d.ts",
 			"import": "./dist/adapters/static.js"
+		},
+		"./runtime/cloudflare": {
+			"types": "./dist/runtime/cloudflare/index.d.ts",
+			"import": "./dist/runtime/cloudflare/index.js"
+		},
+		"./runtime/node": {
+			"types": "./dist/runtime/node.d.ts",
+			"import": "./dist/runtime/node.js"
 		}
 	},
 	"scripts": {