@truewatchtech/react-native-mobile 0.4.2 → 0.4.3

package/src/rum/longTasksUtils.ts

@@ -0,0 +1,17 @@
+export const MIN_LONG_TASK_THRESHOLD_MS = 100;
+export const MAX_LONG_TASK_THRESHOLD_MS = 5000;
+export const DEFAULT_LONG_TASK_THRESHOLD_MS = 100;
+
+/**
+ * Converts the public JavaScript long task option to the numeric value expected
+ * by the native bridge. Enablement is controlled separately.
+ */
+export function normalizeLongTaskThreshold(threshold?: number): number {
+  if (!threshold) {
+    return DEFAULT_LONG_TASK_THRESHOLD_MS;
+  }
+  if (threshold < MIN_LONG_TASK_THRESHOLD_MS) {
+    return MIN_LONG_TASK_THRESHOLD_MS;
+  }
+  return Math.min(threshold, MAX_LONG_TASK_THRESHOLD_MS);
+}

package/src/specs/NativeFTMobileReactNative.ts

@@ -41,6 +41,7 @@ export interface Spec extends TurboModule {
    * @returns a Promise.
    */
   unbindRUMUserData(): Promise<void>;
+  resetVisitorId(): Promise<void>;
   /**
    * Add custom global parameters. Applies to RUM and Log data
    * @param context custom global parameters.
@@ -79,5 +80,22 @@ export interface Spec extends TurboModule {
    * Clear all data that has not yet been uploaded to the server.
    */
   clearAllData(): Promise<void>;
+  /**
+   * Update remote configuration using the configured minimum update interval.
+   */
+  updateRemoteConfig(): Promise<Object>;
+  /**
+   * Update remote configuration using a custom minimum update interval and
+   * optional override rules.
+   */
+  updateRemoteConfigWithMiniUpdateInterval(
+    interval: number,
+    rules?: Array<Object>
+  ): Promise<Object>;
+  /**
+   * Required by NativeEventEmitter for remote configuration callbacks.
+   */
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
 }
 export default TurboModuleRegistry.get<Spec>('FTMobileReactNative');

package/src/specs/NativeFTReactNativeRUM.ts

@@ -9,6 +9,10 @@ export interface Spec extends TurboModule {
    * @returns a Promise.
    */
   setConfig(config: Object): Promise<void>;
+  /** Internal synchronous snapshot used only by native JS long task reporting. */
+  setLongTaskContext(context: Object): boolean;
+  /** Stops the internal JavaScript long task monitor before SDK shutdown. */
+  stopLongTaskTracking(): Promise<void>;
   /**
    * Start RUM Action.
    * RUM will bind Resource, Error, LongTask events that may be triggered by this Action.
@@ -39,10 +43,24 @@ export interface Spec extends TurboModule {
   /**
    * view load duration.
    * @param viewName view name
-   * @param loadTime view load duration
+   * @param loadTime monotonic view load duration in nanoseconds
    * @returns a Promise.
    */
   onCreateView(viewName: string, loadTime: number): Promise<void>;
+  /** Replace the current View's loading duration; non-negative safe integer nanoseconds. */
+  updateViewLoadingTime(duration: number): Promise<void>;
+  /** Framework integration: duration in ns; epoch start in ms, converted natively. */
+  onCreateViewWithLoadStart(
+    viewName: string,
+    loadTime: number,
+    loadStartEpochMs: number
+  ): Promise<void>;
+  /** Framework integration: Manual = 0, Automatic = 1. */
+  startViewWithTrackingType(
+    viewName: string,
+    property: Object | undefined,
+    trackingType: number
+  ): Promise<void>;
   /**
    * view start.
    * @param viewName page name

package/src/specs/NativeFTReactNativeTrace.ts

@@ -22,5 +22,17 @@ export interface Spec extends TurboModule {
    * @returns trace request header parameters
    */
   getTraceHeaderFields(url: string, key?: string): Promise<Object>;
+  /**
+   * Get trace HTTP request headers synchronously for APIs whose construction
+   * cannot wait for a Promise, such as React Native WebSocket.
+   * @internal
+   */
+  getTraceHeaderFieldsSync(url: string, key: string): Object | null;
+  /**
+   * Discard iOS Trace correlation when WebSocket observation is abandoned
+   * before Resource reporting starts. Android uses native collection.
+   * @internal
+   */
+  cancelWebSocketTrace(key: string): Promise<void>;
 }
 export default TurboModuleRegistry.get<Spec>('FTReactNativeTrace');

package/src/specs/NativeFTReactNativeWebSocket.ts

