@robthepcguy/rag-vault 1.0.0

package/dist/web/api-routes.js

@@ -0,0 +1,127 @@
+"use strict";
+// REST API routes for web frontend
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createApiRouter = createApiRouter;
+const node_path_1 = __importDefault(require("node:path"));
+const express_1 = require("express");
+const index_js_1 = require("../errors/index.js");
+const index_js_2 = require("./middleware/index.js");
+/**
+ * Extract text from a RAG server response with proper bounds checking
+ * @throws RAGError if the response format is invalid
+ */
+function extractResultText(result) {
+    if (!result.content || !Array.isArray(result.content) || result.content.length === 0) {
+        throw new index_js_1.RAGError('Malformed server response: missing content array', {
+            statusCode: 500,
+        });
+    }
+    const firstContent = result.content[0];
+    if (!firstContent || typeof firstContent.text !== 'string') {
+        throw new index_js_1.RAGError('Malformed server response: missing text in content', {
+            statusCode: 500,
+        });
+    }
+    return firstContent.text;
+}
+/**
+ * Create API router with all endpoints
+ * @param serverOrAccessor - RAGServer instance or accessor function
+ */
+function createApiRouter(serverOrAccessor) {
+    const router = (0, express_1.Router)();
+    // Helper to get server (supports both direct instance and accessor function)
+    const getServer = () => {
+        if (typeof serverOrAccessor === 'function') {
+            return serverOrAccessor();
+        }
+        return serverOrAccessor;
+    };
+    // POST /api/v1/search - Search documents
+    router.post('/search', (0, index_js_2.asyncHandler)(async (req, res) => {
+        const { query, limit } = req.body;
+        if (!query || typeof query !== 'string') {
+            throw new index_js_1.ValidationError('Query is required and must be a string');
+        }
+        const queryInput = { query };
+        if (limit !== undefined) {
+            queryInput.limit = limit;
+        }
+        const server = getServer();
+        const result = await server.handleQueryDocuments(queryInput);
+        const data = JSON.parse(extractResultText(result));
+        res.json({ results: data });
+    }));
+    // POST /api/v1/files/upload - Upload files (multipart)
+    router.post('/files/upload', (0, index_js_2.asyncHandler)(async (req, res) => {
+        // File is attached by multer middleware
+        const file = req.file;
+        if (!file) {
+            throw new index_js_1.ValidationError('No file uploaded');
+        }
+        // Use the uploaded file path (convert to absolute)
+        const server = getServer();
+        const absolutePath = node_path_1.default.resolve(file.path);
+        const result = await server.handleIngestFile({ filePath: absolutePath });
+        const data = JSON.parse(extractResultText(result));
+        res.json(data);
+    }));
+    // POST /api/v1/data - Ingest content strings
+    router.post('/data', (0, index_js_2.asyncHandler)(async (req, res) => {
+        const { content, metadata } = req.body;
+        if (!content || typeof content !== 'string') {
+            throw new index_js_1.ValidationError('Content is required and must be a string');
+        }
+        if (!metadata || !metadata.source || !metadata.format) {
+            throw new index_js_1.ValidationError('Metadata with source and format is required');
+        }
+        const server = getServer();
+        const result = await server.handleIngestData({ content, metadata });
+        const data = JSON.parse(extractResultText(result));
+        res.json(data);
+    }));
+    // GET /api/v1/files - List ingested files
+    router.get('/files', (0, index_js_2.asyncHandler)(async (_req, res) => {
+        const server = getServer();
+        const result = await server.handleListFiles();
+        const data = JSON.parse(extractResultText(result));
+        res.json({ files: data });
+    }));
+    // DELETE /api/v1/files - Delete file/source
+    router.delete('/files', (0, index_js_2.asyncHandler)(async (req, res) => {
+        const { filePath, source } = req.body;
+        if (!filePath && !source) {
+            throw new index_js_1.ValidationError('Either filePath or source is required');
+        }
+        const deleteInput = {};
+        if (filePath !== undefined) {
+            deleteInput.filePath = filePath;
+        }
+        if (source !== undefined) {
+            deleteInput.source = source;
+        }
+        const server = getServer();
+        const result = await server.handleDeleteFile(deleteInput);
+        const data = JSON.parse(extractResultText(result));
+        res.json(data);
+    }));
+    // GET /api/v1/status - System status
+    router.get('/status', (0, index_js_2.asyncHandler)(async (_req, res) => {
+        const server = getServer();
+        const result = await server.handleStatus();
+        const data = JSON.parse(extractResultText(result));
+        res.json(data);
+    }));
+    // GET /api/v1/health - Lightweight health check for load balancers
+    router.get('/health', (_req, res) => {
+        res.json({
+            status: 'ok',
+            timestamp: new Date().toISOString(),
+        });
+    });
+    return router;
+}
+//# sourceMappingURL=api-routes.js.map

package/dist/web/api-routes.js.map

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

package/dist/web/config-routes.d.ts

