@phreshos/node 0.1.14 → 0.1.15

package/dist/main.d.ts

@@ -1,5 +1,5 @@
 export { gatewayAddress } from "./address.js";
 export { ClientEndpoint, ClientService, Endpoint, Process, Program, ServerEndpoint, ServerService, System, type ProgramProcessRunEvent, type ProgramProcessRunOptions } from "./system.js";
-export { Service, clientPermissionCatalog, isPermissionName, type ClientLaunch, type Launch, type Permission, type PermissionChange, type PermissionDefinition, type PermissionDefinitions, type PermissionInput, type PermissionName, type PermissionValue, type PermissionValueDomain, type Permissions, type ProgramPermissions, type ProgramDefinition, type ServerLaunch, type ServiceKey, type ShellEvent, type ShellOptions, type ProgramStartup, type Storage, } from "@phreshos/core";
+export { Service, clientPermissionCatalog, isPermissionName, type ClientLaunch, type Launch, type Permission, type PermissionDefinition, type PermissionDefinitions, type PermissionInput, type PermissionName, type PermissionRequest, type PermissionValue, type PermissionValueDomain, type Permissions, type ProgramPermissions, type ProgramDefinition, type ServerLaunch, type ServiceKey, type ShellEvent, type ShellOptions, type ProgramStartup, type Storage, } from "@phreshos/core";
 export { resolveHome } from "./home.js";
 export { Project, type Manifest, type PackedProject, type ProjectMode, type ProjectOptions, type ProjectRunOptions } from "./project.js";

package/dist/program-resources.d.ts

@@ -1,13 +1,13 @@
 import { type ProgramPermissions, type ProgramSql, type ProgramStore } from "@phreshos/core";
 type Call = <Result = unknown>(event: string, ...values: unknown[]) => Promise<Result>;
