@zapier/zapier-sdk 0.30.0 → 0.31.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @zapier/zapier-sdk
 
+## 0.31.0
+
+### Minor Changes
+
+- 4a874c6: Add Zod schema for base SDK options, autodoc generation for SDK factory options and CLI base command options
+
 ## 0.30.0
 
 ### Minor Changes

package/README.md

@@ -6,6 +6,7 @@
 - [Documentation](#documentation)
 - [Installation](#installation)
 - [Quick Start](#quick-start)
+- [Factory](#factory)
 - [Available Functions](#available-functions)
 - [Accounts](#accounts)
   - [`getProfile`](#getprofile)
@@ -289,6 +290,19 @@ const emojiData = await emojiResponse.json();
 console.log(emojiData.emoji);
 ```
 
+## Factory
+
+The `createZapierSdk(...)` factory function is the main entry point for the SDK. It provides methods for managing connections, listing apps, running actions, and more.
+
+| Name                     | Type                       | Required | Default | Possible Values | Description                                                                                                                                                                                   |
+| ------------------------ | -------------------------- | -------- | ------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `credentials`            | `string, object, function` | ❌       | —       | —               | Authentication credentials. Can be a string (token or API key), a client credentials object ({ clientId, clientSecret }), a PKCE object ({ clientId }), or a function returning any of those. |
+| `debug`                  | `boolean`                  | ❌       | —       | —               | Enable debug logging.                                                                                                                                                                         |
+| `baseUrl`                | `string`                   | ❌       | —       | —               | Base URL for Zapier API endpoints.                                                                                                                                                            |
+| `trackingBaseUrl`        | `string`                   | ❌       | —       | —               | Base URL for Zapier tracking endpoints.                                                                                                                                                       |
+| `maxNetworkRetries`      | `number`                   | ❌       | —       | —               | Max retries for rate-limited requests (default: 3).                                                                                                                                           |
+| `maxNetworkRetryDelayMs` | `number`                   | ❌       | —       | —               | Max delay in ms to wait for retry (default: 60000).                                                                                                                                           |
+
 ## Available Functions
 
 ### Accounts
@@ -872,15 +886,15 @@ Make authenticated HTTP requests to any API through Zapier. Pass a connectionId
 
 **Parameters:**
 
-| Name             | Type                             | Required | Default | Possible Values                                            | Description                                                                                         |
-| ---------------- | -------------------------------- | -------- | ------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
-| `url`            | `string, custom`                 | ✅       | —       | —                                                          | The full URL of the API endpoint to call (proxied through Zapier's Relay service)                   |
-| `init`           | `object`                         | ❌       | —       | —                                                          | Request options including method, headers, body, and authentication                                 |
-| ↳ `method`       | `string`                         | ❌       | —       | `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HEAD`, `OPTIONS` | HTTP method for the request (defaults to GET)                                                       |
-| ↳ `headers`      | `object`                         | ❌       | —       | —                                                          | HTTP headers to include in the request                                                              |
-| ↳ `body`         | `string, custom, custom, record` | ❌       | —       | —                                                          | Request body — plain objects and JSON strings are auto-detected and Content-Type is set accordingly |
-| ↳ `connectionId` | `string, number`                 | ❌       | —       | —                                                          | Connection ID to use for this action                                                                |
-| ↳ `callbackUrl`  | `string`                         | ❌       | —       | —                                                          | URL to send async response to (makes request async)                                                 |
+| Name             | Type                     | Required | Default | Possible Values                                            | Description                                                                                         |
+| ---------------- | ------------------------ | -------- | ------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
+| `url`            | `string, custom`         | ✅       | —       | —                                                          | The full URL of the API endpoint to call (proxied through Zapier's Relay service)                   |
+| `init`           | `object`                 | ❌       | —       | —                                                          | Request options including method, headers, body, and authentication                                 |
+| ↳ `method`       | `string`                 | ❌       | —       | `GET`, `POST`, `PUT`, `DELETE`, `PATCH`, `HEAD`, `OPTIONS` | HTTP method for the request (defaults to GET)                                                       |
+| ↳ `headers`      | `object`                 | ❌       | —       | —                                                          | HTTP headers to include in the request                                                              |
+| ↳ `body`         | `string, custom, record` | ❌       | —       | —                                                          | Request body — plain objects and JSON strings are auto-detected and Content-Type is set accordingly |
+| ↳ `connectionId` | `string, number`         | ❌       | —       | —                                                          | Connection ID to use for this action                                                                |
+| ↳ `callbackUrl`  | `string`                 | ❌       | —       | —                                                          | URL to send async response to (makes request async)                                                 |
 
 **Returns:** `Promise<Response>`
 

package/dist/api/schemas.d.ts

@@ -42,8 +42,8 @@ export declare const NeedSchema: z.ZodObject<{
     type: z.ZodOptional<z.ZodEnum<{
         string: "string";
         boolean: "boolean";
-        filter: "filter";
         file: "file";
+        filter: "filter";
         integer: "integer";
         text: "text";
         datetime: "datetime";
@@ -286,8 +286,8 @@ export declare const NeedsResponseSchema: z.ZodObject<{
         type: z.ZodOptional<z.ZodEnum<{
             string: "string";
             boolean: "boolean";
-            filter: "filter";
             file: "file";
+            filter: "filter";
             integer: "integer";
             text: "text";
             datetime: "datetime";

package/dist/index.cjs

@@ -3919,8 +3919,34 @@ async function pollUntilComplete(options) {
     }
   }
 }
-
-// src/types/credentials.ts
+var ClientCredentialsObjectSchema = zod.z.object({
+  type: zod.z.enum(["client_credentials"]).optional().meta({ internal: true }),
+  clientId: zod.z.string().describe("OAuth client ID for authentication.").meta({ valueHint: "id" }),
+  clientSecret: zod.z.string().describe("OAuth client secret for authentication.").meta({ valueHint: "secret" }),
+  baseUrl: zod.z.string().optional().describe("Override authentication base URL.").meta({ valueHint: "url" }),
+  scope: zod.z.string().optional().describe("Authentication scope.").meta({ internal: true })
+});
+var PkceCredentialsObjectSchema = zod.z.object({
+  type: zod.z.enum(["pkce"]).optional().meta({ internal: true }),
+  clientId: zod.z.string().describe("OAuth client ID for authentication.").meta({ valueHint: "id" }),
+  baseUrl: zod.z.string().optional().describe("Override authentication base URL.").meta({ valueHint: "url" }),
+  scope: zod.z.string().optional().describe("Authentication scope.").meta({ internal: true })
+});
+var CredentialsObjectSchema = zod.z.union([
+  ClientCredentialsObjectSchema,
+  PkceCredentialsObjectSchema
+]);
+var ResolvedCredentialsSchema = zod.z.union([
+  zod.z.string().describe("Authentication token.").meta({ valueHint: "token" }),
+  CredentialsObjectSchema
+]);
+var CredentialsFunctionSchema = zod.z.function().input([]).output(
+  zod.z.union([ResolvedCredentialsSchema, zod.z.promise(ResolvedCredentialsSchema)])
+);
+var CredentialsSchema = zod.z.union([
+  ResolvedCredentialsSchema,
+  CredentialsFunctionSchema
+]);
 function isClientCredentials(credentials) {
   return typeof credentials === "object" && credentials !== null && "clientId" in credentials && "clientSecret" in credentials;
 }
@@ -5402,7 +5428,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "0.30.0"};
+  version: "0.31.0"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {
@@ -5861,13 +5887,46 @@ function createZapierSdkWithoutRegistry(options = {}) {
 function createZapierSdk(options = {}) {
   return createZapierSdkWithoutRegistry(options).addPlugin(registryPlugin);
 }
+var BaseSdkOptionsSchema = zod.z.object({
+  credentials: CredentialsSchema.optional().describe(
+    "Authentication credentials. Can be a string (token or API key), a client credentials object ({ clientId, clientSecret }), a PKCE object ({ clientId }), or a function returning any of those."
+  ),
+  debug: zod.z.boolean().optional().describe("Enable debug logging."),
+  baseUrl: zod.z.string().optional().describe("Base URL for Zapier API endpoints.").meta({ valueHint: "url" }),
+  trackingBaseUrl: zod.z.string().optional().describe("Base URL for Zapier tracking endpoints.").meta({ valueHint: "url" }),
+  /**
+   * Maximum number of retries for rate-limited requests (429 responses).
+   * Set to 0 to disable retries. Default is 3.
+   */
+  maxNetworkRetries: zod.z.number().optional().describe("Max retries for rate-limited requests (default: 3).").meta({ valueHint: "count" }),
+  /**
+   * Maximum delay in milliseconds to wait for a rate limit retry.
+   * If the server requests a longer delay, the request fails immediately.
+   * Default is 60000 (60 seconds).
+   */
+  maxNetworkRetryDelayMs: zod.z.number().optional().describe("Max delay in ms to wait for retry (default: 60000).").meta({ valueHint: "ms" }),
+  // Internal
+  manifestPath: zod.z.string().optional().describe("Path to a .zapierrc manifest file for app version locking.").meta({ internal: true }),
+  manifest: zod.z.custom().optional().describe("Manifest for app version locking.").meta({ internal: true }),
+  onEvent: zod.z.custom().optional().meta({ internal: true }),
+  fetch: zod.z.custom().optional().meta({ internal: true }),
+  eventEmission: zod.z.custom().optional().meta({ internal: true }),
+  // Deprecated
+  token: zod.z.string().optional().meta({ deprecated: true })
+  // Use credentials instead
+});
 
 exports.ActionKeyPropertySchema = ActionKeyPropertySchema;
 exports.ActionTimeoutMsPropertySchema = ActionTimeoutMsPropertySchema;
 exports.ActionTypePropertySchema = ActionTypePropertySchema;
 exports.AppKeyPropertySchema = AppKeyPropertySchema;
 exports.AuthenticationIdPropertySchema = AuthenticationIdPropertySchema;
+exports.BaseSdkOptionsSchema = BaseSdkOptionsSchema;
+exports.ClientCredentialsObjectSchema = ClientCredentialsObjectSchema;
 exports.ConnectionIdPropertySchema = ConnectionIdPropertySchema;
+exports.CredentialsFunctionSchema = CredentialsFunctionSchema;
+exports.CredentialsObjectSchema = CredentialsObjectSchema;
+exports.CredentialsSchema = CredentialsSchema;
 exports.DEFAULT_ACTION_TIMEOUT_MS = DEFAULT_ACTION_TIMEOUT_MS;
 exports.DEFAULT_CONFIG_PATH = DEFAULT_CONFIG_PATH;
 exports.DebugPropertySchema = DebugPropertySchema;
@@ -5877,8 +5936,10 @@ exports.MAX_PAGE_LIMIT = MAX_PAGE_LIMIT;
 exports.OffsetPropertySchema = OffsetPropertySchema;
 exports.OutputPropertySchema = OutputPropertySchema;
 exports.ParamsPropertySchema = ParamsPropertySchema;
+exports.PkceCredentialsObjectSchema = PkceCredentialsObjectSchema;
 exports.RelayFetchSchema = RelayFetchSchema;
 exports.RelayRequestSchema = RelayRequestSchema;
+exports.ResolvedCredentialsSchema = ResolvedCredentialsSchema;
 exports.ZAPIER_AUTH_BASE_URL = ZAPIER_AUTH_BASE_URL;
 exports.ZAPIER_AUTH_CLIENT_ID = ZAPIER_AUTH_CLIENT_ID;
 exports.ZAPIER_BASE_URL = ZAPIER_BASE_URL;

package/dist/index.d.mts

@@ -399,44 +399,164 @@ interface EventEmissionProvides {
  * - PKCE: OAuth client ID for interactive login (CLI only)
  * - Function: Lazy/dynamic credential resolution
  */
+
 /**
  * Client credentials for OAuth client_credentials flow.
  * The SDK will exchange these for an access token.
  */
-interface ClientCredentialsObject {
-    type?: "client_credentials";
-    clientId: string;
-    clientSecret: string;
-    baseUrl?: string;
-    scope?: string;
-}
+declare const ClientCredentialsObjectSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ClientCredentialsObject = z.infer<typeof ClientCredentialsObjectSchema>;
 /**
  * PKCE credentials for interactive OAuth flow.
  * Only works when @zapier/zapier-sdk-cli-login is available.
  */
-interface PkceCredentialsObject {
-    type?: "pkce";
-    clientId: string;
-    baseUrl?: string;
-    scope?: string;
-}
+declare const PkceCredentialsObjectSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type PkceCredentialsObject = z.infer<typeof PkceCredentialsObjectSchema>;
 /**
  * Union of all credential object types.
  */
-type CredentialsObject = ClientCredentialsObject | PkceCredentialsObject;
+declare const CredentialsObjectSchema: z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+type CredentialsObject = z.infer<typeof CredentialsObjectSchema>;
 /**
  * Resolved credentials - what a credentials function must return.
  * Either a string (token) or a credentials object.
  * Functions are not allowed to return other functions.
  */
-type ResolvedCredentials = string | CredentialsObject;
+declare const ResolvedCredentialsSchema: z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>]>;
+type ResolvedCredentials = z.infer<typeof ResolvedCredentialsSchema>;
+/**
+ * Lazy/dynamic credential resolution — a function returning resolved credentials.
+ */
+declare const CredentialsFunctionSchema: z.ZodFunction<z.core.$ZodTuple<readonly [], z.core.$ZodFunctionOut>, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>]>, z.ZodPromise<z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>]>>]>>;
+type CredentialsFunction = z.infer<typeof CredentialsFunctionSchema>;
 /**
  * Credentials can be:
  * - A string (token or API key)
  * - A credentials object (client_credentials or pkce)
  * - A function that returns credentials (sync or async)
  */
-type Credentials = ResolvedCredentials | (() => ResolvedCredentials | Promise<ResolvedCredentials>);
+declare const CredentialsSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>]>, z.ZodFunction<z.core.$ZodTuple<readonly [], z.core.$ZodFunctionOut>, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>]>, z.ZodPromise<z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>]>>]>>]>;
+type Credentials = z.infer<typeof CredentialsSchema>;
 /**
  * Type guard for client credentials objects.
  */
@@ -452,7 +572,7 @@ declare function isCredentialsObject(credentials: ResolvedCredentials): credenti
 /**
  * Type guard for credentials functions.
  */
-declare function isCredentialsFunction(credentials: Credentials): credentials is () => ResolvedCredentials | Promise<ResolvedCredentials>;
+declare function isCredentialsFunction(credentials: Credentials): credentials is CredentialsFunction;
 
 declare const NeedSchema: z.ZodObject<{
     key: z.ZodString;
@@ -1127,8 +1247,8 @@ declare const GetConnectionParamSchema: z.ZodObject<{
 type GetConnectionParam = z.infer<typeof GetConnectionParamSchema>;
 
 declare const FindFirstConnectionSchema: z.ZodObject<{
-    search: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
     appKey: z.ZodOptional<z.ZodString & {
         _def: z.core.$ZodStringDef & PositionalMetadata;
     }>;
@@ -1140,8 +1260,8 @@ declare const FindFirstConnectionSchema: z.ZodObject<{
 type FindFirstConnectionOptions = z.infer<typeof FindFirstConnectionSchema>;
 
 declare const FindUniqueConnectionSchema: z.ZodObject<{
-    search: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
     appKey: z.ZodOptional<z.ZodString & {
         _def: z.core.$ZodStringDef & PositionalMetadata;
     }>;
@@ -1568,8 +1688,8 @@ interface ZapierSdkApps {
 }
 
 declare const ListConnectionsQuerySchema: z.ZodObject<{
-    search: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
     owner: z.ZodOptional<z.ZodString>;
     appKey: z.ZodOptional<z.ZodString & {
         _def: z.core.$ZodStringDef & PositionalMetadata;
@@ -1739,8 +1859,8 @@ declare const listClientCredentialsPlugin: Plugin<{}, {
 declare const CreateClientCredentialsSchema: z.ZodObject<{
     name: z.ZodString;
     allowedScopes: z.ZodDefault<z.ZodArray<z.ZodEnum<{
-        external: "external";
         credentials: "credentials";
+        external: "external";
     }>>>;
 }, z.core.$strip>;
 type CreateClientCredentialsOptions = z.infer<typeof CreateClientCredentialsSchema> & FunctionOptions;
@@ -1918,39 +2038,66 @@ RequestPluginProvides>;
  * SDK-related types and interfaces
  */
 
-interface BaseSdkOptions {
-    /**
-     * Authentication credentials. Can be:
-     * - A string (token or API key)
-     * - An object with clientId/clientSecret for client_credentials flow
-     * - An object with clientId (no secret) for PKCE flow
-     * - A function returning any of the above
-     */
-    credentials?: Credentials;
-    /**
-     * @deprecated Use `credentials` instead.
-     */
-    token?: string;
-    onEvent?: EventCallback;
-    fetch?: typeof fetch;
-    baseUrl?: string;
-    trackingBaseUrl?: string;
-    debug?: boolean;
-    manifestPath?: string;
-    manifest?: Manifest;
-    eventEmission?: EventEmissionConfig;
-    /**
-     * Maximum number of retries for rate-limited requests (429 responses).
-     * Set to 0 to disable retries. Default is 3.
-     */
-    maxNetworkRetries?: number;
-    /**
-     * Maximum delay in milliseconds to wait for a rate limit retry.
-     * If the server requests a longer delay, the request fails immediately.
-     * Default is 60000 (60 seconds).
-     */
-    maxNetworkRetryDelayMs?: number;
-}
+declare const BaseSdkOptionsSchema: z.ZodObject<{
+    credentials: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            client_credentials: "client_credentials";
+        }>>;
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            pkce: "pkce";
+        }>>;
+        clientId: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>]>, z.ZodFunction<z.core.$ZodTuple<readonly [], z.core.$ZodFunctionOut>, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            client_credentials: "client_credentials";
+        }>>;
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            pkce: "pkce";
+        }>>;
+        clientId: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>]>, z.ZodPromise<z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            client_credentials: "client_credentials";
+        }>>;
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            pkce: "pkce";
+        }>>;
+        clientId: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>]>>]>>]>>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    trackingBaseUrl: z.ZodOptional<z.ZodString>;
+    maxNetworkRetries: z.ZodOptional<z.ZodNumber>;
+    maxNetworkRetryDelayMs: z.ZodOptional<z.ZodNumber>;
+    manifestPath: z.ZodOptional<z.ZodString>;
+    manifest: z.ZodOptional<z.ZodCustom<Manifest, Manifest>>;
+    onEvent: z.ZodOptional<z.ZodCustom<EventCallback, EventCallback>>;
+    fetch: z.ZodOptional<z.ZodCustom<typeof fetch, typeof fetch>>;
+    eventEmission: z.ZodOptional<z.ZodCustom<EventEmissionConfig, EventEmissionConfig>>;
+    token: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type BaseSdkOptions = z.infer<typeof BaseSdkOptionsSchema>;
 
 interface FunctionRegistryEntry {
     name: string;
@@ -2166,8 +2313,8 @@ type ConnectionItem$1 = z.infer<typeof ConnectionItemSchema>;
 
 declare const ActionItemSchema: z.ZodObject<{
     description: z.ZodString;
-    key: z.ZodString;
     id: z.ZodOptional<z.ZodString>;
+    key: z.ZodString;
     is_important: z.ZodOptional<z.ZodBoolean>;
     is_hidden: z.ZodOptional<z.ZodBoolean>;
     app_key: z.ZodString;
@@ -2799,4 +2946,4 @@ declare function createZapierSdkWithoutRegistry(options?: ZapierSdkOptions): Sdk
 }>;
 declare function createZapierSdk(options?: ZapierSdkOptions): ZapierSdk;
 
-export { type Action, type ActionEntry, type ActionExecutionOptions, type ActionExecutionResult, type ActionField, type ActionFieldChoice, type ActionItem$1 as ActionItem, type ActionKeyProperty, ActionKeyPropertySchema, type ActionTimeoutMsProperty, ActionTimeoutMsPropertySchema, type ActionTypeProperty, ActionTypePropertySchema, type AddActionEntryOptions, type AddActionEntryResult, type ApiError, type ApiEvent, type ApiPluginOptions, type ApiPluginProvides, type App, type AppItem, type AppKeyProperty, AppKeyPropertySchema, type ApplicationLifecycleEventData, type AppsPluginProvides, type AuthEvent, type AuthenticationIdProperty, AuthenticationIdPropertySchema, type BaseEvent, type BatchOptions, type Choice, type ClientCredentialsObject, type Connection, type ConnectionIdProperty, ConnectionIdPropertySchema, type ConnectionItem, type ConnectionsResponse, type CreateClientCredentialsPluginProvides, type Credentials, type CredentialsObject, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_CONFIG_PATH, type DebugProperty, DebugPropertySchema, type DeleteClientCredentialsPluginProvides, type EnhancedErrorEventData, type ErrorOptions, type EventCallback, type EventContext, type EventEmissionContext, type FetchPluginProvides, type Field, type FieldsetItem, type FindFirstAuthenticationPluginProvides, type FindFirstConnectionPluginProvides, type FindUniqueAuthenticationPluginProvides, type FindUniqueConnectionPluginProvides, type FormatMetadata, type FormattedItem, type FunctionOptions, type FunctionRegistryEntry, type GetActionPluginProvides, type GetAppPluginProvides, type GetAuthenticationPluginProvides, type GetConnectionPluginProvides, type GetContextType, type GetProfilePluginProvides, type GetSdkType, type InfoFieldItem, type InputFieldItem, type InputsProperty, InputsPropertySchema, type LimitProperty, LimitPropertySchema, type ListActionsPluginProvides, type ListAppsPluginProvides, type ListAuthenticationsPluginProvides, type ListClientCredentialsPluginProvides, type ListConnectionsPluginProvides, type ListInputFieldsPluginProvides, type LoadingEvent, MAX_PAGE_LIMIT, type Manifest, type ManifestEntry, type ManifestPluginOptions, type ManifestPluginProvides, type MethodCalledEvent, type MethodCalledEventData, type Need, type NeedsRequest, type NeedsResponse, type OffsetProperty, OffsetPropertySchema, type OutputProperty, OutputPropertySchema, type PaginatedSdkFunction, type ParamsProperty, ParamsPropertySchema, type PkceCredentialsObject, type Plugin, type PluginDependencies, type PluginOptions, type PluginProvides, type PositionalMetadata, type RateLimitInfo, RelayFetchSchema, RelayRequestSchema, type RequestPluginProvides, type ResolveAuthTokenOptions, type ResolveCredentialsOptions, type ResolvedCredentials, type RootFieldItem, type RunActionPluginProvides, type Sdk, type SdkEvent, type StaticResolver, type UpdateManifestEntryOptions, type UpdateManifestEntryResult, type UserProfile, type UserProfileItem, ZAPIER_AUTH_BASE_URL, ZAPIER_AUTH_CLIENT_ID, ZAPIER_BASE_URL, ZAPIER_CREDENTIALS, ZAPIER_CREDENTIALS_BASE_URL, ZAPIER_CREDENTIALS_CLIENT_ID, ZAPIER_CREDENTIALS_CLIENT_SECRET, ZAPIER_CREDENTIALS_SCOPE, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZAPIER_TOKEN, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, type ZapierFetchInitOptions, ZapierNotFoundError, ZapierRateLimitError, ZapierResourceNotFoundError, type ZapierSdk, type ZapierSdkApps, type ZapierSdkOptions, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, connectionIdGenericResolver as authenticationIdGenericResolver, connectionIdResolver as authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, connectionIdGenericResolver, connectionIdResolver, createBaseEvent, createClientCredentialsPlugin, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, deleteClientCredentialsPlugin, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTokenFromCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listInputFieldsPlugin, logDeprecation, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, runActionPlugin, toSnakeCase, toTitleCase };
+export { type Action, type ActionEntry, type ActionExecutionOptions, type ActionExecutionResult, type ActionField, type ActionFieldChoice, type ActionItem$1 as ActionItem, type ActionKeyProperty, ActionKeyPropertySchema, type ActionTimeoutMsProperty, ActionTimeoutMsPropertySchema, type ActionTypeProperty, ActionTypePropertySchema, type AddActionEntryOptions, type AddActionEntryResult, type ApiError, type ApiEvent, type ApiPluginOptions, type ApiPluginProvides, type App, type AppItem, type AppKeyProperty, AppKeyPropertySchema, type ApplicationLifecycleEventData, type AppsPluginProvides, type AuthEvent, type AuthenticationIdProperty, AuthenticationIdPropertySchema, type BaseEvent, BaseSdkOptionsSchema, type BatchOptions, type Choice, type ClientCredentialsObject, ClientCredentialsObjectSchema, type Connection, type ConnectionIdProperty, ConnectionIdPropertySchema, type ConnectionItem, type ConnectionsResponse, type CreateClientCredentialsPluginProvides, type Credentials, type CredentialsFunction, CredentialsFunctionSchema, type CredentialsObject, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_CONFIG_PATH, type DebugProperty, DebugPropertySchema, type DeleteClientCredentialsPluginProvides, type EnhancedErrorEventData, type ErrorOptions, type EventCallback, type EventContext, type EventEmissionContext, type FetchPluginProvides, type Field, type FieldsetItem, type FindFirstAuthenticationPluginProvides, type FindFirstConnectionPluginProvides, type FindUniqueAuthenticationPluginProvides, type FindUniqueConnectionPluginProvides, type FormatMetadata, type FormattedItem, type FunctionOptions, type FunctionRegistryEntry, type GetActionPluginProvides, type GetAppPluginProvides, type GetAuthenticationPluginProvides, type GetConnectionPluginProvides, type GetContextType, type GetProfilePluginProvides, type GetSdkType, type InfoFieldItem, type InputFieldItem, type InputsProperty, InputsPropertySchema, type LimitProperty, LimitPropertySchema, type ListActionsPluginProvides, type ListAppsPluginProvides, type ListAuthenticationsPluginProvides, type ListClientCredentialsPluginProvides, type ListConnectionsPluginProvides, type ListInputFieldsPluginProvides, type LoadingEvent, MAX_PAGE_LIMIT, type Manifest, type ManifestEntry, type ManifestPluginOptions, type ManifestPluginProvides, type MethodCalledEvent, type MethodCalledEventData, type Need, type NeedsRequest, type NeedsResponse, type OffsetProperty, OffsetPropertySchema, type OutputProperty, OutputPropertySchema, type PaginatedSdkFunction, type ParamsProperty, ParamsPropertySchema, type PkceCredentialsObject, PkceCredentialsObjectSchema, type Plugin, type PluginDependencies, type PluginOptions, type PluginProvides, type PositionalMetadata, type RateLimitInfo, RelayFetchSchema, RelayRequestSchema, type RequestPluginProvides, type ResolveAuthTokenOptions, type ResolveCredentialsOptions, type ResolvedCredentials, ResolvedCredentialsSchema, type RootFieldItem, type RunActionPluginProvides, type Sdk, type SdkEvent, type StaticResolver, type UpdateManifestEntryOptions, type UpdateManifestEntryResult, type UserProfile, type UserProfileItem, ZAPIER_AUTH_BASE_URL, ZAPIER_AUTH_CLIENT_ID, ZAPIER_BASE_URL, ZAPIER_CREDENTIALS, ZAPIER_CREDENTIALS_BASE_URL, ZAPIER_CREDENTIALS_CLIENT_ID, ZAPIER_CREDENTIALS_CLIENT_SECRET, ZAPIER_CREDENTIALS_SCOPE, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZAPIER_TOKEN, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, type ZapierFetchInitOptions, ZapierNotFoundError, ZapierRateLimitError, ZapierResourceNotFoundError, type ZapierSdk, type ZapierSdkApps, type ZapierSdkOptions, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, connectionIdGenericResolver as authenticationIdGenericResolver, connectionIdResolver as authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, connectionIdGenericResolver, connectionIdResolver, createBaseEvent, createClientCredentialsPlugin, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, deleteClientCredentialsPlugin, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTokenFromCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listInputFieldsPlugin, logDeprecation, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, runActionPlugin, toSnakeCase, toTitleCase };

package/dist/index.d.ts

@@ -38,6 +38,7 @@ export * from "./constants";
 export { RelayRequestSchema, RelayFetchSchema, } from "./plugins/request/schemas";
 export { createZapierSdk, createZapierSdkWithoutRegistry, createSdk, ZapierSdkOptions, } from "./sdk";
 export type { FunctionRegistryEntry } from "./types/sdk";
+export { BaseSdkOptionsSchema } from "./types/sdk";
 export type { Plugin, PluginProvides, PluginDependencies, PluginOptions, GetSdkType, GetContextType, Sdk, } from "./types/plugin";
 export { registryPlugin } from "./plugins/registry";
 export type { ZapierSdk } from "./types/sdk";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAG/C,YAAY,EACV,iCAAiC,EACjC,+BAA+B,EAC/B,qCAAqC,EACrC,sCAAsC,GACvC,MAAM,sCAAsC,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAG9B,YAAY,EACV,MAAM,EACN,GAAG,EACH,IAAI,EACJ,KAAK,EACL,MAAM,EACN,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EACV,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,cAAc,aAAa,CAAC;AAG5B,cAAc,QAAQ,CAAC;AAGvB,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAG3E,cAAc,aAAa,CAAC;AAI5B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,SAAS,EACT,gBAAgB,GACjB,MAAM,OAAO,CAAC;AAGf,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,YAAY,EACV,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,cAAc,EACd,GAAG,GACJ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,6BAA6B,EAC7B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,IAAI,EACJ,aAAa,EACb,cAAc,EACd,UAAU,EACV,8BAA8B,EAC9B,0BAA0B,EAC1B,eAAe,EACf,eAAe,EACf,sBAAsB,GACvB,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAG/C,YAAY,EACV,iCAAiC,EACjC,+BAA+B,EAC/B,qCAAqC,EACrC,sCAAsC,GACvC,MAAM,sCAAsC,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAG9B,YAAY,EACV,MAAM,EACN,GAAG,EACH,IAAI,EACJ,KAAK,EACL,MAAM,EACN,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,mBAAmB,EACnB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EACV,aAAa,EACb,cAAc,EACd,cAAc,GACf,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGhE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,cAAc,aAAa,CAAC;AAG5B,cAAc,QAAQ,CAAC;AAGvB,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAG3E,cAAc,aAAa,CAAC;AAI5B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,eAAe,EACf,8BAA8B,EAC9B,SAAS,EACT,gBAAgB,GACjB,MAAM,OAAO,CAAC;AAGf,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD,YAAY,EACV,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,cAAc,EACd,GAAG,GACJ,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,6BAA6B,EAC7B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,IAAI,EACJ,aAAa,EACb,cAAc,EACd,UAAU,EACV,8BAA8B,EAC9B,0BAA0B,EAC1B,eAAe,EACf,eAAe,EACf,sBAAsB,GACvB,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -45,6 +45,7 @@ export * from "./constants";
 export { RelayRequestSchema, RelayFetchSchema, } from "./plugins/request/schemas";
 // Export the main combined SDK and new flexible SDK creator
 export { createZapierSdk, createZapierSdkWithoutRegistry, createSdk, } from "./sdk";
+export { BaseSdkOptionsSchema } from "./types/sdk";
 // Export registry plugin for manual use
 export { registryPlugin } from "./plugins/registry";
 export { generateEventId, getCurrentTimestamp, getReleaseId, getOsInfo, getPlatformVersions, isCi, getCiPlatform, getMemoryUsage, getCpuTime, buildApplicationLifecycleEvent, buildErrorEventWithContext, buildErrorEvent, createBaseEvent, buildMethodCalledEvent, } from "./plugins/eventEmission";

package/dist/index.mjs

@@ -3897,8 +3897,34 @@ async function pollUntilComplete(options) {
     }
   }
 }
-
-// src/types/credentials.ts
+var ClientCredentialsObjectSchema = z.object({
+  type: z.enum(["client_credentials"]).optional().meta({ internal: true }),
+  clientId: z.string().describe("OAuth client ID for authentication.").meta({ valueHint: "id" }),
+  clientSecret: z.string().describe("OAuth client secret for authentication.").meta({ valueHint: "secret" }),
+  baseUrl: z.string().optional().describe("Override authentication base URL.").meta({ valueHint: "url" }),
+  scope: z.string().optional().describe("Authentication scope.").meta({ internal: true })
+});
+var PkceCredentialsObjectSchema = z.object({
+  type: z.enum(["pkce"]).optional().meta({ internal: true }),
+  clientId: z.string().describe("OAuth client ID for authentication.").meta({ valueHint: "id" }),
+  baseUrl: z.string().optional().describe("Override authentication base URL.").meta({ valueHint: "url" }),
+  scope: z.string().optional().describe("Authentication scope.").meta({ internal: true })
+});
+var CredentialsObjectSchema = z.union([
+  ClientCredentialsObjectSchema,
+  PkceCredentialsObjectSchema
+]);
+var ResolvedCredentialsSchema = z.union([
+  z.string().describe("Authentication token.").meta({ valueHint: "token" }),
+  CredentialsObjectSchema
+]);
+var CredentialsFunctionSchema = z.function().input([]).output(
+  z.union([ResolvedCredentialsSchema, z.promise(ResolvedCredentialsSchema)])
+);
+var CredentialsSchema = z.union([
+  ResolvedCredentialsSchema,
+  CredentialsFunctionSchema
+]);
 function isClientCredentials(credentials) {
   return typeof credentials === "object" && credentials !== null && "clientId" in credentials && "clientSecret" in credentials;
 }
@@ -5380,7 +5406,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "0.30.0"};
+  version: "0.31.0"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {
@@ -5839,5 +5865,33 @@ function createZapierSdkWithoutRegistry(options = {}) {
 function createZapierSdk(options = {}) {
   return createZapierSdkWithoutRegistry(options).addPlugin(registryPlugin);
 }
+var BaseSdkOptionsSchema = z.object({
+  credentials: CredentialsSchema.optional().describe(
+    "Authentication credentials. Can be a string (token or API key), a client credentials object ({ clientId, clientSecret }), a PKCE object ({ clientId }), or a function returning any of those."
+  ),
+  debug: z.boolean().optional().describe("Enable debug logging."),
+  baseUrl: z.string().optional().describe("Base URL for Zapier API endpoints.").meta({ valueHint: "url" }),
+  trackingBaseUrl: z.string().optional().describe("Base URL for Zapier tracking endpoints.").meta({ valueHint: "url" }),
+  /**
+   * Maximum number of retries for rate-limited requests (429 responses).
+   * Set to 0 to disable retries. Default is 3.
+   */
+  maxNetworkRetries: z.number().optional().describe("Max retries for rate-limited requests (default: 3).").meta({ valueHint: "count" }),
+  /**
+   * Maximum delay in milliseconds to wait for a rate limit retry.
+   * If the server requests a longer delay, the request fails immediately.
+   * Default is 60000 (60 seconds).
+   */
+  maxNetworkRetryDelayMs: z.number().optional().describe("Max delay in ms to wait for retry (default: 60000).").meta({ valueHint: "ms" }),
+  // Internal
+  manifestPath: z.string().optional().describe("Path to a .zapierrc manifest file for app version locking.").meta({ internal: true }),
+  manifest: z.custom().optional().describe("Manifest for app version locking.").meta({ internal: true }),
+  onEvent: z.custom().optional().meta({ internal: true }),
+  fetch: z.custom().optional().meta({ internal: true }),
+  eventEmission: z.custom().optional().meta({ internal: true }),
+  // Deprecated
+  token: z.string().optional().meta({ deprecated: true })
+  // Use credentials instead
+});
 
-export { ActionKeyPropertySchema, ActionTimeoutMsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, ConnectionIdPropertySchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_CONFIG_PATH, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, RelayFetchSchema, RelayRequestSchema, ZAPIER_AUTH_BASE_URL, ZAPIER_AUTH_CLIENT_ID, ZAPIER_BASE_URL, ZAPIER_CREDENTIALS, ZAPIER_CREDENTIALS_BASE_URL, ZAPIER_CREDENTIALS_CLIENT_ID, ZAPIER_CREDENTIALS_CLIENT_SECRET, ZAPIER_CREDENTIALS_SCOPE, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZAPIER_TOKEN, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierResourceNotFoundError, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, connectionIdGenericResolver as authenticationIdGenericResolver, connectionIdResolver as authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, connectionIdGenericResolver, connectionIdResolver, createBaseEvent, createClientCredentialsPlugin, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, deleteClientCredentialsPlugin, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTokenFromCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listInputFieldsPlugin, logDeprecation, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, runActionPlugin, toSnakeCase, toTitleCase };
+export { ActionKeyPropertySchema, ActionTimeoutMsPropertySchema, ActionTypePropertySchema, AppKeyPropertySchema, AuthenticationIdPropertySchema, BaseSdkOptionsSchema, ClientCredentialsObjectSchema, ConnectionIdPropertySchema, CredentialsFunctionSchema, CredentialsObjectSchema, CredentialsSchema, DEFAULT_ACTION_TIMEOUT_MS, DEFAULT_CONFIG_PATH, DebugPropertySchema, InputsPropertySchema, LimitPropertySchema, MAX_PAGE_LIMIT, OffsetPropertySchema, OutputPropertySchema, ParamsPropertySchema, PkceCredentialsObjectSchema, RelayFetchSchema, RelayRequestSchema, ResolvedCredentialsSchema, ZAPIER_AUTH_BASE_URL, ZAPIER_AUTH_CLIENT_ID, ZAPIER_BASE_URL, ZAPIER_CREDENTIALS, ZAPIER_CREDENTIALS_BASE_URL, ZAPIER_CREDENTIALS_CLIENT_ID, ZAPIER_CREDENTIALS_CLIENT_SECRET, ZAPIER_CREDENTIALS_SCOPE, ZAPIER_MAX_NETWORK_RETRIES, ZAPIER_MAX_NETWORK_RETRY_DELAY_MS, ZAPIER_TOKEN, ZapierActionError, ZapierApiError, ZapierAppNotFoundError, ZapierAuthenticationError, ZapierBundleError, ZapierConfigurationError, ZapierError, ZapierNotFoundError, ZapierRateLimitError, ZapierResourceNotFoundError, ZapierTimeoutError, ZapierUnknownError, ZapierValidationError, actionKeyResolver, actionTypeResolver, apiPlugin, appKeyResolver, appsPlugin, connectionIdGenericResolver as authenticationIdGenericResolver, connectionIdResolver as authenticationIdResolver, batch, buildApplicationLifecycleEvent, buildErrorEvent, buildErrorEventWithContext, buildMethodCalledEvent, clearTokenCache, clientCredentialsNameResolver, clientIdResolver, connectionIdGenericResolver, connectionIdResolver, createBaseEvent, createClientCredentialsPlugin, createFunction, createSdk, createZapierSdk, createZapierSdkWithoutRegistry, deleteClientCredentialsPlugin, fetchPlugin, findFirstConnectionPlugin, findManifestEntry, findUniqueConnectionPlugin, formatErrorMessage, generateEventId, getActionPlugin, getAppPlugin, getBaseUrlFromCredentials, getCiPlatform, getClientIdFromCredentials, getConnectionPlugin, getCpuTime, getCurrentTimestamp, getMemoryUsage, getOsInfo, getPlatformVersions, getPreferredManifestEntryKey, getProfilePlugin, getReleaseId, getTokenFromCliLogin, inputFieldKeyResolver, inputsAllOptionalResolver, inputsResolver, invalidateCachedToken, invalidateCredentialsToken, isCi, isClientCredentials, isCredentialsFunction, isCredentialsObject, isPkceCredentials, isPositional, listActionsPlugin, listAppsPlugin, listClientCredentialsPlugin, listConnectionsPlugin, listInputFieldsPlugin, logDeprecation, manifestPlugin, readManifestFromFile, registryPlugin, requestPlugin, resetDeprecationWarnings, resolveAuthToken, resolveCredentials, resolveCredentialsFromEnv, runActionPlugin, toSnakeCase, toTitleCase };

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

@@ -2,8 +2,8 @@ import type { z } from "zod";
 import type { ConnectionItem } from "../../types/domain";
 import type { ZapierAuthenticationError, ZapierApiError, ZapierValidationError, ZapierUnknownError } from "../../types/errors";
 export declare const FindFirstConnectionSchema: z.ZodObject<{
-    search: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
     appKey: z.ZodOptional<z.ZodString & {
         _def: z.core.$ZodStringDef & import("../..").PositionalMetadata;
     }>;

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

@@ -2,8 +2,8 @@ import type { z } from "zod";
 import type { ConnectionItem } from "../../types/domain";
 import type { ZapierAuthenticationError, ZapierApiError, ZapierResourceNotFoundError, ZapierValidationError, ZapierUnknownError } from "../../types/errors";
 export declare const FindUniqueConnectionSchema: z.ZodObject<{
-    search: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
     appKey: z.ZodOptional<z.ZodString & {
         _def: z.core.$ZodStringDef & import("../..").PositionalMetadata;
     }>;

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

@@ -3,8 +3,8 @@ import type { PaginatedSdkFunction } from "../../types/functions";
 import type { ConnectionItem } from "@zapier/zapier-sdk-core/v0/schemas/connections";
 import type { ZapierAuthenticationError, ZapierApiError, ZapierAppNotFoundError, ZapierValidationError, ZapierUnknownError } from "../../types/errors";
 export declare const ListConnectionsQuerySchema: z.ZodObject<{
-    search: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
     owner: z.ZodOptional<z.ZodString>;
     appKey: z.ZodOptional<z.ZodString & {
         _def: z.core.$ZodStringDef & import("../..").PositionalMetadata;

package/dist/schemas/Action.d.ts

@@ -1,8 +1,8 @@
 import { z } from "zod";
 export declare const ActionItemSchema: z.ZodObject<{
-    key: z.ZodString;
-    description: z.ZodString;
     id: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+    key: z.ZodString;
     is_important: z.ZodOptional<z.ZodBoolean>;
     is_hidden: z.ZodOptional<z.ZodBoolean>;
     app_key: z.ZodString;

package/dist/types/credentials.d.ts

@@ -8,44 +8,164 @@
  * - PKCE: OAuth client ID for interactive login (CLI only)
  * - Function: Lazy/dynamic credential resolution
  */
+import { z } from "zod";
 /**
  * Client credentials for OAuth client_credentials flow.
  * The SDK will exchange these for an access token.
  */
-export interface ClientCredentialsObject {
-    type?: "client_credentials";
-    clientId: string;
-    clientSecret: string;
-    baseUrl?: string;
-    scope?: string;
-}
+export declare const ClientCredentialsObjectSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ClientCredentialsObject = z.infer<typeof ClientCredentialsObjectSchema>;
 /**
  * PKCE credentials for interactive OAuth flow.
  * Only works when @zapier/zapier-sdk-cli-login is available.
  */
-export interface PkceCredentialsObject {
-    type?: "pkce";
-    clientId: string;
-    baseUrl?: string;
-    scope?: string;
-}
+export declare const PkceCredentialsObjectSchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PkceCredentialsObject = z.infer<typeof PkceCredentialsObjectSchema>;
 /**
  * Union of all credential object types.
  */
-export type CredentialsObject = ClientCredentialsObject | PkceCredentialsObject;
+export declare const CredentialsObjectSchema: z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+export type CredentialsObject = z.infer<typeof CredentialsObjectSchema>;
 /**
  * Resolved credentials - what a credentials function must return.
  * Either a string (token) or a credentials object.
  * Functions are not allowed to return other functions.
  */
-export type ResolvedCredentials = string | CredentialsObject;
+export declare const ResolvedCredentialsSchema: z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>]>;
+export type ResolvedCredentials = z.infer<typeof ResolvedCredentialsSchema>;
+/**
+ * Lazy/dynamic credential resolution — a function returning resolved credentials.
+ */
+export declare const CredentialsFunctionSchema: z.ZodFunction<z.core.$ZodTuple<readonly [], z.core.$ZodFunctionOut>, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>]>, z.ZodPromise<z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>]>>]>>;
+export type CredentialsFunction = z.infer<typeof CredentialsFunctionSchema>;
 /**
  * Credentials can be:
  * - A string (token or API key)
  * - A credentials object (client_credentials or pkce)
  * - A function that returns credentials (sync or async)
  */
-export type Credentials = ResolvedCredentials | (() => ResolvedCredentials | Promise<ResolvedCredentials>);
+export declare const CredentialsSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>]>, z.ZodFunction<z.core.$ZodTuple<readonly [], z.core.$ZodFunctionOut>, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>]>, z.ZodPromise<z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        client_credentials: "client_credentials";
+    }>>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        pkce: "pkce";
+    }>>;
+    clientId: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>]>>]>>]>;
+export type Credentials = z.infer<typeof CredentialsSchema>;
 /**
  * Type guard for client credentials objects.
  */
@@ -61,5 +181,5 @@ export declare function isCredentialsObject(credentials: ResolvedCredentials): c
 /**
  * Type guard for credentials functions.
  */
-export declare function isCredentialsFunction(credentials: Credentials): credentials is () => ResolvedCredentials | Promise<ResolvedCredentials>;
+export declare function isCredentialsFunction(credentials: Credentials): credentials is CredentialsFunction;
 //# sourceMappingURL=credentials.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/types/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GAAG,qBAAqB,CAAC;AAEhF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB,mBAAmB,GACnB,CAAC,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAE/D;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,mBAAmB,GAC/B,WAAW,IAAI,uBAAuB,CAOxC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,mBAAmB,GAC/B,WAAW,IAAI,qBAAqB,CAOtC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,mBAAmB,GAC/B,WAAW,IAAI,iBAAiB,CAMlC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,GACvB,WAAW,IAAI,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAEzE"}
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/types/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;iBAoBxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAC3C,OAAO,6BAA6B,CACrC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;iBAgBtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;mBAGlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;qBAGpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAKnC,CAAC;AACJ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAG5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,mBAAmB,GAC/B,WAAW,IAAI,uBAAuB,CAOxC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,mBAAmB,GAC/B,WAAW,IAAI,qBAAqB,CAOtC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,mBAAmB,GAC/B,WAAW,IAAI,iBAAiB,CAMlC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,GACvB,WAAW,IAAI,mBAAmB,CAEpC"}

package/dist/types/credentials.js

@@ -8,6 +8,86 @@
  * - PKCE: OAuth client ID for interactive login (CLI only)
  * - Function: Lazy/dynamic credential resolution
  */
+import { z } from "zod";
+/**
+ * Client credentials for OAuth client_credentials flow.
+ * The SDK will exchange these for an access token.
+ */
+export const ClientCredentialsObjectSchema = z.object({
+    type: z.enum(["client_credentials"]).optional().meta({ internal: true }),
+    clientId: z
+        .string()
+        .describe("OAuth client ID for authentication.")
+        .meta({ valueHint: "id" }),
+    clientSecret: z
+        .string()
+        .describe("OAuth client secret for authentication.")
+        .meta({ valueHint: "secret" }),
+    baseUrl: z
+        .string()
+        .optional()
+        .describe("Override authentication base URL.")
+        .meta({ valueHint: "url" }),
+    scope: z
+        .string()
+        .optional()
+        .describe("Authentication scope.")
+        .meta({ internal: true }),
+});
+/**
+ * PKCE credentials for interactive OAuth flow.
+ * Only works when @zapier/zapier-sdk-cli-login is available.
+ */
+export const PkceCredentialsObjectSchema = z.object({
+    type: z.enum(["pkce"]).optional().meta({ internal: true }),
+    clientId: z
+        .string()
+        .describe("OAuth client ID for authentication.")
+        .meta({ valueHint: "id" }),
+    baseUrl: z
+        .string()
+        .optional()
+        .describe("Override authentication base URL.")
+        .meta({ valueHint: "url" }),
+    scope: z
+        .string()
+        .optional()
+        .describe("Authentication scope.")
+        .meta({ internal: true }),
+});
+/**
+ * Union of all credential object types.
+ */
+export const CredentialsObjectSchema = z.union([
+    ClientCredentialsObjectSchema,
+    PkceCredentialsObjectSchema,
+]);
+/**
+ * Resolved credentials - what a credentials function must return.
+ * Either a string (token) or a credentials object.
+ * Functions are not allowed to return other functions.
+ */
+export const ResolvedCredentialsSchema = z.union([
+    z.string().describe("Authentication token.").meta({ valueHint: "token" }),
+    CredentialsObjectSchema,
+]);
+/**
+ * Lazy/dynamic credential resolution — a function returning resolved credentials.
+ */
+export const CredentialsFunctionSchema = z
+    .function()
+    .input([])
+    .output(z.union([ResolvedCredentialsSchema, z.promise(ResolvedCredentialsSchema)]));
+/**
+ * Credentials can be:
+ * - A string (token or API key)
+ * - A credentials object (client_credentials or pkce)
+ * - A function that returns credentials (sync or async)
+ */
+export const CredentialsSchema = z.union([
+    ResolvedCredentialsSchema,
+    CredentialsFunctionSchema,
+]);
 /**
  * Type guard for client credentials objects.
  */

package/dist/types/meta.d.ts

@@ -0,0 +1,9 @@
+declare module "zod" {
+    interface GlobalMeta {
+        internal?: boolean;
+        deprecated?: boolean;
+        valueHint?: string;
+    }
+}
+export {};
+//# sourceMappingURL=meta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/types/meta.ts"],"names":[],"mappings":"AAGA,OAAO,QAAQ,KAAK,CAAC;IACnB,UAAU,UAAU;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CACF;AAGD,OAAO,EAAE,CAAC"}

package/dist/types/meta.js

@@ -0,0 +1,3 @@
+// Augment the Zod Metadata Registry
+// https://zod.dev/metadata?id=metadata
+export {};

package/dist/types/sdk.d.ts

@@ -1,49 +1,75 @@
 /**
  * SDK-related types and interfaces
  */
+import { z } from "zod";
 import type { EventCallback } from "./events";
 import type { EventEmissionConfig } from "../plugins/eventEmission";
 import type { Manifest } from "../plugins/manifest";
-import type { Credentials } from "./credentials";
-export interface BaseSdkOptions {
-    /**
-     * Authentication credentials. Can be:
-     * - A string (token or API key)
-     * - An object with clientId/clientSecret for client_credentials flow
-     * - An object with clientId (no secret) for PKCE flow
-     * - A function returning any of the above
-     */
-    credentials?: Credentials;
-    /**
-     * @deprecated Use `credentials` instead.
-     */
-    token?: string;
-    onEvent?: EventCallback;
-    fetch?: typeof fetch;
-    baseUrl?: string;
-    trackingBaseUrl?: string;
-    debug?: boolean;
-    manifestPath?: string;
-    manifest?: Manifest;
-    eventEmission?: EventEmissionConfig;
-    /**
-     * Maximum number of retries for rate-limited requests (429 responses).
-     * Set to 0 to disable retries. Default is 3.
-     */
-    maxNetworkRetries?: number;
-    /**
-     * Maximum delay in milliseconds to wait for a rate limit retry.
-     * If the server requests a longer delay, the request fails immediately.
-     * Default is 60000 (60 seconds).
-     */
-    maxNetworkRetryDelayMs?: number;
-}
+export declare const BaseSdkOptionsSchema: z.ZodObject<{
+    credentials: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            client_credentials: "client_credentials";
+        }>>;
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            pkce: "pkce";
+        }>>;
+        clientId: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>]>, z.ZodFunction<z.core.$ZodTuple<readonly [], z.core.$ZodFunctionOut>, z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            client_credentials: "client_credentials";
+        }>>;
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            pkce: "pkce";
+        }>>;
+        clientId: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>]>, z.ZodPromise<z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            client_credentials: "client_credentials";
+        }>>;
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodOptional<z.ZodEnum<{
+            pkce: "pkce";
+        }>>;
+        clientId: z.ZodString;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>]>>]>>]>>;
+    debug: z.ZodOptional<z.ZodBoolean>;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    trackingBaseUrl: z.ZodOptional<z.ZodString>;
+    maxNetworkRetries: z.ZodOptional<z.ZodNumber>;
+    maxNetworkRetryDelayMs: z.ZodOptional<z.ZodNumber>;
+    manifestPath: z.ZodOptional<z.ZodString>;
+    manifest: z.ZodOptional<z.ZodCustom<Manifest, Manifest>>;
+    onEvent: z.ZodOptional<z.ZodCustom<EventCallback, EventCallback>>;
+    fetch: z.ZodOptional<z.ZodCustom<typeof fetch, typeof fetch>>;
+    eventEmission: z.ZodOptional<z.ZodCustom<EventEmissionConfig, EventEmissionConfig>>;
+    token: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BaseSdkOptions = z.infer<typeof BaseSdkOptionsSchema>;
 import type { ListInputFieldsSdkFunction } from "../plugins/listInputFields/schemas";
 import type { GetConnectionSdkFunction } from "../plugins/getConnection/schemas";
 import type { FindFirstConnectionSdkFunction } from "../plugins/findFirstConnection/schemas";
 import type { FindUniqueConnectionSdkFunction } from "../plugins/findUniqueConnection/schemas";
 import type { RelayRequestSdkFunction } from "../plugins/request/schemas";
-import type { z } from "zod";
 import type { RegistryPluginProvides } from "../plugins/registry";
 import type { GetProfilePluginProvides } from "../plugins/getProfile";
 import type { EventEmissionProvides } from "../plugins/eventEmission";

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

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

package/dist/types/sdk.js

@@ -1,4 +1,58 @@
 /**
  * SDK-related types and interfaces
  */
-export {};
+import { z } from "zod";
+import { CredentialsSchema } from "./credentials";
+// SDK Configuration Types
+export const BaseSdkOptionsSchema = z.object({
+    credentials: CredentialsSchema.optional().describe("Authentication credentials. Can be a string (token or API key), a client credentials object ({ clientId, clientSecret }), a PKCE object ({ clientId }), or a function returning any of those."),
+    debug: z.boolean().optional().describe("Enable debug logging."),
+    baseUrl: z
+        .string()
+        .optional()
+        .describe("Base URL for Zapier API endpoints.")
+        .meta({ valueHint: "url" }),
+    trackingBaseUrl: z
+        .string()
+        .optional()
+        .describe("Base URL for Zapier tracking endpoints.")
+        .meta({ valueHint: "url" }),
+    /**
+     * Maximum number of retries for rate-limited requests (429 responses).
+     * Set to 0 to disable retries. Default is 3.
+     */
+    maxNetworkRetries: z
+        .number()
+        .optional()
+        .describe("Max retries for rate-limited requests (default: 3).")
+        .meta({ valueHint: "count" }),
+    /**
+     * Maximum delay in milliseconds to wait for a rate limit retry.
+     * If the server requests a longer delay, the request fails immediately.
+     * Default is 60000 (60 seconds).
+     */
+    maxNetworkRetryDelayMs: z
+        .number()
+        .optional()
+        .describe("Max delay in ms to wait for retry (default: 60000).")
+        .meta({ valueHint: "ms" }),
+    // Internal
+    manifestPath: z
+        .string()
+        .optional()
+        .describe("Path to a .zapierrc manifest file for app version locking.")
+        .meta({ internal: true }),
+    manifest: z
+        .custom()
+        .optional()
+        .describe("Manifest for app version locking.")
+        .meta({ internal: true }),
+    onEvent: z.custom().optional().meta({ internal: true }),
+    fetch: z.custom().optional().meta({ internal: true }),
+    eventEmission: z
+        .custom()
+        .optional()
+        .meta({ internal: true }),
+    // Deprecated
+    token: z.string().optional().meta({ deprecated: true }), // Use credentials instead
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",