@secondlayer/subgraphs 1.0.0 → 1.2.0

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

@@ -0,0 +1,199 @@
+/** STX event filters */
+interface StxTransferFilter {
+	type: "stx_transfer";
+	sender?: string;
+	recipient?: string;
+	minAmount?: bigint;
+	maxAmount?: bigint;
+}
+interface StxMintFilter {
+	type: "stx_mint";
+	recipient?: string;
+	minAmount?: bigint;
+}
+interface StxBurnFilter {
+	type: "stx_burn";
+	sender?: string;
+	minAmount?: bigint;
+}
+interface StxLockFilter {
+	type: "stx_lock";
+	lockedAddress?: string;
+	minAmount?: bigint;
+}
+/** FT event filters */
+interface FtTransferFilter {
+	type: "ft_transfer";
+	assetIdentifier?: string;
+	sender?: string;
+	recipient?: string;
+	minAmount?: bigint;
+}
+interface FtMintFilter {
+	type: "ft_mint";
+	assetIdentifier?: string;
+	recipient?: string;
+	minAmount?: bigint;
+}
+interface FtBurnFilter {
+	type: "ft_burn";
+	assetIdentifier?: string;
+	sender?: string;
+	minAmount?: bigint;
+}
+/** NFT event filters */
+interface NftTransferFilter {
+	type: "nft_transfer";
+	assetIdentifier?: string;
+	sender?: string;
+	recipient?: string;
+}
+interface NftMintFilter {
+	type: "nft_mint";
+	assetIdentifier?: string;
+	recipient?: string;
+}
+interface NftBurnFilter {
+	type: "nft_burn";
+	assetIdentifier?: string;
+	sender?: string;
+}
+/** Contract event filters */
+interface ContractCallFilter {
+	type: "contract_call";
+	contractId?: string;
+	functionName?: string;
+	caller?: string;
+	/** ABI for typed event.args. If omitted, auto-fetched at deploy time. */
+	abi?: Record<string, unknown>;
+}
+interface ContractDeployFilter {
+	type: "contract_deploy";
+	deployer?: string;
+	contractName?: string;
+}
+interface PrintEventFilter {
+	type: "print_event";
+	contractId?: string;
+	topic?: string;
+}
+/** All subgraph filter types — discriminated on `type` */
+type SubgraphFilter = StxTransferFilter | StxMintFilter | StxBurnFilter | StxLockFilter | FtTransferFilter | FtMintFilter | FtBurnFilter | NftTransferFilter | NftMintFilter | NftBurnFilter | ContractCallFilter | ContractDeployFilter | PrintEventFilter;
+interface EventTrigger {
+	type: "event";
+	filter: SubgraphFilter;
+}
+/** Metadata shared by every event. */
+interface TxMeta2 {
+	txId: string;
+	sender: string;
+	blockHeight: number;
+	blockTime: number;
+}
+interface StxTransferEvent {
+	sender: string;
+	recipient: string;
+	amount: bigint;
+	memo: string | null;
+	tx: TxMeta2;
+}
+interface StxMintEvent {
+	recipient: string;
+	amount: bigint;
+	tx: TxMeta2;
+}
+interface StxBurnEvent {
+	sender: string;
+	amount: bigint;
+	tx: TxMeta2;
+}
+interface StxLockEvent {
+	lockedAddress: string;
+	amount: bigint;
+	unlockHeight: number;
+	tx: TxMeta2;
+}
+interface FtTransferEvent {
+	assetIdentifier: string;
+	sender: string;
+	recipient: string;
+	amount: bigint;
+	tx: TxMeta2;
+}
+interface FtMintEvent {
+	assetIdentifier: string;
+	recipient: string;
+	amount: bigint;
+	tx: TxMeta2;
+}
+interface FtBurnEvent {
+	assetIdentifier: string;
+	sender: string;
+	amount: bigint;
+	tx: TxMeta2;
+}
+interface NftTransferEvent {
+	assetIdentifier: string;
+	sender: string;
+	recipient: string;
+	tokenId: string;
+	tx: TxMeta2;
+}
+interface NftMintEvent {
+	assetIdentifier: string;
+	recipient: string;
+	tokenId: string;
+	tx: TxMeta2;
+}
+interface NftBurnEvent {
+	assetIdentifier: string;
+	sender: string;
+	tokenId: string;
+	tx: TxMeta2;
+}
+interface ContractCallEvent {
+	contractId: string;
+	functionName: string;
+	args: unknown[];
+	caller: string;
+	tx: TxMeta2;
+}
+interface ContractDeployEvent {
+	contractId: string;
+	deployer: string;
+	contractName: string;
+	tx: TxMeta2;
+}
+interface PrintEventEvent {
+	contractId: string;
+	topic: string | null;
+	value: unknown;
+	tx: TxMeta2;
+}
+/**
+* Phantom-typed EventTrigger. Runtime shape is identical to `EventTrigger`;
+* the `__event` field only exists at the type level, letting subscription
+* definitions infer the handler's `event` parameter from the filter.
+*/
+type TypedEventTrigger<TEvent> = EventTrigger & {
+	readonly __event?: TEvent
+};
+interface TriggerHelpers {
+	stxTransfer: (f?: Omit<StxTransferFilter, "type">) => TypedEventTrigger<StxTransferEvent>;
+	stxMint: (f?: Omit<StxMintFilter, "type">) => TypedEventTrigger<StxMintEvent>;
+	stxBurn: (f?: Omit<StxBurnFilter, "type">) => TypedEventTrigger<StxBurnEvent>;
+	stxLock: (f?: Omit<StxLockFilter, "type">) => TypedEventTrigger<StxLockEvent>;
+	ftTransfer: (f?: Omit<FtTransferFilter, "type">) => TypedEventTrigger<FtTransferEvent>;
+	ftMint: (f?: Omit<FtMintFilter, "type">) => TypedEventTrigger<FtMintEvent>;
+	ftBurn: (f?: Omit<FtBurnFilter, "type">) => TypedEventTrigger<FtBurnEvent>;
+	nftTransfer: (f?: Omit<NftTransferFilter, "type">) => TypedEventTrigger<NftTransferEvent>;
+	nftMint: (f?: Omit<NftMintFilter, "type">) => TypedEventTrigger<NftMintEvent>;
+	nftBurn: (f?: Omit<NftBurnFilter, "type">) => TypedEventTrigger<NftBurnEvent>;
+	contractCall: (f?: Omit<ContractCallFilter, "type">) => TypedEventTrigger<ContractCallEvent>;
+	contractDeploy: (f?: Omit<ContractDeployFilter, "type">) => TypedEventTrigger<ContractDeployEvent>;
+	printEvent: (f?: Omit<PrintEventFilter, "type">) => TypedEventTrigger<PrintEventEvent>;
+}
+declare const on: TriggerHelpers;
+/** Extract the event payload type from a trigger. */
+type EventOf<T> = T extends TypedEventTrigger<infer E> ? E : never;
+export { on, TypedEventTrigger, TxMeta2 as TxMeta, TriggerHelpers, StxTransferEvent, StxMintEvent, StxLockEvent, StxBurnEvent, PrintEventEvent, NftTransferEvent, NftMintEvent, NftBurnEvent, FtTransferEvent, FtMintEvent, FtBurnEvent, EventOf, ContractDeployEvent, ContractCallEvent };

