@ram_28/kf-ai-sdk 1.0.4 → 1.0.5

package/README.md

@@ -9,6 +9,7 @@ npm install @ram_28/kf-ai-sdk
 ```
 
 **Peer Dependencies:**
+
 ```bash
 npm install react @tanstack/react-query
 ```
@@ -43,8 +44,8 @@ import {
 
   // Utilities
   formatCurrency,
-  formatDate
-} from '@ram_28/kf-ai-sdk';
+  formatDate,
+} from "@ram_28/kf-ai-sdk";
 ```
 
 ## Authentication
@@ -56,8 +57,8 @@ The SDK provides a complete authentication solution with cookie-based session ma
 Wrap your app with `AuthProvider` inside a `QueryClientProvider`. No configuration required - it works out of the box:
 
 ```tsx
-import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
-import { AuthProvider } from '@ram_28/kf-ai-sdk';
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { AuthProvider } from "@ram_28/kf-ai-sdk";
 
 const queryClient = new QueryClient();
 
@@ -77,7 +78,7 @@ function App() {
 Access authentication state and operations in any component:
 
 ```tsx
-import { useAuth } from '@ram_28/kf-ai-sdk';
+import { useAuth } from "@ram_28/kf-ai-sdk";
 
 function UserMenu() {
   const { user, isAuthenticated, isLoading, logout, hasRole } = useAuth();
@@ -90,11 +91,9 @@ function UserMenu() {
       <span>Welcome, {user._name}</span>
       <span>Role: {user.Role}</span>
 
-      {hasRole('Admin') && <a href="/admin">Admin Dashboard</a>}
+      {hasRole("Admin") && <a href="/admin">Admin Dashboard</a>}
 
-      <button onClick={() => logout({ redirectUrl: '/' })}>
-        Logout
-      </button>
+      <button onClick={() => logout({ redirectUrl: "/" })}>Logout</button>
     </div>
   );
 }
