@amaster.ai/client 1.0.0-alpha.1

package/dist/index.cjs

@@ -0,0 +1,162 @@
+'use strict';
+
+var authClient = require('@amaster.ai/auth-client');
+var entityClient = require('@amaster.ai/entity-client');
+var bpmClient = require('@amaster.ai/bpm-client');
+var workflowClient = require('@amaster.ai/workflow-client');
+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,
+    autoHandleOAuthCallback
+  } = options;
+  const baseHttpClient = httpClient.createHttpClient({
+    baseURL,
+    headers
+  });
+  const auth = authClient.createAuthClient({
+    baseURL,
+    headers,
+    onTokenExpired,
+    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();
+        const authHeaders = token ? { Authorization: `Bearer ${token}` } : {};
+        const mergedConfig = {
+          ...config,
+          headers: {
+            ...config.headers,
+            ...authHeaders
+          }
+        };
+        let result = await baseHttpClient.request(mergedConfig);
+        if (result.status === 401 && 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();
+            result = await baseHttpClient.request({
+              ...config,
+              headers: {
+                ...config.headers,
+                ...newToken ? { Authorization: `Bearer ${newToken}` } : {}
+              }
+            });
+          }
+        }
+        if (result.status === 401 && onUnauthorized) {
+          onUnauthorized();
+        }
+        return result;
+      }
+    };
+  };
+  const authenticatedHttpClient = createAuthenticatedHttpClient();
+  let cachedUserUid = null;
+  auth.on("login", (user) => {
+    cachedUserUid = user?.uid ?? null;
+  });
+  auth.on("logout", () => {
+    cachedUserUid = null;
+  });
+  if (auth.isAuthenticated()) {
+    auth.getMe().then((result) => {
+      if (result.data?.uid) {
+        cachedUserUid = result.data.uid;
+      }
+    }).catch(() => {
+    });
+  }
+  const entity = entityClient.createEntityClient(authenticatedHttpClient);
+  const bpm = bpmClient.createBpmClient(authenticatedHttpClient);
+  const workflow = workflowClient.createWorkflowClient(authenticatedHttpClient);
+  const functionClient$1 = functionClient.createFunctionClient(authenticatedHttpClient);
+  const copilot = copilotClient.createCopilotClient(
+    authenticatedHttpClient,
+    baseURL,
+    () => auth.getAccessToken(),
+    () => cachedUserUid
+  );
+  const s3 = s3Client.createS3Client(authenticatedHttpClient);
+  const asr = asrClient.createASRClient({
+    getAccessToken: () => auth.getAccessToken()
+  });
+  const asrHttp = asrClient.createASRHttpClient({
+    getAccessToken: () => auth.getAccessToken()
+  });
+  const tts = ttsClient.createTTSClient({
+    getAccessToken: () => auth.getAccessToken()
+  });
+  const client = {
+    auth,
+    entity,
+    bpm,
+    workflow,
+    asr,
+    asrHttp,
+    copilot,
+    function: functionClient$1,
+    tts,
+    s3,
+    http: authenticatedHttpClient,
+    // Expose token management methods from auth client
+    isAuthenticated: () => auth.isAuthenticated(),
+    getAccessToken: () => auth.getAccessToken(),
+    setAccessToken: (token) => auth.setAccessToken(token),
+    clearAuth: () => auth.clearAuth()
+  };
+  return client;
+}
+
+exports.createClient = createClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":["createHttpClient","createAuthClient","createEntityClient","createBpmClient","createWorkflowClient","functionClient","createFunctionClient","createCopilotClient","createS3Client","createASRClient","createASRHttpClient","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 {\n  createASRClient,\n  createASRHttpClient,\n  type ASRClientConfig,\n  type ASRClient,\n  type ASRHttpClientConfig,\n  type ASRHttpClient,\n} from \"@amaster.ai/asr-client\";\nimport { createCopilotClient, type CopilotClient } from \"@amaster.ai/copilot-client\";\nimport { createFunctionClient, type FunctionClient } from \"@amaster.ai/function-client\";\nimport { createTTSClient, TTSClientConfig, 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 && 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          const refreshed = await refreshPromise;\n\n          if (refreshed) {\n            // Retry with new token\n            const newToken = auth.getAccessToken();\n            result = await baseHttpClient.request<T>({\n              ...config,\n              headers: {\n                ...config.headers,\n                ...(newToken ? { Authorization: `Bearer ${newToken}` } : {}),\n              },\n            });\n          }\n        }\n\n        // Trigger unauthorized if still 401\n        if (result.status === 401 && onUnauthorized) {\n          onUnauthorized();\n        }\n\n        return result;\n      },\n    };\n  };\n\n  const authenticatedHttpClient = createAuthenticatedHttpClient();\n\n  let cachedUserUid: string | null = null;\n\n  auth.on(\"login\", (user: { uid?: string }) => {\n    cachedUserUid = user?.uid ?? null;\n  });\n  auth.on(\"logout\", () => {\n    cachedUserUid = null;\n  });\n\n  if (auth.isAuthenticated()) {\n    auth\n      .getMe()\n      .then((result) => {\n        if (result.data?.uid) {\n          cachedUserUid = result.data.uid;\n        }\n      })\n      .catch(() => {});\n  }\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: CopilotClient = createCopilotClient(\n    authenticatedHttpClient,\n    baseURL,\n    () => auth.getAccessToken(),\n    () => cachedUserUid\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: (config: ASRClientConfig) => ASRClient = createASRClient({\n    getAccessToken: () => auth.getAccessToken(),\n  });\n  const asrHttp: (config: ASRHttpClientConfig) => ASRHttpClient = createASRHttpClient({\n    getAccessToken: () => auth.getAccessToken(),\n  });\n  const tts: (config: TTSClientConfig) => 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    asrHttp,\n    copilot,\n    function: functionClient,\n    tts,\n    s3,\n    http: authenticatedHttpClient,\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

