@tracelog/lib 0.5.4 → 0.6.0

package/dist/esm/managers/tags.manager.js

@@ -1,167 +0,0 @@
-import { TagConditionOperator, TagConditionType, TagLogicalOperator, } from '../types';
-import { StateManager } from './state.manager';
-export class TagsManager extends StateManager {
-    /**
-     * Gets matching tag IDs for an event based on configured tag conditions
-     */
-    getEventTagsIds(event, deviceType) {
-        const tags = this.get('config')?.tags?.filter((tag) => tag.triggerType === event.type) ?? [];
-        if (tags.length === 0) {
-            return [];
-        }
-        const context = {
-            event,
-            deviceType,
-            clickData: event.click_data,
-        };
-        return tags.filter((tag) => this.evaluateTagConditions(tag, context)).map((tag) => tag.id);
-    }
-    /**
-     * Evaluates all conditions for a tag using logical operators
-     */
-    evaluateTagConditions(tag, context) {
-        const { conditions, logicalOperator = TagLogicalOperator.OR } = tag;
-        if (!conditions || conditions.length === 0) {
-            return false;
-        }
-        const results = conditions.map((condition) => this.evaluateCondition(condition, context));
-        return logicalOperator === TagLogicalOperator.AND ? results.every(Boolean) : results.some(Boolean);
-    }
-    /**
-     * Evaluates a single tag condition
-     */
-    evaluateCondition(condition, context) {
-        try {
-            switch (condition.type) {
-                case TagConditionType.URL_MATCHES:
-                    return this.matchStringCondition(condition, context.event.page_url);
-                case TagConditionType.DEVICE_TYPE:
-                    return this.matchStringCondition(condition, context.deviceType);
-                case TagConditionType.UTM_SOURCE:
-                    return this.matchStringCondition(condition, context.event.utm?.source ?? '');
-                case TagConditionType.UTM_MEDIUM:
-                    return this.matchStringCondition(condition, context.event.utm?.medium ?? '');
-                case TagConditionType.UTM_CAMPAIGN:
-                    return this.matchStringCondition(condition, context.event.utm?.campaign ?? '');
-                case TagConditionType.ELEMENT_MATCHES:
-                    return context.clickData ? this.matchElementCondition(condition, context.clickData) : false;
-                default:
-                    return false;
-            }
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Unified string matching logic for all string-based conditions
-     */
-    matchStringCondition(condition, value) {
-        if (!value &&
-            condition.operator !== TagConditionOperator.EXISTS &&
-            condition.operator !== TagConditionOperator.NOT_EXISTS) {
-            return false;
-        }
-        const conditionValue = condition.value.toLowerCase();
-        const targetValue = value.toLowerCase();
-        switch (condition.operator) {
-            case TagConditionOperator.EQUALS:
-                return targetValue === conditionValue;
-            case TagConditionOperator.CONTAINS:
-                return targetValue.includes(conditionValue);
-            case TagConditionOperator.STARTS_WITH:
-                return targetValue.startsWith(conditionValue);
-            case TagConditionOperator.ENDS_WITH:
-                return targetValue.endsWith(conditionValue);
-            case TagConditionOperator.REGEX:
-                return this.testRegex(conditionValue, targetValue);
-            case TagConditionOperator.EXISTS:
-                return !!value;
-            case TagConditionOperator.NOT_EXISTS:
-                return !value;
-            default:
-                return false;
-        }
-    }
-    /**
-     * Element-specific matching logic with optimized data extraction
-     */
-    matchElementCondition(condition, clickData) {
-        if (condition.operator === TagConditionOperator.EQUALS) {
-            return this.matchElementFieldExact(condition, clickData);
-        }
-        // Build searchable element data string once
-        const elementData = this.buildElementDataString(clickData).toLowerCase();
-        const conditionValue = condition.value.toLowerCase();
-        switch (condition.operator) {
-            case TagConditionOperator.CONTAINS:
-                return elementData.includes(conditionValue);
-            case TagConditionOperator.STARTS_WITH:
-                return elementData.startsWith(conditionValue);
-            case TagConditionOperator.ENDS_WITH:
-                return elementData.endsWith(conditionValue);
-            case TagConditionOperator.REGEX:
-                return this.testRegex(conditionValue, elementData);
-            default:
-                return false;
-        }
-    }
-    /**
-     * Exact field matching for element EQUALS operations
-     */
-    matchElementFieldExact(condition, clickData) {
-        const conditionValue = condition.value.toLowerCase();
-        const fields = [
-            clickData.id,
-            clickData.class,
-            clickData.tag,
-            clickData.text,
-            clickData.href,
-            clickData.title,
-            clickData.alt,
-            clickData.role,
-            clickData.ariaLabel,
-        ];
-        // Check standard fields
-        if (fields.some((field) => field && field.toLowerCase() === conditionValue)) {
-            return true;
-        }
-        // Check data attributes
-        if (clickData.dataAttributes) {
-            return Object.values(clickData.dataAttributes).some((value) => value.toLowerCase() === conditionValue);
-        }
-        return false;
-    }
-    /**
-     * Builds searchable element data string with null safety
-     */
-    buildElementDataString(clickData) {
-        const parts = [
-            clickData.id,
-            clickData.class,
-            clickData.tag,
-            clickData.text,
-            clickData.href,
-            clickData.title,
-            clickData.alt,
-            clickData.role,
-            clickData.ariaLabel,
-        ].filter(Boolean);
-        if (clickData.dataAttributes) {
-            parts.push(...Object.values(clickData.dataAttributes));
-        }
-        return parts.join(' ');
-    }
-    /**
-     * Safe regex testing with error handling
-     */
-    testRegex(pattern, text) {
-        try {
-            const regex = new RegExp(pattern, 'gi');
-            return regex.test(text);
-        }
-        catch {
-            return false;
-        }
-    }
-}

package/dist/esm/types/api.types.d.ts

@@ -1,52 +0,0 @@
-/**
- * Special project IDs for testing and development
- *
- * All automatically force mode: 'debug' but differ in HTTP behavior:
- * - Skip: NO network calls (pure offline testing)
- * - Localhost: Makes network calls to local server (integration testing)
- * - Fail: Makes network calls that intentionally fail (persistence testing)
- */
-export declare enum SpecialProjectId {
-    /**
-     * Value: 'skip'
-     *
-     * Skips ALL HTTP calls - no config fetch, no event sending
-     * Uses default local config, forces debug mode
-     * Perfect for pure offline E2E testing
-     *
-     * @example
-     * await TraceLog.init({ id: SpecialProjectId.Skip });
-     * // or
-     * await TraceLog.init({ id: 'skip' });
-     */
-    Skip = "skip",
-    /**
-     * Value: 'localhost:8080'
-     *
-     * Makes HTTP calls to local development server on port 8080
-     * Converts to http://localhost:8080/config for requests
-     * Requires origin to be in ALLOWED_ORIGINS list, forces debug mode
-     * Perfect for local development with running middleware
-     *
-     * @example
-     * await TraceLog.init({ id: SpecialProjectId.Localhost });
-     * // or
-     * await TraceLog.init({ id: 'localhost:8080' });
-     * // Makes requests to: http://localhost:8080/config
-     */
-    Localhost = "localhost:8080",
-    /**
-     * Value: 'localhost:9999'
-     *
-     * Makes HTTP calls to non-existent server (port 9999)
-     * All HTTP requests will fail naturally, triggering persistence
-     * Forces debug mode, perfect for testing event persistence & recovery
-     *
-     * @example
-     * await TraceLog.init({ id: SpecialProjectId.Fail });
-     * // or
-     * await TraceLog.init({ id: 'localhost:9999' });
-     * // Makes requests to: http://localhost:9999 (will fail)
-     */
-    Fail = "localhost:9999"
-}

package/dist/esm/types/api.types.js

@@ -1,53 +0,0 @@
-/**
- * Special project IDs for testing and development
- *
- * All automatically force mode: 'debug' but differ in HTTP behavior:
- * - Skip: NO network calls (pure offline testing)
- * - Localhost: Makes network calls to local server (integration testing)
- * - Fail: Makes network calls that intentionally fail (persistence testing)
- */
-export var SpecialProjectId;
-(function (SpecialProjectId) {
-    /**
-     * Value: 'skip'
-     *
-     * Skips ALL HTTP calls - no config fetch, no event sending
-     * Uses default local config, forces debug mode
-     * Perfect for pure offline E2E testing
-     *
-     * @example
-     * await TraceLog.init({ id: SpecialProjectId.Skip });
-     * // or
-     * await TraceLog.init({ id: 'skip' });
-     */
-    SpecialProjectId["Skip"] = "skip";
-    /**
-     * Value: 'localhost:8080'
-     *
-     * Makes HTTP calls to local development server on port 8080
-     * Converts to http://localhost:8080/config for requests
-     * Requires origin to be in ALLOWED_ORIGINS list, forces debug mode
-     * Perfect for local development with running middleware
-     *
-     * @example
-     * await TraceLog.init({ id: SpecialProjectId.Localhost });
-     * // or
-     * await TraceLog.init({ id: 'localhost:8080' });
-     * // Makes requests to: http://localhost:8080/config
-     */
-    SpecialProjectId["Localhost"] = "localhost:8080";
-    /**
-     * Value: 'localhost:9999'
-     *
-     * Makes HTTP calls to non-existent server (port 9999)
-     * All HTTP requests will fail naturally, triggering persistence
-     * Forces debug mode, perfect for testing event persistence & recovery
-     *
-     * @example
-     * await TraceLog.init({ id: SpecialProjectId.Fail });
-     * // or
-     * await TraceLog.init({ id: 'localhost:9999' });
-     * // Makes requests to: http://localhost:9999 (will fail)
-     */
-    SpecialProjectId["Fail"] = "localhost:9999";
-})(SpecialProjectId || (SpecialProjectId = {}));

package/dist/esm/types/tag.types.d.ts

@@ -1,43 +0,0 @@
-import { EventType } from './event.types';
-export declare enum TagLogicalOperator {
-    AND = "AND",
-    OR = "OR"
-}
-export declare enum TagConditionType {
-    URL_MATCHES = "url_matches",
-    ELEMENT_MATCHES = "element_matches",
-    DEVICE_TYPE = "device_type",
-    ELEMENT_TEXT = "element_text",
-    ELEMENT_ATTRIBUTE = "element_attribute",
-    UTM_SOURCE = "utm_source",
-    UTM_MEDIUM = "utm_medium",
-    UTM_CAMPAIGN = "utm_campaign"
-}
-export declare enum TagConditionOperator {
-    EQUALS = "equals",
-    CONTAINS = "contains",
-    STARTS_WITH = "starts_with",
-    ENDS_WITH = "ends_with",
-    REGEX = "regex",
-    GREATER_THAN = "greater_than",
-    LESS_THAN = "less_than",
-    EXISTS = "exists",
-    NOT_EXISTS = "not_exists"
-}
-export type TagConfig = Pick<Tag, 'key' | 'triggerType' | 'logicalOperator' | 'conditions'> & {
-    id: string;
-};
-export interface Tag {
-    key: string;
-    name: string;
-    description?: string;
-    active: boolean;
-    triggerType: EventType;
-    logicalOperator?: TagLogicalOperator;
-    conditions: TagCondition[];
-}
-export interface TagCondition {
-    type: TagConditionType;
-    operator: TagConditionOperator;
-    value: string;
-}

package/dist/esm/types/tag.types.js

@@ -1,28 +0,0 @@
-export var TagLogicalOperator;
-(function (TagLogicalOperator) {
-    TagLogicalOperator["AND"] = "AND";
-    TagLogicalOperator["OR"] = "OR";
-})(TagLogicalOperator || (TagLogicalOperator = {}));
-export var TagConditionType;
-(function (TagConditionType) {
-    TagConditionType["URL_MATCHES"] = "url_matches";
-    TagConditionType["ELEMENT_MATCHES"] = "element_matches";
-    TagConditionType["DEVICE_TYPE"] = "device_type";
-    TagConditionType["ELEMENT_TEXT"] = "element_text";
-    TagConditionType["ELEMENT_ATTRIBUTE"] = "element_attribute";
-    TagConditionType["UTM_SOURCE"] = "utm_source";
-    TagConditionType["UTM_MEDIUM"] = "utm_medium";
-    TagConditionType["UTM_CAMPAIGN"] = "utm_campaign";
-})(TagConditionType || (TagConditionType = {}));
-export var TagConditionOperator;
-(function (TagConditionOperator) {
-    TagConditionOperator["EQUALS"] = "equals";
-    TagConditionOperator["CONTAINS"] = "contains";
-    TagConditionOperator["STARTS_WITH"] = "starts_with";
-    TagConditionOperator["ENDS_WITH"] = "ends_with";
-    TagConditionOperator["REGEX"] = "regex";
-    TagConditionOperator["GREATER_THAN"] = "greater_than";
-    TagConditionOperator["LESS_THAN"] = "less_than";
-    TagConditionOperator["EXISTS"] = "exists";
-    TagConditionOperator["NOT_EXISTS"] = "not_exists";
-})(TagConditionOperator || (TagConditionOperator = {}));

package/dist/esm/utils/logging/debug-logger.utils.d.ts

@@ -1,14 +0,0 @@
-declare class DebugLogger {
-    clientError: (ns: string, msg: string, data?: unknown) => void;
-    clientWarn: (ns: string, msg: string, data?: unknown) => void;
-    info: (ns: string, msg: string, data?: unknown) => void;
-    error: (ns: string, msg: string, data?: unknown) => void;
-    warn: (ns: string, msg: string, data?: unknown) => void;
-    debug: (ns: string, msg: string, data?: unknown) => void;
-    verbose: (ns: string, msg: string, data?: unknown) => void;
-    private log;
-    private shouldShow;
-    private getMethod;
-}
-export declare const debugLog: DebugLogger;
-export {};

package/dist/esm/utils/logging/debug-logger.utils.js

@@ -1,44 +0,0 @@
-import { getGlobalState } from '../../managers/state.manager';
-class DebugLogger {
-    constructor() {
-        this.clientError = (ns, msg, data) => this.log('CLIENT_ERROR', ns, msg, data);
-        this.clientWarn = (ns, msg, data) => this.log('CLIENT_WARN', ns, msg, data);
-        this.info = (ns, msg, data) => this.log('INFO', ns, msg, data);
-        this.error = (ns, msg, data) => this.log('ERROR', ns, msg, data);
-        this.warn = (ns, msg, data) => this.log('WARN', ns, msg, data);
-        this.debug = (ns, msg, data) => this.log('DEBUG', ns, msg, data);
-        this.verbose = (ns, msg, data) => this.log('VERBOSE', ns, msg, data);
-    }
-    log(level, ns, msg, data) {
-        const mode = getGlobalState()?.config?.mode;
-        if (!this.shouldShow(level, mode))
-            return;
-        const formattedMsg = `[TraceLog:${ns}] ${msg}`;
-        const method = this.getMethod(level);
-        if (data !== undefined) {
-            console[method](formattedMsg, data);
-        }
-        else {
-            console[method](formattedMsg);
-        }
-    }
-    shouldShow(level, mode) {
-        if (['CLIENT_ERROR', 'ERROR'].includes(level))
-            return true;
-        if (!mode)
-            return level === 'CLIENT_WARN';
-        if (mode === 'qa')
-            return ['INFO', 'CLIENT_ERROR', 'CLIENT_WARN'].includes(level);
-        if (mode === 'debug')
-            return true; // Debug mode shows all logs
-        return false;
-    }
-    getMethod(level) {
-        if (['CLIENT_ERROR', 'ERROR'].includes(level))
-            return 'error';
-        if (['CLIENT_WARN', 'WARN'].includes(level))
-            return 'warn';
-        return 'log';
-    }
-}
-export const debugLog = new DebugLogger();

package/dist/esm/utils/logging/index.d.ts

@@ -1 +0,0 @@
-export { debugLog } from './debug-logger.utils';

package/dist/esm/utils/logging/index.js

@@ -1 +0,0 @@
-export { debugLog } from './debug-logger.utils';

package/dist/esm/utils/network/fetch-with-timeout.utils.d.ts

@@ -1,4 +0,0 @@
-export interface FetchWithTimeoutOptions extends RequestInit {
-    timeout?: number;
-}
-export declare function fetchWithTimeout(url: string, options?: FetchWithTimeoutOptions): Promise<Response>;

package/dist/esm/utils/network/fetch-with-timeout.utils.js

@@ -1,22 +0,0 @@
-export async function fetchWithTimeout(url, options = {}) {
-    const { timeout = 10000, ...fetchOptions } = options;
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => {
-        controller.abort();
-    }, timeout);
-    try {
-        const response = await fetch(url, {
-            ...fetchOptions,
-            signal: controller.signal,
-        });
-        clearTimeout(timeoutId);
-        return response;
-    }
-    catch (error) {
-        clearTimeout(timeoutId);
-        if (error instanceof Error && error.name === 'AbortError') {
-            throw new Error(`Request timeout after ${timeout}ms`);
-        }
-        throw error;
-    }
-}

package/dist/esm/utils/validations/url-validations.utils.d.ts

@@ -1,15 +0,0 @@
-/**
- * Validates if a URL is valid and optionally allows HTTP URLs
- * @param url - The URL to validate
- * @param allowHttp - Whether to allow HTTP URLs (default: false)
- * @returns True if the URL is valid, false otherwise
- */
-export declare const isValidUrl: (url: string, allowHttp?: boolean) => boolean;
-/**
- * Validates a URL field in configuration
- * @param url - The URL to validate
- * @param allowHttp - Whether to allow HTTP URLs
- * @param fieldName - The name of the field being validated
- * @param errors - Array to push errors to
- */
-export declare const validateUrl: (url: unknown, allowHttp: boolean | undefined, fieldName: string, errors: string[]) => void;

package/dist/esm/utils/validations/url-validations.utils.js

@@ -1,42 +0,0 @@
-/**
- * Validates if a URL is valid and optionally allows HTTP URLs
- * @param url - The URL to validate
- * @param allowHttp - Whether to allow HTTP URLs (default: false)
- * @returns True if the URL is valid, false otherwise
- */
-export const isValidUrl = (url, allowHttp = false) => {
-    try {
-        const parsed = new URL(url);
-        const isHttps = parsed.protocol === 'https:';
-        const isHttp = parsed.protocol === 'http:';
-        return isHttps || (allowHttp && isHttp);
-    }
-    catch {
-        return false;
-    }
-};
-/**
- * Validates a URL field in configuration
- * @param url - The URL to validate
- * @param allowHttp - Whether to allow HTTP URLs
- * @param fieldName - The name of the field being validated
- * @param errors - Array to push errors to
- */
-export const validateUrl = (url, allowHttp, fieldName, errors) => {
-    if (url !== undefined) {
-        if (typeof url === 'string') {
-            try {
-                const parsed = new URL(url);
-                if (parsed.protocol === 'http:' && !allowHttp) {
-                    errors.push(`${fieldName} using http requires allowHttp=true`);
-                }
-            }
-            catch {
-                errors.push(`${fieldName} must be a valid URL`);
-            }
-        }
-        else {
-            errors.push(`${fieldName} must be a string`);
-        }
-    }
-};