@avaprotocol/sdk-js 2.6.12 → 2.7.0

package/dist/models/step.d.ts

@@ -0,0 +1,29 @@
+import * as avs_pb from "@/grpc_codegen/avs_pb";
+import { StepProps, OutputDataProps } from "@avaprotocol/types";
+declare class Step implements StepProps {
+    id: string;
+    type: string;
+    name: string;
+    success: boolean;
+    error: string;
+    log: string;
+    inputsList: string[];
+    config?: any;
+    output: OutputDataProps;
+    startAt: number;
+    endAt: number;
+    metadata?: any;
+    executionContext?: any;
+    constructor(props: StepProps);
+    /**
+     * Convert Step instance to plain object (StepProps)
+     * This is useful for serialization, especially with Next.js Server Components
+     */
+    toJson(): StepProps;
+    static getOutput(step: avs_pb.Execution.Step): OutputDataProps;
+    private static extractOutputData;
+    private static getOutputDataCase;
+    static fromResponse(step: avs_pb.Execution.Step): Step;
+}
+export default Step;
+//# sourceMappingURL=step.d.ts.map

package/dist/models/step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/models/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAMhD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEhE,cAAM,IAAK,YAAW,SAAS;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;gBAEF,KAAK,EAAE,SAAS;IAc5B;;;OAGG;IACH,MAAM,IAAI,SAAS;IAgBnB,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,GAAG,eAAe;IAwD9D,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAiEhC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAgChC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI;CAqEvD;AAED,eAAe,IAAI,CAAC"}
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/models/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAMhD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEhE,cAAM,IAAK,YAAW,SAAS;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,gBAAgB,CAAC,EAAE,GAAG,CAAC;gBAEX,KAAK,EAAE,SAAS;IAgB5B;;;OAGG;IACH,MAAM,IAAI,SAAS;IAkBnB,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,GAAG,eAAe;IAoC9D,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAiEhC,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAkChC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI;CAuGvD;AAED,eAAe,IAAI,CAAC"}

package/dist/models/step.js

