cursor-history 0.6.0 → 0.9.1

package/dist/core/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/database/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,mBAAmB;AACnB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAErB,8BAA8B;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,iCAAiC;AACjC,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;AACpC,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,OAAO,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY;IACtD,OAAO,QAAQ,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,QAAQ,CAAC,eAAe,EAAE,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,QAAQ,CAAC,eAAe,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAsC;IACpE,OAAO,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,QAAQ,CAAC,oBAAoB,EAAE,CAAC;AACzC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB;IACvC,OAAO,QAAQ,CAAC,mBAAmB,EAAE,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,QAAQ,CAAC,YAAY,EAAE,CAAC;AAChC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB,EAAE,QAAgB;IACvE,OAAO,QAAQ,CAAC,cAAc,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACvD,CAAC"}

package/dist/core/database/registry.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Driver Registry - Singleton for managing SQLite driver selection
+ *
+ * Handles auto-detection, manual selection, and runtime switching of drivers.
+ */
+import type { Database, DatabaseDriver, DriverName } from './types.js';
+/**
+ * Singleton registry for managing SQLite drivers
+ */
+declare class DriverRegistry {
+    private drivers;
+    private currentDriver;
+    private initialized;
+    /**
+     * Register a driver with the registry
+     */
+    register(driver: DatabaseDriver): void;
+    /**
+     * Get all registered driver names
+     */
+    getRegisteredDrivers(): string[];
+    /**
+     * Check which drivers are currently available
+     */
+    getAvailableDrivers(): Promise<string[]>;
+    /**
+     * Auto-detect and select the best available driver
+     *
+     * Priority:
+     * 1. User-specified via CURSOR_HISTORY_SQLITE_DRIVER env var
+     * 2. node:sqlite (no native bindings, ESM compatible)
+     * 3. better-sqlite3 (fallback)
+     */
+    autoSelect(): Promise<DatabaseDriver>;
+    /**
+     * Manually set the active driver by name
+     */
+    setDriver(name: DriverName): Promise<void>;
+    /**
+     * Get the name of the currently active driver
+     */
+    getActiveDriver(): string;
+    /**
+     * Check if a driver has been selected
+     */
+    hasActiveDriver(): boolean;
+    /**
+     * Get the current driver, auto-selecting if needed
+     */
+    ensureDriver(): Promise<DatabaseDriver>;
+    /**
+     * Open a database in read-only mode
+     */
+    openDatabase(path: string): Promise<Database>;
+    /**
+     * Open a database in read-write mode
+     */
+    openDatabaseReadWrite(path: string): Promise<Database>;
+    /**
+     * Synchronous database open (requires driver to already be selected)
+     *
+     * This is used by backup module which needs synchronous access.
+     * Auto-selection must have happened before calling this.
+     */
+    openSync(path: string, options: {
+        readonly: boolean;
+    }): Database;
+    /**
+     * Backup a database file to another location
+     *
+     * Uses the native SQLite backup API for consistent snapshots.
+     */
+    backupDatabase(sourcePath: string, destPath: string): Promise<void>;
+    /**
+     * Reset the registry (mainly for testing)
+     */
+    reset(): void;
+}
+export declare const registry: DriverRegistry;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/database/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/database/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAIvE;;GAEG;AACH,cAAM,cAAc;IAClB,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,WAAW,CAAS;IAE5B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAKtC;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAU9C;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;IAuC3C;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBhD;;OAEG;IACH,eAAe,IAAI,MAAM;IAOzB;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC;IAO7C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKnD;;OAEG;IACG,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAK5D;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,GAAG,QAAQ;IAUhE;;;;OAIG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd;AAGD,eAAO,MAAM,QAAQ,gBAAuB,CAAC"}

package/dist/core/database/registry.js

