@fxhash/errors 0.0.10

package/README.md

@@ -0,0 +1,3 @@
+# @fxhash/errors
+
+Application-wide errors which are exposed and used by different parts of our stack.

package/dist/errors/_index.d.ts

@@ -0,0 +1,6 @@
+export * from "./common.js";
+export * from "./graphql/_index.js";
+export * from "./core.js";
+export * from "./network.js";
+export * from "./wallet-api.js";
+export * from "./web3auth.js";

package/dist/errors/common.d.ts

@@ -0,0 +1,109 @@
+import type { IEquatableError } from "@fxhash/utils";
+/**
+* Rich Error Messages are messages with extra data for a better usage of errors
+* passed through the stack. Traditionally, error messages are intended for
+* developers only (and some custom implementation for user error feedback is
+* required for clean UIs).
+*/
+export interface IRichErrorMessages {
+	dev?: string;
+	user?: string;
+}
+/**
+* Static error messages for "unexpected" errors. This payload is reused accross
+* the stack for when error data is missing.
+*/
+export declare const UnexpectedRichErrorMessages: Readonly<Required<IRichErrorMessages>>;
+/**
+* Flatenned Rich Error interface so that Rich Errors can also be passed in a
+* more convenient way. The purpose of this interface is to provide back-
+* compatibility with `Error`, as well as providing an unambiguous `userMessage`
+* property which can be used by front-end applications.
+*/
+export interface IRichError {
+	/**
+	* Message intended for developers
+	*/
+	message: string;
+	/**
+	* Message intended for users
+	*/
+	userMessage: string;
+}
+/**
+* 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
+* }
+* ```
+*/
+export declare class RichError extends Error implements IRichError, IEquatableError {
+	messages: IRichErrorMessages;
+	messagesOverride: IRichErrorMessages | undefined;
+	constructor(messagesOverride?: IRichErrorMessages);
+	private _message;
+	get message(): string;
+	get userMessage(): string;
+	get code(): string;
+	serialize(): IRichErrorSerialized;
+	static get code(): string;
+	/**
+	* 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<T extends (typeof RichError)[]>(serialized: IRichErrorSerialized, expected: T): RichErrorUnion<T> | UnexpectedRichError;
+	/**
+	* Returns a new instance of {@link UnexpectedRichError}
+	* @param messagesOverride Optional overrides of default unexpected messages
+	*/
+	static Unexpected(messagesOverride?: IRichErrorMessages): UnexpectedRichError;
+}
+/**
+* A Rich error serialized,
+*/
+export interface IRichErrorSerialized {
+	code: string;
+	messages?: IRichErrorMessages;
+}
+/**
+* A general-purpose error which is thrown when no better error could be
+* inferred from the available context.
+*/
+export declare class UnexpectedRichError extends RichError {
+	name: "UnexpectedRichError";
+	messages: typeof UnexpectedRichErrorMessages;
+}
+/**
+* Creates an Union of Rich Error instance types from an array of Rich Error
+* classes.
+*/
+export type RichErrorUnion<T extends (typeof RichError)[]> = InstanceType<T[number]>;

package/dist/errors/core.d.ts

@@ -0,0 +1,25 @@
+import { IRichErrorMessages, RichError, RichErrorUnion } from "./common.js";
+export declare class WalletSourceRequestConnectionRejectedError extends RichError {
+	name: "WalletSourceRequestConnectionRejectedError";
+	messages: {
+		dev: string
+		user: string
+	};
+}
+export declare class WalletSourceRequestConnectionUnknownError extends RichError {
+	name: "WalletSourceRequestConnectionUnknownError";
+	constructor(messages: IRichErrorMessages);
+	constructor(network: string);
+}
+export declare class WalletSourceRequestConnectionWalletNotAvailableError extends RichError {
+	name: "WalletSourceRequestConnectionWalletNotAvailableError";
+	constructor(messages: IRichErrorMessages);
+	constructor(network: string);
+}
+export declare const WalletSourceRequestConnectionErrors: (typeof WalletSourceRequestConnectionRejectedError | typeof WalletSourceRequestConnectionUnknownError | typeof WalletSourceRequestConnectionWalletNotAvailableError)[];
+export type WalletSourceRequestConnectionError = RichErrorUnion<typeof WalletSourceRequestConnectionErrors>;
+export declare class NoWalletConnectedForNetworkError extends RichError {
+	name: "NoWalletConnectedForNetworkError";
+	constructor(messages: IRichErrorMessages);
+	constructor(network: string);
+}

