@secondlayer/sdk 6.47.0 → 6.48.0

package/dist/index.js

@@ -592,6 +592,11 @@ function assertFinalizedCheckpoint(returned, checkpoint) {
     throw new ValidationError(`onBatch returned cursor "${returned}", above the last delivered finalized event${boundary}. With finalizedOnly, events past that point were filtered out and will be re-read once finalized — committing beyond it skips them permanently. Return ctx.cursor (or nothing); never envelope.next_cursor.`, 400);
   }
 }
+function assertSinkModeCompatible(sink, finalizedOnly) {
+  if (sink?.capabilities?.finalizedOnly && !finalizedOnly) {
+    throw new ValidationError("This sink declares capabilities.finalizedOnly — it cannot roll back reorged rows, and following the unfinalized tip would corrupt it at the first fork. Pass finalizedOnly: true to consume(), or use a sink that implements rollback.", 400);
+  }
+}
 function batchContext(cursor, height, tip, reorgs = []) {
   const tipHeight = tip.block_height;
   return {
@@ -658,6 +663,7 @@ async function consumeStreamsEvents(opts) {
   const emptyBackoffMs = opts.emptyBackoffMs ?? 500;
   const maxPages = opts.maxPages ?? Number.POSITIVE_INFINITY;
   const maxEmptyPolls = opts.maxEmptyPolls ?? Number.POSITIVE_INFINITY;
+  assertSinkModeCompatible(opts.sink, finalizedOnly);
   const committedCursor = await opts.sink?.loadCursor() ?? null;
   let cursor = opts.fromCursor ?? committedCursor;
   const handledReorgs = new Set;
@@ -824,6 +830,7 @@ async function consumeIndexFeed(opts) {
   const emptyBackoffMs = opts.emptyBackoffMs ?? 500;
   const maxPages = opts.maxPages ?? Number.POSITIVE_INFINITY;
   const maxEmptyPolls = opts.maxEmptyPolls ?? Number.POSITIVE_INFINITY;
+  assertSinkModeCompatible(opts.sink, finalizedOnly);
   const committedCursor = await opts.sink?.loadCursor() ?? null;
   let cursor = opts.fromCursor ?? committedCursor;
   const handledReorgs = new Set;
@@ -2892,5 +2899,5 @@ export {
   ApiError
 };
 
-//# debugId=8DFD8103C4A93D9164756E2164756E21
+//# debugId=AADEB8FAB0EE368C64756E2164756E21
 //# sourceMappingURL=index.js.map