@@ -0,0 +1,7 @@
+import type { Router } from 'express';
+import type { DatabaseManager } from './database-manager.js';
+/**
+ * Create config API router with all endpoints
+ */
+export declare function createConfigRouter(dbManager: DatabaseManager): Router;
+//# sourceMappingURL=config-routes.d.ts.map

package/dist/web/config-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-routes.d.ts","sourceRoot":"","sources":["../../src/web/config-routes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAqB,MAAM,EAAE,MAAM,SAAS,CAAA;AAGxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAyB5D;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,CAqErE"}

package/dist/web/config-routes.js

@@ -0,0 +1,54 @@
+"use strict";
+// REST API routes for database configuration
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConfigRouter = createConfigRouter;
+const express_1 = require("express");
+const index_js_1 = require("../errors/index.js");
+const index_js_2 = require("./middleware/index.js");
+/**
+ * Create config API router with all endpoints
+ */
+function createConfigRouter(dbManager) {
+    const router = (0, express_1.Router)();
+    // GET /api/v1/config/current - Get current database configuration
+    router.get('/current', (0, index_js_2.asyncHandler)(async (_req, res) => {
+        const config = await dbManager.getCurrentConfig();
+        res.json(config);
+    }));
+    // GET /api/v1/config/databases - List recent databases
+    router.get('/databases', (0, index_js_2.asyncHandler)(async (_req, res) => {
+        const databases = await dbManager.getRecentDatabases();
+        res.json({ databases });
+    }));
+    // POST /api/v1/config/databases/switch - Switch to different database
+    router.post('/databases/switch', (0, index_js_2.asyncHandler)(async (req, res) => {
+        const { dbPath } = req.body;
+        if (!dbPath || typeof dbPath !== 'string') {
+            throw new index_js_1.ValidationError('dbPath is required and must be a string');
+        }
+        await dbManager.switchDatabase(dbPath);
+        const config = await dbManager.getCurrentConfig();
+        res.json({ success: true, config });
+    }));
+    // POST /api/v1/config/databases/create - Create new database
+    router.post('/databases/create', (0, index_js_2.asyncHandler)(async (req, res) => {
+        const { dbPath, name } = req.body;
+        if (!dbPath || typeof dbPath !== 'string') {
+            throw new index_js_1.ValidationError('dbPath is required and must be a string');
+        }
+        await dbManager.createDatabase({ dbPath, name });
+        const config = await dbManager.getCurrentConfig();
+        res.json({ success: true, config });
+    }));
+    // POST /api/v1/config/databases/scan - Scan directory for databases
+    router.post('/databases/scan', (0, index_js_2.asyncHandler)(async (req, res) => {
+        const { scanPath } = req.body;
+        if (!scanPath || typeof scanPath !== 'string') {
+            throw new index_js_1.ValidationError('scanPath is required and must be a string');
+        }
+        const databases = await dbManager.scanForDatabases(scanPath);
+        res.json({ databases });
+    }));
+    return router;
+}
+//# sourceMappingURL=config-routes.js.map

package/dist/web/config-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-routes.js","sourceRoot":"","sources":["../../src/web/config-routes.ts"],"names":[],"mappings":";AAAA,6CAA6C;;AAiC7C,gDAqEC;AAnGD,qCAAgD;AAChD,iDAAoD;AAEpD,oDAAoD;AAwBpD;;GAEG;AACH,SAAgB,kBAAkB,CAAC,SAA0B;IAC3D,MAAM,MAAM,GAAG,IAAA,gBAAY,GAAE,CAAA;IAE7B,kEAAkE;IAClE,MAAM,CAAC,GAAG,CACR,UAAU,EACV,IAAA,uBAAY,EAAC,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QAClD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,gBAAgB,EAAE,CAAA;QACjD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAClB,CAAC,CAAC,CACH,CAAA;IAED,uDAAuD;IACvD,MAAM,CAAC,GAAG,CACR,YAAY,EACZ,IAAA,uBAAY,EAAC,KAAK,EAAE,IAAa,EAAE,GAAa,EAAE,EAAE;QAClD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,kBAAkB,EAAE,CAAA;QACtD,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;IACzB,CAAC,CAAC,CACH,CAAA;IAED,sEAAsE;IACtE,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,IAAA,uBAAY,EAAC,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACjD,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,IAA6B,CAAA;QAEpD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,0BAAe,CAAC,yCAAyC,CAAC,CAAA;QACtE,CAAC;QAED,MAAM,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;QACtC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,gBAAgB,EAAE,CAAA;QACjD,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IACrC,CAAC,CAAC,CACH,CAAA;IAED,6DAA6D;IAC7D,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,IAAA,uBAAY,EAAC,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACjD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,IAA6B,CAAA;QAE1D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,0BAAe,CAAC,yCAAyC,CAAC,CAAA;QACtE,CAAC;QAED,MAAM,SAAS,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QAChD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,gBAAgB,EAAE,CAAA;QACjD,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IACrC,CAAC,CAAC,CACH,CAAA;IAED,oEAAoE;IACpE,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,IAAA,uBAAY,EAAC,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACjD,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC,IAA4B,CAAA;QAErD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,IAAI,0BAAe,CAAC,2CAA2C,CAAC,CAAA;QACxE,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAC5D,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAA;IACzB,CAAC,CAAC,CACH,CAAA;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/web/database-manager.d.ts

