@j0hanz/memdb 1.0.1 → 1.0.3

package/README.md

@@ -1,6 +1,6 @@
 # memdb
 
-A memory-based MCP server using SQLite in-memory database.
+A SQLite-backed MCP memory server (on-disk by default, in-memory optional).
 
 [![npm version](https://img.shields.io/npm/v/@j0hanz/memdb.svg)](https://www.npmjs.com/package/@j0hanz/memdb)
 
@@ -10,17 +10,17 @@ A memory-based MCP server using SQLite in-memory database.
 
 [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/install-mcp?name=memdb&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBqMGhhbnovbWVtZGJAbGF0ZXN0Il19)
 
-## ✨ Features
+## Features
 
-| Feature                  | Description                                               |
-| :----------------------- | :-------------------------------------------------------- |
-| 🧠 **Memory Storage**    | Store text-based memories with tags and importance scores |
-| 🔍 **Full-Text Search**  | Search memories using FTS5 with relevance ranking         |
-| 🕸️ **Graph Connections** | Link memories together to create knowledge graphs         |
-| 📊 **Analytics**         | Track memory statistics and database health               |
-| 🔒 **Local Privacy**     | All data stored locally in SQLite (`data/memory.db`)      |
+| Feature           | Description                                                       |
+| :---------------- | :---------------------------------------------------------------- |
+| Memory Storage    | Store text memories with tags, importance, and type               |
+| Full-Text Search  | FTS5-backed phrase search with relevance ranking                  |
+| Graph Connections | Link memories and traverse relationships                          |
+| Stats             | Memory and relationship counts                                    |
+| Local Privacy     | All data stored locally in SQLite (`.memdb/memory.db` by default) |
 
-## 🚀 Quick Start
+## Quick Start
 
 ### VS Code / Cursor
 
@@ -35,7 +35,7 @@ Add this to your `mcpServers` configuration:
 }
 ```
 
-## 📦 Installation
+## Installation
 
 ### NPX (Recommended)
 
@@ -58,91 +58,147 @@ npm install
 npm run build
 ```
 
-## ⚙️ Configuration
+## Configuration
 
-The server uses a local SQLite database located at `data/memory.db` relative to the working directory. No environment variables are required for basic operation.
+The server uses a local SQLite database at `<cwd>/.memdb/memory.db` by default.
+The path is resolved to an absolute path unless you use `:memory:`.
 
-## 🔧 Tools
+### Environment Variables
+
+- `MEMDB_PATH`: Override the database path (`:memory:` for in-memory).
+- `MEMDB_LOG_LEVEL`: `info`, `warn`, or `error` (default: `info`).
+
+### CLI Flags
+
+- `--db <path>`: Override the database path.
+- `--memory`: Use in-memory database (`:memory:`).
+- `--log-level <level>`: `info`, `warn`, or `error`.
+
+Precedence: CLI flags > environment variables > defaults.
+
+## Tool Response Format
+
+All tools return structured JSON in both `content` and `structuredContent`.
+
+Success:
+
+```json
+{
+  "ok": true,
+  "result": { "...": "..." }
+}
+```
+
+Error:
+
+```json
+{
+  "ok": false,
+  "error": {
+    "code": "E_CODE",
+    "message": "Human-readable message"
+  }
+}
+```
+
+## Tools
 
 ### `store_memory`
 
 Store a new memory with optional tags and metadata.
 
-| Parameter    | Type     | Required | Default | Description                                     |
-| :----------- | :------- | :------- | :------ | :---------------------------------------------- |
-| `content`    | string   | ✅       | -       | The content of the memory                       |
-| `tags`       | string[] | ❌       | -       | Tags to categorize the memory                   |
-| `importance` | number   | ❌       | -       | Importance score (0-10)                         |
-| `memoryType` | string   | ❌       | -       | Type of memory (e.g., conversation, fact, rule) |
+| Parameter    | Type     | Required | Default   | Description                                |
+| :----------- | :------- | :------- | :-------- | :----------------------------------------- |
+| `content`    | string   | Yes      | -         | The content of the memory (1-100000 chars) |
+| `tags`       | string[] | No       | -         | Tags (max 100, each 1-50 chars)            |
+| `importance` | number   | No       | `0`       | Importance score (0-10)                    |
+| `memoryType` | string   | No       | `general` | Type of memory (1-50 chars)                |
+
+**Returns:** `{ id, hash, isNew }`
+
+Notes:
 
-**Returns:** The created memory object with its hash.
+- Content is deduplicated by MD5 hash. Storing the same content again returns the same hash with `isNew: false`.
 
 ### `search_memories`
 
 Full-text search with filters.
 
-| Parameter      | Type     | Required | Default | Description               |
-| :------------- | :------- | :------- | :------ | :------------------------ |
-| `query`        | string   | ✅       | -       | Search query              |
-| `limit`        | number   | ❌       | -       | Maximum number of results |
-| `tags`         | string[] | ❌       | -       | Filter by tags            |
-| `minRelevance` | number   | ❌       | -       | Minimum relevance score   |
+| Parameter      | Type     | Required | Default | Description                       |
+| :------------- | :------- | :------- | :------ | :-------------------------------- |
+| `query`        | string   | Yes      | -       | Search query (1-1000 chars)       |
+| `limit`        | number   | No       | `10`    | Maximum number of results (1-100) |
+| `tags`         | string[] | No       | -       | Filter by tags (max 50)           |
+| `minRelevance` | number   | No       | -       | Minimum relevance score (0-1)     |
 
-**Returns:** Array of matching memories.
+**Returns:** Array of search results (`Memory` + `relevance`).
 
 ### `get_memory`
 
 Retrieve a specific memory by its hash.
 
-| Parameter | Type   | Required | Default | Description            |
-| :-------- | :----- | :------- | :------ | :--------------------- |
-| `hash`    | string | ✅       | -       | MD5 hash of the memory |
+| Parameter | Type   | Required | Default | Description         |
+| :-------- | :----- | :------- | :------ | :------------------ |
+| `hash`    | string | Yes      | -       | MD5 hash (32 chars) |
 
-**Returns:** The memory object.
+**Returns:** `Memory`.
 
 ### `delete_memory`
 
 Delete a memory by its hash.
 
-| Parameter | Type   | Required | Default | Description            |
-| :-------- | :----- | :------- | :------ | :--------------------- |
-| `hash`    | string | ✅       | -       | MD5 hash of the memory |
+| Parameter | Type   | Required | Default | Description         |
+| :-------- | :----- | :------- | :------ | :------------------ |
+| `hash`    | string | Yes      | -       | MD5 hash (32 chars) |
 
-**Returns:** Confirmation of deletion.
+**Returns:** `{ deleted: true }`.
 
 ### `link_memories`
 
 Create a relationship between two memories.
 
-| Parameter      | Type   | Required | Default | Description               |
-| :------------- | :----- | :------- | :------ | :------------------------ |
-| `fromHash`     | string | ✅       | -       | Hash of the source memory |
-| `toHash`       | string | ✅       | -       | Hash of the target memory |
-| `relationType` | string | ✅       | -       | Type of relationship      |
+| Parameter      | Type   | Required | Default | Description                          |
+| :------------- | :----- | :------- | :------ | :----------------------------------- |
+| `fromHash`     | string | Yes      | -       | Hash of the source memory (32 chars) |
+| `toHash`       | string | Yes      | -       | Hash of the target memory (32 chars) |
+| `relationType` | string | Yes      | -       | Type of relationship (1-50 chars)    |
 
-**Returns:** Confirmation of link creation.
+**Returns:** `{ linked: true }`.
 
 ### `get_related`
 
 Get memories related to a given memory.
 
-| Parameter      | Type   | Required | Default | Description                 |
-| :------------- | :----- | :------- | :------ | :-------------------------- |
-| `hash`         | string | ✅       | -       | Hash of the memory          |
-| `relationType` | string | ❌       | -       | Filter by relationship type |
-| `depth`        | number | ❌       | -       | Traversal depth (1-3)       |
+| Parameter      | Type   | Required | Default | Description                   |
+| :------------- | :----- | :------- | :------ | :---------------------------- |
+| `hash`         | string | Yes      | -       | Hash of the memory (32 chars) |
+| `relationType` | string | No       | -       | Filter by relationship type   |
+| `depth`        | number | No       | `1`     | Traversal depth (1-3)         |
 
-**Returns:** Array of related memories.
+**Returns:** Array of related memories (`Memory` + `relation_type`, `depth`).
 
 ### `memory_stats`
 
-Get database statistics and health information.
+Get database statistics.
 
 _No parameters required._
 
-**Returns:** Database statistics (count, size, etc.).
+**Returns:** `{ memoryCount, relationshipCount }`.
 
-## 🔌 Client Configuration
+### Memory Fields
+
+All memory-shaped responses include:
+
+- `id`: integer ID
+- `content`: original content string
+- `summary`: optional summary (currently unset by tools)
+- `importance`: integer 0-10
+- `memory_type`: string
+- `created_at`: timestamp string
+- `accessed_at`: timestamp string
+- `hash`: MD5 hash
+
+## Client Configuration
 
 <details>
 <summary><b>VS Code</b></summary>
@@ -191,33 +247,68 @@ Add to your `claude_desktop_config.json`:
 
 </details>
 
-## 🛠️ Development
+## Limits & Constraints
+
+| Constraint                    | Value         | Description                                              |
+| :---------------------------- | :------------ | :------------------------------------------------------- |
+| **Max content length**        | 100,000 chars | Maximum characters in memory content                     |
+| **Max query length**          | 1,000 chars   | Maximum characters in search query                       |
+| **Max search results**        | 100           | Maximum results returned from `search_memories`          |
+| **Default search limit**      | 10            | Default `limit` for `search_memories`                    |
+| **Max tags per memory**       | 100           | Maximum number of tags when storing a memory             |
+| **Max tag length**            | 50 chars      | Maximum characters per tag                               |
+| **Max tags in search filter** | 50            | Maximum tags when filtering search results               |
+| **Max related memories**      | 1,000         | Maximum results from `get_related` queries               |
+| **Max traversal depth**       | 3             | Maximum depth for relationship traversal                 |
+| **Importance range**          | 0-10          | Allowed range for `importance`                           |
+| **Min relevance range**       | 0-1           | Allowed range for `minRelevance`                         |
+| **Hash length**               | 32 chars      | MD5 hash length                                          |
+| **Search mode**               | Phrase        | Search uses phrase matching (FTS5 operators are escaped) |
+
+### Notes
+
+- **Content deduplication**: Memories are deduplicated using MD5 hashes.
+- **Search errors**: If FTS5 is unavailable, `search_memories` returns an error indicating the index is missing. Invalid query syntax returns an error with details.
+- **Local storage**: All data is stored locally in `.memdb/memory.db` unless `:memory:` is used.
+
+## Development
 
 ### Prerequisites
 
-- Node.js >= 22.0.0
+- Node.js >= 22.0.0 (required for `node:sqlite`)
 
 ### Scripts
 
-| Command         | Description                        |
-| :-------------- | :--------------------------------- |
-| `npm run build` | Compile TypeScript to `dist/`      |
-| `npm run dev`   | Run in development mode with watch |
-| `npm run test`  | Run tests                          |
-| `npm run lint`  | Run ESLint                         |
+| Command                   | Description                                |
+| :------------------------ | :----------------------------------------- |
+| `npm run clean`           | Remove `dist/`                             |
+| `npm run build`           | Compile TypeScript to `dist/`              |
+| `npm run dev`             | Run in development mode with watch         |
+| `npm run start`           | Run compiled server (`node dist/index.js`) |
+| `npm run test`            | Run tests                                  |
+| `npm run test:coverage`   | Run tests with coverage                    |
+| `npm run lint`            | Run ESLint                                 |
+| `npm run format`          | Format code with Prettier                  |
+| `npm run format:check`    | Check code formatting                      |
+| `npm run type-check`      | TypeScript type checking                   |
+| `npm run type-check:test` | Type-check tests only                      |
+| `npm run maintainability` | Generate maintainability report            |
+| `npm run duplication`     | Run duplication report (jscpd)             |
+| `npm run bench:memory`    | Run memory-service benchmark               |
+| `npm run inspector`       | Run MCP inspector                          |
 
 ### Project Structure
 
 ```text
 src/
-├── index.ts          # Entry point
-├── core/             # Database and memory service
-├── tools/            # Tool implementations
-├── schemas/          # Zod input/output schemas
-├── lib/              # Utility functions
-└── utils/            # Config and logger
+|-- index.ts          # Entry point
+|-- core/             # Database and memory service
+|-- tools/            # Tool implementations
+|-- schemas/          # Zod input/output schemas
+|-- lib/              # Error helpers
+`-- utils/            # Config and logger
 ```
 
-## 🤝 Contributing
+## Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request.

package/dist/core/database.d.ts

@@ -1,9 +1,4 @@
 import { DatabaseSync } from 'node:sqlite';
-export declare class DatabaseManager {
-    private db;
-    constructor();
-    private init;
-    getDb(): DatabaseSync;
-}
-export declare const dbManager: DatabaseManager;
+export declare const db: DatabaseSync;
+export declare const closeDb: () => void;
 //# sourceMappingURL=database.d.ts.map

package/dist/core/database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/core/database.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAe;;IAYzB,OAAO,CAAC,IAAI;IA8EL,KAAK,IAAI,YAAY;CAG7B;AAED,eAAO,MAAM,SAAS,iBAAwB,CAAC"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/core/database.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAwE3C,eAAO,MAAM,EAAE,cAAqD,CAAC;AAKrE,eAAO,MAAM,OAAO,QAAO,IAG1B,CAAC"}

package/dist/core/database.js

@@ -2,86 +2,77 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { DatabaseSync } from 'node:sqlite';
 import { config } from '../utils/config.js';
-export class DatabaseManager {
-    db;
-    constructor() {
-        const dbDir = path.dirname(config.dbPath);
-        if (!fs.existsSync(dbDir)) {
-            fs.mkdirSync(dbDir, { recursive: true });
-        }
-        this.db = new DatabaseSync(config.dbPath, { timeout: 5000 });
-        this.init();
-    }
-    init() {
-        this.db.exec('PRAGMA journal_mode = WAL');
-        this.db.exec('PRAGMA synchronous = NORMAL');
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS memories (
-        id INTEGER PRIMARY KEY AUTOINCREMENT,
-        content TEXT NOT NULL,
-        summary TEXT,
-        importance INTEGER DEFAULT 0,
-        memory_type TEXT DEFAULT 'general',
-        created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-        accessed_at TEXT DEFAULT CURRENT_TIMESTAMP,
-        hash TEXT UNIQUE NOT NULL
-      ) STRICT;
-    `);
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS tags (
-        memory_id INTEGER NOT NULL,
-        tag TEXT NOT NULL,
-        PRIMARY KEY (memory_id, tag),
-        FOREIGN KEY (memory_id) REFERENCES memories(id) ON DELETE CASCADE
-      ) STRICT;
-    `);
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS relationships (
-        id INTEGER PRIMARY KEY AUTOINCREMENT,
-        from_memory_id INTEGER NOT NULL,
-        to_memory_id INTEGER NOT NULL,
-        relation_type TEXT NOT NULL,
-        created_at TEXT DEFAULT CURRENT_TIMESTAMP,
-        FOREIGN KEY (from_memory_id) REFERENCES memories(id) ON DELETE CASCADE,
-        FOREIGN KEY (to_memory_id) REFERENCES memories(id) ON DELETE CASCADE,
-        UNIQUE(from_memory_id, to_memory_id, relation_type)
-      ) STRICT;
-    `);
-        // FTS5
-        const ftsRow = this.db
-            .prepare("SELECT count(*) as count FROM sqlite_master WHERE type='table' AND name='memories_fts'")
-            .get();
-        const ftsExists = ftsRow?.count ?? 0;
-        if (ftsExists === 0) {
-            this.db.exec(`
-          CREATE VIRTUAL TABLE memories_fts USING fts5(
-            content,
-            summary,
-            content_rowid='id'
-          );
-        `);
-            this.db.exec(`
-          CREATE TRIGGER memories_ai AFTER INSERT ON memories BEGIN
-            INSERT INTO memories_fts(rowid, content, summary)
-            VALUES (new.id, new.content, new.summary);
-          END;
-        `);
-            this.db.exec(`
-          CREATE TRIGGER memories_au AFTER UPDATE ON memories BEGIN
-            DELETE FROM memories_fts WHERE rowid = old.id;
-            INSERT INTO memories_fts(rowid, content, summary) VALUES (new.id, new.content, new.summary);
-          END;
-        `);
-            this.db.exec(`
-          CREATE TRIGGER memories_ad AFTER DELETE ON memories BEGIN
-            DELETE FROM memories_fts WHERE rowid = old.id;
-          END;
-        `);
-        }
-    }
-    getDb() {
-        return this.db;
-    }
+const SCHEMA_SQL = `
+  PRAGMA foreign_keys = ON;
+  PRAGMA journal_mode = WAL;
+  PRAGMA synchronous = NORMAL;
+
+  CREATE TABLE IF NOT EXISTS memories (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    content TEXT NOT NULL,
+    summary TEXT,
+    importance INTEGER DEFAULT 0,
+    memory_type TEXT DEFAULT 'general',
+    created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+    accessed_at TEXT DEFAULT CURRENT_TIMESTAMP,
+    hash TEXT UNIQUE NOT NULL
+  ) STRICT;
+
+  CREATE TABLE IF NOT EXISTS tags (
+    memory_id INTEGER NOT NULL,
+    tag TEXT NOT NULL,
+    PRIMARY KEY (memory_id, tag),
+    FOREIGN KEY (memory_id) REFERENCES memories(id) ON DELETE CASCADE
+  ) STRICT;
+
+  CREATE INDEX IF NOT EXISTS idx_tags_tag_memory_id ON tags(tag, memory_id);
+
+  CREATE TABLE IF NOT EXISTS relationships (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    from_memory_id INTEGER NOT NULL,
+    to_memory_id INTEGER NOT NULL,
+    relation_type TEXT NOT NULL,
+    created_at TEXT DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (from_memory_id) REFERENCES memories(id) ON DELETE CASCADE,
+    FOREIGN KEY (to_memory_id) REFERENCES memories(id) ON DELETE CASCADE,
+    UNIQUE(from_memory_id, to_memory_id, relation_type)
+  ) STRICT;
+
+  CREATE VIRTUAL TABLE IF NOT EXISTS memories_fts USING fts5(
+    content,
+    summary,
+    content_rowid='id'
+  );
+
+  CREATE TRIGGER IF NOT EXISTS memories_ai AFTER INSERT ON memories BEGIN
+    INSERT INTO memories_fts(rowid, content, summary)
+    VALUES (new.id, new.content, new.summary);
+  END;
+
+  CREATE TRIGGER IF NOT EXISTS memories_au AFTER UPDATE ON memories BEGIN
+    DELETE FROM memories_fts WHERE rowid = old.id;
+    INSERT INTO memories_fts(rowid, content, summary)
+    VALUES (new.id, new.content, new.summary);
+  END;
+
+  CREATE TRIGGER IF NOT EXISTS memories_ad AFTER DELETE ON memories BEGIN
+    DELETE FROM memories_fts WHERE rowid = old.id;
+  END;
+`;
+const FTS_SYNC_SQL = `
+  INSERT INTO memories_fts(rowid, content, summary)
+  SELECT id, content, summary FROM memories
+  WHERE id NOT IN (SELECT rowid FROM memories_fts);
+`;
+if (config.dbPath !== ':memory:') {
+    fs.mkdirSync(path.dirname(config.dbPath), { recursive: true });
 }
