@ram_28/kf-ai-sdk 1.0.10 → 1.0.12

package/package.json

@@ -1,22 +1,160 @@
 {
   "name": "@ram_28/kf-ai-sdk",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "Type-safe, AI-driven SDK for building modern web applications with role-based access control",
   "author": "Ramprasad",
   "license": "MIT",
   "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
+  "sideEffects": false,
   "exports": {
-    ".": {
+    "./form": {
       "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.mjs"
+        "types": "./dist/form.d.ts",
+        "default": "./dist/form.mjs"
       },
       "require": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.cjs"
+        "types": "./dist/form.d.ts",
+        "default": "./dist/form.cjs"
+      }
+    },
+    "./form/types": {
+      "import": {
+        "types": "./dist/form.types.d.ts",
+        "default": "./dist/form.types.mjs"
+      },
+      "require": {
+        "types": "./dist/form.types.d.ts",
+        "default": "./dist/form.types.cjs"
+      }
+    },
+    "./table": {
+      "import": {
+        "types": "./dist/table.d.ts",
+        "default": "./dist/table.mjs"
+      },
+      "require": {
+        "types": "./dist/table.d.ts",
+        "default": "./dist/table.cjs"
+      }
+    },
+    "./table/types": {
+      "import": {
+        "types": "./dist/table.types.d.ts",
+        "default": "./dist/table.types.mjs"
+      },
+      "require": {
+        "types": "./dist/table.types.d.ts",
+        "default": "./dist/table.types.cjs"
+      }
+    },
+    "./kanban": {
+      "import": {
+        "types": "./dist/kanban.d.ts",
+        "default": "./dist/kanban.mjs"
+      },
+      "require": {
+        "types": "./dist/kanban.d.ts",
+        "default": "./dist/kanban.cjs"
+      }
+    },
+    "./kanban/types": {
+      "import": {
+        "types": "./dist/kanban.types.d.ts",
+        "default": "./dist/kanban.types.mjs"
+      },
+      "require": {
+        "types": "./dist/kanban.types.d.ts",
+        "default": "./dist/kanban.types.cjs"
+      }
+    },
+    "./kanban/ui": {
+      "import": {
+        "types": "./dist/kanban.ui.d.ts",
+        "default": "./dist/kanban.ui.mjs"
+      },
+      "require": {
+        "types": "./dist/kanban.ui.d.ts",
+        "default": "./dist/kanban.ui.cjs"
+      }
+    },
+    "./filter": {
+      "import": {
+        "types": "./dist/filter.d.ts",
+        "default": "./dist/filter.mjs"
+      },
+      "require": {
+        "types": "./dist/filter.d.ts",
+        "default": "./dist/filter.cjs"
+      }
+    },
+    "./filter/types": {
+      "import": {
+        "types": "./dist/filter.types.d.ts",
+        "default": "./dist/filter.types.mjs"
+      },
+      "require": {
+        "types": "./dist/filter.types.d.ts",
+        "default": "./dist/filter.types.cjs"
+      }
+    },
+    "./auth": {
+      "import": {
+        "types": "./dist/auth.d.ts",
+        "default": "./dist/auth.mjs"
+      },
+      "require": {
+        "types": "./dist/auth.d.ts",
+        "default": "./dist/auth.cjs"
+      }
+    },
+    "./auth/types": {
+      "import": {
+        "types": "./dist/auth.types.d.ts",
+        "default": "./dist/auth.types.mjs"
+      },
+      "require": {
+        "types": "./dist/auth.types.d.ts",
+        "default": "./dist/auth.types.cjs"
+      }
+    },
+    "./api": {
+      "import": {
+        "types": "./dist/api.d.ts",
+        "default": "./dist/api.mjs"
+      },
+      "require": {
+        "types": "./dist/api.d.ts",
+        "default": "./dist/api.cjs"
+      }
+    },
+    "./api/types": {
+      "import": {
+        "types": "./dist/api.types.d.ts",
+        "default": "./dist/api.types.mjs"
+      },
+      "require": {
+        "types": "./dist/api.types.d.ts",
+        "default": "./dist/api.types.cjs"
+      }
+    },
+    "./utils": {
+      "import": {
+        "types": "./dist/utils.d.ts",
+        "default": "./dist/utils.mjs"
+      },
+      "require": {
+        "types": "./dist/utils.d.ts",
+        "default": "./dist/utils.cjs"
+      }
+    },
+    "./types": {
+      "import": {
+        "types": "./dist/base-types.d.ts",
+        "default": "./dist/types.mjs"
+      },
+      "require": {
+        "types": "./dist/base-types.d.ts",
+        "default": "./dist/types.cjs"
       }
     }
   },

