@ram_28/kf-ai-sdk 1.0.1 → 1.0.3

package/README.md

@@ -15,6 +15,7 @@ npm install react @tanstack/react-query
 
 ## Features
 
+- **Authentication** - Cookie-based auth with AuthProvider and useAuth hook
 - **useForm** - Dynamic schema-driven forms with backend validation
 - **useTable** - Data tables with sorting, pagination, and React Query integration
 - **useKanban** - Kanban board state management with drag-drop support
@@ -27,12 +28,22 @@ npm install react @tanstack/react-query
 
 ```tsx
 import {
+  // Authentication
+  AuthProvider,
+  useAuth,
+  configureAuth,
+
+  // Hooks
   useForm,
   useTable,
   useKanban,
   useFilter,
+
+  // API
   api,
   setApiBaseUrl,
+
+  // Utilities
   formatCurrency,
   formatDate
 } from '@ram_28/kf-ai-sdk';
@@ -41,6 +52,149 @@ import {
 setApiBaseUrl('https://api.example.com');
 ```
 
+## Authentication
+
+The SDK provides a complete authentication solution with cookie-based session management.
+
+### Setup
+
+Wrap your app with `AuthProvider` inside a `QueryClientProvider`:
+
+```tsx
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { AuthProvider, setApiBaseUrl, configureAuth } from '@ram_28/kf-ai-sdk';
+
+// Configure API
+setApiBaseUrl('https://api.example.com');
+
+// Optional: customize auth settings
+configureAuth({
+  defaultProvider: 'google',
+  autoRedirect: true,
+  refetchOnWindowFocus: false,  // Disable session check on tab switch
+  refetchOnReconnect: true,     // Re-check session on network reconnect
+  providers: {
+    google: {
+      loginPath: '/api/auth/google/login',
+      logoutPath: '/api/auth/logout',
+    },
+  },
+});
+
+const queryClient = new QueryClient();
+
+function App() {
+  return (
+    <QueryClientProvider client={queryClient}>
+      <AuthProvider
+        loadingComponent={<div>Loading...</div>}
+        onAuthChange={(status, user) => console.log('Auth:', status, user)}
+      >
+        <MyApp />
+      </AuthProvider>
+    </QueryClientProvider>
+  );
+}
+```
+
+### useAuth Hook
+
+Access authentication state and operations in any component:
+
+```tsx
+import { useAuth } from '@ram_28/kf-ai-sdk';
+
+function UserMenu() {
+  const { user, isAuthenticated, isLoading, logout, hasRole } = useAuth();
+
+  if (isLoading) return <div>Loading...</div>;
+  if (!isAuthenticated) return null;
+
+  return (
+    <div>
+      <span>Welcome, {user._name}</span>
+      <span>Role: {user.Role}</span>
+
+      {hasRole('Admin') && <a href="/admin">Admin Dashboard</a>}
+
+      <button onClick={() => logout({ redirectUrl: '/' })}>
+        Logout
+      </button>
+    </div>
+  );
+}
+```
+
+### useAuth Return Values
+
+```tsx
+const {
+  // User state
+  user,              // UserDetails | null
+  staticBaseUrl,     // string | null
+  buildId,           // string | null
+  status,            // 'loading' | 'authenticated' | 'unauthenticated'
+  isAuthenticated,   // boolean
+  isLoading,         // boolean
+
+  // Operations
+  login,             // (provider?, options?) => void
+  logout,            // (options?) => Promise<void>
+  refreshSession,    // () => Promise<SessionResponse | null>
+  hasRole,           // (role: string) => boolean
+  hasAnyRole,        // (roles: string[]) => boolean
+
+  // Error handling
+  error,             // Error | null
+  clearError,        // () => void
+} = useAuth();
+```
+
+### Multiple Auth Providers
+
+```tsx
+import { useAuth } from '@ram_28/kf-ai-sdk';
+
+function LoginPage() {
+  const { login } = useAuth();
+
+  return (
+    <div>
+      <button onClick={() => login('google')}>
+        Continue with Google
+      </button>
+      <button onClick={() => login('microsoft')}>
+        Continue with Microsoft
+      </button>
+    </div>
+  );
+}
+```
+
+### Protected Routes
+
+```tsx
+import { useAuth } from '@ram_28/kf-ai-sdk';
+import { Navigate } from 'react-router-dom';
+
+function ProtectedRoute({ children, requiredRoles }) {
+  const { isAuthenticated, isLoading, hasAnyRole } = useAuth();
+
+  if (isLoading) return <div>Loading...</div>;
+  if (!isAuthenticated) return <Navigate to="/login" />;
+  if (requiredRoles && !hasAnyRole(requiredRoles)) {
+    return <Navigate to="/unauthorized" />;
+  }
+
+  return children;
+}
+
+// Usage
+<ProtectedRoute requiredRoles={['Admin', 'Manager']}>
+  <AdminDashboard />
+</ProtectedRoute>
+```
+
 ## Hooks
 
 ### useTable
