refactor: fix language issues

Author: Lora Trifonova

miracl-sdk/src/main/java/com/miracl/trust/MIRACLResult.kt

@@ -1,18 +1,18 @@
 package com.miracl.trust
 
 /**
- * MIRACLResult is a class representing the MIRACLTrust SDK responses.
+ * MIRACLResult is a class representing the MIRACL Trust SDK responses.
  */
 public sealed class MIRACLResult<SUCCESS, FAIL>
 
 /**
- * MIRACLSuccess<SUCCESS, FAIL> is a success response from the MIRACLTrust SDK.
+ * MIRACLSuccess<SUCCESS, FAIL> is a success response from the MIRACL Trust SDK.
  * It provides a value of type SUCCESS.
  */
 public data class MIRACLSuccess<SUCCESS, FAIL>(val value: SUCCESS) : MIRACLResult<SUCCESS, FAIL>()
 
 /**
- * MIRACLError<SUCCESS, FAIL> is an error response from the MIRACLTrust SDK.
+ * MIRACLError<SUCCESS, FAIL> is an error response from the MIRACL Trust SDK.
  * It provides a value of type FAIL and an optional exception.
  */
 public data class MIRACLError<SUCCESS, FAIL>(val value: FAIL) : MIRACLResult<SUCCESS, FAIL>()

miracl-sdk/src/main/java/com/miracl/trust/MIRACLTrust.kt

