@zapier/zapier-sdk 0.0.2 → 0.0.3

package/src/api.ts

@@ -0,0 +1,361 @@
+/**
+ * Zapier API Client Module
+ *
+ * This module provides a centralized API layer for all HTTP interactions
+ * with Zapier's various APIs. It handles authentication, error handling,
+ * polling, and provides consistent patterns across all services.
+ */
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface ApiClientOptions {
+  baseUrl: string;
+  token?: string;
+  debug?: boolean;
+  fetch?: typeof globalThis.fetch;
+}
+
+export interface ApiClient {
+  get: (path: string, options?: RequestOptions) => Promise<any>;
+  post: (path: string, data?: any, options?: RequestOptions) => Promise<any>;
+  put: (path: string, data?: any, options?: RequestOptions) => Promise<any>;
+  delete: (path: string, options?: RequestOptions) => Promise<any>;
+  poll: (path: string, options?: PollOptions) => Promise<any>;
+}
+
+export interface RequestOptions {
+  headers?: Record<string, string>;
+  searchParams?: Record<string, string>;
+  authRequired?: boolean;
+  customErrorHandler?: (response: Response) => Error | undefined;
+}
+
+export interface PollOptions extends RequestOptions {
+  maxAttempts?: number;
+  initialDelay?: number;
+  maxDelay?: number;
+  successStatus?: number;
+  pendingStatus?: number;
+  resultExtractor?: (response: any) => any;
+}
+
+interface DebugLogger {
+  (message: string, data?: any): void;
+}
+
+// ============================================================================
+// Authentication Utilities
+// ============================================================================
+
+export function isJwt(token: string): boolean {
+  // JWT tokens have exactly 3 parts separated by dots
+  const parts = token.split(".");
+  if (parts.length !== 3) {
+    return false;
+  }
+
+  // Each part should be base64url encoded (no padding)
+  // Basic validation - each part should be non-empty and contain valid base64url characters
+  const base64UrlPattern = /^[A-Za-z0-9_-]+$/;
+  return parts.every((part) => part.length > 0 && base64UrlPattern.test(part));
+}
+
+export function getAuthorizationHeader(token: string): string {
+  // Check if token is a JWT (has 3 parts separated by dots)
+  if (isJwt(token)) {
+    return `JWT ${token}`;
+  }
+  // Default to Bearer for other token types
+  return `Bearer ${token}`;
+}
+
+// ============================================================================
+// Debug Logging
+// ============================================================================
+
+function createDebugLogger(enabled: boolean): DebugLogger {
+  if (!enabled) {
+    return () => {}; // No-op function when debug is disabled
+  }
+
+  return (message: string, data?: any) => {
+    console.log(`[Zapier SDK] ${message}`, data || "");
+  };
+}
+
+function createDebugFetch(options: {
+  originalFetch: typeof globalThis.fetch;
+  debugLog: DebugLogger;
+}) {
+  const { originalFetch, debugLog } = options;
+  return async (input: RequestInfo | URL, options?: RequestInit) => {
+    const startTime = Date.now();
+
+    // Convert input to URL string for logging
+    const url = typeof input === "string" ? input : input.toString();
+    const method = options?.method || "GET";
+
+    debugLog(`→ ${method} ${url}`, {
+      headers: options?.headers,
+      body: options?.body ? JSON.parse(options.body as string) : undefined,
+    });
+
+    try {
+      const response = await originalFetch(input, options);
+      const duration = Date.now() - startTime;
+
+      debugLog(`← ${response.status} ${response.statusText} (${duration}ms)`, {
+        url,
+        method,
+        status: response.status,
+      });
+
+      return response;
+    } catch (error) {
+      const duration = Date.now() - startTime;
+      debugLog(`✖ Request failed (${duration}ms)`, {
+        url,
+        method,
+        error: error instanceof Error ? error.message : error,
+      });
+      throw error;
+    }
+  };
+}
+
+// ============================================================================
+// Polling Utilities
+// ============================================================================
+
+export async function pollUntilComplete(options: {
+  fetch: typeof globalThis.fetch;
+  url: string;
+  headers?: Record<string, string>;
+  maxAttempts?: number;
+  initialDelay?: number;
+  maxDelay?: number;
+  successStatus?: number;
+  pendingStatus?: number;
+  resultExtractor?: (response: any) => any;
+}): Promise<any> {
+  const {
+    fetch,
+    url,
+    headers = {},
+    maxAttempts = 30,
+    initialDelay = 50,
+    maxDelay = 1000,
+    successStatus = 200,
+    pendingStatus = 202,
+    resultExtractor = (response) => response,
+  } = options;
+
+  let delay = initialDelay;
+
+  for (let attempt = 0; attempt < maxAttempts; attempt++) {
+    const response = await fetch(url, { headers });
+
+    if (response.status === successStatus) {
+      // Success - extract and return results
+      const result = await response.json();
+      return resultExtractor(result);
+    } else if (response.status === pendingStatus) {
+      // Still processing - wait and retry
+      if (attempt < maxAttempts - 1) {
+        await new Promise((resolve) => setTimeout(resolve, delay));
+        delay = Math.min(delay * 2, maxDelay); // Exponential backoff
+        continue;
+      }
+    } else {
+      // Error occurred
+      throw new Error(
+        `Request failed: GET ${url} - ${response.status} ${response.statusText}`,
+      );
+    }
+  }
+
+  throw new Error(`Operation timed out after ${maxAttempts} attempts`);
+}
+
+// ============================================================================
+// API Client Factory
+// ============================================================================
+
+export function createZapierApi(options: ApiClientOptions): ApiClient {
+  const {
+    baseUrl,
+    token,
+    debug = false,
+    fetch: originalFetch = globalThis.fetch,
+  } = options;
+
+  const debugLog = createDebugLogger(debug);
+  const fetch = createDebugFetch({ originalFetch, debugLog });
+
+  // Helper to build full URLs
+  function buildUrl(
+    path: string,
+    searchParams?: Record<string, string>,
+  ): string {
+    const url = new URL(path, baseUrl);
+    if (searchParams) {
+      Object.entries(searchParams).forEach(([key, value]) => {
+        url.searchParams.set(key, value);
+      });
+    }
+    return url.toString();
+  }
+
+  // Helper to build headers
+  function buildHeaders(options: RequestOptions = {}): Record<string, string> {
+    const headers: Record<string, string> = {
+      ...options.headers,
+    };
+
+    // Add auth header if token provided and not explicitly disabled
+    if (token && options.authRequired !== false) {
+      headers.Authorization = getAuthorizationHeader(token);
+    }
+
+    return headers;
+  }
+
+  // Helper to handle responses
+  async function handleResponse(
+    response: Response,
+    customErrorHandler?: (response: Response) => Error | undefined,
+  ): Promise<any> {
+    if (!response.ok) {
+      // Check for custom error handling first
+      if (customErrorHandler) {
+        const customError = customErrorHandler(response);
+        if (customError) {
+          throw customError;
+        }
+      }
+
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+
+    // Try to parse JSON, fall back to text if that fails
+    try {
+      return await response.json();
+    } catch {
+      return await response.text();
+    }
+  }
+
+  // Helper to perform HTTP requests with JSON handling
+  async function fetchJson(
+    method: string,
+    path: string,
+    data?: any,
+    options: RequestOptions = {},
+  ): Promise<any> {
+    const url = buildUrl(path, options.searchParams);
+    const headers = buildHeaders(options);
+
+    // Add Content-Type for JSON requests with body data
+    if (data && typeof data === "object") {
+      headers["Content-Type"] = "application/json";
+    }
+
+    const response = await fetch(url, {
+      method,
+      headers,
+      body: data ? JSON.stringify(data) : undefined,
+    });
+
+    return handleResponse(response, options.customErrorHandler);
+  }
+
+  return {
+    async get(path: string, options: RequestOptions = {}): Promise<any> {
+      return fetchJson("GET", path, undefined, options);
+    },
+
+    async post(
+      path: string,
+      data?: any,
+      options: RequestOptions = {},
+    ): Promise<any> {
+      return fetchJson("POST", path, data, options);
+    },
+
+    async put(
+      path: string,
+      data?: any,
+      options: RequestOptions = {},
+    ): Promise<any> {
+      return fetchJson("PUT", path, data, options);
+    },
+
+    async delete(path: string, options: RequestOptions = {}): Promise<any> {
+      return fetchJson("DELETE", path, undefined, options);
+    },
+
+    async poll(path: string, options: PollOptions = {}): Promise<any> {
+      const url = buildUrl(path, options.searchParams);
+      const headers = buildHeaders(options);
+
+      return pollUntilComplete({
+        fetch,
+        url,
+        headers,
+        maxAttempts: options.maxAttempts,
+        initialDelay: options.initialDelay,
+        maxDelay: options.maxDelay,
+        successStatus: options.successStatus,
+        pendingStatus: options.pendingStatus,
+        resultExtractor: options.resultExtractor,
+      });
+    },
+  };
+}
+
+// ============================================================================
+// Utility Functions
+// ============================================================================
+
+export function generateRequestId(): string {
+  return Math.random().toString(36).substring(2) + Date.now().toString(36);
+}
+
+// ============================================================================
+// Utility Functions for Standalone Functions
+// ============================================================================
+
+/**
+ * Utility function to get or create an API client for standalone functions
+ *
+ * @param config - Configuration that may include an existing API client
+ * @returns ApiClient instance
+ */
+export function getOrCreateApiClient(config: {
+  baseUrl?: string;
+  token?: string;
+  api?: ApiClient;
+  debug?: boolean;
+  fetch?: typeof globalThis.fetch;
+}): ApiClient {
+  const {
+    baseUrl = "https://zapier.com",
+    token = process.env.ZAPIER_TOKEN,
+    api: providedApi,
+    debug = false,
+    fetch: customFetch,
+  } = config;
+
+  // Use provided API client or create a new one
+  return (
+    providedApi ||
+    createZapierApi({
+      baseUrl,
+      token,
+      debug,
+      fetch: customFetch,
+    })
+  );
+}

package/src/functions/bundleCode.ts

@@ -0,0 +1,85 @@
+export interface BundleCodeOptions {
+  input: string;
+  output?: string;
+  target?: string;
+  cjs?: boolean;
+  minify?: boolean;
+  string?: boolean;
+}
+
+/**
+ * Bundle TypeScript code into executable JavaScript
+ *
+ * This function can be used standalone without instantiating a full SDK,
+ * which enables better tree-shaking in applications that only need this functionality.
+ *
+ * @param options - Bundling configuration options
+ * @returns Promise<string> - Bundled JavaScript code
+ */
+export async function bundleCode(options: BundleCodeOptions): Promise<string> {
+  const {
+    input,
+    output,
+    target = "es2020",
+    cjs = false,
+    minify = false,
+    string: returnString = false,
+  } = options;
+
+  // Dynamically import esbuild
+  const { buildSync } = await import("esbuild");
+  const fs = await import("fs");
+  const path = await import("path");
+
+  // Resolve input path
+  const resolvedInput = path.resolve(process.cwd(), input);
+
+  try {
+    // Bundle with esbuild
+    const result = buildSync({
+      entryPoints: [resolvedInput],
+      bundle: true,
+      platform: "node",
+      target: target,
+      format: cjs ? "cjs" : "esm",
+      minify: minify,
+      write: false,
+      external: [], // Bundle everything
+      banner: {
+        js: "#!/usr/bin/env node",
+      },
+    });
+
+    if (result.errors.length > 0) {
+      throw new Error(
+        `Bundle failed: ${result.errors.map((e) => e.text).join(", ")}`,
+      );
+    }
+
+    const bundledCode = result.outputFiles?.[0]?.text;
+    if (!bundledCode) {
+      throw new Error("No output generated");
+    }
+
+    let finalOutput = bundledCode;
+
+    if (returnString) {
+      // Output as quoted string for node -e using JSON.stringify
+      finalOutput = JSON.stringify(bundledCode);
+    }
+
+    // Write to file if output path specified
+    if (output) {
+      fs.mkdirSync(path.dirname(output), { recursive: true });
+      fs.writeFileSync(output, finalOutput, "utf8");
+    }
+
+    return finalOutput;
+  } catch (error) {
+    throw new Error(
+      `Bundle failed: ${
+        error instanceof Error ? error.message : "Unknown error"
+      }`,
+    );
+  }
+}