@ram_28/kf-ai-sdk 1.0.5 → 1.0.8

package/sdk/components/hooks/useTable/useTable.ts

@@ -18,44 +18,11 @@ interface SortingState<T> {
   direction: "asc" | "desc" | null;
 }
 
-interface FilteringState {
-  global: string;
-}
-
 interface PaginationState {
   pageNo: number; // 1-indexed page number
   pageSize: number;
 }
 
-// ============================================================
-// FIELD TYPE DETECTION
-// ============================================================
-
-/**
- * Detect field type for auto-formatting
- * This will be enhanced with actual type introspection in the future
- * Currently unused but kept for future auto-formatting implementation
- */
-// function _detectFieldType<T>(fieldId: keyof T): string {
-//   const fieldName = String(fieldId);
-//
-//   // Basic pattern matching - will be replaced with actual type introspection
-//   if (fieldName.includes('price') || fieldName.includes('cost') || fieldName.includes('amount')) {
-//     return 'currency';
-//   }
-//   if (fieldName.includes('date') || fieldName.includes('At') || fieldName === 'created' || fieldName === 'updated') {
-//     return 'datetime';
-//   }
-//   if (fieldName.includes('stock') || fieldName.includes('quantity') || fieldName.includes('count')) {
-//     return 'number';
-//   }
-//   if (fieldName.includes('status') || fieldName.includes('type') || fieldName.includes('category')) {
-//     return 'string';
-//   }
-//
-//   return 'string'; // default
-// }
-
 // ============================================================
 // MAIN HOOK
 // ============================================================
@@ -76,12 +43,8 @@ export function useTable<T = any>(
     direction: options.initialState?.sorting?.direction || null,
   });
 
-  const [filtering, setFiltering] = useState<FilteringState>({
-    global: options.initialState?.globalFilter || "",
-  });
-
   const [pagination, setPagination] = useState<PaginationState>({
-    pageNo: options.initialState?.pagination?.pageNo || 1, // Start at page 1
+    pageNo: options.initialState?.pagination?.pageNo || 1,
     pageSize: options.initialState?.pagination?.pageSize || 10,
   });
 
