cursor-history 0.5.1 → 0.6.0

package/dist/lib/config.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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;
+}
+/**
+ * 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;CACjB;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,CAYxE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAW/D"}

package/dist/lib/config.js

@@ -0,0 +1,80 @@
+/**
+ * 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,
+    };
+}
+/**
+ * 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,54 @@
 /**
- * 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];
-/**
- * Custom error class for CLI errors with exit codes
- */
-export declare class CliError extends Error {
-    readonly exitCode: ExitCode;
-    constructor(message: string, exitCode?: ExitCode);
-}
-/**
- * Error for when no Cursor installation is found
- */
-export declare class CursorNotFoundError extends CliError {
-    constructor(searchPath: string);
+export declare class DatabaseLockedError extends Error {
+    name: "DatabaseLockedError";
+    /** Path to locked database file */
+    path: string;
+    constructor(path: string);
 }
 /**
- * Error for when no chat history exists
+ * Thrown when database file or directory does not exist.
+ *
+ * Recovery: Verify Cursor is installed, check dataPath configuration.
  */
-export declare class NoHistoryError extends CliError {
-    constructor();
+export declare class DatabaseNotFoundError extends Error {
+    name: "DatabaseNotFoundError";
+    /** Path that was not found */
+    path: string;
+    constructor(path: string);
 }
 /**
- * Error for invalid session index
- */
-export declare class SessionNotFoundError extends CliError {
-    constructor(index: number, maxIndex: number);
+ * 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);
 }
 /**
- * Error for file already exists
+ * Type guard to check if an error is a DatabaseLockedError.
  */
-export declare class FileExistsError extends CliError {
-    constructor(path: string);
-}
+export declare function isDatabaseLockedError(error: unknown): error is DatabaseLockedError;
 /**
- * Error for search with no results
+ * Type guard to check if an error is a DatabaseNotFoundError.
  */
-export declare class NoSearchResultsError extends CliError {
-    constructor(query: string);
-}
+export declare function isDatabaseNotFoundError(error: unknown): error is DatabaseNotFoundError;
 /**
- * Handle an error and exit with appropriate code
+ * Type guard to check if an error is an InvalidConfigError.
  */
-export declare function handleError(error: unknown): never;
+export declare function isInvalidConfigError(error: unknown): error is InvalidConfigError;
 //# 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":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,IAAI,EAAG,qBAAqB,CAAU;IAEtC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;gBAED,IAAI,EAAE,MAAM;CAOzB;AAED;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,IAAI,EAAG,uBAAuB,CAAU;IAExC,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;gBAED,IAAI,EAAE,MAAM;CAOzB;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,IAAI,EAAG,oBAAoB,CAAU;IAErC,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IAEd,6BAA6B;IAC7B,KAAK,EAAE,OAAO,CAAC;gBAEH,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;CAQ1D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAElF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAEtF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF"}

package/dist/lib/errors.js

@@ -1,90 +1,79 @@
 /**
- * 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 const ExitCode = {
-    SUCCESS: 0,
-    GENERAL_ERROR: 1,
-    USAGE_ERROR: 2, // Invalid arguments
-    NOT_FOUND: 3, // Resource not found
-    IO_ERROR: 4, // File/database access error
-};
-/**
- * Custom error class for CLI errors with exit codes
- */
-export class CliError extends Error {
-    exitCode;
-    constructor(message, exitCode = ExitCode.GENERAL_ERROR) {
-        super(message);
-        this.exitCode = exitCode;
-        this.name = 'CliError';
-    }
-}
-/**
- * Error for when no Cursor installation is found
- */
-export class CursorNotFoundError extends CliError {
-    constructor(searchPath) {
-        super(`Cursor data not found at: ${searchPath}\n` +
-            'Make sure Cursor is installed and has been used at least once.\n' +
-            'You can specify a custom path with --data-path or CURSOR_DATA_PATH env var.', ExitCode.NOT_FOUND);
-        this.name = 'CursorNotFoundError';
+export class DatabaseLockedError extends Error {
+    name = 'DatabaseLockedError';
+    /** Path to locked database file */
+    path;
+    constructor(path) {
+        super(`Database is locked: ${path}. Close Cursor or retry later.`);
+        this.path = path;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, DatabaseLockedError);
+        }
     }
 }
 /**
- * Error for when no chat history exists
+ * Thrown when database file or directory does not exist.
+ *
+ * Recovery: Verify Cursor is installed, check dataPath configuration.
  */
-export class NoHistoryError extends CliError {
-    constructor() {
-        super('No chat history found.\n' + 'Start a conversation in Cursor to create chat history.', ExitCode.NOT_FOUND);
-        this.name = 'NoHistoryError';
+export class DatabaseNotFoundError extends Error {
+    name = 'DatabaseNotFoundError';
+    /** Path that was not found */
+    path;
+    constructor(path) {
+        super(`Database not found: ${path}. Check dataPath configuration.`);
+        this.path = path;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, DatabaseNotFoundError);
+        }
     }
 }
 /**
- * Error for invalid session index
+ * Thrown when configuration parameters are invalid.
+ *
+ * Recovery: Fix configuration values per LibraryConfig validation rules.
  */
-export class SessionNotFoundError extends CliError {
-    constructor(index, maxIndex) {
-        const message = maxIndex > 0
-            ? `Session #${index} not found. Valid range: 1-${maxIndex}`
-            : 'No sessions found.';
-        super(message, ExitCode.NOT_FOUND);
-        this.name = 'SessionNotFoundError';
+export class InvalidConfigError extends Error {
+    name = 'InvalidConfigError';
+    /** Name of invalid config field */
+    field;
+    /** Invalid value provided */
+    value;
+    constructor(field, value, reason) {
+        super(`Invalid config.${field}: ${reason} (got: ${JSON.stringify(value)})`);
+        this.field = field;
+        this.value = value;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, InvalidConfigError);
+        }
     }
 }
 /**
- * Error for file already exists
+ * Type guard to check if an error is a DatabaseLockedError.
  */
-export class FileExistsError extends CliError {
-    constructor(path) {
-        super(`File already exists: ${path}\nUse --force to overwrite.`, ExitCode.IO_ERROR);
-        this.name = 'FileExistsError';
-    }
+export function isDatabaseLockedError(error) {
+    return error instanceof DatabaseLockedError;
 }
 /**
- * Error for search with no results
+ * Type guard to check if an error is a DatabaseNotFoundError.
  */
-export class NoSearchResultsError extends CliError {
-    constructor(query) {
-        super(`No results found for: "${query}"`, ExitCode.NOT_FOUND);
-        this.name = 'NoSearchResultsError';
-    }
+export function isDatabaseNotFoundError(error) {
+    return error instanceof DatabaseNotFoundError;
 }
 /**
- * Handle an error and exit with appropriate code
+ * Type guard to check if an error is an InvalidConfigError.
  */
-export function handleError(error) {
-    if (error instanceof CliError) {
-        console.error(error.message);
-        process.exit(error.exitCode);
-    }
-    if (error instanceof Error) {
-        console.error(`Error: ${error.message}`);
-        process.exit(ExitCode.GENERAL_ERROR);
-    }
-    console.error('An unexpected error occurred');
-    process.exit(ExitCode.GENERAL_ERROR);
+export function isInvalidConfigError(error) {
+    return error instanceof InvalidConfigError;
 }
 //# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,CAAC,EAAE,oBAAoB;IACpC,SAAS,EAAE,CAAC,EAAE,qBAAqB;IACnC,QAAQ,EAAE,CAAC,EAAE,6BAA6B;CAClC,CAAC;AAIX;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IAGf;IAFlB,YACE,OAAe,EACC,WAAqB,QAAQ,CAAC,aAAa;QAE3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,aAAQ,GAAR,QAAQ,CAAmC;QAG3D,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,UAAkB;QAC5B,KAAK,CACH,6BAA6B,UAAU,IAAI;YACzC,kEAAkE;YAClE,6EAA6E,EAC/E,QAAQ,CAAC,SAAS,CACnB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1C;QACE,KAAK,CACH,0BAA0B,GAAG,wDAAwD,EACrF,QAAQ,CAAC,SAAS,CACnB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;IAChD,YAAY,KAAa,EAAE,QAAgB;QACzC,MAAM,OAAO,GACX,QAAQ,GAAG,CAAC;YACV,CAAC,CAAC,YAAY,KAAK,8BAA8B,QAAQ,EAAE;YAC3D,CAAC,CAAC,oBAAoB,CAAC;QAC3B,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,IAAY;QACtB,KAAK,CAAC,wBAAwB,IAAI,6BAA6B,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;IAChD,YAAY,KAAa;QACvB,KAAK,CAAC,0BAA0B,KAAK,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;AACvC,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,IAAI,GAAG,qBAA8B,CAAC;IAEtC,mCAAmC;IACnC,IAAI,CAAS;IAEb,YAAY,IAAY;QACtB,KAAK,CAAC,uBAAuB,IAAI,gCAAgC,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,IAAI,GAAG,uBAAgC,CAAC;IAExC,8BAA8B;IAC9B,IAAI,CAAS;IAEb,YAAY,IAAY;QACtB,KAAK,CAAC,uBAAuB,IAAI,iCAAiC,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,IAAI,GAAG,oBAA6B,CAAC;IAErC,mCAAmC;IACnC,KAAK,CAAS;IAEd,6BAA6B;IAC7B,KAAK,CAAU;IAEf,YAAY,KAAa,EAAE,KAAc,EAAE,MAAc;QACvD,KAAK,CAAC,kBAAkB,KAAK,KAAK,MAAM,UAAU,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,KAAK,YAAY,mBAAmB,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,KAAK,YAAY,qBAAqB,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,KAAK,YAAY,kBAAkB,CAAC;AAC7C,CAAC"}

package/dist/lib/index.d.ts

@@ -0,0 +1,142 @@
+/**
+ * cursor-history Library API
+ *
+ * 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 { listSessions, getSession, searchSessions } from 'cursor-history'`
+ */
+export type { Session, Message, ToolCall, SearchResult, LibraryConfig, PaginatedResult, } from './types.js';
+export { DatabaseLockedError, DatabaseNotFoundError, InvalidConfigError, isDatabaseLockedError, isDatabaseNotFoundError, isInvalidConfigError, } from './errors.js';
+export { getDefaultDataPath } from './utils.js';
+import type { LibraryConfig, PaginatedResult, Session, SearchResult } from './types.js';
+/**
+ * List all chat sessions, optionally filtered and paginated.
+ *
+ * @param config - Optional configuration (dataPath, workspace filter, pagination)
+ * @returns Paginated result with sessions and metadata
+ * @throws {DatabaseLockedError} If database is locked by Cursor
+ * @throws {DatabaseNotFoundError} If database path does not exist
+ * @throws {InvalidConfigError} If config parameters are invalid
+ *
+ * @example
+ * // List all sessions
+ * const result = listSessions();
+ * console.log(result.data); // Session[]
+ *
+ * @example
+ * // List sessions with pagination
+ * const page1 = listSessions({ limit: 10, offset: 0 });
+ * const page2 = listSessions({ limit: 10, offset: 10 });
+ *
+ * @example
+ * // List sessions for specific workspace
+ * const result = listSessions({ workspace: '/path/to/project' });
+ */
+export declare function listSessions(config?: LibraryConfig): PaginatedResult<Session>;
+/**
+ * Get a specific session by index.
+ *
+ * @param index - Zero-based session index (from listSessions result)
+ * @param config - Optional configuration (dataPath)
+ * @returns Complete session with all messages
+ * @throws {DatabaseLockedError} If database is locked by Cursor
+ * @throws {DatabaseNotFoundError} If database path does not exist
+ * @throws {InvalidConfigError} If index is out of bounds
+ *
+ * @example
+ * const session = getSession(0);
+ * console.log(session.messages); // Message[]
+ *
+ * @example
+ * // Get session from custom data path
+ * const session = getSession(5, { dataPath: '/custom/cursor/data' });
+ */
+export declare function getSession(index: number, config?: LibraryConfig): Session;
+/**
+ * Search across all sessions for matching content.
+ *
+ * @param query - Search query string (case-insensitive substring match)
+ * @param config - Optional configuration (dataPath, workspace filter, context lines)
+ * @returns Array of search results with context
+ * @throws {DatabaseLockedError} If database is locked by Cursor
+ * @throws {DatabaseNotFoundError} If database path does not exist
+ *
+ * @example
+ * // Basic search
+ * const results = searchSessions('authentication');
+ *
+ * @example
+ * // Search with context lines
+ * const results = searchSessions('error', { context: 2 });
+ * results.forEach(r => {
+ *   console.log(r.contextBefore); // 2 lines before match
+ *   console.log(r.match);          // matched line
+ *   console.log(r.contextAfter);   // 2 lines after match
+ * });
+ *
+ * @example
+ * // Search within specific workspace
+ * const results = searchSessions('bug', { workspace: '/path/to/project' });
+ */
+export declare function searchSessions(query: string, config?: LibraryConfig): SearchResult[];
+/**
+ * Export a session to JSON format.
+ *
+ * @param index - Zero-based session index (from listSessions result)
+ * @param config - Optional configuration (dataPath)
+ * @returns JSON string representation of session
+ * @throws {DatabaseLockedError} If database is locked by Cursor
+ * @throws {DatabaseNotFoundError} If database path does not exist
+ * @throws {InvalidConfigError} If index is out of bounds
+ *
+ * @example
+ * const json = exportSessionToJson(0);
+ * fs.writeFileSync('session.json', json);
+ */
+export declare function exportSessionToJson(index: number, config?: LibraryConfig): string;
+/**
+ * Export a session to Markdown format.
+ *
+ * @param index - Zero-based session index (from listSessions result)
+ * @param config - Optional configuration (dataPath)
+ * @returns Markdown formatted string
+ * @throws {DatabaseLockedError} If database is locked by Cursor
+ * @throws {DatabaseNotFoundError} If database path does not exist
+ * @throws {InvalidConfigError} If index is out of bounds
+ *
+ * @example
+ * const markdown = exportSessionToMarkdown(0);
+ * fs.writeFileSync('session.md', markdown);
+ */
+export declare function exportSessionToMarkdown(index: number, config?: LibraryConfig): string;
+/**
+ * Export all sessions to JSON format.
+ *
+ * @param config - Optional configuration (dataPath, workspace filter)
+ * @returns JSON string with array of all sessions
+ * @throws {DatabaseLockedError} If database is locked by Cursor
+ * @throws {DatabaseNotFoundError} If database path does not exist
+ *
+ * @example
+ * const json = exportAllSessionsToJson();
+ * fs.writeFileSync('all-sessions.json', json);
+ *
+ * @example
+ * // Export sessions from specific workspace
+ * const json = exportAllSessionsToJson({ workspace: '/path/to/project' });
+ */
+export declare function exportAllSessionsToJson(config?: LibraryConfig): string;
+/**
+ * Export all sessions to Markdown format.
+ *
+ * @param config - Optional configuration (dataPath, workspace filter)
+ * @returns Markdown formatted string with all sessions
+ * @throws {DatabaseLockedError} If database is locked by Cursor
+ * @throws {DatabaseNotFoundError} If database path does not exist
+ *
+ * @example
+ * const markdown = exportAllSessionsToMarkdown();
+ * fs.writeFileSync('all-sessions.md', markdown);
+ */
+export declare function exportAllSessionsToMarkdown(config?: LibraryConfig): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,OAAO,EACP,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA8BxF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC,CAyD7E;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CA6BzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,YAAY,EAAE,CAmFpF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAiBjF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAiBrF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CA4BtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,MAAM,CAgC1E"}