@dynatrace/cordova-plugin 2.329.1 → 2.333.1

package/files/iOS/Dynatrace.xcframework/ios-arm64_x86_64-simulator/Dynatrace.framework/Headers/Dynatrace.h

@@ -1,5 +1,5 @@
 // Dynatrace.h
-// Version: 8.329.1.1017
+// Version: 8.333.1.1005
 //
 // These materials contain confidential information and
 // trade secrets of Dynatrace Corporation. You shall
@@ -528,42 +528,6 @@ typedef NS_ENUM(int, DTX_StatusCode) {
 
 @end
 
-/*************************************************************************************************/
-
-/*! 
- @brief Encapsulates contextual data for a single captured web request.
- @property request The request associated with the web request event.
- @property response The response returned by the server. Nil if no response was obtained.
- @property responseBody Raw response body data (may be nil or truncated based on configuration).
- @property error Transport or protocol error if the request failed. Nil on success.
-*/
-
-@interface DTXHttpRequestEventContext : NSObject
-
-@property (nonatomic, strong, readonly, nonnull) NSURLRequest *request;
-@property (nonatomic, strong, readonly, nullable) NSURLResponse *response;
-@property (nonatomic, strong, readonly, nullable) NSData *responseBody;
-@property (nonatomic, strong, readonly, nullable) NSError *error;
-
-/**
- @brief Designated initializer.
-
- @param request The NSURLRequest associated with the event.
- @param response The NSURLResponse (if available) or nil.
- @param responseBody The raw body payload (if available) or nil.
- @param error The error encountered (nil for successful responses).
- */
-- (instancetype _Nonnull)initWithRequest:(NSURLRequest *_Nonnull)request
-                        response:(NSURLResponse * _Nullable)response
-                    responseBody:(NSData * _Nullable)responseBody
-                           error:(NSError * _Nullable)error;
-
-/// Unavailable. Use the designated initializer.
-- (instancetype _Nonnull)init NS_UNAVAILABLE;
-
-@end
-
-/*************************************************************************************************/
 /*!
  @brief Provides the ability to manually create custom events.
 
@@ -638,6 +602,59 @@ typedef NS_ENUM(int, DTX_StatusCode) {
 - (DTXSessionPropertyEventData* _Nonnull)addSessionProperty:(NSString* _Nonnull)property value:(id _Nullable)value;
 
 @end
+/*************************************************************************************************/
+
+/*! 
+ @brief Encapsulates contextual data for a single captured web request.
+ @property request The request associated with the web request event.
+ @property response The response returned by the server. Nil if no response was obtained.
+ @property responseBody Raw response body data (may be nil or truncated based on configuration).
+ @property error Transport or protocol error if the request failed. Nil on success.
+*/
+
+@interface DTXHttpRequestEventContext : NSObject
+
+@property (nonatomic, strong, readonly, nonnull) NSURLRequest *request;
+@property (nonatomic, strong, readonly, nullable) NSURLResponse *response;
+@property (nonatomic, strong, readonly, nullable) NSData *responseBody;
+@property (nonatomic, strong, readonly, nullable) NSError *error;
+
+/**
+ @brief Designated initializer.
+
+ @param request The NSURLRequest associated with the event.
+ @param response The NSURLResponse (if available) or nil.
+ @param responseBody The raw body payload (if available) or nil.
+ @param error The error encountered (nil for successful responses).
+ */
+- (instancetype _Nonnull)initWithRequest:(NSURLRequest *_Nonnull)request
+                        response:(NSURLResponse * _Nullable)response
+                    responseBody:(NSData * _Nullable)responseBody
+                           error:(NSError * _Nullable)error;
+
+/// Unavailable. Use the designated initializer.
+- (instancetype _Nonnull)init NS_UNAVAILABLE;
+
+@end
+/*************************************************************************************************/
+
+/*!
+ @brief Encapsulates W3C trace context headers for distributed tracing.
+ @discussion This object contains the traceparent and tracestate headers as defined by the W3C Trace Context specification.
+ Use these values to propagate trace context to downstream services by adding them as HTTP headers to outgoing requests.
+ @property traceparent The W3C traceparent header value identifying the request as part of a distributed trace.
+ @property tracestate The W3C tracestate header value containing vendor-specific trace information.
+ @seealso https://www.w3.org/TR/trace-context
+*/
+
+@interface DTXTraceContext : NSObject
+
+@property (nonatomic, strong, readonly, nonnull) NSString *traceparent;
+@property (nonatomic, strong, readonly, nonnull) NSString *tracestate;
+
+@end
+
+/*************************************************************************************************/
 
 /*!
 @brief DTXUserPrivacyOptions protocol should be implemented by objects passed to applyUserPrivacyOptions:completion: method.
@@ -991,8 +1008,7 @@ When the user optin feature is not used:
  With sendBizEvent, you can report a business event. These standalone events are being sent detached from user actions or sessions.
  The 'dt' key, as well as all 'dt.' prefixed keys are considered reserved by Dynatrace and will be stripped from the passed in attributes.
  Note: Business events are only supported on Dynatrace SaaS deployments currently.
- https://www.dynatrace.com/support/help/how-to-use-dynatrace/business-analytics/ba-events-capturing#get-business-events-from-rum
-
+ https://docs.dynatrace.com/docs/observe/business-observability/bo-events-capturing#report-business-event-rum
  @param type type of the event being sent
  @param attributes dictionary of attributes being attached to the sent event
 */
@@ -1019,7 +1035,26 @@ When the user optin feature is not used:
 + (void)sendEvent:(DTXEventData* _Nullable)data;
 
 /*!
- * @brief Sends a web request event with the fields set in the builder. Use the builder to add data to the request event.
+ * @brief Generates W3C trace context headers for distributed tracing.
+ *
+ * Creates a new trace context or enriches an existing one with Dynatrace-specific data. The returned object
+ * contains both `traceparent` and `tracestate` headers that should be added to outgoing HTTP requests.
+ *
+ * Returns `nil` when:
+ * - Capture is off (agent is not running)
+ * - Privacy settings prevent web request tagging (data collection level doesn't permit tagging)
+ * - Traffic control has disabled the current session
+ * - The provided `traceparent` is invalid or the agent cannot build a complete trace context
+ *
+ * @seealso https://www.w3.org/TR/trace-context
+ * @param traceparent The W3C `traceparent` header value identifying the web request as part of a trace, or `nil` to generate a new trace
+ * @param tracestate The existing W3C `tracestate` header value of the request, or `nil` if no other tracing vendor is used
+ * @return A `DTXTraceContext` object containing both `traceparent` and `tracestate` header values, or `nil` if the trace context cannot be created.
+ */
++ (DTXTraceContext* _Nullable)generateTraceContext:(NSString* _Nullable)traceparent tracestate:(NSString* _Nullable)tracestate; 
+
+/*!
+ * @brief Sends a web request event with the fields set in the data object. Use the data object to add data to the request event.
  *
  * The keys of the fields added via addEventProperty() have to be prefixed with `event_properties.` in order to be handled by the agent. All other fields will be dropped.
  *
@@ -1094,6 +1129,15 @@ When the user optin feature is not used:
  */
 + (void)sendSessionPropertyEvent:(DTXSessionPropertyEventData* _Nullable)data;
 
+/*!
+ * @brief Set the URLSession used by the agent for network requests.
+ *
+ * Note: This feature is currently only supported for Real User Monitoring powered by Grail on Dynatrace SaaS deployments.
+ *
+ * @param urlSession new URLSession to be used by the agent for network requests.
+ */
++ (void)setURLSession:(NSURLSession* _Nonnull)urlSession;
+
 @end
 #endif
 
@@ -1330,7 +1374,7 @@ extern NSString *_Nonnull const kDTXDetectRageTaps;
 @const kDTXInstrumentFrameworks
  Flag to force the agent to also look for viewControllers inside the frameworks linked with the application
 */
-extern NSString *_Nonnull const kDTXInstrumentFrameworks;
+extern NSString *_Nonnull const kDTXInstrumentFrameworks __deprecated_msg("Deprecated as of version 8.331 with no replacement, do not use this flag anymore, it will be ignored.");
 /*!
 @const kDTXUIActionNamePrivacy
  If set to true, a label or accessibility identifier of a view will be replaced by the view class name when reporting a touch event.

package/files/iOS/Dynatrace.xcframework/ios-arm64_x86_64-simulator/Dynatrace.framework/Modules/Dynatrace.swiftmodule/arm64-apple-ios-simulator.abi.json

@@ -637,14 +637,14 @@
   },
   "ConstValues": [
     {
-      "filePath": "\/opt\/agent-jenkins\/workspace\/eAgent_ios-agent_release_8.329.x\/DynatraceUEM\/Dynatrace\/SwiftUIExtensions.swift",
+      "filePath": "\/opt\/agent-jenkins\/workspace\/eAgent_ios-agent_release_8.333.x\/DynatraceUEM\/Dynatrace\/SwiftUIExtensions.swift",
       "kind": "BooleanLiteral",
       "offset": 872,
       "length": 5,
       "value": "false"
     },
     {
-      "filePath": "\/opt\/agent-jenkins\/workspace\/eAgent_ios-agent_release_8.329.x\/DynatraceUEM\/Dynatrace\/SwiftUIExtensions.swift",
+      "filePath": "\/opt\/agent-jenkins\/workspace\/eAgent_ios-agent_release_8.333.x\/DynatraceUEM\/Dynatrace\/SwiftUIExtensions.swift",
       "kind": "BooleanLiteral",
       "offset": 1543,
       "length": 4,

package/files/iOS/Dynatrace.xcframework/ios-arm64_x86_64-simulator/Dynatrace.framework/Modules/Dynatrace.swiftmodule/x86_64-apple-ios-simulator.abi.json

@@ -637,14 +637,14 @@
   },
   "ConstValues": [
     {
-      "filePath": "\/opt\/agent-jenkins\/workspace\/eAgent_ios-agent_release_8.329.x\/DynatraceUEM\/Dynatrace\/SwiftUIExtensions.swift",
+      "filePath": "\/opt\/agent-jenkins\/workspace\/eAgent_ios-agent_release_8.333.x\/DynatraceUEM\/Dynatrace\/SwiftUIExtensions.swift",
       "kind": "BooleanLiteral",
       "offset": 872,
       "length": 5,
       "value": "false"
     },
     {
-      "filePath": "\/opt\/agent-jenkins\/workspace\/eAgent_ios-agent_release_8.329.x\/DynatraceUEM\/Dynatrace\/SwiftUIExtensions.swift",
+      "filePath": "\/opt\/agent-jenkins\/workspace\/eAgent_ios-agent_release_8.333.x\/DynatraceUEM\/Dynatrace\/SwiftUIExtensions.swift",
       "kind": "BooleanLiteral",
       "offset": 1543,
       "length": 4,

package/files/iOS/Dynatrace.xcframework/ios-arm64_x86_64-simulator/Dynatrace.framework/_CodeSignature/CodeResources

@@ -10,7 +10,7 @@
 		</data>
 		<key>Headers/Dynatrace.h</key>
 		<data>
-		oxuM3/dl55c2FRqG5v1HujuNVGk=
+		zdJ4gO+nNm1T0/bim/GsNi2fDX8=
 		</data>
 		<key>Headers/DynatraceSwiftUI.h</key>
 		<data>
@@ -22,19 +22,19 @@
 		</data>
 		<key>Info.plist</key>
 		<data>
-		3WQwH8ZTXMLdNuii2876zS9WA6I=
+		/Nl+5lJt80mtRtqYtP297teqkOU=
 		</data>
 		<key>Modules/Dynatrace.swiftmodule/Project/arm64-apple-ios-simulator.swiftsourceinfo</key>
 		<data>
-		jj9Dgj3uNQVp+CAI87ymKlWWGlk=
+		TewLPRwuWR8Cqu3vzjAN3v3Y2f4=
 		</data>
 		<key>Modules/Dynatrace.swiftmodule/Project/x86_64-apple-ios-simulator.swiftsourceinfo</key>
 		<data>
-		jiuotgT150RimX/rrrBCuSQA7V4=
+		lXYJUR0wiKzSZJb9V7PsarTwkFk=
 		</data>
 		<key>Modules/Dynatrace.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<data>
-		9BZ792+mr4ycuYQPitsU/F3JxKk=
+		EsvlaOwj5cQ/D5hjq1KmHtmQxyM=
 		</data>
 		<key>Modules/Dynatrace.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
@@ -50,11 +50,11 @@
 		</data>
 		<key>Modules/Dynatrace.swiftmodule/arm64-apple-ios-simulator.swiftmodule</key>
 		<data>
-		xQyUQ77hsRld0+6rK/M7VQkL8iA=
+		j2SYmvHVFNzfkVVkdW0Bh07S9pE=
 		</data>
 		<key>Modules/Dynatrace.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<data>
-		9BZ792+mr4ycuYQPitsU/F3JxKk=
+		EsvlaOwj5cQ/D5hjq1KmHtmQxyM=
 		</data>
 		<key>Modules/Dynatrace.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
 		<data>
@@ -70,7 +70,7 @@
 		</data>
 		<key>Modules/Dynatrace.swiftmodule/x86_64-apple-ios-simulator.swiftmodule</key>
 		<data>
-		SjY5cv2dYEvVMRAs/7ub6lHUD2Y=
+		5T9KF+QyqtjwiAtc+2fsRWSekoY=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -94,7 +94,7 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			P7yzT2OtqguCQYeTvGUCxXBw2chqM+IXP1MUqvab6Vo=
+			ckC4PqSJvRxA91V5E+lHPbCp8BCMxDjlFwkdgEm9WA8=
 			</data>
 		</dict>
 		<key>Headers/DynatraceSwiftUI.h</key>
@@ -115,21 +115,21 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			Nrs3UziSBZfRqEY0j0Hrp0+0MpSgdh3HOldJuTUDXRs=
+			HC2uxRIdtgfcXekGmt9CrB39Y3lLQaPp9S9x6vqciJ8=
 			</data>
 		</dict>
 		<key>Modules/Dynatrace.swiftmodule/Project/x86_64-apple-ios-simulator.swiftsourceinfo</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			IFJjvc784/sW3r2uxNVc2davLQsAz88kYCtDZNH6Trc=
+			gy+XG7R9QSyYhL9X3r1d8Jd3IE8o+JK+zWd9ysVqJsU=
 			</data>
 		</dict>
 		<key>Modules/Dynatrace.swiftmodule/arm64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			mt6xkS+ZDunZ25NXGFsCqLzrJ+nrE52no5GzfJ2EnwM=
+			uGfS/MoxrkxX5OJ5VRPgI1lwQGDP71f5kANrRvv6Mdo=
 			</data>
 		</dict>
 		<key>Modules/Dynatrace.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface</key>
@@ -157,14 +157,14 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			I3QdlFSzwhCI7fNOwbVxHwimaz4EGN1oVboeNmH5NYw=
+			D/ABGzZNJ5013nI/sgIC7ucg1IgldmjfYIpqlyfEqjQ=
 			</data>
 		</dict>
 		<key>Modules/Dynatrace.swiftmodule/x86_64-apple-ios-simulator.abi.json</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			mt6xkS+ZDunZ25NXGFsCqLzrJ+nrE52no5GzfJ2EnwM=
+			uGfS/MoxrkxX5OJ5VRPgI1lwQGDP71f5kANrRvv6Mdo=
 			</data>
 		</dict>
 		<key>Modules/Dynatrace.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface</key>
@@ -192,7 +192,7 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			q8UW1SD8ZUpXUXnwI2DSsRUl2Ikhonn60xvw4WmgQrM=
+			sKxSHCUiH5V0l2WI1JaC6Ou0DYqklLlPJ54yz5j2NW4=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/files/iOS/Dynatrace.xcframework/tvos-arm64/Dynatrace.framework/Headers/Dynatrace.h

@@ -1,5 +1,5 @@
 // Dynatrace.h
-// Version: 8.329.1.1017
+// Version: 8.333.1.1005
 //
 // These materials contain confidential information and
 // trade secrets of Dynatrace Corporation. You shall
@@ -528,42 +528,6 @@ typedef NS_ENUM(int, DTX_StatusCode) {
 
 @end
 
-/*************************************************************************************************/
-
-/*! 
- @brief Encapsulates contextual data for a single captured web request.
- @property request The request associated with the web request event.
- @property response The response returned by the server. Nil if no response was obtained.
- @property responseBody Raw response body data (may be nil or truncated based on configuration).
- @property error Transport or protocol error if the request failed. Nil on success.
-*/
-
-@interface DTXHttpRequestEventContext : NSObject
-
-@property (nonatomic, strong, readonly, nonnull) NSURLRequest *request;
-@property (nonatomic, strong, readonly, nullable) NSURLResponse *response;
-@property (nonatomic, strong, readonly, nullable) NSData *responseBody;
-@property (nonatomic, strong, readonly, nullable) NSError *error;
-
-/**
- @brief Designated initializer.
-
- @param request The NSURLRequest associated with the event.
- @param response The NSURLResponse (if available) or nil.
- @param responseBody The raw body payload (if available) or nil.
- @param error The error encountered (nil for successful responses).
- */
-- (instancetype _Nonnull)initWithRequest:(NSURLRequest *_Nonnull)request
-                        response:(NSURLResponse * _Nullable)response
-                    responseBody:(NSData * _Nullable)responseBody
-                           error:(NSError * _Nullable)error;
-
-/// Unavailable. Use the designated initializer.
-- (instancetype _Nonnull)init NS_UNAVAILABLE;
-
-@end
-
-/*************************************************************************************************/
 /*!
  @brief Provides the ability to manually create custom events.
 
@@ -638,6 +602,59 @@ typedef NS_ENUM(int, DTX_StatusCode) {
 - (DTXSessionPropertyEventData* _Nonnull)addSessionProperty:(NSString* _Nonnull)property value:(id _Nullable)value;
 
 @end
+/*************************************************************************************************/
+
+/*! 
+ @brief Encapsulates contextual data for a single captured web request.
+ @property request The request associated with the web request event.
+ @property response The response returned by the server. Nil if no response was obtained.
+ @property responseBody Raw response body data (may be nil or truncated based on configuration).
+ @property error Transport or protocol error if the request failed. Nil on success.
+*/
+
+@interface DTXHttpRequestEventContext : NSObject
+
+@property (nonatomic, strong, readonly, nonnull) NSURLRequest *request;
+@property (nonatomic, strong, readonly, nullable) NSURLResponse *response;
+@property (nonatomic, strong, readonly, nullable) NSData *responseBody;
+@property (nonatomic, strong, readonly, nullable) NSError *error;
+
+/**
+ @brief Designated initializer.
+
+ @param request The NSURLRequest associated with the event.
+ @param response The NSURLResponse (if available) or nil.
+ @param responseBody The raw body payload (if available) or nil.
+ @param error The error encountered (nil for successful responses).
+ */
+- (instancetype _Nonnull)initWithRequest:(NSURLRequest *_Nonnull)request
+                        response:(NSURLResponse * _Nullable)response
+                    responseBody:(NSData * _Nullable)responseBody
+                           error:(NSError * _Nullable)error;
+
+/// Unavailable. Use the designated initializer.
+- (instancetype _Nonnull)init NS_UNAVAILABLE;
+
+@end
+/*************************************************************************************************/
+
+/*!
+ @brief Encapsulates W3C trace context headers for distributed tracing.
+ @discussion This object contains the traceparent and tracestate headers as defined by the W3C Trace Context specification.
+ Use these values to propagate trace context to downstream services by adding them as HTTP headers to outgoing requests.
+ @property traceparent The W3C traceparent header value identifying the request as part of a distributed trace.
+ @property tracestate The W3C tracestate header value containing vendor-specific trace information.
+ @seealso https://www.w3.org/TR/trace-context
+*/
+
+@interface DTXTraceContext : NSObject
+
+@property (nonatomic, strong, readonly, nonnull) NSString *traceparent;
+@property (nonatomic, strong, readonly, nonnull) NSString *tracestate;
+
+@end
+
+/*************************************************************************************************/
 
 /*!
 @brief DTXUserPrivacyOptions protocol should be implemented by objects passed to applyUserPrivacyOptions:completion: method.
@@ -991,8 +1008,7 @@ When the user optin feature is not used:
  With sendBizEvent, you can report a business event. These standalone events are being sent detached from user actions or sessions.
  The 'dt' key, as well as all 'dt.' prefixed keys are considered reserved by Dynatrace and will be stripped from the passed in attributes.
  Note: Business events are only supported on Dynatrace SaaS deployments currently.
- https://www.dynatrace.com/support/help/how-to-use-dynatrace/business-analytics/ba-events-capturing#get-business-events-from-rum
-
+ https://docs.dynatrace.com/docs/observe/business-observability/bo-events-capturing#report-business-event-rum
  @param type type of the event being sent
  @param attributes dictionary of attributes being attached to the sent event
 */
@@ -1019,7 +1035,26 @@ When the user optin feature is not used:
 + (void)sendEvent:(DTXEventData* _Nullable)data;
 
 /*!
- * @brief Sends a web request event with the fields set in the builder. Use the builder to add data to the request event.
+ * @brief Generates W3C trace context headers for distributed tracing.
+ *
+ * Creates a new trace context or enriches an existing one with Dynatrace-specific data. The returned object
+ * contains both `traceparent` and `tracestate` headers that should be added to outgoing HTTP requests.
+ *
+ * Returns `nil` when:
+ * - Capture is off (agent is not running)
+ * - Privacy settings prevent web request tagging (data collection level doesn't permit tagging)
+ * - Traffic control has disabled the current session
+ * - The provided `traceparent` is invalid or the agent cannot build a complete trace context
+ *
+ * @seealso https://www.w3.org/TR/trace-context
+ * @param traceparent The W3C `traceparent` header value identifying the web request as part of a trace, or `nil` to generate a new trace
+ * @param tracestate The existing W3C `tracestate` header value of the request, or `nil` if no other tracing vendor is used
+ * @return A `DTXTraceContext` object containing both `traceparent` and `tracestate` header values, or `nil` if the trace context cannot be created.
+ */
++ (DTXTraceContext* _Nullable)generateTraceContext:(NSString* _Nullable)traceparent tracestate:(NSString* _Nullable)tracestate; 
+
+/*!
+ * @brief Sends a web request event with the fields set in the data object. Use the data object to add data to the request event.
  *
  * The keys of the fields added via addEventProperty() have to be prefixed with `event_properties.` in order to be handled by the agent. All other fields will be dropped.
  *
@@ -1094,6 +1129,15 @@ When the user optin feature is not used:
  */
 + (void)sendSessionPropertyEvent:(DTXSessionPropertyEventData* _Nullable)data;
 
+/*!
+ * @brief Set the URLSession used by the agent for network requests.
+ *
+ * Note: This feature is currently only supported for Real User Monitoring powered by Grail on Dynatrace SaaS deployments.
+ *
+ * @param urlSession new URLSession to be used by the agent for network requests.
+ */
++ (void)setURLSession:(NSURLSession* _Nonnull)urlSession;
+
 @end
 #endif
 
@@ -1330,7 +1374,7 @@ extern NSString *_Nonnull const kDTXDetectRageTaps;
 @const kDTXInstrumentFrameworks
  Flag to force the agent to also look for viewControllers inside the frameworks linked with the application
 */
-extern NSString *_Nonnull const kDTXInstrumentFrameworks;
+extern NSString *_Nonnull const kDTXInstrumentFrameworks __deprecated_msg("Deprecated as of version 8.331 with no replacement, do not use this flag anymore, it will be ignored.");
 /*!
 @const kDTXUIActionNamePrivacy
  If set to true, a label or accessibility identifier of a view will be replaced by the view class name when reporting a touch event.