@optimystic/db-core 1.19.0 → 1.20.1

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 (171) hide show
  1. package/dist/src/cluster/structs.d.ts +41 -8
  2. package/dist/src/cluster/structs.d.ts.map +1 -1
  3. package/dist/src/cluster/structs.js +18 -7
  4. package/dist/src/cluster/structs.js.map +1 -1
  5. package/dist/src/collection/action.d.ts +29 -0
  6. package/dist/src/collection/action.d.ts.map +1 -1
  7. package/dist/src/collection/action.js +6 -0
  8. package/dist/src/collection/action.js.map +1 -1
  9. package/dist/src/collection/collection.d.ts +533 -120
  10. package/dist/src/collection/collection.d.ts.map +1 -1
  11. package/dist/src/collection/collection.js +974 -500
  12. package/dist/src/collection/collection.js.map +1 -1
  13. package/dist/src/collection/head-commit.d.ts +110 -0
  14. package/dist/src/collection/head-commit.d.ts.map +1 -0
  15. package/dist/src/collection/head-commit.js +65 -0
  16. package/dist/src/collection/head-commit.js.map +1 -0
  17. package/dist/src/collection/index.d.ts +2 -0
  18. package/dist/src/collection/index.d.ts.map +1 -1
  19. package/dist/src/collection/index.js +2 -0
  20. package/dist/src/collection/index.js.map +1 -1
  21. package/dist/src/collection/segments.d.ts +77 -0
  22. package/dist/src/collection/segments.d.ts.map +1 -0
  23. package/dist/src/collection/segments.js +110 -0
  24. package/dist/src/collection/segments.js.map +1 -0
  25. package/dist/src/collection/struct.d.ts +156 -1
  26. package/dist/src/collection/struct.d.ts.map +1 -1
  27. package/dist/src/collection/struct.js +70 -0
  28. package/dist/src/collection/struct.js.map +1 -1
  29. package/dist/src/collection/write-attempts.d.ts +245 -0
  30. package/dist/src/collection/write-attempts.d.ts.map +1 -0
  31. package/dist/src/collection/write-attempts.js +439 -0
  32. package/dist/src/collection/write-attempts.js.map +1 -0
  33. package/dist/src/collections/tree/struct.d.ts +100 -17
  34. package/dist/src/collections/tree/struct.d.ts.map +1 -1
  35. package/dist/src/collections/tree/struct.js +38 -7
  36. package/dist/src/collections/tree/struct.js.map +1 -1
  37. package/dist/src/collections/tree/tree.d.ts +17 -5
  38. package/dist/src/collections/tree/tree.d.ts.map +1 -1
  39. package/dist/src/collections/tree/tree.js +112 -26
  40. package/dist/src/collections/tree/tree.js.map +1 -1
  41. package/dist/src/index.d.ts +2 -0
  42. package/dist/src/index.d.ts.map +1 -1
  43. package/dist/src/index.js +2 -0
  44. package/dist/src/index.js.map +1 -1
  45. package/dist/src/network/i-repo.d.ts +3 -0
  46. package/dist/src/network/i-repo.d.ts.map +1 -1
  47. package/dist/src/network/index.d.ts +3 -0
  48. package/dist/src/network/index.d.ts.map +1 -1
  49. package/dist/src/network/index.js +3 -0
  50. package/dist/src/network/index.js.map +1 -1
  51. package/dist/src/network/promise-shortfall-error.d.ts +40 -0
  52. package/dist/src/network/promise-shortfall-error.d.ts.map +1 -0
  53. package/dist/src/network/promise-shortfall-error.js +67 -0
  54. package/dist/src/network/promise-shortfall-error.js.map +1 -0
  55. package/dist/src/network/refuse-solo.d.ts +8 -0
  56. package/dist/src/network/refuse-solo.d.ts.map +1 -0
  57. package/dist/src/network/refuse-solo.js +8 -0
  58. package/dist/src/network/refuse-solo.js.map +1 -0
  59. package/dist/src/network/stale-failure.d.ts +20 -3
  60. package/dist/src/network/stale-failure.d.ts.map +1 -1
  61. package/dist/src/network/stale-failure.js +24 -3
  62. package/dist/src/network/stale-failure.js.map +1 -1
  63. package/dist/src/network/struct.d.ts +148 -2
  64. package/dist/src/network/struct.d.ts.map +1 -1
  65. package/dist/src/network/struct.js.map +1 -1
  66. package/dist/src/network/validity-rejected-error.d.ts +28 -0
  67. package/dist/src/network/validity-rejected-error.d.ts.map +1 -0
  68. package/dist/src/network/validity-rejected-error.js +51 -0
  69. package/dist/src/network/validity-rejected-error.js.map +1 -0
  70. package/dist/src/offline/entry.d.ts +72 -0
  71. package/dist/src/offline/entry.d.ts.map +1 -0
  72. package/dist/src/offline/entry.js +73 -0
  73. package/dist/src/offline/entry.js.map +1 -0
  74. package/dist/src/offline/index.d.ts +5 -0
  75. package/dist/src/offline/index.d.ts.map +1 -0
  76. package/dist/src/offline/index.js +5 -0
  77. package/dist/src/offline/index.js.map +1 -0
  78. package/dist/src/offline/journal.d.ts +61 -0
  79. package/dist/src/offline/journal.d.ts.map +1 -0
  80. package/dist/src/offline/journal.js +2 -0
  81. package/dist/src/offline/journal.js.map +1 -0
  82. package/dist/src/offline/queue.d.ts +484 -0
  83. package/dist/src/offline/queue.d.ts.map +1 -0
  84. package/dist/src/offline/queue.js +1236 -0
  85. package/dist/src/offline/queue.js.map +1 -0
  86. package/dist/src/offline/reachability.d.ts +25 -0
  87. package/dist/src/offline/reachability.d.ts.map +1 -0
  88. package/dist/src/offline/reachability.js +13 -0
  89. package/dist/src/offline/reachability.js.map +1 -0
  90. package/dist/src/offline/status.d.ts +148 -0
  91. package/dist/src/offline/status.d.ts.map +1 -0
  92. package/dist/src/offline/status.js +63 -0
  93. package/dist/src/offline/status.js.map +1 -0
  94. package/dist/src/offline/wake.d.ts +30 -0
  95. package/dist/src/offline/wake.d.ts.map +1 -0
  96. package/dist/src/offline/wake.js +68 -0
  97. package/dist/src/offline/wake.js.map +1 -0
  98. package/dist/src/testing/test-transactor.d.ts +29 -0
  99. package/dist/src/testing/test-transactor.d.ts.map +1 -1
  100. package/dist/src/testing/test-transactor.js +50 -0
  101. package/dist/src/testing/test-transactor.js.map +1 -1
  102. package/dist/src/transaction/commit-failure-class.d.ts +103 -0
  103. package/dist/src/transaction/commit-failure-class.d.ts.map +1 -0
  104. package/dist/src/transaction/commit-failure-class.js +96 -0
  105. package/dist/src/transaction/commit-failure-class.js.map +1 -0
  106. package/dist/src/transaction/coordinator.d.ts +165 -41
  107. package/dist/src/transaction/coordinator.d.ts.map +1 -1
  108. package/dist/src/transaction/coordinator.js +605 -300
  109. package/dist/src/transaction/coordinator.js.map +1 -1
  110. package/dist/src/transaction/entry-commit.d.ts +139 -0
  111. package/dist/src/transaction/entry-commit.d.ts.map +1 -0
  112. package/dist/src/transaction/entry-commit.js +199 -0
  113. package/dist/src/transaction/entry-commit.js.map +1 -0
  114. package/dist/src/transaction/index.d.ts +4 -1
  115. package/dist/src/transaction/index.d.ts.map +1 -1
  116. package/dist/src/transaction/index.js +1 -0
  117. package/dist/src/transaction/index.js.map +1 -1
  118. package/dist/src/transaction/transaction.d.ts +20 -0
  119. package/dist/src/transaction/transaction.d.ts.map +1 -1
  120. package/dist/src/transaction/validator.d.ts +7 -0
  121. package/dist/src/transaction/validator.d.ts.map +1 -1
  122. package/dist/src/transaction/validator.js +21 -12
  123. package/dist/src/transaction/validator.js.map +1 -1
  124. package/dist/src/transactor/network-transactor.d.ts +1 -0
  125. package/dist/src/transactor/network-transactor.d.ts.map +1 -1
  126. package/dist/src/transactor/network-transactor.js +61 -28
  127. package/dist/src/transactor/network-transactor.js.map +1 -1
  128. package/dist/src/transactor/transactor-source.d.ts +22 -11
  129. package/dist/src/transactor/transactor-source.d.ts.map +1 -1
  130. package/dist/src/transactor/transactor-source.js +9 -13
  131. package/dist/src/transactor/transactor-source.js.map +1 -1
  132. package/dist/src/utility/visit-every.d.ts +14 -0
  133. package/dist/src/utility/visit-every.d.ts.map +1 -0
  134. package/dist/src/utility/visit-every.js +27 -0
  135. package/dist/src/utility/visit-every.js.map +1 -0
  136. package/package.json +1 -1
  137. package/src/cluster/structs.ts +42 -7
  138. package/src/collection/action.ts +34 -0
  139. package/src/collection/collection.ts +1048 -543
  140. package/src/collection/head-commit.ts +148 -0
  141. package/src/collection/index.ts +2 -0
  142. package/src/collection/segments.ts +149 -0
  143. package/src/collection/struct.ts +183 -1
  144. package/src/collection/write-attempts.ts +506 -0
  145. package/src/collections/tree/struct.ts +97 -17
  146. package/src/collections/tree/tree.ts +125 -29
  147. package/src/index.ts +2 -0
  148. package/src/network/i-repo.ts +3 -0
  149. package/src/network/index.ts +3 -0
  150. package/src/network/promise-shortfall-error.ts +69 -0
  151. package/src/network/refuse-solo.ts +7 -0
  152. package/src/network/stale-failure.ts +27 -4
  153. package/src/network/struct.ts +154 -2
  154. package/src/network/validity-rejected-error.ts +55 -0
  155. package/src/offline/entry.ts +127 -0
  156. package/src/offline/index.ts +4 -0
  157. package/src/offline/journal.ts +60 -0
  158. package/src/offline/queue.ts +1342 -0
  159. package/src/offline/reachability.ts +32 -0
  160. package/src/offline/status.ts +183 -0
  161. package/src/offline/wake.ts +67 -0
  162. package/src/testing/test-transactor.ts +53 -0
  163. package/src/transaction/commit-failure-class.ts +133 -0
  164. package/src/transaction/coordinator.ts +696 -349
  165. package/src/transaction/entry-commit.ts +285 -0
  166. package/src/transaction/index.ts +4 -0
  167. package/src/transaction/transaction.ts +21 -0
  168. package/src/transaction/validator.ts +22 -12
  169. package/src/transactor/network-transactor.ts +62 -28
  170. package/src/transactor/transactor-source.ts +29 -13
  171. package/src/utility/visit-every.ts +25 -0
