@saxenapackages/auth-sdk 1.0.0

package/dist/provider/AuthContext.d.ts

@@ -0,0 +1,24 @@
+import { User } from '../types/auth';
+import { AuthSdkConfig } from '../types/config';
+import { AuthApi } from '../api/authApi';
+export interface AuthContextProps {
+    user: User | null;
+    token: string | null;
+    refreshToken: string | null;
+    isAuthenticated: boolean;
+    loading: boolean;
+    login: (payload: Record<string, any>) => Promise<any>;
+    logout: () => Promise<void>;
+    signup: (payload: Record<string, any>) => Promise<any>;
+    verifyOtp: (payload: Record<string, any>, urlParams?: Record<string, string | number>) => Promise<any>;
+    verifyIdentity: (payload: Record<string, any>, urlParams?: Record<string, string | number>) => Promise<any>;
+    resetPassword: (payload: Record<string, any>, urlParams?: Record<string, string | number>) => Promise<any>;
+    refresh: () => Promise<string | null>;
+    getUserProfile: (site?: string, id?: string) => Promise<any>;
+    updateUser: (payload: Record<string, any>, site?: string, id?: string) => Promise<any>;
+    deleteUser: (site?: string, id?: string) => Promise<any>;
+    config: AuthSdkConfig;
+    authApi: AuthApi | null;
+}
+export declare const AuthContext: import('react').Context<AuthContextProps | undefined>;
+export default AuthContext;

package/dist/provider/AuthProvider.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+import { AuthSdkConfig } from '../types/config';
+interface AuthProviderProps {
+    children: React.ReactNode;
+    config: AuthSdkConfig;
+}
+export declare const AuthProvider: React.FC<AuthProviderProps>;
+export {};

package/dist/services/event.service.d.ts

@@ -0,0 +1,9 @@
+import { AuthEvent, AuthEventCallback } from '../types/auth';
+declare class EventService {
+    private listeners;
+    on(event: AuthEvent, callback: AuthEventCallback): void;
+    off(event: AuthEvent, callback: AuthEventCallback): void;
+    emit(event: AuthEvent, data?: any): void;
+}
+export declare const eventService: EventService;
+export default eventService;

package/dist/services/storage.service.d.ts

@@ -0,0 +1,10 @@
+import { StorageType } from '../types/config';
+export declare class StorageService {
+    private adapter;
+    constructor(storageType?: StorageType);
+    private resolveAdapter;
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+}

package/dist/services/token.service.d.ts

@@ -0,0 +1,10 @@
+import { StorageService } from './storage.service';
+export declare class TokenService {
+    private storageService;
+    constructor(storageService: StorageService);
+    saveToken(key: string, token: string): Promise<void>;
+    getToken(key: string): Promise<string | null>;
+    removeToken(key: string): Promise<void>;
+    decodeJWT(token: string): any;
+    isExpired(token: string | null): boolean;
+}

package/dist/theme/defaultTheme.d.ts

@@ -0,0 +1,3 @@
+import { CustomTheme } from '../types/config';
+export declare const defaultLightTheme: CustomTheme;
+export declare const defaultDarkTheme: CustomTheme;

package/dist/types/api.d.ts

@@ -0,0 +1,10 @@
+export interface ApiResponse<T = any> {
+    data: T;
+    status: number;
+    message?: string;
+}
+export interface ApiRequestOptions {
+    headers?: Record<string, string>;
+    params?: Record<string, any>;
+    [key: string]: any;
+}

package/dist/types/auth.d.ts

@@ -0,0 +1,28 @@
+import { default as React } from 'react';
+export interface User {
+    id?: string | number;
+    email?: string;
+    name?: string;
+    [key: string]: any;
+}
+export interface TokenSession {
+    token: string | null;
+    refreshToken: string | null;
+    user: User | null;
+}
+export type AuthEvent = 'LOGIN_SUCCESS' | 'LOGIN_FAILED' | 'LOGOUT' | 'TOKEN_EXPIRED' | 'OTP_VERIFIED' | 'PASSWORD_RESET' | 'OTP_SENT';
+export type AuthEventCallback = (data?: any) => void;
+export interface ComponentOverrides {
+    Button?: React.ComponentType<any>;
+    Input?: React.ComponentType<any>;
+    Card?: React.ComponentType<any>;
+    Loader?: React.ComponentType<any>;
+    Checkbox?: React.ComponentType<any>;
+}
+export interface BaseComponentProps {
+    components?: ComponentOverrides;
+    labels?: Record<string, string>;
+    buttonText?: string;
+    placeholders?: Record<string, string>;
+    validationSchema?: any;
+}

package/dist/types/config.d.ts

