@zapier/zapier-sdk 0.0.3 → 0.1.0

package/dist/api/auth.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Authentication Utilities
+ *
+ * This module provides utilities for handling authentication tokens,
+ * including JWT detection and authorization header generation.
+ */
+export declare function isJwt(token: string): boolean;
+export declare function getAuthorizationHeader(token: string): string;

package/dist/api/auth.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Authentication Utilities
+ *
+ * This module provides utilities for handling authentication tokens,
+ * including JWT detection and authorization header generation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isJwt = isJwt;
+exports.getAuthorizationHeader = getAuthorizationHeader;
+function isJwt(token) {
+    // 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));
+}
+function getAuthorizationHeader(token) {
+    // 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}`;
+}

package/dist/api/client.d.ts

@@ -0,0 +1,8 @@
+/**
+ * API Client Implementation
+ *
+ * This module contains the core API client implementation, including
+ * HTTP method handlers, response processing, and client factory functions.
+ */
+import type { ApiClient, ApiClientOptions } from "./types";
+export declare function createZapierApi(options: ApiClientOptions): ApiClient;

package/dist/api/client.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * API Client Implementation
+ *
+ * This module contains the core API client implementation, including
+ * HTTP method handlers, response processing, and client factory functions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createZapierApi = createZapierApi;
+const auth_1 = require("./auth");
+const debug_1 = require("./debug");
+const polling_1 = require("./polling");
+function createZapierApi(options) {
+    const { baseUrl, token, debug = false, fetch: originalFetch = globalThis.fetch, } = options;
+    const debugLog = (0, debug_1.createDebugLogger)(debug);
+    const fetch = (0, debug_1.createDebugFetch)({ originalFetch, debugLog });
+    // Helper to build full URLs
+    function buildUrl(path, searchParams) {
+        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 = {}) {
+        const headers = {
+            ...options.headers,
+        };
+        // Add auth header if token provided and not explicitly disabled
+        if (token && options.authRequired !== false) {
+            headers.Authorization = (0, auth_1.getAuthorizationHeader)(token);
+        }
+        return headers;
+    }
+    // Helper to handle responses
+    async function handleResponse(response, customErrorHandler) {
+        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, path, data, options = {}) {
+        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, options = {}) {
+            return fetchJson("GET", path, undefined, options);
+        },
+        async post(path, data, options = {}) {
+            return fetchJson("POST", path, data, options);
+        },
+        async put(path, data, options = {}) {
+            return fetchJson("PUT", path, data, options);
+        },
+        async delete(path, options = {}) {
+            return fetchJson("DELETE", path, undefined, options);
+        },
+        async poll(path, options = {}) {
+            const url = buildUrl(path, options.searchParams);
+            const headers = buildHeaders(options);
+            return (0, polling_1.pollUntilComplete)({
+                fetch,
+                url,
+                headers,
+                maxAttempts: options.maxAttempts,
+                initialDelay: options.initialDelay,
+                maxDelay: options.maxDelay,
+                successStatus: options.successStatus,
+                pendingStatus: options.pendingStatus,
+                resultExtractor: options.resultExtractor,
+            });
+        },
+    };
+}

package/dist/api/debug.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Debug Logging Utilities
+ *
+ * This module provides debug logging capabilities for API requests and responses,
+ * including request timing and detailed logging of HTTP interactions.
+ */
+import type { DebugLogger } from "./types";
+export declare function createDebugLogger(enabled: boolean): DebugLogger;
+export declare function createDebugFetch(options: {
+    originalFetch: typeof globalThis.fetch;
+    debugLog: DebugLogger;
+}): (input: RequestInfo | URL, options?: RequestInit) => Promise<Response>;