@@ -0,0 +1,110 @@
1
+ /**
2
+ * A collection's staged actions, in two parts: the sealed segments, one per queued entry that wrote
3
+ * the collection, oldest first, and the open segment the current transaction is staging into
4
+ * (docs/offline-sync.md §The segment model). The pure list operations live here; everything that
5
+ * touches the tracker or the collection latch stays on `Collection`.
6
+ */
7
+ export class SegmentList {
8
+ /** Sealed segments in queue order, oldest first (invariant 1). Private so every change goes
9
+ * through a method that bumps `version`; read it through {@link replayable}, {@link find},
10
+ * {@link head} and {@link entryIds}. */
11
+ sealed = [];
12
+ /** The open segment: what the current transaction has staged. */
13
+ open = [];
14
+ /** Bumped on every change to the sealed list — a seal, an unseal, an insert, a drop, a refusal
15
+ * recorded. Captured by a snapshot so a restore can tell whether the sealed segments it was taken
16
+ * over are still the ones in place (ticket `offline-sync-open-segment-snapshot`). Read and written
17
+ * only under the collection latch or from synchronous callers. */
18
+ version = 0;
19
+ /** Close the open segment into a sealed segment owned by `entryId`. Returns `false` and changes
20
+ * nothing — the version included — when the open segment is empty: an entry that staged nothing
21
+ * here owns no segment here. Throws when `entryId` is already sealed. */
22
+ seal(entryId) {
23
+ if (this.find(entryId) !== undefined) {
24
+ throw new Error(`entry ${entryId} is already sealed in this collection`);
25
+ }
26
+ if (this.open.length === 0) {
27
+ return false;
28
+ }
29
+ this.sealed.push({ entryId, actions: this.open });
30
+ this.open = [];
31
+ this.version++;
32
+ return true;
33
+ }
34
+ /** The exact inverse of {@link seal}: move the newest sealed segment's actions back into the open
35
+ * segment, for an enqueue whose journal write failed after sealing (`OfflineQueue.enqueue`).
36
+ * Requires the segment to be the NEWEST sealed one and the open segment to be empty — both true at
37
+ * that one call site, which has just sealed and staged nothing since — and throws otherwise, since
38
+ * putting an older segment's actions behind a newer one's would reorder what was staged. Bumps
39
+ * `version`: the sealed list changed, even though the tracker did not (the transforms are already
40
+ * what they were). */
41
+ unseal(entryId) {
42
+ const newest = this.sealed[this.sealed.length - 1];
43
+ if (newest === undefined || newest.entryId !== entryId) {
44
+ throw new Error(`entry ${entryId} is not the newest sealed segment (${newest?.entryId ?? 'nothing is sealed'}); only the newest can be unsealed`);
45
+ }
46
+ if (this.open.length > 0) {
47
+ throw new Error(`entry ${entryId} cannot be unsealed over a non-empty open segment`);
48
+ }
49
+ this.sealed.pop();
50
+ this.open = [...newest.actions];
51
+ this.version++;
52
+ }
53
+ /** Insert a sealed segment owned by `entryId` holding `actions`, ahead of the segment `before`
54
+ * names, or last when `before` is `undefined` — a segment put back from a journal after a restart
55
+ * (`Collection.restoreSealed`), which belongs wherever its entry sits in queue order. Throws when
56
+ * `entryId` is already sealed or `before` names no segment here, before anything changes. */
57
+ insert(entryId, actions, before) {
58
+ if (this.find(entryId) !== undefined) {
59
+ throw new Error(`entry ${entryId} is already sealed in this collection`);
60
+ }
61
+ const index = before === undefined ? this.sealed.length : this.sealed.findIndex(segment => segment.entryId === before);
62
+ if (index < 0) {
63
+ throw new Error(`entry ${before} is not sealed in this collection; cannot insert ${entryId} before it`);
64
+ }
65
+ this.sealed.splice(index, 0, { entryId, actions: [...actions] });
66
+ this.version++;
67
+ }
68
+ /** Remove the segment owned by `entryId`, wherever it sits. Throws for an unknown id. */
69
+ drop(entryId) {
70
+ const index = this.sealed.findIndex(segment => segment.entryId === entryId);
71
+ if (index < 0) {
72
+ throw new Error(`entry ${entryId} is not sealed in this collection`);
73
+ }
74
+ const [dropped] = this.sealed.splice(index, 1);
75
+ this.version++;
76
+ return dropped;
77
+ }
78
+ /** Record that a replay refused the segment owned by `entryId`, excluding it from later replays. */
79
+ refuse(entryId, error) {
80
+ const segment = this.find(entryId);
81
+ if (segment === undefined) {
82
+ throw new Error(`entry ${entryId} is not sealed in this collection`);
83
+ }
84
+ segment.refused = error;
85
+ this.version++;
86
+ }
87
+ find(entryId) {
88
+ return this.sealed.find(segment => segment.entryId === entryId);
89
+ }
90
+ /** The oldest sealed segment, if any. */
91
+ head() {
92
+ return this.sealed[0];
93
+ }
94
+ entryIds() {
95
+ return this.sealed.map(segment => segment.entryId);
96
+ }
97
+ /** Whether any segment is sealed, refused ones included. */
98
+ hasSealed() {
99
+ return this.sealed.length > 0;
100
+ }
101
+ /** The sealed segments a replay re-stages, in order: every one not refused. */
102
+ replayable() {
103
+ return this.sealed.filter(segment => segment.refused === undefined);
104
+ }
105
+ /** How many actions a replay re-stages: the replayable sealed segments' plus the open segment's. */
106
+ replayableCount() {
107
+ return this.replayable().reduce((count, segment) => count + segment.actions.length, this.open.length);
108
+ }
109
+ }
110
+ //# sourceMappingURL=segments.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"segments.js","sourceRoot":"","sources":["../../../src/collection/segments.ts"],"names":[],"mappings":"AA6BA;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IACvB;;4CAEwC;IACvB,MAAM,GAA6B,EAAE,CAAC;IACvD,iEAAiE;IACjE,IAAI,GAAsB,EAAE,CAAC;IAC7B;;;sEAGkE;IAClE,OAAO,GAAG,CAAC,CAAC;IAEZ;;6EAEyE;IACzE,IAAI,CAAC,OAAgB;QACpB,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,uCAAuC,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC;QACd,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QACf,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;0BAMsB;IACtB,MAAM,CAAC,OAAgB;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACnD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,sCAAsC,MAAM,EAAE,OAAO,IAAI,mBAAmB,oCAAoC,CAAC,CAAC;QACnJ,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,mDAAmD,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,EAAE,CAAC;IAChB,CAAC;IAED;;;iGAG6F;IAC7F,MAAM,CAAC,OAAgB,EAAE,OAAmC,EAAE,MAA2B;QACxF,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,uCAAuC,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;QACvH,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,oDAAoD,OAAO,YAAY,CAAC,CAAC;QACzG,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,OAAO,EAAE,CAAC;IAChB,CAAC;IAED,yFAAyF;IACzF,IAAI,CAAC,OAAgB;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;QAC5E,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,mCAAmC,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,OAAQ,CAAC;IACjB,CAAC;IAED,oGAAoG;IACpG,MAAM,CAAC,OAAgB,EAAE,KAAyB;QACjD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,SAAS,OAAO,mCAAmC,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,OAAO,EAAE,CAAC;IAChB,CAAC;IAED,IAAI,CAAC,OAAgB;QACpB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,yCAAyC;IACzC,IAAI;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,QAAQ;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,4DAA4D;IAC5D,SAAS;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,+EAA+E;IAC/E,UAAU;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;IACrE,CAAC;IAED,oGAAoG;IACpG,eAAe;QACd,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvG,CAAC;CACD"}
@@ -1,7 +1,136 @@
1
- import type { IBlock, BlockId, Action, WriteDurability } from "../index.js";
1
+ import type { IBlock, BlockId, Action, ActionId, Transforms, WriteDurability } from "../index.js";
2
2
  import type { IChainHeader } from "../chain/chain-nodes.js";
