finej3 1.0.0

package/dist/esm/index.d.ts

@@ -0,0 +1,48 @@
+export { Jx3Api, MAIN_BASE_URL } from './clients/main.js';
+export { Jx3SearchApi, SEARCH_BASE_URL } from './clients/search.js';
+export { Jx3ClientApi, CLIENT_BASE_URL } from './clients/client.js';
+export type { Jx3Options, Jx3Envelope, GatewayEnvelope } from './core/http.js';
+export type * from './types/main.js';
+export type * from './types/search.js';
+export type * from './types/client.js';
+import { Jx3Api } from './clients/main.js';
+import { Jx3SearchApi } from './clients/search.js';
+import { Jx3ClientApi } from './clients/client.js';
+import type { Jx3Options } from './core/http.js';
+/**
+ * 按服务覆盖地址。三个服务域名不同，且搜索 / 客户端服务都是 POST 到根路径，
+ * 因此必须分别指定，不能共用一个地址。省略的服务使用官方地址。
+ */
+export interface Jx3BaseUrls {
+    /** 主站，缺省 https://seasun.nicemoe.cn */
+    api?: string;
+    /** 搜索服务，缺省 https://search.client.nicemoe.cn */
+    search?: string;
+    /** 客户端服务，缺省 https://submit.client.nicemoe.cn */
+    client?: string;
+}
+export interface CreateJx3Options extends Omit<Jx3Options, 'baseUrl'> {
+    /** 按服务覆盖地址（自建代理 / 镜像 / 测试环境），可只覆盖其中一部分 */
+    baseUrl?: Jx3BaseUrls;
+}
+export interface Jx3Clients {
+    /** 主站（seasun.nicemoe.cn） */
+    api: Jx3Api;
+    /** 搜索服务（search.client.nicemoe.cn） */
+    search: Jx3SearchApi;
+    /** 客户端服务（submit.client.nicemoe.cn） */
+    client: Jx3ClientApi;
+}
+/**
+ * 一次性创建三个服务的客户端。
+ *
+ * @example
+ * ```ts
+ * const { api, search, client } = createJx3({ token, ticket });
+ *
+ * // 只把主站指向自建代理，其余走官方
+ * const clients = createJx3({ token, baseUrl: { api: 'https://my-proxy.example.com' } });
+ * ```
+ */
+export declare function createJx3(options: CreateJx3Options): Jx3Clients;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE/E,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,mBAAmB,CAAC;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC;IACnE,0CAA0C;IAC1C,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,MAAM,EAAE,YAAY,CAAC;IACrB,sCAAsC;IACtC,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU,CAO/D"}

package/dist/esm/index.js

