@shirokasoke/webapi-sdk 2.9.0-bete2-0.6-pre

package/dist/client.js

@@ -0,0 +1,462 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebApiError = exports.WebApiClient = void 0;
+function buildQuery(params) {
+    const record = params;
+    const qs = Object.entries(record)
+        .filter(([, v]) => v !== undefined)
+        .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)
+        .join("&");
+    return qs ? `?${qs}` : "";
+}
+class WebApiClient {
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, "");
+        this.authToken = options.authToken;
+        const globalFetch = typeof globalThis !== "undefined" ? globalThis.fetch : undefined;
+        this.fetchImpl = options.fetch || globalFetch || undefined;
+        if (!this.fetchImpl) {
+            throw new Error("No fetch implementation provided. Pass one via options.fetch or run in an environment with global fetch.");
+        }
+    }
+    async request(path, init) {
+        const req = new Request(`${this.baseUrl}${path}`, init);
+        if (this.authToken) {
+            req.headers.set("Authorization", this.authToken);
+        }
+        const res = await this.fetchImpl(req);
+        const contentType = res.headers.get("content-type") || "";
+        if (!res.ok) {
+            if (contentType.includes("application/json")) {
+                const body = await res.json().catch(() => ({ message: res.statusText }));
+                throw new WebApiError(body.message || res.statusText, res.status, body);
+            }
+            throw new WebApiError(res.statusText, res.status);
+        }
+        if (contentType.includes("application/json")) {
+            const body = await res.json();
+            if (body.success) {
+                return body.data;
+            }
+            else {
+                throw new WebApiError(body.message, res.status, body);
+            }
+        }
+        return res.arrayBuffer();
+    }
+    // ========== Root / Status ==========
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/RootHandler.java)
+     * @returns 使用 {@link RootInfoSchema} 验证
+     */
+    getRoot() {
+        return this.request("/version");
+    }
+    // ========== TPS / Performance ==========
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/TPSHandler.java)
+     * @returns 使用 `Joi.object().pattern(Joi.string(), {@link TPSInfoSchema})` 验证
+     */
+    getTPS() {
+        return this.request("/tps");
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ProfilerHandler.java)
+     * @returns 使用 {@link ProfilerDataSchema} 验证
+     */
+    getProfiler() {
+        return this.request("/profiler");
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/LagAnalyzerHandler.java)
+     * @returns 使用 {@link LagAnalyzerDataSchema} 验证
+     */
+    getLagAnalyzer() {
+        return this.request("/lag-analyzer");
+    }
+    // ========== World ==========
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/WorldInfoHandler.java)
+     * @returns 使用 `Joi.object().pattern(Joi.string(), {@link WorldInfoDataSchema})` 验证
+     */
+    getWorldInfo() {
+        return this.request("/WorldInfo");
+    }
+    // ========== Blocks ==========
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/BlocksHandler.java)
+     * @returns 使用 `Joi.array().items(`{@link BlockSchema}`)` 验证
+     */
+    getBlocks() {
+        return this.request("/blocks");
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/BlockHandler.java)
+     * @returns 使用 {@link BlockDetailSchema} 验证
+     */
+    getBlock(params) {
+        return this.request(`/block${buildQuery(params)}`);
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/SetBlockHandler.java)
+     * @param body 使用 {@link SetBlockBodySchema} 验证
+     * @returns 使用 {@link SetBlockResultSchema} 验证
+     */
+    setBlock(params, body) {
+        return this.request(`/setblock${buildQuery(params)}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+    }
+    /**
+     * 提交批量 setblock 任务到慢队列，异步执行。
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/BatchSetBlockHandler.java)
+     * @param tasks 使用 `Joi.array().items(`{@link BatchSetBlockTaskSchema} ) 验证
+     * @returns 使用 {@link BatchSetBlockSubmitResultSchema} 验证
+     */
+    batchSetBlock(tasks) {
+        return this.request("/batchsetblock", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(tasks),
+        });
+    }
+    /**
+     * 查询批量 setblock 任务执行结果。
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/BatchSetBlockHandler.java)
+     * @returns 使用 {@link BatchSetBlockJobResultSchema} 验证
+     */
+    getBatchSetBlockJob(params) {
+        return this.request(`/batchsetblock${buildQuery(params)}`);
+    }
+    /**
+     * 轮询等待批量 setblock 任务完成。
+     * @param jobId 任务 ID（由 batchSetBlock 返回）
+     * @param intervalMs 轮询间隔 (ms)，默认 100
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/BatchSetBlockHandler.java)
+     * @returns 使用 {@link BatchSetBlockJobResultSchema} 验证
+     */
+    async waitForBatchSetBlockJob(jobId, intervalMs = 100) {
+        while (true) {
+            const job = await this.getBatchSetBlockJob({ id: jobId });
+            if (job.status === "completed")
+                return job;
+            await new Promise(r => setTimeout(r, intervalMs));
+        }
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/FMPHandler.java)
+     * @returns 使用 `Joi.array().items(`{@link FMPPartSchema}`)` 验证
+     */
+    getBlockFMP(params) {
+        return this.request(`/block/fmp${buildQuery(params)}`);
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/block/BlockTileHandler.java)
+     * @returns 二进制数据，无 JSON Schema
+     */
+    getBlockTile(params) {
+        return this.request(`/block/tile${buildQuery(params)}`);
+    }
+    // ========== Items ==========
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/item/ItemsHandler.java)
+     * @returns 使用 `Joi.array().items(`{@link ItemSchema}`)` 验证
+     */
+    getItems() {
+        return this.request("/items");
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/item/ItemHandler.java)
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/item/ItemStaticHandler.java)
+     * @returns 使用 {@link ItemDetailSchema} 验证
+     */
+    getItem(params) {
+        return this.request(`/item${buildQuery(params)}`);
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/item/ItemIconHandler.java)
+     * @param params.id 物品 ID（对应 ItemStack 的 id）
+     * @param params.damage 物品损伤值/元数据（可选，默认 0）
+     * @param params.tag Base64 编码的 NBTTagCompound（可选）
+     * @returns 二进制 PNG 图片数据 (ArrayBuffer)
+     */
+    getItemIcon(params) {
+        return this.request(`/item/icon${buildQuery(params)}`);
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/item/AEHandler.java)
+     * @returns 使用 {@link AEItemDefinitionsSchema} 验证
+     */
+    getAEItems() {
+        return this.request("/items/ae");
+    }
+    // ========== Fluids ==========
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/fluid/FluidsHandler.java)
+     * @returns 使用 `Joi.array().items(`{@link FluidSchema}`)` 验证
+     */
+    getFluids() {
+        return this.request("/fluids");
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/fluid/FluidContainersHandler.java)
+     * @returns 使用 `Joi.array().items(`{@link FluidContainerSchema}`)` 验证
+     */
+    getFluidContainers() {
+        return this.request("/fluidContainers");
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/fluid/FluidIconHandler.java)
+     * @param params.id 流体 ID（对应 Fluid 的 id）
+     * @param params.name 流体名称（对应 Fluid 的 name）
+     * @returns 二进制 PNG 图片数据 (ArrayBuffer)
+     */
+    getFluidIcon(params) {
+        return this.request(`/fluid/icon${buildQuery(params)}`);
+    }
+    // ========== Entities ==========
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/entity/EntitiesHandler.java)
+     * @returns 使用 `Joi.object().pattern(Joi.string(),`{@link EntitiesByDimensionSchema}`)` 验证
+     *
+     * 其中实体为 {@link EntitySummarySchema} 精简结构
+     */
+    getEntities() {
+        return this.request("/entities");
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/entity/EntityHandler.java)
+     * @returns 使用 {@link EntitySchema} 验证
+     */
+    getEntity(params) {
+        return this.request(`/entity${buildQuery(params)}`);
+    }
+    // ========== Chunks ==========
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/chunk/ChunksHandler.java)
+     * @returns 使用 `Joi.object().pattern(Joi.string(),`{@link ChunksByDimensionSchema}`)` 验证
+     */
+    getChunks() {
+        return this.request("/chunks");
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/chunk/ChunkHandler.java)
+     * @returns 使用 {@link ChunkWithDimensionSchema} 验证
+     */
+    getChunk(params) {
+        return this.request(`/chunk${buildQuery(params)}`);
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/chunk/ChunkMapHandler.java)
+     * @returns JSON 模式使用 `Joi.array().items(Joi.array().items(`{@link ChunkMapCellSchema}`)` 验证；raw 模式为 ArrayBuffer
+     */
+    getChunkMap(params, raw) {
+        const q = buildQuery({
+            ...params,
+            raw: raw == true ? String(raw) : undefined,
+        });
+        return this.request(`/chunk/map${q}`);
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/chunk/ChunkForceHandler.java)
+     * @returns 使用 {@link ChunkForceListSchema} 验证
+     */
+    getChunkForceList() {
+        return this.request("/chunk/force");
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/chunk/ChunkForceHandler.java)
+     * @returns 使用 {@link ChunkLoadResultSchema} 验证
+     */
+    loadChunk(params) {
+        return this.request(`/chunk/force${buildQuery({ action: "load", ...params })}`, {
+            method: "POST",
+        });
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/chunk/ChunkForceHandler.java)
+     * @returns 使用 {@link ChunkLoadResultSchema} 验证
+     */
+    unloadChunk(params) {
+        return this.request(`/chunk/force${buildQuery({ action: "unload", ...params })}`, {
+            method: "POST",
+        });
+    }
+    // ========== GT5 ==========
+    /**
+     * 查询单个 GT5 机器信息。
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5BaseHandler.java)
+     * @returns 使用 {@link GT5MachineInfoSchema} 验证
+     */
+    getGT5Machine(params) {
+        return this.request(`/gt5${buildQuery(params)}`);
+    }
+    /**
+     * 提交批量 GT5 机器查询任务。
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5BatchHandler.java)
+     * @param machines 使用 `Joi.array().items(`{@link GT5BatchMachineCoordSchema}`)` 验证
+     * @returns 使用 {@link GT5BatchSubmitResultSchema} 验证
+     */
+    submitGT5Batch(machines) {
+        return this.request("/gt5/batch", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(machines),
+        });
+    }
+    /**
+     * 查询批量 GT5 机器任务状态。
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5BatchHandler.java)
+     * @returns 使用 {@link GT5BatchJobResultSchema} 验证
+     */
+    getGT5BatchJob(params) {
+        return this.request(`/gt5/batch${buildQuery(params)}`);
+    }
+    /**
+     * 重新执行已有的批量 GT5 机器查询任务。
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5BatchHandler.java)
+     * @returns 使用 {@link GT5BatchRerunResultSchema} 验证
+     */
+    rerunGT5Batch(params) {
+        return this.request(`/gt5/batch${buildQuery(params)}`, {
+            method: "PATCH",
+        });
+    }
+    /**
+     * 轮询等待批量 GT5 机器任务完成。
+     * @param jobId 任务 ID（由 submitGT5Batch 返回）
+     * @param intervalMs 轮询间隔 (ms)，默认 100
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5BatchHandler.java)
+     * @returns 使用 {@link GT5BatchJobResultSchema} 验证
+     */
+    async waitForGT5BatchJob(jobId, intervalMs = 100) {
+        while (true) {
+            const job = await this.getGT5BatchJob({ id: jobId });
+            if (job.status === "completed")
+                return job;
+            await new Promise(r => setTimeout(r, intervalMs));
+        }
+    }
+    /**
+     * 提交区块扫描任务，异步扫描指定区块内所有 GT5 机器。
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5ChunkScanHandler.java)
+     * @returns 使用 {@link GT5ScanSubmitResultSchema} 验证
+     */
+    submitGT5ChunkScan(params) {
+        return this.request(`/gt5/scan${buildQuery(params)}`, {
+            method: "POST",
+        });
+    }
+    /**
+     * 查询区块扫描任务状态。
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5ChunkScanHandler.java)
+     * @returns 使用 {@link GT5ScanJobResultSchema} 验证
+     */
+    getGT5ScanJob(params) {
+        return this.request(`/gt5/scan${buildQuery(params)}`);
+    }
+    /**
+     * 轮询等待区块扫描任务完成。
+     * @param jobId 任务 ID（由 submitGT5ChunkScan 返回）
+     * @param intervalMs 轮询间隔 (ms)，默认 100
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/gt5/GT5ChunkScanHandler.java)
+     * @returns 使用 {@link GT5ScanJobResultSchema} 验证
+     */
+    async waitForGT5ScanJob(jobId, intervalMs = 100) {
+        while (true) {
+            const job = await this.getGT5ScanJob({ id: jobId });
+            if (job.status === "completed")
+                return job;
+            await new Promise(r => setTimeout(r, intervalMs));
+        }
+    }
+    // ========== AE2 ==========
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AEBaseHandler.java)
+     * @returns 使用 {@link AEHitResultSchema} 验证
+     */
+    aeHit(params) {
+        return this.request(`/ae${buildQuery(params)}`);
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AENodesHandler.java)
+     * @returns 使用 `Joi.array().items(`{@link AENodeSchema}`)` 验证
+     */
+    aeNodes(params) {
+        return this.request(`/ae/nodes${buildQuery(params)}`);
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AECPUHandler.java)
+     * @returns 使用 `Joi.array().items(`{@link AECPUSchema}`)` 验证
+     */
+    aeCPUs(params) {
+        return this.request(`/ae/cpu${buildQuery(params)}`);
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AEMEHandler.java)
+     * @returns 使用 `Joi.array().items(`{@link AE2PatternSchema}`.append({ slot: Joi.number().required(), direction: Joi.string().optional() }))` 验证
+     */
+    aeME(params) {
+        return this.request(`/ae/me${buildQuery(params)}`);
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AEMEsHandler.java)
+     * @returns 使用 `Joi.array().items(`{@link AEMEInterfaceSchema}`)` 验证
+     */
+    aeMEs(params) {
+        if (params.load || params.world) {
+            params.pattern = true;
+        }
+        return this.request(`/ae/mes${buildQuery(params)}`);
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AEMEsupportHandler.java)
+     * @returns 字符串数组，无专用 Schema
+     */
+    aeMESupport() {
+        return this.request("/ae/me/support");
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AEItemHandler.java)
+     * @returns 使用 {@link AEItemsResultSchema} 验证
+     */
+    aeItems(params) {
+        return this.request(`/ae/item${buildQuery(params)}`);
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AECPUTaskHandler.java)
+     * @param body 使用 {@link AECraftingTaskBodySchema} 验证
+     * @returns 使用 {@link AECraftingTaskResultSchema} 验证
+     */
+    aeCraft(params, body) {
+        return this.request(`/ae/cpu/task${buildQuery(params)}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+    }
+    /**
+     * @java [java](../../../src/main/java/love/shirokasoke/webapi/webserver/handlers/ae2/AECPUCancelHandler.java)
+     * @param body 使用 {@link AECPUCancelBodySchema} 验证
+     * @returns 使用 {@link AECPUCancelResultSchema} 验证
+     */
+    aeCancel(params, body) {
+        return this.request(`/ae/cpu/cancel${buildQuery(params)}`, {
+            method: "DELETE",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+    }
+}
+exports.WebApiClient = WebApiClient;
+class WebApiError extends Error {
+    constructor(message, status, body) {
+        super(message);
+        this.name = "WebApiError";
+        this.status = status;
+        this.body = body;
+    }
+}
+exports.WebApiError = WebApiError;