package/dist/errors/graphql/_index.d.ts

@@ -0,0 +1,4 @@
+export * from "./common.js";
+export * from "./email-otp.js";
+export * from "./oauth.js";
+export * from "./wallet-linking.js";

package/dist/errors/graphql/common.d.ts

@@ -0,0 +1,11 @@
+import { IRichErrorSerialized, RichError, RichErrorUnion, UnexpectedRichError } from "../common.js";
+import { NetworkRichError } from "../network.js";
+/**
+* Format of the GraphQL error extensions returned by the GraphQL API.
+*/
+export interface IFxhashGraphQLErrorExtensions {
+	version: "fxhash@0.1.0";
+	richError: IRichErrorSerialized;
+}
+export declare const GraphQLErrors: (typeof UnexpectedRichError | typeof NetworkRichError)[];
+export type WithGqlErrors<T extends RichError> = T | RichErrorUnion<typeof GraphQLErrors>;

package/dist/errors/graphql/email-otp.d.ts

@@ -0,0 +1,26 @@
+import { RichError, RichErrorUnion } from "../common.js";
+export declare class EmailOTPLockedError extends RichError {
+	name: "EmailOTPLockedError";
+	messages: {
+		dev: string
+		user: string
+	};
+}
+export declare const EmailOTPRequestErrors: (typeof EmailOTPLockedError)[];
+export type EmailOTPRequestError = RichErrorUnion<typeof EmailOTPRequestErrors>;
+export declare class EmailOTPInvalidError extends RichError {
+	name: "EmailOTPInvalidError";
+	messages: {
+		dev: string
+		user: string
+	};
+}
+export declare class EmailOTPExpiredError extends RichError {
+	name: "EmailOTPExpiredError";
+	messages: {
+		dev: string
+		user: string
+	};
+}
+export declare const EmailOTPVerificationErrors: (typeof EmailOTPLockedError | typeof EmailOTPInvalidError | typeof EmailOTPExpiredError)[];
+export type EmailOTPVerificationError = RichErrorUnion<typeof EmailOTPVerificationErrors>;

package/dist/errors/graphql/oauth.d.ts

@@ -0,0 +1,15 @@
+import { IRichErrorMessages, RichError, RichErrorUnion } from "../common.js";
+type OAuthProvider = "google" | "discord";
+export declare class OAuthTokenVerificationError extends RichError {
+	name: "OAuthTokenVerificationError";
+	constructor(messages: IRichErrorMessages);
+	constructor(provider: OAuthProvider);
+}
+export declare class OAuthMissingInfoError extends RichError {
+	name: "OAuthMissingInfoError";
+	constructor(messages: IRichErrorMessages);
+	constructor(provider: OAuthProvider, missing: string[]);
+}
+export declare const OAuthErrors: (typeof OAuthTokenVerificationError | typeof OAuthMissingInfoError)[];
+export type OAuthError = RichErrorUnion<typeof OAuthErrors>;
+export {};

package/dist/errors/graphql/wallet-linking.d.ts

