@secondlayer/sdk 10.6.0 → 11.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

@@ -730,7 +730,6 @@ function buildSubgraphQueryString(params) {
     _sort: params.sort,
     _order: params.order,
     _limit: params.limit,
-    _offset: params.offset,
     _fields: params.fields,
     ...params.filters
   });
@@ -808,15 +807,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 count(name, table, params = {}) {
+    return this.request("GET", `/v1/subgraphs/${seg(name)}/${seg(table)}/count${buildSubgraphQueryString(params)}`);
   }
-  async queryTableCount(name, table, params = {}) {
-    return this.request("GET", `/api/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 +828,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 +2692,5 @@ export {
   getSubgraph
 };
 
-//# debugId=8E4B27D4BE8A894F64756E2164756E21
+//# debugId=0162A8C28478658D64756E2164756E21
 //# sourceMappingURL=index.js.map