@eztrak/shared 0.7.0 → 0.7.3

package/README.md

@@ -8,13 +8,38 @@ Shared utilities, hooks, and UI components for Eztrak applications.
 npm install @eztrak/shared
 ```
 
-Peer dependencies (hooks + `handleApiError` + components):
+Peer dependencies:
 
 ```bash
-npm install react react-dom react-router-dom react-hot-toast sweetalert2
+npm install react react-dom react-router-dom react-hot-toast sweetalert2 react-icons framer-motion
 ```
 
-Your app must render `<Toaster />` from react-hot-toast (e.g. in your root layout).
+Your app must render `<Toaster />` from `react-hot-toast` (e.g. in your root layout).
+
+Import loader styles once if you use the `Loader` component:
+
+```ts
+import "@eztrak/shared/components/loader.css";
+```
+
+`CustomCellEditor` does **not** require `loader.css` — it uses an inline SVG spinner for the save button.
+
+## Development
+
+From the monorepo root:
+
+```bash
+npm run build:shared
+npm run storybook
+```
+
+From `packages/shared`:
+
+```bash
+npm run build
+npm run storybook
+npm run build:storybook
+```
 
 ## Usage
 
@@ -171,6 +196,77 @@ import {
 
 `ResetColumnsButton` shows a SweetAlert2 confirmation before calling `onReset`.
 
+### Components — CustomCellEditor
+
+AG Grid cell editor with inline save/cancel buttons, keyboard shortcuts (Enter to save, Escape to cancel), and toast feedback. Implements the AG Grid `ICellEditor` ref API (`getValue`, `isCancelBeforeStart`, `isCancelAfterEnd`).
+
+Your app owns the API call via `onSave` — the package does not use RTK Query or app-specific endpoints.
+
+For narrow columns, set `cellEditorPopup: true` on the column definition so the editor (and save/cancel buttons) is not clipped.
+
+```tsx
+import { CustomCellEditor } from "@eztrak/shared/components";
+import { ELITE_API } from "../constants/apiConstants";
+import { createCellEditorOnSave } from "../utils/cellEditorOnSave";
+
+// In column defs:
+{
+  field: "name",
+  editable: true,
+  cellEditor: CustomCellEditor,
+  cellEditorPopup: true,
+  cellEditorSelector: (params) => ({
+    component: CustomCellEditor,
+    params: {
+      value: params.value,
+      name: "name",
+      entityId: params.data.id,
+      entityName: "Package",
+      inputType: "text",
+      onSave: createCellEditorOnSave([ELITE_API.PACKAGE]),
+      dropdownOptions: [], // when inputType is "dropdown"
+    },
+  }),
+}
+```
+
+Example `createCellEditorOnSave` helper (elite-pilot pattern):
+
+```js
+import { ELITE_API } from "../constants/apiConstants";
+import { store } from "../redux/store";
+import { generalApi } from "../redux/api/generalApi";
+
+export function createCellEditorOnSave(invalidate = []) {
+  return async (payload) => {
+    const result = await store.dispatch(
+      generalApi.endpoints.updateRecord.initiate({
+        endpoint: ELITE_API.SAVE_CELL_EDIT,
+        data: payload,
+        invalidate: invalidate.map((endpoint) => ({
+          type: "General",
+          id: endpoint,
+        })),
+      })
+    );
+    if (result.error) {
+      throw new Error(result.error?.data?.message || "Failed to update record");
+    }
+  };
+}
+```
+
+#### Input types
+
+| `inputType` | Behavior |
+| --- | --- |
+| `text` | Standard text input |
+| `number` | Numeric input (filters non-numeric characters); `propertyValue` is sent as a `number` |
+| `date` | Date picker (`YYYY-MM-DD` via `toDateInputValue`) |
+| `dropdown` | Select from `dropdownOptions` |
+
+Save is disabled when the value is unchanged (compares as strings so `42` and `"42"` are treated as equal). Pressing Enter while a save is in progress does not submit twice.
+
 ### Components — ResetFiltersButton
 
 Clears all URL search params (`react-router-dom`) in one click. Self-contained — no app `Button` needed.
@@ -196,6 +292,104 @@ import { ResetFiltersButton } from "@eztrak/shared/components";
 | `onReset` | `() => void` | — | Called after search params are cleared |
 | `disabled` | `boolean` | `false` | Disables the button |
 
+### Components — SearchInput
+
+URL-synced search field with optional debounced live search. Requires a React Router context (`useSearchParams`).
+
+```tsx
+import { SearchInput } from "@eztrak/shared/components";
+
+// Submit on Enter or search icon click (updates ?query= in the URL)
+<SearchInput placeholder="Search items..." />
+```
+
+#### Live search (debounced)
+
+```tsx
+<SearchInput
+  placeholder="Search..."
+  liveSearch
+  debounceDelay={500}
+/>
+```
+
+#### Custom URL param name
+
+```tsx
+<SearchInput defaultParam="search" placeholder="Find a user..." />
+```
+
+#### Custom styling and icon
+
+```tsx
+<SearchInput
+  searchWrapperClass="border border-gray-200 shadow-sm"
+  searchClassName="w-full"
+  searchIconClassName="text-blue-500"
+  showIcon
+/>
+```
+
+#### Hide icon / custom icon
+
+```tsx
+import { HiOutlineSearch } from "react-icons/hi";
+
+<SearchInput showIcon={false} />
+
+<SearchInput customIcon={<HiOutlineSearch className="h-5 w-5" />} />
+```
+
+`SearchInput` reads and writes a single query param (default `query`). Clearing the input removes that param from the URL. The input stays in sync when the URL changes externally (e.g. browser back/forward or `ResetFiltersButton`).
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `placeholder` | `string` | `"Search..."` | Input placeholder |
+| `defaultParam` | `string` | `"query"` | URL search param key |
+| `defaultValue` | `string` | — | Initial value when the param is absent |
+| `liveSearch` | `boolean` | `false` | Update URL on input change (debounced) |
+| `debounceDelay` | `number` | `500` | Debounce delay in ms when `liveSearch` is true |
+| `showIcon` | `boolean` | `true` | Show the submit/search icon button |
+| `customIcon` | `ReactNode \| null` | `null` | Replace the default search icon |
+| `name` | `string` | `"search"` | Form input `name` (used on submit) |
+| `type` | `string` | `"search"` | Input `type` attribute |
+| `searchWrapperClass` | `string` | — | Classes for the form wrapper |
+| `searchClassName` | `string` | — | Classes for the input |
+| `searchBtn` | `string` | — | Classes for the icon button |
+| `searchIconClassName` | `string` | — | Classes for the default search icon |
+
+Also accepts standard `<input>` HTML attributes (except `name`, `type`, `value`, `onChange`, and `defaultValue`, which are managed internally).
+
+### Components — Loader
+
+Spinner for full-page or inline loading states. Requires `loader.css`:
+
+```tsx
+import { Loader } from "@eztrak/shared/components";
+import "@eztrak/shared/components/loader.css";
+
+<Loader size="36px" color="#F54C00" />
+```
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `size` | `string` | `"50px"` | Spinner diameter |
+| `color` | `string` | `"#F54C00"` | Spinner accent color |
+| `speed` | `string` | `"1s"` | Animation duration |
+| `className` | `string` | — | Extra class on the spinner element |
+
+### Components — Modal
+
+Animated modal dialog (uses `framer-motion`).
+
+```tsx
+import { Modal } from "@eztrak/shared/components";
+
+<Modal isOpen={open} onClose={() => setOpen(false)} title="Confirm">
+  <p>Modal content</p>
+</Modal>
+```
+
 ### Components — EztrakTabs
 
 Import styles once in your app entry or layout:
@@ -315,6 +509,10 @@ import {
   useGridHeight,
   EztrakTabs,
   CustomPagination,
+  SearchInput,
+  CustomCellEditor,
+  Loader,
+  Modal,
 } from "@eztrak/shared";
 ```
 
