@serfab/quereus-plugin-sereus 0.10.0 → 0.12.0

package/dist/cached-storage.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Wrap an embedder-supplied `IRawStorage` in `@optimystic/db-p2p`'s write-through
+ * raw-storage cache (`CachedRawStorage`) before handing it to a node or transactor.
+ *
+ * Why: bringing a control database or strand up is raw-storage-operation bound —
+ * uncached, a cold start re-reads the same handful of blocks ~2000 times (see the
+ * budget history in cadre-core's `test/control-start-storage-op-budget.spec.ts` and
+ * the sereus tickets `complete/optimystic-block-read-amplification-on-control-start`
+ * + `complete/optimystic-schema-catalog-reread-per-write-blows-storage-budgets`).
+ * Upstream ships the remedy as an opt-in wrapper — adoption is deliberately the
+ * consumer's choice — and this module is where Sereus opts in. It lives in this
+ * package (not cadre-core) for the same reason `cluster-size.ts` does: both the SQL
+ * plugin's own connectors (`composeStrand`, including the browser/IndexedDB path,
+ * where per-operation latency is highest) and cadre-core's control/strand seams
+ * need the identical wrap, and two copies could disagree.
+ *
+ * Soundness rests on the cache's single-process-owner invariant (upstream
+ * docs/storage.md §6): every write to the backend must funnel through the wrapped
+ * instance. Two rules uphold that:
+ *
+ * - **One wrap per inner instance** (WeakMap memo): the same `IRawStorage` reaches
+ *   this function from several seams at once — cadre-core's node wiring and the
+ *   strand backfill share the instance the node was built with, and the SQL
+ *   plugin's `composeStrand` re-wraps whatever it is handed. Two live caches over
+ *   one backend would each miss the other's writes; the memo makes the wrap
+ *   idempotent instead — a caller wrapping an already-wrapped or already-seen
+ *   instance gets the same object back.
+ * - **A Sereus process owns its data stores** — no second process writes the same
+ *   backend, which is the invariant's other half.
+ *
+ * `MemoryRawStorage` is returned unwrapped on upstream's own guidance: the backend
+ * is already in-memory, so the cache adds bookkeeping with nothing to save.
+ *
+ * **{@link wrapStorageWithCache} and {@link disposeStorageCache} are a matched pair
+ * with a holder count between them.** Every wrap that hands back a cache this module
+ * created takes one claim on it; every dispose of that cache releases one. The cache
+ * is emptied, unregistered from the shared pool, and forgotten only when the LAST
+ * claim goes. That is what makes overlapping scopes safe: `CadreNodeConfig.storage.provider`
+ * may be a single `IRawStorage` shared by the control database and every workspace,
+ * and without a count the first scope to stop would retire the cache the others are
+ * still reading through — then the next scope to start, finding the memo empty, would
+ * build a SECOND cache over the same backend, and each would serve its own stale view
+ * (including remembered "this block does not exist" answers). It is also what lets
+ * `composeStrand` release its own claim unconditionally on `shutdown()` without having
+ * to guess whether it or cadre-core created the wrapper.
+ *
+ * The memo dedupes *concurrent* seams; it is not what keeps a cache alive across a
+ * runtime rebuild. That is cadre-core's job, and it does it by OWNERSHIP: one
+ * resolved store per scope per runtime lifetime — a strand's store for the life of
+ * its instance (a hibernation quiesce → resume reuses the store already resolved,
+ * so the wake lands on a warm cache), the control store for the life of one
+ * `CadreNode.start()`. Because the store outlives the rebuild, so does its wrap,
+ * whether or not the embedder's provider returns a stable instance.
+ *
+ * When a scope's runtime stops for good, it calls {@link disposeStorageCache} — the
+ * release half of that ownership. Without it the retired wrapper's `CacheStoreHandle`
+ * would stay in the shared pool's registry for the process lifetime (`unregisterStore`
+ * is the only removal), one orphan per stop.
+ *
+ * NOTE: upstream ships an equivalent counted wrap of its own — `withReadCache`, which
+ * hands back a `ReadCacheLease` per caller and additionally dedupes by
+ * `getStoreIdentity()`, so two DISTINCT instances over one directory share one cache.
+ * This module keeps its own count instead, because its public surface releases by
+ * WRAPPER (`disposeStorageCache(storage)`) rather than by lease, and `withReadCache`
+ * returns no lease on its already-cached pass-through — which would leave
+ * `composeStrand`'s unconditional release unable to tell its own claim from cadre-core's.
+ * Adopting the lease API would mean changing that surface at all three call sites; worth
+ * doing if Sereus ever needs the identity-keyed dedupe (two `FileRawStorage` over one
+ * path), and not before.
+ */
+import { type IRawStorage } from '@optimystic/db-p2p/rn';
+/**
+ * The cached view of `storage`, memoized per instance, with one holder claim taken for
+ * this caller — release it with {@link disposeStorageCache} when this caller's scope
+ * ends. `label` names the store in the shared pool's `stats()` (e.g. `control`, or the
+ * strand id); on a memo hit the first caller's label sticks, since a second cache over
+ * one backend is the failure that matters and a stale pool label is not.
+ */
+export declare function wrapStorageWithCache(storage: IRawStorage, label: string): IRawStorage;
+/**
+ * Release this caller's claim on the cache wrapper {@link wrapStorageWithCache} returned.
+ * The wrapper is emptied, unregistered from the shared pool, and dropped from the memo
+ * only when the LAST holder releases — so a scope stopping never retires a cache another
+ * live scope is still reading through, and a still-held wrapper is never replaced by a
+ * competing second cache over the same backend.
+ *
+ * A wrapper with no live claim is left alone: that covers both a cache the embedder built
+ * itself (theirs to dispose) and a late second dispose of an already-retired wrapper,
+ * whose successor in the memo must not be dropped.
+ *
+ * No-op for anything this module returned unwrapped (e.g. `MemoryRawStorage`), so callers
+ * need no `instanceof` test. Only the wrapper is released: the inner store the embedder
+ * returned is never closed — that handle stays the embedder's to manage.
+ */
+export declare function disposeStorageCache(storage: IRawStorage): Promise<void>;