@@ -310,7 +464,7 @@ cn('text-red-500', condition && 'text-blue-500');
 
 ## Documentation
 
-Detailed documentation for each hook:
+Detailed documentation for each feature:
 
 - [useForm Documentation](./docs/useForm.md)
 - [useTable Documentation](./docs/useTable.md)

package/dist/auth/AuthProvider.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+import type { AuthContextValue, AuthProviderProps } from "./types";
+export declare function AuthProvider({ children, config: configOverride, onAuthChange, onError, loadingComponent, unauthenticatedComponent, skipInitialCheck, }: AuthProviderProps): React.ReactElement;
+export declare function useAuthContext(): AuthContextValue;
+//# sourceMappingURL=AuthProvider.d.ts.map

package/dist/auth/AuthProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthProvider.d.ts","sourceRoot":"","sources":["../../sdk/auth/AuthProvider.tsx"],"names":[],"mappings":"AAKA,OAAO,KAQN,MAAM,OAAO,CAAC;AAGf,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAOlB,MAAM,SAAS,CAAC;AAsBjB,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,MAAM,EAAE,cAAc,EACtB,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,wBAAwB,EACxB,gBAAwB,GACzB,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAiNxC;AAMD,wBAAgB,cAAc,IAAI,gBAAgB,CAMjD"}

package/dist/auth/authClient.d.ts

@@ -0,0 +1,42 @@
+import type { SessionResponse, AuthProviderName, LoginOptions, LogoutOptions } from "./types";
+/**
+ * Custom error class for authentication errors
+ */
+export declare class AuthenticationError extends Error {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number);
+}
+/**
+ * Fetch current session from the server
+ * Calls the session endpoint (default: /api/id)
+ *
+ * @throws AuthenticationError if session check fails or user is not authenticated
+ */
+export declare function fetchSession(): Promise<SessionResponse>;
+/**
+ * Initiates OAuth login flow by redirecting to the auth provider.
+ *
+ * @remarks
+ * This function redirects the browser and never resolves.
+ * Any code after calling this function will not execute.
+ *
+ * @param provider - OAuth provider to use (defaults to config.defaultProvider)
+ * @param options - Login options including callback URL and custom params
+ * @returns Promise that never resolves (browser redirects away)
+ *
+ * @example
+ * ```typescript
+ * // Correct usage - no code after login()
+ * function handleLoginClick() {
+ *   login('google');
+ *   // Don't put code here - it won't run
+ * }
+ * ```
+ */
+export declare function initiateLogin(provider?: AuthProviderName, options?: LoginOptions): Promise<never>;
+/**
+ * Logout the current user
+ * Optionally calls the logout endpoint before clearing client state
+ */
+export declare function performLogout(options?: LogoutOptions): Promise<void>;
+//# sourceMappingURL=authClient.d.ts.map

package/dist/auth/authClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authClient.d.ts","sourceRoot":"","sources":["../../sdk/auth/authClient.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACd,MAAM,SAAS,CAAC;AAQjB;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,UAAU,EAAE,MAAM,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAKhD;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC,CAuB7D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,KAAK,CAAC,CA0DhB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB1E"}

package/dist/auth/authConfig.d.ts

