@absmartly/sdk-plugins 1.0.1

package/lib/types/index.d.ts

@@ -0,0 +1,177 @@
+export type ChangeType = 'text' | 'html' | 'style' | 'styleRules' | 'class' | 'attribute' | 'javascript' | 'move' | 'create' | 'delete';
+export type DOMChangeValue = string | number | boolean | Record<string, string> | undefined;
+export interface URLFilterConfig {
+    include?: string[];
+    exclude?: string[];
+    mode?: 'simple' | 'regex';
+    matchType?: 'full-url' | 'path' | 'domain' | 'query' | 'hash';
+}
+export type URLFilter = string | string[] | URLFilterConfig;
+export interface StyleRuleStates {
+    normal?: Record<string, string>;
+    hover?: Record<string, string>;
+    active?: Record<string, string>;
+    focus?: Record<string, string>;
+}
+export interface DOMChange {
+    selector: string;
+    type: ChangeType;
+    value?: DOMChangeValue;
+    enabled?: boolean;
+    add?: string[];
+    remove?: string[];
+    targetSelector?: string;
+    position?: 'before' | 'after' | 'firstChild' | 'lastChild';
+    element?: string;
+    states?: StyleRuleStates;
+    important?: boolean;
+    observerRoot?: string;
+    waitForElement?: boolean;
+    persistStyle?: boolean;
+    trigger_on_view?: boolean;
+}
+export interface DOMChangesConfig {
+    changes: DOMChange[];
+    urlFilter?: URLFilter;
+    waitForElement?: boolean;
+    persistStyle?: boolean;
+    important?: boolean;
+    observerRoot?: string;
+}
+export type DOMChangesData = DOMChange[] | DOMChangesConfig;
+export interface InjectionData {
+    headStart?: string;
+    headEnd?: string;
+    bodyStart?: string;
+    bodyEnd?: string;
+}
+export type InjectionLocation = 'headStart' | 'headEnd' | 'bodyStart' | 'bodyEnd';
+export interface InjectionItem {
+    code: string;
+    priority: number;
+    location: InjectionLocation;
+}
+export type RawInjectionData = Record<string, string | URLFilter>;
+export interface InjectionDataWithFilter {
+    data: RawInjectionData;
+    urlFilter?: URLFilter;
+}
+export interface ElementState {
+    selector: string;
+    type: string;
+    originalState: {
+        text?: string;
+        html?: string;
+        style?: string;
+        classList?: string[];
+        attributes?: Record<string, string>;
+        parent?: Element | null;
+        nextSibling?: Element | null;
+    };
+}
+export interface ABsmartlyContext {
+    ready(): Promise<void>;
+    data(): ContextData | null;
+    peek(experimentName: string): number | undefined;
+    treatment(experimentName: string): number;
+    override(experimentName: string, variant: number): void;
+    customFieldValue(experimentName: string, fieldName: string): unknown;
+    __plugins?: {
+        [key: string]: PluginRegistration | undefined;
+    };
+    __domPlugin?: PluginRegistration;
+}
+export interface PluginRegistration {
+    name: string;
+    version: string;
+    initialized: boolean;
+    capabilities: string[];
+    instance: unknown;
+    timestamp: number;
+}
+export interface PluginConfig {
+    context: ABsmartlyContext;
+    autoApply?: boolean;
+    /**
+     * SPA mode - Enables features for Single Page Applications (React, Vue, Angular, etc.)
+     * When enabled, automatically activates:
+     * - Wait for element: Observes DOM for elements that don't exist yet
+     * - Style persistence: Re-applies styles when frameworks overwrite them (e.g., on hover)
+     *
+     * Set to true for dynamic apps where DOM changes after page load
+     */
+    spa?: boolean;
+    visibilityTracking?: boolean;
+    extensionBridge?: boolean;
+    dataSource?: 'variable' | 'customField';
+    dataFieldName?: string;
+    debug?: boolean;
+    hideUntilReady?: boolean | 'body' | 'elements';
+    hideTimeout?: number;
+    hideSelector?: string;
+    hideTransition?: string | false;
+}
+export interface AppliedChange {
+    experimentName: string;
+    change: DOMChange;
+    elements: Element[];
+    timestamp: number;
+}
+export interface PendingChange {
+    experimentName: string;
+    change: DOMChange;
+    retryCount: number;
+}
+export type MessagePayloadData = {
+    changes?: DOMChange[];
+    experimentName?: string;
+    count?: number;
+    version?: string;
+    capabilities?: string[];
+    experiments?: ExperimentData[];
+    overrides?: Record<string, unknown>;
+    locations?: string[];
+    error?: string;
+    variant?: number;
+    changeCount?: number;
+    headStart?: string;
+    headEnd?: string;
+    bodyStart?: string;
+    bodyEnd?: string;
+};
+export interface MessagePayload {
+    source: string;
+    type: string;
+    payload?: MessagePayloadData;
+}
+export interface ExperimentVariant {
+    variables?: Record<string, unknown>;
+    config?: string | Record<string, unknown>;
+}
+export interface ExperimentData {
+    name: string;
+    variants?: ExperimentVariant[];
+}
+export interface ContextData {
+    experiments?: ExperimentData[];
+}
+export type EventCallback = (data?: EventCallbackData) => void;
+export interface EventCallbackData {
+    count?: number;
+    experimentName?: string;
+    changeCount?: number;
+    locations?: string[];
+    error?: string;
+    removedChanges?: AppliedChange[];
+    change?: DOMChange;
+}
+export type MessageHandler = (payload: MessagePayloadData) => void;
+export interface ExperimentTracking {
+    experimentName: string;
+    variant: number;
+    changes: DOMChange[];
+    allPossibleSelectors: Set<string>;
+    triggered: boolean;
+    hasImmediateTrigger: boolean;
+    hasViewportTrigger: boolean;
+}

