@phreshos/server 0.1.20 → 0.1.21

package/README.md

@@ -42,11 +42,13 @@ await system.appearance.update({
 void bytes
 ```
 
-Its JavaScript entry point adapts the Process IPC boundary to these contracts.
+Its JavaScript entry point adapts the Server runtime boundary to these contracts.
 The SDK owns callbacks, waits, queues, and their cleanup; the boundary owns
 only the forwarding registrations requested by the SDK.
 
-Importing the SDK injects no message into the child process. The endpoint may
+The same SDK works in either supported Server runtime: a child process uses its
+IPC channel, while a System-owned Worker uses its parent port. Importing the SDK
+injects no message into either runtime. The endpoint may
 announce its readiness outward, but identity, Theme, Process, readiness,
 lifecycle, and application values enter only in response to an explicit request
 or a live registration made by Program code.

package/dist/system.d.ts

@@ -3,16 +3,23 @@ import type { ClientServiceHandler, ServerServiceHandler } from "./service.js";
 import { type Client, type Process, type Program, type Server } from "./domain.js";
 import { type Storage } from "./storage.js";
 /** Resolved production description for a Program's Server. */
-export type ServerDescription = Readonly<{
+type ServerDescriptionBase = Readonly<{
     /** Absolute directory containing the production Server files. */
     location: string;
     /** Whether newly created Processes start this Server by default. */
     start?: boolean;
     /** Command used to install the Server's production dependencies. */
     installCommand?: string;
-    /** Command used to start the Server from its production directory. */
-    startCommand: string;
 }>;
+export type ServerDescription = ServerDescriptionBase & (Readonly<{
+    /** Command used to start an isolated Server process. */
+    startCommand: string;
+    entryFile?: never;
+}> | Readonly<{
+    startCommand?: never;
+    /** JavaScript module loaded as a worker owned by the System. */
+    entryFile: string;
+}>);
 /** Resolved production description for a Program's Client and initial Window. */
 export type ClientDescription = Readonly<{
     /** Absolute directory containing the production Client files. */

package/dist/wire.d.ts

@@ -14,6 +14,7 @@ declare class Wire {
     private readonly waiting;
     private readonly impossible;
     private identityPromise;
+    private readonly transport;
     constructor();
     send(route: string, ...values: unknown[]): void;
     request(values: unknown[], timeout?: number): Promise<unknown>;

package/dist/wire.js

@@ -2,6 +2,7 @@ import { randomUUID } from "node:crypto";
 import Deadline from "./deadline.js";
 import { defaultTimeout } from "./events.js";
 import { deserialize, serialize } from "./messagepack.js";
+import { parentPort } from "node:worker_threads";
 /** The server endpoint's sole IPC adapter. */
 class Wire {
     pending = new Map();
@@ -12,8 +13,9 @@ class Wire {
     waiting = new Map();
     impossible = new Map();
     identityPromise = null;
+    transport = endpointTransport();
     constructor() {
-        process.on("message", message => {
+        this.transport.onMessage(message => {
             if (!(message instanceof Uint8Array))
                 return;
             let decoded;
@@ -50,10 +52,10 @@ class Wire {
             }
             this.deliver(route, values);
         });
-        process.send?.(serialize(["boundary", "ready"]));
+        this.transport.send(serialize(["boundary", "ready"]));
     }
     send(route, ...values) {
-        process.send?.(serialize([route, ...values]));
+        this.transport.send(serialize([route, ...values]));
     }
     request(values, timeout = defaultTimeout) {
         return this.requestWithin(values, new Deadline(timeout));
@@ -337,6 +339,18 @@ class Wire {
         stream.wake = null;
     }
 }
+function endpointTransport() {
+    const worker = parentPort;
+    if (worker)
+        return {
+            onMessage: listener => worker.on("message", listener),
+            send: message => worker.postMessage(message)
+        };
+    return {
+        onMessage: listener => { process.on("message", listener); },
+        send: message => { process.send?.(message); }
+    };
+}
 const maximumStreamQueue = 256;
 function failed(error) {
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/server",
-  "version": "0.1.20",
+    "version": "0.1.21",
   "description": "The SDK used by a Program's server endpoint.",
   "type": "module",
   "main": "dist/main.js",
@@ -42,17 +42,18 @@
     "check": "tsc --noEmit",
     "build": "node --run clean && tsc --noEmit false --outDir dist --rootDir source",
     "verify:package": "node scripts/verify-package.mjs",
-    "verify": "node --run check && node --run build && node --run verify:package",
+    "verify:worker": "node scripts/verify-worker.mjs",
+    "verify": "node --run check && node --run build && node --run verify:worker && node --run verify:package",
     "prepack": "node --run build"
   },
   "peerDependencies": {
-    "@phreshos/core": "^0.1.19"
+    "@phreshos/core": "^0.1.20"
   },
   "dependencies": {
     "@msgpack/msgpack": "^3.1.3"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.19",
+        "@phreshos/core": "^0.1.20",
     "@types/node": "^26.2.0",
     "typescript": "^6.0.3"
   }