@zapier/zapier-sdk 0.13.7 → 0.13.9

package/dist/schemas/Field.d.ts

@@ -3,11 +3,11 @@ export declare const BaseFieldItemSchema: z.ZodObject<{
     type: z.ZodString;
     key: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    type: string;
     key: string;
-}, {
     type: string;
+}, {
     key: string;
+    type: string;
 }>;
 export declare const InputFieldItemSchema: z.ZodObject<{
     key: z.ZodString;
@@ -30,8 +30,8 @@ export declare const InputFieldItemSchema: z.ZodObject<{
         type: string;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    type: "input_field";
     key: string;
+    type: "input_field";
     depends_on: string[];
     placeholder: string;
     description: string;
@@ -45,8 +45,8 @@ export declare const InputFieldItemSchema: z.ZodObject<{
         type: string;
     } | undefined;
 }, {
-    type: "input_field";
     key: string;
+    type: "input_field";
     depends_on: string[];
     placeholder: string;
     description: string;
@@ -67,13 +67,13 @@ export declare const InfoFieldItemSchema: z.ZodObject<{
     description: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    type: "info_field";
     key: string;
+    type: "info_field";
     description: string;
     title?: string | undefined;
 }, {
-    type: "info_field";
     key: string;
+    type: "info_field";
     description: string;
     title?: string | undefined;
 }>;
@@ -106,8 +106,8 @@ export declare const RootFieldItemSchema: z.ZodUnion<[z.ZodObject<{
         type: string;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    type: "input_field";
     key: string;
+    type: "input_field";
     depends_on: string[];
     placeholder: string;
     description: string;
@@ -121,8 +121,8 @@ export declare const RootFieldItemSchema: z.ZodUnion<[z.ZodObject<{
         type: string;
     } | undefined;
 }, {
-    type: "input_field";
     key: string;
+    type: "input_field";
     depends_on: string[];
     placeholder: string;
     description: string;
@@ -142,13 +142,13 @@ export declare const RootFieldItemSchema: z.ZodUnion<[z.ZodObject<{
     description: z.ZodString;
     title: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    type: "info_field";
     key: string;
+    type: "info_field";
     description: string;
     title?: string | undefined;
 }, {
-    type: "info_field";
     key: string;
+    type: "info_field";
     description: string;
     title?: string | undefined;
 }>, z.ZodType<FieldsetItem, z.ZodTypeDef, FieldsetItem>]>;

package/dist/sdk.test.js

@@ -1,5 +1,5 @@
 // Test the flat plugin system
-import { describe, it, expect } from "vitest";
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
 import { createZapierSdk, createSdk } from "./sdk";
 describe("Flat Plugin System", () => {
     it("should create SDK with all expected methods", () => {
@@ -133,3 +133,123 @@ describe("Flat Plugin System", () => {
         expect(context.meta).not.toBeNull();
     });
 });
+describe("Environment Variable Support", () => {
+    let originalEnv;
+    beforeEach(() => {
+        // Save original environment variable
+        originalEnv = process.env.ZAPIER_BASE_URL;
+    });
+    afterEach(() => {
+        // Restore original environment variable
+        if (originalEnv !== undefined) {
+            process.env.ZAPIER_BASE_URL = originalEnv;
+        }
+        else {
+            delete process.env.ZAPIER_BASE_URL;
+        }
+        // Clear module cache to ensure constants are re-evaluated
+        vi.resetModules();
+    });
+    it("should use custom base URL from ZAPIER_BASE_URL environment variable", async () => {
+        // Set custom base URL via environment variable
+        const customBaseUrl = "https://custom-zapier.example.com";
+        process.env.ZAPIER_BASE_URL = customBaseUrl;
+        // Clear module cache and re-import to get fresh constants
+        vi.resetModules();
+        const { createZapierSdk } = await import("./sdk");
+        // Create mock fetch function to capture requests
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                results: [],
+                meta: { next_cursor: null },
+            }),
+            headers: new Headers(),
+        });
+        // Create SDK instance with mock fetch
+        const sdk = createZapierSdk({
+            token: "test-token",
+            fetch: mockFetch,
+        });
+        // Make an API call that should use the custom base URL
+        await sdk.listApps();
+        // Verify that the request was made to the custom base URL
+        expect(mockFetch).toHaveBeenCalledTimes(1);
+        const [actualUrl] = mockFetch.mock.calls[0];
+        expect(actualUrl).toMatch(new RegExp(`^${customBaseUrl}`));
+        expect(actualUrl).toContain("/api/v4/");
+    });
+    it("should use default base URL when ZAPIER_BASE_URL is not set", async () => {
+        // Ensure environment variable is not set
+        delete process.env.ZAPIER_BASE_URL;
+        // Clear module cache and re-import to get fresh constants
+        vi.resetModules();
+        const { createZapierSdk } = await import("./sdk");
+        // Create mock fetch function to capture requests
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                results: [],
+                meta: { next_cursor: null },
+            }),
+            headers: new Headers(),
+        });
+        // Create SDK instance with mock fetch
+        const sdk = createZapierSdk({
+            token: "test-token",
+            fetch: mockFetch,
+        });
+        // Make an API call that should use the default base URL
+        await sdk.listApps();
+        // Verify that the request was made to the default base URL
+        expect(mockFetch).toHaveBeenCalledTimes(1);
+        const [actualUrl] = mockFetch.mock.calls[0];
+        expect(actualUrl).toMatch(/^https:\/\/zapier\.com/);
+        expect(actualUrl).toContain("/api/v4/");
+    });
+    it("should use explicit baseUrl option for SDK API requests", async () => {
+        // Clear environment variable to ensure we're testing the explicit option
+        delete process.env.ZAPIER_BASE_URL;
+        // Clear module cache and re-import to get fresh constants
+        vi.resetModules();
+        const { createZapierSdk } = await import("./sdk");
+        const customBaseUrl = "https://staging.zapier.com";
+        // Create mock fetch function to capture requests
+        const mockFetch = vi.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                results: [],
+                meta: { next_cursor: null },
+            }),
+            headers: new Headers(),
+        });
+        // Create SDK instance with explicit baseUrl option and mock fetch
+        const sdk = createZapierSdk({
+            baseUrl: customBaseUrl,
+            token: "test-token",
+            fetch: mockFetch,
+        });
+        // Make an API call that should use the custom base URL
+        await sdk.listApps();
+        // Verify that the request was made to the custom base URL
+        expect(mockFetch).toHaveBeenCalledTimes(1);
+        const [actualUrl] = mockFetch.mock.calls[0];
+        expect(actualUrl).toMatch(new RegExp(`^${customBaseUrl}`));
+        expect(actualUrl).toContain("/api/v4/");
+    });
+    it("should accept authClientId in SDK options", async () => {
+        delete process.env.ZAPIER_BASE_URL;
+        vi.resetModules();
+        const { createZapierSdk } = await import("./sdk");
+        const sdk = createZapierSdk({
+            authClientId: "test-client-id",
+            token: "test-token",
+        });
+        // Verify SDK was created successfully with authClientId option
+        expect(sdk).toBeDefined();
+        expect(sdk.listApps).toBeDefined();
+    });
+});