package/dist/cached-storage.js

@@ -0,0 +1,156 @@
+/**
+ * Wrap an embedder-supplied `IRawStorage` in `@optimystic/db-p2p`'s write-through
+ * raw-storage cache (`CachedRawStorage`) before handing it to a node or transactor.
+ *
+ * Why: bringing a control database or strand up is raw-storage-operation bound —
+ * uncached, a cold start re-reads the same handful of blocks ~2000 times (see the
+ * budget history in cadre-core's `test/control-start-storage-op-budget.spec.ts` and
+ * the sereus tickets `complete/optimystic-block-read-amplification-on-control-start`
+ * + `complete/optimystic-schema-catalog-reread-per-write-blows-storage-budgets`).
+ * Upstream ships the remedy as an opt-in wrapper — adoption is deliberately the
+ * consumer's choice — and this module is where Sereus opts in. It lives in this
+ * package (not cadre-core) for the same reason `cluster-size.ts` does: both the SQL
+ * plugin's own connectors (`composeStrand`, including the browser/IndexedDB path,
+ * where per-operation latency is highest) and cadre-core's control/strand seams
+ * need the identical wrap, and two copies could disagree.
+ *
+ * Soundness rests on the cache's single-process-owner invariant (upstream
+ * docs/storage.md §6): every write to the backend must funnel through the wrapped
+ * instance. Two rules uphold that:
+ *
+ * - **One wrap per inner instance** (WeakMap memo): the same `IRawStorage` reaches
+ *   this function from several seams at once — cadre-core's node wiring and the
+ *   strand backfill share the instance the node was built with, and the SQL
+ *   plugin's `composeStrand` re-wraps whatever it is handed. Two live caches over
+ *   one backend would each miss the other's writes; the memo makes the wrap
+ *   idempotent instead — a caller wrapping an already-wrapped or already-seen
+ *   instance gets the same object back.
+ * - **A Sereus process owns its data stores** — no second process writes the same
+ *   backend, which is the invariant's other half.
+ *
+ * `MemoryRawStorage` is returned unwrapped on upstream's own guidance: the backend
+ * is already in-memory, so the cache adds bookkeeping with nothing to save.
+ *
+ * **{@link wrapStorageWithCache} and {@link disposeStorageCache} are a matched pair
+ * with a holder count between them.** Every wrap that hands back a cache this module
+ * created takes one claim on it; every dispose of that cache releases one. The cache
+ * is emptied, unregistered from the shared pool, and forgotten only when the LAST
+ * claim goes. That is what makes overlapping scopes safe: `CadreNodeConfig.storage.provider`
+ * may be a single `IRawStorage` shared by the control database and every workspace,
+ * and without a count the first scope to stop would retire the cache the others are
+ * still reading through — then the next scope to start, finding the memo empty, would
+ * build a SECOND cache over the same backend, and each would serve its own stale view
+ * (including remembered "this block does not exist" answers). It is also what lets
+ * `composeStrand` release its own claim unconditionally on `shutdown()` without having
+ * to guess whether it or cadre-core created the wrapper.
+ *
+ * The memo dedupes *concurrent* seams; it is not what keeps a cache alive across a
+ * runtime rebuild. That is cadre-core's job, and it does it by OWNERSHIP: one
+ * resolved store per scope per runtime lifetime — a strand's store for the life of
+ * its instance (a hibernation quiesce → resume reuses the store already resolved,
+ * so the wake lands on a warm cache), the control store for the life of one
+ * `CadreNode.start()`. Because the store outlives the rebuild, so does its wrap,
+ * whether or not the embedder's provider returns a stable instance.
+ *
+ * When a scope's runtime stops for good, it calls {@link disposeStorageCache} — the
+ * release half of that ownership. Without it the retired wrapper's `CacheStoreHandle`
+ * would stay in the shared pool's registry for the process lifetime (`unregisterStore`
+ * is the only removal), one orphan per stop.
+ *
+ * NOTE: upstream ships an equivalent counted wrap of its own — `withReadCache`, which
+ * hands back a `ReadCacheLease` per caller and additionally dedupes by
+ * `getStoreIdentity()`, so two DISTINCT instances over one directory share one cache.
+ * This module keeps its own count instead, because its public surface releases by
+ * WRAPPER (`disposeStorageCache(storage)`) rather than by lease, and `withReadCache`
+ * returns no lease on its already-cached pass-through — which would leave
+ * `composeStrand`'s unconditional release unable to tell its own claim from cadre-core's.
+ * Adopting the lease API would mean changing that surface at all three call sites; worth
+ * doing if Sereus ever needs the identity-keyed dedupe (two `FileRawStorage` over one
+ * path), and not before.
+ */
+// Imported from the `/rn` entry — the platform-neutral surface (no Node-only
+// transports) — because `composeStrand` reaches this module on the browser path
+// too. Both db-p2p entrypoints re-export the same storage modules, so class
+// identity (the `instanceof` checks below) is unaffected on Node.
+import { CachedRawStorage, MemoryRawStorage } from '@optimystic/db-p2p/rn';
+const wraps = new WeakMap();
+const claims = new WeakMap();
+/**
+ * Count one more holder of `wrapped`, if this module created it. A cache built outside
+ * this module stays its creator's to release, so it is left uncounted and
+ * {@link disposeStorageCache} no-ops on it.
+ */
+function addHolder(wrapped) {
+    const claim = claims.get(wrapped);
+    if (claim) {
+        claim.holders += 1;
+    }
+}
+/**
+ * The cached view of `storage`, memoized per instance, with one holder claim taken for
+ * this caller — release it with {@link disposeStorageCache} when this caller's scope
+ * ends. `label` names the store in the shared pool's `stats()` (e.g. `control`, or the
+ * strand id); on a memo hit the first caller's label sticks, since a second cache over
+ * one backend is the failure that matters and a stale pool label is not.
+ */
+export function wrapStorageWithCache(storage, label) {
+    if (storage instanceof MemoryRawStorage) {
+        return storage;
+    }
+    if (storage instanceof CachedRawStorage) {
+        // Already the wrapper this module handed out: cadre-core wraps at its own seams
+        // and passes the wrapper down to `composeStrand`, which wraps again. Count the
+        // new holder rather than stacking a second cache over one backend.
+        // NOTE: a RETIRED wrapper (last holder already released) is also returned as-is,
+        // uncounted — the caller gets a dead cache with no error. No call site can reach
+        // that today: both retire sites drop their reference in the same block that
+        // releases. If a caller ever holds a wrapper across its own release, make this
+        // branch throw on an absent claim rather than hand back the corpse.
+        addHolder(storage);
+        return storage;
+    }
+    const memoized = wraps.get(storage);
+    if (memoized) {
+        addHolder(memoized);
+        return memoized;
+    }
+    const wrapped = new CachedRawStorage(storage, undefined, label);
+    wraps.set(storage, wrapped);
+    claims.set(wrapped, { inner: storage, holders: 1 });
+    return wrapped;
+}
+/**
+ * Release this caller's claim on the cache wrapper {@link wrapStorageWithCache} returned.
+ * The wrapper is emptied, unregistered from the shared pool, and dropped from the memo
+ * only when the LAST holder releases — so a scope stopping never retires a cache another
+ * live scope is still reading through, and a still-held wrapper is never replaced by a
+ * competing second cache over the same backend.
+ *
+ * A wrapper with no live claim is left alone: that covers both a cache the embedder built
+ * itself (theirs to dispose) and a late second dispose of an already-retired wrapper,
+ * whose successor in the memo must not be dropped.
+ *
+ * No-op for anything this module returned unwrapped (e.g. `MemoryRawStorage`), so callers
+ * need no `instanceof` test. Only the wrapper is released: the inner store the embedder
+ * returned is never closed — that handle stays the embedder's to manage.
+ */
+export async function disposeStorageCache(storage) {
+    if (!(storage instanceof CachedRawStorage)) {
+        return;
+    }
+    const claim = claims.get(storage);
+    if (!claim) {
+        return;
+    }
+    // Decrement, and on zero retire the bookkeeping, all in this SYNCHRONOUS prefix —
+    // before the await below. A wrap of the same inner instance interleaved between the
+    // two would otherwise find a memo entry pointing at a dying cache.
+    claim.holders -= 1;
+    if (claim.holders > 0) {
+        return;
+    }
+    claims.delete(storage);
+    wraps.delete(claim.inner);
+    await storage.dispose();
+}
+//# sourceMappingURL=cached-storage.js.map