3
3
  import type { RandFn } from "../utility/backoff.js";
4
+ import type { EntryId } from "./segments.js";
5
+ import type { AlreadyAppliedTally } from "./action.js";
6
+ import type { BlockBaseRevs, BlockContentDigests } from "../network/struct.js";
4
7
  export type CollectionId = BlockId;
8
+ /**
9
+ * A handler's statement that an action cannot be applied over the committed state it is being
10
+ * replayed against — a uniqueness or lost-update check failed. Not a transport failure and never
11
+ * retryable: the action's staged writes are discarded (the handler runs inside an Atomic), and
12
+ * nothing downgrades it to a stale failure. `TreeGuardRefusedError` in
13
+ * `packages/db-core/src/collections/tree/struct.ts` is the tree's subclass, and carries the
14
+ * contract every refusal obeys.
15
+ *
16
+ * Lives here rather than beside the tree so the collection can recognise a refusal without
17
+ * importing the tree module (which imports the collection). Segment-aware replay
18
+ * (`Collection.replayActions`) treats a throw of this class from a SEALED segment as that
19
+ * segment's refusal and keeps going; from the open segment it propagates as it always has.
20
+ */
21
+ export declare class ActionRefusedError extends Error {
22
+ /** The collection whose handler refused the action. */
23
+ readonly collectionId: CollectionId;
24
+ constructor(
25
+ /** The collection whose handler refused the action. */
26
+ collectionId: CollectionId, message: string);
27
+ }
28
+ /** Why a sealed segment stood in the way of a commit (see {@link SealedSegmentsError}):
29
+ * - `whole-collection` — a whole-collection commit was asked for while a segment is sealed.
30
+ * - `not-head` — `commitHead` named a segment that is not the oldest sealed one.
31
+ * - `refused` — `commitHead` named a segment a replay has refused; the queue drops it instead.
32
+ * - `in-flight` — a head commit is on the network for the named segment, so neither a second
33
+ * `commitHead` nor a `dropSealed` of it can proceed. */
34
+ export type SealedSegmentsReason = 'whole-collection' | 'not-head' | 'refused' | 'in-flight';
35
+ /**
36
+ * Thrown by the whole-collection commit paths — {@link ICollection.sync},
37
+ * {@link ICollection.updateAndSync}, `Collection.actAndSync` and `Collection.getPendingActions`
38
+ * (the coordinator's append) — while the collection holds sealed segments. Those paths commit
39
+ * everything staged as ONE log entry under one action id; over sealed segments that would merge
40
+ * several queue entries into one, which the queue's identity rules forbid
41
+ * (docs/offline-sync.md §Identity across attempts). A sealed segment is committed on its own,
42
+ * through `Collection.commitHead`, whose own preconditions throw this class too, with a
43
+ * {@link reason} other than `whole-collection` (see {@link SealedSegmentsReason}).
44
+ *
45
+ * Nothing is unstaged or changed when this is thrown: every segment, sealed and open, is exactly
46
+ * as it was.
47
+ */
48
+ export declare class SealedSegmentsError extends Error {
49
+ readonly collectionId: CollectionId;
50
+ /** The sealed segments' entry ids, in order. */
51
+ readonly sealedEntries: EntryId[];
52
+ readonly reason: SealedSegmentsReason;
53
+ /** The entry a `commitHead` or `dropSealed` named, for every reason but `whole-collection`. */
54
+ readonly entryId?: EntryId | undefined;
55
+ constructor(collectionId: CollectionId,
56
+ /** The sealed segments' entry ids, in order. */
57
+ sealedEntries: EntryId[], reason?: SealedSegmentsReason,
58
+ /** The entry a `commitHead` or `dropSealed` named, for every reason but `whole-collection`. */
59
+ entryId?: EntryId | undefined);
60
+ }
61
+ /** Exactly what one write attempt sent to the transactor — enough to send the same thing again.
62
+ * Retained by `Collection.retainInFlightAttempt` so that a refresh which then finds this attempt's
63
+ * own log entry can land the blocks the attempt left behind, at the same action id and revision
64
+ * (see `Collection.completeOwnEntry`).
65
+ *
66
+ * Also the shape a caller RECORDS before an attempt is sent and hands back on a later cycle
67
+ * ({@link HeadCommitOptions.recordAttempt} and {@link HeadCommitOptions.resume};
68
+ * docs/offline-sync.md §Identity across attempts), so it must stay plain data — ids, numbers and the
69
+ * transforms as the wire carries them, nothing with object identity and no functions: the
70
+ * offline-sync journal serialises it as JSON. */
71
+ export type InFlightAttempt = {
72
+ /** The action id the attempt was sent under — the one every attempt of the write reuses, and
73
+ * the one a cycle that resumes from this record must run under. */
74
+ actionId: ActionId;
75
+ /** The revision the attempt's log entry was stamped with, and pended and committed at. */
76
+ rev: number;
77
+ /** Every transform the attempt pended — the log blocks included. The caller hands over a copy
78
+ * it will not mutate; the collection keeps it as given. */
79
+ transforms: Transforms;
80
+ /** The attempt's log tail block, committed first. */
81
+ tailId: BlockId;
82
+ /** The per-block content declarations the attempt's commit carried, if any. */
83
+ blockDigests?: BlockContentDigests;
84
+ /** The per-block bases the attempt's pend carried, if any (see `PendRequest.baseRevs`). Kept
85
+ * with the transforms because they describe them: a re-send of these operations must name the
86
+ * same bases they were computed against. */
87
+ baseRevs?: BlockBaseRevs;
88
+ };
89
+ /** What `Collection.commitHead` commits the head segment under, beside the retry bounds of
90
+ * {@link SyncOptions}. Both fields are the queue's (docs/offline-sync.md §Identity across
91
+ * attempts): the collection mints neither. */
92
+ export type HeadCommitOptions = SyncOptions & {
93
+ /** The action id the attempt cycle runs under. The queue mints it, and re-supplies the SAME id
94
+ * when it re-drives an entry whose earlier attempt may have landed, so the refresh that opens the
95
+ * cycle recognises that attempt's log entry as the write's own and finishes or consumes it
96
+ * instead of committing a second copy. */
97
+ actionId: ActionId;
98
+ /** The entry's local commit time, stamped on the log entry in place of the time
99
+ * `Collection.syncInternal` mints for a sync. Fixed per write, so every attempt appends the same
100
+ * entry (see "A write's log append is a fixed function of the write and the revision it is
101
+ * requesting" in docs/internals.md). */
102
+ timestamp: number;
103
+ /** The write-ahead hook: called with each attempt exactly as it is about to be sent — after it is
104
+ * built and BEFORE the collection latch is released for the network — and awaited under that
105
+ * latch. It is where the queue records the attempt's identity before sending it
106
+ * (docs/offline-sync.md §Identity across attempts) and, later, where the journal writes it. A
107
+ * throw aborts the cycle before anything is sent: it escapes `commitHead` unchanged, the handle
108
+ * closes, and every segment is exactly as it was. */
109
+ recordAttempt?: (attempt: InFlightAttempt) => Promise<void>;
110
+ /** The attempt an earlier cycle under the SAME `actionId` handed to `recordAttempt` and did not
111
+ * resolve — it must carry this `actionId`, and `openHeadCommit` throws before touching anything
112
+ * when it does not. Seeded as the retained attempt right after the action is marked in flight,
113
+ * so the cycle's opening refresh, finding that attempt's log entry with blocks missing, finishes
114
+ * it from these transforms (`Collection.completeOwnEntry`) instead of refusing it as torn with
115
+ * `transforms-not-held`. Without it a re-drive can recognise only an attempt that landed whole.
116
+ * The revision check still applies: an attempt recorded at a revision other than the entry's is
117
+ * refused as before. And when that refresh finds nothing new, this attempt is what the cycle
118
+ * re-sends, verbatim, while the next attempt would request its revision (`resumedAttempt`), since
119
+ * it may have landed on machines the refresh did not hear from. */
120
+ resume?: InFlightAttempt;
121
+ /** Called once, with what the head segment's actions accepted as already applied
122
+ * ({@link AlreadyAppliedTally}, as recorded on the segment by its last staging over the committed
123
+ * state), at the moment the segment is made durable and dropped: when the committed attempt is
124
+ * folded (`HeadCommitHandle.fold`), or when the cycle's refresh finds the entry's own log entry and
125
+ * consumes the head (`Collection.consumeHead`) — so a re-drive that finds its earlier attempt landed
126
+ * reports it too. Runs synchronously under the collection latch, like `onSealedRefused`, so it must
127
+ * not call a latched method of the collection; the queue's closure only records into a map. A throw
128
+ * out of it is logged, never raised: the commit is already durable. A hook rather than a widened
129
+ * return type because the partial-commit path reports the committed half through
130
+ * `CoordinatorPartialCommitError` and the refresh-consumed path through `RefreshReport`; one hook
131
+ * reaches all three. */
132
+ onCommittedHead?: (applied: AlreadyAppliedTally) => void;
133
+ };
5
134
  export type CollectionHeaderBlock = IBlock & Partial<IChainHeader>;
