@hawcx/react-native-sdk 1.0.1 → 1.0.3

package/lib/typescript/index.d.ts

@@ -1,11 +1,19 @@
 import { NativeEventEmitter, EmitterSubscription } from 'react-native';
 export type HawcxInitializeConfig = {
     projectApiKey: string;
+    /**
+     * Tenant-specific Hawcx host (for example: https://hawcx-api.hawcx.com).
+     * The native SDK appends /hc_auth internally—do not add extra paths.
+     */
+    baseUrl?: string;
     oauthConfig?: {
         clientId: string;
         publicKeyPem: string;
         tokenEndpoint: string;
     };
+    /**
+     * @deprecated Use root-level `baseUrl` instead. Kept for backward compatibility during migration.
+     */
     endpoints?: {
         authBaseUrl?: string;
     };
@@ -15,6 +23,18 @@ export type AuthSuccessPayload = {
     refreshToken?: string;
     isLoginFlow: boolean;
 };
+export type AuthorizationCodePayload = {
+    code: string;
+    expiresIn?: number;
+};
+export type AdditionalVerificationPayload = {
+    sessionId: string;
+    detail?: string;
+};
+export type BackendOAuthTokens = {
+    accessToken: string;
+    refreshToken?: string;
+};
 export type AuthErrorPayload = {
     code: string;
     message: string;
@@ -24,6 +44,12 @@ export type AuthEvent = {
 } | {
     type: 'auth_success';
     payload: AuthSuccessPayload;
+} | {
+    type: 'authorization_code';
+    payload: AuthorizationCodePayload;
+} | {
+    type: 'additional_verification_required';
+    payload: AdditionalVerificationPayload;
 } | {
     type: 'auth_error';
     payload: AuthErrorPayload;
@@ -51,6 +77,7 @@ export type PushEvent = {
 export declare function initialize(config: HawcxInitializeConfig): Promise<void>;
 export declare function authenticate(userId: string): Promise<void>;
 export declare function submitOtp(otp: string): Promise<void>;
+export declare function storeBackendOAuthTokens(userId: string, accessToken: string, refreshToken?: string): Promise<void>;
 export declare function getDeviceDetails(): Promise<void>;
 export declare function webLogin(pin: string): Promise<void>;
 export declare function webApprove(token: string): Promise<void>;
@@ -73,6 +100,8 @@ export declare class HawcxAuthError extends Error {
 }
 export type HawcxAuthOptions = {
     onOtpRequired?: () => void;
+    onAuthorizationCode?: (payload: AuthorizationCodePayload) => void;
+    onAdditionalVerificationRequired?: (payload: AdditionalVerificationPayload) => void;
     onEvent?: (event: AuthEvent) => void;
 };
 export type AuthInvocation = {
@@ -100,6 +129,7 @@ export declare class HawcxClient {
     approvePushRequest(requestId: string): Promise<void>;
     declinePushRequest(requestId: string): Promise<void>;
     addPushListener(handler: (event: PushEvent) => void): EmitterSubscription;
+    storeBackendOAuthTokens(userId: string, tokens: BackendOAuthTokens): Promise<void>;
 }
 export declare const hawcxClient: HawcxClient;
 export type HawcxAuthHookState = {
@@ -109,6 +139,12 @@ export type HawcxAuthHookState = {
 } | {
     status: 'otp';
     attempts: number;
+} | {
+    status: 'authorization_code';
+    payload: AuthorizationCodePayload;
+} | {
+    status: 'additional_verification_required';
+    payload: AdditionalVerificationPayload;
 } | {
     status: 'success';
     result: AuthSuccessPayload;

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,kBAAkB,EAElB,mBAAmB,EAEpB,MAAM,cAAc,CAAC;AAWtB,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,SAAS,CAAC,EAAE;QACV,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAC3B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAC;AA0CtD,wBAAgB,UAAU,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUvE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1D;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpD;AAED,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhD;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvD;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASxD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBvF;AAED,wBAAgB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAEzF;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnE;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMnE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,mBAAmB,CAExF;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,mBAAmB,CAE9F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,mBAAmB,CAExF;AAED,eAAO,MAAM,QAAQ,iDAAc,CAAC;AAEpC,qBAAa,cAAe,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,EAAE,gBAAgB,CAAC;gBAE9B,OAAO,EAAE,gBAAgB;CAMtC;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAOF,qBAAa,WAAW;IACtB,UAAU,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,cAAc;IA4CxE,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3F,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB/F,WAAW,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,mBAAmB;IAIrE,cAAc,IAAI,IAAI;IAItB,kBAAkB,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxE,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC,sBAAsB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1E,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,eAAe,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,mBAAmB;CAG1E;AAED,eAAO,MAAM,WAAW,aAAoB,CAAC;AAE7C,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEjD,wBAAgB,YAAY,CAAC,MAAM,GAAE,WAAyB;;2BA4BjD,MAAM,YAAY,gBAAgB;qBAQrC,MAAM;;EAiBf;AAED,sDAAsD;AACtD,eAAO,MAAM,mBAAmB;;;;;;;CAO/B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,WAAyB;;oBAexD,MAAM;wBAQJ,MAAM;;;EAuBjB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hawcx/react-native-sdk",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "React Native SDK that wraps the Hawcx V5 iOS framework for secure mobile authentication.",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",

package/react_mobile_sdk_plan.md

@@ -219,6 +219,8 @@ _Update this table as you work. Status values: TODO / IN-PROGRESS / BLOCKED / DO
 | E | JS/TS platform ergonomics | Codex (2025-11-15) | DONE | Added cross-platform push helpers, Android guards, README/testing updates |
 | F | Example app + Android QA harness | Codex (2025-11-15) | DONE | Example app updated for Android + push harness, README + Maestro docs refreshed |
 | G | Docs + release updates | Codex (2025-11-15) | DONE | Release guide now covers Android Gradle checks + dual-platform handoff |
+| H | OAuth authorization-code surfacing + backend token helper | Codex (2025-11-17) | DONE | React bridges emit `authorization_code`/`additional_verification_required` events and expose `storeBackendOAuthTokens`; TypeScript API + tests updated |
+| I | Example app backend toggle + documentation refresh | Codex (2025-11-17) | DONE | RN demo app can send codes to `hawcx_node_oauth_client/demo`, README + mint docs document backend setup and ngrok flow |
 
 Add rows if new scope appears (e.g., analytics hook, tenant-specific API). Include blockers and links to PRs.
 

package/src/__tests__/index.test.ts

@@ -2,6 +2,7 @@ import {
   initialize,
   authenticate,
   submitOtp,
+  storeBackendOAuthTokens,
   webLogin,
   webApprove,
   approvePushRequest,
@@ -11,7 +12,7 @@ import {
   HawcxAuthError,
   __INTERNAL_EVENTS__,
 } from '../index';
-import { Platform } from 'react-native';
+import { NativeModules, Platform } from 'react-native';
 
 const ORIGINAL_PLATFORM = Platform.OS;
 
@@ -27,6 +28,10 @@ describe('Hawcx React Native SDK', () => {
     await expect(initialize({ projectApiKey: '' })).rejects.toThrow('projectApiKey is required');
   });
 
+  it('rejects initialize call without base url', async () => {
+    await expect(initialize({ projectApiKey: 'key' })).rejects.toThrow('baseUrl is required');
+  });
+
   it('rejects authenticate call without userId', async () => {
     await expect(authenticate('   ')).rejects.toThrow('userId is required');
   });
@@ -114,6 +119,22 @@ describe('HawcxClient helpers', () => {
     });
   });
 
+  it('invokes authorization code callback', async () => {
+    const onAuthorizationCode = jest.fn();
+    client.authenticate('user@example.com', { onAuthorizationCode });
+    const payload = { code: 'abc', expiresIn: 30 };
+    emitAuth({ type: 'authorization_code', payload });
+    expect(onAuthorizationCode).toHaveBeenCalledWith(payload);
+  });
+
+  it('invokes additional verification callback', async () => {
+    const onAdditionalVerificationRequired = jest.fn();
+    client.authenticate('user@example.com', { onAdditionalVerificationRequired });
+    const payload = { sessionId: 'sid', detail: 'extra' };
+    emitAuth({ type: 'additional_verification_required', payload });
+    expect(onAdditionalVerificationRequired).toHaveBeenCalledWith(payload);
+  });
+
   it('invokes push event handlers', async () => {
     const handler = jest.fn();
     const subscription = client.addPushListener(handler);
@@ -161,3 +182,25 @@ describe('push token helpers', () => {
     );
   });
 });
+
+describe('storeBackendOAuthTokens helper', () => {
+  const bridge = NativeModules.HawcxReactNative.storeBackendOAuthTokens as jest.Mock;
+
+  beforeEach(() => {
+    bridge.mockResolvedValue(true);
+  });
+
+  it('calls native bridge with trimmed values', async () => {
+    await storeBackendOAuthTokens(' user@example.com ', ' token ', ' refresh ');
+    expect(bridge).toHaveBeenCalledWith('user@example.com', 'token', 'refresh');
+  });
+
+  it('passes null refresh token when omitted', async () => {
+    await storeBackendOAuthTokens('user@example.com', 'token');
+    expect(bridge).toHaveBeenCalledWith('user@example.com', 'token', null);
+  });
+
+  it('rejects when userId empty', async () => {
+    await expect(storeBackendOAuthTokens('   ', 'token')).rejects.toThrow('userId is required');
+  });
+});

package/src/index.ts

@@ -17,11 +17,19 @@ const PUSH_EVENT = 'hawcx.push.event';
 
 export type HawcxInitializeConfig = {
   projectApiKey: string;
+  /**
+   * Tenant-specific Hawcx host (for example: https://hawcx-api.hawcx.com).
+   * The native SDK appends /hc_auth internally—do not add extra paths.
+   */
+  baseUrl?: string;
   oauthConfig?: {
     clientId: string;
     publicKeyPem: string;
     tokenEndpoint: string;
   };
+  /**
+   * @deprecated Use root-level `baseUrl` instead. Kept for backward compatibility during migration.
+   */
   endpoints?: {
     authBaseUrl?: string;
   };
@@ -33,6 +41,21 @@ export type AuthSuccessPayload = {
   isLoginFlow: boolean;
 };
 
+export type AuthorizationCodePayload = {
+  code: string;
+  expiresIn?: number;
+};
+
+export type AdditionalVerificationPayload = {
+  sessionId: string;
+  detail?: string;
+};
+
+export type BackendOAuthTokens = {
+  accessToken: string;
+  refreshToken?: string;
+};
+
 export type AuthErrorPayload = {
   code: string;
   message: string;
@@ -41,6 +64,8 @@ export type AuthErrorPayload = {
 export type AuthEvent =
   | { type: 'otp_required' }
   | { type: 'auth_success'; payload: AuthSuccessPayload }
+  | { type: 'authorization_code'; payload: AuthorizationCodePayload }
+  | { type: 'additional_verification_required'; payload: AdditionalVerificationPayload }
   | { type: 'auth_error'; payload: AuthErrorPayload };
 
 export type SessionEvent =
@@ -63,6 +88,11 @@ type NativeBridge = {
   initialize(config: HawcxInitializeConfig): Promise<void>;
   authenticate(userId: string): Promise<void>;
   submitOtp(otp: string): Promise<void>;
+  storeBackendOAuthTokens(
+    userId: string,
+    accessToken: string,
+    refreshToken?: string | null,
+  ): Promise<boolean>;
   getDeviceDetails(): Promise<void>;
   webLogin(pin: string): Promise<void>;
   webApprove(token: string): Promise<void>;
@@ -99,12 +129,19 @@ const ensureNonEmpty = (value: string, field: string): string => {
   return trimmed;
 };
 
+const resolveBaseUrl = (config: HawcxInitializeConfig): string => {
+  const candidate = config.baseUrl ?? config.endpoints?.authBaseUrl ?? '';
+  return ensureNonEmpty(candidate, 'baseUrl');
+};
+
 export function initialize(config: HawcxInitializeConfig): Promise<void> {
   try {
     const apiKey = ensureNonEmpty(config.projectApiKey, 'projectApiKey');
+    const baseUrl = resolveBaseUrl(config);
     return HawcxReactNative.initialize({
       ...config,
       projectApiKey: apiKey,
+      baseUrl,
     });
   } catch (error) {
     return Promise.reject(error);
@@ -127,6 +164,25 @@ export function submitOtp(otp: string): Promise<void> {
   }
 }
 
+export function storeBackendOAuthTokens(
+  userId: string,
+  accessToken: string,
+  refreshToken?: string,
+): Promise<void> {
+  try {
+    const trimmedUser = ensureNonEmpty(userId, 'userId');
+    const trimmedAccess = ensureNonEmpty(accessToken, 'accessToken');
+    const trimmedRefresh = refreshToken?.trim();
+    return HawcxReactNative.storeBackendOAuthTokens(
+      trimmedUser,
+      trimmedAccess,
+      trimmedRefresh && trimmedRefresh.length > 0 ? trimmedRefresh : null,
+    ).then(() => undefined);
+  } catch (error) {
+    return Promise.reject(error);
+  }
+}
+
 export function getDeviceDetails(): Promise<void> {
   return HawcxReactNative.getDeviceDetails();
 }
@@ -244,6 +300,8 @@ export class HawcxAuthError extends Error {
 
 export type HawcxAuthOptions = {
   onOtpRequired?: () => void;
+  onAuthorizationCode?: (payload: AuthorizationCodePayload) => void;
+  onAdditionalVerificationRequired?: (payload: AdditionalVerificationPayload) => void;
   onEvent?: (event: AuthEvent) => void;
 };
 
@@ -280,6 +338,12 @@ export class HawcxClient {
           case 'otp_required':
             options?.onOtpRequired?.();
             break;
+          case 'authorization_code':
+            options?.onAuthorizationCode?.(event.payload);
+            break;
+          case 'additional_verification_required':
+            options?.onAdditionalVerificationRequired?.(event.payload);
+            break;
           case 'auth_success':
             cleanup();
             resolve(event.payload);
@@ -387,6 +451,10 @@ export class HawcxClient {
   addPushListener(handler: (event: PushEvent) => void): EmitterSubscription {
     return addPushListener(handler);
   }
+
+  storeBackendOAuthTokens(userId: string, tokens: BackendOAuthTokens): Promise<void> {
+    return storeBackendOAuthTokens(userId, tokens.accessToken, tokens.refreshToken);
+  }
 }
 
 export const hawcxClient = new HawcxClient();
@@ -395,6 +463,8 @@ export type HawcxAuthHookState =
   | { status: 'idle' }
   | { status: 'pending' }
   | { status: 'otp'; attempts: number }
+  | { status: 'authorization_code'; payload: AuthorizationCodePayload }
+  | { status: 'additional_verification_required'; payload: AdditionalVerificationPayload }
   | { status: 'success'; result: AuthSuccessPayload }
   | { status: 'error'; error: AuthErrorPayload };
 
@@ -415,6 +485,17 @@ export function useHawcxAuth(client: HawcxClient = hawcxClient) {
           otpAttempts.current += 1;
           setState({ status: 'otp', attempts: otpAttempts.current });
           break;
+        case 'authorization_code':
+          otpAttempts.current = 0;
+          setState({ status: 'authorization_code', payload: event.payload });
+          break;
+        case 'additional_verification_required':
+          otpAttempts.current = 0;
+          setState({
+            status: 'additional_verification_required',
+            payload: event.payload,
+          });
+          break;
         case 'auth_success':
           otpAttempts.current = 0;
           setState({ status: 'success', result: event.payload });