blackcat.js-database 1.0.5 → 1.0.6

package/README.md

@@ -331,6 +331,8 @@ const db = new Database({
 
 # JSON Driver (ví dụ)
 
+Driver lưu dữ liệu trong file json.
+
 ```ts
 import { Database, JSONDriver } from "blackcat.js-database";
 
@@ -344,6 +346,8 @@ const database = new Database({
 
 # Mongo Driver (ví dụ)
 
+Driver lưu dữ liệu trong mongoose.
+
 ```ts
 import { Database, MongoDriver } from "blackcat.js-database";
 
@@ -369,6 +373,8 @@ const database = new Database({
 
 # SQLite Driver (ví dụ)
 
+Driver lưu dữ liệu trong SQLite.
+
 ```ts
 import { Database, SQLiteDriver } from "blackcat.js-database";
 
@@ -382,7 +388,6 @@ const database = new Database({
 ---
 
 
-
 # Tạo Custom Driver
 
 Bạn có thể tạo driver riêng bằng cách implement `DatabaseDriver`.

package/dist/{index.js → index.cjs}

@@ -5,7 +5,6 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __export = (target, all) => {
   for (var name in all)
@@ -28,7 +27,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 // src/index.ts
 var index_exports = {};
@@ -68,7 +66,10 @@ var errors = {
   INVALID_KEY: "{1}"
 };
 var createTypesArray = /* @__PURE__ */ __name((...elements) => `[${elements.map((element) => typeOf(element))}]`, "createTypesArray");
-var _BlackCatError = class _BlackCatError extends Error {
+var BlackCatError = class extends Error {
+  static {
+    __name(this, "BlackCatError");
+  }
   /**  
    * Creates a BlackCatError instance.
    * @param {string} errorCode Quick Mongo error code.
@@ -85,11 +86,12 @@ var _BlackCatError = class _BlackCatError extends Error {
     this.name = `BlackCatError [${code}]`;
   }
 };
-__name(_BlackCatError, "BlackCatError");
-var BlackCatError = _BlackCatError;
 
 // src/utils/TypedObject.ts
-var _TypedObject = class _TypedObject {
+var TypedObject = class {
+  static {
+    __name(this, "TypedObject");
+  }
   /**
    * Lấy danh sách key của object với type chính xác.
    *
@@ -197,11 +199,25 @@ var _TypedObject = class _TypedObject {
     return Object.entries(obj || {});
   }
 };
-__name(_TypedObject, "TypedObject");
-var TypedObject = _TypedObject;
 
 // src/Database.ts
-var _Database = class _Database {
+var Database = class {
+  static {
+    __name(this, "Database");
+  }
+  /**
+   * Storage driver được sử dụng để đọc và ghi dữ liệu database.
+   *
+   * Driver phải implement interface `DatabaseDriver`.
+   *
+   * Ví dụ:
+   * ```ts
+   * const db = new Database({
+   *   driver: new JSONDriver({ filePath: "./database.json" }),
+   * })
+   * ```
+   */
+  driver;
   /**
    * Khởi tạo Database instance.
    *
@@ -227,19 +243,6 @@ var _Database = class _Database {
    * ```
    */
   constructor(options) {
-    /**
-     * Storage driver được sử dụng để đọc và ghi dữ liệu database.
-     *
-     * Driver phải implement interface `DatabaseDriver`.
-     *
-     * Ví dụ:
-     * ```ts
-     * const db = new Database({
-     *   driver: new JSONDriver({ filePath: "./database.json" }),
-     * })
-     * ```
-     */
-    __publicField(this, "driver");
     this.driver = options.driver;
   }
   /**
@@ -288,7 +291,6 @@ var _Database = class _Database {
    */
   async get(key) {
     const data = await this.all();
-    if (key === void 0) return data;
     if (typeof key !== "string") {
       throw new BlackCatError("INVALID_TYPE", "key", "string", typeOf(key));
     }
@@ -377,7 +379,7 @@ var _Database = class _Database {
    * @param {AutocompletableString<P>} key Đường dẫn dữ liệu cần gán giá trị.
    * @param {ObjectValue<V, P>} value Giá trị mới.
    *
-   * @returns {Promise<If<IsObject<V>, ObjectValue<V, FirstObjectKey<P>>, V>>} Giá trị vừa được set hoặc object root nếu value là object.
+   * @returns {void} Giá trị vừa được set hoặc object root nếu value là object.
    *
    * @example
    * ```ts
@@ -412,7 +414,6 @@ var _Database = class _Database {
     }
     ;
     await this.driver.set(allDatabase);
-    return typeof value == "object" && value !== null ? await this.get(keys[0]) : value;
   }
   /**
    * Xóa một key khỏi database.
@@ -629,7 +630,8 @@ var _Database = class _Database {
     if (!isNumber(numberToAdd)) {
       throw new BlackCatError("INVALID_TYPE", "numberToAdd", "number", typeOf(numberToAdd));
     }
-    return await this.set(key, targetNumber + numberToAdd);
+    await this.set(key, targetNumber + numberToAdd);
+    return targetNumber + numberToAdd;
   }
   /**
    * Trừ giá trị khỏi một key dạng number.
@@ -659,7 +661,8 @@ var _Database = class _Database {
     if (!isNumber(numberToSubtract)) {
       throw new BlackCatError("INVALID_TYPE", "numberToSubtract", "number", typeOf(numberToSubtract));
     }
-    return await this.set(key, targetNumber - numberToSubtract);
+    await this.set(key, targetNumber - numberToSubtract);
+    return targetNumber - numberToSubtract;
   }
   /**
    * Thêm một hoặc nhiều phần tử vào cuối array tại key-path.
@@ -877,7 +880,8 @@ var _Database = class _Database {
    * const userKeys = await db.keys("user");
    */
   async keys(key) {
-    if (!key) return TypedObject.keys(await this.all());
+    const all = await this.all();
+    if (!key) return TypedObject.keys(all);
     const data = await this.get(key);
     return TypedObject.keys(data).filter((key2) => data[key2] !== void 0 && data[key2] !== null);
   }
@@ -911,7 +915,8 @@ var _Database = class _Database {
    * const userValues = await db.values("users");
    */
   async values(key) {
-    if (!key) return TypedObject.values(await this.all());
+    const all = await this.all();
+    if (!key) return TypedObject.values(all);
     const data = await this.get(key);
     return TypedObject.values(data);
   }
@@ -1036,12 +1041,21 @@ var _Database = class _Database {
     return values.every(queryFunction);
   }
 };
-__name(_Database, "Database");
-var Database = _Database;
 
 // src/drivers/JSONDriver.ts
 var import_fs = require("fs");
-var _JSONDriver = class _JSONDriver {
+var JSONDriver = class {
+  static {
+    __name(this, "JSONDriver");
+  }
+  /**
+   * Đường dẫn tới file database JSON.
+   */
+  filePath;
+  /**
+   * Cho biết có minify JSON khi ghi file hay không.
+   */
+  minifyJSON;
   /**
    * Khởi tạo một instance mới của {@link JSONDriver}.
    *
@@ -1063,14 +1077,6 @@ var _JSONDriver = class _JSONDriver {
    * ```
    */
   constructor(options) {
-    /**
-     * Đường dẫn tới file database JSON.
-     */
-    __publicField(this, "filePath");
-    /**
-     * Cho biết có minify JSON khi ghi file hay không.
-     */
-    __publicField(this, "minifyJSON");
     this.filePath = options.filePath || "database.json";
     this.minifyJSON = options.minifyJSON || false;
   }
@@ -1131,11 +1137,16 @@ var _JSONDriver = class _JSONDriver {
     return true;
   }
 };
-__name(_JSONDriver, "JSONDriver");
-var JSONDriver = _JSONDriver;
 
 // src/drivers/MemoryDriver.ts
-var _MemoryDriver = class _MemoryDriver {
+var MemoryDriver = class {
+  static {
+    __name(this, "MemoryDriver");
+  }
+  /**
+   * Object chứa toàn bộ dữ liệu database trong RAM.
+   */
+  store;
   /**
    * Khởi tạo MemoryDriver.
    *
@@ -1162,10 +1173,6 @@ var _MemoryDriver = class _MemoryDriver {
    * ```
    */
   constructor(initialData = {}) {
-    /**
-     * Object chứa toàn bộ dữ liệu database trong RAM.
-     */
-    __publicField(this, "store");
     this.store = initialData;
   }
   /**
@@ -1196,12 +1203,21 @@ var _MemoryDriver = class _MemoryDriver {
     return true;
   }
 };
-__name(_MemoryDriver, "MemoryDriver");
-var MemoryDriver = _MemoryDriver;
 
 // src/drivers/SQLiteDriver.ts
 var import_better_sqlite3 = __toESM(require("better-sqlite3"));
-var _SQLiteDriver = class _SQLiteDriver {
+var SQLiteDriver = class {
+  static {
+    __name(this, "SQLiteDriver");
+  }
+  /**
+   * SQLite database instance.
+   */
+  db;
+  /**
+   * Tên table lưu trữ dữ liệu JSON.
+   */
+  table;
   /**
    * Khởi tạo SQLiteDriver.
    *
@@ -1218,14 +1234,6 @@ var _SQLiteDriver = class _SQLiteDriver {
    * ```
    */
   constructor(options = {}) {
-    /**
-     * SQLite database instance.
-     */
-    __publicField(this, "db");
-    /**
-     * Tên table lưu trữ dữ liệu JSON.
-     */
-    __publicField(this, "table");
     this.db = new import_better_sqlite3.default(options.filePath ?? "database.sqlite");
     this.table = options.table ?? "json_store";
     this.db.prepare(`CREATE TABLE IF NOT EXISTS ${this.table} (id INTEGER PRIMARY KEY, data TEXT)`).run();
@@ -1263,12 +1271,45 @@ var _SQLiteDriver = class _SQLiteDriver {
     return true;
   }
 };
-__name(_SQLiteDriver, "SQLiteDriver");
-var SQLiteDriver = _SQLiteDriver;
 
 // src/drivers/MongoDriver.ts
 var import_mongodb = require("mongodb");
-var _MongoDriver = class _MongoDriver {
+var MongoDriver = class {
+  static {
+    __name(this, "MongoDriver");
+  }
+  /**
+   * MongoDB client instance.
+   */
+  client;
+  /**
+   * MongoDB database instance.
+   */
+  db;
+  /**
+   * Collection lưu dữ liệu JSON.
+   */
+  collection;
+  /**
+   * Tên database MongoDB.
+   */
+  databaseName;
+  /**
+   * Tên collection MongoDB.
+   */
+  collectionName;
+  /**
+   * Callback khi kết nối thành công.
+   */
+  onLoad;
+  /**
+   * Callback khi xảy ra lỗi.
+   */
+  onError;
+  /**
+   * Trạng thái đã gọi onLoad chưa (tránh spam)
+   */
+  isLoaded = false;
   /**
    * Khởi tạo MongoDriver.
    *
@@ -1295,38 +1336,6 @@ var _MongoDriver = class _MongoDriver {
    * });
    */
   constructor(options = {}) {
-    /**
-     * MongoDB client instance.
-     */
-    __publicField(this, "client");
-    /**
-     * MongoDB database instance.
-     */
-    __publicField(this, "db");
-    /**
-     * Collection lưu dữ liệu JSON.
-     */
-    __publicField(this, "collection");
-    /**
-     * Tên database MongoDB.
-     */
-    __publicField(this, "databaseName");
-    /**
-     * Tên collection MongoDB.
-     */
-    __publicField(this, "collectionName");
-    /**
-     * Callback khi kết nối thành công.
-     */
-    __publicField(this, "onLoad");
-    /**
-     * Callback khi xảy ra lỗi.
-     */
-    __publicField(this, "onError");
-    /**
-     * Trạng thái đã gọi onLoad chưa (tránh spam)
-     */
-    __publicField(this, "isLoaded", false);
     const {
       mongourl = "mongodb://localhost:27017",
       databaseName = "database",
@@ -1410,8 +1419,6 @@ var _MongoDriver = class _MongoDriver {
     return true;
   }
 };
-__name(_MongoDriver, "MongoDriver");
-var MongoDriver = _MongoDriver;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Database,
@@ -1420,4 +1427,4 @@ var MongoDriver = _MongoDriver;
   MongoDriver,
   SQLiteDriver
 });
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/utils/isObject.function.ts","../src/utils/typeOf.function.ts","../src/utils/isNumber.function.ts","../src/utils/BlackCatError.ts","../src/utils/TypedObject.ts","../src/Database.ts","../src/drivers/JSONDriver.ts","../src/drivers/MemoryDriver.ts","../src/drivers/SQLiteDriver.ts","../src/drivers/MongoDriver.ts"],"sourcesContent":["export * from \"./Database.ts\";\nexport * from \"./drivers\";","/**\n * Kiểm tra một giá trị có phải là object (không phải array, không phải null) hay không.\n *\n * @param item - Giá trị cần kiểm tra\n * @returns `true` nếu là object hợp lệ, ngược lại `false`\n *\n * @remarks\n * Method này dùng để xác định một giá trị có phải là object theo nghĩa:\n * - Có kiểu `typeof === \"object\"`\n * - Không phải `null`\n * - Không phải `Array`\n *\n * ---\n *\n * ### Cơ chế hoạt động:\n * - Loại trừ `Array` bằng `Array.isArray`\n * - Loại trừ `null`\n * - Kiểm tra `typeof item === \"object\"`\n *\n * ---\n *\n * ### Lưu ý:\n * - Trả về `true` với:\n *   - Plain object (`{}`)\n *   - Object từ class (`new MyClass()`)\n *   - Built-in object (`Date`, `Map`, `Set`, ...)\n *\n * - Không phải là kiểm tra **plain object** (POJO)\n *   → Nếu cần strict hơn, nên dùng `isPlainObject`\n *\n * ---\n *\n * @example\n * ```ts\n * isObject({});            // true\n * isObject({ a: 1 });      // true\n * ```\n *\n * @example\n * ```ts\n * isObject([]);            // false\n * isObject(null);          // false\n * ```\n *\n * @example\n * ```ts\n * isObject(new Date());    // true\n * isObject(new Map());     // true\n * ```\n *\n * @example\n * ```ts\n * isObject(\"text\");        // false\n * isObject(123);           // false\n * isObject(undefined);     // false\n * ```\n *\n * @see Array.isArray\n */\nexport const isObject = (item: any): boolean => !Array.isArray(item) && item !== null && typeof item === \"object\";","/**\n * Trả về kiểu dữ liệu \"chính xác\" của một giá trị.\n *\n * @param input - Giá trị cần kiểm tra\n * @returns Chuỗi mô tả kiểu dữ liệu của `input`\n *\n * @remarks\n * Đây là utility nâng cao so với `typeof`, giúp phân biệt rõ hơn\n * các kiểu dữ liệu trong JavaScript, đặc biệt là:\n * - `null`\n * - `NaN`\n * - Class / instance\n * - Object có constructor\n *\n * ---\n *\n * ### Cơ chế hoạt động:\n * 1. Xử lý các trường hợp đặc biệt:\n *    - `null` → `\"null\"`\n *    - `undefined` → `\"undefined\"`\n *    - `NaN` → `\"NaN\"`\n *\n * 2. Nếu là function có `prototype`:\n *    → coi như class constructor  \n *    → trả về: `\"<ClassName> class instance\"`\n *\n * 3. Nếu là object / function:\n *    → trả về `constructor.name` nếu tồn tại\n *\n * 4. Fallback:\n *    → dùng `typeof`\n *\n * ---\n *\n * ### Khác với `typeof`:\n * | Input        | typeof     | typeOf            |\n * |--------------|-----------|-------------------|\n * | `null`       | \"object\"  | \"null\"            |\n * | `[]`         | \"object\"  | \"Array\"           |\n * | `{}`         | \"object\"  | \"Object\"          |\n * | `new Date()` | \"object\"  | \"Date\"            |\n * | `NaN`        | \"number\"  | \"NaN\"             |\n *\n * ---\n *\n * ### Lưu ý:\n * - Kết quả phụ thuộc vào `constructor.name`\n * - Có thể không chính xác nếu code bị minify (tên class bị rút gọn)\n * - Không phân biệt rõ instance vs plain object nếu cùng constructor\n *\n * ---\n *\n * @example\n * ```ts\n * typeOf(null);        // \"null\"\n * typeOf(undefined);   // \"undefined\"\n * typeOf(NaN);         // \"NaN\"\n * ```\n *\n * @example\n * ```ts\n * typeOf([]);          // \"Array\"\n * typeOf({});          // \"Object\"\n * typeOf(new Date());  // \"Date\"\n * ```\n *\n * @example\n * ```ts\n * class User {}\n *\n * typeOf(User);        // \"User class instance\"\n * typeOf(new User());  // \"User\"\n * ```\n *\n * @example\n * ```ts\n * typeOf(\"text\");      // \"String\"\n * typeOf(123);         // \"Number\"\n * ```\n *\n * @see typeof\n */\nexport const typeOf = (input: any): string => {\n    // Xử lý các trường hợp đặc biệt: null, undefined và NaN\n    if (input == null || (typeof input === \"number\" && Number.isNaN(input))) {\n        return String(input);\n    }\n    // Nếu đó là hàm tạo của lớp (có nguyên mẫu)\n    if (typeof input === \"function\" && input.prototype) {\n        return `${input.name} class instance`;\n    }\n    // Trả về tên hàm tạo nếu có, nếu không sẽ sử dụng kiểu dữ liệu (typeof) làm phương án dự phòng.\n    return input?.constructor?.name ?? typeof input;\n};","import { typeOf } from \"./typeOf.function\";\n\n/**\n * Kiểm tra một giá trị có phải là số hợp lệ hay không.\n *\n * @param input - Giá trị cần kiểm tra\n * @returns `true` nếu là số hợp lệ, ngược lại `false`\n *\n * @remarks\n * Đây là utility dùng để xác định một giá trị có thể được xem là số,\n * đồng thời tránh các trường hợp sai lệch từ JavaScript như:\n * - `\"\"` (empty string) → bị coi là `0`\n * - `[]` (array rỗng) → bị coi là `0`\n * - `null` → bị coi là `0`\n *\n * ---\n *\n * ### Cơ chế hoạt động:\n * - Sử dụng `isNaN()` để kiểm tra khả năng chuyển đổi sang number\n * - Loại trừ các trường hợp đặc biệt:\n *   - `\"\"`\n *   - `null`\n *   - `Array`\n *\n * ---\n *\n * ### Lưu ý:\n * - Không phân biệt giữa `number` và `numeric string`\n *   - `\"123\"` → `true`\n * - Không kiểm tra `Infinity` hoặc `-Infinity`\n * - Phụ thuộc vào `typeOf()` để xác định array\n *\n * ---\n *\n * @example\n * ```ts\n * isNumber(123);        // true\n * isNumber(\"123\");      // true\n * isNumber(\"12.5\");     // true\n * ```\n *\n * @example\n * ```ts\n * isNumber(\"\");         // false\n * isNumber(null);       // false\n * isNumber([]);         // false\n * ```\n *\n * @example\n * ```ts\n * isNumber(\"abc\");      // false\n * isNumber(undefined);  // false\n * ```\n *\n * @see isNaN\n */\nexport const isNumber = (input: any): boolean => !isNaN(input as number) && input !== \"\" && input !== null && typeOf(input) !== \"Array\";","import { typeOf } from \"./typeOf.function\";\n\nexport type TargetParamType = \"string\" | \"number\" | \"object\" | \"array\" | `${string} class instance`;\nexport const errors = {\n    UNKNOWN_ERROR: 'Lỗi không xác định.',\n    REQUIRED_PARAMETER_MISSING: 'Tham số \\'{1}\\' là bắt buộc nhưng chưa được cung cấp.',\n    INVALID_TYPE: '\\'{1}\\' phải có kiểu {2}. Kiểu nhận được: {3}.',\n    ONE_OR_MORE_ARRAY_TYPES_INVALID: 'Tất cả phần tử trong mảng của tham số \\'{1}\\' phải có kiểu {2}. Các kiểu nhận được trong mảng: {3}.',\n    INVALID_TARGET: 'Đối tượng target trong database phải có kiểu {1}. Kiểu nhận được: {2}.',\n    INVALID_KEY: \"{1}\",\n};\nexport interface ErrorParams extends Record<keyof typeof errors, string[]> {\n    UNKNOWN_ERROR: [];\n    REQUIRED_PARAMETER_MISSING: [missingParam: string];\n    INVALID_TYPE: [paramName: string, targetType: TargetParamType, receivedType: string];\n    ONE_OR_MORE_ARRAY_TYPES_INVALID: [paramName: string, targetType: TargetParamType, receivedTypesArray: string];\n    INVALID_TARGET: [targetType: TargetParamType, receivedType: string];\n    INVALID_KEY: [paramName: string];\n}\nexport const createTypesArray = <T>(...elements: any): string => `[${elements.map((element: any) => typeOf(element))}]`;\n/**\n * BlackCatError class.\n */\nexport class BlackCatError<TErrorCode extends keyof typeof errors> extends Error {\n    /**  \n     * Creates a BlackCatError instance.\n     * @param {string} errorCode Quick Mongo error code.\n     * @param {any[]} params Additional parameters to replace the placeholders in the error message.\n     */\n    public constructor(errorCode: TErrorCode, ...params: ErrorParams[TErrorCode]) {\n        const code = errors[errorCode] ? errorCode : \"UNKNOWN_ERROR\" as TErrorCode;\n        let message = errors[code];\n        for (let i = 0; i < params.length; i++) {\n            message = message.replaceAll(`{${i + 1}}`, params[i]);\n        };\n        super(message);\n        /**\n         * The name of the error.\n         */\n        this.name = `BlackCatError [${code}]`;\n    }\n}","import { ExtractObjectKeys, ExtractObjectValues, ExtractObjectEntries } from \"../types\";\n\n/**\n * Utility class hỗ trợ làm việc với object theo hướng type-safe.\n *\n * @remarks\n * Class này cung cấp các phương thức static tương tự `Object.keys`,\n * `Object.values`, `Object.entries` nhưng có typing chính xác hơn\n * nhờ sử dụng các utility types:\n * - {@link ExtractObjectKeys}\n * - {@link ExtractObjectValues}\n * - {@link ExtractObjectEntries}\n *\n * ---\n *\n * ### Lợi ích:\n * - Giữ nguyên type của key/value khi thao tác object\n * - Tránh bị widen type thành `string[]` hoặc `any[]`\n * - Tăng khả năng infer type trong TypeScript\n *\n * ---\n *\n * @example\n * ```ts\n * const obj = { a: 1, b: 2 };\n *\n * const keys = TypedObject.keys(obj);\n * // type: (\"a\" | \"b\")[]\n * ```\n *\n * @example\n * ```ts\n * const values = TypedObject.values(obj);\n * // type: number[]\n * ```\n *\n * @example\n * ```ts\n * const entries = TypedObject.entries(obj);\n * // type: [\"a\" | \"b\", number][]\n * ```\n */\nexport class TypedObject {\n    /**\n     * Lấy danh sách key của object với type chính xác.\n     *\n     * @typeParam TObject - Kiểu object đầu vào\n     *\n     * @param obj - Object cần lấy key\n     * @returns Mảng các key của object (`ExtractObjectKeys<TObject>[]`)\n     *\n     * @remarks\n     * Khác với `Object.keys`:\n     * - `Object.keys(obj)` → `string[]`\n     * - `TypedObject.keys(obj)` → union key chính xác\n     *\n     * ---\n     *\n     * ### Lưu ý:\n     * - Nếu `obj` là `null` hoặc `undefined`, sẽ fallback thành `{}` → trả về `[]`\n     *\n     * ---\n     *\n     * @example\n     * ```ts\n     * const obj = { a: 1, b: 2 };\n     *\n     * const keys = TypedObject.keys(obj);\n     * // (\"a\" | \"b\")[]\n     * ```\n     *\n     * @see Object.keys\n     */\n    public static keys<TObject extends Record<string, any>>(obj: TObject): ExtractObjectKeys<TObject>[] {\n        return Object.keys(obj || {});\n    }\n\n    /**\n     * Lấy danh sách value của object với type chính xác.\n     *\n     * @typeParam TObject - Kiểu object đầu vào\n     *\n     * @param obj - Object cần lấy value\n     * @returns Mảng các value của object (`ExtractObjectValues<TObject>[]`)\n     *\n     * @remarks\n     * Khác với `Object.values`:\n     * - `Object.values(obj)` → `any[]`\n     * - `TypedObject.values(obj)` → union value chính xác\n     *\n     * ---\n     *\n     * ### Lưu ý:\n     * - Nếu `obj` là `null` hoặc `undefined`, sẽ fallback thành `{}` → trả về `[]`\n     *\n     * ---\n     *\n     * @example\n     * ```ts\n     * const obj = { a: 1, b: 2 };\n     *\n     * const values = TypedObject.values(obj);\n     * // number[]\n     * ```\n     *\n     * @see Object.values\n     */\n    public static values<TObject extends Record<string, any>>(obj: TObject): ExtractObjectValues<TObject>[] {\n        return Object.values(obj || {});\n    }\n\n    /**\n     * Lấy danh sách entry (key-value) của object với type chính xác.\n     *\n     * @typeParam TObject - Kiểu object đầu vào\n     *\n     * @param obj - Object cần lấy entries\n     * @returns Mảng các cặp `[key, value]` (`ExtractObjectEntries<TObject>[]`)\n     *\n     * @remarks\n     * Khác với `Object.entries`:\n     * - `Object.entries(obj)` → `[string, any][]`\n     * - `TypedObject.entries(obj)` → typed tuple chính xác\n     *\n     * ---\n     *\n     * ### Lưu ý:\n     * - Nếu `obj` là `null` hoặc `undefined`, sẽ fallback thành `{}` → trả về `[]`\n     *\n     * ---\n     *\n     * @example\n     * ```ts\n     * const obj = { a: 1, b: 2 };\n     *\n     * const entries = TypedObject.entries(obj);\n     * // [\"a\" | \"b\", number][]\n     * ```\n     *\n     * @example\n     * ```ts\n     * for (const [key, value] of TypedObject.entries(obj)) {\n     *   // key & value được infer đúng type\n     * }\n     * ```\n     *\n     * @see Object.entries\n     */\n    public static entries<TObject extends Record<string, any>>(obj: TObject): ExtractObjectEntries<TObject>[] {\n        return Object.entries(obj || {});\n    }\n}","import { DatabaseConfiguration, AutocompletableString, If, IsObject, ObjectPath, ObjectValue, Maybe, QueryFunction, RestOrArray, ExtractFromArray, DatabaseDriver, ArrayElement } from \"./types\";\nimport { BlackCatError, createTypesArray, isNumber, typeOf, TypedObject, isObject } from \"./utils\";\nexport { DatabaseDriver } from \"./types\";\n/**\n * Class Database cung cấp API thao tác dữ liệu dạng key-path\n * trên nhiều loại storage khác nhau thông qua `DatabaseDriver`.\n *\n * Đây là **lớp database chính (logic layer)** của hệ thống.\n *\n * Class này chịu trách nhiệm:\n * - parse key path (`user.profile.name`)\n * - validate dữ liệu\n * - thao tác object\n * - query dữ liệu (find, filter, map...)\n *\n * Việc lưu trữ dữ liệu thực tế sẽ được thực hiện bởi các **driver phụ trợ**\n * như:\n *\n * - `JSONDriver`\n * - `MemoryDriver`\n * - `SQLiteDriver`\n * - `MongoDriver`\n *\n * Các driver này chỉ chịu trách nhiệm:\n * - đọc toàn bộ dữ liệu database\n * - ghi toàn bộ dữ liệu database\n *\n * @template V Kiểu dữ liệu tổng thể của database.\n */\nexport class Database<V = any> {\n    /**\n     * Storage driver được sử dụng để đọc và ghi dữ liệu database.\n     *\n     * Driver phải implement interface `DatabaseDriver`.\n     *\n     * Ví dụ:\n     * ```ts\n     * const db = new Database({\n     *   driver: new JSONDriver({ filePath: \"./database.json\" }),\n     * })\n     * ```\n     */\n    public driver: DatabaseDriver;\n    /**\n     * Khởi tạo Database instance.\n     *\n     * @param options Cấu hình database.\n     * @param options.driver Driver lưu trữ dữ liệu.\n     *\n     * @example\n     * ```ts\n     * const db = new Database({\n     *   driver: new JSONDriver({ filePath: \"./database.json\" }),\n     * })\n     * ```\n     *\n     * Ví dụ với MongoDB:\n     *\n     * ```ts\n     * const db = new Database({\n     *   driver: new MongoDriver({\n     *     uri: \"mongodb://localhost:27017\",\n     *     databaseName: \"mydb\"\n     *   })\n     * });\n     * ```\n     */\n    constructor(options: DatabaseConfiguration) {\n        this.driver = options.driver;\n    }\n    /**\n     * Lấy toàn bộ dữ liệu từ database thông qua driver.\n     *\n     * @template T Kiểu dữ liệu object database trả về.\n     *\n     * @returns Promise chứa toàn bộ dữ liệu database.\n     *\n     * @example\n     * ```ts\n     * const data = await db.all();\n     * console.log(data.users);\n     * ```\n     */\n    public async all(): Promise<V> {\n        return await this.driver.all();\n    }\n    /**\n     * Lấy giá trị từ database theo key-path.\n     *\n     * Key có thể là chuỗi dạng path:\n     *\n     * ```\n     * user.profile.name\n     * economy.users.123.balance\n     * ```\n     *\n     * Nếu không truyền `key`, method sẽ trả về **toàn bộ database**.\n     *\n     * @template {AutocompletableString<ObjectPath<V>>} P Key path trong database.\n     *\n     * @param {AutocompletableString<P>} key Đường dẫn dữ liệu cần lấy.\n     *\n     * @returns Giá trị tại key hoặc `null` nếu không tồn tại.\n     *\n     * @example\n     * ```ts\n     * const name = await db.get(\"user.profile.name\");\n     * ```\n     *\n     * @example\n     * ```ts\n     * const all = await db.get();\n     * ```\n     */\n    public async get<P extends AutocompletableString<ObjectPath<V>>>(key?: AutocompletableString<P>): Promise<Maybe<ObjectValue<V, P>>> {\n        const data = await this.all();\n        if (typeof key !== \"string\") {\n            throw new BlackCatError(\"INVALID_TYPE\", \"key\", \"string\", typeOf(key));\n        }\n        const keys = key.split(\".\");\n        let result: any = data;\n        for (const k of keys) {\n            if (!isObject(result) && !Array.isArray(result)) return null;\n            result = result[k];\n            if (result === undefined) return null;\n        }\n        return result;\n    }\n    /**\n     * Tìm và trả về một bản ghi đầu tiên khớp với điều kiện trong database.\n     *\n     * Hàm này có hai cách sử dụng:\n     *\n     * 1. **Chỉ truyền `key`**\n     *    → Trả về toàn bộ dữ liệu của key (tương tự `get()`).\n     *\n     * 2. **Truyền `key` và `query`**\n     *    → Tìm phần tử đầu tiên trong mảng dữ liệu của key khớp với điều kiện.\n     *\n     * @template V - Kiểu dữ liệu của database.\n     * @template P - Đường dẫn key trong object (`ObjectPath<V>`).\n     *\n     * @param key - Key hoặc đường dẫn đến dữ liệu cần truy vấn.\n     * @param query - Đối tượng điều kiện để tìm bản ghi phù hợp.\n     *\n     * @returns\n     * - Nếu chỉ có `key`: trả về toàn bộ dữ liệu của key.\n     * - Nếu có `query`: trả về bản ghi đầu tiên khớp điều kiện.\n     * - Nếu không tìm thấy: trả về `null`.\n     *\n     * @example\n     * Chỉ lấy dữ liệu theo key\n     * ```ts\n     * const users = await db.findOne(\"user\");\n     * ```\n     *\n     * @example\n     * Tìm một bản ghi theo điều kiện\n     * ```ts\n     * const user = await db.findOne(\"user\", {\n     *   guild: 1234566\n     * });\n     * ```\n     */\n    public async findOne<P extends AutocompletableString<ObjectPath<V>>>(key?: AutocompletableString<P>, query?: Partial<ArrayElement<ObjectValue<V, P>>>): Promise<Maybe<ObjectValue<V, P>>> {\n        const data = await this.get(key as any);\n        if (!query) return data;\n        if (!Array.isArray(data)) return null as Maybe<ObjectValue<V, P>>;\n        const result = data.find((item) => {\n            return Object.entries(query as Record<string, any>).every(([k, v]) => item[k] == v);\n        });\n        return (result ?? null) as Maybe<ObjectValue<V, P>>;\n    }\n    /**\n     * Kiểm tra một key-path có tồn tại trong database hay không.\n     *\n     * Method này sử dụng `get()` để xác định giá trị có tồn tại.\n     *\n     * @template {AutocompletableString<ObjectPath<V>>} P Key path trong database.\n     *\n     * @param {AutocompletableString<P>} key Đường dẫn dữ liệu cần kiểm tra.\n     *\n     * @returns `true` nếu key tồn tại, ngược lại `false`.\n     *\n     * @example\n     * ```ts\n     * const exists = await db.has(\"users.123\");\n     * ```\n     */\n    public async has<P extends AutocompletableString<ObjectPath<V>>>(key: AutocompletableString<P>): Promise<boolean> {\n        const value = await this.get(key);\n        return value !== null && value !== undefined;\n    }\n    /**\n     * Gán giá trị cho một key-path trong database.\n     *\n     * Nếu key-path chưa tồn tại, các object trung gian\n     * sẽ được tự động tạo.\n     *\n     * @template {AutocompletableString<ObjectPath<V>>} P Key path trong database.\n     *\n     * @param {AutocompletableString<P>} key Đường dẫn dữ liệu cần gán giá trị.\n     * @param {ObjectValue<V, P>} value Giá trị mới.\n     *\n     * @returns {void} Giá trị vừa được set hoặc object root nếu value là object.\n     *\n     * @example\n     * ```ts\n     * await db.set(\"users.123.name\", \"Alice\");\n     * ```\n     *\n     * @example\n     * ```ts\n     * await db.set(\"config.prefix\", \"!\");\n     * ```\n     */\n    public async set<P extends AutocompletableString<ObjectPath<V>>>(key: AutocompletableString<P>, value: ObjectValue<V, P>): Promise<void> {\n        const allDatabase = await this.all();\n        if (!key) {\n            throw new BlackCatError(\"REQUIRED_PARAMETER_MISSING\", \"key\");\n        }\n        if (typeof key !== \"string\") {\n            throw new BlackCatError(\"INVALID_TYPE\", \"key\", \"string\", typeOf(key));\n        }\n        const keys = key.split(\".\");\n        let currentObj = allDatabase as any;\n\n        for (let i = 0; i < keys.length; i++) {\n            if (keys.length - 1 === i) {\n                currentObj[keys[i]] = value\n            } else {\n                if (!isObject(currentObj[keys[i]])) {\n                    currentObj[keys[i]] = {};\n                }\n                currentObj = currentObj[keys[i]];\n            };\n        };\n        await this.driver.set(allDatabase);\n    }\n    /**\n     * Xóa một key khỏi database.\n     *\n     * Hỗ trợ nested path bằng dot notation.\n     *\n     * @typeParam P - Path của object.\n     *\n     * @param key - Đường dẫn key cần xóa.\n     *\n     * @returns\n     * - `true` nếu xóa thành công\n     * - `false` nếu key không tồn tại\n     *\n     * @throws BlackCatError\n     * - INVALID_TYPE nếu key không phải string\n     *\n     * @example\n     * await db.delete(\"user.name\");\n     */\n    public async delete<P extends AutocompletableString<ObjectPath<V>>>(key?: AutocompletableString<P>): Promise<boolean> {\n        if (typeof key !== \"string\") {\n            throw new BlackCatError(\"INVALID_TYPE\", \"key\", \"string\", typeof key);\n        }\n        const allDatabase = await this.all();\n        const keys = key.split(\".\");\n        const lastKey = keys.pop() as string;\n        let currentObj: any = allDatabase;\n        for (const k of keys) {\n            if (!isObject(currentObj[k])) {\n                return false;\n            }\n            currentObj = currentObj[k];\n        }\n        if (!(lastKey in currentObj)) return false;\n        delete currentObj[lastKey];\n        await this.driver.set(allDatabase);\n        return true;\n    }\n    /**\n     * Xóa toàn bộ dữ liệu trong database.\n     *\n     * Method này gọi trực tiếp `driver.delete()` để reset storage.\n     *\n     * @returns `true` sau khi dữ liệu đã được xóa.\n     *\n     * @example\n     * await db.deleteAll();\n     */\n    public async deleteAll(): Promise<boolean> {\n        await this.driver.delete();\n        return true;\n    }\n    /**\n     * Xóa nhiều bản ghi trong một mảng dữ liệu dựa trên điều kiện truy vấn.\n     *\n     * ⚠️ Method này **chỉ hoạt động với dữ liệu dạng mảng (array)**.\n     * Nếu dữ liệu tại `key` không phải là mảng, method sẽ **không thực hiện xóa**\n     * và trả về `0`.\n     *\n     * Method sẽ duyệt qua toàn bộ phần tử trong mảng và xóa những phần tử\n     * khớp với điều kiện `query`.\n     *\n     * @template V - Kiểu dữ liệu của database.\n     * @template P - Đường dẫn key trong object (`ObjectPath<V>`).\n     *\n     * @param key - Đường dẫn đến mảng dữ liệu cần thao tác.\n     * @param query - Điều kiện để xác định các phần tử cần xóa.\n     * Có thể truyền:\n     * - Một object điều kiện\n     *\n     * @returns Số lượng phần tử đã bị xóa khỏi mảng.\n     *\n     * @example\n     * Database mẫu:\n     * ```json\n     * {\n     *   \"member\": {\n     *     \"user\": {\n     *       \"database\": [\n     *         { \"guild\": \"123\", \"username\": \"vinh\" },\n     *         { \"guild\": \"456\", \"username\": \"test\" }\n     *       ]\n     *     }\n     *   }\n     * }\n     * ```\n     *\n     * @example\n     * Xóa tất cả user có guild = \"123\"\n     * ```ts\n     * await db.deleteMany(\"member.user.database\", {\n     *   guild: \"123\"\n     * });\n     * ```\n     */\n    public async deleteMany<P extends AutocompletableString<ObjectPath<V>>>(key: AutocompletableString<P>, query: Partial<ArrayElement<ObjectValue<V, P>>>): Promise<number> {\n        const data = await this.get(key as any);\n        if (!Array.isArray(data)) return 0;\n        const originalLength = data.length;\n        const filtered = data.filter((item: any) => {\n            return !Object.entries(query as Record<string, any>).every(([k, v]) => item[k] == v);\n        });\n        await this.set(key, filtered as any);\n\n        return originalLength - filtered.length;\n    }\n    /**\n     * Cập nhật dữ liệu trong database theo đường dẫn key.\n     *\n     * Hàm này sẽ tìm đến vị trí của `key` trong database và gán `value` vào đó.\n     * Nếu `value` và giá trị hiện tại tại key đều là object thì sẽ thực hiện\n     * **shallow merge** thay vì ghi đè toàn bộ object.\n     *\n     * Điều này giúp tránh việc làm mất các thuộc tính đã tồn tại.\n     *\n     * @template P - Đường dẫn key hợp lệ trong object database.\n     *\n     * @param key - Đường dẫn tới giá trị cần cập nhật.\n     * Hỗ trợ nested path dạng `\"a.b.c\"`.\n     *\n     * @param value - Giá trị mới sẽ được cập nhật tại key.\n     *\n     * @returns\n     * Trả về giá trị cuối cùng sau khi cập nhật.\n     *\n     * @example\n     * Database ban đầu:\n     * ```json\n     * {\n     *   \"123\": {\n     *     \"guildID\": \"123\",\n     *     \"guildName\": \"BlackCat\",\n     *     \"history\": []\n     *   }\n     * }\n     * ```\n     *\n     * Cập nhật:\n     * ```ts\n     * await db.update(\"123\", {\n     *   history: [1,2,3]\n     * });\n     * ```\n     *\n     * Kết quả:\n     * ```json\n     * {\n     *   \"123\": {\n     *     \"guildID\": \"123\",\n     *     \"guildName\": \"BlackCat\",\n     *     \"history\": [1,2,3]\n     *   }\n     * }\n     * ```\n     *\n     * @throws {BlackCatError}\n     * - `REQUIRED_PARAMETER_MISSING` nếu key không được cung cấp\n     * - `INVALID_TYPE` nếu key không phải string\n     */\n    public async update<P extends AutocompletableString<ObjectPath<V>>>(key: AutocompletableString<P>, value: ObjectValue<V, P>): Promise<If<IsObject<V>, ObjectValue<V, P>>> {\n        if (!key) {\n            throw new BlackCatError(\"REQUIRED_PARAMETER_MISSING\", \"key\");\n        }\n        if (typeof key !== \"string\") {\n            throw new BlackCatError(\"INVALID_TYPE\", \"key\", \"string\", typeOf(key));\n        }\n        const allDatabase = await this.all();\n        const keys = key.split(\".\");\n        let current: any = allDatabase;\n        for (let i = 0; i < keys.length - 1; i++) {\n            const part = keys[i];\n            if (!isObject(current[part])) {\n                current[part] = {};\n            }\n            current = current[part];\n        }\n\n        const lastKey = keys[keys.length - 1];\n        if (isObject(value) && isObject(current[lastKey])) {\n            current[lastKey] = {\n                ...current[lastKey],\n                ...value\n            };\n        } else {\n            current[lastKey] = value;\n        }\n        await this.driver.set(allDatabase);\n        return current[lastKey];\n    }\n    /**\n     * Cộng thêm giá trị vào một key dạng number.\n     *\n     * Nếu key chưa tồn tại, giá trị mặc định sẽ là `0`.\n     *\n     * @template P Key path trong database.\n     *\n     * @param key Đường dẫn dữ liệu dạng number.\n     * @param numberToAdd Số cần cộng thêm.\n     *\n     * @returns Giá trị mới sau khi cộng.\n     *\n     * @example\n     * ```ts\n     * await db.add(\"economy.users.123.balance\", 50);\n     * ```\n     */\n    public async add<P extends AutocompletableString<ObjectPath<V>>>(key: AutocompletableString<P>, numberToAdd: number): Promise<number> {\n        const targetNumber = await this.get(key) as any ?? 0;\n\n        if (!isNumber(targetNumber)) {\n            throw new BlackCatError(\"INVALID_TARGET\", \"number\", typeOf(targetNumber));\n        }\n        if (numberToAdd === undefined) {\n            throw new BlackCatError(\"REQUIRED_PARAMETER_MISSING\", \"numberToAdd\");\n        }\n        if (!isNumber(numberToAdd)) {\n            throw new BlackCatError(\"INVALID_TYPE\", \"numberToAdd\", \"number\", typeOf(numberToAdd));\n        }\n        await this.set(key, targetNumber + numberToAdd);\n        return targetNumber + numberToAdd;\n    }\n    /**\n     * Trừ giá trị khỏi một key dạng number.\n     *\n     * Nếu key chưa tồn tại, giá trị mặc định sẽ là `0`.\n     *\n     * @template P Key path trong database.\n     *\n     * @param key Đường dẫn dữ liệu dạng number.\n     * @param numberToSubtract Số cần trừ.\n     *\n     * @returns Giá trị mới sau khi trừ.\n     *\n     * @example\n     * ```ts\n     * await db.subtract(\"economy.users.123.balance\", 20);\n     * ```\n     */\n    public async subtract<P extends AutocompletableString<ObjectPath<V>>>(key: AutocompletableString<P>, numberToSubtract: number): Promise<number> {\n        const targetNumber = await this.get(key) as any ?? 0;\n\n        if (!isNumber(targetNumber)) {\n            throw new BlackCatError(\"INVALID_TARGET\", \"number\", typeOf(targetNumber));\n        }\n        if (numberToSubtract === undefined) {\n            throw new BlackCatError(\"REQUIRED_PARAMETER_MISSING\", \"numberToSubtract\");\n        }\n        if (!isNumber(numberToSubtract)) {\n            throw new BlackCatError(\"INVALID_TYPE\", \"numberToSubtract\", \"number\", typeOf(numberToSubtract));\n        }\n        await this.set(key, targetNumber - numberToSubtract as any);\n        return targetNumber - numberToSubtract;\n    }\n    /**\n     * Thêm một hoặc nhiều phần tử vào cuối array tại key-path.\n     *\n     * Method này sẽ:\n     * - kiểm tra target có phải array không\n     * - chỉ thêm các giá trị **chưa tồn tại** trong array\n     *\n     * ⚠️ Nếu key không tồn tại hoặc target không phải array\n     * thì sẽ ném lỗi.\n     *\n     * @template P Key path trong database.\n     *\n     * @param key Đường dẫn tới array cần thêm phần tử.\n     * @param values Một hoặc nhiều giá trị cần thêm.\n     *\n     * @returns Array sau khi thêm phần tử.\n     *\n     * @example\n     * ```ts\n     * await db.push(\"users.123.roles\", \"admin\");\n     * ```\n     *\n     * @example\n     * ```ts\n     * await db.push(\"queue.songs\", song1, song2);\n     * ```\n     */\n    public async push<P extends ObjectPath<V>>(key: AutocompletableString<P>, ...values: RestOrArray<ExtractFromArray<ObjectValue<V, P>>>): Promise<ExtractFromArray<ObjectValue<V, P>>[]> {\n        if (!values.length) {\n            throw new BlackCatError(\"REQUIRED_PARAMETER_MISSING\", \"values\");\n        }\n        const root = await this.all() as any;\n        const pathParts = key.split(\".\");\n        let target = root as any;\n        for (let i = 0; i < pathParts.length; i++) {\n            const part = pathParts[i];\n            if (!(part in target)) {\n                throw new BlackCatError(\"INVALID_KEY\", key);\n            }\n            if (i === pathParts.length - 1) {\n                if (!Array.isArray(target[part])) {\n                    throw new BlackCatError(\"INVALID_TARGET\", \"array\", typeOf(target[part]));\n                }\n                const uniqueValues = (values as any[]).filter(v => !target[part].includes(v));\n                target[part].push(...uniqueValues);\n            } else {\n                target = target[part];\n            }\n        };\n        const topKey = pathParts[0];\n        await this.set(topKey, root[topKey]);\n        return target[pathParts[pathParts.length - 1]];\n    }\n    /**\n     * Thay thế phần tử trong array theo index.\n     *\n     * @typeParam P - Path trỏ đến array.\n     *\n     * @param key - Đường dẫn array.\n     * @param targetArrayElementIndex - Index cần thay.\n     * @param value - Giá trị mới.\n     *\n     * @returns Array sau khi thay thế.\n     *\n     * @throws BlackCatError\n     * - INVALID_TYPE nếu index không phải number\n     * - REQUIRED_PARAMETER_MISSING nếu thiếu value\n     * - INVALID_KEY nếu path không tồn tại\n     * - INVALID_TARGET nếu target không phải array\n     *\n     * @example\n     * await db.pull(\"users\", 0, { id: 2 });\n     */\n    public async pull<P extends AutocompletableString<ObjectPath<V>>>(key: AutocompletableString<P>, targetArrayElementIndex: number, value: ExtractFromArray<ObjectValue<V, P>>,): Promise<ExtractFromArray<ObjectValue<V, P>>[]> {\n        if (!isNumber(targetArrayElementIndex)) {\n            throw new BlackCatError(\"INVALID_TYPE\", \"targetArrayElementIndex\", \"number\", typeOf(targetArrayElementIndex));\n        };\n        if (value === undefined) {\n            throw new BlackCatError(\"REQUIRED_PARAMETER_MISSING\", \"value\");\n        };\n        const root = await this.all() as any;\n        const pathParts = key.split(\".\");\n        let target: any = root;\n        for (let i = 0; i < pathParts.length; i++) {\n            const part = pathParts[i];\n            if (!(part in target)) {\n                throw new BlackCatError(\"INVALID_KEY\", `Path \"${key}\" does not exist`);\n            }\n            if (i === pathParts.length - 1) {\n                if (!Array.isArray(target[part])) {\n                    throw new BlackCatError(\"INVALID_TARGET\", \"array\", typeOf(target[part]));\n                };\n                const arr = target[part];\n                const index = targetArrayElementIndex >= 0 ? targetArrayElementIndex : arr.length + targetArrayElementIndex;\n                if (index < 0 || index >= arr.length) {\n                    console.error(`Index ${targetArrayElementIndex} is out of bounds`);\n                };\n                arr[index] = value;\n            } else {\n                target = target[part];\n            };\n        };\n        await this.set(pathParts[0], root[pathParts[0]]);\n        return target[pathParts[pathParts.length - 1]];\n    }\n    /**\n     * Xóa phần tử khỏi array theo index.\n     *\n     * Có thể truyền nhiều index hoặc một array index.\n     *\n     * @typeParam P - Path trỏ đến array.\n     *\n     * @param key - Đường dẫn array.\n     * @param targetArrayElementIndexes - Các index cần xóa.\n     *\n     * @returns Danh sách phần tử đã bị xóa.\n     *\n     * @throws BlackCatError\n     * - INVALID_TARGET nếu target không phải array\n     * - REQUIRED_PARAMETER_MISSING nếu thiếu index\n     * - ONE_OR_MORE_ARRAY_TYPES_INVALID nếu index không phải number\n     *\n     * @example\n     * await db.pop(\"users\", 0);\n     * await db.pop(\"numbers\", [1, 2, 3]);\n     */\n    public async pop<P extends AutocompletableString<ObjectPath<V>>>(key: AutocompletableString<P>, ...targetArrayElementIndexes: RestOrArray<ExtractFromArray<number>>): Promise<ExtractFromArray<ObjectValue<V, P>>[]> {\n        const targetArray = await this.get(key) ?? [];\n\n        if (!Array.isArray(targetArray)) {\n            throw new BlackCatError(\"INVALID_TARGET\", \"array\", typeOf(targetArray));\n        };\n\n        if (!targetArrayElementIndexes.length) {\n            throw new BlackCatError(\"REQUIRED_PARAMETER_MISSING\", \"targetArrayElementIndex\");\n        };\n        const indexes = Array.isArray(targetArrayElementIndexes[0]) ? (targetArrayElementIndexes[0] as number[]) : (targetArrayElementIndexes as number[]);\n        if (indexes.some(index => !isNumber(index))) {\n            throw new BlackCatError(\"ONE_OR_MORE_ARRAY_TYPES_INVALID\", \"targetArrayElementIndexes\", \"number\", createTypesArray(indexes));\n        };\n\n        const sortedIndexes = [...indexes].sort((a, b) => b - a);\n        const removedElements: any[] = [];\n\n        for (const index of sortedIndexes) {\n            const removed = targetArray.splice(index, 1);\n            removedElements.push(...removed);\n        };\n\n        const parentPath = key.split(\".\").slice(0, -1).join(\".\") as AutocompletableString<any>;\n        const fieldName = key.split(\".\").slice(-1)[0];\n\n        if (parentPath) {\n            const parentObject = await this.get(parentPath) as Record<string, any> ?? {};\n            parentObject[fieldName] = targetArray;\n            await this.set(parentPath, parentObject as NonNullable<Exclude<ObjectValue<V, P>, undefined>>);\n        } else {\n            await this.set(key, targetArray as NonNullable<Exclude<ObjectValue<V, P>, undefined>>);\n        };\n        return removedElements;\n    }\n    /**\n     * Kiểm tra xem giá trị tại key có phải là Array hay không.\n     *\n     * @typeParam P - Path của object trong database.\n     * @param key - Đường dẫn key cần kiểm tra.\n     *\n     * @returns `true` nếu giá trị là Array, ngược lại `false`.\n     *\n     * @example\n     * const result = await db.isTargetArray(\"users\");\n     * console.log(result);\n     */\n    public async isTargetArray<P extends AutocompletableString<ObjectPath<V>>>(key: AutocompletableString<P>): Promise<boolean> {\n        const target = await this.get(key);\n        return Array.isArray(target);\n    }\n    /**\n     * Kiểm tra xem giá trị tại key có phải là Number hay không.\n     *\n     * @typeParam P - Path của object trong database.\n     *\n     * @param key - Đường dẫn key cần kiểm tra.\n     *\n     * @returns `true` nếu giá trị là Number, ngược lại `false`.\n     *\n     * @example\n     * const result = await db.isTargetNumber(\"stats.score\");\n     * console.log(result);\n     */\n    public async isTargetNumber<P extends AutocompletableString<ObjectPath<V>>>(key: AutocompletableString<P>): Promise<boolean> {\n        const target = await this.get(key);\n        return isNumber(target);\n    }\n    /**\n     * Lấy danh sách các key của object trong database.\n     *\n     * Nếu không truyền `key` → trả về các key cấp cao nhất của database.\n     *\n     * @typeParam P - Path của object.\n     *\n     * @param key - Path của object cần lấy danh sách key.\n     *\n     * @returns Mảng các key tồn tại (không bao gồm `null` hoặc `undefined`).\n     *\n     * @example\n     * const rootKeys = await db.keys();\n     * const userKeys = await db.keys(\"user\");\n     */\n    public async keys<P extends AutocompletableString<ObjectPath<V>>>(key?: P): Promise<ObjectPath<P>[]> {\n        const all = await this.all() as any;\n        if (!key) return TypedObject.keys(all) as ObjectPath<P>[];\n        const data = await this.get(key) as Record<string, any>;\n        return TypedObject.keys(data).filter((key) => data[key] !== undefined && data[key] !== null) as any\n    }\n    /**\n     * Lấy số lượng key cấp cao nhất trong database.\n     *\n     * @returns Tổng số key ở root level.\n     *\n     * @example\n     * const count = await db.size();\n     */\n    public async size(): Promise<number> {\n        const keys = await this.keys();\n        return keys.length;\n    }\n    /**\n     * Lấy danh sách các giá trị từ database.\n     *\n     * Nếu không truyền `key` → trả về toàn bộ values ở root level.\n     * Nếu truyền `key` → trả về values của object tại path đó.\n     *\n     * @typeParam P - Path của object trong database.\n     *\n     * @param key - Đường dẫn object cần lấy values.\n     *\n     * @returns Mảng các giá trị.\n     *\n     * @example\n     * const allValues = await db.values();\n     *\n     * const userValues = await db.values(\"users\");\n     */\n    public async values<P extends AutocompletableString<ObjectPath<V>>>(key?: P): Promise<ObjectValue<V, P>[]> {\n        const all = await this.all() as any;\n        if (!key) return TypedObject.values(all);\n        const data = await this.get(key) as Record<string, any>;\n        return TypedObject.values(data) as ObjectValue<V, P>[];\n    }\n    /**\n     * Lấy ngẫu nhiên một phần tử từ array tại path được chỉ định.\n     *\n     * @typeParam P - Path trỏ đến array trong database.\n     *\n     * @param key - Đường dẫn đến array.\n     *\n     * @returns Một phần tử ngẫu nhiên trong array hoặc `null` nếu array rỗng.\n     *\n     * @throws BlackCatError\n     * - INVALID_TARGET nếu giá trị tại key không phải array\n     *\n     * @example\n     * const randomUser = await db.random(\"users\");\n     */\n    public async random<P extends AutocompletableString<ObjectPath<V>>>(key: AutocompletableString<P>): Promise<Maybe<ObjectValue<V, P>>> {\n        const array = await this.get(key);\n        if (!Array.isArray(array)) {\n            throw new BlackCatError(\"INVALID_TARGET\", \"array\", typeOf(array));\n        }\n        return array[Math.floor(Math.random() * array.length)] ?? null;\n    }\n    /**\n     * Tìm phần tử đầu tiên thỏa điều kiện.\n     *\n     * Hoạt động tương tự `Array.prototype.find`.\n     *\n     * @param queryFunction - Hàm kiểm tra điều kiện.\n     *\n     * @returns Phần tử đầu tiên thỏa điều kiện hoặc `null` nếu không tìm thấy.\n     *\n     * @example\n     * const user = await db.find(u => u.id === 1);\n     */\n    public async find(queryFunction: QueryFunction<V>): Promise<Maybe<V>> {\n        const values = await this.values();\n        return values.find(queryFunction as QueryFunction<ObjectValue<V, any>>) as Promise<Maybe<V>> ?? null;\n    }\n    /**\n     * Biến đổi tất cả giá trị trong database thành một mảng mới.\n     *\n     * Hoạt động giống `Array.prototype.map`.\n     *\n     * @typeParam TReturnType - Kiểu dữ liệu của phần tử trả về.\n     *\n     * @param queryFunction - Hàm transform từng phần tử.\n     *\n     * @returns Mảng kết quả sau khi transform.\n     *\n     * @example\n     * const names = await db.map(user => user.name);\n     */\n    public async map<TReturnType>(queryFunction: QueryFunction<V, TReturnType>): Promise<TReturnType[]> {\n        const values = await this.values();\n        return values.map(queryFunction as QueryFunction<ObjectValue<V, any>, TReturnType>);\n    }\n    /**\n     * Tìm index của phần tử đầu tiên thỏa điều kiện.\n     *\n     * Hoạt động giống `Array.prototype.findIndex`.\n     *\n     * @param queryFunction - Hàm kiểm tra điều kiện.\n     *\n     * @returns Index của phần tử hoặc `-1` nếu không tìm thấy.\n     *\n     * @example\n     * const index = await db.findIndex(user => user.id === 1);\n     */\n    public async findIndex(queryFunction: QueryFunction<V>): Promise<number> {\n        const values = await this.values();\n        return values.findIndex(queryFunction as QueryFunction<ObjectValue<V, any>>);\n    }\n    /**\n     * Lọc các phần tử thỏa điều kiện.\n     *\n     * Hoạt động giống `Array.prototype.filter`.\n     *\n     * @param queryFunction - Hàm kiểm tra điều kiện.\n     *\n     * @returns Mảng các phần tử thỏa điều kiện.\n     *\n     * @example\n     * const admins = await db.filter(user => user.role === \"admin\");\n     */\n    public async filter(queryFunction: QueryFunction<V>): Promise<V[]> {\n        const values = await this.values();\n        return values.filter(queryFunction as QueryFunction<ObjectValue<V, any>>) as any;\n    }\n    /**\n     * Kiểm tra có ít nhất một phần tử thỏa điều kiện hay không.\n     *\n     * Hoạt động giống `Array.prototype.some`.\n     *\n     * @param queryFunction - Hàm kiểm tra điều kiện.\n     *\n     * @returns `true` nếu tồn tại phần tử thỏa điều kiện.\n     *\n     * @example\n     * const hasAdmin = await db.some(user => user.role === \"admin\");\n     */\n    public async some(queryFunction: QueryFunction<V>): Promise<boolean> {\n        const values = await this.values();\n        return values.some(queryFunction as QueryFunction<ObjectValue<V, any>>);\n    }\n    /**\n     * Kiểm tra tất cả phần tử có thỏa điều kiện hay không.\n     *\n     * Hoạt động giống `Array.prototype.every`.\n     *\n     * @param queryFunction - Hàm kiểm tra điều kiện.\n     *\n     * @returns `true` nếu tất cả phần tử đều thỏa điều kiện.\n     *\n     * @example\n     * const allActive = await db.every(user => user.active === true);\n     */\n    public async every(queryFunction: QueryFunction<V>): Promise<boolean> {\n        const values = await this.values();\n        return values.every(queryFunction as QueryFunction<ObjectValue<V, any>>);\n    }\n}","import { promises as fs } from \"fs\";\nimport { DatabaseDriver } from \"../types\";\n\n/**\n * Cấu hình khởi tạo cho {@link JSONDriver}.\n */\ninterface JSONDriverOptions {\n    /**\n     * Đường dẫn tới file JSON dùng làm database.\n     *\n     * Ví dụ:\n     * ```ts\n     * \"./database.json\"\n     * \"./data/users.json\"\n     * ```\n     */\n    filePath: string;\n    /**\n     * Nếu bật, nội dung JSON sẽ được **minify**\n     * (không format khoảng trắng) để giảm dung lượng file.\n     *\n     * Nếu tắt, JSON sẽ được format với indentation để dễ đọc.\n     *\n     * @default false\n     */\n    minifyJSON?: boolean;\n}\n\n/**\n * Driver lưu trữ dữ liệu dạng JSON.\n *\n * ⚠️ Đây **không phải database hoàn chỉnh**.\n * Class này chỉ đóng vai trò **driver lưu trữ (storage layer)**\n * cho class chính `Database`.\n *\n * Toàn bộ logic xử lý key path (`a.b.c`), validate dữ liệu,\n * và các thao tác database sẽ được thực hiện trong class `Database`.\n *\n * `JSONDriver` chỉ chịu trách nhiệm:\n *\n * - Đọc dữ liệu từ file JSON\n * - Ghi dữ liệu xuống file JSON\n * \n * @example  \n * ```ts\n * const database = new Database({\n *      driber: new JSONDriver({\\\n *          filePath: \"./database.json\",\n *          minifyJSON: false\n *      })\n * });\n * ```\n */\nexport class JSONDriver implements DatabaseDriver {\n    /**\n     * Đường dẫn tới file database JSON.\n     */\n    private filePath: string;\n    /**\n     * Cho biết có minify JSON khi ghi file hay không.\n     */\n    public minifyJSON: boolean;\n    /**\n     * Khởi tạo một instance mới của {@link JSONDriver}.\n     *\n     * @param options - Cấu hình driver\n     *\n     * @param options.filePath\n     * Đường dẫn tới file JSON dùng làm database.\n     *\n     * @param options.minifyJSON\n     * Nếu `true`, nội dung JSON sẽ được minify khi ghi ra file để giảm dung lượng.\n     *\n     * @example\n     * ```ts\n     * const database = new Database({\n     *      driver: db = new JSONDriver({\n     *          filePath: \"./database.json\"\n     *      })\n     * });\n     * ```\n     */\n    constructor(options: JSONDriverOptions) {\n        this.filePath = options.filePath || \"database.json\";\n        this.minifyJSON = options.minifyJSON || false;\n\n    }\n    /**\n     * Đảm bảo file database tồn tại.\n     * Nếu file chưa tồn tại sẽ tự động tạo file `{}`.\n     */\n    private async ensureFile(): Promise<void> {\n        try {\n            await fs.access(this.filePath);\n        } catch {\n            await fs.writeFile(this.filePath, \"{}\");\n        }\n    }\n    /**\n     * Đọc toàn bộ dữ liệu từ file database JSON.\n     *\n     * Nếu file không tồn tại hoặc lỗi parse,\n     * method sẽ trả về object rỗng.\n     *\n     * @template V Kiểu dữ liệu database.\n     * @returns Promise chứa toàn bộ dữ liệu database.\n     */\n    public async all<V>(): Promise<V> {\n        await this.ensureFile();\n        return fs.readFile(this.filePath, \"utf-8\").then((content) => JSON.parse(content) as V).catch((error) => {\n            console.error(`Không thể đọc file database: ${this.filePath}`, error);\n            return {} as V;\n        });\n    }\n    /**\n     * Ghi toàn bộ dữ liệu database xuống file JSON.\n     *\n     * Method này **không xử lý key path**.\n     * Logic cập nhật dữ liệu sẽ được xử lý ở class `Database`\n     * trước khi truyền object hoàn chỉnh vào đây.\n     *\n     * @param data Toàn bộ dữ liệu database sau khi đã được cập nhật.\n     *\n     * @template R Kiểu dữ liệu database.\n     * @returns Promise chứa dữ liệu đã ghi.\n     */\n    public async set<R = any>(data: R): Promise<R> {\n        await this.ensureFile();\n        await fs.writeFile(this.filePath, JSON.stringify(data, null, this.minifyJSON ? undefined : \"\\t\"));\n        return data;\n    }\n    /**\n     * Xóa toàn bộ database.\n     *\n     * Method này chỉ reset file JSON về `{}`.\n     *\n     * @returns `true` nếu reset thành công.\n     */\n    public async delete(): Promise<boolean> {\n        await this.ensureFile();\n        await fs.writeFile(this.filePath, \"{}\");\n        return true;\n    }\n}","import { DatabaseDriver } from \"../types\";\n\n/**\n * Driver lưu trữ dữ liệu trong RAM.\n *\n * ⚠️ Đây **không phải database chính**.\n * Class này chỉ là **storage driver phụ trợ** cho class `Database`.\n *\n * Toàn bộ logic xử lý:\n * - key path (`a.b.c`)\n * - validation\n * - update dữ liệu\n *\n * đều được thực hiện trong class `Database`.\n *\n * `MemoryDriver` chỉ chịu trách nhiệm:\n * - lưu trữ object database trong RAM\n * - trả về toàn bộ dữ liệu\n *\n * Dữ liệu sẽ **mất khi ứng dụng restart**.\n *\n * Phù hợp cho:\n * - testing\n * - cache runtime\n * - development\n * \n * @example\n * ```ts\n * const database = new Database({\n *      driver: new MemoryDriver({\n *          users: {},\n *          guilds: {},\n *          settings: {\n *              prefix: \"!\"\n *          }\n *      })\n * });\n * ```\n * \n *  hoặc \n * \n * ```ts\n * const database = new Database({\n *     driver: new MemoryDriver()\n * });\n * ```\n */\nexport class MemoryDriver implements DatabaseDriver {\n    /**\n     * Object chứa toàn bộ dữ liệu database trong RAM.\n     */\n    private store: Record<string, any>;\n    /**\n     * Khởi tạo MemoryDriver.\n     *\n     * @param initialData Dữ liệu khởi tạo ban đầu.\n     * * @example\n     * ```ts\n     * const database = new Database({\n     *      driver: new MemoryDriver({\n     *          users: {},\n     *          guilds: {},\n     *          settings: {\n     *              prefix: \"!\"\n     *          }\n     *      })\n     * });\n     * ```\n     * \n     *  hoặc \n     * \n     * ```ts\n     * const database = new Database({\n     *     driver: new MemoryDriver()\n     * });\n     * ```\n     */\n    constructor(initialData: Record<string, any> = {}) {\n        this.store = initialData;\n    }\n    /**\n     * Trả về toàn bộ dữ liệu database.\n     *\n     * @template T Kiểu dữ liệu database.\n     */\n    public async all<T = any>(): Promise<T> {\n        return this.store as T;\n    }\n    /**\n     * Ghi toàn bộ database vào memory.\n     *\n     * ⚠️ Method này **không xử lý key-path**.\n     * Dữ liệu đã được xử lý trước bởi `Database`.\n     *\n     * @param data Toàn bộ database object\n     */\n    public async set<T = any>(data: T): Promise<T> {\n        this.store = data as any;\n        return data;\n    }\n    /**\n     * Xóa toàn bộ dữ liệu database trong memory.\n     */\n    public async delete(): Promise<boolean> {\n        this.store = {};\n        return true;\n    }\n}","import SQLite from \"better-sqlite3\";\nimport { DatabaseDriver } from \"../types\";\n\n/**\n * Các tùy chọn cấu hình cho SQLiteDriver.\n * @hidden\n *\n * Interface này định nghĩa các thiết lập được sử dụng khi\n * khởi tạo driver SQLite cho hệ thống database.\n */\ninterface SQLiteDriverOptions {\n    /**\n     * Đường dẫn đến file cơ sở dữ liệu SQLite.\n     *\n     * Nếu không được cung cấp, driver có thể tạo\n     * một file database mặc định tùy theo cách triển khai.\n     *\n     * Ví dụ:\n     * `\"./database.sqlite\"`\n     */\n    filePath?: string;\n    /**\n     * Tên bảng được sử dụng để lưu trữ dữ liệu key-value.\n     *\n     * Nếu không được chỉ định, driver có thể sử dụng\n     * một tên bảng mặc định (ví dụ: `\"data\"`).\n     *\n     * Ví dụ:\n     * `\"storage\"`\n     */\n    table?: string;\n}\n/**\n * Driver lưu trữ dữ liệu bằng SQLite.\n *\n * ⚠️ Đây **không phải database chính**.\n * Class này chỉ là **driver lưu trữ phụ trợ** cho `Database`.\n *\n * Logic xử lý dữ liệu như:\n * - parse key path\n * - update object\n * - validation\n *\n * sẽ được thực hiện bởi class `Database`.\n *\n * Driver này chỉ:\n * - serialize database thành JSON\n * - lưu JSON vào SQLite\n * - trả về JSON khi đọc\n *\n * Toàn bộ database được lưu trong **một row duy nhất**.\n * \n * @example\n * ```ts\n * const database = new Database({\n *      driver: new SQLiteDriver({\n *         filePath: \"database.sqlite\",\n *         table: \"json_store\"\n *      })\n * })\n * ```\n */\nexport class SQLiteDriver implements DatabaseDriver {\n    /**\n     * SQLite database instance.\n     */\n    private db: SQLite.Database;\n    /**\n     * Tên table lưu trữ dữ liệu JSON.\n     */\n    private table: string;\n    /**\n     * Khởi tạo SQLiteDriver.\n     *\n     * @param filePath Đường dẫn file SQLite\n     * @param table Tên table lưu JSON database\n     * @example\n     * ```ts\n     * const database = new Database({\n     *      driver: new SQLiteDriver({\n     *         filePath: \"database.sqlite\",\n     *         table: \"json_store\"\n     *      })\n     * })\n     * ```\n     */\n    constructor(options: SQLiteDriverOptions = {}) {\n        this.db = new SQLite(options.filePath ?? \"database.sqlite\");\n        this.table = options.table ?? \"json_store\";\n        this.db.prepare(`CREATE TABLE IF NOT EXISTS ${this.table} (id INTEGER PRIMARY KEY, data TEXT)`).run();\n        const row = this.db.prepare(`SELECT * FROM ${this.table} WHERE id = 1`).get();\n        if (!row) {\n            this.db.prepare(`INSERT INTO ${this.table} (id, data) VALUES (1, '{}')`).run();\n        }\n    }\n    /**\n     * Lấy toàn bộ dữ liệu database từ SQLite.\n     *\n     * @template T Kiểu dữ liệu database.\n     */\n    public async all<T = any>(): Promise<T> {\n        const row = this.db.prepare(`SELECT data FROM ${this.table} WHERE id = 1`).get() as { data: string };\n        return JSON.parse(row.data) as T;\n    }\n    /**\n     * Ghi toàn bộ database vào SQLite.\n     *\n     * ⚠️ Method này **không xử lý key-path**.\n     * `Database` đã cập nhật object trước khi truyền vào đây.\n     *\n     * @param data Toàn bộ database object\n     */\n    public async set<T = any>(data: T): Promise<T> {\n        this.db.prepare(`UPDATE ${this.table} SET data = ? WHERE id = 1`).run(JSON.stringify(data));\n        return data;\n    }\n    /**\n     * Reset toàn bộ database.\n     */\n    public async delete(): Promise<boolean> {\n        this.db.prepare(`UPDATE ${this.table} SET data = '{}' WHERE id = 1`).run();\n        return true;\n    }\n}","import { MongoClient, Db, Collection } from \"mongodb\";\nimport type { DatabaseDriver } from \"../types\";\n\n\n/**\n * Context được truyền vào callback `onLoad` của MongoDriver.\n * @hidden\n */\ninterface MongoDriverOnLoadContext {\n    /**\n     * Instance MongoClient đã kết nối.\n     */\n    client: MongoClient;\n    /**\n     * Database hiện tại.\n     */\n    db: Db;\n    /**\n     * Collection đang được sử dụng.\n     */\n    collection: Collection<DatabaseDocument>;\n    /**\n     * Tên database.\n     */\n    databaseName: string;\n    /**\n     * Tên collection.\n     */\n    collectionName: string;\n}\n\n/**\n * Context được truyền vào callback `onError` của MongoDriver.\n * @hidden\n */\ninterface MongoDriverOnErrorContext {\n    /**\n     * Lỗi phát sinh.\n     *\n     * Có thể là bất kỳ kiểu nào (`unknown`),\n     * nên cần type guard hoặc cast khi xử lý.\n     */\n    error: unknown;\n    /**\n     * Tên database tại thời điểm xảy ra lỗi.\n     */\n    databaseName: string;\n    /**\n     * Tên collection tại thời điểm xảy ra lỗi.\n     */\n    collectionName: string;\n}\n\n/**\n * Cấu hình cho MongoDriver.\n */\ninterface MongoDriverOptions {\n    /**\n     * Chuỗi kết nối MongoDB.\n     *\n     * @default \"mongodb://localhost:27017\"\n     */\n    mongourl?: string;\n    /**\n     * Tên database MongoDB.\n     *\n     * @default \"database\"\n     */\n    databaseName?: string;\n    /**\n     * Tên collection lưu dữ liệu JSON.\n     *\n     * @default \"json_store\"\n     */\n    collectionName?: string;\n    /**\n     * Callback khi kết nối thành công.\n     */\n    onLoad?: (ctx: MongoDriverOnLoadContext) => any;\n    /**\n     * Callback khi xảy ra lỗi.\n     */\n    onError?: (ctx: MongoDriverOnErrorContext) => any;\n}\n/**\n * Schema document dùng để lưu trữ database trong MongoDB.\n */\ninterface DatabaseDocument<V = any> {\n    _id: string;\n    data: V;\n}\n/**\n * Driver lưu trữ dữ liệu bằng MongoDB.\n *\n * ⚠️ Đây **không phải database chính**.\n * Class này chỉ là **driver lưu trữ phụ trợ** cho class `Database`.\n *\n * Logic xử lý:\n * - parse key path\n * - validate dữ liệu\n * - cập nhật object\n *\n * sẽ được xử lý bởi class `Database`.\n *\n * `MongoDriver` chỉ chịu trách nhiệm:\n * - lưu toàn bộ database object\n * - trả về database object\n *\n * Toàn bộ database được lưu trong **một document duy nhất**.\n * \n * @example \n * ```ts\n * import { Database, MongoDriver } from \"blackcat.js-database\";\n * \n * const database = new Database({ \n *      driver: new MongoDriver({\n *          mongourl: \"mongodb://localhost:27017\", \n *          databaseName: \"mydb\",  \n *          collectionName: \"store\",\n *          onLoad: ({ db, collection, databaseName }) => {\n *              console.log(`✅ Đã kết nối với cơ sở dữ liệu: ${databaseName}`);\n *              console.log(`📦 Bộ sưu tập: ${collection.collectionName}`);\n *          }, \n *          onError: ({ error, databaseName }) => {\n *              console.error(`❌ Không thể kết nối với cơ sở dữ liệu: ${databaseName}`);\n *              console.error(error);\n *          }\n *      })\n * });\n * ```\n */\n\nexport class MongoDriver implements DatabaseDriver {\n    /**\n     * MongoDB client instance.\n     */\n    private client: MongoClient;\n    /**\n     * MongoDB database instance.\n     */\n    private db!: Db;\n    /**\n     * Collection lưu dữ liệu JSON.\n     */\n    private collection!: Collection<DatabaseDocument>;\n    /**\n     * Tên database MongoDB.\n     */\n    private databaseName: string;\n    /**\n     * Tên collection MongoDB.\n     */\n    private collectionName: string;\n    /**\n     * Callback khi kết nối thành công.\n     */\n    onLoad?: (ctx: MongoDriverOnLoadContext) => any;\n    /**\n     * Callback khi xảy ra lỗi.\n     */\n    onError?: (ctx: MongoDriverOnErrorContext) => any;\n    /**\n     * Trạng thái đã gọi onLoad chưa (tránh spam)\n     */\n    private isLoaded = false;\n    /**\n     * Khởi tạo MongoDriver.\n     *\n     * @param options Cấu hình MongoDB driver.\n     * \n     * @example \n     * ```ts\n     * import { Database, MongoDriver } from \"blackcat.js-database\";\n     * \n     * const database = new Database({ \n     *      driver: new MongoDriver({\n     *          mongourl: \"mongodb://localhost:27017\", \n     *          databaseName: \"mydb\",  \n     *          collectionName: \"store\",\n     *          onLoad: ({ db, collection, databaseName }) => {\n     *              console.log(`✅ Đã kết nối với cơ sở dữ liệu: ${databaseName}`);\n     *              console.log(`📦 Bộ sưu tập: ${collection.collectionName}`);\n     *          },\n     *          onError: ({ error, databaseName }) => {\n     *              console.error(`❌ Không thể kết nối với cơ sở dữ liệu: ${databaseName}`); \n     *              console.error(error);\n     *          }\n     *      })\n     * });\n     */\n    constructor(options: MongoDriverOptions = {}) {\n        const {\n            mongourl = \"mongodb://localhost:27017\",\n            databaseName = \"database\",\n            collectionName = \"json_store\"\n        } = options;\n        this.client = new MongoClient(mongourl);\n        this.databaseName = databaseName;\n        this.collectionName = collectionName;\n        this.onLoad = options.onLoad;\n        this.onError = options.onError;\n    }\n    /**\n     * Thiết lập kết nối MongoDB nếu chưa kết nối.\n     */\n    private async connect(): Promise<void> {\n        if (!this.db) {\n            try {\n                await this.client.connect();\n                this.db = this.client.db(this.databaseName);\n                this.collection = this.db.collection(this.collectionName);\n                const doc = await this.collection.findOne({ _id: \"database\" });\n                if (!doc) {\n                    await this.collection.insertOne({\n                        _id: \"database\",\n                        data: {}\n                    });\n                }\n                if (!this.isLoaded) {\n                    this.isLoaded = true;\n                    this.onLoad?.({\n                        client: this.client,\n                        db: this.db,\n                        collection: this.collection,\n                        databaseName: this.databaseName,\n                        collectionName: this.collectionName\n                    });\n                }\n            } catch (error) {\n                this.onError?.({\n                    error: error,\n                    databaseName: this.databaseName,\n                    collectionName: this.collectionName\n                });\n                throw error;\n            }\n        }\n    }\n    /**\n     * Lấy toàn bộ dữ liệu database từ MongoDB.\n     */\n    public async all<T = any>(): Promise<T> {\n        await this.connect();\n        const doc = await this.collection.findOne({ _id: \"database\" });\n        return (doc?.data ?? {}) as T;\n    }\n    /**\n     * Ghi toàn bộ database vào MongoDB.\n     *\n     * ⚠️ Method này **không xử lý key-path**.\n     * Object database đã được xử lý bởi class `Database`.\n     * \n     * @param data Toàn bộ object database\n     */\n    public async set<T = any>(data: T): Promise<T> {\n        await this.connect();\n        await this.collection.updateOne(\n            { _id: \"database\" },\n            { $set: { data } }\n        );\n        return data;\n    }\n    /**\n     * Reset toàn bộ database về object rỗng.\n     */\n    public async delete(): Promise<boolean> {\n        await this.connect();\n        await this.collection.updateOne(\n            { _id: \"database\" },\n            { $set: { data: {} } }\n        );\n        return true;\n    }\n}"],"mappings":"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","names":["key","fs","SQLite"]}