@amaster.ai/client 1.1.0-beta.3 → 1.1.0-beta.31

package/README.md

@@ -487,13 +487,10 @@ const result = await client.copilot.sendMessage([
 console.log(result.data.content);
 
 // Streaming response
-await client.copilot.sendMessage(
-  [{ role: "user", content: "Tell me a story" }],
-  {
-    stream: true,
-    onChunk: (chunk) => console.log(chunk),
-  }
-);
+await client.copilot.sendMessage([{ role: "user", content: "Tell me a story" }], {
+  stream: true,
+  onChunk: (chunk) => console.log(chunk),
+});
 ```
 
 ### `client.function`

package/dist/index.cjs

@@ -8,11 +8,12 @@ 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 +22,22 @@ 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 (typeof result.data === "string" && /expired/i.test(result.data)) {
+        return true;
+      }
+      return !!auth.getAccessToken();
+    }
     return {
       async request(config) {
         const token = auth.getAccessToken();
@@ -35,9 +49,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 +96,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 +117,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 { 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, autoHandleOAuthCallback } = 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 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(\n    authenticatedHttpClient, \n    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

@@ -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

@@ -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,12 @@ 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 +20,22 @@ 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 (typeof result.data === "string" && /expired/i.test(result.data)) {
+        return true;
+      }
+      return !!auth.getAccessToken();
+    }
     return {
       async request(config) {
         const token = auth.getAccessToken();
@@ -33,9 +47,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 +94,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 +115,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":";;;;;;;;;;;;AA+FO,SAAS,aAAa,OAAA,EAA8C;AACzE,EAAA,MAAM,EAAE,SAAS,OAAA,GAAU,IAAI,cAAA,EAAgB,cAAA,EAAgB,yBAAwB,GAAI,OAAA;AAG3F,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,cAAA;AAAA,IACA;AAAA,GACD,CAAA;AAGD,EAAA,MAAM,gCAAgC,MAAkB;AAEtD,IAAA,IAAI,YAAA,GAAe,KAAA;AACnB,IAAA,IAAI,cAAA,GAA0C,IAAA;AAM9C,IAAA,SAAS,eAAe,MAAA,EAAwC;AAC9D,MAAA,IAAI,MAAA,CAAO,MAAA,KAAW,GAAA,EAAK,OAAO,KAAA;AAGlC,MAAA,IAAI,MAAA,CAAO,OAAO,OAAA,IAAW,UAAA,CAAW,KAAK,MAAA,CAAO,KAAA,CAAM,OAAO,CAAA,EAAG;AAClE,QAAA,OAAO,IAAA;AAAA,MACT;AAGA,MAAA,IAAI,OAAO,OAAO,IAAA,KAAS,QAAA,IAAY,WAAW,IAAA,CAAK,MAAA,CAAO,IAAI,CAAA,EAAG;AACnE,QAAA,OAAO,IAAA;AAAA,MACT;AAGA,MAAA,OAAO,CAAC,CAAC,IAAA,CAAK,cAAA,EAAe;AAAA,IAC/B;AAEA,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,IAAI,MAAA,GAAS,MAAM,cAAA,CAAe,OAAA,CAAW,YAAY,CAAA;AAGzD,QAAA,IAAI,MAAA,CAAO,WAAW,GAAA,EAAK;AAEzB,UAAA,IAAI,cAAA,CAAe,MAAM,CAAA,EAAG;AAE1B,YAAA,IAAI,CAAC,YAAA,EAAc;AACjB,cAAA,YAAA,GAAe,IAAA;AACf,cAAA,cAAA,GAAA,CAAkB,YAAY;AAC5B,gBAAA,IAAI;AACF,kBAAA,MAAM,aAAA,GAAgB,MAAM,IAAA,CAAK,YAAA,EAAa;AAC9C,kBAAA,OAAO,CAAC,CAAC,aAAA,CAAc,IAAA;AAAA,gBACzB,CAAA,SAAE;AACA,kBAAA,YAAA,GAAe,KAAA;AACf,kBAAA,cAAA,GAAiB,IAAA;AAAA,gBACnB;AAAA,cACF,CAAA,GAAG;AAAA,YACL;AAGA,YAAA,MAAM,YAAY,MAAM,cAAA;AAExB,YAAA,IAAI,SAAA,EAAW;AAEb,cAAA,MAAM,QAAA,GAAW,KAAK,cAAA,EAAe;AAGrC,cAAA,MAAM,YAAA,GAAe;AAAA,gBACnB,GAAG,MAAA,CAAO,OAAA;AAAA,gBACV,GAAI,WAAW,EAAE,aAAA,EAAe,UAAU,QAAQ,CAAA,CAAA,KAAO;AAAC,eAC5D;AAEA,cAAA,MAAM,WAAA,GAA6B;AAAA,gBACjC,GAAG,MAAA;AAAA,gBACH,OAAA,EAAS;AAAA,eACX;AAGA,cAAA,MAAA,GAAS,MAAM,cAAA,CAAe,OAAA,CAAW,WAAW,CAAA;AAAA,YACtD,CAAA,MAAO;AAEL,cAAA,IAAI,cAAA,EAAgB;AAClB,gBAAA,cAAA,EAAe;AAAA,cACjB;AAAA,YACF;AAAA,UACF,CAAA,MAAO;AAEL,YAAA,IAAI,cAAA,EAAgB;AAClB,cAAA,cAAA,EAAe;AAAA,YACjB;AAAA,UACF;AAAA,QACF;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;AAEnF,EAAA,MAAM,OAAA,GAA6B,uBAAA;AAAA,IACjC,uBAAA;AAAA,IACA,OAAA;AAAA,IACA,MAAM,KAAK,cAAA;AAAe,GAC5B;AACA,EAAA,MAAM,EAAA,GAAe,eAAe,uBAAuB,CAAA;AAI3D,EAAA,MAAM,MAAiB,eAAA,CAAgB;AAAA,IACrC,cAAA,EAAgB,MAAM,IAAA,CAAK,cAAA;AAAe,GAC3C,CAAA;AACD,EAAA,MAAM,MAAiB,eAAA,CAAgB;AAAA,IACrC,cAAA,EAAgB,MAAM,IAAA,CAAK,cAAA;AAAe,GAC3C,CAAA;AAGD,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,IACA,EAAA;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 { createS3Client, type S3Client } from \"@amaster.ai/s3-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, autoHandleOAuthCallback } = 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 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(\n    authenticatedHttpClient, \n    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.3",
+  "version": "1.1.0-beta.31",
   "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/bpm-client": "1.1.0-beta.3",
-    "@amaster.ai/copilot-client": "1.1.0-beta.3",
-    "@amaster.ai/function-client": "1.1.0-beta.3",
-    "@amaster.ai/auth-client": "1.1.0-beta.3",
-    "@amaster.ai/asr-client": "1.1.0-beta.3",
-    "@amaster.ai/http-client": "1.1.0-beta.3",
-    "@amaster.ai/workflow-client": "1.1.0-beta.3",
-    "@amaster.ai/tts-client": "1.1.0-beta.3",
-    "@amaster.ai/entity-client": "1.1.0-beta.3",
-    "@amaster.ai/asr-http-client": "1.1.0-beta.3"
+    "@amaster.ai/asr-http-client": "1.1.0-beta.31",
+    "@amaster.ai/copilot-client": "1.1.0-beta.31",
+    "@amaster.ai/auth-client": "1.1.0-beta.31",
+    "@amaster.ai/asr-client": "1.1.0-beta.31",
+    "@amaster.ai/http-client": "1.1.0-beta.31",
+    "@amaster.ai/function-client": "1.1.0-beta.31",
+    "@amaster.ai/bpm-client": "1.1.0-beta.31",
+    "@amaster.ai/s3-client": "1.1.0-beta.31",
+    "@amaster.ai/entity-client": "1.1.0-beta.31",
+    "@amaster.ai/workflow-client": "1.1.0-beta.31",
+    "@amaster.ai/tts-client": "1.1.0-beta.31"
   },
   "peerDependencies": {
     "axios": "^1.11.0"

package/types/__tests__/type-checks.test-d.ts

@@ -0,0 +1,163 @@
+/**
+ * Type-level tests for @amaster.ai/client
+ * 
+ * These tests verify type inference and type safety at compile time.
+ * They ensure that the type definitions work correctly with TypeScript.
+ */
+
+import { describe, it, expectTypeOf } from 'vitest';
+import type {
+  AmasterClient,
+  AmasterClientOptions,
+  ClientResult,
+  ClientError,
+  EntityListResponse,
+  LoginParams,
+  User,
+  Task,
+  ProcessInstance,
+} from '../index';
+
+describe('Type Tests', () => {
+  describe('ClientResult', () => {
+    it('should have correct structure', () => {
+      type Result = ClientResult<{ id: number; name: string }>;
+      
+      expectTypeOf<Result>().toMatchTypeOf<{
+        data: { id: number; name: string } | null;
+        error: ClientError | null;
+        status: number;
+        success: boolean;
+      }>();
+    });
+
+    it('should infer data type correctly', () => {
+      type UserResult = ClientResult<User>;
+      
+      expectTypeOf<UserResult['data']>().toEqualTypeOf<User | null>();
+    });
+
+    it('should have success field', () => {
+      type Result = ClientResult<unknown>;
+      
+      expectTypeOf<Result['success']>().toEqualTypeOf<boolean>();
+    });
+  });
+
+  describe('ClientError', () => {
+    it('should have all required fields', () => {
+      expectTypeOf<ClientError>().toMatchTypeOf<{
+        status: number;
+        message: string;
+        code?: string;
+        details?: unknown;
+        timestamp?: string;
+      }>();
+    });
+  });
+
+  describe('EntityListResponse', () => {
+    it('should infer item type correctly', () => {
+      type UserListResponse = EntityListResponse<{ id: number; name: string }>;
+      
+      expectTypeOf<UserListResponse['items']>().toEqualTypeOf<Array<{ id: number; name: string }>>();
+    });
+
+    it('should have pagination fields', () => {
+      type Response = EntityListResponse<unknown>;
+      
+      expectTypeOf<Response>().toMatchTypeOf<{
+        items: unknown[];
+        total: number;
+        page?: number;
+        perPage?: number;
+      }>();
+    });
+  });
+
+  describe('AmasterClient', () => {
+    it('should have all service modules', () => {
+      expectTypeOf<AmasterClient>().toHaveProperty('auth');
+      expectTypeOf<AmasterClient>().toHaveProperty('entity');
+      expectTypeOf<AmasterClient>().toHaveProperty('bpm');
+      expectTypeOf<AmasterClient>().toHaveProperty('workflow');
+      expectTypeOf<AmasterClient>().toHaveProperty('asr');
+      expectTypeOf<AmasterClient>().toHaveProperty('copilot');
+      expectTypeOf<AmasterClient>().toHaveProperty('function');
+      expectTypeOf<AmasterClient>().toHaveProperty('tts');
+      expectTypeOf<AmasterClient>().toHaveProperty('s3');
+    });
+
+    it('should have utility methods', () => {
+      expectTypeOf<AmasterClient>().toHaveProperty('isAuthenticated');
+      expectTypeOf<AmasterClient>().toHaveProperty('getAccessToken');
+      expectTypeOf<AmasterClient>().toHaveProperty('setAccessToken');
+      expectTypeOf<AmasterClient>().toHaveProperty('clearAuth');
+    });
+  });
+
+  describe('LoginParams', () => {
+    it('should accept email login', () => {
+      const params: LoginParams = {
+        email: 'user@example.com',
+        password: 'password123'
+      };
+      
+      expectTypeOf(params).toMatchTypeOf<LoginParams>();
+    });
+
+    it('should accept username login', () => {
+      const params: LoginParams = {
+        username: 'johndoe',
+        password: 'password123'
+      };
+      
+      expectTypeOf(params).toMatchTypeOf<LoginParams>();
+    });
+
+    it('should accept phone login', () => {
+      const params: LoginParams = {
+        phone: '+1234567890',
+        password: 'password123'
+      };
+      
+      expectTypeOf(params).toMatchTypeOf<LoginParams>();
+    });
+  });
+
+  describe('Generic Type Inference', () => {
+    it('should infer entity list result type', () => {
+      type User = { id: number; name: string; email: string };
+      type Result = ClientResult<EntityListResponse<User>>;
+      
+      // If success, data.items should be User[]
+      expectTypeOf<NonNullable<Result['data']>['items']>().toEqualTypeOf<User[]>();
+    });
+
+    it('should infer entity get result type', () => {
+      type Product = { id: number; title: string; price: number };
+      type Result = ClientResult<Product>;
+      
+      expectTypeOf<NonNullable<Result['data']>>().toEqualTypeOf<Product>();
+    });
+  });
+
+  describe('BPM Types', () => {
+    it('should have correct Task structure', () => {
+      expectTypeOf<Task>().toMatchTypeOf<{
+        id: string;
+        name: string;
+        assignee: string | null;
+        processInstanceId: string;
+      }>();
+    });
+
+    it('should have correct ProcessInstance structure', () => {
+      expectTypeOf<ProcessInstance>().toMatchTypeOf<{
+        id: string;
+        definitionId?: string;
+        businessKey?: string;
+      }>();
+    });
+  });
+});