@zapier/zapier-sdk 0.0.3 → 0.1.1

package/src/schemas/Auth.ts

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { withFormatter } from "../schema-utils";
+
+// ============================================================================
+// Auth Schemas
+// ============================================================================
+
+export const AuthItemSchema = withFormatter(
+  z.object({
+    id: z.number(),
+    title: z.string().optional(),
+    identifier: z.string().optional(),
+    account_id: z.string().optional(),
+    is_private: z.boolean().optional(),
+    shared_with_all: z.boolean().optional(),
+    marked_stale_at: z.string().optional(),
+  }),
+  {
+    format: (item) => {
+      const details = [];
+
+      if (item.identifier) {
+        details.push({
+          text: `Identifier: ${item.identifier}`,
+          style: "accent" as const,
+        });
+      }
+
+      details.push({
+        text: `Account: ${item.account_id || "unknown"} | Private: ${item.is_private || false} | Shared: ${item.shared_with_all || false}`,
+        style: "dim" as const,
+      });
+
+      if (item.marked_stale_at) {
+        details.push({
+          text: `⚠️  Marked stale: ${new Date(item.marked_stale_at).toLocaleDateString()}`,
+          style: "warning" as const,
+        });
+      }
+
+      return {
+        title: item.title || `Authentication ${item.id}`,
+        subtitle: `(ID: ${item.id})`,
+        details,
+      };
+    },
+  },
+);
+
+// ============================================================================
+// Type Exports
+// ============================================================================
+
+export type AuthItem = z.infer<typeof AuthItemSchema>;

package/src/schemas/Field.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { withFormatter } from "../schema-utils";
+
+// ============================================================================
+// Field Schemas
+// ============================================================================
+
+export const FieldItemSchema = withFormatter(
+  z.object({
+    key: z.string(),
+    name: z.string().optional(),
+    description: z.string().optional(),
+  }),
+  {
+    format: (item) => {
+      const details = [];
+      if (item.description) {
+        details.push({ text: item.description, style: "dim" as const });
+      }
+
+      return {
+        title: item.name || item.key,
+        subtitle: `(${item.key})`,
+        details,
+      };
+    },
+  },
+);
+
+// ============================================================================
+// Type Exports
+// ============================================================================
+
+export type FieldItem = z.infer<typeof FieldItemSchema>;

package/src/sdk.ts