@@ -0,0 +1,130 @@
+import type { RAGServer, RAGServerConfig } from '../server/index.js';
+/**
+ * Database entry in recent databases list
+ */
+export interface DatabaseEntry {
+    /** Absolute path to the database directory */
+    path: string;
+    /** Human-readable name (derived from path) */
+    name: string;
+    /** Last access timestamp (ISO 8601) */
+    lastAccessed: string;
+    /** Model name used with this database */
+    modelName?: string | undefined;
+}
+/**
+ * Current database configuration (extended with stats)
+ */
+export interface CurrentDatabaseConfig {
+    /** Database path */
+    dbPath: string;
+    /** Model name */
+    modelName: string;
+    /** Human-readable database name */
+    name: string;
+    /** Document count */
+    documentCount: number;
+    /** Chunk count */
+    chunkCount: number;
+}
+/**
+ * Create database options
+ */
+export interface CreateDatabaseOptions {
+    /** Path where to create the database */
+    dbPath: string;
+    /** Optional custom name */
+    name?: string | undefined;
+}
+/**
+ * Scan result for a discovered database
+ */
+export interface ScannedDatabase {
+    /** Absolute path to the database */
+    path: string;
+    /** Human-readable name */
+    name: string;
+    /** Whether this database is already in recent list */
+    isKnown: boolean;
+}
+/**
+ * DatabaseManager handles RAG database lifecycle management
+ *
+ * Responsibilities:
+ * - Track current database connection
+ * - Hot-swap between databases
+ * - Persist recent databases list
+ * - Discover databases by scanning directories
+ */
+export declare class DatabaseManager {
+    private currentServer;
+    private currentConfig;
+    private serverFactory;
+    private baseConfig;
+    private switchPromise;
+    constructor(serverFactory: (config: RAGServerConfig) => RAGServer, baseConfig: Omit<RAGServerConfig, 'dbPath'>);
+    /**
+     * Initialize with a database path
+     */
+    initialize(dbPath: string): Promise<void>;
+    /**
+     * Get current RAG server instance
+     */
+    getServer(): RAGServer;
+    /**
+     * Get current database configuration with stats
+     */
+    getCurrentConfig(): Promise<CurrentDatabaseConfig | null>;
+    /**
+     * Switch to a different database
+     *
+     * Uses promise-based mutex to prevent race conditions from concurrent switch attempts.
+     */
+    switchDatabase(newDbPath: string): Promise<void>;
+    /**
+     * Internal method to perform the actual database switch
+     */
+    private performSwitch;
+    /**
+     * Create a new database
+     */
+    createDatabase(options: CreateDatabaseOptions): Promise<void>;
+    /**
+     * Switch to a new (possibly empty) database
+     *
+     * Uses promise-based mutex to prevent race conditions from concurrent switch attempts.
+     */
+    private switchToNewDatabase;
+    /**
+     * Internal method to perform the actual switch to a new database
+     */
+    private performSwitchToNew;
+    /**
+     * Get list of recent databases
+     *
+     * Handles errors appropriately:
+     * - File not found: Normal case, returns empty array
+     * - Parse/validation error: Logs error but returns empty array to allow recovery
+     */
+    getRecentDatabases(): Promise<DatabaseEntry[]>;
+    /**
+     * Scan a directory for LanceDB databases
+     *
+     * Security: Only scans within allowed roots (ALLOWED_SCAN_ROOTS env var or home directory)
+     * to prevent path traversal attacks.
+     */
+    scanForDatabases(scanPath: string): Promise<ScannedDatabase[]>;
+    /**
+     * Add a database to recent list
+     */
+    private addToRecent;
+    /**
+     * Derive a human-readable name from a path
+     */
+    private getNameFromPath;
+    /**
+     * Ensure config directory exists
+     */
+    private ensureConfigDir;
+}
+//# sourceMappingURL=database-manager.d.ts.map

package/dist/web/database-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-manager.d.ts","sourceRoot":"","sources":["../../src/web/database-manager.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AA6EpE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B;AAUD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oBAAoB;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAA;CACjB;AAMD;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,aAAa,CAA6B;gBAGhD,aAAa,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,SAAS,EACrD,UAAU,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC;IAM7C;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB/C;;OAEG;IACH,SAAS,IAAI,SAAS;IAOtB;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IA+B/D;;;;OAIG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BtD;;OAEG;YACW,aAAa;IAsB3B;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBnE;;;;OAIG;YACW,mBAAmB;IAajC;;OAEG;YACW,kBAAkB;IAmBhC;;;;;;OAMG;IACG,kBAAkB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAsCpD;;;;;OAKG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA8DpE;;OAEG;YACW,WAAW;IAwBzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;YACW,eAAe;CAK9B"}