@optimystic/db-core 1.13.0 → 1.14.0

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.
Files changed (36) hide show
  1. package/dist/src/cluster/structs.d.ts +12 -0
  2. package/dist/src/cluster/structs.d.ts.map +1 -1
  3. package/dist/src/index.d.ts +1 -0
  4. package/dist/src/index.d.ts.map +1 -1
  5. package/dist/src/index.js +1 -0
  6. package/dist/src/index.js.map +1 -1
  7. package/dist/src/network/struct.d.ts +20 -0
  8. package/dist/src/network/struct.d.ts.map +1 -1
  9. package/dist/src/network/struct.js.map +1 -1
  10. package/dist/src/transaction/coordinator.d.ts.map +1 -1
  11. package/dist/src/transaction/coordinator.js +11 -3
  12. package/dist/src/transaction/coordinator.js.map +1 -1
  13. package/dist/src/transactor/network-transactor.d.ts +48 -5
  14. package/dist/src/transactor/network-transactor.d.ts.map +1 -1
  15. package/dist/src/transactor/network-transactor.js +98 -22
  16. package/dist/src/transactor/network-transactor.js.map +1 -1
  17. package/dist/src/transactor/owed-cancels.d.ts +96 -0
  18. package/dist/src/transactor/owed-cancels.d.ts.map +1 -0
  19. package/dist/src/transactor/owed-cancels.js +211 -0
  20. package/dist/src/transactor/owed-cancels.js.map +1 -0
  21. package/dist/src/transactor/transactor-source.d.ts.map +1 -1
  22. package/dist/src/transactor/transactor-source.js +3 -1
  23. package/dist/src/transactor/transactor-source.js.map +1 -1
  24. package/dist/src/utility/unref-timer.d.ts +9 -0
  25. package/dist/src/utility/unref-timer.d.ts.map +1 -0
  26. package/dist/src/utility/unref-timer.js +15 -0
  27. package/dist/src/utility/unref-timer.js.map +1 -0
  28. package/package.json +1 -1
  29. package/src/cluster/structs.ts +12 -0
  30. package/src/index.ts +1 -0
  31. package/src/network/struct.ts +20 -0
  32. package/src/transaction/coordinator.ts +11 -3
  33. package/src/transactor/network-transactor.ts +120 -29
  34. package/src/transactor/owed-cancels.ts +252 -0
  35. package/src/transactor/transactor-source.ts +3 -1
  36. package/src/utility/unref-timer.ts +15 -0
