@ram_28/kf-ai-sdk 1.0.10 → 1.0.12

package/sdk/types/base-fields.ts

@@ -3,7 +3,7 @@
  * Resolves to: string
  * Use this for all ID-type fields (user IDs, order IDs, etc.)
  */
-export type IdField = string;
+export type IdFieldType = string;
 
 /**
  * String field with optional literal type constraint and length limits
@@ -14,11 +14,11 @@ export type IdField = string;
  * Storage: VARCHAR in database
  *
  * @example
- * StringField // => string
- * StringField<'active' | 'inactive'> // => 'active' | 'inactive'
- * StringField<string, 1, 100> // => string with length constraints
+ * StringFieldType // => string
+ * StringFieldType<'active' | 'inactive'> // => 'active' | 'inactive'
+ * StringFieldType<string, 1, 100> // => string with length constraints
  */
-export type StringField<
+export type StringFieldType<
   T extends string = string,
   _MinLength extends number = never,
   _MaxLength extends number = never,
@@ -31,9 +31,9 @@ export type StringField<
  * Use this for descriptions, comments, rich text content
  *
  * @example
- * TextAreaField // => string (multi-line)
+ * TextAreaFieldType // => string (multi-line)
  */
-export type TextAreaField = string;
+export type TextAreaFieldType = string;
 
 /**
  * Numeric field with optional precision constraints
@@ -43,10 +43,10 @@ export type TextAreaField = string;
  * Use this for quantities, measurements, calculations
  *
  * @example
- * NumberField // => number
- * NumberField<2> // => number with 2 decimal places
+ * NumberFieldType // => number
+ * NumberFieldType<2> // => number with 2 decimal places
  */
-export type NumberField<_Precision extends number = never> = number;
+export type NumberFieldType<_Precision extends number = never> = number;
 
 /**
  * Large integer field for big numbers
@@ -55,9 +55,9 @@ export type NumberField<_Precision extends number = never> = number;
  * Use this for large counters, timestamps, file sizes
  *
  * @example
- * LongField // => number (large integer)
+ * LongFieldType // => number (large integer)
  */
-export type LongField = number;
+export type LongFieldType = number;
 
 /**
  * Boolean field
@@ -65,7 +65,7 @@ export type LongField = number;
  * Storage: BOOLEAN in database
  * Use this for true/false values, flags, toggles
  */
-export type BooleanField = boolean;
+export type BooleanFieldType = boolean;
 
 /**
  * Date field (date only, no time)
@@ -74,9 +74,9 @@ export type BooleanField = boolean;
  * Use this for birth dates, due dates, calendar events
  *
  * @example
- * DateField // => Date (date only)
+ * DateFieldType // => Date (date only)
  */
-export type DateField = Date;
+export type DateFieldType = Date;
 
 /**
  * DateTime field (date and time)
@@ -85,9 +85,9 @@ export type DateField = Date;
  * Use this for created_at, updated_at, event timestamps
  *
  * @example
- * DateTimeField // => Date (with time)
+ * DateTimeFieldType // => Date (with time)
  */
-export type DateTimeField = Date;
+export type DateTimeFieldType = Date;
 
 // ============================================================
 // COMPLEX FIELD TYPES
@@ -95,53 +95,53 @@ export type DateTimeField = Date;
 
 /**
  * Currency field supporting multiple value formats
- * Resolves to: CurrencyValue
+ * Resolves to: CurrencyValueType
  * Storage: JSON/VARCHAR in database
  * Use this for prices, monetary amounts, financial data
  *
  * @example
- * CurrencyField // => {value: number, currency: string} | string
+ * CurrencyFieldType // => {value: number, currency: string} | string
  */
-export type CurrencyField = CurrencyValue;
+export type CurrencyFieldType = CurrencyValueType;
 
 /**
  * Currency value format - supports both object and string representations
  */
