@secondlayer/sdk 6.47.0 → 6.48.1

package/dist/subgraphs/index.js

@@ -592,6 +592,20 @@ 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 resumeHeight(cursor) {
+  if (cursor === null)
+    return null;
+  try {
+    return Cursor.parse(cursor).blockHeight;
+  } catch {
+    return null;
+  }
+}
 function batchContext(cursor, height, tip, reorgs = []) {
   const tipHeight = tip.block_height;
   return {
@@ -658,12 +672,13 @@ 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;
   let pages = 0;
   let emptyPolls = 0;
-  let height = null;
+  let height = resumeHeight(cursor);
   while (pages < maxPages && emptyPolls < maxEmptyPolls && !opts.signal?.aborted) {
     const envelope = await fetchPageWithRetry(() => opts.fetchEvents({
       cursor,
@@ -702,7 +717,7 @@ async function consumeStreamsEvents(opts) {
     const emitted = finalizedOnly ? envelope.events.filter((event) => event.finalized) : envelope.events;
     const checkpoint = finalizedOnly ? emitted.at(-1)?.cursor ?? cursor : envelope.next_cursor;
     height = emitted.at(-1)?.block_height ?? height;
-    const ctx = batchContext(checkpoint, height, envelope.tip, envelope.reorgs);
+    const ctx = batchContext(checkpoint ?? cursor, height, envelope.tip, envelope.reorgs);
     opts.onProgress?.(ctx);
     let nextCursor;
     if (opts.sink) {
@@ -824,12 +839,13 @@ 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;
   let pages = 0;
   let emptyPolls = 0;
-  let height = null;
+  let height = resumeHeight(cursor);
   while (pages < maxPages && emptyPolls < maxEmptyPolls && !opts.signal?.aborted) {
     const envelope = await fetchPageWithRetry(() => opts.fetchPage({
       cursor,
@@ -863,7 +879,7 @@ async function consumeIndexFeed(opts) {
     const emitted = finalizedOnly ? items.filter((item) => item.block_height <= envelope.tip.finalized_height) : items;
     const checkpoint = finalizedOnly ? emitted.at(-1)?.cursor ?? cursor : envelope.next_cursor;
     height = emitted.at(-1)?.block_height ?? height;
-    const ctx = batchContext(checkpoint, height, envelope.tip, envelope.reorgs);
+    const ctx = batchContext(checkpoint ?? cursor, height, envelope.tip, envelope.reorgs);
     opts.onProgress?.(ctx);
     let nextCursor;
     if (opts.sink) {
@@ -2196,5 +2212,5 @@ export {
   Subgraphs
 };
 
-//# debugId=D54DFB03E93AA1D464756E2164756E21
+//# debugId=BE9B5D3664FE5C8464756E2164756E21
 //# sourceMappingURL=index.js.map