getu-attribution-v2-sdk 0.2.1 → 0.2.3

package/README.md

@@ -8,6 +8,7 @@ A JavaScript SDK for tracking user attribution and conversion events in web appl
 - [Installation](#installation)
 - [Quick Start](#quick-start)
 - [Configuration](#configuration)
+- [User ID Management](#user-id-management)
 - [Event Tracking](#event-tracking)
 - [Auto-Tracking](#auto-tracking)
 - [SPA Support](#spa-support)
@@ -23,18 +24,18 @@ A JavaScript SDK for tracking user attribution and conversion events in web appl
 
 ## Features
 
-| Feature                   | Description                                                      |
-| ------------------------- | ---------------------------------------------------------------- |
-| 🎯 **UTM Tracking**       | Automatic capture and storage of UTM parameters from URLs        |
-| 🔗 **Cross-Domain UTM**   | Automatic UTM parameter passing to external links                |
-| 📦 **Event Batching**     | Efficient batch processing of events with configurable intervals |
-| 📴 **Offline Support**    | Queue events locally when offline, sync when connection restores |
-| 🔄 **SPA Support**        | Automatic page view tracking for Single Page Applications        |
-| ⚡ **Immediate Events**   | Critical events (purchase, login, signup) sent immediately       |
-| 🕐 **Session Management** | Tracks user sessions with configurable timeout                   |
-| 🧹 **Auto Clean UTM**     | Removes UTM parameters from URL after capture                    |
-| 📄 **Page View Debounce** | Prevents duplicate page view events within configurable interval |
-| 📝 **TypeScript**         | Full TypeScript support with type definitions                    |
+| Feature                   | Description                                                                |
+| ------------------------- | -------------------------------------------------------------------------- |
+| 🎯 **UTM Tracking**       | Automatic capture and storage of UTM parameters from URLs                  |
+| 🔗 **Cross-Domain UTM**   | Automatic UTM parameter passing to external links                          |
+| 📦 **Event Batching**     | Efficient batch processing of events with configurable intervals           |
+| 📴 **Offline Support**    | Queue events locally when offline, sync when connection restores           |
+| 🔄 **SPA Support**        | Automatic page view tracking for Single Page Applications                  |
+| ⚡ **Immediate Events**   | Critical events (purchase, login, signup, audit approved) sent immediately |
+| 🕐 **Session Management** | Tracks user sessions with configurable timeout                             |
+| 🧹 **Auto Clean UTM**     | Removes UTM parameters from URL after capture                              |
+| 📄 **Page View Debounce** | Prevents duplicate page view events within configurable interval           |
+| 📝 **TypeScript**         | Full TypeScript support with type definitions                              |
 
 ---
 
@@ -104,6 +105,7 @@ await trackPageView({ category: "homepage" });
 | `data-batch-size`           | number  | `100`                                         | Number of events per batch                    |
 | `data-batch-interval`       | number  | `2000`                                        | Batch interval in milliseconds                |
 | `data-auto-clean-utm`       | boolean | `true`                                        | Remove UTM params from URL after capture      |
+| `data-user-id`              | string  | -                                             | Initial user ID                               |
 
 ### Configuration Object
 
@@ -139,6 +141,9 @@ interface SDKConfig {
   // Page View
   pageViewDebounceInterval?: number; // Default: 5000 (ms) - Debounce interval for same page
 
+  // User ID
+  userId?: string; // Initial user ID to set on initialization
+
   // Debug
   enableDebug?: boolean; // Default: false
 }
@@ -162,12 +167,83 @@ await init({
   excludeDomains: ["google.com", "facebook.com"],
   autoCleanUTM: true,
   pageViewDebounceInterval: 3000,
+  userId: "user_123", // Optional: Set initial user ID
   enableDebug: true,
 });
 ```
 
 ---
 
+## User ID Management
+
+The SDK automatically manages user IDs and includes them in all tracked events.
+
+### Setting User ID
+
+#### During Initialization
+
+You can set the user ID when initializing the SDK:
+
+```javascript
+// Via script tag
+<script
+  src="https://unpkg.com/getu-attribution-v2-sdk/dist/getuai-attribution.min.js"
+  data-api-key="your_api_key_here"
+  data-user-id="user_123"
+></script>;
+
+// Via configuration object
+await init({
+  apiKey: "your_api_key_here",
+  userId: "user_123",
+});
+```
+
+#### Programmatically Set User ID
+
+You can set or update the user ID at any time:
+
+```javascript
+import { setUserId } from "getu-attribution-v2-sdk";
+
+// Set user ID (e.g., after user login)
+setUserId("user_123");
+```
+
+### Getting User ID
+
+```javascript
+import { getUserId } from "getu-attribution-v2-sdk";
+
+const userId = getUserId();
+console.log("Current user ID:", userId); // "user_123" or null
+```
+
+### Removing User ID
+
+```javascript
+import { removeUserId } from "getu-attribution-v2-sdk";
+
+// Remove user ID (e.g., after user logout)
+removeUserId();
+```
+
+### Automatic Inclusion in Events
+
+Once a user ID is set, it will **automatically be included** in all tracked events, even if you don't explicitly pass it:
+
+```javascript
+// User ID is already set via setUserId("user_123")
+
+// This will automatically include user_123 in the event
+await trackPageView({ category: "homepage" });
+
+// Explicit user ID parameter will override the stored one
+await trackPageView({ category: "homepage" }, "different_user_456");
+```
+
+---
+
 ## Event Tracking
 
 ### Event Types
@@ -193,6 +269,9 @@ enum EventType {
   PRODUCT_VIEW = "product_view",
   ADD_TO_CART = "add_to_cart",
   PURCHASE = "purchase",
+
+  // Post-conversion / back-office conversion
+  AUDIT_APPROVED = "audit_approved",
 }
 ```
 
@@ -205,6 +284,7 @@ These events are sent immediately (not batched):
 - `SIGNUP`
 - `FORM_SUBMIT`
 - `EMAIL_VERIFICATION`
+- `AUDIT_APPROVED`
 
 ### Track Page View
 
@@ -239,9 +319,11 @@ await trackPageClick("user_123", {
 
 ### Track Purchase
 
+**Method 1: Traditional format (user_id required)**
+
 ```javascript
 await trackPurchase(
-  "user_123", // tracking_user_id
+  "user_123", // tracking_user_id (required)
   99.99, // revenue
   Currency.USD, // currency (optional, default: USD)
   {
@@ -253,8 +335,33 @@ await trackPurchase(
 );
 ```
 
+**Method 2: Auto user ID format (object parameter, user_id optional)**
+
+```javascript
+// Auto-use stored user ID
+await trackPurchaseAuto({
+  revenue: 99.99,
+  currency: Currency.USD, // optional
+  purchaseData: {
+    product_id: "prod_123",
+    product_name: "Premium Plan",
+    quantity: 1,
+  },
+  // tracking_user_id is optional - will use stored user ID if not provided
+});
+
+// Or explicitly provide user ID
+await trackPurchaseAuto({
+  revenue: 99.99,
+  tracking_user_id: "user_123", // optional, will use stored if not provided
+  purchaseData: { product_id: "prod_123" },
+});
+```
+
 ### Track Login
 
+**Method 1: Traditional format (user_id required)**
+
 ```javascript
 await trackLogin("user_123", {
   method: "email",
@@ -262,8 +369,29 @@ await trackLogin("user_123", {
 });
 ```
 
+**Method 2: Auto user ID format (object parameter, user_id optional)**
+
+```javascript
+// Auto-use stored user ID
+await trackLoginAuto({
+  loginData: {
+    method: "email",
+    provider: "google",
+  },
+  // tracking_user_id is optional - will use stored user ID if not provided
+});
+
+// Or explicitly provide user ID
+await trackLoginAuto({
+  tracking_user_id: "user_123", // optional
+  loginData: { method: "email" },
+});
+```
+
 ### Track Signup
 
+**Method 1: Traditional format (user_id required)**
+
 ```javascript
 await trackSignup("user_123", {
   method: "email",
@@ -271,6 +399,25 @@ await trackSignup("user_123", {
 });
 ```
 
+**Method 2: Auto user ID format (object parameter, user_id optional)**
+
+```javascript
+// Auto-use stored user ID
+await trackSignupAuto({
+  signupData: {
+    method: "email",
+    referral_code: "REF123",
+  },
+  // tracking_user_id is optional - will use stored user ID if not provided
+});
+
+// Or explicitly provide user ID
+await trackSignupAuto({
+  tracking_user_id: "user_123", // optional
+  signupData: { method: "email" },
+});
+```
+
 ### Track Form Submit
 
 ```javascript
@@ -300,6 +447,8 @@ await trackVideoPlay("user_123", {
 
 ### Track Email Verification
 
+**Method 1: Traditional format (user_id required)**
+
 ```javascript
 await trackEmailVerification("user_123", {
   email: "user@example.com",
@@ -307,6 +456,53 @@ await trackEmailVerification("user_123", {
 });
 ```
 
+**Method 2: Auto user ID format (object parameter, user_id optional)**
+
+```javascript
+// Auto-use stored user ID
+await trackEmailVerificationAuto({
+  verificationData: {
+    email: "user@example.com",
+    verification_method: "email_link",
+  },
+  // tracking_user_id is optional - will use stored user ID if not provided
+});
+
+// Or explicitly provide user ID
+await trackEmailVerificationAuto({
+  tracking_user_id: "user_123", // optional
+  verificationData: { email: "user@example.com" },
+});
+```
+
+### Track Audit Approved
+
+Track an audit approval conversion event. **Sent immediately.**
+
+```javascript
+import { trackAuditApproved } from "getu-attribution-v2-sdk";
+
+await trackAuditApproved("user_123", {
+  audit_id: "audit_987",
+  reviewer: "ops_team",
+});
+```
+
+### Auto User ID Functions Summary
+
+The following functions support auto user ID with object parameter format:
+
+- `trackPurchaseAuto(options)` - Purchase tracking with optional user ID
+- `trackLoginAuto(options)` - Login tracking with optional user ID
+- `trackSignupAuto(options)` - Signup tracking with optional user ID
+- `trackEmailVerificationAuto(options)` - Email verification tracking with optional user ID
+
+**Important Notes:**
+
+- If `tracking_user_id` is not provided in options and no user ID is stored, these functions will log an error and return without tracking the event
+- Always set user ID using `setUserId()` before calling these functions, or provide `tracking_user_id` in the options
+- The traditional functions (`trackPurchase`, `trackLogin`, etc.) still require `tracking_user_id` as the first parameter
+
 ### Track Product View
 
 ```javascript

package/dist/core/AttributionSDK.d.ts

@@ -26,6 +26,25 @@ export declare class AttributionSDK {
     trackFormSubmit(tracking_user_id?: string, formData?: Record<string, any>): Promise<void>;
     trackVideoPlay(tracking_user_id?: string, videoData?: Record<string, any>): Promise<void>;
     trackEmailVerification(tracking_user_id: string, verificationData?: Record<string, any>): Promise<void>;
+    trackAuditApproved(tracking_user_id: string, auditData?: Record<string, any>): Promise<void>;
+    trackPurchaseAuto(options: {
+        revenue: number;
+        currency?: Currency;
+        purchaseData?: Record<string, any>;
+        tracking_user_id?: string;
+    }): Promise<void>;
+    trackLoginAuto(options: {
+        loginData?: Record<string, any>;
+        tracking_user_id?: string;
+    }): Promise<void>;
+    trackSignupAuto(options: {
+        signupData?: Record<string, any>;
+        tracking_user_id?: string;
+    }): Promise<void>;
+    trackEmailVerificationAuto(options: {
+        verificationData?: Record<string, any>;
+        tracking_user_id?: string;
+    }): Promise<void>;
     trackProductView(tracking_user_id?: string, productData?: Record<string, any>): Promise<void>;
     trackAddToCart(tracking_user_id?: string, cartData?: Record<string, any>): Promise<void>;
     trackPageClick(tracking_user_id?: string, clickData?: Record<string, any>): Promise<void>;
@@ -33,6 +52,10 @@ export declare class AttributionSDK {
     addUTMToURL(url: string): string;
     getCurrentUTMParams(): Record<string, string>;
     private getUTMParams;
+    private initializeUserId;
+    setUserId(userId: string): void;
+    getUserId(): string | null;
+    removeUserId(): void;
     private initializeSession;
     private extractAndStoreUTMData;
     private setupAutoTracking;

package/dist/core/AttributionSDK.d.ts.map

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

package/dist/core/AttributionSDK.js

@@ -49,8 +49,17 @@ export 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
@@ -123,10 +132,12 @@ export 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 },
@@ -223,6 +234,46 @@ export 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);
@@ -308,6 +359,42 @@ export 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();