@ram_28/kf-ai-sdk 1.0.18 → 1.0.20

package/sdk/utils/api/buildListOptions.ts

@@ -0,0 +1,120 @@
+// ============================================================
+// BUILD LIST OPTIONS UTILITY
+// ============================================================
+// Shared utility for building API list options across hooks
+
+import type { ListOptionsType, FilterType, SortType } from "../../types/common";
+
+/**
+ * Options for building list API request options
+ */
+export interface BuildListOptionsParams<T = any> {
+  /** Search query string */
+  search?: string;
+  /** Filter payload */
+  filter?: FilterType<T>;
+  /** Sort configuration */
+  sort?: {
+    field: keyof T | null;
+    direction: "asc" | "desc" | null;
+  };
+  /** Sort array in API format */
+  sortArray?: SortType;
+  /** Pagination settings */
+  pagination?: {
+    pageNo: number;
+    pageSize: number;
+  };
+}
+
+/**
+ * Build list options for count queries
+ * Excludes pagination and sorting (they don't affect count)
+ */
+export function buildCountOptions<T = any>(
+  params: Pick<BuildListOptionsParams<T>, "search" | "filter">
+): ListOptionsType {
+  const opts: ListOptionsType = {};
+
+  if (params.search) {
+    opts.Search = params.search;
+  }
+
+  if (params.filter) {
+    opts.Filter = params.filter;
+  }
+
+  return opts;
+}
+
+/**
+ * Build list options for data queries
+ * Includes all options: search, filter, sort, pagination
+ */
+export function buildListOptions<T = any>(
+  params: BuildListOptionsParams<T>
+): ListOptionsType {
+  const opts: ListOptionsType = buildCountOptions({
+    search: params.search,
+    filter: params.filter,
+  });
+
+  // Add sorting - convert internal format to API format
+  if (params.sort?.field && params.sort?.direction) {
+    opts.Sort = [
+      {
+        [String(params.sort.field)]:
+          params.sort.direction === "asc" ? "ASC" : "DESC",
+      },
+    ];
+  } else if (params.sortArray) {
+    opts.Sort = params.sortArray;
+  }
+
+  // Add pagination
+  if (params.pagination) {
+    opts.Page = params.pagination.pageNo;
+    opts.PageSize = params.pagination.pageSize;
+  }
+
+  return opts;
+}
+
+/**
+ * Combine filter payload with additional column filter
+ * Used for kanban column-specific queries
+ */
+export function combineFilters<T = any>(
+  baseFilter: FilterType<T> | undefined,
+  additionalCondition: {
+    LHSField: string;
+    Operator: string;
+    RHSValue: any;
+    RHSType?: string;
+  }
+): FilterType<T> {
+  const columnFilterObject = {
+    ...additionalCondition,
+    RHSType: additionalCondition.RHSType || "Constant",
+  };
+
+  if (!baseFilter) {
+    return {
+      Operator: "And",
+      Condition: [columnFilterObject],
+    } as FilterType<T>;
+  }
+
+  // If base is And, append. If base is Or/Not, wrap in new And.
+  if (baseFilter.Operator === "And") {
+    return {
+      ...baseFilter,
+      Condition: [...(baseFilter.Condition || []), columnFilterObject],
+    } as FilterType<T>;
+  }
+
+  return {
+    Operator: "And",
+    Condition: [baseFilter, columnFilterObject],
+  } as FilterType<T>;
+}

package/sdk/utils/api/index.ts

@@ -0,0 +1,2 @@
+// API utilities
+export * from "./buildListOptions";

package/sdk/utils/error-handling.ts