@@ -13,6 +13,8 @@ class Step {
         this.output = props.output;
         this.startAt = props.startAt;
         this.endAt = props.endAt;
+        this.metadata = props.metadata;
+        this.executionContext = props.executionContext;
     }
     /**
      * Convert Step instance to plain object (StepProps)
@@ -31,60 +33,41 @@ class Step {
             output: this.output,
             startAt: this.startAt,
             endAt: this.endAt,
+            metadata: this.metadata,
+            executionContext: this.executionContext,
         };
     }
     static getOutput(step) {
-        const outputData = this.extractOutputData(step);
-        if (!outputData)
+        // Always return Output.data; step-level metadata is separate.
+        const outputObj = this.extractOutputData(step);
+        if (!outputObj)
             return null;
-        const outputCase = this.getOutputDataCase(step);
-        // 🚀 Special handling for ContractWrite and ContractRead - return both data and metadata
-        if (outputCase === avs_pb.Execution.Step.OutputDataCase.CONTRACT_WRITE ||
-            outputCase === avs_pb.Execution.Step.OutputDataCase.CONTRACT_READ) {
-            try {
-                const result = {};
-                // Extract data field (decoded events/results)
-                if (typeof outputData.getData === "function") {
-                    result.data = convertProtobufValueToJs(outputData.getData());
-                }
-                // Extract metadata field (method execution details)
-                if (typeof outputData.getMetadata === "function") {
-                    result.metadata = convertProtobufValueToJs(outputData.getMetadata());
-                }
-                // Return both data and metadata for ContractWrite and ContractRead
-                // This ensures consistent structure between simulated and deployed workflow execution
-                return result;
-            }
-            catch (error) {
-                console.warn("Failed to convert ContractWrite/ContractRead protobuf to JavaScript:", error);
-                return outputData.getData ? outputData.getData() : null;
-            }
-        }
-        // STANDARDIZED Direct Mapping - ALL other triggers and nodes use the same logic
-        if (typeof outputData.hasData === "function" && outputData.hasData()) {
+        // Protobuf accessor path
+        if (typeof outputObj.getData === "function") {
+            const val = outputObj.getData();
+            if (!val)
+                return null;
             try {
-                return convertProtobufValueToJs(outputData.getData());
+                return convertProtobufValueToJs(val);
             }
             catch (error) {
                 console.warn("Failed to convert protobuf Value to JavaScript:", error);
-                return outputData.getData();
+                return val;
             }
         }
-        else if (typeof outputData.getData === "function") {
+        // Plain object fallback
+        const data = outputObj.data;
+        if (data) {
             try {
-                return convertProtobufValueToJs(outputData.getData());
+                return typeof data.getKindCase === "function"
+                    ? convertProtobufValueToJs(data)
+                    : data;
             }
             catch (error) {
-                console.warn("Failed to convert protobuf Value to JavaScript:", error);
-                return outputData.getData();
+                console.warn("Failed to convert plain object Value to JavaScript:", error);
+                return data;
             }
         }
-        else if (outputData.data) {
-            // For plain objects, try to convert or use directly
-            return typeof outputData.data.getKindCase === "function"
-                ? convertProtobufValueToJs(outputData.data)
-                : outputData.data;
-        }
         return null;
     }
     static extractOutputData(step) {
@@ -226,6 +209,34 @@ class Step {
         const getEndAt = () => typeof step.getEndAt === "function"
             ? step.getEndAt()
             : step.endAt;
+        // Extract step-level metadata if present (per protobuf: Execution.Step.metadata)
+        let stepMetadata = undefined;
+        if (typeof step.getMetadata === "function" &&
+            step.getMetadata()) {
+            try {
+                stepMetadata = convertProtobufValueToJs(step.getMetadata());
+            }
+            catch (e) {
+                stepMetadata = step.getMetadata();
+            }
+        }
+        else if (step.metadata) {
+            stepMetadata = step.metadata;
+        }
+        // Extract executionContext if present on the step
+        let executionContext = undefined;
+        if (typeof step.getExecutionContext === "function" &&
+            step.getExecutionContext()) {
+            try {
+                executionContext = convertProtobufValueToJs(step.getExecutionContext());
+            }
+            catch (e) {
+                executionContext = step.getExecutionContext();
+            }
+        }
+        else if (step.executionContext) {
+            executionContext = step.executionContext;
+        }
         return new Step({
             id: getId(),
             type: convertProtobufStepTypeToSdk(getType()),
@@ -238,6 +249,8 @@ class Step {
             output: Step.getOutput(step),
             startAt: getStartAt(),
             endAt: getEndAt(),
+            metadata: stepMetadata,
+            executionContext,
         });
     }
 }

package/dist/utils.d.ts

@@ -0,0 +1,77 @@
+import { Value as ProtobufValue } from "google-protobuf/google/protobuf/struct_pb";
+/**
+ * Convert a protobuf Value to a JavaScript value
+ *
+ * **🏆 RECOMMENDED for modern protobuf usage**
+ *
+ * This is the primary implementation using proper TypeScript types and getKindCase()
+ * for the latest protobuf libraries. Use this for all new code.
+ *
+ * @param value - The protobuf Value to convert
+ * @returns The converted JavaScript value
+ */
+export declare function convertProtobufValueToJs(value?: ProtobufValue): any;
+/**
+ * Convert a JavaScript value to a protobuf Value
+ *
+ * Uses proper TypeScript types for modern protobuf usage.
+ *
+ * @param value - The JavaScript value to convert
+ * @returns The protobuf Value object
+ */
+export declare function convertJSValueToProtobuf(value: any): ProtobufValue;
+/**
+ * Recursively convert object keys from snake_case to camelCase.
+ * Leaves non-objects and arrays intact (arrays are mapped over).
+ */
+export declare function toCamelCaseKeys<T = any>(input: any): T;
+/**
+ * Convert protobuf trigger type string to SDK trigger type string
+ *
+ * @param protobufType - The protobuf trigger type string (e.g., "TRIGGER_TYPE_MANUAL")
+ * @returns The SDK trigger type string (e.g., "manualTrigger")
+ */
+export declare function convertProtobufTriggerTypeToSdk(protobufType: string): string;
+/**
+ * Convert protobuf node type string to SDK node type string
+ *
+ * @param protobufType - The protobuf node type string (e.g., "NODE_TYPE_CUSTOM_CODE")
+ * @returns The SDK node type string (e.g., "customCode")
+ */
+export declare function convertProtobufNodeTypeToSdk(protobufType: string): string;
+/**
+ * Convert protobuf step type string to SDK step type string
+ *
+ * Automatically detects whether the type is a trigger or node type and converts accordingly.
+ *
+ * @param protobufType - The protobuf type string (e.g., "TRIGGER_TYPE_MANUAL" or "NODE_TYPE_CUSTOM_CODE")
+ * @returns The SDK type string (e.g., "manualTrigger" or "customCode")
+ */
+export declare function convertProtobufStepTypeToSdk(protobufType: string): string;
+/**
+ * Convert input field from JavaScript object to protobuf Value format
+ *
+ * Pure utility function for converting trigger/node input data to protobuf format.
+ * Can be used by both triggers and nodes.
+ *
+ * @param input - JavaScript object with input data, or undefined
+ * @returns protobuf Value or undefined if no input
+ */
+export declare function convertInputToProtobuf(input?: Record<string, any>): ProtobufValue | undefined;
+/**
+ * Extract input field from protobuf Value format to JavaScript object
+ *
+ * Pure utility function for extracting trigger/node input data from protobuf format.
+ * Can be used by both triggers and nodes.
+ *
+ * @param inputValue - protobuf Value from response, plain JavaScript object, or undefined
+ * @returns JavaScript object or undefined
+ */
+export declare function extractInputFromProtobuf(inputValue?: ProtobufValue | Record<string, any>): Record<string, any> | undefined;
+/**
+ * Clean up gRPC error messages by extracting the actual message
+ * @param message - The raw gRPC error message
+ * @returns {string} - The cleaned error message
+ */
+export declare function cleanGrpcErrorMessage(message: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,IAAI,aAAa,EAGvB,MAAM,2CAA2C,CAAC;AAGnD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,GAAG,CAiCnE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,GAAG,GAAG,aAAa,CA6BlE;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAkB5E;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CA0BzE;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CASzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,aAAa,GAAG,SAAS,CAK3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC/C,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAiCjC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsB7D"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,IAAI,aAAa,EAGvB,MAAM,2CAA2C,CAAC;AAGnD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,GAAG,CAiCnE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,GAAG,GAAG,aAAa,CA6BlE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,CAatD;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAkB5E;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CA0BzE;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CASzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC1B,aAAa,GAAG,SAAS,CAK3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC/C,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAiCjC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAsB7D"}

