@mparticle/web-sdk 3.23.0 → 3.25.0

package/dist/types/src/buttonTracking/buttonClickEvent.d.ts

@@ -1,5 +1,12 @@
+import { IKitFilterSettings } from '../configAPIClient';
+import type KitBlocker from '../kitBlocking';
 import { BaseEvent } from '../sdkRuntimeModels';
 import { IButtonClick } from './buttonDescription';
 export declare const AUTO_BUTTON_ATTRIBUTE = "is_auto_button_click";
 export declare const BUTTON_CLICK_EVENT_NAME = "Auto Button Click";
+export declare const AUTO_LINK_ATTRIBUTE = "is_auto_link_click";
+export declare const LINK_CLICK_EVENT_NAME = "Auto Link Click";
 export declare const buildButtonClickEvent: (click: IButtonClick, pathname: string) => BaseEvent;
+export declare const buildLinkClickEvent: (click: IButtonClick, pathname: string) => BaseEvent;
+export type ButtonClickBlocker = 'data plan' | 'forwarding rule' | 'event name filter' | 'event type filter';
+export declare const getButtonClickBlocker: (forwarder: IKitFilterSettings, kitBlocker?: KitBlocker, link?: boolean) => ButtonClickBlocker | undefined;

package/dist/types/src/buttonTracking/buttonDescription.d.ts

@@ -1,6 +1,6 @@
 export type ButtonElementKind = 'button' | 'input' | 'role' | 'wallet' | 'link';
