@pagopa/io-wallet-utils 0.7.7 → 1.0.0-alpha-20260211164158

package/dist/index.d.mts

@@ -1,4 +1,61 @@
-export { Fetch, JsonParseError, ValidationError, addSecondsToDate, dateToSeconds, decodeUtf8String, encodeToBase64Url, parseWithErrorHandling } from '@openid4vc/utils';
+import { HttpMethod } from '@openid4vc/utils';
+export { ContentType, Fetch, JsonParseError, ValidationError, addSecondsToDate, createFetcher, dateToSeconds, decodeUtf8String, encodeToBase64Url, formatZodError, parseWithErrorHandling, zHttpsUrl } from '@openid4vc/utils';
+
+/**
+ * Supported versions of the Italian Wallet technical specifications
+ */
+declare enum ItWalletSpecsVersion {
+    V1_0 = "V1_0",
+    V1_3 = "V1_3"
+}
+/**
+ * Configuration options for the IO Wallet SDK
+ */
+interface IoWalletSdkConfigOptions {
+    /**
+     * The version of the Italian Wallet specification to use.
+     * REQUIRED - must be explicitly set by the user.
+     *
+     * Version differences:
+     * - V1_0: Uses singular `proof` object with explicit `proof_type` field
+     * - V1_3: Uses plural `proofs` object with JWT array and requires key attestation
+     *
+     * @example
+     * const config = new IoWalletSdkConfig({ itWalletSpecsVersion: ItWalletSpecsVersion.V1_3 });
+     */
+    itWalletSpecsVersion: ItWalletSpecsVersion;
+}
+/**
+ * Configuration class for the IO Wallet SDK
+ *
+ * This class manages the version of the Italian Wallet technical specifications
+ * to use throughout the SDK. The version determines the format of credential
+ * requests and responses.
+ *
+ * @example Basic usage
+ * const config = new IoWalletSdkConfig({ itWalletSpecsVersion: ItWalletSpecsVersion.V1_0 });
+ * console.log(config.itWalletSpecsVersion); // ItWalletSpecsVersion.V1_0
+ *
+ * @example Type guard usage
+ * if (config.isVersion(ItWalletSpecsVersion.V1_3)) {
+ *   // TypeScript narrows config.itWalletSpecsVersion to ItWalletSpecsVersion.V1_3
+ * }
+ */
+declare class IoWalletSdkConfig {
+    readonly itWalletSpecsVersion: ItWalletSpecsVersion;
+    constructor(options: IoWalletSdkConfigOptions);
+    /**
+     * Type guard for version checking
+     *
+     * @param version - The version to check against
+     * @returns True if the config's version matches the provided version
+     *
+     * @internal
+     */
+    isVersion<V extends ItWalletSpecsVersion>(version: V): this is {
+        itWalletSpecsVersion: V;
+    } & IoWalletSdkConfig;
+}
 
 /**
  * HTTP Content-Type constants for OAuth2 requests
@@ -43,6 +100,29 @@ declare class UnexpectedStatusCodeError extends Error {
         statusCode: number;
     });
 }
+/**
+ * An error subclass thrown when an unsupported Italian Wallet specification version is requested.
+ *
+ * This error is thrown when:
+ * - A feature or method is called with a version that it doesn't support
+ * - An invalid version identifier is provided
+ *
+ * @example
+ * throw new ItWalletSpecsVersionError(
+ *   'createCredentialRequest',
+ *   '2.0.0',
+ *   [ItWalletSpecsVersion.V1_0, ItWalletSpecsVersion.V1_3]
+ * );
+ * // Error: Feature "createCredentialRequest" does not support version 2.0.0.
+ * // Supported versions: V1_0, V1_3
+ */
+declare class ItWalletSpecsVersionError extends Error {
+    readonly feature: string;
+    readonly requestedVersion: string;
+    readonly supportedVersions: readonly string[];
+    readonly code = "IT_WALLET_SPECS_VERSION_ERROR";
+    constructor(feature: string, requestedVersion: string, supportedVersions: readonly string[]);
+}
 
 /**
  * Check if a response is in the expected status, otherwise throw an error
@@ -57,4 +137,11 @@ declare const hasStatusOrThrow: (status: number, customError?: typeof Unexpected
  */
 declare const parseRawHttpResponse: <T extends Record<string, unknown>>(response: Response) => Promise<T> | Promise<string>;
 
-export { CONTENT_TYPES, HEADERS, UnexpectedStatusCodeError, hasStatusOrThrow, parseRawHttpResponse, serializeAttrs };
+type FetchHeaders = globalThis.Headers;
+interface RequestLike {
+    headers: FetchHeaders;
+    method: HttpMethod;
+    url: string;
+}
+
+export { CONTENT_TYPES, type FetchHeaders, HEADERS, IoWalletSdkConfig, type IoWalletSdkConfigOptions, ItWalletSpecsVersion, ItWalletSpecsVersionError, type RequestLike, UnexpectedStatusCodeError, hasStatusOrThrow, parseRawHttpResponse, serializeAttrs };

package/dist/index.d.ts