package/lib/types/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/lib/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/lib/utils/URLMatcher.d.ts

@@ -0,0 +1,20 @@
+export interface URLFilterConfig {
+    include?: string[];
+    exclude?: string[];
+    mode?: 'simple' | 'regex';
+    matchType?: 'full-url' | 'path' | 'domain' | 'query' | 'hash';
+}
+export type URLFilter = string | string[] | URLFilterConfig;
+export declare class URLMatcher {
+    /**
+     * Check if current URL matches the filter
+     */
+    static matches(filter: URLFilter, url?: string): boolean;
+    /**
+     * Extract the relevant part of the URL based on matchType
+     */
+    private static extractURLPart;
+    private static matchesPatterns;
+    private static matchSimplePattern;
+    private static normalizeFilter;
+}

package/lib/utils/URLMatcher.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.URLMatcher = void 0;
+var URLMatcher = /** @class */ (function () {
+    function URLMatcher() {
+    }
+    /**
+     * Check if current URL matches the filter
+     */
+    URLMatcher.matches = function (filter, url) {
+        if (url === void 0) { url = window.location.href; }
+        // Normalize filter to URLFilterConfig
+        var config = this.normalizeFilter(filter);
+        // Extract the part of URL to match based on matchType
+        var urlPart = this.extractURLPart(url, config.matchType);
+        // Check exclusions first
+        if (config.exclude && this.matchesPatterns(config.exclude, urlPart, config.mode)) {
+            return false;
+        }
+        // Check inclusions
+        if (!config.include) {
+            return true; // No include property = match all
+        }
+        if (config.include.length === 0) {
+            return false; // Empty include array = match nothing (explicit "include nothing")
+        }
+        return this.matchesPatterns(config.include, urlPart, config.mode);
+    };
+    /**
+     * Extract the relevant part of the URL based on matchType
+     */
+    URLMatcher.extractURLPart = function (url, matchType) {
+        if (matchType === void 0) { matchType = 'path'; }
+        try {
+            var urlObj = new URL(url);
+            switch (matchType) {
+                case 'full-url':
+                    // Complete URL including protocol, domain, path, query, and hash
+                    return urlObj.href;
+                case 'path':
+                    // Path + hash (default behavior - most common use case)
+                    return urlObj.pathname + urlObj.hash;
+                case 'domain':
+                    // Just the hostname (e.g., 'example.com' or 'www.example.com')
+                    return urlObj.hostname;
+                case 'query':
+                    // Just query parameters (e.g., '?id=123&ref=home')
+                    return urlObj.search;
+                case 'hash':
+                    // Just hash fragment (e.g., '#section')
+                    return urlObj.hash;
+                default:
+                    return urlObj.pathname + urlObj.hash;
+            }
+        }
+        catch (error) {
+            // If URL parsing fails, return original string
+            console.error("[ABsmartly] Failed to parse URL: ".concat(url), error);
+            return url;
+        }
+    };
+    URLMatcher.matchesPatterns = function (patterns, url, mode) {
+        var _this = this;
+        if (mode === void 0) { mode = 'simple'; }
+        return patterns.some(function (pattern) {
+            if (mode === 'regex') {
+                try {
+                    return new RegExp(pattern).test(url);
+                }
+                catch (error) {
+                    console.error("[ABsmartly] Invalid regex pattern: ".concat(pattern), error);
+                    return false;
+                }
+            }
+            return _this.matchSimplePattern(pattern, url);
+        });
+    };
+    URLMatcher.matchSimplePattern = function (pattern, url) {
+        // Convert simple pattern to regex
+        // * becomes .*
+        // ? becomes .
+        // Escape other regex special chars
+        var regexPattern = pattern
+            .replace(/[.+^${}()|[\]\\]/g, '\\$&') // Escape regex chars except * and ?
+            .replace(/\*/g, '.*') // * to .*
+            .replace(/\?/g, '.'); // ? to .
+        try {
+            return new RegExp("^".concat(regexPattern, "$")).test(url);
+        }
+        catch (error) {
+            console.error("[ABsmartly] Invalid pattern: ".concat(pattern), error);
+            return false;
+        }
+    };
+    URLMatcher.normalizeFilter = function (filter) {
+        if (typeof filter === 'string') {
+            return { include: [filter], exclude: [], mode: 'simple', matchType: 'path' };
+        }
+        if (Array.isArray(filter)) {
+            return {
+                include: filter.length > 0 ? filter : undefined,
+                exclude: [],
+                mode: 'simple',
+                matchType: 'path',
+            };
+        }
+        return {
+            include: filter.include,
+            exclude: filter.exclude || [],
+            mode: filter.mode || 'simple',
+            matchType: filter.matchType || 'path',
+        };
+    };
+    return URLMatcher;
+}());
+exports.URLMatcher = URLMatcher;
+//# sourceMappingURL=URLMatcher.js.map