6
135
  /** A collection's committed tail: the log tail block its header names, and that block's latest
7
136
  * committed revision, which is the collection's (every commit touches the log tail). */
@@ -65,7 +194,33 @@ export interface SyncOptions {
65
194
  * {@link deadlineMs} is still checked first, so a sync that is both past its deadline and
66
195
  * stalled reports the deadline (as {@link SyncRetryExhaustedError}), not the stall. */
67
196
  maxStalledAttempts?: number;
197
+ /** Refuse to let this write be committed by a lone node — a coordinator whose cohort for the
198
+ * write is only itself — while that node knows of members of the cohort it could not reach, is
199
+ * still waiting to hear from a peer it was configured to join through, or could not route the
200
+ * write at all. A node that is genuinely alone (no absent member known, nothing awaited, routed to
201
+ * itself) still commits. The refusal is a promise shortfall (`PromiseShortfallError`, with
202
+ * `soloRefused` naming the reason), so the write stops and is classified `cohort-unreachable`.
203
+ * Rides on every send of the write's attempt cycle as `PendRequest.refuseSolo` and
204
+ * `CommitRequest.refuseSolo`. Default off: only the offline queue sets it (docs/offline-sync.md
205
+ * §When to submit: the reachability gate). A coordinator on a build that predates the field
206
+ * ignores it and commits alone as before. */
207
+ refuseSoloCommit?: boolean;
68
208
  }