@@ -1,4 +1,61 @@
-export { Fetch, JsonParseError, ValidationError, addSecondsToDate, dateToSeconds, decodeUtf8String, encodeToBase64Url, parseWithErrorHandling } from '@openid4vc/utils';
+import { HttpMethod } from '@openid4vc/utils';
+export { ContentType, Fetch, JsonParseError, ValidationError, addSecondsToDate, createFetcher, dateToSeconds, decodeUtf8String, encodeToBase64Url, formatZodError, parseWithErrorHandling, zHttpsUrl } from '@openid4vc/utils';
+
+/**
+ * Supported versions of the Italian Wallet technical specifications
+ */
+declare enum ItWalletSpecsVersion {
+    V1_0 = "V1_0",
+    V1_3 = "V1_3"
+}
+/**
+ * Configuration options for the IO Wallet SDK
+ */
+interface IoWalletSdkConfigOptions {
+    /**
+     * The version of the Italian Wallet specification to use.
+     * REQUIRED - must be explicitly set by the user.
+     *
+     * Version differences:
+     * - V1_0: Uses singular `proof` object with explicit `proof_type` field
+     * - V1_3: Uses plural `proofs` object with JWT array and requires key attestation
+     *
+     * @example
+     * const config = new IoWalletSdkConfig({ itWalletSpecsVersion: ItWalletSpecsVersion.V1_3 });
+     */
+    itWalletSpecsVersion: ItWalletSpecsVersion;
+}
+/**
+ * Configuration class for the IO Wallet SDK
+ *
+ * This class manages the version of the Italian Wallet technical specifications
+ * to use throughout the SDK. The version determines the format of credential
+ * requests and responses.
+ *
+ * @example Basic usage
+ * const config = new IoWalletSdkConfig({ itWalletSpecsVersion: ItWalletSpecsVersion.V1_0 });
+ * console.log(config.itWalletSpecsVersion); // ItWalletSpecsVersion.V1_0
+ *
+ * @example Type guard usage
+ * if (config.isVersion(ItWalletSpecsVersion.V1_3)) {
+ *   // TypeScript narrows config.itWalletSpecsVersion to ItWalletSpecsVersion.V1_3
+ * }
+ */
+declare class IoWalletSdkConfig {
+    readonly itWalletSpecsVersion: ItWalletSpecsVersion;
+    constructor(options: IoWalletSdkConfigOptions);
+    /**
+     * Type guard for version checking
+     *
+     * @param version - The version to check against
+     * @returns True if the config's version matches the provided version
+     *
+     * @internal
+     */
+    isVersion<V extends ItWalletSpecsVersion>(version: V): this is {
+        itWalletSpecsVersion: V;
+    } & IoWalletSdkConfig;
+}
 
 /**
  * HTTP Content-Type constants for OAuth2 requests
@@ -43,6 +100,29 @@ declare class UnexpectedStatusCodeError extends Error {
         statusCode: number;
     });
 }
+/**
+ * An error subclass thrown when an unsupported Italian Wallet specification version is requested.
+ *
+ * This error is thrown when:
+ * - A feature or method is called with a version that it doesn't support
+ * - An invalid version identifier is provided
+ *
+ * @example
+ * throw new ItWalletSpecsVersionError(
+ *   'createCredentialRequest',
+ *   '2.0.0',
+ *   [ItWalletSpecsVersion.V1_0, ItWalletSpecsVersion.V1_3]
+ * );
+ * // Error: Feature "createCredentialRequest" does not support version 2.0.0.
+ * // Supported versions: V1_0, V1_3
+ */
+declare class ItWalletSpecsVersionError extends Error {
+    readonly feature: string;
+    readonly requestedVersion: string;
+    readonly supportedVersions: readonly string[];
+    readonly code = "IT_WALLET_SPECS_VERSION_ERROR";
+    constructor(feature: string, requestedVersion: string, supportedVersions: readonly string[]);
+}
 
 /**
  * Check if a response is in the expected status, otherwise throw an error
@@ -57,4 +137,11 @@ declare const hasStatusOrThrow: (status: number, customError?: typeof Unexpected
  */
 declare const parseRawHttpResponse: <T extends Record<string, unknown>>(response: Response) => Promise<T> | Promise<string>;
 
-export { CONTENT_TYPES, HEADERS, UnexpectedStatusCodeError, hasStatusOrThrow, parseRawHttpResponse, serializeAttrs };
+type FetchHeaders = globalThis.Headers;
+interface RequestLike {
+    headers: FetchHeaders;
+    method: HttpMethod;
+    url: string;
+}
+
+export { CONTENT_TYPES, type FetchHeaders, HEADERS, IoWalletSdkConfig, type IoWalletSdkConfigOptions, ItWalletSpecsVersion, ItWalletSpecsVersionError, type RequestLike, UnexpectedStatusCodeError, hasStatusOrThrow, parseRawHttpResponse, serializeAttrs };

package/dist/index.js

@@ -21,21 +21,52 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   CONTENT_TYPES: () => CONTENT_TYPES,
+  ContentType: () => import_utils.ContentType,
   HEADERS: () => HEADERS,
+  IoWalletSdkConfig: () => IoWalletSdkConfig,
+  ItWalletSpecsVersion: () => ItWalletSpecsVersion,
+  ItWalletSpecsVersionError: () => ItWalletSpecsVersionError,
   JsonParseError: () => import_utils.JsonParseError,
   UnexpectedStatusCodeError: () => UnexpectedStatusCodeError,
   ValidationError: () => import_utils.ValidationError,
   addSecondsToDate: () => import_utils.addSecondsToDate,
+  createFetcher: () => import_utils.createFetcher,
   dateToSeconds: () => import_utils.dateToSeconds,
   decodeUtf8String: () => import_utils.decodeUtf8String,
   encodeToBase64Url: () => import_utils.encodeToBase64Url,
+  formatZodError: () => import_utils.formatZodError,
   hasStatusOrThrow: () => hasStatusOrThrow,
   parseRawHttpResponse: () => parseRawHttpResponse,
   parseWithErrorHandling: () => import_utils.parseWithErrorHandling,
-  serializeAttrs: () => serializeAttrs
+  serializeAttrs: () => serializeAttrs,
+  zHttpsUrl: () => import_utils.zHttpsUrl
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/config.ts
+var ItWalletSpecsVersion = /* @__PURE__ */ ((ItWalletSpecsVersion2) => {
+  ItWalletSpecsVersion2["V1_0"] = "V1_0";
+  ItWalletSpecsVersion2["V1_3"] = "V1_3";
+  return ItWalletSpecsVersion2;
+})(ItWalletSpecsVersion || {});
+var IoWalletSdkConfig = class {
+  itWalletSpecsVersion;
+  constructor(options) {
+    this.itWalletSpecsVersion = options.itWalletSpecsVersion;
+  }
+  /**
+   * Type guard for version checking
+   *
+   * @param version - The version to check against
+   * @returns True if the config's version matches the provided version
+   *
+   * @internal
+   */
+  isVersion(version) {
+    return this.itWalletSpecsVersion === version;
+  }
+};
+
 // src/constants.ts
 var CONTENT_TYPES = {
   FORM_URLENCODED: "application/x-www-form-urlencoded",
@@ -69,6 +100,23 @@ var UnexpectedStatusCodeError = class extends Error {
     this.statusCode = statusCode;
   }
 };
