@phreshos/server 0.1.3 → 0.1.4

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" });

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/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.4",
   "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.4"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.3",
+    "@phreshos/core": "^0.1.4",
     "@types/node": "^26.2.0",
     "typescript": "^6.0.3"
   }