@zapier/zapier-sdk 0.15.4 → 0.15.9

package/dist/api/router.d.ts

@@ -0,0 +1,16 @@
+import { type Handler } from "../temporary-internal-core";
+export interface Route {
+    method: string;
+    pattern: RegExp;
+    handler: Handler<any, any, any>;
+    paramMap: string[];
+}
+export declare function findMatchingRoute(routeList: Route[], method: string, path: string): {
+    handler: Handler<any, any, any>;
+    params: Record<string, string>;
+} | null;
+export declare function matchRoute(method: string, path: string): {
+    handler: Handler<any, any, any>;
+    params: Record<string, string>;
+} | null;
+//# sourceMappingURL=router.d.ts.map

package/dist/api/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/api/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,OAAO,EACb,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAiBD,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,KAAK,EAAE,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM;;;SAsBb;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;;SAEtD"}

package/dist/api/router.js

@@ -0,0 +1,37 @@
+import { handleListApps, handleGetAuthentication, } from "../temporary-internal-core";
+const routes = [
+    {
+        method: "GET",
+        pattern: /^\/api\/v0\/apps$/,
+        handler: handleListApps,
+        paramMap: [],
+    },
+    {
+        method: "GET",
+        pattern: /^\/api\/v0\/authentications\/([^\/]+)$/,
+        handler: handleGetAuthentication,
+        paramMap: ["authenticationId"],
+    },
+];
+export function findMatchingRoute(routeList, method, path) {
+    for (const route of routeList) {
+        if (route.method !== method) {
+            continue;
+        }
+        const match = path.match(route.pattern);
+        if (match) {
+            const params = {};
+            route.paramMap.forEach((name, index) => {
+                params[name] = match[index + 1];
+            });
+            return {
+                handler: route.handler,
+                params,
+            };
+        }
+    }
+    return null;
+}
+export function matchRoute(method, path) {
+    return findMatchingRoute(routes, method, path);
+}

package/dist/api/router.test.d.ts

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

package/dist/api/router.test.d.ts.map

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

package/dist/api/router.test.js

@@ -0,0 +1,109 @@
+import { describe, it, expect, vi } from "vitest";
+import { matchRoute, findMatchingRoute } from "./router";
+import { handleListApps, handleGetAuthentication, } from "../temporary-internal-core";
+describe("Router", () => {
+    describe("matchRoute (Integration)", () => {
+        it("should match GET /api/v0/apps", () => {
+            const match = matchRoute("GET", "/api/v0/apps");
+            expect(match).not.toBeNull();
+            expect(match?.handler).toBe(handleListApps);
+            expect(match?.params).toEqual({});
+        });
+        it("should match GET /api/v0/authentications/:authenticationId", () => {
+            const match = matchRoute("GET", "/api/v0/authentications/12345");
+            expect(match).not.toBeNull();
+            expect(match?.handler).toBe(handleGetAuthentication);
+            expect(match?.params).toEqual({ authenticationId: "12345" });
+        });
+        it("should not match POST /api/v0/apps", () => {
+            const match = matchRoute("POST", "/api/v0/apps");
+            expect(match).toBeNull();
+        });
+        it("should not match unknown paths", () => {
+            expect(matchRoute("GET", "/api/v0/unknown")).toBeNull();
+            expect(matchRoute("GET", "/")).toBeNull();
+        });
+        it("should not match partial paths if regex is anchored", () => {
+            // The regex is /^\/api\/v0\/apps$/ so it shouldn't match suffix
+            expect(matchRoute("GET", "/api/v0/apps/something")).toBeNull();
+        });
+    });
+    describe("findMatchingRoute (Unit)", () => {
+        const mockHandler = vi.fn();
+        const testRoutes = [
+            {
+                method: "GET",
+                pattern: /^\/items$/,
+                handler: mockHandler,
+                paramMap: [],
+            },
+            {
+                method: "GET",
+                pattern: /^\/items\/(\d+)$/,
+                handler: mockHandler,
+                paramMap: ["id"],
+            },
+            {
+                method: "POST",
+                pattern: /^\/items$/,
+                handler: mockHandler,
+                paramMap: [],
+            },
+            {
+                method: "GET",
+                pattern: /^\/users\/(\w+)\/posts\/(\d+)$/,
+                handler: mockHandler,
+                paramMap: ["userId", "postId"],
+            },
+        ];
+        it("should match exact path", () => {
+            const match = findMatchingRoute(testRoutes, "GET", "/items");
+            expect(match).not.toBeNull();
+            expect(match?.handler).toBe(mockHandler);
+            expect(match?.params).toEqual({});
+        });
+        it("should extract single parameter", () => {
+            const match = findMatchingRoute(testRoutes, "GET", "/items/123");
+            expect(match).not.toBeNull();
+            expect(match?.params).toEqual({ id: "123" });
+        });
+        it("should extract multiple parameters", () => {
+            const match = findMatchingRoute(testRoutes, "GET", "/users/alice/posts/456");
+            expect(match).not.toBeNull();
+            expect(match?.params).toEqual({ userId: "alice", postId: "456" });
+        });
+        it("should respect HTTP method", () => {
+            // GET /items exists
+            expect(findMatchingRoute(testRoutes, "GET", "/items")).not.toBeNull();
+            // POST /items exists
+            expect(findMatchingRoute(testRoutes, "POST", "/items")).not.toBeNull();
+            // PUT /items does not exist
+            expect(findMatchingRoute(testRoutes, "PUT", "/items")).toBeNull();
+        });
+        it("should not match if regex does not match", () => {
+            // /items/abc does not match /^\/items\/(\d+)$/ (\d+ is digits only)
+            expect(findMatchingRoute(testRoutes, "GET", "/items/abc")).toBeNull();
+        });
+        it("should handle empty route list", () => {
+            expect(findMatchingRoute([], "GET", "/anything")).toBeNull();
+        });
+        it("should return first matching route", () => {
+            const overlappingRoutes = [
+                {
+                    method: "GET",
+                    pattern: /^\/overlapping$/,
+                    handler: mockHandler,
+                    paramMap: [],
+                },
+                {
+                    method: "GET",
+                    pattern: /^\/overlapping$/, // duplicate pattern
+                    handler: () => Promise.resolve("second"),
+                    paramMap: [],
+                },
+            ];
+            const match = findMatchingRoute(overlappingRoutes, "GET", "/overlapping");
+            expect(match?.handler).toBe(mockHandler); // Should match the first one
+        });
+    });
+});