package/dist/cached-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-storage.js","sourceRoot":"","sources":["../src/cached-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AAEH,6EAA6E;AAC7E,gFAAgF;AAChF,4EAA4E;AAC5E,kEAAkE;AAClE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAoB,MAAM,uBAAuB,CAAC;AAE7F,MAAM,KAAK,GAAG,IAAI,OAAO,EAAiC,CAAC;AAmB3D,MAAM,MAAM,GAAG,IAAI,OAAO,EAAgC,CAAC;AAE3D;;;;GAIG;AACH,SAAS,SAAS,CAAC,OAAyB;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,KAAK,EAAE,CAAC;QACX,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;IACpB,CAAC;AACF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAoB,EAAE,KAAa;IACvE,IAAI,OAAO,YAAY,gBAAgB,EAAE,CAAC;QACzC,OAAO,OAAO,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,YAAY,gBAAgB,EAAE,CAAC;QACzC,gFAAgF;QAChF,+EAA+E;QAC/E,mEAAmE;QACnE,iFAAiF;QACjF,iFAAiF;QACjF,4EAA4E;QAC5E,+EAA+E;QAC/E,oEAAoE;QACpE,SAAS,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,OAAO,CAAC;IAChB,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,QAAQ,EAAE,CAAC;QACd,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpB,OAAO,QAAQ,CAAC;IACjB,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAChE,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5B,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAoB;IAC7D,IAAI,CAAC,CAAC,OAAO,YAAY,gBAAgB,CAAC,EAAE,CAAC;QAC5C,OAAO;IACR,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO;IACR,CAAC;IACD,kFAAkF;IAClF,oFAAoF;IACpF,mEAAmE;IACnE,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;IACnB,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;IACR,CAAC;IACD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;AACzB,CAAC"}