@@ -1,26 +1,172 @@
-import { createActionsSdk, ActionsSdk } from "./actions-sdk";
-import { BaseSdkOptions } from "./types";
-
-export interface ZapierSdk extends ActionsSdk {
-  // Future SDK namespaces will be added here
-  // workflows: WorkflowsSdk
-  // interfaces: InterfacesSdk
-  // tables: TablesSdk
+import { createZapierApi } from "./api";
+import { BaseSdkOptions } from "./types/domain";
+// Import function implementations
+import { listApps } from "./functions/listApps";
+import { getApp } from "./functions/getApp";
+import { listActions } from "./functions/listActions";
+import { getAction } from "./functions/getAction";
+import { runAction } from "./functions/runAction";
+import { listAuthentications } from "./functions/listAuthentications";
+import { findFirstAuthentication } from "./functions/findFirstAuthentication";
+import { findUniqueAuthentication } from "./functions/findUniqueAuthentication";
+import { listFields } from "./functions/listFields";
+import { generateTypes } from "./functions/generateTypes";
+import { bundleCode } from "./functions/bundleCode";
+
+// Import function registry info objects (only for CLI registry)
+import { listAppsInfo } from "./functions/listApps/info";
+import { getAppInfo } from "./functions/getApp/info";
+import { listActionsInfo } from "./functions/listActions/info";
+import { getActionInfo } from "./functions/getAction/info";
+import { runActionInfo } from "./functions/runAction/info";
+import { listAuthenticationsInfo } from "./functions/listAuthentications/info";
+import { findFirstAuthenticationInfo } from "./functions/findFirstAuthentication/info";
+import { findUniqueAuthenticationInfo } from "./functions/findUniqueAuthentication/info";
+import { listFieldsInfo } from "./functions/listFields/info";
+import { generateTypesInfo } from "./functions/generateTypes/info";
+import { bundleCodeInfo } from "./functions/bundleCode/info";
+
+// Function registry as array - uses names from function info objects
+const functionRegistry = [
+  listAppsInfo,
+  getAppInfo,
+  listActionsInfo,
+  getActionInfo,
+  runActionInfo,
+  listAuthenticationsInfo,
+  findFirstAuthenticationInfo,
+  findUniqueAuthenticationInfo,
+  listFieldsInfo,
+  generateTypesInfo,
+  bundleCodeInfo,
+];
+
+// Import the properly typed SDK interface
+import type { ZapierSdk } from "./types/sdk";
+
+// Import plugin functions
+import { createAppsPlugin } from "./plugins/apps/index";
+
+// TODO: Add plugin registry back when needed for CLI compatibility
+
+// Base SDK functions interface (functions + registry, no plugins)
+interface BaseZapierSdkWithFunctions {
+  __registry: Array<{
+    name: string;
+    inputSchema: any;
+    implementation: Function;
+  }>;
+  listApps: ZapierSdk["listApps"];
+  getApp: ZapierSdk["getApp"];
+  listActions: ZapierSdk["listActions"];
+  getAction: ZapierSdk["getAction"];
+  runAction: ZapierSdk["runAction"];
+  listAuthentications: ZapierSdk["listAuthentications"];
+  findFirstAuthentication: ZapierSdk["findFirstAuthentication"];
+  findUniqueAuthentication: ZapierSdk["findUniqueAuthentication"];
+  listFields: ZapierSdk["listFields"];
+  generateTypes: ZapierSdk["generateTypes"];
+  bundleCode: ZapierSdk["bundleCode"];
 }
 
+// Full SDK interface with plugins applied
+export type { ZapierSdk } from "./types/sdk";
+
 export interface ZapierSdkOptions extends BaseSdkOptions {}
 
+function createBaseZapierSdk(
+  options: ZapierSdkOptions = {},
+): BaseZapierSdkWithFunctions {
+  // Auto-load .env files (searches up directory tree)
+  try {
+    const { findUpSync } = require("find-up");
+    const envPath = findUpSync(".env");
+    if (envPath) {
+      require("dotenv").config({ path: envPath, quiet: true });
+    }
+  } catch {
+    // Silently fail if dotenv/find-up not available or .env not found
+  }
+
+  const {
+    fetch: customFetch = globalThis.fetch,
+    baseUrl = "https://zapier.com",
+    token,
+    debug = false,
+  } = options;
+
+  // If no token provided, try to get it from environment variable
+  const finalToken = token || process.env.ZAPIER_TOKEN;
+
+  // Create the API client
+  const api = createZapierApi({
+    baseUrl,
+    token: finalToken,
+    debug,
+    fetch: customFetch,
+  });
+
+  // Build SDK directly - TypeScript will enforce correct implementation
+  const sdk: BaseZapierSdkWithFunctions = {
+    // Registry for CLI
+    __registry: functionRegistry,
+
+    // Function implementations with API config injection
+    listApps: (options = {}) =>
+      listApps({ ...options, api, token: finalToken }),
+    getApp: (options) => getApp({ ...options, api, token: finalToken }),
+    listActions: (options = {}) =>
+      listActions({ ...options, api, token: finalToken }),
+    getAction: (options) => getAction({ ...options, api, token: finalToken }),
+    runAction: (options) => runAction({ ...options, api, token: finalToken }),
+    listAuthentications: (options = {}) =>
+      listAuthentications({ ...options, api, token: finalToken }),
+    findFirstAuthentication: (options = {}) =>
+      findFirstAuthentication({ ...options, api, token: finalToken }),
+    findUniqueAuthentication: (options = {}) =>
+      findUniqueAuthentication({ ...options, api, token: finalToken }),
+    listFields: (options) => listFields({ ...options, api, token: finalToken }),
+    generateTypes: (options) =>
+      generateTypes({ ...options, api, token: finalToken }),
+    bundleCode: (options) => bundleCode(options), // No API config needed
+  };
+
+  return sdk;
+}
+
 export function createZapierSdk(options: ZapierSdkOptions = {}): ZapierSdk {
-  // Create individual SDKs
-  const actionsSdk = createActionsSdk(options);
-
-  // For now, we just return the actions SDK
-  // Later we'll combine multiple SDKs here
-  return {
-    ...actionsSdk,
-    // Future SDKs will be spread here:
-    // ...workflowsSdk,
-    // ...interfacesSdk,
-    // ...tablesSdk,
+  // Create base SDK
+  const baseSdk = createBaseZapierSdk(options);
+
+  // Extract options needed for plugins
+  const {
+    fetch: customFetch = globalThis.fetch,
+    baseUrl = "https://zapier.com",
+    token,
+    debug = false,
+  } = options;
+
+  const finalToken = token || process.env.ZAPIER_TOKEN;
+
+  // Create the API client for plugins
+  const api = createZapierApi({
+    baseUrl,
+    token: finalToken,
+    debug,
+    fetch: customFetch,
+  });
+
+  // Create plugins directly - TypeScript will enforce correct implementation
+  const appsPlugin = createAppsPlugin({
+    api,
+    token: finalToken,
+  });
+
+  // Compose final SDK - TypeScript will enforce we have all required properties
+  const fullSdk: ZapierSdk = {
+    ...baseSdk,
+    apps: appsPlugin,
   };
+
+  return fullSdk;
 }

package/src/types/domain.ts

@@ -0,0 +1,54 @@
+// Re-export API types from the API module
+export type {
+  Integration,
+  Action,
+  Trigger,
+  Field,
+  Choice,
+  ActionExecutionResult,
+  ActionField,
+  ActionFieldChoice,
+  NeedsRequest,
+  NeedsResponse,
+  Authentication,
+  AuthenticationsResponse,
+} from "../api/types";
+
+// SDK Configuration Types
+export interface ActionExecutionOptions {
+  inputs?: Record<string, any>;
+  authenticationId?: number;
+}
+
+export interface AuthObject {
+  id: number;
+}
+
+export interface BaseSdkOptions {
+  token?: string;
+  fetch?: typeof fetch;
+  baseUrl?: string;
+  debug?: boolean;
+}
+
+// Error Classes
+export class ZapierSdkError extends Error {
+  constructor(
+    message: string,
+    public code?: string,
+  ) {
+    super(message);
+    this.name = "ZapierSdkError";
+  }
+}
+
+export class AppNotFoundError extends ZapierSdkError {
+  appKey: string;
+
+  constructor(appKey: string) {
+    super(`App "${appKey}" not found`);
+    this.name = "AppNotFoundError";
+    this.code = "APP_NOT_FOUND";
+    this.appKey = appKey;
+  }
+}

package/src/types/properties.ts

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import { withPositional } from "../schema-utils";
+
+// Shared property definitions for common parameters across functions
+// These can be reused in function schemas without duplication
+
+export const AppKeyPropertySchema = withPositional(
+  z.string().min(1).describe("App slug (e.g., 'slack', 'github')"),
+);
+
+export const ActionTypePropertySchema = z
+  .enum(["read", "write", "search", "create", "update", "delete"])
+  .describe("Action type that matches the action's defined type");
+
+export const ActionKeyPropertySchema = z
+  .string()
+  .min(1)
+  .describe("Action key to execute");
+
+export const AuthenticationIdPropertySchema = z
+  .number()
+  .int()
+  .describe("Authentication ID to use for this action");
+
+export const InputsPropertySchema = z
+  .record(z.any())
+  .describe("Input parameters for the action");
+
+export const LimitPropertySchema = z
+  .number()
+  .int()
+  .min(1)
+  .max(1000)
+  .default(50)
+  .describe("Maximum number of items to return");
+
+export const OffsetPropertySchema = z
+  .number()
+  .int()
+  .min(0)
+  .default(0)
+  .describe("Number of items to skip for pagination");
+
+export const OutputPropertySchema = z.string().describe("Output file path");
+
+export const DebugPropertySchema = z
+  .boolean()
+  .default(false)
+  .describe("Enable debug logging");
+
+export const ParamsPropertySchema = z
+  .record(z.any())
+  .describe("Additional parameters");
+
+// Inferred TypeScript types for the properties
+export type AppKeyProperty = z.infer<typeof AppKeyPropertySchema>;
+export type ActionTypeProperty = z.infer<typeof ActionTypePropertySchema>;
+export type ActionKeyProperty = z.infer<typeof ActionKeyPropertySchema>;
+export type AuthenticationIdProperty = z.infer<
+  typeof AuthenticationIdPropertySchema
+>;
+export type InputsProperty = z.infer<typeof InputsPropertySchema>;
+export type LimitProperty = z.infer<typeof LimitPropertySchema>;
+export type OffsetProperty = z.infer<typeof OffsetPropertySchema>;
+export type OutputProperty = z.infer<typeof OutputPropertySchema>;
+export type DebugProperty = z.infer<typeof DebugPropertySchema>;
+export type ParamsProperty = z.infer<typeof ParamsPropertySchema>;

package/src/types/sdk.ts

@@ -0,0 +1,46 @@
+// SDK interface composed from individual function interfaces
+import type { ListActionsSdkFunction } from "../functions/listActions/schemas";
+import type { GetActionSdkFunction } from "../functions/getAction/schemas";
+import type { GetAppSdkFunction } from "../functions/getApp/schemas";
+import type { RunActionSdkFunction } from "../functions/runAction/schemas";
+import type { ListFieldsSdkFunction } from "../functions/listFields/schemas";
+import type { ListAuthenticationsSdkFunction } from "../functions/listAuthentications/schemas";
+import type { FindFirstAuthenticationSdkFunction } from "../functions/findFirstAuthentication/schemas";
+import type { FindUniqueAuthenticationSdkFunction } from "../functions/findUniqueAuthentication/schemas";
+import type { GenerateTypesSdkFunction } from "../functions/generateTypes/schemas";
+import type { ListAppsSdkFunction } from "../functions/listApps/schemas";
+import type { BundleCodeSdkFunction } from "../functions/bundleCode/schemas";
+
+// Plugin interfaces
+import type { AppsPluginSdkExtension } from "../plugins/apps/types";
+
+// Compose SDK functions from individual function interfaces
+export interface ZapierSdkFunctions
+  extends ListActionsSdkFunction,
+    GetActionSdkFunction,
+    GetAppSdkFunction,
+    RunActionSdkFunction,
+    ListFieldsSdkFunction,
+    ListAuthenticationsSdkFunction,
+    FindFirstAuthenticationSdkFunction,
+    FindUniqueAuthenticationSdkFunction,
+    GenerateTypesSdkFunction,
+    ListAppsSdkFunction,
+    BundleCodeSdkFunction {
+  // All functions now properly typed!
+}
+
+// Compose SDK plugins from individual plugin interfaces
+export interface ZapierSdkPlugins extends AppsPluginSdkExtension {
+  // All plugins now properly typed!
+}
+
+// Main SDK interface with functions and plugins
+export interface ZapierSdk extends ZapierSdkFunctions, ZapierSdkPlugins {
+  // Special property for CLI to access schemas
+  __registry: Array<{
+    name: string;
+    inputSchema: any;
+    implementation: Function;
+  }>;
+}

package/dist/actions-sdk.d.ts

@@ -1,47 +0,0 @@
-import { Integration, Action, ActionExecutionOptions, ActionExecutionResult, ActionField, Authentication, BaseSdkOptions } from "./types";
-import { AppsListOptions, AppsGetOptions, ActionsListOptions, ActionsGetOptions, ActionsRunOptions, AuthsListOptions, AuthsFindOptions, FieldsListOptions, GenerateOptions, BundleOptions } from "./schemas";
-export * from "./schemas";
-export * from "./output-schemas";
-export interface ActionsSdk {
-    apps: AppsService;
-    actions: ActionsService;
-    auths: AuthsService;
-    fields: FieldsService;
-    generate: GenerateFunction;
-    bundle: BundleFunction;
-}
-export interface AppsService {
-    list(options?: AppsListOptions): Promise<Integration[]>;
-    get(options: AppsGetOptions): Promise<Integration>;
-}
-interface ActionRunner {
-    (params: ActionsRunOptions): Promise<ActionExecutionResult>;
-}
-interface ActionProxy {
-    [app: string]: {
-        [type: string]: {
-            [action: string]: (options?: ActionExecutionOptions) => Promise<ActionExecutionResult>;
-        };
-    };
-}
-export interface GenerateFunction {
-    (options: GenerateOptions): Promise<string>;
-}
-export interface BundleFunction {
-    (options: BundleOptions): Promise<string>;
-}
-export interface ActionsService {
-    list(options?: ActionsListOptions): Promise<Action[]>;
-    get(options: ActionsGetOptions): Promise<Action>;
-    run: ActionRunner & ActionProxy;
-}
-export interface AuthsService {
-    list(options?: AuthsListOptions): Promise<Authentication[]>;
-    find(options: AuthsFindOptions): number;
-}
-export interface FieldsService {
-    list(options: FieldsListOptions): Promise<ActionField[]>;
-}
-export interface ActionsSdkOptions extends BaseSdkOptions {
-}
-export declare function createActionsSdk(options?: ActionsSdkOptions): ActionsSdk;