api-sentinel-express 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../src/config/defaults.js", "../src/core/percentile.js", "../src/core/metrics-collector.js", "../src/core/route-normalizer.js", "../src/core/request-tracker.js", "../src/utils/request-id.js", "../src/middleware/create-middleware.js", "../src/utils/sanitizer.js", "../src/middleware/error-handler.js", "../src/utils/logger.js", "../src/utils/validation.js", "../src/index.js"],
4
+ "sourcesContent": ["/**\n * Default configuration constants and validation bounds for API Sentinel.\n */\nexport const DEFAULT_CONFIG = Object.freeze({\n slowRequestThresholdMs: 500,\n maxRecentRequests: 200,\n maxRouteEntries: 100,\n windowSampleSize: 1000,\n requestIdHeader: 'X-Request-ID',\n trustIncomingRequestId: false,\n fallbackRouteLabel: '/__overflow_routes__',\n unmatchedRouteLabel: '/__unmatched__',\n logging: Object.freeze({\n enabled: true,\n logAllRequests: false,\n logSlowRequests: true,\n logServerErrors: true,\n logClientErrors: false,\n }),\n});\n\nexport const CONFIG_BOUNDS = Object.freeze({\n slowRequestThresholdMs: { min: 1, max: 3_600_000 },\n maxRecentRequests: { min: 1, max: 50_000 },\n maxRouteEntries: { min: 2, max: 10_000 },\n windowSampleSize: { min: 10, max: 50_000 },\n});\n", "/**\n * Rounds a floating-point duration value to 2 decimal places.\n *\n * @param {number} value - Duration in milliseconds.\n * @returns {number} Rounded duration (>= 0).\n */\nexport function roundDuration(value) {\n if (!Number.isFinite(value) || value <= 0) {\n return 0;\n }\n return Math.round(value * 100) / 100;\n}\n\n/**\n * Computes the given percentile (e.g. 95 for P95) over an array of numeric latency samples\n * using the standard nearest-rank method:\n *\n * rank = ceil((P / 100) * N)\n * value = sorted[rank - 1]\n *\n * Returns `0` when the sample array is empty.\n *\n * @param {number[]} samples - Array of latency samples in milliseconds.\n * @param {number} [percentile=95] - Target percentile in range (0, 100].\n * @returns {number} Calculated percentile value rounded to 2 decimal places.\n */\nexport function calculatePercentile(samples, percentile = 95) {\n if (\n typeof percentile !== 'number' ||\n percentile <= 0 ||\n percentile > 100 ||\n !Number.isFinite(percentile)\n ) {\n throw new RangeError(\n `Invalid percentile \"${percentile}\": must be a number in the range (0, 100].`\n );\n }\n\n if (!Array.isArray(samples) || samples.length === 0) {\n return 0;\n }\n\n const count = samples.length;\n if (count === 1) {\n return roundDuration(samples[0] ?? 0);\n }\n\n const sorted = [...samples].sort((a, b) => a - b);\n const rankIndex = Math.min(\n sorted.length - 1,\n Math.max(0, Math.ceil((percentile / 100) * count) - 1)\n );\n\n return roundDuration(sorted[rankIndex] ?? 0);\n}\n\n/**\n * Fixed-capacity circular ring buffer for bounded-memory rolling percentile calculations.\n *\n * Insertion is O(1) and uses a pre-allocated Float64Array so long-running Node.js processes\n * never suffer from unbounded array allocations or memory leaks.\n */\nexport class RollingWindowSampler {\n /**\n * @param {number} [capacity=1000] - Maximum number of samples retained in the rolling window.\n */\n constructor(capacity = 1000) {\n if (!Number.isInteger(capacity) || capacity < 1) {\n throw new RangeError('RollingWindowSampler capacity must be a positive integer.');\n }\n this.capacity = capacity;\n this.buffer = new Float64Array(capacity);\n this.writeIndex = 0;\n this.currentSize = 0;\n }\n\n /**\n * Adds a new latency sample (in milliseconds) to the rolling window in O(1) time.\n *\n * @param {number} durationMs - Observed latency in milliseconds.\n */\n add(durationMs) {\n if (typeof durationMs !== 'number' || !Number.isFinite(durationMs) || durationMs < 0) {\n return;\n }\n this.buffer[this.writeIndex] = durationMs;\n this.writeIndex = (this.writeIndex + 1) % this.capacity;\n if (this.currentSize < this.capacity) {\n this.currentSize += 1;\n }\n }\n\n /**\n * Returns the current number of active samples in the rolling window (0 <= size <= capacity).\n *\n * @returns {number} Active sample count.\n */\n size() {\n return this.currentSize;\n }\n\n /**\n * Extracts a copy of the active samples currently stored in the ring buffer.\n *\n * @returns {number[]} Detached array of active latency samples.\n */\n getSamples() {\n const result = new Array(this.currentSize);\n for (let i = 0; i < this.currentSize; i += 1) {\n result[i] = this.buffer[i] ?? 0;\n }\n return result;\n }\n\n /**\n * Computes the target percentile (defaults to 95th percentile) over the current rolling window.\n *\n * @param {number} [percentile=95] - Target percentile (0, 100].\n * @returns {number} Percentile latency in milliseconds.\n */\n getPercentile(percentile = 95) {\n if (this.currentSize === 0) {\n return 0;\n }\n return calculatePercentile(this.getSamples(), percentile);\n }\n\n /**\n * Clears all samples in the rolling window.\n */\n reset() {\n this.writeIndex = 0;\n this.currentSize = 0;\n this.buffer.fill(0);\n }\n}\n", "import { RollingWindowSampler, roundDuration } from './percentile.js';\n\n/**\n * Bounded, in-memory metrics aggregator for API Sentinel.\n *\n * Designed for deterministic memory consumption:\n * - Recent request history is stored in a fixed-size circular ring buffer (`maxRecentRequests`).\n * - Endpoint analytics are capped at `maxRouteEntries` with automatic overflow aggregation.\n * - Latency percentiles use fixed-size `Float64Array` ring buffers (`windowSampleSize`).\n * - All public read methods return detached deep copies so callers can never mutate internal state.\n */\nexport class MetricsCollector {\n /**\n * @param {object} config - Resolved API Sentinel configuration.\n */\n constructor(config) {\n this.config = config;\n this.startedAt = new Date();\n this.totalRequests = 0;\n this.informationalRequests = 0;\n this.successfulRequests = 0;\n this.redirectRequests = 0;\n this.notModifiedRequests = 0;\n this.clientErrorRequests = 0;\n this.serverErrorRequests = 0;\n this.notFoundRequests = 0;\n this.unmatchedRouteRequests = 0;\n this.slowRequests = 0;\n this.abortedRequests = 0;\n this.cardinalityOverflowCount = 0;\n\n this.totalDurationMs = 0;\n this.minDurationMs = Number.POSITIVE_INFINITY;\n this.maxDurationMs = 0;\n this.globalLatencySampler = new RollingWindowSampler(config.windowSampleSize);\n\n this.statusDistribution = {\n '1xx': 0,\n '2xx': 0,\n '3xx': 0,\n '4xx': 0,\n '5xx': 0,\n };\n this.statusCodeCounts = new Map();\n this.endpoints = new Map();\n this.recentRequestsBuffer = new Array(config.maxRecentRequests);\n this.recentWriteIndex = 0;\n this.recentCount = 0;\n }\n\n /**\n * Records a completed HTTP request into global counters, recent request history,\n * and per-endpoint analytics.\n *\n * @param {object} record - Completed request telemetry record.\n */\n recordRequest(record) {\n const duration = roundDuration(record.durationMs);\n const status = record.statusCode;\n\n this.totalRequests += 1;\n this.totalDurationMs += duration;\n\n if (duration < this.minDurationMs) {\n this.minDurationMs = duration;\n }\n if (duration > this.maxDurationMs) {\n this.maxDurationMs = duration;\n }\n this.globalLatencySampler.add(duration);\n\n if (record.isSlow) {\n this.slowRequests += 1;\n }\n if (record.isUnmatchedRoute) {\n this.unmatchedRouteRequests += 1;\n }\n if (record.aborted) {\n this.abortedRequests += 1;\n }\n\n const statusKey = String(status);\n this.statusCodeCounts.set(statusKey, (this.statusCodeCounts.get(statusKey) ?? 0) + 1);\n\n if (status === 404) {\n this.notFoundRequests += 1;\n }\n\n if (status >= 500) {\n this.serverErrorRequests += 1;\n this.statusDistribution['5xx'] += 1;\n } else if (status >= 400) {\n this.clientErrorRequests += 1;\n this.statusDistribution['4xx'] += 1;\n } else if (status >= 300) {\n if (status === 304) {\n this.notModifiedRequests += 1;\n } else {\n this.redirectRequests += 1;\n }\n this.statusDistribution['3xx'] += 1;\n } else if (status >= 200) {\n this.successfulRequests += 1;\n this.statusDistribution['2xx'] += 1;\n } else {\n this.informationalRequests += 1;\n this.statusDistribution['1xx'] += 1;\n }\n\n this.appendRecentRequest(record);\n this.recordEndpointMetrics(record, duration);\n }\n\n /**\n * Appends a cloned request record to the bounded circular buffer.\n *\n * @param {object} record - Completed request record.\n */\n appendRecentRequest(record) {\n const clonedRecord = {\n requestId: record.requestId,\n timestamp: record.timestamp,\n method: record.method,\n route: record.route,\n statusCode: record.statusCode,\n durationMs: roundDuration(record.durationMs),\n isSlow: Boolean(record.isSlow),\n outcome: record.outcome,\n isUnmatchedRoute: Boolean(record.isUnmatchedRoute),\n aborted: Boolean(record.aborted),\n };\n\n if (record.errorName !== undefined) {\n clonedRecord.errorName = record.errorName;\n }\n if (record.errorCode !== undefined) {\n clonedRecord.errorCode = record.errorCode;\n }\n\n this.recentRequestsBuffer[this.recentWriteIndex] = clonedRecord;\n this.recentWriteIndex = (this.recentWriteIndex + 1) % this.config.maxRecentRequests;\n if (this.recentCount < this.config.maxRecentRequests) {\n this.recentCount += 1;\n }\n }\n\n /**\n * Updates per-endpoint metrics while strictly enforcing `maxRouteEntries`.\n *\n * @param {object} record - Completed request record.\n * @param {number} duration - Rounded duration in milliseconds.\n */\n recordEndpointMetrics(record, duration) {\n const method = record.method.toUpperCase();\n const route = record.route;\n const endpointKey = `${method} ${route}`;\n const overflowKey = `ALL ${this.config.fallbackRouteLabel}`;\n\n let state = this.endpoints.get(endpointKey);\n\n if (!state) {\n if (this.endpoints.size < this.config.maxRouteEntries) {\n state = this.createEmptyEndpointState(endpointKey, method, route, record.timestamp, false);\n this.endpoints.set(endpointKey, state);\n } else {\n this.cardinalityOverflowCount += 1;\n state = this.getOrCreateOverflowBucket(overflowKey, record.timestamp);\n }\n }\n\n this.applyRequestToEndpointState(state, record, duration);\n }\n\n /**\n * Obtains or creates the overflow bucket when `maxRouteEntries` is reached.\n * If all `maxRouteEntries` slots are currently occupied by normal routes, the least-frequently\n * hit normal route is merged into the new overflow bucket so total entries never exceed `maxRouteEntries`.\n *\n * @param {string} overflowKey - Canonical key for the overflow bucket.\n * @param {string} timestamp - ISO timestamp.\n * @returns {object} Mutable overflow endpoint state.\n */\n getOrCreateOverflowBucket(overflowKey, timestamp) {\n const existingOverflow = this.endpoints.get(overflowKey);\n if (existingOverflow) {\n return existingOverflow;\n }\n\n const overflowState = this.createEmptyEndpointState(\n overflowKey,\n 'ALL',\n this.config.fallbackRouteLabel,\n timestamp,\n true\n );\n\n if (this.endpoints.size >= this.config.maxRouteEntries) {\n let victimKey;\n let victimState;\n\n for (const [key, candidate] of this.endpoints.entries()) {\n if (candidate.isOverflowBucket) {\n continue;\n }\n if (!victimState || candidate.requestCount < victimState.requestCount) {\n victimKey = key;\n victimState = candidate;\n }\n }\n\n if (victimKey && victimState) {\n this.endpoints.delete(victimKey);\n this.mergeEndpointState(overflowState, victimState);\n }\n }\n\n this.endpoints.set(overflowKey, overflowState);\n return overflowState;\n }\n\n createEmptyEndpointState(key, method, route, timestamp, isOverflowBucket) {\n return {\n key,\n method,\n route,\n requestCount: 0,\n informationalCount: 0,\n successCount: 0,\n redirectCount: 0,\n notModifiedCount: 0,\n errorCount: 0,\n clientErrorCount: 0,\n serverErrorCount: 0,\n slowRequestCount: 0,\n totalDurationMs: 0,\n minDurationMs: Number.POSITIVE_INFINITY,\n maxDurationMs: 0,\n sampler: new RollingWindowSampler(this.config.windowSampleSize),\n lastSeenAt: timestamp,\n isOverflowBucket,\n };\n }\n\n mergeEndpointState(target, source) {\n target.requestCount += source.requestCount;\n target.informationalCount += source.informationalCount;\n target.successCount += source.successCount;\n target.redirectCount += source.redirectCount;\n target.notModifiedCount += source.notModifiedCount;\n target.errorCount += source.errorCount;\n target.clientErrorCount += source.clientErrorCount;\n target.serverErrorCount += source.serverErrorCount;\n target.slowRequestCount += source.slowRequestCount;\n target.totalDurationMs += source.totalDurationMs;\n\n if (source.minDurationMs < target.minDurationMs) {\n target.minDurationMs = source.minDurationMs;\n }\n if (source.maxDurationMs > target.maxDurationMs) {\n target.maxDurationMs = source.maxDurationMs;\n }\n for (const sample of source.sampler.getSamples()) {\n target.sampler.add(sample);\n }\n if (source.lastSeenAt > target.lastSeenAt) {\n target.lastSeenAt = source.lastSeenAt;\n }\n }\n\n applyRequestToEndpointState(state, record, duration) {\n state.requestCount += 1;\n state.totalDurationMs += duration;\n if (duration < state.minDurationMs) {\n state.minDurationMs = duration;\n }\n if (duration > state.maxDurationMs) {\n state.maxDurationMs = duration;\n }\n state.sampler.add(duration);\n state.lastSeenAt = record.timestamp;\n\n if (record.isSlow) {\n state.slowRequestCount += 1;\n }\n\n if (record.statusCode >= 500) {\n state.serverErrorCount += 1;\n state.errorCount += 1;\n } else if (record.statusCode >= 400) {\n state.clientErrorCount += 1;\n state.errorCount += 1;\n } else if (record.statusCode >= 300) {\n if (record.statusCode === 304) {\n state.notModifiedCount += 1;\n } else {\n state.redirectCount += 1;\n }\n } else if (record.statusCode >= 200) {\n state.successCount += 1;\n } else {\n state.informationalCount += 1;\n }\n }\n\n /**\n * Returns a detached array of per-endpoint analytics sorted by request volume.\n *\n * @returns {object[]} Detached list of endpoint metric objects.\n */\n getEndpointMetrics() {\n const endpointsList = [];\n\n for (const state of this.endpoints.values()) {\n const epAvg =\n state.requestCount > 0 ? roundDuration(state.totalDurationMs / state.requestCount) : 0;\n const epMin =\n state.requestCount > 0 && Number.isFinite(state.minDurationMs) ? state.minDurationMs : 0;\n const epMax = state.requestCount > 0 ? state.maxDurationMs : 0;\n\n endpointsList.push({\n key: state.key,\n method: state.method,\n route: state.route,\n requestCount: state.requestCount,\n informationalCount: state.informationalCount,\n successCount: state.successCount,\n redirectCount: state.redirectCount,\n notModifiedCount: state.notModifiedCount,\n errorCount: state.errorCount,\n clientErrorCount: state.clientErrorCount,\n serverErrorCount: state.serverErrorCount,\n slowRequestCount: state.slowRequestCount,\n avgDurationMs: epAvg,\n minDurationMs: epMin,\n maxDurationMs: epMax,\n p95DurationMs: state.sampler.getPercentile(95),\n lastSeenAt: state.lastSeenAt,\n isOverflowBucket: state.isOverflowBucket,\n });\n }\n\n endpointsList.sort((a, b) => {\n if (a.isOverflowBucket !== b.isOverflowBucket) {\n return a.isOverflowBucket ? 1 : -1;\n }\n return b.requestCount - a.requestCount || b.p95DurationMs - a.p95DurationMs;\n });\n\n return endpointsList;\n }\n\n /**\n * Produces a detached, deeply cloned snapshot of all collected metrics.\n *\n * @returns {object} Detached metrics snapshot.\n */\n getMetrics() {\n const now = new Date();\n const uptimeSeconds = Math.max(\n 0,\n roundDuration((now.getTime() - this.startedAt.getTime()) / 1000)\n );\n\n const hasRequests = this.totalRequests > 0;\n const totalErrors = this.clientErrorRequests + this.serverErrorRequests;\n const errorRate = hasRequests ? roundDuration((totalErrors / this.totalRequests) * 100) : 0;\n const slowRequestRate = hasRequests\n ? roundDuration((this.slowRequests / this.totalRequests) * 100)\n : 0;\n\n const avgMs = hasRequests ? roundDuration(this.totalDurationMs / this.totalRequests) : 0;\n const minMs = hasRequests && Number.isFinite(this.minDurationMs) ? this.minDurationMs : 0;\n const maxMs = hasRequests ? this.maxDurationMs : 0;\n const p95Ms = hasRequests ? this.globalLatencySampler.getPercentile(95) : 0;\n\n const statusDistributionCopy = {\n '1xx': this.statusDistribution['1xx'],\n '2xx': this.statusDistribution['2xx'],\n '3xx': this.statusDistribution['3xx'],\n '4xx': this.statusDistribution['4xx'],\n '5xx': this.statusDistribution['5xx'],\n };\n\n const statusCodeCountsCopy = {};\n for (const [code, count] of this.statusCodeCounts.entries()) {\n statusCodeCountsCopy[code] = count;\n }\n\n return {\n generatedAt: now.toISOString(),\n startedAt: this.startedAt.toISOString(),\n uptimeSeconds,\n totalRequests: this.totalRequests,\n informationalRequests: this.informationalRequests,\n successfulRequests: this.successfulRequests,\n redirectRequests: this.redirectRequests,\n notModifiedRequests: this.notModifiedRequests,\n clientErrorRequests: this.clientErrorRequests,\n serverErrorRequests: this.serverErrorRequests,\n notFoundRequests: this.notFoundRequests,\n unmatchedRouteRequests: this.unmatchedRouteRequests,\n slowRequests: this.slowRequests,\n abortedRequests: this.abortedRequests,\n errorRate,\n slowRequestRate,\n latency: {\n avgMs,\n minMs,\n maxMs,\n p95Ms,\n sampleCount: this.globalLatencySampler.size(),\n },\n statusDistribution: statusDistributionCopy,\n statusCodeCounts: statusCodeCountsCopy,\n endpoints: this.getEndpointMetrics(),\n cardinalityOverflowCount: this.cardinalityOverflowCount,\n config: {\n slowRequestThresholdMs: this.config.slowRequestThresholdMs,\n maxRecentRequests: this.config.maxRecentRequests,\n maxRouteEntries: this.config.maxRouteEntries,\n windowSampleSize: this.config.windowSampleSize,\n requestIdHeader: this.config.requestIdHeader,\n },\n };\n }\n\n /**\n * Returns a detached array of cloned recent request records ordered from newest to oldest.\n *\n * @param {number} [limit] - Optional maximum number of records to return.\n * @returns {object[]} Array of recent request records.\n */\n getRecentRequests(limit) {\n if (limit !== undefined) {\n if (typeof limit !== 'number' || !Number.isFinite(limit)) {\n throw new TypeError(`Invalid \"limit\": expected a finite number, received ${typeof limit}.`);\n }\n if (limit <= 0) {\n return [];\n }\n }\n\n const maxToReturn =\n limit !== undefined ? Math.min(Math.floor(limit), this.recentCount) : this.recentCount;\n const results = [];\n\n for (let i = 0; i < maxToReturn; i += 1) {\n const bufferIndex =\n (this.recentWriteIndex - 1 - i + this.config.maxRecentRequests) %\n this.config.maxRecentRequests;\n const item = this.recentRequestsBuffer[bufferIndex];\n if (item) {\n const copy = {\n requestId: item.requestId,\n timestamp: item.timestamp,\n method: item.method,\n route: item.route,\n statusCode: item.statusCode,\n durationMs: item.durationMs,\n isSlow: item.isSlow,\n outcome: item.outcome,\n isUnmatchedRoute: item.isUnmatchedRoute,\n aborted: item.aborted,\n };\n if (item.errorName !== undefined) {\n copy.errorName = item.errorName;\n }\n if (item.errorCode !== undefined) {\n copy.errorCode = item.errorCode;\n }\n results.push(copy);\n }\n }\n\n return results;\n }\n\n /**\n * Resets all in-memory metrics, latency buffers, endpoint records, and recent request history.\n */\n reset() {\n this.startedAt = new Date();\n this.totalRequests = 0;\n this.informationalRequests = 0;\n this.successfulRequests = 0;\n this.redirectRequests = 0;\n this.notModifiedRequests = 0;\n this.clientErrorRequests = 0;\n this.serverErrorRequests = 0;\n this.notFoundRequests = 0;\n this.unmatchedRouteRequests = 0;\n this.slowRequests = 0;\n this.abortedRequests = 0;\n this.cardinalityOverflowCount = 0;\n\n this.totalDurationMs = 0;\n this.minDurationMs = Number.POSITIVE_INFINITY;\n this.maxDurationMs = 0;\n this.globalLatencySampler.reset();\n\n this.statusDistribution = {\n '1xx': 0,\n '2xx': 0,\n '3xx': 0,\n '4xx': 0,\n '5xx': 0,\n };\n this.statusCodeCounts.clear();\n this.endpoints.clear();\n this.recentRequestsBuffer = new Array(this.config.maxRecentRequests);\n this.recentWriteIndex = 0;\n this.recentCount = 0;\n }\n}\n", "const UUID_SEGMENT_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\nconst OBJECT_ID_SEGMENT_REGEX = /^[0-9a-f]{24}$/i;\nconst NUMERIC_SEGMENT_REGEX = /^\\d+$/;\nconst LONG_TOKEN_SEGMENT_REGEX = /^(?=.*\\d)[A-Za-z0-9_-]{12,}$/;\nconst HEX_HASH_SEGMENT_REGEX = /^[0-9a-f]{16,}$/i;\n\n/**\n * Strips query parameters and hash fragments from a URL or path and normalizes slashes.\n * Guarantees query-string values never leak into route keys or logs.\n *\n * @param {string} rawUrl - Raw URL or route path.\n * @returns {string} Cleaned path string starting with \"/\".\n */\nexport function cleanPathString(rawUrl) {\n if (!rawUrl || typeof rawUrl !== 'string') {\n return '/';\n }\n\n const withoutQuery = rawUrl.split('?')[0]?.split('#')[0]?.trim() ?? '/';\n if (withoutQuery.length === 0) {\n return '/';\n }\n\n const withLeadingSlash = withoutQuery.startsWith('/') ? withoutQuery : `/${withoutQuery}`;\n const collapsedSlashes = withLeadingSlash.replace(/\\/+/g, '/');\n\n if (collapsedSlashes.length > 1 && collapsedSlashes.endsWith('/')) {\n return collapsedSlashes.slice(0, -1);\n }\n\n return collapsedSlashes;\n}\n\n/**\n * Normalizes dynamic path segments (numeric IDs, UUIDs, MongoDB ObjectIds, long opaque tokens)\n * into canonical `:id` placeholders to prevent high-cardinality metrics explosion when\n * an Express route template is not available.\n *\n * @param {string} rawUrl - Raw URL or path.\n * @returns {string} Normalized path template.\n */\nexport function normalizeDynamicPathSegments(rawUrl) {\n const cleaned = cleanPathString(rawUrl);\n if (cleaned === '/') {\n return '/';\n }\n\n const segments = cleaned.split('/').filter((seg) => seg.length > 0);\n const normalizedSegments = segments.map((segment) => {\n if (segment.startsWith(':')) {\n return segment;\n }\n if (\n NUMERIC_SEGMENT_REGEX.test(segment) ||\n UUID_SEGMENT_REGEX.test(segment) ||\n OBJECT_ID_SEGMENT_REGEX.test(segment) ||\n HEX_HASH_SEGMENT_REGEX.test(segment) ||\n LONG_TOKEN_SEGMENT_REGEX.test(segment)\n ) {\n return ':id';\n }\n return segment;\n });\n\n return `/${normalizedSegments.join('/')}`;\n}\n\n/**\n * Resolves the canonical normalized route template for an Express request.\n *\n * Priority:\n * 1. If Express matched a route (`req.route.path`), combine `req.baseUrl` + `req.route.path`.\n * 2. If no Express route matched and the response status is 404, classify as an unmatched route\n * using `unmatchedRouteLabel` (default `/__unmatched__`) to prevent 404 cardinality explosion.\n * 3. Otherwise (e.g., middleware-terminated requests such as 401/403 or `app.use` handlers),\n * strip query strings and normalize dynamic URL segments into `:id`.\n *\n * @param {object} req - Express request object.\n * @param {number} statusCode - Final HTTP status code.\n * @param {string} [unmatchedRouteLabel='/__unmatched__'] - Label for unmatched 404 routes.\n * @returns {{ route: string, isUnmatchedRoute: boolean }} Normalized route metadata.\n */\nexport function resolveNormalizedRoute(req, statusCode, unmatchedRouteLabel = '/__unmatched__') {\n const matchedRoute = req && req.route;\n\n if (matchedRoute && matchedRoute.path !== undefined) {\n const baseUrl = typeof req.baseUrl === 'string' ? req.baseUrl : '';\n const routePath =\n typeof matchedRoute.path === 'string'\n ? matchedRoute.path\n : Array.isArray(matchedRoute.path) && typeof matchedRoute.path[0] === 'string'\n ? matchedRoute.path[0]\n : String(matchedRoute.path);\n\n const combined = cleanPathString(`${baseUrl}/${routePath}`);\n return {\n route: combined,\n isUnmatchedRoute: false,\n };\n }\n\n if (statusCode === 404) {\n return {\n route: cleanPathString(unmatchedRouteLabel),\n isUnmatchedRoute: true,\n };\n }\n\n const rawCandidate =\n (req && typeof req.originalUrl === 'string' && req.originalUrl) ||\n (req && typeof req.url === 'string' && req.url) ||\n (req && typeof req.path === 'string' && req.path) ||\n '/';\n\n return {\n route: normalizeDynamicPathSegments(rawCandidate),\n isUnmatchedRoute: false,\n };\n}\n", "import { performance } from 'node:perf_hooks';\nimport { roundDuration } from './percentile.js';\n\n/**\n * WeakMap associating an active Express Request object with its API Sentinel tracking context.\n * Using a WeakMap guarantees zero memory retention once the request lifecycle completes.\n */\nconst activeRequestContexts = new WeakMap();\n\n/**\n * Initializes and attaches a tracking context to an incoming Express request.\n *\n * @param {object} req - Express request object.\n * @param {string} requestId - Unique request identifier.\n * @returns {object} Initialized request tracking context.\n */\nexport function startRequestTracking(req, requestId) {\n const context = {\n requestId,\n startTimeMs: performance.now(),\n errorName: undefined,\n errorCode: undefined,\n };\n if (req && typeof req === 'object') {\n activeRequestContexts.set(req, context);\n }\n return context;\n}\n\n/**\n * Retrieves the active tracking context for an Express request, if present.\n *\n * @param {object} req - Express request object.\n * @returns {object|undefined} Tracking context if found.\n */\nexport function getRequestTrackingContext(req) {\n if (!req || typeof req !== 'object') {\n return undefined;\n }\n return activeRequestContexts.get(req);\n}\n\n/**\n * Computes elapsed duration in milliseconds using `performance.now()`.\n *\n * @param {number} startTimeMs - Start timestamp from `performance.now()`.\n * @param {number} [endTimeMs=performance.now()] - End timestamp from `performance.now()`.\n * @returns {number} Elapsed duration in milliseconds rounded to 2 decimal places.\n */\nexport function calculateElapsedDurationMs(startTimeMs, endTimeMs = performance.now()) {\n const diffMs = endTimeMs - startTimeMs;\n if (!Number.isFinite(diffMs) || diffMs <= 0) {\n return 0;\n }\n return roundDuration(diffMs);\n}\n\n/**\n * Classifies an HTTP status code into a semantic outcome string.\n *\n * - 500\u2013599: `'server_error'`\n * - 400\u2013499: `'client_error'`\n * - 304: `'not_modified'` (cache validation response within 3xx family)\n * - 300\u2013399 (excluding 304): `'redirect'`\n * - 200\u2013299: `'success'`\n * - 100\u2013199: `'informational'`\n *\n * @param {number} statusCode - HTTP response status code.\n * @returns {'success'|'redirect'|'not_modified'|'client_error'|'server_error'|'informational'} Outcome classification.\n */\nexport function classifyHttpStatus(statusCode) {\n if (statusCode >= 500) {\n return 'server_error';\n }\n if (statusCode >= 400) {\n return 'client_error';\n }\n if (statusCode === 304) {\n return 'not_modified';\n }\n if (statusCode >= 300) {\n return 'redirect';\n }\n if (statusCode >= 200) {\n return 'success';\n }\n return 'informational';\n}\n", "import { randomUUID } from 'node:crypto';\n\n/**\n * Strict validation pattern for optional incoming request IDs when `trustIncomingRequestId: true`.\n * Allows only URL-safe alphanumeric characters, hyphens, and underscores between 8 and 64 characters.\n * Prevents header splitting (CRLF), log injection, and oversized header attacks.\n */\nconst SAFE_REQUEST_ID_PATTERN = /^[A-Za-z0-9_-]{8,64}$/;\n\n/**\n * Generates a cryptographically strong UUID v4 request identifier.\n *\n * @returns {string} Unique request ID.\n */\nexport function generateRequestId() {\n return randomUUID();\n}\n\n/**\n * Validates whether an incoming header value is safe to adopt as a request ID.\n *\n * @param {unknown} candidate - Incoming header value.\n * @returns {boolean} True if valid and safe.\n */\nexport function isValidIncomingRequestId(candidate) {\n return typeof candidate === 'string' && SAFE_REQUEST_ID_PATTERN.test(candidate);\n}\n\n/**\n * Resolves the request ID for an incoming Express request.\n * By default (`trustIncoming = false`), always generates a fresh UUID v4 and ignores client headers.\n *\n * @param {object} req - Express request object.\n * @param {string} headerName - Header name to inspect if trustIncoming is enabled.\n * @param {boolean} [trustIncoming=false] - Whether to trust validated client request IDs.\n * @returns {string} Resolved request ID.\n */\nexport function resolveRequestId(req, headerName, trustIncoming = false) {\n if (trustIncoming && req && req.headers) {\n const rawHeader = req.headers[String(headerName).toLowerCase()];\n const candidate = Array.isArray(rawHeader) ? rawHeader[0] : rawHeader;\n if (isValidIncomingRequestId(candidate)) {\n return candidate;\n }\n }\n return generateRequestId();\n}\n", "import {\n calculateElapsedDurationMs,\n classifyHttpStatus,\n startRequestTracking,\n} from '../core/request-tracker.js';\nimport { cleanPathString, resolveNormalizedRoute } from '../core/route-normalizer.js';\nimport { resolveRequestId } from '../utils/request-id.js';\n\n/**\n * Checks whether an incoming request matches any configured `ignorePaths` rule.\n *\n * @param {object} req - Express request object.\n * @param {Array<string|RegExp>|Function} ignorePaths - Ignore rules.\n * @returns {boolean} True if the request should be skipped by API Sentinel.\n */\nexport function shouldIgnoreRequest(req, ignorePaths) {\n if (typeof ignorePaths === 'function') {\n return Boolean(ignorePaths(req));\n }\n\n if (!Array.isArray(ignorePaths) || ignorePaths.length === 0) {\n return false;\n }\n\n const rawPath =\n (req && typeof req.originalUrl === 'string' && req.originalUrl) ||\n (req && typeof req.url === 'string' && req.url) ||\n (req && typeof req.path === 'string' && req.path) ||\n '/';\n const cleanedPath = cleanPathString(rawPath);\n\n for (const pattern of ignorePaths) {\n if (typeof pattern === 'string') {\n if (cleanPathString(pattern) === cleanedPath) {\n return true;\n }\n } else if (pattern instanceof RegExp) {\n if (pattern.test(cleanedPath)) {\n return true;\n }\n }\n }\n\n return false;\n}\n\n/**\n * Creates the primary API Sentinel Express middleware.\n *\n * @param {object} params - Internal dependencies.\n * @param {object} params.config - Resolved configuration.\n * @param {import('../core/metrics-collector.js').MetricsCollector} params.collector - Metrics collector instance.\n * @param {import('../utils/logger.js').StructuredLogger} params.logger - Structured logger instance.\n * @returns {Function} Express middleware function `(req, res, next) => void`.\n */\nexport function createSentinelMiddleware({ config, collector, logger }) {\n return function apiSentinelMiddleware(req, res, next) {\n if (shouldIgnoreRequest(req, config.ignorePaths)) {\n next();\n return;\n }\n\n const requestId = resolveRequestId(req, config.requestIdHeader, config.trustIncomingRequestId);\n const trackingContext = startRequestTracking(req, requestId);\n\n if (res && typeof res.setHeader === 'function' && !res.headersSent) {\n res.setHeader(config.requestIdHeader, requestId);\n }\n\n if (res && typeof res.locals === 'object' && res.locals !== null) {\n res.locals.requestId = requestId;\n }\n\n let finalized = false;\n\n const finalizeRequest = (aborted) => {\n if (finalized) {\n return;\n }\n finalized = true;\n\n if (res && typeof res.removeListener === 'function') {\n res.removeListener('finish', onFinish);\n res.removeListener('close', onClose);\n }\n\n const durationMs = calculateElapsedDurationMs(trackingContext.startTimeMs);\n const rawStatus =\n res && typeof res.statusCode === 'number' && Number.isFinite(res.statusCode)\n ? res.statusCode\n : 200;\n const statusCode = aborted && !res?.writableEnded && rawStatus === 200 ? 499 : rawStatus;\n\n const { route, isUnmatchedRoute } = resolveNormalizedRoute(\n req,\n statusCode,\n config.unmatchedRouteLabel\n );\n\n const method =\n req && typeof req.method === 'string' && req.method.trim().length > 0\n ? req.method.toUpperCase()\n : 'GET';\n\n const isSlow = durationMs > config.slowRequestThresholdMs;\n const outcome = classifyHttpStatus(statusCode);\n const timestamp = new Date().toISOString();\n\n const record = {\n requestId,\n timestamp,\n method,\n route,\n statusCode,\n durationMs,\n isSlow,\n outcome,\n isUnmatchedRoute,\n aborted,\n };\n\n if (trackingContext.errorName !== undefined) {\n record.errorName = trackingContext.errorName;\n }\n if (trackingContext.errorCode !== undefined) {\n record.errorCode = trackingContext.errorCode;\n }\n\n collector.recordRequest(record);\n logger.logCompletedRequest(record);\n };\n\n const onFinish = () => {\n finalizeRequest(false);\n };\n\n const onClose = () => {\n const wasAborted = !(res && (res.writableEnded || res.finished));\n finalizeRequest(wasAborted);\n };\n\n if (res && typeof res.on === 'function') {\n res.on('finish', onFinish);\n res.on('close', onClose);\n }\n\n next();\n };\n}\n", "const SAFE_IDENTIFIER_REGEX = /^[A-Za-z0-9_.:-]+$/;\n\n/**\n * Builds a strictly whitelisted structured log event object.\n * Guarantees that request bodies, query parameters, passwords, authorization headers,\n * cookies, session tokens, and raw stack traces are never included in monitoring events.\n *\n * @param {object} event - Raw candidate log event.\n * @returns {object} Frozen, sanitized log event with whitelisted properties only.\n */\nexport function sanitizeLogEvent(event) {\n const clean = {\n type: String(event.type),\n requestId: String(event.requestId),\n method: String(event.method).toUpperCase(),\n route: String(event.route),\n statusCode: Number(event.statusCode),\n durationMs: Number(event.durationMs),\n timestamp: String(event.timestamp),\n };\n\n if (event.outcome !== undefined) {\n clean.outcome = String(event.outcome);\n }\n if (event.isSlow !== undefined) {\n clean.isSlow = Boolean(event.isSlow);\n }\n if (event.isUnmatchedRoute !== undefined) {\n clean.isUnmatchedRoute = Boolean(event.isUnmatchedRoute);\n }\n if (event.aborted !== undefined) {\n clean.aborted = Boolean(event.aborted);\n }\n if (event.errorName !== undefined) {\n clean.errorName = String(event.errorName).slice(0, 120);\n }\n if (event.errorCode !== undefined) {\n clean.errorCode = String(event.errorCode).slice(0, 64);\n }\n\n return Object.freeze(clean);\n}\n\n/**\n * Extracts strictly privacy-safe classification metadata from an unknown error object.\n * Never extracts error messages, stack traces, SQL queries, or request payloads.\n *\n * @param {unknown} err - Error passed to Express error middleware.\n * @returns {{ errorName: string, errorCode?: string }} Safe error classification metadata.\n */\nexport function extractSafeErrorMetadata(err) {\n if (err === null || err === undefined) {\n return { errorName: 'UnknownError' };\n }\n\n if (typeof err === 'object') {\n let rawName = 'Error';\n if (typeof err.name === 'string' && err.name.trim().length > 0) {\n rawName = err.name.trim();\n } else if (\n err.constructor &&\n typeof err.constructor.name === 'string' &&\n err.constructor.name.trim().length > 0\n ) {\n rawName = err.constructor.name.trim();\n }\n\n const sanitizedName = SAFE_IDENTIFIER_REGEX.test(rawName)\n ? rawName.slice(0, 80)\n : 'ApplicationError';\n\n let sanitizedCode;\n if (typeof err.code === 'string' && SAFE_IDENTIFIER_REGEX.test(err.code)) {\n sanitizedCode = err.code.slice(0, 64);\n } else if (typeof err.code === 'number' && Number.isFinite(err.code)) {\n sanitizedCode = String(err.code);\n }\n\n const result = { errorName: sanitizedName };\n if (sanitizedCode !== undefined) {\n result.errorCode = sanitizedCode;\n }\n return result;\n }\n\n return { errorName: 'NonObjectThrown' };\n}\n", "import { calculateElapsedDurationMs, getRequestTrackingContext } from '../core/request-tracker.js';\nimport { resolveNormalizedRoute } from '../core/route-normalizer.js';\nimport { resolveRequestId } from '../utils/request-id.js';\nimport { extractSafeErrorMetadata } from '../utils/sanitizer.js';\n\n/**\n * Creates the Express error-handling middleware for API Sentinel.\n *\n * Captures strictly sanitized error classification metadata (`errorName` and optional `errorCode`),\n * emits an `'error-detected'` structured log event, and always forwards the original error\n * to `next(err)` without swallowing exceptions or altering the response lifecycle.\n *\n * @param {object} params - Internal dependencies.\n * @param {object} params.config - Resolved configuration.\n * @param {import('../utils/logger.js').StructuredLogger} params.logger - Structured logger instance.\n * @returns {Function} Express error-handling middleware `(err, req, res, next) => void`.\n */\nexport function createSentinelErrorHandler({ config, logger }) {\n return function apiSentinelErrorHandler(err, req, res, next) {\n const safeMeta = extractSafeErrorMetadata(err);\n const trackingContext = getRequestTrackingContext(req);\n\n if (trackingContext) {\n trackingContext.errorName = safeMeta.errorName;\n if (safeMeta.errorCode !== undefined) {\n trackingContext.errorCode = safeMeta.errorCode;\n }\n }\n\n const requestId =\n trackingContext?.requestId ??\n resolveRequestId(req, config.requestIdHeader, config.trustIncomingRequestId);\n\n const durationMs = trackingContext\n ? calculateElapsedDurationMs(trackingContext.startTimeMs)\n : 0;\n\n const currentStatus =\n res && typeof res.statusCode === 'number' && res.statusCode >= 400 ? res.statusCode : 500;\n\n const { route, isUnmatchedRoute } = resolveNormalizedRoute(\n req,\n currentStatus,\n config.unmatchedRouteLabel\n );\n\n const method =\n req && typeof req.method === 'string' && req.method.trim().length > 0\n ? req.method.toUpperCase()\n : 'GET';\n\n if (config.logging.enabled && config.logging.logServerErrors) {\n logger.emit({\n type: 'error-detected',\n requestId,\n method,\n route,\n statusCode: currentStatus,\n durationMs,\n timestamp: new Date().toISOString(),\n outcome: currentStatus >= 500 ? 'server_error' : 'client_error',\n isSlow: durationMs > config.slowRequestThresholdMs,\n isUnmatchedRoute,\n errorName: safeMeta.errorName,\n ...(safeMeta.errorCode !== undefined ? { errorCode: safeMeta.errorCode } : {}),\n });\n }\n\n next(err);\n };\n}\n", "import { sanitizeLogEvent } from './sanitizer.js';\n\n/**\n * Structured logger that safely emits machine-readable monitoring events.\n * Any exception thrown by a custom writer or console output is caught and suppressed\n * so logging failures can never crash or interrupt the host Express application.\n */\nexport class StructuredLogger {\n /**\n * @param {object} loggingConfig - Resolved logging configuration.\n */\n constructor(loggingConfig) {\n this.config = loggingConfig;\n }\n\n /**\n * Emits a single structured log event if logging is enabled.\n *\n * @param {object} event - Event record to emit.\n */\n emit(event) {\n if (!this.config || !this.config.enabled) {\n return;\n }\n\n try {\n const sanitized = sanitizeLogEvent(event);\n\n if (typeof this.config.writer === 'function') {\n this.config.writer(sanitized);\n return;\n }\n\n const serialized = JSON.stringify(sanitized);\n if (sanitized.type === 'server-error' || sanitized.type === 'error-detected') {\n console.error(serialized);\n } else if (sanitized.type === 'slow-request' || sanitized.type === 'client-error') {\n console.warn(serialized);\n } else {\n console.info(serialized);\n }\n } catch {\n // Never allow logging failures to crash or disrupt the host application.\n }\n }\n\n /**\n * Evaluates a completed request and emits the appropriate structured event(s)\n * according to the active logging configuration.\n *\n * @param {object} record - Completed request record.\n */\n logCompletedRequest(record) {\n if (!this.config || !this.config.enabled) {\n return;\n }\n\n const isServerError = record.statusCode >= 500;\n const isClientError = record.statusCode >= 400 && record.statusCode < 500;\n const isSlow = Boolean(record.isSlow);\n\n if (isServerError && this.config.logServerErrors) {\n this.emit({ ...record, type: 'server-error' });\n } else if (isClientError && this.config.logClientErrors) {\n this.emit({ ...record, type: 'client-error' });\n }\n\n if (isSlow && this.config.logSlowRequests) {\n this.emit({ ...record, type: 'slow-request' });\n }\n\n if (\n this.config.logAllRequests &&\n !isSlow &&\n !(isServerError && this.config.logServerErrors) &&\n !(isClientError && this.config.logClientErrors)\n ) {\n this.emit({ ...record, type: 'request-completed' });\n }\n }\n}\n", "import { CONFIG_BOUNDS, DEFAULT_CONFIG } from '../config/defaults.js';\n\nconst HEADER_NAME_REGEX = /^[!#$%&'*+\\-.^_`|~0-9A-Za-z]+$/;\n\nfunction validateNumberRange(value, fieldName, min, max) {\n if (typeof value !== 'number' || !Number.isFinite(value)) {\n throw new TypeError(\n `Invalid \"${fieldName}\": expected a finite number, received ${typeof value}.`\n );\n }\n if (value < min || value > max) {\n throw new RangeError(\n `Invalid \"${fieldName}\": must be between ${min} and ${max}, received ${value}.`\n );\n }\n return value;\n}\n\nfunction validateIntegerRange(value, fieldName, min, max) {\n const num = validateNumberRange(value, fieldName, min, max);\n if (!Number.isInteger(num)) {\n throw new RangeError(`Invalid \"${fieldName}\": expected an integer, received ${value}.`);\n }\n return num;\n}\n\nfunction resolveLoggerConfig(logging) {\n if (logging === undefined || logging === true) {\n return { ...DEFAULT_CONFIG.logging };\n }\n\n if (logging === false) {\n return {\n enabled: false,\n logAllRequests: false,\n logSlowRequests: false,\n logServerErrors: false,\n logClientErrors: false,\n };\n }\n\n if (typeof logging !== 'object' || logging === null || Array.isArray(logging)) {\n throw new TypeError('Invalid \"logging\" option: expected a boolean or configuration object.');\n }\n\n if (logging.writer !== undefined && typeof logging.writer !== 'function') {\n throw new TypeError('Invalid \"logging.writer\": expected a callback function.');\n }\n\n const resolved = {\n enabled: logging.enabled ?? DEFAULT_CONFIG.logging.enabled,\n logAllRequests: logging.logAllRequests ?? DEFAULT_CONFIG.logging.logAllRequests,\n logSlowRequests: logging.logSlowRequests ?? DEFAULT_CONFIG.logging.logSlowRequests,\n logServerErrors: logging.logServerErrors ?? DEFAULT_CONFIG.logging.logServerErrors,\n logClientErrors: logging.logClientErrors ?? DEFAULT_CONFIG.logging.logClientErrors,\n };\n\n if (typeof resolved.enabled !== 'boolean') {\n throw new TypeError('Invalid \"logging.enabled\": expected a boolean.');\n }\n\n if (logging.writer) {\n resolved.writer = logging.writer;\n }\n\n return resolved;\n}\n\n/**\n * Validates user-supplied configuration options and merges them with defaults.\n *\n * @param {object} [config={}] - User configuration options.\n * @returns {object} Frozen, validated configuration object.\n */\nexport function resolveAndValidateConfig(config = {}) {\n if (typeof config !== 'object' || config === null || Array.isArray(config)) {\n throw new TypeError('Invalid configuration: expected a plain configuration object.');\n }\n\n const slowRequestThresholdMs =\n config.slowRequestThresholdMs !== undefined\n ? validateNumberRange(\n config.slowRequestThresholdMs,\n 'slowRequestThresholdMs',\n CONFIG_BOUNDS.slowRequestThresholdMs.min,\n CONFIG_BOUNDS.slowRequestThresholdMs.max\n )\n : DEFAULT_CONFIG.slowRequestThresholdMs;\n\n const maxRecentRequests =\n config.maxRecentRequests !== undefined\n ? validateIntegerRange(\n config.maxRecentRequests,\n 'maxRecentRequests',\n CONFIG_BOUNDS.maxRecentRequests.min,\n CONFIG_BOUNDS.maxRecentRequests.max\n )\n : DEFAULT_CONFIG.maxRecentRequests;\n\n const maxRouteEntries =\n config.maxRouteEntries !== undefined\n ? validateIntegerRange(\n config.maxRouteEntries,\n 'maxRouteEntries',\n CONFIG_BOUNDS.maxRouteEntries.min,\n CONFIG_BOUNDS.maxRouteEntries.max\n )\n : DEFAULT_CONFIG.maxRouteEntries;\n\n const windowSampleSize =\n config.windowSampleSize !== undefined\n ? validateIntegerRange(\n config.windowSampleSize,\n 'windowSampleSize',\n CONFIG_BOUNDS.windowSampleSize.min,\n CONFIG_BOUNDS.windowSampleSize.max\n )\n : DEFAULT_CONFIG.windowSampleSize;\n\n const requestIdHeader = config.requestIdHeader ?? DEFAULT_CONFIG.requestIdHeader;\n if (\n typeof requestIdHeader !== 'string' ||\n requestIdHeader.trim().length === 0 ||\n !HEADER_NAME_REGEX.test(requestIdHeader)\n ) {\n throw new TypeError(\n 'Invalid \"requestIdHeader\": must be a valid non-empty HTTP header token string.'\n );\n }\n\n const trustIncomingRequestId =\n config.trustIncomingRequestId ?? DEFAULT_CONFIG.trustIncomingRequestId;\n if (typeof trustIncomingRequestId !== 'boolean') {\n throw new TypeError('Invalid \"trustIncomingRequestId\": expected a boolean.');\n }\n\n const ignorePaths = config.ignorePaths ?? [];\n if (typeof ignorePaths !== 'function' && !Array.isArray(ignorePaths)) {\n throw new TypeError(\n 'Invalid \"ignorePaths\": expected an array of strings/RegExps or a predicate function.'\n );\n }\n\n if (Array.isArray(ignorePaths)) {\n for (const item of ignorePaths) {\n if (typeof item !== 'string' && !(item instanceof RegExp)) {\n throw new TypeError(\n 'Invalid \"ignorePaths\" element: every item must be a string or RegExp.'\n );\n }\n }\n }\n\n const fallbackRouteLabel = config.fallbackRouteLabel ?? DEFAULT_CONFIG.fallbackRouteLabel;\n if (typeof fallbackRouteLabel !== 'string' || !fallbackRouteLabel.startsWith('/')) {\n throw new TypeError('Invalid \"fallbackRouteLabel\": must be a string starting with \"/\".');\n }\n\n const unmatchedRouteLabel = config.unmatchedRouteLabel ?? DEFAULT_CONFIG.unmatchedRouteLabel;\n if (typeof unmatchedRouteLabel !== 'string' || !unmatchedRouteLabel.startsWith('/')) {\n throw new TypeError('Invalid \"unmatchedRouteLabel\": must be a string starting with \"/\".');\n }\n\n return Object.freeze({\n slowRequestThresholdMs,\n maxRecentRequests,\n maxRouteEntries,\n windowSampleSize,\n requestIdHeader,\n trustIncomingRequestId,\n logging: Object.freeze(resolveLoggerConfig(config.logging)),\n ignorePaths,\n fallbackRouteLabel,\n unmatchedRouteLabel,\n });\n}\n", "import { DEFAULT_CONFIG } from './config/defaults.js';\nimport { MetricsCollector } from './core/metrics-collector.js';\nimport { calculatePercentile, RollingWindowSampler, roundDuration } from './core/percentile.js';\nimport {\n cleanPathString,\n normalizeDynamicPathSegments,\n resolveNormalizedRoute,\n} from './core/route-normalizer.js';\nimport { createSentinelMiddleware } from './middleware/create-middleware.js';\nimport { createSentinelErrorHandler } from './middleware/error-handler.js';\nimport { StructuredLogger } from './utils/logger.js';\nimport {\n generateRequestId,\n isValidIncomingRequestId,\n resolveRequestId,\n} from './utils/request-id.js';\nimport { extractSafeErrorMetadata, sanitizeLogEvent } from './utils/sanitizer.js';\nimport { resolveAndValidateConfig } from './utils/validation.js';\n\n/**\n * Creates a configured API Sentinel observability instance for an Express application.\n *\n * @param {object} [options={}] - Configuration options.\n * @param {number} [options.slowRequestThresholdMs=500] - Threshold in ms above which requests are marked slow.\n * @param {number} [options.maxRecentRequests=200] - Maximum recent request records stored in memory.\n * @param {number} [options.maxRouteEntries=100] - Maximum distinct route templates tracked before overflow bucket aggregation.\n * @param {number} [options.windowSampleSize=1000] - Rolling window sample capacity for P95 latency calculations.\n * @param {string} [options.requestIdHeader='X-Request-ID'] - Outgoing response header name for request IDs.\n * @param {boolean} [options.trustIncomingRequestId=false] - Whether to trust validated incoming request ID headers.\n * @param {boolean|object} [options.logging=true] - Enable/disable or customize structured logging.\n * @param {Array<string|RegExp>|Function} [options.ignorePaths=[]] - Paths or predicate to exclude from monitoring.\n * @param {string} [options.fallbackRouteLabel='/__overflow_routes__'] - Route label for cardinality overflow bucket.\n * @param {string} [options.unmatchedRouteLabel='/__unmatched__'] - Route label for unmatched 404 requests.\n * @returns {{\n * middleware: Function,\n * errorHandler: Function,\n * getMetrics: () => object,\n * getRecentRequests: (limit?: number) => object[],\n * getEndpointMetrics: () => object[],\n * resetMetrics: () => void,\n * getConfig: () => object\n * }} Frozen API Sentinel instance.\n */\nexport function createApiSentinel(options = {}) {\n const config = resolveAndValidateConfig(options);\n const collector = new MetricsCollector(config);\n const logger = new StructuredLogger(config.logging);\n\n const middleware = createSentinelMiddleware({ config, collector, logger });\n const errorHandler = createSentinelErrorHandler({ config, logger });\n\n return Object.freeze({\n middleware,\n errorHandler,\n getMetrics: () => collector.getMetrics(),\n getRecentRequests: (limit) => collector.getRecentRequests(limit),\n getEndpointMetrics: () => collector.getEndpointMetrics(),\n resetMetrics: () => collector.reset(),\n getConfig: () => config,\n });\n}\n\nexport {\n DEFAULT_CONFIG,\n calculatePercentile,\n RollingWindowSampler,\n roundDuration,\n cleanPathString,\n normalizeDynamicPathSegments,\n resolveNormalizedRoute,\n generateRequestId,\n isValidIncomingRequestId,\n resolveRequestId,\n extractSafeErrorMetadata,\n sanitizeLogEvent,\n resolveAndValidateConfig,\n};\n\nexport default createApiSentinel;\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
package/package.json CHANGED
@@ -1,6 +1,78 @@
1
1
  {
2
2
  "name": "api-sentinel-express",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "1.0.0",
4
+ "description": "Lightweight, privacy-first Express.js observability and API monitoring middleware with in-memory latency analytics, P95 tracking, slow-request detection, and structured logging.",
5
+ "keywords": [
6
+ "express",
7
+ "express-middleware",
8
+ "observability",
9
+ "monitoring",
10
+ "api-monitoring",
11
+ "metrics",
12
+ "latency",
13
+ "p95",
14
+ "request-id",
15
+ "structured-logging",
16
+ "performance",
17
+ "javascript",
18
+ "nodejs",
19
+ "api-sentinel"
20
+ ],
21
+ "homepage": "https://github.com/YOUR_GITHUB_USERNAME/api-sentinel-express#readme",
22
+ "bugs": {
23
+ "url": "https://github.com/YOUR_GITHUB_USERNAME/api-sentinel-express/issues"
24
+ },
25
+ "repository": {
26
+ "type": "git",
27
+ "url": "git+https://github.com/aviiixbuilds/api-sentinel-express.git"
28
+ },
29
+ "license": "MIT",
30
+ "author": "Aviral Dwivedi <your-email@example.com>",
31
+ "sideEffects": false,
32
+ "type": "module",
33
+ "main": "./dist/index.cjs",
34
+ "module": "./dist/index.js",
35
+ "exports": {
36
+ ".": {
37
+ "import": "./dist/index.js",
38
+ "require": "./dist/index.cjs",
39
+ "default": "./dist/index.js"
40
+ },
41
+ "./package.json": "./package.json"
42
+ },
43
+ "files": [
44
+ "dist",
45
+ "README.md",
46
+ "LICENSE",
47
+ "CHANGELOG.md",
48
+ "SECURITY.md"
49
+ ],
50
+ "engines": {
51
+ "node": ">=20.0.0"
52
+ },
53
+ "peerDependencies": {
54
+ "express": "^4.18.0 || ^5.0.0"
55
+ },
56
+ "devDependencies": {
57
+ "@eslint/js": "^9.20.0",
58
+ "@vitest/coverage-v8": "^3.0.5",
59
+ "esbuild": "^0.25.0",
60
+ "eslint": "^9.20.0",
61
+ "express": "^4.21.2",
62
+ "globals": "^15.15.0",
63
+ "prettier": "^3.5.0",
64
+ "supertest": "^7.0.0",
65
+ "vitest": "^3.0.5"
66
+ },
67
+ "scripts": {
68
+ "build": "node scripts/build.js",
69
+ "lint": "eslint src tests examples benchmarks scripts",
70
+ "format": "prettier --write \"src/**/*.js\" \"tests/**/*.js\" \"examples/**/*.js\" \"benchmarks/**/*.js\" \"scripts/**/*.js\"",
71
+ "format:check": "prettier --check \"src/**/*.js\" \"tests/**/*.js\" \"examples/**/*.js\" \"benchmarks/**/*.js\" \"scripts/**/*.js\"",
72
+ "test": "vitest run",
73
+ "test:watch": "vitest",
74
+ "test:coverage": "vitest run --coverage",
75
+ "benchmark": "node benchmarks/overhead-benchmark.js",
76
+ "prepublishOnly": "npm run lint && npm run test && npm run build"
77
+ }
78
+ }