@cyanheads/mcp-ts-core 0.9.16 → 0.9.17

package/dist/services/mirror/sqlite/handle.js

@@ -0,0 +1,105 @@
+/**
+ * @fileoverview Runtime-agnostic SQLite handle for the mirror store. Uses the
+ * built-in `bun:sqlite` driver under Bun and the `better-sqlite3` optional peer
+ * dependency on Node — both exposed through one synchronous handle interface
+ * (the intersection of the two driver APIs).
+ *
+ * The drivers are loaded via variable-specifier dynamic imports so the
+ * framework typechecks and builds without `bun-types` in scope or
+ * `better-sqlite3` installed; both resolve at runtime on the matching runtime.
+ * @module services/mirror/sqlite/handle
+ */
+import { mkdir } from 'node:fs/promises';
+import { dirname, resolve as resolvePath } from 'node:path';
+import { configurationError, databaseError, McpError } from '../../../types-global/errors.js';
+import { runtimeCaps } from '../../../utils/internal/runtime.js';
+/**
+ * Variable-specifier module IDs. Annotating as `string` (not the string
+ * literal) stops `tsc` from statically resolving the module, so the framework
+ * compiles without `bun-types` or `better-sqlite3` present. Each resolves at
+ * runtime only on the runtime that ships it.
+ */
+const BUN_SQLITE_SPECIFIER = 'bun:sqlite';
+const BETTER_SQLITE3_SPECIFIER = 'better-sqlite3';
+/**
+ * Open (or create) a SQLite database at `path`, picking the driver for the
+ * current runtime. Creates the parent directory, enables WAL, and sets
+ * `busy_timeout` so a refresh writer and reader processes coexist without
+ * spurious `database is locked` errors.
+ *
+ * Throws `ConfigurationError` on Node when `better-sqlite3` is not installed,
+ * and `DatabaseError` for any other open failure.
+ */
+export async function openSqliteHandle(path, options = {}) {
+    await mkdir(dirname(resolvePath(path)), { recursive: true });
+    const busyTimeoutMs = options.busyTimeoutMs ?? 5000;
+    let handle;
+    try {
+        handle = runtimeCaps.isBun
+            ? /* istanbul ignore next -- Bun branch; the test suite runs Vitest workers under Node */
+                await openBunHandle(path)
+            : await openBetterSqlite3Handle(path);
+    }
+    catch (err) {
+        // The Node path throws a ConfigurationError when better-sqlite3 is absent —
+        // preserve it rather than masking it as a generic open failure.
+        if (err instanceof McpError)
+            throw err;
+        throw databaseError(`Failed to open mirror store at ${path}`, { path }, { cause: err });
+    }
+    // Connection pragmas. WAL allows one writer + concurrent readers; NORMAL
+    // synchronous is the WAL-recommended durability/throughput balance.
+    handle.exec(`PRAGMA journal_mode = WAL; PRAGMA synchronous = NORMAL; PRAGMA foreign_keys = ON; PRAGMA busy_timeout = ${busyTimeoutMs};`);
+    return handle;
+}
+/* istanbul ignore next -- Bun-only driver; the test suite runs Vitest workers under Node */
+async function openBunHandle(path) {
+    const mod = (await import(BUN_SQLITE_SPECIFIER));
+    const db = new mod.Database(path, { create: true });
+    return {
+        close: () => {
+            db.close();
+        },
+        exec: (sql) => {
+            db.exec(sql);
+        },
+        prepare: (sql) => {
+            const stmt = db.prepare(sql);
+            return {
+                all: (...params) => stmt.all(...params),
+                get: (...params) => stmt.get(...params),
+                run: (...params) => stmt.run(...params),
+            };
+        },
+        transaction: (fn) => db.transaction(fn)(),
+    };
+}
+async function openBetterSqlite3Handle(path) {
+    let mod;
+    try {
+        mod = (await import(BETTER_SQLITE3_SPECIFIER));
+    }
+    catch (err) {
+        /* istanbul ignore next -- missing-dep path; better-sqlite3 is installed in the test env */
+        throw configurationError('Install "better-sqlite3" to use the SQLite mirror store on Node: bun add better-sqlite3', { path }, { cause: err });
+    }
+    const db = new mod.default(path);
+    return {
+        close: () => {
+            db.close();
+        },
+        exec: (sql) => {
+            db.exec(sql);
+        },
+        prepare: (sql) => {
+            const stmt = db.prepare(sql);
+            return {
+                all: (...params) => stmt.all(...params),
+                get: (...params) => stmt.get(...params),
+                run: (...params) => stmt.run(...params),
+            };
+        },
+        transaction: (fn) => db.transaction(fn)(),
+    };
+}
+//# sourceMappingURL=handle.js.map

