@robthepcguy/rag-vault 1.0.0

package/dist/web/middleware/error-handler.js

@@ -0,0 +1,68 @@
+"use strict";
+// Express error handling middleware
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpStatus = void 0;
+exports.errorHandler = errorHandler;
+exports.notFoundHandler = notFoundHandler;
+const index_js_1 = require("../../errors/index.js");
+/**
+ * HTTP status codes for API responses
+ */
+var HttpStatus;
+(function (HttpStatus) {
+    HttpStatus[HttpStatus["OK"] = 200] = "OK";
+    HttpStatus[HttpStatus["CREATED"] = 201] = "CREATED";
+    HttpStatus[HttpStatus["NO_CONTENT"] = 204] = "NO_CONTENT";
+    HttpStatus[HttpStatus["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    HttpStatus[HttpStatus["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    HttpStatus[HttpStatus["FORBIDDEN"] = 403] = "FORBIDDEN";
+    HttpStatus[HttpStatus["NOT_FOUND"] = 404] = "NOT_FOUND";
+    HttpStatus[HttpStatus["CONFLICT"] = 409] = "CONFLICT";
+    HttpStatus[HttpStatus["TOO_MANY_REQUESTS"] = 429] = "TOO_MANY_REQUESTS";
+    HttpStatus[HttpStatus["INTERNAL_ERROR"] = 500] = "INTERNAL_ERROR";
+    HttpStatus[HttpStatus["SERVICE_UNAVAILABLE"] = 503] = "SERVICE_UNAVAILABLE";
+})(HttpStatus || (exports.HttpStatus = HttpStatus = {}));
+/**
+ * Express error handling middleware
+ *
+ * Handles:
+ * - RAGError subclasses (with proper status codes)
+ * - Generic errors (500 Internal Server Error)
+ *
+ * In production, hides stack traces and internal details.
+ *
+ * @example
+ * // Add as the last middleware
+ * app.use(errorHandler)
+ */
+function errorHandler(err, _req, res, _next) {
+    // Log the error
+    console.error('Request error:', err);
+    // Build error response
+    const response = {
+        error: err.message,
+    };
+    let statusCode = 500;
+    if (err instanceof index_js_1.RAGError) {
+        statusCode = err.statusCode;
+        response.code = err.code;
+        // Only include details in non-production
+        if (process.env['NODE_ENV'] !== 'production' && err.details) {
+            response.details = err.details;
+        }
+    }
+    else {
+        // For generic errors in production, use generic message
+        if (process.env['NODE_ENV'] === 'production') {
+            response.error = 'Internal server error';
+        }
+    }
+    res.status(statusCode).json(response);
+}
+/**
+ * 404 Not Found handler
+ */
+function notFoundHandler(_req, res) {
+    res.status(404).json({ error: 'Not found' });
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/web/middleware/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../../../src/web/middleware/error-handler.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;AA4CpC,oCA2BC;AAKD,0CAEC;AA3ED,oDAAgD;AAEhD;;GAEG;AACH,IAAY,UAYX;AAZD,WAAY,UAAU;IACpB,yCAAQ,CAAA;IACR,mDAAa,CAAA;IACb,yDAAgB,CAAA;IAChB,2DAAiB,CAAA;IACjB,6DAAkB,CAAA;IAClB,uDAAe,CAAA;IACf,uDAAe,CAAA;IACf,qDAAc,CAAA;IACd,uEAAuB,CAAA;IACvB,iEAAoB,CAAA;IACpB,2EAAyB,CAAA;AAC3B,CAAC,EAZW,UAAU,0BAAV,UAAU,QAYrB;AAWD;;;;;;;;;;;;GAYG;AACH,SAAgB,YAAY,CAAC,GAAU,EAAE,IAAa,EAAE,GAAa,EAAE,KAAmB;IACxF,gBAAgB;IAChB,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAA;IAEpC,uBAAuB;IACvB,MAAM,QAAQ,GAAkB;QAC9B,KAAK,EAAE,GAAG,CAAC,OAAO;KACnB,CAAA;IAED,IAAI,UAAU,GAAG,GAAG,CAAA;IAEpB,IAAI,GAAG,YAAY,mBAAQ,EAAE,CAAC;QAC5B,UAAU,GAAG,GAAG,CAAC,UAAU,CAAA;QAC3B,QAAQ,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAA;QAExB,yCAAyC;QACzC,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,YAAY,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YAC5D,QAAQ,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAA;QAChC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,wDAAwD;QACxD,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,YAAY,EAAE,CAAC;YAC7C,QAAQ,CAAC,KAAK,GAAG,uBAAuB,CAAA;QAC1C,CAAC;IACH,CAAC;IAED,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;AACvC,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,IAAa,EAAE,GAAa;IAC1D,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;AAC9C,CAAC"}

package/dist/web/middleware/index.d.ts

@@ -0,0 +1,6 @@
+export { apiKeyAuth } from './auth.js';
+export { asyncHandler } from './async-handler.js';
+export { errorHandler, notFoundHandler } from './error-handler.js';
+export { createRateLimiter, getRateLimitConfigFromEnv, stopRateLimiterCleanup, } from './rate-limit.js';
+export { createRequestLogger, isRequestLoggingEnabled } from './request-logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/web/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/web/middleware/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/web/middleware/index.js

@@ -0,0 +1,19 @@
+"use strict";
+// Web middleware exports
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRequestLoggingEnabled = exports.createRequestLogger = exports.stopRateLimiterCleanup = exports.getRateLimitConfigFromEnv = exports.createRateLimiter = exports.notFoundHandler = exports.errorHandler = exports.asyncHandler = exports.apiKeyAuth = void 0;
+var auth_js_1 = require("./auth.js");
+Object.defineProperty(exports, "apiKeyAuth", { enumerable: true, get: function () { return auth_js_1.apiKeyAuth; } });
+var async_handler_js_1 = require("./async-handler.js");
+Object.defineProperty(exports, "asyncHandler", { enumerable: true, get: function () { return async_handler_js_1.asyncHandler; } });
+var error_handler_js_1 = require("./error-handler.js");
+Object.defineProperty(exports, "errorHandler", { enumerable: true, get: function () { return error_handler_js_1.errorHandler; } });
+Object.defineProperty(exports, "notFoundHandler", { enumerable: true, get: function () { return error_handler_js_1.notFoundHandler; } });
+var rate_limit_js_1 = require("./rate-limit.js");
+Object.defineProperty(exports, "createRateLimiter", { enumerable: true, get: function () { return rate_limit_js_1.createRateLimiter; } });
+Object.defineProperty(exports, "getRateLimitConfigFromEnv", { enumerable: true, get: function () { return rate_limit_js_1.getRateLimitConfigFromEnv; } });
+Object.defineProperty(exports, "stopRateLimiterCleanup", { enumerable: true, get: function () { return rate_limit_js_1.stopRateLimiterCleanup; } });
+var request_logger_js_1 = require("./request-logger.js");
+Object.defineProperty(exports, "createRequestLogger", { enumerable: true, get: function () { return request_logger_js_1.createRequestLogger; } });
+Object.defineProperty(exports, "isRequestLoggingEnabled", { enumerable: true, get: function () { return request_logger_js_1.isRequestLoggingEnabled; } });
+//# sourceMappingURL=index.js.map

package/dist/web/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/web/middleware/index.ts"],"names":[],"mappings":";AAAA,yBAAyB;;;AAEzB,qCAAsC;AAA7B,qGAAA,UAAU,OAAA;AACnB,uDAAiD;AAAxC,gHAAA,YAAY,OAAA;AACrB,uDAAkE;AAAzD,gHAAA,YAAY,OAAA;AAAE,mHAAA,eAAe,OAAA;AACtC,iDAIwB;AAHtB,kHAAA,iBAAiB,OAAA;AACjB,0HAAA,yBAAyB,OAAA;AACzB,uHAAA,sBAAsB,OAAA;AAExB,yDAAkF;AAAzE,wHAAA,mBAAmB,OAAA;AAAE,4HAAA,uBAAuB,OAAA"}

package/dist/web/middleware/rate-limit.d.ts

@@ -0,0 +1,38 @@
+import type { NextFunction, Request, Response } from 'express';
+/**
+ * Rate limit configuration
+ */
+export interface RateLimitConfig {
+    /** Time window in milliseconds */
+    windowMs: number;
+    /** Maximum requests per window */
+    maxRequests: number;
+    /** Message to return when rate limited */
+    message?: string;
+}
+/**
+ * Create a rate limiting middleware
+ *
+ * Uses client IP address for tracking. In production with proxies,
+ * ensure trust proxy is configured in Express.
+ *
+ * @example
+ * app.use('/api', createRateLimiter({ windowMs: 60000, maxRequests: 100 }))
+ */
+export declare function createRateLimiter(config?: Partial<RateLimitConfig>): (req: Request, res: Response, next: NextFunction) => void;
+/**
+ * Get rate limit configuration from environment variables
+ *
+ * Environment variables:
+ * - RATE_LIMIT_WINDOW_MS: Time window in milliseconds (default: 60000)
+ * - RATE_LIMIT_MAX_REQUESTS: Max requests per window (default: 100)
+ */
+export declare function getRateLimitConfigFromEnv(): RateLimitConfig;
+/**
+ * Stop the rate limiter cleanup interval
+ *
+ * Call this during graceful shutdown to prevent memory leaks.
+ * Safe to call multiple times or when no interval is active.
+ */
+export declare function stopRateLimiterCleanup(): void;
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/web/middleware/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../../src/web/middleware/rate-limit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAQ9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,IAiC7D,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,KAAG,IAAI,CAkC/D;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,IAAI,eAAe,CAY3D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAM7C"}

package/dist/web/middleware/rate-limit.js

@@ -0,0 +1,116 @@
+"use strict";
+// Simple in-memory rate limiting middleware
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRateLimiter = createRateLimiter;
+exports.getRateLimitConfigFromEnv = getRateLimitConfigFromEnv;
+exports.stopRateLimiterCleanup = stopRateLimiterCleanup;
+// Track active cleanup interval for graceful shutdown
+let cleanupInterval = null;
+// Track if rate limiter has been created (for warning)
+let rateLimiterCreated = false;
+/**
+ * Default rate limit configuration
+ */
+const DEFAULT_CONFIG = {
+    windowMs: 60 * 1000, // 1 minute
+    maxRequests: 100, // 100 requests per minute
+    message: 'Too many requests, please try again later',
+};
+/**
+ * Create a rate limiting middleware
+ *
+ * Uses client IP address for tracking. In production with proxies,
+ * ensure trust proxy is configured in Express.
+ *
+ * @example
+ * app.use('/api', createRateLimiter({ windowMs: 60000, maxRequests: 100 }))
+ */
+function createRateLimiter(config = {}) {
+    const { windowMs, maxRequests, message } = { ...DEFAULT_CONFIG, ...config };
+    // Warn if rate limiter is being recreated (potential memory leak)
+    if (rateLimiterCreated) {
+        console.warn('Rate limiter already created. Creating a new instance replaces the previous one. ' +
+            'If this is intentional, call stopRateLimiterCleanup() first.');
+    }
+    rateLimiterCreated = true;
+    // In-memory store for client request counts
+    const clients = new Map();
+    // Clear any existing cleanup interval before creating a new one
+    if (cleanupInterval) {
+        clearInterval(cleanupInterval);
+    }
+    // Cleanup old entries periodically
+    cleanupInterval = setInterval(() => {
+        const now = Date.now();
+        for (const [key, record] of clients.entries()) {
+            if (record.resetTime < now) {
+                clients.delete(key);
+            }
+        }
+    }, windowMs * 2);
+    // Prevent interval from keeping process alive
+    cleanupInterval.unref();
+    return (req, res, next) => {
+        // Get client identifier (IP address)
+        const clientId = req.ip || req.socket.remoteAddress || 'unknown';
+        const now = Date.now();
+        // Get or create client record
+        let record = clients.get(clientId);
+        if (!record || record.resetTime < now) {
+            // New window
+            record = { count: 1, resetTime: now + windowMs };
+            clients.set(clientId, record);
+        }
+        else {
+            // Increment existing window
+            record.count++;
+        }
+        // Set rate limit headers
+        res.setHeader('X-RateLimit-Limit', maxRequests);
+        res.setHeader('X-RateLimit-Remaining', Math.max(0, maxRequests - record.count));
+        res.setHeader('X-RateLimit-Reset', Math.ceil(record.resetTime / 1000));
+        // Check if rate limited
+        if (record.count > maxRequests) {
+            res.status(429).json({
+                error: message,
+                code: 'RATE_LIMIT_EXCEEDED',
+                retryAfter: Math.ceil((record.resetTime - now) / 1000),
+            });
+            return;
+        }
+        next();
+    };
+}
+/**
+ * Get rate limit configuration from environment variables
+ *
+ * Environment variables:
+ * - RATE_LIMIT_WINDOW_MS: Time window in milliseconds (default: 60000)
+ * - RATE_LIMIT_MAX_REQUESTS: Max requests per window (default: 100)
+ */
+function getRateLimitConfigFromEnv() {
+    const windowMs = Number.parseInt(process.env['RATE_LIMIT_WINDOW_MS'] || '60000', 10);
+    const maxRequests = Number.parseInt(process.env['RATE_LIMIT_MAX_REQUESTS'] || '100', 10);
+    const config = {
+        windowMs: Number.isNaN(windowMs) ? DEFAULT_CONFIG.windowMs : windowMs,
+        maxRequests: Number.isNaN(maxRequests) ? DEFAULT_CONFIG.maxRequests : maxRequests,
+    };
+    if (DEFAULT_CONFIG.message !== undefined) {
+        config.message = DEFAULT_CONFIG.message;
+    }
+    return config;
+}
+/**
+ * Stop the rate limiter cleanup interval
+ *
+ * Call this during graceful shutdown to prevent memory leaks.
+ * Safe to call multiple times or when no interval is active.
+ */
+function stopRateLimiterCleanup() {
+    if (cleanupInterval) {
+        clearInterval(cleanupInterval);
+        cleanupInterval = null;
+    }
+    rateLimiterCreated = false;
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/web/middleware/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../../src/web/middleware/rate-limit.ts"],"names":[],"mappings":";AAAA,4CAA4C;;AAgD5C,8CAmEC;AASD,8DAYC;AAQD,wDAMC;AAlJD,sDAAsD;AACtD,IAAI,eAAe,GAA0B,IAAI,CAAA;AAEjD,uDAAuD;AACvD,IAAI,kBAAkB,GAAG,KAAK,CAAA;AAsB9B;;GAEG;AACH,MAAM,cAAc,GAAoB;IACtC,QAAQ,EAAE,EAAE,GAAG,IAAI,EAAE,WAAW;IAChC,WAAW,EAAE,GAAG,EAAE,0BAA0B;IAC5C,OAAO,EAAE,2CAA2C;CACrD,CAAA;AAED;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAAC,SAAmC,EAAE;IACrE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAA;IAE3E,kEAAkE;IAClE,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CACV,mFAAmF;YACjF,8DAA8D,CACjE,CAAA;IACH,CAAC;IACD,kBAAkB,GAAG,IAAI,CAAA;IAEzB,4CAA4C;IAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAA;IAE/C,gEAAgE;IAChE,IAAI,eAAe,EAAE,CAAC;QACpB,aAAa,CAAC,eAAe,CAAC,CAAA;IAChC,CAAC;IAED,mCAAmC;IACnC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;QACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,IAAI,MAAM,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;gBAC3B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YACrB,CAAC;QACH,CAAC;IACH,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAA;IAEhB,8CAA8C;IAC9C,eAAe,CAAC,KAAK,EAAE,CAAA;IAEvB,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAQ,EAAE;QAC/D,qCAAqC;QACrC,MAAM,QAAQ,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,SAAS,CAAA;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAEtB,8BAA8B;QAC9B,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAElC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;YACtC,aAAa;YACb,MAAM,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,GAAG,QAAQ,EAAE,CAAA;YAChD,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC/B,CAAC;aAAM,CAAC;YACN,4BAA4B;YAC5B,MAAM,CAAC,KAAK,EAAE,CAAA;QAChB,CAAC;QAED,yBAAyB;QACzB,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAA;QAC/C,GAAG,CAAC,SAAS,CAAC,uBAAuB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QAC/E,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAA;QAEtE,wBAAwB;QACxB,IAAI,MAAM,CAAC,KAAK,GAAG,WAAW,EAAE,CAAC;YAC/B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBACnB,KAAK,EAAE,OAAO;gBACd,IAAI,EAAE,qBAAqB;gBAC3B,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC;aACvD,CAAC,CAAA;YACF,OAAM;QACR,CAAC;QAED,IAAI,EAAE,CAAA;IACR,CAAC,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,yBAAyB;IACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,OAAO,EAAE,EAAE,CAAC,CAAA;IACpF,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC,CAAA;IAExF,MAAM,MAAM,GAAoB;QAC9B,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;QACrE,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW;KAClF,CAAA;IACD,IAAI,cAAc,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,CAAC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAA;IACzC,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB;IACpC,IAAI,eAAe,EAAE,CAAC;QACpB,aAAa,CAAC,eAAe,CAAC,CAAA;QAC9B,eAAe,GAAG,IAAI,CAAA;IACxB,CAAC;IACD,kBAAkB,GAAG,KAAK,CAAA;AAC5B,CAAC"}

package/dist/web/middleware/request-logger.d.ts

@@ -0,0 +1,52 @@
+import type { NextFunction, Request, Response } from 'express';
+/**
+ * Log entry structure
+ */
+export interface RequestLogEntry {
+    timestamp: string;
+    method: string;
+    path: string;
+    statusCode: number;
+    responseTime: number;
+    clientIp: string;
+    userAgent: string;
+    contentLength?: number;
+}
+/**
+ * Logger function type
+ */
+export type LoggerFn = (entry: RequestLogEntry) => void;
+/**
+ * Request logging configuration
+ */
+export interface RequestLoggerConfig {
+    /** Custom logger function */
+    logger?: LoggerFn;
+    /** Skip logging for certain paths (e.g., health checks) */
+    skip?: (req: Request) => boolean;
+    /** Include request body in logs (careful with sensitive data) */
+    includeBody?: boolean;
+}
+/**
+ * Create a request logging middleware
+ *
+ * Logs all incoming requests with timing information for audit trails.
+ *
+ * @example
+ * app.use(createRequestLogger())
+ *
+ * @example
+ * // With custom logger
+ * app.use(createRequestLogger({
+ *   logger: (entry) => myLogger.info(entry),
+ *   skip: (req) => req.path === '/health'
+ * }))
+ */
+export declare function createRequestLogger(config?: RequestLoggerConfig): (req: Request, res: Response, next: NextFunction) => void;
+/**
+ * Check if request logging is enabled via environment variable
+ *
+ * Enable with: REQUEST_LOGGING=true
+ */
+export declare function isRequestLoggingEnabled(): boolean;
+//# sourceMappingURL=request-logger.d.ts.map

package/dist/web/middleware/request-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-logger.d.ts","sourceRoot":"","sources":["../../../src/web/middleware/request-logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAE9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;AAkBvD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,MAAM,CAAC,EAAE,QAAQ,CAAA;IACjB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA;IAChC,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,mBAAwB,IAG1D,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,KAAG,IAAI,CAgC/D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAGjD"}

package/dist/web/middleware/request-logger.js

@@ -0,0 +1,74 @@
+"use strict";
+// Request logging middleware for audit trail
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRequestLogger = createRequestLogger;
+exports.isRequestLoggingEnabled = isRequestLoggingEnabled;
+/**
+ * Default logger - outputs to stderr in structured format
+ */
+const defaultLogger = (entry) => {
+    const logLine = [
+        `[${entry.timestamp}]`,
+        entry.method,
+        entry.path,
+        entry.statusCode,
+        `${entry.responseTime}ms`,
+        entry.clientIp,
+    ].join(' ');
+    console.error(logLine);
+};
+/**
+ * Create a request logging middleware
+ *
+ * Logs all incoming requests with timing information for audit trails.
+ *
+ * @example
+ * app.use(createRequestLogger())
+ *
+ * @example
+ * // With custom logger
+ * app.use(createRequestLogger({
+ *   logger: (entry) => myLogger.info(entry),
+ *   skip: (req) => req.path === '/health'
+ * }))
+ */
+function createRequestLogger(config = {}) {
+    const { logger = defaultLogger, skip } = config;
+    return (req, res, next) => {
+        // Skip logging if configured
+        if (skip?.(req)) {
+            next();
+            return;
+        }
+        const startTime = Date.now();
+        // Capture response finish
+        res.on('finish', () => {
+            const entry = {
+                timestamp: new Date().toISOString(),
+                method: req.method,
+                path: req.originalUrl || req.url,
+                statusCode: res.statusCode,
+                responseTime: Date.now() - startTime,
+                clientIp: req.ip || req.socket.remoteAddress || 'unknown',
+                userAgent: req.get('user-agent') || 'unknown',
+            };
+            // Add content length if available
+            const contentLength = res.get('content-length');
+            if (contentLength) {
+                entry.contentLength = Number.parseInt(contentLength, 10);
+            }
+            logger(entry);
+        });
+        next();
+    };
+}
+/**
+ * Check if request logging is enabled via environment variable
+ *
+ * Enable with: REQUEST_LOGGING=true
+ */
+function isRequestLoggingEnabled() {
+    const envValue = process.env['REQUEST_LOGGING'];
+    return envValue === 'true' || envValue === '1';
+}
+//# sourceMappingURL=request-logger.js.map

package/dist/web/middleware/request-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-logger.js","sourceRoot":"","sources":["../../../src/web/middleware/request-logger.ts"],"names":[],"mappings":";AAAA,6CAA6C;;AAkE7C,kDAmCC;AAOD,0DAGC;AAxFD;;GAEG;AACH,MAAM,aAAa,GAAa,CAAC,KAAK,EAAE,EAAE;IACxC,MAAM,OAAO,GAAG;QACd,IAAI,KAAK,CAAC,SAAS,GAAG;QACtB,KAAK,CAAC,MAAM;QACZ,KAAK,CAAC,IAAI;QACV,KAAK,CAAC,UAAU;QAChB,GAAG,KAAK,CAAC,YAAY,IAAI;QACzB,KAAK,CAAC,QAAQ;KACf,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAEX,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;AACxB,CAAC,CAAA;AAcD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,mBAAmB,CAAC,SAA8B,EAAE;IAClE,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,IAAI,EAAE,GAAG,MAAM,CAAA;IAE/C,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAQ,EAAE;QAC/D,6BAA6B;QAC7B,IAAI,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;YAChB,IAAI,EAAE,CAAA;YACN,OAAM;QACR,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAE5B,0BAA0B;QAC1B,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YACpB,MAAM,KAAK,GAAoB;gBAC7B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,IAAI,EAAE,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,GAAG;gBAChC,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,YAAY,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBACpC,QAAQ,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,SAAS;gBACzD,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,SAAS;aAC9C,CAAA;YAED,kCAAkC;YAClC,MAAM,aAAa,GAAG,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;YAC/C,IAAI,aAAa,EAAE,CAAC;gBAClB,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC,CAAA;YAC1D,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,CAAA;QACf,CAAC,CAAC,CAAA;QAEF,IAAI,EAAE,CAAA;IACR,CAAC,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;IAC/C,OAAO,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,GAAG,CAAA;AAChD,CAAC"}

package/dist/web/types.d.ts

@@ -0,0 +1,6 @@
+import type { RAGServer } from '../server/index.js';
+/**
+ * Server accessor function type - allows dynamic server access
+ */
+export type ServerAccessor = () => RAGServer;
+//# sourceMappingURL=types.d.ts.map

package/dist/web/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/web/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAEnD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,SAAS,CAAA"}

package/dist/web/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Shared types for web module
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/web/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/web/types.ts"],"names":[],"mappings":";AAAA,8BAA8B"}

package/package.json

@@ -0,0 +1,135 @@
+{
+  "name": "@robthepcguy/rag-vault",
+  "version": "1.0.0",
+  "description": "Local RAG MCP Server - Easy-to-setup document search with minimal configuration",
+  "main": "dist/index.js",
+  "bin": {
+    "rag-vault": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "keywords": [
+    "typescript",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "rag",
+    "vector-search",
+    "semantic-search",
+    "embeddings",
+    "lancedb",
+    "transformers",
+    "huggingface",
+    "local-ai",
+    "offline",
+    "privacy",
+    "document-search",
+    "pdf",
+    "json",
+    "claude-code",
+    "cursor",
+    "codex",
+    "skills"
+  ],
+  "author": "RobThePCGuy",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RobThePCGuy/rag-vault.git"
+  },
+  "scripts": {
+    "build": "tsc && tsc-alias",
+    "check": "pnpm type-check && pnpm lint && pnpm format:check",
+    "check:all": "pnpm check && pnpm check:unused && pnpm check:deps && pnpm build && pnpm test",
+    "check:deps": "madge --circular --extensions ts src",
+    "check:deps:graph": "madge --extensions ts --image graph.svg src",
+    "check:unused": "node scripts/check-unused-exports.js",
+    "check:unused:all": "knip",
+    "cleanup:processes": "bash ./scripts/cleanup-test-processes.sh",
+    "dev": "tsx src/index.ts",
+    "format": "biome format --write src",
+    "format:check": "biome format src",
+    "lint": "biome lint src",
+    "lint:fix": "biome lint --write src",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:safe": "pnpm test && pnpm cleanup:processes",
+    "test:watch": "vitest",
+    "type-check": "tsc --noEmit",
+    "audit": "pnpm audit --audit-level=moderate",
+    "audit:fix": "pnpm audit --fix",
+    "setup:web": "pnpm install && pnpm web:build && pnpm --prefix web-ui install && pnpm ui:build && pnpm web:dev",
+    "ui:build": "pnpm --prefix web-ui build",
+    "ui:dev": "cd web-ui && pnpm dev",
+    "web:build": "pnpm build",
+    "web:dev": "concurrently -n api,ui -c blue,magenta \"pnpm web:watch\" \"pnpm --prefix web-ui dev\"",
+    "web:start": "node dist/web/index.js",
+    "web:watch": "tsx watch src/web/index.ts",
+    "web": "tsx src/web/index.ts"
+  },
+  "dependencies": {
+    "@huggingface/transformers": "^3.7.6",
+    "hono": "^4.11.7",
+    "@lancedb/lancedb": "^0.23.0",
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "@mozilla/readability": "^0.6.0",
+    "compression": "^1.8.1",
+    "cors": "^2.8.5",
+    "express": "^4.21.2",
+    "file-type": "^21.3.0",
+    "helmet": "^8.1.0",
+    "jsdom": "^27.4.0",
+    "mammoth": "^1.11.0",
+    "multer": "^2.0.2",
+    "pdfjs-dist": "^5.4.530",
+    "turndown": "^7.2.2",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.12",
+    "@types/compression": "^1.8.1",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.0",
+    "@types/jsdom": "^27.0.0",
+    "@types/multer": "^2.0.0",
+    "@types/node": "^24.0.0",
+    "@types/turndown": "5.0.6",
+    "@vitest/coverage-v8": "^4.0.18",
+    "concurrently": "^9.2.1",
+    "husky": "^9.1.7",
+    "knip": "^5.61.0",
+    "lint-staged": "^16.2.7",
+    "madge": "^8.0.0",
+    "ts-node": "^10.9.1",
+    "tsc-alias": "^1.8.7",
+    "tsx": "^4.19.4",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.18"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "lint-staged": {
+    "src/**/*.{ts,tsx}": [
+      "biome check --write --no-errors-on-unmatched"
+    ]
+  },
+  "mcpName": "io.github.RobThePCGuy/rag-vault",
+  "pnpm": {
+    "overrides": {
+      "tar": ">=7.5.4",
+      "hono": "4.11.7",
+      "diff": ">=4.0.4"
+    },
+    "onlyBuiltDependencies": [
+      "esbuild",
+      "onnxruntime-node",
+      "protobufjs",
+      "@robthepcguy/rag-vault",
+      "sharp"
+    ]
+  }
+}