@zapier/zapier-sdk-cli 0.0.3 → 0.1.0

package/dist/commands/bundle.js

@@ -1,101 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.bundleCommand = void 0;
-const commander_1 = require("commander");
-const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
-const esbuild_1 = require("esbuild");
-const fs_1 = require("fs");
-const path_1 = require("path");
-exports.bundleCommand = new commander_1.Command('bundle')
-    .description('Bundle TypeScript/JavaScript into a single file')
-    .argument('<input>', 'Input file path (e.g., packages/example/src/index.ts)')
-    .option('--output <path>', 'Output file path (default: bundle.js)')
-    .option('--string', 'Output as a quoted string for node -e')
-    .option('--minify', 'Minify the output')
-    .option('--cjs', 'Output as CommonJS (default: ESM)')
-    .option('--target <target>', 'JavaScript target (default: node18)', 'node18')
-    .action(bundleFile);
-async function bundleFile(inputPath, options) {
-    try {
-        console.log(chalk_1.default.blue('📦 JavaScript Bundler'));
-        console.log(chalk_1.default.gray(`Input: ${inputPath}\n`));
-        const spinner = (0, ora_1.default)('Bundling JavaScript...').start();
-        // Resolve input path from current working directory
-        const resolvedInput = (0, path_1.resolve)(process.cwd(), inputPath);
-        console.log(chalk_1.default.gray(`Resolved input: ${resolvedInput}`));
-        // Default output path
-        const outputPath = options.output || 'bundle.js';
-        try {
-            // Bundle with esbuild
-            const result = (0, esbuild_1.buildSync)({
-                entryPoints: [resolvedInput],
-                bundle: true,
-                platform: 'node',
-                target: options.target,
-                format: options.cjs ? 'cjs' : 'esm',
-                minify: options.minify,
-                write: false,
-                external: [], // Bundle everything
-                banner: {
-                    js: '#!/usr/bin/env node',
-                },
-            });
-            if (result.errors.length > 0) {
-                spinner.fail('Bundle failed');
-                result.errors.forEach(error => {
-                    console.error(chalk_1.default.red('Error:'), error.text);
-                });
-                return;
-            }
-            const bundledCode = result.outputFiles?.[0]?.text;
-            if (!bundledCode) {
-                spinner.fail('No output generated');
-                return;
-            }
-            spinner.succeed('Bundle created');
-            if (options.string) {
-                // Output as quoted string for node -e using JSON.stringify
-                const quotedString = JSON.stringify(bundledCode);
-                if (options.output) {
-                    // Write quoted string to file
-                    (0, fs_1.writeFileSync)(outputPath, quotedString, 'utf8');
-                    console.log(chalk_1.default.green(`✅ Quoted string saved to: ${outputPath}`));
-                }
-                else {
-                    // Output to console
-                    console.log(chalk_1.default.green('\n📋 Quoted string for node -e:\n'));
-                    console.log(quotedString);
-                }
-                console.log(chalk_1.default.gray('\nUsage:'));
-                console.log(chalk_1.default.blue(`node -e ${quotedString.substring(0, 50)}...`));
-            }
-            else {
-                // Write normal bundle
-                (0, fs_1.writeFileSync)(outputPath, bundledCode, 'utf8');
-                console.log(chalk_1.default.green(`✅ Bundle saved to: ${outputPath}`));
-                console.log(chalk_1.default.gray('\nUsage:'));
-                console.log(chalk_1.default.blue(`node ${outputPath}`));
-            }
-            // Show bundle info
-            const sizeKB = (bundledCode.length / 1024).toFixed(1);
-            console.log(chalk_1.default.gray(`\nBundle size: ${sizeKB} KB`));
-        }
-        catch (error) {
-            spinner.fail('Bundle failed');
-            if (error instanceof Error) {
-                console.error(chalk_1.default.red('Error:'), error.message);
-            }
-            else {
-                console.error(chalk_1.default.red('Unknown error:'), error);
-            }
-        }
-    }
-    catch (error) {
-        console.error(chalk_1.default.red('Unexpected error:'), error instanceof Error ? error.message : 'Unknown error');
-        process.exit(1);
-    }
-}

package/dist/commands/generate.d.ts