package/dist/services/mirror/sqlite/handle.js.map

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

package/dist/services/mirror/sqlite/schema.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview DDL generation for the SQLite mirror store. Builds the primary
+ * table, secondary indexes, an optional FTS5 external-content index with sync
+ * triggers, the single-row `mirror_sync_state` table, and the `schema_version`
+ * table — all from a declarative column/FTS spec.
+ * @module services/mirror/sqlite/schema
+ */
+/** Default FTS5 tokenizer — Unicode-aware, diacritic-stripping, no stemming. */
+export declare const DEFAULT_FTS_TOKENIZER = "unicode61 remove_diacritics 2";
+/** Declarative schema spec consumed by {@link buildSchemaSql}. */
+export interface SchemaSpec {
+    /** Column name → SQLite type/declaration (e.g. `'TEXT'`, `'INTEGER NOT NULL'`). */
+    columns: Record<string, string>;
+    /** Columns to index in FTS5 (subset of `columns`). Omit/empty to skip FTS. */
+    fts?: string[];
+    /** FTS5 tokenizer directive. Defaults to {@link DEFAULT_FTS_TOKENIZER}. */
+    ftsTokenizer?: string;
+    /** Secondary indexes over declared columns. */
+    indexes?: Array<{
+        name?: string;
+        columns: string[];
+    }>;
+    /** Primary-key column — receives `PRIMARY KEY NOT NULL` and drives upsert/tombstone. */
+    primaryKey: string;
+    /** Primary table name. */
+    table: string;
+}
+/** Validate a {@link SchemaSpec} and return its FTS column set (validated). */
+export declare function validateSchemaSpec(spec: SchemaSpec): {
+    ftsColumns: string[];
+    tokenizer: string;
+};
+/**
+ * Build the full idempotent DDL for a mirror store. Safe to run on every open
+ * (`CREATE … IF NOT EXISTS` throughout). Returns one SQL string.
+ */
+export declare function buildSchemaSql(spec: SchemaSpec): string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/services/mirror/sqlite/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/services/mirror/sqlite/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,kCAAkC,CAAC;AAErE,kEAAkE;AAClE,MAAM,WAAW,UAAU;IACzB,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACtD,wFAAwF;IACxF,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAaD,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CA4ChG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAuCvD"}

package/dist/services/mirror/sqlite/schema.js

