@zapier/zapier-sdk 0.10.0 → 0.11.1

package/dist/plugins/listInputFields/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/listInputFields/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,qBAAqB,EACrB,KAAK,sBAAsB,EAE5B,MAAM,WAAW,CAAC;AAGnB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AA0GxE,MAAM,WAAW,6BAA6B;IAC5C,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC;QAC7D,IAAI,EAAE,cAAc,EAAE,CAAC;KACxB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,cAAc,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QAC/D,KAAK,IAAI,aAAa,CAAC,cAAc,CAAC,CAAC;KACxC,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,eAAe,EAAE;gBACf,WAAW,EAAE,OAAO,qBAAqB,CAAC;aAC3C,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,UAAU,CAAC,oBAAoB,CAAC,EAAE,yBAAyB;AAC3D;IACE,GAAG,EAAE,SAAS,CAAC;IACf,4BAA4B,EAAE,4BAA4B,CAAC;CAC5D,EAAE,2DAA2D;AAC9D,6BAA6B,CAqF9B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/listInputFields/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,KAAK,sBAAsB,EAE5B,MAAM,WAAW,CAAC;AAGnB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAmKxE,MAAM,WAAW,6BAA6B;IAC5C,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC;QAC7D,IAAI,EAAE,aAAa,EAAE,CAAC;KACvB,CAAC,GACA,aAAa,CAAC;QAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG;QAC9D,KAAK,IAAI,aAAa,CAAC,cAAc,GAAG,aAAa,GAAG,YAAY,CAAC,CAAC;KACvE,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,eAAe,EAAE;gBACf,WAAW,EAAE,OAAO,qBAAqB,CAAC;aAC3C,CAAC;SACH,CAAC;KACH,CAAC;CACH;AAED,eAAO,MAAM,qBAAqB,EAAE,MAAM,CACxC,UAAU,CAAC,oBAAoB,CAAC,EAAE,yBAAyB;AAC3D;IACE,GAAG,EAAE,SAAS,CAAC;IACf,4BAA4B,EAAE,4BAA4B,CAAC;CAC5D,EAAE,2DAA2D;AAC9D,6BAA6B,CAmF9B,CAAC"}

package/dist/plugins/listInputFields/index.js

@@ -2,7 +2,8 @@ import { ListInputFieldsSchema, } from "./schemas";
 import { ZapierConfigurationError, ZapierApiError } from "../../types/errors";
 import { createPaginatedFunction } from "../../utils/function-utils";
 import { appKeyResolver, actionTypeResolver, actionKeyResolver, authenticationIdResolver, inputsAllOptionalResolver, } from "../../resolvers";
