@secondlayer/subgraphs 3.0.0 → 3.1.0

package/dist/src/index.d.ts

@@ -137,6 +137,14 @@ interface PrintEventFilter {
 	type: "print_event";
 	contractId?: string;
 	topic?: string;
+	/**
+	* Optional per-topic field schema. When declared, the handler's `event` is
+	* a discriminated union keyed by `topic` and `event.data` is typed per topic
+	* (e.g. `{ "completed-deposit": { amount: "uint", sender: "principal" } }`).
+	* Uses the same `ColumnType` vocab as `schema`; nested fields use `"jsonb"`.
+	* Type-level only — not validated at runtime.
+	*/
+	prints?: Record<string, Record<string, ColumnType>>;
 }
 /** All subgraph filter types — discriminated on `type` */
 type SubgraphFilter = StxTransferFilter | StxMintFilter | StxBurnFilter | StxLockFilter | FtTransferFilter | FtMintFilter | FtBurnFilter | NftTransferFilter | NftMintFilter | NftBurnFilter | ContractCallFilter | ContractDeployFilter | PrintEventFilter;
@@ -246,114 +254,6 @@ declare function backfillSubgraph(def: SubgraphDefinition, opts: {
 }): Promise<{
 	processed: number
 }>;
-interface FtTransferPayload {
-	sender: string;
-	recipient: string;
-	amount: bigint;
-	assetIdentifier: string;
-	tx: TxMeta;
-}
-interface FtMintPayload {
-	recipient: string;
-	amount: bigint;
-	assetIdentifier: string;
-	tx: TxMeta;
-}
-interface FtBurnPayload {
-	sender: string;
-	amount: bigint;
-	assetIdentifier: string;
-	tx: TxMeta;
-}
-interface NftTransferPayload {
-	sender: string;
-	recipient: string;
-	tokenId: unknown;
-	assetIdentifier: string;
-	tx: TxMeta;
-}
-interface NftMintPayload {
-	recipient: string;
-	tokenId: unknown;
-	assetIdentifier: string;
-	tx: TxMeta;
-}
-interface NftBurnPayload {
-	sender: string;
-	tokenId: unknown;
-	assetIdentifier: string;
-	tx: TxMeta;
-}
-interface StxTransferPayload {
-	sender: string;
-	recipient: string;
-	amount: bigint;
-	/** Memo string, or "" when none was attached. */
-	memo: string;
-	tx: TxMeta;
-}
-interface StxMintPayload {
-	recipient: string;
-	amount: bigint;
-	tx: TxMeta;
-}
-interface StxBurnPayload {
-	sender: string;
-	amount: bigint;
-	tx: TxMeta;
-}
-interface StxLockPayload {
-	lockedAddress: string;
-	lockedAmount: bigint;
-	unlockHeight: bigint;
-	tx: TxMeta;
-}
-interface PrintEventPayload {
-	contractId: string;
-	/** Decoded print topic (the Clarity tuple's `topic` field), or "". */
-	topic: string;
-	/**
-	* Remaining decoded tuple fields, camelCased. Empty object when the print
-	* value isn't a tuple. Narrow per `topic` to access typed fields.
-	*/
-	data: Record<string, unknown>;
-	tx: TxMeta;
-}
-interface ContractDeployPayload {
-	contractId: string;
-	deployer: string;
-	tx: TxMeta;
-}
-/** The event payload a handler receives for a given source filter. */
-type EventForFilter<F extends SubgraphFilter> = F extends {
-	type: "print_event"
-} ? PrintEventPayload : F extends {
-	type: "ft_transfer"
-} ? FtTransferPayload : F extends {
-	type: "ft_mint"
-} ? FtMintPayload : F extends {
-	type: "ft_burn"
-} ? FtBurnPayload : F extends {
-	type: "nft_transfer"
-} ? NftTransferPayload : F extends {
-	type: "nft_mint"
-} ? NftMintPayload : F extends {
-	type: "nft_burn"
-} ? NftBurnPayload : F extends {
-	type: "stx_transfer"
-} ? StxTransferPayload : F extends {
-	type: "stx_mint"
-} ? StxMintPayload : F extends {
-	type: "stx_burn"
-} ? StxBurnPayload : F extends {
-	type: "stx_lock"
-} ? StxLockPayload : F extends {
-	type: "contract_call"
-} ? ContractCallEvent : F extends {
-	type: "contract_deploy"
-} ? ContractDeployPayload : never;
-/** Union of every event payload — the `"*"` catch-all handler receives this. */
-type AnyEvent = FtTransferPayload | FtMintPayload | FtBurnPayload | NftTransferPayload | NftMintPayload | NftBurnPayload | StxTransferPayload | StxMintPayload | StxBurnPayload | StxLockPayload | PrintEventPayload | ContractCallEvent | ContractDeployPayload;
 /** Maps a ColumnType string literal to its TypeScript equivalent */
 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 */
