@turinhub/tale-js-sdk 2.0.0 → 2.1.0

package/README.md

@@ -23,16 +23,90 @@ yarn add @turinhub/tale-js-sdk
 本 SDK 采用 ESM（`type: module`）。在 TypeScript 或现代 Node.js/前端环境中可直接导入：
 
 ```ts
-// 具体导出以实际 SDK 为准（后续文档将补充）
-import * as Tale from "@turinhub/tale-js-sdk";
+import {
+  getAppToken,
+  getCurrentUser,
+  listAppsByOrg,
+  listFiles,
+} from "@turinhub/tale-js-sdk";
+
+const appToken = await getAppToken({
+  baseUrl: "https://api.tale.example",
+  appKey: process.env.TALE_APP_KEY,
+  appSecret: process.env.TALE_APP_SECRET,
+});
+
+const files = await listFiles({
+  baseUrl: "https://api.tale.example",
+  appToken,
+  folderId: "folder-id",
+});
+
+const currentUser = await getCurrentUser({
+  baseUrl: "https://api.tale.example",
+  taleToken: "tale-user-token",
+});
+
+const apps = await listAppsByOrg(currentUser.app.orgId, {
+  baseUrl: "https://api.tale.example",
+  taleToken: "tale-user-token",
+});
+```
+
+## 认证与 Token
+
+SDK 中常见的鉴权选项都通过 `x-t-token` 发送到 Tale 后端：
+
+- `appToken`：应用作用域 Token，适用于 CMS、RBAC、ACL、Task、Attachment 等应用内资源 API。
+- `taleToken`：Tale 用户 Token，适用于平台级 App 管理 API，例如获取当前用户、应用列表、应用详情、App Secret，以及按 App Key 换发 App Token。
+- `baseUrl`：Tale 后端服务基础 URL；未显式传入时会读取环境变量。
+
+服务端可使用 `getAppToken()` 通过 `TALE_APP_KEY` 与 `TALE_APP_SECRET` 获取应用 Token。浏览器端的 Cookie、缓存、自动续期和多应用切换策略不由 SDK 核心管理，调用方可基于 `issueAppToken()` 自行封装。
+
+## App 与 App Token API
 
-// 示例：初始化客户端并调用 API（占位示例）
-// const client = Tale.createClient({ baseUrl: 'https://api.tale.example' })
-// const result = await client.health()
-// console.log(result)
+AppTS 模块提供平台应用相关方法：
+
+```ts
+import {
+  getCurrentUser,
+  listAppsByOrg,
+  createApp,
+  getAppDetail,
+  updateApp,
+} from "@turinhub/tale-js-sdk";
+```
+
+AppTokenTS 模块提供 App Token 相关接口封装：
+
+```ts
+import {
+  listAppTokens,
+  getAppSecret,
+  issueAppToken,
+} from "@turinhub/tale-js-sdk";
+
+const page = await listAppTokens({
+  baseUrl: "https://api.tale.example",
+  appToken: "app-token",
+  page: 0,
+  size: 20,
+  isValid: true,
+});
+
+const secret = await getAppSecret("oa_xxx", {
+  baseUrl: "https://api.tale.example",
+  taleToken: "tale-user-token",
+});
+
+const issued = await issueAppToken({
+  baseUrl: "https://api.tale.example",
+  taleToken: "tale-user-token",
+  appKey: "oa_xxx",
+});
 ```
 
-> 提示：由于 SDK 仍在迭代中，具体 API 名称与调用方式请以后续文档或源码为准。
+公开类型、入参和响应字段保持 camelCase。SDK 会处理 Java 后端可能返回的 `{ code, msg, data }` envelope 与直接 payload，但不再兼容历史 snake_case 响应字段。
 
 ## 开发与测试
 
@@ -40,7 +114,10 @@ import * as Tale from "@turinhub/tale-js-sdk";
 
 ```bash
 pnpm install   # 或 npm install / yarn
-pnpm test      # 对应 package.json 中的 "test": "jest"
+pnpm run typecheck
+pnpm run build
+pnpm run test:unit
+pnpm test
 ```
 
 ## 更新日志与版本

package/dist/app/index.d.ts

