@phreshos/client 0.1.47 → 0.1.48

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 {
@@ -13,5 +13,5 @@ export default class ClientAppearance extends Events<AppearanceEvents, never> im
         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, 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;
@@ -484,6 +491,8 @@ 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;
     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

@@ -128,6 +128,8 @@ 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 };
     return values[0];
 }
 function systemConnectionEvent(_event, values) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/client",
-  "version": "0.1.47",
+  "version": "0.1.48",
   "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.56"
   },
   "dependencies": {
     "@the-link/messagepack": "^0.1.0"
   },
   "devDependencies": {
-    "@phreshos/core": "^0.1.55",
+    "@phreshos/core": "^0.1.56",
     "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)]);
-        }
-    };
-}