doct-ui-auth-kit 1.0.12 → 1.0.14

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

@@ -0,0 +1,57 @@
+import type { ReactNode } from 'react';
+/** Props for the ImageSlider component. */
+export interface ImageSliderProps {
+    /** Array of image URLs to display */
+    images: string[];
+    /** Auto-play interval in milliseconds (0 to disable) */
+    autoPlayInterval?: number;
+    /** Additional className for the root container */
+    className?: string;
+    /** Whether to hide the built-in slider indicators */
+    hideIndicators?: boolean;
+    /** Optional callback fired whenever the active slide changes */
+    onSlideChange?: (index: number) => void;
+    /** Controlled active index (makes component controlled) */
+    activeIndex?: number;
+    /** Callback for manual slide navigation in controlled mode */
+    onNavigate?: (index: number) => void;
+}
+/**
+ * Props for the MainLayout component.
+ * Two-panel auth page: left panel (marketing/slider), right panel (auth content).
+ */
+export interface MainLayoutProps {
+    /** Array of image URLs for the slider */
+    sliderImages?: string[];
+    /** Auto-play interval for slider in milliseconds (0 to disable) */
+    sliderAutoPlayInterval?: number;
+    /** Call-to-action text displayed above the image card. Set to null to hide */
+    ctaText?: ReactNode | null;
+    /** Per-slide title/CTA (overrides ctaText when provided; uses active slide index) */
+    sliderTitles?: (ReactNode | string)[] | undefined;
+    /** Additional className for the root container */
+    className?: string;
+    /** Additional className for the marketing panel (left side) */
+    marketingClassName?: string;
+    /** Additional className for the content panel (right side) */
+    contentClassName?: string;
+    /** Main authentication content (typically AuthLayout.Root with slots) */
+    children: ReactNode;
+}
+/** Props for the MarketingPanel component (left side). */
+export interface MarketingPanelProps {
+    /** Array of image URLs for the slider */
+    sliderImages: string[];
+    /** Auto-play interval for slider in milliseconds */
+    sliderAutoPlayInterval: number;
+    /** Active slide index (controlled) */
+    activeSlideIndex: number;
+    /** Callback when slide changes */
+    onSlideChange: (index: number) => void;
+    /** Call-to-action text */
+    ctaText?: ReactNode | null;
+    /** Per-slide title/CTA (overrides ctaText when provided) */
+    sliderTitles?: (ReactNode | string)[] | undefined;
+    /** Additional className */
+    className?: string;
+}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Central export for all types and interfaces.
+ * Organized by domain: auth (SSO), components (props), pages (page-specific).
+ */
+export * from './auth';
+export * from './components';
+export * from './pages';

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

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

package/dist/types/pages/login-form.d.ts