-type ProgramAddress = Readonly<{
+type HandleAddress = Readonly<{
     identity: string;
     reference: string;
 }>;
 /** Program-owned key-value storage carried through the owner-local Gateway. */
-export declare function programStore(call: Call, handle: ProgramAddress): ProgramStore;
+export declare function programStore(call: Call, handle: HandleAddress): ProgramStore;
 /** Program-owned SQL capability carried through the owner-local Gateway. */
-export declare function programSql(call: Call, handle: ProgramAddress, database: "database" | "logs"): ProgramSql;
+export declare function programSql(call: Call, handle: HandleAddress, database: "database" | "logs"): ProgramSql;
 /** Program permission management carried through the owner-local Gateway. */
-export declare function programPermissions(call: Call, handle: ProgramAddress): ProgramPermissions;
+export declare function programPermissions(call: Call, handle: HandleAddress): ProgramPermissions;
 export {};

package/dist/program-resources.js

@@ -1,4 +1,4 @@
-import { parsePermission, parsePermissionChange, parsePermissions } from "@phreshos/core";
+import { parsePermission, parsePermissions } from "@phreshos/core";
 /** Program-owned key-value storage carried through the owner-local Gateway. */
 export function programStore(call, handle) {
     const operate = (storeOperation, key, value, ttl) => (call("/program/store", handle, storeOperation, key, value, ttl));
@@ -25,8 +25,9 @@ export function programPermissions(call, handle) {
     return {
         async get(name) { return parsePermission(name, await operate("get", name)); },
         async all() { return parsePermissions(await operate("all")); },
-        async set(name, permission) { return parsePermissionChange(name, await operate("set", name, permission)); },
-        async delete(name) { return parsePermissionChange(name, await operate("delete", name)); }
+        async allows(name, permission = true) { return await operate("allows", name, permission) === true; },
+        async set(name, permission) { await operate("set", name, permission); },
+        async delete(name) { await operate("delete", name); }
     };
 }
 function written(statement, rest) {

package/dist/representation.d.ts

@@ -21,14 +21,15 @@ export interface WindowState {
     layer: WindowLayer;
     location: string;
 }
-export interface ProcessState {
+export interface ProcessIdentityState {
     reference: string;
     identity: string;
     name: string | null;
     program: string;
-    parent: ProcessAddress | null;
     options: Record<string, string>;
     startedAt: Date;
+}
+export interface ProcessState extends ProcessIdentityState {
     server: {
         ready: boolean;
         service: boolean;
@@ -39,10 +40,6 @@ export interface ProcessState {
         window: WindowState;
     } | null;
 }
-export interface ProcessAddress {
-    reference: string;
-    identity: string;
-}
 export type Observation = Readonly<{
     scope: "endpoint";
     process: string;
@@ -97,4 +94,6 @@ export type ProgramAddress = Readonly<{
     identity: string;
     reference: string;
 }>;
+/** Read the immutable facts needed to retain one Process handle. */
+export declare function processIdentityState(value: unknown): ProcessIdentityState;
 export {};

package/dist/representation.js

@@ -270,26 +270,40 @@ function programState(value) {
     };
 }
 function processState(value) {
-    if (!record(value) || typeof value.reference !== "string" || typeof value.identity !== "string" || typeof value.program !== "string" || !record(value.options)) {
+    const identity = processIdentityState(value);
+    const source = value;
+    return {
+        ...identity,
+        server: record(source.server) ? { ready: source.server.ready === true, service: source.server.service === true } : null,
+        client: record(source.client) ? {
+            service: source.client.service === true,
+            sameOrigin: source.client.sameOrigin === true,
+            window: windowState(source.client.window)
+        } : null
+    };
+}
+/** Read the immutable facts needed to retain one Process handle. */
+export function processIdentityState(value) {
+    if (!record(value) || typeof value.reference !== "string" || typeof value.identity !== "string" || !record(value.options)) {
         throw new Error("The System returned an invalid Process");
     }
+    const program = typeof value.program === "string"
+        ? value.program
+        : record(value.program) && typeof value.program.identity === "string"
+            ? value.program.identity
+            : null;
     const startedAt = value.startedAt instanceof Date ? value.startedAt : new Date(String(value.startedAt));
+    if (program === null)
+        throw new Error("The System returned an invalid Process owner");
     if (Number.isNaN(startedAt.getTime()))
         throw new Error("The System returned an invalid Process start time");
     return {
         reference: value.reference,
         identity: value.identity,
         name: typeof value.name === "string" ? value.name : null,
-        program: value.program,
-        parent: address(value.parent),
+        program,
         options: value.options,
-        startedAt,
-        server: record(value.server) ? { ready: value.server.ready === true, service: value.server.service === true } : null,
-        client: record(value.client) ? {
-            service: value.client.service === true,
-            sameOrigin: value.client.sameOrigin === true,
-            window: windowState(value.client.window)
-        } : null
+        startedAt
     };
 }
 function windowState(value) {
@@ -306,11 +320,6 @@ function windowState(value) {
         location: value.location
     };
 }
-function address(value) {
-    if (!record(value) || typeof value.reference !== "string" || typeof value.identity !== "string")
-        return null;
-    return { reference: value.reference, identity: value.identity };
-}
 function windowMessage(event, process) {
     const window = process.client.window;
     if (event === "move")

package/dist/system.js

@@ -7,7 +7,7 @@ import { resolveHome } from "./home.js";
 import { filesystemStorage, nativeStorage } from "./storage.js";
 import { programPermissions, programSql, programStore } from "./program-resources.js";
 import { EndpointTrafficHandle, ServerTrafficHandle } from "./traffic.js";
-import SystemRepresentation, {} from "./representation.js";
+import SystemRepresentation, { processIdentityState } from "./representation.js";
 import { GatewayConnection, openConnection } from "./transport.js";
 import Uploads from "./uploads.js";
 import shell from "./shell.js";
@@ -384,13 +384,11 @@ class ProcessHandle extends ProcessBase {
     async parent() {
         if (!await this.exists())
             throw new Error(`Process "${this.identity}" no longer exists`);
-        const snapshot = processState(this.system, this);
-        if (snapshot.parent === null)
-            return null;
-        const parent = await this.system.process.find(snapshot.parent.identity);
-        if (!parent)
-            throw new Error("The parent Process no longer exists");
-        return parent;
+        const value = await representation(this.system).call("/process/parent", {
+            identity: this.identity,
+            reference: processReference(this)
+        });
+        return value === null ? null : processHandle(this.system, processIdentityState(value));
     }
     async option(name) { return processState(this.system, this).options[name]; }
     async exit() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/node",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "Node.js access to PhreshOS and Program projects.",
   "type": "module",
   "main": "dist/main.js",
@@ -36,7 +36,7 @@
     "prepack": "node --run build"
   },
   "dependencies": {
-    "@phreshos/core": "^0.1.39",
+    "@phreshos/core": "^0.1.40",
     "@the-link/ipc": "^0.2.1",
     "@the-link/messagepack": "^0.1.0",
     "adm-zip": "^0.6.0",