@zapier/zapier-sdk 0.18.3 → 0.19.0

package/dist/utils/telemetry-utils.test.js

@@ -1,94 +0,0 @@
-import { describe, it, expect, vi } from "vitest";
-import { createTelemetryCallback } from "./telemetry-utils";
-describe("createTelemetryCallback", () => {
-    it("should create callback that emits telemetry with explicit method name", () => {
-        const mockEmit = vi.fn();
-        const callback = createTelemetryCallback(mockEmit, "testMethod");
-        callback.onMethodCalled({
-            methodName: "ignoredName",
-            durationMs: 123,
-            success: true,
-            argumentCount: 2,
-            isPaginated: false,
-        });
-        expect(mockEmit).toHaveBeenCalledWith({
-            method_name: "testMethod",
-            execution_duration_ms: 123,
-            success_flag: true,
-            error_message: null,
-            error_type: null,
-            argument_count: 2,
-            is_paginated: false,
-        });
-    });
-    it("should include error details when method fails", () => {
-        const mockEmit = vi.fn();
-        const callback = createTelemetryCallback(mockEmit, "failingMethod");
-        const testError = new Error("Test failure");
-        callback.onMethodCalled({
-            methodName: "ignoredName",
-            durationMs: 50,
-            success: false,
-            error: testError,
-            argumentCount: 1,
-            isPaginated: false,
-        });
-        expect(mockEmit).toHaveBeenCalledWith({
-            method_name: "failingMethod",
-            execution_duration_ms: 50,
-            success_flag: false,
-            error_message: "Test failure",
-            error_type: "Error",
-            argument_count: 1,
-            is_paginated: false,
-        });
-    });
-    it("should handle paginated method calls", () => {
-        const mockEmit = vi.fn();
-        const callback = createTelemetryCallback(mockEmit, "listItems");
-        callback.onMethodCalled({
-            methodName: "ignoredName",
-            durationMs: 200,
-            success: true,
-            argumentCount: 1,
-            isPaginated: true,
-        });
-        expect(mockEmit).toHaveBeenCalledWith({
-            method_name: "listItems",
-            execution_duration_ms: 200,
-            success_flag: true,
-            error_message: null,
-            error_type: null,
-            argument_count: 1,
-            is_paginated: true,
-        });
-    });
-    it("should handle custom error types", () => {
-        const mockEmit = vi.fn();
-        const callback = createTelemetryCallback(mockEmit, "customFailMethod");
-        class CustomError extends Error {
-            constructor(message) {
-                super(message);
-                this.name = "CustomError";
-            }
-        }
-        const customError = new CustomError("Custom failure");
-        callback.onMethodCalled({
-            methodName: "ignoredName",
-            durationMs: 75,
-            success: false,
-            error: customError,
-            argumentCount: 3,
-            isPaginated: false,
-        });
-        expect(mockEmit).toHaveBeenCalledWith({
-            method_name: "customFailMethod",
-            execution_duration_ms: 75,
-            success_flag: false,
-            error_message: "Custom failure",
-            error_type: "CustomError",
-            argument_count: 3,
-            is_paginated: false,
-        });
-    });
-});

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

@@ -1,19 +0,0 @@
-/**
- * Gets the Zapier base URL from a baseUrl if it matches Zapier hosting patterns.
- * Returns the root domain URL or undefined if not a Zapier domain.
- * This combines domain checking and URL extraction logic.
- */
-export declare function getZapierBaseUrl(baseUrl?: string): string | undefined;
-/**
- * Gets tracking base URL with the following precedence:
- * 1. Explicit trackingBaseUrl parameter
- * 2. ZAPIER_TRACKING_BASE_URL environment variable
- * 3. Derive from baseUrl if it's a Zapier domain
- * 4. Use baseUrl directly (whether Zapier-hosted or not)
- * 5. Default to ZAPIER_BASE_URL constant
- */
-export declare function getTrackingBaseUrl({ trackingBaseUrl, baseUrl, }: {
-    trackingBaseUrl?: string;
-    baseUrl?: string;
-}): string;
-//# sourceMappingURL=url-utils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"url-utils.d.ts","sourceRoot":"","sources":["../../src/utils/url-utils.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA+BrE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,eAAe,EACf,OAAO,GACR,EAAE;IACD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CA0BT"}