package/sdk/api/client.ts

@@ -3,22 +3,22 @@
 // ============================================================
 
 import type {
-  ListOptions,
-  ListResponse,
-  ReadResponse,
-  CreateUpdateResponse,
-  DeleteResponse,
-  CountResponse,
-  DateTimeEncoded,
-  DateEncoded,
-  MetricOptions,
-  MetricResponse,
-  PivotOptions,
-  PivotResponse,
-  DraftResponse,
-  FieldsResponse,
-  FetchFieldOption,
-  FetchFieldResponse,
+  ListOptionsType,
+  ListResponseType,
+  ReadResponseType,
+  CreateUpdateResponseType,
+  DeleteResponseType,
+  CountResponseType,
+  DateTimeEncodedType,
+  DateEncodedType,
+  MetricOptionsType,
+  MetricResponseType,
+  PivotOptionsType,
+  PivotResponseType,
+  DraftResponseType,
+  FieldsResponseType,
+  FetchFieldOptionType,
+  FetchFieldResponseType,
 } from "../types/common";
 
 /**
@@ -33,19 +33,19 @@ export interface ResourceClient<T = any> {
   get(id: string): Promise<T>;
 
   /** Create new record */
-  create(data: Partial<T> & { _id?: string }): Promise<CreateUpdateResponse>;
+  create(data: Partial<T> & { _id?: string }): Promise<CreateUpdateResponseType>;
 
   /** Update existing record */
-  update(id: string, data: Partial<T>): Promise<CreateUpdateResponse>;
+  update(id: string, data: Partial<T>): Promise<CreateUpdateResponseType>;
 
   /** Delete record by ID */
-  delete(id: string): Promise<DeleteResponse>;
+  delete(id: string): Promise<DeleteResponseType>;
 
   /** List records with optional filtering, sorting, and pagination */
-  list(options?: ListOptions): Promise<ListResponse<T>>;
+  list(options?: ListOptionsType): Promise<ListResponseType<T>>;
 
   /** Get count of records matching the same criteria as list */
-  count(options?: ListOptions): Promise<CountResponse>;
+  count(options?: ListOptionsType): Promise<CountResponseType>;
 
   // ============================================================
   // DRAFT/INTERACTIVE OPERATIONS
