@tracelog/lib 0.5.4 → 0.6.0

package/dist/cjs/managers/storage.manager.d.ts

@@ -1,11 +1,13 @@
 /**
- * Manages localStorage with automatic fallback to in-memory storage.
+ * Manages localStorage and sessionStorage with automatic fallback to in-memory storage.
  * Provides a consistent interface for storing session data, configuration,
  * and analytics metadata across browser environments.
  */
 export declare class StorageManager {
     private readonly storage;
+    private readonly sessionStorageRef;
     private readonly fallbackStorage;
+    private readonly fallbackSessionStorage;
     private hasQuotaExceededError;
     constructor();
     /**
@@ -34,7 +36,19 @@ export declare class StorageManager {
      */
     hasQuotaError(): boolean;
     /**
-     * Initialize localStorage with feature detection
+     * Initialize storage (localStorage or sessionStorage) with feature detection
      */
     private initializeStorage;
+    /**
+     * Retrieves an item from sessionStorage
+     */
+    getSessionItem(key: string): string | null;
+    /**
+     * Stores an item in sessionStorage
+     */
+    setSessionItem(key: string, value: string): void;
+    /**
+     * Removes an item from sessionStorage
+     */
+    removeSessionItem(key: string): void;
 }

package/dist/cjs/managers/storage.manager.js

