@eztrak/shared 0.13.6 → 0.13.7

package/dist/handleApiError-Dgh_d-CX.d.mts

@@ -0,0 +1,48 @@
+type RtkQueryError = {
+    status?: number | string;
+    originalStatus?: number;
+    data?: {
+        errors?: Record<string, string[]>;
+        message?: string;
+        title?: string;
+    };
+    error?: string;
+};
+interface HandleApiErrorOptions {
+    showAlert?: boolean;
+    fallbackMessage?: string;
+}
+type ErrorSuggestedAction = "retry" | "refresh" | "contact-support" | "none";
+type ErrorClassification = {
+    isRetryable: boolean;
+    userMessage: string;
+    technicalMessage: string;
+    suggestedAction: ErrorSuggestedAction;
+};
+/** Returns true for transient network/server errors that warrant automatic retry. */
+declare function isRetryableError(error: RtkQueryError | null | undefined): boolean;
+/** Classifies RTK Query errors for user messaging and retry guidance. */
+declare function classifyError(error: RtkQueryError | null | undefined): ErrorClassification;
+declare function formatValidationErrorsHtml(errors: Record<string, string[]>): string;
+/** Handles RTK Query errors with built-in toast.error or SweetAlert (when showAlert is true). */
+declare function handleApiError(error: RtkQueryError | null | undefined, { showAlert, fallbackMessage }?: HandleApiErrorOptions): void;
+interface ConfirmationAlertOptions {
+    title?: string;
+    text?: string;
+    html?: string;
+    icon?: "warning" | "info" | "question" | "error" | "success";
+    confirmButtonText?: string;
+    cancelButtonText?: string;
+    confirmButtonColor?: string;
+    cancelButtonColor?: string;
+    showLoaderOnConfirm?: boolean;
+    /** Type exactly — trimmed, case-sensitive. */
+    inputExpectedValue?: string;
+    inputPlaceholder?: string;
+    reverseButtons?: boolean;
+    focusCancel?: boolean;
+    zIndex?: number;
+}
+declare function confirmationAlert(onConfirm: () => void | Promise<void>, options?: ConfirmationAlertOptions): void;
+
+export { type ConfirmationAlertOptions as C, type ErrorClassification as E, type HandleApiErrorOptions as H, type RtkQueryError as R, type ErrorSuggestedAction as a, confirmationAlert as b, classifyError as c, formatValidationErrorsHtml as f, handleApiError as h, isRetryableError as i };

package/dist/handleApiError-Dgh_d-CX.d.ts

@@ -0,0 +1,48 @@
+type RtkQueryError = {
+    status?: number | string;
+    originalStatus?: number;
+    data?: {
+        errors?: Record<string, string[]>;
+        message?: string;
+        title?: string;
+    };
+    error?: string;
+};
+interface HandleApiErrorOptions {
+    showAlert?: boolean;
+    fallbackMessage?: string;
+}
+type ErrorSuggestedAction = "retry" | "refresh" | "contact-support" | "none";
+type ErrorClassification = {
+    isRetryable: boolean;
+    userMessage: string;
+    technicalMessage: string;
+    suggestedAction: ErrorSuggestedAction;
+};
+/** Returns true for transient network/server errors that warrant automatic retry. */
+declare function isRetryableError(error: RtkQueryError | null | undefined): boolean;
+/** Classifies RTK Query errors for user messaging and retry guidance. */
+declare function classifyError(error: RtkQueryError | null | undefined): ErrorClassification;
+declare function formatValidationErrorsHtml(errors: Record<string, string[]>): string;
+/** Handles RTK Query errors with built-in toast.error or SweetAlert (when showAlert is true). */
+declare function handleApiError(error: RtkQueryError | null | undefined, { showAlert, fallbackMessage }?: HandleApiErrorOptions): void;
+interface ConfirmationAlertOptions {
+    title?: string;
+    text?: string;
+    html?: string;
+    icon?: "warning" | "info" | "question" | "error" | "success";
+    confirmButtonText?: string;
+    cancelButtonText?: string;
+    confirmButtonColor?: string;
+    cancelButtonColor?: string;
+    showLoaderOnConfirm?: boolean;
+    /** Type exactly — trimmed, case-sensitive. */
+    inputExpectedValue?: string;
+    inputPlaceholder?: string;
+    reverseButtons?: boolean;
+    focusCancel?: boolean;
+    zIndex?: number;
+}
+declare function confirmationAlert(onConfirm: () => void | Promise<void>, options?: ConfirmationAlertOptions): void;
+
+export { type ConfirmationAlertOptions as C, type ErrorClassification as E, type HandleApiErrorOptions as H, type RtkQueryError as R, type ErrorSuggestedAction as a, confirmationAlert as b, classifyError as c, formatValidationErrorsHtml as f, handleApiError as h, isRetryableError as i };

