@phreshos/server 0.1.3 → 0.1.5

package/README.md

@@ -76,13 +76,10 @@ retained handle. Server and Client handles remain stable for their Process
 lifetime. Each Client permanently owns one synchronous `window` capability,
 whose operations address that Client's current live presentation state.
 
-An `under` or `over` Client Window may own an authoritative host Surface through
-`client.window.surface`. It is command-only: `set()` or `remove()` changes the
-server-owned value, while Program endpoints cannot read or subscribe to it.
-Radius may be a
-nonnegative pixel number, `"full"`, or a semantic `ScaleLevel` resolved by the
-desktop against its current Theme. Ordinary `window` and system `wallpaper`
-layers reject Surface mutations.
+Surface presentation is deliberately absent from the Server SDK. It belongs to
+one live iframe representation and is requested through the Client's
+`current.window.surface`; a Server may coordinate Program state, but it neither
+owns nor controls the resulting desktop material.
 
 The package provides two contextual runtime entry points:
 

package/dist/channel.d.ts

@@ -1,8 +1,9 @@
-import type { Channel as CoreChannel, ChannelMessage, Cleanup } from "@phreshos/core";
+import type { Channel as CoreChannel, ChannelMessage, Cleanup, ServerServiceDefinition } from "@phreshos/core";
+import { type Endpoint } from "./domain.js";
 /** Handles one question addressed to the current Server. */
 export type Answerer<Payload = unknown, Result = undefined> = (message: ChannelMessage<Payload>) => Result | Promise<Result>;
 /** Events and questions explicitly accepted by the current Server. */