@@ -0,0 +1,150 @@
+// ============================================================
+// ERROR HANDLING UTILITIES
+// ============================================================
+// Type-safe error handling utilities for the SDK
+
+/**
+ * Safely convert unknown error to Error object
+ * Handles all possible error types that could be thrown
+ */
+export function toError(err: unknown): Error {
+  // Already an Error instance
+  if (err instanceof Error) {
+    return err;
+  }
+
+  // String error
+  if (typeof err === "string") {
+    return new Error(err);
+  }
+
+  // Object with message property
+  if (
+    err !== null &&
+    typeof err === "object" &&
+    "message" in err &&
+    typeof (err as { message: unknown }).message === "string"
+  ) {
+    const error = new Error((err as { message: string }).message);
+    // Preserve any additional properties
+    Object.assign(error, err);
+    return error;
+  }
+
+  // Fallback: convert to string
+  return new Error(String(err));
+}
+
+/**
+ * Type guard to check if a value is an Error
+ */
+export function isError(value: unknown): value is Error {
+  return value instanceof Error;
+}
+
+/**
+ * Type guard to check if error has a specific code
+ */
+export function hasErrorCode(
+  err: unknown,
+  code: string
+): err is Error & { code: string } {
+  return (
+    err instanceof Error &&
+    "code" in err &&
+    (err as Error & { code: unknown }).code === code
+  );
+}
+
+/**
+ * Type guard to check if error is a network error
+ */
+export function isNetworkError(err: unknown): boolean {
+  if (!isError(err)) return false;
+
+  const message = err.message.toLowerCase();
+  return (
+    message.includes("network") ||
+    message.includes("fetch") ||
+    message.includes("connection") ||
+    hasErrorCode(err, "NETWORK_ERROR") ||
+    hasErrorCode(err, "ENOTFOUND") ||
+    hasErrorCode(err, "ECONNREFUSED")
+  );
+}
+
+/**
+ * Type guard to check if error is a timeout error
+ */
+export function isTimeoutError(err: unknown): boolean {
+  if (!isError(err)) return false;
+
+  return (
+    err.message.toLowerCase().includes("timeout") ||
+    hasErrorCode(err, "TIMEOUT") ||
+    hasErrorCode(err, "ETIMEDOUT")
+  );
+}
+
+/**
+ * Type guard to check if error is an abort error
+ */
+export function isAbortError(err: unknown): boolean {
+  if (!isError(err)) return false;
+
+  return err.name === "AbortError" || hasErrorCode(err, "ABORT_ERR");
+}
+
+/**
+ * Extract error message from unknown error
+ */
+export function getErrorMessage(err: unknown): string {
+  if (isError(err)) {
+    return err.message;
+  }
+
+  if (typeof err === "string") {
+    return err;
+  }
+
+  if (
+    err !== null &&
+    typeof err === "object" &&
+    "message" in err &&
+    typeof (err as { message: unknown }).message === "string"
+  ) {
+    return (err as { message: string }).message;
+  }
+
+  return String(err);
+}
+
+/**
+ * Safe error handler wrapper for async functions
+ * Returns a tuple of [result, error]
+ */
+export async function tryCatch<T>(
+  fn: () => Promise<T>
+): Promise<[T, null] | [null, Error]> {
+  try {
+    const result = await fn();
+    return [result, null];
+  } catch (err) {
+    return [null, toError(err)];
+  }
+}
+
+/**
+ * Create a wrapped error with original error as cause
+ */
+export function wrapError(message: string, cause: unknown): Error {
+  const error = new Error(message);
+  // Use Object.defineProperty for broader compatibility
+  Object.defineProperty(error, 'cause', {
+    value: toError(cause),
+    writable: true,
+    enumerable: false,
+    configurable: true,
+  });
+  return error;
+}

package/sdk/utils/index.ts

@@ -3,3 +3,9 @@ export * from "./formatting";
 
 // Class name utilities
 export * from "./cn";
+
+// Error handling utilities
+export * from "./error-handling";
+
+// API utilities
+export * from "./api";

package/dist/useFilter-Dofowpr_.cjs

@@ -1 +0,0 @@
-"use strict";const u=require("react"),d=r=>"Condition"in r,R=r=>"LHSField"in r;let _=0;const l=()=>`filter_${Date.now()}_${++_}`,$=r=>r.id?r:{...r,id:l()},k=r=>r.map(o=>{const n=$(o);return d(n)?{...n,Condition:k(n.Condition)}:n}),O=r=>r.map(o=>{if(d(o)){const{id:b,...C}=o;return{...C,Condition:O(o.Condition)}}const{id:n,...t}=o;return t}),h=(r,o)=>{for(const n of r){if(n.id===o)return n;if(d(n)){const t=h(n.Condition,o);if(t)return t}}},f=(r,o,n)=>r.map(t=>t.id===o?n(t):d(t)?{...t,Condition:f(t.Condition,o,n)}:t),G=(r,o)=>r.filter(n=>n.id!==o).map(n=>d(n)?{...n,Condition:G(n.Condition,o)}:n),p=(r,o,n)=>r.map(t=>t.id===o&&d(t)?{...t,Condition:[...t.Condition,n]}:d(t)?{...t,Condition:p(t.Condition,o,n)}:t);function q(r={}){const[o,n]=u.useState(()=>k(r.initialConditions||[])),[t,b]=u.useState(r.initialOperator||"And"),C=u.useMemo(()=>{if(o.length!==0)return{Operator:t,Condition:O(o)}},[o,t]),g=o.length>0,v=u.useCallback((i,s)=>{const c=l(),e={...i,id:c};return n(s?a=>p(a,s,e):a=>[...a,e]),c},[]),F=u.useCallback((i,s)=>{const c=l(),e={id:c,Operator:i,Condition:[]};return n(s?a=>p(a,s,e):a=>[...a,e]),c},[]),I=u.useCallback((i,s)=>{n(c=>f(c,i,e=>d(e)?e:{...e,...s}))},[]),S=u.useCallback((i,s)=>{n(c=>f(c,i,e=>d(e)?{...e,Operator:s}:e))},[]),w=u.useCallback(i=>{n(s=>G(s,i))},[]),T=u.useCallback(i=>h(o,i),[o]),y=u.useCallback(()=>{n([])},[]),A=u.useCallback(i=>{b(i)},[]);return{operator:t,items:o,payload:C,hasConditions:g,addCondition:v,addConditionGroup:F,updateCondition:I,updateGroupOperator:S,removeCondition:w,getCondition:T,clearAllConditions:y,setRootOperator:A}}exports.isCondition=R;exports.isConditionGroup=d;exports.useFilter=q;

