rename par method to authorizeWithPAR for clarity and consistency

Author: subhankarmaiti

EXAMPLES.md

@@ -314,7 +314,7 @@ The PAR flow requires coordination between your backend (BFF) and the mobile app
 val requestUri = yourBffClient.initiatePAR(scope, audience)
 
 // Step 2 & 3: SDK opens browser and returns authorization code
-WebAuthProvider.par(account)
+WebAuthProvider.authorizeWithPAR(account)
     .start(context, requestUri, object : Callback<AuthorizationCode, AuthenticationException> {
         override fun onSuccess(result: AuthorizationCode) {
             // Step 4: Send code to BFF to exchange for tokens
@@ -340,7 +340,7 @@ try {
     val requestUri = yourBffClient.initiatePAR(scope, audience)
 
     // Step 2 & 3: SDK opens browser and returns authorization code
-    val authCode = WebAuthProvider.par(account)
+    val authCode = WebAuthProvider.authorizeWithPAR(account)
         .await(context, requestUri)
 
     // Step 4: Send code to BFF to exchange for tokens

auth0/src/main/java/com/auth0/android/provider/WebAuthProvider.kt

@@ -89,7 +89,7 @@ public object WebAuthProvider : SenderConstraining<WebAuthProvider> {
      * @return a new PARBuilder instance to customize.
      */
     @JvmStatic
-    public fun par(account: Auth0): PARBuilder {
+    public fun authorizeWithPAR(account: Auth0): PARBuilder {
         return PARBuilder(account)
     }
 
@@ -671,7 +671,7 @@ public object WebAuthProvider : SenderConstraining<WebAuthProvider> {
      *
      * Example usage:
      * ```kotlin
-     * WebAuthProvider.par(account)
+     * WebAuthProvider.authorizeWithPAR(account)
      *     .start(context, requestURI, callback)
      * ```
      */

auth0/src/test/java/com/auth0/android/provider/PARCodeManagerTest.kt

@@ -6,7 +6,7 @@ import android.net.Uri
 import com.auth0.android.Auth0
 import com.auth0.android.authentication.AuthenticationException
 import com.auth0.android.callback.Callback
-import com.auth0.android.provider.WebAuthProvider.par
+import com.auth0.android.provider.WebAuthProvider.authorizeWithPAR
 import com.auth0.android.provider.WebAuthProvider.resume
 import com.auth0.android.request.internal.ThreadSwitcherShadow
 import com.auth0.android.result.AuthorizationCode
@@ -69,7 +69,7 @@ public class PARCodeManagerTest {
 
     @Test
     public fun shouldStartPARFlowWithCorrectAuthorizeUri() {
-        par(account)
+        authorizeWithPAR(account)
             .start(activity, REQUEST_URI, callback)
 
         Assert.assertNotNull(WebAuthProvider.managerInstance)
@@ -87,7 +87,7 @@ public class PARCodeManagerTest {
 
     @Test
     public fun shouldResumeWithValidCode() {
-        par(account)
+        authorizeWithPAR(account)
             .start(activity, REQUEST_URI, callback)
 
         verify(activity).startActivity(intentCaptor.capture())
@@ -105,7 +105,7 @@ public class PARCodeManagerTest {
 
     @Test
     public fun shouldFailWithMissingCode() {
-        par(account)
+        authorizeWithPAR(account)
             .start(activity, REQUEST_URI, callback)
 
         verify(activity).startActivity(intentCaptor.capture())
@@ -123,7 +123,7 @@ public class PARCodeManagerTest {
 
     @Test
     public fun shouldFailWithErrorResponse() {
-        par(account)
+        authorizeWithPAR(account)
             .start(activity, REQUEST_URI, callback)
 
         verify(activity).startActivity(intentCaptor.capture())
@@ -141,7 +141,7 @@ public class PARCodeManagerTest {
 
     @Test
     public fun shouldHandleCanceledAuthentication() {
-        par(account)
+        authorizeWithPAR(account)
             .start(activity, REQUEST_URI, callback)
 
         verify(activity).startActivity(intentCaptor.capture())
@@ -167,7 +167,7 @@ public class PARCodeManagerTest {
             null
         )
 
-        par(account)
+        authorizeWithPAR(account)
             .start(activity, REQUEST_URI, callback)
 
         verify(callback).onFailure(authExceptionCaptor.capture())