package/dist/index.d.mts

@@ -1,7 +1,9 @@
-export { ConfirmationAlertOptions, HandleApiErrorOptions, PermissionRecord, RtkQueryError, TransformedPermissions, USER_STATE_STORAGE_KEY, capitalizeText, checkIfExistsInArray, cn, confirmationAlert, convertCommaDataToArray, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, formatNumber, formatValidationErrorsHtml, get, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, getItem, getItemFromLocalStorage, handleApiError, isEmpty, loadUserState, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, removeItem, saveItemLocalStorage, saveUserState, set, setItem, storeItemInLocalStorage, toDateInputValue, toLowerCaseText, transformPermissions, truncateFileName, truncateText } from './utils/index.mjs';
+export { CreateBaseQueryWithRetryOptions, PermissionRecord, TransformedPermissions, USER_STATE_STORAGE_KEY, capitalizeText, checkIfExistsInArray, cn, convertCommaDataToArray, createBaseQueryWithRetry, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, formatNumber, get, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, getItem, getItemFromLocalStorage, isEmpty, loadUserState, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, removeItem, saveItemLocalStorage, saveUserState, set, setItem, storeItemInLocalStorage, toDateInputValue, toLowerCaseText, transformPermissions, truncateFileName, truncateText } from './utils/index.mjs';
+export { C as ConfirmationAlertOptions, E as ErrorClassification, a as ErrorSuggestedAction, H as HandleApiErrorOptions, R as RtkQueryError, c as classifyError, b as confirmationAlert, f as formatValidationErrorsHtml, h as handleApiError, i as isRetryableError } from './handleApiError-Dgh_d-CX.mjs';
 export { UseGridHeightOptions, useGridHeight, usePaginationUrlSync } from './hooks/index.mjs';
-export { CardSkeleton, CardSkeletonProps, CardSkeletonVariant, CellEditPayload, CellEditorInputType, CustomCellEditor, CustomCellEditorProps, CustomCellEditorRef, CustomPagination, CustomPaginationClassNames, CustomPaginationProps, DropdownFilter, DropdownFilterProps, DropdownOption, EztrakTab, EztrakTabs, EztrakTabsClassNames, EztrakTabsProps, LayoutStatus, Loader, LoaderProps, Modal, ModalProps, PaginationData, PopupActionHandler, PopupCellRenderer, PopupCellRendererParams, PopupCellRendererProps, PopupDropDownContent, ResetColumnsButton, ResetColumnsButtonProps, ResetFiltersButton, ResetFiltersButtonProps, ResetFiltersButtonVariant, SearchInput, SearchInputProps, TableLayoutToolbarControls, TableLayoutToolbarControlsProps, ToolTip, ToolTipProps, TooltipText, TooltipTextProps, dropdownStyles } from './components/index.mjs';
+export { CardSkeleton, CardSkeletonProps, CardSkeletonVariant, CellEditPayload, CellEditorInputType, CustomCellEditor, CustomCellEditorProps, CustomCellEditorRef, CustomPagination, CustomPaginationClassNames, CustomPaginationProps, DropdownFilter, DropdownFilterProps, DropdownOption, EztrakTab, EztrakTabs, EztrakTabsClassNames, EztrakTabsProps, LayoutStatus, Loader, LoaderProps, Modal, ModalProps, PaginationData, PopupActionHandler, PopupCellRenderer, PopupCellRendererParams, PopupCellRendererProps, PopupDropDownContent, ResetColumnsButton, ResetColumnsButtonProps, ResetFiltersButton, ResetFiltersButtonProps, ResetFiltersButtonVariant, SearchInput, SearchInputProps, TableErrorBoundary, TableErrorBoundaryProps, TableLayoutToolbarControls, TableLayoutToolbarControlsProps, ToolTip, ToolTipProps, TooltipText, TooltipTextProps, dropdownStyles } from './components/index.mjs';
 import 'clsx';
+import '@reduxjs/toolkit/query';
 import 'react-router-dom';
 import 'react';
 import 'react-select';

