@zapier/zapier-sdk 0.6.4 → 0.8.1

package/dist/index.d.mts

@@ -673,225 +673,6 @@ type InputFieldItem = z.infer<typeof InputFieldItemSchema>;
  */
 type UserProfileItem = z.infer<typeof UserProfileItemSchema>;
 
-/**
- * Function-related types and interfaces
- */
-interface FunctionOptions {
-    /** Base URL for Zapier API */
-    baseUrl?: string;
-    /** Authentication token */
-    token?: string;
-    /** Function to dynamically resolve authentication token */
-    getToken?: () => Promise<string | undefined>;
-    /** Optional pre-instantiated API client */
-    api?: any;
-    /** Enable debug logging */
-    debug?: boolean;
-    /** Custom fetch implementation */
-    fetch?: typeof globalThis.fetch;
-}
-type PaginatedSdkFunction<TOptions, TItem> = (options: TOptions) => Promise<{
-    data: TItem[];
-}> & AsyncIterable<{
-    data: TItem[];
-    nextCursor?: string;
-}> & {
-    items(): AsyncIterable<TItem>;
-};
-
-declare const AppKeyPropertySchema: z.ZodString;
-declare const ActionTypePropertySchema: z.ZodEnum<["read", "read_bulk", "write", "run", "search", "search_or_write", "search_and_write", "filter"]>;
-declare const ActionKeyPropertySchema: z.ZodString;
-declare const AuthenticationIdPropertySchema: z.ZodNumber;
-declare const InputsPropertySchema: z.ZodRecord<z.ZodString, z.ZodAny>;
-declare const LimitPropertySchema: z.ZodDefault<z.ZodNumber>;
-declare const OffsetPropertySchema: z.ZodDefault<z.ZodNumber>;
-declare const OutputPropertySchema: z.ZodString;
-declare const DebugPropertySchema: z.ZodDefault<z.ZodBoolean>;
-declare const ParamsPropertySchema: z.ZodRecord<z.ZodString, z.ZodAny>;
-type AppKeyProperty = z.infer<typeof AppKeyPropertySchema>;
-type ActionTypeProperty = z.infer<typeof ActionTypePropertySchema>;
-type ActionKeyProperty = z.infer<typeof ActionKeyPropertySchema>;
-type AuthenticationIdProperty = z.infer<typeof AuthenticationIdPropertySchema>;
-type InputsProperty = z.infer<typeof InputsPropertySchema>;
-type LimitProperty = z.infer<typeof LimitPropertySchema>;
-type OffsetProperty = z.infer<typeof OffsetPropertySchema>;
-type OutputProperty = z.infer<typeof OutputPropertySchema>;
-type DebugProperty = z.infer<typeof DebugPropertySchema>;
-type ParamsProperty = z.infer<typeof ParamsPropertySchema>;
-
-/**
- * Standard error format returned by the Zapier API
- */
-interface ApiError {
-    status: number;
-    code: string;
-    title: string;
-    detail: string;
-    source?: unknown;
-    meta?: unknown;
-}
-/**
- * Base options for all error constructors
- */
-interface ErrorOptions {
-    statusCode?: number;
-    errors?: ApiError[];
-    cause?: unknown;
-    response?: unknown;
-}
-/**
- * Base class for all Zapier SDK errors
- * Use instanceof ZapierError to check if an error is from the SDK
- */
-declare abstract class ZapierError extends Error {
-    abstract readonly name: string;
-    statusCode?: number;
-    errors?: ApiError[];
-    cause?: unknown;
-    response?: unknown;
-    constructor(message: string, options?: ErrorOptions);
-}
-/**
- * Error thrown when API requests fail
- */
-declare class ZapierApiError extends ZapierError {
-    readonly name = "ZapierApiError";
-    constructor(message: string, options?: ErrorOptions);
-}
-/**
- * Error thrown when an app is not found
- */
-declare class ZapierAppNotFoundError extends ZapierError {
-    readonly name = "ZapierAppNotFoundError";
-    appKey?: string;
-    constructor(message: string, options?: ErrorOptions & {
-        appKey?: string;
-    });
-}
-/**
- * Error thrown when validation fails (e.g., invalid parameters)
- */
-declare class ZapierValidationError extends ZapierError {
-    readonly name = "ZapierValidationError";
-    details?: unknown;
-    constructor(message: string, options?: ErrorOptions & {
-        details?: unknown;
-    });
-}
-/**
- * Error for unrecognized/unknown errors that get wrapped by safe functions
- */
-declare class ZapierUnknownError extends ZapierError {
-    readonly name = "ZapierUnknownError";
-    constructor(message: string, options?: ErrorOptions);
-}
-/**
- * Error thrown for authentication and authorization failures (401/403)
- */
-declare class ZapierAuthenticationError extends ZapierError {
-    readonly name = "ZapierAuthenticationError";
-    constructor(message: string, options?: ErrorOptions);
-}
-/**
- * Error thrown when a requested resource is not found
- */
-declare class ZapierResourceNotFoundError extends ZapierError {
-    readonly name = "ZapierResourceNotFoundError";
-    resourceType?: string;
-    resourceId?: string;
-    constructor(message: string, options?: ErrorOptions & {
-        resourceType?: string;
-        resourceId?: string;
-    });
-}
-/**
- * Error thrown when required app or implementation configuration is missing
- */
-declare class ZapierConfigurationError extends ZapierError {
-    readonly name = "ZapierConfigurationError";
-    configType?: string;
-    constructor(message: string, options?: ErrorOptions & {
-        configType?: string;
-    });
-}
-/**
- * Error thrown when code bundling or compilation fails
- */
-declare class ZapierBundleError extends ZapierError {
-    readonly name = "ZapierBundleError";
-    buildErrors?: string[];
-    constructor(message: string, options?: ErrorOptions & {
-        buildErrors?: string[];
-    });
-}
-/**
- * Error thrown when operations timeout or exceed retry limits
- */
-declare class ZapierTimeoutError extends ZapierError {
-    readonly name = "ZapierTimeoutError";
-    attempts?: number;
-    maxAttempts?: number;
-    constructor(message: string, options?: ErrorOptions & {
-        attempts?: number;
-        maxAttempts?: number;
-    });
-}
-/**
- * Error thrown when action execution fails due to errors returned from the third-party service
- * This happens when the Actions API returns a 200 status but includes errors in the response
- */
-declare class ZapierActionError extends ZapierError {
-    readonly name = "ZapierActionError";
-    appKey?: string;
-    actionKey?: string;
-    constructor(message: string, options?: ErrorOptions & {
-        appKey?: string;
-        actionKey?: string;
-    });
-    get actionErrors(): ApiError[] | undefined;
-}
-/**
- * Error thrown when a resource is not found (404)
- */
-declare class ZapierNotFoundError extends ZapierError {
-    readonly name = "ZapierNotFoundError";
-    constructor(message: string, options?: ErrorOptions);
-}
-/**
- * Utility function to format error messages for display
- */
-declare function formatErrorMessage(error: ZapierError): string;
-
-interface ActionExecutionOptions {
-    inputs?: Record<string, any>;
-    authenticationId?: number;
-}
-interface AppFactoryOptions {
-    authenticationId: number;
-}
-interface BaseActionTypeProxy {
-    [action: string]: (options?: ActionExecutionOptions) => unknown;
-}
-interface FetchActionType {
-    fetch: (url: string | URL, init?: RequestInit & {
-        authenticationId?: number;
-        callbackUrl?: string;
-        authenticationTemplate?: string;
-    }) => Promise<Response>;
-}
-type ActionTypeProxy = BaseActionTypeProxy & Partial<FetchActionType>;
-interface AppProxy {
-    [type: string]: ActionTypeProxy;
-}
-interface AppFactory {
-    (options: AppFactoryOptions): AppProxy;
-}
-type AppProxyWithFactory = AppFactory & AppProxy;
-interface ActionProxy {
-    [app: string]: AppProxyWithFactory;
-}
-
 /**
  * SDK Event System
  *
@@ -906,176 +687,29 @@ interface SdkEvent {
 interface AuthEvent extends SdkEvent {
     type: "auth_refreshing" | "auth_success" | "auth_error" | "auth_logout";
     payload?: {
-        message?: string;
-        error?: string;
-        operation?: string;
-    };
-}
-interface ApiEvent extends SdkEvent {
-    type: "api_request" | "api_response" | "api_error";
-    payload?: {
-        url?: string;
-        method?: string;
-        status?: number;
-        duration?: number;
-        error?: string;
-    };
-}
-interface LoadingEvent extends SdkEvent {
-    type: "loading_start" | "loading_end";
-    payload?: {
-        operation?: string;
-        resource?: string;
-    };
-}
-type EventCallback = (event: SdkEvent) => void;
-
-declare const ListInputFieldsSchema: z.ZodObject<{
-    appKey: z.ZodString;
-    actionType: z.ZodEnum<["read", "read_bulk", "write", "run", "search", "search_or_write", "search_and_write", "filter"]>;
-    actionKey: z.ZodString;
-    authenticationId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    pageSize: z.ZodOptional<z.ZodNumber>;
-    maxItems: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    appKey: string;
-    actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
-    actionKey: string;
-    authenticationId?: number | null | undefined;
-    inputs?: Record<string, any> | undefined;
-    pageSize?: number | undefined;
-    maxItems?: number | undefined;
-}, {
-    appKey: string;
-    actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
-    actionKey: string;
-    authenticationId?: number | null | undefined;
-    inputs?: Record<string, any> | undefined;
-    pageSize?: number | undefined;
-    maxItems?: number | undefined;
-}>;
-type ListInputFieldsOptions = z.infer<typeof ListInputFieldsSchema>;
-
-declare const GetAuthenticationSchema: z.ZodObject<{
-    authenticationId: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    authenticationId: number;
-}, {
-    authenticationId: number;
-}>;
-type GetAuthenticationOptions = z.infer<typeof GetAuthenticationSchema>;
-
-declare const FindFirstAuthenticationSchema: z.ZodObject<{
-    appKey: z.ZodOptional<z.ZodString>;
-    search: z.ZodOptional<z.ZodString>;
-    title: z.ZodOptional<z.ZodString>;
-    account_id: z.ZodOptional<z.ZodString>;
-    owner: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    title?: string | undefined;
-    search?: string | undefined;
-    account_id?: string | undefined;
-    appKey?: string | undefined;
-    owner?: string | undefined;
-}, {
-    title?: string | undefined;
-    search?: string | undefined;
-    account_id?: string | undefined;
-    appKey?: string | undefined;
-    owner?: string | undefined;
-}>;
-type FindFirstAuthenticationOptions = z.infer<typeof FindFirstAuthenticationSchema>;
-
-declare const FindUniqueAuthenticationSchema: z.ZodObject<{
-    appKey: z.ZodOptional<z.ZodString>;
-    search: z.ZodOptional<z.ZodString>;
-    title: z.ZodOptional<z.ZodString>;
-    account_id: z.ZodOptional<z.ZodString>;
-    owner: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    title?: string | undefined;
-    search?: string | undefined;
-    account_id?: string | undefined;
-    appKey?: string | undefined;
-    owner?: string | undefined;
-}, {
-    title?: string | undefined;
-    search?: string | undefined;
-    account_id?: string | undefined;
-    appKey?: string | undefined;
-    owner?: string | undefined;
-}>;
-type FindUniqueAuthenticationOptions = z.infer<typeof FindUniqueAuthenticationSchema>;
-
-declare const RelayRequestSchema: z.ZodObject<{
-    url: z.ZodString;
-    method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]>>;
-    body: z.ZodOptional<z.ZodAny>;
-    authenticationId: z.ZodOptional<z.ZodNumber>;
-    callbackUrl: z.ZodOptional<z.ZodString>;
-    authenticationTemplate: z.ZodOptional<z.ZodString>;
-    headers: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodString>, z.ZodType<Headers, z.ZodTypeDef, Headers>, z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>, "many">]>>;
-} & {
-    relayBaseUrl: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    url: string;
-    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
-    authenticationId?: number | undefined;
-    body?: any;
-    callbackUrl?: string | undefined;
-    authenticationTemplate?: string | undefined;
-    headers?: Record<string, string> | [string, string][] | Headers | undefined;
-    relayBaseUrl?: string | undefined;
-}, {
-    url: string;
-    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
-    authenticationId?: number | undefined;
-    body?: any;
-    callbackUrl?: string | undefined;
-    authenticationTemplate?: string | undefined;
-    headers?: Record<string, string> | [string, string][] | Headers | undefined;
-    relayBaseUrl?: string | undefined;
-}>;
-type RelayRequestOptions = z.infer<typeof RelayRequestSchema>;
-declare const RelayFetchSchema: z.ZodObject<{
-    url: z.ZodString;
-    method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]>>;
-    body: z.ZodOptional<z.ZodAny>;
-    authenticationId: z.ZodOptional<z.ZodNumber>;
-    callbackUrl: z.ZodOptional<z.ZodString>;
-    authenticationTemplate: z.ZodOptional<z.ZodString>;
-    headers: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodString>, z.ZodType<Headers, z.ZodTypeDef, Headers>, z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>, "many">]>>;
-} & {
-    relayBaseUrl: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    url: string;
-    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
-    authenticationId?: number | undefined;
-    body?: any;
-    callbackUrl?: string | undefined;
-    authenticationTemplate?: string | undefined;
-    headers?: Record<string, string> | [string, string][] | Headers | undefined;
-    relayBaseUrl?: string | undefined;
-}, {
-    url: string;
-    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
-    authenticationId?: number | undefined;
-    body?: any;
-    callbackUrl?: string | undefined;
-    authenticationTemplate?: string | undefined;
-    headers?: Record<string, string> | [string, string][] | Headers | undefined;
-    relayBaseUrl?: string | undefined;
-}>;
-
-declare const LockVersionSchema: z.ZodObject<{
-    appKey: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    appKey: string;
-}, {
-    appKey: string;
-}>;
-type LockVersionOptions = z.infer<typeof LockVersionSchema>;
+        message?: string;
+        error?: string;
+        operation?: string;
+    };
+}
+interface ApiEvent extends SdkEvent {
+    type: "api_request" | "api_response" | "api_error";
+    payload?: {
+        url?: string;
+        method?: string;
+        status?: number;
+        duration?: number;
+        error?: string;
+    };
+}
+interface LoadingEvent extends SdkEvent {
+    type: "loading_start" | "loading_end";
+    payload?: {
+        operation?: string;
+        resource?: string;
+    };
+}
+type EventCallback = (event: SdkEvent) => void;
 
 declare const NeedSchema: z.ZodObject<{
     key: z.ZodString;
@@ -2175,58 +1809,424 @@ declare const NeedsResponseSchema: z.ZodObject<{
 }>;
 
 /**
- * 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.
- *
- * API response model types are inferred from Zod schemas defined in api/schemas.ts
- * to ensure a single source of truth and eliminate duplication.
+ * 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.
+ *
+ * API response model types are inferred from Zod schemas defined in api/schemas.ts
+ * to ensure a single source of truth and eliminate duplication.
+ */
+
+interface ApiClient {
+    get: <T = unknown>(path: string, options?: RequestOptions) => Promise<T>;
+    post: <T = unknown>(path: string, data?: unknown, options?: RequestOptions) => Promise<T>;
+    put: <T = unknown>(path: string, data?: unknown, options?: RequestOptions) => Promise<T>;
+    delete: <T = unknown>(path: string, options?: RequestOptions) => Promise<T>;
+    poll: <T = unknown>(path: string, options?: PollOptions) => Promise<T>;
+    fetch: (path: string, init?: RequestInit & {
+        searchParams?: Record<string, string>;
+        authRequired?: boolean;
+    }) => Promise<Response>;
+}
+interface RequestOptions {
+    headers?: Record<string, string>;
+    searchParams?: Record<string, string>;
+    authRequired?: boolean;
+    customErrorHandler?: (errorInfo: {
+        status: number;
+        statusText: string;
+        data: unknown;
+    }) => Error | undefined;
+}
+interface PollOptions extends RequestOptions {
+    maxAttempts?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    successStatus?: number;
+    pendingStatus?: number;
+    resultExtractor?: (response: unknown) => unknown;
+}
+type Need = z.infer<typeof NeedSchema>;
+type Action = z.infer<typeof ActionSchema>;
+type Choice = z.infer<typeof ChoiceSchema>;
+type Field = z.infer<typeof FieldSchema>;
+type ActionExecutionResult = z.infer<typeof ActionExecutionResultSchema>;
+type ActionFieldChoice = z.infer<typeof ActionFieldChoiceSchema>;
+type ActionField = z.infer<typeof ActionFieldSchema>;
+type Authentication = z.infer<typeof AuthenticationSchema>;
+type AuthenticationsResponse = z.infer<typeof AuthenticationsResponseSchema>;
+type UserProfile = z.infer<typeof UserProfileSchema>;
+type App = z.infer<typeof AppSchema>;
+type NeedsRequest = z.infer<typeof NeedsRequestSchema>;
+type NeedsResponse = z.infer<typeof NeedsResponseSchema>;
+
+/**
+ * Function-related types and interfaces
+ */
+interface FunctionOptions {
+    /** Base URL for Zapier API */
+    baseUrl?: string;
+    /** Authentication token */
+    token?: string;
+    /** Function to dynamically resolve authentication token */
+    getToken?: () => Promise<string | undefined>;
+    /** Optional pre-instantiated API client */
+    api?: ApiClient;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Custom fetch implementation */
+    fetch?: typeof globalThis.fetch;
+}
+type PaginatedSdkFunction<TOptions, TItem> = (options: TOptions) => Promise<{
+    data: TItem[];
+}> & AsyncIterable<{
+    data: TItem[];
+    nextCursor?: string;
+}> & {
+    items(): AsyncIterable<TItem>;
+};
+
+declare const AppKeyPropertySchema: z.ZodString;
+declare const ActionTypePropertySchema: z.ZodEnum<["read", "read_bulk", "write", "run", "search", "search_or_write", "search_and_write", "filter"]>;
+declare const ActionKeyPropertySchema: z.ZodString;
+declare const AuthenticationIdPropertySchema: z.ZodNumber;
+declare const InputsPropertySchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+declare const LimitPropertySchema: z.ZodDefault<z.ZodNumber>;
+declare const OffsetPropertySchema: z.ZodDefault<z.ZodNumber>;
+declare const OutputPropertySchema: z.ZodString;
+declare const DebugPropertySchema: z.ZodDefault<z.ZodBoolean>;
+declare const ParamsPropertySchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+type AppKeyProperty = z.infer<typeof AppKeyPropertySchema>;
+type ActionTypeProperty = z.infer<typeof ActionTypePropertySchema>;
+type ActionKeyProperty = z.infer<typeof ActionKeyPropertySchema>;
+type AuthenticationIdProperty = z.infer<typeof AuthenticationIdPropertySchema>;
+type InputsProperty = z.infer<typeof InputsPropertySchema>;
+type LimitProperty = z.infer<typeof LimitPropertySchema>;
+type OffsetProperty = z.infer<typeof OffsetPropertySchema>;
+type OutputProperty = z.infer<typeof OutputPropertySchema>;
+type DebugProperty = z.infer<typeof DebugPropertySchema>;
+type ParamsProperty = z.infer<typeof ParamsPropertySchema>;
+
+/**
+ * Standard error format returned by the Zapier API
+ */
+interface ApiError {
+    status: number;
+    code: string;
+    title: string;
+    detail: string;
+    source?: unknown;
+    meta?: unknown;
+}
+/**
+ * Base options for all error constructors
+ */
+interface ErrorOptions {
+    statusCode?: number;
+    errors?: ApiError[];
+    cause?: unknown;
+    response?: unknown;
+}
+/**
+ * Base class for all Zapier SDK errors
+ * Use instanceof ZapierError to check if an error is from the SDK
+ */
+declare abstract class ZapierError extends Error {
+    abstract readonly name: string;
+    statusCode?: number;
+    errors?: ApiError[];
+    cause?: unknown;
+    response?: unknown;
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when API requests fail
+ */
+declare class ZapierApiError extends ZapierError {
+    readonly name = "ZapierApiError";
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when an app is not found
+ */
+declare class ZapierAppNotFoundError extends ZapierError {
+    readonly name = "ZapierAppNotFoundError";
+    appKey?: string;
+    constructor(message: string, options?: ErrorOptions & {
+        appKey?: string;
+    });
+}
+/**
+ * Error thrown when validation fails (e.g., invalid parameters)
+ */
+declare class ZapierValidationError extends ZapierError {
+    readonly name = "ZapierValidationError";
+    details?: unknown;
+    constructor(message: string, options?: ErrorOptions & {
+        details?: unknown;
+    });
+}
+/**
+ * Error for unrecognized/unknown errors that get wrapped by safe functions
+ */
+declare class ZapierUnknownError extends ZapierError {
+    readonly name = "ZapierUnknownError";
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown for authentication and authorization failures (401/403)
+ */
+declare class ZapierAuthenticationError extends ZapierError {
+    readonly name = "ZapierAuthenticationError";
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Error thrown when a requested resource is not found
+ */
+declare class ZapierResourceNotFoundError extends ZapierError {
+    readonly name = "ZapierResourceNotFoundError";
+    resourceType?: string;
+    resourceId?: string;
+    constructor(message: string, options?: ErrorOptions & {
+        resourceType?: string;
+        resourceId?: string;
+    });
+}
+/**
+ * Error thrown when required app or implementation configuration is missing
+ */
+declare class ZapierConfigurationError extends ZapierError {
+    readonly name = "ZapierConfigurationError";
+    configType?: string;
+    constructor(message: string, options?: ErrorOptions & {
+        configType?: string;
+    });
+}
+/**
+ * Error thrown when code bundling or compilation fails
+ */
+declare class ZapierBundleError extends ZapierError {
+    readonly name = "ZapierBundleError";
+    buildErrors?: string[];
+    constructor(message: string, options?: ErrorOptions & {
+        buildErrors?: string[];
+    });
+}
+/**
+ * Error thrown when operations timeout or exceed retry limits
+ */
+declare class ZapierTimeoutError extends ZapierError {
+    readonly name = "ZapierTimeoutError";
+    attempts?: number;
+    maxAttempts?: number;
+    constructor(message: string, options?: ErrorOptions & {
+        attempts?: number;
+        maxAttempts?: number;
+    });
+}
+/**
+ * Error thrown when action execution fails due to errors returned from the third-party service
+ * This happens when the Actions API returns a 200 status but includes errors in the response
+ */
+declare class ZapierActionError extends ZapierError {
+    readonly name = "ZapierActionError";
+    appKey?: string;
+    actionKey?: string;
+    constructor(message: string, options?: ErrorOptions & {
+        appKey?: string;
+        actionKey?: string;
+    });
+    get actionErrors(): ApiError[] | undefined;
+}
+/**
+ * Error thrown when a resource is not found (404)
+ */
+declare class ZapierNotFoundError extends ZapierError {
+    readonly name = "ZapierNotFoundError";
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Utility function to format error messages for display
  */
+declare function formatErrorMessage(error: ZapierError): string;
 
-interface ApiClient {
-    get: <T = unknown>(path: string, options?: RequestOptions) => Promise<T>;
-    post: <T = unknown>(path: string, data?: unknown, options?: RequestOptions) => Promise<T>;
-    put: <T = unknown>(path: string, data?: unknown, options?: RequestOptions) => Promise<T>;
-    delete: <T = unknown>(path: string, options?: RequestOptions) => Promise<T>;
-    poll: <T = unknown>(path: string, options?: PollOptions) => Promise<T>;
-    fetch: (path: string, init?: RequestInit & {
-        searchParams?: Record<string, string>;
-        authRequired?: boolean;
+interface ActionExecutionOptions {
+    inputs?: Record<string, any>;
+    authenticationId?: number;
+}
+interface AppFactoryOptions {
+    authenticationId: number;
+}
+interface BaseActionTypeProxy {
+    [action: string]: (options?: ActionExecutionOptions) => unknown;
+}
+interface FetchActionType {
+    fetch: (url: string | URL, init?: RequestInit & {
+        authenticationId?: number;
+        callbackUrl?: string;
+        authenticationTemplate?: string;
     }) => Promise<Response>;
 }
-interface RequestOptions {
-    headers?: Record<string, string>;
-    searchParams?: Record<string, string>;
-    authRequired?: boolean;
-    customErrorHandler?: (errorInfo: {
-        status: number;
-        statusText: string;
-        data: unknown;
-    }) => Error | undefined;
+type ActionTypeProxy = BaseActionTypeProxy & Partial<FetchActionType>;
+interface AppProxy {
+    [type: string]: ActionTypeProxy;
 }
-interface PollOptions extends RequestOptions {
-    maxAttempts?: number;
-    initialDelay?: number;
-    maxDelay?: number;
-    successStatus?: number;
-    pendingStatus?: number;
-    resultExtractor?: (response: unknown) => unknown;
+interface AppFactory {
+    (options: AppFactoryOptions): AppProxy;
 }
-type Need = z.infer<typeof NeedSchema>;
-type Action = z.infer<typeof ActionSchema>;
-type Choice = z.infer<typeof ChoiceSchema>;
-type Field = z.infer<typeof FieldSchema>;
-type ActionExecutionResult = z.infer<typeof ActionExecutionResultSchema>;
-type ActionFieldChoice = z.infer<typeof ActionFieldChoiceSchema>;
-type ActionField = z.infer<typeof ActionFieldSchema>;
-type Authentication = z.infer<typeof AuthenticationSchema>;
-type AuthenticationsResponse = z.infer<typeof AuthenticationsResponseSchema>;
-type UserProfile = z.infer<typeof UserProfileSchema>;
-type App = z.infer<typeof AppSchema>;
-type NeedsRequest = z.infer<typeof NeedsRequestSchema>;
-type NeedsResponse = z.infer<typeof NeedsResponseSchema>;
+type AppProxyWithFactory = AppFactory & AppProxy;
+interface ActionProxy {
+    [app: string]: AppProxyWithFactory;
+}
+
+declare const ListInputFieldsSchema: z.ZodObject<{
+    appKey: z.ZodString;
+    actionType: z.ZodEnum<["read", "read_bulk", "write", "run", "search", "search_or_write", "search_and_write", "filter"]>;
+    actionKey: z.ZodString;
+    authenticationId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    maxItems: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    appKey: string;
+    actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
+    actionKey: string;
+    authenticationId?: number | null | undefined;
+    inputs?: Record<string, unknown> | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
+}, {
+    appKey: string;
+    actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
+    actionKey: string;
+    authenticationId?: number | null | undefined;
+    inputs?: Record<string, unknown> | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
+}>;
+type ListInputFieldsOptions = z.infer<typeof ListInputFieldsSchema>;
+
+declare const GetAuthenticationSchema: z.ZodObject<{
+    authenticationId: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    authenticationId: number;
+}, {
+    authenticationId: number;
+}>;
+type GetAuthenticationOptions = z.infer<typeof GetAuthenticationSchema>;
+
+declare const FindFirstAuthenticationSchema: z.ZodObject<{
+    appKey: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    accountId: z.ZodOptional<z.ZodString>;
+    owner: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title?: string | undefined;
+    search?: string | undefined;
+    appKey?: string | undefined;
+    accountId?: string | undefined;
+    owner?: string | undefined;
+}, {
+    title?: string | undefined;
+    search?: string | undefined;
+    appKey?: string | undefined;
+    accountId?: string | undefined;
+    owner?: string | undefined;
+}>;
+type FindFirstAuthenticationOptions = z.infer<typeof FindFirstAuthenticationSchema>;
+
+declare const FindUniqueAuthenticationSchema: z.ZodObject<{
+    appKey: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    accountId: z.ZodOptional<z.ZodString>;
+    owner: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    title?: string | undefined;
+    search?: string | undefined;
+    appKey?: string | undefined;
+    accountId?: string | undefined;
+    owner?: string | undefined;
+}, {
+    title?: string | undefined;
+    search?: string | undefined;
+    appKey?: string | undefined;
+    accountId?: string | undefined;
+    owner?: string | undefined;
+}>;
+type FindUniqueAuthenticationOptions = z.infer<typeof FindUniqueAuthenticationSchema>;
+
+declare const RelayRequestSchema: z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]>>;
+    body: z.ZodOptional<z.ZodAny>;
+    authenticationId: z.ZodOptional<z.ZodNumber>;
+    callbackUrl: z.ZodOptional<z.ZodString>;
+    authenticationTemplate: z.ZodOptional<z.ZodString>;
+    headers: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodString>, z.ZodType<Headers, z.ZodTypeDef, Headers>, z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>, "many">]>>;
+} & {
+    relayBaseUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+    authenticationId?: number | undefined;
+    body?: any;
+    callbackUrl?: string | undefined;
+    authenticationTemplate?: string | undefined;
+    headers?: Record<string, string> | [string, string][] | Headers | undefined;
+    relayBaseUrl?: string | undefined;
+}, {
+    url: string;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+    authenticationId?: number | undefined;
+    body?: any;
+    callbackUrl?: string | undefined;
+    authenticationTemplate?: string | undefined;
+    headers?: Record<string, string> | [string, string][] | Headers | undefined;
+    relayBaseUrl?: string | undefined;
+}>;
+type RelayRequestOptions = z.infer<typeof RelayRequestSchema>;
+declare const RelayFetchSchema: z.ZodObject<{
+    url: z.ZodString;
+    method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"]>>;
+    body: z.ZodOptional<z.ZodAny>;
+    authenticationId: z.ZodOptional<z.ZodNumber>;
+    callbackUrl: z.ZodOptional<z.ZodString>;
+    authenticationTemplate: z.ZodOptional<z.ZodString>;
+    headers: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodString>, z.ZodType<Headers, z.ZodTypeDef, Headers>, z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString], null>, "many">]>>;
+} & {
+    relayBaseUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+    authenticationId?: number | undefined;
+    body?: any;
+    callbackUrl?: string | undefined;
+    authenticationTemplate?: string | undefined;
+    headers?: Record<string, string> | [string, string][] | Headers | undefined;
+    relayBaseUrl?: string | undefined;
+}, {
+    url: string;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS" | undefined;
+    authenticationId?: number | undefined;
+    body?: any;
+    callbackUrl?: string | undefined;
+    authenticationTemplate?: string | undefined;
+    headers?: Record<string, string> | [string, string][] | Headers | undefined;
+    relayBaseUrl?: string | undefined;
+}>;
+
+declare const LockVersionSchema: z.ZodObject<{
+    appKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    appKey: string;
+}, {
+    appKey: string;
+}>;
+type LockVersionOptions = z.infer<typeof LockVersionSchema>;
 
 declare const ListAppsSchema: z.ZodObject<{
     appKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -2519,7 +2519,7 @@ declare const RunActionSchema: z.ZodObject<{
     actionType: z.ZodEnum<["read", "read_bulk", "write", "run", "search", "search_or_write", "search_and_write", "filter"]>;
     actionKey: z.ZodString;
     authenticationId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     pageSize: z.ZodOptional<z.ZodNumber>;
     maxItems: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
@@ -2527,7 +2527,7 @@ declare const RunActionSchema: z.ZodObject<{
     actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
     actionKey: string;
     authenticationId?: number | null | undefined;
-    inputs?: Record<string, any> | undefined;
+    inputs?: Record<string, unknown> | undefined;
     pageSize?: number | undefined;
     maxItems?: number | undefined;
 }, {
@@ -2535,7 +2535,7 @@ declare const RunActionSchema: z.ZodObject<{
     actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
     actionKey: string;
     authenticationId?: number | null | undefined;
-    inputs?: Record<string, any> | undefined;
+    inputs?: Record<string, unknown> | undefined;
     pageSize?: number | undefined;
     maxItems?: number | undefined;
 }>;
@@ -2569,25 +2569,25 @@ declare const ListAuthenticationsSchema: z.ZodObject<{
     appKey: z.ZodOptional<z.ZodString>;
     search: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
-    account_id: z.ZodOptional<z.ZodString>;
+    accountId: z.ZodOptional<z.ZodString>;
     owner: z.ZodOptional<z.ZodString>;
     pageSize: z.ZodOptional<z.ZodNumber>;
     maxItems: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     title?: string | undefined;
     search?: string | undefined;
-    account_id?: string | undefined;
     appKey?: string | undefined;
     pageSize?: number | undefined;
     maxItems?: number | undefined;
+    accountId?: string | undefined;
     owner?: string | undefined;
 }, {
     title?: string | undefined;
     search?: string | undefined;
-    account_id?: string | undefined;
     appKey?: string | undefined;
     pageSize?: number | undefined;
     maxItems?: number | undefined;
+    accountId?: string | undefined;
     owner?: string | undefined;
 }>;
 type ListAuthenticationsOptions = z.infer<typeof ListAuthenticationsSchema>;
@@ -2923,12 +2923,80 @@ declare function getTokenFromCliLogin(options?: AuthOptions): Promise<string | u
  */
 declare function getTokenFromEnvOrConfig(options?: AuthOptions): Promise<string | undefined>;
 
+declare const InputFieldChoiceItemSchema: z.ZodObject<{
+    key: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    sample: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    value?: string | undefined;
+    key?: string | undefined;
+    label?: string | undefined;
+    sample?: string | undefined;
+}, {
+    value?: string | undefined;
+    key?: string | undefined;
+    label?: string | undefined;
+    sample?: string | undefined;
+}>;
+type InputFieldChoiceItem = z.infer<typeof InputFieldChoiceItemSchema>;
+declare const ListInputFieldChoicesSchema: z.ZodObject<{
+    appKey: z.ZodString;
+    actionType: z.ZodEnum<["read", "read_bulk", "write", "run", "search", "search_or_write", "search_and_write", "filter"]>;
+    actionKey: z.ZodString;
+    inputFieldKey: z.ZodString;
+    authenticationId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    page: z.ZodOptional<z.ZodNumber>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    maxItems: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    appKey: string;
+    actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
+    actionKey: string;
+    inputFieldKey: string;
+    page?: number | undefined;
+    authenticationId?: number | null | undefined;
+    inputs?: Record<string, unknown> | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
+}, {
+    appKey: string;
+    actionType: "filter" | "read" | "read_bulk" | "run" | "search" | "search_and_write" | "search_or_write" | "write";
+    actionKey: string;
+    inputFieldKey: string;
+    page?: number | undefined;
+    authenticationId?: number | null | undefined;
+    inputs?: Record<string, unknown> | undefined;
+    pageSize?: number | undefined;
+    maxItems?: number | undefined;
+}>;
+type ListInputFieldChoicesOptions = z.infer<typeof ListInputFieldChoicesSchema>;
+
+interface ListInputFieldChoicesPluginProvides {
+    listInputFieldChoices: (options: ListInputFieldChoicesOptions) => Promise<{
+        data: InputFieldChoiceItem[];
+    }> & AsyncIterable<{
+        data: InputFieldChoiceItem[];
+        nextCursor?: string;
+    }> & {
+        items(): AsyncIterable<InputFieldChoiceItem>;
+    };
+    context: {
+        meta: {
+            listInputFieldChoices: {
+                inputSchema: typeof ListInputFieldChoicesSchema;
+            };
+        };
+    };
+}
+
 interface ZapierSdkOptions extends BaseSdkOptions {
 }
 declare function createSdk<TCurrentSdk = {}, TCurrentContext = {
     meta: Record<string, PluginMeta>;
 }>(options?: ZapierSdkOptions, initialSdk?: TCurrentSdk, initialContext?: TCurrentContext): Sdk<TCurrentSdk, TCurrentContext>;
-declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): Sdk<ExtractSdkProperties<ApiPluginProvides> & ExtractSdkProperties<ListAppsPluginProvides> & ExtractSdkProperties<ManifestPluginProvides> & ExtractSdkProperties<GetAppPluginProvides> & ExtractSdkProperties<ListActionsPluginProvides> & ExtractSdkProperties<GetActionPluginProvides> & ExtractSdkProperties<ListInputFieldsPluginProvides> & ExtractSdkProperties<RunActionPluginProvides> & ExtractSdkProperties<LockVersionPluginProvides> & ExtractSdkProperties<ListAuthenticationsPluginProvides> & ExtractSdkProperties<GetAuthenticationPluginProvides> & ExtractSdkProperties<FindFirstAuthenticationPluginProvides> & ExtractSdkProperties<FindUniqueAuthenticationPluginProvides> & ExtractSdkProperties<RequestPluginProvides> & ExtractSdkProperties<FetchPluginProvides> & ExtractSdkProperties<AppsPluginProvides> & ExtractSdkProperties<GetProfilePluginProvides>, {
+declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): Sdk<ExtractSdkProperties<ApiPluginProvides> & ExtractSdkProperties<ListAppsPluginProvides> & ExtractSdkProperties<ManifestPluginProvides> & ExtractSdkProperties<GetAppPluginProvides> & ExtractSdkProperties<ListActionsPluginProvides> & ExtractSdkProperties<GetActionPluginProvides> & ExtractSdkProperties<ListInputFieldsPluginProvides> & ExtractSdkProperties<ListInputFieldChoicesPluginProvides> & ExtractSdkProperties<RunActionPluginProvides> & ExtractSdkProperties<LockVersionPluginProvides> & ExtractSdkProperties<ListAuthenticationsPluginProvides> & ExtractSdkProperties<GetAuthenticationPluginProvides> & ExtractSdkProperties<FindFirstAuthenticationPluginProvides> & ExtractSdkProperties<FindUniqueAuthenticationPluginProvides> & ExtractSdkProperties<RequestPluginProvides> & ExtractSdkProperties<FetchPluginProvides> & ExtractSdkProperties<AppsPluginProvides> & ExtractSdkProperties<GetProfilePluginProvides>, {
     meta: Record<string, PluginMeta>;
 } & {
     api: ApiClient;
@@ -2966,6 +3034,12 @@ declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): Sdk
             inputSchema: typeof ListInputFieldsSchema;
         };
     };
+} & {
+    meta: {
+        listInputFieldChoices: {
+            inputSchema: typeof ListInputFieldChoicesSchema;
+        };
+    };
 } & {
     meta: {
         runAction: {