cursor-history 0.5.1 → 0.8.0

package/dist/lib/backup.js

@@ -0,0 +1,108 @@
+/**
+ * Library API for backup and restore operations
+ *
+ * IMPORTANT: This is a library interface for direct import and use in TypeScript/JavaScript
+ * projects, NOT a network/REST API.
+ */
+import { createBackup as coreCreateBackup, restoreBackup as coreRestoreBackup, validateBackup as coreValidateBackup, listBackups as coreListBackups, getDefaultBackupDir as coreGetDefaultBackupDir, } from '../core/backup.js';
+/**
+ * Create a full backup of Cursor chat history.
+ *
+ * @param config - Optional backup configuration
+ * @returns Promise resolving to backup result
+ *
+ * @example
+ * ```typescript
+ * import { createBackup } from 'cursor-history';
+ *
+ * // Basic usage
+ * const result = await createBackup();
+ * console.log(`Backup created: ${result.backupPath}`);
+ *
+ * // With options
+ * const result = await createBackup({
+ *   outputPath: '/path/to/backup.zip',
+ *   force: true,
+ *   onProgress: (progress) => {
+ *     console.log(`${progress.phase}: ${progress.filesCompleted}/${progress.totalFiles}`);
+ *   }
+ * });
+ * ```
+ */
+export async function createBackup(config) {
+    return coreCreateBackup(config);
+}
+/**
+ * Restore Cursor chat history from a backup file.
+ *
+ * @param config - Restore configuration (backupPath required)
+ * @returns Restore result
+ *
+ * @example
+ * ```typescript
+ * import { restoreBackup } from 'cursor-history';
+ *
+ * const result = restoreBackup({
+ *   backupPath: '/path/to/backup.zip',
+ *   force: true
+ * });
+ * ```
+ */
+export function restoreBackup(config) {
+    return coreRestoreBackup(config);
+}
+/**
+ * Validate a backup file's integrity without restoring.
+ *
+ * @param backupPath - Path to backup zip file
+ * @returns Validation result with status and details
+ *
+ * @example
+ * ```typescript
+ * import { validateBackup } from 'cursor-history';
+ *
+ * const validation = validateBackup('/path/to/backup.zip');
+ * if (validation.status === 'valid') {
+ *   console.log('Backup is valid');
+ * }
+ * ```
+ */
+export function validateBackup(backupPath) {
+    return coreValidateBackup(backupPath);
+}
+/**
+ * List available backup files in a directory.
+ *
+ * @param directory - Directory to scan (default: ~/cursor-history-backups)
+ * @returns Array of backup info objects
+ *
+ * @example
+ * ```typescript
+ * import { listBackups } from 'cursor-history';
+ *
+ * const backups = listBackups();
+ * for (const backup of backups) {
+ *   console.log(`${backup.filename}: ${backup.manifest?.stats.sessionCount} sessions`);
+ * }
+ * ```
+ */
+export function listBackups(directory) {
+    return coreListBackups(directory);
+}
+/**
+ * Get the default backup directory path.
+ *
+ * @returns Default backup directory path (~/cursor-history-backups)
+ *
+ * @example
+ * ```typescript
+ * import { getDefaultBackupDir } from 'cursor-history';
+ *
+ * const dir = getDefaultBackupDir();
+ * // Returns: /home/user/cursor-history-backups (Linux)
+ * ```
+ */
+export function getDefaultBackupDir() {
+    return coreGetDefaultBackupDir();
+}
+//# sourceMappingURL=backup.js.map

package/dist/lib/backup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup.js","sourceRoot":"","sources":["../../src/lib/backup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,IAAI,gBAAgB,EAChC,aAAa,IAAI,iBAAiB,EAClC,cAAc,IAAI,kBAAkB,EACpC,WAAW,IAAI,eAAe,EAC9B,mBAAmB,IAAI,uBAAuB,GAC/C,MAAM,mBAAmB,CAAC;AAW3B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAqB;IACtD,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,OAAO,kBAAkB,CAAC,UAAU,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,WAAW,CAAC,SAAkB;IAC5C,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,uBAAuB,EAAE,CAAC;AACnC,CAAC"}

package/dist/lib/config.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Configuration handling and validation for library API
+ *
+ * IMPORTANT: This is a library interface for direct import and use in TypeScript/JavaScript
+ * projects, NOT a network/REST API.
+ */
+import type { LibraryConfig } from './types.js';
+/**
+ * Merged configuration with all defaults applied
+ */
+export interface ResolvedConfig {
+    dataPath: string;
+    workspace?: string;
+    limit: number;
+    offset: number;
+    context: number;
+    backupPath?: string;
+}
+/**
+ * Validate configuration parameters
+ * @throws {InvalidConfigError} If any parameter is invalid
+ */
+export declare function validateConfig(config?: LibraryConfig): void;
+/**
+ * Merge user configuration with defaults
+ */
+export declare function mergeWithDefaults(config?: LibraryConfig): ResolvedConfig;
+/**
+ * Resolve database path with symlink handling
+ * @throws {DatabaseNotFoundError} If path does not exist
+ */
+export declare function resolveDatabasePath(configPath?: string): string;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAsC3D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,cAAc,CAaxE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAW/D"}

