@amaster.ai/client 1.1.10 → 1.1.12

package/README.md

@@ -92,8 +92,8 @@ await client.auth.login({
 
 // 3. Use any service - auth token is automatically attached!
 const users = await client.entity.list("default", "users");
-const tasks = await client.bpm.getMyTasks();
-const result = await client.workflow.execute("my-workflow", { input: {} });
+const tasks = await client.bpm.getTasks();
+const result = await client.workflow.run("my-workflow", { data: "value" });
 ```
 
 ## 🔑 Authentication
@@ -168,6 +168,8 @@ if (result.success) {
 }
 ```
 
+`client.entity.list(...)` also accepts `limit` / `offset`, `__orders`, `__keywords`, `__relations`, `__fields`, and `__filter` from `EntityQueryParams`.
+
 ### Get Single Entity
 
 ```typescript
@@ -222,28 +224,24 @@ Manage business processes powered by Camunda 7.
 ### Start a Process
 
 ```typescript
-const result = await client.bpm.startProcess({
-  processKey: "approval-process",
-  businessKey: "ORDER-12345",
-  variables: {
-    amount: 1000,
-    requester: "john@example.com",
-  },
+const result = await client.bpm.startProcess("approval-process", {
+  amount: 1000,
+  requester: "john@example.com",
 });
 ```
 
-### Get My Tasks
+### Get Tasks
 
 ```typescript
-const result = await client.bpm.getMyTasks({
-  page: 1,
-  perPage: 20,
+const result = await client.bpm.getTasks({
+  assignee: "user-123",
+  maxResults: 20,
   sortBy: "created",
   sortOrder: "desc",
 });
 
-if (result.success) {
-  console.log("Tasks:", result.data.items);
+if (result.data) {
+  console.log("Tasks:", result.data);
 }
 ```
 
@@ -256,10 +254,10 @@ await client.bpm.completeTask("task-id", {
 });
 ```
 
-### Claim a Task
+### Delegate a Task
 
 ```typescript
-await client.bpm.claimTask("task-id");
+await client.bpm.delegateTask("task-id", "manager-123");
 ```
 
 ## ⚡ Workflow Execution
@@ -267,15 +265,13 @@ await client.bpm.claimTask("task-id");
 Execute workflows and automation flows.
 
 ```typescript
-const result = await client.workflow.execute("data-processing-workflow", {
-  input: {
-    dataSource: "users",
-    filters: { status: "active" },
-  },
+const result = await client.workflow.run("data-processing-workflow", {
+  dataSource: "users",
+  filters: { status: "active" },
 });
 
-if (result.success) {
-  console.log("Workflow result:", result.data);
+if (result.data) {
+  console.log("Workflow result:", result.data.outputs);
 }
 ```
 
@@ -570,7 +566,7 @@ if (result.data) {
 
 ## ☁️ S3 Storage
 
-文件上传下载。
+File upload, download, and metadata lookup.
 
 ```typescript
 // Upload file
@@ -578,6 +574,9 @@ await client.s3.upload(file);
 
 // Download file
 await client.s3.download("path/to/file");
+
+// Get object metadata
+await client.s3.getMetadata("path/to/file");
 ```
 
 ## ⚙️ Configuration
@@ -702,7 +701,7 @@ const client = createClient();
 // One client, automatic token management
 await client.auth.login({ email, password });
 await client.entity.list("default", "users"); // Token automatically attached
-await client.bpm.getMyTasks(); // Token automatically attached
+await client.bpm.getTasks(); // Token automatically attached
 ```
 
 ## 📖 API Reference
@@ -728,7 +727,7 @@ Full authentication API from `@amaster.ai/auth-client`:
 
 Full CRUD API from `@amaster.ai/entity-client`:
 
-- `list(source, entity, params?)` - List entities with pagination
+- `list(source, entity, params?)` - List entities with pagination, filtering, sorting, and query params
 - `get(source, entity, id)` - Get single entity
 - `create(source, entity, data)` - Create new entity
 - `update(source, entity, id, data)` - Update entity
@@ -741,20 +740,29 @@ Full CRUD API from `@amaster.ai/entity-client`:
 
 Full BPM API from `@amaster.ai/bpm-client`:
 
-- `startProcess(params)` - Start process instance
-- `getMyTasks(params?)` - Get current user's tasks
-- `completeTask(taskId, variables?)` - Complete a task
-- `claimTask(taskId)` - Claim a task
-- `unclaimTask(taskId)` - Unclaim a task
+- `startProcess(processKey, inputs?)` - Start process instance
+- `getTasks(params?)` - Query tasks
+- `getTaskCount(params?)` - Get task count
+- `completeTask(taskId, variables)` - Complete a task
+- `delegateTask(taskId, userId)` - Delegate a task
+- `getProcessDefinitions(params?)` - Query process definitions
+- `getHistoryTasks(params?)` - Query historical tasks
+- `getRoles()` / `getUserRoles(userId)` - Query runtime roles
 - And more...
 
 ### `client.workflow`
 
 Workflow execution API from `@amaster.ai/workflow-client`:
 
-- `execute(workflowId, params)` - Execute a workflow
-- `getStatus(executionId)` - Get execution status
-- And more...
+- `run(workflowName, inputs?)` - Run a workflow
+
+### `client.s3`
+
+S3 storage API:
+
+- `upload(file)` - Upload file
+- `download(path)` - Download file as a blob
+- `getMetadata(key)` - Read object metadata
 
 ### `client.asr`
 

package/dist/index.cjs

@@ -15,6 +15,7 @@ var httpClient = require('@amaster.ai/http-client');
 function createClient(options = {}) {
   const {
     baseURL,
+    env = "dev",
     headers = {},
     onUnauthorized,
     onTokenExpired,
@@ -123,7 +124,9 @@ function createClient(options = {}) {
   }
   const entity = entityClient.createEntityClient(authenticatedHttpClient);
   const bpm = bpmClient.createBpmClient(authenticatedHttpClient);
-  const workflow = workflowClient.createWorkflowClient(authenticatedHttpClient);
+  const workflow = workflowClient.createWorkflowClient(authenticatedHttpClient, {
+    env
+  });
   const functionClient$1 = functionClient.createFunctionClient(authenticatedHttpClient);
   const copilot = copilotClient.createCopilotClient(
     authenticatedHttpClient,

package/dist/index.cjs.map

@@ -1 +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 * 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\n * const client = createClient();\n *\n * // With authentication callbacks\n * const client = createClient({\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    autoRedirectAfterLogin,\n    runtime,\n  } = options;\n\n  // Create the base HTTP client\n  const baseHttpClient = createHttpClient({\n    baseURL,\n    headers,\n    runtime,\n  });\n\n  // Create the auth client first using the same base HTTP implementation so\n  // mini-program request handling stays consistent across all modules.\n  const auth: AuthClient = createAuthClient({\n    baseURL,\n    headers,\n    onTokenExpired,\n    onUnauthorized,\n    autoHandleOAuthCallback,\n    autoRedirectAfterLogin,\n    runtime,\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"]}
+{"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 * 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('approval', { amount: 1000 });\n * await client.bpm.getTasks({ assignee: 'currentUserId' });\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\n * const client = createClient();\n *\n * // With authentication callbacks\n * const client = createClient({\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.getTasks({ assignee: 'currentUserId' });\n * ```\n */\nexport function createClient(options: AmasterClientOptions = {}): AmasterClient {\n  const {\n    baseURL,\n    env = \"dev\",\n    headers = {},\n    onUnauthorized,\n    onTokenExpired,\n    autoHandleOAuthCallback,\n    autoRedirectAfterLogin,\n    runtime,\n  } = options;\n\n  // Create the base HTTP client\n  const baseHttpClient = createHttpClient({\n    baseURL,\n    headers,\n    runtime,\n  });\n\n  // Create the auth client first using the same base HTTP implementation so\n  // mini-program request handling stays consistent across all modules.\n  const auth: AuthClient = createAuthClient({\n    baseURL,\n    headers,\n    onTokenExpired,\n    onUnauthorized,\n    autoHandleOAuthCallback,\n    autoRedirectAfterLogin,\n    runtime,\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    env,\n  });\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"]}

package/dist/index.d.cts

@@ -33,6 +33,14 @@ interface AmasterClientOptions {
      * @example 'https://api.amaster.ai'
      */
     baseURL?: string;
+    /**
+     * Runtime environment identifier.
+     * Used for request headers such as `x-env` and injected into workflow inputs
+     * when `workflow.run(...)` needs environment-aware downstream calls.
+     *
+     * @default "dev"
+     */
+    env?: string;
     /**
      * Optional custom headers to include in all requests
      */
@@ -141,13 +149,12 @@ interface AmasterClient {
      * @example
      * ```typescript
      * // Start a process
-     * await client.bpm.startProcess({
-     *   processKey: 'approval-process',
-     *   variables: { amount: 1000 }
+     * await client.bpm.startProcess('approval-process', {
+     *   amount: 1000
      * });
      *
-     * // Get my tasks
-     * const tasks = await client.bpm.getMyTasks();
+     * // Get tasks
+     * const tasks = await client.bpm.getTasks({ assignee: 'currentUserId' });
      *
      * // Complete a task
      * await client.bpm.completeTask(taskId, { approved: true });
@@ -159,9 +166,9 @@ interface AmasterClient {
      *
      * @example
      * ```typescript
-     * // Execute a workflow
-     * const result = await client.workflow.execute('my-workflow', {
-     *   input: { data: 'value' }
+     * // Run a workflow
+     * const result = await client.workflow.run('my-workflow', {
+     *   data: 'value'
      * });
      * ```
      */
@@ -296,8 +303,11 @@ interface AmasterClient {
      * // Upload file
      * await client.s3.upload(file);
      *
-     * // Download file
-     * await client.s3.download('path/to/file');
+    * // Download file
+    * await client.s3.download('path/to/file');
+     *
+     * // Read metadata
+     * await client.s3.getMetadata('path/to/file');
      * ```
      */
     s3: S3Client;
@@ -376,7 +386,8 @@ interface AmasterClient {
  *
  * // All subsequent requests automatically include auth token
  * await client.entity.list('default', 'users');
- * await client.bpm.startProcess({ processKey: 'approval' });
+ * await client.bpm.startProcess('approval', { amount: 1000 });
+ * await client.bpm.getTasks({ assignee: 'currentUserId' });
  * ```
  */
 
@@ -419,7 +430,7 @@ interface AmasterClient {
  *
  * // Now all requests automatically include the auth token
  * const users = await client.entity.list('default', 'users');
- * const tasks = await client.bpm.getMyTasks();
+ * const tasks = await client.bpm.getTasks({ assignee: 'currentUserId' });
  * ```
  */
 declare function createClient(options?: AmasterClientOptions): AmasterClient;

package/dist/index.d.ts

@@ -33,6 +33,14 @@ interface AmasterClientOptions {
      * @example 'https://api.amaster.ai'
      */
     baseURL?: string;
+    /**
+     * Runtime environment identifier.
+     * Used for request headers such as `x-env` and injected into workflow inputs
+     * when `workflow.run(...)` needs environment-aware downstream calls.
+     *
+     * @default "dev"
+     */
+    env?: string;
     /**
      * Optional custom headers to include in all requests
      */
@@ -141,13 +149,12 @@ interface AmasterClient {
      * @example
      * ```typescript
      * // Start a process
-     * await client.bpm.startProcess({
-     *   processKey: 'approval-process',
-     *   variables: { amount: 1000 }
+     * await client.bpm.startProcess('approval-process', {
+     *   amount: 1000
      * });
      *
-     * // Get my tasks
-     * const tasks = await client.bpm.getMyTasks();
+     * // Get tasks
+     * const tasks = await client.bpm.getTasks({ assignee: 'currentUserId' });
      *
      * // Complete a task
      * await client.bpm.completeTask(taskId, { approved: true });
@@ -159,9 +166,9 @@ interface AmasterClient {
      *
      * @example
      * ```typescript
-     * // Execute a workflow
-     * const result = await client.workflow.execute('my-workflow', {
-     *   input: { data: 'value' }
+     * // Run a workflow
+     * const result = await client.workflow.run('my-workflow', {
+     *   data: 'value'
      * });
      * ```
      */
@@ -296,8 +303,11 @@ interface AmasterClient {
      * // Upload file
      * await client.s3.upload(file);
      *
-     * // Download file
-     * await client.s3.download('path/to/file');
+    * // Download file
+    * await client.s3.download('path/to/file');
+     *
+     * // Read metadata
+     * await client.s3.getMetadata('path/to/file');
      * ```
      */
     s3: S3Client;
@@ -376,7 +386,8 @@ interface AmasterClient {
  *
  * // All subsequent requests automatically include auth token
  * await client.entity.list('default', 'users');
- * await client.bpm.startProcess({ processKey: 'approval' });
+ * await client.bpm.startProcess('approval', { amount: 1000 });
+ * await client.bpm.getTasks({ assignee: 'currentUserId' });
  * ```
  */
 
@@ -419,7 +430,7 @@ interface AmasterClient {
  *
  * // Now all requests automatically include the auth token
  * const users = await client.entity.list('default', 'users');
- * const tasks = await client.bpm.getMyTasks();
+ * const tasks = await client.bpm.getTasks({ assignee: 'currentUserId' });
  * ```
  */
 declare function createClient(options?: AmasterClientOptions): AmasterClient;

package/dist/index.js

@@ -15,6 +15,7 @@ import { createHttpClient } from '@amaster.ai/http-client';
 function createClient(options = {}) {
   const {
     baseURL,
+    env = "dev",
     headers = {},
     onUnauthorized,
     onTokenExpired,
@@ -123,7 +124,9 @@ function createClient(options = {}) {
   }
   const entity = createEntityClient(authenticatedHttpClient);
   const bpm = createBpmClient(authenticatedHttpClient);
-  const workflow = createWorkflowClient(authenticatedHttpClient);
+  const workflow = createWorkflowClient(authenticatedHttpClient, {
+    env
+  });
   const functionClient = createFunctionClient(authenticatedHttpClient);
   const copilot = createCopilotClient(
     authenticatedHttpClient,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AA8FO,SAAS,YAAA,CAAa,OAAA,GAAgC,EAAC,EAAkB;AAC9E,EAAA,MAAM;AAAA,IACJ,OAAA;AAAA,IACA,UAAU,EAAC;AAAA,IACX,cAAA;AAAA,IACA,cAAA;AAAA,IACA,uBAAA;AAAA,IACA,sBAAA;AAAA,IACA;AAAA,GACF,GAAI,OAAA;AAGJ,EAAA,MAAM,iBAAiB,gBAAA,CAAiB;AAAA,IACtC,OAAA;AAAA,IACA,OAAA;AAAA,IACA;AAAA,GACD,CAAA;AAID,EAAA,MAAM,OAAmB,gBAAA,CAAiB;AAAA,IACxC,OAAA;AAAA,IACA,OAAA;AAAA,IACA,cAAA;AAAA,IACA,cAAA;AAAA,IACA,uBAAA;AAAA,IACA,sBAAA;AAAA,IACA;AAAA,GACD,CAAA;AAGD,EAAA,MAAM,gCAAgC,MAAkB;AAEtD,IAAA,IAAI,YAAA,GAAe,KAAA;AACnB,IAAA,IAAI,cAAA,GAA0C,IAAA;AAM9C,IAAA,SAAS,eAAe,MAAA,EAAwC;AAC9D,MAAA,IAAI,MAAA,CAAO,MAAA,KAAW,GAAA,EAAK,OAAO,KAAA;AAGlC,MAAA,IAAI,MAAA,CAAO,OAAO,OAAA,IAAW,UAAA,CAAW,KAAK,MAAA,CAAO,KAAA,CAAM,OAAO,CAAA,EAAG;AAClE,QAAA,OAAO,IAAA;AAAA,MACT;AAGA,MAAA,IAAI,MAAA,CAAO,OAAO,OAAA,EAAS;AACzB,QAAA,MAAM,OAAA,GAAU,OAAO,KAAA,CAAM,OAAA;AAC7B,QAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,UAAA,CAAW,IAAA,CAAK,OAAO,CAAA,EAAG;AAC3D,UAAA,OAAO,IAAA;AAAA,QACT;AAEA,QAAA,IAAI,OAAO,OAAA,KAAY,QAAA,IAAY,OAAA,KAAY,IAAA,EAAM;AACnD,UAAA,MAAM,UAAA,GAAa,OAAA;AACnB,UAAA,IAAI,OAAO,WAAW,OAAA,KAAY,QAAA,IAAY,WAAW,IAAA,CAAK,UAAA,CAAW,OAAO,CAAA,EAAG;AACjF,YAAA,OAAO,IAAA;AAAA,UACT;AAAA,QACF;AAAA,MACF;AAGA,MAAA,IAAI,OAAO,OAAO,IAAA,KAAS,QAAA,IAAY,WAAW,IAAA,CAAK,MAAA,CAAO,IAAI,CAAA,EAAG;AACnE,QAAA,OAAO,IAAA;AAAA,MACT;AAGA,MAAA,OAAO,CAAC,CAAC,IAAA,CAAK,cAAA,EAAe;AAAA,IAC/B;AAEA,IAAA,OAAO;AAAA,MACL,MAAM,QAAW,MAAA,EAAiD;AAEhE,QAAA,MAAM,KAAA,GAAQ,KAAK,cAAA,EAAe;AAGlC,QAAA,MAAM,WAAA,GAAc,QAAQ,EAAE,aAAA,EAAe,UAAU,KAAK,CAAA,CAAA,KAAO,EAAC;AACpE,QAAA,MAAM,YAAA,GAA8B;AAAA,UAClC,GAAG,MAAA;AAAA,UACH,OAAA,EAAS;AAAA,YACP,GAAG,MAAA,CAAO,OAAA;AAAA,YACV,GAAG;AAAA;AACL,SACF;AAGA,QAAA,IAAI,MAAA,GAAS,MAAM,cAAA,CAAe,OAAA,CAAW,YAAY,CAAA;AAGzD,QAAA,IAAI,MAAA,CAAO,MAAA,KAAW,GAAA,IAAO,cAAA,CAAe,MAAM,CAAA,EAAG;AAEnD,UAAA,IAAI,CAAC,YAAA,EAAc;AACjB,YAAA,YAAA,GAAe,IAAA;AACf,YAAA,cAAA,GAAA,CAAkB,YAAY;AAC5B,cAAA,IAAI;AACF,gBAAA,MAAM,aAAA,GAAgB,MAAM,IAAA,CAAK,YAAA,EAAa;AAC9C,gBAAA,OAAO,CAAC,CAAC,aAAA,CAAc,IAAA;AAAA,cACzB,CAAA,SAAE;AACA,gBAAA,YAAA,GAAe,KAAA;AACf,gBAAA,cAAA,GAAiB,IAAA;AAAA,cACnB;AAAA,YACF,CAAA,GAAG;AAAA,UACL;AAEA,UAAA,MAAM,YAAY,MAAM,cAAA;AAExB,UAAA,IAAI,SAAA,EAAW;AAEb,YAAA,MAAM,QAAA,GAAW,KAAK,cAAA,EAAe;AACrC,YAAA,MAAA,GAAS,MAAM,eAAe,OAAA,CAAW;AAAA,cACvC,GAAG,MAAA;AAAA,cACH,OAAA,EAAS;AAAA,gBACP,GAAG,MAAA,CAAO,OAAA;AAAA,gBACV,GAAI,WAAW,EAAE,aAAA,EAAe,UAAU,QAAQ,CAAA,CAAA,KAAO;AAAC;AAC5D,aACD,CAAA;AAAA,UACH;AAAA,QACF;AAGA,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;AAEA,EAAA,MAAM,0BAA0B,6BAAA,EAA8B;AAE9D,EAAA,IAAI,aAAA,GAA+B,IAAA;AAEnC,EAAA,IAAA,CAAK,EAAA,CAAG,OAAA,EAAS,CAAC,IAAA,KAA2B;AAC3C,IAAA,aAAA,GAAgB,MAAM,GAAA,IAAO,IAAA;AAAA,EAC/B,CAAC,CAAA;AACD,EAAA,IAAA,CAAK,EAAA,CAAG,UAAU,MAAM;AACtB,IAAA,aAAA,GAAgB,IAAA;AAAA,EAClB,CAAC,CAAA;AAED,EAAA,IAAI,IAAA,CAAK,iBAAgB,EAAG;AAC1B,IAAA,IAAA,CACG,KAAA,EAAM,CACN,IAAA,CAAK,CAAC,MAAA,KAAW;AAChB,MAAA,IAAI,MAAA,CAAO,MAAM,GAAA,EAAK;AACpB,QAAA,aAAA,GAAgB,OAAO,IAAA,CAAK,GAAA;AAAA,MAC9B;AAAA,IACF,CAAC,CAAA,CACA,KAAA,CAAM,MAAM;AAAA,IAAC,CAAC,CAAA;AAAA,EACnB;AAGA,EAAA,MAAM,MAAA,GAAuB,mBAAmB,uBAAuB,CAAA;AACvE,EAAA,MAAM,GAAA,GAAiB,gBAAgB,uBAAuB,CAAA;AAC9D,EAAA,MAAM,QAAA,GAA2B,qBAAqB,uBAAuB,CAAA;AAC7E,EAAA,MAAM,cAAA,GAAiC,qBAAqB,uBAAuB,CAAA;AACnF,EAAA,MAAM,OAAA,GAAyB,mBAAA;AAAA,IAC7B,uBAAA;AAAA,IACA,OAAA;AAAA,IACA,MAAM,KAAK,cAAA,EAAe;AAAA,IAC1B,MAAM;AAAA,GACR;AACA,EAAA,MAAM,EAAA,GAAe,eAAe,uBAAuB,CAAA;AAI3D,EAAA,MAAM,MAA8C,eAAA,CAAgB;AAAA,IAClE,cAAA,EAAgB,MAAM,IAAA,CAAK,cAAA;AAAe,GAC3C,CAAA;AACD,EAAA,MAAM,UAA0D,mBAAA,CAAoB;AAAA,IAClF,cAAA,EAAgB,MAAM,IAAA,CAAK,cAAA,EAAe;AAAA,IAC1C,IAAA,EAAM;AAAA,GACP,CAAA;AACD,EAAA,MAAM,MAA8C,eAAA,CAAgB;AAAA,IAClE,cAAA,EAAgB,MAAM,IAAA,CAAK,cAAA;AAAe,GAC3C,CAAA;AAGD,EAAA,MAAM,MAAA,GAAwB;AAAA,IAC5B,IAAA;AAAA,IACA,MAAA;AAAA,IACA,GAAA;AAAA,IACA,QAAA;AAAA,IACA,GAAA;AAAA,IACA,OAAA;AAAA,IACA,OAAA;AAAA,IACA,QAAA,EAAU,cAAA;AAAA,IACV,GAAA;AAAA,IACA,EAAA;AAAA,IACA,IAAA,EAAM,uBAAA;AAAA;AAAA,IAGN,eAAA,EAAiB,MAAM,IAAA,CAAK,eAAA,EAAgB;AAAA,IAC5C,cAAA,EAAgB,MAAM,IAAA,CAAK,cAAA,EAAe;AAAA,IAC1C,cAAA,EAAgB,CAAC,KAAA,KAAkB,IAAA,CAAK,eAAe,KAAK,CAAA;AAAA,IAC5D,SAAA,EAAW,MAAM,IAAA,CAAK,SAAA;AAAU,GAClC;AAEA,EAAA,OAAO,MAAA;AACT","file":"index.js","sourcesContent":["/**\n * ============================================================================\n * @amaster.ai/client - Unified Amaster Client\n * ============================================================================\n *\n * Supabase-inspired unified API client for the Amaster platform\n *\n * Features:\n * - Single client instance for all services (auth, entity, bpm, workflow)\n * - Automatic token management and refresh\n * - Auto-attach authentication to all requests\n * - Centralized error handling\n *\n * @example\n * ```typescript\n * 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\n * const client = createClient();\n *\n * // With authentication callbacks\n * const client = createClient({\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    autoRedirectAfterLogin,\n    runtime,\n  } = options;\n\n  // Create the base HTTP client\n  const baseHttpClient = createHttpClient({\n    baseURL,\n    headers,\n    runtime,\n  });\n\n  // Create the auth client first using the same base HTTP implementation so\n  // mini-program request handling stays consistent across all modules.\n  const auth: AuthClient = createAuthClient({\n    baseURL,\n    headers,\n    onTokenExpired,\n    onUnauthorized,\n    autoHandleOAuthCallback,\n    autoRedirectAfterLogin,\n    runtime,\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"]}
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * ============================================================================\n * @amaster.ai/client - Unified Amaster Client\n * ============================================================================\n *\n * Supabase-inspired unified API client for the Amaster platform\n *\n * Features:\n * - Single client instance for all services (auth, entity, bpm, workflow)\n * - Automatic token management and refresh\n * - Auto-attach authentication to all requests\n * - Centralized error handling\n *\n * @example\n * ```typescript\n * 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('approval', { amount: 1000 });\n * await client.bpm.getTasks({ assignee: 'currentUserId' });\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\n * const client = createClient();\n *\n * // With authentication callbacks\n * const client = createClient({\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.getTasks({ assignee: 'currentUserId' });\n * ```\n */\nexport function createClient(options: AmasterClientOptions = {}): AmasterClient {\n  const {\n    baseURL,\n    env = \"dev\",\n    headers = {},\n    onUnauthorized,\n    onTokenExpired,\n    autoHandleOAuthCallback,\n    autoRedirectAfterLogin,\n    runtime,\n  } = options;\n\n  // Create the base HTTP client\n  const baseHttpClient = createHttpClient({\n    baseURL,\n    headers,\n    runtime,\n  });\n\n  // Create the auth client first using the same base HTTP implementation so\n  // mini-program request handling stays consistent across all modules.\n  const auth: AuthClient = createAuthClient({\n    baseURL,\n    headers,\n    onTokenExpired,\n    onUnauthorized,\n    autoHandleOAuthCallback,\n    autoRedirectAfterLogin,\n    runtime,\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    env,\n  });\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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amaster.ai/client",
-  "version": "1.1.10",
+  "version": "1.1.12",
   "description": "Unified API client for Amaster platform - All services in one package",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -72,16 +72,16 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@amaster.ai/asr-client": "1.1.10",
-    "@amaster.ai/copilot-client": "1.1.10",
-    "@amaster.ai/auth-client": "1.1.10",
-    "@amaster.ai/bpm-client": "1.1.10",
-    "@amaster.ai/entity-client": "1.1.10",
-    "@amaster.ai/function-client": "1.1.10",
-    "@amaster.ai/http-client": "1.1.10",
-    "@amaster.ai/s3-client": "1.1.10",
-    "@amaster.ai/tts-client": "1.1.10",
-    "@amaster.ai/workflow-client": "1.1.10"
+    "@amaster.ai/asr-client": "1.1.12",
+    "@amaster.ai/auth-client": "1.1.12",
+    "@amaster.ai/bpm-client": "1.1.12",
+    "@amaster.ai/copilot-client": "1.1.12",
+    "@amaster.ai/function-client": "1.1.12",
+    "@amaster.ai/http-client": "1.1.12",
+    "@amaster.ai/s3-client": "1.1.12",
+    "@amaster.ai/entity-client": "1.1.12",
+    "@amaster.ai/tts-client": "1.1.12",
+    "@amaster.ai/workflow-client": "1.1.12"
   },
   "peerDependencies": {
     "axios": "^1.11.0"

package/types/bpm.d.ts

@@ -445,6 +445,22 @@ export interface BpmClientAPI {
     params?: { skipCustomListeners?: boolean }
   ): Promise<ClientResult<null>>;
 
+  /**
+   * Get currently active activity instances for a process instance
+   *
+   * @param processInstanceId - Process instance ID
+   * @returns Array of active activity instances
+   *
+   * @example
+   * ```typescript
+   * const result = await client.bpm.getActiveActivities('proc-123');
+   * result.data?.forEach((activity) => {
+   *   console.log(activity.activityId, activity.activityName);
+   * });
+   * ```
+   */
+  getActiveActivities(processInstanceId: string): Promise<ClientResult<ActivityInstance[]>>;
+
   /**
    * Get process variables
    *
@@ -916,6 +932,20 @@ export interface ProcessXmlResponse {
   processDefinitionId: string;
 }
 
+/**
+ * Runtime active activity instance
+ */
+export interface ActivityInstance {
+  id: string;
+  activityId: string;
+  activityName: string;
+  activityType: string;
+  processInstanceId: string;
+  executionId: string;
+  startTime: string;
+  endTime?: string;
+}
+
 /**
  * Runtime activity instance tree
  */

package/types/index.d.ts

@@ -20,7 +20,8 @@
  *
  * // All subsequent requests automatically include auth token
  * await client.entity.list('default', 'users');
- * await client.bpm.startProcess({ processKey: 'approval' });
+ * await client.bpm.startProcess('approval', { amount: 1000 });
+ * await client.bpm.getTasks({ assignee: 'currentUserId' });
  * ```
  *
  * ## Module Documentation
@@ -65,6 +66,13 @@ export interface AmasterClientOptions {
    */
   baseURL?: 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
    *
@@ -247,7 +255,7 @@ export interface AmasterClient {
   /**
    * S3 Storage module
    *
-   * Provides methods for file upload, download, and management.
+   * Provides methods for file upload, download, and metadata lookup.
    *
    * For detailed documentation, see {@link ./s3.d.ts}
    */

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 `env`, workflow requests
+   * automatically include the `x-env` header and backfill `inputs.env`
+   * when that key is absent.
    * 
    * @template TOutput - The type of workflow outputs
    * @param workflowName - Workflow identifier (key/name)