@phreshos/client 0.1.43 → 0.1.45

package/dist/authentication.d.ts

@@ -0,0 +1,3 @@
+import { Connection as CoreConnection, Session as CoreSession } from "@phreshos/core";
+export declare function connection(value: unknown): CoreConnection;
+export declare function session(value: unknown): CoreSession;

package/dist/authentication.js

@@ -0,0 +1,78 @@
+import { Connection as CoreConnection, Session as CoreSession, parseConnectionSnapshot, parseSessionEndSnapshot, parseSessionSnapshot } from "@phreshos/core";
+import HandleRegistry from "./handle-registry.js";
+import { scoped } from "./domain.js";
+import wire from "./wire.js";
+const handles = new HandleRegistry();
+class ConnectionHandle extends CoreConnection {
+    subscribe;
+    wait;
+    events;
+    identity;
+    constructor(snapshot) {
+        super();
+        this.identity = snapshot.identity;
+        const events = scoped("connection-host", this.identity, connectionEvent);
+        this.subscribe = events.subscribe;
+        this.wait = events.wait;
+        this.events = events.events;
+    }
+    async connected() {
+        const [snapshot] = await wire.request(["host-connection-state", this.identity]);
+        return parseConnectionSnapshot(snapshot).connected;
+    }
+    async session() {
+        const [snapshot] = await wire.request(["host-connection-session", this.identity]);
+        return snapshot === null ? null : session(snapshot);
+    }
+    async signIn() {
+        const [snapshot] = await wire.request(["host-connection-sign-in", this.identity]);
+        return session(snapshot);
+    }
+}
+class SessionHandle extends CoreSession {
+    subscribe;
+    wait;
+    events;
+    identity;
+    constructor(snapshot) {
+        super();
+        this.identity = snapshot.identity;
+        const events = scoped("session-host", this.identity, (event, values) => sessionEvent(this.identity, event, values));
+        this.subscribe = events.subscribe;
+        this.wait = events.wait;
+        this.events = events.events;
+    }
+    async valid() {
+        const [snapshot] = await wire.request(["host-session-state", this.identity]);
+        return parseSessionSnapshot(snapshot).valid;
+    }
+    async connections() {
+        const [snapshots] = await wire.request(["host-session-connections", this.identity]);
+        return snapshots.map(connection);
+    }
+    async signOut() {
+        await wire.request(["host-session-sign-out", this.identity]);
+    }
+}
+export function connection(value) {
+    const snapshot = parseConnectionSnapshot(value);
+    return handles.obtain(`connection:${snapshot.identity}`, () => new ConnectionHandle(snapshot));
+}
+export function session(value) {
+    const snapshot = parseSessionSnapshot(value);
+    return handles.obtain(`session:${snapshot.identity}`, () => new SessionHandle(snapshot));
+}
+function connectionEvent(event, values) {
+    if (event === "sessionChange")
+        return values[0] === null ? null : session(values[0]);
+    if (event === "disconnect")
+        return undefined;
+    return values[0];
+}
+function sessionEvent(identity, event, values) {
+    if (event === "connectionAttach" || event === "connectionDetach")
+        return connection(values[0]);
+    if (event === "end")
+        return { reason: parseSessionEndSnapshot({ identity, valid: false, reason: values[0] }).reason };
+    return values[0];
+}

package/dist/desktop/desktop.js

@@ -1,9 +1,15 @@
+import { connection } from "../authentication.js";
+import wire from "../wire.js";
 import ClientPreferences from "./preferences.js";
 import ClientViewport from "./viewport.js";
 /** Desktop access bound to the current Client Endpoint's Process boundary. */
 class ClientDesktop {
     viewport = new ClientViewport();
     preferences = new ClientPreferences();
+    async connection() {
+        const [snapshot] = await wire.request(["desktop-connection"]);
+        return connection(snapshot);
+    }
 }
 /** The Desktop environment containing this Client Endpoint. */
 export const desktop = new ClientDesktop();

package/dist/domain.d.ts

