humanbehavior-js 0.5.17 → 0.5.19

package/packages/core/dist/redact.d.ts

@@ -0,0 +1,88 @@
+export interface RedactionOptions {
+    redactedText?: string;
+    excludeSelectors?: string[];
+    userFields?: string[];
+    redactionStrategy?: {
+        mode: 'privacy-first' | 'visibility-first';
+        unredactFields?: string[];
+        redactFields?: string[];
+    };
+    legacyRedactFields?: string[];
+}
+export declare class RedactionManager {
+    private redactedText;
+    private unredactedFields;
+    private redactedFields;
+    private redactionMode;
+    private excludeSelectors;
+    constructor(options?: RedactionOptions);
+    /**
+     * Set specific fields to be redacted (for visibility-first mode)
+     * @param fields Array of CSS selectors for fields to redact
+     */
+    setFieldsToRedact(fields: string[]): void;
+    /**
+     * Set specific fields to be unredacted (everything else stays redacted by rrweb)
+     * @param fields Array of CSS selectors for fields to unredact
+     */
+    setFieldsToUnredact(fields: string[]): void;
+    /**
+     * Remove specific fields from unredaction (they become redacted again)
+     * @param fields Array of CSS selectors for fields to redact
+     */
+    redactFields(fields: string[]): void;
+    /**
+     * Clear all unredacted fields (everything becomes redacted again)
+     */
+    clearUnredactedFields(): void;
+    /**
+     * Check if any fields are currently unredacted
+     */
+    hasUnredactedFields(): boolean;
+    /**
+     * Get the current redaction mode
+     */
+    getRedactionMode(): 'privacy-first' | 'visibility-first';
+    /**
+     * Get the currently unredacted fields
+     */
+    getUnredactedFields(): string[];
+    /**
+     * Get CSS selectors for rrweb masking configuration
+     * Returns null if no fields are unredacted (everything stays redacted)
+     */
+    getMaskTextSelector(): string | null;
+    /**
+     * Apply redaction classes to DOM elements (for visibility-first mode)
+     * Adds 'rr-mask' class to elements that should be redacted
+     */
+    applyRedactionClasses(): void;
+    /**
+     * Apply unredaction classes to DOM elements
+     * Removes 'rr-mask' class from elements that should be unredacted
+     */
+    applyUnredactionClasses(): void;
+    /**
+     * Remove all unredaction classes from DOM elements
+     */
+    removeUnredactionClasses(): void;
+    /**
+     * Check if a selector represents a password field
+     */
+    private isPasswordSelector;
+    /**
+     * Get the original value of an element (for debugging)
+     */
+    getOriginalValue(element: HTMLElement): string | undefined;
+    /**
+     * Check if an element is currently unredacted
+     */
+    isElementUnredacted(element: HTMLElement): boolean;
+    /**
+     * Check if an element should be unredacted
+     */
+    shouldUnredactElement(element: HTMLElement): boolean;
+}
+export declare const redactionManager: RedactionManager;
+export default RedactionManager;
+//# sourceMappingURL=redact.d.ts.map

package/packages/core/dist/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../src/redact.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,gBAAgB;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,CAAC,EAAE;QAChB,IAAI,EAAE,eAAe,GAAG,kBAAkB,CAAC;QAC3C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;IACF,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,qBAAa,gBAAgB;IACzB,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,aAAa,CAAyD;IAC9E,OAAO,CAAC,gBAAgB,CAGtB;gBAEU,OAAO,CAAC,EAAE,gBAAgB;IAoCtC;;;OAGG;IACI,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAyBhD;;;OAGG;IACI,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAwBlD;;;OAGG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAc3C;;OAEG;IACI,qBAAqB,IAAI,IAAI;IAOpC;;OAEG;IACI,mBAAmB,IAAI,OAAO;IAIrC;;OAEG;IACI,gBAAgB,IAAI,eAAe,GAAG,kBAAkB;IAI/D;;OAEG;IACI,mBAAmB,IAAI,MAAM,EAAE;IAItC;;;OAGG;IACI,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAgB3C;;;OAGG;IACI,qBAAqB,IAAI,IAAI;IA2BpC;;;OAGG;IACI,uBAAuB,IAAI,IAAI;IA2BtC;;OAEG;IACI,wBAAwB,IAAI,IAAI;IAKvC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACI,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS;IAOjE;;OAEG;IACI,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAIzD;;OAEG;IACI,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;CAqC9D;AAGD,eAAO,MAAM,gBAAgB,kBAAyB,CAAC;AAGvD,eAAe,gBAAgB,CAAC"}

