@pagopa/io-react-native-wallet 3.7.4 → 3.8.2

package/lib/typescript/module/client/generated/wallet-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-provider.d.ts","sourceRoot":"","sources":["../../../../../src/client/generated/wallet-provider.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/client/index.d.ts

@@ -0,0 +1,13 @@
+import { type EndpointParameters, ApiClient as WalletProviderApiClient } from "./generated/wallet-provider.js";
+export type WalletProviderClient = WalletProviderApiClient;
+export declare const getWalletProviderClient: (context: {
+    appFetch?: typeof fetch;
+    walletProviderBaseUrl: string;
+}) => WalletProviderApiClient;
+/**
+ * Function to interpolate the url when the request includes path params.
+ * The client generator expects the literal name of the param in the url
+ * and passes the actual values in a separate object.
+ */
+export declare const interpolateUrl: (url: string, params?: EndpointParameters) => string;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,kBAAkB,EAEvB,SAAS,IAAI,uBAAuB,EACrC,MAAM,gCAA6B,CAAC;AAErC,MAAM,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAwB3D,eAAO,MAAM,uBAAuB,GAAI,SAAS;IAC/C,QAAQ,CAAC,EAAE,OAAO,KAAK,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,4BAiBA,CAAC;AAKF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,EAAE,SAAS,kBAAkB,WAUtE,CAAC"}

package/lib/typescript/module/credential/index.d.ts

@@ -0,0 +1,3 @@
+import * as Offer from "./offer/index.js";
+export { Offer };
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/credential/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/credential/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,kBAAS,CAAC;AAEjC,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/lib/typescript/module/credential/issuance/api/01-evaluate-issuer-trust.d.ts

@@ -0,0 +1,22 @@
+import type { IssuerConfig } from "./IssuerConfig.js";
+export interface EvaluateIssuerTrustApi {
+    /**
+     * The Issuer trust evaluation phase.
+     * Fetch the Issuer's configuration and verify trust.
+     * @since 1.0.0
+     *
+     * @param issuerUrl The base url of the Issuer
+     * @param context.appFetch (optional) fetch api implementation. Default: built-in fetch
+     * @param context.authorizationServer (optional) Authorization Server URL selected
+     *   from a credential offer. When provided it must match one of the Credential
+     *   Issuer metadata `authorization_servers`. Only honored from v1.3.3 onwards.
+     * @returns The Issuer's configuration
+     */
+    evaluateIssuerTrust(issuerUrl: string, ctx?: {
+        appFetch?: typeof fetch;
+        authorizationServer?: string;
+    }): Promise<{
+        issuerConf: IssuerConfig;
+    }>;
+}
+//# sourceMappingURL=01-evaluate-issuer-trust.d.ts.map

package/lib/typescript/module/credential/issuance/api/01-evaluate-issuer-trust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"01-evaluate-issuer-trust.d.ts","sourceRoot":"","sources":["../../../../../../src/credential/issuance/api/01-evaluate-issuer-trust.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAgB,CAAC;AAEnD,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;;;OAWG;IACH,mBAAmB,CACjB,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,CAAC;QAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9D,OAAO,CAAC;QAAE,UAAU,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;CAC1C"}

package/lib/typescript/module/credential/issuance/api/02-start-user-authorization.d.ts

@@ -0,0 +1,53 @@
+import type { CryptoContext } from "@pagopa/io-react-native-jwt";
+import type { AuthorizationDetail } from "../../../utils/par.js";
+import type { IssuerConfig } from "./IssuerConfig.js";
+export interface StartUserAuthorizationApi {
+    /**
+     * WARNING: This function must be called after {@link evaluateIssuerTrust}. The next steam is {@link completeUserAuthorizationWithQueryMode} or {@link completeUserAuthorizationWithFormPostJwtMode}
+     *
+     * Creates and sends a PAR request to the PAR endpoint of the authorization server.
+     * This starts the authentication flow to obtain an access token.
+     * This token enables the Wallet Instance to request a digital credential from the Credential Endpoint of the Credential Issuer; when multiple credential types are passed,
+     * it is possible to use the same access token for the issuance of all requested credentials.
+     *
+     * This is an HTTP POST request containing the Wallet Instance identifier (client id), the code challenge and challenge method as specified by PKCE according to RFC 9126
+     * along with the WTE and its proof of possession (WTE-PoP).
+     * Additionally, it includes a request object, which is a signed JWT encapsulating the type of digital credential requested (authorization_details), challenge method and
+     * redirect URI for the document proof step (if L2 flow), the application session identifier on the Wallet Instance side (state), the method (query or form_post.jwt)
+     * by which the Authorization Server should transmit the Authorization Response containing the authorization code issued upon the end user's authentication (response_mode)
+     * to the Wallet Instance's Token Endpoint to obtain the Access Token, and the redirectUri of the Wallet Instance where the Authorization Response should be delivered.
+     * The redirect is achived by using a custom URL scheme that the Wallet Instance is registered to handle.
+     * @since 1.0.0
+     *
+     * @param issuerConf The issuer configuration
+     * @param credentialIds The credential configuration IDs to be requested
+     * @param proof The configuration for the proof to be used in the request: "none" for standard flows, "document" for L2+ with MRTD verification.
+     * @param context.wiaCryptoContext The Wallet Instance's cryptographic context
+     * @param context.walletInstanceAttestation: the Wallet Instance's attestation
+     * @param context.redirectUri: the redirect URI
+     * @param context.appFetch: (optional) the fetch implementation
+     * @param context.scope: (optional) the OAuth 2.0 scope, forwarded to the PAR. When the issuance is started from a Credential Offer, it comes from the `authorization_code` grant.
+     * @param context.issuerState: (optional) the issuer state, forwarded to the PAR to correlate the authorization request with the Credential Offer.
+     * @returns The URI to which the end user should be redirected to start the authentication flow, along with additional authentication parameters
+     */
+    startUserAuthorization(issuerConf: IssuerConfig, credentialIds: string[], proof: {
+        idpHinting: string;
+        proofType: "mrtd-pop";
+    } | {
+        proofType: "none";
+    }, context: {
+        appFetch?: typeof fetch;
+        issuerState?: string;
+        redirectUri: string;
+        scope?: string;
+        walletInstanceAttestation: string;
+        wiaCryptoContext: CryptoContext;
+    }): Promise<{
+        clientId: string;
+        codeVerifier: string;
+        credentialDefinition: AuthorizationDetail[];
+        issuerRequestUri: string;
+        responseMode?: string;
+    }>;
+}
+//# sourceMappingURL=02-start-user-authorization.d.ts.map

