@secondlayer/subgraphs 7.0.4 → 7.1.0

package/dist/index.d.ts

@@ -338,11 +338,23 @@ interface VarSetFilter extends TraitScope, FactoryScope {
 	type: "var_set";
 	contractId?: string | readonly string[];
 	varName?: string;
+	/**
+	* Contract ABI. With a `varName` the abi defines, `event.value` is typed
+	* and decoded from the variable's type. Pass it yourself
+	* (`normalizeAbi()` from `@secondlayer/stacks/clarity`).
+	*/
+	abi?: AbiContract2;
 }
 interface MapWriteFilter extends TraitScope, FactoryScope {
 	type: "map_set" | "map_insert" | "map_delete";
 	contractId?: string | readonly string[];
 	map?: string;
+	/**
+	* Contract ABI. With a `map` the abi defines, `event.key` and
+	* `event.value` are typed and decoded from the map's types. Pass it
+	* yourself (`normalizeAbi()` from `@secondlayer/stacks/clarity`).
+	*/
+	abi?: AbiContract2;
 }
 /**
 * One declared field of a print payload.
@@ -479,7 +491,7 @@ interface SubgraphDefinition {
 	/** Handler functions, one per source, keyed by source name */
 	handlers: Record<string, SubgraphHandler>;
 }
-import { AbiContract as AbiContract3, ExtractFunctionArgs as ExtractFunctionArgs2, ExtractFunctionNames } from "@secondlayer/stacks/clarity";
+import { AbiContract as AbiContract3, ExtractFunctionArgs as ExtractFunctionArgs2, ExtractFunctionNames, ExtractMapKey, ExtractMapNames, ExtractMapValue, ExtractVariableNames, ExtractVariableType } from "@secondlayer/stacks/clarity";
 /** 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 */
@@ -837,14 +849,14 @@ interface NestedContractCallPayload {
 	result: unknown;
 	tx: TxMeta;
 }