@@ -89,24 +52,9 @@ export function useTable<T = any>(
   // FILTER HOOK INTEGRATION
   // ============================================================
 
-  const filterHook = useFilter<T>({
+  const filter = useFilter({
     initialConditions: options.initialState?.filters,
-    initialLogicalOperator: options.initialState?.filterOperator || "And",
-    fieldDefinitions: options.fieldDefinitions,
-    validateOnChange: true,
-    onValidationError: options.onFilterError,
-    onConditionAdd: () => {
-      // Reset to first page when adding filters
-      setPagination((prev) => ({ ...prev, pageNo: 1 }));
-    },
-    onConditionUpdate: () => {
-      // Reset to first page when updating filters
-      setPagination((prev) => ({ ...prev, pageNo: 1 }));
-    },
-    onConditionRemove: () => {
-      // Reset to first page when removing filters
-      setPagination((prev) => ({ ...prev, pageNo: 1 }));
-    },
+    initialOperator: options.initialState?.filterOperator || "And",
   });
 
   // ============================================================
@@ -123,12 +71,12 @@ export function useTable<T = any>(
     }
 
     // Add filter conditions (affects count)
-    if (filterHook.filterPayload) {
-      opts.Filter = filterHook.filterPayload;
+    if (filter.payload) {
+      opts.Filter = filter.payload;
     }
 
     return opts;
-  }, [search.query, filterHook.filterPayload]);
+  }, [search.query, filter.payload]);
 
   // Options for list query - includes all options
   const apiOptions = useMemo((): ListOptions => {
@@ -145,7 +93,7 @@ export function useTable<T = any>(
 
     // Add pagination
     if (options.enablePagination) {
-      opts.Page = pagination.pageNo; // Already 1-indexed
+      opts.Page = pagination.pageNo;
       opts.PageSize = pagination.pageSize;
     }
 
@@ -182,7 +130,7 @@ export function useTable<T = any>(
     gcTime: 0,
   });
 
-  // Count query for accurate total items (only depends on filters/search, not sorting/pagination)
+  // Count query for accurate total items
   const {
     data: countData,
     isLoading: isCountLoading,
@@ -223,14 +171,12 @@ export function useTable<T = any>(
   const toggleSort = useCallback((field: keyof T) => {
     setSorting((prev) => {
       if (prev.field === field) {
-        // Same field - toggle direction or clear
         if (prev.direction === "asc") {
           return { field, direction: "desc" };
         } else if (prev.direction === "desc") {
           return { field: null, direction: null };
         }
       }
-      // New field or no current sort
       return { field, direction: "asc" };
     });
   }, []);
@@ -252,7 +198,6 @@ export function useTable<T = any>(
 
   const setSearchQuery = useCallback((value: string) => {
     setSearch({ query: value });
-    // Reset to first page when searching
     setPagination((prev) => ({ ...prev, pageNo: 1 }));
   }, []);
 
@@ -260,20 +205,6 @@ export function useTable<T = any>(
     setSearch({ query: "" });
   }, []);
 
-  // ============================================================
-  // FILTERING OPERATIONS
-  // ============================================================
-
-  const setGlobalFilter = useCallback((value: string) => {
-    setFiltering((prev) => ({ ...prev, global: value }));
-    // Reset to first page when filtering
-    setPagination((prev) => ({ ...prev, pageNo: 1 }));
-  }, []);
-
-  const clearFilter = useCallback(() => {
-    setFiltering({ global: "" });
-  }, []);
-
   // ============================================================
   // PAGINATION OPERATIONS
   // ============================================================
@@ -295,7 +226,7 @@ export function useTable<T = any>(
 
   const goToPage = useCallback(
     (page: number) => {
-      const pageNo = Math.max(1, Math.min(page, totalPages)); // Clamp between 1 and totalPages
+      const pageNo = Math.max(1, Math.min(page, totalPages));
       setPagination((prev) => ({ ...prev, pageNo }));
     },
     [totalPages]
@@ -305,7 +236,7 @@ export function useTable<T = any>(
     setPagination((prev) => ({
       ...prev,
       pageSize: size,
-      pageNo: 1, // Reset to first page
+      pageNo: 1,
     }));
   }, []);
 
@@ -350,52 +281,12 @@ export function useTable<T = any>(
       set: setSort,
     },
 
-    // Legacy Global Filtering (Flat Access)
-    globalFilter: {
-      value: filtering.global,
-      setValue: setGlobalFilter,
-      clear: clearFilter,
-    },
-
-    // Advanced Filtering (Filter Conditions)
-    filter: {
-      // State
-      conditions: filterHook.conditions,
-      logicalOperator: filterHook.logicalOperator,
-      isValid: filterHook.isValid,
-      validationErrors: filterHook.validationErrors,
-      hasConditions: filterHook.hasConditions,
-
-      // Condition Management
-      addCondition: filterHook.addCondition,
-      updateCondition: filterHook.updateCondition,
-      removeCondition: filterHook.removeCondition,
-      clearConditions: filterHook.clearConditions,
-      getCondition: filterHook.getCondition,
-
-      // Logical Operator
-      setLogicalOperator: filterHook.setLogicalOperator,
-
-      // Bulk Operations
-      setConditions: filterHook.setConditions,
-      replaceCondition: filterHook.replaceCondition,
-
-      // Validation
-      validateCondition: filterHook.validateCondition,
-      validateAllConditions: filterHook.validateAllConditions,
-
-      // State Management
-      exportState: filterHook.exportState,
-      importState: filterHook.importState,
-      resetToInitial: filterHook.resetToInitial,
-
-      // Utilities
-      getConditionCount: filterHook.getConditionCount,
-    },
+    // Filter (Simplified chainable API)
+    filter,
 
     // Pagination (Flat Access)
     pagination: {
-      currentPage: pagination.pageNo, // Already 1-indexed
+      currentPage: pagination.pageNo,
       pageSize: pagination.pageSize,
       totalPages,
       totalItems,

package/sdk/types/common.ts

@@ -15,18 +15,20 @@ export type SortOption = Record<string, SortDirection>;
 export type Sort = SortOption[];
 
 /**
- * Filter operators for individual conditions (leaf nodes)
+ * Condition operators for individual conditions (leaf nodes)
+ * Used in Condition.Operator
  */
-export type FilterOperator =
+export type ConditionOperator =
   | "EQ" | "NE" | "GT" | "GTE" | "LT" | "LTE"
   | "Between" | "NotBetween" | "IN" | "NIN"
   | "Empty" | "NotEmpty" | "Contains" | "NotContains"
   | "MinLength" | "MaxLength";
 
 /**
- * Logical operators for combining filter conditions (tree nodes)
+ * Operators for combining conditions in a group (tree nodes)
+ * Used in ConditionGroup.Operator
  */
-export type LogicalOperator = "And" | "Or" | "Not";
+export type ConditionGroupOperator = "And" | "Or" | "Not";
 
 /**
  * RHS value type for filter conditions
@@ -34,19 +36,13 @@ export type LogicalOperator = "And" | "Or" | "Not";
 export type FilterRHSType = "Constant" | "BOField" | "AppVariable";
 
 /**
- * Base interface for all filter nodes
+ * Leaf condition (actual field comparison)
  */
-interface FilterNodeBase {
-  /** Operator type */
-  Operator: FilterOperator | LogicalOperator;
-}
-
-/**
- * Leaf filter condition (actual field comparison)
- */
-export interface FilterCondition extends FilterNodeBase {
+export interface Condition {
+  /** Optional ID for hook state management (omitted in API payload) */
+  id?: string;
   /** Condition operator */
-  Operator: FilterOperator;
+  Operator: ConditionOperator;
   /** Left-hand side field name */
   LHSField: string;
   /** Right-hand side value */
@@ -56,25 +52,45 @@ export interface FilterCondition extends FilterNodeBase {
 }
 
 /**
- * Logical filter node (combines multiple conditions)
+ * Group combining conditions (recursive structure)
  */
-export interface FilterLogical extends FilterNodeBase {
-  /** Logical operator */
-  Operator: LogicalOperator;
-  /** Nested conditions (can be FilterCondition or FilterLogical) */
-  Condition: Array<FilterCondition | FilterLogical>;
+export interface ConditionGroup {
+  /** Optional ID for hook state management (omitted in API payload) */
+  id?: string;
+  /** Group operator (And, Or, Not) */
+  Operator: ConditionGroupOperator;
+  /** Nested conditions (can be Condition or ConditionGroup) */
+  Condition: Array<Condition | ConditionGroup>;
 }
 
 /**
- * Filter structure matching API specification (root level)
- * This is a discriminated union - a filter is either a logical node or a condition
+ * Root filter type (alias for ConditionGroup)
+ */
+export type Filter = ConditionGroup;
+
+// ============================================================
+// LEGACY TYPE ALIASES (for backwards compatibility)
+// ============================================================
+
+/**
+ * @deprecated Use `Condition` instead
+ */
+export type FilterCondition = Condition;
+
+/**
+ * @deprecated Use `ConditionGroup` instead
+ */
+export type FilterLogical = ConditionGroup;
+
+/**
+ * @deprecated Use `ConditionGroupOperator` instead
  */
-export type Filter = FilterLogical;
+export type FilterOperator = ConditionGroupOperator;
 
 /**
- * Convenience type for any filter node (leaf or logical)
+ * @deprecated Use `Condition | ConditionGroup` instead
  */
-export type FilterNode = FilterCondition | FilterLogical;
+export type FilterNode = Condition | ConditionGroup;
 
 /**
  * DateTime encoding format used by the API

package/dist/components/hooks/useFilter/payloadBuilder.utils.d.ts

@@ -1,33 +0,0 @@
-import type { Filter, LogicalOperator } from "../../../types/common";
-import type { FilterConditionWithId, FilterState } from "../useFilter";
-/**
- * Build SDK Filter payload from filter state
- * Returns undefined if no valid conditions exist
- * Supports both flat and nested filter structures
- */
-export declare const buildFilterPayload: (conditions: FilterConditionWithId[], logicalOperator: LogicalOperator) => Filter | undefined;
-/**
- * Build filter payload from complete filter state
- */
-export declare const buildFilterPayloadFromState: (state: FilterState) => Filter | undefined;
-/**
- * Validate that a filter payload is well-formed (supports nested filters)
- */
-export declare const validateFilterPayload: (filter: Filter | undefined) => boolean;
-/**
- * Deep clone a filter payload (supports nested filters)
- */
-export declare const cloneFilterPayload: (filter: Filter | undefined) => Filter | undefined;
-/**
- * Merge multiple filter payloads with a logical operator
- */
-export declare const mergeFilterPayloads: (filters: (Filter | undefined)[], operator: LogicalOperator) => Filter | undefined;
-/**
- * Convert filter payload to a human-readable string for debugging (supports nested filters)
- */
-export declare const filterPayloadToString: (filter: Filter | undefined) => string;
-/**
- * Check if two filter payloads are equivalent (supports nested filters)
- */
-export declare const areFilterPayloadsEqual: (filter1: Filter | undefined, filter2: Filter | undefined) => boolean;
-//# sourceMappingURL=payloadBuilder.utils.d.ts.map

package/dist/components/hooks/useFilter/payloadBuilder.utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"payloadBuilder.utils.d.ts","sourceRoot":"","sources":["../../../../sdk/components/hooks/useFilter/payloadBuilder.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAkC,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACrG,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAqCvE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,YAAY,qBAAqB,EAAE,EACnC,iBAAiB,eAAe,KAC/B,MAAM,GAAG,SAmBX,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,GAAI,OAAO,WAAW,KAAG,MAAM,GAAG,SAEzE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,GAAG,SAAS,KAAG,OAwClE,CAAC;AAwBF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,SASxE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,EAC/B,UAAU,eAAe,KACxB,MAAM,GAAG,SAoBX,CAAC;AA6BF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,GAAG,SAAS,KAAG,MAYlE,CAAC;AAyCF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,MAAM,GAAG,SAAS,EAC3B,SAAS,MAAM,GAAG,SAAS,KAC1B,OAyBF,CAAC"}

package/dist/components/hooks/useFilter/validation.utils.d.ts

@@ -1,38 +0,0 @@
-import type { FilterOperator } from "../../../types/common";
-import type { FieldDefinition, ValidationResult } from "../useFilter";
-/**
- * Validate number values based on operator
- */
-export declare const validateNumberValue: (value: any, operator: FilterOperator) => ValidationResult;
-/**
- * Validate date values based on operator
- */
-export declare const validateDateValue: (value: any, operator: FilterOperator) => ValidationResult;
-/**
- * Validate currency values based on operator
- */
-export declare const validateCurrencyValue: (value: any, operator: FilterOperator) => ValidationResult;
-/**
- * Validate string values based on operator
- */
-export declare const validateStringValue: (value: any, operator: FilterOperator) => ValidationResult;
-/**
- * Validate boolean values based on operator
- */
-export declare const validateBooleanValue: (value: any, operator: FilterOperator) => ValidationResult;
-/**
- * Validate select field values based on operator and available options
- */
-export declare const validateSelectValue: (value: any, operator: FilterOperator, selectOptions?: Array<{
-    label: string;
-    value: any;
-}>) => ValidationResult;
-/**
- * Get default field definition based on field type
- */
-export declare const getDefaultFieldDefinition: (fieldType: FieldDefinition["type"]) => FieldDefinition;
-/**
- * Create field definitions from sample data
- */
-export declare const createFieldDefinitionsFromSample: <T>(sampleData: T) => Record<keyof T, FieldDefinition>;
-//# sourceMappingURL=validation.utils.d.ts.map

package/dist/components/hooks/useFilter/validation.utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.utils.d.ts","sourceRoot":"","sources":["../../../../sdk/components/hooks/useFilter/validation.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAMtE;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,GAAG,EAAE,UAAU,cAAc,KAAG,gBAwC1E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,GAAG,EAAE,UAAU,cAAc,KAAG,gBAqDxE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,GAAG,EAAE,UAAU,cAAc,KAAG,gBAmD5E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,GAAG,EAAE,UAAU,cAAc,KAAG,gBA+C1E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,GAAG,EAAE,UAAU,cAAc,KAAG,gBAkC3E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,GAAG,EACV,UAAU,cAAc,EACxB,gBAAgB,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,CAAC,KACnD,gBA2CF,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,WAAW,eAAe,CAAC,MAAM,CAAC,KAAG,eAmD9E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gCAAgC,GAAI,CAAC,EAAE,YAAY,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,CA4BlG,CAAC"}