@sentienguard/apm 1.0.5 → 1.0.6

package/src/normalizer.js

@@ -1,147 +1,147 @@
-/**
- * Route Normalizer
- * Normalizes dynamic routes before aggregation to prevent cardinality explosion.
- *
- * Examples:
- *   /api/users/123        → /api/users/:id
- *   /api/orders/ab23f9    → /api/orders/:id
- *   /api/users/123/posts/456 → /api/users/:id/posts/:id
- */
-
-// Patterns for ID detection
-const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-const MONGO_ID_PATTERN = /^[0-9a-f]{24}$/i;
-const NUMERIC_PATTERN = /^\d+$/;
-const SHORT_HEX_PATTERN = /^[0-9a-f]{6,}$/i;
-
-// Max route length to prevent abuse
-const MAX_ROUTE_LENGTH = 200;
-
-/**
- * Check if a path segment looks like a dynamic ID
- */
-function isIdSegment(segment) {
-  if (!segment) return false;
-
-  // Check for common ID patterns
-  if (NUMERIC_PATTERN.test(segment)) return true;
-  if (UUID_PATTERN.test(segment)) return true;
-  if (MONGO_ID_PATTERN.test(segment)) return true;
-  if (SHORT_HEX_PATTERN.test(segment)) return true;
-
-  return false;
-}
-
-/**
- * Normalize a route path by replacing dynamic segments with :id
- *
- * @param {string} path - The URL path to normalize
- * @returns {string} Normalized route path
- */
-export function normalizeRoute(path) {
-  if (!path || typeof path !== 'string') {
-    return '/unknown';
-  }
-
-  // Remove query string and hash
-  let cleanPath = path.split('?')[0].split('#')[0];
-
-  // Ensure path starts with /
-  if (!cleanPath.startsWith('/')) {
-    cleanPath = '/' + cleanPath;
-  }
-
-  // Truncate overly long paths
-  if (cleanPath.length > MAX_ROUTE_LENGTH) {
-    return '/unknown';
-  }
-
-  // Split into segments and normalize
-  const segments = cleanPath.split('/');
-  const normalizedSegments = segments.map(segment => {
-    if (isIdSegment(segment)) {
-      return ':id';
-    }
-    return segment;
-  });
-
-  const normalized = normalizedSegments.join('/');
-
-  // Clean up multiple slashes
-  return normalized.replace(/\/+/g, '/') || '/';
-}
-
-/**
- * Extract route pattern from Express/Fastify request
- * Prefers the framework's route pattern if available
- *
- * @param {object} req - HTTP request object
- * @returns {string} Route pattern
- */
-export function extractRoute(req) {
-  // Express stores the matched route pattern
-  if (req.route && req.route.path) {
-    return req.baseUrl ? req.baseUrl + req.route.path : req.route.path;
-  }
-
-  // Fastify stores route info differently
-  if (req.routerPath) {
-    return req.routerPath;
-  }
-
-  // Fastify alternative
-  if (req.routeOptions && req.routeOptions.url) {
-    return req.routeOptions.url;
-  }
-
-  // Fall back to normalizing the URL
-  return normalizeRoute(req.url || req.originalUrl || '/');
-}
-
-/**
- * Route registry to track and limit unique routes
- */
-export class RouteRegistry {
-  constructor(maxRoutes = 100) {
-    this.maxRoutes = maxRoutes;
-    this.routes = new Set();
-  }
-
-  /**
-   * Register a route and check if it should be tracked
-   * Returns the route if under limit, '/unknown' if limit exceeded
-   */
-  register(route) {
-    if (this.routes.has(route)) {
-      return route;
-    }
-
-    if (this.routes.size >= this.maxRoutes) {
-      // Bucket overflow routes as /unknown
-      return '/unknown';
-    }
-
-    this.routes.add(route);
-    return route;
-  }
-
-  /**
-   * Get count of unique routes
-   */
-  get size() {
-    return this.routes.size;
-  }
-
-  /**
-   * Reset the registry
-   */
-  clear() {
-    this.routes.clear();
-  }
-}
-
-export default {
-  normalizeRoute,
-  extractRoute,
-  RouteRegistry
-};
+/**
+ * Route Normalizer
+ * Normalizes dynamic routes before aggregation to prevent cardinality explosion.
+ *
+ * Examples:
+ *   /api/users/123        → /api/users/:id
+ *   /api/orders/ab23f9    → /api/orders/:id
+ *   /api/users/123/posts/456 → /api/users/:id/posts/:id
+ */
+
+// Patterns for ID detection
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const MONGO_ID_PATTERN = /^[0-9a-f]{24}$/i;
+const NUMERIC_PATTERN = /^\d+$/;
+const SHORT_HEX_PATTERN = /^[0-9a-f]{6,}$/i;
+
+// Max route length to prevent abuse
+const MAX_ROUTE_LENGTH = 200;
+
+/**
+ * Check if a path segment looks like a dynamic ID
+ */
+function isIdSegment(segment) {
+  if (!segment) return false;
+
+  // Check for common ID patterns
+  return (
+    NUMERIC_PATTERN.test(segment) ||
+    UUID_PATTERN.test(segment) ||
+    MONGO_ID_PATTERN.test(segment) ||
+    SHORT_HEX_PATTERN.test(segment)
+  );
+}
+
+/**
+ * Normalize a route path by replacing dynamic segments with :id
+ *
+ * @param {string} path - The URL path to normalize
+ * @returns {string} Normalized route path
+ */
+export function normalizeRoute(path) {
+  if (!path || typeof path !== 'string') {
+    return '/unknown';
+  }
+
+  // Remove query string and hash
+  let cleanPath = path.split('?')[0].split('#')[0];
+
+  // Ensure path starts with /
+  if (!cleanPath.startsWith('/')) {
+    cleanPath = '/' + cleanPath;
+  }
+
+  // Truncate overly long paths
+  if (cleanPath.length > MAX_ROUTE_LENGTH) {
+    return '/unknown';
+  }
+
+  // Split into segments and normalize
+  const segments = cleanPath.split('/');
+  const normalizedSegments = segments.map(segment => {
+    if (isIdSegment(segment)) {
+      return ':id';
+    }
+    return segment;
+  });
+
+  const normalized = normalizedSegments.join('/');
+
+  // Clean up multiple slashes
+  return normalized.replace(/\/+/g, '/') || '/';
+}
+
+/**
+ * Extract route pattern from Express/Fastify request
+ * Prefers the framework's route pattern if available
+ *
+ * @param {object} req - HTTP request object
+ * @returns {string} Route pattern
+ */
+export function extractRoute(req) {
+  // Express stores the matched route pattern
+  if (req.route?.path) {
+    return req.baseUrl ? req.baseUrl + req.route.path : req.route.path;
+  }
+
+  // Fastify stores route info differently
+  if (req.routerPath) {
+    return req.routerPath;
+  }
+
+  // Fastify alternative
+  if (req.routeOptions?.url) {
+    return req.routeOptions.url;
+  }
+
+  // Fall back to normalizing the URL
+  return normalizeRoute(req.url || req.originalUrl || '/');
+}
+
+/**
+ * Route registry to track and limit unique routes
+ */
+export class RouteRegistry {
+  constructor(maxRoutes = 100) {
+    this.maxRoutes = maxRoutes;
+    this.routes = new Set();
+  }
+
+  /**
+   * Register a route and check if it should be tracked
+   * Returns the route if under limit, '/unknown' if limit exceeded
+   */
+  register(route) {
+    if (this.routes.has(route)) {
+      return route;
+    }
+
+    if (this.routes.size >= this.maxRoutes) {
+      // Bucket overflow routes as /unknown
+      return '/unknown';
+    }
+
+    this.routes.add(route);
+    return route;
+  }
+
+  /**
+   * Get count of unique routes
+   */
+  get size() {
+    return this.routes.size;
+  }
+
+  /**
+   * Reset the registry
+   */
+  clear() {
+    this.routes.clear();
+  }
+}
+
+export default {
+  normalizeRoute,
+  extractRoute,
+  RouteRegistry
+};