@adobe/spacecat-shared-rum-api-client 2.0.3 → 2.1.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [@adobe/spacecat-shared-rum-api-client-v2.1.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-rum-api-client-v2.0.3...@adobe/spacecat-shared-rum-api-client-v2.1.0) (2024-06-20)
+
+
+### Features
+
+* adding experiment function for rum bundler APIs ([#264](https://github.com/adobe/spacecat-shared/issues/264)) ([b1a076d](https://github.com/adobe/spacecat-shared/commit/b1a076d0044fe4364951accf5d2aa1a5ae315b7b))
+
 # [@adobe/spacecat-shared-rum-api-client-v2.0.3](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-rum-api-client-v2.0.2...@adobe/spacecat-shared-rum-api-client-v2.0.3) (2024-06-11)
 
 

package/README.md

@@ -133,6 +133,64 @@ An example response:
 
 ```
 
+### experiment
+
+Lists all the experiments for a specified domain within the requested interval. The results are grouped by URL. The output includes all the URLs running the experiment, along with experiment id, variants, number of clicks/convert/formsubmit events per variant/selector and views for each of the variant in the experiment.
+
+
+An example response:
+
+```json
+{
+  "https://www.aem.live/home": [
+    {
+      "experiment": "short-home",
+      "variants": [
+        {
+          "name": "challenger-1",
+          "views": 1300,
+          "click": {
+            ".hero": 100,
+            ".header #navmenu-0": 100,
+            ".roi-calculator .button": 100,
+            ".hero .button": 100
+          },
+          "convert": {},
+          "formsubmit": {}
+        },
+        {
+          "name": "control",
+          "views": 800,
+          "click": {
+            ".hero .button": 100,
+            ".header .button": 200,
+            ".header #navmenu-0": 200
+          },
+          "convert": {},
+          "formsubmit": {}
+        }
+      ]
+    }
+  ],
+
+  "https://www.aem.live/new-exp-page": [
+    {
+      "experiment": "visitor-behavior",
+      "variants": [
+        {
+          "name": "https://www.aem.live/some-other-page",
+          "views": 500,
+          "click": {},
+          "convert": {},
+          "formsubmit": {}
+        }
+      ]
+    }
+  ]
+}
+
+```
+
 ## Linting
 Lint the codebase using:
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-rum-api-client",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "description": "Shared modules of the Spacecat Services - Rum API client",
   "type": "module",
   "main": "src/index.js",
@@ -40,9 +40,9 @@
   },
   "devDependencies": {
     "chai": "4.4.1",
-    "chai-as-promised": "7.1.2",
+    "chai-as-promised": "8.0.0",
     "nock": "13.5.4",
-    "sinon": "17.0.2",
+    "sinon": "18.0.0",
     "sinon-chai": "3.7.0",
     "typescript": "5.4.5"
   }

package/src/functions/experiment.js

@@ -0,0 +1,83 @@
+/*
+ * Copyright 2024 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+const EXPERIMENT_CHECKPOINT = ['experiment'];
+const METRIC_CHECKPOINTS = ['click', 'convert', 'formsubmit'];
+const CHECKPOINTS = [...EXPERIMENT_CHECKPOINT, ...METRIC_CHECKPOINTS];
+
+function toClassName(name) {
+  return typeof name === 'string'
+    ? name.toLowerCase().replace(/[^0-9a-z]/gi, '-').replace(/-+/g, '-').replace(/^-|-$/g, '')
+    : '';
+}
+
+function getOrCreateExperimentObject(urlInsights, experimentName) {
+  let experimentObject = urlInsights.find((e) => e.experiment === toClassName(experimentName));
+  if (!experimentObject) {
+    experimentObject = {
+      experiment: toClassName(experimentName),
+      variants: [],
+    };
+    urlInsights.push(experimentObject);
+  }
+  return experimentObject;
+}
+
+function getOrCreateVariantObject(variants, variantName) {
+  let variantObject = variants.find((v) => v.name === variantName);
+  if (!variantObject) {
+    variantObject = {
+      name: variantName,
+      views: 0,
+      click: {},
+      convert: {},
+      formsubmit: {},
+    };
+    variants.push(variantObject);
+  }
+  return variantObject;
+}
+
+function handler(bundles) {
+  const experimentInsights = {};
+  for (const bundle of bundles) {
+    const experimentEvent = bundle.events.find((e) => e.checkpoint === 'experiment');
+    if (experimentEvent) {
+      const { url, weight } = bundle;
+      if (!experimentInsights[url]) {
+        experimentInsights[url] = [];
+      }
+      const experimentName = experimentEvent.source;
+      const variantName = experimentEvent.target;
+      const experimentObject = getOrCreateExperimentObject(experimentInsights[url], experimentName);
+      const variantObject = getOrCreateVariantObject(experimentObject.variants, variantName);
+      variantObject.views += weight;
+
+      for (const event of bundle.events) {
+        if (METRIC_CHECKPOINTS.includes(event.checkpoint)) {
+          const { source, checkpoint } = event;
+          if (!variantObject[checkpoint][source]) {
+            variantObject[checkpoint][source] = weight;
+          } else {
+            variantObject[checkpoint][source] += weight;
+          }
+        }
+      }
+    }
+  }
+  return experimentInsights;
+}
+
+export default {
+  handler,
+  checkpoints: CHECKPOINTS,
+};

package/src/index.js

@@ -12,10 +12,12 @@
 import { fetchBundles } from './common/rum-bundler-client.js';
 import notfound from './functions/404.js';
 import cwv from './functions/cwv.js';
+import experiment from './functions/experiment.js';
 
 const HANDLERS = {
   404: notfound,
   cwv,
+  experiment,
 };
 
 export default class RUMAPIClient {