@@ -0,0 +1,10 @@
+import type { AppDetail, AppInfo, AppUserLike, CommonOptions, CreateAppRequest, CreateAppResponse, CurrentAppUser, UpdateAppRequest } from "./types.js";
+export type { AppDetail, AppDetailResponse, AppInfo, AppPrivilege, AppRole, AppUserLike, CommonOptions, CreateAppRequest, CreateAppResponse, CurrentAppUser, UpdateAppRequest, } from "./types.js";
+export declare function normalizeAppInfo(value: unknown): AppInfo;
+export declare function normalizeAppDetail(value: unknown): AppDetail;
+export declare function normalizeCurrentAppUser(value: unknown): CurrentAppUser;
+export declare function getCurrentUser(options?: CommonOptions): Promise<AppUserLike>;
+export declare function listAppsByOrg(orgId: string, options?: CommonOptions): Promise<AppInfo[]>;
+export declare function createApp(request: CreateAppRequest, options?: CommonOptions): Promise<CreateAppResponse>;
+export declare function getAppDetail(appKey: string, options?: CommonOptions): Promise<AppDetail>;
+export declare function updateApp(request: UpdateAppRequest, options?: CommonOptions): Promise<AppDetail>;

package/dist/app/index.js

@@ -0,0 +1,198 @@
+import { assertRequiredString, pickBoolean, pickString, requestJson, toRecord, } from "../common/http.js";
+function normalizeRole(value) {
+    const role = toRecord(value);
+    return {
+        roleId: pickString(role.roleId),
+        roleName: pickString(role.roleName),
+        roleType: pickString(role.roleType) || undefined,
+        roleProperty: toRecord(role.roleProperty),
+        roleConfig: toRecord(role.roleConfig),
+        rolePrivileges: Array.isArray(role.rolePrivileges)
+            ? role.rolePrivileges.map(normalizePrivilege)
+            : undefined,
+        privilegeIds: Array.isArray(role.privilegeIds)
+            ? role.privilegeIds.map(String)
+            : undefined,
+        resourceIds: Array.isArray(role.resourceIds)
+            ? role.resourceIds.map(String)
+            : undefined,
+        expiredAt: pickString(role.expiredAt) || undefined,
+        remark: pickString(role.remark) || undefined,
+    };
+}
+function normalizePrivilege(value) {
+    const privilege = toRecord(value);
+    return {
+        privilegeId: pickString(privilege.privilegeId),
+        privilegeName: pickString(privilege.privilegeName),
+        privilegeType: pickString(privilege.privilegeType) || undefined,
+        privilegeProperty: toRecord(privilege.privilegeProperty),
+        privilegeConfig: toRecord(privilege.privilegeConfig),
+        resourceIds: Array.isArray(privilege.resourceIds)
+            ? privilege.resourceIds.map(String)
+            : undefined,
+        expiredAt: pickString(privilege.expiredAt) || undefined,
+        remark: pickString(privilege.remark) || undefined,
+    };
+}
+function normalizeUserGroup(value) {
+    const group = toRecord(value);
+    return {
+        groupId: pickString(group.groupId),
+        name: pickString(group.name, group.groupName),
+        description: pickString(group.description) || undefined,
+        type: pickString(group.type) || undefined,
+        remark: pickString(group.remark) || undefined,
+    };
+}
+export function normalizeAppInfo(value) {
+    const app = toRecord(value);
+    const appKey = pickString(app.appKey);
+    const appName = pickString(app.appName, app.name);
+    const appId = pickString(app.appId, app.id);
+    return {
+        appId,
+        appKey,
+        appName,
+        id: pickString(app.id, appId, appKey),
+        name: pickString(app.name, appName, appKey),
+        description: pickString(app.description, app.remark) || undefined,
+        icon: pickString(app.icon) || undefined,
+        plan: pickString(app.plan) || undefined,
+        orgId: pickString(app.orgId) || undefined,
+        appProperty: toRecord(app.appProperty),
+        appConfig: toRecord(app.appConfig),
+        appAdmins: toRecord(app.appAdmins),
+        roleConfig: toRecord(app.roleConfig),
+        userGroupConfig: toRecord(app.userGroupConfig),
+        createdAt: pickString(app.createdAt) || undefined,
+        updatedAt: pickString(app.updatedAt) || undefined,
+        remark: pickString(app.remark) || undefined,
+    };
+}
+function normalizeAppRole(value) {
+    return normalizeRole(value);
+}
+function normalizeAppPrivilege(value) {
+    return normalizePrivilege(value);
+}
+export function normalizeAppDetail(value) {
+    const app = toRecord(value);
+    const info = normalizeAppInfo(app);
+    return {
+        ...info,
+        appRoles: Array.isArray(app.appRoles)
+            ? app.appRoles.map(normalizeAppRole)
+            : [],
+        appPrivileges: Array.isArray(app.appPrivileges)
+            ? app.appPrivileges.map(normalizeAppPrivilege)
+            : [],
+        wechatConfig: toRecord(app.wechatConfig),
+        feishuConfig: toRecord(app.feishuConfig),
+        openaiConfig: toRecord(app.openaiConfig),
+    };
+}
+export function normalizeCurrentAppUser(value) {
+    const payload = toRecord(value);
+    const app = toRecord(payload.app);
+    const user = toRecord(payload.user);
+    return {
+        app: {
+            appName: pickString(app.appName),
+            appKey: pickString(app.appKey),
+            orgId: pickString(app.orgId, payload.orgId),
+            appId: pickString(app.appId),
+        },
+        user: {
+            latestLoginTime: pickString(user.latestLoginTime) || undefined,
+            registeredAt: pickString(user.registeredAt) || undefined,
+            isFrozen: pickBoolean(user.isFrozen),
+            userId: pickString(user.userId, payload.userId),
+            phone: pickString(user.phone) || undefined,
+            username: pickString(user.username) || undefined,
+            email: pickString(user.email) || undefined,
+            nickname: pickString(user.nickname) || undefined,
+            remark: pickString(user.remark) || undefined,
+            avatarUrl: pickString(user.avatarUrl) || undefined,
+        },
+        thirdParty: toRecord(payload.thirdParty),
+        userRoles: Array.isArray(payload.userRoles)
+            ? payload.userRoles.map(normalizeRole)
+            : [],
+        userPrivileges: Array.isArray(payload.userPrivileges)
+            ? payload.userPrivileges.map(normalizePrivilege)
+            : [],
+        userGroups: Array.isArray(payload.userGroups)
+            ? payload.userGroups.map(normalizeUserGroup)
+            : [],
+    };
+}
+function normalizeCreateAppResponse(value) {
+    const app = toRecord(value);
+    return {
+        appId: pickString(app.appId, app.id),
+        appName: pickString(app.appName, app.name),
+        orgId: pickString(app.orgId),
+        appKey: pickString(app.appKey),
+        createdAt: pickString(app.createdAt) || undefined,
+    };
+}
+function toUpdateAppPayload(request) {
+    return {
+        appId: request.appId,
+        appName: request.appName,
+        remark: request.remark,
+        appProperty: request.appProperty,
+        appConfig: request.appConfig,
+        wechatConfig: request.wechatConfig,
+        appAdmins: request.appAdmins,
+        roleConfig: request.roleConfig,
+        userGroupConfig: request.userGroupConfig,
+        feishuConfig: request.feishuConfig,
+        openaiConfig: request.openaiConfig,
+    };
+}
+export async function getCurrentUser(options) {
+    const payload = await requestJson("/account/v2/user", options, {
+        authMode: "taleToken",
+        errorMessage: "Failed to get current user",
+    });
+    return normalizeCurrentAppUser(payload);
+}
+export async function listAppsByOrg(orgId, options) {
+    assertRequiredString(orgId, "orgId");
+    const payload = await requestJson(`/app/v2/org/${encodeURIComponent(orgId)}/apps`, options, {
+        authMode: "taleToken",
+        errorMessage: "Failed to list apps",
+    });
+    return Array.isArray(payload) ? payload.map(normalizeAppInfo) : [];
+}
+export async function createApp(request, options) {
+    assertRequiredString(request?.appName, "appName");
+    assertRequiredString(request?.orgId, "orgId");
+    const payload = await requestJson("/app/v2/app", options, {
+        method: "POST",
+        body: request,
+        authMode: "taleToken",
+        errorMessage: "Failed to create app",
+    });
+    return normalizeCreateAppResponse(payload);
+}
+export async function getAppDetail(appKey, options) {
+    assertRequiredString(appKey, "appKey");
+    const payload = await requestJson(`/app/v2/app/${encodeURIComponent(appKey)}`, options, {
+        authMode: "taleToken",
+        errorMessage: "Failed to get app detail",
+    });
+    return normalizeAppDetail(payload);
+}
+export async function updateApp(request, options) {
+    assertRequiredString(request?.appId, "appId");
+    const payload = await requestJson("/app/v2/app", options, {
+        method: "PUT",
+        body: toUpdateAppPayload(request),
+        authMode: "taleToken",
+        errorMessage: "Failed to update app",
+    });
+    return normalizeAppDetail(payload);
+}