package/dist/api/debug.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Debug Logging Utilities
+ *
+ * This module provides debug logging capabilities for API requests and responses,
+ * including request timing and detailed logging of HTTP interactions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDebugLogger = createDebugLogger;
+exports.createDebugFetch = createDebugFetch;
+function createDebugLogger(enabled) {
+    if (!enabled) {
+        return () => { }; // No-op function when debug is disabled
+    }
+    return (message, data) => {
+        console.log(`[Zapier SDK] ${message}`, data || "");
+    };
+}
+function createDebugFetch(options) {
+    const { originalFetch, debugLog } = options;
+    return async (input, options) => {
+        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) : 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;
+        }
+    };
+}

package/dist/api/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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.
+ */
+export type { ApiClient, ApiClientOptions, RequestOptions, PollOptions, DebugLogger, Integration, Action, Trigger, Field, Choice, ActionExecutionResult, ActionField, ActionFieldChoice, NeedsRequest, NeedsResponse, Authentication, AuthenticationsResponse, } from "./types";
+export { isJwt, getAuthorizationHeader } from "./auth";
+export { createDebugLogger, createDebugFetch } from "./debug";
+export { pollUntilComplete } from "./polling";
+export { createZapierApi } from "./client";
+export declare function generateRequestId(): string;
+/**
+ * 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 declare function getOrCreateApiClient(config: {
+    baseUrl?: string;
+    token?: string;
+    api?: import("./types").ApiClient;
+    debug?: boolean;
+    fetch?: typeof globalThis.fetch;
+}): import("./types").ApiClient;

package/dist/api/index.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createZapierApi = exports.pollUntilComplete = exports.createDebugFetch = exports.createDebugLogger = exports.getAuthorizationHeader = exports.isJwt = void 0;
+exports.generateRequestId = generateRequestId;
+exports.getOrCreateApiClient = getOrCreateApiClient;
+// Re-export authentication utilities
+var auth_1 = require("./auth");
+Object.defineProperty(exports, "isJwt", { enumerable: true, get: function () { return auth_1.isJwt; } });
+Object.defineProperty(exports, "getAuthorizationHeader", { enumerable: true, get: function () { return auth_1.getAuthorizationHeader; } });
+// Re-export debug utilities
+var debug_1 = require("./debug");
+Object.defineProperty(exports, "createDebugLogger", { enumerable: true, get: function () { return debug_1.createDebugLogger; } });
+Object.defineProperty(exports, "createDebugFetch", { enumerable: true, get: function () { return debug_1.createDebugFetch; } });
+// Re-export polling utilities
+var polling_1 = require("./polling");
+Object.defineProperty(exports, "pollUntilComplete", { enumerable: true, get: function () { return polling_1.pollUntilComplete; } });
+// Re-export the main client factory
+var client_1 = require("./client");
+Object.defineProperty(exports, "createZapierApi", { enumerable: true, get: function () { return client_1.createZapierApi; } });
+// Utility Functions
+function generateRequestId() {
+    return Math.random().toString(36).substring(2) + Date.now().toString(36);
+}
+/**
+ * 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
+ */
+function getOrCreateApiClient(config) {
+    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
+    if (providedApi) {
+        return providedApi;
+    }
+    // Import createZapierApi locally to avoid circular imports
+    const { createZapierApi } = require("./client");
+    return createZapierApi({
+        baseUrl,
+        token,
+        debug,
+        fetch: customFetch,
+    });
+}

package/dist/api/polling.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Polling Utilities
+ *
+ * This module provides utilities for polling HTTP endpoints until completion,
+ * with configurable retry logic and exponential backoff.
+ */
+export declare 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>;