@@ -0,0 +1,57 @@
+import type { UseFormReturn } from 'react-hook-form';
+import type { z } from 'zod';
+import type { 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. */
+export type PhoneFormValues = z.infer<typeof loginPhoneFormSchema>;
+/** Form values for email-based login, inferred from the Zod schema. */
+export type EmailFormValues = z.infer<typeof loginEmailFormSchema>;
+/** Discriminated union of phone or email login form values. */
+export type LoginEntryFormValues = PhoneFormValues | EmailFormValues;
+/** Payload when login entry form is valid (phone or email). */
+export type LoginEntrySubmitData = {
+    phone?: string;
+    email?: string;
+    countryCode?: string;
+};
+/**
+ * Params passed to onSuccess after submitApi resolves.
+ * Lets the consumer redirect to OTP with mode and recipient (for recipientDisplay) without storing them in refs.
+ */
+export interface LoginEntrySuccessParams {
+    /** Current login entry mode (phone or email). */
+    mode: LoginEntryMode;
+    /** Submitted phone or email string; use for OTP page recipientDisplay or verify API. */
+    recipient: string;
+}
+export interface UseLoginEntryFormOptions {
+    mode: LoginEntryMode;
+    /**
+     * Sync callback with valid form data. Used when parent owns API (e.g. AuthFlow passes actions.submitIdentifier).
+     * Ignored when submitApi is provided.
+     */
+    onSubmit?: ((data: LoginEntrySubmitData) => void) | undefined;
+    /**
+     * 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>) | undefined;
+    /** Called after submitApi resolves successfully; receives mode and recipient for OTP redirect/display. */
+    onSuccess?: ((params: LoginEntrySuccessParams) => void) | undefined;
+    /** Called when submitApi rejects or throws. */
+    onError?: ((error: unknown) => void) | undefined;
+}
+/** Return value of the `useLoginEntryForm` hook, providing form state and mode info. */
+export interface UseLoginEntryFormReturn {
+    /** react-hook-form methods bound to the current login mode's schema. */
+    methods: UseFormReturn<LoginEntryFormValues>;
+    /** Submit handler to pass to the form's `onSubmit`. Validates and dispatches the login data. */
+    handleSubmit: (data: LoginEntryFormValues) => void;
+    /** True when the current mode is `'phone'`; use for conditional field rendering. */
+    isPhone: boolean;
+    /** True when current form values pass validation (for disabling Continue until valid – edge cases 3, 4). */
+    isFormValid: (data: LoginEntryFormValues) => boolean;
+    /** True while submitApi is in flight. Use to disable Continue button and show loading. */
+    isSubmitting: boolean;
+}

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

@@ -0,0 +1,51 @@
+/** Handlers exposed by the main auth page (method select). */
+export interface MainAuthPageHandlers {
+    /** Called when the user selects "Continue with Mobile". */
+    onContinueWithMobile: () => void;
+    /** Called when the user selects "Continue with Email". */
+    onContinueWithEmail: () => void;
+    /** Called when the user selects "Continue with Google". */
+    onContinueWithGoogle: () => void;
+    /** Called when the user selects "Continue with Apple". */
+    onContinueWithApple: () => void;
+}
+/** Config for lib-handled Google sign-in. When set, the lib runs the OAuth flow and calls onCredential. */
+export interface MainLoginGoogleProviderConfig {
+    /** Google OAuth 2.0 client ID. */
+    clientId: string;
+    /** Called with ID token (One Tap) or auth code (button popup). Send to your backend to verify. */
+    onCredential: (credential: string) => void;
+    /** Enable Google One Tap prompt for automatic sign-in. */
+    enableOneTap?: boolean;
+}
+/** Config for lib-handled Apple sign-in (stub). When set, the lib will run the flow and call onCredential when implemented. */
+export interface MainLoginAppleProviderConfig {
+    /** Apple Services ID (client ID) configured in the Apple Developer portal. */
+    clientId: string;
+    /** OAuth redirect URI registered with Apple for the sign-in flow. */
+    redirectUri: string;
+    /** Called with the Apple identity token after a successful sign-in. Send to your backend to verify. */
+    onCredential: (credential: string) => void;
+}
+/** Optional provider config so the lib handles Google/Apple API calls. */
+export interface MainLoginPageProvidersConfig {
+    /** Google sign-in configuration. When set, the lib handles the Google OAuth flow. */
+    google?: MainLoginGoogleProviderConfig;
+    /** Apple sign-in configuration. When set, the lib handles the Apple OAuth flow. */
+    apple?: MainLoginAppleProviderConfig;
+}
+/** Options for useMainAuthPageHandlers: optional callback overrides + optional provider config for lib-handled OAuth. */
+export type UseMainAuthPageHandlersOptions = Partial<MainAuthPageHandlers> & {
+    providers?: MainLoginPageProvidersConfig;
+    /**
+     * Custom handler for the "Enterprise Login" header CTA. When omitted,
+     * the header redirects to the default enterprise URL
+     * (`DEFAULT_ENTERPRISE_LOGIN_URL`).
+     */
+    onEnterpriseLogin?: () => void;
+    /**
+     * Override the default enterprise redirect URL. Ignored when
+     * `onEnterpriseLogin` is provided. Defaults to `https://docthub.com/`.
+     */
+    enterpriseLoginUrl?: string;
+};

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

@@ -0,0 +1,53 @@
+import type { UseFormReturn } from 'react-hook-form';
+import type { z } from 'zod';
+import type { 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>;
+/**
+ * Consumer-provided custom validator for OTP. Runs after the built-in
+ * 6-digit check passes. Return `true` to accept, or a string message to
+ * surface as the field error (and block submission). May be async so
+ * callers can hit a backend pre-check before the full verify call.
+ */
+export type OtpValidateFn = (otp: string) => string | true | Promise<string | true>;
+/** Options for the `useOtpVerification` hook controlling mode, submission, and callbacks. */
+export interface UseOtpVerificationOptions {
+    /** OTP mode: phone (60s cooldown) or email (2 min cooldown). */
+    mode: OtpVerificationMode;
+    /** Sync callback with OTP string. Use when parent owns API (e.g. AuthFlow). Ignored when submitApi is provided. */
+    onSubmit?: ((otp: string) => void) | undefined;
+    /** 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>) | undefined;
+    /** Called after submitApi resolves (e.g. router.push('/dashboard')). */
+    onSuccess?: (() => void) | undefined;
+    /** Called when submitApi rejects or throws. */
+    onError?: ((error: unknown) => void) | undefined;
+    /**
+     * Optional custom OTP validator. Runs after the built-in digit check.
+     * Return `true` to accept, or a string to surface as the field error
+     * and block submission.
+     */
+    validate?: OtpValidateFn | undefined;
+}
+/** Return value of the `useOtpVerification` hook, providing form state and resend controls. */
+export interface UseOtpVerificationReturn {
+    /** react-hook-form methods bound to the OTP form. */
+    methods: UseFormReturn<OtpFormValues>;
+    /** Submit handler to pass to the form's `onSubmit`. Validates and dispatches the OTP. */
+    handleSubmit: (data: OtpFormValues) => void;
+    /** True when current form values pass validation (for disabling Submit until valid – edge case 6). */
+    isFormValid: (data: OtpFormValues) => boolean;
+    /** Triggers a resend of the OTP code and resets the cooldown timer. */
+    handleResend: () => void;
+    /** Seconds remaining before the user can request another OTP code. */
+    resendSecondsLeft: number;
+    /** True when the resend cooldown has elapsed and the user may request a new code. */
+    canResend: boolean;
+    /** Human-readable countdown string (e.g. `"00:45"`) for display next to the resend button. */
+    timerText: string;
+    /** True while submitApi is in flight. */
+    isSubmitting: boolean;
+}

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

@@ -0,0 +1,146 @@
+/**
+ * Props and public types for auth page components.
+ */
+import type { UserType } from '../auth/auth-types';
+import type { IdentifierType } from '../auth/flow';
+import type { LoginEntryMode } from './login-form';
+import type { UseMainAuthPageHandlersOptions } from './main-login';
+import type { OtpValidateFn, OtpVerificationMode } from './otp-verification';
+/** Props for MainLoginPage and MainLogin components. */
+export type MainLoginPageProps = UseMainAuthPageHandlersOptions;
+/** Props for LoginEntry (inner form without layout). */
+export interface LoginEntryProps {
+    /** Mode: phone number or email input */
+    mode: LoginEntryMode;
+    /** Override title (consumers render via AuthLayout.Title) */
+    title?: string;
+    /** Override subtitle (consumers render via AuthLayout.Description) */
+    subtitle?: string;
+    /** Handler when back button is clicked (consumers render back button in AuthLayout.Logo) */
+    onBack?: () => void;
+    /**
+     * Sync callback with valid data. Use when parent owns API (e.g. AuthFlow).
+     * Ignored when submitApi is provided.
+     */
+    onSubmit?: ((data: {
+        phone?: string;
+        email?: string;
+        countryCode?: string;
+    }) => 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: {
+        phone?: string;
+        email?: string;
+        countryCode?: string;
+    }) => Promise<void>) | undefined;
+    /** Called after submitApi succeeds; receives { mode, recipient } for OTP redirect/recipientDisplay. */
+    onSuccess?: ((params: {
+        mode: LoginEntryMode;
+        recipient: string;
+    }) => void) | undefined;
+    /** Called when submitApi fails. */
+    onError?: ((error: unknown) => void) | undefined;
+}
+/** Props for the full LoginEntryPage (adds optional layout overrides for story/viewport). */
+export interface LoginEntryPageProps extends LoginEntryProps {
+    /** Layout type. Default: 'withSlider' for desktop, use 'standalone' for mobile. */
+    layoutType?: 'withSlider' | 'standalone';
+    /** Layout variant. Default derived from layoutType if not set. */
+    variant?: 'desktop' | 'mobile';
+}
+/** Props for Signup (inner form without layout). */
+export interface SignupPageProps {
+    /** Indian: which field to collect. Foreign: use 'foreign' mode (name + email + phone). */
+    userType: UserType;
+    /** How user started (phone or email). */
+    loginMethod: IdentifierType;
+    /** Indian only: which field to collect (phone or email). */
+    signupCollectField: IdentifierType;
+    /** Foreign only: phone when user entered phone before signup details. */
+    pendingPhone?: string | undefined;
+    /** Sync callback with valid data. Use when parent owns API (e.g. AuthFlow). Ignored when submitApi is provided. */
+    onSubmit?: ((data: {
+        fullName: string;
+        phone?: string;
+        email?: string;
+        countryCode?: string;
+    }) => void) | undefined;
+    /** Async API (e.g. complete profile). When provided, hook runs: validate → submitApi(data) → onSuccess(). */
+    submitApi?: ((data: {
+        fullName: string;
+        phone?: string;
+        email?: string;
+        countryCode?: string;
+    }) => Promise<void>) | undefined;
+    /** Called after submitApi succeeds (e.g. router.push('/otp') or next step). */
+    onSuccess?: (() => void) | undefined;
+    /** Called when submitApi fails. */
+    onError?: ((error: unknown) => void) | undefined;
+}
+/** Props for the full SignupPage (adds optional layout overrides). */
+export interface SignupPageFullProps extends SignupPageProps {
+    layoutType?: 'withSlider' | 'standalone';
+    variant?: 'desktop' | 'mobile';
+}
+/** Props for OtpVerification (inner form without layout). */
+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 | 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 | undefined;
+    /** Handler when back is clicked */
+    onBack?: (() => void) | undefined;
+    /** Sync callback with OTP. Use when parent owns API (e.g. AuthFlow). Ignored when submitApi is provided. */
+    onSubmit?: ((otp: string) => void) | undefined;
+    /** Handler when user requests resend code */
+    onResendCode?: (() => void) | undefined;
+    /** Async API (e.g. verify OTP). When provided, hook runs: validate → submitApi(otp) → onSuccess(). */
+    submitApi?: ((otp: string) => Promise<void>) | undefined;
+    /** Called after submitApi succeeds (e.g. router.push('/dashboard')). */
+    onSuccess?: (() => void) | undefined;
+    /** Called when submitApi fails. */
+    onError?: ((error: unknown) => void) | undefined;
+    /**
+     * Optional custom OTP validator. Runs after the built-in 6-digit
+     * check; return `true` to accept or a string message to display as
+     * the field error (and block submission).
+     */
+    validate?: OtpValidateFn | undefined;
+}
+/** Props for the full OtpVerificationPage (adds optional layout overrides). */
+export interface OtpVerificationPageProps extends OtpVerificationProps {
+    layoutType?: 'withSlider' | 'standalone';
+    variant?: 'desktop' | 'mobile';
+}
+/** Props for RepeatLogin (inner component without layout). */
+export interface RepeatLoginProps {
+    /**
+     * Last used authentication method shown in the primary button label.
+     * Example: "Mobile", "Email".
+     *
+     * @default "Mobile"
+     */
+    lastUsedMethod?: string;
+    /** Sync handler for primary action. Use when caller owns API (e.g. AuthFlow). Ignored when continueApi is provided. */
+    onContinueWithLastMethod?: (() => void) | undefined;
+    /** Handler for the secondary action (choose another method). */
+    onUseAnotherMethod?: (() => void) | undefined;
+    /** Async API for continue (e.g. validate session). When provided, hook runs: continueApi() → onSuccess(). */
+    continueApi?: (() => Promise<void>) | undefined;
+    /** Called after continueApi succeeds (e.g. router.push('/dashboard')). */
+    onSuccess?: (() => void) | undefined;
+    /** Called when continueApi fails. */
+    onError?: ((error: unknown) => void) | undefined;
+}
+/** Props for the full RepeatLoginPage (adds optional layout overrides). */
+export interface RepeatLoginPageProps extends RepeatLoginProps {
+    layoutType?: 'withSlider' | 'standalone';
+    variant?: 'desktop' | 'mobile';
+}

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