@@ -0,0 +1,421 @@
+import { AuthClient } from '@amaster.ai/auth-client';
+export { LoginParams, LoginResponse, OAuthProvider, Permission, RegisterParams, Role, Session, User } from '@amaster.ai/auth-client';
+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 { 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 { ASRClientConfig, ASRClient, ASRHttpClientConfig, ASRHttpClient } from '@amaster.ai/asr-client';
+export { ASRClient, ASRClientConfig, ASRHttpClient, ASRHttpClientConfig, ASRLanguage } from '@amaster.ai/asr-client';
+import { CopilotClient } from '@amaster.ai/copilot-client';
+export { ChatMessage, ChatOptions, CopilotClient, FileContent, ImageContent, MessageContent, TextContent } from '@amaster.ai/copilot-client';
+import { FunctionClient } from '@amaster.ai/function-client';
+export { FunctionClient } from '@amaster.ai/function-client';
+import { TTSClientConfig, 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';
+import { HttpClient } from '@amaster.ai/http-client';
+export { ClientError, ClientResult, HttpClient, RequestConfig } from '@amaster.ai/http-client';
+
+/**
+ * Amaster Client Configuration Options
+ */
+interface AmasterClientOptions {
+    /**
+     * Base URL for the Amaster API (optional)
+     *
+     * If not provided:
+     * - Browser/H5: Uses dev proxy or relative URLs
+     * - Taro/Mini-program: Auto-reads from process.env.TARO_APP_API_BASE_URL or VITE_API_BASE_URL
+     *
+     * @example 'https://api.amaster.ai'
+     */
+    baseURL?: string;
+    /**
+     * Optional custom headers to include in all requests
+     */
+    headers?: Record<string, string>;
+    /**
+     * Callback function triggered when a 401 Unauthorized response is received
+     * Useful for redirecting to login page or showing auth modal
+     * @example () => window.location.href = '/login'
+     */
+    onUnauthorized?: () => void;
+    /**
+     * Callback function triggered when the access token expires
+     * Auto-refresh is handled internally, this is for additional actions
+     */
+    onTokenExpired?: () => void;
+    /**
+     * Enable automatic token refresh (default: true)
+     */
+    autoRefresh?: boolean;
+    /**
+     * Token refresh threshold in seconds (default: 300 = 5 minutes)
+     * 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
+ *
+ * Provides a simplified, Supabase-style API to access all Amaster services
+ */
+interface AmasterClient {
+    /**
+     * Authentication module
+     *
+     * @example
+     * ```typescript
+     * // Login
+     * await client.auth.login({ email, password });
+     *
+     * // Register
+     * await client.auth.register({ username, email, password });
+     *
+     * // Logout
+     * await client.auth.logout();
+     *
+     * // Get current user
+     * const user = await client.auth.getMe();
+     * ```
+     */
+    auth: AuthClient;
+    /**
+     * Entity CRUD operations module
+     *
+     * @example
+     * ```typescript
+     * // List entities
+     * const result = await client.entity.list('default', 'users', {
+     *   page: 1,
+     *   perPage: 20,
+     *   orderBy: 'createdAt',
+     *   orderDir: 'desc'
+     * });
+     *
+     * // Get single entity
+     * const user = await client.entity.get('default', 'users', 1);
+     *
+     * // Create entity
+     * await client.entity.create('default', 'users', { name: 'John' });
+     *
+     * // Update entity
+     * await client.entity.update('default', 'users', 1, { name: 'Jane' });
+     *
+     * // Delete entity
+     * await client.entity.delete('default', 'users', 1);
+     * ```
+     */
+    entity: EntityClient;
+    /**
+     * BPM (Business Process Management) module
+     *
+     * @example
+     * ```typescript
+     * // Start a process
+     * await client.bpm.startProcess({
+     *   processKey: 'approval-process',
+     *   variables: { amount: 1000 }
+     * });
+     *
+     * // Get my tasks
+     * const tasks = await client.bpm.getMyTasks();
+     *
+     * // Complete a task
+     * await client.bpm.completeTask(taskId, { approved: true });
+     * ```
+     */
+    bpm: BpmClient;
+    /**
+     * Workflow execution module
+     *
+     * @example
+     * ```typescript
+     * // Execute a workflow
+     * const result = await client.workflow.execute('my-workflow', {
+     *   input: { data: 'value' }
+     * });
+     * ```
+     */
+    workflow: WorkflowClient;
+    /**
+     * ASR (Automatic Speech Recognition) module - WebSocket-based real-time speech recognition
+     *
+     * Suitable for scenarios requiring real-time transcription results, such as voice input, live captions, etc.
+     *
+     * @example
+     * ```typescript
+     * // Real-time streaming recognition
+     * const asrClient = client.asr({
+     *   onReady() {
+     *     console.log('ASR Ready');
+     *   },
+     *   onTranscript(text, isFinal) {
+     *     console.log(isFinal ? '[Final]' : '[Interim]', text);
+     *   },
+     *   onError(err) {
+     *     console.error('ASR Error:', err);
+     *   },
+     *   onClose() {
+     *     console.log('ASR Connection Closed');
+     *   },
+     * });
+     *
+     * await asrClient.connect();
+     * await asrClient.startRecording();
+     *
+     * // Stop and close
+     * asrClient.stopRecording();
+     * asrClient.close();
+     * ```
+     */
+    asr: (config: ASRClientConfig) => ASRClient;
+    /**
+     * ASR Http module - HTTP-based press-to-talk speech recognition
+     *
+     * Suitable for press-to-talk scenarios where you hold to speak and release to recognize,
+     * such as voice messages, voice search, etc.
+     *
+     * @example
+     * ```typescript
+     * // Press-to-talk recognition
+     * const asrHttpClient = client.asrHttp({
+     *   onRecordingStart() {
+     *     console.log('Recording started');
+     *   },
+     *   onRecordingStop() {
+     *     console.log('Recording stopped');
+     *   },
+     *   onResult(text) {
+     *     console.log('Recognition result:', text);
+     *   },
+     *   onError(err) {
+     *     console.error('ASR HTTP Error:', err);
+     *   },
+     * });
+     *
+     * await asrHttpClient.startRecording();
+     * // ... user speaks ...
+     * const result = await asrHttpClient.stopRecording();
+     * ```
+     */
+    asrHttp: (config: ASRHttpClientConfig) => ASRHttpClient;
+    /**
+     * Copilot AI assistant module
+     *
+     * @example
+     * ```typescript
+     * // Send a message
+     * const result = await client.copilot.sendMessage([
+     *   { role: 'user', content: 'Hello' }
+     * ]);
+     * ```
+     */
+    copilot: CopilotClient;
+    /**
+     * Function invocation module
+     *
+     * @example
+     * ```typescript
+     * // Call a function
+     * const result = await client.function.invoke('myFunction', {
+     *   param: 'value'
+     * });
+     * ```
+     */
+    function: FunctionClient;
+    /**
+     * TTS (Text-to-Speech) module - WebSocket-based real-time speech synthesis
+     *
+     * Supports multiple voices and audio formats. Built-in playback only supports PCM format.
+     *
+     * @example
+     * ```typescript
+     * // Connect and speak
+     * const ttsClient = client.tts({
+     *   voice: 'Cherry',
+     *   autoPlay: true,
+     *   onReady() {
+     *     console.log('TTS Ready');
+     *   },
+     *   onAudioStart() {
+     *     console.log('Playing audio');
+     *   },
+     *   onAudioEnd() {
+     *     console.log('Audio playback ended');
+     *   },
+     * });
+     *
+     * await ttsClient.connect();
+     * await ttsClient.speak('Hello, welcome to Amaster!');
+     *
+     * // Close when done
+     * ttsClient.close();
+     * ```
+     */
+    tts: (config: TTSClientConfig) => TTSClient;
+    /**
+     * S3 Storage module
+     *
+     * @example
+     * ```typescript
+     * // Upload file
+     * await client.s3.upload(file);
+     *
+     * // Download file
+     * await client.s3.download('path/to/file');
+     * ```
+     */
+    s3: S3Client;
+    /**
+     * HTTP client for custom requests
+     *
+     * Provides direct access to the underlying HTTP client with automatic
+     * authentication token attachment. Useful for calling custom endpoints
+     * or APIs not covered by the specialized clients.
+     *
+     * Supports both `data` (Axios style) and `body` (Fetch API style) for request payload.
+     *
+     * @example
+     * ```typescript
+     * // Make a custom GET request
+     * const { data, error } = await client.http.request({
+     *   url: '/custom/endpoint',
+     *   method: 'GET'
+     * });
+     *
+     * // Make a POST request with data (Axios style)
+     * const { data, error } = await client.http.request({
+     *   url: '/custom/endpoint',
+     *   method: 'POST',
+     *   data: { key: 'value' }
+     * });
+     *
+     * // Make a POST request with body (Fetch API style, auto-converted to data)
+     * const { data, error } = await client.http.request({
+     *   url: '/custom/endpoint',
+     *   method: 'POST',
+     *   body: { key: 'value' }
+     * });
+     * ```
+     */
+    http: HttpClient;
+    /**
+     * Check if the user is currently authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get the current access token
+     */
+    getAccessToken(): string | null;
+    /**
+     * Manually set an access token (useful for SSR or token from external auth)
+     */
+    setAccessToken(token: string): void;
+    /**
+     * Clear all authentication data
+     */
+    clearAuth(): void;
+}
+
+/**
+ * ============================================================================
+ * @amaster.ai/client - Unified Amaster Client
+ * ============================================================================
+ *
+ * Supabase-inspired unified API client for the Amaster platform
+ *
+ * Features:
+ * - Single client instance for all services (auth, entity, bpm, workflow)
+ * - Automatic token management and refresh
+ * - Auto-attach authentication to all requests
+ * - Centralized error handling
+ *
+ * @example
+ * ```typescript
+ * // With explicit baseURL
+ * const client = createClient({
+ *   baseURL: 'https://api.amaster.ai',
+ *   onUnauthorized: () => window.location.href = '/login'
+ * });
+ *
+ * // Auto-detect baseURL from env (Taro/Mini-program)
+ * const client = createClient({
+ *   onUnauthorized: () => window.location.href = '/login'
+ * });
+ *
+ * // Login
+ * await client.auth.login({ email, password });
+ *
+ * // All subsequent requests automatically include auth token
+ * await client.entity.list('default', 'users');
+ * await client.bpm.startProcess({ processKey: 'approval' });
+ * ```
+ */
+
+/**
+ * Create a unified Amaster client instance
+ *
+ * This function creates a single client that provides access to all Amaster services:
+ * - Authentication (login, register, logout)
+ * - Entity CRUD operations
+ * - BPM (Business Process Management)
+ * - Workflow execution
+ *
+ * All sub-clients automatically share the same HTTP client and authentication state,
+ * ensuring that tokens are consistently attached to all requests.
+ *
+ * @param options - Client configuration options
+ * @returns A unified Amaster client instance
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with explicit baseURL
+ * const client = createClient({
+ *   baseURL: 'https://api.amaster.ai'
+ * });
+ *
+ * // Auto-detect baseURL (for Taro/Mini-program or dev proxy)
+ * const client = createClient({});
+ *
+ * // With authentication callbacks
+ * const client = createClient({
+ *   baseURL: 'https://api.amaster.ai',
+ *   onUnauthorized: () => {
+ *     // Redirect to login or show auth modal
+ *     window.location.href = '/login';
+ *   },
+ *   onTokenExpired: () => {
+ *     console.log('Token expired, refreshing...');
+ *   }
+ * });
+ *
+ * // Login
+ * await client.auth.login({
+ *   email: 'user@example.com',
+ *   password: 'password123'
+ * });
+ *
+ * // Now all requests automatically include the auth token
+ * const users = await client.entity.list('default', 'users');
+ * const tasks = await client.bpm.getMyTasks();
+ * ```
+ */
+declare function createClient(options: AmasterClientOptions): AmasterClient;
+
+export { type AmasterClient, type AmasterClientOptions, createClient };