@semics-tech/mongolite 1.1.0 → 1.3.0

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;
+}