@truewatchtech/react-native-mobile 0.4.1 → 0.4.3-alpha.2

package/lib/module/specs/NativeFTReactNativeRUM.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","get"],"sources":["NativeFTReactNativeRUM.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/ban-types */\nimport type { TurboModule } from 'react-native';\nimport { TurboModuleRegistry } from 'react-native';\n\nexport interface Spec extends TurboModule {\n  /**\n   * Set RUM tracking conditions and enable RUM collection.\n   * @param config rum configuration parameters.\n   * @returns a Promise.\n   */\n  setConfig(config: Object): Promise<void>;\n  /**\n   * Start RUM Action.\n   * RUM will bind Resource, Error, LongTask events that may be triggered by this Action.\n   * Avoid adding multiple times within 0.1s, only one Action will be associated with the same View at the same time, and new Actions will be discarded if the previous one has not ended.\n   * Adding Action with `addAction` method does not affect each other.\n   * @param actionName action name\n   * @param actionType action type\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  startAction(\n    actionName: string,\n    actionType: string,\n    property?: Object\n  ): Promise<void>;\n  /**\n   * Add Action event. This type of data cannot be associated with Error, Resource, LongTask data, and has no discard logic.\n   * @param actionName action name\n   * @param actionType action type\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  addAction(\n    actionName: string,\n    actionType: string,\n    property?: Object\n  ): Promise<void>;\n  /**\n   * view load duration.\n   * @param viewName view name\n   * @param loadTime view load duration\n   * @returns a Promise.\n   */\n  onCreateView(viewName: string, loadTime: number): Promise<void>;\n  /**\n   * view start.\n   * @param viewName page name\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  startView(viewName: string, property?: Object): Promise<void>;\n  /**\n   * view end.\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  stopView(property?: Object): Promise<void>;\n  /**\n   * Exception capture and log collection.\n   * @param stack stack log\n   * @param message error message\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  addError(stack: string, message: string, property?: Object): Promise<void>;\n  /**\n   * Exception capture and log collection.\n   * @param type error type\n   * @param stack stack log\n   * @param message error message\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  addErrorWithType(\n    type: string,\n    stack: string,\n    message: string,\n    property?: Object\n  ): Promise<void>;\n  /**\n   * Start resource request.\n   * @param key unique id\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  startResource(key: string, property?: Object): Promise<void>;\n  /**\n   * End resource request.\n   * @param key unique id\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  stopResource(key: string, property?: Object): Promise<void>;\n  /**\n   * Send resource data metrics.\n   * @param key unique id\n   * @param resource resource data\n   * @param metrics resource performance data\n   * @returns a Promise.\n   */\n  addResource(key: string, resource: Object, metrics?: Object): Promise<void>;\n}\nexport default TurboModuleRegistry.get<Spec>('FTReactNativeRUM');\n"],"mappings":"AAAA;;AAEA,SAASA,mBAAmB,QAAQ,cAAc;AAqGlD,eAAeA,mBAAmB,CAACC,GAAG,CAAO,kBAAkB,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","get"],"sources":["NativeFTReactNativeRUM.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/ban-types */\nimport type { TurboModule } from 'react-native';\nimport { TurboModuleRegistry } from 'react-native';\n\nexport interface Spec extends TurboModule {\n  /**\n   * Set RUM tracking conditions and enable RUM collection.\n   * @param config rum configuration parameters.\n   * @returns a Promise.\n   */\n  setConfig(config: Object): Promise<void>;\n  /** Internal synchronous snapshot used only by native JS long task reporting. */\n  setLongTaskContext(context: Object): boolean;\n  /** Stops the internal JavaScript long task monitor before SDK shutdown. */\n  stopLongTaskTracking(): Promise<void>;\n  /**\n   * Start RUM Action.\n   * RUM will bind Resource, Error, LongTask events that may be triggered by this Action.\n   * Avoid adding multiple times within 0.1s, only one Action will be associated with the same View at the same time, and new Actions will be discarded if the previous one has not ended.\n   * Adding Action with `addAction` method does not affect each other.\n   * @param actionName action name\n   * @param actionType action type\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  startAction(\n    actionName: string,\n    actionType: string,\n    property?: Object\n  ): Promise<void>;\n  /**\n   * Add Action event. This type of data cannot be associated with Error, Resource, LongTask data, and has no discard logic.\n   * @param actionName action name\n   * @param actionType action type\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  addAction(\n    actionName: string,\n    actionType: string,\n    property?: Object\n  ): Promise<void>;\n  /**\n   * view load duration.\n   * @param viewName view name\n   * @param loadTime view load duration\n   * @returns a Promise.\n   */\n  onCreateView(viewName: string, loadTime: number): Promise<void>;\n  /**\n   * view start.\n   * @param viewName page name\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  startView(viewName: string, property?: Object): Promise<void>;\n  /**\n   * view end.\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  stopView(property?: Object): Promise<void>;\n  /**\n   * Exception capture and log collection.\n   * @param stack stack log\n   * @param message error message\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  addError(stack: string, message: string, property?: Object): Promise<void>;\n  /**\n   * Exception capture and log collection.\n   * @param type error type\n   * @param stack stack log\n   * @param message error message\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  addErrorWithType(\n    type: string,\n    stack: string,\n    message: string,\n    property?: Object\n  ): Promise<void>;\n  /**\n   * Start resource request.\n   * @param key unique id\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  startResource(key: string, property?: Object): Promise<void>;\n  /**\n   * End resource request.\n   * @param key unique id\n   * @param property event context (optional)\n   * @returns a Promise.\n   */\n  stopResource(key: string, property?: Object): Promise<void>;\n  /**\n   * Send resource data metrics.\n   * @param key unique id\n   * @param resource resource data\n   * @param metrics resource performance data\n   * @returns a Promise.\n   */\n  addResource(key: string, resource: Object, metrics?: Object): Promise<void>;\n}\nexport default TurboModuleRegistry.get<Spec>('FTReactNativeRUM');\n"],"mappings":"AAAA;;AAEA,SAASA,mBAAmB,QAAQ,cAAc;AAyGlD,eAAeA,mBAAmB,CAACC,GAAG,CAAO,kBAAkB,CAAC","ignoreList":[]}

