@pagopa/io-wallet-oid4vci 1.4.2 → 1.5.0

package/dist/index.mjs

@@ -196,7 +196,12 @@ async function sendAuthorizationResponseAndExtractCode(options) {
 }
 
 // src/credential-offer/extract-grant-details.ts
-function extractGrantDetails(credentialOffer) {
+import {
+  ItWalletSpecsVersion,
+  ItWalletSpecsVersionError,
+  createVersionDispatcher
+} from "@pagopa/io-wallet-utils";
+function requireAuthorizationCodeGrant(credentialOffer) {
   if (!credentialOffer.grants) {
     throw new CredentialOfferError("No grants found in credential offer");
   }
@@ -204,6 +209,10 @@ function extractGrantDetails(credentialOffer) {
   if (!authCodeGrant) {
     throw new CredentialOfferError("authorization_code grant not found");
   }
+  return authCodeGrant;
+}
+function extractGrantDetailsV1_3(options) {
+  const authCodeGrant = requireAuthorizationCodeGrant(options.credentialOffer);
   return {
     authorizationCodeGrant: {
       authorizationServer: authCodeGrant.authorization_server,
@@ -213,10 +222,37 @@ function extractGrantDetails(credentialOffer) {
     grantType: "authorization_code"
   };
 }
+function extractGrantDetailsV1_4(options) {
+  const authCodeGrant = requireAuthorizationCodeGrant(options.credentialOffer);
+  return {
+    authorizationCodeGrant: {
+      authorizationServer: authCodeGrant.authorization_server,
+      issuerState: authCodeGrant.issuer_state
+    },
+    grantType: "authorization_code"
+  };
+}
+var dispatchExtractGrantDetails = createVersionDispatcher({
+  [ItWalletSpecsVersion.V1_0]: () => {
+    throw new ItWalletSpecsVersionError(
+      "extractGrantDetails",
+      ItWalletSpecsVersion.V1_0,
+      [ItWalletSpecsVersion.V1_3, ItWalletSpecsVersion.V1_4]
+    );
+  },
+  [ItWalletSpecsVersion.V1_3]: (o) => extractGrantDetailsV1_3(o),
+  [ItWalletSpecsVersion.V1_4]: (o) => extractGrantDetailsV1_4(o)
+});
+function extractGrantDetails(options) {
+  return dispatchExtractGrantDetails(options);
+}
 
 // src/credential-offer/z-credential-offer.ts
+import { z as z4 } from "zod";
+
+// src/credential-offer/v1.3/z-credential-offer.ts
 import { z as z2 } from "zod";
-var zAuthorizationCodeGrant = z2.object({
+var zAuthorizationCodeGrantV1_3 = z2.object({
   /**
    * CONDITIONALLY REQUIRED. HTTPS URL of the Authorization Server.
    * REQUIRED only when the Credential Issuer uses multiple Authorization Servers.
@@ -234,14 +270,14 @@ var zAuthorizationCodeGrant = z2.object({
    */
   scope: z2.string()
 });
-var zCredentialOfferGrants = z2.object({
+var zCredentialOfferGrantsV1_3 = z2.object({
   /**
    * REQUIRED. Authorization Code grant details.
    * IT-Wallet v1.3 only supports authorization_code grant.
    */
-  authorization_code: zAuthorizationCodeGrant
+  authorization_code: zAuthorizationCodeGrantV1_3
 });
-var zCredentialOffer = z2.object({
+var zCredentialOfferV1_3 = z2.object({
   /**
    * REQUIRED. Array of credential configuration identifiers.
    * References the types of credentials offered as defined in the Credential Issuer metadata.
@@ -256,24 +292,66 @@ var zCredentialOffer = z2.object({
    * REQUIRED. Grant information for the credential offer.
    * IT-Wallet v1.3 requires authorization_code grant.
    */
-  grants: zCredentialOfferGrants
+  grants: zCredentialOfferGrantsV1_3
+});
+
+// src/credential-offer/v1.4/z-credential-offer.ts
+import { z as z3 } from "zod";
+var zAuthorizationCodeGrantV1_4 = z3.object({
+  /**
+   * CONDITIONALLY REQUIRED. HTTPS URL of the Authorization Server.
+   * REQUIRED only when the Credential Issuer uses multiple Authorization Servers.
+   * If present, MUST match one of the authorization_servers in the Credential Issuer metadata.
+   */
+  authorization_server: z3.url().optional(),
+  /**
+   * OPTIONAL. String value representing the issuer state.
+   * Used to correlate the authorization request with the credential offer.
+   */
+  issuer_state: z3.string().optional()
 });
-var zCredentialOfferUri = z2.object({
+var zCredentialOfferGrantsV1_4 = z3.object({
+  /**
+   * REQUIRED. Authorization Code grant details.
+   * IT-Wallet v1.4 only supports authorization_code grant.
+   */
+  authorization_code: zAuthorizationCodeGrantV1_4
+});
+var zCredentialOfferV1_4 = z3.object({
+  /**
+   * REQUIRED. Array of credential configuration identifiers.
+   * References the types of credentials offered as defined in the Credential Issuer metadata.
+   */
+  credential_configuration_ids: z3.array(z3.string()).min(1),
+  /**
+   * REQUIRED. HTTPS URL of the Credential Issuer.
+   * The Credential Issuer from which the wallet will request credentials.
+   */
+  credential_issuer: z3.url(),
+  /**
+   * REQUIRED. Grant information for the credential offer.
+   * IT-Wallet v1.4 requires authorization_code grant.
+   */
+  grants: zCredentialOfferGrantsV1_4
+});
+
+// src/credential-offer/z-credential-offer.ts
+var zCredentialOfferUri = z4.object({
   /**
    * OPTIONAL. Inline credential offer JSON (by value).
    * URL-encoded JSON string containing the credential offer.
    */
-  credential_offer: z2.string().optional(),
+  credential_offer: z4.string().optional(),
   /**
    * OPTIONAL. URL pointing to the credential offer JSON (by reference).
    * HTTPS URL where the credential offer can be fetched.
    */
-  credential_offer_uri: z2.url().optional(),
+  credential_offer_uri: z4.url().optional(),
   /**
    * URL scheme used for the credential offer.
    * Determines the invocation method.
    */
-  scheme: z2.enum(["openid-credential-offer", "haip-vci", "https"])
+  scheme: z4.enum(["openid-credential-offer", "haip-vci", "https"])
 }).refine((data) => data.credential_offer || data.credential_offer_uri, {
   message: "Either credential_offer or credential_offer_uri must be present"
 });
@@ -312,19 +390,35 @@ async function parseCredentialOfferUri(options) {
 
 // src/credential-offer/resolve-credential-offer.ts
 import {
+  ItWalletSpecsVersion as ItWalletSpecsVersion2,
+  ItWalletSpecsVersionError as ItWalletSpecsVersionError2,
   UnexpectedStatusCodeError as UnexpectedStatusCodeError2,
   createFetcher as createFetcher2,
   hasStatusOrThrow as hasStatusOrThrow2
 } from "@pagopa/io-wallet-utils";
+function parseCredentialOfferForVersion(config, data) {
+  switch (config.itWalletSpecsVersion) {
+    case ItWalletSpecsVersion2.V1_3:
+      return zCredentialOfferV1_3.parse(data);
+    case ItWalletSpecsVersion2.V1_4:
+      return zCredentialOfferV1_4.parse(data);
+    default:
+      throw new ItWalletSpecsVersionError2(
+        "resolveCredentialOffer",
+        config.itWalletSpecsVersion,
+        [ItWalletSpecsVersion2.V1_3, ItWalletSpecsVersion2.V1_4]
+      );
+  }
+}
 async function resolveCredentialOffer(options) {
-  const { callbacks, credentialOffer } = options;
+  const { callbacks, config, credentialOffer } = options;
   try {
     if (credentialOffer.startsWith("openid-credential-offer://") || credentialOffer.startsWith("haip-vci://") || credentialOffer.startsWith("https://")) {
       const parsed = await parseCredentialOfferUri({ uri: credentialOffer });
       if (parsed.credential_offer) {
         const decoded = decodeURIComponent(parsed.credential_offer);
         const offerJson2 = JSON.parse(decoded);
-        return zCredentialOffer.parse(offerJson2);
+        return parseCredentialOfferForVersion(config, offerJson2);
       }
       if (parsed.credential_offer_uri) {
         const fetch = createFetcher2(callbacks.fetch);
@@ -336,13 +430,13 @@ async function resolveCredentialOffer(options) {
         });
         await hasStatusOrThrow2(200, UnexpectedStatusCodeError2)(response);
         const offerJson2 = await response.json();
-        return zCredentialOffer.parse(offerJson2);
+        return parseCredentialOfferForVersion(config, offerJson2);
       }
     }
     const offerJson = JSON.parse(credentialOffer);
-    return zCredentialOffer.parse(offerJson);
+    return parseCredentialOfferForVersion(config, offerJson);
   } catch (error) {
-    if (error instanceof CredentialOfferError || error instanceof UnexpectedStatusCodeError2) {
+    if (error instanceof CredentialOfferError || error instanceof UnexpectedStatusCodeError2 || error instanceof ItWalletSpecsVersionError2) {
       throw error;
     }
     throw new CredentialOfferError(
@@ -352,8 +446,38 @@ async function resolveCredentialOffer(options) {
 }
 
 // src/credential-offer/validate-credential-offer.ts
-async function validateCredentialOffer(options) {
-  const { credentialIssuerMetadata, credentialOffer } = options;
+import {
+  ItWalletSpecsVersion as ItWalletSpecsVersion3,
+  ItWalletSpecsVersionError as ItWalletSpecsVersionError3,
+  createVersionDispatcher as createVersionDispatcher2
+} from "@pagopa/io-wallet-utils";
+function assertAuthorizationServerAllowed(authorizationServer, authorizationServers) {
+  if (!authorizationServer) {
+    if (authorizationServers && authorizationServers.length > 1) {
+      throw new CredentialOfferError(
+        "authorization_server is REQUIRED when Credential Issuer uses multiple Authorization Servers"
+      );
+    }
+    return;
+  }
+  if (!authorizationServers) {
+    throw new CredentialOfferError(
+      "credential offer specified an `authorization_server` but issuer metadata doesn't contain `authorization_servers`"
+    );
+  }
+  if (authorizationServers.length === 1) {
+    throw new CredentialOfferError(
+      "credential offer specified an `authorization_server` but issuer metadata's `authorization_servers` contains only an element"
+    );
+  }
+  if (!authorizationServers.includes(authorizationServer)) {
+    throw new CredentialOfferError(
+      `authorization_server '${authorizationServer}' does not match Credential Issuer metadata. Valid servers: ${authorizationServers.join(", ")}`
+    );
+  }
+}
+function validateBaseCredentialOffer(options) {
+  const { credentialIssuerMetadata, credentialOffer, versionLabel } = options;
   if (!credentialOffer.credential_issuer.startsWith("https://")) {
     throw new CredentialOfferError("credential_issuer must be an HTTPS URL");
   }
@@ -363,38 +487,57 @@ async function validateCredentialOffer(options) {
     );
   }
   if (!credentialOffer.grants) {
-    throw new CredentialOfferError("grants is REQUIRED for IT-Wallet v1.3");
+    throw new CredentialOfferError(
+      `grants is REQUIRED for IT-Wallet ${versionLabel}`
+    );
   }
   const authCodeGrant = credentialOffer.grants.authorization_code;
   if (!authCodeGrant) {
     throw new CredentialOfferError(
-      "authorization_code grant is REQUIRED for IT-Wallet v1.3"
+      `authorization_code grant is REQUIRED for IT-Wallet ${versionLabel}`
     );
   }
-  if (!authCodeGrant.scope) {
+  assertAuthorizationServerAllowed(
+    authCodeGrant.authorization_server,
+    credentialIssuerMetadata?.authorization_servers
+  );
+}
+async function validateCredentialOfferV1_3(options) {
+  validateBaseCredentialOffer({
+    credentialIssuerMetadata: options.credentialIssuerMetadata,
+    credentialOffer: options.credentialOffer,
+    versionLabel: "v1.3"
+  });
+  if (!options.credentialOffer.grants.authorization_code.scope) {
     throw new CredentialOfferError("authorization_code.scope is REQUIRED");
   }
-  if (credentialIssuerMetadata?.authorization_servers) {
-    const authServers = credentialIssuerMetadata.authorization_servers;
-    if (authServers.length > 1 && !authCodeGrant.authorization_server) {
-      throw new CredentialOfferError(
-        "authorization_server is REQUIRED when Credential Issuer uses multiple Authorization Servers"
-      );
-    }
-    if (authCodeGrant.authorization_server) {
-      if (!authServers.includes(authCodeGrant.authorization_server)) {
-        throw new CredentialOfferError(
-          `authorization_server '${authCodeGrant.authorization_server}' does not match Credential Issuer metadata. Valid servers: ${authServers.join(", ")}`
-        );
-      }
-    }
-  }
+}
+async function validateCredentialOfferV1_4(options) {
+  validateBaseCredentialOffer({
+    credentialIssuerMetadata: options.credentialIssuerMetadata,
+    credentialOffer: options.credentialOffer,
+    versionLabel: "v1.4"
+  });
+}
+var dispatchValidateCredentialOffer = createVersionDispatcher2({
+  [ItWalletSpecsVersion3.V1_0]: () => {
+    throw new ItWalletSpecsVersionError3(
+      "validateCredentialOffer",
+      ItWalletSpecsVersion3.V1_0,
+      [ItWalletSpecsVersion3.V1_3, ItWalletSpecsVersion3.V1_4]
+    );
+  },
+  [ItWalletSpecsVersion3.V1_3]: (o) => validateCredentialOfferV1_3(o),
+  [ItWalletSpecsVersion3.V1_4]: (o) => validateCredentialOfferV1_4(o)
+});
+async function validateCredentialOffer(options) {
+  return dispatchValidateCredentialOffer(options);
 }
 
 // src/credential-request/create-credential-request.ts
 import {
-  ItWalletSpecsVersion as ItWalletSpecsVersion3,
-  createVersionDispatcher
+  ItWalletSpecsVersion as ItWalletSpecsVersion6,
+  createVersionDispatcher as createVersionDispatcher3
 } from "@pagopa/io-wallet-utils";
 
 // src/credential-request/v1.0/create-credential-request.ts
@@ -405,18 +548,18 @@ import {
 } from "@pagopa/io-wallet-utils";
 
 // src/credential-request/v1.0/z-credential.ts
-import { z as z4 } from "zod";
+import { z as z6 } from "zod";
 
 // src/credential-request/z-base-credential-request.ts
-import { z as z3 } from "zod";
-var zBaseCredentialRequest = z3.object({
-  credential_configuration_id: z3.string().optional().describe(
+import { z as z5 } from "zod";
+var zBaseCredentialRequest = z5.object({
+  credential_configuration_id: z5.string().optional().describe(
     "REQUIRED if credential_identifier param is absent. MUST NOT be used otherwise."
   ),
-  credential_identifier: z3.string().optional().describe(
+  credential_identifier: z5.string().optional().describe(
     "REQUIRED when Authorization Details of type openid_credential was returned. MUST NOT be used if credential_configuration_id is present."
   ),
-  transaction_id: z3.string().optional().describe(
+  transaction_id: z5.string().optional().describe(
     "REQUIRED only in case of deferred flow. MUST NOT be present in immediate flow."
   )
 });
@@ -438,9 +581,9 @@ function credentialRequestRefiner(data, ctx) {
 }
 
 // src/credential-request/v1.0/z-credential.ts
-var zCredentialRequestProof = z4.object({
-  jwt: z4.string().min(1, "JWT must not be empty"),
-  proof_type: z4.literal("jwt")
+var zCredentialRequestProof = z6.object({
+  jwt: z6.string().min(1, "JWT must not be empty"),
+  proof_type: z6.literal("jwt")
   // MUST be "jwt"
 });
 var zCredentialRequestV1_0 = zBaseCredentialRequest.extend({
@@ -497,10 +640,10 @@ import {
 } from "@pagopa/io-wallet-utils";
 
 // src/credential-request/v1.3/z-credential.ts
-import { z as z5 } from "zod";
-var zCredentialRequestProofJwt = z5.string().min(1, "JWT must not be empty in credential request proofs array");
-var zCredentialRequestProofs = z5.object({
-  jwt: z5.tuple([zCredentialRequestProofJwt], zCredentialRequestProofJwt)
+import { z as z7 } from "zod";
+var zCredentialRequestProofJwt = z7.string().min(1, "JWT must not be empty in credential request proofs array");
+var zCredentialRequestProofs = z7.object({
+  jwt: z7.tuple([zCredentialRequestProofJwt], zCredentialRequestProofJwt)
 });
 var zCredentialRequestV1_3 = zBaseCredentialRequest.extend({
   proofs: zCredentialRequestProofs.describe(
@@ -583,10 +726,10 @@ var createCredentialRequest2 = async (options) => {
 };
 
 // src/credential-request/create-credential-request.ts
-var dispatchCreateCredentialRequest = createVersionDispatcher({
-  [ItWalletSpecsVersion3.V1_0]: (o) => createCredentialRequest(o),
-  [ItWalletSpecsVersion3.V1_3]: (o) => createCredentialRequest2(o),
-  [ItWalletSpecsVersion3.V1_4]: (o) => (
+var dispatchCreateCredentialRequest = createVersionDispatcher3({
+  [ItWalletSpecsVersion6.V1_0]: (o) => createCredentialRequest(o),
+  [ItWalletSpecsVersion6.V1_3]: (o) => createCredentialRequest2(o),
+  [ItWalletSpecsVersion6.V1_4]: (o) => (
     // V1_4 reuses V1_3 credential request schema — no breaking changes between versions.
     // Verified against compare/1.3.3...1.4.1: credential request parameters (format, proofs, key_attestation) identical.
     createCredentialRequest2(o)
@@ -604,30 +747,32 @@ import {
 } from "@pagopa/io-wallet-oauth2";
 import {
   HEADERS,
-  ItWalletSpecsVersion as ItWalletSpecsVersion4,
-  ItWalletSpecsVersionError,
+  HashAlgorithm as HashAlgorithm2,
+  ItWalletSpecsVersion as ItWalletSpecsVersion7,
+  ItWalletSpecsVersionError as ItWalletSpecsVersionError4,
   ValidationError as ValidationError4,
-  createVersionDispatcher as createVersionDispatcher2,
+  calculateJwkThumbprint as calculateJwkThumbprint2,
+  createVersionDispatcher as createVersionDispatcher4,
   parseWithErrorHandling as parseWithErrorHandling3
 } from "@pagopa/io-wallet-utils";
 
 // src/credential-request/z-proof-jwt.ts
 import { zJwk } from "@pagopa/io-wallet-oauth2";
-import { z as z6 } from "zod";
-var zBaseProofJwtHeader = z6.object({
-  alg: z6.string().min(1),
+import { z as z8 } from "zod";
+var zBaseProofJwtHeader = z8.object({
+  alg: z8.string().min(1),
   jwk: zJwk,
-  typ: z6.literal("openid4vci-proof+jwt")
+  typ: z8.literal("openid4vci-proof+jwt")
 });
 var zProofJwtHeaderV1_0 = zBaseProofJwtHeader.loose();
 var zProofJwtHeaderV1_3 = zBaseProofJwtHeader.extend({
-  key_attestation: z6.string().min(1)
+  key_attestation: z8.string().min(1)
 }).loose();
-var zProofJwtPayload = z6.looseObject({
-  aud: z6.string().min(1),
-  iat: z6.number(),
-  iss: z6.string().min(1).optional(),
-  nonce: z6.string().min(1)
+var zProofJwtPayload = z8.looseObject({
+  aud: z8.string().min(1),
+  iat: z8.number(),
+  iss: z8.string().min(1).optional(),
+  nonce: z8.string().min(1)
 });
 
 // src/credential-request/parse-credential-request.ts
@@ -692,7 +837,7 @@ function parseProofJwt(options) {
     errorMessagePrefix: "Error decoding credential request proof JWT:",
     jwt: options.jwt
   });
-  const headerValidation = options.itWalletSpecsVersion === ItWalletSpecsVersion4.V1_3 || options.itWalletSpecsVersion === ItWalletSpecsVersion4.V1_4 ? zProofJwtHeaderV1_3.safeParse(decoded.header) : zProofJwtHeaderV1_0.safeParse(decoded.header);
+  const headerValidation = options.itWalletSpecsVersion === ItWalletSpecsVersion7.V1_3 || options.itWalletSpecsVersion === ItWalletSpecsVersion7.V1_4 ? zProofJwtHeaderV1_3.safeParse(decoded.header) : zProofJwtHeaderV1_0.safeParse(decoded.header);
   if (!headerValidation.success) {
     throw new ValidationError4(
       "Credential proof JWT header is invalid or missing required claims"
@@ -717,7 +862,27 @@ function parseProofJwt(options) {
     proofType: "jwt"
   };
 }
-function normalizeProofs(options) {
+async function validateProofJwkUniqueness(options) {
+  if (options.proofs.length <= 1) {
+    return;
+  }
+  const thumbprints = await Promise.all(
+    options.proofs.map(
+      (proof) => calculateJwkThumbprint2({
+        hashAlgorithm: HashAlgorithm2.Sha256,
+        hashCallback: options.callbacks.hash,
+        jwk: proof.header.jwk
+      })
+    )
+  );
+  const uniqueThumbprints = new Set(thumbprints);
+  if (uniqueThumbprints.size !== thumbprints.length) {
+    throw new ValidationError4(
+      "Credential request proofs must use unique jwk header values"
+    );
+  }
+}
+async function normalizeProofs(options) {
   if ("proof" in options.credentialRequest) {
     return [
       parseProofJwt({
@@ -728,7 +893,7 @@ function normalizeProofs(options) {
       })
     ];
   }
-  return options.credentialRequest.proofs.jwt.map(
+  const proofs = options.credentialRequest.proofs.jwt.map(
     (jwt) => parseProofJwt({
       expected: options.expected,
       grantType: options.grantType,
@@ -736,14 +901,20 @@ function normalizeProofs(options) {
       jwt
     })
   );
+  await validateProofJwkUniqueness({
+    callbacks: options.callbacks,
+    proofs
+  });
+  return proofs;
 }
-function toResult(options) {
+async function toResult(options) {
   validateExpectedValues(options.credentialRequest, options.expected);
   validateTransactionContext({
     credentialRequest: options.credentialRequest,
     isDeferredFlow: options.isDeferredFlow
   });
-  const proofs = normalizeProofs({
+  const proofs = await normalizeProofs({
+    callbacks: options.callbacks,
     credentialRequest: options.credentialRequest,
     expected: options.expected,
     grantType: options.grantType,
@@ -802,12 +973,13 @@ function parseCredentialRequestV1_0(options) {
   );
   return toResult({
     accessToken: options.accessToken,
+    callbacks: options.callbacks,
     credentialRequest,
     dpopProof: options.dpopProof,
     expected: options.expected,
     grantType: options.grantType,
     isDeferredFlow: options.isDeferredFlow,
-    itWalletSpecsVersion: ItWalletSpecsVersion4.V1_0
+    itWalletSpecsVersion: ItWalletSpecsVersion7.V1_0
   });
 }
 function parseCredentialRequestV1_3(options) {
@@ -818,12 +990,13 @@ function parseCredentialRequestV1_3(options) {
   );
   return toResult({
     accessToken: options.accessToken,
+    callbacks: options.callbacks,
     credentialRequest,
     dpopProof: options.dpopProof,
     expected: options.expected,
     grantType: options.grantType,
     isDeferredFlow: options.isDeferredFlow,
-    itWalletSpecsVersion: ItWalletSpecsVersion4.V1_3
+    itWalletSpecsVersion: ItWalletSpecsVersion7.V1_3
   });
 }
 function parseCredentialRequestV1_4(options) {
@@ -834,27 +1007,28 @@ function parseCredentialRequestV1_4(options) {
   );
   return toResult({
     accessToken: options.accessToken,
+    callbacks: options.callbacks,
     credentialRequest,
     dpopProof: options.dpopProof,
     expected: options.expected,
     grantType: options.grantType,
     isDeferredFlow: options.isDeferredFlow,
-    itWalletSpecsVersion: ItWalletSpecsVersion4.V1_4
+    itWalletSpecsVersion: ItWalletSpecsVersion7.V1_4
     // V1_4 reuses V1_3 proof schema
   });
 }
-var dispatchParseCredentialRequest = createVersionDispatcher2({
-  [ItWalletSpecsVersion4.V1_0]: parseCredentialRequestV1_0,
-  [ItWalletSpecsVersion4.V1_3]: parseCredentialRequestV1_3,
-  [ItWalletSpecsVersion4.V1_4]: parseCredentialRequestV1_4
+var dispatchParseCredentialRequest = createVersionDispatcher4({
+  [ItWalletSpecsVersion7.V1_0]: parseCredentialRequestV1_0,
+  [ItWalletSpecsVersion7.V1_3]: parseCredentialRequestV1_3,
+  [ItWalletSpecsVersion7.V1_4]: parseCredentialRequestV1_4
 });
-function parseCredentialRequest(options) {
+async function parseCredentialRequest(options) {
   const grantType = options.grantType ?? "authorization_code";
   const isDeferredFlow = options.isDeferredFlow ?? false;
   try {
     const accessToken = parseAuthorizationHeader(options.headers);
     const dpopProof = parseDpopProof(options.headers);
-    return dispatchParseCredentialRequest({
+    return await dispatchParseCredentialRequest({
       ...options,
       accessToken,
       dpopProof,
@@ -862,7 +1036,7 @@ function parseCredentialRequest(options) {
       isDeferredFlow
     });
   } catch (error) {
-    if (error instanceof ItWalletSpecsVersionError || error instanceof Oauth2JwtParseError || error instanceof ValidationError4 || error instanceof CredentialAuthorizationHeaderError || error instanceof MissingDpopProofError) {
+    if (error instanceof ItWalletSpecsVersionError4 || error instanceof Oauth2JwtParseError || error instanceof ValidationError4 || error instanceof CredentialAuthorizationHeaderError || error instanceof MissingDpopProofError) {
       throw error;
     }
     throw new ParseCredentialRequestError(
@@ -873,18 +1047,18 @@ function parseCredentialRequest(options) {
 }
 
 // src/credential-request/verify-credential-request-jwt-proof.ts
-import { calculateJwkThumbprint as calculateJwkThumbprint2, jwtSignerFromJwt as jwtSignerFromJwt3 } from "@openid4vc/oauth2";
+import { calculateJwkThumbprint as calculateJwkThumbprint3, jwtSignerFromJwt as jwtSignerFromJwt3 } from "@openid4vc/oauth2";
 import {
-  HashAlgorithm as HashAlgorithm2,
+  HashAlgorithm as HashAlgorithm3,
   Oauth2JwtParseError as Oauth2JwtParseError3,
   decodeJwt as decodeJwt3,
   verifyJwt as verifyJwt3
 } from "@pagopa/io-wallet-oauth2";
 import {
-  ItWalletSpecsVersion as ItWalletSpecsVersion5,
-  ItWalletSpecsVersionError as ItWalletSpecsVersionError2,
+  ItWalletSpecsVersion as ItWalletSpecsVersion8,
+  ItWalletSpecsVersionError as ItWalletSpecsVersionError5,
   ValidationError as ValidationError6,
-  createVersionDispatcher as createVersionDispatcher3,
+  createVersionDispatcher as createVersionDispatcher5,
   verifyJwtIatOrThrow
 } from "@pagopa/io-wallet-utils";
 
@@ -901,33 +1075,33 @@ import { ValidationError as ValidationError5 } from "@pagopa/io-wallet-utils";
 import { zCertificateChain, zJwk as zJwk2, zTrustChain } from "@pagopa/io-wallet-oauth2";
 import { zKeyStorageLevelV1_3 } from "@pagopa/io-wallet-oid-federation";
 import { zItwSupportedSignatureAlg } from "@pagopa/io-wallet-utils";
-import { z as z7 } from "zod";
-var zStatusList = z7.object({
-  idx: z7.number(),
-  uri: z7.url()
+import { z as z9 } from "zod";
+var zStatusList = z9.object({
+  idx: z9.number(),
+  uri: z9.url()
 });
-var zKeyAttestationStatus = z7.object({
+var zKeyAttestationStatus = z9.object({
   status_list: zStatusList
 });
 var zKeyAttestationAlg = zItwSupportedSignatureAlg;
-var zKeyAttestationHeader = z7.object({
+var zKeyAttestationHeader = z9.object({
   alg: zKeyAttestationAlg,
-  kid: z7.string(),
+  kid: z9.string(),
   trust_chain: zTrustChain.optional(),
-  typ: z7.literal("key-attestation+jwt"),
+  typ: z9.literal("key-attestation+jwt"),
   x5c: zCertificateChain
 });
-var zKeyAttestationPayload = z7.object({
-  attested_keys: z7.array(zJwk2).nonempty(),
-  certification: z7.string().optional(),
-  exp: z7.number(),
-  iat: z7.number(),
-  iss: z7.string(),
-  key_storage: z7.array(zKeyStorageLevelV1_3).nonempty(),
+var zKeyAttestationPayload = z9.object({
+  attested_keys: z9.array(zJwk2).nonempty(),
+  certification: z9.string().optional(),
+  exp: z9.number(),
+  iat: z9.number(),
+  iss: z9.string(),
+  key_storage: z9.array(zKeyStorageLevelV1_3).nonempty(),
   status: zKeyAttestationStatus,
-  user_authentication: z7.array(zKeyStorageLevelV1_3).nonempty()
+  user_authentication: z9.array(zKeyStorageLevelV1_3).nonempty()
 });
-var zKeyAttestationTypeHeader = z7.literal("key-attestation+jwt");
+var zKeyAttestationTypeHeader = z9.literal("key-attestation+jwt");
 var keyAttestationTypeHeader = zKeyAttestationTypeHeader.value;
 
 // src/credential-request/verify-key-attestation-jwt.ts
@@ -974,15 +1148,15 @@ async function verifyKeyAttestationJwt(options) {
 
 // src/credential-request/verify-credential-request-jwt-proof.ts
 async function isJwkInSet(options) {
-  const targetThumbprint = await calculateJwkThumbprint2({
-    hashAlgorithm: HashAlgorithm2.Sha256,
+  const targetThumbprint = await calculateJwkThumbprint3({
+    hashAlgorithm: HashAlgorithm3.Sha256,
     hashCallback: options.callbacks.hash,
     jwk: options.jwk
   });
   const thumbprints = await Promise.all(
     options.jwks.map(
-      (jwk) => calculateJwkThumbprint2({
-        hashAlgorithm: HashAlgorithm2.Sha256,
+      (jwk) => calculateJwkThumbprint3({
+        hashAlgorithm: HashAlgorithm3.Sha256,
         hashCallback: options.callbacks.hash,
         jwk
       })
@@ -1077,10 +1251,10 @@ async function verifyProofV1_3(options) {
   }
   return { header, keyAttestation: keyAttestationResult, payload, signer };
 }
-var dispatchVerifyProof = createVersionDispatcher3({
-  [ItWalletSpecsVersion5.V1_0]: (o) => verifyProofV1_0(o),
-  [ItWalletSpecsVersion5.V1_3]: (o) => verifyProofV1_3(o),
-  [ItWalletSpecsVersion5.V1_4]: (o) => verifyProofV1_3(o)
+var dispatchVerifyProof = createVersionDispatcher5({
+  [ItWalletSpecsVersion8.V1_0]: (o) => verifyProofV1_0(o),
+  [ItWalletSpecsVersion8.V1_3]: (o) => verifyProofV1_3(o),
+  [ItWalletSpecsVersion8.V1_4]: (o) => verifyProofV1_3(o)
 });
 async function verifyCredentialRequestJwtProof(options) {
   try {
@@ -1092,7 +1266,7 @@ async function verifyCredentialRequestJwtProof(options) {
     }
     return await dispatchVerifyProof({ ...options, now });
   } catch (error) {
-    if (error instanceof VerifyCredentialRequestJwtProofError || error instanceof VerifyKeyAttestationJwtError || error instanceof ItWalletSpecsVersionError2 || error instanceof ValidationError6 || error instanceof Oauth2JwtParseError3) {
+    if (error instanceof VerifyCredentialRequestJwtProofError || error instanceof VerifyKeyAttestationJwtError || error instanceof ItWalletSpecsVersionError5 || error instanceof ValidationError6 || error instanceof Oauth2JwtParseError3) {
       throw error;
     }
     throw new VerifyCredentialRequestJwtProofError(
@@ -1104,39 +1278,39 @@ async function verifyCredentialRequestJwtProof(options) {
 
 // src/credential-response/create-credential-response.ts
 import {
-  ItWalletSpecsVersion as ItWalletSpecsVersion6,
+  ItWalletSpecsVersion as ItWalletSpecsVersion9,
   ValidationError as ValidationError7,
-  createVersionDispatcher as createVersionDispatcher4
+  createVersionDispatcher as createVersionDispatcher6
 } from "@pagopa/io-wallet-utils";
 
 // src/credential-response/v1.0/create-credential-response.ts
 import { parseWithErrorHandling as parseWithErrorHandling4 } from "@pagopa/io-wallet-utils";
 
 // src/credential-response/v1.0/z-credential-response.ts
-import { z as z9 } from "zod";
+import { z as z11 } from "zod";
 
 // src/credential-response/z-immediate-credential-response.ts
-import { z as z8 } from "zod";
-var zCredentialObject = z8.object({
-  credential: z8.string()
+import { z as z10 } from "zod";
+var zCredentialObject = z10.object({
+  credential: z10.string()
 });
-var zImmediateCredentialResponse = z8.strictObject({
-  credentials: z8.array(zCredentialObject).nonempty().describe(
+var zImmediateCredentialResponse = z10.strictObject({
+  credentials: z10.array(zCredentialObject).nonempty().describe(
     "Conditional. Array of issued Digital Credentials as JSON objects with `credential` member containing encoded credential string. Present for immediate issuance (HTTP 200)."
   ),
-  notification_id: z8.string().optional().describe(
+  notification_id: z10.string().optional().describe(
     "OPTIONAL. Identifier for notification requests. Only present with credentials parameter."
   )
 });
 
 // src/credential-response/v1.0/z-credential-response.ts
-var zDeferredCredentialResponseV1_0 = z9.strictObject({
-  lead_time: z9.number().int().positive().describe(
+var zDeferredCredentialResponseV1_0 = z11.strictObject({
+  lead_time: z11.number().int().positive().describe(
     "REQUIRED if credentials is not present, otherwise it MUST NOT be present. The amount of time (in seconds) required before making a Deferred Credential Request."
   ),
-  transaction_id: z9.string().nonempty()
+  transaction_id: z11.string().nonempty()
 });
-var zCredentialResponseV1_0 = z9.union([
+var zCredentialResponseV1_0 = z11.union([
   zImmediateCredentialResponse,
   zDeferredCredentialResponseV1_0
 ]);
@@ -1169,14 +1343,14 @@ function createCredentialResponseV1_0(flow) {
 import { parseWithErrorHandling as parseWithErrorHandling5 } from "@pagopa/io-wallet-utils";
 
 // src/credential-response/v1.3/z-credential-response.ts
-import { z as z10 } from "zod";
-var zDeferredCredentialResponseV1_3 = z10.strictObject({
-  interval: z10.number().int().positive().describe(
+import { z as z12 } from "zod";
+var zDeferredCredentialResponseV1_3 = z12.strictObject({
+  interval: z12.number().int().positive().describe(
     "REQUIRED if transaction_id is present, otherwise it MUST NOT be present. The amount of time (in seconds) required before making a Deferred Credential Request"
   ),
-  transaction_id: z10.string().nonempty()
+  transaction_id: z12.string().nonempty()
 });
-var zCredentialResponseV1_3 = z10.union([
+var zCredentialResponseV1_3 = z12.union([
   zImmediateCredentialResponse,
   zDeferredCredentialResponseV1_3
 ]);
@@ -1206,14 +1380,14 @@ function createCredentialResponseV1_3(flow) {
 }
 
 // src/credential-response/create-credential-response.ts
-var dispatchBuildVersionedResponse = createVersionDispatcher4({
-  [ItWalletSpecsVersion6.V1_0]: (o) => createCredentialResponseV1_0(
+var dispatchBuildVersionedResponse = createVersionDispatcher6({
+  [ItWalletSpecsVersion9.V1_0]: (o) => createCredentialResponseV1_0(
     o.flow
   ),
-  [ItWalletSpecsVersion6.V1_3]: (o) => createCredentialResponseV1_3(
+  [ItWalletSpecsVersion9.V1_3]: (o) => createCredentialResponseV1_3(
     o.flow
   ),
-  [ItWalletSpecsVersion6.V1_4]: (o) => createCredentialResponseV1_3(
+  [ItWalletSpecsVersion9.V1_4]: (o) => createCredentialResponseV1_3(
     o.flow
     // V1_4 reuses V1_3 credential response schema — no breaking changes between versions.
     // Verified against compare/1.3.3...1.4.1: credential response parameters identical.
@@ -1274,10 +1448,10 @@ import {
 
 // src/credential-response/z-credential-response.ts
 import { zAlgValueNotNone, zJwk as zJwk3 } from "@pagopa/io-wallet-oauth2";
-import { z as z11 } from "zod";
-var zCredentialResponseEncryption = z11.looseObject({
+import { z as z13 } from "zod";
+var zCredentialResponseEncryption = z13.looseObject({
   alg: zAlgValueNotNone,
-  enc: z11.string(),
+  enc: z13.string(),
   jwk: zJwk3
 });
 
@@ -1325,16 +1499,16 @@ async function fetchCredentialResponse(options) {
 import { decodeJwt as decodeJwt4 } from "@pagopa/io-wallet-oauth2";
 import { itWalletEntityStatementClaimsSchema as itWalletEntityStatementClaimsSchema2 } from "@pagopa/io-wallet-oid-federation";
 import {
-  ItWalletSpecsVersion as ItWalletSpecsVersion7,
-  ItWalletSpecsVersionError as ItWalletSpecsVersionError3,
+  ItWalletSpecsVersion as ItWalletSpecsVersion10,
+  ItWalletSpecsVersionError as ItWalletSpecsVersionError6,
   UnexpectedStatusCodeError as UnexpectedStatusCodeError4,
   ValidationError as ValidationError9,
   createFetcher as createFetcher4,
-  createVersionDispatcher as createVersionDispatcher5,
+  createVersionDispatcher as createVersionDispatcher7,
   hasStatusOrThrow as hasStatusOrThrow4,
   parseWithErrorHandling as parseWithErrorHandling7
 } from "@pagopa/io-wallet-utils";
-import z13 from "zod";
+import z15 from "zod";
 
 // src/metadata/z-metadata-response.ts
 import {
@@ -1342,23 +1516,29 @@ import {
   itWalletMetadataV1_0,
   itWalletMetadataV1_3
 } from "@pagopa/io-wallet-oid-federation";
-import { z as z12 } from "zod";
-var zMetadataResponseV1_0 = z12.object({
-  discoveredVia: z12.enum(["federation"]),
+import { z as z14 } from "zod";
+var zMetadataResponseV1_0 = z14.object({
+  discoveredVia: z14.enum(["federation"]),
   metadata: itWalletMetadataV1_0,
   openid_federation_claims: itWalletEntityStatementClaimsSchema
 });
-var zMetadataResponseV1_3 = z12.object({
-  discoveredVia: z12.enum(["federation", "oid4vci"]),
+var zMetadataResponseV1_3 = z14.object({
+  /**
+   * Entity statement claims of the Authorization Server, present only when the
+   * selected authorization server was resolved through a federation entity
+   * distinct from the Credential Issuer.
+   */
+  authorization_server_federation_claims: itWalletEntityStatementClaimsSchema.optional(),
+  discoveredVia: z14.enum(["federation", "oid4vci"]),
   metadata: itWalletMetadataV1_3,
   openid_federation_claims: itWalletEntityStatementClaimsSchema.optional()
 });
-var zMetadataResponse = z12.union([
+var zMetadataResponse = z14.union([
   zMetadataResponseV1_0,
   zMetadataResponseV1_3
 ]);
-var zPartialIssuerMetadata = z12.looseObject({
-  authorization_servers: z12.array(z12.string()).optional()
+var zPartialIssuerMetadata = z14.looseObject({
+  authorization_servers: z14.tuple([z14.url()], z14.url()).optional()
 });
 
 // src/metadata/fetch-metadata.ts
@@ -1410,7 +1590,48 @@ async function tryFederationDiscovery(fetch, baseUrl, verifyJwt4) {
     return void 0;
   }
 }
-async function fallbackDiscovery(fetch, baseUrl) {
+async function applyFederationAuthorizationServerSelection(fetch, federationResult, authorizationServer, verifyJwt4) {
+  const credentialIssuer = federationResult.metadata?.openid_credential_issuer?.credential_issuer;
+  const authorizationServers = federationResult.metadata?.openid_credential_issuer?.authorization_servers;
+  let selectedAuthorizationServer;
+  if (authorizationServer) {
+    assertAuthorizationServerAllowed(authorizationServer, authorizationServers);
+    selectedAuthorizationServer = authorizationServer;
+  } else if (authorizationServers && authorizationServers.length > 0) {
+    selectedAuthorizationServer = credentialIssuer && authorizationServers.includes(credentialIssuer) ? credentialIssuer : authorizationServers[0];
+  } else {
+    selectedAuthorizationServer = credentialIssuer;
+  }
+  if (!selectedAuthorizationServer || selectedAuthorizationServer === credentialIssuer) {
+    return federationResult;
+  }
+  const parsedSelectedAuthorizationServer = z15.url().safeParse(selectedAuthorizationServer);
+  if (!parsedSelectedAuthorizationServer.success || !parsedSelectedAuthorizationServer.data.startsWith("https://")) {
+    throw new ValidationError9(
+      "selected authorization server is not a valid HTTPS URL"
+    );
+  }
+  const authorizationServerResult = await tryFederationDiscovery(
+    fetch,
+    parsedSelectedAuthorizationServer.data,
+    verifyJwt4
+  );
+  const resolvedAuthorizationServer = authorizationServerResult?.metadata?.oauth_authorization_server;
+  if (!resolvedAuthorizationServer) {
+    throw new ValidationError9(
+      `Federation discovery did not yield oauth_authorization_server metadata for authorization server '${selectedAuthorizationServer}'`
+    );
+  }
+  return {
+    ...federationResult,
+    authorization_server_federation_claims: authorizationServerResult.openid_federation_claims,
+    metadata: {
+      ...federationResult.metadata,
+      oauth_authorization_server: resolvedAuthorizationServer
+    }
+  };
+}
+async function fallbackDiscovery(fetch, baseUrl, authorizationServer) {
   const issuerUrl = new URL(
     ".well-known/openid-credential-issuer",
     ensureTrailingSlash(baseUrl)
@@ -1423,12 +1644,14 @@ async function fallbackDiscovery(fetch, baseUrl) {
     "Failed to parse credential issuer metadata"
   );
   const authorizationServers = issuerJson.authorization_servers;
+  assertAuthorizationServerAllowed(authorizationServer, authorizationServers);
   let oauthAuthorizationServer;
   if (authorizationServers && authorizationServers.length > 0) {
-    const parsedUrl = z13.url().safeParse(authorizationServers[0]);
+    const selectedAuthorizationServer = authorizationServer ?? authorizationServers[0];
+    const parsedUrl = z15.url().safeParse(selectedAuthorizationServer);
     if (!parsedUrl.success || !parsedUrl.data.startsWith("https://")) {
       throw new ValidationError9(
-        "authorization_servers[0] is not a valid HTTPS URL"
+        "selected authorization server is not a valid HTTPS URL"
       );
     }
     const authServerUrl = new URL(
@@ -1474,22 +1697,31 @@ async function fetchMetadataV1_3(options) {
     options.credentialIssuerUrl,
     options.callbacks.verifyJwt
   );
-  const raw = federationResult ?? await fallbackDiscovery(fetch, options.credentialIssuerUrl);
+  const raw = federationResult ? await applyFederationAuthorizationServerSelection(
+    fetch,
+    federationResult,
+    options.authorizationServer,
+    options.callbacks.verifyJwt
+  ) : await fallbackDiscovery(
+    fetch,
+    options.credentialIssuerUrl,
+    options.authorizationServer
+  );
   return parseWithErrorHandling7(
     zMetadataResponseV1_3,
     raw,
     "Failed to parse v1.3 metadata response"
   );
 }
-var dispatchFetchMetadata = createVersionDispatcher5({
-  [ItWalletSpecsVersion7.V1_0]: (o) => fetchMetadataV1_0(o),
-  [ItWalletSpecsVersion7.V1_3]: (o) => fetchMetadataV1_3(o),
+var dispatchFetchMetadata = createVersionDispatcher7({
+  [ItWalletSpecsVersion10.V1_0]: (o) => fetchMetadataV1_0(o),
+  [ItWalletSpecsVersion10.V1_3]: (o) => fetchMetadataV1_3(o),
   // V1_4 reuses V1_3 metadata schema — no breaking changes between versions.
-  [ItWalletSpecsVersion7.V1_4]: (o) => fetchMetadataV1_3(o)
+  [ItWalletSpecsVersion10.V1_4]: (o) => fetchMetadataV1_3(o)
 });
 async function fetchMetadata(options) {
   try {
-    const urlValidation = z13.url().safeParse(options.credentialIssuerUrl);
+    const urlValidation = z15.url().safeParse(options.credentialIssuerUrl);
     if (!urlValidation.success || !urlValidation.data.startsWith("https://")) {
       throw new ValidationError9(
         "credentialIssuerUrl must be a valid HTTPS URL"
@@ -1497,7 +1729,7 @@ async function fetchMetadata(options) {
     }
     return await dispatchFetchMetadata(options);
   } catch (error) {
-    if (error instanceof UnexpectedStatusCodeError4 || error instanceof ValidationError9 || error instanceof ItWalletSpecsVersionError3 || error instanceof FetchMetadataError) {
+    if (error instanceof UnexpectedStatusCodeError4 || error instanceof ValidationError9 || error instanceof ItWalletSpecsVersionError6 || error instanceof CredentialOfferError || error instanceof FetchMetadataError) {
       throw error;
     }
     throw new FetchMetadataError("Unexpected error during metadata fetch", {
@@ -1513,7 +1745,7 @@ import {
   createWalletAttestationJwtV1_4
 } from "@pagopa/io-wallet-oauth2";
 import {
-  ItWalletSpecsVersion as ItWalletSpecsVersion8,
+  ItWalletSpecsVersion as ItWalletSpecsVersion11,
   addSecondsToDate,
   dateToSeconds as dateToSeconds3,
   dispatchByVersion
@@ -1682,7 +1914,7 @@ var WalletProvider = class {
    */
   async createItWalletAttestationJwt(options) {
     return dispatchByVersion(this.specVersion, {
-      [ItWalletSpecsVersion8.V1_0]: () => {
+      [ItWalletSpecsVersion11.V1_0]: () => {
         assertV1_0Options(options);
         return createWalletAttestationJwtV1_0({
           authenticatorAssuranceLevel: options.authenticatorAssuranceLevel,
@@ -1695,7 +1927,7 @@ var WalletProvider = class {
           walletName: options.walletName
         });
       },
-      [ItWalletSpecsVersion8.V1_3]: () => {
+      [ItWalletSpecsVersion11.V1_3]: () => {
         assertV1_3Options(options);
         return createWalletAttestationJwtV1_3({
           callbacks: options.callbacks,
@@ -1709,7 +1941,7 @@ var WalletProvider = class {
           walletName: options.walletName
         });
       },
-      [ItWalletSpecsVersion8.V1_4]: () => {
+      [ItWalletSpecsVersion11.V1_4]: () => {
         assertV1_4Options(options);
         return createWalletAttestationJwtV1_4({
           callbacks: options.callbacks,
@@ -1756,8 +1988,14 @@ export {
   verifyAuthorizationResponseFormPostJWT,
   verifyCredentialRequestJwtProof,
   verifyKeyAttestationJwt,
+  zAuthorizationCodeGrantV1_3,
+  zAuthorizationCodeGrantV1_4,
   zAuthorizationResponse,
   zCredentialObject,
+  zCredentialOfferGrantsV1_3,
+  zCredentialOfferGrantsV1_4,
+  zCredentialOfferV1_3,
+  zCredentialOfferV1_4,
   zCredentialRequestV1_0,
   zCredentialRequestV1_3,
   zCredentialResponseEncryption,