mcard-js 2.1.12 → 2.1.13

package/dist/storage/SqliteWasmEngine.js

@@ -0,0 +1,193 @@
+/**
+ * SqliteWasmEngine - SQLite WASM backend using sql.js
+ *
+ * Provides full SQL support with FTS5 and same schema as Python implementation.
+ * Persistence via IndexedDB or OPFS.
+ */
+import { MCard } from '../model/MCard';
+import { validateHandle } from '../model/Handle';
+import { CORE_SCHEMAS } from './schema';
+/**
+ * SqliteWasmEngine - Full SQL support via sql.js
+ */
+export class SqliteWasmEngine {
+    db = null;
+    SQL = null;
+    /**
+     * Initialize the database
+     * @param wasmUrl URL to sql-wasm.wasm file (optional, defaults to CDN)
+     * @param existingData Optional existing database as Uint8Array
+     */
+    async init(wasmUrl, existingData) {
+        // Dynamically import sql.js
+        const initSqlJs = (await import('sql.js')).default;
+        const SQL = await initSqlJs({
+            locateFile: (file) => wasmUrl || `https://sql.js.org/dist/${file}`
+        });
+        this.SQL = SQL;
+        this.db = existingData
+            ? new SQL.Database(existingData)
+            : new SQL.Database();
+        // Create tables using shared schema definitions
+        this.db.run(CORE_SCHEMAS.card);
+        this.db.run(CORE_SCHEMAS.handleRegistry);
+        this.db.run(CORE_SCHEMAS.handleHistory);
+        this.db.run(CORE_SCHEMAS.handleIndex);
+    }
+    ensureDb() {
+        if (!this.db)
+            throw new Error('Database not initialized. Call init() first.');
+        return this.db;
+    }
+    /**
+     * Export database as Uint8Array (for persistence)
+     */
+    export() {
+        return this.ensureDb().export();
+    }
+    /**
+     * Get raw sql.js Database for use with VectorStore adapter.
+     *
+     * Example:
+     *   const vecStore = createWasmVectorStore(engine.getRawDb());
+     */
+    getRawDb() {
+        return this.ensureDb();
+    }
+    // =========== Card Operations ===========
+    async add(card) {
+        const db = this.ensureDb();
+        db.run('INSERT OR REPLACE INTO card (hash, content, g_time) VALUES (?, ?, ?)', [card.hash, card.content, card.g_time]);
+        return card.hash;
+    }
+    async get(hash) {
+        const db = this.ensureDb();
+        const result = db.exec(`SELECT hash, content, g_time FROM card WHERE hash = '${hash}'`);
+        if (result.length === 0 || result[0].values.length === 0)
+            return null;
+        const [h, content, g_time] = result[0].values[0];
+        return MCard.fromData(new Uint8Array(content), h, g_time);
+    }
+    async delete(hash) {
+        this.ensureDb().run('DELETE FROM card WHERE hash = ?', [hash]);
+    }
+    async getPage(pageNumber, pageSize) {
+        const db = this.ensureDb();
+        const totalItems = await this.count();
+        const totalPages = Math.ceil(totalItems / pageSize);
+        const offset = (pageNumber - 1) * pageSize;
+        const result = db.exec(`SELECT hash, content, g_time FROM card LIMIT ${pageSize} OFFSET ${offset}`);
+        const items = (result[0]?.values || []).map(([h, content, g_time]) => MCard.fromData(new Uint8Array(content), h, g_time));
+        return {
+            items,
+            totalItems,
+            pageNumber,
+            pageSize,
+            totalPages,
+            hasNext: pageNumber < totalPages,
+            hasPrevious: pageNumber > 1
+        };
+    }
+    async count() {
+        const result = this.ensureDb().exec('SELECT COUNT(*) FROM card');
+        return result[0]?.values[0]?.[0] || 0;
+    }
+    async searchByHash(hashPrefix) {
+        const db = this.ensureDb();
+        const stmt = db.prepare('SELECT hash, content, g_time FROM card WHERE hash LIKE ?');
+        stmt.bind([`${hashPrefix}%`]);
+        const items = [];
+        while (stmt.step()) {
+            const row = stmt.get();
+            items.push(MCard.fromData(new Uint8Array(row[1]), row[0], row[2]));
+        }
+        stmt.free();
+        return items;
+    }
+    async search(query, pageNumber, pageSize) {
+        const db = this.ensureDb();
+        const offset = (pageNumber - 1) * pageSize;
+        const pattern = `%${query}%`;
+        // Count
+        let stmt = db.prepare('SELECT COUNT(*) FROM card WHERE CAST(content AS TEXT) LIKE ?');
+        stmt.bind([pattern]);
+        stmt.step();
+        const totalItems = stmt.get()[0];
+        stmt.free();
+        const totalPages = Math.ceil(totalItems / pageSize);
+        // Query
+        stmt = db.prepare('SELECT hash, content, g_time FROM card WHERE CAST(content AS TEXT) LIKE ? LIMIT ? OFFSET ?');
+        stmt.bind([pattern, pageSize, offset]);
+        const items = [];
+        while (stmt.step()) {
+            const row = stmt.get();
+            items.push(MCard.fromData(new Uint8Array(row[1]), row[0], row[2]));
+        }
+        stmt.free();
+        return {
+            items,
+            totalItems,
+            pageNumber,
+            pageSize,
+            totalPages,
+            hasNext: pageNumber < totalPages,
+            hasPrevious: pageNumber > 1
+        };
+    }
+    async getAll() {
+        const result = this.ensureDb().exec('SELECT hash, content, g_time FROM card');
+        return (result[0]?.values || []).map(([h, content, g_time]) => MCard.fromData(new Uint8Array(content), h, g_time));
+    }
+    async clear() {
+        const db = this.ensureDb();
+        db.run('DELETE FROM card');
+        db.run('DELETE FROM handle_registry');
+        db.run('DELETE FROM handle_history');
+    }
+    // =========== Handle Operations ===========
+    async registerHandle(handle, hash) {
+        const db = this.ensureDb();
+        const normalized = validateHandle(handle);
+        const existing = db.exec(`SELECT handle FROM handle_registry WHERE handle = '${normalized}'`);
+        if (existing.length > 0 && existing[0].values.length > 0) {
+            throw new Error(`Handle '${handle}' already exists.`);
+        }
+        const now = new Date().toISOString();
+        db.run('INSERT INTO handle_registry (handle, current_hash, created_at, updated_at) VALUES (?, ?, ?, ?)', [normalized, hash, now, now]);
+    }
+    async resolveHandle(handle) {
+        const normalized = validateHandle(handle);
+        const result = this.ensureDb().exec(`SELECT current_hash FROM handle_registry WHERE handle = '${normalized}'`);
+        return result[0]?.values[0]?.[0] || null;
+    }
+    async getByHandle(handle) {
+        const hash = await this.resolveHandle(handle);
+        if (!hash)
+            return null;
+        return this.get(hash);
+    }
+    async updateHandle(handle, newHash) {
+        const db = this.ensureDb();
+        const normalized = validateHandle(handle);
+        const existing = db.exec(`SELECT current_hash FROM handle_registry WHERE handle = '${normalized}'`);
+        if (existing.length === 0 || existing[0].values.length === 0) {
+            throw new Error(`Handle '${handle}' not found.`);
+        }
+        const previousHash = existing[0].values[0][0];
+        const now = new Date().toISOString();
+        // Record history
+        db.run('INSERT INTO handle_history (handle, previous_hash, changed_at) VALUES (?, ?, ?)', [normalized, previousHash, now]);
+        // Update handle
+        db.run('UPDATE handle_registry SET current_hash = ?, updated_at = ? WHERE handle = ?', [newHash, now, normalized]);
+        return previousHash;
+    }
+    async getHandleHistory(handle) {
+        const normalized = validateHandle(handle);
+        const result = this.ensureDb().exec(`SELECT previous_hash, changed_at FROM handle_history WHERE handle = '${normalized}' ORDER BY id DESC`);
+        return (result[0]?.values || []).map(([previousHash, changedAt]) => ({
+            previousHash: previousHash,
+            changedAt: changedAt
+        }));
+    }
+}
+//# sourceMappingURL=SqliteWasmEngine.js.map

