@starktma/minecraft-utils 1.0.1 → 1.2.0

package/dist/database/constants.d.ts.map

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

package/dist/database/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/database/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAgB,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AA0I5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,cAAc,CAAC,CAAC,SAAS,YAAY;IACjD,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAM;IAErB,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACH,SAAS,aAAa,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS;IAYtE;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAIjB;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI;IAK1B;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI;IAO7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;OAIG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIpC;;;OAGG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK9B;;;OAGG;IACH,aAAa,IAAI,CAAC,EAAE;IAIpB;;OAEG;IACH,eAAe,IAAI,IAAI;IAKvB;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;CAGtE"}

package/dist/database/index.d.ts.map

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

package/dist/database/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/database/interfaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;CACX"}

package/dist/math/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/math/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAIhF;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAmBlG;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,GAAE,MAAY,GAAG,OAAO,CAEvF;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAExE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/math/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAIhF;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,GAAE,OAAe,GAAG,GAAG,GAAG,IAAI,CAsB9E;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,GAAE,MAAY,GAAG,OAAO,CAEvF;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAExE"}

package/dist/minecraft/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/minecraft/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAS,MAAM,mBAAmB,CAAC;AAG1E,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,KAAK,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,WA4BnG;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,OAAO,EAAE,GAAG,QAO3E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAEtD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/minecraft/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,MAAM,EACN,MAAM,EACN,KAAK,EACL,OAAO,EAEP,iBAAiB,EACjB,OAAO,EAOP,MAAM,mBAAmB,CAAC;AAG3B,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,KAAK,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,WA4BnG;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,OAAO,EAAE,GAAG,QAO3E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAU,GAAG,OAAO,CAUjG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAO3F;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAapF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAwC1D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAe,GAAG,MAAM,CAuD3F"}

package/dist/player-event/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/player-event/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,iBAAiB,CAAC"}

package/dist/player-event/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/player-event/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,MAAM,EAEN,yBAAyB,EACzB,wBAAwB,EAGxB,SAAS,EACT,MAAM,mBAAmB,CAAC;AAG3B,KAAK,aAAa,CAAC,CAAC,GAAG,YAAY,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;AAE3D,aAAK,kBAAkB;IACtB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,QAAQ,aAAa;CACrB;AAED,aAAK,WAAW;IACf,eAAe,mCAAmC;CAClD;AAED,KAAK,eAAe,GAAG,kBAAkB,GAAG,MAAM,CAAC;AAEnD,cAAM,UAAU,CAAC,CAAC,GAAG,YAAY;IAChC,OAAO,CAAC,SAAS,CAAkD;;IASnE,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC;IAOxC,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAQpD,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;CASrD;AAED,cAAM,YAAY;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,SAAK;IACd,QAAQ,SAAK;IACb,SAAS,SAAK;gBAEF,MAAM,EAAE,MAAM;IAK1B,IAAI,mBAAmB,IACoD,yBAAyB,CACnG;IAED,IAAI,kBAAkB,IACoD,wBAAwB,CACjG;IAED,eAAe,IAAI,SAAS,GAAG,SAAS;IAIxC,KAAK;IAOL,IAAI;CAmBJ;AAED,cAAM,aAAa,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IACxD,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,MAAM,CAAoC;IAElD,SAAS;IA2BT,SAAS,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC;IAIhD,SAAS,CAAC,EAAE,EAAE,MAAM;IAIpB,YAAY,CAAC,EAAE,EAAE,MAAM;IAIvB,SAAS,CAAC,MAAM,EAAE,MAAM;IAKxB,cAAc,CAAC,OAAO,EAAE,MAAM;;;IAM9B,SAAS,CAAC,OAAO,EAAE,MAAM;IAIzB,IAAI;CAWJ;AAED,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/package.json

