tale-js-sdk 1.0.0 → 1.1.0

package/dist/acl/index.js

@@ -1,5 +1,23 @@
 import { getAppToken } from "../token.js";
 import { ApiError, ConfigurationError, NetworkError } from "../errors.js";
+// ==================== Helper Functions ====================
+/**
+ * Parses standard API response format: { code, msg, data }
+ */
+function parseApiResponse(json, errorMessage, statusCode) {
+    if (typeof json !== 'object' || json === null) {
+        throw new ApiError(`Invalid response: ${errorMessage} - not an object`, statusCode);
+    }
+    const response = json;
+    if (response.code !== 200) {
+        const errorMsg = typeof response.msg === "string" ? response.msg : errorMessage;
+        throw new ApiError(errorMsg, statusCode, response.code);
+    }
+    if (!response.data) {
+        throw new ApiError(`Invalid response: ${errorMessage} - missing data`, statusCode);
+    }
+    return response.data;
+}
 // ==================== ACL Record Management (v2) ====================
 /**
  * Gets an ACL record by ID.
@@ -48,15 +66,8 @@ export async function getAclRecord(recordId, options) {
     catch (error) {
         throw new NetworkError(`Failed to get ACL record: ${error instanceof Error ? error.message : "Unknown error"}`);
     }
-    const json = (await response.json());
-    if (json.code !== 200) {
-        const errorMsg = typeof json.msg === "string" ? json.msg : "Failed to get ACL record";
-        throw new ApiError(errorMsg, response.status, json.code);
-    }
-    if (!json.data) {
-        throw new ApiError("Invalid ACL record response: missing data", response.status);
-    }
-    return json.data;
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to get ACL record", response.status);
 }
 /**
  * Lists ACL records with pagination and optional filtering.
@@ -91,10 +102,12 @@ export async function listAclRecords(options) {
         throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
     }
     const url = new URL(String(base).replace(/\/+$/, "") + "/acl/v2/records");
+    // 分离 AclOptions 字段，只保留请求参数
+    const { appToken, baseUrl, ...requestParams } = options || {};
     const queryParams = {
         page: 0,
         size: 20,
-        ...options,
+        ...requestParams,
     };
     Object.entries(queryParams).forEach(([key, value]) => {
         if (value !== undefined) {
@@ -114,15 +127,12 @@ export async function listAclRecords(options) {
     catch (error) {
         throw new NetworkError(`Failed to list ACL records: ${error instanceof Error ? error.message : "Unknown error"}`);
     }
-    const json = (await response.json());
-    if (json.code !== 200) {
-        const errorMsg = typeof json.msg === "string" ? json.msg : "Failed to list ACL records";
-        throw new ApiError(errorMsg, response.status, json.code);
+    const json = await response.json();
+    const data = parseApiResponse(json, "Failed to list ACL records", response.status);
+    if (!Array.isArray(data.content)) {
+        throw new ApiError("Invalid ACL records response: content is not an array", response.status);
     }
-    if (!json.data || !Array.isArray(json.data.content)) {
-        throw new ApiError("Invalid ACL records response: missing data", response.status);
-    }
-    return json.data;
+    return data;
 }
 /**
  * Creates a new ACL record.
@@ -183,15 +193,8 @@ export async function createAclRecord(request, options) {
     catch (error) {
         throw new NetworkError(`Failed to create ACL record: ${error instanceof Error ? error.message : "Unknown error"}`);
     }
-    const json = (await response.json());
-    if (json.code !== 200) {
-        const errorMsg = typeof json.msg === "string" ? json.msg : "Failed to create ACL record";
-        throw new ApiError(errorMsg, response.status, json.code);
-    }
-    if (!json.data) {
-        throw new ApiError("Invalid ACL record creation response: missing data", response.status);
-    }
-    return json.data;
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to create ACL record", response.status);
 }
 /**
  * Batch creates ACL records.
@@ -253,17 +256,8 @@ export async function batchCreateAclRecords(requests, options) {
     catch (error) {
         throw new NetworkError(`Failed to batch create ACL records: ${error instanceof Error ? error.message : "Unknown error"}`);
     }
-    const json = (await response.json());
-    if (json.code !== 200) {
-        const errorMsg = typeof json.msg === "string"
-            ? json.msg
-            : "Failed to batch create ACL records";
-        throw new ApiError(errorMsg, response.status, json.code);
-    }
-    if (!json.data) {
-        throw new ApiError("Invalid ACL batch creation response: missing data", response.status);
-    }
-    return json.data;
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to batch create ACL records", response.status);
 }
 /**
  * Updates an existing ACL record.
@@ -317,15 +311,8 @@ export async function updateAclRecord(recordId, request, options) {
     catch (error) {
         throw new NetworkError(`Failed to update ACL record: ${error instanceof Error ? error.message : "Unknown error"}`);
     }
-    const json = (await response.json());
-    if (json.code !== 200) {
-        const errorMsg = typeof json.msg === "string" ? json.msg : "Failed to update ACL record";
-        throw new ApiError(errorMsg, response.status, json.code);
-    }
-    if (!json.data) {
-        throw new ApiError("Invalid ACL record update response: missing data", response.status);
-    }
-    return json.data;
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to update ACL record", response.status);
 }
 /**
  * Deletes an ACL record.
@@ -374,10 +361,15 @@ export async function deleteAclRecord(recordId, options) {
     catch (error) {
         throw new NetworkError(`Failed to delete ACL record: ${error instanceof Error ? error.message : "Unknown error"}`);
     }
-    const json = (await response.json());
-    if (json.code !== 200) {
-        const errorMsg = typeof json.msg === "string" ? json.msg : "Failed to delete ACL record";
-        throw new ApiError(errorMsg, response.status, json.code);
+    const json = await response.json();
+    // Delete response may not have data field, handle differently
+    if (typeof json !== 'object' || json === null) {
+        throw new ApiError("Invalid ACL record deletion response", response.status);
+    }
+    const apiResponse = json;
+    if (apiResponse.code !== 200) {
+        const errorMsg = typeof apiResponse.msg === "string" ? apiResponse.msg : "Failed to delete ACL record";
+        throw new ApiError(errorMsg, response.status, apiResponse.code);
     }
 }
 // ==================== ACL Template Management ====================
@@ -471,12 +463,14 @@ export async function listAclTemplates(options) {
         throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
     }
     const url = new URL(String(base).replace(/\/+$/, "") + "/acl/v1/templates");
+    // 分离 AclOptions 字段，只保留请求参数
+    const { appToken, baseUrl, ...requestParams } = options || {};
     const queryParams = {
         page: 0,
         size: 20,
         sort_by: "createdAt",
         sort_direction: "desc",
-        ...options,
+        ...requestParams,
     };
     Object.entries(queryParams).forEach(([key, value]) => {
         if (value !== undefined) {

package/dist/acl/types.d.ts

@@ -52,6 +52,7 @@ export interface UpdateAclRecordRequest {
 export interface ListAclRecordsRequest {
     page?: number;
     size?: number;
+    sort?: string;
     template_id?: string;
     subject_type?: string;
     subject_id?: string;

package/dist/index.d.ts

@@ -5,5 +5,6 @@ export * from "./auth/index.js";
 export * from "./user-group/index.js";
 export * from "./rbac/index.js";
 export * from "./acl/index.js";
+export * from "./user-attribute/index.js";
 export * from "./errors.js";
 export type { CommonOptions, PageResponse, UserGroup, Role, Privilege, AppInfo, User } from "./common/types.js";

package/dist/index.js

@@ -5,4 +5,5 @@ export * from "./auth/index.js";
 export * from "./user-group/index.js";
 export * from "./rbac/index.js";
 export * from "./acl/index.js";
+export * from "./user-attribute/index.js";
 export * from "./errors.js";

package/dist/user/index.d.ts

@@ -1,5 +1,5 @@
-import type { CreateUserRequest, AppInfo, User, Role, Privilege, UserGroup, UserLoginMethod, CreateUserResponse, CreateUserJson, CreateUserOptions, GetUserRequest, DeleteUserResponse, DeleteUserJson, CommonOptions, ListUsersRequest, UserAttribute, UserListItem, ListUsersResponse, ListUsersJson, UpdateUserRequest, UpdateUserResponse, UpdateUserJson, UpdateUserPasswordRequest, UpdateUserPasswordResponse, UpdateUserPasswordJson, UploadAvatarResponse, UploadAvatarJson, AvatarPresignedUrlResponse, AvatarPresignedUrlJson, UpdateUserFrozenStatusRequest, UserFrozenStatusResponse, UpdateUserFrozenStatusJson, GetUserFrozenStatusJson } from "./types.js";
-export type { CreateUserRequest, AppInfo, User, Role, Privilege, UserGroup, UserLoginMethod, CreateUserResponse, CreateUserJson, CreateUserOptions, GetUserRequest, DeleteUserResponse, DeleteUserJson, CommonOptions, ListUsersRequest, UserAttribute, UserListItem, ListUsersResponse, ListUsersJson, UpdateUserRequest, UpdateUserResponse, UpdateUserJson, UpdateUserPasswordRequest, UpdateUserPasswordResponse, UpdateUserPasswordJson, UploadAvatarResponse, UploadAvatarJson, AvatarPresignedUrlResponse, AvatarPresignedUrlJson, UpdateUserFrozenStatusRequest, UserFrozenStatusResponse, UpdateUserFrozenStatusJson, GetUserFrozenStatusJson, };
+import type { CreateUserRequest, AppInfo, User, Role, Privilege, UserGroup, UserLoginMethod, CreateUserResponse, CreateUserJson, CreateUserOptions, GetUserRequest, DeleteUserResponse, DeleteUserJson, CommonOptions, ListUsersRequest, UserAttributeItemDTO, UserListItem, ListUsersResponse, ListUsersJson, UpdateUserRequest, UpdateUserResponse, UpdateUserJson, UpdateUserPasswordRequest, UpdateUserPasswordResponse, UpdateUserPasswordJson, UploadAvatarResponse, UploadAvatarJson, AvatarPresignedUrlResponse, AvatarPresignedUrlJson, UpdateUserFrozenStatusRequest, UserFrozenStatusResponse, UpdateUserFrozenStatusJson, GetUserFrozenStatusJson } from "./types.js";
+export type { CreateUserRequest, AppInfo, User, Role, Privilege, UserGroup, UserLoginMethod, CreateUserResponse, CreateUserJson, CreateUserOptions, GetUserRequest, DeleteUserResponse, DeleteUserJson, CommonOptions, ListUsersRequest, UserAttributeItemDTO, UserListItem, ListUsersResponse, ListUsersJson, UpdateUserRequest, UpdateUserResponse, UpdateUserJson, UpdateUserPasswordRequest, UpdateUserPasswordResponse, UpdateUserPasswordJson, UploadAvatarResponse, UploadAvatarJson, AvatarPresignedUrlResponse, AvatarPresignedUrlJson, UpdateUserFrozenStatusRequest, UserFrozenStatusResponse, UpdateUserFrozenStatusJson, GetUserFrozenStatusJson, };
 /**
  * Creates a new user in the Tale application.
  *

package/dist/user/types.d.ts

@@ -1,5 +1,6 @@
 import type { AppInfo, User, UserGroup, Role, Privilege, CommonOptions, PageResponse } from "../common/types.js";
-export type { AppInfo, User, UserGroup, Role, Privilege, CommonOptions, PageResponse, };
+import type { UserAttributeItemDTO } from "../user-attribute/types.js";
+export type { AppInfo, User, UserGroup, Role, Privilege, CommonOptions, PageResponse, UserAttributeItemDTO, };
 export interface CreateUserRequest {
     username: string;
     password_encrypted?: string;
@@ -59,18 +60,13 @@ export interface ListUsersRequest {
     keyword?: string;
     include_attributes?: boolean;
 }
-export interface UserAttribute {
-    attribute_id: string;
-    attribute_name: string;
-    attribute_value: string;
-}
 export interface UserListItem {
     app: AppInfo;
     user: User;
     user_roles: Role[];
     user_privileges: Privilege[];
     user_groups: UserGroup[];
-    user_attributes?: UserAttribute[];
+    user_attributes?: UserAttributeItemDTO[];
 }
 export interface ListUsersResponse extends PageResponse<UserListItem> {
     content: UserListItem[];

package/dist/user-attribute/index.d.ts

@@ -0,0 +1,194 @@
+import type { UserAttributeDefinition, UserAttributeDTO, UserAttributeItemDTO, UserAttributeGroupedDTO, CreateUserAttributeDefinitionRequest, UpdateUserAttributeDefinitionRequest, SetUserAttributeRequest, ListUserAttributeDefinitionsRequest, ListUserAttributesRequest, ListAllUserAttributesRequest, UserAttributeOptions } from "./types.js";
+export type { UserAttributeDefinition, UserAttributeDTO, UserAttributeItemDTO, UserAttributeGroupedDTO, CreateUserAttributeDefinitionRequest, UpdateUserAttributeDefinitionRequest, SetUserAttributeRequest, ListUserAttributeDefinitionsRequest, ListUserAttributesRequest, ListAllUserAttributesRequest, UserAttributeOptions, };
+/**
+ * Creates a new user attribute definition.
+ *
+ * @param request - Attribute definition creation request
+ * @param options - Optional configuration
+ * @returns Promise resolving to created attribute definition
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * const definition = await createUserAttributeDefinition({
+ *   attribute_name: "department",
+ *   description: "User's department",
+ *   schema_definition: { type: "string" },
+ *   is_enabled: true,
+ * });
+ * ```
+ */
+export declare function createUserAttributeDefinition(request: CreateUserAttributeDefinitionRequest, options?: UserAttributeOptions): Promise<UserAttributeDefinition>;
+/**
+ * Updates an existing user attribute definition.
+ *
+ * @param openId - Attribute definition open ID
+ * @param request - Attribute definition update request
+ * @param options - Optional configuration
+ * @returns Promise resolving to updated attribute definition
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export declare function updateUserAttributeDefinition(openId: string, request: UpdateUserAttributeDefinitionRequest, options?: UserAttributeOptions): Promise<UserAttributeDefinition>;
+/**
+ * Deletes a user attribute definition.
+ *
+ * @param openId - Attribute definition open ID
+ * @param options - Optional configuration
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export declare function deleteUserAttributeDefinition(openId: string, options?: UserAttributeOptions): Promise<void>;
+/**
+ * Gets a user attribute definition by open ID.
+ *
+ * @param openId - Attribute definition open ID
+ * @param options - Optional configuration
+ * @returns Promise resolving to attribute definition
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export declare function getUserAttributeDefinition(openId: string, options?: UserAttributeOptions): Promise<UserAttributeDefinition>;
+/**
+ * Lists user attribute definitions with pagination and optional filtering.
+ *
+ * @param request - List request parameters
+ * @param options - Optional configuration
+ * @returns Promise resolving to paginated list of attribute definitions
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * const result = await listUserAttributeDefinitions({
+ *   page: 0,
+ *   size: 20,
+ *   keyword: "department",
+ * });
+ * console.log(result.content); // Array of definitions
+ * console.log(result.totalElements); // Total count
+ * ```
+ */
+export declare function listUserAttributeDefinitions(request?: ListUserAttributeDefinitionsRequest & UserAttributeOptions): Promise<{
+    content: UserAttributeDefinition[];
+    totalElements: number;
+}>;
+/**
+ * Lists all enabled user attribute definitions.
+ *
+ * @param options - Optional configuration
+ * @returns Promise resolving to array of enabled attribute definitions
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export declare function listEnabledUserAttributeDefinitions(options?: UserAttributeOptions): Promise<UserAttributeDefinition[]>;
+/**
+ * Toggles the enabled status of a user attribute definition.
+ *
+ * @param openId - Attribute definition open ID
+ * @param isEnabled - Whether the definition should be enabled
+ * @param options - Optional configuration
+ * @returns Promise resolving to updated attribute definition
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export declare function toggleUserAttributeDefinitionStatus(openId: string, isEnabled: boolean, options?: UserAttributeOptions): Promise<UserAttributeDefinition>;
+/**
+ * Sets a user attribute value.
+ *
+ * @param userId - User ID
+ * @param attributeDefinitionId - Attribute definition ID
+ * @param request - Attribute value to set
+ * @param options - Optional configuration
+ * @returns Promise resolving to updated user attribute
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export declare function setUserAttribute(userId: string, attributeDefinitionId: string, request: SetUserAttributeRequest, options?: UserAttributeOptions): Promise<UserAttributeDTO>;
+/**
+ * Gets a user attribute value.
+ *
+ * @param userId - User ID
+ * @param attributeDefinitionId - Attribute definition ID
+ * @param options - Optional configuration
+ * @returns Promise resolving to user attribute
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export declare function getUserAttribute(userId: string, attributeDefinitionId: string, options?: UserAttributeOptions): Promise<UserAttributeDTO>;
+/**
+ * Deletes a user attribute value.
+ *
+ * @param userId - User ID
+ * @param attributeDefinitionId - Attribute definition ID
+ * @param options - Optional configuration
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export declare function deleteUserAttribute(userId: string, attributeDefinitionId: string, options?: UserAttributeOptions): Promise<void>;
+/**
+ * Gets all attributes for a specific user.
+ *
+ * @param userId - User ID
+ * @param options - Optional configuration
+ * @returns Promise resolving to array of user attributes
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export declare function getUserAttributes(userId: string, options?: UserAttributeOptions): Promise<UserAttributeDTO[]>;
+/**
+ * Lists user attributes with pagination.
+ *
+ * @param userId - User ID
+ * @param request - List request parameters
+ * @param options - Optional configuration
+ * @returns Promise resolving to paginated list of user attributes
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export declare function listUserAttributes(userId: string, request?: ListUserAttributesRequest & UserAttributeOptions): Promise<{
+    content: UserAttributeDTO[];
+    totalElements: number;
+}>;
+/**
+ * Lists all users who have a specific attribute.
+ *
+ * @param attributeDefinitionId - Attribute definition ID
+ * @param request - List request parameters
+ * @param options - Optional configuration
+ * @returns Promise resolving to paginated list of user attributes
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export declare function listAttributeUsers(attributeDefinitionId: string, request?: ListUserAttributesRequest & UserAttributeOptions): Promise<{
+    content: UserAttributeDTO[];
+    totalElements: number;
+}>;
+/**
+ * Lists all user attributes grouped by user with pagination.
+ *
+ * @param request - List request parameters
+ * @param options - Optional configuration
+ * @returns Promise resolving to paginated list of grouped user attributes
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export declare function listAllUserAttributes(request?: ListAllUserAttributesRequest & UserAttributeOptions): Promise<{
+    content: UserAttributeGroupedDTO[];
+    totalElements: number;
+}>;

package/dist/user-attribute/index.js

@@ -0,0 +1,628 @@
+import { getAppToken } from "../token.js";
+import { ApiError, ConfigurationError, NetworkError } from "../errors.js";
+// ==================== Helper Functions ====================
+/**
+ * Parses standard API response format: { code, msg, data }
+ */
+function parseApiResponse(json, errorMessage, statusCode) {
+    if (typeof json !== "object" || json === null) {
+        throw new ApiError(`Invalid response: ${errorMessage} - not an object`, statusCode);
+    }
+    const response = json;
+    if (response.code !== 200) {
+        const errorMsg = typeof response.msg === "string" ? response.msg : errorMessage;
+        throw new ApiError(errorMsg, statusCode, response.code);
+    }
+    if (!response.data) {
+        throw new ApiError(`Invalid response: ${errorMessage} - missing data`, statusCode);
+    }
+    return response.data;
+}
+// ==================== Attribute Definition Management ====================
+/**
+ * Creates a new user attribute definition.
+ *
+ * @param request - Attribute definition creation request
+ * @param options - Optional configuration
+ * @returns Promise resolving to created attribute definition
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * const definition = await createUserAttributeDefinition({
+ *   attribute_name: "department",
+ *   description: "User's department",
+ *   schema_definition: { type: "string" },
+ *   is_enabled: true,
+ * });
+ * ```
+ */
+export async function createUserAttributeDefinition(request, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") + "/user-attribute/v1/definition");
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+            body: JSON.stringify(request),
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to create user attribute definition: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to create user attribute definition", response.status);
+}
+/**
+ * Updates an existing user attribute definition.
+ *
+ * @param openId - Attribute definition open ID
+ * @param request - Attribute definition update request
+ * @param options - Optional configuration
+ * @returns Promise resolving to updated attribute definition
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export async function updateUserAttributeDefinition(openId, request, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") +
+        `/user-attribute/v1/definition/${encodeURIComponent(openId)}`);
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "PUT",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+            body: JSON.stringify(request),
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to update user attribute definition: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to update user attribute definition", response.status);
+}
+/**
+ * Deletes a user attribute definition.
+ *
+ * @param openId - Attribute definition open ID
+ * @param options - Optional configuration
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export async function deleteUserAttributeDefinition(openId, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") +
+        `/user-attribute/v1/definition/${encodeURIComponent(openId)}`);
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "DELETE",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to delete user attribute definition: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    if (typeof json !== "object" || json === null) {
+        throw new ApiError("Invalid user attribute definition deletion response", response.status);
+    }
+    const apiResponse = json;
+    if (apiResponse.code !== 200) {
+        const errorMsg = typeof apiResponse.msg === "string"
+            ? apiResponse.msg
+            : "Failed to delete user attribute definition";
+        throw new ApiError(errorMsg, response.status, apiResponse.code);
+    }
+}
+/**
+ * Gets a user attribute definition by open ID.
+ *
+ * @param openId - Attribute definition open ID
+ * @param options - Optional configuration
+ * @returns Promise resolving to attribute definition
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export async function getUserAttributeDefinition(openId, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") +
+        `/user-attribute/v1/definition/${encodeURIComponent(openId)}`);
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to get user attribute definition: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to get user attribute definition", response.status);
+}
+/**
+ * Lists user attribute definitions with pagination and optional filtering.
+ *
+ * @param request - List request parameters
+ * @param options - Optional configuration
+ * @returns Promise resolving to paginated list of attribute definitions
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * const result = await listUserAttributeDefinitions({
+ *   page: 0,
+ *   size: 20,
+ *   keyword: "department",
+ * });
+ * console.log(result.content); // Array of definitions
+ * console.log(result.totalElements); // Total count
+ * ```
+ */
+export async function listUserAttributeDefinitions(request) {
+    const token = request?.appToken ?? (await getAppToken(request));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = request?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") + "/user-attribute/v1/definition");
+    const { appToken, baseUrl, ...requestParams } = request || {};
+    const queryParams = {
+        page: 0,
+        size: 20,
+        ...requestParams,
+    };
+    Object.entries(queryParams).forEach(([key, value]) => {
+        if (value !== undefined) {
+            url.searchParams.append(key, String(value));
+        }
+    });
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to list user attribute definitions: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    const data = parseApiResponse(json, "Failed to list user attribute definitions", response.status);
+    if (!Array.isArray(data.content)) {
+        throw new ApiError("Invalid user attribute definitions response: content is not an array", response.status);
+    }
+    return data;
+}
+/**
+ * Lists all enabled user attribute definitions.
+ *
+ * @param options - Optional configuration
+ * @returns Promise resolving to array of enabled attribute definitions
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export async function listEnabledUserAttributeDefinitions(options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") +
+        "/user-attribute/v1/definition/enabled");
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to list enabled user attribute definitions: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    const result = parseApiResponse(json, "Failed to list enabled user attribute definitions", response.status);
+    if (!Array.isArray(result)) {
+        throw new ApiError("Invalid enabled user attribute definitions response: not an array", response.status);
+    }
+    return result;
+}
+/**
+ * Toggles the enabled status of a user attribute definition.
+ *
+ * @param openId - Attribute definition open ID
+ * @param isEnabled - Whether the definition should be enabled
+ * @param options - Optional configuration
+ * @returns Promise resolving to updated attribute definition
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export async function toggleUserAttributeDefinitionStatus(openId, isEnabled, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") +
+        `/user-attribute/v1/definition/${encodeURIComponent(openId)}/status`);
+    url.searchParams.append("enabled", String(isEnabled));
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "PUT",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to toggle user attribute definition status: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to toggle user attribute definition status", response.status);
+}
+// ==================== User Attribute Value Management ====================
+/**
+ * Sets a user attribute value.
+ *
+ * @param userId - User ID
+ * @param attributeDefinitionId - Attribute definition ID
+ * @param request - Attribute value to set
+ * @param options - Optional configuration
+ * @returns Promise resolving to updated user attribute
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export async function setUserAttribute(userId, attributeDefinitionId, request, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") +
+        `/user-attribute/v1/user/${encodeURIComponent(userId)}/attribute/${encodeURIComponent(attributeDefinitionId)}`);
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "PUT",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+            body: JSON.stringify(request),
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to set user attribute: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to set user attribute", response.status);
+}
+/**
+ * Gets a user attribute value.
+ *
+ * @param userId - User ID
+ * @param attributeDefinitionId - Attribute definition ID
+ * @param options - Optional configuration
+ * @returns Promise resolving to user attribute
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export async function getUserAttribute(userId, attributeDefinitionId, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") +
+        `/user-attribute/v1/user/${encodeURIComponent(userId)}/attribute/${encodeURIComponent(attributeDefinitionId)}`);
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to get user attribute: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    return parseApiResponse(json, "Failed to get user attribute", response.status);
+}
+/**
+ * Deletes a user attribute value.
+ *
+ * @param userId - User ID
+ * @param attributeDefinitionId - Attribute definition ID
+ * @param options - Optional configuration
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export async function deleteUserAttribute(userId, attributeDefinitionId, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") +
+        `/user-attribute/v1/user/${encodeURIComponent(userId)}/attribute/${encodeURIComponent(attributeDefinitionId)}`);
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "DELETE",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to delete user attribute: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    if (typeof json !== "object" || json === null) {
+        throw new ApiError("Invalid user attribute deletion response", response.status);
+    }
+    const apiResponse = json;
+    if (apiResponse.code !== 200) {
+        const errorMsg = typeof apiResponse.msg === "string"
+            ? apiResponse.msg
+            : "Failed to delete user attribute";
+        throw new ApiError(errorMsg, response.status, apiResponse.code);
+    }
+}
+/**
+ * Gets all attributes for a specific user.
+ *
+ * @param userId - User ID
+ * @param options - Optional configuration
+ * @returns Promise resolving to array of user attributes
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export async function getUserAttributes(userId, options) {
+    const token = options?.appToken ?? (await getAppToken(options));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") +
+        `/user-attribute/v1/user/${encodeURIComponent(userId)}/attribute`);
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to get user attributes: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    const result = parseApiResponse(json, "Failed to get user attributes", response.status);
+    if (!Array.isArray(result)) {
+        throw new ApiError("Invalid user attributes response: not an array", response.status);
+    }
+    return result;
+}
+/**
+ * Lists user attributes with pagination.
+ *
+ * @param userId - User ID
+ * @param request - List request parameters
+ * @param options - Optional configuration
+ * @returns Promise resolving to paginated list of user attributes
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export async function listUserAttributes(userId, request) {
+    const token = request?.appToken ?? (await getAppToken(request));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = request?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") +
+        `/user-attribute/v1/user/${encodeURIComponent(userId)}/attribute/page`);
+    const { appToken, baseUrl, ...requestParams } = request || {};
+    const queryParams = {
+        page: 0,
+        size: 20,
+        ...requestParams,
+    };
+    Object.entries(queryParams).forEach(([key, value]) => {
+        if (value !== undefined) {
+            url.searchParams.append(key, String(value));
+        }
+    });
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to list user attributes: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    const data = parseApiResponse(json, "Failed to list user attributes", response.status);
+    if (!Array.isArray(data.content)) {
+        throw new ApiError("Invalid user attributes response: content is not an array", response.status);
+    }
+    return data;
+}
+/**
+ * Lists all users who have a specific attribute.
+ *
+ * @param attributeDefinitionId - Attribute definition ID
+ * @param request - List request parameters
+ * @param options - Optional configuration
+ * @returns Promise resolving to paginated list of user attributes
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export async function listAttributeUsers(attributeDefinitionId, request) {
+    const token = request?.appToken ?? (await getAppToken(request));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = request?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") +
+        `/user-attribute/v1/definition/${encodeURIComponent(attributeDefinitionId)}/users`);
+    const { appToken, baseUrl, ...requestParams } = request || {};
+    const queryParams = {
+        page: 0,
+        size: 20,
+        ...requestParams,
+    };
+    Object.entries(queryParams).forEach(([key, value]) => {
+        if (value !== undefined) {
+            url.searchParams.append(key, String(value));
+        }
+    });
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to list attribute users: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    const data = parseApiResponse(json, "Failed to list attribute users", response.status);
+    if (!Array.isArray(data.content)) {
+        throw new ApiError("Invalid attribute users response: content is not an array", response.status);
+    }
+    return data;
+}
+/**
+ * Lists all user attributes grouped by user with pagination.
+ *
+ * @param request - List request parameters
+ * @param options - Optional configuration
+ * @returns Promise resolving to paginated list of grouped user attributes
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails
+ * @throws {NetworkError} When network request fails
+ */
+export async function listAllUserAttributes(request) {
+    const token = request?.appToken ?? (await getAppToken(request));
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = request?.baseUrl ?? env?.TALE_BASE_URL ?? undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    const url = new URL(String(base).replace(/\/+$/, "") +
+        "/user-attribute/v1/user/attribute/page");
+    const { appToken, baseUrl, ...requestParams } = request || {};
+    const queryParams = {
+        page: 0,
+        size: 20,
+        sort_by: "createdAt",
+        sort_direction: "desc",
+        ...requestParams,
+    };
+    Object.entries(queryParams).forEach(([key, value]) => {
+        if (value !== undefined) {
+            url.searchParams.append(key, String(value));
+        }
+    });
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to list all user attributes: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    const json = await response.json();
+    const data = parseApiResponse(json, "Failed to list all user attributes", response.status);
+    if (!Array.isArray(data.content)) {
+        throw new ApiError("Invalid all user attributes response: content is not an array", response.status);
+    }
+    return data;
+}

