@zapier/zapier-sdk 0.1.1 → 0.2.0

package/dist/api/client.js

@@ -11,7 +11,7 @@ const auth_1 = require("./auth");
 const debug_1 = require("./debug");
 const polling_1 = require("./polling");
 function createZapierApi(options) {
-    const { baseUrl, token, debug = false, fetch: originalFetch = globalThis.fetch, } = options;
+    const { baseUrl, token, getToken, debug = false, fetch: originalFetch = globalThis.fetch, } = options;
     const debugLog = (0, debug_1.createDebugLogger)(debug);
     const fetch = (0, debug_1.createDebugFetch)({ originalFetch, debugLog });
     // Helper to build full URLs
@@ -25,13 +25,23 @@ function createZapierApi(options) {
         return url.toString();
     }
     // Helper to build headers
-    function buildHeaders(options = {}) {
+    async function buildHeaders(options = {}) {
         const headers = {
             ...options.headers,
         };
         // Add auth header if token provided and not explicitly disabled
-        if (token && options.authRequired !== false) {
-            headers.Authorization = (0, auth_1.getAuthorizationHeader)(token);
+        if (options.authRequired !== false) {
+            let resolvedToken = token;
+            // Token resolution precedence: explicit token > getToken() > env var
+            if (!resolvedToken && getToken) {
+                resolvedToken = await getToken();
+            }
+            if (!resolvedToken) {
+                resolvedToken = process.env.ZAPIER_TOKEN;
+            }
+            if (resolvedToken) {
+                headers.Authorization = (0, auth_1.getAuthorizationHeader)(resolvedToken);
+            }
         }
         return headers;
     }
@@ -58,7 +68,7 @@ function createZapierApi(options) {
     // Helper to perform HTTP requests with JSON handling
     async function fetchJson(method, path, data, options = {}) {
         const url = buildUrl(path, options.searchParams);
-        const headers = buildHeaders(options);
+        const headers = await buildHeaders(options);
         // Add Content-Type for JSON requests with body data
         if (data && typeof data === "object") {
             headers["Content-Type"] = "application/json";
@@ -85,7 +95,7 @@ function createZapierApi(options) {
         },
         async poll(path, options = {}) {
             const url = buildUrl(path, options.searchParams);
-            const headers = buildHeaders(options);
+            const headers = await buildHeaders(options);
             return (0, polling_1.pollUntilComplete)({
                 fetch,
                 url,
@@ -98,5 +108,11 @@ function createZapierApi(options) {
                 resultExtractor: options.resultExtractor,
             });
         },
+        requireAuthTo(operation) {
+            // Check if any authentication method is available
+            if (!token && !getToken && !process.env.ZAPIER_TOKEN) {
+                throw new Error(`Authentication token is required to ${operation}. Please provide token in options or set ZAPIER_TOKEN environment variable.`);
+            }
+        },
     };
 }

package/dist/api/index.d.ts

@@ -6,6 +6,7 @@
  * polling, and provides consistent patterns across all services.
  */
 export type { ApiClient, ApiClientOptions, RequestOptions, PollOptions, DebugLogger, Integration, Action, Trigger, Field, Choice, ActionExecutionResult, ActionField, ActionFieldChoice, NeedsRequest, NeedsResponse, Authentication, AuthenticationsResponse, } from "./types";
+import type { ApiClient } from "./types";
 export { isJwt, getAuthorizationHeader } from "./auth";
 export { createDebugLogger, createDebugFetch } from "./debug";
 export { pollUntilComplete } from "./polling";
@@ -20,7 +21,8 @@ export declare function generateRequestId(): string;
 export declare function getOrCreateApiClient(config: {
     baseUrl?: string;
     token?: string;
-    api?: import("./types").ApiClient;
+    getToken?: () => Promise<string | undefined>;
+    api?: ApiClient;
     debug?: boolean;
     fetch?: typeof globalThis.fetch;
-}): import("./types").ApiClient;
+}): ApiClient;

package/dist/api/index.js

@@ -24,6 +24,8 @@ Object.defineProperty(exports, "pollUntilComplete", { enumerable: true, get: fun
 // Re-export the main client factory
 var client_1 = require("./client");
 Object.defineProperty(exports, "createZapierApi", { enumerable: true, get: function () { return client_1.createZapierApi; } });
+// Import for local use
+const client_2 = require("./client");
 // Utility Functions
 function generateRequestId() {
     return Math.random().toString(36).substring(2) + Date.now().toString(36);
@@ -35,16 +37,15 @@ function generateRequestId() {
  * @returns ApiClient instance
  */
 function getOrCreateApiClient(config) {
-    const { baseUrl = "https://zapier.com", token = process.env.ZAPIER_TOKEN, api: providedApi, debug = false, fetch: customFetch, } = config;
+    const { baseUrl = "https://zapier.com", token, getToken, api: providedApi, debug = false, fetch: customFetch, } = config;
     // Use provided API client or create a new one
     if (providedApi) {
         return providedApi;
     }
-    // Import createZapierApi locally to avoid circular imports
-    const { createZapierApi } = require("./client");
-    return createZapierApi({
+    return (0, client_2.createZapierApi)({
         baseUrl,
         token,
+        getToken,
         debug,
         fetch: customFetch,
     });

package/dist/api/types.d.ts

@@ -8,6 +8,7 @@
 export interface ApiClientOptions {
     baseUrl: string;
     token?: string;
+    getToken?: () => Promise<string | undefined>;
     debug?: boolean;
     fetch?: typeof globalThis.fetch;
 }
@@ -17,6 +18,7 @@ export interface ApiClient {
     put: (path: string, data?: any, options?: RequestOptions) => Promise<any>;
     delete: (path: string, options?: RequestOptions) => Promise<any>;
     poll: (path: string, options?: PollOptions) => Promise<any>;
+    requireAuthTo: (operation: string) => void;
 }
 export interface RequestOptions {
     headers?: Record<string, string>;

package/dist/functions/listAuthentications/index.js

@@ -13,11 +13,8 @@ const getApp_1 = require("../getApp");
  * @returns Promise<Authentication[]> with pagination metadata
  */
 async function listAuthentications(options = {}) {
-    const { token } = options;
-    if (!token && !process.env.ZAPIER_TOKEN) {
-        throw new Error("Authentication token is required to list authentications. Please provide token in options or set ZAPIER_TOKEN environment variable.");
-    }
     const api = (0, api_1.getOrCreateApiClient)(options);
+    api.requireAuthTo("list authentications");
     // Local function to handle the actual API fetching
     const listAuthenticationsInternal = async (options = {}) => {
         // Build search parameters

package/dist/functions/listAuthentications/schemas.d.ts

@@ -30,6 +30,8 @@ export type ListAuthenticationsOptions = z.infer<typeof ListAuthenticationsSchem
     baseUrl?: string;
     /** Authentication token */
     token?: string;
+    /** Function to dynamically resolve authentication token */
+    getToken?: () => Promise<string | undefined>;
     /** Optional pre-instantiated API client */
     api?: any;
     /** Enable debug logging */

package/dist/functions/runAction/index.js

@@ -15,10 +15,8 @@ const getApp_1 = require("../getApp");
  */
 async function runAction(options) {
     const { appKey, actionType, actionKey, inputs, authenticationId: providedAuthenticationId, token, } = options;
-    if (!token && !process.env.ZAPIER_TOKEN) {
-        throw new Error("Authentication token is required to run actions. Please provide token in options or set ZAPIER_TOKEN environment variable.");
-    }
     const api = (0, api_1.getOrCreateApiClient)(options);
+    api.requireAuthTo("run actions");
     // Validate that the action exists
     const actionData = await (0, getAction_1.getAction)({
         ...options,

package/dist/functions/runAction/schemas.d.ts

@@ -24,6 +24,8 @@ export type RunActionOptions = z.infer<typeof RunActionSchema> & {
     baseUrl?: string;
     /** Authentication token */
     token?: string;
+    /** Function to dynamically resolve authentication token */
+    getToken?: () => Promise<string | undefined>;
     /** Optional pre-instantiated API client */
     api?: any;
     /** Enable debug logging */

package/dist/sdk.js

@@ -43,24 +43,12 @@ const functionRegistry = [
 // Import plugin functions
 const index_1 = require("./plugins/apps/index");
 function createBaseZapierSdk(options = {}) {
-    // Auto-load .env files (searches up directory tree)
-    try {
-        const { findUpSync } = require("find-up");
-        const envPath = findUpSync(".env");
-        if (envPath) {
-            require("dotenv").config({ path: envPath, quiet: true });
-        }
-    }
-    catch {
-        // Silently fail if dotenv/find-up not available or .env not found
-    }
-    const { fetch: customFetch = globalThis.fetch, baseUrl = "https://zapier.com", token, debug = false, } = options;
-    // If no token provided, try to get it from environment variable
-    const finalToken = token || process.env.ZAPIER_TOKEN;
+    const { fetch: customFetch = globalThis.fetch, baseUrl = "https://zapier.com", token, getToken, debug = false, } = options;
     // Create the API client
     const api = (0, api_1.createZapierApi)({
         baseUrl,
-        token: finalToken,
+        token,
+        getToken,
         debug,
         fetch: customFetch,
     });
@@ -69,16 +57,16 @@ function createBaseZapierSdk(options = {}) {
         // Registry for CLI
         __registry: functionRegistry,
         // Function implementations with API config injection
-        listApps: (options = {}) => (0, listApps_1.listApps)({ ...options, api, token: finalToken }),
-        getApp: (options) => (0, getApp_1.getApp)({ ...options, api, token: finalToken }),
-        listActions: (options = {}) => (0, listActions_1.listActions)({ ...options, api, token: finalToken }),
-        getAction: (options) => (0, getAction_1.getAction)({ ...options, api, token: finalToken }),
-        runAction: (options) => (0, runAction_1.runAction)({ ...options, api, token: finalToken }),
-        listAuthentications: (options = {}) => (0, listAuthentications_1.listAuthentications)({ ...options, api, token: finalToken }),
-        findFirstAuthentication: (options = {}) => (0, findFirstAuthentication_1.findFirstAuthentication)({ ...options, api, token: finalToken }),
-        findUniqueAuthentication: (options = {}) => (0, findUniqueAuthentication_1.findUniqueAuthentication)({ ...options, api, token: finalToken }),
-        listFields: (options) => (0, listFields_1.listFields)({ ...options, api, token: finalToken }),
-        generateTypes: (options) => (0, generateTypes_1.generateTypes)({ ...options, api, token: finalToken }),
+        listApps: (options = {}) => (0, listApps_1.listApps)({ ...options, api }),
+        getApp: (options) => (0, getApp_1.getApp)({ ...options, api }),
+        listActions: (options = {}) => (0, listActions_1.listActions)({ ...options, api }),
+        getAction: (options) => (0, getAction_1.getAction)({ ...options, api }),
+        runAction: (options) => (0, runAction_1.runAction)({ ...options, api }),
+        listAuthentications: (options = {}) => (0, listAuthentications_1.listAuthentications)({ ...options, api }),
+        findFirstAuthentication: (options = {}) => (0, findFirstAuthentication_1.findFirstAuthentication)({ ...options, api }),
+        findUniqueAuthentication: (options = {}) => (0, findUniqueAuthentication_1.findUniqueAuthentication)({ ...options, api }),
+        listFields: (options) => (0, listFields_1.listFields)({ ...options, api }),
+        generateTypes: (options) => (0, generateTypes_1.generateTypes)({ ...options, api }),
         bundleCode: (options) => (0, bundleCode_1.bundleCode)(options), // No API config needed
     };
     return sdk;
@@ -87,19 +75,19 @@ function createZapierSdk(options = {}) {
     // Create base SDK
     const baseSdk = createBaseZapierSdk(options);
     // Extract options needed for plugins
-    const { fetch: customFetch = globalThis.fetch, baseUrl = "https://zapier.com", token, debug = false, } = options;
-    const finalToken = token || process.env.ZAPIER_TOKEN;
+    const { fetch: customFetch = globalThis.fetch, baseUrl = "https://zapier.com", token, getToken, debug = false, } = options;
     // Create the API client for plugins
     const api = (0, api_1.createZapierApi)({
         baseUrl,
-        token: finalToken,
+        token,
+        getToken,
         debug,
         fetch: customFetch,
     });
     // Create plugins directly - TypeScript will enforce correct implementation
     const appsPlugin = (0, index_1.createAppsPlugin)({
         api,
-        token: finalToken,
+        token,
     });
     // Compose final SDK - TypeScript will enforce we have all required properties
     const fullSdk = {

package/dist/types/domain.d.ts

@@ -8,6 +8,7 @@ export interface AuthObject {
 }
 export interface BaseSdkOptions {
     token?: string;
+    getToken?: () => Promise<string | undefined>;
     fetch?: typeof fetch;
     baseUrl?: string;
     debug?: boolean;

package/dist/utils/getTokenFromConfig.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Attempts to read the JWT token from the CLI config file.
+ * This is a synchronous function that only returns valid, non-expired tokens.
+ * For token refresh logic, the CLI should handle that separately.
+ * Returns undefined if config file doesn't exist, token is not available, or token is expired.
+ */
+export declare function getTokenFromConfig(): string | undefined;

package/dist/utils/getTokenFromConfig.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTokenFromConfig = getTokenFromConfig;
+/**
+ * Attempts to read the JWT token from the CLI config file.
+ * This is a synchronous function that only returns valid, non-expired tokens.
+ * For token refresh logic, the CLI should handle that separately.
+ * Returns undefined if config file doesn't exist, token is not available, or token is expired.
+ */
+function getTokenFromConfig() {
+    try {
+        // Dynamically import conf to avoid dependency issues if not installed
+        const Conf = require("conf");
+        const config = new Conf({ projectName: "zapier-sdk-cli" });
+        // Get the stored JWT token
+        const jwt = config.get("login_jwt");
+        const expiresAt = config.get("login_expires_at");
+        // Check if token exists and is not expired (with 30s buffer)
+        if (jwt && expiresAt && expiresAt > Date.now() + 30 * 1000) {
+            return jwt;
+        }
+        // Token is missing or expired - return undefined so SDK will require explicit auth
+        return undefined;
+    }
+    catch {
+        // Config package not available or other error - silently fail
+        return undefined;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zapier/zapier-sdk",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Complete Zapier SDK - combines all Zapier SDK packages",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,9 +18,7 @@
     "access": "restricted"
   },
   "dependencies": {
-    "dotenv": "^17.0.0",
     "esbuild": "^0.25.5",
-    "find-up": "^7.0.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {

package/src/api/client.ts

@@ -19,6 +19,7 @@ export function createZapierApi(options: ApiClientOptions): ApiClient {
   const {
     baseUrl,
     token,
+    getToken,
     debug = false,
     fetch: originalFetch = globalThis.fetch,
   } = options;
@@ -41,14 +42,29 @@ export function createZapierApi(options: ApiClientOptions): ApiClient {
   }
 
   // Helper to build headers
-  function buildHeaders(options: RequestOptions = {}): Record<string, string> {
+  async function buildHeaders(
+    options: RequestOptions = {},
+  ): Promise<Record<string, string>> {
     const headers: Record<string, string> = {
       ...options.headers,
     };
 
     // Add auth header if token provided and not explicitly disabled
-    if (token && options.authRequired !== false) {
-      headers.Authorization = getAuthorizationHeader(token);
+    if (options.authRequired !== false) {
+      let resolvedToken = token;
+
+      // Token resolution precedence: explicit token > getToken() > env var
+      if (!resolvedToken && getToken) {
+        resolvedToken = await getToken();
+      }
+
+      if (!resolvedToken) {
+        resolvedToken = process.env.ZAPIER_TOKEN;
+      }
+
+      if (resolvedToken) {
+        headers.Authorization = getAuthorizationHeader(resolvedToken);
+      }
     }
 
     return headers;
@@ -87,7 +103,7 @@ export function createZapierApi(options: ApiClientOptions): ApiClient {
     options: RequestOptions = {},
   ): Promise<any> {
     const url = buildUrl(path, options.searchParams);
-    const headers = buildHeaders(options);
+    const headers = await buildHeaders(options);
 
     // Add Content-Type for JSON requests with body data
     if (data && typeof data === "object") {
@@ -130,7 +146,7 @@ export function createZapierApi(options: ApiClientOptions): ApiClient {
 
     async poll(path: string, options: PollOptions = {}): Promise<any> {
       const url = buildUrl(path, options.searchParams);
-      const headers = buildHeaders(options);
+      const headers = await buildHeaders(options);
 
       return pollUntilComplete({
         fetch,
@@ -144,5 +160,14 @@ export function createZapierApi(options: ApiClientOptions): ApiClient {
         resultExtractor: options.resultExtractor,
       });
     },
+
+    requireAuthTo(operation: string): void {
+      // Check if any authentication method is available
+      if (!token && !getToken && !process.env.ZAPIER_TOKEN) {
+        throw new Error(
+          `Authentication token is required to ${operation}. Please provide token in options or set ZAPIER_TOKEN environment variable.`,
+        );
+      }
+    },
   };
 }

package/src/api/index.ts

@@ -29,6 +29,9 @@ export type {
   AuthenticationsResponse,
 } from "./types";
 
+// Import for local use
+import type { ApiClient } from "./types";
+
 // Re-export authentication utilities
 export { isJwt, getAuthorizationHeader } from "./auth";
 
@@ -41,6 +44,9 @@ export { pollUntilComplete } from "./polling";
 // Re-export the main client factory
 export { createZapierApi } from "./client";
 
+// Import for local use
+import { createZapierApi } from "./client";
+
 // Utility Functions
 export function generateRequestId(): string {
   return Math.random().toString(36).substring(2) + Date.now().toString(36);
@@ -55,13 +61,15 @@ export function generateRequestId(): string {
 export function getOrCreateApiClient(config: {
   baseUrl?: string;
   token?: string;
-  api?: import("./types").ApiClient;
+  getToken?: () => Promise<string | undefined>;
+  api?: ApiClient;
   debug?: boolean;
   fetch?: typeof globalThis.fetch;
-}): import("./types").ApiClient {
+}): ApiClient {
   const {
     baseUrl = "https://zapier.com",
-    token = process.env.ZAPIER_TOKEN,
+    token,
+    getToken,
     api: providedApi,
     debug = false,
     fetch: customFetch,
@@ -72,11 +80,10 @@ export function getOrCreateApiClient(config: {
     return providedApi;
   }
 
-  // Import createZapierApi locally to avoid circular imports
-  const { createZapierApi } = require("./client");
   return createZapierApi({
     baseUrl,
     token,
+    getToken,
     debug,
     fetch: customFetch,
   });

package/src/api/types.ts

@@ -13,6 +13,7 @@
 export interface ApiClientOptions {
   baseUrl: string;
   token?: string;
+  getToken?: () => Promise<string | undefined>;
   debug?: boolean;
   fetch?: typeof globalThis.fetch;
 }
@@ -23,6 +24,7 @@ export interface ApiClient {
   put: (path: string, data?: any, options?: RequestOptions) => Promise<any>;
   delete: (path: string, options?: RequestOptions) => Promise<any>;
   poll: (path: string, options?: PollOptions) => Promise<any>;
+  requireAuthTo: (operation: string) => void;
 }
 
 export interface RequestOptions {

package/src/functions/listAuthentications/index.ts

@@ -18,15 +18,8 @@ import type { ListAuthenticationsOptions } from "./schemas";
 export async function listAuthentications(
   options: Partial<ListAuthenticationsOptions> = {},
 ): Promise<Authentication[]> {
-  const { token } = options;
-
-  if (!token && !process.env.ZAPIER_TOKEN) {
-    throw new Error(
-      "Authentication token is required to list authentications. Please provide token in options or set ZAPIER_TOKEN environment variable.",
-    );
-  }
-
   const api = getOrCreateApiClient(options);
+  api.requireAuthTo("list authentications");
 
   // Local function to handle the actual API fetching
   const listAuthenticationsInternal = async (

package/src/functions/listAuthentications/schemas.ts

@@ -44,6 +44,8 @@ export type ListAuthenticationsOptions = z.infer<
   baseUrl?: string;
   /** Authentication token */
   token?: string;
+  /** Function to dynamically resolve authentication token */
+  getToken?: () => Promise<string | undefined>;
   /** Optional pre-instantiated API client */
   api?: any;
   /** Enable debug logging */

package/src/functions/runAction/index.ts

@@ -25,13 +25,8 @@ export async function runAction(
     token,
   } = options;
 
-  if (!token && !process.env.ZAPIER_TOKEN) {
-    throw new Error(
-      "Authentication token is required to run actions. Please provide token in options or set ZAPIER_TOKEN environment variable.",
-    );
-  }
-
   const api = getOrCreateApiClient(options);
+  api.requireAuthTo("run actions");
 
   // Validate that the action exists
   const actionData = await getAction({

package/src/functions/runAction/schemas.ts

@@ -27,6 +27,8 @@ export type RunActionOptions = z.infer<typeof RunActionSchema> & {
   baseUrl?: string;
   /** Authentication token */
   token?: string;
+  /** Function to dynamically resolve authentication token */
+  getToken?: () => Promise<string | undefined>;
   /** Optional pre-instantiated API client */
   api?: any;
   /** Enable debug logging */

package/src/sdk.ts

@@ -77,31 +77,19 @@ export interface ZapierSdkOptions extends BaseSdkOptions {}
 function createBaseZapierSdk(
   options: ZapierSdkOptions = {},
 ): BaseZapierSdkWithFunctions {
-  // Auto-load .env files (searches up directory tree)
-  try {
-    const { findUpSync } = require("find-up");
-    const envPath = findUpSync(".env");
-    if (envPath) {
-      require("dotenv").config({ path: envPath, quiet: true });
-    }
-  } catch {
-    // Silently fail if dotenv/find-up not available or .env not found
-  }
-
   const {
     fetch: customFetch = globalThis.fetch,
     baseUrl = "https://zapier.com",
     token,
+    getToken,
     debug = false,
   } = options;
 
-  // If no token provided, try to get it from environment variable
-  const finalToken = token || process.env.ZAPIER_TOKEN;
-
   // Create the API client
   const api = createZapierApi({
     baseUrl,
-    token: finalToken,
+    token,
+    getToken,
     debug,
     fetch: customFetch,
   });
@@ -112,22 +100,19 @@ function createBaseZapierSdk(
     __registry: functionRegistry,
 
     // Function implementations with API config injection
-    listApps: (options = {}) =>
-      listApps({ ...options, api, token: finalToken }),
-    getApp: (options) => getApp({ ...options, api, token: finalToken }),
-    listActions: (options = {}) =>
-      listActions({ ...options, api, token: finalToken }),
-    getAction: (options) => getAction({ ...options, api, token: finalToken }),
-    runAction: (options) => runAction({ ...options, api, token: finalToken }),
+    listApps: (options = {}) => listApps({ ...options, api }),
+    getApp: (options) => getApp({ ...options, api }),
+    listActions: (options = {}) => listActions({ ...options, api }),
+    getAction: (options) => getAction({ ...options, api }),
+    runAction: (options) => runAction({ ...options, api }),
     listAuthentications: (options = {}) =>
-      listAuthentications({ ...options, api, token: finalToken }),
+      listAuthentications({ ...options, api }),
     findFirstAuthentication: (options = {}) =>
-      findFirstAuthentication({ ...options, api, token: finalToken }),
+      findFirstAuthentication({ ...options, api }),
     findUniqueAuthentication: (options = {}) =>
-      findUniqueAuthentication({ ...options, api, token: finalToken }),
-    listFields: (options) => listFields({ ...options, api, token: finalToken }),
-    generateTypes: (options) =>
-      generateTypes({ ...options, api, token: finalToken }),
+      findUniqueAuthentication({ ...options, api }),
+    listFields: (options) => listFields({ ...options, api }),
+    generateTypes: (options) => generateTypes({ ...options, api }),
     bundleCode: (options) => bundleCode(options), // No API config needed
   };
 
@@ -143,15 +128,15 @@ export function createZapierSdk(options: ZapierSdkOptions = {}): ZapierSdk {
     fetch: customFetch = globalThis.fetch,
     baseUrl = "https://zapier.com",
     token,
+    getToken,
     debug = false,
   } = options;
 
-  const finalToken = token || process.env.ZAPIER_TOKEN;
-
   // Create the API client for plugins
   const api = createZapierApi({
     baseUrl,
-    token: finalToken,
+    token,
+    getToken,
     debug,
     fetch: customFetch,
   });
@@ -159,7 +144,7 @@ export function createZapierSdk(options: ZapierSdkOptions = {}): ZapierSdk {
   // Create plugins directly - TypeScript will enforce correct implementation
   const appsPlugin = createAppsPlugin({
     api,
-    token: finalToken,
+    token,
   });
 
   // Compose final SDK - TypeScript will enforce we have all required properties

package/src/types/domain.ts

@@ -26,6 +26,7 @@ export interface AuthObject {
 
 export interface BaseSdkOptions {
   token?: string;
+  getToken?: () => Promise<string | undefined>;
   fetch?: typeof fetch;
   baseUrl?: string;
   debug?: boolean;

package/src/utils/getTokenFromConfig.ts

@@ -0,0 +1,28 @@
+/**
+ * Attempts to read the JWT token from the CLI config file.
+ * This is a synchronous function that only returns valid, non-expired tokens.
+ * For token refresh logic, the CLI should handle that separately.
+ * Returns undefined if config file doesn't exist, token is not available, or token is expired.
+ */
+export function getTokenFromConfig(): string | undefined {
+  try {
+    // Dynamically import conf to avoid dependency issues if not installed
+    const Conf = require("conf");
+    const config = new Conf({ projectName: "zapier-sdk-cli" });
+
+    // Get the stored JWT token
+    const jwt = config.get("login_jwt") as string | undefined;
+    const expiresAt = config.get("login_expires_at") as number | undefined;
+
+    // Check if token exists and is not expired (with 30s buffer)
+    if (jwt && expiresAt && expiresAt > Date.now() + 30 * 1000) {
+      return jwt;
+    }
+
+    // Token is missing or expired - return undefined so SDK will require explicit auth
+    return undefined;
+  } catch {
+    // Config package not available or other error - silently fail
+    return undefined;
+  }
+}