@@ -0,0 +1,29 @@
+/**
+ * Hook options and return type for repeat login (continue with last method).
+ */
+export interface UseRepeatLoginOptions {
+    /**
+     * Last used authentication method shown in the primary button label.
+     * @default "Mobile"
+     */
+    lastUsedMethod?: string | undefined;
+    /** Sync handler for primary action. Use when caller owns API (e.g. AuthFlow). Ignored when continueApi is provided. */
+    onContinueWithLastMethod?: (() => void) | undefined;
+    /** Handler for the secondary action (choose another method). */
+    onUseAnotherMethod?: (() => void) | undefined;
+    /** Async API for continue (e.g. validate session). When provided, hook runs: continueApi() → onSuccess(). */
+    continueApi?: (() => Promise<void>) | undefined;
+    /** Called after continueApi succeeds (e.g. router.push('/dashboard')). */
+    onSuccess?: (() => void) | undefined;
+    /** Called when continueApi fails. */
+    onError?: ((error: unknown) => void) | undefined;
+}
+/** Return value of the `useRepeatLogin` hook, providing continue handler and display state. */
+export interface UseRepeatLoginReturn {
+    /** Call this when the user clicks "Continue with {lastUsedMethod}". */
+    handleContinue: () => void;
+    /** True while continueApi is in flight. */
+    isSubmitting: boolean;
+    /** Resolved lastUsedMethod for display (default "Mobile"). */
+    lastUsedMethod: string;
+}

