Skip to content

Commit

Permalink
fix(plugin-autocapture-browser): import types from analytics-types
Browse files Browse the repository at this point in the history
  • Loading branch information
Mercy811 committed Sep 10, 2024
1 parent 30a2da3 commit 06b60d2
Show file tree
Hide file tree
Showing 9 changed files with 28 additions and 109 deletions.
2 changes: 1 addition & 1 deletion packages/plugin-autocapture-browser/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@
},
"dependencies": {
"@amplitude/analytics-client-common": ">=1 <3",
"@amplitude/analytics-types": ">=1 <3",
"@amplitude/analytics-types": ">=2.8.1 <3",
"rxjs": "^7.8.1",
"tslib": "^2.4.1"
},
Expand Down
88 changes: 15 additions & 73 deletions packages/plugin-autocapture-browser/src/autocapture-plugin.ts
Original file line number Diff line number Diff line change
@@ -1,5 +1,15 @@
/* eslint-disable no-restricted-globals */
import { BrowserClient, BrowserConfig, EnrichmentPlugin, Logger } from '@amplitude/analytics-types';
import {
BrowserClient,
BrowserConfig,
EnrichmentPlugin,
Logger,
ElementInteractionsOptions,
DEFAULT_CSS_SELECTOR_ALLOWLIST,
DEFAULT_DATA_ATTRIBUTE_PREFIX,
DEFAULT_ACTION_CLICK_ALLOWLIST,
ActionType,
} from '@amplitude/analytics-types';
import * as constants from './constants';
import { fromEvent, map, Observable, Subscription } from 'rxjs';
import {
Expand All @@ -11,8 +21,7 @@ import {
createShouldTrackEvent,
getClosestElement,
} from './helpers';
import { Messenger, WindowMessenger } from './libs/messenger';
import { ActionType } from './typings/autocapture';
import { WindowMessenger } from './libs/messenger';
import { getHierarchy } from './hierarchy';
import { trackClicks } from './autocapture/track-click';
import { trackChange } from './autocapture/track-change';
Expand Down Expand Up @@ -52,77 +61,10 @@ interface NavigateEvent extends Event {

type BrowserEnrichmentPlugin = EnrichmentPlugin<BrowserClient, BrowserConfig>;

export const DEFAULT_CSS_SELECTOR_ALLOWLIST = [
'a',
'button',
'input',
'select',
'textarea',
'label',
'video',
'audio',
'[contenteditable="true" i]',
'[data-amp-default-track]',
'.amp-default-track',
];
export const DEFAULT_ACTION_CLICK_ALLOWLIST = ['div', 'span', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6'];
export const DEFAULT_DATA_ATTRIBUTE_PREFIX = 'data-amp-track-';

export interface AutocaptureOptions {
/**
* 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;
};

/**
* Debounce time in milliseconds for tracking events.
* This is used to detect rage clicks.
*/
debounceTime?: number;

/**
* CSS selector allowlist for tracking clicks that result in a DOM change/navigation on elements not already allowed by the cssSelectorAllowlist
*/
actionClickAllowlist?: string[];
}

export type AutoCaptureOptionsWithDefaults = Required<
Pick<AutocaptureOptions, 'debounceTime' | 'cssSelectorAllowlist' | 'actionClickAllowlist'>
Pick<ElementInteractionsOptions, 'debounceTime' | 'cssSelectorAllowlist' | 'actionClickAllowlist'>
> &
AutocaptureOptions;
ElementInteractionsOptions;

export enum ObservablesEnum {
ClickObservable = 'clickObservable',
Expand Down Expand Up @@ -164,7 +106,7 @@ export function isElementBasedEvent<T>(event: BaseTimestampedEvent<T>): event is
return event.type === 'click' || event.type === 'change';
}

export const autocapturePlugin = (options: AutocaptureOptions = {}): BrowserEnrichmentPlugin => {
export const autocapturePlugin = (options: ElementInteractionsOptions = {}): BrowserEnrichmentPlugin => {
const {
dataAttributePrefix = DEFAULT_DATA_ATTRIBUTE_PREFIX,
visualTaggingOptions = {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,7 @@ import {
ObservablesEnum,
} from 'src/autocapture-plugin';
import { filter, map, merge, switchMap, take, timeout, EMPTY } from 'rxjs';
import { ActionType } from 'src/typings/autocapture';
import { BrowserClient } from '@amplitude/analytics-types';
import { BrowserClient, ActionType } from '@amplitude/analytics-types';
import { filterOutNonTrackableEvents, getClosestElement, shouldTrackEvent } from '../helpers';
import { AMPLITUDE_ELEMENT_CLICKED_EVENT } from '../constants';

Expand Down
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
import { AllWindowObservables } from 'src/autocapture-plugin';
import { filter } from 'rxjs';
import { ActionType } from 'src/typings/autocapture';
import { BrowserClient } from '@amplitude/analytics-types';
import { BrowserClient, ActionType } from '@amplitude/analytics-types';
import { filterOutNonTrackableEvents, shouldTrackEvent } from '../helpers';
import { AMPLITUDE_ELEMENT_CHANGED_EVENT } from '../constants';

Expand Down
7 changes: 3 additions & 4 deletions packages/plugin-autocapture-browser/src/helpers.ts
Original file line number Diff line number Diff line change
@@ -1,9 +1,8 @@
/* eslint-disable no-restricted-globals */
import { finder } from './libs/finder';
import * as constants from './constants';
import { Logger } from '@amplitude/analytics-types';
import { AutocaptureOptions, ElementBasedEvent, ElementBasedTimestampedEvent } from './autocapture-plugin';
import { ActionType } from './typings/autocapture';
import { Logger, ElementInteractionsOptions, ActionType } from '@amplitude/analytics-types';
import { ElementBasedEvent, ElementBasedTimestampedEvent } from './autocapture-plugin';

export type JSONValue = string | number | boolean | null | { [x: string]: JSONValue } | Array<JSONValue>;

Expand All @@ -12,7 +11,7 @@ const SENSITIVE_TAGS = ['input', 'select', 'textarea'];
export type shouldTrackEvent = (actionType: ActionType, element: Element) => boolean;

export const createShouldTrackEvent = (
autocaptureOptions: AutocaptureOptions,
autocaptureOptions: ElementInteractionsOptions,
allowlist: string[], // this can be any type of css selector allow list
): shouldTrackEvent => {
return (actionType: ActionType, element: Element) => {
Expand Down
10 changes: 2 additions & 8 deletions packages/plugin-autocapture-browser/src/index.ts
Original file line number Diff line number Diff line change
@@ -1,8 +1,2 @@
export {
autocapturePlugin as plugin,
autocapturePlugin,
DEFAULT_CSS_SELECTOR_ALLOWLIST,
DEFAULT_DATA_ATTRIBUTE_PREFIX,
AutocaptureOptions,
} from './autocapture-plugin';
export { Messenger, Action, ActionData, Message, WindowMessenger } from './libs/messenger';
export { autocapturePlugin as plugin, autocapturePlugin } from './autocapture-plugin';
export { Action, ActionData, Message, WindowMessenger } from './libs/messenger';
8 changes: 1 addition & 7 deletions packages/plugin-autocapture-browser/src/libs/messenger.ts
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,7 @@ import {
AMPLITUDE_VISUAL_TAGGING_HIGHLIGHT_CLASS,
} from '../constants';
import { asyncLoadScript, generateUniqueId, getEventTagProps } from '../helpers';
import { Logger } from '@amplitude/analytics-types';
import { ActionType } from '../typings/autocapture';

export interface Messenger {
logger?: Logger;
setup: () => void;
}
import { Logger, Messenger, ActionType } from '@amplitude/analytics-types';

export type Action =
| 'ping'
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
export type ActionType = 'click' | 'change';

export type HierarchyNode = {
tag: string;
id?: string;
Expand Down
14 changes: 4 additions & 10 deletions yarn.lock
Original file line number Diff line number Diff line change
Expand Up @@ -66,16 +66,10 @@
"@amplitude/analytics-types" "^2.6.0"
tslib "^2.4.1"

"@amplitude/analytics-remote-config@^0.3.5":
version "0.3.5"
resolved "https://registry.yarnpkg.com/@amplitude/analytics-remote-config/-/analytics-remote-config-0.3.5.tgz#b3b9ca15f183a0399c451b9395d9c8281d310e7d"
integrity sha512-jnm/w+/NFSLnjcHSP/MYvdy6RQ7lVqWyAiIw/cTs+iL6cJaoauHuB0gbUnqGTPUhvbUlKa7faz1iiXGwt6HSjA==
dependencies:
"@amplitude/analytics-client-common" ">=1 <3"
"@amplitude/analytics-core" ">=1 <3"
"@amplitude/analytics-types" ">=1 <3"
idb "^8.0.0"
tslib "^2.4.1"
"@amplitude/analytics-types@>=2.8.1 <3":
version "2.8.1"
resolved "https://registry.yarnpkg.com/@amplitude/analytics-types/-/analytics-types-2.8.1.tgz#baf7b23b3bccc72df9ef5b0464f4dd6b82c0f37a"
integrity sha512-q+JRrw92VZmCuFzuaL7gBsRidNtqsjLRqNfLNH5RtbKdG6hmx/UEVIGDm/NeLlH4pQokCTHUWeiS+cbmOkgOwQ==

"@amplitude/analytics-types@^2.1.1":
version "2.1.1"
Expand Down

0 comments on commit 06b60d2

Please sign in to comment.