@secondlayer/subgraphs 0.5.7 → 0.7.0

package/dist/src/index.d.ts

@@ -94,6 +94,18 @@ declare function reindexSubgraph(def: SubgraphDefinition, opts?: ReindexOptions)
 	processed: number
 }>;
 /**
+* Backfill a subgraph by re-processing a block range WITHOUT dropping the schema.
+* Uses upserts so existing data is updated, not duplicated. Safe to run while
+* the subgraph is actively syncing.
+*/
+declare function backfillSubgraph(def: SubgraphDefinition, opts: {
+	fromBlock: number
+	toBlock: number
+	schemaName?: string
+}): Promise<{
+	processed: number
+}>;
+/**
 * Identity function that preserves schema literal types for type inference.
 *
 * The generic `S` is narrowed to the exact schema shape so that column type
@@ -126,8 +138,8 @@ interface GeneratedSQL {
 */
 declare function generateSubgraphSQL(def: SubgraphDefinition, schemaNameOverride?: string): GeneratedSQL;
 import { pgSchemaName } from "@secondlayer/shared/db/queries/subgraphs";
-import { Kysely } from "kysely";
 import { Database } from "@secondlayer/shared/db";
+import { Kysely } from "kysely";
 type AnyDb = Kysely<Database>;
 interface TableDiff {
 	/** Tables added to the schema */
@@ -162,13 +174,13 @@ declare function deploySchema(db: AnyDb, def: SubgraphDefinition, handlerPath: s
 	subgraphId: string
 }>;
 /** Maps a ColumnType string literal to its TypeScript equivalent */
-type ColumnToTS<T extends string> = T extends "uint" | "int" ? number : T extends "text" | "principal" | "timestamp" ? string : T extends "boolean" ? boolean : T extends "jsonb" ? Record<string, unknown> : unknown;
+type ColumnToTS<T extends string> = T extends "uint" | "int" ? bigint : T extends "text" | "principal" | "timestamp" ? string : T extends "boolean" ? boolean : T extends "jsonb" ? Record<string, unknown> : unknown;
 /** Infer TS type for a single column definition, respecting nullable */
 type InferColumnType<C extends SubgraphColumn> = C["type"] extends ColumnType ? C["nullable"] extends true ? ColumnToTS<C["type"]> | null : ColumnToTS<C["type"]> : unknown;
 /** Shape of system columns on every returned row (camelCase, underscore-prefixed) */
 interface SystemRow {
 	_id: string;
-	_blockHeight: number;
+	_blockHeight: bigint;
 	_txId: string;
 	_createdAt: string;
 }
@@ -190,7 +202,7 @@ type WhereInput<TRow> = { [K in keyof TRow]? : TRow[K] | ComparisonFilter<TRow[K
 * Both `_blockHeight` and `blockHeight` are valid — serializer handles mapping.
 */
 type SystemWhereAliases = {
-	blockHeight?: number | ComparisonFilter<number>
+	blockHeight?: bigint | ComparisonFilter<bigint>
 	txId?: string | ComparisonFilter<string>
 	createdAt?: string | ComparisonFilter<string>
 	id?: string | ComparisonFilter<string>
@@ -216,4 +228,4 @@ interface SubgraphTableClient<TRow> {
 type InferSubgraphClient<T> = T extends {
 	schema: infer S
 } ? { [K in keyof S] : S[K] extends SubgraphTable ? SubgraphTableClient<InferTableRow<S[K]>> : never } : never;
-export { validateSubgraphDefinition, sourceKey, reindexSubgraph, pgSchemaName, generateSubgraphSQL, diffSchema, deploySchema, defineSubgraph, WhereInput, TableDiff, SystemRow, SubgraphTableClient, SubgraphTable, SubgraphSource, SubgraphSchema, SubgraphHandler, SubgraphDefinition, SubgraphContext, SubgraphColumn, ReindexOptions, InferTableRow, InferSubgraphClient, InferColumnType, GeneratedSQL, FindManyOptions, ComparisonFilter, ColumnType, ColumnToTS, ColumnDiff };
+export { validateSubgraphDefinition, sourceKey, reindexSubgraph, pgSchemaName, generateSubgraphSQL, diffSchema, deploySchema, defineSubgraph, backfillSubgraph, WhereInput, TableDiff, SystemRow, SubgraphTableClient, SubgraphTable, SubgraphSource, SubgraphSchema, SubgraphHandler, SubgraphDefinition, SubgraphContext, SubgraphColumn, ReindexOptions, InferTableRow, InferSubgraphClient, InferColumnType, GeneratedSQL, FindManyOptions, ComparisonFilter, ColumnType, ColumnToTS, ColumnDiff };