@@ -0,0 +1,124 @@
+/**
+ * @fileoverview DDL generation for the SQLite mirror store. Builds the primary
+ * table, secondary indexes, an optional FTS5 external-content index with sync
+ * triggers, the single-row `mirror_sync_state` table, and the `schema_version`
+ * table — all from a declarative column/FTS spec.
+ * @module services/mirror/sqlite/schema
+ */
+import { configurationError } from '../../../types-global/errors.js';
+/** Default FTS5 tokenizer — Unicode-aware, diacritic-stripping, no stemming. */
+export const DEFAULT_FTS_TOKENIZER = 'unicode61 remove_diacritics 2';
+const IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function assertIdentifier(value, role) {
+    if (!IDENTIFIER_RE.test(value)) {
+        throw configurationError(`Invalid mirror ${role} identifier "${value}" — must match ${IDENTIFIER_RE.source}.`, { value, role });
+    }
+}
+/** Validate a {@link SchemaSpec} and return its FTS column set (validated). */
+export function validateSchemaSpec(spec) {
+    assertIdentifier(spec.table, 'table');
+    const columnNames = Object.keys(spec.columns);
+    if (columnNames.length === 0) {
+        throw configurationError('Mirror schema must declare at least one column.', {
+            table: spec.table,
+        });
+    }
+    for (const col of columnNames)
+        assertIdentifier(col, 'column');
+    if (!(spec.primaryKey in spec.columns)) {
+        throw configurationError(`Mirror primaryKey "${spec.primaryKey}" is not among the declared columns.`, { primaryKey: spec.primaryKey, columns: columnNames });
+    }
+    const ftsColumns = spec.fts ?? [];
+    for (const col of ftsColumns) {
+        if (!(col in spec.columns)) {
+            throw configurationError(`Mirror FTS column "${col}" is not a declared column.`, {
+                column: col,
+                columns: columnNames,
+            });
+        }
+    }
+    const tokenizer = spec.ftsTokenizer ?? DEFAULT_FTS_TOKENIZER;
+    if (tokenizer.includes('"')) {
+        throw configurationError('Mirror ftsTokenizer must not contain a double-quote character.', {
+            tokenizer,
+        });
+    }
+    for (const idx of spec.indexes ?? []) {
+        for (const col of idx.columns) {
+            if (!(col in spec.columns)) {
+                throw configurationError(`Mirror index column "${col}" is not a declared column.`, {
+                    column: col,
+                });
+            }
+        }
+    }
+    return { ftsColumns, tokenizer };
+}
+/**
+ * Build the full idempotent DDL for a mirror store. Safe to run on every open
+ * (`CREATE … IF NOT EXISTS` throughout). Returns one SQL string.
+ */
+export function buildSchemaSql(spec) {
+    const { ftsColumns, tokenizer } = validateSchemaSpec(spec);
+    const t = spec.table;
+    const columnDefs = Object.entries(spec.columns).map(([name, decl]) => {
+        const base = `${name} ${decl}`.trim();
+        return name === spec.primaryKey ? `${name} ${decl} PRIMARY KEY NOT NULL`.trim() : base;
+    });
+    const parts = [
+        `CREATE TABLE IF NOT EXISTS schema_version (version INTEGER PRIMARY KEY, applied_at TEXT NOT NULL);`,
+        `CREATE TABLE IF NOT EXISTS ${t} (\n  ${columnDefs.join(',\n  ')}\n);`,
+    ];
+    for (const idx of spec.indexes ?? []) {
+        const name = idx.name ?? `${t}_${idx.columns.join('_')}_idx`;
+        assertIdentifier(name, 'index');
+        parts.push(`CREATE INDEX IF NOT EXISTS ${name} ON ${t}(${idx.columns.join(', ')});`);
+    }
+    if (ftsColumns.length > 0) {
+        parts.push(buildFtsSql(t, ftsColumns, tokenizer));
+    }
+    parts.push(`CREATE TABLE IF NOT EXISTS mirror_sync_state (
+  id INTEGER PRIMARY KEY CHECK (id = 1),
+  status TEXT NOT NULL,
+  cursor TEXT,
+  checkpoint TEXT,
+  started_at TEXT,
+  completed_at TEXT,
+  total INTEGER,
+  error TEXT
+);`, `INSERT OR IGNORE INTO mirror_sync_state(id, status) VALUES (1, 'pending');`);
+    return parts.join('\n\n');
+}
+/**
+ * Build the FTS5 external-content virtual table and its insert/delete/update
+ * sync triggers. External content (`content=<table>`) stores only the index, not
+ * a copy of the text; the triggers keep it in lock-step with the base table,
+ * using the `('delete', …)` command-row form required for external-content
+ * deletes.
+ */
+function buildFtsSql(table, ftsColumns, tokenizer) {
+    const cols = ftsColumns.join(', ');
+    const newCols = ftsColumns.map((c) => `new.${c}`).join(', ');
+    const oldCols = ftsColumns.map((c) => `old.${c}`).join(', ');
+    const fts = `${table}_fts`;
+    return `CREATE VIRTUAL TABLE IF NOT EXISTS ${fts} USING fts5(
+  ${ftsColumns.join(',\n  ')},
+  content='${table}',
+  content_rowid='rowid',
+  tokenize="${tokenizer}"
+);
+
+CREATE TRIGGER IF NOT EXISTS ${table}_ai AFTER INSERT ON ${table} BEGIN
+  INSERT INTO ${fts}(rowid, ${cols}) VALUES (new.rowid, ${newCols});
+END;
+
+CREATE TRIGGER IF NOT EXISTS ${table}_ad AFTER DELETE ON ${table} BEGIN
+  INSERT INTO ${fts}(${fts}, rowid, ${cols}) VALUES ('delete', old.rowid, ${oldCols});
+END;
+
+CREATE TRIGGER IF NOT EXISTS ${table}_au AFTER UPDATE ON ${table} BEGIN
+  INSERT INTO ${fts}(${fts}, rowid, ${cols}) VALUES ('delete', old.rowid, ${oldCols});
+  INSERT INTO ${fts}(rowid, ${cols}) VALUES (new.rowid, ${newCols});
+END;`;
+}
+//# sourceMappingURL=schema.js.map

