@starktma/minecraft-utils 1.2.1 → 1.2.3

package/README.md

@@ -1,77 +1,26 @@
-# Database Management in Minecraft: TypeScript Edition
+# @starktma/minecraft-utils — utilities for Minecraft scripting
 
-PropertyDatabase is a TypeScript-based database management system designed for use within Minecraft. The system consists of two main classes: `DatabaseManager` and `SimpleDatabase`, which handle JSON database operations in the Minecraft world.
+This package provides a small collection of TypeScript utilities. The code is split into focused modules; this README gives a short summary and points to the source files for details.
 
-## Features
+## Quick summary
 
-- **Entity & World Targeting**: Ability to target either an entity or the Minecraft world for storing data.
-- **JSON Database Operations**: Supports basic CRUD (Create, Read, Update, Delete) operations for JSON databases.
-- **Custom Object Management**: Facilitates storing and managing custom objects with unique IDs.
+- **database** — lightweight JSON storage helpers for Minecraft's dynamic properties. Implements a `DatabaseManager` (low-level serialization/partitioning) and `SimpleDatabase` (convenience base class for storing objects by id). See `src/database` for full details and examples.
+- **math** — common math utilities used across the packages. See `src/math`.
+- **minecraft** — helpers for Minecraft-specific operations and types. See `src/minecraft`.
+- **player-event** — convenience helpers to handle player-related events and payloads. See `src/player-event`.
 
-## Installation
+## Short database note
 
-1. Ensure you have the Minecraft server set up with the appropriate scripting API support.
-2. Install the PropertyDatabase module `@starktma/minecraft-utils` using your preferred method (e.g., npm, yarn).
-3. Place the PropertyDatabase module in your server's script directory or in the assets/javascript directory if you're using Anvil.
+The database utilities are intentionally small: `DatabaseManager` handles serializing/partitioning JSON so it can be stored within Minecraft dynamic property limits, and `SimpleDatabase` provides a straightforward API for storing objects keyed by `id`. For full API and examples, open `src/database`.
 
-## Usage
+## Installation & quick dev
 
-### DatabaseManager Class
+- **To use the published package**: `npm install @starktma/minecraft-utils` (if published to npm or a registry).
 
-Handles JSON databases in Minecraft's world properties. Can target an entity or the world itself.
+## Where to look next
 
-#### Methods:
-
-- `hasJSONDatabase(databaseName: string)`: Checks if a database exists.
-- `addJSONDatabase(databaseName: string, database: object)`: Adds a new database.
-- `removeJSONDatabase(databaseName: string)`: Removes a database.
-- `getJSONDatabase(databaseName: string)`: Retrieves a database.
-
-### SimpleDatabase Class
-
-A base class for managing databases of custom objects.
-
-#### Methods:
-
-- `addObject(object: SimpleObject)`: Adds a new object to the database.
-- `updateObject(object: SimpleObject)`: Updates an existing object.
-- `hasObject(id: string)`: Checks if an object exists.
-- `getObject(id: string)`: Retrieves an object by ID.
-- `removeObject(id: string)`: Removes an object.
-- `getAllObjects()`: Retrieves all objects.
-- `eraseAllObjects()`: Clears the database.
-- `forEach(callback: Function)`: Iterates over objects.
-
-### SimpleObject Interface
-
-A basic interface for objects managed by `SimpleDatabase`. Must include an `id` property.
-
-## NOTE
-
-The `DatabaseManager` class is designed to handle JSON databases in Minecraft's world properties and cannot be used directly. Its main job is to convert your database to string formats that can be stored on dynamic properties and back.
-
-The `DatabaseManager` class is responsible for deconstructing and reconstructing the database from JSON strings to work around the dynamic property size limits in Minecraft [`32767`].
-
-The `SimpleDatabase` class uses the `DatabaseManager` to manage custom objects. It provides methods to add, update, retrieve, and remove objects, as well as to iterate over all objects in the database.
-
-The `SimpleDatabase` is intended to be inherited by custom object classes. It requires an `id` property to uniquely identify each object and can be extended with additional properties as needed.
-
-The `SimpleObject` interface defines the structure of objects that can be managed by `SimpleDatabase`. It includes an `id` property, which is essential for identifying objects within the database, and can be extended with additional properties to structure your own database objects.
-
-## Examples
-
-### Creating a Custom Database
-
-```typescript
-class MyDatabase extends SimpleDatabase {
-	constructor() {
-		super("my_database");
-	}
-
-	addObject(object: MyObject) {
-		super.addObject(object);
-	}
-
-	// Additional custom methods...
-}
-```
+- See the module source for exact types, exported functions, and examples:
+  - `src/database` — database manager, simple database base class, and interfaces
+  - `src/math` — math helpers
+  - `src/minecraft` — Minecraft helpers
+  - `src/player-event` — player event helpers

