\n hasRole, // (role: string) => boolean\n hasAnyRole, // (roles: string[]) => boolean\n\n // Error handling\n error, // Error | null\n clearError, // () => void\n} = useAuth();\n```\n\n### Multiple Auth Providers\n\n```tsx\nimport { useAuth } from \"@ram_28/kf-ai-sdk/auth\";\n\nfunction LoginPage() {\n const { login } = useAuth();\n\n return (\n \n \n \n
\n );\n}\n```\n\n### Protected Routes\n\n```tsx\nimport { useAuth } from \"@ram_28/kf-ai-sdk/auth\";\nimport { Navigate } from \"react-router-dom\";\n\nfunction ProtectedRoute({ children, requiredRoles }) {\n const { isAuthenticated, isLoading, hasAnyRole } = useAuth();\n\n if (isLoading) return Loading...
;\n if (!isAuthenticated) return ;\n if (requiredRoles && !hasAnyRole(requiredRoles)) {\n return ;\n }\n\n return children;\n}\n\n// Usage\n\n \n;\n```\n\n## Hooks\n\n### useBDOForm\n\nBDO-integrated form hook with automatic validation and API calls.\n\n```tsx\nimport { useBDOForm } from \"@ram_28/kf-ai-sdk/form\";\nimport { AdminProduct } from \"./bdo/admin/Product\";\n\nfunction ProductForm() {\n const product = new AdminProduct();\n\n const { register, handleSubmit, errors, isSubmitting } = useBDOForm({\n bdo: product,\n defaultValues: { Title: \"\", Price: 0 },\n });\n\n return (\n \n );\n}\n```\n\n### useTable\n\nData table hook with sorting, pagination, and React Query integration.\n\n```tsx\nimport { useTable } from \"@ram_28/kf-ai-sdk/table\";\n\nfunction ProductTable() {\n const table = useTable({\n source: \"products\",\n columns: [\n { fieldId: \"name\", enableSorting: true },\n { fieldId: \"price\", enableSorting: true },\n ],\n initialState: {\n pagination: { pageNo: 1, pageSize: 25 },\n },\n });\n\n return (\n \n \n \n | table.sort.toggle(\"name\")}>Name | \n table.sort.toggle(\"price\")}>Price | \n
\n \n \n {table.rows.map((product) => (\n \n | {product.name} | \n ${product.price} | \n
\n ))}\n \n \n \n | \n \n Page {table.pagination.pageNo} of {table.pagination.totalPages}\n \n | \n
\n \n
\n );\n}\n```\n\n### useFilter\n\nAdvanced filtering with logical operators.\n\n```tsx\nimport { ConditionOperator, RHSType } from \"@ram_28/kf-ai-sdk/filter\";\nimport { BuyerProduct } from \"./bdo/buyer/Product\";\n\nfunction ProductFilter() {\n const product = new BuyerProduct();\n const filter = useFilter();\n\n return (\n \n \n \n \n
\n );\n}\n```\n\n## BDO (Business Data Object)\n\nType-safe, role-based data access layer:\n\n```tsx\nimport { BaseBdo, StringField, NumberField } from \"@ram_28/kf-ai-sdk/bdo\";\n\n// Define your BDO class\nclass AdminProduct extends BaseBdo {\n readonly meta = { _id: \"BDO_Product\", name: \"Product\" } as const;\n\n readonly Title = new StringField({ _id: \"Title\", Name: \"Product Title\", Type: \"String\", Constraint: { Required: true } });\n readonly Price = new NumberField({ _id: \"Price\", Name: \"Price\", Type: \"Number\" });\n\n // Expose only the methods this role can use\n public async get(id: string) { return super.get(id); }\n public async list(options?: any) { return super.list(options); }\n public async create(data: Partial) { return super.create(data); }\n public async update(id: string, data: Partial) { return super.update(id, data); }\n}\n```\n\n## API Client\n\nType-safe API client for CRUD operations.\n\n```tsx\nimport { api, setApiBaseUrl } from \"@ram_28/kf-ai-sdk/api\";\n\n// Configure base URL\nsetApiBaseUrl(\"https://api.example.com\");\n\n// CRUD Operations\nasync function productOperations() {\n // Get single record\n const product = await api(\"products\").get(\"PROD_123\");\n\n // Create record\n const created = await api(\"products\").create({\n name: \"New Product\",\n price: 99.99,\n category: \"electronics\",\n });\n\n // Update record\n const updated = await api(\"products\").update(\"PROD_123\", {\n price: 89.99,\n });\n\n // Delete record\n await api(\"products\").delete(\"PROD_123\");\n\n // List with filtering and sorting\n const products = await api(\"products\").list({\n Filter: {\n Operator: \"And\",\n Condition: [\n { Operator: \"EQ\", LHSField: \"category\", RHSValue: \"electronics\" },\n { Operator: \"GTE\", LHSField: \"price\", RHSValue: 50 },\n ],\n },\n Sort: [{ \"price\": \"DESC\" }],\n Page: 1,\n PageSize: 25,\n });\n\n // Count records\n const count = await api(\"products\").count({\n Filter: {\n Operator: \"And\",\n Condition: [{ Operator: \"EQ\", LHSField: \"inStock\", RHSValue: true }],\n },\n });\n}\n```\n\n## Type System\n\nThe SDK provides semantic field types for type-safe data modeling:\n\n```tsx\nimport type {\n StringFieldType,\n TextFieldType,\n NumberFieldType,\n BooleanFieldType,\n DateFieldType,\n DateTimeFieldType,\n SelectFieldType,\n ReferenceFieldType,\n} from \"@ram_28/kf-ai-sdk/types\";\n\n// Define your data types\ninterface Product {\n _id: StringFieldType;\n name: StringFieldType;\n description: TextFieldType;\n price: NumberFieldType;\n quantity: NumberFieldType;\n inStock: BooleanFieldType;\n category: SelectFieldType<\"electronics\" | \"clothing\" | \"books\">;\n createdAt: DateTimeFieldType;\n}\n```\n\n## Utilities\n\n### Formatting\n\n```tsx\nimport {\n formatCurrency,\n formatDate,\n formatDateTime,\n formatNumber,\n} from \"@ram_28/kf-ai-sdk/utils\";\n\nformatCurrency(99.99); // \"$99.99\"\nformatDate(new Date()); // \"Jan 11, 2024\"\nformatDateTime(new Date()); // \"Jan 11, 2024, 10:30 AM\"\nformatNumber(1234.56, 2); // \"1,234.56\"\n```\n\n### Class Names\n\n```tsx\nimport { cn } from \"@ram_28/kf-ai-sdk/utils\";\n\n// Merge Tailwind classes with conflict resolution\ncn(\"px-4 py-2\", \"px-6\"); // \"py-2 px-6\"\ncn(\"text-red-500\", condition && \"text-blue-500\");\n```\n\n## Documentation\n\nDetailed, use-case-driven documentation with examples for each module:\n\n**Hooks:**\n- [useBDOForm](./docs/useBDOForm/README.md) — BDO-integrated forms with validation and API submission\n- [useBDOTable](./docs/useBDOTable/README.md) — Data tables with sorting, search, filtering, and pagination\n- [useActivityForm](./docs/useActivityForm/README.md) — Workflow activity forms with save-draft and complete\n- [useActivityTable](./docs/useActivityTable/README.md) — Activity instance tables for workflow tasks\n- [useFilter](./docs/useFilter/README.md) — Filter condition builder with nested groups\n\n**Core:**\n- [BDO](./docs/bdo/README.md) — Type-safe, role-based data access layer\n- [Workflow](./docs/workflow/README.md) — Business process orchestration\n- [API Client](./docs/api/README.md) — Low-level CRUD, metric, pivot, draft, and attachment operations\n\n**Auth:**\n- [useAuth](./docs/useAuth/README.md) — Cookie-based authentication with session management\n\n## Requirements\n\n- Node.js >= 18.0.0\n- React >= 16.8.0\n- @tanstack/react-query >= 5.0.0\n\n## License\n\nMIT\n","readmeFilename":"README.md"}