doct-ui-auth-kit 1.0.23 → 1.0.24

package/dist/types/auth/auth-api-adapter.d.ts

@@ -3,6 +3,7 @@
  * Consumers implement AuthApiAdapter to connect the SDK to their central auth service.
  */
 import type { AuthenticateWithProviderParams, CompleteProfileParams, SendOtpResponse, SSOSession, UserType, VerifyOtpResponse } from './auth-types';
+import type { LinkOrMergeOtpTarget } from './flow';
 /** Parameters for sending OTP to phone or email. */
 export interface SendOtpParams {
     type: 'phone' | 'email';
@@ -39,6 +40,13 @@ export type LinkOrMergeAccountParams = (LinkOrMergeBaseParams & {
     newCountryCode: string;
     newPhone: string;
 });
+export type LinkOrMergeAccountResponse = SSOSession | {
+    otpTarget: LinkOrMergeOtpTarget;
+} | void;
+export interface VerifyLinkOrMergeOtpParams extends LinkOrMergeOtpTarget {
+    otp: string;
+    conflictField: 'email' | 'phone';
+}
 /**
  * Adapter implemented by the consumer to talk to the central auth service.
  * All methods return promises; the SDK handles loading/error state.
@@ -72,7 +80,12 @@ export interface AuthApiAdapter {
      * duplicate new email/mobile. Implementations should only send the fields
      * for `params.conflictField`.
      */
-    linkOrMergeAccount?(params: LinkOrMergeAccountParams): Promise<SSOSession | void>;
+    linkOrMergeAccount?(params: LinkOrMergeAccountParams): Promise<LinkOrMergeAccountResponse>;
+    /**
+     * Optional: verify the OTP sent by linkOrMergeAccount. Called after the
+     * user enters the OTP received on the existing/old email or mobile.
+     */
+    verifyLinkOrMergeOtp?(params: VerifyLinkOrMergeOtpParams): Promise<SSOSession>;
     /** Optional: clear server-side cookie/session on sign out. */
     logout?(): Promise<void>;
 }

package/dist/types/auth/flow.d.ts

@@ -5,7 +5,14 @@ import type { AuthStep, SSOSession, UserType } from './auth-types';
 /** Identifier type for OTP / profile steps. */
 export type IdentifierType = 'phone' | 'email';
 export type LinkOrMergeConflictField = IdentifierType;
-export type LinkOrMergeStage = 'summary' | 'verification';
+export type LinkOrMergeStage = 'summary' | 'otp';
+export interface LinkOrMergeOtpTarget {
+    type: IdentifierType;
+    value: string;
+    countryCode?: string;
+    phone?: string;
+    maskedValue?: string;
+}
 export type LinkOrMergeState = {
     stage: LinkOrMergeStage;
     conflictField: 'email';
@@ -15,6 +22,7 @@ export type LinkOrMergeState = {
     existingPhone?: string;
     oldEmail?: string;
     newEmail: string;
+    otpTarget?: LinkOrMergeOtpTarget;
 } | {
     stage: LinkOrMergeStage;
     conflictField: 'phone';
@@ -26,17 +34,7 @@ export type LinkOrMergeState = {
     oldPhone?: string;
     newCountryCode: string;
     newPhone: string;
-};
-export type LinkOrMergeVerificationInput = {
-    conflictField: 'email';
-    oldEmail: string;
-    newEmail: string;
-} | {
-    conflictField: 'phone';
-    oldCountryCode: string;
-    oldPhone: string;
-    newCountryCode: string;
-    newPhone: string;
+    otpTarget?: LinkOrMergeOtpTarget;
 };
 export type LinkOrMergeSetupPayload = (Omit<Extract<LinkOrMergeState, {
     conflictField: 'email';
@@ -112,7 +110,8 @@ export type AuthFlowAction = {
 } | ({
     type: 'SET_STEP_LINK_OR_MERGE';
 } & LinkOrMergeSetupPayload) | {
-    type: 'SET_LINK_OR_MERGE_VERIFICATION_STAGE';
+    type: 'SET_LINK_OR_MERGE_OTP_STAGE';
+    otpTarget: LinkOrMergeOtpTarget;
 } | {
     type: 'SET_STEP_PROVIDER_PENDING';
 } | {
@@ -175,8 +174,8 @@ export interface AuthFlowActions {
         provider: 'google' | 'apple';
         credential: string;
     }) => void;
-    continueLinkOrMerge: () => void;
-    verifyLinkOrMerge: (data: LinkOrMergeVerificationInput) => Promise<void>;
+    continueLinkOrMerge: () => Promise<void>;
+    verifyLinkOrMerge: (otp: string) => Promise<void>;
     goBack: () => void;
     reset: () => void;
     signOut: () => void;

package/dist/types/pages/pages.d.ts

@@ -2,7 +2,7 @@
  * Props and public types for auth page components.
  */
 import type { UserType } from '../auth/auth-types';
-import type { IdentifierType, LinkOrMergeState, LinkOrMergeVerificationInput } from '../auth/flow';
+import type { IdentifierType, LinkOrMergeState } from '../auth/flow';
 import type { LoginEntryMode } from './login-form';
 import type { UseMainAuthPageHandlersOptions } from './main-login';
 import type { OtpValidateFn, OtpVerificationMode } from './otp-verification';
@@ -88,8 +88,9 @@ export interface SignupPageFullProps extends SignupPageProps {
 export interface LinkOrMergePageProps {
     details: LinkOrMergeState;
     onBack?: (() => void) | undefined;
-    onContinue: () => void;
-    onVerify: (data: LinkOrMergeVerificationInput) => Promise<void>;
+    onContinue: () => Promise<void>;
+    onVerify: (otp: string) => Promise<void>;
+    onResendCode?: (() => void) | undefined;
 }
 /** Props for OtpVerification (inner form without layout). */
 export interface OtpVerificationProps {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "doct-ui-auth-kit",
-  "version": "1.0.23",
+  "version": "1.0.24",
   "description": "Composable React auth SDK – layouts, login/signup/OTP pages, SSO provider, and auth flow hooks for Docthub",
   "type": "module",
   "main": "./dist/index.js",