tale-js-sdk 0.1.3 → 0.1.4

package/dist/auth/types.d.ts

@@ -1,9 +1,9 @@
-import type { AppInfo, BaseUser, UserGroup, Role, Privilege, CommonOptions } from "../common/types.js";
+import type { AppInfo, User, UserGroup, Role, Privilege, CommonOptions } from "../common/types.js";
 export type { AppInfo, UserGroup };
 /**
- * Auth user information (extends BaseUser with non-null remark)
+ * Auth user information (extends User with non-null remark)
  */
-export interface AuthUser extends Omit<BaseUser, "remark"> {
+export interface AuthUser extends Omit<User, "remark"> {
     remark: string;
 }
 /**

package/dist/common/types.d.ts

@@ -1,76 +1,82 @@
-/**
- * Application information
- */
-export interface AppInfo {
-    app_id: string;
-    org_id: string;
-    app_key: string;
-    app_name: string;
+export interface CommonOptions {
+    baseUrl?: string;
+    appToken?: string;
 }
 /**
- * Base user information with common fields
+ * Spring Boot Page serialization format
+ *
+ * This matches the default JSON serialization format of Spring Data's Page object
+ *
+ * @see https://docs.spring.io/spring-data/commons/docs/current/api/org/springframework/data/domain/Page.html
  */
-export interface BaseUser {
-    user_id: string;
-    nick_name: string;
-    avatar_url: string;
-    username: string;
-    email: string;
-    phone: string;
-    registered_at: string;
-    remark: string | null;
-    is_frozen: boolean;
-    latest_login_time?: string;
+export interface PageResponse<T> {
+    /** Page content */
+    content: T[];
+    /** Pagination information */
+    pageable: {
+        pageNumber: number;
+        pageSize: number;
+        sort: {
+            sorted: boolean;
+            unsorted: boolean;
+            empty: boolean;
+        };
+    };
+    /** Total number of pages */
+    totalPages: number;
+    /** Total number of elements */
+    totalElements: number;
+    /** Whether this is the last page */
+    last: boolean;
+    /** Whether this is the first page */
+    first: boolean;
+    /** Number of elements in current page */
+    numberOfElements: number;
+    /** Page size */
+    size: number;
+    /** Current page number */
+    number: number;
+    /** Whether the page is empty */
+    empty: boolean;
 }
-/**
- * User group information
- */
 export interface UserGroup {
     group_id: string;
     group_name: string;
     description?: string;
+    remark?: string;
 }
-/**
- * Role information
- */
 export interface Role {
     role_id: string;
     role_name: string;
+    role_type?: string;
+    role_property?: Record<string, unknown>;
     description?: string;
+    expired_at?: string;
 }
-/**
- * Privilege information
- */
 export interface Privilege {
     privilege_id: string;
     privilege_name: string;
+    privilege_type?: string;
+    privilege_property?: Record<string, unknown>;
     description?: string;
+    expired_at?: string;
+    remark?: string;
 }
-/**
- * Sort information for pagination
- */
-export interface Sort {
-    empty: boolean;
-    sorted: boolean;
-    unsorted: boolean;
-}
-/**
- * Pageable information for pagination
- */
-export interface Pageable {
-    sort: Sort;
-    offset: number;
-    pageNumber: number;
-    pageSize: number;
-    paged: boolean;
-    unpaged: boolean;
+export interface AppInfo {
+    app_id: string;
+    app_key: string;
+    app_name: string;
 }
-/**
- * Common API request options
- */
-export interface CommonOptions {
-    baseUrl?: string;
-    appKey?: string;
-    appSecret?: string;
-    appToken?: string;
+export interface User {
+    user_id: string;
+    open_id: string;
+    username: string;
+    nick_name: string;
+    email: string;
+    phone: string;
+    avatar_url?: string;
+    is_frozen: boolean;
+    created_at: string;
+    updated_at: string;
+    remark?: string;
 }

package/dist/common/types.js

@@ -1,3 +1,2 @@
 // ==================== Common Types ====================
-// This file contains shared type definitions used across multiple modules
 export {};

package/dist/index.d.ts

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

package/dist/index.js

@@ -4,4 +4,3 @@ export * from "./user/index.js";
 export * from "./auth/index.js";
 export * from "./user-group/index.js";
 export * from "./errors.js";
-export * from "./common/types.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, Sort, Pageable, ListUsersResponse, ListUsersJson } from "./types.js";
-export type { CreateUserRequest, AppInfo, User, Role, Privilege, UserGroup, UserLoginMethod, CreateUserResponse, CreateUserJson, CreateUserOptions, GetUserRequest, DeleteUserResponse, DeleteUserJson, CommonOptions, ListUsersRequest, UserAttribute, UserListItem, Sort, Pageable, ListUsersResponse, ListUsersJson, };
+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, };
 /**
  * Creates a new user in the Tale application.
  *
@@ -102,3 +102,166 @@ export declare function deleteUser(userId: string, options?: CommonOptions): Pro
  * ```
  */
 export declare function listUsers(options?: ListUsersRequest & CommonOptions): Promise<ListUsersResponse>;
+/**
+ * Updates user information by user ID or open ID.
+ *
+ * @param userId - User ID (open_id) to update
+ * @param userData - User data to update
+ * @param options - Optional configuration for the request
+ * @returns Promise resolving to the update result
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails or returns invalid response
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * import { updateUser } from '@tale/client';
+ *
+ * try {
+ *   const result = await updateUser('user_open_id_here', {
+ *     nick_name: 'John Doe',
+ *     email: 'john@example.com'
+ *   });
+ *   console.log('User updated:', result.success);
+ * } catch (error) {
+ *   console.error('Failed to update user:', error.message);
+ * }
+ * ```
+ */
+export declare function updateUser(userId: string, userData: UpdateUserRequest, options?: CommonOptions): Promise<UpdateUserResponse>;
+/**
+ * Updates user password.
+ *
+ * @param passwordData - Password data including user_id and encrypted password
+ * @param options - Optional configuration for the request
+ * @returns Promise resolving to the update result
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails or returns invalid response
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * import { updateUserPassword } from '@tale/client';
+ *
+ * try {
+ *   const result = await updateUserPassword({
+ *     user_id: 'user_open_id_here',
+ *     password_encrypted: 'encrypted_password_here'
+ *   });
+ *   console.log('Password updated:', result.success);
+ * } catch (error) {
+ *   console.error('Failed to update password:', error.message);
+ * }
+ * ```
+ */
+export declare function updateUserPassword(passwordData: UpdateUserPasswordRequest, options?: CommonOptions): Promise<UpdateUserPasswordResponse>;
+/**
+ * Uploads user avatar image.
+ *
+ * @param file - File object to upload as avatar
+ * @param userId - User ID (open_id) of the user
+ * @param options - Optional configuration for the request
+ * @returns Promise resolving to the upload result with avatar OSS key
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails or returns invalid response
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * import { uploadAvatar } from '@tale/client';
+ *
+ * try {
+ *   const fileInput = document.querySelector('input[type="file"]');
+ *   const file = fileInput.files[0];
+ *   const result = await uploadAvatar(file, 'user_open_id_here');
+ *   console.log('Avatar uploaded:', result.avatar_oss_key);
+ * } catch (error) {
+ *   console.error('Failed to upload avatar:', error.message);
+ * }
+ * ```
+ */
+export declare function uploadAvatar(file: File, userId: string, options?: CommonOptions): Promise<UploadAvatarResponse>;
+/**
+ * Gets presigned URL for avatar access.
+ *
+ * @param ossKey - OSS key of the avatar
+ * @param options - Optional configuration for the request
+ * @returns Promise resolving to presigned URL information
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails or returns invalid response
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * import { getAvatarPresignedUrl } from '@tale/client';
+ *
+ * try {
+ *   const result = await getAvatarPresignedUrl('avatars/user123.jpg');
+ *   console.log('Presigned URL:', result.presignedUrl);
+ *   console.log('Expires in:', result.expireTimeInSeconds, 'seconds');
+ * } catch (error) {
+ *   console.error('Failed to get presigned URL:', error.message);
+ * }
+ * ```
+ */
+export declare function getAvatarPresignedUrl(ossKey: string, options?: CommonOptions): Promise<AvatarPresignedUrlResponse>;
+/**
+ * Updates user frozen status (freeze or unfreeze a user account).
+ *
+ * @param userId - User ID (open_id) to update frozen status
+ * @param frozenData - Frozen status data including is_frozen flag and optional remark
+ * @param options - Optional configuration for the request
+ * @returns Promise resolving to the updated frozen status information
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails or returns invalid response
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * import { updateUserFrozenStatus } from '@tale/client';
+ *
+ * try {
+ *   // Freeze a user account
+ *   const result = await updateUserFrozenStatus('user_open_id_here', {
+ *     is_frozen: true,
+ *     remark: 'Violated community guidelines'
+ *   });
+ *   console.log('User frozen:', result.is_frozen);
+ *
+ *   // Unfreeze a user account
+ *   const unfrozenResult = await updateUserFrozenStatus('user_open_id_here', {
+ *     is_frozen: false,
+ *     remark: 'Account reactivated'
+ *   });
+ *   console.log('User unfrozen:', !unfrozenResult.is_frozen);
+ * } catch (error) {
+ *   console.error('Failed to update frozen status:', error.message);
+ * }
+ * ```
+ */
+export declare function updateUserFrozenStatus(userId: string, frozenData: UpdateUserFrozenStatusRequest, options?: CommonOptions): Promise<UserFrozenStatusResponse>;
+/**
+ * Gets user frozen status by user ID.
+ *
+ * @param userId - User ID (open_id) to query frozen status
+ * @param options - Optional configuration for the request
+ * @returns Promise resolving to the user frozen status information
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails or returns invalid response
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * import { getUserFrozenStatus } from '@tale/client';
+ *
+ * try {
+ *   const status = await getUserFrozenStatus('user_open_id_here');
+ *   console.log('User is frozen:', status.is_frozen);
+ *   console.log('Remark:', status.remark);
+ *   console.log('Last updated:', status.updated_at);
+ * } catch (error) {
+ *   console.error('Failed to get frozen status:', error.message);
+ * }
+ * ```
+ */
+export declare function getUserFrozenStatus(userId: string, options?: CommonOptions): Promise<UserFrozenStatusResponse>;

package/dist/user/index.js

@@ -330,3 +330,454 @@ export async function listUsers(options) {
     }
     return json.data;
 }
+/**
+ * Updates user information by user ID or open ID.
+ *
+ * @param userId - User ID (open_id) to update
+ * @param userData - User data to update
+ * @param options - Optional configuration for the request
+ * @returns Promise resolving to the update result
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails or returns invalid response
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * import { updateUser } from '@tale/client';
+ *
+ * try {
+ *   const result = await updateUser('user_open_id_here', {
+ *     nick_name: 'John Doe',
+ *     email: 'john@example.com'
+ *   });
+ *   console.log('User updated:', result.success);
+ * } catch (error) {
+ *   console.error('Failed to update user:', error.message);
+ * }
+ * ```
+ */
+export async function updateUser(userId, userData, options) {
+    // Validate required fields
+    if (!userId || userId.trim() === "") {
+        throw new ApiError("userId is required for update", 400, "9400");
+    }
+    // Use provided app token or get one from token service
+    const token = options?.appToken ?? (await getAppToken(options));
+    // Determine base URL
+    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 = String(base).replace(/\/+$/, "") +
+        `/account/v1/user/${encodeURIComponent(userId)}`;
+    let response;
+    try {
+        response = await globalThis.fetch(url, {
+            method: "PUT",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+            body: JSON.stringify(userData),
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to update user: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    let json;
+    try {
+        const responseJson = await response.json();
+        json = responseJson;
+    }
+    catch (error) {
+        throw new ApiError(`Failed to parse user update response: ${error instanceof Error ? error.message : "Invalid JSON"}`, response.status);
+    }
+    // Handle API errors
+    if (json.code !== 200) {
+        const errorMsg = typeof json.msg === "string" ? json.msg : "User update failed";
+        throw new ApiError(errorMsg, response.status, json.code);
+    }
+    return {
+        success: true,
+        user_id: userId,
+    };
+}
+/**
+ * Updates user password.
+ *
+ * @param passwordData - Password data including user_id and encrypted password
+ * @param options - Optional configuration for the request
+ * @returns Promise resolving to the update result
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails or returns invalid response
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * import { updateUserPassword } from '@tale/client';
+ *
+ * try {
+ *   const result = await updateUserPassword({
+ *     user_id: 'user_open_id_here',
+ *     password_encrypted: 'encrypted_password_here'
+ *   });
+ *   console.log('Password updated:', result.success);
+ * } catch (error) {
+ *   console.error('Failed to update password:', error.message);
+ * }
+ * ```
+ */
+export async function updateUserPassword(passwordData, options) {
+    // Validate required fields
+    if (!passwordData.user_id || passwordData.user_id.trim() === "") {
+        throw new ApiError("user_id is required for password update", 400, "9400");
+    }
+    if (!passwordData.password_encrypted || passwordData.password_encrypted.trim() === "") {
+        throw new ApiError("password_encrypted is required", 400, "9400");
+    }
+    // Use provided app token or get one from token service
+    const token = options?.appToken ?? (await getAppToken(options));
+    // Determine base URL
+    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 = String(base).replace(/\/+$/, "") + "/account/v1/user/password";
+    let response;
+    try {
+        response = await globalThis.fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+            body: JSON.stringify(passwordData),
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to update user password: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    let json;
+    try {
+        const responseJson = await response.json();
+        json = responseJson;
+    }
+    catch (error) {
+        throw new ApiError(`Failed to parse password update response: ${error instanceof Error ? error.message : "Invalid JSON"}`, response.status);
+    }
+    // Handle API errors
+    if (json.code !== 200) {
+        const errorMsg = typeof json.msg === "string" ? json.msg : "Password update failed";
+        throw new ApiError(errorMsg, response.status, json.code);
+    }
+    return {
+        success: true,
+        user_id: passwordData.user_id,
+    };
+}
+/**
+ * Uploads user avatar image.
+ *
+ * @param file - File object to upload as avatar
+ * @param userId - User ID (open_id) of the user
+ * @param options - Optional configuration for the request
+ * @returns Promise resolving to the upload result with avatar OSS key
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails or returns invalid response
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * import { uploadAvatar } from '@tale/client';
+ *
+ * try {
+ *   const fileInput = document.querySelector('input[type="file"]');
+ *   const file = fileInput.files[0];
+ *   const result = await uploadAvatar(file, 'user_open_id_here');
+ *   console.log('Avatar uploaded:', result.avatar_oss_key);
+ * } catch (error) {
+ *   console.error('Failed to upload avatar:', error.message);
+ * }
+ * ```
+ */
+export async function uploadAvatar(file, userId, options) {
+    // Validate required fields
+    if (!file) {
+        throw new ApiError("file is required for avatar upload", 400, "9400");
+    }
+    if (!userId || userId.trim() === "") {
+        throw new ApiError("userId is required for avatar upload", 400, "9400");
+    }
+    // Use provided app token or get one from token service
+    const token = options?.appToken ?? (await getAppToken(options));
+    // Determine base URL
+    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 = String(base).replace(/\/+$/, "") + "/account/v1/user/avatar/upload";
+    // Create FormData
+    const formData = new FormData();
+    formData.append("file", file);
+    formData.append("user_open_id", userId);
+    let response;
+    try {
+        response = await globalThis.fetch(url, {
+            method: "POST",
+            headers: {
+                "x-t-token": token,
+            },
+            body: formData,
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to upload avatar: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    let json;
+    try {
+        const responseJson = await response.json();
+        json = responseJson;
+    }
+    catch (error) {
+        throw new ApiError(`Failed to parse avatar upload response: ${error instanceof Error ? error.message : "Invalid JSON"}`, response.status);
+    }
+    // Handle API errors
+    if (json.code !== 200) {
+        const errorMsg = typeof json.msg === "string" ? json.msg : "Avatar upload failed";
+        throw new ApiError(errorMsg, response.status, json.code);
+    }
+    // Validate response structure
+    if (!json.data || !json.data.avatar_oss_key) {
+        throw new ApiError("Invalid avatar upload response: missing avatar_oss_key", response.status);
+    }
+    return json.data;
+}
+/**
+ * Gets presigned URL for avatar access.
+ *
+ * @param ossKey - OSS key of the avatar
+ * @param options - Optional configuration for the request
+ * @returns Promise resolving to presigned URL information
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails or returns invalid response
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * import { getAvatarPresignedUrl } from '@tale/client';
+ *
+ * try {
+ *   const result = await getAvatarPresignedUrl('avatars/user123.jpg');
+ *   console.log('Presigned URL:', result.presignedUrl);
+ *   console.log('Expires in:', result.expireTimeInSeconds, 'seconds');
+ * } catch (error) {
+ *   console.error('Failed to get presigned URL:', error.message);
+ * }
+ * ```
+ */
+export async function getAvatarPresignedUrl(ossKey, options) {
+    // Validate required fields
+    if (!ossKey || ossKey.trim() === "") {
+        throw new ApiError("ossKey is required", 400, "9400");
+    }
+    // Use provided app token or get one from token service
+    const token = options?.appToken ?? (await getAppToken(options));
+    // Determine base URL
+    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(/\/+$/, "") + "/cms/file/getPresignedUrl");
+    url.searchParams.append("ossKey", ossKey);
+    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 avatar presigned URL: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    let json;
+    try {
+        const responseJson = await response.json();
+        json = responseJson;
+    }
+    catch (error) {
+        throw new ApiError(`Failed to parse presigned URL response: ${error instanceof Error ? error.message : "Invalid JSON"}`, response.status);
+    }
+    // Handle API errors
+    if (json.code !== 200) {
+        const errorMsg = typeof json.msg === "string" ? json.msg : "Failed to get presigned URL";
+        throw new ApiError(errorMsg, response.status, json.code);
+    }
+    // Validate response structure
+    if (!json.data || !json.data.presignedUrl) {
+        throw new ApiError("Invalid presigned URL response: missing presignedUrl", response.status);
+    }
+    return json.data;
+}
+/**
+ * Updates user frozen status (freeze or unfreeze a user account).
+ *
+ * @param userId - User ID (open_id) to update frozen status
+ * @param frozenData - Frozen status data including is_frozen flag and optional remark
+ * @param options - Optional configuration for the request
+ * @returns Promise resolving to the updated frozen status information
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails or returns invalid response
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * import { updateUserFrozenStatus } from '@tale/client';
+ *
+ * try {
+ *   // Freeze a user account
+ *   const result = await updateUserFrozenStatus('user_open_id_here', {
+ *     is_frozen: true,
+ *     remark: 'Violated community guidelines'
+ *   });
+ *   console.log('User frozen:', result.is_frozen);
+ *
+ *   // Unfreeze a user account
+ *   const unfrozenResult = await updateUserFrozenStatus('user_open_id_here', {
+ *     is_frozen: false,
+ *     remark: 'Account reactivated'
+ *   });
+ *   console.log('User unfrozen:', !unfrozenResult.is_frozen);
+ * } catch (error) {
+ *   console.error('Failed to update frozen status:', error.message);
+ * }
+ * ```
+ */
+export async function updateUserFrozenStatus(userId, frozenData, options) {
+    // Validate required fields
+    if (!userId || userId.trim() === "") {
+        throw new ApiError("userId is required for updating frozen status", 400, "9400");
+    }
+    if (frozenData.is_frozen === undefined || frozenData.is_frozen === null) {
+        throw new ApiError("is_frozen is required", 400, "9400");
+    }
+    // Use provided app token or get one from token service
+    const token = options?.appToken ?? (await getAppToken(options));
+    // Determine base URL
+    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 = String(base).replace(/\/+$/, "") +
+        `/account/v1/user/${encodeURIComponent(userId)}/frozen-status`;
+    let response;
+    try {
+        response = await globalThis.fetch(url, {
+            method: "PUT",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+            body: JSON.stringify(frozenData),
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to update user frozen status: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    let json;
+    try {
+        const responseJson = await response.json();
+        json = responseJson;
+    }
+    catch (error) {
+        throw new ApiError(`Failed to parse frozen status update response: ${error instanceof Error ? error.message : "Invalid JSON"}`, response.status);
+    }
+    // Handle API errors
+    if (json.code !== 200) {
+        const errorMsg = typeof json.msg === "string" ? json.msg : "Failed to update frozen status";
+        throw new ApiError(errorMsg, response.status, json.code);
+    }
+    // Validate response structure
+    if (!json.data || json.data.user_id === undefined) {
+        throw new ApiError("Invalid frozen status update response: missing required data", response.status);
+    }
+    return json.data;
+}
+/**
+ * Gets user frozen status by user ID.
+ *
+ * @param userId - User ID (open_id) to query frozen status
+ * @param options - Optional configuration for the request
+ * @returns Promise resolving to the user frozen status information
+ * @throws {ConfigurationError} When required environment variables are missing
+ * @throws {ApiError} When API request fails or returns invalid response
+ * @throws {NetworkError} When network request fails
+ *
+ * @example
+ * ```typescript
+ * import { getUserFrozenStatus } from '@tale/client';
+ *
+ * try {
+ *   const status = await getUserFrozenStatus('user_open_id_here');
+ *   console.log('User is frozen:', status.is_frozen);
+ *   console.log('Remark:', status.remark);
+ *   console.log('Last updated:', status.updated_at);
+ * } catch (error) {
+ *   console.error('Failed to get frozen status:', error.message);
+ * }
+ * ```
+ */
+export async function getUserFrozenStatus(userId, options) {
+    // Validate required fields
+    if (!userId || userId.trim() === "") {
+        throw new ApiError("userId is required for getting frozen status", 400, "9400");
+    }
+    // Use provided app token or get one from token service
+    const token = options?.appToken ?? (await getAppToken(options));
+    // Determine base URL
+    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 = String(base).replace(/\/+$/, "") +
+        `/account/v1/user/${encodeURIComponent(userId)}/frozen-status`;
+    let response;
+    try {
+        response = await globalThis.fetch(url, {
+            method: "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`Failed to get user frozen status: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    let json;
+    try {
+        const responseJson = await response.json();
+        json = responseJson;
+    }
+    catch (error) {
+        throw new ApiError(`Failed to parse frozen status response: ${error instanceof Error ? error.message : "Invalid JSON"}`, response.status);
+    }
+    // Handle API errors
+    if (json.code !== 200) {
+        const errorMsg = typeof json.msg === "string" ? json.msg : "Failed to get frozen status";
+        throw new ApiError(errorMsg, response.status, json.code);
+    }
+    // Validate response structure
+    if (!json.data || json.data.user_id === undefined) {
+        throw new ApiError("Invalid frozen status response: missing required data", response.status);
+    }
+    return json.data;
+}

package/dist/user/types.d.ts

@@ -1,9 +1,5 @@
-import type { AppInfo, BaseUser, UserGroup, Role, Privilege, Sort, Pageable, CommonOptions } from "../common/types.js";
-export type { AppInfo, UserGroup, Role, Privilege, Sort, Pageable, CommonOptions, };
-/**
- * User information (uses BaseUser from common types)
- */
-export type User = BaseUser;
+import type { AppInfo, User, UserGroup, Role, Privilege, CommonOptions, PageResponse } from "../common/types.js";
+export type { AppInfo, User, UserGroup, Role, Privilege, CommonOptions, PageResponse, };
 export interface CreateUserRequest {
     username: string;
     password_encrypted?: string;
@@ -76,21 +72,78 @@ export interface UserListItem {
     user_groups: UserGroup[];
     user_attributes?: UserAttribute[];
 }
-export interface ListUsersResponse {
+export interface ListUsersResponse extends PageResponse<UserListItem> {
     content: UserListItem[];
-    pageable: Pageable;
-    last: boolean;
-    totalPages: number;
-    totalElements: number;
-    size: number;
-    number: number;
-    sort: Sort;
-    first: boolean;
-    numberOfElements: number;
-    empty: boolean;
 }
 export interface ListUsersJson {
     data: ListUsersResponse;
     code: number;
     msg: string;
 }
+export interface UpdateUserRequest {
+    username?: string;
+    nick_name?: string;
+    email?: string;
+    phone?: string;
+    remark?: string;
+}
+export interface UpdateUserResponse {
+    success: boolean;
+    user_id: string;
+}
+export interface UpdateUserJson {
+    data?: UpdateUserResponse;
+    code: number;
+    msg: string;
+}
+export interface UpdateUserPasswordRequest {
+    user_id: string;
+    password_encrypted: string;
+}
+export interface UpdateUserPasswordResponse {
+    success: boolean;
+    user_id: string;
+}
+export interface UpdateUserPasswordJson {
+    data?: UpdateUserPasswordResponse;
+    code: number;
+    msg: string;
+}
+export interface UploadAvatarResponse {
+    avatar_oss_key: string;
+}
+export interface UploadAvatarJson {
+    data: UploadAvatarResponse;
+    code: number;
+    msg: string;
+}
+export interface AvatarPresignedUrlResponse {
+    ossKey: string;
+    presignedUrl: string;
+    expireTimeInSeconds: number;
+}
+export interface AvatarPresignedUrlJson {
+    data: AvatarPresignedUrlResponse;
+    code: number;
+    msg: string;
+}
+export interface UpdateUserFrozenStatusRequest {
+    is_frozen: boolean;
+    remark?: string;
+}
+export interface UserFrozenStatusResponse {
+    user_id: string;
+    is_frozen: boolean;
+    remark: string;
+    updated_at: string;
+}
+export interface UpdateUserFrozenStatusJson {
+    data: UserFrozenStatusResponse;
+    code: number;
+    msg: string;
+}
+export interface GetUserFrozenStatusJson {
+    data: UserFrozenStatusResponse;
+    code: number;
+    msg: string;
+}

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

@@ -1,23 +1,23 @@
-import type { Sort, Pageable, CommonOptions } from "../user/types.js";
+import type { CommonOptions } from "../common/types.js";
 export interface UserGroupInfo {
-    group_id: string;
+    groupId: string;
     name: string;
     description?: string;
     type?: string;
     remark?: string;
-    member_count: number;
-    created_at: string;
-    updated_at: string;
+    memberCount: number;
+    createdAt: string;
+    updatedAt: string;
 }
 export interface UserGroupMember {
-    user_id: string;
+    userId: string;
     nickname: string;
     username: string;
     phone: string;
     email: string;
-    avatar_url: string;
-    is_frozen: boolean;
-    created_at: string;
+    avatarUrl: string;
+    isFrozen: boolean;
+    createdAt: string;
     remark: string;
 }
 export interface CreateUserGroupRequest {
@@ -48,14 +48,17 @@ export interface ListUserGroupMembersRequest {
 }
 export interface UserGroupPaginatedResponse<T> {
     content: T[];
-    pageable: Pageable;
-    last: boolean;
-    totalPages: number;
-    totalElements: number;
-    size: number;
-    number: number;
-    sort: Sort;
-    first: boolean;
-    numberOfElements: number;
-    empty: boolean;
+    total: number;
+    pageable: {
+        sort: {
+            orders: Array<{
+                direction: string;
+                property: string;
+                ignoreCase: boolean;
+                nullHandling: string;
+            }>;
+        };
+        pageNumber: number;
+        pageSize: number;
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tale-js-sdk",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Official TypeScript SDK for Tale backend services",
   "keywords": [
     "tale",
@@ -22,6 +22,17 @@
   "author": "Turinhub <dev@turinhub.com>",
   "type": "module",
   "main": "dist/index.js",
+  "scripts": {
+    "test": "pnpm run build && node --env-file=.env --experimental-vm-modules ./node_modules/jest/bin/jest.js",
+    "test:unit": "pnpm run build && node --env-file=.env --experimental-vm-modules ./node_modules/jest/bin/jest.js --testPathIgnorePatterns='integration'",
+    "test:integration": "pnpm run build && node --env-file=.env --experimental-vm-modules ./node_modules/jest/bin/jest.js --testPathPatterns='integration'",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx}\" \"*.json\" \"*.md\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx,js,jsx}\" \"*.json\" \"*.md\"",
+    "docs": "typedoc --entryPoints src/index.ts --out docs",
+    "docs:md": "typedoc --entryPoints src/index.ts --plugin typedoc-plugin-markdown --hideBreadcrumbs --out docs"
+  },
   "devDependencies": {
     "@types/jest": "^30.0.0",
     "jest": "^30.2.0",
@@ -35,14 +46,5 @@
     "dist",
     "README.md",
     "LICENSE"
-  ],
-  "scripts": {
-    "test": "pnpm run build && node --env-file=.env --experimental-vm-modules ./node_modules/jest/bin/jest.js",
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx}\" \"*.json\" \"*.md\"",
-    "format:check": "prettier --check \"src/**/*.{ts,tsx,js,jsx}\" \"*.json\" \"*.md\"",
-    "docs": "typedoc --entryPoints src/index.ts --out docs",
-    "docs:md": "typedoc --entryPoints src/index.ts --plugin typedoc-plugin-markdown --hideBreadcrumbs --out docs"
-  }
-}
+  ]
+}