@optimystic/db-core 1.5.0 → 1.5.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 (152) hide show
  1. package/README.md +336 -336
  2. package/dist/src/collection/collection.d.ts +44 -4
  3. package/dist/src/collection/collection.d.ts.map +1 -1
  4. package/dist/src/collection/collection.js +95 -14
  5. package/dist/src/collection/collection.js.map +1 -1
  6. package/dist/src/log/log.d.ts +41 -8
  7. package/dist/src/log/log.d.ts.map +1 -1
  8. package/dist/src/log/log.js +15 -10
  9. package/dist/src/log/log.js.map +1 -1
  10. package/dist/src/testing/test-transactor.d.ts +36 -0
  11. package/dist/src/testing/test-transactor.d.ts.map +1 -1
  12. package/dist/src/testing/test-transactor.js +49 -0
  13. package/dist/src/testing/test-transactor.js.map +1 -1
  14. package/dist/src/transaction/coordinator.d.ts.map +1 -1
  15. package/dist/src/transaction/coordinator.js +26 -9
  16. package/dist/src/transaction/coordinator.js.map +1 -1
  17. package/package.json +1 -1
  18. package/src/blocks/block-store.ts +31 -31
  19. package/src/blocks/block-types.ts +11 -11
  20. package/src/blocks/index.ts +5 -5
  21. package/src/blocks/structs.ts +17 -17
  22. package/src/btree/btree.ts +872 -872
  23. package/src/btree/independent-trunk.ts +53 -53
  24. package/src/btree/index.ts +5 -5
  25. package/src/btree/key-range.ts +15 -15
  26. package/src/btree/keyset.ts +6 -6
  27. package/src/btree/nodes.ts +25 -25
  28. package/src/btree/path.ts +37 -37
  29. package/src/btree/tree-block.ts +11 -11
  30. package/src/btree/trunk.ts +14 -14
  31. package/src/chain/chain-nodes.ts +26 -26
  32. package/src/chain/chain.ts +349 -349
  33. package/src/chain/index.ts +3 -3
  34. package/src/cluster/i-cluster.ts +6 -6
  35. package/src/cluster/index.ts +3 -3
  36. package/src/cohort-topic/addressing.ts +120 -120
  37. package/src/cohort-topic/antidos/bootstrap-evidence.ts +106 -106
  38. package/src/cohort-topic/antidos/index.ts +5 -5
  39. package/src/cohort-topic/antidos/rate-limiter.ts +210 -210
  40. package/src/cohort-topic/antidos/replay-guard.ts +146 -146
  41. package/src/cohort-topic/antidos/topic-budget.ts +160 -160
  42. package/src/cohort-topic/antiflood/index.ts +2 -2
  43. package/src/cohort-topic/antiflood/invariants.ts +108 -108
  44. package/src/cohort-topic/antiflood/jitter.ts +117 -117
  45. package/src/cohort-topic/coldstart.ts +237 -237
  46. package/src/cohort-topic/dmax.ts +88 -88
  47. package/src/cohort-topic/gossip/bus.ts +254 -254
  48. package/src/cohort-topic/gossip/index.ts +3 -3
  49. package/src/cohort-topic/gossip/records.ts +45 -45
  50. package/src/cohort-topic/gossip/view.ts +91 -91
  51. package/src/cohort-topic/index.ts +20 -20
  52. package/src/cohort-topic/load/barometer.ts +134 -134
  53. package/src/cohort-topic/load/index.ts +1 -1
  54. package/src/cohort-topic/member-engine.ts +430 -430
  55. package/src/cohort-topic/membership/index.ts +3 -3
  56. package/src/cohort-topic/membership/publisher.ts +163 -163
  57. package/src/cohort-topic/membership/source.ts +41 -41
  58. package/src/cohort-topic/ports.ts +157 -157
  59. package/src/cohort-topic/promotion.ts +477 -477
  60. package/src/cohort-topic/registration/bytes.ts +37 -37
  61. package/src/cohort-topic/registration/handoff.ts +154 -154
  62. package/src/cohort-topic/registration/index.ts +6 -6
  63. package/src/cohort-topic/registration/renewal.ts +495 -495
  64. package/src/cohort-topic/registration/sharding.ts +61 -61
  65. package/src/cohort-topic/registration/store.ts +81 -81
  66. package/src/cohort-topic/registration/types.ts +91 -91
  67. package/src/cohort-topic/ring-hash.ts +50 -50
  68. package/src/cohort-topic/service.ts +416 -416
  69. package/src/cohort-topic/sig/index.ts +2 -2
  70. package/src/cohort-topic/sig/payloads.ts +59 -59
  71. package/src/cohort-topic/sig/threshold.ts +64 -64
  72. package/src/cohort-topic/tiers.ts +74 -74
  73. package/src/cohort-topic/traffic.ts +233 -233
  74. package/src/cohort-topic/walk.ts +326 -326
  75. package/src/cohort-topic/willingness.ts +237 -237
  76. package/src/cohort-topic/wire/index.ts +18 -18
  77. package/src/cohort-topic/wire/payloads.ts +126 -126
  78. package/src/collection/action.ts +48 -48
  79. package/src/collection/collection-type-registry.ts +37 -37
  80. package/src/collection/collection.ts +2203 -2118
  81. package/src/collection/index.ts +4 -4
  82. package/src/collections/diary/index.ts +2 -2
  83. package/src/collections/diary/struct.ts +3 -3
  84. package/src/collections/index.ts +2 -2
  85. package/src/collections/tree/collection-trunk.ts +25 -25
  86. package/src/collections/tree/index.ts +2 -2
  87. package/src/collections/tree/readme.md +55 -55
  88. package/src/log/index.ts +2 -2
  89. package/src/log/log.ts +304 -268
  90. package/src/log/struct.ts +165 -165
  91. package/src/matchmaking/capability-filter.ts +45 -45
  92. package/src/matchmaking/config.ts +98 -98
  93. package/src/matchmaking/index.ts +21 -21
  94. package/src/matchmaking/multi-cohort-seeker.ts +234 -234
  95. package/src/matchmaking/provider.ts +123 -123
  96. package/src/matchmaking/query-eval.ts +105 -105
  97. package/src/matchmaking/seeker-walk.ts +127 -127
  98. package/src/matchmaking/seeker.ts +86 -86
  99. package/src/matchmaking/topic-anchor.ts +90 -90
  100. package/src/matchmaking/voting-quorum.ts +394 -394
  101. package/src/network/i-peer-network.ts +25 -25
  102. package/src/network/repo-protocol.ts +13 -13
  103. package/src/network/types.ts +37 -37
  104. package/src/reactivity/backfill.ts +220 -220
  105. package/src/reactivity/backpressure.ts +191 -191
  106. package/src/reactivity/checkpoint.ts +308 -308
  107. package/src/reactivity/config.ts +172 -172
  108. package/src/reactivity/dedupe.ts +132 -132
  109. package/src/reactivity/forwarder.ts +87 -87
  110. package/src/reactivity/index.ts +34 -34
  111. package/src/reactivity/notification.ts +123 -123
  112. package/src/reactivity/policy.ts +79 -79
  113. package/src/reactivity/push-state.ts +310 -310
  114. package/src/reactivity/recover.ts +153 -153
  115. package/src/reactivity/replay-buffer.ts +141 -141
  116. package/src/reactivity/resume.ts +549 -549
  117. package/src/reactivity/rotation.ts +415 -415
  118. package/src/reactivity/subscriber.ts +132 -132
  119. package/src/reactivity/subscription.ts +66 -66
  120. package/src/reactivity/topic-anchor.ts +71 -71
  121. package/src/reactivity/verify.ts +73 -73
  122. package/src/reactivity/wire-validate.ts +13 -13
  123. package/src/testing/async-wait.ts +65 -65
  124. package/src/testing/index.ts +2 -2
  125. package/src/testing/test-transactor.ts +62 -0
  126. package/src/transaction/actions-engine.ts +68 -68
  127. package/src/transaction/coordinator.ts +28 -11
  128. package/src/transaction/index.ts +52 -52
  129. package/src/transaction/operations-hash.ts +196 -196
  130. package/src/transaction/read-dependency-collector.ts +78 -78
  131. package/src/transaction/session.ts +238 -238
  132. package/src/transaction/transaction.ts +442 -442
  133. package/src/transaction/validator.ts +197 -197
  134. package/src/transactor/block-floors.ts +126 -126
  135. package/src/transactor/index.ts +6 -6
  136. package/src/transactor/network-transactor.ts +1545 -1545
  137. package/src/transform/atomic-proxy.ts +92 -92
  138. package/src/transform/cache-source.ts +370 -370
  139. package/src/transform/helpers.ts +164 -164
  140. package/src/transform/index.ts +7 -7
  141. package/src/transform/struct.ts +21 -21
  142. package/src/utility/actor.ts +62 -62
  143. package/src/utility/backoff.ts +95 -95
  144. package/src/utility/batch-coordinator.ts +191 -191
  145. package/src/utility/ensured.ts +32 -32
  146. package/src/utility/groupby.ts +18 -18
  147. package/src/utility/hash-string.ts +14 -14
  148. package/src/utility/is-record-empty.ts +5 -5
  149. package/src/utility/latches.ts +42 -42
  150. package/src/utility/lru-map.ts +60 -60
  151. package/src/utility/nameof.ts +7 -7
  152. 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
+ }