getu-attribution-v2-sdk 0.2.1 → 0.2.3

package/dist/index.js

@@ -39,7 +39,7 @@ __webpack_require__.d(__webpack_exports__, {
   "default": () => (/* binding */ src)
 });
 
-// UNUSED EXPORTS: AttributionSDK, Currency, EventType, addUTMToURL, destroy, flush, getAttributionData, getCurrentUTMParams, getSDK, getStatus, init, trackAddToCart, trackEmailVerification, trackEvent, trackFormSubmit, trackLogin, trackPageClick, trackPageView, trackProductView, trackPurchase, trackSignup, trackVideoPlay, waitForSDK
+// UNUSED EXPORTS: AttributionSDK, Currency, EventType, addUTMToURL, destroy, flush, getAttributionData, getCurrentUTMParams, getSDK, getStatus, getUserId, init, removeUserId, setUserId, trackAddToCart, trackAuditApproved, trackEmailVerification, trackEmailVerificationAuto, trackEvent, trackFormSubmit, trackLogin, trackLoginAuto, trackPageClick, trackPageView, trackProductView, trackPurchase, trackPurchaseAuto, trackSignup, trackSignupAuto, trackVideoPlay, waitForSDK
 
 ;// ./src/types/index.ts
 // Event types matching server-side enum exactly
@@ -60,6 +60,8 @@ var EventType;
     EventType["PRODUCT_VIEW"] = "product_view";
     EventType["ADD_TO_CART"] = "add_to_cart";
     EventType["PURCHASE"] = "purchase";
+    // Post-conversion / back-office conversion
+    EventType["AUDIT_APPROVED"] = "audit_approved";
 })(EventType || (EventType = {}));
 // Currency types
 var Currency;
@@ -74,6 +76,7 @@ const IMMEDIATE_EVENTS = [
     EventType.SIGNUP,
     EventType.FORM_SUBMIT,
     EventType.EMAIL_VERIFICATION,
+    EventType.AUDIT_APPROVED,
 ];
 
 ;// ./src/utils/index.ts