@@ -0,0 +1,38 @@
+import { IRichErrorMessages, RichError, RichErrorUnion } from "../common.js";
+export declare class WalletAlreadyOtherAccountMainWalletError extends RichError {
+	name: "WalletAlreadyOtherAccountMainWalletError";
+	messages: {
+		dev: string
+		user: string
+	};
+}
+export declare class WalletAlreadyLinkedError extends RichError {
+	name: "WalletAlreadyLinkedError";
+	messages: {
+		dev: string
+		user: string
+	};
+}
+export declare class AccountAlreadyLinkedOnNetworkError extends RichError {
+	name: "AccountAlreadyLinkedOnNetworkError";
+	constructor(messages: IRichErrorMessages);
+	constructor(network: string);
+}
+export declare const LinkWalletErrors: (typeof WalletAlreadyOtherAccountMainWalletError | typeof WalletAlreadyLinkedError | typeof AccountAlreadyLinkedOnNetworkError)[];
+export type LinkWalletError = RichErrorUnion<typeof LinkWalletErrors>;
+export declare class WalletNotLinkedToAccountError extends RichError {
+	name: "WalletNotLinkedToAccountError";
+	messages: {
+		dev: string
+		user: string
+	};
+}
+export declare class MainWalletCannotBeUnlinkedError extends RichError {
+	name: "MainWalletCannotBeUnlinkedError";
+	messages: {
+		dev: string
+		user: string
+	};
+}
+export declare const UnlinkWalletErrors: (typeof WalletNotLinkedToAccountError | typeof MainWalletCannotBeUnlinkedError)[];
+export type UnlinkWalletError = RichErrorUnion<typeof UnlinkWalletErrors>;

package/dist/errors/network.d.ts

@@ -0,0 +1,8 @@
+import { RichError } from "./common.js";
+export declare class NetworkRichError extends RichError {
+	name: "NetworkRichError";
+	messages: {
+		dev: string
+		user: string
+	};
+}

package/dist/errors/wallet-api.d.ts

@@ -0,0 +1,31 @@
+import { RichError, RichErrorUnion, IRichErrorMessages } from "./common.js";
+export declare class WalletAPIRpcUnknownNetworkError extends RichError {
+	name: "WalletApiRpcHealthError";
+	constructor(messages: IRichErrorMessages);
+	constructor(network: string);
+}
+export declare class WalletAPIInvalidRequestError extends RichError {
+	name: "WalletAPIInvalidRequestError";
+	constructor(messages: IRichErrorMessages);
+	constructor(validationErrors?: Array<{
+		path: (string | number)[]
+		message: string
+	}>);
+}
+export declare class WalletAPIFetchError extends RichError {
+	name: "WalletAPIFetchError";
+	constructor(messages: IRichErrorMessages);
+	constructor(url: string, statusCode: number, attempt: number, maxRetries: number);
+}
+export declare class WalletAPIFetchTimeoutError extends RichError {
+	name: "WalletAPIFetchTimeoutError";
+	constructor(messages: IRichErrorMessages);
+	constructor(url: string, maxRetries: number, finalError: unknown);
+}
+export declare class WalletAPIInvalidURLError extends RichError {
+	name: "WalletAPIInvalidURLError";
+	constructor(messages: IRichErrorMessages);
+	constructor(url: string);
+}
+export declare const WalletAPIErrors: (typeof WalletAPIRpcUnknownNetworkError | typeof WalletAPIInvalidRequestError | typeof WalletAPIFetchError | typeof WalletAPIFetchTimeoutError | typeof WalletAPIInvalidURLError)[];
+export type WalletAPIError = RichErrorUnion<typeof WalletAPIErrors>;

package/dist/errors/web3auth.d.ts