package/dist/utils.js

@@ -88,6 +88,25 @@ export function convertJSValueToProtobuf(value) {
     }
     return protobufValue;
 }
+/**
+ * Recursively convert object keys from snake_case to camelCase.
+ * Leaves non-objects and arrays intact (arrays are mapped over).
+ */
+export function toCamelCaseKeys(input) {
+    if (input === null || input === undefined)
+        return input;
+    if (Array.isArray(input)) {
+        return input.map((item) => toCamelCaseKeys(item));
+    }
+    if (typeof input !== "object")
+        return input;
+    const result = {};
+    for (const [key, value] of Object.entries(input)) {
+        const camelKey = key.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+        result[camelKey] = toCamelCaseKeys(value);
+    }
+    return result;
+}
 /**
  * Convert protobuf trigger type string to SDK trigger type string
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avaprotocol/sdk-js",
-  "version": "2.6.12",
+  "version": "2.7.0",
   "description": "A JavaScript/TypeScript SDK designed to simplify integration with Ava Protocol's AVS",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -31,7 +31,7 @@
     "prepare": "node ../../scripts/prepare-package.js"
   },
   "dependencies": {
-    "@avaprotocol/types": "^2.4.10",
+    "@avaprotocol/types": "^2.5.0",
     "@grpc/grpc-js": "^1.11.3",
     "@grpc/proto-loader": "^0.7.13",
     "dotenv": "^16.4.5",