@pagopa/io-wallet-oid4vci 1.5.1 → 1.5.2

package/dist/index.d.mts

@@ -326,23 +326,27 @@ interface BaseResolveCredentialOfferOptions {
      */
     credentialOffer: string;
 }
+/**
+ * Options for resolving a credential offer.
+ *
+ * Accepts a runtime-selected SDK config and defers version support checks to
+ * the credential offer parser.
+ */
+interface ResolveCredentialOfferOptions extends BaseResolveCredentialOfferOptions {
+    config: IoWalletSdkConfig;
+}
 /**
  * Options for resolving a credential offer against the IT-Wallet v1.3 schema.
  */
-interface ResolveCredentialOfferOptionsV1_3 extends BaseResolveCredentialOfferOptions {
+interface ResolveCredentialOfferOptionsV1_3 extends ResolveCredentialOfferOptions {
     config: IoWalletSdkConfig<ItWalletSpecsVersion.V1_3>;
 }
 /**
  * Options for resolving a credential offer against the IT-Wallet v1.4 schema.
  */
-interface ResolveCredentialOfferOptionsV1_4 extends BaseResolveCredentialOfferOptions {
+interface ResolveCredentialOfferOptionsV1_4 extends ResolveCredentialOfferOptions {
     config: IoWalletSdkConfig<ItWalletSpecsVersion.V1_4>;
 }
-/**
- * Options for resolving a credential offer.
- * The configured version selects the schema used to parse the offer.
- */
-type ResolveCredentialOfferOptions = ResolveCredentialOfferOptionsV1_3 | ResolveCredentialOfferOptionsV1_4;
 /**
  * Base options shared across all validate-credential-offer versions.
  */
@@ -363,14 +367,24 @@ interface BaseValidateCredentialOfferOptions {
      *   ]
      * };
      */
-    credentialIssuerMetadata?: {
+    credentialIssuerMetadata: {
         authorization_servers?: [string, ...string[]];
     };
 }
+/**
+ * Options for validating a credential offer against the configured IT-Wallet specification.
+ */
+interface ValidateCredentialOfferOptions extends BaseValidateCredentialOfferOptions {
+    config: IoWalletSdkConfig;
+    /**
+     * The credential offer to validate against the configured IT-Wallet specification.
+     */
+    credentialOffer: CredentialOfferV1_3 | CredentialOfferV1_4;
+}
 /**
  * Options for validating an IT-Wallet v1.3 credential offer.
  */
-interface ValidateCredentialOfferOptionsV1_3 extends BaseValidateCredentialOfferOptions {
+interface ValidateCredentialOfferOptionsV1_3 extends ValidateCredentialOfferOptions {
     config: IoWalletSdkConfig<ItWalletSpecsVersion.V1_3>;
     /**
      * The credential offer to validate against IT-Wallet v1.3 specifications.
@@ -380,7 +394,7 @@ interface ValidateCredentialOfferOptionsV1_3 extends BaseValidateCredentialOffer
 /**
  * Options for validating an IT-Wallet v1.4 credential offer.
  */
-interface ValidateCredentialOfferOptionsV1_4 extends BaseValidateCredentialOfferOptions {
+interface ValidateCredentialOfferOptionsV1_4 extends ValidateCredentialOfferOptions {
     config: IoWalletSdkConfig<ItWalletSpecsVersion.V1_4>;
     /**
      * The credential offer to validate against IT-Wallet v1.4 specifications.
@@ -388,13 +402,19 @@ interface ValidateCredentialOfferOptionsV1_4 extends BaseValidateCredentialOffer
     credentialOffer: CredentialOfferV1_4;
 }
 /**
- * Options for validating a credential offer against IT-Wallet specifications.
+ * Options for extracting grant details from a credential offer.
  */
-type ValidateCredentialOfferOptions = ValidateCredentialOfferOptionsV1_3 | ValidateCredentialOfferOptionsV1_4;
+interface ExtractGrantDetailsOptions {
+    config: IoWalletSdkConfig;
+    /**
+     * The credential offer to extract grant details from.
+     */
+    credentialOffer: CredentialOfferV1_3 | CredentialOfferV1_4;
+}
 /**
  * Options for extracting grant details from an IT-Wallet v1.3 credential offer.
  */
-interface ExtractGrantDetailsOptionsV1_3 {
+interface ExtractGrantDetailsOptionsV1_3 extends ExtractGrantDetailsOptions {
     config: IoWalletSdkConfig<ItWalletSpecsVersion.V1_3>;
     /**
      * The credential offer to extract grant details from.
@@ -404,17 +424,13 @@ interface ExtractGrantDetailsOptionsV1_3 {
 /**
  * Options for extracting grant details from an IT-Wallet v1.4 credential offer.
  */
-interface ExtractGrantDetailsOptionsV1_4 {
+interface ExtractGrantDetailsOptionsV1_4 extends ExtractGrantDetailsOptions {
     config: IoWalletSdkConfig<ItWalletSpecsVersion.V1_4>;
     /**
      * The credential offer to extract grant details from.
      */
     credentialOffer: CredentialOfferV1_4;
 }
-/**
- * Options for extracting grant details from a credential offer.
- */
-type ExtractGrantDetailsOptions = ExtractGrantDetailsOptionsV1_3 | ExtractGrantDetailsOptionsV1_4;
 /**
  * Result of extracting grant details from an IT-Wallet v1.3 credential offer.
  */
@@ -466,6 +482,12 @@ interface ExtractGrantDetailsResultV1_4 {
          * OPTIONAL. Used to correlate the authorization request with the credential offer.
          */
         issuerState?: string;
+        /**
+         * Version 1.4 has dropped support for the scope field,
+         * But typescript inference might have trouble recognizing this fact
+         * in its union type, so this is needed
+         */
+        scope?: never;
     };
     /**
      * The type of grant present in the credential offer.
@@ -497,6 +519,7 @@ type ExtractGrantDetailsResult = ExtractGrantDetailsResultV1_3 | ExtractGrantDet
  */
 declare function extractGrantDetails(options: ExtractGrantDetailsOptionsV1_3): ExtractGrantDetailsResultV1_3;
 declare function extractGrantDetails(options: ExtractGrantDetailsOptionsV1_4): ExtractGrantDetailsResultV1_4;
+declare function extractGrantDetails(options: ExtractGrantDetailsOptions): ExtractGrantDetailsResult;
 
 /**
  * Parses a credential offer URI and extracts the scheme and parameters.
@@ -596,6 +619,7 @@ declare function parseCredentialOfferUri(options: ParseCredentialOfferUriOptions
  */
 declare function resolveCredentialOffer(options: ResolveCredentialOfferOptionsV1_3): Promise<CredentialOfferV1_3>;
 declare function resolveCredentialOffer(options: ResolveCredentialOfferOptionsV1_4): Promise<CredentialOfferV1_4>;
+declare function resolveCredentialOffer(options: ResolveCredentialOfferOptions): Promise<CredentialOffer>;
 
 /**
  * Validates a credential offer against IT-Wallet specifications for the configured version.

package/dist/index.d.ts

@@ -326,23 +326,27 @@ interface BaseResolveCredentialOfferOptions {
      */
     credentialOffer: string;
 }
+/**
+ * Options for resolving a credential offer.
+ *
+ * Accepts a runtime-selected SDK config and defers version support checks to
+ * the credential offer parser.
+ */
+interface ResolveCredentialOfferOptions extends BaseResolveCredentialOfferOptions {
+    config: IoWalletSdkConfig;
+}
 /**
  * Options for resolving a credential offer against the IT-Wallet v1.3 schema.
  */
-interface ResolveCredentialOfferOptionsV1_3 extends BaseResolveCredentialOfferOptions {
+interface ResolveCredentialOfferOptionsV1_3 extends ResolveCredentialOfferOptions {
     config: IoWalletSdkConfig<ItWalletSpecsVersion.V1_3>;
 }
 /**
  * Options for resolving a credential offer against the IT-Wallet v1.4 schema.
  */
-interface ResolveCredentialOfferOptionsV1_4 extends BaseResolveCredentialOfferOptions {
+interface ResolveCredentialOfferOptionsV1_4 extends ResolveCredentialOfferOptions {
     config: IoWalletSdkConfig<ItWalletSpecsVersion.V1_4>;
 }
-/**
- * Options for resolving a credential offer.
- * The configured version selects the schema used to parse the offer.
- */
-type ResolveCredentialOfferOptions = ResolveCredentialOfferOptionsV1_3 | ResolveCredentialOfferOptionsV1_4;
 /**
  * Base options shared across all validate-credential-offer versions.
  */
@@ -363,14 +367,24 @@ interface BaseValidateCredentialOfferOptions {
      *   ]
      * };
      */
-    credentialIssuerMetadata?: {
+    credentialIssuerMetadata: {
         authorization_servers?: [string, ...string[]];
     };
 }
+/**
+ * Options for validating a credential offer against the configured IT-Wallet specification.
+ */
+interface ValidateCredentialOfferOptions extends BaseValidateCredentialOfferOptions {
+    config: IoWalletSdkConfig;
+    /**
+     * The credential offer to validate against the configured IT-Wallet specification.
+     */
+    credentialOffer: CredentialOfferV1_3 | CredentialOfferV1_4;
+}
 /**
  * Options for validating an IT-Wallet v1.3 credential offer.
  */
-interface ValidateCredentialOfferOptionsV1_3 extends BaseValidateCredentialOfferOptions {
+interface ValidateCredentialOfferOptionsV1_3 extends ValidateCredentialOfferOptions {
     config: IoWalletSdkConfig<ItWalletSpecsVersion.V1_3>;
     /**
      * The credential offer to validate against IT-Wallet v1.3 specifications.
@@ -380,7 +394,7 @@ interface ValidateCredentialOfferOptionsV1_3 extends BaseValidateCredentialOffer
 /**
  * Options for validating an IT-Wallet v1.4 credential offer.
  */
-interface ValidateCredentialOfferOptionsV1_4 extends BaseValidateCredentialOfferOptions {
+interface ValidateCredentialOfferOptionsV1_4 extends ValidateCredentialOfferOptions {
     config: IoWalletSdkConfig<ItWalletSpecsVersion.V1_4>;
     /**
      * The credential offer to validate against IT-Wallet v1.4 specifications.
@@ -388,13 +402,19 @@ interface ValidateCredentialOfferOptionsV1_4 extends BaseValidateCredentialOffer
     credentialOffer: CredentialOfferV1_4;
 }
 /**
- * Options for validating a credential offer against IT-Wallet specifications.
+ * Options for extracting grant details from a credential offer.
  */
-type ValidateCredentialOfferOptions = ValidateCredentialOfferOptionsV1_3 | ValidateCredentialOfferOptionsV1_4;
+interface ExtractGrantDetailsOptions {
+    config: IoWalletSdkConfig;
+    /**
+     * The credential offer to extract grant details from.
+     */
+    credentialOffer: CredentialOfferV1_3 | CredentialOfferV1_4;
+}
 /**
  * Options for extracting grant details from an IT-Wallet v1.3 credential offer.
  */
-interface ExtractGrantDetailsOptionsV1_3 {
+interface ExtractGrantDetailsOptionsV1_3 extends ExtractGrantDetailsOptions {
     config: IoWalletSdkConfig<ItWalletSpecsVersion.V1_3>;
     /**
      * The credential offer to extract grant details from.
@@ -404,17 +424,13 @@ interface ExtractGrantDetailsOptionsV1_3 {
 /**
  * Options for extracting grant details from an IT-Wallet v1.4 credential offer.
  */
-interface ExtractGrantDetailsOptionsV1_4 {
+interface ExtractGrantDetailsOptionsV1_4 extends ExtractGrantDetailsOptions {
     config: IoWalletSdkConfig<ItWalletSpecsVersion.V1_4>;
     /**
      * The credential offer to extract grant details from.
      */
     credentialOffer: CredentialOfferV1_4;
 }
-/**
- * Options for extracting grant details from a credential offer.
- */
-type ExtractGrantDetailsOptions = ExtractGrantDetailsOptionsV1_3 | ExtractGrantDetailsOptionsV1_4;
 /**
  * Result of extracting grant details from an IT-Wallet v1.3 credential offer.
  */
@@ -466,6 +482,12 @@ interface ExtractGrantDetailsResultV1_4 {
          * OPTIONAL. Used to correlate the authorization request with the credential offer.
          */
         issuerState?: string;
+        /**
+         * Version 1.4 has dropped support for the scope field,
+         * But typescript inference might have trouble recognizing this fact
+         * in its union type, so this is needed
+         */
+        scope?: never;
     };
     /**
      * The type of grant present in the credential offer.
@@ -497,6 +519,7 @@ type ExtractGrantDetailsResult = ExtractGrantDetailsResultV1_3 | ExtractGrantDet
  */
 declare function extractGrantDetails(options: ExtractGrantDetailsOptionsV1_3): ExtractGrantDetailsResultV1_3;
 declare function extractGrantDetails(options: ExtractGrantDetailsOptionsV1_4): ExtractGrantDetailsResultV1_4;
+declare function extractGrantDetails(options: ExtractGrantDetailsOptions): ExtractGrantDetailsResult;
 
 /**
  * Parses a credential offer URI and extracts the scheme and parameters.
@@ -596,6 +619,7 @@ declare function parseCredentialOfferUri(options: ParseCredentialOfferUriOptions
  */
 declare function resolveCredentialOffer(options: ResolveCredentialOfferOptionsV1_3): Promise<CredentialOfferV1_3>;
 declare function resolveCredentialOffer(options: ResolveCredentialOfferOptionsV1_4): Promise<CredentialOfferV1_4>;
+declare function resolveCredentialOffer(options: ResolveCredentialOfferOptions): Promise<CredentialOffer>;
 
 /**
  * Validates a credential offer against IT-Wallet specifications for the configured version.

package/dist/index.js

@@ -1617,19 +1617,14 @@ async function applyFederationAuthorizationServerSelection(fetch, federationResu
     parsedSelectedAuthorizationServer.data,
     verifyJwt4
   );
-  const resolvedAuthorizationServer = authorizationServerResult?.metadata?.oauth_authorization_server;
-  if (!resolvedAuthorizationServer) {
+  if (!authorizationServerResult) {
     throw new import_io_wallet_utils16.ValidationError(
-      `Federation discovery did not yield oauth_authorization_server metadata for authorization server '${selectedAuthorizationServer}'`
+      `Federation discovery did not yield OpenID Federation metadata for authorization server '${selectedAuthorizationServer}'`
     );
   }
   return {
     ...federationResult,
-    authorization_server_federation_claims: authorizationServerResult.openid_federation_claims,
-    metadata: {
-      ...federationResult.metadata,
-      oauth_authorization_server: resolvedAuthorizationServer
-    }
+    authorization_server_federation_claims: authorizationServerResult.openid_federation_claims
   };
 }
 async function fallbackDiscovery(fetch, baseUrl, authorizationServer) {