package/dist/utils/url-utils.js

@@ -1,62 +0,0 @@
-import { ZAPIER_BASE_URL } from "../constants";
-/**
- * Gets the Zapier base URL from a baseUrl if it matches Zapier hosting patterns.
- * Returns the root domain URL or undefined if not a Zapier domain.
- * This combines domain checking and URL extraction logic.
- */
-export function getZapierBaseUrl(baseUrl) {
-    if (!baseUrl) {
-        return undefined;
-    }
-    try {
-        const url = new URL(baseUrl);
-        const hostname = url.hostname;
-        // Check if it matches Zapier hosting patterns by examining the last two parts
-        const hostParts = hostname.split(".");
-        if (hostParts.length < 2) {
-            return undefined;
-        }
-        // Check if any part is "zapier" or starts with "zapier-"
-        const hasZapierPart = hostParts.some((part) => part === "zapier" || part.startsWith("zapier-"));
-        if (!hasZapierPart) {
-            return undefined;
-        }
-        // Extract root domain using the last two parts
-        const rootDomain = hostParts.slice(-2).join(".");
-        return `${url.protocol}//${rootDomain}`;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Gets tracking base URL with the following precedence:
- * 1. Explicit trackingBaseUrl parameter
- * 2. ZAPIER_TRACKING_BASE_URL environment variable
- * 3. Derive from baseUrl if it's a Zapier domain
- * 4. Use baseUrl directly (whether Zapier-hosted or not)
- * 5. Default to ZAPIER_BASE_URL constant
- */
-export function getTrackingBaseUrl({ trackingBaseUrl, baseUrl, }) {
-    // 1. Explicit parameter takes highest precedence
-    if (trackingBaseUrl) {
-        return trackingBaseUrl;
-    }
-    // 2. Environment variable override
-    if (process.env.ZAPIER_TRACKING_BASE_URL) {
-        return process.env.ZAPIER_TRACKING_BASE_URL;
-    }
-    // 3. Try to derive from baseUrl if it's a Zapier domain
-    if (baseUrl) {
-        const zapierBaseUrl = getZapierBaseUrl(baseUrl);
-        if (zapierBaseUrl) {
-            return zapierBaseUrl;
-        }
-    }
-    // 4. Use baseUrl directly for tracking (whether Zapier-hosted or not)
-    if (baseUrl) {
-        return baseUrl;
-    }
-    // 5. Default to ZAPIER_BASE_URL constant
-    return ZAPIER_BASE_URL;
-}

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

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

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

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

package/dist/utils/url-utils.test.js

@@ -1,103 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
-import { getZapierBaseUrl, getTrackingBaseUrl } from "./url-utils";
-describe("getZapierBaseUrl", () => {
-    describe("with valid Zapier domains", () => {
-        it("should return root domain for zapier.* patterns", () => {
-            expect(getZapierBaseUrl("https://zapier.com")).toBe("https://zapier.com");
-            expect(getZapierBaseUrl("https://api.zapier.com")).toBe("https://zapier.com");
-            expect(getZapierBaseUrl("https://staging.zapier.com")).toBe("https://zapier.com");
-            expect(getZapierBaseUrl("https://custom.zapier.dev:8080")).toBe("https://zapier.dev");
-        });
-        it("should return root domain for zapier-*.* patterns", () => {
-            expect(getZapierBaseUrl("https://zapier-staging.dev")).toBe("https://zapier-staging.dev");
-            expect(getZapierBaseUrl("https://zapier-production.example.com")).toBe("https://example.com");
-            expect(getZapierBaseUrl("http://zapier-custom.local")).toBe("http://zapier-custom.local");
-        });
-    });
-    describe("with non-Zapier domains", () => {
-        it("should return undefined for non-Zapier domains", () => {
-            expect(getZapierBaseUrl("https://example.com")).toBe(undefined);
-            expect(getZapierBaseUrl("https://api.example.com")).toBe(undefined);
-            expect(getZapierBaseUrl("http://localhost")).toBe(undefined);
-            expect(getZapierBaseUrl("http://127.0.0.1")).toBe(undefined);
-            expect(getZapierBaseUrl("https://my-zapier.com")).toBe(undefined);
-        });
-    });
-    describe("with invalid inputs", () => {
-        it("should return undefined for invalid or missing URLs", () => {
-            expect(getZapierBaseUrl()).toBe(undefined);
-            expect(getZapierBaseUrl(undefined)).toBe(undefined);
-            expect(getZapierBaseUrl("")).toBe(undefined);
-            expect(getZapierBaseUrl("invalid-url")).toBe(undefined);
-        });
-    });
-});
-describe("getTrackingBaseUrl", () => {
-    let originalEnv;
-    beforeEach(() => {
-        originalEnv = {
-            ZAPIER_TRACKING_BASE_URL: process.env.ZAPIER_TRACKING_BASE_URL,
-            ZAPIER_BASE_URL: process.env.ZAPIER_BASE_URL,
-        };
-    });
-    afterEach(() => {
-        if (originalEnv.ZAPIER_TRACKING_BASE_URL !== undefined) {
-            process.env.ZAPIER_TRACKING_BASE_URL =
-                originalEnv.ZAPIER_TRACKING_BASE_URL;
-        }
-        else {
-            delete process.env.ZAPIER_TRACKING_BASE_URL;
-        }
-        if (originalEnv.ZAPIER_BASE_URL !== undefined) {
-            process.env.ZAPIER_BASE_URL = originalEnv.ZAPIER_BASE_URL;
-        }
-        else {
-            delete process.env.ZAPIER_BASE_URL;
-        }
-    });
-    describe("precedence rules", () => {
-        it("should prioritize trackingBaseUrl parameter", () => {
-            process.env.ZAPIER_TRACKING_BASE_URL = "https://env-tracking.zapier.com";
-            expect(getTrackingBaseUrl({
-                trackingBaseUrl: "https://param-tracking.zapier.com",
-                baseUrl: "https://api.example.com",
-            })).toBe("https://param-tracking.zapier.com");
-        });
-        it("should use ZAPIER_TRACKING_BASE_URL environment variable", () => {
-            process.env.ZAPIER_TRACKING_BASE_URL = "https://env-tracking.zapier.com";
-            expect(getTrackingBaseUrl({
-                baseUrl: "https://api.example.com",
-            })).toBe("https://env-tracking.zapier.com");
-        });
-        it("should derive from baseUrl if it's a Zapier domain", () => {
-            delete process.env.ZAPIER_TRACKING_BASE_URL;
-            expect(getTrackingBaseUrl({
-                baseUrl: "https://api.zapier.com",
-            })).toBe("https://zapier.com");
-            expect(getTrackingBaseUrl({
-                baseUrl: "https://custom.zapier.dev:8080",
-            })).toBe("https://zapier.dev");
-        });
-        it("should use baseUrl directly for non-Zapier domains", () => {
-            delete process.env.ZAPIER_TRACKING_BASE_URL;
-            expect(getTrackingBaseUrl({
-                baseUrl: "https://api.example.com",
-            })).toBe("https://api.example.com");
-            expect(getTrackingBaseUrl({
-                baseUrl: "http://localhost:3000",
-            })).toBe("http://localhost:3000");
-        });
-        it("should fallback to ZAPIER_BASE_URL constant", async () => {
-            delete process.env.ZAPIER_TRACKING_BASE_URL;
-            process.env.ZAPIER_BASE_URL = "https://custom.zapier.com";
-            // Clear module cache and re-import to get fresh constants
-            vi.resetModules();
-            const { getTrackingBaseUrl: freshGetTrackingBaseUrl } = await import("./url-utils");
-            expect(freshGetTrackingBaseUrl({})).toBe("https://custom.zapier.com");
-            delete process.env.ZAPIER_BASE_URL;
-            vi.resetModules();
-            const { getTrackingBaseUrl: defaultGetTrackingBaseUrl } = await import("./url-utils");
-            expect(defaultGetTrackingBaseUrl({})).toBe("https://zapier.com");
-        });
-    });
-});

package/dist/utils/validation.d.ts

@@ -1,4 +0,0 @@
-import type { z } from "zod";
-export declare function createValidator<TSchema extends z.ZodSchema>(schema: TSchema): (input: unknown) => z.infer<TSchema>;
-export declare const validateOptions: <TOptions, TSchemaOptions extends TOptions>(schema: z.ZodSchema<TSchemaOptions>, options: TOptions) => TSchemaOptions;
-//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAgC7B,wBAAgB,eAAe,CAAC,OAAO,SAAS,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,IAC/C,OAAO,OAAO,KAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAG7D;AAED,eAAO,MAAM,eAAe,GAAI,QAAQ,EAAE,cAAc,SAAS,QAAQ,EACvE,QAAQ,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,EACnC,SAAS,QAAQ,mBAGlB,CAAC"}

package/dist/utils/validation.js

@@ -1,30 +0,0 @@
-import { ZapierValidationError } from "../types/errors";
-/**
- * Throws clean ZapierValidationError on validation failures
- */
-const validate = (schema, input) => {
-    const result = schema.safeParse(input);
-    if (!result.success) {
-        // Format Zod errors into a clean, user-friendly message
-        const errorMessages = result.error.issues.map((error) => {
-            const path = error.path.length > 0 ? error.path.join(".") : "input";
-            return `${path}: ${error.message}`;
-        });
-        const message = `Validation failed:\n  ${errorMessages.join("\n  ")}`;
-        throw new ZapierValidationError(message, {
-            details: {
-                zodErrors: result.error.issues,
-                input,
-            },
-        });
-    }
-    return result.data;
-};
-export function createValidator(schema) {
-    return function validateFn(input) {
-        return validate(schema, input);
-    };
-}
-export const validateOptions = (schema, options) => {
-    return validate(schema, options);
-};

package/dist/utils/validation.test.d.ts

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

package/dist/utils/validation.test.d.ts.map

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

package/dist/utils/validation.test.js

@@ -1,44 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { z } from "zod";
-import { createValidator } from "./validation";
-import { ZapierValidationError } from "../types/errors";
-describe("validation utilities", () => {
-    describe("createValidator", () => {
-        it("should validate valid input", () => {
-            const schema = z.object({
-                name: z.string(),
-                age: z.number(),
-            });
-            const validator = createValidator(schema);
-            const result = validator({ name: "John", age: 30 });
-            expect(result).toEqual({ name: "John", age: 30 });
-        });
-        it("should throw ZapierValidationError for invalid input", () => {
-            const schema = z.object({
-                name: z.string(),
-                age: z.number(),
-            });
-            const validator = createValidator(schema);
-            expect(() => {
-                validator({ name: "John", age: "not-a-number" });
-            }).toThrow(ZapierValidationError);
-        });
-        it("should include helpful error messages", () => {
-            const schema = z.object({
-                name: z.string(),
-                age: z.number().min(0),
-            });
-            const validator = createValidator(schema);
-            try {
-                validator({ name: 123, age: -5 });
-            }
-            catch (error) {
-                expect(error).toBeInstanceOf(ZapierValidationError);
-                expect(error.message).toContain("name:");
-                expect(error.message).toContain("age:");
-                expect(error.details
-                    ?.zodErrors).toBeDefined();
-            }
-        });
-    });
-});