@zaplier/sdk 1.6.1 → 1.6.2
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/dist/index.cjs +293 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +2 -1
- package/dist/index.esm.js +293 -1
- package/dist/index.esm.js.map +1 -1
- package/dist/sdk.js +293 -1
- package/dist/sdk.js.map +1 -1
- package/dist/sdk.min.js +1 -1
- package/dist/src/modules/visitor-persistence.d.ts +20 -88
- package/dist/src/modules/visitor-persistence.d.ts.map +1 -1
- package/dist/src/sdk.d.ts +2 -1
- package/dist/src/sdk.d.ts.map +1 -1
- package/package.json +1 -1
|
@@ -1,104 +1,36 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
3
|
-
* Implements
|
|
2
|
+
* Visitor Persistence Manager for SDK
|
|
3
|
+
* Implements client-side visitor identification with localStorage camouflage
|
|
4
4
|
*/
|
|
5
5
|
interface VisitorIdentity {
|
|
6
6
|
visitorId: string;
|
|
7
7
|
sessionId: string;
|
|
8
|
-
|
|
8
|
+
stableCoreHash: string;
|
|
9
9
|
deviceFingerprint?: string;
|
|
10
10
|
persistenceMethod: "localStorage" | "sessionStorage" | "cookie" | "memory";
|
|
11
11
|
confidence: number;
|
|
12
12
|
createdAt: number;
|
|
13
13
|
lastSeen: number;
|
|
14
|
-
|
|
15
|
-
interface CamouflagedData {
|
|
16
|
-
theme: "auto" | "light" | "dark";
|
|
17
|
-
lang: string;
|
|
18
|
-
tz: string;
|
|
19
|
-
analytics: boolean;
|
|
20
|
-
cookies: boolean;
|
|
21
|
-
_v: string;
|
|
22
|
-
_s: string;
|
|
23
|
-
_sc: string;
|
|
24
|
-
ts: number;
|
|
25
|
-
}
|
|
26
|
-
/**
|
|
27
|
-
* Multi-layer persistence manager with fallbacks
|
|
28
|
-
*/
|
|
29
|
-
export declare class PersistenceManager {
|
|
30
|
-
private static memoryStore;
|
|
31
|
-
static setLocal(key: string, value: string): boolean;
|
|
32
|
-
static getLocal(key: string): string | null;
|
|
33
|
-
static setSession(key: string, value: string): boolean;
|
|
34
|
-
static getSession(key: string): string | null;
|
|
35
|
-
static setCookie(key: string, value: string, days?: number): boolean;
|
|
36
|
-
static getCookie(key: string): string | null;
|
|
37
|
-
static setMemory(key: string, value: string): boolean;
|
|
38
|
-
static getMemory(key: string): string | null;
|
|
39
|
-
static get(key: string): string | null;
|
|
40
|
-
static set(key: string, value: string): void;
|
|
41
|
-
static clear(key: string): void;
|
|
14
|
+
reused: boolean;
|
|
42
15
|
}
|
|
43
16
|
/**
|
|
44
|
-
*
|
|
45
|
-
* Implements camuflaged localStorage with multiple identification layers
|
|
17
|
+
* Advanced Visitor Identity Manager with Camouflaged Storage
|
|
46
18
|
*/
|
|
47
19
|
export declare class VisitorIdentityManager {
|
|
48
|
-
private
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
* Persist visitor identity using camuflaged storage
|
|
63
|
-
*/
|
|
64
|
-
private static persistIdentity;
|
|
65
|
-
/**
|
|
66
|
-
* Generate unique visitor ID
|
|
67
|
-
*/
|
|
68
|
-
private static generateVisitorId;
|
|
69
|
-
/**
|
|
70
|
-
* Generate or continue session ID
|
|
71
|
-
*/
|
|
72
|
-
private static generateSessionId;
|
|
73
|
-
/**
|
|
74
|
-
* Generate stable core ID based on invariant device characteristics
|
|
75
|
-
*/
|
|
76
|
-
private static generateStableCoreId;
|
|
77
|
-
/**
|
|
78
|
-
* Get navigator language safely
|
|
79
|
-
*/
|
|
80
|
-
private static getNavigatorLanguage;
|
|
81
|
-
/**
|
|
82
|
-
* Get timezone safely
|
|
83
|
-
*/
|
|
84
|
-
private static getTimezone;
|
|
85
|
-
/**
|
|
86
|
-
* Update session activity
|
|
87
|
-
*/
|
|
88
|
-
static updateSessionActivity(): void;
|
|
89
|
-
/**
|
|
90
|
-
* Get current visitor identity (without creating new one)
|
|
91
|
-
*/
|
|
92
|
-
static getCurrentIdentity(): VisitorIdentity | null;
|
|
93
|
-
/**
|
|
94
|
-
* Clear all visitor data (for privacy compliance)
|
|
95
|
-
*/
|
|
96
|
-
static clearAllData(): void;
|
|
97
|
-
/**
|
|
98
|
-
* Check if visitor identity is available
|
|
99
|
-
*/
|
|
100
|
-
static hasIdentity(): boolean;
|
|
20
|
+
private generateVisitorId;
|
|
21
|
+
private generateSessionId;
|
|
22
|
+
private createCamouflageData;
|
|
23
|
+
private extractFromCamouflage;
|
|
24
|
+
getOrCreateVisitorIdentity(params: {
|
|
25
|
+
fingerprintHash: string;
|
|
26
|
+
stableCoreHash: string;
|
|
27
|
+
deviceFingerprint: string;
|
|
28
|
+
sessionId?: string;
|
|
29
|
+
userAgent?: string;
|
|
30
|
+
ipAddress?: string;
|
|
31
|
+
}): Promise<VisitorIdentity>;
|
|
32
|
+
getCurrentVisitorId(): string | null;
|
|
33
|
+
clearIdentity(): void;
|
|
101
34
|
}
|
|
102
|
-
export
|
|
103
|
-
export type { CamouflagedData, VisitorIdentity };
|
|
35
|
+
export {};
|
|
104
36
|
//# sourceMappingURL=visitor-persistence.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"visitor-persistence.d.ts","sourceRoot":"","sources":["../../../src/modules/visitor-persistence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,
|
|
1
|
+
{"version":3,"file":"visitor-persistence.d.ts","sourceRoot":"","sources":["../../../src/modules/visitor-persistence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,cAAc,GAAG,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAgKD;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,qBAAqB;IAqBvB,0BAA0B,CAAC,MAAM,EAAE;QACvC,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,eAAe,CAAC;IAwD5B,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAUpC,aAAa,IAAI,IAAI;CAetB"}
|
package/dist/src/sdk.d.ts
CHANGED
|
@@ -21,6 +21,7 @@ export declare class ZaplierSDK implements IZaplierSDK {
|
|
|
21
21
|
private heatmapEngine?;
|
|
22
22
|
private antiAdblockManager?;
|
|
23
23
|
private autoTracker?;
|
|
24
|
+
private visitorIdentityManager?;
|
|
24
25
|
constructor(userConfig: SDKConfig);
|
|
25
26
|
/**
|
|
26
27
|
* Initialize SDK
|
|
@@ -49,7 +50,7 @@ export declare class ZaplierSDK implements IZaplierSDK {
|
|
|
49
50
|
private initializeAntiAdblock;
|
|
50
51
|
/**
|
|
51
52
|
* Collect fingerprint and generate visitor ID (IMPROVED - 2024)
|
|
52
|
-
* Enhanced with better incognito detection
|
|
53
|
+
* Enhanced with better incognito detection and localStorage persistence
|
|
53
54
|
*/
|
|
54
55
|
private collectFingerprint;
|
|
55
56
|
/**
|
package/dist/src/sdk.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/sdk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,UAAU,IAAI,WAAW,EACzB,aAAa,EACb,SAAS,EACT,QAAQ,EACR,cAAc,EACd,WAAW,EACZ,MAAM,SAAS,CAAC;
|
|
1
|
+
{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/sdk.ts"],"names":[],"mappings":"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"}
|