@amaster.ai/client 1.1.0-beta.0 → 1.1.0-beta.2

package/README.md

@@ -1,6 +1,6 @@
 # @amaster.ai/client
 
-> Unified API client for the Amaster platform - Supabase-style developer experience
+> Unified API client for the Amaster platform - All services in one package
 
 [![npm version](https://img.shields.io/npm/v/@amaster.ai/client.svg)](https://www.npmjs.com/package/@amaster.ai/client)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
@@ -19,13 +19,25 @@ This package is designed with AI tools (GitHub Copilot, Cursor, etc.) in mind:
 ```
 types/
   ├── index.d.ts      # Main entry (lightweight)
-  ├── auth.d.ts       # Authentication API (login, register, etc.)
+  ├── auth/           # Authentication (split into 7 focused modules)
+  │   ├── user.d.ts
+  │   ├── password-auth.d.ts
+  │   ├── code-auth.d.ts
+  │   ├── oauth.d.ts
+  │   ├── permissions.d.ts
+  │   ├── profile.d.ts
+  │   └── index.d.ts
   ├── entity.d.ts     # Entity CRUD operations
   ├── bpm.d.ts        # Business Process Management
-  └── workflow.d.ts   # Workflow execution
+  ├── workflow.d.ts   # Workflow execution
+  ├── asr.d.ts        # Speech Recognition (WebSocket)
+  ├── copilot.d.ts    # AI Assistant / Chat
+  ├── function.d.ts   # Function invocation
+  └── tts.d.ts        # Text-to-Speech (WebSocket)
 ```
 
 Each module contains:
+
 - Complete method signatures
 - Parameter descriptions
 - Return type definitions
@@ -41,6 +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
 
 ## 📦 Installation
 
@@ -58,27 +71,27 @@ yarn add @amaster.ai/client axios
 ## 🎯 Quick Start
 
 ```typescript
-import { createClient } from '@amaster.ai/client';
+import { createClient } from "@amaster.ai/client";
 
 // 1. Create client instance
 const client = createClient({
-  baseURL: 'https://api.amaster.ai',
+  baseURL: "https://api.amaster.ai",
   onUnauthorized: () => {
     // Handle unauthorized (redirect to login, show modal, etc.)
-    window.location.href = '/login';
-  }
+    window.location.href = "/login";
+  },
 });
 
 // 2. Login
 await client.auth.login({
-  email: 'user@example.com',
-  password: 'password123'
+  email: "user@example.com",
+  password: "password123",
 });
 
 // 3. Use any service - auth token is automatically attached!
-const users = await client.entity.list('default', 'users');
+const users = await client.entity.list("default", "users");
 const tasks = await client.bpm.getMyTasks();
-const result = await client.workflow.execute('my-workflow', { input: {} });
+const result = await client.workflow.execute("my-workflow", { input: {} });
 ```
 
 ## 🔑 Authentication
@@ -88,12 +101,12 @@ const result = await client.workflow.execute('my-workflow', { input: {} });
 ```typescript
 // Email/Password login
 const result = await client.auth.login({
-  email: 'user@example.com',
-  password: 'password123'
+  email: "user@example.com",
+  password: "password123",
 });
 
 if (result.success) {
-  console.log('Logged in:', result.data.user);
+  console.log("Logged in:", result.data.user);
 }
 ```
 
@@ -101,9 +114,9 @@ if (result.success) {
 
 ```typescript
 const result = await client.auth.register({
-  username: 'johndoe',
-  email: 'john@example.com',
-  password: 'securePassword123'
+  username: "johndoe",
+  email: "john@example.com",
+  password: "securePassword123",
 });
 ```
 
@@ -112,7 +125,7 @@ const result = await client.auth.register({
 ```typescript
 const result = await client.auth.getMe();
 if (result.success) {
-  console.log('Current user:', result.data);
+  console.log("Current user:", result.data);
 }
 ```
 
@@ -126,7 +139,7 @@ await client.auth.logout();
 
 ```typescript
 if (client.isAuthenticated()) {
-  console.log('User is logged in');
+  console.log("User is logged in");
 }
 ```
 
@@ -137,14 +150,14 @@ Full CRUD operations for your data entities with type safety.
 ### List Entities
 
 ```typescript
-const result = await client.entity.list('default', 'users', {
+const result = await client.entity.list("default", "users", {
   page: 1,
   perPage: 20,
-  orderBy: 'createdAt',
-  orderDir: 'desc',
+  orderBy: "createdAt",
+  orderDir: "desc",
   // Filters
-  'status[eq]': 'active',
-  'age[gt]': 18
+  "status[eq]": "active",
+  "age[gt]": 18,
 });
 
 if (result.success) {
@@ -156,48 +169,48 @@ if (result.success) {
 ### Get Single Entity
 
 ```typescript
-const result = await client.entity.get('default', 'users', 123);
+const result = await client.entity.get("default", "users", 123);
 if (result.success) {
-  console.log('User:', result.data);
+  console.log("User:", result.data);
 }
 ```
 
 ### Create Entity
 
 ```typescript
-const result = await client.entity.create('default', 'users', {
-  name: 'John Doe',
-  email: 'john@example.com',
-  status: 'active'
+const result = await client.entity.create("default", "users", {
+  name: "John Doe",
+  email: "john@example.com",
+  status: "active",
 });
 ```
 
 ### Update Entity
 
 ```typescript
-const result = await client.entity.update('default', 'users', 123, {
-  name: 'Jane Doe',
-  status: 'inactive'
+const result = await client.entity.update("default", "users", 123, {
+  name: "Jane Doe",
+  status: "inactive",
 });
 ```
 
 ### Delete Entity
 
 ```typescript
-await client.entity.delete('default', 'users', 123);
+await client.entity.delete("default", "users", 123);
 ```
 
 ### Bulk Operations
 
 ```typescript
 // Bulk update
-await client.entity.bulkUpdate('default', 'users', [
-  { id: 1, status: 'active' },
-  { id: 2, status: 'inactive' }
+await client.entity.bulkUpdate("default", "users", [
+  { id: 1, status: "active" },
+  { id: 2, status: "inactive" },
 ]);
 
 // Bulk delete
-await client.entity.bulkDelete('default', 'users', [1, 2, 3]);
+await client.entity.bulkDelete("default", "users", [1, 2, 3]);
 ```
 
 ## 🔄 BPM (Business Process Management)
@@ -208,12 +221,12 @@ Manage business processes powered by Camunda 7.
 
 ```typescript
 const result = await client.bpm.startProcess({
-  processKey: 'approval-process',
-  businessKey: 'ORDER-12345',
+  processKey: "approval-process",
+  businessKey: "ORDER-12345",
   variables: {
     amount: 1000,
-    requester: 'john@example.com'
-  }
+    requester: "john@example.com",
+  },
 });
 ```
 
@@ -223,28 +236,28 @@ const result = await client.bpm.startProcess({
 const result = await client.bpm.getMyTasks({
   page: 1,
   perPage: 20,
-  sortBy: 'created',
-  sortOrder: 'desc'
+  sortBy: "created",
+  sortOrder: "desc",
 });
 
 if (result.success) {
-  console.log('Tasks:', result.data.items);
+  console.log("Tasks:", result.data.items);
 }
 ```
 
 ### Complete a Task
 
 ```typescript
-await client.bpm.completeTask('task-id', {
+await client.bpm.completeTask("task-id", {
   approved: true,
-  comments: 'Looks good!'
+  comments: "Looks good!",
 });
 ```
 
 ### Claim a Task
 
 ```typescript
-await client.bpm.claimTask('task-id');
+await client.bpm.claimTask("task-id");
 ```
 
 ## ⚡ Workflow Execution
@@ -252,15 +265,15 @@ await client.bpm.claimTask('task-id');
 Execute workflows and automation flows.
 
 ```typescript
-const result = await client.workflow.execute('data-processing-workflow', {
+const result = await client.workflow.execute("data-processing-workflow", {
   input: {
-    dataSource: 'users',
-    filters: { status: 'active' }
-  }
+    dataSource: "users",
+    filters: { status: "active" },
+  },
 });
 
 if (result.success) {
-  console.log('Workflow result:', result.data);
+  console.log("Workflow result:", result.data);
 }
 ```
 
@@ -294,23 +307,23 @@ interface AmasterClientOptions {
 
 ```typescript
 const client = createClient({
-  baseURL: 'https://api.amaster.ai',
-  
+  baseURL: "https://api.amaster.ai",
+
   headers: {
-    'X-App-Version': '1.0.0'
+    "X-App-Version": "1.0.0",
   },
-  
+
   onUnauthorized: () => {
-    console.log('Session expired, redirecting to login...');
-    window.location.href = '/login';
+    console.log("Session expired, redirecting to login...");
+    window.location.href = "/login";
   },
-  
+
   onTokenExpired: () => {
-    console.log('Token expired, will auto-refresh');
+    console.log("Token expired, will auto-refresh");
   },
-  
+
   autoRefresh: true,
-  refreshThreshold: 300 // Refresh 5 minutes before expiry
+  refreshThreshold: 300, // Refresh 5 minutes before expiry
 });
 ```
 
@@ -323,7 +336,7 @@ const client = createClient({
 const token = client.getAccessToken();
 
 // Set token manually (useful for SSR or external auth)
-client.setAccessToken('your-jwt-token');
+client.setAccessToken("your-jwt-token");
 
 // Clear all auth data
 client.clearAuth();
@@ -332,15 +345,15 @@ client.clearAuth();
 ### Error Handling
 
 ```typescript
-const result = await client.entity.list('default', 'users');
+const result = await client.entity.list("default", "users");
 
 if (result.success) {
   // Success case
-  console.log('Data:', result.data);
+  console.log("Data:", result.data);
 } else {
   // Error case
-  console.error('Error:', result.error);
-  console.error('Status:', result.statusCode);
+  console.error("Error:", result.error);
+  console.error("Status:", result.statusCode);
 }
 ```
 
@@ -349,9 +362,9 @@ if (result.success) {
 ### Before (Using separate clients)
 
 ```typescript
-import { createAuthClient } from '@amaster.ai/auth-client';
-import { createEntityClient } from '@amaster.ai/entity-client';
-import { createBpmClient } from '@amaster.ai/bpm-client';
+import { createAuthClient } from "@amaster.ai/auth-client";
+import { createEntityClient } from "@amaster.ai/entity-client";
+import { createBpmClient } from "@amaster.ai/bpm-client";
 
 const authClient = createAuthClient({ baseURL });
 const entityClient = createEntityClient({ baseURL });
@@ -367,13 +380,13 @@ const token = authClient.getAccessToken();
 ### After (Using unified client)
 
 ```typescript
-import { createClient } from '@amaster.ai/client';
+import { createClient } from "@amaster.ai/client";
 
 const client = createClient({ baseURL });
 
 // One client, automatic token management
 await client.auth.login({ email, password });
-await client.entity.list('default', 'users'); // Token automatically attached
+await client.entity.list("default", "users"); // Token automatically attached
 await client.bpm.getMyTasks(); // Token automatically attached
 ```
 
@@ -426,6 +439,107 @@ Workflow execution API from `@amaster.ai/workflow-client`:
 - `getStatus(executionId)` - Get execution status
 - And more...
 
+### `client.asr`
+
+Real-time speech recognition API from `@amaster.ai/asr-client`:
+
+- `connect()` - Connect to ASR service via WebSocket
+- `startRecording()` - Start microphone recording
+- `stopRecording()` - Stop recording
+- `close()` - Close connection
+
+**Example:**
+
+```typescript
+// Configure callbacks
+client.asr = createASRClient({
+  onTranscript: (text, isFinal) => {
+    console.log(isFinal ? `[FINAL] ${text}` : `[INTERIM] ${text}`);
+  },
+});
+
+// Connect and start
+await client.asr.connect();
+await client.asr.startRecording();
+
+// Stop when done
+client.asr.stopRecording();
+client.asr.close();
+```
+
+### `client.copilot`
+
+AI assistant / chatbot API from `@amaster.ai/copilot-client`:
+
+- `sendMessage(messages, options?)` - Send messages to AI assistant
+
+**Example:**
+
+```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),
+  }
+);
+```
+
+### `client.function`
+
+Function invocation API from `@amaster.ai/function-client`:
+
+- `invoke<T>(funcName, params?)` - Invoke a serverless function
+
+**Example:**
+
+```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);
+}
+```
+
+### `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();
+```
+
 ## 🔐 Token Management Flow
 
 ```
@@ -452,11 +566,17 @@ MIT © Amaster Team
 
 ## 🤝 Related Packages
 
-- `@amaster.ai/auth-client` - Authentication client
-- `@amaster.ai/entity-client` - Entity CRUD client
-- `@amaster.ai/bpm-client` - BPM client
-- `@amaster.ai/workflow-client` - Workflow client
-- `@amaster.ai/http-client` - HTTP client foundation
+All these packages are now integrated into `@amaster.ai/client`:
+
+- `@amaster.ai/auth-client` - Authentication (login, register, etc.)
+- `@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/copilot-client` - AI assistant / chatbot
+- `@amaster.ai/function-client` - Function invocation
+- `@amaster.ai/tts-client` - Text-to-speech (WebSocket)
+- `@amaster.ai/http-client` - HTTP client foundation (internal)
 
 ## 💡 Inspiration
 

package/dist/index.cjs

@@ -4,6 +4,10 @@ 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 httpClient = require('@amaster.ai/http-client');
 
 // src/client.ts
@@ -43,11 +47,19 @@ function createClient(options) {
   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 client = {
     auth,
     entity,
     bpm,
     workflow,
+    asr,
+    copilot,
+    function: functionClient$1,
+    tts,
     // 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"],"mappings":";;;;;;;;;AAiFO,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;AAG7E,EAAA,MAAM,MAAA,GAAwB;AAAA,IAC5B,IAAA;AAAA,IACA,MAAA;AAAA,IACA,GAAA;AAAA,IACA,QAAA;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 * const client = createClient({\n *   baseURL: 'https://api.amaster.ai',\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 { 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\n * const client = createClient({\n *   baseURL: 'https://api.amaster.ai'\n * });\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\n  // Return unified client interface\n  const client: AmasterClient = {\n    auth,\n    entity,\n    bpm,\n    workflow,\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","createASRClient","createTTSClient"],"mappings":";;;;;;;;;;;;;AAqFO,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 * const client = createClient({\n *   baseURL: 'https://api.amaster.ai',\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\n * const client = createClient({\n *   baseURL: 'https://api.amaster.ai'\n * });\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"]}

package/dist/index.d.cts

@@ -6,6 +6,14 @@ import { BpmClient } from '@amaster.ai/bpm-client';
 export { CamundaVariable, HistoryProcessInstance, HistoryTask, ProcessInstance, ProcessVariable, Task, TaskFormSchema, TaskQueryParams } from '@amaster.ai/bpm-client';
 import { WorkflowClient } from '@amaster.ai/workflow-client';
 export { WorkflowFile, WorkflowInputValue, WorkflowRunRequest, WorkflowRunResponse } from '@amaster.ai/workflow-client';
+import { ASRClient } from '@amaster.ai/asr-client';
+export { ASRClient, ASRClientConfig } from '@amaster.ai/asr-client';
+import { CopilotA2UIClient } from '@amaster.ai/copilot-client';
+export { ChatMessage, ChatOptions, CopilotA2UIClient, FileContent, ImageContent, MessageContent, TextContent } from '@amaster.ai/copilot-client';
+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';
 export { ClientError, ClientResult } from '@amaster.ai/http-client';
 
 /**
@@ -125,6 +133,61 @@ interface AmasterClient {
      * ```
      */
     workflow: WorkflowClient;
+    /**
+     * ASR (Automatic Speech Recognition) module
+     * WebSocket-based real-time speech recognition
+     *
+     * @example
+     * ```typescript
+     * // Connect and start recording
+     * await client.asr.connect();
+     * await client.asr.startRecording();
+     *
+     * // Stop and close
+     * client.asr.stopRecording();
+     * client.asr.close();
+     * ```
+     */
+    asr: ASRClient;
+    /**
+     * Copilot AI assistant module
+     *
+     * @example
+     * ```typescript
+     * // Send a message
+     * const result = await client.copilot.sendMessage([
+     *   { role: 'user', content: 'Hello' }
+     * ]);
+     * ```
+     */
+    copilot: CopilotA2UIClient;
+    /**
+     * 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
+     *
+     * @example
+     * ```typescript
+     * // Connect and speak
+     * await client.tts.connect();
+     * await client.tts.speak('Hello world');
+     *
+     * // Close connection
+     * client.tts.close();
+     * ```
+     */
+    tts: TTSClient;
     /**
      * Check if the user is currently authenticated
      */