@@ -0,0 +1,63 @@
+import { TypeOfRichError } from "../index.js";
+import { IRichErrorMessages, RichError, RichErrorUnion } from "./common.js";
+export declare class Web3AuthFrameNotLoading extends RichError {
+	name: "Web3AuthFrameNotLoading";
+	constructor(url: string, error: string | Event);
+	constructor(messages: IRichErrorMessages);
+}
+export declare class Web3AuthFrameNotResponding extends RichError {
+	name: "Web3AuthFrameNotResponding";
+	constructor(url: string);
+}
+export declare class Web3AuthFrameNotInitialized extends RichError {
+	name: "Web3AuthFrameNotInitialized";
+	messages: {
+		dev: string
+		user: string
+	};
+}
+export type Web3AuthFrameInitializationError = Web3AuthFrameNotInitialized | Web3AuthFrameNotLoading | Web3AuthFrameNotResponding;
+export declare class Web3AuthFrameAuthenticationError extends RichError {
+	name: "Web3AuthFrameAuthenticationError";
+	messages: {
+		dev: string
+		user: string
+	};
+}
+export declare class Web3AuthFrameFxhashAuthenticationError extends RichError {
+	name: "Web3AuthFrameFxhashAuthenticationError";
+	messages: {
+		dev: string
+		user: string
+	};
+}
+export declare class Web3AuthFrameLogoutFailedError extends RichError {
+	name: "Web3AuthFrameLogoutFailedError";
+	messages: {
+		dev: string
+		user: string
+	};
+}
+export declare class Web3AuthInitializationFailedError extends RichError {
+	name: "Web3AuthInitializationFailedError";
+	messages: {
+		dev: string
+		user: string
+	};
+}
+export declare class Web3AuthFrameUnknownError extends RichError {
+	name: "Web3AuthFrameUnknownError";
+	messages: {
+		dev: string
+		user: string
+	};
+}
+export declare const Web3AuthFrameErrors: {
+	init: (typeof Web3AuthInitializationFailedError)[]
+	getSessionDetails: (typeof Web3AuthFrameAuthenticationError)[]
+	login: (typeof Web3AuthFrameAuthenticationError | typeof Web3AuthFrameFxhashAuthenticationError | typeof Web3AuthFrameUnknownError)[]
+	logout: (typeof Web3AuthFrameLogoutFailedError)[]
+};
+export type Web3AuthFrameError = { [K in keyof typeof Web3AuthFrameErrors] : RichErrorUnion<(typeof Web3AuthFrameErrors)[K]> };
+export type AllWeb3AuthFrameError = TypeOfRichError<Web3AuthFrameError[keyof Web3AuthFrameError]>;
+export declare const AllWeb3AuthFrameErrors: AllWeb3AuthFrameError[];

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./errors/_index.js";
+export * from "./utils/_index.js";

package/dist/index.js

@@ -0,0 +1,537 @@
+// src/errors/common.ts
+var UnexpectedRichErrorMessages = {
+  dev: "Unexpected error",
+  user: "Unexpected error"
+};
+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) {
+      if (RichErrorClass.code === serialized.code) {
+        return new RichErrorClass(serialized.messages);
+      }
+    }
+    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);
+  }
+};
+var UnexpectedRichError = class extends RichError {
+  constructor() {
+    super(...arguments);
+    this.name = "UnexpectedRichError";
+    this.messages = UnexpectedRichErrorMessages;
+  }
+};
+
+// 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"
+    };
+  }
+};
+
+// src/errors/graphql/common.ts
+var GraphQLErrors = [NetworkRichError, UnexpectedRichError];
+
+// 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
+];
+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"
+    };
+  }
+};
+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];
+
+// src/utils/rich-error.ts
+import { failure, success } from "@fxhash/utils";
+function richError(params) {
+  return Object.assign(new RichError(), params);
+}
+function isFxhashErrorExtensions(ext) {
+  return typeof ext === "object" && ext.version === "fxhash@0.1.0";
+}
+function isRichErrorMessages(value) {
+  if (typeof value !== "object") return false;
+  return typeof value.dev === "string" || typeof value.user === "string";
+}
+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();
+}
+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();
+}
+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"
+    })
+  );
+}
+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;
+    }
+  }
+  return false;
+}
+
+// src/errors/graphql/oauth.ts
+import { capitalize } from "@fxhash/utils";
+var 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";
+  }
+};
+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];
+
+// 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."
+    };
+  }
+};
+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."
+    };
+  }
+};
+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
+];
+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."
+    };
+  }
+};
+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];
+
+// 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"
+    };
+  }
+};
+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";
+  }
+};
+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
+];
+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";
+  }
+};
+
+// 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";
+  }
+};
+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";
+  }
+};
+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";
+  }
+};
+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";
+  }
+};
+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
+];
+
+// 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";
+  }
+};
+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";
+  }
+};
+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"
+    };
+  }
+};
+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"
+    };
+  }
+};
+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"
+    };
+  }
+};
+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."
+    };
+  }
+};
+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."
+    };
+  }
+};
+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
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/utils/_index.d.ts

