cursor-history 0.5.1 → 0.6.0

package/dist/lib/index.js

@@ -0,0 +1,401 @@
+/**
+ * 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 error classes (will be created in Phase 2)
+export { DatabaseLockedError, DatabaseNotFoundError, InvalidConfigError, isDatabaseLockedError, isDatabaseNotFoundError, isInvalidConfigError, } from './errors.js';
+// Export utility functions
+export { getDefaultDataPath } from './utils.js';
+import { mergeWithDefaults } from './config.js';
+import { DatabaseLockedError, DatabaseNotFoundError } from './errors.js';
+import * as storage from '../core/storage.js';
+import { exportToJson, exportToMarkdown } from '../core/parser.js';
+/**
+ * Convert core ChatSession to library Session
+ */
+function convertToLibrarySession(coreSession) {
+    return {
+        id: coreSession.id,
+        workspace: coreSession.workspacePath ?? 'unknown',
+        timestamp: coreSession.createdAt.toISOString(),
+        messages: coreSession.messages.map((msg) => ({
+            role: msg.role === 'user' ? 'user' : 'assistant',
+            content: msg.content,
+            timestamp: msg.timestamp.toISOString(),
+            toolCalls: msg.toolCalls,
+            thinking: msg.thinking,
+            metadata: msg.metadata,
+        })),
+        messageCount: coreSession.messageCount,
+        metadata: {
+            lastModified: coreSession.lastUpdatedAt.toISOString(),
+        },
+    };
+}
+/**
+ * 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 function listSessions(config) {
+    try {
+        const resolved = mergeWithDefaults(config);
+        // Get all sessions using core storage layer
+        const coreSessions = storage.listSessions({
+            limit: -1, // Get all, we'll paginate ourselves
+            all: true,
+            workspacePath: resolved.workspace,
+        }, resolved.dataPath);
+        // Total count before pagination
+        const total = coreSessions.length;
+        // Apply offset and limit
+        const start = resolved.offset;
+        const end = Math.min(start + resolved.limit, total);
+        const paginatedSessions = coreSessions.slice(start, end);
+        // Convert to library Session format
+        // We need full sessions, not summaries, so we'll fetch each one
+        const sessions = paginatedSessions.map((summary) => {
+            const fullSession = storage.getSession(summary.index, resolved.dataPath);
+            if (!fullSession) {
+                throw new DatabaseNotFoundError(`Session ${summary.index} not found`);
+            }
+            return convertToLibrarySession(fullSession);
+        });
+        return {
+            data: sessions,
+            pagination: {
+                total,
+                limit: resolved.limit,
+                offset: resolved.offset,
+                hasMore: end < total,
+            },
+        };
+    }
+    catch (err) {
+        // Check for SQLite BUSY error (database locked)
+        if (err instanceof Error && err.message.includes('SQLITE_BUSY')) {
+            throw new DatabaseLockedError(config?.dataPath ?? 'default path');
+        }
+        // Check for file not found errors
+        if (err instanceof Error && (err.message.includes('ENOENT') || err.message.includes('no such file'))) {
+            throw new DatabaseNotFoundError(config?.dataPath ?? 'default path');
+        }
+        // Re-throw library errors as-is
+        if (err instanceof DatabaseLockedError || err instanceof DatabaseNotFoundError) {
+            throw err;
+        }
+        // Wrap other errors
+        throw new Error(`Failed to list sessions: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * 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 function getSession(index, config) {
+    try {
+        const resolved = mergeWithDefaults(config);
+        // Core storage uses 1-based indexing, so we add 1
+        const coreIndex = index + 1;
+        const coreSession = storage.getSession(coreIndex, resolved.dataPath);
+        if (!coreSession) {
+            throw new DatabaseNotFoundError(`Session at index ${index} not found`);
+        }
+        return convertToLibrarySession(coreSession);
+    }
+    catch (err) {
+        // Check for SQLite BUSY error (database locked)
+        if (err instanceof Error && err.message.includes('SQLITE_BUSY')) {
+            throw new DatabaseLockedError(config?.dataPath ?? 'default path');
+        }
+        // Check for file not found errors
+        if (err instanceof Error && (err.message.includes('ENOENT') || err.message.includes('no such file'))) {
+            throw new DatabaseNotFoundError(config?.dataPath ?? 'default path');
+        }
+        // Re-throw library errors as-is
+        if (err instanceof DatabaseLockedError || err instanceof DatabaseNotFoundError) {
+            throw err;
+        }
+        // Wrap other errors
+        throw new Error(`Failed to get session: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * 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 function searchSessions(query, config) {
+    try {
+        const resolved = mergeWithDefaults(config);
+        // Search using core storage layer
+        const coreResults = storage.searchSessions(query, {
+            limit: resolved.limit === Number.MAX_SAFE_INTEGER ? 0 : resolved.limit,
+            contextChars: resolved.context * 80, // Rough estimate: 1 line = 80 chars
+            workspacePath: resolved.workspace,
+        }, resolved.dataPath);
+        // Convert core results to library format
+        return coreResults.map((coreResult) => {
+            // Get full session for reference
+            const fullSession = storage.getSession(coreResult.index, resolved.dataPath);
+            if (!fullSession) {
+                throw new DatabaseNotFoundError(`Session ${coreResult.index} not found`);
+            }
+            // Find the first match to get offset and context
+            const firstSnippet = coreResult.snippets[0];
+            const match = firstSnippet?.text ?? '';
+            const offset = firstSnippet?.matchPositions[0]?.[0] ?? 0;
+            // Extract context lines (split by newlines)
+            const lines = match.split('\n');
+            const contextBefore = [];
+            const contextAfter = [];
+            // Find the line containing the match
+            let matchLineIndex = 0;
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (line && line.includes(query)) {
+                    matchLineIndex = i;
+                    break;
+                }
+            }
+            // Get context lines before and after
+            if (resolved.context > 0) {
+                const start = Math.max(0, matchLineIndex - resolved.context);
+                const end = Math.min(lines.length, matchLineIndex + resolved.context + 1);
+                for (let i = start; i < matchLineIndex; i++) {
+                    const line = lines[i];
+                    if (line)
+                        contextBefore.push(line);
+                }
+                for (let i = matchLineIndex + 1; i < end; i++) {
+                    const line = lines[i];
+                    if (line)
+                        contextAfter.push(line);
+                }
+            }
+            return {
+                session: convertToLibrarySession(fullSession),
+                match: lines[matchLineIndex] ?? match,
+                messageIndex: 0, // Would need to track which message contains the match
+                offset,
+                contextBefore: contextBefore.length > 0 ? contextBefore : undefined,
+                contextAfter: contextAfter.length > 0 ? contextAfter : undefined,
+            };
+        });
+    }
+    catch (err) {
+        // Check for SQLite BUSY error (database locked)
+        if (err instanceof Error && err.message.includes('SQLITE_BUSY')) {
+            throw new DatabaseLockedError(config?.dataPath ?? 'default path');
+        }
+        // Check for file not found errors
+        if (err instanceof Error && (err.message.includes('ENOENT') || err.message.includes('no such file'))) {
+            throw new DatabaseNotFoundError(config?.dataPath ?? 'default path');
+        }
+        // Re-throw library errors as-is
+        if (err instanceof DatabaseLockedError || err instanceof DatabaseNotFoundError) {
+            throw err;
+        }
+        // Wrap other errors
+        throw new Error(`Failed to search sessions: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * 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 function exportSessionToJson(index, config) {
+    try {
+        const resolved = mergeWithDefaults(config);
+        const coreIndex = index + 1; // Convert to 1-based indexing
+        const coreSession = storage.getSession(coreIndex, resolved.dataPath);
+        if (!coreSession) {
+            throw new DatabaseNotFoundError(`Session at index ${index} not found`);
+        }
+        return exportToJson(coreSession, coreSession.workspacePath);
+    }
+    catch (err) {
+        if (err instanceof DatabaseLockedError || err instanceof DatabaseNotFoundError) {
+            throw err;
+        }
+        throw new Error(`Failed to export session to JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * 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 function exportSessionToMarkdown(index, config) {
+    try {
+        const resolved = mergeWithDefaults(config);
+        const coreIndex = index + 1; // Convert to 1-based indexing
+        const coreSession = storage.getSession(coreIndex, resolved.dataPath);
+        if (!coreSession) {
+            throw new DatabaseNotFoundError(`Session at index ${index} not found`);
+        }
+        return exportToMarkdown(coreSession, coreSession.workspacePath);
+    }
+    catch (err) {
+        if (err instanceof DatabaseLockedError || err instanceof DatabaseNotFoundError) {
+            throw err;
+        }
+        throw new Error(`Failed to export session to Markdown: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * 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 function exportAllSessionsToJson(config) {
+    try {
+        const resolved = mergeWithDefaults(config);
+        // Get all sessions
+        const coreSessions = storage.listSessions({
+            limit: -1,
+            all: true,
+            workspacePath: resolved.workspace,
+        }, resolved.dataPath);
+        // Export each session
+        const exportedSessions = coreSessions.map((summary) => {
+            const session = storage.getSession(summary.index, resolved.dataPath);
+            if (!session)
+                return null;
+            return JSON.parse(exportToJson(session, session.workspacePath));
+        }).filter((s) => s !== null);
+        return JSON.stringify(exportedSessions, null, 2);
+    }
+    catch (err) {
+        if (err instanceof DatabaseLockedError || err instanceof DatabaseNotFoundError) {
+            throw err;
+        }
+        throw new Error(`Failed to export all sessions to JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * 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 function exportAllSessionsToMarkdown(config) {
+    try {
+        const resolved = mergeWithDefaults(config);
+        // Get all sessions
+        const coreSessions = storage.listSessions({
+            limit: -1,
+            all: true,
+            workspacePath: resolved.workspace,
+        }, resolved.dataPath);
+        // Export each session
+        const parts = [];
+        for (const summary of coreSessions) {
+            const session = storage.getSession(summary.index, resolved.dataPath);
+            if (!session)
+                continue;
+            parts.push(exportToMarkdown(session, session.workspacePath));
+            parts.push('\n\n---\n\n'); // Separator between sessions
+        }
+        return parts.join('');
+    }
+    catch (err) {
+        if (err instanceof DatabaseLockedError || err instanceof DatabaseNotFoundError) {
+            throw err;
+        }
+        throw new Error(`Failed to export all sessions to Markdown: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

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

package/dist/lib/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * 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;
+}
+/**
+ * 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;
+    };
+}
+//# 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":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IAEX,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAElB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAElB,+CAA+C;IAC/C,QAAQ,EAAE,OAAO,EAAE,CAAC;IAEpB,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;IAErB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE;QACT,+CAA+C;QAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;QAEvB,8BAA8B;QAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAE3B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAEhB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAElB,kEAAkE;IAClE,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IAEvB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mDAAmD;IACnD,QAAQ,CAAC,EAAE;QACT,mDAAmD;QACnD,SAAS,CAAC,EAAE,OAAO,CAAC;QAEpB,yDAAyD;QACzD,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IAEb,4BAA4B;IAC5B,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;IAE5C,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IAEjB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IAEd,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IAErB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,2CAA2C;IAC3C,IAAI,EAAE,CAAC,EAAE,CAAC;IAEV,0BAA0B;IAC1B,UAAU,EAAE;QACV,6CAA6C;QAC7C,KAAK,EAAE,MAAM,CAAC;QAEd,iDAAiD;QACjD,KAAK,EAAE,MAAM,CAAC;QAEd,gEAAgE;QAChE,MAAM,EAAE,MAAM,CAAC;QAEf,8CAA8C;QAC9C,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;CACH"}

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.6.0",
+  "description": "CLI tool and library to browse and export 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",