package/lib/utils/URLMatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"URLMatcher.js","sourceRoot":"","sources":["../../src/utils/URLMatcher.ts"],"names":[],"mappings":"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"}

package/lib/utils/debug.d.ts

@@ -0,0 +1,41 @@
+export declare const DEBUG: boolean;
+export interface LogContext {
+    experimentName?: string;
+    selector?: string;
+    changeType?: string;
+    elementsCount?: number;
+    [key: string]: any;
+}
+/**
+ * Logs debug messages only when DEBUG flag is true
+ * This function will be completely removed in production builds
+ */
+export declare function logDebug(...args: unknown[]): void;
+/**
+ * Logs detailed change application
+ */
+export declare function logChangeApplication(experimentName: string, selector: string, changeType: string, elementsAffected: number, success: boolean): void;
+/**
+ * Logs change removal/restoration
+ */
+export declare function logChangeRemoval(experimentName: string, selector: string, changeType: string, elementsRestored: number): void;
+/**
+ * Logs experiment summary
+ */
+export declare function logExperimentSummary(experimentName: string, totalChanges: number, successfulChanges: number, pendingChanges: number): void;
+/**
+ * Logs state management operations
+ */
+export declare function logStateOperation(operation: 'store' | 'retrieve' | 'clear', selector: string, changeType: string, experimentName?: string): void;
+/**
+ * Logs visibility tracking events
+ */
+export declare function logVisibilityEvent(experimentName: string, element: Element, triggered: boolean): void;
+/**
+ * Logs message bridge communication
+ */
+export declare function logMessage(direction: 'sent' | 'received', messageType: string, payload?: any): void;
+/**
+ * Logs performance metrics
+ */
+export declare function logPerformance(operation: string, duration: number, details?: any): void;

