finej3 1.0.14 → 2.0.0

package/dist/cjs/types/client.d.ts

@@ -0,0 +1,239 @@
+import type { Jx3Envelope } from '../core/http.js';
+/** 新版 HTTP 接口响应类型：依据官方 schema 及 2026-11-13 多角色、多参数实测；保留原始字段名。 */
+/** 阵营事件；依据新版接口实测响应。 */
+export interface CampHistoryData {
+    items: Array<{
+        _id: string;
+        book_id: number;
+        center_id: number;
+        content: string;
+        extras: {
+            ERCarrier?: number;
+            HQCarrier?: number;
+            Top10TongER?: Array<string | Array<number | string>>;
+            Top10TongHQ?: Array<string | Array<number | string>>;
+            WinCamp: number;
+            Winresult: number | string;
+        };
+        global_id_list: Array<string>;
+        map_id: number;
+        time: number;
+        type: number;
+    }>;
+    next_cursor: string;
+    query: {
+        book_id: number;
+        center_id: number;
+        cursor: string;
+        limit: number;
+        map_id: number;
+        month: number;
+        types: Array<number>;
+        year: number;
+    };
+}
+/** 据点历史；依据新版接口实测响应。 */
+export interface CastleHistoryData {
+    items: Array<{
+        _id: string;
+        book_id: number;
+        center_id: number;
+        content: string;
+        extras: {
+            Camp: number;
+            ContribTop?: Array<{
+                byForceID: number;
+                byLevel: number;
+                dwMiniAvatarID: number;
+                nContribution: number;
+                nRank: number;
+                szGlobalRoleID: string;
+                szName: string;
+                szTongName: string;
+            }>;
+            CostPiece?: number;
+            Event: number;
+            RepairCount?: number;
+            TongID: number;
+            TongName: string;
+            UpgradeCount?: number;
+        };
+        global_id_list: Array<string>;
+        map_id: number;
+        time: number;
+        type: number;
+    }>;
+    next_cursor: string;
+    query: {
+        book_id: number;
+        center_id: number;
+        cursor: string;
+        limit: number;
+        map_id: number;
+        month: number;
+        types: Array<number>;
+        year: number;
+    };
+}
+/** 万宝楼；依据新版接口实测响应。 */
+export interface CookieData {
+    client: {
+        game_id: string;
+        request_type: number;
+        role_id: string;
+        signed_at: number;
+        token: string;
+    };
+    server: string;
+    time: number;
+    zone: string;
+}
+/** 设计站；依据新版接口实测响应。 */
+export interface DesignData {
+    rank_list: Array<{
+        body_type: number;
+        cover: string;
+        cover_md5: string;
+        cover_size_type?: number;
+        desc: string;
+        face_type?: number;
+        file_link: string;
+        file_md5: string;
+        force_id?: number;
+        heat: number;
+        is_creator: number;
+        name: string;
+        open_status: number;
+        photo_map_id?: number;
+        photo_map_type?: number;
+        reward: number;
+        share_id: string;
+        tags: string;
+        upload_source: string;
+        user: string;
+        version: number;
+    }>;
+    request_id: string;
+    session_id: string;
+    total_row: number;
+}
+/** 交易行；依据新版接口实测响应。 */
+export interface ClientTradeItemSearchData {
+    aItems: Array<{
+        CRC: number;
+        ID: number;
+        Item: {
+            dwSkillID: number;
+            nBindType: number;
+            nDetail: number;
+            nGenre: number;
+            nLevel: number;
+            nMaxDurability: number;
+            nQuality: number;
+            nStackNum: number;
+            nSub: number;
+            nUiId: number;
+            nVersion: number;
+            szName: string;
+        };
+        LastDurationTime: number;
+        LeftTime: number;
+        Price: {
+            nCopper: number;
+            nGold: number;
+            nSilver: number;
+        };
+        SellerName: string;
+        SellerNum: number;
+        StackNum: number;
+    }>;
+    nCount: number;
+    nPages: number;
+}
+/** 角色名片。 */
+export interface ShowCard {
+    cacheTime: number;
+    fileName: string;
+    globalRoleId: string;
+    roleId: string;
+    roleName: string;
+    serverName: string;
+    showActive: boolean;
+    showAvatar: string;
+    showHash: string;
+    showIndex: number;
+    showLike: number;
+    zoneName: string;
+}
+/** 名片列表；依据新版接口实测响应。 */
+export interface ShowCardHistoryItem {
+    cacheTime: number;
+    fileName: string;
+    globalRoleId: string;
+    roleId: string;
+    roleName: string;
+    serverName: string;
+    showActive: boolean;
+    showAvatar: string;
+    showHash: string;
+    showIndex: number;
+    showLike: number;
+    zoneName: string;
+}
+/** 装备详情；依据新版接口实测响应。 */
+export interface RoleEquipListData {
+    dwForceID: number;
+    dwSchoolID: number;
+    dwTongID: number;
+    globalRoleId: string;
+    nCamp: number;
+    nLevel: number;
+    nRoleType: number;
+    roleId: string;
+    roleName: string;
+    serverName: string;
+    szName: string;
+    szTongName: string;
+    zoneName: string;
+}
+/** 角色在线；依据新版接口实测响应。 */
+export interface RoleOnlineStatus {
+    appOnline: boolean;
+    gameOnline: boolean;
+    globalRoleId: string;
+    maintenance: boolean;
+    onlineStatus: boolean;
+    responded: boolean;
+    roleId: string;
+    roleName: string;
+    serverName: string;
+    zoneName: string;
+}
+/** 副本记录；依据新版接口实测响应。 */
+export interface RaidProgress {
+    bossCount: number;
+    bossFinished: number;
+    bossProgress: Array<{
+        finished: boolean;
+        index: number;
+        name: string;
+        progressId: number;
+    }>;
+    mapId: number;
+    mapName: string;
+    seasonName: string;
+}
+/** 批量查询的单角色结果；失败时 detail 是错误字符串，使用 isSuccess 逐项判断。 */
+export type ClientBatchResult<T> = Jx3Envelope<T> & {
+    params: RoleRef;
+    submit: string;
+};
+/** 批量查询结果，单角色失败不改变外层成功状态。 */
+export type RolesOnlineStatusData = Array<ClientBatchResult<RoleOnlineStatus>>;
+/** 批量查询结果，单角色失败不改变外层成功状态。 */
+export type RolesRaidRecordsData = Array<ClientBatchResult<RaidProgress[]>>;
+/** 批量查询中的角色标识；请求至少包含一项。 */
+export interface RoleRef {
+    server: string;
+    name: string;
+}