@@ -0,0 +1,38 @@
+import type { AuthConfig, AuthProviderName, AuthEndpointConfig } from "./types";
+/**
+ * Configure authentication settings globally
+ * @example
+ * ```ts
+ * configureAuth({
+ *   defaultProvider: "google",
+ *   autoRedirect: true,
+ *   providers: {
+ *     google: { loginPath: "/api/auth/google/login" },
+ *     microsoft: { loginPath: "/api/auth/microsoft/login" },
+ *   },
+ * });
+ * ```
+ */
+export declare function configureAuth(config: Partial<AuthConfig>): void;
+/**
+ * Add or update an auth provider configuration
+ */
+export declare function setAuthProvider(provider: AuthProviderName, config: AuthEndpointConfig): void;
+/**
+ * Get current auth configuration
+ */
+export declare function getAuthConfig(): Readonly<AuthConfig>;
+/**
+ * Get the base URL for auth endpoints
+ * Falls back to API base URL if not explicitly set
+ */
+export declare function getAuthBaseUrl(): string;
+/**
+ * Get endpoint configuration for a specific provider
+ */
+export declare function getProviderConfig(provider: AuthProviderName): AuthEndpointConfig | undefined;
+/**
+ * Reset auth configuration to defaults
+ */
+export declare function resetAuthConfig(): void;
+//# sourceMappingURL=authConfig.d.ts.map

package/dist/auth/authConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authConfig.d.ts","sourceRoot":"","sources":["../../sdk/auth/authConfig.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AA+BhF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAa/D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,kBAAkB,GACzB,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,QAAQ,CAAC,UAAU,CAAC,CAEpD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,gBAAgB,GACzB,kBAAkB,GAAG,SAAS,CAEhC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/auth/index.d.ts