@@ -0,0 +1,26 @@
+export { Jx3Api, MAIN_BASE_URL } from './clients/main.js';
+export { Jx3SearchApi, SEARCH_BASE_URL } from './clients/search.js';
+export { Jx3ClientApi, CLIENT_BASE_URL } from './clients/client.js';
+import { Jx3Api } from './clients/main.js';
+import { Jx3SearchApi } from './clients/search.js';
+import { Jx3ClientApi } from './clients/client.js';
+/**
+ * 一次性创建三个服务的客户端。
+ *
+ * @example
+ * ```ts
+ * const { api, search, client } = createJx3({ token, ticket });
+ *
+ * // 只把主站指向自建代理，其余走官方
+ * const clients = createJx3({ token, baseUrl: { api: 'https://my-proxy.example.com' } });
+ * ```
+ */
+export function createJx3(options) {
+    const { baseUrl, ...shared } = options;
+    return {
+        api: new Jx3Api({ ...shared, baseUrl: baseUrl?.api }),
+        search: new Jx3SearchApi({ ...shared, baseUrl: baseUrl?.search }),
+        client: new Jx3ClientApi({ ...shared, baseUrl: baseUrl?.client }),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAOpE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA8BnD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAC,OAAyB;IACjD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IACvC,OAAO;QACL,GAAG,EAAE,IAAI,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QACrD,MAAM,EAAE,IAAI,YAAY,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACjE,MAAM,EAAE,IAAI,YAAY,CAAC,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;KAClE,CAAC;AACJ,CAAC"}

package/dist/esm/package.json

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

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

@@ -0,0 +1,136 @@
+/**
+ * 客户端服务（submit.client.nicemoe.cn）响应类型。
+ * 字段依据 2026-07-20 实测采样推导。
+ * 注意：部分接口（design / trade_item_search / role_equip_list 的装备数据）依赖目标服务器
+ * 有已注册的游戏客户端在线，否则返回 503「无可用客户端」。
+ */
+import type { RawEquipItem } from './search.js';
+import type { RaidProgress } from './main.js';
+export interface ShowCard {
+    zoneName: string;
+    serverName: string;
+    roleName: string;
+    roleId: string;
+    globalRoleId: string;
+    showLike: number;
+    showHash: string;
+    showActive?: boolean;
+    showIndex: number;
+    showAvatar: string;
+    fileName: string;
+    cacheTime: number;
+}
+export interface ShowCardRandom {
+    zoneName: string;
+    serverName: string;
+    roleName: string;
+    roleId: string;
+    globalRoleId: string;
+    showHash: string;
+    showAvatar: string;
+    fileName: string;
+}
+export interface ShowCardHistoryItem {
+    zoneName: string;
+    serverName: string;
+    globalRoleId: string;
+    roleName: string;
+    fileName: string;
+    showHash: string;
+    showActive: boolean;
+    showIndex: number;
+    showAvatar: string;
+    lastEditTime: number;
+}
+export interface RoleOnlineStatus {
+    zoneName: string;
+    serverName: string;
+    roleName: string;
+    roleId: string;
+    globalRoleId: string;
+    onlineStatus: boolean;
+}
+/** 批量查询的角色标识 */
+export interface RoleRef {
+    server: string;
+    name: string;
+}
+/** 批量接口的单角色结果（status 非 200 时 detail 为空对象） */
+export interface BatchResult<T> {
+    status: number;
+    submit: string;
+    params: RoleRef;
+    detail: T | Record<string, never>;
+}
+export interface RoleEquipListData {
+    zoneName: string;
+    serverName: string;
+    roleName: string;
+    roleId: string;
+    globalRoleId: string;
+    /** 需要该服务器有在线游戏客户端时才有装备数据 */
+    equipList?: RawEquipItem[];
+    [key: string]: unknown;
+}
+/** 副本进度与主站 /raid/records 同构 */
+export type RoleCdListData = RaidProgress[];
+/** 交易行搜索结果中的物品详情 */
+export interface ClientTradeItemDetail {
+    dwSkillID: number;
+    nBindType: number;
+    nDetail: number;
+    nGenre: number;
+    nLevel: number;
+    nMaxDurability: number;
+    nQuality: number;
+    nStackNum: number;
+    nSub: number;
+    nUiId: number;
+    nVersion: number;
+    szName: string;
+}
+/** 交易行挂单价格，单位分别为金、银、铜 */
+export interface ClientTradeItemPrice {
+    nCopper: number;
+    nGold: number;
+    nSilver: number;
+}
+/** 交易行搜索结果中的单条挂单 */
+export interface ClientTradeItem {
+    CRC: number;
+    ID: number;
+    Item: ClientTradeItemDetail;
+    LastDurationTime: number;
+    LeftTime: number;
+    Price: ClientTradeItemPrice;
+    SellerName: string;
+    SellerNum: number;
+    StackNum: number;
+}
+/** 交易行搜索分页结果（需要在线游戏客户端） */
+export interface ClientTradeItemSearchData {
+    nPages: number;
+    nCount: number;
+    aItems: ClientTradeItem[];
+}
+/** 未实测：设计站点推荐（需要在线游戏客户端） */
+export interface DesignData {
+    [key: string]: unknown;
+}
+export interface DesignParams {
+    /** 服务器名称 */
+    server: string;
+    /** 1-indexed 页码 (1-50)，默认 1 */
+    page?: number;
+    /** 1=脸型 / 2=体型 / 3=穿搭 / 4=拍照，默认 1 */
+    data_type?: 1 | 2 | 3 | 4;
+    /** 体型过滤 (data_type 1/2/3 有效)，-1=不过滤 */
+    body_type?: number;
+    /** 脸型子类目 (仅 data_type=1 有效)，-1=不过滤 / 1=写实 / 2=写意 */
+    face_type?: number;
+    /** 封面尺寸 (仅 data_type=4 有效)，-1=不过滤 */
+    cover_size_type?: number;
+    /** 上传源 (仅 data_type=4 有效)，""=不过滤 / "dx"=旗舰端 */
+    upload_source?: string;
+}
+//# sourceMappingURL=client.d.ts.map

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

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

package/dist/esm/types/client.js

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

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

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