package/dist/app/types.d.ts

@@ -0,0 +1,101 @@
+import type { CommonOptions, Privilege, Role, UserGroup } from "../common/types.js";
+export type { CommonOptions, Privilege, Role, UserGroup };
+export interface AppInfo {
+    appId: string;
+    appKey: string;
+    appName: string;
+    id: string;
+    name: string;
+    description?: string;
+    icon?: string;
+    plan?: string;
+    orgId?: string;
+    appProperty?: Record<string, unknown>;
+    appConfig?: Record<string, unknown>;
+    appAdmins?: Record<string, unknown>;
+    roleConfig?: Record<string, unknown>;
+    userGroupConfig?: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+    remark?: string;
+}
+export interface CreateAppRequest {
+    appName: string;
+    orgId: string;
+    remark?: string;
+}
+export interface CreateAppResponse {
+    appId: string;
+    appName: string;
+    orgId: string;
+    appKey: string;
+    createdAt?: string;
+}
+export interface UpdateAppRequest {
+    appId: string;
+    appName?: string;
+    remark?: string;
+    appProperty?: Record<string, unknown>;
+    appConfig?: Record<string, unknown>;
+    wechatConfig?: Record<string, unknown>;
+    appAdmins?: Record<string, unknown>;
+    roleConfig?: Record<string, unknown>;
+    userGroupConfig?: Record<string, unknown>;
+    feishuConfig?: Record<string, unknown>;
+    openaiConfig?: Record<string, unknown>;
+}
+export interface AppRole {
+    roleId: string;
+    roleName: string;
+    roleType?: string;
+    roleProperty?: Record<string, unknown>;
+    roleConfig?: Record<string, unknown>;
+    expiredAt?: string;
+    remark?: string;
+}
+export interface AppPrivilege {
+    privilegeId: string;
+    privilegeName: string;
+    privilegeType?: string;
+    privilegeProperty?: Record<string, unknown>;
+    privilegeConfig?: Record<string, unknown>;
+    expiredAt?: string;
+    remark?: string;
+}
+export interface AppDetail extends AppInfo {
+    appRoles: AppRole[];
+    appPrivileges: AppPrivilege[];
+    wechatConfig?: Record<string, unknown>;
+    feishuConfig?: Record<string, unknown>;
+    openaiConfig?: Record<string, unknown>;
+}
+export interface AppDetailResponse {
+    data: AppDetail;
+    code: number;
+    msg: string;
+}
+export interface CurrentAppUser {
+    app: {
+        appName: string;
+        appKey: string;
+        orgId: string;
+        appId: string;
+    };
+    user: {
+        latestLoginTime?: string;
+        registeredAt?: string;
+        isFrozen?: boolean;
+        userId: string;
+        phone?: string;
+        username?: string;
+        email?: string;
+        nickname?: string;
+        remark?: string;
+        avatarUrl?: string;
+    };
+    thirdParty: Record<string, unknown>;
+    userRoles: Role[];
+    userPrivileges: Privilege[];
+    userGroups: UserGroup[];
+}
+export type AppUserLike = CurrentAppUser;

