@semics-tech/mongolite 1.2.0 → 1.4.0

package/dist/cjs/sync/shadow.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncShadow = exports.SHADOW_TABLE = void 0;
+exports.projectToLocalShape = projectToLocalShape;
+exports.projectForComparison = projectForComparison;
+/**
+ * The shadow store: the last-known **server** state of each replicated document.
+ *
+ * It exists because the local store cannot represent MongoDB's type system. Documents
+ * are persisted as plain `JSON.stringify`, so a `Date` becomes an ISO string, an
+ * `ObjectId` becomes hex, and `Binary`/`Decimal128` degrade to unusable structural
+ * objects. Pushing a whole local document back would therefore rewrite the upstream
+ * document in that degraded form.
+ *
+ * Keeping a verbatim copy of the server document solves three problems at once:
+ *
+ * 1. **Conflict base** — the `_v` a compare-and-swap asserts against.
+ * 2. **Type preservation** — fields the application never touched locally are simply
+ *    absent from the diff, so the upstream values survive intact.
+ * 3. **Minimal writes** — pushes become `$set`/`$unset` of what actually changed,
+ *    so a local edit stops clobbering fields other writers changed.
+ *
+ * Documents are stored as canonical Extended JSON. That encoding is safe **only**
+ * because it lives here and never in a collection table: the query, sort and index
+ * layer reads collection data with `json_extract` and assumes bare scalars, so
+ * encoding values there would break range queries and indexes wholesale.
+ */
+const bson_1 = require("bson");
+exports.SHADOW_TABLE = '__mongolite_sync_shadow__';
+/**
+ * Bookkeeping fields replication maintains on upstream documents. They are stripped
+ * from the projection so they never reach local documents and never show up as a
+ * spurious change to push back.
+ */
+const SYNC_FIELDS = new Set(['_v', '_updatedAt']);
+/** Millisecond epoch as a SQL expression — portable across SQLite builds. */
+const NOW_MS_SQL = `CAST((julianday('now') - 2440587.5) * 86400000.0 AS INTEGER)`;
+/**
+ * Flattens a document to exactly the representation the local store would produce.
+ *
+ * This is deliberately the *same* lossy transform the collection tables apply
+ * (`JSON.stringify`), rather than an approximation of it: a server `Date` projects to
+ * the identical ISO string the local row holds, so the two compare equal and the field
+ * stays out of the diff. Any drift between this and the storage encoding would show up
+ * as phantom changes pushed on every sync.
+ */
+function projectToLocalShape(document) {
+    return JSON.parse(JSON.stringify(document));
+}
+/**
+ * The projection a local document is compared against: the server document flattened
+ * to local shape, with replication's own bookkeeping fields removed.
+ */
+function projectForComparison(document) {
+    const projected = projectToLocalShape(document);
+    for (const field of SYNC_FIELDS)
+        delete projected[field];
+    return projected;
+}
+class SyncShadow {
+    constructor(db, replicator) {
+        this.db = db;
+        this.replicator = replicator;
+        this.schemaReady = null;
+    }
+    /** Creates the shadow table. Idempotent. */
+    async ensureSchema() {
+        if (!this.schemaReady) {
+            this.schemaReady = this.createSchema().catch((err) => {
+                // Let a later call retry rather than caching the failure forever.
+                this.schemaReady = null;
+                throw err;
+            });
+        }
+        return this.schemaReady;
+    }
+    async createSchema() {
+        await this.db.exec(`
+      CREATE TABLE IF NOT EXISTS ${exports.SHADOW_TABLE} (
+        replicator      TEXT    NOT NULL,
+        collection_name TEXT    NOT NULL,
+        document_id     TEXT    NOT NULL,
+        base_version    INTEGER,
+        server_document TEXT,
+        updated_at      INTEGER NOT NULL,
+        PRIMARY KEY (replicator, collection_name, document_id)
+      );
+    `);
+    }
+    /**
+     * Loads the shadow entries for a set of documents in one collection.
+     * Missing ids simply do not appear — those documents have never been upstream.
+     */
+    async load(collection, documentIds) {
+        await this.ensureSchema();
+        const found = new Map();
+        if (documentIds.length === 0)
+            return found;
+        // Chunked to stay well clear of SQLite's bound-parameter limit.
+        const chunkSize = 400;
+        for (let i = 0; i < documentIds.length; i += chunkSize) {
+            const chunk = documentIds.slice(i, i + chunkSize);
+            const placeholders = chunk.map(() => '?').join(', ');
+            const rows = await this.db.all(`SELECT document_id, base_version, server_document
+         FROM ${exports.SHADOW_TABLE}
+         WHERE replicator = ? AND collection_name = ? AND document_id IN (${placeholders})`, [this.replicator, collection, ...chunk]);
+            for (const row of rows) {
+                const serverDocument = decodeServerDocument(row.server_document);
+                if (!serverDocument)
+                    continue;
+                found.set(row.document_id, {
+                    collection,
+                    documentId: row.document_id,
+                    baseVersion: row.base_version === null ? null : Number(row.base_version),
+                    serverDocument,
+                    projection: projectForComparison(serverDocument),
+                });
+            }
+        }
+        return found;
+    }
+    /** Records the server state of a document after a successful write or a re-read. */
+    async put(collection, documentId, baseVersion, serverDocument) {
+        await this.ensureSchema();
+        await this.db.run(`INSERT INTO ${exports.SHADOW_TABLE}
+         (replicator, collection_name, document_id, base_version, server_document, updated_at)
+       VALUES (?, ?, ?, ?, ?, ${NOW_MS_SQL})
+       ON CONFLICT (replicator, collection_name, document_id) DO UPDATE SET
+         base_version = excluded.base_version,
+         server_document = excluded.server_document,
+         updated_at = excluded.updated_at`, [
+            this.replicator,
+            collection,
+            documentId,
+            baseVersion,
+            bson_1.EJSON.stringify(serverDocument, { relaxed: false }),
+        ]);
+    }
+    /** Drops a document's shadow — it no longer exists upstream. */
+    async remove(collection, documentId) {
+        await this.ensureSchema();
+        await this.db.run(`DELETE FROM ${exports.SHADOW_TABLE}
+       WHERE replicator = ? AND collection_name = ? AND document_id = ?`, [this.replicator, collection, documentId]);
+    }
+    /** Number of shadowed documents, for diagnostics. */
+    async size() {
+        await this.ensureSchema();
+        const row = await this.db.get(`SELECT COUNT(*) AS total FROM ${exports.SHADOW_TABLE} WHERE replicator = ?`, [this.replicator]);
+        return Number(row?.total ?? 0);
+    }
+    /** Forgets every shadow for this replicator, forcing the next push to re-seed. */
+    async clear() {
+        await this.ensureSchema();
+        const result = await this.db.run(`DELETE FROM ${exports.SHADOW_TABLE} WHERE replicator = ?`, [
+            this.replicator,
+        ]);
+        return result.changes;
+    }
+}
+exports.SyncShadow = SyncShadow;
+/**
+ * Decodes a stored server document. Returns `null` if the row is unreadable, so a
+ * corrupt shadow degrades to "never seen upstream" — the document is re-seeded rather
+ * than crashing replication.
+ */
+function decodeServerDocument(encoded) {
+    if (encoded === null || encoded === undefined)
+        return null;
+    try {
+        const parsed = bson_1.EJSON.parse(encoded, { relaxed: false });
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/cjs/sync/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cli/discover.d.ts

@@ -0,0 +1,40 @@
+import type { IDatabaseAdapter } from '../db.js';
+export interface DatabaseCandidate {
+    /** Absolute path to the file. */
+    path: string;
+    /** Path relative to the search root, for display. */
+    relativePath: string;
+    sizeBytes: number;
+    modified: Date;
+}
+export interface FindDatabasesOptions {
+    /** How many directory levels below the root to search. Default 2. */
+    depth?: number;
+    /** Stop after this many files. Default 50. */
+    limit?: number;
+}
+/**
+ * Walk `root` looking for SQLite-looking files, skipping the usual noisy
+ * directories. Results are newest-first, since the file you just wrote is
+ * almost always the one you want.
+ */
+export declare function findDatabaseFiles(root?: string, options?: FindDatabasesOptions): DatabaseCandidate[];
+export declare function formatBytes(bytes: number): string;
+export declare function formatRelativeTime(date: Date, now?: Date): string;
+export interface CollectionInfo {
+    name: string;
+    /** Number of documents (rows) in the collection. */
+    count: number;
+    /** False for tables that are not shaped like a MongoLite collection. */
+    isMongoLite: boolean;
+}
+/**
+ * List the tables in the database, flagging which ones look like MongoLite
+ * collections (an `_id` column plus a `data` column). Foreign tables are still
+ * reported so a user pointed at the wrong file gets a useful message rather
+ * than an empty list.
+ */
+export declare function listCollectionInfo(db: IDatabaseAdapter): Promise<CollectionInfo[]>;
+/** Resolve a user-supplied database path, allowing `:memory:` and `~` shorthand. */
+export declare function resolveDatabasePath(input: string): string;
+export declare function databaseExists(dbPath: string): boolean;

package/dist/cli/discover.js

@@ -0,0 +1,146 @@
+/**
+ * Finding things for the user so they do not have to type paths or remember
+ * collection names: SQLite files on disk, and MongoLite-shaped tables inside
+ * a database.
+ */
+import { readdirSync, statSync, existsSync } from 'node:fs';
+import path from 'node:path';
+const DB_EXTENSIONS = ['.db', '.sqlite', '.sqlite3', '.db3'];
+const SKIP_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'coverage',
+    '.next',
+    '.cache',
+    'vendor',
+    '.venv',
+    'venv',
+    '__pycache__',
+]);
+/**
+ * Walk `root` looking for SQLite-looking files, skipping the usual noisy
+ * directories. Results are newest-first, since the file you just wrote is
+ * almost always the one you want.
+ */
+export function findDatabaseFiles(root = process.cwd(), options = {}) {
+    const maxDepth = options.depth ?? 2;
+    const limit = options.limit ?? 50;
+    const found = [];
+    const walk = (dir, depth) => {
+        if (found.length >= limit || depth > maxDepth)
+            return;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return; // Unreadable directory - nothing useful to say about it.
+        }
+        for (const entry of entries) {
+            if (found.length >= limit)
+                return;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (SKIP_DIRS.has(entry.name) || entry.name.startsWith('.'))
+                    continue;
+                walk(full, depth + 1);
+                continue;
+            }
+            if (!entry.isFile())
+                continue;
+            if (!DB_EXTENSIONS.includes(path.extname(entry.name).toLowerCase()))
+                continue;
+            // WAL/SHM siblings are not databases you can open directly.
+            if (/-(wal|shm)$/.test(entry.name))
+                continue;
+            try {
+                const stats = statSync(full);
+                found.push({
+                    path: full,
+                    relativePath: path.relative(root, full) || entry.name,
+                    sizeBytes: stats.size,
+                    modified: stats.mtime,
+                });
+            }
+            catch {
+                // File vanished between readdir and stat - ignore.
+            }
+        }
+    };
+    walk(root, 0);
+    found.sort((a, b) => b.modified.getTime() - a.modified.getTime());
+    return found;
+}
+export function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    const units = ['KB', 'MB', 'GB', 'TB'];
+    let value = bytes / 1024;
+    let unit = 0;
+    while (value >= 1024 && unit < units.length - 1) {
+        value /= 1024;
+        unit += 1;
+    }
+    return `${value >= 10 ? Math.round(value) : value.toFixed(1)} ${units[unit]}`;
+}
+export function formatRelativeTime(date, now = new Date()) {
+    const seconds = Math.max(0, Math.round((now.getTime() - date.getTime()) / 1000));
+    if (seconds < 60)
+        return 'just now';
+    const minutes = Math.round(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.round(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.round(hours / 24);
+    if (days < 30)
+        return `${days}d ago`;
+    return date.toISOString().slice(0, 10);
+}
+/**
+ * List the tables in the database, flagging which ones look like MongoLite
+ * collections (an `_id` column plus a `data` column). Foreign tables are still
+ * reported so a user pointed at the wrong file gets a useful message rather
+ * than an empty list.
+ */
+export async function listCollectionInfo(db) {
+    const tables = await db.all(`SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' ORDER BY name`);
+    const infos = [];
+    for (const { name } of tables) {
+        let isMongoLite = false;
+        try {
+            const columns = await db.all(`PRAGMA table_info("${name}")`);
+            const columnNames = new Set(columns.map((column) => column.name));
+            isMongoLite = columnNames.has('_id') && columnNames.has('data');
+        }
+        catch {
+            isMongoLite = false;
+        }
+        let count = 0;
+        try {
+            const row = await db.get(`SELECT COUNT(*) as count FROM "${name}"`);
+            count = row?.count ?? 0;
+        }
+        catch {
+            count = 0;
+        }
+        infos.push({ name, count, isMongoLite });
+    }
+    return infos;
+}
+/** Resolve a user-supplied database path, allowing `:memory:` and `~` shorthand. */
+export function resolveDatabasePath(input) {
+    if (input === ':memory:')
+        return input;
+    const expanded = input.startsWith('~')
+        ? path.join(process.env.HOME ?? '', input.slice(1))
+        : input;
+    return path.resolve(expanded);
+}
+export function databaseExists(dbPath) {
+    return dbPath === ':memory:' || existsSync(dbPath);
+}
+//# sourceMappingURL=discover.js.map

package/dist/cli/discover.js.map

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

package/dist/cli/explorer.d.ts

@@ -0,0 +1,59 @@
+export interface ExplorerOptions {
+    database?: string;
+    collection?: string;
+    verbose?: boolean;
+    /** How many documents to sample when inferring the schema. Default 200. */
+    sampleSize?: number;
+    /** Rows shown per page of results. Default 20. */
+    pageSize?: number;
+}
+export declare class Explorer {
+    private readonly options;
+    private client;
+    private dbPath;
+    private collectionName;
+    private schema;
+    private lastSql;
+    private lastQuery;
+    /**
+     * `-d`/`-c` are a starting point, not a preference. Once they have been
+     * honoured they are forgotten, otherwise "open a different database" would
+     * take you straight back to the one on the command line.
+     */
+    private startingDatabaseUsed;
+    private startingCollectionUsed;
+    private readonly sampleSize;
+    private readonly pageSize;
+    constructor(options?: ExplorerOptions);
+    run(): Promise<void>;
+    private disconnect;
+    private chooseDatabase;
+    private connect;
+    private chooseCollection;
+    private useCollection;
+    private collectionMenu;
+    private guidedFind;
+    /** Collect conditions until the user is done. Returns null when cancelled. */
+    private buildConditions;
+    private buildOneCondition;
+    /**
+     * Ask for one value. When the field has few distinct values in the sample we
+     * offer them as a menu — no typing, no guessing at spelling or casing.
+     */
+    private askForValue;
+    private chooseSort;
+    private runQuery;
+    private chooseColumns;
+    private exportDocuments;
+    private countFlow;
+    private distinctFlow;
+    private groupFlow;
+    private pickField;
+    private showSchema;
+    private showIndexes;
+    private jsonFilterFlow;
+    private runRawSql;
+    private showLastSql;
+    private requireClient;
+    private collection;
+}