package/dist/auth.d.ts

@@ -14,6 +14,10 @@ export interface AuthOptions {
     authBaseUrl?: string;
     authClientId?: string;
 }
+export interface ResolveAuthTokenOptions extends AuthOptions {
+    token?: string;
+    getToken?: () => Promise<string | undefined> | string | undefined;
+}
 /**
  * Gets the ZAPIER_TOKEN from environment variables.
  * Returns undefined if not set.
@@ -34,4 +38,15 @@ export declare function getTokenFromCliLogin(options?: AuthOptions): Promise<str
  * Returns undefined if no valid token is found.
  */
 export declare function getTokenFromEnvOrConfig(options?: AuthOptions): Promise<string | undefined>;
+/**
+ * Resolves an auth token from all possible sources with the following precedence:
+ * 1. Explicitly provided token in options
+ * 2. Token from getToken callback in options
+ * 3. ZAPIER_TOKEN environment variable
+ * 4. CLI login package (if available)
+ *
+ * This is the canonical token resolution logic used throughout the SDK.
+ * Returns undefined if no valid token is found.
+ */
+export declare function resolveAuthToken(options?: ResolveAuthTokenOptions): Promise<string | undefined>;
 //# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,YAAY,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAEpD;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS7B;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS7B"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,YAAY,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;CACnE;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAEpD;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS7B;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS7B;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB7B"}

package/dist/auth.js

@@ -45,3 +45,28 @@ export async function getTokenFromEnvOrConfig(options = {}) {
     // Second priority: CLI login package (if available)
     return getTokenFromCliLogin(options);
 }
+/**
+ * Resolves an auth token from all possible sources with the following precedence:
+ * 1. Explicitly provided token in options
+ * 2. Token from getToken callback in options
+ * 3. ZAPIER_TOKEN environment variable
+ * 4. CLI login package (if available)
+ *
+ * This is the canonical token resolution logic used throughout the SDK.
+ * Returns undefined if no valid token is found.
+ */
+export async function resolveAuthToken(options = {}) {
+    // First priority: explicitly provided token
+    if (options.token) {
+        return options.token;
+    }
+    // Second priority: getToken callback
+    if (options.getToken) {
+        const token = await options.getToken();
+        if (token) {
+            return token;
+        }
+    }
+    // Third and fourth priorities: environment variable or CLI login
+    return getTokenFromEnvOrConfig(options);
+}