@naveenadi/mnemonic 0.1.0

package/dist/store/collections.d.ts

@@ -0,0 +1,23 @@
+import type { MnemonicDB } from './database.js';
+import type { CollectionConfig, CollectionInfo } from '../types.js';
+export declare class CollectionStore {
+    private db;
+    constructor(db: MnemonicDB);
+    /** Add or update a collection */
+    upsert(name: string, config: CollectionConfig): void;
+    /** Remove a collection */
+    remove(name: string): void;
+    /** Get a collection by name */
+    get(name: string): CollectionInfo | undefined;
+    /** List all collections */
+    list(): CollectionInfo[];
+    /** Rename a collection */
+    rename(oldName: string, newName: string): void;
+    /** Set includeByDefault */
+    setInclude(name: string, include: boolean): void;
+    /** Set update command */
+    setUpdateCmd(name: string, cmd: string | null): void;
+    /** Get names of collections included by default */
+    getDefaultNames(): string[];
+}
+//# sourceMappingURL=collections.d.ts.map

package/dist/store/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/store/collections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEpE,qBAAa,eAAe;IACd,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,UAAU;IAElC,iCAAiC;IACjC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAqCpD,0BAA0B;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI1B,+BAA+B;IAC/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IA0B7C,2BAA2B;IAC3B,IAAI,IAAI,cAAc,EAAE;IAwBxB,0BAA0B;IAC1B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAM9C,2BAA2B;IAC3B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAMhD,yBAAyB;IACzB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAMpD,mDAAmD;IACnD,eAAe,IAAI,MAAM,EAAE;CAM5B"}

package/dist/store/collections.js

@@ -0,0 +1,99 @@
+export class CollectionStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Add or update a collection */
+    upsert(name, config) {
+        const existing = this.db.db
+            .prepare('SELECT name FROM collections WHERE name = ?')
+            .get(name);
+        if (existing) {
+            this.db.db
+                .prepare(`UPDATE collections SET path = ?, glob_pattern = ?, ignore_pattern = ?,
+           include_by_default = ?, update_cmd = ?, last_modified = datetime('now')
+           WHERE name = ?`)
+                .run(config.path, config.pattern ?? '**/*.md', config.ignore?.join('\n') ?? null, config.includeByDefault !== false ? 1 : 0, config.updateCommand ?? null, name);
+        }
+        else {
+            this.db.db
+                .prepare(`INSERT INTO collections (name, path, glob_pattern, ignore_pattern, include_by_default, update_cmd)
+           VALUES (?, ?, ?, ?, ?, ?)`)
+                .run(name, config.path, config.pattern ?? '**/*.md', config.ignore?.join('\n') ?? null, config.includeByDefault !== false ? 1 : 0, config.updateCommand ?? null);
+        }
+    }
+    /** Remove a collection */
+    remove(name) {
+        this.db.db.prepare('DELETE FROM collections WHERE name = ?').run(name);
+    }
+    /** Get a collection by name */
+    get(name) {
+        const row = this.db.db
+            .prepare(`SELECT c.*,
+                (SELECT COUNT(*) FROM documents WHERE collection = c.name) as doc_count,
+                (SELECT COUNT(*) FROM documents WHERE collection = c.name AND docid IN
+                  (SELECT DISTINCT docid FROM chunks)) as active_count,
+                (SELECT COUNT(*) FROM contexts WHERE collection = c.name) as context_count
+         FROM collections c WHERE c.name = ?`)
+            .get(name);
+        if (!row)
+            return undefined;
+        return {
+            name: row.name,
+            path: row.path,
+            globPattern: row.glob_pattern,
+            docCount: Number(row.doc_count),
+            activeCount: Number(row.active_count),
+            lastModified: row.last_modified ?? '',
+            includeByDefault: row.include_by_default === 1,
+            contextCount: Number(row.context_count),
+        };
+    }
+    /** List all collections */
+    list() {
+        const rows = this.db.db
+            .prepare(`SELECT c.*,
+                (SELECT COUNT(*) FROM documents WHERE collection = c.name) as doc_count,
+                (SELECT COUNT(*) FROM documents WHERE collection = c.name AND docid IN
+                  (SELECT DISTINCT docid FROM chunks)) as active_count,
+                (SELECT COUNT(*) FROM contexts WHERE collection = c.name) as context_count
+         FROM collections c ORDER BY c.name`)
+            .all();
+        return rows.map((r) => ({
+            name: r.name,
+            path: r.path,
+            globPattern: r.glob_pattern,
+            docCount: Number(r.doc_count),
+            activeCount: Number(r.active_count),
+            lastModified: r.last_modified ?? '',
+            includeByDefault: r.include_by_default === 1,
+            contextCount: Number(r.context_count),
+        }));
+    }
+    /** Rename a collection */
+    rename(oldName, newName) {
+        this.db.db
+            .prepare('UPDATE collections SET name = ? WHERE name = ?')
+            .run(newName, oldName);
+    }
+    /** Set includeByDefault */
+    setInclude(name, include) {
+        this.db.db
+            .prepare('UPDATE collections SET include_by_default = ? WHERE name = ?')
+            .run(include ? 1 : 0, name);
+    }
+    /** Set update command */
+    setUpdateCmd(name, cmd) {
+        this.db.db
+            .prepare('UPDATE collections SET update_cmd = ?, last_modified = datetime(\'now\') WHERE name = ?')
+            .run(cmd, name);
+    }
+    /** Get names of collections included by default */
+    getDefaultNames() {
+        const rows = this.db.db
+            .prepare('SELECT name FROM collections WHERE include_by_default = 1 ORDER BY name')
+            .all();
+        return rows.map((r) => r.name);
+    }
+}
+//# sourceMappingURL=collections.js.map