package/lib/utils/debug.js

@@ -0,0 +1,195 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEBUG = void 0;
+exports.logDebug = logDebug;
+exports.logChangeApplication = logChangeApplication;
+exports.logChangeRemoval = logChangeRemoval;
+exports.logExperimentSummary = logExperimentSummary;
+exports.logStateOperation = logStateOperation;
+exports.logVisibilityEvent = logVisibilityEvent;
+exports.logMessage = logMessage;
+exports.logPerformance = logPerformance;
+// Build-time debug flag - true in development, false in production
+exports.DEBUG = typeof __DEBUG__ !== 'undefined' ? __DEBUG__ : false;
+/**
+ * Logs debug messages only when DEBUG flag is true
+ * This function will be completely removed in production builds
+ */
+function logDebug() {
+    var args = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        args[_i] = arguments[_i];
+    }
+    if (exports.DEBUG) {
+        // Handle old format with message and context
+        if (args.length === 2 && typeof args[0] === 'string' && typeof args[1] === 'object') {
+            var _a = __read(args, 2), message = _a[0], context = _a[1];
+            // Skip repetitive messages
+            if (message.includes('Original state already stored'))
+                return;
+            if (message.includes('State store operation'))
+                return;
+            if (message.includes('Performance:') && (context === null || context === void 0 ? void 0 : context.duration) && context.duration < 5)
+                return;
+            if (message.includes('Message sent:') || message.includes('Message received:'))
+                return;
+            var timestamp = new Date().toISOString();
+            var prefix = '[ABsmartly Debug]';
+            console.log("".concat(prefix, " [").concat(timestamp, "] ").concat(message), context);
+        }
+        else if (args.length === 1 && typeof args[0] === 'string') {
+            // Single string message
+            var message = args[0];
+            // Skip repetitive messages
+            if (message.includes('Original state already stored'))
+                return;
+            if (message.includes('State store operation'))
+                return;
+            if (message.includes('Message sent:') || message.includes('Message received:'))
+                return;
+            var timestamp = new Date().toISOString();
+            var prefix = '[ABsmartly Debug]';
+            console.log("".concat(prefix, " [").concat(timestamp, "] ").concat(message));
+        }
+        else {
+            // Direct console.log replacement - just pass through all arguments
+            console.log.apply(console, __spreadArray([], __read(args), false));
+        }
+    }
+}
+/**
+ * Logs detailed change application
+ */
+function logChangeApplication(experimentName, selector, changeType, elementsAffected, success) {
+    if (exports.DEBUG) {
+        var status_1 = success ? '✓' : '✗';
+        var message = "".concat(status_1, " Applied ").concat(changeType, " change to ").concat(elementsAffected, " element(s)");
+        logDebug(message, {
+            experimentName: experimentName,
+            selector: selector,
+            changeType: changeType,
+            elementsCount: elementsAffected,
+            success: success,
+        });
+    }
+}
+/**
+ * Logs change removal/restoration
+ */
+function logChangeRemoval(experimentName, selector, changeType, elementsRestored) {
+    if (exports.DEBUG) {
+        var message = "Restored ".concat(elementsRestored, " element(s) to original state");
+        logDebug(message, {
+            experimentName: experimentName,
+            selector: selector,
+            changeType: changeType,
+            elementsCount: elementsRestored,
+            action: 'restore',
+        });
+    }
+}
+/**
+ * Logs experiment summary
+ */
+function logExperimentSummary(experimentName, totalChanges, successfulChanges, pendingChanges) {
+    if (exports.DEBUG) {
+        var message = "Experiment \"".concat(experimentName, "\" summary");
+        logDebug(message, {
+            experimentName: experimentName,
+            totalChanges: totalChanges,
+            successfulChanges: successfulChanges,
+            pendingChanges: pendingChanges,
+            successRate: totalChanges > 0 ? "".concat(Math.round((successfulChanges / totalChanges) * 100), "%") : 'N/A',
+        });
+    }
+}
+/**
+ * Logs state management operations
+ */
+function logStateOperation(operation, selector, changeType, experimentName) {
+    if (exports.DEBUG) {
+        var message = "State ".concat(operation, " operation");
+        logDebug(message, {
+            operation: operation,
+            selector: selector,
+            changeType: changeType,
+            experimentName: experimentName,
+        });
+    }
+}
+/**
+ * Logs visibility tracking events
+ */
+function logVisibilityEvent(experimentName, element, triggered) {
+    if (exports.DEBUG) {
+        var message = triggered
+            ? 'Element became visible - experiment triggered'
+            : 'Element visibility changed';
+        logDebug(message, {
+            experimentName: experimentName,
+            selector: element.className || element.id || element.tagName,
+            triggered: triggered,
+            action: 'visibility',
+        });
+    }
+}
+/**
+ * Logs message bridge communication
+ */
+function logMessage(direction, messageType, payload) {
+    if (exports.DEBUG) {
+        var message = "Message ".concat(direction, ": ").concat(messageType);
+        logDebug(message, {
+            direction: direction,
+            messageType: messageType,
+            payload: payload,
+            bridge: 'extension',
+        });
+    }
+}
+/**
+ * Logs performance metrics
+ */
+function logPerformance(operation, duration, details) {
+    if (exports.DEBUG) {
+        var message = "Performance: ".concat(operation, " took ").concat(duration, "ms");
+        logDebug(message, __assign({ operation: operation, duration: duration, performance: true }, details));
+    }
+}
+//# sourceMappingURL=debug.js.map