@@ -461,6 +361,127 @@ interface TypedSubgraphContext<S extends SubgraphSchema> {
 type InferSubgraphClient<T> = T extends {
 	schema: infer S
 } ? { [K in keyof S] : S[K] extends SubgraphTable ? SubgraphTableClient<InferTableRow<S[K]>> : never } : never;
+interface FtTransferPayload {
+	sender: string;
+	recipient: string;
+	amount: bigint;
+	assetIdentifier: string;
+	tx: TxMeta;
+}
+interface FtMintPayload {
+	recipient: string;
+	amount: bigint;
+	assetIdentifier: string;
+	tx: TxMeta;
+}
+interface FtBurnPayload {
+	sender: string;
+	amount: bigint;
+	assetIdentifier: string;
+	tx: TxMeta;
+}
+interface NftTransferPayload {
+	sender: string;
+	recipient: string;
+	tokenId: unknown;
+	assetIdentifier: string;
+	tx: TxMeta;
+}
+interface NftMintPayload {
+	recipient: string;
+	tokenId: unknown;
+	assetIdentifier: string;
+	tx: TxMeta;
+}
+interface NftBurnPayload {
+	sender: string;
+	tokenId: unknown;
+	assetIdentifier: string;
+	tx: TxMeta;
+}
+interface StxTransferPayload {
+	sender: string;
+	recipient: string;
+	amount: bigint;
+	/** Memo string, or "" when none was attached. */
+	memo: string;
+	tx: TxMeta;
+}
+interface StxMintPayload {
+	recipient: string;
+	amount: bigint;
+	tx: TxMeta;
+}
+interface StxBurnPayload {
+	sender: string;
+	amount: bigint;
+	tx: TxMeta;
+}
+interface StxLockPayload {
+	lockedAddress: string;
+	lockedAmount: bigint;
+	unlockHeight: bigint;
+	tx: TxMeta;
+}
+interface PrintEventPayload {
+	contractId: string;
+	/** Decoded print topic (the Clarity tuple's `topic` field), or "". */
+	topic: string;
+	/**
+	* Remaining decoded tuple fields, camelCased. Empty object when the print
+	* value isn't a tuple. Narrow per `topic` to access typed fields.
+	*/
+	data: Record<string, unknown>;
+	tx: TxMeta;
+}
+interface ContractDeployPayload {
+	contractId: string;
+	deployer: string;
+	tx: TxMeta;
+}
+/**
+* Print event typed per topic. When a `print_event` source declares a `prints`
+* map, the payload is a discriminated union keyed by `topic` with `data` typed
+* per topic; otherwise it falls back to the untyped {@link PrintEventPayload}.
+*/
+type PrintEventFor<F> = F extends {
+	prints: infer P extends Record<string, Record<string, ColumnType>>
+} ? { [K in keyof P] : {
+	contractId: string
+	topic: K
+	data: { [Field in keyof P[K]] : ColumnToTS<P[K][Field]> }
+	tx: TxMeta
+} }[keyof P] : PrintEventPayload;
+/** The event payload a handler receives for a given source filter. */
+type EventForFilter<F extends SubgraphFilter> = F extends {
+	type: "print_event"
+} ? PrintEventFor<F> : F extends {
+	type: "ft_transfer"
+} ? FtTransferPayload : F extends {
+	type: "ft_mint"
+} ? FtMintPayload : F extends {
+	type: "ft_burn"
+} ? FtBurnPayload : F extends {
+	type: "nft_transfer"
+} ? NftTransferPayload : F extends {
+	type: "nft_mint"
+} ? NftMintPayload : F extends {
+	type: "nft_burn"
+} ? NftBurnPayload : F extends {
+	type: "stx_transfer"
+} ? StxTransferPayload : F extends {
+	type: "stx_mint"
+} ? StxMintPayload : F extends {
+	type: "stx_burn"
+} ? StxBurnPayload : F extends {
+	type: "stx_lock"
+} ? StxLockPayload : F extends {
+	type: "contract_call"
+} ? ContractCallEvent : F extends {
+	type: "contract_deploy"
+} ? ContractDeployPayload : never;
+/** Union of every event payload — the `"*"` catch-all handler receives this. */
+type AnyEvent = FtTransferPayload | FtMintPayload | FtBurnPayload | NftTransferPayload | NftMintPayload | NftBurnPayload | StxTransferPayload | StxMintPayload | StxBurnPayload | StxLockPayload | PrintEventPayload | ContractCallEvent | ContractDeployPayload;
 /**
 * Handlers keyed by source name. Each handler's `event` is typed from the
 * matching source's filter `type` (e.g. a `print_event` source → `event.topic`
@@ -567,4 +588,4 @@ declare function deploySchema(db: AnyDb, def: SubgraphDefinition, handlerPath: s
 	version: string
 	diff?: DeployDiff
 }>;
-export { validateSubgraphDefinition, resumeReindex, reindexSubgraph, pgSchemaName, generateSubgraphSQL, 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, PrintEventPayload, PrintEventFilter, NftTransferPayload, NftTransferFilter, NftMintPayload, NftMintFilter, NftBurnPayload, NftBurnFilter, InferTableRow, InferSubgraphClient, InferColumnType, GeneratedSQL, FtTransferPayload, FtTransferFilter, FtMintPayload, FtMintFilter, FtBurnPayload, FtBurnFilter, FindManyOptions, EventForFilter, ContractDeployPayload, ContractDeployFilter, ContractCallFilter, ContractCallEvent, ComputedValue, ComparisonFilter, ColumnType, ColumnToTS, ColumnDiff, AnyEvent };
+export { validateSubgraphDefinition, resumeReindex, reindexSubgraph, pgSchemaName, generateSubgraphSQL, 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, PrintEventPayload, PrintEventFor, PrintEventFilter, NftTransferPayload, NftTransferFilter, NftMintPayload, NftMintFilter, NftBurnPayload, NftBurnFilter, InferTableRow, InferSubgraphClient, InferColumnType, GeneratedSQL, FtTransferPayload, FtTransferFilter, FtMintPayload, FtMintFilter, FtBurnPayload, FtBurnFilter, FindManyOptions, EventForFilter, ContractDeployPayload, ContractDeployFilter, ContractCallFilter, ContractCallEvent, ComputedValue, ComparisonFilter, ColumnType, ColumnToTS, ColumnDiff, AnyEvent };

package/dist/src/runtime/block-processor.d.ts

@@ -96,6 +96,14 @@ interface PrintEventFilter {
 	type: "print_event";
 	contractId?: string;
 	topic?: string;
+	/**
+	* Optional per-topic field schema. When declared, the handler's `event` is
+	* a discriminated union keyed by `topic` and `event.data` is typed per topic
+	* (e.g. `{ "completed-deposit": { amount: "uint", sender: "principal" } }`).
+	* Uses the same `ColumnType` vocab as `schema`; nested fields use `"jsonb"`.
+	* Type-level only — not validated at runtime.
+	*/
+	prints?: Record<string, Record<string, ColumnType>>;
 }
 /** All subgraph filter types — discriminated on `type` */
 type SubgraphFilter = StxTransferFilter | StxMintFilter | StxBurnFilter | StxLockFilter | FtTransferFilter | FtMintFilter | FtBurnFilter | NftTransferFilter | NftMintFilter | NftBurnFilter | ContractCallFilter | ContractDeployFilter | PrintEventFilter;

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