package/lib/typescript/module/credential/issuance/api/02-start-user-authorization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"02-start-user-authorization.d.ts","sourceRoot":"","sources":["../../../../../../src/credential/issuance/api/02-start-user-authorization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAgB,CAAC;AAEnD,MAAM,WAAW,yBAAyB;IACxC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,sBAAsB,CACpB,UAAU,EAAE,YAAY,EACxB,aAAa,EAAE,MAAM,EAAE,EACvB,KAAK,EACD;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,UAAU,CAAA;KAAE,GAC7C;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,EACzB,OAAO,EAAE;QACP,QAAQ,CAAC,EAAE,OAAO,KAAK,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,yBAAyB,EAAE,MAAM,CAAC;QAClC,gBAAgB,EAAE,aAAa,CAAC;KACjC,GACA,OAAO,CAAC;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;QAC5C,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;CACJ"}

package/lib/typescript/module/credential/issuance/api/03-complete-user-authorization.d.ts

@@ -0,0 +1,97 @@
+import type { CryptoContext } from "@pagopa/io-react-native-jwt";
+import type { RequestObject } from "../../../credential/presentation/api/index.js";
+import type { EvaluateDcqlQueryApi } from "../../../credential/presentation/api/06-evaluate-dcql-query.js";
+import type { AuthorizationChallengeResult, AuthorizationResult } from "../../../utils/auth.js";
+import type { Out } from "../../../utils/misc.js";
+import type { IssuerConfig } from "./IssuerConfig.js";
+export interface CompleteUserAuthorizationApi {
+    /**
+     * WARNING: This function must be called after {@link startUserAuthorization}.
+     *
+     * The generated authUrl must be used to open a browser or webview capable of catching the redirectSchema to perform a get request to the authorization endpoint.
+     * Builds the authorization URL to which the end user should be redirected to continue the authentication flow.
+     * @since 1.0.0
+     *
+     * @param issuerRequestUri the URI of the issuer where the request is sent
+     * @param clientId Identifies the current client across all the requests of the issuing flow returned by {@link startUserAuthorization}
+     * @param issuerConf The issuer configuration returned by {@link evaluateIssuerTrust}
+     * @param idpHint Unique identifier of the IDP selected by the user (optional)
+     * @returns An object containing the authorization URL
+     */
+    buildAuthorizationUrl(issuerRequestUri: string, clientId: string, issuerConf: IssuerConfig, idpHint?: string): Promise<{
+        authUrl: string;
+    }>;
+    /**
+     * Complete user authorization when the response mode is "query" and the requested credential is an Electronic Attestation of Attributes (EAA).
+     * This type of credentials requires a PID to be presented to complete the authorization process and then obtain an access token.
+     * @since 1.3.3
+     *
+     * @param requestObject The request object containing the necessary parameters for authorization.
+     * @param issuerConfig The issuer configuration returned by {@link evaluateIssuerTrust}
+     * @param evaluatedDcqlQuery The result of evaluating the request object's DCQL query against the credentials to present.
+     * @param redirectUri The client redirect URI to which the authorization server will redirect after completing the authorization process.
+     * @returns The authorization response which contains code, state and iss
+     */
+    completeEaaUserAuthorizationWithQueryMode(requestObject: RequestObject, issuerConf: IssuerConfig, evaluatedDcqlQuery: EvaluatedDcqlQuery, redirectUri: string, context?: {
+        /** Fetch api implementation. Default: built-in fetch. */
+        appFetch?: typeof fetch;
+        /** Function to fetch the final redirect uri; it allows full control on how redirects are handled. If not provided, `appFetch` is used. */
+        fetchFinalRedirectUri?: (url: string) => Promise<string | undefined>;
+    }): Promise<AuthorizationResult>;
+    /**
+     * WARNING: This function must be called after obtaining the authorization redirect URL from the webviews (SPID and CIE L3) or browser for CIEID.
+     *
+     * Complete User authorization via strong identification when the response mode is "query" and the request credential is a PersonIdentificationData.
+     * This function parses the authorization redirect URL to extract the authorization response.
+     * @since 1.0.0
+     *
+     * @param authRedirectUrl The URL to which the end user should be redirected to start the authentication flow
+     * @returns the authorization response which contains code, state and iss
+     */
+    completePidUserAuthorizationWithQueryMode(authRedirectUrl: string): Promise<AuthorizationResult>;
+    /**
+     * WARNING: This function must be called after {@link getRequestedCredentialToBePresented} and after evaluating the request object's DCQL query with {@link EvaluateDcqlQueryApi.evaluateDcqlQuery}. The next function to be called is {@link authorizeAccess}.
+     *
+     * The interface of the phase to complete User authorization via presentation of existing credentials when the response mode is "form_post.jwt".
+     * The information is obtained by performing a POST request to the endpoint received in the response_uri field of the requestObject, where the Authorization Response payload is posted.
+     * Following this,the redirect_uri from the response is used to obtain the final authorization response.
+     * @since 1.0.0
+     *
+     * @param requestObject The request object containing the necessary parameters for authorization.
+     * @param evaluatedDcqlQuery The result of evaluating the request object's DCQL query against the credentials to present.
+     * @param appFetch (optional) fetch api implementation. Default: built-in fetch
+     * @returns the authorization response which contains code, state and iss
+     * @throws {ValidationFailed} if an error while validating the response
+     */
+    completeUserAuthorizationWithFormPostJwtMode(requestObject: RequestObject, issuerConf: IssuerConfig, evaluatedDcqlQuery: EvaluatedDcqlQuery, context: {
+        appFetch?: typeof fetch;
+        wiaCryptoContext: CryptoContext;
+    }): Promise<AuthorizationResult>;
+    /**
+     * WARNING: this function must be called after obtaining the authorization redirect URL from the webviews (SPID and CIE L3) or browser for CIEID, and the PID
+     * issuance requires a MRTD PoP challenge.
+     * @since 1.0.0
+     *
+     * @param authRedirectUrl The URL to which the end user should be redirected to start the MRTD PoP validation flow
+     * @returns the authorization response which contains the challenge
+     */
+    continueUserAuthorizationWithMRTDPoPChallenge(authRedirectUrl: string): Promise<AuthorizationChallengeResult>;
+    /**
+     * WARNING: This function must be called after {@link startUserAuthorization}. The next step is evaluating the returned request object's DCQL query with {@link EvaluateDcqlQueryApi.evaluateDcqlQuery}.
+     *
+     * The interface of the phase to complete User authorization via presentation of existing credentials when the response mode is "form_post.jwt".
+     * It is used as a first step to complete the user authorization by obtaining the requested credential to be presented from the authorization server.
+     * The information is obtained by performing a GET request to the authorization endpoint with request_uri and client_id parameters.
+     * @since 1.0.0
+     *
+     * @param issuerRequestUri the URI of the issuer where the request is sent
+     * @param clientId Identifies the current client across all the requests of the issuing flow returned by {@link startUserAuthorization}
+     * @param issuerConf The issuer configuration returned by {@link evaluateIssuerTrust}
+     * @param appFetch (optional) fetch api implementation. Default: built-in fetch
+     * @returns the request object which contains the credential to be presented in order to obtain the requested credential
+     * @throws {ValidationFailed} if an error while validating the response
+     */
+    getRequestedCredentialToBePresented(issuerRequestUri: string, clientId: string, issuerConf: IssuerConfig, appFetch?: typeof fetch): Promise<RequestObject>;
+}
+export type EvaluatedDcqlQuery = Out<EvaluateDcqlQueryApi["evaluateDcqlQuery"]>;
+//# sourceMappingURL=03-complete-user-authorization.d.ts.map

