@amaster.ai/client 1.1.0-beta.7 → 1.1.0-beta.71

package/README.md

@@ -53,7 +53,7 @@ Each module contains:
 🔄 **Token auto-refresh** - never worry about expiration  
 📦 **Type-safe** - Full TypeScript support with auto-completion  
 🎯 **Simple API** - Clean, consistent method naming  
-🌐 **Complete Integration** - Auth, Entity, BPM, Workflow, ASR, Copilot, Function, TTS
+🌐 **Complete Integration** - Auth, Entity, BPM, Workflow, ASR, Copilot, Function, TTS, S3
 
 ## 📦 Installation
 
@@ -280,6 +280,307 @@ if (result.success) {
 }
 ```
 
+## 🎙️ ASR (Automatic Speech Recognition)
+
+实时语音识别支持 WebSocket 流式识别和 HTTP 按压识别两种方式。
+
+### WebSocket ASR（实时流式识别）
+
+适合需要实时看到识别结果的场景，如语音输入、实时字幕等。
+
+```tsx
+import { useRef, useState } from "react";
+import type { ASRClient } from "@amaster.ai/client";
+
+function ASRRealtimeDemo() {
+  const asrRef = useRef<ASRClient | null>(null);
+  const [result, setResult] = useState("");
+  const [status, setStatus] = useState("idle"); // idle | connecting | ready | error | closed
+
+  const start = async () => {
+    let finalResult = "";
+    let temp = "";
+
+    setStatus("connecting");
+
+    const asrClient = client.asr({
+      onReady() {
+        setStatus("ready");
+      },
+      onTranscript(text, isFinal) {
+        if (!isFinal) {
+          temp = text;
+          setResult(finalResult + temp);
+        } else {
+          temp = "";
+          finalResult += text;
+          setResult(finalResult);
+        }
+      },
+      onError(err) {
+        console.error(err);
+        setStatus("error");
+      },
+      onClose() {
+        setStatus("closed");
+      },
+    });
+
+    await asrClient.connect();
+    await asrClient.startRecording();
+    asrRef.current = asrClient;
+  };
+
+  const stop = () => {
+    asrRef.current?.stopRecording();
+    asrRef.current?.close();
+    asrRef.current = null;
+    setStatus("idle");
+  };
+
+  return (
+    <div>
+      <div>状态: {status}</div>
+      <button onClick={start} disabled={status === "connecting" || status === "ready"}>
+        开始录音
+      </button>
+      <button onClick={stop} disabled={status !== "ready"}>
+        停止
+      </button>
+      <div>识别结果: {result || "（等待说话...）"}</div>
+    </div>
+  );
+}
+```
+
+### HTTP ASR（按压识别）
+
+适合按住说话、松开识别的场景，如语音消息、语音搜索等。
+
+```tsx
+import { useRef, useState } from "react";
+import type { ASRHttpClient } from "@amaster.ai/client";
+
+function ASRPressToTalkDemo() {
+  const clientRef = useRef<ASRHttpClient | null>(null);
+  const [recording, setRecording] = useState(false);
+  const [text, setText] = useState("");
+  const [error, setError] = useState<string | null>(null);
+
+  if (!clientRef.current) {
+    clientRef.current = client.asrHttp({
+      onRecordingStart() {
+        setRecording(true);
+        setText("");
+        setError(null);
+      },
+      onRecordingStop() {
+        setRecording(false);
+      },
+      onResult(result) {
+        setText(result);
+      },
+      onError(err) {
+        setError(err.message);
+      },
+    });
+  }
+
+  const asrHttpClient = clientRef.current;
+
+  return (
+    <div>
+      <button
+        onMouseDown={() => asrHttpClient.startRecording()}
+        onMouseUp={() => asrHttpClient.stopRecording()}
+        onTouchStart={() => asrHttpClient.startRecording()}
+        onTouchEnd={() => asrHttpClient.stopRecording()}
+        style={{
+          padding: "12px 24px",
+          background: recording ? "#f87171" : "#4ade80",
+        }}
+      >
+        {recording ? "松开识别" : "按住说话"}
+      </button>
+
+      <div>
+        <strong>识别结果：</strong>
+        <div>{text || "（暂无）"}</div>
+      </div>
+
+      {error && <div style={{ color: "red" }}>错误：{error}</div>}
+    </div>
+  );
+}
+```
+
+**ASR Client 配置说明：**
+
+| 参数               | 类型                                       | 说明                           |
+| ------------------ | ------------------------------------------ | ------------------------------ |
+| `onReady`          | `() => void`                               | 会话创建完成                   |
+| `onSpeechStart`    | `() => void`                               | 检测到语音开始（仅 WebSocket） |
+| `onSpeechEnd`      | `() => void`                               | 检测到语音结束（仅 WebSocket） |
+| `onTranscript`     | `(text: string, isFinal: boolean) => void` | 转写回调（WebSocket）          |
+| `onRecordingStart` | `() => void`                               | 录音开始回调（仅 HTTP）        |
+| `onRecordingStop`  | `() => void`                               | 录音停止回调（仅 HTTP）        |
+| `onResult`         | `(text: string) => void`                   | 识别结果回调（HTTP）           |
+| `onError`          | `(error: Error) => void`                   | 错误回调                       |
+| `onClose`          | `() => void`                               | 连接关闭回调（WebSocket）      |
+
+## 🔊 TTS (Text-to-Speech)
+
+WebSocket 实时语音合成。
+
+```tsx
+import { useRef, useState } from "react";
+import type { TTSClient } from "@amaster.ai/client";
+
+function TTSDemo() {
+  const [voice, setVoice] = useState("Cherry");
+  const [connected, setConnected] = useState(false);
+  const [status, setStatus] = useState("disconnected");
+  const [text, setText] = useState("你好，欢迎使用实时语音合成服务。");
+  const clientRef = useRef<TTSClient | null>(null);
+
+  const connectTTS = () => {
+    if (clientRef.current) return;
+
+    const ttsClient = client.tts({
+      voice,
+      autoPlay: true,
+      audioFormat: "pcm",
+      sampleRate: 24000,
+      onReady: () => {
+        setConnected(true);
+        setStatus("connected");
+      },
+      onAudioStart: () => setStatus("playing"),
+      onAudioEnd: () => setStatus("connected"),
+      onAudioChunk: (chunks) => {
+        console.log("收到音频片段:", chunks.length);
+      },
+      onError: (err) => {
+        console.error("TTS Error:", err);
+        setStatus("error");
+      },
+    });
+
+    ttsClient.connect();
+    clientRef.current = ttsClient;
+  };
+
+  const sendTTS = () => {
+    if (!text || !clientRef.current) return;
+    clientRef.current.speak(text);
+    setStatus("sending");
+  };
+
+  const disconnectTTS = () => {
+    clientRef.current?.close();
+    clientRef.current = null;
+    setConnected(false);
+    setStatus("disconnected");
+  };
+
+  return (
+    <div>
+      <h3>🔊 实时语音合成</h3>
+      <div>状态: {status}</div>
+
+      <div>
+        <label>音色:</label>
+        <select value={voice} onChange={(e) => setVoice(e.target.value)}>
+          <option value="Cherry">Cherry - 甜美女声</option>
+          <option value="Serena">苏瑶 - 温柔小姐姐</option>
+          <option value="Ethan">晨煦 - 标准普通话</option>
+          <option value="Chelsie">千雪 - 二次元虚拟女友</option>
+          <option value="Peter">天津话</option>
+        </select>
+      </div>
+
+      <div>
+        <label>合成文本:</label>
+        <textarea rows={4} value={text} onChange={(e) => setText(e.target.value)} />
+      </div>
+
+      <div>
+        <button onClick={connectTTS} disabled={connected}>
+          连接
+        </button>
+        <button onClick={sendTTS} disabled={!connected}>
+          合成语音
+        </button>
+        <button onClick={disconnectTTS} disabled={!connected}>
+          断开
+        </button>
+      </div>
+    </div>
+  );
+}
+```
+
+**TTS Client 配置说明：**
+
+| 参数           | 类型                                | 默认值     | 说明                           |
+| -------------- | ----------------------------------- | ---------- | ------------------------------ |
+| `voice`        | `string`                            | `"Cherry"` | 发音人名称                     |
+| `autoPlay`     | `boolean`                           | `true`     | 是否自动播放                   |
+| `audioFormat`  | `"pcm" \| "mp3" \| "wav" \| "opus"` | `"pcm"`    | 音频格式（内置播放仅支持 pcm） |
+| `sampleRate`   | `number`                            | `24000`    | 采样率                         |
+| `onReady`      | `() => void`                        | -          | 会话就绪回调                   |
+| `onAudioStart` | `() => void`                        | -          | 音频开始播放回调               |
+| `onAudioEnd`   | `() => void`                        | -          | 音频播放结束回调               |
+| `onAudioChunk` | `(chunks: string[]) => void`        | -          | 音频分片回调                   |
+| `onError`      | `(error: Error) => void`            | -          | 错误回调                       |
+
+## 🤖 Copilot (AI Assistant)
+
+AI assistant / chatbot API.
+
+```typescript
+// Simple chat
+const result = await client.copilot.sendMessage([
+  { role: "user", content: "Hello, how can you help?" },
+]);
+
+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),
+});
+```
+
+## ⚙️ Function Invocation
+
+调用服务端函数。
+
+```typescript
+// Call a function
+const result = await client.function.invoke<{ result: string }>("sendEmail", {
+  to: "user@example.com",
+  subject: "Hello",
+});
+
+if (result.data) {
+  console.log("Function result:", result.data.result);
+}
+```
+
+## ☁️ S3 Storage
+
+文件上传下载。
+
+```typescript
+// Upload file
+await client.s3.upload(file);
+
+// Download file
+await client.s3.download("path/to/file");
+```
+
 ## ⚙️ Configuration
 
 ### Client Options
@@ -303,6 +604,9 @@ interface AmasterClientOptions {
 
   /** Refresh threshold in seconds (default: 300) */
   refreshThreshold?: number;
+
+  /** Automatically handle OAuth callback on initialization (default: true) */
+  autoHandleOAuthCallback?: boolean;
 }
 ```
 