package/dist/types/pages/signup-form.d.ts

@@ -0,0 +1,49 @@
+import type { UseFormReturn } from 'react-hook-form';
+import type { z } from 'zod';
+import type { 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. */
+export type SignupPhoneFormValues = z.infer<typeof signupPhoneFormSchema>;
+/** Form values for email-based signup, inferred from the Zod schema. */
+export type SignupEmailFormValues = z.infer<typeof signupEmailFormSchema>;
+/** Form values for foreign signup (full name + email + phone), inferred from the Zod schema. */
+export type SignupForeignFormValues = z.infer<typeof signupForeignFormSchema>;
+/** Discriminated union of all signup form value shapes. */
+export type SignupFormValues = SignupPhoneFormValues | SignupEmailFormValues | SignupForeignFormValues;
+/** Payload when signup form is valid. */
+export type SignupSubmitData = {
+    fullName: string;
+    phone?: string;
+    email?: string;
+    countryCode?: string;
+};
+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 | 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>) | undefined;
+    /** Called after submitApi succeeds (e.g. router.push('/otp') or next step). */
+    onSuccess?: (() => void) | undefined;
+    /** Called when submitApi rejects or throws. */
+    onError?: ((error: unknown) => void) | undefined;
+}
+/** Return value of the `useSignupForm` hook, providing form state and mode flags. */
+export interface UseSignupFormReturn {
+    /** react-hook-form methods bound to the current signup mode's schema. */
+    methods: UseFormReturn<SignupFormValues>;
+    /** Submit handler to pass to the form's `onSubmit`. Validates and dispatches signup data. */
+    handleSubmit: (data: SignupFormValues) => void;
+    /** True when mode is 'phone', false when mode is 'email'. For 'foreign' same as (mode === 'phone') for layout. */
+    isPhone: boolean;
+    /** True when mode is 'foreign' (full name + email + phone). */
+    isForeign: boolean;
+    /** True when current form values pass validation (for disabling Continue – edge cases 9, 16, 19). */
+    isFormValid: (data: SignupFormValues) => boolean;
+    /** True while submitApi is in flight. */
+    isSubmitting: boolean;
+}

