@secondlayer/subgraphs 2.0.2 → 2.0.4

package/dist/src/index.d.ts

@@ -78,6 +78,47 @@ interface NftBurnFilter {
 	assetIdentifier?: string;
 	sender?: string;
 }
+/**
+* Event shape passed to contract_call handlers.
+*
+* `args` is a **positional array** of decoded Clarity values matching the
+* contract function's parameter list in declaration order. Use the ABI
+* (or Clarity contract source) to map positions to names:
+*
+* ```ts
+* // pox-4 stack-stx args: (amount-ustx uint) (pox-addr tuple) (start-burn-ht uint) (lock-period uint)
+* const [amountUstx, , , lockPeriod] = event.args;
+* ```
+*
+* Bigints come out as `bigint`. Buffers as `Uint8Array`. Principals as
+* strings (`"SP..."`). Tuples as `Record<string, unknown>`.
+*
+* Historical transactions indexed before the function_args column was added
+* will have `args = []` — always guard with `args.length > 0` when reading
+* args from pre-Nakamoto history.
+*/
+interface ContractCallEvent {
+	type: "contract_call";
+	/** Transaction sender (the principal who signed the tx). Always non-null. */
+	sender: string;
+	contractId: string;
+	functionName: string;
+	/** Positional decoded Clarity values — order matches the ABI parameter list. */
+	args: unknown[];
+	/** Decoded return value from the contract function, or null. */
+	result: unknown;
+	/** Raw hex-encoded result value. */
+	resultHex: string | null;
+	/** Transaction metadata. */
+	tx: {
+		txId: string
+		sender: string
+		type: string
+		status: string
+		contractId: string | null
+		functionName: string | null
+	};
+}
 /** Contract event filters */
 interface ContractCallFilter {
 	type: "contract_call";
@@ -279,7 +320,7 @@ declare function deploySchema(db: AnyDb, def: SubgraphDefinition, handlerPath: s
 	handlerCode?: string
 	sourceCode?: string
 }): Promise<{
-	action: "created" | "unchanged" | "updated" | "reindexed"
+	action: "created" | "unchanged" | "handler_updated" | "updated" | "reindexed"
 	subgraphId: string
 	version: string
 	diff?: DeployDiff
@@ -339,4 +380,4 @@ interface SubgraphTableClient<TRow> {
 type InferSubgraphClient<T> = T extends {
 	schema: infer S
 } ? { [K in keyof S] : S[K] extends SubgraphTable ? SubgraphTableClient<InferTableRow<S[K]>> : never } : never;
-export { validateSubgraphDefinition, resumeReindex, reindexSubgraph, pgSchemaName, generateSubgraphSQL, diffSchema, deploySchema, defineSubgraph, backfillSubgraph, WhereInput, TxMeta, TableDiff, SystemRow, SubgraphTableClient, SubgraphTable, SubgraphSchema, SubgraphHandler, SubgraphFilter, SubgraphDefinition, SubgraphContext, SubgraphColumn, StxTransferFilter, StxMintFilter, StxLockFilter, StxBurnFilter, RowValue, ReindexOptions, PrintEventFilter, NftTransferFilter, NftMintFilter, NftBurnFilter, InferTableRow, InferSubgraphClient, InferColumnType, GeneratedSQL, FtTransferFilter, FtMintFilter, FtBurnFilter, FindManyOptions, ContractDeployFilter, ContractCallFilter, ComputedValue, ComparisonFilter, ColumnType, ColumnToTS, ColumnDiff };
+export { validateSubgraphDefinition, resumeReindex, reindexSubgraph, pgSchemaName, generateSubgraphSQL, diffSchema, deploySchema, defineSubgraph, backfillSubgraph, WhereInput, TxMeta, TableDiff, SystemRow, SubgraphTableClient, SubgraphTable, SubgraphSchema, SubgraphHandler, SubgraphFilter, SubgraphDefinition, SubgraphContext, SubgraphColumn, StxTransferFilter, StxMintFilter, StxLockFilter, StxBurnFilter, RowValue, ReindexOptions, PrintEventFilter, NftTransferFilter, NftMintFilter, NftBurnFilter, InferTableRow, InferSubgraphClient, InferColumnType, GeneratedSQL, FtTransferFilter, FtMintFilter, FtBurnFilter, FindManyOptions, ContractDeployFilter, ContractCallFilter, ContractCallEvent, ComputedValue, ComparisonFilter, ColumnType, ColumnToTS, ColumnDiff };

package/dist/src/index.js

@@ -490,9 +490,10 @@ function buildEventPayload(filter, tx, event) {
     switch (filter.type) {
       case "contract_call":
         return {
+          type: "contract_call",
           contractId: tx.contract_id ?? "",
           functionName: tx.function_name ?? "",
-          caller: tx.sender,
+          sender: tx.sender,
           args: decodedArgs,
           result: decodedResult,
           resultHex: tx.raw_result ?? null,
@@ -598,10 +599,11 @@ function buildEventPayload(filter, tx, event) {
     case "contract_call":
       return {
         ...decoded,
+        type: "contract_call",
         _eventType: event.type,
         contractId: tx.contract_id ?? "",
         functionName: tx.function_name ?? "",
-        caller: tx.sender,
+        sender: tx.sender,
         args: decodedArgs,
         result: decodedResult,
         resultHex: tx.raw_result ?? null,
@@ -2002,10 +2004,14 @@ async function deploySchema(db, def, handlerPath, opts) {
   };
   if (existing) {
     if (existing.schema_hash === hash && !opts?.forceReindex) {
+      const handlerChanged = opts?.handlerCode != null && opts.handlerCode !== existing.handler_code;
       const { updateSubgraphHandlerPath } = await import("@secondlayer/shared/db/queries/subgraphs");
-      await updateSubgraphHandlerPath(db, def.name, handlerPath);
+      await updateSubgraphHandlerPath(db, def.name, handlerPath, {
+        handlerCode: opts?.handlerCode,
+        sourceCode: opts?.sourceCode
+      });
       return {
-        action: "unchanged",
+        action: handlerChanged ? "handler_updated" : "unchanged",
         subgraphId: existing.id,
         version: existing.version
       };
@@ -2153,5 +2159,5 @@ export {
   backfillSubgraph
 };
 
-//# debugId=E0522C5B1714929864756E2164756E21
+//# debugId=3710F19F792D1C7E64756E2164756E21
 //# sourceMappingURL=index.js.map