package/dist/lib/config.js

@@ -0,0 +1,81 @@
+/**
+ * Configuration handling and validation for library API
+ *
+ * IMPORTANT: This is a library interface for direct import and use in TypeScript/JavaScript
+ * projects, NOT a network/REST API.
+ */
+import { realpathSync } from 'node:fs';
+import { resolve, normalize, isAbsolute } from 'node:path';
+import { InvalidConfigError, DatabaseNotFoundError } from './errors.js';
+import { getCursorDataPath } from '../lib/platform.js';
+/**
+ * Validate configuration parameters
+ * @throws {InvalidConfigError} If any parameter is invalid
+ */
+export function validateConfig(config) {
+    if (!config)
+        return;
+    // Validate limit
+    if (config.limit !== undefined) {
+        if (typeof config.limit !== 'number' || config.limit < 1 || !Number.isInteger(config.limit)) {
+            throw new InvalidConfigError('limit', config.limit, 'must be a positive integer greater than 0');
+        }
+    }
+    // Validate offset
+    if (config.offset !== undefined) {
+        if (typeof config.offset !== 'number' || config.offset < 0 || !Number.isInteger(config.offset)) {
+            throw new InvalidConfigError('offset', config.offset, 'must be a non-negative integer');
+        }
+    }
+    // Validate context
+    if (config.context !== undefined) {
+        if (typeof config.context !== 'number' || config.context < 0 || !Number.isInteger(config.context)) {
+            throw new InvalidConfigError('context', config.context, 'must be a non-negative integer');
+        }
+    }
+    // Validate workspace path
+    if (config.workspace !== undefined) {
+        if (typeof config.workspace !== 'string') {
+            throw new InvalidConfigError('workspace', config.workspace, 'must be a string');
+        }
+        if (!isAbsolute(config.workspace)) {
+            throw new InvalidConfigError('workspace', config.workspace, 'must be an absolute path');
+        }
+    }
+    // Validate dataPath
+    if (config.dataPath !== undefined && typeof config.dataPath !== 'string') {
+        throw new InvalidConfigError('dataPath', config.dataPath, 'must be a string');
+    }
+}
+/**
+ * Merge user configuration with defaults
+ */
+export function mergeWithDefaults(config) {
+    validateConfig(config);
+    const dataPath = config?.dataPath ?? getCursorDataPath();
+    return {
+        dataPath,
+        workspace: config?.workspace,
+        limit: config?.limit ?? Number.MAX_SAFE_INTEGER,
+        offset: config?.offset ?? 0,
+        context: config?.context ?? 0,
+        backupPath: config?.backupPath,
+    };
+}
+/**
+ * Resolve database path with symlink handling
+ * @throws {DatabaseNotFoundError} If path does not exist
+ */
+export function resolveDatabasePath(configPath) {
+    const basePath = configPath ?? getCursorDataPath();
+    const normalized = normalize(basePath);
+    const resolved = resolve(normalized);
+    try {
+        // Resolve symlinks and verify path exists
+        return realpathSync(resolved);
+    }
+    catch {
+        throw new DatabaseNotFoundError(resolved);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/errors.d.ts

@@ -1,56 +1,283 @@
 /**
- * Error handling utilities and exit codes
+ * Custom error classes for library API
+ *
+ * IMPORTANT: This is a library interface for direct import and use in TypeScript/JavaScript
+ * projects, NOT a network/REST API.
  */
 /**
- * CLI exit codes following Unix conventions
+ * Thrown when database is locked by Cursor or another process.
+ *
+ * Recovery: Close Cursor IDE and retry, or implement custom retry logic.
  */
-export declare const ExitCode: {
-    readonly SUCCESS: 0;
-    readonly GENERAL_ERROR: 1;
-    readonly USAGE_ERROR: 2;
-    readonly NOT_FOUND: 3;
-    readonly IO_ERROR: 4;
-};
-export type ExitCode = (typeof ExitCode)[keyof typeof ExitCode];
+export declare class DatabaseLockedError extends Error {
+    name: "DatabaseLockedError";
+    /** Path to locked database file */
+    path: string;
+    constructor(path: string);
+}
+/**
+ * Thrown when database file or directory does not exist.
+ *
+ * Recovery: Verify Cursor is installed, check dataPath configuration.
+ */
+export declare class DatabaseNotFoundError extends Error {
+    name: "DatabaseNotFoundError";
+    /** Path that was not found */
+    path: string;
+    constructor(path: string);
+}
+/**
+ * Thrown when configuration parameters are invalid.
+ *
+ * Recovery: Fix configuration values per LibraryConfig validation rules.
+ */
+export declare class InvalidConfigError extends Error {
+    name: "InvalidConfigError";
+    /** Name of invalid config field */
+    field: string;
+    /** Invalid value provided */
+    value: unknown;
+    constructor(field: string, value: unknown, reason: string);
+}
+/**
+ * Type guard to check if an error is a DatabaseLockedError.
+ */
+export declare function isDatabaseLockedError(error: unknown): error is DatabaseLockedError;
+/**
+ * Type guard to check if an error is a DatabaseNotFoundError.
+ */
+export declare function isDatabaseNotFoundError(error: unknown): error is DatabaseNotFoundError;
+/**
+ * Type guard to check if an error is an InvalidConfigError.
+ */
+export declare function isInvalidConfigError(error: unknown): error is InvalidConfigError;
+/**
+ * Thrown when a session ID or index cannot be resolved.
+ *
+ * Recovery: Check session exists with `listSessions()`, use valid ID or index.
+ */
+export declare class SessionNotFoundError extends Error {
+    name: "SessionNotFoundError";
+    /** The identifier that was not found (index or UUID) */
+    identifier: string | number;
+    constructor(identifier: string | number);
+}
+/**
+ * Thrown when destination workspace path has no workspace directory.
+ *
+ * Recovery: Open the project in Cursor first to create the workspace directory.
+ */
+export declare class WorkspaceNotFoundError extends Error {
+    name: "WorkspaceNotFoundError";
+    /** The workspace path that was not found */
+    path: string;
+    constructor(path: string);
+}
+/**
+ * Thrown when source and destination paths are the same.
+ *
+ * Recovery: Specify different source and destination paths.
+ */
+export declare class SameWorkspaceError extends Error {
+    name: "SameWorkspaceError";
+    /** The path that was specified for both source and destination */
+    path: string;
+    constructor(path: string);
+}
+/**
+ * Thrown when no sessions are found for the specified source workspace.
+ *
+ * Recovery: Check the source path is correct, verify sessions exist with `list --workspace`.
+ */
+export declare class NoSessionsFoundError extends Error {
+    name: "NoSessionsFoundError";
+    /** The source workspace path */
+    path: string;
+    constructor(path: string);
+}
+/**
+ * Thrown when destination has existing sessions and --force not specified.
+ *
+ * Recovery: Use --force flag to proceed with additive merge.
+ */
+export declare class DestinationHasSessionsError extends Error {
+    name: "DestinationHasSessionsError";
+    /** The destination workspace path */
+    path: string;
+    /** Number of existing sessions at destination */
+    sessionCount: number;
+    constructor(path: string, sessionCount: number);
+}
+/**
+ * Type guard to check if an error is a SessionNotFoundError.
+ */
+export declare function isSessionNotFoundError(error: unknown): error is SessionNotFoundError;
+/**
+ * Type guard to check if an error is a WorkspaceNotFoundError.
+ */
+export declare function isWorkspaceNotFoundError(error: unknown): error is WorkspaceNotFoundError;
+/**
+ * Type guard to check if an error is a SameWorkspaceError.
+ */
+export declare function isSameWorkspaceError(error: unknown): error is SameWorkspaceError;
+/**
+ * Type guard to check if an error is a NoSessionsFoundError.
+ */
+export declare function isNoSessionsFoundError(error: unknown): error is NoSessionsFoundError;
+/**
+ * Type guard to check if an error is a DestinationHasSessionsError.
+ */
+export declare function isDestinationHasSessionsError(error: unknown): error is DestinationHasSessionsError;
+/**
+ * Thrown when destination workspace path is nested within source workspace.
+ *
+ * Recovery: Choose a destination that is not a subdirectory of the source.
+ */
+export declare class NestedPathError extends Error {
+    name: "NestedPathError";
+    /** The source workspace path */
+    source: string;
+    /** The destination workspace path (nested in source) */
+    destination: string;
+    constructor(source: string, destination: string);
+}
+/**
+ * Type guard to check if an error is a NestedPathError.
+ */
+export declare function isNestedPathError(error: unknown): error is NestedPathError;
+/**
+ * Base error for backup operations.
+ *
+ * Recovery: Check specific subclass for targeted recovery actions.
+ */
+export declare class BackupError extends Error {
+    name: string;
+    constructor(message: string);
+}
+/**
+ * Thrown when there is no Cursor data to backup.
+ *
+ * Recovery: Verify Cursor is installed and has been used.
+ */
+export declare class NoDataError extends BackupError {
+    name: string;
+    /** Path that was checked for data */
+    path: string;
+    constructor(path: string);
+}
+/**
+ * Thrown when output file already exists.
+ *
+ * Recovery: Use force: true to overwrite, or specify different output path.
+ */
+export declare class FileExistsError extends BackupError {
+    name: string;
+    /** Path to existing file */
+    path: string;
+    constructor(path: string);
+}
 /**
- * Custom error class for CLI errors with exit codes
+ * Thrown when there is insufficient disk space for backup.
+ *
+ * Recovery: Free up disk space or specify different output location.
  */
-export declare class CliError extends Error {
-    readonly exitCode: ExitCode;
-    constructor(message: string, exitCode?: ExitCode);
+export declare class InsufficientSpaceError extends BackupError {
+    name: string;
+    /** Required space in bytes */
+    required: number;
+    /** Available space in bytes */
+    available: number;
+    constructor(required: number, available: number);
 }
 /**
- * Error for when no Cursor installation is found
+ * Base error for restore operations.
+ *
+ * Recovery: Check specific subclass for targeted recovery actions.
  */
-export declare class CursorNotFoundError extends CliError {
-    constructor(searchPath: string);
+export declare class RestoreError extends Error {
+    name: string;
+    constructor(message: string);
 }
 /**
- * Error for when no chat history exists
+ * Thrown when backup file is not found.
+ *
+ * Recovery: Verify backup file path is correct.
  */
-export declare class NoHistoryError extends CliError {
-    constructor();
+export declare class BackupNotFoundError extends RestoreError {
+    name: string;
+    /** Path to backup file that was not found */
+    path: string;
+    constructor(path: string);
 }
 /**
- * Error for invalid session index
+ * Thrown when backup file is invalid or corrupted.
+ *
+ * Recovery: Use a different backup file, or attempt to repair with external tools.
  */
-export declare class SessionNotFoundError extends CliError {
-    constructor(index: number, maxIndex: number);
+export declare class InvalidBackupError extends RestoreError {
+    name: string;
+    /** Path to invalid backup file */
+    path: string;
+    /** Reason for invalidity */
+    reason: string;
+    constructor(path: string, reason: string);
 }
 /**
- * Error for file already exists
+ * Thrown when target directory already has Cursor data.
+ *
+ * Recovery: Use force: true to overwrite, or specify different target path.
  */
-export declare class FileExistsError extends CliError {
+export declare class TargetExistsError extends RestoreError {
+    name: string;
+    /** Path to existing target */
+    path: string;
     constructor(path: string);
 }
 /**
- * Error for search with no results
+ * Thrown when backup integrity check fails critically.
+ *
+ * Recovery: Backup may be corrupted beyond repair; try a different backup.
  */
-export declare class NoSearchResultsError extends CliError {
-    constructor(query: string);
+export declare class IntegrityError extends RestoreError {
+    name: string;
+    /** Files that failed integrity check */
+    failedFiles: string[];
+    constructor(failedFiles: string[]);
 }
 /**
- * Handle an error and exit with appropriate code
+ * Type guard to check if an error is a BackupError or subclass.
+ */
+export declare function isBackupError(error: unknown): error is BackupError;
+/**
+ * Type guard to check if an error is a RestoreError or subclass.
+ */
+export declare function isRestoreError(error: unknown): error is RestoreError;
+/**
+ * Type guard to check if an error is an InvalidBackupError.
+ */
+export declare function isInvalidBackupError(error: unknown): error is InvalidBackupError;
+/**
+ * Type guard to check if an error is a NoDataError.
+ */
+export declare function isNoDataError(error: unknown): error is NoDataError;
+/**
+ * Type guard to check if an error is a FileExistsError.
+ */
+export declare function isFileExistsError(error: unknown): error is FileExistsError;
+/**
+ * Type guard to check if an error is an InsufficientSpaceError.
+ */
+export declare function isInsufficientSpaceError(error: unknown): error is InsufficientSpaceError;
+/**
+ * Type guard to check if an error is a BackupNotFoundError.
+ */
+export declare function isBackupNotFoundError(error: unknown): error is BackupNotFoundError;
+/**
+ * Type guard to check if an error is a TargetExistsError.
+ */
+export declare function isTargetExistsError(error: unknown): error is TargetExistsError;
+/**
+ * Type guard to check if an error is an IntegrityError.
  */
-export declare function handleError(error: unknown): never;
+export declare function isIntegrityError(error: unknown): error is IntegrityError;
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAGf,QAAQ,EAAE,QAAQ;gBADlC,OAAO,EAAE,MAAM,EACC,QAAQ,GAAE,QAAiC;CAK9D;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,UAAU,EAAE,MAAM;CAS/B;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;;CAQ3C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,QAAQ;gBACpC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAQ5C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,IAAI,EAAE,MAAM;CAIzB;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,QAAQ;gBACpC,KAAK,EAAE,MAAM;CAI1B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAajD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"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"}