@kubesense/kubesense-browser-rum-core 1.7.0 → 2.0.0-beta.1

package/cjs/domain/getSelectorFromElement.js

@@ -1,218 +1,226 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.STABLE_ATTRIBUTES = void 0;
-exports.getSelectorFromElement = getSelectorFromElement;
-exports.isSelectorUniqueAmongSiblings = isSelectorUniqueAmongSiblings;
-const actionNameConstants_1 = require("./action/actionNameConstants");
+const require_htmlDomUtils = require("../browser/htmlDomUtils.js");
+const require_actionNameConstants = require("./action/actionNameConstants.js");
+//#region src/domain/getSelectorFromElement.ts
+/**
+* Marker used to indicate shadow DOM boundaries in selectors.
+* Named after the deprecated Shadow DOM v0 '::shadow' pseudo-element which served the same
+* purpose of marking entry into a shadow root.
+* Note: This is NOT a valid CSS selector, it's an internal marker that requires custom
+* parsing logic.
+*/
+const SHADOW_DOM_MARKER = "::shadow ";
 /**
- * Stable attributes are attributes that are commonly used to identify parts of a UI (ex:
- * component). Those attribute values should not be generated randomly (hardcoded most of the time)
- * and stay the same across deploys. They are not necessarily unique across the document.
- */
-exports.STABLE_ATTRIBUTES = [
-    actionNameConstants_1.DEFAULT_PROGRAMMATIC_ACTION_NAME_ATTRIBUTE,
-    // Common test attributes (list provided by google recorder)
-    'data-testid',
-    'data-test',
-    'data-qa',
-    'data-cy',
-    'data-test-id',
-    'data-qa-id',
-    'data-testing',
-    // FullStory decorator attributes:
-    'data-component',
-    'data-element',
-    'data-source-file',
+* Stable attributes are attributes that are commonly used to identify parts of a UI (ex:
+* component). Those attribute values should not be generated randomly (hardcoded most of the time)
+* and stay the same across deploys. They are not necessarily unique across the document.
+*/
+const STABLE_ATTRIBUTES = [
+	require_actionNameConstants.DEFAULT_PROGRAMMATIC_ACTION_NAME_ATTRIBUTE,
+	"data-testid",
+	"data-test",
+	"data-qa",
+	"data-cy",
+	"data-test-id",
+	"data-qa-id",
+	"data-testing",
+	"data-component",
+	"data-element",
+	"data-source-file"
 ];
-// Selectors to use if they target a single element on the whole document. Those selectors are
-// considered as "stable" and uniquely identify an element regardless of the page state. If we find
-// one, we should consider the selector "complete" and stop iterating over ancestors.
 const GLOBALLY_UNIQUE_SELECTOR_GETTERS = [getStableAttributeSelector, getIDSelector];
-// Selectors to use if they target a single element among an element descendants. Those selectors
-// are more brittle than "globally unique" selectors and should be combined with ancestor selectors
-// to improve specificity.
 const UNIQUE_AMONG_CHILDREN_SELECTOR_GETTERS = [
-    getStableAttributeSelector,
-    getClassSelector,
-    getTagNameSelector,
+	getStableAttributeSelector,
+	getClassSelector,
+	getTagNameSelector
 ];
 function getSelectorFromElement(targetElement, actionNameAttribute) {
-    if (!targetElement.isConnected) {
-        // We cannot compute a selector for a detached element, as we don't have access to all of its
-        // parents, and we cannot determine if it's unique in the document.
-        return;
-    }
-    let targetElementSelector;
-    let currentElement = targetElement;
-    while (currentElement && currentElement.nodeName !== 'HTML') {
-        const globallyUniqueSelector = findSelector(currentElement, GLOBALLY_UNIQUE_SELECTOR_GETTERS, isSelectorUniqueGlobally, actionNameAttribute, targetElementSelector);
-        if (globallyUniqueSelector) {
-            return globallyUniqueSelector;
-        }
-        const uniqueSelectorAmongChildren = findSelector(currentElement, UNIQUE_AMONG_CHILDREN_SELECTOR_GETTERS, isSelectorUniqueAmongSiblings, actionNameAttribute, targetElementSelector);
-        targetElementSelector =
-            uniqueSelectorAmongChildren || combineSelector(getPositionSelector(currentElement), targetElementSelector);
-        currentElement = currentElement.parentElement;
-    }
-    return targetElementSelector;
+	if (!targetElement.isConnected) return;
+	const subtrees = getAllSubtreeTargets(targetElement);
+	const selectorParts = [];
+	for (const { rootNode, target } of subtrees) {
+		const selector = getSelectorFromElementWithinSubtree(target, rootNode, actionNameAttribute);
+		if (!selector) return;
+		selectorParts.push(selector);
+	}
+	return selectorParts.join(SHADOW_DOM_MARKER);
+}
+/**
+* Returns all (rootNode, target) pairs from the document down to the element.
+*/
+function getAllSubtreeTargets(element) {
+	const result = [];
+	let currentTarget = element;
+	while (currentTarget) {
+		const rootNode = currentTarget.getRootNode();
+		result.push({
+			rootNode,
+			target: currentTarget
+		});
+		if (require_htmlDomUtils.isNodeShadowRoot(rootNode)) currentTarget = rootNode.host;
+		else break;
+	}
+	return result.reverse();
+}
+/**
+* Computes a CSS selector for an element within a specific subtree (document or shadow root).
+*/
+function getSelectorFromElementWithinSubtree(targetElement, rootNode, actionNameAttribute) {
+	let currentSelector;
+	let currentElement = targetElement;
+	while (currentElement && currentElement.nodeName !== "HTML") {
+		const globallyUniqueSelector = findSelector(currentElement, rootNode, GLOBALLY_UNIQUE_SELECTOR_GETTERS, isSelectorUniqueWithinRoot, actionNameAttribute, currentSelector);
+		if (globallyUniqueSelector) return combineSelector(globallyUniqueSelector, currentSelector);
+		currentSelector = combineSelector(findSelector(currentElement, rootNode, UNIQUE_AMONG_CHILDREN_SELECTOR_GETTERS, isSelectorUniqueAmongSiblings, actionNameAttribute, currentSelector) || getPositionSelector(currentElement), currentSelector);
+		currentElement = currentElement.parentElement;
+	}
+	return currentSelector;
 }
 function isGeneratedValue(value) {
-    // To compute the "URL path group", the backend replaces every URL path parts as a question mark
-    // if it thinks the part is an identifier. The condition it uses is to checks whether a digit is
-    // present.
-    //
-    // Here, we use the same strategy: if the value contains a digit, we consider it generated. This
-    // strategy might be a bit naive and fail in some cases, but there are many fallbacks to generate
-    // CSS selectors so it should be fine most of the time.
-    return /[0-9]/.test(value);
+	return /[0-9]/.test(value);
 }
 function getIDSelector(element) {
-    if (element.id && !isGeneratedValue(element.id)) {
-        return `#${CSS.escape(element.id)}`;
-    }
+	if (element.id && !isGeneratedValue(element.id)) return `#${CSS.escape(element.id)}`;
 }
 function getClassSelector(element) {
-    if (element.tagName === 'BODY') {
-        return;
-    }
-    const classList = element.classList;
-    for (let i = 0; i < classList.length; i += 1) {
-        const className = classList[i];
-        if (isGeneratedValue(className)) {
-            continue;
-        }
-        return `${CSS.escape(element.tagName)}.${CSS.escape(className)}`;
-    }
+	if (element.tagName === "BODY") return;
+	const classList = element.classList;
+	for (let i = 0; i < classList.length; i += 1) {
+		const className = classList[i];
+		if (isGeneratedValue(className)) continue;
+		return `${CSS.escape(element.tagName)}.${CSS.escape(className)}`;
+	}
 }
 function getTagNameSelector(element) {
-    return CSS.escape(element.tagName);
+	return CSS.escape(element.tagName);
 }
 function getStableAttributeSelector(element, actionNameAttribute) {
-    if (actionNameAttribute) {
-        const selector = getAttributeSelector(actionNameAttribute);
-        if (selector) {
-            return selector;
-        }
-    }
-    for (const attributeName of exports.STABLE_ATTRIBUTES) {
-        const selector = getAttributeSelector(attributeName);
-        if (selector) {
-            return selector;
-        }
-    }
-    function getAttributeSelector(attributeName) {
-        if (element.hasAttribute(attributeName)) {
-            return `${CSS.escape(element.tagName)}[${attributeName}="${CSS.escape(element.getAttribute(attributeName))}"]`;
-        }
-    }
+	if (actionNameAttribute) {
+		const selector = getAttributeSelector(actionNameAttribute);
+		if (selector) return selector;
+	}
+	for (const attributeName of STABLE_ATTRIBUTES) {
+		const selector = getAttributeSelector(attributeName);
+		if (selector) return selector;
+	}
+	function getAttributeSelector(attributeName) {
+		if (element.hasAttribute(attributeName)) return `${CSS.escape(element.tagName)}${getAttributeValueSelector(attributeName, element.getAttribute(attributeName))}`;
+	}
+}
+function getAttributeValueSelector(attributeName, attributeValue) {
+	return `[${attributeName}="${CSS.escape(attributeValue)}"]`;
 }
 function getPositionSelector(element) {
-    let sibling = element.parentElement.firstElementChild;
-    let elementIndex = 1;
-    while (sibling && sibling !== element) {
-        if (sibling.tagName === element.tagName) {
-            elementIndex += 1;
-        }
-        sibling = sibling.nextElementSibling;
-    }
-    return `${CSS.escape(element.tagName)}:nth-of-type(${elementIndex})`;
+	const nthOfType = getNthOfTypeSelector(element);
+	return `${CSS.escape(element.tagName)}:nth-of-type(${nthOfType})`;
+}
+function getNthOfTypeSelector(element) {
+	let sibling = element.parentNode.firstElementChild;
+	let nthOfType = 1;
+	while (sibling && sibling !== element) {
+		if (sibling.tagName === element.tagName) nthOfType += 1;
+		sibling = sibling.nextElementSibling;
+	}
+	return nthOfType;
 }
-function findSelector(element, selectorGetters, predicate, actionNameAttribute, childSelector) {
-    for (const selectorGetter of selectorGetters) {
-        const elementSelector = selectorGetter(element, actionNameAttribute);
-        if (!elementSelector) {
-            continue;
-        }
-        if (predicate(element, elementSelector, childSelector)) {
-            return combineSelector(elementSelector, childSelector);
-        }
-    }
+function findSelector(element, rootNode, selectorGetters, predicate, actionNameAttribute, childSelector) {
+	for (const selectorGetter of selectorGetters) {
+		const elementSelector = selectorGetter(element, actionNameAttribute);
+		if (!elementSelector) continue;
+		if (predicate(element, rootNode, elementSelector, childSelector)) return elementSelector;
+	}
 }
 /**
- * Check whether the selector is unique among the whole document.
- */
-function isSelectorUniqueGlobally(element, elementSelector, childSelector) {
-    return element.ownerDocument.querySelectorAll(combineSelector(elementSelector, childSelector)).length === 1;
+* Check whether the selector is unique within the root node (document or shadow root).
+*/
+function isSelectorUniqueWithinRoot(_element, rootNode, elementSelector, childSelector) {
+	return rootNode.querySelectorAll(combineSelector(elementSelector, childSelector)).length === 1;
 }
 /**
- * Check whether the selector is unique among the element siblings. In other words, it returns true
- * if "ELEMENT_PARENT > CHILD_SELECTOR" returns a single element.
- *
- * @param {Element} currentElement - the element being considered while iterating over the target
- * element ancestors.
- *
- * @param {string} currentElementSelector - a selector that matches the current element. That
- * selector is not a composed selector (i.e. it might be a single tag name, class name...).
- *
- * @param {string|undefined} childSelector - child selector is a selector that targets a descendant
- * of the current element. When undefined, the current element is the target element.
- *
- * # Scope selector usage
- *
- * When composed together, the final selector will be joined with `>` operators to make sure we
- * target direct descendants at each level. In this function, we'll use `querySelector` to check if
- * a selector matches descendants of the current element. But by default, the query selector match
- * elements at any level. Example:
- *
- * ```html
- * <main>
- *   <div>
- *     <span></span>
- *   </div>
- *   <marquee>
- *     <div>
- *       <span></span>
- *     </div>
- *   </marquee>
- * </main>
- * ```
- *
- * `sibling.querySelector('DIV > SPAN')` will match both span elements, so we would consider the
- * selector to be not unique, even if it is unique when we'll compose it with the parent with a `>`
- * operator (`MAIN > DIV > SPAN`).
- *
- * To avoid this, we can use the `:scope` selector to make sure the selector starts from the current
- * sibling (i.e. `sibling.querySelector('DIV:scope > SPAN')` will only match the first span).
- *
- * [1]: https://developer.mozilla.org/fr/docs/Web/CSS/:scope
- *
- * # Performance considerations
- *
- * We compute selectors in performance-critical operations (ex: during a click), so we need to make
- * sure the function is as fast as possible. We observed that naively using `querySelectorAll` to
- * check if the selector matches more than 1 element is quite expensive, so we want to avoid it.
- *
- * Because we are iterating the DOM upward and we use that function at every level, we know the
- * child selector is already unique among the current element children, so we don't need to check
- * for the current element subtree.
- *
- * Instead, we can focus on the current element siblings. If we find a single element matching the
- * selector within a sibling, we know that it's not unique. This allows us to use `querySelector`
- * (or `matches`, when the current element is the target element) instead of `querySelectorAll`.
- */
-function isSelectorUniqueAmongSiblings(currentElement, currentElementSelector, childSelector) {
-    let isSiblingMatching;
-    if (childSelector === undefined) {
-        // If the child selector is undefined (meaning `currentElement` is the target element, not one
-        // of its ancestor), we need to use `matches` to check if the sibling is matching the selector,
-        // as `querySelector` only returns a descendant of the element.
-        isSiblingMatching = (sibling) => sibling.matches(currentElementSelector);
-    }
-    else {
-        const scopedSelector = combineSelector(`${currentElementSelector}:scope`, childSelector);
-        isSiblingMatching = (sibling) => sibling.querySelector(scopedSelector) !== null;
-    }
-    const parent = currentElement.parentElement;
-    let sibling = parent.firstElementChild;
-    while (sibling) {
-        if (sibling !== currentElement && isSiblingMatching(sibling)) {
-            return false;
-        }
-        sibling = sibling.nextElementSibling;
-    }
-    return true;
+* Check whether the selector is unique among the element siblings. In other words, it returns true
+* if "ELEMENT_PARENT > CHILD_SELECTOR" returns a single element.
+*
+* @param currentElement - the element being considered while iterating over the target
+* element ancestors.
+* @param _rootNode - the root node (document or shadow root) - unused but required for predicate signature.
+* @param currentElementSelector - a selector that matches the current element. That
+* selector is not a composed selector (i.e. it might be a single tag name, class name...).
+* @param childSelector - child selector is a selector that targets a descendant
+* of the current element. When undefined, the current element is the target element.
+*
+* # Scope selector usage
+*
+* When composed together, the final selector will be joined with `>` operators to make sure we
+* target direct descendants at each level. In this function, we'll use `querySelector` to check if
+* a selector matches descendants of the current element. But by default, the query selector match
+* elements at any level. Example:
+*
+* ```html
+* <main>
+*   <div>
+*     <span></span>
+*   </div>
+*   <marquee>
+*     <div>
+*       <span></span>
+*     </div>
+*   </marquee>
+* </main>
+* ```
+*
+* `sibling.querySelector('DIV > SPAN')` will match both span elements, so we would consider the
+* selector to be not unique, even if it is unique when we'll compose it with the parent with a `>`
+* operator (`MAIN > DIV > SPAN`).
+*
+* To avoid this, we can use the `:scope` selector to make sure the selector starts from the current
+* sibling (i.e. `sibling.querySelector('DIV:scope > SPAN')` will only match the first span).
+*
+* [1]: https://developer.mozilla.org/fr/docs/Web/CSS/:scope
+*
+* # Performance considerations
+*
+* We compute selectors in performance-critical operations (ex: during a click), so we need to make
+* sure the function is as fast as possible. We observed that naively using `querySelectorAll` to
+* check if the selector matches more than 1 element is quite expensive, so we want to avoid it.
+*
+* Because we are iterating the DOM upward and we use that function at every level, we know the
+* child selector is already unique among the current element children, so we don't need to check
+* for the current element subtree.
+*
+* Instead, we can focus on the current element siblings. If we find a single element matching the
+* selector within a sibling, we know that it's not unique. This allows us to use `querySelector`
+* (or `matches`, when the current element is the target element) instead of `querySelectorAll`.
+*/
+function isSelectorUniqueAmongSiblings(currentElement, _rootNode, currentElementSelector, childSelector) {
+	let isSiblingMatching;
+	if (childSelector === void 0) isSiblingMatching = (sibling) => sibling.matches(currentElementSelector);
+	else {
+		const scopedSelector = combineSelector(`${currentElementSelector}:scope`, childSelector);
+		isSiblingMatching = (sibling) => sibling.querySelector(scopedSelector) !== null;
+	}
+	let sibling = currentElement.previousElementSibling;
+	while (sibling) {
+		if (isSiblingMatching(sibling)) return false;
+		sibling = sibling.previousElementSibling;
+	}
+	sibling = currentElement.nextElementSibling;
+	while (sibling) {
+		if (isSiblingMatching(sibling)) return false;
+		sibling = sibling.nextElementSibling;
+	}
+	return true;
 }
 function combineSelector(parent, child) {
-    return child ? `${parent}>${child}` : parent;
+	return child ? `${parent}>${child}` : parent;
 }
+//#endregion
+exports.SHADOW_DOM_MARKER = SHADOW_DOM_MARKER;
+exports.STABLE_ATTRIBUTES = STABLE_ATTRIBUTES;
+exports.getAttributeValueSelector = getAttributeValueSelector;
+exports.getIDSelector = getIDSelector;
+exports.getNthOfTypeSelector = getNthOfTypeSelector;
+exports.getSelectorFromElement = getSelectorFromElement;
+exports.getTagNameSelector = getTagNameSelector;
+exports.isGeneratedValue = isGeneratedValue;
+exports.isSelectorUniqueAmongSiblings = isSelectorUniqueAmongSiblings;
+
 //# sourceMappingURL=getSelectorFromElement.js.map

package/cjs/domain/getSelectorFromElement.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSelectorFromElement.js","sourceRoot":"","sources":["../../src/domain/getSelectorFromElement.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"getSelectorFromElement.js","names":["DEFAULT_PROGRAMMATIC_ACTION_NAME_ATTRIBUTE","isNodeShadowRoot"],"sources":["../../src/domain/getSelectorFromElement.ts"],"sourcesContent":["import { isNodeShadowRoot } from '../browser/htmlDomUtils'\nimport { DEFAULT_PROGRAMMATIC_ACTION_NAME_ATTRIBUTE } from './action/actionNameConstants'\n\n/**\n * Marker used to indicate shadow DOM boundaries in selectors.\n * Named after the deprecated Shadow DOM v0 '::shadow' pseudo-element which served the same\n * purpose of marking entry into a shadow root.\n * Note: This is NOT a valid CSS selector, it's an internal marker that requires custom\n * parsing logic.\n */\nexport const SHADOW_DOM_MARKER = '::shadow '\n\n/**\n * Stable attributes are attributes that are commonly used to identify parts of a UI (ex:\n * component). Those attribute values should not be generated randomly (hardcoded most of the time)\n * and stay the same across deploys. They are not necessarily unique across the document.\n */\nexport const STABLE_ATTRIBUTES = [\n  DEFAULT_PROGRAMMATIC_ACTION_NAME_ATTRIBUTE,\n  // Common test attributes (list provided by google recorder)\n  'data-testid',\n  'data-test',\n  'data-qa',\n  'data-cy',\n  'data-test-id',\n  'data-qa-id',\n  'data-testing',\n  // FullStory decorator attributes:\n  'data-component',\n  'data-element',\n  'data-source-file',\n]\n\ntype SelectorGetter = (element: Element, actionNameAttribute: string | undefined) => string | undefined\n\n// Selectors to use if they target a single element on the whole document. Those selectors are\n// considered as \"stable\" and uniquely identify an element regardless of the page state. If we find\n// one, we should consider the selector \"complete\" and stop iterating over ancestors.\nconst GLOBALLY_UNIQUE_SELECTOR_GETTERS: SelectorGetter[] = [getStableAttributeSelector, getIDSelector]\n\n// Selectors to use if they target a single element among an element descendants. Those selectors\n// are more brittle than \"globally unique\" selectors and should be combined with ancestor selectors\n// to improve specificity.\nconst UNIQUE_AMONG_CHILDREN_SELECTOR_GETTERS: SelectorGetter[] = [\n  getStableAttributeSelector,\n  getClassSelector,\n  getTagNameSelector,\n]\n\ninterface SubtreeTarget {\n  rootNode: Document | ShadowRoot\n  target: Element\n}\n\nexport function getSelectorFromElement(\n  targetElement: Element,\n  actionNameAttribute: string | undefined\n): string | undefined {\n  if (!targetElement.isConnected) {\n    // We cannot compute a selector for a detached element, as we don't have access to all of its\n    // parents, and we cannot determine if it's unique in the document.\n    return\n  }\n\n  const subtrees = getAllSubtreeTargets(targetElement)\n  const selectorParts: string[] = []\n\n  for (const { rootNode, target } of subtrees) {\n    const selector = getSelectorFromElementWithinSubtree(target, rootNode, actionNameAttribute)\n    if (!selector) {\n      return undefined\n    }\n    selectorParts.push(selector)\n  }\n\n  return selectorParts.join(SHADOW_DOM_MARKER)\n}\n\n/**\n * Returns all (rootNode, target) pairs from the document down to the element.\n */\nfunction getAllSubtreeTargets(element: Element): SubtreeTarget[] {\n  const result: SubtreeTarget[] = []\n  let currentTarget: Element | undefined = element\n\n  while (currentTarget) {\n    const rootNode = currentTarget.getRootNode() as Document | ShadowRoot\n    result.push({ rootNode, target: currentTarget })\n\n    if (isNodeShadowRoot(rootNode)) {\n      currentTarget = rootNode.host\n    } else {\n      break\n    }\n  }\n\n  return result.reverse()\n}\n\n/**\n * Computes a CSS selector for an element within a specific subtree (document or shadow root).\n */\nfunction getSelectorFromElementWithinSubtree(\n  targetElement: Element,\n  rootNode: Document | ShadowRoot,\n  actionNameAttribute: string | undefined\n): string | undefined {\n  let currentSelector: string | undefined\n  let currentElement: Element | null = targetElement\n\n  while (currentElement && currentElement.nodeName !== 'HTML') {\n    const globallyUniqueSelector = findSelector(\n      currentElement,\n      rootNode,\n      GLOBALLY_UNIQUE_SELECTOR_GETTERS,\n      isSelectorUniqueWithinRoot,\n      actionNameAttribute,\n      currentSelector\n    )\n    if (globallyUniqueSelector) {\n      return combineSelector(globallyUniqueSelector, currentSelector)\n    }\n\n    const uniqueSelectorAmongChildren = findSelector(\n      currentElement,\n      rootNode,\n      UNIQUE_AMONG_CHILDREN_SELECTOR_GETTERS,\n      isSelectorUniqueAmongSiblings,\n      actionNameAttribute,\n      currentSelector\n    )\n\n    const elementSelector = uniqueSelectorAmongChildren || getPositionSelector(currentElement)\n    currentSelector = combineSelector(elementSelector, currentSelector)\n\n    currentElement = currentElement.parentElement\n  }\n\n  return currentSelector\n}\n\nexport function isGeneratedValue(value: string) {\n  // To compute the \"URL path group\", the backend replaces every URL path parts as a question mark\n  // if it thinks the part is an identifier. The condition it uses is to checks whether a digit is\n  // present.\n  //\n  // Here, we use the same strategy: if the value contains a digit, we consider it generated. This\n  // strategy might be a bit naive and fail in some cases, but there are many fallbacks to generate\n  // CSS selectors so it should be fine most of the time.\n  return /[0-9]/.test(value)\n}\n\nexport function getIDSelector(element: Element): string | undefined {\n  if (element.id && !isGeneratedValue(element.id)) {\n    return `#${CSS.escape(element.id)}`\n  }\n}\n\nfunction getClassSelector(element: Element): string | undefined {\n  if (element.tagName === 'BODY') {\n    return\n  }\n  const classList = element.classList\n  for (let i = 0; i < classList.length; i += 1) {\n    const className = classList[i]\n    if (isGeneratedValue(className)) {\n      continue\n    }\n\n    return `${CSS.escape(element.tagName)}.${CSS.escape(className)}`\n  }\n}\n\nexport function getTagNameSelector(element: Element): string {\n  return CSS.escape(element.tagName)\n}\n\nfunction getStableAttributeSelector(element: Element, actionNameAttribute: string | undefined): string | undefined {\n  if (actionNameAttribute) {\n    const selector = getAttributeSelector(actionNameAttribute)\n    if (selector) {\n      return selector\n    }\n  }\n\n  for (const attributeName of STABLE_ATTRIBUTES) {\n    const selector = getAttributeSelector(attributeName)\n    if (selector) {\n      return selector\n    }\n  }\n\n  function getAttributeSelector(attributeName: string) {\n    if (element.hasAttribute(attributeName)) {\n      return `${CSS.escape(element.tagName)}${getAttributeValueSelector(attributeName, element.getAttribute(attributeName)!)}`\n    }\n  }\n}\n\nexport function getAttributeValueSelector(attributeName: string, attributeValue: string) {\n  return `[${attributeName}=\"${CSS.escape(attributeValue)}\"]`\n}\n\nfunction getPositionSelector(element: Element): string {\n  const nthOfType = getNthOfTypeSelector(element)\n\n  return `${CSS.escape(element.tagName)}:nth-of-type(${nthOfType})`\n}\n\nexport function getNthOfTypeSelector(element: Element): number {\n  const parent = element.parentNode!\n\n  let sibling = parent.firstElementChild\n\n  let nthOfType = 1\n\n  while (sibling && sibling !== element) {\n    if (sibling.tagName === element.tagName) {\n      nthOfType += 1\n    }\n    sibling = sibling.nextElementSibling\n  }\n\n  return nthOfType\n}\n\nfunction findSelector(\n  element: Element,\n  rootNode: Document | ShadowRoot,\n  selectorGetters: SelectorGetter[],\n  predicate: (\n    element: Element,\n    rootNode: Document | ShadowRoot,\n    elementSelector: string,\n    childSelector: string | undefined\n  ) => boolean,\n  actionNameAttribute: string | undefined,\n  childSelector: string | undefined\n) {\n  for (const selectorGetter of selectorGetters) {\n    const elementSelector = selectorGetter(element, actionNameAttribute)\n    if (!elementSelector) {\n      continue\n    }\n    if (predicate(element, rootNode, elementSelector, childSelector)) {\n      return elementSelector\n    }\n  }\n}\n\n/**\n * Check whether the selector is unique within the root node (document or shadow root).\n */\nfunction isSelectorUniqueWithinRoot(\n  _element: Element,\n  rootNode: Document | ShadowRoot,\n  elementSelector: string,\n  childSelector: string | undefined\n): boolean {\n  return rootNode.querySelectorAll(combineSelector(elementSelector, childSelector)).length === 1\n}\n\n/**\n * Check whether the selector is unique among the element siblings. In other words, it returns true\n * if \"ELEMENT_PARENT > CHILD_SELECTOR\" returns a single element.\n *\n * @param currentElement - the element being considered while iterating over the target\n * element ancestors.\n * @param _rootNode - the root node (document or shadow root) - unused but required for predicate signature.\n * @param currentElementSelector - a selector that matches the current element. That\n * selector is not a composed selector (i.e. it might be a single tag name, class name...).\n * @param childSelector - child selector is a selector that targets a descendant\n * of the current element. When undefined, the current element is the target element.\n *\n * # Scope selector usage\n *\n * When composed together, the final selector will be joined with `>` operators to make sure we\n * target direct descendants at each level. In this function, we'll use `querySelector` to check if\n * a selector matches descendants of the current element. But by default, the query selector match\n * elements at any level. Example:\n *\n * ```html\n * <main>\n *   <div>\n *     <span></span>\n *   </div>\n *   <marquee>\n *     <div>\n *       <span></span>\n *     </div>\n *   </marquee>\n * </main>\n * ```\n *\n * `sibling.querySelector('DIV > SPAN')` will match both span elements, so we would consider the\n * selector to be not unique, even if it is unique when we'll compose it with the parent with a `>`\n * operator (`MAIN > DIV > SPAN`).\n *\n * To avoid this, we can use the `:scope` selector to make sure the selector starts from the current\n * sibling (i.e. `sibling.querySelector('DIV:scope > SPAN')` will only match the first span).\n *\n * [1]: https://developer.mozilla.org/fr/docs/Web/CSS/:scope\n *\n * # Performance considerations\n *\n * We compute selectors in performance-critical operations (ex: during a click), so we need to make\n * sure the function is as fast as possible. We observed that naively using `querySelectorAll` to\n * check if the selector matches more than 1 element is quite expensive, so we want to avoid it.\n *\n * Because we are iterating the DOM upward and we use that function at every level, we know the\n * child selector is already unique among the current element children, so we don't need to check\n * for the current element subtree.\n *\n * Instead, we can focus on the current element siblings. If we find a single element matching the\n * selector within a sibling, we know that it's not unique. This allows us to use `querySelector`\n * (or `matches`, when the current element is the target element) instead of `querySelectorAll`.\n */\nexport function isSelectorUniqueAmongSiblings(\n  currentElement: Element,\n  _rootNode: Document | ShadowRoot,\n  currentElementSelector: string,\n  childSelector: string | undefined\n): boolean {\n  let isSiblingMatching: (sibling: Element) => boolean\n\n  if (childSelector === undefined) {\n    // If the child selector is undefined (meaning `currentElement` is the target element, not one\n    // of its ancestor), we need to use `matches` to check if the sibling is matching the selector,\n    // as `querySelector` only returns a descendant of the element.\n    isSiblingMatching = (sibling) => sibling.matches(currentElementSelector)\n  } else {\n    const scopedSelector = combineSelector(`${currentElementSelector}:scope`, childSelector)\n    isSiblingMatching = (sibling) => sibling.querySelector(scopedSelector) !== null\n  }\n\n  // Check siblings by iterating directly through previousElementSibling and nextElementSibling.\n  // This works even when parentElement is null (e.g., when parent is a DocumentFragment).\n\n  // Check previous siblings\n  let sibling = currentElement.previousElementSibling\n  while (sibling) {\n    if (isSiblingMatching(sibling)) {\n      return false\n    }\n    sibling = sibling.previousElementSibling\n  }\n\n  // Check next siblings\n  sibling = currentElement.nextElementSibling\n  while (sibling) {\n    if (isSiblingMatching(sibling)) {\n      return false\n    }\n    sibling = sibling.nextElementSibling\n  }\n\n  return true\n}\n\nfunction combineSelector(parent: string, child: string | undefined): string {\n  return child ? `${parent}>${child}` : parent\n}\n"],"mappings":"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"}

package/cjs/domain/getSessionReplayUrl.d.ts

@@ -1,8 +1,8 @@
+import type { SessionContext } from '@kubesense/kubesense-browser-core';
 import type { RumConfiguration } from './configuration';
 import type { ViewHistoryEntry } from './contexts/viewHistory';
-import type { RumSession } from './rumSessionManager';
 export declare function getSessionReplayUrl(configuration: RumConfiguration, { session, viewContext, errorType, }: {
-    session?: RumSession;
+    session?: SessionContext;
     viewContext?: ViewHistoryEntry;
     errorType?: string;
 }): string;

package/cjs/domain/getSessionReplayUrl.js

@@ -1,34 +1,21 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSessionReplayUrl = getSessionReplayUrl;
-exports.getKubeSenseSiteUrl = getKubeSenseSiteUrl;
-const kubesense_browser_core_1 = require("@kubesense/kubesense-browser-core");
-function getSessionReplayUrl(configuration, { session, viewContext, errorType, }) {
-    const sessionId = session ? session.id : 'no-session-id';
-    const parameters = [];
-    if (errorType !== undefined) {
-        parameters.push(`error-type=${errorType}`);
-    }
-    if (viewContext) {
-        parameters.push(`seed=${viewContext.id}`);
-        parameters.push(`from=${viewContext.startClocks.timeStamp}`);
-    }
-    const origin = getKubeSenseSiteUrl(configuration);
-    const path = `/rum/replay/sessions/${sessionId}`;
-    return `${origin}${path}?${parameters.join('&')}`;
+//#region src/domain/getSessionReplayUrl.ts
+function getSessionReplayUrl(configuration, { session, viewContext, errorType }) {
+	const sessionId = session ? session.id : "no-session-id";
+	const parameters = [];
+	if (errorType !== void 0) parameters.push(`error-type=${errorType}`);
+	if (viewContext) {
+		parameters.push(`seed=${viewContext.id}`);
+		parameters.push(`from=${viewContext.startClocks.timeStamp}`);
+	}
+	return `${getKubeSenseSiteUrl(configuration)}${`/rum/replay/sessions/${sessionId}`}?${parameters.join("&")}`;
 }
 function getKubeSenseSiteUrl(rumConfiguration) {
-    const site = rumConfiguration.kubesenseRumEndpoint;
-    const subdomain = rumConfiguration.subdomain;
-    return `https://${subdomain ? `${subdomain}.` : ''}${site}`;
-}
-function getSiteDefaultSubdomain(configuration) {
-    switch (configuration.kubesenseRumEndpoint) {
-        case kubesense_browser_core_1.INTAKE_SITE_PROD:
-        case kubesense_browser_core_1.INTAKE_SITE_STAGING:
-            return 'staging';
-        default:
-            return undefined;
-    }
+	const site = rumConfiguration.kubesenseRumEndpoint;
+	const subdomain = rumConfiguration.subdomain;
+	return `https://${subdomain ? `${subdomain}.` : ""}${site}`;
 }
+//#endregion
+exports.getKubeSenseSiteUrl = getKubeSenseSiteUrl;
+exports.getSessionReplayUrl = getSessionReplayUrl;
+
 //# sourceMappingURL=getSessionReplayUrl.js.map

package/cjs/domain/getSessionReplayUrl.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSessionReplayUrl.js","sourceRoot":"","sources":["../../src/domain/getSessionReplayUrl.ts"],"names":[],"mappings":";;AAKA,kDAyBC;AAED,kDAIC;AApCD,8EAAyF;AAKzF,SAAgB,mBAAmB,CACjC,aAA+B,EAC/B,EACE,OAAO,EACP,WAAW,EACX,SAAS,GAKV;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAA;IACxD,MAAM,UAAU,GAAa,EAAE,CAAA;IAC/B,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,UAAU,CAAC,IAAI,CAAC,cAAc,SAAS,EAAE,CAAC,CAAA;IAC5C,CAAC;IACD,IAAI,WAAW,EAAE,CAAC;QAChB,UAAU,CAAC,IAAI,CAAC,QAAQ,WAAW,CAAC,EAAE,EAAE,CAAC,CAAA;QACzC,UAAU,CAAC,IAAI,CAAC,QAAQ,WAAW,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,CAAA;IAC9D,CAAC;IAED,MAAM,MAAM,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAA;IACjD,MAAM,IAAI,GAAG,wBAAwB,SAAS,EAAE,CAAA;IAChD,OAAO,GAAG,MAAM,GAAG,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;AACnD,CAAC;AAED,SAAgB,mBAAmB,CAAC,gBAAkC;IACpE,MAAM,IAAI,GAAG,gBAAgB,CAAC,oBAAoB,CAAA;IAClD,MAAM,SAAS,GAAG,gBAAgB,CAAC,SAAS,CAAA;IAC5C,OAAO,WAAW,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAA;AAC7D,CAAC;AAED,SAAS,uBAAuB,CAAC,aAA+B;IAC9D,QAAQ,aAAa,CAAC,oBAAoB,EAAE,CAAC;QAC3C,KAAK,yCAAgB,CAAC;QACtB,KAAK,4CAAmB;YACtB,OAAO,SAAS,CAAA;QAClB;YACE,OAAO,SAAS,CAAA;IACpB,CAAC;AACH,CAAC"}
+{"version":3,"file":"getSessionReplayUrl.js","names":[],"sources":["../../src/domain/getSessionReplayUrl.ts"],"sourcesContent":["import type { SessionContext } from '@kubesense/kubesense-browser-core'\nimport type { RumConfiguration } from './configuration'\nimport type { ViewHistoryEntry } from './contexts/viewHistory'\n\nexport function getSessionReplayUrl(\n  configuration: RumConfiguration,\n  {\n    session,\n    viewContext,\n    errorType,\n  }: {\n    session?: SessionContext\n    viewContext?: ViewHistoryEntry\n    errorType?: string\n  }\n): string {\n  const sessionId = session ? session.id : 'no-session-id'\n  const parameters: string[] = []\n  if (errorType !== undefined) {\n    parameters.push(`error-type=${errorType}`)\n  }\n  if (viewContext) {\n    parameters.push(`seed=${viewContext.id}`)\n    parameters.push(`from=${viewContext.startClocks.timeStamp}`)\n  }\n\n  const origin = getKubeSenseSiteUrl(configuration)\n  const path = `/rum/replay/sessions/${sessionId}`\n  return `${origin}${path}?${parameters.join('&')}`\n}\n\nexport function getKubeSenseSiteUrl(rumConfiguration: RumConfiguration) {\n  // KubeSense installations address the collector host directly, so there is no per-site default\n  // subdomain to derive: only an explicitly configured `subdomain` is prepended.\n  const site = rumConfiguration.kubesenseRumEndpoint\n  const subdomain = rumConfiguration.subdomain\n  return `https://${subdomain ? `${subdomain}.` : ''}${site}`\n}\n"],"mappings":";AAIA,SAAgB,oBACd,eACA,EACE,SACA,aACA,aAMM;CACR,MAAM,YAAY,UAAU,QAAQ,KAAK;CACzC,MAAM,aAAuB,CAAC;CAC9B,IAAI,cAAc,KAAA,GAChB,WAAW,KAAK,cAAc,WAAW;CAE3C,IAAI,aAAa;EACf,WAAW,KAAK,QAAQ,YAAY,IAAI;EACxC,WAAW,KAAK,QAAQ,YAAY,YAAY,WAAW;CAC7D;CAIA,OAAO,GAFQ,oBAAoB,aAEpB,IAAI,wBADkB,YACb,GAAG,WAAW,KAAK,GAAG;AAChD;AAEA,SAAgB,oBAAoB,kBAAoC;CAGtE,MAAM,OAAO,iBAAiB;CAC9B,MAAM,YAAY,iBAAiB;CACnC,OAAO,WAAW,YAAY,GAAG,UAAU,KAAK,KAAK;AACvD"}

package/cjs/domain/hooks.d.ts

@@ -1,23 +1,32 @@
-import type { DISCARDED, Duration, HookNamesAsConst, RecursivePartial, RelativeTime, SKIPPED, TelemetryEvent } from '@kubesense/kubesense-browser-core';
+import type { Duration, RelativeTime } from '@kubesense/kubesense-js-core/time';
+import type { TelemetryEvent } from '@kubesense/kubesense-browser-core';
+import type { Hook } from '@kubesense/kubesense-js-core/assembly';
+import type { RecursivePartial } from '@kubesense/kubesense-js-core/util';
 import type { RumEvent } from '../rumEvent.types';
+import type { RawRumEvent } from '../rawRumEvent.types';
+import type { RumEventDomainContext } from '../domainContext.types';
 export type DefaultRumEventAttributes = RecursivePartial<RumEvent> & {
     type: RumEvent['type'];
 };
 export type DefaultTelemetryEventAttributes = RecursivePartial<TelemetryEvent>;
-export interface HookCallbackMap {
-    [HookNamesAsConst.ASSEMBLE]: (param: {
-        eventType: RumEvent['type'];
-        startTime: RelativeTime;
-        duration?: Duration | undefined;
-    }) => DefaultRumEventAttributes | SKIPPED | DISCARDED;
-    [HookNamesAsConst.ASSEMBLE_TELEMETRY]: (param: {
-        startTime: RelativeTime;
-    }) => DefaultTelemetryEventAttributes | SKIPPED | DISCARDED;
-}
-export type Hooks = ReturnType<typeof createHooks>;
-export declare const createHooks: () => {
-    register<K extends import("@kubesense/kubesense-browser-core").HookNames>(hookName: K, callback: HookCallbackMap[K]): {
-        unregister: () => void;
-    };
-    triggerHook<K extends import("@kubesense/kubesense-browser-core").HookNames>(hookName: K, param: Parameters<HookCallbackMap[K]>[0]): "DISCARDED" | Exclude<ReturnType<HookCallbackMap[K]>, "SKIPPED"> | undefined;
+type DeepReadonly<T> = {
+    readonly [K in keyof T]: DeepReadonly<T[K]>;
 };
+export interface AssembleHookParams {
+    readonly eventType: RumEvent['type'];
+    rawRumEvent: DeepReadonly<RawRumEvent>;
+    domainContext: DeepReadonly<RumEventDomainContext<RawRumEvent['type']>>;
+    readonly startTime: RelativeTime;
+    readonly duration?: Duration | undefined;
+}
+export type AssembleHook = Hook<AssembleHookParams, DefaultRumEventAttributes>;
+export type AssembleTelemetryHook = Hook<{
+    startTime: RelativeTime;
+}, DefaultTelemetryEventAttributes>;
+export interface Hooks {
+    assembleEventDefaults: AssembleHook;
+    assembleTelemetry: AssembleTelemetryHook;
+    assembleEvent: AssembleHook;
+}
+export declare function createHooks(): Hooks;
+export {};

package/cjs/domain/hooks.js

@@ -1,6 +1,13 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createHooks = void 0;
-const kubesense_browser_core_1 = require("@kubesense/kubesense-browser-core");
-exports.createHooks = (kubesense_browser_core_1.abstractHooks);
+let _kubesense_kubesense_js_core_assembly = require("@kubesense/kubesense-js-core/assembly");
+//#region src/domain/hooks.ts
+function createHooks() {
+	return {
+		assembleEventDefaults: (0, _kubesense_kubesense_js_core_assembly.createHook)(),
+		assembleTelemetry: (0, _kubesense_kubesense_js_core_assembly.createHook)(),
+		assembleEvent: (0, _kubesense_kubesense_js_core_assembly.createHook)()
+	};
+}
+//#endregion
+exports.createHooks = createHooks;
+
 //# sourceMappingURL=hooks.js.map