@zaplier/sdk 1.6.1 → 1.6.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/dist/index.cjs +324 -3
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +3 -1
- package/dist/index.esm.js +324 -3
- package/dist/index.esm.js.map +1 -1
- package/dist/sdk.js +324 -3
- package/dist/sdk.js.map +1 -1
- package/dist/sdk.min.js +1 -1
- package/dist/src/modules/fingerprint/hashing.d.ts +1 -0
- package/dist/src/modules/fingerprint/hashing.d.ts.map +1 -1
- package/dist/src/modules/visitor-persistence.d.ts +21 -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
|
@@ -19,6 +19,7 @@ export declare function hash32(input: string): string;
|
|
|
19
19
|
export declare function hashFingerprint(components: Record<string, any>, debug?: boolean): string;
|
|
20
20
|
/**
|
|
21
21
|
* Generate a visitor ID from fingerprint hash
|
|
22
|
+
* Returns a proper UUID v4 format for database compatibility
|
|
22
23
|
*/
|
|
23
24
|
export declare function generateVisitorId(fingerprintHash: string): string;
|
|
24
25
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"hashing.d.ts","sourceRoot":"","sources":["../../../../src/modules/fingerprint/hashing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2FH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,MAAM,CAyFlE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW5C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,KAAK,GAAE,OAAe,GACrB,MAAM,CA2BR;AAED
|
|
1
|
+
{"version":3,"file":"hashing.d.ts","sourceRoot":"","sources":["../../../../src/modules/fingerprint/hashing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2FH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,MAAM,CAyFlE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW5C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,KAAK,GAAE,OAAe,GACrB,MAAM,CA2BR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAcjE;AAmFD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/B,KAAK,GAAE,OAAe,GACrB,MAAM,CAuBR"}
|
|
@@ -1,104 +1,37 @@
|
|
|
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
|
-
|
|
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 generateVisitorIdFromHash;
|
|
22
|
+
private generateSessionId;
|
|
23
|
+
private createCamouflageData;
|
|
24
|
+
private extractFromCamouflage;
|
|
25
|
+
getOrCreateVisitorIdentity(params: {
|
|
26
|
+
fingerprintHash: string;
|
|
27
|
+
stableCoreHash: string;
|
|
28
|
+
deviceFingerprint: string;
|
|
29
|
+
sessionId?: string;
|
|
30
|
+
userAgent?: string;
|
|
31
|
+
ipAddress?: string;
|
|
32
|
+
}): Promise<VisitorIdentity>;
|
|
33
|
+
getCurrentVisitorId(): string | null;
|
|
34
|
+
clearIdentity(): void;
|
|
101
35
|
}
|
|
102
|
-
export
|
|
103
|
-
export type { CamouflagedData, VisitorIdentity };
|
|
36
|
+
export {};
|
|
104
37
|
//# 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;IAYzB,OAAO,CAAC,yBAAyB;IAiBjC,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;IA0D5B,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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"}
|