@@ -1,4 +1,4 @@
-import { ClientEndpoint as CoreClientEndpoint, Endpoint as CoreEndpoint, Process as CoreProcess, Program as CoreProgram, ServerEndpoint as CoreServerEndpoint, type AnswerCapture as CoreAnswerCapture, type AnswerMessage as CoreAnswerMessage, type AnswerOutcome, type AnswerSubscriber as CoreAnswerSubscriber, type AskCapture as CoreAskCapture, type AskMessage as CoreAskMessage, type AskSubscriber as CoreAskSubscriber, type Cleanup, type ClientTraffic as CoreClientTraffic, type ClientDeclaration, type EndpointReference as CoreEndpointReference, type EndpointSnapshot, type HandleAddress, type ProcessSnapshot, type ProgramSnapshot, type EndpointTraffic as CoreEndpointTraffic, type EndpointLifecycleEvents, type EndpointDeclaration, type Exit, type EventOptions, type LocalWindow, type ProgramProcess as CoreProgramProcess, type ProgramProcessRunEvent as CoreProgramProcessRunEvent, type ProgramProcessRunOptions as CoreProgramProcessRunOptions, type ServerTraffic as CoreServerTraffic, type TrafficMessage as CoreTrafficMessage, type TrafficCapture as CoreTrafficCapture, type TrafficEvents as CoreTrafficEvents, type Window as CoreWindow, type WindowState } from "@phreshos/core";
+import { ClientEndpoint as CoreClientEndpoint, Endpoint as CoreEndpoint, Process as CoreProcess, Program as CoreProgram, ServerEndpoint as CoreServerEndpoint, type AnswerCapture as CoreAnswerCapture, type AnswerMessage as CoreAnswerMessage, type AnswerOutcome, type AnswerSubscriber as CoreAnswerSubscriber, type AskCapture as CoreAskCapture, type AskMessage as CoreAskMessage, type AskSubscriber as CoreAskSubscriber, type Cleanup, type ClientTraffic as CoreClientTraffic, type ClientDeclaration, type EndpointReference as CoreEndpointReference, type EndpointSnapshot, type HandleAddress, type ProcessSnapshot, type ProgramSnapshot, type EndpointTraffic as CoreEndpointTraffic, type EndpointLifecycleEvents, type EndpointDeclaration, type Exit, type EventOptions, type LocalWindow, type ProgramProcessRunEvent as CoreProgramProcessRunEvent, type ProgramProcessRunOptions as CoreProgramProcessRunOptions, type ServerTraffic as CoreServerTraffic, type TrafficMessage as CoreTrafficMessage, type TrafficCapture as CoreTrafficCapture, type TrafficEvents as CoreTrafficEvents, type Window as CoreWindow, type WindowState } from "@phreshos/core";
 import Events from "./events.js";
 export type { HandleAddress };
 export type EndpointDeclarationRecord = EndpointDeclaration;
@@ -9,7 +9,6 @@ export type EndpointRecord = EndpointSnapshot;
 export type EndpointReference = CoreEndpointReference;
 export type WindowRecord = WindowState;
 export type Program = CoreProgram;
-export type ProgramProcess = CoreProgramProcess;
 export type ProgramProcessRunEvent = CoreProgramProcessRunEvent;
 export type ProgramProcessRunOptions = CoreProgramProcessRunOptions;
 export type Process = CoreProcess;

package/dist/domain.js