+var ItWalletSpecsVersionError = class _ItWalletSpecsVersionError extends Error {
+  constructor(feature, requestedVersion, supportedVersions) {
+    super(
+      `Feature "${feature}" does not support version ${requestedVersion}.
+Supported versions: ${supportedVersions.join(", ")}`
+    );
+    this.feature = feature;
+    this.requestedVersion = requestedVersion;
+    this.supportedVersions = supportedVersions;
+    this.name = "ItWalletSpecsVersionError";
+    const ErrorConstructor = Error;
+    if (typeof ErrorConstructor.captureStackTrace === "function") {
+      ErrorConstructor.captureStackTrace(this, _ItWalletSpecsVersionError);
+    }
+  }
+  code = "IT_WALLET_SPECS_VERSION_ERROR";
+};
 
 // src/fetcher.ts
 var hasStatusOrThrow = (status, customError) => async (res) => {
@@ -90,17 +138,24 @@ var import_utils = require("@openid4vc/utils");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CONTENT_TYPES,
+  ContentType,
   HEADERS,
+  IoWalletSdkConfig,
+  ItWalletSpecsVersion,
+  ItWalletSpecsVersionError,
   JsonParseError,
   UnexpectedStatusCodeError,
   ValidationError,
   addSecondsToDate,
+  createFetcher,
   dateToSeconds,
   decodeUtf8String,
   encodeToBase64Url,
+  formatZodError,
   hasStatusOrThrow,
   parseRawHttpResponse,
   parseWithErrorHandling,
-  serializeAttrs
+  serializeAttrs,
+  zHttpsUrl
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/constants.ts","../src/errors.ts","../src/fetcher.ts"],"sourcesContent":["export * from \"./constants\";\nexport * from \"./errors\";\nexport * from \"./fetcher\";\n\nexport {\n  type Fetch,\n  JsonParseError,\n  ValidationError,\n  addSecondsToDate,\n  dateToSeconds,\n  decodeUtf8String,\n  encodeToBase64Url,\n  parseWithErrorHandling,\n} from \"@openid4vc/utils\";\n","/**\n * HTTP Content-Type constants for OAuth2 requests\n */\nexport const CONTENT_TYPES = {\n  FORM_URLENCODED: \"application/x-www-form-urlencoded\",\n  JSON: \"application/json\",\n} as const;\n\n/**\n * HTTP Header constants\n */\nexport const HEADERS = {\n  AUTHORIZATION: \"Authorization\",\n  CONTENT_TYPE: \"Content-Type\",\n  DPOP: \"DPoP\",\n  OAUTH_CLIENT_ATTESTATION: \"OAuth-Client-Attestation\",\n  OAUTH_CLIENT_ATTESTATION_POP: \"OAuth-Client-Attestation-PoP\",\n} as const;\n","// An error reason that supports both a string and a generic JSON object\ntype GenericErrorReason = Record<string, unknown> | string;\n\n/**\n * utility to format a set of attributes into an error message string\n *\n * @example\n * // returns \"foo=value bar=(list, item)\"\n * serializeAttrs({ foo: \"value\", bar: [\"list\", \"item\"] })\n *\n * @param attrs A key value record set\n * @returns a human-readable serialization of the set\n */\nexport const serializeAttrs = (\n  attrs: Record<string, GenericErrorReason | number | string[] | undefined>,\n): string =>\n  Object.entries(attrs)\n    .filter(([, v]) => v !== undefined)\n    .map(([k, v]) => {\n      if (Array.isArray(v)) return [k, `(${v.join(\", \")})`];\n      if (typeof v !== \"string\") return [k, JSON.stringify(v)];\n      return [k, v];\n    })\n    .map((_) => _.join(\"=\"))\n    .join(\" \");\n\n/**\n * An error subclass thrown when an HTTP request has a status code different from the one expected.\n */\nexport class UnexpectedStatusCodeError extends Error {\n  code = \"ERR_UNEXPECTED_STATUS_CODE\";\n  reason: GenericErrorReason;\n  statusCode: number;\n\n  constructor({\n    message,\n    reason,\n    statusCode,\n  }: {\n    message: string;\n    reason: GenericErrorReason;\n    statusCode: number;\n  }) {\n    super(serializeAttrs({ message, reason, statusCode }));\n    this.reason = reason;\n    this.statusCode = statusCode;\n  }\n}\n","import { UnexpectedStatusCodeError } from \"./errors\";\n\n/**\n * Check if a response is in the expected status, otherwise throw an error\n * @param status - The expected status\n * @param customError - A custom error compatible with {@link UnexpectedStatusCodeError}\n * @throws UnexpectedStatusCodeError if the status is different from the one expected\n * @returns The given response object\n */\nexport const hasStatusOrThrow =\n  (status: number, customError?: typeof UnexpectedStatusCodeError) =>\n  async (res: Response): Promise<Response> => {\n    if (res.status !== status) {\n      const ErrorClass = customError ?? UnexpectedStatusCodeError;\n      throw new ErrorClass({\n        message: `Http request failed. Expected ${status}, got ${res.status}, url: ${res.url}`,\n        reason: await parseRawHttpResponse(res), // Pass the response body as reason so the original error can surface\n        statusCode: res.status,\n      });\n    }\n    return res;\n  };\n\n/**\n * Utility function to parse a raw HTTP response as JSON if supported, otherwise as text.\n */\nexport const parseRawHttpResponse = <T extends Record<string, unknown>>(\n  response: Response,\n) =>\n  response.headers.get(\"content-type\")?.includes(\"application/json\")\n    ? (response.json() as Promise<T>)\n    : response.text();\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGO,IAAM,gBAAgB;AAAA,EAC3B,iBAAiB;AAAA,EACjB,MAAM;AACR;AAKO,IAAM,UAAU;AAAA,EACrB,eAAe;AAAA,EACf,cAAc;AAAA,EACd,MAAM;AAAA,EACN,0BAA0B;AAAA,EAC1B,8BAA8B;AAChC;;;ACJO,IAAM,iBAAiB,CAC5B,UAEA,OAAO,QAAQ,KAAK,EACjB,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,MAAM,MAAS,EACjC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM;AACf,MAAI,MAAM,QAAQ,CAAC,EAAG,QAAO,CAAC,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC,GAAG;AACpD,MAAI,OAAO,MAAM,SAAU,QAAO,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC;AACvD,SAAO,CAAC,GAAG,CAAC;AACd,CAAC,EACA,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,EACtB,KAAK,GAAG;AAKN,IAAM,4BAAN,cAAwC,MAAM;AAAA,EACnD,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EAEA,YAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAIG;AACD,UAAM,eAAe,EAAE,SAAS,QAAQ,WAAW,CAAC,CAAC;AACrD,SAAK,SAAS;AACd,SAAK,aAAa;AAAA,EACpB;AACF;;;ACtCO,IAAM,mBACX,CAAC,QAAgB,gBACjB,OAAO,QAAqC;AAC1C,MAAI,IAAI,WAAW,QAAQ;AACzB,UAAM,aAAa,eAAe;AAClC,UAAM,IAAI,WAAW;AAAA,MACnB,SAAS,iCAAiC,MAAM,SAAS,IAAI,MAAM,UAAU,IAAI,GAAG;AAAA,MACpF,QAAQ,MAAM,qBAAqB,GAAG;AAAA;AAAA,MACtC,YAAY,IAAI;AAAA,IAClB,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAKK,IAAM,uBAAuB,CAClC,aAEA,SAAS,QAAQ,IAAI,cAAc,GAAG,SAAS,kBAAkB,IAC5D,SAAS,KAAK,IACf,SAAS,KAAK;;;AH3BpB,mBASO;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/config.ts","../src/constants.ts","../src/errors.ts","../src/fetcher.ts"],"sourcesContent":["export * from \"./config\";\nexport * from \"./constants\";\nexport * from \"./errors\";\nexport * from \"./fetcher\";\nexport type * from \"./globals\";\n\nexport {\n  ContentType,\n  type Fetch,\n  JsonParseError,\n  ValidationError,\n  addSecondsToDate,\n  createFetcher,\n  dateToSeconds,\n  decodeUtf8String,\n  encodeToBase64Url,\n  formatZodError,\n  parseWithErrorHandling,\n  zHttpsUrl,\n} from \"@openid4vc/utils\";\n","/**\n * Supported versions of the Italian Wallet technical specifications\n */\nexport enum ItWalletSpecsVersion {\n  V1_0 = \"V1_0\",\n  V1_3 = \"V1_3\",\n}\n\n/**\n * Configuration options for the IO Wallet SDK\n */\nexport interface IoWalletSdkConfigOptions {\n  /**\n   * The version of the Italian Wallet specification to use.\n   * REQUIRED - must be explicitly set by the user.\n   *\n   * Version differences:\n   * - V1_0: Uses singular `proof` object with explicit `proof_type` field\n   * - V1_3: Uses plural `proofs` object with JWT array and requires key attestation\n   *\n   * @example\n   * const config = new IoWalletSdkConfig({ itWalletSpecsVersion: ItWalletSpecsVersion.V1_3 });\n   */\n  itWalletSpecsVersion: ItWalletSpecsVersion;\n}\n\n/**\n * Configuration class for the IO Wallet SDK\n *\n * This class manages the version of the Italian Wallet technical specifications\n * to use throughout the SDK. The version determines the format of credential\n * requests and responses.\n *\n * @example Basic usage\n * const config = new IoWalletSdkConfig({ itWalletSpecsVersion: ItWalletSpecsVersion.V1_0 });\n * console.log(config.itWalletSpecsVersion); // ItWalletSpecsVersion.V1_0\n *\n * @example Type guard usage\n * if (config.isVersion(ItWalletSpecsVersion.V1_3)) {\n *   // TypeScript narrows config.itWalletSpecsVersion to ItWalletSpecsVersion.V1_3\n * }\n */\nexport class IoWalletSdkConfig {\n  public readonly itWalletSpecsVersion: ItWalletSpecsVersion;\n\n  constructor(options: IoWalletSdkConfigOptions) {\n    this.itWalletSpecsVersion = options.itWalletSpecsVersion;\n  }\n\n  /**\n   * Type guard for version checking\n   *\n   * @param version - The version to check against\n   * @returns True if the config's version matches the provided version\n   *\n   * @internal\n   */\n  isVersion<V extends ItWalletSpecsVersion>(\n    version: V,\n  ): this is { itWalletSpecsVersion: V } & IoWalletSdkConfig {\n    return this.itWalletSpecsVersion === version;\n  }\n}\n","/**\n * HTTP Content-Type constants for OAuth2 requests\n */\nexport const CONTENT_TYPES = {\n  FORM_URLENCODED: \"application/x-www-form-urlencoded\",\n  JSON: \"application/json\",\n} as const;\n\n/**\n * HTTP Header constants\n */\nexport const HEADERS = {\n  AUTHORIZATION: \"Authorization\",\n  CONTENT_TYPE: \"Content-Type\",\n  DPOP: \"DPoP\",\n  OAUTH_CLIENT_ATTESTATION: \"OAuth-Client-Attestation\",\n  OAUTH_CLIENT_ATTESTATION_POP: \"OAuth-Client-Attestation-PoP\",\n} as const;\n","// An error reason that supports both a string and a generic JSON object\ntype GenericErrorReason = Record<string, unknown> | string;\n\n/**\n * utility to format a set of attributes into an error message string\n *\n * @example\n * // returns \"foo=value bar=(list, item)\"\n * serializeAttrs({ foo: \"value\", bar: [\"list\", \"item\"] })\n *\n * @param attrs A key value record set\n * @returns a human-readable serialization of the set\n */\nexport const serializeAttrs = (\n  attrs: Record<string, GenericErrorReason | number | string[] | undefined>,\n): string =>\n  Object.entries(attrs)\n    .filter(([, v]) => v !== undefined)\n    .map(([k, v]) => {\n      if (Array.isArray(v)) return [k, `(${v.join(\", \")})`];\n      if (typeof v !== \"string\") return [k, JSON.stringify(v)];\n      return [k, v];\n    })\n    .map((_) => _.join(\"=\"))\n    .join(\" \");\n\n/**\n * An error subclass thrown when an HTTP request has a status code different from the one expected.\n */\nexport class UnexpectedStatusCodeError extends Error {\n  code = \"ERR_UNEXPECTED_STATUS_CODE\";\n  reason: GenericErrorReason;\n  statusCode: number;\n\n  constructor({\n    message,\n    reason,\n    statusCode,\n  }: {\n    message: string;\n    reason: GenericErrorReason;\n    statusCode: number;\n  }) {\n    super(serializeAttrs({ message, reason, statusCode }));\n    this.reason = reason;\n    this.statusCode = statusCode;\n  }\n}\n\n/**\n * An error subclass thrown when an unsupported Italian Wallet specification version is requested.\n *\n * This error is thrown when:\n * - A feature or method is called with a version that it doesn't support\n * - An invalid version identifier is provided\n *\n * @example\n * throw new ItWalletSpecsVersionError(\n *   'createCredentialRequest',\n *   '2.0.0',\n *   [ItWalletSpecsVersion.V1_0, ItWalletSpecsVersion.V1_3]\n * );\n * // Error: Feature \"createCredentialRequest\" does not support version 2.0.0.\n * // Supported versions: V1_0, V1_3\n */\nexport class ItWalletSpecsVersionError extends Error {\n  public readonly code = \"IT_WALLET_SPECS_VERSION_ERROR\";\n\n  constructor(\n    public readonly feature: string,\n    public readonly requestedVersion: string,\n    public readonly supportedVersions: readonly string[],\n  ) {\n    super(\n      `Feature \"${feature}\" does not support version ${requestedVersion}.\\n` +\n        `Supported versions: ${supportedVersions.join(\", \")}`,\n    );\n    this.name = \"ItWalletSpecsVersionError\";\n\n    // Maintain proper stack trace for V8 engines (Node.js, Chrome)\n    const ErrorConstructor = Error as {\n      captureStackTrace?: (target: object, constructor: unknown) => void;\n    };\n    if (typeof ErrorConstructor.captureStackTrace === \"function\") {\n      ErrorConstructor.captureStackTrace(this, ItWalletSpecsVersionError);\n    }\n  }\n}\n","import { UnexpectedStatusCodeError } from \"./errors\";\n\n/**\n * Check if a response is in the expected status, otherwise throw an error\n * @param status - The expected status\n * @param customError - A custom error compatible with {@link UnexpectedStatusCodeError}\n * @throws UnexpectedStatusCodeError if the status is different from the one expected\n * @returns The given response object\n */\nexport const hasStatusOrThrow =\n  (status: number, customError?: typeof UnexpectedStatusCodeError) =>\n  async (res: Response): Promise<Response> => {\n    if (res.status !== status) {\n      const ErrorClass = customError ?? UnexpectedStatusCodeError;\n      throw new ErrorClass({\n        message: `Http request failed. Expected ${status}, got ${res.status}, url: ${res.url}`,\n        reason: await parseRawHttpResponse(res), // Pass the response body as reason so the original error can surface\n        statusCode: res.status,\n      });\n    }\n    return res;\n  };\n\n/**\n * Utility function to parse a raw HTTP response as JSON if supported, otherwise as text.\n */\nexport const parseRawHttpResponse = <T extends Record<string, unknown>>(\n  response: Response,\n) =>\n  response.headers.get(\"content-type\")?.includes(\"application/json\")\n    ? (response.json() as Promise<T>)\n    : response.text();\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGO,IAAK,uBAAL,kBAAKA,0BAAL;AACL,EAAAA,sBAAA,UAAO;AACP,EAAAA,sBAAA,UAAO;AAFG,SAAAA;AAAA,GAAA;AAuCL,IAAM,oBAAN,MAAwB;AAAA,EACb;AAAA,EAEhB,YAAY,SAAmC;AAC7C,SAAK,uBAAuB,QAAQ;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,UACE,SACyD;AACzD,WAAO,KAAK,yBAAyB;AAAA,EACvC;AACF;;;AC3DO,IAAM,gBAAgB;AAAA,EAC3B,iBAAiB;AAAA,EACjB,MAAM;AACR;AAKO,IAAM,UAAU;AAAA,EACrB,eAAe;AAAA,EACf,cAAc;AAAA,EACd,MAAM;AAAA,EACN,0BAA0B;AAAA,EAC1B,8BAA8B;AAChC;;;ACJO,IAAM,iBAAiB,CAC5B,UAEA,OAAO,QAAQ,KAAK,EACjB,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,MAAM,MAAS,EACjC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM;AACf,MAAI,MAAM,QAAQ,CAAC,EAAG,QAAO,CAAC,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC,GAAG;AACpD,MAAI,OAAO,MAAM,SAAU,QAAO,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC;AACvD,SAAO,CAAC,GAAG,CAAC;AACd,CAAC,EACA,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,EACtB,KAAK,GAAG;AAKN,IAAM,4BAAN,cAAwC,MAAM;AAAA,EACnD,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EAEA,YAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAIG;AACD,UAAM,eAAe,EAAE,SAAS,QAAQ,WAAW,CAAC,CAAC;AACrD,SAAK,SAAS;AACd,SAAK,aAAa;AAAA,EACpB;AACF;AAkBO,IAAM,4BAAN,MAAM,mCAAkC,MAAM;AAAA,EAGnD,YACkB,SACA,kBACA,mBAChB;AACA;AAAA,MACE,YAAY,OAAO,8BAA8B,gBAAgB;AAAA,sBACxC,kBAAkB,KAAK,IAAI,CAAC;AAAA,IACvD;AAPgB;AACA;AACA;AAMhB,SAAK,OAAO;AAGZ,UAAM,mBAAmB;AAGzB,QAAI,OAAO,iBAAiB,sBAAsB,YAAY;AAC5D,uBAAiB,kBAAkB,MAAM,0BAAyB;AAAA,IACpE;AAAA,EACF;AAAA,EApBgB,OAAO;AAqBzB;;;AC9EO,IAAM,mBACX,CAAC,QAAgB,gBACjB,OAAO,QAAqC;AAC1C,MAAI,IAAI,WAAW,QAAQ;AACzB,UAAM,aAAa,eAAe;AAClC,UAAM,IAAI,WAAW;AAAA,MACnB,SAAS,iCAAiC,MAAM,SAAS,IAAI,MAAM,UAAU,IAAI,GAAG;AAAA,MACpF,QAAQ,MAAM,qBAAqB,GAAG;AAAA;AAAA,MACtC,YAAY,IAAI;AAAA,IAClB,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAKK,IAAM,uBAAuB,CAClC,aAEA,SAAS,QAAQ,IAAI,cAAc,GAAG,SAAS,kBAAkB,IAC5D,SAAS,KAAK,IACf,SAAS,KAAK;;;AJzBpB,mBAaO;","names":["ItWalletSpecsVersion"]}

