@zapier/zapier-sdk-cli 0.24.4 → 0.25.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @zapier/zapier-sdk-cli
 
+## 0.25.0
+
+### Minor Changes
+
+- d72cda1: Deprecates request() in favor of self-contained fetch(). The fetch plugin now handles URL-to-relay transformation, header normalization,
+  and body content-type inference directly instead of delegating to request. The request plugin is preserved as a backward-compatible
+  shim that forwards to fetch. CLI and MCP now expose a fetch command via a new inputParameters registry concept for
+  multi-positional-argument functions.
+
+### Patch Changes
+
+- Updated dependencies [d72cda1]
+  - @zapier/zapier-sdk-mcp@0.8.0
+  - @zapier/zapier-sdk@0.24.0
+
 ## 0.24.4
 
 ### Patch Changes

package/README.md

@@ -30,7 +30,7 @@
   - [`delete-client-credentials`](#delete-client-credentials)
   - [`list-client-credentials`](#list-client-credentials)
 - [HTTP Requests](#http-requests)
-  - [`request`](#request)
+  - [`fetch`](#fetch)
 - [Utilities](#utilities)
   - [`add`](#add)
   - [`build-manifest`](#build-manifest)
@@ -423,27 +423,26 @@ npx zapier-sdk list-client-credentials [--page-size] [--max-items] [--cursor]
 
 ### HTTP Requests
 
-#### `request`
+#### `fetch`
 
-Make authenticated HTTP requests through Zapier's Relay service
+Make authenticated HTTP requests to any API through Zapier's Relay service. Pass an authenticationId to automatically inject the user's stored credentials (OAuth tokens, API keys, etc.) into the outgoing request. Mirrors the native fetch(url, init?) signature with additional Zapier-specific options.
 
 **Options:**
 
-| Option                      | Type                    | Required | Default | Possible Values                                            | Description                                                          |
-| --------------------------- | ----------------------- | -------- | ------- | ---------------------------------------------------------- | -------------------------------------------------------------------- |
-| `<url>`                     | `string`                | ✅       | —       | —                                                          | The URL to request (will be proxied through Relay)                   |
-| `--method`                  | `string`                | ❌       | —       | `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HEAD`, `OPTIONS` | HTTP method                                                          |
-| `--body`                    | `string`                | ❌       | —       | —                                                          | Request body as a string                                             |
-| `--authentication-id`       | `string, number`        | ❌       | —       | —                                                          | Authentication ID to use for this action                             |
-| `--callback-url`            | `string`                | ❌       | —       | —                                                          | URL to send async response to (makes request async)                  |
-| `--authentication-template` | `string`                | ❌       | —       | —                                                          | Optional JSON string authentication template to bypass Notary lookup |
-| `--headers`                 | `record, custom, array` | ❌       | —       | —                                                          | Request headers                                                      |
-| `--relay-base-url`          | `string`                | ❌       | —       | —                                                          | Base URL for Relay service                                           |
+| Option                      | Type                     | Required | Default | Possible Values                                            | Description                                                                       |
+| --------------------------- | ------------------------ | -------- | ------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------- |
+| `<url>`                     | `string, custom`         | ✅       | —       | —                                                          | The full URL of the API endpoint to call (proxied through Zapier's Relay service) |
+| `--method`                  | `string`                 | ❌       | —       | `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HEAD`, `OPTIONS` | HTTP method for the request (defaults to GET)                                     |
+| `--headers`                 | `object`                 | ❌       | —       | —                                                          | HTTP headers to include in the request                                            |
+| `--body`                    | `string, custom, custom` | ❌       | —       | —                                                          | Request body — JSON strings are auto-detected and Content-Type is set accordingly |
+| `--authentication-id`       | `string, number`         | ❌       | —       | —                                                          | Authentication ID to use for this action                                          |
+| `--callback-url`            | `string`                 | ❌       | —       | —                                                          | URL to send async response to (makes request async)                               |
+| `--authentication-template` | `string`                 | ❌       | —       | —                                                          | Optional JSON string authentication template to bypass Notary lookup              |
 
 **Usage:**
 
 ```bash
-npx zapier-sdk request <url> [--method] [--body] [--authentication-id] [--callback-url] [--authentication-template] [--headers] [--relay-base-url]
+npx zapier-sdk fetch <url> [--method] [--headers] [--body] [--authentication-id] [--callback-url] [--authentication-template]
 ```
 
 ### Utilities

package/dist/cli.cjs

@@ -977,6 +977,65 @@ function analyzeZodField(name, schema, functionInfo) {
     isPositional: zapierSdk.isPositional(schema)
   };
 }
+function analyzeInputParameters(inputParameters, functionInfo) {
+  const cliParams = [];
+  for (const param of inputParameters) {
+    let schema = param.schema;
+    let isOptional = false;
+    if (schema instanceof zod.z.ZodOptional) {
+      isOptional = true;
+      schema = schema._zod.def.innerType;
+    }
+    if (schema instanceof zod.z.ZodObject) {
+      const shape = schema.shape;
+      for (const [key, fieldSchema] of Object.entries(shape)) {
+        const analyzed = analyzeZodField(
+          key,
+          fieldSchema,
+          functionInfo
+        );
+        if (analyzed) {
+          if (isOptional) {
+            analyzed.required = false;
+          }
+          cliParams.push(analyzed);
+        }
+      }
+    } else {
+      const analyzed = analyzeZodField(param.name, param.schema, functionInfo);
+      if (analyzed) {
+        analyzed.required = !isOptional;
+        analyzed.isPositional = true;
+        cliParams.push(analyzed);
+      }
+    }
+  }
+  return cliParams;
+}
+function reconstructPositionalArgs(inputParameters, flatParams) {
+  const args = [];
+  for (const param of inputParameters) {
+    let schema = param.schema;
+    if (schema instanceof zod.z.ZodOptional) {
+      schema = schema._zod.def.innerType;
+    }
+    if (schema instanceof zod.z.ZodObject) {
+      const shape = schema.shape;
+      const obj = {};
+      let hasValues = false;
+      for (const key of Object.keys(shape)) {
+        if (key in flatParams && flatParams[key] !== void 0) {
+          obj[key] = flatParams[key];
+          hasValues = true;
+        }
+      }
+      args.push(hasValues ? obj : void 0);
+    } else {
+      args.push(flatParams[param.name]);
+    }
+  }
+  return args;
+}
 function toKebabCase(str) {
   return str.replace(/([A-Z])/g, "-$1").toLowerCase();
 }
@@ -990,7 +1049,7 @@ function generateCliCommands(program2, sdk2) {
   }
   const registry = sdk2.getRegistry({ package: "cli" });
   registry.functions.forEach((fnInfo) => {
-    if (!fnInfo.inputSchema) {
+    if (!fnInfo.inputSchema && !fnInfo.inputParameters) {
       console.warn(`Schema not found for ${fnInfo.name}`);
       return;
     }
@@ -1060,9 +1119,10 @@ function generateCliCommands(program2, sdk2) {
   });
 }
 function createCommandConfig(cliCommandName, functionInfo, sdk2) {
+  const usesInputParameters = !functionInfo.inputSchema && !!functionInfo.inputParameters;
   const schema = functionInfo.inputSchema;
-  const parameters = analyzeZodSchema(schema, functionInfo);
-  const description = schema.description || `${cliCommandName} command`;
+  const parameters = usesInputParameters ? analyzeInputParameters(functionInfo.inputParameters, functionInfo) : analyzeZodSchema(schema, functionInfo);
+  const description = functionInfo.description || schema?.description || `${cliCommandName} command`;
   const handler = async (...args) => {
     try {
       const commandObj = args[args.length - 1];
@@ -1078,13 +1138,18 @@ function createCommandConfig(cliCommandName, functionInfo, sdk2) {
         args.slice(0, -1),
         options
       );
-      const resolver = new SchemaParameterResolver();
-      const resolvedParams = await resolver.resolveParameters(
-        schema,
-        rawParams,
-        sdk2,
-        functionInfo.name
-      );
+      let resolvedParams;
+      if (schema && !usesInputParameters) {
+        const resolver = new SchemaParameterResolver();
+        resolvedParams = await resolver.resolveParameters(
+          schema,
+          rawParams,
+          sdk2,
+          functionInfo.name
+        );
+      } else {
+        resolvedParams = rawParams;
+      }
       const confirm = functionInfo.confirm;
       let confirmMessageAfter;
       if (confirm && !shouldUseJson) {
@@ -1106,16 +1171,26 @@ function createCommandConfig(cliCommandName, functionInfo, sdk2) {
       } else {
         const hasOutputFile = resolvedParams.output;
         if (hasOutputFile) {
-          const sdkObj2 = sdk2;
-          await sdkObj2[functionInfo.name](resolvedParams);
+          const sdkObj = sdk2;
+          await sdkObj[functionInfo.name](resolvedParams);
           console.log(
             chalk3__default.default.green(`\u2705 ${cliCommandName} completed successfully!`)
           );
           console.log(chalk3__default.default.gray(`Output written to: ${hasOutputFile}`));
           return;
         }
-        const sdkObj = sdk2;
-        let result = await sdkObj[functionInfo.name](resolvedParams);
+        let result;
+        if (usesInputParameters) {
+          const positionalArgs = reconstructPositionalArgs(
+            functionInfo.inputParameters,
+            resolvedParams
+          );
+          const sdkObj = sdk2;
+          result = await sdkObj[functionInfo.name](...positionalArgs);
+        } else {
+          const sdkObj = sdk2;
+          result = await sdkObj[functionInfo.name](resolvedParams);
+        }
         if (result instanceof Response) {
           const response = result;
           let body;
@@ -1196,11 +1271,12 @@ ${confirmMessageAfter}`));
   return {
     description,
     parameters,
-    handler
+    handler,
+    hidden: functionInfo.categories?.includes("deprecated") ?? false
   };
 }
 function addCommand(program2, commandName, config2) {
-  const command = program2.command(commandName).description(config2.description);
+  const command = program2.command(commandName, { hidden: config2.hidden ?? false }).description(config2.description);
   let hasPositionalArray = false;
   config2.parameters.forEach((param) => {
     const kebabName = param.name.replace(/([A-Z])/g, "-$1").toLowerCase();
@@ -1698,7 +1774,7 @@ var LoginSchema = zod.z.object({
 
 // package.json
 var package_default = {
-  version: "0.24.4"};
+  version: "0.25.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -2979,7 +3055,7 @@ function createZapierCliSdk(options = {}) {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.24.4"};
+  version: "0.25.0"};
 function detectPackageManager(cwd = process.cwd()) {
   const ua = process.env.npm_config_user_agent;
   if (ua) {

package/dist/cli.mjs

@@ -941,6 +941,65 @@ function analyzeZodField(name, schema, functionInfo) {
     isPositional: isPositional(schema)
   };
 }
+function analyzeInputParameters(inputParameters, functionInfo) {
+  const cliParams = [];
+  for (const param of inputParameters) {
+    let schema = param.schema;
+    let isOptional = false;
+    if (schema instanceof z.ZodOptional) {
+      isOptional = true;
+      schema = schema._zod.def.innerType;
+    }
+    if (schema instanceof z.ZodObject) {
+      const shape = schema.shape;
+      for (const [key, fieldSchema] of Object.entries(shape)) {
+        const analyzed = analyzeZodField(
+          key,
+          fieldSchema,
+          functionInfo
+        );
+        if (analyzed) {
+          if (isOptional) {
+            analyzed.required = false;
+          }
+          cliParams.push(analyzed);
+        }
+      }
+    } else {
+      const analyzed = analyzeZodField(param.name, param.schema, functionInfo);
+      if (analyzed) {
+        analyzed.required = !isOptional;
+        analyzed.isPositional = true;
+        cliParams.push(analyzed);
+      }
+    }
+  }
+  return cliParams;
+}
+function reconstructPositionalArgs(inputParameters, flatParams) {
+  const args = [];
+  for (const param of inputParameters) {
+    let schema = param.schema;
+    if (schema instanceof z.ZodOptional) {
+      schema = schema._zod.def.innerType;
+    }
+    if (schema instanceof z.ZodObject) {
+      const shape = schema.shape;
+      const obj = {};
+      let hasValues = false;
+      for (const key of Object.keys(shape)) {
+        if (key in flatParams && flatParams[key] !== void 0) {
+          obj[key] = flatParams[key];
+          hasValues = true;
+        }
+      }
+      args.push(hasValues ? obj : void 0);
+    } else {
+      args.push(flatParams[param.name]);
+    }
+  }
+  return args;
+}
 function toKebabCase(str) {
   return str.replace(/([A-Z])/g, "-$1").toLowerCase();
 }
@@ -954,7 +1013,7 @@ function generateCliCommands(program2, sdk2) {
   }
   const registry = sdk2.getRegistry({ package: "cli" });
   registry.functions.forEach((fnInfo) => {
-    if (!fnInfo.inputSchema) {
+    if (!fnInfo.inputSchema && !fnInfo.inputParameters) {
       console.warn(`Schema not found for ${fnInfo.name}`);
       return;
     }
@@ -1024,9 +1083,10 @@ function generateCliCommands(program2, sdk2) {
   });
 }
 function createCommandConfig(cliCommandName, functionInfo, sdk2) {
+  const usesInputParameters = !functionInfo.inputSchema && !!functionInfo.inputParameters;
   const schema = functionInfo.inputSchema;
-  const parameters = analyzeZodSchema(schema, functionInfo);
-  const description = schema.description || `${cliCommandName} command`;
+  const parameters = usesInputParameters ? analyzeInputParameters(functionInfo.inputParameters, functionInfo) : analyzeZodSchema(schema, functionInfo);
+  const description = functionInfo.description || schema?.description || `${cliCommandName} command`;
   const handler = async (...args) => {
     try {
       const commandObj = args[args.length - 1];
@@ -1042,13 +1102,18 @@ function createCommandConfig(cliCommandName, functionInfo, sdk2) {
         args.slice(0, -1),
         options
       );
-      const resolver = new SchemaParameterResolver();
-      const resolvedParams = await resolver.resolveParameters(
-        schema,
-        rawParams,
-        sdk2,
-        functionInfo.name
-      );
+      let resolvedParams;
+      if (schema && !usesInputParameters) {
+        const resolver = new SchemaParameterResolver();
+        resolvedParams = await resolver.resolveParameters(
+          schema,
+          rawParams,
+          sdk2,
+          functionInfo.name
+        );
+      } else {
+        resolvedParams = rawParams;
+      }
       const confirm = functionInfo.confirm;
       let confirmMessageAfter;
       if (confirm && !shouldUseJson) {
@@ -1070,16 +1135,26 @@ function createCommandConfig(cliCommandName, functionInfo, sdk2) {
       } else {
         const hasOutputFile = resolvedParams.output;
         if (hasOutputFile) {
-          const sdkObj2 = sdk2;
-          await sdkObj2[functionInfo.name](resolvedParams);
+          const sdkObj = sdk2;
+          await sdkObj[functionInfo.name](resolvedParams);
           console.log(
             chalk3.green(`\u2705 ${cliCommandName} completed successfully!`)
           );
           console.log(chalk3.gray(`Output written to: ${hasOutputFile}`));
           return;
         }
-        const sdkObj = sdk2;
-        let result = await sdkObj[functionInfo.name](resolvedParams);
+        let result;
+        if (usesInputParameters) {
+          const positionalArgs = reconstructPositionalArgs(
+            functionInfo.inputParameters,
+            resolvedParams
+          );
+          const sdkObj = sdk2;
+          result = await sdkObj[functionInfo.name](...positionalArgs);
+        } else {
+          const sdkObj = sdk2;
+          result = await sdkObj[functionInfo.name](resolvedParams);
+        }
         if (result instanceof Response) {
           const response = result;
           let body;
@@ -1160,11 +1235,12 @@ ${confirmMessageAfter}`));
   return {
     description,
     parameters,
-    handler
+    handler,
+    hidden: functionInfo.categories?.includes("deprecated") ?? false
   };
 }
 function addCommand(program2, commandName, config2) {
-  const command = program2.command(commandName).description(config2.description);
+  const command = program2.command(commandName, { hidden: config2.hidden ?? false }).description(config2.description);
   let hasPositionalArray = false;
   config2.parameters.forEach((param) => {
     const kebabName = param.name.replace(/([A-Z])/g, "-$1").toLowerCase();
@@ -1662,7 +1738,7 @@ var LoginSchema = z.object({
 
 // package.json
 var package_default = {
-  version: "0.24.4"};
+  version: "0.25.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -2943,7 +3019,7 @@ function createZapierCliSdk(options = {}) {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.24.4"};
+  version: "0.25.0"};
 function detectPackageManager(cwd = process.cwd()) {
   const ua = process.env.npm_config_user_agent;
   if (ua) {

package/dist/index.cjs

@@ -302,7 +302,7 @@ var LoginSchema = zod.z.object({
 
 // package.json
 var package_default = {
-  version: "0.24.4"};
+  version: "0.25.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/dist/index.mjs

@@ -271,7 +271,7 @@ var LoginSchema = z.object({
 
 // package.json
 var package_default = {
-  version: "0.24.4"};
+  version: "0.25.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zapier/zapier-sdk-cli",
-    "version": "0.24.4",
+    "version": "0.25.0",
     "description": "Command line interface for Zapier SDK",
     "main": "dist/index.cjs",
     "module": "dist/index.mjs",

package/dist/src/utils/cli-generator.js

@@ -122,6 +122,74 @@ function analyzeZodField(name, schema, functionInfo) {
         isPositional: isPositional(schema),
     };
 }
+/**
+ * Analyze inputParameters (used by multi-parameter functions like fetch) into flat CLI parameters.
+ * Simple-type params become positional args; object-type params have their properties flattened into flags.
+ */
+function analyzeInputParameters(inputParameters, functionInfo) {
+    const cliParams = [];
+    for (const param of inputParameters) {
+        let schema = param.schema;
+        let isOptional = false;
+        // Unwrap optional wrapper
+        if (schema instanceof z.ZodOptional) {
+            isOptional = true;
+            schema = schema._zod.def.innerType;
+        }
+        if (schema instanceof z.ZodObject) {
+            // Flatten object properties into individual CLI flags
+            const shape = schema.shape;
+            for (const [key, fieldSchema] of Object.entries(shape)) {
+                const analyzed = analyzeZodField(key, fieldSchema, functionInfo);
+                if (analyzed) {
+                    if (isOptional) {
+                        analyzed.required = false;
+                    }
+                    cliParams.push(analyzed);
+                }
+            }
+        }
+        else {
+            // Simple type — treat as positional argument
+            const analyzed = analyzeZodField(param.name, param.schema, functionInfo);
+            if (analyzed) {
+                analyzed.required = !isOptional;
+                analyzed.isPositional = true;
+                cliParams.push(analyzed);
+            }
+        }
+    }
+    return cliParams;
+}
+/**
+ * Reconstruct positional arguments for SDK invocation from a flat params record.
+ * Used when calling multi-parameter SDK functions (inputParameters) from the CLI.
+ */
+function reconstructPositionalArgs(inputParameters, flatParams) {
+    const args = [];
+    for (const param of inputParameters) {
+        let schema = param.schema;
+        if (schema instanceof z.ZodOptional) {
+            schema = schema._zod.def.innerType;
+        }
+        if (schema instanceof z.ZodObject) {
+            const shape = schema.shape;
+            const obj = {};
+            let hasValues = false;
+            for (const key of Object.keys(shape)) {
+                if (key in flatParams && flatParams[key] !== undefined) {
+                    obj[key] = flatParams[key];
+                    hasValues = true;
+                }
+            }
+            args.push(hasValues ? obj : undefined);
+        }
+        else {
+            args.push(flatParams[param.name]);
+        }
+    }
+    return args;
+}
 // ============================================================================
 // CLI Structure Derivation - Purely Generic
 // ============================================================================
@@ -151,7 +219,7 @@ export function generateCliCommands(program, sdk) {
     const registry = sdk.getRegistry({ package: "cli" });
     // Create all commands first
     registry.functions.forEach((fnInfo) => {
-        if (!fnInfo.inputSchema) {
+        if (!fnInfo.inputSchema && !fnInfo.inputParameters) {
             console.warn(`Schema not found for ${fnInfo.name}`);
             return;
         }
@@ -213,9 +281,14 @@ export function generateCliCommands(program, sdk) {
     });
 }
 function createCommandConfig(cliCommandName, functionInfo, sdk) {
+    const usesInputParameters = !functionInfo.inputSchema && !!functionInfo.inputParameters;
     const schema = functionInfo.inputSchema;
-    const parameters = analyzeZodSchema(schema, functionInfo);
-    const description = schema.description || `${cliCommandName} command`;
+    const parameters = usesInputParameters
+        ? analyzeInputParameters(functionInfo.inputParameters, functionInfo)
+        : analyzeZodSchema(schema, functionInfo);
+    const description = functionInfo.description ||
+        schema?.description ||
+        `${cliCommandName} command`;
     const handler = async (...args) => {
         try {
             // The last argument is always the command object with parsed options
@@ -229,8 +302,15 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
             // Convert CLI args to SDK method parameters
             const rawParams = convertCliArgsToSdkParams(parameters, args.slice(0, -1), options);
             // Resolve missing parameters interactively using schema metadata
-            const resolver = new SchemaParameterResolver();
-            const resolvedParams = await resolver.resolveParameters(schema, rawParams, sdk, functionInfo.name);
+            // (only available for inputSchema-based functions)
+            let resolvedParams;
+            if (schema && !usesInputParameters) {
+                const resolver = new SchemaParameterResolver();
+                resolvedParams = (await resolver.resolveParameters(schema, rawParams, sdk, functionInfo.name));
+            }
+            else {
+                resolvedParams = rawParams;
+            }
             // Check for confirmation before executing (skip for --json mode)
             const confirm = functionInfo.confirm;
             let confirmMessageAfter;
@@ -256,16 +336,23 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
                 // Special handling for commands that write to files
                 const hasOutputFile = resolvedParams.output;
                 if (hasOutputFile) {
-                    // Call the SDK method for file output commands
                     const sdkObj = sdk;
                     await sdkObj[functionInfo.name](resolvedParams);
                     console.log(chalk.green(`✅ ${cliCommandName} completed successfully!`));
                     console.log(chalk.gray(`Output written to: ${hasOutputFile}`));
                     return;
                 }
-                // Call the SDK method and handle non-paginated results
-                const sdkObj = sdk;
-                let result = await sdkObj[functionInfo.name](resolvedParams);
+                // Invoke SDK method — reconstruct positional args for inputParameters functions
+                let result;
+                if (usesInputParameters) {
+                    const positionalArgs = reconstructPositionalArgs(functionInfo.inputParameters, resolvedParams);
+                    const sdkObj = sdk;
+                    result = await sdkObj[functionInfo.name](...positionalArgs);
+                }
+                else {
+                    const sdkObj = sdk;
+                    result = await sdkObj[functionInfo.name](resolvedParams);
+                }
                 // Handle Response objects by wrapping in a structured envelope
                 if (result instanceof Response) {
                     const response = result;
@@ -345,10 +432,13 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
         description,
         parameters,
         handler,
+        hidden: functionInfo.categories?.includes("deprecated") ?? false,
     };
 }
 function addCommand(program, commandName, config) {
-    const command = program.command(commandName).description(config.description);
+    const command = program
+        .command(commandName, { hidden: config.hidden ?? false })
+        .description(config.description);
     // Track whether we've already used a positional array parameter
     let hasPositionalArray = false;
     // Add parameters to command