finej3 1.0.15 → 2.1.0

package/dist/esm/clients/main.d.ts

@@ -1,548 +1,443 @@
-import { HttpClient, type Jx3Envelope, type Jx3Options } from '../core/http.js';
+import { HttpClient, type Jx3Envelope, type Jx3Options, type EmptyObject } from '../core/http.js';
 import type * as T from '../types/main.js';
-/** 主站官方地址 */
-export declare const MAIN_BASE_URL = "https://seasun.nicemoe.cn";
-/**
- * JX3API 主站客户端（seasun.nicemoe.cn，GET + query）。
- *
- * - 响应信封 `{ code, msg, data, time }` 原样返回，不解包、业务错误不抛异常（自行判断 code）。
- * - 所有方法自动注入 token；推栏相关方法自动注入配置中的 ticket（可在参数中覆盖）。
- * - 榜单类接口 server 为可选筛选条件：指定 server 时 data 为单个对象，
- *   不指定时 data 为数组（已用方法重载表达）。
- * - 传 `baseUrl` 可指向自建代理 / 镜像，缺省用 {@link MAIN_BASE_URL}。
- */
+import type { RaidProgress } from '../types/client.js';
+/** 新版主站服务入口。 */
+export declare const MAIN_BASE_URL = "https://nico.nicemoe.cn";
+/** 响应保留 { status, detail }；使用 isSuccess 判断成功后读取业务数据。 */
 export declare class Jx3Api extends HttpClient {
-    constructor(options: Jx3Options);
-    /**
-     * 活动日历：单日日常活动推演。`num` 为天数偏移（0=今天，最大 15）。
-     *
-     * 返回的 `draw` / `leader` 按该日星期决定有无（`draw` 见于周三/五/六/日，
-     * `leader` 见于周三/五），访问前需判空。
-     */
-    activeCalendar(params?: {
+    constructor(options?: Jx3Options);
+    /** 活动日历。查询每日活动安排及本周秘境、副本信息。 */
+    activeCalendar(params: {
+        mode: 'list';
         num?: number;
+    }): Promise<Jx3Envelope<T.ActiveCalendarList | EmptyObject>>;
+    activeCalendar(params?: {
         mode?: 'day';
-    }): Promise<Jx3Envelope<T.ActiveCalendarDay>>;
-    /**
-     * 活动日历：前后区间日常活动推演。`num` 为区间半径（最大 15）。
-     * 条目**不含** `weekly` 字段，且 `war` 不带 "大战！" 前缀。
-     */
+        num?: number;
+    }): Promise<Jx3Envelope<T.ActiveCalendarDay | EmptyObject>>;
     activeCalendar(params: {
+        mode?: 'day' | 'list';
         num?: number;
-        mode: 'list';
-    }): Promise<Jx3Envelope<T.ActiveCalendarList>>;
-    /** 地图活动：楚天社 / 云从社 / 披风会接下来 10 条排期 */
+    }): Promise<Jx3Envelope<T.ActiveCalendarDay | T.ActiveCalendarList | EmptyObject>>;
+    /** 地图活动。查询指定地图活动当前及后续的 10 条安排，时间为北京时间。 */
     activeCelebs(params: {
-        name: string;
-    }): Promise<Jx3Envelope<T.CelebActivity[]>>;
-    /** 关隘首领状态，按服务器分组 */
-    castleStatus(): Promise<Jx3Envelope<T.CastleStatusGroup[]>>;
-    /** 今日赤兔记录 */
-    chituRecords(): Promise<Jx3Envelope<T.ChituRecord[]>>;
-    /** 本周赤兔到达地图 */
-    chituWeekRecords(): Promise<Jx3Envelope<T.ChituWeekRecords>>;
-    /** 阵营奉献：据点争夺记录 */
-    fenxianRecords(params?: {
-        name?: string;
-        limit?: number;
-    }): Promise<Jx3Envelope<T.FenxianRecord[]>>;
-    /** 烟花记录 */
-    fireworkRecords(params: {
-        server: string;
-        name: string;
-    }): Promise<Jx3Envelope<T.FireworkRecord[]>>;
-    /** 马场预告：各地图下一匹的预计时刻 */
-    ranchChat(params: {
-        server: string;
-    }): Promise<Jx3Envelope<T.RanchChatData>>;
-    /**
-     * 马场事件：各地图的出世预告及本周期出世备注。
-     * 响应的 `data` 包含 `zone`、`server`、`data` 和 `note`；
-     * 其中内层 `data` 按地图分组，键可能附带进图时间，值为预告文本数组。
-     *
-     * @example
-     * ```ts
-     * const response = await api.ranchRecords({ server: '破阵子' });
-     * if (response.code === 200) {
-     *   for (const [map, records] of Object.entries(response.data.data)) {
-     *     console.log(map, records);
-     *   }
-     *   console.log(response.data.note);
-     * }
-     * ```
-     */
-    ranchRecords(params: {
-        server: string;
-        expired?: 0 | 1;
-    }): Promise<Jx3Envelope<T.RanchRecordsData>>;
-    /** 下次扶摇：指定服返回该服未来场次，否则全服各返回下一场 */
-    soarNext(params?: {
-        server?: string;
-        limit?: number;
-    }): Promise<Jx3Envelope<T.SoarNextItem[]>>;
-    /** 诛恶事件刷新记录 */
-    wickedRecords(params?: {
-        server?: string;
-        limit?: number;
-    }): Promise<Jx3Envelope<T.WickedRecord[]>>;
-    /** 名剑排行：某比赛模式竞技场排行榜前 limit 名 */
+        name: "楚天社" | "云从社" | "披风会" | "穹野卫";
+    }): Promise<Jx3Envelope<T.CelebActivity[] | EmptyObject>>;
+    /** 名剑排行。查询名剑大会周排行榜。 */
     arenaAwesome(params?: {
-        mode?: number;
-        limit?: number;
+        limit?: number | null;
+        mode?: 22 | 33 | 55 | null;
+        node?: string;
         ticket?: string;
-    }): Promise<Jx3Envelope<T.ArenaAwesomeItem[]>>;
-    /**
-     * 名剑战绩：角色竞技场名片、各模式战绩表现、历史对战。
-     * 指定 mode 时 performance 仅含该模式并附 trend 趋势；不指定则三个模式都在、无 trend。
-     */
+    }): Promise<Jx3Envelope<T.ArenaAwesomeItem[] | EmptyObject>>;
+    /** 名剑战绩。查询角色名剑大会表现及近期战绩。 */
     arenaRecent(params: {
-        server: string;
+        mode?: 0 | 22 | 33 | 55 | null;
         name: string;
-        mode: number;
-        ticket?: string;
-    }): Promise<Jx3Envelope<T.ArenaRecentData & {
-        trend: T.ArenaTrendItem[];
-    }>>;
-    arenaRecent(params: {
+        node?: string;
         server: string;
-        name: string;
-        mode?: undefined;
         ticket?: string;
-    }): Promise<Jx3Envelope<T.ArenaRecentData>>;
-    /** 名剑统计：某比赛模式下各门派的竞技场周统计 */
+    }): Promise<Jx3Envelope<T.ArenaRecentData | EmptyObject>>;
+    /** 名剑统计。查询各门派的名剑大会周统计。 */
     arenaSchools(params?: {
-        mode?: number;
+        mode?: 22 | 33 | 55 | null;
+        node?: string;
         ticket?: string;
-    }): Promise<Jx3Envelope<T.ArenaSchoolItem[]>>;
-    /** 跨服名剑军团赛季榜（0=2v2 / 1=3v3 / 2=5v5） */
-    rankArena(params: {
-        server: string;
-        mode?: 0 | 1 | 2;
-    }): Promise<Jx3Envelope<T.RankArenaGroup>>;
-    rankArena(params?: {
-        server?: undefined;
-        mode?: 0 | 1 | 2;
-    }): Promise<Jx3Envelope<T.RankArenaGroup[]>>;
-    /** 武林争霸帮会榜（1=浩气 / 2=恶人） */
-    rankChampionship(params: {
-        server: string;
-        camp?: 1 | 2;
-    }): Promise<Jx3Envelope<T.RankChampionshipGroup>>;
-    rankChampionship(params?: {
-        server?: undefined;
-        camp?: 1 | 2;
-    }): Promise<Jx3Envelope<T.RankChampionshipGroup[]>>;
-    /** 捕快荣誉榜 */
-    rankConstable(params: {
+    }): Promise<Jx3Envelope<T.ArenaSchoolItem[] | EmptyObject>>;
+    /** 阵营拍卖。查询阵营拍卖成交记录。 */
+    auctionRecords(params: {
+        limit?: number | null;
+        name?: string;
         server: string;
-    }): Promise<Jx3Envelope<T.RankBountyGroup>>;
-    rankConstable(params?: {
-        server?: undefined;
-    }): Promise<Jx3Envelope<T.RankBountyGroup[]>>;
-    /** 江湖浪客榜 */
-    rankOutlaw(params: {
+    }): Promise<Jx3Envelope<T.AuctionRecord[] | EmptyObject>>;
+    /** 帮战记录。查询服务器最近 30 场帮战。 */
+    battleRecords(params: {
         server: string;
-    }): Promise<Jx3Envelope<T.RankBountyGroup>>;
-    rankOutlaw(params?: {
-        server?: undefined;
-    }): Promise<Jx3Envelope<T.RankBountyGroup[]>>;
-    /** 排行统计（按榜单名称） */
-    rankStatistics(params: {
+    }): Promise<Jx3Envelope<T.BattleRecord[] | EmptyObject>>;
+    /** DPS 计算。page 默认 pvedps，cycle 省略时使用上游默认循环。需同时检查 detail 内的上游错误。 */
+    calcdCalculate(params: {
         server: string;
         name: string;
-    }): Promise<Jx3Envelope<T.RankStatisticsGroup>>;
-    rankStatistics(params: {
-        server?: undefined;
+        cycle?: string;
+        page?: 'pvedps' | '界pvedps';
+    }): Promise<Jx3Envelope<T.CalcdCalculateData | T.UpstreamErrorDetail | EmptyObject>>;
+    /** 名片缓存。查询已缓存的角色名片。 */
+    cardCached(params: {
         name: string;
-    }): Promise<Jx3Envelope<T.RankStatisticsGroup[]>>;
-    /**
-     * 试炼之地榜。`name` 是**心法名**（如 "花间游"），不是榜单名。
-     * 指定 server 返回该服单个对象，不指定返回全服数组。
-     */
-    rankTrials(params: {
         server: string;
+    }): Promise<Jx3Envelope<T.CardRecord | EmptyObject>>;
+    /** 名片详情。查询角色名片图片与获赞数。 */
+    cardDetail(params: {
         name: string;
-    }): Promise<Jx3Envelope<T.RankTrialsGroup>>;
-    rankTrials(params: {
-        server?: undefined;
-        name: string;
-    }): Promise<Jx3Envelope<T.RankTrialsGroup[]>>;
-    /** 决斗挑战悬赏榜（1=公开 / 2=私密） */
-    rankWanted(params: {
+        node?: string;
         server: string;
-        mode?: 1 | 2;
-    }): Promise<Jx3Envelope<T.RankWantedGroup>>;
-    rankWanted(params?: {
-        server?: undefined;
-        mode?: 1 | 2;
-    }): Promise<Jx3Envelope<T.RankWantedGroup[]>>;
-    /** 赛季试炼：各赛季的最高层数与首领列表（无需参数） */
-    trialSeasons(): Promise<Jx3Envelope<T.TrialSeason[]>>;
-    /**
-     * 试炼秒伤：指定赛季 + 层数下各首领的血量与完美 / 通关秒伤需求。
-     * 赛季名与可用层数见 {@link Jx3Api.trialSeasons}。
-     */
-    trialBosses(params: {
-        season: string;
-        floor: number;
-    }): Promise<Jx3Envelope<T.TrialBosses>>;
-    /** 资历榜单：指定服 / 门派（默认全服全门派）的资历前 100 名 */
-    schoolSeniority(params?: {
-        server?: string;
-        school?: string;
         ticket?: string;
-    }): Promise<Jx3Envelope<T.SchoolSeniorityItem[]>>;
-    /**
-     * 资历分布：返回角色名片及按分类、副本、地图汇总的完成进度。
-     * 指定 subclass 时，total 只返回该大类的子类，并移除最外层大类。
-     */
-    tuilanAchievement(params: {
-        server: string;
+    }): Promise<Jx3Envelope<T.CardPreset | EmptyObject>>;
+    /** 随机名片。随机获取一张角色名片。 */
+    cardRandom(params?: {
+        body?: string | null;
+        force?: string | null;
+        server?: string | null;
+    }): Promise<Jx3Envelope<T.CardRecord | EmptyObject>>;
+    /** 名片记录。查询角色名片。 */
+    cardRecord(params: {
         name: string;
-        class?: 1 | 2 | 3;
-        subclass: string;
-        ticket?: string;
-    }): Promise<Jx3Envelope<T.TuilanAchievementData<T.TuilanAchievementFilteredTotal>>>;
-    tuilanAchievement(params: {
         server: string;
+    }): Promise<Jx3Envelope<T.CardRecord | EmptyObject>>;
+    /** 名片历史。查询角色的历史名片。 */
+    cardRecords(params: {
+        like?: boolean;
         name: string;
-        class?: 1 | 2 | 3;
-        subclass?: undefined;
-        ticket?: string;
-    }): Promise<Jx3Envelope<T.TuilanAchievementData>>;
-    tuilanAchievement(params: {
         server: string;
-        name: string;
-        class?: 1 | 2 | 3;
-        subclass?: string;
-        ticket?: string;
-    }): Promise<Jx3Envelope<T.TuilanAchievementData<T.TuilanAchievementTotal | T.TuilanAchievementFilteredTotal>>>;
-    /** 角色徽章，需要 LV.2 及以上的站点 token 和推栏 ticket。 */
-    tuilanBadge(params: {
+    }): Promise<Jx3Envelope<T.CardHistoryItem[] | EmptyObject>>;
+    /** 聊天内容。合并补充记录后去重分页，返回记录数组。 */
+    chatContent(params: {
         server: string;
         name: string;
-        ticket?: string;
-    }): Promise<Jx3Envelope<T.TuilanBadgeData>>;
-    /** 阵营拍卖记录 */
-    auctionRecords(params: {
-        server: string;
-        name?: string;
         limit?: number;
-    }): Promise<Jx3Envelope<T.AuctionRecord[]>>;
-    /** 的卢拍卖：指定服最新 10 条，不指定则每服最新 1 条 */
-    steedRecords(params?: {
-        server?: string;
-    }): Promise<Jx3Envelope<T.SteedRecord[]>>;
-    /** 金价行情 */
-    tradeDemon(params?: {
-        server?: string;
+        page?: number;
+    }): Promise<Jx3Envelope<T.ChatContentItem[] | EmptyObject>>;
+    /** 角色聊天。分页查询角色聊天记录。 */
+    chatRecords(params: {
         limit?: number;
-    }): Promise<Jx3Envelope<T.TradeDemonItem[]>>;
-    /** 外观价格：历史成交 + 万宝楼挂单 */
-    tradeItemRecords(params: {
         name: string;
-        server?: string;
-    }): Promise<Jx3Envelope<T.TradeItemRecords>>;
-    /** 外观搜索（先精确后模糊） */
-    tradeItemSearch(params: {
-        name: string;
-    }): Promise<Jx3Envelope<T.TradeItemInfo[]>>;
-    /** 成本计算：按成品配方算材料成本 */
-    tradeManufacture(params: {
+        page?: number;
         server: string;
+    }): Promise<Jx3Envelope<T.ChatRecordsData | EmptyObject>>;
+    /** 今日赤兔。查询今日赤兔预告与出世记录。 */
+    chituRecords(): Promise<Jx3Envelope<T.ChituRecord[]>>;
+    /** 本周赤兔。查询本周赤兔预告与出世记录，每周二 07:00（北京时间）重置。 */
+    chituWeekRecords(): Promise<Jx3Envelope<T.ChituWeekRecords | EmptyObject>>;
+    /** 答案之书。随机获取一条答案和一句鼓励语。 */
+    choiceAnswer(): Promise<Jx3Envelope<T.ChoiceAnswerData | EmptyObject>>;
+    /** 喝什么。随机推荐 2～4 种饮品。 */
+    choiceDrink(): Promise<Jx3Envelope<T.ChoiceDrinkData | EmptyObject>>;
+    /** 吃什么。随机推荐 2～4 种食物。 */
+    choiceFood(): Promise<Jx3Envelope<T.ChoiceFoodData | EmptyObject>>;
+    /** 编辑器。查询编辑器资料。 */
+    editorSearch(params: {
         name: string;
-        source?: 0 | 1;
-    }): Promise<Jx3Envelope<T.TradeManufactureData>>;
-    /** 物品价格：各区 / 指定服历史成交价 */
-    tradeRecords(params: {
-        name: string;
-        server?: string;
-    }): Promise<Jx3Envelope<T.TradeItemRecords>>;
-    /** 万宝楼编号搜索：角色信息、售价与调价记录 */
-    tradeWanbaolou(params: {
-        id: string;
-    }): Promise<Jx3Envelope<T.TradeWanbaolouData>>;
-    /**
-     * 万宝楼角色信息：按编号转发上游 role_info2 接口，服务端固定 type=3。
-     * `id` 使用字符串以避免大整数精度丢失；需要 LV.2 及以上的站点 token，无需 ticket。
-     * 保留上游字段与 `{ code, data }` 结构，角色列表位于 `response.data.data`。
-     */
-    wblzsRole(params: {
-        id: string;
-    }): Promise<Jx3Envelope<T.WanbaolouRoleData>>;
-    /** 万宝楼找人：按订单编号查询详情与匹配角色（需要推栏 ticket） */
-    wblzsSomeone(params: {
-        id: string;
-        ticket?: string;
-    }): Promise<Jx3Envelope<T.WanbaolouOrderData>>;
-    /** 帮战记录：某服最近 30 场 */
-    battleRecords(params: {
-        server: string;
-    }): Promise<Jx3Envelope<T.BattleRecord[]>>;
-    /** 沙盘据点归属 */
-    sandRecords(params: {
+        page?: number;
+    }): Promise<Jx3Envelope<T.EditorSearchData | EmptyObject>>;
+    /** 奇遇汇总。汇总服务器近期的奇遇次数及最近触发记录。 */
+    eventCollect(params: {
+        num?: number | null;
         server: string;
-    }): Promise<Jx3Envelope<T.SandRecordsData>>;
-    /** 名片缓存 */
-    cardCached(params: {
+    }): Promise<Jx3Envelope<T.EventCollectItem[] | EmptyObject>>;
+    /** 近期奇遇。查询服务器最近的奇遇触发记录。 */
+    eventRecent(params: {
+        limit?: number | null;
         server: string;
+    }): Promise<Jx3Envelope<T.EventRecentItem[] | EmptyObject>>;
+    /** 奇遇记录。查询角色的奇遇触发记录。 */
+    eventRecords(params: {
+        full?: 0 | 1 | null;
         name: string;
-    }): Promise<Jx3Envelope<T.CardRecord>>;
-    /** 名片预设（推栏预设图与获赞数） */
-    cardPreset(params: {
         server: string;
+    }): Promise<Jx3Envelope<T.EventRecordItem[] | EmptyObject>>;
+    /** 奇遇统计。查询指定奇遇最近的触发记录。 */
+    eventStatistics(params: {
+        limit?: number | null;
         name: string;
-        ticket?: string;
-    }): Promise<Jx3Envelope<T.CardPreset>>;
-    /** 随机名片 */
-    cardRandom(params?: {
         server?: string;
-        force?: string;
-        body?: string;
-    }): Promise<Jx3Envelope<T.CardRandom>>;
-    /** 名片记录 */
-    cardRecord(params: {
-        server: string;
+    }): Promise<Jx3Envelope<T.EventStatisticsItem[] | EmptyObject>>;
+    /** 奇遇攻略。查询奇遇的分类和等级资料。 */
+    eventStrategy(params: {
+        name: string;
+    }): Promise<Jx3Envelope<T.EventStrategy | EmptyObject>>;
+    /** 科举答案。搜索科举试题及答案。 */
+    examSearch(params: {
+        limit?: number | null;
+        subject: string;
+    }): Promise<Jx3Envelope<T.ExamAnswer[] | EmptyObject>>;
+    /** 烟花记录。查询角色发送或接收的烟花记录。 */
+    fireworkRecords(params: {
         name: string;
-    }): Promise<Jx3Envelope<T.CardRecord>>;
-    /** 名片历史列表 */
-    cardRecords(params: {
         server: string;
+    }): Promise<Jx3Envelope<T.FireworkRecord[] | EmptyObject>>;
+    /** 小吃小药。查询心法的小吃小药。 */
+    foodList(params?: {
+        name?: string;
+    }): Promise<Jx3Envelope<T.FoodItem[] | EmptyObject>>;
+    /** 骗子查询。查询角色 UID 对应的骗子记录。 */
+    fraudDetail(params: {
+        server?: string;
+        uid: number;
+    }): Promise<Jx3Envelope<T.FraudRecord[] | EmptyObject>>;
+    /** 家园鲜花。查询各家园地图的鲜花收购信息。 */
+    homeFlower(params: {
+        map?: string;
+        name?: string;
+        node?: string;
+        server: string;
+    }): Promise<Jx3Envelope<T.HomeFlowerData | EmptyObject>>;
+    /** 秘境方位。查询当前秘境方位及下次变化的倒计时。 */
+    mechDecrypt(): Promise<Jx3Envelope<T.MechDecrypt | EmptyObject>>;
+    /** 师徒列表。查询服务器的师徒招募信息。 */
+    mentorSearch(params: {
+        keyword?: string;
+        label?: number | null;
+        limit?: number | null;
+        server: string;
+    }): Promise<Jx3Envelope<T.MentorItem[] | EmptyObject>>;
+    /** 角色百战。查询角色的百战技能、体力、精力和场次。 */
+    monsterRecords(params: {
         name: string;
-        like?: boolean;
-    }): Promise<Jx3Envelope<T.CardHistoryItem[]>>;
-    /** 奇遇汇总：白名单奇遇近 num 天触发次数 + 最新一条 */
-    eventCollect(params: {
         server: string;
-        num?: number;
-    }): Promise<Jx3Envelope<T.EventCollectItem[]>>;
-    /** 该角色尚未触发的奇遇 */
-    eventMissing(params: {
+    }): Promise<Jx3Envelope<T.MonsterRecords | EmptyObject>>;
+    /** 百战首领。查询本周百战首领、技能及效果。 */
+    monsterWeekly(): Promise<Jx3Envelope<T.MonsterWeekly | EmptyObject>>;
+    /** 维护公告。查询游戏维护更新公告。 */
+    newsAnnounce(params?: {
+        limit?: number | null;
+    }): Promise<Jx3Envelope<T.NewsItem[] | EmptyObject>>;
+    /** 新闻资讯。查询最新游戏新闻资讯。 */
+    newsRecords(params?: {
+        limit?: number | null;
+    }): Promise<Jx3Envelope<T.NewsItem[] | EmptyObject>>;
+    /** 团队副本进度。使用主站 /raid/records 路由。 */
+    raidRecords(params: {
         server: string;
         name: string;
-    }): Promise<Jx3Envelope<T.EventMissingItem[]>>;
-    /** 某服最近触发的奇遇 */
-    eventRecent(params: {
+    }): Promise<Jx3Envelope<RaidProgress[] | EmptyObject>>;
+    /** 马场预告。查询各地图 NPC 播报的马匹预计出世时间。 */
+    ranchChat(params: {
         server: string;
-        limit?: number;
-    }): Promise<Jx3Envelope<T.EventRecentItem[]>>;
-    /** 角色奇遇记录 */
-    eventRecords(params: {
+    }): Promise<Jx3Envelope<T.RanchChatData>>;
+    /** 马场事件。查询马场预告及本周期赤兔、的卢出世情况。 */
+    ranchRecords(params: {
+        expired?: number;
         server: string;
+    }): Promise<Jx3Envelope<T.RanchRecordsData>>;
+    /** 绝境战场。查询绝境战场榜单。 */
+    rankBattle(params: {
         name: string;
-        full?: 0 | 1;
-    }): Promise<Jx3Envelope<T.EventRecordItem[]>>;
-    /** 某奇遇最近的触发记录 */
-    eventStatistics(params: {
         server?: string;
+    }): Promise<Jx3Envelope<T.RankBattleGroup | T.RankBattleGroup[]>>;
+    /** 据点贡献。查询据点贡献榜。 */
+    rankCastle(params: {
         name: string;
-        limit?: number;
-    }): Promise<Jx3Envelope<T.EventStatisticsItem[]>>;
-    /** 奇遇攻略（白名单配置） */
-    eventStrategy(params: {
+        server?: string;
+    }): Promise<Jx3Envelope<T.RankCastleGroup | T.RankCastleGroup[]>>;
+    /** 武林争霸。查询指定阵营的武林争霸榜单。 */
+    rankContest(params?: {
+        camp?: 1 | 2 | null;
+        server?: string;
+    }): Promise<Jx3Envelope<T.RankContestGroup | T.RankContestGroup[]>>;
+    /** 帮会排行。查询帮会排行与战功榜。 */
+    rankGuild(params: {
         name: string;
-    }): Promise<Jx3Envelope<T.EventStrategy>>;
-    /** 角色百战技能配装：体力 / 精力属性与技能列表。未打过百战的角色会返回 404 未收录 */
-    monsterRecords(params: {
-        server: string;
+        server?: string;
+    }): Promise<Jx3Envelope<T.RankGuildGroup | T.RankGuildGroup[]>>;
+    /** 江湖排行。查询江湖浪客与捕快荣誉榜。 */
+    rankJianghu(params: {
         name: string;
-    }): Promise<Jx3Envelope<T.MonsterRecords>>;
-    /**
-     * 本周百战异闻录：本周首领与 100 层关卡（无需 server / name）。
-     *
-     * 「百战记录」分组下后端新增的接口，晚于最初的接口文档，故原始文档中没有；
-     * 字段依据实测。
-     */
-    monsterWeekly(): Promise<Jx3Envelope<T.MonsterWeekly>>;
-    /**
-     * 成就查询：角色名片 + 按 `name` 模糊匹配的成就列表，标记该角色完成情况。
-     * `role` 为角色名，`name` 为成就名/分类关键词。
-     */
-    roleAchievement(params: {
+        server?: string;
+    }): Promise<Jx3Envelope<T.RankJianghuGroup | T.RankJianghuGroup[]>>;
+    /** 跨服名剑。查询跨服名剑榜单。 */
+    rankLadder(params?: {
+        mode?: number | null;
+        server?: string;
+    }): Promise<Jx3Envelope<T.RankLadderGroup | T.RankLadderGroup[]>>;
+    /** 个人排行。查询个人排行与贡献榜。 */
+    rankRecords(params: {
+        name: string;
+        server?: string;
+    }): Promise<Jx3Envelope<T.RankRecordsGroup | T.RankRecordsGroup[]>>;
+    /** 试炼之地。查询指定心法的试炼之地榜单。 */
+    rankTrials(params: {
+        kungfu: string;
+        server?: string;
+    }): Promise<Jx3Envelope<T.RankTrialsGroup | T.RankTrialsGroup[]>>;
+    /** 决斗挑战。查询公开或私密的决斗挑战榜单。 */
+    rankWanted(params?: {
+        mode?: 1 | 2 | null;
+        server?: string;
+    }): Promise<Jx3Envelope<T.RankWantedGroup | T.RankWantedGroup[]>>;
+    /** 团队招募。查询服务器的团队招募信息。 */
+    recruitSearch(params: {
+        keyword?: string;
+        label?: number | null;
+        limit?: number | null;
         server: string;
-        role: string;
+    }): Promise<Jx3Envelope<T.RecruitItem[] | EmptyObject>>;
+    /** 掉落统计。查询物品的掉落记录。 */
+    rewardStatistics(params: {
+        limit?: number | null;
         name: string;
-    }): Promise<Jx3Envelope<T.RoleAchievementData>>;
-    /** 角色详情（history=1 时附改名 / 帮会历史） */
+        server?: string;
+    }): Promise<Jx3Envelope<T.RewardRecord[] | EmptyObject>>;
+    /** 批量角色资料。全局角色 ID 使用字符串，至少传一个 ID，未匹配的角色不出现在结果中。 */
+    roleBatch(params: {
+        ids: [string, ...string[]];
+    }): Promise<Jx3Envelope<T.RoleBatchItem[] | EmptyObject>>;
+    /** 角色详情。查询角色资料，可附带角色名和帮会历史。 */
     roleDetail(params: {
-        server: string;
+        history?: 0 | 1 | null;
         name: string;
-        history?: 0 | 1;
-    }): Promise<Jx3Envelope<T.RoleDetail>>;
-    /** 蹲宠查询：七宠白名单命中情况 */
-    shareStay(params: {
         server: string;
-    }): Promise<Jx3Envelope<T.ShareStayItem[]>>;
-    /**
-     * 聊天内容：查询角色在所有服务器的聊天记录，由服务端合并去重并按时间倒序分页。
-     * `limit` 默认 20，`page` 默认 1；需要 LV.2 及以上的站点 token。
-     */
-    chatContent(params: {
+    }): Promise<Jx3Envelope<T.RoleDetail | EmptyObject>>;
+    /** 全服角色。查询全服已收录的同名角色。 */
+    roleDetails(params: {
+        name: string;
+    }): Promise<Jx3Envelope<T.RoleDetailsData | EmptyObject>>;
+    /** 沙盘据点。查询据点归属及本周祭祀次数。 */
+    sandRecords(params: {
         server: string;
+    }): Promise<Jx3Envelope<T.SandRecordsData | EmptyObject>>;
+    /** 舔狗日志。随机获取一条舔狗日志。 */
+    saohuaContent(): Promise<Jx3Envelope<T.SaohuaRandom | EmptyObject>>;
+    /** 分类语录。按分类随机获取一条语录。 */
+    saohuaContext(params: {
         name: string;
-        limit?: number;
-        page?: number;
-    }): Promise<Jx3Envelope<T.ChatContentItem[]>>;
-    /** 统战歪歪：各服 YY 语音在线主播 */
-    duowanStatistics(params?: {
+    }): Promise<Jx3Envelope<T.SaohuaContext | EmptyObject>>;
+    /** 随机骚话。随机获取一条骚话。 */
+    saohuaRandom(): Promise<Jx3Envelope<T.SaohuaRandom | EmptyObject>>;
+    /** 渣男语录。随机获取一条渣男语录。 */
+    saohuaZhanan(): Promise<Jx3Envelope<T.SaohuaZhananData | EmptyObject>>;
+    /** 配装搜索。查询指定心法的推荐配装。 */
+    schoolSearch(params: {
+        mode?: string;
+        name: string;
+        node?: string;
+        ticket?: string;
+    }): Promise<Jx3Envelope<T.SchoolSearchItem[]>>;
+    /** 资历榜单。查询全服或指定服务器、门派的资历前 100 名。 */
+    schoolSeniority(params?: {
+        node?: string;
+        school?: string;
         server?: string;
-    }): Promise<Jx3Envelope<T.DuowanStatisticsGroup[]>>;
-    /** 小吃小药（指定心法或全部） */
-    foodList(params?: {
-        name?: string;
-    }): Promise<Jx3Envelope<T.FoodItem[]>>;
-    /** 骗子查询：按 UID 查风控记录 */
-    fraudDetail(params: {
-        uid: number;
+        ticket?: string;
+    }): Promise<Jx3Envelope<T.SchoolSeniorityItem[] | EmptyObject>>;
+    /** 别名搜索。查询名称对应的主服务器。 */
+    serverSearch(params: {
+        server: string;
+    }): Promise<Jx3Envelope<T.ServerSearchData | EmptyObject>>;
+    /** 大区状态。查询服务器的开服或在线状态。 */
+    serverStatusCheck(params?: {
         server?: string;
-    }): Promise<Jx3Envelope<T.FraudRecord[]>>;
-    /** 家园鲜花行情，按地图归组 */
-    homeFlower(params: {
+        type?: number;
+    }): Promise<Jx3Envelope<T.ServerStatus[] | T.ServerOnlineStatus | T.ServerOnlineStatus[]>>;
+    /** 游戏版本。查询游戏最新版本及更新包大小。 */
+    serverVersionCheck(): Promise<Jx3Envelope<T.ServerVersionCheckData | EmptyObject>>;
+    /** 蹲宠查询。查询宠物最近触发时间及刷新信息。 */
+    shareStay(params: {
+        node?: string;
         server: string;
+    }): Promise<Jx3Envelope<T.ShareStayItem[] | EmptyObject>>;
+    /** 副本掉落模拟。省略 name 使用服务端默认副本，需同时检查 detail 内的上游错误。 */
+    simulateRaid(params?: {
         name?: string;
-        map?: string;
-    }): Promise<Jx3Envelope<T.HomeFlowerData>>;
-    /**
-     * 家园装饰。`name` 必须是完整精确的装饰名（如 "龙门香梦"），
-     * 模糊名会返回 `code: 400 参数不正确`。返回数组，同名装饰可能有多条。
-     */
-    homeFurniture(params: {
-        name: string;
-    }): Promise<Jx3Envelope<T.HomeFurniture[]>>;
-    /**
-     * 器物图谱。`name` 必须是完整精确的器物名（如 "日晷"），
-     * 模糊名会返回 `code: 400 参数不正确`。返回数组，结构与 {@link Jx3Api.homeFurniture} 一致。
-     */
-    homeTravel(params: {
-        name: string;
-    }): Promise<Jx3Envelope<T.HomeTravelItem[]>>;
-    /** 师徒列表（label 1=师父 / 2=徒弟） */
-    mentorSearch(params: {
-        label?: 1 | 2;
-        server: string;
-        keyword?: string;
-        limit?: number;
-    }): Promise<Jx3Envelope<T.MentorItem[]>>;
-    /** 维护公告（标题含「版本更新」） */
-    newsAnnounce(params?: {
-        limit?: number;
-    }): Promise<Jx3Envelope<T.NewsItem[]>>;
-    /** 新闻资讯 */
-    newsRecords(params?: {
-        limit?: number;
-    }): Promise<Jx3Envelope<T.NewsItem[]>>;
-    /** 团队招募 */
-    recruitSearch(params: {
-        server: string;
-        label?: 1 | 2 | 3;
-        keyword?: string;
+    }): Promise<Jx3Envelope<T.RaidDropData | T.UpstreamErrorDetail | EmptyObject>>;
+    /** 试炼翻牌模拟。name 为层数序列，省略时默认 "123"。 */
+    simulateTrial(params?: {
+        name?: string;
+    }): Promise<Jx3Envelope<T.RaidFlipData | EmptyObject>>;
+    /** 急速计算。计算技能在各急速档位的读条时长。 */
+    skillCalculate(params?: {
+        cooldown?: number | null;
+    }): Promise<Jx3Envelope<T.SkillCalculateItem[] | EmptyObject>>;
+    /** 技改记录。查询官方武学调整公告。 */
+    skillRework(params?: {
+        node?: string;
+    }): Promise<Jx3Envelope<T.SkillReworkItem[] | EmptyObject>>;
+    /** 扶摇记录。查询已上报的扶摇九天记录及活动状态。 */
+    soarRecords(params?: {
         limit?: number;
-    }): Promise<Jx3Envelope<T.RecruitItem[]>>;
-    /** 分类骚话语录（疯狂星期四 / 彩虹屁 / 毒鸡汤 / 朋友圈） */
-    saohuaContext(params: {
-        name: string;
-    }): Promise<Jx3Envelope<T.SaohuaContext>>;
-    /**
-     * 随机骚话（无需参数）。「骚话语录」分组下后端新增的接口，晚于最初的接口文档，
-     * 类型依据实测。注意返回字段是 `text`，不同于 saohuaContext 的 `content`。
-     */
-    saohuaRandom(): Promise<Jx3Envelope<T.SaohuaRandom>>;
-    /**
-     * 舔狗日记（无需参数），返回一段较长的舔狗日记文本。
-     * 同为「骚话语录」分组下后端新增的接口，返回结构与 saohuaRandom 一致（字段 `text`）。
-     */
-    saohuaContent(): Promise<Jx3Envelope<T.SaohuaRandom>>;
-    /** 贴吧外观记录 */
+        server?: string;
+    }): Promise<Jx3Envelope<T.SoarRecord[] | EmptyObject>>;
+    /** 的卢拍卖。查询的卢出世、捕获与拍卖记录。 */
+    steedRecords(params?: {
+        server?: string;
+    }): Promise<Jx3Envelope<T.SteedRecord[] | T.SteedServerRecord[]>>;
+    /** 外观记录。查询贴吧中的外观交易记录。 */
     tiebaItemRecords(params: {
+        limit?: number | null;
         name: string;
         server?: string;
-        limit?: number;
-    }): Promise<Jx3Envelope<T.TiebaItemRecord[]>>;
-    /** 百度贴吧：按帖子类型随机取近 31 天帖子 */
+    }): Promise<Jx3Envelope<T.TiebaItemRecord[] | EmptyObject>>;
+    /** 贴吧物价。查询物品在贴吧及其他渠道的最近价格记录。 */
+    tiebaItemSales(params: {
+        name: string;
+    }): Promise<Jx3Envelope<T.TiebaItemSalesData | EmptyObject>>;
+    /** 随机帖子。按类型随机查询近 31 天的贴吧帖子。 */
     tiebaRandom(params: {
-        tags: string;
+        limit?: number | null;
         server?: string;
-        limit?: number;
-    }): Promise<Jx3Envelope<T.TiebaRandomItem[]>>;
-    /** 贴吧帖子 AI 总结 */
+        tags: string;
+    }): Promise<Jx3Envelope<T.TiebaRandomItem[] | EmptyObject>>;
+    /** 贴吧总结。获取贴吧帖子的 AI 摘要。 */
     tiebaSummary(params: {
-        id: string | number;
+        id: string;
     }): Promise<Jx3Envelope<T.TiebaSummary>>;
