@serfab/cadre-core 1.11.0 → 1.13.0

package/dist/strand-reactivity.js

@@ -0,0 +1,41 @@
+/**
+ * Which strand nodes are built with Optimystic's change-notification substrate
+ * (`NodeOptions.cohortTopic` in `@optimystic/db-p2p`): a node built with it announces every
+ * commit whose collection log tail it applied, and gives the strand's tables tagged
+ * `"optimystic.network_watch" = true` a network watch, so an app on another machine is woken
+ * by a commit instead of polling. Off unless the operator turns it on; `docs/strands.md` →
+ * "Change notifications (reactivity)" says what turning it on costs and exposes.
+ *
+ * "Cohort topic" is Optimystic's name for the substrate and stays inside this module; cadre
+ * calls the setting `strandReactivity`.
+ */
+/**
+ * The `createLibp2pNode` options slice for one strand: `{ cohortTopic: { enabled: true } }` when
+ * `config.enabled === true` and (`strandIds` is absent, an empty array, or contains `strandId`
+ * exactly); otherwise `{}` — no `cohortTopic` key at all, never `{ enabled: false }`, so db-p2p
+ * takes its "absent" path unchanged.
+ *
+ * Fails closed on a JS embedder's mistake: an `enabled` that is not the boolean `true`, or a
+ * `strandIds` that is present but not an array, enables nothing.
+ *
+ * Deliberately no `wantK` or `host` tuning: a reactivity root is the tail block's storage group
+ * (`clusterSize` wide), verified at the consensus super-majority, and neither `wantK` nor
+ * `cohortTopic.host.minSigs` governs it; the tiers below the root keep db-p2p's defaults.
+ *
+ * NOTE: with no `host.profile`, db-p2p builds every host as core (forwarder-eligible, 30 s
+ * renewal), a `'transaction'` phone included — it does not follow `fretProfile`. If phone-side
+ * forwarding load shows up, pass `host: { profile: edgeProfile() }` for transaction nodes, after
+ * confirming an edge host still serves its part of a tail block's root group.
+ */
+export function strandCohortTopicOption(config, strandId) {
+    return config?.enabled === true && strandSelected(config.strandIds, strandId)
+        ? { cohortTopic: { enabled: true } }
+        : {};
+}
+function strandSelected(strandIds, strandId) {
+    if (strandIds === undefined) {
+        return true;
+    }
+    return Array.isArray(strandIds) && (strandIds.length === 0 || strandIds.includes(strandId));
+}
+//# sourceMappingURL=strand-reactivity.js.map

package/dist/strand-reactivity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strand-reactivity.js","sourceRoot":"","sources":["../src/strand-reactivity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAA0C,EAC1C,QAAgB;IAEhB,OAAO,MAAM,EAAE,OAAO,KAAK,IAAI,IAAI,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC;QAC3E,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACpC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,SAAS,cAAc,CAAC,SAAkB,EAAE,QAAgB;IAC1D,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC9F,CAAC"}

package/dist/types.d.ts

@@ -3,6 +3,7 @@ import type { CircuitRelayServerInit } from '@libp2p/circuit-relay-v2';
 import type { IRawStorage, Libp2pConnectionMonitorInit, Libp2pTransports, NoiseCryptoInterface } from '@optimystic/db-p2p';
 import type { IPeerNetwork, IRepo } from '@optimystic/db-core';
 import type { PeerJoinBackfillConfig } from './peer-join-backfill.js';
+import type { StrandReactivityConfig } from './strand-reactivity.js';
 import type { StrandRevocationEnforcementConfig } from './strand-revocation-enforcer.js';
 import type { StrandMembershipReconciliationConfig } from './strand-membership-reconciler.js';
 import type { StrandFirstSyncConfig } from './strand-first-sync-gate.js';
