doct-ui-auth-kit 1.0.7 → 1.0.9

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

@@ -1,40 +0,0 @@
-import { UseFormReturn } from 'react-hook-form';
-import { z } from 'zod';
-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>;
-/** 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>;
-    /** Called after submitApi resolves (e.g. router.push('/dashboard')). */
-    onSuccess?: () => void;
-    /** Called when submitApi rejects or throws. */
-    onError?: (error: unknown) => void;
-}
-/** 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.d.ts

@@ -1,133 +0,0 @@
-import { UserType } from './auth-types';
-import { IdentifierType } from './flow';
-import { LoginEntryMode } from './login-form';
-import { UseMainAuthPageHandlersOptions } from './main-login';
-import { 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;
-    }) => void;
-    /**
-     * 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;
-    }) => Promise<void>;
-    /** Called after submitApi succeeds; receives { mode, recipient } for OTP redirect/recipientDisplay. */
-    onSuccess?: (params: {
-        mode: LoginEntryMode;
-        recipient: string;
-    }) => void;
-    /** Called when submitApi fails. */
-    onError?: (error: unknown) => void;
-}
-/** 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;
-    /** 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;
-    }) => void;
-    /** Async API (e.g. complete profile). When provided, hook runs: validate → submitApi(data) → onSuccess(). */
-    submitApi?: (data: {
-        fullName: string;
-        phone?: string;
-        email?: string;
-    }) => Promise<void>;
-    /** Called after submitApi succeeds (e.g. router.push('/otp') or next step). */
-    onSuccess?: () => void;
-    /** Called when submitApi fails. */
-    onError?: (error: unknown) => void;
-}
-/** 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;
-    /** 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;
-    /** Handler when back is clicked */
-    onBack?: () => void;
-    /** Sync callback with OTP. Use when parent owns API (e.g. AuthFlow). Ignored when submitApi is provided. */
-    onSubmit?: (otp: string) => void;
-    /** Handler when user requests resend code */
-    onResendCode?: () => void;
-    /** Async API (e.g. verify OTP). When provided, hook runs: validate → submitApi(otp) → onSuccess(). */
-    submitApi?: (otp: string) => Promise<void>;
-    /** Called after submitApi succeeds (e.g. router.push('/dashboard')). */
-    onSuccess?: () => void;
-    /** Called when submitApi fails. */
-    onError?: (error: unknown) => void;
-}
-/** 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;
-    /** Handler for the secondary action (choose another method). */
-    onUseAnotherMethod?: () => void;
-    /** Async API for continue (e.g. validate session). When provided, hook runs: continueApi() → onSuccess(). */
-    continueApi?: () => Promise<void>;
-    /** Called after continueApi succeeds (e.g. router.push('/dashboard')). */
-    onSuccess?: () => void;
-    /** Called when continueApi fails. */
-    onError?: (error: unknown) => void;
-}
-/** Props for the full RepeatLoginPage (adds optional layout overrides). */
-export interface RepeatLoginPageProps extends RepeatLoginProps {
-    layoutType?: 'withSlider' | 'standalone';
-    variant?: 'desktop' | 'mobile';
-}

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

@@ -1,29 +0,0 @@
-/**
- * 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;
-    /** Sync handler for primary action. Use when caller owns API (e.g. AuthFlow). Ignored when continueApi is provided. */
-    onContinueWithLastMethod?: () => void;
-    /** Handler for the secondary action (choose another method). */
-    onUseAnotherMethod?: () => void;
-    /** Async API for continue (e.g. validate session). When provided, hook runs: continueApi() → onSuccess(). */
-    continueApi?: () => Promise<void>;
-    /** Called after continueApi succeeds (e.g. router.push('/dashboard')). */
-    onSuccess?: () => void;
-    /** Called when continueApi fails. */
-    onError?: (error: unknown) => void;
-}
-/** 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/signup-form.d.ts

@@ -1,48 +0,0 @@
-import { UseFormReturn } from 'react-hook-form';
-import { z } from 'zod';
-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. */
-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;
-};
-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;
-    /** 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>;
-    /** Called after submitApi succeeds (e.g. router.push('/otp') or next step). */
-    onSuccess?: () => void;
-    /** Called when submitApi rejects or throws. */
-    onError?: (error: unknown) => void;
-}
-/** 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/types/sso-session.d.ts

@@ -1,33 +0,0 @@
-/**
- * SSO session and token storage types.
- */
-/** How/where the SSO token is stored for cross-app access. */
-export interface TokenStorageStrategy {
-    get(): string | null;
-    set(token: string, expiresAt: number): void;
-    remove(): void;
-}
-/** Minimal request config type for the interceptor (no axios import). */
-export interface AxiosRequestConfig {
-    headers?: Record<string, string> | {
-        [key: string]: string;
-    };
-    withCredentials?: boolean;
-}
-/**
- * Axios instance shape needed to attach auth interceptors (avoids hard axios dependency).
- * Use createAxiosAuthInterceptors with your axios instance.
- */
-export interface AxiosAuthInterceptorInstance {
-    interceptors: {
-        request: {
-            use(onFulfilled?: (config: AxiosRequestConfig) => AxiosRequestConfig | Promise<AxiosRequestConfig>, onRejected?: (err: unknown) => unknown): number;
-        };
-        response: {
-            use(onFulfilled?: (res: unknown) => unknown, onRejected?: (err: unknown) => unknown): number;
-        };
-    };
-    defaults: {
-        withCredentials?: boolean;
-    };
-}

package/dist/utils/index.d.ts

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

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

@@ -1,11 +0,0 @@
-import { 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

@@ -1,6 +0,0 @@
-/**
- * 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

@@ -1,73 +0,0 @@
-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; national part (after "-") digits only, length between 7 and 15.
- * Matches Storybook/react-hook-form validate: value format "countryCode-nationalNumber" (e.g. "91-9876543210").
- */
-export declare const phoneSchema: z.ZodString;
-/**
- * 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;
-}, 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;
-}, z.core.$strip>;
-export declare const signupSchemas: {
-    readonly phone: z.ZodObject<{
-        fullName: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
-        phone: z.ZodString;
-    }, 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;
-    }, z.core.$strip>;
-};
-/**
- * Phone validation per PRODUCT_PROTOCOLS #2, #5 and edge cases 3–5.
- */
-export declare const loginPhoneFormSchema: z.ZodObject<{
-    phone: z.ZodString;
-}, 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;
-    }, 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>;