package/dist/types/sdk.d.ts

@@ -10,6 +10,9 @@ export interface BaseSdkOptions {
     onEvent?: EventCallback;
     fetch?: typeof fetch;
     baseUrl?: string;
+    authBaseUrl?: string;
+    authClientId?: string;
+    trackingBaseUrl?: string;
     debug?: boolean;
     manifestPath?: string;
     manifest?: Manifest;

package/dist/types/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/types/sdk.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/types/sdk.ts"],"names":[],"mappings":"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"}

package/dist/utils/batch-utils.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Batch Operation Utilities
+ *
+ * This module provides utilities for executing multiple async operations
+ * with concurrency control and retry logic.
+ */
+/**
+ * Options for batch execution
+ */
+export interface BatchOptions {
+    /**
+     * Maximum number of concurrent operations (default: 10)
+     * Lower values are more "polite" but slower
+     * Higher values are faster but risk rate limits
+     */
+    concurrency?: number;
+    /**
+     * Whether to retry failed operations (default: true)
+     * When enabled, each operation gets up to MAX_CONSECUTIVE_ERRORS retries
+     */
+    retry?: boolean;
+    /**
+     * Delay in milliseconds between starting batches (default: 100ms)
+     * Adds a small delay between concurrent batches to avoid burst patterns
+     */
+    batchDelay?: number;
+    /**
+     * Overall timeout for the entire batch operation in milliseconds (default: 180000ms / 3 minutes)
+     * When exceeded, throws ZapierTimeoutError and stops processing remaining tasks
+     */
+    timeoutMs?: number;
+    /**
+     * Timeout for individual tasks in milliseconds (default: none)
+     * When set, each task will be cancelled if it exceeds this duration
+     * Tasks that timeout will be marked as rejected in the results
+     */
+    taskTimeoutMs?: number;
+}
+/**
+ * Execute multiple async operations with concurrency limiting and retry logic
+ *
+ * This prevents overwhelming APIs by:
+ * 1. Limiting concurrent operations (worker pool pattern)
+ * 2. Adding small delays between batches to avoid burst detection
+ * 3. Retrying failed operations with exponential backoff
+ *
+ * Problem Solved:
+ * - Rate limit prevention: Steady stream instead of burst requests
+ * - Connection pool management: Stays within browser/Node limits (~6-8 per domain)
+ * - Resilience: Transient failures are retried automatically
+ * - Observability: Returns detailed success/failure info for each operation
+ *
+ * Example Usage:
+ * ```typescript
+ * // Instead of Promise.allSettled (fires all at once):
+ * const results = await Promise.allSettled(
+ *   actions.map(a => sdk.listInputFields(a))
+ * );
+ *
+ * // Use batch (controlled concurrency):
+ * const results = await batch(
+ *   actions.map(a => () => sdk.listInputFields(a)),
+ *   { concurrency: 10, retry: true }
+ * );
+ * ```
+ *
+ * @param tasks - Array of functions that return promises (NOT promises themselves!)
+ * @param options - Configuration for concurrency and retry behavior
+ * @returns Promise resolving to array of settled results (same as Promise.allSettled)
+ */
+export declare function batch<T>(tasks: (() => Promise<T>)[], options?: BatchOptions): Promise<PromiseSettledResult<T>[]>;
+//# sourceMappingURL=batch-utils.d.ts.map

package/dist/utils/batch-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-utils.d.ts","sourceRoot":"","sources":["../../src/utils/batch-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwBH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAC3B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC,CAuIpC"}

package/dist/utils/batch-utils.js

@@ -0,0 +1,162 @@
+/**
+ * Batch Operation Utilities
+ *
+ * This module provides utilities for executing multiple async operations
+ * with concurrency control and retry logic.
+ */
+import { setTimeout } from "timers/promises";
+import { calculateWaitTime, MAX_CONSECUTIVE_ERRORS } from "./retry-utils";
+import { ZapierTimeoutError } from "../types/errors";
+/**
+ * Default number of concurrent operations
+ * Chosen to be "polite" to APIs while still providing good throughput
+ */
+const DEFAULT_CONCURRENCY = 10;
+/**
+ * Delay between starting each batch of concurrent operations (milliseconds)
+ * This prevents burst patterns that might trigger rate limiting
+ */
+const BATCH_START_DELAY_MS = 25;
+/**
+ * Default timeout for entire batch operation (milliseconds)
+ * Set to 3 minutes to match polling default timeout
+ */
+const DEFAULT_BATCH_TIMEOUT_MS = 180000;
+/**
+ * Execute multiple async operations with concurrency limiting and retry logic
+ *
+ * This prevents overwhelming APIs by:
+ * 1. Limiting concurrent operations (worker pool pattern)
+ * 2. Adding small delays between batches to avoid burst detection
+ * 3. Retrying failed operations with exponential backoff
+ *
+ * Problem Solved:
+ * - Rate limit prevention: Steady stream instead of burst requests
+ * - Connection pool management: Stays within browser/Node limits (~6-8 per domain)
+ * - Resilience: Transient failures are retried automatically
+ * - Observability: Returns detailed success/failure info for each operation
+ *
+ * Example Usage:
+ * ```typescript
+ * // Instead of Promise.allSettled (fires all at once):
+ * const results = await Promise.allSettled(
+ *   actions.map(a => sdk.listInputFields(a))
+ * );
+ *
+ * // Use batch (controlled concurrency):
+ * const results = await batch(
+ *   actions.map(a => () => sdk.listInputFields(a)),
+ *   { concurrency: 10, retry: true }
+ * );
+ * ```
+ *
+ * @param tasks - Array of functions that return promises (NOT promises themselves!)
+ * @param options - Configuration for concurrency and retry behavior
+ * @returns Promise resolving to array of settled results (same as Promise.allSettled)
+ */
+export async function batch(tasks, options = {}) {
+    const { concurrency = DEFAULT_CONCURRENCY, retry = true, batchDelay = BATCH_START_DELAY_MS, timeoutMs = DEFAULT_BATCH_TIMEOUT_MS, taskTimeoutMs, } = options;
+    // Validate inputs
+    if (concurrency <= 0) {
+        throw new Error("Concurrency must be greater than 0");
+    }
+    if (timeoutMs <= 0) {
+        throw new Error("Timeout must be greater than 0");
+    }
+    if (taskTimeoutMs !== undefined && taskTimeoutMs <= 0) {
+        throw new Error("Task timeout must be greater than 0");
+    }
+    if (tasks.length === 0) {
+        return [];
+    }
+    // Track overall batch timing
+    const startTime = Date.now();
+    // Pre-allocate results array to maintain input order
+    const results = new Array(tasks.length);
+    // Create task queue with retry state
+    const taskQueue = tasks.map((task, index) => ({
+        index,
+        task,
+        errorCount: 0,
+    }));
+    /**
+     * Execute a single task with retry logic and optional per-task timeout
+     */
+    async function executeTask(taskState) {
+        const { index, task, errorCount } = taskState;
+        try {
+            let result;
+            // Apply per-task timeout if specified
+            if (taskTimeoutMs !== undefined) {
+                const timeoutPromise = setTimeout(taskTimeoutMs).then(() => {
+                    throw new ZapierTimeoutError(`Task timed out after ${taskTimeoutMs}ms`);
+                });
+                result = await Promise.race([task(), timeoutPromise]);
+            }
+            else {
+                result = await task();
+            }
+            results[index] = { status: "fulfilled", value: result };
+        }
+        catch (error) {
+            const newErrorCount = errorCount + 1;
+            // Don't retry timeout errors - they're unlikely to succeed on retry
+            const isTimeout = error instanceof ZapierTimeoutError;
+            // If retry is enabled and we haven't hit max errors and it's not a timeout, retry with backoff
+            if (retry && !isTimeout && newErrorCount < MAX_CONSECUTIVE_ERRORS) {
+                // Calculate backoff delay (base 1000ms with jitter and error scaling)
+                const waitTime = calculateWaitTime(1000, newErrorCount);
+                await setTimeout(waitTime);
+                // Re-queue the task with incremented error count
+                taskQueue.push({
+                    index,
+                    task,
+                    errorCount: newErrorCount,
+                });
+            }
+            else {
+                // Max retries reached, retry disabled, or timeout error - mark as rejected
+                results[index] = { status: "rejected", reason: error };
+            }
+        }
+    }
+    /**
+     * Worker that continuously picks up and executes tasks from the queue
+     * Checks overall batch timeout before processing each task
+     */
+    async function worker() {
+        while (taskQueue.length > 0) {
+            // Check overall batch timeout before processing next task
+            const elapsedTime = Date.now() - startTime;
+            if (elapsedTime >= timeoutMs) {
+                throw new ZapierTimeoutError(`Batch operation timed out after ${Math.floor(elapsedTime / 1000)}s. ${taskQueue.length} task(s) not completed.`);
+            }
+            const taskState = taskQueue.shift();
+            if (!taskState)
+                break;
+            await executeTask(taskState);
+            // Small delay to prevent burst patterns within a worker
+            // Only delay if there are more tasks to process
+            if (taskQueue.length > 0 && batchDelay > 0) {
+                await setTimeout(batchDelay);
+            }
+        }
+    }
+    /**
+     * Start workers in small batches to avoid initial burst
+     * This helps avoid rate limit triggers when starting many workers
+     */
+    const workerCount = Math.min(concurrency, tasks.length);
+    const workers = [];
+    for (let i = 0; i < workerCount; i++) {
+        workers.push(worker());
+        // Add small delay between starting workers to stagger the initial requests
+        // Skip delay for last worker
+        if (i < workerCount - 1 && batchDelay > 0) {
+            await setTimeout(batchDelay / 10); // 10ms between worker starts
+        }
+    }
+    // Wait for all workers to complete
+    await Promise.all(workers);
+    return results;
+}

package/dist/utils/batch-utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=batch-utils.test.d.ts.map

package/dist/utils/batch-utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-utils.test.d.ts","sourceRoot":"","sources":["../../src/utils/batch-utils.test.ts"],"names":[],"mappings":""}