codeseeker 1.4.0

package/dist/storage/interfaces.d.ts

@@ -0,0 +1,259 @@
+/**
+ * Storage Abstraction Interfaces
+ *
+ * Enables CodeSeeker to work with either:
+ * - Embedded storage (SQLite + graphology + lru-cache) - zero setup, default
+ * - Server storage (PostgreSQL + Neo4j + Redis) - optional, for production
+ *
+ * All implementations support disk persistence for durability.
+ */
+export interface VectorDocument {
+    id: string;
+    projectId: string;
+    filePath: string;
+    content: string;
+    embedding: number[];
+    metadata?: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface VectorSearchResult {
+    document: VectorDocument;
+    score: number;
+    matchType: 'vector' | 'fts' | 'hybrid';
+    /** Debug info for verbose mode - score breakdown by source */
+    debug?: {
+        vectorScore: number;
+        textScore: number;
+        pathMatch: boolean;
+        matchSource: string;
+    };
+}
+export interface IVectorStore {
+    /** Store or update a document with its embedding */
+    upsert(doc: Omit<VectorDocument, 'createdAt' | 'updatedAt'>): Promise<void>;
+    /** Bulk upsert for efficiency */
+    upsertMany(docs: Array<Omit<VectorDocument, 'createdAt' | 'updatedAt'>>): Promise<void>;
+    /** Search by vector similarity */
+    searchByVector(embedding: number[], projectId: string, limit?: number): Promise<VectorSearchResult[]>;
+    /** Search by full-text query */
+    searchByText(query: string, projectId: string, limit?: number): Promise<VectorSearchResult[]>;
+    /** Hybrid search (vector + FTS with RRF fusion) */
+    searchHybrid(query: string, embedding: number[], projectId: string, limit?: number): Promise<VectorSearchResult[]>;
+    /** Delete documents for a project */
+    deleteByProject(projectId: string): Promise<number>;
+    /** Delete a specific document */
+    delete(id: string): Promise<boolean>;
+    /** Get document/chunk count for a project */
+    count(projectId: string): Promise<number>;
+    /** Get unique file count for a project */
+    countFiles(projectId: string): Promise<number>;
+    /** Get stored file metadata for change detection (hash + mtime) */
+    getFileMetadata(projectId: string, filePath: string): Promise<{
+        fileHash: string;
+        indexedAt: string;
+    } | null>;
+    /** Persist to disk (for embedded mode) */
+    flush(): Promise<void>;
+    /** Close connections and cleanup */
+    close(): Promise<void>;
+}
+export interface GraphNode {
+    id: string;
+    type: 'file' | 'class' | 'function' | 'method' | 'variable' | 'import' | 'export';
+    name: string;
+    filePath: string;
+    projectId: string;
+    properties?: Record<string, unknown>;
+}
+export interface GraphEdge {
+    id: string;
+    source: string;
+    target: string;
+    type: 'imports' | 'exports' | 'calls' | 'extends' | 'implements' | 'contains' | 'uses' | 'depends_on';
+    properties?: Record<string, unknown>;
+}
+export interface GraphQueryResult {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+export interface IGraphStore {
+    /** Add or update a node */
+    upsertNode(node: GraphNode): Promise<void>;
+    /** Add or update an edge */
+    upsertEdge(edge: GraphEdge): Promise<void>;
+    /** Bulk operations */
+    upsertNodes(nodes: GraphNode[]): Promise<void>;
+    upsertEdges(edges: GraphEdge[]): Promise<void>;
+    /** Find nodes by type and project */
+    findNodes(projectId: string, type?: GraphNode['type']): Promise<GraphNode[]>;
+    /** Find node by ID */
+    getNode(id: string): Promise<GraphNode | null>;
+    /** Get edges from/to a node */
+    getEdges(nodeId: string, direction?: 'in' | 'out' | 'both'): Promise<GraphEdge[]>;
+    /** Find related nodes (1-hop neighbors) */
+    getNeighbors(nodeId: string, edgeType?: GraphEdge['type']): Promise<GraphNode[]>;
+    /** Find path between nodes */
+    findPath(sourceId: string, targetId: string, maxDepth?: number): Promise<GraphNode[]>;
+    /** Delete all nodes/edges for a project */
+    deleteByProject(projectId: string): Promise<number>;
+    /** Get node count for a project */
+    countNodes(projectId: string): Promise<number>;
+    /** Persist to disk (for embedded mode) */
+    flush(): Promise<void>;
+    /** Close and cleanup */
+    close(): Promise<void>;
+}
+export interface CacheEntry<T = unknown> {
+    key: string;
+    value: T;
+    expiresAt?: Date;
+    tags?: string[];
+}
+export interface ICacheStore {
+    /** Get a cached value */
+    get<T>(key: string): Promise<T | null>;
+    /** Set a value with optional TTL (seconds) */
+    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
+    /** Delete a cached value */
+    delete(key: string): Promise<boolean>;
+    /** Check if key exists */
+    has(key: string): Promise<boolean>;
+    /** Delete all keys matching a pattern */
+    deletePattern(pattern: string): Promise<number>;
+    /** Delete all keys with a specific tag */
+    deleteByTag(tag: string): Promise<number>;
+    /** Clear entire cache */
+    clear(): Promise<void>;
+    /** Get cache statistics */
+    stats(): Promise<{
+        size: number;
+        hits: number;
+        misses: number;
+    }>;
+    /** Persist to disk (for embedded mode) */
+    flush(): Promise<void>;
+    /** Close and cleanup */
+    close(): Promise<void>;
+}
+export interface Project {
+    id: string;
+    name: string;
+    path: string;
+    createdAt: Date;
+    updatedAt: Date;
+    metadata?: Record<string, unknown>;
+}
+export interface IProjectStore {
+    /** Create or update a project */
+    upsert(project: Omit<Project, 'createdAt' | 'updatedAt'>): Promise<Project>;
+    /** Find project by path */
+    findByPath(path: string): Promise<Project | null>;
+    /** Find project by ID */
+    findById(id: string): Promise<Project | null>;
+    /** List all projects */
+    list(): Promise<Project[]>;
+    /** Delete a project and all related data */
+    delete(id: string): Promise<boolean>;
+    /** Persist to disk */
+    flush(): Promise<void>;
+    /** Close and cleanup */
+    close(): Promise<void>;
+}
+export interface TextDocument {
+    id: string;
+    projectId: string;
+    filePath: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+export interface TextSearchResult {
+    document: TextDocument;
+    score: number;
+    matchedTerms: string[];
+}
+export interface Synonym {
+    term: string;
+    synonyms: string[];
+    projectId?: string;
+}
+export interface ITextStore {
+    /** Index a document for full-text search */
+    index(doc: TextDocument): Promise<void>;
+    /** Bulk index documents */
+    indexMany(docs: TextDocument[]): Promise<void>;
+    /** Search by text query with BM25 scoring */
+    search(query: string, projectId: string, limit?: number): Promise<TextSearchResult[]>;
+    /** Search with synonym expansion */
+    searchWithSynonyms(query: string, projectId: string, limit?: number): Promise<TextSearchResult[]>;
+    /** Remove a document from the index */
+    remove(id: string): Promise<boolean>;
+    /** Remove all documents for a project */
+    removeByProject(projectId: string): Promise<number>;
+    /** Add a synonym mapping */
+    addSynonym(term: string, synonyms: string[], projectId?: string): Promise<void>;
+    /** Remove a synonym mapping */
+    removeSynonym(term: string, projectId?: string): Promise<boolean>;
+    /** Get all synonyms */
+    getSynonyms(projectId?: string): Promise<Synonym[]>;
+    /** Clear all synonyms */
+    clearSynonyms(projectId?: string): Promise<void>;
+    /** Get document count */
+    count(projectId: string): Promise<number>;
+    /** Persist to disk (for embedded mode) */
+    flush(): Promise<void>;
+    /** Close and cleanup */
+    close(): Promise<void>;
+}
+export type StorageMode = 'embedded' | 'server';
+export interface StorageConfig {
+    mode: StorageMode;
+    /** Directory for embedded storage files (default: ~/.codeseeker/data) */
+    dataDir?: string;
+    /** Flush interval in seconds (default: 30) */
+    flushIntervalSeconds?: number;
+    /** Server configuration (only used when mode === 'server') */
+    server?: {
+        postgres?: {
+            host: string;
+            port: number;
+            database: string;
+            user: string;
+            password: string;
+        };
+        neo4j?: {
+            uri: string;
+            user: string;
+            password: string;
+        };
+        redis?: {
+            host: string;
+            port: number;
+            password?: string;
+        };
+    };
+}
+export interface IStorageProvider {
+    /** Get the vector store */
+    getVectorStore(): IVectorStore;
+    /** Get the graph store */
+    getGraphStore(): IGraphStore;
+    /** Get the cache store */
+    getCacheStore(): ICacheStore;
+    /** Get the project store */
+    getProjectStore(): IProjectStore;
+    /** Get the text store (full-text search) */
+    getTextStore(): ITextStore;
+    /** Get current storage mode */
+    getMode(): StorageMode;
+    /** Persist all stores to disk */
+    flushAll(): Promise<void>;
+    /** Close all connections */
+    closeAll(): Promise<void>;
+    /** Check if storage is healthy */
+    healthCheck(): Promise<{
+        healthy: boolean;
+        details: Record<string, boolean>;
+    }>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/storage/interfaces.d.ts.map

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

package/dist/storage/interfaces.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Storage Abstraction Interfaces
+ *
+ * Enables CodeSeeker to work with either:
+ * - Embedded storage (SQLite + graphology + lru-cache) - zero setup, default
+ * - Server storage (PostgreSQL + Neo4j + Redis) - optional, for production
+ *
+ * All implementations support disk persistence for durability.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interfaces.js.map

package/dist/storage/interfaces.js.map

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

package/dist/storage/server/elasticsearch-text-store.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Elasticsearch Text Store (FUTURE FEATURE)
+ *
+ * This is a stub implementation for future Elasticsearch integration.
+ * When implemented, it will provide:
+ * - Distributed full-text search
+ * - Advanced query DSL
+ * - Synonym support via synonym filters
+ * - Scalable indexing for large codebases
+ *
+ * IMPLEMENTATION STATUS: Stub - Not yet functional
+ *
+ * To implement:
+ * 1. Install @elastic/elasticsearch package
+ * 2. Set up Docker Compose with Elasticsearch
+ * 3. Implement the methods below
+ *
+ * Docker Compose example:
+ * ```yaml
+ * services:
+ *   elasticsearch:
+ *     image: docker.elastic.co/elasticsearch/elasticsearch:8.11.0
+ *     environment:
+ *       - discovery.type=single-node
+ *       - xpack.security.enabled=false
+ *       - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
+ *     ports:
+ *       - "9200:9200"
+ *     volumes:
+ *       - elasticsearch-data:/usr/share/elasticsearch/data
+ *
+ * volumes:
+ *   elasticsearch-data:
+ * ```
+ */
+import { ITextStore, TextDocument, TextSearchResult, Synonym } from '../interfaces';
+export interface ElasticsearchConfig {
+    node: string;
+    auth?: {
+        username: string;
+        password: string;
+    };
+    indexPrefix?: string;
+}
+export declare class ElasticsearchTextStore implements ITextStore {
+    private config;
+    constructor(config: ElasticsearchConfig);
+    index(_doc: TextDocument): Promise<void>;
+    indexMany(_docs: TextDocument[]): Promise<void>;
+    search(_query: string, _projectId: string, _limit?: number): Promise<TextSearchResult[]>;
+    searchWithSynonyms(_query: string, _projectId: string, _limit?: number): Promise<TextSearchResult[]>;
+    remove(_id: string): Promise<boolean>;
+    removeByProject(_projectId: string): Promise<number>;
+    addSynonym(_term: string, _synonyms: string[], _projectId?: string): Promise<void>;
+    removeSynonym(_term: string, _projectId?: string): Promise<boolean>;
+    getSynonyms(_projectId?: string): Promise<Synonym[]>;
+    clearSynonyms(_projectId?: string): Promise<void>;
+    count(_projectId: string): Promise<number>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Future: Initialize Elasticsearch indices with proper mappings
+     *
+     * Index mapping would include:
+     * - content: text with custom analyzer for code
+     * - filePath: keyword + text for both exact and fuzzy matching
+     * - projectId: keyword for filtering
+     * - metadata: object for flexible metadata
+     *
+     * Custom analyzer would include:
+     * - camelCase tokenizer
+     * - lowercase filter
+     * - asciifolding filter
+     * - synonym filter (configurable)
+     */
+    initializeIndices(): Promise<void>;
+    /**
+     * Future: Create the index mapping for code search
+     */
+    static getIndexMapping(): object;
+}
+//# sourceMappingURL=elasticsearch-text-store.d.ts.map

package/dist/storage/server/elasticsearch-text-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elasticsearch-text-store.d.ts","sourceRoot":"","sources":["../../../src/storage/server/elasticsearch-text-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,OAAO,EACR,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,sBAAuB,YAAW,UAAU;IACvD,OAAO,CAAC,MAAM,CAAsB;gBAGxB,MAAM,EAAE,mBAAmB;IAKjC,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIxF,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAIpG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIpD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlF,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInE,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAIpD,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;;;;;;;;;;;OAcG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACH,MAAM,CAAC,eAAe,IAAI,MAAM;CAqEjC"}

package/dist/storage/server/elasticsearch-text-store.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Elasticsearch Text Store (FUTURE FEATURE)
+ *
+ * This is a stub implementation for future Elasticsearch integration.
+ * When implemented, it will provide:
+ * - Distributed full-text search
+ * - Advanced query DSL
+ * - Synonym support via synonym filters
+ * - Scalable indexing for large codebases
+ *
+ * IMPLEMENTATION STATUS: Stub - Not yet functional
+ *
+ * To implement:
+ * 1. Install @elastic/elasticsearch package
+ * 2. Set up Docker Compose with Elasticsearch
+ * 3. Implement the methods below
+ *
+ * Docker Compose example:
+ * ```yaml
+ * services:
+ *   elasticsearch:
+ *     image: docker.elastic.co/elasticsearch/elasticsearch:8.11.0
+ *     environment:
+ *       - discovery.type=single-node
+ *       - xpack.security.enabled=false
+ *       - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
+ *     ports:
+ *       - "9200:9200"
+ *     volumes:
+ *       - elasticsearch-data:/usr/share/elasticsearch/data
+ *
+ * volumes:
+ *   elasticsearch-data:
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ElasticsearchTextStore = void 0;
+class ElasticsearchTextStore {
+    config;
+    // private client: Client; // @elastic/elasticsearch Client
+    constructor(config) {
+        this.config = config;
+        console.warn('[ElasticsearchTextStore] This is a stub implementation. Elasticsearch is a future feature.');
+    }
+    async index(_doc) {
+        throw new Error('ElasticsearchTextStore is not yet implemented. Use MiniSearchTextStore for embedded mode.');
+    }
+    async indexMany(_docs) {
+        throw new Error('ElasticsearchTextStore is not yet implemented. Use MiniSearchTextStore for embedded mode.');
+    }
+    async search(_query, _projectId, _limit) {
+        throw new Error('ElasticsearchTextStore is not yet implemented. Use MiniSearchTextStore for embedded mode.');
+    }
+    async searchWithSynonyms(_query, _projectId, _limit) {
+        throw new Error('ElasticsearchTextStore is not yet implemented. Use MiniSearchTextStore for embedded mode.');
+    }
+    async remove(_id) {
+        throw new Error('ElasticsearchTextStore is not yet implemented. Use MiniSearchTextStore for embedded mode.');
+    }
+    async removeByProject(_projectId) {
+        throw new Error('ElasticsearchTextStore is not yet implemented. Use MiniSearchTextStore for embedded mode.');
+    }
+    async addSynonym(_term, _synonyms, _projectId) {
+        throw new Error('ElasticsearchTextStore is not yet implemented. Use MiniSearchTextStore for embedded mode.');
+    }
+    async removeSynonym(_term, _projectId) {
+        throw new Error('ElasticsearchTextStore is not yet implemented. Use MiniSearchTextStore for embedded mode.');
+    }
+    async getSynonyms(_projectId) {
+        throw new Error('ElasticsearchTextStore is not yet implemented. Use MiniSearchTextStore for embedded mode.');
+    }
+    async clearSynonyms(_projectId) {
+        throw new Error('ElasticsearchTextStore is not yet implemented. Use MiniSearchTextStore for embedded mode.');
+    }
+    async count(_projectId) {
+        throw new Error('ElasticsearchTextStore is not yet implemented. Use MiniSearchTextStore for embedded mode.');
+    }
+    async flush() {
+        // Elasticsearch is always persisted
+    }
+    async close() {
+        // Close client connection when implemented
+    }
+    /**
+     * Future: Initialize Elasticsearch indices with proper mappings
+     *
+     * Index mapping would include:
+     * - content: text with custom analyzer for code
+     * - filePath: keyword + text for both exact and fuzzy matching
+     * - projectId: keyword for filtering
+     * - metadata: object for flexible metadata
+     *
+     * Custom analyzer would include:
+     * - camelCase tokenizer
+     * - lowercase filter
+     * - asciifolding filter
+     * - synonym filter (configurable)
+     */
+    async initializeIndices() {
+        throw new Error('ElasticsearchTextStore is not yet implemented.');
+    }
+    /**
+     * Future: Create the index mapping for code search
+     */
+    static getIndexMapping() {
+        return {
+            mappings: {
+                properties: {
+                    id: { type: 'keyword' },
+                    projectId: { type: 'keyword' },
+                    filePath: {
+                        type: 'text',
+                        fields: {
+                            keyword: { type: 'keyword' },
+                            path: { type: 'text', analyzer: 'path_analyzer' }
+                        }
+                    },
+                    content: {
+                        type: 'text',
+                        analyzer: 'code_analyzer'
+                    },
+                    metadata: { type: 'object', enabled: true },
+                    createdAt: { type: 'date' },
+                    updatedAt: { type: 'date' }
+                }
+            },
+            settings: {
+                analysis: {
+                    analyzer: {
+                        code_analyzer: {
+                            type: 'custom',
+                            tokenizer: 'standard',
+                            filter: ['lowercase', 'camelcase_split', 'asciifolding', 'code_synonyms']
+                        },
+                        path_analyzer: {
+                            type: 'custom',
+                            tokenizer: 'path_tokenizer',
+                            filter: ['lowercase']
+                        }
+                    },
+                    tokenizer: {
+                        path_tokenizer: {
+                            type: 'pattern',
+                            pattern: '[/\\\\.]'
+                        }
+                    },
+                    filter: {
+                        camelcase_split: {
+                            type: 'word_delimiter_graph',
+                            split_on_case_change: true,
+                            preserve_original: true
+                        },
+                        code_synonyms: {
+                            type: 'synonym_graph',
+                            synonyms: [
+                                'function, method, func, procedure',
+                                'class, type, struct',
+                                'interface, contract, protocol',
+                                'variable, var, const, let',
+                                'async, asynchronous, concurrent',
+                                'database, db, datastore',
+                                'query, search, find, select',
+                                'create, add, insert, new',
+                                'update, modify, change, edit',
+                                'delete, remove, destroy',
+                                'read, get, fetch, retrieve'
+                            ]
+                        }
+                    }
+                }
+            }
+        };
+    }
+}
+exports.ElasticsearchTextStore = ElasticsearchTextStore;
+//# sourceMappingURL=elasticsearch-text-store.js.map

package/dist/storage/server/elasticsearch-text-store.js.map

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

package/dist/storage/server/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Server Storage Provider
+ *
+ * Uses external servers for production deployments:
+ * - PostgreSQL + pgvector for vector search
+ * - Neo4j for graph database
+ * - Redis for caching
+ *
+ * This module is only loaded when storage mode is 'server'.
+ * For most users, the embedded storage (SQLite + Graphology + LRU-cache) is sufficient.
+ *
+ * Setup requires Docker or manual server installation.
+ * See docs/STORAGE.md for configuration details.
+ */
+import { IStorageProvider, IVectorStore, IGraphStore, ICacheStore, IProjectStore, ITextStore, StorageMode, StorageConfig } from '../interfaces';
+export { PostgresVectorStore, PostgresVectorStoreConfig } from './postgres-vector-store';
+export { Neo4jGraphStore, Neo4jGraphStoreConfig } from './neo4j-graph-store';
+export { RedisCacheStore, RedisCacheStoreConfig } from './redis-cache-store';
+export { PostgresProjectStore, PostgresProjectStoreConfig } from './postgres-project-store';
+/**
+ * Server storage provider using PostgreSQL, Neo4j, and Redis
+ */
+export declare class ServerStorageProvider implements IStorageProvider {
+    private vectorStore;
+    private graphStore;
+    private cacheStore;
+    private projectStore;
+    constructor(config: StorageConfig);
+    getVectorStore(): IVectorStore;
+    getGraphStore(): IGraphStore;
+    getCacheStore(): ICacheStore;
+    getProjectStore(): IProjectStore;
+    getTextStore(): ITextStore;
+    getMode(): StorageMode;
+    flushAll(): Promise<void>;
+    closeAll(): Promise<void>;
+    healthCheck(): Promise<{
+        healthy: boolean;
+        details: Record<string, boolean>;
+    }>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,EACd,MAAM,eAAe,CAAC;AASvB,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAE5F;;GAEG;AACH,qBAAa,qBAAsB,YAAW,gBAAgB;IAC5D,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,YAAY,CAAuB;gBAE/B,MAAM,EAAE,aAAa;IAkBjC,cAAc,IAAI,YAAY;IAI9B,aAAa,IAAI,WAAW;IAI5B,aAAa,IAAI,WAAW;IAI5B,eAAe,IAAI,aAAa;IAIhC,YAAY,IAAI,UAAU;IAM1B,OAAO,IAAI,WAAW;IAIhB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAUzB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IASzB,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAgBrF"}