@ram_28/kf-ai-sdk 2.0.26 → 2.0.28

package/docs/bdo/README.md

@@ -82,7 +82,7 @@ const filtered = await product.count({
   Filter: {
     Operator: "And",
     Condition: [
-      { Operator: "eq", LHSField: "Category", RHSValue: "Electronics" },
+      { Operator: "EQ", LHSField: "Category", RHSValue: "Electronics", RHSType: "Constant" },
     ],
   },
 });
@@ -125,8 +125,8 @@ const items = await product.list({
   Filter: {
     Operator: "And",
     Condition: [
-      { Operator: "eq", LHSField: "Category", RHSValue: "Electronics" },
-      { Operator: "gte", LHSField: "Price", RHSValue: 10 },
+      { Operator: "EQ", LHSField: "Category", RHSValue: "Electronics", RHSType: "Constant" },
+      { Operator: "GTE", LHSField: "Price", RHSValue: 10, RHSType: "Constant" },
     ],
   },
   Sort: [{ Price: "DESC" }],

package/docs/bdo/api_reference.md

@@ -140,7 +140,7 @@ interface ConditionGroupType {
 }
 
 interface ConditionType {
-  Operator: string;        // "eq", "neq", "gt", "gte", "lt", "lte", "contains", "startswith", etc.
+  Operator: string;        // "EQ", "NE", "GT", "GTE", "LT", "LTE", "Contains", "StartsWith", "IN", "NIN", "Empty", "NotEmpty"
   LHSField: string;        // field name
   RHSValue: any;            // comparison value
   RHSType?: string;         // defaults to "Constant"

package/docs/examples/bdo/filtered-product-table.md

@@ -6,7 +6,7 @@
 import { useState, useMemo } from "react";
 import { useBDOTable } from "@ram_28/kf-ai-sdk/table";
 import type { UseBDOTableReturnType } from "@ram_28/kf-ai-sdk/table/types";
-import { ConditionOperator, RHSType } from "@ram_28/kf-ai-sdk/filter";
+import { ConditionOperator, RHSType } from "@ram_28/kf-ai-sdk/table";
 import { BuyerProduct } from "@/bdo/buyer/Product";
 
 export default function FilteredProductTable() {

package/docs/examples/workflow/filtered-activity-table.md

@@ -6,7 +6,7 @@
 import { useState, useMemo } from "react";
 import { useActivityTable, ActivityTableStatus } from "@ram_28/kf-ai-sdk/workflow";
 import type { UseActivityTableReturnType } from "@ram_28/kf-ai-sdk/workflow";
-import { ConditionOperator, RHSType } from "@ram_28/kf-ai-sdk/filter";
+import { ConditionOperator, RHSType } from "@ram_28/kf-ai-sdk/table";
 import { EmployeeInputActivity } from "@/workflow/leave";
 
 export default function FilteredActivityTable() {

package/docs/fields/README.md

@@ -38,13 +38,34 @@ import type {
 } from "@ram_28/kf-ai-sdk/types";
 ```
 
+## CRITICAL: `.get()` Returns `T | undefined`
+
+**Every** field accessor's `.get()` method returns `T | undefined` — **never just `T`**. This means you MUST null-guard the return value before passing it to typed functions:
+
+```typescript
+// ❌ WRONG — TypeScript error: 'string | undefined' not assignable to 'string | number'
+const rowDate = new Date(row.start_time.get());
+const label = format(row.start_time.get(), "MMM d");
+getStatusBadge(row.status.get());  // param expects string, gets string | undefined
+
+// ✅ CORRECT — Guard undefined before use
+const startVal = row.start_time.get();
+if (!startVal) return null;  // or provide a fallback
+const rowDate = new Date(startVal);        // Now guaranteed string
+const label = format(startVal, "MMM d");   // Now guaranteed string
+getStatusBadge(row.status.get() ?? "");    // Fallback to empty string
+```
+
+This applies to ALL field types: `StringField.get()` → `string | undefined`, `NumberField.get()` → `number | undefined`, `DateTimeField.get()` → `string | undefined`, etc.
+
 ## Common Mistakes (READ FIRST)
 
 1. **`item.Title` is not the value** — Use `item.Title.get()` to read, `.set()` to write.
-2. **Don't confuse `StringField` (class) with `StringFieldType` (type alias)** — Different modules.
-3. **`fetchOptions()` requires a parent BDO** — Standalone fields will throw.
-4. **SelectField meta `Type` is `"String"`** — `Constraint.Enum` differentiates it.
-5. **Always use pre-built components for File/Image** — `<FileUpload>`, `<ImageUpload>`, `<FilePreview>`, `<ImageThumbnail>`.
+2. **`.get()` returns `T | undefined`** — Always null-guard before passing to `new Date()`, `format()`, template literals, or typed function parameters. See section above.
+3. **Don't confuse `StringField` (class) with `StringFieldType` (type alias)** — Different modules.
+4. **`fetchOptions()` requires a parent BDO** — Standalone fields will throw.
+5. **SelectField meta `Type` is `"String"`** — `Constraint.Enum` differentiates it.
+6. **Always use pre-built components for File/Image** — `<FileUpload>`, `<ImageUpload>`, `<FilePreview>`, `<ImageThumbnail>`.
 
 ## Quick Start
 

package/docs/useActivityTable/README.md

@@ -161,14 +161,14 @@ Sorting is controlled through the `sort` object. Column headers typically use `t
 The table includes an integrated [`useFilter`](../useFilter/README.md) instance at `table.filter`. Use it to build filter conditions that narrow down the table results:
 
 ```tsx
-import { ConditionOperator } from "@ram_28/kf-ai-sdk/table";
+import { ConditionOperator, RHSType } from "@ram_28/kf-ai-sdk/table";
 
 // Filter by leave type
 table.filter.addCondition({
   Operator: ConditionOperator.EQ,
   LHSField: activity.LeaveType.id,
   RHSValue: "PTO",
-  RHSType: "Constant",
+  RHSType: RHSType.Constant,
 });
 
 // Date range filter
@@ -176,7 +176,7 @@ table.filter.addCondition({
   Operator: ConditionOperator.GTE,
   LHSField: activity.StartDate.id,
   RHSValue: "2026-01-01",
-  RHSType: "Constant",
+  RHSType: RHSType.Constant,
 });
 
 // Clear all filters

package/docs/useBDOTable/README.md

@@ -141,14 +141,14 @@ Sorting is controlled through the `sort` object. Column headers typically use `t
 The table includes an integrated [`useFilter`](../useFilter/README.md) instance at `table.filter`. Use it to build filter conditions that narrow down the table results:
 
 ```tsx
-import { ConditionOperator } from "@ram_28/kf-ai-sdk/table";
+import { ConditionOperator, RHSType } from "@ram_28/kf-ai-sdk/table";
 
 // Exact match
 table.filter.addCondition({
   Operator: ConditionOperator.EQ,
   LHSField: product.Category.id,
   RHSValue: "Electronics",
-  RHSType: "Constant",
+  RHSType: RHSType.Constant,
 });
 
 // Range filter
@@ -156,6 +156,7 @@ table.filter.addCondition({
   Operator: ConditionOperator.GTE,
   LHSField: product.Price.id,
   RHSValue: 100,
+  RHSType: RHSType.Constant,
 });
 
 // Clear all filters

package/package.json

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