-export const dbManager = new DatabaseManager();
+export const db = new DatabaseSync(config.dbPath, { timeout: 5000 });
+db.exec(SCHEMA_SQL);
+db.exec(FTS_SYNC_SQL);
+export const closeDb = () => {
+    if (!db.isOpen)
+        return;
+    db.close();
+};
 //# sourceMappingURL=database.js.map

package/dist/core/database.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/core/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,OAAO,eAAe;IAClB,EAAE,CAAe;IAEzB;QACE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEO,IAAI;QACV,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC1C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAE5C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;KAWZ,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;KAOZ,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;KAWZ,CAAC,CAAC;QAEH,OAAO;QACP,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE;aACnB,OAAO,CACN,wFAAwF,CACzF;aACA,GAAG,EAAmC,CAAC;QAC1C,MAAM,SAAS,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,CAAC;QAErC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;SAMV,CAAC,CAAC;YAEL,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;SAKV,CAAC,CAAC;YAEL,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;SAKV,CAAC,CAAC;YAEL,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;SAIV,CAAC,CAAC;QACP,CAAC;IACH,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC"}
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/core/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDlB,CAAC;AAEF,MAAM,YAAY,GAAG;;;;CAIpB,CAAC;AAEF,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;IACjC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAErE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACpB,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAEtB,MAAM,CAAC,MAAM,OAAO,GAAG,GAAS,EAAE;IAChC,IAAI,CAAC,EAAE,CAAC,MAAM;QAAE,OAAO;IACvB,EAAE,CAAC,KAAK,EAAE,CAAC;AACb,CAAC,CAAC"}

