yolodb 1.0.0 → 1.2.0

package/README.md

@@ -30,11 +30,13 @@ Install the package:
 npm install -D yolodb
 ```
 
+Example:
+
 ```typescript
 import { yolodb } from 'yolodb'
 
 // Create a table with a primary key
-const usersTable = yolodb<User>('users.json', 'id', [])
+const usersTable = yolodb<User>('full/path/to/users.json', 'id', [])
 
 // Insert a record
 usersTable.insert({
@@ -55,13 +57,11 @@ const activeUsers = usersTable.search((user) => user.status === 'active')
 ### Use Cases
 
 - 🧪 **Testing and Development**
-
   - Mock your production database (best way is via abstractions such as repository classes)
   - Quick prototyping without database setup
   - Isolated test environments
 
 - 🎮 **Small Applications**
-
   - Simple data persistence needs
   - Prototypes and MVPs
   - Local development tools
@@ -73,6 +73,7 @@ const activeUsers = usersTable.search((user) => user.status === 'active')
 
 ### Advantages
 
+- **Quick data access**: Compared to SQL-based engines, you can easily check the data by opening the JSON files.
 - **Simple but Powerful**: Basic CRUD operations with a simple and familiar API
 - **No Configuration**: Works out of the box
 - **Type Safety**: Full TypeScript support
@@ -86,6 +87,8 @@ const activeUsers = usersTable.search((user) => user.status === 'active')
 - **Performance costs**: Reads table files on every operation, and writes to disk on every write operation
 - **Concurrency**: Basic file-based locking
 - **Scale**: Not suitable for large datasets, since data is loaded into memory
+- **Sorting, Joins and more complex queries**: Not implemented yet.
+- **Data migrations**: Not implemented, and not planned.
 
 ## API Reference
 
@@ -141,7 +144,6 @@ class DrizzleUserRepository implements UserRepository { ... }
    ```
 
 2. **Implement Repository Pattern**
-
    - Encapsulate database logic
    - Add domain-specific methods
    - Maintain clean architecture

package/dist/index.d.mts

@@ -0,0 +1,48 @@
+//#region src/yolodb.d.ts
+declare const logger: Console;
+type YoloDbDebugLogger = typeof logger.debug;
+declare class YoloDbError extends Error {
+  constructor(message: string);
+}
+type YoloDbTableOptions = {
+  superjsonEnabled?: boolean;
+  debugLogger?: YoloDbDebugLogger;
+};
+/**
+ * Simple file-based JSON database built on top of SuperJSON.
+ */
+declare class YoloDbTable<R extends Record<string, any>> {
+  private readonly tableName;
+  private readonly pkField;
+  private readonly filePath;
+  private readonly options;
+  constructor(absoluteFilePath: string, pkField: keyof R, initialData?: R[], options?: YoloDbTableOptions);
+  private get log();
+  private getData;
+  all(): R[];
+  readFile(): R[];
+  saveFile(db: R[]): void;
+  findById(id: string): R | undefined;
+  findBy(field: keyof R, value: any): R[];
+  findFirstBy(field: keyof R, value: any): R | undefined;
+  search(filterFn: (record: R) => boolean): R[];
+  insert(record: R): void;
+  insertMany(records: R[]): void;
+  update(record: Partial<R>): void;
+  updateMany(records: Array<Partial<R>>): void;
+  delete(id: string): void;
+  deleteMany(ids: string[]): void;
+  truncate(): void;
+}
+declare class YoloDbRepository<R extends Record<string, any>> {
+  protected table: YoloDbTable<R>;
+  constructor(dataPath: string, pkField: keyof R);
+}
+/**
+ * Helper function to create a new YoloDB table.
+ * It reuses the same table instance if the same file path is used.
+ */
+declare function yolodb<R extends Record<string, any>>(filePath: string, pkField: keyof R, initialData: R[], options?: YoloDbTableOptions): YoloDbTable<R>;
+//#endregion
+export { YoloDbDebugLogger, YoloDbError, YoloDbRepository, YoloDbTable, YoloDbTableOptions, yolodb };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,120 @@
+import fs from "node:fs";
+import path from "node:path";
+import superjson from "superjson";
+
+//#region src/yolodb.ts
+const logger = console;
+var YoloDbError = class extends Error {
+	constructor(message) {
+		super(`[YoloDB] ${message}`);
+		this.name = "YoloDbError";
+	}
+};
+/**
+* Simple file-based JSON database built on top of SuperJSON.
+*/
+var YoloDbTable = class {
+	constructor(absoluteFilePath, pkField, initialData = [], options) {
+		const dirName = path.dirname(absoluteFilePath);
+		if (!fs.existsSync(dirName)) fs.mkdirSync(dirName, { recursive: true });
+		this.tableName = path.basename(absoluteFilePath).replace(".json", "");
+		this.pkField = pkField;
+		this.filePath = absoluteFilePath;
+		this.options = {
+			debugLogger: (message, ctx) => logger.debug(`[YoloDB] ${this.tableName} - ${message}`, ctx),
+			superjsonEnabled: true,
+			...options
+		};
+		if (!fs.existsSync(absoluteFilePath)) this.saveFile(initialData);
+	}
+	get log() {
+		return this.options.debugLogger;
+	}
+	getData() {
+		const db = this.readFile();
+		if (!Array.isArray(db)) throw new YoloDbError(`Invalid data in ${this.filePath}`);
+		return db;
+	}
+	all() {
+		return this.getData();
+	}
+	readFile() {
+		this.log(`Reading table from ${this.filePath}`);
+		if (!fs.existsSync(this.filePath)) {
+			this.saveFile([]);
+			return [];
+		}
+		const fileContent = fs.readFileSync(this.filePath, "utf8");
+		return this.options.superjsonEnabled ? superjson.parse(fileContent) : JSON.parse(fileContent);
+	}
+	saveFile(db) {
+		this.log(`Saving table to ${this.filePath}`);
+		const serializedDb = this.options.superjsonEnabled ? JSON.stringify(superjson.serialize(db), null, 2) : JSON.stringify(db, null, 2);
+		fs.writeFileSync(this.filePath, serializedDb);
+	}
+	findById(id) {
+		return this.getData().find((record) => record[this.pkField] === id);
+	}
+	findBy(field, value) {
+		return this.getData().filter((record) => record[field] === value);
+	}
+	findFirstBy(field, value) {
+		return this.getData().find((record) => record[field] === value);
+	}
+	search(filterFn) {
+		return this.getData().filter((record) => filterFn(record));
+	}
+	insert(record) {
+		if (!record[this.pkField]) throw new YoloDbError(`Record does not have a primary key: ${this.tableName}.${String(this.pkField)}`);
+		const db = this.getData();
+		db.push(record);
+		this.saveFile(db);
+	}
+	insertMany(records) {
+		const db = this.getData();
+		db.push(...records);
+		this.saveFile(db);
+	}
+	update(record) {
+		const pk = record[this.pkField];
+		if (!pk) throw new YoloDbError(`Record not found in ${this.tableName}: ${pk}`);
+		const db = this.getData();
+		for (const currentRecord of db) if (currentRecord[this.pkField] === pk) {
+			Object.assign(currentRecord, record);
+			break;
+		}
+		this.saveFile(db);
+	}
+	updateMany(records) {
+		records.forEach((record) => this.update(record));
+	}
+	delete(id) {
+		this.deleteMany([id]);
+	}
+	deleteMany(ids) {
+		this.log(`Deleting ${ids.length} records`);
+		const db = this.getData().filter((record) => !ids.includes(record[this.pkField]));
+		this.saveFile(db);
+	}
+	truncate() {
+		this.saveFile([]);
+	}
+};
+var YoloDbRepository = class {
+	constructor(dataPath, pkField) {
+		this.table = yolodb(dataPath, pkField, []);
+	}
+};
+const _yoloDbTables = {};
+/**
+* Helper function to create a new YoloDB table.
+* It reuses the same table instance if the same file path is used.
+*/
+function yolodb(filePath, pkField, initialData, options) {
+	if (!_yoloDbTables[filePath]) _yoloDbTables[filePath] = new YoloDbTable(filePath, pkField, initialData, options);
+	return _yoloDbTables[filePath];
+}
+
+//#endregion
+export { YoloDbError, YoloDbRepository, YoloDbTable, yolodb };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/yolodb.ts"],"sourcesContent":["import fs from 'node:fs'\nimport path from 'node:path'\nimport superjson from 'superjson'\n\nconst logger = console\n\nexport type YoloDbDebugLogger = typeof logger.debug\n\nexport class YoloDbError extends Error {\n  constructor(message: string) {\n    super(`[YoloDB] ${message}`)\n    this.name = 'YoloDbError'\n  }\n}\n\nexport type YoloDbTableOptions = {\n  superjsonEnabled?: boolean\n  debugLogger?: YoloDbDebugLogger\n}\n\n/**\n * Simple file-based JSON database built on top of SuperJSON.\n */\nexport class YoloDbTable<R extends Record<string, any>> {\n  private readonly tableName: string\n  private readonly pkField: keyof R\n  private readonly filePath: string\n  private readonly options: Required<YoloDbTableOptions>\n\n  constructor(absoluteFilePath: string, pkField: keyof R, initialData: R[] = [], options?: YoloDbTableOptions) {\n    const dirName = path.dirname(absoluteFilePath)\n\n    if (!fs.existsSync(dirName)) {\n      fs.mkdirSync(dirName, { recursive: true })\n    }\n\n    this.tableName = path.basename(absoluteFilePath).replace('.json', '')\n    this.pkField = pkField\n    this.filePath = absoluteFilePath\n\n    this.options = {\n      debugLogger: (message, ctx) => logger.debug(`[YoloDB] ${this.tableName} - ${message}`, ctx),\n      superjsonEnabled: true,\n      ...options,\n    }\n\n    if (!fs.existsSync(absoluteFilePath)) {\n      this.saveFile(initialData)\n    }\n  }\n\n  private get log(): YoloDbDebugLogger {\n    return this.options.debugLogger\n  }\n\n  private getData(): R[] {\n    const db = this.readFile()\n    if (!Array.isArray(db)) {\n      throw new YoloDbError(`Invalid data in ${this.filePath}`)\n    }\n    return db\n  }\n\n  all(): R[] {\n    return this.getData()\n  }\n\n  readFile(): R[] {\n    this.log(`Reading table from ${this.filePath}`)\n\n    if (!fs.existsSync(this.filePath)) {\n      this.saveFile([])\n      return []\n    }\n\n    const fileContent = fs.readFileSync(this.filePath, 'utf8')\n    return this.options.superjsonEnabled ? superjson.parse<R[]>(fileContent) : JSON.parse(fileContent)\n  }\n\n  saveFile(db: R[]): void {\n    this.log(`Saving table to ${this.filePath}`)\n    const serializedDb = this.options.superjsonEnabled\n      ? JSON.stringify(superjson.serialize(db), null, 2)\n      : JSON.stringify(db, null, 2)\n    fs.writeFileSync(this.filePath, serializedDb)\n  }\n\n  findById(id: string): R | undefined {\n    const db = this.getData()\n    return db.find((record) => record[this.pkField] === id)\n  }\n\n  findBy(field: keyof R, value: any): R[] {\n    const db = this.getData()\n    return db.filter((record) => record[field] === value)\n  }\n\n  findFirstBy(field: keyof R, value: any): R | undefined {\n    const db = this.getData()\n    return db.find((record) => record[field] === value)\n  }\n\n  search(filterFn: (record: R) => boolean): R[] {\n    const db = this.getData()\n    return db.filter((record) => filterFn(record))\n  }\n\n  insert(record: R): void {\n    const pk = record[this.pkField]\n    if (!pk) {\n      throw new YoloDbError(`Record does not have a primary key: ${this.tableName}.${String(this.pkField)}`)\n    }\n\n    const db = this.getData()\n    db.push(record)\n\n    this.saveFile(db)\n  }\n\n  insertMany(records: R[]): void {\n    const db = this.getData()\n    db.push(...records)\n\n    this.saveFile(db)\n  }\n\n  update(record: Partial<R>): void {\n    const pk = record[this.pkField]\n    if (!pk) {\n      throw new YoloDbError(`Record not found in ${this.tableName}: ${pk}`)\n    }\n\n    const db = this.getData()\n\n    for (const currentRecord of db) {\n      if (currentRecord[this.pkField] === pk) {\n        Object.assign(currentRecord, record)\n        break\n      }\n    }\n\n    this.saveFile(db)\n  }\n\n  updateMany(records: Array<Partial<R>>): void {\n    records.forEach((record) => this.update(record))\n  }\n\n  delete(id: string): void {\n    this.deleteMany([id])\n  }\n\n  deleteMany(ids: string[]): void {\n    this.log(`Deleting ${ids.length} records`)\n    const db = this.getData().filter((record) => !ids.includes(record[this.pkField]))\n\n    this.saveFile(db)\n  }\n\n  truncate(): void {\n    this.saveFile([])\n  }\n}\n\nexport class YoloDbRepository<R extends Record<string, any>> {\n  protected table: YoloDbTable<R>\n\n  constructor(dataPath: string, pkField: keyof R) {\n    this.table = yolodb<R>(dataPath, pkField, [])\n  }\n}\n\n// In-memory cache of YoloDB table instances\nconst _yoloDbTables: Record<string, YoloDbTable<any>> = {}\n\n/**\n * Helper function to create a new YoloDB table.\n * It reuses the same table instance if the same file path is used.\n */\nexport function yolodb<R extends Record<string, any>>(\n  filePath: string,\n  pkField: keyof R,\n  initialData: R[],\n  options?: YoloDbTableOptions,\n): YoloDbTable<R> {\n  if (!_yoloDbTables[filePath]) {\n    _yoloDbTables[filePath] = new YoloDbTable<R>(filePath, pkField, initialData, options)\n  }\n  return _yoloDbTables[filePath]\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yolodb",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "homepage": "https://itsjavi.com/yolodb",
   "repository": {
     "type": "git",
@@ -10,40 +10,33 @@
   "type": "module",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.js"
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.mjs"
     }
   },
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "files": [
     "dist",
     "README.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "tsup src/index.ts --dts --sourcemap --format esm --clean",
-    "format": "sort-package-json && prettier --write ./src README.md tsconfig.json",
-    "lint": "pnpm run typecheck && prettier --check ./src README.md tsconfig.json && publint",
-    "prepare": "sort-package-json",
-    "prepublishOnly": "pnpm run lint && pnpm run build",
-    "typecheck": "tsc --noEmit"
-  },
   "dependencies": {
-    "superjson": "^2.2.2"
+    "superjson": "^2.2.6"
   },
   "devDependencies": {
-    "@types/node": "^22.13.4",
-    "prettier": "^3.5.1",
-    "publint": "^0.3.5",
-    "sort-package-json": "^2.14.0",
-    "tsup": "^8.3.6",
-    "typescript": "^5.7.3"
+    "@types/node": "^25.0.3",
+    "prettier": "^3.7.4",
+    "publint": "^0.3.16",
+    "sort-package-json": "^3.6.0",
+    "tsdown": "0.19.0-beta.2",
+    "typescript": "^5.9.3"
   },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "esbuild"
-    ]
+  "scripts": {
+    "build": "tsdown src/index.ts --dts --sourcemap --format esm --clean",
+    "format": "sort-package-json && prettier --write ./src README.md tsconfig.json",
+    "lint": "pnpm run typecheck && prettier --check ./src README.md tsconfig.json && publint",
+    "typecheck": "tsc --noEmit"
   }
-}
+}

package/dist/index.d.ts

@@ -1,44 +0,0 @@
-type YoloDbLogger = (...args: any[]) => void;
-declare class YoloDbError extends Error {
-    constructor(message: string);
-}
-type YoloDbTableOptions = {
-    logger?: YoloDbLogger;
-};
-/**
- * Simple file-based JSON database built on top of SuperJSON.
- */
-declare class YoloDbTable<R extends Record<string, any>> {
-    private readonly tableName;
-    private readonly pkField;
-    private readonly filePath;
-    private readonly options;
-    constructor(absoluteFilePath: string, pkField: keyof R, initialData?: R[], options?: YoloDbTableOptions);
-    private get log();
-    private getData;
-    all(): R[];
-    readFile(): R[];
-    saveFile(db: R[]): void;
-    findById(id: string): R | undefined;
-    findBy(field: keyof R, value: any): R[];
-    findFirstBy(field: keyof R, value: any): R | undefined;
-    search(filterFn: (record: R) => boolean): R[];
-    insert(record: R): void;
-    insertMany(records: R[]): void;
-    update(record: Partial<R>): void;
-    updateMany(records: Array<Partial<R>>): void;
-    delete(id: string): void;
-    deleteMany(ids: string[]): void;
-    truncate(): void;
-}
-declare class YoloDbRepository<R extends Record<string, any>> {
-    protected table: YoloDbTable<R>;
-    constructor(dataPath: string, pkField: keyof R);
-}
-/**
- * Helper function to create a new YoloDB table.
- * It reuses the same table instance if the same file path is used.
- */
-declare function yolodb<R extends Record<string, any>>(filePath: string, pkField: keyof R, initialData: R[], options?: YoloDbTableOptions): YoloDbTable<R>;
-
-export { YoloDbError, type YoloDbLogger, YoloDbRepository, YoloDbTable, type YoloDbTableOptions, yolodb };

package/dist/index.js

@@ -1,131 +0,0 @@
-// src/yolodb.ts
-import fs from "node:fs";
-import path from "node:path";
-import superjson from "superjson";
-var YoloDbError = class extends Error {
-  constructor(message) {
-    super(`[YoloDB] ${message}`);
-    this.name = "YoloDbError";
-  }
-};
-var YoloDbTable = class {
-  constructor(absoluteFilePath, pkField, initialData = [], options) {
-    const dirName = path.dirname(absoluteFilePath);
-    if (!fs.existsSync(dirName)) {
-      fs.mkdirSync(dirName, { recursive: true });
-    }
-    this.tableName = path.basename(absoluteFilePath).replace(".json", "");
-    this.pkField = pkField;
-    this.filePath = absoluteFilePath;
-    this.options = {
-      logger: (...args) => console.debug(`[YoloDB] ${this.tableName}`, ...args),
-      ...options
-    };
-    if (!fs.existsSync(absoluteFilePath)) {
-      this.saveFile(initialData);
-    }
-  }
-  get log() {
-    return this.options.logger;
-  }
-  getData() {
-    const db = this.readFile();
-    if (!Array.isArray(db)) {
-      throw new YoloDbError(`Invalid data in ${this.filePath}`);
-    }
-    return db;
-  }
-  all() {
-    return this.getData();
-  }
-  readFile() {
-    this.log(`Reading table from ${this.filePath}`);
-    if (!fs.existsSync(this.filePath)) {
-      this.saveFile([]);
-      return [];
-    }
-    const fileContent = fs.readFileSync(this.filePath, "utf8");
-    return superjson.parse(fileContent);
-  }
-  saveFile(db) {
-    this.log(`Saving table to ${this.filePath}`);
-    fs.writeFileSync(this.filePath, JSON.stringify(superjson.serialize(db), null, 2));
-  }
-  findById(id) {
-    const db = this.getData();
-    return db.find((record) => record[this.pkField] === id);
-  }
-  findBy(field, value) {
-    const db = this.getData();
-    return db.filter((record) => record[field] === value);
-  }
-  findFirstBy(field, value) {
-    const db = this.getData();
-    return db.find((record) => record[field] === value);
-  }
-  search(filterFn) {
-    const db = this.getData();
-    return db.filter((record) => filterFn(record));
-  }
-  insert(record) {
-    const pk = record[this.pkField];
-    if (!pk) {
-      throw new YoloDbError(`Record does not have a primary key: ${this.tableName}.${String(this.pkField)}`);
-    }
-    const db = this.getData();
-    db.push(record);
-    this.saveFile(db);
-  }
-  insertMany(records) {
-    const db = this.getData();
-    db.push(...records);
-    this.saveFile(db);
-  }
-  update(record) {
-    const pk = record[this.pkField];
-    if (!pk) {
-      throw new YoloDbError(`Record not found in ${this.tableName}: ${pk}`);
-    }
-    const db = this.getData();
-    for (const currentRecord of db) {
-      if (currentRecord[this.pkField] === pk) {
-        Object.assign(currentRecord, record);
-        break;
-      }
-    }
-    this.saveFile(db);
-  }
-  updateMany(records) {
-    records.forEach((record) => this.update(record));
-  }
-  delete(id) {
-    this.deleteMany([id]);
-  }
-  deleteMany(ids) {
-    this.log(`Deleting ${ids.length} records`);
-    const db = this.getData().filter((record) => !ids.includes(record[this.pkField]));
-    this.saveFile(db);
-  }
-  truncate() {
-    this.saveFile([]);
-  }
-};
-var YoloDbRepository = class {
-  constructor(dataPath, pkField) {
-    this.table = yolodb(dataPath, pkField, []);
-  }
-};
-var _yoloDbTables = {};
-function yolodb(filePath, pkField, initialData, options) {
-  if (!_yoloDbTables[filePath]) {
-    _yoloDbTables[filePath] = new YoloDbTable(filePath, pkField, initialData, options);
-  }
-  return _yoloDbTables[filePath];
-}
-export {
-  YoloDbError,
-  YoloDbRepository,
-  YoloDbTable,
-  yolodb
-};
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/yolodb.ts"],"sourcesContent":["import fs from 'node:fs'\nimport path from 'node:path'\nimport superjson from 'superjson'\n\nexport type YoloDbLogger = (...args: any[]) => void\n\nexport class YoloDbError extends Error {\n  constructor(message: string) {\n    super(`[YoloDB] ${message}`)\n    this.name = 'YoloDbError'\n  }\n}\n\nexport type YoloDbTableOptions = {\n  logger?: YoloDbLogger\n}\n\n/**\n * Simple file-based JSON database built on top of SuperJSON.\n */\nexport class YoloDbTable<R extends Record<string, any>> {\n  private readonly tableName: string\n  private readonly pkField: keyof R\n  private readonly filePath: string\n  private readonly options: Required<YoloDbTableOptions>\n\n  constructor(absoluteFilePath: string, pkField: keyof R, initialData: R[] = [], options?: YoloDbTableOptions) {\n    const dirName = path.dirname(absoluteFilePath)\n\n    if (!fs.existsSync(dirName)) {\n      fs.mkdirSync(dirName, { recursive: true })\n    }\n\n    this.tableName = path.basename(absoluteFilePath).replace('.json', '')\n    this.pkField = pkField\n    this.filePath = absoluteFilePath\n\n    this.options = {\n      logger: (...args) => console.debug(`[YoloDB] ${this.tableName}`, ...args),\n      ...options,\n    }\n\n    if (!fs.existsSync(absoluteFilePath)) {\n      this.saveFile(initialData)\n    }\n  }\n\n  private get log(): YoloDbLogger {\n    return this.options.logger\n  }\n\n  private getData(): R[] {\n    const db = this.readFile()\n    if (!Array.isArray(db)) {\n      throw new YoloDbError(`Invalid data in ${this.filePath}`)\n    }\n    return db\n  }\n\n  all(): R[] {\n    return this.getData()\n  }\n\n  readFile(): R[] {\n    this.log(`Reading table from ${this.filePath}`)\n\n    if (!fs.existsSync(this.filePath)) {\n      this.saveFile([])\n      return []\n    }\n\n    const fileContent = fs.readFileSync(this.filePath, 'utf8')\n    return superjson.parse<R[]>(fileContent)\n  }\n\n  saveFile(db: R[]): void {\n    this.log(`Saving table to ${this.filePath}`)\n    fs.writeFileSync(this.filePath, JSON.stringify(superjson.serialize(db), null, 2))\n  }\n\n  findById(id: string): R | undefined {\n    const db = this.getData()\n    return db.find((record) => record[this.pkField] === id)\n  }\n\n  findBy(field: keyof R, value: any): R[] {\n    const db = this.getData()\n    return db.filter((record) => record[field] === value)\n  }\n\n  findFirstBy(field: keyof R, value: any): R | undefined {\n    const db = this.getData()\n    return db.find((record) => record[field] === value)\n  }\n\n  search(filterFn: (record: R) => boolean): R[] {\n    const db = this.getData()\n    return db.filter((record) => filterFn(record))\n  }\n\n  insert(record: R): void {\n    const pk = record[this.pkField]\n    if (!pk) {\n      throw new YoloDbError(`Record does not have a primary key: ${this.tableName}.${String(this.pkField)}`)\n    }\n\n    const db = this.getData()\n    db.push(record)\n\n    this.saveFile(db)\n  }\n\n  insertMany(records: R[]): void {\n    const db = this.getData()\n    db.push(...records)\n\n    this.saveFile(db)\n  }\n\n  update(record: Partial<R>): void {\n    const pk = record[this.pkField]\n    if (!pk) {\n      throw new YoloDbError(`Record not found in ${this.tableName}: ${pk}`)\n    }\n\n    const db = this.getData()\n\n    for (const currentRecord of db) {\n      if (currentRecord[this.pkField] === pk) {\n        Object.assign(currentRecord, record)\n        break\n      }\n    }\n\n    this.saveFile(db)\n  }\n\n  updateMany(records: Array<Partial<R>>): void {\n    records.forEach((record) => this.update(record))\n  }\n\n  delete(id: string): void {\n    this.deleteMany([id])\n  }\n\n  deleteMany(ids: string[]): void {\n    this.log(`Deleting ${ids.length} records`)\n    const db = this.getData().filter((record) => !ids.includes(record[this.pkField]))\n\n    this.saveFile(db)\n  }\n\n  truncate(): void {\n    this.saveFile([])\n  }\n}\n\nexport class YoloDbRepository<R extends Record<string, any>> {\n  protected table: YoloDbTable<R>\n\n  constructor(dataPath: string, pkField: keyof R) {\n    this.table = yolodb<R>(dataPath, pkField, [])\n  }\n}\n\n// In-memory cache of YoloDB table instances\nconst _yoloDbTables: Record<string, YoloDbTable<any>> = {}\n\n/**\n * Helper function to create a new YoloDB table.\n * It reuses the same table instance if the same file path is used.\n */\nexport function yolodb<R extends Record<string, any>>(\n  filePath: string,\n  pkField: keyof R,\n  initialData: R[],\n  options?: YoloDbTableOptions,\n): YoloDbTable<R> {\n  if (!_yoloDbTables[filePath]) {\n    _yoloDbTables[filePath] = new YoloDbTable<R>(filePath, pkField, initialData, options)\n  }\n  return _yoloDbTables[filePath]\n}\n"],"mappings":"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","names":[]}