@dynatrace/react-native-plugin 2.339.1 → 2.341.1

package/types.d.ts

@@ -684,17 +684,17 @@ interface IEventModifier {
     modifyEvent(event: JSONObject): JSONObject | null;
 }
 
-/**
- * Represents the allowed types for event property values.
- */
-type EventProperty = string | number | boolean;
-
 type TraceparentHeader = `${string}-${string}-${string}-${string}`;
 interface TraceContext {
     traceparent: TraceparentHeader;
     tracestate: string;
 }
 
+/**
+ * Represents the allowed types for event property values.
+ */
+type EventProperty = string | number | boolean;
+
 /**
  * Base interface for all events.
  */
@@ -1845,8 +1845,8 @@ declare class ManualStartupConfiguration implements IConfiguration {
  * Builder for manual startup configuration used with `Dynatrace.start()`.
  */
 declare class ConfigurationBuilder {
-    private beaconUrl;
-    private applicationId;
+    private readonly beaconUrl;
+    private readonly applicationId;
     private reportCrash;
     private errorHandler;
     private reportFatalErrorAsCrash;
@@ -2346,6 +2346,157 @@ declare class DynatraceWebRequestTiming implements IDynatraceWebRequestTiming {
     getRequestTagHeader(): string;
 }
 
+/**
+ * Configuration for React Native transformer
+ */
+interface TransformerReactConfiguration {
+    /**
+     * Path to an upstream transformer to use before Dynatrace transformation
+     */
+    upstreamTransformer?: string;
+}
+/**
+ * Configuration for React Native instrumentation
+ */
+interface InstrumentationReactConfiguration {
+    /**
+     * Whether to automatically start the Dynatrace agent (and insert instrumentation for startup)
+     */
+    autoStart: boolean;
+    /**
+     * Enable debug mode for additional console output during instrumentation and runtime
+     */
+    debug: boolean;
+    /**
+     * Unique name for the bundle. Required for multiple bundle setups and sourcemap deobfuscation.
+     */
+    bundleName?: string;
+    /**
+     * Version of the bundle
+     */
+    bundleVersion?: string;
+    /**
+     * Error handler configuration
+     */
+    errorHandler: {
+        /**
+         * Enable the Dynatrace error/crash handler
+         */
+        enabled: boolean;
+        /**
+         * Report fatal/unhandled errors as crashes instead of errors
+         *
+         * @remarks
+         * When false, fatal errors are reported as errors and the current session remains open
+         */
+        reportFatalErrorAsCrash: boolean;
+    };
+    /**
+     * Lifecycle event monitoring configuration
+     */
+    lifecycle: {
+        /**
+         * Include React component update lifecycle events
+         */
+        includeUpdate: boolean;
+        /**
+         * Determine which files should have lifecycle instrumentation
+         *
+         * @param filename - Path to the file being instrumented
+         * @returns true to instrument the file, false to skip
+         *
+         * @defaultValue Returns false for all files
+         */
+        instrument: (filename: string) => boolean;
+    };
+    /**
+     * User input monitoring configuration
+     */
+    input: {
+        /**
+         * Determine which files should have input instrumentation
+         *
+         * @param filename - Path to the file being instrumented
+         * @returns true to instrument the file, false to skip
+         *
+         * @defaultValue Returns true for all files
+         */
+        instrument: (filename: string) => boolean;
+        /**
+         * Enable action name privacy to exclude automatic text/label detection
+         *
+         * @defaultValue false
+         *
+         * @remarks
+         * When true, action names will not include accessibility labels, button titles,
+         * or inner text. Use dtActionName property to set custom names.
+         */
+        actionNamePrivacy?: boolean;
+        actionNamePreference?: ActionNamePreference;
+        actionNameAlgorithm?: ActionNameAlgorithm;
+    };
+    /**
+     * Navigation monitoring configuration
+     */
+    navigation: {
+        /**
+         * Enable automatic navigation tracking
+         */
+        enabled: boolean;
+    };
+    userInteraction: boolean;
+    sourcemap: {
+        enabled: boolean;
+        androidSourcemapLocation: string;
+    };
+    debugBabelPlugin?: boolean;
+    useLegacyJscodeshift?: boolean;
+}
+/**
+ * Combined React configuration including transformer and instrumentation settings
+ */
+type ReactConfiguration = TransformerReactConfiguration & InstrumentationReactConfiguration;
+/**
+ * Main Dynatrace configuration structure
+ */
+interface DynatraceConfiguration {
+    /**
+     * React Native specific configuration
+     */
+    react: ReactConfiguration;
+    /**
+     * Android native agent configuration
+     */
+    android?: NativeConfiguration;
+    /**
+     * iOS native agent configuration
+     */
+    ios?: NativeConfiguration;
+}
+/**
+ * The type of dynatrace.config.js
+ * All properties are optional since the user can only specify a subset
+ * Will be merged with defaultConfig to ensure all required values are present
+ * When T is a primitive or a function, then DeepPartial<T> resolves to T for better readability
+ */
+type DeepPartial<T> = T extends Function ? T : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+type DynatraceUserConfiguration = DeepPartial<DynatraceConfiguration>;
+/**
+ * Native platform (Android/iOS) configuration
+ */
+interface NativeConfiguration {
+    /**
+     * Platform-specific configuration string
+     *
+     * @remarks
+     * For Android: Contains Gradle DSL configuration block
+     * For iOS: Contains plist key-value pairs
+     */
+    config?: string;
+}
+
 declare module 'react' {
     namespace JSX {
         interface IntrinsicAttributes extends IDynatraceProperties {
@@ -2354,4 +2505,4 @@ declare module 'react' {
 }
 
 export { ConfigurationBuilder, DataCollectionLevel, Dynatrace, DynatraceWebRequestTiming, EventData, ExceptionEventData, HttpRequestEventData, LogLevel, ManualStartupConfiguration, Platform, SessionPropertyEventData, UserPrivacyOptions };
-export type { IConfiguration, IDynatraceAction, IDynatraceRootAction, IDynatraceWebRequestTiming, IEventModifier, JSONObject };
+export type { DynatraceUserConfiguration, IConfiguration, IDynatraceAction, IDynatraceRootAction, IDynatraceWebRequestTiming, IEventModifier, JSONObject };