package/lib/module/specs/NativeFTReactNativeTrace.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","get"],"sources":["NativeFTReactNativeTrace.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/ban-types */\nimport type { TurboModule } from 'react-native';\nimport { TurboModuleRegistry } from 'react-native';\n\nexport interface Spec extends TurboModule {\n  /**\n   * Configure trace to enable distributed tracing.\n   * @param config trace configuration parameters.\n   * @returns a Promise.\n   */\n  setConfig(config: Object): Promise<void>;\n  /**\n   * Get trace HTTP request header data.\n   * @param url request URL\n   * @returns trace request header parameters\n   * @deprecated use getTraceHeaderFields() replace.\n   */\n  getTraceHeader(key: string, url: string): Promise<Object>;\n  /**\n   * Get trace HTTP request header data.\n   * @param url request URL\n   * @returns trace request header parameters\n   */\n  getTraceHeaderFields(url: string, key?: string): Promise<Object>;\n}\nexport default TurboModuleRegistry.get<Spec>('FTReactNativeTrace');\n"],"mappings":"AAAA;;AAEA,SAASA,mBAAmB,QAAQ,cAAc;AAuBlD,eAAeA,mBAAmB,CAACC,GAAG,CAAO,oBAAoB,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","get"],"sources":["NativeFTReactNativeTrace.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/ban-types */\nimport type { TurboModule } from 'react-native';\nimport { TurboModuleRegistry } from 'react-native';\n\nexport interface Spec extends TurboModule {\n  /**\n   * Configure trace to enable distributed tracing.\n   * @param config trace configuration parameters.\n   * @returns a Promise.\n   */\n  setConfig(config: Object): Promise<void>;\n  /**\n   * Get trace HTTP request header data.\n   * @param url request URL\n   * @returns trace request header parameters\n   * @deprecated use getTraceHeaderFields() replace.\n   */\n  getTraceHeader(key: string, url: string): Promise<Object>;\n  /**\n   * Get trace HTTP request header data.\n   * @param url request URL\n   * @returns trace request header parameters\n   */\n  getTraceHeaderFields(url: string, key?: string): Promise<Object>;\n  /**\n   * Get trace HTTP request headers synchronously for APIs whose construction\n   * cannot wait for a Promise, such as React Native WebSocket.\n   * @internal\n   */\n  getTraceHeaderFieldsSync(url: string, key: string): Object | null;\n  /**\n   * Discard iOS Trace correlation when WebSocket observation is abandoned\n   * before Resource reporting starts. Android uses native collection.\n   * @internal\n   */\n  cancelWebSocketTrace(key: string): Promise<void>;\n}\nexport default TurboModuleRegistry.get<Spec>('FTReactNativeTrace');\n"],"mappings":"AAAA;;AAEA,SAASA,mBAAmB,QAAQ,cAAc;AAmClD,eAAeA,mBAAmB,CAACC,GAAG,CAAO,oBAAoB,CAAC","ignoreList":[]}

package/lib/module/specs/NativeFTReactNativeWebSocket.js

@@ -0,0 +1,8 @@
+/* eslint-disable @typescript-eslint/ban-types */
+
+import { TurboModuleRegistry } from 'react-native';
+
+/** Internal iOS handshake reporting bridge; absent on Android and older binaries. */
+
+export default TurboModuleRegistry.get('FTReactNativeWebSocket');
+//# sourceMappingURL=NativeFTReactNativeWebSocket.js.map