@@ -1,9 +0,0 @@
-import { Command } from 'commander';
-import { Action, ActionField } from '@zapier/actions-sdk';
-interface ActionWithActionFields extends Omit<Action, 'inputFields'> {
-    inputFields: ActionField[];
-}
-export declare const generateCommand: Command;
-export declare function generateTypeDefinitions(appKey: string, actions: ActionWithActionFields[], version?: string): string;
-export declare function capitalize(str: string): string;
-export {};

package/dist/commands/generate.js

@@ -1,281 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateCommand = void 0;
-exports.generateTypeDefinitions = generateTypeDefinitions;
-exports.capitalize = capitalize;
-const commander_1 = require("commander");
-const chalk_1 = __importDefault(require("chalk"));
-const ora_1 = __importDefault(require("ora"));
-const actions_sdk_1 = require("@zapier/actions-sdk");
-const fs_1 = require("fs");
-const path_1 = require("path");
-const auth_picker_1 = require("../utils/auth-picker");
-exports.generateCommand = new commander_1.Command('generate')
-    .description('Generate TypeScript types for Zapier app actions')
-    .argument('<app>', 'App identifier (e.g., slack, slack@1.2.3)')
-    .option('--token <token>', 'Authentication token (JWT or Bearer) - can also use ZAPIER_TOKEN env var')
-    .option('--auth <id>', 'Authentication ID', (value) => parseInt(value))
-    .option('--output <path>', 'Output file path (default: ./types/[app].d.ts)')
-    .option('--debug', 'Enable debug logging')
-    .action(generateTypes);
-async function generateTypes(appIdentifier, options) {
-    try {
-        console.log(chalk_1.default.blue('🎯 Zapier Type Generator'));
-        console.log(chalk_1.default.gray(`Generating types for: ${appIdentifier}\n`));
-        // Parse app identifier (support app@version format)
-        const { appKey, version } = parseAppIdentifier(appIdentifier);
-        // Get token from option or environment variable
-        const token = options.token || process.env.ZAPIER_TOKEN;
-        if (!token) {
-            console.error(chalk_1.default.red('Authentication token is required'));
-            console.log(chalk_1.default.gray('Use --token <jwt-or-bearer-token> or set ZAPIER_TOKEN environment variable'));
-            return;
-        }
-        // Create SDK instance
-        const sdk = (0, actions_sdk_1.createActionsSDK)({
-            auth: options.auth ? {
-                token: token,
-                authentications: {
-                    [appKey]: [{ id: options.auth }]
-                }
-            } : {
-                token: token,
-                authentications: {}
-            },
-            debug: options.debug
-        });
-        // Fetch all actions for the app
-        const spinner = (0, ora_1.default)('Fetching app actions...').start();
-        let actions;
-        try {
-            actions = await sdk.actions.list({ appKey });
-            spinner.succeed(`Found ${actions.length} actions for ${appKey}`);
-        }
-        catch (error) {
-            spinner.fail('Failed to fetch actions');
-            console.error(chalk_1.default.red('Error:'), error instanceof Error ? error.message : 'Unknown error');
-            return;
-        }
-        if (actions.length === 0) {
-            console.log(chalk_1.default.yellow('No actions found for this app'));
-            return;
-        }
-        // Fetch input fields for each action (with optional interactive auth selection)
-        const actionsWithFields = [];
-        let authId = options.auth;
-        // If no auth provided, offer to select one interactively
-        if (!authId) {
-            console.log(chalk_1.default.yellow('No authentication ID provided.'));
-            const authResult = await (0, auth_picker_1.pickAuthentication)({
-                sdk,
-                appKey,
-                message: `Select an authentication for ${appKey} type generation (or skip for generic types):`,
-                allowSkip: true,
-                skipMessage: 'Skip - Generate generic types without specific input fields'
-            });
-            if (!authResult.skipped) {
-                authId = authResult.authId;
-            }
-        }
-        if (authId) {
-            const fieldsSpinner = (0, ora_1.default)('Fetching action input fields...').start();
-            for (const action of actions) {
-                try {
-                    const fields = await sdk.fields.list({
-                        app: action.appKey,
-                        action: action.key,
-                        type: action.type,
-                        authId: authId
-                    });
-                    actionsWithFields.push({ ...action, inputFields: fields });
-                }
-                catch (error) {
-                    // If we can't get fields for an action, include it without fields
-                    console.warn(`Warning: Could not fetch fields for ${action.key}:`, error instanceof Error ? error.message : 'Unknown error');
-                    actionsWithFields.push({ ...action, inputFields: [] });
-                }
-            }
-            fieldsSpinner.succeed(`Fetched input fields for ${actionsWithFields.length} actions`);
-        }
-        else {
-            console.log(chalk_1.default.yellow('⚠️  Generating types without specific input field types (using generic Record<string, any>)'));
-            // Convert actions to have empty input fields (will generate generic types)
-            actions.forEach(action => {
-                actionsWithFields.push({ ...action, inputFields: [] });
-            });
-        }
-        // Generate TypeScript types
-        const typeSpinner = (0, ora_1.default)('Generating TypeScript types...').start();
-        const typeDefinitions = generateTypeDefinitions(appKey, actionsWithFields, version);
-        // Determine output path
-        const outputPath = options.output || `./types/${appKey}.d.ts`;
-        // Ensure output directory exists
-        (0, fs_1.mkdirSync)((0, path_1.dirname)(outputPath), { recursive: true });
-        // Write the types file
-        (0, fs_1.writeFileSync)(outputPath, typeDefinitions, 'utf8');
-        typeSpinner.succeed(`Types generated: ${outputPath}`);
-        console.log(chalk_1.default.green('\n✅ Type generation complete!'));
-        console.log(chalk_1.default.gray('\nTo use the generated types:'));
-        console.log(chalk_1.default.blue(`import type { ${capitalize(appKey)}Actions } from '${outputPath.replace('.d.ts', '')}'`));
-        console.log(chalk_1.default.blue(`const sdk: ZapierSDK & { actions: ${capitalize(appKey)}Actions } = createActionsSDK(...)`));
-    }
-    catch (error) {
-        console.error(chalk_1.default.red('Unexpected error:'), error instanceof Error ? error.message : 'Unknown error');
-        process.exit(1);
-    }
-}
-function parseAppIdentifier(identifier) {
-    const parts = identifier.split('@');
-    return {
-        appKey: parts[0],
-        version: parts[1]
-    };
-}
-function generateTypeDefinitions(appKey, actions, version) {
-    // Handle empty actions
-    if (actions.length === 0) {
-        return generateEmptyTypesFile(appKey, version);
-    }
-    // Group actions by type
-    const actionsByType = actions.reduce((acc, action) => {
-        if (!acc[action.type]) {
-            acc[action.type] = [];
-        }
-        acc[action.type].push(action);
-        return acc;
-    }, {});
-    const appName = capitalize(appKey);
-    const versionComment = version ? ` * Generated for ${appKey}@${version}` : ` * Generated for ${appKey}`;
-    let output = `/**
- * Auto-generated TypeScript types for Zapier ${appKey} actions
-${versionComment}
- * Generated on: ${new Date().toISOString()}
- * 
- * Usage:
- *   import type { ${appName}Actions } from './path/to/this/file'
- *   const sdk: ZapierSDK & { actions: ${appName}Actions } = createActionsSDK(...)
- */
-
-import type { ActionExecutionOptions, ActionExecutionResult } from '@zapier/shared-sdk'
-
-`;
-    // Generate input types for each action
-    actions.forEach((action) => {
-        if (action.inputFields.length > 0) {
-            const inputTypeName = `${appName}${capitalize(action.type)}${capitalize(sanitizeActionName(action.key))}Inputs`;
-            output += `interface ${inputTypeName} {\n`;
-            action.inputFields.forEach((field) => {
-                const isOptional = !field.required;
-                const fieldType = mapFieldTypeToTypeScript(field);
-                const description = field.helpText ? `  /** ${escapeComment(field.helpText)} */\n` : '';
-                output += `${description}  ${sanitizeFieldName(field.key)}${isOptional ? '?' : ''}: ${fieldType}\n`;
-            });
-            output += `}\n\n`;
-        }
-    });
-    // Generate action type interfaces for each action type
-    Object.entries(actionsByType).forEach(([actionType, typeActions]) => {
-        const typeName = `${appName}${capitalize(actionType)}Actions`;
-        output += `interface ${typeName} {\n`;
-        typeActions.forEach((action) => {
-            const actionName = sanitizeActionName(action.key);
-            const description = action.description ? `  /** ${escapeComment(action.description)} */\n` : '';
-            // Generate type-safe action method signature
-            if (action.inputFields.length > 0) {
-                const inputTypeName = `${appName}${capitalize(action.type)}${capitalize(sanitizeActionName(action.key))}Inputs`;
-                output += `${description}  ${actionName}: (options: { inputs: ${inputTypeName} } & Omit<ActionExecutionOptions, 'inputs'>) => Promise<ActionExecutionResult>\n`;
-            }
-            else {
-                // No specific input fields available - use generic Record<string, any> for inputs
-                output += `${description}  ${actionName}: (options?: { inputs?: Record<string, any> } & ActionExecutionOptions) => Promise<ActionExecutionResult>\n`;
-            }
-        });
-        output += `}\n\n`;
-    });
-    // Generate the main app actions interface
-    output += `export interface ${appName}Actions {\n`;
-    output += `  ${appKey}: {\n`;
-    Object.keys(actionsByType).forEach(actionType => {
-        const typeName = `${appName}${capitalize(actionType)}Actions`;
-        output += `    ${actionType}: ${typeName}\n`;
-    });
-    output += `  }\n`;
-    output += `}\n`;
-    return output;
-}
-function generateEmptyTypesFile(appKey, version) {
-    const appName = capitalize(appKey);
-    const versionComment = version ? ` * Generated for ${appKey}@${version}` : ` * Generated for ${appKey}`;
-    return `/**
- * Auto-generated TypeScript types for Zapier ${appKey} actions
-${versionComment}
- * Generated on: ${new Date().toISOString()}
- * 
- * No actions found for this app.
- */
-
-import type { ActionExecutionOptions, ActionExecutionResult } from '@zapier/shared-sdk'
-
-export interface ${appName}Actions {
-  ${appKey}: {
-    // No actions available
-  }
-}
-`;
-}
-function capitalize(str) {
-    return str.charAt(0).toUpperCase() + str.slice(1).replace(/[-_]/g, '');
-}
-function sanitizeActionName(actionKey) {
-    // Ensure the action name is a valid TypeScript identifier
-    return actionKey.replace(/[^a-zA-Z0-9_$]/g, '_');
-}
-function sanitizeFieldName(fieldKey) {
-    // Ensure the field name is a valid TypeScript identifier
-    return fieldKey.replace(/[^a-zA-Z0-9_$]/g, '_');
-}
-function escapeComment(comment) {
-    // Escape comment text to prevent breaking the JSDoc comment
-    return comment.replace(/\*\//g, '*\\/').replace(/\r?\n/g, ' ');
-}
-function mapFieldTypeToTypeScript(field) {
-    // Handle choices (enum-like fields)
-    if (field.choices && field.choices.length > 0) {
-        const choiceValues = field.choices
-            .filter(choice => choice.value !== undefined && choice.value !== null && choice.value !== '')
-            .map(choice => typeof choice.value === 'string' ? `"${choice.value}"` : choice.value);
-        if (choiceValues.length > 0) {
-            return choiceValues.join(' | ');
-        }
-        // If all choices were filtered out, fall through to default type handling
-    }
-    // Map Zapier field types to TypeScript types
-    switch (field.type?.toLowerCase()) {
-        case 'string':
-        case 'text':
-        case 'email':
-        case 'url':
-        case 'password':
-            return 'string';
-        case 'integer':
-        case 'number':
-            return 'number';
-        case 'boolean':
-            return 'boolean';
-        case 'datetime':
-        case 'date':
-            return 'string'; // ISO date strings
-        case 'file':
-            return 'string'; // File URL or content
-        case 'array':
-            return 'any[]';
-        case 'object':
-            return 'Record<string, any>';
-        default:
-            // Default to string for unknown types, with union for common cases
-            return 'string | number | boolean';
-    }
-}

package/dist/utils/auth-picker.d.ts

@@ -1,17 +0,0 @@
-import { ActionsSDK } from '@zapier/actions-sdk';
-export interface AuthPickerOptions {
-    sdk: ActionsSDK;
-    appKey?: string;
-    message?: string;
-    allowSkip?: boolean;
-    skipMessage?: string;
-}
-export interface AuthPickerResult {
-    authId: number | null;
-    skipped: boolean;
-}
-/**
- * Interactive authentication picker that shows available auths
- * and lets the user select one or skip (if allowed)
- */
-export declare function pickAuthentication(options: AuthPickerOptions): Promise<AuthPickerResult>;

package/dist/utils/auth-picker.js

@@ -1,121 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.pickAuthentication = pickAuthentication;
-const inquirer_1 = __importDefault(require("inquirer"));
-const chalk_1 = __importDefault(require("chalk"));
-const actions_sdk_1 = require("@zapier/actions-sdk");
-/**
- * Interactive authentication picker that shows available auths
- * and lets the user select one or skip (if allowed)
- */
-async function pickAuthentication(options) {
-    const { sdk, appKey, message = 'Select an authentication to use:', allowSkip = false, skipMessage = 'Skip (continue without authentication)' } = options;
-    try {
-        console.log(chalk_1.default.blue('🔐 Fetching available authentications...'));
-        // Since auths.list now requires appKey, we need one to proceed
-        if (!appKey) {
-            console.log(chalk_1.default.red('❌ App key is required to list authentications'));
-            return { authId: null, skipped: true };
-        }
-        // Fetch authentications for the specified app
-        let auths;
-        try {
-            auths = await sdk.auths.list({
-                appKey,
-                owner: 'me', // Only show user's own auths for selection
-                limit: 100 // Get a reasonable number of auths
-            });
-        }
-        catch (error) {
-            if (error instanceof actions_sdk_1.AppNotFoundError) {
-                console.error(chalk_1.default.red(`❌ ${error.message}`));
-                console.log(chalk_1.default.gray('Use "zapier browse apps" to see available apps'));
-                if (allowSkip) {
-                    return { authId: null, skipped: true };
-                }
-                else {
-                    process.exit(1);
-                }
-            }
-            throw error;
-        }
-        if (auths.length === 0) {
-            const appFilter = appKey ? ` for app "${appKey}"` : '';
-            console.log(chalk_1.default.yellow(`No authentications found${appFilter}.`));
-            console.log(chalk_1.default.gray('You may need to create an authentication in the Zapier web interface first.'));
-            if (allowSkip) {
-                return { authId: null, skipped: true };
-            }
-            else {
-                process.exit(1);
-            }
-        }
-        // Prepare choices for inquirer
-        const SKIP_VALUE = -1; // Sentinel value for skip option
-        const choices = auths.map(auth => ({
-            name: formatAuthChoice(auth),
-            value: auth.id,
-            short: `Auth ${auth.id}`
-        }));
-        // Add skip option if allowed
-        if (allowSkip) {
-            choices.push({
-                name: chalk_1.default.gray(skipMessage),
-                value: SKIP_VALUE,
-                short: 'Skip'
-            });
-        }
-        // Show interactive selection
-        const { selectedAuthId } = await inquirer_1.default.prompt([{
-                type: 'list',
-                name: 'selectedAuthId',
-                message,
-                choices,
-                pageSize: Math.min(15, choices.length) // Limit visible choices
-            }]);
-        if (selectedAuthId === SKIP_VALUE) {
-            return { authId: null, skipped: true };
-        }
-        console.log(chalk_1.default.green(`✅ Selected authentication ID: ${selectedAuthId}`));
-        return { authId: selectedAuthId, skipped: false };
-    }
-    catch (error) {
-        console.error(chalk_1.default.red('❌ Error fetching authentications:'), error instanceof Error ? error.message : error);
-        if (allowSkip) {
-            console.log(chalk_1.default.yellow('Continuing without authentication...'));
-            return { authId: null, skipped: true };
-        }
-        else {
-            process.exit(1);
-        }
-    }
-}
-/**
- * Format an authentication for display in the picker
- */
-function formatAuthChoice(auth) {
-    const parts = [];
-    // Auth ID and API
-    parts.push(chalk_1.default.cyan(`ID: ${auth.id}`));
-    parts.push(chalk_1.default.gray(`(${auth.selected_api})`));
-    // Add label if available
-    if (auth.label) {
-        parts.push(chalk_1.default.blue(`- ${auth.label}`));
-    }
-    // Add identifier if available
-    if (auth.identifier) {
-        parts.push(chalk_1.default.magenta(`[${auth.identifier}]`));
-    }
-    // Add title if available
-    if (auth.title) {
-        parts.push(chalk_1.default.white(`"${auth.title}"`));
-    }
-    // Add warning if stale
-    if (auth.marked_stale_at) {
-        parts.push(chalk_1.default.red('⚠️  STALE'));
-    }
-    return parts.join(' ');
-}

package/dist/utils/schema-generator.d.ts

@@ -1,4 +0,0 @@
-import { Command } from 'commander';
-import { ActionsSDK } from '@zapier/actions-sdk';
-export declare function generateCLICommands(program: Command, sdk: ActionsSDK): void;
-export declare function enhanceCommandHelp(program: Command): void;