@@ -0,0 +1,6 @@
+export { AuthProvider } from "./AuthProvider";
+export { useAuth } from "./useAuth";
+export { configureAuth, setAuthProvider, getAuthConfig, getAuthBaseUrl, resetAuthConfig, } from "./authConfig";
+export { fetchSession, initiateLogin, performLogout, AuthenticationError, } from "./authClient";
+export type { UserDetails, SessionResponse, AuthStatus, AuthConfig, AuthProviderName, AuthEndpointConfig, AuthProviderProps, UseAuthReturn, LoginOptions, LogoutOptions, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/auth/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../sdk/auth/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EACL,aAAa,EACb,eAAe,EACf,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAGtB,YAAY,EACV,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/auth/types.d.ts

@@ -0,0 +1,156 @@
+/**
+ * User details returned from the session endpoint
+ */
+export interface UserDetails {
+    _id: string;
+    _name: string;
+    Role: string;
+    [key: string]: unknown;
+}
+/**
+ * Session response from /api/id endpoint
+ */
+export interface SessionResponse {
+    userDetails: UserDetails;
+    staticBaseUrl: string;
+    buildId: string;
+}
+/**
+ * Authentication status
+ */
+export type AuthStatus = "loading" | "authenticated" | "unauthenticated";
+/**
+ * Authentication provider type (extensible for multiple OAuth providers)
+ */
+export type AuthProviderName = "google" | "microsoft" | "github" | "custom";
+/**
+ * Auth endpoint configuration for a specific provider
+ */
+export interface AuthEndpointConfig {
+    /** Login endpoint path (e.g., "/api/auth/google/login") */
+    loginPath: string;
+    /** Optional logout endpoint path */
+    logoutPath?: string;
+    /** Optional callback endpoint path */
+    callbackPath?: string;
+}
+/**
+ * Global authentication configuration
+ */
+export interface AuthConfig {
+    /** Base URL for auth endpoints (defaults to apiBaseUrl) */
+    baseUrl?: string;
+    /** Session check endpoint (default: "/api/id") */
+    sessionEndpoint: string;
+    /** Auth provider configurations */
+    providers: Partial<Record<AuthProviderName, AuthEndpointConfig>>;
+    /** Default provider to use for login */
+    defaultProvider: AuthProviderName;
+    /** Auto-redirect to login when unauthenticated */
+    autoRedirect: boolean;
+    /** Custom redirect URL (if not using provider's login path) */
+    loginRedirectUrl?: string;
+    /** URL to redirect after successful login */
+    callbackUrl?: string;
+    /** Session check interval in milliseconds (0 to disable) */
+    sessionCheckInterval: number;
+    /** Retry configuration for session check */
+    retry: {
+        count: number;
+        delay: number;
+    };
+    /** React Query stale time for session data */
+    staleTime: number;
+    /** Refetch session when window regains focus (default: true) */
+    refetchOnWindowFocus?: boolean;
+    /** Refetch session when network reconnects (default: true) */
+    refetchOnReconnect?: boolean;
+}
+/**
+ * AuthProvider component props
+ */
+export interface AuthProviderProps {
+    children: React.ReactNode;
+    /** Override global config for this provider instance */
+    config?: Partial<AuthConfig>;
+    /** Callback when authentication status changes */
+    onAuthChange?: (status: AuthStatus, user: UserDetails | null) => void;
+    /** Callback on authentication error */
+    onError?: (error: Error) => void;
+    /** Custom loading component */
+    loadingComponent?: React.ReactNode;
+    /** Custom unauthenticated component (shown when autoRedirect is false) */
+    unauthenticatedComponent?: React.ReactNode;
+    /** Disable automatic session check on mount */
+    skipInitialCheck?: boolean;
+}
+/**
+ * Options for login operation
+ */
+export interface LoginOptions {
+    /** URL to redirect after successful login */
+    callbackUrl?: string;
+    /** Additional query parameters for login URL */
+    params?: Record<string, string>;
+}
+/**
+ * Options for logout operation
+ */
+export interface LogoutOptions {
+    /** URL to redirect after logout */
+    redirectUrl?: string;
+    /** Whether to call logout endpoint (default: true) */
+    callLogoutEndpoint?: boolean;
+}
+/**
+ * Return type for useAuth hook
+ */
+export interface UseAuthReturn {
+    /** Current authenticated user (null if not authenticated) */
+    user: UserDetails | null;
+    /** Static base URL from session */
+    staticBaseUrl: string | null;
+    /** Build ID from session */
+    buildId: string | null;
+    /** Current authentication status */
+    status: AuthStatus;
+    /** Convenience boolean for authenticated state */
+    isAuthenticated: boolean;
+    /** Convenience boolean for loading state */
+    isLoading: boolean;
+    /**
+     * Initiate login flow
+     * @param provider - Auth provider to use (defaults to configured default)
+     * @param options - Additional options for login
+     */
+    login: (provider?: AuthProviderName, options?: LoginOptions) => void;
+    /**
+     * Logout the current user
+     * @param options - Additional options for logout
+     */
+    logout: (options?: LogoutOptions) => Promise<void>;
+    /**
+     * Manually refresh the session
+     */
+    refreshSession: () => Promise<SessionResponse | null>;
+    /**
+     * Check if user has a specific role
+     */
+    hasRole: (role: string) => boolean;
+    /**
+     * Check if user has any of the specified roles
+     */
+    hasAnyRole: (roles: string[]) => boolean;
+    /** Last authentication error */
+    error: Error | null;
+    /** Clear the current error */
+    clearError: () => void;
+}
+/**
+ * Auth context value (internal)
+ */
+export interface AuthContextValue extends UseAuthReturn {
+    /** Internal: force re-check session */
+    _forceCheck: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/auth/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../sdk/auth/types.ts"],"names":[],"mappings":"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"}

package/dist/auth/useAuth.d.ts

@@ -0,0 +1,27 @@
+import type { UseAuthReturn } from "./types";
+/**
+ * Hook to access authentication state and operations
+ *
+ * Must be used within an AuthProvider component.
+ *
+ * @example
+ * ```tsx
+ * function UserProfile() {
+ *   const { user, isAuthenticated, logout } = useAuth();
+ *
+ *   if (!isAuthenticated) {
+ *     return <div>Please log in</div>;
+ *   }
+ *
+ *   return (
+ *     <div>
+ *       <h1>Welcome, {user._name}</h1>
+ *       <p>Role: {user.Role}</p>
+ *       <button onClick={() => logout()}>Logout</button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAuth(): UseAuthReturn;
+//# sourceMappingURL=useAuth.d.ts.map

package/dist/auth/useAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../../sdk/auth/useAuth.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,OAAO,IAAI,aAAa,CAmCvC"}