doct-ui-auth-kit 1.0.13 → 1.0.15

package/dist/pages/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Page components barrel: *Page = full page with layout, bare name = form-only for composition.
+ */
+export { LoginEntry, type LoginEntryMode, LoginEntryPage, type LoginEntryPageProps, type LoginEntryProps, } from './login-entry';
+export { MainLogin, type MainLoginAppleProviderConfig, type MainLoginGoogleProviderConfig, MainLoginPage, type MainLoginPageProps, type MainLoginPageProvidersConfig, } from './main-login';
+export { OtpVerification, type OtpVerificationMode, OtpVerificationPage, type OtpVerificationPageProps, type OtpVerificationProps, } from './otp-verification';
+export { RepeatLogin, RepeatLoginPage, type RepeatLoginPageProps, type RepeatLoginProps, } from './repeat-login';
+export { Signup, SignupPage, type SignupPageFullProps, type SignupPageProps, } from './signup';

package/dist/pages/login-entry/index.d.ts

@@ -0,0 +1,3 @@
+export type { LoginEntryMode, LoginEntryPageProps, LoginEntryProps, } from '../../types';
+export { LoginEntry } from './login-entry';
+export { LoginEntryPage } from './login-entry-page';

package/dist/pages/login-entry/login-entry-page.d.ts

@@ -0,0 +1,21 @@
+import type { LoginEntryPageProps } from '../../types';
+/**
+ * Full LoginEntry page with AuthLayoutWrapper, back button, and slider/standalone layout.
+ * Use when rendering the login entry screen as a standalone page.
+ *
+ * @example Next.js: API call in hook, redirect with mode + recipient for OTP page
+ * ```tsx
+ * <LoginEntryPage
+ *   mode="phone"
+ *   onBack={() => router.back()}
+ *   submitApi={(data) => api.sendOtp(data)}
+ *   onSuccess={(params) => router.push(`/otp?mode=${params.mode}&recipient=${encodeURIComponent(params.recipient)}`)}
+ * />
+ * ```
+ *
+ * @example Sync callback (caller owns API)
+ * ```tsx
+ * <LoginEntryPage mode="phone" onSubmit={(data) => sendOtp(data)} />
+ * ```
+ */
+export declare function LoginEntryPage(props: Readonly<LoginEntryPageProps>): import("react/jsx-runtime").JSX.Element;

package/dist/pages/login-entry/login-entry.d.ts

@@ -0,0 +1,21 @@
+import type { LoginEntryProps } from '../../types';
+/**
+ * Login entry form body without layout wrapper.
+ * Single form for phone or email based on mode. Use inside your own layout or AuthFlow.
+ * Validation per PRODUCT_PROTOCOLS and edge cases 3–5, 18; cursor focus on first field (#26).
+ *
+ * @example With AuthFlow (sync onSubmit)
+ * ```tsx
+ * <LoginEntry mode="phone" onSubmit={(data) => actions.submitIdentifier(data)} />
+ * ```
+ *
+ * @example Standalone Next.js (API + redirect in hook)
+ * ```tsx
+ * <LoginEntry
+ *   mode="phone"
+ *   submitApi={(data) => api.sendOtp(data)}
+ *   onSuccess={() => router.push('/otp')}
+ * />
+ * ```
+ */
+export declare function LoginEntry(props: Readonly<LoginEntryProps>): import("react/jsx-runtime").JSX.Element;

package/dist/pages/main-login/index.d.ts

@@ -0,0 +1,3 @@
+export type { MainLoginAppleProviderConfig, MainLoginGoogleProviderConfig, MainLoginPageProps, MainLoginPageProvidersConfig, } from '../../types';
+export { MainLogin } from './main-login';
+export { MainLoginPage } from './main-login-page';

package/dist/pages/main-login/main-login-page.d.ts

@@ -0,0 +1,16 @@
+import type { MainLoginPageProps } from '../../types';
+/**
+ * Full MainLogin page with AuthLayoutWrapper, header, footer, and slider layout.
+ * Includes default branding and layout configuration.
+ *
+ * @example
+ * ```tsx
+ * <MainLoginPage
+ *   onContinueWithMobile={() => navigate('/auth/phone')}
+ *   onContinueWithEmail={() => navigate('/auth/email')}
+ *   onContinueWithGoogle={() => navigate('/auth/google')}
+ *   onContinueWithApple={() => navigate('/auth/apple')}
+ * />
+ * ```
+ */
+export declare const MainLoginPage: (props: Readonly<MainLoginPageProps>) => import("react/jsx-runtime").JSX.Element;

