@amaster.ai/client 1.1.25 → 1.1.26

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { AuthClient } from '@amaster.ai/auth-client';
 export { LoginParams, LoginResponse, OAuthProvider, Permission, RegisterParams, Role, Session, User } from '@amaster.ai/auth-client';
 import { EntityClient } from '@amaster.ai/entity-client';
-export { EntityListResponse, EntityQueryParams, FilterGroup, FilterItem, FilterOperator } from '@amaster.ai/entity-client';
+export { EntityGetParams, EntityListResponse, EntityQueryParams, FilterGroup, FilterItem, FilterOperator } from '@amaster.ai/entity-client';
 import { BpmClient } from '@amaster.ai/bpm-client';
 export { ActivityInstanceTree, CamundaVariable, HistoryActivityInstance, HistoryProcessInstance, HistoryTask, ProcessInstance, ProcessVariable, Task, TaskFormSchema, TaskQueryParams, UserOperationLog } from '@amaster.ai/bpm-client';
 import { WorkflowClient } from '@amaster.ai/workflow-client';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { AuthClient } from '@amaster.ai/auth-client';
 export { LoginParams, LoginResponse, OAuthProvider, Permission, RegisterParams, Role, Session, User } from '@amaster.ai/auth-client';
 import { EntityClient } from '@amaster.ai/entity-client';
-export { EntityListResponse, EntityQueryParams, FilterGroup, FilterItem, FilterOperator } from '@amaster.ai/entity-client';
+export { EntityGetParams, EntityListResponse, EntityQueryParams, FilterGroup, FilterItem, FilterOperator } from '@amaster.ai/entity-client';
 import { BpmClient } from '@amaster.ai/bpm-client';
 export { ActivityInstanceTree, CamundaVariable, HistoryActivityInstance, HistoryProcessInstance, HistoryTask, ProcessInstance, ProcessVariable, Task, TaskFormSchema, TaskQueryParams, UserOperationLog } from '@amaster.ai/bpm-client';
 import { WorkflowClient } from '@amaster.ai/workflow-client';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amaster.ai/client",
-  "version": "1.1.25",
+  "version": "1.1.26",
   "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.25",
-    "@amaster.ai/auth-client": "1.1.25",
-    "@amaster.ai/copilot-client": "1.1.25",
-    "@amaster.ai/bpm-client": "1.1.25",
-    "@amaster.ai/entity-client": "1.1.25",
-    "@amaster.ai/http-client": "1.1.25",
-    "@amaster.ai/s3-client": "1.1.25",
-    "@amaster.ai/tts-client": "1.1.25",
-    "@amaster.ai/workflow-client": "1.1.25",
-    "@amaster.ai/function-client": "1.1.25"
+    "@amaster.ai/asr-client": "1.1.26",
+    "@amaster.ai/auth-client": "1.1.26",
+    "@amaster.ai/bpm-client": "1.1.26",
+    "@amaster.ai/copilot-client": "1.1.26",
+    "@amaster.ai/entity-client": "1.1.26",
+    "@amaster.ai/function-client": "1.1.26",
+    "@amaster.ai/http-client": "1.1.26",
+    "@amaster.ai/s3-client": "1.1.26",
+    "@amaster.ai/workflow-client": "1.1.26",
+    "@amaster.ai/tts-client": "1.1.26"
   },
   "peerDependencies": {
     "axios": "^1.11.0"

package/types/entity.d.ts

@@ -176,6 +176,19 @@ export interface EntityQueryParams {
   [key: string]: unknown;
 }
 
+/**
+ * Entity detail query parameters.
+ *
+ * `get()` locates the record by path id. These params only control projection.
+ */
+export interface EntityGetParams {
+  /** Relations to load */
+  __relations?: string[];
+
+  /** Fields to select */
+  __fields?: string[];
+}
+
 // ==================== Response Types ====================
 
 /**
@@ -262,6 +275,7 @@ export interface EntityClientAPI {
    * @param source - Data source name
    * @param entity - Entity name
    * @param id - Entity ID
+   * @param params - Projection parameters, including explicit relation loading
    * @returns The entity data
    * 
    * @example
@@ -274,13 +288,20 @@ export interface EntityClientAPI {
    * // With type safety
    * type User = { id: number; name: string };
    * const result = await client.entity.get<User>('default', 'users', 123);
+   *
+   * @example
+   * // Load explicit relations
+   * const result = await client.entity.get('default', 'orders', 123, {
+   *   __relations: ['order_customer']
+   * });
    * 
    * @since 1.0.0
    */
   get<T = Record<string, unknown>>(
     source: string,
     entity: string,
-    id: string | number
+    id: string | number,
+    params?: EntityGetParams
   ): Promise<ClientResult<T>>;
 
   /**

package/types/index.d.ts

@@ -376,6 +376,7 @@ export type {
 } from "./auth";
 export type {
   EntityClientAPI,
+  EntityGetParams,
   EntityQueryParams,
   EntityListResponse,
   FilterOperator,