@secondlayer/sdk 6.37.0 → 6.38.0

package/dist/streams/index.js

@@ -399,7 +399,7 @@ async function consumeStreamsEvents(opts) {
   const emptyBackoffMs = opts.emptyBackoffMs ?? 500;
   const maxPages = opts.maxPages ?? Number.POSITIVE_INFINITY;
   const maxEmptyPolls = opts.maxEmptyPolls ?? Number.POSITIVE_INFINITY;
-  let cursor = opts.fromCursor ?? null;
+  let cursor = opts.fromCursor ?? await opts.sink?.loadCursor() ?? null;
   const handledReorgs = new Set;
   let pages = 0;
   let emptyPolls = 0;
@@ -422,13 +422,14 @@ async function consumeStreamsEvents(opts) {
       signal: opts.signal
     });
     pages++;
-    if (!finalizedOnly && opts.onReorg) {
+    if (!finalizedOnly && (opts.onReorg || opts.sink)) {
       const fresh = envelope.reorgs.filter((reorg) => !handledReorgs.has(reorgKey(reorg))).sort((a, b) => a.fork_point_height - b.fork_point_height);
       if (fresh.length > 0) {
         const forkPoint = Math.min(...fresh.map((reorg) => reorg.fork_point_height));
         const rewind = Cursor.atHeight(forkPoint);
         for (const reorg of fresh) {
-          await opts.onReorg(reorg, { cursor: rewind });
+          await opts.sink?.rollback(reorg.fork_point_height, rewind);
+          await opts.onReorg?.(reorg, { cursor: rewind });
           handledReorgs.add(reorgKey(reorg));
         }
         cursor = rewind;
@@ -440,10 +441,26 @@ 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 returnedCursor = await opts.onBatch(emitted, envelope, batchContext(checkpoint, height, envelope.tip.block_height));
-    if (finalizedOnly)
-      assertFinalizedCheckpoint(returnedCursor, checkpoint);
-    const nextCursor = returnedCursor ?? checkpoint;
+    const ctx = batchContext(checkpoint, height, envelope.tip.block_height);
+    opts.onProgress?.(ctx);
+    let nextCursor;
+    if (opts.sink) {
+      const sink = opts.sink;
+      if (checkpoint !== null && (checkpoint !== cursor || emitted.length > 0)) {
+        await sink.commitBatch(checkpoint, async (tx) => {
+          await opts.onBatch(emitted, envelope, {
+            ...ctx,
+            tx
+          });
+        });
+      }
+      nextCursor = checkpoint;
+    } else {
+      const returnedCursor = await opts.onBatch(emitted, envelope, ctx);
+      if (finalizedOnly)
+        assertFinalizedCheckpoint(returnedCursor, checkpoint);
+      nextCursor = returnedCursor ?? checkpoint;
+    }
     if (nextCursor && nextCursor !== cursor) {
       cursor = nextCursor;
       emptyPolls = 0;
@@ -535,6 +552,175 @@ async function* streamStreamsEvents(opts) {
   }
 }
 
+// src/streams/_payload.ts
+function requireString(payload, field, eventType) {
+  const value = payload[field];
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error(`${eventType} payload missing ${field}`);
+  }
+  return value;
+}
+function optionalString(value) {
+  return typeof value === "string" && value.length > 0 ? value : null;
+}
+function requireAmountField(payload, field, eventType) {
+  const amount = requireString(payload, field, eventType);
+  if (!/^(0|[1-9]\d*)$/.test(amount)) {
+    throw new Error(`${eventType} payload has malformed ${field}`);
+  }
+  return amount;
+}
+function requireAmount(payload, eventType) {
+  return requireAmountField(payload, "amount", eventType);
+}
+function parseAssetIdentifier(assetIdentifier, eventType) {
+  const [contractId, tokenName] = assetIdentifier.split("::");
+  if (!contractId) {
+    throw new Error(`${eventType} payload has malformed asset_identifier`);
+  }
+  return {
+    contract_id: contractId,
+    token_name: tokenName && tokenName.length > 0 ? tokenName : null
+  };
+}
+function requireHexValue(payload, eventType) {
+  const rawValue = payload.raw_value;
+  if (typeof rawValue === "string") {
+    if (!/^0x[0-9a-fA-F]*$/.test(rawValue)) {
+      throw new Error(`${eventType} payload has malformed value`);
+    }
+    return rawValue;
+  }
+  const value = payload.value;
+  const hex = typeof value === "string" ? value : value && typeof value === "object" && typeof value.hex === "string" ? value.hex : null;
+  if (!hex) {
+    throw new Error(`${eventType} payload missing value`);
+  }
+  if (!/^0x[0-9a-fA-F]*$/.test(hex)) {
+    throw new Error(`${eventType} payload has malformed value`);
+  }
+  return hex;
+}
+function decodedRow(event, eventType, decoded_payload) {
+  return {
+    cursor: event.cursor,
+    block_height: event.block_height,
+    tx_id: event.tx_id,
+    tx_index: event.tx_index,
+    event_index: event.event_index,
+    event_type: eventType,
+    decoded_payload,
+    source_cursor: event.cursor
+  };
+}
+
+// src/streams/decode.ts
+function decode(event) {
+  const base = {
+    cursor: event.cursor,
+    block_height: event.block_height,
+    block_time: event.ts,
+    tx_id: event.tx_id,
+    tx_index: event.tx_index,
+    event_index: event.event_index,
+    contract_id: event.contract_id
+  };
+  const p = event.payload;
+  switch (event.event_type) {
+    case "stx_transfer":
+      return {
+        ...base,
+        event_type: "stx_transfer",
+        sender: requireString(p, "sender", event.event_type),
+        recipient: requireString(p, "recipient", event.event_type),
+        amount: requireAmountField(p, "amount", event.event_type),
+        memo: optionalString(p.memo)
+      };
+    case "stx_mint":
+      return {
+        ...base,
+        event_type: "stx_mint",
+        recipient: requireString(p, "recipient", event.event_type),
+        amount: requireAmountField(p, "amount", event.event_type)
+      };
+    case "stx_burn":
+      return {
+        ...base,
+        event_type: "stx_burn",
+        sender: requireString(p, "sender", event.event_type),
+        amount: requireAmountField(p, "amount", event.event_type)
+      };
+    case "stx_lock":
+      return {
+        ...base,
+        event_type: "stx_lock",
+        sender: requireString(p, "locked_address", event.event_type),
+        amount: requireAmountField(p, "locked_amount", event.event_type),
+        payload: { unlock_height: optionalString(p.unlock_height) }
+      };
+    case "ft_transfer":
+      return {
+        ...base,
+        event_type: "ft_transfer",
+        asset_identifier: requireString(p, "asset_identifier", event.event_type),
+        sender: requireString(p, "sender", event.event_type),
+        recipient: requireString(p, "recipient", event.event_type),
+        amount: requireAmountField(p, "amount", event.event_type)
+      };
+    case "ft_mint":
+      return {
+        ...base,
+        event_type: "ft_mint",
+        asset_identifier: requireString(p, "asset_identifier", event.event_type),
+        recipient: requireString(p, "recipient", event.event_type),
+        amount: requireAmountField(p, "amount", event.event_type)
+      };
+    case "ft_burn":
+      return {
+        ...base,
+        event_type: "ft_burn",
+        asset_identifier: requireString(p, "asset_identifier", event.event_type),
+        sender: requireString(p, "sender", event.event_type),
+        amount: requireAmountField(p, "amount", event.event_type)
+      };
+    case "nft_transfer":
+      return {
+        ...base,
+        event_type: "nft_transfer",
+        asset_identifier: requireString(p, "asset_identifier", event.event_type),
+        sender: requireString(p, "sender", event.event_type),
+        recipient: requireString(p, "recipient", event.event_type),
+        value: requireHexValue(p, event.event_type)
+      };
+    case "nft_mint":
+      return {
+        ...base,
+        event_type: "nft_mint",
+        asset_identifier: requireString(p, "asset_identifier", event.event_type),
+        recipient: requireString(p, "recipient", event.event_type),
+        value: requireHexValue(p, event.event_type)
+      };
+    case "nft_burn":
+      return {
+        ...base,
+        event_type: "nft_burn",
+        asset_identifier: requireString(p, "asset_identifier", event.event_type),
+        sender: requireString(p, "sender", event.event_type),
+        value: requireHexValue(p, event.event_type)
+      };
+    case "print":
+      return {
+        ...base,
+        event_type: "print",
+        payload: {
+          topic: optionalString(p.topic),
+          value: p.value,
+          raw_value: optionalString(p.raw_value)
+        }
+      };
+  }
+}
+
 // src/streams/dumps.ts
 import { createHash } from "node:crypto";
 import { verifyStreamsBulkManifestSignature } from "@secondlayer/shared/streams-bulk-manifest";
@@ -909,8 +1095,11 @@ function createStreamsClient(options) {
         return request(`/v1/streams/events/${encodeURIComponent(txId)}`);
       },
       consume(params) {
+        const onBatch = params.decoded ? (events, envelope, ctx) => params.onBatch(events.map(decode), envelope, ctx) : params.onBatch;
         return consumeStreamsEvents({
           fromCursor: params.fromCursor,
+          sink: params.sink,
+          onProgress: params.onProgress,
           mode: params.mode,
           finalizedOnly: params.finalizedOnly,
           types: params.types,
@@ -921,7 +1110,7 @@ function createStreamsClient(options) {
           assetIdentifier: params.assetIdentifier,
           batchSize: params.batchSize ?? 100,
           fetchEvents,
-          onBatch: params.onBatch,
+          onBatch,
           onReorg: params.onReorg,
           emptyBackoffMs: params.emptyBackoffMs,
           maxPages: params.maxPages,
@@ -1009,68 +1198,6 @@ function createStreamsClient(options) {
     }
   };
 }
-// src/streams/_payload.ts
-function requireString(payload, field, eventType) {
-  const value = payload[field];
-  if (typeof value !== "string" || value.length === 0) {
-    throw new Error(`${eventType} payload missing ${field}`);
-  }
-  return value;
-}
-function optionalString(value) {
-  return typeof value === "string" && value.length > 0 ? value : null;
-}
-function requireAmountField(payload, field, eventType) {
-  const amount = requireString(payload, field, eventType);
-  if (!/^(0|[1-9]\d*)$/.test(amount)) {
-    throw new Error(`${eventType} payload has malformed ${field}`);
-  }
-  return amount;
-}
-function requireAmount(payload, eventType) {
-  return requireAmountField(payload, "amount", eventType);
-}
-function parseAssetIdentifier(assetIdentifier, eventType) {
-  const [contractId, tokenName] = assetIdentifier.split("::");
-  if (!contractId) {
-    throw new Error(`${eventType} payload has malformed asset_identifier`);
-  }
-  return {
-    contract_id: contractId,
-    token_name: tokenName && tokenName.length > 0 ? tokenName : null
-  };
-}
-function requireHexValue(payload, eventType) {
-  const rawValue = payload.raw_value;
-  if (typeof rawValue === "string") {
-    if (!/^0x[0-9a-fA-F]*$/.test(rawValue)) {
-      throw new Error(`${eventType} payload has malformed value`);
-    }
-    return rawValue;
-  }
-  const value = payload.value;
-  const hex = typeof value === "string" ? value : value && typeof value === "object" && typeof value.hex === "string" ? value.hex : null;
-  if (!hex) {
-    throw new Error(`${eventType} payload missing value`);
-  }
-  if (!/^0x[0-9a-fA-F]*$/.test(hex)) {
-    throw new Error(`${eventType} payload has malformed value`);
-  }
-  return hex;
-}
-function decodedRow(event, eventType, decoded_payload) {
-  return {
-    cursor: event.cursor,
-    block_height: event.block_height,
-    tx_id: event.tx_id,
-    tx_index: event.tx_index,
-    event_index: event.event_index,
-    event_type: eventType,
-    decoded_payload,
-    source_cursor: event.cursor
-  };
-}
-
 // src/streams/ft-transfer.ts
 function isFtTransfer(event) {
   return event.event_type === "ft_transfer";
@@ -1315,6 +1442,7 @@ export {
   decodeFtTransfer,
   decodeFtMint,
   decodeFtBurn,
+  decode,
   createStreamsClient,
   ValidationError,
   StreamsSignatureError,
@@ -1325,5 +1453,5 @@ export {
   AuthError
 };
 
-//# debugId=9793637197EFD6F364756E2164756E21
+//# debugId=5CDDE8F307DF3D9164756E2164756E21
 //# sourceMappingURL=index.js.map