@monlite/core 0.8.0 → 0.9.0

package/README.md

@@ -525,6 +525,31 @@ db.driverName;             // "better-sqlite3" | "node:sqlite"
 
 ---
 
+## Plugins
+
+`@monlite/core` stays lean; heavier or optional capabilities are opt-in plugins
+passed to `createDb`:
+
+```ts
+import { createDb } from "@monlite/core";
+import { fts } from "@monlite/fts";
+
+const db = createDb("./app.db", {
+  plugins: [fts({ posts: ["title", "body"] })],
+});
+
+await db.collection("posts").search("hello world"); // full-text search
+```
+
+| Plugin | Adds |
+|---|---|
+| [`@monlite/fts`](https://www.npmjs.com/package/@monlite/fts) | Full-text search (SQLite FTS5) via `collection.search()` |
+
+Write your own against the `MonlitePlugin` interface (`init` / `afterWrite` /
+`collectionMethods` hooks).
+
+---
+
 ## Drivers & zero dependencies
 
 monlite talks to SQLite through a tiny driver adapter, so it runs on two

package/dist/index.cjs

@@ -952,9 +952,11 @@ var Collection = class {
     ).run(...values);
     this.afterWrite([id]);
   }
-  /** @internal Notify reactivity watchers that documents changed. */
+  /** @internal Notify reactivity watchers and plugins that documents changed. */
   afterWrite(ids) {
+    if (ids.length === 0) return;
     this.mon.reactor.emit(this.name, ids);
+    this.mon.firePluginAfterWrite(this.name, ids);
   }
   /* ----------------------------- create ----------------------------- */
   async create(args) {
@@ -1888,6 +1890,7 @@ var Monlite = class {
   /** @internal Sync metadata store; present only when `{ sync: true }`. */
   $sync;
   collections = /* @__PURE__ */ new Map();
+  plugins;
   closed = false;
   constructor(filename, options = {}) {
     this.driver = createDriver(filename, {
@@ -1905,6 +1908,15 @@ var Monlite = class {
     if (options.sync) {
       this.$sync = new SyncStore(this.driver, options.nodeId, this);
     }
+    this.plugins = options.plugins ?? [];
+    for (const plugin of this.plugins) plugin.init?.(this);
+  }
+  /** @internal Notify plugins that documents changed (post-commit). */
+  firePluginAfterWrite(collection, ids) {
+    if (this.plugins.length === 0 || ids.length === 0) return;
+    for (const plugin of this.plugins) {
+      plugin.afterWrite?.(this, { collection, ids });
+    }
   }
   /** Stable node id for LWW tie-breaking (only when sync is enabled). */
   get nodeId() {
@@ -1930,6 +1942,13 @@ var Monlite = class {
     if (!col) {
       col = new Collection(this, name, options);
       this.collections.set(name, col);
+      for (const plugin of this.plugins) {
+        for (const [method, impl] of Object.entries(
+          plugin.collectionMethods ?? {}
+        )) {
+          col[method] = (...args) => impl(col, ...args);
+        }
+      }
     } else if (options?.schema) {
       const requested = Object.keys(options.schema);
       const existing = new Set(col.columnNames);