@@ -0,0 +1 @@
+export * from "./rich-error.js";

package/dist/utils/rich-error.d.ts

@@ -0,0 +1,108 @@
+import type { CombinedError, OperationResult } from "@urql/core";
+import { IFxhashGraphQLErrorExtensions, IRichErrorMessages, NetworkRichError, RichError, UnexpectedRichError, WithGqlErrors } from "../index.js";
+import { IEquatableError, Result } from "@fxhash/utils";
+export type TypeOfRichError<T extends RichError> = {
+	new (): T
+	parse: (typeof RichError)["parse"]
+	Unexpected: (typeof RichError)["Unexpected"]
+	code: (typeof RichError)["code"]
+};
+/**
+* Instanciate a new {@link RichError} using a declarative object. This is
+* useful when Rich Error are instanciated programmatically when type is
+* unknown.
+*/
+export declare function richError(params: {
+	name: string
+	messages?: IRichErrorMessages
+}): RichError;
+export declare function isFxhashErrorExtensions(ext: any): ext is IFxhashGraphQLErrorExtensions;
+/**
+* Test whether a given value is implementing the {@link IRichErrorMessages}
+* interface.
+* @param value Any value
+*/
+export declare function isRichErrorMessages(value: any): value is IRichErrorMessages;
+/**
+* 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
+*/
+export declare function richErrorFromGraphQLError(error: CombinedError): RichError | UnexpectedRichError | NetworkRichError;
+/**
+* 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}
+*/
+export declare function typedRichErrorFromGraphQLError<T extends (typeof RichError)[]>(graphQLError: CombinedError, expectedErrors: T): WithGqlErrors<InstanceType<T[number]>>;
+/**
+* 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
+*   )
+* },
+* ```
+*/
+export declare function richResultFromGraphQLResponse<
+	T extends (typeof RichError)[],
+	Data = any,
+	ExtractedData = any
+>(operationResult: OperationResult<Data>, getData: (result: OperationResult<Data>) => ExtractedData | undefined | null, potentialErrors: T): Result<ExtractedData, WithGqlErrors<InstanceType<T[number]>>>;
+/**
+* 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
+* )
+* ```
+*/
+export declare function isErrorOfKind<Errors extends (IEquatableError | IEquatableError[])[]>(error: IEquatableError, ...kinds: Errors): error is Instance<Flatten<Errors>>;
+type Flatten<T> = T extends (infer U)[] ? Flatten<U> : T;
+type Instance<T> = T extends abstract new (...args: any) => any ? InstanceType<T> : T;
+export {};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@fxhash/errors",
+  "description": "Application-wide errors which are exposed and used by different parts of our stack.",
+  "version": "0.0.10",
+  "author": "fxhash",
+  "dependencies": {
+    "@urql/core": "4.1.4",
+    "@fxhash/utils": "0.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "18.7.13",
+    "tslib": "2.6.2",
+    "tsup": "8.4.0",
+    "typescript": "5.8.2",
+    "unplugin-isolated-decl": "0.13.6",
+    "@fxhash/tsconfig": "0.0.1"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": "fxhash/fxhash-package",
+  "type": "module",
+  "scripts": {
+    "build": "tsup && tsc --noEmit",
+    "dev": "tsup --watch"
+  }
+}