@dreamhorizonorg/pulse-react-native 0.0.3 → 0.0.4

package/src/config.ts

@@ -1,11 +1,15 @@
-import { setupErrorHandler } from './errorHandler';
+import { setupErrorHandler, uninstallErrorHandler } from './errorHandler';
 import { isSupportedPlatform } from './initialization';
 import {
   createReactNavigationIntegration,
+  uninstallNavigationIntegration,
   type ReactNavigationIntegration,
   type NavigationIntegrationOptions,
 } from './navigation';
-import { initializeNetworkInterceptor } from './network-interceptor/initialization';
+import {
+  initializeNetworkInterceptor,
+  uninstallNetworkInterceptor,
+} from './network-interceptor/initialization';
 import PulseReactNativeOtel from './NativePulseReactNativeOtel';
 import type { PulseFeatureConfig } from './pulse.interface';
 import { PULSE_FEATURE_NAMES } from './pulse.constants';
@@ -34,12 +38,27 @@ const defaultConfig: Required<PulseConfig> = {
 
 let currentConfig: PulseConfig = { ...defaultConfig };
 
+/** After shutdown, start() and initialize are no-ops; re-initialization is not supported. */
+let isShutdown = false;
+
+/** True only after start() has been called at least once. Integrations (e.g. navigation) are no-ops until then. */
+let isStarted = false;
+
 // Cache for features from remote SDK config
 let cachedFeatures: PulseFeatureConfig;
 
+export function getIsShutdown(): boolean {
+  return isShutdown;
+}
+
+/** True only after start() has been called at least once. Public APIs (trackEvent, reportException, startSpan, etc.) no-op until then. */
+export function getIsStarted(): boolean {
+  return isStarted;
+}
+
 /**
  * Gets all features from the remote SDK config.
- * @returns Record of feature names to their enabled status, or null if config not available
+ * @returns Record of feature names to their enabled status, or null if config not available or start() not called
  */
 export function getFeaturesFromRemoteConfig(): PulseFeatureConfig {
   if (cachedFeatures !== undefined) {
@@ -93,7 +112,14 @@ function resolveNavigationState(
 
 export function start(options?: PulseConfig): void {
   if (!isSupportedPlatform()) return;
+  if (isShutdown) {
+    console.log(
+      '[Pulse] SDK has been shut down. Pulse.start() is a no-op; re-initialization is not supported.'
+    );
+    return;
+  }
 
+  isStarted = true;
   const features = getFeaturesFromRemoteConfig();
   const config: PulseConfig = {
     autoDetectExceptions: resolveFeatureState(
@@ -119,6 +145,18 @@ export function start(options?: PulseConfig): void {
   configure(config);
 }
 
+export function shutdown(): void {
+  if (isShutdown) {
+    console.warn('[Pulse] SDK already shut down.');
+    return;
+  }
+  uninstallErrorHandler();
+  uninstallNetworkInterceptor();
+  uninstallNavigationIntegration();
+  PulseReactNativeOtel.shutdown();
+  isShutdown = true;
+}
+
 export function createNavigationIntegrationWithConfig(
   options?: NavigationIntegrationOptions
 ): ReactNavigationIntegration {
@@ -128,6 +166,18 @@ export function createNavigationIntegrationWithConfig(
       markContentReady: () => {},
     };
   }
+  if (!isStarted) {
+    return {
+      registerNavigationContainer: (_: unknown) => () => {},
+      markContentReady: () => {},
+    };
+  }
+  if (isShutdown) {
+    return {
+      registerNavigationContainer: (_: unknown) => () => {},
+      markContentReady: () => {},
+    };
+  }
   if (!currentConfig.autoDetectNavigation) {
     console.warn(
       '[Pulse Navigation] auto-detection disabled via Pulse.start; createNavigationIntegration() returning no-op.'

package/src/errorBoundary.tsx

@@ -1,5 +1,6 @@
 import * as React from 'react';
 import { Pulse } from './index';
+import { getIsShutdown } from './config';
 
 export const UNKNOWN_COMPONENT = 'unknown';
 const COMPONENT_STACK_UNAVAILABLE = '<component stack unavailable>';
@@ -46,7 +47,9 @@ export class ErrorBoundary extends React.Component<
 
     const errorToReport =
       error instanceof Error ? error : new Error(String(error));
-    Pulse.reportException(errorToReport, !handled);
+    if (!getIsShutdown()) {
+      Pulse.reportException(errorToReport, !handled);
+    }
 
     if (onError) {
       onError(error, componentStack);

package/src/errorHandler.ts

@@ -1,4 +1,5 @@
 import PulseReactNativeOtel from './NativePulseReactNativeOtel';
+import { getIsShutdown, getIsStarted } from './config';
 import { mergeWithGlobalAttributes } from './globalAttributes';
 import { isSupportedPlatform } from './initialization';
 import { extractErrorDetails } from './utility';
@@ -68,7 +69,7 @@ export function reportException(
   isFatal: boolean = false,
   attributes?: PulseAttributes
 ): void {
-  if (!isSupportedPlatform()) {
+  if (!isSupportedPlatform() || !getIsStarted() || getIsShutdown()) {
     return;
   }
 
@@ -160,6 +161,10 @@ function disableErrorHandler(): void {
   handlingFatal = false;
 }
 
+export function uninstallErrorHandler(): void {
+  disableErrorHandler();
+}
+
 export function setupErrorHandler(enableErrorHandler: boolean): void {
   if (enableErrorHandler) {
     initializeErrorHandler();

package/src/events.ts

@@ -1,11 +1,15 @@
 import PulseReactNativeOtel from './NativePulseReactNativeOtel';
-import { getFeaturesFromRemoteConfig } from './config';
+import {
+  getFeaturesFromRemoteConfig,
+  getIsShutdown,
+  getIsStarted,
+} from './config';
 import { mergeWithGlobalAttributes } from './globalAttributes';
 import { isSupportedPlatform } from './initialization';
 import type { PulseAttributes } from './pulse.interface';
 
 export function trackEvent(event: string, attributes?: PulseAttributes): void {
-  if (!isSupportedPlatform()) {
+  if (!isSupportedPlatform() || !getIsStarted() || getIsShutdown()) {
     return;
   }
   const features = getFeaturesFromRemoteConfig();

package/src/index.tsx

@@ -1,7 +1,7 @@
 import { startSpan, trackSpan } from './trace';
 import { reportException } from './errorHandler';
 import { trackEvent } from './events';
-import { start } from './config';
+import { start, shutdown } from './config';
 import { isInitialized } from './initialization';
 import { setGlobalAttribute } from './globalAttributes';
 import { setUserId, setUserProperty, setUserProperties } from './user';
@@ -22,6 +22,7 @@ export type { ErrorBoundaryProps, FallbackRender } from './errorBoundary';
 export { SpanStatusCode } from './trace';
 export const Pulse = {
   start,
+  shutdown,
   isInitialized,
   useNavigationTracking,
   markContentReady,

package/src/navigation/index.ts

@@ -37,6 +37,15 @@ import {
 export type { NavigationRoute, NavigationIntegrationOptions };
 export { DEFAULT_NAVIGATION_OPTIONS } from './navigation.interface';
 
+let currentNavigationUnregister: (() => void) | null = null;
+
+export function uninstallNavigationIntegration(): void {
+  if (currentNavigationUnregister) {
+    currentNavigationUnregister();
+    currentNavigationUnregister = null;
+  }
+}
+
 export interface ReactNavigationIntegration {
   registerNavigationContainer: (
     maybeNavigationContainer: unknown
@@ -270,6 +279,9 @@ export function createReactNavigationIntegration(
           }
           navigationContainer = undefined;
           isInitialized = false;
+          if (currentNavigationUnregister === unmountCleanup) {
+            currentNavigationUnregister = null;
+          }
 
           clearGlobalMarkContentReady(
             updatedInteractiveTracker.markContentReady
@@ -304,6 +316,7 @@ export function createReactNavigationIntegration(
       );
       isInitialized = true;
 
+      currentNavigationUnregister = unmountCleanup;
       return unmountCleanup;
     } catch (error) {
       console.error(

package/src/navigation/screen-interactive.ts

@@ -1,4 +1,5 @@
 import { Pulse, type Span } from '../index';
+import { getIsStarted } from '../config';
 import { Platform } from 'react-native';
 import { SPAN_NAMES, ATTRIBUTE_KEYS, PULSE_TYPES } from '../pulse.constants';
 import { discardSpan } from '../trace';
@@ -131,6 +132,9 @@ export function createScreenInteractiveTracker(
 }
 
 export function markContentReady(): void {
+  if (!getIsStarted()) {
+    return;
+  }
   if (globalMarkContentReady) {
     globalMarkContentReady();
   } else {

package/src/network-interceptor/initialization.ts

@@ -4,6 +4,7 @@ import type { NetworkHeaderConfig } from '../config';
 export { normalizeHeaderName, shouldCaptureHeader } from './header-helper';
 
 let isInitialized = false;
+let uninstallXmlHttpRequestTracker: (() => void) | null = null;
 let headerConfig: NetworkHeaderConfig = {
   requestHeaders: [],
   responseHeaders: [],
@@ -35,7 +36,8 @@ export function initializeNetworkInterceptor(
     // In react-native, we are intercepting XMLHttpRequest only, since axios and fetch both use it internally.
     // See: https://github.com/facebook/react-native/blob/main/packages/react-native/Libraries/Network/fetch.js
     if (typeof XMLHttpRequest !== 'undefined') {
-      createXmlHttpRequestTracker(XMLHttpRequest);
+      const result = createXmlHttpRequestTracker(XMLHttpRequest);
+      uninstallXmlHttpRequestTracker = result.uninstall;
     } else {
       console.warn('[Pulse] XMLHttpRequest is not available');
     }
@@ -47,3 +49,14 @@ export function initializeNetworkInterceptor(
 }
 
 export const isNetworkInterceptorInitialized = (): boolean => isInitialized;
+
+export function uninstallNetworkInterceptor(): void {
+  if (!isInitialized) {
+    return;
+  }
+  if (uninstallXmlHttpRequestTracker) {
+    uninstallXmlHttpRequestTracker();
+    uninstallXmlHttpRequestTracker = null;
+  }
+  isInitialized = false;
+}

package/src/network-interceptor/request-tracker-xhr.ts

@@ -18,12 +18,17 @@ type ReadyStateChangeHandler = (this: XMLHttpRequest, ev: Event) => any;
 
 let isXHRIntercepted = false;
 
+export interface XmlHttpRequestTrackerResult {
+  requestTracker: RequestTracker;
+  uninstall: () => void;
+}
+
 function createXmlHttpRequestTracker(
   xhr: typeof XMLHttpRequest
-): RequestTracker {
+): XmlHttpRequestTrackerResult {
   if (isXHRIntercepted) {
     console.warn('[Pulse] XMLHttpRequest already intercepted');
-    return new RequestTracker();
+    return { requestTracker: new RequestTracker(), uninstall: () => {} };
   }
 
   const requestTracker = new RequestTracker();
@@ -192,7 +197,15 @@ function createXmlHttpRequestTracker(
     originalSend.call(this, body);
   };
 
-  return requestTracker;
+  const uninstall = (): void => {
+    if (!isXHRIntercepted) return;
+    xhr.prototype.open = originalOpen;
+    xhr.prototype.setRequestHeader = originalSetRequestHeader;
+    xhr.prototype.send = originalSend;
+    isXHRIntercepted = false;
+  };
+
+  return { requestTracker, uninstall };
 }
 
 export default createXmlHttpRequestTracker;

package/src/trace.ts

@@ -1,9 +1,18 @@
 import PulseReactNativeOtel from './NativePulseReactNativeOtel';
+import { getIsShutdown, getIsStarted } from './config';
 import { isSupportedPlatform } from './initialization';
 import { mergeWithGlobalAttributes } from './globalAttributes';
 import { extractErrorDetails } from './utility';
 import type { PulseAttributes } from './pulse.interface';
 
+const noopSpan: Span = {
+  end: (_statusCode?: SpanStatusCode) => {},
+  addEvent: (_eventName: string, _eventAttributes?: PulseAttributes) => {},
+  setAttributes: (_attributes?: PulseAttributes) => {},
+  recordException: (_error: Error, _attributes?: PulseAttributes) => {},
+  spanId: undefined,
+};
+
 /**
  * Options for starting a span.
  * @param attributes - Attributes to set on the span.
@@ -30,14 +39,8 @@ export type Span = {
 };
 
 export function startSpan(name: string, options?: SpanOptions): Span {
-  if (!isSupportedPlatform()) {
-    return {
-      end: (_statusCode?: SpanStatusCode) => {},
-      addEvent: (_eventName: string, _eventAttributes?: PulseAttributes) => {},
-      setAttributes: (_attributes?: PulseAttributes) => {},
-      recordException: (_error: Error, _attributes?: PulseAttributes) => {},
-      spanId: undefined,
-    };
+  if (!isSupportedPlatform() || !getIsStarted() || getIsShutdown()) {
+    return noopSpan;
   }
 
   const mergedAttributes = mergeWithGlobalAttributes(options?.attributes || {});
@@ -69,7 +72,7 @@ export function trackSpan<T>(
   options: SpanOptions,
   fn: () => T | Promise<T>
 ): T | Promise<T> {
-  if (!isSupportedPlatform()) {
+  if (!isSupportedPlatform() || !getIsStarted() || getIsShutdown()) {
     return fn();
   }
 
@@ -94,11 +97,12 @@ export function trackSpan<T>(
 }
 
 function endSpan(spanId: string, statusCode?: SpanStatusCode): void {
+  if (getIsShutdown()) return;
   PulseReactNativeOtel.endSpan(spanId, statusCode);
 }
 
 export function discardSpan(spanId: string): void {
-  if (!isSupportedPlatform()) {
+  if (!isSupportedPlatform() || !getIsStarted() || getIsShutdown()) {
     return;
   }
   PulseReactNativeOtel.discardSpan(spanId);
@@ -109,14 +113,17 @@ function addSpanEvent(
   name: string,
   attributes?: PulseAttributes
 ): void {
+  if (getIsShutdown()) return;
   PulseReactNativeOtel.addSpanEvent(spanId, name, attributes || undefined);
 }
 
 function setSpanAttributes(spanId: string, attributes?: PulseAttributes): void {
+  if (getIsShutdown()) return;
   PulseReactNativeOtel.setSpanAttributes(spanId, attributes || undefined);
 }
 
 function recordSpanException(error: Error, attributes?: PulseAttributes): void {
+  if (getIsShutdown()) return;
   const { message, stackTrace, errorType } = extractErrorDetails(error);
   const observedTimeMs = Date.now();
   const mergedAttributes = mergeWithGlobalAttributes(attributes || {});

package/src/user.ts

@@ -1,23 +1,24 @@
 import PulseReactNativeOtel from './NativePulseReactNativeOtel';
+import { getIsShutdown } from './config';
 import { isSupportedPlatform } from './initialization';
 import type { PulseAttributes } from './pulse.interface';
 
 export function setUserId(id: string | null): void {
-  if (!isSupportedPlatform()) {
+  if (!isSupportedPlatform() || getIsShutdown()) {
     return;
   }
   PulseReactNativeOtel.setUserId(id);
 }
 
 export function setUserProperty(name: string, value: string | null): void {
-  if (!isSupportedPlatform()) {
+  if (!isSupportedPlatform() || getIsShutdown()) {
     return;
   }
   PulseReactNativeOtel.setUserProperty(name, value);
 }
 
 export function setUserProperties(properties: PulseAttributes): void {
-  if (!isSupportedPlatform()) {
+  if (!isSupportedPlatform() || getIsShutdown()) {
     return;
   }
   PulseReactNativeOtel.setUserProperties(properties);