getu-attribution-v2-sdk 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,101 @@
+export declare enum EventType {
+    PAGE_VIEW = "page_view",
+    VIDEO_PLAY = "video_play",
+    FORM_SUBMIT = "form_submit",
+    EMAIL_VERIFICATION = "email_verification",
+    LOGIN = "login",
+    SIGNUP = "signup",
+    PRODUCT_VIEW = "product_view",
+    ADD_TO_CART = "add_to_cart",
+    PURCHASE = "purchase"
+}
+export declare enum Currency {
+    USD = "USD"
+}
+export interface UTMData {
+    utm_source?: string | null;
+    utm_medium?: string | null;
+    utm_campaign?: string | null;
+    utm_term?: string | null;
+    utm_content?: string | null;
+    timestamp: number;
+}
+export interface AttributionData {
+    firstTouch: UTMData;
+    lastTouch: UTMData;
+    touchpoints: UTMData[];
+    expiresAt: number;
+}
+export interface EventData {
+    event_id: string;
+    event_type: EventType;
+    tracking_user_id?: string;
+    utm_source?: string | null;
+    utm_medium?: string | null;
+    utm_campaign?: string | null;
+    utm_term?: string | null;
+    utm_content?: string | null;
+    revenue?: number | null;
+    currency?: Currency | null;
+    event_data?: Record<string, any> | null;
+    context?: {
+        page?: {
+            domain?: string | null;
+            path?: string | null;
+            title?: string | null;
+            referrer?: string | null;
+            url?: string | null;
+            querystring?: string | null;
+            query_params?: Record<string, string> | null;
+        };
+        [key: string]: any;
+    } | null;
+    timestamp?: number;
+}
+export interface BatchEventRequest {
+    events: EventData[];
+}
+export declare const defaultEndpoint = "https://attribution.getu.ai/attribution/api";
+export interface SDKConfig {
+    apiKey: string;
+    apiEndpoint?: string;
+    batchSize?: number;
+    batchInterval?: number;
+    maxRetries?: number;
+    retryDelay?: number;
+    enableDebug?: boolean;
+    autoTrack?: boolean;
+    autoTrackPageView?: boolean;
+    sessionTimeout?: number;
+    enableCrossDomainUTM?: boolean;
+    crossDomainUTMParams?: string[];
+    excludeDomains?: string[];
+    autoCleanUTM?: boolean;
+    pageViewDebounceInterval?: number;
+}
+export interface StorageInterface {
+    get(key: string): any;
+    set(key: string, value: any): void;
+    remove(key: string): void;
+    clear(): void;
+}
+export interface QueueInterface {
+    add(event: EventData): void;
+    process(): Promise<void>;
+    clear(): void;
+    size(): number;
+}
+export interface LoggerInterface {
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}
+export interface UserSession {
+    sessionId: string;
+    startTime: number;
+    lastActivity: number;
+    pageViews: number;
+}
+export declare const IMMEDIATE_EVENTS: EventType[];
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,32 @@
+// Event types matching server-side enum exactly
+export var EventType;
+(function (EventType) {
+    // Pre-conversion signals
+    EventType["PAGE_VIEW"] = "page_view";
+    EventType["VIDEO_PLAY"] = "video_play";
+    // Registration funnel
+    EventType["FORM_SUBMIT"] = "form_submit";
+    EventType["EMAIL_VERIFICATION"] = "email_verification";
+    // Login flow
+    EventType["LOGIN"] = "login";
+    // Signup flow
+    EventType["SIGNUP"] = "signup";
+    // Purchase funnel
+    EventType["PRODUCT_VIEW"] = "product_view";
+    EventType["ADD_TO_CART"] = "add_to_cart";
+    EventType["PURCHASE"] = "purchase";
+})(EventType || (EventType = {}));
+// Currency types
+export var Currency;
+(function (Currency) {
+    Currency["USD"] = "USD";
+})(Currency || (Currency = {}));
+export const defaultEndpoint = "https://attribution.getu.ai/attribution/api";
+// Special events that should be sent immediately
+export const IMMEDIATE_EVENTS = [
+    EventType.PURCHASE,
+    EventType.LOGIN,
+    EventType.SIGNUP,
+    EventType.FORM_SUBMIT,
+    EventType.EMAIL_VERIFICATION,
+];

package/dist/utils/index.d.ts