@@ -0,0 +1,171 @@
+/**
+ * Driver Registry - Singleton for managing SQLite driver selection
+ *
+ * Handles auto-detection, manual selection, and runtime switching of drivers.
+ */
+import { NoDriverAvailableError, DriverNotAvailableError } from './errors.js';
+import { debugLog } from './debug.js';
+/**
+ * Singleton registry for managing SQLite drivers
+ */
+class DriverRegistry {
+    drivers = new Map();
+    currentDriver = null;
+    initialized = false;
+    /**
+     * Register a driver with the registry
+     */
+    register(driver) {
+        this.drivers.set(driver.name, driver);
+        debugLog(`Registered driver: ${driver.name}`);
+    }
+    /**
+     * Get all registered driver names
+     */
+    getRegisteredDrivers() {
+        return Array.from(this.drivers.keys());
+    }
+    /**
+     * Check which drivers are currently available
+     */
+    async getAvailableDrivers() {
+        const available = [];
+        for (const [name, driver] of this.drivers) {
+            if (await driver.isAvailable()) {
+                available.push(name);
+            }
+        }
+        return available;
+    }
+    /**
+     * Auto-detect and select the best available driver
+     *
+     * Priority:
+     * 1. User-specified via CURSOR_HISTORY_SQLITE_DRIVER env var
+     * 2. node:sqlite (no native bindings, ESM compatible)
+     * 3. better-sqlite3 (fallback)
+     */
+    async autoSelect() {
+        // Check for user override via environment variable
+        const envDriver = process.env['CURSOR_HISTORY_SQLITE_DRIVER'];
+        if (envDriver) {
+            debugLog(`Environment override: CURSOR_HISTORY_SQLITE_DRIVER=${envDriver}`);
+            const driver = this.drivers.get(envDriver);
+            if (driver && (await driver.isAvailable())) {
+                this.currentDriver = driver;
+                this.initialized = true;
+                debugLog(`Using driver from env var: ${driver.name}`);
+                return driver;
+            }
+            // Driver specified but not available
+            const available = await this.getAvailableDrivers();
+            throw new DriverNotAvailableError(envDriver, available);
+        }
+        // Auto-detect: try node:sqlite first (no native bindings)
+        const nodeSqlite = this.drivers.get('node:sqlite');
+        if (nodeSqlite && (await nodeSqlite.isAvailable())) {
+            this.currentDriver = nodeSqlite;
+            this.initialized = true;
+            debugLog(`Auto-selected driver: node:sqlite`);
+            return nodeSqlite;
+        }
+        // Fallback to better-sqlite3
+        const betterSqlite = this.drivers.get('better-sqlite3');
+        if (betterSqlite && (await betterSqlite.isAvailable())) {
+            this.currentDriver = betterSqlite;
+            this.initialized = true;
+            debugLog(`Auto-selected driver: better-sqlite3`);
+            return betterSqlite;
+        }
+        // No driver available
+        throw new NoDriverAvailableError();
+    }
+    /**
+     * Manually set the active driver by name
+     */
+    async setDriver(name) {
+        const driver = this.drivers.get(name);
+        if (!driver) {
+            const available = await this.getAvailableDrivers();
+            throw new DriverNotAvailableError(name, available);
+        }
+        if (!(await driver.isAvailable())) {
+            const available = await this.getAvailableDrivers();
+            throw new DriverNotAvailableError(name, available);
+        }
+        this.currentDriver = driver;
+        this.initialized = true;
+        debugLog(`Manually set driver: ${name}`);
+    }
+    /**
+     * Get the name of the currently active driver
+     */
+    getActiveDriver() {
+        if (!this.currentDriver) {
+            throw new Error('No driver is currently active. Call autoSelect() or setDriver() first.');
+        }
+        return this.currentDriver.name;
+    }
+    /**
+     * Check if a driver has been selected
+     */
+    hasActiveDriver() {
+        return this.currentDriver !== null;
+    }
+    /**
+     * Get the current driver, auto-selecting if needed
+     */
+    async ensureDriver() {
+        if (!this.initialized || !this.currentDriver) {
+            return this.autoSelect();
+        }
+        return this.currentDriver;
+    }
+    /**
+     * Open a database in read-only mode
+     */
+    async openDatabase(path) {
+        const driver = await this.ensureDriver();
+        return driver.open(path, { readonly: true });
+    }
+    /**
+     * Open a database in read-write mode
+     */
+    async openDatabaseReadWrite(path) {
+        const driver = await this.ensureDriver();
+        return driver.open(path, { readonly: false });
+    }
+    /**
+     * Synchronous database open (requires driver to already be selected)
+     *
+     * This is used by backup module which needs synchronous access.
+     * Auto-selection must have happened before calling this.
+     */
+    openSync(path, options) {
+        if (!this.currentDriver) {
+            throw new Error('No driver is currently active. Auto-selection must complete before using openSync(). ' +
+                'Call a database operation first to trigger auto-selection.');
+        }
+        return this.currentDriver.open(path, options);
+    }
+    /**
+     * Backup a database file to another location
+     *
+     * Uses the native SQLite backup API for consistent snapshots.
+     */
+    async backupDatabase(sourcePath, destPath) {
+        const driver = await this.ensureDriver();
+        return driver.backup(sourcePath, destPath);
+    }
+    /**
+     * Reset the registry (mainly for testing)
+     */
+    reset() {
+        this.currentDriver = null;
+        this.initialized = false;
+        debugLog('Registry reset');
+    }
+}
+// Singleton instance
+export const registry = new DriverRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/core/database/registry.js.map

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