package/dist/index.d.ts

@@ -1,7 +1,9 @@
-export { ConfirmationAlertOptions, HandleApiErrorOptions, PermissionRecord, RtkQueryError, TransformedPermissions, USER_STATE_STORAGE_KEY, capitalizeText, checkIfExistsInArray, cn, confirmationAlert, convertCommaDataToArray, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, formatNumber, formatValidationErrorsHtml, get, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, getItem, getItemFromLocalStorage, handleApiError, isEmpty, loadUserState, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, removeItem, saveItemLocalStorage, saveUserState, set, setItem, storeItemInLocalStorage, toDateInputValue, toLowerCaseText, transformPermissions, truncateFileName, truncateText } from './utils/index.js';
+export { CreateBaseQueryWithRetryOptions, PermissionRecord, TransformedPermissions, USER_STATE_STORAGE_KEY, capitalizeText, checkIfExistsInArray, cn, convertCommaDataToArray, createBaseQueryWithRetry, currencyFormatter, deserializeJson, flattenTableData, formatDate, formatDateTime, formatNumber, get, getApiError, getErrorMessages, getFieldsByCategory, getFieldsByInputType, getFieldsByName, getItem, getItemFromLocalStorage, isEmpty, loadUserState, normalizeApiListItems, parseCurrencyValueToNumber, removeByPropertyValues, removeItem, saveItemLocalStorage, saveUserState, set, setItem, storeItemInLocalStorage, toDateInputValue, toLowerCaseText, transformPermissions, truncateFileName, truncateText } from './utils/index.js';
+export { C as ConfirmationAlertOptions, E as ErrorClassification, a as ErrorSuggestedAction, H as HandleApiErrorOptions, R as RtkQueryError, c as classifyError, b as confirmationAlert, f as formatValidationErrorsHtml, h as handleApiError, i as isRetryableError } from './handleApiError-Dgh_d-CX.js';
 export { UseGridHeightOptions, useGridHeight, usePaginationUrlSync } from './hooks/index.js';
-export { CardSkeleton, CardSkeletonProps, CardSkeletonVariant, CellEditPayload, CellEditorInputType, CustomCellEditor, CustomCellEditorProps, CustomCellEditorRef, CustomPagination, CustomPaginationClassNames, CustomPaginationProps, DropdownFilter, DropdownFilterProps, DropdownOption, EztrakTab, EztrakTabs, EztrakTabsClassNames, EztrakTabsProps, LayoutStatus, Loader, LoaderProps, Modal, ModalProps, PaginationData, PopupActionHandler, PopupCellRenderer, PopupCellRendererParams, PopupCellRendererProps, PopupDropDownContent, ResetColumnsButton, ResetColumnsButtonProps, ResetFiltersButton, ResetFiltersButtonProps, ResetFiltersButtonVariant, SearchInput, SearchInputProps, TableLayoutToolbarControls, TableLayoutToolbarControlsProps, ToolTip, ToolTipProps, TooltipText, TooltipTextProps, dropdownStyles } from './components/index.js';
+export { CardSkeleton, CardSkeletonProps, CardSkeletonVariant, CellEditPayload, CellEditorInputType, CustomCellEditor, CustomCellEditorProps, CustomCellEditorRef, CustomPagination, CustomPaginationClassNames, CustomPaginationProps, DropdownFilter, DropdownFilterProps, DropdownOption, EztrakTab, EztrakTabs, EztrakTabsClassNames, EztrakTabsProps, LayoutStatus, Loader, LoaderProps, Modal, ModalProps, PaginationData, PopupActionHandler, PopupCellRenderer, PopupCellRendererParams, PopupCellRendererProps, PopupDropDownContent, ResetColumnsButton, ResetColumnsButtonProps, ResetFiltersButton, ResetFiltersButtonProps, ResetFiltersButtonVariant, SearchInput, SearchInputProps, TableErrorBoundary, TableErrorBoundaryProps, TableLayoutToolbarControls, TableLayoutToolbarControlsProps, ToolTip, ToolTipProps, TooltipText, TooltipTextProps, dropdownStyles } from './components/index.js';
 import 'clsx';
+import '@reduxjs/toolkit/query';
 import 'react-router-dom';
 import 'react';
 import 'react-select';

package/dist/index.js