package/dist/store/collections.js.map

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

package/dist/store/database.d.ts

@@ -0,0 +1,22 @@
+import Database from 'better-sqlite3';
+import type { CollectionConfig, StoreOptions } from '../types.js';
+export declare class MnemonicDB {
+    db: Database.Database;
+    private dbPath;
+    constructor(dbPath: string);
+    /** Initialize schema */
+    init(): void;
+    /** Load sqlite-vec extension */
+    loadVectors(): Promise<void>;
+    /** Check if vector index exists */
+    hasVectorIndex(): boolean;
+    /** Create vector table with given dimension */
+    createVectorTable(dim: number): void;
+    /** Close database */
+    close(): void;
+    /** Get database file path */
+    getPath(): string;
+}
+/** Load collection config from YAML or inline options */
+export declare function loadConfig(options: StoreOptions): Record<string, CollectionConfig>;
+//# sourceMappingURL=database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/store/database.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAItC,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA0IlE,qBAAa,UAAU;IACd,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAO1B,wBAAwB;IACxB,IAAI,IAAI,IAAI;IAIZ,gCAAgC;IAC1B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IASlC,mCAAmC;IACnC,cAAc,IAAI,OAAO;IASzB,+CAA+C;IAC/C,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAcpC,qBAAqB;IACrB,KAAK,IAAI,IAAI;IAIb,6BAA6B;IAC7B,OAAO,IAAI,MAAM;CAGlB;AAED,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAclF"}

package/dist/store/database.js

