@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.
- package/dist/models/live-query-definition.d.ts +4 -0
- package/dist/models/live-query-definition.d.ts.map +1 -1
- package/dist/services/transport-manager.d.ts +5 -2
- package/dist/services/transport-manager.d.ts.map +1 -1
- package/package.json +2 -2
- package/src/models/live-query-definition.js +4 -0
- package/src/services/transport-manager.js +8 -3
|
@@ -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
|
|
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
|
-
*
|
|
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:
|
|
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":"
|
|
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.
|
|
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.
|
|
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
|
-
*
|
|
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(
|
|
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
|
-
|
|
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
|