@zapier/zapier-sdk-cli 0.52.10 → 0.52.12

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # @zapier/zapier-sdk-cli
 
+## 0.52.12
+
+### Patch Changes
+
+- a950509: Route all debug, diagnostic, and telemetry log output to stderr (`console.error`) instead of stdout (`console.log`) across the SDK and CLI packages. The CLI now reserves stdout exclusively for the program's data payload — command output, JSON envelopes, response bodies — so callers can safely pipe CLI output through `jq`, `> redirect`, or `JSON.parse` even when `--debug` is on or telemetry/logging flags are enabled. Interactive terminal users see no change since both streams interleave in a TTY.
+- 9096184: Extract the plugin framework into a new sibling package `kitcore` that
+  `@zapier/zapier-sdk` consumes as a workspace devDependency (bundled into
+  the published dist, not a runtime dep). Existing SDK code is unaffected:
+  `createZapierSdk`, `createSdk`, the `ZapierSdk` type, every SDK method, and
+  the full `Zapier*` error hierarchy keep their names, codes, and `instanceof`
+  semantics. Internally `createZapierSdk` now builds via the linear
+  `createPluginStack().use(...).toSdk()` path, which substantially speeds up
+  construction. One behavior change to note: `normalizeError` no longer wraps
+  thrown `Error` subclasses, so a handler's `TypeError` or a userland
+  `MyAppError` bubbles through unchanged and `instanceof` works again; only
+  non-`Error` throws get wrapped.
+
+  New stack-based composition surface for building on top of the SDK:
+  `createZapierSdkStack(options)` (from the root and `/experimental`) returns
+  the unsealed `PluginStack` that `createZapierSdk` materializes, and
+  `createPluginStack`, `createCorePlugin`, and `addPlugin` are re-exported from
+  the root. Build by chaining `.use(...)` and sealing with `.toSdk()`, or
+  extend a sealed SDK in place with `addPlugin(sdk, plugin)`. The chain-style
+  `createSdk().addPlugin(...)` pattern is deprecated (now logs a one-time
+  warning) but still works; the CLI and MCP packages moved their internal
+  assembly to stacks with no change to their commands or tools.
+
+- Updated dependencies [a950509]
+- Updated dependencies [9096184]
+  - @zapier/zapier-sdk@0.67.0
+  - @zapier/zapier-sdk-mcp@0.13.21
+
+## 0.52.11
+
+### Patch Changes
+
+- 0eb6a76: Add the `triggerWorkflow` experimental code-substrate plugin. Lives behind `@zapier/zapier-sdk/experimental` only — the stable subpath does not surface it. Looks up the workflow's `trigger_url` via the durableworkflowzaps API, then POSTs the user-supplied JSON payload to that URL. The trigger endpoint is tokenized (the URL embeds a secret) and takes no auth header, so the SDK uses a raw `fetch` rather than the api plugin for the second leg. Custom fetch flows through `sdk.context.options.fetch` for tests. The workflow id is UUID-validated at the input boundary; trigger endpoint failures (non-2xx, or workflow with no published version) surface as descriptive errors. The CLI gets the `workflowIdResolver` picker for the workflow input.
+- Updated dependencies [66db7cb]
+- Updated dependencies [c7c8f64]
+- Updated dependencies [0eb6a76]
+  - @zapier/zapier-sdk@0.66.0
+  - @zapier/zapier-sdk-mcp@0.13.20
+
 ## 0.52.10
 
 ### Patch Changes

package/README.md

