@zapier/zapier-sdk 0.15.3 → 0.15.8

package/dist/plugins/getAuthentication/index.test.js

@@ -1,28 +1,28 @@
 import { describe, it, expect, vi, beforeEach } from "vitest";
-import { ZapierValidationError, ZapierAuthenticationError, ZapierResourceNotFoundError, } from "../../types/errors";
+import { ZapierValidationError } from "../../types/errors";
 import { getAuthenticationPlugin } from "./index";
 import { createSdk } from "../../sdk";
-import { manifestPlugin } from "../manifest";
-import { listAppsPlugin } from "../listApps";
-const mockAuthenticationResponse = {
+const mockAuthenticationItem = {
     id: 123,
     date: "2021-01-01",
     account_id: 456,
-    selected_api: "SlackCLIAPI@1.21.1",
+    implementation_id: "SlackCLIAPI@1.21.1",
     is_invite_only: false,
     is_private: false,
     shared_with_all: false,
-    is_stale: "false",
-    marked_stale_at: null,
+    is_expired: "false",
+    expired_at: null,
     label: "My Slack Workspace",
     title: "My Slack Workspace",
+    app_key: "SlackCLIAPI",
+    app_version: "1.21.1",
 };
 describe("getAuthentication plugin", () => {
     let mockApiClient;
     beforeEach(() => {
         vi.clearAllMocks();
         mockApiClient = {
-            get: vi.fn().mockResolvedValue(mockAuthenticationResponse),
+            get: vi.fn().mockResolvedValue({ data: mockAuthenticationItem }),
         };
     });
     const apiPlugin = () => ({
@@ -31,13 +31,9 @@ describe("getAuthentication plugin", () => {
         },
     });
     function createTestSdk() {
-        return createSdk()
-            .addPlugin(apiPlugin)
-            .addPlugin(manifestPlugin)
-            .addPlugin(listAppsPlugin)
-            .addPlugin(getAuthenticationPlugin);
+        return createSdk().addPlugin(apiPlugin).addPlugin(getAuthenticationPlugin);
     }
-    describe("schema validation", () => {
+    describe("input validation", () => {
         it("should throw validation error for missing authenticationId", async () => {
             const sdk = createTestSdk();
             await expect(sdk.getAuthentication({})).rejects.toThrow(ZapierValidationError);
@@ -60,157 +56,49 @@ describe("getAuthentication plugin", () => {
                 authenticationId: 0,
             })).rejects.toThrow(ZapierValidationError);
         });
-        it("should pass validation with valid authenticationId", async () => {
+        it("should accept valid authenticationId", async () => {
             const sdk = createTestSdk();
             const result = await sdk.getAuthentication({
                 authenticationId: 123,
             });
             expect(result.data).toBeDefined();
+            expect(result.data.id).toBe(123);
         });
     });
-    describe("API integration", () => {
-        it("should call the correct API endpoint", async () => {
+    describe("SDK API endpoint routing", () => {
+        it("should call the correct SDK API endpoint with path params", async () => {
             const sdk = createTestSdk();
             await sdk.getAuthentication({ authenticationId: 123 });
-            expect(mockApiClient.get).toHaveBeenCalledWith("/zapier/api/v4/authentications/123/", expect.objectContaining({
-                authRequired: true,
-                customErrorHandler: expect.any(Function),
-            }));
+            expect(mockApiClient.get).toHaveBeenCalledWith("/api/v0/authentications/123");
         });
-        it("should return normalized authentication data", async () => {
+        it("should return data from API response", async () => {
             const sdk = createTestSdk();
             const result = await sdk.getAuthentication({ authenticationId: 123 });
-            expect(result.data).toEqual({
-                id: 123,
-                date: "2021-01-01",
-                account_id: 456,
-                implementation_id: "SlackCLIAPI@1.21.1",
-                is_invite_only: false,
-                is_private: false,
-                shared_with_all: false,
-                is_expired: "false",
-                expired_at: null,
-                label: "My Slack Workspace",
-                title: "My Slack Workspace",
-                app_key: "SlackCLIAPI",
-                app_version: "1.21.1",
-                user_id: undefined, // customuser_id wasn't in mock data
-                is_stale: "false", // Original field preserved
-                marked_stale_at: null, // Original field preserved
-            });
-        });
-    });
-    describe("error handling", () => {
-        it("should throw ZapierAuthenticationError for 401 responses", async () => {
-            const customErrorHandler = vi
-                .fn()
-                .mockReturnValue(new ZapierAuthenticationError("Authentication failed. Your token may not have permission to access authentications or may be expired. (HTTP 401)", { statusCode: 401 }));
-            mockApiClient.get = vi.fn().mockImplementation(() => {
-                const error = customErrorHandler({ status: 401 });
-                throw error;
-            });
-            const sdk = createTestSdk();
-            await expect(sdk.getAuthentication({ authenticationId: 123 })).rejects.toThrow(ZapierAuthenticationError);
-        });
-        it("should throw ZapierAuthenticationError for 403 responses", async () => {
-            const customErrorHandler = vi
-                .fn()
-                .mockReturnValue(new ZapierAuthenticationError("Access forbidden. Your token may not have the required scopes to get authentication 123. (HTTP 403)", { statusCode: 403 }));
-            mockApiClient.get = vi.fn().mockImplementation(() => {
-                const error = customErrorHandler({ status: 403 });
-                throw error;
-            });
-            const sdk = createTestSdk();
-            await expect(sdk.getAuthentication({ authenticationId: 123 })).rejects.toThrow(ZapierAuthenticationError);
-        });
-        it("should throw ZapierResourceNotFoundError for 404 responses", async () => {
-            const customErrorHandler = vi.fn().mockReturnValue(new ZapierResourceNotFoundError("Authentication 123 not found. It may not exist or you may not have access to it. (HTTP 404)", {
-                resourceType: "Authentication",
-                resourceId: "123",
-            }));
-            mockApiClient.get = vi.fn().mockImplementation(() => {
-                const error = customErrorHandler({ status: 404 });
-                throw error;
-            });
-            const sdk = createTestSdk();
-            await expect(sdk.getAuthentication({ authenticationId: 123 })).rejects.toThrow(ZapierResourceNotFoundError);
-        });
-        it("should handle network errors", async () => {
-            mockApiClient.get = vi.fn().mockRejectedValue(new Error("Network error"));
-            const sdk = createTestSdk();
-            await expect(sdk.getAuthentication({ authenticationId: 123 })).rejects.toThrow("Network error");
+            expect(result.data).toEqual(mockAuthenticationItem);
         });
     });
-    describe("data transformation", () => {
-        it("should map is_stale to is_expired and marked_stale_at to expired_at", async () => {
-            const authWithExpiration = {
-                ...mockAuthenticationResponse,
-                is_stale: "true",
-                marked_stale_at: "2021-06-01",
-            };
-            mockApiClient.get = vi.fn().mockResolvedValue(authWithExpiration);
-            const sdk = createTestSdk();
-            const result = await sdk.getAuthentication({ authenticationId: 123 });
-            expect(result.data.is_expired).toBe("true");
-            expect(result.data.expired_at).toBe("2021-06-01");
-        });
-        it("should preserve all original authentication fields", async () => {
-            const authWithAllFields = {
-                id: 123,
-                date: "2021-01-01",
-                lastchanged: "2021-01-02",
-                account_id: 456,
-                customuser_id: 789,
-                selected_api: "SlackCLIAPI@1.21.1",
-                destination_selected_api: "SlackDestAPI@1.0.0",
-                is_invite_only: true,
-                is_private: true,
-                shared_with_all: false,
-                is_stale: "true",
-                is_shared: "false",
-                marked_stale_at: "2021-06-01",
-                label: "Auth Label",
-                title: "Auth Title",
-                identifier: "auth-identifier",
-                url: "https://example.com",
-                groups: "group1,group2",
-                members: "user1,user2",
-                permissions: { read: true, write: false },
-            };
-            mockApiClient.get = vi.fn().mockResolvedValue(authWithAllFields);
+    describe("error propagation", () => {
+        it("should propagate errors from API client", async () => {
+            mockApiClient.get = vi.fn().mockRejectedValue(new Error("API error"));
             const sdk = createTestSdk();
-            const result = await sdk.getAuthentication({ authenticationId: 123 });
-            const auth = result.data;
-            // Verify original fields are preserved
-            expect(auth.id).toBe(123);
-            expect(auth.date).toBe("2021-01-01");
-            expect(auth.lastchanged).toBe("2021-01-02");
-            expect(auth.account_id).toBe(456);
-            expect(auth.user_id).toBe(789);
-            expect(auth.implementation_id).toBe("SlackCLIAPI@1.21.1");
-            expect(auth.destination_selected_api).toBe("SlackDestAPI@1.0.0");
-            expect(auth.is_invite_only).toBe(true);
-            expect(auth.is_private).toBe(true);
-            expect(auth.shared_with_all).toBe(false);
-            expect(auth.is_shared).toBe("false");
-            expect(auth.label).toBe("Auth Label");
-            expect(auth.title).toBe("Auth Title");
-            expect(auth.identifier).toBe("auth-identifier");
-            expect(auth.url).toBe("https://example.com");
-            expect(auth.groups).toBe("group1,group2");
-            expect(auth.members).toBe("user1,user2");
-            expect(auth.permissions).toEqual({ read: true, write: false });
-            // Verify mapped fields
-            expect(auth.is_expired).toBe("true");
-            expect(auth.expired_at).toBe("2021-06-01");
+            await expect(sdk.getAuthentication({ authenticationId: 123 })).rejects.toThrow("API error");
         });
     });
-    describe("context and metadata", () => {
-        it("should provide context with meta information", () => {
+    describe("plugin metadata", () => {
+        it("should provide metadata in SDK context", () => {
             const sdk = createTestSdk();
             const context = sdk.getContext();
             expect(context.meta.getAuthentication).toBeDefined();
             expect(context.meta.getAuthentication.inputSchema).toBeDefined();
+            expect(context.meta.getAuthentication.outputSchema).toBeDefined();
+            expect(context.meta.getAuthentication.type).toBe("item");
+            expect(context.meta.getAuthentication.itemType).toBe("Authentication");
+        });
+        it("should include resolvers in metadata", () => {
+            const sdk = createTestSdk();
+            const context = sdk.getContext();
+            expect(context.meta.getAuthentication.resolvers).toBeDefined();
+            expect(context.meta.getAuthentication.resolvers.authenticationId).toBeDefined();
         });
     });
 });

package/dist/plugins/getAuthentication/schemas.d.ts

@@ -1,18 +1,9 @@
-import { z } from "zod";
-import type { AuthenticationItem } from "../../types/domain";
+import type { GetAuthenticationResponse } from "../../temporary-internal-core";
 import type { ZapierAuthenticationError, ZapierResourceNotFoundError, ZapierApiError, ZapierValidationError, ZapierUnknownError } from "../../types/errors";
-export declare const GetAuthenticationSchema: z.ZodObject<{
-    authenticationId: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    authenticationId: number;
-}, {
-    authenticationId: number;
-}>;
-export type GetAuthenticationOptions = z.infer<typeof GetAuthenticationSchema>;
+import type { GetAuthenticationOptions } from "../../temporary-internal-core/schemas/authentications";
+export { GetAuthenticationOptionsSchema as GetAuthenticationSchema, GetAuthenticationHandlerRequestSchema, GetAuthenticationResponseSchema, type GetAuthenticationOptions, type GetAuthenticationHandlerRequest, type GetAuthenticationResponse, } from "../../temporary-internal-core/schemas/authentications";
 export type GetAuthenticationError = ZapierAuthenticationError | ZapierResourceNotFoundError | ZapierApiError | ZapierValidationError | ZapierUnknownError;
 export interface GetAuthenticationSdkFunction {
-    getAuthentication: (options: GetAuthenticationOptions) => Promise<{
-        data: AuthenticationItem;
-    }>;
+    getAuthentication: (options: GetAuthenticationOptions) => Promise<GetAuthenticationResponse>;
 }
 //# sourceMappingURL=schemas.d.ts.map

package/dist/plugins/getAuthentication/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/getAuthentication/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EACV,yBAAyB,EACzB,2BAA2B,EAC3B,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAG5B,eAAO,MAAM,uBAAuB;;;;;;EAQc,CAAC;AAGnD,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAG/E,MAAM,MAAM,sBAAsB,GAC9B,yBAAyB,GACzB,2BAA2B,GAC3B,cAAc,GACd,qBAAqB,GACrB,kBAAkB,CAAC;AAGvB,MAAM,WAAW,4BAA4B;IAC3C,iBAAiB,EAAE,CACjB,OAAO,EAAE,wBAAwB,KAC9B,OAAO,CAAC;QAAE,IAAI,EAAE,kBAAkB,CAAA;KAAE,CAAC,CAAC;CAC5C"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/plugins/getAuthentication/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,KAAK,EACV,yBAAyB,EACzB,2BAA2B,EAC3B,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uDAAuD,CAAC;AAEtG,OAAO,EACL,8BAA8B,IAAI,uBAAuB,EACzD,qCAAqC,EACrC,+BAA+B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,GAC/B,MAAM,uDAAuD,CAAC;AAG/D,MAAM,MAAM,sBAAsB,GAC9B,yBAAyB,GACzB,2BAA2B,GAC3B,cAAc,GACd,qBAAqB,GACrB,kBAAkB,CAAC;AAGvB,MAAM,WAAW,4BAA4B;IAC3C,iBAAiB,EAAE,CACjB,OAAO,EAAE,wBAAwB,KAC9B,OAAO,CAAC,yBAAyB,CAAC,CAAC;CACzC"}

package/dist/plugins/getAuthentication/schemas.js

@@ -1,11 +1 @@
-import { z } from "zod";
-// Pure Zod schema - no resolver metadata!
-export const GetAuthenticationSchema = z
-    .object({
-    authenticationId: z
-        .number()
-        .int()
-        .positive()
-        .describe("Authentication ID to retrieve"),
-})
-    .describe("Get a specific authentication by ID");
+export { GetAuthenticationOptionsSchema as GetAuthenticationSchema, GetAuthenticationHandlerRequestSchema, GetAuthenticationResponseSchema, } from "../../temporary-internal-core/schemas/authentications";

package/dist/schemas/Action.d.ts

@@ -8,7 +8,7 @@ export declare const ActionItemSchema: z.ZodObject<Omit<{
     is_important: z.ZodOptional<z.ZodBoolean>;
     is_hidden: z.ZodOptional<z.ZodBoolean>;
     selected_api: z.ZodOptional<z.ZodString>;
-}, "type" | "name" | "selected_api"> & {
+}, "type" | "selected_api" | "name"> & {
     app_key: z.ZodString;
     app_version: z.ZodOptional<z.ZodString>;
     action_type: z.ZodEnum<["filter", "read", "read_bulk", "run", "search", "search_and_write", "search_or_write", "write"]>;

package/dist/schemas/Auth.d.ts

@@ -20,7 +20,7 @@ export declare const AuthenticationItemSchema: z.ZodObject<Omit<{
     groups: z.ZodOptional<z.ZodString>;
     members: z.ZodOptional<z.ZodString>;
     permissions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
-}, "selected_api" | "customuser_id"> & {
+}, "customuser_id" | "selected_api"> & {
     implementation_id: z.ZodOptional<z.ZodString>;
     is_expired: z.ZodOptional<z.ZodString>;
     expired_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -28,9 +28,9 @@ export declare const AuthenticationItemSchema: z.ZodObject<Omit<{
     app_version: z.ZodOptional<z.ZodString>;
     user_id: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    account_id: number;
     id: number;
     date: string;
-    account_id: number;
     is_invite_only: boolean;
     is_private: boolean;
     shared_with_all: boolean;
@@ -53,9 +53,9 @@ export declare const AuthenticationItemSchema: z.ZodObject<Omit<{
     app_key?: string | undefined;
     app_version?: string | undefined;
 }, {
+    account_id: number;
     id: number;
     date: string;
-    account_id: number;
     is_invite_only: boolean;
     is_private: boolean;
     shared_with_all: boolean;
@@ -99,7 +99,7 @@ export declare const AuthItemSchema: z.ZodObject<Omit<{
     groups: z.ZodOptional<z.ZodString>;
     members: z.ZodOptional<z.ZodString>;
     permissions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
-}, "selected_api" | "customuser_id"> & {
+}, "customuser_id" | "selected_api"> & {
     implementation_id: z.ZodOptional<z.ZodString>;
     is_expired: z.ZodOptional<z.ZodString>;
     expired_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -107,9 +107,9 @@ export declare const AuthItemSchema: z.ZodObject<Omit<{
     app_version: z.ZodOptional<z.ZodString>;
     user_id: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    account_id: number;
     id: number;
     date: string;
-    account_id: number;
     is_invite_only: boolean;
     is_private: boolean;
     shared_with_all: boolean;
@@ -132,9 +132,9 @@ export declare const AuthItemSchema: z.ZodObject<Omit<{
     app_key?: string | undefined;
     app_version?: string | undefined;
 }, {
+    account_id: number;
     id: number;
     date: string;
-    account_id: number;
     is_invite_only: boolean;
     is_private: boolean;
     shared_with_all: boolean;

package/dist/sdk.d.ts

@@ -100,7 +100,7 @@ export declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOption
 } & {
     meta: {
         getAuthentication: {
-            inputSchema: typeof import("./plugins/getAuthentication/schemas").GetAuthenticationSchema;
+            inputSchema: typeof import("./temporary-internal-core").GetAuthenticationOptionsSchema;
         };
     };
 } & {

package/dist/temporary-internal-core/handlers/getAuthentication.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Handler for getAuthentication operation
+ *
+ * This handler will become an SDK API endpoint handler.
+ * It encapsulates the business logic for retrieving a single authentication, including:
+ * - API call to internal authentication endpoint
+ * - Custom error handling (401, 403, 404)
+ * - Response transformation (field renaming, computed fields)
+ *
+ * The handler receives a validated authentication ID and returns normalized data.
+ */
+import type { Handler, HandlerDeps } from "../types";
+import { type GetAuthenticationHandlerRequest, type GetAuthenticationResponse } from "../schemas/authentications";
+/**
+ * Simple HTTP client interface for calling internal APIs
+ *
+ * Why pass this as a dependency instead of importing directly?
+ *
+ * 1. **Different implementations in different contexts:**
+ *    - In the SDK: Uses the ApiClient wrapper (adds auth, error handling, etc.)
+ *    - In the SDK API: Would use internal HTTP client or direct service calls
+ *
+ * 2. **Testability:**
+ *    - Can mock httpClient in tests without complex setup
+ *    - Can verify API calls and responses in isolation
+ *
+ * 3. **No hard coupling:**
+ *    - Handler doesn't know/care how HTTP calls are made
+ *    - Makes migration to SDK API easier (just swap implementation)
+ */
+export interface HttpClient {
+    get<T = unknown>(path: string, options?: {
+        searchParams?: Record<string, string>;
+        authRequired?: boolean;
+        customErrorHandler?: (errorInfo: {
+            status: number;
+            statusText: string;
+            data: unknown;
+        }) => Error | undefined;
+    }): Promise<T>;
+    post<T = unknown>(path: string, data?: unknown, options?: {
+        authRequired?: boolean;
+        customErrorHandler?: (errorInfo: {
+            status: number;
+            statusText: string;
+            data: unknown;
+        }) => Error | undefined;
+    }): Promise<T>;
+    delete<T = unknown>(path: string, options?: {
+        authRequired?: boolean;
+        customErrorHandler?: (errorInfo: {
+            status: number;
+            statusText: string;
+            data: unknown;
+        }) => Error | undefined;
+    }): Promise<T>;
+}
+/**
+ * Dependencies required by the getAuthentication handler
+ *
+ * Passed as a parameter (dependency injection) rather than imported directly
+ * to allow different implementations in different environments:
+ * - SDK plugin injects: { httpClient: api } (SDK's ApiClient)
+ * - SDK API would inject: { httpClient: internalHttpClient } (direct internal calls)
+ * - Tests inject: { httpClient: mockHttpClient } (mocked responses)
+ *
+ * Extends HandlerDeps to ensure compatibility with the Handler interface.
+ */
+export interface GetAuthenticationHandlerDeps extends HandlerDeps {
+    httpClient: HttpClient;
+}
+/**
+ * Handles getAuthentication operation
+ *
+ * Conforms to the Handler<TRequest, TResponse, TDeps> interface contract.
+ *
+ * Flow:
+ * 1. Validates request (schema validation happens at plugin boundary)
+ * 2. Makes API call to /authentications/{id}/ with custom error handler
+ * 3. Transforms response to normalized AuthenticationItem
+ * 4. Returns wrapped in { data } envelope
+ *
+ * Error handling:
+ * - 401: Authentication error (invalid/expired token)
+ * - 403: Forbidden (insufficient scopes)
+ * - 404: Authentication not found
+ * - Other: Propagates original error
+ *
+ * @param request - The authentication ID to retrieve
+ * @param deps - Dependencies injected by the caller (httpClient)
+ * @returns Single authentication item wrapped in data envelope
+ */
+export declare const handleGetAuthentication: Handler<GetAuthenticationHandlerRequest, GetAuthenticationResponse, GetAuthenticationHandlerDeps>;
+//# sourceMappingURL=getAuthentication.d.ts.map

package/dist/temporary-internal-core/handlers/getAuthentication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAuthentication.d.ts","sourceRoot":"","sources":["../../../src/temporary-internal-core/handlers/getAuthentication.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAEL,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAE/B,MAAM,4BAA4B,CAAC;AAOpC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,CAAC,GAAG,OAAO,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE;YAC/B,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,IAAI,EAAE,OAAO,CAAC;SACf,KAAK,KAAK,GAAG,SAAS,CAAC;KACzB,GACA,OAAO,CAAC,CAAC,CAAC,CAAC;IAEd,IAAI,CAAC,CAAC,GAAG,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE;YAC/B,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,IAAI,EAAE,OAAO,CAAC;SACf,KAAK,KAAK,GAAG,SAAS,CAAC;KACzB,GACA,OAAO,CAAC,CAAC,CAAC,CAAC;IAEd,MAAM,CAAC,CAAC,GAAG,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE;YAC/B,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;YACnB,IAAI,EAAE,OAAO,CAAC;SACf,KAAK,KAAK,GAAG,SAAS,CAAC;KACzB,GACA,OAAO,CAAC,CAAC,CAAC,CAAC;CACf;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,4BAA6B,SAAQ,WAAW;IAC/D,UAAU,EAAE,UAAU,CAAC;CACxB;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,uBAAuB,EAAE,OAAO,CAC3C,+BAA+B,EAC/B,yBAAyB,EACzB,4BAA4B,CA8C7B,CAAC"}

package/dist/temporary-internal-core/handlers/getAuthentication.js

@@ -0,0 +1,68 @@
+/**
+ * Handler for getAuthentication operation
+ *
+ * This handler will become an SDK API endpoint handler.
+ * It encapsulates the business logic for retrieving a single authentication, including:
+ * - API call to internal authentication endpoint
+ * - Custom error handling (401, 403, 404)
+ * - Response transformation (field renaming, computed fields)
+ *
+ * The handler receives a validated authentication ID and returns normalized data.
+ */
+import { GetAuthenticationHandlerRequestSchema, } from "../schemas/authentications";
+import { ZapierAuthenticationError, ZapierResourceNotFoundError, } from "../schemas/errors";
+import { normalizeAuthenticationItem } from "../utils/transformations";
+// ============================================================================
+// Handler Implementation
+// ============================================================================
+/**
+ * Handles getAuthentication operation
+ *
+ * Conforms to the Handler<TRequest, TResponse, TDeps> interface contract.
+ *
+ * Flow:
+ * 1. Validates request (schema validation happens at plugin boundary)
+ * 2. Makes API call to /authentications/{id}/ with custom error handler
+ * 3. Transforms response to normalized AuthenticationItem
+ * 4. Returns wrapped in { data } envelope
+ *
+ * Error handling:
+ * - 401: Authentication error (invalid/expired token)
+ * - 403: Forbidden (insufficient scopes)
+ * - 404: Authentication not found
+ * - Other: Propagates original error
+ *
+ * @param request - The authentication ID to retrieve
+ * @param deps - Dependencies injected by the caller (httpClient)
+ * @returns Single authentication item wrapped in data envelope
+ */
+export const handleGetAuthentication = async ({ request, deps }) => {
+    // Validate and normalize request at handler boundary
+    const validatedRequest = GetAuthenticationHandlerRequestSchema.parse(request);
+    const { httpClient } = deps;
+    const { authenticationId } = validatedRequest;
+    // Make API call with custom error handling
+    const authentication = await httpClient.get(`/zapier/api/v4/authentications/${authenticationId}/`, {
+        authRequired: true,
+        customErrorHandler: ({ status }) => {
+            if (status === 401) {
+                return new ZapierAuthenticationError(`Authentication failed. Your token may not have permission to access authentications or may be expired. (HTTP ${status})`, { statusCode: status });
+            }
+            if (status === 403) {
+                return new ZapierAuthenticationError(`Access forbidden. Your token may not have the required scopes to get authentication ${authenticationId}. (HTTP ${status})`, { statusCode: status });
+            }
+            if (status === 404) {
+                return new ZapierResourceNotFoundError(`Authentication ${authenticationId} not found. It may not exist or you may not have access to it. (HTTP ${status})`, {
+                    resourceType: "Authentication",
+                    resourceId: String(authenticationId),
+                });
+            }
+            return undefined; // Let default error handling take over
+        },
+    });
+    // Transform to normalized AuthenticationItem
+    const normalizedAuthentication = normalizeAuthenticationItem(authentication);
+    return {
+        data: normalizedAuthentication,
+    };
+};

package/dist/temporary-internal-core/handlers/getAuthentication.test.d.ts

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

package/dist/temporary-internal-core/handlers/getAuthentication.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getAuthentication.test.d.ts","sourceRoot":"","sources":["../../../src/temporary-internal-core/handlers/getAuthentication.test.ts"],"names":[],"mappings":""}