package/lib/module/specs/NativeFTReactNativeWebSocket.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TurboModuleRegistry","get"],"sources":["NativeFTReactNativeWebSocket.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/ban-types */\nimport type { TurboModule } from 'react-native';\nimport { TurboModuleRegistry } from 'react-native';\n\n/** Internal iOS handshake reporting bridge; absent on Android and older binaries. */\nexport interface Spec extends TurboModule {\n  startCapture(session: string): Promise<void>;\n  stopCapture(session: string): Promise<void>;\n  clear(): Promise<void>;\n  startResource(\n    key: string,\n    socketID: number,\n    url: string,\n    session: string,\n    sequence: number,\n    property: Object\n  ): Promise<void>;\n  stopResource(\n    key: string,\n    event: string,\n    session: string,\n    property: Object\n  ): Promise<void>;\n  addResource(\n    key: string,\n    content: Object,\n    metrics: Object,\n    session: string\n  ): Promise<void>;\n  releaseResource(key: string, session: string): Promise<void>;\n}\n\nexport default TurboModuleRegistry.get<Spec>('FTReactNativeWebSocket');\n"],"mappings":"AAAA;;AAEA,SAASA,mBAAmB,QAAQ,cAAc;;AAElD;;AA4BA,eAAeA,mBAAmB,CAACC,GAAG,CAAO,wBAAwB,CAAC","ignoreList":[]}

package/lib/module/version.js

@@ -1,3 +1,3 @@
 // generated by genversion
-export const version = '0.4.1';
+export const version = '0.4.3-alpha.2';
 //# sourceMappingURL=version.js.map

package/lib/module/version.js.map

@@ -1 +1 @@
-{"version":3,"names":["version"],"sources":["version.ts"],"sourcesContent":["// generated by genversion\nexport const version = '0.4.1';\n"],"mappings":"AAAA;AACA,OAAO,MAAMA,OAAO,GAAG,OAAO","ignoreList":[]}
+{"version":3,"names":["version"],"sources":["version.ts"],"sourcesContent":["// generated by genversion\nexport const version = '0.4.3-alpha.2';\n"],"mappings":"AAAA;AACA,OAAO,MAAMA,OAAO,GAAG,eAAe","ignoreList":[]}

package/lib/typescript/ft_mobile_agent.d.ts