@@ -2,25 +2,25 @@ package com.miracl.trust.authentication
 
 /** A class hierarchy that describes authentication issues. */
 public sealed class AuthenticationException(cause: Throwable? = null) : Exception(cause) {
-    /** User object passed for authentication is not valid. */
+    /** The user object passed for authentication is not valid. */
     public object InvalidUserData : AuthenticationException()
 
-    /** Could not find the session identifier in App Link. */
+    /** Could not find the session identifier in the App Link. */
     public object InvalidAppLink : AuthenticationException()
 
-    /** Could not find the session identifier in QR URL. */
+    /** Could not find the session identifier in the QR code URL. */
     public object InvalidQRCode : AuthenticationException()
 
     /** Could not find a valid projectID, qrURL, or userID in the push notification payload. */
     public object InvalidPushNotificationPayload : AuthenticationException()
 
-    /** There isn't a registered user for the provided user ID and project in the push notification payload. */
+    /** There is no registered user for the provided User ID and project in the push notification payload. */
     public object UserNotFound : AuthenticationException()
 
-    /** Pin code includes invalid symbols or pin length does not match. */
+    /** PIN code contains invalid symbols or PIN length does not match. */
     public object InvalidPin : AuthenticationException()
 
-    /** Pin not entered. */
+    /** PIN not entered. */
     public object PinCancelled : AuthenticationException()
 
     /** Invalid or expired authentication session. */
@@ -29,7 +29,7 @@ public sealed class AuthenticationException(cause: Throwable? = null) : Exceptio
     /** Invalid or expired cross-device session. */
     public object InvalidCrossDeviceSession : AuthenticationException()
 
-    /** The authentication was not successful. */
+    /** Authentication was not successful. */
     public object UnsuccessfulAuthentication : AuthenticationException()
 
     /** The user is revoked because of too many unsuccessful authentication attempts or has not been

miracl-sdk/src/main/java/com/miracl/trust/authentication/AuthenticationException.kt

@@ -13,10 +13,10 @@ import kotlin.coroutines.CoroutineContext
 import kotlin.jvm.Throws
 
 /**
- * The Configuration class is used to set up the MIRACLTrust SDK. It provides a way
+ * The Configuration class is used to set up the MIRACL Trust SDK. It provides a way
  * to customize some of the SDK components.
  *
- * Instance is created though its [Builder]
+ * Instance is created through its [Builder]
  */
 public class Configuration private constructor(
     internal val projectId: String,
@@ -107,31 +107,31 @@ public class Configuration private constructor(
             apply { this.coroutineContext = coroutineContext }
 
         /**
-         * Sets additional information that will be sent via X-MIRACL-CLIENT HTTP header.
+         * Sets additional information that will be sent via the X-MIRACL-CLIENT HTTP header.
          */
         public fun applicationInfo(applicationInfo: String): Builder =
             apply { this.applicationInfo = applicationInfo }
 
         /**
-         * Sets value of device name.
+         * Sets the value of the device name.
          */
         public fun deviceName(deviceName: String): Builder =
             apply { this.deviceNameValue = deviceName }
 
         /**
-         * Provides implementation of the [HttpRequestExecutor] interface to be used by the SDK.
+         * Provides the implementation of the [HttpRequestExecutor] interface to be used by the SDK.
          */
         public fun httpRequestExecutor(httpRequestExecutor: HttpRequestExecutor): Builder =
             apply { this.httpRequestExecutorValue = httpRequestExecutor }
 
         /**
-         * Provides implementation of the [UserStorage] interface to be used by the SDK.
+         * Provides the implementation of the [UserStorage] interface to be used by the SDK.
          */
         public fun userStorage(userStorage: UserStorage): Builder =
             apply { this.userStorage = userStorage }
 
         /**
-         * Provides implementation of the [Logger] interface to be used by the SDK.
+         * Provides the implementation of the [Logger] interface to be used by the SDK.
          */
         public fun logger(logger: Logger): Builder =
             apply { this.loggerValue = logger }
@@ -148,22 +148,22 @@ public class Configuration private constructor(
             apply { this.loggingLevel = loggingLevel }
 
         /**
-         * Sets HTTP requests connect timeout in seconds to be used by the SDK default [HttpRequestExecutor].
+         * Sets the HTTP requests connect timeout in seconds to be used by the SDK default [HttpRequestExecutor].
          *
          * The default is 10 seconds.
          * >
-         * **Has no effect if using custom HTTP request executor provided by
+         * **Has no effect if using custom the HTTP request executor provided by
          * [httpRequestExecutor(httpRequestExecutor: HttpRequestExecutor)][httpRequestExecutor]**
          */
         public fun connectTimeout(connectTimeout: Int): Builder =
             apply { this.connectTimeout = connectTimeout }
 
         /**
-         * Sets HTTP requests read timeout in seconds to be used by the SDK default [HttpRequestExecutor].
+         * Sets the HTTP requests read timeout in seconds to be used by the SDK default [HttpRequestExecutor].
          *
          * The default is 10 seconds.
          * >
-         * **Has no effect if using custom HTTP request executor provided by
+         * **Has no effect if using the custom HTTP request executor provided by
          * [httpRequestExecutor(httpRequestExecutor: HttpRequestExecutor)][httpRequestExecutor]**
          */
         public fun readTimeout(readTimeout: Int): Builder =
@@ -198,4 +198,4 @@ public class Configuration private constructor(
             return Configuration(this)
         }
     }
-}
+}

miracl-sdk/src/main/java/com/miracl/trust/configuration/Configuration.kt

@@ -3,7 +3,7 @@ package com.miracl.trust.configuration
 /** A class hierarchy that describes issues with the SDK configuration. */
 public sealed class ConfigurationException : Exception() {
 
-    /** Empty project ID. */
+    /** Empty Project ID. */
     public object EmptyProjectId : ConfigurationException()
 
     /** Invalid Project URL. */

miracl-sdk/src/main/java/com/miracl/trust/configuration/ConfigurationException.kt

@@ -4,7 +4,7 @@
 
 /**
  * An interface used to allow the MIRACLTrust SDK to request PIN. The application using
- * the SDK is responsible for obtaining the PIN from the user and then pass it
+ * the SDK is responsible for obtaining the PIN from the user and then passing it
  * to the {@link PinConsumer}.
  */
 public interface PinProvider {

miracl-sdk/src/main/java/com/miracl/trust/delegate/PinProvider.java

@@ -7,9 +7,9 @@
 import com.miracl.trust.MIRACLError;
 
 /**
- * An interface used to connect MIRACLTrust SDK output to your application.
+ * An interface used to connect the MIRACL Trust SDK output to your application.
  *
- * <p>This interface defines the {@link #onResult(MIRACLResult)} method, which handles the result of a MIRACLTrust SDK operation.
+ * <p>This interface defines the {@link #onResult(MIRACLResult)} method which handles the result of a MIRACL Trust SDK operation.
  * <b>Important:</b> Implementations of this method will be invoked on the main thread.</p>
  *
  * @param <SUCCESS> type of the value on success.
@@ -25,4 +25,4 @@ public interface ResultHandler<SUCCESS, FAIL> {
      * It can be either a {@link MIRACLSuccess} or a {@link MIRACLError}.
      */
     void onResult(@NonNull MIRACLResult<SUCCESS, FAIL> result);
-}
+}

miracl-sdk/src/main/java/com/miracl/trust/delegate/ResultHandler.java

@@ -5,7 +5,7 @@ import java.io.Serializable
 /**
  * Object representing QuickCode and its validity period.
  * @property code The issued QuickCode.
- * @property expireTime MIRACL MFA system time when the code will expire.
+ * @property expireTime MIRACL Trust MFA system time when the code will expire.
  * @property ttlSeconds The expiration period in seconds.
  */
 public class QuickCode internal constructor(
@@ -16,4 +16,4 @@ public class QuickCode internal constructor(
     override fun toString(): String {
         return "QuickCode(code=<REDACTED>, expireTime=$expireTime, ttlSeconds=$ttlSeconds"
     }
-}
+}

miracl-sdk/src/main/java/com/miracl/trust/model/QuickCode.kt

@@ -5,10 +5,10 @@ import com.miracl.trust.util.toSHA256
 
 /**
  * Object representing the user in the platform.
- * @property userId Identifier of the user. Could be email, username, etc.
- * @property projectId Required to link the user with the project on the MIRACLTrust platform.
- * @property revoked Provides information if the user is revoked or not.
- * @property pinLength The number of the digits the user PIN should be.
+ * @property userId an identifier of the user.
+ * @property projectId Required to link the user with the project on the MIRACL Trust platform.
+ * @property revoked Provides information about whether the user is revoked or not.
+ * @property pinLength The number of the digits in the user's PIN.
  */
 @Keep
 public class User internal constructor(
@@ -49,4 +49,4 @@ internal fun User.revoke(): User = User(
     token = token,
     dtas = dtas,
     publicKey = publicKey
-)
+)

miracl-sdk/src/main/java/com/miracl/trust/model/User.kt

@@ -4,7 +4,7 @@ package com.miracl.trust.network
 public sealed class ApiException(public val url: String, cause: Throwable? = null) :
     Exception(cause) {
 
-    /** Error while executing HTTP request. */
+    /** Error while executing the HTTP request. */
     public class ExecutionError internal constructor(url: String = "", cause: Throwable? = null) :
         ApiException(url, cause)