seedorm 0.2.0 → 0.3.0

package/README.md

@@ -1,10 +1,10 @@
 # seedorm
 
-Development-first ORM that lets you start with a JSON file and migrate to any SQL database by changing one line of config. No rewrites.
+Development-first ORM that lets you start with a JSON file and migrate to any SQL database by changing one line of config. No rewrites. No drama.
 
 ## Why
 
-Every project starts the same way: you need to store data, but you don't want to set up a database just to prototype. SeedORM lets you start building immediately with a local JSON file, then switch to a real database when you're ready — without changing your application code.
+Every project starts the same way: you need to store data, but you don't want to set up a database just to prototype. SeedORM lets you start building immediately with a local JSON file, then switch to a real database when you're ready. Your application code doesn't change. Not one line.
 
 ## Quick start
 
@@ -15,37 +15,41 @@ npm install seedorm
 ```typescript
 import { SeedORM, FieldType } from "seedorm";
 
-const db = new SeedORM();
-await db.connect();
-
-const User = db.model({
-  name: "User",
-  collection: "users",
-  schema: {
-    name:  { type: FieldType.String, required: true },
-    email: { type: FieldType.String, unique: true },
-    role:  { type: FieldType.String, enum: ["admin", "user"], default: "user" },
-  },
-});
-await User.init();
-
-// Create
-const alice = await User.create({ name: "Alice", email: "alice@example.com" });
-
-// Query with MongoDB-style operators
-const admins = await User.find({
-  filter: { role: { $eq: "admin" } },
-  sort: { name: 1 },
-  limit: 10,
-});
-
-// Update
-await User.update(alice.id, { role: "admin" });
-
-// Delete
-await User.delete(alice.id);
+async function main() {
+  const db = new SeedORM();
+  await db.connect();
+
+  const User = db.model({
+    name: "User",
+    collection: "users",
+    schema: {
+      name:  { type: FieldType.String, required: true },
+      email: { type: FieldType.String, unique: true },
+      role:  { type: FieldType.String, enum: ["admin", "user"], default: "user" },
+    },
+  });
+  await User.init();
+
+  // Create
+  const alice = await User.create({ name: "Alice", email: "alice@example.com" });
+
+  // Query with MongoDB-style operators
+  const admins = await User.find({
+    filter: { role: { $eq: "admin" } },
+    sort: { name: 1 },
+    limit: 10,
+  });
+
+  // Update
+  await User.update(alice.id, { role: "admin" });
+
+  // Delete
+  await User.delete(alice.id);
+
+  await db.disconnect();
+}
 
-await db.disconnect();
+main();
 ```
 
 ## Relations
@@ -87,8 +91,8 @@ const user = await User.findById("usr_abc123", {
 });
 
 // Manage many-to-many links