@@ -0,0 +1,33 @@
+/* eslint-disable @typescript-eslint/ban-types */
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+
+/** Internal iOS handshake reporting bridge; absent on Android and older binaries. */
+export interface Spec extends TurboModule {
+  startCapture(session: string): Promise<void>;
+  stopCapture(session: string): Promise<void>;
+  clear(): Promise<void>;
+  startResource(
+    key: string,
+    socketID: number,
+    url: string,
+    session: string,
+    sequence: number,
+    property: Object
+  ): Promise<void>;
+  stopResource(
+    key: string,
+    event: string,
+    session: string,
+    property: Object
+  ): Promise<void>;
+  addResource(
+    key: string,
+    content: Object,
+    metrics: Object,
+    session: string
+  ): Promise<void>;
+  releaseResource(key: string, session: string): Promise<void>;
+}
+
+export default TurboModuleRegistry.get<Spec>('FTReactNativeWebSocket');

package/src/version.ts

@@ -1,2 +1,2 @@
 // generated by genversion
-export const version = '0.4.2';
+export const version = '0.4.3';

package/src/visitorIdConfig.ts

@@ -0,0 +1,123 @@
+/** Anonymous Visitor ID header configuration for HTTP(S), excluding WebSockets. */
+export interface FTVisitorIdConfig {
+  header: string;
+  /** Fixed lifetime in hours; defaults to 24. Access does not renew it. */
+  ttlHours?: number;
+  /** Complete HTTP(S) prefixes constrained to the same scheme, host and port. */
+  urlPrefixes?: string[];
+  /** Native regular expressions searched against the complete URL; rules use OR. */
+  regularExpressions?: string[];
+}
+
+// These restrictions are shared by the target iOS and Android native SDKs.
+const reservedHeaders = new Set([
+  'accept-charset',
+  'accept-encoding',
+  'access-control-request-headers',
+  'access-control-request-method',
+  'connection',
+  'content-length',
+  'cookie',
+  'cookie2',
+  'date',
+  'dnt',
+  'expect',
+  'host',
+  'keep-alive',
+  'origin',
+  'permissions-policy',
+  'referer',
+  'te',
+  'trailer',
+  'transfer-encoding',
+  'upgrade',
+  'via',
+  'b3',
+  'traceparent',
+  'tracestate',
+  'uber-trace-id',
+  'sw8',
+  'x-gc-trace-id',
+  'x-gc-span-id',
+  'x-rum-resource-id',
+]);
+const reservedFragments = [
+  'authorization',
+  'authentication',
+  'api-key',
+  'api_key',
+  'apikey',
+  'auth-token',
+  'auth_token',
+  'access-token',
+  'access_token',
+  'session-token',
+  'session_token',
+  'refresh-token',
+  'refresh_token',
+  'id-token',
+  'id_token',
+  'security-token',
+  'security_token',
+  'csrf',
+  'xsrf',
+  'jwt',
+  'signature',
+];
+
+export function validateVisitorIdConfig(config: FTVisitorIdConfig): void {
+  if (!config || typeof config !== 'object' || Array.isArray(config)) {
+    throw new Error('visitorIdConfig must be an object');
+  }
+  const {
+    header,
+    ttlHours = 24,
+    urlPrefixes = [],
+    regularExpressions = [],
+  } = config;
+  if (
+    typeof header !== 'string' ||
+    /[\r\n]/.test(header) ||
+    !/^[!#$%&'*+.^_`|~0-9a-z-]+$/.test(header) ||
+    reservedHeaders.has(header) ||
+    reservedFragments.some((part) => header.includes(part)) ||
+    ['proxy-', 'sec-', 'x-datadog-', 'x-b3-'].some((prefix) =>
+      header.startsWith(prefix)
+    )
+  ) {
+    throw new Error(
+      'visitorIdConfig.header must be a lowercase custom HTTP header'
+    );
+  }
+  // Android stores TTL as a signed long number of milliseconds.
+  const milliseconds = ttlHours * 3600000;
+  if (
+    typeof ttlHours !== 'number' ||
+    !Number.isFinite(ttlHours) ||
+    milliseconds < 1 ||
+    milliseconds >= 2 ** 63
+  ) {
+    throw new Error(
+      'visitorIdConfig.ttlHours must represent at least 1 millisecond and fit a signed 64-bit integer'
+    );
+  }
+  if (
+    !Array.isArray(urlPrefixes) ||
+    !Array.isArray(regularExpressions) ||
+    urlPrefixes.length + regularExpressions.length === 0
+  ) {
+    throw new Error('visitorIdConfig requires at least one URL matching rule');
+  }
+  if (
+    urlPrefixes.some(
+      (prefix) =>
+        typeof prefix !== 'string' ||
+        !/^https?:\/\/[^/?#\s]+(?:[/?#]|$)/i.test(prefix)
+    ) ||
+    regularExpressions.some(
+      (pattern) => typeof pattern !== 'string' || pattern.length === 0
+    )
+  ) {
+    throw new Error('visitorIdConfig contains an invalid URL matching rule');
+  }
+}