doct-ui-auth-kit 1.0.22 → 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';
@@ -30,18 +31,22 @@ interface LinkOrMergeBaseParams {
 }
 export type LinkOrMergeAccountParams = (LinkOrMergeBaseParams & {
     conflictField: 'email';
-    oldEmail?: string;
-    oldCountryCode?: string;
-    oldPhone?: string;
+    oldEmail: string;
     newEmail: string;
 }) | (LinkOrMergeBaseParams & {
     conflictField: 'phone';
-    oldEmail?: string;
-    oldCountryCode?: string;
-    oldPhone?: string;
+    oldCountryCode: string;
+    oldPhone: string;
     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.
@@ -75,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,22 +5,46 @@ 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' | 'otp';
+export interface LinkOrMergeOtpTarget {
+    type: IdentifierType;
+    value: string;
+    countryCode?: string;
+    phone?: string;
+    maskedValue?: string;
+}
 export type LinkOrMergeState = {
+    stage: LinkOrMergeStage;
     conflictField: 'email';
     name: string;
+    existingEmail?: string;
+    existingCountryCode?: string;
+    existingPhone?: string;
     oldEmail?: string;
-    oldCountryCode?: string;
-    oldPhone?: string;
     newEmail: string;
+    otpTarget?: LinkOrMergeOtpTarget;
 } | {
+    stage: LinkOrMergeStage;
     conflictField: 'phone';
     name: string;
-    oldEmail?: string;
+    existingEmail?: string;
+    existingCountryCode?: string;
+    existingPhone?: string;
     oldCountryCode?: string;
     oldPhone?: string;
     newCountryCode: string;
     newPhone: string;
+    otpTarget?: LinkOrMergeOtpTarget;
 };
+export type LinkOrMergeSetupPayload = (Omit<Extract<LinkOrMergeState, {
+    conflictField: 'email';
+}>, 'stage'> & {
+    stage?: LinkOrMergeStage;
+}) | (Omit<Extract<LinkOrMergeState, {
+    conflictField: 'phone';
+}>, 'stage'> & {
+    stage?: LinkOrMergeStage;
+});
 /** Full state for the auth flow. */
 export interface AuthFlowState {
     step: AuthStep;
@@ -85,7 +109,10 @@ export type AuthFlowAction = {
     maskedRecipient?: string;
 } | ({
     type: 'SET_STEP_LINK_OR_MERGE';
-} & LinkOrMergeState) | {
+} & LinkOrMergeSetupPayload) | {
+    type: 'SET_LINK_OR_MERGE_OTP_STAGE';
+    otpTarget: LinkOrMergeOtpTarget;
+} | {
     type: 'SET_STEP_PROVIDER_PENDING';
 } | {
     type: 'SET_STEP_AUTHENTICATED';
@@ -147,7 +174,8 @@ export interface AuthFlowActions {
         provider: 'google' | 'apple';
         credential: string;
     }) => void;
-    verifyLinkOrMerge: () => Promise<void>;
+    continueLinkOrMerge: () => Promise<void>;
+    verifyLinkOrMerge: (otp: string) => Promise<void>;
     goBack: () => void;
     reset: () => void;
     signOut: () => void;

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

@@ -88,7 +88,9 @@ export interface SignupPageFullProps extends SignupPageProps {
 export interface LinkOrMergePageProps {
     details: LinkOrMergeState;
     onBack?: (() => void) | undefined;
-    onVerify: () => 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.22",
+  "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",