@dynatrace/react-native-plugin 2.341.1 → 2.343.1

package/lib/next/events/EventPipeline.js

@@ -34,30 +34,53 @@ class EventPipelineImpl {
         ];
     }
     insertEvent(event) {
+        if (this.isSuppressed(event)) {
+            return;
+        }
+        this.logger.debug(LogMessages_1.LogMessage.EVENT_PIPELINE_INSERT_EVENT, {
+            event: JSON.stringify(event),
+        });
+        const processed = this.applyModifiers(event);
+        if (processed != null) {
+            this.dispatchEvent(processed);
+        }
+    }
+    addEventModifier(eventModifier) {
+        this.logger.debug(LogMessages_1.LogMessage.ADD_EVENT_MODIFIER);
+        return this.customEventModifierChain.addEventModifier(eventModifier);
+    }
+    removeEventModifier(eventModifier) {
+        this.logger.debug(LogMessages_1.LogMessage.REMOVE_EVENT_MODIFIER);
+        return this.customEventModifierChain.removeEventModifier(eventModifier);
+    }
+    isSuppressed(event) {
         const decision = ConfigurationHandler_1.ConfigurationHandler.getThirdGenDataReportingDecision();
-        if (!decision.allowed) {
+        if (decision.allowed) {
+            return false;
+        }
+        const isAppStart = event["characteristics.has_app_start"] ===
+            true;
+        const suppressed = !isAppStart ||
+            decision.reason === 'data_collection_off' ||
+            decision.reason === 'agent_inactive';
+        if (suppressed) {
             const reasonText = decision.reason
                 ? DECISION_REASON_TEXT[decision.reason]
                 : 'Unknown reason';
             this.logger.debug(LogMessages_1.LogMessage.THIRD_GEN_EVENT_SUPPRESSED, {
                 reason: reasonText,
             });
-            return;
         }
-        this.logger.debug(LogMessages_1.LogMessage.EVENT_PIPELINE_INSERT_EVENT, {
-            event: JSON.stringify(event),
-        });
-        let isDiscarded = false;
+        return suppressed;
+    }
+    applyModifiers(event) {
         for (const modifier of this.getEventModifierChain()) {
             try {
-                const eventRv = modifier.modifyEvent(event);
-                if (eventRv == null) {
-                    isDiscarded = true;
-                    break;
-                }
-                else {
-                    event = eventRv;
+                const result = modifier.modifyEvent(event);
+                if (result == null) {
+                    return null;
                 }
+                event = result;
             }
             catch (_a) {
                 if (event != null) {
@@ -65,25 +88,19 @@ class EventPipelineImpl {
                 }
             }
         }
-        if (event != null && !isDiscarded) {
-            this.logger.debug(LogMessages_1.LogMessage.EVENT_PIPELINE_FORWARD_EVENT, {
-                event: JSON.stringify(event),
-            });
-            if (event["characteristics.has_app_start"] === true) {
-                DynatraceBridge_1.DynatraceNative.forwardAppStartEvent(event, EventSpecContstants_1.ALL_APP_START_KEYS);
-            }
-            else {
-                DynatraceBridge_1.DynatraceNative.forwardEvent(event);
-            }
-        }
-    }
-    addEventModifier(eventModifier) {
-        this.logger.debug(LogMessages_1.LogMessage.ADD_EVENT_MODIFIER);
-        return this.customEventModifierChain.addEventModifier(eventModifier);
+        return event;
     }
-    removeEventModifier(eventModifier) {
-        this.logger.debug(LogMessages_1.LogMessage.REMOVE_EVENT_MODIFIER);
-        return this.customEventModifierChain.removeEventModifier(eventModifier);
+    dispatchEvent(event) {
+        this.logger.debug(LogMessages_1.LogMessage.EVENT_PIPELINE_FORWARD_EVENT, {
+            event: JSON.stringify(event),
+        });
+        if (event["characteristics.has_app_start"] ===
+            true) {
+            DynatraceBridge_1.DynatraceNative.forwardAppStartEvent(event, EventSpecContstants_1.ALL_APP_START_KEYS);
+        }
+        else {
+            DynatraceBridge_1.DynatraceNative.forwardEvent(event);
+        }
     }
 }
 exports.EventPipeline = new EventPipelineImpl();

package/lib/next/events/HttpRequestEventData.js

@@ -94,7 +94,7 @@ class HttpRequestEventData {
             return "api_set";
         }
         else {
-            return "invalid";
+            return "invalid_set";
         }
     }
     hasValidMandatoryAttributes() {

package/lib/next/events/spec/EventSpecContstants.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ALL_APP_START_KEYS = exports.EVENT_WHITELIST_SIZE = exports.MODIFY_EVENT_WHITELIST_NAMESPACE = exports.MODIFY_EVENT_WHITELIST_STRING_FIELDS = exports.MODIFY_EVENT_WHITELIST_FIELDS = exports.SEND_SESSION_PROPERTY_EVENT_WHITELIST_FIELDS = exports.SEND_EXCEPTION_EVENT_WHITELIST_FIELDS = exports.SEND_EVENT_WHITELIST_FIELDS = exports.SEND_SESSION_PROPERTY_EVENT_WHITELIST_NAMESPACES = exports.SEND_EXCEPTION_EVENT_WHITELIST_NAMESPACES = exports.SEND_EVENT_WHITELIST_NAMESPACES = exports.AllCharacteristicsKeys = exports.KEY_NAME_REGEX = exports.MAX_CUSTOM_EVENT_VALUE_LENGTH = exports.MAX_CUSTOM_EVENT_KEY_LENGTH = exports.MAX_CUSTOM_EVENT_FIELDS = exports.SPECIFICATION_VERSION = void 0;
-exports.SPECIFICATION_VERSION = '0.23.0';
+exports.SPECIFICATION_VERSION = '0.24.0';
 exports.MAX_CUSTOM_EVENT_FIELDS = 50;
 exports.MAX_CUSTOM_EVENT_KEY_LENGTH = 100;
 exports.MAX_CUSTOM_EVENT_VALUE_LENGTH = 5000;

package/lib/next/userAction/NullUserAction.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NullUserAction = void 0;
+class NullUserAction {
+    getCustomName() {
+        return '';
+    }
+    isCompleteAutomatically() {
+        return false;
+    }
+    setCompleteAutomatically(enabled) { }
+    complete() { }
+    addEventProperty(key, value) { }
+}
+exports.NullUserAction = NullUserAction;

package/lib/next/userAction/UserAction.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/next/userAction/UserActionConfiguration.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserActionConfiguration = void 0;
+class UserActionConfiguration {
+    constructor(customName, completeAutomatically = false) {
+        this.customName = customName;
+        this.completeAutomatically = completeAutomatically;
+    }
+}
+exports.UserActionConfiguration = UserActionConfiguration;

package/lib/next/userAction/UserActionImpl.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserActionImpl = void 0;
+const DynatraceBridge_1 = require("../../core/DynatraceBridge");
+const ConsoleLogger_1 = require("../../core/logging/ConsoleLogger");
+const LogMessages_1 = require("../../core/logging/LogMessages");
+const Utils_1 = require("../util/Utils");
+const randomActionId = () => (0, Utils_1.randomHex)(16);
+class UserActionImpl {
+    constructor(configuration) {
+        this.completed = false;
+        this.logger = new ConsoleLogger_1.ConsoleLogger('UserAction');
+        this.customName = configuration.customName;
+        this.completeAutomatically = configuration.completeAutomatically;
+        this.actionId = randomActionId();
+        DynatraceBridge_1.DynatraceNative.createUserAction(this.actionId, this.customName, this.completeAutomatically, null);
+        this.logger.debug(LogMessages_1.LogMessage.USER_ACTION_CREATED, {
+            customName: this.customName,
+            completeAutomatically: this.completeAutomatically,
+            actionId: this.actionId,
+        });
+    }
+    getCustomName() {
+        return this.customName;
+    }
+    isCompleteAutomatically() {
+        return this.completeAutomatically;
+    }
+    setCompleteAutomatically(enabled) {
+        if (this.completed) {
+            return;
+        }
+        this.logger.debug(LogMessages_1.LogMessage.USER_ACTION_SET_COMPLETE_AUTOMATICALLY, {
+            enabled,
+            customName: this.customName,
+        });
+        this.completeAutomatically = enabled;
+        DynatraceBridge_1.DynatraceNative.setCompleteUserActionAutomatically(this.actionId, enabled);
+    }
+    complete() {
+        if (this.completed) {
+            return;
+        }
+        this.completed = true;
+        this.logger.debug(LogMessages_1.LogMessage.USER_ACTION_COMPLETE, {
+            customName: this.customName,
+        });
+        DynatraceBridge_1.DynatraceNative.completeUserAction(this.actionId);
+    }
+    addEventProperty(key, value) {
+        if (this.completed) {
+            return;
+        }
+        this.logger.debug(LogMessages_1.LogMessage.USER_ACTION_ADD_EVENT_PROPERTY, {
+            key,
+            value: String(value),
+            customName: this.customName,
+        });
+        if (typeof value === 'string') {
+            DynatraceBridge_1.DynatraceNative.addEventStringPropertyToUserAction(this.actionId, key, value);
+        }
+        else if (typeof value === 'number') {
+            DynatraceBridge_1.DynatraceNative.addEventDoublePropertyToUserAction(this.actionId, key, value);
+        }
+        else {
+            DynatraceBridge_1.DynatraceNative.addEventBooleanPropertyToUserAction(this.actionId, key, value);
+        }
+    }
+}
+exports.UserActionImpl = UserActionImpl;

package/lib/next/util/TraceContextUtils.js

@@ -4,6 +4,7 @@ exports.trimTraceState = exports.generateTracestate = exports.generateTraceparen
 const ConsoleLogger_1 = require("../../core/logging/ConsoleLogger");
 const LogMessages_1 = require("../../core/logging/LogMessages");
 const ConfigurationHandler_1 = require("../../core/configuration/ConfigurationHandler");
+const Utils_1 = require("./Utils");
 const logger = new ConsoleLogger_1.ConsoleLogger('TraceContextUtils');
 const parseTraceparent = (traceparent) => {
     const traceparentRegex = /^[0-9a-f]{2}-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/i;
@@ -26,27 +27,18 @@ const parseTraceparent = (traceparent) => {
 exports.parseTraceparent = parseTraceparent;
 const allZeros = (str) => /^0*$/.test(str);
 const generateTraceparentHeader = () => {
-    let traceId = randomHex(32);
+    let traceId = (0, Utils_1.randomHex)(32);
     if (/^0+$/.test(traceId)) {
         traceId = '1' + traceId.slice(1);
     }
-    let spanId = randomHex(16);
+    let spanId = (0, Utils_1.randomHex)(16);
     if (/^0+$/.test(spanId)) {
         spanId = '1' + spanId.slice(1);
     }
     return `00-${traceId}-${spanId}-01`;
 };
 exports.generateTraceparentHeader = generateTraceparentHeader;
-const randomHex = (length) => {
-    let hex = '';
-    while (hex.length < length) {
-        hex += Math.floor(Math.random() * 0xffffffff)
-            .toString(16)
-            .padStart(8, '0');
-    }
-    return hex.slice(0, length);
-};
-const generateTracestate = (parentId, existingTracestate) => {
+const generateTracestate = (parentId, traceparentFromDynatrace, existingTracestate) => {
     const instanceId = ConfigurationHandler_1.ConfigurationHandler.getInstanceId();
     const sessionId = ConfigurationHandler_1.ConfigurationHandler.getSessionId();
     const applicationId = ConfigurationHandler_1.ConfigurationHandler.getApplicationId();
@@ -55,10 +47,12 @@ const generateTracestate = (parentId, existingTracestate) => {
         !(instanceId && sessionId && applicationId && tracestateKeyPrefix)) {
         return undefined;
     }
-    const version = 1;
     const originMarker = 'dtr';
+    const version = 2;
     const capture = 0;
-    let tracestate = `${tracestateKeyPrefix}@${originMarker}=${version};${parentId};${capture};${formatApplicationId(applicationId)};${instanceId};${sessionId}`;
+    const formattedApplicationId = formatApplicationId(applicationId);
+    const tpSource = traceparentFromDynatrace ? 1 : 2;
+    let tracestate = `${tracestateKeyPrefix}@${originMarker}=${version};${parentId};${capture};${formattedApplicationId};${instanceId};${sessionId};${tpSource}`;
     if (typeof existingTracestate === 'string' && existingTracestate.trim()) {
         tracestate += `,${existingTracestate}`;
     }

package/lib/next/util/Utils.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randomHex = void 0;
+const randomHex = (length) => {
+    let hex = '';
+    while (hex.length < length) {
+        hex += Math.floor(Math.random() * 0xffffffff)
+            .toString(16)
+            .padStart(8, '0');
+    }
+    return hex.slice(0, length);
+};
+exports.randomHex = randomHex;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynatrace/react-native-plugin",
-  "version": "2.341.1",
+  "version": "2.343.1",
   "description": "This plugin gives you the ability to use the Dynatrace Mobile agent in your react native application.",
   "main": "index.js",
   "types": "types.d.ts",
@@ -50,7 +50,7 @@
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
     "@babel/runtime": "^8.0.0",
-    "jscodeshift": "^17.3.0",
+    "jscodeshift": "^17.4.0",
     "plist": "^3.1.0",
     "proxy-polyfill": "^0.3.2",
     "semver": "^7.8.5"
@@ -69,7 +69,10 @@
     "ast-types": "npm:ast-types-x",
     "flow-parser": "0.160",
     "tmp": ">=0.2.6",
-    "ws": "^7.5.11"
+    "ws": "^7.5.11",
+    "@istanbuljs/load-nyc-config": {
+      "js-yaml": "^3.15.0"
+    }
   },
   "devDependencies": {
     "@babel/plugin-transform-class-properties": "^7.27.1",
@@ -175,6 +178,7 @@
     "lib/next/events/spec/*.js",
     "lib/next/util/*.js",
     "lib/next/provider/*.js",
+    "lib/next/userAction/*.js",
     "lib/features/ui-interaction/*.js",
     "src/lib/core/interface/NativeDynatraceBridge.ts",
     "types.d.ts"

package/public.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExceptionEventData = exports.SessionPropertyEventData = exports.EventData = exports.HttpRequestEventData = exports.DynatraceWebRequestTiming = exports.UserPrivacyOptions = exports.LogLevel = exports.Platform = exports.ConfigurationBuilder = exports.ManualStartupConfiguration = exports.DataCollectionLevel = exports.Dynatrace = void 0;
+exports.UserActionConfiguration = exports.ExceptionEventData = exports.SessionPropertyEventData = exports.EventData = exports.HttpRequestEventData = exports.DynatraceWebRequestTiming = exports.UserPrivacyOptions = exports.LogLevel = exports.Platform = exports.ConfigurationBuilder = exports.ManualStartupConfiguration = exports.DataCollectionLevel = exports.Dynatrace = void 0;
 var Dynatrace_1 = require("./lib/core/Dynatrace");
 Object.defineProperty(exports, "Dynatrace", { enumerable: true, get: function () { return Dynatrace_1.Dynatrace; } });
 var DataCollectionLevel_1 = require("./lib/core/model/DataCollectionLevel");
@@ -25,4 +25,6 @@ var SessionPropertyEventData_1 = require("./lib/next/events/SessionPropertyEvent
 Object.defineProperty(exports, "SessionPropertyEventData", { enumerable: true, get: function () { return SessionPropertyEventData_1.default; } });
 var ExceptionEventData_1 = require("./lib/next/events/ExceptionEventData");
 Object.defineProperty(exports, "ExceptionEventData", { enumerable: true, get: function () { return ExceptionEventData_1.default; } });
+var UserActionConfiguration_1 = require("./lib/next/userAction/UserActionConfiguration");
+Object.defineProperty(exports, "UserActionConfiguration", { enumerable: true, get: function () { return UserActionConfiguration_1.UserActionConfiguration; } });
 require("./react-augmentation");

package/react-native-dynatrace.podspec

@@ -12,10 +12,17 @@ Pod::Spec.new do |s|
   s.version       = package['version']
   s.summary       = package['description'] 
   s.homepage      = package['homepage'] 
-  s.ios.deployment_target = "12.0"
-  s.tvos.deployment_target = "12.0"
+  s.ios.deployment_target = "15.0"
+  s.tvos.deployment_target = "15.0"
   s.source_files  = ["ios/*.{h,mm}"]
 
+  # Build-time off-switch for screenshot self-monitoring (replay metrics), passed at `pod install`:
+  #   DYNATRACE_REPLAY_METRICS_ENABLED=0 pod install
+  # Defaults to enabled; when set to 0 the monitor is compiled out (DynatraceRNBridge.mm #if guard).
+  if ENV['DYNATRACE_REPLAY_METRICS_ENABLED'] == '0'
+    s.prefix_header_contents = '#define DTX_REPLAY_METRICS_ENABLED 0'
+  end
+
   s.license = { :type => 'Commercial', :text => 'https://github.com/Dynatrace/dem-license/blob/main/LICENSE.md'} 
 
   # ---  License  ----------------------------------------------------------- #
@@ -111,7 +118,7 @@ Pod::Spec.new do |s|
   #
   
   s.dependency "React"
-  s.dependency 'Dynatrace', '~> 8.341.1.1010'
+  s.dependency 'Dynatrace', '~> 8.343.1.1007'
 
   # Allows for better compatibility for older and newer versions
   if defined?(install_modules_dependencies)

package/scripts/Config.js

@@ -12,6 +12,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkConfiguration = exports.addDefaultConfigs = exports.readConfig = exports.readConfigDefault = exports.defaultConfig = exports.ERROR_CONFIG_NOT_AVAILABLE = void 0;
 const path = require("node:path");
+const node_fs_1 = require("node:fs");
 const FileOperationHelper_1 = require("./FileOperationHelper");
 const Logger_1 = require("./Logger");
 const PathsConstants_1 = require("./PathsConstants");
@@ -45,9 +46,19 @@ exports.defaultConfig = {
 };
 const readConfigDefault = () => {
     const customArguments = (0, CustomArgumentUtil_1.readCustomArguments)();
-    const configPath = customArguments.isCustomConfigurationPathSet()
-        ? path.resolve(PathsConstants_1.default.getApplicationPath(), customArguments.getCustomConfigurationPath())
-        : PathsConstants_1.default.getConfigFilePath();
+    let configPath;
+    if (customArguments.isCustomConfigurationPathSet()) {
+        configPath = path.resolve(PathsConstants_1.default.getApplicationPath(), customArguments.getCustomConfigurationPath());
+    }
+    else {
+        const envConfig = process.env.DYNATRACE_CONFIG;
+        if (envConfig === undefined || envConfig.trim() === '') {
+            configPath = PathsConstants_1.default.getConfigFilePath();
+        }
+        else {
+            configPath = path.resolve(PathsConstants_1.default.getApplicationPath(), envConfig.trim());
+        }
+    }
     return (0, exports.readConfig)(configPath);
 };
 exports.readConfigDefault = readConfigDefault;
@@ -87,6 +98,9 @@ const logConfigCreatedMessage = () => {
     Logger_1.default.logMessageSync(message, Logger_1.default.INFO);
 };
 const patchMalformedConfiguration = (pathToDynatraceConfig) => {
+    if (!(0, node_fs_1.existsSync)(pathToDynatraceConfig)) {
+        return;
+    }
     const configContent = FileOperationHelper_1.default.readTextFromFileSync(pathToDynatraceConfig);
     if (configContent.indexOf('\u200B') !== -1) {
         FileOperationHelper_1.default.writeTextToFileSync(pathToDynatraceConfig, configContent.split('\u200B').join(''));

package/scripts/core/InstrumentCall.js

@@ -20,6 +20,10 @@ const logHelpMessage = () => {
 
         Options:
             --help                          Show this help message and exit.
+            --reset                         Clear any previously-persisted custom config path and
+                                            revert the Metro/Babel transformer to the default
+                                            dynatrace.config.js lookup. Use this if you previously
+                                            ran with config="..." and want to go back to the default.
             config="/custom/path/to/dynatrace.config.js"
                                             Specify a custom path to the Dynatrace configuration file.
                                             Default: ${PathsConstants_1.default.getConfigFilePath()}
@@ -38,14 +42,13 @@ const logHelpMessage = () => {
             npx instrumentDynatrace config="/custom/path/to/dynatrace.config.js"
             npx instrumentDynatrace gradle="/custom/path/to/build.gradle"
             npx instrumentDynatrace plist="/custom/path/to/Info.plist"
+            npx instrumentDynatrace --reset
         `, Logger_1.default.INFO);
 };
 const persistCustomArguments = (argv) => {
-    if (argv.isEmpty()) {
-        (0, CustomArgumentUtil_1.clearCustomArguments)();
-        return;
+    if (!argv.isEmpty()) {
+        (0, CustomArgumentUtil_1.writeCustomArguments)(argv);
     }
-    (0, CustomArgumentUtil_1.writeCustomArguments)(argv);
 };
 const resolveInstrumentationPaths = (argv) => {
     let pathToConfig = PathsConstants_1.default.getConfigFilePath();
@@ -140,6 +143,11 @@ const instrumentCommand = () => {
         logHelpMessage();
         return;
     }
+    if (commandArgs.includes('--reset')) {
+        (0, CustomArgumentUtil_1.clearCustomArguments)();
+        Logger_1.default.logMessageSync('✅ Custom config path cleared. Metro/Babel transformer will use dynatrace.config.js.', Logger_1.default.INFO);
+        return;
+    }
     Logger_1.default.logMessageSync('⏳ Starting instrumentation of React Native application ..', Logger_1.default.INFO);
     Logger_1.default.withPrefix({ info: '  ℹ️  ', warning: '  ⚠️  ' }, () => (0, InstrumentUtil_1.showVersionOfPlugin)());
     const argv = (0, CustomArgumentUtil_1.parseCommandLine)(commandArgs.slice(2));

package/src/lib/core/interface/NativeDynatraceBridge.ts

@@ -54,7 +54,6 @@ export interface Spec extends TurboModule {
         platform?: string,
     ): void;
 
-    // eslint-disable-next-line max-len
     reportCrash(
         errorName: string,
         reason: string,
@@ -123,6 +122,40 @@ export interface Spec extends TurboModule {
         appStartKeys: string[],
     ): void;
 
+    setAutomaticUserActionDetection(enabled: boolean): void;
+
+    createUserAction(
+        actionId: string,
+        name: string,
+        completeAutomatically: boolean,
+        properties?: UnsafeObject | null,
+    ): void;
+
+    addEventStringPropertyToUserAction(
+        actionId: string,
+        key: string,
+        value: string,
+    ): void;
+
+    addEventDoublePropertyToUserAction(
+        actionId: string,
+        key: string,
+        value: number,
+    ): void;
+
+    addEventBooleanPropertyToUserAction(
+        actionId: string,
+        key: string,
+        value: boolean,
+    ): void;
+
+    completeUserAction(actionId: string): void;
+
+    setCompleteUserActionAutomatically(
+        actionId: string,
+        enabled: boolean,
+    ): void;
+
     setGPSLocation(
         latitude: number,
         longitude: number,

package/types.d.ts

@@ -1113,6 +1113,20 @@ declare class ExceptionEventData implements IExceptionEventData {
     toJSON(): JSONObject | null;
 }
 
+interface UserAction {
+    getCustomName(): string;
+    isCompleteAutomatically(): boolean;
+    setCompleteAutomatically(enabled: boolean): void;
+    complete(): void;
+    addEventProperty(key: string, value: string | number | boolean): void;
+}
+
+declare class UserActionConfiguration {
+    readonly customName: string;
+    readonly completeAutomatically: boolean;
+    constructor(customName: string, completeAutomatically?: boolean);
+}
+
 interface IDynatrace$1 {
     /**
      * Adds an event modifier that is executed just before the event is transferred.
@@ -1348,6 +1362,19 @@ interface IDynatrace$1 {
      * ```
      */
     generateTraceContext(traceparent?: TraceparentHeader, tracestate?: string): TraceContext | undefined;
+    /**
+     * Creates a new manual user action.
+     *
+     * @param configuration The user action configuration
+     * @returns A new {@link UserAction} instance
+     */
+    createUserAction(configuration: UserActionConfiguration): UserAction;
+    /**
+     * Enables or disables automatic user action detection.
+     *
+     * @param enabled True to enable, false to disable
+     */
+    setAutomaticUserActionDetection(enabled: boolean): void;
 }
 
 /**
@@ -2504,5 +2531,5 @@ declare module 'react' {
     }
 }
 
-export { ConfigurationBuilder, DataCollectionLevel, Dynatrace, DynatraceWebRequestTiming, EventData, ExceptionEventData, HttpRequestEventData, LogLevel, ManualStartupConfiguration, Platform, SessionPropertyEventData, UserPrivacyOptions };
-export type { DynatraceUserConfiguration, IConfiguration, IDynatraceAction, IDynatraceRootAction, IDynatraceWebRequestTiming, IEventModifier, JSONObject };
+export { ConfigurationBuilder, DataCollectionLevel, Dynatrace, DynatraceWebRequestTiming, EventData, ExceptionEventData, HttpRequestEventData, LogLevel, ManualStartupConfiguration, Platform, SessionPropertyEventData, UserActionConfiguration, UserPrivacyOptions };
+export type { DynatraceUserConfiguration,IConfiguration, IDynatraceAction, IDynatraceRootAction, IDynatraceWebRequestTiming, IEventModifier, JSONObject, UserAction };