package/dist/useFilter-Dv-mr9QW.js

@@ -1,117 +0,0 @@
-import { useState as h, useMemo as k, useCallback as c } from "react";
-const u = (t) => "Condition" in t, H = (t) => "LHSField" in t;
-let x = 0;
-const f = () => `filter_${Date.now()}_${++x}`, B = (t) => t.id ? t : { ...t, id: f() }, g = (t) => t.map((o) => {
-  const n = B(o);
-  return u(n) ? {
-    ...n,
-    Condition: g(n.Condition)
-  } : n;
-}), v = (t) => t.map((o) => {
-  if (u(o)) {
-    const { id: O, ...C } = o;
-    return {
-      ...C,
-      Condition: v(o.Condition)
-    };
-  }
-  const { id: n, ...r } = o;
-  return r;
-}), G = (t, o) => {
-  for (const n of t) {
-    if (n.id === o)
-      return n;
-    if (u(n)) {
-      const r = G(n.Condition, o);
-      if (r) return r;
-    }
-  }
-}, p = (t, o, n) => t.map((r) => r.id === o ? n(r) : u(r) ? {
-  ...r,
-  Condition: p(r.Condition, o, n)
-} : r), I = (t, o) => t.filter((n) => n.id !== o).map((n) => u(n) ? {
-  ...n,
-  Condition: I(n.Condition, o)
-} : n), l = (t, o, n) => t.map((r) => r.id === o && u(r) ? {
-  ...r,
-  Condition: [...r.Condition, n]
-} : u(r) ? {
-  ...r,
-  Condition: l(r.Condition, o, n)
-} : r);
-function L(t = {}) {
-  const [o, n] = h(
-    () => g(t.initialConditions || [])
-  ), [r, O] = h(
-    t.initialOperator || "And"
-  ), C = k(() => {
-    if (o.length !== 0)
-      return {
-        Operator: r,
-        Condition: v(o)
-      };
-  }, [o, r]), w = o.length > 0, F = c(
-    (i, s) => {
-      const d = f(), e = { ...i, id: d };
-      return n(s ? (a) => l(a, s, e) : (a) => [...a, e]), d;
-    },
-    []
-  ), S = c(
-    (i, s) => {
-      const d = f(), e = {
-        id: d,
-        Operator: i,
-        Condition: []
-      };
-      return n(s ? (a) => l(a, s, e) : (a) => [...a, e]), d;
-    },
-    []
-  ), T = c(
-    (i, s) => {
-      n(
-        (d) => p(d, i, (e) => u(e) ? e : { ...e, ...s })
-      );
-    },
-    []
-  ), y = c(
-    (i, s) => {
-      n(
-        (d) => p(d, i, (e) => u(e) ? { ...e, Operator: s } : e)
-      );
-    },
-    []
-  ), A = c((i) => {
-    n((s) => I(s, i));
-  }, []), _ = c(
-    (i) => G(o, i),
-    [o]
-  ), $ = c(() => {
-    n([]);
-  }, []), b = c((i) => {
-    O(i);
-  }, []);
-  return {
-    // State
-    operator: r,
-    items: o,
-    payload: C,
-    hasConditions: w,
-    // Add operations
-    addCondition: F,
-    addConditionGroup: S,
-    // Update operations
-    updateCondition: T,
-    updateGroupOperator: y,
-    // Remove & access
-    removeCondition: A,
-    getCondition: _,
-    // Utility
-    clearAllConditions: $,
-    setRootOperator: b
-  };
-}
-export {
-  u as a,
-  H as i,
-  L as u
-};