@fxhash/errors 0.0.13 → 0.0.14

package/dist/index.js

@@ -1,541 +1,577 @@
-// src/errors/common.ts
-var UnexpectedRichErrorMessages = {
-  dev: "Unexpected error",
-  user: "Unexpected error"
-};
+import { capitalize, failure, success } from "@fxhash/utils";
+
+//#region src/errors/common.ts
+/**
+* Static error messages for "unexpected" errors. This payload is reused accross
+* the stack for when error data is missing.
+*/
+const UnexpectedRichErrorMessages = {
+	dev: "Unexpected error",
+	user: "Unexpected error"
+};
+/**
+* An error which provides messages intended for devs & users. This class should
+* be used accross our stack to provide meaningful error objects which can be
+* used for both developers & users. When typed errors are returned, if they all
+* are instances of `RichError`, then client applications can take some simple
+* shortcuts to provide error feedback to both the developer and the user.
+*
+* @example
+*
+* ```ts
+* export class SomeCustomError extends RichError {
+*   name = "SomeCustomError" as const // `code` will have same value
+*   messages = {
+*     dev: "some message for devs",
+*     user: "some message for users"
+*   }
+* }
+* ```
+*
+* ```ts
+* const res = await something()
+* if (res.isFailure()) {
+*   const err = res.error // if this is typed as `RichError`
+*   displayErrorOnUI(err.userMessage) // safely display user message
+* }
+* ```
+*/
 var RichError = class extends Error {
-  constructor(messagesOverride) {
-    super();
-    this.messages = UnexpectedRichErrorMessages;
-    if (messagesOverride) {
-      this.messagesOverride = messagesOverride;
-    }
-  }
-  _message(target) {
-    return this.messagesOverride?.[target] || this.messages[target] || UnexpectedRichErrorMessages[target];
-  }
-  get message() {
-    return this._message("dev");
-  }
-  get userMessage() {
-    return this._message("user");
-  }
-  get code() {
-    return this.name;
-  }
-  serialize() {
-    return {
-      code: this.code,
-      messages: this.messagesOverride || this.messages
-    };
-  }
-  static get code() {
-    return this.name;
-  }
-  /**
-   * Instanciates a Rich Error, trying to match the serialized error with the
-   * provided Rich Error classes. The `code` property of the serialized payload
-   * is matched against `RichError.name`
-   *
-   * @param serialized A rich error serialized
-   * @param expected A list of Rich Error classes which are expected. If the
-   * serialized error doesn't match any of these, UnexpectedRichError will be
-   * returned.
-   *
-   * @returns An instance of Rich Error which type matches the `code` property,
-   * or {@link UnexpectedRichError} if no match.
-   */
-  static parse(serialized, expected) {
-    for (const RichErrorClass of expected) {
-      const maybeError = new RichErrorClass(serialized.messages);
-      if (maybeError.code === serialized.code) {
-        return maybeError;
-      }
-    }
-    return new UnexpectedRichError(serialized.messages);
-  }
-  /**
-   * Returns a new instance of {@link UnexpectedRichError}
-   * @param messagesOverride Optional overrides of default unexpected messages
-   */
-  static Unexpected(messagesOverride) {
-    return new UnexpectedRichError(messagesOverride);
-  }
-};
+	constructor(messagesOverride) {
+		super();
+		this.messages = UnexpectedRichErrorMessages;
+		if (messagesOverride) this.messagesOverride = messagesOverride;
+	}
+	_message(target) {
+		return this.messagesOverride?.[target] || this.messages[target] || UnexpectedRichErrorMessages[target];
+	}
+	get message() {
+		return this._message("dev");
+	}
+	get userMessage() {
+		return this._message("user");
+	}
+	get code() {
+		return this.name;
+	}
+	serialize() {
+		return {
+			code: this.code,
+			messages: this.messagesOverride || this.messages
+		};
+	}
+	static get code() {
+		return this.name;
+	}
+	/**
+	* Instanciates a Rich Error, trying to match the serialized error with the
+	* provided Rich Error classes. The `code` property of the serialized payload
+	* is matched against `RichError.name`
+	*
+	* @param serialized A rich error serialized
+	* @param expected A list of Rich Error classes which are expected. If the
+	* serialized error doesn't match any of these, UnexpectedRichError will be
+	* returned.
+	*
+	* @returns An instance of Rich Error which type matches the `code` property,
+	* or {@link UnexpectedRichError} if no match.
+	*/
+	static parse(serialized, expected) {
+		for (const RichErrorClass of expected) {
+			const maybeError = new RichErrorClass(serialized.messages);
+			if (maybeError.code === serialized.code) return maybeError;
+		}
+		return new UnexpectedRichError(serialized.messages);
+	}
+	/**
+	* Returns a new instance of {@link UnexpectedRichError}
+	* @param messagesOverride Optional overrides of default unexpected messages
+	*/
+	static Unexpected(messagesOverride) {
+		return new UnexpectedRichError(messagesOverride);
+	}
+};
+/**
+* A general-purpose error which is thrown when no better error could be
+* inferred from the available context.
+*/
 var UnexpectedRichError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "UnexpectedRichError";