package/packages/core/dist/tracker.d.ts

@@ -0,0 +1,338 @@
+import { RedactionOptions } from './redact';
+export declare class HumanBehaviorTracker {
+    private eventQueue;
+    private sessionId;
+    private userProperties;
+    private isProcessing;
+    private flushInterval;
+    private readonly FLUSH_INTERVAL_MS;
+    private readonly MAX_QUEUE_SIZE;
+    private api;
+    private endUserId;
+    private apiKey;
+    private initialized;
+    initializationPromise: Promise<void> | null;
+    private redactionManager;
+    private propertyManager;
+    private isDomReady;
+    private requestQueue;
+    private domReadyHandlers;
+    private originalConsole;
+    private consoleTrackingEnabled;
+    navigationTrackingEnabled: boolean;
+    private currentUrl;
+    private previousUrl;
+    private originalPushState;
+    private originalReplaceState;
+    private navigationListeners;
+    private _connectionBlocked;
+    private recordInstance;
+    private sessionStartTime;
+    private rrwebRecord;
+    private fullSnapshotTimeout;
+    private recordCanvas;
+    private isStarted;
+    /**
+     * Check if the tracker has been started
+     */
+    get isTrackerStarted(): boolean;
+    /**
+     * DOM ready detection - more aggressive
+     */
+    private setupDomReadyHandler;
+    /**
+     * Called when DOM is ready - processes queued requests
+     */
+    private onDomReady;
+    /**
+     * Queue a request until DOM is ready
+     */
+    private queueRequest;
+    /**
+     * Process a request (called after DOM is ready)
+     */
+    private processRequest;
+    /**
+     * Register a handler to be called when DOM is ready
+     */
+    private registerDomReadyHandler;
+    /**
+     * Initialize the HumanBehavior tracker
+     * This is the main entry point - call this once per page
+     */
+    static init(apiKey: string, options?: {
+        ingestionUrl?: string;
+        logLevel?: 'none' | 'error' | 'warn' | 'info' | 'debug';
+        redactFields?: string[];
+        redactionStrategy?: {
+            mode: 'privacy-first' | 'visibility-first';
+            unredactFields?: string[];
+            redactFields?: string[];
+        };
+        enableAutomaticTracking?: boolean;
+        suppressConsoleErrors?: boolean;
+        recordCanvas?: boolean;
+        enableAutomaticProperties?: boolean;
+        propertyDenylist?: string[];
+        automaticTrackingOptions?: {
+            trackButtons?: boolean;
+            trackLinks?: boolean;
+            trackForms?: boolean;
+            includeText?: boolean;
+            includeClasses?: boolean;
+        };
+        maxQueueSize?: number;
+    }): HumanBehaviorTracker;
+    constructor(apiKey: string | undefined, ingestionUrl?: string, options?: {
+        enableAutomaticProperties?: boolean;
+        propertyDenylist?: string[];
+        redactionStrategy?: {
+            mode: 'privacy-first' | 'visibility-first';
+            unredactFields?: string[];
+            redactFields?: string[];
+        };
+        redactFields?: string[];
+        maxQueueSize?: number;
+    });
+    private init;
+    private initServerAsync;
+    /**
+     * ✅ FIXED: Wait for Kafka-based initialization to complete
+     */
+    private ensureInitialized;
+    /**
+     * Setup navigation event tracking for SPA navigation
+     */
+    private setupNavigationTracking;
+    /**
+     * Track navigation events and send custom events
+     */
+    trackNavigationEvent(type: string, fromUrl: string, toUrl: string): Promise<void>;
+    trackPageView(url?: string): Promise<void>;
+    customEvent(eventName: string, properties?: Record<string, any>): Promise<void>;
+    /**
+     * Setup automatic tracking for buttons, links, and forms
+     * TEMPORARILY DISABLED: Automatic custom event tracking
+     */
+    private setupAutomaticTracking;
+    /**
+     * Setup automatic button tracking
+     * TEMPORARILY DISABLED: Automatic custom event tracking
+     */
+    private setupAutomaticButtonTracking;
+    /**
+     * Setup automatic link tracking
+     * TEMPORARILY DISABLED: Automatic custom event tracking
+     */
+    private setupAutomaticLinkTracking;
+    /**
+     * Setup automatic form tracking
+     * TEMPORARILY DISABLED: Automatic custom event tracking
+     */
+    private setupAutomaticFormTracking;
+    /**
+     * Cleanup navigation tracking
+     */
+    private cleanupNavigationTracking;
+    static logToStorage(message: string): void;
+    /**
+     * Configure logging behavior for the SDK
+     * @param config Logger configuration options
+     */
+    static configureLogging(config: {
+        level?: 'none' | 'error' | 'warn' | 'info' | 'debug';
+        enableConsole?: boolean;
+        enableStorage?: boolean;
+    }): void;
+    /**
+     * Enable console event tracking
+     */
+    enableConsoleTracking(): void;
+    /**
+     * Disable console event tracking
+     */
+    disableConsoleTracking(): void;
+    private trackConsoleEvent;
+    private setupPageUnloadHandler;
+    viewLogs(): void;
+    /**
+     * Add user identification information to the tracker
+     * If userId is not provided, will use userProperties.email as the userId (if present)
+     */
+    identifyUser({ userProperties }: {
+        userProperties: Record<string, any>;
+    }): Promise<string>;
+    /**
+     * Get current user attributes
+     */
+    getUserAttributes(): Record<string, any>;
+    start(): Promise<void>;
+    /**
+     * Manually trigger a FullSnapshot (for navigation events)
+     * Delays snapshot to avoid capturing mid-animation states
+     */
+    private takeFullSnapshot;
+    stop(): Promise<void>;
+    /**
+     * Add an event to the ingestion queue
+     * Events are sent directly without processing to avoid corruption
+     */
+    addEvent(event: any): Promise<void>;
+    /**
+     * Flush events to the ingestion server
+     * Events are sent in chunks to handle large payloads efficiently
+     */
+    private flushEvents;
+    /**
+     * Add an event to the session recording queue
+     * These are typically FullSnapshots or IncrementalSnapshots
+     */
+    addRecordingEvent(event: any): Promise<void>;
+    private setCookie;
+    getCookie(name: string): string | null;
+    /**
+     * Delete a cookie by setting its expiration date to the past
+     * @param name The name of the cookie to delete
+     */
+    private deleteCookie;
+    /**
+     * Clear user data and reset session when user signs out of the site
+     * This should be called when a user logs out of your application to prevent
+     * data contamination between different users
+     */
+    logout(): void;
+    /**
+     * Start redaction functionality for sensitive input fields
+     * @param options Optional configuration for redaction behavior
+     */
+    redact(options?: RedactionOptions): Promise<void>;
+    /**
+     * Set specific fields to be redacted (for visibility-first mode)
+     * @param fields Array of CSS selectors for fields to redact
+     */
+    setRedactedFields(fields: string[]): void;
+    /**
+     * Set specific fields to be unredacted (everything else stays redacted by rrweb)
+     * @param fields Array of CSS selectors for fields to unredact (e.g., ['#username', '#comment'])
+     */
+    setUnredactedFields(fields: string[]): void;
+    private restartWithNewRedaction;
+    /**
+     * Check if any fields are currently unredacted
+     */
+    hasUnredactedFields(): boolean;
+    /**
+     * Get the currently unredacted fields
+     */
+    getUnredactedFields(): string[];
+    /**
+     * Remove specific fields from unredaction (they become redacted again)
+     * @param fields Array of CSS selectors for fields to redact
+     */
+    redactFields(fields: string[]): void;
+    /**
+     * Clear all unredacted fields (everything becomes redacted again)
+     */
+    clearUnredactedFields(): void;
+    /**
+     * Get the current session ID
+     */
+    getSessionId(): string;
+    /**
+     * Get the current URL being tracked
+     */
+    getCurrentUrl(): string;
+    /**
+     * Get current snapshot frequency info
+     * Uses configured values (5 minutes, 1000 events)
+     */
+    getSnapshotFrequencyInfo(): {
+        sessionDuration: number;
+        currentInterval: number;
+        currentThreshold: number;
+        phase: string;
+    };
+    /**
+     * Test if the tracker can reach the ingestion server
+     */
+    testConnection(): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Get connection status and recommendations
+     */
+    getConnectionStatus(): {
+        blocked: boolean;
+        recommendations: string[];
+    };
+    /**
+     * Check if the current user is a preexisting user
+     * Returns true if the user has an existing endUserId cookie from a previous session
+     */
+    isPreexistingUser(): boolean;
+    /**
+     * Get user information including whether they are preexisting
+     */
+    getUserInfo(): {
+        endUserId: string | null;
+        sessionId: string;
+        isPreexistingUser: boolean;
+        initialized: boolean;
+    };
+    /**
+     * Set a session property that will be included in all events for this session
+     */
+    setSessionProperty(key: string, value: any): void;
+    /**
+     * Set multiple session properties
+     */
+    setSessionProperties(properties: Record<string, any>): void;
+    /**
+     * Get a session property
+     */
+    getSessionProperty(key: string): any;
+    /**
+     * Remove a session property
+     */
+    removeSessionProperty(key: string): void;
+    /**
+     * Set a user property that will be included in all events
+     */
+    setUserProperty(key: string, value: any): void;
+    /**
+     * Set multiple user properties
+     */
+    setUserProperties(properties: Record<string, any>): void;
+    /**
+     * Get a user property
+     */
+    getUserProperty(key: string): any;
+    /**
+     * Remove a user property
+     */
+    removeUserProperty(key: string): void;
+    /**
+     * Set a property only if it hasn't been set before
+     */
+    setOnce(key: string, value: any, scope?: 'session' | 'user'): void;
+    /**
+     * Clear all session properties
+     */
+    clearSessionProperties(): void;
+    /**
+     * Clear all user properties
+     */
+    clearUserProperties(): void;
+    /**
+     * Get all properties for debugging
+     */
+    getAllProperties(): {
+        automatic: Record<string, any>;
+        session: Record<string, any>;
+        user: Record<string, any>;
+        initial: Record<string, any>;
+    };
+}
+export default HumanBehaviorTracker;
+//# sourceMappingURL=tracker.d.ts.map

