@zapier/zapier-sdk 0.31.1 → 0.31.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @zapier/zapier-sdk
 
+## 0.31.2
+
+### Patch Changes
+
+- 1ae0349: Improve error message when credentials can't be found. Also improve module resolution for login module.
+
 ## 0.31.1
 
 ### Patch Changes

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAGjB,MAAM,SAAS,CAAC;AA2nBjB,eAAO,MAAM,eAAe,GAAI,SAAS,gBAAgB,KAAG,SAW3D,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAGjB,MAAM,SAAS,CAAC;AA2oBjB,eAAO,MAAM,eAAe,GAAI,SAAS,gBAAgB,KAAG,SAW3D,CAAC"}

package/dist/api/client.js

@@ -7,7 +7,7 @@
 import { getAuthorizationHeader } from "./auth";
 import { createDebugLogger, createDebugFetch } from "./debug";
 import { pollUntilComplete } from "./polling";
-import { resolveAuthToken, invalidateCredentialsToken } from "../auth";
+import { resolveAuthToken, invalidateCredentialsToken, isCliLoginAvailable, } from "../auth";
 import { getZapierBaseUrl } from "../utils/url-utils";
 import { sleep, calculateExponentialBackoffMs } from "../utils/retry-utils";
 import { isPlainObject } from "../utils/type-guard-utils";
@@ -421,7 +421,20 @@ class ZapierApiClient {
         // before we even make a request.
         if (options.authRequired) {
             if (headers.get("Authorization") == null && authToken == null) {
-                throw new ZapierAuthenticationError(`Authentication required but no credentials available. Please set ZAPIER_CREDENTIALS, or run the 'login' command with the CLI.`);
+                const message = isCliLoginAvailable() === false
+                    ? "Authentication required but no credentials available. " +
+                        "To use CLI login, install the CLI as a dev dependency " +
+                        "(e.g. `npm install -D @zapier/zapier-sdk-cli`) and " +
+                        "log in (e.g. `npx zapier-sdk login`). " +
+                        "Alternatively, set the ZAPIER_CREDENTIALS environment variable " +
+                        "or ZAPIER_CREDENTIALS_CLIENT_ID and " +
+                        "ZAPIER_CREDENTIALS_CLIENT_SECRET environment variables."
+                    : "Authentication required but no credentials available. " +
+                        "Please log in (e.g. `npx zapier-sdk login`) or set the " +
+                        "ZAPIER_CREDENTIALS environment variable or " +
+                        "ZAPIER_CREDENTIALS_CLIENT_ID and " +
+                        "ZAPIER_CREDENTIALS_CLIENT_SECRET environment variables.";
+                throw new ZapierAuthenticationError(message);
             }
         }
         return headers;

package/dist/auth.d.ts

@@ -56,10 +56,14 @@ interface CliLoginOptions {
     debug?: boolean;
 }
 /**
- * Attempts to get a token by optionally importing from CLI login package.
- * This provides a graceful fallback when the CLI login package is not available.
+ * Returns whether a CLI login package is available.
+ * `undefined` if no import has been attempted yet, `true` if found, `false` if not.
+ */
+export declare function isCliLoginAvailable(): boolean | undefined;
+/**
+ * Attempts to get a token from the CLI login package.
  *
- * Returns undefined if no valid token is found or CLI package is not available.
+ * Returns undefined if no valid token is found or no login package is available.
  * Throws if there's an actual error (like token refresh failure).
  */
 export declare function getTokenFromCliLogin(options: CliLoginOptions): Promise<string | undefined>;

package/dist/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,qBAAqB,CAAC;AAM5E,YAAY,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA+BD;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AA0CD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CAIN;AA6HD;;GAEG;AACH,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkB7B;AA6ED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE;IACxD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhB"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAuB,MAAM,qBAAqB,CAAC;AAM5E,YAAY,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA+BD;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAItC;AA0CD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,GACf,IAAI,CAIN;AA6HD;;GAEG;AACH,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAsCD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,GAAG,SAAS,CAGzD;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAK7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkB7B;AA6ED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE;IACxD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhB"}

package/dist/auth.js