@@ -1,19 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.StorageManager = void 0;
-const debug_logger_utils_1 = require("../utils/logging/debug-logger.utils");
+const utils_1 = require("../utils");
 /**
- * Manages localStorage with automatic fallback to in-memory storage.
+ * Manages localStorage and sessionStorage with automatic fallback to in-memory storage.
  * Provides a consistent interface for storing session data, configuration,
  * and analytics metadata across browser environments.
  */
 class StorageManager {
     constructor() {
         this.fallbackStorage = new Map();
+        this.fallbackSessionStorage = new Map();
         this.hasQuotaExceededError = false;
-        this.storage = this.initializeStorage();
+        this.storage = this.initializeStorage('localStorage');
+        this.sessionStorageRef = this.initializeStorage('sessionStorage');
         if (!this.storage) {
-            debug_logger_utils_1.debugLog.warn('StorageManager', 'localStorage not available, using memory fallback');
+            (0, utils_1.log)('warn', 'localStorage not available, using memory fallback');
+        }
+        if (!this.sessionStorageRef) {
+            (0, utils_1.log)('warn', 'sessionStorage not available, using memory fallback');
         }
     }
     /**
@@ -26,8 +31,8 @@ class StorageManager {
             }
             return this.fallbackStorage.get(key) ?? null;
         }
-        catch (error) {
-            debug_logger_utils_1.debugLog.warn('StorageManager', 'Failed to get item, using fallback', { key, error });
+        catch {
+            // Silent fallback - user already warned in constructor
             return this.fallbackStorage.get(key) ?? null;
         }
     }
@@ -44,14 +49,12 @@ class StorageManager {
         catch (error) {
             if (error instanceof DOMException && error.name === 'QuotaExceededError') {
                 this.hasQuotaExceededError = true;
-                debug_logger_utils_1.debugLog.error('StorageManager', 'localStorage quota exceeded - data will not persist after reload', {
-                    key,
-                    valueSize: value.length,
+                (0, utils_1.log)('error', 'localStorage quota exceeded - data will not persist after reload', {
+                    error,
+                    data: { key, valueSize: value.length },
                 });
             }
-            else {
-                debug_logger_utils_1.debugLog.warn('StorageManager', 'Failed to set item, using fallback', { key, error });
-            }
+            // Else: Silent fallback - user already warned in constructor
         }
         // Always update fallback for consistency
         this.fallbackStorage.set(key, value);
@@ -65,8 +68,8 @@ class StorageManager {
                 this.storage.removeItem(key);
             }
         }
-        catch (error) {
-            debug_logger_utils_1.debugLog.warn('StorageManager', 'Failed to remove item', { key, error });
+        catch {
+            // Silent - not critical
         }
         // Always clean fallback
         this.fallbackStorage.delete(key);
@@ -89,10 +92,9 @@ class StorageManager {
             }
             keysToRemove.forEach((key) => this.storage.removeItem(key));
             this.fallbackStorage.clear();
-            debug_logger_utils_1.debugLog.debug('StorageManager', 'Cleared storage', { itemsRemoved: keysToRemove.length });
         }
         catch (error) {
-            debug_logger_utils_1.debugLog.error('StorageManager', 'Failed to clear storage', { error });
+            (0, utils_1.log)('error', 'Failed to clear storage', { error });
             this.fallbackStorage.clear();
         }
     }
@@ -110,14 +112,14 @@ class StorageManager {
         return this.hasQuotaExceededError;
     }
     /**
-     * Initialize localStorage with feature detection
+     * Initialize storage (localStorage or sessionStorage) with feature detection
      */
-    initializeStorage() {
+    initializeStorage(type) {
         if (typeof window === 'undefined') {
             return null;
         }
         try {
-            const storage = window.localStorage;
+            const storage = type === 'localStorage' ? window.localStorage : window.sessionStorage;
             const testKey = '__tracelog_test__';
             storage.setItem(testKey, 'test');
             storage.removeItem(testKey);
@@ -127,5 +129,57 @@ class StorageManager {
             return null;
         }
     }
+    /**
+     * Retrieves an item from sessionStorage
+     */
+    getSessionItem(key) {
+        try {
+            if (this.sessionStorageRef) {
+                return this.sessionStorageRef.getItem(key);
+            }
+            return this.fallbackSessionStorage.get(key) ?? null;
+        }
+        catch {
+            // Silent fallback - user already warned in constructor
+            return this.fallbackSessionStorage.get(key) ?? null;
+        }
+    }
+    /**
+     * Stores an item in sessionStorage
+     */
+    setSessionItem(key, value) {
+        try {
+            if (this.sessionStorageRef) {
+                this.sessionStorageRef.setItem(key, value);
+                return;
+            }
+        }
+        catch (error) {
+            if (error instanceof DOMException && error.name === 'QuotaExceededError') {
+                (0, utils_1.log)('error', 'sessionStorage quota exceeded - data will not persist', {
+                    error,
+                    data: { key, valueSize: value.length },
+                });
+            }
+            // Else: Silent fallback - user already warned in constructor
+        }
+        // Always update fallback for consistency
+        this.fallbackSessionStorage.set(key, value);
+    }
+    /**
+     * Removes an item from sessionStorage
+     */
+    removeSessionItem(key) {
+        try {
+            if (this.sessionStorageRef) {
+                this.sessionStorageRef.removeItem(key);
+            }
+        }
+        catch {
+            // Silent - not critical
+        }
+        // Always clean fallback
+        this.fallbackSessionStorage.delete(key);
+    }
 }
 exports.StorageManager = StorageManager;

package/dist/cjs/managers/user.manager.d.ts

@@ -12,5 +12,5 @@ export declare class UserManager {
      * @param projectId - Project identifier for namespacing
      * @returns Persistent unique user ID
      */
-    static getId(storageManager: StorageManager, projectId?: string): string;
+    static getId(storageManager: StorageManager): string;
 }

package/dist/cjs/managers/user.manager.js

@@ -16,8 +16,8 @@ class UserManager {
      * @param projectId - Project identifier for namespacing
      * @returns Persistent unique user ID
      */
-    static getId(storageManager, projectId) {
-        const storageKey = (0, constants_1.USER_ID_KEY)(projectId ?? '');
+    static getId(storageManager) {
+        const storageKey = constants_1.USER_ID_KEY;
         const storedUserId = storageManager.getItem(storageKey);
         if (storedUserId) {
             return storedUserId;

package/dist/cjs/public-api.d.ts

@@ -1,8 +1,8 @@
 export * from './app.constants';
-export * from './app.types';
+export * from './types';
 export declare const tracelog: {
-    init: (appConfig: import("./app.types").AppConfig) => Promise<void>;
-    event: (name: string, metadata?: Record<string, import("./app.types").MetadataType> | Record<string, import("./app.types").MetadataType>[]) => void;
+    init: (config: import("./types").Config) => Promise<void>;
+    event: (name: string, metadata?: Record<string, import("./types").MetadataType> | Record<string, import("./types").MetadataType>[]) => void;
     on: <K extends keyof import("./types").EmitterMap>(event: K, callback: import("./types").EmitterCallback<import("./types").EmitterMap[K]>) => void;
     off: <K extends keyof import("./types").EmitterMap>(event: K, callback: import("./types").EmitterCallback<import("./types").EmitterMap[K]>) => void;
     isInitialized: () => boolean;

package/dist/cjs/public-api.js

@@ -19,7 +19,7 @@ const api_1 = require("./api");
 // Constants
 __exportStar(require("./app.constants"), exports);
 // Types
-__exportStar(require("./app.types"), exports);
+__exportStar(require("./types"), exports);
 // TraceLog namespace containing all API methods
 exports.tracelog = {
     init: api_1.init,

package/dist/cjs/test-bridge.d.ts

@@ -16,6 +16,7 @@ export declare class TestBridge extends App implements TraceLogTestBridge {
     private _isInitializing;
     private _isDestroying;
     constructor(isInitializing: boolean, isDestroying: boolean);
+    init(config: any): Promise<void>;
     isInitializing(): boolean;
     sendCustomEvent(name: string, data?: Record<string, unknown> | Record<string, unknown>[]): void;
     getSessionData(): Record<string, unknown> | null;

package/dist/cjs/test-bridge.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TestBridge = void 0;
 const app_1 = require("./app");
+const api_1 = require("./api");
+const constants_1 = require("./constants");
 /**
  * Test bridge for E2E testing
  */
@@ -12,6 +14,34 @@ class TestBridge extends app_1.App {
         this._isInitializing = isInitializing;
         this._isDestroying = isDestroying;
     }
+    async init(config) {
+        // Guard: TestBridge should only be used in development
+        if (process.env.NODE_ENV !== 'dev') {
+            throw new Error('[TraceLog] TestBridge is only available in development mode');
+        }
+        // First sync with window.tracelog BEFORE initializing
+        // This ensures both APIs point to the same instance from the start
+        if (!api_1.__setAppInstance) {
+            throw new Error('[TraceLog] __setAppInstance is not available (production build?)');
+        }
+        try {
+            (0, api_1.__setAppInstance)(this);
+        }
+        catch {
+            // If __setAppInstance fails (e.g., already initialized), throw clear error
+            throw new Error('[TraceLog] TestBridge cannot sync with existing tracelog instance. Call destroy() first.');
+        }
+        try {
+            await super.init(config);
+        }
+        catch (error) {
+            // If init fails, clear the sync
+            if (api_1.__setAppInstance) {
+                (0, api_1.__setAppInstance)(null);
+            }
+            throw error;
+        }
+    }
     isInitializing() {
         return this._isInitializing;
     }
@@ -46,7 +76,8 @@ class TestBridge extends app_1.App {
         if (!storageManager) {
             throw new Error('Storage manager not available');
         }
-        const projectId = this.get('config')?.id;
+        const config = this.get('config');
+        const projectId = config?.integrations?.tracelog?.projectId ?? config?.integrations?.custom?.apiUrl ?? 'test';
         const userId = this.get('userId');
         const sessionId = this.get('sessionId');
         if (!projectId || !userId) {
@@ -61,7 +92,7 @@ class TestBridge extends app_1.App {
             timestamp: Date.now(),
         };
         // Store in the same format as SenderManager.persistEvents()
-        const storageKey = `tl:${projectId}:queue:${userId}`;
+        const storageKey = `${constants_1.STORAGE_BASE_KEY}:${projectId}:queue:${userId}`;
         storageManager.setItem(storageKey, JSON.stringify(persistedData));
     }
     get(key) {
@@ -106,6 +137,10 @@ class TestBridge extends app_1.App {
         this._isDestroying = true;
         try {
             await super.destroy(force);
+            // Clear window.tracelog API reference (only in dev mode)
+            if (api_1.__setAppInstance) {
+                (0, api_1.__setAppInstance)(null);
+            }
         }
         finally {
             this._isDestroying = false;

package/dist/cjs/types/config.types.d.ts

@@ -1,18 +1,5 @@
 import { MetadataType } from './common.types';
-import { TagConfig } from './tag.types';
-import { Mode } from './mode.types';
-export type Config = AppConfig & ExclusiveApiConfig;
-export type ApiConfig = SharedConfig & ExclusiveApiConfig;
-export type SharedConfig = Pick<AppConfig, 'mode' | 'samplingRate' | 'excludedUrlPaths'>;
-export interface ExclusiveApiConfig {
-    /** Tag definitions used to categorize tracked events. */
-    tags?: TagConfig[];
-    /** Determines if IP address is excluded from tracking. */
-    ipExcluded?: boolean;
-}
-export interface AppConfig {
-    /** Project identifier used for tracing. */
-    id: string;
+export interface Config {
     /** Session inactivity timeout in milliseconds. @default 900000 */
     sessionTimeout?: number;
     /** Metadata appended to every tracked event. */
@@ -25,14 +12,20 @@ export interface AppConfig {
     sensitiveQueryParams?: string[];
     /** Error event sampling rate between 0 and 1. */
     errorSampling?: number;
-    /** Logging mode controlling verbosity of client logs. */
-    mode?: Mode;
     /** Event sampling rate between 0 and 1. */
     samplingRate?: number;
-    /** URL path patterns that should be ignored by tracking. */
-    excludedUrlPaths?: string[];
     /** Optional configuration for third-party integrations. */
     integrations?: {
+        /** TraceLog integration options. */
+        tracelog?: {
+            /** Required project ID TraceLog SaaS integration. */
+            projectId: string;
+        };
+        /** Custom integration options. */
+        custom?: {
+            /** Required API URL for custom integration. */
+            apiUrl: string;
+        };
         /** Google Analytics integration options. */
         googleAnalytics?: {
             /** Required measurement ID for Google Analytics. */
@@ -40,3 +33,7 @@ export interface AppConfig {
         };
     };
 }
+export declare enum SpecialApiUrl {
+    Localhost = "localhost:8080",
+    Fail = "localhost:9999"
+}

package/dist/cjs/types/config.types.js

@@ -1,2 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpecialApiUrl = void 0;
+var SpecialApiUrl;
+(function (SpecialApiUrl) {
+    SpecialApiUrl["Localhost"] = "localhost:8080";
+    SpecialApiUrl["Fail"] = "localhost:9999";
+})(SpecialApiUrl || (exports.SpecialApiUrl = SpecialApiUrl = {}));

package/dist/cjs/types/event.types.d.ts

@@ -74,15 +74,8 @@ export interface PageViewData {
     search?: string;
     hash?: string;
 }
-export interface EventLocation {
-    country: string;
-    country_code: string;
-}
-export interface VitalSample {
-    type: WebVitalType;
-    value: number;
-}
 export interface EventData {
+    id: string;
     type: EventType;
     page_url: string;
     timestamp: number;
@@ -96,9 +89,4 @@ export interface EventData {
     session_end_reason?: SessionEndReason;
     error_data?: ErrorData;
     utm?: UTM;
-    location?: EventLocation;
-    tags?: string[] | {
-        id: string;
-        key: string;
-    }[];
 }

package/dist/cjs/types/index.d.ts

@@ -1,4 +1,3 @@
-export * from './api.types';
 export * from './common.types';
 export * from './config.types';
 export * from './device.types';
@@ -9,7 +8,6 @@ export * from './mode.types';
 export * from './queue.types';
 export * from './session.types';
 export * from './state.types';
-export * from './tag.types';
 export * from './test-bridge.types';
 export * from './validation-error.types';
 export * from './window.types';

package/dist/cjs/types/index.js

@@ -14,7 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./api.types"), exports);
 __exportStar(require("./common.types"), exports);
 __exportStar(require("./config.types"), exports);
 __exportStar(require("./device.types"), exports);
@@ -25,7 +24,6 @@ __exportStar(require("./mode.types"), exports);
 __exportStar(require("./queue.types"), exports);
 __exportStar(require("./session.types"), exports);
 __exportStar(require("./state.types"), exports);
-__exportStar(require("./tag.types"), exports);
 __exportStar(require("./test-bridge.types"), exports);
 __exportStar(require("./validation-error.types"), exports);
 __exportStar(require("./window.types"), exports);

package/dist/cjs/types/mode.types.d.ts

@@ -2,6 +2,5 @@
  * App modes for the TraceLog Library
  */
 export declare enum Mode {
-    QA = "qa",
-    DEBUG = "debug"
+    QA = "qa"
 }

package/dist/cjs/types/mode.types.js

@@ -7,5 +7,4 @@ exports.Mode = void 0;
 var Mode;
 (function (Mode) {
     Mode["QA"] = "qa";
-    Mode["DEBUG"] = "debug";
 })(Mode || (exports.Mode = Mode = {}));

package/dist/cjs/types/queue.types.d.ts

@@ -8,11 +8,6 @@ export interface BaseEventsQueueDto {
     events: EventData[];
     global_metadata?: Record<string, MetadataType>;
 }
-export interface ExtendedEventsQueueDto extends BaseEventsQueueDto {
-    project: string;
-    source: string;
-    ip: string;
-}
 export interface PersistedQueueData {
     userId: string;
     sessionId: string;
@@ -20,5 +15,4 @@ export interface PersistedQueueData {
     events: BaseEventsQueueDto['events'];
     timestamp: number;
     global_metadata?: BaseEventsQueueDto['global_metadata'];
-    fallbackMode?: boolean;
 }

package/dist/cjs/types/state.types.d.ts

@@ -1,6 +1,8 @@
 import { Config } from './config.types';
 import { DeviceType } from './device.types';
+import { Mode } from './mode.types';
 export interface State {
+    mode?: Mode;
     apiUrl: string;
     config: Config;
     sessionId: string | null;

package/dist/cjs/types/test-bridge.types.d.ts

@@ -7,7 +7,7 @@ import { SessionHandler } from '@/handlers/session.handler';
 import { GoogleAnalyticsIntegration } from '@/integrations/google-analytics.integration';
 import { EventManager } from '@/managers/event.manager';
 import { StorageManager as TraceLogStorageManager } from '@/managers/storage.manager';
-import { AppConfig } from './config.types';
+import { Config } from './config.types';
 import { State } from './state.types';
 /**
  * Testing bridge interface for E2E tests
@@ -15,7 +15,7 @@ import { State } from './state.types';
  */
 export interface TraceLogTestBridge {
     readonly initialized: boolean;
-    init(config: AppConfig): Promise<void>;
+    init(config: Config): Promise<void>;
     destroy(): Promise<void>;
     isInitializing(): boolean;
     sendCustomEvent(name: string, data?: Record<string, unknown> | Record<string, unknown>[]): void;

package/dist/cjs/types/validation-error.types.d.ts

@@ -10,12 +10,6 @@ export declare abstract class TraceLogValidationError extends Error {
     readonly layer: 'config' | 'app' | 'runtime';
     constructor(message: string, errorCode: string, layer: 'config' | 'app' | 'runtime');
 }
-/**
- * Thrown when project ID validation fails
- */
-export declare class ProjectIdValidationError extends TraceLogValidationError {
-    constructor(message?: string, layer?: 'config' | 'app' | 'runtime');
-}
 /**
  * Thrown when app configuration validation fails
  */

package/dist/cjs/types/validation-error.types.js

@@ -4,7 +4,7 @@
  * Provides better error handling and consistency across validation layers
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InitializationTimeoutError = exports.IntegrationValidationError = exports.SamplingRateValidationError = exports.SessionTimeoutValidationError = exports.AppConfigValidationError = exports.ProjectIdValidationError = exports.TraceLogValidationError = void 0;
+exports.InitializationTimeoutError = exports.IntegrationValidationError = exports.SamplingRateValidationError = exports.SessionTimeoutValidationError = exports.AppConfigValidationError = exports.TraceLogValidationError = void 0;
 /**
  * Base class for all TraceLog validation errors
  */
@@ -21,15 +21,6 @@ class TraceLogValidationError extends Error {
     }
 }
 exports.TraceLogValidationError = TraceLogValidationError;
-/**
- * Thrown when project ID validation fails
- */
-class ProjectIdValidationError extends TraceLogValidationError {
-    constructor(message = 'Project ID is required', layer = 'config') {
-        super(message, 'PROJECT_ID_INVALID', layer);
-    }
-}
-exports.ProjectIdValidationError = ProjectIdValidationError;
 /**
  * Thrown when app configuration validation fails
  */

package/dist/cjs/utils/browser/device-detector.utils.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDeviceType = void 0;
 const device_types_1 = require("../../types/device.types");
-const logging_1 = require("../logging");
+const logging_utils_1 = require("../logging.utils");
 let coarsePointerQuery;
 let noHoverQuery;
 const initMediaQueries = () => {
@@ -17,22 +17,14 @@ const initMediaQueries = () => {
  */
 const getDeviceType = () => {
     try {
-        logging_1.debugLog.debug('DeviceDetector', 'Starting device detection');
         const nav = navigator;
         if (nav.userAgentData && typeof nav.userAgentData.mobile === 'boolean') {
-            logging_1.debugLog.debug('DeviceDetector', 'Using modern User-Agent Client Hints API', {
-                mobile: nav.userAgentData.mobile,
-                platform: nav.userAgentData.platform,
-            });
             if (nav.userAgentData.platform && /ipad|tablet/i.test(nav.userAgentData.platform)) {
-                logging_1.debugLog.debug('DeviceDetector', 'Device detected as tablet via platform hint');
                 return device_types_1.DeviceType.Tablet;
             }
             const result = nav.userAgentData.mobile ? device_types_1.DeviceType.Mobile : device_types_1.DeviceType.Desktop;
-            logging_1.debugLog.debug('DeviceDetector', 'Device detected via User-Agent hints', { result });
             return result;
         }
-        logging_1.debugLog.debug('DeviceDetector', 'Using fallback detection methods');
         initMediaQueries();
         const width = window.innerWidth;
         const hasCoarsePointer = coarsePointerQuery?.matches ?? false;
@@ -41,30 +33,16 @@ const getDeviceType = () => {
         const ua = navigator.userAgent.toLowerCase();
         const isMobileUA = /mobile|android|iphone|ipod|blackberry|iemobile|opera mini/.test(ua);
         const isTabletUA = /tablet|ipad|android(?!.*mobile)/.test(ua);
-        const detectionData = {
-            width,
-            hasCoarsePointer,
-            hasNoHover,
-            hasTouchSupport,
-            isMobileUA,
-            isTabletUA,
-            maxTouchPoints: navigator.maxTouchPoints,
-        };
         if (width <= 767 || (isMobileUA && hasTouchSupport)) {
-            logging_1.debugLog.debug('DeviceDetector', 'Device detected as mobile', detectionData);
             return device_types_1.DeviceType.Mobile;
         }
         if ((width >= 768 && width <= 1024) || isTabletUA || (hasCoarsePointer && hasNoHover && hasTouchSupport)) {
-            logging_1.debugLog.debug('DeviceDetector', 'Device detected as tablet', detectionData);
             return device_types_1.DeviceType.Tablet;
         }
-        logging_1.debugLog.debug('DeviceDetector', 'Device detected as desktop', detectionData);
         return device_types_1.DeviceType.Desktop;
     }
     catch (error) {
-        logging_1.debugLog.warn('DeviceDetector', 'Device detection failed, defaulting to desktop', {
-            error: error instanceof Error ? error.message : error,
-        });
+        (0, logging_utils_1.log)('warn', 'Device detection failed, defaulting to desktop', { error });
         return device_types_1.DeviceType.Desktop;
     }
 };

package/dist/cjs/utils/browser/index.d.ts

@@ -1,2 +1,3 @@
 export * from './device-detector.utils';
+export * from './qa-mode.utils';
 export * from './utm-params.utils';

package/dist/cjs/utils/browser/index.js

@@ -15,4 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./device-detector.utils"), exports);
+__exportStar(require("./qa-mode.utils"), exports);
 __exportStar(require("./utm-params.utils"), exports);

package/dist/cjs/utils/browser/qa-mode.utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Detects if QA mode should be active based on URL query parameter or sessionStorage
+ *
+ * Detection flow:
+ * 1. Check if already active in sessionStorage
+ * 2. Check for ?tlog_mode=qa query parameter
+ * 3. If found in URL:
+ *    - Persist to sessionStorage
+ *    - Clean param from URL
+ *
+ * @returns True if QA mode is active, false otherwise
+ */
+export declare const detectQaMode: () => boolean;