@@ -360,6 +664,17 @@ if (result.success) {
 }
 ```
 
+### Custom HTTP Requests
+
+```typescript
+// Make a custom request with automatic auth
+const { data, error } = await client.http.request({
+  url: "/custom/endpoint",
+  method: "POST",
+  data: { key: "value" },
+});
+```
+
 ## 🎨 Comparison with Individual Clients
 
 ### Before (Using separate clients)
@@ -444,101 +759,49 @@ Workflow execution API from `@amaster.ai/workflow-client`:
 
 ### `client.asr`
 
-Real-time speech recognition API from `@amaster.ai/asr-client`:
+WebSocket real-time speech recognition:
 
-- `connect()` - Connect to ASR service via WebSocket
+- `connect()` - Connect to ASR service
 - `startRecording()` - Start microphone recording
 - `stopRecording()` - Stop recording
 - `close()` - Close connection
 
-**Example:**
+### `client.asrHttp`
 
-```typescript
-// Configure callbacks
-client.asr = createASRClient({
-  onTranscript: (text, isFinal) => {
-    console.log(isFinal ? `[FINAL] ${text}` : `[INTERIM] ${text}`);
-  },
-});
+HTTP press-to-talk speech recognition:
 
-// Connect and start
-await client.asr.connect();
-await client.asr.startRecording();
+- `startRecording()` - Start recording
+- `stopRecording()` - Stop and get result
+- `recognizeFile(file)` - Recognize audio file
+- `recognizeUrl(url)` - Recognize audio URL
 