package/dist/user-attribute/types.d.ts

@@ -0,0 +1,108 @@
+import type { CommonOptions } from "../common/types.js";
+/**
+ * User attribute definition
+ */
+export interface UserAttributeDefinition {
+    open_id: string;
+    attribute_name: string;
+    description?: string;
+    schema_definition: Record<string, unknown>;
+    is_enabled: boolean;
+    created_at: string;
+    updated_at: string;
+    remark?: string;
+}
+/**
+ * User attribute value (matches backend UserAttributeDTO)
+ */
+export interface UserAttributeDTO {
+    user_id: string;
+    attribute_definition_id: string;
+    attribute_name: string;
+    attribute_value: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    remark?: string;
+}
+/**
+ * User attribute item (without user_id, matches backend UserAttributeItemDTO)
+ */
+export interface UserAttributeItemDTO {
+    attribute_definition_id: string;
+    attribute_name: string;
+    attribute_value: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    remark?: string;
+}
+/**
+ * User attribute grouped by user (matches backend UserAttributeGroupedDTO)
+ */
+export interface UserAttributeGroupedDTO {
+    user_id: string;
+    username: string;
+    nickname: string;
+    email: string;
+    phone: string;
+    avatar_url?: string;
+    remark?: string;
+    is_frozen: boolean;
+    registered_at: string;
+    attributes: UserAttributeItemDTO[];
+}
+/**
+ * Request for creating a user attribute definition
+ */
+export interface CreateUserAttributeDefinitionRequest {
+    attribute_name: string;
+    description?: string;
+    schema_definition: Record<string, unknown>;
+    is_enabled?: boolean;
+    remark?: string;
+}
+/**
+ * Request for updating a user attribute definition
+ */
+export interface UpdateUserAttributeDefinitionRequest {
+    attribute_name?: string;
+    description?: string;
+    schema_definition?: Record<string, unknown>;
+    is_enabled?: boolean;
+    remark?: string;
+}
+/**
+ * Request for setting a user attribute value
+ */
+export interface SetUserAttributeRequest {
+    attribute_value: Record<string, unknown>;
+    remark?: string;
+}
+/**
+ * Request for listing user attribute definitions
+ */
+export interface ListUserAttributeDefinitionsRequest {
+    page?: number;
+    size?: number;
+    keyword?: string;
+}
+/**
+ * Request for listing user attributes
+ */
+export interface ListUserAttributesRequest {
+    page?: number;
+    size?: number;
+}
+/**
+ * Request for listing all user attributes (grouped)
+ */
+export interface ListAllUserAttributesRequest {
+    page?: number;
+    size?: number;
+    sort_by?: string;
+    sort_direction?: "asc" | "desc";
+}
+/**
+ * Options for user attribute operations
+ */
+export interface UserAttributeOptions extends CommonOptions {
+}

package/dist/user-attribute/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tale-js-sdk",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Official TypeScript SDK for Tale backend services",
   "keywords": [
     "tale",