package/lib/utils/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/utils/debug.ts"],"names":[],"mappings":"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"}

package/lib/vitals/WebVitalsPlugin.d.ts

@@ -0,0 +1,37 @@
+import type { Context } from '@absmartly/javascript-sdk';
+export interface WebVitalsPluginOptions {
+    context?: Context;
+    debug?: boolean;
+    trackWebVitals?: boolean;
+    trackPageMetrics?: boolean;
+    webVitalsUrl?: string;
+    autoTrack?: boolean;
+}
+export interface Metric {
+    value: number;
+    delta?: number;
+    id?: string;
+    name?: string;
+    rating?: 'good' | 'needs-improvement' | 'poor';
+    entries?: unknown[];
+}
+export declare class WebVitalsPlugin {
+    private context?;
+    private debug;
+    private trackWebVitals;
+    private trackPageMetrics;
+    private webVitalsUrl;
+    private autoTrack;
+    private webVitalsLoaded;
+    private metricsTracked;
+    constructor(options?: WebVitalsPluginOptions);
+    private debugLog;
+    setContext(context: Context): void;
+    private loadWebVitalsLibrary;
+    trackWebVitalsMetrics(context?: Context): Promise<void>;
+    trackPageMetricsData(context?: Context): void;
+    private trackImmediateMetrics;
+    private trackLoadMetrics;
+    initialize(): Promise<void>;
+    reset(): void;
+}