finej3 2.1.0 → 2.3.0

package/README.md

@@ -2,7 +2,19 @@
 
 剑网 3 API 的 TypeScript SDK，无运行时依赖，支持 Node.js 18+、ESM、CommonJS 和类型声明。
 
-当前实现面向 `nico.nicemoe.cn` 的新版 HTTP API，共包含主站 88 个、搜索服务 12 个、客户端服务 15 个方法。不包含 WebSocket 推送。
+当前实现包含主站 88 个、搜索服务 12 个、客户端服务 15 个和计算器服务 2 个方法，共 117 个 HTTP 接口。不包含 WebSocket 推送。
+
+## 2.3.0 版本说明
+
+- `calcd.calculateDps` 增加可选 `fillMinimumHaste` 的类型适配，供支持补足加速试算的计算器服务使用。
+- 补充 `hasteAdjustment` 和 `hasteShortfall` 类型，区分原始装备加速与试算加速。
+- 增加参数透传、补足结果和错误诊断的回归检查。
+
+## 2.2.0 版本说明
+
+- 新增独立 `calcd` 客户端，通过 `listRotations` 查询循环目录，通过 `calculateDps` 提交装备快照计算 DPS。
+- 按计算器 OpenAPI 定义完整类型，保留原始成功数据、错误对象及 422 加速不匹配诊断。
+- 支持数字字符串装备参数和可空镶嵌字段，提供两个接口的路由、错误响应及凭证隔离测试。
 
 ## 2.1.0 版本说明
 
@@ -59,7 +71,9 @@ SDK 不自动读取环境变量或加载 `.env`。公开接口可省略 `token`
 
 ## 响应与错误
 
-三个客户端都原样返回 `{ status, detail }`。`status === 200` 表示成功，业务错误的 `detail` 为字符串。错误码范围未被文档限定，使用 `isSuccess(response)` 在 TypeScript 中安全收窄分支。
+主站、搜索和客户端服务都原样返回 `{ status, detail }`。`status === 200` 表示成功，业务错误的 `detail` 为字符串。错误码范围未被文档限定，使用 `isSuccess(response)` 在 TypeScript 中安全收窄分支。
+
+计算器服务返回原始成功数据或 `{ code, message, details? }` 错误对象，通过 `'code' in response` 收窄错误分支。HTTP 422 的加速不匹配错误可能包含实际加速、延迟档和可用循环档位。
 
 部分成功响应允许 `detail` 为 `{}` 或 `null`，类型中保留这些情况。榜单在查询全服时返回数组，指定服务器时返回分组对象；空字符串也表示全服，因此方法不会仅凭 `server: string` 就断言一定返回单对象。
 
@@ -74,14 +88,45 @@ SDK 不自动读取环境变量或加载 `.env`。公开接口可省略 `token`
 | `api` | `https://nico.nicemoe.cn` |
 | `search` | `https://nico.nicemoe.cn/search/submit` |
 | `client` | `https://nico.nicemoe.cn/client/submit` |
+| `calcd` | `https://calcd.nicemoe.cn` |
+
+可传入自定义 `fetch`，或通过 `baseUrl: { api, search, client, calcd }` 分别覆盖入口。`api` 和 `calcd` 是 URL 前缀，`search` 和 `client` 是完整的 POST 提交地址。
+
+## 计算器接口
+
+`calcd.listRotations({ spec? })` 调用 `GET /v1/rotations` 获取心法循环目录。`calcd.calculateDps({ rotationId, role })` 调用 `POST /v1/dps`，使用目录中的循环 ID 和角色原始装备快照计算木桩 DPS。两个接口均为公开接口。
+
+若返回 `HASTE_MISMATCH` 且 `details.hasteShortfall` 为正数，可用同一份快照调用 `calcd.calculateDps({ rotationId, role, fillMinimumHaste: true })`。实际补足后，`haste` 仍是装备加速，`hasteAdjustment` 提供 `addedHaste`（补足点数）和 `simulatedHaste`（试算加速）。正常结果省略该对象。
+
+2026-11-13 发布前实测时，公开计算器接口传入 `fillMinimumHaste` 会返回 `INVALID_REQUEST`。此选项需在所连接的服务端支持后启用。
+
+```ts
+import { createJx3, type CalcdRole } from 'finej3';
+
+const { calcd } = createJx3();
+const catalog = await calcd.listRotations({ spec: 'shxj' });
+if ('code' in catalog) throw new Error(catalog.message);
+console.log(catalog.specs[0]?.rotations);
+
+async function calculate(rotationId: string, role: CalcdRole) {
+  const result = await calcd.calculateDps({ rotationId, role });
+  if ('code' in result) {
+    console.log(result.code, result.message, result.details);
+    return;
+  }
+  console.log(result.dps, result.skills, result.enchantGains);
+}
+```
+
+`role` 可使用 `search.roleEquipDetail` 默认客户端格式的有效 `detail` 对象。必填字段为 `serverName`、`roleName`、`kungfuName` 和 `equipList`，额外快照字段会原样传递。装备数值字段支持文档规定的整数或数字字符串，镶嵌字段保留 `null` 和空槽。
 
