@secondlayer/sdk 6.21.2 → 6.23.0

package/dist/index.js

@@ -442,6 +442,280 @@ class Contracts extends BaseClient {
   }
 }
 
+// src/streams/errors.ts
+class AuthError extends Error {
+  status = 401;
+  constructor(message = "API key invalid or expired.") {
+    super(message);
+    this.name = "AuthError";
+  }
+}
+
+class RateLimitError extends Error {
+  retryAfter;
+  status = 429;
+  constructor(message = "Rate limited. Try again later.", retryAfter) {
+    super(message);
+    this.retryAfter = retryAfter;
+    this.name = "RateLimitError";
+  }
+}
+
+class ValidationError extends Error {
+  status;
+  body;
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "ValidationError";
+  }
+}
+
+class StreamsServerError extends Error {
+  status;
+  body;
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "StreamsServerError";
+  }
+}
+
+class StreamsSignatureError extends Error {
+  constructor(message = "Streams response signature verification failed.") {
+    super(message);
+    this.name = "StreamsSignatureError";
+  }
+}
+
+// src/streams/cursor.ts
+var Cursor = {
+  atHeight(height) {
+    return `${height}:0`;
+  },
+  parse(cursor) {
+    const parts = cursor.split(":");
+    const blockHeight = Number(parts[0]);
+    const eventIndex = Number(parts[1]);
+    if (parts.length !== 2 || !Number.isInteger(blockHeight) || !Number.isInteger(eventIndex)) {
+      throw new ValidationError(`Invalid stream cursor "${cursor}"; expected "<block>:<index>" (e.g. "951475:3").`, 400);
+    }
+    return { blockHeight, eventIndex };
+  }
+};
+
+// src/streams/consumer.ts
+function reorgKey(reorg) {
+  return `${reorg.detected_at}|${reorg.fork_point_height}|${reorg.new_canonical_tip}`;
+}
+async function defaultSleep(ms, signal) {
+  if (signal?.aborted)
+    return;
+  await new Promise((resolve) => {
+    const timeout = setTimeout(resolve, ms);
+    if (!signal)
+      return;
+    signal.addEventListener("abort", () => {
+      clearTimeout(timeout);
+      resolve();
+    }, { once: true });
+  });
+}
+async function consumeStreamsEvents(opts) {
+  const sleep = opts.sleep ?? defaultSleep;
+  const mode = opts.mode ?? "tail";
+  const finalizedOnly = opts.finalizedOnly ?? false;
+  const emptyBackoffMs = opts.emptyBackoffMs ?? 500;
+  const maxPages = opts.maxPages ?? Number.POSITIVE_INFINITY;
+  const maxEmptyPolls = opts.maxEmptyPolls ?? Number.POSITIVE_INFINITY;
+  let cursor = opts.fromCursor ?? null;
+  const handledReorgs = new Set;
+  let pages = 0;
+  let emptyPolls = 0;
+  while (pages < maxPages && emptyPolls < maxEmptyPolls && !opts.signal?.aborted) {
+    const envelope = await opts.fetchEvents({
+      cursor,
+      limit: opts.batchSize,
+      types: opts.types,
+      notTypes: opts.notTypes,
+      contractId: opts.contractId,
+      sender: opts.sender,
+      recipient: opts.recipient,
+      assetIdentifier: opts.assetIdentifier
+    });
+    pages++;
+    if (!finalizedOnly && opts.onReorg) {
+      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 });
+          handledReorgs.add(reorgKey(reorg));
+        }
+        cursor = rewind;
+        emptyPolls = 0;
+        continue;
+      }
+    }
+    const emitted = finalizedOnly ? envelope.events.filter((event) => event.finalized) : envelope.events;
+    const checkpoint = finalizedOnly ? emitted.at(-1)?.cursor ?? cursor : envelope.next_cursor;
+    const returnedCursor = await opts.onBatch(emitted, envelope, {
+      cursor: checkpoint
+    });
+    const nextCursor = returnedCursor ?? checkpoint;
+    if (nextCursor && nextCursor !== cursor) {
+      cursor = nextCursor;
+      emptyPolls = 0;
+      continue;
+    }
+    if (emitted.length === 0) {
+      emptyPolls++;
+      if (mode === "bounded") {
+        return { cursor, pages, emptyPolls };
+      }
+      await sleep(emptyBackoffMs, opts.signal);
+      continue;
+    }
+    return { cursor, pages, emptyPolls };
+  }
+  return { cursor, pages, emptyPolls };
+}
+async function* iterateStreamsBatches(opts) {
+  const sleep = opts.sleep ?? defaultSleep;
+  let cursor = opts.fromCursor ?? null;
+  while (!opts.signal?.aborted) {
+    const envelope = await opts.fetchEvents({
+      cursor,
+      limit: opts.batchSize,
+      types: opts.types,
+      notTypes: opts.notTypes,
+      contractId: opts.contractId,
+      sender: opts.sender,
+      recipient: opts.recipient,
+      assetIdentifier: opts.assetIdentifier
+    });
+    const checkpoint = envelope.next_cursor ?? cursor;
+    if (envelope.events.length > 0 || envelope.reorgs.length > 0) {
+      yield {
+        events: envelope.events,
+        cursor: checkpoint,
+        tip: envelope.tip,
+        reorgs: envelope.reorgs
+      };
+    }
+    const advanced = checkpoint !== null && checkpoint !== cursor;
+    cursor = checkpoint;
+    if (!advanced && envelope.events.length === 0) {
+      if (opts.signal?.aborted)
+        return;
+      await sleep(opts.intervalMs, opts.signal);
+    }
+  }
+}
+async function* streamStreamsEvents(opts) {
+  const sleep = opts.sleep ?? defaultSleep;
+  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 pages = 0;
+  let emptyPolls = 0;
+  while (pages < maxPages && emptyPolls < maxEmptyPolls && !opts.signal?.aborted) {
+    const envelope = await opts.fetchEvents({
+      cursor,
+      limit: opts.batchSize,
+      types: opts.types,
+      notTypes: opts.notTypes,
+      contractId: opts.contractId,
+      sender: opts.sender,
+      recipient: opts.recipient,
+      assetIdentifier: opts.assetIdentifier
+    });
+    pages++;
+    for (const event of envelope.events) {
+      if (opts.signal?.aborted)
+        return;
+      yield event;
+    }
+    const nextCursor = envelope.next_cursor;
+    if (nextCursor && nextCursor !== cursor) {
+      cursor = nextCursor;
+      emptyPolls = 0;
+      continue;
+    }
+    if (envelope.events.length === 0) {
+      emptyPolls++;
+      if (emptyPolls >= maxEmptyPolls || pages >= maxPages)
+        return;
+      await sleep(emptyBackoffMs, opts.signal);
+      continue;
+    }
+    return;
+  }
+}
+
+// src/index-api/consumer.ts
+async function consumeIndexFeed(opts) {
+  const sleep = opts.sleep ?? defaultSleep;
+  const mode = opts.mode ?? "tail";
+  const finalizedOnly = opts.finalizedOnly ?? false;
+  const batchSize = opts.batchSize ?? 200;
+  const emptyBackoffMs = opts.emptyBackoffMs ?? 500;
+  const maxPages = opts.maxPages ?? Number.POSITIVE_INFINITY;
+  const maxEmptyPolls = opts.maxEmptyPolls ?? Number.POSITIVE_INFINITY;
+  let cursor = opts.fromCursor ?? null;
+  const handledReorgs = new Set;
+  let pages = 0;
+  let emptyPolls = 0;
+  while (pages < maxPages && emptyPolls < maxEmptyPolls && !opts.signal?.aborted) {
+    const envelope = await opts.fetchPage({
+      cursor,
+      fromHeight: cursor === null ? opts.fromHeight : undefined,
+      limit: batchSize
+    });
+    pages++;
+    if (!finalizedOnly && opts.onReorg) {
+      const fresh = envelope.reorgs.filter((reorg) => !handledReorgs.has(reorg.id)).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 });
+          handledReorgs.add(reorg.id);
+        }
+        cursor = rewind;
+        emptyPolls = 0;
+        continue;
+      }
+    }
+    const items = opts.itemsOf(envelope);
+    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;
+    const returnedCursor = await opts.onBatch(emitted, envelope, {
+      cursor: checkpoint
+    });
+    const nextCursor = returnedCursor ?? checkpoint;
+    if (nextCursor && nextCursor !== cursor) {
+      cursor = nextCursor;
+      emptyPolls = 0;
+      continue;
+    }
+    if (emitted.length === 0) {
+      emptyPolls++;
+      if (mode === "bounded") {
+        return { cursor, pages, emptyPolls };
+      }
+      await sleep(emptyBackoffMs, opts.signal);
+      continue;
+    }
+    return { cursor, pages, emptyPolls };
+  }
+  return { cursor, pages, emptyPolls };
+}
+
 // src/index-api/client.ts
 function firstWalkFromHeight(params) {
   if (params.fromHeight !== undefined)
@@ -461,6 +735,15 @@ class Index extends BaseClient {
   discover() {
     return this.request("GET", "/v1/index");
   }
+  async printSchema(contractId) {
+    try {
+      return await this.request("GET", `/v1/index/contracts/${encodeURIComponent(contractId)}/print-schema`);
+    } catch (err) {
+      if (err instanceof ApiError && err.status === 404)
+        return null;
+      throw err;
+    }
+  }
   ftTransfers = Object.assign((params = {}) => this.listFtTransfers(params), {
     list: (params = {}) => this.listFtTransfers(params),
     walk: (params = {}) => this.walkFtTransfers(params)
@@ -471,11 +754,41 @@ class Index extends BaseClient {
   });
   events = Object.assign((params) => this.listEvents(params), {
     list: (params) => this.listEvents(params),
-    walk: (params) => this.walkEvents(params)
+    walk: (params) => this.walkEvents(params),
+    consume: (params) => consumeIndexFeed({
+      ...params,
+      fetchPage: ({ cursor, fromHeight, limit }) => this.listEvents({
+        eventType: params.eventType,
+        contractId: params.contractId,
+        assetIdentifier: params.assetIdentifier,
+        sender: params.sender,
+        recipient: params.recipient,
+        trait: params.trait,
+        toHeight: params.toHeight,
+        cursor,
+        fromHeight,
+        limit
+      }),
+      itemsOf: (envelope) => envelope.events
+    })
   });
   contractCalls = {
     list: (params = {}) => this.listContractCalls(params),
-    walk: (params = {}) => this.walkContractCalls(params)
+    walk: (params = {}) => this.walkContractCalls(params),
+    consume: (params) => consumeIndexFeed({
+      ...params,
+      fetchPage: ({ cursor, fromHeight, limit }) => this.listContractCalls({
+        contractId: params.contractId,
+        functionName: params.functionName,
+        sender: params.sender,
+        trait: params.trait,
+        toHeight: params.toHeight,
+        cursor,
+        fromHeight,
+        limit
+      }),
+      itemsOf: (envelope) => envelope.contract_calls
+    })
   };
   canonical = {
     list: (params = {}) => this.listCanonical(params),
@@ -896,221 +1209,6 @@ class Projects extends BaseClient {
 // src/streams/client.ts
 import { ed25519 as ed255192 } from "@secondlayer/shared";
 
-// src/streams/errors.ts
-class AuthError extends Error {
-  status = 401;
-  constructor(message = "API key invalid or expired.") {
-    super(message);
-    this.name = "AuthError";
-  }
-}
-
-class RateLimitError extends Error {
-  retryAfter;
-  status = 429;
-  constructor(message = "Rate limited. Try again later.", retryAfter) {
-    super(message);
-    this.retryAfter = retryAfter;
-    this.name = "RateLimitError";
-  }
-}
-
-class ValidationError extends Error {
-  status;
-  body;
-  constructor(message, status, body) {
-    super(message);
-    this.status = status;
-    this.body = body;
-    this.name = "ValidationError";
-  }
-}
-
-class StreamsServerError extends Error {
-  status;
-  body;
-  constructor(message, status, body) {
-    super(message);
-    this.status = status;
-    this.body = body;
-    this.name = "StreamsServerError";
-  }
-}
-
-class StreamsSignatureError extends Error {
-  constructor(message = "Streams response signature verification failed.") {
-    super(message);
-    this.name = "StreamsSignatureError";
-  }
-}
-
-// src/streams/cursor.ts
-var Cursor = {
-  atHeight(height) {
-    return `${height}:0`;
-  },
-  parse(cursor) {
-    const parts = cursor.split(":");
-    const blockHeight = Number(parts[0]);
-    const eventIndex = Number(parts[1]);
-    if (parts.length !== 2 || !Number.isInteger(blockHeight) || !Number.isInteger(eventIndex)) {
-      throw new ValidationError(`Invalid stream cursor "${cursor}"; expected "<block>:<index>" (e.g. "951475:3").`, 400);
-    }
-    return { blockHeight, eventIndex };
-  }
-};
-
-// src/streams/consumer.ts
-function reorgKey(reorg) {
-  return `${reorg.detected_at}|${reorg.fork_point_height}|${reorg.new_canonical_tip}`;
-}
-async function defaultSleep(ms, signal) {
-  if (signal?.aborted)
-    return;
-  await new Promise((resolve) => {
-    const timeout = setTimeout(resolve, ms);
-    if (!signal)
-      return;
-    signal.addEventListener("abort", () => {
-      clearTimeout(timeout);
-      resolve();
-    }, { once: true });
-  });
-}
-async function consumeStreamsEvents(opts) {
-  const sleep = opts.sleep ?? defaultSleep;
-  const mode = opts.mode ?? "tail";
-  const finalizedOnly = opts.finalizedOnly ?? false;
-  const emptyBackoffMs = opts.emptyBackoffMs ?? 500;
-  const maxPages = opts.maxPages ?? Number.POSITIVE_INFINITY;
-  const maxEmptyPolls = opts.maxEmptyPolls ?? Number.POSITIVE_INFINITY;
-  let cursor = opts.fromCursor ?? null;
-  const handledReorgs = new Set;
-  let pages = 0;
-  let emptyPolls = 0;
-  while (pages < maxPages && emptyPolls < maxEmptyPolls && !opts.signal?.aborted) {
-    const envelope = await opts.fetchEvents({
-      cursor,
-      limit: opts.batchSize,
-      types: opts.types,
-      notTypes: opts.notTypes,
-      contractId: opts.contractId,
-      sender: opts.sender,
-      recipient: opts.recipient,
-      assetIdentifier: opts.assetIdentifier
-    });
-    pages++;
-    if (!finalizedOnly && opts.onReorg) {
-      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 });
-          handledReorgs.add(reorgKey(reorg));
-        }
-        cursor = rewind;
-        emptyPolls = 0;
-        continue;
-      }
-    }
-    const emitted = finalizedOnly ? envelope.events.filter((event) => event.finalized) : envelope.events;
-    const checkpoint = finalizedOnly ? emitted.at(-1)?.cursor ?? cursor : envelope.next_cursor;
-    const returnedCursor = await opts.onBatch(emitted, envelope, {
-      cursor: checkpoint
-    });
-    const nextCursor = returnedCursor ?? checkpoint;
-    if (nextCursor && nextCursor !== cursor) {
-      cursor = nextCursor;
-      emptyPolls = 0;
-      continue;
-    }
-    if (emitted.length === 0) {
-      emptyPolls++;
-      if (mode === "bounded") {
-        return { cursor, pages, emptyPolls };
-      }
-      await sleep(emptyBackoffMs, opts.signal);
-      continue;
-    }
-    return { cursor, pages, emptyPolls };
-  }
-  return { cursor, pages, emptyPolls };
-}
-async function* iterateStreamsBatches(opts) {
-  const sleep = opts.sleep ?? defaultSleep;
-  let cursor = opts.fromCursor ?? null;
-  while (!opts.signal?.aborted) {
-    const envelope = await opts.fetchEvents({
-      cursor,
-      limit: opts.batchSize,
-      types: opts.types,
-      notTypes: opts.notTypes,
-      contractId: opts.contractId,
-      sender: opts.sender,
-      recipient: opts.recipient,
-      assetIdentifier: opts.assetIdentifier
-    });
-    const checkpoint = envelope.next_cursor ?? cursor;
-    if (envelope.events.length > 0 || envelope.reorgs.length > 0) {
-      yield {
-        events: envelope.events,
-        cursor: checkpoint,
-        tip: envelope.tip,
-        reorgs: envelope.reorgs
-      };
-    }
-    const advanced = checkpoint !== null && checkpoint !== cursor;
-    cursor = checkpoint;
-    if (!advanced && envelope.events.length === 0) {
-      if (opts.signal?.aborted)
-        return;
-      await sleep(opts.intervalMs, opts.signal);
-    }
-  }
-}
-async function* streamStreamsEvents(opts) {
-  const sleep = opts.sleep ?? defaultSleep;
-  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 pages = 0;
-  let emptyPolls = 0;
-  while (pages < maxPages && emptyPolls < maxEmptyPolls && !opts.signal?.aborted) {
-    const envelope = await opts.fetchEvents({
-      cursor,
-      limit: opts.batchSize,
-      types: opts.types,
-      notTypes: opts.notTypes,
-      contractId: opts.contractId,
-      sender: opts.sender,
-      recipient: opts.recipient,
-      assetIdentifier: opts.assetIdentifier
-    });
-    pages++;
-    for (const event of envelope.events) {
-      if (opts.signal?.aborted)
-        return;
-      yield event;
-    }
-    const nextCursor = envelope.next_cursor;
-    if (nextCursor && nextCursor !== cursor) {
-      cursor = nextCursor;
-      emptyPolls = 0;
-      continue;
-    }
-    if (envelope.events.length === 0) {
-      emptyPolls++;
-      if (emptyPolls >= maxEmptyPolls || pages >= maxPages)
-        return;
-      await sleep(emptyBackoffMs, opts.signal);
-      continue;
-    }
-    return;
-  }
-}
-
 // src/streams/dumps.ts
 import { createHash } from "node:crypto";
 import { verifyStreamsBulkManifestSignature } from "@secondlayer/shared/streams-bulk-manifest";
@@ -2373,6 +2471,7 @@ export {
   decodeClarityValue,
   createX402Client,
   createStreamsClient,
+  consumeIndexFeed,
   buildSignedX402Payment,
   X402SpendGuardError,
   VersionConflictError,
@@ -2394,5 +2493,5 @@ export {
   ApiError
 };
 
-//# debugId=EAC231197163FBBB64756E2164756E21
+//# debugId=97CCB6EA784D158564756E2164756E21
 //# sourceMappingURL=index.js.map