@secondlayer/subgraphs 3.0.0 → 3.2.0

package/dist/src/types.d.ts

@@ -1,3 +1,4 @@
+import { AbiContract } from "@secondlayer/stacks/clarity";
 /** Supported column types for subgraph schemas */
 type ColumnType = "text" | "uint" | "int" | "principal" | "boolean" | "timestamp" | "jsonb";
 /** Column definition in a subgraph table */
@@ -125,8 +126,13 @@ interface ContractCallFilter {
 	contractId?: string;
 	functionName?: string;
 	caller?: string;
-	/** ABI for typed event.args. If omitted, auto-fetched at deploy time. */
-	abi?: Record<string, unknown>;
+	/**
+	* Contract ABI (pass it `as const`) used to type `event.input` — the named,
+	* decoded function arguments. Dev-provided; serialized into the deployed
+	* definition and used at runtime to decode args by name. Omit to keep
+	* `event.args` as a positional `unknown[]`.
+	*/
+	abi?: AbiContract;
 }
 interface ContractDeployFilter {
 	type: "contract_deploy";
@@ -137,6 +143,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

@@ -1,3 +1,4 @@
+import { AbiContract } from "@secondlayer/stacks/clarity";
 /** Supported column types for subgraph schemas */
 type ColumnType = "text" | "uint" | "int" | "principal" | "boolean" | "timestamp" | "jsonb";
 /** Column definition in a subgraph table */
@@ -84,8 +85,13 @@ interface ContractCallFilter {
 	contractId?: string;
 	functionName?: string;
 	caller?: string;
-	/** ABI for typed event.args. If omitted, auto-fetched at deploy time. */
-	abi?: Record<string, unknown>;
+	/**
+	* Contract ABI (pass it `as const`) used to type `event.input` — the named,
+	* decoded function arguments. Dev-provided; serialized into the deployed
+	* definition and used at runtime to decode args by name. Omit to keep
+	* `event.args` as a positional `unknown[]`.
+	*/
+	abi?: AbiContract;
 }
 interface ContractDeployFilter {
 	type: "contract_deploy";
@@ -96,6 +102,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.2.0",
 	"type": "module",
 	"main": "./dist/src/index.js",
 	"types": "./dist/src/index.d.ts",