-可传入自定义 `fetch`，或通过 `baseUrl: { api, search, client }` 分别覆盖入口。`api` 是 URL 前缀；另外两项是完整的 POST 提交地址，SDK 不再追加路径。
+`baselineAvailable` 表示循环的固定基准可用性，实际角色加速仍需匹配档位。查询或计算失败时可读取 `code`、`message`，以及可选的 `details.availableVariants`。完整字段定义依据[计算器 OpenAPI](https://nico.nicemoe.cn/doc/json/openapi.calcd.json)。
 
 ## 补充接口
 
 | 方法 | 用途与参数 |
 | --- | --- |
-| `api.calcdCalculate({ server, name, page?, cycle? })` | DPS 计算，`page` 支持 `pvedps` 和 `界pvedps` |
+| `api.calcdCalculate({ server, name, page?, cycle? })` | 主站代理 DPS 计算，`page` 支持 `pvedps` 和 `界pvedps` |
 | `api.chatContent({ server, name, limit?, page? })` | 合并补充记录后去重分页，返回聊天记录数组 |
 | `api.raidRecords({ server, name })` | 主站团队副本进度 |
 | `api.roleBatch({ ids })` | 批量角色资料，`ids` 为非空字符串数组，通过 POST JSON 发送 |
@@ -152,7 +197,7 @@ npm test
 npm run verify-package
 ```
 
-`npm run prepublishOnly` 依次运行以上检查，不执行发布。`npm test` 使用本地 HTTP 服务验证全部 115 个方法的路由、参数和鉴权，并检查错误响应、空值、超时及自定义入口；运行前需要构建。
+`npm run prepublishOnly` 依次运行以上检查，不执行发布。`npm test` 验证 117 个接口的路由、参数和响应，包括计算器原始错误、422 诊断及凭证隔离，并检查空值、超时及自定义入口。运行前需要构建。
 
 `npm run verify-package` 还会通过包名编译 `.mts` / `.cts` 消费者，检查两种模块解析模式下的类型入口，并确认声明文件包含在发布包中。
 

package/dist/cjs/clients/calcd.d.ts

@@ -0,0 +1,14 @@
+import { HttpClient, type Jx3Options } from '../core/http.js';
+import type * as T from '../types/calcd.js';
+export declare const CALCD_BASE_URL = "https://calcd.nicemoe.cn";
+export type Jx3CalcdOptions = Pick<Jx3Options, 'baseUrl' | 'fetch' | 'timeoutMs'>;
+/** 独立计算器服务，原样返回成功数据或 { code, message, details? } 错误。 */
+export declare class Jx3CalcdApi extends HttpClient {
+    constructor({ baseUrl, fetch, timeoutMs }?: Jx3CalcdOptions);
+    /** 循环目录。spec 为心法简写，省略时查询全部心法。 */
+    listRotations(params?: {
+        spec?: string;
+    }): Promise<T.CalcdRotationsData | T.CalcdError>;
+    /** 按目录 rotationId 和角色原始装备快照计算木桩 DPS。 */
+    calculateDps<Role extends T.CalcdRole>(params: T.CalcdDpsParams<Role>): Promise<T.CalcdDpsData | T.CalcdError>;
+}

package/dist/cjs/clients/calcd.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Jx3CalcdApi = exports.CALCD_BASE_URL = void 0;
+const http_js_1 = require("../core/http.js");
+exports.CALCD_BASE_URL = 'https://calcd.nicemoe.cn';
+function isCalcdError(value) {
+    return value !== null && typeof value === 'object'
+        && 'code' in value && typeof value.code === 'string'
+        && 'message' in value && typeof value.message === 'string';
+}
+/** 独立计算器服务，原样返回成功数据或 { code, message, details? } 错误。 */
+class Jx3CalcdApi extends http_js_1.HttpClient {
+    constructor({ baseUrl, fetch, timeoutMs } = {}) {
+        super(exports.CALCD_BASE_URL, { baseUrl, fetch, timeoutMs });
+    }
+    /** 循环目录。spec 为心法简写，省略时查询全部心法。 */
+    async listRotations(params = {}) {
+        const query = new URLSearchParams();
+        if (params.spec !== undefined)
+            query.set('spec', params.spec);
+        const suffix = query.toString();
+        const { body } = await this.requestJson(`/v1/rotations${suffix ? `?${suffix}` : ''}`, { method: 'GET' }, '/v1/rotations');
+        if (isCalcdError(body))
+            return body;
+        if (body !== null && typeof body === 'object' && 'specs' in body && Array.isArray(body.specs)) {
+            return body;
+        }
+        throw new Error('finej3: [/v1/rotations] 响应不符合计算器目录格式');
+    }
+    /** 按目录 rotationId 和角色原始装备快照计算木桩 DPS。 */
+    async calculateDps(params) {
+        const { body } = await this.requestJson('/v1/dps', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(params),
+        }, '/v1/dps');
+        if (isCalcdError(body))
+            return body;
+        if (body !== null && typeof body === 'object' && 'dps' in body && typeof body.dps === 'number') {
+            return body;
+        }
+        throw new Error('finej3: [/v1/dps] 响应不符合计算器结果格式');
+    }
+}
+exports.Jx3CalcdApi = Jx3CalcdApi;
+//# sourceMappingURL=calcd.js.map

package/dist/cjs/clients/calcd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calcd.js","sourceRoot":"","sources":["../../../src/clients/calcd.ts"],"names":[],"mappings":";;;AAAA,6CAA8D;AAGjD,QAAA,cAAc,GAAG,0BAA0B,CAAC;AAGzD,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;WAC7C,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;WACjD,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC;AAC/D,CAAC;AAED,wDAAwD;AACxD,MAAa,WAAY,SAAQ,oBAAU;IACzC,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,KAAsB,EAAE;QAC7D,KAAK,CAAC,sBAAc,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,aAAa,CAAC,SAA4B,EAAE;QAChD,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,eAAe,CAAC,CAAC;QAC1H,IAAI,YAAY,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9F,OAAO,IAA4B,CAAC;QACtC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,YAAY,CAA2B,MAA8B;QACzE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE;YACjD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;SAC7B,EAAE,SAAS,CAAC,CAAC;QACd,IAAI,YAAY,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC/F,OAAO,IAAsB,CAAC;QAChC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;CACF;AA/BD,kCA+BC"}

package/dist/cjs/core/http.d.ts

@@ -33,6 +33,11 @@ export declare class HttpClient {
     private readonly baseUrl;
     constructor(defaultBaseUrl: string, options: Jx3Options);
     protected requireTicket(ticket: string | undefined, endpoint: string): string;
+    /** 共用请求、鉴权、超时及 JSON 解析，响应格式由各服务处理。 */
+    protected requestJson(path: string, init: RequestInit, endpoint: string): Promise<{
+        status: number;
+        body: unknown;
+    }>;
     private fetchJson;
     /** 主站 GET；null 和 undefined 都按未传参处理，token 只放请求头。 */
     protected get<T>(path: string, params: object): Promise<Jx3Envelope<T>>;

package/dist/cjs/core/http.js

@@ -19,11 +19,12 @@ class HttpClient {
         }
         return value;
     }
-    async fetchJson(url, init, endpoint) {
+    /** 共用请求、鉴权、超时及 JSON 解析，响应格式由各服务处理。 */
+    async requestJson(path, init, endpoint) {
         const headers = new Headers(init.headers);
         if (this.options.token)
             headers.set('token', this.options.token);
-        const response = await (this.options.fetch ?? fetch)(url, {
+        const response = await (this.options.fetch ?? fetch)(`${this.baseUrl}${path}`, {
             ...init,
             headers,
             signal: AbortSignal.timeout(this.options.timeoutMs ?? 30000),
@@ -36,10 +37,14 @@ class HttpClient {
         catch {
             throw new Error(`finej3: [${endpoint}] 响应不是合法 JSON (http ${response.status})`);
         }
+        return { status: response.status, body };
+    }
+    async fetchJson(path, init, endpoint) {
+        const { status, body } = await this.requestJson(path, init, endpoint);
         if (body === null || typeof body !== 'object' || !('status' in body)
             || !Number.isInteger(body.status) || !('detail' in body)
             || (body.status !== 200 && typeof body.detail !== 'string')) {
-            throw new Error(`finej3: [${endpoint}] 响应不符合 { status, detail } 格式 (http ${response.status})`);
+            throw new Error(`finej3: [${endpoint}] 响应不符合 { status, detail } 格式 (http ${status})`);
         }
         return body;
     }
@@ -52,11 +57,11 @@ class HttpClient {
         }
         const encoded = query.toString();
         const suffix = encoded ? `?${encoded}` : '';
-        return this.fetchJson(`${this.baseUrl}${path}${suffix}`, { method: 'GET' }, path);
+        return this.fetchJson(`${path}${suffix}`, { method: 'GET' }, path);
     }
     /** 网关 action 使用 JSON body，token 通过请求头传入。 */
     post(action, payload) {
-        return this.fetchJson(this.baseUrl, {
+        return this.fetchJson('', {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({ ...payload, action }),
@@ -64,7 +69,7 @@ class HttpClient {
     }
     /** 主站路径使用 JSON body，支持批量 ID 等数组参数。 */
     postPath(path, payload) {
-        return this.fetchJson(`${this.baseUrl}${path}`, {
+        return this.fetchJson(path, {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify(payload),

package/dist/cjs/core/http.js.map

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

package/dist/cjs/index.d.ts

@@ -1,17 +1,20 @@
 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 { Jx3CalcdApi, CALCD_BASE_URL, type Jx3CalcdOptions } from './clients/calcd.js';
 export { isSuccess } from './core/http.js';
 export type { Jx3Options, Jx3Envelope, Jx3SuccessEnvelope, Jx3ErrorEnvelope, EmptyObject, GatewayEnvelope, GatewaySuccessEnvelope, GatewayErrorEnvelope, GatewayErrorStatus } from './core/http.js';
 export type * from './types/main.js';
 export type * from './types/search.js';
 export type * from './types/client.js';
+export type * from './types/calcd.js';
 import { Jx3Api } from './clients/main.js';
 import { Jx3SearchApi } from './clients/search.js';
 import { Jx3ClientApi } from './clients/client.js';
+import { Jx3CalcdApi } from './clients/calcd.js';
 import type { Jx3Options } from './core/http.js';
 /**
- * 按服务覆盖地址。主站为 URL 前缀，搜索和客户端为完整提交入口。
+ * 按服务覆盖地址。主站和计算器为 URL 前缀，搜索和客户端为完整提交入口。
  * 省略的服务使用官方地址。
  */
 export interface Jx3BaseUrls {
@@ -21,6 +24,8 @@ export interface Jx3BaseUrls {
     search?: string;
     /** 客户端服务，缺省 https://nico.nicemoe.cn/client/submit */
     client?: string;
+    /** 计算器，缺省 https://calcd.nicemoe.cn */
+    calcd?: string;
 }
 export interface CreateJx3Options extends Omit<Jx3Options, 'baseUrl'> {
     /** 按服务覆盖地址（自建代理 / 镜像 / 测试环境），可只覆盖其中一部分 */
@@ -33,9 +38,11 @@ export interface Jx3Clients {
     search: Jx3SearchApi;
     /** 客户端服务 */
     client: Jx3ClientApi;
+    /** 公开计算器服务 */
+    calcd: Jx3CalcdApi;
 }
 /**
- * 一次性创建三个服务的客户端。
+ * 一次性创建四个服务的客户端。
  *
  * @example
  * ```ts

package/dist/cjs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSuccess = exports.CLIENT_BASE_URL = exports.Jx3ClientApi = exports.SEARCH_BASE_URL = exports.Jx3SearchApi = exports.MAIN_BASE_URL = exports.Jx3Api = void 0;
+exports.isSuccess = exports.CALCD_BASE_URL = exports.Jx3CalcdApi = exports.CLIENT_BASE_URL = exports.Jx3ClientApi = exports.SEARCH_BASE_URL = exports.Jx3SearchApi = exports.MAIN_BASE_URL = exports.Jx3Api = void 0;
 exports.createJx3 = createJx3;
 var main_js_1 = require("./clients/main.js");
 Object.defineProperty(exports, "Jx3Api", { enumerable: true, get: function () { return main_js_1.Jx3Api; } });
@@ -11,13 +11,17 @@ Object.defineProperty(exports, "SEARCH_BASE_URL", { enumerable: true, get: funct
 var client_js_1 = require("./clients/client.js");
 Object.defineProperty(exports, "Jx3ClientApi", { enumerable: true, get: function () { return client_js_1.Jx3ClientApi; } });
 Object.defineProperty(exports, "CLIENT_BASE_URL", { enumerable: true, get: function () { return client_js_1.CLIENT_BASE_URL; } });
+var calcd_js_1 = require("./clients/calcd.js");
+Object.defineProperty(exports, "Jx3CalcdApi", { enumerable: true, get: function () { return calcd_js_1.Jx3CalcdApi; } });
+Object.defineProperty(exports, "CALCD_BASE_URL", { enumerable: true, get: function () { return calcd_js_1.CALCD_BASE_URL; } });
 var http_js_1 = require("./core/http.js");
 Object.defineProperty(exports, "isSuccess", { enumerable: true, get: function () { return http_js_1.isSuccess; } });
 const main_js_2 = require("./clients/main.js");
 const search_js_2 = require("./clients/search.js");
 const client_js_2 = require("./clients/client.js");
+const calcd_js_2 = require("./clients/calcd.js");
 /**
- * 一次性创建三个服务的客户端。
+ * 一次性创建四个服务的客户端。
  *
  * @example
  * ```ts
@@ -33,6 +37,7 @@ function createJx3(options = {}) {
         api: new main_js_2.Jx3Api({ ...shared, baseUrl: baseUrl?.api }),
         search: new search_js_2.Jx3SearchApi({ ...shared, baseUrl: baseUrl?.search }),
         client: new client_js_2.Jx3ClientApi({ ...shared, baseUrl: baseUrl?.client }),
+        calcd: new calcd_js_2.Jx3CalcdApi({ fetch: shared.fetch, timeoutMs: shared.timeoutMs, baseUrl: baseUrl?.calcd }),
     };
 }
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AA+CA,8BAOC;AAtDD,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;AACtC,0CAA2C;AAAlC,oGAAA,SAAS,OAAA;AAKlB,+CAA2C;AAC3C,mDAAmD;AACnD,mDAAmD;AA0BnD;;;;;;;;;;GAUG;AACH,SAAgB,SAAS,CAAC,UAA4B,EAAE;IACtD,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAsDA,8BAQC;AA9DD,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;AACtC,+CAAuF;AAA9E,uGAAA,WAAW,OAAA;AAAE,0GAAA,cAAc,OAAA;AACpC,0CAA2C;AAAlC,oGAAA,SAAS,OAAA;AAMlB,+CAA2C;AAC3C,mDAAmD;AACnD,mDAAmD;AACnD,iDAAiD;AA8BjD;;;;;;;;;;GAUG;AACH,SAAgB,SAAS,CAAC,UAA4B,EAAE;IACtD,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;QACjE,KAAK,EAAE,IAAI,sBAAW,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;KACtG,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,121 @@
+/** 计算器类型依据 openapi.calcd.json 的完整 schema。 */
+/** 循环的加速、延迟档位。 */
+export interface CalcdVariant {
+    index: number;
+    /** 加速值区间 [下限, 上限)，为 null 时使用 hasteTier。 */
+    hasteRange: [number, number] | null;
+    hasteTier: number | null;
+    latencyTier: number | null;
+    durationSeconds: number;
+}
+export interface CalcdRotation {
+    rotationId: string;
+    name: string;
+    title: string;
+    weapon: string | null;
+    strictHaste: boolean;
+    /** 基准可用仍需校验角色实际加速。 */
+    baselineAvailable: boolean;
+    unavailableReason: string | null;
+    variants: CalcdVariant[];
+}
+export interface CalcdSpec {
+    spec: string;
+    name: string;
+    rotations: CalcdRotation[];
+}
+export interface CalcdRotationsData {
+    specs: CalcdSpec[];
+}
+/** 整数及数字字符串由服务端按字段约束校验。 */
+export type CalcdIntegerInput = number | string;
+export type CalcdGemSlots = Array<CalcdIntegerInput[] | null> | null;
+/** 客户端格式的装备条目，支持文档中的两套镶嵌字段。 */
+export interface CalcdEquipmentItem {
+    nItemIndex: CalcdIntegerInput;
+    dwTabIndex: CalcdIntegerInput;
+    dwTabType?: CalcdIntegerInput;
+    /** 精炼等级 0～10，省略时按 0 计算。 */
+    nStrengthLevel?: CalcdIntegerInput;
+    dwPermanentEnchantID?: CalcdIntegerInput;
+    dwTemporaryEnchantID?: CalcdIntegerInput;
+    aMountDiamond?: CalcdGemSlots;
+    aSlotItem?: CalcdGemSlots;
+    aColorDiamond?: CalcdIntegerInput[] | null;
+    ColorInfo?: CalcdGemSlots;
+}
+/** 可直接传入原始装备查询的成功 detail 对象。 */
+export interface CalcdRole {
+    serverName: string;
+    roleName: string;
+    kungfuName: string;
+    equipList: CalcdEquipmentItem[];
+}
+/** role 和装备条目允许额外字段，保留调用方快照中的信息。 */
+export interface CalcdDpsParams<Role extends CalcdRole = CalcdRole> {
+    rotationId: string;
+    role: Role;
+    /** 仅在实际加速低于所选循环最低可用档时，补到该档试算。默认关闭。 */
+    fillMinimumHaste?: boolean;
+}
+export interface CalcdDpsSkill {
+    name: string;
+    count: number;
+    damage: number;
+    dps: number;
+    sharePct: number;
+}
+export interface CalcdEnchantGain {
+    stat: string;
+    amount: number;
+    dps: number;
+    deltaDps: number;
+    gainPct: number;
+}
+export interface CalcdDpsData {
+    character: {
+        server: string;
+        roleName: string;
+        kungfu: string;
+    };
+    spec: string;
+    rotationId: string;
+    baseline: {
+        target: string;
+        latencyTier: number;
+        externalBuffs: boolean;
+    };
+    haste: number;
+    /** 仅补足试算返回；haste 始终为原始装备加速。 */
+    hasteAdjustment?: {
+        addedHaste: number;
+        simulatedHaste: number;
+    };
+    matchedVariant: CalcdVariant;
+    durationSeconds: number;
+    totalDamage: number;
+    dps: number;
+    skills: CalcdDpsSkill[];
+    enchantGains: CalcdEnchantGain[];
+    equipment: {
+        received: number;
+        recognized: number;
+    };
+    warnings: string[];
+}
+/** HTTP 422 的 HASTE_MISMATCH 错误可提供此诊断信息。 */
+export interface CalcdHasteMismatchDetails {
+    actualHaste: number;
+    /** 低于最低可用档时，补足到该档所需的点数。 */
+    hasteShortfall?: number;
+    actualHasteTier: number;
+    latencyTier: number;
+    availableVariants: CalcdVariant[];
+    warnings: string[];
+}
+/** 计算器错误原样返回，以 'code' in response 收窄。 */
+export interface CalcdError {
+    code: string;
+    message: string;
+    details?: CalcdHasteMismatchDetails;
+}

package/dist/cjs/types/calcd.js

@@ -0,0 +1,4 @@
+"use strict";
+/** 计算器类型依据 openapi.calcd.json 的完整 schema。 */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=calcd.js.map

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

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

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

@@ -0,0 +1,15 @@
+import { HttpClient, type Jx3Options } from '../core/http.js';
+import type * as T from '../types/calcd.js';
+export declare const CALCD_BASE_URL = "https://calcd.nicemoe.cn";
+export type Jx3CalcdOptions = Pick<Jx3Options, 'baseUrl' | 'fetch' | 'timeoutMs'>;
+/** 独立计算器服务，原样返回成功数据或 { code, message, details? } 错误。 */
+export declare class Jx3CalcdApi extends HttpClient {
+    constructor({ baseUrl, fetch, timeoutMs }?: Jx3CalcdOptions);
+    /** 循环目录。spec 为心法简写，省略时查询全部心法。 */
+    listRotations(params?: {
+        spec?: string;
+    }): Promise<T.CalcdRotationsData | T.CalcdError>;
+    /** 按目录 rotationId 和角色原始装备快照计算木桩 DPS。 */
+    calculateDps<Role extends T.CalcdRole>(params: T.CalcdDpsParams<Role>): Promise<T.CalcdDpsData | T.CalcdError>;
+}
+//# sourceMappingURL=calcd.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calcd.d.ts","sourceRoot":"","sources":["../../../src/clients/calcd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,KAAK,CAAC,MAAM,mBAAmB,CAAC;AAE5C,eAAO,MAAM,cAAc,6BAA6B,CAAC;AACzD,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC,CAAC;AAQlF,wDAAwD;AACxD,qBAAa,WAAY,SAAQ,UAAU;gBAC7B,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAE,eAAoB;IAI/D,iCAAiC;IAC3B,aAAa,CAAC,MAAM,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,CAAC,CAAC,kBAAkB,GAAG,CAAC,CAAC,UAAU,CAAC;IAYjG,wCAAwC;IAClC,YAAY,CAAC,IAAI,SAAS,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,UAAU,CAAC;CAYrH"}

package/dist/esm/clients/calcd.js

@@ -0,0 +1,42 @@
+import { HttpClient } from '../core/http.js';
+export const CALCD_BASE_URL = 'https://calcd.nicemoe.cn';
+function isCalcdError(value) {
+    return value !== null && typeof value === 'object'
+        && 'code' in value && typeof value.code === 'string'
+        && 'message' in value && typeof value.message === 'string';
+}
+/** 独立计算器服务，原样返回成功数据或 { code, message, details? } 错误。 */
+export class Jx3CalcdApi extends HttpClient {
+    constructor({ baseUrl, fetch, timeoutMs } = {}) {
+        super(CALCD_BASE_URL, { baseUrl, fetch, timeoutMs });
+    }
+    /** 循环目录。spec 为心法简写，省略时查询全部心法。 */
+    async listRotations(params = {}) {
+        const query = new URLSearchParams();
+        if (params.spec !== undefined)
+            query.set('spec', params.spec);
+        const suffix = query.toString();
+        const { body } = await this.requestJson(`/v1/rotations${suffix ? `?${suffix}` : ''}`, { method: 'GET' }, '/v1/rotations');
+        if (isCalcdError(body))
+            return body;
+        if (body !== null && typeof body === 'object' && 'specs' in body && Array.isArray(body.specs)) {
+            return body;
+        }
+        throw new Error('finej3: [/v1/rotations] 响应不符合计算器目录格式');
+    }
+    /** 按目录 rotationId 和角色原始装备快照计算木桩 DPS。 */
+    async calculateDps(params) {
+        const { body } = await this.requestJson('/v1/dps', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(params),
+        }, '/v1/dps');
+        if (isCalcdError(body))
+            return body;
+        if (body !== null && typeof body === 'object' && 'dps' in body && typeof body.dps === 'number') {
+            return body;
+        }
+        throw new Error('finej3: [/v1/dps] 响应不符合计算器结果格式');
+    }
+}
+//# sourceMappingURL=calcd.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calcd.js","sourceRoot":"","sources":["../../../src/clients/calcd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAmB,MAAM,iBAAiB,CAAC;AAG9D,MAAM,CAAC,MAAM,cAAc,GAAG,0BAA0B,CAAC;AAGzD,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;WAC7C,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;WACjD,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC;AAC/D,CAAC;AAED,wDAAwD;AACxD,MAAM,OAAO,WAAY,SAAQ,UAAU;IACzC,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,KAAsB,EAAE;QAC7D,KAAK,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,aAAa,CAAC,SAA4B,EAAE;QAChD,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;QACpC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,eAAe,CAAC,CAAC;QAC1H,IAAI,YAAY,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9F,OAAO,IAA4B,CAAC;QACtC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,YAAY,CAA2B,MAA8B;QACzE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE;YACjD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;SAC7B,EAAE,SAAS,CAAC,CAAC;QACd,IAAI,YAAY,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC/F,OAAO,IAAsB,CAAC;QAChC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;CACF"}

package/dist/esm/core/http.d.ts

@@ -33,6 +33,11 @@ export declare class HttpClient {
     private readonly baseUrl;
     constructor(defaultBaseUrl: string, options: Jx3Options);
     protected requireTicket(ticket: string | undefined, endpoint: string): string;
+    /** 共用请求、鉴权、超时及 JSON 解析，响应格式由各服务处理。 */
+    protected requestJson(path: string, init: RequestInit, endpoint: string): Promise<{
+        status: number;
+        body: unknown;
+    }>;
     private fetchJson;
     /** 主站 GET；null 和 undefined 都按未传参处理，token 只放请求头。 */
     protected get<T>(path: string, params: object): Promise<Jx3Envelope<T>>;

package/dist/esm/core/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/core/http.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEpD,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,CAAC,CAAC;CACX;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uCAAuC;AACvC,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC;AAEtE,wBAAgB,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAExF;AAED,mCAAmC;AACnC,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;AAChD,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAC9D,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AACpD,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAIxC,qBAAa,UAAU;IACrB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU;IAKvD,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;YAQ/D,SAAS;IAuBvB,mDAAmD;IACnD,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAUvE,4CAA4C;IAC5C,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAQ3E,sCAAsC;IACtC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAO9E"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/core/http.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEpD,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,MAAM,EAAE,GAAG,CAAC;IACZ,MAAM,EAAE,CAAC,CAAC;CACX;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uCAAuC;AACvC,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC;AAEtE,wBAAgB,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAExF;AAED,mCAAmC;AACnC,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;AAChD,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC;AAC9D,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC;AACpD,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAIxC,qBAAa,UAAU;IACrB,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU;IAKvD,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQ7E,sCAAsC;cACtB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;YAkB5G,SAAS;IAUvB,mDAAmD;IACnD,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAUvE,4CAA4C;IAC5C,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAQ3E,sCAAsC;IACtC,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAO9E"}

package/dist/esm/core/http.js

@@ -15,11 +15,12 @@ export class HttpClient {
         }
         return value;
     }
-    async fetchJson(url, init, endpoint) {
+    /** 共用请求、鉴权、超时及 JSON 解析，响应格式由各服务处理。 */
+    async requestJson(path, init, endpoint) {
         const headers = new Headers(init.headers);
         if (this.options.token)
             headers.set('token', this.options.token);
-        const response = await (this.options.fetch ?? fetch)(url, {
+        const response = await (this.options.fetch ?? fetch)(`${this.baseUrl}${path}`, {
             ...init,
             headers,
             signal: AbortSignal.timeout(this.options.timeoutMs ?? 30000),
@@ -32,10 +33,14 @@ export class HttpClient {
         catch {
             throw new Error(`finej3: [${endpoint}] 响应不是合法 JSON (http ${response.status})`);
         }
+        return { status: response.status, body };
+    }
+    async fetchJson(path, init, endpoint) {
+        const { status, body } = await this.requestJson(path, init, endpoint);
         if (body === null || typeof body !== 'object' || !('status' in body)
             || !Number.isInteger(body.status) || !('detail' in body)
             || (body.status !== 200 && typeof body.detail !== 'string')) {
-            throw new Error(`finej3: [${endpoint}] 响应不符合 { status, detail } 格式 (http ${response.status})`);
+            throw new Error(`finej3: [${endpoint}] 响应不符合 { status, detail } 格式 (http ${status})`);
         }
         return body;
     }
@@ -48,11 +53,11 @@ export class HttpClient {
         }
         const encoded = query.toString();
         const suffix = encoded ? `?${encoded}` : '';
-        return this.fetchJson(`${this.baseUrl}${path}${suffix}`, { method: 'GET' }, path);
+        return this.fetchJson(`${path}${suffix}`, { method: 'GET' }, path);
     }
     /** 网关 action 使用 JSON body，token 通过请求头传入。 */
     post(action, payload) {
-        return this.fetchJson(this.baseUrl, {
+        return this.fetchJson('', {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({ ...payload, action }),
@@ -60,7 +65,7 @@ export class HttpClient {
     }
     /** 主站路径使用 JSON body，支持批量 ID 等数组参数。 */
     postPath(path, payload) {
-        return this.fetchJson(`${this.baseUrl}${path}`, {
+        return this.fetchJson(path, {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify(payload),

package/dist/esm/core/http.js.map

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

package/dist/esm/index.d.ts

@@ -1,17 +1,20 @@
 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 { Jx3CalcdApi, CALCD_BASE_URL, type Jx3CalcdOptions } from './clients/calcd.js';
 export { isSuccess } from './core/http.js';
 export type { Jx3Options, Jx3Envelope, Jx3SuccessEnvelope, Jx3ErrorEnvelope, EmptyObject, GatewayEnvelope, GatewaySuccessEnvelope, GatewayErrorEnvelope, GatewayErrorStatus } from './core/http.js';
 export type * from './types/main.js';
 export type * from './types/search.js';
 export type * from './types/client.js';
+export type * from './types/calcd.js';
 import { Jx3Api } from './clients/main.js';
 import { Jx3SearchApi } from './clients/search.js';
 import { Jx3ClientApi } from './clients/client.js';
+import { Jx3CalcdApi } from './clients/calcd.js';
 import type { Jx3Options } from './core/http.js';
 /**
- * 按服务覆盖地址。主站为 URL 前缀，搜索和客户端为完整提交入口。
+ * 按服务覆盖地址。主站和计算器为 URL 前缀，搜索和客户端为完整提交入口。
  * 省略的服务使用官方地址。
  */
 export interface Jx3BaseUrls {
@@ -21,6 +24,8 @@ export interface Jx3BaseUrls {
     search?: string;
     /** 客户端服务，缺省 https://nico.nicemoe.cn/client/submit */
     client?: string;
+    /** 计算器，缺省 https://calcd.nicemoe.cn */
+    calcd?: string;
 }
 export interface CreateJx3Options extends Omit<Jx3Options, 'baseUrl'> {
     /** 按服务覆盖地址（自建代理 / 镜像 / 测试环境），可只覆盖其中一部分 */
@@ -33,9 +38,11 @@ export interface Jx3Clients {
     search: Jx3SearchApi;
     /** 客户端服务 */
     client: Jx3ClientApi;
+    /** 公开计算器服务 */
+    calcd: Jx3CalcdApi;
 }
 /**
- * 一次性创建三个服务的客户端。
+ * 一次性创建四个服务的客户端。
  *
  * @example
  * ```ts

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

@@ -1 +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,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpM,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,mBAAmB,CAAC;AACvC,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;AACjD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC;IACnE,0CAA0C;IAC1C,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AACD,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY;IACZ,MAAM,EAAE,YAAY,CAAC;CACtB;AACD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,UAAU,CAOpE"}
+{"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,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,WAAW,EAAE,eAAe,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpM,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,kBAAkB,CAAC;AACtC,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,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC;IACnE,0CAA0C;IAC1C,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AACD,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY;IACZ,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc;IACd,KAAK,EAAE,WAAW,CAAC;CACpB;AACD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,UAAU,CAQpE"}

package/dist/esm/index.js

@@ -1,12 +1,14 @@
 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 { Jx3CalcdApi, CALCD_BASE_URL } from './clients/calcd.js';
 export { isSuccess } from './core/http.js';
 import { Jx3Api } from './clients/main.js';
 import { Jx3SearchApi } from './clients/search.js';
 import { Jx3ClientApi } from './clients/client.js';
+import { Jx3CalcdApi } from './clients/calcd.js';
 /**
- * 一次性创建三个服务的客户端。
+ * 一次性创建四个服务的客户端。
  *
  * @example
  * ```ts
@@ -22,6 +24,7 @@ export function createJx3(options = {}) {
         api: new Jx3Api({ ...shared, baseUrl: baseUrl?.api }),
         search: new Jx3SearchApi({ ...shared, baseUrl: baseUrl?.search }),
         client: new Jx3ClientApi({ ...shared, baseUrl: baseUrl?.client }),
+        calcd: new Jx3CalcdApi({ fetch: shared.fetch, timeoutMs: shared.timeoutMs, baseUrl: baseUrl?.calcd }),
     };
 }
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +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;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAK3C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA0BnD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAC,UAA4B,EAAE;IACtD,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"}
+{"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;AACpE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAwB,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAM3C,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,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA8BjD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAC,UAA4B,EAAE;IACtD,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;QACjE,KAAK,EAAE,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;KACtG,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,122 @@
+/** 计算器类型依据 openapi.calcd.json 的完整 schema。 */
+/** 循环的加速、延迟档位。 */
+export interface CalcdVariant {
+    index: number;
+    /** 加速值区间 [下限, 上限)，为 null 时使用 hasteTier。 */
+    hasteRange: [number, number] | null;
+    hasteTier: number | null;
+    latencyTier: number | null;
+    durationSeconds: number;
+}
+export interface CalcdRotation {
+    rotationId: string;
+    name: string;
+    title: string;
+    weapon: string | null;
+    strictHaste: boolean;
+    /** 基准可用仍需校验角色实际加速。 */
+    baselineAvailable: boolean;
+    unavailableReason: string | null;
+    variants: CalcdVariant[];
+}
+export interface CalcdSpec {
+    spec: string;
+    name: string;
+    rotations: CalcdRotation[];
+}
+export interface CalcdRotationsData {
+    specs: CalcdSpec[];
+}
+/** 整数及数字字符串由服务端按字段约束校验。 */
+export type CalcdIntegerInput = number | string;
+export type CalcdGemSlots = Array<CalcdIntegerInput[] | null> | null;
+/** 客户端格式的装备条目，支持文档中的两套镶嵌字段。 */
+export interface CalcdEquipmentItem {
+    nItemIndex: CalcdIntegerInput;
+    dwTabIndex: CalcdIntegerInput;
+    dwTabType?: CalcdIntegerInput;
+    /** 精炼等级 0～10，省略时按 0 计算。 */
+    nStrengthLevel?: CalcdIntegerInput;
+    dwPermanentEnchantID?: CalcdIntegerInput;
+    dwTemporaryEnchantID?: CalcdIntegerInput;
+    aMountDiamond?: CalcdGemSlots;
+    aSlotItem?: CalcdGemSlots;
+    aColorDiamond?: CalcdIntegerInput[] | null;
+    ColorInfo?: CalcdGemSlots;
+}
+/** 可直接传入原始装备查询的成功 detail 对象。 */
+export interface CalcdRole {
+    serverName: string;
+    roleName: string;
+    kungfuName: string;
+    equipList: CalcdEquipmentItem[];
+}
+/** role 和装备条目允许额外字段，保留调用方快照中的信息。 */
+export interface CalcdDpsParams<Role extends CalcdRole = CalcdRole> {
+    rotationId: string;
+    role: Role;
+    /** 仅在实际加速低于所选循环最低可用档时，补到该档试算。默认关闭。 */
+    fillMinimumHaste?: boolean;
+}
+export interface CalcdDpsSkill {
+    name: string;
+    count: number;
+    damage: number;
+    dps: number;
+    sharePct: number;
+}
+export interface CalcdEnchantGain {
+    stat: string;
+    amount: number;
+    dps: number;
+    deltaDps: number;
+    gainPct: number;
+}
+export interface CalcdDpsData {
+    character: {
+        server: string;
+        roleName: string;
+        kungfu: string;
+    };
+    spec: string;
+    rotationId: string;
+    baseline: {
+        target: string;
+        latencyTier: number;
+        externalBuffs: boolean;
+    };
+    haste: number;
+    /** 仅补足试算返回；haste 始终为原始装备加速。 */
+    hasteAdjustment?: {
+        addedHaste: number;
+        simulatedHaste: number;
+    };
+    matchedVariant: CalcdVariant;
+    durationSeconds: number;
+    totalDamage: number;
+    dps: number;
+    skills: CalcdDpsSkill[];
+    enchantGains: CalcdEnchantGain[];
+    equipment: {
+        received: number;
+        recognized: number;
+    };
+    warnings: string[];
+}
+/** HTTP 422 的 HASTE_MISMATCH 错误可提供此诊断信息。 */
+export interface CalcdHasteMismatchDetails {
+    actualHaste: number;
+    /** 低于最低可用档时，补足到该档所需的点数。 */
+    hasteShortfall?: number;
+    actualHasteTier: number;
+    latencyTier: number;
+    availableVariants: CalcdVariant[];
+    warnings: string[];
+}
+/** 计算器错误原样返回，以 'code' in response 收窄。 */
+export interface CalcdError {
+    code: string;
+    message: string;
+    details?: CalcdHasteMismatchDetails;
+}
+//# sourceMappingURL=calcd.d.ts.map

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

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

package/dist/esm/types/calcd.js

@@ -0,0 +1,3 @@
+/** 计算器类型依据 openapi.calcd.json 的完整 schema。 */
+export {};
+//# sourceMappingURL=calcd.js.map

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

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "finej3",
-  "version": "2.1.0",
-  "description": "剑网 3 API 的 TypeScript SDK，支持主站、搜索和客户端服务，提供 ESM 与 CommonJS 双格式。",
+  "version": "2.3.0",
+  "description": "剑网 3 API 的 TypeScript SDK，支持主站、搜索、客户端和 DPS 计算器服务，提供 ESM 与 CommonJS 双格式。",
   "type": "module",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -27,7 +27,7 @@
     "clean": "node -e \"fs.rmSync('dist',{recursive:true,force:true})\"",
     "build": "npm run clean && tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && node scripts/fixup-dist.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p test/tsconfig.json",
-    "test": "node test/baseurl.mjs",
+    "test": "node test/baseurl.mjs && node test/calcd.mjs",
     "smoke": "node --env-file=.env test/smoke.mjs",
     "verify-package": "node scripts/verify-package.mjs",
     "prepublishOnly": "npm run typecheck && npm run build && npm test && npm run verify-package"