@secondlayer/sdk 10.6.0 → 12.0.0

package/dist/subgraphs/index.d.ts

@@ -179,7 +179,7 @@ declare class Subgraphs extends BaseClient {
 	* pass an apiKey on the client where reads are closed. Resume with the
 	* returned `next_cursor`.
 	*/
-	rows<T = unknown>(name: string, table: string, params?: Omit<SubgraphQueryParams, "offset" | "sort"> & {
+	rows<T = unknown>(name: string, table: string, params?: Omit<SubgraphQueryParams, "offset"> & {
 		cursor?: string;
 	}): Promise<SubgraphRowsEnvelope<T>>;
 	/** Recent reindex/backfill operations for a subgraph, newest first. */
@@ -201,11 +201,14 @@ declare class Subgraphs extends BaseClient {
 	bundle(data: {
 		code: string;
 	}): Promise<BundleSubgraphResponse>;
-	queryTable(name: string, table: string, params?: SubgraphQueryParams): Promise<unknown[]>;
-	queryTableCount(name: string, table: string, params?: SubgraphQueryParams): Promise<{
+	/** Open /v1 read: exact row count for a filtered set. Same auth posture as
+	*  {@link rows}. */
+	count(name: string, table: string, params?: Pick<SubgraphQueryParams, "filters">): Promise<{
 		count: number;
 	}>;
-	queryTableAggregate(name: string, table: string, params?: SubgraphAggregateParams): Promise<SubgraphAggregateResponse>;
+	/** Open /v1 read: scalar aggregates over a filtered set. Same auth posture
+	*  as {@link rows}. */
+	aggregate(name: string, table: string, params?: SubgraphAggregateParams): Promise<SubgraphAggregateResponse>;
 	/**
 	* Returns a typed client for a subgraph defined with `defineSubgraph()`.
 	* Row types are inferred from the subgraph's schema literal types.
@@ -214,8 +217,9 @@ declare class Subgraphs extends BaseClient {
 	* ```ts
 	* import mySubgraph from './subgraphs/my-token-subgraph'
 	* const client = sl.subgraphs.typed(mySubgraph)
-	* const rows = await client.transfers.findMany({ where: { sender: 'SP...' } })
-	* // rows: InferTableRow<typeof mySubgraph.schema.transfers>[]
+	* const page = await client.transfers.findMany({ where: { sender: 'SP...' } })
+	* // page.rows: InferTableRow<typeof mySubgraph.schema.transfers>[]
+	* // page.nextCursor: string | null — pass back as `cursor` to resume
 	* ```
 	*/
 	typed<T extends {
@@ -2659,7 +2663,7 @@ declare class SecondLayer extends BaseClient {
 * import { getSubgraph } from '@secondlayer/sdk'
 *
 * const client = getSubgraph(mySubgraph, { apiKey: 'sl_...' })
-* const rows = await client.transfers.findMany({ where: { sender: 'SP...' } })
+* const page = await client.transfers.findMany({ where: { sender: 'SP...' } })
 * ```
 */
 declare function getSubgraph<T extends {

package/dist/subgraphs/index.js

@@ -198,7 +198,6 @@ function raceAbort(promise, signal) {
 var LOCAL_API_URL = "http://127.0.0.1:3800";
 var INSTANCE_TOKEN_ENV = "INSTANCE_TOKEN";
 var ACCOUNT_KEY_ENV = "SECONDLAYER_API_KEY";
-var warnedUrlAlias = false;
 function resolveBaseUrl(explicit) {
   if (explicit && explicit.length > 0)
     return explicit.replace(/\/+$/, "");
@@ -206,14 +205,6 @@ function resolveBaseUrl(explicit) {
     const primary = process.env?.SECONDLAYER_API_URL || undefined;
     if (primary)
       return primary.replace(/\/+$/, "");
-    const legacy = process.env?.SL_API_URL || undefined;
-    if (legacy) {
-      if (!warnedUrlAlias) {
-        warnedUrlAlias = true;
-        console.warn("[secondlayer] SL_API_URL is a legacy alias of SECONDLAYER_API_URL; using the alias this once.");
-      }
-      return legacy.replace(/\/+$/, "");
-    }
   }
   return LOCAL_API_URL;
 }
@@ -225,26 +216,12 @@ function resolveApiKey(apiKey) {
   const token = process.env?.INSTANCE_TOKEN || undefined;
   return token;
 }
-var warnedArchiveAlias = false;
 function resolveAccountKey(accountKey) {
   if (accountKey !== undefined)
     return accountKey;
   if (typeof process === "undefined")
     return;
-  const primary = process.env?.SECONDLAYER_API_KEY || undefined;
-  const slAlias = process.env?.SL_API_KEY || undefined;
-  const archiveAlias = process.env?.SL_ARCHIVE_API_KEY || undefined;
-  if (primary)
-    return primary;
-  const legacy = slAlias ?? archiveAlias;
-  if (legacy) {
-    if (!warnedArchiveAlias) {
-      warnedArchiveAlias = true;
-      console.warn("[secondlayer] SL_API_KEY / SL_ARCHIVE_API_KEY are legacy aliases of SECONDLAYER_API_KEY; using the alias this once.");
-    }
-    return legacy;
-  }
-  return;
+  return process.env?.SECONDLAYER_API_KEY || undefined;
 }
 function seg(value) {
   return encodeURIComponent(String(value));
@@ -730,7 +707,6 @@ function buildSubgraphQueryString(params) {
     _sort: params.sort,
     _order: params.order,
     _limit: params.limit,
-    _offset: params.offset,
     _fields: params.fields,
     ...params.filters
   });
@@ -808,15 +784,11 @@ class Subgraphs extends BaseClient {
   async bundle(data) {
     return this.request("POST", "/api/subgraphs/bundle", data);
   }
-  async queryTable(name, table, params = {}) {
-    const result = await this.request("GET", `/api/subgraphs/${seg(name)}/${seg(table)}${buildSubgraphQueryString(params)}`);
-    return Array.isArray(result) ? result : result.data;
-  }
-  async queryTableCount(name, table, params = {}) {
-    return this.request("GET", `/api/subgraphs/${seg(name)}/${seg(table)}/count${buildSubgraphQueryString(params)}`);
+  async count(name, table, params = {}) {
+    return this.request("GET", `/v1/subgraphs/${seg(name)}/${seg(table)}/count${buildSubgraphQueryString(params)}`);
   }
-  async queryTableAggregate(name, table, params = {}) {
-    return this.request("GET", `/api/subgraphs/${seg(name)}/${seg(table)}/aggregate${buildAggregateQueryString(params)}`);
+  async aggregate(name, table, params = {}) {
+    return this.request("GET", `/v1/subgraphs/${seg(name)}/${seg(table)}/aggregate${buildAggregateQueryString(params)}`);
   }
   typed(def) {
     const result = {};
@@ -833,32 +805,41 @@ class Subgraphs extends BaseClient {
         let sort;
         let order;
         if (options.orderBy) {
-          const entries = Array.isArray(options.orderBy) ? options.orderBy : Object.entries(options.orderBy);
-          if (entries.length > 0) {
-            sort = entries.map(([col]) => resolveOrderByColumn(col, columns)).join(",");
-            order = entries.map(([, dir]) => dir ?? "asc").join(",");
+          const entries = Object.entries(options.orderBy);
+          if (entries.length > 1) {
+            throw new Error(`findMany orderBy accepts a single column; got ${entries.length}: ${entries.map(([col]) => col).join(", ")}. Sort one column — the cursor pairs it with _id as a tiebreaker.`);
+          }
+          const entry = entries[0];
+          if (entry) {
+            const [col, dir] = entry;
+            sort = resolveOrderByColumn(col, columns);
+            order = dir ?? "asc";
           }
         }
-        const params = {
+        const result = await self.rows(subgraphName, tableName, {
           sort,
           order,
           limit: options.limit,
-          offset: options.offset,
           fields: options.fields?.join(","),
-          filters
+          filters,
+          cursor: options.cursor
+        });
+        return {
+          rows: result.rows,
+          nextCursor: result.next_cursor,
+          tip: result.tip
         };
-        return self.queryTable(subgraphName, tableName, params);
       },
       async count(where) {
         const filters = where ? serializeWhere(where, columns) : undefined;
-        const result = await self.queryTableCount(subgraphName, tableName, {
+        const result = await self.count(subgraphName, tableName, {
           filters
         });
         return result.count;
       },
       async aggregate(spec) {
         const filters = spec.where ? serializeWhere(spec.where, columns) : undefined;
-        const result = await self.queryTableAggregate(subgraphName, tableName, {
+        const result = await self.aggregate(subgraphName, tableName, {
           filters,
           count: spec.count,
           countDistinct: spec.countDistinct,
@@ -2688,5 +2669,5 @@ export {
   getSubgraph
 };
 
-//# debugId=8E4B27D4BE8A894F64756E2164756E21
+//# debugId=351ADA07395C9F6764756E2164756E21
 //# sourceMappingURL=index.js.map