@secondlayer/subgraphs 3.11.0 → 3.13.0

package/dist/src/runtime/reindex.d.ts

@@ -165,6 +165,13 @@ interface SubgraphContext {
 	update(table: string, where: Record<string, unknown>, set: Record<string, unknown>): void;
 	upsert(table: string, key: Record<string, unknown>, row: Record<string, unknown>): void;
 	delete(table: string, where: Record<string, unknown>): void;
+	/**
+	* Atomic counter update — the blessed accumulator primitive. Applies
+	* `col = COALESCE(col, 0) + delta` per column (insert-or-add); deltas may
+	* be negative. Requires a uniqueKeys constraint matching `key`. Prefer
+	* this over patchOrInsert with functional updaters for running totals.
+	*/
+	increment(table: string, key: Record<string, unknown>, deltas: Record<string, bigint | number>): void;
 	/** Partial update — sets only specified fields, preserves others */
 	patch(table: string, where: Record<string, unknown>, set: Record<string, unknown>): void;
 	/** Find-then-merge-or-insert. Values can be functions: (existing) => newValue */
@@ -196,6 +203,9 @@ interface SubgraphDefinition {
 	description?: string;
 	/** Block height to start indexing from (default: 1) */
 	startBlock?: number;
+	/** 'concurrent' = tip-first: live at tip now, history backfills behind.
+	*  Requires order-tolerant handlers. Default 'blocking'. */
+	backfillMode?: "blocking" | "concurrent";
 	/** Named source filters — keys become handler keys */
 	sources: Record<string, SubgraphFilter>;
 	/** Tables in this subgraph */
@@ -225,6 +235,8 @@ interface ReindexOptions {
 	fromBlock?: number;
 	toBlock?: number;
 	schemaName?: string;
+	/** Op row to receive processed_events on each progress flush. */
+	operationId?: string;
 	signal?: AbortSignal;
 }
 /**
@@ -242,6 +254,7 @@ declare function reindexSubgraph(def: SubgraphDefinition, opts?: ReindexOptions)
 */
 declare function resumeReindex(def: SubgraphDefinition, opts: {
 	schemaName: string
+	operationId?: string
 	signal?: AbortSignal
 }): Promise<{
 	processed: number
@@ -255,6 +268,7 @@ declare function backfillSubgraph(def: SubgraphDefinition, opts: {
 	fromBlock: number
 	toBlock: number
 	schemaName?: string
+	operationId?: string
 	signal?: AbortSignal
 }): Promise<{
 	processed: number