@@ -323,12 +521,14 @@ import {
 Run the component playground locally (dev-only, not published to npm):
 
 ```bash
+# From monorepo root
+npm run storybook
+
+# From packages/shared
 npm run storybook
-# or from the monorepo root:
-npm run storybook -w @eztrak/shared
 ```
 
-Opens on [http://localhost:6006](http://localhost:6006) with stories for `EztrakTabs`, `CustomPagination`, and `ResetColumnsButton`.
+Opens on [http://localhost:6006](http://localhost:6006) with stories for `EztrakTabs`, `CustomPagination`, `ResetColumnsButton`, `CustomCellEditor`, and `Loader`.
 
 ## Exports
 
@@ -337,8 +537,9 @@ Opens on [http://localhost:6006](http://localhost:6006) with stories for `Eztrak
 | `@eztrak/shared` | Main entry — re-exports utils, hooks, and components |
 | `@eztrak/shared/utils` | `cn`, `handleApiError`, `confirmationAlert`, date/format helpers, API error helpers, form field helpers |
 | `@eztrak/shared/hooks` | `usePaginationUrlSync`, `useGridHeight` |
-| `@eztrak/shared/components` | `EztrakTabs`, `CustomPagination`, `ResetColumnsButton`, `TableLayoutToolbarControls`, `ResetFiltersButton`, and related types |
+| `@eztrak/shared/components` | `EztrakTabs`, `CustomPagination`, `CustomCellEditor`, `SearchInput`, `ResetFiltersButton`, `Modal`, `Loader`, `TableLayoutToolbarControls`, `ResetColumnsButton`, and related types |
 | `@eztrak/shared/components/tabs.css` | Default tab styles (CSS variables) |
+| `@eztrak/shared/components/loader.css` | Loader spinner styles |
 
 ### EztrakTabs props
 
@@ -375,12 +576,30 @@ Keyboard: Arrow keys move between tabs; Home/End jump to first/last enabled tab.
 
 `CustomPagination` writes `page` and `perPage` to the URL via `react-router-dom`. Your page should read those params, fetch data, and pass the result back as `paginationData`.
 
+### CustomCellEditor props
+
+| Prop | Type | Default | Description |
+| --- | --- | --- | --- |
+| `value` | `string \| number \| null` | required | Initial cell value (AG Grid passes via `cellEditorParams`) |
+| `name` | `string` | required | Property name sent in save payload as `propertyName` |
+| `stopEditing` | `() => void` | required | AG Grid callback to close the editor |
+| `entityId` | `string \| number` | required | Entity id sent in save payload |
+| `entityName` | `string` | `"Record"` | Entity type name sent in save payload |
+| `inputType` | `CellEditorInputType` | `"text"` | `text`, `number`, `date`, or `dropdown` |
+| `onSave` | `(payload: CellEditPayload) => Promise<void>` | required | Async save handler; throw on failure to show error toast |
+| `dropdownOptions` | `DropdownOption[]` | `[]` | Options when `inputType` is `dropdown` |
+
+`CellEditPayload` shape: `{ propertyName, propertyValue, entityId, entityName }`. For `inputType: "number"`, `propertyValue` is a `number` (via `parseFloat`).
+
 ## Requirements
 
 - Node.js 18+
 - React 18+ (for hooks and components)
-- `react-router-dom` (required for `CustomPagination` and `usePaginationUrlSync`)
-- `sweetalert2` (required for `ResetColumnsButton` and `confirmationAlert`)
+- `react-router-dom` — `CustomPagination`, `SearchInput`, `ResetFiltersButton`, and `usePaginationUrlSync` (optional peer; install if you use these)
+- `react-hot-toast` — toast feedback in `CustomCellEditor` and `handleApiError`
+- `sweetalert2` — `ResetColumnsButton` and `confirmationAlert`
+- `react-icons` — `CustomCellEditor`, `SearchInput`, and `Modal`
+- `framer-motion` — `Modal`
 - Works with any bundler that supports the [Node.js `exports` field](https://nodejs.org/api/packages.html#exports)
 
 ## License

package/dist/chunk-GED6IT3S.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-GED6IT3S.mjs.map

package/dist/chunk-GED6IT3S.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{chunk-GIBPOQGL.mjs → chunk-GVIHLI67.mjs}

@@ -1,3 +1,10 @@
+// src/utils/cn.ts
+import clsx from "clsx";
+import { twMerge } from "tailwind-merge";
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+
 // src/utils/helpers.ts
 var truncateText = (text, maxLength = 20) => {
   if (text === null || text === void 0) return "";
@@ -196,7 +203,76 @@ var getFieldsByInputType = (fields = [], key) => {
   return fields.filter(({ inputType = "" }) => inputType === key);
 };
 
+// src/utils/handleApiError.ts
+import toast from "react-hot-toast";
+import Swal from "sweetalert2";
+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 showValidationAlert(html) {
+  void Swal.fire({
+    title: "Validation errors",
+    html,
+    icon: "error",
+    confirmButtonText: "OK",
+    showCancelButton: false,
+    confirmButtonColor: "#FF7335"
+  });
+}
+function handleApiError(error, { showAlert = false, fallbackMessage } = {}) {
+  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) {
+      showValidationAlert(formatValidationErrorsHtml(errors));
+    } else {
+      Object.keys(errors).forEach((field) => {
+        (errors[field] || []).forEach((errorMessage) => {
+          toast.error(errorMessage);
+        });
+      });
+    }
+    return;
+  }
+  if (status === 404) {
+    return;
+  }
+  const message = fallbackMessage || data?.message || data?.title || error.error || "An error occurred. Please try again.";
+  toast.error(message);
+}
+function confirmationAlert(onConfirm, options = {}) {
+  void Swal.fire({
+    title: options.title ?? "Are you sure?",
+    text: options.text,
+    icon: options.icon ?? "warning",
+    showCancelButton: true,
+    confirmButtonText: options.confirmButtonText ?? "Yes",
+    cancelButtonText: options.cancelButtonText ?? "Cancel",
+    confirmButtonColor: "#FF7335"
+  }).then((result) => {
+    if (result.isConfirmed) {
+      onConfirm();
+    }
+  });
+}
+
 export {
+  cn,
   truncateText,
   truncateFileName,
   getApiError,
@@ -218,6 +294,9 @@ export {
   deserializeJson,
   formatDateTime,
   removeByPropertyValues,
-  getFieldsByInputType
+  getFieldsByInputType,
+  formatValidationErrorsHtml,
+  handleApiError,
+  confirmationAlert
 };
-//# sourceMappingURL=chunk-GIBPOQGL.mjs.map
+//# sourceMappingURL=chunk-GVIHLI67.mjs.map

package/dist/chunk-GVIHLI67.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/cn.ts","../src/utils/helpers.ts","../src/utils/handleApiError.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 = (\r\n  text: string | number | null | undefined,\r\n  maxLength = 20\r\n): string => {\r\n  if (text === null || text === undefined) return \"\";\r\n  const value = String(text);\r\n  if (value.length <= maxLength) {\r\n    return value;\r\n  }\r\n  return value.slice(0, maxLength - 3) + \"...\";\r\n};\r\n\r\nexport const truncateFileName = (\r\n  fileName: string | null | undefined,\r\n  maxLength = 20\r\n): string => {\r\n  if (!fileName) return \"\";\r\n  if (fileName.length <= maxLength) {\r\n    return fileName;\r\n  }\r\n  const extension = fileName.slice(fileName.lastIndexOf(\".\"));\r\n  const truncatedName =\r\n    fileName.slice(0, maxLength - extension.length - 3) + \"...\";\r\n  return truncatedName + extension;\r\n};\r\n\r\nexport function getApiError(apiError: unknown): string {\r\n  if (!apiError) return \"An unknown error occurred\";\r\n\r\n  if (typeof apiError === \"string\") {\r\n    return apiError;\r\n  }\r\n\r\n  const error = apiError as {\r\n    response?: { data?: Record<string, unknown> };\r\n    message?: string;\r\n  };\r\n\r\n  if (error.response?.data) {\r\n    const responseData = error.response.data;\r\n\r\n    if (typeof responseData === \"string\") {\r\n      return responseData;\r\n    }\r\n\r\n    const errors = responseData.errors;\r\n    if (errors && typeof errors === \"object\") {\r\n      for (const key in errors) {\r\n        const messages = (errors as Record<string, unknown>)[key];\r\n        if (Array.isArray(messages) && messages.length > 0) {\r\n          return String(messages[0]);\r\n        }\r\n      }\r\n    }\r\n\r\n    if (responseData.message) {\r\n      return String(responseData.message);\r\n    }\r\n\r\n    if (responseData.title) {\r\n      return String(responseData.title);\r\n    }\r\n  }\r\n\r\n  if (error.message) {\r\n    return error.message;\r\n  }\r\n\r\n  return \"An unknown error occurred\";\r\n}\r\n\r\nexport const normalizeApiListItems = (responseData: unknown): unknown[] => {\r\n  if (responseData == null) return [];\r\n  if (Array.isArray(responseData)) return responseData;\r\n\r\n  const record = responseData as Record<string, unknown>;\r\n  const data = record.data;\r\n\r\n  if (\r\n    data &&\r\n    typeof data === \"object\" &&\r\n    !Array.isArray(data) &&\r\n    Array.isArray((data as { items?: unknown[] }).items)\r\n  ) {\r\n    return (data as { items: unknown[] }).items;\r\n  }\r\n\r\n  const returnModel = record.returnModel as { items?: unknown[] } | undefined;\r\n  if (Array.isArray(returnModel?.items)) return returnModel.items;\r\n  if (Array.isArray(data)) return data;\r\n  if (typeof data === \"object\" && data !== null) {\r\n    return [data];\r\n  }\r\n  return [];\r\n};\r\n\r\nexport function capitalizeText(name: string | null | undefined): string {\r\n  if (!name) return \"\";\r\n  return name\r\n    .split(\" \")\r\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())\r\n    .join(\" \");\r\n}\r\n\r\nexport function toLowerCaseText(text: string | null | undefined): string {\r\n  if (!text) return \"\";\r\n  return text.toLowerCase();\r\n}\r\n\r\nexport const formatDate = (dateString: string | null | undefined): string => {\r\n  if (dateString === null || dateString === undefined) return \"-\";\r\n  const date = new Date(dateString);\r\n\r\n  if (isNaN(date.getTime())) {\r\n    return dateString;\r\n  }\r\n\r\n  const month = (date.getMonth() + 1).toString().padStart(2, \"0\");\r\n  const day = date.getDate().toString().padStart(2, \"0\");\r\n  const year = date.getFullYear().toString().slice(-2);\r\n  return `${month}/${day}/${year}`;\r\n};\r\n\r\nexport const isEmpty = (obj: object): boolean => {\r\n  return Object.keys(obj).length === 0;\r\n};\r\n\r\nexport const toDateInputValue = (date: string | Date | null | undefined): string => {\r\n  if (!date) return \"\";\r\n\r\n  let d: Date;\r\n\r\n  if (typeof date === \"string\") {\r\n    if (/^\\d{4}-\\d{2}-\\d{2}$/.test(date)) {\r\n      return date;\r\n    }\r\n    d = new Date(date);\r\n  } else {\r\n    d = new Date(date);\r\n  }\r\n\r\n  if (isNaN(d.getTime())) return \"\";\r\n\r\n  const localDate = new Date(d.getTime() - d.getTimezoneOffset() * 60000);\r\n  const year = localDate.getFullYear();\r\n  const month = (localDate.getMonth() + 1).toString().padStart(2, \"0\");\r\n  const day = localDate.getDate().toString().padStart(2, \"0\");\r\n\r\n  return `${year}-${month}-${day}`;\r\n};\r\n\r\nexport function convertCommaDataToArray(data: string | null | undefined): string[] {\r\n  if (!data || data.trim() === \"\") {\r\n    return [];\r\n  }\r\n  return data.split(\",\").map((item) => item.trim());\r\n}\r\n\r\nexport function checkIfExistsInArray<T>(array: T[], searchValue: T): boolean {\r\n  return array.includes(searchValue);\r\n}\r\n\r\nexport const currencyFormatter = (value: number | null | undefined): string => {\r\n  return value?.toLocaleString(\"en-US\", {\r\n    style: \"currency\",\r\n    currency: \"USD\",\r\n  }) ?? \"\";\r\n};\r\nexport const formatNumber = (number: number | string | null | undefined): string => {\r\n  if (isNaN(Number(number)) || number === null || number === undefined) {\r\n    return \"0\";\r\n  }\r\n\r\n  const formattedNumber = Number(number)\r\n    .toString()\r\n    .replace(/\\B(?=(\\d{3})+(?!\\d))/g, \",\");\r\n\r\n  return formattedNumber;\r\n};\r\n\r\nexport const parseCurrencyValueToNumber = (value: unknown): number => {\r\n  if (value == null || value === \"\") return 0;\r\n\r\n  const raw =\r\n    typeof value === \"object\" && value !== null && \"value\" in value\r\n      ? (value as { value: unknown }).value\r\n      : value;\r\n\r\n  const stringValue = raw == null || raw === \"\" ? \"\" : String(raw);\r\n  const numericValue = stringValue.replace(/[$,]/g, \"\");\r\n  return parseFloat(numericValue) || 0;\r\n};\r\n\r\nexport function flattenTableData<T extends Record<string, unknown>>(\r\n  data: T[] | null | undefined,\r\n  columns: { field?: string }[] | null | undefined\r\n): T[] {\r\n  if (!Array.isArray(data)) return [];\r\n  return data.map((row) => {\r\n    const flatRow = { ...row };\r\n    (columns ?? []).forEach((col) => {\r\n      const key = col.field;\r\n      if (!key) return;\r\n      if (key.includes(\".\")) {\r\n        const value = key.split(\".\").reduce<unknown>(\r\n          (acc, part) => (acc as Record<string, unknown> | undefined)?.[part],\r\n          row\r\n        );\r\n        (flatRow as Record<string, unknown>)[key] = value ?? \"\";\r\n      }\r\n    });\r\n    return flatRow;\r\n  });\r\n}\r\n\r\nexport const getErrorMessages = (error: {\r\n  data?: {\r\n    errors?: Record<string, string[]>;\r\n    title?: string;\r\n    error?: { name?: string[] };\r\n  };\r\n} | null | undefined): string => {\r\n  if (error?.data?.errors) {\r\n    return Object.values(error.data.errors).flat().join(\"\\n\");\r\n  }\r\n  return (\r\n    error?.data?.title ??\r\n    error?.data?.error?.name?.[0] ??\r\n    \"Failed to save\"\r\n  );\r\n};\r\n\r\nexport const getFieldsByCategory = <T extends { category?: string }>(\r\n  fields: T[] = [],\r\n  key: string\r\n): T[] => {\r\n  return fields?.filter(({ category = \"\" }) => category === key);\r\n};\r\n\r\nexport const getFieldsByName = <T extends { name?: string }>(\r\n  fields: T[] = [],\r\n  key: string\r\n): T[] => {\r\n  return fields.filter(({ name = \"\" }) => name === key);\r\n};\r\n\r\nexport const deserializeJson = <T = unknown>(jsonString: string): T | null => {\r\n  try {\r\n    return JSON.parse(jsonString) as T;\r\n  } catch (error) {\r\n    console.error(\"Error parsing JSON:\", error);\r\n    return null;\r\n  }\r\n};\r\n\r\nexport const formatDateTime = (dateString: string | null | undefined): string => {\r\n  if (!dateString) return \"Invalid Date\";\r\n  const date = new Date(dateString);\r\n  if (isNaN(date.getTime())) return \"Invalid Date\";\r\n  const options: Intl.DateTimeFormatOptions = {\r\n    year: \"numeric\",\r\n    month: \"numeric\",\r\n    day: \"numeric\",\r\n    hour: \"numeric\",\r\n    minute: \"numeric\",\r\n    hour12: true,\r\n  };\r\n  return date.toLocaleString(\"en-US\", options);\r\n};\r\n\r\nexport const removeByPropertyValues = <T extends Record<string, unknown>>(\r\n  items: T[] = [],\r\n  property: keyof T & string,\r\n  values: unknown[] = [],\r\n  { caseInsensitive = false }: { caseInsensitive?: boolean } = {}\r\n): T[] => {\r\n  if (!Array.isArray(items) || !property) return Array.isArray(items) ? items : [];\r\n  const normalize = (v: unknown) =>\r\n    caseInsensitive && typeof v === \"string\" ? v.toLowerCase() : v;\r\n  const valuesArr = Array.isArray(values) ? values : [values];\r\n  const toRemove = new Set(valuesArr.map(normalize));\r\n  return items.filter((item) => !toRemove.has(normalize(item?.[property])));\r\n};\r\n\r\nexport const getFieldsByInputType = <T extends { inputType?: string }>(\r\n  fields: T[] = [],\r\n  key: string\r\n): T[] => {\r\n  return fields.filter(({ inputType = \"\" }) => inputType === key);\r\n};\r\n","import toast from \"react-hot-toast\";\r\nimport Swal from \"sweetalert2\";\r\n\r\nexport type RtkQueryError = {\r\n  status?: number | string;\r\n  originalStatus?: number;\r\n  data?: {\r\n    errors?: Record<string, string[]>;\r\n    message?: string;\r\n    title?: string;\r\n  };\r\n  error?: string;\r\n};\r\n\r\nexport interface HandleApiErrorOptions {\r\n  showAlert?: boolean;\r\n  fallbackMessage?: string;\r\n}\r\n\r\nexport function formatValidationErrorsHtml(\r\n  errors: Record<string, string[]>\r\n): string {\r\n  const items = Object.keys(errors).flatMap((field) =>\r\n    (errors[field] || []).map((msg) => `<li>${msg}</li>`)\r\n  );\r\n  return `\r\n        <div style=\"text-align:left\">\r\n          <p>Please review and correct the following:</p>\r\n          <ul style=\"margin:8px 0 0 16px; list-style:disc;\">\r\n            ${items.join(\"\")}\r\n          </ul>\r\n        </div>\r\n      `;\r\n}\r\n\r\nfunction showValidationAlert(html: string): void {\r\n  void Swal.fire({\r\n    title: \"Validation errors\",\r\n    html,\r\n    icon: \"error\",\r\n    confirmButtonText: \"OK\",\r\n    showCancelButton: false,\r\n    confirmButtonColor: \"#FF7335\",\r\n  });\r\n}\r\n\r\n/** Handles RTK Query errors with built-in toast.error or SweetAlert (when showAlert is true). */\r\nexport function handleApiError(\r\n  error: RtkQueryError | null | undefined,\r\n  { showAlert = false, fallbackMessage }: HandleApiErrorOptions = {}\r\n): void {\r\n  if (!error) return;\r\n\r\n  const status = error.status ?? error.originalStatus;\r\n  const data = error.data;\r\n\r\n  if (status === 200) {\r\n    return;\r\n  }\r\n\r\n  if (data?.errors && typeof data.errors === \"object\") {\r\n    const errors = data.errors;\r\n\r\n    if (showAlert) {\r\n      showValidationAlert(formatValidationErrorsHtml(errors));\r\n    } else {\r\n      Object.keys(errors).forEach((field) => {\r\n        (errors[field] || []).forEach((errorMessage) => {\r\n          toast.error(errorMessage);\r\n        });\r\n      });\r\n    }\r\n    return;\r\n  }\r\n\r\n  if (status === 404) {\r\n    return;\r\n  }\r\n\r\n  const message =\r\n    fallbackMessage ||\r\n    data?.message ||\r\n    data?.title ||\r\n    error.error ||\r\n    \"An error occurred. Please try again.\";\r\n\r\n  toast.error(message);\r\n}\r\n\r\nexport interface ConfirmationAlertOptions {\r\n  title?: string;\r\n  text?: string;\r\n  icon?: \"warning\" | \"info\" | \"question\" | \"error\" | \"success\";\r\n  confirmButtonText?: string;\r\n  cancelButtonText?: string;\r\n}\r\n\r\nexport function confirmationAlert(\r\n  onConfirm: () => void,\r\n  options: ConfirmationAlertOptions = {}\r\n): void {\r\n  void Swal.fire({\r\n    title: options.title ?? \"Are you sure?\",\r\n    text: options.text,\r\n    icon: options.icon ?? \"warning\",\r\n    showCancelButton: true,\r\n    confirmButtonText: options.confirmButtonText ?? \"Yes\",\r\n    cancelButtonText: options.cancelButtonText ?? \"Cancel\",\r\n    confirmButtonColor: \"#FF7335\",\r\n  }).then((result) => {\r\n    if (result.isConfirmed) {\r\n      onConfirm();\r\n    }\r\n  });\r\n}\r\n"],"mappings":"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","names":[]}