package/dist/core/db-worker-client.d.ts

@@ -0,0 +1,8 @@
+import type { DbWorkerCallMap } from './db-worker-protocol.js';
+type PayloadFor<K extends keyof DbWorkerCallMap> = DbWorkerCallMap[K]['payload'];
+type ResultFor<K extends keyof DbWorkerCallMap> = DbWorkerCallMap[K]['result'];
+type ArgsFor<K extends keyof DbWorkerCallMap> = undefined extends PayloadFor<K> ? [payload?: PayloadFor<K>] : [payload: PayloadFor<K>];
+export declare const callDbWorker: <K extends keyof DbWorkerCallMap>(type: K, ...args: ArgsFor<K>) => Promise<ResultFor<K>>;
+export declare const closeDbWorker: () => Promise<void>;
+export {};
+//# sourceMappingURL=db-worker-client.d.ts.map

package/dist/core/db-worker-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-worker-client.d.ts","sourceRoot":"","sources":["../../src/core/db-worker-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,yBAAyB,CAAC;AAOjC,KAAK,UAAU,CAAC,CAAC,SAAS,MAAM,eAAe,IAC7C,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAChC,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,eAAe,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAC/E,KAAK,OAAO,CAAC,CAAC,SAAS,MAAM,eAAe,IAC1C,SAAS,SAAS,UAAU,CAAC,CAAC,CAAC,GAC3B,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,GACzB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAkE/B,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,eAAe,EAC1D,MAAM,CAAC,EACP,GAAG,MAAM,OAAO,CAAC,CAAC,CAAC,KAClB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAGtB,CAAC;AAEF,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,IAAI,CAUlD,CAAC"}