package/dist/src/triggers/index.js

@@ -0,0 +1,28 @@
+import { createRequire } from "node:module";
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+// src/triggers/index.ts
+function make(filter) {
+  return { type: "event", filter };
+}
+var on = {
+  stxTransfer: (f = {}) => make({ type: "stx_transfer", ...f }),
+  stxMint: (f = {}) => make({ type: "stx_mint", ...f }),
+  stxBurn: (f = {}) => make({ type: "stx_burn", ...f }),
+  stxLock: (f = {}) => make({ type: "stx_lock", ...f }),
+  ftTransfer: (f = {}) => make({ type: "ft_transfer", ...f }),
+  ftMint: (f = {}) => make({ type: "ft_mint", ...f }),
+  ftBurn: (f = {}) => make({ type: "ft_burn", ...f }),
+  nftTransfer: (f = {}) => make({ type: "nft_transfer", ...f }),
+  nftMint: (f = {}) => make({ type: "nft_mint", ...f }),
+  nftBurn: (f = {}) => make({ type: "nft_burn", ...f }),
+  contractCall: (f = {}) => make({ type: "contract_call", ...f }),
+  contractDeploy: (f = {}) => make({ type: "contract_deploy", ...f }),
+  printEvent: (f = {}) => make({ type: "print_event", ...f })
+};
+export {
+  on
+};
+
+//# debugId=C92F67573451324664756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/src/triggers/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/triggers/index.ts"],
+  "sourcesContent": [
+    "/**\n * Typed event-trigger helpers. Each helper returns a standard `EventTrigger`\n * plus a phantom `__event` type used for inference at consumer sites. The\n * phantom carries no runtime value.\n */\n\nimport type {\n\tContractCallFilter,\n\tContractDeployFilter,\n\tFtBurnFilter,\n\tFtMintFilter,\n\tFtTransferFilter,\n\tNftBurnFilter,\n\tNftMintFilter,\n\tNftTransferFilter,\n\tPrintEventFilter,\n\tStxBurnFilter,\n\tStxLockFilter,\n\tStxMintFilter,\n\tStxTransferFilter,\n} from \"../types.ts\";\nimport type { EventTrigger } from \"./types.ts\";\n\n// --- Per-filter event payload shapes ---\n\n/** Metadata shared by every event. */\nexport interface TxMeta {\n\ttxId: string;\n\tsender: string;\n\tblockHeight: number;\n\tblockTime: number;\n}\n\nexport interface StxTransferEvent {\n\tsender: string;\n\trecipient: string;\n\tamount: bigint;\n\tmemo: string | null;\n\ttx: TxMeta;\n}\n\nexport interface StxMintEvent {\n\trecipient: string;\n\tamount: bigint;\n\ttx: TxMeta;\n}\n\nexport interface StxBurnEvent {\n\tsender: string;\n\tamount: bigint;\n\ttx: TxMeta;\n}\n\nexport interface StxLockEvent {\n\tlockedAddress: string;\n\tamount: bigint;\n\tunlockHeight: number;\n\ttx: TxMeta;\n}\n\nexport interface FtTransferEvent {\n\tassetIdentifier: string;\n\tsender: string;\n\trecipient: string;\n\tamount: bigint;\n\ttx: TxMeta;\n}\n\nexport interface FtMintEvent {\n\tassetIdentifier: string;\n\trecipient: string;\n\tamount: bigint;\n\ttx: TxMeta;\n}\n\nexport interface FtBurnEvent {\n\tassetIdentifier: string;\n\tsender: string;\n\tamount: bigint;\n\ttx: TxMeta;\n}\n\nexport interface NftTransferEvent {\n\tassetIdentifier: string;\n\tsender: string;\n\trecipient: string;\n\ttokenId: string;\n\ttx: TxMeta;\n}\n\nexport interface NftMintEvent {\n\tassetIdentifier: string;\n\trecipient: string;\n\ttokenId: string;\n\ttx: TxMeta;\n}\n\nexport interface NftBurnEvent {\n\tassetIdentifier: string;\n\tsender: string;\n\ttokenId: string;\n\ttx: TxMeta;\n}\n\nexport interface ContractCallEvent {\n\tcontractId: string;\n\tfunctionName: string;\n\targs: unknown[];\n\tcaller: string;\n\ttx: TxMeta;\n}\n\nexport interface ContractDeployEvent {\n\tcontractId: string;\n\tdeployer: string;\n\tcontractName: string;\n\ttx: TxMeta;\n}\n\nexport interface PrintEventEvent {\n\tcontractId: string;\n\ttopic: string | null;\n\tvalue: unknown;\n\ttx: TxMeta;\n}\n\n// --- Typed trigger wrapper ---\n\n/**\n * Phantom-typed EventTrigger. Runtime shape is identical to `EventTrigger`;\n * the `__event` field only exists at the type level, letting subscription\n * definitions infer the handler's `event` parameter from the filter.\n */\nexport type TypedEventTrigger<TEvent> = EventTrigger & {\n\treadonly __event?: TEvent;\n};\n\nfunction make<TEvent>(\n\tfilter: EventTrigger[\"filter\"],\n): TypedEventTrigger<TEvent> {\n\treturn { type: \"event\", filter };\n}\n\n// --- `on.*` helpers, 13 total ---\n\nexport interface TriggerHelpers {\n\tstxTransfer: (\n\t\tf?: Omit<StxTransferFilter, \"type\">,\n\t) => TypedEventTrigger<StxTransferEvent>;\n\tstxMint: (f?: Omit<StxMintFilter, \"type\">) => TypedEventTrigger<StxMintEvent>;\n\tstxBurn: (f?: Omit<StxBurnFilter, \"type\">) => TypedEventTrigger<StxBurnEvent>;\n\tstxLock: (f?: Omit<StxLockFilter, \"type\">) => TypedEventTrigger<StxLockEvent>;\n\tftTransfer: (\n\t\tf?: Omit<FtTransferFilter, \"type\">,\n\t) => TypedEventTrigger<FtTransferEvent>;\n\tftMint: (f?: Omit<FtMintFilter, \"type\">) => TypedEventTrigger<FtMintEvent>;\n\tftBurn: (f?: Omit<FtBurnFilter, \"type\">) => TypedEventTrigger<FtBurnEvent>;\n\tnftTransfer: (\n\t\tf?: Omit<NftTransferFilter, \"type\">,\n\t) => TypedEventTrigger<NftTransferEvent>;\n\tnftMint: (f?: Omit<NftMintFilter, \"type\">) => TypedEventTrigger<NftMintEvent>;\n\tnftBurn: (f?: Omit<NftBurnFilter, \"type\">) => TypedEventTrigger<NftBurnEvent>;\n\tcontractCall: (\n\t\tf?: Omit<ContractCallFilter, \"type\">,\n\t) => TypedEventTrigger<ContractCallEvent>;\n\tcontractDeploy: (\n\t\tf?: Omit<ContractDeployFilter, \"type\">,\n\t) => TypedEventTrigger<ContractDeployEvent>;\n\tprintEvent: (\n\t\tf?: Omit<PrintEventFilter, \"type\">,\n\t) => TypedEventTrigger<PrintEventEvent>;\n}\n\nexport const on: TriggerHelpers = {\n\tstxTransfer: (f = {}) =>\n\t\tmake<StxTransferEvent>({ type: \"stx_transfer\", ...f }),\n\n\tstxMint: (f = {}) => make<StxMintEvent>({ type: \"stx_mint\", ...f }),\n\n\tstxBurn: (f = {}) => make<StxBurnEvent>({ type: \"stx_burn\", ...f }),\n\n\tstxLock: (f = {}) => make<StxLockEvent>({ type: \"stx_lock\", ...f }),\n\n\tftTransfer: (f = {}) => make<FtTransferEvent>({ type: \"ft_transfer\", ...f }),\n\n\tftMint: (f = {}) => make<FtMintEvent>({ type: \"ft_mint\", ...f }),\n\n\tftBurn: (f = {}) => make<FtBurnEvent>({ type: \"ft_burn\", ...f }),\n\n\tnftTransfer: (f = {}) =>\n\t\tmake<NftTransferEvent>({ type: \"nft_transfer\", ...f }),\n\n\tnftMint: (f = {}) => make<NftMintEvent>({ type: \"nft_mint\", ...f }),\n\n\tnftBurn: (f = {}) => make<NftBurnEvent>({ type: \"nft_burn\", ...f }),\n\n\tcontractCall: (f = {}) =>\n\t\tmake<ContractCallEvent>({ type: \"contract_call\", ...f }),\n\n\tcontractDeploy: (f = {}) =>\n\t\tmake<ContractDeployEvent>({ type: \"contract_deploy\", ...f }),\n\n\tprintEvent: (f = {}) => make<PrintEventEvent>({ type: \"print_event\", ...f }),\n};\n\n/** Extract the event payload type from a trigger. */\nexport type EventOf<T> = T extends TypedEventTrigger<infer E> ? E : never;\n"
+  ],
+  "mappings": ";;;;AAyIA,SAAS,IAAY,CACpB,QAC4B;AAAA,EAC5B,OAAO,EAAE,MAAM,SAAS,OAAO;AAAA;AAiCzB,IAAM,KAAqB;AAAA,EACjC,aAAa,CAAC,IAAI,CAAC,MAClB,KAAuB,EAAE,MAAM,mBAAmB,EAAE,CAAC;AAAA,EAEtD,SAAS,CAAC,IAAI,CAAC,MAAM,KAAmB,EAAE,MAAM,eAAe,EAAE,CAAC;AAAA,EAElE,SAAS,CAAC,IAAI,CAAC,MAAM,KAAmB,EAAE,MAAM,eAAe,EAAE,CAAC;AAAA,EAElE,SAAS,CAAC,IAAI,CAAC,MAAM,KAAmB,EAAE,MAAM,eAAe,EAAE,CAAC;AAAA,EAElE,YAAY,CAAC,IAAI,CAAC,MAAM,KAAsB,EAAE,MAAM,kBAAkB,EAAE,CAAC;AAAA,EAE3E,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAkB,EAAE,MAAM,cAAc,EAAE,CAAC;AAAA,EAE/D,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAkB,EAAE,MAAM,cAAc,EAAE,CAAC;AAAA,EAE/D,aAAa,CAAC,IAAI,CAAC,MAClB,KAAuB,EAAE,MAAM,mBAAmB,EAAE,CAAC;AAAA,EAEtD,SAAS,CAAC,IAAI,CAAC,MAAM,KAAmB,EAAE,MAAM,eAAe,EAAE,CAAC;AAAA,EAElE,SAAS,CAAC,IAAI,CAAC,MAAM,KAAmB,EAAE,MAAM,eAAe,EAAE,CAAC;AAAA,EAElE,cAAc,CAAC,IAAI,CAAC,MACnB,KAAwB,EAAE,MAAM,oBAAoB,EAAE,CAAC;AAAA,EAExD,gBAAgB,CAAC,IAAI,CAAC,MACrB,KAA0B,EAAE,MAAM,sBAAsB,EAAE,CAAC;AAAA,EAE5D,YAAY,CAAC,IAAI,CAAC,MAAM,KAAsB,EAAE,MAAM,kBAAkB,EAAE,CAAC;AAC5E;",
+  "debugId": "C92F67573451324664756E2164756E21",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@secondlayer/subgraphs",
-	"version": "1.0.0",
+	"version": "1.2.0",
 	"type": "module",
 	"main": "./dist/src/index.js",
 	"types": "./dist/src/index.d.ts",
@@ -21,6 +21,10 @@
 			"types": "./dist/src/validate.d.ts",
 			"import": "./dist/src/validate.js"
 		},
+		"./triggers": {
+			"types": "./dist/src/triggers/index.d.ts",
+			"import": "./dist/src/triggers/index.js"
+		},
 		"./runtime/source-matcher": {
 			"types": "./dist/src/runtime/source-matcher.d.ts",
 			"import": "./dist/src/runtime/source-matcher.js"
@@ -41,10 +45,9 @@
 		"prepublishOnly": "bun run build"
 	},
 	"dependencies": {
-		"@secondlayer/shared": "^3.0.0",
-		"@secondlayer/stacks": "^1.0.0",
+		"@secondlayer/shared": "^4.1.1",
+		"@secondlayer/stacks": "^2.0.0",
 		"kysely": "0.28.15",
-		"postgres": "^3.4.6",
 		"zod": "^4.3.6"
 	},
 	"devDependencies": {