@optimystic/db-core 1.5.0 → 1.6.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 (157) hide show
  1. package/README.md +336 -336
  2. package/dist/src/cluster/structs.d.ts +37 -0
  3. package/dist/src/cluster/structs.d.ts.map +1 -1
  4. package/dist/src/cluster/structs.js +13 -0
  5. package/dist/src/cluster/structs.js.map +1 -1
  6. package/dist/src/collection/collection.d.ts +44 -4
  7. package/dist/src/collection/collection.d.ts.map +1 -1
  8. package/dist/src/collection/collection.js +95 -14
  9. package/dist/src/collection/collection.js.map +1 -1
  10. package/dist/src/log/log.d.ts +41 -8
  11. package/dist/src/log/log.d.ts.map +1 -1
  12. package/dist/src/log/log.js +15 -10
  13. package/dist/src/log/log.js.map +1 -1
  14. package/dist/src/testing/test-transactor.d.ts +36 -0
  15. package/dist/src/testing/test-transactor.d.ts.map +1 -1
  16. package/dist/src/testing/test-transactor.js +49 -0
  17. package/dist/src/testing/test-transactor.js.map +1 -1
  18. package/dist/src/transaction/coordinator.d.ts.map +1 -1
  19. package/dist/src/transaction/coordinator.js +26 -9
  20. package/dist/src/transaction/coordinator.js.map +1 -1
  21. package/package.json +1 -1
  22. package/src/blocks/block-store.ts +31 -31
  23. package/src/blocks/block-types.ts +11 -11
  24. package/src/blocks/index.ts +5 -5
  25. package/src/blocks/structs.ts +17 -17
  26. package/src/btree/btree.ts +872 -872
  27. package/src/btree/independent-trunk.ts +53 -53
  28. package/src/btree/index.ts +5 -5
  29. package/src/btree/key-range.ts +15 -15
  30. package/src/btree/keyset.ts +6 -6
  31. package/src/btree/nodes.ts +25 -25
  32. package/src/btree/path.ts +37 -37
  33. package/src/btree/tree-block.ts +11 -11
  34. package/src/btree/trunk.ts +14 -14
  35. package/src/chain/chain-nodes.ts +26 -26
  36. package/src/chain/chain.ts +349 -349
  37. package/src/chain/index.ts +3 -3
  38. package/src/cluster/i-cluster.ts +6 -6
  39. package/src/cluster/index.ts +3 -3
  40. package/src/cluster/structs.ts +38 -0
  41. package/src/cohort-topic/addressing.ts +120 -120
  42. package/src/cohort-topic/antidos/bootstrap-evidence.ts +106 -106
  43. package/src/cohort-topic/antidos/index.ts +5 -5
  44. package/src/cohort-topic/antidos/rate-limiter.ts +210 -210
  45. package/src/cohort-topic/antidos/replay-guard.ts +146 -146
  46. package/src/cohort-topic/antidos/topic-budget.ts +160 -160
  47. package/src/cohort-topic/antiflood/index.ts +2 -2
  48. package/src/cohort-topic/antiflood/invariants.ts +108 -108
  49. package/src/cohort-topic/antiflood/jitter.ts +117 -117
  50. package/src/cohort-topic/coldstart.ts +237 -237
  51. package/src/cohort-topic/dmax.ts +88 -88
  52. package/src/cohort-topic/gossip/bus.ts +254 -254
  53. package/src/cohort-topic/gossip/index.ts +3 -3
  54. package/src/cohort-topic/gossip/records.ts +45 -45
  55. package/src/cohort-topic/gossip/view.ts +91 -91
  56. package/src/cohort-topic/index.ts +20 -20
  57. package/src/cohort-topic/load/barometer.ts +134 -134
  58. package/src/cohort-topic/load/index.ts +1 -1
  59. package/src/cohort-topic/member-engine.ts +430 -430
  60. package/src/cohort-topic/membership/index.ts +3 -3
  61. package/src/cohort-topic/membership/publisher.ts +163 -163
  62. package/src/cohort-topic/membership/source.ts +41 -41
  63. package/src/cohort-topic/ports.ts +157 -157
  64. package/src/cohort-topic/promotion.ts +477 -477
  65. package/src/cohort-topic/registration/bytes.ts +37 -37
  66. package/src/cohort-topic/registration/handoff.ts +154 -154
  67. package/src/cohort-topic/registration/index.ts +6 -6
  68. package/src/cohort-topic/registration/renewal.ts +495 -495
  69. package/src/cohort-topic/registration/sharding.ts +61 -61
  70. package/src/cohort-topic/registration/store.ts +81 -81
  71. package/src/cohort-topic/registration/types.ts +91 -91
  72. package/src/cohort-topic/ring-hash.ts +50 -50
  73. package/src/cohort-topic/service.ts +416 -416
  74. package/src/cohort-topic/sig/index.ts +2 -2
  75. package/src/cohort-topic/sig/payloads.ts +59 -59
  76. package/src/cohort-topic/sig/threshold.ts +64 -64
  77. package/src/cohort-topic/tiers.ts +74 -74
  78. package/src/cohort-topic/traffic.ts +233 -233
  79. package/src/cohort-topic/walk.ts +326 -326
  80. package/src/cohort-topic/willingness.ts +237 -237
  81. package/src/cohort-topic/wire/index.ts +18 -18
  82. package/src/cohort-topic/wire/payloads.ts +126 -126
  83. package/src/collection/action.ts +48 -48
  84. package/src/collection/collection-type-registry.ts +37 -37
  85. package/src/collection/collection.ts +2203 -2118
  86. package/src/collection/index.ts +4 -4
  87. package/src/collections/diary/index.ts +2 -2
  88. package/src/collections/diary/struct.ts +3 -3
  89. package/src/collections/index.ts +2 -2
  90. package/src/collections/tree/collection-trunk.ts +25 -25
  91. package/src/collections/tree/index.ts +2 -2
  92. package/src/collections/tree/readme.md +55 -55
  93. package/src/log/index.ts +2 -2
  94. package/src/log/log.ts +304 -268
  95. package/src/log/struct.ts +165 -165
  96. package/src/matchmaking/capability-filter.ts +45 -45
  97. package/src/matchmaking/config.ts +98 -98
  98. package/src/matchmaking/index.ts +21 -21
  99. package/src/matchmaking/multi-cohort-seeker.ts +234 -234
  100. package/src/matchmaking/provider.ts +123 -123
  101. package/src/matchmaking/query-eval.ts +105 -105
  102. package/src/matchmaking/seeker-walk.ts +127 -127
  103. package/src/matchmaking/seeker.ts +86 -86
  104. package/src/matchmaking/topic-anchor.ts +90 -90
  105. package/src/matchmaking/voting-quorum.ts +394 -394
  106. package/src/network/i-peer-network.ts +25 -25
  107. package/src/network/repo-protocol.ts +13 -13
  108. package/src/network/types.ts +37 -37
  109. package/src/reactivity/backfill.ts +220 -220
  110. package/src/reactivity/backpressure.ts +191 -191
  111. package/src/reactivity/checkpoint.ts +308 -308
  112. package/src/reactivity/config.ts +172 -172
  113. package/src/reactivity/dedupe.ts +132 -132
  114. package/src/reactivity/forwarder.ts +87 -87
  115. package/src/reactivity/index.ts +34 -34
  116. package/src/reactivity/notification.ts +123 -123
  117. package/src/reactivity/policy.ts +79 -79
  118. package/src/reactivity/push-state.ts +310 -310
  119. package/src/reactivity/recover.ts +153 -153
  120. package/src/reactivity/replay-buffer.ts +141 -141
  121. package/src/reactivity/resume.ts +549 -549
  122. package/src/reactivity/rotation.ts +415 -415
  123. package/src/reactivity/subscriber.ts +132 -132
  124. package/src/reactivity/subscription.ts +66 -66
  125. package/src/reactivity/topic-anchor.ts +71 -71
  126. package/src/reactivity/verify.ts +73 -73
  127. package/src/reactivity/wire-validate.ts +13 -13
  128. package/src/testing/async-wait.ts +65 -65
  129. package/src/testing/index.ts +2 -2
  130. package/src/testing/test-transactor.ts +62 -0
  131. package/src/transaction/actions-engine.ts +68 -68
  132. package/src/transaction/coordinator.ts +28 -11
  133. package/src/transaction/index.ts +52 -52
  134. package/src/transaction/operations-hash.ts +196 -196
  135. package/src/transaction/read-dependency-collector.ts +78 -78
  136. package/src/transaction/session.ts +238 -238
  137. package/src/transaction/transaction.ts +442 -442
  138. package/src/transaction/validator.ts +197 -197
  139. package/src/transactor/block-floors.ts +126 -126
  140. package/src/transactor/index.ts +6 -6
  141. package/src/transactor/network-transactor.ts +1545 -1545
  142. package/src/transform/atomic-proxy.ts +92 -92
  143. package/src/transform/cache-source.ts +370 -370
  144. package/src/transform/helpers.ts +164 -164
  145. package/src/transform/index.ts +7 -7
  146. package/src/transform/struct.ts +21 -21
  147. package/src/utility/actor.ts +62 -62
  148. package/src/utility/backoff.ts +95 -95
  149. package/src/utility/batch-coordinator.ts +191 -191
  150. package/src/utility/ensured.ts +32 -32
  151. package/src/utility/groupby.ts +18 -18
  152. package/src/utility/hash-string.ts +14 -14
  153. package/src/utility/is-record-empty.ts +5 -5
  154. package/src/utility/latches.ts +42 -42
  155. package/src/utility/lru-map.ts +60 -60
  156. package/src/utility/nameof.ts +7 -7
  157. package/src/utility/pending.ts +43 -43
