@secondlayer/sdk 10.4.3 → 10.6.0

package/dist/streams/index.js

@@ -159,6 +159,30 @@ function parseRetryAfter(value) {
 }
 
 // src/base.ts
+class MemoryEtagCache {
+  limit;
+  entries = new Map;
+  constructor(limit = 64) {
+    this.limit = limit;
+  }
+  get(key) {
+    const entry = this.entries.get(key);
+    if (entry) {
+      this.entries.delete(key);
+      this.entries.set(key, entry);
+    }
+    return entry;
+  }
+  set(key, entry) {
+    this.entries.delete(key);
+    this.entries.set(key, entry);
+    if (this.entries.size > this.limit) {
+      const oldest = this.entries.keys().next().value;
+      if (oldest !== undefined)
+        this.entries.delete(oldest);
+    }
+  }
+}
 var DEFAULT_REQUEST_TIMEOUT_MS = 30000;
 function abortError() {
   return new DOMException("This operation was aborted", "AbortError");
@@ -269,12 +293,14 @@ class BaseClient {
   origin;
   fetchImpl;
   requestTimeoutMs;
+  etagCache;
   constructor(options = {}) {
     this.baseUrl = resolveBaseUrl(options.baseUrl);
     this.apiKey = resolveApiKey(options.apiKey);
     this.origin = options.origin ?? "cli";
     this.requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
     this.fetchImpl = options.fetchImpl ?? ((...args) => fetch(...args));
+    this.etagCache = options.etagCache === false ? null : options.etagCache ?? new MemoryEtagCache;
   }
   static authHeaders(apiKey) {
     const headers = {
@@ -287,11 +313,25 @@ class BaseClient {
   }
   async request(method, path, body, opts = {}) {
     return this.withRequestBudget(opts.signal, async (signal) => {
-      const response = await this.fetchResponse(method, path, body, signal);
+      const cacheKey = method === "GET" && this.etagCache ? `${this.baseUrl}${path}` : null;
+      const cached = cacheKey ? await this.etagCache?.get(cacheKey) : undefined;
+      const response = await this.fetchResponse(method, path, body, signal, cached ? { "If-None-Match": cached.etag } : undefined);
       if (response.status === 204) {
         return;
       }
-      return await raceAbort(response.json(), signal);
+      if (response.status === 304) {
+        if (!cached) {
+          throw new ApiError(304, "Not Modified without a cached copy");
+        }
+        return JSON.parse(cached.body);
+      }
+      const etag = cacheKey ? response.headers.get("ETag") : null;
+      if (!cacheKey || !etag) {
+        return await raceAbort(response.json(), signal);
+      }
+      const text = await raceAbort(response.text(), signal);
+      await this.etagCache?.set(cacheKey, { etag, body: text });
+      return JSON.parse(text);
     });
   }
   async requestOrNull(method, path, body, opts = {}) {
@@ -334,9 +374,12 @@ class BaseClient {
       callerSignal?.removeEventListener("abort", forward);
     }
   }
-  async fetchResponse(method, path, body, signal) {
+  async fetchResponse(method, path, body, signal, extraHeaders) {
     const url = `${this.baseUrl}${path}`;
-    const headers = BaseClient.authHeaders(this.apiKey);
+    const headers = {
+      ...BaseClient.authHeaders(this.apiKey),
+      ...extraHeaders
+    };
     headers["x-sl-origin"] = this.origin;
     let serializedBody;
     if (body !== undefined && body !== null) {
@@ -361,6 +404,8 @@ class BaseClient {
         throw err;
       throw new ApiError(0, `Cannot reach API at ${this.baseUrl}. Check your connection or try again.`, undefined, undefined, { retryable: true, cause: err instanceof Error ? err : undefined });
     }
+    if (response.status === 304)
+      return response;
     if (!response.ok) {
       const errorBody = signal ? await raceAbort(response.text(), signal) : await response.text();
       const envelope = parseErrorEnvelope(errorBody);
@@ -1475,38 +1520,38 @@ import {
   STREAMS_EVENT_TYPES
 } from "@secondlayer/shared/streams-rows";
 export {
-  isStxTransfer,
-  isStxMint,
-  isStxLock,
-  isStxBurn,
-  isPrint,
-  isNftTransfer,
-  isNftMint,
-  isNftBurn,
-  isFtTransfer,
-  isFtMint,
-  isFtBurn,
-  decodeStxTransfer,
-  decodeStxMint,
-  decodeStxLock,
-  decodeStxBurn,
-  decodePrint,
-  decodeNftTransfer,
-  decodeNftMint,
-  decodeNftBurn,
-  decodeFtTransfer,
-  decodeFtMint,
-  decodeFtBurn,
-  decode,
-  createStreamsClient,
-  ValidationError,
-  StreamsSignatureError,
-  StreamsServerError,
-  STREAMS_EVENT_TYPES,
-  RateLimitError,
+  AuthError,
   Cursor,
-  AuthError
+  RateLimitError,
+  STREAMS_EVENT_TYPES,
+  StreamsServerError,
+  StreamsSignatureError,
+  ValidationError,
+  createStreamsClient,
+  decode,
+  decodeFtBurn,
+  decodeFtMint,
+  decodeFtTransfer,
+  decodeNftBurn,
+  decodeNftMint,
+  decodeNftTransfer,
+  decodePrint,
+  decodeStxBurn,
+  decodeStxLock,
+  decodeStxMint,
+  decodeStxTransfer,
+  isFtBurn,
+  isFtMint,
+  isFtTransfer,
+  isNftBurn,
+  isNftMint,
+  isNftTransfer,
+  isPrint,
+  isStxBurn,
+  isStxLock,
+  isStxMint,
+  isStxTransfer
 };
 
-//# debugId=67918C210E187D1F64756E2164756E21
+//# debugId=DA295DDA55543B7064756E2164756E21
 //# sourceMappingURL=index.js.map