@zapier/zapier-sdk-cli 0.13.0 → 0.13.2

package/dist/index.cjs

@@ -466,21 +466,17 @@ var AstTypeGenerator = class {
    * Generate TypeScript types using AST for a specific app
    */
   async generateTypes(options) {
-    const { appKey, authenticationId, sdk } = options;
-    const { app, version } = this.parseAppIdentifier(appKey);
+    const { app, authenticationId, sdk } = options;
     const actionsResult = await sdk.listActions({
-      appKey: app
+      appKey: app.implementation_id
     });
     const actions = actionsResult.data;
-    if (actions.length === 0) {
-      return this.generateEmptyTypesFile(app, version);
-    }
     const actionsWithFields = [];
     if (authenticationId) {
       for (const action of actions) {
         try {
           const fieldsResult = await sdk.listInputFields({
-            appKey,
+            appKey: app.implementation_id,
             actionKey: action.key,
             actionType: action.action_type,
             authenticationId
@@ -506,7 +502,7 @@ var AstTypeGenerator = class {
             ...action,
             inputFields: [],
             name: action.title || action.key,
-            app_key: action.app_key || appKey,
+            app_key: action.app_key || app.implementation_id,
             action_type: action.action_type || "write",
             title: action.title || action.key,
             type: "action",
@@ -515,20 +511,15 @@ var AstTypeGenerator = class {
         }
       );
     }
-    const sourceFile = this.createSourceFile(app, actionsWithFields, version);
+    const sourceFile = this.createSourceFile(app, actionsWithFields);
     return this.printer.printFile(sourceFile);
   }
-  parseAppIdentifier(identifier) {
-    const parts = identifier.split("@");
-    return {
-      app: parts[0],
-      version: parts[1]
-    };
-  }
-  createSourceFile(appKey, actions, version) {
-    const appName = this.capitalize(appKey);
-    const versionComment = version ? ` * Generated for ${appKey}@${version}` : ` * Generated for ${appKey}`;
-    const headerComment = `Auto-generated TypeScript types for Zapier ${appKey} actions
+  createSourceFile(app, actions) {
+    const appName = this.getPreferredAppName(app);
+    const versionComment = ` * Generated for ${app.implementation_id}`;
+    const preferredKey = this.getPreferredProgrammaticKey(app);
+    const myVariableName = `my${appName}`;
+    const headerComment = `Auto-generated TypeScript types for Zapier ${app.key} actions
 ${versionComment.slice(3)}
 Generated on: ${(/* @__PURE__ */ new Date()).toISOString()}
 
@@ -540,11 +531,11 @@ Usage:
   
   const zapier = createZapierSdk();
   // Types are automatically available:
-  await zapier.apps.${appKey}.search.user_by_email({ authenticationId: 123, inputs: { email } })
+  await zapier.apps.${preferredKey}.search.user_by_email({ authenticationId: 123, inputs: { email } })
   
   // Factory usage (pinned auth):
-  const my${appName} = zapier.apps.${appKey}({ authenticationId: 123 })
-  await my${appName}.search.user_by_email({ inputs: { email } })`;
+  const ${myVariableName} = zapier.apps.${preferredKey}({ authenticationId: 123 })
+  await ${myVariableName}.search.user_by_email({ inputs: { email } })`;
     const statements = [
       // Import the SDK to activate module augmentation
       this.createImportStatement(["@zapier/zapier-sdk"]),
@@ -582,7 +573,8 @@ Usage:
     statements.push(appFactoryInterface);
     const appWithFactoryType = this.createAppWithFactoryType(appName);
     statements.push(appWithFactoryType);
-    const moduleAugmentation = this.createModuleAugmentation(appKey, appName);
+    const allKeys = this.getAllKeys(app);
+    const moduleAugmentation = this.createModuleAugmentation(allKeys, appName);
     statements.push(moduleAugmentation);
     statements.push(
       this.factory.createExportDeclaration(
@@ -908,7 +900,15 @@ Usage:
       ])
     );
   }
-  createModuleAugmentation(appKey, appName) {
+  createModuleAugmentation(appKeys, appName) {
+    const properties = appKeys.map(
+      (appKey) => this.factory.createPropertySignature(
+        void 0,
+        this.createPropertyName(appKey),
+        void 0,
+        this.factory.createTypeReferenceNode(`${appName}AppWithFactory`)
+      )
+    );
     return this.factory.createModuleDeclaration(
       [this.factory.createToken(ts__namespace.SyntaxKind.DeclareKeyword)],
       this.factory.createStringLiteral("@zapier/zapier-sdk"),
@@ -918,14 +918,7 @@ Usage:
           "ZapierSdkApps",
           void 0,
           void 0,
-          [
-            this.factory.createPropertySignature(
-              void 0,
-              appKey,
-              void 0,
-              this.factory.createTypeReferenceNode(`${appName}AppWithFactory`)
-            )
-          ]
+          properties
         )
       ])
     );
@@ -963,38 +956,6 @@ Usage:
         ]);
     }
   }