@@ -0,0 +1,209 @@
+import Database from 'better-sqlite3';
+import { readFileSync, existsSync } from 'node:fs';
+import { parse as parseYaml } from 'yaml';
+/** SQLite schema: all tables and indices */
+const SCHEMA = `
+-- Collections: indexed directories with name and glob patterns
+CREATE TABLE IF NOT EXISTS collections (
+  name TEXT PRIMARY KEY,
+  path TEXT NOT NULL,
+  glob_pattern TEXT NOT NULL DEFAULT '**/*.md',
+  ignore_pattern TEXT,
+  include_by_default INTEGER NOT NULL DEFAULT 1,
+  update_cmd TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  last_modified TEXT
+);
+
+-- Documents: files with content hash, title, path, metadata
+CREATE TABLE IF NOT EXISTS documents (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  docid TEXT NOT NULL UNIQUE,
+  collection TEXT NOT NULL,
+  path TEXT NOT NULL,
+  full_path TEXT NOT NULL,
+  title TEXT NOT NULL,
+  content TEXT NOT NULL,
+  checksum TEXT NOT NULL,
+  size INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  indexed_at TEXT NOT NULL DEFAULT (datetime('now')),
+  frontmatter TEXT,
+  tags TEXT,
+  modified_at TEXT,
+  FOREIGN KEY (collection) REFERENCES collections(name) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_docs_collection ON documents(collection);
+CREATE INDEX IF NOT EXISTS idx_docs_path ON documents(collection, path);
+
+-- FTS5 full-text index
+CREATE VIRTUAL TABLE IF NOT EXISTS documents_fts USING fts5(
+  title,
+  content,
+  heading,
+  content=documents,
+  content_rowid=id,
+  tokenize='porter unicode61'
+);
+
+-- Triggers to keep FTS in sync
+CREATE TRIGGER IF NOT EXISTS docs_ai AFTER INSERT ON documents BEGIN
+  INSERT INTO documents_fts(rowid, title, content, heading)
+  VALUES (new.id, new.title, new.content, COALESCE(
+    (SELECT heading FROM chunks WHERE docid = new.docid AND seq = 0 LIMIT 1),
+    new.title
+  ));
+END;
+
+CREATE TRIGGER IF NOT EXISTS docs_ad AFTER DELETE ON documents BEGIN
+  INSERT INTO documents_fts(documents_fts, rowid, title, content, heading)
+  VALUES ('delete', old.id, old.title, old.content, '');
+END;
+
+CREATE TRIGGER IF NOT EXISTS docs_au AFTER UPDATE ON documents BEGIN
+  INSERT INTO documents_fts(documents_fts, rowid, title, content, heading)
+  VALUES ('delete', old.id, old.title, old.content, '');
+  INSERT INTO documents_fts(rowid, title, content, heading)
+  VALUES (new.id, new.title, new.content, COALESCE(
+    (SELECT heading FROM chunks WHERE docid = new.docid AND seq = 0 LIMIT 1),
+    new.title
+  ));
+END;
+
+-- Chunks: document splits for embedding
+CREATE TABLE IF NOT EXISTS chunks (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  docid TEXT NOT NULL,
+  seq INTEGER NOT NULL,
+  pos INTEGER NOT NULL DEFAULT 0,
+  content TEXT NOT NULL,
+  heading TEXT NOT NULL DEFAULT '',
+  checksum TEXT NOT NULL,
+  FOREIGN KEY (docid) REFERENCES documents(docid) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_chunks_docid ON chunks(docid);
+
+-- Context: hierarchical metadata tree
+CREATE TABLE IF NOT EXISTS contexts (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  collection TEXT,
+  path TEXT NOT NULL,
+  context TEXT NOT NULL,
+  UNIQUE(collection, path)
+);
+
+-- Links: wikilink graph
+CREATE TABLE IF NOT EXISTS links (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  source_docid TEXT NOT NULL,
+  source_path TEXT NOT NULL,
+  target_docid TEXT,
+  target_path TEXT NOT NULL,
+  link_type TEXT NOT NULL DEFAULT 'wikilink',
+  FOREIGN KEY (source_docid) REFERENCES documents(docid) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_links_source ON links(source_docid);
+CREATE INDEX IF NOT EXISTS idx_links_target ON links(target_docid);
+CREATE INDEX IF NOT EXISTS idx_links_target_path ON links(target_path);
+
+-- Tags: manual + frontmatter
+CREATE TABLE IF NOT EXISTS tags (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  docid TEXT NOT NULL,
+  tag TEXT NOT NULL,
+  source TEXT NOT NULL DEFAULT 'manual',
+  UNIQUE(docid, tag, source),
+  FOREIGN KEY (docid) REFERENCES documents(docid) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_tags_docid ON tags(docid);
+CREATE INDEX IF NOT EXISTS idx_tags_tag ON tags(tag);
+
+-- LLM cache
+CREATE TABLE IF NOT EXISTS llm_cache (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  expires_at TEXT
+);
+
+-- Global settings
+CREATE TABLE IF NOT EXISTS settings (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+`;
+export class MnemonicDB {
+    db;
+    dbPath;
+    constructor(dbPath) {
+        this.dbPath = dbPath;
+        this.db = new Database(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+    }
+    /** Initialize schema */
+    init() {
+        this.db.exec(SCHEMA);
+    }
+    /** Load sqlite-vec extension */
+    async loadVectors() {
+        try {
+            const sqliteVec = await import('sqlite-vec');
+            sqliteVec.load(this.db);
+        }
+        catch {
+            // sqlite-vec not available, vector search disabled
+        }
+    }
+    /** Check if vector index exists */
+    hasVectorIndex() {
+        try {
+            this.db.prepare("SELECT 1 FROM vectors_vec LIMIT 1").get();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Create vector table with given dimension */
+    createVectorTable(dim) {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS vectors (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        hash TEXT NOT NULL UNIQUE,
+        embedding BLOB NOT NULL
+      );
+      CREATE VIRTUAL TABLE IF NOT EXISTS vectors_vec USING vec0(
+        hash TEXT PRIMARY KEY,
+        embedding float[${dim}]
+      );
+    `);
+    }
+    /** Close database */
+    close() {
+        this.db.close();
+    }
+    /** Get database file path */
+    getPath() {
+        return this.dbPath;
+    }
+}
+/** Load collection config from YAML or inline options */
+export function loadConfig(options) {
+    if (options.config?.collections) {
+        return options.config.collections;
+    }
+    if (options.configPath && existsSync(options.configPath)) {
+        const content = readFileSync(options.configPath, 'utf-8');
+        const parsed = parseYaml(content);
+        if (parsed.collections && typeof parsed.collections === 'object') {
+            return parsed.collections;
+        }
+    }
+    return {};
+}
+//# sourceMappingURL=database.js.map

package/dist/store/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/store/database.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C,4CAA4C;AAC5C,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqId,CAAC;AAEF,MAAM,OAAO,UAAU;IACd,EAAE,CAAoB;IACrB,MAAM,CAAS;IAEvB,YAAY,MAAc;QACxB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACtC,CAAC;IAED,wBAAwB;IACxB,IAAI;QACF,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,gCAAgC;IAChC,KAAK,CAAC,WAAW;QACf,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YAC7C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,cAAc;QACZ,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,iBAAiB,CAAC,GAAW;QAC3B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;0BAQS,GAAG;;KAExB,CAAC,CAAC;IACL,CAAC;IAED,qBAAqB;IACrB,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAED,6BAA6B;IAC7B,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAED,yDAAyD;AACzD,MAAM,UAAU,UAAU,CAAC,OAAqB;IAC9C,IAAI,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;IACpC,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,IAAI,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACzD,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAA4B,CAAC;QAC7D,IAAI,MAAM,CAAC,WAAW,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;YACjE,OAAO,MAAM,CAAC,WAA+C,CAAC;QAChE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/store/documents.d.ts

@@ -0,0 +1,68 @@
+import type { MnemonicDB } from './database.js';
+import type { DocumentResult, DocumentNotFound, ContextEntry, LinkEntry } from '../types.js';
+/** Generate 6-char docid from content hash */
+export declare function docid(content: string): string;
+/** Generate full content hash */
+export declare function contentHash(content: string): string;
+/** Extract title from content (first heading or filename) */
+export declare function extractTitle(content: string, fallback: string): string;
+/** Parse frontmatter from markdown content */
+export declare function parseFrontmatter(content: string): {
+    frontmatter: Record<string, unknown> | null;
+    body: string;
+};
+/** Extract tags from frontmatter and inline #tags */
+export declare function extractTags(frontmatter: Record<string, unknown> | null, content: string): string[];
+export declare class DocumentStore {
+    private db;
+    constructor(db: MnemonicDB);
+    /** Add or update a document */
+    upsert(collection: string, relPath: string, fullPath: string, content: string): {
+        docid: string;
+        isNew: boolean;
+        needsEmbed: boolean;
+    };
+    /** Extract wikilinks and markdown links from content */
+    private storeLinks;
+    /** Remove a document and its related data */
+    remove(docid: string): void;
+    /** Remove all documents in a collection */
+    removeCollection(name: string): void;
+    /** Get a document by path or docid */
+    get(identifier: string): DocumentResult | DocumentNotFound;
+    /** Get document body with line range */
+    getBody(identifier: string, options?: {
+        fromLine?: number;
+        maxLines?: number;
+    }): {
+        content: string;
+        totalLines: number;
+    } | DocumentNotFound;
+    /** Add context entry */
+    addContext(collection: string | null, path: string, context: string): void;
+    /** List all contexts */
+    listContexts(): ContextEntry[];
+    /** Remove a context */
+    removeContext(collection: string | null, path: string): void;
+    /** Get context chain for a document (hierarchical) */
+    getContextChain(collection: string, relPath: string): string[];
+    /** Add a manual tag */
+    addTag(docid: string, tag: string): void;
+    /** Remove a manual tag */
+    removeTag(docid: string, tag: string): void;
+    /** Get all tags */
+    getAllTags(): Array<{
+        tag: string;
+        count: number;
+    }>;
+    /** Get backlinks to a document */
+    getBacklinks(docid: string): LinkEntry[];
+    /** Get outgoing links from a document */
+    getLinks(docid: string): LinkEntry[];
+    /** Find orphan documents (no incoming or outgoing links) */
+    getOrphans(): Array<{
+        docid: string;
+        path: string;
+    }>;
+}
+//# sourceMappingURL=documents.d.ts.map

package/dist/store/documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/store/documents.ts"],"names":[],"mappings":"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"}