package/dist/services/mirror/sqlite/schema.js.map

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

package/dist/services/mirror/sqlite/sqliteMirrorStore.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Embedded-SQLite implementation of {@link MirrorStore}. Owns the
+ * primary table, optional FTS5 index, the `mirror_sync_state` row, schema
+ * versioning + migration runner, generic flat queries, and the raw-handle
+ * escape hatch. Lazy-opens on first use (memoized) and is then backed by
+ * synchronous driver calls.
+ * @module services/mirror/sqlite/sqliteMirrorStore
+ */
+import type { Migration, MirrorStore } from '../types.js';
+import { type SchemaSpec } from './schema.js';
+/** Configuration for {@link sqliteMirrorStore}. */
+export interface SqliteMirrorStoreSpec extends SchemaSpec {
+    /** `PRAGMA busy_timeout` in ms. Default 5000. */
+    busyTimeoutMs?: number;
+    /** Migrations applied in order when the stored version is lower than `version`. */
+    migrations?: Migration[];
+    /** Filesystem path to the SQLite database (created if absent). */
+    path: string;
+    /** Current schema version. Default 1. */
+    version?: number;
+}
+/**
+ * Create a SQLite-backed {@link MirrorStore} from a declarative spec. The store
+ * is not opened until the first method call.
+ */
+export declare function sqliteMirrorStore(spec: SqliteMirrorStoreSpec): MirrorStore;
+//# sourceMappingURL=sqliteMirrorStore.d.ts.map

package/dist/services/mirror/sqlite/sqliteMirrorStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteMirrorStore.d.ts","sourceRoot":"","sources":["../../../../src/services/mirror/sqlite/sqliteMirrorStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAEV,SAAS,EAET,WAAW,EAMZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAkB,KAAK,UAAU,EAAsB,MAAM,aAAa,CAAC;AAElF,mDAAmD;AACnD,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mFAAmF;IACnF,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAkBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,WAAW,CA0L1E"}

package/dist/services/mirror/sqlite/sqliteMirrorStore.js

