@secondlayer/subgraphs 3.3.0 → 3.5.0

package/dist/src/index.d.ts

@@ -308,6 +308,12 @@ type ComparisonFilter<T> = {
 	gte?: T
 	lt?: T
 	lte?: T
+	/** Match any value in the set. */
+	in?: T[]
+	/** Match none of the values in the set. */
+	notIn?: T[]
+	/** SQL ILIKE pattern (case-insensitive); `%`/`_` wildcards. Strings only. */
+	like?: string
 };
 /** Where clause — each column accepts a scalar (eq) or comparison object */
 type WhereInput<TRow> = { [K in keyof TRow]? : TRow[K] | ComparisonFilter<TRow[K]> };
@@ -327,16 +333,37 @@ type SystemOrderByAliases = {
 	createdAt?: "asc" | "desc"
 	id?: "asc" | "desc"
 };
+/** Ordered list form for deterministic multi-column sort. */
+type OrderByList<TRow> = Array<[keyof (TRow & SystemOrderByAliases) & string, "asc" | "desc"]>;
 interface FindManyOptions<TRow> {
 	where?: WhereInput<TRow> & SystemWhereAliases;
-	orderBy?: { [K in keyof TRow]? : "asc" | "desc" } & SystemOrderByAliases;
+	/**
+	* Single-key object (common case) OR an ordered `[column, direction][]` list
+	* for deterministic multi-column sort (object key order isn't guaranteed).
+	*/
+	orderBy?: ({ [K in keyof TRow]? : "asc" | "desc" } & SystemOrderByAliases) | OrderByList<TRow>;
 	limit?: number;
 	offset?: number;
 	fields?: (keyof TRow & string)[];
 }
+/** Options for the realtime row stream (SSE). */
+interface SubscribeOptions<TRow> {
+	/** Same column filters as `findMany`, applied server-side per row. */
+	where?: WhereInput<TRow> & SystemWhereAliases;
+	/** Replay rows from this block height, then tail live. Omit for go-forward only. */
+	since?: number;
+	/** Called on stream/connection errors. */
+	onError?: (err: unknown) => void;
+}
 interface SubgraphTableClient<TRow> {
 	findMany(options?: FindManyOptions<TRow>): Promise<TRow[]>;
 	count(where?: WhereInput<TRow> & SystemWhereAliases): Promise<number>;
+	/**
+	* Stream rows as they're indexed over Server-Sent Events. `onRow` fires for
+	* each new row (block-cadence). Returns an unsubscribe function that closes
+	* the connection. Requires a global `EventSource` (browsers, Node >= 22).
+	*/
+	subscribe(onRow: (row: TRow) => void, options?: SubscribeOptions<TRow>): () => void;
 }
 /** A column is optional on insert when it's nullable or has a SQL default. */
 type IsOptionalColumn<C> = C extends {
@@ -669,4 +696,4 @@ declare function deploySchema(db: AnyDb, def: SubgraphDefinition, handlerPath: s
 	version: string
 	diff?: DeployDiff
 }>;
-export { validateSubgraphDefinition, resumeReindex, renderDeployPlan, reindexSubgraph, pgSchemaName, generateSubgraphSQL, generatePrismaSchema, generateDrizzleSchema, diffSchema, deploySchema, defineSubgraph, backfillSubgraph, WriteRow, WhereInput, TypedSubgraphDefinition, TypedSubgraphContext, TypedHandlers, TxMeta, TableDiff, SystemRow, SubgraphTableClient, SubgraphTable, SubgraphSchema, SubgraphHandler, SubgraphFilter, SubgraphDefinition, SubgraphContext, SubgraphColumn, StxTransferPayload, StxTransferFilter, StxMintPayload, StxMintFilter, StxLockPayload, StxLockFilter, StxBurnPayload, StxBurnFilter, RowValue, ReindexOptions, PrismaGenOptions, PrintEventPayload, PrintEventFor, PrintEventFilter, NftTransferPayload, NftTransferFilter, NftMintPayload, NftMintFilter, NftBurnPayload, NftBurnFilter, InferTableRow, InferSubgraphClient, InferColumnType, GeneratedSQL, FtTransferPayload, FtTransferFilter, FtMintPayload, FtMintFilter, FtBurnPayload, FtBurnFilter, FindManyOptions, EventForFilter, DrizzleGenOptions, DeployPlan, ContractDeployPayload, ContractDeployFilter, ContractCallPayload, ContractCallFilter, ContractCallEvent, ComputedValue, ComparisonFilter, ColumnType, ColumnToTS, ColumnDiff, AnyEvent };
+export { validateSubgraphDefinition, resumeReindex, renderDeployPlan, reindexSubgraph, pgSchemaName, generateSubgraphSQL, generatePrismaSchema, generateDrizzleSchema, diffSchema, deploySchema, defineSubgraph, backfillSubgraph, WriteRow, WhereInput, TypedSubgraphDefinition, TypedSubgraphContext, TypedHandlers, TxMeta, TableDiff, SystemRow, SubscribeOptions, SubgraphTableClient, SubgraphTable, SubgraphSchema, SubgraphHandler, SubgraphFilter, SubgraphDefinition, SubgraphContext, SubgraphColumn, StxTransferPayload, StxTransferFilter, StxMintPayload, StxMintFilter, StxLockPayload, StxLockFilter, StxBurnPayload, StxBurnFilter, RowValue, ReindexOptions, PrismaGenOptions, PrintEventPayload, PrintEventFor, PrintEventFilter, NftTransferPayload, NftTransferFilter, NftMintPayload, NftMintFilter, NftBurnPayload, NftBurnFilter, InferTableRow, InferSubgraphClient, InferColumnType, GeneratedSQL, FtTransferPayload, FtTransferFilter, FtMintPayload, FtMintFilter, FtBurnPayload, FtBurnFilter, FindManyOptions, EventForFilter, DrizzleGenOptions, DeployPlan, ContractDeployPayload, ContractDeployFilter, ContractCallPayload, ContractCallFilter, ContractCallEvent, ComputedValue, ComparisonFilter, ColumnType, ColumnToTS, ColumnDiff, AnyEvent };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@secondlayer/subgraphs",
-	"version": "3.3.0",
+	"version": "3.5.0",
 	"license": "MIT",
 	"repository": {
 		"type": "git",