@secondlayer/sdk 6.27.0 → 6.27.2

package/dist/index.d.ts

@@ -24,6 +24,9 @@ declare abstract class BaseClient {
 	constructor(options?: Partial<SecondLayerOptions>);
 	static authHeaders(apiKey?: string): Record<string, string>;
 	protected request<T>(method: string, path: string, body?: unknown): Promise<T>;
+	/** Like `request`, but maps a 404 to `null` instead of throwing — the one
+	*  place that owns the "absent resource" rule for `get*` accessors. */
+	protected requestOrNull<T>(method: string, path: string, body?: unknown): Promise<T | null>;
 	protected requestText(method: string, path: string, body?: unknown): Promise<string>;
 	private fetchResponse;
 }

package/dist/index.js

@@ -80,6 +80,15 @@ class BaseClient {
     }
     return response.json();
   }
+  async requestOrNull(method, path, body) {
+    try {
+      return await this.request(method, path, body);
+    } catch (err) {
+      if (err instanceof ApiError && err.status === 404)
+        return null;
+      throw err;
+    }
+  }
   async requestText(method, path, body) {
     const response = await this.fetchResponse(method, path, body);
     return response.text();
@@ -194,44 +203,24 @@ function resolveOrderByColumn(col) {
 
 // src/subgraphs/client.ts
 function buildSubgraphQueryString(params) {
-  const qs = new URLSearchParams;
-  if (params.sort)
-    qs.set("_sort", params.sort);
-  if (params.order)
-    qs.set("_order", params.order);
-  if (params.limit !== undefined)
-    qs.set("_limit", String(params.limit));
-  if (params.offset !== undefined)
-    qs.set("_offset", String(params.offset));
-  if (params.fields)
-    qs.set("_fields", params.fields);
-  if (params.filters) {
-    for (const [key, value] of Object.entries(params.filters)) {
-      qs.set(key, String(value));
-    }
-  }
-  const str = qs.toString();
-  return str ? `?${str}` : "";
+  return buildQuery({
+    _sort: params.sort,
+    _order: params.order,
+    _limit: params.limit,
+    _offset: params.offset,
+    _fields: params.fields,
+    ...params.filters
+  });
 }
 function buildAggregateQueryString(params) {
-  const qs = new URLSearchParams;
-  if (params.filters) {
-    for (const [key, value] of Object.entries(params.filters)) {
-      qs.set(key, String(value));
-    }
-  }
-  if (params.count)
-    qs.set("_count", "true");
-  if (params.countDistinct?.length)
-    qs.set("_countDistinct", params.countDistinct.join(","));
-  if (params.sum?.length)
-    qs.set("_sum", params.sum.join(","));
-  if (params.min?.length)
-    qs.set("_min", params.min.join(","));
-  if (params.max?.length)
-    qs.set("_max", params.max.join(","));
-  const str = qs.toString();
-  return str ? `?${str}` : "";
+  return buildQuery({
+    ...params.filters,
+    _count: params.count ? "true" : undefined,
+    _countDistinct: params.countDistinct,
+    _sum: params.sum,
+    _min: params.min,
+    _max: params.max
+  });
 }
 function buildSpecQueryString(options) {
   return buildQuery({ server: options?.serverUrl });
@@ -364,13 +353,11 @@ class Subgraphs extends BaseClient {
       },
       subscribe(onRow, options = {}) {
         const filters = options.where ? serializeWhere(options.where) : {};
-        const qs = new URLSearchParams;
-        for (const [k, v] of Object.entries(filters))
-          qs.set(k, String(v));
-        if (options.since != null)
-          qs.set("since", String(options.since));
-        const query = qs.toString();
-        const url = `${self.baseUrl}/api/subgraphs/${subgraphName}/${tableName}/stream${query ? `?${query}` : ""}`;
+        const qs = buildQuery({
+          ...filters,
+          since: options.since ?? undefined
+        });
+        const url = `${self.baseUrl}/api/subgraphs/${subgraphName}/${tableName}/stream${qs}`;
         const ES = globalThis.EventSource;
         if (!ES) {
           throw new Error("subscribe() needs a global EventSource (available in browsers and Node >= 22).");
@@ -424,14 +411,8 @@ class Contracts extends BaseClient {
     })}`);
   }
   async get(contractId, opts = {}) {
-    try {
-      const { contract } = await this.request("GET", `/v1/contracts/${encodeURIComponent(contractId)}${opts.includeAbi ? "?include=abi" : ""}`);
-      return contract;
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    const result = await this.requestOrNull("GET", `/v1/contracts/${encodeURIComponent(contractId)}${opts.includeAbi ? "?include=abi" : ""}`);
+    return result?.contract ?? null;
   }
 }
 
@@ -732,13 +713,7 @@ class Index extends BaseClient {
     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;
-    }
+    return this.requestOrNull("GET", `/v1/index/contracts/${encodeURIComponent(contractId)}/print-schema`);
   }
   ftTransfers = Object.assign((params = {}) => this.listFtTransfers(params), {
     list: (params = {}) => this.listFtTransfers(params),
@@ -1033,13 +1008,7 @@ class Index extends BaseClient {
     })}`);
   }
   async getBlock(ref) {
-    try {
-      return await this.request("GET", `/v1/index/blocks/${encodeURIComponent(String(ref))}`);
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    return this.requestOrNull("GET", `/v1/index/blocks/${encodeURIComponent(String(ref))}`);
   }
   async* walkBlocks(params = {}) {
     const batchSize = params.batchSize ?? 200;
@@ -1079,22 +1048,10 @@ class Index extends BaseClient {
     })}`);
   }
   async getTransaction(txId) {
-    try {
-      return await this.request("GET", `/v1/index/transactions/${encodeURIComponent(txId)}`);
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    return this.requestOrNull("GET", `/v1/index/transactions/${encodeURIComponent(txId)}`);
   }
   async getTransactionProof(txId) {
-    try {
-      return await this.request("GET", `/v1/index/transactions/${encodeURIComponent(txId)}/proof`);
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    return this.requestOrNull("GET", `/v1/index/transactions/${encodeURIComponent(txId)}/proof`);
   }
   async* walkTransactions(params = {}) {
     const batchSize = params.batchSize ?? 200;
@@ -1169,13 +1126,7 @@ class Index extends BaseClient {
     })}`);
   }
   async getMempoolTx(txId) {
-    try {
-      return await this.request("GET", `/v1/index/mempool/${encodeURIComponent(txId)}`);
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    return this.requestOrNull("GET", `/v1/index/mempool/${encodeURIComponent(txId)}`);
   }
   async* walkMempool(params = {}) {
     const batchSize = params.batchSize ?? 200;
@@ -1239,13 +1190,7 @@ class Index extends BaseClient {
     }
   }
   async getSbtcDeposit(bitcoinTxid) {
-    try {
-      return await this.request("GET", `/v1/index/sbtc/deposits/${encodeURIComponent(bitcoinTxid)}`);
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    return this.requestOrNull("GET", `/v1/index/sbtc/deposits/${encodeURIComponent(bitcoinTxid)}`);
   }
   async listSbtcWithdrawals(params = {}) {
     return this.request("GET", `/v1/index/sbtc/withdrawals${buildQuery({
@@ -1286,13 +1231,7 @@ class Index extends BaseClient {
     }
   }
   async getSbtcWithdrawal(requestId) {
-    try {
-      return await this.request("GET", `/v1/index/sbtc/withdrawals/${requestId}`);
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    return this.requestOrNull("GET", `/v1/index/sbtc/withdrawals/${requestId}`);
   }
   async listSbtcEvents(params = {}) {
     return this.request("GET", `/v1/index/sbtc/events${buildQuery({
@@ -1360,13 +1299,7 @@ class Index extends BaseClient {
     }
   }
   async getPoxCycle(rewardCycle) {
-    try {
-      return await this.request("GET", `/v1/index/pox/cycles/${rewardCycle}`);
-    } catch (err) {
-      if (err instanceof ApiError && err.status === 404)
-        return null;
-      throw err;
-    }
+    return this.requestOrNull("GET", `/v1/index/pox/cycles/${rewardCycle}`);
   }
 }
 
@@ -2701,5 +2634,5 @@ export {
   ApiError
 };
 
-//# debugId=FEC0971346A0193B64756E2164756E21
+//# debugId=CD88F21B10F170CE64756E2164756E21
 //# sourceMappingURL=index.js.map