package/lib/typescript/module/credential/issuance/api/03-complete-user-authorization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"03-complete-user-authorization.d.ts","sourceRoot":"","sources":["../../../../../../src/credential/issuance/api/03-complete-user-authorization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+CAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gEAA6D,CAAC;AACxG,OAAO,KAAK,EACV,4BAA4B,EAC5B,mBAAmB,EACpB,MAAM,wBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAgB,CAAC;AAEnD,MAAM,WAAW,4BAA4B;IAC3C;;;;;;;;;;;;OAYG;IACH,qBAAqB,CACnB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,YAAY,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEhC;;;;;;;;;;OAUG;IACH,yCAAyC,CACvC,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,YAAY,EACxB,kBAAkB,EAAE,kBAAkB,EACtC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QACR,yDAAyD;QACzD,QAAQ,CAAC,EAAE,OAAO,KAAK,CAAC;QACxB,0IAA0I;QAC1I,qBAAqB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;KACtE,GACA,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC;;;;;;;;;OASG;IACH,yCAAyC,CACvC,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC;;;;;;;;;;;;;OAaG;IACH,4CAA4C,CAC1C,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,YAAY,EACxB,kBAAkB,EAAE,kBAAkB,EACtC,OAAO,EAAE;QACP,QAAQ,CAAC,EAAE,OAAO,KAAK,CAAC;QACxB,gBAAgB,EAAE,aAAa,CAAC;KACjC,GACA,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAEhC;;;;;;;OAOG;IACH,6CAA6C,CAC3C,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAEzC;;;;;;;;;;;;;;OAcG;IACH,mCAAmC,CACjC,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,YAAY,EACxB,QAAQ,CAAC,EAAE,OAAO,KAAK,GACtB,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B;AAED,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC,CAAC"}