-interface VarSetPayload {
+interface VarSetEvent {
 	contractId: string;
 	varName: string;
 	rawValue: string;
 	value: unknown;
 	tx: TxMeta;
 }
-interface MapWritePayload {
+interface MapWriteEvent {
 	contractId: string;
 	map: string;
 	rawKey: string;
@@ -853,7 +865,7 @@ interface MapWritePayload {
 	value: unknown;
 	tx: TxMeta;
 }
-interface MapDeletePayload {
+interface MapDeleteEvent {
 	contractId: string;
 	map: string;
 	rawKey: string;
@@ -861,6 +873,31 @@ interface MapDeletePayload {
 	tx: TxMeta;
 }
 /**
+* State-write payloads. When the source carries a `const` `abi` and a known
+* `varName` / `map`, `value` (and `key`) are typed from the contract's
+* definition and decoded with it (camelCased tuple keys, `AbiToTS` shapes).
+* Without an `abi`, or with a name the abi lacks, they stay `unknown`.
+*/
+type VarSetPayload<F = unknown> = F extends {
+	abi: infer A extends AbiContract3;
+	varName: infer N extends string;
+} ? N extends ExtractVariableNames<A> ? Omit<VarSetEvent, "value"> & {
+	value: ExtractVariableType<A, N>;
+} : VarSetEvent : VarSetEvent;
+type MapWritePayload<F = unknown> = F extends {
+	abi: infer A extends AbiContract3;
+	map: infer N extends string;
+} ? N extends ExtractMapNames<A> ? Omit<MapWriteEvent, "key" | "value"> & {
+	key: ExtractMapKey<A, N>;
+	value: ExtractMapValue<A, N>;
+} : MapWriteEvent : MapWriteEvent;
+type MapDeletePayload<F = unknown> = F extends {
+	abi: infer A extends AbiContract3;
+	map: infer N extends string;
+} ? N extends ExtractMapNames<A> ? Omit<MapDeleteEvent, "key"> & {
+	key: ExtractMapKey<A, N>;
+} : MapDeleteEvent : MapDeleteEvent;
+/**
 * 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}.
@@ -925,11 +962,11 @@ type EventForFilter<F extends SubgraphFilter> = F extends {
 	type: "nested_contract_call";
 } ? NestedContractCallPayload : F extends {
 	type: "var_set";
-} ? VarSetPayload : F extends {
+} ? VarSetPayload<F> : F extends {
 	type: infer T extends "map_set" | "map_insert" | "map_delete";
-} ? T extends "map_delete" ? MapDeletePayload : MapWritePayload : never;
+} ? T extends "map_delete" ? MapDeletePayload<F> : MapWritePayload<F> : never;
 /** Union of every event payload. */
-type AnyEvent = FtTransferPayload | FtMintPayload | FtBurnPayload | NftTransferPayload | NftMintPayload | NftBurnPayload | StxTransferPayload | StxMintPayload | StxBurnPayload | StxLockPayload | PrintEventPayload | ContractCallEvent | ContractDeployPayload | NestedContractCallPayload | VarSetPayload | MapWritePayload | MapDeletePayload;
+type AnyEvent = FtTransferPayload | FtMintPayload | FtBurnPayload | NftTransferPayload | NftMintPayload | NftBurnPayload | StxTransferPayload | StxMintPayload | StxBurnPayload | StxLockPayload | PrintEventPayload | ContractCallEvent | ContractDeployPayload | NestedContractCallPayload | VarSetEvent | MapWriteEvent | MapDeleteEvent;
 type HandlerFn<
 	F extends SubgraphFilter,
 	S extends SubgraphSchema

package/dist/index.js

@@ -199,6 +199,7 @@ var SubgraphFilterUnion = z.discriminatedUnion("type", [
     type: z.literal("var_set"),
     contractId: contractIdField.optional(),
     varName: z.string().optional(),
+    abi: AbiContractSchema.optional(),
     ...traitScope,
     ...factoryScope
   }).strict(),
@@ -206,6 +207,7 @@ var SubgraphFilterUnion = z.discriminatedUnion("type", [
     type: z.literal("map_set"),
     contractId: contractIdField.optional(),
     map: z.string().optional(),
+    abi: AbiContractSchema.optional(),
     ...traitScope,
     ...factoryScope
   }).strict(),
@@ -213,6 +215,7 @@ var SubgraphFilterUnion = z.discriminatedUnion("type", [
     type: z.literal("map_insert"),
     contractId: contractIdField.optional(),
     map: z.string().optional(),
+    abi: AbiContractSchema.optional(),
     ...traitScope,
     ...factoryScope
   }).strict(),
@@ -220,6 +223,7 @@ var SubgraphFilterUnion = z.discriminatedUnion("type", [
     type: z.literal("map_delete"),
     contractId: contractIdField.optional(),
     map: z.string().optional(),
+    abi: AbiContractSchema.optional(),
     ...traitScope,
     ...factoryScope
   }).strict()
@@ -787,7 +791,7 @@ import { createHash } from "node:crypto";
 // package.json
 var package_default = {
   name: "@secondlayer/subgraphs",
-  version: "7.0.4",
+  version: "7.1.0",
   description: "Describe the Stacks data you want as one TypeScript file; it fills itself and survives reorgs.",
   license: "MIT",
   repository: {
@@ -848,8 +852,8 @@ var package_default = {
   },
   dependencies: {
     "@secondlayer/shared": "^13.0.0",
-    "@secondlayer/stacks": "^6.2.2",
-    "@secondlayer/verify": "^0.5.4",
+    "@secondlayer/stacks": "^6.3.0",
+    "@secondlayer/verify": "^0.6.0",
     esbuild: "^0.28.2",
     kysely: "0.28.17",
     zod: "^4.3.6"
@@ -2949,5 +2953,5 @@ export {
   validateSubgraphDefinition
 };
 
-//# debugId=DCD9274CFF218C3164756E2164756E21
+//# debugId=DC950AFB0608338264756E2164756E21
 //# sourceMappingURL=index.js.map