package/dist/storage/SqliteWasmEngine.js.map

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

package/dist/storage/StorageAdapter.d.ts

@@ -0,0 +1,42 @@
+import { MCard } from '../model/MCard';
+/**
+ * Page - Pagination container for query results
+ */
+export interface Page<T> {
+    items: T[];
+    totalItems: number;
+    pageNumber: number;
+    pageSize: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrevious: boolean;
+}
+/**
+ * StorageEngine - Abstract interface for storage backends
+ *
+ * Implementations: IndexedDBEngine, SqliteWasmEngine
+ */
+export interface StorageEngine {
+    add(card: MCard): Promise<string>;
+    get(hash: string): Promise<MCard | null>;
+    delete(hash: string): Promise<void>;
+    searchByHash(hashPrefix: string): Promise<MCard[]>;
+    getPage(pageNumber: number, pageSize: number): Promise<Page<MCard>>;
+    search(query: string, pageNumber: number, pageSize: number): Promise<Page<MCard>>;
+    getAll(): Promise<MCard[]>;
+    count(): Promise<number>;
+    clear(): Promise<void>;
+    registerHandle(handle: string, hash: string): Promise<void>;
+    resolveHandle(handle: string): Promise<string | null>;
+    getByHandle(handle: string): Promise<MCard | null>;
+    updateHandle(handle: string, newHash: string): Promise<string>;
+    getHandleHistory(handle: string): Promise<{
+        previousHash: string;
+        changedAt: string;
+    }[]>;
+    pruneHandleHistory?(handle: string, options: {
+        olderThan?: string;
+        deleteAll?: boolean;
+    }): Promise<number>;
+}
+//# sourceMappingURL=StorageAdapter.d.ts.map