package/dist/utils/build-phone-recipient.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Normalize a phone + country code pair into a single E.164-style string.
+ *
+ * Rules (shared by login-entry submission and the SSO flow's identifier /
+ * signup-details handlers):
+ * - Trim the phone value.
+ * - Empty phone → `''`.
+ * - Phone already starting with `+` → return as-is (caller-supplied E.164).
+ * - Otherwise: strip non-digits from the country code; prefix `+{cc}{phone}`
+ *   if a country code is present, else return the bare phone digits.
+ */
+export declare function buildPhoneRecipient(phone?: string, countryCode?: string): string;

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Reusable utilities used in 2+ places across the auth SDK.
+ */
+export { buildPhoneRecipient } from './build-phone-recipient';
+export { setFormErrorsFromZod } from './set-form-errors-from-zod';

package/dist/utils/set-form-errors-from-zod.d.ts

@@ -0,0 +1,11 @@
+import type { ZodError } from 'zod';
+/**
+ * Applies Zod validation errors to a React Hook Form setError function.
+ * Used by form submit handlers to display field-level errors from schema validation.
+ *
+ * @param error - The ZodError from schema.safeParse when validation fails
+ * @param setError - RHF's setError (e.g. methods.setError)
+ */
+export declare function setFormErrorsFromZod(error: ZodError, setError: (path: string, opts: {
+    message: string;
+}) => void): void;