@@ -36,6 +36,7 @@ function buildCacheKey(clientId, scopes) {
 export function clearTokenCache() {
     tokenCache.clear();
     pendingExchanges.clear();
+    cachedCliLogin = undefined;
 }
 const TOKEN_EXPIRATION_BUFFER = 5 * 60 * 1000; // 5 minutes
 /**
@@ -169,26 +170,56 @@ async function exchangeClientCredentials(options) {
     });
     return data.access_token;
 }
+let cachedCliLogin;
 /**
- * Attempts to get a token by optionally importing from CLI login package.
- * This provides a graceful fallback when the CLI login package is not available.
+ * Dynamically imports a CLI login package with caching.
  *
- * Returns undefined if no valid token is found or CLI package is not available.
- * Throws if there's an actual error (like token refresh failure).
+ * Tries `@zapier/zapier-sdk-cli/login` first (available when the CLI is a
+ * direct dependency), then falls back to `@zapier/zapier-sdk-cli-login` (for
+ * users who install the lightweight login package directly).
+ *
+ * Returns the module if found, or `undefined` if neither package is available.
+ * The result is cached after the first attempt.
  */
-export async function getTokenFromCliLogin(options) {
-    // Dynamically import the CLI login package if available.
-    // This is intentionally an async import because this module is a dependency
-    // of the CLI and is only available when the CLI is installed!
-    let cliLogin;
+async function getCliLogin() {
+    if (cachedCliLogin !== undefined) {
+        return cachedCliLogin || undefined;
+    }
+    try {
+        cachedCliLogin = await import("@zapier/zapier-sdk-cli/login");
+        return cachedCliLogin;
+    }
+    catch {
+        // First path not available, try fallback
+    }
     try {
-        cliLogin = await import("@zapier/zapier-sdk-cli-login");
+        cachedCliLogin = await import("@zapier/zapier-sdk-cli-login");
+        return cachedCliLogin;
     }
     catch {
-        // CLI login package is not available, return undefined
+        cachedCliLogin = false;
         return undefined;
     }
-    // Call getToken - let any errors (like refresh failures) propagate
+}
+/**
+ * Returns whether a CLI login package is available.
+ * `undefined` if no import has been attempted yet, `true` if found, `false` if not.
+ */
+export function isCliLoginAvailable() {
+    if (cachedCliLogin === undefined)
+        return undefined;
+    return cachedCliLogin !== false;
+}
+/**
+ * Attempts to get a token from the CLI login package.
+ *
+ * Returns undefined if no valid token is found or no login package is available.
+ * Throws if there's an actual error (like token refresh failure).
+ */
+export async function getTokenFromCliLogin(options) {
+    const cliLogin = await getCliLogin();
+    if (!cliLogin)
+        return undefined;
     return await cliLogin.getToken(options);
 }
 /**

package/dist/auth.test.js

@@ -1,8 +1,12 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
 import * as auth from "./auth";
 import { resetDeprecationWarnings } from "./utils/logging";
-// Mock the CLI login package
+// Mock both CLI login import paths (SDK tries @zapier/zapier-sdk-cli/login
+// first, then falls back to @zapier/zapier-sdk-cli-login)
 const mockGetToken = vi.fn();
+vi.mock("@zapier/zapier-sdk-cli/login", () => ({
+    getToken: mockGetToken,
+}));
 vi.mock("@zapier/zapier-sdk-cli-login", () => ({
     getToken: mockGetToken,
 }));
@@ -41,6 +45,11 @@ describe("auth", () => {
             mockGetToken.mockRejectedValue(new Error("Token refresh failed"));
             await expect(auth.getTokenFromCliLogin({})).rejects.toThrow("Token refresh failed");
         });
+        it("should set isCliLoginAvailable to true when import succeeds", async () => {
+            mockGetToken.mockResolvedValue("cli-token");
+            await auth.getTokenFromCliLogin({});
+            expect(auth.isCliLoginAvailable()).toBe(true);
+        });
     });
     describe("resolveAuthToken", () => {
         it("should return string credentials directly", async () => {

package/dist/index.cjs

@@ -4168,6 +4168,7 @@ function buildCacheKey(clientId, scopes) {
 function clearTokenCache() {
   tokenCache.clear();
   pendingExchanges.clear();
+  cachedCliLogin = void 0;
 }
 var TOKEN_EXPIRATION_BUFFER = 5 * 60 * 1e3;
 function getCachedToken(clientId, scopes) {
@@ -4272,13 +4273,31 @@ async function exchangeClientCredentials(options) {
   });
   return data.access_token;
 }
-async function getTokenFromCliLogin(options) {
-  let cliLogin;
+var cachedCliLogin;
+async function getCliLogin() {
+  if (cachedCliLogin !== void 0) {
+    return cachedCliLogin || void 0;
+  }
+  try {
+    cachedCliLogin = await import('@zapier/zapier-sdk-cli/login');
+    return cachedCliLogin;
+  } catch {
+  }
   try {
-    cliLogin = await import('@zapier/zapier-sdk-cli-login');
+    cachedCliLogin = await import('@zapier/zapier-sdk-cli-login');
+    return cachedCliLogin;
   } catch {
+    cachedCliLogin = false;
     return void 0;
   }
+}
+function isCliLoginAvailable() {
+  if (cachedCliLogin === void 0) return void 0;
+  return cachedCliLogin !== false;
+}
+async function getTokenFromCliLogin(options) {
+  const cliLogin = await getCliLogin();
+  if (!cliLogin) return void 0;
   return await cliLogin.getToken(options);
 }
 async function resolveAuthToken(options = {}) {
@@ -4704,9 +4723,8 @@ var ZapierApiClient = class {
     }
     if (options.authRequired) {
       if (headers.get("Authorization") == null && authToken == null) {
-        throw new ZapierAuthenticationError(
-          `Authentication required but no credentials available. Please set ZAPIER_CREDENTIALS, or run the 'login' command with the CLI.`
-        );
+        const message = isCliLoginAvailable() === false ? "Authentication required but no credentials available. To use CLI login, install the CLI as a dev dependency (e.g. `npm install -D @zapier/zapier-sdk-cli`) and log in (e.g. `npx zapier-sdk login`). Alternatively, set the ZAPIER_CREDENTIALS environment variable or ZAPIER_CREDENTIALS_CLIENT_ID and ZAPIER_CREDENTIALS_CLIENT_SECRET environment variables." : "Authentication required but no credentials available. Please log in (e.g. `npx zapier-sdk login`) or set the ZAPIER_CREDENTIALS environment variable or ZAPIER_CREDENTIALS_CLIENT_ID and ZAPIER_CREDENTIALS_CLIENT_SECRET environment variables.";
+        throw new ZapierAuthenticationError(message);
       }
     }
     return headers;
@@ -5469,7 +5487,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "0.31.1"};
+  version: "0.31.2"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {
@@ -6056,6 +6074,7 @@ exports.inputsResolver = inputsResolver;
 exports.invalidateCachedToken = invalidateCachedToken;
 exports.invalidateCredentialsToken = invalidateCredentialsToken;
 exports.isCi = isCi;
+exports.isCliLoginAvailable = isCliLoginAvailable;
 exports.isClientCredentials = isClientCredentials;
 exports.isCredentialsFunction = isCredentialsFunction;
 exports.isCredentialsObject = isCredentialsObject;

package/dist/index.d.mts

@@ -2623,10 +2623,14 @@ interface CliLoginOptions {
     debug?: boolean;
 }
 /**
- * Attempts to get a token by optionally importing from CLI login package.
- * This provides a graceful fallback when the CLI login package is not available.
+ * Returns whether a CLI login package is available.
+ * `undefined` if no import has been attempted yet, `true` if found, `false` if not.
+ */
+declare function isCliLoginAvailable(): boolean | undefined;
+/**
+ * Attempts to get a token from the CLI login package.
  *
- * Returns undefined if no valid token is found or CLI package is not available.
+ * Returns undefined if no valid token is found or no login package is available.
  * Throws if there's an actual error (like token refresh failure).
  */
 declare function getTokenFromCliLogin(options: CliLoginOptions): Promise<string | undefined>;
@@ -2949,4 +2953,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, 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 };
+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, isCliLoginAvailable, 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.mjs

@@ -4146,6 +4146,7 @@ function buildCacheKey(clientId, scopes) {
 function clearTokenCache() {
   tokenCache.clear();
   pendingExchanges.clear();
+  cachedCliLogin = void 0;
 }
 var TOKEN_EXPIRATION_BUFFER = 5 * 60 * 1e3;
 function getCachedToken(clientId, scopes) {
@@ -4250,13 +4251,31 @@ async function exchangeClientCredentials(options) {
   });
   return data.access_token;
 }
-async function getTokenFromCliLogin(options) {
-  let cliLogin;
+var cachedCliLogin;
+async function getCliLogin() {
+  if (cachedCliLogin !== void 0) {
+    return cachedCliLogin || void 0;
+  }
+  try {
+    cachedCliLogin = await import('@zapier/zapier-sdk-cli/login');
+    return cachedCliLogin;
+  } catch {
+  }
   try {
-    cliLogin = await import('@zapier/zapier-sdk-cli-login');
+    cachedCliLogin = await import('@zapier/zapier-sdk-cli-login');
+    return cachedCliLogin;
   } catch {
+    cachedCliLogin = false;
     return void 0;
   }
+}
+function isCliLoginAvailable() {
+  if (cachedCliLogin === void 0) return void 0;
+  return cachedCliLogin !== false;
+}
+async function getTokenFromCliLogin(options) {
+  const cliLogin = await getCliLogin();
+  if (!cliLogin) return void 0;
   return await cliLogin.getToken(options);
 }
 async function resolveAuthToken(options = {}) {
@@ -4682,9 +4701,8 @@ var ZapierApiClient = class {
     }
     if (options.authRequired) {
       if (headers.get("Authorization") == null && authToken == null) {
-        throw new ZapierAuthenticationError(
-          `Authentication required but no credentials available. Please set ZAPIER_CREDENTIALS, or run the 'login' command with the CLI.`
-        );
+        const message = isCliLoginAvailable() === false ? "Authentication required but no credentials available. To use CLI login, install the CLI as a dev dependency (e.g. `npm install -D @zapier/zapier-sdk-cli`) and log in (e.g. `npx zapier-sdk login`). Alternatively, set the ZAPIER_CREDENTIALS environment variable or ZAPIER_CREDENTIALS_CLIENT_ID and ZAPIER_CREDENTIALS_CLIENT_SECRET environment variables." : "Authentication required but no credentials available. Please log in (e.g. `npx zapier-sdk login`) or set the ZAPIER_CREDENTIALS environment variable or ZAPIER_CREDENTIALS_CLIENT_ID and ZAPIER_CREDENTIALS_CLIENT_SECRET environment variables.";
+        throw new ZapierAuthenticationError(message);
       }
     }
     return headers;
@@ -5447,7 +5465,7 @@ function getCpuTime() {
 
 // package.json
 var package_default = {
-  version: "0.31.1"};
+  version: "0.31.2"};
 
 // src/plugins/eventEmission/builders.ts
 function createBaseEvent(context = {}) {
@@ -5935,4 +5953,4 @@ var BaseSdkOptionsSchema = z.object({
   // Use credentials instead
 });
 
-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 };
+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, isCliLoginAvailable, 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/eventEmission/index.test.js

@@ -14,6 +14,9 @@ vi.mock("./transport", () => ({
 }));
 // Mock CLI login package - default to returning null context
 const mockGetToken = vi.fn().mockResolvedValue(undefined);
+vi.mock("@zapier/zapier-sdk-cli/login", () => ({
+    getToken: mockGetToken,
+}));
 vi.mock("@zapier/zapier-sdk-cli-login", () => ({
     getToken: mockGetToken,
 }));

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

@@ -11,7 +11,10 @@ const mockTransport = {
 vi.mock("../eventEmission/transport", () => ({
     createTransport: vi.fn(() => mockTransport),
 }));
-// Mock CLI login package - prevents real token resolution requests
+// Mock CLI login packages - prevents real token resolution requests
+vi.mock("@zapier/zapier-sdk-cli/login", () => ({
+    getToken: vi.fn().mockResolvedValue(undefined),
+}));
 vi.mock("@zapier/zapier-sdk-cli-login", () => ({
     getToken: vi.fn().mockResolvedValue(undefined),
 }));

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

@@ -11,7 +11,10 @@ const mockTransport = {
 vi.mock("../eventEmission/transport", () => ({
     createTransport: vi.fn(() => mockTransport),
 }));
-// Mock CLI login package - prevents real token resolution requests
+// Mock CLI login packages - prevents real token resolution requests
+vi.mock("@zapier/zapier-sdk-cli/login", () => ({
+    getToken: vi.fn().mockResolvedValue(undefined),
+}));
 vi.mock("@zapier/zapier-sdk-cli-login", () => ({
     getToken: vi.fn().mockResolvedValue(undefined),
 }));

package/package.json

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