@@ -652,10 +655,131 @@ class AttributionStorageManager {
     constructor(logger) {
         this.UTM_STORAGE_KEY = "attribution_utm_data";
         this.SESSION_STORAGE_KEY = "attribution_session";
+        this.USER_ID_KEY = "getuai_user_id";
+        this.USER_ID_COOKIE_EXPIRES = 365; // days
         this.logger = logger;
         this.localStorage = new LocalStorageManager(logger);
         this.indexedDB = new IndexedDBManager(logger);
     }
+    // User ID management - stores in both cookie and localStorage
+    setUserId(userId) {
+        if (!userId || userId.trim() === "") {
+            this.logger.warn("Cannot set empty user ID");
+            return;
+        }
+        const trimmedUserId = userId.trim();
+        // Store in cookie
+        try {
+            this.setCookie(this.USER_ID_KEY, trimmedUserId, this.USER_ID_COOKIE_EXPIRES);
+            this.logger.debug(`👤 User ID stored in cookie: ${trimmedUserId}`);
+        }
+        catch (error) {
+            this.logger.error("Failed to store user ID in cookie:", error);
+        }
+        // Store in localStorage
+        try {
+            if (typeof localStorage !== "undefined") {
+                localStorage.setItem(this.USER_ID_KEY, trimmedUserId);
+                this.logger.debug(`👤 User ID stored in localStorage: ${trimmedUserId}`);
+            }
+        }
+        catch (error) {
+            this.logger.error("Failed to store user ID in localStorage:", error);
+        }
+    }
+    getUserId() {
+        // Try localStorage first
+        try {
+            if (typeof localStorage !== "undefined") {
+                const userId = localStorage.getItem(this.USER_ID_KEY);
+                if (userId) {
+                    return userId;
+                }
+            }
+        }
+        catch (error) {
+            this.logger.debug("Failed to get user ID from localStorage:", error);
+        }
+        // Fallback to cookie
+        try {
+            const userId = this.getCookie(this.USER_ID_KEY);
+            if (userId) {
+                // Sync back to localStorage if cookie exists but localStorage doesn't
+                try {
+                    if (typeof localStorage !== "undefined") {
+                        localStorage.setItem(this.USER_ID_KEY, userId);
+                    }
+                }
+                catch (error) {
+                    // Ignore sync errors
+                }
+                return userId;
+            }
+        }
+        catch (error) {
+            this.logger.debug("Failed to get user ID from cookie:", error);
+        }
+        return null;
+    }
+    removeUserId() {
+        // Remove from cookie
+        try {
+            this.deleteCookie(this.USER_ID_KEY);
+            this.logger.debug("👤 User ID removed from cookie");
+        }
+        catch (error) {
+            this.logger.error("Failed to remove user ID from cookie:", error);
+        }
+        // Remove from localStorage
+        try {
+            if (typeof localStorage !== "undefined") {
+                localStorage.removeItem(this.USER_ID_KEY);
+                this.logger.debug("👤 User ID removed from localStorage");
+            }
+        }
+        catch (error) {
+            this.logger.error("Failed to remove user ID from localStorage:", error);
+        }
+    }
+    // Cookie helper methods
+    setCookie(name, value, days) {
+        try {
+            const expires = new Date();
+            expires.setTime(expires.getTime() + days * 24 * 60 * 60 * 1000);
+            const cookieValue = `${name}=${encodeURIComponent(value)};expires=${expires.toUTCString()};path=/;SameSite=Lax`;
+            document.cookie = cookieValue;
+        }
+        catch (error) {
+            this.logger.error("Failed to set cookie:", error);
+        }
+    }
+    getCookie(name) {
+        try {
+            const nameEQ = name + "=";
+            const ca = document.cookie.split(";");
+            for (let i = 0; i < ca.length; i++) {
+                let c = ca[i];
+                while (c.charAt(0) === " ")
+                    c = c.substring(1, c.length);
+                if (c.indexOf(nameEQ) === 0) {
+                    return decodeURIComponent(c.substring(nameEQ.length, c.length));
+                }
+            }
+            return null;
+        }
+        catch (error) {
+            this.logger.error("Failed to get cookie:", error);
+            return null;
+        }
+    }
+    deleteCookie(name) {
+        try {
+            document.cookie = `${name}=;expires=Thu, 01 Jan 1970 00:00:00 UTC;path=/;`;
+        }
+        catch (error) {
+            this.logger.error("Failed to delete cookie:", error);
+        }
+    }
     async init() {
         await this.indexedDB.init();
     }
@@ -1020,8 +1144,17 @@ class AttributionSDK {
         }
         try {
             this.logger.info("Initializing GetuAI Attribution SDK");
-            // Initialize storage
-            await this.storage.init();
+            // Initialize storage (IndexedDB failure should not block SDK initialization)
+            try {
+                await this.storage.init();
+            }
+            catch (storageError) {
+                this.logger.warn("Storage initialization failed (IndexedDB may be unavailable), continuing with basic features:", storageError);
+                // Continue initialization even if IndexedDB fails
+                // User ID and other features using cookie/localStorage will still work
+            }
+            // Initialize user ID (from config or existing storage)
+            this.initializeUserId();
             // Initialize session
             this.initializeSession();
             // Extract and store UTM data from current URL
@@ -1094,10 +1227,12 @@ class AttributionSDK {
                 last_activity: this.session?.lastActivity,
                 page_views: this.session?.pageViews,
             };
+            // Use provided tracking_user_id or fallback to stored user ID
+            const finalUserId = tracking_user_id || this.getUserId();
             const event = {
                 event_id: generateId(),
                 event_type: eventType,
-                tracking_user_id: tracking_user_id,
+                tracking_user_id: finalUserId || undefined,
                 timestamp: getTimestamp(),
                 event_data: eventData,
                 context: { page: pageContext, session: sessionContext },
@@ -1194,6 +1329,46 @@ class AttributionSDK {
     async trackEmailVerification(tracking_user_id, verificationData) {
         await this.trackEvent(EventType.EMAIL_VERIFICATION, verificationData, tracking_user_id);
     }
+    // Track audit approved (conversion)
+    async trackAuditApproved(tracking_user_id, auditData) {
+        await this.trackEvent(EventType.AUDIT_APPROVED, auditData, tracking_user_id);
+    }
+    // Track purchase with auto user ID (object parameter format)
+    async trackPurchaseAuto(options) {
+        const userId = options.tracking_user_id || this.getUserId();
+        if (!userId) {
+            this.logger.error("❌ trackPurchaseAuto requires tracking_user_id. Please set user ID using setUserId() or pass it in options.tracking_user_id.");
+            return;
+        }
+        await this.trackEvent(EventType.PURCHASE, options.purchaseData, userId, options.revenue, options.currency || Currency.USD);
+    }
+    // Track login with auto user ID (object parameter format)
+    async trackLoginAuto(options) {
+        const userId = options.tracking_user_id || this.getUserId();
+        if (!userId) {
+            this.logger.error("❌ trackLoginAuto requires tracking_user_id. Please set user ID using setUserId() or pass it in options.tracking_user_id.");
+            return;
+        }
+        await this.trackEvent(EventType.LOGIN, options.loginData, userId);
+    }
+    // Track signup with auto user ID (object parameter format)
+    async trackSignupAuto(options) {
+        const userId = options.tracking_user_id || this.getUserId();
+        if (!userId) {
+            this.logger.error("❌ trackSignupAuto requires tracking_user_id. Please set user ID using setUserId() or pass it in options.tracking_user_id.");
+            return;
+        }
+        await this.trackEvent(EventType.SIGNUP, options.signupData, userId);
+    }
+    // Track email verification with auto user ID (object parameter format)
+    async trackEmailVerificationAuto(options) {
+        const userId = options.tracking_user_id || this.getUserId();
+        if (!userId) {
+            this.logger.error("❌ trackEmailVerificationAuto requires tracking_user_id. Please set user ID using setUserId() or pass it in options.tracking_user_id.");
+            return;
+        }
+        await this.trackEvent(EventType.EMAIL_VERIFICATION, options.verificationData, userId);
+    }
     // Track product view
     async trackProductView(tracking_user_id, productData) {
         await this.trackEvent(EventType.PRODUCT_VIEW, productData, tracking_user_id);
@@ -1279,6 +1454,42 @@ class AttributionSDK {
         this.logger.debug("UTM params for event:", filteredParams);
         return filteredParams;
     }
+    // Initialize user ID
+    initializeUserId() {
+        // If userId is provided in config, set it (will override existing)
+        if (this.config.userId) {
+            this.setUserId(this.config.userId);
+            this.logger.info(`👤 User ID initialized from config: ${this.config.userId}`);
+        }
+        else {
+            // Check if user ID already exists in storage
+            const existingUserId = this.getUserId();
+            if (existingUserId) {
+                this.logger.debug(`👤 Existing user ID found: ${existingUserId}`);
+            }
+            else {
+                this.logger.debug("👤 No user ID found, will be set when user identifies");
+            }
+        }
+    }
+    // Set user ID
+    setUserId(userId) {
+        if (!userId || userId.trim() === "") {
+            this.logger.warn("Cannot set empty user ID");
+            return;
+        }
+        this.storage.setUserId(userId);
+        this.logger.info(`👤 User ID set: ${userId}`);
+    }
+    // Get user ID
+    getUserId() {
+        return this.storage.getUserId();
+    }
+    // Remove user ID
+    removeUserId() {
+        this.storage.removeUserId();
+        this.logger.info("👤 User ID removed");
+    }
     // Initialize user session
     initializeSession() {
         const existingSession = this.storage.getSession();
@@ -1731,6 +1942,7 @@ function autoInit() {
         autoCleanUTM: script.getAttribute("data-auto-clean-utm") !== "false",
         batchSize: parseInt(script.getAttribute("data-batch-size") || "100"),
         batchInterval: parseInt(script.getAttribute("data-batch-interval") || "2000"),
+        userId: script.getAttribute("data-user-id") || undefined,
     };
     // Initialize SDK
     init(config);
@@ -1874,6 +2086,51 @@ async function trackEmailVerification(tracking_user_id, verificationData) {
     }
     await sdk.trackEmailVerification(tracking_user_id, verificationData);
 }
+// Track audit approved (conversion)
+async function trackAuditApproved(tracking_user_id, auditData) {
+    const sdk = getSDK();
+    if (!sdk) {
+        console.warn("GetuAI SDK: Not initialized. Call init() first.");
+        return;
+    }
+    await sdk.trackAuditApproved(tracking_user_id, auditData);
+}
+// Track purchase with auto user ID (object parameter format)
+async function trackPurchaseAuto(options) {
+    const sdk = getSDK();
+    if (!sdk) {
+        console.warn("GetuAI SDK: Not initialized. Call init() first.");
+        return;
+    }
+    await sdk.trackPurchaseAuto(options);
+}
+// Track login with auto user ID (object parameter format)
+async function trackLoginAuto(options) {
+    const sdk = getSDK();
+    if (!sdk) {
+        console.warn("GetuAI SDK: Not initialized. Call init() first.");
+        return;
+    }
+    await sdk.trackLoginAuto(options);
+}
+// Track signup with auto user ID (object parameter format)
+async function trackSignupAuto(options) {
+    const sdk = getSDK();
+    if (!sdk) {
+        console.warn("GetuAI SDK: Not initialized. Call init() first.");
+        return;
+    }
+    await sdk.trackSignupAuto(options);
+}
+// Track email verification with auto user ID (object parameter format)
+async function trackEmailVerificationAuto(options) {
+    const sdk = getSDK();
+    if (!sdk) {
+        console.warn("GetuAI SDK: Not initialized. Call init() first.");
+        return;
+    }
+    await sdk.trackEmailVerificationAuto(options);
+}
 // Track product view
 async function trackProductView(tracking_user_id, productData) {
     const sdk = getSDK();
@@ -1943,6 +2200,33 @@ function getCurrentUTMParams() {
     }
     return sdk.getCurrentUTMParams();
 }
+// Set user ID
+function setUserId(userId) {
+    const sdk = getSDK();
+    if (!sdk) {
+        console.warn("GetuAI SDK: Not initialized. Call init() first.");
+        return;
+    }
+    sdk.setUserId(userId);
+}
+// Get user ID
+function getUserId() {
+    const sdk = getSDK();
+    if (!sdk) {
+        console.warn("GetuAI SDK: Not initialized. Call init() first.");
+        return null;
+    }
+    return sdk.getUserId();
+}
+// Remove user ID
+function removeUserId() {
+    const sdk = getSDK();
+    if (!sdk) {
+        console.warn("GetuAI SDK: Not initialized. Call init() first.");
+        return;
+    }
+    sdk.removeUserId();
+}
 // Destroy SDK
 function destroy() {
     if (globalSDK) {
@@ -1989,6 +2273,22 @@ class AttributionSDKStatic extends AttributionSDK {
     static async trackEmailVerification(tracking_user_id, verificationData) {
         return await trackEmailVerification(tracking_user_id, verificationData);
     }
+    // Static method to track purchase with auto user ID
+    static async trackPurchaseAuto(options) {
+        return await trackPurchaseAuto(options);
+    }
+    // Static method to track login with auto user ID
+    static async trackLoginAuto(options) {
+        return await trackLoginAuto(options);
+    }
+    // Static method to track signup with auto user ID
+    static async trackSignupAuto(options) {
+        return await trackSignupAuto(options);
+    }
+    // Static method to track email verification with auto user ID
+    static async trackEmailVerificationAuto(options) {
+        return await trackEmailVerificationAuto(options);
+    }
     // Static method to track product view
     static async trackProductView(tracking_user_id, productData) {
         return await trackProductView(tracking_user_id, productData);
@@ -2021,6 +2321,18 @@ class AttributionSDKStatic extends AttributionSDK {
     static getCurrentUTMParams() {
         return getCurrentUTMParams();
     }
+    // Static method to set user ID
+    static setUserId(userId) {
+        setUserId(userId);
+    }
+    // Static method to get user ID
+    static getUserId() {
+        return getUserId();
+    }
+    // Static method to remove user ID
+    static removeUserId() {
+        removeUserId();
+    }
     // Static method to destroy SDK
     static destroy() {
         destroy();
@@ -2061,13 +2373,21 @@ if (typeof window !== "undefined") {
         trackFormSubmit,
         trackVideoPlay,
         trackEmailVerification,
+        trackAuditApproved,
         trackProductView,
         trackAddToCart,
+        trackPurchaseAuto,
+        trackLoginAuto,
+        trackSignupAuto,
+        trackEmailVerificationAuto,
         getAttributionData,
         flush,
         getStatus,
         addUTMToURL: src_addUTMToURL,
         getCurrentUTMParams,
+        setUserId,
+        getUserId,
+        removeUserId,
         destroy,
         EventType: EventType,
         Currency: Currency,
@@ -2087,11 +2407,18 @@ if (typeof window !== "undefined") {
     window.trackEmailVerification = trackEmailVerification;
     window.trackProductView = trackProductView;
     window.trackAddToCart = trackAddToCart;
+    window.trackPurchaseAuto = trackPurchaseAuto;
+    window.trackLoginAuto = trackLoginAuto;
+    window.trackSignupAuto = trackSignupAuto;
+    window.trackEmailVerificationAuto = trackEmailVerificationAuto;
     window.getAttributionData = getAttributionData;
     window.flush = flush;
     window.getStatus = getStatus;
     window.addUTMToURL = src_addUTMToURL;
     window.getCurrentUTMParams = getCurrentUTMParams;
+    window.setUserId = setUserId;
+    window.getUserId = getUserId;
+    window.removeUserId = removeUserId;
     window.destroy = destroy;
     window.AttributionSDK = AttributionSDKStatic; // 直接暴露带静态方法的AttributionSDK类
 }
@@ -2111,11 +2438,18 @@ if (typeof window !== "undefined") {
     trackEmailVerification,
     trackProductView,
     trackAddToCart,
+    trackPurchaseAuto,
+    trackLoginAuto,
+    trackSignupAuto,
+    trackEmailVerificationAuto,
     getAttributionData,
     flush,
     getStatus,
     addUTMToURL: src_addUTMToURL,
     getCurrentUTMParams,
+    setUserId,
+    getUserId,
+    removeUserId,
     destroy,
     EventType: EventType,
     Currency: Currency,

package/dist/storage/index.d.ts

@@ -29,7 +29,15 @@ export declare class AttributionStorageManager {
     private logger;
     private readonly UTM_STORAGE_KEY;
     private readonly SESSION_STORAGE_KEY;
+    private readonly USER_ID_KEY;
+    private readonly USER_ID_COOKIE_EXPIRES;
     constructor(logger: LoggerInterface);
+    setUserId(userId: string): void;
+    getUserId(): string | null;
+    removeUserId(): void;
+    private setCookie;
+    private getCookie;
+    private deleteCookie;
     init(): Promise<void>;
     storeUTMData(utmData: Partial<AttributionData>): void;
     getUTMData(): AttributionData | null;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,eAAe,EAEhB,MAAM,UAAU,CAAC;AASlB,qBAAa,mBAAoB,YAAW,gBAAgB;IAC1D,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IAInC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAmBrB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAelC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAUzB,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,mBAAmB;CA4B5B;AAGD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,EAAE,CAA4B;gBAE1B,MAAM,EAAE,eAAe;IAI7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCrB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BzC,eAAe,CAAC,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA2B1D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuDnD,gBAAgB,CACpB,MAAM,GAAE,MAAgC,GACvC,OAAO,CAAC,IAAI,CAAC;IAgCV,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAqB/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB7B;AAGD,qBAAa,yBAAyB;IACpC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0B;IAC1D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyB;gBAEjD,MAAM,EAAE,eAAe;IAM7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAkCrD,UAAU,IAAI,eAAe,GAAG,IAAI;IAepC,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAIhC,UAAU,IAAI,GAAG;IAKX,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3C,eAAe,CAAC,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAI1D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC,kBAAkB,IAAI,IAAI;CAG3B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,eAAe,EAEhB,MAAM,UAAU,CAAC;AASlB,qBAAa,mBAAoB,YAAW,gBAAgB;IAC1D,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IAInC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAmBrB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAelC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAUzB,KAAK,IAAI,IAAI;IAUb,OAAO,CAAC,mBAAmB;CA4B5B;AAGD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,EAAE,CAA4B;gBAE1B,MAAM,EAAE,eAAe;IAI7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAoCrB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BzC,eAAe,CAAC,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA2B1D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAuDnD,gBAAgB,CACpB,MAAM,GAAE,MAAgC,GACvC,OAAO,CAAC,IAAI,CAAC;IAgCV,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAqB/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAqB7B;AAGD,qBAAa,yBAAyB;IACpC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0B;IAC1D,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAyB;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAO;gBAElC,MAAM,EAAE,eAAe;IAOnC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAiC/B,SAAS,IAAI,MAAM,GAAG,IAAI;IAkC1B,YAAY,IAAI,IAAI;IAqBpB,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,YAAY;IAQd,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAkCrD,UAAU,IAAI,eAAe,GAAG,IAAI;IAepC,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAIhC,UAAU,IAAI,GAAG;IAKX,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3C,eAAe,CAAC,KAAK,GAAE,MAAY,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAI1D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC,kBAAkB,IAAI,IAAI;CAG3B"}

package/dist/storage/index.js

@@ -274,10 +274,131 @@ export class AttributionStorageManager {
     constructor(logger) {
         this.UTM_STORAGE_KEY = "attribution_utm_data";
         this.SESSION_STORAGE_KEY = "attribution_session";
+        this.USER_ID_KEY = "getuai_user_id";
+        this.USER_ID_COOKIE_EXPIRES = 365; // days
         this.logger = logger;
         this.localStorage = new LocalStorageManager(logger);
         this.indexedDB = new IndexedDBManager(logger);
     }
+    // User ID management - stores in both cookie and localStorage
+    setUserId(userId) {
+        if (!userId || userId.trim() === "") {
+            this.logger.warn("Cannot set empty user ID");
+            return;
+        }
+        const trimmedUserId = userId.trim();
+        // Store in cookie
+        try {
+            this.setCookie(this.USER_ID_KEY, trimmedUserId, this.USER_ID_COOKIE_EXPIRES);
+            this.logger.debug(`👤 User ID stored in cookie: ${trimmedUserId}`);
+        }
+        catch (error) {
+            this.logger.error("Failed to store user ID in cookie:", error);
+        }
+        // Store in localStorage
+        try {
+            if (typeof localStorage !== "undefined") {
+                localStorage.setItem(this.USER_ID_KEY, trimmedUserId);
+                this.logger.debug(`👤 User ID stored in localStorage: ${trimmedUserId}`);
+            }
+        }
+        catch (error) {
+            this.logger.error("Failed to store user ID in localStorage:", error);
+        }
+    }
+    getUserId() {
+        // Try localStorage first
+        try {
+            if (typeof localStorage !== "undefined") {
+                const userId = localStorage.getItem(this.USER_ID_KEY);
+                if (userId) {
+                    return userId;
+                }
+            }
+        }
+        catch (error) {
+            this.logger.debug("Failed to get user ID from localStorage:", error);
+        }
+        // Fallback to cookie
+        try {
+            const userId = this.getCookie(this.USER_ID_KEY);
+            if (userId) {
+                // Sync back to localStorage if cookie exists but localStorage doesn't
+                try {
+                    if (typeof localStorage !== "undefined") {
+                        localStorage.setItem(this.USER_ID_KEY, userId);
+                    }
+                }
+                catch (error) {
+                    // Ignore sync errors
+                }
+                return userId;
+            }
+        }
+        catch (error) {
+            this.logger.debug("Failed to get user ID from cookie:", error);
+        }
+        return null;
+    }
+    removeUserId() {
+        // Remove from cookie
+        try {
+            this.deleteCookie(this.USER_ID_KEY);
+            this.logger.debug("👤 User ID removed from cookie");
+        }
+        catch (error) {
+            this.logger.error("Failed to remove user ID from cookie:", error);
+        }
+        // Remove from localStorage
+        try {
+            if (typeof localStorage !== "undefined") {
+                localStorage.removeItem(this.USER_ID_KEY);
+                this.logger.debug("👤 User ID removed from localStorage");
+            }
+        }
+        catch (error) {
+            this.logger.error("Failed to remove user ID from localStorage:", error);
+        }
+    }
+    // Cookie helper methods
+    setCookie(name, value, days) {
+        try {
+            const expires = new Date();
+            expires.setTime(expires.getTime() + days * 24 * 60 * 60 * 1000);
+            const cookieValue = `${name}=${encodeURIComponent(value)};expires=${expires.toUTCString()};path=/;SameSite=Lax`;
+            document.cookie = cookieValue;
+        }
+        catch (error) {
+            this.logger.error("Failed to set cookie:", error);
+        }
+    }
+    getCookie(name) {
+        try {
+            const nameEQ = name + "=";
+            const ca = document.cookie.split(";");
+            for (let i = 0; i < ca.length; i++) {
+                let c = ca[i];
+                while (c.charAt(0) === " ")
+                    c = c.substring(1, c.length);
+                if (c.indexOf(nameEQ) === 0) {
+                    return decodeURIComponent(c.substring(nameEQ.length, c.length));
+                }
+            }
+            return null;
+        }
+        catch (error) {
+            this.logger.error("Failed to get cookie:", error);
+            return null;
+        }
+    }
+    deleteCookie(name) {
+        try {
+            document.cookie = `${name}=;expires=Thu, 01 Jan 1970 00:00:00 UTC;path=/;`;
+        }
+        catch (error) {
+            this.logger.error("Failed to delete cookie:", error);
+        }
+    }
     async init() {
         await this.indexedDB.init();
     }

package/dist/types/index.d.ts

@@ -8,7 +8,8 @@ export declare enum EventType {
     SIGNUP = "signup",
     PRODUCT_VIEW = "product_view",
     ADD_TO_CART = "add_to_cart",
-    PURCHASE = "purchase"
+    PURCHASE = "purchase",
+    AUDIT_APPROVED = "audit_approved"
 }
 export declare enum Currency {
     USD = "USD"
@@ -74,6 +75,7 @@ export interface SDKConfig {
     excludeDomains?: string[];
     autoCleanUTM?: boolean;
     pageViewDebounceInterval?: number;
+    userId?: string;
 }
 export interface StorageInterface {
     get(key: string): any;

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

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

package/dist/types/index.js

@@ -16,6 +16,8 @@ export var EventType;
     EventType["PRODUCT_VIEW"] = "product_view";
     EventType["ADD_TO_CART"] = "add_to_cart";
     EventType["PURCHASE"] = "purchase";
+    // Post-conversion / back-office conversion
+    EventType["AUDIT_APPROVED"] = "audit_approved";
 })(EventType || (EventType = {}));
 // Currency types
 export var Currency;
@@ -30,4 +32,5 @@ export const IMMEDIATE_EVENTS = [
     EventType.SIGNUP,
     EventType.FORM_SUBMIT,
     EventType.EMAIL_VERIFICATION,
+    EventType.AUDIT_APPROVED,
 ];