@ram_28/kf-ai-sdk 1.0.11 → 1.0.13

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';

package/sdk/api.types.ts

@@ -0,0 +1,58 @@
+// ============================================================
+// API MODULE - Type Exports
+// @ram_28/kf-ai-sdk/api/types
+// ============================================================
+
+// Resource client type
+export type { ResourceClient } from './api/client';
+
+// Metadata types
+export type { BackendSchema, MetadataItem, FieldMetadata } from './api/metadata';
+
+// Common API types
+export type {
+  // Sort types
+  SortDirectionType,
+  SortOptionType,
+  SortType,
+
+  // Filter types
+  ConditionType,
+  ConditionGroupType,
+  ConditionGroupOperatorType,
+  ConditionOperatorType,
+  FilterType,
+  FilterRHSTypeType,
+
+  // List types
+  ListOptionsType,
+  ListResponseType,
+  ReadResponseType,
+  CreateUpdateResponseType,
+  DeleteResponseType,
+  CountResponseType,
+
+  // DateTime types
+  DateTimeEncodedType,
+  DateEncodedType,
+
+  // Metric types
+  MetricTypeType,
+  MetricFieldType,
+  MetricOptionsType,
+  MetricResponseType,
+
+  // Pivot types
+  PivotHeaderItemType,
+  PivotResponseDataType,
+  PivotOptionsType,
+  PivotResponseType,
+
+  // Draft types
+  DraftResponseType,
+
+  // Fields types
+  FieldsResponseType,
+  FetchFieldOptionType,
+  FetchFieldResponseType,
+} from './types/common';

package/sdk/auth/AuthProvider.tsx

