@li2/analytics 0.3.1-beta.0 → 0.3.3
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/README.md +179 -39
- package/dist/auto-events.global.js +1 -1
- package/dist/auto-events.js +1 -1
- package/dist/auto-events.mjs +1 -1
- package/dist/chunk-FF6VDEL5.mjs +1 -0
- package/dist/chunk-LZDMBCUK.mjs +1 -1
- package/dist/chunk-MURA7RU5.mjs +1 -1
- package/dist/click-tracker/index.global.js +1 -1
- package/dist/click-tracker/index.js +1 -1
- package/dist/click-tracker/index.mjs +1 -1
- package/dist/element-resolver-BnZ_ItHT.d.mts +22 -0
- package/dist/element-resolver-BnZ_ItHT.d.ts +22 -0
- package/dist/index.d.mts +2 -22
- package/dist/index.d.ts +2 -22
- package/dist/index.global.js +1 -1
- package/dist/index.js +1 -1
- package/dist/index.mjs +1 -1
- package/dist/outbound.global.js +1 -1
- package/dist/outbound.js +1 -1
- package/dist/outbound.mjs +1 -1
- package/dist/pageview/index.global.js +1 -1
- package/dist/pageview/index.js +1 -1
- package/dist/pageview/index.mjs +1 -1
- package/dist/toolbar/index.d.mts +25 -3
- package/dist/toolbar/index.d.ts +25 -3
- package/dist/toolbar/index.global.js +95 -2
- package/dist/toolbar/index.js +95 -2
- package/dist/toolbar/index.mjs +95 -2
- package/package.json +12 -13
- package/dist/chunk-6RUMMSEZ.mjs +0 -1
- package/dist/click-triggers.d.mts +0 -2
- package/dist/click-triggers.d.ts +0 -2
- package/dist/click-triggers.global.js +0 -1
- package/dist/click-triggers.js +0 -1
- package/dist/click-triggers.mjs +0 -1
- package/dist/index-DEfkJIjF.d.mts +0 -114
- package/dist/index-DEfkJIjF.d.ts +0 -114
|
@@ -1,114 +0,0 @@
|
|
|
1
|
-
/** Configuration for PageviewTracker */
|
|
2
|
-
interface PageviewConfig {
|
|
3
|
-
/** API endpoint base URL */
|
|
4
|
-
apiUrl: string;
|
|
5
|
-
/** Publishable key for authentication */
|
|
6
|
-
publishableKey: string;
|
|
7
|
-
/** Enable/disable pageview tracking */
|
|
8
|
-
enabled: boolean;
|
|
9
|
-
/** SPA detection mode: 'auto' | 'manual' | 'disabled' */
|
|
10
|
-
spaMode: 'auto' | 'manual' | 'disabled';
|
|
11
|
-
/** Batch send interval in milliseconds (default: 5000) */
|
|
12
|
-
batchInterval: number;
|
|
13
|
-
/** Max pageviews per batch (default: 50) */
|
|
14
|
-
batchSize: number;
|
|
15
|
-
/** URL patterns to exclude from tracking (glob-like) */
|
|
16
|
-
excludePatterns: string[];
|
|
17
|
-
/** Track hash changes as separate pageviews (default: false) */
|
|
18
|
-
trackHashChanges: boolean;
|
|
19
|
-
/** Session timeout in minutes (default: 30) */
|
|
20
|
-
sessionTimeout: number;
|
|
21
|
-
/** Cookie-less mode: use only sessionStorage (default: false) */
|
|
22
|
-
cookieLessMode: boolean;
|
|
23
|
-
/** Enable debug logging (default: false) */
|
|
24
|
-
debug: boolean;
|
|
25
|
-
/** Respect Do Not Track header (default: true) */
|
|
26
|
-
respectDnt: boolean;
|
|
27
|
-
/** Cookie domain (default: auto-detect) */
|
|
28
|
-
cookieDomain?: string;
|
|
29
|
-
/** Cookie path (default: '/') */
|
|
30
|
-
cookiePath: string;
|
|
31
|
-
/** Search query URL parameters to detect (default: ['q', 'query', 'search', 's']) */
|
|
32
|
-
searchParams: string[];
|
|
33
|
-
}
|
|
34
|
-
/** A single pageview event to be sent to the server */
|
|
35
|
-
interface PageviewEvent {
|
|
36
|
-
/** Client-generated session ID */
|
|
37
|
-
session_id: string;
|
|
38
|
-
/** Persistent visitor ID */
|
|
39
|
-
visitor_id: string;
|
|
40
|
-
/** Li2 click ID if visitor came from short link */
|
|
41
|
-
li2_cid: string | null;
|
|
42
|
-
/** Full page URL */
|
|
43
|
-
page_url: string;
|
|
44
|
-
/** URL path only */
|
|
45
|
-
page_path: string;
|
|
46
|
-
/** Document title */
|
|
47
|
-
page_title: string;
|
|
48
|
-
/** Previous page URL (internal referrer) */
|
|
49
|
-
page_referrer: string;
|
|
50
|
-
/** URL hash/fragment */
|
|
51
|
-
page_hash: string;
|
|
52
|
-
/** Search query (if detected from URL params) */
|
|
53
|
-
search_query: string | null;
|
|
54
|
-
/** Unix timestamp in milliseconds */
|
|
55
|
-
timestamp: number;
|
|
56
|
-
/** Time spent on previous page in milliseconds */
|
|
57
|
-
time_on_page: number | null;
|
|
58
|
-
/** Screen dimensions */
|
|
59
|
-
screen_width: number;
|
|
60
|
-
screen_height: number;
|
|
61
|
-
viewport_width: number;
|
|
62
|
-
viewport_height: number;
|
|
63
|
-
}
|
|
64
|
-
/** Batch payload sent to the server */
|
|
65
|
-
interface PageviewBatchPayload {
|
|
66
|
-
pageviews: PageviewEvent[];
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
declare class PageviewTracker {
|
|
70
|
-
private config;
|
|
71
|
-
private pageDetector;
|
|
72
|
-
private sessionManager;
|
|
73
|
-
private batchSender;
|
|
74
|
-
private enabled;
|
|
75
|
-
private lastPageUrl;
|
|
76
|
-
private lastPageTimestamp;
|
|
77
|
-
constructor(config: Partial<PageviewConfig> & Pick<PageviewConfig, 'apiUrl' | 'publishableKey'>);
|
|
78
|
-
/** Start tracking pageviews */
|
|
79
|
-
start(): void;
|
|
80
|
-
/** Stop tracking pageviews */
|
|
81
|
-
stop(): void;
|
|
82
|
-
/** Enable pageview tracking */
|
|
83
|
-
enable(): void;
|
|
84
|
-
/** Disable pageview tracking */
|
|
85
|
-
disable(): void;
|
|
86
|
-
/** Force start a new session */
|
|
87
|
-
newSession(): void;
|
|
88
|
-
/** Manually track a pageview (for advanced use cases) */
|
|
89
|
-
trackPageview(options?: {
|
|
90
|
-
pageUrl?: string;
|
|
91
|
-
pageTitle?: string;
|
|
92
|
-
customData?: Record<string, unknown>;
|
|
93
|
-
}): void;
|
|
94
|
-
/** Handle page change event from PageDetector */
|
|
95
|
-
private handlePageChange;
|
|
96
|
-
/** Build a PageviewEvent from current state */
|
|
97
|
-
private buildPageviewEvent;
|
|
98
|
-
/** Track the current page (called on init) */
|
|
99
|
-
private trackCurrentPage;
|
|
100
|
-
/** Check if a path matches any exclude pattern */
|
|
101
|
-
private isExcluded;
|
|
102
|
-
/** Extract search query from URL params */
|
|
103
|
-
private extractSearchQuery;
|
|
104
|
-
/**
|
|
105
|
-
* Get Li2 click ID from existing SDK cookie management.
|
|
106
|
-
* Priority: URL param `uid` → cookie `li_cid` → legacy cookie `li2_id`
|
|
107
|
-
* This matches the exact resolution order in li2-analytics/src/index.ts
|
|
108
|
-
*/
|
|
109
|
-
private getLi2Cid;
|
|
110
|
-
/** Debug logger */
|
|
111
|
-
private log;
|
|
112
|
-
}
|
|
113
|
-
|
|
114
|
-
export { PageviewTracker as P, type PageviewConfig as a, type PageviewEvent as b, type PageviewBatchPayload as c };
|
package/dist/index-DEfkJIjF.d.ts
DELETED
|
@@ -1,114 +0,0 @@
|
|
|
1
|
-
/** Configuration for PageviewTracker */
|
|
2
|
-
interface PageviewConfig {
|
|
3
|
-
/** API endpoint base URL */
|
|
4
|
-
apiUrl: string;
|
|
5
|
-
/** Publishable key for authentication */
|
|
6
|
-
publishableKey: string;
|
|
7
|
-
/** Enable/disable pageview tracking */
|
|
8
|
-
enabled: boolean;
|
|
9
|
-
/** SPA detection mode: 'auto' | 'manual' | 'disabled' */
|
|
10
|
-
spaMode: 'auto' | 'manual' | 'disabled';
|
|
11
|
-
/** Batch send interval in milliseconds (default: 5000) */
|
|
12
|
-
batchInterval: number;
|
|
13
|
-
/** Max pageviews per batch (default: 50) */
|
|
14
|
-
batchSize: number;
|
|
15
|
-
/** URL patterns to exclude from tracking (glob-like) */
|
|
16
|
-
excludePatterns: string[];
|
|
17
|
-
/** Track hash changes as separate pageviews (default: false) */
|
|
18
|
-
trackHashChanges: boolean;
|
|
19
|
-
/** Session timeout in minutes (default: 30) */
|
|
20
|
-
sessionTimeout: number;
|
|
21
|
-
/** Cookie-less mode: use only sessionStorage (default: false) */
|
|
22
|
-
cookieLessMode: boolean;
|
|
23
|
-
/** Enable debug logging (default: false) */
|
|
24
|
-
debug: boolean;
|
|
25
|
-
/** Respect Do Not Track header (default: true) */
|
|
26
|
-
respectDnt: boolean;
|
|
27
|
-
/** Cookie domain (default: auto-detect) */
|
|
28
|
-
cookieDomain?: string;
|
|
29
|
-
/** Cookie path (default: '/') */
|
|
30
|
-
cookiePath: string;
|
|
31
|
-
/** Search query URL parameters to detect (default: ['q', 'query', 'search', 's']) */
|
|
32
|
-
searchParams: string[];
|
|
33
|
-
}
|
|
34
|
-
/** A single pageview event to be sent to the server */
|
|
35
|
-
interface PageviewEvent {
|
|
36
|
-
/** Client-generated session ID */
|
|
37
|
-
session_id: string;
|
|
38
|
-
/** Persistent visitor ID */
|
|
39
|
-
visitor_id: string;
|
|
40
|
-
/** Li2 click ID if visitor came from short link */
|
|
41
|
-
li2_cid: string | null;
|
|
42
|
-
/** Full page URL */
|
|
43
|
-
page_url: string;
|
|
44
|
-
/** URL path only */
|
|
45
|
-
page_path: string;
|
|
46
|
-
/** Document title */
|
|
47
|
-
page_title: string;
|
|
48
|
-
/** Previous page URL (internal referrer) */
|
|
49
|
-
page_referrer: string;
|
|
50
|
-
/** URL hash/fragment */
|
|
51
|
-
page_hash: string;
|
|
52
|
-
/** Search query (if detected from URL params) */
|
|
53
|
-
search_query: string | null;
|
|
54
|
-
/** Unix timestamp in milliseconds */
|
|
55
|
-
timestamp: number;
|
|
56
|
-
/** Time spent on previous page in milliseconds */
|
|
57
|
-
time_on_page: number | null;
|
|
58
|
-
/** Screen dimensions */
|
|
59
|
-
screen_width: number;
|
|
60
|
-
screen_height: number;
|
|
61
|
-
viewport_width: number;
|
|
62
|
-
viewport_height: number;
|
|
63
|
-
}
|
|
64
|
-
/** Batch payload sent to the server */
|
|
65
|
-
interface PageviewBatchPayload {
|
|
66
|
-
pageviews: PageviewEvent[];
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
declare class PageviewTracker {
|
|
70
|
-
private config;
|
|
71
|
-
private pageDetector;
|
|
72
|
-
private sessionManager;
|
|
73
|
-
private batchSender;
|
|
74
|
-
private enabled;
|
|
75
|
-
private lastPageUrl;
|
|
76
|
-
private lastPageTimestamp;
|
|
77
|
-
constructor(config: Partial<PageviewConfig> & Pick<PageviewConfig, 'apiUrl' | 'publishableKey'>);
|
|
78
|
-
/** Start tracking pageviews */
|
|
79
|
-
start(): void;
|
|
80
|
-
/** Stop tracking pageviews */
|
|
81
|
-
stop(): void;
|
|
82
|
-
/** Enable pageview tracking */
|
|
83
|
-
enable(): void;
|
|
84
|
-
/** Disable pageview tracking */
|
|
85
|
-
disable(): void;
|
|
86
|
-
/** Force start a new session */
|
|
87
|
-
newSession(): void;
|
|
88
|
-
/** Manually track a pageview (for advanced use cases) */
|
|
89
|
-
trackPageview(options?: {
|
|
90
|
-
pageUrl?: string;
|
|
91
|
-
pageTitle?: string;
|
|
92
|
-
customData?: Record<string, unknown>;
|
|
93
|
-
}): void;
|
|
94
|
-
/** Handle page change event from PageDetector */
|
|
95
|
-
private handlePageChange;
|
|
96
|
-
/** Build a PageviewEvent from current state */
|
|
97
|
-
private buildPageviewEvent;
|
|
98
|
-
/** Track the current page (called on init) */
|
|
99
|
-
private trackCurrentPage;
|
|
100
|
-
/** Check if a path matches any exclude pattern */
|
|
101
|
-
private isExcluded;
|
|
102
|
-
/** Extract search query from URL params */
|
|
103
|
-
private extractSearchQuery;
|
|
104
|
-
/**
|
|
105
|
-
* Get Li2 click ID from existing SDK cookie management.
|
|
106
|
-
* Priority: URL param `uid` → cookie `li_cid` → legacy cookie `li2_id`
|
|
107
|
-
* This matches the exact resolution order in li2-analytics/src/index.ts
|
|
108
|
-
*/
|
|
109
|
-
private getLi2Cid;
|
|
110
|
-
/** Debug logger */
|
|
111
|
-
private log;
|
|
112
|
-
}
|
|
113
|
-
|
|
114
|
-
export { PageviewTracker as P, type PageviewConfig as a, type PageviewEvent as b, type PageviewBatchPayload as c };
|