@@ -96,6 +96,14 @@ interface PrintEventFilter {
 	type: "print_event";
 	contractId?: string;
 	topic?: string;
+	/**
+	* Optional per-topic field schema. When declared, the handler's `event` is
+	* a discriminated union keyed by `topic` and `event.data` is typed per topic
+	* (e.g. `{ "completed-deposit": { amount: "uint", sender: "principal" } }`).
+	* Uses the same `ColumnType` vocab as `schema`; nested fields use `"jsonb"`.
+	* Type-level only — not validated at runtime.
+	*/
+	prints?: Record<string, Record<string, ColumnType>>;
 }
 /** All subgraph filter types — discriminated on `type` */
 type SubgraphFilter = StxTransferFilter | StxMintFilter | StxBurnFilter | StxLockFilter | FtTransferFilter | FtMintFilter | FtBurnFilter | NftTransferFilter | NftMintFilter | NftBurnFilter | ContractCallFilter | ContractDeployFilter | PrintEventFilter;

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

@@ -96,6 +96,14 @@ interface PrintEventFilter {
 	type: "print_event";
 	contractId?: string;
 	topic?: string;
+	/**
+	* Optional per-topic field schema. When declared, the handler's `event` is
+	* a discriminated union keyed by `topic` and `event.data` is typed per topic
+	* (e.g. `{ "completed-deposit": { amount: "uint", sender: "principal" } }`).
+	* Uses the same `ColumnType` vocab as `schema`; nested fields use `"jsonb"`.
+	* Type-level only — not validated at runtime.
+	*/
+	prints?: Record<string, Record<string, ColumnType>>;
 }
 /** All subgraph filter types — discriminated on `type` */
 type SubgraphFilter = StxTransferFilter | StxMintFilter | StxBurnFilter | StxLockFilter | FtTransferFilter | FtMintFilter | FtBurnFilter | NftTransferFilter | NftMintFilter | NftBurnFilter | ContractCallFilter | ContractDeployFilter | PrintEventFilter;

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