-import { InputFieldItemSchema } from "../../schemas/Field";
+import { RootFieldItemSchema } from "../../schemas/Field";
+import { toTitleCase } from "../../utils/string-utils";
 // Enums for input field transformation
 var InputFieldType;
 (function (InputFieldType) {
@@ -74,7 +75,7 @@ function getItemsTypeFromNeed(need) {
 function transformNeedToInputFieldItem(need) {
     const itemsType = getItemsTypeFromNeed(need);
     return {
-        // Only the final computed/mapped fields that are in InputFieldItemSchema
+        type: "input_field",
         key: need.key,
         default_value: need.default || "",
         depends_on: need.depends_on || [],
@@ -88,6 +89,59 @@ function transformNeedToInputFieldItem(need) {
         items: itemsType ? { type: itemsType } : undefined,
     };
 }
+// Transform Need to InfoFieldItem (for copy fields)
+function transformNeedToInfoFieldItem(need) {
+    return {
+        type: "info_field",
+        key: need.key,
+        description: need.help_text || "",
+        title: need.label,
+    };
+}
+// Transform needs to fields (similar to partnerapi compute_root_fieldset_from_needs)
+function transformNeedsToFields(needs) {
+    const rootFields = [];
+    const fieldsetMap = new Map();
+    for (const need of needs) {
+        if (need.computed) {
+            // Computed needs (i.e zap_id for CodeAPI steps) are not shown by the
+            // editor, hide them here too.
+            continue;
+        }
+        // If parent_key is set, we need to ensure that a corresponding
+        // fieldset exists, since we'll be adding this need to that fieldset
+        if (need.parent_key) {
+            let fieldset = fieldsetMap.get(need.parent_key);
+            if (!fieldset) {
+                fieldset = {
+                    type: "fieldset",
+                    key: need.parent_key,
+                    title: toTitleCase(need.parent_key),
+                    fields: [],
+                };
+                fieldsetMap.set(need.parent_key, fieldset);
+                rootFields.push(fieldset);
+            }
+            // Add field to fieldset
+            if (need.type === "copy" && need.help_text) {
+                fieldset.fields.push(transformNeedToInfoFieldItem(need));
+            }
+            else {
+                fieldset.fields.push(transformNeedToInputFieldItem(need));
+            }
+        }
+        else {
+            // Add field to root
+            if (need.type === "copy" && need.help_text) {
+                rootFields.push(transformNeedToInfoFieldItem(need));
+            }
+            else {
+                rootFields.push(transformNeedToInputFieldItem(need));
+            }
+        }
+    }
+    return rootFields;
+}
 export const listInputFieldsPlugin = ({ context }) => {
     const listInputFields = createPaginatedFunction(async function listInputFieldsPage(options) {
         // Note: This function ignores pageSize and cursor since it's not actually paginated internally
@@ -114,10 +168,10 @@ export const listInputFieldsPlugin = ({ context }) => {
         if (!needsData.success) {
             throw new ZapierApiError(`Failed to get action fields: ${needsData.errors?.join(", ") || "Unknown error"}`);
         }
-        // Transform Need objects to InputFieldItem objects
-        const inputFields = (needsData.needs || []).map(transformNeedToInputFieldItem);
+        // Transform Need objects to Root Fieldset with proper nesting
+        const rootFieldset = transformNeedsToFields(needsData.needs || []);
         return {
-            data: inputFields,
+            data: rootFieldset,
             nextCursor: undefined, // No pagination needed since we return all input fields
         };
     }, ListInputFieldsSchema);
@@ -128,9 +182,9 @@ export const listInputFieldsPlugin = ({ context }) => {
                 listInputFields: {
                     categories: ["action"],
                     type: "list",
-                    itemType: "InputField",
+                    itemType: "RootFieldItem",
                     inputSchema: ListInputFieldsSchema,
-                    outputSchema: InputFieldItemSchema,
+                    outputSchema: RootFieldItemSchema,
                     resolvers: {
                         appKey: appKeyResolver,
                         actionType: actionTypeResolver,

package/dist/plugins/listInputFields/schemas.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { InputFieldItem } from "../../types/domain";
+import type { RootFieldItem } from "../../types/domain";
 import type { PaginatedSdkFunction } from "../../types/functions";
 import type { ZapierConfigurationError, ZapierApiError, ZapierAuthenticationError, ZapierAppNotFoundError, ZapierValidationError, ZapierUnknownError } from "../../types/errors";
 export declare const ListInputFieldsSchema: z.ZodObject<{
@@ -32,10 +32,10 @@ export declare const ListInputFieldsSchema: z.ZodObject<{
 export type ListInputFieldsOptions = z.infer<typeof ListInputFieldsSchema>;
 export type ListInputFieldsError = ZapierConfigurationError | ZapierApiError | ZapierAuthenticationError | ZapierAppNotFoundError | ZapierValidationError | ZapierUnknownError;
 export interface ListInputFieldsPage {
-    data: InputFieldItem[];
+    data: RootFieldItem[];
     nextCursor?: string;
 }
 export interface ListInputFieldsSdkFunction {
-    listInputFields: PaginatedSdkFunction<ListInputFieldsOptions, InputFieldItem>;
+    listInputFields: PaginatedSdkFunction<ListInputFieldsOptions, RootFieldItem[]>;
 }
 //# sourceMappingURL=schemas.d.ts.map

package/dist/plugins/listInputFields/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/listInputFields/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EACV,wBAAwB,EACxB,cAAc,EACd,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAG5B,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBgC,CAAC;AAGnE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAG3E,MAAM,MAAM,oBAAoB,GAC5B,wBAAwB,GACxB,cAAc,GACd,yBAAyB,GACzB,sBAAsB,GACtB,qBAAqB,GACrB,kBAAkB,CAAC;AAGvB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,oBAAoB,CAAC,sBAAsB,EAAE,cAAc,CAAC,CAAC;CAC/E"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/listInputFields/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EACV,wBAAwB,EACxB,cAAc,EACd,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAG5B,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBgC,CAAC;AAGnE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAG3E,MAAM,MAAM,oBAAoB,GAC5B,wBAAwB,GACxB,cAAc,GACd,yBAAyB,GACzB,sBAAsB,GACtB,qBAAqB,GACrB,kBAAkB,CAAC;AAGvB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,oBAAoB,CACnC,sBAAsB,EACtB,aAAa,EAAE,CAChB,CAAC;CACH"}

package/dist/resolvers/inputFieldKey.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inputFieldKey.d.ts","sourceRoot":"","sources":["../../src/resolvers/inputFieldKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,eAAO,MAAM,qBAAqB,EAAE,eAAe,CACjD,cAAc,EACd;IACE,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAyBF,CAAC"}
+{"version":3,"file":"inputFieldKey.d.ts","sourceRoot":"","sources":["../../src/resolvers/inputFieldKey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAiC9D,eAAO,MAAM,qBAAqB,EAAE,eAAe,CACjD,cAAc,EACd;IACE,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CA0BF,CAAC"}

package/dist/resolvers/inputFieldKey.js

@@ -1,3 +1,26 @@
+/**
+ * Helper function to flatten fieldsets into a flat array of input fields.
+ * Used to extract all input fields from nested fieldset structure for field selection.
+ */
+function flattenRootFieldset(rootFieldset) {
+    const result = [];
+    function processItem(item) {
+        if (item.type === "input_field") {
+            result.push(item);
+        }
+        else if (item.type === "fieldset") {
+            // Recursively process fields in the fieldset
+            for (const field of item.fields) {
+                processItem(field);
+            }
+        }
+        // Skip info fields as they're not input fields
+    }
+    for (const item of rootFieldset) {
+        processItem(item);
+    }
+    return result;
+}
 export const inputFieldKeyResolver = {
     type: "dynamic",
     depends: ["appKey", "actionKey", "actionType", "authenticationId"],
@@ -9,7 +32,8 @@ export const inputFieldKeyResolver = {
             authenticationId: resolvedParams.authenticationId,
             inputs: resolvedParams.inputs, // Pass along currently resolved inputs
         });
-        return fieldsResponse.data;
+        // Flatten the fieldset structure for field selection
+        return flattenRootFieldset(fieldsResponse.data);
     },
     prompt: (fields) => ({
         type: "list",

package/dist/resolvers/inputs.d.ts

@@ -1,12 +1,16 @@
-import type { FieldsResolver } from "../utils/schema-utils";
 import type { ActionTypeProperty } from "../types/properties";
-type InputsResolver = FieldsResolver<{
-    appKey: string;
-    actionKey: string;
-    actionType: ActionTypeProperty;
-    authenticationId: number;
-    inputs?: Record<string, unknown>;
-}>;
+import type { RootFieldItem } from "../types/domain";
+type InputsResolver = {
+    type: "fields";
+    depends: readonly string[];
+    fetch: (sdk: any, resolvedParams: {
+        appKey: string;
+        actionKey: string;
+        actionType: ActionTypeProperty;
+        authenticationId: number;
+        inputs?: Record<string, unknown>;
+    }) => Promise<RootFieldItem[]>;
+};
 export declare const inputsResolver: InputsResolver;
 export declare const inputsAllOptionalResolver: InputsResolver;
 export {};

package/dist/resolvers/inputs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/resolvers/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,KAAK,cAAc,GAAG,cAAc,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,cAa5B,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,cAgBvC,CAAC"}
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/resolvers/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAuBrD,KAAK,cAAc,GAAG;IACpB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,CACL,GAAG,EAAE,GAAG,EACR,cAAc,EAAE;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,kBAAkB,CAAC;QAC/B,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,KACE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAa5B,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,cAcvC,CAAC"}

package/dist/resolvers/inputs.js

@@ -1,3 +1,24 @@
+// Helper function to recursively make all input fields optional while preserving structure
+function makeFieldsOptional(fields) {
+    return fields.map((field) => {
+        if (field.type === "input_field") {
+            return {
+                ...field,
+                is_required: false,
+            };
+        }
+        else if (field.type === "fieldset") {
+            return {
+                ...field,
+                fields: makeFieldsOptional(field.fields),
+            };
+        }
+        else {
+            // Info fields remain unchanged
+            return field;
+        }
+    });
+}
 export const inputsResolver = {
     type: "fields",
     depends: ["appKey", "actionKey", "actionType", "authenticationId"],
@@ -23,9 +44,7 @@ export const inputsAllOptionalResolver = {
             authenticationId: resolvedParams.authenticationId,
             inputs: resolvedParams.inputs, // Pass along currently resolved inputs
         });
-        return fieldsResponse.data.map((field) => ({
-            ...field,
-            is_required: false,
-        }));
+        // Return nested structure with all fields marked as optional.
+        return makeFieldsOptional(fieldsResponse.data);
     },
 };

package/dist/schemas/Field.d.ts

@@ -1,6 +1,18 @@
 import { z } from "zod";
+export declare const BaseFieldItemSchema: z.ZodObject<{
+    type: z.ZodString;
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    key: string;
+}, {
+    type: string;
+    key: string;
+}>;
 export declare const InputFieldItemSchema: z.ZodObject<{
     key: z.ZodString;
+} & {
+    type: z.ZodLiteral<"input_field">;
     default_value: z.ZodString;
     depends_on: z.ZodArray<z.ZodString, "many">;
     description: z.ZodString;
@@ -18,6 +30,7 @@ export declare const InputFieldItemSchema: z.ZodObject<{
         type: string;
     }>>;
 }, "strip", z.ZodTypeAny, {
+    type: "input_field";
     key: string;
     depends_on: string[];
     placeholder: string;
@@ -32,6 +45,7 @@ export declare const InputFieldItemSchema: z.ZodObject<{
         type: string;
     } | undefined;
 }, {
+    type: "input_field";
     key: string;
     depends_on: string[];
     placeholder: string;
@@ -46,6 +60,100 @@ export declare const InputFieldItemSchema: z.ZodObject<{
         type: string;
     } | undefined;
 }>;
+export declare const InfoFieldItemSchema: z.ZodObject<{
+    key: z.ZodString;
+} & {
+    type: z.ZodLiteral<"info_field">;
+    description: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "info_field";
+    key: string;
+    description: string;
+    title?: string | undefined;
+}, {
+    type: "info_field";
+    key: string;
+    description: string;
+    title?: string | undefined;
+}>;
+type FieldsetItemType = z.infer<typeof InputFieldItemSchema> | z.infer<typeof InfoFieldItemSchema> | FieldsetItem;
+export interface FieldsetItem {
+    type: "fieldset";
+    key: string;
+    title: string;
+    fields: FieldsetItemType[];
+}
+export declare const FieldsetItemSchema: z.ZodType<FieldsetItem>;
+export declare const RootFieldItemSchema: z.ZodUnion<[z.ZodObject<{
+    key: z.ZodString;
+} & {
+    type: z.ZodLiteral<"input_field">;
+    default_value: z.ZodString;
+    depends_on: z.ZodArray<z.ZodString, "many">;
+    description: z.ZodString;
+    invalidates_input_fields: z.ZodBoolean;
+    is_required: z.ZodBoolean;
+    placeholder: z.ZodString;
+    title: z.ZodString;
+    value_type: z.ZodString;
+    format: z.ZodOptional<z.ZodString>;
+    items: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+    }, {
+        type: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    type: "input_field";
+    key: string;
+    depends_on: string[];
+    placeholder: string;
+    description: string;
+    title: string;
+    default_value: string;
+    invalidates_input_fields: boolean;
+    is_required: boolean;
+    value_type: string;
+    format?: string | undefined;
+    items?: {
+        type: string;
+    } | undefined;
+}, {
+    type: "input_field";
+    key: string;
+    depends_on: string[];
+    placeholder: string;
+    description: string;
+    title: string;
+    default_value: string;
+    invalidates_input_fields: boolean;
+    is_required: boolean;
+    value_type: string;
+    format?: string | undefined;
+    items?: {
+        type: string;
+    } | undefined;
+}>, z.ZodObject<{
+    key: z.ZodString;
+} & {
+    type: z.ZodLiteral<"info_field">;
+    description: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "info_field";
+    key: string;
+    description: string;
+    title?: string | undefined;
+}, {
+    type: "info_field";
+    key: string;
+    description: string;
+    title?: string | undefined;
+}>, z.ZodType<FieldsetItem, z.ZodTypeDef, FieldsetItem>]>;
 export type InputFieldItem = z.infer<typeof InputFieldItemSchema>;
-export type FieldItem = InputFieldItem;
+export type InfoFieldItem = z.infer<typeof InfoFieldItemSchema>;
+export type RootFieldItem = z.infer<typeof RootFieldItemSchema>;
+export {};
 //# sourceMappingURL=Field.d.ts.map

package/dist/schemas/Field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../src/schemas/Field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkFhC,CAAC;AAMF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGlE,MAAM,MAAM,SAAS,GAAG,cAAc,CAAC"}
+{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../src/schemas/Field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAMH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkFhC,CAAC;AAMF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;EAc/B,CAAC;AAOF,KAAK,gBAAgB,GACjB,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,GACpC,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GACnC,YAAY,CAAC;AAEjB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAanD,CAAC;AAML,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yDAI9B,CAAC;AAMH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/schemas/Field.js

@@ -1,10 +1,17 @@
 import { z } from "zod";
 import { withFormatter } from "../utils/schema-utils";
 // ============================================================================
-// Input Field Item Schema (extends API Need schema with computed fields and formatting)
+// Base Field Schema
 // ============================================================================
-export const InputFieldItemSchema = withFormatter(z.object({
+export const BaseFieldItemSchema = z.object({
+    type: z.string(), // "input_field", "info_field", or "fieldset"
     key: z.string(), // From need.key
+});
+// ============================================================================
+// Input Field Item Schema (extends API Need schema with computed fields and formatting)
+// ============================================================================
+export const InputFieldItemSchema = withFormatter(BaseFieldItemSchema.extend({
+    type: z.literal("input_field"),
     default_value: z.string(), // Mapped from 'default' with fallback to ""
     depends_on: z.array(z.string()), // Mapped from 'depends_on' with fallback to []
     description: z.string(), // Mapped from 'help_text' with fallback to ""
@@ -75,3 +82,35 @@ export const InputFieldItemSchema = withFormatter(z.object({
         };
     },
 });
+// ============================================================================
+// Info Field Item Schema (for help text and copy fields)
+// ============================================================================
+export const InfoFieldItemSchema = withFormatter(BaseFieldItemSchema.extend({
+    type: z.literal("info_field"),
+    description: z.string(), // From need.help_text
+    title: z.string().optional(), // Optional title
+}), {
+    format: (item) => ({
+        title: item.title || "Info",
+        key: item.key,
+        description: item.description,
+        details: [{ text: item.description, style: "normal" }],
+    }),
+});
+export const FieldsetItemSchema = BaseFieldItemSchema.extend({
+    type: z.literal("fieldset"),
+    title: z.string(),
+    fields: z.lazy(() => z.array(z.union([
+        InputFieldItemSchema,
+        InfoFieldItemSchema,
+        FieldsetItemSchema,
+    ]))),
+});
+// ============================================================================
+// Root Field Item Schema (union of all possible field types)
+// ============================================================================
+export const RootFieldItemSchema = z.union([
+    InputFieldItemSchema,
+    InfoFieldItemSchema,
+    FieldsetItemSchema,
+]);

package/dist/types/domain.d.ts

@@ -6,8 +6,9 @@ import type { z } from "zod";
 import type { AppItemSchema } from "../schemas/App";
 import type { AuthenticationItemSchema } from "../schemas/Auth";
 import type { ActionItemSchema } from "../schemas/Action";
-import type { InputFieldItemSchema } from "../schemas/Field";
+import type { InputFieldItemSchema, InfoFieldItemSchema, RootFieldItemSchema } from "../schemas/Field";
 import type { UserProfileItemSchema } from "../schemas/UserProfile";
+import type { FieldsetItem } from "../schemas/Field";
 /**
  * Represents an app item returned by getApp and listApps functions
  * Inferred from AppItemSchema which extends the base App API schema
@@ -28,6 +29,21 @@ export type ActionItem = z.infer<typeof ActionItemSchema>;
  * Inferred from InputFieldItemSchema which extends the base Need API schema
  */
 export type InputFieldItem = z.infer<typeof InputFieldItemSchema>;
+/**
+ * Represents an info field item (help text/copy) returned by listInputFields functions
+ * Inferred from InfoFieldItemSchema
+ */
+export type InfoFieldItem = z.infer<typeof InfoFieldItemSchema>;
+/**
+ * Represents a fieldset (group of fields) returned by listInputFields functions
+ * This is defined as an interface rather than inferred due to recursive nature
+ */
+export type { FieldsetItem };
+/**
+ * Represents a root field item (any field/fieldset type) returned by listInputFields
+ * Inferred from RootFieldItemSchema - use as RootFieldItem[]
+ */
+export type RootFieldItem = z.infer<typeof RootFieldItemSchema>;
 /**
  * Represents a user profile item returned by getProfile function
  * Inferred from UserProfileItemSchema which extends the base UserProfile API schema

package/dist/types/domain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/types/domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/types/domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;GAGG;AACH,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/utils/string-utils.d.ts

@@ -0,0 +1,12 @@
+/**
+ * String utility functions for the Zapier SDK
+ */
+/**
+ * Converts a string to title case, handling various input formats:
+ * - camelCase: "firstName" → "First Name"
+ * - snake_case: "first_name" → "First Name"
+ * - kebab-case: "first-name" → "First Name"
+ * - mixed formats: "first_name-value" → "First Name Value"
+ */
+export declare function toTitleCase(input: string): string;
+//# sourceMappingURL=string-utils.d.ts.map

package/dist/utils/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcjD"}

package/dist/utils/string-utils.js

@@ -0,0 +1,23 @@
+/**
+ * String utility functions for the Zapier SDK
+ */
+/**
+ * Converts a string to title case, handling various input formats:
+ * - camelCase: "firstName" → "First Name"
+ * - snake_case: "first_name" → "First Name"
+ * - kebab-case: "first-name" → "First Name"
+ * - mixed formats: "first_name-value" → "First Name Value"
+ */
+export function toTitleCase(input) {
+    return (input
+        // insert a space before capital letters (handles camelCase)
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        // replace delimiters (underscore, dash, multiple spaces) with single space
+        .replace(/[_\-]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        // split and capitalize each word
+        .split(" ")
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join(" "));
+}

package/dist/utils/string-utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=string-utils.test.d.ts.map

package/dist/utils/string-utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.test.d.ts","sourceRoot":"","sources":["../../src/utils/string-utils.test.ts"],"names":[],"mappings":""}

package/dist/utils/string-utils.test.js

@@ -0,0 +1,36 @@
+import { describe, it, expect } from "vitest";
+import { toTitleCase } from "./string-utils";
+describe("toTitleCase", () => {
+    it("converts snake_case to title case", () => {
+        expect(toTitleCase("first_name")).toBe("First Name");
+        expect(toTitleCase("sender_settings")).toBe("Sender Settings");
+        expect(toTitleCase("api_key_config")).toBe("Api Key Config");
+    });
+    it("converts camelCase to title case", () => {
+        expect(toTitleCase("firstName")).toBe("First Name");
+        expect(toTitleCase("senderSettings")).toBe("Sender Settings");
+        expect(toTitleCase("apiKeyConfig")).toBe("Api Key Config");
+    });
+    it("converts kebab-case to title case", () => {
+        expect(toTitleCase("first-name")).toBe("First Name");
+        expect(toTitleCase("sender-settings")).toBe("Sender Settings");
+        expect(toTitleCase("api-key-config")).toBe("Api Key Config");
+    });
+    it("handles mixed formats", () => {
+        expect(toTitleCase("first_name-value")).toBe("First Name Value");
+        expect(toTitleCase("sender_settings-config")).toBe("Sender Settings Config");
+    });
+    it("handles single words", () => {
+        expect(toTitleCase("name")).toBe("Name");
+        expect(toTitleCase("settings")).toBe("Settings");
+    });
+    it("handles multiple spaces and trims", () => {
+        expect(toTitleCase("  first   name  ")).toBe("First Name");
+        expect(toTitleCase("sender__settings")).toBe("Sender Settings");
+    });
+    it("handles empty and edge cases", () => {
+        expect(toTitleCase("")).toBe("");
+        expect(toTitleCase("a")).toBe("A");
+        expect(toTitleCase("_")).toBe("");
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",