@adobe/spacecat-shared-utils 1.38.5 → 1.39.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [@adobe/spacecat-shared-utils-v1.39.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-utils-v1.38.6...@adobe/spacecat-shared-utils-v1.39.0) (2025-06-12)
+
+
+### Features
+
+* introduce isValidHelixPreviewUrl in context of preflight audits ([#798](https://github.com/adobe/spacecat-shared/issues/798)) ([9e3fdd5](https://github.com/adobe/spacecat-shared/commit/9e3fdd5887e5b02e5a9248b4732f00f4bfa84f81))
+
+# [@adobe/spacecat-shared-utils-v1.38.6](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-utils-v1.38.5...@adobe/spacecat-shared-utils-v1.38.6) (2025-06-07)
+
+
+### Bug Fixes
+
+* **deps:** update external fixes ([#794](https://github.com/adobe/spacecat-shared/issues/794)) ([756cc67](https://github.com/adobe/spacecat-shared/commit/756cc67513540b0fc69ead1b90345891fef64793))
+
 # [@adobe/spacecat-shared-utils-v1.38.5](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-utils-v1.38.4...@adobe/spacecat-shared-utils-v1.38.5) (2025-05-31)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-utils",
-  "version": "1.38.5",
+  "version": "1.39.0",
   "description": "Shared modules of the Spacecat Services - utils",
   "type": "module",
   "engines": {
@@ -46,9 +46,9 @@
   },
   "dependencies": {
     "@adobe/fetch": "4.2.2",
-    "@aws-sdk/client-s3": "3.821.0",
-    "@aws-sdk/client-secrets-manager": "3.821.0",
-    "@aws-sdk/client-sqs": "3.821.0",
+    "@aws-sdk/client-s3": "3.826.0",
+    "@aws-sdk/client-secrets-manager": "3.826.0",
+    "@aws-sdk/client-sqs": "3.826.0",
     "@json2csv/plainjs": "7.0.6",
     "aws-xray-sdk": "3.10.3",
     "uuid": "11.1.0"

package/src/functions.js

@@ -261,6 +261,52 @@ function isValidIMSOrgId(imsOrgId) {
   return IMS_ORG_ID_REGEX.test(imsOrgId);
 }
 
+/**
+ * Validates whether the given string is a valid Helix preview URL.
+ * Preview URLs have the format: https://ref--site--owner.domain
+ * where domain is typically .hlx.page, .aem.page, .hlx.live, etc.
+ *
+ * @param {string} urlString - The string to validate.
+ * @returns {boolean} True if the given string is a valid Helix preview URL.
+ */
+function isValidHelixPreviewUrl(urlString) {
+  try {
+    const url = new URL(urlString);
+    if (url.protocol !== 'https:') {
+      return false;
+    }
+
+    const parts = url.hostname.split('.');
+    if (parts.length < 2) {
+      return false;
+    }
+
+    // making 3 parts: ref--site--owner
+    const subdomain = parts[0];
+    const subdomainParts = subdomain.split('--');
+
+    if (subdomainParts.length !== 3) {
+      return false;
+    }
+
+    if (subdomainParts.some((part) => !part || part.trim() === '')) {
+      return false;
+    }
+
+    const domain = parts.slice(1).join('.');
+    const validDomains = [
+      'hlx.page',
+      'hlx.live',
+      'aem.page',
+      'aem.live',
+    ];
+
+    return validDomains.includes(domain);
+  } catch {
+    return false;
+  }
+}
+
 export {
   arrayEquals,
   dateAfterDays,
@@ -280,5 +326,6 @@ export {
   isValidUrl,
   isValidUUID,
   isValidIMSOrgId,
+  isValidHelixPreviewUrl,
   toBoolean,
 };

package/src/index.js

@@ -29,6 +29,7 @@ export {
   isValidUrl,
   isValidUUID,
   isValidIMSOrgId,
+  isValidHelixPreviewUrl,
   toBoolean,
 } from './functions.js';