request-scope-api 1.0.0

package/dist/cjs/capture.js

@@ -0,0 +1,310 @@
+"use strict";
+/**
+ * RequestScope — Capture layer, request and response sides.
+ *
+ * Provides:
+ *   - parseClientIp(req)    — extract client IP from headers/socket
+ *   - bufferRequestBody(req) — consume request stream, buffer ≤50 KB,
+ *                              attempt JSON / URL-encoded parse, return
+ *                              body string + original byte size + client IP.
+ *   - wrapResponse(res)     — monkey-patch res.write/res.end to accumulate
+ *                              response chunks, cap at 100 KB, return wrapper
+ *                              with finish event handler that builds RequestRecord.
+ *
+ * Uses Node.js built-ins only (no external deps).
+ * Compiles under strict: true.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERROR_DATA_SYMBOL = void 0;
+exports.parseClientIp = parseClientIp;
+exports.bufferRequestBody = bufferRequestBody;
+exports.wrapResponse = wrapResponse;
+const node_crypto_1 = require("node:crypto");
+const masker_1 = require("./masker");
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Maximum bytes to retain from a request body before truncation. */
+const MAX_BODY_BYTES = 50000;
+/** Maximum bytes to retain from a response body before truncation. */
+const MAX_RESPONSE_BODY_BYTES = 100000;
+/** Suffix appended to a body that was truncated. */
+const TRUNCATED_SUFFIX = '[truncated]';
+// ---------------------------------------------------------------------------
+// Client IP extraction
+// ---------------------------------------------------------------------------
+/**
+ * Extracts the client IP address from the request.
+ *
+ * Prefers the first entry of the `X-Forwarded-For` header (proxy-aware),
+ * falling back to `req.socket.remoteAddress`. Returns `"0.0.0.0"` when
+ * neither is available.
+ *
+ * @param req  Node.js IncomingMessage (or Express Request)
+ */
+function parseClientIp(req) {
+    const xff = req.headers['x-forwarded-for'];
+    if (xff) {
+        const raw = Array.isArray(xff) ? xff[0] : xff;
+        // X-Forwarded-For may be comma-separated: "client, proxy1, proxy2"
+        const first = raw.split(',')[0].trim();
+        if (first) {
+            return first;
+        }
+    }
+    return req.socket?.remoteAddress ?? '0.0.0.0';
+}
+// ---------------------------------------------------------------------------
+// URL-encoded body parsing helper
+// ---------------------------------------------------------------------------
+/**
+ * Attempts to parse `raw` as a URL-encoded query string.
+ *
+ * Returns a JSON string of the key-value pairs on success, or `null` when
+ * the string contains no parseable key-value pairs.
+ */
+function tryParseUrlEncoded(raw) {
+    // A URL-encoded body must contain at least one '=' (key=value separator).
+    // Without this guard, URLSearchParams treats any bare string as a key with
+    // an empty value, producing false positives for plain text / XML bodies.
+    if (!raw.includes('=')) {
+        return null;
+    }
+    try {
+        const params = new URLSearchParams(raw);
+        const obj = {};
+        params.forEach((value, key) => {
+            obj[key] = value;
+        });
+        // Only treat as URL-encoded if we got at least one key-value pair.
+        if (Object.keys(obj).length === 0) {
+            return null;
+        }
+        return JSON.stringify(obj);
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Request body buffering
+// ---------------------------------------------------------------------------
+/**
+ * Consumes the `req` stream and buffers up to {@link MAX_BODY_BYTES} bytes.
+ *
+ * Behaviour:
+ * 1. Collects `Buffer` chunks from `data` events; tracks total byte length.
+ * 2. On `end`: concatenates chunks, slices to MAX_BODY_BYTES; appends
+ *    `"[truncated]"` when the original size exceeded the limit.
+ * 3. Attempts `JSON.parse` → stores normalised JSON string.
+ * 4. On JSON failure, attempts `URLSearchParams` parse → stores JSON map.
+ * 5. On both failures, stores the raw string as-is.
+ * 6. On stream `error`, resolves with `{ body: '', bodySize: 0, clientIp }`.
+ *
+ * @param req  Node.js IncomingMessage (or Express Request)
+ * @returns    Resolved promise with body string, original byte size, and IP.
+ */
+async function bufferRequestBody(req) {
+    const clientIp = parseClientIp(req);
+    return new Promise((resolve) => {
+        const chunks = [];
+        let totalBytes = 0;
+        req.on('data', (chunk) => {
+            const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+            totalBytes += buf.byteLength;
+            chunks.push(buf);
+        });
+        req.on('end', () => {
+            // Concatenate all chunks into one buffer, then slice to the limit.
+            const full = Buffer.concat(chunks);
+            const truncated = totalBytes > MAX_BODY_BYTES;
+            const kept = truncated ? full.subarray(0, MAX_BODY_BYTES) : full;
+            let rawString = kept.toString('utf8');
+            if (truncated) {
+                rawString += TRUNCATED_SUFFIX;
+            }
+            // Try JSON first.
+            try {
+                const parsed = JSON.parse(rawString.replace(TRUNCATED_SUFFIX, ''));
+                // Store as normalised JSON string (handles whitespace variation).
+                const base = JSON.stringify(parsed);
+                resolve({
+                    body: truncated ? base + TRUNCATED_SUFFIX : base,
+                    bodySize: totalBytes,
+                    clientIp,
+                });
+                return;
+            }
+            catch {
+                // JSON parse failed — try URL-encoded next (only on untruncated or
+                // the raw portion; URLSearchParams on a truncated string may be
+                // structurally invalid, but we try on the raw slice).
+            }
+            // Try URL-encoded.
+            const rawForUrlParse = truncated
+                ? full.subarray(0, MAX_BODY_BYTES).toString('utf8')
+                : rawString;
+            const urlEncoded = tryParseUrlEncoded(rawForUrlParse);
+            if (urlEncoded !== null) {
+                resolve({
+                    body: truncated ? urlEncoded + TRUNCATED_SUFFIX : urlEncoded,
+                    bodySize: totalBytes,
+                    clientIp,
+                });
+                return;
+            }
+            // Fall back to raw string (possibly truncated).
+            resolve({ body: rawString, bodySize: totalBytes, clientIp });
+        });
+        req.on('error', () => {
+            resolve({ body: '', bodySize: 0, clientIp });
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Response body wrapping
+// ---------------------------------------------------------------------------
+/**
+ * Symbol used to attach error data to the request object for the finish handler.
+ */
+exports.ERROR_DATA_SYMBOL = Symbol('requestscope_error_data');
+/**
+ * Wraps a ServerResponse to accumulate response chunks.
+ *
+ * Monkey-patches `res.write` and `res.end` to accumulate response body chunks.
+ * Caps the buffer at MAX_RESPONSE_BODY_BYTES; beyond that stores first
+ * MAX_RESPONSE_BODY_BYTES bytes + "[truncated]". Records responseBodySize as
+ * the original Content-Length or accumulated size.
+ *
+ * On the `finish` event, builds a RequestRecord with:
+ * - UUIDv4 id
+ * - process.hrtime-based responseTime
+ * - maskObject() applied to request headers and request body
+ * - maskObject() applied to response headers
+ * - Enqueues the record synchronously via the provided callback
+ *
+ * If wrapping fails (stream/binary response), sets responseBody = "",
+ * reads Content-Length header as responseBodySize, and calls original write/end
+ * without disrupting the response.
+ *
+ * @param res - Node.js ServerResponse (or Express Response)
+ * @param req - Node.js IncomingMessage (or Express Request)
+ * @param requestBody - Buffered request body string
+ * @param requestBodySize - Original request body byte size
+ * @param clientIp - Client IP address
+ * @param sensitiveFields - Set of sensitive field names to mask
+ * @param enqueueRecord - Callback to enqueue the RequestRecord synchronously
+ * @returns The wrapped response (same object, with patched methods)
+ */
+function wrapResponse(res, req, requestBody, requestBodySize, clientIp, sensitiveFields, enqueueRecord) {
+    const chunks = [];
+    let totalBytes = 0;
+    const startTime = process.hrtime.bigint();
+    // Store original methods
+    const originalWrite = res.write;
+    const originalEnd = res.end;
+    // Helper to accumulate chunks
+    const accumulateChunk = (chunk, encoding) => {
+        try {
+            const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk, encoding);
+            totalBytes += buf.byteLength;
+            if (totalBytes <= MAX_RESPONSE_BODY_BYTES) {
+                chunks.push(buf);
+            }
+        }
+        catch (err) {
+            // Ignore accumulation errors
+        }
+    };
+    // Patch res.write
+    res.write = function (chunk, encoding, cb) {
+        accumulateChunk(chunk, encoding);
+        return originalWrite.call(this, chunk, encoding, cb);
+    };
+    // Patch res.end
+    res.end = function (chunk, encoding, cb) {
+        if (chunk !== undefined) {
+            accumulateChunk(chunk, encoding);
+        }
+        originalEnd.call(this, chunk, encoding, cb);
+    };
+    // Patch Express-specific methods that might bypass res.write/res.end
+    const expressRes = res;
+    if (expressRes.send) {
+        const originalSend = expressRes.send;
+        expressRes.send = function (body) {
+            // Capture the body before sending
+            if (body !== undefined) {
+                const str = typeof body === 'string' ? body : JSON.stringify(body);
+                accumulateChunk(str, 'utf8');
+            }
+            return originalSend.call(this, body);
+        };
+    }
+    if (expressRes.json) {
+        const originalJson = expressRes.json;
+        expressRes.json = function (obj) {
+            const str = JSON.stringify(obj);
+            accumulateChunk(str, 'utf8');
+            return originalJson.call(this, obj);
+        };
+    }
+    // Listen for finish event to build the record
+    res.on('finish', () => {
+        const endTime = process.hrtime.bigint();
+        const responseTime = Number(endTime - startTime) / 1000000; // Convert to milliseconds
+        // Build response body
+        let responseBody = '';
+        let responseBodySize = totalBytes;
+        if (chunks.length > 0) {
+            const full = Buffer.concat(chunks);
+            const truncated = totalBytes > MAX_RESPONSE_BODY_BYTES;
+            const kept = truncated ? full.subarray(0, MAX_RESPONSE_BODY_BYTES) : full;
+            responseBody = kept.toString('utf8');
+            if (truncated) {
+                responseBody += TRUNCATED_SUFFIX;
+            }
+        }
+        else {
+            // No chunks accumulated - try to get size from Content-Length header
+            const contentLength = res.getHeader('Content-Length');
+            if (typeof contentLength === 'number') {
+                responseBodySize = contentLength;
+            }
+            else if (typeof contentLength === 'string') {
+                responseBodySize = parseInt(contentLength, 10) || 0;
+            }
+            // Log when no chunks are accumulated for debugging
+            process.stderr.write(`[RequestScope] No response chunks accumulated for ${req.method} ${req.url}\n`);
+        }
+        // Get error data from request if present
+        const errorData = req[exports.ERROR_DATA_SYMBOL];
+        // Build request record
+        const record = {
+            id: (0, node_crypto_1.randomUUID)(),
+            method: req.method || 'GET',
+            url: req.url || '/',
+            route: null, // Will be set by Express if available
+            queryParams: {}, // Will be populated by Express
+            pathParams: {}, // Will be populated by Express
+            requestHeaders: (0, masker_1.maskObject)(Object.fromEntries(Object.entries(req.headers).map(([k, v]) => [k, Array.isArray(v) ? v[0] : v ?? ''])), sensitiveFields),
+            requestBody,
+            requestBodySize,
+            clientIp,
+            userAgent: req.headers['user-agent'] || '',
+            statusCode: res.statusCode,
+            responseHeaders: (0, masker_1.maskObject)(Object.fromEntries(Object.entries(res.getHeaders()).map(([k, v]) => [k, Array.isArray(v) ? v[0] : v ?? ''])), sensitiveFields),
+            responseBody,
+            responseBodySize,
+            responseTime,
+            errorMessage: errorData?.message ?? null,
+            errorStack: errorData?.stack ?? null,
+            errorStatusCode: errorData?.statusCode ?? null,
+            timestamp: new Date().toISOString(),
+        };
+        // Enqueue the record synchronously
+        enqueueRecord(record);
+    });
+    return res;
+}
+//# sourceMappingURL=capture.js.map

package/dist/cjs/capture.js.map

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

package/dist/cjs/config.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * RequestScope — Configuration validation, defaults, and sensitive-field set.
+ *
+ * All validation errors are thrown synchronously so that `requestscope()` fails
+ * fast at startup before any middleware is registered.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyDefaults = applyDefaults;
+exports.validateConfig = validateConfig;
+exports.buildSensitiveFieldSet = buildSensitiveFieldSet;
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const SUPPORTED_STORAGE_TYPES = ['mongodb', 'mysql', 'postgresql'];
+const SQL_REQUIRED_FIELDS = [
+    'host',
+    'database',
+    'username',
+    'password',
+];
+/** Built-in sensitive field names (all compared case-insensitively). */
+const DEFAULT_SENSITIVE_FIELDS = [
+    'password',
+    'token',
+    'authorization',
+    'apiKey',
+    'secret',
+];
+// ---------------------------------------------------------------------------
+// applyDefaults
+// ---------------------------------------------------------------------------
+/**
+ * Fills in missing optional fields with their documented default values.
+ * Mutates the config object in place and returns it for chaining.
+ *
+ * Defaults applied:
+ *   retentionDays  → 30
+ *   ignore         → []
+ *   maskFields     → []
+ *   storage.poolSize → 5
+ *   storage.ssl    → false
+ */
+function applyDefaults(config) {
+    if (config.retentionDays === undefined) {
+        config.retentionDays = 30;
+    }
+    if (config.ignore === undefined) {
+        config.ignore = ['/requestscope/api', '/requestscope/assets'];
+    }
+    if (config.maskFields === undefined) {
+        config.maskFields = [];
+    }
+    if (config.storage.poolSize === undefined) {
+        config.storage.poolSize = 5;
+    }
+    if (config.storage.ssl === undefined) {
+        config.storage.ssl = false;
+    }
+    return config;
+}
+// ---------------------------------------------------------------------------
+// validateConfig
+// ---------------------------------------------------------------------------
+/**
+ * Validates the configuration object and throws a synchronous `Error` for
+ * any invalid value.
+ *
+ * Checks (in order):
+ *   1. `storage.type` must be one of the supported values.
+ *   2. MongoDB requires `storage.uri`.
+ *   3. MySQL / PostgreSQL require `host`, `database`, `username`, `password`.
+ *   4. `retentionDays` (when provided) must be a positive integer in [1, 365].
+ */
+function validateConfig(config) {
+    const { storage, retentionDays } = config;
+    // 1. Validate storage.type
+    if (!SUPPORTED_STORAGE_TYPES.includes(storage.type)) {
+        throw new Error(`Invalid storage type: '${storage.type}'. Supported values are: mongodb, mysql, postgresql`);
+    }
+    // 2. MongoDB: uri is required
+    if (storage.type === 'mongodb') {
+        if (!storage.uri) {
+            throw new Error("storage.uri is required when storage.type is 'mongodb'");
+        }
+    }
+    // 3. MySQL / PostgreSQL: all SQL required fields must be present
+    if (storage.type === 'mysql' || storage.type === 'postgresql') {
+        const missing = SQL_REQUIRED_FIELDS.filter((field) => storage[field] === undefined || storage[field] === null);
+        if (missing.length > 0) {
+            throw new Error(`Missing required storage fields: ${missing.join(', ')}`);
+        }
+    }
+    // 4. retentionDays: must be a positive integer in [1, 365] when provided
+    if (retentionDays !== undefined) {
+        const isValidInteger = typeof retentionDays === 'number' &&
+            Number.isInteger(retentionDays) &&
+            retentionDays >= 1 &&
+            retentionDays <= 365;
+        if (!isValidInteger) {
+            throw new Error(`retentionDays must be a positive integer between 1 and 365, received: ${retentionDays}`);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// buildSensitiveFieldSet
+// ---------------------------------------------------------------------------
+/**
+ * Constructs the `Set<string>` of sensitive field names by forming the union
+ * of the built-in defaults and any user-supplied `maskFields`.
+ *
+ * All names are lowercased so that lookups from `maskObject()` can compare
+ * case-insensitively by lowercasing the inspected key.
+ */
+function buildSensitiveFieldSet(config) {
+    const names = [
+        ...DEFAULT_SENSITIVE_FIELDS,
+        ...(config.maskFields ?? []),
+    ];
+    return new Set(names.map((n) => n.toLowerCase()));
+}
+//# sourceMappingURL=config.js.map

package/dist/cjs/config.js.map

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

package/dist/cjs/dashboard/api.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * RequestScope — Dashboard API handlers.
+ *
+ * Provides Express route handlers for the dashboard:
+ *   - GET /api/records — List records with filtering, sorting, and pagination
+ *   - GET /api/records/:id — Get a single record by ID
+ *
+ * Requirements: 9.1, 9.2, 9.3, 9.4, 9.5, 9.6
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRecords = getRecords;
+exports.getRecordById = getRecordById;
+exports.deleteAllRecords = deleteAllRecords;
+// ---------------------------------------------------------------------------
+// Helper functions
+// ---------------------------------------------------------------------------
+/**
+ * Parses a query parameter as an integer with a default value.
+ */
+function parseIntParam(value, defaultValue, min = 1) {
+    if (value === undefined) {
+        return defaultValue;
+    }
+    const parsed = parseInt(value, 10);
+    if (isNaN(parsed) || parsed < min) {
+        return defaultValue;
+    }
+    return parsed;
+}
+/**
+ * Validates that a value is one of the allowed options.
+ */
+function validateOption(value, allowed, defaultValue) {
+    if (value === undefined) {
+        return defaultValue;
+    }
+    return allowed.includes(value) ? value : defaultValue;
+}
+// ---------------------------------------------------------------------------
+// Route handlers
+// ---------------------------------------------------------------------------
+/**
+ * GET /api/records handler.
+ *
+ * Query parameters:
+ *   - search: string (optional) — case-insensitive substring match on url
+ *   - startDate: string (optional) — ISO 8601 timestamp, inclusive lower bound
+ *   - endDate: string (optional) — ISO 8601 timestamp, inclusive upper bound
+ *   - statusCodeGroup: string (optional) — '2xx', '3xx', '4xx', or '5xx'
+ *   - statusCode: number (optional) — exact status code match
+ *   - method: string (optional) — exact HTTP method match (case-insensitive)
+ *   - sortBy: string (optional) — 'timestamp', 'responseTime', or 'statusCode'
+ *   - sortOrder: string (optional) — 'asc' or 'desc'
+ *   - page: number (optional) — page number, default 1
+ *   - pageSize: number (optional) — page size, default 25
+ *
+ * Returns:
+ *   - 200 with { records: RequestRecord[], total: number }
+ *   - 400 for malformed query parameters
+ */
+async function getRecords(req, res) {
+    try {
+        const adapter = req.app.get('requestscopeAdapter');
+        if (!adapter) {
+            res.status(500).json({ error: 'Storage adapter not configured' });
+            return;
+        }
+        // Parse and validate query parameters
+        const page = parseIntParam(req.query.page, 1);
+        const pageSize = parseIntParam(req.query.pageSize, 25);
+        const sortBy = validateOption(req.query.sortBy, ['timestamp', 'responseTime', 'statusCode'], 'timestamp');
+        const sortOrder = validateOption(req.query.sortOrder, ['asc', 'desc'], 'desc');
+        // Build QueryFilters
+        const filters = {
+            search: req.query.search,
+            startDate: req.query.startDate,
+            endDate: req.query.endDate,
+            statusCodeGroup: (() => {
+                const value = req.query.statusCodeGroup;
+                if (!value)
+                    return undefined;
+                if (['2xx', '3xx', '4xx', '5xx'].includes(value)) {
+                    return value;
+                }
+                return undefined;
+            })(),
+            statusCode: req.query.statusCode
+                ? parseIntParam(req.query.statusCode, 0)
+                : undefined,
+            method: req.query.method,
+            sortBy,
+            sortOrder,
+            page,
+            pageSize,
+        };
+        // Query the adapter
+        const result = await adapter.query(filters, { page, pageSize });
+        res.status(200).json(result);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        res.status(400).json({ error: message });
+    }
+}
+/**
+ * GET /api/records/:id handler.
+ *
+ * Returns:
+ *   - 200 with the RequestRecord
+ *   - 404 if the record is not found
+ *   - 400 for malformed ID
+ */
+async function getRecordById(req, res) {
+    try {
+        const adapter = req.app.get('requestscopeAdapter');
+        if (!adapter) {
+            res.status(500).json({ error: 'Storage adapter not configured' });
+            return;
+        }
+        const id = req.params.id;
+        if (!id) {
+            res.status(400).json({ error: 'Record ID is required' });
+            return;
+        }
+        // Query for the specific record using id filter
+        const filters = {
+            id,
+            page: 1,
+            pageSize: 1,
+        };
+        const result = await adapter.query(filters, { page: 1, pageSize: 1 });
+        const record = result.records[0];
+        if (!record) {
+            res.status(404).json({ error: 'Record not found' });
+            return;
+        }
+        res.status(200).json(record);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        res.status(400).json({ error: message });
+    }
+}
+/**
+ * DELETE /api/records handler.
+ *
+ * Deletes all records from the database.
+ *
+ * Returns:
+ *   - 200 with { deleted: number }
+ *   - 500 for server errors
+ */
+async function deleteAllRecords(req, res) {
+    try {
+        const adapter = req.app.get('requestscopeAdapter');
+        if (!adapter) {
+            res.status(500).json({ error: 'Storage adapter not configured' });
+            return;
+        }
+        // Query to get total count before deletion
+        const allRecords = await adapter.query({ page: 1, pageSize: 1000000 }, { page: 1, pageSize: 1000000 });
+        const totalToDelete = allRecords.total;
+        // Delete all records by setting retention to a future date
+        await adapter.deleteOlderThan(new Date(Date.now() + 86400000));
+        res.status(200).json({ deleted: totalToDelete });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        res.status(500).json({ error: message });
+    }
+}
+//# sourceMappingURL=api.js.map

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

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