-    this.messages = UnexpectedRichErrorMessages;
-  }
+	constructor(..._args) {
+		super(..._args);
+		this.name = "UnexpectedRichError";
+		this.messages = UnexpectedRichErrorMessages;
+	}
 };
 
-// src/errors/network.ts
+//#endregion
+//#region src/errors/network.ts
 var NetworkRichError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "NetworkRichError";
-    this.messages = {
-      dev: "An network error occured.",
-      user: "Network error"
-    };
-  }
+	constructor(..._args) {
+		super(..._args);
+		this.name = "NetworkRichError";
+		this.messages = {
+			dev: "An network error occured.",
+			user: "Network error"
+		};
+	}
 };
 
-// src/errors/graphql/common.ts
-var GraphQLErrors = [NetworkRichError, UnexpectedRichError];
+//#endregion
+//#region src/errors/graphql/common.ts
+const GraphQLErrors = [NetworkRichError, UnexpectedRichError];
 
-// src/errors/graphql/email-otp.ts
+//#endregion
+//#region src/errors/graphql/email-otp.ts
 var EmailOTPLockedError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "EmailOTPLockedError";
-    this.messages = {
-      dev: "Email locked 2h because too many attempts",
-      user: "This email is locked for verification during 2 hours because of too many attempts in a short period of time"
-    };
-  }
-};
-var EmailOTPRequestErrors = [
-  EmailOTPLockedError
-];
+	constructor(..._args) {
+		super(..._args);
+		this.name = "EmailOTPLockedError";
+		this.messages = {
+			dev: "Email locked 2h because too many attempts",
+			user: "This email is locked for verification during 2 hours because of too many attempts in a short period of time"
+		};
+	}
+};
+const EmailOTPRequestErrors = [EmailOTPLockedError];
 var EmailOTPInvalidError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "EmailOTPInvalidError";
-    this.messages = {
-      dev: "Email verification failed because OTP is invalid",
-      user: "The validation code is invalid"
-    };
-  }
+	constructor(..._args2) {
+		super(..._args2);
+		this.name = "EmailOTPInvalidError";
+		this.messages = {
+			dev: "Email verification failed because OTP is invalid",
+			user: "The validation code is invalid"
+		};
+	}
 };
 var EmailOTPExpiredError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "EmailOTPExpiredError";
-    this.messages = {
-      dev: "Email verification failed because OTP has expired. A new OTP request must be initiated",
-      user: "Verification code has expired. Please make another request."
-    };
-  }
-};
-var EmailOTPVerificationErrors = [EmailOTPInvalidError, EmailOTPExpiredError, EmailOTPLockedError];
+	constructor(..._args3) {
+		super(..._args3);
+		this.name = "EmailOTPExpiredError";
+		this.messages = {
+			dev: "Email verification failed because OTP has expired. A new OTP request must be initiated",
+			user: "Verification code has expired. Please make another request."
+		};
+	}
+};
+const EmailOTPVerificationErrors = [
+	EmailOTPInvalidError,
+	EmailOTPExpiredError,
+	EmailOTPLockedError
+];
 
-// src/utils/rich-error.ts
-import { failure, success } from "@fxhash/utils";
+//#endregion
+//#region src/utils/rich-error.ts
+/**
+* Instanciate a new {@link RichError} using a declarative object. This is
+* useful when Rich Error are instanciated programmatically when type is
+* unknown.
+*/
 function richError(params) {
-  return Object.assign(new RichError(), params);
+	return Object.assign(new RichError(), params);
 }
 function isFxhashErrorExtensions(ext) {
-  return typeof ext === "object" && ext.version === "fxhash@0.1.0";
+	return typeof ext === "object" && ext.version === "fxhash@0.1.0";
 }
+/**
+* Test whether a given value is implementing the {@link IRichErrorMessages}
+* interface.
+* @param value Any value
+*/
 function isRichErrorMessages(value) {
-  if (typeof value !== "object") return false;
-  return typeof value.dev === "string" || typeof value.user === "string";
+	if (typeof value !== "object") return false;
+	return typeof value.dev === "string" || typeof value.user === "string";
 }
+/**
+* Parses the GraphQL error object into a RichError. This function detects
+* fxhash error extensions for outputting user error messages returned by
+* the backend.
+*
+* @param error A GraphQL error response
+*
+* @returns An "untyped" rich error constructed by parsing the GraphQL error
+*/
 function richErrorFromGraphQLError(error) {
-  if (error.graphQLErrors.length > 0) {
-    const gqlError = error.graphQLErrors[0];
-    if (isFxhashErrorExtensions(gqlError.extensions)) {
-      return richError({
-        name: gqlError.extensions.richError.code,
-        messages: gqlError.extensions.richError.messages
-      });
-    }
-    return new UnexpectedRichError();
-  }
-  if (error.networkError) {
-    return new NetworkRichError();
-  }
-  return new UnexpectedRichError();
+	if (error.graphQLErrors.length > 0) {
+		const gqlError = error.graphQLErrors[0];
+		if (isFxhashErrorExtensions(gqlError.extensions)) return richError({
+			name: gqlError.extensions.richError.code,
+			messages: gqlError.extensions.richError.messages
+		});
+		return new UnexpectedRichError();
+	}
+	if (error.networkError) return new NetworkRichError();
+	return new UnexpectedRichError();
 }
