getu-attribution-v2-sdk 0.2.1 → 0.2.3

package/dist/index.esm.js

@@ -16,6 +16,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;
@@ -30,6 +32,7 @@ const IMMEDIATE_EVENTS = [
     EventType.SIGNUP,
     EventType.FORM_SUBMIT,
     EventType.EMAIL_VERIFICATION,
+    EventType.AUDIT_APPROVED,
 ];
 
 // Generate unique ID
@@ -550,10 +553,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();
     }
@@ -872,8 +996,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
@@ -946,10 +1079,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 },
@@ -1046,6 +1181,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);
@@ -1131,6 +1306,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();
@@ -1580,6 +1791,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);
@@ -1723,6 +1935,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();
@@ -1792,6 +2049,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) {
@@ -1838,6 +2122,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);
@@ -1870,6 +2170,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();
@@ -1904,13 +2216,21 @@ if (typeof window !== "undefined") {
         trackFormSubmit,
         trackVideoPlay,
         trackEmailVerification,
+        trackAuditApproved,
         trackProductView,
         trackAddToCart,
+        trackPurchaseAuto,
+        trackLoginAuto,
+        trackSignupAuto,
+        trackEmailVerificationAuto,
         getAttributionData,
         flush,
         getStatus,
         addUTMToURL,
         getCurrentUTMParams,
+        setUserId,
+        getUserId,
+        removeUserId,
         destroy,
         EventType,
         Currency,
@@ -1930,11 +2250,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 = addUTMToURL;
     window.getCurrentUTMParams = getCurrentUTMParams;
+    window.setUserId = setUserId;
+    window.getUserId = getUserId;
+    window.removeUserId = removeUserId;
     window.destroy = destroy;
     window.AttributionSDK = AttributionSDKStatic; // 直接暴露带静态方法的AttributionSDK类
 }
@@ -1954,16 +2281,23 @@ var index = {
     trackEmailVerification,
     trackProductView,
     trackAddToCart,
+    trackPurchaseAuto,
+    trackLoginAuto,
+    trackSignupAuto,
+    trackEmailVerificationAuto,
     getAttributionData,
     flush,
     getStatus,
     addUTMToURL,
     getCurrentUTMParams,
+    setUserId,
+    getUserId,
+    removeUserId,
     destroy,
     EventType,
     Currency,
     AttributionSDK: AttributionSDKStatic, // 包含带静态方法的AttributionSDK类
 };
 
-export { AttributionSDKStatic as AttributionSDK, Currency, EventType, addUTMToURL, index as default, destroy, flush, getAttributionData, getCurrentUTMParams, getSDK, getStatus, init, trackAddToCart, trackEmailVerification, trackEvent, trackFormSubmit, trackLogin, trackPageClick, trackPageView, trackProductView, trackPurchase, trackSignup, trackVideoPlay, waitForSDK };
+export { AttributionSDKStatic as AttributionSDK, Currency, EventType, addUTMToURL, index as default, 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 };
 //# sourceMappingURL=index.esm.js.map