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

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

package/ios/RNLuciq/LuciqAPMBridge.m

@@ -90,6 +90,61 @@ RCT_EXPORT_METHOD(setScreenRenderingEnabled:(BOOL)isEnabled) {
     LCQAPM.screenRenderingEnabled = isEnabled;
 }
 
+// Syncs a custom span to the native SDK (currently logs only)
+RCT_EXPORT_METHOD(syncCustomSpan:(NSString *)name
+                  startTimestamp:(double)startTimestamp
+                  endTimestamp:(double)endTimestamp
+                  resolver:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject)
+{
+    @try {
+        // Convert microseconds → seconds (NSDate uses seconds)
+        NSTimeInterval startSeconds = startTimestamp / 1e6;
+        NSTimeInterval endSeconds   = endTimestamp / 1e6;
+
+        NSDate *startDate = [NSDate dateWithTimeIntervalSince1970:startSeconds];
+        NSDate *endDate   = [NSDate dateWithTimeIntervalSince1970:endSeconds];
+
+        // Add completed span to APM
+        [LCQAPM addCompletedCustomSpanWithName:name
+                                     startDate:startDate
+                                       endDate:endDate];
+
+        resolve(@YES);
+    }
+    @catch (NSException *exception) {
+        reject(
+            @"SYNC_CUSTOM_SPAN_ERROR",
+            exception.reason ?: @"Failed to sync custom span",
+            nil
+        );
+    }
+}
+
+// Checks if custom spans feature is enabled
+RCT_EXPORT_METHOD(isCustomSpanEnabled:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject) {
+    @try {
+        BOOL enabled = LCQAPM.customSpansEnabled;
+        resolve(@(enabled));
+    } @catch (NSException *exception) {
+        NSLog(@"[CustomSpan] Error checking feature flag: %@", exception);
+        resolve(@NO);
+    }
+}
+
+// Checks if APM is enabled
+RCT_EXPORT_METHOD(isAPMEnabled:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject) {
+    @try {
+        BOOL enabled = LCQAPM.enabled;
+        resolve(@(enabled));
+    } @catch (NSException *exception) {
+        NSLog(@"[CustomSpan] Error checking APM enabled: %@", exception);
+        resolve(@NO);
+    }
+}
+
 
 
 @synthesize description;

package/ios/RNLuciq/LuciqReactBridge.m

@@ -545,4 +545,16 @@ RCT_EXPORT_METHOD(setNetworkLogBodyEnabled:(BOOL)isEnabled) {
     LCQNetworkLogger.logBodyEnabled = isEnabled;
 }
 
+// Checks if Luciq SDK is initialized
+RCT_EXPORT_METHOD(isBuilt:(RCTPromiseResolveBlock)resolve
+                  rejecter:(RCTPromiseRejectBlock)reject) {
+    @try {
+        BOOL isBuilt = YES;
+        resolve(@(isBuilt));
+    } @catch (NSException *exception) {
+        NSLog(@"[Luciq] Error checking if SDK is built: %@", exception);
+        resolve(@NO);
+    }
+}
+
 @end

package/ios/RNLuciq/Util/LCQAPM+PrivateAPIs.h

@@ -11,5 +11,6 @@
 
 @property (class, atomic, assign) BOOL networkEnabled;
 
++ (BOOL)customSpansEnabled;
 
 @end

package/ios/native.rb

@@ -1,4 +1,4 @@
-$luciq= { :version => '19.4.1' }
+$luciq= { :version => '19.5.0' }
 
 def use_luciq! (spec = nil)
   version = $luciq[:version]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@luciq/react-native",
   "description": "Luciq is the Agentic Observability Platform built for Mobile.",
-  "version": "19.2.2",
+  "version": "19.3.0-40271-SNAPSHOT",
   "author": "Luciq (https://luciq.ai)",
   "repository": "github:luciqai/luciq-reactnative-sdk",
   "homepage": "https://www.luciq.ai/platforms/react-native",
@@ -43,7 +43,6 @@
   },
   "devDependencies": {
     "@apollo/client": "^3.7.0",
-    "@instabug/danger-plugin-coverage": "Instabug/danger-plugin-coverage",
     "@react-native-community/eslint-config": "^3.1.0",
     "@react-navigation/native": "^6.1.7",
     "@rollup/plugin-commonjs": "^25.0.3",

package/scripts/releases/changelog_to_slack_formatter.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+input=$(cat)
+
+input=$(sed -E \
+          -e 's/\[([^]]+)\]\(([^)]+)\)/<\2|\1>/g' \
+          -e 's/^#{1,6}[[:space:]]*([^[:space:]].*)$/\*\1\*/' \
+          -e 's/^- /• /' <<< "$input")
+
+echo "$input"