@secondlayer/subgraphs 3.12.0 → 3.14.0

package/dist/src/index.d.ts

@@ -206,6 +206,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 */
@@ -657,6 +664,52 @@ declare function defineSubgraph<
 	const Sources extends Record<string, SubgraphFilter>,
 	const S extends SubgraphSchema
 >(def: TypedSubgraphDefinition<Sources, S>): TypedSubgraphDefinition<Sources, S>;
+/**
+* Empirical print-payload schema inference. Callers (the index print-schema
+* endpoint) extract topic + raw Clarity hex per row; this module deserializes
+* a bounded sample per topic, unifies the observed value shapes into a single
+* structural tree, and renders Clarity/TS/ColumnType views of each field.
+*/
+interface PrintSample {
+	blockHeight: number;
+	topic: string;
+	rawHex: string | null;
+}
+interface InferredPrintField {
+	/** Original kebab-case tuple key (the `topic` discriminant is excluded) */
+	name: string;
+	/** What handlers see on `e.data` — exact runner camelization */
+	camel_name: string;
+	/** Rendered Clarity type; buff/string lengths are the max observed */
+	clarity_type: string;
+	/** Decoded handler value type (uint→bigint, buffer→string, …) */
+	ts_type: string;
+	column_type: ColumnType;
+	/** Present in 100% of this topic's decoded samples */
+	always_present: boolean;
+	/** Only when optional observed: share of present samples that were some */
+	optional_some_rate?: number;
+}
+interface InferredTopicSchema {
+	topic: string;
+	count: number;
+	first_height: number;
+	last_height: number;
+	non_tuple: boolean;
+	fields: InferredPrintField[];
+}
+/**
+* Kebab-case → camelCase using the exact runner regex, so `camel_name`
+* matches what handlers see on `e.data` (runner.ts camelizeKeys).
+*/
+declare function camelizeDataKey(str: string): string;
+/**
+* Infers per-topic field schemas from sampled print events. Counts and
+* height bounds cover ALL rows of a topic (cheap); only a bounded subset is
+* deserialized for typing. Rows with missing/undecodable hex still count but
+* contribute nothing to typing.
+*/
+declare function inferPrintTopics(samples: PrintSample[]): InferredTopicSchema[];
 interface GeneratedSQL {
 	statements: string[];
 	hash: string;
@@ -822,4 +875,4 @@ type SparseProbeTarget = {
 declare function canSparseScan(subgraph: SubgraphDefinition): boolean;
 /** Probe targets for a subgraph's filters: decoded type + contract scope when\\n*  the filter pins one (assetIdentifier "SP….contract::asset" or contractId). */
 declare function sparseProbeTargets(subgraph: SubgraphDefinition): SparseProbeTarget[];
-export { validateSubgraphDefinition, sparseProbeTargets, resumeReindex, renderDeployPlan, reindexSubgraph, pgSchemaName, hasBreakingChanges, generateSubgraphSQL, generatePrismaSchema, generateKyselySchema, generateIndexSchema, generateDrizzleSchema, diffSchema, deploySchema, defineSubgraph, canSparseScan, 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, SparseProbeTarget, RowValue, ReindexOptions, PrismaGenOptions, PrintEventPayload, PrintEventFor, PrintEventFilter, NftTransferPayload, NftTransferFilter, NftMintPayload, NftMintFilter, NftBurnPayload, NftBurnFilter, KyselyGenOptions, InferTableRow, InferSubgraphClient, InferColumnType, IndexCodegenTarget, IndexCodegenOptions, INDEX_CODEGEN_TABLES, GeneratedSQL, FtTransferPayload, FtTransferFilter, FtMintPayload, FtMintFilter, FtBurnPayload, FtBurnFilter, FindManyOptions, EventForFilter, DrizzleGenOptions, DeployPlan, DeployDiff, ContractDeployPayload, ContractDeployFilter, ContractCallPayload, ContractCallFilter, ContractCallEvent, ComputedValue, ComparisonFilter, ColumnType, ColumnToTS, ColumnDiff, ByoMigrationPlan, ByoBreakingChangeError, AnyEvent, AggregateSpec, AggregateResult };
+export { validateSubgraphDefinition, sparseProbeTargets, resumeReindex, renderDeployPlan, reindexSubgraph, pgSchemaName, inferPrintTopics, hasBreakingChanges, generateSubgraphSQL, generatePrismaSchema, generateKyselySchema, generateIndexSchema, generateDrizzleSchema, diffSchema, deploySchema, defineSubgraph, canSparseScan, camelizeDataKey, 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, SparseProbeTarget, RowValue, ReindexOptions, PrismaGenOptions, PrintSample, PrintEventPayload, PrintEventFor, PrintEventFilter, NftTransferPayload, NftTransferFilter, NftMintPayload, NftMintFilter, NftBurnPayload, NftBurnFilter, KyselyGenOptions, InferredTopicSchema, InferredPrintField, InferTableRow, InferSubgraphClient, InferColumnType, IndexCodegenTarget, IndexCodegenOptions, INDEX_CODEGEN_TABLES, GeneratedSQL, FtTransferPayload, FtTransferFilter, FtMintPayload, FtMintFilter, FtBurnPayload, FtBurnFilter, FindManyOptions, EventForFilter, DrizzleGenOptions, DeployPlan, DeployDiff, ContractDeployPayload, ContractDeployFilter, ContractCallPayload, ContractCallFilter, ContractCallEvent, ComputedValue, ComparisonFilter, ColumnType, ColumnToTS, ColumnDiff, ByoMigrationPlan, ByoBreakingChangeError, AnyEvent, AggregateSpec, AggregateResult };