@serfab/cadre-core 1.18.0 → 1.19.1

package/src/edge-node/platform.ts

@@ -4,7 +4,7 @@
  * for it. Fixed for the app's lifetime.
  */
 
-import type { IRawStorage, Libp2pTransports, NoiseCryptoInterface } from '@optimystic/db-p2p';
+import type { IKVStore, IRawStorage, Libp2pTransports, NoiseCryptoInterface } from '@optimystic/db-p2p';
 import type { KeyStore } from '../key-store.js';
 import type { DurableSlot } from '../node-local-snapshot.js';
 import type { CadreNodeConfig } from '../types.js';
@@ -123,6 +123,17 @@ export interface EdgeNodeStorage {
 	 * strand stops.
 	 */
 	rawStorage(scope: string): IRawStorage;
+	/**
+	 * A strand's offline journal (`CadreNodeConfig.strandOffline.journal`), kept in the strand
+	 * scope's own database beside its blocks: the journal's keys are all under
+	 * `optimystic-offline/`, a node key-value namespace the platform stores apart from blocks. The
+	 * same instance for the same scope until {@link close}, which flushes and closes it with the
+	 * scope's handle; cadre-core asks again on every rebuild of the strand, and a second store over
+	 * one handle would not see the first one's unflushed writes. {@link destroyScope} closes it too.
+	 * A rejection fails the strand's build. Absent: no offline mode on this platform
+	 * (`setStrandOfflineMode` throws `StrandOfflineUnavailableError`).
+	 */
+	offlineJournal?(scope: string): Promise<IKVStore>;
 	/** Delete a scope's storage. No handle on it may be open. Resolves when it is gone or was absent. */
 	destroyScope(scope: string): Promise<void>;
 	/**
@@ -132,8 +143,9 @@ export interface EdgeNodeStorage {
 	 */
 	nodeLocal(): NodeLocalKv;
 	/**
-	 * Flush and close the node-local store, then close every handle {@link rawStorage} opened. A
-	 * failure closing one is logged and the rest still close; the call does not reject.
+	 * Flush and close the node-local store and every {@link offlineJournal}, then close every
+	 * handle {@link rawStorage} opened. A failure closing one is logged and the rest still close;
+	 * the call does not reject.
 	 */
 	close(): Promise<void>;
 	/**

package/src/edge-node/strands.ts

@@ -40,8 +40,9 @@ export async function attachStrandWhenWritable(
  * Optimystic's cluster coordinator reports a write that could not gather enough approvals this
  * way. It is transient right after a node restarts alone: its cohort has not reconnected yet.
  *
- * NOTE: matched on the message because Optimystic throws a plain `Error` here. If it gains a typed
- * error, match on that instead — a reworded message would silently stop the retries.
+ * NOTE: matched on the message. Optimystic 1.20.0 raises this failure as `PromiseShortfallError` and
+ * keeps the sentence unchanged as a contract, so the match holds; moving to the type is the second arm
+ * of backlog `debt-control-write-retry-matches-the-shortfall-by-type`.
  */
 const SUPER_MAJORITY_FAILURE = /Failed to get super-majority/i;