@zapier/zapier-sdk-cli 0.71.0 → 0.72.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @zapier/zapier-sdk-cli
 
+## 0.72.0
+
+### Minor Changes
+
+- 6e5189c: Added a `manual` option (experimental) to `publishWorkflowVersion`, exposed in the CLI as `--manual` on `publish-workflow-version`. Pass `manual: true` to publish an on-demand, triggerless workflow version explicitly; pass `trigger` for a triggered one. The two are mutually exclusive — sending both is rejected with a 400.
+
+### Patch Changes
+
+- Updated dependencies [80dc74a]
+- Updated dependencies [6e5189c]
+  - @zapier/zapier-sdk@0.95.0
+  - @zapier/zapier-sdk-mcp@0.19.2
+
+## 0.71.1
+
+### Patch Changes
+
+- 0f54b24: CLI commands with an object-typed parameter (e.g. `run-durable`'s `<source-files>`, or an array-of-object parameter like its `notifications`) now reject invalid input with a clear error naming the parameter, instead of silently passing it through to a confusing downstream validation error like `expected record, received string`:
+  - A string that isn't valid JSON reports the parse failure. A value that looks like a file path (contains a slash or ends in `.ts`/`.js`/`.tsx`/`.jsx`/`.json`) gets an additional hint that a JSON value was expected, not a path on disk.
+  - A string that parses as valid JSON but isn't an object (e.g. `42`, `true`, `null`) is also rejected, since it can never satisfy an object-shaped parameter.
+
+- Updated dependencies [59a8180]
+  - @zapier/zapier-sdk@0.94.1
+  - @zapier/zapier-sdk-mcp@0.19.1
+
 ## 0.71.0
 
 ### Minor Changes

package/README.md

@@ -874,16 +874,17 @@ Publish a new version of a durable workflow. Enables the workflow by default.
 | `--ignore-open-drafts`     | `boolean` | ❌       | —       | —               | Publish even though the workflow has open draft(s). Without this, the API rejects a direct publish with a 409 while any draft is open, since publishing the draft later would ship its stale content over this version. |
 | `--connections`            | `object`  | ❌       | —       | —               | Map of connection aliases to Zapier connections used by the workflow. Pass `null` to clear an existing binding.                                                                                                         |
 | `--app-versions`           | `object`  | ❌       | —       | —               | Map of app keys to pinned app implementation/version used by the workflow. Pass `null` to clear an existing binding.                                                                                                    |
-| `--trigger`                | `object`  | ❌       | —       | —               | Trigger configuration. When provided, the workflow subscribes to a Zapier trigger; omit for webhook-only workflows.                                                                                                     |
+| `--trigger`                | `object`  | ❌       | —       | —               | Trigger configuration. When provided, the workflow subscribes to a Zapier trigger; for an on-demand, triggerless workflow, omit this and pass `manual: true` instead.                                                   |
 | ​ ↳ `selectedApi`          | `string`  | ❌       | —       | —               | Zapier app/API identifier (e.g. 'GoogleSheetsAPI'). Required when a trigger is configured.                                                                                                                              |
 | ​ ↳ `action`               | `string`  | ✅       | —       | —               | Trigger action key (e.g. 'new_row')                                                                                                                                                                                     |
 | ​ ↳ `authenticationId`     | `string`  | ❌       | —       | —               | Connection ID for the trigger source. Omit or pass null for no-auth triggers (e.g. Schedule by Zapier).                                                                                                                 |
 | ​ ↳ `params`               | `object`  | ❌       | —       | —               | Trigger parameters as a JSON object                                                                                                                                                                                     |
+| `--manual`                 | `boolean` | ❌       | —       | —               | Declare this an on-demand, triggerless workflow version. Pass `manual: true` only when omitting `trigger`; passing both is a contradiction the API rejects with a 400.                                                  |
 
 **Usage:**
 
 ```bash
-npx zapier-sdk publish-workflow-version <workflow> <source-files> [--dependencies] [--zapier-durable-version] [--enabled] [--ignore-open-drafts] [--connections] [--app-versions] [--trigger]
+npx zapier-sdk publish-workflow-version <workflow> <source-files> [--dependencies] [--zapier-durable-version] [--enabled] [--ignore-open-drafts] [--connections] [--app-versions] [--trigger] [--manual]
 ```
 
 #### `run-durable` 🧪 _experimental_

package/dist/cli.cjs

@@ -602,7 +602,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.71.0"};
+  version: "0.72.0"};
 var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
 var LOCKFILES = [
   ["pnpm-lock.yaml", "pnpm"],
@@ -1982,7 +1982,8 @@ function convertCliArgsToSdkParams(parameters, positionalArgs, options) {
       sdkParams[param.name] = convertValue(
         positionalValue,
         param.type,
-        param.elementType
+        param.elementType,
+        param.name
       );
     }
   });
