@amplitude/plugin-autocapture-browser 0.9.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Amplitude Analytics
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,83 @@
+<p align="center">
+  <a href="https://amplitude.com" target="_blank" align="center">
+    <img src="https://static.amplitude.com/lightning/46c85bfd91905de8047f1ee65c7c93d6fa9ee6ea/static/media/amplitude-logo-with-text.4fb9e463.svg" width="280">
+  </a>
+  <br />
+</p>
+
+# @amplitude/plugin-autocapture-browser (beta)
+**This plugin is in beta at the moment, naming and interface might change in the future.**
+
+Browser SDK plugin for autocapture.
+
+## Installation
+
+This package is published on NPM registry and is available to be installed using npm and yarn.
+
+```sh
+# npm
+npm install @amplitude/plugin-autocapture-browser@beta
+
+# yarn
+yarn add @amplitude/plugin-autocapture-browser@beta
+```
+
+## Usage
+
+This plugin works on top of the Amplitude Browser SDK, generating auto-tracked events and sending to Amplitude.
+
+To use this plugin, you need to install `@amplitude/analytics-browser` version `v1.9.1` or later.
+
+### 1. Import Amplitude packages
+
+* `@amplitude/analytics-browser`
+* `@amplitude/plugin-autocapture-browser`
+
+```typescript
+import * as amplitude from '@amplitude/analytics-browser';
+import { autocapturePlugin } from '@amplitude/plugin-autocapture-browser';
+```
+
+### 2. Instantiate the plugin
+
+The plugin accepts 1 optional parameter, which is an `Object` to configure the allowed tracking options.
+
+```typescript
+const plugin = autocapturePlugin({
+  cssSelectorAllowlist: [
+    '.amp-tracking',
+    '[amp-tracking]'
+  ],
+  pageUrlAllowlist: [
+    'https://amplitude.com',
+    new RegExp('https://amplitude.com/blog/*')
+  ],
+});
+```
+
+Examples:
+- The above `cssSelectorAllowlist` will only allow tracking elements like:
+    - `<button amp-tracking>Click</button>`
+    - `<a class="amp-tracking">Link</a>`
+- The above `pageUrlAllowlist` will only allow the elements on URL "https://amplitude.com" or any URL matching the "https://amplitude.com/blog/*" to be tracked
+
+#### Options
+
+|Name|Type|Default|Description|
+|-|-|-|-|
+|`cssSelectorAllowlist`|`string[]`|`['a', 'button', 'input', 'select', 'textarea', 'label', '[data-amp-default-track]', '.amp-default-track']`| When provided, only allow elements matching any selector to be tracked. |
+|`pageUrlAllowlist`|`(string\|RegExp)[]`|`undefined`| When provided, only allow elements matching URLs to be tracked. |
+|`shouldTrackEventResolver`|`(actionType: ActionType, element: Element) => boolean`|`undefined`| When provided, overwrite all other allowlists and configurations. |
+|`dataAttributePrefix`|`string`|`'data-amp-track-'`| Allow data attributes to be collected in event property. |
+
+### 3. Install plugin to Amplitude SDK
+
+```typescript
+amplitude.add(plugin);
+```
+
+### 4. Initialize Amplitude SDK
+
+```typescript
+amplitude.init('API_KEY');
+```

package/lib/cjs/autocapture-plugin.d.ts

@@ -0,0 +1,44 @@
+import { BrowserClient, BrowserConfig, EnrichmentPlugin } from '@amplitude/analytics-types';
+import { Messenger } from './libs/messenger';
+import { ActionType } from './typings/autocapture';
+type BrowserEnrichmentPlugin = EnrichmentPlugin<BrowserClient, BrowserConfig>;
+export declare const DEFAULT_CSS_SELECTOR_ALLOWLIST: string[];
+export declare const DEFAULT_DATA_ATTRIBUTE_PREFIX = "data-amp-track-";
+interface Options {
+    /**
+     * List of CSS selectors to allow auto tracking on.
+     * When provided, allow elements matching any selector to be tracked.
+     * Default is ['a', 'button', 'input', 'select', 'textarea', 'label', '[data-amp-default-track]', '.amp-default-track'].
+     */
+    cssSelectorAllowlist?: string[];
+    /**
+     * List of page URLs to allow auto tracking on.
+     * When provided, only allow tracking on these URLs.
+     * Both full URLs and regex are supported.
+     */
+    pageUrlAllowlist?: (string | RegExp)[];
+    /**
+     * Function to determine whether an event should be tracked.
+     * When provided, this function overwrites all other allowlists and configurations.
+     * If the function returns true, the event will be tracked.
+     * If the function returns false, the event will not be tracked.
+     * @param actionType - The type of action that triggered the event.
+     * @param element - The element that triggered the event.
+     */
+    shouldTrackEventResolver?: (actionType: ActionType, element: Element) => boolean;
+    /**
+     * Prefix for data attributes to allow auto collecting.
+     * Default is 'data-amp-track-'.
+     */
+    dataAttributePrefix?: string;
+    /**
+     * Options for integrating visual tagging selector.
+     */
+    visualTaggingOptions?: {
+        enabled?: boolean;
+        messenger?: Messenger;
+    };
+}
+export declare const autocapturePlugin: (options?: Options) => BrowserEnrichmentPlugin;
+export {};
+//# sourceMappingURL=autocapture-plugin.d.ts.map

package/lib/cjs/autocapture-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocapture-plugin.d.ts","sourceRoot":"","sources":["../../src/autocapture-plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAU,MAAM,4BAA4B,CAAC;AAYpG,OAAO,EAAE,SAAS,EAAmB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,KAAK,uBAAuB,GAAG,gBAAgB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAE9E,eAAO,MAAM,8BAA8B,UAS1C,CAAC;AACF,eAAO,MAAM,6BAA6B,oBAAoB,CAAC;AAQ/D,UAAU,OAAO;IACf;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAEvC;;;;;;;OAOG;IACH,wBAAwB,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;IAEjF;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,oBAAoB,CAAC,EAAE;QACrB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,SAAS,CAAC,EAAE,SAAS,CAAC;KACvB,CAAC;CACH;AAED,eAAO,MAAM,iBAAiB,aAAa,OAAO,KAAQ,uBAyOzD,CAAC"}

