@zapier/zapier-sdk-cli 0.43.4 → 0.44.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @zapier/zapier-sdk-cli
 
+## 0.44.0
+
+### Minor Changes
+
+- c7cff63: Adds an extension mechanism that lets the CLI and MCP server load additional plugin packages at runtime. Set `ZAPIER_SDK_EXTENSIONS` to a comma-separated list of package specifiers, or pass them via the new `extensions` option — methods they contribute show up automatically as CLI commands and MCP tools, no per-project wiring required.
+
+  When a plugin tries to register a method, context field, or meta entry that's already registered by another plugin in the chain, `addPlugin` now logs a warning and skips the duplicate plugin's contribution rather than silently overwriting. This catches the common foot-gun of an extension accidentally shadowing a built-in SDK method. Intentional duplicates can be expressed via `composePlugins(...)`, and meta-only overrides (e.g. tagging a built-in method as deprecated) continue to work unchanged.
+
+### Patch Changes
+
+- Updated dependencies [c7cff63]
+  - @zapier/zapier-sdk-mcp@0.12.0
+  - @zapier/zapier-sdk@0.48.0
+
 ## 0.43.4
 
 ### Patch Changes

package/dist/cli.cjs

@@ -176,14 +176,14 @@ var SchemaParameterResolver = class {
       this.spinner = null;
     }
   }
