@amaster.ai/client 1.1.0-beta.4 → 1.1.0-beta.41

package/dist/index.cjs

@@ -8,11 +8,18 @@ var asrClient = require('@amaster.ai/asr-client');
 var copilotClient = require('@amaster.ai/copilot-client');
 var functionClient = require('@amaster.ai/function-client');
 var ttsClient = require('@amaster.ai/tts-client');
+var s3Client = require('@amaster.ai/s3-client');
 var httpClient = require('@amaster.ai/http-client');
 
 // src/client.ts
 function createClient(options) {
-  const { baseURL, headers = {}, onUnauthorized, onTokenExpired } = options;
+  const {
+    baseURL,
+    headers = {},
+    onUnauthorized,
+    onTokenExpired,
+    autoHandleOAuthCallback
+  } = options;
   const baseHttpClient = httpClient.createHttpClient({
     baseURL,
     headers
@@ -21,9 +28,34 @@ function createClient(options) {
     baseURL,
     headers,
     onTokenExpired,
-    onUnauthorized
+    onUnauthorized,
+    autoHandleOAuthCallback
   });
   const createAuthenticatedHttpClient = () => {
+    let isRefreshing = false;
+    let refreshPromise = null;
+    function isTokenExpired(result) {
+      if (result.status !== 401) return false;
+      if (result.error?.message && /expired/i.test(result.error.message)) {
+        return true;
+      }
+      if (result.error?.details) {
+        const details = result.error.details;
+        if (typeof details === "string" && /expired/i.test(details)) {
+          return true;
+        }
+        if (typeof details === "object" && details !== null) {
+          const detailsObj = details;
+          if (typeof detailsObj.message === "string" && /expired/i.test(detailsObj.message)) {
+            return true;
+          }
+        }
+      }
+      if (typeof result.data === "string" && /expired/i.test(result.data)) {
+        return true;
+      }
+      return !!auth.getAccessToken();
+    }
     return {
       async request(config) {
         const token = auth.getAccessToken();
@@ -35,9 +67,43 @@ function createClient(options) {
             ...authHeaders
           }
         };
-        const result = await baseHttpClient.request(mergedConfig);
-        if (result.status === 401 && onUnauthorized) {
-          onUnauthorized();
+        let result = await baseHttpClient.request(mergedConfig);
+        if (result.status === 401) {
+          if (isTokenExpired(result)) {
+            if (!isRefreshing) {
+              isRefreshing = true;
+              refreshPromise = (async () => {
+                try {
+                  const refreshResult = await auth.refreshToken();
+                  return !!refreshResult.data;
+                } finally {
+                  isRefreshing = false;
+                  refreshPromise = null;
+                }
+              })();
+            }
+            const refreshed = await refreshPromise;
+            if (refreshed) {
+              const newToken = auth.getAccessToken();
+              const retryHeaders = {
+                ...config.headers,
+                ...newToken ? { Authorization: `Bearer ${newToken}` } : {}
+              };
+              const retryConfig = {
+                ...config,
+                headers: retryHeaders
+              };
+              result = await baseHttpClient.request(retryConfig);
+            } else {
+              if (onUnauthorized) {
+                onUnauthorized();
+              }
+            }
+          } else {
+            if (onUnauthorized) {
+              onUnauthorized();
+            }
+          }
         }
         return result;
       }
@@ -48,9 +114,18 @@ function createClient(options) {
   const bpm = bpmClient.createBpmClient(authenticatedHttpClient);
   const workflow = workflowClient.createWorkflowClient(authenticatedHttpClient);
   const functionClient$1 = functionClient.createFunctionClient(authenticatedHttpClient);
-  const copilot = copilotClient.createCopilotA2UIClient(authenticatedHttpClient);
-  const asr = asrClient.createASRClient({});
-  const tts = ttsClient.createTTSClient({});
+  const copilot = copilotClient.createCopilotA2UIClient(
+    authenticatedHttpClient,
+    baseURL,
+    () => auth.getAccessToken()
+  );
+  const s3 = s3Client.createS3Client(authenticatedHttpClient);
+  const asr = asrClient.createASRClient({
+    getAccessToken: () => auth.getAccessToken()
+  });
+  const tts = ttsClient.createTTSClient({
+    getAccessToken: () => auth.getAccessToken()
+  });
   const client = {
     auth,
     entity,
@@ -60,6 +135,7 @@ function createClient(options) {
     copilot,
     function: functionClient$1,
     tts,
+    s3,
     // Expose token management methods from auth client
     isAuthenticated: () => auth.isAuthenticated(),
     getAccessToken: () => auth.getAccessToken(),

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"names":["createHttpClient","createAuthClient","createEntityClient","createBpmClient","createWorkflowClient","functionClient","createFunctionClient","createCopilotA2UIClient","createASRClient","createTTSClient"],"mappings":";;;;;;;;;;;;;AA8FO,SAAS,aAAa,OAAA,EAA8C;AACzE,EAAA,MAAM,EAAE,OAAA,EAAS,OAAA,GAAU,EAAC,EAAG,cAAA,EAAgB,gBAAe,GAAI,OAAA;AAGlE,EAAA,MAAM,iBAAiBA,2BAAA,CAAiB;AAAA,IACtC,OAAA;AAAA,IACA;AAAA,GACD,CAAA;AAGD,EAAA,MAAM,OAAmBC,2BAAA,CAAiB;AAAA,IACxC,OAAA;AAAA,IACA,OAAA;AAAA,IACA,cAAA;AAAA,IACA;AAAA,GACD,CAAA;AAGD,EAAA,MAAM,gCAAgC,MAAkB;AACtD,IAAA,OAAO;AAAA,MACL,MAAM,QAAW,MAAA,EAAiD;AAEhE,QAAA,MAAM,KAAA,GAAQ,KAAK,cAAA,EAAe;AAGlC,QAAA,MAAM,WAAA,GAAc,QAAQ,EAAE,aAAA,EAAe,UAAU,KAAK,CAAA,CAAA,KAAO,EAAC;AACpE,QAAA,MAAM,YAAA,GAA8B;AAAA,UAClC,GAAG,MAAA;AAAA,UACH,OAAA,EAAS;AAAA,YACP,GAAG,MAAA,CAAO,OAAA;AAAA,YACV,GAAG;AAAA;AACL,SACF;AAGA,QAAA,MAAM,MAAA,GAAS,MAAM,cAAA,CAAe,OAAA,CAAW,YAAY,CAAA;AAG3D,QAAA,IAAI,MAAA,CAAO,MAAA,KAAW,GAAA,IAAO,cAAA,EAAgB;AAC3C,UAAA,cAAA,EAAe;AAAA,QACjB;AAEA,QAAA,OAAO,MAAA;AAAA,MACT;AAAA,KACF;AAAA,EACF,CAAA;AAGA,EAAA,MAAM,0BAA0B,6BAAA,EAA8B;AAG9D,EAAA,MAAM,MAAA,GAAuBC,gCAAmB,uBAAuB,CAAA;AACvE,EAAA,MAAM,GAAA,GAAiBC,0BAAgB,uBAAuB,CAAA;AAC9D,EAAA,MAAM,QAAA,GAA2BC,oCAAqB,uBAAuB,CAAA;AAC7E,EAAA,MAAMC,gBAAA,GAAiCC,oCAAqB,uBAAuB,CAAA;AACnF,EAAA,MAAM,OAAA,GAA6BC,sCAAwB,uBAAuB,CAAA;AAIlF,EAAA,MAAM,GAAA,GAAiBC,yBAAA,CAAgB,EAAE,CAAA;AACzC,EAAA,MAAM,GAAA,GAAiBC,yBAAA,CAAgB,EAAE,CAAA;AAGzC,EAAA,MAAM,MAAA,GAAwB;AAAA,IAC5B,IAAA;AAAA,IACA,MAAA;AAAA,IACA,GAAA;AAAA,IACA,QAAA;AAAA,IACA,GAAA;AAAA,IACA,OAAA;AAAA,IACA,QAAA,EAAUJ,gBAAA;AAAA,IACV,GAAA;AAAA;AAAA,IAGA,eAAA,EAAiB,MAAM,IAAA,CAAK,eAAA,EAAgB;AAAA,IAC5C,cAAA,EAAgB,MAAM,IAAA,CAAK,cAAA,EAAe;AAAA,IAC1C,cAAA,EAAgB,CAAC,KAAA,KAAkB,IAAA,CAAK,eAAe,KAAK,CAAA;AAAA,IAC5D,SAAA,EAAW,MAAM,IAAA,CAAK,SAAA;AAAU,GAClC;AAEA,EAAA,OAAO,MAAA;AACT","file":"index.cjs","sourcesContent":["/**\n * ============================================================================\n * @amaster.ai/client - Unified Amaster Client\n * ============================================================================\n * \n * Supabase-inspired unified API client for the Amaster platform\n * \n * Features:\n * - Single client instance for all services (auth, entity, bpm, workflow)\n * - Automatic token management and refresh\n * - Auto-attach authentication to all requests\n * - Centralized error handling\n * \n * @example\n * ```typescript\n * // With explicit baseURL\n * const client = createClient({\n *   baseURL: 'https://api.amaster.ai',\n *   onUnauthorized: () => window.location.href = '/login'\n * });\n * \n * // Auto-detect baseURL from env (Taro/Mini-program)\n * const client = createClient({\n *   onUnauthorized: () => window.location.href = '/login'\n * });\n * \n * // Login\n * await client.auth.login({ email, password });\n * \n * // All subsequent requests automatically include auth token\n * await client.entity.list('default', 'users');\n * await client.bpm.startProcess({ processKey: 'approval' });\n * ```\n */\n\nimport { createAuthClient, type AuthClient } from \"@amaster.ai/auth-client\";\nimport { createEntityClient, type EntityClient } from \"@amaster.ai/entity-client\";\nimport { createBpmClient, type BpmClient } from \"@amaster.ai/bpm-client\";\nimport { createWorkflowClient, type WorkflowClient } from \"@amaster.ai/workflow-client\";\nimport { createASRClient, type ASRClient } from \"@amaster.ai/asr-client\";\nimport { createCopilotA2UIClient, type CopilotA2UIClient } from \"@amaster.ai/copilot-client\";\nimport { createFunctionClient, type FunctionClient } from \"@amaster.ai/function-client\";\nimport { createTTSClient, type TTSClient } from \"@amaster.ai/tts-client\";\nimport { createHttpClient, type HttpClient, type RequestConfig, type ClientResult } from \"@amaster.ai/http-client\";\nimport type { AmasterClient, AmasterClientOptions } from \"./types\";\n\n/**\n * Create a unified Amaster client instance\n * \n * This function creates a single client that provides access to all Amaster services:\n * - Authentication (login, register, logout)\n * - Entity CRUD operations\n * - BPM (Business Process Management)\n * - Workflow execution\n * \n * All sub-clients automatically share the same HTTP client and authentication state,\n * ensuring that tokens are consistently attached to all requests.\n * \n * @param options - Client configuration options\n * @returns A unified Amaster client instance\n * \n * @example\n * ```typescript\n * // Basic usage with explicit baseURL\n * const client = createClient({\n *   baseURL: 'https://api.amaster.ai'\n * });\n * \n * // Auto-detect baseURL (for Taro/Mini-program or dev proxy)\n * const client = createClient({});\n * \n * // With authentication callbacks\n * const client = createClient({\n *   baseURL: 'https://api.amaster.ai',\n *   onUnauthorized: () => {\n *     // Redirect to login or show auth modal\n *     window.location.href = '/login';\n *   },\n *   onTokenExpired: () => {\n *     console.log('Token expired, refreshing...');\n *   }\n * });\n * \n * // Login\n * await client.auth.login({\n *   email: 'user@example.com',\n *   password: 'password123'\n * });\n * \n * // Now all requests automatically include the auth token\n * const users = await client.entity.list('default', 'users');\n * const tasks = await client.bpm.getMyTasks();\n * ```\n */\nexport function createClient(options: AmasterClientOptions): AmasterClient {\n  const { baseURL, headers = {}, onUnauthorized, onTokenExpired } = options;\n\n  // Create the base HTTP client\n  const baseHttpClient = createHttpClient({\n    baseURL,\n    headers,\n  });\n\n  // Create the auth client first (it manages its own HTTP client internally)\n  const auth: AuthClient = createAuthClient({\n    baseURL,\n    headers,\n    onTokenExpired,\n    onUnauthorized,\n  });\n\n  // Create a wrapper HTTP client that automatically adds the auth token\n  const createAuthenticatedHttpClient = (): HttpClient => {\n    return {\n      async request<T>(config: RequestConfig): Promise<ClientResult<T>> {\n        // Get the current token from auth client\n        const token = auth.getAccessToken();\n        \n        // Merge Authorization header with existing headers\n        const authHeaders = token ? { Authorization: `Bearer ${token}` } : {};\n        const mergedConfig: RequestConfig = {\n          ...config,\n          headers: {\n            ...config.headers,\n            ...authHeaders,\n          },\n        };\n\n        // Make the request with the updated config\n        const result = await baseHttpClient.request<T>(mergedConfig);\n\n        // Handle 401 errors\n        if (result.status === 401 && onUnauthorized) {\n          onUnauthorized();\n        }\n\n        return result;\n      },\n    };\n  };\n\n  // Create the authenticated HTTP client\n  const authenticatedHttpClient = createAuthenticatedHttpClient();\n\n  // Create other clients using the authenticated HTTP client\n  const entity: EntityClient = createEntityClient(authenticatedHttpClient);\n  const bpm: BpmClient = createBpmClient(authenticatedHttpClient);\n  const workflow: WorkflowClient = createWorkflowClient(authenticatedHttpClient);\n  const functionClient: FunctionClient = createFunctionClient(authenticatedHttpClient);\n  const copilot: CopilotA2UIClient = createCopilotA2UIClient(authenticatedHttpClient);\n\n  // ASR and TTS clients use WebSocket, create with default config\n  // Users can reconfigure by accessing client.asr / client.tts directly\n  const asr: ASRClient = createASRClient({});\n  const tts: TTSClient = createTTSClient({});\n\n  // Return unified client interface\n  const client: AmasterClient = {\n    auth,\n    entity,\n    bpm,\n    workflow,\n    asr,\n    copilot,\n    function: functionClient,\n    tts,\n\n    // Expose token management methods from auth client\n    isAuthenticated: () => auth.isAuthenticated(),\n    getAccessToken: () => auth.getAccessToken(),\n    setAccessToken: (token: string) => auth.setAccessToken(token),\n    clearAuth: () => auth.clearAuth(),\n  };\n\n  return client;\n}\n"]}
+{"version":3,"sources":["../src/client.ts"],"names":["createHttpClient","createAuthClient","createEntityClient","createBpmClient","createWorkflowClient","functionClient","createFunctionClient","createCopilotA2UIClient","createS3Client","createASRClient","createTTSClient"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * ============================================================================\n * @amaster.ai/client - Unified Amaster Client\n * ============================================================================\n *\n * Supabase-inspired unified API client for the Amaster platform\n *\n * Features:\n * - Single client instance for all services (auth, entity, bpm, workflow)\n * - Automatic token management and refresh\n * - Auto-attach authentication to all requests\n * - Centralized error handling\n *\n * @example\n * ```typescript\n * // With explicit baseURL\n * const client = createClient({\n *   baseURL: 'https://api.amaster.ai',\n *   onUnauthorized: () => window.location.href = '/login'\n * });\n *\n * // Auto-detect baseURL from env (Taro/Mini-program)\n * const client = createClient({\n *   onUnauthorized: () => window.location.href = '/login'\n * });\n *\n * // Login\n * await client.auth.login({ email, password });\n *\n * // All subsequent requests automatically include auth token\n * await client.entity.list('default', 'users');\n * await client.bpm.startProcess({ processKey: 'approval' });\n * ```\n */\n\nimport { createAuthClient, type AuthClient } from \"@amaster.ai/auth-client\";\nimport { createEntityClient, type EntityClient } from \"@amaster.ai/entity-client\";\nimport { createBpmClient, type BpmClient } from \"@amaster.ai/bpm-client\";\nimport { createWorkflowClient, type WorkflowClient } from \"@amaster.ai/workflow-client\";\nimport { createASRClient, type ASRClient } from \"@amaster.ai/asr-client\";\nimport { createCopilotA2UIClient, type CopilotA2UIClient } from \"@amaster.ai/copilot-client\";\nimport { createFunctionClient, type FunctionClient } from \"@amaster.ai/function-client\";\nimport { createTTSClient, type TTSClient } from \"@amaster.ai/tts-client\";\nimport { createS3Client, type S3Client } from \"@amaster.ai/s3-client\";\nimport {\n  createHttpClient,\n  type HttpClient,\n  type RequestConfig,\n  type ClientResult,\n} from \"@amaster.ai/http-client\";\nimport type { AmasterClient, AmasterClientOptions } from \"./types\";\n\n/**\n * Create a unified Amaster client instance\n *\n * This function creates a single client that provides access to all Amaster services:\n * - Authentication (login, register, logout)\n * - Entity CRUD operations\n * - BPM (Business Process Management)\n * - Workflow execution\n *\n * All sub-clients automatically share the same HTTP client and authentication state,\n * ensuring that tokens are consistently attached to all requests.\n *\n * @param options - Client configuration options\n * @returns A unified Amaster client instance\n *\n * @example\n * ```typescript\n * // Basic usage with explicit baseURL\n * const client = createClient({\n *   baseURL: 'https://api.amaster.ai'\n * });\n *\n * // Auto-detect baseURL (for Taro/Mini-program or dev proxy)\n * const client = createClient({});\n *\n * // With authentication callbacks\n * const client = createClient({\n *   baseURL: 'https://api.amaster.ai',\n *   onUnauthorized: () => {\n *     // Redirect to login or show auth modal\n *     window.location.href = '/login';\n *   },\n *   onTokenExpired: () => {\n *     console.log('Token expired, refreshing...');\n *   }\n * });\n *\n * // Login\n * await client.auth.login({\n *   email: 'user@example.com',\n *   password: 'password123'\n * });\n *\n * // Now all requests automatically include the auth token\n * const users = await client.entity.list('default', 'users');\n * const tasks = await client.bpm.getMyTasks();\n * ```\n */\nexport function createClient(options: AmasterClientOptions): AmasterClient {\n  const {\n    baseURL,\n    headers = {},\n    onUnauthorized,\n    onTokenExpired,\n    autoHandleOAuthCallback,\n  } = options;\n\n  // Create the base HTTP client\n  const baseHttpClient = createHttpClient({\n    baseURL,\n    headers,\n  });\n\n  // Create the auth client first (it manages its own HTTP client internally)\n  const auth: AuthClient = createAuthClient({\n    baseURL,\n    headers,\n    onTokenExpired,\n    onUnauthorized,\n    autoHandleOAuthCallback,\n  });\n\n  // Create a wrapper HTTP client that automatically adds the auth token\n  const createAuthenticatedHttpClient = (): HttpClient => {\n    // Track if we're currently refreshing to avoid multiple simultaneous refreshes\n    let isRefreshing = false;\n    let refreshPromise: Promise<boolean> | null = null;\n\n    /**\n     * Check if 401 error is due to token expiration\n     * Traefik JWT plugin returns plain text like \"Jwt is expired\" or \"Token is expired\"\n     */\n    function isTokenExpired(result: ClientResult<unknown>): boolean {\n      if (result.status !== 401) return false;\n\n      // Check error message (could be from backend JSON response)\n      if (result.error?.message && /expired/i.test(result.error.message)) {\n        return true;\n      }\n\n      // Check error details (traefik returns plain text in details)\n      if (result.error?.details) {\n        const details = result.error.details;\n        if (typeof details === \"string\" && /expired/i.test(details)) {\n          return true;\n        }\n        // Also check if details is an object with message field\n        if (typeof details === \"object\" && details !== null) {\n          const detailsObj = details as Record<string, unknown>;\n          if (typeof detailsObj.message === \"string\" && /expired/i.test(detailsObj.message)) {\n            return true;\n          }\n        }\n      }\n\n      // Check raw data (could be plain text from traefik)\n      if (typeof result.data === \"string\" && /expired/i.test(result.data)) {\n        return true;\n      }\n\n      // If we have a token but got 401, assume it might be expired\n      return !!auth.getAccessToken();\n    }\n\n    return {\n      async request<T>(config: RequestConfig): Promise<ClientResult<T>> {\n        // Get the current token from auth client\n        const token = auth.getAccessToken();\n\n        // Merge Authorization header with existing headers\n        const authHeaders = token ? { Authorization: `Bearer ${token}` } : {};\n        const mergedConfig: RequestConfig = {\n          ...config,\n          headers: {\n            ...config.headers,\n            ...authHeaders,\n          },\n        };\n\n        // Make the request with the updated config\n        let result = await baseHttpClient.request<T>(mergedConfig);\n\n        // Handle 401 errors with automatic token refresh\n        if (result.status === 401) {\n          // Check if this is a token expiration (vs. no auth / invalid credentials)\n          if (isTokenExpired(result)) {\n            // Attempt to refresh token\n            if (!isRefreshing) {\n              isRefreshing = true;\n              refreshPromise = (async () => {\n                try {\n                  const refreshResult = await auth.refreshToken();\n                  return !!refreshResult.data;\n                } finally {\n                  isRefreshing = false;\n                  refreshPromise = null;\n                }\n              })();\n            }\n\n            // Wait for refresh to complete\n            const refreshed = await refreshPromise;\n\n            if (refreshed) {\n              // Token refreshed successfully, get new token and retry\n              const newToken = auth.getAccessToken();\n\n              // Rebuild headers with new token for retry\n              const retryHeaders = {\n                ...config.headers,\n                ...(newToken ? { Authorization: `Bearer ${newToken}` } : {}),\n              };\n\n              const retryConfig: RequestConfig = {\n                ...config,\n                headers: retryHeaders,\n              };\n\n              // Retry the request directly with baseHttpClient (avoid recursive wrapper call)\n              result = await baseHttpClient.request<T>(retryConfig);\n            } else {\n              // Refresh failed, trigger unauthorized callback\n              if (onUnauthorized) {\n                onUnauthorized();\n              }\n            }\n          } else {\n            // Not a token expiration, trigger unauthorized callback\n            if (onUnauthorized) {\n              onUnauthorized();\n            }\n          }\n        }\n\n        return result;\n      },\n    };\n  };\n\n  // Create the authenticated HTTP client\n  const authenticatedHttpClient = createAuthenticatedHttpClient();\n\n  // Create other clients using the authenticated HTTP client\n  const entity: EntityClient = createEntityClient(authenticatedHttpClient);\n  const bpm: BpmClient = createBpmClient(authenticatedHttpClient);\n  const workflow: WorkflowClient = createWorkflowClient(authenticatedHttpClient);\n  const functionClient: FunctionClient = createFunctionClient(authenticatedHttpClient);\n  // Pass token getter for streaming authentication (SSE/fetch)\n  const copilot: CopilotA2UIClient = createCopilotA2UIClient(authenticatedHttpClient, baseURL, () =>\n    auth.getAccessToken()\n  );\n  const s3: S3Client = createS3Client(authenticatedHttpClient);\n\n  // ASR and TTS clients use WebSocket, pass token getter for authentication\n  // Token can be appended to WebSocket URL as query parameter\n  const asr: ASRClient = createASRClient({\n    getAccessToken: () => auth.getAccessToken(),\n  });\n  const tts: TTSClient = createTTSClient({\n    getAccessToken: () => auth.getAccessToken(),\n  });\n\n  // Return unified client interface\n  const client: AmasterClient = {\n    auth,\n    entity,\n    bpm,\n    workflow,\n    asr,\n    copilot,\n    function: functionClient,\n    tts,\n    s3,\n\n    // Expose token management methods from auth client\n    isAuthenticated: () => auth.isAuthenticated(),\n    getAccessToken: () => auth.getAccessToken(),\n    setAccessToken: (token: string) => auth.setAccessToken(token),\n    clearAuth: () => auth.clearAuth(),\n  };\n\n  return client;\n}\n"]}

package/dist/index.d.cts

@@ -3,7 +3,7 @@ export { LoginParams, LoginResponse, OAuthProvider, Permission, RegisterParams,
 import { EntityClient } from '@amaster.ai/entity-client';
 export { EntityListResponse, EntityQueryParams, FilterGroup, FilterItem, FilterOperator } from '@amaster.ai/entity-client';
 import { BpmClient } from '@amaster.ai/bpm-client';
-export { CamundaVariable, HistoryProcessInstance, HistoryTask, ProcessInstance, ProcessVariable, Task, TaskFormSchema, TaskQueryParams } from '@amaster.ai/bpm-client';
+export { ActivityInstanceTree, CamundaVariable, HistoryActivityInstance, HistoryProcessInstance, HistoryTask, ProcessInstance, ProcessVariable, Task, TaskFormSchema, TaskQueryParams, UserOperationLog } from '@amaster.ai/bpm-client';
 import { WorkflowClient } from '@amaster.ai/workflow-client';
 export { WorkflowFile, WorkflowInputValue, WorkflowRunRequest, WorkflowRunResponse } from '@amaster.ai/workflow-client';
 import { ASRClient } from '@amaster.ai/asr-client';
@@ -14,6 +14,8 @@ import { FunctionClient } from '@amaster.ai/function-client';
 export { FunctionClient } from '@amaster.ai/function-client';
 import { TTSClient } from '@amaster.ai/tts-client';
 export { TTSClient, TTSClientConfig } from '@amaster.ai/tts-client';
+import { S3Client } from '@amaster.ai/s3-client';
+export { S3Client, S3Metadata, UploadRes } from '@amaster.ai/s3-client';
 export { ClientError, ClientResult } from '@amaster.ai/http-client';
 
 /**
@@ -54,6 +56,18 @@ interface AmasterClientOptions {
      * Tokens will be refreshed this many seconds before expiry
      */
     refreshThreshold?: number;
+    /**
+     * Automatically handle OAuth callback on initialization (default: true)
+     *
+     * When enabled, the client will automatically detect and process OAuth
+     * callback URLs containing #access_token. After processing, the hash
+     * is automatically cleared from the URL for security.
+     *
+     * Set to false if you want to manually handle OAuth callbacks.
+     *
+     * @default true
+     */
+    autoHandleOAuthCallback?: boolean;
 }
 /**
  * Unified Amaster Client
@@ -193,6 +207,19 @@ interface AmasterClient {
      * ```
      */
     tts: TTSClient;
+    /**
+     * S3 Storage module
+     *
+     * @example
+     * ```typescript
+     * // Upload file
+     * await client.s3.upload(file);
+     *
+     * // Download file
+     * await client.s3.download('path/to/file');
+     * ```
+     */
+    s3: S3Client;
     /**
      * Check if the user is currently authenticated
      */

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { LoginParams, LoginResponse, OAuthProvider, Permission, RegisterParams,
 import { EntityClient } from '@amaster.ai/entity-client';
 export { EntityListResponse, EntityQueryParams, FilterGroup, FilterItem, FilterOperator } from '@amaster.ai/entity-client';
 import { BpmClient } from '@amaster.ai/bpm-client';
-export { CamundaVariable, HistoryProcessInstance, HistoryTask, ProcessInstance, ProcessVariable, Task, TaskFormSchema, TaskQueryParams } from '@amaster.ai/bpm-client';
+export { ActivityInstanceTree, CamundaVariable, HistoryActivityInstance, HistoryProcessInstance, HistoryTask, ProcessInstance, ProcessVariable, Task, TaskFormSchema, TaskQueryParams, UserOperationLog } from '@amaster.ai/bpm-client';
 import { WorkflowClient } from '@amaster.ai/workflow-client';
 export { WorkflowFile, WorkflowInputValue, WorkflowRunRequest, WorkflowRunResponse } from '@amaster.ai/workflow-client';
 import { ASRClient } from '@amaster.ai/asr-client';
@@ -14,6 +14,8 @@ import { FunctionClient } from '@amaster.ai/function-client';
 export { FunctionClient } from '@amaster.ai/function-client';
 import { TTSClient } from '@amaster.ai/tts-client';
 export { TTSClient, TTSClientConfig } from '@amaster.ai/tts-client';
+import { S3Client } from '@amaster.ai/s3-client';
+export { S3Client, S3Metadata, UploadRes } from '@amaster.ai/s3-client';
 export { ClientError, ClientResult } from '@amaster.ai/http-client';
 
 /**
@@ -54,6 +56,18 @@ interface AmasterClientOptions {
      * Tokens will be refreshed this many seconds before expiry
      */
     refreshThreshold?: number;
+    /**
+     * Automatically handle OAuth callback on initialization (default: true)
+     *
+     * When enabled, the client will automatically detect and process OAuth
+     * callback URLs containing #access_token. After processing, the hash
+     * is automatically cleared from the URL for security.
+     *
+     * Set to false if you want to manually handle OAuth callbacks.
+     *
+     * @default true
+     */
+    autoHandleOAuthCallback?: boolean;
 }
 /**
  * Unified Amaster Client
@@ -193,6 +207,19 @@ interface AmasterClient {
      * ```
      */
     tts: TTSClient;
+    /**
+     * S3 Storage module
+     *
+     * @example
+     * ```typescript
+     * // Upload file
+     * await client.s3.upload(file);
+     *
+     * // Download file
+     * await client.s3.download('path/to/file');
+     * ```
+     */
+    s3: S3Client;
     /**
      * Check if the user is currently authenticated
      */

package/dist/index.js

@@ -6,11 +6,18 @@ import { createASRClient } from '@amaster.ai/asr-client';
 import { createCopilotA2UIClient } from '@amaster.ai/copilot-client';
 import { createFunctionClient } from '@amaster.ai/function-client';
 import { createTTSClient } from '@amaster.ai/tts-client';
+import { createS3Client } from '@amaster.ai/s3-client';
 import { createHttpClient } from '@amaster.ai/http-client';
 
 // src/client.ts
 function createClient(options) {
-  const { baseURL, headers = {}, onUnauthorized, onTokenExpired } = options;
+  const {
+    baseURL,
+    headers = {},
+    onUnauthorized,
+    onTokenExpired,
+    autoHandleOAuthCallback
+  } = options;
   const baseHttpClient = createHttpClient({
     baseURL,
     headers
@@ -19,9 +26,34 @@ function createClient(options) {
     baseURL,
     headers,
     onTokenExpired,
-    onUnauthorized
+    onUnauthorized,
+    autoHandleOAuthCallback
   });
   const createAuthenticatedHttpClient = () => {
+    let isRefreshing = false;
+    let refreshPromise = null;
+    function isTokenExpired(result) {
+      if (result.status !== 401) return false;
+      if (result.error?.message && /expired/i.test(result.error.message)) {
+        return true;
+      }
+      if (result.error?.details) {
+        const details = result.error.details;
+        if (typeof details === "string" && /expired/i.test(details)) {
+          return true;
+        }
+        if (typeof details === "object" && details !== null) {
+          const detailsObj = details;
+          if (typeof detailsObj.message === "string" && /expired/i.test(detailsObj.message)) {
+            return true;
+          }
+        }
+      }
+      if (typeof result.data === "string" && /expired/i.test(result.data)) {
+        return true;
+      }
+      return !!auth.getAccessToken();
+    }
     return {
       async request(config) {
         const token = auth.getAccessToken();
@@ -33,9 +65,43 @@ function createClient(options) {
             ...authHeaders
           }
         };
-        const result = await baseHttpClient.request(mergedConfig);
-        if (result.status === 401 && onUnauthorized) {
-          onUnauthorized();
+        let result = await baseHttpClient.request(mergedConfig);
+        if (result.status === 401) {
+          if (isTokenExpired(result)) {
+            if (!isRefreshing) {
+              isRefreshing = true;
+              refreshPromise = (async () => {
+                try {
+                  const refreshResult = await auth.refreshToken();
+                  return !!refreshResult.data;
+                } finally {
+                  isRefreshing = false;
+                  refreshPromise = null;
+                }
+              })();
+            }
+            const refreshed = await refreshPromise;
+            if (refreshed) {
+              const newToken = auth.getAccessToken();
+              const retryHeaders = {
+                ...config.headers,
+                ...newToken ? { Authorization: `Bearer ${newToken}` } : {}
+              };
+              const retryConfig = {
+                ...config,
+                headers: retryHeaders
+              };
+              result = await baseHttpClient.request(retryConfig);
+            } else {
+              if (onUnauthorized) {
+                onUnauthorized();
+              }
+            }
+          } else {
+            if (onUnauthorized) {
+              onUnauthorized();
+            }
+          }
         }
         return result;
       }
@@ -46,9 +112,18 @@ function createClient(options) {
   const bpm = createBpmClient(authenticatedHttpClient);
   const workflow = createWorkflowClient(authenticatedHttpClient);
   const functionClient = createFunctionClient(authenticatedHttpClient);
-  const copilot = createCopilotA2UIClient(authenticatedHttpClient);
-  const asr = createASRClient({});
-  const tts = createTTSClient({});
+  const copilot = createCopilotA2UIClient(
+    authenticatedHttpClient,
+    baseURL,
+    () => auth.getAccessToken()
+  );
+  const s3 = createS3Client(authenticatedHttpClient);
+  const asr = createASRClient({
+    getAccessToken: () => auth.getAccessToken()
+  });
+  const tts = createTTSClient({
+    getAccessToken: () => auth.getAccessToken()
+  });
   const client = {
     auth,
     entity,
@@ -58,6 +133,7 @@ function createClient(options) {
     copilot,
     function: functionClient,
     tts,
+    s3,
     // Expose token management methods from auth client
     isAuthenticated: () => auth.isAuthenticated(),
     getAccessToken: () => auth.getAccessToken(),

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":";;;;;;;;;;;AA8FO,SAAS,aAAa,OAAA,EAA8C;AACzE,EAAA,MAAM,EAAE,OAAA,EAAS,OAAA,GAAU,EAAC,EAAG,cAAA,EAAgB,gBAAe,GAAI,OAAA;AAGlE,EAAA,MAAM,iBAAiB,gBAAA,CAAiB;AAAA,IACtC,OAAA;AAAA,IACA;AAAA,GACD,CAAA;AAGD,EAAA,MAAM,OAAmB,gBAAA,CAAiB;AAAA,IACxC,OAAA;AAAA,IACA,OAAA;AAAA,IACA,cAAA;AAAA,IACA;AAAA,GACD,CAAA;AAGD,EAAA,MAAM,gCAAgC,MAAkB;AACtD,IAAA,OAAO;AAAA,MACL,MAAM,QAAW,MAAA,EAAiD;AAEhE,QAAA,MAAM,KAAA,GAAQ,KAAK,cAAA,EAAe;AAGlC,QAAA,MAAM,WAAA,GAAc,QAAQ,EAAE,aAAA,EAAe,UAAU,KAAK,CAAA,CAAA,KAAO,EAAC;AACpE,QAAA,MAAM,YAAA,GAA8B;AAAA,UAClC,GAAG,MAAA;AAAA,UACH,OAAA,EAAS;AAAA,YACP,GAAG,MAAA,CAAO,OAAA;AAAA,YACV,GAAG;AAAA;AACL,SACF;AAGA,QAAA,MAAM,MAAA,GAAS,MAAM,cAAA,CAAe,OAAA,CAAW,YAAY,CAAA;AAG3D,QAAA,IAAI,MAAA,CAAO,MAAA,KAAW,GAAA,IAAO,cAAA,EAAgB;AAC3C,UAAA,cAAA,EAAe;AAAA,QACjB;AAEA,QAAA,OAAO,MAAA;AAAA,MACT;AAAA,KACF;AAAA,EACF,CAAA;AAGA,EAAA,MAAM,0BAA0B,6BAAA,EAA8B;AAG9D,EAAA,MAAM,MAAA,GAAuB,mBAAmB,uBAAuB,CAAA;AACvE,EAAA,MAAM,GAAA,GAAiB,gBAAgB,uBAAuB,CAAA;AAC9D,EAAA,MAAM,QAAA,GAA2B,qBAAqB,uBAAuB,CAAA;AAC7E,EAAA,MAAM,cAAA,GAAiC,qBAAqB,uBAAuB,CAAA;AACnF,EAAA,MAAM,OAAA,GAA6B,wBAAwB,uBAAuB,CAAA;AAIlF,EAAA,MAAM,GAAA,GAAiB,eAAA,CAAgB,EAAE,CAAA;AACzC,EAAA,MAAM,GAAA,GAAiB,eAAA,CAAgB,EAAE,CAAA;AAGzC,EAAA,MAAM,MAAA,GAAwB;AAAA,IAC5B,IAAA;AAAA,IACA,MAAA;AAAA,IACA,GAAA;AAAA,IACA,QAAA;AAAA,IACA,GAAA;AAAA,IACA,OAAA;AAAA,IACA,QAAA,EAAU,cAAA;AAAA,IACV,GAAA;AAAA;AAAA,IAGA,eAAA,EAAiB,MAAM,IAAA,CAAK,eAAA,EAAgB;AAAA,IAC5C,cAAA,EAAgB,MAAM,IAAA,CAAK,cAAA,EAAe;AAAA,IAC1C,cAAA,EAAgB,CAAC,KAAA,KAAkB,IAAA,CAAK,eAAe,KAAK,CAAA;AAAA,IAC5D,SAAA,EAAW,MAAM,IAAA,CAAK,SAAA;AAAU,GAClC;AAEA,EAAA,OAAO,MAAA;AACT","file":"index.js","sourcesContent":["/**\n * ============================================================================\n * @amaster.ai/client - Unified Amaster Client\n * ============================================================================\n * \n * Supabase-inspired unified API client for the Amaster platform\n * \n * Features:\n * - Single client instance for all services (auth, entity, bpm, workflow)\n * - Automatic token management and refresh\n * - Auto-attach authentication to all requests\n * - Centralized error handling\n * \n * @example\n * ```typescript\n * // With explicit baseURL\n * const client = createClient({\n *   baseURL: 'https://api.amaster.ai',\n *   onUnauthorized: () => window.location.href = '/login'\n * });\n * \n * // Auto-detect baseURL from env (Taro/Mini-program)\n * const client = createClient({\n *   onUnauthorized: () => window.location.href = '/login'\n * });\n * \n * // Login\n * await client.auth.login({ email, password });\n * \n * // All subsequent requests automatically include auth token\n * await client.entity.list('default', 'users');\n * await client.bpm.startProcess({ processKey: 'approval' });\n * ```\n */\n\nimport { createAuthClient, type AuthClient } from \"@amaster.ai/auth-client\";\nimport { createEntityClient, type EntityClient } from \"@amaster.ai/entity-client\";\nimport { createBpmClient, type BpmClient } from \"@amaster.ai/bpm-client\";\nimport { createWorkflowClient, type WorkflowClient } from \"@amaster.ai/workflow-client\";\nimport { createASRClient, type ASRClient } from \"@amaster.ai/asr-client\";\nimport { createCopilotA2UIClient, type CopilotA2UIClient } from \"@amaster.ai/copilot-client\";\nimport { createFunctionClient, type FunctionClient } from \"@amaster.ai/function-client\";\nimport { createTTSClient, type TTSClient } from \"@amaster.ai/tts-client\";\nimport { createHttpClient, type HttpClient, type RequestConfig, type ClientResult } from \"@amaster.ai/http-client\";\nimport type { AmasterClient, AmasterClientOptions } from \"./types\";\n\n/**\n * Create a unified Amaster client instance\n * \n * This function creates a single client that provides access to all Amaster services:\n * - Authentication (login, register, logout)\n * - Entity CRUD operations\n * - BPM (Business Process Management)\n * - Workflow execution\n * \n * All sub-clients automatically share the same HTTP client and authentication state,\n * ensuring that tokens are consistently attached to all requests.\n * \n * @param options - Client configuration options\n * @returns A unified Amaster client instance\n * \n * @example\n * ```typescript\n * // Basic usage with explicit baseURL\n * const client = createClient({\n *   baseURL: 'https://api.amaster.ai'\n * });\n * \n * // Auto-detect baseURL (for Taro/Mini-program or dev proxy)\n * const client = createClient({});\n * \n * // With authentication callbacks\n * const client = createClient({\n *   baseURL: 'https://api.amaster.ai',\n *   onUnauthorized: () => {\n *     // Redirect to login or show auth modal\n *     window.location.href = '/login';\n *   },\n *   onTokenExpired: () => {\n *     console.log('Token expired, refreshing...');\n *   }\n * });\n * \n * // Login\n * await client.auth.login({\n *   email: 'user@example.com',\n *   password: 'password123'\n * });\n * \n * // Now all requests automatically include the auth token\n * const users = await client.entity.list('default', 'users');\n * const tasks = await client.bpm.getMyTasks();\n * ```\n */\nexport function createClient(options: AmasterClientOptions): AmasterClient {\n  const { baseURL, headers = {}, onUnauthorized, onTokenExpired } = options;\n\n  // Create the base HTTP client\n  const baseHttpClient = createHttpClient({\n    baseURL,\n    headers,\n  });\n\n  // Create the auth client first (it manages its own HTTP client internally)\n  const auth: AuthClient = createAuthClient({\n    baseURL,\n    headers,\n    onTokenExpired,\n    onUnauthorized,\n  });\n\n  // Create a wrapper HTTP client that automatically adds the auth token\n  const createAuthenticatedHttpClient = (): HttpClient => {\n    return {\n      async request<T>(config: RequestConfig): Promise<ClientResult<T>> {\n        // Get the current token from auth client\n        const token = auth.getAccessToken();\n        \n        // Merge Authorization header with existing headers\n        const authHeaders = token ? { Authorization: `Bearer ${token}` } : {};\n        const mergedConfig: RequestConfig = {\n          ...config,\n          headers: {\n            ...config.headers,\n            ...authHeaders,\n          },\n        };\n\n        // Make the request with the updated config\n        const result = await baseHttpClient.request<T>(mergedConfig);\n\n        // Handle 401 errors\n        if (result.status === 401 && onUnauthorized) {\n          onUnauthorized();\n        }\n\n        return result;\n      },\n    };\n  };\n\n  // Create the authenticated HTTP client\n  const authenticatedHttpClient = createAuthenticatedHttpClient();\n\n  // Create other clients using the authenticated HTTP client\n  const entity: EntityClient = createEntityClient(authenticatedHttpClient);\n  const bpm: BpmClient = createBpmClient(authenticatedHttpClient);\n  const workflow: WorkflowClient = createWorkflowClient(authenticatedHttpClient);\n  const functionClient: FunctionClient = createFunctionClient(authenticatedHttpClient);\n  const copilot: CopilotA2UIClient = createCopilotA2UIClient(authenticatedHttpClient);\n\n  // ASR and TTS clients use WebSocket, create with default config\n  // Users can reconfigure by accessing client.asr / client.tts directly\n  const asr: ASRClient = createASRClient({});\n  const tts: TTSClient = createTTSClient({});\n\n  // Return unified client interface\n  const client: AmasterClient = {\n    auth,\n    entity,\n    bpm,\n    workflow,\n    asr,\n    copilot,\n    function: functionClient,\n    tts,\n\n    // Expose token management methods from auth client\n    isAuthenticated: () => auth.isAuthenticated(),\n    getAccessToken: () => auth.getAccessToken(),\n    setAccessToken: (token: string) => auth.setAccessToken(token),\n    clearAuth: () => auth.clearAuth(),\n  };\n\n  return client;\n}\n"]}
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * ============================================================================\n * @amaster.ai/client - Unified Amaster Client\n * ============================================================================\n *\n * Supabase-inspired unified API client for the Amaster platform\n *\n * Features:\n * - Single client instance for all services (auth, entity, bpm, workflow)\n * - Automatic token management and refresh\n * - Auto-attach authentication to all requests\n * - Centralized error handling\n *\n * @example\n * ```typescript\n * // With explicit baseURL\n * const client = createClient({\n *   baseURL: 'https://api.amaster.ai',\n *   onUnauthorized: () => window.location.href = '/login'\n * });\n *\n * // Auto-detect baseURL from env (Taro/Mini-program)\n * const client = createClient({\n *   onUnauthorized: () => window.location.href = '/login'\n * });\n *\n * // Login\n * await client.auth.login({ email, password });\n *\n * // All subsequent requests automatically include auth token\n * await client.entity.list('default', 'users');\n * await client.bpm.startProcess({ processKey: 'approval' });\n * ```\n */\n\nimport { createAuthClient, type AuthClient } from \"@amaster.ai/auth-client\";\nimport { createEntityClient, type EntityClient } from \"@amaster.ai/entity-client\";\nimport { createBpmClient, type BpmClient } from \"@amaster.ai/bpm-client\";\nimport { createWorkflowClient, type WorkflowClient } from \"@amaster.ai/workflow-client\";\nimport { createASRClient, type ASRClient } from \"@amaster.ai/asr-client\";\nimport { createCopilotA2UIClient, type CopilotA2UIClient } from \"@amaster.ai/copilot-client\";\nimport { createFunctionClient, type FunctionClient } from \"@amaster.ai/function-client\";\nimport { createTTSClient, type TTSClient } from \"@amaster.ai/tts-client\";\nimport { createS3Client, type S3Client } from \"@amaster.ai/s3-client\";\nimport {\n  createHttpClient,\n  type HttpClient,\n  type RequestConfig,\n  type ClientResult,\n} from \"@amaster.ai/http-client\";\nimport type { AmasterClient, AmasterClientOptions } from \"./types\";\n\n/**\n * Create a unified Amaster client instance\n *\n * This function creates a single client that provides access to all Amaster services:\n * - Authentication (login, register, logout)\n * - Entity CRUD operations\n * - BPM (Business Process Management)\n * - Workflow execution\n *\n * All sub-clients automatically share the same HTTP client and authentication state,\n * ensuring that tokens are consistently attached to all requests.\n *\n * @param options - Client configuration options\n * @returns A unified Amaster client instance\n *\n * @example\n * ```typescript\n * // Basic usage with explicit baseURL\n * const client = createClient({\n *   baseURL: 'https://api.amaster.ai'\n * });\n *\n * // Auto-detect baseURL (for Taro/Mini-program or dev proxy)\n * const client = createClient({});\n *\n * // With authentication callbacks\n * const client = createClient({\n *   baseURL: 'https://api.amaster.ai',\n *   onUnauthorized: () => {\n *     // Redirect to login or show auth modal\n *     window.location.href = '/login';\n *   },\n *   onTokenExpired: () => {\n *     console.log('Token expired, refreshing...');\n *   }\n * });\n *\n * // Login\n * await client.auth.login({\n *   email: 'user@example.com',\n *   password: 'password123'\n * });\n *\n * // Now all requests automatically include the auth token\n * const users = await client.entity.list('default', 'users');\n * const tasks = await client.bpm.getMyTasks();\n * ```\n */\nexport function createClient(options: AmasterClientOptions): AmasterClient {\n  const {\n    baseURL,\n    headers = {},\n    onUnauthorized,\n    onTokenExpired,\n    autoHandleOAuthCallback,\n  } = options;\n\n  // Create the base HTTP client\n  const baseHttpClient = createHttpClient({\n    baseURL,\n    headers,\n  });\n\n  // Create the auth client first (it manages its own HTTP client internally)\n  const auth: AuthClient = createAuthClient({\n    baseURL,\n    headers,\n    onTokenExpired,\n    onUnauthorized,\n    autoHandleOAuthCallback,\n  });\n\n  // Create a wrapper HTTP client that automatically adds the auth token\n  const createAuthenticatedHttpClient = (): HttpClient => {\n    // Track if we're currently refreshing to avoid multiple simultaneous refreshes\n    let isRefreshing = false;\n    let refreshPromise: Promise<boolean> | null = null;\n\n    /**\n     * Check if 401 error is due to token expiration\n     * Traefik JWT plugin returns plain text like \"Jwt is expired\" or \"Token is expired\"\n     */\n    function isTokenExpired(result: ClientResult<unknown>): boolean {\n      if (result.status !== 401) return false;\n\n      // Check error message (could be from backend JSON response)\n      if (result.error?.message && /expired/i.test(result.error.message)) {\n        return true;\n      }\n\n      // Check error details (traefik returns plain text in details)\n      if (result.error?.details) {\n        const details = result.error.details;\n        if (typeof details === \"string\" && /expired/i.test(details)) {\n          return true;\n        }\n        // Also check if details is an object with message field\n        if (typeof details === \"object\" && details !== null) {\n          const detailsObj = details as Record<string, unknown>;\n          if (typeof detailsObj.message === \"string\" && /expired/i.test(detailsObj.message)) {\n            return true;\n          }\n        }\n      }\n\n      // Check raw data (could be plain text from traefik)\n      if (typeof result.data === \"string\" && /expired/i.test(result.data)) {\n        return true;\n      }\n\n      // If we have a token but got 401, assume it might be expired\n      return !!auth.getAccessToken();\n    }\n\n    return {\n      async request<T>(config: RequestConfig): Promise<ClientResult<T>> {\n        // Get the current token from auth client\n        const token = auth.getAccessToken();\n\n        // Merge Authorization header with existing headers\n        const authHeaders = token ? { Authorization: `Bearer ${token}` } : {};\n        const mergedConfig: RequestConfig = {\n          ...config,\n          headers: {\n            ...config.headers,\n            ...authHeaders,\n          },\n        };\n\n        // Make the request with the updated config\n        let result = await baseHttpClient.request<T>(mergedConfig);\n\n        // Handle 401 errors with automatic token refresh\n        if (result.status === 401) {\n          // Check if this is a token expiration (vs. no auth / invalid credentials)\n          if (isTokenExpired(result)) {\n            // Attempt to refresh token\n            if (!isRefreshing) {\n              isRefreshing = true;\n              refreshPromise = (async () => {\n                try {\n                  const refreshResult = await auth.refreshToken();\n                  return !!refreshResult.data;\n                } finally {\n                  isRefreshing = false;\n                  refreshPromise = null;\n                }\n              })();\n            }\n\n            // Wait for refresh to complete\n            const refreshed = await refreshPromise;\n\n            if (refreshed) {\n              // Token refreshed successfully, get new token and retry\n              const newToken = auth.getAccessToken();\n\n              // Rebuild headers with new token for retry\n              const retryHeaders = {\n                ...config.headers,\n                ...(newToken ? { Authorization: `Bearer ${newToken}` } : {}),\n              };\n\n              const retryConfig: RequestConfig = {\n                ...config,\n                headers: retryHeaders,\n              };\n\n              // Retry the request directly with baseHttpClient (avoid recursive wrapper call)\n              result = await baseHttpClient.request<T>(retryConfig);\n            } else {\n              // Refresh failed, trigger unauthorized callback\n              if (onUnauthorized) {\n                onUnauthorized();\n              }\n            }\n          } else {\n            // Not a token expiration, trigger unauthorized callback\n            if (onUnauthorized) {\n              onUnauthorized();\n            }\n          }\n        }\n\n        return result;\n      },\n    };\n  };\n\n  // Create the authenticated HTTP client\n  const authenticatedHttpClient = createAuthenticatedHttpClient();\n\n  // Create other clients using the authenticated HTTP client\n  const entity: EntityClient = createEntityClient(authenticatedHttpClient);\n  const bpm: BpmClient = createBpmClient(authenticatedHttpClient);\n  const workflow: WorkflowClient = createWorkflowClient(authenticatedHttpClient);\n  const functionClient: FunctionClient = createFunctionClient(authenticatedHttpClient);\n  // Pass token getter for streaming authentication (SSE/fetch)\n  const copilot: CopilotA2UIClient = createCopilotA2UIClient(authenticatedHttpClient, baseURL, () =>\n    auth.getAccessToken()\n  );\n  const s3: S3Client = createS3Client(authenticatedHttpClient);\n\n  // ASR and TTS clients use WebSocket, pass token getter for authentication\n  // Token can be appended to WebSocket URL as query parameter\n  const asr: ASRClient = createASRClient({\n    getAccessToken: () => auth.getAccessToken(),\n  });\n  const tts: TTSClient = createTTSClient({\n    getAccessToken: () => auth.getAccessToken(),\n  });\n\n  // Return unified client interface\n  const client: AmasterClient = {\n    auth,\n    entity,\n    bpm,\n    workflow,\n    asr,\n    copilot,\n    function: functionClient,\n    tts,\n    s3,\n\n    // Expose token management methods from auth client\n    isAuthenticated: () => auth.isAuthenticated(),\n    getAccessToken: () => auth.getAccessToken(),\n    setAccessToken: (token: string) => auth.setAccessToken(token),\n    clearAuth: () => auth.clearAuth(),\n  };\n\n  return client;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amaster.ai/client",
-  "version": "1.1.0-beta.4",
+  "version": "1.1.0-beta.41",
   "description": "Unified API client for Amaster platform - All services in one package",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -38,6 +38,9 @@
       "tts": [
         "./types/tts.d.ts"
       ],
+      "s3": [
+        "./types/s3.d.ts"
+      ],
       "common": [
         "./types/common.d.ts"
       ]
@@ -69,16 +72,17 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@amaster.ai/asr-client": "1.1.0-beta.3",
-    "@amaster.ai/asr-http-client": "1.1.0-beta.3",
-    "@amaster.ai/copilot-client": "1.1.0-beta.3",
-    "@amaster.ai/auth-client": "1.1.0-beta.3",
-    "@amaster.ai/function-client": "1.1.0-beta.3",
-    "@amaster.ai/bpm-client": "1.1.0-beta.3",
-    "@amaster.ai/entity-client": "1.1.0-beta.3",
-    "@amaster.ai/tts-client": "1.1.0-beta.3",
-    "@amaster.ai/workflow-client": "1.1.0-beta.3",
-    "@amaster.ai/http-client": "1.1.0-beta.3"
+    "@amaster.ai/asr-client": "1.1.0-beta.41",
+    "@amaster.ai/auth-client": "1.1.0-beta.41",
+    "@amaster.ai/bpm-client": "1.1.0-beta.41",
+    "@amaster.ai/copilot-client": "1.1.0-beta.41",
+    "@amaster.ai/function-client": "1.1.0-beta.41",
+    "@amaster.ai/http-client": "1.1.0-beta.41",
+    "@amaster.ai/s3-client": "1.1.0-beta.41",
+    "@amaster.ai/tts-client": "1.1.0-beta.41",
+    "@amaster.ai/workflow-client": "1.1.0-beta.41",
+    "@amaster.ai/asr-http-client": "1.1.0-beta.41",
+    "@amaster.ai/entity-client": "1.1.0-beta.41"
   },
   "peerDependencies": {
     "axios": "^1.11.0"