@s8lab/sso-client 1.0.0

package/dist/lib/captchaV3.d.ts

@@ -0,0 +1,12 @@
+declare global {
+    interface Window {
+        grecaptcha: {
+            ready: (cb: () => void) => void;
+            execute: (siteKey: string, options: {
+                action: string;
+            }) => Promise<string>;
+        };
+    }
+}
+export declare function loadRecaptchaV3Script(siteKey: string): void;
+export declare function executeRecaptchaV3(siteKey: string, action: string): Promise<string>;

package/dist/lib/utils.d.ts

@@ -0,0 +1,2 @@
+import { ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/types/index.d.ts

@@ -0,0 +1,148 @@
+import { default as React } from 'react';
+export interface CaptchaConfig {
+    enabled: boolean;
+    /** "recaptcha" (Google) or "hcaptcha" */
+    provider?: "recaptcha" | "hcaptcha";
+    /** "v2" = checkbox widget, "v3" = invisible/score-based */
+    version?: "v2" | "v3";
+    siteKey?: string;
+}
+export interface OAuthProvider {
+    /** e.g. "google" | "github" | "facebook" */
+    provider: string;
+    /** Display label. Defaults to capitalised provider name */
+    label?: string;
+    /** Full OAuth redirect URL returned by your server */
+    url: string;
+}
+export interface AuthConfig {
+    logoUrl?: string;
+    allowSignup: boolean;
+    allowMagicLink?: boolean;
+    captcha: CaptchaConfig;
+    privacyPolicyUrl?: string;
+    termsOfServiceUrl?: string;
+    oauthProviders?: OAuthProvider[];
+}
+export interface AuthConfigContextValue {
+    config: AuthConfig | null;
+    configLoading: boolean;
+    apiUrl: string;
+}
+export interface User {
+    id: string;
+    email: string;
+    firstName: string;
+    lastName: string;
+    whatsappNumber?: string;
+    avatarUrl?: string;
+    [key: string]: unknown;
+}
+export interface AuthTokens {
+    accessToken: string;
+    refreshToken?: string;
+}
+export interface AuthState {
+    user: User | null;
+    tokens: AuthTokens | null;
+    isLoading: boolean;
+    isAuthenticated: boolean;
+}
+export interface LoginPayload {
+    email: string;
+    password: string;
+    captchaToken: string;
+    rememberMe?: boolean;
+}
+export interface SignupPayload {
+    firstName: string;
+    lastName: string;
+    email: string;
+    password: string;
+    whatsappNumber?: string;
+    captchaToken: string;
+}
+export interface ForgotPasswordPayload {
+    email: string;
+    captchaToken: string;
+}
+export interface MagicLinkPayload {
+    email: string;
+    captchaToken: string;
+}
+export interface AuthContextValue extends AuthState {
+    login: (payload: LoginPayload) => Promise<void>;
+    signup: (payload: SignupPayload) => Promise<void>;
+    logout: () => Promise<void>;
+    forgotPassword: (payload: ForgotPasswordPayload) => Promise<void>;
+    sendMagicLink: (payload: MagicLinkPayload) => Promise<void>;
+    updateUser: (user: Partial<User>) => void;
+}
+export interface AuthProviderProps {
+    children: React.ReactNode;
+    /**
+     * Base URL of your SSO API server.
+     * Expected endpoints:
+     *   GET  /auth/config          (with X-Project-Id header)
+     *   POST /auth/login
+     *   POST /auth/signup
+     *   POST /auth/logout
+     *   POST /auth/forgot-password
+     *   POST /auth/magic-link
+     *   GET  /auth/me
+     */
+    apiUrl: string;
+    /** Project ID sent as X-Project-Id header when loading auth config */
+    projectId: string;
+    /** localStorage key prefix for tokens. Default: "sso" */
+    storageKeyPrefix?: string;
+    /**
+     * Custom fetch handler — override for custom headers, interceptors, etc.
+     * Must return the parsed JSON response (or undefined for 204).
+     */
+    fetcher?: <T>(url: string, init: RequestInit) => Promise<T>;
+}
+export interface LoginFormProps {
+    /** Extra CSS classes applied to the outer Card */
+    className?: string;
+    /** Called after a successful login */
+    onSuccess?: (user: User) => void;
+    /** Called on login or config error */
+    onError?: (error: Error) => void;
+    /** href for the "Forgot password?" link */
+    forgotPasswordUrl?: string;
+    /** href for the "Sign up" link (only shown when config.allowSignup is true) */
+    signupUrl?: string;
+    /** Override the page title. Default: "Sign in to your account" */
+    title?: string;
+}
+export interface SignupFormProps {
+    className?: string;
+    onSuccess?: (user: User) => void;
+    onError?: (error: Error) => void;
+    /** href for the "Sign in" link */
+    loginUrl?: string;
+    title?: string;
+}
+export interface ForgotPasswordFormProps {
+    className?: string;
+    onSuccess?: () => void;
+    onError?: (error: Error) => void;
+    loginUrl?: string;
+    title?: string;
+}
+export interface LogoutButtonProps {
+    className?: string;
+    onSuccess?: () => void;
+    onError?: (error: Error) => void;
+    label?: string;
+    children?: (props: {
+        isLoading: boolean;
+    }) => React.ReactNode;
+}
+export interface ProfileComponentProps {
+    className?: string;
+    onEditProfile?: (user: User) => void;
+    showLogout?: boolean;
+    onLogoutSuccess?: () => void;
+}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@s8lab/sso-client",
+  "version": "1.0.0",
+  "description": "SSO authentication components for React — Login, Signup, ForgotPassword, Logout, Profile with Google reCAPTCHA and shadcn UI",
+  "author": "S8 Lab",
+  "license": "MIT",
+  "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"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
+    "preview": "vite preview",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
+  },
+  "dependencies": {
+    "@hookform/resolvers": "^3.9.0",
+    "@hcaptcha/react-hcaptcha": "^1.1.1",
+    "@radix-ui/react-avatar": "^1.1.1",
+    "@radix-ui/react-checkbox": "^1.1.2",
+    "@radix-ui/react-label": "^2.1.0",
+    "@radix-ui/react-separator": "^1.1.0",
+    "@radix-ui/react-slot": "^1.1.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "lucide-react": "^0.468.0",
+    "react-google-recaptcha": "^3.1.0",
+    "react-hook-form": "^7.54.0",
+    "tailwind-merge": "^2.5.5",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "@types/react-google-recaptcha": "^2.1.9",
+    "@vitejs/plugin-react": "^4.3.4",
+    "autoprefixer": "^10.4.20",
+    "eslint": "^9.17.0",
+    "postcss": "^8.4.49",
+    "tailwindcss": "^3.4.17",
+    "typescript": "^5.7.2",
+    "vite": "^6.0.5",
+    "vite-plugin-dts": "^4.3.0",
+    "vite-plugin-lib-inject-css": "^2.1.1"
+  },
+  "keywords": [
+    "sso",
+    "auth",
+    "login",
+    "signup",
+    "react",
+    "shadcn",
+    "recaptcha",
+    "authentication"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/avasarhub/sso-client-sdk"
+  }
+}