@@ -15,14 +15,14 @@ import React, {
 import { useQuery, useQueryClient } from "@tanstack/react-query";
 
 import type {
-  AuthContextValue,
-  AuthProviderProps,
-  AuthStatus,
-  UserDetails,
-  SessionResponse,
-  AuthProviderName,
-  LoginOptions,
-  LogoutOptions,
+  AuthContextValueType,
+  AuthProviderPropsType,
+  AuthStatusType,
+  UserDetailsType,
+  SessionResponseType,
+  AuthProviderNameType,
+  LoginOptionsType,
+  LogoutOptionsType,
 } from "./types";
 
 import {
@@ -37,7 +37,7 @@ import { getAuthConfig, configureAuth } from "./authConfig";
 // CONTEXT
 // ============================================================
 
-const AuthContext = createContext<AuthContextValue | null>(null);
+const AuthContext = createContext<AuthContextValueType | null>(null);
 
 const SESSION_QUERY_KEY = ["auth", "session"] as const;
 
@@ -53,7 +53,7 @@ export function AuthProvider({
   loadingComponent,
   unauthenticatedComponent,
   skipInitialCheck = false,
-}: AuthProviderProps): React.ReactElement {
+}: AuthProviderPropsType): React.ReactElement {
   const configApplied = useRef(false);
 
   if (configOverride && !configApplied.current) {
@@ -74,7 +74,7 @@ export function AuthProvider({
     error: queryError,
     refetch,
     isFetching,
-  } = useQuery<SessionResponse, Error>({
+  } = useQuery<SessionResponseType, Error>({
     queryKey: SESSION_QUERY_KEY,
     queryFn: fetchSession,
     enabled: !skipInitialCheck,
@@ -100,13 +100,13 @@ export function AuthProvider({
 
   const [error, setError] = useState<Error | null>(null);
 
-  const status: AuthStatus = useMemo(() => {
+  const status: AuthStatusType = useMemo(() => {
     if (isLoading || isFetching) return "loading";
     if (sessionData?.userDetails) return "authenticated";
     return "unauthenticated";
   }, [isLoading, isFetching, sessionData]);
 
-  const user: UserDetails | null = sessionData?.userDetails || null;
+  const user: UserDetailsType | null = sessionData?.userDetails || null;
   const staticBaseUrl: string | null = sessionData?.staticBaseUrl || null;
   const buildId: string | null = sessionData?.buildId || null;
   const isAuthenticated = status === "authenticated";
@@ -153,21 +153,21 @@ export function AuthProvider({
   // ============================================================
 
   const login = useCallback(
-    (provider?: AuthProviderName, options?: LoginOptions) => {
+    (provider?: AuthProviderNameType, options?: LoginOptionsType) => {
       initiateLogin(provider, options);
     },
     []
   );
 
   const logout = useCallback(
-    async (options?: LogoutOptions) => {
+    async (options?: LogoutOptionsType) => {
       queryClient.removeQueries({ queryKey: SESSION_QUERY_KEY });
       await performLogout(options);
     },
     [queryClient]
   );
 
-  const refreshSession = useCallback(async (): Promise<SessionResponse | null> => {
+  const refreshSession = useCallback(async (): Promise<SessionResponseType | null> => {
     // Prevent concurrent refreshes - return existing data if already fetching
     if (isFetching) {
       return sessionData || null;
@@ -208,7 +208,7 @@ export function AuthProvider({
   // CONTEXT VALUE
   // ============================================================
 
-  const contextValue: AuthContextValue = useMemo(
+  const contextValue: AuthContextValueType = useMemo(
     () => ({
       user,
       staticBaseUrl,
@@ -268,7 +268,7 @@ export function AuthProvider({
 // CONTEXT HOOK (internal)
 // ============================================================
 
-export function useAuthContext(): AuthContextValue {
+export function useAuthContext(): AuthContextValueType {
   const context = useContext(AuthContext);
   if (!context) {
     throw new Error("useAuth must be used within an AuthProvider");

package/sdk/auth/authClient.ts

@@ -4,10 +4,10 @@
 // Low-level functions for authentication API calls
 
 import type {
-  SessionResponse,
-  AuthProviderName,
-  LoginOptions,
-  LogoutOptions,
+  SessionResponseType,
+  AuthProviderNameType,
+  LoginOptionsType,
+  LogoutOptionsType,
 } from "./types";
 import {
   getAuthBaseUrl,
@@ -35,7 +35,7 @@ export class AuthenticationError extends Error {
  *
  * @throws AuthenticationError if session check fails or user is not authenticated
  */
-export async function fetchSession(): Promise<SessionResponse> {
+export async function fetchSession(): Promise<SessionResponseType> {
   const config = getAuthConfig();
   const baseUrl = getAuthBaseUrl();
   const headers = getDefaultHeaders();
@@ -56,7 +56,7 @@ export async function fetchSession(): Promise<SessionResponse> {
     );
   }
 
-  const data: SessionResponse = await response.json();
+  const data: SessionResponseType = await response.json();
   return data;
 }
 
@@ -81,8 +81,8 @@ export async function fetchSession(): Promise<SessionResponse> {
  * ```
  */
 export function initiateLogin(
-  provider?: AuthProviderName,
-  options?: LoginOptions
+  provider?: AuthProviderNameType,
+  options?: LoginOptionsType
 ): Promise<never> {
   return new Promise(() => {
     const config = getAuthConfig();
@@ -147,7 +147,7 @@ export function initiateLogin(
  * Logout the current user
  * Optionally calls the logout endpoint before clearing client state
  */
-export async function performLogout(options?: LogoutOptions): Promise<void> {
+export async function performLogout(options?: LogoutOptionsType): Promise<void> {
   const config = getAuthConfig();
   const baseUrl = getAuthBaseUrl();
   const headers = getDefaultHeaders();

package/sdk/auth/authConfig.ts

@@ -3,13 +3,13 @@
 // ============================================================
 // Global auth configuration following the setApiBaseUrl pattern
 
-import type { AuthConfig, AuthProviderName, AuthEndpointConfig } from "./types";
+import type { AuthConfigType, AuthProviderNameType, AuthEndpointConfigType } from "./types";
 import { getApiBaseUrl } from "../api/client";
 
 /**
  * Default auth configuration
  */
-const defaultAuthConfig: AuthConfig = {
+const defaultAuthConfig: AuthConfigType = {
   sessionEndpoint: "/api/id",
   providers: {
     google: {
@@ -32,7 +32,7 @@ const defaultAuthConfig: AuthConfig = {
 /**
  * Current auth configuration (mutable)
  */
-let authConfig: AuthConfig = { ...defaultAuthConfig };
+let authConfig: AuthConfigType = { ...defaultAuthConfig };
 
 /**
  * Configure authentication settings globally
@@ -48,7 +48,7 @@ let authConfig: AuthConfig = { ...defaultAuthConfig };
  * });
  * ```
  */
-export function configureAuth(config: Partial<AuthConfig>): void {
+export function configureAuth(config: Partial<AuthConfigType>): void {
   authConfig = {
     ...authConfig,
     ...config,
@@ -67,8 +67,8 @@ export function configureAuth(config: Partial<AuthConfig>): void {
  * Add or update an auth provider configuration
  */
 export function setAuthProvider(
-  provider: AuthProviderName,
-  config: AuthEndpointConfig
+  provider: AuthProviderNameType,
+  config: AuthEndpointConfigType
 ): void {
   authConfig.providers[provider] = config;
 }
@@ -76,7 +76,7 @@ export function setAuthProvider(
 /**
  * Get current auth configuration
  */
-export function getAuthConfig(): Readonly<AuthConfig> {
+export function getAuthConfig(): Readonly<AuthConfigType> {
   return { ...authConfig };
 }
 
@@ -92,8 +92,8 @@ export function getAuthBaseUrl(): string {
  * Get endpoint configuration for a specific provider
  */
 export function getProviderConfig(
-  provider: AuthProviderName
-): AuthEndpointConfig | undefined {
+  provider: AuthProviderNameType
+): AuthEndpointConfigType | undefined {
   return authConfig.providers[provider];
 }
 

package/sdk/auth/index.ts

@@ -13,9 +13,9 @@ export { AuthenticationError } from "./authClient";
 
 // Type exports
 export type {
-  UserDetails,
-  SessionResponse,
-  AuthStatus,
-  AuthProviderProps,
-  UseAuthReturn,
+  UserDetailsType,
+  SessionResponseType,
+  AuthStatusType,
+  AuthProviderPropsType,
+  UseAuthReturnType,
 } from "./types";

package/sdk/auth/types.ts

@@ -5,7 +5,7 @@
 /**
  * User details returned from the session endpoint
  */
-export interface UserDetails {
+export interface UserDetailsType {
   _id: string;
   _name: string;
   Role: string;
@@ -15,8 +15,8 @@ export interface UserDetails {
 /**
  * Session response from /api/id endpoint
  */
-export interface SessionResponse {
-  userDetails: UserDetails;
+export interface SessionResponseType {
+  userDetails: UserDetailsType;
   staticBaseUrl: string;
   buildId: string;
 }
@@ -24,17 +24,17 @@ export interface SessionResponse {
 /**
  * Authentication status
  */
-export type AuthStatus = "loading" | "authenticated" | "unauthenticated";
+export type AuthStatusType = "loading" | "authenticated" | "unauthenticated";
 
 /**
  * Authentication provider type (extensible for multiple OAuth providers)
  */
-export type AuthProviderName = "google" | "microsoft" | "github" | "custom";
+export type AuthProviderNameType = "google" | "microsoft" | "github" | "custom";
 
 /**
  * Auth endpoint configuration for a specific provider
  */
-export interface AuthEndpointConfig {
+export interface AuthEndpointConfigType {
   /** Login endpoint path (e.g., "/api/auth/google/login") */
   loginPath: string;
   /** Optional logout endpoint path */
@@ -46,7 +46,7 @@ export interface AuthEndpointConfig {
 /**
  * Global authentication configuration
  */
-export interface AuthConfig {
+export interface AuthConfigType {
   /** Base URL for auth endpoints (defaults to apiBaseUrl) */
   baseUrl?: string;
 
@@ -54,10 +54,10 @@ export interface AuthConfig {
   sessionEndpoint: string;
 
   /** Auth provider configurations */
-  providers: Partial<Record<AuthProviderName, AuthEndpointConfig>>;
+  providers: Partial<Record<AuthProviderNameType, AuthEndpointConfigType>>;
 
   /** Default provider to use for login */
-  defaultProvider: AuthProviderName;
+  defaultProvider: AuthProviderNameType;
 
   /** Auto-redirect to login when unauthenticated */
   autoRedirect: boolean;
@@ -90,14 +90,14 @@ export interface AuthConfig {
 /**
  * AuthProvider component props
  */
-export interface AuthProviderProps {
+export interface AuthProviderPropsType {
   children: React.ReactNode;
 
   /** Override global config for this provider instance */
-  config?: Partial<AuthConfig>;
+  config?: Partial<AuthConfigType>;
 
   /** Callback when authentication status changes */
-  onAuthChange?: (status: AuthStatus, user: UserDetails | null) => void;
+  onAuthChange?: (status: AuthStatusType, user: UserDetailsType | null) => void;
 
   /** Callback on authentication error */
   onError?: (error: Error) => void;
@@ -115,7 +115,7 @@ export interface AuthProviderProps {
 /**
  * Options for login operation
  */
-export interface LoginOptions {
+export interface LoginOptionsType {
   /** URL to redirect after successful login */
   callbackUrl?: string;
   /** Additional query parameters for login URL */
@@ -125,7 +125,7 @@ export interface LoginOptions {
 /**
  * Options for logout operation
  */
-export interface LogoutOptions {
+export interface LogoutOptionsType {
   /** URL to redirect after logout */
   redirectUrl?: string;
   /** Whether to call logout endpoint (default: true) */
@@ -135,13 +135,13 @@ export interface LogoutOptions {
 /**
  * Return type for useAuth hook
  */
-export interface UseAuthReturn {
+export interface UseAuthReturnType {
   // ============================================================
   // USER STATE
   // ============================================================
 
   /** Current authenticated user (null if not authenticated) */
-  user: UserDetails | null;
+  user: UserDetailsType | null;
 
   /** Static base URL from session */
   staticBaseUrl: string | null;
@@ -150,7 +150,7 @@ export interface UseAuthReturn {
   buildId: string | null;
 
   /** Current authentication status */
-  status: AuthStatus;
+  status: AuthStatusType;
 
   /** Convenience boolean for authenticated state */
   isAuthenticated: boolean;
@@ -167,18 +167,18 @@ export interface UseAuthReturn {
    * @param provider - Auth provider to use (defaults to configured default)
    * @param options - Additional options for login
    */
-  login: (provider?: AuthProviderName, options?: LoginOptions) => void;
+  login: (provider?: AuthProviderNameType, options?: LoginOptionsType) => void;
 
   /**
    * Logout the current user
    * @param options - Additional options for logout
    */
-  logout: (options?: LogoutOptions) => Promise<void>;
+  logout: (options?: LogoutOptionsType) => Promise<void>;
 
   /**
    * Manually refresh the session
    */
-  refreshSession: () => Promise<SessionResponse | null>;
+  refreshSession: () => Promise<SessionResponseType | null>;
 
   /**
    * Check if user has a specific role
@@ -204,7 +204,7 @@ export interface UseAuthReturn {
 /**
  * Auth context value (internal)
  */
-export interface AuthContextValue extends UseAuthReturn {
+export interface AuthContextValueType extends UseAuthReturnType {
   /** Internal: force re-check session */
   _forceCheck: () => void;
 }

package/sdk/auth/useAuth.ts

@@ -4,7 +4,7 @@
 // Main hook for consuming authentication state
 
 import { useMemo } from "react";
-import type { UseAuthReturn } from "./types";
+import type { UseAuthReturnType } from "./types";
 import { useAuthContext } from "./AuthProvider";
 
 /**
@@ -31,7 +31,7 @@ import { useAuthContext } from "./AuthProvider";
  * }
  * ```
  */
-export function useAuth(): UseAuthReturn {
+export function useAuth(): UseAuthReturnType {
   const context = useAuthContext();
 
   return useMemo(

package/sdk/auth.ts

@@ -0,0 +1,22 @@
+// ============================================================
+// AUTH MODULE - Main Entry Point
+// @ram_28/kf-ai-sdk/auth
+// ============================================================
+
+// Provider component
+export { AuthProvider } from './auth/AuthProvider';
+
+// Main hook
+export { useAuth } from './auth/useAuth';
+
+// Error class
+export { AuthenticationError } from './auth/authClient';
+
+// Configuration
+export {
+  configureAuth,
+  getAuthConfig,
+  setAuthProvider,
+  getAuthBaseUrl,
+  resetAuthConfig,
+} from './auth/authConfig';

package/sdk/auth.types.ts

@@ -0,0 +1,28 @@
+// ============================================================
+// AUTH MODULE - Type Exports
+// @ram_28/kf-ai-sdk/auth/types
+// ============================================================
+
+export type {
+  // Core hook types
+  UseAuthReturnType,
+
+  // User and session
+  UserDetailsType,
+  SessionResponseType,
+
+  // Auth status
+  AuthStatusType,
+
+  // Provider types
+  AuthProviderPropsType,
+  AuthProviderNameType,
+
+  // Configuration
+  AuthConfigType,
+  AuthEndpointConfigType,
+
+  // Operation options
+  LoginOptionsType,
+  LogoutOptionsType,
+} from './auth/types';