@secondlayer/sdk 10.0.0 → 10.1.0

package/AGENTS.md

@@ -96,6 +96,13 @@ await sl.streams.events.consume({
 });
 ```
 
+Folds (balances, counters, last-wins owner) do not go in `tables`. Invert or
+recompute them in the sink's `onRollback`, same transaction, before the
+fact-table delete. Doomed rows are still visible; remaining facts are
+`height < forkPointHeight`. A throw aborts the rewind. Consume `onReorg`
+runs after that transaction and must not mutate. Derive undo from the doomed
+rows so a re-applied rollback is a no-op.
+
 Hand-rolling it is allowed, but the checkpoint write must be inside the same
 transaction as the row writes.
 

package/dist/index.d.ts

@@ -763,7 +763,8 @@ type StreamsEventsConsumeParams<
 	* the loop resumes from the sink's committed cursor, `onBatch` receives
 	* `ctx.tx` and must write ONLY through it (rows and cursor commit in one
 	* transaction), reorg rollback is automatic, and `onBatch`'s return value
-	* is ignored.
+	* is ignored. Folds (balances) invert in the sink's `onRollback`, not in
+	* `onReorg`.
 	*/
 	sink?: ConsumerSink<TTx>;
 	/** Fires once per page, before `onBatch` and before any early return. */
@@ -1118,7 +1119,8 @@ type IndexConsumeOptions<
 	* the loop resumes from the sink's committed cursor, `onBatch` receives
 	* `ctx.tx` and must write ONLY through it (rows and cursor commit in one
 	* transaction — a throw aborts both), reorg rollback is automatic (no
-	* `onReorg` needed), and `onBatch`'s return value is ignored.
+	* `onReorg` needed), and `onBatch`'s return value is ignored. Folds
+	* (balances) invert in the sink's `onRollback`, not in `onReorg`.
 	*/
 	sink?: ConsumerSink<TTx>;
 	/** Fires once per page, before `onBatch` and before any early return —