finej3 1.0.0

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAoDA,8BAOC;AA3DD,6CAA0D;AAAjD,iGAAA,MAAM,OAAA;AAAE,wGAAA,aAAa,OAAA;AAC9B,iDAAoE;AAA3D,yGAAA,YAAY,OAAA;AAAE,4GAAA,eAAe,OAAA;AACtC,iDAAoE;AAA3D,yGAAA,YAAY,OAAA;AAAE,4GAAA,eAAe,OAAA;AAOtC,+CAA2C;AAC3C,mDAAmD;AACnD,mDAAmD;AA8BnD;;;;;;;;;;GAUG;AACH,SAAgB,SAAS,CAAC,OAAyB;IACjD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IACvC,OAAO;QACL,GAAG,EAAE,IAAI,gBAAM,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QACrD,MAAM,EAAE,IAAI,wBAAY,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACjE,MAAM,EAAE,IAAI,wBAAY,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/cjs/types/client.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * 客户端服务（submit.client.nicemoe.cn）响应类型。
+ * 字段依据 2026-07-20 实测采样推导。
+ * 注意：部分接口（design / trade_item_search / role_equip_list 的装备数据）依赖目标服务器
+ * 有已注册的游戏客户端在线，否则返回 503「无可用客户端」。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=client.js.map

package/dist/cjs/types/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/types/client.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/cjs/types/main.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * 主站（seasun.nicemoe.cn）响应类型。
+ * 全部字段依据 2026-07-20 对线上接口的实测采样推导；
+ * 标注「未实测」的类型来自文档描述，字段可能不完整，均带 index signature 以便访问额外字段。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=main.js.map

package/dist/cjs/types/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/types/main.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/cjs/types/search.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * 搜索服务（search.client.nicemoe.cn）响应类型。
+ * 字段依据 2026-07-20 实测采样推导。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=search.js.map

package/dist/cjs/types/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/types/search.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

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

