@luciq/react-native 19.2.1 → 19.3.0-40271-SNAPSHOT

package/dist/modules/Luciq.js

@@ -1,7 +1,7 @@
 import { AppState, findNodeHandle, Platform } from 'react-native';
 import Report from '../models/Report';
 import { emitter, NativeEvents, NativeLuciq } from '../native/NativeLuciq';
-import { registerFeatureFlagsListener } from '../utils/FeatureFlags';
+import { registerFeatureFlagsListener, initFeatureFlagsCache } from '../utils/FeatureFlags';
 import { LogLevel, NetworkInterceptionMode, ReproStepsMode, StringKey, } from '../utils/Enums';
 import LuciqUtils, { checkNetworkRequestHandlers, resetNativeObfuscationListener, setApmNetworkFlagsIfChanged, stringifyIfNotString, } from '../utils/LuciqUtils';
 import * as NetworkLogger from './NetworkLogger';
@@ -50,6 +50,7 @@ function reportCurrentViewForAndroid(screenName) {
  * @param config SDK configurations. See {@link LuciqConfig} for more info.
  */
 export const init = (config) => {
+    initFeatureFlagsCache();
     if (Platform.OS === 'android') {
         // Add android feature flags listener for android
         registerFeatureFlagsListener();

package/dist/modules/NetworkLogger.d.ts

@@ -3,11 +3,6 @@ import { NetworkData, ProgressCallback } from '../utils/XhrNetworkInterceptor';
 import { NetworkListenerType } from '../native/NativeNetworkLogger';
 export type { NetworkData };
 export type NetworkDataObfuscationHandler = (data: NetworkData) => Promise<NetworkData>;
-/**
- * Sets whether network logs should be sent with bug reports.
- * It is enabled by default.
- * @param isEnabled
- */
 export declare const setEnabled: (isEnabled: boolean) => void;
 /**
  * @internal

package/dist/modules/NetworkLogger.js

@@ -20,21 +20,25 @@ function getPortFromUrl(url) {
  * It is enabled by default.
  * @param isEnabled
  */
+const NET_TAG = 'LCQ-RN-NET:';
 export const setEnabled = (isEnabled) => {
     if (isEnabled) {
         xhr.enableInterception();
         xhr.setOnDoneCallback(async (network) => {
+            Logger.debug(NET_TAG, `[NetworkLogger] onDoneCallback received: ${network.method} ${network.url}, status=${network.responseCode}`);
             // eslint-disable-next-line no-new-func
             const predicate = Function('network', 'return ' + _requestFilterExpression);
             if (!predicate(network)) {
                 const MAX_NETWORK_BODY_SIZE_IN_BYTES = await NativeLuciq.getNetworkBodyMaxSize();
                 try {
                     if (_networkDataObfuscationHandler) {
+                        Logger.debug(NET_TAG, `[NetworkLogger] Running obfuscation handler for ${network.url}`);
                         network = await _networkDataObfuscationHandler(network);
                     }
                     if (__DEV__) {
                         const urlPort = getPortFromUrl(network.url);
                         if (urlPort === LuciqRNConfig.metroDevServerPort) {
+                            Logger.debug(NET_TAG, `[NetworkLogger] Skipping Metro dev server request: ${network.url}`);
                             return;
                         }
                     }
@@ -54,12 +58,16 @@ export const setEnabled = (isEnabled) => {
                         network.responseBody = `Body is omitted because content type ${network.contentType} isn't supported`;
                         Logger.warn(`LCQ-RN: The response body for the network request with URL ${network.url} has been omitted because the content type ${network.contentType} isn't supported.`);
                     }
+                    Logger.debug(NET_TAG, `[NetworkLogger] Reporting network log to native: ${network.method} ${network.url}`);
                     reportNetworkLog(network);
                 }
                 catch (e) {
-                    Logger.error(e);
+                    Logger.error(NET_TAG, `[NetworkLogger] Error processing network log for ${network.url}:`, e);
                 }
             }
+            else {
+                Logger.debug(NET_TAG, `[NetworkLogger] Request filtered out by predicate: ${network.method} ${network.url}, expression="${_requestFilterExpression}"`);
+            }
         });
     }
     else {

package/dist/native/NativeAPM.d.ts

@@ -14,6 +14,9 @@ export interface ApmNativeModule extends NativeModule {
     endUITrace(): void;
     lcqSleep(): void;
     setScreenRenderingEnabled(isEnabled: boolean): void;
+    syncCustomSpan(name: string, startTimestamp: number, endTimestamp: number): Promise<void>;
+    isCustomSpanEnabled(): Promise<boolean>;
+    isAPMEnabled(): Promise<boolean>;
 }
 export declare const NativeAPM: ApmNativeModule;
 export declare const emitter: NativeEventEmitter;

package/dist/native/NativeLuciq.d.ts

@@ -8,6 +8,7 @@ import type { ThemeConfig } from '../models/ThemeConfig';
 export interface LuciqNativeModule extends NativeModule {
     getConstants(): NativeConstants;
     setEnabled(isEnabled: boolean): void;
+    isBuilt(): Promise<boolean>;
     init(token: string, invocationEvents: InvocationEvent[], debugLogsLevel: LogLevel, useNativeNetworkInterception: boolean, codePushVersion?: string, appVariant?: string, options?: {
         ignoreAndroidSecureFlag?: boolean;
     }, overAirVersion?: OverAirUpdate): void;

package/dist/utils/CustomSpansManager.d.ts

@@ -0,0 +1,38 @@
+import { CustomSpan } from '../models/CustomSpan';
+/**
+ * Starts a custom span for performance tracking.
+ *
+ * A custom span measures the duration of an arbitrary operation that is not
+ * automatically tracked by the SDK. The span must be manually ended by calling
+ * the `end()` method on the returned span object.
+ *
+ * @param name - The name of the span. Cannot be empty. Max 150 characters.
+ *               Leading and trailing whitespace will be trimmed.
+ *
+ * @returns Promise<CustomSpan | null> - The span object to end later, or null if:
+ *   - Name is empty after trimming
+ *   - SDK is not initialized
+ *   - APM is disabled
+ *   - Custom spans feature is disabled
+ *   - Maximum concurrent spans limit (100) reached
+ */
+export declare const startCustomSpan: (name: string) => Promise<CustomSpan | null>;
+/**
+ * Records a completed custom span with pre-recorded timestamps.
+ *
+ * Use this method when you have already recorded the start and end times
+ * of an operation and want to report it retroactively.
+ *
+ * @param name - The name of the span. Cannot be empty. Max 150 characters.
+ *               Leading and trailing whitespace will be trimmed.
+ * @param startDate - The start time of the operation
+ * @param endDate - The end time of the operation (must be after startDate)
+ *
+ * @returns Promise<void>
+ */
+export declare const addCompletedCustomSpan: (name: string, startDate: Date, endDate: Date) => Promise<void>;
+/**
+ * Test-only helper to clear active spans between tests.
+ * @internal
+ */
+export declare const __resetCustomSpansForTests: () => void;

package/dist/utils/CustomSpansManager.js

@@ -0,0 +1,173 @@
+import { NativeAPM } from '../native/NativeAPM';
+import { NativeLuciq } from '../native/NativeLuciq';
+import { CustomSpan } from '../models/CustomSpan';
+import { LuciqStrings } from '../constants/Strings';
+/**
+ * Tracks currently active custom spans
+ * @internal
+ */
+const activeSpans = new Set();
+/**
+ * Maximum concurrent custom spans allowed at any time
+ * @internal
+ */
+const MAX_CONCURRENT_SPANS = 100;
+/**
+ * Internal: unregister a span from active tracking
+ * @internal
+ */
+const unregisterSpan = (span) => {
+    activeSpans.delete(span);
+};
+/**
+ * Internal: sync custom span data to native SDK
+ * @internal
+ */
+const syncCustomSpan = async (name, startTimestamp, endTimestamp) => {
+    // Validate inputs (safety net)
+    if (!name || name.trim().length === 0) {
+        console.error(LuciqStrings.customSpanNameEmpty);
+        return;
+    }
+    if (endTimestamp <= startTimestamp) {
+        console.error(LuciqStrings.customSpanEndTimeBeforeStartTime);
+        return;
+    }
+    // Truncate name if needed (safety net)
+    let spanName = name.trim();
+    if (spanName.length > 150) {
+        spanName = spanName.substring(0, 150);
+    }
+    await NativeAPM.syncCustomSpan(spanName, startTimestamp, endTimestamp);
+};
+/**
+ * Starts a custom span for performance tracking.
+ *
+ * A custom span measures the duration of an arbitrary operation that is not
+ * automatically tracked by the SDK. The span must be manually ended by calling
+ * the `end()` method on the returned span object.
+ *
+ * @param name - The name of the span. Cannot be empty. Max 150 characters.
+ *               Leading and trailing whitespace will be trimmed.
+ *
+ * @returns Promise<CustomSpan | null> - The span object to end later, or null if:
+ *   - Name is empty after trimming
+ *   - SDK is not initialized
+ *   - APM is disabled
+ *   - Custom spans feature is disabled
+ *   - Maximum concurrent spans limit (100) reached
+ */
+export const startCustomSpan = async (name) => {
+    try {
+        // Validate name
+        const trimmedName = name.trim();
+        if (trimmedName.length === 0) {
+            console.error(LuciqStrings.customSpanNameEmpty);
+            return null;
+        }
+        // Check SDK initialization
+        const isInitialized = await NativeLuciq.isBuilt();
+        if (!isInitialized) {
+            console.error(LuciqStrings.customSpanSDKNotInitializedMessage);
+            return null;
+        }
+        // Check APM enabled
+        const isAPMEnabled = await NativeAPM.isAPMEnabled();
+        if (!isAPMEnabled) {
+            console.log(LuciqStrings.customSpanAPMDisabledMessage);
+            return null;
+        }
+        // Check custom spans enabled
+        const isCustomSpanEnabled = await NativeAPM.isCustomSpanEnabled();
+        if (!isCustomSpanEnabled) {
+            console.log(LuciqStrings.customSpanDisabled);
+            return null;
+        }
+        // Check concurrent span limit
+        if (activeSpans.size >= MAX_CONCURRENT_SPANS) {
+            console.error(LuciqStrings.customSpanLimitReached);
+            return null;
+        }
+        // Truncate name if needed
+        let spanName = trimmedName;
+        if (spanName.length > 150) {
+            spanName = spanName.substring(0, 150);
+            console.log(LuciqStrings.customSpanNameTruncated);
+        }
+        // Create and register span with callbacks
+        const span = new CustomSpan(spanName, unregisterSpan, syncCustomSpan);
+        activeSpans.add(span);
+        return span;
+    }
+    catch (error) {
+        console.error('[CustomSpan] Error starting span:', error);
+        return null;
+    }
+};
+/**
+ * Records a completed custom span with pre-recorded timestamps.
+ *
+ * Use this method when you have already recorded the start and end times
+ * of an operation and want to report it retroactively.
+ *
+ * @param name - The name of the span. Cannot be empty. Max 150 characters.
+ *               Leading and trailing whitespace will be trimmed.
+ * @param startDate - The start time of the operation
+ * @param endDate - The end time of the operation (must be after startDate)
+ *
+ * @returns Promise<void>
+ */
+export const addCompletedCustomSpan = async (name, startDate, endDate) => {
+    try {
+        // Validate name
+        const trimmedName = name.trim();
+        if (trimmedName.length === 0) {
+            console.error(LuciqStrings.customSpanNameEmpty);
+            return;
+        }
+        // Validate timestamps
+        if (endDate <= startDate) {
+            console.error(LuciqStrings.customSpanEndTimeBeforeStartTime);
+            return;
+        }
+        // Check SDK initialization
+        const isInitialized = await NativeLuciq.isBuilt();
+        if (!isInitialized) {
+            console.error(LuciqStrings.customSpanSDKNotInitializedMessage);
+            return;
+        }
+        // Check APM enabled
+        const isAPMEnabled = await NativeAPM.isAPMEnabled();
+        if (!isAPMEnabled) {
+            console.log(LuciqStrings.customSpanAPMDisabledMessage);
+            return;
+        }
+        // Check custom spans enabled
+        const isCustomSpanEnabled = await NativeAPM.isCustomSpanEnabled();
+        if (!isCustomSpanEnabled) {
+            console.log(LuciqStrings.customSpanDisabled);
+            return;
+        }
+        // Truncate name if needed
+        let spanName = trimmedName;
+        if (spanName.length > 150) {
+            spanName = spanName.substring(0, 150);
+            console.log(LuciqStrings.customSpanNameTruncated);
+        }
+        // Convert to microseconds
+        const startMicros = startDate.getTime() * 1000;
+        const endMicros = endDate.getTime() * 1000;
+        // Send to native SDK
+        await syncCustomSpan(spanName, startMicros, endMicros);
+    }
+    catch (error) {
+        console.error('[CustomSpan] Error adding completed span:', error);
+    }
+};
+/**
+ * Test-only helper to clear active spans between tests.
+ * @internal
+ */
+export const __resetCustomSpansForTests = () => {
+    activeSpans.clear();
+};

package/dist/utils/FeatureFlags.d.ts

@@ -1,3 +1,9 @@
+export declare function initFeatureFlagsCache(): Promise<void>;
+export declare function getCachedW3cFlags(): {
+    isW3cExternalTraceIDEnabled: boolean;
+    isW3cExternalGeneratedHeaderEnabled: boolean;
+    isW3cCaughtHeaderEnabled: boolean;
+};
 export declare const FeatureFlags: {
     isW3ExternalTraceID: () => Promise<boolean>;
     isW3ExternalGeneratedHeader: () => Promise<boolean>;

package/dist/utils/FeatureFlags.js

@@ -1,5 +1,34 @@
 import { NativeLuciq } from '../native/NativeLuciq';
 import { _registerFeatureFlagsChangeListener } from '../modules/Luciq';
+import { Logger } from './logger';
+const TAG = 'LCQ-RN-NET:';
+let cachedW3cFlags = {
+    isW3cExternalTraceIDEnabled: false,
+    isW3cExternalGeneratedHeaderEnabled: false,
+    isW3cCaughtHeaderEnabled: false,
+};
+export async function initFeatureFlagsCache() {
+    Logger.debug(TAG, '[FeatureFlags] Initializing W3C feature flags cache from native bridge...');
+    try {
+        const [traceID, generatedHeader, caughtHeader] = await Promise.all([
+            NativeLuciq.isW3ExternalTraceIDEnabled(),
+            NativeLuciq.isW3ExternalGeneratedHeaderEnabled(),
+            NativeLuciq.isW3CaughtHeaderEnabled(),
+        ]);
+        cachedW3cFlags = {
+            isW3cExternalTraceIDEnabled: traceID,
+            isW3cExternalGeneratedHeaderEnabled: generatedHeader,
+            isW3cCaughtHeaderEnabled: caughtHeader,
+        };
+        Logger.debug(TAG, `[FeatureFlags] Cache initialized: traceID=${traceID}, generatedHeader=${generatedHeader}, caughtHeader=${caughtHeader}`);
+    }
+    catch (e) {
+        Logger.debug(TAG, '[FeatureFlags] Failed to initialize cache, using defaults (all false):', e);
+    }
+}
+export function getCachedW3cFlags() {
+    return cachedW3cFlags;
+}
 export const FeatureFlags = {
     isW3ExternalTraceID: () => NativeLuciq.isW3ExternalTraceIDEnabled(),
     isW3ExternalGeneratedHeader: () => NativeLuciq.isW3ExternalGeneratedHeaderEnabled(),
@@ -8,6 +37,12 @@ export const FeatureFlags = {
 };
 export const registerFeatureFlagsListener = () => {
     _registerFeatureFlagsChangeListener((res) => {
+        Logger.debug(TAG, `[FeatureFlags] Flags updated from native listener: traceID=${res.isW3ExternalTraceIDEnabled}, generatedHeader=${res.isW3ExternalGeneratedHeaderEnabled}, caughtHeader=${res.isW3CaughtHeaderEnabled}, bodyLimit=${res.networkBodyLimit}`);
+        cachedW3cFlags = {
+            isW3cExternalTraceIDEnabled: res.isW3ExternalTraceIDEnabled,
+            isW3cExternalGeneratedHeaderEnabled: res.isW3ExternalGeneratedHeaderEnabled,
+            isW3cCaughtHeaderEnabled: res.isW3CaughtHeaderEnabled,
+        };
         FeatureFlags.isW3ExternalTraceID = async () => {
             return res.isW3ExternalTraceIDEnabled;
         };

package/dist/utils/LuciqUtils.js

@@ -3,6 +3,7 @@ import parseErrorStackLib from 'react-native/Libraries/Core/Devtools/parseErrorS
 import { NativeCrashReporting } from '../native/NativeCrashReporting';
 import { NativeLuciq } from '../native/NativeLuciq';
 import { NativeAPM } from '../native/NativeAPM';
+import { Logger } from './logger';
 import * as NetworkLogger from '../modules/NetworkLogger';
 import { NativeNetworkLogger, NativeNetworkLoggerEvent, NetworkListenerType, NetworkLoggerEmitter, } from '../native/NativeNetworkLogger';
 let apmFlags = {
@@ -181,10 +182,12 @@ export const reportNetworkLog = (network) => {
     if (Platform.OS === 'android') {
         const requestHeaders = JSON.stringify(network.requestHeaders);
         const responseHeaders = JSON.stringify(network.responseHeaders);
+        Logger.debug('LCQ-RN-NET:', `[reportNetworkLog] Sending to NativeLuciq.networkLogAndroid: ${network.method} ${network.url}, status=${network.responseCode}, duration=${network.duration}ms, error=${network.errorDomain || 'none'}`);
         NativeLuciq.networkLogAndroid(network.url, network.requestBody, network.responseBody, network.method, network.responseCode, requestHeaders, responseHeaders, network.duration);
         if (!apmFlags.isNativeInterceptionFeatureEnabled ||
             !apmFlags.hasAPMNetworkPlugin ||
             !apmFlags.shouldEnableNativeInterception) {
+            Logger.debug('LCQ-RN-NET:', `[reportNetworkLog] Also sending to NativeAPM.networkLogAndroid (native interception disabled): ${network.method} ${network.url}`);
             NativeAPM.networkLogAndroid(network.startTime, network.duration, requestHeaders, network.requestBody, network.requestBodySize, network.method, network.url, network.requestContentType, responseHeaders, network.responseBody, network.responseBodySize, network.responseCode, network.contentType, network.errorDomain, {
                 isW3cHeaderFound: network.isW3cHeaderFound,
                 partialId: network.partialId,
@@ -193,6 +196,9 @@ export const reportNetworkLog = (network) => {
                 w3cCaughtHeader: network.w3cCaughtHeader,
             }, network.gqlQueryName, network.serverErrorMessage);
         }
+        else {
+            Logger.debug('LCQ-RN-NET:', `[reportNetworkLog] Skipping NativeAPM.networkLogAndroid (native interception enabled): nativeFeature=${apmFlags.isNativeInterceptionFeatureEnabled}, hasPlugin=${apmFlags.hasAPMNetworkPlugin}, shouldEnable=${apmFlags.shouldEnableNativeInterception}`);
+        }
     }
     else {
         NativeLuciq.networkLogIOS(network.url, network.method, network.requestBody, network.requestBodySize, network.responseBody, network.responseBodySize, network.responseCode, network.requestHeaders, network.responseHeaders, network.contentType, network.errorDomain, network.errorCode, network.startTime, network.duration, network.gqlQueryName, network.serverErrorMessage, {

package/dist/utils/XhrNetworkInterceptor.js

@@ -1,6 +1,8 @@
 import LuciqConstants from './LuciqConstants';
 import { stringifyIfNotString, generateW3CHeader } from './LuciqUtils';
-import { FeatureFlags } from '../utils/FeatureFlags';
+import { getCachedW3cFlags } from './FeatureFlags';
+import { Logger } from './logger';
+const TAG = 'LCQ-RN-NET:';
 const XMLHttpRequest = global.XMLHttpRequest;
 let originalXHROpen = XMLHttpRequest.prototype.open;
 let originalXHRSend = XMLHttpRequest.prototype.send;
@@ -8,40 +10,34 @@ let originalXHRSetRequestHeader = XMLHttpRequest.prototype.setRequestHeader;
 let onProgressCallback;
 let onDoneCallback;
 let isInterceptorEnabled = false;
-let network;
-const _reset = () => {
-    network = {
-        id: '',
-        url: '',
-        method: '',
-        requestBody: '',
-        requestBodySize: 0,
-        responseBody: '',
-        responseBodySize: 0,
-        responseCode: 0,
-        requestHeaders: {},
-        responseHeaders: {},
-        contentType: '',
-        errorDomain: '',
-        errorCode: 0,
-        startTime: 0,
-        duration: 0,
-        gqlQueryName: '',
-        serverErrorMessage: '',
-        requestContentType: '',
-        isW3cHeaderFound: null,
-        partialId: null,
-        networkStartTimeInSeconds: null,
-        w3cGeneratedHeader: null,
-        w3cCaughtHeader: null,
-    };
-};
-const getTraceparentHeader = async (networkData) => {
-    const [isW3cExternalTraceIDEnabled, isW3cExternalGeneratedHeaderEnabled, isW3cCaughtHeaderEnabled,] = await Promise.all([
-        FeatureFlags.isW3ExternalTraceID(),
-        FeatureFlags.isW3ExternalGeneratedHeader(),
-        FeatureFlags.isW3CaughtHeader(),
-    ]);
+const networkMap = new WeakMap();
+const createNetworkData = () => ({
+    id: '',
+    url: '',
+    method: '',
+    requestBody: '',
+    requestBodySize: 0,
+    responseBody: '',
+    responseBodySize: 0,
+    responseCode: 0,
+    requestHeaders: {},
+    responseHeaders: {},
+    contentType: '',
+    errorDomain: '',
+    errorCode: 0,
+    startTime: 0,
+    duration: 0,
+    gqlQueryName: '',
+    serverErrorMessage: '',
+    requestContentType: '',
+    isW3cHeaderFound: null,
+    partialId: null,
+    networkStartTimeInSeconds: null,
+    w3cGeneratedHeader: null,
+    w3cCaughtHeader: null,
+});
+const getTraceparentHeader = (networkData) => {
+    const { isW3cExternalTraceIDEnabled, isW3cExternalGeneratedHeaderEnabled, isW3cCaughtHeaderEnabled, } = getCachedW3cFlags();
     return injectHeaders(networkData, {
         isW3cExternalTraceIDEnabled,
         isW3cExternalGeneratedHeaderEnabled,
@@ -85,39 +81,57 @@ export default {
         onProgressCallback = callback;
     },
     enableInterception() {
-        // Prevents infinite calls to XMLHttpRequest.open when enabling interception multiple times
         if (isInterceptorEnabled) {
+            Logger.debug(TAG, 'enableInterception called but already enabled, skipping');
             return;
         }
+        Logger.debug(TAG, 'Enabling XHR network interception');
         originalXHROpen = XMLHttpRequest.prototype.open;
         originalXHRSend = XMLHttpRequest.prototype.send;
         originalXHRSetRequestHeader = XMLHttpRequest.prototype.setRequestHeader;
         // An error code that signifies an issue with the RN client.
         const clientErrorCode = 9876;
         XMLHttpRequest.prototype.open = function (method, url, ...args) {
-            _reset();
-            network.url = url;
-            network.method = method;
+            const networkData = createNetworkData();
+            networkData.url = url;
+            networkData.method = method;
+            networkMap.set(this, networkData);
+            Logger.debug(TAG, `[open] ${method} ${url}`);
             originalXHROpen.apply(this, [method, url, ...args]);
         };
         XMLHttpRequest.prototype.setRequestHeader = function (header, value) {
-            // According to the HTTP RFC, headers are case-insensitive, so we convert
-            // them to lower-case to make accessing headers predictable.
-            // This avoid issues like failing to get the Content-Type header for a request
-            // because the header is set as 'Content-Type' instead of 'content-type'.
             const key = header.toLowerCase();
-            network.requestHeaders[key] = stringifyIfNotString(value);
+            const networkData = networkMap.get(this);
+            if (networkData) {
+                networkData.requestHeaders[key] = stringifyIfNotString(value);
+            }
+            else {
+                Logger.debug(TAG, `[setRequestHeader] No networkData found in WeakMap for header "${key}" — request may have been GC'd or open() was not called`);
+            }
             originalXHRSetRequestHeader.apply(this, [header, value]);
         };
-        XMLHttpRequest.prototype.send = async function (data) {
-            const cloneNetwork = JSON.parse(JSON.stringify(network));
+        XMLHttpRequest.prototype.send = function (data) {
+            const networkData = networkMap.get(this);
+            if (!networkData) {
+                Logger.debug(TAG, '[send] No networkData found in WeakMap — falling back to original send (open() was not intercepted)');
+                originalXHRSend.apply(this, [data]);
+                return;
+            }
+            Logger.debug(TAG, `[send] ${networkData.method} ${networkData.url}`);
+            const cloneNetwork = JSON.parse(JSON.stringify(networkData));
             cloneNetwork.requestBody = data ? data : '';
             if (typeof cloneNetwork.requestBody !== 'string') {
                 cloneNetwork.requestBody = JSON.stringify(cloneNetwork.requestBody);
             }
+            let isReported = false;
             if (this.addEventListener) {
                 this.addEventListener('readystatechange', async () => {
                     if (!isInterceptorEnabled) {
+                        Logger.debug(TAG, `[readystatechange] Interceptor disabled, ignoring state=${this.readyState} for ${cloneNetwork.url}`);
+                        return;
+                    }
+                    if (isReported) {
+                        Logger.debug(TAG, `[readystatechange] Already reported, ignoring state=${this.readyState} for ${cloneNetwork.url}`);
                         return;
                     }
                     if (this.readyState === this.HEADERS_RECEIVED) {
@@ -146,6 +160,7 @@ export default {
                             cloneNetwork.requestContentType =
                                 cloneNetwork.requestHeaders['content-type'].split(';')[0];
                         }
+                        Logger.debug(TAG, `[readystatechange] HEADERS_RECEIVED for ${cloneNetwork.url}, contentType=${cloneNetwork.contentType}`);
                     }
                     if (this.readyState === this.DONE) {
                         cloneNetwork.duration = Date.now() - cloneNetwork.startTime;
@@ -166,11 +181,11 @@ export default {
                             cloneNetwork.requestBody =
                                 typeof _response === 'string' ? _response : JSON.stringify(_response);
                             cloneNetwork.responseBody = '';
-                            // Detect a more descriptive error message.
                             if (typeof _response === 'string' && _response.length > 0) {
                                 cloneNetwork.errorDomain = _response;
                             }
                             cloneNetwork.responseBody = `ERROR: ${cloneNetwork.errorDomain}`;
+                            Logger.debug(TAG, `[readystatechange] DONE with client error for ${cloneNetwork.url}, errorDomain=${cloneNetwork.errorDomain}`);
                             // @ts-ignore
                         }
                         else if (this._timedOut) {
@@ -179,6 +194,7 @@ export default {
                             cloneNetwork.responseCode = 0;
                             cloneNetwork.contentType = 'text/plain';
                             cloneNetwork.responseBody = `ERROR: ${cloneNetwork.errorDomain}`;
+                            Logger.debug(TAG, `[readystatechange] DONE with timeout for ${cloneNetwork.url}`);
                         }
                         // Only set response body if not already set by error handlers
                         if (!cloneNetwork.errorDomain) {
@@ -225,16 +241,20 @@ export default {
                         else {
                             delete cloneNetwork.gqlQueryName;
                         }
+                        isReported = true;
+                        Logger.debug(TAG, `[readystatechange] DONE for ${cloneNetwork.method} ${cloneNetwork.url} — status=${cloneNetwork.responseCode}, duration=${cloneNetwork.duration}ms, hasCallback=${!!onDoneCallback}`);
                         if (onDoneCallback) {
                             onDoneCallback(cloneNetwork);
                         }
+                        else {
+                            Logger.debug(TAG, `[readystatechange] WARNING: onDoneCallback is null, network log for ${cloneNetwork.url} will be LOST`);
+                        }
                     }
                 });
                 const downloadUploadProgressCallback = (event) => {
                     if (!isInterceptorEnabled) {
                         return;
                     }
-                    // check if will be able to compute progress
                     if (event.lengthComputable && onProgressCallback) {
                         const totalBytesSent = event.loaded;
                         const totalBytesExpectedToSend = event.total - event.loaded;
@@ -243,31 +263,43 @@ export default {
                 };
                 this.addEventListener('progress', downloadUploadProgressCallback);
                 this.upload.addEventListener('progress', downloadUploadProgressCallback);
-                // Handler for abort events (works with fetch, Axios, and any XHR-based requests)
                 this.addEventListener('abort', () => {
                     if (!isInterceptorEnabled) {
+                        Logger.debug(TAG, `[abort] Interceptor disabled, ignoring abort for ${cloneNetwork.url}`);
+                        return;
+                    }
+                    if (isReported) {
+                        Logger.debug(TAG, `[abort] Already reported via readystatechange DONE, ignoring duplicate abort for ${cloneNetwork.url}`);
                         return;
                     }
+                    isReported = true;
                     cloneNetwork.duration = Date.now() - cloneNetwork.startTime;
                     cloneNetwork.responseCode = 0;
                     cloneNetwork.errorCode = clientErrorCode;
                     cloneNetwork.errorDomain = 'cancelled';
                     cloneNetwork.responseBody = `ERROR: ${cloneNetwork.errorDomain}`;
+                    Logger.debug(TAG, `[abort] Request cancelled: ${cloneNetwork.method} ${cloneNetwork.url}, duration=${cloneNetwork.duration}ms, hasCallback=${!!onDoneCallback}`);
+                    if (onDoneCallback) {
+                        onDoneCallback(cloneNetwork);
+                    }
+                    else {
+                        Logger.debug(TAG, `[abort] WARNING: onDoneCallback is null, cancelled log for ${cloneNetwork.url} will be LOST`);
+                    }
                 });
             }
             cloneNetwork.startTime = Date.now();
-            const traceparent = await getTraceparentHeader(cloneNetwork);
+            const traceparent = getTraceparentHeader(cloneNetwork);
             if (traceparent) {
                 this.setRequestHeader('Traceparent', traceparent);
-            }
-            if (this.readyState === this.UNSENT) {
-                return; // Prevent sending the request if not opened
+                Logger.debug(TAG, `[send] Injected traceparent header for ${cloneNetwork.url}`);
             }
             originalXHRSend.apply(this, [data]);
         };
         isInterceptorEnabled = true;
+        Logger.debug(TAG, 'XHR network interception enabled');
     },
     disableInterception() {
+        Logger.debug(TAG, 'Disabling XHR network interception');
         isInterceptorEnabled = false;
         XMLHttpRequest.prototype.send = originalXHRSend;
         XMLHttpRequest.prototype.open = originalXHROpen;

package/ios/RNLuciq/LuciqAPMBridge.h

@@ -23,4 +23,17 @@
 
 - (void)setScreenRenderingEnabled:(BOOL)isEnabled;
 
+// Custom Span methods
+- (void)syncCustomSpan:(NSString *)name
+        startTimestamp:(double)startTimestamp
+          endTimestamp:(double)endTimestamp
+              resolver:(RCTPromiseResolveBlock)resolve
+              rejecter:(RCTPromiseRejectBlock)reject;
+
+- (void)isCustomSpanEnabled:(RCTPromiseResolveBlock)resolve
+                   rejecter:(RCTPromiseRejectBlock)reject;
+
+- (void)isAPMEnabled:(RCTPromiseResolveBlock)resolve
+            rejecter:(RCTPromiseRejectBlock)reject;
+
 @end