package/dist/database/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const NAMESPACE = "inventory-manager";
+//# sourceMappingURL=constants.d.ts.map

package/dist/database/constants.js

@@ -0,0 +1,2 @@
+export const NAMESPACE = 'inventory-manager';
+//# sourceMappingURL=constants.js.map

package/dist/database/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/database/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG,mBAAmB,CAAC"}

package/dist/database/database.d.ts

@@ -0,0 +1,87 @@
+import { Entity } from "@minecraft/server";
+import { SimpleObject } from "./interfaces";
+/**
+ * SimpleDatabase is a base class for databases that store custom objects with an id property.
+ * It provides methods for adding, updating, removing and retrieving objects from the database.
+ * A singleton pattern is used to ensure that only one instance of the database exists.
+ *
+ * @example
+ * class MyDatabase extends SimpleDatabase<PlayerObject> {
+ * 	protected static instance: MyDatabase;
+ * 	constructor() {
+ * 		super("myDatabase", undefined);
+ * 	}
+ *
+ * 	static getInstance(): MyDatabase {
+ * 		if (!MyDatabase.instance) {
+ * 			MyDatabase.instance = new MyDatabase();
+ * 		}
+ * 		return MyDatabase.instance;
+ * 	}
+ */
+export declare class SimpleDatabase<T extends SimpleObject> {
+    private mainDB;
+    private localDB;
+    protected databaseName: string;
+    /**
+     * The constructor initializes the local database and syncs it with the main database.
+     * @param databaseName The name of the database.
+     * @param target The target entity to store the database in. If undefined, the database is stored in the world.
+     */
+    protected constructor(databaseName: string, target?: Entity | undefined);
+    /**
+     * Updates the main database with the local database.
+     * This method is called automatically when an object is added, updated or removed.
+     * @private
+     */
+    private updateMainDB;
+    /**
+     * Retrieves the main database.
+     * @private
+     * @returns The main database.
+     */
+    private getMainDB;
+    /**
+     * Adds an object to the local database and updates the main database.
+     * @param object The object to be added.
+     */
+    addObject(object: T): void;
+    /**
+     * Updates an object in the local database and the main database.
+     * If the object does not exist, it is added.
+     * @param object The object to be updated.
+     */
+    updateObject(object: T): void;
+    /**
+     * Checks if an object with the given id exists in the local database.
+     * @param id The id of the object.
+     * @returns True if the object exists, false otherwise.
+     */
+    hasObject(id: string): boolean;
+    /**
+     * Retrieves an object with the given id from the local database.
+     * @param id The id of the object.
+     * @returns The object if it exists, undefined otherwise.
+     */
+    getObject(id: string): T | undefined;
+    /**
+     * Removes an object with the given id from the local database and updates the main database.
+     * @param id The id of the object.
+     */
+    removeObject(id: string): void;
+    /**
+     * Retrieves all objects from the local database.
+     * @returns An array of all objects in the local database.
+     */
+    getAllObjects(): T[];
+    /**
+     * Removes all objects from the local database and updates the main database.
+     */
+    eraseAllObjects(): void;
+    /**
+     * Iterates over all objects in the local database.
+     * @param callback The function to be called for each object.
+     */
+    forEach(callback: (object: SimpleObject, index: number) => void): void;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/database/database.js

@@ -0,0 +1,256 @@
+import { Entity, world } from "@minecraft/server";
+//@ts-ignore
+import { NAMESPACE } from "./constants";
+/**
+ * DatabaseManager is a class that manages databases stored in Minecraft's world properties.
+ * Currently only supports JSON databases.
+ */
+class DatabaseManager {
+    static DYNAMIC_PROP_MAX_LENGTH = 32767;
+    static CHUNK_KEY = "__SPLIT__";
+    target;
+    constructor(target) {
+        if (target instanceof Entity) {
+            this.target = target;
+        }
+        else {
+            this.target = world;
+        }
+    }
+    /**
+     * Checks if a JSON database with the given name exists.
+     * @param databaseName The name of the database.
+     * @returns True if the database exists, false otherwise.
+     */
+    hasJSONDatabase(databaseName) {
+        return this.target.getDynamicProperty(NAMESPACE + ":" + databaseName) !== undefined;
+    }
+    /**
+     * Adds a new JSON database with the given name and data.
+     * @param databaseName The name of the database.
+     * @param database The data to be stored in the database.
+     */
+    addJSONDatabase(databaseName, database) {
+        const propertyName = `${NAMESPACE}:${databaseName}`;
+        const jsonString = JSON.stringify(database);
+        const existingProp = this.target.getDynamicProperty(propertyName);
+        let existingChunks = 0;
+        if (existingProp) {
+            try {
+                const propObj = JSON.parse(existingProp);
+                if (propObj && typeof propObj === "object" && DatabaseManager.CHUNK_KEY in propObj) {
+                    existingChunks = propObj[DatabaseManager.CHUNK_KEY];
+                }
+            }
+            catch { }
+        }
+        if (jsonString.length <= DatabaseManager.DYNAMIC_PROP_MAX_LENGTH || jsonString.length === 0) {
+            if (existingChunks > 0) {
+                for (let i = 0; i < existingChunks; i++) {
+                    const partName = `${propertyName}_${i}`;
+                    this.target.setDynamicProperty(partName, undefined);
+                }
+            }
+            this.target.setDynamicProperty(propertyName, jsonString);
+        }
+        else {
+            const chunkSize = DatabaseManager.DYNAMIC_PROP_MAX_LENGTH;
+            const chunkCount = Math.ceil(jsonString.length / chunkSize);
+            if (existingChunks > 0) {
+                for (let i = 0; i < existingChunks; i++) {
+                    const oldPartName = `${propertyName}_${i}`;
+                    this.target.setDynamicProperty(oldPartName, undefined);
+                }
+            }
+            for (let i = 0; i < chunkCount; i++) {
+                const start = i * chunkSize;
+                const end = start + chunkSize;
+                const chunk = jsonString.slice(start, end);
+                const partName = `${propertyName}_${i}`;
+                this.target.setDynamicProperty(partName, chunk);
+            }
+            const meta = { [DatabaseManager.CHUNK_KEY]: chunkCount };
+            this.target.setDynamicProperty(propertyName, JSON.stringify(meta));
+        }
+    }
+    /**
+     * Removes a JSON database with the given name.
+     * @param databaseName The name of the database.
+     */
+    removeJSONDatabase(databaseName) {
+        const propertyName = `${NAMESPACE}:${databaseName}`;
+        const propString = this.target.getDynamicProperty(propertyName);
+        if (propString !== undefined) {
+            try {
+                const propObj = JSON.parse(propString);
+                if (propObj && typeof propObj === "object" && DatabaseManager.CHUNK_KEY in propObj) {
+                    const chunkCount = propObj[DatabaseManager.CHUNK_KEY];
+                    for (let i = 0; i < chunkCount; i++) {
+                        const partName = `${propertyName}_${i}`;
+                        this.target.setDynamicProperty(partName, undefined);
+                    }
+                }
+            }
+            catch { }
+            this.target.setDynamicProperty(propertyName, undefined);
+        }
+    }
+    /**
+     * Retrieves a JSON database with the given name.
+     * @param databaseName The name of the database.
+     * @returns The data stored in the database.
+     * @throws An error if the database does not exist.
+     */
+    getJSONDatabase(databaseName) {
+        const propertyName = `${NAMESPACE}:${databaseName}`;
+        const propString = this.target.getDynamicProperty(propertyName);
+        if (propString === undefined) {
+            throw new Error("Database does not exist");
+        }
+        try {
+            const propObj = JSON.parse(propString);
+            if (propObj && typeof propObj === "object" && DatabaseManager.CHUNK_KEY in propObj) {
+                const chunkCount = propObj[DatabaseManager.CHUNK_KEY];
+                let combined = "";
+                for (let i = 0; i < chunkCount; i++) {
+                    const partName = `${propertyName}_${i}`;
+                    const part = this.target.getDynamicProperty(partName);
+                    if (typeof part === "string") {
+                        combined += part;
+                    }
+                    else {
+                        combined += "";
+                    }
+                }
+                return JSON.parse(combined);
+            }
+            else {
+                return JSON.parse(propString);
+            }
+        }
+        catch {
+            throw new Error("Failed to parse database JSON");
+        }
+    }
+}
+/**
+ * SimpleDatabase is a base class for databases that store custom objects with an id property.
+ * It provides methods for adding, updating, removing and retrieving objects from the database.
+ * A singleton pattern is used to ensure that only one instance of the database exists.
+ *
+ * @example
+ * class MyDatabase extends SimpleDatabase<PlayerObject> {
+ * 	protected static instance: MyDatabase;
+ * 	constructor() {
+ * 		super("myDatabase", undefined);
+ * 	}
+ *
+ * 	static getInstance(): MyDatabase {
+ * 		if (!MyDatabase.instance) {
+ * 			MyDatabase.instance = new MyDatabase();
+ * 		}
+ * 		return MyDatabase.instance;
+ * 	}
+ */
+export class SimpleDatabase {
+    mainDB;
+    localDB;
+    databaseName;
+    /**
+     * The constructor initializes the local database and syncs it with the main database.
+     * @param databaseName The name of the database.
+     * @param target The target entity to store the database in. If undefined, the database is stored in the world.
+     */
+    constructor(databaseName, target) {
+        this.mainDB = new DatabaseManager(target);
+        this.databaseName = databaseName;
+        if (this.mainDB.hasJSONDatabase(this.databaseName)) {
+            this.localDB = this.getMainDB();
+        }
+        else {
+            this.localDB = [];
+            this.updateMainDB();
+        }
+    }
+    /**
+     * Updates the main database with the local database.
+     * This method is called automatically when an object is added, updated or removed.
+     * @private
+     */
+    updateMainDB() {
+        this.mainDB.addJSONDatabase(this.databaseName, this.localDB);
+    }
+    /**
+     * Retrieves the main database.
+     * @private
+     * @returns The main database.
+     */
+    getMainDB() {
+        return this.mainDB.getJSONDatabase(this.databaseName);
+    }
+    /**
+     * Adds an object to the local database and updates the main database.
+     * @param object The object to be added.
+     */
+    addObject(object) {
+        this.localDB.push(object);
+        this.updateMainDB();
+    }
+    /**
+     * Updates an object in the local database and the main database.
+     * If the object does not exist, it is added.
+     * @param object The object to be updated.
+     */
+    updateObject(object) {
+        if (this.hasObject(object.id)) {
+            this.removeObject(object.id);
+        }
+        this.addObject(object);
+    }
+    /**
+     * Checks if an object with the given id exists in the local database.
+     * @param id The id of the object.
+     * @returns True if the object exists, false otherwise.
+     */
+    hasObject(id) {
+        return this.localDB.map((object) => object.id).includes(id);
+    }
+    /**
+     * Retrieves an object with the given id from the local database.
+     * @param id The id of the object.
+     * @returns The object if it exists, undefined otherwise.
+     */
+    getObject(id) {
+        return this.localDB.filter((object) => object.id === id)[0];
+    }
+    /**
+     * Removes an object with the given id from the local database and updates the main database.
+     * @param id The id of the object.
+     */
+    removeObject(id) {
+        this.localDB = this.localDB.filter((object) => object.id !== id);
+        this.updateMainDB();
+    }
+    /**
+     * Retrieves all objects from the local database.
+     * @returns An array of all objects in the local database.
+     */
+    getAllObjects() {
+        return this.localDB;
+    }
+    /**
+     * Removes all objects from the local database and updates the main database.
+     */
+    eraseAllObjects() {
+        this.localDB = [];
+        this.updateMainDB();
+    }
+    /**
+     * Iterates over all objects in the local database.
+     * @param callback The function to be called for each object.
+     */
+    forEach(callback) {
+        this.localDB.forEach((object, index) => callback(object, index));
+    }
+}
+//# sourceMappingURL=database.js.map

package/dist/database/database.js.map

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

package/{src/database/index.ts → dist/database/index.d.ts}

@@ -1,4 +1,4 @@
 import { SimpleDatabase } from "./database";
 import { SimpleObject } from "./interfaces";
-
 export { SimpleDatabase, SimpleObject };
+//# sourceMappingURL=index.d.ts.map

package/dist/database/index.js

@@ -0,0 +1,3 @@
+import { SimpleDatabase } from "./database";
+export { SimpleDatabase };
+//# sourceMappingURL=index.js.map

package/dist/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAAE,cAAc,EAAgB,CAAC"}

package/{src/database/interfaces.ts → dist/database/interfaces.d.ts}

@@ -2,5 +2,6 @@
  * SimpleObject is an interface for objects with an id property.
  */
 export interface SimpleObject {
-	id: string;
+    id: string;
 }
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/database/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/database/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/database/interfaces.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/{src/math/index.ts → dist/math/index.d.ts}

@@ -1,37 +1,25 @@
 import { RGB, RGBA, Vector3 } from "@minecraft/server";
-
 /**
  * Converts an angle in degrees to radians.
  *
  * @param degrees - The angle in degrees to be converted.
  * @returns The angle in radians.
  */
-export function toRadians(degrees: number): number {
-	return degrees * (Math.PI / 180);
-}
-
+export declare function toRadians(degrees: number): number;
 /**
  * Converts an angle in radians to degrees.
  *
  * @param radians - The angle in radians to be converted.
  * @returns The angle in degrees.
  */
-export function calculateDistance(position1: Vector3, position2: Vector3): number {
-	return Math.sqrt(
-		Math.pow(position1.x - position2.x, 2) + Math.pow(position1.y - position2.y, 2) + Math.pow(position1.z - position2.z, 2)
-	);
-}
-
+export declare function calculateDistance(position1: Vector3, position2: Vector3): number;
 /**
  * Converts an angle in radians to degrees.
  *
  * @param radians - The angle in radians to be converted.
  * @returns The angle in degrees.
  */
-export function toDegrees(radians: number): number {
-	return radians * (180 / Math.PI);
-}
-
+export declare function toDegrees(radians: number): number;
 /**
  * Converts a hex color string to an RGBA object.
  *
@@ -39,30 +27,7 @@ export function toDegrees(radians: number): number {
  * @returns An object containing the red, green, blue, and alpha components as numbers between 0 and 1.
  * @throws Error if the hex string is invalid.
  */
-export function hexToRgba(hex: string, stripAlpha: boolean = false): RGB | RGBA {
-	if (!/^#([a-fA-F0-9]{4}|[a-fA-F0-9]{8}|[a-fA-F0-9]{6}|[a-fA-F0-9]{3})$/.test(hex)) {
-		throw new Error("Invalid hex color");
-	}
-
-	let normalized = hex.slice(1);
-	if (normalized.length === 3 || normalized.length === 4) {
-		normalized = normalized
-			.split("")
-			.map((c) => c + c)
-			.join("");
-	}
-
-	const red = parseInt(normalized.substring(0, 2), 16) / 255;
-	const green = parseInt(normalized.substring(2, 4), 16) / 255;
-	const blue = parseInt(normalized.substring(4, 6), 16) / 255;
-	const alpha = (normalized.length === 8 ? parseInt(normalized.substring(6, 8), 16) : 255) / 255;
-
-	if (stripAlpha) {
-		return { red, green, blue };
-	}
-	return { red, green, blue, alpha };
-}
-
+export declare function hexToRgba(hex: string, stripAlpha?: boolean): RGB | RGBA;
 /**
  * Clamps a value between a minimum and maximum range.
  *
@@ -71,31 +36,21 @@ export function hexToRgba(hex: string, stripAlpha: boolean = false): RGB | RGBA
  * @param max - The maximum value of the range.
  * @returns The clamped value, which will be between `min` and `max`.
  */
-export function clamp(value: number, min: number, max: number): number {
-	return Math.max(min, Math.min(max, value));
-}
-
+export declare function clamp(value: number, min: number, max: number): number;
 /**
  * Converts an angle in degrees to its signed equivalent in the range [-180, 180].
  *
  * @param angle - The angle in degrees to be converted.
  * @returns The signed angle in degrees, normalized to the range [-180, 180].
  */
-export function toSigned(angle: number): number {
-	const wrapped = ((angle % 360) + 360) % 360;
-	return wrapped > 180 ? wrapped - 360 : wrapped;
-}
-
+export declare function toSigned(angle: number): number;
 /**
  * Converts an angle in degrees to its unsigned equivalent in the range [0, 360].
  *
  * @param angle - The angle in degrees to be converted.
  * @returns The unsigned angle in degrees, normalized to the range [0, 360].
  */
-export function toUnsigned(angle: number): number {
-	return ((angle % 360) + 360) % 360;
-}
-
+export declare function toUnsigned(angle: number): number;
 /**
  * Calculates the shortest signed arc between two angles in degrees.
  *
@@ -103,10 +58,7 @@ export function toUnsigned(angle: number): number {
  * @param to - The target angle in degrees.
  * @returns The shortest arc in degrees from `from` to `to`.
  */
-export function shortestArc(from: number, to: number): number {
-	return -toSigned((to - from + 360) % 360);
-}
-
+export declare function shortestArc(from: number, to: number): number;
 /**
  * Checks if two positions are equal within a specified tolerance.
  *
@@ -115,10 +67,7 @@ export function shortestArc(from: number, to: number): number {
  * @param tolerance - The tolerance for comparison (default is 0.5).
  * @returns `true` if the positions are equal within the tolerance, otherwise `false`.
  */
-export function positionsEqual(a: Vector3, b: Vector3, tolerance: number = 0.5): boolean {
-	return Math.abs(a.x - b.x) < tolerance && Math.abs(a.y - b.y) < tolerance && Math.abs(a.z - b.z) < tolerance;
-}
-
+export declare function positionsEqual(a: Vector3, b: Vector3, tolerance?: number): boolean;
 /**
  * Checks if a value is within a specified range.
  *
@@ -127,6 +76,5 @@ export function positionsEqual(a: Vector3, b: Vector3, tolerance: number = 0.5):
  * @param max - The maximum value of the range.
  * @returns `true` if the value is within the range [min, max], otherwise `false`.
  */
-export function inRange(value: number, min: number, max: number): boolean {
-	return value >= min && value <= max;
-}
+export declare function inRange(value: number, min: number, max: number): boolean;
+//# sourceMappingURL=index.d.ts.map