@econ-v1/domain 7.0.51 → 7.0.52

package/dist/models/live-query-definition.d.ts

@@ -9,12 +9,23 @@ export type DomainEvent = import("../events/index.js").DomainEvent;
  * `run()` is provably independent of the local SQLite cache, such as in-memory
  * state or a home-node round trip; those queries remain available in degraded
  * mode when a browser cannot provide OPFS.
+ *
+ * `retryAfterMs` is how a definition that carries its own failure backoff
+ * asks the engine to come back on a timer. It is read after a rejected
+ * `run()` and returns milliseconds from now until the definition is willing
+ * to run again; `0` or an absent property schedules nothing. It exists
+ * because a definition whose `matchesInvalidation` gates on a backoff
+ * deadline DISCARDS the invalidations that arrive inside the window — including
+ * the single `connectivity.changed` edge published when a node comes back — so
+ * without a timer one transient failure is permanent for the life of the
+ * subscription.
  */
 export type LiveQueryDefinition<TParams, TRow> = {
     readonly invalidateOn: readonly KernelEventType[];
     readonly matchesInvalidation?: (event: DomainEvent) => boolean;
     readonly name: QueryName;
     readonly requiresDurableStorage?: boolean;
+    readonly retryAfterMs?: () => number;
     key(row: TRow): string;
     run(params: TParams): Promise<readonly TRow[]>;
 };

package/dist/models/live-query-definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-query-definition.d.ts","sourceRoot":"","sources":["../../src/models/live-query-definition.js"],"names":[],"mappings":"8BAGa,OAAO,oBAAoB,EAAE,eAAe;wBAG5C,OAAO,oBAAoB,EAAE,SAAS;0BAErC,OAAO,oBAAoB,EAAE,WAAW;;;;;;;;;;gCAUzC,OAAO,EACP,IAAI,IACJ;IACZ,QAAY,CAAC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;IACtD,QAAY,CAAC,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC;IACnE,QAAY,CAAC,IAAI,EAAE,SAAS,CAAC;IAC7B,QAAY,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAAC;IACvB,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;CAChD"}
+{"version":3,"file":"live-query-definition.d.ts","sourceRoot":"","sources":["../../src/models/live-query-definition.js"],"names":[],"mappings":"8BAGa,OAAO,oBAAoB,EAAE,eAAe;wBAG5C,OAAO,oBAAoB,EAAE,SAAS;0BAErC,OAAO,oBAAoB,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;gCAoBzC,OAAO,EACP,IAAI,IACJ;IACZ,QAAY,CAAC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;IACtD,QAAY,CAAC,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC;IACnE,QAAY,CAAC,IAAI,EAAE,SAAS,CAAC;IAC7B,QAAY,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC9C,QAAY,CAAC,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;IACrC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAAC;IACvB,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;CAChD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@econ-v1/domain",
-  "version": "7.0.51",
+  "version": "7.0.52",
   "description": "Platform-neutral domain contracts and errors for Node clients",
   "license": "MIT OR Apache-2.0",
   "author": "Node contributors",
@@ -57,6 +57,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@econ-v1/ports": "7.0.51"
+    "@econ-v1/ports": "7.0.52"
   }
 }

package/src/models/live-query-definition.js

@@ -16,6 +16,16 @@
  * state or a home-node round trip; those queries remain available in degraded
  * mode when a browser cannot provide OPFS.
  *
+ * `retryAfterMs` is how a definition that carries its own failure backoff
+ * asks the engine to come back on a timer. It is read after a rejected
+ * `run()` and returns milliseconds from now until the definition is willing
+ * to run again; `0` or an absent property schedules nothing. It exists
+ * because a definition whose `matchesInvalidation` gates on a backoff
+ * deadline DISCARDS the invalidations that arrive inside the window — including
+ * the single `connectivity.changed` edge published when a node comes back — so
+ * without a timer one transient failure is permanent for the life of the
+ * subscription.
+ *
  * @template TParams
  * @template TRow
  * @typedef {{
@@ -23,6 +33,7 @@
  *   readonly matchesInvalidation?: (event: DomainEvent) => boolean;
  *   readonly name: QueryName;
  *   readonly requiresDurableStorage?: boolean;
+ *   readonly retryAfterMs?: () => number;
  *   key(row: TRow): string;
  *   run(params: TParams): Promise<readonly TRow[]>;
  * }} LiveQueryDefinition