doct-ui-auth-kit 1.0.13 → 1.0.15

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,109 +1,110 @@
-{
-  "name": "doct-ui-auth-kit",
-  "version": "1.0.13",
-  "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"],
-  "keywords": [
-    "react",
-    "auth",
-    "sdk",
-    "docthub",
-    "login",
-    "signup",
-    "sso",
-    "otp"
-  ],
-  "license": "UNLICENSED",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/docthub/doct-ui-auth-kit"
-  },
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build && tsc -p tsconfig.build.json",
-    "prepublishOnly": "npm run build",
-    "lint": "biome lint .",
-    "preview": "vite preview",
-    "format": "biome format --write .",
-    "lint:biome": "biome lint .",
-    "check": "biome check .",
-    "check:fix": "biome check --write .",
-    "type-check": "tsc --noEmit",
-    "prepare": "husky",
-    "storybook": "storybook dev -p 6006",
-    "build-storybook": "storybook build"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./style.css": "./dist/doct-ui-auth-kit.css",
-    "./pages": {
-      "types": "./dist/pages/index.d.ts",
-      "import": "./dist/pages.js"
-    }
-  },
-  "peerDependencies": {
-    "docthub-core-components": "2.99.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "react-hook-form": "^7.50.0",
-    "react-icons": "^5.5.0",
-    "zod": "^4.0.0"
-  },
-  "dependencies": {
-    "clsx": "^2.1.1",
-    "dayjs": "^1.11.19",
-    "docthub-core-components": "2.99.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "react-hook-form": "^7.50.0",
-    "react-icons": "^5.5.0",
-    "react-phone-number-input": "^3.4.14",
-    "react-router-dom": "^7.13.0",
-    "zod": "^4.0.0"
-  },
-  "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",
-    "@storybook/addon-docs": "^10.2.6",
-    "@storybook/addon-onboarding": "^10.2.6",
-    "@storybook/addon-vitest": "^10.2.6",
-    "@storybook/react-vite": "^10.2.6",
-    "@types/node": "^24.10.1",
-    "@types/react": "^19.2.5",
-    "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^5.1.1",
-    "@vitest/browser-playwright": "^4.0.18",
-    "@vitest/coverage-v8": "^4.0.18",
-    "autoprefixer": "^10.4.24",
-    "babel-plugin-react-compiler": "^1.0.0",
-    "eslint": "^9.39.1",
-    "eslint-plugin-react-hooks": "^7.0.1",
-    "eslint-plugin-react-refresh": "^0.4.24",
-    "glob": "^13.0.1",
-    "globals": "^16.5.0",
-    "husky": "^9.1.7",
-    "lint-staged": "^16.2.7",
-    "playwright": "^1.58.1",
-    "postcss": "^8.5.6",
-    "storybook": "^10.2.6",
-    "tailwind-merge": "^3.0.1",
-    "tailwindcss": "^3.4.16",
-    "tailwindcss-animate": "^1.0.7",
-    "typescript": "~5.6.2",
-    "typescript-eslint": "^8.46.4",
-    "vite": "^7.2.4",
-    "vite-plugin-dts": "^4.5.0",
-    "vitest": "^4.0.18"
-  }
-}
+{
+  "name": "doct-ui-auth-kit",
+  "version": "1.0.15",
+  "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"],
+  "keywords": [
+    "react",
+    "auth",
+    "sdk",
+    "docthub",
+    "login",
+    "signup",
+    "sso",
+    "otp"
+  ],
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/docthub/doct-ui-auth-kit"
+  },
+  "scripts": {
+    "dev": "vite",
+    "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",
+    "format": "biome format --write .",
+    "lint:biome": "biome lint .",
+    "check": "biome check .",
+    "check:fix": "biome check --write .",
+    "type-check": "tsc --noEmit",
+    "prepare": "husky",
+    "storybook": "storybook dev -p 6006",
+    "build-storybook": "storybook build"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./style.css": "./dist/doct-ui-auth-kit.css",
+    "./pages": {
+      "types": "./dist/pages/index.d.ts",
+      "import": "./dist/pages.js"
+    }
+  },
+  "peerDependencies": {
+    "docthub-core-components": "2.99.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-hook-form": "^7.50.0",
+    "react-icons": "^5.5.0",
+    "zod": "^4.0.0"
+  },
+  "dependencies": {
+    "clsx": "^2.1.1",
+    "dayjs": "^1.11.19",
+    "docthub-core-components": "2.99.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-hook-form": "^7.50.0",
+    "react-icons": "^5.5.0",
+    "react-phone-number-input": "^3.4.14",
+    "react-router-dom": "^7.13.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.14",
+    "@chromatic-com/storybook": "^5.0.0",
+    "@eslint/js": "^9.39.1",
+    "@storybook/addon-a11y": "^10.2.6",
+    "@storybook/addon-docs": "^10.2.6",
+    "@storybook/addon-onboarding": "^10.2.6",
+    "@storybook/addon-vitest": "^10.2.6",
+    "@storybook/react-vite": "^10.2.6",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.5",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.1",
+    "@vitest/browser-playwright": "^4.0.18",
+    "@vitest/coverage-v8": "^4.0.18",
+    "autoprefixer": "^10.4.24",
+    "babel-plugin-react-compiler": "^1.0.0",
+    "eslint": "^9.39.1",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.4.24",
+    "glob": "^13.0.1",
+    "globals": "^16.5.0",
+    "husky": "^9.1.7",
+    "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",
+    "vite-plugin-dts": "^4.5.0",
+    "vitest": "^4.0.18"
+  }
+}