+/**
+* Parses the GraphQL error response to find the fxhash GraphQL error extension,
+* which is used to instanciate a Rich Error from a list of provided RichErrors.
+* The `name` constant property of such classes will be compared to the `code`
+* property of the fxhash error extension to find a match.
+*
+* @param graphQLError GraphQL error response
+* @param expectedErrors An array of RichError classes which will be parsed to
+* find matches between the RichError `name` constant and the `code` returned
+* by the GraphQL fxhash error extension.
+*
+* @returns A RichError instance matchin the error code, or
+* {@link NetworkRichError} if a network error occured, else
+* {@link UnexpectedRichError}
+*/
 function typedRichErrorFromGraphQLError(graphQLError, expectedErrors) {
-  if (graphQLError.networkError) {
-    return new NetworkRichError();
-  }
-  if (graphQLError.graphQLErrors.length > 0) {
-    const gqlError = graphQLError.graphQLErrors[0];
-    if (isFxhashErrorExtensions(gqlError.extensions)) {
-      return RichError.parse(gqlError.extensions.richError, expectedErrors);
-    }
-    return new UnexpectedRichError();
-  }
-  return new UnexpectedRichError();
+	if (graphQLError.networkError) return new NetworkRichError();
+	if (graphQLError.graphQLErrors.length > 0) {
+		const gqlError = graphQLError.graphQLErrors[0];
+		if (isFxhashErrorExtensions(gqlError.extensions)) return RichError.parse(gqlError.extensions.richError, expectedErrors);
+		return new UnexpectedRichError();
+	}
+	return new UnexpectedRichError();
 }
+/**
+* Returns a `Result<Data, TypedRichError>` by parsing a GraphQL response. If
+* the response has an error, {@link typedRichErrorFromGraphQLError} will be
+* called with such error to return a proper error instance based on the error
+* code in the fxhash graphql error extension (or a a generic error if none).
+*
+* @param operationResult A GraphQL response from fxhash hasura endpoint
+* @param getData A function which takes the response and returns the data (if
+* no data is found it should return `null` | `undefined`, in which case it will
+* fail with UnexpectedError)
+* @param potentialErrors An array of Rich Error classes which could be found in
+* the error response.
+*
+* @example
+*
+* ```ts
+* const emailRequestOTP = async (email) => {
+*   return richResultFromGraphQLResponse(
+*     await gqlWrapper.client().mutation(Mu_Web3AuthEmailRequestOTP, {
+*       email,
+*     }),
+*     res => res.data?.web3auth_email_request_otp,
+*     EmailOTPRequestErrors
+*   )
+* },
+* ```
+*/
 function richResultFromGraphQLResponse(operationResult, getData, potentialErrors) {
-  const res = operationResult;
-  if (res.error) {
-    return failure(typedRichErrorFromGraphQLError(res.error, potentialErrors));
-  }
-  const data = getData(res);
-  return data ? success(data) : failure(
-    new UnexpectedRichError({
-      dev: "Expected data missing from GraphQL response"
-    })
-  );
+	const res = operationResult;
+	if (res.error) return failure(typedRichErrorFromGraphQLError(res.error, potentialErrors));
+	const data = getData(res);
+	return data ? success(data) : failure(new UnexpectedRichError({ dev: "Expected data missing from GraphQL response" }));
 }
+/**
+* Test if an error is of a certain error kind, among a list of [errors] or
+* [list of errors]. This allows testing multiple array of errors, which are
+* defined quite a lot throughout the errors stack.
+*
+* @param error The error which needs to be tested
+* @param kinds List of [errors]/[array of errors]
+*
+* @returns boolean if error is of given kind
+*
+* @example
+*
+* ```ts
+* isErrorOfKind(
+*   someErr,
+*   UnexpectedRichError,
+*   [SuperError, BigError],
+*   SimpleError
+* )
+* ```
+*/
 function isErrorOfKind(error, ...kinds) {
-  for (const kind of kinds) {
-    if (Array.isArray(kind)) {
-      if (isErrorOfKind(error, ...kind)) return true;
-    } else {
-      if (error.name === kind.name) return true;
-      if (error.name === kind.errorType) return true;
-    }
-  }
-  return false;
+	for (const kind of kinds) if (Array.isArray(kind)) {
+		if (isErrorOfKind(error, ...kind)) return true;
+	} else {
+		if (error.name === kind.name) return true;
+		if (error.name === kind.errorType) return true;
+	}
+	return false;
 }
 