package/packages/core/dist/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../src/tracker.ts"],"names":[],"mappings":"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"}

package/packages/core/dist/utils/global-tracker.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Global tracker utility functions
+ * Provides helper functions for accessing the global HumanBehavior tracker instance
+ */
+/**
+ * Identifies a user using the global HumanBehavior tracker
+ * @param userProperties - User properties to identify with
+ * @returns Promise<string> - The endUserId if successful, null if tracker not found
+ */
+export declare function identifyUserGlobally(userProperties: Record<string, any>): Promise<string> | null;
+/**
+ * Sends an event using the global HumanBehavior tracker
+ * @param eventName - Name of the event
+ * @param properties - Event properties
+ * @returns Promise<boolean> - True if successful, false if tracker not found
+ */
+export declare function sendEventGlobally(eventName: string, properties?: Record<string, any>): Promise<boolean> | null;
+/**
+ * Checks if the global HumanBehavior tracker is available
+ * @returns boolean - True if tracker is available
+ */
+export declare function isGlobalTrackerAvailable(): boolean;
+//# sourceMappingURL=global-tracker.d.ts.map

package/packages/core/dist/utils/global-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-tracker.d.ts","sourceRoot":"","sources":["../../src/utils/global-tracker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAShG;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAS9G;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAGlD"}

