@zapier/zapier-sdk-cli 0.22.0 → 0.23.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @zapier/zapier-sdk-cli
 
+## 0.23.0
+
+### Minor Changes
+
+- 33e2a8f: Added methods/commands for creating/listing/deleting client credentials.
+
+### Patch Changes
+
+- Updated dependencies [33e2a8f]
+  - @zapier/zapier-sdk-cli-login@0.6.0
+  - @zapier/zapier-sdk-mcp@0.6.0
+  - @zapier/zapier-sdk@0.21.0
+
+## 0.22.1
+
+### Patch Changes
+
+- Updated dependencies [7bd3c5c]
+  - @zapier/zapier-sdk@0.20.1
+  - @zapier/zapier-sdk-mcp@0.5.1
+
 ## 0.22.0
 
 - Fix 0.21.0 saying to update to 0.21.0.

package/README.md

@@ -25,6 +25,10 @@
   - [`find-unique-authentication`](#find-unique-authentication)
   - [`get-authentication`](#get-authentication)
   - [`list-authentications`](#list-authentications)
+- [Client Credentials](#client-credentials)
+  - [`create-client-credentials`](#create-client-credentials)
+  - [`delete-client-credentials`](#delete-client-credentials)
+  - [`list-client-credentials`](#list-client-credentials)
 - [HTTP Requests](#http-requests)
   - [`request`](#request)
 - [Utilities](#utilities)
@@ -364,6 +368,59 @@ List available authentications with optional filtering
 npx zapier-sdk list-authentications [--app-key] [--authentication-ids] [--search] [--title] [--account-id] [--owner] [--is-expired] [--page-size] [--max-items] [--cursor]
 ```
 
+### Client Credentials
+
+#### `create-client-credentials`
+
+Create new client credentials for the authenticated user
+
+**Options:**
+
+| Option             | Type     | Required | Default        | Possible Values | Description                                    |
+| ------------------ | -------- | -------- | -------------- | --------------- | ---------------------------------------------- |
+| `<name>`           | `string` | ✅       | —              | —               | Human-readable name for the client credentials |
+| `--allowed_scopes` | `array`  | ❌       | `["external"]` | —               | Scopes to allow for these credentials          |
+
+**Usage:**
+
+```bash
+npx zapier-sdk create-client-credentials <name> [--allowed_scopes]
+```
+
+#### `delete-client-credentials`
+
+Delete client credentials by client ID
+
+**Options:**
+
+| Option        | Type     | Required | Default | Possible Values | Description                                       |
+| ------------- | -------- | -------- | ------- | --------------- | ------------------------------------------------- |
+| `<client-id>` | `string` | ✅       | —       | —               | The client ID of the client credentials to delete |
+
+**Usage:**
+
+```bash
+npx zapier-sdk delete-client-credentials <client-id>
+```
+
+#### `list-client-credentials`
+
+List client credentials for the authenticated user
+
+**Options:**
+
+| Option        | Type     | Required | Default | Possible Values | Description                                    |
+| ------------- | -------- | -------- | ------- | --------------- | ---------------------------------------------- |
+| `--page-size` | `number` | ❌       | —       | —               | Number of credentials per page                 |
+| `--max-items` | `number` | ❌       | —       | —               | Maximum total items to return across all pages |
+| `--cursor`    | `string` | ❌       | —       | —               | Cursor to start from                           |
+
+**Usage:**
+
+```bash
+npx zapier-sdk list-client-credentials [--page-size] [--max-items] [--cursor]
+```
+
 ### HTTP Requests
 
 #### `request`

package/dist/cli.cjs

@@ -876,6 +876,33 @@ function formatItemsGeneric(items, startingNumber = 0) {
     formatSingleItem(formatted, startingNumber + index);
   });
 }
+var CONFIRM_MESSAGES = {
+  "create-secret": {
+    messageBefore: "You are about to create a sensitive secret that will be displayed as plain text.\nOnce created, you cannot retrieve it again.",
+    messageAfter: "Please treat this secret like a password and store it securely!"
+  },
+  delete: {
+    messageBefore: "You are about to delete this record."
+  }
+};
+async function promptConfirm(confirmType) {
+  if (!confirmType || !CONFIRM_MESSAGES[confirmType]) {
+    return { confirmed: true };
+  }
+  const { messageBefore, messageAfter } = CONFIRM_MESSAGES[confirmType];
+  console.log(chalk3__default.default.yellow(`
+${messageBefore}
+`));
+  const { confirmed } = await inquirer__default.default.prompt([
+    {
+      type: "confirm",
+      name: "confirmed",
+      message: "Continue?",
+      default: false
+    }
+  ]);
+  return { confirmed, messageAfter };
+}
 function analyzeZodSchema(schema, functionInfo) {
   const parameters = [];
   const schemaDef = schema._zod?.def;
@@ -907,7 +934,8 @@ function analyzeZodField(name, schema, functionInfo) {
       baseSchema = baseSchema._zod.def.innerType;
     } else if (baseSchema instanceof zod.z.ZodDefault) {
       required = false;
-      defaultValue = baseSchema._zod.def.defaultValue();
+      const defValue = baseSchema._zod.def.defaultValue;
+      defaultValue = typeof defValue === "function" ? defValue() : defValue;
       baseSchema = baseSchema._zod.def.innerType;
     } else {
       const zodDef = baseSchema._zod?.def;
@@ -1057,6 +1085,16 @@ function createCommandConfig(cliCommandName, functionInfo, sdk2) {
         sdk2,
         functionInfo.name
       );
+      const confirm = functionInfo.confirm;
+      let confirmMessageAfter;
+      if (confirm && !shouldUseJson) {
+        const confirmResult = await promptConfirm(confirm);
+        if (!confirmResult.confirmed) {
+          console.log(chalk3__default.default.yellow("Operation cancelled."));
+          return;
+        }
+        confirmMessageAfter = confirmResult.messageAfter;
+      }
       if (isListCommand && hasPaginationParams && !shouldUseJson && !hasUserSpecifiedMaxItems) {
         const sdkObj = sdk2;
         const sdkIterator = sdkObj[functionInfo.name](resolvedParams);
@@ -1109,6 +1147,10 @@ function createCommandConfig(cliCommandName, functionInfo, sdk2) {
         } else {
           formatJsonOutput(items);
         }
+        if (confirmMessageAfter) {
+          console.log(chalk3__default.default.yellow(`
+${confirmMessageAfter}`));
+        }
       }
     } catch (error) {
       if (error instanceof Error && error.message.includes('"code"')) {
@@ -1656,7 +1698,7 @@ var LoginSchema = zod.z.object({
 
 // package.json
 var package_default = {
-  version: "0.22.0"};
+  version: "0.23.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -2937,7 +2979,7 @@ function createZapierCliSdk(options = {}) {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.22.0"};
+  version: "0.23.0"};
 function detectPackageManager(cwd = process.cwd()) {
   const ua = process.env.npm_config_user_agent;
   if (ua) {

package/dist/cli.mjs

@@ -840,6 +840,33 @@ function formatItemsGeneric(items, startingNumber = 0) {
     formatSingleItem(formatted, startingNumber + index);
   });
 }
+var CONFIRM_MESSAGES = {
+  "create-secret": {
+    messageBefore: "You are about to create a sensitive secret that will be displayed as plain text.\nOnce created, you cannot retrieve it again.",
+    messageAfter: "Please treat this secret like a password and store it securely!"
+  },
+  delete: {
+    messageBefore: "You are about to delete this record."
+  }
+};
+async function promptConfirm(confirmType) {
+  if (!confirmType || !CONFIRM_MESSAGES[confirmType]) {
+    return { confirmed: true };
+  }
+  const { messageBefore, messageAfter } = CONFIRM_MESSAGES[confirmType];
+  console.log(chalk3.yellow(`
+${messageBefore}
+`));
+  const { confirmed } = await inquirer.prompt([
+    {
+      type: "confirm",
+      name: "confirmed",
+      message: "Continue?",
+      default: false
+    }
+  ]);
+  return { confirmed, messageAfter };
+}
 function analyzeZodSchema(schema, functionInfo) {
   const parameters = [];
   const schemaDef = schema._zod?.def;
@@ -871,7 +898,8 @@ function analyzeZodField(name, schema, functionInfo) {
       baseSchema = baseSchema._zod.def.innerType;
     } else if (baseSchema instanceof z.ZodDefault) {
       required = false;
-      defaultValue = baseSchema._zod.def.defaultValue();
+      const defValue = baseSchema._zod.def.defaultValue;
+      defaultValue = typeof defValue === "function" ? defValue() : defValue;
       baseSchema = baseSchema._zod.def.innerType;
     } else {
       const zodDef = baseSchema._zod?.def;
@@ -1021,6 +1049,16 @@ function createCommandConfig(cliCommandName, functionInfo, sdk2) {
         sdk2,
         functionInfo.name
       );
+      const confirm = functionInfo.confirm;
+      let confirmMessageAfter;
+      if (confirm && !shouldUseJson) {
+        const confirmResult = await promptConfirm(confirm);
+        if (!confirmResult.confirmed) {
+          console.log(chalk3.yellow("Operation cancelled."));
+          return;
+        }
+        confirmMessageAfter = confirmResult.messageAfter;
+      }
       if (isListCommand && hasPaginationParams && !shouldUseJson && !hasUserSpecifiedMaxItems) {
         const sdkObj = sdk2;
         const sdkIterator = sdkObj[functionInfo.name](resolvedParams);
@@ -1073,6 +1111,10 @@ function createCommandConfig(cliCommandName, functionInfo, sdk2) {
         } else {
           formatJsonOutput(items);
         }
+        if (confirmMessageAfter) {
+          console.log(chalk3.yellow(`
+${confirmMessageAfter}`));
+        }
       }
     } catch (error) {
       if (error instanceof Error && error.message.includes('"code"')) {
@@ -1620,7 +1662,7 @@ var LoginSchema = z.object({
 
 // package.json
 var package_default = {
-  version: "0.22.0"};
+  version: "0.23.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {
@@ -2901,7 +2943,7 @@ function createZapierCliSdk(options = {}) {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@zapier/zapier-sdk-cli",
-  version: "0.22.0"};
+  version: "0.23.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.22.0"};
+  version: "0.23.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.22.0"};
+  version: "0.23.0"};
 
 // src/telemetry/builders.ts
 function createCliBaseEvent(context = {}) {

package/dist/package.json

@@ -0,0 +1,78 @@
+{
+    "name": "@zapier/zapier-sdk-cli",
+    "version": "0.23.0",
+    "description": "Command line interface for Zapier SDK",
+    "main": "dist/index.cjs",
+    "module": "dist/index.mjs",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "require": {
+                "types": "./dist/index.d.ts",
+                "default": "./dist/index.cjs"
+            },
+            "import": {
+                "types": "./dist/index.d.mts",
+                "default": "./dist/index.mjs"
+            }
+        }
+    },
+    "bin": {
+        "zapier-sdk": "./bin/zapier-sdk.mjs"
+    },
+    "scripts": {
+        "test": "vitest",
+        "build": "tsup",
+        "clean": "rm -rf dist",
+        "rebuild": "pnpm clean && pnpm build",
+        "dev": "tsx src/cli.ts",
+        "typecheck": "tsc --project tsconfig.build.json --noEmit",
+        "prepublishOnly": "node ../../scripts/check-version.js"
+    },
+    "keywords": [
+        "zapier",
+        "cli",
+        "sdk"
+    ],
+    "author": "",
+    "license": "SEE LICENSE IN LICENSE",
+    "files": [
+        "dist",
+        "bin",
+        "README.md",
+        "CHANGELOG.md"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "dependencies": {
+        "@zapier/zapier-sdk": "workspace:*",
+        "@zapier/zapier-sdk-cli-login": "workspace:*",
+        "@zapier/zapier-sdk-mcp": "workspace:*",
+        "chalk": "^5.3.0",
+        "cli-table3": "^0.6.5",
+        "commander": "^12.0.0",
+        "conf": "^14.0.0",
+        "esbuild": "^0.25.5",
+        "express": "^5.1.0",
+        "inquirer": "^12.6.3",
+        "is-installed-globally": "^1.0.0",
+        "jsonwebtoken": "^9.0.2",
+        "open": "^10.2.0",
+        "ora": "^8.2.0",
+        "package-json": "^10.0.1",
+        "pkce-challenge": "^5.0.0",
+        "semver": "^7.7.3",
+        "typescript": "^5.8.3",
+        "zod": "4.2.1"
+    },
+    "devDependencies": {
+        "@types/express": "^5.0.3",
+        "@types/inquirer": "^9.0.8",
+        "@types/jsonwebtoken": "^9.0.10",
+        "@types/node": "^24.0.1",
+        "@types/semver": "^7.7.1",
+        "tsup": "^8.5.0",
+        "vitest": "^3.2.3"
+    }
+}

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/cli.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+import { Command, CommanderError } from "commander";
+import { generateCliCommands } from "./utils/cli-generator";
+import { createZapierCliSdk } from "./sdk";
+import packageJson from "../package.json" with { type: "json" };
+import { ZapierCliError } from "./utils/errors";
+import { checkAndNotifyUpdates } from "./utils/version-checker";
+const program = new Command();
+program
+    .name("zapier-sdk")
+    .description("CLI for Zapier SDK")
+    .version(packageJson.version, "-v, --version", "display version number")
+    .option("--debug", "Enable debug logging")
+    .option("--base-url <url>", "Base URL for Zapier API endpoints")
+    .option("--credentials <token>", "Authentication token")
+    .option("--credentials-client-id <id>", "OAuth client ID for authentication")
+    .option("--credentials-client-secret <secret>", "OAuth client secret for authentication")
+    .option("--credentials-base-url <url>", "Base URL for authentication endpoints")
+    .option("--tracking-base-url <url>", "Base URL for Zapier tracking endpoints");
+// Check for debug flag early (support both flag and env var)
+const isDebugMode = process.env.DEBUG === "true" || process.argv.includes("--debug");
+// Helper to get flag value from argv
+function getFlagValue(flagName) {
+    const index = process.argv.indexOf(flagName);
+    return index !== -1 ? process.argv[index + 1] : undefined;
+}
+// Extract options from process.argv for early SDK creation
+// We need to create the SDK before parsing to generate commands from schemas
+const baseUrl = getFlagValue("--base-url");
+const credentialsToken = getFlagValue("--credentials");
+const credentialsClientId = getFlagValue("--credentials-client-id");
+const credentialsClientSecret = getFlagValue("--credentials-client-secret");
+const credentialsBaseUrl = getFlagValue("--credentials-base-url");
+const trackingBaseUrl = getFlagValue("--tracking-base-url");
+// Build credentials object from flags
+function buildCredentialsFromFlags() {
+    // If a direct token is provided, use it
+    if (credentialsToken) {
+        return credentialsToken;
+    }
+    // If client ID is provided, build a credentials object
+    if (credentialsClientId) {
+        if (credentialsClientSecret) {
+            // Client credentials flow
+            return {
+                type: "client_credentials",
+                clientId: credentialsClientId,
+                clientSecret: credentialsClientSecret,
+                baseUrl: credentialsBaseUrl,
+            };
+        }
+        else {
+            // PKCE flow (no secret)
+            return {
+                type: "pkce",
+                clientId: credentialsClientId,
+                baseUrl: credentialsBaseUrl,
+            };
+        }
+    }
+    // No credentials from flags - will fall back to env vars or stored login
+    return undefined;
+}
+const credentials = buildCredentialsFromFlags();
+// Create CLI SDK instance with all plugins and URL options
+const sdk = createZapierCliSdk({
+    debug: isDebugMode,
+    credentials,
+    baseUrl,
+    trackingBaseUrl,
+});
+// Auth commands now handled by plugins
+// Generate CLI commands from SDK schemas (including CLI plugins)
+generateCliCommands(program, sdk);
+// MCP command now handled by plugin
+// Override Commander's default exit behavior to handle our custom errors
+program.exitOverride();
+(async () => {
+    let exitCode = 0;
+    // Start version checking non-blocking
+    const versionCheckPromise = checkAndNotifyUpdates({
+        packageName: packageJson.name,
+        currentVersion: packageJson.version,
+    });
+    try {
+        await program.parseAsync();
+    }
+    catch (error) {
+        if (error instanceof ZapierCliError) {
+            exitCode = error.exitCode;
+        }
+        else if (error instanceof CommanderError) {
+            exitCode = error.exitCode;
+        }
+        else {
+            // For any other unexpected errors, exit with code 1
+            console.error("Unexpected error:", error);
+            exitCode = 1;
+        }
+    }
+    // Wait for version checking to complete
+    await versionCheckPromise;
+    // Use exitCode instead of exit() to allow stdout to flush when piped
+    process.exitCode = exitCode;
+})();

package/dist/src/generators/ast-generator.d.ts

@@ -0,0 +1,41 @@
+import type { GetSdkType, ListActionsPluginProvides, ListInputFieldsPluginProvides, ManifestPluginProvides, AppItem } from "@zapier/zapier-sdk";
+interface GenerateTypesOptions {
+    app: AppItem;
+    authenticationId?: string | number;
+}
+/**
+ * AST-based TypeScript type generator using the TypeScript Compiler API
+ */
+export declare class AstTypeGenerator {
+    private readonly factory;
+    private readonly printer;
+    /**
+     * Generate TypeScript types using AST for a specific app
+     */
+    generateTypes(options: GenerateTypesOptions & {
+        sdk: GetSdkType<ListActionsPluginProvides & ListInputFieldsPluginProvides & ManifestPluginProvides>;
+    }): Promise<string>;
+    private createSourceFile;
+    private createImportStatement;
+    private createTypeImportStatement;
+    private groupActionsByType;
+    private createInputInterface;
+    private createActionInterface;
+    private createAppProxyInterface;
+    private createFetchMethodProperty;
+    private createAppFactoryInterface;
+    private createAppWithFactoryType;
+    private createModuleAugmentation;
+    private mapFieldTypeToTypeNode;
+    private capitalize;
+    private sanitizeActionName;
+    private sanitizeFieldName;
+    private escapeComment;
+    private createPropertyName;
+    private isValidIdentifier;
+    private getPreferredProgrammaticKey;
+    private getPreferredAppName;
+    private sanitizeToIdentifier;
+    private getAllKeys;
+}
+export {};