@phreshos/server 0.1.20 → 0.1.22

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/main.d.ts

@@ -1,4 +1,4 @@
-export { system, type System, type SystemProcess, type SystemProgram, type ClientDescription, type SystemProcessEvents, type SystemProcessExit, type SystemProgramEvents, type SystemProgramUninstall, type ProgramDescription, type ServerDescription } from "./system.js";
+export { system } from "./system.js";
 export { current, type Current, type CurrentClient } from "./current.js";
 export { type Answerer, type Channel, type ChannelCapture, type ChannelEvents, type ChannelMessage } from "./channel.js";
 export { type ProgramStartup } from "./startup.js";
@@ -6,4 +6,4 @@ export { type Storage } from "./storage.js";
 export { ClientServiceHandler, ServerServiceHandler } from "./service.js";
 export { ServiceHandler, type ClientServiceChannel, type ServerServiceChannel, type ServiceChannel, type ServiceKey, type ServiceLifecycleEvents } from "@phreshos/core";
 export { Client, Endpoint, Process, Program, Server, type Window, type ProgramProcess } from "./domain.js";
-export type { AnswerCapture, AnswerMessage, AnswerObserver, Askable, AskCapture, AskMessage, AskObserver, Capture, Captures, ClientTraffic, ClientDeclaration, Cleanup, DirectoryStat, EndpointDeclaration, EndpointTraffic, EntryStat, EventMessage, EventName, EventObserver, EventOptions, EventSubscriber, Exit, FileStat, Launch, LaunchClient, Layer, LogKind, LogRecord, LogSource, Message, OtherStat, Outcome, Position, ProgramEvents, ProgramPermission, ProgramProcessEvents, ProgramProcessExit, ProgramSql, ProgramStore, ProcessEvents, Publishable, SystemUploads, Upload, ServerTraffic, Size, Subscribable, SubscribableEvents, SubscribableFallback, TimedAskable, TrafficCapture, TrafficEvents, TrafficMessage, Value, Appearance, AppearanceEvents, AppearanceSource, AppearanceSurface, ThemedValue, WritableAppearance, WindowEvents, WindowGeometry, WindowLayer, WindowState } from "@phreshos/core";
+export type { AnswerCapture, AnswerMessage, AnswerObserver, Askable, AskCapture, AskMessage, AskObserver, Capture, Captures, ClientTraffic, ClientDeclaration, Cleanup, DirectoryStat, EndpointDeclaration, EndpointTraffic, EntryStat, EventMessage, EventName, EventObserver, EventOptions, EventSubscriber, Exit, FileStat, Launch, LaunchClient, Layer, LogKind, LogRecord, LogSource, Message, OtherStat, Outcome, Position, ProgramEvents, ProgramPermission, ProgramProcessEvents, ProgramProcessExit, ProgramSql, ProgramStore, ProcessEvents, Publishable, SystemUploads, Upload, ServerTraffic, System, SystemProcess, SystemProcessEntity, SystemProcessEntityEvents, SystemProgram, SystemProgramEntity, SystemProgramProcess, SystemProgramProcessEvents, SystemEndpointEntity, SystemServerEntity, SystemClientEntity, ClientDescription, SystemProcessEvents, SystemProcessExit, SystemProgramEvents, SystemProgramUninstall, ProgramDescription, ServerDescription, Size, Subscribable, SubscribableEvents, SubscribableFallback, TimedAskable, TrafficCapture, TrafficEvents, TrafficMessage, Value, Appearance, AppearanceEvents, AppearanceSource, AppearanceSurface, ThemedValue, WritableAppearance, WindowEvents, WindowGeometry, WindowLayer, WindowState } from "@phreshos/core";

package/dist/system.d.ts