@@ -0,0 +1,81 @@
+import { HttpClient, type GatewayEnvelope, type Jx3Options } from '../core/http.js';
+import type * as T from '../types/client.js';
+/** 客户端服务官方地址 */
+export declare const CLIENT_BASE_URL = "https://submit.client.nicemoe.cn";
+/**
+ * 客户端服务（submit.client.nicemoe.cn，POST + JSON body，单入口 action 分发）。
+ * 响应信封 `{ status, detail }` 原样返回，不解包、业务错误不抛异常（自行判断 status；
+ * 业务错误时 detail 为错误描述字符串）。
+ *
+ * 部分接口（design / tradeItemSearch，以及 roleEquipList 的装备数据）依赖目标服务器
+ * 有已注册的游戏客户端在线，否则返回 status=503「无可用客户端」。
+ * 传 `baseUrl` 可指向自建代理 / 镜像，缺省用 {@link CLIENT_BASE_URL}。
+ */
+export declare class Jx3ClientApi extends HttpClient {
+    constructor(options: Jx3Options);
+    /** 角色名片 */
+    roleShowCard(params: {
+        server: string;
+        name: string;
+    }): Promise<GatewayEnvelope<T.ShowCard>>;
+    /** 全部名片 */
+    roleShowCards(params: {
+        server: string;
+        name: string;
+    }): Promise<GatewayEnvelope<T.ShowCard[]>>;
+    /** 名片缓存 */
+    roleShowCardCached(params: {
+        server: string;
+        name: string;
+    }): Promise<GatewayEnvelope<T.ShowCard>>;
+    /** 随机名片（可按势力 / 体型筛选） */
+    roleShowCardRandom(params: {
+        server: string;
+        force?: string;
+        body?: string;
+    }): Promise<GatewayEnvelope<T.ShowCardRandom>>;
+    /** 历史名片 */
+    roleShowCardRecords(params: {
+        server: string;
+        name: string;
+    }): Promise<GatewayEnvelope<T.ShowCardHistoryItem[]>>;
+    /** 在线状态 */
+    roleOnlineStatus(params: {
+        server: string;
+        name: string;
+    }): Promise<GatewayEnvelope<T.RoleOnlineStatus>>;
+    /** 批量在线（最多 10 个角色） */
+    rolesOnlineStatus(params: {
+        roles: T.RoleRef[];
+    }): Promise<GatewayEnvelope<Array<T.BatchResult<{
+        status: boolean;
+    }>>>>;
+    /** 装备列表（装备数据需要该服务器有在线游戏客户端） */
+    roleEquipList(params: {
+        server: string;
+        name: string;
+    }): Promise<GatewayEnvelope<T.RoleEquipListData>>;
+    /** 副本进度 */
+    roleCdList(params: {
+        server: string;
+        name: string;
+    }): Promise<GatewayEnvelope<T.RoleCdListData>>;
+    /** 批量副本（最多 10 个角色） */
+    rolesCdList(params: {
+        roles: T.RoleRef[];
+    }): Promise<GatewayEnvelope<Array<T.BatchResult<T.RoleCdListData>>>>;
+    /**
+     * 交易行物品搜索（需要在线游戏客户端）。
+     * quality：-1=任意 / 1..6=白绿蓝紫橙金；type_idx：物品分类索引，4=全部；page 为 1-indexed。
+     */
+    tradeItemSearch(params: {
+        server: string;
+        keyword: string;
+        quality?: number;
+        type_idx?: number;
+        page?: number;
+    }): Promise<GatewayEnvelope<T.ClientTradeItemSearchData>>;
+    /** 设计站点推荐（未实测：需要在线游戏客户端） */
+    design(params: T.DesignParams): Promise<GatewayEnvelope<T.DesignData>>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/esm/clients/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/clients/client.ts"],"names":[],"mappings":"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"}

package/dist/esm/clients/client.js

@@ -0,0 +1,74 @@
+import { HttpClient } from '../core/http.js';
+/** 客户端服务官方地址 */
+export const CLIENT_BASE_URL = 'https://submit.client.nicemoe.cn';
+/**
+ * 客户端服务（submit.client.nicemoe.cn，POST + JSON body，单入口 action 分发）。
+ * 响应信封 `{ status, detail }` 原样返回，不解包、业务错误不抛异常（自行判断 status；
+ * 业务错误时 detail 为错误描述字符串）。
+ *
+ * 部分接口（design / tradeItemSearch，以及 roleEquipList 的装备数据）依赖目标服务器
+ * 有已注册的游戏客户端在线，否则返回 status=503「无可用客户端」。
+ * 传 `baseUrl` 可指向自建代理 / 镜像，缺省用 {@link CLIENT_BASE_URL}。
+ */
+export class Jx3ClientApi extends HttpClient {
+    constructor(options) {
+        super(CLIENT_BASE_URL, options);
+    }
+    // ---------- 角色名片 ----------
+    /** 角色名片 */
+    roleShowCard(params) {
+        return this.post('role_show_card', { ...params });
+    }
+    /** 全部名片 */
+    roleShowCards(params) {
+        return this.post('role_show_cards', { ...params });
+    }
+    /** 名片缓存 */
+    roleShowCardCached(params) {
+        return this.post('role_show_card_cached', { ...params });
+    }
+    /** 随机名片（可按势力 / 体型筛选） */
+    roleShowCardRandom(params) {
+        return this.post('role_show_card_random', { ...params });
+    }
+    /** 历史名片 */
+    roleShowCardRecords(params) {
+        return this.post('role_show_card_records', { ...params });
+    }
+    // ---------- 在线状态 ----------
+    /** 在线状态 */
+    roleOnlineStatus(params) {
+        return this.post('role_online_status', { ...params });
+    }
+    /** 批量在线（最多 10 个角色） */
+    rolesOnlineStatus(params) {
+        return this.post('roles_online_status', { ...params });
+    }
+    // ---------- 装备副本 ----------
+    /** 装备列表（装备数据需要该服务器有在线游戏客户端） */
+    roleEquipList(params) {
+        return this.post('role_equip_list', { ...params });
+    }
+    /** 副本进度 */
+    roleCdList(params) {
+        return this.post('role_cd_list', { ...params });
+    }
+    /** 批量副本（最多 10 个角色） */
+    rolesCdList(params) {
+        return this.post('roles_cd_list', { ...params });
+    }
+    // ---------- 交易搜索 ----------
+    /**
+     * 交易行物品搜索（需要在线游戏客户端）。
+     * quality：-1=任意 / 1..6=白绿蓝紫橙金；type_idx：物品分类索引，4=全部；page 为 1-indexed。
+     */
+    tradeItemSearch(params) {
+        return this.post('trade_item_search', { ...params });
+    }
+    // ---------- 设计站点 ----------
+    /** 设计站点推荐（未实测：需要在线游戏客户端） */
+    design(params) {
+        return this.post('design', { ...params });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/clients/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/clients/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAyC,MAAM,iBAAiB,CAAC;AAGpF,gBAAgB;AAChB,MAAM,CAAC,MAAM,eAAe,GAAG,kCAAkC,CAAC;AAElE;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAa,SAAQ,UAAU;IAC1C,YAAY,OAAmB;QAC7B,KAAK,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,6BAA6B;IAE7B,WAAW;IACX,YAAY,CAAC,MAAwC;QACnD,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,WAAW;IACX,aAAa,CAAC,MAAwC;QACpD,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,WAAW;IACX,kBAAkB,CAAC,MAAwC;QACzD,OAAO,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,wBAAwB;IACxB,kBAAkB,CAAC,MAAyD;QAC1E,OAAO,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,WAAW;IACX,mBAAmB,CAAC,MAAwC;QAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,6BAA6B;IAE7B,WAAW;IACX,gBAAgB,CAAC,MAAwC;QACvD,OAAO,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,sBAAsB;IACtB,iBAAiB,CAAC,MAA8B;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,6BAA6B;IAE7B,+BAA+B;IAC/B,aAAa,CAAC,MAAwC;QACpD,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,WAAW;IACX,UAAU,CAAC,MAAwC;QACjD,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,sBAAsB;IACtB,WAAW,CAAC,MAA8B;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,6BAA6B;IAE7B;;;OAGG;IACH,eAAe,CAAC,MAMf;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,6BAA6B;IAE7B,4BAA4B;IAC5B,MAAM,CAAC,MAAsB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;CACF"}