@@ -0,0 +1,211 @@
1
+ import { jitteredBackoffMs } from "../utility/backoff.js";
2
+ import { armUnrefTimer } from "../utility/unref-timer.js";
3
+ import { createLogger } from "../logger.js";
4
+ const log = createLogger('network-transactor');
5
+ /**
6
+ * Bounds the memory a writer spends on cancels it cannot land. Evicting an entry re-opens the wedge
7
+ * that entry was kept to close, so it is logged; a writer that owes this many is cut off from its
8
+ * cohorts, and its records are the node-side backstop's (backlog
9
+ * `debt-unpromotable-pending-records-need-a-sweep`).
10
+ */
11
+ const DEFAULT_MAX_OWED_ACTIONS = 256;
12
+ /** The backoff between re-sends of one owed cancel: a second at first, doubling to half a minute. */
13
+ const RETRY_BACKOFF = { baseMs: 1_000, capMs: 30_000 };
14
+ /**
15
+ * The cancels a writer could not discharge, kept and re-sent until they land.
16
+ *
17
+ * A cancel whose rounds all fall short — every one of them is a cluster transaction, so the member
18
+ * whose silence sank the commit sinks the cancel too — leaves pending records standing that make the
19
+ * members refuse every later write to those blocks, from any writer. Nothing else removes them while
20
+ * their slot is unreached (docs/repository.md, "A pending record's lifetime is bounded by its
21
+ * writer"), so the writer keeps the cancel and sends it again:
22
+ *
23
+ * - **before its own next pend of any of those blocks** ({@link beforePend}), which is what clears
24
+ * the leftover in front of the writer's next write to the block;
25
+ * - **on a backoff timer** while anything is owed, so other machines' writes, which the records also
26
+ * refuse, are freed without this writer writing the block again.
27
+ *
28
+ * Re-sending is safe whenever it arrives: a cancel deletes only the cancelled action's pending records
29
+ * and never moves a revision, so it commutes with every other action. The one exception is a re-pend
30
+ * of the SAME action id, whose new record a late cancel would delete — so a pend of an owed action
31
+ * supersedes the owed cancel for every block it names, and waits out any re-send of it already in
32
+ * flight before it goes out.
33
+ */
34
+ export class OwedCancels {
35
+ entries = new Map();
36
+ inFlight = new Map();
37
+ attempt;
38
+ now;
39
+ setTimer;
40
+ maxActions;
41
+ timer;
42
+ stopped = false;
43
+ constructor(init) {
44
+ this.attempt = init.attempt;
45
+ this.now = init.clock?.now ?? (() => Date.now());
46
+ this.setTimer = init.clock?.setTimer ?? armUnrefTimer;
47
+ this.maxActions = init.maxActions ?? DEFAULT_MAX_OWED_ACTIONS;
48
+ }
49
+ /** Every owed action with the blocks it still owes a cancel for. A snapshot. */
50
+ snapshot() {
51
+ return new Map(Array.from(this.entries, ([actionId, entry]) => [actionId, Array.from(entry.blockIds)]));
52
+ }
53
+ /** A cancel for `actionId` ran out of budget with `blockIds` still unanswered. */
54
+ record(actionId, blockIds, why) {
55
+ if (blockIds.length === 0)
56
+ return;
57
+ if (this.stopped) {
58
+ log('cancel:owed-abandoned actionId=%s blocks=%o why=stopped', actionId, blockIds);
59
+ return;
60
+ }
61
+ const existing = this.entries.get(actionId);
62
+ if (existing) {
63
+ for (const bid of blockIds)
64
+ existing.blockIds.add(bid);
65
+ existing.nextAttemptAt = this.now() + this.backoffMs(existing.attempts);
66
+ }
67
+ else {
68
+ const now = this.now();
69
+ this.entries.set(actionId, { blockIds: new Set(blockIds), since: now, attempts: 0, nextAttemptAt: now + this.backoffMs(0) });
70
+ this.evictOverflow();
71
+ }
72
+ log('cancel:owed actionId=%s blocks=%o why=%s', actionId, blockIds, why ?? 'unknown');
73
+ this.arm();
74
+ }
75
+ /** A cancel for `actionId` was answered for `blockIds` — whoever sent it, they are owed no longer. */
76
+ discharged(actionId, blockIds) {
77
+ const settled = this.remove(actionId, blockIds);
78
+ if (settled) {
79
+ log('cancel:owed-discharged actionId=%s attempts=%d stoodMs=%d', actionId, settled.attempts, this.now() - settled.since);
80
+ }
81
+ }
82
+ /**
83
+ * Re-sends nothing from here on: the timer is disarmed and every cancel still owed is logged
84
+ * (`cancel:owed-abandoned`) and forgotten, its records left to the node-side backstop. For when the
85
+ * node the re-sends go through stops — they could never land, and the timer would otherwise keep
86
+ * the transactor, and everything it reaches, alive for the life of the process.
87
+ */
88
+ stop() {
89
+ this.stopped = true;
90
+ this.timer?.cancel();
91
+ this.timer = undefined;
92
+ for (const [actionId, entry] of this.entries) {
93
+ log('cancel:owed-abandoned actionId=%s blocks=%o stoodMs=%d', actionId, Array.from(entry.blockIds), this.now() - entry.since);
94
+ }
95
+ this.entries.clear();
96
+ }
97
+ /**
98
+ * Runs ahead of every pend of `actionId` over `blockIds`: supersedes this action's own owed cancel
99
+ * for those blocks, then makes one attempt at every OTHER owed cancel that names any of them. A
100
+ * failed attempt stays owed and the pend proceeds; a cohort still unable to approve the cancel
101
+ * cannot approve the pend either, so one attempt — not a loop — is what the pend should wait for.
102
+ */
103
+ async beforePend(actionId, blockIds) {
104
+ if (this.entries.size === 0 && this.inFlight.size === 0)
105
+ return;
106
+ await this.supersede(actionId, blockIds);
107
+ const named = new Set(blockIds);
108
+ const overlapping = Array.from(this.entries)
109
+ .filter(([owedId, entry]) => owedId !== actionId && Array.from(entry.blockIds).some(bid => named.has(bid)))
110
+ .map(([owedId]) => owedId);
111
+ await Promise.all(overlapping.map(owedId => this.attemptOnce(owedId)));
112
+ }
113
+ /**
114
+ * A pend of `actionId` writes a fresh record on every block it names, which a late cancel for the
115
+ * same action id would delete. So those blocks leave the owed entry first — synchronously, so no
116
+ * re-send started from here on can carry them — and a re-send already in flight is waited out, so
117
+ * it lands before the pend rather than after it.
118
+ */
119
+ async supersede(actionId, blockIds) {
120
+ const entry = this.entries.get(actionId);
121
+ const superseded = entry ? blockIds.filter(bid => entry.blockIds.has(bid)) : [];
122
+ if (superseded.length > 0) {
123
+ log('cancel:owed-superseded actionId=%s blocks=%o', actionId, superseded);
124
+ this.remove(actionId, superseded);
125
+ }
126
+ await this.inFlight.get(actionId);
127
+ }
128
+ /** Takes `blockIds` off `actionId`'s entry, returning the entry when that emptied — and so removed — it. */
129
+ remove(actionId, blockIds) {
130
+ const entry = this.entries.get(actionId);
131
+ if (!entry)
132
+ return undefined;
133
+ for (const bid of blockIds)
134
+ entry.blockIds.delete(bid);
135
+ if (entry.blockIds.size > 0)
136
+ return undefined;
137
+ this.entries.delete(actionId);
138
+ this.arm();
139
+ return entry;
140
+ }
141
+ /** One re-send of `actionId`'s owed cancel, joining the one already in flight if there is one. */
142
+ attemptOnce(actionId) {
143
+ const running = this.inFlight.get(actionId);
144
+ if (running)
145
+ return running;
146
+ const entry = this.entries.get(actionId);
147
+ if (!entry)
148
+ return Promise.resolve();
149
+ ++entry.attempts;
150
+ const run = this.resend(actionId, Array.from(entry.blockIds))
151
+ .finally(() => {
152
+ if (this.inFlight.get(actionId) === run)
153
+ this.inFlight.delete(actionId);
154
+ this.arm();
155
+ });
156
+ this.inFlight.set(actionId, run);
157
+ return run;
158
+ }
159
+ async resend(actionId, blockIds) {
160
+ let answered;
161
+ try {
162
+ answered = await this.attempt({ actionId, blockIds });
163
+ }
164
+ catch (error) {
165
+ log('cancel:owed-retry-failed actionId=%s blocks=%d error=%s', actionId, blockIds.length, error?.message ?? String(error));
166
+ answered = new Set();
167
+ }
168
+ this.discharged(actionId, answered);
169
+ const entry = this.entries.get(actionId);
170
+ if (entry) {
171
+ entry.nextAttemptAt = this.now() + this.backoffMs(entry.attempts);
172
+ }
173
+ }
174
+ /** Arms the one timer at the earliest re-send due among the entries not already being re-sent, or disarms it. */
175
+ arm() {
176
+ let dueAt;
177
+ for (const [actionId, entry] of this.entries) {
178
+ if (this.inFlight.has(actionId))
179
+ continue;
180
+ if (dueAt === undefined || entry.nextAttemptAt < dueAt)
181
+ dueAt = entry.nextAttemptAt;
182
+ }
183
+ if (this.timer && (dueAt === undefined || this.timer.dueAt > dueAt)) {
184
+ this.timer.cancel();
185
+ this.timer = undefined;
186
+ }
187
+ if (dueAt === undefined || this.timer)
188
+ return;
189
+ this.timer = { cancel: this.setTimer(() => this.fire(), Math.max(0, dueAt - this.now())), dueAt };
190
+ }
191
+ fire() {
192
+ this.timer = undefined;
193
+ const now = this.now();
194
+ for (const [actionId, entry] of this.entries) {
195
+ if (entry.nextAttemptAt <= now)
196
+ void this.attemptOnce(actionId);
197
+ }
198
+ this.arm();
199
+ }
200
+ backoffMs(attempts) {
201
+ return jitteredBackoffMs(attempts, RETRY_BACKOFF);
202
+ }
203
+ evictOverflow() {
204
+ while (this.entries.size > this.maxActions) {
205
+ const [oldestId, oldest] = this.entries.entries().next().value;
206
+ this.entries.delete(oldestId);
207
+ log('cancel:owed-evicted actionId=%s blocks=%o stoodMs=%d', oldestId, Array.from(oldest.blockIds), this.now() - oldest.since);
208
+ }
209
+ }
210
+ }
211
+ //# sourceMappingURL=owed-cancels.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"owed-cancels.js","sourceRoot":"","sources":["../../../src/transactor/owed-cancels.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"transactor-source.d.ts","sourceRoot":"","sources":["../../../src/transactor/transactor-source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGzN,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAEtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKzD;;;;;;;;;;;;;;;;;;;;;;;iFAuBiF;AACjF,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASxH;AAED;;iCAEiC;AACjC,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE5D;AAED,qGAAqG;AACrG,MAAM,MAAM,WAAW,GAAG;IACzB,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,qBAAa,gBAAgB,CAAC,MAAM,SAAS,MAAM,CAAE,YAAW,WAAW,CAAC,MAAM,CAAC;IAejF,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IACpB,aAAa,EAAE,aAAa,GAAG,SAAS;IAE/C;uGACmG;IACnG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IApBzB;;iDAE6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD;uFACmF;IACnF,OAAO,CAAC,aAAa,CAA8B;IACnD;;;mGAG+F;IAC/F,OAAO,CAAC,MAAM,CAAsC;gBAGlC,YAAY,EAAE,OAAO,EACrB,UAAU,EAAE,WAAW,EACjC,aAAa,EAAE,aAAa,GAAG,SAAS,EAC/C,SAAS,CAAC,EAAE,uBAAuB;IACnC;uGACmG;IAClF,MAAM,CAAC,EAAE,eAAe,YAAA;IAK1C,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW;IAQhE,UAAU,IAAI,OAAO;IAKf,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,GAAE,WAAqB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA6CtF;;+DAE2D;IAC3D,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS;IAIhD;;wFAEoF;IACpF,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAItD;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA4BqB;IACrB,OAAO,CAAC,SAAS;IAIjB,mBAAmB,IAAI,cAAc,EAAE;IAIvC;;;8EAG0E;IAC1E,YAAY,IAAI,uBAAuB;IAIvC,qBAAqB,IAAI,IAAI;IAI7B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,QAAQ,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,SAAI,EAAE,YAAY,CAAC,EAAE,mBAAmB,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA2C7M;;;;;;;;;;OAUG;YACW,aAAa;CAS3B"}
1
+ {"version":3,"file":"transactor-source.d.ts","sourceRoot":"","sources":["../../../src/transactor/transactor-source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGzN,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAEtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKzD;;;;;;;;;;;;;;;;;;;;;;;iFAuBiF;AACjF,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASxH;AAED;;iCAEiC;AACjC,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE5D;AAED,qGAAqG;AACrG,MAAM,MAAM,WAAW,GAAG;IACzB,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,qBAAa,gBAAgB,CAAC,MAAM,SAAS,MAAM,CAAE,YAAW,WAAW,CAAC,MAAM,CAAC;IAejF,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IACpB,aAAa,EAAE,aAAa,GAAG,SAAS;IAE/C;uGACmG;IACnG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IApBzB;;iDAE6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD;uFACmF;IACnF,OAAO,CAAC,aAAa,CAA8B;IACnD;;;mGAG+F;IAC/F,OAAO,CAAC,MAAM,CAAsC;gBAGlC,YAAY,EAAE,OAAO,EACrB,UAAU,EAAE,WAAW,EACjC,aAAa,EAAE,aAAa,GAAG,SAAS,EAC/C,SAAS,CAAC,EAAE,uBAAuB;IACnC;uGACmG;IAClF,MAAM,CAAC,EAAE,eAAe,YAAA;IAK1C,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW;IAQhE,UAAU,IAAI,OAAO;IAKf,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,GAAE,WAAqB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA6CtF;;+DAE2D;IAC3D,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS;IAIhD;;wFAEoF;IACpF,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAItD;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA4BqB;IACrB,OAAO,CAAC,SAAS;IAIjB,mBAAmB,IAAI,cAAc,EAAE;IAIvC;;;8EAG0E;IAC1E,YAAY,IAAI,uBAAuB;IAIvC,qBAAqB,IAAI,IAAI;IAI7B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,QAAQ,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,SAAI,EAAE,YAAY,CAAC,EAAE,mBAAmB,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA6C7M;;;;;;;;;;OAUG;YACW,aAAa;CAS3B"}
@@ -217,7 +217,9 @@ export class TransactorSource {
217
217
  const pendResult = await this.transactor.pend({
218
218
  transforms: transform, actionId, rev, policy: 'r',
219
219
  ...(priority > 0 ? { priority } : {}),
220
- ...baseRevsField(baseRevs)
220
+ ...baseRevsField(baseRevs),
221
+ // One collection, pended whole and then committed: the shape `PendRequest.soleReservation` names.
222
+ soleReservation: true
221
223
  });
222
224
  if (!pendResult.success) {
223
225
  return pendResult;
@@ -1 +1 @@
1
- {"version":3,"file":"transactor-source.js","sourceRoot":"","sources":["../../../src/transactor/transactor-source.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"transactor-source.js","sourceRoot":"","sources":["../../../src/transactor/transactor-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAEtE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,GAAG,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;iFAuBiF;AACjF,MAAM,UAAU,aAAa,CAAC,EAAW,EAAE,KAAqB,EAAE,OAAkC;IACnG,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,GAAG,KAAK,CAAC;IAC1D,IAAI,CAAC,KAAK,IAAI,WAAW,EAAE,CAAC;QAC3B,MAAM,IAAI,qBAAqB,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,mBAAmB,KAAK,SAAS,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,IAAI,mBAAmB,CAAC,EAAE,CAAC;QACxG,MAAM,IAAI,uBAAuB,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;iCAEiC;AACjC,MAAM,UAAU,cAAc,CAAC,KAAqB;IACnD,OAAO,KAAK,CAAC,YAAY,EAAE,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;AAChE,CAAC;AAUD,MAAM,OAAO,gBAAgB;IAeV;IACA;IACV;IAIU;IApBlB;;iDAE6C;IAC5B,SAAS,CAA0B;IACpD;uFACmF;IAC3E,aAAa,GAAG,IAAI,GAAG,EAAmB,CAAC;IACnD;;;mGAG+F;IACvF,MAAM,GAAG,IAAI,OAAO,EAAuB,CAAC;IAEpD,YACkB,YAAqB,EACrB,UAAuB,EACjC,aAAwC,EAC/C,SAAmC;IACnC;uGACmG;IAClF,MAAwB;QANxB,iBAAY,GAAZ,YAAY,CAAS;QACrB,eAAU,GAAV,UAAU,CAAa;QACjC,kBAAa,GAAb,aAAa,CAA2B;QAI9B,WAAM,GAAN,MAAM,CAAkB;QAEzC,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,IAAI,uBAAuB,EAAE,CAAC;IAC7D,CAAC;IAED,iBAAiB,CAAC,IAAe,EAAE,KAAe;QACjD,OAAO;YACN,IAAI;YACJ,EAAE,EAAE,KAAK,IAAI,IAAI,CAAC,UAAU,EAAE;YAC9B,YAAY,EAAE,IAAI,CAAC,YAAY;SAC/B,CAAC;IACH,CAAC;IAED,UAAU;QACT,8CAA8C;QAC9C,OAAO,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,CAAA;IACxD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAW,EAAE,UAAuB,OAAO;QACvD,2FAA2F;QAC3F,6FAA6F;QAC7F,0EAA0E;QAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YACxC,QAAQ,EAAE,CAAC,EAAE,CAAC;YACd,OAAO,EAAE,IAAI,CAAC,aAAa;YAC3B,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/D,CAAC,CAAC;QACH,mFAAmF;QACnF,gFAAgF;QAChF,yEAAyE;QACzE,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,KAAK,EAAE,CAAC;YACX,sEAAsE;YACtE,MAAM,KAAK,GAAG,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAC3D,4FAA4F;YAC5F,8FAA8F;YAC9F,wFAAwF;YACxF,6FAA6F;YAC7F,2FAA2F;YAC3F,IAAI,KAAK,EAAE,CAAC;gBACX,mFAAmF;gBACnF,qFAAqF;gBACrF,2EAA2E;gBAC3E,sFAAsF;gBACtF,sFAAsF;gBACtF,iFAAiF;gBACjF,kCAAkC;gBAClC,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;gBAClC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;gBACxC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;gBAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACrE,CAAC;YACD,yFAAyF;YACzF,2FAA2F;YAC3F,0FAA0F;YAC1F,4FAA4F;YAC5F,yFAAyF;YACzF,2FAA2F;YAC3F,OAAO,KAAe,CAAC;QACxB,CAAC;IACF,CAAC;IAED;;+DAE2D;IAC3D,eAAe,CAAC,EAAW;QAC1B,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;wFAEoF;IACpF,cAAc,CAAC,KAAa;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA4BqB;IACb,SAAS,CAAC,EAAW,EAAE,SAAiB;QAC/C,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAC5E,CAAC;IAED,mBAAmB;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,CAAC;IAC7C,CAAC;IAED;;;8EAG0E;IAC1E,YAAY;QACX,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,qBAAqB;QACpB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,QAAQ,CAAC,SAAqB,EAAE,QAAkB,EAAE,GAAW,EAAE,QAAiB,EAAE,MAAe,EAAE,QAAQ,GAAG,CAAC,EAAE,YAAkC,EAAE,QAAwB;QACpL,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAC7C,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG;YACjD,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,GAAG,aAAa,CAAC,QAAQ,CAAC;YAC1B,kGAAkG;YAClG,eAAe,EAAE,IAAI;SACrB,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACzB,OAAO,UAAU,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC9E,IAAI,CAAC;YACJ,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBACjD,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;gBACtC,MAAM;gBACN,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,QAAQ;gBACR,GAAG;gBACH,GAAG,iBAAiB,CAAC,YAAY,CAAC;aAClC,CAAC,CAAC;YACH,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBAC3B,yFAAyF;gBACzF,mFAAmF;gBACnF,gFAAgF;gBAChF,mFAAmF;gBACnF,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACxD,OAAO,YAAY,CAAC;YACrB,CAAC;YACD,OAAO,EAAE,GAAG,YAAY,EAAE,UAAU,EAAE,aAAa,CAAC,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;QAC1G,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,yFAAyF;YACzF,wFAAwF;YACxF,wFAAwF;YACxF,oDAAoD;YACpD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC5E,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACtE,oFAAoF;gBACpF,uFAAuF;gBACvF,IAAI,CAAC;oBAAE,CAA+B,CAAC,WAAW,GAAG,WAAW,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;YAC3F,CAAC;YACD,MAAM,CAAC,CAAC;QACT,CAAC;IACF,CAAC;IAED;;;;;;;;;;OAUG;IACK,KAAK,CAAC,aAAa,CAAC,QAAkB,EAAE,QAAmB;QAClE,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;YACrD,OAAO,SAAS,CAAC;QAClB,CAAC;QAAC,OAAO,WAAW,EAAE,CAAC;YACtB,GAAG,CAAC,8EAA8E,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;YACrH,OAAO,WAAW,CAAC;QACpB,CAAC;IACF,CAAC;CACD"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Keep a pending timer from holding a Node process open. Browsers and React Native return a number
3
+ * from `setTimeout` / `setInterval`, which has no `unref`, so the call is guarded. Every first-party
4
+ * `unref` goes through here; the `NO_TIMER_UNREF` lint rule in `eslint.config.js` enforces that.
5
+ */
6
+ export declare function unrefTimer<T>(handle: T): T;
7
+ /** Arm a one-shot timer that never holds a process open; returns its cancel. The default behind the injectable `setTimer` seams. */
8
+ export declare function armUnrefTimer(fn: () => void, ms: number): () => void;
9
+ //# sourceMappingURL=unref-timer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unref-timer.d.ts","sourceRoot":"","sources":["../../../src/utility/unref-timer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAG1C;AAED,oIAAoI;AACpI,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,IAAI,CAGpE"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Keep a pending timer from holding a Node process open. Browsers and React Native return a number
3
+ * from `setTimeout` / `setInterval`, which has no `unref`, so the call is guarded. Every first-party
4
+ * `unref` goes through here; the `NO_TIMER_UNREF` lint rule in `eslint.config.js` enforces that.
5
+ */
6
+ export function unrefTimer(handle) {
7
+ handle.unref?.();
8
+ return handle;
9
+ }
10
+ /** Arm a one-shot timer that never holds a process open; returns its cancel. The default behind the injectable `setTimer` seams. */
11
+ export function armUnrefTimer(fn, ms) {
12
+ const handle = unrefTimer(setTimeout(fn, ms));
13
+ return () => clearTimeout(handle);
14
+ }
15
+ //# sourceMappingURL=unref-timer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"unref-timer.js","sourceRoot":"","sources":["../../../src/utility/unref-timer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAI,MAAS;IACrC,MAAiC,CAAC,KAAK,EAAE,EAAE,CAAC;IAC7C,OAAO,MAAM,CAAC;AACf,CAAC;AAED,oIAAoI;AACpI,MAAM,UAAU,aAAa,CAAC,EAAc,EAAE,EAAU;IACvD,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9C,OAAO,GAAS,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@optimystic/db-core",
3
- "version": "1.13.0",
3
+ "version": "1.14.0",
4
4
  "type": "module",
5
5
  "description": "Core database functionality for Optimystic",
6
6
  "main": "dist/src/index.js",
@@ -354,6 +354,18 @@ export interface ClusterConsensusConfig {
354
354
  commitBroadcastRetryMaxAttempts?: number;
355
355
  /** Immediate in-line retries per failed peer inside the broadcast (default 1) */
356
356
  commitBroadcastImmediateRetries?: number;
357
+ /**
358
+ * How long a coordinator may hold back a pend's final "apply it" delivery to the other members, in
359
+ * ms (default 2000, `DEFAULT_PEND_DELIVERY_DEFERRAL_MS` in db-p2p), so it rides on the first request
360
+ * of the action's commit instead of costing a request of its own. Only for a pend on a two-member
361
+ * cohort that reached its commit majority without a commit round, whose writer marked it the action's
362
+ * only reservation (`PendRequest.soleReservation`), and only to a member this node can carry records
363
+ * to. When the time runs out first the delivery goes alone, and that does not count against
364
+ * `commitBroadcastRetryMaxAttempts`. `0` turns the deferral off: a
365
+ * single-collection write on a two-member cohort then costs the other member four requests instead
366
+ * of three.
367
+ */
368
+ pendDeliveryDeferralMs?: number;
357
369
  /**
358
370
  * Immediate in-line retries per peer while collecting promises (default 1).
359
371
  * The promise phase rides the same libp2p stream the commit broadcast does;
package/src/index.ts CHANGED
@@ -24,3 +24,4 @@ export * from "./utility/ensured.js";
24
24
  export * from "./utility/pending.js";
25
25
  export * from "./utility/lru-map.js";
26
26
  export * from "./utility/backoff.js";
27
+ export * from "./utility/unref-timer.js";
@@ -82,6 +82,26 @@ export type PendRequest = ActionTransforms & {
82
82
  * pend named no base, not the primary check.
83
83
  */
84
84
  baseRevs?: BlockBaseRevs;
85
+ /**
86
+ * The writer's word that this pend is the action's only one — every block the action will commit
87
+ * is in this one request — and that the action's commit goes to the coordinator this pend goes
88
+ * to. Only then may a coordinator hold back the pend's final delivery to the other members and
89
+ * send it inside the commit's first request (`ClusterCoordinator.mayDeferPendDelivery` in db-p2p):
90
+ * a member that refuses the pend late refuses that one commit, before anything of the action is
91
+ * durable. A send that pends several requests before committing any — several collections under
92
+ * one action id, or one collection split across coordinators — must never carry it: one request's
93
+ * late refusal would surface while another request's commit may already have landed, tearing the
94
+ * action.
95
+ *
96
+ * Set by `TransactorSource.transact` and by `TransactionCoordinator` for a transaction of exactly
97
+ * one collection; `NetworkTransactor.pend` keeps it only on a request carrying the whole pend.
98
+ * `Collection.completeOwnEntry` re-sends one participant of a half-landed multi-collection action
99
+ * through `transact`, and carries it too: that re-send pends and commits its one collection on its
100
+ * own, so its late refusal stops only its own commit, as an on-time refusal would.
101
+ * Omitted rather than `false`, for the same preimage reason as {@link baseRevs}; a coordinator on
102
+ * an older build ignores it, and then delivers at once as it always did.
103
+ */
104
+ soleReservation?: true;
85
105
  };
86
106
 
87
107
  export type BlockActionStatus = ActionBlocks & {
@@ -1601,6 +1601,11 @@ export class TransactionCoordinator {
1601
1601
 
1602
1602
  const actionId = transaction.id as ActionId;
1603
1603
  const nominees = superclusterNominees ? Array.from(superclusterNominees) : undefined;
1604
+ // A one-collection transaction pends once and commits that one collection (commitPhase), as a
1605
+ // `Collection.sync` write does, so its pend may say so (`PendRequest.soleReservation`). Two or
1606
+ // more never may: each collection's commit lands on its own, and a late refusal of another
1607
+ // collection's pend would surface after it.
1608
+ const sole = collectionTransforms.size === 1;
1604
1609
 
1605
1610
  // Fan out the independent per-collection pends concurrently. Each settles to a
1606
1611
  // { collectionId, blockIds } on success, or rejects with the per-collection reason.
@@ -1609,7 +1614,7 @@ export class TransactionCoordinator {
1609
1614
  // with a concurrency limiter so peak in-flight round-trips stays sane. Same for commitPhase.
1610
1615
  const outcomes = await Promise.allSettled(
1611
1616
  Array.from(collectionTransforms.entries()).map(([collectionId, transforms]) =>
1612
- this.pendCollection(transaction, validation, collectionId, transforms, pendedRevs.get(collectionId)!, actionId, nominees)
1617
+ this.pendCollection(transaction, validation, collectionId, transforms, pendedRevs.get(collectionId)!, actionId, nominees, sole)
1613
1618
  )
1614
1619
  );
1615
1620
 
@@ -1666,7 +1671,9 @@ export class TransactionCoordinator {
1666
1671
  * a concurrent refresh already moved past. */
1667
1672
  rev: number,
1668
1673
  actionId: ActionId,
1669
- nominees: PeerId[] | undefined
1674
+ nominees: PeerId[] | undefined,
1675
+ /** Whether this is the transaction's only collection (see {@link pendPhase}). */
1676
+ sole: boolean
1670
1677
  ): Promise<{ collectionId: CollectionId; blockIds: BlockId[] }> {
1671
1678
  const collection = this.collections.get(collectionId);
1672
1679
  if (!collection) {
@@ -1696,7 +1703,8 @@ export class TransactionCoordinator {
1696
1703
  ? (priority > 0 ? { priority } : {})
1697
1704
  : { validation }),
1698
1705
  ...baseRevsField(baseRevs),
1699
- superclusterNominees: nominees
1706
+ superclusterNominees: nominees,
1707
+ ...(sole ? { soleReservation: true as const } : {})
1700
1708
  };
1701
1709
 
1702
1710
  const pendResult = await this.transactor.pend(pendRequest);