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

package/dist/types/gt5.d.ts

@@ -0,0 +1,210 @@
+import type { ClassInfo } from "./common";
+import type { Fluid } from "./fluid";
+export type GT5MachineType = "MULTIBLOCK" | "SINGLE" | "GENERATOR" | "HATCH" | "UNKNOWN";
+export interface GT5ShutDownReason {
+    id: string;
+    displayString: string;
+    wasCritical: boolean;
+}
+/**
+ * 机器 IO 信息，由 GT5 IGregTechDeviceInformation 接口提供。
+ * 字段 inputVoltage/inputAmperage 仅在机器接入电力输入网络时存在；
+ * outputVoltage/outputAmperage 仅在机器接入电力输出网络时存在。
+ */
+export interface GT5MachineIO {
+    storedEU: number;
+    euCapacity: number;
+    /** getInfoData() 返回的格式化字符串数组（IC2 信息显示屏同源数据） */
+    Info: string[];
+    /** getInfoMap() 返回的结构化键值对 */
+    rawInfo: Record<string, string>;
+    inputVoltage?: number;
+    inputAmperage?: number;
+    outputVoltage?: number;
+    outputAmperage?: number;
+}
+export interface GT5MachineState {
+    isActive: boolean;
+    isAllowedToWork: boolean;
+    wasShutdown?: boolean;
+    lastShutDownReason?: GT5ShutDownReason;
+    storedEU: number;
+    euCapacity: number;
+    Info?: string[];
+    rawInfo?: Record<string, string>;
+    inputVoltage?: number;
+    inputAmperage?: number;
+    outputVoltage?: number;
+    outputAmperage?: number;
+}
+export interface GT5HatchCoord {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface GT5MaintenanceState {
+    wrench: boolean;
+    screwdriver: boolean;
+    softMallet: boolean;
+    hardHammer: boolean;
+    solderingTool: boolean;
+    crowbar: boolean;
+}
+export interface GT5MultiBlockInfo {
+    structureValid: boolean;
+    progressTime: number;
+    maxProgressTime: number;
+    euT: number;
+    efficiency: number;
+    pollution: number;
+    inputVoltageTier: number;
+    maxInputEu: number;
+    maxInputAmps: number;
+    /** 所有能源仓已存储 EU 之和（注意：LSC 等电池类机器 EU 不存于能源仓，此值为 0） */
+    storedEnergy: number;
+    /** 所有能源仓总容量之和（注意：LSC 等电池类机器 EU 不存于能源仓，此值仅为能源仓容量） */
+    maxEnergy: number;
+    maxParallelRecipes: number;
+    trueParallel: number;
+    maintenance: GT5MaintenanceState;
+    hatches: {
+        inputBus: GT5HatchCoord[];
+        outputBus: GT5HatchCoord[];
+        inputHatch: GT5HatchCoord[];
+        outputHatch: GT5HatchCoord[];
+        energyHatch: GT5HatchCoord[];
+        dynamoHatch: GT5HatchCoord[];
+        maintenanceHatch: GT5HatchCoord[];
+        mufflerHatch: GT5HatchCoord[];
+        dualInputHatch: GT5HatchCoord[];
+        smartInputHatch: GT5HatchCoord[];
+    };
+}
+export interface GT5HatchInfo {
+    tier: number;
+}
+export interface GT5SingleBlockInfo {
+    tier: number;
+    progressTime: number;
+    maxProgressTime: number;
+    euT: number;
+    inputSlotCount: number;
+    amperage: number;
+    mainFacing: string;
+}
+export interface GT5GeneratorInfo {
+    tier: number;
+    storedEU: number;
+    maxEUStore: number;
+    pollution: number;
+    efficiency: number;
+    recipeMap?: string;
+    maxEUOutput: number;
+    capacity: number;
+    fluid?: Fluid;
+}
+export type GT5Machine = {
+    machineType: "MULTIBLOCK";
+    multi: GT5MultiBlockInfo;
+} | {
+    machineType: "SINGLE";
+    single: GT5SingleBlockInfo;
+} | {
+    machineType: "GENERATOR";
+    generator: GT5GeneratorInfo;
+} | {
+    machineType: "HATCH";
+    hatch: GT5HatchInfo;
+} | {
+    machineType: "UNKNOWN";
+};
+/** GET /gt5 返回的完整机器信息 */
+export type GT5MachineInfo = {
+    x: number;
+    y: number;
+    z: number;
+    dimension: number;
+    localName: string;
+    internalName: string;
+    metaTileID: number;
+    owner: string;
+    state: GT5MachineState;
+    class?: ClassInfo;
+    nbt: Record<string, unknown>;
+} & GT5Machine;
+export interface GT5BatchMachineCoord {
+    x: number;
+    y: number;
+    z: number;
+    dim?: number;
+}
+/** POST /gt5/batch 提交结果 */
+export interface GT5BatchSubmitResult {
+    id: string;
+    total: number;
+}
+/** PATCH /gt5/batch 重执行结果 */
+export interface GT5BatchRerunResult {
+    id: string;
+    total: number;
+    runCount: number;
+}
+export type GT5BatchJobStatus = "pending" | "running" | "completed";
+/** GET /gt5/batch 查询结果 */
+export interface GT5BatchJobResult {
+    id: string;
+    total: number;
+    completed: number;
+    success: number;
+    failed: number;
+    status: GT5BatchJobStatus;
+    runCount: number;
+    createTime: number;
+    finishTime?: number;
+    durationMs?: number;
+    errors?: string[];
+    errorsTruncated?: number;
+    machines?: GT5MachineInfo[];
+}
+/** POST /gt5/scan 提交结果 */
+export interface GT5ScanSubmitResult {
+    id: string;
+    total: number;
+}
+/** Scan 中单个机器信息（精简版，不含 state/multi/hatch/single） */
+export interface GT5ScanMachine {
+    x: number;
+    y: number;
+    z: number;
+    machineType: GT5MachineType;
+    localName: string;
+    internalName: string;
+    metaTileID: number;
+    owner: string;
+}
+export interface GT5ScanResult {
+    chunkX: number;
+    chunkZ: number;
+    dimension: number;
+    totalMachines: number;
+    machines: GT5ScanMachine[];
+}
+export type GT5ScanJobStatus = "pending" | "running" | "completed";
+/** GET /gt5/scan 查询结果 */
+export interface GT5ScanJobResult {
+    id: string;
+    total: number;
+    completed: number;
+    success: number;
+    failed: number;
+    status: GT5ScanJobStatus;
+    createTime: number;
+    chunkX: number;
+    chunkZ: number;
+    dimension: number;
+    finishTime?: number;
+    durationMs?: number;
+    errors?: string[];
+    errorsTruncated?: number;
+    result?: GT5ScanResult;
+}

package/dist/types/gt5.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./common";
+export * from "./block";
+export * from "./item";
+export * from "./fluid";
+export * from "./entity";
+export * from "./chunk";
+export * from "./world";
+export * from "./ae2";
+export * from "./fmp";
+export * from "./gt5";
+export * from "./rawInfo";

package/dist/types/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./common"), exports);
+__exportStar(require("./block"), exports);
+__exportStar(require("./item"), exports);
+__exportStar(require("./fluid"), exports);
+__exportStar(require("./entity"), exports);
+__exportStar(require("./chunk"), exports);
+__exportStar(require("./world"), exports);
+__exportStar(require("./ae2"), exports);
+__exportStar(require("./fmp"), exports);
+__exportStar(require("./gt5"), exports);
+__exportStar(require("./rawInfo"), exports);

package/dist/types/item.d.ts

@@ -0,0 +1,39 @@
+import type { ClassInfo } from "./common";
+export interface NBTData {
+    nbtstr?: string;
+    nbtWrite?: string;
+    nbt?: Record<string, unknown>;
+}
+export interface Item {
+    class?: ClassInfo;
+    id: number;
+    registryName: string;
+    UnlocalizedName: string;
+    localizedName: string;
+    HasSubtypes: boolean;
+}
+export interface ItemStack extends Item, NBTData {
+    MaxStackSize: number;
+    damageable: boolean;
+    damage: number;
+    AttributeModifiers?: Record<string, unknown>;
+    stackSize?: number;
+    count?: number;
+}
+export interface ItemDetail extends Item {
+    subs?: ItemStack[];
+}
+export interface AEItemDefinitions {
+    items: Array<Item & {
+        name: string;
+    }>;
+    parts: Array<Item & {
+        name: string;
+    }>;
+    materials: Array<Item & {
+        name: string;
+    }>;
+    blocks: Array<Item & {
+        name: string;
+    }>;
+}

package/dist/types/item.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/rawInfo.d.ts

@@ -0,0 +1,25 @@
+/**
+ * LSC rawInfo 解析后的强类型视图。
+ * @java [java](../../../../src/main/java/love/shirokasoke/webapi/mixins/late/MTELapotronicSuperCapacitorGetInfoMapMixin.java)
+ */
+export interface LSCRawInfoMap {
+    stored: string;
+    capacity: string;
+    inputLastTick: number;
+    outputLastTick: number;
+    passiveDischargeAmount: number;
+    avgInput100t: number;
+    avgOutput100t: number;
+    avgInput5m: number;
+    avgOutput5m: number;
+    avgInput1h: number;
+    avgOutput1h: number;
+    maxEUInput: number;
+    maxEUOutput: number;
+    wirelessMode: boolean;
+    wirelessEU?: string;
+    capacitorUHV: number;
+    capacitorUEV: number;
+    capacitorUIV: number;
+    capacitorUMV: number;
+}

package/dist/types/rawInfo.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/world.d.ts

@@ -0,0 +1,58 @@
+import type { ClassInfo } from "./common";
+export interface TPSInfo {
+    WorldName?: string;
+    TickTime: number;
+    TPS: number;
+}
+export interface WorldInfoData {
+    WorldServerClass?: ClassInfo;
+    WorldInfoClass?: ClassInfo;
+    WorldInfo: Record<string, unknown>;
+}
+export interface ProfilerData {
+    server: {
+        totalMemoryMB: number;
+        freeMemoryMB: number;
+        maxMemoryMB: number;
+    };
+    dimensions: Record<string, {
+        name: string;
+        loadedChunks: number;
+        totalEntities: number;
+        totalTileEntities: number;
+        laggyChunks: Array<{
+            chunkX: number;
+            chunkZ: number;
+            entityCount: number;
+        }>;
+    }>;
+    profiler: {
+        enabled: boolean;
+    };
+}
+export interface LagAnalyzerData {
+    entities: {
+        byType: Array<{
+            name: string;
+            count: number;
+            items: number;
+            xpOrbs: number;
+        }>;
+        byDimension: Record<string, number>;
+    };
+    tileEntities: {
+        byType: Array<{
+            name: string;
+            count: number;
+            samplePositions: string[];
+        }>;
+        byDimension: Record<string, number>;
+    };
+    memory: {
+        totalMB: number;
+        freeMB: number;
+        usedMB: number;
+        maxMB: number;
+        availableProcessors: number;
+    };
+}

package/dist/types/world.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/validators/ae2.d.ts

@@ -0,0 +1,55 @@
+import Joi from "joi";
+import type { AECPU, AECPUCancelBody, AECPUCancelResult, AECraftingTaskBody, AECraftingTaskResult, AEHitResult, AEItemsResult, AEMEInterface, AENode } from "../types/ae2";
+export declare const AEStackProvidersSchema: Joi.ArraySchema<any[]>;
+/** 对应服务端 Pattern.dumpAEStack 的输出：物品或流体堆，附加 count 字段 */
+export declare const AEStackSchema: Joi.AlternativesSchema<{
+    MaxStackSize: unknown;
+    damageable: unknown;
+    damage: unknown;
+    AttributeModifiers: unknown;
+    stackSize: unknown;
+    count: unknown;
+} | {
+    count: unknown;
+}>;
+export declare const AEStackWithProvidersSchema: Joi.AlternativesSchema<{
+    count: unknown;
+    providers: unknown;
+} | {
+    count: unknown;
+    providers: unknown;
+}>;
+export declare const AENodeSchema: Joi.ObjectSchema<AENode>;
+export declare const AE2PatternSchema: Joi.ObjectSchema<{
+    crafting: unknown;
+    substitute: unknown;
+    beSubstitute: unknown;
+    author: unknown;
+    inputs: unknown;
+    outputs: unknown;
+    isCraftable: unknown;
+    priority: unknown;
+    canSubstitute: unknown;
+    canBeSubstitute: unknown;
+    condensedInputs: unknown;
+    condensedOutputs: unknown;
+    patternParseError: unknown;
+}>;
+export declare const AECPUSchema: Joi.ObjectSchema<AECPU>;
+export declare const AEMEInterfaceSchema: Joi.ObjectSchema<AEMEInterface>;
+export declare const AECraftingTaskBodySchema: Joi.ObjectSchema<AECraftingTaskBody>;
+export declare const AECraftingTaskResultSchema: Joi.ObjectSchema<AECraftingTaskResult>;
+export declare const AECPUCancelBodySchema: Joi.ObjectSchema<AECPUCancelBody>;
+export declare const AECPUCancelResultSchema: Joi.ObjectSchema<AECPUCancelResult>;
+export declare const AEItemStackSchema: Joi.AlternativesSchema<{
+    type: unknown;
+    stackSize: unknown;
+    Craftable: unknown;
+} | {
+    type: unknown;
+    stackSize: unknown;
+    Craftable: unknown;
+}>;
+export declare const AEItemCellStatusSchema: Joi.ObjectSchema<any>;
+export declare const AEItemsResultSchema: Joi.ObjectSchema<AEItemsResult>;
+export declare const AEHitResultSchema: Joi.ObjectSchema<AEHitResult>;

package/dist/validators/ae2.js

@@ -0,0 +1,144 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AEHitResultSchema = exports.AEItemsResultSchema = exports.AEItemCellStatusSchema = exports.AEItemStackSchema = exports.AECPUCancelResultSchema = exports.AECPUCancelBodySchema = exports.AECraftingTaskResultSchema = exports.AECraftingTaskBodySchema = exports.AEMEInterfaceSchema = exports.AECPUSchema = exports.AE2PatternSchema = exports.AENodeSchema = exports.AEStackWithProvidersSchema = exports.AEStackSchema = exports.AEStackProvidersSchema = void 0;
+const joi_1 = __importDefault(require("joi"));
+const common_1 = require("./common");
+const fluid_1 = require("./fluid");
+const item_1 = require("./item");
+exports.AEStackProvidersSchema = joi_1.default.array().items(joi_1.default.object({
+    x: joi_1.default.number().required(),
+    y: joi_1.default.number().required(),
+    z: joi_1.default.number().required(),
+    dimension: joi_1.default.number().required(),
+})).required();
+/** 对应服务端 Pattern.dumpAEStack 的输出：物品或流体堆，附加 count 字段 */
+exports.AEStackSchema = joi_1.default.alternatives(item_1.ItemStackSchema.append({ count: joi_1.default.number().required() }), fluid_1.FluidSchema.append({ count: joi_1.default.number().required() }));
+exports.AEStackWithProvidersSchema = joi_1.default.alternatives(item_1.ItemStackSchema.append({
+    count: joi_1.default.number().required(),
+    providers: exports.AEStackProvidersSchema,
+}), fluid_1.FluidSchema.append({
+    count: joi_1.default.number().required(),
+    providers: exports.AEStackProvidersSchema,
+}));
+exports.AENodeSchema = joi_1.default.object({
+    active: joi_1.default.boolean().required(),
+    meetsChannel: joi_1.default.boolean().required(),
+    playerID: joi_1.default.number().required(),
+    machineClass: common_1.ClassInfoSchema.optional(),
+    isPart: joi_1.default.boolean().required(),
+    isIActionHost: joi_1.default.boolean().required(),
+    location: joi_1.default.object({
+        x: joi_1.default.number().required(),
+        y: joi_1.default.number().required(),
+        z: joi_1.default.number().required(),
+        dimension: joi_1.default.number().required(),
+    }).optional(),
+    idlePowerUsage: joi_1.default.number().required(),
+    flags: joi_1.default.array().items(joi_1.default.string()).required(),
+});
+exports.AE2PatternSchema = item_1.ItemStackSchema.append({
+    crafting: joi_1.default.boolean().required(),
+    substitute: joi_1.default.boolean().required(),
+    beSubstitute: joi_1.default.boolean().required(),
+    author: joi_1.default.string().optional(),
+    inputs: joi_1.default.array().items(joi_1.default.alternatives(item_1.ItemStackSchema, joi_1.default.valid(null))).optional(),
+    outputs: joi_1.default.array().items(joi_1.default.alternatives(item_1.ItemStackSchema, joi_1.default.valid(null))).optional(),
+    isCraftable: joi_1.default.boolean().optional(),
+    priority: joi_1.default.number().optional(),
+    canSubstitute: joi_1.default.boolean().optional(),
+    canBeSubstitute: joi_1.default.boolean().optional(),
+    condensedInputs: joi_1.default.array().items(exports.AEStackSchema).optional(),
+    condensedOutputs: joi_1.default.array().items(exports.AEStackSchema).optional(),
+    patternParseError: joi_1.default.string().optional(),
+});
+exports.AECPUSchema = joi_1.default.object({
+    name: joi_1.default.string().allow("").required(),
+    busy: joi_1.default.boolean().required(),
+    availableStorage: joi_1.default.number().unsafe().required(),
+    usedStorage: joi_1.default.number().required(),
+    coProcessors: joi_1.default.number().required(),
+    remainingItemCount: joi_1.default.number().required(),
+    startItemCount: joi_1.default.number().required(),
+    elapsedTime: joi_1.default.number().required(),
+    craftingAllowMode: joi_1.default.string().required(),
+    finalOutput: exports.AEStackSchema.optional(),
+    tasks: joi_1.default.array().items(joi_1.default.object({
+        remaining: joi_1.default.number().required(),
+        inputs: joi_1.default.array().items(exports.AEStackSchema).required(),
+        pattern: exports.AE2PatternSchema.required(),
+        outputs: joi_1.default.array().items(exports.AEStackWithProvidersSchema).required(),
+    })).optional(),
+    tasking: joi_1.default.array().items(exports.AEStackWithProvidersSchema).optional(),
+    tasksError: joi_1.default.string().optional(),
+});
+exports.AEMEInterfaceSchema = joi_1.default.object({
+    display: joi_1.default.boolean().required(),
+    name: joi_1.default.string().required(),
+    rawName: joi_1.default.string().allow(null).required(),
+    active: joi_1.default.boolean().required(),
+    allowsPatternOptimization: joi_1.default.boolean().required(),
+    playerID: joi_1.default.number().required(),
+    location: joi_1.default.object({
+        x: joi_1.default.number().required(),
+        y: joi_1.default.number().required(),
+        z: joi_1.default.number().required(),
+        dimension: joi_1.default.number().required(),
+    }).required(),
+    patterns: joi_1.default.array().items(exports.AE2PatternSchema.append({ slot: joi_1.default.number().required() })).required(),
+});
+exports.AECraftingTaskBodySchema = joi_1.default.object({
+    id: joi_1.default.number().required(),
+    Count: joi_1.default.number().required(),
+    Type: joi_1.default.string().valid("item", "fluid").optional(),
+    Damage: joi_1.default.number().optional(),
+    tag: joi_1.default.string().optional(),
+    cpu: joi_1.default.string().optional(),
+});
+exports.AECraftingTaskResultSchema = joi_1.default.object({
+    bytes: joi_1.default.number().required(),
+    cpu: joi_1.default.string().required(),
+    output: item_1.ItemStackSchema.append({ stackSize: joi_1.default.number().required() }).required(),
+});
+exports.AECPUCancelBodySchema = joi_1.default.object({
+    name: joi_1.default.string().optional(),
+    id: joi_1.default.number().optional(),
+});
+exports.AECPUCancelResultSchema = joi_1.default.object({
+    cpu: joi_1.default.string().required(),
+    wasBusy: joi_1.default.boolean().required(),
+});
+exports.AEItemStackSchema = joi_1.default.alternatives(item_1.ItemStackSchema.append({
+    type: joi_1.default.string().valid("item").required(),
+    stackSize: joi_1.default.number().required(),
+    Craftable: joi_1.default.boolean().required(),
+}), fluid_1.FluidSchema.append({
+    type: joi_1.default.string().valid("fluid").required(),
+    stackSize: joi_1.default.number().required(),
+    Craftable: joi_1.default.boolean().required(),
+}));
+exports.AEItemCellStatusSchema = joi_1.default.object({
+    all: joi_1.default.number().required(),
+    green: joi_1.default.number().required(),
+    blue: joi_1.default.number().required(),
+    orange: joi_1.default.number().required(),
+    red: joi_1.default.number().required(),
+});
+exports.AEItemsResultSchema = joi_1.default.object({
+    items: joi_1.default.array().items(exports.AEItemStackSchema).required(),
+    totalBytes: joi_1.default.number().required(),
+    usedBytes: joi_1.default.number().required(),
+    totalTypes: joi_1.default.number().required(),
+    usedTypes: joi_1.default.number().required(),
+    cellStatus: exports.AEItemCellStatusSchema.required(),
+    fluidTotalBytes: joi_1.default.number().required(),
+    fluidUsedBytes: joi_1.default.number().required(),
+    fluidTotalTypes: joi_1.default.number().required(),
+    fluidUsedTypes: joi_1.default.number().required(),
+    fluidCellStatus: exports.AEItemCellStatusSchema.required(),
+});
+exports.AEHitResultSchema = joi_1.default.object({
+    message: joi_1.default.string().required(),
+});

package/dist/validators/block.d.ts

@@ -0,0 +1,12 @@
+import Joi from "joi";
+import type { BatchSetBlockJobResult, Block, BlockDetail } from "../types/block";
+export declare const MaterialSchema: Joi.ObjectSchema<any>;
+export declare const BlockSchema: Joi.ObjectSchema<Block>;
+export declare const BlockDetailSchema: Joi.ObjectSchema<BlockDetail>;
+export declare const SetBlockBodySchema: Joi.ObjectSchema<any>;
+export declare const SetBlockResultSchema: Joi.Schema<any>;
+export declare const BatchSetBlockTaskSchema: Joi.ObjectSchema<any>;
+export declare const BatchSetBlockSubmitResultSchema: Joi.ObjectSchema<any>;
+export declare const BatchSetBlockJobStatusSchema: Joi.Schema<any>;
+export declare const BatchSetBlockFailureSchema: Joi.ObjectSchema<any>;
+export declare const BatchSetBlockJobResultSchema: Joi.ObjectSchema<BatchSetBlockJobResult>;