package/dist/storage/StorageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageAdapter.d.ts","sourceRoot":"","sources":["../../src/storage/StorageAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,IAAI,CAAC,CAAC;IACnB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAE1B,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACzC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACnD,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACpE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAClF,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAGvB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtD,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACnD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IACzF,kBAAkB,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9G"}

package/dist/storage/StorageAdapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=StorageAdapter.js.map

package/dist/storage/StorageAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageAdapter.js","sourceRoot":"","sources":["../../src/storage/StorageAdapter.ts"],"names":[],"mappings":""}

package/dist/storage/VectorStore.d.ts

@@ -0,0 +1,202 @@
+/**
+ * MCard Vector Store for JavaScript
+ *
+ * SQLite-based vector storage for semantic search using sqlite-vec extension.
+ * Compatible with the Python MCardVectorStore implementation.
+ */
+import Database from 'better-sqlite3';
+export interface VectorDbStatement {
+    run: (...params: unknown[]) => {
+        lastInsertRowid?: number | bigint;
+        changes?: number;
+    };
+    all: (...params: unknown[]) => any[];
+    get: (...params: unknown[]) => any;
+    loadVecExtension?: (dimensions: number) => boolean;
+}
+export interface VectorDb {
+    exec(sql: string): void;
+    prepare(sql: string): VectorDbStatement;
+}
+export declare class BetterSqliteAdapter implements VectorDb {
+    private db;
+    constructor(db: Database.Database);
+    exec(sql: string): void;
+    prepare(sql: string): {
+        run: (...params: unknown[]) => Database.RunResult;
+        all: (...params: unknown[]) => unknown[];
+        get: (...params: unknown[]) => unknown;
+        loadVecExtension: (dimensions: number) => boolean;
+    };
+}
+export interface VectorStoreConfig {
+    /** Embedding model name (for Ollama) */
+    embeddingModel: string;
+    /** Vector dimensions (default: 768 for nomic-embed-text) */
+    dimensions: number;
+    /** Ollama base URL */
+    ollamaBaseUrl: string;
+    /** Chunk size for long documents */
+    chunkSize: number;
+    /** Chunk overlap */
+    chunkOverlap: number;
+    /** Enable FTS hybrid search */
+    enableHybridSearch: boolean;
+}
+export declare const DEFAULT_VECTOR_CONFIG: VectorStoreConfig;
+export interface EmbeddingProvider {
+    embed(text: string): Promise<number[]>;
+    embedBatch?(texts: string[]): Promise<number[][]>;
+    modelName?: string;
+    dimensions?: number;
+}
+/**
+ * Serialize a float array to bytes (little-endian float32).
+ */
+export declare function serializeVector(vector: number[]): Buffer;
+/**
+ * Deserialize bytes to a float array.
+ */
+export declare function deserializeVector(buffer: Buffer): number[];
+/**
+ * Calculate cosine similarity between two vectors.
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+export interface VectorSearchResult {
+    hash: string;
+    score: number;
+    content?: string;
+    chunkIndex?: number;
+    metadata?: Record<string, unknown>;
+}
+export declare class MCardVectorStore {
+    protected db: VectorDb;
+    protected config: VectorStoreConfig;
+    protected hasVecExtension: boolean;
+    /**
+     * Construct a vector store.
+     *
+     * - Node.js: pass a string path (uses better-sqlite3 under the hood)
+     * - Advanced: pass a VectorDb adapter (e.g., SqlJsVectorAdapter for WASM)
+     */
+    constructor(dbOrPath?: string | VectorDb, config?: Partial<VectorStoreConfig>);
+    /**
+     * Initialize database tables.
+     * Uses schema from the unified MCardSchema singleton (schema/mcard_schema.sql).
+     */
+    private initDatabase;
+    /**
+     * Fallback initialization for browser/WASM environments.
+     * Uses exported constants from schema.ts which are loaded from the SQL file.
+     */
+    private initDatabaseFallback;
+    /**
+     * Try to load sqlite-vec extension.
+     */
+    private tryLoadVecExtension;
+    /**
+     * Generate embedding using Ollama.
+     */
+    embed(text: string): Promise<number[]>;
+    /**
+     * Index content with its embedding.
+     */
+    index(hash: string, content: string, metadata?: Record<string, unknown>, chunk?: boolean): Promise<number>;
+    /**
+     * Search for similar content.
+     */
+    search(query: string, k?: number): Promise<VectorSearchResult[]>;
+    /**
+     * Search using sqlite-vec KNN.
+     */
+    private searchWithVec;
+    /**
+     * Fallback brute-force similarity search.
+     */
+    private searchFallback;
+    /**
+     * Hybrid search combining vector and FTS.
+     */
+    hybridSearch(query: string, k?: number, vectorWeight?: number): Promise<VectorSearchResult[]>;
+    /**
+     * Split text into overlapping chunks.
+     */
+    private chunkText;
+    /**
+     * Get count of indexed vectors.
+     */
+    count(): number;
+    /**
+     * Get list of all indexed hashes (distinct)
+     */
+    getIndexedHashes(): Promise<string[]>;
+    /**
+     * Count unique indexed cards
+     */
+    countUnique(): number;
+    /**
+     * Delete vectors for a hash.
+     */
+    delete(hash: string): number;
+    /**
+     * Clear all vectors.
+     */
+    clear(): void;
+    /**
+     * Check if sqlite-vec extension is available.
+     */
+    hasVectorExtension(): boolean;
+    /**
+     * Get information about the vector store.
+     */
+    getInfo(): Record<string, unknown>;
+    /**
+     * Close the database connection.
+     */
+    close(): void;
+}
+/**
+ * Minimal shape of a sql.js Database for adapter purposes.
+ * We intentionally keep this loose to avoid tight coupling to sql.js types.
+ */
+export interface SqlJsDatabaseLike {
+    run(sql: string, params?: unknown[]): void;
+    exec(sql: string): {
+        columns: string[];
+        values: unknown[][];
+    }[];
+    prepare(sql: string): any;
+}
+/**
+ * Adapter for sql.js / SQLite WASM so VectorStore can run in the browser.
+ *
+ * NOTE: Parameter binding and stepping are left as a TODO because the exact
+ * sql.js API usage (bind/step/getAsObject) depends on how you want to map
+ * VectorDb semantics to sql.js. For now, this adapter is scaffolding that
+ * shows where to integrate sql.js.
+ */
+export declare class SqlJsVectorAdapter implements VectorDb {
+    private db;
+    constructor(db: SqlJsDatabaseLike);
+    exec(sql: string): void;
+    prepare(_sql: string): {
+        run: (..._params: unknown[]) => {
+            lastInsertRowid?: number;
+            changes?: number;
+        };
+        all: (..._params: unknown[]) => any[];
+        get: (..._params: unknown[]) => any;
+        loadVecExtension: (_dimensions: number) => boolean;
+    };
+}
+/**
+ * Factory to create a VectorStore backed by SqliteWasmEngine/sql.js.
+ *
+ * Example usage (browser):
+ *
+ *   const engine = new SqliteWasmEngine();
+ *   await engine.init(wasmUrl, existingData);
+ *   const vecStore = createWasmVectorStore(engine.getRawDb());
+ */
+export declare function createWasmVectorStore(wasmDb: SqlJsDatabaseLike, config?: Partial<VectorStoreConfig>): MCardVectorStore;
+//# sourceMappingURL=VectorStore.d.ts.map

package/dist/storage/VectorStore.d.ts.map

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