-await User.associate("roles", "usr_abc123", "rol_editor");
-await User.dissociate("roles", "usr_abc123", "rol_editor");
+await User.associate("usr_abc123", "roles", "rol_editor");
+await User.dissociate("usr_abc123", "roles", "rol_editor");
 ```
 
 **Relation types:** `hasOne`, `hasMany`, `belongsTo`, `manyToMany`
@@ -123,14 +127,14 @@ SeedORM exports string enums for type-safe definitions. Plain strings also work
 
 ## Features
 
-- **Zero-config start** — data lives in a JSON file, no database setup needed
-- **Schema validation** — type checking, required fields, unique constraints, min/max, enums
-- **Relations** — `hasOne`, `hasMany`, `belongsTo`, `manyToMany` with eager loading via `include`
-- **Query operators** — `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$in`, `$nin`, `$like`, `$exists`
-- **CLI tools** — `seedorm init`, `seedorm start` (REST server), `seedorm studio` (visual UI)
-- **Migration engine** — `migrate create`, `migrate up`, `migrate to` (SQL export)
-- **Pluggable adapters** — PostgreSQL built-in, MySQL and SQLite coming soon. Drivers are lazy-loaded and optional.
-- **TypeScript** — written in TypeScript with full type exports, dual CJS/ESM output
+- **Zero-config start**: data lives in a JSON file, no database setup needed
+- **Schema validation**: type checking, required fields, unique constraints, min/max, enums
+- **Relations**: `hasOne`, `hasMany`, `belongsTo`, `manyToMany` with eager loading via `include`
+- **Query operators**: `$eq`, `$ne`, `$gt`, `$gte`, `$lt`, `$lte`, `$in`, `$nin`, `$like`, `$exists`
+- **CLI tools**: `seedorm init`, `seedorm start` (REST server), `seedorm studio` (visual UI)
+- **Migration engine**: `migrate create`, `migrate up`, `migrate to` (SQL export)
+- **Pluggable adapters**: PostgreSQL built-in, MySQL and SQLite coming soon. Drivers are lazy-loaded and optional.
+- **TypeScript**: written in TypeScript with full type exports, dual CJS/ESM output
 
 ## CLI
 
@@ -165,7 +169,7 @@ When running `seedorm start`, the following endpoints are available:
 | `GET` | `/api/:collection` | List documents (supports `?filter=`, `?sort=`, `?limit=`, `?offset=`) |
 | `GET` | `/api/:collection/:id` | Get document by ID |
 | `POST` | `/api/:collection` | Create document |
-| `PATCH` | `/api/:collection/:id` | Update document |
+| `PUT/PATCH` | `/api/:collection/:id` | Update document |
 | `DELETE` | `/api/:collection/:id` | Delete document |
 
 ## Requirements
@@ -174,6 +178,14 @@ When running `seedorm start`, the following endpoints are available:
 - `pg` (optional, only needed for PostgreSQL adapter)
 - `mysql2` (optional, only needed for MySQL adapter)
 
+## Links
+
+- [Documentation](https://seedorm.io/docs)
+- [Getting Started](https://seedorm.io/docs/getting-started)
+- [API Reference](https://seedorm.io/docs/api)
+- [CLI Reference](https://seedorm.io/docs/cli)
+- [Tutorial](https://seedorm.io/docs/tutorial)
+
 ## License
 
-Apache 2.0 — see [LICENSE](./LICENSE)
+Apache 2.0

package/dist/bin/seedorm.cjs

@@ -4369,6 +4369,11 @@ var Model = class {
   }
   async init() {
     await this.adapter.createCollection(this.collection, this.schema);
+    for (const rel of Object.values(this.relations)) {
+      if (rel.type === "manyToMany" /* ManyToMany */ && rel.joinCollection) {
+        await this.adapter.createCollection(rel.joinCollection, {});
+      }
+    }
   }
   generateId() {
     return `${this.prefix}_${nanoid(12)}`;
@@ -4645,68 +4650,82 @@ var fs3 = __toESM(require("fs"), 1);
 var path3 = __toESM(require("path"), 1);
 var import_write_file_atomic = __toESM(require_lib(), 1);
 var FileEngine = class {
-  filePath;
-  data = {};
+  dirPath;
+  data = /* @__PURE__ */ new Map();
+  dirty = /* @__PURE__ */ new Set();
   writeQueue = Promise.resolve();
-  dirty = false;
-  constructor(filePath) {
-    this.filePath = path3.resolve(filePath);
+  constructor(dirPath) {
+    this.dirPath = path3.resolve(dirPath);
   }
   async load() {
-    try {
-      const raw = fs3.readFileSync(this.filePath, "utf-8");
-      this.data = JSON.parse(raw);
-    } catch (err) {
-      if (err.code === "ENOENT") {
-        this.data = {};
-        await this.flush();
-      } else {
-        throw err;
+    if (!fs3.existsSync(this.dirPath)) {
+      fs3.mkdirSync(this.dirPath, { recursive: true });
+    }
+    const legacyPath = path3.join(this.dirPath, "seedorm.json");
+    if (fs3.existsSync(legacyPath)) {
+      const raw = fs3.readFileSync(legacyPath, "utf-8");
+      const legacy = JSON.parse(raw);
+      for (const [collection, docs] of Object.entries(legacy)) {
+        this.data.set(collection, docs);
+        this.dirty.add(collection);
       }
+      await this.flush();
+      fs3.unlinkSync(legacyPath);
+      return;
+    }
+    const files = fs3.readdirSync(this.dirPath).filter((f) => f.endsWith(".json"));
+    for (const file of files) {
+      const collection = file.slice(0, -5);
+      const raw = fs3.readFileSync(path3.join(this.dirPath, file), "utf-8");
+      this.data.set(collection, JSON.parse(raw));
     }
-  }
-  getData() {
-    return this.data;
   }
   getCollection(name) {
-    if (!this.data[name]) {
-      this.data[name] = [];
+    if (!this.data.has(name)) {
+      this.data.set(name, []);
     }
-    return this.data[name];
+    return this.data.get(name);
   }
   hasCollection(name) {
-    return name in this.data;
+    return this.data.has(name);
   }
   createCollection(name) {
-    if (!this.data[name]) {
-      this.data[name] = [];
+    if (!this.data.has(name)) {
+      this.data.set(name, []);
+      this.dirty.add(name);
     }
   }
   dropCollection(name) {
-    delete this.data[name];
+    this.data.delete(name);
+    this.dirty.delete(name);
+    const filePath = path3.join(this.dirPath, `${name}.json`);
+    if (fs3.existsSync(filePath)) {
+      fs3.unlinkSync(filePath);
+    }
   }
   listCollections() {
-    return Object.keys(this.data);
+    return Array.from(this.data.keys());
   }
-  markDirty() {
-    this.dirty = true;
+  markDirty(collection) {
+    this.dirty.add(collection);
   }
   async flush() {
+    const toWrite = new Set(this.dirty);
+    this.dirty.clear();
     this.writeQueue = this.writeQueue.then(async () => {
-      const dir = path3.dirname(this.filePath);
-      if (!fs3.existsSync(dir)) {
-        fs3.mkdirSync(dir, { recursive: true });
+      for (const collection of toWrite) {
+        const docs = this.data.get(collection);
+        if (docs === void 0) continue;
+        await (0, import_write_file_atomic.default)(
+          path3.join(this.dirPath, `${collection}.json`),
+          JSON.stringify(docs)
+        );
       }
-      await (0, import_write_file_atomic.default)(
-        this.filePath,
-        JSON.stringify(this.data, null, 2) + "\n"
-      );
-      this.dirty = false;
     });
     return this.writeQueue;
   }
   async flushIfDirty() {
-    if (this.dirty) {
+    if (this.dirty.size > 0) {
       await this.flush();
     }
   }
@@ -4792,8 +4811,8 @@ var JsonAdapter = class {
   engine;
   indexer = new Indexer();
   schemas = /* @__PURE__ */ new Map();
-  constructor(filePath) {
-    this.engine = new FileEngine(filePath);
+  constructor(dirPath) {
+    this.engine = new FileEngine(dirPath);
   }
   async connect() {
     await this.engine.load();
@@ -4829,7 +4848,7 @@ var JsonAdapter = class {
     const docs = this.getCollectionOrThrow(collection);
     this.indexer.onInsert(collection, doc);
     docs.push(doc);
-    this.engine.markDirty();
+    this.engine.markDirty(collection);
     await this.engine.flush();
     return doc;
   }
@@ -4853,7 +4872,7 @@ var JsonAdapter = class {
     const newDoc = { ...oldDoc, ...data, id: oldDoc.id };
     this.indexer.onUpdate(collection, oldDoc, newDoc);
     docs[index] = newDoc;
-    this.engine.markDirty();
+    this.engine.markDirty(collection);
     await this.engine.flush();
     return newDoc;
   }
@@ -4863,7 +4882,7 @@ var JsonAdapter = class {
     if (index === -1) return false;
     this.indexer.onDelete(collection, docs[index]);
     docs.splice(index, 1);
-    this.engine.markDirty();
+    this.engine.markDirty(collection);
     await this.engine.flush();
     return true;
   }
@@ -4879,7 +4898,7 @@ var JsonAdapter = class {
     docs.length = 0;
     docs.push(...remaining);
     if (deleted > 0) {
-      this.engine.markDirty();
+      this.engine.markDirty(collection);
       await this.engine.flush();
     }
     return deleted;
@@ -4908,11 +4927,8 @@ var SeedORM = class {
   async createAdapter(adapterConfig) {
     switch (adapterConfig.adapter) {
       case "json" /* Json */: {
-        const dbPath = path4.resolve(
-          adapterConfig.path ?? "./data",
-          "seedorm.json"
-        );
-        return new JsonAdapter(dbPath);
+        const dirPath = path4.resolve(adapterConfig.path ?? "./data");
+        return new JsonAdapter(dirPath);
       }
       case "postgres" /* Postgres */: {
         const { PostgresAdapter: PostgresAdapter2 } = await Promise.resolve().then(() => (init_postgres_adapter(), postgres_adapter_exports));
@@ -5489,13 +5505,26 @@ function createApiHandler(db) {
             const limitParam = url.searchParams.get("limit");
             const offsetParam = url.searchParams.get("offset");
             const sortParam = url.searchParams.get("sort");
-            const opts = {};
-            if (filterParam) opts.filter = JSON.parse(filterParam);
-            if (limitParam) opts.limit = parseInt(limitParam, 10);
-            if (offsetParam) opts.offset = parseInt(offsetParam, 10);
-            if (sortParam) opts.sort = JSON.parse(sortParam);
-            const docs = await adapter.find(collection, opts);
-            const total = await adapter.count(collection, opts.filter);
+            const searchParam = url.searchParams.get("search");
+            const findOpts = {};
+            if (filterParam) findOpts.filter = JSON.parse(filterParam);
+            if (sortParam) findOpts.sort = JSON.parse(sortParam);
+            let allDocs = await adapter.find(collection, findOpts);
+            if (searchParam) {
+              const q = searchParam.toLowerCase();
+              allDocs = allDocs.filter(
+                (doc) => Object.values(doc).some((v) => {
+                  if (v == null) return false;
+                  const s = typeof v === "string" ? v : JSON.stringify(v);
+                  return s.toLowerCase().includes(q);
+                })
+              );
+            }
+            const total = allDocs.length;
+            const offset = offsetParam ? parseInt(offsetParam, 10) : 0;
+            const limit = limitParam ? parseInt(limitParam, 10) : void 0;
+            let docs = allDocs.slice(offset);
+            if (limit !== void 0) docs = docs.slice(0, limit);
             return json2(res, 200, { data: docs, total });
           }
           case "POST": {
@@ -5650,7 +5679,7 @@ async function studioCommand(options) {
 // src/cli/index.ts
 function createCLI() {
   const program3 = new Command();
-  program3.name("seedorm").description("Development-first ORM \u2014 start with JSON, migrate to PostgreSQL/MySQL").version("0.1.0");
+  program3.name("seedorm").description("Development-first ORM \u2014 start with JSON, migrate to PostgreSQL/MySQL").version("0.2.1");
   program3.command("init").description("Initialize a new seedorm project").option("-f, --force", "Overwrite existing config").action(initCommand);
   program3.command("start").description("Start the development REST API server").option("-p, --port <port>", "Port to listen on", "4100").action(startCommand);
   const migrate = program3.command("migrate").description("Migration commands");

package/dist/bin/static/app.js

@@ -1,6 +1,11 @@
 const API = '/api';
+const PAGE_SIZE = 50;
 let currentCollection = null;
 let currentDoc = null;
+let currentPage = 0;
+let totalDocs = 0;
+let searchQuery = '';
+let searchTimer = null;
 
 async function api(path, opts = {}) {
   const res = await fetch(`${API}${path}`, {
@@ -25,6 +30,9 @@ async function loadCollections() {
 
 async function selectCollection(name) {
   currentCollection = name;
+  currentPage = 0;
+  searchQuery = '';
+  document.getElementById('search-input').value = '';
   document.getElementById('empty-state').classList.add('hidden');
   document.getElementById('collection-view').classList.remove('hidden');
   document.getElementById('collection-name').textContent = name;
@@ -34,15 +42,21 @@ async function selectCollection(name) {
 
 async function loadDocuments() {
   if (!currentCollection) return;
-  const { data, total } = await api(`/data/${currentCollection}?limit=100`);
+  const offset = currentPage * PAGE_SIZE;
+  let url = `/data/${currentCollection}?limit=${PAGE_SIZE}&offset=${offset}`;
+  if (searchQuery) url += `&search=${encodeURIComponent(searchQuery)}`;
+
+  const { data, total } = await api(url);
+  totalDocs = total;
   document.getElementById('doc-count').textContent = `${total} documents`;
 
   const thead = document.getElementById('table-head');
   const tbody = document.getElementById('table-body');
 
   if (!data || data.length === 0) {
-    thead.innerHTML = '<th>No documents</th>';
+    thead.innerHTML = `<th>${searchQuery ? 'No matching documents' : 'No documents'}</th>`;
     tbody.innerHTML = '';
+    updatePagination();
     return;
   }
 
@@ -63,6 +77,23 @@ async function loadDocuments() {
   tbody.querySelectorAll('tr').forEach(tr => {
     tr.onclick = () => editDocument(data.find(d => d.id === tr.dataset.id));
   });
+
+  updatePagination();
+}
+
+function updatePagination() {
+  const totalPages = Math.max(1, Math.ceil(totalDocs / PAGE_SIZE));
+  const pag = document.getElementById('pagination');
+
+  if (totalPages <= 1) {
+    pag.classList.add('hidden');
+    return;
+  }
+
+  pag.classList.remove('hidden');
+  document.getElementById('page-info').textContent = `Page ${currentPage + 1} of ${totalPages}`;
+  document.getElementById('btn-prev').disabled = currentPage === 0;
+  document.getElementById('btn-next').disabled = currentPage >= totalPages - 1;
 }
 
 function editDocument(doc) {
@@ -122,5 +153,22 @@ document.getElementById('modal').onclick = (e) => {
   if (e.target === document.getElementById('modal')) closeModal();
 };
 
+document.getElementById('btn-prev').onclick = () => {
+  if (currentPage > 0) { currentPage--; loadDocuments(); }
+};
+document.getElementById('btn-next').onclick = () => {
+  const totalPages = Math.ceil(totalDocs / PAGE_SIZE);
+  if (currentPage < totalPages - 1) { currentPage++; loadDocuments(); }
+};
+
+document.getElementById('search-input').oninput = (e) => {
+  clearTimeout(searchTimer);
+  searchTimer = setTimeout(() => {
+    searchQuery = e.target.value.trim();
+    currentPage = 0;
+    loadDocuments();
+  }, 250);
+};
+
 // Initial load
 loadCollections();

package/dist/bin/static/index.html

@@ -25,12 +25,20 @@
         <div class="toolbar">
           <h2 id="collection-name"></h2>
           <span id="doc-count" class="dim"></span>
-          <button id="btn-add" class="btn">+ Add Document</button>
+          <div class="toolbar-right">
+            <input type="text" id="search-input" placeholder="Search..." autocomplete="off">
+            <button id="btn-add" class="btn">+ Add Document</button>
+          </div>
         </div>
         <table id="docs-table">
           <thead><tr id="table-head"></tr></thead>
           <tbody id="table-body"></tbody>
         </table>
+        <div id="pagination" class="pagination hidden">
+          <button id="btn-prev" class="btn">&larr; Prev</button>
+          <span id="page-info" class="dim"></span>
+          <button id="btn-next" class="btn">Next &rarr;</button>
+        </div>
       </div>
     </section>
   </main>

package/dist/bin/static/style.css

@@ -90,6 +90,27 @@ aside li.active .count { background: rgba(255,255,255,0.2); }
 
 .toolbar h2 { font-size: 1.2rem; }
 
+.toolbar-right {
+  margin-left: auto;
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+#search-input {
+  padding: 0.4rem 0.75rem;
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  color: var(--text);
+  font-size: 0.85rem;
+  width: 200px;
+  outline: none;
+}
+
+#search-input:focus { border-color: var(--accent); }
+#search-input::placeholder { color: var(--dim); }
+
 .btn {
   padding: 0.4rem 0.8rem;
   border: 1px solid var(--border);
@@ -135,6 +156,20 @@ td {
 tr:hover td { background: var(--surface); }
 tr { cursor: pointer; }
 
+.pagination {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 1rem;
+  padding: 1rem 0;
+}
+
+.pagination .btn:disabled {
+  opacity: 0.3;
+  cursor: default;
+  border-color: var(--border);
+}
+
 .hidden { display: none !important; }
 
 #empty-state {