@secondlayer/subgraphs 7.0.4 → 7.2.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.
@@ -378,6 +390,12 @@ type PrintEventPrints = Record<string, Record<string, PrintField>>;
 type PrintEventFields = FactoryScope & {
 	type: "print_event";
 	topic?: string;
+	/** Equality on top-level keys of the decoded print tuple, spelled as the
+	*  contract prints them (`signer-manager`). A value matches the field's
+	*  JSON form: principals `SP…`, uints as decimal strings, bools
+	*  `"true"`/`"false"`, buffers `0x…`. An array is any-of; keys AND.
+	*  Nested tuples and lists never match. */
+	where?: Record<string, string | readonly string[]>;
 };
 /**
 * Pinned to one or more contract ids with no trait — `prints` is required so
@@ -479,7 +497,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 +855,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 +871,7 @@ interface MapWritePayload {
 	value: unknown;
 	tx: TxMeta;
 }
-interface MapDeletePayload {
+interface MapDeleteEvent {
 	contractId: string;
 	map: string;
 	rawKey: string;
@@ -861,6 +879,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 +968,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

@@ -6,6 +6,7 @@ function defineSchema(schema) {
   return schema;
 }
 // src/validate.ts
+import { PrintWhereSchema } from "@secondlayer/shared/schemas/webhooks";
 import { z } from "zod";
 var SubgraphNameSchema = z.string().min(1).max(63).regex(/^[a-z][a-z0-9-]*$/, "Must start with lowercase letter, contain only lowercase alphanumeric and hyphens");
 var SqlIdentifierSchema = z.string().min(1).max(63).regex(/^[a-z_][a-z0-9_]*$/i, "Must be a valid SQL identifier: start with a letter or underscore, then letters/digits/underscores only");
@@ -182,6 +183,7 @@ var SubgraphFilterUnion = z.discriminatedUnion("type", [
     type: z.literal("print_event"),
     contractId: contractIdField.optional(),
     topic: z.string().optional(),
+    where: PrintWhereSchema.optional(),
     prints: z.record(z.string(), z.record(z.string(), PrintFieldSchema)).optional(),
     ...traitScope,
     ...factoryScope
@@ -199,6 +201,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 +209,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 +217,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 +225,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 +793,7 @@ import { createHash } from "node:crypto";
 // package.json
 var package_default = {
   name: "@secondlayer/subgraphs",
-  version: "7.0.4",
+  version: "7.2.0",
   description: "Describe the Stacks data you want as one TypeScript file; it fills itself and survives reorgs.",
   license: "MIT",
   repository: {
@@ -847,9 +853,9 @@ var package_default = {
     prepublishOnly: "bun run build"
   },
   dependencies: {
-    "@secondlayer/shared": "^13.0.0",
-    "@secondlayer/stacks": "^6.2.2",
-    "@secondlayer/verify": "^0.5.4",
+    "@secondlayer/shared": "^13.1.0",
+    "@secondlayer/stacks": "^6.4.0",
+    "@secondlayer/verify": "^0.6.0",
     esbuild: "^0.28.2",
     kysely: "0.28.17",
     zod: "^4.3.6"
@@ -2949,5 +2955,5 @@ export {
   validateSubgraphDefinition
 };
 
-//# debugId=DCD9274CFF218C3164756E2164756E21
+//# debugId=A0749A4C359E248364756E2164756E21
 //# sourceMappingURL=index.js.map