@econ-v1/domain 7.6.46 → 7.6.48

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -24,6 +24,9 @@ export type DomainEvent = import("../events/index.js").DomainEvent;
24
24
  * the single `connectivity.changed` edge published when a node comes back — so
25
25
  * without a timer one transient failure is permanent for the life of the
26
26
  * subscription.
27
+ *
28
+ * `acquire` starts work needed only by a live consumer and returns its release function.
29
+ * One-shot reads never acquire it; each subscription releases it exactly once.
27
30
  */
28
31
  export type LiveQueryDefinition<TParams, TRow> = {
29
32
  readonly invalidateOn: readonly KernelEventType[];
@@ -31,6 +34,7 @@ export type LiveQueryDefinition<TParams, TRow> = {
31
34
  readonly name: QueryName;
32
35
  readonly requiresDurableStorage?: boolean;
33
36
  readonly retryAfterMs?: () => number;
37
+ readonly acquire?: () => () => void;
34
38
  key(row: TRow): string;
35
39
  run(params: TParams): Promise<readonly TRow[]>;
36
40
  };
@@ -1 +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;;;;;;;;;;;;;;;;;;;;;;;;;gCAyBzC,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"}
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;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCA4BzC,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;IACzC,QAAY,CAAC,OAAO,CAAC,EAAE,MAAM,MAAM,IAAI,CAAC;IACpC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM,CAAC;IACvB,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;CAChD"}
@@ -46,10 +46,13 @@ export class TransportManager {
46
46
  */
47
47
  connect(options?: TransportConnectOptions): Promise<HomeNodeClient>;
48
48
  /**
49
- * @param {DirectTransportPath} path
49
+ * Adopt a carrier snapshot, or publish a selected ladder path.
50
+ * @param {Exclude<TransportState["path"], "offline"> | Extract<TransportState, {status: "connected"}>} path
50
51
  * @returns {void}
51
52
  */
52
- markConnected(path: DirectTransportPath): void;
53
+ markConnected(path: Exclude<TransportState["path"], "offline"> | Extract<TransportState, {
54
+ status: "connected";
55
+ }>): void;
53
56
  /** @param {number} attempt @returns {void} */
54
57
  markConnecting(attempt: number): void;
55
58
  /** @param {number} attempt @param {string} nextRetryAt @returns {void} */
@@ -1 +1 @@
1
- {"version":3,"file":"transport-manager.d.ts","sourceRoot":"","sources":["../../src/services/transport-manager.js"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"transport-manager.d.ts","sourceRoot":"","sources":["../../src/services/transport-manager.js"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@econ-v1/domain",
3
- "version": "7.6.46",
3
+ "version": "7.6.48",
4
4
  "description": "Platform-neutral domain contracts and errors for Node clients",
5
5
  "license": "MIT OR Apache-2.0",
6
6
  "author": "Node contributors",
@@ -57,6 +57,6 @@
57
57
  "access": "public"
58
58
  },
59
59
  "dependencies": {
60
- "@econ-v1/ports": "7.6.46"
60
+ "@econ-v1/ports": "7.6.48"
61
61
  }
62
62
  }
@@ -31,6 +31,9 @@
31
31
  * without a timer one transient failure is permanent for the life of the
32
32
  * subscription.
33
33
  *
34
+ * `acquire` starts work needed only by a live consumer and returns its release function.
35
+ * One-shot reads never acquire it; each subscription releases it exactly once.
36
+ *
34
37
  * @template TParams
35
38
  * @template TRow
36
39
  * @typedef {{
@@ -39,6 +42,7 @@
39
42
  * readonly name: QueryName;
40
43
  * readonly requiresDurableStorage?: boolean;
41
44
  * readonly retryAfterMs?: () => number;
45
+ * readonly acquire?: () => () => void;
42
46
  * key(row: TRow): string;
43
47
  * run(params: TParams): Promise<readonly TRow[]>;
44
48
  * }} LiveQueryDefinition
@@ -149,11 +149,14 @@ export class TransportManager {
149
149
  }
150
150
 
151
151
  /**
152
- * @param {DirectTransportPath} path
152
+ * Adopt a carrier snapshot, or publish a selected ladder path.
153
+ * @param {Exclude<TransportState["path"], "offline"> | Extract<TransportState, {status: "connected"}>} path
153
154
  * @returns {void}
154
155
  */
155
156
  markConnected(path) {
156
- this.#setState({ changedAt: this.#now(), path, status: "connected" });
157
+ this.#setState(typeof path === "string"
158
+ ? { changedAt: this.#now(), path, status: "connected" }
159
+ : path);
157
160
  }
158
161
 
159
162
  /** @param {number} attempt @returns {void} */
@@ -295,7 +298,9 @@ export class TransportManager {
295
298
  if (publishState) this.markConnected(winner.attempt.candidate.path);
296
299
  return winner.client;
297
300
  }
298
- if (publishState) this.markOffline();
301
+ // Dial failure describes this ladder, not an already adopted live carrier.
302
+ // Explicit retirement/teardown still owns genuine offline transitions.
303
+ if (publishState && this.#state.status !== "connected") this.markOffline();
299
304
  // Typed, not a bare `Error`. `ManagedHomeNodeClient#activateWhenConnected` funnels this
300
305
  // through `normalizeTransportError`, which passes the three N2 seam types through and
301
306
  // REPLACES anything else with a generic `TransportError("No home-node transport