package/dist/api/polling.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Polling Utilities
+ *
+ * This module provides utilities for polling HTTP endpoints until completion,
+ * with configurable retry logic and exponential backoff.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pollUntilComplete = pollUntilComplete;
+async function pollUntilComplete(options) {
+    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`);
+}

package/dist/{types.d.ts → api/types.d.ts}

@@ -1,3 +1,40 @@
+/**
+ * API Client Type Definitions
+ *
+ * This module contains all type definitions related to the Zapier API client,
+ * including configuration options, client interfaces, request/response types,
+ * and API response models.
+ */
+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;
+}
+export interface DebugLogger {
+    (message: string, data?: any): void;
+}
 export interface Integration {
     key: string;
     name: string;
@@ -37,17 +74,6 @@ export interface Choice {
     value: string | number;
     label: string;
 }
-export interface ListOptions {
-    category?: string;
-    appKey?: string;
-    type?: string;
-    limit?: number;
-    offset?: number;
-}
-export interface ActionExecutionOptions {
-    inputs?: Record<string, any>;
-    authId?: number;
-}
 export interface ActionExecutionResult {
     success: boolean;
     data?: any;
@@ -89,34 +115,6 @@ export interface NeedsResponse {
     needs?: ActionField[];
     errors?: string[];
 }
-export interface Workflow {
-    id: string;
-    name: string;
-    description: string;
-    steps: WorkflowStep[];
-}
-export interface WorkflowStep {
-    id: string;
-    type: "trigger" | "action";
-    appKey: string;
-    actionKey?: string;
-    triggerKey?: string;
-}
-export interface Interface {
-    key: string;
-    name: string;
-    fields: Field[];
-}
-export interface Table {
-    key: string;
-    name: string;
-    columns: TableColumn[];
-}
-export interface TableColumn {
-    key: string;
-    name: string;
-    type: string;
-}
 export interface Authentication {
     id: number;
     date: string;
@@ -145,52 +143,3 @@ export interface AuthenticationsResponse {
     previous?: string | null;
     results: Authentication[];
 }
-export interface AuthenticationListOptions {
-    account_id?: string;
-    owner?: string;
-    appKey?: string;
-    limit?: number;
-    offset?: number;
-}
-export declare class ZapierSdkError extends Error {
-    code?: string | undefined;
-    constructor(message: string, code?: string | undefined);
-}
-export declare class AppNotFoundError extends ZapierSdkError {
-    constructor(appKey: string);
-}
-export declare class ActionNotFoundError extends ZapierSdkError {
-    constructor(appKey: string, actionKey: string);
-}
-export declare class AuthenticationError extends ZapierSdkError {
-    constructor(message: string);
-}
-export interface AuthObject {
-    id: number;
-}
-export interface BaseSdkOptions {
-    token?: string;
-    authentications?: {
-        [appKey: string]: AuthObject[];
-    };
-    fetch?: typeof fetch;
-    baseUrl?: string;
-    debug?: boolean;
-}
-export interface FunctionConfig {
-    /** Base URL for Zapier API */
-    baseUrl?: string;
-    /** Authentication token */
-    token?: string;
-    /** Optional pre-instantiated API client */
-    api?: any;
-    /** Enable debug logging */
-    debug?: boolean;
-    /** Custom fetch implementation */
-    fetch?: typeof globalThis.fetch;
-}
-export interface CombinedSdk {
-    [namespace: string]: any;
-}
-export type SdkFactory<T = any> = (options: BaseSdkOptions) => T;
-export declare function combineSdks(sdks: Record<string, any>): CombinedSdk;

package/dist/api/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * API Client Type Definitions
+ *
+ * This module contains all type definitions related to the Zapier API client,
+ * including configuration options, client interfaces, request/response types,
+ * and API response models.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/functions/{bundleCode.d.ts → bundleCode/index.d.ts}

@@ -1,11 +1,4 @@
-export interface BundleCodeOptions {
-    input: string;
-    output?: string;
-    target?: string;
-    cjs?: boolean;
-    minify?: boolean;
-    string?: boolean;
-}
+import type { BundleCodeOptions } from "./schemas";
 /**
  * Bundle TypeScript code into executable JavaScript
  *

package/dist/functions/bundleCode/info.d.ts

@@ -0,0 +1,27 @@
+import { bundleCode } from "./index";
+export declare const bundleCodeInfo: {
+    name: string;
+    inputSchema: import("zod").ZodObject<{
+        input: import("zod").ZodString;
+        output: import("zod").ZodOptional<import("zod").ZodString>;
+        string: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        minify: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        target: import("zod").ZodDefault<import("zod").ZodString>;
+        cjs: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    }, "strip", import("zod").ZodTypeAny, {
+        string: boolean;
+        input: string;
+        minify: boolean;
+        target: string;
+        cjs: boolean;
+        output?: string | undefined;
+    }, {
+        input: string;
+        string?: boolean | undefined;
+        output?: string | undefined;
+        minify?: boolean | undefined;
+        target?: string | undefined;
+        cjs?: boolean | undefined;
+    }>;
+    implementation: typeof bundleCode;
+};

package/dist/functions/bundleCode/info.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bundleCodeInfo = void 0;
+const index_1 = require("./index");
+const schemas_1 = require("./schemas");
+// Function registry info - imports both function and schema
+exports.bundleCodeInfo = {
+    name: index_1.bundleCode.name,
+    inputSchema: schemas_1.BundleCodeSchema,
+    implementation: index_1.bundleCode,
+};

package/dist/functions/bundleCode/schemas.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+export declare const BundleCodeSchema: z.ZodObject<{
+    input: z.ZodString;
+    output: z.ZodOptional<z.ZodString>;
+    string: z.ZodDefault<z.ZodBoolean>;
+    minify: z.ZodDefault<z.ZodBoolean>;
+    target: z.ZodDefault<z.ZodString>;
+    cjs: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    string: boolean;
+    input: string;
+    minify: boolean;
+    target: string;
+    cjs: boolean;
+    output?: string | undefined;
+}, {
+    input: string;
+    string?: boolean | undefined;
+    output?: string | undefined;
+    minify?: boolean | undefined;
+    target?: string | undefined;
+    cjs?: boolean | undefined;
+}>;
+export type BundleCodeOptions = z.infer<typeof BundleCodeSchema>;
+export interface BundleCodeSdkFunction {
+    bundleCode: (options: BundleCodeOptions) => Promise<string>;
+}

package/dist/functions/bundleCode/schemas.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BundleCodeSchema = void 0;
+const zod_1 = require("zod");
+const properties_1 = require("../../types/properties");
+// Pure Zod schema - no resolver metadata!
+exports.BundleCodeSchema = zod_1.z
+    .object({
+    input: zod_1.z.string().min(1).describe("Input TypeScript file path to bundle"),
+    output: properties_1.OutputPropertySchema.optional().describe("Output file path (defaults to input with .js extension)"),
+    string: zod_1.z
+        .boolean()
+        .default(false)
+        .describe("Return bundled code as string instead of writing to file"),
+    minify: zod_1.z.boolean().default(false).describe("Minify the bundled output"),
+    target: zod_1.z.string().default("es2017").describe("ECMAScript target version"),
+    cjs: zod_1.z
+        .boolean()
+        .default(false)
+        .describe("Output CommonJS format instead of ESM"),
+})
+    .describe("Bundle TypeScript code into executable JavaScript");

package/dist/functions/{generateTypes.d.ts → generateTypes/index.d.ts}

@@ -1,16 +1,11 @@
-import type { FunctionConfig } from "../types";
-export interface GenerateTypesOptions extends FunctionConfig {
-    appKey: string;
-    authId?: number;
-    output?: string;
-}
+import type { GenerateTypesOptions } from "./schemas";
 /**
  * Generate TypeScript types for a specific app
  *
  * 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 - App key, auth ID, output path, and API configuration options
+ * @param options - App key, authentication ID, output path, and API configuration options
  * @returns Promise<string> - Generated TypeScript code
  */
 export declare function generateTypes(options: GenerateTypesOptions): Promise<string>;