@phreshos/client 0.1.29 → 0.1.31

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 = never> = 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/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 = never> = 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 = never> = 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 = never> = 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 = never> = 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 = never> = 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 = never> = 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 = never> = 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<{}, never> | null;
             payload: unknown;
         }>;
     }>>;
@@ -152,7 +152,7 @@ export declare class ServerTrafficHandle extends TrafficHandle {
         event: string;
         questionId: string;
         message: Readonly<{
-            to: Endpoint<{}> | null;
+            to: Endpoint<{}, never> | 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<{}, never>;
 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/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 = {}>(key: ServiceKey & {
+export declare function prepareService<EventsMap extends object = {}, Fallback = never>(key: ServiceKey & {
     endpoint: "server";
-}): ServerService<EventsMap>;
-export declare function prepareService<EventsMap extends object = {}>(key: ServiceKey & {
+}): ServerService<EventsMap, Fallback>;
+export declare function prepareService<EventsMap extends object = {}, Fallback = never>(key: ServiceKey & {
     endpoint: "client";
-}): ClientService<EventsMap>;
+}): ClientService<EventsMap, Fallback>;
 export declare function prepareService(key: ServiceKey): Service;

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> = Endpoint extends "server" ? ServerService<Events> : ClientService<Events>;
+type ServiceHandle<Endpoint extends ServiceEndpoint, Events extends object, Fallback = never> = 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>(key: ServiceAddress<"server">): ServerService<ServiceEvents>;
+    service<ServiceEvents extends object, Fallback = never>(key: ServiceAddress<"server">): ServerService<ServiceEvents, Fallback>;
     /** Returns a typed stable handle for one exact Client service identity. */
-    service<ServiceEvents extends object>(key: ServiceAddress<"client">): ClientService<ServiceEvents>;
+    service<ServiceEvents extends object, Fallback = never>(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.29",
+  "version": "0.1.31",
   "description": "The SDK used by a Program's client endpoint.",
   "type": "module",
   "main": "dist/main.js",
@@ -47,13 +47,13 @@
     "prepack": "node --run build"
   },
   "peerDependencies": {
-    "@phreshos/core": "^0.1.31"
+    "@phreshos/core": "^0.1.35"
   },
   "dependencies": {
     "@msgpack/msgpack": "^3.1.3"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.31",
+    "@phreshos/core": "^0.1.35",
     "typescript": "^6.0.3"
   }
 }