@@ -0,0 +1,286 @@
+/**
+ * @fileoverview Embedded-SQLite implementation of {@link MirrorStore}. Owns the
+ * primary table, optional FTS5 index, the `mirror_sync_state` row, schema
+ * versioning + migration runner, generic flat queries, and the raw-handle
+ * escape hatch. Lazy-opens on first use (memoized) and is then backed by
+ * synchronous driver calls.
+ * @module services/mirror/sqlite/sqliteMirrorStore
+ */
+import { databaseError, validationError } from '../../../types-global/errors.js';
+import { openSqliteHandle } from './handle.js';
+import { buildSchemaSql, validateSchemaSpec } from './schema.js';
+const SQL_OP = {
+    eq: '=',
+    ne: '!=',
+    gt: '>',
+    gte: '>=',
+    lt: '<',
+    lte: '<=',
+};
+/**
+ * Create a SQLite-backed {@link MirrorStore} from a declarative spec. The store
+ * is not opened until the first method call.
+ */
+export function sqliteMirrorStore(spec) {
+    // Fail fast on a malformed spec at construction time, not first query.
+    const { ftsColumns } = validateSchemaSpec(spec);
+    const allColumns = Object.keys(spec.columns);
+    const ftsTable = `${spec.table}_fts`;
+    let opened;
+    let opening;
+    function open() {
+        if (opened)
+            return Promise.resolve(opened);
+        opening ??= (async () => {
+            const handleOptions = {
+                ...(spec.busyTimeoutMs !== undefined && { busyTimeoutMs: spec.busyTimeoutMs }),
+            };
+            const handle = await openSqliteHandle(spec.path, handleOptions);
+            try {
+                handle.exec(buildSchemaSql(spec));
+                runMigrations(handle, spec.version ?? 1, spec.migrations ?? []);
+            }
+            catch (err) {
+                handle.close();
+                throw databaseError(`Failed to initialize mirror store at ${spec.path}`, { path: spec.path }, { cause: err });
+            }
+            opened = { handle, allColumns, hasFts: ftsColumns.length > 0 };
+            return opened;
+        })();
+        return opening;
+    }
+    function assertColumn(column, role) {
+        if (!allColumns.includes(column)) {
+            throw validationError(`Unknown mirror ${role} column "${column}".`, {
+                column,
+                columns: allColumns,
+            });
+        }
+    }
+    return {
+        async applyBatch(records, tombstones) {
+            if (records.length === 0 && tombstones.length === 0)
+                return;
+            const { handle } = await open();
+            const cols = allColumns;
+            const placeholders = cols.map(() => '?').join(', ');
+            const updates = cols
+                .filter((c) => c !== spec.primaryKey)
+                .map((c) => `${c} = excluded.${c}`)
+                .join(', ');
+            // No non-PK columns → a bare PK table; ON CONFLICT DO NOTHING keeps upsert idempotent.
+            const conflict = updates
+                ? `ON CONFLICT(${spec.primaryKey}) DO UPDATE SET ${updates}`
+                : `ON CONFLICT(${spec.primaryKey}) DO NOTHING`;
+            const upsert = handle.prepare(`INSERT INTO ${spec.table}(${cols.join(', ')}) VALUES (${placeholders}) ${conflict}`);
+            const remove = handle.prepare(`DELETE FROM ${spec.table} WHERE ${spec.primaryKey} = ?`);
+            handle.transaction(() => {
+                for (const record of records) {
+                    upsert.run(...cols.map((c) => record[c] ?? null));
+                }
+                for (const id of tombstones)
+                    remove.run(id);
+            });
+        },
+        async query(options) {
+            const store = await open();
+            if (options.match && !store.hasFts) {
+                throw validationError('This mirror has no FTS index; `match` is not supported.', {
+                    table: spec.table,
+                });
+            }
+            for (const f of options.filters ?? [])
+                assertColumn(f.column, 'filter');
+            if (options.sort && options.sort !== 'relevance')
+                assertColumn(options.sort.column, 'sort');
+            const { handle } = store;
+            const { clauses: filterClauses, params: filterParams } = buildFilterClauses(options.filters ?? []);
+            const relevance = options.sort === 'relevance' && Boolean(options.match);
+            // COUNT never needs bm25, so the FTS predicate is always the rowid
+            // subquery form — no join, no ordering.
+            const countClauses = [...filterClauses];
+            const countParams = [...filterParams];
+            if (options.match) {
+                countClauses.unshift(`${spec.table}.rowid IN (SELECT rowid FROM ${ftsTable} WHERE ${ftsTable} MATCH ?)`);
+                countParams.unshift(options.match);
+            }
+            const countWhere = countClauses.length > 0 ? `WHERE ${countClauses.join(' AND ')}` : '';
+            const total = handle
+                .prepare(`SELECT COUNT(*) AS n FROM ${spec.table} ${countWhere}`)
+                .get(...countParams)?.n ?? 0;
+            // Row fetch. For relevance sort, apply MATCH on the JOINed FTS table so
+            // `bm25()` is scored in that MATCH's context; the subquery form leaves
+            // bm25 with no query to score against. Other sorts keep the subquery form
+            // (no join needed). `ORDER BY` columns are table-qualified to avoid a
+            // `rowid` ambiguity once the FTS table is joined in.
+            const rowClauses = [...filterClauses];
+            const rowParams = [...filterParams];
+            let join = '';
+            if (options.match) {
+                if (relevance) {
+                    join = `JOIN ${ftsTable} ON ${spec.table}.rowid = ${ftsTable}.rowid`;
+                    rowClauses.unshift(`${ftsTable} MATCH ?`);
+                }
+                else {
+                    rowClauses.unshift(`${spec.table}.rowid IN (SELECT rowid FROM ${ftsTable} WHERE ${ftsTable} MATCH ?)`);
+                }
+                rowParams.unshift(options.match);
+            }
+            const rowWhere = rowClauses.length > 0 ? `WHERE ${rowClauses.join(' AND ')}` : '';
+            const selectCols = store.allColumns.map((c) => `${spec.table}.${c}`).join(', ');
+            const orderBy = relevance
+                ? `ORDER BY bm25(${ftsTable}) ASC`
+                : buildOrderBy(options.sort, spec.table);
+            const rows = handle
+                .prepare(`SELECT ${selectCols} FROM ${spec.table} ${join} ${rowWhere} ${orderBy} LIMIT ? OFFSET ?`)
+                .all(...rowParams, options.limit, options.offset);
+            return { rows, total };
+        },
+        async getByIds(ids) {
+            if (ids.length === 0)
+                return [];
+            const { handle } = await open();
+            const placeholders = ids.map(() => '?').join(', ');
+            const rows = handle
+                .prepare(`SELECT ${allColumns.join(', ')} FROM ${spec.table} WHERE ${spec.primaryKey} IN (${placeholders})`)
+                .all(...ids);
+            const byId = new Map(rows.map((r) => [r[spec.primaryKey], r]));
+            return ids.map((id) => byId.get(id)).filter((r) => r !== undefined);
+        },
+        async count() {
+            const { handle } = await open();
+            const row = handle.prepare(`SELECT COUNT(*) AS n FROM ${spec.table}`).get();
+            return row?.n ?? 0;
+        },
+        async readState() {
+            const { handle } = await open();
+            return readSyncState(handle);
+        },
+        async writeState(state) {
+            const { handle } = await open();
+            writeSyncState(handle, state);
+        },
+        async raw() {
+            return (await open()).handle;
+        },
+        async integrityCheck() {
+            const { handle } = await open();
+            const integrity = handle.prepare(`PRAGMA integrity_check`).all();
+            const quick = handle.prepare(`PRAGMA quick_check`).all();
+            const results = [
+                ...integrity.map((r) => `integrity_check: ${r.integrity_check}`),
+                ...quick.map((r) => `quick_check: ${r.quick_check}`),
+            ];
+            return { ok: results.every((r) => r.endsWith('ok')), results };
+        },
+        close() {
+            if (opened) {
+                opened.handle.close();
+                opened = undefined;
+                opening = undefined;
+            }
+            return Promise.resolve();
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Query building
+// ---------------------------------------------------------------------------
+function buildFilterClauses(filters) {
+    const clauses = [];
+    const params = [];
+    for (const f of filters) {
+        if (f.op === 'in') {
+            const values = Array.isArray(f.value) ? f.value : [f.value];
+            if (values.length === 0) {
+                clauses.push('0'); // empty IN matches nothing
+                continue;
+            }
+            clauses.push(`${f.column} IN (${values.map(() => '?').join(', ')})`);
+            params.push(...values);
+            continue;
+        }
+        clauses.push(`${f.column} ${SQL_OP[f.op]} ?`);
+        params.push(Array.isArray(f.value) ? (f.value[0] ?? null) : f.value);
+    }
+    return { clauses, params };
+}
+function buildOrderBy(sort, table) {
+    if (sort && sort !== 'relevance') {
+        return `ORDER BY ${table}.${sort.column} ${sort.direction === 'asc' ? 'ASC' : 'DESC'}`;
+    }
+    return `ORDER BY ${table}.rowid ASC`;
+}
+function readSyncState(handle) {
+    const row = handle
+        .prepare(`SELECT status, cursor, checkpoint, started_at, completed_at, total, error
+       FROM mirror_sync_state WHERE id = 1`)
+        .get();
+    if (!row)
+        return { status: 'pending' };
+    return {
+        status: row.status,
+        ...(row.cursor != null && { cursor: row.cursor }),
+        ...(row.checkpoint != null && { checkpoint: row.checkpoint }),
+        ...(row.started_at != null && { startedAt: row.started_at }),
+        ...(row.completed_at != null && { completedAt: row.completed_at }),
+        ...(row.total != null && { total: row.total }),
+        ...(row.error != null && { error: row.error }),
+    };
+}
+/**
+ * Persist sync state. `completed_at` and `total` are durable "last successful
+ * sync" markers — preserved via COALESCE when a write omits them — so an
+ * in-progress or failed refresh on top of a complete mirror keeps the
+ * completion marker that readiness keys off. Every other column is
+ * current-run progress, overwritten on each write.
+ */
+function writeSyncState(handle, state) {
+    handle
+        .prepare(`UPDATE mirror_sync_state
+       SET status = ?, cursor = ?, checkpoint = ?, started_at = ?,
+           completed_at = COALESCE(?, completed_at),
+           total = COALESCE(?, total),
+           error = ?
+       WHERE id = 1`)
+        .run(state.status, state.cursor ?? null, state.checkpoint ?? null, state.startedAt ?? null, state.completedAt ?? null, state.total ?? null, state.error ?? null);
+}
+// ---------------------------------------------------------------------------
+// Schema versioning
+// ---------------------------------------------------------------------------
+/**
+ * Apply pending migrations. A brand-new database (no `schema_version` row) was
+ * just built at the current schema by the DDL, so it is stamped to `target`
+ * without running migrations (there is no older data to transform). An existing
+ * database at a lower version runs each migration with `stored < version <=
+ * target`, in order, stamping the version after each.
+ */
+function runMigrations(handle, target, migrations) {
+    const stored = handle.prepare(`SELECT MAX(version) AS version FROM schema_version`).get()
+        ?.version ?? 0;
+    if (stored === 0) {
+        stampVersion(handle, target);
+        return;
+    }
+    if (stored >= target)
+        return;
+    const pending = migrations
+        .filter((m) => m.version > stored && m.version <= target)
+        .sort((a, b) => a.version - b.version);
+    for (const m of pending) {
+        handle.transaction(() => {
+            m.up(handle);
+        });
+        stampVersion(handle, m.version);
+    }
+    stampVersion(handle, target);
+}
+function stampVersion(handle, version) {
+    handle.transaction(() => {
+        handle.prepare(`DELETE FROM schema_version`).run();
+        handle
+            .prepare(`INSERT INTO schema_version(version, applied_at) VALUES (?, ?)`)
+            .run(version, new Date().toISOString());
+    });
+}
+//# sourceMappingURL=sqliteMirrorStore.js.map

package/dist/services/mirror/sqlite/sqliteMirrorStore.js.map

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