yolodb 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Javi Aguilar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,167 @@
+# YoloDB 🚀
+
+A lightweight, file-based JSON database powered by SuperJSON for Node.js (and compatible) runtimes. Perfect for
+prototyping, testing, and when you just need a simple persistent store without the overhead of a full database system.
+
+> Because setting up databases for local development is complex and You Only Live Once!
+
+## Highlights ✨
+
+- 🔄 **Real-time file synchronization** - No stale data in multi-threaded/process environments (such as Next.js server)
+- 🎯 **SuperJSON powered** - Support for Dates, Maps, Sets, and more complex data types
+- 🛠️ **Developer friendly API** - Familiar CRUD operations with a simple, intuitive interface
+- 📦 **Zero configuration** - Just instantiate and start using
+- 🔍 **Type-safe** - Built with TypeScript for robust development
+- 🧪 **Perfect for testing** - Mock your production database with ease
+- 🔍 **Debuggable** - Easily debug your data by checking the table files
+
+## What's different compared to LowDB?
+
+- Uses superjson for serialization/deserialization, so it supports more data types like Dates, Maps, Sets, etc.
+- More intuitive interface, easier to use, closer to what would you expect from a real DB abstraction layer.
+- Read/write operations are done on-the-fly. Less performant, but you don't need to worry about stale data.
+- Comes with handy object-oriented abstractions such as `YoloDbRepository`
+
+## Quick Start
+
+Install the package:
+
+```bash
+npm install -D yolodb
+```
+
+```typescript
+import { yolodb } from 'yolodb'
+
+// Create a table with a primary key
+const usersTable = yolodb<User>('users.json', 'id', [])
+
+// Insert a record
+usersTable.insert({
+  id: '1',
+  name: 'John Doe',
+  createdAt: new Date(),
+})
+
+// Find by ID
+const user = usersTable.findById('1')
+
+// Search with custom filter
+const activeUsers = usersTable.search((user) => user.status === 'active')
+```
+
+## Why YoloDB? 🤔
+
+### 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
+
+- 📚 **Learning Best Practices**
+  - A proof that you data model is well decoupled from the persistence layer, is that it can be mocked with ease
+  - Having living proof that your data model is well designed and you can switch between different persistence engines
+    with ease
+
+### Advantages
+
+- **Simple but Powerful**: Basic CRUD operations with a simple and familiar API
+- **No Configuration**: Works out of the box
+- **Type Safety**: Full TypeScript support
+- **Complex Data Types**: Thanks to SuperJSON
+- **Real-time File Access**: Always fresh data
+- **Repository Pattern Support**: Clean architecture friendly
+
+### Limitations
+
+- **Not for Production**: Designed for development and testing
+- **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
+
+## API Reference
+
+### Table Operations
+
+```typescript
+const table = yolodb<Record>(filePath, primaryKeyField, initialData)
+
+// Basic CRUD
+table.all() // Get all records
+table.findById(id) // Find by primary key
+table.findBy(field, value) // Find by field value
+table.search(filterFn) // Custom search
+table.insert(record) // Insert single record
+table.insertMany(records) // Bulk insert
+table.update(record) // Update record
+table.updateMany(records) // Bulk update
+table.delete(id) // Delete by id
+table.deleteMany(ids) // Bulk delete
+table.truncate() // Clear all records
+```
+
+### Repository Pattern
+
+```typescript
+interface UserRepository {
+  findByUsername(username: string): User | null
+}
+
+class MockedUserRepository extends YoloDbRepository<User> implements UserRepository {
+  constructor() {
+    super("users.json", "id");
+  }
+
+  // Implement interface methods here
+}
+// Your real repository would look like this:
+class DrizzleUserRepository implements UserRepository { ... }
+```
+
+## Best Practices 🌟
+
+1. **Use Type Definitions**
+
+   ```typescript
+   interface User {
+     id: string
+     name: string
+     createdAt: Date
+   }
+
+   const usersTable = yolodb<User>('users.json', 'id', [])
+   ```
+
+2. **Implement Repository Pattern**
+
+   - Encapsulate database logic
+   - Add domain-specific methods
+   - Maintain clean architecture
+
+3. **Handle Errors**
+
+   ```typescript
+   try {
+     table.insert(record)
+   } catch (error) {
+     // Handle file system errors
+   }
+   ```
+
+4. **Clean Up Data**
+   ```typescript
+   // e.g. in your tests teardown
+   table.truncate()
+   ```
+
+---
+
+Made with ❤️ for developers who know that sometimes, you just need a simple solution.

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+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

@@ -0,0 +1,131 @@
+// 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

@@ -0,0 +1 @@
+{"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":[]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "yolodb",
+  "version": "1.0.0",
+  "homepage": "https://itsjavi.com/yolodb",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/itsjavi/yolodb.git"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "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"
+  },
+  "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"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  }
+}