209
+ /** What a write's attempt cycle carries besides its identity, recorded beside the in-flight mark
210
+ * (`Collection.beginInFlightAction`) so that every send of the cycle carries it: each attempt, and
211
+ * the re-send a refresh makes to finish a torn one (`Collection.completeOwnEntry`). */
212
+ export type InFlightCycle = {
213
+ /** {@link SyncOptions.refuseSoloCommit}, for this cycle. */
214
+ readonly refuseSolo?: boolean;
215
+ };
216
+ /** What `Collection.openHeadCommit` opens a head commit with besides its identity: the cycle's
217
+ * {@link InFlightCycle}, the attempt an earlier cycle under the same action id recorded and did not
218
+ * resolve ({@link HeadCommitOptions.resume}), and the committed-head hook
219
+ * ({@link HeadCommitOptions.onCommittedHead}). */
220
+ export type OpenHeadCommitOptions = InFlightCycle & {
221
+ readonly resume?: InFlightAttempt;
222
+ readonly onCommittedHead?: (applied: AlreadyAppliedTally) => void;
223
+ };
69
224
  /** Thrown by {@link ICollection.sync} / {@link ICollection.updateAndSync} when the retry budget
70
225
  * (attempt count or deadline) is exhausted while the transactor keeps returning stale failures.
71
226
  * Catchable so callers can surface a clear "gave up syncing" condition instead of hanging.
@@ -1 +1 @@
1
- {"version":3,"file":"struct.d.ts","sourceRoot":"","sources":["../../../src/collection/struct.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC;AAEnC,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAEnE;wFACwF;AACxF,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,4FAA4F;AAC5F,MAAM,MAAM,kBAAkB,GAAG;IAChC,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B;sDACkD;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF;qGACqG;AACrG,MAAM,MAAM,mBAAmB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAE/B;;+EAE+E;AAC/E,MAAM,WAAW,WAAW;IAC3B;;;qBAGiB;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;sFACkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;6EAIyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;iGAC6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;4BAEwB;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;2FACuF;IACvF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;2FAYuF;IACvF,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;sEAOsE;AACtE,qBAAa,uBAAwB,SAAQ,KAAK;IAEhD,QAAQ,CAAC,YAAY,EAAE,YAAY;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM;IAC5B;;8FAE0F;IAC1F,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;gBAN3C,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,YAAA;IAC5B;;8FAE0F;IACjF,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,YAAA;CAOrD;AAED;;;;;;;;;;;;;;;;;sBAiBsB;AACtB,qBAAa,wBAAyB,SAAQ,uBAAuB;IAQnE,0DAA0D;IAC1D,QAAQ,CAAC,YAAY,EAAE,MAAM;IAC7B;4BACwB;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAXrC,0FAA0F;IAC1F,SAAiB,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;gBAG3D,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAC1C,0DAA0D;IACjD,YAAY,EAAE,MAAM;IAC7B;4BACwB;IACf,OAAO,EAAE,MAAM,GAAG,SAAS,EACpC,UAAU,CAAC,EAAE,MAAM;CAYpB;AAED;;;;;;;;;;;;;yEAayE;AACzE,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GAAG,oBAAoB,GAAG,qBAAqB,CAAC;AAErG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAqCmB;AACnB,qBAAa,eAAgB,SAAQ,KAAK;IAExC,QAAQ,CAAC,YAAY,EAAE,YAAY;IACnC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,4FAA4F;IAC5F,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE;IAC5B,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,gBAAgB;IACjC;6DACyD;IACzD,QAAQ,CAAC,KAAK,EAAE,OAAO;IACvB,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB;mDAC+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;gBAhB3C,YAAY,EAAE,YAAY;IACnC,yCAAyC;IAChC,QAAQ,EAAE,MAAM;IACzB,4FAA4F;IACnF,GAAG,EAAE,MAAM;IACpB,uEAAuE;IAC9D,QAAQ,EAAE,OAAO,EAAE;IAC5B,6FAA6F;IACpF,MAAM,EAAE,gBAAgB;IACjC;6DACyD;IAChD,KAAK,EAAE,OAAO;IACvB,oFAAoF;IAC3E,MAAM,EAAE,MAAM;IACvB;mDAC+C;IACtC,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,YAAA;CAWrD;AAED;;;;;;;;;;;;;;;;;;;gGAmBgG;AAChG,qBAAa,6BAA8B,SAAQ,KAAK;IAEtD,QAAQ,CAAC,YAAY,EAAE,YAAY;IACnC,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,MAAM;gBAFf,YAAY,EAAE,YAAY;IACnC,yFAAyF;IAChF,OAAO,EAAE,MAAM;CAMzB;AAED,MAAM,WAAW,WAAW,CAAC,OAAO;IACnC,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,GAAG,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB;;;6FAGyF;IACzF,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IAClE,wDAAwD;IACxD,aAAa,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IAC3E,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;CACrE;AAED,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG;IACnD,IAAI,EAAE,QAAQ,CAAC;CACf,CAAC"}
1
+ {"version":3,"file":"struct.d.ts","sourceRoot":"","sources":["../../../src/collection/struct.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,73 @@
1
+ /**
2
+ * A handler's statement that an action cannot be applied over the committed state it is being
3
+ * replayed against — a uniqueness or lost-update check failed. Not a transport failure and never
4
+ * retryable: the action's staged writes are discarded (the handler runs inside an Atomic), and
5
+ * nothing downgrades it to a stale failure. `TreeGuardRefusedError` in
6
+ * `packages/db-core/src/collections/tree/struct.ts` is the tree's subclass, and carries the
7
+ * contract every refusal obeys.
8
+ *
9
+ * Lives here rather than beside the tree so the collection can recognise a refusal without
10
+ * importing the tree module (which imports the collection). Segment-aware replay
11
+ * (`Collection.replayActions`) treats a throw of this class from a SEALED segment as that
12
+ * segment's refusal and keeps going; from the open segment it propagates as it always has.
13
+ */
14
+ export class ActionRefusedError extends Error {
15
+ collectionId;
16
+ constructor(
17
+ /** The collection whose handler refused the action. */
18
+ collectionId, message) {
19
+ super(message);
20
+ this.collectionId = collectionId;
21
+ this.name = 'ActionRefusedError';
22
+ }
23
+ }
24
+ /**
25
+ * Thrown by the whole-collection commit paths — {@link ICollection.sync},
26
+ * {@link ICollection.updateAndSync}, `Collection.actAndSync` and `Collection.getPendingActions`
27
+ * (the coordinator's append) — while the collection holds sealed segments. Those paths commit
28
+ * everything staged as ONE log entry under one action id; over sealed segments that would merge
29
+ * several queue entries into one, which the queue's identity rules forbid
30
+ * (docs/offline-sync.md §Identity across attempts). A sealed segment is committed on its own,
31
+ * through `Collection.commitHead`, whose own preconditions throw this class too, with a
32
+ * {@link reason} other than `whole-collection` (see {@link SealedSegmentsReason}).
33
+ *
34
+ * Nothing is unstaged or changed when this is thrown: every segment, sealed and open, is exactly
35
+ * as it was.
36
+ */
37
+ export class SealedSegmentsError extends Error {
38
+ collectionId;
39
+ sealedEntries;
40
+ reason;
41
+ entryId;
42
+ constructor(collectionId,
43
+ /** The sealed segments' entry ids, in order. */
44
+ sealedEntries, reason = 'whole-collection',
45
+ /** The entry a `commitHead` or `dropSealed` named, for every reason but `whole-collection`. */
46
+ entryId) {
47
+ super(sealedSegmentsMessage(collectionId, sealedEntries, reason, entryId));
48
+ this.collectionId = collectionId;
49
+ this.sealedEntries = sealedEntries;
50
+ this.reason = reason;
51
+ this.entryId = entryId;
52
+ this.name = 'SealedSegmentsError';
53
+ }
54
+ }
55
+ function sealedSegmentsMessage(collectionId, sealedEntries, reason, entryId) {
56
+ const listed = sealedEntries.length === 0 ? 'nothing' : sealedEntries.join(', ');
57
+ switch (reason) {
58
+ case 'whole-collection':
59
+ return `collection ${collectionId} holds sealed segment(s) ${listed}; `
60
+ + `a whole-collection commit would merge them into one log entry — commit the head segment instead`;
61
+ case 'not-head':
62
+ return `collection ${collectionId}: entry ${entryId} is not the head sealed segment (sealed: ${listed}); `
63
+ + `only the oldest sealed segment can be committed`;
64
+ case 'refused':
65
+ return `collection ${collectionId}: entry ${entryId} carries a recorded refusal; `
66
+ + `a refused segment is dropped, never committed`;
67
+ case 'in-flight':
68
+ return `collection ${collectionId}: a head commit of entry ${entryId} is in flight on this instance`;
69
+ }
70
+ }
1
71
  /** Thrown by {@link ICollection.sync} / {@link ICollection.updateAndSync} when the retry budget
2
72
  * (attempt count or deadline) is exhausted while the transactor keeps returning stale failures.
3
73
  * Catchable so callers can surface a clear "gave up syncing" condition instead of hanging.
@@ -1 +1 @@
1
- {"version":3,"file":"struct.js","sourceRoot":"","sources":["../../../src/collection/struct.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"struct.js","sourceRoot":"","sources":["../../../src/collection/struct.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGlC;IAFV;IACC,uDAAuD;IAC9C,YAA0B,EACnC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,iBAAY,GAAZ,YAAY,CAAc;QAInC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAClC,CAAC;CACD;AAUD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAEnC;IAEA;IACA;IAEA;IANV,YACU,YAA0B;IACnC,gDAAgD;IACvC,aAAwB,EACxB,SAA+B,kBAAkB;IAC1D,+FAA+F;IACtF,OAAiB;QAE1B,KAAK,CAAC,qBAAqB,CAAC,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAPlE,iBAAY,GAAZ,YAAY,CAAc;QAE1B,kBAAa,GAAb,aAAa,CAAW;QACxB,WAAM,GAAN,MAAM,CAA2C;QAEjD,YAAO,GAAP,OAAO,CAAU;QAG1B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,CAAC;CACD;AAED,SAAS,qBAAqB,CAAC,YAA0B,EAAE,aAAwB,EAAE,MAA4B,EAAE,OAA4B;IAC9I,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjF,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,kBAAkB;YACtB,OAAO,cAAc,YAAY,4BAA4B,MAAM,IAAI;kBACpE,iGAAiG,CAAC;QACtG,KAAK,UAAU;YACd,OAAO,cAAc,YAAY,WAAW,OAAO,4CAA4C,MAAM,KAAK;kBACvG,iDAAiD,CAAC;QACtD,KAAK,SAAS;YACb,OAAO,cAAc,YAAY,WAAW,OAAO,+BAA+B;kBAC/E,+CAA+C,CAAC;QACpD,KAAK,WAAW;YACf,OAAO,cAAc,YAAY,4BAA4B,OAAO,gCAAgC,CAAC;IACvG,CAAC;AACF,CAAC;AAyKD;;;;;;;sEAOsE;AACtE,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAEvC;IACA;IACA;IAIA;IAPV,YACU,YAA0B,EAC1B,QAAgB,EAChB,UAAmB;IAC5B;;8FAE0F;IACjF,OAA2C;QAEpD,KAAK,CAAC,uBAAuB,YAAY,cAAc,QAAQ,UAAU;YACxE,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,OAAO,CAAC,OAAO,WAAW,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAVvE,iBAAY,GAAZ,YAAY,CAAc;QAC1B,aAAQ,GAAR,QAAQ,CAAQ;QAChB,eAAU,GAAV,UAAU,CAAS;QAInB,YAAO,GAAP,OAAO,CAAoC;QAKpD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACvC,CAAC;CACD;AAED;;;;;;;;;;;;;;;;;sBAiBsB;AACtB,MAAM,OAAO,wBAAyB,SAAQ,uBAAuB;IAS1D;IAGA;IARV,YACC,YAA0B,EAC1B,QAAgB,EAChB,OAA0C;IAC1C,0DAA0D;IACjD,YAAoB;IAC7B;4BACwB;IACf,OAA2B,EACpC,UAAmB;QAEnB,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAN1C,iBAAY,GAAZ,YAAY,CAAQ;QAGpB,YAAO,GAAP,OAAO,CAAoB;QAIpC,yFAAyF;QACzF,uFAAuF;QACvF,IAAI,CAAC,OAAO,GAAG,uBAAuB,YAAY,kBAAkB,QAAQ,aAAa;cACtF,yBAAyB,OAAO,IAAI,MAAM,0BAA0B,YAAY,IAAI;cACpF,aAAa,OAAO,CAAC,OAAO,kCAAkC,OAAO,CAAC,GAAG,OAAO;cAChF,kCAAkC;cAClC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACxC,CAAC;CACD;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAqCmB;AACnB,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAE/B;IAEA;IAEA;IAEA;IAEA;IAGA;IAEA;IAGA;IAjBV,YACU,YAA0B;IACnC,yCAAyC;IAChC,QAAgB;IACzB,4FAA4F;IACnF,GAAW;IACpB,uEAAuE;IAC9D,QAAmB;IAC5B,6FAA6F;IACpF,MAAwB;IACjC;6DACyD;IAChD,KAAc;IACvB,oFAAoF;IAC3E,MAAc;IACvB;mDAC+C;IACtC,OAA2C;QAEpD,KAAK,CAAC,cAAc,YAAY,YAAY,QAAQ,mBAAmB,GAAG,6BAA6B;cACpG,gBAAgB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,WAAW,qDAAqD;cACvG,aAAa,MAAM,EAAE;cACrB,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,OAAO,cAAc,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;cACvE,CAAC,KAAK;gBACP,CAAC,CAAC,uEAAuE;gBACzE,CAAC,CAAC,+FAA+F,CAAC,CAAC,CAAC;QAxB7F,iBAAY,GAAZ,YAAY,CAAc;QAE1B,aAAQ,GAAR,QAAQ,CAAQ;QAEhB,QAAG,GAAH,GAAG,CAAQ;QAEX,aAAQ,GAAR,QAAQ,CAAW;QAEnB,WAAM,GAAN,MAAM,CAAkB;QAGxB,UAAK,GAAL,KAAK,CAAS;QAEd,WAAM,GAAN,MAAM,CAAQ;QAGd,YAAO,GAAP,OAAO,CAAoC;QASpD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAC/B,CAAC;CACD;AAED;;;;;;;;;;;;;;;;;;;gGAmBgG;AAChG,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAE7C;IAEA;IAHV,YACU,YAA0B;IACnC,yFAAyF;IAChF,OAAe;QAExB,KAAK,CAAC,cAAc,YAAY,6BAA6B,OAAO,yBAAyB;cAC1F,iFAAiF,CAAC,CAAC;QAL7E,iBAAY,GAAZ,YAAY,CAAc;QAE1B,YAAO,GAAP,OAAO,CAAQ;QAIxB,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC7C,CAAC;CACD"}