-  generateEmptyTypesFile(appKey, version) {
-    const appName = this.capitalize(appKey);
-    const versionComment = version ? ` * Generated for ${appKey}@${version}` : ` * Generated for ${appKey}`;
-    return `/* eslint-disable @typescript-eslint/naming-convention, @typescript-eslint/no-explicit-any */
-/**
- * Auto-generated TypeScript types for Zapier ${appKey} actions
-${versionComment}
- * Generated on: ${(/* @__PURE__ */ new Date()).toISOString()}
- * 
- * No actions found for this app.
- */
-
-import type { ActionExecutionOptions, ActionExecutionResult, ZapierFetchInitOptions } from '@zapier/zapier-sdk'
-
-interface ${appName}AppProxy {
-  /** Make authenticated HTTP requests through Zapier's Relay service */
-  fetch: (url: string | URL, init?: ZapierFetchInitOptions) => Promise<Response>
-}
-
-interface ${appName}AppFactory {
-  (options: { authenticationId: number }): ${appName}AppProxy
-}
-
-type ${appName}AppWithFactory = ${appName}AppFactory & ${appName}AppProxy
-
-declare module "@zapier/zapier-sdk" {
-  interface ZapierSdkApps {
-    ${appKey}: ${appName}AppWithFactory
-  }
-}
-`;
-  }
   capitalize(str) {
     return str.charAt(0).toUpperCase() + str.slice(1).replace(/[-_]/g, "");
   }