package/dist/index.mjs

@@ -1,3 +1,27 @@
+// src/config.ts
+var ItWalletSpecsVersion = /* @__PURE__ */ ((ItWalletSpecsVersion2) => {
+  ItWalletSpecsVersion2["V1_0"] = "V1_0";
+  ItWalletSpecsVersion2["V1_3"] = "V1_3";
+  return ItWalletSpecsVersion2;
+})(ItWalletSpecsVersion || {});
+var IoWalletSdkConfig = class {
+  itWalletSpecsVersion;
+  constructor(options) {
+    this.itWalletSpecsVersion = options.itWalletSpecsVersion;
+  }
+  /**
+   * Type guard for version checking
+   *
+   * @param version - The version to check against
+   * @returns True if the config's version matches the provided version
+   *
+   * @internal
+   */
+  isVersion(version) {
+    return this.itWalletSpecsVersion === version;
+  }
+};
+
 // src/constants.ts
 var CONTENT_TYPES = {
   FORM_URLENCODED: "application/x-www-form-urlencoded",
@@ -31,6 +55,23 @@ var UnexpectedStatusCodeError = class extends Error {
     this.statusCode = statusCode;
   }
 };
+var ItWalletSpecsVersionError = class _ItWalletSpecsVersionError extends Error {
+  constructor(feature, requestedVersion, supportedVersions) {
+    super(
+      `Feature "${feature}" does not support version ${requestedVersion}.
+Supported versions: ${supportedVersions.join(", ")}`
+    );
+    this.feature = feature;
+    this.requestedVersion = requestedVersion;
+    this.supportedVersions = supportedVersions;
+    this.name = "ItWalletSpecsVersionError";
+    const ErrorConstructor = Error;
+    if (typeof ErrorConstructor.captureStackTrace === "function") {
+      ErrorConstructor.captureStackTrace(this, _ItWalletSpecsVersionError);
+    }
+  }
+  code = "IT_WALLET_SPECS_VERSION_ERROR";
+};
 
 // src/fetcher.ts
 var hasStatusOrThrow = (status, customError) => async (res) => {
@@ -49,27 +90,38 @@ var parseRawHttpResponse = (response) => response.headers.get("content-type")?.i
 
 // src/index.ts
 import {
+  ContentType,
   JsonParseError,
   ValidationError,
   addSecondsToDate,
+  createFetcher,
   dateToSeconds,
   decodeUtf8String,
   encodeToBase64Url,
-  parseWithErrorHandling
+  formatZodError,
+  parseWithErrorHandling,
+  zHttpsUrl
 } from "@openid4vc/utils";
 export {
   CONTENT_TYPES,
+  ContentType,
   HEADERS,
+  IoWalletSdkConfig,
+  ItWalletSpecsVersion,
+  ItWalletSpecsVersionError,
   JsonParseError,
   UnexpectedStatusCodeError,
   ValidationError,
   addSecondsToDate,
+  createFetcher,
   dateToSeconds,
   decodeUtf8String,
   encodeToBase64Url,
+  formatZodError,
   hasStatusOrThrow,
   parseRawHttpResponse,
   parseWithErrorHandling,
-  serializeAttrs
+  serializeAttrs,
+  zHttpsUrl
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts","../src/errors.ts","../src/fetcher.ts","../src/index.ts"],"sourcesContent":["/**\n * HTTP Content-Type constants for OAuth2 requests\n */\nexport const CONTENT_TYPES = {\n  FORM_URLENCODED: \"application/x-www-form-urlencoded\",\n  JSON: \"application/json\",\n} as const;\n\n/**\n * HTTP Header constants\n */\nexport const HEADERS = {\n  AUTHORIZATION: \"Authorization\",\n  CONTENT_TYPE: \"Content-Type\",\n  DPOP: \"DPoP\",\n  OAUTH_CLIENT_ATTESTATION: \"OAuth-Client-Attestation\",\n  OAUTH_CLIENT_ATTESTATION_POP: \"OAuth-Client-Attestation-PoP\",\n} as const;\n","// An error reason that supports both a string and a generic JSON object\ntype GenericErrorReason = Record<string, unknown> | string;\n\n/**\n * utility to format a set of attributes into an error message string\n *\n * @example\n * // returns \"foo=value bar=(list, item)\"\n * serializeAttrs({ foo: \"value\", bar: [\"list\", \"item\"] })\n *\n * @param attrs A key value record set\n * @returns a human-readable serialization of the set\n */\nexport const serializeAttrs = (\n  attrs: Record<string, GenericErrorReason | number | string[] | undefined>,\n): string =>\n  Object.entries(attrs)\n    .filter(([, v]) => v !== undefined)\n    .map(([k, v]) => {\n      if (Array.isArray(v)) return [k, `(${v.join(\", \")})`];\n      if (typeof v !== \"string\") return [k, JSON.stringify(v)];\n      return [k, v];\n    })\n    .map((_) => _.join(\"=\"))\n    .join(\" \");\n\n/**\n * An error subclass thrown when an HTTP request has a status code different from the one expected.\n */\nexport class UnexpectedStatusCodeError extends Error {\n  code = \"ERR_UNEXPECTED_STATUS_CODE\";\n  reason: GenericErrorReason;\n  statusCode: number;\n\n  constructor({\n    message,\n    reason,\n    statusCode,\n  }: {\n    message: string;\n    reason: GenericErrorReason;\n    statusCode: number;\n  }) {\n    super(serializeAttrs({ message, reason, statusCode }));\n    this.reason = reason;\n    this.statusCode = statusCode;\n  }\n}\n","import { UnexpectedStatusCodeError } from \"./errors\";\n\n/**\n * Check if a response is in the expected status, otherwise throw an error\n * @param status - The expected status\n * @param customError - A custom error compatible with {@link UnexpectedStatusCodeError}\n * @throws UnexpectedStatusCodeError if the status is different from the one expected\n * @returns The given response object\n */\nexport const hasStatusOrThrow =\n  (status: number, customError?: typeof UnexpectedStatusCodeError) =>\n  async (res: Response): Promise<Response> => {\n    if (res.status !== status) {\n      const ErrorClass = customError ?? UnexpectedStatusCodeError;\n      throw new ErrorClass({\n        message: `Http request failed. Expected ${status}, got ${res.status}, url: ${res.url}`,\n        reason: await parseRawHttpResponse(res), // Pass the response body as reason so the original error can surface\n        statusCode: res.status,\n      });\n    }\n    return res;\n  };\n\n/**\n * Utility function to parse a raw HTTP response as JSON if supported, otherwise as text.\n */\nexport const parseRawHttpResponse = <T extends Record<string, unknown>>(\n  response: Response,\n) =>\n  response.headers.get(\"content-type\")?.includes(\"application/json\")\n    ? (response.json() as Promise<T>)\n    : response.text();\n","export * from \"./constants\";\nexport * from \"./errors\";\nexport * from \"./fetcher\";\n\nexport {\n  type Fetch,\n  JsonParseError,\n  ValidationError,\n  addSecondsToDate,\n  dateToSeconds,\n  decodeUtf8String,\n  encodeToBase64Url,\n  parseWithErrorHandling,\n} from \"@openid4vc/utils\";\n"],"mappings":";AAGO,IAAM,gBAAgB;AAAA,EAC3B,iBAAiB;AAAA,EACjB,MAAM;AACR;AAKO,IAAM,UAAU;AAAA,EACrB,eAAe;AAAA,EACf,cAAc;AAAA,EACd,MAAM;AAAA,EACN,0BAA0B;AAAA,EAC1B,8BAA8B;AAChC;;;ACJO,IAAM,iBAAiB,CAC5B,UAEA,OAAO,QAAQ,KAAK,EACjB,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,MAAM,MAAS,EACjC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM;AACf,MAAI,MAAM,QAAQ,CAAC,EAAG,QAAO,CAAC,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC,GAAG;AACpD,MAAI,OAAO,MAAM,SAAU,QAAO,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC;AACvD,SAAO,CAAC,GAAG,CAAC;AACd,CAAC,EACA,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,EACtB,KAAK,GAAG;AAKN,IAAM,4BAAN,cAAwC,MAAM;AAAA,EACnD,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EAEA,YAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAIG;AACD,UAAM,eAAe,EAAE,SAAS,QAAQ,WAAW,CAAC,CAAC;AACrD,SAAK,SAAS;AACd,SAAK,aAAa;AAAA,EACpB;AACF;;;ACtCO,IAAM,mBACX,CAAC,QAAgB,gBACjB,OAAO,QAAqC;AAC1C,MAAI,IAAI,WAAW,QAAQ;AACzB,UAAM,aAAa,eAAe;AAClC,UAAM,IAAI,WAAW;AAAA,MACnB,SAAS,iCAAiC,MAAM,SAAS,IAAI,MAAM,UAAU,IAAI,GAAG;AAAA,MACpF,QAAQ,MAAM,qBAAqB,GAAG;AAAA;AAAA,MACtC,YAAY,IAAI;AAAA,IAClB,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAKK,IAAM,uBAAuB,CAClC,aAEA,SAAS,QAAQ,IAAI,cAAc,GAAG,SAAS,kBAAkB,IAC5D,SAAS,KAAK,IACf,SAAS,KAAK;;;AC3BpB;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../src/config.ts","../src/constants.ts","../src/errors.ts","../src/fetcher.ts","../src/index.ts"],"sourcesContent":["/**\n * Supported versions of the Italian Wallet technical specifications\n */\nexport enum ItWalletSpecsVersion {\n  V1_0 = \"V1_0\",\n  V1_3 = \"V1_3\",\n}\n\n/**\n * Configuration options for the IO Wallet SDK\n */\nexport interface IoWalletSdkConfigOptions {\n  /**\n   * The version of the Italian Wallet specification to use.\n   * REQUIRED - must be explicitly set by the user.\n   *\n   * Version differences:\n   * - V1_0: Uses singular `proof` object with explicit `proof_type` field\n   * - V1_3: Uses plural `proofs` object with JWT array and requires key attestation\n   *\n   * @example\n   * const config = new IoWalletSdkConfig({ itWalletSpecsVersion: ItWalletSpecsVersion.V1_3 });\n   */\n  itWalletSpecsVersion: ItWalletSpecsVersion;\n}\n\n/**\n * Configuration class for the IO Wallet SDK\n *\n * This class manages the version of the Italian Wallet technical specifications\n * to use throughout the SDK. The version determines the format of credential\n * requests and responses.\n *\n * @example Basic usage\n * const config = new IoWalletSdkConfig({ itWalletSpecsVersion: ItWalletSpecsVersion.V1_0 });\n * console.log(config.itWalletSpecsVersion); // ItWalletSpecsVersion.V1_0\n *\n * @example Type guard usage\n * if (config.isVersion(ItWalletSpecsVersion.V1_3)) {\n *   // TypeScript narrows config.itWalletSpecsVersion to ItWalletSpecsVersion.V1_3\n * }\n */\nexport class IoWalletSdkConfig {\n  public readonly itWalletSpecsVersion: ItWalletSpecsVersion;\n\n  constructor(options: IoWalletSdkConfigOptions) {\n    this.itWalletSpecsVersion = options.itWalletSpecsVersion;\n  }\n\n  /**\n   * Type guard for version checking\n   *\n   * @param version - The version to check against\n   * @returns True if the config's version matches the provided version\n   *\n   * @internal\n   */\n  isVersion<V extends ItWalletSpecsVersion>(\n    version: V,\n  ): this is { itWalletSpecsVersion: V } & IoWalletSdkConfig {\n    return this.itWalletSpecsVersion === version;\n  }\n}\n","/**\n * HTTP Content-Type constants for OAuth2 requests\n */\nexport const CONTENT_TYPES = {\n  FORM_URLENCODED: \"application/x-www-form-urlencoded\",\n  JSON: \"application/json\",\n} as const;\n\n/**\n * HTTP Header constants\n */\nexport const HEADERS = {\n  AUTHORIZATION: \"Authorization\",\n  CONTENT_TYPE: \"Content-Type\",\n  DPOP: \"DPoP\",\n  OAUTH_CLIENT_ATTESTATION: \"OAuth-Client-Attestation\",\n  OAUTH_CLIENT_ATTESTATION_POP: \"OAuth-Client-Attestation-PoP\",\n} as const;\n","// An error reason that supports both a string and a generic JSON object\ntype GenericErrorReason = Record<string, unknown> | string;\n\n/**\n * utility to format a set of attributes into an error message string\n *\n * @example\n * // returns \"foo=value bar=(list, item)\"\n * serializeAttrs({ foo: \"value\", bar: [\"list\", \"item\"] })\n *\n * @param attrs A key value record set\n * @returns a human-readable serialization of the set\n */\nexport const serializeAttrs = (\n  attrs: Record<string, GenericErrorReason | number | string[] | undefined>,\n): string =>\n  Object.entries(attrs)\n    .filter(([, v]) => v !== undefined)\n    .map(([k, v]) => {\n      if (Array.isArray(v)) return [k, `(${v.join(\", \")})`];\n      if (typeof v !== \"string\") return [k, JSON.stringify(v)];\n      return [k, v];\n    })\n    .map((_) => _.join(\"=\"))\n    .join(\" \");\n\n/**\n * An error subclass thrown when an HTTP request has a status code different from the one expected.\n */\nexport class UnexpectedStatusCodeError extends Error {\n  code = \"ERR_UNEXPECTED_STATUS_CODE\";\n  reason: GenericErrorReason;\n  statusCode: number;\n\n  constructor({\n    message,\n    reason,\n    statusCode,\n  }: {\n    message: string;\n    reason: GenericErrorReason;\n    statusCode: number;\n  }) {\n    super(serializeAttrs({ message, reason, statusCode }));\n    this.reason = reason;\n    this.statusCode = statusCode;\n  }\n}\n\n/**\n * An error subclass thrown when an unsupported Italian Wallet specification version is requested.\n *\n * This error is thrown when:\n * - A feature or method is called with a version that it doesn't support\n * - An invalid version identifier is provided\n *\n * @example\n * throw new ItWalletSpecsVersionError(\n *   'createCredentialRequest',\n *   '2.0.0',\n *   [ItWalletSpecsVersion.V1_0, ItWalletSpecsVersion.V1_3]\n * );\n * // Error: Feature \"createCredentialRequest\" does not support version 2.0.0.\n * // Supported versions: V1_0, V1_3\n */\nexport class ItWalletSpecsVersionError extends Error {\n  public readonly code = \"IT_WALLET_SPECS_VERSION_ERROR\";\n\n  constructor(\n    public readonly feature: string,\n    public readonly requestedVersion: string,\n    public readonly supportedVersions: readonly string[],\n  ) {\n    super(\n      `Feature \"${feature}\" does not support version ${requestedVersion}.\\n` +\n        `Supported versions: ${supportedVersions.join(\", \")}`,\n    );\n    this.name = \"ItWalletSpecsVersionError\";\n\n    // Maintain proper stack trace for V8 engines (Node.js, Chrome)\n    const ErrorConstructor = Error as {\n      captureStackTrace?: (target: object, constructor: unknown) => void;\n    };\n    if (typeof ErrorConstructor.captureStackTrace === \"function\") {\n      ErrorConstructor.captureStackTrace(this, ItWalletSpecsVersionError);\n    }\n  }\n}\n","import { UnexpectedStatusCodeError } from \"./errors\";\n\n/**\n * Check if a response is in the expected status, otherwise throw an error\n * @param status - The expected status\n * @param customError - A custom error compatible with {@link UnexpectedStatusCodeError}\n * @throws UnexpectedStatusCodeError if the status is different from the one expected\n * @returns The given response object\n */\nexport const hasStatusOrThrow =\n  (status: number, customError?: typeof UnexpectedStatusCodeError) =>\n  async (res: Response): Promise<Response> => {\n    if (res.status !== status) {\n      const ErrorClass = customError ?? UnexpectedStatusCodeError;\n      throw new ErrorClass({\n        message: `Http request failed. Expected ${status}, got ${res.status}, url: ${res.url}`,\n        reason: await parseRawHttpResponse(res), // Pass the response body as reason so the original error can surface\n        statusCode: res.status,\n      });\n    }\n    return res;\n  };\n\n/**\n * Utility function to parse a raw HTTP response as JSON if supported, otherwise as text.\n */\nexport const parseRawHttpResponse = <T extends Record<string, unknown>>(\n  response: Response,\n) =>\n  response.headers.get(\"content-type\")?.includes(\"application/json\")\n    ? (response.json() as Promise<T>)\n    : response.text();\n","export * from \"./config\";\nexport * from \"./constants\";\nexport * from \"./errors\";\nexport * from \"./fetcher\";\nexport type * from \"./globals\";\n\nexport {\n  ContentType,\n  type Fetch,\n  JsonParseError,\n  ValidationError,\n  addSecondsToDate,\n  createFetcher,\n  dateToSeconds,\n  decodeUtf8String,\n  encodeToBase64Url,\n  formatZodError,\n  parseWithErrorHandling,\n  zHttpsUrl,\n} from \"@openid4vc/utils\";\n"],"mappings":";AAGO,IAAK,uBAAL,kBAAKA,0BAAL;AACL,EAAAA,sBAAA,UAAO;AACP,EAAAA,sBAAA,UAAO;AAFG,SAAAA;AAAA,GAAA;AAuCL,IAAM,oBAAN,MAAwB;AAAA,EACb;AAAA,EAEhB,YAAY,SAAmC;AAC7C,SAAK,uBAAuB,QAAQ;AAAA,EACtC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,UACE,SACyD;AACzD,WAAO,KAAK,yBAAyB;AAAA,EACvC;AACF;;;AC3DO,IAAM,gBAAgB;AAAA,EAC3B,iBAAiB;AAAA,EACjB,MAAM;AACR;AAKO,IAAM,UAAU;AAAA,EACrB,eAAe;AAAA,EACf,cAAc;AAAA,EACd,MAAM;AAAA,EACN,0BAA0B;AAAA,EAC1B,8BAA8B;AAChC;;;ACJO,IAAM,iBAAiB,CAC5B,UAEA,OAAO,QAAQ,KAAK,EACjB,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,MAAM,MAAS,EACjC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM;AACf,MAAI,MAAM,QAAQ,CAAC,EAAG,QAAO,CAAC,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC,GAAG;AACpD,MAAI,OAAO,MAAM,SAAU,QAAO,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC;AACvD,SAAO,CAAC,GAAG,CAAC;AACd,CAAC,EACA,IAAI,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,EACtB,KAAK,GAAG;AAKN,IAAM,4BAAN,cAAwC,MAAM;AAAA,EACnD,OAAO;AAAA,EACP;AAAA,EACA;AAAA,EAEA,YAAY;AAAA,IACV;AAAA,IACA;AAAA,IACA;AAAA,EACF,GAIG;AACD,UAAM,eAAe,EAAE,SAAS,QAAQ,WAAW,CAAC,CAAC;AACrD,SAAK,SAAS;AACd,SAAK,aAAa;AAAA,EACpB;AACF;AAkBO,IAAM,4BAAN,MAAM,mCAAkC,MAAM;AAAA,EAGnD,YACkB,SACA,kBACA,mBAChB;AACA;AAAA,MACE,YAAY,OAAO,8BAA8B,gBAAgB;AAAA,sBACxC,kBAAkB,KAAK,IAAI,CAAC;AAAA,IACvD;AAPgB;AACA;AACA;AAMhB,SAAK,OAAO;AAGZ,UAAM,mBAAmB;AAGzB,QAAI,OAAO,iBAAiB,sBAAsB,YAAY;AAC5D,uBAAiB,kBAAkB,MAAM,0BAAyB;AAAA,IACpE;AAAA,EACF;AAAA,EApBgB,OAAO;AAqBzB;;;AC9EO,IAAM,mBACX,CAAC,QAAgB,gBACjB,OAAO,QAAqC;AAC1C,MAAI,IAAI,WAAW,QAAQ;AACzB,UAAM,aAAa,eAAe;AAClC,UAAM,IAAI,WAAW;AAAA,MACnB,SAAS,iCAAiC,MAAM,SAAS,IAAI,MAAM,UAAU,IAAI,GAAG;AAAA,MACpF,QAAQ,MAAM,qBAAqB,GAAG;AAAA;AAAA,MACtC,YAAY,IAAI;AAAA,IAClB,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAKK,IAAM,uBAAuB,CAClC,aAEA,SAAS,QAAQ,IAAI,cAAc,GAAG,SAAS,kBAAkB,IAC5D,SAAS,KAAK,IACf,SAAS,KAAK;;;ACzBpB;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":["ItWalletSpecsVersion"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pagopa/io-wallet-utils",
-  "version": "0.7.7",
+  "version": "1.0.0-alpha-20260211164158",
   "files": [
     "dist"
   ],