47 lines
1.3 KiB
TypeScript
47 lines
1.3 KiB
TypeScript
/**
|
|
* Browser identifier utility for anonymous usage tracking
|
|
* Generates and persists a unique UUID in localStorage for WAU tracking
|
|
*/
|
|
|
|
const BROWSER_ID_KEY = 'stirling_browser_id';
|
|
|
|
/**
|
|
* Gets or creates a unique browser identifier
|
|
* Used for Weekly Active Users (WAU) tracking in no-login mode
|
|
*/
|
|
export function getBrowserId(): string {
|
|
try {
|
|
// Try to get existing ID from localStorage
|
|
let browserId = localStorage.getItem(BROWSER_ID_KEY);
|
|
|
|
if (!browserId) {
|
|
// Generate new UUID v4
|
|
browserId = generateUUID();
|
|
localStorage.setItem(BROWSER_ID_KEY, browserId);
|
|
}
|
|
|
|
return browserId;
|
|
} catch (error) {
|
|
// Fallback to session-based ID if localStorage is unavailable
|
|
console.warn('localStorage unavailable, using session-based ID', error);
|
|
return `session_${generateUUID()}`;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Generates a UUID v4
|
|
*/
|
|
function generateUUID(): string {
|
|
// Use crypto.randomUUID if available (modern browsers)
|
|
if (typeof crypto !== 'undefined' && crypto.randomUUID) {
|
|
return crypto.randomUUID();
|
|
}
|
|
|
|
// Fallback to manual UUID generation
|
|
return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
|
|
const r = (Math.random() * 16) | 0;
|
|
const v = c === 'x' ? r : (r & 0x3) | 0x8;
|
|
return v.toString(16);
|
|
});
|
|
}
|