@shirokasoke/webapi-sdk 2.9.0-beta2-0.11-pre

package/dist/types/recipe.d.ts

@@ -0,0 +1,114 @@
+import type { Fluid } from "./fluid";
+import type { ItemStack } from "./item";
+/** 合成配方查询中单个格子/原料的可选物品集合 */
+export interface RecipeIngredient {
+    /** 矿物词典前缀列表（如 ["plankWood"]），仅有序/无序矿物词典配方会出现 */
+    ores?: string[];
+    /** 可替代的物品列表，至少一个 */
+    items: Array<ItemStack & {
+        stackSize: number;
+    }>;
+}
+/** 工作台合成配方（有序/无序） */
+export interface CraftingRecipe {
+    /** 配方实现类全名，如 net.minecraft.item.crafting.ShapedRecipes */
+    recipeClass: string;
+    /** shaped=有序，shapeless=无序，unknown=无法识别的实现 */
+    type: "shaped" | "shapeless" | "unknown";
+    shapeless: boolean;
+    /** 有序配方网格宽度；无法还原网格或无序配方时为 -1 */
+    width?: number;
+    /** 有序配方网格高度；无法还原网格或无序配方时为 -1 */
+    height?: number;
+    /** 有序配方网格（可为 null 表示空槽）；无法还原网格时不输出 */
+    grid?: Array<Array<RecipeIngredient | null>>;
+    /** 无序配方原料列表；无法还原网格的有序配方也会退化为该字段 */
+    ingredients?: RecipeIngredient[];
+    output: (ItemStack & {
+        stackSize: number;
+    }) | null;
+}
+/** 熔炉熔炼配方的单条记录 */
+export interface FurnaceRecipe {
+    input: ItemStack & {
+        stackSize: number;
+    };
+    output: ItemStack & {
+        stackSize: number;
+    };
+}
+/** /recipes/crafting 响应 */
+export interface CraftingRecipesResult {
+    type: "crafting";
+    queryType: "output" | "input";
+    count: number;
+    offset: number;
+    /** 仅在启用索引加速（IndexedCraftingRecipesHandler）时输出 */
+    total?: number;
+    query?: ItemStack & {
+        stackSize?: number;
+    };
+    recipes: CraftingRecipe[];
+}
+/** /recipes/furnace 响应 */
+export interface FurnaceRecipesResult {
+    type: "furnace";
+    queryType: "output" | "input";
+    count: number;
+    offset: number;
+    query?: ItemStack & {
+        stackSize?: number;
+    };
+    recipes: FurnaceRecipe[];
+}
+/** GT5 配方表映射表中的一项 */
+export interface GTRecipeMap {
+    unlocalizedName: string;
+    name: string;
+}
+/** GT5 配方（结构与 GTRecipe 字段对应） */
+export interface GTRecipe {
+    recipeMap: string;
+    recipeMapName: string;
+    duration: number;
+    eut: number;
+    amperage: number;
+    specialValue: number;
+    enabled: boolean;
+    hidden: boolean;
+    fake: boolean;
+    inputs: {
+        items: Array<(ItemStack & {
+            stackSize: number;
+        }) | null>;
+        fluids: Array<(Fluid & {
+            amount: number;
+        }) | null>;
+    };
+    outputs: {
+        items: Array<(ItemStack & {
+            stackSize: number;
+        }) | null>;
+        fluids: Array<(Fluid & {
+            amount: number;
+        }) | null>;
+    };
+    inputChances: number[];
+    outputChances: number[];
+    fluidInputChances: number[];
+    fluidOutputChances: number[];
+}
+/** /recipes/gt 响应 */
+export interface GTRecipesResult {
+    type: "gt";
+    queryType: "output" | "input";
+    count: number;
+    offset: number;
+    /** 限定查询的配方表（仅当传入 map 参数时输出） */
+    map?: string;
+    query?: ItemStack & {
+        stackSize?: number;
+    };
+    fluid?: Fluid;
+    recipes: GTRecipe[];
+}

package/dist/types/recipe.js

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

package/dist/types/threeD.d.ts

@@ -0,0 +1,43 @@
+/** 3D 打印任务状态 */
+export type PrintJobStatus = "pending" | "running" | "completed";
+/** /3d/player 响应：投递到玩家背包的结果 */
+export interface PlayerPrintResult {
+    /** 生成的打印件总数 */
+    total: number;
+    /** 成功放入背包的数量 */
+    added: number;
+    /** 背包放不下、掉落在玩家附近的数量 */
+    dropped: number;
+}
+/** /3d/world PUT 提交响应 */
+export interface WorldPrintSubmitResult {
+    id: string;
+    total: number;
+    /** 全透明被跳过的小块数量 */
+    skipped: number;
+}
+/** /3d/world 任务失败详情 */
+export interface WorldPrintFailure {
+    x: number;
+    y: number;
+    z: number;
+    reason: string;
+}
+/** /3d/world GET 任务结果 */
+export interface WorldPrintJobResult {
+    id: string;
+    total: number;
+    completed: number;
+    success: number;
+    failed: number;
+    status: PrintJobStatus;
+    createTime: number;
+    finishTime?: number;
+    durationMs?: number;
+    failures?: WorldPrintFailure[];
+    failuresTruncated?: number;
+}
+/** /3d/size 响应：打印件 NBT 大小（字节） */
+export interface PrintSizeResult {
+    size: number;
+}