package/dist/core/database/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Pluggable SQLite Driver - Type Definitions
+ *
+ * These interfaces define the contract for the driver abstraction layer.
+ * Both better-sqlite3 and node:sqlite adapters must conform to these types.
+ */
+/**
+ * Result of running a statement that modifies data (INSERT/UPDATE/DELETE)
+ */
+export interface RunResult {
+    /** Number of rows affected by the operation */
+    changes: number;
+    /** Row ID of the last inserted row (for INSERT operations) */
+    lastInsertRowid: number | bigint;
+}
+/**
+ * Prepared SQL statement that can be run multiple times with different parameters
+ */
+export interface Statement {
+    /**
+     * Run the statement and return the first row
+     * @param params - Bind parameters for the query
+     * @returns The first row as an object, or undefined if no rows
+     */
+    get(...params: unknown[]): unknown;
+    /**
+     * Run the statement and return all rows
+     * @param params - Bind parameters for the query
+     * @returns Array of row objects (empty array if no rows)
+     */
+    all(...params: unknown[]): unknown[];
+    /**
+     * Run the statement for side effects (INSERT/UPDATE/DELETE)
+     * @param params - Bind parameters for the query
+     * @returns Result containing changes count and last insert ID
+     */
+    run(...params: unknown[]): RunResult;
+}
+/**
+ * Open database connection
+ */
+export interface Database {
+    /**
+     * Create a prepared statement from SQL
+     * @param sql - SQL query string
+     * @returns Prepared statement object
+     */
+    prepare(sql: string): Statement;
+    /**
+     * Run raw SQL directly without returning results
+     * Useful for DDL statements or multiple statements
+     * Note: Named 'runSQL' to avoid confusion with child_process methods
+     * @param sql - SQL to run
+     */
+    runSQL(sql: string): void;
+    /**
+     * Close the database connection
+     * After calling this, the database object should not be used
+     */
+    close(): void;
+}
+/**
+ * Options for opening a database connection
+ */
+export interface DatabaseOptions {
+    /** If true, open in read-only mode (writes will fail) */
+    readonly: boolean;
+}
+/**
+ * Pluggable database driver implementation
+ *
+ * Each driver adapter (better-sqlite3, node:sqlite, etc.) must implement
+ * this interface to be usable with the driver registry.
+ */
+export interface DatabaseDriver {
+    /** Unique identifier for this driver (e.g., "better-sqlite3", "node:sqlite") */
+    readonly name: string;
+    /**
+     * Check if this driver is available in the current environment
+     *
+     * This method should:
+     * - Attempt to load/import the underlying driver
+     * - Return true if successful, false otherwise
+     * - Not throw exceptions
+     *
+     * @returns Promise resolving to availability status
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Open a database connection using this driver
+     *
+     * @param path - Path to the SQLite database file
+     * @param options - Connection options (readonly, etc.)
+     * @returns Open database connection
+     * @throws Error if database cannot be opened
+     */
+    open(path: string, options: DatabaseOptions): Database;
+    /**
+     * Backup a database to another file
+     *
+     * Uses the native SQLite backup API for consistent snapshots even
+     * while the source database is being written to.
+     *
+     * @param sourcePath - Path to the source database file
+     * @param destPath - Path where backup will be created
+     * @returns Promise that resolves when backup is complete
+     * @throws Error if backup fails
+     */
+    backup(sourcePath: string, destPath: string): Promise<void>;
+}
+/**
+ * Driver names that can be used for manual selection
+ */
+export type DriverName = 'better-sqlite3' | 'node:sqlite';
+//# sourceMappingURL=types.d.ts.map

package/dist/core/database/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/database/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAEnC;;;;OAIG;IACH,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;IAErC;;;;OAIG;IACH,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IAEhC;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;;;;;;OASG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;;;;;;OAOG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,QAAQ,CAAC;IAEvD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG,aAAa,CAAC"}

package/dist/core/database/types.js

@@ -0,0 +1,8 @@
+/**
+ * Pluggable SQLite Driver - Type Definitions
+ *
+ * These interfaces define the contract for the driver abstraction layer.
+ * Both better-sqlite3 and node:sqlite adapters must conform to these types.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/database/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/database/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/migrate.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Core migration logic for Cursor chat history
+ *
+ * This module provides session-level migration as the core primitive.
+ * Workspace-level migration is built on top of session migration.
+ */
+import type { MigrateSessionOptions, MigrateWorkspaceOptions, SessionMigrationResult, WorkspaceMigrationResult } from './types.js';
+/**
+ * Migrate a single session from its current workspace to a destination workspace.
+ *
+ * This is the core primitive for all migration operations.
+ * Move mode: removes session from source, adds to destination.
+ * Copy mode: duplicates session to destination, keeps source intact.
+ *
+ * @param sessionId - The session ID to migrate
+ * @param options - Migration options
+ * @returns Migration result for this session
+ */
+export declare function migrateSession(sessionId: string, options: Omit<MigrateSessionOptions, 'sessionIds'>): Promise<SessionMigrationResult>;
+/**
+ * Migrate multiple sessions to a destination workspace.
+ *
+ * Handles batch migration with partial failure support.
+ * Each session is migrated independently - failures don't stop the batch.
+ *
+ * @param options - Migration options including session IDs
+ * @returns Array of results for each session
+ */
+export declare function migrateSessions(options: MigrateSessionOptions): Promise<SessionMigrationResult[]>;
+/**
+ * Migrate all sessions from one workspace to another.
+ *
+ * This is a convenience wrapper that finds all sessions in the source workspace
+ * and calls migrateSession for each one.
+ *
+ * @param options - Workspace migration options
+ * @returns Aggregate result with per-session details
+ */
+export declare function migrateWorkspace(options: MigrateWorkspaceOptions): Promise<WorkspaceMigrationResult>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/core/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/core/migrate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AA+apB;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,YAAY,CAAC,GACjD,OAAO,CAAC,sBAAsB,CAAC,CA+IjC;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAuBvG;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAoF1G"}