@@ -7,6 +7,7 @@ import { EmitterSubscription } from 'react-native';
 declare class BridgeContextManager {
     private static instance;
     private properties;
+    private longTaskContextEnabled;
     private constructor();
     /**
      * Initialize SDK information properties
@@ -23,6 +24,8 @@ declare class BridgeContextManager {
      * @param properties Object containing key-value pairs
      */
     appendBridgeContext(properties: Record<string, any>): void;
+    configureLongTaskContext(enabled: boolean): void;
+    private syncLongTaskContext;
     /**
      * Merge bridge context properties with local properties
      * Bridge context properties take precedence over local properties
@@ -137,6 +140,8 @@ export type FTRemoteConfigResult = {
  * @param syncSleepTime interval time between each request during data synchronization, unit milliseconds, 0 < syncSleepTime < 100
  * @param enableDataIntegerCompatible whether to enable data integer compatibility during data synchronization, enabled by default
  * @param compressIntakeRequests whether to compress synchronized data
+ * @param enableDataFilter whether to enable SDK-side local data filters, enabled by default
+ * @param dataFilters local blocklist filter rules. Supported categories include `logging` and `rum`. Any data that matches a rule will be discarded.
  * @param globalContext custom global parameters
  * @param groupIdentifiers iOS side sets the AppGroups Identifier array corresponding to the collected Widget Extension
  * @param enableLimitWithDbSize set whether to enable using db to limit data size, after enabling, `FTLogConfig.logCacheLimitCount` and `FTRUMConfig.rumCacheLimitCount` will no longer take effect
@@ -165,6 +170,8 @@ export interface FTMobileConfig {
     syncSleepTime?: number;
     enableDataIntegerCompatible?: boolean;
     compressIntakeRequests?: boolean;
+    enableDataFilter?: boolean;
+    dataFilters?: Record<string, Array<string>>;
     globalContext?: object;
     groupIdentifiers?: Array<string>;
     enableLimitWithDbSize?: boolean;

package/lib/typescript/ft_rum.d.ts

@@ -59,9 +59,15 @@ export declare enum IOSCrashMonitoringType {
  * @param enableTrackNativeAppANR whether to collect Native ANR
  * @param enableTrackNativeFreeze whether to collect Native Freeze
  * @param nativeFreezeDurationMs set the threshold for collecting Native Freeze, value range [100,), unit ms. iOS default 250ms, Android default 1000ms
+ * @param enableLongTask whether to collect React Native JavaScript LongTasks, default false
+ * @param longTaskThresholdMs set the threshold for collecting React Native JavaScript LongTasks, unit ms. Defaults to 100 and is clamped to [100, 5000]
  * @param enableNativeUserAction whether to start Native Action tracking, Button click events, recommended to disable for pure react-native apps
  * @param enableNativeUserView whether to start Native View auto tracking, recommended to disable for pure react-native apps
  * @param enableNativeUserResource whether to automatically collect react-native Resource
+ * @param enableIOSWebSocketResource whether to collect iOS WebSocket opening handshakes as RUM Resources. Defaults to false.
+ * Independent of enableNativeUserResource. Android native WebSocket collection is unaffected.
+ * iOS WebSocket Trace header injection requires both this option and enableNativeAutoTrace.
+ * When disabled, new iOS WebSocket connections are not instrumented or automatically injected with Trace headers by this SDK.
  * @param enableResourceHostIP whether to collect network request Host IP (only for native http, iOS 13 and above)
  * @param errorMonitorType error monitoring supplement type
  * @param deviceMonitorType page monitoring supplement type
@@ -84,9 +90,12 @@ export interface FTRUMConfig {
     enableTrackNativeAppANR?: boolean;
     enableTrackNativeFreeze?: boolean;
     nativeFreezeDurationMs?: number;
+    enableLongTask?: boolean;
+    longTaskThresholdMs?: number;
     enableNativeUserAction?: boolean;
     enableNativeUserView?: boolean;
     enableNativeUserResource?: boolean;
+    enableIOSWebSocketResource?: boolean;
     enableResourceHostIP?: boolean;
     errorMonitorType?: ErrorMonitorType;
     deviceMonitorType?: DeviceMetricsMonitorType;

package/lib/typescript/index.d.ts

@@ -4,4 +4,6 @@ import { FTRUMConfig, FTRUMResource, FTReactNativeRUM, ErrorMonitorType, DeviceM
 import { FTTraceConfig, FTReactNativeTrace, TraceType } from './ft_tracing';
 import { FTRumActionTracking } from './rum/FTRumActionTracking';
 import { FTRumErrorTracking } from './rum/FTRumErrorTracking';
-export { FTMobileReactNative, FTMobileConfig, EnvType, FTDBCacheDiscard, FTRemoteConfigResult, FTRemoteConfigOverrideRule, FTRemoteConfigOverrideMatch, FTRemoteConfigOverrideValues, FTLogConfig, FTReactNativeLog, FTLogStatus, FTLogCacheDiscard, FTRUMConfig, FTReactNativeRUM, FTRUMResource, ErrorMonitorType, DeviceMetricsMonitorType, DetectFrequency, FTRUMResourceMetrics, FTRUMCacheDiscard, IOSCrashMonitoringType, FTTraceConfig, FTReactNativeTrace, TraceType, FTRumActionTracking, FTRumErrorTracking, };
+import { FTBabelInteractionTracking } from './rum/FTBabelInteractionTracking';
+import { __ftExtractText } from './rum/FTBabelUtils';
+export { FTMobileReactNative, FTMobileConfig, EnvType, FTDBCacheDiscard, FTRemoteConfigResult, FTRemoteConfigOverrideRule, FTRemoteConfigOverrideMatch, FTRemoteConfigOverrideValues, FTLogConfig, FTReactNativeLog, FTLogStatus, FTLogCacheDiscard, FTRUMConfig, FTReactNativeRUM, FTRUMResource, ErrorMonitorType, DeviceMetricsMonitorType, DetectFrequency, FTRUMResourceMetrics, FTRUMCacheDiscard, IOSCrashMonitoringType, FTTraceConfig, FTReactNativeTrace, TraceType, FTRumActionTracking, FTRumErrorTracking, FTBabelInteractionTracking, __ftExtractText, };

package/lib/typescript/rum/FTBabelInteractionTracking.d.ts

@@ -0,0 +1,30 @@
+declare global {
+    var __FT_RN_BABEL_PLUGIN_ENABLED__: boolean | undefined;
+}
+export type FTBabelActionTarget = {
+    'options': {
+        useContent: boolean;
+        useNamePrefix: boolean;
+    };
+    'handlerArgs'?: unknown[];
+    'componentName': string;
+    'getContent'?: () => string[];
+    'ft-action-name'?: string[];
+    'customActionName'?: string[];
+    'accessibilityLabel'?: string[];
+};
+type ActionReporter = (actionName: string, actionType: string, property?: object) => Promise<void>;
+type BabelTrackingConfig = {
+    trackInteractions: boolean;
+    actionReporter?: ActionReporter;
+};
+declare class BabelInteractionTracking {
+    private trackInteractions;
+    private actionReporter;
+    getInstance(): BabelInteractionTracking;
+    configure(config: BabelTrackingConfig): void;
+    getTargetName(target: FTBabelActionTarget): string;
+    wrapRumAction(handler: ((...args: any[]) => any) | null | undefined, actionType: string, target: FTBabelActionTarget): (...args: any[]) => any;
+}
+export declare const FTBabelInteractionTracking: BabelInteractionTracking;
+export {};

package/lib/typescript/rum/FTBabelUtils.d.ts

@@ -0,0 +1 @@
+export declare function __ftExtractText(node: any, prefer?: any[]): string[];

package/lib/typescript/rum/FTRumActionTracking.d.ts

@@ -10,6 +10,4 @@ export declare class FTRumActionTracking {
     private static interceptOnPress;
     private static handleTargetEvent;
     private static resolveActionName;
-    private static findActionProperty;
-    private static findActionEnableTrack;
 }

package/lib/typescript/rum/FTRumActionTrackingContext.d.ts

@@ -0,0 +1,11 @@
+export type FTRumActionTrackingContext = {
+    enabled: boolean;
+    property?: object;
+};
+type FiberNode = {
+    memoizedProps?: Record<string, unknown>;
+    return?: FiberNode | null;
+};
+export declare function resolveActionTrackingContextFromTarget(targetNode: FiberNode | null): FTRumActionTrackingContext;
+export declare function resolveActionTrackingContext(handlerArgs: unknown[]): FTRumActionTrackingContext;
+export {};

package/lib/typescript/rum/FTRumWebSocketNative.d.ts

@@ -0,0 +1,23 @@
+export interface NativeWebSocketResource {
+    url: string;
+    httpMethod: string;
+    requestHeader: Record<string, unknown>;
+    webSocketEvent: string;
+    errorMessage?: string;
+}
+export declare class NativeWebSocketSession {
+    private readonly session;
+    private stopped;
+    private sequence;
+    constructor(session: string);
+    startResource(key: string, socketID: number | undefined, url: string): Promise<void>;
+    stopResource(key: string, event: string): Promise<void>;
+    addResource(key: string, content: NativeWebSocketResource, metrics: {
+        duration?: number;
+    }): Promise<void>;
+    release(key: string): void;
+    stop(): void;
+}
+export declare function startNativeWebSocketSession(createKey: () => string): NativeWebSocketSession | undefined;
+export declare function clearNativeWebSocketSessions(): void;
+export declare function webSocketNativeID(socket: unknown): number | undefined;

package/lib/typescript/rum/FTRumWebSocketTiming.d.ts

@@ -0,0 +1,2 @@
+/** Measures only the JS-observed opening handshake; bridge delays are excluded. */
+export declare function startWebSocketTiming(): () => number | undefined;

package/lib/typescript/rum/FTRumWebSocketTracking.d.ts

@@ -0,0 +1,56 @@
+type WebSocketHandshakeState = 'success' | 'rejected' | 'failed';
+interface FTRUMWebSocketResource {
+    url: string;
+    httpMethod: string;
+    requestHeader: Record<string, unknown>;
+    resourceStatus: number;
+    responseHeader?: Record<string, string>;
+    resourceType: 'websocket';
+    webSocketHandshake: true;
+    webSocketHandshakeState: WebSocketHandshakeState;
+    errorMessage?: string;
+}
+interface FTRumWebSocketResourceReporter {
+    startResource(key: string): Promise<void>;
+    stopResource(key: string): Promise<void>;
+    addResource(key: string, resource: FTRUMWebSocketResource, metrics?: {
+        duration?: number;
+        resource_http_protocol?: string;
+    }): Promise<void>;
+}
+export declare class FTRumWebSocketTracking {
+    private static enabled;
+    private static installed;
+    private static originalWebSocket;
+    private static instrumentedWebSocket;
+    private static resourceReporter;
+    private static nativeAutoTraceEnabled;
+    private static warnedFailures;
+    private static lifecycleVersion;
+    private static nativeSession;
+    private static pendingHandshakes;
+    /** Identifies configuration and reporting work started before SDK shutdown. */
+    static getLifecycleVersion(): number;
+    static shutDown(): void;
+    static setNativeAutoTraceEnabled(enabled: boolean): void;
+    private static stopNativeSession;
+    static startTracking(resourceReporter: FTRumWebSocketResourceReporter): void;
+    static stopTracking(): void;
+    private static createWebSocket;
+    private static createResourceKey;
+    private static cancelTrace;
+    private static getTraceHeaders;
+    private static mergeTraceHeaders;
+    private static toOptions;
+    private static toHeaderRecord;
+    private static eventString;
+    private static handshakeErrorFromEvent;
+    private static failureMessageFromClose;
+    private static statusFromError;
+    private static toHandshakeError;
+    private static startResource;
+    private static completeResource;
+    private static completeNativeResource;
+    private static warnOnce;
+}
+export {};

package/lib/typescript/rum/longTasksUtils.d.ts

@@ -0,0 +1,8 @@
+export declare const MIN_LONG_TASK_THRESHOLD_MS = 100;
+export declare const MAX_LONG_TASK_THRESHOLD_MS = 5000;
+export declare 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 declare function normalizeLongTaskThreshold(threshold?: number): number;

package/lib/typescript/specs/NativeFTMobileReactNative.d.ts

@@ -70,6 +70,20 @@ 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;
 }
 declare const _default: Spec | null;
 export default _default;