@@ -96,6 +96,14 @@ interface PrintEventFilter {
 	type: "print_event";
 	contractId?: string;
 	topic?: string;
+	/**
+	* Optional per-topic field schema. When declared, the handler's `event` is
+	* a discriminated union keyed by `topic` and `event.data` is typed per topic
+	* (e.g. `{ "completed-deposit": { amount: "uint", sender: "principal" } }`).
+	* Uses the same `ColumnType` vocab as `schema`; nested fields use `"jsonb"`.
+	* Type-level only — not validated at runtime.
+	*/
+	prints?: Record<string, Record<string, ColumnType>>;
 }
 /** All subgraph filter types — discriminated on `type` */
 type SubgraphFilter = StxTransferFilter | StxMintFilter | StxBurnFilter | StxLockFilter | FtTransferFilter | FtMintFilter | FtBurnFilter | NftTransferFilter | NftMintFilter | NftBurnFilter | ContractCallFilter | ContractDeployFilter | PrintEventFilter;

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

@@ -96,6 +96,14 @@ interface PrintEventFilter {
 	type: "print_event";
 	contractId?: string;
 	topic?: string;
+	/**
+	* Optional per-topic field schema. When declared, the handler's `event` is
+	* a discriminated union keyed by `topic` and `event.data` is typed per topic
+	* (e.g. `{ "completed-deposit": { amount: "uint", sender: "principal" } }`).
+	* Uses the same `ColumnType` vocab as `schema`; nested fields use `"jsonb"`.
+	* Type-level only — not validated at runtime.
+	*/
+	prints?: Record<string, Record<string, ColumnType>>;
 }
 /** All subgraph filter types — discriminated on `type` */
 type SubgraphFilter = StxTransferFilter | StxMintFilter | StxBurnFilter | StxLockFilter | FtTransferFilter | FtMintFilter | FtBurnFilter | NftTransferFilter | NftMintFilter | NftBurnFilter | ContractCallFilter | ContractDeployFilter | PrintEventFilter;

package/dist/src/runtime/source-matcher.d.ts