-    /** 秘境方位：按 15 分钟档推算 */
-    mechDecrypt(): Promise<Jx3Envelope<T.MechDecrypt>>;
-    /** 副本掉落模拟。name 为副本名，服务端默认使用「25yx闲风雾城」。需要 LV.2 及以上的 token。 */
-    raidDrop(params?: {
-        name?: string;
-    }): Promise<Jx3Envelope<T.RaidDropData>>;
-    /** 试炼翻牌模拟。name 为层数字符串，默认 "123" 表示依次模拟第 1、2、3 层。需要 LV.2 及以上的 token。 */
-    raidFlip(params?: {
-        name?: string;
-    }): Promise<Jx3Envelope<T.RaidFlipData>>;
-    /** 团队副本 CD 列表 */
-    raidRecords(params: {
-        server: string;
+    /** 金价行情。查询各渠道的金币价格。 */
+    tradeDemon(params?: {
+        limit?: number | null;
+        server?: string;
+    }): Promise<Jx3Envelope<T.TradeDemonItem[] | EmptyObject>>;
+    /** 外观价格。按物品全名查询成交价和寄售挂单。 */
+    tradeItemRecords(params: {
         name: string;
-    }): Promise<Jx3Envelope<T.RaidProgress[]>>;
-    /** 掉落统计：按物品名模糊匹配 */
-    rewardStatistics(params: {
+        node?: string;
         server?: string;
+    }): Promise<Jx3Envelope<T.TradeItemRecords | EmptyObject>>;
+    /** 外观搜索。搜索外观及其基础资料。 */
+    tradeItemSearch(params: {
         name: string;
-        limit?: number;
-    }): Promise<Jx3Envelope<T.RewardRecord[]>>;
-    /** 阵眼效果 */
-    schoolMatrix(params: {
+    }): Promise<Jx3Envelope<T.TradeItemInfo[] | EmptyObject>>;
+    /** 成本计算。查询成品售价并计算配方材料成本。 */
+    tradeManufacture(params: {
         name: string;
-        ticket?: string;
-    }): Promise<Jx3Envelope<T.SchoolMatrix>>;
-    /** 推栏推荐配装 */
-    schoolSearch(params: {
+        node?: string;
+        server: string;
+        source?: 0 | 1 | null;
+    }): Promise<Jx3Envelope<T.TradeManufactureData | EmptyObject>>;
+    /** 物品价格。按物品名称或别名查询成交价和寄售挂单。 */
+    tradeRecords(params: {
         name: string;
-        mode?: string;
-        ticket?: string;
-    }): Promise<Jx3Envelope<T.SchoolSearchItem[]>>;
-    /** 技能信息 */
-    schoolSkills(params: {
+        node?: string;
+        server?: string;
+    }): Promise<Jx3Envelope<T.TradeItemRecords | EmptyObject>>;
+    /** 编号搜索。按万宝楼角色编号查询寄售角色详情。 */
+    tradeWanbaolou(params: {
+        id: string;
+        node?: string;
+    }): Promise<Jx3Envelope<T.TradeWanbaolouData | EmptyObject>>;
+    /** 秒伤计算。查询当前赛季指定层数的首领血量与通关秒伤。 */
+    trialBosses(params: {
+        floor: number;
+    }): Promise<Jx3Envelope<T.TrialBosses | EmptyObject>>;
+    /** 赛季列表。查询当前试炼赛季及首领顺序。 */
+    trialSeasons(): Promise<Jx3Envelope<T.TrialSeason[] | EmptyObject>>;
+    /** 角色徽章。查询推栏角色徽章。 */
+    tuilanBadge(params: {
         name: string;
-        update?: 0 | 1;
+        node?: string;
+        server: string;
         ticket?: string;
-    }): Promise<Jx3Envelope<T.SchoolSkillsGroup[]>>;
-    /** 奇穴信息 */
-    schoolTalent(params: {
-        name: string;
-        update?: 0 | 1;
+    }): Promise<Jx3Envelope<T.TuilanBadgeData | EmptyObject>>;
+    /** 统战语音。查询统战 YY 频道的在线主播。 */
+    voiceChannels(params?: {
+        node?: string;
+        server?: string;
+    }): Promise<Jx3Envelope<T.VoiceChannelGroup[] | EmptyObject>>;
+    /** 角色信息。按万宝楼编号查询角色信息。 */
+    wblzsRole(params: {
+        id: string;
+    }): Promise<Jx3Envelope<T.WanbaolouRoleData | EmptyObject>>;
+    /** 搜索找人。按万宝楼订单查找卖家角色候选。 */
+    wblzsSomeone(params: {
+        id: string;
+        limit?: number;
+        node?: string;
+        range?: number;
         ticket?: string;
-    }): Promise<Jx3Envelope<T.SchoolTalentLevel[]>>;
-    /** 科举答案：按题目或拼音模糊匹配 */
-    examSearch(params: {
-        subject: string;
+        type?: number;
+    }): Promise<Jx3Envelope<T.WanbaolouOrderData | EmptyObject>>;
+    /** 诛恶事件。查询诛恶事件刷新记录。 */
+    wickedRecords(params?: {
         limit?: number;
-    }): Promise<Jx3Envelope<T.ExamAnswer[]>>;
-    /**
-     * 大区状态：data 固定为数组，指定 server 时也只是数组里的单条，
-     * 不指定则返回收录的全部大区。（文档写“指定服返回单条”，实测仍是数组）
-     */
-    serverStatusCheck(params?: {
         server?: string;
-    }): Promise<Jx3Envelope<T.ServerStatus[]>>;
-    /** 默认接口服务（服务状态自检） */
-    siteIndex(params?: {
-        username?: string;
-    }): Promise<Jx3Envelope<T.SiteIndex>>;
-    /** 急速计算：按技能 cd 推算各急速档位 */
-    skillCalculate(params?: {
-        cooldown?: number;
-    }): Promise<Jx3Envelope<T.SkillCalculateItem[]>>;
-    /**
-     * 技改记录（无需参数）：武学调整公告列表，时间倒序。
-     * 后端新增的接口，晚于最初的接口文档，类型依据实测。
-     */
-    skillRework(): Promise<Jx3Envelope<T.SkillReworkItem[]>>;
-    /** 语音合成（未实测：需要用户自己的阿里云密钥） */
-    soundConverter(params: T.SoundConverterParams): Promise<Jx3Envelope<T.SoundConverterData>>;
-    /**
-     * 更新日常：客户端上报当日大战 / 秘境 / 团本。
-     * 注意：这是写入型接口，会修改服务端日历数据。
-     */
-    updateCalendar(params: T.UpdateCalendarParams): Promise<Jx3Envelope<unknown>>;
+    }): Promise<Jx3Envelope<T.WickedRecord[] | EmptyObject>>;
 }
 //# sourceMappingURL=main.d.ts.map