@@ -2005,7 +2006,12 @@ function convertCliArgsToSdkParams(parameters, positionalArgs, options) {
       if (param.type === "array" && Array.isArray(value) && value.length === 0) {
         return;
       }
-      sdkParams[camelKey] = convertValue(value, param.type, param.elementType);
+      sdkParams[camelKey] = convertValue(
+        value,
+        param.type,
+        param.elementType,
+        param.name
+      );
     }
   });
   return sdkParams;
@@ -2020,7 +2026,28 @@ function parseCliBoolean(value) {
     `Expected a boolean (true or false), received "${value}".`
   );
 }
-function convertValue(value, type, elementType) {
+function looksLikeFilePath(value) {
+  return /[/\\]/.test(value) || /\.(ts|js|tsx|jsx|json)$/i.test(value);
+}
+function parseJsonParameter(value, paramName) {
+  let parsed;
+  try {
+    parsed = JSON.parse(value);
+  } catch (error) {
+    const parseErrorMessage = error instanceof Error ? error.message : String(error);
+    const pathHint = looksLikeFilePath(value) ? ` "${value}" looks like a file path \u2014 this parameter expects a JSON value (e.g. an object), not a path on disk.` : "";
+    throw new commander.InvalidArgumentError(
+      `Parameter "${paramName}" expects JSON, but the value could not be parsed: ${parseErrorMessage}.${pathHint}`
+    );
+  }
+  if (typeof parsed !== "object" || parsed === null) {
+    throw new commander.InvalidArgumentError(
+      `Parameter "${paramName}" expects a JSON object, but got: ${value}.`
+    );
+  }
+  return parsed;
+}
+function convertValue(value, type, elementType, paramName) {
   if (value === void 0) {
     return void 0;
   }
@@ -2033,12 +2060,8 @@ function convertValue(value, type, elementType) {
       const arr = Array.isArray(value) ? value : [value];
       if (elementType !== "object") return arr;
       return arr.flatMap((item) => {
-        if (typeof item === "string" && (item.startsWith("{") || item.startsWith("["))) {
-          try {
-            return JSON.parse(item);
-          } catch {
-            return item;
-          }
+        if (typeof item === "string") {
+          return parseJsonParameter(item, paramName ?? "value");
         }
         return item;
       });
@@ -2047,11 +2070,7 @@ function convertValue(value, type, elementType) {
       return value;
     case "object":
       if (typeof value === "string") {
-        try {
-          return JSON.parse(value);
-        } catch {
-          return value;
-        }
+        return parseJsonParameter(value, paramName ?? "value");
       }
       return value;
     default:
@@ -8341,7 +8360,7 @@ function buildBoxLines(message) {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.71.0"};
+  version: "0.72.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();

package/dist/cli.mjs

@@ -558,7 +558,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.71.0"};
+  version: "0.72.0"};
 var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
 var LOCKFILES = [
   ["pnpm-lock.yaml", "pnpm"],
@@ -1938,7 +1938,8 @@ function convertCliArgsToSdkParams(parameters, positionalArgs, options) {
       sdkParams[param.name] = convertValue(
         positionalValue,
         param.type,
-        param.elementType
+        param.elementType,
+        param.name
       );
     }
   });
@@ -1961,7 +1962,12 @@ function convertCliArgsToSdkParams(parameters, positionalArgs, options) {
       if (param.type === "array" && Array.isArray(value) && value.length === 0) {
         return;
       }
-      sdkParams[camelKey] = convertValue(value, param.type, param.elementType);
+      sdkParams[camelKey] = convertValue(
+        value,
+        param.type,
+        param.elementType,
+        param.name
+      );
     }
   });
   return sdkParams;
@@ -1976,7 +1982,28 @@ function parseCliBoolean(value) {
     `Expected a boolean (true or false), received "${value}".`
   );
 }
-function convertValue(value, type, elementType) {
+function looksLikeFilePath(value) {
+  return /[/\\]/.test(value) || /\.(ts|js|tsx|jsx|json)$/i.test(value);
+}
+function parseJsonParameter(value, paramName) {
+  let parsed;
+  try {
+    parsed = JSON.parse(value);
+  } catch (error) {
+    const parseErrorMessage = error instanceof Error ? error.message : String(error);
+    const pathHint = looksLikeFilePath(value) ? ` "${value}" looks like a file path \u2014 this parameter expects a JSON value (e.g. an object), not a path on disk.` : "";
+    throw new InvalidArgumentError(
+      `Parameter "${paramName}" expects JSON, but the value could not be parsed: ${parseErrorMessage}.${pathHint}`
+    );
+  }
+  if (typeof parsed !== "object" || parsed === null) {
+    throw new InvalidArgumentError(
+      `Parameter "${paramName}" expects a JSON object, but got: ${value}.`
+    );
+  }
+  return parsed;
+}
+function convertValue(value, type, elementType, paramName) {
   if (value === void 0) {
     return void 0;
   }
@@ -1989,12 +2016,8 @@ function convertValue(value, type, elementType) {
       const arr = Array.isArray(value) ? value : [value];
       if (elementType !== "object") return arr;
       return arr.flatMap((item) => {
-        if (typeof item === "string" && (item.startsWith("{") || item.startsWith("["))) {
-          try {
-            return JSON.parse(item);
-          } catch {
-            return item;
-          }
+        if (typeof item === "string") {
+          return parseJsonParameter(item, paramName ?? "value");
         }
         return item;
       });
@@ -2003,11 +2026,7 @@ function convertValue(value, type, elementType) {
       return value;
     case "object":
       if (typeof value === "string") {
-        try {
-          return JSON.parse(value);
-        } catch {
-          return value;
-        }
+        return parseJsonParameter(value, paramName ?? "value");
       }
       return value;
     default:
@@ -8297,7 +8316,7 @@ function buildBoxLines(message) {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.71.0"};
+  version: "0.72.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();

package/dist/experimental.cjs

@@ -6861,7 +6861,7 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.71.0"};
+  version: "0.72.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();

package/dist/experimental.mjs

@@ -6820,7 +6820,7 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.71.0"};
+  version: "0.72.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();

package/dist/index.cjs

@@ -6862,7 +6862,7 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.71.0"};
+  version: "0.72.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();
@@ -6946,7 +6946,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.71.0"};
+  version: "0.72.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/dist/index.mjs

@@ -6821,7 +6821,7 @@ function collectDeprecationNoticeAndForward(event, onEvent) {
 // package.json with { type: 'json' }
 var package_default = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.71.0"};
+  version: "0.72.0"};
 
 // src/sdk.ts
 var warnedDeprecatedMethods = /* @__PURE__ */ new Set();
@@ -6905,7 +6905,7 @@ function createZapierCliSdk(options = {}) {
 
 // package.json
 var package_default2 = {
-  version: "0.71.0"};
+  version: "0.72.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk-cli",
-  "version": "0.71.0",
+  "version": "0.72.0",
   "description": "Command line interface for Zapier SDK",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -95,8 +95,8 @@
     "typescript": "^5.8.3",
     "wrap-ansi": "^10.0.0",
     "zod": "4.3.6",
-    "@zapier/zapier-sdk": "0.94.0",
-    "@zapier/zapier-sdk-mcp": "0.19.0"
+    "@zapier/zapier-sdk": "0.95.0",
+    "@zapier/zapier-sdk-mcp": "0.19.2"
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",