@adobe/spacecat-shared-utils 1.47.0 → 1.48.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [@adobe/spacecat-shared-utils-v1.48.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-utils-v1.47.0...@adobe/spacecat-shared-utils-v1.48.0) (2025-08-18)
+
+
+### Features
+
+* added `urlMatchesFilter` in `spacecat-shared-utils` ([#921](https://github.com/adobe/spacecat-shared/issues/921)) ([74e11e4](https://github.com/adobe/spacecat-shared/commit/74e11e4124137b13942b0c58ead620905c438538))
+
 # [@adobe/spacecat-shared-utils-v1.47.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-utils-v1.46.0...@adobe/spacecat-shared-utils-v1.47.0) (2025-08-15)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-utils",
-  "version": "1.47.0",
+  "version": "1.48.0",
   "description": "Shared modules of the Spacecat Services - utils",
   "type": "module",
   "engines": {

package/src/index.js

@@ -64,6 +64,7 @@ export {
   resolveCanonicalUrl,
   getSpacecatRequestHeaders,
   ensureHttps,
+  urlMatchesFilter,
 } from './url-helpers.js';
 
 export { getStoredMetrics, storeMetrics } from './metrics-store.js';

package/src/url-helpers.js

@@ -171,6 +171,75 @@ async function resolveCanonicalUrl(urlString, method = 'HEAD') {
   }
 }
 
+/**
+ * Normalize a URL by trimming whitespace and handling trailing slashes
+ * @param {string} url - The URL to normalize
+ * @returns {string} The normalized URL
+ */
+function normalizeUrl(url) {
+  if (!url || typeof url !== 'string') return url;
+  // Trim whitespace from beginning and end
+  let normalized = url.trim();
+  // Handle trailing slashes - normalize multiple trailing slashes to single slash
+  // or no slash depending on whether it's a root path
+  if (normalized.endsWith('/')) {
+    // Remove all trailing slashes
+    normalized = normalized.replace(/\/+$/, '');
+    // Add back a single slash if it's a root path (domain only)
+    const parts = normalized.split('/');
+    if (parts.length === 1 || (parts.length === 2 && parts[1] === '')) {
+      normalized += '/';
+    }
+  }
+  return normalized;
+}
+
+/**
+ * Normalize a pathname by removing trailing slashes
+ * @param {string} pathname - The pathname to normalize
+ * @returns {string} The normalized pathname
+ */
+function normalizePathname(pathname) {
+  if (!pathname || typeof pathname !== 'string') return pathname;
+  if (pathname === '/') return '/';
+  return pathname.replace(/\/+$/, '');
+}
+
+/**
+ * Check if a URL matches any of the filter URLs by comparing pathnames
+ * @param {string} url - URL to check (format: https://domain.com/path)
+ * @param {string[]} filterUrls - Array of filter URLs (format: domain.com/path)
+ * @returns {boolean} True if URL matches any filter URL, false if any URL is invalid
+ */
+function urlMatchesFilter(url, filterUrls) {
+  if (!filterUrls || filterUrls.length === 0) return true;
+  try {
+    // Normalize the input URL
+    const normalizedInputUrl = normalizeUrl(url);
+    const normalizedUrl = prependSchema(normalizedInputUrl);
+    const urlPath = normalizePathname(new URL(normalizedUrl).pathname);
+    return filterUrls.some((filterUrl) => {
+      try {
+        // Normalize each filter URL
+        const normalizedInputFilterUrl = normalizeUrl(filterUrl);
+        const normalizedFilterUrl = prependSchema(normalizedInputFilterUrl);
+        const filterPath = normalizePathname(new URL(normalizedFilterUrl).pathname);
+        return urlPath === filterPath;
+      } catch (error) {
+        // If any filter URL is invalid, skip it and continue checking others
+        /* eslint-disable-next-line no-console */
+        console.warn(`Invalid filter URL: ${filterUrl}`, error.message);
+        return false;
+      }
+    });
+  } catch (error) {
+    // If the main URL is invalid, return false
+    /* eslint-disable-next-line no-console */
+    console.warn(`Invalid URL: ${url}`, error.message);
+    return false;
+  }
+}
+
 export {
   ensureHttps,
   getSpacecatRequestHeaders,
@@ -182,4 +251,5 @@ export {
   stripTrailingDot,
   stripTrailingSlash,
   stripWWW,
+  urlMatchesFilter,
 };