package/dist/pages/main-login/main-login.d.ts

@@ -0,0 +1,25 @@
+import type { MainAuthPageHandlers, MainLoginPageProps } from '../../types';
+interface MainLoginPageBodyProps {
+    handlers: MainAuthPageHandlers;
+}
+/**
+ * Renders the main login form body with four authentication options.
+ * Each button triggers its corresponding handler from the handlers prop.
+ */
+export declare const MainLoginPageBody: ({ handlers, }: Readonly<MainLoginPageBodyProps>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Login body component without layout wrapper.
+ * Displays four authentication method buttons (Mobile, Email, Google, Apple).
+ *
+ * Use this when you need custom layout or when integrating with AuthFlow.
+ *
+ * @example
+ * ```tsx
+ * <MainLogin
+ *   onContinueWithMobile={() => navigate('/auth/phone')}
+ *   onContinueWithEmail={() => navigate('/auth/email')}
+ * />
+ * ```
+ */
+export declare function MainLogin(props: Readonly<MainLoginPageProps>): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/pages/otp-verification/index.d.ts

@@ -0,0 +1,3 @@
+export type { OtpVerificationMode, OtpVerificationPageProps, OtpVerificationProps, } from '../../types';
+export { OtpVerification } from './otp-verification';
+export { OtpVerificationPage } from './otp-verification-page';

package/dist/pages/otp-verification/otp-verification-page.d.ts

@@ -0,0 +1,23 @@
+import type { OtpVerificationPageProps } from '../../types';
+/**
+ * Full OTP verification page with AuthLayoutWrapper and back button.
+ * Use when rendering the OTP screen as a standalone page.
+ *
+ * @example Next.js: API in hook, redirect from consumer
+ * ```tsx
+ * <OtpVerificationPage
+ *   mode="phone"
+ *   recipientDisplay="+91 9825910X0X"
+ *   onBack={() => router.back()}
+ *   submitApi={(otp) => api.verifyOtp(otp)}
+ *   onSuccess={() => router.push('/dashboard')}
+ *   onResendCode={() => api.resendOtp()}
+ * />
+ * ```
+ *
+ * @example Sync callback (AuthFlow)
+ * ```tsx
+ * <OtpVerificationPage onSubmit={(otp) => actions.verifyOtp(otp)} ... />
+ * ```
+ */
+export declare function OtpVerificationPage(props: Readonly<OtpVerificationPageProps>): import("react/jsx-runtime").JSX.Element;

package/dist/pages/otp-verification/otp-verification.d.ts

@@ -0,0 +1,22 @@
+import type { OtpVerificationProps } from '../../types';
+/**
+ * OTP verification form body without layout wrapper.
+ * 6-digit OTP input, resend countdown, and submit. Use inside your own layout or AuthFlow.
+ * Validation per edge cases 6, 7 (invalid/expired OTP); cursor focus on first OTP box (#26).
+ *
+ * @example With submitApi + onSuccess (consumer redirect)
+ * ```tsx
+ * <OtpVerification
+ *   mode="phone"
+ *   recipientDisplay="+91 9825910X0X"
+ *   submitApi={(otp) => api.verifyOtp(otp)}
+ *   onSuccess={() => router.push('/dashboard')}
+ * />
+ * ```
+ *
+ * @example Sync onSubmit (AuthFlow)
+ * ```tsx
+ * <OtpVerification onSubmit={(otp) => actions.verifyOtp(otp)} ... />
+ * ```
+ */
+export declare function OtpVerification(props: Readonly<OtpVerificationProps>): import("react/jsx-runtime").JSX.Element;

package/dist/pages/repeat-login/index.d.ts

@@ -0,0 +1,3 @@
+export type { RepeatLoginPageProps, RepeatLoginProps } from '../../types';
+export { RepeatLogin } from './repeat-login';
+export { RepeatLoginPage } from './repeat-login-page';

package/dist/pages/repeat-login/repeat-login-page.d.ts

@@ -0,0 +1,24 @@
+import type { RepeatLoginPageProps } from '../../types';
+/**
+ * Full Repeat Login page with AuthLayoutWrapper, logo, title, description, and footer.
+ * Use when rendering the repeat login screen as a standalone page.
+ *
+ * @example Next.js: API in lib, redirect from consumer
+ * ```tsx
+ * <RepeatLoginPage
+ *   lastUsedMethod="Mobile"
+ *   continueApi={() => api.validateSession()}
+ *   onSuccess={() => router.push('/dashboard')}
+ *   onUseAnotherMethod={() => resetFlow()}
+ * />
+ * ```
+ *
+ * @example Sync (AuthFlow)
+ * ```tsx
+ * <RepeatLoginPage
+ *   onContinueWithLastMethod={() => actions.continueWithLastMethod()}
+ *   onUseAnotherMethod={() => actions.reset()}
+ * />
+ * ```
+ */
+export declare function RepeatLoginPage(props: Readonly<RepeatLoginPageProps>): import("react/jsx-runtime").JSX.Element;

package/dist/pages/repeat-login/repeat-login.d.ts

@@ -0,0 +1,25 @@
+import type { RepeatLoginProps } from '../../types';
+/**
+ * Repeat login body without layout wrapper.
+ * Primary CTA (continue with last method) and secondary "Use another method" button.
+ * When continueApi is provided, primary runs: continueApi() → onSuccess() (e.g. redirect).
+ *
+ * @example With continueApi + onSuccess (consumer redirect)
+ * ```tsx
+ * <RepeatLogin
+ *   lastUsedMethod="Mobile"
+ *   continueApi={() => api.validateSession()}
+ *   onSuccess={() => router.push('/dashboard')}
+ *   onUseAnotherMethod={() => resetFlow()}
+ * />
+ * ```
+ *
+ * @example Sync (AuthFlow)
+ * ```tsx
+ * <RepeatLogin
+ *   onContinueWithLastMethod={() => actions.continueWithLastMethod()}
+ *   onUseAnotherMethod={() => actions.reset()}
+ * />
+ * ```
+ */
+export declare function RepeatLogin(props: Readonly<RepeatLoginProps>): import("react/jsx-runtime").JSX.Element;

package/dist/pages/signup/index.d.ts

@@ -0,0 +1,3 @@
+export type { SignupEntryMode, SignupPageFullProps, SignupPageProps, } from '../../types';
+export { Signup } from './signup';
+export { SignupPage } from './signup-page';

package/dist/pages/signup/signup-page.d.ts

@@ -0,0 +1,6 @@
+import type { SignupPageFullProps } from '../../types';
+/**
+ * Full signup page: AuthLayoutWrapper + logo + title + description + {@link Signup} form.
+ * Use when rendering signup as a standalone route. For embedding in a custom layout, use {@link Signup} directly.
+ */
+export declare function SignupPage(props: Readonly<SignupPageFullProps>): import("react/jsx-runtime").JSX.Element;

package/dist/pages/signup/signup.d.ts

@@ -0,0 +1,7 @@
+import type { SignupPageProps } from '../../types';
+/**
+ * Form-only signup component (no layout wrapper). Use inside a custom layout or AuthFlow.
+ * Supports `submitApi` (async, hook-driven — future SSO profile completion plugs in here)
+ * and `onSubmit` (sync, caller-driven via AuthFlow actions).
+ */
+export declare function Signup(props: Readonly<SignupPageProps>): import("react/jsx-runtime").JSX.Element;

package/dist/pages.js

@@ -1,5 +1,5 @@
 "use client";
-import { L as e, a as n, M as g, b as s, O as o, c as t, R as p, d as L, S as r, e as P } from "./signup-page-ChXnxtSS.js";
+import { L as e, a as n, M as g, b as s, O as o, c as t, R as p, d as L, S as r, e as P } from "./signup-page-LsYojX4-.js";
 export {
   e as LoginEntry,
   n as LoginEntryPage,

package/dist/{signup-page-ChXnxtSS.js → signup-page-LsYojX4-.js}

@@ -2,7 +2,7 @@
 import { jsx as m, jsxs as k, Fragment as $e } from "react/jsx-runtime";
 import { DoctButton as B, DoctTypography as R, DoctPhoneInput as Ze, DoctLabeledInput as Qe, DoctCircularProgress as ve, DoctOtpInput as et } from "docthub-core-components";
 import { MdArrowBack as tt, MdChevronRight as nt } from "react-icons/md";
-import q, { createContext as lt, useContext as it, useState as K, useEffect as te, useRef as le } from "react";
+import Y, { createContext as lt, useContext as it, useState as K, useEffect as te, useRef as le } from "react";
 import { useFormContext as ne, Controller as de, useForm as ye, FormProvider as Ce } from "react-hook-form";
 import { z as j } from "zod";
 var ae = { exports: {} }, ge = {};
@@ -10,7 +10,7 @@ var Oe;
 function ot() {
   if (Oe) return ge;
   Oe = 1;
-  var n = q.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE;
+  var n = Y.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE;
   return ge.c = function(e) {
     return n.H.useMemoCache(e);
   }, ge;
@@ -19,7 +19,7 @@ var pe = {};
 var Te;
 function rt() {
   return Te || (Te = 1, process.env.NODE_ENV !== "production" && (function() {
-    var n = q.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE;
+    var n = Y.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE;
     pe.c = function(e) {
       var t = n.H;
       return t === null && console.error(
@@ -277,7 +277,7 @@ function St(n) {
   let a;
   return e[7] !== o || e[8] !== s ? (a = /* @__PURE__ */ m("footer", { className: o, children: s }), e[7] = o, e[8] = s, e[9] = a) : a = e[9], a;
 }
-const H = {
+const q = {
   Root: ht,
   Header: gt,
   Main: Ct,
@@ -436,32 +436,32 @@ function ie(n) {
   e[7] !== w || e[8] !== r ? (L = () => r ? typeof r == "string" ? /* @__PURE__ */ m(R, { variant: "body1", align: w, className: "text-neutral-black", children: r }) : r : null, e[7] = w, e[8] = r, e[9] = L) : L = e[9];
   const M = L;
   let I;
-  e[10] !== a ? (I = a && /* @__PURE__ */ m(H.Header, { children: a }), e[10] = a, e[11] = I) : I = e[11];
+  e[10] !== a ? (I = a && /* @__PURE__ */ m(q.Header, { children: a }), e[10] = a, e[11] = I) : I = e[11];
   let U;
   e[12] !== $ ? (U = $(), e[12] = $, e[13] = U) : U = e[13];
-  let z;
-  e[14] !== w || e[15] !== U ? (z = /* @__PURE__ */ m(H.Logo, { align: w, children: U }), e[14] = w, e[15] = U, e[16] = z) : z = e[16];
   let G;
-  e[17] !== w || e[18] !== T || e[19] !== o ? (G = o && /* @__PURE__ */ m(H.Title, { align: w, children: T() }), e[17] = w, e[18] = T, e[19] = o, e[20] = G) : G = e[20];
+  e[14] !== w || e[15] !== U ? (G = /* @__PURE__ */ m(q.Logo, { align: w, children: U }), e[14] = w, e[15] = U, e[16] = G) : G = e[16];
   let V;
-  e[21] !== w || e[22] !== r || e[23] !== M ? (V = r && /* @__PURE__ */ m(H.Description, { align: w, children: M() }), e[21] = w, e[22] = r, e[23] = M, e[24] = V) : V = e[24];
+  e[17] !== w || e[18] !== T || e[19] !== o ? (V = o && /* @__PURE__ */ m(q.Title, { align: w, children: T() }), e[17] = w, e[18] = T, e[19] = o, e[20] = V) : V = e[20];
+  let H;
+  e[21] !== w || e[22] !== r || e[23] !== M ? (H = r && /* @__PURE__ */ m(q.Description, { align: w, children: M() }), e[21] = w, e[22] = r, e[23] = M, e[24] = H) : H = e[24];
   let W;
-  e[25] !== t ? (W = /* @__PURE__ */ m(H.Body, { children: t }), e[25] = t, e[26] = W) : W = e[26];
-  let Y;
-  e[27] !== z || e[28] !== G || e[29] !== V || e[30] !== W || e[31] !== E ? (Y = /* @__PURE__ */ k(H.Main, { sm: E, children: [
-    z,
+  e[25] !== t ? (W = /* @__PURE__ */ m(q.Body, { children: t }), e[25] = t, e[26] = W) : W = e[26];
+  let z;
+  e[27] !== G || e[28] !== V || e[29] !== H || e[30] !== W || e[31] !== E ? (z = /* @__PURE__ */ k(q.Main, { sm: E, children: [
     G,
     V,
+    H,
     W
-  ] }), e[27] = z, e[28] = G, e[29] = V, e[30] = W, e[31] = E, e[32] = Y) : Y = e[32];
+  ] }), e[27] = G, e[28] = V, e[29] = H, e[30] = W, e[31] = E, e[32] = z) : z = e[32];
   let J;
-  e[33] !== s ? (J = s && /* @__PURE__ */ m(H.Footer, { children: s }), e[33] = s, e[34] = J) : J = e[34];
+  e[33] !== s ? (J = s && /* @__PURE__ */ m(q.Footer, { children: s }), e[33] = s, e[34] = J) : J = e[34];
   let oe;
-  e[35] !== I || e[36] !== Y || e[37] !== J ? (oe = /* @__PURE__ */ k($e, { children: [
+  e[35] !== I || e[36] !== z || e[37] !== J ? (oe = /* @__PURE__ */ k($e, { children: [
     I,
-    Y,
+    z,
     J
-  ] }), e[35] = I, e[36] = Y, e[37] = J, e[38] = oe) : oe = e[38];
+  ] }), e[35] = I, e[36] = z, e[37] = J, e[38] = oe) : oe = e[38];
   const X = oe;
   if (C === "withSlider") {
     let Q;
@@ -469,7 +469,7 @@ function ie(n) {
       className: y
     }, e[39] = y, e[40] = Q) : Q = e[40];
     let ee;
-    e[41] !== X || e[42] !== x || e[43] !== O ? (ee = /* @__PURE__ */ m(H.Root, { variant: O, maxWidth: x, className: "bg-transparent", children: X }), e[41] = X, e[42] = x, e[43] = O, e[44] = ee) : ee = e[44];
+    e[41] !== X || e[42] !== x || e[43] !== O ? (ee = /* @__PURE__ */ m(q.Root, { variant: O, maxWidth: x, className: "bg-transparent", children: X }), e[41] = X, e[42] = x, e[43] = O, e[44] = ee) : ee = e[44];
     let se;
     return e[45] !== S || e[46] !== N || e[47] !== f || e[48] !== Q || e[49] !== ee ? (se = /* @__PURE__ */ m(wt, { sliderImages: N, sliderAutoPlayInterval: S, sliderTitles: f, ...Q, children: ee }), e[45] = S, e[46] = N, e[47] = f, e[48] = Q, e[49] = ee, e[50] = se) : se = e[50], se;
   }
@@ -478,7 +478,7 @@ function ie(n) {
     className: y
   }, e[51] = y, e[52] = Z) : Z = e[52];
   let re;
-  return e[53] !== X || e[54] !== x || e[55] !== O || e[56] !== Z ? (re = /* @__PURE__ */ m(H.Root, { variant: O, maxWidth: x, ...Z, children: X }), e[53] = X, e[54] = x, e[55] = O, e[56] = Z, e[57] = re) : re = e[57], re;
+  return e[53] !== X || e[54] !== x || e[55] !== O || e[56] !== Z ? (re = /* @__PURE__ */ m(q.Root, { variant: O, maxWidth: x, ...Z, children: X }), e[53] = X, e[54] = x, e[55] = O, e[56] = Z, e[57] = re) : re = e[57], re;
 }
 function _t(n) {
   return {
@@ -900,7 +900,7 @@ var qe = {
   className: void 0,
   style: void 0,
   attr: void 0
-}, ke = q.createContext && /* @__PURE__ */ q.createContext(qe), Vt = ["attr", "size", "title"];
+}, ke = Y.createContext && /* @__PURE__ */ Y.createContext(qe), Vt = ["attr", "size", "title"];
 function Ht(n, e) {
   if (n == null) return {};
   var t = qt(n, e), l, i;
@@ -970,12 +970,12 @@ function Jt(n, e) {
   return (e === "string" ? String : Number)(n);
 }
 function Ye(n) {
-  return n && n.map((e, t) => /* @__PURE__ */ q.createElement(e.tag, he({
+  return n && n.map((e, t) => /* @__PURE__ */ Y.createElement(e.tag, he({
     key: t
   }, e.attr), Ye(e.child)));
 }
 function Ke(n) {
-  return (e) => /* @__PURE__ */ q.createElement(Xt, me({
+  return (e) => /* @__PURE__ */ Y.createElement(Xt, me({
     attr: he({}, n.attr)
   }, e), Ye(n.child));
 }
@@ -986,7 +986,7 @@ function Xt(n) {
       size: i,
       title: o
     } = n, r = Ht(n, Vt), s = i || t.size || "1em", a;
-    return t.className && (a = t.className), n.className && (a = (a ? a + " " : "") + n.className), /* @__PURE__ */ q.createElement("svg", me({
+    return t.className && (a = t.className), n.className && (a = (a ? a + " " : "") + n.className), /* @__PURE__ */ Y.createElement("svg", me({
       stroke: "currentColor",
       fill: "currentColor",
       strokeWidth: "0"
@@ -998,9 +998,9 @@ function Xt(n) {
       height: s,
       width: s,
       xmlns: "http://www.w3.org/2000/svg"
-    }), o && /* @__PURE__ */ q.createElement("title", null, o), n.children);
+    }), o && /* @__PURE__ */ Y.createElement("title", null, o), n.children);
   };
-  return ke !== void 0 ? /* @__PURE__ */ q.createElement(ke.Consumer, null, (t) => e(t)) : e(qe);
+  return ke !== void 0 ? /* @__PURE__ */ Y.createElement(ke.Consumer, null, (t) => e(t)) : e(qe);
 }
 function Zt(n) {
   return Ke({ attr: { viewBox: "0 0 384 512" }, child: [{ tag: "path", attr: { d: "M318.7 268.7c-.2-36.7 16.4-64.4 50-84.8-18.8-26.9-47.2-41.7-84.7-44.6-35.5-2.8-74.3 20.7-88.5 20.7-15 0-49.4-19.7-76.4-19.7C63.3 141.2 4 184.8 4 273.5q0 39.3 14.4 81.2c12.8 36.7 59 126.7 107.2 125.2 25.2-.6 43-17.9 75.8-17.9 31.8 0 48.3 17.9 76.4 17.9 48.6-.7 90.4-82.5 102.6-119.3-65.2-30.7-61.7-90-61.7-91.9zm-56.6-164.2c27.3-32.4 24.8-61.9 24-72.5-24.1 1.4-52 16.4-67.9 34.9-17.5 19.8-27.8 44.3-25.6 71.9 26.1 2 49.9-11.4 69.5-34.3z" }, child: [] }] })(n);
@@ -1097,26 +1097,27 @@ function rn(n) {
   e[4] !== f ? (N = () => {
     if (f <= 0)
       return;
-    const z = setInterval(() => {
+    const G = setInterval(() => {
       p(an);
     }, 1e3);
-    return () => clearInterval(z);
+    return () => clearInterval(G);
   }, S = [f], e[4] = f, e[5] = N, e[6] = S) : (N = e[5], S = e[6]), te(N, S);
   let x;
-  e[7] !== C || e[8] !== s || e[9] !== l || e[10] !== r || e[11] !== o || e[12] !== a ? (x = async (z) => {
-    const G = He.safeParse(z);
-    if (!G.success) {
-      const W = G.error.issues[0]?.message ?? "Invalid OTP";
+  e[7] !== C || e[8] !== s || e[9] !== l || e[10] !== r || e[11] !== o || e[12] !== a ? (x = async (G) => {
+    C.clearErrors("otp");
+    const V = He.safeParse(G);
+    if (!V.success) {
+      const W = V.error.issues[0]?.message ?? "Invalid OTP";
       C.setError("otp", {
         message: W
       });
       return;
     }
-    const V = G.data.otp.join("");
+    const H = V.data.otp.join("");
     if (a) {
       u(!0);
       try {
-        const W = await a(V);
+        const W = await a(H);
         if (W !== !0) {
           C.setError("otp", {
             type: "validate",
@@ -1131,16 +1132,20 @@ function rn(n) {
       o || u(!1);
     }
     if (o) {
-      u(!0), o(V).then(() => {
+      u(!0), o(H).then(() => {
         r?.();
       }).catch((W) => {
-        s?.(W);
+        const z = W?.message;
+        C.setError("otp", {
+          type: "submit",
+          message: typeof z == "string" && z.length > 0 ? z : "OTP verification failed"
+        }), s?.(W);
       }).finally(() => {
         u(!1);
       });
       return;
     }
-    l?.(V);
+    l?.(H);
   }, e[7] = C, e[8] = s, e[9] = l, e[10] = r, e[11] = o, e[12] = a, e[13] = x) : x = e[13];
   const A = x;
   let w;
@@ -1666,7 +1671,7 @@ export {
   On as d,
   Tn as e,
   _ as f,
-  H as g,
+  q as g,
   _t as h,
   Tt as i,
   Be as j,

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

@@ -0,0 +1,57 @@
+/**
+ * API adapter types for the SSO auth SDK.
+ * Consumers implement AuthApiAdapter to connect the SDK to their central auth service.
+ */
+import type { AuthenticateWithProviderParams, CompleteProfileParams, SendOtpResponse, SSOSession, UserType, VerifyOtpResponse } from './auth-types';
+/** Parameters for sending OTP to phone or email. */
+export interface SendOtpParams {
+    type: 'phone' | 'email';
+    value: string;
+}
+/** Parameters for verifying OTP. */
+export interface VerifyOtpParams {
+    type: 'phone' | 'email';
+    value: string;
+    otp: string;
+}
+/** Optional lookup to branch flows before sending OTP (e.g. foreign existing user). */
+export interface CheckIdentifierParams {
+    type: 'phone' | 'email';
+    value: string;
+}
+/** Optional lookup response used by the provider to choose the next step. */
+export interface CheckIdentifierResponse {
+    exists: boolean;
+    userType?: UserType;
+}
+/**
+ * Adapter implemented by the consumer to talk to the central auth service.
+ * All methods return promises; the SDK handles loading/error state.
+ */
+export interface AuthApiAdapter {
+    /** Send OTP to the given phone or email. */
+    sendOtp(params: SendOtpParams): Promise<SendOtpResponse>;
+    /**
+     * Verify OTP. Returns session if existing user, or isNewUser flag for profile completion.
+     * May return conflict error when identifier is linked to another account.
+     */
+    verifyOtp(params: VerifyOtpParams): Promise<VerifyOtpResponse>;
+    /** Complete profile for new users; returns SSO session. */
+    completeProfile(params: CompleteProfileParams): Promise<SSOSession>;
+    /** Authenticate with a third-party provider (Google/Apple) credential. */
+    authenticateWithProvider(params: AuthenticateWithProviderParams): Promise<VerifyOtpResponse>;
+    /** Validate an existing SSO session token; called on SDK mount. Returns null if invalid/expired. */
+    validateSession(token: string): Promise<SSOSession | null>;
+    /**
+     * Optional: validate session using server-read cookie (no token from client).
+     * Required when using serverCookieTokenStorage. Client sends credentials;
+     * server reads cookie from the request and returns session or null.
+     */
+    validateSessionFromCookie?(): Promise<SSOSession | null>;
+    /** Optional: refresh an expired SSO session using refresh token. */
+    refreshSession?(refreshToken: string): Promise<SSOSession | null>;
+    /** Optional: check identifier existence before OTP routing decisions. */
+    checkIdentifier?(params: CheckIdentifierParams): Promise<CheckIdentifierResponse>;
+    /** Optional: clear server-side cookie/session on sign out. */
+    logout?(): Promise<void>;
+}

package/dist/types/auth/auth-provider.d.ts

@@ -0,0 +1,40 @@
+import type { ReactNode } from 'react';
+import type { AuthApiAdapter } from './auth-api-adapter';
+import type { AuthError, SSOSession } from './auth-types';
+import type { TokenStorageStrategy } from './sso-session';
+/** Consumer-provided config for SSOAuthProvider. */
+export interface SSOAuthConfig {
+    /** Consumer-provided adapter to their central auth service. */
+    apiAdapter: AuthApiAdapter;
+    /** Auth method configs (Google client ID, Apple client ID, etc.). */
+    providers?: {
+        google?: {
+            clientId: string;
+            enableOneTap?: boolean;
+        };
+        apple?: {
+            clientId: string;
+            redirectUri: string;
+        };
+    };
+    /** Called when SSO session is established (any method). */
+    onAuthSuccess: (session: SSOSession) => void;
+    /** Called on auth errors. */
+    onAuthError?: (error: AuthError) => void;
+    /** Optional: called when user signs out. */
+    onSignOut?: () => void;
+    /** SSO token persistence strategy. Defaults to localStorage. */
+    tokenStorage?: TokenStorageStrategy;
+    /** Branding customization (logo, slider images). */
+    branding?: {
+        logo?: ReactNode;
+        sliderImages?: string[];
+    };
+}
+/** Props for the SSOAuthProvider context wrapper that supplies auth state to the component tree. */
+export interface SSOAuthProviderProps {
+    /** Auth configuration including API adapter, provider settings, and callbacks. */
+    config: SSOAuthConfig;
+    /** Child components that will have access to the SSO auth context. */
+    children: ReactNode;
+}

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

@@ -0,0 +1,70 @@
+/**
+ * SSO auth domain types: session, flow steps, adapter contracts, and error codes.
+ * Used by the flow engine, provider, and adapter implementations.
+ */
+/** Auth methods available in the SSO system. */
+export type AuthMethod = 'phone' | 'email' | 'google' | 'apple';
+/** User payload in the SSO session. */
+export interface SSOUser {
+    id: string;
+    name: string;
+    email?: string;
+    phone?: string;
+    avatar?: string;
+    isNewUser: boolean;
+}
+/** The SSO session — same structure regardless of auth method used. */
+export interface SSOSession {
+    accessToken: string;
+    refreshToken?: string;
+    expiresAt: number;
+    user: SSOUser;
+    authMethod: AuthMethod;
+}
+/** User type for layout and OTP routing: Indian (+91) vs Foreign (non +91). */
+export type UserType = 'INDIAN' | 'FOREIGN';
+/** Flow states for the state machine. */
+export type AuthStep = 'CHECKING_SESSION' | 'REPEAT_LOGIN' | 'METHOD_SELECT' | 'PHONE_ENTRY' | 'EMAIL_ENTRY' | 'OTP_VERIFICATION' | 'SIGNUP_DETAILS' | 'PROVIDER_PENDING' | 'AUTHENTICATED';
+/** Error codes from the central auth service. */
+export type AuthErrorCode = 'IDENTIFIER_CONFLICT' | 'OTP_EXPIRED' | 'OTP_INVALID' | 'OTP_RATE_LIMIT' | 'SESSION_EXPIRED' | 'PROVIDER_AUTH_FAILED' | 'NETWORK_ERROR' | 'UNKNOWN';
+/** Auth error with code and optional message / linked identifier. */
+export interface AuthError {
+    code: AuthErrorCode;
+    message?: string;
+    /** Masked linked identifier when conflict (e.g. "+91 98XXXX0X0X"). */
+    linkedIdentifier?: string;
+}
+/** Response from sendOtp. */
+export interface SendOtpResponse {
+    success: boolean;
+    /** Masked value for display (e.g. "+91 9825910X0X" or "j***@gmail.com"). */
+    maskedValue?: string;
+    error?: AuthError;
+}
+/** Result of verifyOtp or authenticateWithProvider: existing user gets session, new user gets profile step. */
+export interface VerifyOtpResponse {
+    /** Present when user exists and is authenticated. */
+    session?: SSOSession;
+    /** True when user is new and must complete profile. */
+    isNewUser: boolean;
+    /** When isNewUser and conflict (e.g. email already linked), masked linked identifier. */
+    conflict?: AuthError;
+}
+/** Input for completeProfile (new users). */
+export interface CompleteProfileParams {
+    fullName: string;
+    email?: string;
+    phone?: string;
+}
+/** Input for authenticateWithProvider (Google/Apple credential). */
+export interface AuthenticateWithProviderParams {
+    provider: 'google' | 'apple';
+    /** Id token or equivalent from the provider. */
+    credential: string;
+}
+/** Repeat-login device history (method + masked identifier). */
+export interface RepeatLoginInfo {
+    method: AuthMethod;
+    maskedIdentifier: string;
+    timestamp: number;
+}

package/dist/types/auth/device-detection.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Types for device-based repeat-login detection and persistence.
+ */
+import type { AuthMethod } from './auth-types';
+/** Stored repeat-login info (method + masked identifier). */
+export interface StoredRepeatLogin {
+    /** The authentication method used in the previous login (e.g. `'phone'`, `'email'`, `'google'`). */
+    method: AuthMethod;
+    /** Partially masked identifier shown to the user (e.g. `"****1234"` or `"j***@example.com"`). */
+    maskedIdentifier: string;
+    /** Unix epoch (ms) when this login record was stored. Used for expiry checks. */
+    timestamp: number;
+}