-  async resolveParameters(schema, providedParams, sdk2, functionName, options) {
+  async resolveParameters(schema, providedParams, sdk, functionName, options) {
     return zapierSdk.runWithTelemetryContext(async () => {
       this.debug = options?.debug ?? false;
       const interactiveMode = (options?.interactiveMode ?? true) && !!process.stdin.isTTY;
       const parseResult = schema.safeParse(providedParams);
       const allParams = this.extractParametersFromSchema(schema);
       const resolvableParams = allParams.filter(
-        (param) => this.hasResolver(param.name, sdk2, functionName)
+        (param) => this.hasResolver(param.name, sdk, functionName)
       );
       const missingResolvable = resolvableParams.filter((param) => {
         const hasValue = this.getNestedValue(providedParams, param.path) !== void 0;
@@ -208,12 +208,12 @@ var SchemaParameterResolver = class {
       }
       const resolvedParams = { ...providedParams };
       const context = {
-        sdk: sdk2,
+        sdk,
         currentParams: providedParams,
         resolvedParams,
         functionName
       };
-      const localResolvers = this.getLocalResolvers(sdk2, functionName);
+      const localResolvers = this.getLocalResolvers(sdk, functionName);
       if (required.length > 0) {
         const requiredParamNames = required.map((p) => p.name);
         const requiredResolutionOrder = getLocalResolutionOrderForParams(
@@ -1047,9 +1047,9 @@ Optional fields${pathContext}:`));
     const errorObj = error;
     return errorObj?.name === "ExitPromptError" || errorObj?.message?.includes("User force closed") || errorObj?.isTTYError === true;
   }
-  hasResolver(paramName, sdk2, functionName) {
-    if (functionName && typeof sdk2.getRegistry === "function") {
-      const registry = sdk2.getRegistry({ package: "cli" });
+  hasResolver(paramName, sdk, functionName) {
+    if (functionName && typeof sdk.getRegistry === "function") {
+      const registry = sdk.getRegistry({ package: "cli" });
       const functionInfo = registry.functions.find(
         (f) => f.name === functionName
       );
@@ -1059,9 +1059,9 @@ Optional fields${pathContext}:`));
     }
     return false;
   }
-  getResolver(paramName, sdk2, functionName) {
-    if (functionName && typeof sdk2.getRegistry === "function") {
-      const registry = sdk2.getRegistry({ package: "cli" });
+  getResolver(paramName, sdk, functionName) {
+    if (functionName && typeof sdk.getRegistry === "function") {
+      const registry = sdk.getRegistry({ package: "cli" });
       const functionInfo = registry.functions.find(
         (f) => f.name === functionName
       );
@@ -1071,11 +1071,11 @@ Optional fields${pathContext}:`));
     }
     return null;
   }
-  getLocalResolvers(sdk2, functionName) {
-    if (!functionName || typeof sdk2.getRegistry !== "function") {
+  getLocalResolvers(sdk, functionName) {
+    if (!functionName || typeof sdk.getRegistry !== "function") {
       return {};
     }
-    const registry = sdk2.getRegistry();
+    const registry = sdk.getRegistry();
     const functionInfo = registry.functions.find(
       (f) => f.name === functionName
     );
@@ -1113,7 +1113,7 @@ var SHARED_COMMAND_CLI_OPTIONS = [
 
 // package.json
 var package_default = {
-  version: "0.43.4"};
+  version: "0.44.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -1831,19 +1831,19 @@ function reconstructPositionalArgs(inputParameters, flatParams) {
 function methodNameToCliCommand(methodName) {
   return toKebabCase(methodName);
 }
-function generateCliCommands(program2, sdk2) {
-  if (typeof sdk2.getRegistry !== "function") {
+function generateCliCommands(program2, sdk) {
+  if (typeof sdk.getRegistry !== "function") {
     console.error("SDK registry not available");
     return;
   }
-  const registry = sdk2.getRegistry({ package: "cli" });
+  const registry = sdk.getRegistry({ package: "cli" });
   registry.functions.forEach((fnInfo) => {
     if (!fnInfo.inputSchema && !fnInfo.inputParameters) {
       console.warn(`Schema not found for ${fnInfo.name}`);
       return;
     }
     const cliCommandName = methodNameToCliCommand(fnInfo.name);
-    const config2 = createCommandConfig(cliCommandName, fnInfo, sdk2);
+    const config2 = createCommandConfig(cliCommandName, fnInfo, sdk);
     addCommand(program2, cliCommandName, config2);
   });
   program2.configureHelp({
@@ -1907,7 +1907,7 @@ function generateCliCommands(program2, sdk2) {
     }
   });
 }
-function createCommandConfig(cliCommandName, functionInfo, sdk2) {
+function createCommandConfig(cliCommandName, functionInfo, sdk) {
   const usesInputParameters = !functionInfo.inputSchema && !!functionInfo.inputParameters;
   const schema = functionInfo.inputSchema;
   const parameters = usesInputParameters ? analyzeInputParameters(functionInfo.inputParameters, functionInfo) : analyzeZodSchema(schema, functionInfo);
@@ -1965,7 +1965,7 @@ function createCommandConfig(cliCommandName, functionInfo, sdk2) {
         resolvedParams = await resolver.resolveParameters(
           schema,
           rawParams,
-          sdk2,
+          sdk,
           functionInfo.name,
           {
             interactiveMode,
@@ -1988,7 +1988,7 @@ function createCommandConfig(cliCommandName, functionInfo, sdk2) {
         }
         confirmMessageAfter = confirmResult.messageAfter;
       }
-      const sdkMethod = sdk2[functionInfo.name];
+      const sdkMethod = sdk[functionInfo.name];
       switch (outputMode) {
         case "paginate": {
           const source = sdkMethod(resolvedParams);
@@ -2080,7 +2080,7 @@ ${confirmMessageAfter}`));
             selected_api: resolvedParams.app ?? null
           }
         });
-        sdk2.context.eventEmission.emit(
+        sdk.context.eventEmission.emit(
           CLI_COMMAND_EXECUTED_EVENT_SUBJECT,
           event
         );
@@ -3099,24 +3099,24 @@ function toPkceCredentials(credentials2) {
   return void 0;
 }
 var loginPlugin = zapierSdk.definePlugin(
-  (sdk2) => zapierSdk.createPluginMethod(sdk2, {
+  (sdk) => zapierSdk.createPluginMethod(sdk, {
     name: "login",
     categories: ["account"],
     inputSchema: LoginSchema,
     supportsJsonOutput: false,
-    handler: async ({ sdk: sdk3, options }) => {
+    handler: async ({ sdk: sdk2, options }) => {
       const timeoutSeconds = options.timeout ? parseInt(options.timeout, 10) : 300;
       if (isNaN(timeoutSeconds) || timeoutSeconds <= 0) {
         throw new Error("Timeout must be a positive number");
       }
-      const resolvedCredentials = await sdk3.context.resolveCredentials();
+      const resolvedCredentials = await sdk2.context.resolveCredentials();
       const pkceCredentials = toPkceCredentials(resolvedCredentials);
       await login_default({
         timeoutMs: timeoutSeconds * 1e3,
         credentials: pkceCredentials
       });
       const user = await getLoggedInUser();
-      sdk3.context.eventEmission.emit(
+      sdk2.context.eventEmission.emit(
         "platform.sdk.ApplicationLifecycleEvent",
         zapierSdk.buildApplicationLifecycleEvent(
           { lifecycle_event_type: "login_success" },
@@ -3131,7 +3131,7 @@ var LogoutSchema = zod.z.object({}).describe("Log out of your Zapier account");
 
 // src/plugins/logout/index.ts
 var logoutPlugin = zapierSdk.definePlugin(
-  (sdk2) => zapierSdk.createPluginMethod(sdk2, {
+  (sdk) => zapierSdk.createPluginMethod(sdk, {
     name: "logout",
     categories: ["account"],
     inputSchema: LogoutSchema,
@@ -3148,12 +3148,16 @@ var McpSchema = zod.z.object({
 
 // src/plugins/mcp/index.ts
 var mcpPlugin = zapierSdk.definePlugin(
-  (sdk2) => zapierSdk.createPluginMethod(sdk2, {
+  (sdk) => zapierSdk.createPluginMethod(sdk, {
     name: "mcp",
     categories: ["utility"],
     inputSchema: McpSchema,
-    handler: async ({ sdk: sdk3, options }) => {
-      await zapierSdkMcp.startMcpServer({ ...options, debug: sdk3.context.options?.debug });
+    handler: async ({ sdk: sdk2, options }) => {
+      await zapierSdkMcp.startMcpServer({
+        ...options,
+        debug: sdk2.context.options?.debug,
+        extensions: sdk2.context.extensions
+      });
     }
   })
 );
@@ -3168,7 +3172,7 @@ var BundleCodeSchema = zod.z.object({
   cjs: zod.z.boolean().optional().describe("Output CommonJS format instead of ESM")
 }).describe("Bundle TypeScript code into executable JavaScript");
 var bundleCodePlugin = zapierSdk.definePlugin(
-  (sdk2) => zapierSdk.createPluginMethod(sdk2, {
+  (sdk) => zapierSdk.createPluginMethod(sdk, {
     name: "bundleCode",
     categories: ["utility", "deprecated"],
     inputSchema: BundleCodeSchema,
@@ -3242,7 +3246,7 @@ async function bundleCode(options) {
 }
 var GetLoginConfigPathSchema = zod.z.object({}).describe("Show the path to the login configuration file");
 var getLoginConfigPathPlugin = zapierSdk.definePlugin(
-  (sdk2) => zapierSdk.createPluginMethod(sdk2, {
+  (sdk) => zapierSdk.createPluginMethod(sdk, {
     name: "getLoginConfigPath",
     categories: ["utility"],
     inputSchema: GetLoginConfigPathSchema,
@@ -3277,11 +3281,11 @@ async function detectTypesOutputDirectory() {
   return "./zapier/apps/";
 }
 var addPlugin = zapierSdk.definePlugin(
-  (sdk2) => zapierSdk.createPluginMethod(sdk2, {
+  (sdk) => zapierSdk.createPluginMethod(sdk, {
     name: "add",
     categories: ["utility"],
     inputSchema: AddSchema,
-    handler: async ({ sdk: sdk3, options }) => {
+    handler: async ({ sdk: sdk2, options }) => {
       const {
         apps: appKeys,
         connections: connectionIds,
@@ -3352,13 +3356,13 @@ var addPlugin = zapierSdk.definePlugin(
             break;
         }
       };
-      const manifestResult = await sdk3.buildManifest({
+      const manifestResult = await sdk2.buildManifest({
         apps: appKeys,
         skipWrite: false,
         configPath,
         onProgress: handleManifestProgress
       });
-      const typesResult = await sdk3.generateAppTypes({
+      const typesResult = await sdk2.generateAppTypes({
         apps: appKeys,
         connections: connectionIds,
         skipWrite: false,
@@ -3404,14 +3408,14 @@ var AstTypeGenerator = class {
    * Generate TypeScript types using AST for a specific app
    */
   async generateTypes(options) {
-    const { app, connectionId, sdk: sdk2 } = options;
-    const actionsResult = await sdk2.listActions({
+    const { app, connectionId, sdk } = options;
+    const actionsResult = await sdk.listActions({
       appKey: app.implementation_id
     });
     const actions = actionsResult.data;
     const actionsWithFields = [];
     const inputFieldsTasks = actions.map(
-      (action) => () => sdk2.listInputFields({
+      (action) => () => sdk.listInputFields({
         appKey: app.implementation_id,
         actionKey: action.key,
         actionType: action.action_type,
@@ -3982,13 +3986,13 @@ function createManifestEntry(app) {
   };
 }
 var generateAppTypesPlugin = zapierSdk.definePlugin(
-  (sdk2) => zapierSdk.createPluginMethod(sdk2, {
+  (sdk) => zapierSdk.createPluginMethod(sdk, {
     name: "generateAppTypes",
     categories: ["utility"],
     // Cast: schema validates JSON fields only; GenerateAppTypesOptions adds
     // the runtime-only `onProgress` callback (passthrough via createFunction).
     inputSchema: GenerateAppTypesSchema,
-    handler: async ({ sdk: sdk3, options }) => {
+    handler: async ({ sdk: sdk2, options }) => {
       const {
         apps: appKeys,
         connections: connectionIds,
@@ -3999,7 +4003,7 @@ var generateAppTypesPlugin = zapierSdk.definePlugin(
       const resolvedTypesOutput = path.resolve(typesOutputDirectory);
       const result = { typeDefinitions: {} };
       onProgress?.({ type: "apps_lookup_start", count: appKeys.length });
-      const appsIterable = sdk3.listApps({ apps: appKeys }).items();
+      const appsIterable = sdk2.listApps({ apps: appKeys }).items();
       const apps = [];
       for await (const app of appsIterable) {
         apps.push(app);
@@ -4015,7 +4019,7 @@ var generateAppTypesPlugin = zapierSdk.definePlugin(
           type: "connections_lookup_start",
           count: connectionIds.length
         });
-        const connectionsIterable = sdk3.listConnections({ connections: connectionIds }).items();
+        const connectionsIterable = sdk2.listConnections({ connections: connectionIds }).items();
         for await (const connection of connectionsIterable) {
           connections.push(connection);
         }
@@ -4076,7 +4080,7 @@ var generateAppTypesPlugin = zapierSdk.definePlugin(
           const typeDefinitionString = await generator.generateTypes({
             app,
             connectionId,
-            sdk: sdk3
+            sdk: sdk2
           });
           result.typeDefinitions[manifestKey] = typeDefinitionString;
           onProgress?.({
@@ -4124,7 +4128,7 @@ var BuildManifestSchema = zod.z.object({
 
 // src/plugins/buildManifest/index.ts
 var buildManifestPlugin = zapierSdk.definePlugin(
-  (sdk2) => zapierSdk.createPluginMethod(sdk2, {
+  (sdk) => zapierSdk.createPluginMethod(sdk, {
     name: "buildManifest",
     categories: ["utility"],
     // Cast: BuildManifestSchema validates JSON-serializable fields only.
@@ -4132,7 +4136,7 @@ var buildManifestPlugin = zapierSdk.definePlugin(
     // `createFunction`'s passthrough spread at runtime; this widens TInput
     // so the handler can read it.
     inputSchema: BuildManifestSchema,
-    handler: async ({ sdk: sdk3, options }) => {
+    handler: async ({ sdk: sdk2, options }) => {
       const {
         apps: appKeys,
         skipWrite = false,
@@ -4140,7 +4144,7 @@ var buildManifestPlugin = zapierSdk.definePlugin(
         onProgress
       } = options;
       onProgress?.({ type: "apps_lookup_start", count: appKeys.length });
-      const appsIterable = sdk3.listApps({ apps: appKeys }).items();
+      const appsIterable = sdk2.listApps({ apps: appKeys }).items();
       const apps = [];
       for await (const app of appsIterable) {
         apps.push(app);
@@ -4165,7 +4169,7 @@ var buildManifestPlugin = zapierSdk.definePlugin(
             manifestKey: manifestEntry.implementationName,
             version: manifestEntry.version || ""
           });
-          const { key: updatedManifestKey, manifest } = await sdk3.context.updateManifestEntry({
+          const { key: updatedManifestKey, manifest } = await sdk2.context.updateManifestEntry({
             appKey: app.key,
             entry: manifestEntry,
             configPath,
@@ -4231,12 +4235,12 @@ async function postWithRetry({
   return response;
 }
 var feedbackPlugin = zapierSdk.definePlugin(
-  (sdk2) => zapierSdk.createPluginMethod(sdk2, {
+  (sdk) => zapierSdk.createPluginMethod(sdk, {
     name: "feedback",
     categories: ["utility"],
     inputSchema: FeedbackSchema,
     resolvers: { feedback: feedbackResolver },
-    handler: async ({ sdk: sdk3, options }) => {
+    handler: async ({ sdk: sdk2, options }) => {
       const user = await getLoggedInUser();
       const body = JSON.stringify({
         email: user.email,
@@ -4247,7 +4251,7 @@ var feedbackPlugin = zapierSdk.definePlugin(
         body,
         attemptsLeft: MAX_RETRIES
       });
-      if (sdk3.context.options?.debug) {
+      if (sdk2.context.options?.debug) {
         const text = await response.text();
         console.error("[debug] Webhook response:", text);
       }
@@ -4430,7 +4434,7 @@ async function buildFormData(formArgs, formStringArgs) {
 }
 
 // src/plugins/curl/index.ts
-var curlPlugin = zapierSdk.definePlugin((sdk2) => {
+var curlPlugin = zapierSdk.definePlugin((sdk) => {
   async function curl(options) {
     const {
       url: rawUrl,
@@ -4563,7 +4567,7 @@ var curlPlugin = zapierSdk.definePlugin((sdk2) => {
       process.stderr.write(">\n");
     }
     const start = performance.now();
-    const response = await sdk2.fetch(effectiveUrl.toString(), {
+    const response = await sdk.fetch(effectiveUrl.toString(), {
       method,
       headers,
       body,
@@ -4675,13 +4679,13 @@ ${Array.from(
   };
 });
 var cliOverridesPlugin = zapierSdk.definePlugin(
-  (sdk2) => {
+  (sdk) => {
     const meta = {};
-    if (sdk2.context.meta.fetch) {
+    if (sdk.context.meta.fetch) {
       meta.fetch = {
-        ...sdk2.context.meta.fetch,
+        ...sdk.context.meta.fetch,
         categories: [
-          ...sdk2.context.meta.fetch.categories || [],
+          ...sdk.context.meta.fetch.categories || [],
           "deprecated"
         ],
         deprecation: {
@@ -5131,7 +5135,7 @@ function displaySummaryAndNextSteps({
 
 // src/plugins/init/index.ts
 var initPlugin = zapierSdk.definePlugin(
-  (sdk2) => zapierSdk.createPluginMethod(sdk2, {
+  (sdk) => zapierSdk.createPluginMethod(sdk, {
     name: "init",
     categories: ["utility"],
     inputSchema: InitSchema,
@@ -5188,16 +5192,78 @@ var initPlugin = zapierSdk.definePlugin(
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.43.4"};
+  version: "0.44.0"};
 
 // src/sdk.ts
 zapierSdk.injectCliLogin(login_exports);
 function createZapierCliSdk(options = {}) {
-  return zapierSdk.createZapierSdk({
-    ...options,
-    eventEmission: { ...options.eventEmission, callContext: "cli" },
+  const { extensions = [], ...sdkOptions } = options;
+  const extensionsContextPlugin = () => ({
+    context: { extensions }
+  });
+  let chain = zapierSdk.createZapierSdk({
+    ...sdkOptions,
+    eventEmission: { ...sdkOptions.eventEmission, callContext: "cli" },
     callerPackage: { name: package_default2.name, version: package_default2.version }
-  }).addPlugin(generateAppTypesPlugin).addPlugin(buildManifestPlugin).addPlugin(bundleCodePlugin).addPlugin(getLoginConfigPathPlugin).addPlugin(addPlugin).addPlugin(feedbackPlugin).addPlugin(curlPlugin).addPlugin(initPlugin).addPlugin(mcpPlugin).addPlugin(loginPlugin).addPlugin(logoutPlugin).addPlugin(cliOverridesPlugin);
+  }).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);
+  for (const ext of extensions) {
+    try {
+      chain = chain.addPlugin(ext);
+    } catch (err) {
+      console.warn(
+        `Extension plugin failed to construct: ${err.message}; skipping.`
+      );
+    }
+  }
+  return chain;
+}
+
+// src/utils/extensions.ts
+var ENV_VAR = "ZAPIER_SDK_EXTENSIONS";
+async function resolveExtensions() {
+  const seen = /* @__PURE__ */ new Set();
+  const specs = readEnvSpecs().filter((spec) => {
+    if (seen.has(spec)) return false;
+    seen.add(spec);
+    return true;
+  });
+  const plugins = [];
+  for (const spec of specs) {
+    try {
+      const mod = await import(spec);
+      const exported = mod.default ?? mod;
+      const got = normalizeExtension(exported);
+      if (got) {
+        plugins.push(...got);
+      } else {
+        console.warn(
+          `Extension '${spec}': unrecognized default export shape; skipping.`
+        );
+      }
+    } catch (err) {
+      console.warn(
+        `Extension '${spec}' failed to load: ${err.message}`
+      );
+    }
+  }
+  return plugins;
+}
+function normalizeExtension(exported) {
+  if (typeof exported === "function") {
+    return [exported];
+  }
+  if (Array.isArray(exported)) {
+    if (exported.every((e) => typeof e === "function")) {
+      return exported;
+    }
+    return null;
+  }
+  return null;
+}
+function readEnvSpecs() {
+  const raw = process.env[ENV_VAR];
+  if (!raw) return [];
+  return raw.split(",").map((s) => s.trim()).filter((s) => s.length > 0);
 }
 var ONE_DAY_MS = 24 * 60 * 60 * 1e3;
 var CACHE_RESET_INTERVAL_MS = (() => {
@@ -5428,19 +5494,21 @@ for (const { camelName, kebabFlag } of booleanFlags) {
     flagOverrides[camelName] = true;
   }
 }
-var sdk = createZapierCliSdk({
-  debug: isDebugMode,
-  credentials,
-  baseUrl,
-  trackingBaseUrl,
-  maxNetworkRetries,
-  maxNetworkRetryDelayMs,
-  ...flagOverrides
-});
-generateCliCommands(program, sdk);
 program.exitOverride();
 (async () => {
   let exitCode = 0;
+  const extensions = await resolveExtensions();
+  const sdk = createZapierCliSdk({
+    debug: isDebugMode,
+    credentials,
+    baseUrl,
+    trackingBaseUrl,
+    maxNetworkRetries,
+    maxNetworkRetryDelayMs,
+    ...flagOverrides,
+    extensions
+  });
+  generateCliCommands(program, sdk);
   const versionCheckPromise = checkAndNotifyUpdates({
     packageName: package_default2.name,
     currentVersion: package_default2.version