@phreshos/client 0.1.47 → 0.1.49

package/dist/appearance.d.ts

@@ -1,4 +1,4 @@
-import { type Appearance, type AppearanceEvents, type WritableAppearance } from "@phreshos/core";
+import { type AppearanceEvents, type AppearanceUpdate, type WritableAppearance } from "@phreshos/core";
 import Events from "./events.js";
 /** Read-only System Appearance reached through the Desktop boundary. */
 export default class ClientAppearance extends Events<AppearanceEvents, never> implements WritableAppearance {
@@ -10,8 +10,9 @@ export default class ClientAppearance extends Events<AppearanceEvents, never> im
         shadow: import("@phreshos/core").ThemedValue<import("@phreshos/core").AppearanceShadow>;
         material: import("@phreshos/core").ThemedValue<import("@phreshos/core").AppearanceMaterial>;
         transaction: import("@phreshos/core").AppearanceTransaction;
+        taskbar: import("@phreshos/core").AppearanceTaskbar;
         signInWallpaper: import("@phreshos/core").ThemedValue<string | null>;
         desktopWallpaper: import("@phreshos/core").ThemedValue<string | null>;
     }>>;
-    update(appearance: Appearance): Promise<void>;
+    update(appearance: AppearanceUpdate): Promise<void>;
 }

package/dist/context.js

@@ -2,7 +2,7 @@ import Deadline from "./deadline.js";
 import { ClientEndpoint, ServerEndpoint, ServerTrafficHandle, TrafficHandle, endpointLifecycle, endpointEvents, process, program, visibleEndpoint, presentation, window as windowHandle, } from "./domain.js";
 import Events from "./events.js";
 import wire from "./wire.js";