@@ -1,3 +1,5 @@
+/** Supported column types for subgraph schemas */
+type ColumnType = "text" | "uint" | "int" | "principal" | "boolean" | "timestamp" | "jsonb";
 /** STX event filters */
 interface StxTransferFilter {
 	type: "stx_transfer";
@@ -76,6 +78,14 @@ interface PrintEventFilter {
 	type: "print_event";
 	contractId?: string;
 	topic?: string;
+	/**
+	* Optional per-topic field schema. When declared, the handler's `event` is
+	* a discriminated union keyed by `topic` and `event.data` is typed per topic
+	* (e.g. `{ "completed-deposit": { amount: "uint", sender: "principal" } }`).
+	* Uses the same `ColumnType` vocab as `schema`; nested fields use `"jsonb"`.
+	* Type-level only — not validated at runtime.
+	*/
+	prints?: Record<string, Record<string, ColumnType>>;
 }
 /** All subgraph filter types — discriminated on `type` */
 type SubgraphFilter = StxTransferFilter | StxMintFilter | StxBurnFilter | StxLockFilter | FtTransferFilter | FtMintFilter | FtBurnFilter | NftTransferFilter | NftMintFilter | NftBurnFilter | ContractCallFilter | ContractDeployFilter | PrintEventFilter;

package/dist/src/schema/index.d.ts

@@ -96,6 +96,14 @@ interface PrintEventFilter {
 	type: "print_event";
 	contractId?: string;
 	topic?: string;
+	/**
+	* Optional per-topic field schema. When declared, the handler's `event` is
+	* a discriminated union keyed by `topic` and `event.data` is typed per topic
+	* (e.g. `{ "completed-deposit": { amount: "uint", sender: "principal" } }`).
+	* Uses the same `ColumnType` vocab as `schema`; nested fields use `"jsonb"`.
+	* Type-level only — not validated at runtime.
+	*/
+	prints?: Record<string, Record<string, ColumnType>>;
 }
 /** All subgraph filter types — discriminated on `type` */
 type SubgraphFilter = StxTransferFilter | StxMintFilter | StxBurnFilter | StxLockFilter | FtTransferFilter | FtMintFilter | FtBurnFilter | NftTransferFilter | NftMintFilter | NftBurnFilter | ContractCallFilter | ContractDeployFilter | PrintEventFilter;

package/dist/src/triggers/index.d.ts

@@ -1,3 +1,5 @@
+/** Supported column types for subgraph schemas */
+type ColumnType = "text" | "uint" | "int" | "principal" | "boolean" | "timestamp" | "jsonb";
 /** STX event filters */
 interface StxTransferFilter {
 	type: "stx_transfer";
@@ -76,6 +78,14 @@ interface PrintEventFilter {
 	type: "print_event";
 	contractId?: string;
 	topic?: string;
+	/**
+	* Optional per-topic field schema. When declared, the handler's `event` is
+	* a discriminated union keyed by `topic` and `event.data` is typed per topic
+	* (e.g. `{ "completed-deposit": { amount: "uint", sender: "principal" } }`).
+	* Uses the same `ColumnType` vocab as `schema`; nested fields use `"jsonb"`.
+	* Type-level only — not validated at runtime.
+	*/
+	prints?: Record<string, Record<string, ColumnType>>;
 }
 /** All subgraph filter types — discriminated on `type` */
 type SubgraphFilter = StxTransferFilter | StxMintFilter | StxBurnFilter | StxLockFilter | FtTransferFilter | FtMintFilter | FtBurnFilter | NftTransferFilter | NftMintFilter | NftBurnFilter | ContractCallFilter | ContractDeployFilter | PrintEventFilter;

package/dist/src/types.d.ts

@@ -137,6 +137,14 @@ interface PrintEventFilter {
 	type: "print_event";
 	contractId?: string;
 	topic?: string;
+	/**
+	* Optional per-topic field schema. When declared, the handler's `event` is
+	* a discriminated union keyed by `topic` and `event.data` is typed per topic
+	* (e.g. `{ "completed-deposit": { amount: "uint", sender: "principal" } }`).
+	* Uses the same `ColumnType` vocab as `schema`; nested fields use `"jsonb"`.
+	* Type-level only — not validated at runtime.
+	*/
+	prints?: Record<string, Record<string, ColumnType>>;
 }
 /** All subgraph filter types — discriminated on `type` */
 type SubgraphFilter = StxTransferFilter | StxMintFilter | StxBurnFilter | StxLockFilter | FtTransferFilter | FtMintFilter | FtBurnFilter | NftTransferFilter | NftMintFilter | NftBurnFilter | ContractCallFilter | ContractDeployFilter | PrintEventFilter;

package/dist/src/validate.d.ts

@@ -96,6 +96,14 @@ interface PrintEventFilter {
 	type: "print_event";
 	contractId?: string;
 	topic?: string;
+	/**
+	* Optional per-topic field schema. When declared, the handler's `event` is
+	* a discriminated union keyed by `topic` and `event.data` is typed per topic
+	* (e.g. `{ "completed-deposit": { amount: "uint", sender: "principal" } }`).
+	* Uses the same `ColumnType` vocab as `schema`; nested fields use `"jsonb"`.
+	* Type-level only — not validated at runtime.
+	*/
+	prints?: Record<string, Record<string, ColumnType>>;
 }
 /** All subgraph filter types — discriminated on `type` */
 type SubgraphFilter = StxTransferFilter | StxMintFilter | StxBurnFilter | StxLockFilter | FtTransferFilter | FtMintFilter | FtBurnFilter | NftTransferFilter | NftMintFilter | NftBurnFilter | ContractCallFilter | ContractDeployFilter | PrintEventFilter;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@secondlayer/subgraphs",
-	"version": "3.0.0",
+	"version": "3.1.0",
 	"type": "module",
 	"main": "./dist/src/index.js",
 	"types": "./dist/src/index.d.ts",