@shirokasoke/webapi-sdk 2.9.0-beta3-0.17-pre → 2.9.0-beta3-0.17-pre2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/client.d.ts +642 -0
- package/dist/client.js +761 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.js +23 -0
- package/dist/types/ae2.d.ts +241 -0
- package/dist/types/ae2.js +2 -0
- package/dist/types/block.d.ts +97 -0
- package/dist/types/block.js +2 -0
- package/dist/types/chunk.d.ts +58 -0
- package/dist/types/chunk.js +2 -0
- package/dist/types/common.d.ts +33 -0
- package/dist/types/common.js +2 -0
- package/dist/types/entity.d.ts +132 -0
- package/dist/types/entity.js +2 -0
- package/dist/types/fluid.d.ts +34 -0
- package/dist/types/fluid.js +2 -0
- package/dist/types/fmp.d.ts +33 -0
- package/dist/types/fmp.js +2 -0
- package/dist/types/gt5.d.ts +219 -0
- package/dist/types/gt5.js +2 -0
- package/dist/types/index.d.ts +13 -0
- package/dist/types/index.js +29 -0
- package/dist/types/item.d.ts +45 -0
- package/dist/types/item.js +2 -0
- package/dist/types/rawInfo.d.ts +25 -0
- package/dist/types/rawInfo.js +2 -0
- package/dist/types/recipe.d.ts +114 -0
- package/dist/types/recipe.js +2 -0
- package/dist/types/threeD.d.ts +43 -0
- package/dist/types/threeD.js +2 -0
- package/dist/types/world.d.ts +58 -0
- package/dist/types/world.js +2 -0
- package/dist/utils/ae2.d.ts +42 -0
- package/dist/utils/ae2.js +89 -0
- package/dist/validators/ae2.d.ts +85 -0
- package/dist/validators/ae2.js +234 -0
- package/dist/validators/block.d.ts +12 -0
- package/dist/validators/block.js +101 -0
- package/dist/validators/chunk.d.ts +9 -0
- package/dist/validators/chunk.js +65 -0
- package/dist/validators/common.d.ts +8 -0
- package/dist/validators/common.js +38 -0
- package/dist/validators/entity.d.ts +10 -0
- package/dist/validators/entity.js +133 -0
- package/dist/validators/fluid.d.ts +6 -0
- package/dist/validators/fluid.js +36 -0
- package/dist/validators/fmp.d.ts +4 -0
- package/dist/validators/fmp.js +40 -0
- package/dist/validators/gt5.d.ts +26 -0
- package/dist/validators/gt5.js +197 -0
- package/dist/validators/index.d.ts +13 -0
- package/dist/validators/index.js +29 -0
- package/dist/validators/item.d.ts +14 -0
- package/dist/validators/item.js +39 -0
- package/dist/validators/rawInfo.d.ts +6 -0
- package/dist/validators/rawInfo.js +31 -0
- package/dist/validators/recipe.d.ts +30 -0
- package/dist/validators/recipe.js +83 -0
- package/dist/validators/threeD.d.ts +8 -0
- package/dist/validators/threeD.js +40 -0
- package/dist/validators/world.d.ts +5 -0
- package/dist/validators/world.js +65 -0
- package/package.json +2 -1
package/dist/client.js
ADDED
|
@@ -0,0 +1,761 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.WebApiError = exports.WebApiClient = void 0;
|
|
4
|
+
const fetch_event_source_1 = require("@microsoft/fetch-event-source");
|
|
5
|
+
function buildQuery(params) {
|
|
6
|
+
const record = params;
|
|
7
|
+
const qs = Object.entries(record)
|
|
8
|
+
.filter(([, v]) => v !== undefined)
|
|
9
|
+
.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)
|
|
10
|
+
.join("&");
|
|
11
|
+
return qs ? `?${qs}` : "";
|
|
12
|
+
}
|
|
13
|
+
/** 解包 `ApiResponse<T>`(如 SSE 事件帧),业务失败(success=false)时抛 {@link WebApiError} */
|
|
14
|
+
function unwrapApiResponse(body) {
|
|
15
|
+
if (!body.success) {
|
|
16
|
+
throw new WebApiError(body.message, 200, body);
|
|
17
|
+
}
|
|
18
|
+
return body.data;
|
|
19
|
+
}
|
|
20
|
+
class WebApiClient {
|
|
21
|
+
constructor(options) {
|
|
22
|
+
this.SSE = undefined;
|
|
23
|
+
this.baseUrl = options.baseUrl.replace(/\/$/, "");
|
|
24
|
+
this.authToken = options.authToken;
|
|
25
|
+
const globalFetch = typeof globalThis !== "undefined" ? globalThis.fetch : undefined;
|
|
26
|
+
this.fetchImpl = options.fetch || globalFetch || undefined;
|
|
27
|
+
if (!this.fetchImpl) {
|
|
28
|
+
throw new Error("No fetch implementation provided. Pass one via options.fetch or run in an environment with global fetch.");
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
async request(path, init) {
|
|
32
|
+
const req = new Request(`${this.baseUrl}${path}`, init);
|
|
33
|
+
if (this.authToken) {
|
|
34
|
+
req.headers.set("Authorization", this.authToken);
|
|
35
|
+
}
|
|
36
|
+
const res = await this.fetchImpl(req);
|
|
37
|
+
const contentType = res.headers.get("content-type") || "";
|
|
38
|
+
if (!res.ok) {
|
|
39
|
+
if (contentType.includes("application/json")) {
|
|
40
|
+
const body = await res.json().catch(() => ({ message: res.statusText }));
|
|
41
|
+
throw new WebApiError(body.message || res.statusText, res.status, body);
|
|
42
|
+
}
|
|
43
|
+
throw new WebApiError(res.statusText, res.status);
|
|
44
|
+
}
|
|
45
|
+
if (contentType.includes("application/json")) {
|
|
46
|
+
const body = await res.json();
|
|
47
|
+
if (body.success) {
|
|
48
|
+
return body.data;
|
|
49
|
+
}
|
|
50
|
+
else {
|
|
51
|
+
throw new WebApiError(body.message, res.status, body);
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
return res.arrayBuffer();
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* SSE 订阅模板:统一处理鉴权头、响应校验、事件过滤与错误上报(基于 fetchEventSource,可携带
|
|
58
|
+
* Authorization 头,原生 EventSource 不支持)。服务端推送的 `error` 事件(纯文本消息)会转为
|
|
59
|
+
* {@link Error} 上报;连接建立后发生异常时同样上报并停止库内自动重连,由调用方决定是否重新订阅。
|
|
60
|
+
* @param url 完整订阅地址(含 query)
|
|
61
|
+
* @param eventName 业务事件名,其余事件将被忽略
|
|
62
|
+
* @param callback 业务数据回调
|
|
63
|
+
* @param errorCallback 出错回调,接收模板抛出或 `parse` 抛出的异常(如 {@link WebApiError})
|
|
64
|
+
* @param parse 解析事件的 data 文本为业务数据,抛出异常表示该帧无效
|
|
65
|
+
* @param init 可选的请求附加参数(如 GT5 批量 SSE 需 POST JSON body);携带 body 时自动附加
|
|
66
|
+
* `Content-Type: application/json`
|
|
67
|
+
* @returns AbortController,调用 `abort()` 可停止订阅
|
|
68
|
+
*/
|
|
69
|
+
subscribeSse(url, eventName, callback, errorCallback, parse, init) {
|
|
70
|
+
const controller = new AbortController();
|
|
71
|
+
const headers = {};
|
|
72
|
+
if (init?.body !== undefined) {
|
|
73
|
+
headers["Content-Type"] = "application/json";
|
|
74
|
+
}
|
|
75
|
+
if (this.authToken) {
|
|
76
|
+
headers["Authorization"] = this.authToken;
|
|
77
|
+
}
|
|
78
|
+
(0, fetch_event_source_1.fetchEventSource)(url, {
|
|
79
|
+
signal: controller.signal,
|
|
80
|
+
method: init?.method,
|
|
81
|
+
body: init?.body,
|
|
82
|
+
headers,
|
|
83
|
+
openWhenHidden: true,
|
|
84
|
+
fetch: this.fetchImpl,
|
|
85
|
+
onopen: async (response) => {
|
|
86
|
+
if (!response.ok) {
|
|
87
|
+
const body = (await response.json().catch(() => null));
|
|
88
|
+
throw new WebApiError(body?.message || response.statusText, response.status, body);
|
|
89
|
+
}
|
|
90
|
+
const contentType = response.headers.get("content-type") || "";
|
|
91
|
+
if (!contentType.includes("text/event-stream")) {
|
|
92
|
+
throw new WebApiError(`Expected content-type to be text/event-stream, actual: ${contentType}`, response.status);
|
|
93
|
+
}
|
|
94
|
+
},
|
|
95
|
+
onmessage: (event) => {
|
|
96
|
+
if (event.event === "error") {
|
|
97
|
+
errorCallback(new Error(event.data));
|
|
98
|
+
return;
|
|
99
|
+
}
|
|
100
|
+
if (event.event !== eventName)
|
|
101
|
+
return;
|
|
102
|
+
try {
|
|
103
|
+
callback(parse(event.data));
|
|
104
|
+
}
|
|
105
|
+
catch (err) {
|
|
106
|
+
errorCallback(err instanceof Error ? err : new Error(String(err)));
|
|
107
|
+
}
|
|
108
|
+
},
|
|
109
|
+
onerror: (err) => {
|
|
110
|
+
errorCallback(err instanceof Error ? err : new Error(String(err)));
|
|
111
|
+
// 停止库内自动重连,由调用方决定是否重新订阅
|
|
112
|
+
throw err;
|
|
113
|
+
},
|
|
114
|
+
}).catch(() => { });
|
|
115
|
+
return controller;
|
|
116
|
+
}
|
|
117
|
+
// region Root / Status
|
|
118
|
+
/**
|
|
119
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/RootHandler.java)
|
|
120
|
+
* @returns 使用 {@link RootInfoSchema} 验证
|
|
121
|
+
*/
|
|
122
|
+
getRoot() {
|
|
123
|
+
return this.request("/version");
|
|
124
|
+
}
|
|
125
|
+
/**
|
|
126
|
+
* SSE 可用性探测:连接测试端点 `/test/sse`,确认服务端 SSE(Server-Sent Events)通道可用。
|
|
127
|
+
*
|
|
128
|
+
* 注意:仅当服务端启用虚拟线程(useVirtualThreads)时该路由才会注册。
|
|
129
|
+
* @param timeoutMs 探测超时(ms)
|
|
130
|
+
* @returns 服务端 SSE 可用返回 `true`,否则返回 `false`
|
|
131
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/test/SSETestHandler.java)
|
|
132
|
+
*/
|
|
133
|
+
checkSSE(timeoutMs = 500) {
|
|
134
|
+
if (this.SSE != undefined)
|
|
135
|
+
return Promise.resolve(this.SSE);
|
|
136
|
+
return new Promise(resolve => {
|
|
137
|
+
let controller;
|
|
138
|
+
let settled = false;
|
|
139
|
+
let timer;
|
|
140
|
+
/** 首次结果生效,后续(含 abort 触发的 onerror)一律忽略 */
|
|
141
|
+
const finish = (ok) => {
|
|
142
|
+
if (settled)
|
|
143
|
+
return;
|
|
144
|
+
settled = true;
|
|
145
|
+
if (timer !== undefined)
|
|
146
|
+
clearTimeout(timer);
|
|
147
|
+
controller?.abort();
|
|
148
|
+
this.SSE = ok;
|
|
149
|
+
resolve(ok);
|
|
150
|
+
};
|
|
151
|
+
timer = setTimeout(() => finish(false), timeoutMs);
|
|
152
|
+
controller = this.subscribeSse(`${this.baseUrl}/test/sse`, "success", () => finish(true), () => finish(false), raw => raw);
|
|
153
|
+
});
|
|
154
|
+
}
|
|
155
|
+
// region TPS / Performance
|
|
156
|
+
/**
|
|
157
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/TPSHandler.java)
|
|
158
|
+
* @returns 使用 `Joi.object().pattern(Joi.string(), {@link TPSInfoSchema})` 验证
|
|
159
|
+
*/
|
|
160
|
+
getTPS() {
|
|
161
|
+
return this.request("/tps");
|
|
162
|
+
}
|
|
163
|
+
/**
|
|
164
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ProfilerHandler.java)
|
|
165
|
+
* @returns 使用 {@link ProfilerDataSchema} 验证
|
|
166
|
+
*/
|
|
167
|
+
getProfiler() {
|
|
168
|
+
return this.request("/profiler");
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/LagAnalyzerHandler.java)
|
|
172
|
+
* @returns 使用 {@link LagAnalyzerDataSchema} 验证
|
|
173
|
+
*/
|
|
174
|
+
getLagAnalyzer() {
|
|
175
|
+
return this.request("/lag-analyzer");
|
|
176
|
+
}
|
|
177
|
+
// region World
|
|
178
|
+
/**
|
|
179
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/WorldInfoHandler.java)
|
|
180
|
+
* @returns 使用 `Joi.object().pattern(Joi.string(), {@link WorldInfoDataSchema})` 验证
|
|
181
|
+
*/
|
|
182
|
+
getWorldInfo() {
|
|
183
|
+
return this.request("/WorldInfo");
|
|
184
|
+
}
|
|
185
|
+
// region Blocks
|
|
186
|
+
/**
|
|
187
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/BlocksHandler.java)
|
|
188
|
+
* @returns 使用 `Joi.array().items(`{@link BlockSchema}`)` 验证
|
|
189
|
+
*/
|
|
190
|
+
getBlocks() {
|
|
191
|
+
return this.request("/blocks");
|
|
192
|
+
}
|
|
193
|
+
/**
|
|
194
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/BlockHandler.java)
|
|
195
|
+
* @returns 使用 {@link BlockDetailSchema} 验证
|
|
196
|
+
*/
|
|
197
|
+
getBlock(params) {
|
|
198
|
+
return this.request(`/block${buildQuery(params)}`);
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/SetBlockHandler.java)
|
|
202
|
+
* @param body 使用 {@link SetBlockBodySchema} 验证
|
|
203
|
+
* @returns 使用 {@link SetBlockResultSchema} 验证
|
|
204
|
+
*/
|
|
205
|
+
setBlock(params, body) {
|
|
206
|
+
return this.request(`/setblock${buildQuery(params)}`, {
|
|
207
|
+
method: "POST",
|
|
208
|
+
headers: { "Content-Type": "application/json" },
|
|
209
|
+
body: JSON.stringify(body),
|
|
210
|
+
});
|
|
211
|
+
}
|
|
212
|
+
/**
|
|
213
|
+
* 提交批量 setblock 任务到慢队列,异步执行。
|
|
214
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/BatchSetBlockHandler.java)
|
|
215
|
+
* @param tasks 使用 `Joi.array().items(`{@link BatchSetBlockTaskSchema} ) 验证
|
|
216
|
+
* @returns 使用 {@link BatchSetBlockSubmitResultSchema} 验证
|
|
217
|
+
*/
|
|
218
|
+
batchSetBlock(tasks) {
|
|
219
|
+
return this.request("/batchsetblock", {
|
|
220
|
+
method: "POST",
|
|
221
|
+
headers: { "Content-Type": "application/json" },
|
|
222
|
+
body: JSON.stringify(tasks),
|
|
223
|
+
});
|
|
224
|
+
}
|
|
225
|
+
/**
|
|
226
|
+
* 查询批量 setblock 任务执行结果。
|
|
227
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/BatchSetBlockHandler.java)
|
|
228
|
+
* @returns 使用 {@link BatchSetBlockJobResultSchema} 验证
|
|
229
|
+
*/
|
|
230
|
+
getBatchSetBlockJob(params) {
|
|
231
|
+
return this.request(`/batchsetblock${buildQuery(params)}`);
|
|
232
|
+
}
|
|
233
|
+
/**
|
|
234
|
+
* 轮询等待批量 setblock 任务完成。
|
|
235
|
+
* @param jobId 任务 ID(由 batchSetBlock 返回)
|
|
236
|
+
* @param intervalMs 轮询间隔 (ms),默认 100
|
|
237
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/BatchSetBlockHandler.java)
|
|
238
|
+
* @returns 使用 {@link BatchSetBlockJobResultSchema} 验证
|
|
239
|
+
*/
|
|
240
|
+
async waitForBatchSetBlockJob(jobId, intervalMs = 100) {
|
|
241
|
+
while (true) {
|
|
242
|
+
const job = await this.getBatchSetBlockJob({ id: jobId });
|
|
243
|
+
if (job.status === "completed")
|
|
244
|
+
return job;
|
|
245
|
+
await new Promise(r => setTimeout(r, intervalMs));
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
/**
|
|
249
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/FMPHandler.java)
|
|
250
|
+
* @returns 使用 `Joi.array().items(`{@link FMPPartSchema}`)` 验证
|
|
251
|
+
*/
|
|
252
|
+
getBlockFMP(params) {
|
|
253
|
+
return this.request(`/block/fmp${buildQuery(params)}`);
|
|
254
|
+
}
|
|
255
|
+
/**
|
|
256
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/BlockTileHandler.java)
|
|
257
|
+
* @returns 二进制数据,无 JSON Schema
|
|
258
|
+
*/
|
|
259
|
+
getBlockTile(params) {
|
|
260
|
+
return this.request(`/block/tile${buildQuery(params)}`);
|
|
261
|
+
}
|
|
262
|
+
// region Items
|
|
263
|
+
/**
|
|
264
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/item/ItemsHandler.java)
|
|
265
|
+
* @returns 使用 `Joi.array().items(`{@link ItemSchema}`)` 验证
|
|
266
|
+
*/
|
|
267
|
+
getItems() {
|
|
268
|
+
return this.request("/items");
|
|
269
|
+
}
|
|
270
|
+
/**
|
|
271
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/item/ItemHandler.java)
|
|
272
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/item/ItemStaticHandler.java)
|
|
273
|
+
* @returns 使用 {@link ItemDetailSchema} 验证
|
|
274
|
+
*/
|
|
275
|
+
getItem(params) {
|
|
276
|
+
return this.request(`/item${buildQuery(params)}`);
|
|
277
|
+
}
|
|
278
|
+
/**
|
|
279
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/item/ItemIconHandler.java)
|
|
280
|
+
* @param params.id 物品 ID(对应 ItemStack 的 id)
|
|
281
|
+
* @param params.damage 物品损伤值/元数据(可选,默认 0)
|
|
282
|
+
* @param params.tag Base64 编码的 NBTTagCompound(可选)
|
|
283
|
+
* @returns 二进制 PNG 图片数据 (ArrayBuffer)
|
|
284
|
+
*/
|
|
285
|
+
getItemIcon(params) {
|
|
286
|
+
return this.request(`/item/icon${buildQuery(params)}`);
|
|
287
|
+
}
|
|
288
|
+
/**
|
|
289
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/item/AEHandler.java)
|
|
290
|
+
* @returns 使用 {@link AEItemDefinitionsSchema} 验证
|
|
291
|
+
*/
|
|
292
|
+
getAEItemsDef() {
|
|
293
|
+
return this.request("/items/ae");
|
|
294
|
+
}
|
|
295
|
+
// region Fluids
|
|
296
|
+
/**
|
|
297
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/fluid/FluidsHandler.java)
|
|
298
|
+
* @returns 使用 `Joi.array().items(`{@link FluidSchema}`)` 验证
|
|
299
|
+
*/
|
|
300
|
+
getFluids() {
|
|
301
|
+
return this.request("/fluids");
|
|
302
|
+
}
|
|
303
|
+
/**
|
|
304
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/fluid/FluidContainersHandler.java)
|
|
305
|
+
* @returns 使用 `Joi.array().items(`{@link FluidContainerSchema}`)` 验证
|
|
306
|
+
*/
|
|
307
|
+
getFluidContainers() {
|
|
308
|
+
return this.request("/fluidContainers");
|
|
309
|
+
}
|
|
310
|
+
/**
|
|
311
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/fluid/FluidIconHandler.java)
|
|
312
|
+
* @param params.id 流体 ID(对应 Fluid 的 id)
|
|
313
|
+
* @param params.name 流体名称(对应 Fluid 的 name)
|
|
314
|
+
* @returns 二进制 PNG 图片数据 (ArrayBuffer)
|
|
315
|
+
*/
|
|
316
|
+
getFluidIcon(params) {
|
|
317
|
+
return this.request(`/fluid/icon${buildQuery(params)}`);
|
|
318
|
+
}
|
|
319
|
+
// region Entities
|
|
320
|
+
/**
|
|
321
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/entity/EntitiesHandler.java)
|
|
322
|
+
* @returns 使用 `Joi.object().pattern(Joi.string(),`{@link EntitiesByDimensionSchema}`)` 验证
|
|
323
|
+
*
|
|
324
|
+
* 其中实体为 {@link EntitySummarySchema} 精简结构
|
|
325
|
+
*/
|
|
326
|
+
getEntities() {
|
|
327
|
+
return this.request("/entities");
|
|
328
|
+
}
|
|
329
|
+
/**
|
|
330
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/entity/EntityHandler.java)
|
|
331
|
+
* @returns 使用 {@link EntitySchema} 验证
|
|
332
|
+
*/
|
|
333
|
+
getEntity(params) {
|
|
334
|
+
return this.request(`/entity${buildQuery(params)}`);
|
|
335
|
+
}
|
|
336
|
+
// region Chunks
|
|
337
|
+
/**
|
|
338
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/chunk/ChunksHandler.java)
|
|
339
|
+
* @returns 使用 `Joi.object().pattern(Joi.string(),`{@link ChunksByDimensionSchema}`)` 验证
|
|
340
|
+
*/
|
|
341
|
+
getChunks() {
|
|
342
|
+
return this.request("/chunks");
|
|
343
|
+
}
|
|
344
|
+
/**
|
|
345
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/chunk/ChunkHandler.java)
|
|
346
|
+
* @returns 使用 {@link ChunkWithDimensionSchema} 验证
|
|
347
|
+
*/
|
|
348
|
+
getChunk(params) {
|
|
349
|
+
return this.request(`/chunk${buildQuery(params)}`);
|
|
350
|
+
}
|
|
351
|
+
/**
|
|
352
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/chunk/ChunkMapHandler.java)
|
|
353
|
+
* @returns JSON 模式使用 `Joi.array().items(Joi.array().items(`{@link ChunkMapCellSchema}`)` 验证;raw 模式为 ArrayBuffer
|
|
354
|
+
*/
|
|
355
|
+
getChunkMap(params, raw) {
|
|
356
|
+
const q = buildQuery({
|
|
357
|
+
...params,
|
|
358
|
+
raw: raw == true ? String(raw) : undefined,
|
|
359
|
+
});
|
|
360
|
+
return this.request(`/chunk/map${q}`);
|
|
361
|
+
}
|
|
362
|
+
/**
|
|
363
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/chunk/ChunkForceHandler.java)
|
|
364
|
+
* @returns 使用 {@link ChunkForceListSchema} 验证
|
|
365
|
+
*/
|
|
366
|
+
getChunkForceList() {
|
|
367
|
+
return this.request("/chunk/force");
|
|
368
|
+
}
|
|
369
|
+
/**
|
|
370
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/chunk/ChunkForceHandler.java)
|
|
371
|
+
* @returns 使用 {@link ChunkLoadResultSchema} 验证
|
|
372
|
+
*/
|
|
373
|
+
loadChunk(params) {
|
|
374
|
+
return this.request(`/chunk/force${buildQuery({ action: "load", ...params })}`, {
|
|
375
|
+
method: "POST",
|
|
376
|
+
});
|
|
377
|
+
}
|
|
378
|
+
/**
|
|
379
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/chunk/ChunkForceHandler.java)
|
|
380
|
+
* @returns 使用 {@link ChunkLoadResultSchema} 验证
|
|
381
|
+
*/
|
|
382
|
+
unloadChunk(params) {
|
|
383
|
+
return this.request(`/chunk/force${buildQuery({ action: "unload", ...params })}`, {
|
|
384
|
+
method: "POST",
|
|
385
|
+
});
|
|
386
|
+
}
|
|
387
|
+
// region GT5
|
|
388
|
+
/**
|
|
389
|
+
* 查询单个 GT5 机器信息。
|
|
390
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5BaseHandler.java)
|
|
391
|
+
* @returns 使用 {@link GT5MachineInfoSchema} 验证
|
|
392
|
+
*/
|
|
393
|
+
getGT5Machine(params) {
|
|
394
|
+
return this.request(`/gt5${buildQuery(params)}`);
|
|
395
|
+
}
|
|
396
|
+
/**
|
|
397
|
+
* 启停单台 GT5 机器
|
|
398
|
+
*
|
|
399
|
+
* @returns 使用 {@link GT5StatusResultSchema} 验证;`changed=false` 表示机器本就处于目标状态
|
|
400
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5StatusHandler.java)
|
|
401
|
+
*/
|
|
402
|
+
setGT5MachineStatus(params) {
|
|
403
|
+
return this.request(`/gt5/status${buildQuery(params)}`, { method: "POST" });
|
|
404
|
+
}
|
|
405
|
+
/**
|
|
406
|
+
* 提交批量 GT5 机器查询任务。
|
|
407
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5BatchHandler.java)
|
|
408
|
+
* @param machines 使用 `Joi.array().items(`{@link GT5BatchMachineCoordSchema}`)` 验证
|
|
409
|
+
* @returns 使用 {@link GT5BatchSubmitResultSchema} 验证
|
|
410
|
+
*/
|
|
411
|
+
submitGT5Batch(machines) {
|
|
412
|
+
return this.request("/gt5/batch", {
|
|
413
|
+
method: "POST",
|
|
414
|
+
headers: { "Content-Type": "application/json" },
|
|
415
|
+
body: JSON.stringify(machines),
|
|
416
|
+
});
|
|
417
|
+
}
|
|
418
|
+
/**
|
|
419
|
+
* 查询批量 GT5 机器任务状态。
|
|
420
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5BatchHandler.java)
|
|
421
|
+
* @returns 使用 {@link GT5BatchJobResultSchema} 验证
|
|
422
|
+
*/
|
|
423
|
+
getGT5BatchJob(params) {
|
|
424
|
+
return this.request(`/gt5/batch${buildQuery(params)}`);
|
|
425
|
+
}
|
|
426
|
+
/**
|
|
427
|
+
* 重新执行已有的批量 GT5 机器查询任务。
|
|
428
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5BatchHandler.java)
|
|
429
|
+
* @returns 使用 {@link GT5BatchRerunResultSchema} 验证
|
|
430
|
+
*/
|
|
431
|
+
rerunGT5Batch(params) {
|
|
432
|
+
return this.request(`/gt5/batch${buildQuery(params)}`, {
|
|
433
|
+
method: "PATCH",
|
|
434
|
+
});
|
|
435
|
+
}
|
|
436
|
+
/**
|
|
437
|
+
* 轮询等待批量 GT5 机器任务完成。
|
|
438
|
+
* @param jobId 任务 ID(由 submitGT5Batch 返回)
|
|
439
|
+
* @param intervalMs 轮询间隔 (ms),默认 100
|
|
440
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5BatchHandler.java)
|
|
441
|
+
* @returns 使用 {@link GT5BatchJobResultSchema} 验证
|
|
442
|
+
*/
|
|
443
|
+
async waitForGT5BatchJob(jobId, intervalMs = 100) {
|
|
444
|
+
while (true) {
|
|
445
|
+
const job = await this.getGT5BatchJob({ id: jobId });
|
|
446
|
+
if (job.status === "completed")
|
|
447
|
+
return job;
|
|
448
|
+
await new Promise(r => setTimeout(r, intervalMs));
|
|
449
|
+
}
|
|
450
|
+
}
|
|
451
|
+
/**
|
|
452
|
+
* 提交区块扫描任务,异步扫描指定区块内所有 GT5 机器。
|
|
453
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5ChunkScanHandler.java)
|
|
454
|
+
* @returns 使用 {@link GT5ScanSubmitResultSchema} 验证
|
|
455
|
+
*/
|
|
456
|
+
submitGT5ChunkScan(params) {
|
|
457
|
+
return this.request(`/gt5/scan${buildQuery(params)}`, {
|
|
458
|
+
method: "POST",
|
|
459
|
+
});
|
|
460
|
+
}
|
|
461
|
+
/**
|
|
462
|
+
* 查询区块扫描任务状态。
|
|
463
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5ChunkScanHandler.java)
|
|
464
|
+
* @returns 使用 {@link GT5ScanJobResultSchema} 验证
|
|
465
|
+
*/
|
|
466
|
+
getGT5ScanJob(params) {
|
|
467
|
+
return this.request(`/gt5/scan${buildQuery(params)}`);
|
|
468
|
+
}
|
|
469
|
+
/**
|
|
470
|
+
* 轮询等待区块扫描任务完成。
|
|
471
|
+
* @param jobId 任务 ID(由 submitGT5ChunkScan 返回)
|
|
472
|
+
* @param intervalMs 轮询间隔 (ms),默认 100
|
|
473
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5ChunkScanHandler.java)
|
|
474
|
+
* @returns 使用 {@link GT5ScanJobResultSchema} 验证
|
|
475
|
+
*/
|
|
476
|
+
async waitForGT5ScanJob(jobId, intervalMs = 100) {
|
|
477
|
+
while (true) {
|
|
478
|
+
const job = await this.getGT5ScanJob({ id: jobId });
|
|
479
|
+
if (job.status === "completed")
|
|
480
|
+
return job;
|
|
481
|
+
await new Promise(r => setTimeout(r, intervalMs));
|
|
482
|
+
}
|
|
483
|
+
}
|
|
484
|
+
/**
|
|
485
|
+
* 以回调方式订阅批量 GT5 机器信息 SSE 推送(基于 fetchEventSource,可携带 Authorization 头,原生 EventSource 不支持)。
|
|
486
|
+
* 服务端以 `machines` 数组作为 POST body 提交批量查询,任务完成后推送一次 `gt5` 事件
|
|
487
|
+
* ({@link GT5BatchJobResult} JSON,含 machines 结果),随后每隔 interval 秒(默认 5)自动重跑并再次推送;
|
|
488
|
+
* 连接建立后发生异常时推送 `error` 事件(纯文本消息)并关闭连接。
|
|
489
|
+
* @param machines 目标机器坐标列表,作为 POST JSON body 提交
|
|
490
|
+
* @param callback 每次收到批量查询完整结果(任务完成,含 machines)时调用
|
|
491
|
+
* @param errorCallback 出错(网络错误、鉴权失败、服务端 error 事件、业务失败、数据解析失败)时调用,库内自动重连会随之停止
|
|
492
|
+
* @param params.interval 任务完成后自动重跑的间隔(秒),省略时由服务端取默认值
|
|
493
|
+
* @returns AbortController,调用 `abort()` 可停止订阅
|
|
494
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5BatchSSEHandler.java)
|
|
495
|
+
*/
|
|
496
|
+
gt5BatchSseCallback(machines, callback, errorCallback, params) {
|
|
497
|
+
return this.subscribeSse(`${this.baseUrl}/gt5/batch/sse${buildQuery(params ?? {})}`, "gt5", callback, errorCallback, raw => {
|
|
498
|
+
const body = JSON.parse(raw);
|
|
499
|
+
// 服务端当前推送裸对象(其 success 为数字计数),同时兼容 ApiResponse 包装形式(success 为布尔值)
|
|
500
|
+
return typeof body.success === "boolean"
|
|
501
|
+
? unwrapApiResponse(body)
|
|
502
|
+
: body;
|
|
503
|
+
}, { method: "POST", body: JSON.stringify(machines) });
|
|
504
|
+
}
|
|
505
|
+
// region AE2
|
|
506
|
+
/**
|
|
507
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AEBaseHandler.java)
|
|
508
|
+
* @returns 使用 {@link AEHitResultSchema} 验证
|
|
509
|
+
*/
|
|
510
|
+
aeHit(params) {
|
|
511
|
+
return this.request(`/ae${buildQuery(params)}`);
|
|
512
|
+
}
|
|
513
|
+
/**
|
|
514
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AENodesHandler.java)
|
|
515
|
+
* @returns 使用 `Joi.array().items(`{@link AENodeSchema}`)` 验证
|
|
516
|
+
*/
|
|
517
|
+
aeNodes(params) {
|
|
518
|
+
return this.request(`/ae/nodes${buildQuery(params)}`);
|
|
519
|
+
}
|
|
520
|
+
/**
|
|
521
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AECPUHandler.java)
|
|
522
|
+
* @returns 使用 `Joi.array().items(`{@link AECPUSchema}`)` 验证
|
|
523
|
+
*/
|
|
524
|
+
aeCPUs(params) {
|
|
525
|
+
return this.request(`/ae/cpu${buildQuery(params)}`);
|
|
526
|
+
}
|
|
527
|
+
/**
|
|
528
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AEMEHandler.java)
|
|
529
|
+
* @returns 使用 `Joi.array().items(`{@link AE2PatternSchema}`.append({ slot: Joi.number().required(), direction: Joi.string().optional() }))` 验证
|
|
530
|
+
*/
|
|
531
|
+
aeME(params) {
|
|
532
|
+
return this.request(`/ae/me${buildQuery(params)}`);
|
|
533
|
+
}
|
|
534
|
+
/**
|
|
535
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AEMEsHandler.java)
|
|
536
|
+
* @returns 使用 `Joi.array().items(`{@link AEMEInterfaceSchema}`)` 验证
|
|
537
|
+
*/
|
|
538
|
+
aeMEs(params) {
|
|
539
|
+
if (params.load || params.world) {
|
|
540
|
+
params.pattern = true;
|
|
541
|
+
}
|
|
542
|
+
return this.request(`/ae/mes${buildQuery(params)}`);
|
|
543
|
+
}
|
|
544
|
+
/**
|
|
545
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AEMEsupportHandler.java)
|
|
546
|
+
* @returns 字符串数组,无专用 Schema
|
|
547
|
+
*/
|
|
548
|
+
aeMESupport() {
|
|
549
|
+
return this.request("/ae/me/support");
|
|
550
|
+
}
|
|
551
|
+
/**
|
|
552
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AEItemHandler.java)
|
|
553
|
+
* @returns 使用 {@link AEItemsResultSchema} 验证
|
|
554
|
+
*/
|
|
555
|
+
aeItems(params) {
|
|
556
|
+
return this.request(`/ae/item${buildQuery(params)}`);
|
|
557
|
+
}
|
|
558
|
+
/**
|
|
559
|
+
* 向 AE 合成网络提交自动合成任务
|
|
560
|
+
*
|
|
561
|
+
* 如果返回的 {@link AECraftingTaskResult} 含合成树 `job`({@link AECraftingJobTree}),
|
|
562
|
+
* 可配合 {@link analyzeAECraftingJobTree} 判定能否合成及缺失物品
|
|
563
|
+
*
|
|
564
|
+
* 失败时抛出 {@link WebApiError}:
|
|
565
|
+
* - HTTP 500 且 message 为 "Failed to simulate job" 时,`error.body` 为
|
|
566
|
+
* {@link AECraftingTaskErrorBody},其 `body` 携带失败时的合成树,同样可分析缺失物品;
|
|
567
|
+
* - HTTP 500 且 message 为 "Failed to submit job to CPU" 时,为 CPU 侧问题
|
|
568
|
+
* (无可用 CPU / 存储字节不足 / CPU 忙碌),与材料无关。
|
|
569
|
+
*
|
|
570
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AECPUTaskHandler.java)
|
|
571
|
+
* @param params 坐标参数;`detail` 控制合成树输出:`"all"` 始终输出,`"fail"`仅失败时输出,`"none"` 不输出
|
|
572
|
+
* @param body 使用 {@link AECraftingTaskBodySchema} 验证
|
|
573
|
+
* @returns 使用 {@link AECraftingTaskResultSchema} 验证
|
|
574
|
+
*/
|
|
575
|
+
aeCraft(params, body) {
|
|
576
|
+
return this.request(`/ae/cpu/task${buildQuery(params)}`, {
|
|
577
|
+
method: "POST",
|
|
578
|
+
headers: { "Content-Type": "application/json" },
|
|
579
|
+
body: JSON.stringify(body),
|
|
580
|
+
});
|
|
581
|
+
}
|
|
582
|
+
/**
|
|
583
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AECPUCancelHandler.java)
|
|
584
|
+
* @param body 使用 {@link AECPUCancelBodySchema} 验证
|
|
585
|
+
* @returns 使用 {@link AECPUCancelResultSchema} 验证
|
|
586
|
+
*/
|
|
587
|
+
aeCancel(params, body) {
|
|
588
|
+
return this.request(`/ae/cpu/cancel${buildQuery(params)}`, {
|
|
589
|
+
method: "DELETE",
|
|
590
|
+
headers: { "Content-Type": "application/json" },
|
|
591
|
+
body: JSON.stringify(body),
|
|
592
|
+
});
|
|
593
|
+
}
|
|
594
|
+
/**
|
|
595
|
+
* 暂停(suspend=true,POST)或恢复(suspend=false,DELETE)AE 合成 CPU 上正在执行的合成任务。
|
|
596
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AECPUSuspendHandler.java)
|
|
597
|
+
* @param body 使用 {@link AECPUSuspendBodySchema} 验证
|
|
598
|
+
* @returns 使用 {@link AECPUSuspendResultSchema} 验证
|
|
599
|
+
*/
|
|
600
|
+
aeSuspend(params, body, suspend) {
|
|
601
|
+
return this.request(`/ae/cpu/suspend${buildQuery(params)}`, {
|
|
602
|
+
method: suspend ? "POST" : "DELETE",
|
|
603
|
+
headers: { "Content-Type": "application/json" },
|
|
604
|
+
body: JSON.stringify(body),
|
|
605
|
+
});
|
|
606
|
+
}
|
|
607
|
+
/**
|
|
608
|
+
* 构建 AE 库存 SSE(Server-Sent Events)订阅地址。
|
|
609
|
+
* 注意:仅当服务端启用虚拟线程(useVirtualThreads)时该路由才会注册。
|
|
610
|
+
* 返回 EventSource 可直接使用的完整 URL。
|
|
611
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AEItemSSEHandler.java)
|
|
612
|
+
*/
|
|
613
|
+
aeItemsSseUrl(params) {
|
|
614
|
+
return `${this.baseUrl}/ae/item/sse${buildQuery(params)}`;
|
|
615
|
+
}
|
|
616
|
+
/**
|
|
617
|
+
* 以回调方式订阅 AE 库存 SSE 推送(基于 fetchEventSource,可携带 Authorization 头,原生 EventSource 不支持)。
|
|
618
|
+
* 服务端周期性推送 `aeitem` 事件(`ApiResponse<{@link AEItemsResult}>` JSON,间隔由服务端 AE2Config.item.interval 决定),
|
|
619
|
+
* 回调收到解包后的 {@link AEItemsResult},业务失败(success=false)时以 {@link WebApiError} 上报;
|
|
620
|
+
* 连接建立后发生异常时推送 `error` 事件(纯文本消息)并关闭连接。
|
|
621
|
+
* @param params 目标方块坐标
|
|
622
|
+
* @param callback 每次收到库存快照时调用
|
|
623
|
+
* @param errorCallback 出错(网络错误、鉴权失败、服务端 error 事件、业务失败、数据解析失败)时调用,库内自动重连会随之停止
|
|
624
|
+
* @returns AbortController,调用 `abort()` 可停止订阅
|
|
625
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AEItemSSEHandler.java)
|
|
626
|
+
*/
|
|
627
|
+
aeItemSseCallback(params, callback, errorCallback) {
|
|
628
|
+
return this.subscribeSse(`${this.baseUrl}/ae/item/sse${buildQuery(params)}`, "aeitem", callback, errorCallback, raw => unwrapApiResponse(JSON.parse(raw)));
|
|
629
|
+
}
|
|
630
|
+
/**
|
|
631
|
+
* 构建 AE 合成 CPU 状态 SSE(Server-Sent Events)订阅地址。
|
|
632
|
+
* 注意:仅当服务端启用虚拟线程(useVirtualThreads)时该路由才会注册。
|
|
633
|
+
* 返回 EventSource 可直接使用的完整 URL。
|
|
634
|
+
* @param params 目标方块坐标;interval 为推送间隔(秒),省略时由服务端取默认值 5
|
|
635
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AECPUSSEHandler.java)
|
|
636
|
+
*/
|
|
637
|
+
aeCpuSseUrl(params) {
|
|
638
|
+
return `${this.baseUrl}/ae/cpu/sse${buildQuery(params)}`;
|
|
639
|
+
}
|
|
640
|
+
/**
|
|
641
|
+
* 以回调方式订阅 AE 合成 CPU 状态 SSE 推送(基于 fetchEventSource,可携带 Authorization 头,原生 EventSource 不支持)。
|
|
642
|
+
* 服务端周期性推送 `aecpu` 事件({@link AECPU} 数组 JSON,间隔由 interval 参数(秒)决定,服务端默认 5),
|
|
643
|
+
* 回调收到 CPU 状态列表;连接建立后发生异常时推送 `error` 事件(纯文本消息)并关闭连接。
|
|
644
|
+
* @param params 目标方块坐标;interval 为推送间隔(秒),省略时由服务端取默认值
|
|
645
|
+
* @param callback 每次收到 CPU 状态快照时调用
|
|
646
|
+
* @param errorCallback 出错(网络错误、鉴权失败、服务端 error 事件、业务失败、数据解析失败)时调用,库内自动重连会随之停止
|
|
647
|
+
* @returns AbortController,调用 `abort()` 可停止订阅
|
|
648
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AECPUSSEHandler.java)
|
|
649
|
+
*/
|
|
650
|
+
aeCpuSseCallback(params, callback, errorCallback) {
|
|
651
|
+
return this.subscribeSse(`${this.baseUrl}/ae/cpu/sse${buildQuery(params)}`, "aecpu", callback, errorCallback, raw => {
|
|
652
|
+
const body = JSON.parse(raw);
|
|
653
|
+
// 服务端当前推送裸数组,同时兼容 ApiResponse 包装形式
|
|
654
|
+
return Array.isArray(body) ? body : unwrapApiResponse(body);
|
|
655
|
+
});
|
|
656
|
+
}
|
|
657
|
+
// region Recipes
|
|
658
|
+
/**
|
|
659
|
+
* 查询工作台合成配方(有序/无序)。
|
|
660
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/recipe/CraftingRecipesHandler.java)
|
|
661
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/recipe/IndexedCraftingRecipesHandler.java)
|
|
662
|
+
* @returns 使用 {@link CraftingRecipesResultSchema} 验证
|
|
663
|
+
*/
|
|
664
|
+
getCraftingRecipes(params) {
|
|
665
|
+
return this.request(`/recipes/crafting${buildQuery(params ?? {})}`);
|
|
666
|
+
}
|
|
667
|
+
/**
|
|
668
|
+
* 查询熔炉熔炼配方。
|
|
669
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/recipe/FurnaceRecipesHandler.java)
|
|
670
|
+
* @returns 使用 {@link FurnaceRecipesResultSchema} 验证
|
|
671
|
+
*/
|
|
672
|
+
getFurnaceRecipes(params) {
|
|
673
|
+
return this.request(`/recipes/furnace${buildQuery(params ?? {})}`);
|
|
674
|
+
}
|
|
675
|
+
/**
|
|
676
|
+
* 查询 GT5 配方表的映射表(unlocalizedName → 显示名)。
|
|
677
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/recipe/GTmaps.java)
|
|
678
|
+
* @returns 使用 `Joi.array().items(`{@link GTRecipeMapSchema}`)` 验证
|
|
679
|
+
*/
|
|
680
|
+
getGTRecipeMaps() {
|
|
681
|
+
return this.request("/recipes/gt/maps");
|
|
682
|
+
}
|
|
683
|
+
/**
|
|
684
|
+
* 查询 GT5 机器配方。
|
|
685
|
+
* 注意:必须至少提供 id/damage(物品)、fluid(流体)或 map(单个配方表)之一。
|
|
686
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/recipe/GTRecipesHandler.java)
|
|
687
|
+
* @returns 使用 {@link GTRecipesResultSchema} 验证
|
|
688
|
+
*/
|
|
689
|
+
getGTRecipes(params) {
|
|
690
|
+
return this.request(`/recipes/gt${buildQuery(params)}`);
|
|
691
|
+
}
|
|
692
|
+
// region 3D Print
|
|
693
|
+
/**
|
|
694
|
+
* 上传图片 → OC 3D 打印件,投递到玩家背包(多余掉落在玩家附近)。
|
|
695
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ThreeD/PlayerPrintHandler.java)
|
|
696
|
+
* @param params 二选一:id(实体 ID)或 name(玩家名)
|
|
697
|
+
* @param image 图片二进制数据(png/jpg 等)
|
|
698
|
+
* @returns 使用 {@link PlayerPrintResultSchema} 验证
|
|
699
|
+
*/
|
|
700
|
+
printToPlayer(params, image) {
|
|
701
|
+
return this.request(`/3d/player${buildQuery(params)}`, {
|
|
702
|
+
method: "PUT",
|
|
703
|
+
body: image,
|
|
704
|
+
});
|
|
705
|
+
}
|
|
706
|
+
/**
|
|
707
|
+
* 上传图片 → 在世界中铺设 OC 3D 打印像素画(慢队列逐块执行)。
|
|
708
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ThreeD/WorldPrintHandler.java)
|
|
709
|
+
* @returns 使用 {@link WorldPrintSubmitResultSchema} 验证
|
|
710
|
+
*/
|
|
711
|
+
submitWorldPrint(params, image) {
|
|
712
|
+
return this.request(`/3d/world${buildQuery(params)}`, {
|
|
713
|
+
method: "PUT",
|
|
714
|
+
body: image,
|
|
715
|
+
});
|
|
716
|
+
}
|
|
717
|
+
/**
|
|
718
|
+
* 查询世界 3D 打印任务进度。
|
|
719
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ThreeD/WorldPrintHandler.java)
|
|
720
|
+
* @returns 使用 {@link WorldPrintJobResultSchema} 验证
|
|
721
|
+
*/
|
|
722
|
+
getWorldPrintJob(params) {
|
|
723
|
+
return this.request(`/3d/world${buildQuery(params)}`);
|
|
724
|
+
}
|
|
725
|
+
/**
|
|
726
|
+
* 轮询等待世界 3D 打印任务完成。
|
|
727
|
+
* @param jobId 任务 ID(由 submitWorldPrint 返回)
|
|
728
|
+
* @param intervalMs 轮询间隔 (ms),默认 100
|
|
729
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ThreeD/WorldPrintHandler.java)
|
|
730
|
+
* @returns 使用 {@link WorldPrintJobResultSchema} 验证
|
|
731
|
+
*/
|
|
732
|
+
async waitForWorldPrintJob(jobId, intervalMs = 100) {
|
|
733
|
+
while (true) {
|
|
734
|
+
const job = await this.getWorldPrintJob({ id: jobId });
|
|
735
|
+
if (job.status === "completed")
|
|
736
|
+
return job;
|
|
737
|
+
await new Promise(r => setTimeout(r, intervalMs));
|
|
738
|
+
}
|
|
739
|
+
}
|
|
740
|
+
/**
|
|
741
|
+
* 上传图片,估算生成的 3D 打印件 NBT 大小(不实际打印)。
|
|
742
|
+
* @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ThreeD/PrintSizeHandler.java)
|
|
743
|
+
* @returns 使用 {@link PrintSizeResultSchema} 验证
|
|
744
|
+
*/
|
|
745
|
+
getPrintSize(image, params) {
|
|
746
|
+
return this.request(`/3d/size${buildQuery(params ?? {})}`, {
|
|
747
|
+
method: "PUT",
|
|
748
|
+
body: image,
|
|
749
|
+
});
|
|
750
|
+
}
|
|
751
|
+
}
|
|
752
|
+
exports.WebApiClient = WebApiClient;
|
|
753
|
+
class WebApiError extends Error {
|
|
754
|
+
constructor(message, status, body) {
|
|
755
|
+
super(message);
|
|
756
|
+
this.name = "WebApiError";
|
|
757
|
+
this.status = status;
|
|
758
|
+
this.body = body;
|
|
759
|
+
}
|
|
760
|
+
}
|
|
761
|
+
exports.WebApiError = WebApiError;
|