update eudi-lib-jvm-openid4vci-kt library to 0.3.1; improve logging a…

…nd support for configuration flag to enable/disable; log http request/response
niscy-eudiw · Jun 12, 2024 · 3fee450 · 3fee450
1 parent 26ad04a
commit 3fee450
Show file tree

Hide file tree

Showing 41 changed files with 296 additions and 200 deletions.
diff --git a/README.md b/README.md
@@ -103,7 +103,7 @@ file.
 
 ```groovy
 dependencies {
-    implementation "eu.europa.ec.eudi:eudi-lib-android-wallet-core:0.9.4-SNAPSHOT"
+    implementation "eu.europa.ec.eudi:eudi-lib-android-wallet-core:0.9.5-SNAPSHOT"
     implementation "androidx.biometric:biometric-ktx:1.2.0-alpha05"
 }
 ```
@@ -201,6 +201,7 @@ val config = EudiWalletConfig.Builder(applicationContext)
         useDPoP(false)
         parUsage(ParUsage.IF_SUPPORTED)
         proofTypes(Config.ProofType.JWT, Config.ProofType.CWT)
+        debugLogging(true)
     }
     .build()
 

diff --git a/changelog.md b/changelog.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.9.5-SNAPSHOT]
+
+__12 Jun 2024__
+
+- Configurable debug logging for OpenId4VCI
+
 ## [0.9.4-SNAPSHOT]
 
 __10 Jun 2024__

diff --git a/docs/wallet-core/eu.europa.ec.eudi.wallet.document/index.md b/docs/wallet-core/eu.europa.ec.eudi.wallet.document/index.md
@@ -4,6 +4,6 @@
 
 ## Types
 
-| Name                             | Summary                                                                                                            |
-|----------------------------------|--------------------------------------------------------------------------------------------------------------------|
+| Name | Summary |
+|---|---|
 | [Constants](-constants/index.md) | [androidJvm]<br>object [~~Constants~~](-constants/index.md)<br>Shared constant values for doc types and namespaces |
diff --git a/...ore/eu.europa.ec.eudi.wallet.issue.openid4vci/-offer/-offered-document/index.md b/...ore/eu.europa.ec.eudi.wallet.issue.openid4vci/-offer/-offered-document/index.md
@@ -12,6 +12,7 @@ An item to be issued.
 | Name | Summary |
 |---|---|
 | [asPair](as-pair.md) | [androidJvm]<br>fun [asPair](as-pair.md)(): [Pair](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-pair/index.html)&lt;[String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html), [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)&gt;<br>Converts this item to a pair of name and document type. |
+| [toString](to-string.md) | [androidJvm]<br>open override fun [toString](to-string.md)(): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html) |
 
 ## Properties
 

diff --git a/...eu.europa.ec.eudi.wallet.issue.openid4vci/-offer/-offered-document/to-string.md b/...eu.europa.ec.eudi.wallet.issue.openid4vci/-offer/-offered-document/to-string.md
@@ -0,0 +1,6 @@
+//[wallet-core](../../../../index.md)/[eu.europa.ec.eudi.wallet.issue.openid4vci](../../index.md)/[Offer](../index.md)/[OfferedDocument](index.md)/[toString](to-string.md)
+
+# toString
+
+[androidJvm]\
+open override fun [toString](to-string.md)(): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)
diff --git a/...penid4vci/-open-id4-vci-manager/-config/-builder/auth-flow-redirection-u-r-i.md b/...penid4vci/-open-id4-vci-manager/-config/-builder/auth-flow-redirection-u-r-i.md
@@ -11,8 +11,8 @@ Set the redirection URI for the authorization flow
 
 androidJvm
 
-|                        |                                                |
-|------------------------|------------------------------------------------|
+| | |
+|---|---|
 | authFlowRedirectionURI | the redirection URI for the authorization flow |
 
 [androidJvm]\

diff --git a/...udi.wallet.issue.openid4vci/-open-id4-vci-manager/-config/-builder/client-id.md b/...udi.wallet.issue.openid4vci/-open-id4-vci-manager/-config/-builder/client-id.md
@@ -11,8 +11,8 @@ Set the client id
 
 androidJvm
 
-|          |               |
-|----------|---------------|
+| | |
+|---|---|
 | clientId | the client id |
 
 [androidJvm]\

