@amaster.ai/client 1.1.0-beta.73 → 1.1.0-beta.75

package/types/entity.d.ts

@@ -241,7 +241,7 @@ export interface EntityClientAPI {
    * // With type safety
    * type User = { id: number; name: string; email: string };
    * const result = await client.entity.list<User>('default', 'users');
-   * if (result.success) {
+   * if (result.data) {
    *   result.data.items.forEach(user => {
    *     console.log(user.name); // Type-safe
    *   });
@@ -266,7 +266,7 @@ export interface EntityClientAPI {
    * 
    * @example
    * const result = await client.entity.get('default', 'users', 123);
-   * if (result.success) {
+   * if (result.data) {
    *   console.log('User:', result.data);
    * }
    * 
@@ -299,7 +299,7 @@ export interface EntityClientAPI {
    *   status: 'active'
    * });
    * 
-   * if (result.success) {
+   * if (result.data) {
    *   console.log('Created user with ID:', result.data.id);
    * }
    * 
@@ -327,7 +327,7 @@ export interface EntityClientAPI {
    *   status: 'inactive'
    * });
    * 
-   * if (result.success) {
+   * if (result.data) {
    *   console.log('Updated:', result.data);
    * }
    * 
@@ -350,7 +350,7 @@ export interface EntityClientAPI {
    * 
    * @example
    * const result = await client.entity.delete('default', 'users', 123);
-   * if (result.success) {
+   * if (!result.error) {
    *   console.log('User deleted');
    * }
    * 
@@ -373,7 +373,7 @@ export interface EntityClientAPI {
    * 
    * @example
    * const result = await client.entity.options('default', 'users', ['id', 'name']);
-   * if (result.success) {
+   * if (result.data) {
    *   result.data.forEach(opt => console.log(opt.name));
    * }
    * 
@@ -419,7 +419,7 @@ export interface EntityClientAPI {
    * 
    * @example
    * const result = await client.entity.bulkDelete('default', 'users', [1, 2, 3]);
-   * if (result.success) {
+   * if (!result.error) {
    *   console.log('3 users deleted');
    * }
    * 

package/types/function.d.ts

@@ -28,7 +28,7 @@ export interface FunctionClientAPI {
    *   body: 'Welcome!'
    * });
    * 
-   * if (result.success) {
+   * if (result.data) {
    *   console.log(result.data.message);
    * }
    * 

package/types/http.d.ts

@@ -22,6 +22,18 @@ type AdapterResponse = {
 };
 type HttpAdapter = (_config: RequestConfig) => Promise<AdapterResponse>;
 type MiniProgramRequest = (_opts: any) => any;
+type MiniProgramRuntime = {
+    Taro?: {
+        request?: (_opts: any) => any;
+        login?: (_opts?: any) => any;
+        getEnv?: () => unknown;
+        ENV_TYPE?: Record<string, unknown>;
+        miniGlobal?: unknown;
+        options?: {
+            miniGlobal?: unknown;
+        };
+    };
+};
 type HttpClientOptions = {
     /**
      * HTTP adapter to use:
@@ -67,6 +79,10 @@ type HttpClientOptions = {
      * Set to false to disable automatic error logging
      */
     logErrors?: boolean;
+    /**
+     * Explicitly provide the Taro runtime object when it is not exposed on `globalThis`.
+     */
+    runtime?: Partial<MiniProgramRuntime>;
 };
 type HttpClient = {
     request<T>(_config: RequestConfig): Promise<ClientResult<T>>;
@@ -95,4 +111,4 @@ declare function getMiniProgramRequest(): MiniProgramRequest | null;
  */
 declare function createHttpClient(axiosInstanceOrOptions?: AxiosInstance | HttpClientOptions): HttpClient;
 
-export { type AdapterResponse, type ClientError, type ClientResult, type HttpAdapter, type HttpClient, type HttpClientOptions, type MiniProgramRequest, type RequestConfig, createHttpClient, getMiniProgramRequest, resolveMiniProgramGlobals };
+export { type AdapterResponse, type ClientError, type ClientResult, type HttpAdapter, type HttpClient, type HttpClientOptions, type MiniProgramRequest, type MiniProgramRuntime, type RequestConfig, createHttpClient, getMiniProgramRequest, resolveMiniProgramGlobals };

package/types/index.d.ts

@@ -9,24 +9,23 @@
  *
  * ## Quick Start
  * ```typescript
- * import { createClient } from '@amaster.ai/client';
- *
- * const client = createClient({
- *   baseURL: 'https://api.amaster.ai',
- *   onUnauthorized: () => window.location.href = '/login'
- * });
+* import { createClient } from '@amaster.ai/client';
+*
+* 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('approval', {});
+ * await client.bpm.startProcess({ processKey: 'approval' });
  * ```
  *
  * ## Module Documentation
  * For detailed API documentation, see individual module type definitions:
- * - **Authentication**: {@link ./auth/index.d.ts} (split into user, password-auth, code-auth, oauth, permissions, profile)
+ * - **Authentication**: {@link ./auth/index.d.ts} (split into user, password-auth, code-auth, oauth, permissions, profile, sessions)
  * - **Entity Operations**: {@link ./entity.d.ts}
  * - **BPM (Business Process)**: {@link ./bpm.d.ts}
  * - **Workflow Execution**: {@link ./workflow.d.ts}
@@ -51,9 +50,9 @@ import type { WorkflowClientAPI } from "./workflow";
 import type { ASRClientConfig, ASRClient, ASRHttpClientConfig, ASRHttpClient } from "./asr";
 import type { CopilotClientAPI } from "./copilot";
 import type { FunctionClientAPI } from "./function";
-import type { TTSClientAPI } from "./tts";
+import type { TTSClientAPI, TTSClientConfig } from "./tts";
 import type { S3ClientAPI } from "./s3";
-import type { HttpClient } from "./http";
+import type { HttpClient, MiniProgramRuntime } from "./http";
 
 /**
  * Configuration options for creating an Amaster client
@@ -66,6 +65,19 @@ export interface AmasterClientOptions {
    */
   baseURL?: string;
 
+  /**
+   * Application identifier used for workflow-scoped headers and workflow input auto-fill.
+   *
+   */
+  appId?: string;
+
+  /**
+   * Runtime environment identifier used for workflow headers and workflow input auto-fill.
+   *
+   * @default "dev"
+   */
+  env?: string;
+
   /**
    * Optional custom headers to include in ALL requests
    *
@@ -123,6 +135,20 @@ export interface AmasterClientOptions {
    * @default true
    */
   autoHandleOAuthCallback?: boolean;
+
+  /**
+   * Automatically redirect to the current page's `?redirect=...` target after successful login
+   *
+   * Applies to password login, code login, Mini Program login, and OAuth callback handling.
+   *
+   * @default true
+   */
+  autoRedirectAfterLogin?: boolean;
+
+  /**
+   * Explicitly provide the Taro runtime object when it is not exposed on `globalThis`.
+   */
+  runtime?: Partial<MiniProgramRuntime>;
 }
 
 /**
@@ -229,7 +255,7 @@ export interface AmasterClient {
    *
    * For detailed documentation, see {@link ./tts.d.ts}
    */
-  tts: TTSClientAPI;
+  tts: (config: TTSClientConfig) => TTSClientAPI;
 
   /**
    * S3 Storage module
@@ -313,22 +339,59 @@ export interface AmasterClient {
  * @returns A configured Amaster client instance
  *
  */
-export declare function createClient(options: AmasterClientOptions): AmasterClient;
+export declare function createClient(options?: AmasterClientOptions): AmasterClient;
+
+export { createAutoVoiceReplyController } from "./copilot";
+export {
+  createTTSSpeakController,
+  preprocessTTSContent,
+  splitTextIntoFragments,
+} from "./tts";
 
 // Re-export shared common types
-export type { ClientResult } from "./common";
+export type { ClientError, ClientResult } from "./common";
 
 // Re-export main client interfaces
-export type { AuthClientAPI } from "./auth";
-export type { EntityClientAPI } from "./entity";
-export type { BpmClientAPI } from "./bpm";
-export type { WorkflowClientAPI } from "./workflow";
+export type { AuthClientAPI, AuthClientAPI as AuthClient } from "./auth";
+export type {
+  AuthEvent,
+  EventHandler,
+  LoginParams,
+  LoginResponse,
+  RegisterParams,
+  RegisterResponse,
+  RefreshTokenResponse,
+  SuccessResponse,
+  CodeLoginParams,
+  CodeLoginType,
+  SendCodeParams,
+  SendCodeType,
+  CaptchaResponse,
+  OAuthProvider,
+  OAuthBinding,
+  MiniProgramLoginParams,
+  MiniProgramPhoneParams,
+  MiniProgramPhoneResponse,
+  UpdateMeParams,
+  UpdateProfileParams,
+  PermissionCheck,
+  Session,
+  RevokeAllSessionsResponse,
+  User,
+  Role,
+  Permission,
+  RoleDetail,
+  PermissionDetail,
+} from "./auth";
+export type { EntityClientAPI, EntityQueryParams, EntityListResponse, FilterOperator, FilterItem, FilterGroup } from "./entity";
+export type { BpmClientAPI, ProcessInstance, Task, TaskQueryParams, ProcessVariable, HistoryTask, HistoryProcessInstance, HistoryActivityInstance, ActivityInstanceTree, UserOperationLog, CamundaVariable, TaskFormSchema } from "./bpm";
+export type { WorkflowClientAPI, WorkflowRunRequest, WorkflowRunResponse, WorkflowInputValue, WorkflowFile } from "./workflow";
 export type { ASRClient, ASRClientConfig, ASRHttpClient, ASRHttpClientConfig, Recorder, RecorderOptions } from "./asr";
-export type { CopilotClientAPI } from "./copilot";
-export type { FunctionClientAPI } from "./function";
-export type { TTSClientAPI } from "./tts";
-export type { S3ClientAPI } from "./s3";
-export type { HttpClient } from "./http";
+export type { CopilotClientAPI, CopilotClientAPI as CopilotClient, MessageContent, TextContent, ImageContent, FileContent, ConversationController, ConversationControllerOptions, ConversationControllerSnapshot, AutoVoiceReplyController, AutoVoiceReplyConversation, AutoVoiceReplyMessage, AutoVoiceReplySnapshot, AutoVoiceReplySource, AutoVoiceReplySourceSnapshot, AutoVoiceReplySpeechDriver, AutoVoiceReplySpeechSnapshot, AutoVoiceReplyStorage, CreateAutoVoiceReplyControllerOptions, ConversationRequestState, ConversationRuntimeError, Conversation, MessagesItem, TextMessage, ErrorMessage, ThoughtMessage, ToolMessage, UIRenderMessage, Role as CopilotRole } from "./copilot";
+export type { FunctionClientAPI, FunctionClientAPI as FunctionClient } from "./function";
+export type { TTSClientAPI, TTSClientAPI as TTSClient, TTSClientConfig, TTSAudioFormat, TTSSnapshot, TTSSpeakController, TTSSpeakControllerOptions, TTSSpeakOptions, TTSStreamOptions, TTSRuntime, TTSStorageAdapter } from "./tts";
+export type { S3ClientAPI, UploadRes, S3Metadata, S3ClientAPI as S3Client } from "./s3";
+export type { HttpClient, MiniProgramRuntime, RequestConfig } from "./http";
 
 // For detailed types, import directly from submodules:
 // import type { LoginParams, User } from '@amaster.ai/client/auth'

package/types/s3.d.ts

@@ -47,7 +47,7 @@ export interface S3ClientAPI {
    * 
    * @example
    * const result = await client.s3.download('documents/report.pdf');
-   * if (result.success) {
+   * if (result.data) {
    *   const blob = result.data;
    *   const url = URL.createObjectURL(blob);
    *   window.open(url);
@@ -65,7 +65,7 @@ export interface S3ClientAPI {
    * 
    * @example
    * const result = await client.s3.getMetadata('images/photo.jpg');
-   * if (result.success) {
+   * if (result.data) {
    *   console.log('Size:', result.data.contentLength);
    *   console.log('Type:', result.data.contentType);
    * }
@@ -85,7 +85,7 @@ export interface S3ClientAPI {
    * const file = fileInput.files[0];
    * 
    * const result = await client.s3.upload(file);
-   * if (result.success) {
+   * if (result.data) {
    *   console.log('File uploaded:', result.data.url);
    *   console.log('File key:', result.data.key);
    * }

package/types/tts.d.ts

@@ -4,11 +4,57 @@
  * @module tts
  */
 
+export type TTSAudioFormat = "pcm" | "mp3" | "wav" | "opus";
+
+export interface TTSStorageAdapter {
+  getItem(key: string): string | null | undefined;
+  setItem(key: string, value: string): void;
+  removeItem?(key: string): void;
+}
+
+export interface TTSRuntime {
+  Taro?: {
+    createInnerAudioContext?: () => {
+      src: string;
+      autoplay?: boolean;
+      obeyMuteSwitch?: boolean;
+      play?: () => void;
+      stop?: () => void;
+      destroy?: () => void;
+      onPlay?: (callback: () => void) => void;
+      onEnded?: (callback: () => void) => void;
+      onStop?: (callback: () => void) => void;
+      onError?: (callback: (error: { errMsg?: string }) => void) => void;
+    };
+    getFileSystemManager?: () => {
+      writeFile?: (options: {
+        filePath: string;
+        data: ArrayBuffer;
+        encoding?: string;
+        success?: () => void;
+        fail?: (error: unknown) => void;
+      }) => void;
+      unlink?: (options: {
+        filePath: string;
+        success?: () => void;
+        fail?: () => void;
+      }) => void;
+    };
+    env?: {
+      USER_DATA_PATH?: string;
+    };
+    getEnv?: () => unknown;
+    ENV_TYPE?: Record<string, unknown>;
+  };
+}
+
 /**
  * TTS Client Configuration
  *
  */
 export interface TTSClientConfig {
+  /** Get access token for WebSocket authentication */
+  getAccessToken?: () => string | null;
   
   /** Voice name, default 'Cherry' */
   voice?: string;
@@ -17,10 +63,13 @@ export interface TTSClientConfig {
   autoPlay?: boolean;
   
   /** Audio format, default 'pcm' */
-  audioFormat?: "pcm" | "mp3" | "wav" | "opus";
+  audioFormat?: TTSAudioFormat;
   
   /** Sample rate, default 24000 */
   sampleRate?: number;
+
+  /** Optional runtime bridges for mini-program environments */
+  runtime?: TTSRuntime;
   
   /** Called when connection is ready */
   onReady?: () => void;
@@ -39,6 +88,9 @@ export interface TTSClientConfig {
   
   /** Called on error */
   onError?: (error: Error) => void;
+
+  /** Called when socket is closed */
+  onClose?: () => void;
 }
 
 /**
@@ -70,6 +122,21 @@ export interface TTSClientAPI {
    */
   speak(text: string): Promise<void>;
 
+  /**
+   * Start a streaming TTS request.
+   */
+  startStream(): void;
+
+  /**
+   * Append text to the current streaming request.
+   */
+  appendText(text: string): void;
+
+  /**
+   * Commit the current buffered text to the TTS service.
+   */
+  commitText(): void;
+
   /**
    * Play audio from chunks
    * 
@@ -91,4 +158,86 @@ export interface TTSClientAPI {
    *
    */
   close(): void;
+
+  /**
+   * Whether the client currently has an open WebSocket connection.
+   */
+  isConnected(): boolean;
+
+  /**
+   * Whether any audio has been received for the current request.
+   */
+  hasAudio(): boolean;
+
+  /**
+   * Whether the current response has finished streaming.
+   */
+  isResponseDone(): boolean;
+
+  /**
+   * Whether audio is currently playing.
+   */
+  isPlaying(): boolean;
+
+  /**
+   * Whether the current runtime supports streaming playback.
+   */
+  isStreamingPlayback(): boolean;
+}
+
+export interface TTSSpeakOptions {
+  id?: string;
+  text: string;
+  voice?: string;
+  audioFormat?: TTSAudioFormat;
+  sampleRate?: number;
+}
+
+export interface TTSStreamOptions {
+  id?: string;
+  voice?: string;
+  audioFormat?: TTSAudioFormat;
+  sampleRate?: number;
+}
+
+export interface TTSSnapshot {
+  status: "idle" | "connecting" | "speaking" | "error";
+  activeId: string | null;
+  error: string | null;
+  requestId: number;
+  text: string | null;
+  voice: string | null;
+  fallbackMode: "none" | "system";
+}
+
+export interface TTSSpeakController {
+  getSnapshot(): TTSSnapshot;
+  subscribe(listener: (snapshot: TTSSnapshot) => void): () => void;
+  speak(options: TTSSpeakOptions): Promise<void>;
+  startStream(options: TTSStreamOptions): Promise<void>;
+  appendStreamText(options: TTSSpeakOptions): Promise<void>;
+  commitStream(): void;
+  finishStream(): void;
+  stop(options?: { preserveClient?: boolean }): void;
+  release(): void;
+  toggle(options: TTSSpeakOptions): Promise<void>;
+  isActive(id?: string | null): boolean;
+  setVoice(voice: string | null): void;
+  getVoice(): string | null;
+}
+
+export interface TTSSpeakControllerOptions {
+  storage?: TTSStorageAdapter;
+  voiceStorageKey?: string;
+  runtime?: TTSRuntime;
+  fallbackToSystemSpeech?: boolean;
 }
+
+export declare function splitTextIntoFragments(text: string, maxLength?: number): string[];
+
+export declare function preprocessTTSContent(text: string): string;
+
+export declare function createTTSSpeakController(
+  createClient: (config: TTSClientConfig) => TTSClientAPI,
+  options?: TTSSpeakControllerOptions
+): TTSSpeakController;

package/types/workflow.d.ts

@@ -108,7 +108,9 @@ export interface WorkflowClientAPI {
    * Execute a workflow
    * 
    * Runs a workflow with the provided inputs and returns the result.
-   * Automatically injects `app_id` from URL if in browser environment.
+   * When the parent client is created with `appId` / `env`, workflow requests
+   * automatically include `x-tenant-id` / `x-env` headers and backfill
+   * `inputs.app_id` / `inputs.env` if those keys are absent.
    * 
    * @template TOutput - The type of workflow outputs
    * @param workflowName - Workflow identifier (key/name)
@@ -122,7 +124,7 @@ export interface WorkflowClientAPI {
    *   limit: 100
    * });
    * 
-   * if (result.success) {
+   * if (result.data) {
    *   console.log('Output:', result.data.outputs);
    * }
    *