@account-kit/signer 4.16.0 → 4.16.1-alpha.3

package/src/errors.ts

@@ -1,5 +1,5 @@
 import { BaseError } from "@aa-sdk/core";
-
+import type { MfaFactor } from "./client/types";
 export class NotAuthenticatedError extends BaseError {
   override name = "NotAuthenticatedError";
   constructor() {
@@ -23,3 +23,13 @@ export class OAuthProvidersError extends BaseError {
     });
   }
 }
+
+export class MfaRequiredError extends BaseError {
+  override name = "MfaRequiredError";
+  public multiFactors: MfaFactor[];
+
+  constructor(multiFactors: MfaFactor[]) {
+    super("MFA is required for this user");
+    this.multiFactors = multiFactors;
+  }
+}

package/src/index.ts

@@ -6,7 +6,11 @@ export {
   OauthFailedError,
 } from "./client/index.js";
 export type * from "./client/types.js";
-export { NotAuthenticatedError, OAuthProvidersError } from "./errors.js";
+export {
+  NotAuthenticatedError,
+  OAuthProvidersError,
+  MfaRequiredError,
+} from "./errors.js";
 export {
   DEFAULT_SESSION_MS,
   SessionManagerParamsSchema,

package/src/session/manager.ts

@@ -43,7 +43,11 @@ type Store = Mutate<
   [["zustand/subscribeWithSelector", never], ["zustand/persist", SessionState]]
 >;
 
-type TemporarySession = { orgId: string; isNewUser?: boolean };
+type TemporarySession = {
+  orgId: string;
+  isNewUser?: boolean;
+  isMfaRequired?: boolean;
+};
 
 export class SessionManager {
   private sessionKey: string;

package/src/signer.ts

@@ -4,7 +4,10 @@ import {
   AlchemySignerClientParamsSchema,
   AlchemySignerWebClient,
 } from "./client/index.js";
-import type { CredentialCreationOptionOverrides } from "./client/types.js";
+import type {
+  CredentialCreationOptionOverrides,
+  VerifyMfaParams,
+} from "./client/types.js";
 import { SessionManagerParamsSchema } from "./session/manager.js";
 
 export type AuthParams =
@@ -13,6 +16,7 @@ export type AuthParams =
       email: string;
       emailMode?: "magicLink" | "otp";
       redirectParams?: URLSearchParams;
+      multiFactors?: VerifyMfaParams[];
     }
   | { type: "email"; bundle: string; orgId?: string; isNewUser?: boolean }
   | {
@@ -46,6 +50,7 @@ export type AuthParams =
   | {
       type: "otp";
       otpCode: string;
+      multiFactors?: VerifyMfaParams[];
     };
 
 export type OauthProviderConfig =

package/src/types.ts

@@ -6,6 +6,10 @@ export type AlchemySignerEvents = {
   disconnected(): void;
   statusChanged(status: AlchemySignerStatus): void;
   errorChanged(error: ErrorInfo | undefined): void;
+  mfaStatusChanged(mfaStatus: {
+    mfaRequired: boolean;
+    mfaFactorId?: string;
+  }): void;
 };
 
 export type AlchemySignerEvent = keyof AlchemySignerEvents;
@@ -21,6 +25,11 @@ export enum AlchemySignerStatus {
   AWAITING_OTP_AUTH = "AWAITING_OTP_AUTH",
 }
 
+export enum AlchemyMfaStatus {
+  NOT_REQUIRED = "not_required",
+  REQUIRED = "required",
+}
+
 export interface ErrorInfo {
   name: string;
   message: string;

package/src/utils/parseMfaError.ts

@@ -0,0 +1,15 @@
+import type { MfaFactor } from "../client/types.js";
+
+export function parseMfaError(error: unknown): MfaFactor[] | null {
+  if (error instanceof Error) {
+    try {
+      const parsed = JSON.parse(error.message);
+      if (parsed?.data?.multiFactors) {
+        return parsed.data.multiFactors;
+      }
+    } catch {
+      // ignore JSON parse failures
+    }
+  }
+  return null;
+}

package/src/version.ts

@@ -1,3 +1,3 @@
 // This file is autogenerated by inject-version.ts. Any changes will be
 // overwritten on commit!
-export const VERSION = "4.16.0";
+export const VERSION = "4.16.1-alpha.3";