-export type CurrencyValue =
+export type CurrencyValueType =
   | { value: number; currency: string } // Object format: {value: 100.50, currency: "USD"}
   | string; // String format: "100.50 USD" or "USD 100.50"
 
 /**
  * JSON field for structured data
  * @template T - Expected JSON structure (optional)
- * Resolves to: T or JSONValue
+ * Resolves to: T or JSONValueType
  * Storage: JSON/TEXT in database
  * Use this for configurations, metadata, flexible schemas
  *
  * @example
- * JSONField // => JSONValue (any valid JSON)
- * JSONField<{settings: {theme: string}}> // => {settings: {theme: string}}
+ * JSONFieldType // => JSONValueType (any valid JSON)
+ * JSONFieldType<{settings: {theme: string}}> // => {settings: {theme: string}}
  */
-export type JSONField<T = JSONValue> = T;
+export type JSONFieldType<T = JSONValueType> = T;
 
-export type ReferenceField = string;
+export type ReferenceFieldType = string;
 
 /**
  * Valid JSON value types
  */
-export type JSONValue =
+export type JSONValueType =
   | string
   | number
   | boolean
   | null
-  | JSONObject
-  | JSONArray;
+  | JSONObjectType
+  | JSONArrayType;
 
-export interface JSONObject {
-  [key: string]: JSONValue;
+export interface JSONObjectType {
+  [key: string]: JSONValueType;
 }
 
-export interface JSONArray extends Array<JSONValue> {}
+export interface JSONArrayType extends Array<JSONValueType> {}
 
 /**
  * Select field for single choice from predefined options
@@ -151,9 +151,9 @@ export interface JSONArray extends Array<JSONValue> {}
  * Use this for status fields, categories, enum-like values
  *
  * @example
- * SelectField<'active' | 'inactive' | 'pending'> // => 'active' | 'inactive' | 'pending'
+ * SelectFieldType<'active' | 'inactive' | 'pending'> // => 'active' | 'inactive' | 'pending'
  */
-export type SelectField<T extends string> = T;
+export type SelectFieldType<T extends string> = T;
 
 /**
  * Lookup field for references to other records
@@ -163,10 +163,10 @@ export type SelectField<T extends string> = T;
  * Use this for foreign keys, relationships, references
  *
  * @example
- * LookupField // => string (referenced record ID)
- * LookupField<IdField> // => string (typed as IdField)
+ * LookupFieldType // => string (referenced record ID)
+ * LookupFieldType<IdFieldType> // => string (typed as IdFieldType)
  */
-export type LookupField<T extends string = string> = T;
+export type LookupFieldType<T extends string = string> = T;
 
 // ============================================================
 // CONTAINER AND UTILITY TYPES
@@ -180,11 +180,11 @@ export type LookupField<T extends string = string> = T;
  * Use this for tags, categories, multiple selections
  *
  * @example
- * ArrayField<string> // => string[]
- * ArrayField<IdField> // => string[]
- * ArrayField<SelectField<'tag1' | 'tag2'>> // => ('tag1' | 'tag2')[]
+ * ArrayFieldType<string> // => string[]
+ * ArrayFieldType<IdFieldType> // => string[]
+ * ArrayFieldType<SelectFieldType<'tag1' | 'tag2'>> // => ('tag1' | 'tag2')[]
  */
-export type ArrayField<T> = T[];
+export type ArrayFieldType<T> = T[];
 
 /**
  * Nested object field
@@ -194,9 +194,9 @@ export type ArrayField<T> = T[];
  * Use this for complex nested structures, embedded documents
  *
  * @example
- * ObjectField<{ name: string; age: number }> // => { name: string; age: number }
+ * ObjectFieldType<{ name: string; age: number }> // => { name: string; age: number }
  */
-export type ObjectField<T extends Record<string, any>> = T;
+export type ObjectFieldType<T extends Record<string, any>> = T;
 
 /**
  * Optional field wrapper
@@ -205,10 +205,10 @@ export type ObjectField<T extends Record<string, any>> = T;
  * Use this for fields that may not have values
  *
  * @example
- * OptionalField<StringField> // => string | undefined
- * OptionalField<NumberField> // => number | undefined
+ * OptionalFieldType<StringFieldType> // => string | undefined
+ * OptionalFieldType<NumberFieldType> // => number | undefined
  */
-export type OptionalField<T> = T | undefined;
+export type OptionalFieldType<T> = T | undefined;
 
 // ============================================================
 // UTILITY TYPES FOR FIELD VALIDATION
@@ -218,4 +218,4 @@ export type OptionalField<T> = T | undefined;
  * Utility type to extract the base type from a field type
  * Useful for runtime validation and type guards
  */
-export type ExtractFieldType<T> = T extends OptionalField<infer U> ? U : T;
+export type ExtractFieldTypeType<T> = T extends OptionalFieldType<infer U> ? U : T;

package/sdk/types/common.ts

@@ -1,24 +1,24 @@
 /**
  * Sort direction for API queries (matching API spec)
  */
-export type SortDirection = "ASC" | "DESC";
+export type SortDirectionType = "ASC" | "DESC";
 
 /**
  * Sort configuration: array of field-direction mappings
  * Format: [{ "fieldName": "ASC" }, { "anotherField": "DESC" }]
  */
-export type SortOption = Record<string, SortDirection>;
+export type SortOptionType = Record<string, SortDirectionType>;
 
 /**
  * Sort configuration: array of sort options
  */
-export type Sort = SortOption[];
+export type SortType = SortOptionType[];
 
 /**
  * Condition operators for individual conditions (leaf nodes)
  * Used in Condition.Operator
  */
-export type ConditionOperator =
+export type ConditionOperatorType =
   | "EQ" | "NE" | "GT" | "GTE" | "LT" | "LTE"
   | "Between" | "NotBetween" | "IN" | "NIN"
   | "Empty" | "NotEmpty" | "Contains" | "NotContains"
@@ -28,81 +28,57 @@ export type ConditionOperator =
  * Operators for combining conditions in a group (tree nodes)
  * Used in ConditionGroup.Operator
  */
-export type ConditionGroupOperator = "And" | "Or" | "Not";
+export type ConditionGroupOperatorType = "And" | "Or" | "Not";
 
 /**
  * RHS value type for filter conditions
  */
-export type FilterRHSType = "Constant" | "BOField" | "AppVariable";
+export type FilterRHSTypeType = "Constant" | "BOField" | "AppVariable";
 
 /**
  * Leaf condition (actual field comparison)
  */
-export interface Condition {
+export interface ConditionType {
   /** Optional ID for hook state management (omitted in API payload) */
   id?: string;
   /** Condition operator */
-  Operator: ConditionOperator;
+  Operator: ConditionOperatorType;
   /** Left-hand side field name */
   LHSField: string;
   /** Right-hand side value */
   RHSValue: any;
   /** Right-hand side type (optional, defaults to Constant) */
-  RHSType?: FilterRHSType;
+  RHSType?: FilterRHSTypeType;
 }
 
 /**
  * Group combining conditions (recursive structure)
  */
-export interface ConditionGroup {
+export interface ConditionGroupType {
   /** Optional ID for hook state management (omitted in API payload) */
   id?: string;
   /** Group operator (And, Or, Not) */
-  Operator: ConditionGroupOperator;
+  Operator: ConditionGroupOperatorType;
   /** Nested conditions (can be Condition or ConditionGroup) */
-  Condition: Array<Condition | ConditionGroup>;
+  Condition: Array<ConditionType | ConditionGroupType>;
 }
 
 /**
  * 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 FilterOperator = ConditionGroupOperator;
-
-/**
- * @deprecated Use `Condition | ConditionGroup` instead
- */
-export type FilterNode = Condition | ConditionGroup;
+export type FilterType = ConditionGroupType;
 
 /**
  * DateTime encoding format used by the API
  */
-export interface DateTimeEncoded {
+export interface DateTimeEncodedType {
   $__dt__: number;
 }
 
 /**
- * Date encoding format used by the API  
+ * Date encoding format used by the API
  */
-export interface DateEncoded {
+export interface DateEncodedType {
   $__d__: string;
 }
 
@@ -110,7 +86,7 @@ export interface DateEncoded {
  * Standard paginated list response
  * @template T - Type of items in the list
  */
-export interface ListResponse<T> {
+export interface ListResponseType<T> {
   /** Array of items for current page */
   Data: T[];
 }
@@ -119,7 +95,7 @@ export interface ListResponse<T> {
  * Read API response wrapper
  * @template T - Type of the data object
  */
-export interface ReadResponse<T> {
+export interface ReadResponseType<T> {
   /** The data object */
   Data: T;
 }
@@ -127,7 +103,7 @@ export interface ReadResponse<T> {
 /**
  * Create/Update API response
  */
-export interface CreateUpdateResponse {
+export interface CreateUpdateResponseType {
   /** ID of the created/updated record */
   _id: string;
 }
@@ -135,7 +111,7 @@ export interface CreateUpdateResponse {
 /**
  * Delete API response
  */
-export interface DeleteResponse {
+export interface DeleteResponseType {
   /** Status of the delete operation */
   status: "success";
 }
@@ -143,7 +119,7 @@ export interface DeleteResponse {
 /**
  * Count API response
  */
-export interface CountResponse {
+export interface CountResponseType {
   /** Total count of matching records */
   Count: number;
 }
@@ -151,7 +127,7 @@ export interface CountResponse {
 /**
  * Options for list queries (API request format)
  */
-export interface ListOptions {
+export interface ListOptionsType {
   /** Query type (defaults to "List") */
   Type?: "List";
 
@@ -159,10 +135,10 @@ export interface ListOptions {
   Field?: string[];
 
   /** Filter criteria */
-  Filter?: Filter;
+  Filter?: FilterType;
 
   /** Sort configuration */
-  Sort?: Sort;
+  Sort?: SortType;
 
   /** Search query (separate from filters) */
   Search?: string;
@@ -181,7 +157,7 @@ export interface ListOptions {
 /**
  * Metric aggregation function types
  */
-export type MetricType =
+export type MetricTypeType =
   | "Sum"
   | "Avg"
   | "Count"
@@ -196,31 +172,31 @@ export type MetricType =
 /**
  * Metric field configuration
  */
-export interface MetricField {
+export interface MetricFieldType {
   /** Field to aggregate */
   Field: string;
   /** Aggregation function type */
-  Type: MetricType;
+  Type: MetricTypeType;
 }
 
 /**
  * Options for metric/aggregate queries
  */
-export interface MetricOptions {
+export interface MetricOptionsType {
   /** Query type (always "Metric") */
   Type: "Metric";
   /** Fields to group by */
   GroupBy: string[];
   /** Metric definitions */
-  Metric: MetricField[];
+  Metric: MetricFieldType[];
   /** Optional filter criteria */
-  Filter?: Filter;
+  Filter?: FilterType;
 }
 
 /**
  * Response from metric endpoint
  */
-export interface MetricResponse {
+export interface MetricResponseType {
   /** Aggregated data rows */
   Data: Record<string, any>[];
 }
@@ -232,21 +208,21 @@ export interface MetricResponse {
 /**
  * Pivot table header item (hierarchical)
  */
-export interface PivotHeaderItem {
+export interface PivotHeaderItemType {
   /** Header key/label */
   Key: string;
   /** Child headers for nested grouping */
-  Children?: PivotHeaderItem[] | null;
+  Children?: PivotHeaderItemType[] | null;
 }
 
 /**
  * Pivot response data structure
  */
-export interface PivotResponseData {
+export interface PivotResponseDataType {
   /** Row headers */
-  RowHeader: PivotHeaderItem[];
+  RowHeader: PivotHeaderItemType[];
   /** Column headers */
-  ColumnHeader: PivotHeaderItem[];
+  ColumnHeader: PivotHeaderItemType[];
   /** Value matrix [row][column] */
   Value: (number | string | null)[][];
 }
@@ -254,7 +230,7 @@ export interface PivotResponseData {
 /**
  * Options for pivot queries
  */
-export interface PivotOptions {
+export interface PivotOptionsType {
   /** Query type (always "Pivot") */
   Type: "Pivot";
   /** Row dimension fields */
@@ -262,17 +238,17 @@ export interface PivotOptions {
   /** Column dimension fields */
   Column: string[];
   /** Metric definitions */
-  Metric: MetricField[];
+  Metric: MetricFieldType[];
   /** Optional filter criteria */
-  Filter?: Filter;
+  Filter?: FilterType;
 }
 
 /**
  * Response from pivot endpoint
  */
-export interface PivotResponse {
+export interface PivotResponseType {
   /** Pivot data including headers and values */
-  Data: PivotResponseData;
+  Data: PivotResponseDataType;
 }
 
 // ============================================================
@@ -282,7 +258,7 @@ export interface PivotResponse {
 /**
  * Response from draft operations
  */
-export interface DraftResponse {
+export interface DraftResponseType {
   /** Computed field values */
   [fieldName: string]: any;
 }
@@ -294,7 +270,7 @@ export interface DraftResponse {
 /**
  * Response from fields endpoint
  */
-export interface FieldsResponse {
+export interface FieldsResponseType {
   /** Field metadata */
   Data: Record<string, any>[];
 }
@@ -306,7 +282,7 @@ export interface FieldsResponse {
 /**
  * Single option returned from fetch field endpoint
  */
-export interface FetchFieldOption {
+export interface FetchFieldOptionType {
   /** The value to be stored */
   Value: string;
   /** The display label */
@@ -316,7 +292,7 @@ export interface FetchFieldOption {
 /**
  * Response from fetch field endpoint
  */
-export interface FetchFieldResponse {
+export interface FetchFieldResponseType {
   /** Array of field options */
-  Data: FetchFieldOption[];
-}
+  Data: FetchFieldOptionType[];
+}

package/sdk/types/index.ts

@@ -2,4 +2,4 @@
 export * from './base-fields';
 
 // Common API types
-export * from './common';
+export * from './common';

package/sdk/utils/formatting.ts

@@ -1,4 +1,4 @@
-import type { CurrencyValue, JSONValue } from '../types/base-fields';
+import type { CurrencyValueType, JSONValueType } from '../types/base-fields';
 
 /**
  * Data formatting utilities for display and conversion
@@ -7,7 +7,7 @@ import type { CurrencyValue, JSONValue } from '../types/base-fields';
 /**
  * Format currency value for display
  */
-export function formatCurrency(value: CurrencyValue): string {
+export function formatCurrency(value: CurrencyValueType): string {
   if (typeof value === 'string') {
     return value; // Already formatted
   }
@@ -26,7 +26,7 @@ export function formatCurrency(value: CurrencyValue): string {
 /**
  * Parse currency string to currency object
  */
-export function parseCurrency(value: string): CurrencyValue | null {
+export function parseCurrency(value: string): CurrencyValueType | null {
   // Try to parse "USD 100.50" or "100.50 USD" format
   const match = value.match(/^(?:([A-Z]{3})\s+(\d+\.?\d*))|(?:(\d+\.?\d*)\s+([A-Z]{3}))$/);
   
@@ -90,7 +90,7 @@ export function formatNumber(value: number, precision: number = 2): string {
 /**
  * Format JSON value for display
  */
-export function formatJSON(value: JSONValue, indent: number = 2): string {
+export function formatJSON(value: JSONValueType, indent: number = 2): string {
   try {
     return JSON.stringify(value, null, indent);
   } catch {

package/sdk/utils.ts

@@ -0,0 +1,10 @@
+// ============================================================
+// UTILS MODULE - Main Entry Point
+// @ram_28/kf-ai-sdk/utils
+// ============================================================
+
+// Formatting utilities
+export * from './utils/formatting';
+
+// Class name utilities
+export * from './utils/cn';