-// src/errors/graphql/oauth.ts
-import { capitalize } from "@fxhash/utils";
-var couldntSignIn = (provider) => `Couldn't sign in using ${capitalize(provider)}`;
+//#endregion
+//#region src/errors/graphql/oauth.ts
+const couldntSignIn = (provider) => `Couldn't sign in using ${capitalize(provider)}`;
 var OAuthTokenVerificationError = class extends RichError {
-  constructor(par) {
-    super(
-      isRichErrorMessages(par) ? par : {
-        dev: `The provided ${capitalize(par)} OAuth token could not be verified against ${capitalize(par)} services.`,
-        user: couldntSignIn(par)
-      }
-    );
-    this.name = "OAuthTokenVerificationError";
-  }
+	constructor(par) {
+		super(isRichErrorMessages(par) ? par : {
+			dev: `The provided ${capitalize(par)} OAuth token could not be verified against ${capitalize(par)} services.`,
+			user: couldntSignIn(par)
+		});
+		this.name = "OAuthTokenVerificationError";
+	}
 };
 var OAuthMissingInfoError = class extends RichError {
-  constructor(par, missing) {
-    super(
-      isRichErrorMessages(par) ? par : {
-        dev: `Some user information is missing at the end of the ${capitalize(par)} OAuth authentication flow: ${missing?.join(", ")}. This shouldn't happen and requires investigation from the fxhash team. Please forward this issue to our team.`,
-        user: couldntSignIn(par)
-      }
-    );
-    this.name = "OAuthMissingInfoError";
-  }
-};
-var OAuthErrors = [OAuthTokenVerificationError, OAuthMissingInfoError];
+	constructor(par, missing) {
+		super(isRichErrorMessages(par) ? par : {
+			dev: `Some user information is missing at the end of the ${capitalize(par)} OAuth authentication flow: ${missing?.join(", ")}. This shouldn't happen and requires investigation from the fxhash team. Please forward this issue to our team.`,
+			user: couldntSignIn(par)
+		});
+		this.name = "OAuthMissingInfoError";
+	}
+};
+const OAuthErrors = [OAuthTokenVerificationError, OAuthMissingInfoError];
 
-// src/errors/graphql/wallet-linking.ts
+//#endregion
+//#region src/errors/graphql/wallet-linking.ts
 var WalletAlreadyOtherAccountMainWalletError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "WalletAlreadyOtherAccountMainWalletError";
-    this.messages = {
-      dev: "Wallet is already the main wallet of another account.",
-      user: "This wallet is already registered as the main wallet for another account. To link this wallet to your current account, you need to delete the account associated with this wallet first. Please log in to the other account and proceed to delete the account from the profile menu. After this, you can link the wallet to this account."
-    };
-  }
-};
-WalletAlreadyOtherAccountMainWalletError.errorType = "WalletAlreadyOtherAccountMainWalletError";
+	constructor(..._args) {
+		super(..._args);
+		this.name = "WalletAlreadyOtherAccountMainWalletError";
+		this.messages = {
+			dev: "Wallet is already the main wallet of another account.",
+			user: "This wallet is already registered as the main wallet for another account. To link this wallet to your current account, you need to delete the account associated with this wallet first. Please log in to the other account and proceed to delete the account from the profile menu. After this, you can link the wallet to this account."
+		};
+	}
+	static {
+		this.errorType = "WalletAlreadyOtherAccountMainWalletError";
+	}
+};
 var WalletAlreadyLinkedError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "WalletAlreadyLinkedError";
-    this.messages = {
-      dev: "Wallet is already linked to another account (not as the main wallet)",
-      user: "This wallet is already associated to another account. You must first connect to your other account and unlink this wallet from it."
-    };
-  }
-};
-WalletAlreadyLinkedError.errorType = "WalletAlreadyLinkedError";
+	constructor(..._args2) {
+		super(..._args2);
+		this.name = "WalletAlreadyLinkedError";
+		this.messages = {
+			dev: "Wallet is already linked to another account (not as the main wallet)",
+			user: "This wallet is already associated to another account. You must first connect to your other account and unlink this wallet from it."
+		};
+	}
+	static {
+		this.errorType = "WalletAlreadyLinkedError";
+	}
+};
 var AccountAlreadyLinkedOnNetworkError = class extends RichError {
-  constructor(par) {
-    super(
-      isRichErrorMessages(par) ? par : {
-        dev: `Account already linked to a wallet on ${par.toLowerCase()}. There can only be one wallet per network linked to each account.`,
-        user: `Your account is already linked to a wallet on ${par.toLowerCase()}`
-      }
-    );
-    this.name = "AccountAlreadyLinkedOnNetworkError";
-  }
-};
-var LinkWalletErrors = [
-  WalletAlreadyOtherAccountMainWalletError,
-  WalletAlreadyLinkedError,
-  AccountAlreadyLinkedOnNetworkError
+	constructor(par) {
+		super(isRichErrorMessages(par) ? par : {
+			dev: `Account already linked to a wallet on ${par.toLowerCase()}. There can only be one wallet per network linked to each account.`,
+			user: `Your account is already linked to a wallet on ${par.toLowerCase()}`
+		});
+		this.name = "AccountAlreadyLinkedOnNetworkError";
+	}
+};
+const LinkWalletErrors = [
+	WalletAlreadyOtherAccountMainWalletError,
+	WalletAlreadyLinkedError,
+	AccountAlreadyLinkedOnNetworkError
 ];
 var WalletNotLinkedToAccountError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "WalletNotLinkedToAccountError";
