getu-attribution-v2-sdk 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "getu-attribution-v2-sdk",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "GetuAI Attribution V2 SDK for client-side tracking",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.esm.js",
@@ -1,128 +0,0 @@
1
- import { SDKConfig, EventType, AttributionData, Currency, UserSession, UserTraits } from "../types";
2
- export declare class AttributionSDK {
3
- private config;
4
- private logger;
5
- private storage;
6
- private httpClient;
7
- private queue;
8
- private session;
9
- private initialized;
10
- private autoTrackEnabled;
11
- private pageViewTrackTimes;
12
- private cachedPublicIP;
13
- private publicIPFetchPromise;
14
- private initialPageViewTriggered;
15
- private spaTrackingEnabled;
16
- private lastTrackedPath;
17
- private originalPushState;
18
- private originalReplaceState;
19
- private popstateHandler;
20
- constructor(config: SDKConfig);
21
- init(): Promise<void>;
22
- trackEvent(eventType: EventType, eventData?: Record<string, any>, tracking_user_id?: string, revenue?: number, currency?: Currency): Promise<void>;
23
- trackPageView(pageData?: Record<string, any>, tracking_user_id?: string): Promise<void>;
24
- private cleanupPageViewTrackTimes;
25
- private ensurePublicIPFetched;
26
- private fetchPublicIP;
27
- trackPurchase(tracking_user_id: string, revenue: number, currency?: Currency, purchaseData?: Record<string, any>): Promise<void>;
28
- trackLogin(tracking_user_id: string, loginData?: Record<string, any>): Promise<void>;
29
- trackSignup(tracking_user_id: string, signupData?: Record<string, any>): Promise<void>;
30
- trackFormSubmit(tracking_user_id?: string, formData?: Record<string, any>): Promise<void>;
31
- trackVideoPlay(tracking_user_id?: string, videoData?: Record<string, any>): Promise<void>;
32
- trackEmailVerification(tracking_user_id: string, verificationData?: Record<string, any>): Promise<void>;
33
- trackAuditApproved(tracking_user_id: string, auditData?: Record<string, any>): Promise<void>;
34
- trackPurchaseAuto(options: {
35
- revenue: number;
36
- currency?: Currency;
37
- purchaseData?: Record<string, any>;
38
- tracking_user_id?: string;
39
- }): Promise<void>;
40
- trackLoginAuto(options: {
41
- loginData?: Record<string, any>;
42
- tracking_user_id?: string;
43
- }): Promise<void>;
44
- trackSignupAuto(options: {
45
- signupData?: Record<string, any>;
46
- tracking_user_id?: string;
47
- }): Promise<void>;
48
- trackEmailVerificationAuto(options: {
49
- verificationData?: Record<string, any>;
50
- tracking_user_id?: string;
51
- }): Promise<void>;
52
- trackProductView(tracking_user_id?: string, productData?: Record<string, any>): Promise<void>;
53
- trackAddToCart(tracking_user_id?: string, cartData?: Record<string, any>): Promise<void>;
54
- trackPageClick(tracking_user_id?: string, clickData?: Record<string, any>): Promise<void>;
55
- getAttributionData(): AttributionData | null;
56
- addUTMToURL(url: string): string;
57
- getCurrentUTMParams(): Record<string, string>;
58
- private getUTMParams;
59
- private initializeUserId;
60
- setUserId(userId: string): void;
61
- getUserId(): string | null;
62
- removeUserId(): void;
63
- /**
64
- * Identify user and set user attributes
65
- * Used to explicitly set user information, e.g., after login
66
- *
67
- * @param userId User unique identifier
68
- * @param traits User attributes
69
- *
70
- * @example
71
- * sdk.identify('user-123', {
72
- * email: 'user@example.com',
73
- * name: 'John Doe',
74
- * company_name: 'Acme Inc'
75
- * });
76
- */
77
- identify(userId: string, traits?: UserTraits): Promise<void>;
78
- /**
79
- * Get current user traits
80
- */
81
- getUserTraits(): UserTraits | null;
82
- /**
83
- * Get current session ID
84
- */
85
- getSessionId(): string | null;
86
- private initializeSession;
87
- private extractAndStoreUTMData;
88
- private setupAutoTracking;
89
- private setupFormTracking;
90
- private serializeFormFields;
91
- private getFormFieldKey;
92
- private normalizeFormFieldKey;
93
- private serializeFormValue;
94
- /**
95
- * Extract standardized lead fields from form data
96
- * @param formData Serialized form data
97
- * @returns Extracted user traits
98
- */
99
- private extractLeadFields;
100
- private setupLinkTracking;
101
- private handleCrossDomainUTM;
102
- private setupNetworkHandlers;
103
- private setupVisibilityHandlers;
104
- private setupBeforeUnloadHandler;
105
- private flushOnUnload;
106
- private retryPendingEvents;
107
- private getCurrentPath;
108
- private setupSPATracking;
109
- private cleanupSPATracking;
110
- private updateSessionActivity;
111
- flush(): Promise<void>;
112
- getStatus(): {
113
- initialized: boolean;
114
- session: UserSession | null;
115
- queueSize: number;
116
- online: boolean;
117
- crossDomainUTM: {
118
- enabled: boolean;
119
- currentParams: Record<string, string>;
120
- };
121
- spaTracking: {
122
- enabled: boolean;
123
- currentPath: string;
124
- };
125
- };
126
- destroy(): void;
127
- }
128
- //# sourceMappingURL=AttributionSDK.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"AttributionSDK.d.ts","sourceRoot":"","sources":["../../src/core/AttributionSDK.ts"],"names":[],"mappings":"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"}