react-native-inapp-inspector 2.3.5 → 2.3.7

package/dist/commonjs/customHooks/reduxLogger.js

@@ -1,17 +1,4 @@
 "use strict";
-// #8 — Redux inspector module.
-//
-// Two integration paths, both feeding the same timeline/state snapshot:
-//
-//   1. `inspectorReduxMiddleware` (recommended) — a standard Redux middleware.
-//      Because it sits inside the middleware chain it sees EVERY action,
-//      including ones dispatched from thunks, sagas, listeners and RTK Query.
-//
-//   2. `connectReduxStore(store)` — zero-config fallback. It wraps the outer
-//      `store.dispatch` AND diffs state on `store.subscribe`, so even actions
-//      that bypass the wrapped dispatch (thunk/saga internals capture the raw
-//      dispatch reference at store-creation time) still update the state tree
-//      and per-reducer "last action" consistently.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.connectReduxStore = exports.inspectorReduxMiddleware = exports.subscribeReduxState = exports.setReduxState = exports.clearActionHistory = exports.getActionHistory = exports.clearLastActionForReducer = exports.getLastActionForReducer = exports.getReduxAutoRefresh = exports.setReduxAutoRefresh = exports.getReduxState = exports.isReduxConnected = exports.pruneReduxHistory = exports.getMaxReduxHistoryLimit = exports.setMaxReduxHistoryLimit = exports.getReduxModuleEnabled = exports.setReduxModuleEnabled = void 0;
 const helpers_1 = require("../helpers");
@@ -49,9 +36,6 @@ const pruneReduxHistory = (targetCount) => {
     return Math.max(0, pruned);
 };
 exports.pruneReduxHistory = pruneReduxHistory;
-// Guards against double-instrumentation (e.g. connectReduxStore called twice,
-// or middleware + connect used together) which previously produced duplicate
-// timeline entries and inconsistent counts.
 const connectedStores = new WeakSet();
 let middlewareAttached = false;
 const isReduxConnected = () => middlewareAttached || currentReduxState != null || actionHistory.length > 0;