package/lib/cjs/autocapture-plugin.js

@@ -0,0 +1,232 @@
+var _this = this;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.autocapturePlugin = exports.DEFAULT_DATA_ATTRIBUTE_PREFIX = exports.DEFAULT_CSS_SELECTOR_ALLOWLIST = void 0;
+var tslib_1 = require("tslib");
+var constants = tslib_1.__importStar(require("./constants"));
+var helpers_1 = require("./helpers");
+var messenger_1 = require("./libs/messenger");
+exports.DEFAULT_CSS_SELECTOR_ALLOWLIST = [
+    'a',
+    'button',
+    'input',
+    'select',
+    'textarea',
+    'label',
+    '[data-amp-default-track]',
+    '.amp-default-track',
+];
+exports.DEFAULT_DATA_ATTRIBUTE_PREFIX = 'data-amp-track-';
+var autocapturePlugin = function (options) {
+    if (options === void 0) { options = {}; }
+    var _a = options.cssSelectorAllowlist, cssSelectorAllowlist = _a === void 0 ? exports.DEFAULT_CSS_SELECTOR_ALLOWLIST : _a, pageUrlAllowlist = options.pageUrlAllowlist, shouldTrackEventResolver = options.shouldTrackEventResolver, _b = options.dataAttributePrefix, dataAttributePrefix = _b === void 0 ? exports.DEFAULT_DATA_ATTRIBUTE_PREFIX : _b, _c = options.visualTaggingOptions, visualTaggingOptions = _c === void 0 ? {
+        enabled: true,
+        messenger: new messenger_1.WindowMessenger(),
+    } : _c;
+    var name = constants.PLUGIN_NAME;
+    var type = 'enrichment';
+    var observer;
+    var eventListeners = [];
+    var logger = undefined;
+    var addEventListener = function (element, type, handler) {
+        element.addEventListener(type, handler);
+        eventListeners.push({
+            element: element,
+            type: type,
+            handler: handler,
+        });
+    };
+    var removeEventListeners = function () {
+        eventListeners.forEach(function (_ref) {
+            var element = _ref.element, type = _ref.type, handler = _ref.handler;
+            /* istanbul ignore next */
+            element === null || element === void 0 ? void 0 : element.removeEventListener(type, handler);
+        });
+        eventListeners = [];
+    };
+    var shouldTrackEvent = function (actionType, element) {
+        var _a, _b, _c;
+        /* istanbul ignore if */
+        if (!element) {
+            return false;
+        }
+        /* istanbul ignore next */
+        var tag = (_b = (_a = element === null || element === void 0 ? void 0 : element.tagName) === null || _a === void 0 ? void 0 : _a.toLowerCase) === null || _b === void 0 ? void 0 : _b.call(_a);
+        // Text nodes have no tag
+        if (!tag) {
+            return false;
+        }
+        if (shouldTrackEventResolver) {
+            return shouldTrackEventResolver(actionType, element);
+        }
+        if (!(0, helpers_1.isPageUrlAllowed)(window.location.href, pageUrlAllowlist)) {
+            return false;
+        }
+        /* istanbul ignore next */
+        var elementType = (element === null || element === void 0 ? void 0 : element.type) || '';
+        if (typeof elementType === 'string') {
+            switch (elementType.toLowerCase()) {
+                case 'hidden':
+                    return false;
+                case 'password':
+                    return false;
+            }
+        }
+        /* istanbul ignore if */
+        if (cssSelectorAllowlist) {
+            var hasMatchAnyAllowedSelector = cssSelectorAllowlist.some(function (selector) { var _a; return !!((_a = element === null || element === void 0 ? void 0 : element.matches) === null || _a === void 0 ? void 0 : _a.call(element, selector)); });
+            if (!hasMatchAnyAllowedSelector) {
+                return false;
+            }
+        }
+        switch (tag) {
+            case 'input':
+            case 'select':
+            case 'textarea':
+                return actionType === 'change' || actionType === 'click';
+            default: {
+                /* istanbul ignore next */
+                var computedStyle = (_c = window === null || window === void 0 ? void 0 : window.getComputedStyle) === null || _c === void 0 ? void 0 : _c.call(window, element);
+                /* istanbul ignore next */
+                if (computedStyle && computedStyle.getPropertyValue('cursor') === 'pointer' && actionType === 'click') {
+                    return true;
+                }
+                return actionType === 'click';
+            }
+        }
+    };
+    var getEventProperties = function (actionType, element) {
+        var _a;
+        var _b, _c;
+        /* istanbul ignore next */
+        var tag = (_c = (_b = element === null || element === void 0 ? void 0 : element.tagName) === null || _b === void 0 ? void 0 : _b.toLowerCase) === null || _c === void 0 ? void 0 : _c.call(_b);
+        /* istanbul ignore next */
+        var rect = typeof element.getBoundingClientRect === 'function' ? element.getBoundingClientRect() : { left: null, top: null };
+        var ariaLabel = element.getAttribute('aria-label');
+        var attributes = (0, helpers_1.getAttributesWithPrefix)(element, dataAttributePrefix);
+        var nearestLabel = (0, helpers_1.getNearestLabel)(element);
+        var selector = (0, helpers_1.getSelector)(element, logger);
+        /* istanbul ignore next */
+        var properties = (_a = {},
+            _a[constants.AMPLITUDE_EVENT_PROP_ELEMENT_ID] = element.id,
+            _a[constants.AMPLITUDE_EVENT_PROP_ELEMENT_CLASS] = element.className,
+            _a[constants.AMPLITUDE_EVENT_PROP_ELEMENT_TAG] = tag,
+            _a[constants.AMPLITUDE_EVENT_PROP_ELEMENT_TEXT] = (0, helpers_1.getText)(element),
+            _a[constants.AMPLITUDE_EVENT_PROP_ELEMENT_POSITION_LEFT] = rect.left == null ? null : Math.round(rect.left),
+            _a[constants.AMPLITUDE_EVENT_PROP_ELEMENT_POSITION_TOP] = rect.top == null ? null : Math.round(rect.top),
+            _a[constants.AMPLITUDE_EVENT_PROP_ELEMENT_ARIA_LABEL] = ariaLabel,
+            _a[constants.AMPLITUDE_EVENT_PROP_ELEMENT_ATTRIBUTES] = attributes,
+            _a[constants.AMPLITUDE_EVENT_PROP_ELEMENT_SELECTOR] = selector,
+            _a[constants.AMPLITUDE_EVENT_PROP_ELEMENT_PARENT_LABEL] = nearestLabel,
+            _a[constants.AMPLITUDE_EVENT_PROP_PAGE_URL] = window.location.href.split('?')[0],
+            _a[constants.AMPLITUDE_EVENT_PROP_PAGE_TITLE] = (typeof document !== 'undefined' && document.title) || '',
+            _a[constants.AMPLITUDE_EVENT_PROP_VIEWPORT_HEIGHT] = window.innerHeight,
+            _a[constants.AMPLITUDE_EVENT_PROP_VIEWPORT_WIDTH] = window.innerWidth,
+            _a);
+        if (tag === 'a' && actionType === 'click' && element instanceof HTMLAnchorElement) {
+            properties[constants.AMPLITUDE_EVENT_PROP_ELEMENT_HREF] = element.href;
+        }
+        return (0, helpers_1.removeEmptyProperties)(properties);
+    };
+    var setup = function (config, amplitude) { return tslib_1.__awaiter(_this, void 0, void 0, function () {
+        var addListener, attachListeners;
+        var _a, _b, _c;
+        return tslib_1.__generator(this, function (_d) {
+            if (!amplitude) {
+                /* istanbul ignore next */
+                (_a = config === null || config === void 0 ? void 0 : config.loggerProvider) === null || _a === void 0 ? void 0 : _a.warn("".concat(name, " plugin requires a later version of @amplitude/analytics-browser. Events are not tracked."));
+                return [2 /*return*/];
+            }
+            logger = config.loggerProvider;
+            /* istanbul ignore if */
+            if (typeof document === 'undefined') {
+                return [2 /*return*/];
+            }
+            addListener = function (el) {
+                if (shouldTrackEvent('click', el)) {
+                    addEventListener(el, 'click', function (event) {
+                        // Limit to only the innermost element that matches the selectors, avoiding all propagated event after matching.
+                        /* istanbul ignore next */
+                        if ((event === null || event === void 0 ? void 0 : event.target) != (event === null || event === void 0 ? void 0 : event.currentTarget) &&
+                            (0, helpers_1.getClosestElement)(event === null || event === void 0 ? void 0 : event.target, cssSelectorAllowlist) != (event === null || event === void 0 ? void 0 : event.currentTarget)) {
+                            return;
+                        }
+                        /* istanbul ignore next */
+                        amplitude === null || amplitude === void 0 ? void 0 : amplitude.track(constants.AMPLITUDE_ELEMENT_CLICKED_EVENT, getEventProperties('click', el));
+                    });
+                }
+                if (shouldTrackEvent('change', el)) {
+                    addEventListener(el, 'change', function (event) {
+                        // Limit to only the innermost element that matches the selectors, avoiding all propagated event after matching.
+                        /* istanbul ignore next */
+                        if ((event === null || event === void 0 ? void 0 : event.target) != (event === null || event === void 0 ? void 0 : event.currentTarget) &&
+                            (0, helpers_1.getClosestElement)(event === null || event === void 0 ? void 0 : event.target, cssSelectorAllowlist) != (event === null || event === void 0 ? void 0 : event.currentTarget)) {
+                            return;
+                        }
+                        /* istanbul ignore next */
+                        amplitude === null || amplitude === void 0 ? void 0 : amplitude.track(constants.AMPLITUDE_ELEMENT_CHANGED_EVENT, getEventProperties('change', el));
+                    });
+                }
+            };
+            if (typeof MutationObserver !== 'undefined') {
+                observer = new MutationObserver(function (mutations) {
+                    mutations.forEach(function (mutation) {
+                        mutation.addedNodes.forEach(function (node) {
+                            addListener(node);
+                            if ('querySelectorAll' in node && typeof node.querySelectorAll === 'function') {
+                                (0, helpers_1.querySelectUniqueElements)(node, cssSelectorAllowlist).map(addListener);
+                            }
+                        });
+                    });
+                });
+            }
+            attachListeners = function () {
+                var allElements = (0, helpers_1.querySelectUniqueElements)(document.body, cssSelectorAllowlist);
+                allElements.forEach(addListener);
+                /* istanbul ignore next */
+                observer === null || observer === void 0 ? void 0 : observer.observe(document.body, {
+                    subtree: true,
+                    childList: true,
+                });
+            };
+            if (document.body) {
+                attachListeners();
+            }
+            else {
+                // This is to handle the case where the plugin is loaded before the body is available.
+                // E.g., for non-reactive frameworks.
+                window.addEventListener('load', attachListeners);
+            }
+            /* istanbul ignore next */
+            (_b = config === null || config === void 0 ? void 0 : config.loggerProvider) === null || _b === void 0 ? void 0 : _b.log("".concat(name, " has been successfully added."));
+            // Setup visual tagging selector
+            if (window.opener && visualTaggingOptions.enabled) {
+                /* istanbul ignore next */
+                (_c = visualTaggingOptions.messenger) === null || _c === void 0 ? void 0 : _c.setup(tslib_1.__assign(tslib_1.__assign({ logger: config === null || config === void 0 ? void 0 : config.loggerProvider }, ((config === null || config === void 0 ? void 0 : config.serverZone) && { endpoint: constants.AMPLITUDE_ORIGINS_MAP[config.serverZone] })), { isElementSelectable: shouldTrackEvent }));
+            }
+            return [2 /*return*/];
+        });
+    }); };
+    var execute = function (event) { return tslib_1.__awaiter(_this, void 0, void 0, function () {
+        return tslib_1.__generator(this, function (_a) {
+            return [2 /*return*/, event];
+        });
+    }); };
+    var teardown = function () { return tslib_1.__awaiter(_this, void 0, void 0, function () {
+        return tslib_1.__generator(this, function (_a) {
+            if (observer) {
+                observer.disconnect();
+            }
+            removeEventListeners();
+            return [2 /*return*/];
+        });
+    }); };
+    return {
+        name: name,
+        type: type,
+        setup: setup,
+        execute: execute,
+        teardown: teardown,
+    };
+};
+exports.autocapturePlugin = autocapturePlugin;
+//# sourceMappingURL=autocapture-plugin.js.map