@@ -1015,6 +976,50 @@ declare module "@zapier/zapier-sdk" {
   escapeComment(comment) {
     return comment.replace(/\*\//g, "*\\/").replace(/\r?\n/g, " ");
   }
+  createPropertyName(name) {
+    if (this.isValidIdentifier(name)) {
+      return this.factory.createIdentifier(name);
+    } else {
+      return this.factory.createStringLiteral(name);
+    }
+  }
+  isValidIdentifier(name) {
+    return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name);
+  }
+  getPreferredProgrammaticKey(app) {
+    if (app.slug) {
+      const snakeCaseSlug = zapierSdk.toSnakeCase(app.slug);
+      if (this.isValidIdentifier(snakeCaseSlug)) {
+        return snakeCaseSlug;
+      }
+    }
+    if (this.isValidIdentifier(app.key)) {
+      return app.key;
+    }
+    return this.sanitizeToIdentifier(app.key);
+  }
+  getPreferredAppName(app) {
+    const preferredKey = this.getPreferredProgrammaticKey(app);
+    if (preferredKey.includes("_")) {
+      return preferredKey.split("_").map((word) => this.capitalize(word.toLowerCase())).join("");
+    }
+    return this.capitalize(preferredKey);
+  }
+  sanitizeToIdentifier(name) {
+    let sanitized = name.replace(/[^a-zA-Z0-9_$]/g, "_");
+    if (/^[0-9]/.test(sanitized)) {
+      sanitized = "_" + sanitized;
+    }
+    return sanitized;
+  }
+  getAllKeys(app) {
+    const allKeys = /* @__PURE__ */ new Set([app.key]);
+    if (app.slug) {
+      allKeys.add(app.slug);
+      allKeys.add(zapierSdk.toSnakeCase(app.slug));
+    }
+    return Array.from(allKeys);
+  }
 };
 async function detectTypesOutputDirectory() {
   const candidates = ["src", "lib"];
@@ -1099,7 +1104,7 @@ var addPlugin = ({ sdk, context }) => {
         try {
           const generator = new AstTypeGenerator();
           const typeDefinitions = await generator.generateTypes({
-            appKey: manifestKey,
+            app,
             authenticationId,
             sdk
           });

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { createFunction, OutputPropertySchema, DEFAULT_CONFIG_PATH, createZapierSdkWithoutRegistry, registryPlugin } from '@zapier/zapier-sdk';
+import { createFunction, OutputPropertySchema, DEFAULT_CONFIG_PATH, createZapierSdkWithoutRegistry, registryPlugin, toSnakeCase } from '@zapier/zapier-sdk';
 import open from 'open';
 import crypto from 'crypto';
 import express from 'express';
@@ -435,21 +435,17 @@ var AstTypeGenerator = class {
    * Generate TypeScript types using AST for a specific app
    */
   async generateTypes(options) {
-    const { appKey, authenticationId, sdk } = options;
-    const { app, version } = this.parseAppIdentifier(appKey);
+    const { app, authenticationId, sdk } = options;
     const actionsResult = await sdk.listActions({
-      appKey: app
+      appKey: app.implementation_id
     });
     const actions = actionsResult.data;
-    if (actions.length === 0) {
-      return this.generateEmptyTypesFile(app, version);
-    }
     const actionsWithFields = [];
     if (authenticationId) {
       for (const action of actions) {
         try {
           const fieldsResult = await sdk.listInputFields({
-            appKey,
+            appKey: app.implementation_id,
             actionKey: action.key,
             actionType: action.action_type,
             authenticationId
@@ -475,7 +471,7 @@ var AstTypeGenerator = class {
             ...action,
             inputFields: [],
             name: action.title || action.key,
-            app_key: action.app_key || appKey,
+            app_key: action.app_key || app.implementation_id,
             action_type: action.action_type || "write",
             title: action.title || action.key,
             type: "action",
@@ -484,20 +480,15 @@ var AstTypeGenerator = class {
         }
       );
     }
-    const sourceFile = this.createSourceFile(app, actionsWithFields, version);
+    const sourceFile = this.createSourceFile(app, actionsWithFields);
     return this.printer.printFile(sourceFile);
   }
-  parseAppIdentifier(identifier) {
-    const parts = identifier.split("@");
-    return {
-      app: parts[0],
-      version: parts[1]
-    };
-  }
-  createSourceFile(appKey, actions, version) {
-    const appName = this.capitalize(appKey);
-    const versionComment = version ? ` * Generated for ${appKey}@${version}` : ` * Generated for ${appKey}`;
-    const headerComment = `Auto-generated TypeScript types for Zapier ${appKey} actions
+  createSourceFile(app, actions) {
+    const appName = this.getPreferredAppName(app);
+    const versionComment = ` * Generated for ${app.implementation_id}`;
+    const preferredKey = this.getPreferredProgrammaticKey(app);
+    const myVariableName = `my${appName}`;
+    const headerComment = `Auto-generated TypeScript types for Zapier ${app.key} actions
 ${versionComment.slice(3)}
 Generated on: ${(/* @__PURE__ */ new Date()).toISOString()}
 
@@ -509,11 +500,11 @@ Usage:
   
   const zapier = createZapierSdk();
   // Types are automatically available:
-  await zapier.apps.${appKey}.search.user_by_email({ authenticationId: 123, inputs: { email } })
+  await zapier.apps.${preferredKey}.search.user_by_email({ authenticationId: 123, inputs: { email } })
   
   // Factory usage (pinned auth):
-  const my${appName} = zapier.apps.${appKey}({ authenticationId: 123 })
-  await my${appName}.search.user_by_email({ inputs: { email } })`;
+  const ${myVariableName} = zapier.apps.${preferredKey}({ authenticationId: 123 })
+  await ${myVariableName}.search.user_by_email({ inputs: { email } })`;
     const statements = [
       // Import the SDK to activate module augmentation
       this.createImportStatement(["@zapier/zapier-sdk"]),
@@ -551,7 +542,8 @@ Usage:
     statements.push(appFactoryInterface);
     const appWithFactoryType = this.createAppWithFactoryType(appName);
     statements.push(appWithFactoryType);
-    const moduleAugmentation = this.createModuleAugmentation(appKey, appName);
+    const allKeys = this.getAllKeys(app);
+    const moduleAugmentation = this.createModuleAugmentation(allKeys, appName);
     statements.push(moduleAugmentation);
     statements.push(
       this.factory.createExportDeclaration(
@@ -877,7 +869,15 @@ Usage:
       ])
     );
   }
-  createModuleAugmentation(appKey, appName) {
+  createModuleAugmentation(appKeys, appName) {
+    const properties = appKeys.map(
+      (appKey) => this.factory.createPropertySignature(
+        void 0,
+        this.createPropertyName(appKey),
+        void 0,
+        this.factory.createTypeReferenceNode(`${appName}AppWithFactory`)
+      )
+    );
     return this.factory.createModuleDeclaration(
       [this.factory.createToken(ts.SyntaxKind.DeclareKeyword)],
       this.factory.createStringLiteral("@zapier/zapier-sdk"),
@@ -887,14 +887,7 @@ Usage:
           "ZapierSdkApps",
           void 0,
           void 0,
-          [
-            this.factory.createPropertySignature(
-              void 0,
-              appKey,
-              void 0,
-              this.factory.createTypeReferenceNode(`${appName}AppWithFactory`)
-            )
-          ]
+          properties
         )
       ])
     );
@@ -932,38 +925,6 @@ Usage:
         ]);
     }
   }
-  generateEmptyTypesFile(appKey, version) {
-    const appName = this.capitalize(appKey);
-    const versionComment = version ? ` * Generated for ${appKey}@${version}` : ` * Generated for ${appKey}`;
-    return `/* eslint-disable @typescript-eslint/naming-convention, @typescript-eslint/no-explicit-any */
-/**
- * Auto-generated TypeScript types for Zapier ${appKey} actions
-${versionComment}
- * Generated on: ${(/* @__PURE__ */ new Date()).toISOString()}
- * 
- * No actions found for this app.
- */
-
-import type { ActionExecutionOptions, ActionExecutionResult, ZapierFetchInitOptions } from '@zapier/zapier-sdk'
-
-interface ${appName}AppProxy {
-  /** Make authenticated HTTP requests through Zapier's Relay service */
-  fetch: (url: string | URL, init?: ZapierFetchInitOptions) => Promise<Response>
-}
-
-interface ${appName}AppFactory {
-  (options: { authenticationId: number }): ${appName}AppProxy
-}
-
-type ${appName}AppWithFactory = ${appName}AppFactory & ${appName}AppProxy
-
-declare module "@zapier/zapier-sdk" {
-  interface ZapierSdkApps {
-    ${appKey}: ${appName}AppWithFactory
-  }
-}
-`;
-  }
   capitalize(str) {
     return str.charAt(0).toUpperCase() + str.slice(1).replace(/[-_]/g, "");
   }
@@ -984,6 +945,50 @@ declare module "@zapier/zapier-sdk" {
   escapeComment(comment) {
     return comment.replace(/\*\//g, "*\\/").replace(/\r?\n/g, " ");
   }
+  createPropertyName(name) {
+    if (this.isValidIdentifier(name)) {
+      return this.factory.createIdentifier(name);
+    } else {
+      return this.factory.createStringLiteral(name);
+    }
+  }
+  isValidIdentifier(name) {
+    return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(name);
+  }
+  getPreferredProgrammaticKey(app) {
+    if (app.slug) {
+      const snakeCaseSlug = toSnakeCase(app.slug);
+      if (this.isValidIdentifier(snakeCaseSlug)) {
+        return snakeCaseSlug;
+      }
+    }
+    if (this.isValidIdentifier(app.key)) {
+      return app.key;
+    }
+    return this.sanitizeToIdentifier(app.key);
+  }
+  getPreferredAppName(app) {
+    const preferredKey = this.getPreferredProgrammaticKey(app);
+    if (preferredKey.includes("_")) {
+      return preferredKey.split("_").map((word) => this.capitalize(word.toLowerCase())).join("");
+    }
+    return this.capitalize(preferredKey);
+  }
+  sanitizeToIdentifier(name) {
+    let sanitized = name.replace(/[^a-zA-Z0-9_$]/g, "_");
+    if (/^[0-9]/.test(sanitized)) {
+      sanitized = "_" + sanitized;
+    }
+    return sanitized;
+  }
+  getAllKeys(app) {
+    const allKeys = /* @__PURE__ */ new Set([app.key]);
+    if (app.slug) {
+      allKeys.add(app.slug);
+      allKeys.add(toSnakeCase(app.slug));
+    }
+    return Array.from(allKeys);
+  }
 };
 async function detectTypesOutputDirectory() {
   const candidates = ["src", "lib"];
@@ -1068,7 +1073,7 @@ var addPlugin = ({ sdk, context }) => {
         try {
           const generator = new AstTypeGenerator();
           const typeDefinitions = await generator.generateTypes({
-            appKey: manifestKey,
+            app,
             authenticationId,
             sdk
           });

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zapier/zapier-sdk-cli",
-    "version": "0.13.0",
+    "version": "0.13.2",
     "description": "Command line interface for Zapier SDK",
     "main": "dist/index.cjs",
     "module": "dist/index.mjs",

package/dist/src/plugins/add/ast-generator.d.ts

@@ -1,6 +1,6 @@
-import type { GetSdkType, ListActionsPluginProvides, ListInputFieldsPluginProvides, ManifestPluginProvides } from "@zapier/zapier-sdk";
+import type { GetSdkType, ListActionsPluginProvides, ListInputFieldsPluginProvides, ManifestPluginProvides, AppItem } from "@zapier/zapier-sdk";
 interface GenerateTypesOptions {
-    appKey: string;
+    app: AppItem;
     authenticationId?: number;
 }
 /**
@@ -15,7 +15,6 @@ export declare class AstTypeGenerator {
     generateTypes(options: GenerateTypesOptions & {
         sdk: GetSdkType<ListActionsPluginProvides & ListInputFieldsPluginProvides & ManifestPluginProvides>;
     }): Promise<string>;
-    private parseAppIdentifier;
     private createSourceFile;
     private createImportStatement;
     private createTypeImportStatement;
@@ -28,10 +27,15 @@ export declare class AstTypeGenerator {
     private createAppWithFactoryType;
     private createModuleAugmentation;
     private mapFieldTypeToTypeNode;
-    private generateEmptyTypesFile;
     private capitalize;
     private sanitizeActionName;
     private sanitizeFieldName;
     private escapeComment;
+    private createPropertyName;
+    private isValidIdentifier;
+    private getPreferredProgrammaticKey;
+    private getPreferredAppName;
+    private sanitizeToIdentifier;
+    private getAllKeys;
 }
 export {};