doct-ui-auth-kit 1.0.7 → 1.0.8

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

@@ -0,0 +1,9 @@
+/**
+ * Auth domain types: session, adapter, provider, flow state, errors, device detection.
+ */
+export * from './auth-types';
+export * from './auth-api-adapter';
+export * from './auth-provider';
+export * from './sso-session';
+export * from './device-detection';
+export * from './flow';

package/dist/types/components/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Component prop types: form fields, layouts, auth-layout compound, presets.
+ */
+export * from './forms';
+export * from './layout';
+export * from './auth-layout-types';
+export * from './layout-presets';

package/dist/types/index.d.ts

@@ -1,20 +1,7 @@
 /**
- * Central export file for all types and interfaces.
- * Import types from here: import type { RHFInputFieldProps } from '@/types';
+ * Central export for all types and interfaces.
+ * Organized by domain: auth (SSO), components (props), pages (page-specific).
  */
-export * from './auth-api-adapter';
-export * from './auth-layout-types';
-export * from './auth-provider';
-export * from './auth-types';
-export * from './device-detection';
-export * from './flow';
-export * from './forms';
-export * from './layout';
-export * from './layout-presets';
-export * from './login-form';
-export * from './main-login';
-export * from './otp-verification';
+export * from './auth';
+export * from './components';
 export * from './pages';
-export * from './repeat-login';
-export * from './signup-form';
-export * from './sso-session';

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

@@ -0,0 +1,9 @@
+/**
+ * Page-specific types: props, form values, hook options/return types.
+ */
+export * from './pages';
+export * from './login-form';
+export * from './signup-form';
+export * from './otp-verification';
+export * from './main-login';
+export * from './repeat-login';

package/dist/types/{login-form.d.ts → pages/login-form.d.ts}

@@ -1,6 +1,6 @@
 import { UseFormReturn } from 'react-hook-form';
 import { z } from 'zod';
-import { loginEmailFormSchema, loginPhoneFormSchema } from '../validations';
+import { loginEmailFormSchema, loginPhoneFormSchema } from '../../validations';
 /** Login mode: phone number or email */
 export type LoginEntryMode = 'phone' | 'email';
 /** Form values for phone-based login, inferred from the Zod schema. */