@@ -0,0 +1,139 @@
+import { z } from 'zod';
+export interface StorageAdapter {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
+    clear(): void | Promise<void>;
+}
+export type StorageType = 'localStorage' | 'sessionStorage' | 'memory' | StorageAdapter;
+export interface EndpointsConfig {
+    login?: string;
+    signup?: string;
+    verifyIdentity?: string;
+    verifyOtp?: string;
+    resetPassword?: string;
+    googleLogin?: string;
+    refreshToken?: string;
+    logout?: string;
+    getUser?: string;
+    updateUser?: string;
+    deleteUser?: string;
+}
+export interface CustomTheme {
+    colors?: {
+        primary?: string;
+        primaryHover?: string;
+        secondary?: string;
+        background?: string;
+        surface?: string;
+        text?: string;
+        textMuted?: string;
+        border?: string;
+        error?: string;
+        success?: string;
+        [key: string]: string | undefined;
+    };
+    fonts?: {
+        body?: string;
+        heading?: string;
+    };
+    borderRadius?: string;
+    borderRadiusCard?: string;
+    borderRadiusButton?: string;
+    borderRadiusInput?: string;
+    spacing?: string;
+    background?: string;
+    logo?: string;
+}
+export type ThemeType = 'light' | 'dark' | CustomTheme;
+export interface CustomizationConfig {
+    labels?: Record<string, string>;
+    buttonText?: Record<string, string>;
+    placeholders?: Record<string, string>;
+    translations?: Record<string, Record<string, string>>;
+    validationSchema?: {
+        login?: z.ZodSchema;
+        signup?: z.ZodSchema;
+        verifyIdentity?: z.ZodSchema;
+        otp?: z.ZodSchema;
+        resetPassword?: z.ZodSchema;
+        updateUser?: z.ZodSchema;
+    };
+}
+export interface AuthSdkConfig {
+    apiBaseUrl: string;
+    site?: string;
+    endpoints?: EndpointsConfig;
+    storage?: StorageType;
+    tokenKey?: string;
+    refreshTokenKey?: string;
+    theme?: ThemeType;
+    headers?: Record<string, string>;
+    responseMapping?: {
+        token?: string;
+        refreshToken?: string;
+        user?: string;
+        [key: string]: string | undefined;
+    };
+    requestMapping?: {
+        login?: {
+            email?: string;
+            password?: string;
+            otp?: string;
+            [key: string]: string | undefined;
+        };
+        signup?: {
+            name?: string;
+            email?: string;
+            password?: string;
+            verifyPassword?: string;
+            [key: string]: string | undefined;
+        };
+        verifyIdentity?: {
+            email?: string;
+            [key: string]: string | undefined;
+        };
+        otp?: {
+            otp?: string;
+            email?: string;
+            token?: string;
+            [key: string]: string | undefined;
+        };
+        resetPassword?: {
+            password?: string;
+            verifyPassword?: string;
+            [key: string]: string | undefined;
+        };
+        updateUser?: {
+            fullName?: string;
+            email?: string;
+            username?: string;
+            phoneNumber?: string;
+            profileUrl?: string;
+            password?: string;
+            city?: string;
+            state?: string;
+            country?: string;
+            postalcode?: string;
+            [key: string]: string | undefined;
+        };
+        [key: string]: Record<string, string | undefined> | undefined;
+    };
+    enableRefreshToken?: boolean;
+    enableGoogleLogin?: boolean;
+    enableOtpLogin?: boolean;
+    autoLogin?: boolean;
+    autoRefresh?: boolean;
+    customization?: CustomizationConfig;
+    isExternalApiCall?: boolean;
+    onLogin?: (payload: Record<string, any>) => Promise<any>;
+    onSignup?: (payload: Record<string, any>) => Promise<any>;
+    onVerifyIdentity?: (payload: Record<string, any>, urlParams?: Record<string, string | number>) => Promise<any>;
+    onVerifyOtp?: (payload: Record<string, any>, urlParams?: Record<string, string | number>) => Promise<any>;
+    onResetPassword?: (payload: Record<string, any>, urlParams?: Record<string, string | number>) => Promise<any>;
+    onUpdateUser?: (payload: Record<string, any>, site?: string, id?: string) => Promise<any>;
+    onDeleteUser?: (site?: string, id?: string) => Promise<any>;
+    onLogout?: () => Promise<void>;
+    onRefresh?: (refreshToken: string) => Promise<any>;
+    onGetUser?: (site?: string, id?: string) => Promise<any>;
+}

package/dist/utils/errors.d.ts

@@ -0,0 +1,7 @@
+export type SdkErrorCode = 'INVALID_CREDENTIALS' | 'OTP_EXPIRED' | 'USER_NOT_FOUND' | 'TOKEN_EXPIRED' | 'SERVER_ERROR' | 'NETWORK_ERROR' | 'UNKNOWN_ERROR';
+export declare class AuthSdkError extends Error {
+    code: SdkErrorCode;
+    originalError?: any;
+    constructor(message: string, code: SdkErrorCode, originalError?: any);
+}
+export declare function normalizeError(error: any): AuthSdkError;

package/dist/utils/helpers.d.ts