@@ -763,6 +764,24 @@ export interface CadreNodeConfig {
      * separately tuned catch-up — see {@link controlBackfill}.
      */
     strandBackfill?: PeerJoinBackfillConfig;
+    /**
+     * Optimystic change notifications on this node's strand nodes (`strand-reactivity.ts`):
+     * a strand node built with them announces the commits whose collection log tail it applied,
+     * and an sApp table tagged `"optimystic.network_watch" = true` wakes its `Database.watch`
+     * subscribers on another machine's commit instead of only on local ones. Default off; with
+     * it off every strand node is built exactly as before. `strandIds` narrows it to chosen
+     * strands, independently of `strandFilter` (which decides whether a strand runs at all).
+     *
+     * Frozen when the strand's libp2p node is built: a change takes effect at the next build —
+     * a restart, or the strand's next wake from hibernation. Every machine serving the strand
+     * should enable it, because a node without it neither announces nor serves as part of the
+     * group a notification is rooted at. Enabling registers Optimystic's change-notification
+     * protocol handlers on the strand node, which the closed-strand per-stream gate does not
+     * cover, and each watched table pays a cold-start proof of work on every node build. Both
+     * are spelled out in `docs/strands.md` → "Change notifications (reactivity)". The control
+     * node never gets it.
+     */
+    strandReactivity?: StrandReactivityConfig;
     /**
      * Tuning for the CONTROL network's peer-join block catch-up (same module,
      * `peer-join-backfill.ts`, wired in `CadreNode.start`): when the control

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAoFA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA6C;IAC5E,QAAQ,EAAE;QACR,WAAW,EAAE,QAAQ,EAAS,aAAa;QAC3C,gBAAgB,EAAE,QAAQ,EAAI,kBAAkB;QAChD,eAAe,EAAE,QAAQ,EAAK,MAAM;QACpC,oBAAoB,EAAE,CAAC;QACvB,kBAAkB,EAAE,QAAQ,CAAE,MAAM;KACrC;IACD,WAAW,EAAE;QACX,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAI,YAAY;QAC1C,gBAAgB,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,wBAAwB;QAC1D,eAAe,EAAE,EAAE,GAAG,IAAI,EAAI,mBAAmB;QACjD,oBAAoB,EAAE,CAAC;QACvB,kBAAkB,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,eAAe;KACnD;IACD,UAAU,EAAE;QACV,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAI,WAAW;QACzC,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAG,uBAAuB;QACzD,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAI,kBAAkB;QACpD,oBAAoB,EAAE,CAAC;QACvB,kBAAkB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,gBAAgB;KACxD;IACD,OAAO,EAAE;QACP,WAAW,EAAE,EAAE,GAAG,IAAI,EAAQ,aAAa;QAC3C,gBAAgB,EAAE,EAAE,GAAG,IAAI,EAAG,wBAAwB;QACtD,eAAe,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAG,eAAe;QACjD,oBAAoB,EAAE,CAAC;QACvB,kBAAkB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,eAAe;KAC5D;CACF,CAAC;AA0dF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC;IACtD,uFAAuF;IACvF,mFAAmF;IACnF,YAAY,EAAE,KAAM;IACpB,kFAAkF;IAClF,kFAAkF;IAClF,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,KAAM,EAAE,UAAU,EAAE,KAAM,EAAE,CAAC;CACjC,CAAC,CAAC;AAmBzC;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,GAAG,IAAI,CAAC;AAYnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AAEvC;;;;;GAKG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAqFA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA6C;IAC5E,QAAQ,EAAE;QACR,WAAW,EAAE,QAAQ,EAAS,aAAa;QAC3C,gBAAgB,EAAE,QAAQ,EAAI,kBAAkB;QAChD,eAAe,EAAE,QAAQ,EAAK,MAAM;QACpC,oBAAoB,EAAE,CAAC;QACvB,kBAAkB,EAAE,QAAQ,CAAE,MAAM;KACrC;IACD,WAAW,EAAE;QACX,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAI,YAAY;QAC1C,gBAAgB,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,wBAAwB;QAC1D,eAAe,EAAE,EAAE,GAAG,IAAI,EAAI,mBAAmB;QACjD,oBAAoB,EAAE,CAAC;QACvB,kBAAkB,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,eAAe;KACnD;IACD,UAAU,EAAE;QACV,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAI,WAAW;QACzC,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAG,uBAAuB;QACzD,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAI,kBAAkB;QACpD,oBAAoB,EAAE,CAAC;QACvB,kBAAkB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,gBAAgB;KACxD;IACD,OAAO,EAAE;QACP,WAAW,EAAE,EAAE,GAAG,IAAI,EAAQ,aAAa;QAC3C,gBAAgB,EAAE,EAAE,GAAG,IAAI,EAAG,wBAAwB;QACtD,eAAe,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAG,eAAe;QACjD,oBAAoB,EAAE,CAAC;QACvB,kBAAkB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,eAAe;KAC5D;CACF,CAAC;AA0dF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC;IACtD,uFAAuF;IACvF,mFAAmF;IACnF,YAAY,EAAE,KAAM;IACpB,kFAAkF;IAClF,kFAAkF;IAClF,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,KAAM,EAAE,UAAU,EAAE,KAAM,EAAE,CAAC;CACjC,CAAC,CAAC;AAmBzC;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,GAAG,IAAI,CAAC;AAYnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AAEvC;;;;;GAKG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serfab/cadre-core",
-  "version": "1.11.0",
+  "version": "1.13.0",
   "type": "module",
   "description": "Core library for Sereus cadre nodes - manages control networks and strand participation",
   "main": "dist/index.js",
@@ -77,7 +77,7 @@
     "@libp2p/tcp": "^11.0.28",
     "@libp2p/webrtc": "6.0.33",
     "@libp2p/websockets": "^10.1.21",
-    "@optimystic/db-p2p-storage-fs": "^1.9.0",
+    "@optimystic/db-p2p-storage-fs": "^1.11.0",
     "@types/debug": "^4.1.12",
     "@types/node": "^25.0.10",
     "@vitest/coverage-v8": "^4.0.17",
@@ -93,12 +93,12 @@
     "@libp2p/peer-id": "^6.0.15",
     "@libp2p/peer-record": "^9.0.16",
     "@multiformats/multiaddr": "^13.0.3",
-    "@optimystic/db-core": "^1.9.0",
-    "@optimystic/db-p2p": "^1.9.0",
-    "@optimystic/quereus-plugin-crypto": "^1.9.0",
-    "@optimystic/quereus-plugin-optimystic": "^1.9.0",
-    "@quereus/quereus": "^4.20.0",
-    "@serfab/quereus-plugin-sereus": "^1.11.0",
+    "@optimystic/db-core": "^1.11.0",
+    "@optimystic/db-p2p": "^1.11.0",
+    "@optimystic/quereus-plugin-crypto": "^1.11.0",
+    "@optimystic/quereus-plugin-optimystic": "^1.11.0",
+    "@quereus/quereus": "^4.20.1",
+    "@serfab/quereus-plugin-sereus": "^1.13.0",
     "debug": "^4.4.3",
     "libp2p": "^3.3.11",
     "uint8arrays": "^6.1.1"