@@ -0,0 +1,36 @@
+import { LoggerInterface, UTMData } from "../types";
+export declare function generateId(): string;
+export declare function getTimestamp(): number;
+export declare function parseUrlParams(url: string): Record<string, string>;
+export declare function extractUTMParams(url: string): Record<string, string>;
+export declare function isLocalStorageSupported(): boolean;
+export declare function isIndexedDBSupported(): boolean;
+export declare function deepClone<T>(obj: T): T;
+export declare function debounce<T extends (...args: any[]) => any>(func: T, wait: number): (...args: Parameters<T>) => void;
+export declare function throttle<T extends (...args: any[]) => any>(func: T, limit: number): (...args: Parameters<T>) => void;
+export declare function retry<T>(fn: () => Promise<T>, maxRetries?: number, baseDelay?: number): Promise<T>;
+export declare class ConsoleLogger implements LoggerInterface {
+    private enabled;
+    constructor(enabled?: boolean);
+    debug(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+}
+export declare function getUserAgent(): string;
+export declare function getReferrer(): string;
+export declare function getCurrentUrl(): string;
+export declare function getPageTitle(): string;
+export declare function isOnline(): boolean;
+export declare function generateSessionId(): string;
+export declare function isValidEmail(email: string): boolean;
+export declare function formatCurrency(amount: number, currency?: string): string;
+export declare function addUTMToURL(url: string, utmParams: Record<string, string>): string;
+export declare function shouldExcludeDomain(url: string, excludeDomains?: string[]): boolean;
+export declare function getDomainFromURL(url: string): string | null;
+export declare function isExternalURL(url: string): boolean;
+export declare function filterUTMParams(utmData: Partial<UTMData>, allowedParams?: string[]): Record<string, string>;
+export declare function getQueryString(url?: string): string;
+export declare function getQueryParams(url?: string): Record<string, string>;
+export declare function cleanURL(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

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

package/dist/utils/index.js

@@ -0,0 +1,297 @@
+// Generate unique ID
+export function generateId() {
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, function (c) {
+        const r = (Math.random() * 16) | 0;
+        const v = c === "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+// Generate timestamp in seconds
+export function getTimestamp() {
+    return Math.floor(Date.now() / 1000);
+}
+// Parse URL parameters
+export function parseUrlParams(url) {
+    const params = {};
+    try {
+        const urlObj = new URL(url);
+        urlObj.searchParams.forEach((value, key) => {
+            params[key] = value;
+        });
+    }
+    catch (error) {
+        // Handle invalid URLs
+    }
+    return params;
+}
+// Extract UTM parameters from URL
+export function extractUTMParams(url) {
+    const params = parseUrlParams(url);
+    const utmParams = {};
+    const utmKeys = [
+        "utm_source",
+        "utm_medium",
+        "utm_campaign",
+        "utm_term",
+        "utm_content",
+    ];
+    utmKeys.forEach((key) => {
+        if (params[key] && params[key].trim() !== "") {
+            utmParams[key] = params[key].trim();
+        }
+    });
+    return utmParams;
+}
+// Check if browser supports localStorage
+export function isLocalStorageSupported() {
+    try {
+        const test = "__localStorage_test__";
+        localStorage.setItem(test, test);
+        localStorage.removeItem(test);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// Check if browser supports IndexedDB
+export function isIndexedDBSupported() {
+    return "indexedDB" in window;
+}
+// Deep clone object
+export function deepClone(obj) {
+    if (obj === null || typeof obj !== "object") {
+        return obj;
+    }
+    if (obj instanceof Date) {
+        return new Date(obj.getTime());
+    }
+    if (obj instanceof Array) {
+        return obj.map((item) => deepClone(item));
+    }
+    if (typeof obj === "object") {
+        const cloned = {};
+        for (const key in obj) {
+            if (obj.hasOwnProperty(key)) {
+                cloned[key] = deepClone(obj[key]);
+            }
+        }
+        return cloned;
+    }
+    return obj;
+}
+// Debounce function
+export function debounce(func, wait) {
+    let timeout;
+    return (...args) => {
+        clearTimeout(timeout);
+        timeout = setTimeout(() => func(...args), wait);
+    };
+}
+// Throttle function
+export function throttle(func, limit) {
+    let inThrottle;
+    return (...args) => {
+        if (!inThrottle) {
+            func(...args);
+            inThrottle = true;
+            setTimeout(() => (inThrottle = false), limit);
+        }
+    };
+}
+// Retry function with exponential backoff
+export async function retry(fn, maxRetries = 3, baseDelay = 1000) {
+    let lastError;
+    for (let i = 0; i <= maxRetries; i++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (i === maxRetries) {
+                throw lastError;
+            }
+            const delay = baseDelay * Math.pow(2, i);
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    throw lastError;
+}
+// Console logger implementation
+export class ConsoleLogger {
+    constructor(enabled = true) {
+        this.enabled = enabled;
+    }
+    debug(message, ...args) {
+        if (this.enabled && console.debug) {
+            console.debug(`[GetuAI Debug] ${message}`, ...args);
+        }
+    }
+    info(message, ...args) {
+        if (this.enabled && console.info) {
+            console.info(`[GetuAI Info] ${message}`, ...args);
+        }
+    }
+    warn(message, ...args) {
+        if (this.enabled && console.warn) {
+            console.warn(`[GetuAI Warn] ${message}`, ...args);
+        }
+    }
+    error(message, ...args) {
+        if (this.enabled && console.error) {
+            console.error(`[GetuAI Error] ${message}`, ...args);
+        }
+    }
+}
+// Get user agent info
+export function getUserAgent() {
+    return navigator.userAgent || "";
+}
+// Get referrer
+export function getReferrer() {
+    return document.referrer || "";
+}
+// Get current URL
+export function getCurrentUrl() {
+    return window.location.href;
+}
+// Get page title
+export function getPageTitle() {
+    return document.title || "";
+}
+// Check if user is online
+export function isOnline() {
+    return navigator.onLine;
+}
+// Generate session ID
+export function generateSessionId() {
+    return `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+// Validate email format
+export function isValidEmail(email) {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+}
+// Format currency
+export function formatCurrency(amount, currency = "USD") {
+    return new Intl.NumberFormat("en-US", {
+        style: "currency",
+        currency: currency,
+    }).format(amount);
+}
+// Add UTM parameters to URL
+export function addUTMToURL(url, utmParams) {
+    try {
+        const urlObj = new URL(url);
+        // Add UTM parameters if they don't already exist
+        Object.entries(utmParams).forEach(([key, value]) => {
+            if (value && !urlObj.searchParams.has(key)) {
+                urlObj.searchParams.set(key, value);
+            }
+        });
+        return urlObj.toString();
+    }
+    catch (error) {
+        // If URL parsing fails, return original URL
+        return url;
+    }
+}
+// Check if domain should be excluded from UTM passing
+export function shouldExcludeDomain(url, excludeDomains = []) {
+    try {
+        const urlObj = new URL(url);
+        const hostname = urlObj.hostname.toLowerCase();
+        return excludeDomains.some((domain) => {
+            const excludeDomain = domain.toLowerCase();
+            return (hostname === excludeDomain || hostname.endsWith(`.${excludeDomain}`));
+        });
+    }
+    catch (error) {
+        return false;
+    }
+}
+// Get domain from URL
+export function getDomainFromURL(url) {
+    try {
+        const urlObj = new URL(url);
+        return urlObj.hostname;
+    }
+    catch (error) {
+        return null;
+    }
+}
+// Check if URL is external (different domain)
+export function isExternalURL(url) {
+    try {
+        const urlObj = new URL(url);
+        const currentDomain = window.location.hostname;
+        return urlObj.hostname !== currentDomain;
+    }
+    catch (error) {
+        return false;
+    }
+}
+// Filter UTM parameters based on configuration
+export function filterUTMParams(utmData, allowedParams = ["utm_source", "utm_medium", "utm_campaign"]) {
+    const filtered = {};
+    allowedParams.forEach((param) => {
+        if (utmData[param]) {
+            filtered[param] = utmData[param];
+        }
+    });
+    return filtered;
+}
+// Get query string from URL
+export function getQueryString(url) {
+    try {
+        const targetUrl = url || window.location.href;
+        const urlObj = new URL(targetUrl);
+        return urlObj.search;
+    }
+    catch (error) {
+        return "";
+    }
+}
+// Get query parameters as object
+export function getQueryParams(url) {
+    try {
+        const targetUrl = url || window.location.href;
+        const urlObj = new URL(targetUrl);
+        const params = {};
+        urlObj.searchParams.forEach((value, key) => {
+            params[key] = value;
+        });
+        return params;
+    }
+    catch (error) {
+        return {};
+    }
+}
+// Clean URL by removing UTM parameters
+export function cleanURL() {
+    try {
+        const currentUrl = new URL(window.location.href);
+        const utmKeys = [
+            "utm_source",
+            "utm_medium",
+            "utm_campaign",
+            "utm_term",
+            "utm_content",
+        ];
+        let hasParams = false;
+        utmKeys.forEach((key) => {
+            if (currentUrl.searchParams.has(key)) {
+                currentUrl.searchParams.delete(key);
+                hasParams = true;
+            }
+        });
+        if (hasParams) {
+            // Use replaceState to avoid page reload and history entry
+            window.history.replaceState({}, document.title, currentUrl.toString());
+        }
+    }
+    catch (error) {
+        // Handle invalid URLs silently
+        console.warn("Failed to clean URL:", error);
+    }
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "getu-attribution-v2-sdk",
+  "version": "0.1.0",
+  "description": "GetuAI Attribution SDK for client-side tracking",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "browser": "dist/getuai-attribution.min.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./browser": {
+      "import": "./dist/getuai-attribution.min.js",
+      "require": "./dist/getuai-attribution.min.js"
+    }
+  },
+  "scripts": {
+    "build": "npm run clean && tsc && webpack --mode production && npm run build:esm",
+    "build:dev": "npm run clean && tsc && webpack --mode development && npm run build:esm",
+    "build:esm": "rollup -c",
+    "dev": "webpack --mode development --watch",
+    "test": "jest",
+    "lint": "eslint src/**/*.ts",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "attribution",
+    "tracking",
+    "analytics",
+    "utm",
+    "conversion"
+  ],
+  "author": "GetuAI",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@typescript-eslint/eslint-plugin": "^5.59.0",
+    "@typescript-eslint/parser": "^5.59.0",
+    "eslint": "^8.38.0",
+    "jest": "^29.5.0",
+    "rimraf": "^5.0.0",
+    "rollup": "^3.28.0",
+    "@rollup/plugin-typescript": "^11.1.0",
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "ts-jest": "^29.1.0",
+    "ts-loader": "^9.4.0",
+    "typescript": "^5.0.0",
+    "webpack": "^5.88.0",
+    "webpack-cli": "^5.1.0"
+  },
+  "files": [
+    "dist",
+    "example-script.html"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}