diff --git a/...wallet.issue.openid4vci/-open-id4-vci-manager/-config/-builder/debug-logging.md b/...wallet.issue.openid4vci/-open-id4-vci-manager/-config/-builder/debug-logging.md
@@ -0,0 +1,11 @@
+//[wallet-core](../../../../../index.md)/[eu.europa.ec.eudi.wallet.issue.openid4vci](../../../index.md)/[OpenId4VciManager](../../index.md)/[Config](../index.md)/[Builder](index.md)/[debugLogging](debug-logging.md)
+
+# debugLogging
+
+[androidJvm]\
+fun [debugLogging](debug-logging.md)(debugLogging: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)): [OpenId4VciManager.Config.Builder](index.md)
+
+Set the debug logging flag
+
+[androidJvm]\
+var [debugLogging](debug-logging.md): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)
diff --git a/...ec.eudi.wallet.issue.openid4vci/-open-id4-vci-manager/-config/-builder/index.md b/...ec.eudi.wallet.issue.openid4vci/-open-id4-vci-manager/-config/-builder/index.md
@@ -15,27 +15,29 @@ Builder to create an instance of [Config](../index.md)
 
 ## Functions
 
-| Name                                                              | Summary                                                                                                                                                                                                                                                                                                                                           |
-|-------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| [authFlowRedirectionURI](auth-flow-redirection-u-r-i.md)          | [androidJvm]<br>fun [authFlowRedirectionURI](auth-flow-redirection-u-r-i.md)(authFlowRedirectionURI: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the redirection URI for the authorization flow                                                        |
-| [build](build.md)                                                 | [androidJvm]<br>fun [build](build.md)(): [OpenId4VciManager.Config](../index.md)<br>Build the [Config](../index.md)                                                                                                                                                                                                                               |
-| [clientId](client-id.md)                                          | [androidJvm]<br>fun [clientId](client-id.md)(clientId: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the client id                                                                                                                                       |
-| [issuerUrl](issuer-url.md)                                        | [androidJvm]<br>fun [issuerUrl](issuer-url.md)(issuerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the issuer url                                                                                                                                   |
-| [parUsage](par-usage.md)                                          | [androidJvm]<br>fun [parUsage](par-usage.md)(parUsage: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the PAR usage                                                                                                                                             |
-| [proofTypes](proof-types.md)                                      | [androidJvm]<br>fun [proofTypes](proof-types.md)(vararg proofType: [OpenId4VciManager.Config.ProofType](../-proof-type/index.md)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the proof types. The supported proof types are [ProofType](../-proof-type/index.md). The order of the proof types is the order in which they will be used. |
-| [useDPoP](use-d-po-p.md)                                          | [androidJvm]<br>fun [useDPoP](use-d-po-p.md)(useDPoP: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the flag that if set will enable the use of DPoP JWT                                                                                               |
-| [useStrongBoxIfSupported](use-strong-box-if-supported.md)         | [androidJvm]<br>fun [useStrongBoxIfSupported](use-strong-box-if-supported.md)(useStrongBoxIfSupported: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the flag that if set will enable the use of StrongBox for document keys if supported              |
-| [withAuthFlowRedirectionURI](with-auth-flow-redirection-u-r-i.md) | [androidJvm]<br>fun [withAuthFlowRedirectionURI](with-auth-flow-redirection-u-r-i.md)(authFlowRedirectionURI: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)): [OpenId4VciManager.Config.Builder](index.md)                                                                                                     |
-| [withClientId](with-client-id.md)                                 | [androidJvm]<br>fun [withClientId](with-client-id.md)(clientId: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)): [OpenId4VciManager.Config.Builder](index.md)                                                                                                                                                   |
-| [withIssuerUrl](with-issuer-url.md)                               | [androidJvm]<br>fun [withIssuerUrl](with-issuer-url.md)(issuerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)): [OpenId4VciManager.Config.Builder](index.md)                                                                                                                                                |
+| Name | Summary |
+|---|---|
+| [authFlowRedirectionURI](auth-flow-redirection-u-r-i.md) | [androidJvm]<br>fun [authFlowRedirectionURI](auth-flow-redirection-u-r-i.md)(authFlowRedirectionURI: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the redirection URI for the authorization flow |
+| [build](build.md) | [androidJvm]<br>fun [build](build.md)(): [OpenId4VciManager.Config](../index.md)<br>Build the [Config](../index.md) |
+| [clientId](client-id.md) | [androidJvm]<br>fun [clientId](client-id.md)(clientId: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the client id |
+| [debugLogging](debug-logging.md) | [androidJvm]<br>fun [debugLogging](debug-logging.md)(debugLogging: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the debug logging flag |
+| [issuerUrl](issuer-url.md) | [androidJvm]<br>fun [issuerUrl](issuer-url.md)(issuerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the issuer url |
+| [parUsage](par-usage.md) | [androidJvm]<br>fun [parUsage](par-usage.md)(parUsage: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the PAR usage |
+| [proofTypes](proof-types.md) | [androidJvm]<br>fun [proofTypes](proof-types.md)(vararg proofType: [OpenId4VciManager.Config.ProofType](../-proof-type/index.md)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the proof types. The supported proof types are [ProofType](../-proof-type/index.md). The order of the proof types is the order in which they will be used. |
+| [useDPoP](use-d-po-p.md) | [androidJvm]<br>fun [useDPoP](use-d-po-p.md)(useDPoP: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the flag that if set will enable the use of DPoP JWT |
+| [useStrongBoxIfSupported](use-strong-box-if-supported.md) | [androidJvm]<br>fun [useStrongBoxIfSupported](use-strong-box-if-supported.md)(useStrongBoxIfSupported: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)): [OpenId4VciManager.Config.Builder](index.md)<br>Set the flag that if set will enable the use of StrongBox for document keys if supported |
+| [withAuthFlowRedirectionURI](with-auth-flow-redirection-u-r-i.md) | [androidJvm]<br>fun [withAuthFlowRedirectionURI](with-auth-flow-redirection-u-r-i.md)(authFlowRedirectionURI: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)): [OpenId4VciManager.Config.Builder](index.md) |
+| [withClientId](with-client-id.md) | [androidJvm]<br>fun [withClientId](with-client-id.md)(clientId: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)): [OpenId4VciManager.Config.Builder](index.md) |
+| [withIssuerUrl](with-issuer-url.md) | [androidJvm]<br>fun [withIssuerUrl](with-issuer-url.md)(issuerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)): [OpenId4VciManager.Config.Builder](index.md) |
 
 ## Properties
 
-| Name                                                      | Summary                                                                                                                                                                                                           |
-|-----------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| [authFlowRedirectionURI](auth-flow-redirection-u-r-i.md)  | [androidJvm]<br>var [authFlowRedirectionURI](auth-flow-redirection-u-r-i.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?<br>the redirection URI for the authorization flow |
-| [clientId](client-id.md)                                  | [androidJvm]<br>var [clientId](client-id.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?<br>the client id                                                                  |
-| [issuerUrl](issuer-url.md)                                | [androidJvm]<br>var [issuerUrl](issuer-url.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?<br>the issuer url                                                               |
-| [parUsage](par-usage.md)                                  | [androidJvm]<br>var [parUsage](par-usage.md): [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)<br>if PAR should be used                                                                 |
-| [useDPoPIfSupported](use-d-po-p-if-supported.md)          | [androidJvm]<br>var [useDPoPIfSupported](use-d-po-p-if-supported.md): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)<br>flag that if set will enable the use of DPoP JWT      |
+| Name | Summary |
+|---|---|
+| [authFlowRedirectionURI](auth-flow-redirection-u-r-i.md) | [androidJvm]<br>var [authFlowRedirectionURI](auth-flow-redirection-u-r-i.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?<br>the redirection URI for the authorization flow |
+| [clientId](client-id.md) | [androidJvm]<br>var [clientId](client-id.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?<br>the client id |
+| [debugLogging](debug-logging.md) | [androidJvm]<br>var [debugLogging](debug-logging.md): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)<br>flag to enable debug logging. Default is false |
+| [issuerUrl](issuer-url.md) | [androidJvm]<br>var [issuerUrl](issuer-url.md): [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html)?<br>the issuer url |
+| [parUsage](par-usage.md) | [androidJvm]<br>var [parUsage](par-usage.md): [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)<br>if PAR should be used |
+| [useDPoPIfSupported](use-d-po-p-if-supported.md) | [androidJvm]<br>var [useDPoPIfSupported](use-d-po-p-if-supported.md): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)<br>flag that if set will enable the use of DPoP JWT |
 | [useStrongBoxIfSupported](use-strong-box-if-supported.md) | [androidJvm]<br>var [useStrongBoxIfSupported](use-strong-box-if-supported.md): [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html)<br>use StrongBox for document keys if supported |
diff --git a/...di.wallet.issue.openid4vci/-open-id4-vci-manager/-config/-builder/issuer-url.md b/...di.wallet.issue.openid4vci/-open-id4-vci-manager/-config/-builder/issuer-url.md
@@ -11,8 +11,8 @@ Set the issuer url
 
 androidJvm
 
-|           |                |
-|-----------|----------------|
+| | |
+|---|---|
 | issuerUrl | the issuer url |
 
 [androidJvm]\

diff --git a/...udi.wallet.issue.openid4vci/-open-id4-vci-manager/-config/-builder/par-usage.md b/...udi.wallet.issue.openid4vci/-open-id4-vci-manager/-config/-builder/par-usage.md
@@ -3,17 +3,16 @@
 # parUsage
 
 [androidJvm]\
-fun [parUsage](par-usage.md)(
-parUsage: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)): [OpenId4VciManager.Config.Builder](index.md)
+fun [parUsage](par-usage.md)(parUsage: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html)): [OpenId4VciManager.Config.Builder](index.md)
 
 Set the PAR usage
 
 #### Parameters
 
 androidJvm
 
-|          |               |
-|----------|---------------|
+| | |
+|---|---|
 | parUsage | the PAR usage |
 
 [androidJvm]\

diff --git a/...i.wallet.issue.openid4vci/-open-id4-vci-manager/-config/-builder/proof-types.md b/...i.wallet.issue.openid4vci/-open-id4-vci-manager/-config/-builder/proof-types.md
@@ -3,22 +3,20 @@
 # proofTypes
 
 [androidJvm]\
-fun [proofTypes](proof-types.md)(vararg
-proofType: [OpenId4VciManager.Config.ProofType](../-proof-type/index.md)): [OpenId4VciManager.Config.Builder](index.md)
+fun [proofTypes](proof-types.md)(vararg proofType: [OpenId4VciManager.Config.ProofType](../-proof-type/index.md)): [OpenId4VciManager.Config.Builder](index.md)
 
-Set the proof types. The supported proof types are [ProofType](../-proof-type/index.md). The order of the proof types is
-the order in which they will be used.
+Set the proof types. The supported proof types are [ProofType](../-proof-type/index.md). The order of the proof types is the order in which they will be used.
 
 #### Parameters
 
 androidJvm
 
-|           |                 |
-|-----------|-----------------|
+| | |
+|---|---|
 | proofType | the proof types |
 
 #### Throws
 
-|                                                                                                                        |                                            |
-|------------------------------------------------------------------------------------------------------------------------|--------------------------------------------|
+| | |
+|---|---|
 | [IllegalArgumentException](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-illegal-argument-exception/index.html) | if a proof type is provided more than once |
diff --git a/...di.wallet.issue.openid4vci/-open-id4-vci-manager/-config/-builder/use-d-po-p.md b/...di.wallet.issue.openid4vci/-open-id4-vci-manager/-config/-builder/use-d-po-p.md
@@ -11,6 +11,6 @@ Set the flag that if set will enable the use of DPoP JWT
 
 androidJvm
 
-|         |                                                      |
-|---------|------------------------------------------------------|
+| | |
+|---|---|
 | useDPoP | the flag that if set will enable the use of DPoP JWT |
diff --git a/...penid4vci/-open-id4-vci-manager/-config/-builder/use-strong-box-if-supported.md b/...penid4vci/-open-id4-vci-manager/-config/-builder/use-strong-box-if-supported.md
@@ -11,8 +11,8 @@ Set the flag that if set will enable the use of StrongBox for document keys if s
 
 androidJvm
 
-|                         |                                                                                      |
-|-------------------------|--------------------------------------------------------------------------------------|
+| | |
+|---|---|
 | useStrongBoxIfSupported | the flag that if set will enable the use of StrongBox for document keys if supported |
 
 [androidJvm]\

diff --git a/...europa.ec.eudi.wallet.issue.openid4vci/-open-id4-vci-manager/-config/-config.md b/...europa.ec.eudi.wallet.issue.openid4vci/-open-id4-vci-manager/-config/-config.md
@@ -3,11 +3,4 @@
 # Config
 
 [androidJvm]\
-constructor(issuerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html),
-clientId: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html),
-authFlowRedirectionURI: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html),
-useStrongBoxIfSupported: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html),
-useDPoPIfSupported: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html),
-parUsage: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html),
-proofTypes: [List](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-list/index.html)
-&lt;[OpenId4VciManager.Config.ProofType](-proof-type/index.md)&gt;)
+constructor(issuerUrl: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html), clientId: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html), authFlowRedirectionURI: [String](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-string/index.html), useStrongBoxIfSupported: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html), useDPoPIfSupported: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html), parUsage: [Int](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-int/index.html), proofTypes: [List](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-list/index.html)&lt;[OpenId4VciManager.Config.ProofType](-proof-type/index.md)&gt;, debugLogging: [Boolean](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-boolean/index.html))