@ram_28/kf-ai-sdk 1.0.28 → 1.0.30

package/dist/types/base-fields.d.ts

@@ -71,30 +71,32 @@ export interface DateEncodedType {
 export interface DateTimeEncodedType {
     $__dt__: number;
 }
+type Year = `${number}${number}${number}${number}`;
+type Month = `0${1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9}` | `1${0 | 1 | 2}`;
+type Day = `${0}${1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9}` | `${1 | 2}${number}` | `3${0 | 1}`;
 /**
  * Date field (date only, no time)
- * API Response Format: { "$__d__": "YYYY-MM-DD" }
  * API Request Format: "YYYY-MM-DD"
  * Storage: DATE in database
- * Use this for birth dates, due dates, calendar events
  *
  * @example
  * // Response from API:
- * { "$__d__": "2025-03-15" }
+ * "2025-05-01"
  */
-export type DateFieldType = DateEncodedType;
+export type DateFieldType = `${Year}-${Month}-${Day}`;
+type Hour = number;
+type Minute = number;
+type Second = number;
 /**
  * DateTime field (date and time)
- * API Response Format: { "$__dt__": unix_timestamp_seconds }
  * API Request Format: "YYYY-MM-DD HH:MM:SS"
- * Storage: DATETIME/TIMESTAMP in database
  * Use this for created_at, updated_at, event timestamps
  *
  * @example
  * // Response from API:
- * { "$__dt__": 1769110463 }
+ * "2026-01-23T01:21:33"
  */
-export type DateTimeFieldType = DateTimeEncodedType;
+export type DateTimeFieldType = `${Year}-${Month}-${Day}T${Hour}:${Minute}:${Second}`;
 /**
  * Currency field supporting multiple value formats
  * Resolves to: CurrencyValueType
@@ -233,4 +235,5 @@ export type OptionalFieldType<T> = T | undefined;
  * Useful for runtime validation and type guards
  */
 export type ExtractFieldTypeType<T> = T extends OptionalFieldType<infer U> ? U : T;
+export {};
 //# sourceMappingURL=base-fields.d.ts.map

package/dist/types/base-fields.d.ts.map

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

package/package.json

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

package/sdk/types/base-fields.ts

@@ -83,31 +83,43 @@ export interface DateTimeEncodedType {
   $__dt__: number;
 }
 
+type Year = `${number}${number}${number}${number}`;
+type Month = `0${1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9}` | `1${0 | 1 | 2}`;
+type Day =
+  | `${0}${1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9}`
+  | `${1 | 2}${number}`
+  | `3${0 | 1}`;
+
 /**
  * Date field (date only, no time)
- * API Response Format: { "$__d__": "YYYY-MM-DD" }
  * API Request Format: "YYYY-MM-DD"
  * Storage: DATE in database
- * Use this for birth dates, due dates, calendar events
  *
  * @example
  * // Response from API:
- * { "$__d__": "2025-03-15" }
+ * "2025-05-01"
  */
-export type DateFieldType = DateEncodedType;
+
+export type DateFieldType = `${Year}-${Month}-${Day}`;
+
+type Hour = number;
+type Minute = number;
+type Second = number;
 
 /**
  * DateTime field (date and time)
- * API Response Format: { "$__dt__": unix_timestamp_seconds }
  * API Request Format: "YYYY-MM-DD HH:MM:SS"
- * Storage: DATETIME/TIMESTAMP in database
  * Use this for created_at, updated_at, event timestamps
  *
  * @example
  * // Response from API:
- * { "$__dt__": 1769110463 }
+ * "2026-01-23T01:21:33"
  */
-export type DateTimeFieldType = DateTimeEncodedType;
+
+export type DateTimeFieldType =
+  `${Year}-${Month}-${Day}T${Hour}:${Minute}:${Second}`;
+
+// export type DateTimeFieldType = string;
 
 // ============================================================
 // COMPLEX FIELD TYPES
@@ -181,10 +193,9 @@ export type ExtractReferenceType<T> = T extends { _id: string } ? T : never;
  * type CategoryOptions = ExtractFetchFieldType<BaseProductType["Category"]>;
  * // Result: { Value: string; Label: string } (string has no _id)
  */
-export type ExtractFetchFieldType<T> =
-  T extends { _id: string }
-    ? T
-    : { Value: string; Label: string };
+export type ExtractFetchFieldType<T> = T extends { _id: string }
+  ? T
+  : { Value: string; Label: string };
 
 /**
  * Valid JSON value types
@@ -220,7 +231,8 @@ export type SelectFieldType<T extends string> = T;
  * @template TReferencedType - The full type of the referenced BDO record
  * @deprecated Use ReferenceFieldType instead
  */
-export type LookupFieldType<TReferencedType = unknown> = ReferenceFieldType<TReferencedType>;
+export type LookupFieldType<TReferencedType = unknown> =
+  ReferenceFieldType<TReferencedType>;
 
 // ============================================================
 // CONTAINER AND UTILITY TYPES
@@ -272,4 +284,5 @@ export type OptionalFieldType<T> = T | undefined;
  * Utility type to extract the base type from a field type
  * Useful for runtime validation and type guards
  */
-export type ExtractFieldTypeType<T> = T extends OptionalFieldType<infer U> ? U : T;
+export type ExtractFieldTypeType<T> =
+  T extends OptionalFieldType<infer U> ? U : T;

package/docs/QUICK_REFERENCE.md

@@ -1,274 +0,0 @@
-# KF AI SDK - Quick Reference
-
-Quick reference for common operations. See individual hook docs for detailed examples.
-
-## Installation
-
-```bash
-npm install @ram_28/kf-ai-sdk
-```
-
-```typescript
-import { setApiBaseUrl } from "@ram_28/kf-ai-sdk/api";
-setApiBaseUrl("https://api.your-domain.com");
-```
-
----
-
-## useTable
-
-[Full Documentation](./useTable.md)
-
-```typescript
-import { useTable } from "@ram_28/kf-ai-sdk/table";
-
-const table = useTable<Product>({
-  source: "BDO_Products",
-  columns: [
-    { fieldId: "Title", enableSorting: true },
-    { fieldId: "Price", enableSorting: true },
-  ],
-  initialState: {
-    pagination: { pageNo: 1, pageSize: 10 },
-  },
-});
-```
-
-| Property | Description |
-|----------|-------------|
-| `table.rows` | Current data |
-| `table.isLoading` | Loading state |
-| `table.search.setQuery(q)` | Set search |
-| `table.sort.toggle(field)` | Toggle sort |
-| `table.filter.addCondition({...})` | Add filter |
-| `table.pagination.goToNext()` | Next page |
-
----
-
-## useForm
-
-[Full Documentation](./useForm.md)
-
-```typescript
-import { useForm } from "@ram_28/kf-ai-sdk/form";
-
-const form = useForm<Product>({
-  source: "BDO_Products",
-  operation: "create", // or "update"
-  recordId: "...",     // for update
-});
-```
-
-| Property | Description |
-|----------|-------------|
-| `form.register(field)` | Register input |
-| `form.handleSubmit(onSuccess, onError)` | Submit handler |
-| `form.errors` | Validation errors |
-| `form.isValid` | Form validity |
-| `form.getField(name)` | Field metadata |
-| `form.watch(field)` | Watch value |
-
----
-
-## useKanban
-
-[Full Documentation](./useKanban.md)
-
-```typescript
-import { useKanban } from "@ram_28/kf-ai-sdk/kanban";
-
-const kanban = useKanban<TaskData>({
-  source: "BDO_Tasks",
-  columns: [
-    { id: "todo", title: "To Do", position: 0 },
-    { id: "done", title: "Done", position: 1 },
-  ],
-  enableDragDrop: true,
-});
-```
-
-| Property | Description |
-|----------|-------------|
-| `kanban.columns` | Columns with cards |
-| `kanban.createCard({...})` | Create card |
-| `kanban.moveCard(id, columnId)` | Move card |
-| `kanban.getCardProps(card)` | Drag props |
-| `kanban.filter.addCondition({...})` | Filter cards |
-
----
-
-## useFilter
-
-[Full Documentation](./useFilter.md)
-
-```typescript
-import { useFilter, isCondition, isConditionGroup } from "@ram_28/kf-ai-sdk/filter";
-
-const filter = useFilter({
-  initialOperator: "And",
-});
-```
-
-| Property | Description |
-|----------|-------------|
-| `filter.addCondition({...})` | Add condition |
-| `filter.addConditionGroup(op)` | Add group |
-| `filter.clearAllConditions()` | Clear all |
-| `filter.payload` | API-ready payload |
-| `filter.hasConditions` | Has filters |
-
-### Operators
-
-| Operator | Description |
-|----------|-------------|
-| `EQ`, `NE` | Equal, Not Equal |
-| `GT`, `GTE`, `LT`, `LTE` | Comparisons |
-| `Between`, `NotBetween` | Range |
-| `IN`, `NIN` | List match |
-| `Contains`, `NotContains` | Text search |
-| `Empty`, `NotEmpty` | Null check |
-
----
-
-## useAuth
-
-[Full Documentation](./useAuth.md)
-
-```typescript
-import { useAuth, AuthProvider } from "@ram_28/kf-ai-sdk/auth";
-
-// Wrap app
-<AuthProvider config={{ sessionEndpoint: "/api/id" }}>
-  <App />
-</AuthProvider>
-
-// Use in components
-const auth = useAuth();
-```
-
-| Property | Description |
-|----------|-------------|
-| `auth.user` | Current user |
-| `auth.isAuthenticated` | Auth status |
-| `auth.login(provider?)` | Sign in |
-| `auth.logout()` | Sign out |
-| `auth.hasRole(role)` | Check role |
-| `auth.hasAnyRole(roles)` | Check roles |
-
----
-
-## Common Patterns
-
-### Filter by Category
-
-```typescript
-table.filter.clearAllConditions();
-table.filter.addCondition({
-  Operator: "EQ",
-  LHSField: "Category",
-  RHSValue: "Electronics",
-});
-```
-
-### Filter by Date Range
-
-```typescript
-table.filter.addCondition({
-  Operator: "Between",
-  LHSField: "CreatedAt",
-  RHSValue: [startDate, endDate],
-});
-```
-
-### My Tasks Filter
-
-```typescript
-table.filter.addCondition({
-  Operator: "EQ",
-  LHSField: "AssignedTo",
-  RHSValue: currentUserId,
-});
-```
-
-### Sortable Column Header
-
-```typescript
-<th onClick={() => table.sort.toggle("Price")}>
-  Price {table.sort.field === "Price" && (table.sort.direction === "asc" ? "↑" : "↓")}
-</th>
-```
-
-### Pagination Controls
-
-```typescript
-<button onClick={table.pagination.goToPrevious} disabled={!table.pagination.canGoPrevious}>
-  Previous
-</button>
-<span>Page {table.pagination.pageNo} of {table.pagination.totalPages}</span>
-<button onClick={table.pagination.goToNext} disabled={!table.pagination.canGoNext}>
-  Next
-</button>
-```
-
-### Protected Route
-
-```typescript
-function ProtectedRoute({ children }) {
-  const auth = useAuth();
-  if (auth.isLoading) return <div>Loading...</div>;
-  if (!auth.isAuthenticated) return <div>Please sign in</div>;
-  return children;
-}
-```
-
-### Role-Based UI
-
-```typescript
-{auth.hasRole("Admin") && <AdminPanel />}
-{auth.hasAnyRole(["Seller", "Admin"]) && <ProductManagement />}
-```
-
----
-
-## Date Handling
-
-### Display Encoded Date
-```typescript
-import { decodeDate } from "@ram_28/kf-ai-sdk/api";
-import { formatDate } from "@ram_28/kf-ai-sdk/utils";
-
-const readable = formatDate(decodeDate(record.OrderDate), 'medium');
-// => "Mar 15, 2025"
-```
-
-### Display Timestamp
-```typescript
-import { decodeDateTime } from "@ram_28/kf-ai-sdk/api";
-import { formatDateTime } from "@ram_28/kf-ai-sdk/utils";
-
-const readable = formatDateTime(decodeDateTime(record._created_at), 'medium');
-// => "Mar 15, 2025, 10:30:45 AM"
-```
-
-[Full Documentation](./datetime.md)
-
----
-
-## Type Imports
-
-```typescript
-// Table
-import type { UseTableOptionsType, UseTableReturnType, ColumnDefinitionType } from "@ram_28/kf-ai-sdk/table/types";
-
-// Form
-import type { UseFormOptionsType, UseFormReturnType, FormFieldConfigType } from "@ram_28/kf-ai-sdk/form/types";
-
-// Kanban
-import type { UseKanbanOptionsType, UseKanbanReturnType, KanbanCardType, ColumnConfigType } from "@ram_28/kf-ai-sdk/kanban/types";
-
-// Filter
-import type { ConditionType, ConditionGroupType, ConditionOperatorType, FilterType } from "@ram_28/kf-ai-sdk/filter/types";
-
-// Auth
-import type { UseAuthReturnType, UserDetailsType, AuthStatusType } from "@ram_28/kf-ai-sdk/auth/types";
-```

package/docs/datetime.md

@@ -1,144 +0,0 @@
-# Date & DateTime Handling
-
-Working with Date and DateTime fields in the SDK.
-
-## API Response Format
-
-The backend returns dates in encoded format:
-- **Date**: `{ "$__d__": "YYYY-MM-DD" }`
-- **DateTime**: `{ "$__dt__": unix_timestamp_seconds }`
-
-## Imports
-
-```typescript
-// Decoding & formatting for API
-import {
-  decodeDate,
-  decodeDateTime,
-  formatDate,
-  formatDateTime,
-  parseDate,
-  parseDateTime,
-} from "@ram_28/kf-ai-sdk/api";
-
-// UI display formatting
-import {
-  formatDate,
-  formatDateTime
-} from "@ram_28/kf-ai-sdk/utils";
-```
-
-## Decoding API Responses
-
-Convert encoded dates to JavaScript Date objects.
-
-### decodeDate
-```typescript
-const apiResponse = { "$__d__": "2025-03-15" };
-const date = decodeDate(apiResponse);
-// => Date object for March 15, 2025
-```
-
-### decodeDateTime
-```typescript
-const apiResponse = { "$__dt__": 1769110463 };
-const date = decodeDateTime(apiResponse);
-// => Date object with full timestamp
-```
-
-## Formatting for API Requests
-
-Convert Date objects to strings the API expects.
-
-### formatDate (API)
-```typescript
-import { formatDate } from "@ram_28/kf-ai-sdk/api";
-
-const date = new Date(2025, 2, 15);
-formatDate(date); // => "2025-03-15"
-```
-
-### formatDateTime (API)
-```typescript
-import { formatDateTime } from "@ram_28/kf-ai-sdk/api";
-
-const date = new Date(2025, 2, 15, 10, 30, 45);
-formatDateTime(date); // => "2025-03-15 10:30:45"
-```
-
-## Formatting for UI Display
-
-Convert Date objects to human-readable strings.
-
-### formatDate (UI)
-```typescript
-import { formatDate } from "@ram_28/kf-ai-sdk/utils";
-
-const date = new Date(2025, 2, 15);
-formatDate(date, 'short');  // => "3/15/25"
-formatDate(date, 'medium'); // => "Mar 15, 2025"
-formatDate(date, 'long');   // => "March 15, 2025"
-```
-
-### formatDateTime (UI)
-```typescript
-import { formatDateTime } from "@ram_28/kf-ai-sdk/utils";
-
-const date = new Date(2025, 2, 15, 10, 30, 45);
-formatDateTime(date, 'short');  // => "3/15/25, 10:30 AM"
-formatDateTime(date, 'medium'); // => "Mar 15, 2025, 10:30:45 AM"
-formatDateTime(date, 'long');   // => "March 15, 2025 at 10:30:45 AM"
-```
-
-## Common Patterns
-
-### Display a date from API response
-```typescript
-import { decodeDate } from "@ram_28/kf-ai-sdk/api";
-import { formatDate } from "@ram_28/kf-ai-sdk/utils";
-
-function displayDate(encodedDate: { $__d__: string }) {
-  const date = decodeDate(encodedDate);
-  return formatDate(date, 'medium');
-}
-
-// Usage in component
-<span>{displayDate(record.OrderDate)}</span>
-```
-
-### Display created/modified timestamps
-```typescript
-import { decodeDateTime } from "@ram_28/kf-ai-sdk/api";
-import { formatDateTime } from "@ram_28/kf-ai-sdk/utils";
-
-function displayTimestamp(encodedDateTime: { $__dt__: number }) {
-  const date = decodeDateTime(encodedDateTime);
-  return formatDateTime(date, 'medium');
-}
-
-// Usage
-<span>Created: {displayTimestamp(record._created_at)}</span>
-<span>Modified: {displayTimestamp(record._modified_at)}</span>
-```
-
-### Submit a date to the API
-```typescript
-import { formatDate } from "@ram_28/kf-ai-sdk/api";
-
-// From a date picker value
-const datePickerValue = "2025-03-15"; // HTML date input value
-// Already in correct format, use directly
-
-// From a Date object
-const dateObj = new Date();
-const apiValue = formatDate(dateObj); // => "2025-03-15"
-```
-
-## Type Definitions
-
-```typescript
-import type {
-  DateEncodedType,      // { $__d__: string }
-  DateTimeEncodedType,  // { $__dt__: number }
-} from "@ram_28/kf-ai-sdk/api";
-```