package/packages/core/dist/utils/logger.d.ts

@@ -0,0 +1,34 @@
+export declare enum LogLevel {
+    NONE = 0,
+    ERROR = 1,
+    WARN = 2,
+    INFO = 3,
+    DEBUG = 4
+}
+export interface LoggerConfig {
+    level: LogLevel;
+    enableConsole: boolean;
+    enableStorage: boolean;
+}
+declare class Logger {
+    private config;
+    private isBrowser;
+    constructor(config?: Partial<LoggerConfig>);
+    setConfig(config: Partial<LoggerConfig>): void;
+    private shouldLog;
+    private formatMessage;
+    error(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    info(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+    private logToStorage;
+    getLogs(): any[];
+    clearLogs(): void;
+}
+export declare const logger: Logger;
+export declare const logError: (message: string, ...args: any[]) => void;
+export declare const logWarn: (message: string, ...args: any[]) => void;
+export declare const logInfo: (message: string, ...args: any[]) => void;
+export declare const logDebug: (message: string, ...args: any[]) => void;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/packages/core/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IAClB,IAAI,IAAI;IACR,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,cAAM,MAAM;IACV,OAAO,CAAC,MAAM,CAIZ;IAEF,OAAO,CAAC,SAAS,CAAiC;gBAEtC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAM1C,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAI9C,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,aAAa;IAKrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAc5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAc3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAc3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAc5C,OAAO,CAAC,YAAY;IAqBpB,OAAO,IAAI,GAAG,EAAE;IAUhB,SAAS,IAAI,IAAI;CAKlB;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC;AAGnC,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,SAAmC,CAAC;AAC5F,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,SAAkC,CAAC;AAC1F,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,SAAkC,CAAC;AAC1F,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,SAAmC,CAAC"}

package/packages/core/dist/utils/property-detector.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Automatic Property Detection for HumanBehavior SDK
+ * Captures device type, location, and initial referrer information
+ */
+export interface DeviceInfo {
+    device_type: string;
+    browser: string;
+    browser_version: string;
+    os: string;
+    os_version: string;
+    device_model?: string;
+    screen_resolution: string;
+    viewport_size: string;
+    color_depth: number;
+    timezone: string;
+    language: string;
+    languages: string[];
+    raw_user_agent?: string;
+}
+export interface LocationInfo {
+    current_url: string;
+    pathname: string;
+    search: string;
+    hash: string;
+    title: string;
+    referrer: string;
+    referrer_domain: string;
+    initial_referrer: string;
+    initial_referrer_domain: string;
+    initial_host?: string;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_term?: string;
+    utm_content?: string;
+}
+export interface AutomaticProperties extends DeviceInfo, LocationInfo {
+}
+/**
+ * Get device information
+ */
+export declare function getDeviceInfo(): DeviceInfo;
+/**
+ * Get location information
+ */
+export declare function getLocationInfo(): LocationInfo;
+/**
+ * Get all automatic properties
+ */
+export declare function getAutomaticProperties(): AutomaticProperties;
+/**
+ * Get initial properties that should be captured once per session
+ */
+export declare function getInitialProperties(): Record<string, any>;
+/**
+ * Get current page properties (changes with navigation)
+ */
+export declare function getCurrentPageProperties(): Record<string, any>;
+//# sourceMappingURL=property-detector.d.ts.map

package/packages/core/dist/utils/property-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-detector.d.ts","sourceRoot":"","sources":["../../src/utils/property-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,UAAU;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,MAAM,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAoB,SAAQ,UAAU,EAAE,YAAY;CAAG;AA6KxE;;GAEG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAkC1C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAgC9C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAK5D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAgB1D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAmB9D"}

package/packages/core/dist/utils/property-manager.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Property Manager for HumanBehavior SDK
+ * Handles automatic properties, session properties, and user properties
+ */
+export interface Properties {
+    [key: string]: any;
+}
+export interface PropertyManagerConfig {
+    enableAutomaticProperties?: boolean;
+    enableSessionProperties?: boolean;
+    enableUserProperties?: boolean;
+    propertyDenylist?: string[];
+}
+export declare class PropertyManager {
+    private config;
+    private automaticProperties;
+    private sessionProperties;
+    private userProperties;
+    private initialProperties;
+    private isInitialized;
+    constructor(config?: PropertyManagerConfig);
+    /**
+     * Initialize the property manager
+     */
+    private initialize;
+    /**
+     * Get all properties for an event
+     */
+    getEventProperties(eventProperties?: Properties): Properties;
+    /**
+     * Get automatic properties
+     */
+    getAutomaticProperties(): Properties;
+    /**
+     * Get automatic properties with GeoIP data merged in
+     */
+    getAutomaticPropertiesWithGeoIP(geoIPProperties?: Record<string, any>): Properties;
+    /**
+     * Set a session property
+     */
+    setSessionProperty(key: string, value: any): void;
+    /**
+     * Set multiple session properties
+     */
+    setSessionProperties(properties: Properties): void;
+    /**
+     * Get a session property
+     */
+    getSessionProperty(key: string): any;
+    /**
+     * Remove a session property
+     */
+    removeSessionProperty(key: string): void;
+    /**
+     * Set a user property
+     */
+    setUserProperty(key: string, value: any): void;
+    /**
+     * Set multiple user properties
+     */
+    setUserProperties(properties: Properties): void;
+    /**
+     * Get a user property
+     */
+    getUserProperty(key: string): any;
+    /**
+     * Remove a user property
+     */
+    removeUserProperty(key: string): void;
+    /**
+     * Set a property only if it hasn't been set before
+     */
+    setOnce(key: string, value: any, scope?: 'session' | 'user'): void;
+    /**
+     * Clear all session properties
+     */
+    clearSessionProperties(): void;
+    /**
+     * Clear all user properties
+     */
+    clearUserProperties(): void;
+    /**
+     * Reset all properties
+     */
+    reset(): void;
+    /**
+     * Load session properties from sessionStorage
+     */
+    private loadSessionProperties;
+    /**
+     * Save session properties to sessionStorage
+     */
+    private saveSessionProperties;
+    /**
+     * Apply property denylist
+     */
+    private applyDenylist;
+    /**
+     * Update automatic properties (call when page changes)
+     */
+    updateAutomaticProperties(): void;
+    /**
+     * Get all properties for debugging
+     */
+    getAllProperties(): {
+        automatic: Properties;
+        session: Properties;
+        user: Properties;
+        initial: Properties;
+    };
+}
+//# sourceMappingURL=property-manager.d.ts.map