package/dist/compose-strand.d.ts

@@ -1,7 +1,7 @@
 import type { Database, VTablePluginInfo, FunctionPluginInfo, CollationPluginInfo } from '@quereus/quereus';
 import type { Libp2p } from '@libp2p/interface';
-import type { IRawStorage } from '@optimystic/db-p2p';
-import type { StrandConnectionOptions, SereusPluginResult } from './types.js';
+import type { IRawStorage, NodeOptions } from '@optimystic/db-p2p';
+import type { StrandConnectionOptions, SereusPluginResult, StrandTransactor } from './types.js';
 /** Registration shape shared by the crypto and optimystic plugin results. */
 interface PluginRegistrations {
     vtables?: VTablePluginInfo[];
@@ -29,13 +29,26 @@ export interface CreateNodeContext {
      * default of 10, which gates writes on any smaller party.
      */
     clusterSize: number;
+    /**
+     * The strand cluster policy, resolved here so no platform has to remember it.
+     * Pass it to `createLibp2pNode` verbatim.
+     *
+     * Omitting it does NOT fall back to something equivalent: Optimystic then computes
+     * its read-repair corroboration floor against `clusterSize` instead of against
+     * {@link STRAND_CLUSTER_POLICY}'s `assumedClusterSize`, which is a stricter demand
+     * than a two-machine strand can meet — so repair of a damaged block gives up where
+     * it would otherwise succeed. That is the same defect class that took the *control*
+     * network's e2e suite down before `42cd12c`; see `cluster-size.ts` for the reasoning
+     * written out in full.
+     */
+    clusterPolicy: NonNullable<NodeOptions['clusterPolicy']>;
     /** Resolved persistent storage to back the node, if any. */
     storage?: IRawStorage;
 }
 /** Context passed to the platform's storage-resolution strategy. */
 export interface ResolveStorageContext {
     strandId: string;
-    resolvedTransactor: string;
+    resolvedTransactor: StrandTransactor;
     /** The storage the caller passed in `options.storage`, if any. */
     requestedStorage?: IRawStorage;
 }

package/dist/compose-strand.js

@@ -1,7 +1,8 @@
 import debug from 'debug';
 import optimysticPlugin from '@optimystic/quereus-plugin-optimystic/plugin';
 import { STRAND_SCHEMA } from './strand-schema.js';
-import { resolveStrandClusterSize } from './cluster-size.js';
+import { resolveStrandClusterSize, STRAND_CLUSTER_POLICY } from './cluster-size.js';
+import { wrapStorageWithCache, disposeStorageCache } from './cached-storage.js';
 const log = debug('sereus:plugin:strand');
 const timing = debug('sereus:plugin:strand:timing');
 /**
@@ -33,53 +34,67 @@ export function applyRegistrations(db, result) {
  * vtab, hydrate the catalog, then apply the sApp schema.
  */
 export async function composeStrand(db, options, platform) {
-    const { strandId, bootstrapNodes = [], schema, port = 0, enableCache = true, fretProfile = 'edge', mode, } = options;
+    const { strandId, bootstrapNodes = [], schema, port = 0, enableCache = true, fretProfile = 'edge', transactor = 'network', } = options;
     // Resolve (and validate) up front so a nonsense value fails before any plugin
     // registration or node creation has happened.
     const clusterSize = resolveStrandClusterSize(options.clusterSize);
-    // Resolve the transactor. `mode` is the public knob: bootstrap -> local,
-    // networked -> network. The legacy `transactor` override (used by unit
-    // tests with `'test'`) only applies when `mode` is unspecified.
-    let resolvedTransactor;
-    if (mode !== undefined) {
-        resolvedTransactor = mode === 'bootstrap' ? 'local' : 'network';
-    }
-    else if (options.transactor !== undefined) {
-        resolvedTransactor = options.transactor;
-    }
-    else {
-        resolvedTransactor = 'network';
-    }
+    // The storage engine every write and read below goes through — see
+    // `StrandConnectionOptions.transactor`. Named separately from the option so
+    // the default is applied exactly once and reported on the result.
+    const resolvedTransactor = transactor;
     const networkName = `strand-${strandId}`;
-    log('Connecting to strand %s (network: %s, mode=%s, transactor=%s)', strandId, networkName, mode ?? '(default)', resolvedTransactor);
+    log('Connecting to strand %s (network: %s, transactor=%s)', strandId, networkName, resolvedTransactor);
     // Resolve storage. Node passes `options.storage` through; the browser
-    // defaults to IndexedDB. The resolved instance feeds BOTH the plugin's
-    // bootstrap `rawStorageFactory` and node creation, so it must be decided up
-    // front (before pluginConfig is built).
-    const storage = platform.resolveStorage
+    // defaults to IndexedDB. The resolved instance feeds BOTH the local
+    // transactor's `rawStorageFactory` and node creation, so it must be decided
+    // up front (before pluginConfig is built). Wrapped in the write-through
+    // raw-storage cache (cached-storage.ts) — idempotent, so a caller that
+    // already wrapped (cadre-core's seams) passes through unchanged, with this
+    // composition counted as one more holder of that same cache.
+    const resolvedStorage = platform.resolveStorage
         ? await platform.resolveStorage({ strandId, resolvedTransactor, requestedStorage: options.storage })
         : options.storage;
-    // 1. Register crypto plugin (digest, sign, verify, etc.)
-    await platform.registerCrypto(db);
-    log('Registered crypto plugin');
-    // 2. Register optimystic plugin with transactor defaults. In local mode with
-    // persistent storage, hand the same instance to the plugin so the local
-    // transactor persists DML on the host backend (not in-memory).
-    const pluginConfig = {
-        default_transactor: resolvedTransactor,
-        default_key_network: 'libp2p',
-        default_network_name: networkName,
-        enable_cache: enableCache,
+    const storage = resolvedStorage ? wrapStorageWithCache(resolvedStorage, strandId) : resolvedStorage;
+    /**
+     * Release THIS composition's claim on the storage cache — the matching half of the
+     * wrap above, which took one. `wrapStorageWithCache` counts holders, so this is
+     * unconditionally correct whoever created the wrapper: the cache stays live while
+     * cadre-core (or any other seam over the same store) still holds a claim, and is
+     * emptied and unregistered from the shared cache pool when the last one goes. Holding
+     * a claim past the strand's life is not free — the registration claims the backing
+     * store in the pool, and a claim outliving its strand makes the next connect over that
+     * same directory throw.
+     *
+     * Latched, so a caller that calls `shutdown()` twice releases one claim, not two — a
+     * second release would consume another scope's claim.
+     */
+    let storageCacheReleased = false;
+    const releaseStorageCache = async () => {
+        if (storageCacheReleased || !storage) {
+            return;
+        }
+        storageCacheReleased = true;
+        await disposeStorageCache(storage);
     };
-    if (resolvedTransactor === 'local' && storage) {
-        pluginConfig.rawStorageFactory = () => storage;
+    // 1-2. Register the crypto and optimystic plugins. Guarded on its own, because the
+    // wrap above has ALREADY taken a holder claim: a registration that throws must release
+    // it, or the claim — and the backing store's registration in the shared cache pool —
+    // outlives the failed connect for the process lifetime, and no other scope can retire
+    // the cache. Separate from the larger try below, which has a collection factory and
+    // possibly a node to tear down as well; neither exists yet here.
+    let pluginResult;
+    try {
+        pluginResult = await registerStrandPlugins(db, platform, {
+            resolvedTransactor,
+            networkName,
+            enableCache,
+            storage,
+        });
+    }
+    catch (err) {
+        await releaseStorageCache();
+        throw err;
     }
-    // The plugin's published signature is `Record<string, SqlValue>` but it
-    // also reads `rawStorageFactory` (a function reference) from the same map.
-    // Cast through unknown rather than widen the public type.
-    const pluginResult = optimysticPlugin(db, pluginConfig);
-    applyRegistrations(db, pluginResult);
-    log('Registered optimystic vtables and functions');
     const { collectionFactory } = pluginResult;
     let createdNode = null;
     let hydrated;
@@ -98,7 +113,7 @@ export async function composeStrand(db, options, platform) {
                 log('Using injected libp2p node');
             }
             else {
-                const created = await platform.createNode({ networkName, bootstrapNodes, fretProfile, port, clusterSize, storage });
+                const created = await platform.createNode({ networkName, bootstrapNodes, fretProfile, port, clusterSize, clusterPolicy: STRAND_CLUSTER_POLICY, storage });
                 createdNode = created;
                 node = created;
                 const repo = created.coordinatedRepo;
@@ -141,11 +156,11 @@ export async function composeStrand(db, options, platform) {
         // Manager/Member, invite/peer flows) is owned by the lifecycle ticket
         // `strand-membership-lifecycle-population`.
         log('Applying Strand membership schema for strand %s', strandId);
-        await db.exec(`
-			declare schema Strand {
-				${STRAND_SCHEMA}
-			}
-			apply schema Strand;
+        await db.exec(`
+			declare schema Strand {
+				${STRAND_SCHEMA}
+			}
+			apply schema Strand;
 		`);
         log('Strand membership schema applied');
         // 7. Apply the sApp schema, if provided.
@@ -155,11 +170,11 @@ export async function composeStrand(db, options, platform) {
         // here so it stays a one-location edit across Node, browser, and cadre-core.
         if (schema) {
             log('Applying sApp schema for strand %s', strandId);
-            await db.exec(`
-				declare schema App {
-					${schema}
-				}
-				apply schema App;
+            await db.exec(`
+				declare schema App {
+					${schema}
+				}
+				apply schema App;
 			`);
             log('sApp schema applied');
         }
@@ -170,6 +185,7 @@ export async function composeStrand(db, options, platform) {
         if (createdNode) {
             await createdNode.stop();
         }
+        await releaseStorageCache();
         throw err;
     }
     // 8. Return result with hydrate counts + shutdown handler. `shutdown` tears
@@ -185,14 +201,44 @@ export async function composeStrand(db, options, platform) {
         functions: [],
         collations: [],
         hydrated,
+        transactor: resolvedTransactor,
         async shutdown() {
             log('Shutting down strand connection %s', strandId);
             await collectionFactory.shutdown();
             if (createdNode) {
                 await createdNode.stop();
             }
+            await releaseStorageCache();
             log('Strand connection %s shut down', strandId);
         },
     };
 }
+/**
+ * Steps 1-2 of {@link composeStrand}: register the crypto plugin, then the optimystic
+ * plugin carrying this strand's transactor defaults. Split out so the composition can
+ * guard the pair against the storage-cache claim it has already taken.
+ */
+async function registerStrandPlugins(db, platform, strand) {
+    await platform.registerCrypto(db);
+    log('Registered crypto plugin');
+    // On the local transactor with persistent storage, hand the same instance to the
+    // plugin so DML persists on the host backend (not in-memory).
+    const pluginConfig = {
+        default_transactor: strand.resolvedTransactor,
+        default_key_network: 'libp2p',
+        default_network_name: strand.networkName,
+        enable_cache: strand.enableCache,
+    };
+    if (strand.resolvedTransactor === 'local' && strand.storage) {
+        const storage = strand.storage;
+        pluginConfig.rawStorageFactory = () => storage;
+    }
+    // The plugin's published signature is `Record<string, SqlValue>` but it also reads
+    // `rawStorageFactory` (a function reference) from the same map. Cast through unknown
+    // rather than widen the public type.
+    const pluginResult = optimysticPlugin(db, pluginConfig);
+    applyRegistrations(db, pluginResult);
+    log('Registered optimystic vtables and functions');
+    return pluginResult;
+}
 //# sourceMappingURL=compose-strand.js.map

package/dist/compose-strand.js.map

@@ -1 +1 @@
-{"version":3,"file":"compose-strand.js","sourceRoot":"","sources":["../src/compose-strand.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"compose-strand.js","sourceRoot":"","sources":["../src/compose-strand.ts"],"names":[],"mappings":"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"}

package/dist/connect-browser.js

@@ -30,7 +30,7 @@ export async function connectToStrandBrowser(db, options) {
             const dbHandle = await openOptimysticWebDb(`sereus-strand-${strandId}`);
             return new IndexedDBRawStorage(dbHandle);
         },
-        async createNode({ networkName, bootstrapNodes, fretProfile, clusterSize, storage }) {
+        async createNode({ networkName, bootstrapNodes, fretProfile, clusterSize, clusterPolicy, storage }) {
             return createLibp2pNode({
                 transports: [webSockets(), circuitRelayTransport()],
                 listenAddrs: [],
@@ -38,6 +38,7 @@ export async function connectToStrandBrowser(db, options) {
                 networkName,
                 fretProfile,
                 clusterSize,
+                clusterPolicy,
                 ...(storage && { storage }),
             });
         },

package/dist/connect-browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"connect-browser.js","sourceRoot":"","sources":["../src/connect-browser.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,MAAM,0CAA0C,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAG1F,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AASxE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,EAAY,EACZ,OAAgC;IAEhC,OAAO,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE;QACjC,cAAc,CAAC,QAAQ;YACtB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAkC,CAAC,CAAC;QAC3F,CAAC;QACD,KAAK,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,EAAE;YACtE,IAAI,gBAAgB;gBAAE,OAAO,gBAAgB,CAAC;YAC9C,iEAAiE;YACjE,8CAA8C;YAC9C,IAAI,kBAAkB,KAAK,MAAM;gBAAE,OAAO,SAAS,CAAC;YACpD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;YACxE,OAAO,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE;YAClF,OAAO,gBAAgB,CAAC;gBACvB,UAAU,EAAE,CAAC,UAAU,EAAE,EAAE,qBAAqB,EAAE,CAAC;gBACnD,WAAW,EAAE,EAAE;gBACf,cAAc;gBACd,WAAW;gBACX,WAAW;gBACX,WAAW;gBACX,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;aAC3B,CAAoB,CAAC;QACvB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"connect-browser.js","sourceRoot":"","sources":["../src/connect-browser.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,MAAM,0CAA0C,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAG1F,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AASxE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,EAAY,EACZ,OAAgC;IAEhC,OAAO,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE;QACjC,cAAc,CAAC,QAAQ;YACtB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAkC,CAAC,CAAC;QAC3F,CAAC;QACD,KAAK,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,EAAE;YACtE,IAAI,gBAAgB;gBAAE,OAAO,gBAAgB,CAAC;YAC9C,iEAAiE;YACjE,8CAA8C;YAC9C,IAAI,kBAAkB,KAAK,MAAM;gBAAE,OAAO,SAAS,CAAC;YACpD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;YACxE,OAAO,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE;YACjG,OAAO,gBAAgB,CAAC;gBACvB,UAAU,EAAE,CAAC,UAAU,EAAE,EAAE,qBAAqB,EAAE,CAAC;gBACnD,WAAW,EAAE,EAAE;gBACf,cAAc;gBACd,WAAW;gBACX,WAAW;gBACX,WAAW;gBACX,aAAa;gBACb,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;aAC3B,CAAoB,CAAC;QACvB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/connect.js

@@ -13,7 +13,7 @@ export async function connectToStrand(db, options) {
         async registerCrypto(database) {
             await registerPlugin(database, cryptoPlugin);
         },
-        async createNode({ networkName, bootstrapNodes, fretProfile, port, clusterSize, storage }) {
+        async createNode({ networkName, bootstrapNodes, fretProfile, port, clusterSize, clusterPolicy, storage }) {
             // Dynamically import to keep the module cross-platform friendly: this
             // pulls the Node-only `@optimystic/db-p2p` (TCP) entry, and is only
             // reached when actually creating a node (never for injected nodes).
@@ -24,6 +24,7 @@ export async function connectToStrand(db, options) {
                 networkName,
                 fretProfile,
                 clusterSize,
+                clusterPolicy,
                 ...(storage && { storage }),
             });
         },

package/dist/connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"connect.js","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,YAAY,MAAM,0CAA0C,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,EAAY,EACZ,OAAgC;IAEhC,OAAO,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE;QACjC,KAAK,CAAC,cAAc,CAAC,QAAQ;YAC5B,MAAM,cAAc,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE;YACxF,sEAAsE;YACtE,oEAAoE;YACpE,oEAAoE;YACpE,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAChE,OAAO,gBAAgB,CAAC;gBACvB,IAAI;gBACJ,cAAc;gBACd,WAAW;gBACX,WAAW;gBACX,WAAW;gBACX,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;aAC3B,CAAoB,CAAC;QACvB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,YAAY,MAAM,0CAA0C,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,EAAY,EACZ,OAAgC;IAEhC,OAAO,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE;QACjC,KAAK,CAAC,cAAc,CAAC,QAAQ;YAC5B,MAAM,cAAc,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE;YACvG,sEAAsE;YACtE,oEAAoE;YACpE,oEAAoE;YACpE,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAChE,OAAO,gBAAgB,CAAC;gBACvB,IAAI;gBACJ,cAAc;gBACd,WAAW;gBACX,WAAW;gBACX,WAAW;gBACX,aAAa;gBACb,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;aAC3B,CAAoB,CAAC;QACvB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export { connectToStrand } from './connect.js';
 export { MIN_CLUSTER_SIZE, CONTROL_REPLICATION_BREADTH, CONTROL_CLUSTER_POLICY, DEFAULT_STRAND_CLUSTER_SIZE, STRAND_CLUSTER_POLICY, resolveStrandClusterSize } from './cluster-size.js';
-export type { StrandConnectionOptions, SereusPluginResult } from './types.js';
+export { wrapStorageWithCache, disposeStorageCache } from './cached-storage.js';
+export type { StrandConnectionOptions, SereusPluginResult, StrandTransactor } from './types.js';

package/dist/index.js

@@ -1,3 +1,4 @@
 export { connectToStrand } from './connect.js';
 export { MIN_CLUSTER_SIZE, CONTROL_REPLICATION_BREADTH, CONTROL_CLUSTER_POLICY, DEFAULT_STRAND_CLUSTER_SIZE, STRAND_CLUSTER_POLICY, resolveStrandClusterSize } from './cluster-size.js';
+export { wrapStorageWithCache, disposeStorageCache } from './cached-storage.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACN,gBAAgB,EAChB,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,wBAAwB,EACxB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACN,gBAAgB,EAChB,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,EACrB,wBAAwB,EACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}