@@ -105,40 +104,38 @@ function UserMenu() {
 ```tsx
 const {
   // User state
-  user,              // UserDetails | null
-  staticBaseUrl,     // string | null
-  buildId,           // string | null
-  status,            // 'loading' | 'authenticated' | 'unauthenticated'
-  isAuthenticated,   // boolean
-  isLoading,         // boolean
+  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
+  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
+  error, // Error | null
+  clearError, // () => void
 } = useAuth();
 ```
 
 ### Multiple Auth Providers
 
 ```tsx
-import { useAuth } from '@ram_28/kf-ai-sdk';
+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')}>
+      <button onClick={() => login("google")}>Continue with Google</button>
+      <button onClick={() => login("microsoft")}>
         Continue with Microsoft
       </button>
     </div>
@@ -149,8 +146,8 @@ function LoginPage() {
 ### Protected Routes
 
 ```tsx
-import { useAuth } from '@ram_28/kf-ai-sdk';
-import { Navigate } from 'react-router-dom';
+import { useAuth } from "@ram_28/kf-ai-sdk";
+import { Navigate } from "react-router-dom";
 
 function ProtectedRoute({ children, requiredRoles }) {
   const { isAuthenticated, isLoading, hasAnyRole } = useAuth();
@@ -165,9 +162,9 @@ function ProtectedRoute({ children, requiredRoles }) {
 }
 
 // Usage
-<ProtectedRoute requiredRoles={['Admin', 'Manager']}>
+<ProtectedRoute requiredRoles={["Admin", "Manager"]}>
   <AdminDashboard />
-</ProtectedRoute>
+</ProtectedRoute>;
 ```
 
 ## Hooks
@@ -177,11 +174,11 @@ function ProtectedRoute({ children, requiredRoles }) {
 Data table hook with sorting, pagination, and React Query integration.
 
 ```tsx
-import { useTable } from '@ram_28/kf-ai-sdk';
+import { useTable } from "@ram_28/kf-ai-sdk";
 
 function ProductTable() {
   const table = useTable({
-    source: 'products',
+    source: "products",
     enableSorting: true,
     enablePagination: true,
     pageSize: 25,
@@ -191,8 +188,8 @@ function ProductTable() {
     <table>
       <thead>
         <tr>
-          <th onClick={() => table.toggleSort('name')}>Name</th>
-          <th onClick={() => table.toggleSort('price')}>Price</th>
+          <th onClick={() => table.toggleSort("name")}>Name</th>
+          <th onClick={() => table.toggleSort("price")}>Price</th>
         </tr>
       </thead>
       <tbody>
@@ -222,27 +219,27 @@ function ProductTable() {
 Schema-driven form hook with backend validation support.
 
 ```tsx
-import { useForm } from '@ram_28/kf-ai-sdk';
+import { useForm } from "@ram_28/kf-ai-sdk";
 
 function ProductForm() {
   const form = useForm({
-    source: 'products',
-    operation: 'create',
+    source: "products",
+    operation: "create",
     onSuccess: (data) => {
-      console.log('Created:', data);
+      console.log("Created:", data);
     },
   });
 
   return (
     <form onSubmit={form.handleSubmit()}>
-      <input {...form.register('name')} placeholder="Product Name" />
+      <input {...form.register("name")} placeholder="Product Name" />
       {form.errors.name && <span>{form.errors.name.message}</span>}
 
-      <input {...form.register('price')} type="number" placeholder="Price" />
+      <input {...form.register("price")} type="number" placeholder="Price" />
       {form.errors.price && <span>{form.errors.price.message}</span>}
 
       <button type="submit" disabled={form.isSubmitting}>
-        {form.isSubmitting ? 'Creating...' : 'Create Product'}
+        {form.isSubmitting ? "Creating..." : "Create Product"}
       </button>
     </form>
   );
@@ -254,16 +251,16 @@ function ProductForm() {
 Kanban board state management with drag-drop support.
 
 ```tsx
-import { useKanban, Kanban, KanbanColumn, KanbanCard } from '@ram_28/kf-ai-sdk';
+import { useKanban, Kanban, KanbanColumn, KanbanCard } from "@ram_28/kf-ai-sdk";
 
 function TaskBoard() {
   const kanban = useKanban({
-    source: 'tasks',
-    groupByField: 'status',
+    source: "tasks",
+    groupByField: "status",
     columns: [
-      { id: 'todo', title: 'To Do' },
-      { id: 'in-progress', title: 'In Progress' },
-      { id: 'done', title: 'Done' },
+      { id: "todo", title: "To Do" },
+      { id: "in-progress", title: "In Progress" },
+      { id: "done", title: "Done" },
     ],
   });
 
@@ -288,14 +285,17 @@ function TaskBoard() {
 Advanced filtering with logical operators.
 
 ```tsx
-import { useFilter, buildFilterPayload } from '@ram_28/kf-ai-sdk';
+import { useFilter, buildFilterPayload } from "@ram_28/kf-ai-sdk";
 
 function ProductFilter() {
   const filter = useFilter({
     fields: {
-      name: { type: 'string' },
-      price: { type: 'number' },
-      category: { type: 'select', options: ['electronics', 'clothing', 'books'] },
+      name: { type: "string" },
+      price: { type: "number" },
+      category: {
+        type: "select",
+        options: ["electronics", "clothing", "books"],
+      },
     },
   });
 
@@ -306,10 +306,10 @@ function ProductFilter() {
 
   return (
     <div>
-      <button onClick={() => filter.addCondition('name', 'contains', '')}>
+      <button onClick={() => filter.addCondition("name", "contains", "")}>
         Add Name Filter
       </button>
-      <button onClick={() => filter.addCondition('price', 'gte', 0)}>
+      <button onClick={() => filter.addCondition("price", "gte", 0)}>
         Add Price Filter
       </button>
       <button onClick={handleApply}>Apply Filters</button>
@@ -323,54 +323,50 @@ function ProductFilter() {
 Type-safe API client for CRUD operations.
 
 ```tsx
-import { api, setApiBaseUrl } from '@ram_28/kf-ai-sdk';
+import { api, setApiBaseUrl } from "@ram_28/kf-ai-sdk";
 
 // Configure base URL
-setApiBaseUrl('https://api.example.com');
+setApiBaseUrl("https://api.example.com");
 
 // CRUD Operations
 async function productOperations() {
   // Get single record
-  const product = await api('products').get('PROD_123');
+  const product = await api("products").get("PROD_123");
 
   // Create record
-  const created = await api('products').create({
-    name: 'New Product',
+  const created = await api("products").create({
+    name: "New Product",
     price: 99.99,
-    category: 'electronics',
+    category: "electronics",
   });
 
   // Update record
-  const updated = await api('products').update('PROD_123', {
+  const updated = await api("products").update("PROD_123", {
     price: 89.99,
   });
 
   // Delete record
-  await api('products').delete('PROD_123');
+  await api("products").delete("PROD_123");
 
   // List with filtering and sorting
-  const products = await api('products').list({
+  const products = await api("products").list({
     Filter: {
-      Operator: 'AND',
+      Operator: "AND",
       Condition: [
-        { Operator: 'EQ', LHSField: 'category', RHSValue: 'electronics' },
-        { Operator: 'GTE', LHSField: 'price', RHSValue: 50 },
+        { Operator: "EQ", LHSField: "category", RHSValue: "electronics" },
+        { Operator: "GTE", LHSField: "price", RHSValue: 50 },
       ],
     },
-    Sort: [
-      { Field: 'price', Order: 'DESC' },
-    ],
+    Sort: [{ Field: "price", Order: "DESC" }],
     Page: 1,
     PageSize: 25,
   });
 
   // Count records
-  const count = await api('products').count({
+  const count = await api("products").count({
     Filter: {
-      Operator: 'AND',
-      Condition: [
-        { Operator: 'EQ', LHSField: 'inStock', RHSValue: true },
-      ],
+      Operator: "AND",
+      Condition: [{ Operator: "EQ", LHSField: "inStock", RHSValue: true }],
     },
   });
 }
@@ -392,7 +388,7 @@ import type {
   CurrencyField,
   PercentageField,
   SelectField,
-} from '@ram_28/kf-ai-sdk';
+} from "@ram_28/kf-ai-sdk";
 
 // Define your data types
 interface Product {
@@ -402,7 +398,7 @@ interface Product {
   price: CurrencyField;
   quantity: NumberField<0>;
   inStock: BooleanField;
-  category: SelectField<'electronics' | 'clothing' | 'books'>;
+  category: SelectField<"electronics" | "clothing" | "books">;
   createdAt: DateTimeField;
 }
 ```
@@ -417,24 +413,24 @@ import {
   formatDate,
   formatDateTime,
   formatNumber,
-  formatPercentage
-} from '@ram_28/kf-ai-sdk';
-
-formatCurrency(99.99);           // "$99.99"
-formatDate(new Date());          // "Jan 11, 2024"
-formatDateTime(new Date());      // "Jan 11, 2024, 10:30 AM"
-formatNumber(1234.56, 2);        // "1,234.56"
-formatPercentage(0.156);         // "15.6%"
+  formatPercentage,
+} from "@ram_28/kf-ai-sdk";
+
+formatCurrency(99.99); // "$99.99"
+formatDate(new Date()); // "Jan 11, 2024"
+formatDateTime(new Date()); // "Jan 11, 2024, 10:30 AM"
+formatNumber(1234.56, 2); // "1,234.56"
+formatPercentage(0.156); // "15.6%"
 ```
 
 ### Class Names
 
 ```tsx
-import { cn } from '@ram_28/kf-ai-sdk';
+import { cn } from "@ram_28/kf-ai-sdk";
 
 // Merge Tailwind classes with conflict resolution
-cn('px-4 py-2', 'px-6');  // "py-2 px-6"
-cn('text-red-500', condition && 'text-blue-500');
+cn("px-4 py-2", "px-6"); // "py-2 px-6"
+cn("text-red-500", condition && "text-blue-500");
 ```
 
 ## Documentation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ram_28/kf-ai-sdk",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Type-safe, AI-driven SDK for building modern web applications with role-based access control",
   "author": "Ramprasad",
   "license": "MIT",