-    this.messages = {
-      dev: "Wallet cannot be unlinked because it's not linked to the account currently authenticated",
-      user: "The wallet cannot be unlinked because it isn't linked to your account."
-    };
-  }
+	constructor(..._args3) {
+		super(..._args3);
+		this.name = "WalletNotLinkedToAccountError";
+		this.messages = {
+			dev: "Wallet cannot be unlinked because it's not linked to the account currently authenticated",
+			user: "The wallet cannot be unlinked because it isn't linked to your account."
+		};
+	}
 };
 var MainWalletCannotBeUnlinkedError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "MainWalletCannotBeUnlinkedError";
-    this.messages = {
-      dev: "The main wallet of an account cannot be unlinked from the account.",
-      user: "This wallet is the main one associated with your account, as such it cannot be unlinked."
-    };
-  }
-};
-var UnlinkWalletErrors = [WalletNotLinkedToAccountError, MainWalletCannotBeUnlinkedError];
+	constructor(..._args4) {
+		super(..._args4);
+		this.name = "MainWalletCannotBeUnlinkedError";
+		this.messages = {
+			dev: "The main wallet of an account cannot be unlinked from the account.",
+			user: "This wallet is the main one associated with your account, as such it cannot be unlinked."
+		};
+	}
+};
+const UnlinkWalletErrors = [WalletNotLinkedToAccountError, MainWalletCannotBeUnlinkedError];
 
-// src/errors/core.ts
+//#endregion
+//#region src/errors/core.ts
 var WalletSourceRequestConnectionRejectedError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "WalletSourceRequestConnectionRejectedError";
-    this.messages = {
-      dev: "The connection request was rejected by the user",
-      user: "It looks like you've rejected the connection request - if you didn't mean to, please try again"
-    };
-  }
+	constructor(..._args) {
+		super(..._args);
+		this.name = "WalletSourceRequestConnectionRejectedError";
+		this.messages = {
+			dev: "The connection request was rejected by the user",
+			user: "It looks like you've rejected the connection request - if you didn't mean to, please try again"
+		};
+	}
 };
 var WalletSourceRequestConnectionUnknownError = class extends RichError {
-  constructor(par) {
-    super(
-      isRichErrorMessages(par) ? par : {
-        dev: `An unknown error occurred while requesting a connection: ${par}`,
-        user: "An unknown error occurred while trying to connect to your wallet - please try again"
-      }
-    );
-    this.name = "WalletSourceRequestConnectionUnknownError";
-  }
+	constructor(par) {
+		super(isRichErrorMessages(par) ? par : {
+			dev: `An unknown error occurred while requesting a connection: ${par}`,
+			user: "An unknown error occurred while trying to connect to your wallet - please try again"
+		});
+		this.name = "WalletSourceRequestConnectionUnknownError";
+	}
 };
 var WalletSourceRequestConnectionWalletNotAvailableError = class extends RichError {
-  constructor(par) {
-    super(
-      isRichErrorMessages(par) ? par : {
-        dev: `The wallet source for ${par} is not available`,
-        user: "An unknown error occurred while trying to connect to your wallet - please try again"
-      }
-    );
-    this.name = "WalletSourceRequestConnectionWalletNotAvailableError";
-  }
-};
-var WalletSourceRequestConnectionErrors = [
-  WalletSourceRequestConnectionRejectedError,
-  WalletSourceRequestConnectionUnknownError,
-  WalletSourceRequestConnectionWalletNotAvailableError
+	constructor(par) {
+		super(isRichErrorMessages(par) ? par : {
+			dev: `The wallet source for ${par} is not available`,
+			user: "An unknown error occurred while trying to connect to your wallet - please try again"
+		});
+		this.name = "WalletSourceRequestConnectionWalletNotAvailableError";
+	}
+};
+const WalletSourceRequestConnectionErrors = [
+	WalletSourceRequestConnectionRejectedError,
+	WalletSourceRequestConnectionUnknownError,
+	WalletSourceRequestConnectionWalletNotAvailableError
 ];
 var NoWalletConnectedForNetworkError = class extends RichError {
-  constructor(par) {
-    super(
-      isRichErrorMessages(par) ? par : {
-        dev: `${par} - No wallet is connected to the client`,
-        user: "A wallet needs to be connected before performing this action"
-      }
-    );
-    this.name = "NoWalletConnectedForNetworkError";
-  }
+	constructor(par) {
+		super(isRichErrorMessages(par) ? par : {
+			dev: `${par} - No wallet is connected to the client`,
+			user: "A wallet needs to be connected before performing this action"
+		});
+		this.name = "NoWalletConnectedForNetworkError";
+	}
 };
 