package/dist/app/types.js

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

package/dist/app-token/index.d.ts

@@ -0,0 +1,7 @@
+import type { PageResponse } from "../common/types.js";
+import type { AppToken, CommonOptions, IssueAppTokenRequest, IssueAppTokenResponse, ListAppTokensRequest } from "./types.js";
+export type { AppSecretResponse, AppToken, CommonOptions, IssueAppTokenRequest, IssueAppTokenResponse, ListAppTokensRequest, PageResponse, } from "./types.js";
+export declare function normalizeAppToken(value: unknown): AppToken;
+export declare function listAppTokens(request?: ListAppTokensRequest & CommonOptions): Promise<PageResponse<AppToken>>;
+export declare function getAppSecret(appKey: string, options?: CommonOptions): Promise<string>;
+export declare function issueAppToken(request: IssueAppTokenRequest): Promise<IssueAppTokenResponse>;

package/dist/app-token/index.js

@@ -0,0 +1,58 @@
+import { assertRequiredString, normalizePageResponse, pickString, requestJson, toRecord, } from "../common/http.js";
+export function normalizeAppToken(value) {
+    const token = toRecord(value);
+    return {
+        type: pickString(token.type),
+        appKey: pickString(token.appKey),
+        token: pickString(token.token),
+        status: pickString(token.status),
+        expiredAt: pickString(token.expiredAt),
+    };
+}
+function toListQuery(request) {
+    if (!request) {
+        return undefined;
+    }
+    const sortProperty = request.sort === "expiredAt" ? "expiredTime" : request.sort;
+    const sort = sortProperty && request.sortDirection
+        ? `${sortProperty},${request.sortDirection}`
+        : sortProperty;
+    return {
+        page: request.page,
+        size: request.size,
+        isValid: request.isValid,
+        sort,
+        search: request.search,
+    };
+}
+export async function listAppTokens(request) {
+    const { appToken, taleToken, baseUrl, ...listRequest } = request ?? {};
+    const payload = await requestJson("/app/v2/app/tokens", request, {
+        query: toListQuery(listRequest),
+        errorMessage: "Failed to list app tokens",
+    });
+    return normalizePageResponse(payload, normalizeAppToken);
+}
+export async function getAppSecret(appKey, options) {
+    assertRequiredString(appKey, "appKey");
+    const payload = await requestJson(`/app/v2/app/${encodeURIComponent(appKey)}/secret`, options, {
+        authMode: "taleToken",
+        errorMessage: "Failed to get app secret",
+    });
+    const response = toRecord(payload);
+    const appSecret = pickString(response.appSecret);
+    if (!appSecret) {
+        return pickString(payload);
+    }
+    return appSecret;
+}
+export async function issueAppToken(request) {
+    assertRequiredString(request?.appKey, "appKey");
+    const { appKey, ...options } = request;
+    const payload = await requestJson("/app/v2/token/by-appkey", options, {
+        query: { appKey },
+        authMode: "taleToken",
+        errorMessage: "Failed to issue app token",
+    });
+    return normalizeAppToken(payload);
+}