-export type LinkType = 'same_page' | 'outbound' | 'download';
-export type ButtonLabelSource = 'labelledby' | 'aria' | 'text' | 'label' | 'alt' | 'title' | 'value' | 'none';
+export type LinkType = 'same_page' | 'internal' | 'outbound' | 'download';
+export type ButtonLabelSource = 'labelledby' | 'aria' | 'text' | 'alt' | 'title' | 'value' | 'none';
 export interface IButtonClick {
     label?: string;
     labelSource: ButtonLabelSource;
@@ -18,4 +18,11 @@ export interface IButtonClick {
     fileExtension?: string;
     checked?: boolean;
 }
-export declare function describeButtonClick(control: Element): IButtonClick | undefined;
+export declare function isLinkClick(click: IButtonClick): boolean;
+export declare function describeButtonClick(control: Element, path?: Array<EventTarget | null>): IButtonClick | undefined;
+export interface IPaymentChoice {
+    radio: Element;
+    names: string[];
+}
+export declare function describePaymentChoice(control: Element, path?: Array<EventTarget | null>): IPaymentChoice | undefined;
+export declare function isPicked(radio: Element): boolean;

package/dist/types/src/buttonTracking/buttonTracker.d.ts

@@ -2,6 +2,8 @@ import { IMParticleWebSDKInstance } from '../mp-instance';
 export declare const WIN_BTN_KEY = "__mpBtn__";
 export interface IButtonTrackerOptions {
     hasRoktKit: boolean;
+    logButtons: boolean;
+    logLinks: boolean;
 }
 export declare const getActiveButtonTracker: () => ButtonTracker | undefined;
 export declare const resetButtonTracking: () => void;
@@ -9,8 +11,11 @@ export declare class ButtonTracker {
     private readonly mpInstance;
     private active;
     private hasRoktKit;
+    private logButtons;
+    private logLinks;
     private generation;
     private lastCommitClick;
+    private lastClick;
     private lastSent;
     private pagePath;
     private pageEvents;
@@ -21,6 +26,7 @@ export declare class ButtonTracker {
     constructor(mpInstance: IMParticleWebSDKInstance);
     get isActive(): boolean;
     init(options: IButtonTrackerOptions): void;
+    onApplePayBegin(): void;
     teardown(): void;
     clearPending(): void;
     private reset;
@@ -35,7 +41,9 @@ export declare class ButtonTracker {
     private uploadNow;
     private cancelUpload;
     private emit;
+    private pickPayment;
     private eventsEnabled;
+    private hasTargetingOptOut;
     private isKitSuppressed;
     private log;
 }

package/dist/types/src/buttonTracking/checkoutIntent.d.ts

@@ -1,9 +1,14 @@
-export type CheckoutIntentKind = 'commit' | 'wallet' | 'checkout_step' | 'frame';
-export type CheckoutIntentSource = 'vendor' | 'label' | 'brand' | 'frame' | 'submit';
+export type CheckoutIntentKind = 'commit' | 'wallet' | 'checkout_step' | 'frame' | 'cart';
+export type PaymentFrameFamily = 'apple_pay' | 'google_pay' | 'amazon_pay' | 'shop_pay' | 'card';
+export type CheckoutIntentSource = 'vendor' | 'label' | 'brand' | 'frame' | 'submit' | 'name' | 'api';
 export interface ICheckoutIntent {
     kind: Exclude<CheckoutIntentKind, 'frame'>;
     source: CheckoutIntentSource;
 }
 export declare function classifyIntent(control: Element, pathname: string): ICheckoutIntent | undefined;
 export declare function classifyIntentControl(control: Element, pathname: string): Exclude<CheckoutIntentKind, 'frame'> | undefined;
-export declare function classifyIntentFrame(target: EventTarget | null, win: Window): 'wallet' | 'frame' | undefined;
+export interface IPaymentFrame {
+    kind: 'wallet' | 'frame';
+    family?: PaymentFrameFamily;
+}
+export declare function classifyPaymentFrame(target: EventTarget | null, win: Window): IPaymentFrame | undefined;

package/dist/types/src/buttonTracking/controls.d.ts

@@ -1,9 +1,13 @@
 export declare const CONTROL_SELECTOR = "button, input[type=\"submit\"], input[type=\"button\"], input[type=\"image\"], [role=\"button\"]";
+export declare function someComposedAncestor(element: Element, test: (node: Element) => boolean, until?: Element): boolean;
 export declare function hasComposedAncestor(element: Element, selector: string): boolean;
 export declare function isRoktElement(element: Element): boolean;
 export declare function vendorButtonKind(control: Element): 'wallet' | 'checkout_step' | 'none' | undefined;
+export declare function nameWords(value: string | null): string;
+export declare function isWalletNamed(element: Element): boolean;
 export declare function isWalletElement(element: Element): boolean;
-export declare function isQuietIntentControl(control: Element, isVendorWallet: boolean): boolean;
-export declare function findControl(path: Array<EventTarget | null>): Element | undefined;
-export declare function isUnsafeTextSource(element: Element): boolean;
-export declare function isUnsafeLabelSource(label: Element): boolean;
+export declare function isQuietIntentControl(control: Element, isVendorWallet: boolean, isCart?: boolean): boolean;
+export declare function isWalletNamedControl(element: Element): boolean;
+export declare function isExcludedPath(path: Array<EventTarget | null>): boolean;
+export declare function findControl(path: Array<EventTarget | null>, included?: boolean): Element | undefined;
+export declare function isUnsafeTextSource(element: Element, own?: Element): boolean;

package/dist/types/src/buttonTracking/labelMasking.d.ts

@@ -1 +1,2 @@
+export declare const MAX_RAW_LABEL_LENGTH = 128;
 export declare function maskLabel(raw: string | null | undefined): string | undefined;

package/dist/types/src/configAPIClient.d.ts

@@ -59,6 +59,7 @@ export interface IConfigResponse {
     workspaceToken: string;
     pixelConfigs: IPixelConfiguration[];
     flags: SDKEventCustomFlags;
+    autoLogPageViewQueryParams?: string;
 }
 export interface IConfigAPIClient {
     apiKey: string;

package/dist/types/src/constants.d.ts

@@ -163,6 +163,7 @@ declare const Constants: {
         readonly AstBackgroundEvents: "astBackgroundEvents";
         readonly AutoLogPageView: "autoLogPageView";
         readonly AutoButtonTracking: "autoButtonTracking";
+        readonly AutoLinkTracking: "autoLinkTracking";
     };
     readonly DefaultInstance: "default_instance";
     readonly CCPAPurpose: "data_sale_opt_out";

package/dist/types/src/cookieConsentManager.d.ts

@@ -15,6 +15,11 @@ export interface ICookieConsentFlags {
      * Default: false (targeting is allowed)
      */
     noTargeting: boolean;
+    /**
+     * When true, indicates the user has opted out of the sale or sharing of their data.
+     * Default: false (sharing is allowed)
+     */
+    doNotShareOrSell?: boolean;
 }
 export interface ICookieConsentManager {
     /**
@@ -25,6 +30,10 @@ export interface ICookieConsentManager {
      * Functional tracking is allowed when noFunctional is false (default)
      */
     getNoFunctional: () => boolean;
+    /**
+     * Sharing is allowed when doNotShareOrSell is false (default)
+     */
+    getDoNotShareOrSell: () => boolean;
     /**
      * Syncs the $NoTargeting user attribute based on the current noTargeting flag.
      * Sets the attribute when noTargeting is true, removes it when false.
@@ -32,12 +41,12 @@ export interface ICookieConsentManager {
     syncNoTargetingAttribute: (user: IMParticleUser | null) => void;
 }
 /**
- * CookieConsentManager handles storage and access of consent flags (noFunctional, noTargeting)
- * that are passed via launcherOptions during SDK initialization.
+ * CookieConsentManager handles storage and access of consent flags (noFunctional, noTargeting,
+ * doNotShareOrSell) that are passed via launcherOptions during SDK initialization.
  *
  * These flags allow Rokt integration to respect user privacy choices.
  *
- * Default behavior: Both flags default to false, meaning all features are allowed
+ * Default behavior: All flags default to false, meaning all features are allowed
  * unless explicitly opted out by the user.
  */
 export default class CookieConsentManager implements ICookieConsentManager {
@@ -53,5 +62,10 @@ export default class CookieConsentManager implements ICookieConsentManager {
      * Functional tracking is allowed when noFunctional is false (default).
      */
     getNoFunctional(): boolean;
+    /**
+     * Returns true if the user has opted out of the sale or sharing of their data.
+     * Sharing is allowed when doNotShareOrSell is false (default).
+     */
+    getDoNotShareOrSell(): boolean;
     syncNoTargetingAttribute(user: IMParticleUser | null): void;
 }

package/dist/types/src/forwarder-utils.d.ts

@@ -1,8 +1,11 @@
 import * as EventsApi from '@mparticle/event-models';
 import { IKitFilterSettings } from './configAPIClient';
+import type { SDKEvent } from './sdkRuntimeModels';
+import type KitBlocker from './kitBlocking';
 type ForwarderFilterConfig = Pick<IKitFilterSettings, 'eventNameFilters' | 'eventTypeFilters' | 'screenNameFilters' | 'screenAttributeFilters' | 'attributeFilters' | 'userIdentityFilters' | 'filteringEventAttributeValue'>;
 export declare function isBlockedByForwardingRule(messageType: number, attributes: Record<string, unknown> | null, forwarder: ForwarderFilterConfig): boolean;
 export declare function isBlockedByEventFilter(messageType: number, hashedEventName: number, hashedEventType: number, forwarder: ForwarderFilterConfig): boolean;
+export declare function isEventForwarded(event: SDKEvent, forwarder: ForwarderFilterConfig, kitBlocker?: KitBlocker): boolean;
 export declare function filterEventAttributes(messageType: number, eventCategory: number, eventName: string, attributes: Record<string, unknown> | null, forwarder: ForwarderFilterConfig): Record<string, unknown> | null;
 export declare function filterUserIdentities(userIdentities: Array<{
     Type: number;

package/dist/types/src/pageViewTracker.d.ts

@@ -3,11 +3,23 @@ import { BaseEvent } from './sdkRuntimeModels';
 import { Dictionary } from './utils';
 export declare const WIN_APV_KEY = "__mpApv__";
 export declare const ALLOWED_QUERY_PARAMS: string[];
+export declare const AUTO_PAGE_VIEW_ATTRIBUTE = "is_auto_page_view";
+export declare const MAX_CUSTOM_QUERY_PARAMS = 25;
+export interface IQueryParamAllowlist {
+    allowed: string[];
+    rejectedPositions: number[];
+    overLimit: number;
+}
+export declare const MAX_CUSTOM_QUERY_PARAM_VALUE_LENGTH = 512;
+export interface ICapturedParam {
+    name: string;
+    value: string;
+}
 export declare const ALLOWED_QUERY_PARAM_PREFIXES: string[];
 export declare const isAllowedQueryParam: (name: string) => boolean;
 interface IPageSnapshot {
     path: string;
-    params: Dictionary<string>;
+    params: ICapturedParam[];
 }
 interface IPageViewData extends IPageSnapshot {
     hostname: string;
@@ -17,8 +29,10 @@ interface IPageViewData extends IPageSnapshot {
 export interface IPageViewOptions {
     isAutoPageView?: boolean;
 }
-export declare const allowedQueryParams: (href: string) => Dictionary<string>;
-export declare const AUTO_PAGE_VIEW_ATTRIBUTE = "is_auto_page_view";
+export declare const parseQueryParamAllowlist: (configured: unknown) => IQueryParamAllowlist;
+export declare const effectiveAllowlist: (extras?: string[]) => string[];
+export declare const allowedQueryParams: (href: string, extras?: string[]) => ICapturedParam[];
+export declare const paramsToAttributes: (params: ICapturedParam[]) => Dictionary<string>;
 export declare const autoPageViewAttribute: (isAutoPageView?: boolean) => Dictionary<boolean>;
 export declare const pageKey: (page: IPageSnapshot) => string;
 export declare const isNewPage: (lastKey: string | null, candidateKey: string) => boolean;
@@ -31,6 +45,7 @@ export declare class PageViewTracker {
     private readonly mpInstance;
     private lastPage;
     private active;
+    private customQueryParams;
     private pendingNavigations;
     private undoHistoryPatch;
     private readonly isAutoPageView;
@@ -38,6 +53,7 @@ export declare class PageViewTracker {
     get isActive(): boolean;
     init(): void;
     teardown(): void;
+    private readCustomQueryParams;
     private retire;
     private takePendingNavigations;
     private safeHandleNavigation;

package/dist/types/src/roktLauncherOptions.d.ts

@@ -4,6 +4,7 @@ export interface IRoktLauncherOptions extends Dictionary<any> {
     noDeviceID?: boolean;
     noFunctional?: boolean;
     noTargeting?: boolean;
+    doNotShareOrSell?: boolean;
     sessionId?: string;
     sessionToken?: string;
 }

package/dist/types/src/roktManager.d.ts

@@ -9,7 +9,7 @@ import { MPID } from "@mparticle/web-sdk";
 import { IErrorReportingService, ILoggingService } from "./reporting/types";
 import { IRoktLauncherOptions } from "./roktLauncherOptions";
 import IntegrationCapture from "./integrationCapture";
-import type { CheckoutIntentKind, CheckoutIntentSource } from "./buttonTracking/checkoutIntent";
+import type { CheckoutIntentKind, CheckoutIntentSource, PaymentFrameFamily } from "./buttonTracking/checkoutIntent";
 export type RoktAttributeValueArray = Array<string | number | boolean>;
 export type RoktAttributeValueType = string | number | boolean | undefined | null;
 export type RoktAttributeValue = RoktAttributeValueType | RoktAttributeValueArray;
@@ -50,6 +50,12 @@ export interface ICheckoutIntentSignal {
     source?: CheckoutIntentSource;
     pathname?: string;
 }
+export interface IPaymentPickSignal {
+    t: number;
+    pathname: string;
+    names?: readonly string[];
+    family?: PaymentFrameFamily;
+}
 export interface IRoktKitSettings {
     accountId?: string;
     placementAttributesMapping?: string;
@@ -68,6 +74,7 @@ export interface IRoktKit {
     terminate?: () => Promise<void>;
     onRouteChange?: () => void;
     onCheckoutIntent?: (signal: ICheckoutIntentSignal) => void;
+    onPaymentPick?: (signal: IPaymentPickSignal) => void;
     launcherOptions?: Dictionary<any>;
     settings?: IRoktKitSettings;
     integrationName?: string;
@@ -102,6 +109,7 @@ export default class RoktManager {
     private isShoppableAdsLoaded;
     private stopRouteChangeWatch;
     private pendingCheckoutIntents;
+    private autoButtonClicksForwarded;
     constructor(instanceName?: string);
     /**
      * Sets a callback to be invoked when RoktManager becomes ready
@@ -127,12 +135,15 @@ export default class RoktManager {
     attachKit(kit: IRoktKit): void;
     private watchRouteChanges;
     private notifyRouteChange;
+    setAutoButtonClicksForwarded(forwarded: boolean): void;
+    hasTargetingOptOut(): boolean;
     isCheckoutIntentSuppressed(): boolean;
     isCheckoutIntentLive(): boolean;
     notifyCheckoutIntent(signal: ICheckoutIntentSignal, pathname?: string): void;
     discardCheckoutIntents(): void;
+    notifyPaymentPick(signal: IPaymentPickSignal): void;
     private flushCheckoutIntents;
-    private isAutoLogPageViewEnabled;
+    isAutoLogPageViewEnabled(): boolean;
     /**
      * Renders ads based on the options provided
      *

package/dist/types/src/sdkRuntimeModels.d.ts

@@ -223,6 +223,7 @@ export interface SDKInitConfig extends Omit<MPConfiguration, 'dataPlan' | 'logLe
     dataPlanOptions?: KitBlockerOptions;
     flags?: Dictionary;
     pixelConfigs?: IPixelConfiguration[];
+    autoLogPageViewQueryParams?: string;
     aliasMaxWindow?: number;
     deviceId?: string;
     forceHttps?: boolean;

package/dist/types/src/store.d.ts

@@ -1,6 +1,7 @@
 import { Batch } from '@mparticle/event-models';
 import { MPID, IdentifyRequest, SDKEventCustomFlags, ConsentState, UserIdentities } from '@mparticle/web-sdk';
 import { IKitConfigs } from './configAPIClient';
+import { IQueryParamAllowlist } from './pageViewTracker';
 import { DataPlanResult, KitBlockerOptions, LogLevelType, SDKDataPlan, SDKEvent, SDKGeoLocation, SDKInitConfig, SDKProduct } from './sdkRuntimeModels';
 import { Dictionary, AttributeValue } from './utils';
 import { SDKConsentState } from './consent';
@@ -25,6 +26,7 @@ export interface SDKConfig {
     appVersion?: string;
     package?: string;
     flags?: IFeatureFlags;
+    autoLogPageViewQueryParams?: IQueryParamAllowlist;
     kitConfigs: IKitConfigs[];
     kits: Dictionary<UnregisteredKit>;
     logLevel?: LogLevelType;
@@ -80,6 +82,7 @@ export interface IFeatureFlags {
     astBackgroundEvents?: boolean;
     autoLogPageView?: boolean;
     autoButtonTracking?: boolean;
+    autoLinkTracking?: boolean;
 }
 export interface IStore {
     isEnabled: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mparticle/web-sdk",
-    "version": "3.23.0",
+    "version": "3.25.0",
     "description": "mParticle core SDK for web applications",
     "license": "Apache-2.0",
     "keywords": [
@@ -101,20 +101,18 @@
         "lint"
     ],
     "devDependencies": {
-        "@babel/core": "^7.18.6",
-        "@babel/eslint-parser": "^7.18.2",
-        "@babel/eslint-plugin": "^7.17.7",
-        "@babel/plugin-proposal-class-properties": "^7.5.5",
-        "@babel/plugin-proposal-object-rest-spread": "^7.5.5",
-        "@babel/plugin-transform-runtime": "^7.6.0",
-        "@babel/preset-env": "^7.6.0",
-        "@babel/preset-typescript": "^7.6.0",
+        "@babel/core": "^8.0.7",
+        "@babel/plugin-transform-runtime": "^8.0.6",
+        "@babel/preset-env": "^8.0.7",
+        "@babel/preset-typescript": "^8.0.7",
+        "@babel/runtime": "^8.0.7",
         "@mparticle/data-planning-models": "^0.1.0",
         "@mparticle/event-models": "^1.3.1",
-        "@rollup/plugin-babel": "6.0.3",
+        "@rollup/plugin-babel": "^7.1.0",
         "@rollup/plugin-commonjs": "25.0.4",
         "@rollup/plugin-json": "^5.0.2",
         "@rollup/plugin-node-resolve": "15.2.1",
+        "@rollup/plugin-terser": "^1.0.1",
         "@rollup/plugin-typescript": "^11.1.0",
         "@semantic-release/changelog": "^6.0.3",
         "@semantic-release/exec": "^6.0.3",
@@ -126,7 +124,7 @@
         "@types/mocha": "^9.0.0",
         "@types/mparticle__web-sdk": "^2.66.0",
         "@types/node": "^20.1.0",
-        "babel-preset-minify": "^0.5.1",
+        "babel-plugin-polyfill-corejs3": "^1.0.0",
         "browser-sync": "^2.26.3",
         "browserify": "^17.0.0",
         "chai": "^4.2.0",
@@ -159,7 +157,7 @@
         "shelljs": "^0.8.4",
         "should": "^7.1.0",
         "sinon": "^16.1.3",
-        "ts-jest": "^29.1.0",
+        "ts-jest": "^29.4.15",
         "tslib": "^2.1.0",
         "typescript": "^5.0.2",
         "uglify-js": "^3.4.9",
@@ -169,7 +167,16 @@
     "peerDependencies": {
         "@mparticle/event-models": "^1.3.1"
     },
-    "dependencies": {
-        "@babel/runtime": "^7.23.2"
+    "overrides": {
+        "@rollup/plugin-babel": {
+            "@babel/core": "$@babel/core"
+        }
+    },
+    "devEngines": {
+        "runtime": {
+            "name": "node",
+            "version": "^22.18.0 || >=24.11.0",
+            "onFail": "warn"
+        }
     }
 }

package/src/buttonTracking/buttonClickEvent.ts

@@ -1,4 +1,8 @@
-import { BaseEvent } from '../sdkRuntimeModels';
+import { IKitFilterSettings } from '../configAPIClient';
+import { isEventForwarded } from '../forwarder-utils';
+import type KitBlocker from '../kitBlocking';
+import KitFilterHelper from '../kitFilterHelper';
+import { BaseEvent, SDKEvent } from '../sdkRuntimeModels';
 import { EventType, MessageType } from '../types';
 import { IButtonClick } from './buttonDescription';
 
@@ -8,22 +12,25 @@ export const AUTO_BUTTON_ATTRIBUTE = 'is_auto_button_click';
 // Specific enough not to merge with a customer's own 'Button Click' event.
 export const BUTTON_CLICK_EVENT_NAME = 'Auto Button Click';
 
-// One custom event per click, logged like logLink() with the auto marker and the
-// page fields that auto page views carry. No intent: classifying clicks is left
-// to whoever reads the data.
-export const buildButtonClickEvent = (
+// Marks an automatically logged click on a link that leaves the page.
+export const AUTO_LINK_ATTRIBUTE = 'is_auto_link_click';
+
+export const LINK_CLICK_EVENT_NAME = 'Auto Link Click';
+
+// The attributes both click events carry, with the page fields that auto page
+// views carry. No intent: classifying clicks is left to whoever reads the data.
+const clickAttributes = (
     click: IButtonClick,
     pathname: string
-): BaseEvent => {
+): { [key: string]: string | boolean } => {
     const data: { [key: string]: string | boolean } = {
         label_source: click.labelSource,
         element: click.element,
         type: click.type,
         path: pathname,
         hostname: window.location.hostname,
-        [AUTO_BUTTON_ATTRIBUTE]: true,
     };
-    // Optional fields are left out when the button has no safe value for them.
+    // Optional fields are left out when the control has no safe value for them.
     const optional: { [key: string]: string | undefined } = {
         label: click.label,
         aria_label: click.ariaLabel,
@@ -45,6 +52,16 @@ export const buildButtonClickEvent = (
     if (click.checked !== undefined) {
         data.checked = click.checked;
     }
+    return data;
+};
+
+// One custom event per button click, logged like logLink() with the auto marker.
+export const buildButtonClickEvent = (
+    click: IButtonClick,
+    pathname: string
+): BaseEvent => {
+    const data = clickAttributes(click, pathname);
+    data[AUTO_BUTTON_ATTRIBUTE] = true;
     return {
         messageType: MessageType.PageEvent,
         name: BUTTON_CLICK_EVENT_NAME,
@@ -52,3 +69,104 @@ export const buildButtonClickEvent = (
         eventType: EventType.Other,
     };
 };
+
+// One custom event per click on a link that leaves the page. Typed Other, not
+// Navigation, so no kit reads it as a page change. A plain link to another page
+// of the site goes without its text, which can name the shopper ("Hi, Jane");
+// a button or wallet acting as a link keeps its name.
+export const buildLinkClickEvent = (
+    click: IButtonClick,
+    pathname: string
+): BaseEvent => {
+    const data = clickAttributes(
+        click.linkType === 'internal' && click.element === 'link'
+            ? {
+                  ...click,
+                  label: undefined,
+                  labelSource: 'none',
+                  ariaLabel: undefined,
+              }
+            : click,
+        pathname
+    );
+    data[AUTO_LINK_ATTRIBUTE] = true;
+    return {
+        messageType: MessageType.PageEvent,
+        name: LINK_CLICK_EVENT_NAME,
+        data,
+        eventType: EventType.Other,
+    };
+};
+
+// Every attribute buildButtonClickEvent can set apart from the marker and the
+// hostname, which is the same on every click on this page. A spec checks the
+// two stay in step.
+const CLICK_ATTRIBUTES = [
+    'label_source',
+    'element',
+    'type',
+    'path',
+    'label',
+    'aria_label',
+    'icon',
+    'element_id',
+    'element_name',
+    'test_id',
+    'controls',
+    'form',
+    'link_type',
+    'link_domain',
+    'file_extension',
+    'checked',
+];
+
+export type ButtonClickBlocker =
+    | 'data plan'
+    | 'forwarding rule'
+    | 'event name filter'
+    | 'event type filter';
+
+// Which check keeps some or all auto button clicks, or auto link clicks with
+// `link`, from a kit, or undefined when the kit receives every one. A forwarding
+// rule on an attribute whose value differs between clicks lets some through and
+// not others. Each other check goes through isEventForwarded on its own, so
+// together they decide as it does for each click.
+export const getButtonClickBlocker = (
+    forwarder: IKitFilterSettings,
+    kitBlocker?: KitBlocker,
+    link = false
+): ButtonClickBlocker | undefined => {
+    const rule = forwarder.filteringEventAttributeValue;
+    if (
+        rule &&
+        rule.eventAttributeValue &&
+        CLICK_ATTRIBUTES.some(
+            name =>
+                KitFilterHelper.hashAttributeConditionalForwarding(name) ===
+                rule.eventAttributeName
+        )
+    ) {
+        return 'forwarding rule';
+    }
+    const attributes: { [key: string]: string | boolean } = {
+        hostname: window.location.hostname,
+    };
+    attributes[link ? AUTO_LINK_ATTRIBUTE : AUTO_BUTTON_ATTRIBUTE] = true;
+    const click = ({
+        EventName: link ? LINK_CLICK_EVENT_NAME : BUTTON_CLICK_EVENT_NAME,
+        EventCategory: EventType.Other,
+        EventDataType: MessageType.PageEvent,
+        EventAttributes: attributes,
+    } as unknown) as SDKEvent;
+    const checks: Array<[ButtonClickBlocker, Partial<IKitFilterSettings>]> = [
+        ['data plan', {}],
+        ['forwarding rule', { filteringEventAttributeValue: rule }],
+        ['event name filter', { eventNameFilters: forwarder.eventNameFilters }],
+        ['event type filter', { eventTypeFilters: forwarder.eventTypeFilters }],
+    ];
+    const failed = checks.find(
+        ([, filters]) =>
+            !isEventForwarded(click, filters as IKitFilterSettings, kitBlocker)
+    );
+    return failed ? failed[0] : undefined;
+};