-// src/errors/wallet-api.ts
+//#endregion
+//#region src/errors/wallet-api.ts
 var WalletAPIRpcUnknownNetworkError = class extends RichError {
-  constructor(par) {
-    super(
-      isRichErrorMessages(par) ? par : {
-        dev: `Could not check rpc health for network: ${par}`,
-        user: "Rpc health check failed"
-      }
-    );
-    this.name = "WalletApiRpcHealthError";
-  }
+	constructor(par) {
+		super(isRichErrorMessages(par) ? par : {
+			dev: `Could not check rpc health for network: ${par}`,
+			user: "Rpc health check failed"
+		});
+		this.name = "WalletApiRpcHealthError";
+	}
 };
 var WalletAPIInvalidRequestError = class extends RichError {
-  constructor(par) {
-    const details = Array.isArray(par) ? `
-Validation errors:
-${par.map((err) => `  - ${err.path.join(".")}: ${err.message}`).join("\n")}` : "";
-    super(
-      isRichErrorMessages(par) ? par : {
-        dev: `Invalid operation request payload.${details}`,
-        user: "Invalid request. Please check your input and try again."
-      }
-    );
-    this.name = "WalletAPIInvalidRequestError";
-  }
+	constructor(par) {
+		const details = Array.isArray(par) ? `\nValidation errors:\n${par.map((err) => `  - ${err.path.join(".")}: ${err.message}`).join("\n")}` : "";
+		super(isRichErrorMessages(par) ? par : {
+			dev: `Invalid operation request payload.${details}`,
+			user: "Invalid request. Please check your input and try again."
+		});
+		this.name = "WalletAPIInvalidRequestError";
+	}
 };
 var WalletAPIFetchError = class extends RichError {
-  constructor(par, statusCode, attempt, maxRetries) {
-    super(
-      isRichErrorMessages(par) ? par : {
-        dev: `Request to ${par} failed (status: ${statusCode}) on attempt ${attempt}/${maxRetries}`,
-        user: "Failed to fetch required data. Please try again later."
-      }
-    );
-    this.name = "WalletAPIFetchError";
-  }
+	constructor(par, statusCode, attempt, maxRetries) {
+		super(isRichErrorMessages(par) ? par : {
+			dev: `Request to ${par} failed (status: ${statusCode}) on attempt ${attempt}/${maxRetries}`,
+			user: "Failed to fetch required data. Please try again later."
+		});
+		this.name = "WalletAPIFetchError";
+	}
 };
 var WalletAPIFetchTimeoutError = class extends RichError {
-  constructor(par, maxRetries, finalError) {
-    const errorMessage = finalError instanceof Error ? finalError.message : String(finalError);
-    super(
-      isRichErrorMessages(par) ? par : {
-        dev: `Request to ${par} failed after ${maxRetries} retries. Final error: ${errorMessage}`,
-        user: "Service temporarily unavailable. Please try again later."
-      }
-    );
-    this.name = "WalletAPIFetchTimeoutError";
-  }
+	constructor(par, maxRetries, finalError) {
+		const errorMessage = finalError instanceof Error ? finalError.message : String(finalError);
+		super(isRichErrorMessages(par) ? par : {
+			dev: `Request to ${par} failed after ${maxRetries} retries. Final error: ${errorMessage}`,
+			user: "Service temporarily unavailable. Please try again later."
+		});
+		this.name = "WalletAPIFetchTimeoutError";
+	}
 };
 var WalletAPIInvalidURLError = class extends RichError {
-  constructor(par) {
-    super(
-      isRichErrorMessages(par) ? par : {
-        dev: `Invalid URL provided: ${par}`,
-        user: "Invalid request URL configuration."
-      }
-    );
-    this.name = "WalletAPIInvalidURLError";
-  }
-};
-var WalletAPIErrors = [
-  WalletAPIRpcUnknownNetworkError,
-  WalletAPIInvalidRequestError,
-  WalletAPIFetchError,
-  WalletAPIFetchTimeoutError,
-  WalletAPIInvalidURLError
+	constructor(par) {
+		super(isRichErrorMessages(par) ? par : {
+			dev: `Invalid URL provided: ${par}`,
+			user: "Invalid request URL configuration."
+		});
+		this.name = "WalletAPIInvalidURLError";
+	}
+};
+const WalletAPIErrors = [
+	WalletAPIRpcUnknownNetworkError,
+	WalletAPIInvalidRequestError,
+	WalletAPIFetchError,
+	WalletAPIFetchTimeoutError,
+	WalletAPIInvalidURLError
 ];
 