@@ -35,11 +35,11 @@ export interface UseLoginEntryFormOptions {
      * When provided, hook runs business logic: validate → call submitApi(data) → onSuccess(params).
      * Use from consumer (e.g. Next.js): submitApi = sendOtp, onSuccess = (params) => router.push(`/otp?mode=${params.mode}&recipient=${encodeURIComponent(params.recipient)}`).
      */
-    submitApi?: (data: LoginEntrySubmitData) => Promise<void>;
+    submitApi?: ((data: LoginEntrySubmitData) => Promise<void>) | undefined;
     /** Called after submitApi resolves successfully; receives mode and recipient for OTP redirect/display. */
-    onSuccess?: (params: LoginEntrySuccessParams) => void;
+    onSuccess?: ((params: LoginEntrySuccessParams) => void) | undefined;
     /** Called when submitApi rejects or throws. */
-    onError?: (error: unknown) => void;
+    onError?: ((error: unknown) => void) | undefined;
 }
 /** Return value of the `useLoginEntryForm` hook, providing form state and mode info. */
 export interface UseLoginEntryFormReturn {

package/dist/types/{otp-verification.d.ts → pages/otp-verification.d.ts}

@@ -1,6 +1,6 @@
 import { UseFormReturn } from 'react-hook-form';
 import { z } from 'zod';
-import { OtpVerificationMode, otpFormSchema } from '../validations';
+import { OtpVerificationMode, otpFormSchema } from '../../validations';
 export type { OtpVerificationMode };
 /** Form values for the OTP verification form, inferred from the Zod schema. */
 export type OtpFormValues = z.infer<typeof otpFormSchema>;
@@ -13,11 +13,11 @@ export interface UseOtpVerificationOptions {
     /** Called when the user requests a new OTP code (resend). Ignored when submitApi is provided. */
     onResendCode?: (() => void) | undefined;
     /** When provided, hook runs: validate → submitApi(otp) → onSuccess(). Consumer passes redirect in onSuccess. */
-    submitApi?: (otp: string) => Promise<void>;
+    submitApi?: ((otp: string) => Promise<void>) | undefined;
     /** Called after submitApi resolves (e.g. router.push('/dashboard')). */
-    onSuccess?: () => void;
+    onSuccess?: (() => void) | undefined;
     /** Called when submitApi rejects or throws. */
-    onError?: (error: unknown) => void;
+    onError?: ((error: unknown) => void) | undefined;
 }
 /** Return value of the `useOtpVerification` hook, providing form state and resend controls. */
 export interface UseOtpVerificationReturn {

package/dist/types/{pages.d.ts → pages/pages.d.ts}

@@ -1,5 +1,5 @@
-import { UserType } from './auth-types';
-import { IdentifierType } from './flow';
+import { UserType } from '../auth/auth-types';
+import { IdentifierType } from '../auth/flow';
 import { LoginEntryMode } from './login-form';
 import { UseMainAuthPageHandlersOptions } from './main-login';
 import { OtpVerificationMode } from './otp-verification';
@@ -19,25 +19,25 @@ export interface LoginEntryProps {
      * Sync callback with valid data. Use when parent owns API (e.g. AuthFlow).
      * Ignored when submitApi is provided.
      */
-    onSubmit?: (data: {
+    onSubmit?: ((data: {
         phone?: string;
         email?: string;
-    }) => void;
+    }) => void) | undefined;
     /**
      * Async API call (e.g. send OTP). When provided, hook runs: validate → submitApi(data) → onSuccess().
      * Consumer (e.g. Next.js) can pass redirect in onSuccess.
      */
-    submitApi?: (data: {
+    submitApi?: ((data: {
         phone?: string;
         email?: string;
-    }) => Promise<void>;
+    }) => Promise<void>) | undefined;
     /** Called after submitApi succeeds; receives { mode, recipient } for OTP redirect/recipientDisplay. */
-    onSuccess?: (params: {
+    onSuccess?: ((params: {
         mode: LoginEntryMode;
         recipient: string;
-    }) => void;
+    }) => void) | undefined;
     /** Called when submitApi fails. */
-    onError?: (error: unknown) => void;
+    onError?: ((error: unknown) => void) | undefined;
 }
 /** Props for the full LoginEntryPage (adds optional layout overrides for story/viewport). */
 export interface LoginEntryPageProps extends LoginEntryProps {
@@ -55,23 +55,23 @@ export interface SignupPageProps {
     /** Indian only: which field to collect (phone or email). */
     signupCollectField: IdentifierType;
     /** Foreign only: phone when user entered phone before signup details. */
-    pendingPhone?: string;
+    pendingPhone?: string | undefined;
     /** Sync callback with valid data. Use when parent owns API (e.g. AuthFlow). Ignored when submitApi is provided. */
-    onSubmit?: (data: {
+    onSubmit?: ((data: {
         fullName: string;
         phone?: string;
         email?: string;
-    }) => void;
+    }) => void) | undefined;
     /** Async API (e.g. complete profile). When provided, hook runs: validate → submitApi(data) → onSuccess(). */
-    submitApi?: (data: {
+    submitApi?: ((data: {
         fullName: string;
         phone?: string;
         email?: string;
-    }) => Promise<void>;
+    }) => Promise<void>) | undefined;
     /** Called after submitApi succeeds (e.g. router.push('/otp') or next step). */
-    onSuccess?: () => void;
+    onSuccess?: (() => void) | undefined;
     /** Called when submitApi fails. */
-    onError?: (error: unknown) => void;
+    onError?: ((error: unknown) => void) | undefined;
 }
 /** Props for the full SignupPage (adds optional layout overrides). */
 export interface SignupPageFullProps extends SignupPageProps {
@@ -83,23 +83,23 @@ export interface OtpVerificationProps {
     /** Mode: mobile (phone) or email OTP */
     mode: OtpVerificationMode;
     /** Title override. Default: "6 digit OTP has been sent to your Mobile" | "..." Email */
-    title?: string;
+    title?: string | undefined;
     /** Masked phone (e.g. "+91 9825910X0X") or email (e.g. "j***@gmail.com") */
     recipientDisplay: string;
     /** When true, show instruction line ("Kindly check your Email Inbox."). Used for foreign user flow. */
-    isForeignUser?: boolean;
+    isForeignUser?: boolean | undefined;
     /** Handler when back is clicked */
-    onBack?: () => void;
+    onBack?: (() => void) | undefined;
     /** Sync callback with OTP. Use when parent owns API (e.g. AuthFlow). Ignored when submitApi is provided. */
-    onSubmit?: (otp: string) => void;
+    onSubmit?: ((otp: string) => void) | undefined;
     /** Handler when user requests resend code */
-    onResendCode?: () => void;
+    onResendCode?: (() => void) | undefined;
     /** Async API (e.g. verify OTP). When provided, hook runs: validate → submitApi(otp) → onSuccess(). */
-    submitApi?: (otp: string) => Promise<void>;
+    submitApi?: ((otp: string) => Promise<void>) | undefined;
     /** Called after submitApi succeeds (e.g. router.push('/dashboard')). */
-    onSuccess?: () => void;
+    onSuccess?: (() => void) | undefined;
     /** Called when submitApi fails. */
-    onError?: (error: unknown) => void;
+    onError?: ((error: unknown) => void) | undefined;
 }
 /** Props for the full OtpVerificationPage (adds optional layout overrides). */
 export interface OtpVerificationPageProps extends OtpVerificationProps {
@@ -116,15 +116,15 @@ export interface RepeatLoginProps {
      */
     lastUsedMethod?: string;
     /** Sync handler for primary action. Use when caller owns API (e.g. AuthFlow). Ignored when continueApi is provided. */
-    onContinueWithLastMethod?: () => void;
+    onContinueWithLastMethod?: (() => void) | undefined;
     /** Handler for the secondary action (choose another method). */
-    onUseAnotherMethod?: () => void;
+    onUseAnotherMethod?: (() => void) | undefined;
     /** Async API for continue (e.g. validate session). When provided, hook runs: continueApi() → onSuccess(). */
-    continueApi?: () => Promise<void>;
+    continueApi?: (() => Promise<void>) | undefined;
     /** Called after continueApi succeeds (e.g. router.push('/dashboard')). */
-    onSuccess?: () => void;
+    onSuccess?: (() => void) | undefined;
     /** Called when continueApi fails. */
-    onError?: (error: unknown) => void;
+    onError?: ((error: unknown) => void) | undefined;
 }
 /** Props for the full RepeatLoginPage (adds optional layout overrides). */
 export interface RepeatLoginPageProps extends RepeatLoginProps {

package/dist/types/{repeat-login.d.ts → pages/repeat-login.d.ts}

@@ -6,17 +6,17 @@ export interface UseRepeatLoginOptions {
      * Last used authentication method shown in the primary button label.
      * @default "Mobile"
      */
-    lastUsedMethod?: string;
+    lastUsedMethod?: string | undefined;
     /** Sync handler for primary action. Use when caller owns API (e.g. AuthFlow). Ignored when continueApi is provided. */
-    onContinueWithLastMethod?: () => void;
+    onContinueWithLastMethod?: (() => void) | undefined;
     /** Handler for the secondary action (choose another method). */
-    onUseAnotherMethod?: () => void;
+    onUseAnotherMethod?: (() => void) | undefined;
     /** Async API for continue (e.g. validate session). When provided, hook runs: continueApi() → onSuccess(). */
-    continueApi?: () => Promise<void>;
+    continueApi?: (() => Promise<void>) | undefined;
     /** Called after continueApi succeeds (e.g. router.push('/dashboard')). */
-    onSuccess?: () => void;
+    onSuccess?: (() => void) | undefined;
     /** Called when continueApi fails. */
-    onError?: (error: unknown) => void;
+    onError?: ((error: unknown) => void) | undefined;
 }
 /** Return value of the `useRepeatLogin` hook, providing continue handler and display state. */
 export interface UseRepeatLoginReturn {

package/dist/types/{signup-form.d.ts → pages/signup-form.d.ts}

@@ -1,6 +1,6 @@
 import { UseFormReturn } from 'react-hook-form';
 import { z } from 'zod';
-import { signupEmailFormSchema, signupForeignFormSchema, signupPhoneFormSchema } from '../validations';
+import { signupEmailFormSchema, signupForeignFormSchema, signupPhoneFormSchema } from '../../validations';
 /** Signup mode: phone, email as second field, or foreign (full name + email + phone). */
 export type SignupEntryMode = 'phone' | 'email' | 'foreign';
 /** Form values for phone-based signup, inferred from the Zod schema. */
@@ -21,15 +21,15 @@ export interface UseSignupFormOptions {
     /** Mode: phone, email as second field, or foreign (name + email + phone) */
     mode: SignupEntryMode;
     /** For foreign mode: pre-fill phone when user already entered it. */
-    defaultPhone?: string;
+    defaultPhone?: string | undefined;
     /** Sync callback with valid data. Use when parent owns API (e.g. AuthFlow). Ignored when submitApi is provided. */
     onSubmit?: ((data: SignupSubmitData) => void) | undefined;
     /** When provided, hook runs: validate → submitApi(data) → onSuccess(). Consumer passes redirect in onSuccess. */
-    submitApi?: (data: SignupSubmitData) => Promise<void>;
+    submitApi?: ((data: SignupSubmitData) => Promise<void>) | undefined;
     /** Called after submitApi succeeds (e.g. router.push('/otp') or next step). */
-    onSuccess?: () => void;
+    onSuccess?: (() => void) | undefined;
     /** Called when submitApi rejects or throws. */
-    onError?: (error: unknown) => void;
+    onError?: ((error: unknown) => void) | undefined;
 }
 /** Return value of the `useSignupForm` hook, providing form state and mode flags. */
 export interface UseSignupFormReturn {

package/package.json

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

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

@@ -1,42 +0,0 @@
-import { LoginEntryPageProps, LoginEntryProps } from '../types';
-export type { LoginEntryMode, LoginEntryPageProps, LoginEntryProps, } 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;
-/**
- * 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.d.ts

@@ -1,32 +0,0 @@
-import { MainLoginPageProps } from '../types';
-export type { MainLoginAppleProviderConfig, MainLoginGoogleProviderConfig, MainLoginPageProps, MainLoginPageProvidersConfig, } 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;
-/**
- * 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;

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

@@ -1,45 +0,0 @@
-import { OtpVerificationPageProps, OtpVerificationProps } from '../types';
-export type { OtpVerificationMode, OtpVerificationPageProps, OtpVerificationProps, } 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;
-/**
- * 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.d.ts

@@ -1,49 +0,0 @@
-import { RepeatLoginPageProps, RepeatLoginProps } from '../types';
-export type { RepeatLoginPageProps, RepeatLoginProps } 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;
-/**
- * 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.d.ts

@@ -1,6 +0,0 @@
-import { SignupPageFullProps, SignupPageProps } from '../types';
-export type { SignupEntryMode, SignupPageFullProps, SignupPageProps, } from '../types';
-/** Full signup page with layout wrapper, logo, title, and description. Renders the {@link Signup} form body inside an `AuthLayoutWrapper`. */
-export declare function SignupPage(props: Readonly<SignupPageFullProps>): import("react/jsx-runtime").JSX.Element;
-/** Standalone signup form component (without layout). Use inside a custom layout or when layout is handled externally. */
-export declare function Signup(props: Readonly<SignupPageProps>): import("react/jsx-runtime").JSX.Element;