@phreshos/client 0.1.30 → 0.1.32

package/dist/context.d.ts

@@ -1,7 +1,7 @@
 import type { Context as CoreContext, ContextCapture as CoreContextCapture, ContextEvents as CoreContextEvents, ContextMessage as CoreContextMessage } from "@phreshos/core";
 import { Server, type Endpoint, type Process, type Program, type Window } from "./domain.js";
 /** The executing Process's canonical Server handle. */
-export type ContextServer<Events extends object = {}> = Server<Events>;
+export type ContextServer<Events extends object = {}, Fallback = unknown> = Server<Events, Fallback>;
 /** One value addressed to the current Client, with a client-visible sender. */
 export type ContextMessage<Payload = unknown> = CoreContextMessage<Payload, Endpoint | null>;
 /** Applies the client-visible sender envelope to known Context events. */

package/dist/context.js

@@ -23,7 +23,7 @@ class ContextServerHandle extends ServerBase {
     async start(launch = {}) { await wire.request(["start-endpoint", undefined, "server", launch]); }
     async stop() { await wire.request(["stop-endpoint", undefined, "server"]); }
     async isService() { return (await wire.request(["is-service", "server"]))[0]; }
-    async waitReady(timeout) { await wire.request(["wait-ready"], timeout); }
+    async waitReady(timeout) { await wire.request(["wait-ready", undefined, "server"], timeout); }
     async ask(event, payload = undefined) {
         return this.askWithin(undefined, event, payload);
     }
@@ -32,7 +32,7 @@ class ContextServerHandle extends ServerBase {
     }
     async askWithin(timeout, event, payload) {
         const deadline = new Deadline(timeout);
-        await wire.requestWithin(["wait-ready", null, true], deadline);
+        await wire.requestWithin(["wait-ready", undefined, "server", true], deadline);
         return await wire.askServerWithin(event, payload, deadline);
     }
 }