-// src/errors/web3auth.ts
+//#endregion
+//#region src/errors/web3auth.ts
 var Web3AuthFrameNotLoading = class extends RichError {
-  constructor(par1, error) {
-    const _error = error ? typeof error === "string" ? error : error.type : "/";
-    super(
-      isRichErrorMessages(par1) ? par1 : {
-        dev: `Fxhash embedded wallet iframe (at "${par1}") could not be loaded. The following error was retured: ${_error}`,
-        user: "Fxhash embedded wallet has not loaded"
-      }
-    );
-    this.name = "Web3AuthFrameNotLoading";
-  }
+	constructor(par1, error) {
+		const _error = error ? typeof error === "string" ? error : error.type : "/";
+		super(isRichErrorMessages(par1) ? par1 : {
+			dev: `Fxhash embedded wallet iframe (at "${par1}") could not be loaded. The following error was retured: ${_error}`,
+			user: "Fxhash embedded wallet has not loaded"
+		});
+		this.name = "Web3AuthFrameNotLoading";
+	}
 };
 var Web3AuthFrameNotResponding = class extends RichError {
-  constructor(url) {
-    super({
-      dev: `Fxhash embedded wallet iframe (at "${url}") is not responding to requests`,
-      user: "Fxhash embedded wallet is not responding"
-    });
-    this.name = "Web3AuthFrameNotResponding";
-  }
+	constructor(url) {
+		super({
+			dev: `Fxhash embedded wallet iframe (at "${url}") is not responding to requests`,
+			user: "Fxhash embedded wallet is not responding"
+		});
+		this.name = "Web3AuthFrameNotResponding";
+	}
 };
 var Web3AuthFrameNotInitialized = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "Web3AuthFrameNotInitialized";
-    this.messages = {
-      dev: "Fxhash embedded wallet <iframe> hasn't been initialized while it should have",
-      user: "Fxhash embedded wallet wasn't initialized"
-    };
-  }
+	constructor(..._args) {
+		super(..._args);
+		this.name = "Web3AuthFrameNotInitialized";
+		this.messages = {
+			dev: "Fxhash embedded wallet <iframe> hasn't been initialized while it should have",
+			user: "Fxhash embedded wallet wasn't initialized"
+		};
+	}
 };
 var Web3AuthFrameAuthenticationError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "Web3AuthFrameAuthenticationError";
-    this.messages = {
-      dev: "An error occurred when attempting to authenticate on Web3Auth",
-      user: "Authentication error"
-    };
-  }
+	constructor(..._args2) {
+		super(..._args2);
+		this.name = "Web3AuthFrameAuthenticationError";
+		this.messages = {
+			dev: "An error occurred when attempting to authenticate on Web3Auth",
+			user: "Authentication error"
+		};
+	}
 };
 var Web3AuthFrameFxhashAuthenticationError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "Web3AuthFrameFxhashAuthenticationError";
-    this.messages = {
-      dev: "An error occurred when attempting to authenticate on fxhash",
-      user: "Authentication error"
-    };
-  }
+	constructor(..._args3) {
+		super(..._args3);
+		this.name = "Web3AuthFrameFxhashAuthenticationError";
+		this.messages = {
+			dev: "An error occurred when attempting to authenticate on fxhash",
+			user: "Authentication error"
+		};
+	}
 };
 var Web3AuthFrameLogoutFailedError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "Web3AuthFrameLogoutFailedError";
-    this.messages = {
-      dev: "Logout failed. This is likely an issue on fxhash end.",
-      user: "Could not logout your account. Please try again."
-    };
-  }
+	constructor(..._args4) {
+		super(..._args4);
+		this.name = "Web3AuthFrameLogoutFailedError";
+		this.messages = {
+			dev: "Logout failed. This is likely an issue on fxhash end.",
+			user: "Could not logout your account. Please try again."
+		};
+	}
 };
 var Web3AuthInitializationFailedError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "Web3AuthInitializationFailedError";