package/lib/cjs/autocapture-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocapture-plugin.js","sourceRoot":"","sources":["../../src/autocapture-plugin.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable no-restricted-globals */\nimport { BrowserClient, BrowserConfig, EnrichmentPlugin, Logger } from '@amplitude/analytics-types';\nimport * as constants from './constants';\nimport {\n  getText,\n  isPageUrlAllowed,\n  getAttributesWithPrefix,\n  removeEmptyProperties,\n  getNearestLabel,\n  querySelectUniqueElements,\n  getClosestElement,\n  getSelector,\n} from './helpers';\nimport { Messenger, WindowMessenger } from './libs/messenger';\nimport { ActionType } from './typings/autocapture';\n\ntype BrowserEnrichmentPlugin = EnrichmentPlugin<BrowserClient, BrowserConfig>;\n\nexport const DEFAULT_CSS_SELECTOR_ALLOWLIST = [\n  'a',\n  'button',\n  'input',\n  'select',\n  'textarea',\n  'label',\n  '[data-amp-default-track]',\n  '.amp-default-track',\n];\nexport const DEFAULT_DATA_ATTRIBUTE_PREFIX = 'data-amp-track-';\n\ninterface EventListener {\n  element: Element;\n  type: ActionType;\n  handler: (event: Event) => void;\n}\n\ninterface Options {\n  /**\n   * List of CSS selectors to allow auto tracking on.\n   * When provided, allow elements matching any selector to be tracked.\n   * Default is ['a', 'button', 'input', 'select', 'textarea', 'label', '[data-amp-default-track]', '.amp-default-track'].\n   */\n  cssSelectorAllowlist?: string[];\n\n  /**\n   * List of page URLs to allow auto tracking on.\n   * When provided, only allow tracking on these URLs.\n   * Both full URLs and regex are supported.\n   */\n  pageUrlAllowlist?: (string | RegExp)[];\n\n  /**\n   * Function to determine whether an event should be tracked.\n   * When provided, this function overwrites all other allowlists and configurations.\n   * If the function returns true, the event will be tracked.\n   * If the function returns false, the event will not be tracked.\n   * @param actionType - The type of action that triggered the event.\n   * @param element - The element that triggered the event.\n   */\n  shouldTrackEventResolver?: (actionType: ActionType, element: Element) => boolean;\n\n  /**\n   * Prefix for data attributes to allow auto collecting.\n   * Default is 'data-amp-track-'.\n   */\n  dataAttributePrefix?: string;\n\n  /**\n   * Options for integrating visual tagging selector.\n   */\n  visualTaggingOptions?: {\n    enabled?: boolean;\n    messenger?: Messenger;\n  };\n}\n\nexport const autocapturePlugin = (options: Options = {}): BrowserEnrichmentPlugin => {\n  const {\n    cssSelectorAllowlist = DEFAULT_CSS_SELECTOR_ALLOWLIST,\n    pageUrlAllowlist,\n    shouldTrackEventResolver,\n    dataAttributePrefix = DEFAULT_DATA_ATTRIBUTE_PREFIX,\n    visualTaggingOptions = {\n      enabled: true,\n      messenger: new WindowMessenger(),\n    },\n  } = options;\n  const name = constants.PLUGIN_NAME;\n  const type = 'enrichment';\n\n  let observer: MutationObserver | undefined;\n  let eventListeners: EventListener[] = [];\n  let logger: Logger | undefined = undefined;\n\n  const addEventListener = (element: Element, type: ActionType, handler: (event: Event) => void) => {\n    element.addEventListener(type, handler);\n    eventListeners.push({\n      element: element,\n      type: type,\n      handler: handler,\n    });\n  };\n\n  const removeEventListeners = () => {\n    eventListeners.forEach((_ref) => {\n      const element = _ref.element,\n        type = _ref.type,\n        handler = _ref.handler;\n      /* istanbul ignore next */\n      element?.removeEventListener(type, handler);\n    });\n    eventListeners = [];\n  };\n\n  const shouldTrackEvent = (actionType: ActionType, element: Element) => {\n    /* istanbul ignore if */\n    if (!element) {\n      return false;\n    }\n\n    /* istanbul ignore next */\n    const tag = element?.tagName?.toLowerCase?.();\n    // Text nodes have no tag\n    if (!tag) {\n      return false;\n    }\n\n    if (shouldTrackEventResolver) {\n      return shouldTrackEventResolver(actionType, element);\n    }\n\n    if (!isPageUrlAllowed(window.location.href, pageUrlAllowlist)) {\n      return false;\n    }\n\n    /* istanbul ignore next */\n    const elementType = (element as HTMLInputElement)?.type || '';\n    if (typeof elementType === 'string') {\n      switch (elementType.toLowerCase()) {\n        case 'hidden':\n          return false;\n        case 'password':\n          return false;\n      }\n    }\n\n    /* istanbul ignore if */\n    if (cssSelectorAllowlist) {\n      const hasMatchAnyAllowedSelector = cssSelectorAllowlist.some((selector) => !!element?.matches?.(selector));\n      if (!hasMatchAnyAllowedSelector) {\n        return false;\n      }\n    }\n\n    switch (tag) {\n      case 'input':\n      case 'select':\n      case 'textarea':\n        return actionType === 'change' || actionType === 'click';\n      default: {\n        /* istanbul ignore next */\n        const computedStyle = window?.getComputedStyle?.(element);\n        /* istanbul ignore next */\n        if (computedStyle && computedStyle.getPropertyValue('cursor') === 'pointer' && actionType === 'click') {\n          return true;\n        }\n        return actionType === 'click';\n      }\n    }\n  };\n\n  const getEventProperties = (actionType: ActionType, element: Element) => {\n    /* istanbul ignore next */\n    const tag = element?.tagName?.toLowerCase?.();\n    /* istanbul ignore next */\n    const rect =\n      typeof element.getBoundingClientRect === 'function' ? element.getBoundingClientRect() : { left: null, top: null };\n    const ariaLabel = element.getAttribute('aria-label');\n    const attributes = getAttributesWithPrefix(element, dataAttributePrefix);\n    const nearestLabel = getNearestLabel(element);\n    const selector = getSelector(element, logger);\n    /* istanbul ignore next */\n    const properties: Record<string, any> = {\n      [constants.AMPLITUDE_EVENT_PROP_ELEMENT_ID]: element.id,\n      [constants.AMPLITUDE_EVENT_PROP_ELEMENT_CLASS]: element.className,\n      [constants.AMPLITUDE_EVENT_PROP_ELEMENT_TAG]: tag,\n      [constants.AMPLITUDE_EVENT_PROP_ELEMENT_TEXT]: getText(element),\n      [constants.AMPLITUDE_EVENT_PROP_ELEMENT_POSITION_LEFT]: rect.left == null ? null : Math.round(rect.left),\n      [constants.AMPLITUDE_EVENT_PROP_ELEMENT_POSITION_TOP]: rect.top == null ? null : Math.round(rect.top),\n      [constants.AMPLITUDE_EVENT_PROP_ELEMENT_ARIA_LABEL]: ariaLabel,\n      [constants.AMPLITUDE_EVENT_PROP_ELEMENT_ATTRIBUTES]: attributes,\n      [constants.AMPLITUDE_EVENT_PROP_ELEMENT_SELECTOR]: selector,\n      [constants.AMPLITUDE_EVENT_PROP_ELEMENT_PARENT_LABEL]: nearestLabel,\n      [constants.AMPLITUDE_EVENT_PROP_PAGE_URL]: window.location.href.split('?')[0],\n      [constants.AMPLITUDE_EVENT_PROP_PAGE_TITLE]: (typeof document !== 'undefined' && document.title) || '',\n      [constants.AMPLITUDE_EVENT_PROP_VIEWPORT_HEIGHT]: window.innerHeight,\n      [constants.AMPLITUDE_EVENT_PROP_VIEWPORT_WIDTH]: window.innerWidth,\n    };\n    if (tag === 'a' && actionType === 'click' && element instanceof HTMLAnchorElement) {\n      properties[constants.AMPLITUDE_EVENT_PROP_ELEMENT_HREF] = element.href;\n    }\n    return removeEmptyProperties(properties);\n  };\n\n  const setup: BrowserEnrichmentPlugin['setup'] = async (config, amplitude) => {\n    if (!amplitude) {\n      /* istanbul ignore next */\n      config?.loggerProvider?.warn(\n        `${name} plugin requires a later version of @amplitude/analytics-browser. Events are not tracked.`,\n      );\n      return;\n    }\n    logger = config.loggerProvider;\n\n    /* istanbul ignore if */\n    if (typeof document === 'undefined') {\n      return;\n    }\n    const addListener = (el: Element) => {\n      if (shouldTrackEvent('click', el)) {\n        addEventListener(el, 'click', (event: Event) => {\n          // Limit to only the innermost element that matches the selectors, avoiding all propagated event after matching.\n          /* istanbul ignore next */\n          if (\n            event?.target != event?.currentTarget &&\n            getClosestElement(event?.target as HTMLElement, cssSelectorAllowlist) != event?.currentTarget\n          ) {\n            return;\n          }\n          /* istanbul ignore next */\n          amplitude?.track(constants.AMPLITUDE_ELEMENT_CLICKED_EVENT, getEventProperties('click', el));\n        });\n      }\n      if (shouldTrackEvent('change', el)) {\n        addEventListener(el, 'change', (event: Event) => {\n          // Limit to only the innermost element that matches the selectors, avoiding all propagated event after matching.\n          /* istanbul ignore next */\n          if (\n            event?.target != event?.currentTarget &&\n            getClosestElement(event?.target as HTMLElement, cssSelectorAllowlist) != event?.currentTarget\n          ) {\n            return;\n          }\n          /* istanbul ignore next */\n          amplitude?.track(constants.AMPLITUDE_ELEMENT_CHANGED_EVENT, getEventProperties('change', el));\n        });\n      }\n    };\n\n    if (typeof MutationObserver !== 'undefined') {\n      observer = new MutationObserver((mutations) => {\n        mutations.forEach((mutation) => {\n          mutation.addedNodes.forEach((node: Node) => {\n            addListener(node as Element);\n            if ('querySelectorAll' in node && typeof node.querySelectorAll === 'function') {\n              querySelectUniqueElements(node as Element, cssSelectorAllowlist).map(addListener);\n            }\n          });\n        });\n      });\n    }\n    const attachListeners = () => {\n      const allElements = querySelectUniqueElements(document.body, cssSelectorAllowlist);\n      allElements.forEach(addListener);\n      /* istanbul ignore next */\n      observer?.observe(document.body, {\n        subtree: true,\n        childList: true,\n      });\n    };\n    if (document.body) {\n      attachListeners();\n    } else {\n      // This is to handle the case where the plugin is loaded before the body is available.\n      // E.g., for non-reactive frameworks.\n      window.addEventListener('load', attachListeners);\n    }\n    /* istanbul ignore next */\n    config?.loggerProvider?.log(`${name} has been successfully added.`);\n\n    // Setup visual tagging selector\n    if (window.opener && visualTaggingOptions.enabled) {\n      /* istanbul ignore next */\n      visualTaggingOptions.messenger?.setup({\n        logger: config?.loggerProvider,\n        ...(config?.serverZone && { endpoint: constants.AMPLITUDE_ORIGINS_MAP[config.serverZone] }),\n        isElementSelectable: shouldTrackEvent,\n      });\n    }\n  };\n\n  const execute: BrowserEnrichmentPlugin['execute'] = async (event) => {\n    return event;\n  };\n\n  const teardown = async () => {\n    if (observer) {\n      observer.disconnect();\n    }\n    removeEventListeners();\n  };\n\n  return {\n    name,\n    type,\n    setup,\n    execute,\n    teardown,\n  };\n};\n"]}

package/lib/cjs/constants.d.ts

@@ -0,0 +1,29 @@
+export declare const PLUGIN_NAME = "@amplitude/plugin-autocapture-browser";
+export declare const AMPLITUDE_ELEMENT_CLICKED_EVENT = "[Amplitude] Element Clicked";
+export declare const AMPLITUDE_ELEMENT_CHANGED_EVENT = "[Amplitude] Element Changed";
+export declare const AMPLITUDE_EVENT_PROP_ELEMENT_ID = "[Amplitude] Element ID";
+export declare const AMPLITUDE_EVENT_PROP_ELEMENT_CLASS = "[Amplitude] Element Class";
+export declare const AMPLITUDE_EVENT_PROP_ELEMENT_TAG = "[Amplitude] Element Tag";
+export declare const AMPLITUDE_EVENT_PROP_ELEMENT_TEXT = "[Amplitude] Element Text";
+export declare const AMPLITUDE_EVENT_PROP_ELEMENT_HREF = "[Amplitude] Element Href";
+export declare const AMPLITUDE_EVENT_PROP_ELEMENT_POSITION_LEFT = "[Amplitude] Element Position Left";
+export declare const AMPLITUDE_EVENT_PROP_ELEMENT_POSITION_TOP = "[Amplitude] Element Position Top";
+export declare const AMPLITUDE_EVENT_PROP_ELEMENT_ARIA_LABEL = "[Amplitude] Element Aria Label";
+export declare const AMPLITUDE_EVENT_PROP_ELEMENT_ATTRIBUTES = "[Amplitude] Element Attributes";
+export declare const AMPLITUDE_EVENT_PROP_ELEMENT_SELECTOR = "[Amplitude] Element Selector";
+export declare const AMPLITUDE_EVENT_PROP_ELEMENT_PARENT_LABEL = "[Amplitude] Element Parent Label";
+export declare const AMPLITUDE_EVENT_PROP_PAGE_URL = "[Amplitude] Page URL";
+export declare const AMPLITUDE_EVENT_PROP_PAGE_TITLE = "[Amplitude] Page Title";
+export declare const AMPLITUDE_EVENT_PROP_VIEWPORT_HEIGHT = "[Amplitude] Viewport Height";
+export declare const AMPLITUDE_EVENT_PROP_VIEWPORT_WIDTH = "[Amplitude] Viewport Width";
+export declare const AMPLITUDE_ORIGIN = "https://app.amplitude.com";
+export declare const AMPLITUDE_ORIGIN_EU = "https://app.eu.amplitude.com";
+export declare const AMPLITUDE_ORIGIN_STAGING = "https://apps.stag2.amplitude.com";
+export declare const AMPLITUDE_ORIGINS_MAP: {
+    US: string;
+    EU: string;
+    STAGING: string;
+};
+export declare const AMPLITUDE_VISUAL_TAGGING_SELECTOR_SCRIPT_URL = "https://cdn.amplitude.com/libs/visual-tagging-selector-0.2.2.js.gz";
+export declare const AMPLITUDE_VISUAL_TAGGING_HIGHLIGHT_CLASS = "amp-visual-tagging-selector-highlight";
+//# sourceMappingURL=constants.d.ts.map

package/lib/cjs/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,0CAA0C,CAAC;AAEnE,eAAO,MAAM,+BAA+B,gCAAgC,CAAC;AAC7E,eAAO,MAAM,+BAA+B,gCAAgC,CAAC;AAE7E,eAAO,MAAM,+BAA+B,2BAA2B,CAAC;AACxE,eAAO,MAAM,kCAAkC,8BAA8B,CAAC;AAC9E,eAAO,MAAM,gCAAgC,4BAA4B,CAAC;AAC1E,eAAO,MAAM,iCAAiC,6BAA6B,CAAC;AAC5E,eAAO,MAAM,iCAAiC,6BAA6B,CAAC;AAC5E,eAAO,MAAM,0CAA0C,sCAAsC,CAAC;AAC9F,eAAO,MAAM,yCAAyC,qCAAqC,CAAC;AAC5F,eAAO,MAAM,uCAAuC,mCAAmC,CAAC;AACxF,eAAO,MAAM,uCAAuC,mCAAmC,CAAC;AACxF,eAAO,MAAM,qCAAqC,iCAAiC,CAAC;AACpF,eAAO,MAAM,yCAAyC,qCAAqC,CAAC;AAC5F,eAAO,MAAM,6BAA6B,yBAAyB,CAAC;AACpE,eAAO,MAAM,+BAA+B,2BAA2B,CAAC;AACxE,eAAO,MAAM,oCAAoC,gCAAgC,CAAC;AAClF,eAAO,MAAM,mCAAmC,+BAA+B,CAAC;AAGhF,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAC5D,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAClE,eAAO,MAAM,wBAAwB,qCAAqC,CAAC;AAC3E,eAAO,MAAM,qBAAqB;;;;CAIjC,CAAC;AAEF,eAAO,MAAM,4CAA4C,uEACa,CAAC;AAGvE,eAAO,MAAM,wCAAwC,0CAA0C,CAAC"}

package/lib/cjs/constants.js

@@ -0,0 +1,34 @@
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AMPLITUDE_VISUAL_TAGGING_HIGHLIGHT_CLASS = exports.AMPLITUDE_VISUAL_TAGGING_SELECTOR_SCRIPT_URL = exports.AMPLITUDE_ORIGINS_MAP = exports.AMPLITUDE_ORIGIN_STAGING = exports.AMPLITUDE_ORIGIN_EU = exports.AMPLITUDE_ORIGIN = exports.AMPLITUDE_EVENT_PROP_VIEWPORT_WIDTH = exports.AMPLITUDE_EVENT_PROP_VIEWPORT_HEIGHT = exports.AMPLITUDE_EVENT_PROP_PAGE_TITLE = exports.AMPLITUDE_EVENT_PROP_PAGE_URL = exports.AMPLITUDE_EVENT_PROP_ELEMENT_PARENT_LABEL = exports.AMPLITUDE_EVENT_PROP_ELEMENT_SELECTOR = exports.AMPLITUDE_EVENT_PROP_ELEMENT_ATTRIBUTES = exports.AMPLITUDE_EVENT_PROP_ELEMENT_ARIA_LABEL = exports.AMPLITUDE_EVENT_PROP_ELEMENT_POSITION_TOP = exports.AMPLITUDE_EVENT_PROP_ELEMENT_POSITION_LEFT = exports.AMPLITUDE_EVENT_PROP_ELEMENT_HREF = exports.AMPLITUDE_EVENT_PROP_ELEMENT_TEXT = exports.AMPLITUDE_EVENT_PROP_ELEMENT_TAG = exports.AMPLITUDE_EVENT_PROP_ELEMENT_CLASS = exports.AMPLITUDE_EVENT_PROP_ELEMENT_ID = exports.AMPLITUDE_ELEMENT_CHANGED_EVENT = exports.AMPLITUDE_ELEMENT_CLICKED_EVENT = exports.PLUGIN_NAME = void 0;
+exports.PLUGIN_NAME = '@amplitude/plugin-autocapture-browser';
+exports.AMPLITUDE_ELEMENT_CLICKED_EVENT = '[Amplitude] Element Clicked';
+exports.AMPLITUDE_ELEMENT_CHANGED_EVENT = '[Amplitude] Element Changed';
+exports.AMPLITUDE_EVENT_PROP_ELEMENT_ID = '[Amplitude] Element ID';
+exports.AMPLITUDE_EVENT_PROP_ELEMENT_CLASS = '[Amplitude] Element Class';
+exports.AMPLITUDE_EVENT_PROP_ELEMENT_TAG = '[Amplitude] Element Tag';
+exports.AMPLITUDE_EVENT_PROP_ELEMENT_TEXT = '[Amplitude] Element Text';
+exports.AMPLITUDE_EVENT_PROP_ELEMENT_HREF = '[Amplitude] Element Href';
+exports.AMPLITUDE_EVENT_PROP_ELEMENT_POSITION_LEFT = '[Amplitude] Element Position Left';
+exports.AMPLITUDE_EVENT_PROP_ELEMENT_POSITION_TOP = '[Amplitude] Element Position Top';
+exports.AMPLITUDE_EVENT_PROP_ELEMENT_ARIA_LABEL = '[Amplitude] Element Aria Label';
+exports.AMPLITUDE_EVENT_PROP_ELEMENT_ATTRIBUTES = '[Amplitude] Element Attributes';
+exports.AMPLITUDE_EVENT_PROP_ELEMENT_SELECTOR = '[Amplitude] Element Selector';
+exports.AMPLITUDE_EVENT_PROP_ELEMENT_PARENT_LABEL = '[Amplitude] Element Parent Label';
+exports.AMPLITUDE_EVENT_PROP_PAGE_URL = '[Amplitude] Page URL';
+exports.AMPLITUDE_EVENT_PROP_PAGE_TITLE = '[Amplitude] Page Title';
+exports.AMPLITUDE_EVENT_PROP_VIEWPORT_HEIGHT = '[Amplitude] Viewport Height';
+exports.AMPLITUDE_EVENT_PROP_VIEWPORT_WIDTH = '[Amplitude] Viewport Width';
+// Visual Tagging related constants
+exports.AMPLITUDE_ORIGIN = 'https://app.amplitude.com';
+exports.AMPLITUDE_ORIGIN_EU = 'https://app.eu.amplitude.com';
+exports.AMPLITUDE_ORIGIN_STAGING = 'https://apps.stag2.amplitude.com';
+exports.AMPLITUDE_ORIGINS_MAP = {
+    US: exports.AMPLITUDE_ORIGIN,
+    EU: exports.AMPLITUDE_ORIGIN_EU,
+    STAGING: exports.AMPLITUDE_ORIGIN_STAGING,
+};
+exports.AMPLITUDE_VISUAL_TAGGING_SELECTOR_SCRIPT_URL = 'https://cdn.amplitude.com/libs/visual-tagging-selector-0.2.2.js.gz';
+// This is the class name used by the visual tagging selector to highlight the selected element.
+// Should not use this class in the selector.
+exports.AMPLITUDE_VISUAL_TAGGING_HIGHLIGHT_CLASS = 'amp-visual-tagging-selector-highlight';
+//# sourceMappingURL=constants.js.map

package/lib/cjs/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":";;AAAa,QAAA,WAAW,GAAG,uCAAuC,CAAC;AAEtD,QAAA,+BAA+B,GAAG,6BAA6B,CAAC;AAChE,QAAA,+BAA+B,GAAG,6BAA6B,CAAC;AAEhE,QAAA,+BAA+B,GAAG,wBAAwB,CAAC;AAC3D,QAAA,kCAAkC,GAAG,2BAA2B,CAAC;AACjE,QAAA,gCAAgC,GAAG,yBAAyB,CAAC;AAC7D,QAAA,iCAAiC,GAAG,0BAA0B,CAAC;AAC/D,QAAA,iCAAiC,GAAG,0BAA0B,CAAC;AAC/D,QAAA,0CAA0C,GAAG,mCAAmC,CAAC;AACjF,QAAA,yCAAyC,GAAG,kCAAkC,CAAC;AAC/E,QAAA,uCAAuC,GAAG,gCAAgC,CAAC;AAC3E,QAAA,uCAAuC,GAAG,gCAAgC,CAAC;AAC3E,QAAA,qCAAqC,GAAG,8BAA8B,CAAC;AACvE,QAAA,yCAAyC,GAAG,kCAAkC,CAAC;AAC/E,QAAA,6BAA6B,GAAG,sBAAsB,CAAC;AACvD,QAAA,+BAA+B,GAAG,wBAAwB,CAAC;AAC3D,QAAA,oCAAoC,GAAG,6BAA6B,CAAC;AACrE,QAAA,mCAAmC,GAAG,4BAA4B,CAAC;AAEhF,mCAAmC;AACtB,QAAA,gBAAgB,GAAG,2BAA2B,CAAC;AAC/C,QAAA,mBAAmB,GAAG,8BAA8B,CAAC;AACrD,QAAA,wBAAwB,GAAG,kCAAkC,CAAC;AAC9D,QAAA,qBAAqB,GAAG;IACnC,EAAE,EAAE,wBAAgB;IACpB,EAAE,EAAE,2BAAmB;IACvB,OAAO,EAAE,gCAAwB;CAClC,CAAC;AAEW,QAAA,4CAA4C,GACvD,oEAAoE,CAAC;AACvE,gGAAgG;AAChG,6CAA6C;AAChC,QAAA,wCAAwC,GAAG,uCAAuC,CAAC","sourcesContent":["export const PLUGIN_NAME = '@amplitude/plugin-autocapture-browser';\n\nexport const AMPLITUDE_ELEMENT_CLICKED_EVENT = '[Amplitude] Element Clicked';\nexport const AMPLITUDE_ELEMENT_CHANGED_EVENT = '[Amplitude] Element Changed';\n\nexport const AMPLITUDE_EVENT_PROP_ELEMENT_ID = '[Amplitude] Element ID';\nexport const AMPLITUDE_EVENT_PROP_ELEMENT_CLASS = '[Amplitude] Element Class';\nexport const AMPLITUDE_EVENT_PROP_ELEMENT_TAG = '[Amplitude] Element Tag';\nexport const AMPLITUDE_EVENT_PROP_ELEMENT_TEXT = '[Amplitude] Element Text';\nexport const AMPLITUDE_EVENT_PROP_ELEMENT_HREF = '[Amplitude] Element Href';\nexport const AMPLITUDE_EVENT_PROP_ELEMENT_POSITION_LEFT = '[Amplitude] Element Position Left';\nexport const AMPLITUDE_EVENT_PROP_ELEMENT_POSITION_TOP = '[Amplitude] Element Position Top';\nexport const AMPLITUDE_EVENT_PROP_ELEMENT_ARIA_LABEL = '[Amplitude] Element Aria Label';\nexport const AMPLITUDE_EVENT_PROP_ELEMENT_ATTRIBUTES = '[Amplitude] Element Attributes';\nexport const AMPLITUDE_EVENT_PROP_ELEMENT_SELECTOR = '[Amplitude] Element Selector';\nexport const AMPLITUDE_EVENT_PROP_ELEMENT_PARENT_LABEL = '[Amplitude] Element Parent Label';\nexport const AMPLITUDE_EVENT_PROP_PAGE_URL = '[Amplitude] Page URL';\nexport const AMPLITUDE_EVENT_PROP_PAGE_TITLE = '[Amplitude] Page Title';\nexport const AMPLITUDE_EVENT_PROP_VIEWPORT_HEIGHT = '[Amplitude] Viewport Height';\nexport const AMPLITUDE_EVENT_PROP_VIEWPORT_WIDTH = '[Amplitude] Viewport Width';\n\n// Visual Tagging related constants\nexport const AMPLITUDE_ORIGIN = 'https://app.amplitude.com';\nexport const AMPLITUDE_ORIGIN_EU = 'https://app.eu.amplitude.com';\nexport const AMPLITUDE_ORIGIN_STAGING = 'https://apps.stag2.amplitude.com';\nexport const AMPLITUDE_ORIGINS_MAP = {\n  US: AMPLITUDE_ORIGIN,\n  EU: AMPLITUDE_ORIGIN_EU,\n  STAGING: AMPLITUDE_ORIGIN_STAGING,\n};\n\nexport const AMPLITUDE_VISUAL_TAGGING_SELECTOR_SCRIPT_URL =\n  'https://cdn.amplitude.com/libs/visual-tagging-selector-0.2.2.js.gz';\n// This is the class name used by the visual tagging selector to highlight the selected element.\n// Should not use this class in the selector.\nexport const AMPLITUDE_VISUAL_TAGGING_HIGHLIGHT_CLASS = 'amp-visual-tagging-selector-highlight';\n"]}

package/lib/cjs/helpers.d.ts

@@ -0,0 +1,24 @@
+import { Logger } from '@amplitude/analytics-types';
+export declare const isNonSensitiveString: (text: string | null) => boolean;
+export declare const isTextNode: (node: Node) => boolean;
+export declare const isNonSensitiveElement: (element: Element) => boolean;
+export declare const getText: (element: Element) => string;
+export declare const getSelector: (element: Element, logger?: Logger) => string;
+export declare const isPageUrlAllowed: (url: string, pageUrlAllowlist: (string | RegExp)[] | undefined) => boolean;
+export declare const getAttributesWithPrefix: (element: Element, prefix: string) => {
+    [key: string]: string;
+};
+export declare const isEmpty: (value: unknown) => boolean;
+export declare const removeEmptyProperties: (properties: {
+    [key: string]: unknown;
+}) => {
+    [key: string]: unknown;
+};
+export declare const getNearestLabel: (element: Element) => string;
+export declare const querySelectUniqueElements: (root: Element | Document, selectors: string[]) => Element[];
+export declare const getClosestElement: (element: Element | null, selectors: string[]) => Element | null;
+export declare const getEventTagProps: (element: Element, logger?: Logger) => {
+    [key: string]: unknown;
+};
+export declare const asyncLoadScript: (url: string) => Promise<unknown>;
+//# sourceMappingURL=helpers.d.ts.map

package/lib/cjs/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAIpD,eAAO,MAAM,oBAAoB,SAAU,MAAM,GAAG,IAAI,YAgBvD,CAAC;AAEF,eAAO,MAAM,UAAU,SAAU,IAAI,YAEpC,CAAC;AAEF,eAAO,MAAM,qBAAqB,YAAa,OAAO,YAIrD,CAAC;AAGF,eAAO,MAAM,OAAO,YAAa,OAAO,KAAG,MAsB1C,CAAC;AAEF,eAAO,MAAM,WAAW,YAAa,OAAO,WAAW,MAAM,KAAG,MA+B/D,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAS,MAAM,oBAAoB,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,SAAS,YAU9F,CAAC;AAEF,eAAO,MAAM,uBAAuB,YAAa,OAAO,UAAU,MAAM;;CAWvE,CAAC;AAEF,eAAO,MAAM,OAAO,UAAW,OAAO,YAOrC,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;CAQjC,CAAC;AAEF,eAAO,MAAM,eAAe,YAAa,OAAO,KAAG,MAYlD,CAAC;AAEF,eAAO,MAAM,yBAAyB,SAAU,OAAO,GAAG,QAAQ,aAAa,MAAM,EAAE,KAAG,OAAO,EAchG,CAAC;AAGF,eAAO,MAAM,iBAAiB,YAAa,OAAO,GAAG,IAAI,aAAa,MAAM,EAAE,KAAG,OAAO,GAAG,IAU1F,CAAC;AAEF,eAAO,MAAM,gBAAgB,YAAa,OAAO,WAAW,MAAM;;CAcjE,CAAC;AAEF,eAAO,MAAM,eAAe,QAAS,MAAM,qBA2B1C,CAAC"}