@secondlayer/sdk 9.0.0 → 9.0.2

package/dist/index.d.ts

@@ -2435,7 +2435,7 @@ declare function getSubgraph<T extends {
 	schema: Record<string, unknown>;
 }>(def: T, options?: Partial<SecondLayerOptions> | SecondLayer | Subgraphs): InferSubgraphClient2<T>;
 type CreateStreamsClientOptions = {
-	apiKey: string;
+	apiKey?: string;
 	baseUrl?: string;
 	fetchImpl?: FetchLike2;
 	/**
@@ -2606,7 +2606,9 @@ import { DecodedEventColumns, DecodedEventRow, DecodedFtBurn, DecodedFtBurnPaylo
 * Helpers for Streams cursors. A cursor is the opaque `<block>:<index>` string
 * that marks a position in the event stream; treat the format as an
 * implementation detail and go through these helpers instead of string-building
-* it at call sites.
+* it at call sites. Encode/decode and the rewind sentinel come from the
+* canonical codec in `@secondlayer/shared` so the SDK cannot accept a spelling
+* the server would 400, or rewind to a different foot than Index/Streams.
 */
 declare const Cursor: {
 	/**
@@ -2618,7 +2620,7 @@ declare const Cursor: {
 	* is `height`: the new canonical block at `height` carries a fresh first
 	* event at `(height, 0)` that the consumer MUST re-read.
 	*
-	* Encoded as `${height-1}:${SENTINEL}` rather than the seemingly-natural
+	* Encoded as `blockEndCursor(height - 1)` rather than the seemingly-natural
 	* `${height}:0` — that earlier form was an off-by-one: being exclusive, it
 	* skipped `(height, 0)`, silently dropping the fork block's first row on
 	* every reorg. The sentinel is int4 max (the `event_index`/`tx_index` column

package/dist/index.js

@@ -512,6 +512,13 @@ class Contracts extends BaseClient {
   }
 }
 
+// src/streams/cursor.ts
+import {
+  blockEndCursor,
+  decodeStreamsCursor,
+  encodeStreamsCursor
+} from "@secondlayer/shared";
+
 // src/streams/errors.ts
 class StreamsServerError extends ApiError {
   constructor(message, status, body) {
@@ -528,21 +535,23 @@ class StreamsSignatureError extends SecondLayerError {
 }
 
 // src/streams/cursor.ts
-var REWIND_FOOT_INDEX_SENTINEL = 2147483647;
 var Cursor = {
   atHeight(height) {
-    if (height <= 0)
-      return "0:0";
-    return `${height - 1}:${REWIND_FOOT_INDEX_SENTINEL}`;
+    if (height <= 0) {
+      return encodeStreamsCursor({ block_height: 0, event_index: 0 });
+    }
+    return encodeStreamsCursor(blockEndCursor(height - 1));
   },
   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)) {
+    try {
+      const decoded = decodeStreamsCursor(cursor);
+      return {
+        blockHeight: decoded.block_height,
+        eventIndex: decoded.event_index
+      };
+    } catch {
       throw new ValidationError(`Invalid stream cursor "${cursor}"; expected "<block>:<index>" (e.g. "951475:3").`, 400);
     }
-    return { blockHeight, eventIndex };
   }
 };
 
@@ -1476,7 +1485,7 @@ function subscribeStreamsEvents(opts) {
         })}`;
         const res = await opts.fetchImpl(url, {
           headers: {
-            Authorization: `Bearer ${opts.apiKey}`,
+            ...opts.apiKey ? { Authorization: `Bearer ${opts.apiKey}` } : {},
             Accept: "text/event-stream"
           },
           signal: controller.signal
@@ -1585,12 +1594,8 @@ function parseFrame(raw) {
 function cursorTuple(cursor) {
   if (!cursor)
     return [-1, -1];
-  const parts = cursor.split(":");
-  const [block, index] = parts.map(Number);
-  if (parts.length !== 2 || !Number.isInteger(block) || !Number.isInteger(index)) {
-    throw new ValidationError(`Invalid stream cursor "${cursor}"; expected "<block>:<index>" (e.g. "951475:3").`, 400);
-  }
-  return [block, index];
+  const { blockHeight, eventIndex } = Cursor.parse(cursor);
+  return [blockHeight, eventIndex];
 }
 function maxCursor(a, b) {
   const [ah, ai] = cursorTuple(a);
@@ -1687,7 +1692,7 @@ function createStreamsClient(options) {
   });
   async function request(path) {
     const response = await fetchImpl(`${baseUrl}${path}`, {
-      headers: { Authorization: `Bearer ${options.apiKey}` }
+      headers: options.apiKey ? { Authorization: `Bearer ${options.apiKey}` } : {}
     });
     if (!response.ok)
       await mapStreamsError(response);
@@ -1922,7 +1927,7 @@ class SecondLayer extends BaseClient {
   constructor(options = {}) {
     super(options);
     this.streams = createStreamsClient({
-      apiKey: resolveApiKey(options.apiKey) ?? "",
+      apiKey: resolveApiKey(options.apiKey),
       baseUrl: options.baseUrl,
       fetchImpl: options.fetchImpl,
       dumpsBaseUrl: options.dumpsBaseUrl
@@ -2276,5 +2281,5 @@ export {
   ApiError
 };
 
-//# debugId=968797F41364DCA764756E2164756E21
+//# debugId=9A05B56B79C1360464756E2164756E21
 //# sourceMappingURL=index.js.map