@eztrak/shared 0.2.4 → 0.2.5

package/README.md

@@ -26,6 +26,27 @@ import { cn, formatDate, getApiError, isEmpty } from "@eztrak/shared/utils";
 
 `cn` combines [`clsx`](https://github.com/lukeed/clsx) with [`tailwind-merge`](https://github.com/dcastil/tailwind-merge).
 
+RTK Query errors (pass your app's toast / SweetAlert):
+
+```js
+import { handleApiError } from "@eztrak/shared/utils";
+import { toast } from "react-toastify";
+import Swal from "sweetalert2";
+
+handleApiError(error, {
+  toast: (msg) => toast.error(msg),
+  showAlert: true,
+  alert: ({ title, html }) =>
+    Swal.fire({
+      title,
+      html,
+      icon: "error",
+      confirmButtonText: "OK",
+      confirmButtonColor: "#FF7335",
+    }),
+});
+```
+
 ### Hooks
 
 ```js
@@ -45,7 +66,7 @@ import { cn, useGridHeight } from "@eztrak/shared";
 | Subpath | Description |
 | --- | --- |
 | `@eztrak/shared` | Main entry — re-exports utils and hooks |
-| `@eztrak/shared/utils` | `cn`, date/format helpers, API error helpers, form field helpers |
+| `@eztrak/shared/utils` | `cn`, `handleApiError`, date/format helpers, API error helpers, form field helpers |
 | `@eztrak/shared/hooks` | `usePaginationUrlSync`, `useGridHeight` |
 
 ## Requirements

package/dist/{chunk-WARJTN5T.mjs → chunk-QVRMHJS4.mjs}

@@ -13,6 +13,48 @@ var truncateText = (text, maxLength = 20) => {
   }
   return text.slice(0, maxLength - 3) + "...";
 };
+function formatValidationErrorsHtml(errors) {
+  const items = Object.keys(errors).flatMap(
+    (field) => (errors[field] || []).map((msg) => `<li>${msg}</li>`)
+  );
+  return `
+        <div style="text-align:left">
+          <p>Please review and correct the following:</p>
+          <ul style="margin:8px 0 0 16px; list-style:disc;">
+            ${items.join("")}
+          </ul>
+        </div>
+      `;
+}
+function handleApiError(error, { showAlert = false, fallbackMessage, toast, alert } = {}) {
+  if (!error) return;
+  const status = error.status ?? error.originalStatus;
+  const data = error.data;
+  if (status === 200) {
+    return;
+  }
+  if (data?.errors && typeof data.errors === "object") {
+    const errors = data.errors;
+    if (showAlert && alert) {
+      alert({
+        title: "Validation errors",
+        html: formatValidationErrorsHtml(errors)
+      });
+    } else if (toast) {
+      Object.keys(errors).forEach((field) => {
+        (errors[field] || []).forEach((errorMessage) => {
+          toast(errorMessage);
+        });
+      });
+    }
+    return;
+  }
+  if (status === 404) {
+    return;
+  }
+  const message = fallbackMessage || data?.message || data?.title || error.error || "An error occurred. Please try again.";
+  toast?.(message);
+}
 function getApiError(apiError) {
   if (!apiError) return "An unknown error occurred";
   if (typeof apiError === "string") {
@@ -189,6 +231,8 @@ var getFieldsByInputType = (fields = [], key) => {
 export {
   cn,
   truncateText,
+  formatValidationErrorsHtml,
+  handleApiError,
   getApiError,
   normalizeApiListItems,
   capitalizeText,
@@ -209,4 +253,4 @@ export {
   removeByPropertyValues,
   getFieldsByInputType
 };
-//# sourceMappingURL=chunk-WARJTN5T.mjs.map
+//# sourceMappingURL=chunk-QVRMHJS4.mjs.map

package/dist/chunk-QVRMHJS4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/cn.ts","../src/utils/helpers.ts"],"sourcesContent":["import clsx from \"clsx\";\r\nimport { twMerge } from \"tailwind-merge\";\r\n\r\nexport function cn(...inputs: Parameters<typeof clsx>) {\r\n  return twMerge(clsx(inputs));\r\n}\r\n","export const truncateText = (text: string | null | undefined, maxLength = 20) => {\n  if (!text) return \"\";\n  if (text.length <= maxLength) {\n    return text;\n  }\n  return text.slice(0, maxLength - 3) + \"...\";\n};\n\nexport type RtkQueryError = {\n  status?: number | string;\n  originalStatus?: number;\n  data?: {\n    errors?: Record<string, string[]>;\n    message?: string;\n    title?: string;\n  };\n  error?: string;\n};\n\nexport interface HandleApiErrorOptions {\n  showAlert?: boolean;\n  fallbackMessage?: string;\n  /** Called for each validation message when showAlert is false, and for generic errors */\n  toast?: (message: string) => void;\n  /** Called for validation errors when showAlert is true (e.g. wire to SweetAlert) */\n  alert?: (params: { title: string; html: string }) => void;\n}\n\nexport function formatValidationErrorsHtml(\n  errors: Record<string, string[]>\n): string {\n  const items = Object.keys(errors).flatMap((field) =>\n    (errors[field] || []).map((msg) => `<li>${msg}</li>`)\n  );\n  return `\n        <div style=\"text-align:left\">\n          <p>Please review and correct the following:</p>\n          <ul style=\"margin:8px 0 0 16px; list-style:disc;\">\n            ${items.join(\"\")}\n          </ul>\n        </div>\n      `;\n}\n\n/**\n * Handles RTK Query / fetchBaseQuery error shapes: validation errors, 404 (silent), and generic messages.\n * Pass `toast` and optionally `alert` from your app (react-toastify, SweetAlert, etc.).\n */\nexport function handleApiError(\n  error: RtkQueryError | null | undefined,\n  { showAlert = false, fallbackMessage, toast, alert }: HandleApiErrorOptions = {}\n): void {\n  if (!error) return;\n\n  const status = error.status ?? error.originalStatus;\n  const data = error.data;\n\n  if (status === 200) {\n    return;\n  }\n\n  if (data?.errors && typeof data.errors === \"object\") {\n    const errors = data.errors;\n\n    if (showAlert && alert) {\n      alert({\n        title: \"Validation errors\",\n        html: formatValidationErrorsHtml(errors),\n      });\n    } else if (toast) {\n      Object.keys(errors).forEach((field) => {\n        (errors[field] || []).forEach((errorMessage) => {\n          toast(errorMessage);\n        });\n      });\n    }\n    return;\n  }\n\n  if (status === 404) {\n    return;\n  }\n\n  const message =\n    fallbackMessage ||\n    data?.message ||\n    data?.title ||\n    error.error ||\n    \"An error occurred. Please try again.\";\n\n  toast?.(message);\n}\n\nexport function getApiError(apiError: unknown): string {\n  if (!apiError) return \"An unknown error occurred\";\n\n  if (typeof apiError === \"string\") {\n    return apiError;\n  }\n\n  const error = apiError as {\n    response?: { data?: Record<string, unknown> };\n    message?: string;\n  };\n\n  if (error.response?.data) {\n    const responseData = error.response.data;\n\n    if (typeof responseData === \"string\") {\n      return responseData;\n    }\n\n    const errors = responseData.errors;\n    if (errors && typeof errors === \"object\") {\n      for (const key in errors) {\n        const messages = (errors as Record<string, unknown>)[key];\n        if (Array.isArray(messages) && messages.length > 0) {\n          return String(messages[0]);\n        }\n      }\n    }\n\n    if (responseData.message) {\n      return String(responseData.message);\n    }\n\n    if (responseData.title) {\n      return String(responseData.title);\n    }\n  }\n\n  if (error.message) {\n    return error.message;\n  }\n\n  return \"An unknown error occurred\";\n}\n\nexport const normalizeApiListItems = (responseData: unknown): unknown[] => {\n  if (responseData == null) return [];\n  if (Array.isArray(responseData)) return responseData;\n\n  const record = responseData as Record<string, unknown>;\n  const data = record.data;\n\n  if (\n    data &&\n    typeof data === \"object\" &&\n    !Array.isArray(data) &&\n    Array.isArray((data as { items?: unknown[] }).items)\n  ) {\n    return (data as { items: unknown[] }).items;\n  }\n\n  const returnModel = record.returnModel as { items?: unknown[] } | undefined;\n  if (Array.isArray(returnModel?.items)) return returnModel.items;\n  if (Array.isArray(data)) return data;\n  if (typeof data === \"object\" && data !== null) {\n    return [data];\n  }\n  return [];\n};\n\nexport function capitalizeText(name: string | null | undefined): string {\n  if (!name) return \"\";\n  return name\n    .split(\" \")\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n    .join(\" \");\n}\n\nexport function toLowerCaseText(text: string | null | undefined): string {\n  if (!text) return \"\";\n  return text.toLowerCase();\n}\n\nexport const formatDate = (dateString: string | null | undefined): string => {\n  if (dateString === null || dateString === undefined) return \"-\";\n  const date = new Date(dateString);\n\n  if (isNaN(date.getTime())) {\n    return dateString;\n  }\n\n  const month = (date.getMonth() + 1).toString().padStart(2, \"0\");\n  const day = date.getDate().toString().padStart(2, \"0\");\n  const year = date.getFullYear().toString().slice(-2);\n  return `${month}/${day}/${year}`;\n};\n\nexport const isEmpty = (obj: object): boolean => {\n  return Object.keys(obj).length === 0;\n};\n\nexport const toDateInputValue = (date: string | Date | null | undefined): string => {\n  if (!date) return \"\";\n\n  let d: Date;\n\n  if (typeof date === \"string\") {\n    if (/^\\d{4}-\\d{2}-\\d{2}$/.test(date)) {\n      return date;\n    }\n    d = new Date(date);\n  } else {\n    d = new Date(date);\n  }\n\n  if (isNaN(d.getTime())) return \"\";\n\n  const localDate = new Date(d.getTime() - d.getTimezoneOffset() * 60000);\n  const year = localDate.getFullYear();\n  const month = (localDate.getMonth() + 1).toString().padStart(2, \"0\");\n  const day = localDate.getDate().toString().padStart(2, \"0\");\n\n  return `${year}-${month}-${day}`;\n};\n\nexport function convertCommaDataToArray(data: string | null | undefined): string[] {\n  if (!data || data.trim() === \"\") {\n    return [];\n  }\n  return data.split(\",\").map((item) => item.trim());\n}\n\nexport function checkIfExistsInArray<T>(array: T[], searchValue: T): boolean {\n  return array.includes(searchValue);\n}\n\nexport const currencyFormatter = (value: number | null | undefined): string => {\n  return value?.toLocaleString(\"en-US\", {\n    style: \"currency\",\n    currency: \"USD\",\n  }) ?? \"\";\n};\n\nexport const parseCurrencyValueToNumber = (value: unknown): number => {\n  if (value == null || value === \"\") return 0;\n\n  const raw =\n    typeof value === \"object\" && value !== null && \"value\" in value\n      ? (value as { value: unknown }).value\n      : value;\n\n  const stringValue = raw == null || raw === \"\" ? \"\" : String(raw);\n  const numericValue = stringValue.replace(/[$,]/g, \"\");\n  return parseFloat(numericValue) || 0;\n};\n\nexport function flattenTableData<T extends Record<string, unknown>>(\n  data: T[] | null | undefined,\n  columns: { field?: string }[] | null | undefined\n): T[] {\n  if (!Array.isArray(data)) return [];\n  return data.map((row) => {\n    const flatRow = { ...row };\n    (columns ?? []).forEach((col) => {\n      const key = col.field;\n      if (!key) return;\n      if (key.includes(\".\")) {\n        const value = key.split(\".\").reduce<unknown>(\n          (acc, part) => (acc as Record<string, unknown> | undefined)?.[part],\n          row\n        );\n        (flatRow as Record<string, unknown>)[key] = value ?? \"\";\n      }\n    });\n    return flatRow;\n  });\n}\n\nexport const getErrorMessages = (error: {\n  data?: {\n    errors?: Record<string, string[]>;\n    title?: string;\n    error?: { name?: string[] };\n  };\n} | null | undefined): string => {\n  if (error?.data?.errors) {\n    return Object.values(error.data.errors).flat().join(\"\\n\");\n  }\n  return (\n    error?.data?.title ??\n    error?.data?.error?.name?.[0] ??\n    \"Failed to save\"\n  );\n};\n\nexport const getFieldsByCategory = <T extends { category?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields?.filter(({ category = \"\" }) => category === key);\n};\n\nexport const getFieldsByName = <T extends { name?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields.filter(({ name = \"\" }) => name === key);\n};\n\nexport const deserializeJson = <T = unknown>(jsonString: string): T | null => {\n  try {\n    return JSON.parse(jsonString) as T;\n  } catch (error) {\n    console.error(\"Error parsing JSON:\", error);\n    return null;\n  }\n};\n\nexport const formatDateTime = (dateString: string | null | undefined): string => {\n  if (!dateString) return \"Invalid Date\";\n  const date = new Date(dateString);\n  if (isNaN(date.getTime())) return \"Invalid Date\";\n  const options: Intl.DateTimeFormatOptions = {\n    year: \"numeric\",\n    month: \"numeric\",\n    day: \"numeric\",\n    hour: \"numeric\",\n    minute: \"numeric\",\n    hour12: true,\n  };\n  return date.toLocaleString(\"en-US\", options);\n};\n\nexport const removeByPropertyValues = <T extends Record<string, unknown>>(\n  items: T[] = [],\n  property: keyof T & string,\n  values: unknown[] = [],\n  { caseInsensitive = false }: { caseInsensitive?: boolean } = {}\n): T[] => {\n  if (!Array.isArray(items) || !property) return Array.isArray(items) ? items : [];\n  const normalize = (v: unknown) =>\n    caseInsensitive && typeof v === \"string\" ? v.toLowerCase() : v;\n  const valuesArr = Array.isArray(values) ? values : [values];\n  const toRemove = new Set(valuesArr.map(normalize));\n  return items.filter((item) => !toRemove.has(normalize(item?.[property])));\n};\n\nexport const getFieldsByInputType = <T extends { inputType?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields.filter(({ inputType = \"\" }) => inputType === key);\n};\n"],"mappings":"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","names":[]}

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-export { capitalizeText, checkIfExistsInArray, cn, convertCommaDataToArray, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, isEmpty, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, toDateInputValue, toLowerCaseText, truncateText } from './utils/index.mjs';
+export { HandleApiErrorOptions, RtkQueryError, capitalizeText, checkIfExistsInArray, cn, convertCommaDataToArray, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, formatValidationErrorsHtml, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, handleApiError, isEmpty, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, toDateInputValue, toLowerCaseText, truncateText } from './utils/index.mjs';
 export { UseGridHeightOptions, useGridHeight, usePaginationUrlSync } from './hooks/index.mjs';
 import 'clsx';
 import 'react-router-dom';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { capitalizeText, checkIfExistsInArray, cn, convertCommaDataToArray, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, isEmpty, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, toDateInputValue, toLowerCaseText, truncateText } from './utils/index.js';