package/dist/app-token/types.d.ts

@@ -0,0 +1,25 @@
+import type { CommonOptions } from "../common/types.js";
+export type { CommonOptions, PageResponse } from "../common/types.js";
+export interface AppToken {
+    type: string;
+    appKey: string;
+    token: string;
+    status: string;
+    expiredAt: string;
+}
+export interface ListAppTokensRequest {
+    page?: number;
+    size?: number;
+    isValid?: boolean;
+    sort?: string;
+    sortDirection?: "asc" | "desc" | "ASC" | "DESC";
+    search?: string;
+}
+export interface AppSecretResponse {
+    appSecret: string;
+}
+export interface IssueAppTokenRequest extends CommonOptions {
+    appKey: string;
+}
+export interface IssueAppTokenResponse extends AppToken {
+}

package/dist/app-token/types.js

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

package/dist/common/http.d.ts

@@ -0,0 +1,17 @@
+import type { CommonOptions, PageResponse } from "./types.js";
+type AuthMode = "appToken" | "taleToken";
+export declare function toRecord(value: unknown): Record<string, unknown>;
+export declare function pickString(...values: unknown[]): string;
+export declare function pickBoolean(...values: unknown[]): boolean | undefined;
+export declare function pickNumber(...values: unknown[]): number | undefined;
+export declare function assertRequiredString(value: string | undefined, fieldName: string): asserts value is string;
+export declare function getBaseUrl(options?: CommonOptions): string;
+export declare function requestJson<T>(path: string, options: CommonOptions | undefined, config: {
+    method?: string;
+    body?: unknown;
+    query?: Record<string, unknown>;
+    authMode?: AuthMode;
+    errorMessage: string;
+}): Promise<T>;
+export declare function normalizePageResponse<T>(value: unknown, normalizeItem: (item: unknown) => T): PageResponse<T>;
+export {};

