cursor-history 0.5.1 → 0.8.0

package/dist/lib/types.d.ts

@@ -0,0 +1,374 @@
+/**
+ * Public TypeScript type definitions for cursor-history library
+ *
+ * IMPORTANT: This is a library interface for direct import and use in TypeScript/JavaScript
+ * projects, NOT a network/REST API. Functions are imported directly:
+ * `import { Session, Message } from 'cursor-history'`
+ */
+/**
+ * Represents a complete chat conversation with metadata and messages.
+ */
+export interface Session {
+    /** Unique identifier (database row ID or composite key) */
+    id: string;
+    /** Absolute path to workspace directory */
+    workspace: string;
+    /** ISO 8601 timestamp of session creation */
+    timestamp: string;
+    /** Array of messages in chronological order */
+    messages: Message[];
+    /** Total number of messages in session */
+    messageCount: number;
+    /** Metadata about session origin (optional) */
+    metadata?: {
+        /** Cursor version that created this session */
+        cursorVersion?: string;
+        /** Last modified timestamp */
+        lastModified?: string;
+    };
+}
+/**
+ * Represents a single message within a session (user or assistant).
+ */
+export interface Message {
+    /** Message role: 'user' or 'assistant' */
+    role: 'user' | 'assistant';
+    /** Message content (text, code blocks, or structured data) */
+    content: string;
+    /** ISO 8601 timestamp when message was created */
+    timestamp: string;
+    /** Tool calls executed by assistant (optional, assistant-only) */
+    toolCalls?: ToolCall[];
+    /** AI reasoning/thinking text (optional, assistant-only) */
+    thinking?: string;
+    /** Metadata about message processing (optional) */
+    metadata?: {
+        /** Whether message data was partially corrupted */
+        corrupted?: boolean;
+        /** Original bubble type from database (for debugging) */
+        bubbleType?: number;
+    };
+}
+/**
+ * Represents a tool/function call executed by the assistant.
+ */
+export interface ToolCall {
+    /** Tool/function name (e.g., 'read_file', 'write', 'grep') */
+    name: string;
+    /** Tool execution status */
+    status: 'completed' | 'cancelled' | 'error';
+    /** Tool parameters as JSON object */
+    params?: Record<string, unknown>;
+    /** Tool execution result (optional, present if status === 'completed') */
+    result?: string;
+    /** Error message (optional, present if status === 'error') */
+    error?: string;
+    /** File paths involved in this tool call (optional) */
+    files?: string[];
+}
+/**
+ * Represents a search match with context.
+ */
+export interface SearchResult {
+    /** Reference to the session containing this match */
+    session: Session;
+    /** Matched content snippet */
+    match: string;
+    /** Message index within session where match was found */
+    messageIndex: number;
+    /** Context lines before match (optional, based on config) */
+    contextBefore?: string[];
+    /** Context lines after match (optional, based on config) */
+    contextAfter?: string[];
+    /** Character offset of match within message content */
+    offset?: number;
+}
+/**
+ * Configuration options for library functions.
+ */
+export interface LibraryConfig {
+    /** Custom Cursor data path (optional, defaults to platform path) */
+    dataPath?: string;
+    /** Filter sessions by workspace path (optional) */
+    workspace?: string;
+    /** Pagination limit (optional, defaults to no limit) */
+    limit?: number;
+    /** Pagination offset (optional, defaults to 0) */
+    offset?: number;
+    /** Search context lines (optional, defaults to 0) */
+    context?: number;
+    /** Read from backup file instead of live data (optional) */
+    backupPath?: string;
+}
+/**
+ * Wrapper for paginated API responses.
+ */
+export interface PaginatedResult<T> {
+    /** Array of data items for current page */
+    data: T[];
+    /** Pagination metadata */
+    pagination: {
+        /** Total number of items across all pages */
+        total: number;
+        /** Maximum items per page (from config.limit) */
+        limit: number;
+        /** Offset of first item in current page (from config.offset) */
+        offset: number;
+        /** Whether more pages exist after this one */
+        hasMore: boolean;
+    };
+}
+/**
+ * Migration mode: move removes from source, copy keeps source intact
+ */
+export type MigrationMode = 'move' | 'copy';
+/**
+ * Configuration for session-level migration.
+ */
+export interface MigrateSessionConfig {
+    /**
+     * Session identifier(s) to migrate.
+     * Can be:
+     * - Single session ID (UUID): "abc123-def456"
+     * - Single index (1-based): "3" or 3
+     * - Multiple comma-separated: "1,3,5" or "abc123,def456"
+     * - Array of IDs/indices: ["1", "3"] or [1, 3]
+     */
+    sessions: string | number | (string | number)[];
+    /** Destination workspace path (absolute or relative, resolved to absolute) */
+    destination: string;
+    /** Migration mode: 'move' (default) or 'copy' */
+    mode?: MigrationMode;
+    /** If true, preview without making changes */
+    dryRun?: boolean;
+    /** If true, proceed even if destination has existing history */
+    force?: boolean;
+    /** Custom Cursor data path (optional, uses default if not specified) */
+    dataPath?: string;
+}
+/**
+ * Configuration for workspace-level migration.
+ */
+export interface MigrateWorkspaceConfig {
+    /** Source workspace path to migrate from (exact match) */
+    source: string;
+    /** Destination workspace path to migrate to */
+    destination: string;
+    /** Migration mode: 'move' (default) or 'copy' */
+    mode?: MigrationMode;
+    /** If true, preview without making changes */
+    dryRun?: boolean;
+    /** If true, proceed even if destination has existing history */
+    force?: boolean;
+    /** Custom Cursor data path (optional, uses default if not specified) */
+    dataPath?: string;
+}
+/**
+ * Result of migrating a single session.
+ */
+export interface SessionMigrationResult {
+    /** Whether migration succeeded */
+    success: boolean;
+    /** Original session ID */
+    sessionId: string;
+    /** Source workspace path */
+    sourceWorkspace: string;
+    /** Destination workspace path */
+    destinationWorkspace: string;
+    /** Mode used for migration */
+    mode: MigrationMode;
+    /** For copy mode: the new session ID created */
+    newSessionId?: string;
+    /** Error message if success is false */
+    error?: string;
+    /** Whether this was a dry run */
+    dryRun: boolean;
+}
+/**
+ * Aggregate result of workspace migration.
+ */
+export interface WorkspaceMigrationResult {
+    /** True if all sessions migrated successfully */
+    success: boolean;
+    /** Normalized source path */
+    source: string;
+    /** Normalized destination path */
+    destination: string;
+    /** Mode used for migration */
+    mode: MigrationMode;
+    /** Total number of sessions attempted */
+    totalSessions: number;
+    /** Number of successful migrations */
+    successCount: number;
+    /** Number of failed migrations */
+    failureCount: number;
+    /** Per-session results */
+    results: SessionMigrationResult[];
+    /** Whether this was a dry run */
+    dryRun: boolean;
+}
+/**
+ * Metadata stored in the manifest.json file within the backup zip.
+ */
+export interface BackupManifest {
+    /** Manifest schema version for backward compatibility */
+    version: string;
+    /** ISO 8601 timestamp when backup was created */
+    createdAt: string;
+    /** Platform where backup was created */
+    sourcePlatform: 'darwin' | 'win32' | 'linux';
+    /** cursor-history version that created the backup */
+    cursorHistoryVersion: string;
+    /** List of files in the backup with metadata */
+    files: BackupFileEntry[];
+    /** Aggregate statistics for quick display */
+    stats: BackupStats;
+}
+/**
+ * A single file entry in the backup manifest.
+ */
+export interface BackupFileEntry {
+    /** Path within zip (forward slashes, relative to zip root) */
+    path: string;
+    /** Original file size in bytes */
+    size: number;
+    /** SHA-256 checksum for integrity verification */
+    checksum: string;
+    /** File type for categorization */
+    type: 'global-db' | 'workspace-db' | 'workspace-json' | 'manifest';
+}
+/**
+ * Aggregate statistics for a backup.
+ */
+export interface BackupStats {
+    /** Total uncompressed size of all files */
+    totalSize: number;
+    /** Number of chat sessions across all workspaces */
+    sessionCount: number;
+    /** Number of workspaces included */
+    workspaceCount: number;
+}
+/**
+ * Configuration for backup creation operation.
+ */
+export interface BackupConfig {
+    /** Source Cursor data path (default: platform-specific) */
+    sourcePath?: string;
+    /** Output file path (default: ~/cursor-history-backups/<timestamp>.zip) */
+    outputPath?: string;
+    /** Overwrite existing file without prompting */
+    force?: boolean;
+    /** Progress callback for UI updates */
+    onProgress?: (progress: BackupProgress) => void;
+}
+/**
+ * Progress information during backup operation.
+ */
+export interface BackupProgress {
+    /** Current operation phase */
+    phase: 'scanning' | 'backing-up' | 'compressing' | 'finalizing';
+    /** Current file being processed */
+    currentFile?: string;
+    /** Files completed / total files */
+    filesCompleted: number;
+    totalFiles: number;
+    /** Bytes completed / total bytes */
+    bytesCompleted: number;
+    totalBytes: number;
+}
+/**
+ * Result of a backup operation.
+ */
+export interface BackupResult {
+    /** Whether backup succeeded */
+    success: boolean;
+    /** Path to created backup file */
+    backupPath: string;
+    /** Generated manifest */
+    manifest: BackupManifest;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Configuration for restore operation.
+ */
+export interface RestoreConfig {
+    /** Path to backup zip file */
+    backupPath: string;
+    /** Target Cursor data path (default: platform-specific) */
+    targetPath?: string;
+    /** Overwrite existing data without prompting */
+    force?: boolean;
+    /** Progress callback for UI updates */
+    onProgress?: (progress: RestoreProgress) => void;
+}
+/**
+ * Progress information during restore operation.
+ */
+export interface RestoreProgress {
+    /** Current operation phase */
+    phase: 'validating' | 'extracting' | 'finalizing';
+    /** Current file being processed */
+    currentFile?: string;
+    /** Files completed / total files */
+    filesCompleted: number;
+    totalFiles: number;
+    /** Integrity status */
+    integrityStatus: 'pending' | 'passed' | 'warnings' | 'failed';
+    /** Files with checksum warnings (if any) */
+    corruptedFiles?: string[];
+}
+/**
+ * Result of a restore operation.
+ */
+export interface RestoreResult {
+    /** Whether restore succeeded */
+    success: boolean;
+    /** Path where data was restored */
+    targetPath: string;
+    /** Number of files restored */
+    filesRestored: number;
+    /** Files with integrity warnings (still restored) */
+    warnings: string[];
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Result of backup integrity validation.
+ */
+export interface BackupValidation {
+    /** Overall validation status */
+    status: 'valid' | 'warnings' | 'invalid';
+    /** Manifest if parseable */
+    manifest?: BackupManifest;
+    /** Files that passed checksum verification */
+    validFiles: string[];
+    /** Files that failed checksum verification */
+    corruptedFiles: string[];
+    /** Files missing from manifest */
+    missingFiles: string[];
+    /** Detailed error messages */
+    errors: string[];
+}
+/**
+ * Metadata about a backup file for listing purposes.
+ */
+export interface BackupInfo {
+    /** Full path to the backup file */
+    filePath: string;
+    /** Backup filename */
+    filename: string;
+    /** File size in bytes */
+    fileSize: number;
+    /** File modification time (from filesystem) */
+    modifiedAt: Date;
+    /** Parsed manifest (if valid backup) */
+    manifest?: BackupManifest;
+    /** Error if backup is invalid or corrupted */
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

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

package/dist/lib/types.js

@@ -0,0 +1,9 @@
+/**
+ * Public TypeScript type definitions for cursor-history library
+ *
+ * IMPORTANT: This is a library interface for direct import and use in TypeScript/JavaScript
+ * projects, NOT a network/REST API. Functions are imported directly:
+ * `import { Session, Message } from 'cursor-history'`
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

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

package/dist/lib/utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Utility functions for library API
+ */
+/**
+ * Get the platform-specific default Cursor data path.
+ *
+ * @returns Absolute path to Cursor data directory
+ *
+ * @example
+ * const defaultPath = getDefaultDataPath();
+ * console.log(defaultPath);
+ * // macOS: ~/Library/Application Support/Cursor/User/workspaceStorage
+ * // Linux: ~/.config/Cursor/User/workspaceStorage
+ * // Windows: %APPDATA%\Cursor\User\workspaceStorage
+ */
+export declare function getDefaultDataPath(): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/lib/utils.js

@@ -0,0 +1,20 @@
+/**
+ * Utility functions for library API
+ */
+import { getCursorDataPath } from '../lib/platform.js';
+/**
+ * Get the platform-specific default Cursor data path.
+ *
+ * @returns Absolute path to Cursor data directory
+ *
+ * @example
+ * const defaultPath = getDefaultDataPath();
+ * console.log(defaultPath);
+ * // macOS: ~/Library/Application Support/Cursor/User/workspaceStorage
+ * // Linux: ~/.config/Cursor/User/workspaceStorage
+ * // Windows: %APPDATA%\Cursor\User\workspaceStorage
+ */
+export function getDefaultDataPath() {
+    return getCursorDataPath();
+}
+//# sourceMappingURL=utils.js.map

package/dist/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC"}

package/package.json

@@ -1,12 +1,20 @@
 {
   "name": "cursor-history",
-  "version": "0.5.1",
-  "description": "CLI tool to browse and export Cursor AI chat history",
+  "version": "0.8.0",
+  "description": "The ultimate CLI tool and library to browse, search, export, migrate, and backup your Cursor AI chat history",
   "type": "module",
-  "main": "dist/cli/index.js",
+  "main": "dist/lib/index.js",
+  "types": "dist/lib/index.d.ts",
   "bin": {
     "cursor-history": "dist/cli/index.js"
   },
+  "exports": {
+    ".": {
+      "import": "./dist/lib/index.js",
+      "require": "./dist/lib/index.cjs",
+      "types": "./dist/lib/index.d.ts"
+    }
+  },
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
@@ -23,8 +31,26 @@
     "cursor",
     "chat",
     "history",
+    "ai",
+    "assistant",
+    "conversation",
+    "export",
+    "backup",
+    "restore",
+    "migrate",
     "cli",
-    "ai"
+    "developer",
+    "tools",
+    "devtools",
+    "productivity",
+    "code",
+    "llm",
+    "vscode",
+    "sqlite",
+    "search",
+    "typescript",
+    "ide",
+    "editor"
   ],
   "author": "",
   "license": "MIT",
@@ -48,11 +74,13 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
+    "adm-zip": "^0.5.16",
     "better-sqlite3": "^12.5.0",
     "commander": "^14.0.2",
     "picocolors": "^1.1.1"
   },
   "devDependencies": {
+    "@types/adm-zip": "^0.5.7",
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^25.0.3",
     "eslint": "^9.39.2",