package/lib/typescript/specs/NativeFTReactNativeRUM.d.ts

@@ -6,6 +6,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.

package/lib/typescript/specs/NativeFTReactNativeTrace.d.ts

@@ -19,6 +19,18 @@ 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>;
 }
 declare const _default: Spec | null;
 export default _default;

package/lib/typescript/specs/NativeFTReactNativeWebSocket.d.ts

@@ -0,0 +1,13 @@
+import type { TurboModule } 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>;
+}
+declare const _default: Spec | null;
+export default _default;

package/lib/typescript/version.d.ts

@@ -1 +1 @@
-export declare const version = "0.4.1";
+export declare const version = "0.4.3-alpha.2";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@truewatchtech/react-native-mobile",
-  "version": "0.4.1",
-  "description": "Base on TrueWatchTech Android iOS React Native SDK",
+  "version": "0.4.3-alpha.2",
+  "description": "Base on TrueWatch Android iOS React Native SDK",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
   "types": "lib/typescript/index.d.ts",
@@ -45,14 +45,14 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/GuanceCloud/datakit-react-native.git"
+    "url": "git+https://github.com/TrueWatchTech/datakit-react-native.git"
   },
   "author": "Brandon <brandonfaustine@gmail.com> (https://github.com/Br4ndonZhang)",
   "license": "Apache-2.0",
   "bugs": {
-    "url": "https://github.com/GuanceCloud/datakit-react-native.git/issues"
+    "url": "https://github.com/TrueWatchTech/datakit-react-native.git/issues"
   },
