@pagopa/io-wallet-oid4vp 1.2.0 → 1.3.0

package/dist/index.d.mts

@@ -399,8 +399,6 @@ declare function validateAuthorizationRequestParams(params: AuthorizationRequest
     request_uri_method?: never;
 }) & typeof params;
 
-declare function parseVpToken(vpToken: unknown): Record<string, string | string[]>;
-
 declare const zVpToken: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>>;
 type VpToken = z.infer<typeof zVpToken>;
 
@@ -511,72 +509,6 @@ interface FetchAuthorizationResponseOptions {
  */
 declare function fetchAuthorizationResponse(options: FetchAuthorizationResponseOptions): Promise<Openid4vpAuthorizationResponseResult>;
 
-declare function extractEncryptionJwkFromJwks(jwks: JwkSet, { kid, supportedAlgValues, }: {
-    kid?: string;
-    supportedAlgValues?: string[];
-}): {
-    [x: string]: unknown;
-    kty: string;
-    alg?: string | undefined;
-    crv?: string | undefined;
-    d?: string | undefined;
-    dp?: string | undefined;
-    dq?: string | undefined;
-    e?: string | undefined;
-    ext?: boolean | undefined;
-    k?: string | undefined;
-    key_ops?: string[] | undefined;
-    kid?: string | undefined;
-    n?: string | undefined;
-    oth?: {
-        [x: string]: unknown;
-        d?: string | undefined;
-        r?: string | undefined;
-        t?: string | undefined;
-    }[] | undefined;
-    p?: string | undefined;
-    q?: string | undefined;
-    qi?: string | undefined;
-    use?: string | undefined;
-    x?: string | undefined;
-    x5c?: string[] | undefined;
-    x5t?: string | undefined;
-    "x5t#S256"?: string | undefined;
-    x5u?: string | undefined;
-    y?: string | undefined;
-} | undefined;
-
-interface ParseJarmAuthorizationResponseOptions {
-    /**
-     * Parsed authorization request payload used to validate JARM claims.
-     */
-    authorizationRequestPayload: Openid4vpAuthorizationRequestPayload;
-    /**
-     * Callbacks used to decrypt and verify JARM JWT/JWE responses.
-     */
-    callbacks: Pick<CallbackContext, "decryptJwe" | "verifyJwt">;
-    /**
-     * Compact JARM authorization response (`response` parameter value).
-     */
-    jarmResponseJwt: string;
-    /**
-     * Current time used for temporal claim validation (`exp`, `nbf`).
-     * Defaults to current date-time when omitted.
-     */
-    now?: Date;
-}
-/**
- * Parses and validates a JARM authorization response for OpenID4VP.
- *
- * This function validates compact format, decrypts and/or verifies the JARM token,
- * parses the resulting OpenID4VP authorization response, and validates it against
- * the originating authorization request.
- *
- * @param options {@link ParseJarmAuthorizationResponseOptions}
- * @returns Parsed authorization response enriched with JARM metadata.
- */
-declare function parseJarmAuthorizationResponse(options: ParseJarmAuthorizationResponseOptions): Promise<ParseAuthorizationResponseResult>;
-
 declare const zJarmHeader: z.ZodObject<{
     apu: z.ZodOptional<z.ZodString>;
     apv: z.ZodOptional<z.ZodString>;
@@ -936,6 +868,8 @@ declare function verifyJarmAuthorizationResponse(options: VerifyJarmAuthorizatio
     type: JarmMode;
 }>;
 
+declare function parseVpToken(vpToken: unknown): Record<string, string | string[]>;
+
 interface ValidateOpenid4vpAuthorizationResponseOptions {
     /**
      * Parsed request payload used as validation source.
@@ -1001,8 +935,10 @@ declare function parseAuthorizationResponse(options: ParseAuthorizationResponseO
  * Generic error thrown during Oid4vp operations
  */
 declare class Oid4vpError extends Error {
-    readonly statusCode?: number | undefined;
-    constructor(message: string, statusCode?: number | undefined);
+    readonly statusCode?: number;
+    constructor(message: string, options?: {
+        statusCode?: number;
+    } & ErrorOptions);
 }
 /**
  * Error thrown by {@link parseAuthorizeRequest} when the passed
@@ -1010,30 +946,102 @@ declare class Oid4vpError extends Error {
  * are thrown
  */
 declare class ParseAuthorizeRequestError extends Oid4vpError {
-    readonly statusCode?: number | undefined;
-    constructor(message: string, statusCode?: number | undefined);
+    readonly statusCode?: number;
+    constructor(message: string, options?: {
+        statusCode?: number;
+    } & ErrorOptions);
 }
 /**
  * Error thrown by {@link fetchAuthorizationResponse}
  */
 declare class FetchAuthorizationResponseError extends Oid4vpError {
-    readonly statusCode?: number | undefined;
-    constructor(message: string, statusCode?: number | undefined);
+    readonly statusCode?: number;
+    constructor(message: string, options?: {
+        statusCode?: number;
+    } & ErrorOptions);
 }
 /**
  * Error thrown by {@link createAuthorizationResponse} in case there
  * are unexpected errors.
  */
 declare class CreateAuthorizationResponseError extends Oid4vpError {
-    readonly statusCode?: number | undefined;
-    constructor(message: string, statusCode?: number | undefined);
+    readonly statusCode?: number;
+    constructor(message: string, options?: {
+        statusCode?: number;
+    } & ErrorOptions);
 }
 /**
  * Error thrown when request_uri_method parameter has an invalid value.
  * Valid values are "get" or "post" (case-insensitive).
  */
 declare class InvalidRequestUriMethodError extends Oid4vpError {
-    constructor(message: string);
+    constructor(message: string, options?: ErrorOptions);
+}
+
+declare function extractEncryptionJwkFromJwks(jwks: JwkSet, { kid, supportedAlgValues, }: {
+    kid?: string;
+    supportedAlgValues?: string[];
+}): {
+    [x: string]: unknown;
+    kty: string;
+    alg?: string | undefined;
+    crv?: string | undefined;
+    d?: string | undefined;
+    dp?: string | undefined;
+    dq?: string | undefined;
+    e?: string | undefined;
+    ext?: boolean | undefined;
+    k?: string | undefined;
+    key_ops?: string[] | undefined;
+    kid?: string | undefined;
+    n?: string | undefined;
+    oth?: {
+        [x: string]: unknown;
+        d?: string | undefined;
+        r?: string | undefined;
+        t?: string | undefined;
+    }[] | undefined;
+    p?: string | undefined;
+    q?: string | undefined;
+    qi?: string | undefined;
+    use?: string | undefined;
+    x?: string | undefined;
+    x5c?: string[] | undefined;
+    x5t?: string | undefined;
+    "x5t#S256"?: string | undefined;
+    x5u?: string | undefined;
+    y?: string | undefined;
+} | undefined;
+
+interface ParseJarmAuthorizationResponseOptions {
+    /**
+     * Parsed authorization request payload used to validate JARM claims.
+     */
+    authorizationRequestPayload: Openid4vpAuthorizationRequestPayload;
+    /**
+     * Callbacks used to decrypt and verify JARM JWT/JWE responses.
+     */
+    callbacks: Pick<CallbackContext, "decryptJwe" | "verifyJwt">;
+    /**
+     * Compact JARM authorization response (`response` parameter value).
+     */
+    jarmResponseJwt: string;
+    /**
+     * Current time used for temporal claim validation (`exp`, `nbf`).
+     * Defaults to current date-time when omitted.
+     */
+    now?: Date;
 }
+/**
+ * Parses and validates a JARM authorization response for OpenID4VP.
+ *
+ * This function validates compact format, decrypts and/or verifies the JARM token,
+ * parses the resulting OpenID4VP authorization response, and validates it against
+ * the originating authorization request.
+ *
+ * @param options {@link ParseJarmAuthorizationResponseOptions}
+ * @returns Parsed authorization response enriched with JARM metadata.
+ */
+declare function parseJarmAuthorizationResponse(options: ParseJarmAuthorizationResponseOptions): Promise<ParseAuthorizationResponseResult>;
 
 export { type AuthorizationRequestUrlParams, ClientIdPrefix, type CreateAuthorizationRequestOptions, type CreateAuthorizationRequestOptionsV1_0, type CreateAuthorizationRequestOptionsV1_3, type CreateAuthorizationRequestResult, type CreateAuthorizationRequestResultV1_0, type CreateAuthorizationRequestResultV1_3, CreateAuthorizationResponseError, type CreateAuthorizationResponseOptions, type CreateAuthorizationResponseResult, type EncryptedJarmHeader, type FetchAuthorizationRequestOptions, type FetchAuthorizationRequestResult, FetchAuthorizationResponseError, type FetchAuthorizationResponseOptions, InvalidRequestUriMethodError, type JarOptionsV1_0, type JarOptionsV1_3, type JarmAuthorizationResponse, type JarmAuthorizationResponseEncryptedOnly, type JarmHeader, JarmMode, Oid4vpError, type Openid4vpAuthorizationRequestHeader, type Openid4vpAuthorizationRequestHeaderV1_0, type Openid4vpAuthorizationRequestHeaderV1_3, type Openid4vpAuthorizationRequestPayload, type Openid4vpAuthorizationResponse, type Openid4vpAuthorizationResponseResult, type ParseAuthorizationResponseOptions, type ParseAuthorizationResponseResult, ParseAuthorizeRequestError, type ParseAuthorizeRequestOptions, type ParseJarmAuthorizationResponseOptions, type ParsedAuthorizeRequestResult, type ParsedQrCode, type ValidateOpenid4vpAuthorizationResponseOptions, type ValidateOpenid4vpAuthorizationResponseResult, type VerifyJarmAuthorizationResponseOptions, type VerifyJarmAuthorizationResponseResult, createAuthorizationRequest, createAuthorizationResponse, extractClientIdPrefix, extractEncryptionJwkFromJwks, fetchAuthorizationRequest, fetchAuthorizationResponse, fetchRequestObjectJwt, parseAuthorizationResponse, parseAuthorizeRequest, parseJarmAuthorizationResponse, parseVpToken, validateAuthorizationRequestParams, validateOpenid4vpAuthorizationResponsePayload, verifyJarmAuthorizationResponse, zAuthorizationRequestUrlParams, zEncryptedJarmHeader, zJarmAuthorizationResponse, zJarmAuthorizationResponseEncryptedOnly, zJarmHeader, zOpenid4vpAuthorizationRequestHeaderV1_0, zOpenid4vpAuthorizationRequestHeaderV1_3, zOpenid4vpAuthorizationRequestPayload, zOpenid4vpAuthorizationResponse, zOpenid4vpAuthorizationResponseResult, zVpToken };

package/dist/index.d.ts

@@ -399,8 +399,6 @@ declare function validateAuthorizationRequestParams(params: AuthorizationRequest
     request_uri_method?: never;
 }) & typeof params;
 
-declare function parseVpToken(vpToken: unknown): Record<string, string | string[]>;
-
 declare const zVpToken: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>>;
 type VpToken = z.infer<typeof zVpToken>;
 
@@ -511,72 +509,6 @@ interface FetchAuthorizationResponseOptions {
  */
 declare function fetchAuthorizationResponse(options: FetchAuthorizationResponseOptions): Promise<Openid4vpAuthorizationResponseResult>;
 
-declare function extractEncryptionJwkFromJwks(jwks: JwkSet, { kid, supportedAlgValues, }: {
-    kid?: string;
-    supportedAlgValues?: string[];
-}): {
-    [x: string]: unknown;
-    kty: string;
-    alg?: string | undefined;
-    crv?: string | undefined;
-    d?: string | undefined;
-    dp?: string | undefined;
-    dq?: string | undefined;
-    e?: string | undefined;
-    ext?: boolean | undefined;
-    k?: string | undefined;
-    key_ops?: string[] | undefined;
-    kid?: string | undefined;
-    n?: string | undefined;
-    oth?: {
-        [x: string]: unknown;
-        d?: string | undefined;
-        r?: string | undefined;
-        t?: string | undefined;
-    }[] | undefined;
-    p?: string | undefined;
-    q?: string | undefined;
-    qi?: string | undefined;
-    use?: string | undefined;
-    x?: string | undefined;
-    x5c?: string[] | undefined;
-    x5t?: string | undefined;
-    "x5t#S256"?: string | undefined;
-    x5u?: string | undefined;
-    y?: string | undefined;
-} | undefined;
-
-interface ParseJarmAuthorizationResponseOptions {
-    /**
-     * Parsed authorization request payload used to validate JARM claims.
-     */
-    authorizationRequestPayload: Openid4vpAuthorizationRequestPayload;
-    /**
-     * Callbacks used to decrypt and verify JARM JWT/JWE responses.
-     */
-    callbacks: Pick<CallbackContext, "decryptJwe" | "verifyJwt">;
-    /**
-     * Compact JARM authorization response (`response` parameter value).
-     */
-    jarmResponseJwt: string;
-    /**
-     * Current time used for temporal claim validation (`exp`, `nbf`).
-     * Defaults to current date-time when omitted.
-     */
-    now?: Date;
-}
-/**
- * Parses and validates a JARM authorization response for OpenID4VP.
- *
- * This function validates compact format, decrypts and/or verifies the JARM token,
- * parses the resulting OpenID4VP authorization response, and validates it against
- * the originating authorization request.
- *
- * @param options {@link ParseJarmAuthorizationResponseOptions}
- * @returns Parsed authorization response enriched with JARM metadata.
- */
-declare function parseJarmAuthorizationResponse(options: ParseJarmAuthorizationResponseOptions): Promise<ParseAuthorizationResponseResult>;
-
 declare const zJarmHeader: z.ZodObject<{
     apu: z.ZodOptional<z.ZodString>;
     apv: z.ZodOptional<z.ZodString>;
@@ -936,6 +868,8 @@ declare function verifyJarmAuthorizationResponse(options: VerifyJarmAuthorizatio
     type: JarmMode;
 }>;
 
+declare function parseVpToken(vpToken: unknown): Record<string, string | string[]>;
+
 interface ValidateOpenid4vpAuthorizationResponseOptions {
     /**
      * Parsed request payload used as validation source.
@@ -1001,8 +935,10 @@ declare function parseAuthorizationResponse(options: ParseAuthorizationResponseO
  * Generic error thrown during Oid4vp operations
  */
 declare class Oid4vpError extends Error {
-    readonly statusCode?: number | undefined;
-    constructor(message: string, statusCode?: number | undefined);
+    readonly statusCode?: number;
+    constructor(message: string, options?: {
+        statusCode?: number;
+    } & ErrorOptions);
 }
 /**
  * Error thrown by {@link parseAuthorizeRequest} when the passed
@@ -1010,30 +946,102 @@ declare class Oid4vpError extends Error {
  * are thrown
  */
 declare class ParseAuthorizeRequestError extends Oid4vpError {
-    readonly statusCode?: number | undefined;
-    constructor(message: string, statusCode?: number | undefined);
+    readonly statusCode?: number;
+    constructor(message: string, options?: {
+        statusCode?: number;
+    } & ErrorOptions);
 }
 /**
  * Error thrown by {@link fetchAuthorizationResponse}
  */
 declare class FetchAuthorizationResponseError extends Oid4vpError {
-    readonly statusCode?: number | undefined;
-    constructor(message: string, statusCode?: number | undefined);
+    readonly statusCode?: number;
+    constructor(message: string, options?: {
+        statusCode?: number;
+    } & ErrorOptions);
 }
 /**
  * Error thrown by {@link createAuthorizationResponse} in case there
  * are unexpected errors.
  */
 declare class CreateAuthorizationResponseError extends Oid4vpError {
-    readonly statusCode?: number | undefined;
-    constructor(message: string, statusCode?: number | undefined);
+    readonly statusCode?: number;
+    constructor(message: string, options?: {
+        statusCode?: number;
+    } & ErrorOptions);
 }
 /**
  * Error thrown when request_uri_method parameter has an invalid value.
  * Valid values are "get" or "post" (case-insensitive).
  */
 declare class InvalidRequestUriMethodError extends Oid4vpError {
-    constructor(message: string);
+    constructor(message: string, options?: ErrorOptions);
+}
+
+declare function extractEncryptionJwkFromJwks(jwks: JwkSet, { kid, supportedAlgValues, }: {
+    kid?: string;
+    supportedAlgValues?: string[];
+}): {
+    [x: string]: unknown;
+    kty: string;
+    alg?: string | undefined;
+    crv?: string | undefined;
+    d?: string | undefined;
+    dp?: string | undefined;
+    dq?: string | undefined;
+    e?: string | undefined;
+    ext?: boolean | undefined;
+    k?: string | undefined;
+    key_ops?: string[] | undefined;
+    kid?: string | undefined;
+    n?: string | undefined;
+    oth?: {
+        [x: string]: unknown;
+        d?: string | undefined;
+        r?: string | undefined;
+        t?: string | undefined;
+    }[] | undefined;
+    p?: string | undefined;
+    q?: string | undefined;
+    qi?: string | undefined;
+    use?: string | undefined;
+    x?: string | undefined;
+    x5c?: string[] | undefined;
+    x5t?: string | undefined;
+    "x5t#S256"?: string | undefined;
+    x5u?: string | undefined;
+    y?: string | undefined;
+} | undefined;
+
+interface ParseJarmAuthorizationResponseOptions {
+    /**
+     * Parsed authorization request payload used to validate JARM claims.
+     */
+    authorizationRequestPayload: Openid4vpAuthorizationRequestPayload;
+    /**
+     * Callbacks used to decrypt and verify JARM JWT/JWE responses.
+     */
+    callbacks: Pick<CallbackContext, "decryptJwe" | "verifyJwt">;
+    /**
+     * Compact JARM authorization response (`response` parameter value).
+     */
+    jarmResponseJwt: string;
+    /**
+     * Current time used for temporal claim validation (`exp`, `nbf`).
+     * Defaults to current date-time when omitted.
+     */
+    now?: Date;
 }
+/**
+ * Parses and validates a JARM authorization response for OpenID4VP.
+ *
+ * This function validates compact format, decrypts and/or verifies the JARM token,
+ * parses the resulting OpenID4VP authorization response, and validates it against
+ * the originating authorization request.
+ *
+ * @param options {@link ParseJarmAuthorizationResponseOptions}
+ * @returns Parsed authorization response enriched with JARM metadata.
+ */
+declare function parseJarmAuthorizationResponse(options: ParseJarmAuthorizationResponseOptions): Promise<ParseAuthorizationResponseResult>;
 
 export { type AuthorizationRequestUrlParams, ClientIdPrefix, type CreateAuthorizationRequestOptions, type CreateAuthorizationRequestOptionsV1_0, type CreateAuthorizationRequestOptionsV1_3, type CreateAuthorizationRequestResult, type CreateAuthorizationRequestResultV1_0, type CreateAuthorizationRequestResultV1_3, CreateAuthorizationResponseError, type CreateAuthorizationResponseOptions, type CreateAuthorizationResponseResult, type EncryptedJarmHeader, type FetchAuthorizationRequestOptions, type FetchAuthorizationRequestResult, FetchAuthorizationResponseError, type FetchAuthorizationResponseOptions, InvalidRequestUriMethodError, type JarOptionsV1_0, type JarOptionsV1_3, type JarmAuthorizationResponse, type JarmAuthorizationResponseEncryptedOnly, type JarmHeader, JarmMode, Oid4vpError, type Openid4vpAuthorizationRequestHeader, type Openid4vpAuthorizationRequestHeaderV1_0, type Openid4vpAuthorizationRequestHeaderV1_3, type Openid4vpAuthorizationRequestPayload, type Openid4vpAuthorizationResponse, type Openid4vpAuthorizationResponseResult, type ParseAuthorizationResponseOptions, type ParseAuthorizationResponseResult, ParseAuthorizeRequestError, type ParseAuthorizeRequestOptions, type ParseJarmAuthorizationResponseOptions, type ParsedAuthorizeRequestResult, type ParsedQrCode, type ValidateOpenid4vpAuthorizationResponseOptions, type ValidateOpenid4vpAuthorizationResponseResult, type VerifyJarmAuthorizationResponseOptions, type VerifyJarmAuthorizationResponseResult, createAuthorizationRequest, createAuthorizationResponse, extractClientIdPrefix, extractEncryptionJwkFromJwks, fetchAuthorizationRequest, fetchAuthorizationResponse, fetchRequestObjectJwt, parseAuthorizationResponse, parseAuthorizeRequest, parseJarmAuthorizationResponse, parseVpToken, validateAuthorizationRequestParams, validateOpenid4vpAuthorizationResponsePayload, verifyJarmAuthorizationResponse, zAuthorizationRequestUrlParams, zEncryptedJarmHeader, zJarmAuthorizationResponse, zJarmAuthorizationResponseEncryptedOnly, zJarmHeader, zOpenid4vpAuthorizationRequestHeaderV1_0, zOpenid4vpAuthorizationRequestHeaderV1_3, zOpenid4vpAuthorizationRequestPayload, zOpenid4vpAuthorizationResponse, zOpenid4vpAuthorizationResponseResult, zVpToken };