package/dist/common/http.js

@@ -0,0 +1,141 @@
+import { getAppToken } from "../token.js";
+import { ApiError, ConfigurationError, NetworkError } from "../errors.js";
+export function toRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+export function pickString(...values) {
+    for (const value of values) {
+        if (typeof value === "string" && value.trim()) {
+            return value;
+        }
+    }
+    return "";
+}
+export function pickBoolean(...values) {
+    for (const value of values) {
+        if (typeof value === "boolean") {
+            return value;
+        }
+    }
+    return undefined;
+}
+export function pickNumber(...values) {
+    for (const value of values) {
+        if (typeof value === "number" && Number.isFinite(value)) {
+            return value;
+        }
+    }
+    return undefined;
+}
+export function assertRequiredString(value, fieldName) {
+    if (!value || value.trim() === "") {
+        throw new ApiError(`${fieldName} is required`, 400, "9400");
+    }
+}
+export function getBaseUrl(options) {
+    const env = globalThis?.process?.env ?? import.meta?.env ?? undefined;
+    const base = options?.baseUrl ??
+        env?.TALE_BASE_URL ??
+        env?.NEXT_PUBLIC_TALE_BASE_URL ??
+        undefined;
+    if (!base) {
+        throw new ConfigurationError("Missing required environment variable: TALE_BASE_URL");
+    }
+    return String(base).replace(/\/+$/, "");
+}
+function unwrapApiResponse(json, errorMessage, statusCode) {
+    if (typeof json !== "object" || json === null) {
+        throw new ApiError(`Invalid response: ${errorMessage} - not an object`, statusCode);
+    }
+    const response = json;
+    if ("code" in response && response.code !== 200 && response.code !== "200") {
+        const errorMsg = typeof response.msg === "string" ? response.msg : errorMessage;
+        throw new ApiError(errorMsg, statusCode, String(response.code));
+    }
+    if ("data" in response) {
+        if (response.data === undefined || response.data === null) {
+            throw new ApiError(`Invalid response: ${errorMessage} - missing data`, statusCode);
+        }
+        return response.data;
+    }
+    return json;
+}
+async function resolveToken(options, authMode) {
+    if (authMode === "taleToken") {
+        const taleToken = options?.taleToken;
+        if (!taleToken) {
+            throw new ConfigurationError("Missing required option: taleToken");
+        }
+        return taleToken;
+    }
+    return options?.appToken ?? (await getAppToken(options));
+}
+export async function requestJson(path, options, config) {
+    const token = await resolveToken(options, config.authMode ?? "appToken");
+    const url = new URL(getBaseUrl(options) + path);
+    Object.entries(config.query ?? {}).forEach(([key, value]) => {
+        if (value !== undefined && value !== null) {
+            url.searchParams.append(key, String(value));
+        }
+    });
+    let response;
+    try {
+        response = await globalThis.fetch(url.toString(), {
+            method: config.method ?? "GET",
+            headers: {
+                "Content-Type": "application/json",
+                "x-t-token": token,
+            },
+            body: config.body === undefined ? undefined : JSON.stringify(config.body),
+        });
+    }
+    catch (error) {
+        throw new NetworkError(`${config.errorMessage}: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+    let json;
+    try {
+        json = await response.json();
+    }
+    catch (error) {
+        throw new ApiError(`Failed to parse response: ${error instanceof Error ? error.message : "Invalid JSON"}`, response.status);
+    }
+    return unwrapApiResponse(json, config.errorMessage, response.status);
+}
+export function normalizePageResponse(value, normalizeItem) {
+    const page = toRecord(value);
+    const sort = toRecord(page.sort);
+    const content = Array.isArray(page.content)
+        ? page.content.map(normalizeItem)
+        : [];
+    const size = pickNumber(page.size) ?? content.length;
+    const currentPage = pickNumber(page.page) ?? 0;
+    const total = pickNumber(page.total) ?? content.length;
+    const totalPages = pickNumber(page.totalPages) ??
+        (size > 0 ? Math.ceil(total / size) : 0);
+    const orders = Array.isArray(sort.orders)
+        ? sort.orders
+        : Array.isArray(page.sort)
+            ? page.sort
+            : [];
+    return {
+        content,
+        total,
+        page: currentPage,
+        totalPages,
+        size,
+        numberOfElements: pickNumber(page.numberOfElements) ?? content.length,
+        first: pickBoolean(page.first) ?? currentPage === 0,
+        last: pickBoolean(page.last) ?? currentPage + 1 >= totalPages,
+        empty: pickBoolean(page.empty) ?? content.length === 0,
+        sort: orders.map((order) => {
+            const item = toRecord(order);
+            const direction = pickString(item.direction).toUpperCase();
+            return {
+                property: pickString(item.property),
+                direction: direction === "ASC" ? "ASC" : "DESC",
+            };
+        }),
+    };
+}

package/dist/common/types.d.ts

@@ -1,6 +1,7 @@
 export interface CommonOptions {
     baseUrl?: string;
     appToken?: string;
+    taleToken?: string;
 }
 /**
  * Pagination response format used by Tale backend (PageResponseVO)
@@ -53,12 +54,22 @@ export interface AppInfo {
     appId: string;
     appKey: string;
     appName: string;
+    id?: string;
+    name?: string;
+    description?: string;
+    icon?: string;
+    plan?: string;
+    orgId?: string;
     appProperty?: Record<string, unknown>;
+    appConfig?: Record<string, unknown>;
     appRoles?: unknown[];
     appPrivileges?: unknown[];
     appAdmins?: Record<string, unknown>;
     roleConfig?: Record<string, unknown>;
     userGroupConfig?: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+    remark?: string;
 }
 export interface User {
     userId: string;

package/dist/index.d.ts

@@ -11,6 +11,8 @@ export * from "./task/index.js";
 export * from "./cms/index.js";
 export * from "./attachment/index.js";
 export * from "./attachment-type/index.js";
+export * from "./app/index.js";
+export * from "./app-token/index.js";
 export * from "./errors.js";
 export type { CommonOptions, PageResponse, UserGroup, Role, Privilege, AppInfo, User, } from "./common/types.js";
 export type { Attachment, AttachmentRefType, ListAttachmentsByRefRequest, UploadAttachmentRequest, UploadAuthorizationRequest, CompleteUploadRequest, DeleteAttachmentRequest, DownloadAttachmentUrlRequest, DownloadUrlResponse, AttachmentOptions, } from "./attachment/types.js";

package/dist/index.js

@@ -11,4 +11,6 @@ export * from "./task/index.js";
 export * from "./cms/index.js";
 export * from "./attachment/index.js";
 export * from "./attachment-type/index.js";
+export * from "./app/index.js";
+export * from "./app-token/index.js";
 export * from "./errors.js";

package/dist/status.js

@@ -2,21 +2,21 @@ import pkg from "../package.json" with { type: "json" };
 import { getAppToken, ConfigurationError, ApiError, NetworkError, } from "./token.js";
 function normalizeStatusData(data) {
     return {
-        serviceName: data?.serviceName ?? data?.service_name,
-        hostName: data?.hostName ?? data?.host_name,
+        serviceName: data?.serviceName,
+        hostName: data?.hostName,
     };
 }
 function normalizeAppInfoData(data) {
     return {
-        appId: data?.appId ?? data?.app_id,
-        appKey: data?.appKey ?? data?.app_key,
-        appName: data?.appName ?? data?.app_name,
-        appProperty: data?.appProperty ?? data?.app_property ?? {},
-        appRoles: data?.appRoles ?? data?.app_roles ?? [],
-        appPrivileges: data?.appPrivileges ?? data?.app_privileges ?? [],
-        appAdmins: data?.appAdmins ?? data?.app_admins ?? {},
-        roleConfig: data?.roleConfig ?? data?.role_config ?? {},
-        userGroupConfig: data?.userGroupConfig ?? data?.user_group_config ?? {},
+        appId: data?.appId,
+        appKey: data?.appKey,
+        appName: data?.appName,
+        appProperty: data?.appProperty ?? {},
+        appRoles: data?.appRoles ?? [],
+        appPrivileges: data?.appPrivileges ?? [],
+        appAdmins: data?.appAdmins ?? {},
+        roleConfig: data?.roleConfig ?? {},
+        userGroupConfig: data?.userGroupConfig ?? {},
         remark: data?.remark ?? "",
     };
 }

package/package.json

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