-  "homepage": "https://github.com/GuanceCloud/datakit-react-native.git#readme",
+  "homepage": "https://github.com/TrueWatchTech/datakit-react-native.git#readme",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },
@@ -96,5 +96,6 @@
   },
   "directories": {
     "lib": "lib"
-  }
+  },
+  "gitHead": "b7f95ab574f7e8c0e13c91d14eea9cba0fad7531"
 }

package/src/ft_mobile_agent.tsx

@@ -3,7 +3,10 @@ import {
   NativeEventEmitter,
   NativeModules,
 } from 'react-native';
+import type { Spec as NativeFTMobileReactNativeSpec } from './specs/NativeFTMobileReactNative';
+import type { Spec as NativeFTReactNativeRUMSpec } from './specs/NativeFTReactNativeRUM';
 import { version as sdkVersion } from './version';
+import { FTRumWebSocketTracking } from './rum/FTRumWebSocketTracking';
 
 /**
  * Bridge context manager for managing shared properties across RUM and Logger modules
@@ -13,6 +16,7 @@ import { version as sdkVersion } from './version';
 class BridgeContextManager {
   private static instance: BridgeContextManager;
   private properties: Map<string, any> = new Map();
+  private longTaskContextEnabled = false;
 
   private constructor() {
     // Initialize with SDK version information
@@ -55,11 +59,35 @@ class BridgeContextManager {
       Object.entries(properties).forEach(([key, value]) => {
         this.properties.set(key, value);
       });
+      if (this.longTaskContextEnabled) {
+        this.syncLongTaskContext();
+      }
     } catch (error) {
       console.warn('Failed to append bridge context:', error);
     }
   }
 
+  public configureLongTaskContext(enabled: boolean): void {
+    this.longTaskContextEnabled = enabled;
+    if (enabled) {
+      this.syncLongTaskContext();
+    }
+  }
+
+  private syncLongTaskContext(): void {
+    try {
+      // Apply the snapshot before JS can block. An async native call may run after
+      // the frame that detects the long task and attach stale context to it.
+      const rum: NativeFTReactNativeRUMSpec =
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        require('./specs/NativeFTReactNativeRUM').default;
+      rum.setLongTaskContext(this.mergeWithLocalPropertiesSync());
+    } catch (error) {
+      // Context synchronization must not make a destroyed/older bridge crash the host.
+      console.warn('Failed to sync JS long task bridge context:', error);
+    }
+  }
+
   /**
    * Merge bridge context properties with local properties
    * Bridge context properties take precedence over local properties
@@ -209,6 +237,8 @@ export type FTRemoteConfigResult = {
  * @param syncSleepTime interval time between each request during data synchronization, unit milliseconds, 0 < syncSleepTime < 100
  * @param enableDataIntegerCompatible whether to enable data integer compatibility during data synchronization, enabled by default
  * @param compressIntakeRequests whether to compress synchronized data
+ * @param enableDataFilter whether to enable SDK-side local data filters, enabled by default
+ * @param dataFilters local blocklist filter rules. Supported categories include `logging` and `rum`. Any data that matches a rule will be discarded.
  * @param globalContext custom global parameters
  * @param groupIdentifiers iOS side sets the AppGroups Identifier array corresponding to the collected Widget Extension
  * @param enableLimitWithDbSize set whether to enable using db to limit data size, after enabling, `FTLogConfig.logCacheLimitCount` and `FTRUMConfig.rumCacheLimitCount` will no longer take effect
@@ -237,6 +267,8 @@ export interface FTMobileConfig {
   syncSleepTime?: number;
   enableDataIntegerCompatible?: boolean;
   compressIntakeRequests?: boolean;
+  enableDataFilter?: boolean;
+  dataFilters?: Record<string, Array<string>>;
   globalContext?: object;
   groupIdentifiers?: Array<string>;
   enableLimitWithDbSize?: boolean;
@@ -357,8 +389,10 @@ type FTMobileReactNativeType = {
 
 class FTMobileReactNativeWrapper implements FTMobileReactNativeType {
   /* eslint-disable @typescript-eslint/no-var-requires */