-import { contextPermissions } from "./permissions.js";
+import { programPermissions } from "./permissions.js";
 class ContextServerHandle extends ServerEndpoint {
     owner;
     subscribe;
@@ -96,7 +96,7 @@ class ClientContext extends Events {
     server = contextServer;
     window = contextClient.window;
     presentation = presentation(currentAddress);
-    permissions = contextPermissions();
+    permissions = programPermissions();
     constructor() {
         super((event, listener, impossible) => wire.on("end-end", event, value => listener(contextMessage(value)), null, impossible), (listener, impossible) => wire.onAll("end-end", (event, value) => {
             if (typeof event === "string")

package/dist/domain.js

@@ -1,10 +1,9 @@
-import { ClientEndpoint as CoreClientEndpoint, Endpoint as CoreEndpoint, Process as CoreProcess, Program as CoreProgram, ServerEndpoint as CoreServerEndpoint, parseEndpointReference, parseProcessSnapshot, parseProgramSnapshot, } from "@phreshos/core";
+import { ClientEndpoint as CoreClientEndpoint, Endpoint as CoreEndpoint, Process as CoreProcess, Program as CoreProgram, ServerEndpoint as CoreServerEndpoint, parseEndpointReference, parseProcessSnapshot, parseProgramDefinition, parsePermissions, parseProgramSnapshot, } from "@phreshos/core";
 import Events, { stream } from "./events.js";
 import Deadline from "./deadline.js";
 import HandleRegistry from "./handle-registry.js";
 import { area, sql, store } from "./storage.js";
 import startup from "./startup.js";
-import launch from "./launch.js";
 import { programPermissions } from "./permissions.js";
 import wire from "./wire.js";
 const handles = new HandleRegistry();
@@ -20,7 +19,6 @@ class ProgramHandle extends CoreProgram {
     logs;
     database;
     startup;
-    launch;
     permissions;
     record;
     constructor(record) {
@@ -34,7 +32,6 @@ class ProgramHandle extends CoreProgram {
         this.logs = sql("logs", this.address);
         this.database = sql("database", this.address);
         this.startup = startup(this.address);
-        this.launch = launch(this.address);
         this.permissions = programPermissions(this.address);
         const events = scoped("program-host", record.reference, programEvent);
         this.subscribe = events.subscribe;
@@ -58,6 +55,16 @@ class ProgramHandle extends CoreProgram {
         const answer = await wire.request(["icon", this.address, size]);
         return new Blob([Uint8Array.from(answer[0])], { type: "image/png" });
     }
+    async definition() {
+        const answer = await wire.request(["program-definition", this.address]);
+        return parseProgramDefinition(answer[0]);
+    }
+    async pinned() {
+        const answer = await wire.request(["pinned", this.address, "get"]);
+        return answer[0];
+    }
+    async pin() { await wire.request(["pinned", this.address, "pin"]); }
+    async unpin() { await wire.request(["pinned", this.address, "unpin"]); }
     async agent() {
         if (!this.hasAgent)
             return null;
@@ -314,7 +321,7 @@ class WindowHandle extends Events {
     }
     async title() { return (await this.state()).title; }
     async header() { return (await this.state()).header; }
-    async frame() { return (await this.state()).frame; }
+    async surface() { return (await this.state()).surface; }
     async transaction() { return (await this.state()).transaction; }
     async position() { return (await this.state()).position; }
     async size() { return (await this.state()).size; }
@@ -329,7 +336,7 @@ class WindowHandle extends Events {
     async maximize(maximized = true) { await wire.request(["maximize", await this.target(), maximized]); }
     async setTitle(title) { await wire.request(["setTitle", await this.target(), title]); }
     async setHeader(header) { await wire.request(["setHeader", await this.target(), header]); }
-    async setFrame(frame) { await wire.request(["setFrame", await this.target(), frame]); }
+    async setSurface(surface) { await wire.request(["setSurface", await this.target(), surface]); }
     async setTransaction(transaction) { await wire.request(["setTransaction", await this.target(), transaction]); }
     async raise() { await wire.request(["raise", await this.target()]); }
 }
@@ -358,7 +365,7 @@ class WindowPresentationHandle extends Events {
     }
     async title() { return await this.read("title"); }
     async header() { return await this.read("header"); }
-    async frame() { return await this.read("frame"); }
+    async surface() { return await this.read("surface"); }
     async position() { return await this.read("position"); }
     async size() { return await this.read("size"); }
     async minimized() { return await this.read("minimized"); }
@@ -372,7 +379,7 @@ class WindowPresentationHandle extends Events {
     async maximize(maximized = true) { await this.change("windowPresentationMaximize", maximized); }
     async setTitle(title) { await this.change("windowPresentationTitle", title); }
     async setHeader(header) { await this.change("windowPresentationHeader", header); }
-    async setFrame(frame) { await this.change("windowPresentationFrame", frame); }
+    async setSurface(surface) { await this.change("windowPresentationSurface", surface); }
     async follow() { await this.change("windowPresentationFollow"); }
     async unfollow() { await this.change("windowPresentationUnfollow"); }
     async raise() { await this.change("windowPresentationRaise"); }
@@ -407,7 +414,7 @@ function deferredScoped(route, target, convert) {
     ];
 }
 function windowEvent(event) {
-    return event === "move" || event === "resize" || event === "minimize" || event === "maximize" || event === "changeTitle" || event === "changeHeader" || event === "changeFrame" || event === "changeTransaction" || event === "front";
+    return event === "move" || event === "resize" || event === "minimize" || event === "maximize" || event === "changeTitle" || event === "changeHeader" || event === "changeSurface" || event === "changeTransaction" || event === "front";
 }
 function deferred(target, register, impossible) {
     let active = true;
@@ -484,6 +491,13 @@ function programEvent(event, values) {
         return { process: process(values[0]), ...exit(values[1], values[2]) };
     if (event === "uninstall")
         return { purge: values[0] === true };
+    if (event === "pinned")
+        return values[0] === true;
+    if (event === "permissions") {
+        const record = values[0];
+        program(record);
+        return parsePermissions(record.permissions);
+    }
     return undefined;
 }
 function processEvent(event, values) {

package/dist/permissions.d.ts

@@ -1,7 +1,5 @@
-import type { ContextPermissions, ProgramPermissions } from "@phreshos/core";
+import type { ProgramPermissions } from "@phreshos/core";
 import type { HandleAddress } from "./domain.js";
 export declare const defaultPermissionTimeout = 120000;
 /** Bind authoritative permission state to one exact Program handle. */
-export declare function programPermissions(program: HandleAddress): ProgramPermissions;
-/** Permission state and owner requests belonging to the current Client Endpoint. */
-export declare function contextPermissions(): ContextPermissions;
+export declare function programPermissions(program?: HandleAddress): ProgramPermissions;

package/dist/permissions.js

@@ -4,30 +4,19 @@ export const defaultPermissionTimeout = 120_000;
 /** Bind authoritative permission state to one exact Program handle. */
 export function programPermissions(program) {
     const operate = (operation, name, permission) => (wire.request(["program-permissions", program, operation, name, permission]));
-    return {
-        async get(name) { return parsePermission(name, (await operate("get", name))[0]); },
-        async all() { return parsePermissions((await operate("all"))[0]); },
-        async allows(name, permission = true) { return (await operate("allows", name, permission))[0] === true; },
-        async set(name, permission) { await operate("set", name, permission); },
-        async delete(name) { await operate("delete", name); }
-    };
-}
-/** Permission state and owner requests belonging to the current Client Endpoint. */
-export function contextPermissions() {
     const timed = (timeout) => ({
         async request(name, permission = true) {
             const identity = crypto.randomUUID();
-            const result = await wire.requestOrNull(["context-permission-request", identity, name, permission], timeout);
+            const result = await wire.requestOrNull(["program-permissions", program, "request", identity, name, permission], timeout);
             return result === null ? null : parsePermission(name, result[0]);
         }
     });
     return {
-        async get(name) {
-            return parsePermission(name, (await wire.request(["context-permission-get", name]))[0]);
-        },
-        async allows(name, permission = true) {
-            return (await wire.request(["context-permission-allows", name, permission]))[0] === true;
-        },
+        async get(name) { return parsePermission(name, (await operate("get", name))[0]); },
+        async all() { return parsePermissions((await operate("all"))[0]); },
+        async allows(name, permission = true) { return (await operate("allows", name, permission))[0] === true; },
+        async allow(name, permission = true) { await operate("allow", name, permission); },
+        async deny(name) { await operate("deny", name); },
         request: timed(defaultPermissionTimeout).request,
         timeout(milliseconds) {
             if (!Number.isFinite(milliseconds) || milliseconds < 0)

package/dist/service.js

@@ -22,11 +22,14 @@ class ServiceHandle {
     async waitReady(timeout) {
         await wire.request(["service-wait-ready", this.serviceAddress, timeout], timeout);
     }
-    async programMetadata(options = {}) {
-        const iconSize = options.icon ?? "medium";
-        const [value] = await wire.request(["service-program-metadata", this.serviceAddress, iconSize]);
+    async programMetadata() {
+        const [value] = await wire.request(["service-program-metadata", this.serviceAddress]);
         return parseServiceProgramMetadata(value);
     }
+    async programIcon(size = "medium") {
+        const [value] = await wire.request(["service-program-icon", this.serviceAddress, size]);
+        return parseServiceProgramIcon(value);
+    }
 }
 class ServerHandler extends CoreServerService {
     serviceAddress;
@@ -48,7 +51,8 @@ class ServerHandler extends CoreServerService {
     publish = (event, payload = undefined) => { this.service.publish(event, payload); };
     address() { return this.serviceAddress; }
     available() { return this.service.available(); }
-    programMetadata(options) { return this.service.programMetadata(options); }
+    programMetadata() { return this.service.programMetadata(); }
+    programIcon(size) { return this.service.programIcon(size); }
     waitReady(timeout) { return this.service.waitReady(timeout); }
     async ask(event, payload = undefined) {
         return await this.askWithin(new Deadline(), event, payload);
@@ -90,7 +94,8 @@ class ClientHandler extends CoreClientService {
     publish = (event, payload = undefined) => { this.service.publish(event, payload); };
     address() { return this.serviceAddress; }
     available() { return this.service.available(); }
-    programMetadata(options) { return this.service.programMetadata(options); }
+    programMetadata() { return this.service.programMetadata(); }
+    programIcon(size) { return this.service.programIcon(size); }
     waitReady(timeout) { return this.service.waitReady(timeout); }
 }
 export function prepareService(address) {
@@ -117,13 +122,14 @@ function parseServiceProgramMetadata(value) {
     if (!value || typeof value !== "object")
         throw new Error("The System returned invalid Service Program metadata");
     const metadata = value;
-    if (typeof metadata.name !== "string" || typeof metadata.version !== "string"
-        || !Array.isArray(metadata.icon) || metadata.icon.some(byte => typeof byte !== "number")) {
+    if (typeof metadata.name !== "string" || typeof metadata.version !== "string") {
         throw new Error("The System returned invalid Service Program metadata");
     }
-    return Object.freeze({
-        name: metadata.name,
-        version: metadata.version,
-        icon: new Blob([Uint8Array.from(metadata.icon)], { type: "image/png" })
-    });
+    return Object.freeze({ name: metadata.name, version: metadata.version });
+}
+function parseServiceProgramIcon(value) {
+    if (!Array.isArray(value) || value.some(byte => typeof byte !== "number")) {
+        throw new Error("The System returned an invalid Service Program icon");
+    }
+    return new Blob([Uint8Array.from(value)], { type: "image/png" });
 }

package/dist/system.js

@@ -1,4 +1,4 @@
-import { parseShellEvent, parseSessionEndSnapshot, execute as executeRequest } from "@phreshos/core";
+import { parseShellEvent, parseAuthenticationRequirements, parseAuthenticationState, parsePermissions, parseSessionEndSnapshot, execute as executeRequest } from "@phreshos/core";
 import ClientAppearance from "./appearance.js";
 import wire from "./wire.js";
 import { prepareService } from "./service.js";
@@ -13,8 +13,7 @@ class ClientSystem {
     appearance = new ClientAppearance();
     program = new SystemProgramHandle();
     process = new SystemProcessHandle();
-    connection = new SystemConnectionHandle();
-    session = new SystemSessionHandle();
+    authentication = new SystemAuthenticationHandle();
     service = new SystemServiceHandle();
     uploads = uploads;
     network = network;
@@ -84,37 +83,52 @@ class SystemProcessHandle extends Events {
         return answer[0] ? process(answer[0]) : null;
     }
 }
-class SystemConnectionHandle extends Events {
+class SystemAuthenticationHandle 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"]);
+        super((event, listener, impossible) => {
+            const [route, sourceEvent] = authenticationEventRoute(event);
+            return wire.on(route, sourceEvent, (...values) => listener(systemAuthenticationEvent(route, sourceEvent, values)), null, impossible);
+        }, (observer, impossible) => {
+            const stops = ["host-connection", "host-session"].map(route => wire.onAll(route, (event, ...values) => {
+                if (typeof event !== "string")
+                    return;
+                const name = authenticationEventName(route, event);
+                if (name)
+                    observer(name, systemAuthenticationEvent(route, event, values));
+            }, null, impossible));
+            return () => stops.forEach(stop => stop());
+        });
+    }
+    async state() {
+        const [value] = await wire.request(["host-authentication-state"]);
+        return parseAuthenticationState(value);
+    }
+    async requirements() {
+        const [value] = await wire.request(["host-authentication-requirements"]);
+        return parseAuthenticationRequirements(value);
+    }
+    async connections() {
+        const [snapshots] = await wire.request(["host-authentication-connections"]);
         return snapshots.map(connection);
     }
-    async find(identity) {
-        const [snapshot] = await wire.request(["host-connection-find", identity]);
+    async connection(identity) {
+        const [snapshot] = await wire.request(["host-authentication-connection", 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"]);
+    async sessions() {
+        const [snapshots] = await wire.request(["host-authentication-sessions"]);
         return snapshots.map(session);
     }
-    async find(identity) {
-        const [snapshot] = await wire.request(["host-session-find", identity]);
+    async session(identity) {
+        const [snapshot] = await wire.request(["host-authentication-session", identity]);
         return snapshot === null ? null : session(snapshot);
     }
+    async setCredentials(credentials) {
+        await wire.request(["host-authentication-set-credentials", credentials]);
+    }
+    async signOutAllSessions() {
+        await wire.request(["host-authentication-sign-out-all-sessions"]);
+    }
 }
 function systemProcessEvent(event, values) {
     if (event === "create")
@@ -128,12 +142,39 @@ function systemProgramEvent(event, values) {
         return program(values[1]);
     if (event === "uninstall")
         return { program: program(values[1]), purge: values[2] === true };
+    if (event === "pinned")
+        return { program: program(values[1]), pinned: values[2] === true };
+    if (event === "permissions") {
+        const handle = program(values[1]);
+        return { program: handle, permissions: parsePermissions(values[1].permissions) };
+    }
     return values[0];
 }
-function systemConnectionEvent(_event, values) {
-    return connection(values[1]);
+function authenticationEventRoute(event) {
+    if (event === "connectionCreate")
+        return ["host-connection", "create"];
+    if (event === "connectionDisconnect")
+        return ["host-connection", "disconnect"];
+    if (event === "sessionCreate")
+        return ["host-session", "create"];
+    if (event === "sessionEnd")
+        return ["host-session", "end"];
+    throw new Error(`The Authentication domain does not expose a ${event} event`);
+}
+function authenticationEventName(route, event) {
+    if (route === "host-connection" && event === "create")
+        return "connectionCreate";
+    if (route === "host-connection" && event === "disconnect")
+        return "connectionDisconnect";
+    if (route === "host-session" && event === "create")
+        return "sessionCreate";
+    if (route === "host-session" && event === "end")
+        return "sessionEnd";
+    return null;
 }
-function systemSessionEvent(event, values) {
+function systemAuthenticationEvent(route, event, values) {
+    if (route === "host-connection")
+        return connection(values[1]);
     const handle = session(values[1]);
     return event === "end" ? { session: handle, reason: parseSessionEndSnapshot({ ...values[1], reason: values[2] }).reason } : handle;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/client",
-  "version": "0.1.47",
+    "version": "0.1.49",
   "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.55"
+        "@phreshos/core": "^0.1.58"
   },
   "dependencies": {
     "@the-link/messagepack": "^0.1.0"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.55",
+        "@phreshos/core": "^0.1.58",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }

package/dist/launch.d.ts

@@ -1,4 +0,0 @@
-import { type ProgramLaunch } from "@phreshos/core";
-import type { HandleAddress } from "./domain.js";
-/** Bind saved launch operations to one Program handle. */
-export default function launch(program: HandleAddress): ProgramLaunch;

package/dist/launch.js

@@ -1,14 +0,0 @@
-import { parseLaunch } from "@phreshos/core";
-import wire from "./wire.js";
-/** Bind saved launch operations to one Program handle. */
-export default function launch(program) {
-    return {
-        async get() {
-            const [value] = await wire.request(["launch", program, "get"]);
-            return value === null ? null : parseLaunch(value);
-        },
-        async set(value) {
-            await wire.request(["launch", program, "set", parseLaunch(value)]);
-        }
-    };
-}