@phreshos/client 0.1.51 → 0.1.52

package/dist/client-memory.d.ts

@@ -0,0 +1,3 @@
+import type { ClientMemory, HandleAddress } from "@phreshos/core";
+/** The System, not this browser document, owns the values and ordering. */
+export default function clientMemory(target: HandleAddress | null): ClientMemory;

package/dist/client-memory.js

@@ -0,0 +1,57 @@
+import wire from "./wire.js";
+/** The System, not this browser document, owns the values and ordering. */
+export default function clientMemory(target) {
+    const snapshots = new Map();
+    const address = () => target ? Promise.resolve(target) : wire.identity().then(({ process, reference }) => ({ identity: process, reference }));
+    const ask = async (operation, key, value, expected) => {
+        const [result] = await wire.request(["client-memory", await address(), operation, key, value, expected]);
+        return result;
+    };
+    return {
+        async get(key) {
+            const snapshot = await ask("snapshot", key);
+            snapshots.set(key, snapshot);
+            return snapshot.value;
+        },
+        async set(key, value) { snapshots.set(key, await ask("set", key, value)); },
+        async update(key, updater) {
+            let snapshot = snapshots.get(key) ?? await ask("snapshot", key);
+            for (;;) {
+                const next = updater(snapshot.value);
+                const result = await ask("compareAndSet", key, next, snapshot);
+                snapshots.set(key, result.snapshot);
+                if (result.changed)
+                    return result.snapshot.value;
+                if (result.snapshot.run !== snapshot.run)
+                    throw new Error("The Client run changed during the update");
+                snapshot = result.snapshot;
+            }
+        },
+        async delete(key) { const deleted = await ask("delete", key); snapshots.delete(key); return deleted; },
+        async entries() { return await ask("entries"); },
+        subscribe(key, subscriber) {
+            let active = true;
+            let stop;
+            let latest;
+            void address().then(value => {
+                if (!active)
+                    return;
+                // Register first; an older snapshot response cannot overtake a newer event.
+                stop = wire.on("host-client-memory", key, (identity, snapshot) => {
+                    if (identity !== value.identity || !active)
+                        return;
+                    deliver(snapshot);
+                }, value.identity);
+                void ask("snapshot", key).then(snapshot => deliver(snapshot)).catch(() => undefined);
+            }).catch(() => undefined);
+            const deliver = (snapshot) => {
+                if (!active || (latest && (latest.run !== snapshot.run || latest.revision > snapshot.revision)))
+                    return;
+                latest = snapshot;
+                snapshots.set(key, snapshot);
+                subscriber(snapshot.value);
+            };
+            return () => { active = false; stop?.(); };
+        }
+    };
+}

package/dist/context.js

@@ -2,6 +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 clientMemory from "./client-memory.js";
 import { contextPermissions } from "./permissions.js";
 class ContextServerHandle extends ServerEndpoint {
     owner;
@@ -68,6 +69,7 @@ class ContextClientHandle extends ClientEndpoint {
     traffic = new TrafficHandle(null, "client");
     lifecycle = endpointLifecycle(currentAddress, "client");
     window = windowHandle(currentAddress);
+    memory = clientMemory(null);
     constructor(owner) {
         super();
         this.owner = owner;
@@ -95,6 +97,7 @@ contextClient = new ContextClientHandle(owner);
 class ClientContext extends Events {
     server = contextServer;
     window = contextClient.window;
+    memory = contextClient.memory;
     presentation = presentation(currentAddress);
     permissions = contextPermissions();
     constructor() {

package/dist/domain.js

@@ -6,6 +6,7 @@ import { area, programLogs, sql, store } from "./storage.js";
 import startup from "./startup.js";
 import { programPermissions } from "./permissions.js";
 import wire from "./wire.js";
+import clientMemory from "./client-memory.js";
 const handles = new HandleRegistry();
 class ProgramHandle extends CoreProgram {
     subscribe;
@@ -79,10 +80,10 @@ class ProgramHandle extends CoreProgram {
         const answer = await wire.request(["program-processes", this.address]);
         return answer[0].map(record => process(record));
     }
-    async firstProcess() {
+    async oldestProcess() {
         return chronological(await this.processes())[0] ?? null;
     }
-    async lastProcess() {
+    async newestProcess() {
         return chronological(await this.processes()).at(-1) ?? null;
     }
     async findProcess(identityOrName) {
@@ -285,12 +286,14 @@ class ClientEndpointHandle extends CoreClientEndpoint {
     traffic;
     lifecycle;
     window;
+    memory;
     constructor(owner) {
         super();
         this.owner = owner;
         this.traffic = new TrafficHandle(owner.address, "client");
         this.lifecycle = endpointLifecycle(() => Promise.resolve(owner.address), "client");
         this.window = window(async () => owner.address);
+        this.memory = clientMemory(owner.address);
         const events = endpointEvents(owner.address, "client");
         this.subscribe = events.subscribe;
         this.wait = events.wait;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phreshos/client",
-  "version": "0.1.51",
+  "version": "0.1.52",
   "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.60"
+    "@phreshos/core": "^0.1.62"
   },
   "dependencies": {
     "@the-link/messagepack": "^0.1.0"
   },
   "devDependencies": {
-        "@phreshos/core": "^0.1.60",
+        "@phreshos/core": "^0.1.62",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }