@vaitosoi/minejs 0.2.2 → 0.4.0

package/dist/{base → world}/entity.d.ts

@@ -1,7 +1,7 @@
-import { TCPClient } from "../client/tcp";
-import { AABB } from "./aabb";
+import { AABB } from "../physics/aabb";
+import { SharedState } from "./state";
 export declare class EntitiesManager {
-    private tcp;
+    private state;
     /**
      * Split chunks into 16x16x16 sections, so each chunk sections will contain a set of entities
      *
@@ -12,7 +12,7 @@ export declare class EntitiesManager {
      * A map mapping entity ID to section key.
      */
     entityToSection: Map<number, string>;
-    constructor(tcp: TCPClient);
+    constructor(state: SharedState);
     /**
      * Clear data
      */

package/dist/world/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/world/entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,qBAAa,eAAe;IAYZ,OAAO,CAAC,KAAK;IAXzB;;;;OAIG;IACI,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAa;IACtD;;OAEG;IACI,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAExD,YAAoB,KAAK,EAAE,WAAW,EAAK;IAE3C;;OAEG;IACI,IAAI,SAGV;IAED;;OAEG;IACH,OAAc,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,UAI1D;IAED;;OAEG;IACI,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,QAK3D;IAED;;OAEG;IACI,MAAM,CAAC,QAAQ,EAAE,MAAM,QAM7B;IAED;;OAEG;IACI,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,QAM9D;IAED;;;;OAIG;IACI,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,GAAE,MAAM,EAAO,UAyBrD;CACJ"}

package/dist/{base → world}/entity.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EntitiesManager = void 0;
-const aabb_1 = require("./aabb");
+const aabb_1 = require("../physics/aabb");
 class EntitiesManager {
-    tcp;
+    state;
     /**
      * Split chunks into 16x16x16 sections, so each chunk sections will contain a set of entities
      *
@@ -14,8 +14,8 @@ class EntitiesManager {
      * A map mapping entity ID to section key.
      */
     entityToSection = new Map();
-    constructor(tcp) {
-        this.tcp = tcp;
+    constructor(state) {
+        this.state = state;
     }
     /**
      * Clear data
@@ -68,7 +68,7 @@ class EntitiesManager {
      * @returns
      */
     queryAABB(queryBB, exclude = []) {
-        this.tcp.checkReady();
+        this.state.checkReady();
         const { minX, minY, minZ, maxX, maxY, maxZ } = queryBB;
         const results = [];
         const sx0 = minX >> 4, sx1 = maxX >> 4;
@@ -82,7 +82,7 @@ class EntitiesManager {
                         for (const id of bucket) {
                             if (exclude.includes(id))
                                 continue;
-                            const entity = this.tcp.world.entities[id];
+                            const entity = this.state.world.entities[id];
                             const entityBB = aabb_1.AABB.fromEntityType(entity.type);
                             if (queryBB.isIntersect(entityBB))
                                 results.push(entityBB);

package/dist/world/entity.js.map

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

package/dist/world/state.d.ts

@@ -0,0 +1,175 @@
+import { Cipheriv, Decipheriv } from "node:crypto";
+import { If } from "../base/typing";
+import { Angle, BaseVec3 } from "../physics/direction";
+import { ClientEvents, ClientOption } from "../client/client";
+import { AuthClient } from "../client/auth";
+import { MessageLink } from "../message/link";
+import { SignatureCache } from "../message/sigCache";
+export interface Server {
+    knownPacks?: ServerKnownPack;
+}
+export interface ServerKnownPack {
+    namespace: string;
+    id: string;
+    version: string;
+}
+/**
+ * Represent world information
+ */
+export interface ServerWorld {
+    /** Is hardcore enabled */
+    hardcore: boolean;
+    /** All dimensions */
+    dimensions: string[];
+    /** Max players allowed */
+    maxPlayers: number;
+    /** View distances */
+    viewDistance: number;
+    /** Simulation distance */
+    simulationDistance: number;
+    /**
+     * The record key is a chunk section position packed as `Player Dimension:Chunk X:Chunk Z[Section Y]`
+     *
+     * For `Section Y`, a chunk is splitted into several cubic 16x16x16 sections, or in other word, a chunk is a bund of 16x16x16 sections stacked on each other.
+     */
+    chunks: Record<string, ChunkColumn>;
+    /**
+     * The record key is entity ID
+     */
+    entities: Record<number, Entity>;
+}
+/**
+ * Represent a chunk collumns, which may contains multiple chunks sections
+ */
+export interface ChunkColumn {
+    sections: Record<number, ChunkSection>;
+    blockEntities: Record<number, BlockEntity>;
+}
+export interface ChunkSection {
+    block: PaletteContainer;
+    biome: PaletteContainer;
+}
+/**
+ * Used for indirect mapping
+ *
+ * @see https://minecraft.wiki/w/Java_Edition_protocol/Chunk_format#Paletted_Container_structure
+ */
+export interface PaletteContainer {
+    bpe: number;
+    palette: number[];
+    data: BigInt64Array | null;
+}
+/** Represent a block entity */
+export interface BlockEntity {
+    type: number;
+    data: Record<string, any>;
+}
+/** Represent an entity */
+export interface Entity {
+    id: number;
+    type: number;
+    position: BaseVec3;
+    velocity: BaseVec3;
+    angle: Angle;
+    data: number;
+}
+export declare enum GameMode {
+    Survival = 0,
+    Creative = 1,
+    Adventure = 2,
+    Spectator = 3
+}
+export interface ClientPlayer {
+    /** Player UUID */
+    uuid: string;
+    /** Player username */
+    username: string;
+    /** Player entity ID */
+    entityId: number;
+    /** Current game mode */
+    gameMode: GameMode;
+    position: BaseVec3;
+    velocity: BaseVec3;
+    angle: Angle;
+    /** Current dimension */
+    dimension: string;
+}
+export declare enum ClientStatus {
+    Disconnected = 0,
+    Connecting = 1,
+    Logining = 2,
+    Ready = 3
+}
+export declare enum ConnectionState {
+    Disconnected = 0,
+    Handshake = 1,
+    Login = 2,
+    Configure = 3,
+    Play = 4
+}
+export interface ServerRegistryEntry {
+    id: string;
+    data: object;
+}
+export type MutateState = (state: SharedState) => void;
+export type EmittedEvent = {
+    [K in keyof ClientEvents]: {
+        event: K;
+        args: ClientEvents[K];
+    };
+}[keyof ClientEvents];
+export type SendingPacket = {
+    id: string | number;
+    data: Record<string, any>;
+};
+export declare class SharedState<IsReady extends boolean = boolean> {
+    clientOptions: ClientOption;
+    private mutationQueue;
+    private eventQueue;
+    private sendQueue;
+    state: ConnectionState;
+    status: ClientStatus;
+    compressionThreshold: number;
+    authClient: AuthClient | undefined;
+    playerUUID: string | undefined;
+    publicKey: Buffer | undefined;
+    signature: Buffer | undefined;
+    signatureExpireTime: number | undefined;
+    private signatureTimeoutInstance;
+    sharedSecret: Buffer | undefined;
+    cipher: Cipheriv | undefined;
+    decipher: Decipheriv | undefined;
+    useEncryption: boolean;
+    sessionID: Buffer | undefined;
+    server: Server | undefined;
+    registry: Record<string, ServerRegistryEntry[]> | undefined;
+    world: If<IsReady, ServerWorld>;
+    player: If<IsReady, ClientPlayer>;
+    /**
+     * For maintaining message order.
+     *
+     * A UUID map to a MessageLink.
+     */
+    messageLinks: Record<string, MessageLink> | undefined;
+    messageSignatureCache: SignatureCache | undefined;
+    constructor(clientOptions: ClientOption);
+    isReady(): this is SharedState<true>;
+    checkReady(): void;
+    pruneStates(): void;
+    getSignature(): {
+        publicKey: Buffer<ArrayBufferLike>;
+        signature: Buffer<ArrayBufferLike>;
+    };
+    private fetchSignature;
+    startSignatureLoop(): Promise<void>;
+    stopSignatureLoop(): void;
+    enqueueMutation(mutation: MutateState): void;
+    enqueuePacket(packet: string, data: object): void;
+    enqueuePacket(packet: SendingPacket): void;
+    enqueueEvent<K extends keyof ClientEvents>(event: K, ...args: ClientEvents[K]): void;
+    enqueueEvent(event: EmittedEvent): void;
+    drainMutation(): void;
+    drainEvent(): EmittedEvent[];
+    drainPacket(): SendingPacket[];
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/world/state.d.ts.map

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

package/dist/world/state.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SharedState = exports.ConnectionState = exports.ClientStatus = exports.GameMode = void 0;
+const error_1 = require("../base/error");
+const sigCache_1 = require("../message/sigCache");
+var GameMode;
+(function (GameMode) {
+    GameMode[GameMode["Survival"] = 0] = "Survival";
+    GameMode[GameMode["Creative"] = 1] = "Creative";
+    GameMode[GameMode["Adventure"] = 2] = "Adventure";
+    GameMode[GameMode["Spectator"] = 3] = "Spectator";
+})(GameMode || (exports.GameMode = GameMode = {}));
+var ClientStatus;
+(function (ClientStatus) {
+    ClientStatus[ClientStatus["Disconnected"] = 0] = "Disconnected";
+    ClientStatus[ClientStatus["Connecting"] = 1] = "Connecting";
+    ClientStatus[ClientStatus["Logining"] = 2] = "Logining";
+    ClientStatus[ClientStatus["Ready"] = 3] = "Ready";
+})(ClientStatus || (exports.ClientStatus = ClientStatus = {}));
+var ConnectionState;
+(function (ConnectionState) {
+    ConnectionState[ConnectionState["Disconnected"] = 0] = "Disconnected";
+    ConnectionState[ConnectionState["Handshake"] = 1] = "Handshake";
+    ConnectionState[ConnectionState["Login"] = 2] = "Login";
+    ConnectionState[ConnectionState["Configure"] = 3] = "Configure";
+    ConnectionState[ConnectionState["Play"] = 4] = "Play";
+})(ConnectionState || (exports.ConnectionState = ConnectionState = {}));
+class SharedState {
+    clientOptions;
+    mutationQueue = [];
+    eventQueue = [];
+    sendQueue = [];
+    state = ConnectionState.Disconnected;
+    status = ClientStatus.Disconnected;
+    compressionThreshold = 0;
+    // Auth stuffs
+    authClient = undefined;
+    playerUUID = undefined;
+    publicKey = undefined;
+    signature = undefined;
+    signatureExpireTime = undefined;
+    // eslint-disable-next-line no-undef
+    signatureTimeoutInstance = undefined;
+    sharedSecret = undefined;
+    cipher = undefined;
+    decipher = undefined;
+    useEncryption = false;
+    sessionID = undefined;
+    server = undefined;
+    registry = undefined;
+    world = null;
+    player = null;
+    /**
+     * For maintaining message order.
+     *
+     * A UUID map to a MessageLink.
+     */
+    messageLinks = undefined;
+    messageSignatureCache = undefined;
+    constructor(clientOptions) {
+        this.clientOptions = clientOptions;
+    }
+    isReady() {
+        return this.status === ClientStatus.Ready;
+    }
+    checkReady() {
+        if (!this.isReady())
+            throw new error_1.ClientNotReady();
+    }
+    pruneStates() {
+        this.mutationQueue = [];
+        this.eventQueue = [];
+        this.sendQueue = [];
+        this.state = ConnectionState.Disconnected;
+        this.status = ClientStatus.Disconnected;
+        this.compressionThreshold = 0;
+        this.authClient = undefined;
+        this.playerUUID = undefined;
+        this.publicKey = undefined;
+        this.signature = undefined;
+        this.sharedSecret = undefined;
+        this.cipher = undefined;
+        this.decipher = undefined;
+        this.useEncryption = false;
+        this.sessionID = undefined;
+        this.signatureTimeoutInstance = undefined;
+        this.server = undefined;
+        this.registry = undefined;
+        this.world = undefined;
+        this.player = undefined;
+        if (this.clientOptions.shouldVerifyMessageSignature)
+            this.messageSignatureCache = sigCache_1.SignatureCache.default();
+        else
+            this.messageSignatureCache = undefined;
+        if (this.clientOptions.shouldVerifyMessageOrder)
+            this.messageLinks = {};
+        else
+            this.messageLinks = undefined;
+    }
+    getSignature() {
+        if (this.publicKey && this.signature)
+            return {
+                publicKey: this.publicKey,
+                signature: this.signature
+            };
+        throw new error_1.AuthRelatedNotFound("public key and signature");
+    }
+    async fetchSignature() {
+        if (!this.authClient)
+            throw new error_1.AuthRelatedNotFound("instance of class AuthClient");
+        const { publicKey, signature, expiresAt } = await this.authClient.getKeyPair();
+        this.publicKey = Buffer.from(publicKey);
+        this.signature = Buffer.from(signature);
+        return expiresAt;
+    }
+    async startSignatureLoop() {
+        const expiresAt = await this.fetchSignature();
+        this.signatureTimeoutInstance = setTimeout(async () => await this.startSignatureLoop(), expiresAt - Date.now() - 10_000);
+    }
+    stopSignatureLoop() {
+        clearTimeout(this.signatureTimeoutInstance);
+    }
+    enqueueMutation(mutation) { this.mutationQueue.push(mutation); }
+    enqueuePacket(packet, data) {
+        if (typeof packet === "string")
+            this.sendQueue.push({
+                id: packet,
+                data: data
+            });
+        else
+            this.sendQueue.push(packet);
+    }
+    enqueueEvent(event, ...args) {
+        if (typeof event === "string")
+            this.eventQueue.push({
+                event,
+                args: args
+            });
+        else
+            this.eventQueue.push(event);
+    }
+    drainMutation() {
+        while (true) {
+            const mutation = this.mutationQueue.shift();
+            if (mutation)
+                mutation(this);
+            else
+                break;
+        }
+    }
+    drainEvent() {
+        const events = structuredClone(this.eventQueue);
+        this.eventQueue = [];
+        return events;
+    }
+    drainPacket() {
+        const packets = structuredClone(this.sendQueue);
+        this.sendQueue = [];
+        return packets;
+    }
+}
+exports.SharedState = SharedState;
+//# sourceMappingURL=state.js.map

package/dist/world/state.js.map

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

package/dist/world/tick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tick.d.ts","sourceRoot":"","sources":["../../src/world/tick.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,QAAQ;IAUb,OAAO,CAAC,MAAM;IATlB,gBAAuB,OAAO,MAAM;IACpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAqC;IACpE,gBAAuB,iBAAiB,MAAM;IAE9C,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,KAAK,CAAa;IAE1B,YACY,MAAM,EAAE,MAAM,GAAG,EAI5B;IAEM,KAAK,SAIX;IAEM,IAAI,SAIV;IAED,OAAO,CAAC,IAAI;CAiBf"}

package/dist/world/tick.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tick.js","sourceRoot":"","sources":["../../src/world/tick.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH;IAUgB,MAAM;IATX,MAAM,CAAU,OAAO,GAAG,EAAE,CAAC;IAC5B,MAAM,CAAU,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,QAAU,CAAC;IAC7D,MAAM,CAAU,iBAAiB,GAAG,EAAE,CAAC;IAEtC,OAAO,CAAU;IACjB,YAAY,CAAS;IACrB,KAAK,GAAQ,IAAI,CAAC;IAE1B,YACY,MAAiB;sBAAjB,MAAM;QAEd,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;IAChB,CAAC;IAEM,IAAI;QACP,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAEO,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAE/B,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC,YAAY,GAAG,GAAG,IAAI,QAAQ,GAAG,QAAQ,CAAC,iBAAiB,EAAE,CAAC;YACtE,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,IAAI,CAAC,YAAY,IAAI,QAAQ,CAAC,OAAO,CAAC;YACtC,QAAQ,EAAE,CAAC;QACf,CAAC;QAED,IAAI,QAAQ,IAAI,QAAQ,CAAC,iBAAiB;YACtC,IAAI,CAAC,YAAY,GAAG,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC;QAE/C,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;QAClF,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACrE,CAAC;CACJ"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@vaitosoi/minejs",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "A Minecraft client package",
   "license": "MIT",
   "repository": {
     "url": "git+https://github.com/VaitoSoi/minejs"
   },
+  "homepage": "https://minejs.vaito.dev/",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -23,6 +24,9 @@
   "engines": {
     "node": ">=22"
   },
+  "scripts": {
+    "prepare": "eslint . --fix && tsc --noEmit"
+  },
   "devDependencies": {
     "@clean-jsdoc-theme/typedoc": "5.0.5",
     "@eslint/js": "^10.0.1",
@@ -38,7 +42,8 @@
     "typescript-eslint": "^8.60.1"
   },
   "dependencies": {
-    "bitset": "^5.2.3"
+    "bitset": "^5.2.3",
+    "zod": "^4.4.3"
   },
   "packageManager": "pnpm@11.15.1+sha512.81350b07e53c9538a02f1f2303b4290fa2d7be04e56e2a970c4cc4b417dc761de196edabd49d55c7dc9580db81007c44143e4e3d7e462b3000d23c255122d065"
 }

package/src/base/buffer.ts

@@ -0,0 +1,12 @@
+export function sliceBuffer<T = Buffer>(
+    buf: Buffer, 
+    byteLength: number, 
+    transform?: (buf: Buffer, ind: number) => T
+): T[] {
+    const chunks: Buffer[] = [];
+    for (let i = 0; i < buf.length; i += byteLength)
+        chunks.push(buf.subarray(i, i + byteLength));
+    if (transform)
+        return chunks.map(transform);
+    return chunks as T[];
+}

package/src/base/error.ts

@@ -1,3 +1,10 @@
+/** @hidden */
+export class ClientNotReady extends Error {
+    constructor() {
+        super(`client is not ready`);
+    }
+}
+
 /** @hidden */
 export class UnexpectedValue extends Error {
     constructor(
@@ -33,6 +40,10 @@ export class InvalidValue extends Error {
     }
 }
 
+/*
+ * TCP connection
+ */
+
 /** @hidden */
 export class SockerIsNotWritable extends Error {
     constructor() {
@@ -40,6 +51,10 @@ export class SockerIsNotWritable extends Error {
     }
 }
 
+/*
+ * Authenticating... 
+ */
+
 /** @hidden */
 export class CantGetMsAuthToken extends Error {
     constructor() {
@@ -55,12 +70,19 @@ export class CantGetMsAccessToken extends Error {
 }
 
 /** @hidden */
-export class AuthError extends Error {
-    constructor(public error: string) {
+export class OAuthError extends Error {
+    constructor(public error: string, public detail?: any) {
         super(`got oauth error: ${error}, for more info: https://datatracker.ietf.org/doc/html/rfc6749#section-5.2`);
     }
 }
 
+/** @hidden */
+export class AuthClientError extends Error {
+    constructor(public error: string, public detail?: any) {
+        super(error, detail);
+    }
+}
+
 /** @hidden */
 export class XboxError extends Error {
     constructor(public code: string) {
@@ -68,6 +90,12 @@ export class XboxError extends Error {
     }
 }
 
+/** @hidden */
+export class MinecraftError extends Error {
+    constructor(public error: string) {
+        super(`minecraft auth error: ${error}`);
+    }
+}
 /** @hidden */
 export class ProfileNotFound extends Error {
     constructor() {
@@ -103,16 +131,77 @@ export class MissingAuthOption extends Error {
     }
 }
 
+export class AuthRelatedNotFound extends Error {
+    constructor(public component: string) {
+        super(`auth option is enabled, but the auth related component (${component}) is not found`);
+    }
+}
+
+/*
+ * Packets
+ */
+
 /** @hidden */
 export class RegistryItemNotFound extends Error {
     constructor(public item: string) {
         super(`cant find registry item: ${item}`);
     }
 }
+/** @hidden */
+export class VersionNotSupport extends Error {
+    constructor(public version: string) {
+        super(`version ${version} is not supported`);
+    }
+}
 
 /** @hidden */
-export class ClientNotReady extends Error {
+export class CantReadFile extends Error {
+    constructor(public path: string) {
+        super(`can't read file at "${path}"`);
+    }
+}
+
+/** @hidden */
+export class InvalidPacketStructure extends Error {
+    constructor(public path: string, public zodIssue?: any[]) {
+        super(`packet structure in file "${path}" is invalid` + (zodIssue?.length ? ", zod issue: " + JSON.stringify(zodIssue, null, 4) : ""));
+    }
+}
+
+
+/** @hidden */
+export class MissingPacketField extends Error {
+    constructor(public packetId: number, public field: string, public need: string) {
+        super(`${packetId}: ${field} need ${need}, but not found`);
+    }
+}
+
+/** @hidden */
+export class MissingField extends Error {
+    constructor(public field: string, public where: string) {
+        super(`missing ${field} in ${where}`);
+    }
+}
+
+/** @hidden */
+export class NotImplemented extends Error {
     constructor() {
-        super(`client is not ready`);
+        super("if you are dev, please create an issue on github. if you are vaito, hey, this function is not injected >:(");
+    }
+}
+
+/*
+ * Messages
+ */
+
+export class MessageLinkNotFound extends Error {
+    constructor(public senderUUID: string) {
+        super(`message link of sender ${senderUUID} not found, maybe because server has sent out of order packet`);
+    }
+}
+
+export class HaveSignatureButNotIndex extends Error {
+    constructor() {
+        super (`expecting both shouldVerifyMessageOrder set to true when shouldVerifyMessageSignature set to true`);
     }
 }

package/src/base/http.ts

@@ -0,0 +1,10 @@
+import { AuthClientError } from "./error";
+
+export async function getJson(res: Response, source: string) {
+    const data = await res.text();
+    try {
+        return JSON.parse(data);
+    } catch (e) {
+        throw new AuthClientError(`cant parse json from ${source}`, data);
+    }
+}