package/dist/validations/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Central export for all validation schemas and helpers.
+ * Import from here: import { signupSchemas, loginSchemas, otpFormSchema } from '../validations';
+ */
+export type { OtpVerificationMode } from './schemas';
+export { capitalizeWords, emailSchema, fullNameSchema, getResendCooldownSeconds, loginEmailFormSchema, loginPhoneFormSchema, loginSchemas, OTP_LENGTH, otpFormSchema, phoneSchema, RESEND_COOLDOWN_EMAIL_SECONDS, RESEND_COOLDOWN_PHONE_SECONDS, signupEmailFormSchema, signupForeignFormSchema, signupPhoneFormSchema, signupSchemas, } from './schemas';

package/dist/validations/schemas.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Centralized Zod schemas for auth forms (signup, login, OTP).
+ * Single source of truth for all validation rules per PRODUCT_PROTOCOLS.
+ * Schemas are consumed by hooks (not components) to enforce clean layer separation.
+ * Future SSO API validation (e.g. server-side field constraints) can extend these schemas.
+ */
+import { z } from 'zod';
+/** Capitalize first letter of each word (PRODUCT_PROTOCOLS #25 – Naming conventions). */
+export declare function capitalizeWords(value: string): string;
+/**
+ * Full name: required, min 3 chars, trim, capitalize each word (Protocol #1, #25; Edge case 9).
+ */
+export declare const fullNameSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+/**
+ * Phone: required; accepts both legacy "countryCode-number" and direct numeric input.
+ * Valid when the normalized phone digits length is between 7 and 15.
+ */
+export declare const phoneSchema: z.ZodString;
+/** Optional country calling code, normalized to digits (e.g. `91`). */
+export declare const countryCodeSchema: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+/**
+ * Email: required, valid format, trim and lowercase before save (Edge case 10).
+ */
+export declare const emailSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+export declare const signupPhoneFormSchema: z.ZodObject<{
+    fullName: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    phone: z.ZodString;
+    countryCode: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+}, z.core.$strip>;
+export declare const signupEmailFormSchema: z.ZodObject<{
+    fullName: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    email: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export declare const signupForeignFormSchema: z.ZodObject<{
+    fullName: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    email: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    phone: z.ZodString;
+    countryCode: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+}, z.core.$strip>;
+export declare const signupSchemas: {
+    readonly phone: z.ZodObject<{
+        fullName: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        phone: z.ZodString;
+        countryCode: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    }, z.core.$strip>;
+    readonly email: z.ZodObject<{
+        fullName: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        email: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    }, z.core.$strip>;
+    readonly foreign: z.ZodObject<{
+        fullName: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        email: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        phone: z.ZodString;
+        countryCode: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    }, z.core.$strip>;
+};
+/**
+ * Phone validation per PRODUCT_PROTOCOLS #2, #5 and edge cases 3–5.
+ */
+export declare const loginPhoneFormSchema: z.ZodObject<{
+    phone: z.ZodString;
+    countryCode: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+}, z.core.$strip>;
+/**
+ * Email validation: trim and lowercase per edge case 10.
+ */
+export declare const loginEmailFormSchema: z.ZodObject<{
+    email: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+}, z.core.$strip>;
+export declare const loginSchemas: {
+    readonly phone: z.ZodObject<{
+        phone: z.ZodString;
+        countryCode: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    }, z.core.$strip>;
+    readonly email: z.ZodObject<{
+        email: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    }, z.core.$strip>;
+};
+export declare const OTP_LENGTH = 6;
+/** Resend cooldown: 60s for phone OTP, 2 min for email OTP (per design). */
+export declare const RESEND_COOLDOWN_PHONE_SECONDS = 60;
+export declare const RESEND_COOLDOWN_EMAIL_SECONDS = 120;
+export type OtpVerificationMode = 'phone' | 'email';
+export declare function getResendCooldownSeconds(mode: OtpVerificationMode): number;
+export declare const otpFormSchema: z.ZodObject<{
+    otp: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "doct-ui-auth-kit",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Composable React auth SDK – layouts, login/signup/OTP pages, SSO provider, and auth flow hooks for Docthub",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "files": ["dist", "README.md"],
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "keywords": [
     "react",
     "auth",
@@ -24,7 +27,7 @@
   },
   "scripts": {
     "dev": "vite",
-    "build": "vite build && tsc -p tsconfig.build.json",
+    "build": "vite build && tsc --build tsconfig.build.json --force && tsc-alias -p tsconfig.build.json",
     "prepublishOnly": "npm run build",
     "lint": "biome lint .",
     "preview": "vite preview",
@@ -70,8 +73,6 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.14",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
     "@chromatic-com/storybook": "^5.0.0",
     "@eslint/js": "^9.39.1",
     "@storybook/addon-a11y": "^10.2.6",
@@ -96,10 +97,13 @@
     "lint-staged": "^16.2.7",
     "playwright": "^1.58.1",
     "postcss": "^8.5.6",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
     "storybook": "^10.2.6",
     "tailwind-merge": "^3.0.1",
     "tailwindcss": "^3.4.16",
     "tailwindcss-animate": "^1.0.7",
+    "tsc-alias": "^1.8.17",
     "typescript": "~5.6.2",
     "typescript-eslint": "^8.46.4",
     "vite": "^7.2.4",