-  private sdk: FTMobileReactNativeType =
+  private sdk: NativeFTMobileReactNativeSpec =
     require('./specs/NativeFTMobileReactNative').default;
+  private rum: NativeFTReactNativeRUMSpec =
+    require('./specs/NativeFTReactNativeRUM').default;
   /* eslint-enable @typescript-eslint/no-var-requires */
 
   private emitter: NativeEventEmitter | null = null;
@@ -415,24 +449,33 @@ class FTMobileReactNativeWrapper implements FTMobileReactNativeType {
   flushSyncData(): Promise<void> {
     return this.sdk.flushSyncData();
   }
-  shutDown(): Promise<void> {
-    return this.sdk.shutDown();
+  async shutDown(): Promise<void> {
+    bridgeContextManager.configureLongTaskContext(false);
+    try {
+      FTRumWebSocketTracking.shutDown();
+      await this.rum.stopLongTaskTracking();
+    } finally {
+      await this.sdk.shutDown();
+    }
   }
   clearAllData(): Promise<void> {
     return this.sdk.clearAllData();
   }
   appendBridgeContext(properties: Record<string, any>): void {
-    // Use bridgeContextManager to store properties in JavaScript and send to native SDK
+    // Store properties in JS and update the native long task snapshot when enabled.
     bridgeContextManager.appendBridgeContext(properties);
   }
   updateRemoteConfig(): Promise<FTRemoteConfigResult> {
-    return this.sdk.updateRemoteConfig();
+    return this.sdk.updateRemoteConfig() as Promise<FTRemoteConfigResult>;
   }
   updateRemoteConfigWithMiniUpdateInterval(
     interval: number,
     rules?: Array<FTRemoteConfigOverrideRule>
   ): Promise<FTRemoteConfigResult> {
-    return this.sdk.updateRemoteConfigWithMiniUpdateInterval(interval, rules);
+    return this.sdk.updateRemoteConfigWithMiniUpdateInterval(
+      interval,
+      rules
+    ) as Promise<FTRemoteConfigResult>;
   }
   addRemoteConfigListener(
     listener: (result: FTRemoteConfigResult) => void

package/src/ft_rum.tsx

@@ -1,7 +1,11 @@
 // import { NativeModules } from 'react-native';
+import { Platform } from 'react-native';
 import { FTRumErrorTracking } from './rum/FTRumErrorTracking';
 import { FTRumActionTracking } from './rum/FTRumActionTracking';
+import { FTBabelInteractionTracking } from './rum/FTBabelInteractionTracking';
+import { FTRumWebSocketTracking } from './rum/FTRumWebSocketTracking';
 import { bridgeContextManager } from './ft_mobile_agent';
+import { normalizeLongTaskThreshold } from './rum/longTasksUtils';
 
 /**
  * Error monitoring type.
@@ -80,9 +84,15 @@ export enum IOSCrashMonitoringType {
  * @param enableTrackNativeAppANR whether to collect Native ANR
  * @param enableTrackNativeFreeze whether to collect Native Freeze
  * @param nativeFreezeDurationMs set the threshold for collecting Native Freeze, value range [100,), unit ms. iOS default 250ms, Android default 1000ms
+ * @param enableLongTask whether to collect React Native JavaScript LongTasks, default false
+ * @param longTaskThresholdMs set the threshold for collecting React Native JavaScript LongTasks, unit ms. Defaults to 100 and is clamped to [100, 5000]
  * @param enableNativeUserAction whether to start Native Action tracking, Button click events, recommended to disable for pure react-native apps
  * @param enableNativeUserView whether to start Native View auto tracking, recommended to disable for pure react-native apps
  * @param enableNativeUserResource whether to automatically collect react-native Resource
+ * @param enableIOSWebSocketResource whether to collect iOS WebSocket opening handshakes as RUM Resources. Defaults to false.
+ * Independent of enableNativeUserResource. Android native WebSocket collection is unaffected.
+ * iOS WebSocket Trace header injection requires both this option and enableNativeAutoTrace.
+ * When disabled, new iOS WebSocket connections are not instrumented or automatically injected with Trace headers by this SDK.
  * @param enableResourceHostIP whether to collect network request Host IP (only for native http, iOS 13 and above)
  * @param errorMonitorType error monitoring supplement type
  * @param deviceMonitorType page monitoring supplement type
@@ -105,9 +115,12 @@ export interface FTRUMConfig {
   enableTrackNativeAppANR?: boolean;
   enableTrackNativeFreeze?: boolean;
   nativeFreezeDurationMs?: number;
+  enableLongTask?: boolean;
+  longTaskThresholdMs?: number;
   enableNativeUserAction?: boolean;
   enableNativeUserView?: boolean;
   enableNativeUserResource?: boolean;
+  enableIOSWebSocketResource?: boolean;
   enableResourceHostIP?: boolean;
   errorMonitorType?: ErrorMonitorType;
   deviceMonitorType?: DeviceMetricsMonitorType;
@@ -259,20 +272,66 @@ type FTReactNativeRUMType = {
   ): Promise<void>;
 };
 
+function isBabelPluginEnabled(): boolean {
+  if (typeof globalThis !== 'undefined') {
+    return globalThis.__FT_RN_BABEL_PLUGIN_ENABLED__ === true;
+  }
+  if (typeof global !== 'undefined') {
+    return global.__FT_RN_BABEL_PLUGIN_ENABLED__ === true;
+  }
+  return false;
+}
+
 class FTReactNativeRUMWrapper implements FTReactNativeRUMType {
+  private webSocketConfigVersion = 0;
   // eslint-disable-next-line @typescript-eslint/no-var-requires
   private rum: FTReactNativeRUMType = require('./specs/NativeFTReactNativeRUM')
     .default;
 
   setConfig(config: FTRUMConfig): Promise<void> {
+    bridgeContextManager.configureLongTaskContext(
+      config.enableLongTask === true
+    );
+    const webSocketLifecycle = FTRumWebSocketTracking.getLifecycleVersion();
+    const webSocketConfigVersion = ++this.webSocketConfigVersion;
+    const trackWebSocket = config.enableIOSWebSocketResource === true;
     console.log('FTRUMConfig');
     if (config.enableAutoTrackError) {
       FTRumErrorTracking.startTracking();
     }
-    if (config.enableAutoTrackUserAction) {
+    const babelPluginEnabled = isBabelPluginEnabled();
+    FTBabelInteractionTracking.configure({
+      trackInteractions:
+        babelPluginEnabled && Boolean(config.enableAutoTrackUserAction),
+      actionReporter: (actionName, actionType, property) =>
+        this.startAction(actionName, actionType, property),
+    });
+    if (config.enableAutoTrackUserAction && !babelPluginEnabled) {
       FTRumActionTracking.startTracking();
+    } else {
+      FTRumActionTracking.stopTracking();
     }
-    return this.rum.setConfig(config);
+    return this.rum
+      .setConfig({
+        ...config,
+        enableLongTask: config.enableLongTask === true,
+        longTaskThresholdMs: normalizeLongTaskThreshold(
+          config.longTaskThresholdMs
+        ),
+      })
+      .then(() => {
+        if (
+          webSocketLifecycle !== FTRumWebSocketTracking.getLifecycleVersion() ||
+          webSocketConfigVersion !== this.webSocketConfigVersion
+        ) {
+          return;
+        }
+        if (Platform.OS === 'ios' && trackWebSocket) {
+          FTRumWebSocketTracking.startTracking(this);
+        } else {
+          FTRumWebSocketTracking.stopTracking();
+        }
+      });
   }
   startAction(
     actionName: string,