-export interface Channel<Events extends object = {}> extends CoreChannel<Events> {
+export interface Channel<Events extends object = {}> extends CoreChannel<Events, Endpoint, ServerServiceDefinition> {
     /** Registers one answerer; omitting its return produces `undefined`. */
     answer<Payload = unknown, Result = undefined>(event: string, answerer: Answerer<Payload, Result>): Cleanup;
 }

package/dist/channel.js

@@ -12,7 +12,7 @@ class ServerChannel extends Events {
     publish(event, payload = undefined) {
         wire.send("end-host", "emit", event, payload);
     }
-    async enableService(name) { await enableCurrentService(name); }
+    async enableService(definition) { await enableCurrentService(definition); }
     async disableService() { await disableCurrentService(); }
     answer(event, answerer) {
         return wire.answer("end-end", event, value => answerer(message(value)));

package/dist/current.d.ts

@@ -1,10 +1,9 @@
-import type { Channel as CoreChannel } from "@phreshos/core";
-import { type Answerer } from "./channel.js";
+import { type Answerer, type Channel } from "./channel.js";
 import { Client, type Process, type Program, type Server } from "./domain.js";
 /** The current Process's canonical Client handle. */
 export type CurrentClient<Events extends object = {}> = Client<Events>;
 /** Current Server context: its inbound Channel, owner hierarchy, and paired Client. */
-export interface Current<Events extends object = {}> extends CoreChannel<Events>, Pick<Server, "service"> {
+export interface Current<Events extends object = {}> extends Channel<Events>, Pick<Server, "service"> {
     /** The same Client handle exposed by the current Process. */
     readonly client: CurrentClient;
     /** Registers one answerer; omitting its return produces `undefined`. */

package/dist/domain.js

@@ -67,10 +67,6 @@ class ProgramHandle extends ProgramBase {
         const answer = await wire.request(["create-process", this.address, launch]);
         return process(answer[0]);
     }
-    async apiDocs() {
-        const answer = await wire.request(["api-docs", this.address]);
-        return answer[0];
-    }
     async icon(size = "medium") {
         const answer = await wire.request(["icon", this.address, size]);
         return new Blob([Uint8Array.from(answer[0])], { type: "image/png" });
@@ -253,11 +249,9 @@ class ClientHandle extends ClientBase {
 }
 class WindowHandle extends Events {
     target;
-    surface;
     constructor(target) {
         super(...deferredScoped("host-end", target, (_event, values) => values[0]));
         this.target = target;
-        this.surface = new WindowSurfaceHandle(target);
     }
     async state() {
         const answer = await wire.request(["window", await this.target()]);
@@ -272,18 +266,11 @@ class WindowHandle extends Events {
     async location() { return (await this.state()).location; }
     async move(position) { await wire.request(["move", await this.target(), position]); }
     async resize(size) { await wire.request(["resize", await this.target(), size]); }
+    async setGeometry(geometry) { await wire.request(["setGeometry", await this.target(), geometry]); }
     async minimize(minimized = true) { await wire.request(["minimize", await this.target(), minimized]); }
     async changeTitle(title) { await wire.request(["changeTitle", await this.target(), title]); }
     async raise() { await wire.request(["raise", await this.target()]); }
 }
-class WindowSurfaceHandle {
-    target;
-    constructor(target) {
-        this.target = target;
-    }
-    async set(settings = {}) { await wire.request(["surfaceSet", await this.target(), settings]); }
-    async remove() { await wire.request(["surfaceRemove", await this.target()]); }
-}
 function deferredScoped(route, target, convert) {
     return [
         (event, listener, impossible) => {
@@ -307,7 +294,7 @@ function deferredScoped(route, target, convert) {
     ];
 }
 function windowEvent(event) {
-    return event === "move" || event === "resize" || event === "minimize" || event === "changeTitle" || event === "front";
+    return event === "move" || event === "resize" || event === "geometry" || event === "minimize" || event === "changeTitle" || event === "front";
 }
 function deferred(target, register, impossible) {
     let active = true;

package/dist/host.d.ts

@@ -37,8 +37,6 @@ type Description = Readonly<{
     version?: string;
     /** Short human-readable Program description. */
     description?: string;
-    /** Path to the Program-authored API entry document. */
-    apiDocs?: string;
     /** Absolute validated PNG source used to derive the Program's hosted icon sizes. */
     icon?: string;
     /** Absolute directory used for the Program's persistent storage. */

package/dist/main.d.ts

@@ -4,4 +4,4 @@ export { type Answerer, type Channel } from "./channel.js";
 export { type ProgramStartup } from "./startup.js";
 export { ClientServiceHandler, ServerServiceHandler, ServiceHandler, type ClientServiceChannel, type ServerServiceChannel, type ServiceChannel, type ServiceKey, type ServiceLifecycleEvents } from "@phreshos/core";
 export { Client, Endpoint, Process, Program, Server, type Window, type ProgramArea } from "./domain.js";
-export type { AnswerCapture, AnswerMessage, AnswerObserver, Askable, AskCapture, AskMessage, AskObserver, Capture, Captures, ChannelCapture, ChannelEvents, ChannelMessage, 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, ProgramPermissions, ProgramProcessExit, ProgramSql, ProgramStore, ProcessEvents, Publishable, ServedFile, ServerTraffic, Size, Subscribable, SubscribableEvents, SubscribableFallback, TimedAskable, TrafficCapture, TrafficEvents, TrafficMessage, Value, Theme, ThemeEvents, ThemeProperties, WallpaperLaunch, FileWallpaper, DesktopWallpaper, WritableTheme, WindowEvents, WindowLayer, WindowState, WindowSurface, WindowSurfaceEasing, WindowSurfaceSettings, WindowSurfaceTransaction } from "@phreshos/core";
+export type { AnswerCapture, AnswerMessage, AnswerObserver, Askable, AskCapture, AskMessage, AskObserver, Capture, Captures, ChannelCapture, ChannelEvents, ChannelMessage, 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, ProgramPermissions, ProgramProcessExit, ProgramSql, ProgramStore, ProcessEvents, Publishable, ServedFile, ServerTraffic, Size, Subscribable, SubscribableEvents, SubscribableFallback, TimedAskable, TrafficCapture, TrafficEvents, TrafficMessage, Value, Theme, ThemeEvents, ThemeProperties, WallpaperLaunch, FileWallpaper, DesktopWallpaper, WritableTheme, WindowEvents, WindowGeometry, WindowLayer, WindowState } from "@phreshos/core";

package/dist/service.d.ts

@@ -1,4 +1,4 @@
-import { type ClientServiceHandler, type ServerServiceHandler, type ServiceHandler, type ServiceKey } from "@phreshos/core";
+import { type ClientServiceHandler, type ServerServiceDefinition, type ServerServiceHandler, type ServiceHandler, type ServiceKey } from "@phreshos/core";
 import type { HandleAddress } from "./domain.js";
 export declare function service<EventsMap extends object = {}>(key: ServiceKey & {
     endpoint: "server";
@@ -7,7 +7,7 @@ export declare function service<EventsMap extends object = {}>(key: ServiceKey &
     endpoint: "client";
 }): ClientServiceHandler<EventsMap>;
 export declare function service(key: ServiceKey): ServiceHandler;
-export declare function enableCurrentService(name: string): Promise<void>;
+export declare function enableCurrentService(definition: ServerServiceDefinition): Promise<void>;
 export declare function disableCurrentService(): Promise<void>;
 export declare function endpointService<EventsMap extends object = {}>(target: HandleAddress | null, endpoint: "server"): Promise<ServerServiceHandler<EventsMap> | null>;
 export declare function endpointService<EventsMap extends object = {}>(target: HandleAddress | null, endpoint: "client"): Promise<ClientServiceHandler<EventsMap> | null>;

package/dist/service.js

@@ -63,6 +63,10 @@ class ServerHandler extends ServerServiceBase {
         const answer = await wire.request(["service-disabled", this.key]);
         return answer[0];
     }
+    async docs() {
+        const answer = await wire.request(["service-docs", this.key]);
+        return answer[0];
+    }
 }
 class ClientHandler extends ClientServiceBase {
     key;
@@ -94,8 +98,8 @@ export function service(key) {
             : new ClientHandler(normalized);
     });
 }
-export async function enableCurrentService(name) {
-    await wire.request(["enable-service", name]);
+export async function enableCurrentService(definition) {
+    await wire.request(["enable-service", definition]);
 }
 export async function disableCurrentService() {
     await wire.request(["disable-service"]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/server",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "The SDK used by a Program's server endpoint.",
   "type": "module",
   "main": "dist/main.js",
@@ -46,10 +46,10 @@
     "prepack": "node --run build"
   },
   "peerDependencies": {
-    "@phreshos/core": "^0.1.3"
+    "@phreshos/core": "^0.1.5"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.3",
+    "@phreshos/core": "^0.1.5",
     "@types/node": "^26.2.0",
     "typescript": "^6.0.3"
   }