@@ -0,0 +1,8 @@
+export declare function decodeJWT(token: string): any;
+export declare function isTokenExpired(token: string | null): boolean;
+export declare function getNestedValue(obj: any, path: string): any;
+export declare function setNestedValue(obj: any, path: string, value: any): any;
+export declare function mapPayload(payload: Record<string, any>, mapping?: Record<string, string>): Record<string, any>;
+export declare function getAccessTokenFromResponse(data: any, mappingPath?: string): string | null;
+export declare function getRefreshTokenFromResponse(data: any, mappingPath?: string): string | null;
+export declare function getUserFromResponse(data: any, mappingPath?: string): any;

package/dist/validation/index.d.ts

@@ -0,0 +1,6 @@
+export { loginSchema, otpEmailSchema, otpSubmitSchema } from './login';
+export { signupSchema } from './signup';
+export { verifyIdentitySchema } from './verifyIdentity';
+export { otpSchema } from './otp';
+export { resetPasswordSchema } from './resetPassword';
+export { updateUserSchema } from './updateUser';

package/dist/validation/login.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+export declare const loginSchema: z.ZodObject<{
+    email: z.ZodString;
+    password: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+    password: string;
+}, {
+    email: string;
+    password: string;
+}>;
+export declare const otpEmailSchema: z.ZodObject<{
+    email: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+}, {
+    email: string;
+}>;
+export declare const otpSubmitSchema: z.ZodObject<{
+    email: z.ZodString;
+    otp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+    otp: string;
+}, {
+    email: string;
+    otp: string;
+}>;

package/dist/validation/otp.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const otpSchema: z.ZodObject<{
+    otp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    otp: string;
+}, {
+    otp: string;
+}>;

package/dist/validation/resetPassword.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export declare const resetPasswordSchema: z.ZodEffects<z.ZodObject<{
+    password: z.ZodString;
+    verifyPassword: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    password: string;
+    verifyPassword: string;
+}, {
+    password: string;
+    verifyPassword: string;
+}>, {
+    password: string;
+    verifyPassword: string;
+}, {
+    password: string;
+    verifyPassword: string;
+}>;

package/dist/validation/signup.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+export declare const signupSchema: z.ZodEffects<z.ZodObject<{
+    name: z.ZodString;
+    email: z.ZodString;
+    password: z.ZodString;
+    verifyPassword: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+    name: string;
+    password: string;
+    verifyPassword: string;
+}, {
+    email: string;
+    name: string;
+    password: string;
+    verifyPassword: string;
+}>, {
+    email: string;
+    name: string;
+    password: string;
+    verifyPassword: string;
+}, {
+    email: string;
+    name: string;
+    password: string;
+    verifyPassword: string;
+}>;

package/dist/validation/updateUser.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+export declare const updateUserSchema: z.ZodObject<{
+    fullName: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    email: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    username: z.ZodOptional<z.ZodString>;
+    phoneNumber: z.ZodOptional<z.ZodString>;
+    password: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    profileUrl: z.ZodUnion<[z.ZodOptional<z.ZodString>, z.ZodLiteral<"">]>;
+    city: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodString>;
+    country: z.ZodOptional<z.ZodString>;
+    postalcode: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    email?: string | undefined;
+    password?: string | undefined;
+    fullName?: string | undefined;
+    username?: string | undefined;
+    phoneNumber?: string | undefined;
+    profileUrl?: string | undefined;
+    city?: string | undefined;
+    state?: string | undefined;
+    country?: string | undefined;
+    postalcode?: string | undefined;
+    timezone?: string | undefined;
+}, {
+    email?: string | undefined;
+    password?: string | undefined;
+    fullName?: string | undefined;
+    username?: string | undefined;
+    phoneNumber?: string | undefined;
+    profileUrl?: string | undefined;
+    city?: string | undefined;
+    state?: string | undefined;
+    country?: string | undefined;
+    postalcode?: string | undefined;
+    timezone?: string | undefined;
+}>;

package/dist/validation/verifyIdentity.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const verifyIdentitySchema: z.ZodObject<{
+    email: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+}, {
+    email: string;
+}>;

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@saxenapackages/auth-sdk",
+  "version": "1.0.0",
+  "description": "A production-grade, highly customizable React Authentication SDK",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./dist/auth-sdk.css": "./dist/auth-sdk.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts,.tsx"
+  },
+  "dependencies": {
+    "axios": "^1.6.8",
+    "zod": "^3.22.4"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0 || ^19.0.0",
+    "react-dom": "^18.2.0 || ^19.0.0",
+    "react-router-dom": "^6.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@types/node": "^26.1.1",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "@typescript/typescript6": "^6.0.2",
+    "@vitejs/plugin-react": "^4.7.0",
+    "eslint": "^9.39.5",
+    "jsdom": "^26.1.0",
+    "typescript": "^7.0.2",
+    "vite": "^6.4.3",
+    "vite-plugin-dts": "^5.0.3",
+    "vitest": "^3.2.7"
+  }
+}