package/lib/typescript/module/credential/issuance/api/04-authorize-access.d.ts

@@ -0,0 +1,33 @@
+import type { CryptoContext } from "@pagopa/io-react-native-jwt";
+import type { IssuerConfig } from "./IssuerConfig.js";
+import type { TokenResponse } from "./types.js";
+export interface AuthorizeAccessApi {
+    /**
+     * Creates and sends the DPoP Proof JWT to be presented with the authorization code to the /token endpoint of the authorization server
+     * for requesting the issuance of an access token bound to the public key of the Wallet Instance contained within the DPoP.
+     * This enables the Wallet Instance to request a digital credential.
+     * The DPoP Proof JWT is generated according to the section 4.3 of the DPoP RFC 9449 specification.
+     * @since 1.0.0
+     *
+     * @param issuerConf The issuer configuration returned by {@link evaluateIssuerTrust}
+     * @param code The authorization code returned by {@link completeUserAuthorizationWithQueryMode} or {@link completeUserAuthorizationWithFormPost}
+     * @param redirectUri The redirect URI which is the custom URL scheme that the Wallet Instance is registered to handle
+     * @param codeVerifier The code verifier returned by {@link startUserAuthorization}
+     * @param context.walletInstanceAttestation The Wallet Instance's attestation
+     * @param context.wiaCryptoContext The Wallet Instance's crypto context
+     * @param context.dPopCryptoContext The DPoP crypto context
+     * @param context.appFetch (optional) fetch api implementation. Default: built-in fetch
+     * @return The token response containing the access token along with the token request signed with DPoP which has to be used in the {@link obtainCredential} step.
+     * @throws {ValidationFailed} if an error occurs while parsing the token response
+     * @throws {IssuerResponseError} with a specific code for more context
+     */
+    authorizeAccess(issuerConf: IssuerConfig, code: string, redirectUri: string, codeVerifier: string, context: {
+        appFetch?: typeof fetch;
+        dPopCryptoContext: CryptoContext;
+        walletInstanceAttestation: string;
+        wiaCryptoContext: CryptoContext;
+    }): Promise<{
+        accessToken: TokenResponse;
+    }>;
+}
+//# sourceMappingURL=04-authorize-access.d.ts.map

package/lib/typescript/module/credential/issuance/api/04-authorize-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"04-authorize-access.d.ts","sourceRoot":"","sources":["../../../../../../src/credential/issuance/api/04-authorize-access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAS,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;;;;;;OAkBG;IACH,eAAe,CACb,UAAU,EAAE,YAAY,EACxB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE;QACP,QAAQ,CAAC,EAAE,OAAO,KAAK,CAAC;QACxB,iBAAiB,EAAE,aAAa,CAAC;QACjC,yBAAyB,EAAE,MAAM,CAAC;QAClC,gBAAgB,EAAE,aAAa,CAAC;KACjC,GACA,OAAO,CAAC;QAAE,WAAW,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;CAC5C"}

package/lib/typescript/module/credential/issuance/api/05-obtain-credential.d.ts

@@ -0,0 +1,58 @@
+import type { CryptoContext } from "@pagopa/io-react-native-jwt";
+import type { Out } from "../../../utils/misc.js";
+import type { AuthorizeAccessApi } from "./04-authorize-access.js";
+import type { IssuerConfig } from "./IssuerConfig.js";
+import type { CredentialFormat } from "./types.js";
+export interface ObtainCredentialApi {
+    /**
+     * Obtains the credential from the issuer.
+     * The key pair of the credentialCryptoContext is used for Openid4vci proof JWT to be presented with the Access Token and the DPoP Proof JWT at the Credential Endpoint
+     * of the Credential Issuer to request the issuance of a credential linked to the public key contained in the JWT proof.
+     * The Openid4vci proof JWT incapsulates the nonce extracted from the token response from the {@link authorizeAccess} step.
+     * The credential request is sent to the Credential Endpoint of the Credential Issuer via HTTP POST with the type of the credential, its format, the access token and the JWT proof.
+     * @since 1.0.0
+     *
+     * @param issuerConf The issuer configuration returned by {@link evaluateIssuerTrust}
+     * @param accessToken The access token response returned by {@link authorizeAccess}
+     * @param clientId The client id returned by {@link startUserAuthorization}
+     * @param credentialDefinition The credential definition of the credential to be obtained returned by {@link authorizeAccess}
+     * @param context.credentialCryptoContext The crypto context used to obtain the credential
+     * @param context.dPopCryptoContext The DPoP crypto context
+     * @param context.keyAttestation (optional) The Key Attestation JWT bound to the provided credentialCryptoContext
+     * @param context.appFetch (optional) fetch api implementation. Default: built-in fetch
+     * @returns The credential response containing the credential
+     */
+    obtainCredential(issuerConf: IssuerConfig, accessToken: Out<AuthorizeAccessApi["authorizeAccess"]>["accessToken"], clientId: string, credentialDefinition: {
+        credential_configuration_id: string;
+        credential_identifier?: string;
+    }, context: {
+        appFetch?: typeof fetch;
+        credentialCryptoContext: CryptoContext;
+        dPopCryptoContext: CryptoContext;
+        keyAttestation?: string;
+    }): Promise<{
+        credential: string;
+        format: CredentialFormat;
+    }>;
+    /**
+     * Obtains a batch of credentials from the issuer.
+     * The batch includes the same credential format and dataset with different cryptographic data.
+     * For this reason, the function accepts a list of {@link CryptoContext}; the rest of the parameters are the same as {@link obtainCredential}.
+     * @since 1.3.3
+     *
+     * @returns The list of credentials issued in the batch.
+     */
+    obtainCredentialsBatch(issuerConf: IssuerConfig, accessToken: Out<AuthorizeAccessApi["authorizeAccess"]>["accessToken"], clientId: string, credentialDefinition: {
+        credential_configuration_id: string;
+        credential_identifier: string;
+    }, context: {
+        appFetch?: typeof fetch;
+        credentialCryptoContexts: CryptoContext[];
+        dPopCryptoContext: CryptoContext;
+        keyAttestation?: string;
+    }): Promise<{
+        credential: string;
+        format: CredentialFormat;
+    }[]>;
+}
+//# sourceMappingURL=05-obtain-credential.d.ts.map