-    this.messages = {
-      dev: "Web3Auth initialization failed, as such the embedded wallet cannot be constructed and used. If this issue persists, please raise it on Github.",
-      user: "Could not initialize embedded wallet."
-    };
-  }
+	constructor(..._args5) {
+		super(..._args5);
+		this.name = "Web3AuthInitializationFailedError";
+		this.messages = {
+			dev: "Web3Auth initialization failed, as such the embedded wallet cannot be constructed and used. If this issue persists, please raise it on Github.",
+			user: "Could not initialize embedded wallet."
+		};
+	}
 };
 var Web3AuthFrameUnknownError = class extends RichError {
-  constructor() {
-    super(...arguments);
-    this.name = "Web3AuthFrameUnknownError";
-    this.messages = {
-      dev: "An unexpected error was raised using Web3Auth",
-      user: UnexpectedRichErrorMessages.user
-    };
-  }
-};
-var Web3AuthFrameErrors = {
-  init: [Web3AuthInitializationFailedError],
-  getSessionDetails: [Web3AuthFrameAuthenticationError],
-  login: [
-    Web3AuthFrameAuthenticationError,
-    Web3AuthFrameFxhashAuthenticationError,
-    Web3AuthFrameUnknownError
-  ],
-  logout: [Web3AuthFrameLogoutFailedError]
-};
-var AllWeb3AuthFrameErrors = Array().concat.apply(
-  [],
-  Object.values(Web3AuthFrameErrors)
-);
-export {
-  AccountAlreadyLinkedOnNetworkError,
-  AllWeb3AuthFrameErrors,
-  EmailOTPExpiredError,
-  EmailOTPInvalidError,
-  EmailOTPLockedError,
-  EmailOTPRequestErrors,
-  EmailOTPVerificationErrors,
-  GraphQLErrors,
-  LinkWalletErrors,
-  MainWalletCannotBeUnlinkedError,
-  NetworkRichError,
-  NoWalletConnectedForNetworkError,
-  OAuthErrors,
-  OAuthMissingInfoError,
-  OAuthTokenVerificationError,
-  RichError,
-  UnexpectedRichError,
-  UnexpectedRichErrorMessages,
-  UnlinkWalletErrors,
-  WalletAPIErrors,
-  WalletAPIFetchError,
-  WalletAPIFetchTimeoutError,
-  WalletAPIInvalidRequestError,
-  WalletAPIInvalidURLError,
-  WalletAPIRpcUnknownNetworkError,
-  WalletAlreadyLinkedError,
-  WalletAlreadyOtherAccountMainWalletError,
-  WalletNotLinkedToAccountError,
-  WalletSourceRequestConnectionErrors,
-  WalletSourceRequestConnectionRejectedError,
-  WalletSourceRequestConnectionUnknownError,
-  WalletSourceRequestConnectionWalletNotAvailableError,
-  Web3AuthFrameAuthenticationError,
-  Web3AuthFrameErrors,
-  Web3AuthFrameFxhashAuthenticationError,
-  Web3AuthFrameLogoutFailedError,
-  Web3AuthFrameNotInitialized,
-  Web3AuthFrameNotLoading,
-  Web3AuthFrameNotResponding,
-  Web3AuthFrameUnknownError,
-  Web3AuthInitializationFailedError,
-  isErrorOfKind,
-  isFxhashErrorExtensions,
-  isRichErrorMessages,
-  richError,
-  richErrorFromGraphQLError,
-  richResultFromGraphQLResponse,
-  typedRichErrorFromGraphQLError
-};
+	constructor(..._args6) {
+		super(..._args6);
+		this.name = "Web3AuthFrameUnknownError";
+		this.messages = {
+			dev: "An unexpected error was raised using Web3Auth",
+			user: UnexpectedRichErrorMessages.user
+		};
+	}
+};
+const Web3AuthFrameErrors = {
+	init: [Web3AuthInitializationFailedError],
+	getSessionDetails: [Web3AuthFrameAuthenticationError],
+	login: [
+		Web3AuthFrameAuthenticationError,
+		Web3AuthFrameFxhashAuthenticationError,
+		Web3AuthFrameUnknownError
+	],
+	logout: [Web3AuthFrameLogoutFailedError]
+};
+const AllWeb3AuthFrameErrors = Array().concat.apply([], Object.values(Web3AuthFrameErrors));
+
+//#endregion
+export { AccountAlreadyLinkedOnNetworkError, AllWeb3AuthFrameErrors, EmailOTPExpiredError, EmailOTPInvalidError, EmailOTPLockedError, EmailOTPRequestErrors, EmailOTPVerificationErrors, GraphQLErrors, LinkWalletErrors, MainWalletCannotBeUnlinkedError, NetworkRichError, NoWalletConnectedForNetworkError, OAuthErrors, OAuthMissingInfoError, OAuthTokenVerificationError, RichError, UnexpectedRichError, UnexpectedRichErrorMessages, UnlinkWalletErrors, WalletAPIErrors, WalletAPIFetchError, WalletAPIFetchTimeoutError, WalletAPIInvalidRequestError, WalletAPIInvalidURLError, WalletAPIRpcUnknownNetworkError, WalletAlreadyLinkedError, WalletAlreadyOtherAccountMainWalletError, WalletNotLinkedToAccountError, WalletSourceRequestConnectionErrors, WalletSourceRequestConnectionRejectedError, WalletSourceRequestConnectionUnknownError, WalletSourceRequestConnectionWalletNotAvailableError, Web3AuthFrameAuthenticationError, Web3AuthFrameErrors, Web3AuthFrameFxhashAuthenticationError, Web3AuthFrameLogoutFailedError, Web3AuthFrameNotInitialized, Web3AuthFrameNotLoading, Web3AuthFrameNotResponding, Web3AuthFrameUnknownError, Web3AuthInitializationFailedError, isErrorOfKind, isFxhashErrorExtensions, isRichErrorMessages, richError, richErrorFromGraphQLError, richResultFromGraphQLResponse, typedRichErrorFromGraphQLError };
 //# sourceMappingURL=index.js.map