request-scope-api 1.0.0

package/dist/cjs/dashboard/router.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * RequestScope — Dashboard router.
+ *
+ * Provides an Express router with:
+ *   - Optional BasicAuth middleware
+ *   - API routes for querying records
+ *   - Static file serving for the React SPA
+ *   - SPA fallback for client-side routing
+ *
+ * Requirements: 8.1, 8.2, 8.3, 8.4
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDashboardRouter = createDashboardRouter;
+const express_1 = require("express");
+const path_1 = __importDefault(require("path"));
+const api_1 = require("./api");
+// ---------------------------------------------------------------------------
+// BasicAuth middleware
+// ---------------------------------------------------------------------------
+/**
+ * Creates a BasicAuth middleware if auth config is provided.
+ *
+ * Checks the Authorization header for Basic auth credentials.
+ * If credentials are missing or don't match, responds with 401 and
+ * WWW-Authenticate header.
+ */
+function createBasicAuthMiddleware(auth) {
+    if (!auth) {
+        return (_req, _res, next) => next();
+    }
+    const { username, password } = auth;
+    const expectedAuth = `Basic ${Buffer.from(`${username}:${password}`).toString('base64')}`;
+    return (req, res, next) => {
+        const authHeader = req.headers.authorization;
+        if (!authHeader || authHeader !== expectedAuth) {
+            res.setHeader('WWW-Authenticate', 'Basic realm="RequestScope"');
+            res.status(401).json({ error: 'Unauthorized' });
+            return;
+        }
+        next();
+    };
+}
+// ---------------------------------------------------------------------------
+// Dashboard router factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates and returns an Express router for the RequestScope dashboard.
+ *
+ * The router includes:
+ *   - BasicAuth middleware (if auth config is provided)
+ *   - GET /api/records — List records with filtering and pagination
+ *   - GET /api/records/:id — Get a single record by ID
+ *   - Static file serving for the React SPA
+ *   - SPA fallback for client-side routing
+ *
+ * @param config - Optional dashboard configuration
+ * @param adapter - Storage adapter instance (must be set on the app)
+ * @returns Express Router
+ */
+function createDashboardRouter(config, adapter) {
+    const router = (0, express_1.Router)();
+    // Install BasicAuth middleware if auth config is present
+    const authMiddleware = createBasicAuthMiddleware(config?.auth);
+    router.use(authMiddleware);
+    // Set the adapter on the app for API handlers to access
+    router.use((req, res, next) => {
+        if (adapter) {
+            req.app.set('requestscopeAdapter', adapter);
+        }
+        next();
+    });
+    // Mount API routes
+    router.get('/api/records', api_1.getRecords);
+    router.get('/api/records/:id', api_1.getRecordById);
+    router.delete('/api/records', api_1.deleteAllRecords);
+    // Serve static files from the dashboard bundle
+    // The dashboard is built to dist/dashboard
+    // Resolve from project root regardless of where this file is
+    const dashboardPath = path_1.default.resolve(process.cwd(), 'dist/dashboard');
+    // Serve static files from the built dashboard
+    router.use((0, express_1.static)(dashboardPath));
+    // Explicitly serve index.html for the root path
+    router.get('/', (req, res) => {
+        res.sendFile(path_1.default.join(dashboardPath, 'index.html'));
+    });
+    // SPA fallback for client-side routing (must be after static files)
+    router.get('*', (req, res) => {
+        res.sendFile(path_1.default.join(dashboardPath, 'index.html'));
+    });
+    return router;
+}
+//# sourceMappingURL=router.js.map