@@ -107,7 +91,6 @@ function actionTypeOf(action) {
 function detectActionOrigin(stack, actionType, actionObj) {
     const stackLower = (stack || '').toLowerCase();
     const typeLower = (actionType || '').toLowerCase();
-    // Explicit hint on action if developer tagged it
     if (actionObj && actionObj.__origin) {
         const raw = String(actionObj.__origin).toLowerCase();
         if (raw.includes('saga'))
@@ -117,7 +100,6 @@ function detectActionOrigin(stack, actionType, actionObj) {
         if (raw.includes('ui'))
             return { originType: 'ui' };
     }
-    // 1. Saga Detection (Stack + Action naming conventions)
     const isSaga = stackLower.includes('redux-saga') ||
         stackLower.includes('runputeffect') ||
         stackLower.includes('proc.js') ||
@@ -129,7 +111,6 @@ function detectActionOrigin(stack, actionType, actionObj) {
         typeLower.includes('saga') ||
         typeLower.startsWith('saga/') ||
         typeLower.startsWith('@saga/');
-    // 2. Thunk / RTK Query Detection
     const isThunk = stackLower.includes('createasyncthunk') ||
         stackLower.includes('redux-thunk') ||
         stackLower.includes('rtk-query') ||
@@ -139,12 +120,10 @@ function detectActionOrigin(stack, actionType, actionObj) {
         typeLower.endsWith('/pending') ||
         typeLower.endsWith('/fulfilled') ||
         typeLower.endsWith('/rejected');
-    // 3. Parse Stack Frames to find best application caller
     const lines = (stack || '').split('\n').map(l => l.trim()).filter(Boolean);
     let bestFrame = null;
     for (let i = 0; i < lines.length; i++) {
         const line = lines[i];
-        // Ignore logger / middleware lines inside inspector
         if (line.includes('reduxLogger') ||
             line.includes('inspectorReduxMiddleware') ||
             line.includes('recordAction') ||
@@ -195,7 +174,6 @@ function extractSliceName(actionType, affectedSlices) {
     if (affectedSlices && affectedSlices.length > 0) {
         return affectedSlices[0];
     }
-    // If Redux Toolkit action format: e.g. "users/fetchById" -> "users"
     const match = actionType.match(/^([a-zA-Z0-9_\-]+)\//);
     if (match && match[1] && !match[1].startsWith('@@')) {
         return match[1];
@@ -260,27 +238,11 @@ function recordAction(action, prevState, nextState, rawStack) {
     if (globalReduxAutoRefresh) {
         currentReduxState = nextState;
     }
-    // Timeline / last-action map always changed — notify even when the state
-    // tree snapshot is paused so those panels stay live.
     notify();
 }
-/**
- * Standard Redux middleware — add it to your store to capture every action,
- * including those dispatched from thunks, sagas and RTK Query:
- *
- *   const store = configureStore({
- *     reducer,
- *     middleware: gDM => gDM().concat(inspectorReduxMiddleware),
- *   });
- *
- * Pair with `connectReduxStore(store)` (safe — they de-duplicate) or rely on
- * the middleware alone; the initial snapshot is taken on the first action.
- */
 const inspectorReduxMiddleware = (storeApi) => (next) => (action) => {
     middlewareAttached = true;
     const capturedStack = new Error().stack || '';
-    // Thunks are functions — let them run; their inner plain-action dispatches
-    // pass back through this same middleware, so nothing is lost.
     if (typeof action === 'function') {
         return next(action);
     }
@@ -300,22 +262,15 @@ const connectReduxStore = (store) => {
         console.warn('[NetworkInspector] Invalid Redux store passed to connectReduxStore.');
         return;
     }
-    // Idempotent — connecting the same store twice must not double-wrap
-    // dispatch or double-record the timeline.
     if (connectedStores.has(store)) {
         return;
     }
     connectedStores.add(store);
-    // Wrap the outer dispatch so directly dispatched actions get full
-    // type/payload attribution. Skipped when the middleware is already
-    // attached, otherwise every direct dispatch would be recorded twice.
     const originalDispatch = store.dispatch.bind(store);
     let inWrappedDispatch = false;
     store.dispatch = (action) => {
         const capturedStack = new Error().stack || '';
         if (middlewareAttached || typeof action === 'function') {
-            // Middleware handles recording, or it's a thunk whose inner dispatches
-            // will be picked up individually.
             inWrappedDispatch = true;
             try {
                 return originalDispatch(action);
@@ -337,9 +292,6 @@ const connectReduxStore = (store) => {
         return result;
     };
     (0, exports.setReduxState)(store.getState());
-    // Subscribe-diff fallback: catches state changes whose dispatch bypassed
-    // the wrapper above (thunk/saga internals hold the raw dispatch reference).
-    // Without this, the tree and per-reducer last-action drifted out of sync.
     let lastSeenState = store.getState();
     store.subscribe(() => {
         const nextState = store.getState();
@@ -348,15 +300,12 @@ const connectReduxStore = (store) => {
         const prevState = lastSeenState;
         lastSeenState = nextState;
         if (inWrappedDispatch || middlewareAttached) {
-            // Already recorded with proper attribution; just refresh the snapshot.
             if (globalReduxAutoRefresh) {
                 currentReduxState = nextState;
                 notify();
             }
             return;
         }
-        // Change arrived outside the wrapped dispatch — record it so the
-        // timeline stays consistent, even without the original action type.
         const subStack = new Error().stack || '';
         recordAction({ type: '@@inspector/EXTERNAL_STATE_CHANGE' }, prevState, nextState, subStack);
     });

package/dist/commonjs/customHooks/storageInspector.d.ts

@@ -6,62 +6,22 @@ export interface StorageEntry {
     byteSize: number;
 }
 export type StorageDriver = 'asyncStorage' | 'mmkv';
-/**
- * Register an AsyncStorage instance with the inspector (optional override).
- */
 export declare const connectAsyncStorage: (storageInstance: any) => void;
-/**
- * Register an MMKV instance with the inspector (optional override).
- */
 export declare const connectMMKV: (mmkvInstance: any, id?: string) => void;
-/**
- * Auto-detect AsyncStorage:
- * 1. Explicit connection
- * 2. Global instance
- * 3. Dynamic require '@react-native-async-storage/async-storage'
- * 4. Native Bridge Direct interface
- */
 export declare const getResolvedAsyncStorage: () => any;
-/**
- * Auto-detect MMKV:
- * 1. Explicit connection
- * 2. Dynamic require 'react-native-mmkv' & instantiate default instance
- * 3. Global MMKV / JSI instances
- */
 export declare const getResolvedMMKV: (id?: string) => any;
 export declare const isAsyncStorageConnected: () => boolean;
 export declare const isMMKVConnected: () => boolean;
 export declare const getRegisteredMMKVInstanceIds: () => string[];
-/**
- * Calculate approximate byte size of a UTF-8 string
- */
 export declare const calculateByteSize: (str: string) => number;
-/**
- * Determine type and format value safely without blocking JS thread
- */
 export declare const analyzeStorageValue: (rawVal: any) => {
     strVal: string;
     parsedValue?: any;
     type: "json" | "string" | "number" | "boolean" | "null";
     byteSize: number;
 };
-/**
- * Fetch all storage entries for given driver
- */
 export declare const fetchStorageEntries: (driver: StorageDriver, instanceId?: string) => Promise<StorageEntry[]>;
-/**
- * Create or Update a key-value entry (CRUD: Create / Update)
- */
 export declare const setStorageEntry: (driver: StorageDriver, key: string, value: string, instanceId?: string) => Promise<boolean>;
-/**
- * Delete a single key (CRUD: Delete)
- */
 export declare const removeStorageEntry: (driver: StorageDriver, key: string, instanceId?: string) => Promise<boolean>;
-/**
- * Wipe all keys for given storage (CRUD: Clear All)
- */
 export declare const clearStorageDriver: (driver: StorageDriver, instanceId?: string) => Promise<boolean>;
-/**
- * Subscribe to storage mutations
- */
 export declare const subscribeToStorageChanges: (listener: () => void) => (() => void);

package/dist/commonjs/customHooks/storageInspector.js

@@ -1,13 +1,9 @@
 "use strict";
-// Universal In-App Storage Inspector Adapter for AsyncStorage & MMKV
-// Supports automatic module resolution, NativeModules SQLite fallback, custom instances, and full CRUD operations.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.subscribeToStorageChanges = exports.clearStorageDriver = exports.removeStorageEntry = exports.setStorageEntry = exports.fetchStorageEntries = exports.analyzeStorageValue = exports.calculateByteSize = exports.getRegisteredMMKVInstanceIds = exports.isMMKVConnected = exports.isAsyncStorageConnected = exports.getResolvedMMKV = exports.getResolvedAsyncStorage = exports.connectMMKV = exports.connectAsyncStorage = void 0;
 const react_native_1 = require("react-native");
-// In-memory registered storage references
 let customAsyncStorage = null;
 const customMMKVInstances = new Map();
-// Listeners for storage mutations
 const changeListeners = new Set();
 const notifyChange = () => {
     changeListeners.forEach(listener => {
@@ -17,9 +13,6 @@ const notifyChange = () => {
         catch { }
     });
 };
-/**
- * Register an AsyncStorage instance with the inspector (optional override).
- */
 const connectAsyncStorage = (storageInstance) => {
     if (storageInstance) {
         customAsyncStorage = storageInstance;
@@ -27,9 +20,6 @@ const connectAsyncStorage = (storageInstance) => {
     }
 };
 exports.connectAsyncStorage = connectAsyncStorage;
-/**
- * Register an MMKV instance with the inspector (optional override).
- */
 const connectMMKV = (mmkvInstance, id = 'default') => {
     if (mmkvInstance) {
         customMMKVInstances.set(id, mmkvInstance);
@@ -37,10 +27,6 @@ const connectMMKV = (mmkvInstance, id = 'default') => {
     }
 };
 exports.connectMMKV = connectMMKV;
-/**
- * Native Bridge Fallback for AsyncStorage:
- * Directly interfaces with NativeModules.RNCAsyncStorage without needing JS package imports.
- */
 const getNativeAsyncStorageBridge = () => {
     const nativeModule = react_native_1.NativeModules.RNCAsyncStorage ||
         react_native_1.NativeModules.RNC_AsyncSQLiteDBStorage ||
@@ -135,17 +121,9 @@ const getNativeAsyncStorageBridge = () => {
     }
     return null;
 };
-/**
- * Auto-detect AsyncStorage:
- * 1. Explicit connection
- * 2. Global instance
- * 3. Dynamic require '@react-native-async-storage/async-storage'
- * 4. Native Bridge Direct interface
- */
 const getResolvedAsyncStorage = () => {
     if (customAsyncStorage)
         return customAsyncStorage;
-    // 1. Global instances
     try {
         const maybeReq = globalThis?.__inAppAsyncStorage ||
             globalThis?.AsyncStorage ||
@@ -155,7 +133,6 @@ const getResolvedAsyncStorage = () => {
         }
     }
     catch { }
-    // 2. Dynamic runtime require
     try {
         const req = typeof globalThis?.require === 'function'
             ? globalThis.require
@@ -182,7 +159,6 @@ const getResolvedAsyncStorage = () => {
         }
     }
     catch { }
-    // 3. Native Bridge Fallback (Direct SQLite)
     const nativeBridge = getNativeAsyncStorageBridge();
     if (nativeBridge) {
         return nativeBridge;
@@ -190,17 +166,10 @@ const getResolvedAsyncStorage = () => {
     return null;
 };
 exports.getResolvedAsyncStorage = getResolvedAsyncStorage;
-/**
- * Auto-detect MMKV:
- * 1. Explicit connection
- * 2. Dynamic require 'react-native-mmkv' & instantiate default instance
- * 3. Global MMKV / JSI instances
- */
 const getResolvedMMKV = (id = 'default') => {
     if (customMMKVInstances.has(id)) {
         return customMMKVInstances.get(id);
     }
-    // 1. Dynamic require
     try {
         const req = typeof globalThis?.require === 'function'
             ? globalThis.require
@@ -222,7 +191,6 @@ const getResolvedMMKV = (id = 'default') => {
         }
     }
     catch { }
-    // 2. Global references
     try {
         const globalMMKV = globalThis?.mmkv ||
             global?.mmkv ||
@@ -252,22 +220,16 @@ const isMMKVConnected = () => {
 };
 exports.isMMKVConnected = isMMKVConnected;
 const getRegisteredMMKVInstanceIds = () => {
-    (0, exports.getResolvedMMKV)(); // trigger auto-discovery
+    (0, exports.getResolvedMMKV)();
     return Array.from(customMMKVInstances.keys());
 };
 exports.getRegisteredMMKVInstanceIds = getRegisteredMMKVInstanceIds;
-/**
- * Calculate approximate byte size of a UTF-8 string
- */
 const calculateByteSize = (str) => {
     if (!str)
         return 0;
     return str.length * 2;
 };
 exports.calculateByteSize = calculateByteSize;
-/**
- * Determine type and format value safely without blocking JS thread
- */
 const analyzeStorageValue = (rawVal) => {
     if (rawVal === null || rawVal === undefined) {
         return { strVal: 'null', type: 'null', byteSize: 4 };
@@ -283,7 +245,6 @@ const analyzeStorageValue = (rawVal) => {
     const trimmed = strVal.trim();
     if ((trimmed.startsWith('{') && trimmed.endsWith('}')) ||
         (trimmed.startsWith('[') && trimmed.endsWith(']'))) {
-        // For small/medium JSON, parse eagerly; for huge payloads (>10KB), parse lazily on expand
         if (trimmed.length < 10000) {
             try {
                 const parsed = JSON.parse(trimmed);
@@ -302,9 +263,6 @@ const analyzeStorageValue = (rawVal) => {
     return { strVal, type: 'string', byteSize };
 };
 exports.analyzeStorageValue = analyzeStorageValue;
-/**
- * Fetch all storage entries for given driver
- */
 const fetchStorageEntries = async (driver, instanceId) => {
     const entries = [];
     if (driver === 'asyncStorage') {
@@ -387,14 +345,10 @@ const fetchStorageEntries = async (driver, instanceId) => {
             console.warn('[StorageInspector] Error reading MMKV keys:', err);
         }
     }
-    // Sort alphabetically by key
     entries.sort((a, b) => a.key.localeCompare(b.key));
     return entries;
 };
 exports.fetchStorageEntries = fetchStorageEntries;
-/**
- * Create or Update a key-value entry (CRUD: Create / Update)
- */
 const setStorageEntry = async (driver, key, value, instanceId) => {
     if (!key.trim())
         return false;
@@ -422,9 +376,6 @@ const setStorageEntry = async (driver, key, value, instanceId) => {
     return false;
 };
 exports.setStorageEntry = setStorageEntry;
-/**
- * Delete a single key (CRUD: Delete)
- */
 const removeStorageEntry = async (driver, key, instanceId) => {
     try {
         if (driver === 'asyncStorage') {
@@ -450,9 +401,6 @@ const removeStorageEntry = async (driver, key, instanceId) => {
     return false;
 };
 exports.removeStorageEntry = removeStorageEntry;
-/**
- * Wipe all keys for given storage (CRUD: Clear All)
- */
 const clearStorageDriver = async (driver, instanceId) => {
     try {
         if (driver === 'asyncStorage') {
@@ -478,9 +426,6 @@ const clearStorageDriver = async (driver, instanceId) => {
     return false;
 };
 exports.clearStorageDriver = clearStorageDriver;
-/**
- * Subscribe to storage mutations
- */
 const subscribeToStorageChanges = (listener) => {
     changeListeners.add(listener);
     return () => {

package/dist/commonjs/decorators/index.d.ts

@@ -4,45 +4,8 @@ export interface InspectLogOptions {
     logResult?: boolean;
     logDuration?: boolean;
 }
-/**
- * `@InspectLog`: Automatically logs method execution, arguments, duration, and return values
- * to the In-App Inspector Console.
- *
- * @example
- * ```ts
- * class UserService {
- *   @InspectLog({ tag: 'API', logArgs: true, logDuration: true })
- *   async fetchUser(id: string) {
- *     return api.get(`/users/${id}`);
- *   }
- * }
- * ```
- */
 export declare function InspectLog(options?: InspectLogOptions): (_target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-/**
- * `@InspectTrackTime`: Measures and logs execution duration for critical functions.
- *
- * @example
- * ```ts
- * class FeedManager {
- *   @InspectTrackTime('Feed Data Processing')
- *   processFeedItems(items: FeedItem[]) { ... }
- * }
- * ```
- */
 export declare function InspectTrackTime(label?: string): (_target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
-/**
- * `@InspectCatch`: Safely catches unhandled exceptions thrown inside the method,
- * logs them to the In-App Inspector, and returns a fallback value.
- *
- * @example
- * ```ts
- * class AuthService {
- *   @InspectCatch({ fallback: null, tag: 'AUTH' })
- *   async getCachedToken() { ... }
- * }
- * ```
- */
 export declare function InspectCatch(options?: {
     fallback?: any;
     tag?: string;

package/dist/commonjs/decorators/index.js

@@ -1,27 +1,8 @@
 "use strict";
-// ─── Method & Class Decorators for React Native In-App Inspector ─────────────
-//
-// Clean TypeScript decorators to seamlessly annotate methods, asynchronous actions,
-// and API services with automatic inspection, logging, timing, and error boundaries.
-// ─────────────────────────────────────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InspectLog = InspectLog;
 exports.InspectTrackTime = InspectTrackTime;
 exports.InspectCatch = InspectCatch;
-/**
- * `@InspectLog`: Automatically logs method execution, arguments, duration, and return values
- * to the In-App Inspector Console.
- *
- * @example
- * ```ts
- * class UserService {
- *   @InspectLog({ tag: 'API', logArgs: true, logDuration: true })
- *   async fetchUser(id: string) {
- *     return api.get(`/users/${id}`);
- *   }
- * }
- * ```
- */
 function InspectLog(options = {}) {
     const { tag = 'Inspect', logArgs = true, logResult = true, logDuration = true, } = options;
     return function (_target, propertyKey, descriptor) {
@@ -67,17 +48,6 @@ function InspectLog(options = {}) {
         return descriptor;
     };
 }
-/**
- * `@InspectTrackTime`: Measures and logs execution duration for critical functions.
- *
- * @example
- * ```ts
- * class FeedManager {
- *   @InspectTrackTime('Feed Data Processing')
- *   processFeedItems(items: FeedItem[]) { ... }
- * }
- * ```
- */
 function InspectTrackTime(label) {
     return function (_target, propertyKey, descriptor) {
         const originalMethod = descriptor.value;
@@ -105,18 +75,6 @@ function InspectTrackTime(label) {
         return descriptor;
     };
 }
-/**
- * `@InspectCatch`: Safely catches unhandled exceptions thrown inside the method,
- * logs them to the In-App Inspector, and returns a fallback value.
- *
- * @example
- * ```ts
- * class AuthService {
- *   @InspectCatch({ fallback: null, tag: 'AUTH' })
- *   async getCachedToken() { ... }
- * }
- * ```
- */
 function InspectCatch(options = {}) {
     const { fallback = undefined, tag = 'Catch' } = options;
     return function (_target, propertyKey, descriptor) {

package/dist/commonjs/helpers/gaAnalyticsRegistry.d.ts

@@ -4,15 +4,5 @@ export interface GAPlugin {
     name: string;
     resolveCategory?: (eventName: string, params?: Record<string, any>) => GAEventCategory | string | null | undefined;
 }
-/**
- * Register a dynamic Google Analytics / Firebase plugin or custom resolver.
- */
 export declare const registerGAPlugin: (plugin: GAPlugin) => void;
-/**
- * Dynamically resolves the GA4 event category using:
- * 1. Registered dynamic GA plugins
- * 2. Runtime Firebase Analytics inspection
- * 3. GA4 standard event taxonomies (O(1) Set lookup)
- * 4. Semantic pattern & prefix analysis
- */
 export declare const getEventCategory: (name: string, params?: Record<string, any>) => GAEventCategory;

package/dist/commonjs/helpers/gaAnalyticsRegistry.js

@@ -1,14 +1,8 @@
 "use strict";
-// ─── Google Analytics (GA4) & Firebase Analytics Dynamic Registry ─────────────
-//
-// Dynamically inspects GA4 / Firebase Analytics runtime schemas, auto-detects
-// standard GA4 event taxonomies, and supports dynamic GA plugins.
-// ─────────────────────────────────────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getEventCategory = exports.registerGAPlugin = exports.GAEventCategory = void 0;
 const enums_1 = require("../types/enums");
 Object.defineProperty(exports, "GAEventCategory", { enumerable: true, get: function () { return enums_1.GAEventCategory; } });
-// ─── Official GA4 & Firebase Standard Event Sets ─────────────────────────────
 const GA4_PAGE_VIEW_EVENTS = new Set([
     'screen_view',
     'page_view',
@@ -73,20 +67,13 @@ const GA4_SYSTEM_EVENTS = new Set([
     'ad_query',
     'ad_exposure',
 ]);
-// ─── Registered Dynamic Plugins ──────────────────────────────────────────────
 const registeredPlugins = [];
-/**
- * Register a dynamic Google Analytics / Firebase plugin or custom resolver.
- */
 const registerGAPlugin = (plugin) => {
     if (!registeredPlugins.some(p => p.name === plugin.name)) {
         registeredPlugins.push(plugin);
     }
 };
 exports.registerGAPlugin = registerGAPlugin;
-/**
- * Attempt dynamic inspection of host runtime Firebase / Google Analytics modules.
- */
 const tryInspectRuntimeFirebaseAnalytics = () => {
     try {
         const firebaseAnalytics = require('@react-native-firebase/analytics');
@@ -109,23 +96,13 @@ const tryInspectRuntimeFirebaseAnalytics = () => {
         }
     }
     catch {
-        // Optional dependency - safe fallback to built-in GA4 taxonomy
     }
 };
-// Initialize dynamic runtime inspection once
 tryInspectRuntimeFirebaseAnalytics();
-/**
- * Dynamically resolves the GA4 event category using:
- * 1. Registered dynamic GA plugins
- * 2. Runtime Firebase Analytics inspection
- * 3. GA4 standard event taxonomies (O(1) Set lookup)
- * 4. Semantic pattern & prefix analysis
- */
 const getEventCategory = (name, params) => {
     if (!name || typeof name !== 'string')
         return 'custom';
     const cleanName = name.trim().toLowerCase();
-    // 1. Run through registered dynamic plugins
     for (const plugin of registeredPlugins) {
         if (plugin.resolveCategory) {
             const category = plugin.resolveCategory(cleanName, params);
@@ -133,7 +110,6 @@ const getEventCategory = (name, params) => {
                 return category;
         }
     }
-    // 2. Exact GA4 taxonomy matching (O(1))
     if (GA4_PAGE_VIEW_EVENTS.has(cleanName)) {
         return 'page_view';
     }
@@ -143,7 +119,6 @@ const getEventCategory = (name, params) => {
     if (GA4_SYSTEM_EVENTS.has(cleanName)) {
         return 'system';
     }
-    // 3. Prefix & namespace detection
     if (cleanName.startsWith('firebase_') ||
         cleanName.startsWith('ga_') ||
         cleanName.startsWith('gtag_') ||
@@ -151,7 +126,6 @@ const getEventCategory = (name, params) => {
         cleanName.startsWith('google_')) {
         return 'system';
     }
-    // 4. Semantic pattern matching
     if (cleanName.endsWith('_view') ||
         cleanName.endsWith('_screen') ||
         cleanName.startsWith('screen_') ||

package/dist/commonjs/helpers/index.d.ts

@@ -31,15 +31,10 @@ export declare const getAppVersionAndBuild: () => {
     formatted: string;
 };
 export declare const handleOpenExternalLink: (url: string) => void;
-/** Formats a timestamp as HH:MM:SS (no milliseconds). */
 export declare const formatTimeShort: (ts: number) => string;
-/** Formats a timestamp as HH:MM:SS.mmm (with milliseconds). */
 export declare const formatTime: (ts: number) => string;
-/** Formats a relative gap like "+2s" / "+1m 5s" / "+350ms". */
 export declare const formatGap: (ms: number) => string;
-/** Finds the first JSON object/array embedded anywhere in a log message. */
 export declare const getJsonContent: (message: string) => JsonContent | null;
-/** Pretty-prints JSON data showing 3-4 lines with trailing "..." */
 export declare const getJsonPreviewText: (data: any, maxLines?: number) => {
     text: string;
     hasMore: boolean;
@@ -59,9 +54,7 @@ export interface ParsedStackFrame {
     isOrigin?: boolean;
     copyableLocation: string;
 }
-/** Parses a stack trace line to extract function name, file name, extension (.tsx/.jsx/.ts), line, and column numbers */
 export declare const parseStackLine: (rawLine: string, isOrigin?: boolean) => ParsedStackFrame;
-/** Opens a file and line number directly in VS Code / system editor */
 export declare const openInVSCode: (filePath: string, lineNumber?: string | number, columnNumber?: string | number) => void;
 export declare const ANALYTICS_EVENT_PALETTE: string[];
 export declare const getEventColor: (name: string) => string;