+export { HandleApiErrorOptions, RtkQueryError, capitalizeText, checkIfExistsInArray, cn, convertCommaDataToArray, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, formatValidationErrorsHtml, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, handleApiError, isEmpty, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, toDateInputValue, toLowerCaseText, truncateText } from './utils/index.js';
 export { UseGridHeightOptions, useGridHeight, usePaginationUrlSync } from './hooks/index.js';
 import 'clsx';
 import 'react-router-dom';

package/dist/index.js

@@ -39,11 +39,13 @@ __export(src_exports, {
   flattenTableData: () => flattenTableData,
   formatDate: () => formatDate,
   formatDateTime: () => formatDateTime,
+  formatValidationErrorsHtml: () => formatValidationErrorsHtml,
   getApiError: () => getApiError,
   getErrorMessages: () => getErrorMessages,
   getFieldsByCategory: () => getFieldsByCategory,
   getFieldsByInputType: () => getFieldsByInputType,
   getFieldsByName: () => getFieldsByName,
+  handleApiError: () => handleApiError,
   isEmpty: () => isEmpty,
   normalizeApiListItems: () => normalizeApiListItems,
   parseCurrencyValueToNumber: () => parseCurrencyValueToNumber,
@@ -71,6 +73,48 @@ var truncateText = (text, maxLength = 20) => {
   }
   return text.slice(0, maxLength - 3) + "...";
 };
+function formatValidationErrorsHtml(errors) {
+  const items = Object.keys(errors).flatMap(
+    (field) => (errors[field] || []).map((msg) => `<li>${msg}</li>`)
+  );
+  return `
+        <div style="text-align:left">
+          <p>Please review and correct the following:</p>
+          <ul style="margin:8px 0 0 16px; list-style:disc;">
+            ${items.join("")}
+          </ul>
+        </div>
+      `;
+}
+function handleApiError(error, { showAlert = false, fallbackMessage, toast, alert } = {}) {
+  if (!error) return;
+  const status = error.status ?? error.originalStatus;
+  const data = error.data;
+  if (status === 200) {
+    return;
+  }
+  if (data?.errors && typeof data.errors === "object") {
+    const errors = data.errors;
+    if (showAlert && alert) {
+      alert({
+        title: "Validation errors",
+        html: formatValidationErrorsHtml(errors)
+      });
+    } else if (toast) {
+      Object.keys(errors).forEach((field) => {
+        (errors[field] || []).forEach((errorMessage) => {
+          toast(errorMessage);
+        });
+      });
+    }
+    return;
+  }
+  if (status === 404) {
+    return;
+  }
+  const message = fallbackMessage || data?.message || data?.title || error.error || "An error occurred. Please try again.";
+  toast?.(message);
+}
 function getApiError(apiError) {
   if (!apiError) return "An unknown error occurred";
   if (typeof apiError === "string") {
@@ -321,11 +365,13 @@ var useGridHeight = ({
   flattenTableData,
   formatDate,
   formatDateTime,
+  formatValidationErrorsHtml,
   getApiError,
   getErrorMessages,
   getFieldsByCategory,
   getFieldsByInputType,
   getFieldsByName,
+  handleApiError,
   isEmpty,
   normalizeApiListItems,
   parseCurrencyValueToNumber,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/utils/cn.ts","../src/utils/helpers.ts","../src/hooks/usePaginationUrlSync.ts","../src/hooks/useGridHeight.ts"],"sourcesContent":["export * from \"./utils\";\nexport * from \"./hooks\";\n","import clsx from \"clsx\";\r\nimport { twMerge } from \"tailwind-merge\";\r\n\r\nexport function cn(...inputs: Parameters<typeof clsx>) {\r\n  return twMerge(clsx(inputs));\r\n}\r\n","export const truncateText = (text: string | null | undefined, maxLength = 20) => {\n  if (!text) return \"\";\n  if (text.length <= maxLength) {\n    return text;\n  }\n  return text.slice(0, maxLength - 3) + \"...\";\n};\n\nexport function getApiError(apiError: unknown): string {\n  if (!apiError) return \"An unknown error occurred\";\n\n  if (typeof apiError === \"string\") {\n    return apiError;\n  }\n\n  const error = apiError as {\n    response?: { data?: Record<string, unknown> };\n    message?: string;\n  };\n\n  if (error.response?.data) {\n    const responseData = error.response.data;\n\n    if (typeof responseData === \"string\") {\n      return responseData;\n    }\n\n    const errors = responseData.errors;\n    if (errors && typeof errors === \"object\") {\n      for (const key in errors) {\n        const messages = (errors as Record<string, unknown>)[key];\n        if (Array.isArray(messages) && messages.length > 0) {\n          return String(messages[0]);\n        }\n      }\n    }\n\n    if (responseData.message) {\n      return String(responseData.message);\n    }\n\n    if (responseData.title) {\n      return String(responseData.title);\n    }\n  }\n\n  if (error.message) {\n    return error.message;\n  }\n\n  return \"An unknown error occurred\";\n}\n\nexport const normalizeApiListItems = (responseData: unknown): unknown[] => {\n  if (responseData == null) return [];\n  if (Array.isArray(responseData)) return responseData;\n\n  const record = responseData as Record<string, unknown>;\n  const data = record.data;\n\n  if (\n    data &&\n    typeof data === \"object\" &&\n    !Array.isArray(data) &&\n    Array.isArray((data as { items?: unknown[] }).items)\n  ) {\n    return (data as { items: unknown[] }).items;\n  }\n\n  const returnModel = record.returnModel as { items?: unknown[] } | undefined;\n  if (Array.isArray(returnModel?.items)) return returnModel.items;\n  if (Array.isArray(data)) return data;\n  if (typeof data === \"object\" && data !== null) {\n    return [data];\n  }\n  return [];\n};\n\nexport function capitalizeText(name: string | null | undefined): string {\n  if (!name) return \"\";\n  return name\n    .split(\" \")\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n    .join(\" \");\n}\n\nexport function toLowerCaseText(text: string | null | undefined): string {\n  if (!text) return \"\";\n  return text.toLowerCase();\n}\n\nexport const formatDate = (dateString: string | null | undefined): string => {\n  if (dateString === null || dateString === undefined) return \"-\";\n  const date = new Date(dateString);\n\n  if (isNaN(date.getTime())) {\n    return dateString;\n  }\n\n  const month = (date.getMonth() + 1).toString().padStart(2, \"0\");\n  const day = date.getDate().toString().padStart(2, \"0\");\n  const year = date.getFullYear().toString().slice(-2);\n  return `${month}/${day}/${year}`;\n};\n\nexport const isEmpty = (obj: object): boolean => {\n  return Object.keys(obj).length === 0;\n};\n\nexport const toDateInputValue = (date: string | Date | null | undefined): string => {\n  if (!date) return \"\";\n\n  let d: Date;\n\n  if (typeof date === \"string\") {\n    if (/^\\d{4}-\\d{2}-\\d{2}$/.test(date)) {\n      return date;\n    }\n    d = new Date(date);\n  } else {\n    d = new Date(date);\n  }\n\n  if (isNaN(d.getTime())) return \"\";\n\n  const localDate = new Date(d.getTime() - d.getTimezoneOffset() * 60000);\n  const year = localDate.getFullYear();\n  const month = (localDate.getMonth() + 1).toString().padStart(2, \"0\");\n  const day = localDate.getDate().toString().padStart(2, \"0\");\n\n  return `${year}-${month}-${day}`;\n};\n\nexport function convertCommaDataToArray(data: string | null | undefined): string[] {\n  if (!data || data.trim() === \"\") {\n    return [];\n  }\n  return data.split(\",\").map((item) => item.trim());\n}\n\nexport function checkIfExistsInArray<T>(array: T[], searchValue: T): boolean {\n  return array.includes(searchValue);\n}\n\nexport const currencyFormatter = (value: number | null | undefined): string => {\n  return value?.toLocaleString(\"en-US\", {\n    style: \"currency\",\n    currency: \"USD\",\n  }) ?? \"\";\n};\n\nexport const parseCurrencyValueToNumber = (value: unknown): number => {\n  if (value == null || value === \"\") return 0;\n\n  const raw =\n    typeof value === \"object\" && value !== null && \"value\" in value\n      ? (value as { value: unknown }).value\n      : value;\n\n  const stringValue = raw == null || raw === \"\" ? \"\" : String(raw);\n  const numericValue = stringValue.replace(/[$,]/g, \"\");\n  return parseFloat(numericValue) || 0;\n};\n\nexport function flattenTableData<T extends Record<string, unknown>>(\n  data: T[] | null | undefined,\n  columns: { field?: string }[] | null | undefined\n): T[] {\n  if (!Array.isArray(data)) return [];\n  return data.map((row) => {\n    const flatRow = { ...row };\n    (columns ?? []).forEach((col) => {\n      const key = col.field;\n      if (!key) return;\n      if (key.includes(\".\")) {\n        const value = key.split(\".\").reduce<unknown>(\n          (acc, part) => (acc as Record<string, unknown> | undefined)?.[part],\n          row\n        );\n        (flatRow as Record<string, unknown>)[key] = value ?? \"\";\n      }\n    });\n    return flatRow;\n  });\n}\n\nexport const getErrorMessages = (error: {\n  data?: {\n    errors?: Record<string, string[]>;\n    title?: string;\n    error?: { name?: string[] };\n  };\n} | null | undefined): string => {\n  if (error?.data?.errors) {\n    return Object.values(error.data.errors).flat().join(\"\\n\");\n  }\n  return (\n    error?.data?.title ??\n    error?.data?.error?.name?.[0] ??\n    \"Failed to save\"\n  );\n};\n\nexport const getFieldsByCategory = <T extends { category?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields?.filter(({ category = \"\" }) => category === key);\n};\n\nexport const getFieldsByName = <T extends { name?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields.filter(({ name = \"\" }) => name === key);\n};\n\nexport const deserializeJson = <T = unknown>(jsonString: string): T | null => {\n  try {\n    return JSON.parse(jsonString) as T;\n  } catch (error) {\n    console.error(\"Error parsing JSON:\", error);\n    return null;\n  }\n};\n\nexport const formatDateTime = (dateString: string | null | undefined): string => {\n  if (!dateString) return \"Invalid Date\";\n  const date = new Date(dateString);\n  if (isNaN(date.getTime())) return \"Invalid Date\";\n  const options: Intl.DateTimeFormatOptions = {\n    year: \"numeric\",\n    month: \"numeric\",\n    day: \"numeric\",\n    hour: \"numeric\",\n    minute: \"numeric\",\n    hour12: true,\n  };\n  return date.toLocaleString(\"en-US\", options);\n};\n\nexport const removeByPropertyValues = <T extends Record<string, unknown>>(\n  items: T[] = [],\n  property: keyof T & string,\n  values: unknown[] = [],\n  { caseInsensitive = false }: { caseInsensitive?: boolean } = {}\n): T[] => {\n  if (!Array.isArray(items) || !property) return Array.isArray(items) ? items : [];\n  const normalize = (v: unknown) =>\n    caseInsensitive && typeof v === \"string\" ? v.toLowerCase() : v;\n  const valuesArr = Array.isArray(values) ? values : [values];\n  const toRemove = new Set(valuesArr.map(normalize));\n  return items.filter((item) => !toRemove.has(normalize(item?.[property])));\n};\n\nexport const getFieldsByInputType = <T extends { inputType?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields.filter(({ inputType = \"\" }) => inputType === key);\n};\n","import { useEffect } from \"react\";\nimport type { SetURLSearchParams } from \"react-router-dom\";\n\nexport const usePaginationUrlSync = (\n  searchParams: URLSearchParams,\n  setSearchParams: SetURLSearchParams,\n  page: number,\n  setPage: (page: number) => void,\n  perPage: number,\n  setPerPage: (perPage: number) => void,\n  defaultPage = 1,\n  defaultPerPage = 20\n) => {\n  useEffect(() => {\n    const currentUrlPage = parseInt(searchParams.get(\"page\") ?? \"\") || defaultPage;\n    const currentUrlPerPage =\n      parseInt(searchParams.get(\"perPage\") ?? \"\") || defaultPerPage;\n    const hasPageParam = searchParams.has(\"page\");\n    const hasPerPageParam = searchParams.has(\"perPage\");\n\n    if (!hasPageParam || !hasPerPageParam) {\n      const newParams = new URLSearchParams(searchParams);\n\n      if (!hasPageParam) {\n        newParams.set(\"page\", defaultPage.toString());\n      }\n\n      if (!hasPerPageParam) {\n        newParams.set(\"perPage\", defaultPerPage.toString());\n      }\n\n      setSearchParams(newParams, { replace: true });\n      return;\n    }\n\n    if (currentUrlPage !== page) {\n      setPage(currentUrlPage);\n    }\n\n    if (currentUrlPerPage !== perPage) {\n      setPerPage(currentUrlPerPage);\n    }\n  }, [\n    searchParams,\n    setSearchParams,\n    page,\n    setPage,\n    perPage,\n    setPerPage,\n    defaultPage,\n    defaultPerPage,\n  ]);\n};\n","import { useEffect, useState } from \"react\";\n\nexport interface UseGridHeightOptions {\n  height?: string;\n  headerId?: string;\n  footerId?: string;\n  offset?: number;\n}\n\nexport const useGridHeight = ({\n  height,\n  headerId = \"layout-header\",\n  footerId = \"layout-footer\",\n  offset = 390,\n}: UseGridHeightOptions = {}) => {\n  const [gridHeight, setGridHeight] = useState(height || \"300px\");\n\n  useEffect(() => {\n    if (height) {\n      setGridHeight(height);\n      return;\n    }\n\n    const calculateHeight = () => {\n      const header = document.getElementById(headerId);\n      const footer = document.getElementById(footerId);\n\n      const headerHeight = header ? header.offsetHeight : 0;\n      const footerHeight = footer ? footer.offsetHeight : 0;\n      const totalHeight = window.innerHeight;\n\n      const remainingHeight = totalHeight - headerHeight - footerHeight - offset;\n      setGridHeight(`${remainingHeight}px`);\n    };\n\n    calculateHeight();\n    window.addEventListener(\"resize\", calculateHeight);\n    return () => window.removeEventListener(\"resize\", calculateHeight);\n  }, [height, headerId, footerId, offset]);\n\n  return gridHeight;\n};\n"],"mappings":"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","names":["clsx","import_react"]}
+{"version":3,"sources":["../src/index.ts","../src/utils/cn.ts","../src/utils/helpers.ts","../src/hooks/usePaginationUrlSync.ts","../src/hooks/useGridHeight.ts"],"sourcesContent":["export * from \"./utils\";\nexport * from \"./hooks\";\n","import clsx from \"clsx\";\r\nimport { twMerge } from \"tailwind-merge\";\r\n\r\nexport function cn(...inputs: Parameters<typeof clsx>) {\r\n  return twMerge(clsx(inputs));\r\n}\r\n","export const truncateText = (text: string | null | undefined, maxLength = 20) => {\n  if (!text) return \"\";\n  if (text.length <= maxLength) {\n    return text;\n  }\n  return text.slice(0, maxLength - 3) + \"...\";\n};\n\nexport type RtkQueryError = {\n  status?: number | string;\n  originalStatus?: number;\n  data?: {\n    errors?: Record<string, string[]>;\n    message?: string;\n    title?: string;\n  };\n  error?: string;\n};\n\nexport interface HandleApiErrorOptions {\n  showAlert?: boolean;\n  fallbackMessage?: string;\n  /** Called for each validation message when showAlert is false, and for generic errors */\n  toast?: (message: string) => void;\n  /** Called for validation errors when showAlert is true (e.g. wire to SweetAlert) */\n  alert?: (params: { title: string; html: string }) => void;\n}\n\nexport function formatValidationErrorsHtml(\n  errors: Record<string, string[]>\n): string {\n  const items = Object.keys(errors).flatMap((field) =>\n    (errors[field] || []).map((msg) => `<li>${msg}</li>`)\n  );\n  return `\n        <div style=\"text-align:left\">\n          <p>Please review and correct the following:</p>\n          <ul style=\"margin:8px 0 0 16px; list-style:disc;\">\n            ${items.join(\"\")}\n          </ul>\n        </div>\n      `;\n}\n\n/**\n * Handles RTK Query / fetchBaseQuery error shapes: validation errors, 404 (silent), and generic messages.\n * Pass `toast` and optionally `alert` from your app (react-toastify, SweetAlert, etc.).\n */\nexport function handleApiError(\n  error: RtkQueryError | null | undefined,\n  { showAlert = false, fallbackMessage, toast, alert }: HandleApiErrorOptions = {}\n): void {\n  if (!error) return;\n\n  const status = error.status ?? error.originalStatus;\n  const data = error.data;\n\n  if (status === 200) {\n    return;\n  }\n\n  if (data?.errors && typeof data.errors === \"object\") {\n    const errors = data.errors;\n\n    if (showAlert && alert) {\n      alert({\n        title: \"Validation errors\",\n        html: formatValidationErrorsHtml(errors),\n      });\n    } else if (toast) {\n      Object.keys(errors).forEach((field) => {\n        (errors[field] || []).forEach((errorMessage) => {\n          toast(errorMessage);\n        });\n      });\n    }\n    return;\n  }\n\n  if (status === 404) {\n    return;\n  }\n\n  const message =\n    fallbackMessage ||\n    data?.message ||\n    data?.title ||\n    error.error ||\n    \"An error occurred. Please try again.\";\n\n  toast?.(message);\n}\n\nexport function getApiError(apiError: unknown): string {\n  if (!apiError) return \"An unknown error occurred\";\n\n  if (typeof apiError === \"string\") {\n    return apiError;\n  }\n\n  const error = apiError as {\n    response?: { data?: Record<string, unknown> };\n    message?: string;\n  };\n\n  if (error.response?.data) {\n    const responseData = error.response.data;\n\n    if (typeof responseData === \"string\") {\n      return responseData;\n    }\n\n    const errors = responseData.errors;\n    if (errors && typeof errors === \"object\") {\n      for (const key in errors) {\n        const messages = (errors as Record<string, unknown>)[key];\n        if (Array.isArray(messages) && messages.length > 0) {\n          return String(messages[0]);\n        }\n      }\n    }\n\n    if (responseData.message) {\n      return String(responseData.message);\n    }\n\n    if (responseData.title) {\n      return String(responseData.title);\n    }\n  }\n\n  if (error.message) {\n    return error.message;\n  }\n\n  return \"An unknown error occurred\";\n}\n\nexport const normalizeApiListItems = (responseData: unknown): unknown[] => {\n  if (responseData == null) return [];\n  if (Array.isArray(responseData)) return responseData;\n\n  const record = responseData as Record<string, unknown>;\n  const data = record.data;\n\n  if (\n    data &&\n    typeof data === \"object\" &&\n    !Array.isArray(data) &&\n    Array.isArray((data as { items?: unknown[] }).items)\n  ) {\n    return (data as { items: unknown[] }).items;\n  }\n\n  const returnModel = record.returnModel as { items?: unknown[] } | undefined;\n  if (Array.isArray(returnModel?.items)) return returnModel.items;\n  if (Array.isArray(data)) return data;\n  if (typeof data === \"object\" && data !== null) {\n    return [data];\n  }\n  return [];\n};\n\nexport function capitalizeText(name: string | null | undefined): string {\n  if (!name) return \"\";\n  return name\n    .split(\" \")\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n    .join(\" \");\n}\n\nexport function toLowerCaseText(text: string | null | undefined): string {\n  if (!text) return \"\";\n  return text.toLowerCase();\n}\n\nexport const formatDate = (dateString: string | null | undefined): string => {\n  if (dateString === null || dateString === undefined) return \"-\";\n  const date = new Date(dateString);\n\n  if (isNaN(date.getTime())) {\n    return dateString;\n  }\n\n  const month = (date.getMonth() + 1).toString().padStart(2, \"0\");\n  const day = date.getDate().toString().padStart(2, \"0\");\n  const year = date.getFullYear().toString().slice(-2);\n  return `${month}/${day}/${year}`;\n};\n\nexport const isEmpty = (obj: object): boolean => {\n  return Object.keys(obj).length === 0;\n};\n\nexport const toDateInputValue = (date: string | Date | null | undefined): string => {\n  if (!date) return \"\";\n\n  let d: Date;\n\n  if (typeof date === \"string\") {\n    if (/^\\d{4}-\\d{2}-\\d{2}$/.test(date)) {\n      return date;\n    }\n    d = new Date(date);\n  } else {\n    d = new Date(date);\n  }\n\n  if (isNaN(d.getTime())) return \"\";\n\n  const localDate = new Date(d.getTime() - d.getTimezoneOffset() * 60000);\n  const year = localDate.getFullYear();\n  const month = (localDate.getMonth() + 1).toString().padStart(2, \"0\");\n  const day = localDate.getDate().toString().padStart(2, \"0\");\n\n  return `${year}-${month}-${day}`;\n};\n\nexport function convertCommaDataToArray(data: string | null | undefined): string[] {\n  if (!data || data.trim() === \"\") {\n    return [];\n  }\n  return data.split(\",\").map((item) => item.trim());\n}\n\nexport function checkIfExistsInArray<T>(array: T[], searchValue: T): boolean {\n  return array.includes(searchValue);\n}\n\nexport const currencyFormatter = (value: number | null | undefined): string => {\n  return value?.toLocaleString(\"en-US\", {\n    style: \"currency\",\n    currency: \"USD\",\n  }) ?? \"\";\n};\n\nexport const parseCurrencyValueToNumber = (value: unknown): number => {\n  if (value == null || value === \"\") return 0;\n\n  const raw =\n    typeof value === \"object\" && value !== null && \"value\" in value\n      ? (value as { value: unknown }).value\n      : value;\n\n  const stringValue = raw == null || raw === \"\" ? \"\" : String(raw);\n  const numericValue = stringValue.replace(/[$,]/g, \"\");\n  return parseFloat(numericValue) || 0;\n};\n\nexport function flattenTableData<T extends Record<string, unknown>>(\n  data: T[] | null | undefined,\n  columns: { field?: string }[] | null | undefined\n): T[] {\n  if (!Array.isArray(data)) return [];\n  return data.map((row) => {\n    const flatRow = { ...row };\n    (columns ?? []).forEach((col) => {\n      const key = col.field;\n      if (!key) return;\n      if (key.includes(\".\")) {\n        const value = key.split(\".\").reduce<unknown>(\n          (acc, part) => (acc as Record<string, unknown> | undefined)?.[part],\n          row\n        );\n        (flatRow as Record<string, unknown>)[key] = value ?? \"\";\n      }\n    });\n    return flatRow;\n  });\n}\n\nexport const getErrorMessages = (error: {\n  data?: {\n    errors?: Record<string, string[]>;\n    title?: string;\n    error?: { name?: string[] };\n  };\n} | null | undefined): string => {\n  if (error?.data?.errors) {\n    return Object.values(error.data.errors).flat().join(\"\\n\");\n  }\n  return (\n    error?.data?.title ??\n    error?.data?.error?.name?.[0] ??\n    \"Failed to save\"\n  );\n};\n\nexport const getFieldsByCategory = <T extends { category?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields?.filter(({ category = \"\" }) => category === key);\n};\n\nexport const getFieldsByName = <T extends { name?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields.filter(({ name = \"\" }) => name === key);\n};\n\nexport const deserializeJson = <T = unknown>(jsonString: string): T | null => {\n  try {\n    return JSON.parse(jsonString) as T;\n  } catch (error) {\n    console.error(\"Error parsing JSON:\", error);\n    return null;\n  }\n};\n\nexport const formatDateTime = (dateString: string | null | undefined): string => {\n  if (!dateString) return \"Invalid Date\";\n  const date = new Date(dateString);\n  if (isNaN(date.getTime())) return \"Invalid Date\";\n  const options: Intl.DateTimeFormatOptions = {\n    year: \"numeric\",\n    month: \"numeric\",\n    day: \"numeric\",\n    hour: \"numeric\",\n    minute: \"numeric\",\n    hour12: true,\n  };\n  return date.toLocaleString(\"en-US\", options);\n};\n\nexport const removeByPropertyValues = <T extends Record<string, unknown>>(\n  items: T[] = [],\n  property: keyof T & string,\n  values: unknown[] = [],\n  { caseInsensitive = false }: { caseInsensitive?: boolean } = {}\n): T[] => {\n  if (!Array.isArray(items) || !property) return Array.isArray(items) ? items : [];\n  const normalize = (v: unknown) =>\n    caseInsensitive && typeof v === \"string\" ? v.toLowerCase() : v;\n  const valuesArr = Array.isArray(values) ? values : [values];\n  const toRemove = new Set(valuesArr.map(normalize));\n  return items.filter((item) => !toRemove.has(normalize(item?.[property])));\n};\n\nexport const getFieldsByInputType = <T extends { inputType?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields.filter(({ inputType = \"\" }) => inputType === key);\n};\n","import { useEffect } from \"react\";\nimport type { SetURLSearchParams } from \"react-router-dom\";\n\nexport const usePaginationUrlSync = (\n  searchParams: URLSearchParams,\n  setSearchParams: SetURLSearchParams,\n  page: number,\n  setPage: (page: number) => void,\n  perPage: number,\n  setPerPage: (perPage: number) => void,\n  defaultPage = 1,\n  defaultPerPage = 20\n) => {\n  useEffect(() => {\n    const currentUrlPage = parseInt(searchParams.get(\"page\") ?? \"\") || defaultPage;\n    const currentUrlPerPage =\n      parseInt(searchParams.get(\"perPage\") ?? \"\") || defaultPerPage;\n    const hasPageParam = searchParams.has(\"page\");\n    const hasPerPageParam = searchParams.has(\"perPage\");\n\n    if (!hasPageParam || !hasPerPageParam) {\n      const newParams = new URLSearchParams(searchParams);\n\n      if (!hasPageParam) {\n        newParams.set(\"page\", defaultPage.toString());\n      }\n\n      if (!hasPerPageParam) {\n        newParams.set(\"perPage\", defaultPerPage.toString());\n      }\n\n      setSearchParams(newParams, { replace: true });\n      return;\n    }\n\n    if (currentUrlPage !== page) {\n      setPage(currentUrlPage);\n    }\n\n    if (currentUrlPerPage !== perPage) {\n      setPerPage(currentUrlPerPage);\n    }\n  }, [\n    searchParams,\n    setSearchParams,\n    page,\n    setPage,\n    perPage,\n    setPerPage,\n    defaultPage,\n    defaultPerPage,\n  ]);\n};\n","import { useEffect, useState } from \"react\";\n\nexport interface UseGridHeightOptions {\n  height?: string;\n  headerId?: string;\n  footerId?: string;\n  offset?: number;\n}\n\nexport const useGridHeight = ({\n  height,\n  headerId = \"layout-header\",\n  footerId = \"layout-footer\",\n  offset = 390,\n}: UseGridHeightOptions = {}) => {\n  const [gridHeight, setGridHeight] = useState(height || \"300px\");\n\n  useEffect(() => {\n    if (height) {\n      setGridHeight(height);\n      return;\n    }\n\n    const calculateHeight = () => {\n      const header = document.getElementById(headerId);\n      const footer = document.getElementById(footerId);\n\n      const headerHeight = header ? header.offsetHeight : 0;\n      const footerHeight = footer ? footer.offsetHeight : 0;\n      const totalHeight = window.innerHeight;\n\n      const remainingHeight = totalHeight - headerHeight - footerHeight - offset;\n      setGridHeight(`${remainingHeight}px`);\n    };\n\n    calculateHeight();\n    window.addEventListener(\"resize\", calculateHeight);\n    return () => window.removeEventListener(\"resize\", calculateHeight);\n  }, [height, headerId, footerId, offset]);\n\n  return gridHeight;\n};\n"],"mappings":"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","names":["clsx","import_react"]}

package/dist/index.mjs

@@ -8,11 +8,13 @@ import {
   flattenTableData,
   formatDate,
   formatDateTime,
+  formatValidationErrorsHtml,
   getApiError,
   getErrorMessages,
   getFieldsByCategory,
   getFieldsByInputType,
   getFieldsByName,
+  handleApiError,
   isEmpty,
   normalizeApiListItems,
   parseCurrencyValueToNumber,
@@ -20,7 +22,7 @@ import {
   toDateInputValue,
   toLowerCaseText,
   truncateText
-} from "./chunk-WARJTN5T.mjs";
+} from "./chunk-QVRMHJS4.mjs";
 import {
   useGridHeight,
   usePaginationUrlSync
@@ -35,11 +37,13 @@ export {
   flattenTableData,
   formatDate,
   formatDateTime,
+  formatValidationErrorsHtml,
   getApiError,
   getErrorMessages,
   getFieldsByCategory,
   getFieldsByInputType,
   getFieldsByName,
+  handleApiError,
   isEmpty,
   normalizeApiListItems,
   parseCurrencyValueToNumber,

package/dist/utils/index.d.mts

@@ -3,6 +3,33 @@ import clsx from 'clsx';
 declare function cn(...inputs: Parameters<typeof clsx>): string;
 
 declare const truncateText: (text: string | null | undefined, maxLength?: number) => string;
+type RtkQueryError = {
+    status?: number | string;
+    originalStatus?: number;
+    data?: {
+        errors?: Record<string, string[]>;
+        message?: string;
+        title?: string;
+    };
+    error?: string;
+};
+interface HandleApiErrorOptions {
+    showAlert?: boolean;
+    fallbackMessage?: string;
+    /** Called for each validation message when showAlert is false, and for generic errors */
+    toast?: (message: string) => void;
+    /** Called for validation errors when showAlert is true (e.g. wire to SweetAlert) */
+    alert?: (params: {
+        title: string;
+        html: string;
+    }) => void;
+}
+declare function formatValidationErrorsHtml(errors: Record<string, string[]>): string;
+/**
+ * Handles RTK Query / fetchBaseQuery error shapes: validation errors, 404 (silent), and generic messages.
+ * Pass `toast` and optionally `alert` from your app (react-toastify, SweetAlert, etc.).
+ */
+declare function handleApiError(error: RtkQueryError | null | undefined, { showAlert, fallbackMessage, toast, alert }?: HandleApiErrorOptions): void;
 declare function getApiError(apiError: unknown): string;
 declare const normalizeApiListItems: (responseData: unknown) => unknown[];
 declare function capitalizeText(name: string | null | undefined): string;
@@ -41,4 +68,4 @@ declare const getFieldsByInputType: <T extends {
     inputType?: string;
 }>(fields: T[] | undefined, key: string) => T[];
 
-export { capitalizeText, checkIfExistsInArray, cn, convertCommaDataToArray, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, isEmpty, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, toDateInputValue, toLowerCaseText, truncateText };
+export { type HandleApiErrorOptions, type RtkQueryError, capitalizeText, checkIfExistsInArray, cn, convertCommaDataToArray, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, formatValidationErrorsHtml, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, handleApiError, isEmpty, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, toDateInputValue, toLowerCaseText, truncateText };

package/dist/utils/index.d.ts

@@ -3,6 +3,33 @@ import clsx from 'clsx';
 declare function cn(...inputs: Parameters<typeof clsx>): string;
 
 declare const truncateText: (text: string | null | undefined, maxLength?: number) => string;
+type RtkQueryError = {
+    status?: number | string;
+    originalStatus?: number;
+    data?: {
+        errors?: Record<string, string[]>;
+        message?: string;
+        title?: string;
+    };
+    error?: string;
+};
+interface HandleApiErrorOptions {
+    showAlert?: boolean;
+    fallbackMessage?: string;
+    /** Called for each validation message when showAlert is false, and for generic errors */
+    toast?: (message: string) => void;
+    /** Called for validation errors when showAlert is true (e.g. wire to SweetAlert) */
+    alert?: (params: {
+        title: string;
+        html: string;
+    }) => void;
+}
+declare function formatValidationErrorsHtml(errors: Record<string, string[]>): string;
+/**
+ * Handles RTK Query / fetchBaseQuery error shapes: validation errors, 404 (silent), and generic messages.
+ * Pass `toast` and optionally `alert` from your app (react-toastify, SweetAlert, etc.).
+ */
+declare function handleApiError(error: RtkQueryError | null | undefined, { showAlert, fallbackMessage, toast, alert }?: HandleApiErrorOptions): void;
 declare function getApiError(apiError: unknown): string;
 declare const normalizeApiListItems: (responseData: unknown) => unknown[];
 declare function capitalizeText(name: string | null | undefined): string;
@@ -41,4 +68,4 @@ declare const getFieldsByInputType: <T extends {
     inputType?: string;
 }>(fields: T[] | undefined, key: string) => T[];
 
-export { capitalizeText, checkIfExistsInArray, cn, convertCommaDataToArray, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, isEmpty, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, toDateInputValue, toLowerCaseText, truncateText };
+export { type HandleApiErrorOptions, type RtkQueryError, capitalizeText, checkIfExistsInArray, cn, convertCommaDataToArray, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, formatValidationErrorsHtml, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, handleApiError, isEmpty, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, toDateInputValue, toLowerCaseText, truncateText };

package/dist/utils/index.js

@@ -39,11 +39,13 @@ __export(utils_exports, {
   flattenTableData: () => flattenTableData,
   formatDate: () => formatDate,
   formatDateTime: () => formatDateTime,
+  formatValidationErrorsHtml: () => formatValidationErrorsHtml,
   getApiError: () => getApiError,
   getErrorMessages: () => getErrorMessages,
   getFieldsByCategory: () => getFieldsByCategory,
   getFieldsByInputType: () => getFieldsByInputType,
   getFieldsByName: () => getFieldsByName,
+  handleApiError: () => handleApiError,
   isEmpty: () => isEmpty,
   normalizeApiListItems: () => normalizeApiListItems,
   parseCurrencyValueToNumber: () => parseCurrencyValueToNumber,
@@ -69,6 +71,48 @@ var truncateText = (text, maxLength = 20) => {
   }
   return text.slice(0, maxLength - 3) + "...";
 };
+function formatValidationErrorsHtml(errors) {
+  const items = Object.keys(errors).flatMap(
+    (field) => (errors[field] || []).map((msg) => `<li>${msg}</li>`)
+  );
+  return `
+        <div style="text-align:left">
+          <p>Please review and correct the following:</p>
+          <ul style="margin:8px 0 0 16px; list-style:disc;">
+            ${items.join("")}
+          </ul>
+        </div>
+      `;
+}
+function handleApiError(error, { showAlert = false, fallbackMessage, toast, alert } = {}) {
+  if (!error) return;
+  const status = error.status ?? error.originalStatus;
+  const data = error.data;
+  if (status === 200) {
+    return;
+  }
+  if (data?.errors && typeof data.errors === "object") {
+    const errors = data.errors;
+    if (showAlert && alert) {
+      alert({
+        title: "Validation errors",
+        html: formatValidationErrorsHtml(errors)
+      });
+    } else if (toast) {
+      Object.keys(errors).forEach((field) => {
+        (errors[field] || []).forEach((errorMessage) => {
+          toast(errorMessage);
+        });
+      });
+    }
+    return;
+  }
+  if (status === 404) {
+    return;
+  }
+  const message = fallbackMessage || data?.message || data?.title || error.error || "An error occurred. Please try again.";
+  toast?.(message);
+}
 function getApiError(apiError) {
   if (!apiError) return "An unknown error occurred";
   if (typeof apiError === "string") {
@@ -252,11 +296,13 @@ var getFieldsByInputType = (fields = [], key) => {
   flattenTableData,
   formatDate,
   formatDateTime,
+  formatValidationErrorsHtml,
   getApiError,
   getErrorMessages,
   getFieldsByCategory,
   getFieldsByInputType,
   getFieldsByName,
+  handleApiError,
   isEmpty,
   normalizeApiListItems,
   parseCurrencyValueToNumber,

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/index.ts","../../src/utils/cn.ts","../../src/utils/helpers.ts"],"sourcesContent":["export { cn } from \"./cn\";\r\nexport * from \"./helpers\";\r\n","import clsx from \"clsx\";\r\nimport { twMerge } from \"tailwind-merge\";\r\n\r\nexport function cn(...inputs: Parameters<typeof clsx>) {\r\n  return twMerge(clsx(inputs));\r\n}\r\n","export const truncateText = (text: string | null | undefined, maxLength = 20) => {\n  if (!text) return \"\";\n  if (text.length <= maxLength) {\n    return text;\n  }\n  return text.slice(0, maxLength - 3) + \"...\";\n};\n\nexport function getApiError(apiError: unknown): string {\n  if (!apiError) return \"An unknown error occurred\";\n\n  if (typeof apiError === \"string\") {\n    return apiError;\n  }\n\n  const error = apiError as {\n    response?: { data?: Record<string, unknown> };\n    message?: string;\n  };\n\n  if (error.response?.data) {\n    const responseData = error.response.data;\n\n    if (typeof responseData === \"string\") {\n      return responseData;\n    }\n\n    const errors = responseData.errors;\n    if (errors && typeof errors === \"object\") {\n      for (const key in errors) {\n        const messages = (errors as Record<string, unknown>)[key];\n        if (Array.isArray(messages) && messages.length > 0) {\n          return String(messages[0]);\n        }\n      }\n    }\n\n    if (responseData.message) {\n      return String(responseData.message);\n    }\n\n    if (responseData.title) {\n      return String(responseData.title);\n    }\n  }\n\n  if (error.message) {\n    return error.message;\n  }\n\n  return \"An unknown error occurred\";\n}\n\nexport const normalizeApiListItems = (responseData: unknown): unknown[] => {\n  if (responseData == null) return [];\n  if (Array.isArray(responseData)) return responseData;\n\n  const record = responseData as Record<string, unknown>;\n  const data = record.data;\n\n  if (\n    data &&\n    typeof data === \"object\" &&\n    !Array.isArray(data) &&\n    Array.isArray((data as { items?: unknown[] }).items)\n  ) {\n    return (data as { items: unknown[] }).items;\n  }\n\n  const returnModel = record.returnModel as { items?: unknown[] } | undefined;\n  if (Array.isArray(returnModel?.items)) return returnModel.items;\n  if (Array.isArray(data)) return data;\n  if (typeof data === \"object\" && data !== null) {\n    return [data];\n  }\n  return [];\n};\n\nexport function capitalizeText(name: string | null | undefined): string {\n  if (!name) return \"\";\n  return name\n    .split(\" \")\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n    .join(\" \");\n}\n\nexport function toLowerCaseText(text: string | null | undefined): string {\n  if (!text) return \"\";\n  return text.toLowerCase();\n}\n\nexport const formatDate = (dateString: string | null | undefined): string => {\n  if (dateString === null || dateString === undefined) return \"-\";\n  const date = new Date(dateString);\n\n  if (isNaN(date.getTime())) {\n    return dateString;\n  }\n\n  const month = (date.getMonth() + 1).toString().padStart(2, \"0\");\n  const day = date.getDate().toString().padStart(2, \"0\");\n  const year = date.getFullYear().toString().slice(-2);\n  return `${month}/${day}/${year}`;\n};\n\nexport const isEmpty = (obj: object): boolean => {\n  return Object.keys(obj).length === 0;\n};\n\nexport const toDateInputValue = (date: string | Date | null | undefined): string => {\n  if (!date) return \"\";\n\n  let d: Date;\n\n  if (typeof date === \"string\") {\n    if (/^\\d{4}-\\d{2}-\\d{2}$/.test(date)) {\n      return date;\n    }\n    d = new Date(date);\n  } else {\n    d = new Date(date);\n  }\n\n  if (isNaN(d.getTime())) return \"\";\n\n  const localDate = new Date(d.getTime() - d.getTimezoneOffset() * 60000);\n  const year = localDate.getFullYear();\n  const month = (localDate.getMonth() + 1).toString().padStart(2, \"0\");\n  const day = localDate.getDate().toString().padStart(2, \"0\");\n\n  return `${year}-${month}-${day}`;\n};\n\nexport function convertCommaDataToArray(data: string | null | undefined): string[] {\n  if (!data || data.trim() === \"\") {\n    return [];\n  }\n  return data.split(\",\").map((item) => item.trim());\n}\n\nexport function checkIfExistsInArray<T>(array: T[], searchValue: T): boolean {\n  return array.includes(searchValue);\n}\n\nexport const currencyFormatter = (value: number | null | undefined): string => {\n  return value?.toLocaleString(\"en-US\", {\n    style: \"currency\",\n    currency: \"USD\",\n  }) ?? \"\";\n};\n\nexport const parseCurrencyValueToNumber = (value: unknown): number => {\n  if (value == null || value === \"\") return 0;\n\n  const raw =\n    typeof value === \"object\" && value !== null && \"value\" in value\n      ? (value as { value: unknown }).value\n      : value;\n\n  const stringValue = raw == null || raw === \"\" ? \"\" : String(raw);\n  const numericValue = stringValue.replace(/[$,]/g, \"\");\n  return parseFloat(numericValue) || 0;\n};\n\nexport function flattenTableData<T extends Record<string, unknown>>(\n  data: T[] | null | undefined,\n  columns: { field?: string }[] | null | undefined\n): T[] {\n  if (!Array.isArray(data)) return [];\n  return data.map((row) => {\n    const flatRow = { ...row };\n    (columns ?? []).forEach((col) => {\n      const key = col.field;\n      if (!key) return;\n      if (key.includes(\".\")) {\n        const value = key.split(\".\").reduce<unknown>(\n          (acc, part) => (acc as Record<string, unknown> | undefined)?.[part],\n          row\n        );\n        (flatRow as Record<string, unknown>)[key] = value ?? \"\";\n      }\n    });\n    return flatRow;\n  });\n}\n\nexport const getErrorMessages = (error: {\n  data?: {\n    errors?: Record<string, string[]>;\n    title?: string;\n    error?: { name?: string[] };\n  };\n} | null | undefined): string => {\n  if (error?.data?.errors) {\n    return Object.values(error.data.errors).flat().join(\"\\n\");\n  }\n  return (\n    error?.data?.title ??\n    error?.data?.error?.name?.[0] ??\n    \"Failed to save\"\n  );\n};\n\nexport const getFieldsByCategory = <T extends { category?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields?.filter(({ category = \"\" }) => category === key);\n};\n\nexport const getFieldsByName = <T extends { name?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields.filter(({ name = \"\" }) => name === key);\n};\n\nexport const deserializeJson = <T = unknown>(jsonString: string): T | null => {\n  try {\n    return JSON.parse(jsonString) as T;\n  } catch (error) {\n    console.error(\"Error parsing JSON:\", error);\n    return null;\n  }\n};\n\nexport const formatDateTime = (dateString: string | null | undefined): string => {\n  if (!dateString) return \"Invalid Date\";\n  const date = new Date(dateString);\n  if (isNaN(date.getTime())) return \"Invalid Date\";\n  const options: Intl.DateTimeFormatOptions = {\n    year: \"numeric\",\n    month: \"numeric\",\n    day: \"numeric\",\n    hour: \"numeric\",\n    minute: \"numeric\",\n    hour12: true,\n  };\n  return date.toLocaleString(\"en-US\", options);\n};\n\nexport const removeByPropertyValues = <T extends Record<string, unknown>>(\n  items: T[] = [],\n  property: keyof T & string,\n  values: unknown[] = [],\n  { caseInsensitive = false }: { caseInsensitive?: boolean } = {}\n): T[] => {\n  if (!Array.isArray(items) || !property) return Array.isArray(items) ? items : [];\n  const normalize = (v: unknown) =>\n    caseInsensitive && typeof v === \"string\" ? v.toLowerCase() : v;\n  const valuesArr = Array.isArray(values) ? values : [values];\n  const toRemove = new Set(valuesArr.map(normalize));\n  return items.filter((item) => !toRemove.has(normalize(item?.[property])));\n};\n\nexport const getFieldsByInputType = <T extends { inputType?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields.filter(({ inputType = \"\" }) => inputType === key);\n};\n"],"mappings":"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","names":["clsx"]}
+{"version":3,"sources":["../../src/utils/index.ts","../../src/utils/cn.ts","../../src/utils/helpers.ts"],"sourcesContent":["export { cn } from \"./cn\";\r\nexport * from \"./helpers\";\r\n","import clsx from \"clsx\";\r\nimport { twMerge } from \"tailwind-merge\";\r\n\r\nexport function cn(...inputs: Parameters<typeof clsx>) {\r\n  return twMerge(clsx(inputs));\r\n}\r\n","export const truncateText = (text: string | null | undefined, maxLength = 20) => {\n  if (!text) return \"\";\n  if (text.length <= maxLength) {\n    return text;\n  }\n  return text.slice(0, maxLength - 3) + \"...\";\n};\n\nexport type RtkQueryError = {\n  status?: number | string;\n  originalStatus?: number;\n  data?: {\n    errors?: Record<string, string[]>;\n    message?: string;\n    title?: string;\n  };\n  error?: string;\n};\n\nexport interface HandleApiErrorOptions {\n  showAlert?: boolean;\n  fallbackMessage?: string;\n  /** Called for each validation message when showAlert is false, and for generic errors */\n  toast?: (message: string) => void;\n  /** Called for validation errors when showAlert is true (e.g. wire to SweetAlert) */\n  alert?: (params: { title: string; html: string }) => void;\n}\n\nexport function formatValidationErrorsHtml(\n  errors: Record<string, string[]>\n): string {\n  const items = Object.keys(errors).flatMap((field) =>\n    (errors[field] || []).map((msg) => `<li>${msg}</li>`)\n  );\n  return `\n        <div style=\"text-align:left\">\n          <p>Please review and correct the following:</p>\n          <ul style=\"margin:8px 0 0 16px; list-style:disc;\">\n            ${items.join(\"\")}\n          </ul>\n        </div>\n      `;\n}\n\n/**\n * Handles RTK Query / fetchBaseQuery error shapes: validation errors, 404 (silent), and generic messages.\n * Pass `toast` and optionally `alert` from your app (react-toastify, SweetAlert, etc.).\n */\nexport function handleApiError(\n  error: RtkQueryError | null | undefined,\n  { showAlert = false, fallbackMessage, toast, alert }: HandleApiErrorOptions = {}\n): void {\n  if (!error) return;\n\n  const status = error.status ?? error.originalStatus;\n  const data = error.data;\n\n  if (status === 200) {\n    return;\n  }\n\n  if (data?.errors && typeof data.errors === \"object\") {\n    const errors = data.errors;\n\n    if (showAlert && alert) {\n      alert({\n        title: \"Validation errors\",\n        html: formatValidationErrorsHtml(errors),\n      });\n    } else if (toast) {\n      Object.keys(errors).forEach((field) => {\n        (errors[field] || []).forEach((errorMessage) => {\n          toast(errorMessage);\n        });\n      });\n    }\n    return;\n  }\n\n  if (status === 404) {\n    return;\n  }\n\n  const message =\n    fallbackMessage ||\n    data?.message ||\n    data?.title ||\n    error.error ||\n    \"An error occurred. Please try again.\";\n\n  toast?.(message);\n}\n\nexport function getApiError(apiError: unknown): string {\n  if (!apiError) return \"An unknown error occurred\";\n\n  if (typeof apiError === \"string\") {\n    return apiError;\n  }\n\n  const error = apiError as {\n    response?: { data?: Record<string, unknown> };\n    message?: string;\n  };\n\n  if (error.response?.data) {\n    const responseData = error.response.data;\n\n    if (typeof responseData === \"string\") {\n      return responseData;\n    }\n\n    const errors = responseData.errors;\n    if (errors && typeof errors === \"object\") {\n      for (const key in errors) {\n        const messages = (errors as Record<string, unknown>)[key];\n        if (Array.isArray(messages) && messages.length > 0) {\n          return String(messages[0]);\n        }\n      }\n    }\n\n    if (responseData.message) {\n      return String(responseData.message);\n    }\n\n    if (responseData.title) {\n      return String(responseData.title);\n    }\n  }\n\n  if (error.message) {\n    return error.message;\n  }\n\n  return \"An unknown error occurred\";\n}\n\nexport const normalizeApiListItems = (responseData: unknown): unknown[] => {\n  if (responseData == null) return [];\n  if (Array.isArray(responseData)) return responseData;\n\n  const record = responseData as Record<string, unknown>;\n  const data = record.data;\n\n  if (\n    data &&\n    typeof data === \"object\" &&\n    !Array.isArray(data) &&\n    Array.isArray((data as { items?: unknown[] }).items)\n  ) {\n    return (data as { items: unknown[] }).items;\n  }\n\n  const returnModel = record.returnModel as { items?: unknown[] } | undefined;\n  if (Array.isArray(returnModel?.items)) return returnModel.items;\n  if (Array.isArray(data)) return data;\n  if (typeof data === \"object\" && data !== null) {\n    return [data];\n  }\n  return [];\n};\n\nexport function capitalizeText(name: string | null | undefined): string {\n  if (!name) return \"\";\n  return name\n    .split(\" \")\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n    .join(\" \");\n}\n\nexport function toLowerCaseText(text: string | null | undefined): string {\n  if (!text) return \"\";\n  return text.toLowerCase();\n}\n\nexport const formatDate = (dateString: string | null | undefined): string => {\n  if (dateString === null || dateString === undefined) return \"-\";\n  const date = new Date(dateString);\n\n  if (isNaN(date.getTime())) {\n    return dateString;\n  }\n\n  const month = (date.getMonth() + 1).toString().padStart(2, \"0\");\n  const day = date.getDate().toString().padStart(2, \"0\");\n  const year = date.getFullYear().toString().slice(-2);\n  return `${month}/${day}/${year}`;\n};\n\nexport const isEmpty = (obj: object): boolean => {\n  return Object.keys(obj).length === 0;\n};\n\nexport const toDateInputValue = (date: string | Date | null | undefined): string => {\n  if (!date) return \"\";\n\n  let d: Date;\n\n  if (typeof date === \"string\") {\n    if (/^\\d{4}-\\d{2}-\\d{2}$/.test(date)) {\n      return date;\n    }\n    d = new Date(date);\n  } else {\n    d = new Date(date);\n  }\n\n  if (isNaN(d.getTime())) return \"\";\n\n  const localDate = new Date(d.getTime() - d.getTimezoneOffset() * 60000);\n  const year = localDate.getFullYear();\n  const month = (localDate.getMonth() + 1).toString().padStart(2, \"0\");\n  const day = localDate.getDate().toString().padStart(2, \"0\");\n\n  return `${year}-${month}-${day}`;\n};\n\nexport function convertCommaDataToArray(data: string | null | undefined): string[] {\n  if (!data || data.trim() === \"\") {\n    return [];\n  }\n  return data.split(\",\").map((item) => item.trim());\n}\n\nexport function checkIfExistsInArray<T>(array: T[], searchValue: T): boolean {\n  return array.includes(searchValue);\n}\n\nexport const currencyFormatter = (value: number | null | undefined): string => {\n  return value?.toLocaleString(\"en-US\", {\n    style: \"currency\",\n    currency: \"USD\",\n  }) ?? \"\";\n};\n\nexport const parseCurrencyValueToNumber = (value: unknown): number => {\n  if (value == null || value === \"\") return 0;\n\n  const raw =\n    typeof value === \"object\" && value !== null && \"value\" in value\n      ? (value as { value: unknown }).value\n      : value;\n\n  const stringValue = raw == null || raw === \"\" ? \"\" : String(raw);\n  const numericValue = stringValue.replace(/[$,]/g, \"\");\n  return parseFloat(numericValue) || 0;\n};\n\nexport function flattenTableData<T extends Record<string, unknown>>(\n  data: T[] | null | undefined,\n  columns: { field?: string }[] | null | undefined\n): T[] {\n  if (!Array.isArray(data)) return [];\n  return data.map((row) => {\n    const flatRow = { ...row };\n    (columns ?? []).forEach((col) => {\n      const key = col.field;\n      if (!key) return;\n      if (key.includes(\".\")) {\n        const value = key.split(\".\").reduce<unknown>(\n          (acc, part) => (acc as Record<string, unknown> | undefined)?.[part],\n          row\n        );\n        (flatRow as Record<string, unknown>)[key] = value ?? \"\";\n      }\n    });\n    return flatRow;\n  });\n}\n\nexport const getErrorMessages = (error: {\n  data?: {\n    errors?: Record<string, string[]>;\n    title?: string;\n    error?: { name?: string[] };\n  };\n} | null | undefined): string => {\n  if (error?.data?.errors) {\n    return Object.values(error.data.errors).flat().join(\"\\n\");\n  }\n  return (\n    error?.data?.title ??\n    error?.data?.error?.name?.[0] ??\n    \"Failed to save\"\n  );\n};\n\nexport const getFieldsByCategory = <T extends { category?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields?.filter(({ category = \"\" }) => category === key);\n};\n\nexport const getFieldsByName = <T extends { name?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields.filter(({ name = \"\" }) => name === key);\n};\n\nexport const deserializeJson = <T = unknown>(jsonString: string): T | null => {\n  try {\n    return JSON.parse(jsonString) as T;\n  } catch (error) {\n    console.error(\"Error parsing JSON:\", error);\n    return null;\n  }\n};\n\nexport const formatDateTime = (dateString: string | null | undefined): string => {\n  if (!dateString) return \"Invalid Date\";\n  const date = new Date(dateString);\n  if (isNaN(date.getTime())) return \"Invalid Date\";\n  const options: Intl.DateTimeFormatOptions = {\n    year: \"numeric\",\n    month: \"numeric\",\n    day: \"numeric\",\n    hour: \"numeric\",\n    minute: \"numeric\",\n    hour12: true,\n  };\n  return date.toLocaleString(\"en-US\", options);\n};\n\nexport const removeByPropertyValues = <T extends Record<string, unknown>>(\n  items: T[] = [],\n  property: keyof T & string,\n  values: unknown[] = [],\n  { caseInsensitive = false }: { caseInsensitive?: boolean } = {}\n): T[] => {\n  if (!Array.isArray(items) || !property) return Array.isArray(items) ? items : [];\n  const normalize = (v: unknown) =>\n    caseInsensitive && typeof v === \"string\" ? v.toLowerCase() : v;\n  const valuesArr = Array.isArray(values) ? values : [values];\n  const toRemove = new Set(valuesArr.map(normalize));\n  return items.filter((item) => !toRemove.has(normalize(item?.[property])));\n};\n\nexport const getFieldsByInputType = <T extends { inputType?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields.filter(({ inputType = \"\" }) => inputType === key);\n};\n"],"mappings":"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","names":["clsx"]}

package/dist/utils/index.mjs

@@ -8,11 +8,13 @@ import {
   flattenTableData,
   formatDate,
   formatDateTime,
+  formatValidationErrorsHtml,
   getApiError,
   getErrorMessages,
   getFieldsByCategory,
   getFieldsByInputType,
   getFieldsByName,
+  handleApiError,
   isEmpty,
   normalizeApiListItems,
   parseCurrencyValueToNumber,
@@ -20,7 +22,7 @@ import {
   toDateInputValue,
   toLowerCaseText,
   truncateText
-} from "../chunk-WARJTN5T.mjs";
+} from "../chunk-QVRMHJS4.mjs";
 export {
   capitalizeText,
   checkIfExistsInArray,
@@ -31,11 +33,13 @@ export {
   flattenTableData,
   formatDate,
   formatDateTime,
+  formatValidationErrorsHtml,
   getApiError,
   getErrorMessages,
   getFieldsByCategory,
   getFieldsByInputType,
   getFieldsByName,
+  handleApiError,
   isEmpty,
   normalizeApiListItems,
   parseCurrencyValueToNumber,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eztrak/shared",
-  "version": "0.2.4",
+  "version": "0.2.5",
 
   "homepage": "https://github.com/mehrancentangle/eztrak-packages",
 

package/dist/chunk-WARJTN5T.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils/cn.ts","../src/utils/helpers.ts"],"sourcesContent":["import clsx from \"clsx\";\r\nimport { twMerge } from \"tailwind-merge\";\r\n\r\nexport function cn(...inputs: Parameters<typeof clsx>) {\r\n  return twMerge(clsx(inputs));\r\n}\r\n","export const truncateText = (text: string | null | undefined, maxLength = 20) => {\n  if (!text) return \"\";\n  if (text.length <= maxLength) {\n    return text;\n  }\n  return text.slice(0, maxLength - 3) + \"...\";\n};\n\nexport function getApiError(apiError: unknown): string {\n  if (!apiError) return \"An unknown error occurred\";\n\n  if (typeof apiError === \"string\") {\n    return apiError;\n  }\n\n  const error = apiError as {\n    response?: { data?: Record<string, unknown> };\n    message?: string;\n  };\n\n  if (error.response?.data) {\n    const responseData = error.response.data;\n\n    if (typeof responseData === \"string\") {\n      return responseData;\n    }\n\n    const errors = responseData.errors;\n    if (errors && typeof errors === \"object\") {\n      for (const key in errors) {\n        const messages = (errors as Record<string, unknown>)[key];\n        if (Array.isArray(messages) && messages.length > 0) {\n          return String(messages[0]);\n        }\n      }\n    }\n\n    if (responseData.message) {\n      return String(responseData.message);\n    }\n\n    if (responseData.title) {\n      return String(responseData.title);\n    }\n  }\n\n  if (error.message) {\n    return error.message;\n  }\n\n  return \"An unknown error occurred\";\n}\n\nexport const normalizeApiListItems = (responseData: unknown): unknown[] => {\n  if (responseData == null) return [];\n  if (Array.isArray(responseData)) return responseData;\n\n  const record = responseData as Record<string, unknown>;\n  const data = record.data;\n\n  if (\n    data &&\n    typeof data === \"object\" &&\n    !Array.isArray(data) &&\n    Array.isArray((data as { items?: unknown[] }).items)\n  ) {\n    return (data as { items: unknown[] }).items;\n  }\n\n  const returnModel = record.returnModel as { items?: unknown[] } | undefined;\n  if (Array.isArray(returnModel?.items)) return returnModel.items;\n  if (Array.isArray(data)) return data;\n  if (typeof data === \"object\" && data !== null) {\n    return [data];\n  }\n  return [];\n};\n\nexport function capitalizeText(name: string | null | undefined): string {\n  if (!name) return \"\";\n  return name\n    .split(\" \")\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\n    .join(\" \");\n}\n\nexport function toLowerCaseText(text: string | null | undefined): string {\n  if (!text) return \"\";\n  return text.toLowerCase();\n}\n\nexport const formatDate = (dateString: string | null | undefined): string => {\n  if (dateString === null || dateString === undefined) return \"-\";\n  const date = new Date(dateString);\n\n  if (isNaN(date.getTime())) {\n    return dateString;\n  }\n\n  const month = (date.getMonth() + 1).toString().padStart(2, \"0\");\n  const day = date.getDate().toString().padStart(2, \"0\");\n  const year = date.getFullYear().toString().slice(-2);\n  return `${month}/${day}/${year}`;\n};\n\nexport const isEmpty = (obj: object): boolean => {\n  return Object.keys(obj).length === 0;\n};\n\nexport const toDateInputValue = (date: string | Date | null | undefined): string => {\n  if (!date) return \"\";\n\n  let d: Date;\n\n  if (typeof date === \"string\") {\n    if (/^\\d{4}-\\d{2}-\\d{2}$/.test(date)) {\n      return date;\n    }\n    d = new Date(date);\n  } else {\n    d = new Date(date);\n  }\n\n  if (isNaN(d.getTime())) return \"\";\n\n  const localDate = new Date(d.getTime() - d.getTimezoneOffset() * 60000);\n  const year = localDate.getFullYear();\n  const month = (localDate.getMonth() + 1).toString().padStart(2, \"0\");\n  const day = localDate.getDate().toString().padStart(2, \"0\");\n\n  return `${year}-${month}-${day}`;\n};\n\nexport function convertCommaDataToArray(data: string | null | undefined): string[] {\n  if (!data || data.trim() === \"\") {\n    return [];\n  }\n  return data.split(\",\").map((item) => item.trim());\n}\n\nexport function checkIfExistsInArray<T>(array: T[], searchValue: T): boolean {\n  return array.includes(searchValue);\n}\n\nexport const currencyFormatter = (value: number | null | undefined): string => {\n  return value?.toLocaleString(\"en-US\", {\n    style: \"currency\",\n    currency: \"USD\",\n  }) ?? \"\";\n};\n\nexport const parseCurrencyValueToNumber = (value: unknown): number => {\n  if (value == null || value === \"\") return 0;\n\n  const raw =\n    typeof value === \"object\" && value !== null && \"value\" in value\n      ? (value as { value: unknown }).value\n      : value;\n\n  const stringValue = raw == null || raw === \"\" ? \"\" : String(raw);\n  const numericValue = stringValue.replace(/[$,]/g, \"\");\n  return parseFloat(numericValue) || 0;\n};\n\nexport function flattenTableData<T extends Record<string, unknown>>(\n  data: T[] | null | undefined,\n  columns: { field?: string }[] | null | undefined\n): T[] {\n  if (!Array.isArray(data)) return [];\n  return data.map((row) => {\n    const flatRow = { ...row };\n    (columns ?? []).forEach((col) => {\n      const key = col.field;\n      if (!key) return;\n      if (key.includes(\".\")) {\n        const value = key.split(\".\").reduce<unknown>(\n          (acc, part) => (acc as Record<string, unknown> | undefined)?.[part],\n          row\n        );\n        (flatRow as Record<string, unknown>)[key] = value ?? \"\";\n      }\n    });\n    return flatRow;\n  });\n}\n\nexport const getErrorMessages = (error: {\n  data?: {\n    errors?: Record<string, string[]>;\n    title?: string;\n    error?: { name?: string[] };\n  };\n} | null | undefined): string => {\n  if (error?.data?.errors) {\n    return Object.values(error.data.errors).flat().join(\"\\n\");\n  }\n  return (\n    error?.data?.title ??\n    error?.data?.error?.name?.[0] ??\n    \"Failed to save\"\n  );\n};\n\nexport const getFieldsByCategory = <T extends { category?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields?.filter(({ category = \"\" }) => category === key);\n};\n\nexport const getFieldsByName = <T extends { name?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields.filter(({ name = \"\" }) => name === key);\n};\n\nexport const deserializeJson = <T = unknown>(jsonString: string): T | null => {\n  try {\n    return JSON.parse(jsonString) as T;\n  } catch (error) {\n    console.error(\"Error parsing JSON:\", error);\n    return null;\n  }\n};\n\nexport const formatDateTime = (dateString: string | null | undefined): string => {\n  if (!dateString) return \"Invalid Date\";\n  const date = new Date(dateString);\n  if (isNaN(date.getTime())) return \"Invalid Date\";\n  const options: Intl.DateTimeFormatOptions = {\n    year: \"numeric\",\n    month: \"numeric\",\n    day: \"numeric\",\n    hour: \"numeric\",\n    minute: \"numeric\",\n    hour12: true,\n  };\n  return date.toLocaleString(\"en-US\", options);\n};\n\nexport const removeByPropertyValues = <T extends Record<string, unknown>>(\n  items: T[] = [],\n  property: keyof T & string,\n  values: unknown[] = [],\n  { caseInsensitive = false }: { caseInsensitive?: boolean } = {}\n): T[] => {\n  if (!Array.isArray(items) || !property) return Array.isArray(items) ? items : [];\n  const normalize = (v: unknown) =>\n    caseInsensitive && typeof v === \"string\" ? v.toLowerCase() : v;\n  const valuesArr = Array.isArray(values) ? values : [values];\n  const toRemove = new Set(valuesArr.map(normalize));\n  return items.filter((item) => !toRemove.has(normalize(item?.[property])));\n};\n\nexport const getFieldsByInputType = <T extends { inputType?: string }>(\n  fields: T[] = [],\n  key: string\n): T[] => {\n  return fields.filter(({ inputType = \"\" }) => inputType === key);\n};\n"],"mappings":"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","names":[]}