@@ -1,79 +1,79 @@
1
- /**
2
- * Reactivity — per-cohort Edge/Core policy (`docs/reactivity.md` §Per-cohort policy).
3
- *
4
- * Reactivity is **T3 (luxury)** at the cohort-topic layer. Two consequences are enforced here, the
5
- * authoritative home for the reactivity producer-side policy:
6
- *
7
- * 1. **Edge nodes never serve as reactivity forwarders** — only as subscribers. A T3 *consumer* is fine
8
- * on Edge (a phone wants notifications); a T3 *producer* is off in the Edge profile. The willingness
9
- * check ({@link import("../cohort-topic/willingness.js")}) already declines T3 admission on an Edge
10
- * node because `edgeProfile().willingTiers` excludes {@link Tier.T3}; this module adds the *reactivity*
11
- * gate at the point a node decides whether to instantiate a {@link PushState} / become a forwarder, so
12
- * the decision is explicit and testable rather than implicit in cohort admission.
13
- * 2. **`delta_max` is Edge 0 / Core 4096** — the authoritative plumbing the origination ticket only
14
- * *consumed*. Re-exported here from {@link import("./config.js")} so the policy surface is singular.
15
- *
16
- * The per-cohort topic budget (`topics_max`) bounds the collections a cohort serves; reactivity needs no
17
- * admission policy beyond the cohort-topic default, so it is not re-implemented here.
18
- */
19
-
20
- import { Tier, type NodeProfile } from "../cohort-topic/tiers.js";
21
- import { deltaMaxForProfile } from "./config.js";
22
- import { PushState, type PushStateInit } from "./push-state.js";
23
-
24
- /**
25
- * Whether a node with `profile` may serve as a reactivity **forwarder** (T3 producer). `true` only when
26
- * the profile is willing to forward T3 — Core by default, an operator-narrowable Core, never Edge.
27
- * Equivalent to `profile.willingTiers.has(Tier.T3)`: Edge's willing set is `{T0, T1}`, so this is `false`
28
- * on every Edge node and on a Core node an operator has restricted away from T3.
29
- */
30
- export function mayServeAsReactivityForwarder(profile: NodeProfile): boolean {
31
- return profile.willingTiers.has(Tier.T3);
32
- }
33
-
34
- /** A subscriber-only node (Edge, or a Core narrowed off T3) attempted to instantiate a reactivity forwarder. */
35
- export class ReactivityForwarderForbiddenError extends Error {
36
- constructor(readonly profileKind: NodeProfile["kind"]) {
37
- super(`reactivity: a ${profileKind} node that does not forward T3 cannot instantiate a forwarder (subscriber-only)`);
38
- this.name = "ReactivityForwarderForbiddenError";
39
- }
40
- }
41
-
42
- /**
43
- * Instantiate a forwarder {@link PushState} **only if** `profile` may forward T3. Returns `undefined` for a
44
- * subscriber-only node (Edge, or a Core narrowed off T3) — the caller does not become a forwarder, leaving
45
- * it a pure subscriber. This is the explicit gate the §Per-cohort policy "Edge nodes never serve as
46
- * reactivity forwarders" rule names; a node consults it before allocating any per-collection push state.
47
- */
48
- export function instantiateForwarderPushState(profile: NodeProfile, init: PushStateInit): PushState | undefined {
49
- return mayServeAsReactivityForwarder(profile) ? new PushState(init) : undefined;
50
- }
51
-
52
- /**
53
- * Like {@link instantiateForwarderPushState} but **throws** {@link ReactivityForwarderForbiddenError} on a
54
- * subscriber-only node, for call sites that treat an Edge forwarder attempt as a programming error rather
55
- * than a silent no-op (e.g. a host wiring that should never route forwarder duty to an Edge node).
56
- */
57
- export function requireForwarderPushState(profile: NodeProfile, init: PushStateInit): PushState {
58
- if (!mayServeAsReactivityForwarder(profile)) {
59
- throw new ReactivityForwarderForbiddenError(profile.kind);
60
- }
61
- return new PushState(init);
62
- }
63
-
64
- /**
65
- * The effective reactivity producer policy for a node profile: whether it may forward, and its `delta_max`
66
- * budget (Edge 0 — reject inbound `delta`, re-read the chain; Core 4096). The single struct a host reads to
67
- * configure reactivity on a node (`docs/reactivity.md` §Per-cohort policy, §Delta payloads).
68
- */
69
- export interface ReactivityNodePolicy {
70
- /** Whether this node may instantiate a forwarder / become a T3 producer. */
71
- readonly mayForward: boolean;
72
- /** `delta_max` (bytes): Core 4096, Edge 0 (declines deltas). */
73
- readonly deltaMaxBytes: number;
74
- }
75
-
76
- /** Resolve the {@link ReactivityNodePolicy} for a profile (forwarder eligibility + `delta_max`). */
77
- export function reactivityNodePolicy(profile: NodeProfile): ReactivityNodePolicy {
78
- return { mayForward: mayServeAsReactivityForwarder(profile), deltaMaxBytes: deltaMaxForProfile(profile) };
79
- }
1
+ /**
2
+ * Reactivity — per-cohort Edge/Core policy (`docs/reactivity.md` §Per-cohort policy).
3
+ *
4
+ * Reactivity is **T3 (luxury)** at the cohort-topic layer. Two consequences are enforced here, the
5
+ * authoritative home for the reactivity producer-side policy:
6
+ *
7
+ * 1. **Edge nodes never serve as reactivity forwarders** — only as subscribers. A T3 *consumer* is fine
8
+ * on Edge (a phone wants notifications); a T3 *producer* is off in the Edge profile. The willingness
9
+ * check ({@link import("../cohort-topic/willingness.js")}) already declines T3 admission on an Edge
10
+ * node because `edgeProfile().willingTiers` excludes {@link Tier.T3}; this module adds the *reactivity*
11
+ * gate at the point a node decides whether to instantiate a {@link PushState} / become a forwarder, so
12
+ * the decision is explicit and testable rather than implicit in cohort admission.
13
+ * 2. **`delta_max` is Edge 0 / Core 4096** — the authoritative plumbing the origination ticket only
14
+ * *consumed*. Re-exported here from {@link import("./config.js")} so the policy surface is singular.
15
+ *
16
+ * The per-cohort topic budget (`topics_max`) bounds the collections a cohort serves; reactivity needs no
17
+ * admission policy beyond the cohort-topic default, so it is not re-implemented here.
18
+ */
19
+
20
+ import { Tier, type NodeProfile } from "../cohort-topic/tiers.js";
21
+ import { deltaMaxForProfile } from "./config.js";
22
+ import { PushState, type PushStateInit } from "./push-state.js";
23
+
24
+ /**
25
+ * Whether a node with `profile` may serve as a reactivity **forwarder** (T3 producer). `true` only when
26
+ * the profile is willing to forward T3 — Core by default, an operator-narrowable Core, never Edge.
27
+ * Equivalent to `profile.willingTiers.has(Tier.T3)`: Edge's willing set is `{T0, T1}`, so this is `false`
28
+ * on every Edge node and on a Core node an operator has restricted away from T3.
29
+ */
30
+ export function mayServeAsReactivityForwarder(profile: NodeProfile): boolean {
31
+ return profile.willingTiers.has(Tier.T3);
32
+ }
33
+
34
+ /** A subscriber-only node (Edge, or a Core narrowed off T3) attempted to instantiate a reactivity forwarder. */
35
+ export class ReactivityForwarderForbiddenError extends Error {
36
+ constructor(readonly profileKind: NodeProfile["kind"]) {
37
+ super(`reactivity: a ${profileKind} node that does not forward T3 cannot instantiate a forwarder (subscriber-only)`);
38
+ this.name = "ReactivityForwarderForbiddenError";
39
+ }
40
+ }
41
+
42
+ /**
43
+ * Instantiate a forwarder {@link PushState} **only if** `profile` may forward T3. Returns `undefined` for a
44
+ * subscriber-only node (Edge, or a Core narrowed off T3) — the caller does not become a forwarder, leaving
45
+ * it a pure subscriber. This is the explicit gate the §Per-cohort policy "Edge nodes never serve as
46
+ * reactivity forwarders" rule names; a node consults it before allocating any per-collection push state.
47
+ */
48
+ export function instantiateForwarderPushState(profile: NodeProfile, init: PushStateInit): PushState | undefined {
49
+ return mayServeAsReactivityForwarder(profile) ? new PushState(init) : undefined;
50
+ }
51
+
52
+ /**
53
+ * Like {@link instantiateForwarderPushState} but **throws** {@link ReactivityForwarderForbiddenError} on a
54
+ * subscriber-only node, for call sites that treat an Edge forwarder attempt as a programming error rather
55
+ * than a silent no-op (e.g. a host wiring that should never route forwarder duty to an Edge node).
56
+ */
57
+ export function requireForwarderPushState(profile: NodeProfile, init: PushStateInit): PushState {
58
+ if (!mayServeAsReactivityForwarder(profile)) {
59
+ throw new ReactivityForwarderForbiddenError(profile.kind);
60
+ }
61
+ return new PushState(init);
62
+ }
63
+
64
+ /**
65
+ * The effective reactivity producer policy for a node profile: whether it may forward, and its `delta_max`
66
+ * budget (Edge 0 — reject inbound `delta`, re-read the chain; Core 4096). The single struct a host reads to
67
+ * configure reactivity on a node (`docs/reactivity.md` §Per-cohort policy, §Delta payloads).
68
+ */
69
+ export interface ReactivityNodePolicy {
70
+ /** Whether this node may instantiate a forwarder / become a T3 producer. */
71
+ readonly mayForward: boolean;
72
+ /** `delta_max` (bytes): Core 4096, Edge 0 (declines deltas). */
73
+ readonly deltaMaxBytes: number;
74
+ }
75
+
76
+ /** Resolve the {@link ReactivityNodePolicy} for a profile (forwarder eligibility + `delta_max`). */
77
+ export function reactivityNodePolicy(profile: NodeProfile): ReactivityNodePolicy {
78
+ return { mayForward: mayServeAsReactivityForwarder(profile), deltaMaxBytes: deltaMaxForProfile(profile) };
79
+ }