@@ -41,15 +41,18 @@ __export(src_exports, {
   ResetColumnsButton: () => ResetColumnsButton,
   ResetFiltersButton: () => ResetFiltersButton,
   SearchInput: () => SearchInput,
+  TableErrorBoundary: () => TableErrorBoundary,
   TableLayoutToolbarControls: () => TableLayoutToolbarControls,
   ToolTip: () => ToolTip,
   TooltipText: () => TooltipText,
   USER_STATE_STORAGE_KEY: () => USER_STATE_STORAGE_KEY,
   capitalizeText: () => capitalizeText,
   checkIfExistsInArray: () => checkIfExistsInArray,
+  classifyError: () => classifyError,
   cn: () => cn,
   confirmationAlert: () => confirmationAlert,
   convertCommaDataToArray: () => convertCommaDataToArray,
+  createBaseQueryWithRetry: () => createBaseQueryWithRetry,
   currencyFormatter: () => currencyFormatter,
   deserializeJson: () => deserializeJson,
   dropdownStyles: () => dropdownStyles,
@@ -68,6 +71,7 @@ __export(src_exports, {
   getItemFromLocalStorage: () => getItemFromLocalStorage,
   handleApiError: () => handleApiError,
   isEmpty: () => isEmpty,
+  isRetryableError: () => isRetryableError,
   loadUserState: () => loadUserState,
   normalizeApiListItems: () => normalizeApiListItems,
   parseCurrencyValueToNumber: () => parseCurrencyValueToNumber,
@@ -350,6 +354,52 @@ function transformPermissions(permissions) {
 // src/utils/handleApiError.ts
 var import_react_hot_toast = __toESM(require("react-hot-toast"));
 var import_sweetalert2 = __toESM(require("sweetalert2"));
+function isRetryableError(error) {
+  if (!error) return false;
+  const status = error.status ?? error.originalStatus;
+  if (status === "FETCH_ERROR" || status === "TIMEOUT_ERROR" || status === "PARSING_ERROR") {
+    return true;
+  }
+  if (typeof status === "number") {
+    if (status === 502 || status === 503 || status === 504) return true;
+    if (status >= 500 && status < 600) return true;
+  }
+  return false;
+}
+function classifyError(error) {
+  if (!error) {
+    return {
+      isRetryable: false,
+      userMessage: "An error occurred.",
+      technicalMessage: "Unknown error",
+      suggestedAction: "none"
+    };
+  }
+  const status = error.status ?? error.originalStatus;
+  const data = error.data;
+  if (status === "FETCH_ERROR" || status === "TIMEOUT_ERROR" || status === "PARSING_ERROR") {
+    return {
+      isRetryable: true,
+      userMessage: "Network error. Please check your connection.",
+      technicalMessage: "Network request failed",
+      suggestedAction: "retry"
+    };
+  }
+  if (typeof status === "number" && status >= 500 && status < 600) {
+    return {
+      isRetryable: true,
+      userMessage: "Server is temporarily unavailable. Please try again.",
+      technicalMessage: `Server error: ${status}`,
+      suggestedAction: "retry"
+    };
+  }
+  return {
+    isRetryable: false,
+    userMessage: data?.message || data?.title || error.error || "An error occurred. Please try again.",
+    technicalMessage: typeof status === "number" || typeof status === "string" ? `Client error: ${status}` : "Request failed",
+    suggestedAction: "none"
+  };
+}
 function formatValidationErrorsHtml(errors) {
   const items = Object.keys(errors).flatMap(
     (field) => (errors[field] || []).map((msg) => `<li>${msg}</li>`)
@@ -489,6 +539,45 @@ function confirmationAlert(onConfirm, options = {}) {
   });
 }
 
+// src/utils/createBaseQueryWithRetry.ts
+var import_query = require("@reduxjs/toolkit/query");
+function getRequestMethod(args) {
+  if (typeof args === "string") return "GET";
+  if (args && typeof args === "object" && "method" in args) {
+    const method = args.method;
+    return (method || "GET").toUpperCase();
+  }
+  return "GET";
+}
+function createBaseQueryWithRetry(baseQueryWithReauth, {
+  maxRetries = 3,
+  maxBackoffMs = 8e3
+} = {}) {
+  const retryableQuery = (0, import_query.retry)(
+    async (args, api, extraOptions) => {
+      const result = await baseQueryWithReauth(args, api, extraOptions);
+      if (result.error && !isRetryableError(result.error)) {
+        import_query.retry.fail(result.error);
+      }
+      return result;
+    },
+    {
+      maxRetries,
+      backoff: (attempt) => new Promise(
+        (resolve) => setTimeout(resolve, Math.min(1e3 * 2 ** attempt, maxBackoffMs))
+      )
+    }
+  );
+  const baseQueryWithConditionalRetry = async (args, api, extraOptions) => {
+    const method = getRequestMethod(args);
+    if (method !== "GET") {
+      return baseQueryWithReauth(args, api, extraOptions);
+    }
+    return retryableQuery(args, api, extraOptions);
+  };
+  return baseQueryWithConditionalRetry;
+}
+
 // src/hooks/usePaginationUrlSync.ts
 var import_react = require("react");
 var usePaginationUrlSync = (searchParams, setSearchParams, page, setPage, perPage, setPerPage, defaultPage = 1, defaultPerPage = 20) => {
@@ -2091,6 +2180,85 @@ function PopupCellRenderer({
     }
   ) });
 }
+
+// src/components/table-error-boundary/TableErrorBoundary.tsx
+var import_react11 = require("react");
+var import_fa6 = require("react-icons/fa6");
+var import_jsx_runtime13 = require("react/jsx-runtime");
+var TableErrorBoundary = ({
+  isError,
+  isLoading = false,
+  refetch,
+  children,
+  error,
+  errorMessage,
+  className,
+  minHeight = "280px"
+}) => {
+  const message = (0, import_react11.useMemo)(() => {
+    if (errorMessage) return errorMessage;
+    if (error) return classifyError(error).userMessage;
+    return "Unable to load table data. Please try again.";
+  }, [error, errorMessage]);
+  if (isLoading && !isError) {
+    return /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
+      "div",
+      {
+        className: cn(
+          "flex w-full items-center justify-center rounded-xl bg-neutral-50",
+          className
+        ),
+        style: { minHeight },
+        role: "status",
+        "aria-live": "polite",
+        "aria-busy": "true",
+        children: /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(Loader, { size: "40px" })
+      }
+    );
+  }
+  if (isError) {
+    return /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)(
+      "div",
+      {
+        className: cn(
+          "flex w-full flex-col items-center justify-center gap-4 rounded-xl border border-red-100 bg-red-50 px-6 py-10 text-center",
+          className
+        ),
+        style: { minHeight },
+        role: "alert",
+        "aria-live": "assertive",
+        children: [
+          /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(
+            import_fa6.FaTriangleExclamation,
+            {
+              className: "text-red-500",
+              size: 32,
+              "aria-hidden": true
+            }
+          ),
+          /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)("div", { className: "max-w-md space-y-1", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("p", { className: "text-base font-semibold text-gray-800", children: "Failed to load data" }),
+            /* @__PURE__ */ (0, import_jsx_runtime13.jsx)("p", { className: "text-sm text-gray-600", children: message })
+          ] }),
+          refetch && /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)(
+            "button",
+            {
+              type: "button",
+              onClick: () => refetch(),
+              disabled: isLoading,
+              className: "inline-flex items-center gap-2 rounded-lg bg-primary-150 px-4 py-2 text-sm font-medium text-white transition-colors hover:opacity-90 disabled:cursor-not-allowed disabled:opacity-60",
+              children: [
+                /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(import_fa6.FaArrowsRotate, { className: cn(isLoading && "animate-spin") }),
+                isLoading ? "Retrying..." : "Try again"
+              ]
+            }
+          )
+        ]
+      }
+    );
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime13.jsx)(import_jsx_runtime13.Fragment, { children });
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CardSkeleton,
@@ -2104,15 +2272,18 @@ function PopupCellRenderer({
   ResetColumnsButton,
   ResetFiltersButton,
   SearchInput,
+  TableErrorBoundary,
   TableLayoutToolbarControls,
   ToolTip,
   TooltipText,
   USER_STATE_STORAGE_KEY,
   capitalizeText,
   checkIfExistsInArray,
+  classifyError,
   cn,
   confirmationAlert,
   convertCommaDataToArray,
+  createBaseQueryWithRetry,
   currencyFormatter,
   deserializeJson,
   dropdownStyles,
@@ -2131,6 +2302,7 @@ function PopupCellRenderer({
   getItemFromLocalStorage,
   handleApiError,
   isEmpty,
+  isRetryableError,
   loadUserState,
   normalizeApiListItems,
   parseCurrencyValueToNumber,