package/dist/types/threeD.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,63 @@
+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 的输出：物品或流体堆，附加 stackSize 字段 */
+export declare const AEStackSchema: Joi.AlternativesSchema<{
+    MaxStackSize: unknown;
+    damageable: unknown;
+    damage: unknown;
+    AttributeModifiers: unknown;
+    stackSize: unknown;
+} | {
+    stackSize: unknown;
+}>;
+export declare const AEStackWithProvidersSchema: Joi.AlternativesSchema<{
+    stackSize: unknown;
+    providers: unknown;
+} | {
+    stackSize: 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;
+}>;
+/**
+ * `appeng.util.ScheduledReason` 枚举名。
+ * 采用严格枚举校验：取值必须是下方列表中的一项，未知值直接判非法。
+ * rv3-beta-1000-GTNH 已知取值：UNDEFINED / SOMETHING_STUCK / BLOCKING_MODE /
+ * LOCK_MODE / NO_TARGET / NOT_ENOUGH_INGREDIENTS / SAME_NETWORK / UNSUPPORTED_STACK
+ */
+export declare const AE_CPU_SCHEDULED_REASONS: readonly ["UNDEFINED", "SOMETHING_STUCK", "BLOCKING_MODE", "LOCK_MODE", "NO_TARGET", "NOT_ENOUGH_INGREDIENTS", "SAME_NETWORK", "UNSUPPORTED_STACK"];
+export declare const AECPUScheduledReasonSchema: Joi.StringSchema<string>;
+export declare const AECPUTaskSchema: Joi.ObjectSchema<any>;
+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,169 @@
+"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.AECPUTaskSchema = exports.AECPUScheduledReasonSchema = exports.AE_CPU_SCHEDULED_REASONS = 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 的输出：物品或流体堆，附加 stackSize 字段 */
+exports.AEStackSchema = joi_1.default.alternatives(item_1.ItemStackSchema.append({ stackSize: joi_1.default.number().required() }), fluid_1.FluidSchema.append({ stackSize: joi_1.default.number().required() }));
+exports.AEStackWithProvidersSchema = joi_1.default.alternatives(item_1.ItemStackSchema.append({
+    stackSize: joi_1.default.number().required(),
+    providers: exports.AEStackProvidersSchema,
+}), fluid_1.FluidSchema.append({
+    stackSize: 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(),
+});
+/**
+ * `appeng.util.ScheduledReason` 枚举名。
+ * 采用严格枚举校验：取值必须是下方列表中的一项，未知值直接判非法。
+ * rv3-beta-1000-GTNH 已知取值：UNDEFINED / SOMETHING_STUCK / BLOCKING_MODE /
+ * LOCK_MODE / NO_TARGET / NOT_ENOUGH_INGREDIENTS / SAME_NETWORK / UNSUPPORTED_STACK
+ */
+exports.AE_CPU_SCHEDULED_REASONS = [
+    "UNDEFINED",
+    "SOMETHING_STUCK",
+    "BLOCKING_MODE",
+    "LOCK_MODE",
+    "NO_TARGET",
+    "NOT_ENOUGH_INGREDIENTS",
+    "SAME_NETWORK",
+    "UNSUPPORTED_STACK",
+];
+exports.AECPUScheduledReasonSchema = joi_1.default.string()
+    .valid(...exports.AE_CPU_SCHEDULED_REASONS)
+    .required();
+exports.AECPUTaskSchema = joi_1.default.object({
+    remaining: joi_1.default.number().required(),
+    scheduledReason: exports.AECPUScheduledReasonSchema,
+    inputs: joi_1.default.array().items(exports.AEStackSchema).required(),
+    pattern: exports.AE2PatternSchema.required(),
+    outputs: joi_1.default.array().items(exports.AEStackWithProvidersSchema).required(),
+});
+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(),
+    waiting: joi_1.default.boolean().required(),
+    suspended: joi_1.default.boolean().required(),
+    missingMode: joi_1.default.boolean().required(),
+    finalOutput: exports.AEStackSchema.optional(),
+    waitingForMissing: joi_1.default.array().items(exports.AEStackSchema).optional(),
+    tasks: joi_1.default.array().items(exports.AECPUTaskSchema).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>;

package/dist/validators/block.js

@@ -0,0 +1,91 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BatchSetBlockJobResultSchema = exports.BatchSetBlockFailureSchema = exports.BatchSetBlockJobStatusSchema = exports.BatchSetBlockSubmitResultSchema = exports.BatchSetBlockTaskSchema = exports.SetBlockResultSchema = exports.SetBlockBodySchema = exports.BlockDetailSchema = exports.BlockSchema = exports.MaterialSchema = void 0;
+const joi_1 = __importDefault(require("joi"));
+const common_1 = require("./common");
+const item_1 = require("./item");
+exports.MaterialSchema = joi_1.default.object({
+    isLiquid: joi_1.default.boolean().required(),
+    isSolid: joi_1.default.boolean().required(),
+    blocksMovement: joi_1.default.boolean().required(),
+    isOpaque: joi_1.default.boolean().required(),
+    isFlammable: joi_1.default.boolean().required(),
+    isReplaceable: joi_1.default.boolean().required(),
+    requiresNoTool: joi_1.default.boolean().required(),
+    mobilityFlag: joi_1.default.number().required(),
+    isAdventureModeExempt: joi_1.default.boolean().required(),
+});
+exports.BlockSchema = joi_1.default.object({
+    class: common_1.ClassInfoSchema.optional(),
+    id: joi_1.default.number().required(),
+    registryName: joi_1.default.string().required(),
+    unlocalizedName: joi_1.default.string().required(),
+    localizedName: joi_1.default.string().required(),
+    resistance: joi_1.default.alternatives(joi_1.default.number().unsafe(), joi_1.default.valid("Infinity")).required(),
+    lightLevel: joi_1.default.number().required(),
+    isOpaqueCube: joi_1.default.boolean().required(),
+    isNormalCube: joi_1.default.boolean().required(),
+    slipperiness: joi_1.default.number().required(),
+    renderType: joi_1.default.number().required(),
+    material: exports.MaterialSchema.required(),
+    meta: joi_1.default.number().optional(),
+    fileName: joi_1.default.string().optional(),
+    blockColor: joi_1.default.number().optional(),
+});
+exports.BlockDetailSchema = joi_1.default.object({
+    block: exports.BlockSchema.append({
+        hardness: joi_1.default.number().required(),
+        isReplaceable: joi_1.default.boolean().required(),
+        isPassable: joi_1.default.boolean().required(),
+    }).required(),
+    coordinates: common_1.CoordinatesSchema.required(),
+    metadata: joi_1.default.number().required(),
+    isAir: joi_1.default.boolean().required(),
+    tileEntity: joi_1.default.object({
+        class: common_1.ClassInfoSchema.optional(),
+        inventorySize: joi_1.default.number().optional(),
+        items: joi_1.default.array().items(item_1.ItemStackSchema.append({ slot: joi_1.default.number().required() })).optional(),
+    }).unknown().optional(),
+});
+exports.SetBlockBodySchema = joi_1.default.object({
+    id: joi_1.default.number().required(),
+    metadataIn: joi_1.default.number().optional(),
+    flag: joi_1.default.number().optional(),
+});
+exports.SetBlockResultSchema = joi_1.default.valid(null);
+exports.BatchSetBlockTaskSchema = joi_1.default.object({
+    x: joi_1.default.number().required(),
+    y: joi_1.default.number().required(),
+    z: joi_1.default.number().required(),
+    dim: joi_1.default.number().optional(),
+    id: joi_1.default.number().required(),
+    metadata: joi_1.default.number().optional(),
+    flag: joi_1.default.number().optional(),
+});
+exports.BatchSetBlockSubmitResultSchema = joi_1.default.object({
+    id: joi_1.default.string().required(),
+    total: joi_1.default.number().required(),
+});
+exports.BatchSetBlockJobStatusSchema = joi_1.default.valid("pending", "running", "completed");
+exports.BatchSetBlockFailureSchema = joi_1.default.object({
+    x: joi_1.default.number().required(),
+    y: joi_1.default.number().required(),
+    z: joi_1.default.number().required(),
+    reason: joi_1.default.string().required(),
+});
+exports.BatchSetBlockJobResultSchema = joi_1.default.object({
+    id: joi_1.default.string().required(),
+    total: joi_1.default.number().required(),
+    completed: joi_1.default.number().required(),
+    success: joi_1.default.number().required(),
+    failed: joi_1.default.number().required(),
+    status: exports.BatchSetBlockJobStatusSchema.required(),
+    createTime: joi_1.default.number().required(),
+    finishTime: joi_1.default.number().optional(),
+    durationMs: joi_1.default.number().optional(),
+    failures: joi_1.default.array().items(exports.BatchSetBlockFailureSchema).optional(),
+    failuresTruncated: joi_1.default.number().optional(),
+});

package/dist/validators/chunk.d.ts

@@ -0,0 +1,9 @@
+import Joi from "joi";
+import type { ChunkForceList, ChunkLoadResult, ChunkMapCell, ChunksByDimension, ChunkWithDimension } from "../types/chunk";
+export declare const ChunkSchema: Joi.ObjectSchema<any>;
+export declare const ChunkWithDimensionSchema: Joi.ObjectSchema<ChunkWithDimension>;
+export declare const ChunksByDimensionSchema: Joi.ObjectSchema<ChunksByDimension>;
+export declare const ChunkLoadInfoSchema: Joi.ObjectSchema<any>;
+export declare const ChunkForceListSchema: Joi.ObjectSchema<ChunkForceList>;
+export declare const ChunkLoadResultSchema: Joi.ObjectSchema<ChunkLoadResult>;
+export declare const ChunkMapCellSchema: Joi.ObjectSchema<ChunkMapCell>;

package/dist/validators/chunk.js

@@ -0,0 +1,64 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChunkMapCellSchema = exports.ChunkLoadResultSchema = exports.ChunkForceListSchema = exports.ChunkLoadInfoSchema = exports.ChunksByDimensionSchema = exports.ChunkWithDimensionSchema = exports.ChunkSchema = void 0;
+const joi_1 = __importDefault(require("joi"));
+const common_1 = require("./common");
+const entity_1 = require("./entity");
+exports.ChunkSchema = joi_1.default.object({
+    class: common_1.ClassInfoSchema.optional(),
+    chunkX: joi_1.default.number().required(),
+    chunkZ: joi_1.default.number().required(),
+    xStart: joi_1.default.number().required(),
+    zStart: joi_1.default.number().required(),
+    xEnd: joi_1.default.number().required(),
+    zEnd: joi_1.default.number().required(),
+    lastSaveTime: joi_1.default.number().required(),
+    isTerrainPopulated: joi_1.default.boolean().required(),
+    isLightPopulated: joi_1.default.boolean().required(),
+    isModified: joi_1.default.boolean().required(),
+    hasEntities: joi_1.default.boolean().required(),
+    isChunkLoaded: joi_1.default.boolean().required(),
+    sendUpdates: joi_1.default.boolean().required(),
+    tileEntityCount: joi_1.default.number().required(),
+    entityCount: joi_1.default.number().optional(),
+    entityList: joi_1.default.array().items(joi_1.default.array().items(entity_1.EntitySchema)).optional(),
+    inhabitedTime: joi_1.default.number().required(),
+});
+exports.ChunkWithDimensionSchema = exports.ChunkSchema.append({
+    dimension: joi_1.default.number().required(),
+});
+exports.ChunksByDimensionSchema = joi_1.default.object({
+    name: joi_1.default.string().required(),
+    class: common_1.ClassInfoSchema.optional(),
+    chunks: joi_1.default.array().items(exports.ChunkSchema).required(),
+    count: joi_1.default.number().required(),
+});
+exports.ChunkLoadInfoSchema = joi_1.default.object({
+    ticketKey: joi_1.default.string().required(),
+    chunkX: joi_1.default.number().required(),
+    chunkZ: joi_1.default.number().required(),
+    minX: joi_1.default.number().required(),
+    maxX: joi_1.default.number().required(),
+    minZ: joi_1.default.number().required(),
+    maxZ: joi_1.default.number().required(),
+    dimension: joi_1.default.number().required(),
+    startTime: joi_1.default.number().required(),
+    durationSec: joi_1.default.number().required(),
+    remainingSec: joi_1.default.number().required(),
+    isActive: joi_1.default.boolean().required(),
+});
+exports.ChunkForceListSchema = joi_1.default.object({
+    totalLoaded: joi_1.default.number().required(),
+    chunks: joi_1.default.array().items(exports.ChunkLoadInfoSchema).required(),
+});
+exports.ChunkLoadResultSchema = exports.ChunkLoadInfoSchema.append({
+    action: joi_1.default.valid("load", "unload").required(),
+});
+exports.ChunkMapCellSchema = joi_1.default.object({
+    name: joi_1.default.string().required(),
+    meta: joi_1.default.number().required(),
+    y: joi_1.default.number().required(),
+});

package/dist/validators/common.d.ts

@@ -0,0 +1,8 @@
+import Joi from "joi";
+import type { RootInfo } from "../types/common";
+export declare const ClassInfoSchema: Joi.ObjectSchema<any>;
+export declare const CoordinatesSchema: Joi.ObjectSchema<any>;
+export declare const ApiSuccessResponseSchema: <T>(dataSchema: Joi.Schema<T>) => Joi.ObjectSchema<any>;
+export declare const ApiErrorResponseSchema: Joi.ObjectSchema<any>;
+export declare const ApiResponseSchema: <T>(dataSchema: Joi.Schema<T>) => Joi.AlternativesSchema<any>;
+export declare const RootInfoSchema: Joi.ObjectSchema<RootInfo>;