@ultimabase/realtime 0.1.2 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ultimabase/realtime
 
+## 0.2.0
+
+### Minor Changes
+
+- c0c5a21: `viewer.onClose(listener)` runs once a viewer closes, whatever closes it: its caller ended, the application stopped or `close()` was called. A plugin's own socket closes there.
+
+### Patch Changes
+
+- Updated dependencies [2c3bf4e]
+- Updated dependencies [fd1263e]
+  - ultimabase@0.2.0
+
 ## 0.1.2
 
 ### Patch Changes

package/dist/computed.d.ts

@@ -1,8 +1,12 @@
-import type { Caller } from 'ultimabase';
+import type { Caller, ExposedFunction } from 'ultimabase';
 import type { Recorded } from 'ultimabase/internal';
 import type { Batch } from './changes.ts';
 import type { LiveMessage } from './messages.ts';
 import type { Loader } from './reads.ts';
+/** A function's name, with its plugin's for a plugin's (D-113). */
+export declare const ownerOf: (fn: ExposedFunction) => string;
+/** How long a live function's wake waits for quiet, in milliseconds. */
+export declare const debounce = 50;
 export type ComputedOptions = {
     /** The function's result for `caller`, shaped as its transport sends it. */
     readonly compute: (caller: Caller) => Promise<unknown>;

package/dist/computed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"computed.d.ts","sourceRoot":"","sources":["../src/computed.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAMxC,MAAM,MAAM,eAAe,GAAG;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACtD,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;IAC7C,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;CAC3B,CAAA;AAED,qBAAa,QAAQ;;IAGpB,8BAA8B;IAC9B,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAK;IAC/B,iEAAiE;IACjE,OAAO,EAAE,IAAI,GAAG,SAAS,CAAA;IASzB,YAAY,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAGnD;IAED,2EAA2E;IACrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;IAED,gEAAgE;IAC1D,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxE;IAED,+DAA+D;IACzD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1C;IAED,mEAAmE;IACnE,MAAM,IAAI,IAAI,CAKb;IAED,KAAK,IAAI,IAAI,CAIZ;CA8DD"}
+{"version":3,"file":"computed.d.ts","sourceRoot":"","sources":["../src/computed.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAGxC,mEAAmE;AACnE,eAAO,MAAM,OAAO,OAAQ,eAAe,KAAG,MACgB,CAAA;AAE9D,wEAAwE;AACxE,eAAO,MAAM,QAAQ,KAAK,CAAA;AAK1B,MAAM,MAAM,eAAe,GAAG;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACtD,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;IAC7C,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;CAC3B,CAAA;AAED,qBAAa,QAAQ;;IAGpB,8BAA8B;IAC9B,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAK;IAC/B,iEAAiE;IACjE,OAAO,EAAE,IAAI,GAAG,SAAS,CAAA;IASzB,YAAY,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAGnD;IAED,2EAA2E;IACrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAG3B;IAED,gEAAgE;IAC1D,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxE;IAED,+DAA+D;IACzD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1C;IAED,mEAAmE;IACnE,MAAM,IAAI,IAAI,CAKb;IAED,KAAK,IAAI,IAAI,CAIZ;CA8DD"}

package/dist/computed.js

@@ -5,6 +5,10 @@
 import { isDeepStrictEqual } from 'node:util';
 import { recording } from 'ultimabase/internal';
 import { anyStale } from './stale.js';
+/** A function's name, with its plugin's for a plugin's (D-113). */
+export const ownerOf = (fn) => fn.plugin === undefined ? fn.name : `${fn.plugin}.${fn.name}`;
+/** How long a live function's wake waits for quiet, in milliseconds. */
+export const debounce = 50;
 /** The longest a run waits after the first wake, however many follow. */
 const longest = 1000;
 export class Computed {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAI9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACjE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,MAAM,eAAe,GAAG;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,qDAAqD;IACrD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,iFAAiF;IACjF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC3B,gEAAgE;IAChE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACtD,kDAAkD;IAClD,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IACxC,wFAAwF;IACxF,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAC/C;AAED,0CAA0C;AAC1C,MAAM,WAAW,QAAS,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACrD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;CACzB;AAsDD,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAA0B,CAAA;AAC/D,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,QAAQ,CAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAK9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACjE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,MAAM,eAAe,GAAG;IAC7B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,qDAAqD;IACrD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,iFAAiF;IACjF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC,yEAAyE;IACzE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC3B,gEAAgE;IAChE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACtD,kDAAkD;IAClD,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IACxC,wFAAwF;IACxF,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAC/C;AAED,0CAA0C;AAC1C,MAAM,WAAW,QAAS,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5C,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACrD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;IACxB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAA;CACzB;AAsDD,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAA0B,CAAA;AAC/D,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,QAAQ,CAA6B,CAAA"}

package/dist/index.js

@@ -1,7 +1,7 @@
 import { definePlugin } from 'ultimabase';
 import manifest from '../package.json' with { type: 'json' };
+import { ownerOf } from './computed.js';
 import { Engine } from './engine.js';
-import { ownerOf } from './viewer.js';
 // Each running application's engine, by the context its plugin received.
 const engines = new WeakMap();
 const positive = (name, value) => {

package/dist/viewer.d.ts

@@ -25,8 +25,6 @@ export interface LiveHandle {
     close(this: void): void;
 }
 type Built<R> = Awaited<ReturnType<typeof recording<R>>>;
-/** A function's name, with its plugin's for a plugin's (D-113). */
-export declare const ownerOf: (fn: ExposedFunction) => string;
 export declare class Viewer {
     #private;
     /** `onDue` runs once the caller stops holding, to rebuild it. */
@@ -47,6 +45,8 @@ export declare class Viewer {
      */
     value(name: string, compute: (caller: Caller) => Promise<unknown>, send: (message: LiveMessage) => void): Promise<LiveHandle>;
     close(): void;
+    /** Runs `listener` once it closes, at once when it is closed (D-163). */
+    onClose(listener: () => void): void;
     /** Follows `batch`: rebuilds the caller first when a write may change it. */
     flush(batch: Batch, loader: Loader, missed: boolean): Promise<void>;
     /**

package/dist/viewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../src/viewer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../src/viewer.ts"],"names":[],"mappings":"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"}

package/dist/viewer.js

@@ -1,6 +1,6 @@
 import { livePlan, recording } from 'ultimabase/internal';
 import { checked, invalid } from './checked.js';
-import { Computed } from './computed.js';
+import { Computed, debounce, ownerOf } from './computed.js';
 import { Live } from './live.js';
 import { liveArgs, shapeOf } from './shape.js';
 import { anyStale } from './stale.js';
@@ -8,10 +8,6 @@ import { anyStale } from './stale.js';
 const soonest = 1000;
 /** The longest wait `setTimeout` keeps. */
 const latest = 2 ** 31 - 1;
-/** A function's name, with its plugin's for a plugin's (D-113). */
-export const ownerOf = (fn) => fn.plugin === undefined ? fn.name : `${fn.plugin}.${fn.name}`;
-/** How long a live function's wake waits for quiet, in milliseconds. */
-const debounce = 50;
 /** Who `caller` is, which a rebuilt caller must keep. */
 const whoOf = (caller) => {
     if (caller.kind !== 'user')
@@ -22,7 +18,8 @@ const whoOf = (caller) => {
 export class Viewer {
     #settings;
     #request;
-    #onClose;
+    /** What runs once it closes, the engine's first (D-163). */
+    #listeners = [];
     #onDue;
     #live = new Map();
     #computed = new Map();
@@ -38,7 +35,7 @@ export class Viewer {
         this.#caller = identified.result;
         this.#reads = identified.reads;
         this.#expires = identified.expires;
-        this.#onClose = hooks.onClose;
+        this.#listeners.push(hooks.onClose);
         this.#onDue = hooks.onDue;
         this.#reschedule();
     }
@@ -105,7 +102,24 @@ export class Viewer {
         for (const computed of this.#computed.keys())
             computed.close();
         this.#computed.clear();
-        this.#onClose();
+        this.#told();
+    }
+    /** Runs `listener` once it closes, at once when it is closed (D-163). */
+    onClose(listener) {
+        this.#listeners.push(listener);
+        if (this.#closed)
+            this.#told();
+    }
+    /** Runs each listener once; one that throws is logged, not the others. */
+    #told() {
+        for (const listener of this.#listeners.splice(0)) {
+            try {
+                listener();
+            }
+            catch (error) {
+                this.#settings.logger.error({ err: error }, 'A close listener failed.');
+            }
+        }
     }
     /** Follows `batch`: rebuilds the caller first when a write may change it. */
     async flush(batch, loader, missed) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimabase/realtime",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Realtime for UltimaBase: live lists and live rows that follow every write, under the read rules.",
   "type": "module",
   "license": "Apache-2.0",
@@ -31,14 +31,14 @@
     }
   },
   "peerDependencies": {
-    "ultimabase": "^0.1.2"
+    "ultimabase": "^0.2.0"
   },
   "devDependencies": {
-    "@ultimabase/acl": "0.1.2",
-    "@ultimabase/roles": "0.1.2",
-    "@ultimabase/soft-delete": "0.1.2",
-    "@ultimabase/testing": "0.1.2",
-    "ultimabase": "0.1.2",
+    "@ultimabase/acl": "0.2.0",
+    "@ultimabase/roles": "0.2.0",
+    "@ultimabase/soft-delete": "0.2.0",
+    "@ultimabase/testing": "0.2.0",
+    "ultimabase": "0.2.0",
     "vite": "8.3.4",
     "vitest": "5.0.5"
   }

package/src/computed.ts

@@ -3,7 +3,7 @@
 // result is sent whole; one equal to the last is not. A wake during a run
 // runs it once more after it, and an error closes it.
 import { isDeepStrictEqual } from 'node:util'
-import type { Caller } from 'ultimabase'
+import type { Caller, ExposedFunction } from 'ultimabase'
 import type { Recorded } from 'ultimabase/internal'
 import { recording } from 'ultimabase/internal'
 import type { Batch } from './changes.ts'
@@ -11,6 +11,13 @@ import type { LiveMessage } from './messages.ts'
 import type { Loader } from './reads.ts'
 import { anyStale } from './stale.ts'
 
+/** A function's name, with its plugin's for a plugin's (D-113). */
+export const ownerOf = (fn: ExposedFunction): string =>
+	fn.plugin === undefined ? fn.name : `${fn.plugin}.${fn.name}`
+
+/** How long a live function's wake waits for quiet, in milliseconds. */
+export const debounce = 50
+
 /** The longest a run waits after the first wake, however many follow. */
 const longest = 1000
 

package/src/index.ts

@@ -5,9 +5,9 @@
 import type { PluginOf, PluginTypes, UseOf } from 'ultimabase'
 import { definePlugin } from 'ultimabase'
 import manifest from '../package.json' with { type: 'json' }
+import { ownerOf } from './computed.ts'
 import { Engine } from './engine.ts'
 import type { Viewer } from './viewer.ts'
-import { ownerOf } from './viewer.ts'
 
 export type { LiveMessage, Removal, Upsert } from './messages.ts'
 export type { LiveHandle, Viewer } from './viewer.ts'

package/src/viewer.ts

@@ -9,7 +9,7 @@ import type { Recorded } from 'ultimabase/internal'
 import { livePlan, recording } from 'ultimabase/internal'
 import type { Batch } from './changes.ts'
 import { checked, invalid } from './checked.ts'
-import { Computed } from './computed.ts'
+import { Computed, debounce, ownerOf } from './computed.ts'
 import type { LiveMessage } from './messages.ts'
 import { Live } from './live.ts'
 import type { Loader } from './reads.ts'
@@ -53,13 +53,6 @@ const soonest = 1000
 /** The longest wait `setTimeout` keeps. */
 const latest = 2 ** 31 - 1
 
-/** A function's name, with its plugin's for a plugin's (D-113). */
-export const ownerOf = (fn: ExposedFunction): string =>
-	fn.plugin === undefined ? fn.name : `${fn.plugin}.${fn.name}`
-
-/** How long a live function's wake waits for quiet, in milliseconds. */
-const debounce = 50
-
 /** Who `caller` is, which a rebuilt caller must keep. */
 const whoOf = (caller: Caller): string => {
 	if (caller.kind !== 'user') return JSON.stringify(caller)
@@ -70,7 +63,8 @@ const whoOf = (caller: Caller): string => {
 export class Viewer {
 	readonly #settings: Settings
 	#request: Request
-	readonly #onClose: () => void
+	/** What runs once it closes, the engine's first (D-163). */
+	readonly #listeners: (() => void)[] = []
 	readonly #onDue: () => void
 	readonly #live = new Map<Live, Subscription>()
 	readonly #computed = new Map<Computed, (message: LiveMessage) => void>()
@@ -92,7 +86,7 @@ export class Viewer {
 		this.#caller = identified.result
 		this.#reads = identified.reads
 		this.#expires = identified.expires
-		this.#onClose = hooks.onClose
+		this.#listeners.push(hooks.onClose)
 		this.#onDue = hooks.onDue
 		this.#reschedule()
 	}
@@ -174,7 +168,24 @@ export class Viewer {
 		this.#live.clear()
 		for (const computed of this.#computed.keys()) computed.close()
 		this.#computed.clear()
-		this.#onClose()
+		this.#told()
+	}
+
+	/** Runs `listener` once it closes, at once when it is closed (D-163). */
+	onClose(listener: () => void): void {
+		this.#listeners.push(listener)
+		if (this.#closed) this.#told()
+	}
+
+	/** Runs each listener once; one that throws is logged, not the others. */
+	#told(): void {
+		for (const listener of this.#listeners.splice(0)) {
+			try {
+				listener()
+			} catch (error) {
+				this.#settings.logger.error({ err: error }, 'A close listener failed.')
+			}
+		}
 	}
 
 	/** Follows `batch`: rebuilds the caller first when a write may change it. */