package/lib/typescript/module/credential/issuance/api/05-obtain-credential.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"05-obtain-credential.d.ts","sourceRoot":"","sources":["../../../../../../src/credential/issuance/api/05-obtain-credential.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAS,CAAC;AAEhD,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;;;;OAiBG;IACH,gBAAgB,CACd,UAAU,EAAE,YAAY,EACxB,WAAW,EAAE,GAAG,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAAC,aAAa,CAAC,EACtE,QAAQ,EAAE,MAAM,EAChB,oBAAoB,EAAE;QACpB,2BAA2B,EAAE,MAAM,CAAC;QACpC,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC,EACD,OAAO,EAAE;QACP,QAAQ,CAAC,EAAE,OAAO,KAAK,CAAC;QACxB,uBAAuB,EAAE,aAAa,CAAC;QACvC,iBAAiB,EAAE,aAAa,CAAC;QACjC,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GACA,OAAO,CAAC;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,gBAAgB,CAAC;KAC1B,CAAC,CAAC;IAEH;;;;;;;OAOG;IACH,sBAAsB,CACpB,UAAU,EAAE,YAAY,EACxB,WAAW,EAAE,GAAG,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAAC,aAAa,CAAC,EACtE,QAAQ,EAAE,MAAM,EAChB,oBAAoB,EAAE;QACpB,2BAA2B,EAAE,MAAM,CAAC;QACpC,qBAAqB,EAAE,MAAM,CAAC;KAC/B,EACD,OAAO,EAAE;QACP,QAAQ,CAAC,EAAE,OAAO,KAAK,CAAC;QACxB,wBAAwB,EAAE,aAAa,EAAE,CAAC;QAC1C,iBAAiB,EAAE,aAAa,CAAC;QACjC,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GACA,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAA;KAAE,EAAE,CAAC,CAAC;CAChE"}

package/lib/typescript/module/credential/issuance/api/06-verify-and-parse-credential.d.ts

@@ -0,0 +1,40 @@
+import type { CryptoContext } from "@pagopa/io-react-native-jwt";
+import type { IssuerConfig } from "./IssuerConfig.js";
+import type { ParsedCredential } from "./types.js";
+export interface VerifyAndParseCredentialApi {
+    /**
+     * Verify and parse an encoded credential.
+     * @since 1.0.0
+     *
+     * @param issuerConf The Issuer configuration returned by {@link evaluateIssuerTrust}
+     * @param credential The encoded credential returned by {@link obtainCredential}
+     * @param credentialConfigurationId The credential configuration ID that defines the provided credential
+     * @param context.credentialCryptoContext The crypto context used to obtain the credential in {@link obtainCredential}
+     * @param context.ignoreMissingAttributes Skip error when attributes declared in the issuer configuration are not found within disclosures
+     * @param context.includeUndefinedAttributes Include attributes not explicitly declared in the issuer configuration
+     * @returns A parsed credential with attributes in plain value, the expiration and issuance date of the credential
+     * @throws {IoWalletError} If the credential signature is not verified with the Issuer key set
+     * @throws {IoWalletError} If the credential is not bound to the provided user key
+     * @throws {IoWalletError} If the credential data fail to parse
+     */
+    verifyAndParseCredential(issuerConf: IssuerConfig, credential: string, credentialConfigurationId: string, context: {
+        credentialCryptoContext: CryptoContext;
+        /**
+         * Do not throw an error when an attribute is not found within disclosures.
+         */
+        ignoreMissingAttributes?: boolean;
+        /**
+         * Include attributes that are not explicitly mapped in the issuer configuration.
+         */
+        includeUndefinedAttributes?: boolean;
+        /**
+         * Validate the certificate chain of the credential against the provided `x509CertRoot`.
+         */
+        validateCertificateChain?: boolean;
+    }, x509CertRoot?: string): Promise<{
+        expiration: Date;
+        issuedAt: Date | undefined;
+        parsedCredential: ParsedCredential;
+    }>;
+}
+//# sourceMappingURL=06-verify-and-parse-credential.d.ts.map