@@ -1,126 +1,3 @@
-import type { Exit, Layer, Position, ServiceKey, Size, Subscribable, SystemUploads, WritableAppearance } from "@phreshos/core";
-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<{
-    /** 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;
-}>;
-/** Resolved production description for a Program's Client and initial Window. */
-export type ClientDescription = Readonly<{
-    /** Absolute directory containing the production Client files. */
-    location: string;
-    /** Whether newly created Processes start this Client by default. */
-    start?: boolean;
-    /** Default Window title. */
-    title?: string;
-    /** Default Window size. */
-    size?: Size;
-    /** Default Window position. */
-    position?: Position;
-    /** Default Window layer. */
-    layer?: Layer;
-    /** Whether the Window starts minimized. */
-    minimize?: boolean;
-}>;
-type Description = Readonly<{
-    /** Stable identity assigned to the Program. */
-    identity: string;
-    /** Human-readable Program name. */
-    name?: string;
-    /** Declared Program version. */
-    version?: string;
-    /** Short human-readable Program description. */
-    description?: string;
-    /** Absolute validated PNG source used to derive the Program's hosted icon sizes. */
-    icon?: string;
-    /** Absolute Markdown file describing Program-specific operation to agents. */
-    agent?: string;
-    /** Absolute directory used for the Program's persistent storage. */
-    storage: string;
-}>;
-/** Complete runtime description used to create a Program. */
-export type ProgramDescription = Description & (Readonly<{
-    /** Required Server description when no Client is described. */
-    server: ServerDescription;
-    /** Optional Client description. */
-    client?: ClientDescription;
-}> | Readonly<{
-    /** Optional Server description. */
-    server?: ServerDescription;
-    /** Required Client description when no Server is described. */
-    client: ClientDescription;
-}>);
-/** An uninstall reported with the affected Program and removal scope. */
-export type SystemProgramUninstall = Readonly<{
-    /** Program that left the installed state. */
-    program: Program;
-    /** Whether all installed resources, including storage, were removed. */
-    everythingRemoved: boolean;
-}>;
-/** A Process exit reported with the Process that ended. */
-export type SystemProcessExit = Exit & Readonly<{
-    /** Process that ended. */
-    process: Process;
-}>;
-/** Authoritative lifecycle events visible to the Server system. */
-export type SystemProgramEvents = {
-    /** A Program entered the runtime registry. */
-    create: Program;
-    /** A Program left the runtime registry. */
-    forget: Program;
-    /** A Program entered the installed state. */
-    install: Program;
-    /** A Program left the installed state. */
-    uninstall: SystemProgramUninstall;
-};
-/** Authoritative Process lifecycle events visible to the Server system. */
-export type SystemProcessEvents = {
-    /** One Process Endpoint entered a new live incarnation. */
-    endpointStart: Server | Client;
-    /** One Process Endpoint incarnation ended. */
-    endpointStop: Server | Client;
-    /** A Process entered the runtime set. */
-    create: Process;
-    /** A Process left the runtime set. */
-    exit: SystemProcessExit;
-};
-/** Authoritative Program registry available to a Server endpoint. */
-export interface SystemProgram extends Subscribable<SystemProgramEvents, never> {
-    list(onlyInstalled?: boolean): Promise<Program[]>;
-    find(identity: string): Promise<Program | null>;
-    create(source: ProgramDescription | string): Promise<Program>;
-}
-/** Authoritative Process registry available to a Server endpoint. */
-export interface SystemProcess extends Subscribable<SystemProcessEvents, never> {
-    list(): Promise<Process[]>;
-    find(identity: string): Promise<Process | null>;
-}
-/** Authoritative system capabilities available to a Server endpoint. */
-export interface System {
-    /** Native operating-system home storage available to Server endpoints. */
-    readonly storage: Storage;
-    /** Complete unresolved Appearance authority owned by the System. */
-    readonly appearance: WritableAppearance;
-    readonly program: SystemProgram;
-    readonly process: SystemProcess;
-    /** Flat System-owned public uploads capability. */
-    readonly uploads: SystemUploads;
-    /** Returns a stable handle for one exact Service identity. */
-    service<ServiceEvents extends object = {}>(key: ServiceKey & {
-        endpoint: "server";
-    }): ServerServiceHandler<ServiceEvents>;
-    service<ServiceEvents extends object = {}>(key: ServiceKey & {
-        endpoint: "client";
-    }): ClientServiceHandler<ServiceEvents>;
-}
+import type { System } from "@phreshos/core";
 /** Authoritative system capabilities for the currently executing Server. */
 export declare const system: System;
-export {};

package/dist/system.js

@@ -1,5 +1,5 @@
 import Events from "./events.js";
-import { exit, lifecycleEndpoint, process, program } from "./domain.js";
+import { exit, lifecycleEndpoint, process, program, } from "./domain.js";
 import { uploads } from "./uploads.js";
 import ServerAppearance from "./appearance.js";
 import wire from "./wire.js";

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.22",
   "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.21"
   },
   "dependencies": {
     "@msgpack/msgpack": "^3.1.3"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.19",
+        "@phreshos/core": "^0.1.21",
     "@types/node": "^26.2.0",
     "typescript": "^6.0.3"
   }