Telemetry implemented (#29)

* Telemetry implemented

* Fixed testcase bugs

* Updated Telemetry implementation to match the product requirements for Beta

* Updated Agents.md file and removed unused function & updated tests accordingly

* Updated AGENTS.md lint enforcement rule since it would have had no effect

Author: Sudhanshu96

AGENTS.md

@@ -143,6 +143,39 @@ This SDK uses **Universal Login** for MFA step-up flows. When an MFA-required er
 
 See [Auth0.swift documentation](https://github.com/auth0/Auth0.swift) for detailed setup.
 
+## MyAccount API Client — Required Pattern
+
+**All My Account API calls MUST use `MyAccountClientFactory.create()` instead of calling `Auth0.myAccount()` directly.**
+
+This factory attaches the `Auth0-Client` HTTP header that identifies requests as originating from the UI Components SDK. The library name and version are defined centrally in `Auth0UniversalComponents/Version.swift`:
+
+```swift
+// Version.swift
+let version = "1.0.0"
+let libraryName = "universal-components-ios"
+```
+
+### Correct Usage
+
+```swift
+// In any UseCase
+let client = MyAccountClientFactory.create(
+    token: apiCredentials.accessToken,
+    domain: dependencies.domain,
+    session: session
+)
+let result = try await client.authenticationMethods.enrollTOTP().start()
+```
+
+### Incorrect Usage (will trigger SwiftLint error)
+
+```swift
+// DO NOT use Auth0.myAccount() directly — this bypasses telemetry headers
+let client = Auth0.myAccount(token: token, domain: domain, session: session)
+```
+
+---
+
 ## Key Technical Decisions
 
 ### UI Framework Support

Auth0UniversalComponents/Auth0UniversalComponentsSDKInitializer.swift

@@ -142,12 +142,6 @@ public actor Auth0UniversalComponentsSDKInitializer {
                                     tokenProvider: tokenProvider)
     }
 
-    /// Reset the SDK to an uninitialized state.
-    ///
-    /// This is primarily used for testing purposes to clear the singleton instance.
-    static func reset() {
-        _shared = nil
-    }
 }
 
 /// Ensures a URL string has an HTTPS scheme.

Auth0UniversalComponents/AuthMethodsHome/Domain/GetAuthMethodsUseCase.swift

@@ -45,7 +45,7 @@ struct GetAuthMethodsUseCase: GetAuthMethodsUseCaseable {
     /// - Returns: Array of enrolled authentication methods
     /// - Throws: Auth0APIError if the request fails
     func execute(request: GetAuthMethodsRequest) async throws -> [AuthenticationMethod] {
-        try await Auth0.myAccount(token: request.token, domain: request.domain, session: session)
+        try await MyAccountClientFactory.create(token: request.token, domain: request.domain, session: session)
             .authenticationMethods
             .getAuthenticationMethods()
             .start()

Auth0UniversalComponents/AuthMethodsHome/Domain/GetFactorsUseCase.swift

@@ -45,7 +45,7 @@ struct GetFactorsUseCase: GetFactorsUseCaseable {
     /// - Returns: Array of available authentication factors
     /// - Throws: Auth0APIError if the request fails
     func execute(request: GetFactorsRequest) async throws -> [Factor] {
-        try await Auth0.myAccount(token: request.token, domain: request.domain, session: session)
+        try await MyAccountClientFactory.create(token: request.token, domain: request.domain, session: session)
             .authenticationMethods
             .getFactors()
             .start()

Auth0UniversalComponents/AuthMethodsHome/Presentation/MyAccountAuthMethodsViewModel.swift

@@ -1,4 +1,5 @@
 import Combine
+import Foundation
 import SwiftUI
 import Auth0
 

Auth0UniversalComponents/Core/Telemetry/MyAccountClientFactory.swift

@@ -0,0 +1,21 @@
+import Auth0
+import Foundation
+
+/// Factory for creating MyAccount API clients with telemetry pre-applied.
+///
+/// All UseCases should use this factory instead of calling `Auth0.myAccount()` directly.
+/// This ensures the `Auth0-Client` header identifies requests as originating from
+/// the UI Components SDK.
+struct MyAccountClientFactory {
+    static func create(token: String, domain: String, session: URLSession = .shared) -> MyAccount {
+        var client = Auth0.myAccount(token: token, domain: domain, session: session)
+        client.using(inLibrary: libraryName, version: version)
+        return client
+    }
+
+    static func create(token: String, domain: String) -> MyAccount {
+        var client = Auth0.myAccount(token: token, domain: domain)
+        client.using(inLibrary: libraryName, version: version)
+        return client
+    }
+}

Auth0UniversalComponents/Core/Utils/ErrorHandler.swift

@@ -197,4 +197,5 @@ struct ErrorHandler {
             retryCallback()
         }
     }
+
 }

Auth0UniversalComponents/EmailSMSEnrollment/Domain/ConfirmEmailEnrollmentUseCase.swift

@@ -61,7 +61,7 @@ struct ConfirmEmailEnrollmentUseCase: ConfirmEmailEnrollmentUseCaseable {
     /// - Returns: The newly created email authentication method
     /// - Throws: Auth0APIError if the OTP is invalid or the request fails
     func execute(request: ConfirmEmailEnrollmentRequest) async throws -> AuthenticationMethod {
-        try await Auth0.myAccount(token: request.token, domain: request.domain, session: session)
+        try await MyAccountClientFactory.create(token: request.token, domain: request.domain, session: session)
             .authenticationMethods
             .confirmEmailEnrollment(id: request.id, authSession: request.authSession, otpCode: request.otpCode)
             .start()

Auth0UniversalComponents/EmailSMSEnrollment/Domain/ConfirmPhoneEnrollmentUseCase.swift

@@ -61,7 +61,7 @@ struct ConfirmPhoneEnrollmentUseCase: ConfirmPhoneEnrollmentUseCaseable {
     /// - Returns: The newly created phone authentication method
     /// - Throws: Auth0APIError if the OTP is invalid or the request fails
     func execute(request: ConfirmPhoneEnrollmentRequest) async throws -> AuthenticationMethod {
-        try await Auth0.myAccount(token: request.token, domain: request.domain, session: session)
+        try await MyAccountClientFactory.create(token: request.token, domain: request.domain, session: session)
             .authenticationMethods
             .confirmPhoneEnrollment(id: request.id, authSession: request.authSession, otpCode: request.otpCode)
             .start()

Auth0UniversalComponents/EmailSMSEnrollment/Domain/StartEmailEnrollmentUseCase.swift

@@ -53,7 +53,7 @@ struct StartEmailEnrollmentUseCase: StartEmailEnrollmentUseCaseable {
     /// - Returns: Email enrollment challenge with verification details
     /// - Throws: Auth0APIError if the request fails
     func execute(request: StartEmailEnrollmentRequest) async throws -> EmailEnrollmentChallenge {
-        try await Auth0.myAccount(token: request.token, domain: request.domain, session: session)
+        try await MyAccountClientFactory.create(token: request.token, domain: request.domain, session: session)
             .authenticationMethods
             .enrollEmail(emailAddress: request.email)
             .start()