@@ -21,7 +21,6 @@ class ProgramHandle extends CoreProgram {
     database;
     startup;
     launch;
-    process;
     permissions;
     record;
     constructor(record) {
@@ -37,7 +36,6 @@ class ProgramHandle extends CoreProgram {
         this.startup = startup(this.address);
         this.launch = launch(this.address);
         this.permissions = programPermissions(this.address);
-        this.process = new ProgramProcessHandle(this.address, record.reference);
         const events = scoped("program-host", record.reference, programEvent);
         this.subscribe = events.subscribe;
         this.wait = events.wait;
@@ -70,6 +68,37 @@ class ProgramHandle extends CoreProgram {
         const answer = await wire.request(["installed", this.address]);
         return answer[0];
     }
+    async processes() {
+        const answer = await wire.request(["program-processes", this.address]);
+        return answer[0].map(record => process(record));
+    }
+    async firstProcess() {
+        return chronological(await this.processes())[0] ?? null;
+    }
+    async lastProcess() {
+        return chronological(await this.processes()).at(-1) ?? null;
+    }
+    async findProcess(identityOrName) {
+        const answer = await wire.request(["program-find-process", this.address, identityOrName]);
+        return answer[0] ? process(answer[0]) : null;
+    }
+    async createProcess(launch = {}) {
+        const answer = await wire.request(["program-create-process", this.address, launch]);
+        return process(answer[0]);
+    }
+    async findOrCreateProcess(launch) {
+        const answer = await wire.request(["program-find-or-create-process", this.address, launch]);
+        return process(answer[0]);
+    }
+    async exitProcesses() {
+        const answer = await wire.request(["program-exit-processes", this.address]);
+        return answer[0];
+    }
+    async *runProcess(launch = {}, options = {}) {
+        for await (const value of wire.stream(["run", this.address, launch], undefined, options.signal)) {
+            yield processRunEvent(value);
+        }
+    }
     async *install(options = {}) {
         for await (const value of wire.stream(["install", this.address, options])) {
             yield programCommandChunk(value);
@@ -89,50 +118,6 @@ function programCommandChunk(value) {
     }
     return Object.freeze({ stream: chunk.stream, text: chunk.text });
 }
-class ProgramProcessHandle {
-    address;
-    subscribe;
-    wait;
-    events;
-    constructor(address, reference) {
-        this.address = address;
-        const events = scoped("program-process", reference, programProcessEvent);
-        this.subscribe = events.subscribe;
-        this.wait = events.wait;
-        this.events = events.events;
-    }
-    async list() {
-        const answer = await wire.request(["program-process-list", this.address]);
-        return answer[0].map(record => process(record));
-    }
-    async first() {
-        return chronological(await this.list())[0] ?? null;
-    }
-    async last() {
-        return chronological(await this.list()).at(-1) ?? null;
-    }
-    async find(identityOrName) {
-        const answer = await wire.request(["program-process-find", this.address, identityOrName]);
-        return answer[0] ? process(answer[0]) : null;
-    }
-    async create(launch = {}) {
-        const answer = await wire.request(["program-process-create", this.address, launch]);
-        return process(answer[0]);
-    }
-    async *run(launch = {}, options = {}) {
-        for await (const value of wire.stream(["run", this.address, launch], undefined, options.signal)) {
-            yield processRunEvent(value);
-        }
-    }
-    async findOrCreate(launch) {
-        const answer = await wire.request(["program-process-find-or-create", this.address, launch]);
-        return process(answer[0]);
-    }
-    async exitAll() {
-        const answer = await wire.request(["program-process-exit-all", this.address]);
-        return answer[0];
-    }
-}
 function processRunEvent(value) {
     const event = value;
     if (event?.event === "started" && event.process) {
@@ -462,16 +447,13 @@ function unscoped(subject, values) {
         return values;
     return values[0] === subject ? values.slice(1) : null;
 }
-function programProcessEvent(event, values) {
-    if (event === "create")
+function programEvent(event, values) {
+    if (event === "processCreate")
         return process(values[0]);
-    if (event === "exit")
+    if (event === "processExit")
         return { process: process(values[0]), ...exit(values[1], values[2]) };
-    return undefined;
-}
-function programEvent(event, values) {
     if (event === "uninstall")
-        return values[0] === true;
+        return { purge: values[0] === true };
     return undefined;
 }
 function processEvent(event, values) {

package/dist/system.js

@@ -1,4 +1,4 @@
-import { parseShellEvent } from "@phreshos/core";
+import { parseShellEvent, parseSessionEndSnapshot } from "@phreshos/core";
 import ClientAppearance from "./appearance.js";
 import wire from "./wire.js";
 import { prepareService } from "./service.js";
@@ -7,11 +7,14 @@ import Events from "./events.js";
 import { exit, process, program } from "./domain.js";
 import { systemStorage } from "./storage.js";
 import network from "./network.js";
+import { connection, session } from "./authentication.js";
 class ClientSystem {
     storage = systemStorage();
     appearance = new ClientAppearance();
     program = new SystemProgramHandle();
     process = new SystemProcessHandle();
+    connection = new SystemConnectionHandle();
+    session = new SystemSessionHandle();
     uploads = uploads;
     network = network;
     service(key) { return prepareService(key); }
@@ -61,6 +64,38 @@ class SystemProcessHandle extends Events {
         return answer[0] ? process(answer[0]) : null;
     }
 }
+class SystemConnectionHandle extends Events {
+    constructor() {
+        super((event, listener, impossible) => wire.on("host-connection", event, (...values) => listener(systemConnectionEvent(event, values)), null, impossible), observer => wire.onAll("host-connection", (event, ...values) => {
+            if (typeof event === "string")
+                observer(event, systemConnectionEvent(event, values));
+        }));
+    }
+    async list() {
+        const [snapshots] = await wire.request(["host-connection-list"]);
+        return snapshots.map(connection);
+    }
+    async find(identity) {
+        const [snapshot] = await wire.request(["host-connection-find", identity]);
+        return snapshot === null ? null : connection(snapshot);
+    }
+}
+class SystemSessionHandle extends Events {
+    constructor() {
+        super((event, listener, impossible) => wire.on("host-session", event, (...values) => listener(systemSessionEvent(event, values)), null, impossible), observer => wire.onAll("host-session", (event, ...values) => {
+            if (typeof event === "string")
+                observer(event, systemSessionEvent(event, values));
+        }));
+    }
+    async list() {
+        const [snapshots] = await wire.request(["host-session-list"]);
+        return snapshots.map(session);
+    }
+    async find(identity) {
+        const [snapshot] = await wire.request(["host-session-find", identity]);
+        return snapshot === null ? null : session(snapshot);
+    }
+}
 function systemProcessEvent(event, values) {
     if (event === "create")
         return process(values[1]);
@@ -75,5 +110,12 @@ function systemProgramEvent(event, values) {
         return { program: program(values[1]), purge: values[2] === true };
     return values[0];
 }
+function systemConnectionEvent(_event, values) {
+    return connection(values[1]);
+}
+function systemSessionEvent(event, values) {
+    const handle = session(values[1]);
+    return event === "end" ? { session: handle, reason: parseSessionEndSnapshot({ ...values[1], reason: values[2] }).reason } : handle;
+}
 /** The global System represented through this Client runtime. */
 export const system = new ClientSystem();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/client",
-  "version": "0.1.43",
+  "version": "0.1.45",
   "description": "The SDK used by a Program's client endpoint.",
   "type": "module",
   "main": "dist/main.js",
@@ -46,13 +46,13 @@
     "test": "vitest run --project default"
   },
   "peerDependencies": {
-    "@phreshos/core": "^0.1.49"
+    "@phreshos/core": "^0.1.52"
   },
   "dependencies": {
     "@the-link/messagepack": "^0.1.0"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.49",
+    "@phreshos/core": "^0.1.52",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }