@observertc/observer-js 1.0.0-beta.6 → 1.0.0-beta.8

package/README.md

@@ -297,7 +297,8 @@ These return `undefined` (and warn) when the parent is closed; `createObservedCa
 "Update" means *recompute aggregated metrics and emit the `*-updated` event* at that level.
 Both the observer and each call have a configurable trigger. Updates are **event-driven** — there
 is no built-in timer. An app that wants a fixed cadence can call `observer.update()` /
-`call.update()` from its own `setInterval`.
+`call.update()` from its own `setInterval`. With `'none'`, **nothing auto-updates** — the level
+updates only when the application calls the public `update()` itself.
 
 **Observer-level** (`ObserverConfig.updatePolicy`, default `update-when-all-call-updated`):
 
@@ -305,6 +306,7 @@ is no built-in timer. An app that wants a fixed cadence can call `observer.updat
 |--------|-------------------------------------|
 | `update-on-any-call-updated` | any call updates |
 | `update-when-all-call-updated` | every call has updated since the last observer update |
+| `none` | never automatically — only when the app calls `observer.update()` |
 
 **Call-level** (`ObservedCallSettings.updatePolicy`, defaulted from
 `ObserverConfig.defaultCallUpdatePolicy`):
@@ -313,6 +315,7 @@ is no built-in timer. An app that wants a fixed cadence can call `observer.updat
 |--------|--------------------------------|
 | `update-on-any-client-updated` | any client in the call updates |
 | `update-when-all-client-updated` | every client has updated since the last call update |
+| `none` | never automatically — only when the app calls `call.update()` |
 
 ---
 
@@ -437,7 +440,7 @@ listen to them, but prefer the bus equivalents above for application logic.
 new Observer<AppData>(config?: ObserverConfig<AppData>)
 
 type ObserverConfig<AppData = Record<string, unknown>> = {
-    updatePolicy?: 'update-on-any-call-updated' | 'update-when-all-call-updated';
+    updatePolicy?: 'update-on-any-call-updated' | 'update-when-all-call-updated' | 'none';
     defaultCallUpdatePolicy?: ObservedCallSettings['updatePolicy'];
     appData?: AppData;
     closeClientIfIdleForMs?: number;
@@ -488,7 +491,7 @@ Key members:
 
 ```ts
 type ObservedCallSettings<AppData = Record<string, unknown>> = {
-    updatePolicy?: 'update-on-any-client-updated' | 'update-when-all-client-updated';
+    updatePolicy?: 'update-on-any-client-updated' | 'update-when-all-client-updated' | 'none';
     callId: string;
     appData?: AppData;
     closeCallIfEmptyForMs?: number;
@@ -929,7 +932,7 @@ yarn test        # jest
 
 The build is driven by [`tsup`](https://tsup.egoist.dev) (config in `tsup.config.ts`): a single
 entry (`src/index.ts`), dual ESM + CommonJS output to `dist/` (`index.mjs` / `index.js`) with
-`.d.mts` / `.d.ts` types and sourcemaps, targeting Node 22. CI (`.github/workflows/ci.yml`) runs
+`.d.mts` / `.d.ts` types and sourcemaps, targeting Node 20. CI (`.github/workflows/ci.yml`) runs
 lint + typecheck + **build** + test on every push/PR.
 
 **Project layout** (`src/`): `Observer.ts`, `ObservedCall.ts`, `ObservedClient.ts`,

package/dist/index.d.mts

@@ -2485,7 +2485,7 @@ declare class Detectors {
 }
 
 type ObservedCallUpdateConfig = {
-    updatePolicy?: 'update-on-any-client-updated' | 'update-when-all-client-updated';
+    updatePolicy?: 'update-on-any-client-updated' | 'update-when-all-client-updated' | 'none';
 };
 type ObservedCallSettings<AppData extends Record<string, unknown> = Record<string, unknown>> = ObservedCallUpdateConfig & {
     callId: string;
@@ -2587,7 +2587,7 @@ type AcceptMiddlewarePayload = {
  */
 type AcceptMiddleware = Middleware<AcceptMiddlewarePayload>;
 type ObserverUpdateConfig = {
-    updatePolicy?: 'update-on-any-call-updated' | 'update-when-all-call-updated';
+    updatePolicy?: 'update-on-any-call-updated' | 'update-when-all-call-updated' | 'none';
 };
 /** Produces the initial `appData` for a call created without an explicit `appData`. */
 type CallAppDataFactory = (params: {

package/dist/index.d.ts

@@ -2485,7 +2485,7 @@ declare class Detectors {
 }
 
 type ObservedCallUpdateConfig = {
-    updatePolicy?: 'update-on-any-client-updated' | 'update-when-all-client-updated';
+    updatePolicy?: 'update-on-any-client-updated' | 'update-when-all-client-updated' | 'none';
 };
 type ObservedCallSettings<AppData extends Record<string, unknown> = Record<string, unknown>> = ObservedCallUpdateConfig & {
     callId: string;
@@ -2587,7 +2587,7 @@ type AcceptMiddlewarePayload = {
  */
 type AcceptMiddleware = Middleware<AcceptMiddlewarePayload>;
 type ObserverUpdateConfig = {
-    updatePolicy?: 'update-on-any-call-updated' | 'update-when-all-call-updated';
+    updatePolicy?: 'update-on-any-call-updated' | 'update-when-all-call-updated' | 'none';
 };
 /** Produces the initial `appData` for a call created without an explicit `appData`. */
 type CallAppDataFactory = (params: {

package/dist/index.js

@@ -2879,6 +2879,8 @@ var ObservedCall = class extends import_events3.EventEmitter {
       case "update-when-all-client-updated":
         this.updater = new OnAllClientCallUpdater(this);
         break;
+      case "none":
+        break;
     }
     this.settings = {
       closeCallIfEmptyForMs: settings.closeCallIfEmptyForMs
@@ -3316,6 +3318,8 @@ var Observer = class extends import_events5.EventEmitter {
       case "update-when-all-call-updated":
         this.updater = new OnAllCallObserverUpdater(this);
         break;
+      case "none":
+        break;
     }
   }
   config;