@@ -1,36 +1,44 @@
-{
-	"name": "@starktma/minecraft-utils",
-	"version": "1.0.1",
-	"description": "",
-	"main": "dist/index.js",
-	"types": "dist/index.d.ts",
-	"keywords": [],
-	"author": "",
-	"license": "ISC",
-	"type": "module",
-	"scripts": {
-		"build": "npx -p typescript tsc --project tsconfig.json"
-	},
-	"exports": {
-		".": {
-			"import": "./dist/index.js",
-			"types": "./dist/index.d.ts"
-		},
-		"./math": {
-			"import": "./dist/math/index.js",
-			"types": "./dist/math/index.d.ts"
-		},
-		"./minecraft": {
-			"import": "./dist/minecraft/index.js",
-			"types": "./dist/minecraft/index.d.ts"
-		}
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"devDependencies": {
-		"@minecraft/server": "^2.1.0",
-		"@minecraft/server-ui": "^2.0.0",
-		"typescript": "^5.9.2"
-	}
-}
+{
+	"name": "@starktma/minecraft-utils",
+	"version": "1.2.0",
+	"description": "",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"keywords": [],
+	"author": "",
+	"license": "ISC",
+	"type": "module",
+	"scripts": {
+		"build": "npx -p typescript tsc --project tsconfig.json"
+	},
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		},
+		"./math": {
+			"import": "./dist/math/index.js",
+			"types": "./dist/math/index.d.ts"
+		},
+		"./minecraft": {
+			"import": "./dist/minecraft/index.js",
+			"types": "./dist/minecraft/index.d.ts"
+		},
+		"./database": {
+			"import": "./dist/database/index.js",
+			"types": "./dist/database/index.d.ts"
+		},
+		"./player-events": {
+			"import": "./dist/player-event/index.js",
+			"types": "./dist/player-event/index.d.ts"
+		}
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"devDependencies": {
+		"@minecraft/server": "^2.1.0",
+		"@minecraft/server-ui": "^2.0.0",
+		"typescript": "^5.9.2"
+	}
+}

package/src/database/constants.ts

@@ -0,0 +1 @@
+export const NAMESPACE = 'inventory-manager';

package/src/database/database.ts

@@ -0,0 +1,271 @@
+import { Entity, world, World } from "@minecraft/server";
+import { SimpleObject } from "./interfaces";
+
+//@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 {
+	private static readonly DYNAMIC_PROP_MAX_LENGTH = 32767;
+	private static readonly CHUNK_KEY = "__SPLIT__";
+
+	private target: Entity | World;
+
+	constructor(target: Entity | undefined) {
+		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: string) {
+		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: string, database: object) {
+		const propertyName = `${NAMESPACE}:${databaseName}`;
+		const jsonString = JSON.stringify(database);
+		const existingProp = this.target.getDynamicProperty(propertyName) as string | undefined;
+		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: string) {
+		const propertyName = `${NAMESPACE}:${databaseName}`;
+		const propString = this.target.getDynamicProperty(propertyName) as string | undefined;
+		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: string) {
+		const propertyName = `${NAMESPACE}:${databaseName}`;
+		const propString = this.target.getDynamicProperty(propertyName) as string | undefined;
+		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: number = propObj[DatabaseManager.CHUNK_KEY];
+				let combined = "";
+				for (let i = 0; i < chunkCount; i++) {
+					const partName = `${propertyName}_${i}`;
+					const part = this.target.getDynamicProperty(partName) as string | undefined;
+					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<T extends SimpleObject> {
+	private mainDB: DatabaseManager;
+	private localDB: T[];
+
+	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) {
+		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
+	 */
+	private updateMainDB() {
+		this.mainDB.addJSONDatabase(this.databaseName, this.localDB);
+	}
+
+	/**
+	 * Retrieves the main database.
+	 * @private
+	 * @returns The main database.
+	 */
+	private 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: T): void {
+		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: T): void {
+		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: string): boolean {
+		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: string): T | undefined {
+		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: string): void {
+		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(): T[] {
+		return this.localDB;
+	}
+
+	/**
+	 * Removes all objects from the local database and updates the main database.
+	 */
+	eraseAllObjects(): void {
+		this.localDB = [];
+		this.updateMainDB();
+	}
+
+	/**
+	 * 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 {
+		this.localDB.forEach((object, index) => callback(object, index));
+	}
+}

package/src/database/index.ts

@@ -0,0 +1,4 @@
+import { SimpleDatabase } from "./database";
+import { SimpleObject } from "./interfaces";
+
+export { SimpleDatabase, SimpleObject };

package/src/database/interfaces.ts

@@ -0,0 +1,6 @@
+/**
+ * SimpleObject is an interface for objects with an id property.
+ */
+export interface SimpleObject {
+	id: string;
+}