package/lib/typescript/module/credential/issuance/api/06-verify-and-parse-credential.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"06-verify-and-parse-credential.d.ts","sourceRoot":"","sources":["../../../../../../src/credential/issuance/api/06-verify-and-parse-credential.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAS,CAAC;AAEhD,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;;;;;;;OAcG;IACH,wBAAwB,CACtB,UAAU,EAAE,YAAY,EACxB,UAAU,EAAE,MAAM,EAClB,yBAAyB,EAAE,MAAM,EACjC,OAAO,EAAE;QACP,uBAAuB,EAAE,aAAa,CAAC;QACvC;;WAEG;QACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;QAClC;;WAEG;QACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;QACrC;;WAEG;QACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;KACpC,EACD,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC;QACT,UAAU,EAAE,IAAI,CAAC;QACjB,QAAQ,EAAE,IAAI,GAAG,SAAS,CAAC;QAC3B,gBAAgB,EAAE,gBAAgB,CAAC;KACpC,CAAC,CAAC;CACJ"}

package/lib/typescript/module/credential/issuance/api/IssuerConfig.d.ts

@@ -0,0 +1,90 @@
+import { z } from "zod";
+/**
+ * Common Issuer configuration, decoupled from specific IT-Wallet versions.
+ */
+export type IssuerConfig = z.infer<typeof IssuerConfig>;
+export declare const IssuerConfig: z.ZodObject<{
+    authorization_endpoint: z.ZodString;
+    authorization_servers: z.ZodOptional<z.ZodTuple<[z.ZodString], z.ZodString>>;
+    credential_configurations_supported: z.ZodRecord<z.ZodString, z.ZodIntersection<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        format: z.ZodLiteral<"dc+sd-jwt">;
+        vct: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        doctype: z.ZodString;
+        format: z.ZodLiteral<"mso_mdoc">;
+    }, z.core.$strip>], "format">, z.ZodObject<{
+        authentic_source: z.ZodOptional<z.ZodString>;
+        claims: z.ZodArray<z.ZodObject<{
+            display: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                locale: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strip>>>;
+            path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>>;
+        }, z.core.$strip>>;
+        display: z.ZodArray<z.ZodObject<{
+            locale: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        issuance_errors_supported: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+            display: z.ZodArray<z.ZodObject<{
+                description: z.ZodString;
+                locale: z.ZodString;
+                title: z.ZodString;
+            }, z.core.$strip>>;
+            status_code: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        scope: z.ZodString;
+    }, z.core.$strip>>>;
+    credential_endpoint: z.ZodString;
+    credential_issuance_batch_size: z.ZodOptional<z.ZodNumber>;
+    credential_issuer: z.ZodString;
+    encrypted_response_enc_values_supported: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    federation_entity: z.ZodObject<{
+        contacts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        endpoint_auth_signing_alg_values_supported: z.ZodOptional<z.ZodString>;
+        federation_fetch_endpoint: z.ZodOptional<z.ZodString>;
+        federation_historical_keys_endpoint: z.ZodOptional<z.ZodString>;
+        federation_list_endpoint: z.ZodOptional<z.ZodString>;
+        federation_resolve_endpoint: z.ZodOptional<z.ZodString>;
+        federation_trust_mark_endpoint: z.ZodOptional<z.ZodString>;
+        federation_trust_mark_list_endpoint: z.ZodOptional<z.ZodString>;
+        federation_trust_mark_status_endpoint: z.ZodOptional<z.ZodString>;
+        homepage_uri: z.ZodOptional<z.ZodString>;
+        logo_uri: z.ZodOptional<z.ZodString>;
+        organization_name: z.ZodOptional<z.ZodString>;
+        policy_uri: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    keys: z.ZodArray<z.ZodObject<{
+        alg: z.ZodOptional<z.ZodString>;
+        crv: z.ZodOptional<z.ZodString>;
+        d: z.ZodOptional<z.ZodString>;
+        dp: z.ZodOptional<z.ZodString>;
+        dq: z.ZodOptional<z.ZodString>;
+        e: z.ZodOptional<z.ZodString>;
+        ext: z.ZodOptional<z.ZodBoolean>;
+        k: z.ZodOptional<z.ZodString>;
+        key_ops: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        kid: z.ZodOptional<z.ZodString>;
+        kty: z.ZodEnum<{
+            RSA: "RSA";
+            EC: "EC";
+        }>;
+        n: z.ZodOptional<z.ZodString>;
+        p: z.ZodOptional<z.ZodString>;
+        q: z.ZodOptional<z.ZodString>;
+        qi: z.ZodOptional<z.ZodString>;
+        use: z.ZodOptional<z.ZodString>;
+        x: z.ZodOptional<z.ZodString>;
+        x5c: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        x5t: z.ZodOptional<z.ZodString>;
+        "x5t#S256": z.ZodOptional<z.ZodString>;
+        x5u: z.ZodOptional<z.ZodString>;
+        y: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    nonce_endpoint: z.ZodString;
+    pushed_authorization_request_endpoint: z.ZodString;
+    response_modes_supported: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    status_assertion_endpoint: z.ZodOptional<z.ZodString>;
+    token_endpoint: z.ZodString;
+}, z.core.$strip>;
+//# sourceMappingURL=IssuerConfig.d.ts.map

package/lib/typescript/module/credential/issuance/api/IssuerConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IssuerConfig.d.ts","sourceRoot":"","sources":["../../../../../../src/credential/issuance/api/IssuerConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqDxB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AACxD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBvB,CAAC"}

package/lib/typescript/module/credential/issuance/api/index.d.ts

@@ -0,0 +1,15 @@
+import { type EvaluateIssuerTrustApi } from "./01-evaluate-issuer-trust.js";
+import { type StartUserAuthorizationApi } from "./02-start-user-authorization.js";
+import { type CompleteUserAuthorizationApi } from "./03-complete-user-authorization.js";
+import { type AuthorizeAccessApi } from "./04-authorize-access.js";
+import { type ObtainCredentialApi } from "./05-obtain-credential.js";
+import { type VerifyAndParseCredentialApi } from "./06-verify-and-parse-credential.js";
+import { type MRTDPoPApi } from "./mrtd-pop/index.js";
+export interface IssuanceApi extends AuthorizeAccessApi, CompleteUserAuthorizationApi, EvaluateIssuerTrustApi, ObtainCredentialApi, StartUserAuthorizationApi, VerifyAndParseCredentialApi {
+    MRTDPoP: MRTDPoPApi;
+}
+export type { EvaluatedDcqlQuery } from "./03-complete-user-authorization.js";
+export type { IssuerConfig } from "./IssuerConfig.js";
+export type * as MRTDPoP from "./mrtd-pop/index.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/credential/issuance/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/credential/issuance/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,+BAA4B,CAAC;AACzE,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,kCAA+B,CAAC;AAC/E,OAAO,EAAE,KAAK,4BAA4B,EAAE,MAAM,qCAAkC,CAAC;AACrF,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAAuB,CAAC;AAChE,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,2BAAwB,CAAC;AAClE,OAAO,EAAE,KAAK,2BAA2B,EAAE,MAAM,qCAAkC,CAAC;AACpF,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAY,CAAC;AAE7C,MAAM,WAAW,WACf,SAAQ,kBAAkB,EACxB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,2BAA2B;IAC7B,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,YAAY,EAAE,kBAAkB,EAAE,MAAM,qCAAkC,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAgB,CAAC;AACnD,YAAY,KAAK,OAAO,MAAM,qBAAY,CAAC;AAC3C,mBAAmB,YAAS,CAAC"}

package/lib/typescript/module/credential/issuance/api/mrtd-pop/index.d.ts

@@ -0,0 +1,74 @@
+import type { CryptoContext } from "@pagopa/io-react-native-jwt";
+import type { IssuerConfig } from "../IssuerConfig.js";
+import type { IasPayload, MrtdPayload, MrtdPoPChallenge, MrtdPopVerificationResult, MrtdProofChallengeInfo } from "./types.js";
+export interface MRTDPoPApi {
+    /**
+     * WARNING: This function must be called after {@link validateChallenge}. The generated authUrl must be used to open a browser or webview capable of catching the redirectSchema to perform a get request to the authorization endpoint.
+     * Builds the callback URL to which the end user should be redirected to continue the authentication flow after the MRTD challenge validation.
+     * @param redirectUri - The redirect URI provided by the issuer after the challenge validation to continue the authentication flow.
+     * @param valPopNonce - The MRTD validation PoP nonce obtained from the challenge validation response.
+     * @param authSession - The MRTD authentication session identifier used for session binding.
+     * @returns An object containing the callback URL
+     */
+    buildChallengeCallbackUrl(redirectUri: string, valPopNonce: string, authSession: string): Promise<{
+        callbackUrl: string;
+    }>;
+    /**
+     * Initializes the MRTD challenge with the data received from the issuer after the primary authentication.
+     * This function must be called after {@link verifyAndParseChallengeInfo}.
+     *
+     * @param issuerConf - The issuer configuration containing the JWKS for signature verification.
+     * @param initUrl - The endpoint to call to initialize the challenge.
+     * @param mrtd_auth_session - Session identifier for session binding obtained from the MRTD Proof JWT.
+     * @param mrtd_pop_jwt_nonce - Nonce value obtained from the MRTD Proof JWT.
+     * @param context - The context containing the WIA crypto context used to retrieve the client public key,
+     * the wallet instance attestation and an optional fetch implementation.
+     * @returns The payload of the MRTD PoP Challenge JWT.
+     */
+    initChallenge(issuerConf: IssuerConfig, initUrl: string, mrtd_auth_session: string, mrtd_pop_jwt_nonce: string, context: {
+        appFetch?: typeof fetch;
+        walletInstanceAttestation: string;
+        wiaCryptoContext: CryptoContext;
+    }): Promise<MrtdPoPChallenge>;
+    /**
+     * Validates the MRTD signed challenge by sending the MRTD and IAS payloads to the issuer.
+     * This function must be called after {@link initChallenge} and after obtaining the MRTD and IAS payloads
+     * through the CIE PACE process.
+     *
+     * @param issuerConf - The issuer configuration containing the JWKS for signature verification.
+     * @param verifyUrl - The endpoint to call to validate the challenge.
+     * @param mrtd_auth_session - Session identifier for session binding obtained from the MRTD Proof JWT.
+     * @param mrtd_pop_nonce - Nonce value obtained from the MRTD Proof JWT.
+     * @param mrtd - MRTD validation data containing Data Groups and SOD.
+     * @param ias - IAS validation data containing Anti-Cloning Public Key, and SOD.
+     * @param context - The context containing the WIA crypto context used to retrieve the client public key,
+     * the wallet instance attestation and an optional fetch implementation.
+     * @returns The MRTD PoP Verification Result containing the validation nonce and redirect URI to complete the flow.
+     */
+    validateChallenge(issuerConf: IssuerConfig, verifyUrl: string, mrtd_auth_session: string, mrtd_pop_nonce: string, mrtd: MrtdPayload, ias: IasPayload, context: {
+        appFetch?: typeof fetch;
+        walletInstanceAttestation: string;
+        wiaCryptoContext: CryptoContext;
+    }): Promise<MrtdPopVerificationResult>;
+    /**
+     * Verifies and parses the payload of a MRTD Proof Challenge Info JWT obtained after the primary authentication.
+     *
+     * This function performs the following steps:
+     * 1. Validates the JWT signature using the issuer's JWKS.
+     * 2. Decodes the JWT and parses its structure according to the {@link MrtdProofChallengeInfo} schema.
+     * 3. Verifies that the `aud` claim matches the client's public key ID.
+     * 4. Checks that the JWT is not expired and was not issued in the future.
+     *
+     * @param issuerConf - The issuer configuration containing the JWKS for signature verification.
+     * @param challengeInfoJwt - The JWT string representing the MRTD Proof Challenge Info.
+     * @param context - The context containing the WIA crypto context used to retrieve the client public key.
+     * @returns The parsed payload of the MRTD Proof Challenge Info JWT.
+     * @throws {Error} If the JWT signature is invalid, the structure is malformed, the `aud` claim does not match,
+     * or the JWT is expired/not yet valid.
+     */
+    verifyAndParseChallengeInfo(issuerConf: IssuerConfig, challengeInfoJwt: string, context: {
+        wiaCryptoContext: CryptoContext;
+    }): Promise<MrtdProofChallengeInfo>;
+}
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/credential/issuance/api/mrtd-pop/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/credential/issuance/api/mrtd-pop/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAiB,CAAC;AACpD,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,YAAS,CAAC;AAEjB,MAAM,WAAW,UAAU;IACzB;;;;;;;OAOG;IACH,yBAAyB,CACvB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEpC;;;;;;;;;;;OAWG;IACH,aAAa,CACX,UAAU,EAAE,YAAY,EACxB,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,EACzB,kBAAkB,EAAE,MAAM,EAC1B,OAAO,EAAE;QACP,QAAQ,CAAC,EAAE,OAAO,KAAK,CAAC;QACxB,yBAAyB,EAAE,MAAM,CAAC;QAClC,gBAAgB,EAAE,aAAa,CAAC;KACjC,GACA,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE7B;;;;;;;;;;;;;;OAcG;IACH,iBAAiB,CACf,UAAU,EAAE,YAAY,EACxB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,UAAU,EACf,OAAO,EAAE;QACP,QAAQ,CAAC,EAAE,OAAO,KAAK,CAAC;QACxB,yBAAyB,EAAE,MAAM,CAAC;QAClC,gBAAgB,EAAE,aAAa,CAAC;KACjC,GACA,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAEtC;;;;;;;;;;;;;;;OAeG;IACH,2BAA2B,CACzB,UAAU,EAAE,YAAY,EACxB,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE;QACP,gBAAgB,EAAE,aAAa,CAAC;KACjC,GACA,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACpC;AAED,cAAc,YAAS,CAAC"}

package/lib/typescript/module/credential/issuance/api/mrtd-pop/types.d.ts

@@ -0,0 +1,34 @@
+export interface IasPayload {
+    challenge_signed: string;
+    ias_pk: string;
+    sod_ias: string;
+}
+export interface MrtdPayload {
+    dg1: string;
+    dg11: string;
+    sod_mrtd: string;
+}
+export interface MrtdPoPChallenge {
+    challenge: string;
+    mrtd_pop_nonce: string;
+    mrz?: string;
+    pop_verify_endpoint: string;
+}
+export interface MrtdPopVerificationResult {
+    mrtd_val_pop_nonce: string;
+    redirect_uri: string;
+}
+export interface MrtdProofChallengeInfo {
+    aud: string;
+    exp: number;
+    htm: "POST";
+    htu: string;
+    iat: number;
+    iss: string;
+    mrtd_auth_session: string;
+    mrtd_pop_jwt_nonce: string;
+    state: string;
+    status: "require_interaction";
+    type: "mrtd+ias";
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/module/credential/issuance/api/mrtd-pop/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../src/credential/issuance/api/mrtd-pop/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,qBAAqB,CAAC;IAC9B,IAAI,EAAE,UAAU,CAAC;CAClB"}