@@ -55,19 +55,28 @@ export interface ResourceClient<T = any> {
    * Create draft - compute fields without persisting
    * POST /{bo_id}/draft
    */
-  draft(data: Partial<T>): Promise<DraftResponse>;
+  draft(data: Partial<T>): Promise<DraftResponseType>;
 
   /**
    * Update draft (commit) - compute and prepare for update
    * POST /{bo_id}/{instance_id}/draft
    */
-  draftUpdate(id: string, data: Partial<T>): Promise<CreateUpdateResponse>;
+  draftUpdate(id: string, data: Partial<T>): Promise<CreateUpdateResponseType>;
 
   /**
    * Update draft (patch) - compute fields during editing
    * PATCH /{bo_id}/{instance_id}/draft
    */
-  draftPatch(id: string, data: Partial<T>): Promise<DraftResponse>;
+  draftPatch(id: string, data: Partial<T>): Promise<DraftResponseType>;
+
+  /**
+   * Interactive draft - create/update draft without instance ID
+   * PATCH /{bo_id}/draft
+   * Used in interactive mode for create operations
+   */
+  draftInteraction(
+    data: Partial<T> & { _id?: string }
+  ): Promise<DraftResponseType & { _id: string }>;
 
   // ============================================================
   // QUERY OPERATIONS
@@ -77,13 +86,13 @@ export interface ResourceClient<T = any> {
    * Get aggregated metrics grouped by dimensions
    * POST /{bo_id}/metric
    */
-  metric(options: Omit<MetricOptions, "Type">): Promise<MetricResponse>;
+  metric(options: Omit<MetricOptionsType, "Type">): Promise<MetricResponseType>;
 
   /**
    * Get pivot table data
    * POST /{bo_id}/pivot
    */
-  pivot(options: Omit<PivotOptions, "Type">): Promise<PivotResponse>;
+  pivot(options: Omit<PivotOptionsType, "Type">): Promise<PivotResponseType>;
 
   // ============================================================
   // METADATA OPERATIONS
@@ -93,13 +102,13 @@ export interface ResourceClient<T = any> {
    * Get field definitions for this Business Object
    * GET /{bo_id}/fields
    */
-  fields(): Promise<FieldsResponse>;
+  fields(): Promise<FieldsResponseType>;
 
   /**
    * Fetch reference data for a specific field (for lookup and dropdown fields)
    * GET /{bo_id}/{instance_id}/field/{field_id}/fetch
    */
-  fetchField(instanceId: string, fieldId: string): Promise<FetchFieldOption[]>;
+  fetchField(instanceId: string, fieldId: string): Promise<FetchFieldOptionType[]>;
 }
 
 /**
@@ -163,12 +172,12 @@ function decodeResponseData<T>(data: any): T {
   if (typeof data === "object") {
     // Check for datetime encoding
     if ("$__dt__" in data) {
-      return new Date((data as DateTimeEncoded).$__dt__ * 1000) as T;
+      return new Date((data as DateTimeEncodedType).$__dt__ * 1000) as T;
     }
 
     // Check for date encoding
     if ("$__d__" in data) {
-      return new Date((data as DateEncoded).$__d__) as T;
+      return new Date((data as DateEncodedType).$__d__) as T;
     }
 
     // Recursively process object properties
@@ -202,13 +211,13 @@ export function api<T = any>(bo_id: string): ResourceClient<T> {
         throw new Error(`Failed to get ${bo_id} ${id}: ${response.statusText}`);
       }
 
-      const responseData: ReadResponse<T> = await response.json();
+      const responseData: ReadResponseType<T> = await response.json();
       return decodeResponseData<T>(responseData.Data);
     },
 
     async create(
       data: Partial<T> & { _id?: string }
-    ): Promise<CreateUpdateResponse> {
+    ): Promise<CreateUpdateResponseType> {
       const response = await fetch(`${baseUrl}/api/app/${bo_id}/create`, {
         method: "POST",
         headers: defaultHeaders,
@@ -222,7 +231,7 @@ export function api<T = any>(bo_id: string): ResourceClient<T> {
       return response.json();
     },
 
-    async update(id: string, data: Partial<T>): Promise<CreateUpdateResponse> {
+    async update(id: string, data: Partial<T>): Promise<CreateUpdateResponseType> {
       const response = await fetch(`${baseUrl}/api/app/${bo_id}/${id}/update`, {
         method: "POST",
         headers: defaultHeaders,
@@ -238,7 +247,7 @@ export function api<T = any>(bo_id: string): ResourceClient<T> {
       return response.json();
     },
 
-    async delete(id: string): Promise<DeleteResponse> {
+    async delete(id: string): Promise<DeleteResponseType> {
       const response = await fetch(`${baseUrl}/api/app/${bo_id}/${id}/delete`, {
         method: "DELETE",
         headers: defaultHeaders,
@@ -253,8 +262,8 @@ export function api<T = any>(bo_id: string): ResourceClient<T> {
       return response.json();
     },
 
-    async list(options?: ListOptions): Promise<ListResponse<T>> {
-      const requestBody: ListOptions = {
+    async list(options?: ListOptionsType): Promise<ListResponseType<T>> {
+      const requestBody: ListOptionsType = {
         Type: "List",
         ...options,
       };
@@ -269,13 +278,13 @@ export function api<T = any>(bo_id: string): ResourceClient<T> {
         throw new Error(`Failed to list ${bo_id}: ${response.statusText}`);
       }
 
-      const responseData: ListResponse<any> = await response.json();
+      const responseData: ListResponseType<any> = await response.json();
       return {
         Data: responseData.Data.map((item) => decodeResponseData<T>(item)),
       };
     },
 
-    async count(options?: ListOptions): Promise<CountResponse> {
+    async count(options?: ListOptionsType): Promise<CountResponseType> {
       // Note: Count uses metric endpoint with Count aggregation
       const requestBody = {
         Type: "Metric",
@@ -304,7 +313,7 @@ export function api<T = any>(bo_id: string): ResourceClient<T> {
     // DRAFT/INTERACTIVE OPERATIONS
     // ============================================================
 
-    async draft(data: Partial<T>): Promise<DraftResponse> {
+    async draft(data: Partial<T>): Promise<DraftResponseType> {
       const response = await fetch(`${baseUrl}/api/app/${bo_id}/draft`, {
         method: "POST",
         headers: defaultHeaders,
@@ -323,7 +332,7 @@ export function api<T = any>(bo_id: string): ResourceClient<T> {
     async draftUpdate(
       id: string,
       data: Partial<T>
-    ): Promise<CreateUpdateResponse> {
+    ): Promise<CreateUpdateResponseType> {
       const response = await fetch(`${baseUrl}/api/app/${bo_id}/${id}/draft`, {
         method: "POST",
         headers: defaultHeaders,
@@ -339,7 +348,7 @@ export function api<T = any>(bo_id: string): ResourceClient<T> {
       return response.json();
     },
 
-    async draftPatch(id: string, data: Partial<T>): Promise<DraftResponse> {
+    async draftPatch(id: string, data: Partial<T>): Promise<DraftResponseType> {
       const response = await fetch(`${baseUrl}/api/app/${bo_id}/${id}/draft`, {
         method: "PATCH",
         headers: defaultHeaders,
@@ -355,14 +364,32 @@ export function api<T = any>(bo_id: string): ResourceClient<T> {
       return response.json();
     },
 
+    async draftInteraction(
+      data: Partial<T> & { _id?: string }
+    ): Promise<DraftResponseType & { _id: string }> {
+      const response = await fetch(`${baseUrl}/api/app/${bo_id}/draft`, {
+        method: "PATCH",
+        headers: defaultHeaders,
+        body: JSON.stringify(data),
+      });
+
+      if (!response.ok) {
+        throw new Error(
+          `Failed to create interactive draft for ${bo_id}: ${response.statusText}`
+        );
+      }
+
+      return response.json();
+    },
+
     // ============================================================
     // QUERY OPERATIONS
     // ============================================================
 
     async metric(
-      options: Omit<MetricOptions, "Type">
-    ): Promise<MetricResponse> {
-      const requestBody: MetricOptions = {
+      options: Omit<MetricOptionsType, "Type">
+    ): Promise<MetricResponseType> {
+      const requestBody: MetricOptionsType = {
         Type: "Metric",
         ...options,
       };
@@ -382,8 +409,8 @@ export function api<T = any>(bo_id: string): ResourceClient<T> {
       return response.json();
     },
 
-    async pivot(options: Omit<PivotOptions, "Type">): Promise<PivotResponse> {
-      const requestBody: PivotOptions = {
+    async pivot(options: Omit<PivotOptionsType, "Type">): Promise<PivotResponseType> {
+      const requestBody: PivotOptionsType = {
         Type: "Pivot",
         ...options,
       };
@@ -407,7 +434,7 @@ export function api<T = any>(bo_id: string): ResourceClient<T> {
     // METADATA OPERATIONS
     // ============================================================
 
-    async fields(): Promise<FieldsResponse> {
+    async fields(): Promise<FieldsResponseType> {
       const response = await fetch(`${baseUrl}/api/app/${bo_id}/fields`, {
         method: "GET",
         headers: defaultHeaders,
@@ -425,7 +452,7 @@ export function api<T = any>(bo_id: string): ResourceClient<T> {
     async fetchField(
       instanceId: string,
       fieldId: string
-    ): Promise<FetchFieldOption[]> {
+    ): Promise<FetchFieldOptionType[]> {
       const response = await fetch(
         `${baseUrl}/api/app/${bo_id}/${instanceId}/field/${fieldId}/fetch`,
         {
@@ -440,7 +467,7 @@ export function api<T = any>(bo_id: string): ResourceClient<T> {
         );
       }
 
-      const responseData: FetchFieldResponse = await response.json();
+      const responseData: FetchFieldResponseType = await response.json();
       return responseData.Data;
     },
   };

package/sdk/api/datetime.ts

@@ -1,4 +1,4 @@
-import type { DateTimeEncoded, DateEncoded } from '../types/common';
+import type { DateTimeEncodedType, DateEncodedType } from '../types/common';
 
 /**
  * Utility functions for datetime encoding/decoding
@@ -7,27 +7,27 @@ import type { DateTimeEncoded, DateEncoded } from '../types/common';
 /**
  * Encode a Date object to API datetime format
  */
-export function encodeDatetime(date: Date): DateTimeEncoded {
+export function encodeDatetime(date: Date): DateTimeEncodedType {
   return { $__dt__: date.getTime() / 1000 };
 }
 
 /**
  * Decode API datetime format to Date object
  */
-export function decodeDatetime(encoded: DateTimeEncoded): Date {
+export function decodeDatetime(encoded: DateTimeEncodedType): Date {
   return new Date(encoded.$__dt__ * 1000);
 }
 
 /**
  * Encode a Date object to API date format (YYYY-MM-DD)
  */
-export function encodeDate(date: Date): DateEncoded {
+export function encodeDate(date: Date): DateEncodedType {
   return { $__d__: date.toISOString().split('T')[0] };
 }
 
 /**
  * Decode API date format to Date object
  */
-export function decodeDate(encoded: DateEncoded): Date {
+export function decodeDate(encoded: DateEncodedType): Date {
   return new Date(encoded.$__d__);
 }

package/sdk/api/index.ts

@@ -23,43 +23,38 @@ export type { BackendSchema, MetadataItem, FieldMetadata } from "./metadata";
 // Re-export common types for convenience
 export type {
   // Sort types
-  SortDirection,
-  SortOption,
-  Sort,
-  // Filter types (new names)
-  Condition,
-  ConditionGroup,
-  ConditionGroupOperator,
-  Filter,
-  FilterRHSType,
-  ConditionOperator,
-  // Filter types (legacy - deprecated)
-  FilterCondition,
-  FilterOperator,
-  FilterLogical,
-  FilterNode,
+  SortDirectionType,
+  SortOptionType,
+  SortType,
+  // Filter types
+  ConditionType,
+  ConditionGroupType,
+  ConditionGroupOperatorType,
+  FilterType,
+  FilterRHSTypeType,
+  ConditionOperatorType,
   // List types
-  ListOptions,
-  ListResponse,
-  ReadResponse,
-  CreateUpdateResponse,
-  DeleteResponse,
-  CountResponse,
+  ListOptionsType,
+  ListResponseType,
+  ReadResponseType,
+  CreateUpdateResponseType,
+  DeleteResponseType,
+  CountResponseType,
   // DateTime types
-  DateTimeEncoded,
-  DateEncoded,
+  DateTimeEncodedType,
+  DateEncodedType,
   // Metric types
-  MetricType,
-  MetricField,
-  MetricOptions,
-  MetricResponse,
+  MetricTypeType,
+  MetricFieldType,
+  MetricOptionsType,
+  MetricResponseType,
   // Pivot types
-  PivotHeaderItem,
-  PivotResponseData,
-  PivotOptions,
-  PivotResponse,
+  PivotHeaderItemType,
+  PivotResponseDataType,
+  PivotOptionsType,
+  PivotResponseType,
   // Draft types
-  DraftResponse,
+  DraftResponseType,
   // Fields types
-  FieldsResponse,
+  FieldsResponseType,
 } from "../types/common";

package/sdk/api/metadata.ts

@@ -3,7 +3,7 @@
 // ============================================================
 // Handles metadata/schema fetching operations for Business Objects
 
-import type { ListOptions, ListResponse } from "../types/common";
+import type { ListOptionsType, ListResponseType } from "../types/common";
 import { getApiBaseUrl, getDefaultHeaders } from "./client";
 
 // ============================================================
@@ -97,8 +97,8 @@ export interface MetadataItem {
  * ```
  */
 export async function listMetadata(
-  options?: ListOptions
-): Promise<ListResponse<MetadataItem>> {
+  options?: ListOptionsType
+): Promise<ListResponseType<MetadataItem>> {
   try {
     const baseUrl = getApiBaseUrl();
     const headers = getDefaultHeaders();
@@ -121,7 +121,7 @@ export async function listMetadata(
 
     const result = await response.json();
 
-    return result as ListResponse<MetadataItem>;
+    return result as ListResponseType<MetadataItem>;
   } catch (error) {
     console.error("Metadata list error:", error);
     throw new Error(

package/sdk/api.ts

@@ -0,0 +1,24 @@
+// ============================================================
+// API MODULE - Main Entry Point
+// @ram_28/kf-ai-sdk/api
+// ============================================================
+
+// Main API client
+export {
+  api,
+  setApiBaseUrl,
+  setDefaultHeaders,
+  getDefaultHeaders,
+  getApiBaseUrl,
+} from './api/client';
+
+// DateTime utilities
+export {
+  encodeDatetime,
+  decodeDatetime,
+  encodeDate,
+  decodeDate,
+} from './api/datetime';
+
+// Metadata API client
+export { getBdoSchema, listMetadata } from './api/metadata';