-// Stop when done
-client.asr.stopRecording();
-client.asr.close();
-```
-
-### `client.copilot`
-
-AI assistant / chatbot API from `@amaster.ai/copilot-client`:
+### `client.tts`
 
-- `sendMessage(messages, options?)` - Send messages to AI assistant
+WebSocket real-time text-to-speech:
 
-**Example:**
+- `connect()` - Connect to TTS service
+- `speak(text)` - Synthesize and play speech
+- `play()` - Manually play audio
+- `close()` - Close connection
 
-```typescript
-// Simple chat
-const result = await client.copilot.sendMessage([
-  { role: "user", content: "Hello, how can you help?" },
-]);
+### `client.copilot`
 
-console.log(result.data.content);
+AI assistant API:
 
-// Streaming response
-await client.copilot.sendMessage([{ role: "user", content: "Tell me a story" }], {
-  stream: true,
-  onChunk: (chunk) => console.log(chunk),
-});
-```
+- `sendMessage(messages, options?)` - Send messages to AI
 
 ### `client.function`
 
-Function invocation API from `@amaster.ai/function-client`:
+Function invocation API:
 
 - `invoke<T>(funcName, params?)` - Invoke a serverless function
 
-**Example:**
+### `client.s3`
 
-```typescript
-// Call a function
-const result = await client.function.invoke<{ result: string }>("sendEmail", {
-  to: "user@example.com",
-  subject: "Hello",
-});
-
-if (result.data) {
-  console.log("Function result:", result.data.result);
-}
-```
+S3 storage API:
 
-### `client.tts`
-
-Real-time text-to-speech API from `@amaster.ai/tts-client`:
-
-- `connect()` - Connect to TTS service via WebSocket
-- `speak(text)` - Synthesize and play speech
-- `play()` - Manually play audio (when autoPlay is off)
-- `close()` - Close connection
-
-**Example:**
-
-```typescript
-// Configure TTS
-client.tts = createTTSClient({
-  voice: "Cherry",
-  autoPlay: true,
-  onAudioStart: () => console.log("Playing audio"),
-});
-
-// Connect and speak
-await client.tts.connect();
-await client.tts.speak("Hello, welcome to Amaster!");
-
-// Close when done
-client.tts.close();
-```
+- `upload(file)` - Upload file
+- `download(path)` - Download file
 
 ## 🔐 Token Management Flow
 
@@ -572,10 +835,11 @@ All these packages are now integrated into `@amaster.ai/client`:
 - `@amaster.ai/entity-client` - Entity CRUD operations
 - `@amaster.ai/bpm-client` - Business Process Management
 - `@amaster.ai/workflow-client` - Workflow execution
-- `@amaster.ai/asr-client` - Speech recognition (WebSocket)
+- `@amaster.ai/asr-client` - Speech recognition (WebSocket + HTTP)
 - `@amaster.ai/copilot-client` - AI assistant / chatbot
 - `@amaster.ai/function-client` - Function invocation
 - `@amaster.ai/tts-client` - Text-to-speech (WebSocket)
+- `@amaster.ai/s3-client` - S3 storage operations
 - `@amaster.ai/http-client` - HTTP client foundation (internal)
 
 ## 💡 Inspiration

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,7 +67,32 @@ function createClient(options) {
             ...authHeaders
           }
         };
-        const result = await baseHttpClient.request(mergedConfig);
+        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();
         }
@@ -44,22 +101,54 @@ function createClient(options) {
     };
   };
   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.createCopilotA2UIClient(authenticatedHttpClient);
-  const asr = asrClient.createASRClient({});
-  const tts = ttsClient.createTTSClient({});
+  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(),
+    http: authenticatedHttpClient
+  });
+  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(),

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","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    http: authenticatedHttpClient,\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"]}