@monlite/core 0.8.0 → 0.10.0

package/README.md

@@ -525,6 +525,32 @@ 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()` |
+| [`@monlite/vector`](https://www.npmjs.com/package/@monlite/vector) | Vector / semantic search (sqlite-vec) via `collection.findSimilar()` — RAG, agent memory |
+
+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) {
@@ -1371,8 +1373,10 @@ var NodeSqliteDriver = class {
     this.verbose = options.verbose;
     const { DatabaseSync } = nodeSqlite;
     this.raw = new DatabaseSync(filename, {
-      readOnly: options.readonly ?? false
+      readOnly: options.readonly ?? false,
+      ...options.allowExtensions ? { allowExtension: true } : {}
     });
+    if (options.allowExtensions) this.raw.enableLoadExtension(true);
     this.raw.exec(`PRAGMA busy_timeout = ${options.busyTimeout ?? 5e3}`);
     if (!options.readonly && (options.wal ?? true)) {
       this.raw.exec("PRAGMA journal_mode = WAL");
@@ -1888,6 +1892,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, {
@@ -1895,6 +1900,7 @@ var Monlite = class {
       readonly: options.readonly,
       wal: options.wal,
       busyTimeout: options.busyTimeout,
+      allowExtensions: options.allowExtensions,
       verbose: options.verbose
     });
     this.autoIndexer = new AutoIndexer(
@@ -1905,6 +1911,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 +1945,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);