package/dist/core/db-worker-client.js

@@ -0,0 +1,67 @@
+import process from 'node:process';
+import { Worker } from 'node:worker_threads';
+let worker;
+let nextId = 1;
+const pending = new Map();
+const rejectAll = (error) => {
+    for (const entry of pending.values()) {
+        entry.reject(error);
+    }
+    pending.clear();
+};
+const handleMessage = (message) => {
+    const entry = pending.get(message.id);
+    if (!entry)
+        return;
+    pending.delete(message.id);
+    if (message.ok) {
+        entry.resolve(message.result);
+        return;
+    }
+    entry.reject(new Error(message.error.message));
+};
+const createWorker = () => {
+    const workerUrl = new URL(import.meta.url.endsWith('.ts') ? './db-worker.ts' : './db-worker.js', import.meta.url);
+    const instance = new Worker(workerUrl, { execArgv: process.execArgv });
+    instance.on('message', handleMessage);
+    instance.on('error', (error) => {
+        rejectAll(error);
+    });
+    instance.on('exit', (code) => {
+        if (code !== 0) {
+            rejectAll(new Error(`DB worker exited with code ${String(code)}`));
+        }
+        if (worker === instance) {
+            worker = undefined;
+        }
+    });
+    return instance;
+};
+const getWorker = () => {
+    worker ??= createWorker();
+    return worker;
+};
+const sendRequest = (instance, type, payload) => new Promise((resolve, reject) => {
+    const id = nextId++;
+    pending.set(id, { resolve: resolve, reject });
+    const request = (payload === undefined ? { id, type } : { id, type, payload });
+    instance.postMessage(request);
+});
+export const callDbWorker = (type, ...args) => {
+    const payload = args[0];
+    return sendRequest(getWorker(), type, payload);
+};
+export const closeDbWorker = async () => {
+    if (!worker)
+        return;
+    const instance = worker;
+    try {
+        await sendRequest(instance, 'close');
+    }
+    finally {
+        worker = undefined;
+        rejectAll(new Error('DB worker closed'));
+        await instance.terminate();
+    }
+};
+//# sourceMappingURL=db-worker-client.js.map

package/dist/core/db-worker-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-worker-client.js","sourceRoot":"","sources":["../../src/core/db-worker-client.ts"],"names":[],"mappings":"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"}