@secondlayer/subgraphs 3.4.0 → 3.5.0

package/dist/src/index.d.ts

@@ -346,9 +346,24 @@ interface FindManyOptions<TRow> {
 	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 {
@@ -681,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.4.0",
+	"version": "3.5.0",
 	"license": "MIT",
 	"repository": {
 		"type": "git",