package/dist/cjs/dashboard/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/dashboard/router.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;AAyDH,sDA0CC;AAjGD,qCAA2F;AAC3F,gDAAwB;AAExB,+BAAoE;AAEpE,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;;GAMG;AACH,SAAS,yBAAyB,CAAC,IAA6C;IAC9E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,IAAa,EAAE,IAAc,EAAE,IAAkB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IACvE,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACpC,MAAM,YAAY,GAAG,SAAS,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IAE1F,OAAO,CAAC,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;QACzD,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC;QAE7C,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;YAC/C,GAAG,CAAC,SAAS,CAAC,kBAAkB,EAAE,4BAA4B,CAAC,CAAC;YAChE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QAED,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E;;;;;;;;;;;;;GAaG;AACH,SAAgB,qBAAqB,CACnC,MAAwB,EACxB,OAAwB;IAExB,MAAM,MAAM,GAAG,IAAA,gBAAM,GAAE,CAAC;IAExB,yDAAyD;IACzD,MAAM,cAAc,GAAG,yBAAyB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/D,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAE3B,wDAAwD;IACxD,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QAC5B,IAAI,OAAO,EAAE,CAAC;YACZ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC,CAAC,CAAC;IAEH,mBAAmB;IACnB,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,gBAAU,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE,mBAAa,CAAC,CAAC;IAC9C,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,sBAAgB,CAAC,CAAC;IAEhD,+CAA+C;IAC/C,2CAA2C;IAC3C,6DAA6D;IAC7D,MAAM,aAAa,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAEpE,8CAA8C;IAC9C,MAAM,CAAC,GAAG,CAAC,IAAA,gBAAa,EAAC,aAAa,CAAC,CAAC,CAAC;IAEzC,gDAAgD;IAChD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC9C,GAAG,CAAC,QAAQ,CAAC,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,oEAAoE;IACpE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;QAC9C,GAAG,CAAC,QAAQ,CAAC,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * RequestScope — Public API entry point.
+ *
+ * Exports:
+ *   - Default export: requestscope(config) middleware factory
+ *   - requestscope.dashboard: dashboard router factory
+ *   - All public TypeScript interfaces
+ *
+ * Requirements: 1.1, 12.1, 12.2, 12.3, 12.4
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requestscopeMiddleware = exports.errorHandler = exports.setup = void 0;
+exports.dashboard = dashboard;
+const middleware_1 = require("./middleware");
+Object.defineProperty(exports, "errorHandler", { enumerable: true, get: function () { return middleware_1.errorHandler; } });
+Object.defineProperty(exports, "setup", { enumerable: true, get: function () { return middleware_1.setup; } });
+const router_1 = require("./dashboard/router");
+// ---------------------------------------------------------------------------
+// Main middleware factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates and returns an Express middleware that captures HTTP requests.
+ *
+ * @param config - RequestScope configuration object
+ * @returns Express RequestHandler middleware
+ */
+exports.default = middleware_1.requestscope;
+// ---------------------------------------------------------------------------
+// Dashboard router factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates and returns an Express router for the RequestScope dashboard.
+ *
+ * @param config - Optional dashboard configuration
+ * @param adapter - Optional storage adapter instance
+ * @returns Express Router
+ */
+function dashboard(config, adapter) {
+    return (0, router_1.createDashboardRouter)(config, adapter);
+}
+// Attach dashboard as a named property on the default export for convenience
+middleware_1.requestscope.dashboard = dashboard;
+// ---------------------------------------------------------------------------
+// Named exports for convenience
+// ---------------------------------------------------------------------------
+var middleware_2 = require("./middleware");
+Object.defineProperty(exports, "requestscopeMiddleware", { enumerable: true, get: function () { return middleware_2.requestscope; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAsCH,8BAEC;AArCD,6CAA2F;AAoDlF,6FApDwC,yBAAY,OAoDxC;AANZ,sFA9CsD,kBAAK,OA8CtD;AA7Cd,+CAA2D;AAW3D,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E;;;;;GAKG;AACH,kBAAe,yBAAsB,CAAC;AAEtC,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E;;;;;;GAMG;AACH,SAAgB,SAAS,CAAC,MAAwB,EAAE,OAAwB;IAC1E,OAAO,IAAA,8BAAqB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,6EAA6E;AAC5E,yBAA8B,CAAC,SAAS,GAAG,SAAS,CAAC;AA4BtD,8EAA8E;AAC9E,gCAAgC;AAChC,8EAA8E;AAE9E,2CAAsE;AAA7D,oHAAA,YAAY,OAA0B"}

package/dist/cjs/masker.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * masker.ts — Recursive sensitive field masking
+ *
+ * Provides a pure function that recursively replaces sensitive field values
+ * with "******" at any nesting depth.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maskObject = maskObject;
+/**
+ * Checks if a value is a plain object (not an Array, Date, or class instance).
+ *
+ * @param val - The value to check
+ * @returns True if val is a plain object
+ */
+function isPlainObject(val) {
+    if (val === null || typeof val !== 'object') {
+        return false;
+    }
+    // Reject arrays
+    if (Array.isArray(val)) {
+        return false;
+    }
+    // Check if it's a plain object (created by {} or Object.create(null))
+    // using Object.prototype.toString
+    const proto = Object.getPrototypeOf(val);
+    return proto === null || proto === Object.prototype;
+}
+/**
+ * Recursively masks sensitive fields in an object.
+ *
+ * @param obj - The object to mask
+ * @param sensitiveFields - Set of field names to mask (stored in lowercase)
+ * @param depth - Current recursion depth (default: 0)
+ * @returns A new object with sensitive fields replaced by "******"
+ */
+function maskObject(obj, sensitiveFields, depth = 0) {
+    // Prevent infinite recursion
+    if (depth > 10) {
+        return obj;
+    }
+    const result = {};
+    for (const key in obj) {
+        if (!Object.prototype.hasOwnProperty.call(obj, key)) {
+            continue;
+        }
+        const value = obj[key];
+        // Check if this key is sensitive (case-insensitive comparison)
+        if (sensitiveFields.has(key.toLowerCase())) {
+            result[key] = '******';
+            continue;
+        }
+        // Recurse into plain objects
+        if (isPlainObject(value)) {
+            result[key] = maskObject(value, sensitiveFields, depth + 1);
+            continue;
+        }
+        // Map over arrays: recurse on plain objects, pass primitives through
+        if (Array.isArray(value)) {
+            result[key] = value.map((element) => {
+                if (isPlainObject(element)) {
+                    return maskObject(element, sensitiveFields, depth + 1);
+                }
+                return element;
+            });
+            continue;
+        }
+        // Pass through all other values (primitives, dates, etc.)
+        result[key] = value;
+    }
+    return result;
+}
+//# sourceMappingURL=masker.js.map

package/dist/cjs/masker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"masker.js","sourceRoot":"","sources":["../../src/masker.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAgCH,gCA+CC;AA7ED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,GAAY;IACjC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gBAAgB;IAChB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sEAAsE;IACtE,kCAAkC;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,CAAC;AACtD,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,UAAU,CACxB,GAA4B,EAC5B,eAA4B,EAC5B,QAAgB,CAAC;IAEjB,6BAA6B;IAC7B,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACf,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YACpD,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QAEvB,+DAA+D;QAC/D,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;YACvB,SAAS;QACX,CAAC;QAED,6BAA6B;QAC7B,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAC5D,SAAS;QACX,CAAC;QAED,qEAAqE;QACrE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;gBAClC,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC3B,OAAO,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;gBACzD,CAAC;gBACD,OAAO,OAAO,CAAC;YACjB,CAAC,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,0DAA0D;QAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cjs/middleware.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * RequestScope — Core middleware factory.
+ *
+ * Provides:
+ *   - requestscope(config) — Express middleware factory that validates config,
+ *     instantiates the appropriate storage adapter, creates AsyncQueue and
+ *     RetentionScheduler, and returns a request handler.
+ *   - errorHandler — 4-arity error middleware that attaches error data to
+ *     the request for capture by the finish handler.
+ *
+ * Requirements: 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 1.7, 2.2, 4.1, 4.2, 4.3, 5.1
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requestscope = requestscope;
+exports.setup = setup;
+exports.errorHandler = errorHandler;
+const config_1 = require("./config");
+const mongo_adapter_1 = require("./adapters/mongo.adapter");
+const mysql_adapter_1 = require("./adapters/mysql.adapter");
+const pg_adapter_1 = require("./adapters/pg.adapter");
+const queue_1 = require("./queue");
+const retention_1 = require("./retention");
+const capture_1 = require("./capture");
+const router_1 = require("./dashboard/router");
+// ---------------------------------------------------------------------------
+// Factory function
+// ---------------------------------------------------------------------------
+/**
+ * Creates and returns an Express middleware that captures HTTP requests.
+ *
+ * Validation and initialization:
+ *   1. Calls `validateConfig()`, `applyDefaults()`, and `buildSensitiveFieldSet()`
+ *      synchronously; throws on any validation error.
+ *   2. Instantiates the correct `StorageAdapter` based on `storage.type` (unless adapter is provided).
+ *   3. Calls `adapter.initialize()` asynchronously; logs errors to `stderr`
+ *      without throwing (middleware continues to function even if storage fails).
+ *   4. Creates `AsyncQueue` and `RetentionScheduler`; starts both.
+ *   5. Attaches queue `drain()` to `process.on('SIGTERM')` and
+ *      `process.on('SIGINT')` for graceful shutdown.
+ *
+ * Request handling:
+ *   - Checks `ignore` list; skips capture and calls `next()` if matched.
+ *   - Buffers request body via `bufferRequestBody()`.
+ *   - Wraps response via `wrapResponse()` to accumulate response chunks.
+ *   - On response finish, builds `RequestRecord` and enqueues it.
+ *
+ * @param config - RequestScope configuration object
+ * @param adapter - Optional storage adapter instance (for sharing with dashboard)
+ * @returns Express RequestHandler middleware
+ */
+function requestscope(config, adapter) {
+    // 1. Validate and apply defaults synchronously
+    (0, config_1.validateConfig)(config);
+    (0, config_1.applyDefaults)(config);
+    const sensitiveFields = (0, config_1.buildSensitiveFieldSet)(config);
+    // 2. Instantiate the appropriate storage adapter (if not provided)
+    if (!adapter) {
+        switch (config.storage.type) {
+            case 'mongodb':
+                adapter = new mongo_adapter_1.MongoAdapter(config.storage);
+                break;
+            case 'mysql':
+                adapter = new mysql_adapter_1.MySQLAdapter(config.storage);
+                break;
+            case 'postgresql':
+                adapter = new pg_adapter_1.PgAdapter(config.storage);
+                break;
+            default:
+                // This should never happen due to validateConfig, but TypeScript needs it
+                throw new Error(`Unsupported storage type: ${config.storage.type}`);
+        }
+    }
+    // 3. Initialize adapter asynchronously (log errors, don't throw)
+    void adapter.initialize().catch((err) => {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[RequestScope] Failed to initialize storage adapter: ${message}\n`);
+    });
+    // 4. Create and start AsyncQueue and RetentionScheduler
+    const queue = new queue_1.AsyncQueue(adapter);
+    const retentionDays = config.retentionDays ?? 30;
+    const retentionScheduler = new retention_1.RetentionScheduler(adapter, retentionDays);
+    retentionScheduler.start();
+    // 5. Attach graceful shutdown handlers
+    const shutdown = async () => {
+        retentionScheduler.stop();
+        await queue.drain(10000);
+        queue.destroy();
+    };
+    process.on('SIGTERM', () => {
+        void shutdown();
+    });
+    process.on('SIGINT', () => {
+        void shutdown();
+    });
+    // 6. Return the request handler middleware
+    return async (req, res, next) => {
+        // Check ignore list
+        const ignoreList = config.ignore ?? [];
+        const url = req.originalUrl || req.url || '/';
+        // Always ignore dashboard routes
+        if (url.startsWith('/requestscope')) {
+            next();
+            return;
+        }
+        if (ignoreList.some((pattern) => url === pattern || url.startsWith(pattern))) {
+            next();
+            return;
+        }
+        try {
+            // Buffer request body
+            const { body: requestBody, bodySize: requestBodySize, clientIp } = await (0, capture_1.bufferRequestBody)(req);
+            // Wrap response to capture response data
+            (0, capture_1.wrapResponse)(res, req, requestBody, requestBodySize, clientIp, sensitiveFields, (record) => queue.enqueue(record));
+        }
+        catch (err) {
+            // If capture fails, log and continue without disrupting the request
+            const message = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[RequestScope] Capture error: ${message}\n`);
+        }
+        next();
+    };
+}
+// ---------------------------------------------------------------------------
+// Setup function
+// ---------------------------------------------------------------------------
+/**
+ * Sets up RequestScope middleware and automatically mounts the dashboard at /requestscope.
+ *
+ * This function:
+ *   1. Creates the storage adapter
+ *   2. Sets up the request capture middleware
+ *   3. Automatically mounts the dashboard at /requestscope
+ *
+ * @param app - Express application instance
+ * @param config - RequestScope configuration object
+ */
+function setup(app, config) {
+    // Validate and apply defaults
+    (0, config_1.validateConfig)(config);
+    (0, config_1.applyDefaults)(config);
+    // Instantiate the appropriate storage adapter
+    let adapter;
+    switch (config.storage.type) {
+        case 'mongodb':
+            adapter = new mongo_adapter_1.MongoAdapter(config.storage);
+            break;
+        case 'mysql':
+            adapter = new mysql_adapter_1.MySQLAdapter(config.storage);
+            break;
+        case 'postgresql':
+            adapter = new pg_adapter_1.PgAdapter(config.storage);
+            break;
+        default:
+            throw new Error(`Unsupported storage type: ${config.storage.type}`);
+    }
+    // Initialize adapter asynchronously
+    void adapter.initialize().catch((err) => {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[RequestScope] Failed to initialize storage adapter: ${message}\n`);
+    });
+    // Set adapter on app for dashboard API to use
+    app.set('requestscopeAdapter', adapter);
+    // Use the middleware with the shared adapter
+    app.use(requestscope(config, adapter));
+    // Mount dashboard at /requestscope
+    app.use('/requestscope', (0, router_1.createDashboardRouter)(config.dashboard, adapter));
+}
+// ---------------------------------------------------------------------------
+// Error middleware
+// ---------------------------------------------------------------------------
+/**
+ * 4-arity error middleware that attaches error data to the request.
+ *
+ * The error data (message, stack, statusCode) is attached via a Symbol-keyed
+ * property so the response finish handler can include it in the RequestRecord.
+ *
+ * Usage:
+ *   app.use(requestscope(config));
+ *   app.use(errorHandler);
+ *   // ... route handlers that may throw
+ *
+ * @param err - Error object
+ * @param req - Express Request
+ * @param res - Express Response
+ * @param next - Express NextFunction
+ */
+function errorHandler(err, req, res, next) {
+    const errorData = {
+        message: err.message,
+        stack: err.stack || '',
+        statusCode: err.statusCode || 500,
+    };
+    req[capture_1.ERROR_DATA_SYMBOL] = errorData;
+    // Pass error to next error handler in the chain
+    next(err);
+}
+//# sourceMappingURL=middleware.js.map

package/dist/cjs/middleware.js.map

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

package/dist/cjs/queue.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * AsyncQueue — In-process batch write queue.
+ *
+ * Decouples the hot-path enqueue (synchronous, ≤1 ms) from database writes,
+ * which happen asynchronously in configurable batches. Fault isolation is
+ * total: adapter failures are caught, logged to stderr, and discarded so
+ * they never propagate to the caller.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsyncQueue = void 0;
+class AsyncQueue {
+    constructor(adapter, batchSize = 50, flushIntervalMs = 5000, maxCapacity = 10000) {
+        this.adapter = adapter;
+        this.batchSize = batchSize;
+        this.flushIntervalMs = flushIntervalMs;
+        this.maxCapacity = maxCapacity;
+        this.items = [];
+        this.flushTimer = null;
+        this.isFlushing = false;
+        // Start the periodic flush timer immediately on construction.
+        this.flushTimer = setInterval(() => {
+            void this.flush();
+        }, this.flushIntervalMs);
+        // Allow the Node.js process to exit even if this timer is still active.
+        if (this.flushTimer.unref) {
+            this.flushTimer.unref();
+        }
+    }
+    /**
+     * Synchronously adds a record to the queue.
+     *
+     * If the queue is at capacity, the record is discarded and a warning is
+     * written to stderr. If the queue has reached `batchSize` after this push,
+     * a flush is triggered immediately (fire-and-forget).
+     */
+    enqueue(record) {
+        if (this.items.length >= this.maxCapacity) {
+            process.stderr.write(`[RequestScope] Queue capacity exceeded (max ${this.maxCapacity}). ` +
+                `Record for ${record.method} ${record.url} discarded.\n`);
+            return;
+        }
+        this.items.push(record);
+        if (this.items.length >= this.batchSize) {
+            void this.flush();
+        }
+    }
+    /**
+     * Flushes up to `batchSize` items from the front of the queue.
+     *
+     * A guard (`isFlushing`) prevents concurrent flushes. The splice is
+     * performed atomically before the async adapter call so no records are
+     * lost even if the adapter rejects. On failure the batch is discarded
+     * and the error is written to stderr.
+     */
+    async flush() {
+        if (this.isFlushing || this.items.length === 0) {
+            return;
+        }
+        this.isFlushing = true;
+        // Atomically remove up to batchSize items from the front of the array.
+        const batch = this.items.splice(0, this.batchSize);
+        try {
+            await this.adapter.insert(batch);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[RequestScope] adapter.insert() failed — batch of ${batch.length} record(s) discarded. ` +
+                `Error: ${message}\n`);
+        }
+        finally {
+            this.isFlushing = false;
+        }
+    }
+    /**
+     * Flushes all remaining items in the queue, waiting at most `timeoutMs`
+     * milliseconds. Any items that could not be flushed before the timeout
+     * are logged to stderr.
+     *
+     * Used during graceful shutdown (SIGTERM / SIGINT).
+     */
+    async drain(timeoutMs = 10000) {
+        const deadline = Date.now() + timeoutMs;
+        while (this.items.length > 0) {
+            if (Date.now() >= deadline) {
+                const remaining = this.items.splice(0);
+                process.stderr.write(`[RequestScope] drain() timed out — ${remaining.length} record(s) could not be flushed:\n` +
+                    remaining
+                        .map((r) => `  ${r.method} ${r.url} @ ${r.timestamp}`)
+                        .join('\n') +
+                    '\n');
+                return;
+            }
+            // Wait for any in-progress flush to complete before starting the next.
+            if (this.isFlushing) {
+                await new Promise((resolve) => setTimeout(resolve, 10));
+                continue;
+            }
+            await this.flush();
+        }
+    }
+    /**
+     * Clears the periodic flush timer. Call this to allow the Node.js process
+     * to exit cleanly, or when the queue is no longer needed.
+     */
+    destroy() {
+        if (this.flushTimer !== null) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+    }
+}
+exports.AsyncQueue = AsyncQueue;
+//# sourceMappingURL=queue.js.map

package/dist/cjs/queue.js.map

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

package/dist/cjs/retention.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * RetentionScheduler — automatically purges records older than the configured
+ * retention window by calling `adapter.deleteOlderThan()` once per day.
+ *
+ * Requirements: 7.1, 7.2, 7.4, 7.5
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetentionScheduler = void 0;
+const TWENTY_FOUR_HOURS_MS = 24 * 60 * 60 * 1000; // 86_400_000 ms
+class RetentionScheduler {
+    constructor(adapter, retentionDays) {
+        this.adapter = adapter;
+        this.retentionDays = retentionDays;
+        this.intervalHandle = null;
+    }
+    /**
+     * Runs the retention job immediately, then schedules it to repeat every 24 h.
+     * Calling `start()` more than once has no additional effect until `stop()` is
+     * called first (the previous interval is replaced by the new one).
+     */
+    start() {
+        // Run an initial sweep right away so old records are not kept waiting up
+        // to 24 h after the server first starts.
+        void this.runOnce();
+        // Replace any previously-running interval.
+        if (this.intervalHandle !== null) {
+            clearInterval(this.intervalHandle);
+        }
+        this.intervalHandle = setInterval(() => {
+            void this.runOnce();
+        }, TWENTY_FOUR_HOURS_MS);
+    }
+    /**
+     * Stops the scheduled retention job.  Inflight `runOnce()` calls are allowed
+     * to complete naturally because they are fire-and-forget.
+     */
+    stop() {
+        if (this.intervalHandle !== null) {
+            clearInterval(this.intervalHandle);
+            this.intervalHandle = null;
+        }
+    }
+    /**
+     * Computes the cutoff date from `retentionDays` and asks the adapter to
+     * delete every record older than that date.  Any error is logged to `stderr`
+     * but never rethrown so the scheduler stays alive for the next tick.
+     */
+    async runOnce() {
+        const cutoff = new Date(Date.now() - this.retentionDays * 86400000);
+        try {
+            const deleted = await this.adapter.deleteOlderThan(cutoff);
+            if (deleted > 0) {
+                process.stderr.write(`[RequestScope] RetentionScheduler: deleted ${deleted} record(s) older than ${cutoff.toISOString()}\n`);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[RequestScope] RetentionScheduler error: ${message}\n`);
+        }
+    }
+}
+exports.RetentionScheduler = RetentionScheduler;
+//# sourceMappingURL=retention.js.map

package/dist/cjs/retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.js","sourceRoot":"","sources":["../../src/retention.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAIH,MAAM,oBAAoB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,gBAAgB;AAElE,MAAa,kBAAkB;IAG7B,YACmB,OAAuB,EACvB,aAAqB;QADrB,YAAO,GAAP,OAAO,CAAgB;QACvB,kBAAa,GAAb,aAAa,CAAQ;QAJhC,mBAAc,GAA0C,IAAI,CAAC;IAKlE,CAAC;IAEJ;;;;OAIG;IACH,KAAK;QACH,yEAAyE;QACzE,yCAAyC;QACzC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QAEpB,2CAA2C;QAC3C,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YACjC,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACrC,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;YACrC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QACtB,CAAC,EAAE,oBAAoB,CAAC,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YACjC,aAAa,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACnC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,OAAO;QACnB,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa,GAAG,QAAU,CAAC,CAAC;QACtE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;YAC3D,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8CAA8C,OAAO,yBAAyB,MAAM,CAAC,WAAW,EAAE,IAAI,CACvG,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4CAA4C,OAAO,IAAI,CACxD,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AA5DD,gDA4DC"}

package/dist/cjs/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * RequestScope — All exported TypeScript interfaces.
+ *
+ * This file is the single source of truth for every public type in the library.
+ * All interfaces are written to compile under `strict: true` with zero errors.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

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