@@ -77,6 +77,7 @@ class ContextClientHandle extends ClientBase {
     async start(launch = {}) { await wire.request(["start-endpoint", undefined, "client", launch]); }
     async stop() { await wire.request(["stop-endpoint", undefined, "client"]); }
     async isService() { return (await wire.request(["is-service", "client"]))[0]; }
+    async waitReady(timeout) { await wire.request(["wait-ready", undefined, "client"], timeout); }
 }
 contextClient = new ContextClientHandle(owner);
 class ClientContext extends Events {

package/dist/domain.d.ts

@@ -84,7 +84,7 @@ export type TrafficMessage<Payload = unknown> = CoreTrafficMessage<Payload, Endp
 /** Applies client-visible destination metadata to known traffic events. */
 export type TrafficEvents<Events extends object> = CoreTrafficEvents<Events, Endpoint | null>;
 /** Every ordinary event observable in client-visible Endpoint traffic. */
-export type TrafficCapture<Events extends object = {}> = CoreTrafficCapture<Events, Endpoint | null>;
+export type TrafficCapture<Events extends object = {}, Fallback = unknown> = CoreTrafficCapture<Events, Endpoint | null, Fallback>;
 /** Question with a Server destination hidden when it crosses the Client boundary. */
 export type AskMessage<Payload = unknown> = CoreAskMessage<Payload, Server | null>;
 /** One question observable in client-visible Endpoint traffic. */
@@ -98,29 +98,29 @@ export type AnswerCapture<Result = unknown> = CoreAnswerCapture<Result, Endpoint
 /** Callback that observes answers sent by a client-visible Server. */
 export type AnswerSubscriber<Result = unknown> = CoreAnswerSubscriber<Result, Endpoint | null>;
 /** Directed communication originating from one client-visible Endpoint. */
-export type EndpointTraffic<Events extends object = {}> = CoreEndpointTraffic<Events, Endpoint | null, Server | null>;
+export type EndpointTraffic<Events extends object = {}, Fallback = unknown> = CoreEndpointTraffic<Events, Endpoint | null, Server | null, Fallback>;
 /** Directed communication originating from one client-visible Server. */
-export type ServerTraffic<Events extends object = {}> = CoreServerTraffic<Events, Endpoint | null, Server | null>;
+export type ServerTraffic<Events extends object = {}, Fallback = unknown> = CoreServerTraffic<Events, Endpoint | null, Server | null, Fallback>;
 /** Directed communication originating from one client-visible Client. */
-export type ClientTraffic<Events extends object = {}> = CoreClientTraffic<Events, Endpoint | null, Server | null>;
+export type ClientTraffic<Events extends object = {}, Fallback = unknown> = CoreClientTraffic<Events, Endpoint | null, Server | null, Fallback>;
 /** Common Endpoint handle visible inside a structurally isolated Client. */
-export type Endpoint<Events extends object = {}> = Omit<CoreEndpoint<Events>, "process" | "traffic"> & {
+export type Endpoint<Events extends object = {}, Fallback = unknown> = Omit<CoreEndpoint<Events, Fallback>, "process" | "traffic"> & {
     /** Directed communication originating from this Endpoint. */
-    readonly traffic: EndpointTraffic<Events>;
+    readonly traffic: EndpointTraffic<Events, Fallback>;
     /** Returns the Process that owns this Endpoint. */
     process(): Promise<Process>;
 };
 /** Server handle visible inside a structurally isolated Client. */
-export type Server<Events extends object = {}> = Omit<CoreServer<Events>, "process" | "traffic"> & Endpoint<Events> & {
+export type Server<Events extends object = {}, Fallback = unknown> = Omit<CoreServer<Events, Fallback>, "process" | "traffic"> & Endpoint<Events, Fallback> & {
     /** Directed communication originating from this Server. */
-    readonly traffic: ServerTraffic<Events>;
+    readonly traffic: ServerTraffic<Events, Fallback>;
     /** Returns the Process that owns this Server. */
     process(): Promise<Process>;
 };
 /** Client handle visible inside a structurally isolated Client. */
-export type Client<Events extends object = {}> = Omit<CoreClient<Events>, "process" | "traffic" | "window"> & Endpoint<Events> & {
+export type Client<Events extends object = {}, Fallback = unknown> = Omit<CoreClient<Events, Fallback>, "process" | "traffic" | "window"> & Endpoint<Events, Fallback> & {
     /** Directed communication originating from this Client. */
-    readonly traffic: ClientTraffic<Events>;
+    readonly traffic: ClientTraffic<Events, Fallback>;
     /** Presentation capability permanently owned by this Client handle. */
     readonly window: Window;
     /** Returns the Process that owns this Client. */
@@ -140,7 +140,7 @@ export declare class TrafficHandle extends Events {
         event: string;
         questionId: string;
         message: Readonly<{
-            to: Server<{}> | null;
+            to: Server<{}, unknown> | null;
             payload: unknown;
         }>;
     }>>;
@@ -152,7 +152,7 @@ export declare class ServerTrafficHandle extends TrafficHandle {
         event: string;
         questionId: string;
         message: Readonly<{
-            to: Endpoint<{}> | null;
+            to: Endpoint<{}, unknown> | null;
             outcome: Outcome<unknown>;
         }>;
     }>>;
@@ -173,7 +173,7 @@ export declare function process(record: ProcessRecord, endpoints?: {
     client?: Client;
 }): Process;
 export declare function endpoint(reference: EndpointReference | undefined): Endpoint;
-export declare function claimEndpoint(reference: string, kind: "server" | "client", endpoint: Endpoint): Endpoint<{}>;
+export declare function claimEndpoint(reference: string, kind: "server" | "client", endpoint: Endpoint): Endpoint<{}, unknown>;
 export declare function window(target: WindowTarget): Window;
 /** Resolves only endpoint identities intentionally visible to this Client. */
 export declare function visibleEndpoint(reference: EndpointReference | null | undefined): Endpoint | null;

package/dist/domain.js

@@ -222,7 +222,7 @@ class ServerHandle extends ServerBase {
     async start(launch = {}) { await wire.request(["start-endpoint", this.owner.address, "server", launch]); }
     async stop() { await wire.request(["stop-endpoint", this.owner.address, "server"]); }
     async isService() { return (await wire.request(["is-service", "server", this.owner.address]))[0]; }
-    async waitReady(timeout) { await wire.request(["wait-ready", this.owner.address], timeout); }
+    async waitReady(timeout) { await wire.request(["wait-ready", this.owner.address, "server"], timeout); }
     async ask(event, payload = undefined) {
         return this.askWithin(undefined, event, payload);
     }
@@ -231,7 +231,7 @@ class ServerHandle extends ServerBase {
     }
     async askWithin(timeout, event, payload) {
         const deadline = new Deadline(timeout);
-        await wire.requestWithin(["wait-ready", this.owner.address, true], deadline);
+        await wire.requestWithin(["wait-ready", this.owner.address, "server", true], deadline);
         const source = await wire.identity();
         const address = `client:${source.process}:${crypto.randomUUID()}`;
         const questionId = crypto.randomUUID();
@@ -267,6 +267,7 @@ class ClientHandle extends ClientBase {
     async start(launch = {}) { await wire.request(["start-endpoint", this.owner.address, "client", launch]); }
     async stop() { await wire.request(["stop-endpoint", this.owner.address, "client"]); }
     async isService() { return (await wire.request(["is-service", "client", this.owner.address]))[0]; }
+    async waitReady(timeout) { await wire.request(["wait-ready", this.owner.address, "client"], timeout); }
 }
 class WindowHandle extends Events {
     target;

package/dist/service.d.ts

@@ -1,8 +1,8 @@
 import { type ClientService, type ServerService, type Service, type ServiceKey } from "@phreshos/core";
-export declare function prepareService<EventsMap extends object = {}, Fallback = never>(key: ServiceKey & {
+export declare function prepareService<EventsMap extends object = {}, Fallback = unknown>(key: ServiceKey & {
     endpoint: "server";
 }): ServerService<EventsMap, Fallback>;
-export declare function prepareService<EventsMap extends object = {}, Fallback = never>(key: ServiceKey & {
+export declare function prepareService<EventsMap extends object = {}, Fallback = unknown>(key: ServiceKey & {
     endpoint: "client";
 }): ClientService<EventsMap, Fallback>;
 export declare function prepareService(key: ServiceKey): Service;

package/dist/service.js

@@ -20,6 +20,9 @@ class ServiceHandle {
         const answer = await wire.request(["service-exists", this.key]);
         return answer[0];
     }
+    async waitReady(timeout) {
+        await wire.request(["service-wait-ready", this.key, timeout], timeout);
+    }
 }
 class ServerHandler extends ServerServiceBase {
     key;
@@ -34,9 +37,7 @@ class ServerHandler extends ServerServiceBase {
     }
     publish(event, payload = undefined) { this.service.publish(event, payload); }
     exists() { return this.service.exists(); }
-    async waitReady(timeout) {
-        await wire.request(["service-wait-ready", this.key, timeout], timeout);
-    }
+    waitReady(timeout) { return this.service.waitReady(timeout); }
     async ask(event, payload = undefined) {
         return await this.askWithin(new Deadline(), event, payload);
     }
@@ -68,6 +69,7 @@ class ClientHandler extends ClientServiceBase {
     }
     publish(event, payload = undefined) { this.service.publish(event, payload); }
     exists() { return this.service.exists(); }
+    waitReady(timeout) { return this.service.waitReady(timeout); }
 }
 export function prepareService(key) {
     if (!isServiceKey(key))

package/dist/system.d.ts

@@ -4,7 +4,7 @@ type ServiceEndpoint = ServiceKey["endpoint"];
 type ServiceAddress<Endpoint extends ServiceEndpoint> = Omit<ServiceKey, "endpoint"> & Readonly<{
     endpoint: Endpoint;
 }>;
-type ServiceHandle<Endpoint extends ServiceEndpoint, Events extends object, Fallback = never> = Endpoint extends "server" ? ServerService<Events, Fallback> : ClientService<Events, Fallback>;
+type ServiceHandle<Endpoint extends ServiceEndpoint, Events extends object, Fallback = unknown> = Endpoint extends "server" ? ServerService<Events, Fallback> : ClientService<Events, Fallback>;
 /** Desktop capabilities structurally available to a Client endpoint. */
 export interface System {
     /** Complete unresolved Appearance read from the System authority. */
@@ -18,9 +18,9 @@ export interface System {
     /** Returns a precisely typed stable handle for either service endpoint. */
     service<Endpoint extends ServiceEndpoint>(key: ServiceAddress<Endpoint>): ServiceHandle<Endpoint, {}>;
     /** Returns a typed stable handle for one exact Server service identity. */
-    service<ServiceEvents extends object, Fallback = never>(key: ServiceAddress<"server">): ServerService<ServiceEvents, Fallback>;
+    service<ServiceEvents extends object, Fallback = unknown>(key: ServiceAddress<"server">): ServerService<ServiceEvents, Fallback>;
     /** Returns a typed stable handle for one exact Client service identity. */
-    service<ServiceEvents extends object, Fallback = never>(key: ServiceAddress<"client">): ClientService<ServiceEvents, Fallback>;
+    service<ServiceEvents extends object, Fallback = unknown>(key: ServiceAddress<"client">): ClientService<ServiceEvents, Fallback>;
 }
 /** Desktop capabilities available to this Client. */
 export declare const system: System;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/client",
-  "version": "0.1.30",
+  "version": "0.1.32",
   "description": "The SDK used by a Program's client endpoint.",
   "type": "module",
   "main": "dist/main.js",
@@ -39,7 +39,7 @@
   "packageManager": "bun@1.3.14",
   "scripts": {
     "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
-    "check": "tsc --noEmit",
+    "check": "tsc --noEmit && tsc -p tsconfig.test.json",
     "build": "node --run clean && tsc --noEmit false --outDir dist --rootDir source",
     "verify:completions": "node scripts/verify-completions.mjs",
     "verify:package": "node scripts/verify-package.mjs",
@@ -47,13 +47,13 @@
     "prepack": "node --run build"
   },
   "peerDependencies": {
-    "@phreshos/core": "^0.1.33"
+    "@phreshos/core": "^0.1.36"
   },
   "dependencies": {
     "@msgpack/msgpack": "^3.1.3"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.33",
+    "@phreshos/core": "^0.1.36",
     "typescript": "^6.0.3"
   }
 }