@@ -42,6 +42,7 @@
   - [`list-workflows`](#list-workflows--experimental)
   - [`publish-workflow-version`](#publish-workflow-version--experimental)
   - [`run-durable`](#run-durable--experimental)
+  - [`trigger-workflow`](#trigger-workflow--experimental)
   - [`update-workflow`](#update-workflow--experimental)
 - [Connections](#connections)
   - [`find-first-connection`](#find-first-connection)
@@ -711,7 +712,7 @@ Run a workflow source file as a run-once durable run on sdkdurableapi (no deploy
 | Option                     | Type      | Required | Default | Possible Values | Description                                                                                                     |
 | -------------------------- | --------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------- |
 | `<source_files>`           | `object`  | ✅       | —       | —               | Source files keyed by filename → contents                                                                       |
-| `--input`                  | `string`  | ❌       | —       | —               | Input data passed to the run                                                                                    |
+| `--input`                  | `unknown` | ❌       | —       | —               | Input data passed to the run                                                                                    |
 | `--dependencies`           | `object`  | ❌       | —       | —               | Optional npm package dependencies                                                                               |
 | `--zapier_durable_version` | `string`  | ❌       | —       | —               | Exact semver of @zapier/zapier-durable to use (e.g. "1.2.3"). Defaults to server-configured version if omitted. |
 | `--connections`            | `object`  | ❌       | —       | —               | Named connection aliases. Maps alias names to Zapier connection IDs.                                            |
@@ -724,6 +725,23 @@ Run a workflow source file as a run-once durable run on sdkdurableapi (no deploy
 npx zapier-sdk run-durable <source_files> [--input] [--dependencies] [--zapier_durable_version] [--connections] [--app_versions] [--private]
 ```
 
+#### `trigger-workflow` 🧪 _experimental_
+
+Look up a workflow's trigger URL and fire it manually. The trigger endpoint is tokenized (the URL contains a secret) and takes no auth header, so the SDK uses a raw fetch rather than the api plugin.
+
+**Options:**
+
+| Option       | Type      | Required | Default | Possible Values | Description                                                                                              |
+| ------------ | --------- | -------- | ------- | --------------- | -------------------------------------------------------------------------------------------------------- |
+| `<workflow>` | `string`  | ✅       | —       | —               | Durable workflow ID                                                                                      |
+| `--input`    | `unknown` | ❌       | —       | —               | JSON payload delivered as the trigger body. Sent as `application/json`; omit to fire with an empty body. |
+
+**Usage:**
+
+```bash
+npx zapier-sdk trigger-workflow <workflow> [--input]
+```
+
 #### `update-workflow` 🧪 _experimental_
 
 Update a durable workflow's name and/or description

package/dist/cli.cjs

@@ -200,7 +200,7 @@ var SchemaParameterResolver = class {
   debugLog(message) {
     if (this.debug) {
       this.stopSpinner();
-      console.log(chalk__default.default.gray(`[Zapier CLI] ${message}`));
+      console.error(chalk__default.default.gray(`[Zapier CLI] ${message}`));
     }
   }
   startSpinner() {
@@ -1572,7 +1572,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.52.10"};
+  version: "0.52.12"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -1626,12 +1626,6 @@ function buildCliCommandExecutedEvent({
     subprocess_count: data.subprocess_count ?? null
   };
 }
-function getFormatMetadata(schema) {
-  return schema?._zod?.def?.formatMeta;
-}
-function getOutputSchema(schema) {
-  return schema?._zod?.def?.outputSchema;
-}
 function formatJsonOutput(data) {
   if (data === void 0) {
     return;
@@ -1640,21 +1634,26 @@ function formatJsonOutput(data) {
     util__default.default.inspect(data, { colors: true, depth: null, breakLength: 80 })
   );
 }
-async function formatItemsFromSchema(functionInfo, items, startingNumber = 0, options) {
-  const outputSchema = functionInfo.outputSchema || getOutputSchema(functionInfo.inputSchema);
-  if (!outputSchema) {
-    formatItemsGeneric(items, startingNumber);
-    return;
-  }
-  const formatMeta = getFormatMetadata(outputSchema);
-  if (!formatMeta) {
-    formatItemsGeneric(items, startingNumber);
+async function formatItemsFromSchema(_functionInfo, items, startingNumber = 0, options) {
+  if (options?.formatter) {
+    let context;
+    if (options.formatter.fetch && options.sdk && options.params) {
+      for (const item of items) {
+        context = await options.formatter.fetch(
+          options.sdk,
+          options.params,
+          item,
+          context
+        );
+      }
+    }
+    items.forEach((item, index) => {
+      const formatted = options.formatter.format(item, context);
+      formatSingleItem(formatted, startingNumber + index);
+    });
     return;
   }
-  items.forEach((item, index) => {
-    const formatted = formatMeta.format(item);
-    formatSingleItem(formatted, startingNumber + index);
-  });
+  formatItemsGeneric(items, startingNumber);
 }
 function formatSingleItem(formatted, itemNumber) {
   let titleLine = `${chalk__default.default.gray(`${itemNumber + 1}.`)} ${chalk__default.default.cyan(formatted.title)}`;
@@ -1814,7 +1813,7 @@ function createJsonRenderer() {
         errors: []
       });
     },
-    renderCollectedList(items, _options) {
+    async renderCollectedList(items, _options) {
       outputJson({ data: items, errors: [] });
     },
     renderItem(value, options) {
@@ -1846,27 +1845,32 @@ function getListTitle(functionInfo) {
   if (functionInfo.itemType) return `Available ${functionInfo.itemType} items`;
   return "items";
 }
-function renderItemsForDisplay(items, functionInfo, startingNumber = 0) {
-  if (functionInfo?.inputSchema) {
-    formatItemsFromSchema(
-      functionInfo,
-      items,
-      startingNumber
-    );
-  } else {
-    items.forEach((item, index) => {
-      const obj = item;
-      const name = obj?.name || obj?.key || obj?.id || "Item";
-      console.log(
-        `${chalk__default.default.gray(`${startingNumber + index + 1}.`)} ${chalk__default.default.cyan(String(name))}`
+function createInteractiveRenderer(context = {}) {
+  async function renderItemsForDisplay(items, functionInfo, startingNumber = 0) {
+    if (functionInfo?.inputSchema) {
+      await formatItemsFromSchema(
+        functionInfo,
+        items,
+        startingNumber,
+        {
+          formatter: functionInfo.formatter,
+          sdk: context.sdk,
+          params: context.params
+        }
       );
-      if (obj?.description)
-        console.log(`   ${chalk__default.default.dim(String(obj.description))}`);
-      console.log();
-    });
+    } else {
+      items.forEach((item, index) => {
+        const obj = item;
+        const name = obj?.name || obj?.key || obj?.id || "Item";
+        console.log(
+          `${chalk__default.default.gray(`${startingNumber + index + 1}.`)} ${chalk__default.default.cyan(String(name))}`
+        );
+        if (obj?.description)
+          console.log(`   ${chalk__default.default.dim(String(obj.description))}`);
+        console.log();
+      });
+    }
   }
-}
-function createInteractiveRenderer() {
   return {
     async renderPaginatedList(source, functionInfo) {
       const itemName = getItemName(functionInfo);
@@ -1876,7 +1880,7 @@ function createInteractiveRenderer() {
           console.log(chalk__default.default.yellow(`No ${itemName} found.`));
           return;
         }
-        renderItemsForDisplay(items, functionInfo, 0);
+        await renderItemsForDisplay(items, functionInfo, 0);
         console.log(chalk__default.default.green(`
 \u2705 Showing ${items.length} ${itemName}`));
         return;
@@ -1898,7 +1902,7 @@ function createInteractiveRenderer() {
           console.log(chalk__default.default.blue(`\u{1F4CB} ${getListTitle(functionInfo)}
 `));
         }
-        renderItemsForDisplay(items, functionInfo, totalShown);
+        await renderItemsForDisplay(items, functionInfo, totalShown);
         totalShown += items.length;
         console.log(
           chalk__default.default.green(
@@ -1923,7 +1927,7 @@ function createInteractiveRenderer() {
       console.log(chalk__default.default.gray(`
 \u{1F4C4} Finished browsing ${itemName}`));
     },
-    renderCollectedList(items, { maxItems, userSpecifiedMaxItems, functionInfo } = {}) {
+    async renderCollectedList(items, { maxItems, userSpecifiedMaxItems, functionInfo } = {}) {
       if (!Array.isArray(items)) {
         formatJsonOutput(items);
         return;
@@ -1936,7 +1940,7 @@ function createInteractiveRenderer() {
       console.log(chalk__default.default.green(`
 \u2705 Found ${items.length} ${itemName}:
 `));
-      renderItemsForDisplay(items, functionInfo);
+      await renderItemsForDisplay(items, functionInfo);
       if (userSpecifiedMaxItems && maxItems) {
         console.log(
           chalk__default.default.gray(
@@ -2399,11 +2403,11 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
     const startTime = Date.now();
     let success = true;
     let errorMessage = null;
-    let resolvedParams = {};
+    const resolvedParams = {};
     const commandObj = args[args.length - 1];
     const options = commandObj.opts();
     const interactiveMode = !options.json;
-    const renderer = interactiveMode ? createInteractiveRenderer() : createJsonRenderer();
+    const renderer = interactiveMode ? createInteractiveRenderer({ sdk, params: resolvedParams }) : createJsonRenderer();
     try {
       emitDeprecationWarning({
         cliCommandName,
@@ -2436,7 +2440,7 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
       }
       if (schema && !usesInputParameters) {
         const resolver = new SchemaParameterResolver();
-        resolvedParams = await resolver.resolveParameters(
+        const resolved = await resolver.resolveParameters(
           schema,
           rawParams,
           sdk,
@@ -2446,8 +2450,9 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
             debug: !!options.debug || process.env.DEBUG === "true" || process.argv.includes("--debug")
           }
         );
+        Object.assign(resolvedParams, resolved);
       } else {
-        resolvedParams = rawParams;
+        Object.assign(resolvedParams, rawParams);
       }
       const confirm = functionInfo.confirm;
       let confirmMessageAfter;
@@ -2476,7 +2481,7 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
             sdkResult,
             maxItems
           });
-          renderer.renderCollectedList(allItems, {
+          await renderer.renderCollectedList(allItems, {
             maxItems,
             userSpecifiedMaxItems: hasUserSpecifiedMaxItems,
             functionInfo
@@ -2510,7 +2515,7 @@ function createCommandConfig(cliCommandName, functionInfo, sdk) {
           if (normalizedResult.kind === "response") {
             await renderer.renderResponse(normalizedResult.value);
           } else if (normalizedResult.kind === "list") {
-            renderer.renderCollectedList(normalizedResult.data, {
+            await renderer.renderCollectedList(normalizedResult.data, {
               maxItems: resolvedParams.maxItems,
               userSpecifiedMaxItems: hasUserSpecifiedMaxItems,
               functionInfo
@@ -2566,7 +2571,7 @@ ${confirmMessageAfter}`));
     description,
     parameters,
     handler,
-    hidden: functionInfo.categories?.includes("deprecated") ?? false,
+    hidden: !!functionInfo.deprecation,
     aliases: functionInfo.aliases,
     supportsJsonOutput: functionInfo.supportsJsonOutput
   };
@@ -2725,7 +2730,7 @@ var login_exports = {};
 __export(login_exports, {
   AUTH_MODE_HEADER: () => AUTH_MODE_HEADER,
   DEFAULT_AUTH_BASE_URL: () => DEFAULT_AUTH_BASE_URL,
-  ZapierAuthenticationError: () => ZapierAuthenticationError,
+  ZapierAuthenticationError: () => zapierSdk.ZapierAuthenticationError,
   clearTokensFromKeychain: () => clearTokensFromKeychain,
   createCache: () => createCache,
   getActiveCredentials: () => getActiveCredentials,
@@ -3129,12 +3134,6 @@ async function deleteStoredClientCredentials({
 }
 
 // src/login/index.ts
-var ZapierAuthenticationError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "ZapierAuthenticationError";
-  }
-};
 var DEFAULT_AUTH_CLIENT_ID = "grwWZD5hUWGvb4V8ODBuOtXer3h0DBEZ2HR8aay6";
 var TOKEN_REFRESH_BUFFER_MS = 5 * 60 * 1e3;
 function createDebugLog(enabled) {
@@ -3144,9 +3143,9 @@ function createDebugLog(enabled) {
   }
   return (message, data) => {
     if (data === void 0) {
-      console.log(`[Zapier SDK CLI Login] ${message}`);
+      console.error(`[Zapier SDK CLI Login] ${message}`);
     } else {
-      console.log(`[Zapier SDK CLI Login] ${message}`, data);
+      console.error(`[Zapier SDK CLI Login] ${message}`, data);
     }
   };
 }
@@ -3392,7 +3391,7 @@ async function getToken(options = {}) {
     return await resolveOrRefreshToken(options);
   } catch (error) {
     const message = error instanceof Error ? error.message : "Token refresh failed";
-    throw new ZapierAuthenticationError(
+    throw new zapierSdk.ZapierAuthenticationError(
       `${message}
 Please run 'login' to authenticate again.`
     );
@@ -3566,20 +3565,20 @@ var spinPromise = async (promise, text) => {
 };
 var log = {
   info: (message, ...args) => {
-    console.log(chalk__default.default.blue("\u2139"), message, ...args);
+    console.error(chalk__default.default.blue("\u2139"), message, ...args);
   },
   error: (message, ...args) => {
     console.error(chalk__default.default.red("\u2716"), message, ...args);
   },
   success: (message, ...args) => {
-    console.log(chalk__default.default.green("\u2713"), message, ...args);
+    console.error(chalk__default.default.green("\u2713"), message, ...args);
   },
   warn: (message, ...args) => {
-    console.log(chalk__default.default.yellow("\u26A0"), message, ...args);
+    console.error(chalk__default.default.yellow("\u26A0"), message, ...args);
   },
   debug: (message, ...args) => {
     if (process.env.DEBUG === "true" || process.argv.includes("--debug")) {
-      console.log(chalk__default.default.gray("\u{1F41B}"), message, ...args);
+      console.error(chalk__default.default.gray("\u{1F41B}"), message, ...args);
     }
   }
 };
@@ -4168,7 +4167,8 @@ var BundleCodeSchema = zod.z.object({
 var bundleCodePlugin = zapierSdk.definePlugin(
   (sdk) => zapierSdk.createPluginMethod(sdk, {
     name: "bundleCode",
-    categories: ["utility", "deprecated"],
+    categories: ["utility"],
+    deprecation: { message: "bundleCode is no longer maintained." },
     inputSchema: BundleCodeSchema,
     handler: async ({ options }) => bundleCode(options)
   })
@@ -4264,7 +4264,7 @@ async function detectTypesOutputDirectory() {
   }
   return "./zapier/apps/";
 }
-var addPlugin = zapierSdk.definePlugin(
+var addAppsPlugin = zapierSdk.definePlugin(
   (sdk) => zapierSdk.createPluginMethod(sdk, {
     name: "add",
     categories: ["utility"],
@@ -5669,10 +5669,6 @@ var cliOverridesPlugin = zapierSdk.definePlugin(
     if (sdk.context.meta.fetch) {
       meta.fetch = {
         ...sdk.context.meta.fetch,
-        categories: [
-          ...sdk.context.meta.fetch.categories || [],
-          "deprecated"
-        ],
         deprecation: {
           message: "This command is deprecated and will be removed soon. Use `curl` instead. Learn more: https://docs.zapier.com/sdk/cli-reference#curl"
         }
@@ -6653,7 +6649,7 @@ var watchTriggerInboxCliPlugin = zapierSdk.definePlugin(
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.52.10"};
+  version: "0.52.12"};
 
 // src/sdk.ts
 zapierSdk.injectCliLogin(login_exports);
@@ -6662,21 +6658,21 @@ function createZapierCliSdk(options = {}) {
   const extensionsContextPlugin = () => ({
     context: { extensions }
   });
-  let chain = zapierSdk.createZapierSdk({
+  const sdk = zapierSdk.createZapierSdkStack({
     ...sdkOptions,
     eventEmission: { ...sdkOptions.eventEmission, callContext: "cli" },
     callerPackage: { name: package_default2.name, version: package_default2.version }
-  }).addPlugin(extensionsContextPlugin).addPlugin(generateAppTypesPlugin).addPlugin(buildManifestPlugin).addPlugin(bundleCodePlugin).addPlugin(getLoginConfigPathPlugin).addPlugin(addPlugin).addPlugin(feedbackPlugin).addPlugin(curlPlugin).addPlugin(initPlugin).addPlugin(mcpPlugin).addPlugin(loginPlugin).addPlugin(logoutPlugin).addPlugin(cliOverridesPlugin);
+  }).use(extensionsContextPlugin).use(generateAppTypesPlugin).use(buildManifestPlugin).use(bundleCodePlugin).use(getLoginConfigPathPlugin).use(addAppsPlugin).use(feedbackPlugin).use(curlPlugin).use(initPlugin).use(mcpPlugin).use(loginPlugin).use(logoutPlugin).use(cliOverridesPlugin, { override: true }).toSdk();
   for (const ext of extensions) {
     try {
-      chain = chain.addPlugin(ext);
+      zapierSdk.addPlugin(sdk, ext);
     } catch (err) {
       console.warn(
         `Extension plugin failed to construct: ${err.message}; skipping.`
       );
     }
   }
-  return chain;
+  return sdk;
 }
 experimental.injectCliLogin(login_exports);
 function createZapierCliSdk2(options = {}) {
@@ -6687,21 +6683,21 @@ function createZapierCliSdk2(options = {}) {
   const experimentalContextPlugin = () => ({
     context: { experimental: true }
   });
-  let chain = experimental.createZapierSdk({
+  const sdk = experimental.createZapierSdkStack({
     ...sdkOptions,
     eventEmission: { ...sdkOptions.eventEmission, callContext: "cli" },
     callerPackage: { name: package_default2.name, version: package_default2.version }
-  }).addPlugin(extensionsContextPlugin).addPlugin(experimentalContextPlugin).addPlugin(generateAppTypesPlugin).addPlugin(buildManifestPlugin).addPlugin(bundleCodePlugin).addPlugin(getLoginConfigPathPlugin).addPlugin(addPlugin).addPlugin(feedbackPlugin).addPlugin(curlPlugin).addPlugin(initPlugin).addPlugin(drainTriggerInboxCliPlugin, { override: true }).addPlugin(watchTriggerInboxCliPlugin, { override: true }).addPlugin(mcpPlugin).addPlugin(loginPlugin).addPlugin(logoutPlugin).addPlugin(cliOverridesPlugin);
+  }).use(extensionsContextPlugin).use(experimentalContextPlugin).use(generateAppTypesPlugin).use(buildManifestPlugin).use(bundleCodePlugin).use(getLoginConfigPathPlugin).use(addAppsPlugin).use(feedbackPlugin).use(curlPlugin).use(initPlugin).use(drainTriggerInboxCliPlugin, { override: true }).use(watchTriggerInboxCliPlugin, { override: true }).use(mcpPlugin).use(loginPlugin).use(logoutPlugin).use(cliOverridesPlugin, { override: true }).toSdk();
   for (const ext of extensions) {
     try {
-      chain = chain.addPlugin(ext);
+      experimental.addPlugin(sdk, ext);
     } catch (err) {
       console.warn(
         `Extension plugin failed to construct: ${err.message}; skipping.`
       );
     }
   }
-  return chain;
+  return sdk;
 }
 
 // src/utils/extensions.ts
@@ -6835,7 +6831,9 @@ async function checkForUpdates({
         currentVersion
       );
     } catch (error) {
-      log_default.debug(`Failed to check deprecation for current version: ${error}`);
+      if (!(error instanceof packageJsonLib.VersionNotFoundError)) {
+        log_default.debug(`Failed to check deprecation for current version: ${error}`);
+      }
       currentPackageInfo = latestPackageInfo;
     }
     const isDeprecated = Boolean(currentPackageInfo.deprecated);