@secondlayer/sdk 6.34.0 → 6.36.0

package/dist/subgraphs/index.js

@@ -66,10 +66,12 @@ class BaseClient {
   baseUrl;
   apiKey;
   origin;
+  fetchImpl;
   constructor(options = {}) {
     this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.apiKey = resolveApiKey(options.apiKey);
     this.origin = options.origin ?? "cli";
+    this.fetchImpl = options.fetchImpl ?? ((...args) => fetch(...args));
   }
   static authHeaders(apiKey) {
     const headers = {
@@ -115,7 +117,7 @@ class BaseClient {
     }
     let response;
     try {
-      response = await fetch(url, {
+      response = await this.fetchImpl(url, {
         method,
         headers,
         body: serializedBody
@@ -494,6 +496,19 @@ var Cursor = {
 function reorgKey(reorg) {
   return `${reorg.detected_at}|${reorg.fork_point_height}|${reorg.new_canonical_tip}`;
 }
+function assertFinalizedCheckpoint(returned, checkpoint) {
+  if (returned === null || returned === undefined)
+    return;
+  if (returned === checkpoint)
+    return;
+  const r = Cursor.parse(returned);
+  const c = checkpoint === null ? null : Cursor.parse(checkpoint);
+  const above = c === null || r.blockHeight > c.blockHeight || r.blockHeight === c.blockHeight && r.eventIndex > c.eventIndex;
+  if (above) {
+    const boundary = c ? ` ("${checkpoint}")` : " (none delivered yet)";
+    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 batchContext(cursor, height, tipHeight) {
   return {
     cursor,
@@ -558,6 +573,8 @@ async function consumeStreamsEvents(opts) {
     const checkpoint = finalizedOnly ? emitted.at(-1)?.cursor ?? cursor : envelope.next_cursor;
     height = emitted.at(-1)?.block_height ?? height;
     const returnedCursor = await opts.onBatch(emitted, envelope, batchContext(checkpoint, height, envelope.tip.block_height));
+    if (finalizedOnly)
+      assertFinalizedCheckpoint(returnedCursor, checkpoint);
     const nextCursor = returnedCursor ?? checkpoint;
     if (nextCursor && nextCursor !== cursor) {
       cursor = nextCursor;
@@ -691,6 +708,8 @@ async function consumeIndexFeed(opts) {
     const checkpoint = finalizedOnly ? emitted.at(-1)?.cursor ?? cursor : envelope.next_cursor;
     height = emitted.at(-1)?.block_height ?? height;
     const returnedCursor = await opts.onBatch(emitted, envelope, batchContext(checkpoint, height, envelope.tip.block_height));
+    if (finalizedOnly)
+      assertFinalizedCheckpoint(returnedCursor, checkpoint);
     const nextCursor = returnedCursor ?? checkpoint;
     if (nextCursor && nextCursor !== cursor) {
       cursor = nextCursor;
@@ -807,6 +826,19 @@ class Index extends BaseClient {
     deposits: {
       list: (params = {}) => this.listSbtcDeposits(params),
       walk: (params = {}) => this.walkSbtcDeposits(params),
+      consume: (params) => consumeIndexFeed({
+        ...params,
+        fetchPage: ({ cursor, fromHeight, limit }) => this.listSbtcDeposits({
+          confirmed: params.confirmed,
+          sender: params.sender,
+          bitcoinTxid: params.bitcoinTxid,
+          toHeight: params.toHeight,
+          cursor,
+          fromHeight,
+          limit
+        }),
+        itemsOf: (envelope) => envelope.deposits
+      }),
       get: (bitcoinTxid) => this.getSbtcDeposit(bitcoinTxid)
     },
     withdrawals: {
@@ -816,7 +848,22 @@ class Index extends BaseClient {
     },
     events: {
       list: (params = {}) => this.listSbtcEvents(params),
-      walk: (params = {}) => this.walkSbtcEvents(params)
+      walk: (params = {}) => this.walkSbtcEvents(params),
+      consume: (params) => consumeIndexFeed({
+        ...params,
+        fetchPage: ({ cursor, fromHeight, limit }) => this.listSbtcEvents({
+          confirmed: params.confirmed,
+          topic: params.topic,
+          sender: params.sender,
+          requestId: params.requestId,
+          bitcoinTxid: params.bitcoinTxid,
+          toHeight: params.toHeight,
+          cursor,
+          fromHeight,
+          limit
+        }),
+        itemsOf: (envelope) => envelope.events
+      })
     },
     summary: () => this.getSbtcSummary()
   };
@@ -1762,5 +1809,5 @@ export {
   Subgraphs
 };
 
-//# debugId=875C963182FEF66164756E2164756E21
+//# debugId=13B6D7F76CAEAFE964756E2164756E21
 //# sourceMappingURL=index.js.map