@exyconn/common 1.0.0

package/README.md

@@ -0,0 +1,259 @@
+# @exyconn/common
+
+Common utilities, hooks, types, and data shared across all Exyconn projects (botify.life, exyconn.com, partywings.fun, sibera.work, spentiva.com).
+
+## Installation
+
+```bash
+npm install @exyconn/common
+# or
+yarn add @exyconn/common
+# or
+pnpm add @exyconn/common
+```
+
+## Features
+
+- ���️ **Server utilities** - Response helpers, middleware, logging, database connections
+- ��� **Client utilities** - HTTP clients, React hooks, response parsing
+- ��� **Shared types** - TypeScript interfaces for API responses, users, etc.
+- ��� **Data modules** - Countries, currencies, phone codes, timezones, brand logos
+- ✅ **Validation** - Common patterns, regex, and validation helpers
+- ��� **Date utilities** - Enhanced date-fns with timezone support
+
+## Usage
+
+### Import Everything
+
+```typescript
+import { server, client, shared, data } from '@exyconn/common';
+```
+
+### Server-side
+
+```typescript
+// Response helpers
+import { successResponse, errorResponse, paginatedResponse } from '@exyconn/common/server/response';
+
+// Status codes & messages
+import { STATUS_CODES, STATUS_MESSAGES } from '@exyconn/common/server/enums';
+
+// Winston logger
+import { createLogger, logger } from '@exyconn/common/server/logger';
+
+// MongoDB connection
+import { connectDB } from '@exyconn/common/server/db';
+
+// Auth middleware
+import { authMiddleware, apiKeyMiddleware } from '@exyconn/common/server/middleware';
+```
+
+### Client-side
+
+```typescript
+// HTTP client
+import { createHttpClient, httpGet, httpPost } from '@exyconn/common/client/http';
+
+// React hooks
+import { 
+  useLocalStorage,
+  useDebounce,
+  useCopyToClipboard,
+  usePageTitle,
+  useSnackbar,
+  useMediaQuery,
+  useIsMobile,
+  useThemeDetector,
+  useInterval,
+  useOnClickOutside,
+  useWindowSize
+} from '@exyconn/common/client/hooks';
+
+// Utils
+import { 
+  formatDate, 
+  copyToClipboard, 
+  toSlug,
+  isSuccessResponse,
+  getErrorMessage
+} from '@exyconn/common/client/utils';
+```
+
+### Shared Types
+
+```typescript
+import type { 
+  ApiResponse, 
+  PaginatedResponse, 
+  User, 
+  AuthResponse,
+  JwtPayload
+} from '@exyconn/common/shared/types';
+```
+
+### Validation
+
+```typescript
+import { 
+  VALIDATION_PATTERNS,
+  VALIDATION_MESSAGES,
+  isValidEmail,
+  isValidPassword,
+  isValidPhone,
+  isValidUrl
+} from '@exyconn/common/shared/validation';
+```
+
+### Date/Time Utilities
+
+```typescript
+import { 
+  formatDate,
+  formatDateTime,
+  formatDateInTimezone,
+  formatRelativeTime,
+  formatSmartDate,
+  toTimezone,
+  fromTimezone,
+  nowInTimezone,
+  addTime,
+  subtractTime,
+  getDayBoundaries,
+  getAge,
+  isWeekend,
+  DATE_FORMATS
+} from '@exyconn/common/shared';
+```
+
+### Data Modules
+
+```typescript
+// Countries with nested states/cities
+import { 
+  countries, 
+  getCountryByCode, 
+  getStatesByCountry, 
+  getCitiesByState,
+  searchCountries
+} from '@exyconn/common/data/countries';
+
+// Currencies
+import { 
+  currencies, 
+  getCurrencyByCode, 
+  formatCurrency,
+  formatCurrencyNative
+} from '@exyconn/common/data/currencies';
+
+// Phone codes
+import { phoneCodes, getPhoneCodeByCountry } from '@exyconn/common/data/phone-codes';
+
+// Timezones
+import { 
+  timezones, 
+  getTimezoneByCode, 
+  searchTimezones,
+  getCommonTimezones
+} from '@exyconn/common/data/timezones';
+
+// Brand logos (all 5 companies)
+import { 
+  brands, 
+  getBrandByName, 
+  getAllBrands 
+} from '@exyconn/common/data/logos';
+```
+
+## Data Module Details
+
+### Countries
+- 50+ countries with full details
+- Nested states/cities for major countries
+- Includes phone codes, currencies, timezones
+
+### Currencies
+- 100+ world currencies
+- Symbol, name, and native formatting
+- formatCurrency(amount, code) helper
+
+### Phone Codes
+- 190+ international phone codes
+- Country flags (emoji)
+
+### Timezones
+- 65+ timezones with UTC offsets
+- Common timezone presets
+- Search and filter functions
+
+### Brand Logos
+All 5 Exyconn company brands with light/dark mode support:
+- **botify.life** - AI/Bot platform
+- **exyconn.com** - Main Exyconn brand
+- **partywings.fun** - Event platform
+- **sibera.work** - Work management
+- **spentiva.com** - Finance platform
+
+## React Hooks
+
+| Hook | Description |
+|------|-------------|
+| useLocalStorage | Persist state in localStorage with cross-tab sync |
+| useDebounce | Debounce a value with configurable delay |
+| useCopyToClipboard | Copy text to clipboard with status |
+| usePageTitle | Set document title with suffix |
+| useSnackbar | Toast/snackbar notification state |
+| useMediaQuery | Track media query matches |
+| useIsMobile / useIsDesktop | Responsive breakpoint hooks |
+| useThemeDetector | Detect system light/dark mode |
+| useInterval | Safely run intervals with cleanup |
+| useOnClickOutside | Detect clicks outside element |
+| useWindowSize | Track window dimensions |
+
+## Peer Dependencies
+
+All peer dependencies are optional - only install what you need:
+
+```json
+{
+  "axios": "^1.6.0",
+  "date-fns": "^3.0.0",
+  "date-fns-tz": "^3.0.0",
+  "express": "^4.18.0",
+  "jsonwebtoken": "^9.0.0",
+  "mongoose": "^8.0.0",
+  "react": "^18.0.0",
+  "winston": "^3.11.0"
+}
+```
+
+## Package Exports
+
+```
+@exyconn/common
+├── /server          # Server-side utilities
+│   ├── /response    # Response helpers
+│   ├── /enums       # Status codes/messages
+│   ├── /logger      # Winston logger
+│   ├── /db          # Database connections
+│   ├── /middleware  # Auth middleware
+│   └── /utils       # Server utilities
+├── /client          # Client-side utilities
+│   ├── /http        # Axios HTTP client
+│   ├── /hooks       # React hooks
+│   ├── /logger      # Browser logger
+│   └── /utils       # Client utilities
+├── /shared          # Shared between server/client
+│   ├── /types       # TypeScript types
+│   ├── /validation  # Validation patterns
+│   └── /utils       # Date-time utilities
+└── /data            # Static data modules
+    ├── /countries   # Countries with cities
+    ├── /currencies  # World currencies
+    ├── /phone-codes # Phone codes
+    ├── /timezones   # Timezones
+    └── /logos       # Brand logos
+```
+
+## License
+
+MIT © Exyconn

package/dist/client/http/index.d.mts

@@ -0,0 +1,85 @@
+import { AxiosError, AxiosInstance, AxiosRequestConfig, AxiosResponse } from 'axios';
+
+/**
+ * HTTP Client Configuration Options
+ */
+interface HttpClientOptions {
+    baseURL: string;
+    timeout?: number;
+    withCredentials?: boolean;
+    getAuthToken?: () => string | null;
+    onUnauthorized?: () => void;
+    onServerError?: (error: AxiosError) => void;
+}
+/**
+ * Create configured Axios instance
+ */
+declare const createHttpClient: (options: HttpClientOptions) => AxiosInstance;
+/**
+ * Default request config helpers
+ */
+declare const withFormData: () => AxiosRequestConfig;
+declare const withTimeout: (ms: number) => AxiosRequestConfig;
+declare const withAbortSignal: (signal: AbortSignal) => AxiosRequestConfig;
+
+/**
+ * Standard API Response Structure
+ */
+interface ApiResponse<T = unknown> {
+    success: boolean;
+    message: string;
+    data?: T;
+    error?: string;
+    statusCode?: number;
+}
+/**
+ * Paginated Response Structure
+ */
+interface PaginatedResponse<T = unknown> extends ApiResponse<T[]> {
+    pagination: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+        hasNextPage: boolean;
+        hasPrevPage: boolean;
+    };
+}
+/**
+ * Parse successful API response
+ */
+declare const parseResponse: <T>(response: AxiosResponse<ApiResponse<T>>) => T | null;
+/**
+ * Parse API response with full metadata
+ */
+declare const parseFullResponse: <T>(response: AxiosResponse<ApiResponse<T>>) => ApiResponse<T>;
+/**
+ * Parse error from API response
+ */
+declare const parseError: (error: AxiosError<ApiResponse>) => string;
+/**
+ * Check if response is successful
+ */
+declare const isSuccess: <T>(response: AxiosResponse<ApiResponse<T>>) => boolean;
+/**
+ * Check if error is a specific status code
+ */
+declare const isStatusError: (error: AxiosError, statusCode: number) => boolean;
+/**
+ * Check if error is unauthorized (401)
+ */
+declare const isUnauthorized: (error: AxiosError) => boolean;
+/**
+ * Check if error is forbidden (403)
+ */
+declare const isForbidden: (error: AxiosError) => boolean;
+/**
+ * Check if error is not found (404)
+ */
+declare const isNotFound: (error: AxiosError) => boolean;
+/**
+ * Check if error is server error (5xx)
+ */
+declare const isServerError: (error: AxiosError) => boolean;
+
+export { type ApiResponse, type HttpClientOptions, type PaginatedResponse, createHttpClient, isForbidden, isNotFound, isServerError, isStatusError, isSuccess, isUnauthorized, parseError, parseFullResponse, parseResponse, withAbortSignal, withFormData, withTimeout };

package/dist/client/http/index.d.ts

@@ -0,0 +1,85 @@
+import { AxiosError, AxiosInstance, AxiosRequestConfig, AxiosResponse } from 'axios';
+
+/**
+ * HTTP Client Configuration Options
+ */
+interface HttpClientOptions {
+    baseURL: string;
+    timeout?: number;
+    withCredentials?: boolean;
+    getAuthToken?: () => string | null;
+    onUnauthorized?: () => void;
+    onServerError?: (error: AxiosError) => void;
+}
+/**
+ * Create configured Axios instance
+ */
+declare const createHttpClient: (options: HttpClientOptions) => AxiosInstance;
+/**
+ * Default request config helpers
+ */
+declare const withFormData: () => AxiosRequestConfig;
+declare const withTimeout: (ms: number) => AxiosRequestConfig;
+declare const withAbortSignal: (signal: AbortSignal) => AxiosRequestConfig;
+
+/**
+ * Standard API Response Structure
+ */
+interface ApiResponse<T = unknown> {
+    success: boolean;
+    message: string;
+    data?: T;
+    error?: string;
+    statusCode?: number;
+}
+/**
+ * Paginated Response Structure
+ */
+interface PaginatedResponse<T = unknown> extends ApiResponse<T[]> {
+    pagination: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+        hasNextPage: boolean;
+        hasPrevPage: boolean;
+    };
+}
+/**
+ * Parse successful API response
+ */
+declare const parseResponse: <T>(response: AxiosResponse<ApiResponse<T>>) => T | null;
+/**
+ * Parse API response with full metadata
+ */
+declare const parseFullResponse: <T>(response: AxiosResponse<ApiResponse<T>>) => ApiResponse<T>;
+/**
+ * Parse error from API response
+ */
+declare const parseError: (error: AxiosError<ApiResponse>) => string;
+/**
+ * Check if response is successful
+ */
+declare const isSuccess: <T>(response: AxiosResponse<ApiResponse<T>>) => boolean;
+/**
+ * Check if error is a specific status code
+ */
+declare const isStatusError: (error: AxiosError, statusCode: number) => boolean;
+/**
+ * Check if error is unauthorized (401)
+ */
+declare const isUnauthorized: (error: AxiosError) => boolean;
+/**
+ * Check if error is forbidden (403)
+ */
+declare const isForbidden: (error: AxiosError) => boolean;
+/**
+ * Check if error is not found (404)
+ */
+declare const isNotFound: (error: AxiosError) => boolean;
+/**
+ * Check if error is server error (5xx)
+ */
+declare const isServerError: (error: AxiosError) => boolean;
+
+export { type ApiResponse, type HttpClientOptions, type PaginatedResponse, createHttpClient, isForbidden, isNotFound, isServerError, isStatusError, isSuccess, isUnauthorized, parseError, parseFullResponse, parseResponse, withAbortSignal, withFormData, withTimeout };

package/dist/client/http/index.js

@@ -0,0 +1,127 @@
+'use strict';
+
+var axios = require('axios');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var axios__default = /*#__PURE__*/_interopDefault(axios);
+
+// src/client/http/axios-instance.ts
+var createHttpClient = (options) => {
+  const {
+    baseURL,
+    timeout = 3e4,
+    withCredentials = true,
+    getAuthToken,
+    onUnauthorized,
+    onServerError
+  } = options;
+  const instance = axios__default.default.create({
+    baseURL,
+    timeout,
+    withCredentials,
+    headers: {
+      "Content-Type": "application/json"
+    }
+  });
+  instance.interceptors.request.use(
+    (config) => {
+      if (getAuthToken) {
+        const token = getAuthToken();
+        if (token && config.headers) {
+          config.headers.Authorization = `Bearer ${token}`;
+        }
+      }
+      return config;
+    },
+    (error) => Promise.reject(error)
+  );
+  instance.interceptors.response.use(
+    (response) => response,
+    (error) => {
+      if (error.response) {
+        const status = error.response.status;
+        if (status === 401 && onUnauthorized) {
+          onUnauthorized();
+        }
+        if (status >= 500 && onServerError) {
+          onServerError(error);
+        }
+      }
+      return Promise.reject(error);
+    }
+  );
+  return instance;
+};
+var withFormData = () => ({
+  headers: {
+    "Content-Type": "multipart/form-data"
+  }
+});
+var withTimeout = (ms) => ({
+  timeout: ms
+});
+var withAbortSignal = (signal) => ({
+  signal
+});
+
+// src/client/http/response-parser.ts
+var parseResponse = (response) => {
+  if (response.data?.success && response.data?.data !== void 0) {
+    return response.data.data;
+  }
+  return null;
+};
+var parseFullResponse = (response) => {
+  return response.data;
+};
+var parseError = (error) => {
+  if (error.response?.data?.message) {
+    return error.response.data.message;
+  }
+  if (error.response?.data?.error) {
+    return error.response.data.error;
+  }
+  if (error.code === "ERR_NETWORK") {
+    return "Network error. Please check your connection.";
+  }
+  if (error.code === "ECONNABORTED") {
+    return "Request timed out. Please try again.";
+  }
+  return error.message || "An unexpected error occurred.";
+};
+var isSuccess = (response) => {
+  return response.data?.success === true;
+};
+var isStatusError = (error, statusCode) => {
+  return error.response?.status === statusCode;
+};
+var isUnauthorized = (error) => {
+  return isStatusError(error, 401);
+};
+var isForbidden = (error) => {
+  return isStatusError(error, 403);
+};
+var isNotFound = (error) => {
+  return isStatusError(error, 404);
+};
+var isServerError = (error) => {
+  const status = error.response?.status;
+  return status !== void 0 && status >= 500;
+};
+
+exports.createHttpClient = createHttpClient;
+exports.isForbidden = isForbidden;
+exports.isNotFound = isNotFound;
+exports.isServerError = isServerError;
+exports.isStatusError = isStatusError;
+exports.isSuccess = isSuccess;
+exports.isUnauthorized = isUnauthorized;
+exports.parseError = parseError;
+exports.parseFullResponse = parseFullResponse;
+exports.parseResponse = parseResponse;
+exports.withAbortSignal = withAbortSignal;
+exports.withFormData = withFormData;
+exports.withTimeout = withTimeout;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/client/http/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/client/http/axios-instance.ts","../../../src/client/http/response-parser.ts"],"names":["axios"],"mappings":"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","file":"index.js","sourcesContent":["import axios, { AxiosInstance, AxiosRequestConfig, AxiosError, AxiosResponse, InternalAxiosRequestConfig } from 'axios';\r\n\r\n/**\r\n * HTTP Client Configuration Options\r\n */\r\nexport interface HttpClientOptions {\r\n  baseURL: string;\r\n  timeout?: number;\r\n  withCredentials?: boolean;\r\n  getAuthToken?: () => string | null;\r\n  onUnauthorized?: () => void;\r\n  onServerError?: (error: AxiosError) => void;\r\n}\r\n\r\n/**\r\n * Create configured Axios instance\r\n */\r\nexport const createHttpClient = (options: HttpClientOptions): AxiosInstance => {\r\n  const {\r\n    baseURL,\r\n    timeout = 30000,\r\n    withCredentials = true,\r\n    getAuthToken,\r\n    onUnauthorized,\r\n    onServerError,\r\n  } = options;\r\n\r\n  const instance = axios.create({\r\n    baseURL,\r\n    timeout,\r\n    withCredentials,\r\n    headers: {\r\n      'Content-Type': 'application/json',\r\n    },\r\n  });\r\n\r\n  // Request interceptor - add auth token\r\n  instance.interceptors.request.use(\r\n    (config: InternalAxiosRequestConfig) => {\r\n      if (getAuthToken) {\r\n        const token = getAuthToken();\r\n        if (token && config.headers) {\r\n          config.headers.Authorization = `Bearer ${token}`;\r\n        }\r\n      }\r\n      return config;\r\n    },\r\n    (error: unknown) => Promise.reject(error)\r\n  );\r\n\r\n  // Response interceptor - handle errors\r\n  instance.interceptors.response.use(\r\n    (response: AxiosResponse) => response,\r\n    (error: AxiosError) => {\r\n      if (error.response) {\r\n        const status = error.response.status;\r\n\r\n        // Handle 401 Unauthorized\r\n        if (status === 401 && onUnauthorized) {\r\n          onUnauthorized();\r\n        }\r\n\r\n        // Handle 5xx Server Errors\r\n        if (status >= 500 && onServerError) {\r\n          onServerError(error);\r\n        }\r\n      }\r\n\r\n      return Promise.reject(error);\r\n    }\r\n  );\r\n\r\n  return instance;\r\n};\r\n\r\n/**\r\n * Default request config helpers\r\n */\r\nexport const withFormData = (): AxiosRequestConfig => ({\r\n  headers: {\r\n    'Content-Type': 'multipart/form-data',\r\n  },\r\n});\r\n\r\nexport const withTimeout = (ms: number): AxiosRequestConfig => ({\r\n  timeout: ms,\r\n});\r\n\r\nexport const withAbortSignal = (signal: AbortSignal): AxiosRequestConfig => ({\r\n  signal,\r\n});\r\n\r\nexport default {\r\n  createHttpClient,\r\n  withFormData,\r\n  withTimeout,\r\n  withAbortSignal,\r\n};\r\n","import { AxiosResponse, AxiosError } from 'axios';\r\n\r\n/**\r\n * Standard API Response Structure\r\n */\r\nexport interface ApiResponse<T = unknown> {\r\n  success: boolean;\r\n  message: string;\r\n  data?: T;\r\n  error?: string;\r\n  statusCode?: number;\r\n}\r\n\r\n/**\r\n * Paginated Response Structure\r\n */\r\nexport interface PaginatedResponse<T = unknown> extends ApiResponse<T[]> {\r\n  pagination: {\r\n    total: number;\r\n    page: number;\r\n    limit: number;\r\n    totalPages: number;\r\n    hasNextPage: boolean;\r\n    hasPrevPage: boolean;\r\n  };\r\n}\r\n\r\n/**\r\n * Parse successful API response\r\n */\r\nexport const parseResponse = <T>(response: AxiosResponse<ApiResponse<T>>): T | null => {\r\n  if (response.data?.success && response.data?.data !== undefined) {\r\n    return response.data.data;\r\n  }\r\n  return null;\r\n};\r\n\r\n/**\r\n * Parse API response with full metadata\r\n */\r\nexport const parseFullResponse = <T>(response: AxiosResponse<ApiResponse<T>>): ApiResponse<T> => {\r\n  return response.data;\r\n};\r\n\r\n/**\r\n * Parse error from API response\r\n */\r\nexport const parseError = (error: AxiosError<ApiResponse>): string => {\r\n  // Check for API error message\r\n  if (error.response?.data?.message) {\r\n    return error.response.data.message;\r\n  }\r\n\r\n  if (error.response?.data?.error) {\r\n    return error.response.data.error;\r\n  }\r\n\r\n  // Check for network error\r\n  if (error.code === 'ERR_NETWORK') {\r\n    return 'Network error. Please check your connection.';\r\n  }\r\n\r\n  // Check for timeout\r\n  if (error.code === 'ECONNABORTED') {\r\n    return 'Request timed out. Please try again.';\r\n  }\r\n\r\n  // Default error message\r\n  return error.message || 'An unexpected error occurred.';\r\n};\r\n\r\n/**\r\n * Check if response is successful\r\n */\r\nexport const isSuccess = <T>(response: AxiosResponse<ApiResponse<T>>): boolean => {\r\n  return response.data?.success === true;\r\n};\r\n\r\n/**\r\n * Check if error is a specific status code\r\n */\r\nexport const isStatusError = (error: AxiosError, statusCode: number): boolean => {\r\n  return error.response?.status === statusCode;\r\n};\r\n\r\n/**\r\n * Check if error is unauthorized (401)\r\n */\r\nexport const isUnauthorized = (error: AxiosError): boolean => {\r\n  return isStatusError(error, 401);\r\n};\r\n\r\n/**\r\n * Check if error is forbidden (403)\r\n */\r\nexport const isForbidden = (error: AxiosError): boolean => {\r\n  return isStatusError(error, 403);\r\n};\r\n\r\n/**\r\n * Check if error is not found (404)\r\n */\r\nexport const isNotFound = (error: AxiosError): boolean => {\r\n  return isStatusError(error, 404);\r\n};\r\n\r\n/**\r\n * Check if error is server error (5xx)\r\n */\r\nexport const isServerError = (error: AxiosError): boolean => {\r\n  const status = error.response?.status;\r\n  return status !== undefined && status >= 500;\r\n};\r\n\r\nexport default {\r\n  parseResponse,\r\n  parseFullResponse,\r\n  parseError,\r\n  isSuccess,\r\n  isStatusError,\r\n  isUnauthorized,\r\n  isForbidden,\r\n  isNotFound,\r\n  isServerError,\r\n};\r\n"]}

package/dist/client/http/index.mjs

@@ -0,0 +1,109 @@
+import axios from 'axios';
+
+// src/client/http/axios-instance.ts
+var createHttpClient = (options) => {
+  const {
+    baseURL,
+    timeout = 3e4,
+    withCredentials = true,
+    getAuthToken,
+    onUnauthorized,
+    onServerError
+  } = options;
+  const instance = axios.create({
+    baseURL,
+    timeout,
+    withCredentials,
+    headers: {
+      "Content-Type": "application/json"
+    }
+  });
+  instance.interceptors.request.use(
+    (config) => {
+      if (getAuthToken) {
+        const token = getAuthToken();
+        if (token && config.headers) {
+          config.headers.Authorization = `Bearer ${token}`;
+        }
+      }
+      return config;
+    },
+    (error) => Promise.reject(error)
+  );
+  instance.interceptors.response.use(
+    (response) => response,
+    (error) => {
+      if (error.response) {
+        const status = error.response.status;
+        if (status === 401 && onUnauthorized) {
+          onUnauthorized();
+        }
+        if (status >= 500 && onServerError) {
+          onServerError(error);
+        }
+      }
+      return Promise.reject(error);
+    }
+  );
+  return instance;
+};
+var withFormData = () => ({
+  headers: {
+    "Content-Type": "multipart/form-data"
+  }
+});
+var withTimeout = (ms) => ({
+  timeout: ms
+});
+var withAbortSignal = (signal) => ({
+  signal
+});
+
+// src/client/http/response-parser.ts
+var parseResponse = (response) => {
+  if (response.data?.success && response.data?.data !== void 0) {
+    return response.data.data;
+  }
+  return null;
+};
+var parseFullResponse = (response) => {
+  return response.data;
+};
+var parseError = (error) => {
+  if (error.response?.data?.message) {
+    return error.response.data.message;
+  }
+  if (error.response?.data?.error) {
+    return error.response.data.error;
+  }
+  if (error.code === "ERR_NETWORK") {
+    return "Network error. Please check your connection.";
+  }
+  if (error.code === "ECONNABORTED") {
+    return "Request timed out. Please try again.";
+  }
+  return error.message || "An unexpected error occurred.";
+};
+var isSuccess = (response) => {
+  return response.data?.success === true;
+};
+var isStatusError = (error, statusCode) => {
+  return error.response?.status === statusCode;
+};
+var isUnauthorized = (error) => {
+  return isStatusError(error, 401);
+};
+var isForbidden = (error) => {
+  return isStatusError(error, 403);
+};
+var isNotFound = (error) => {
+  return isStatusError(error, 404);
+};
+var isServerError = (error) => {
+  const status = error.response?.status;
+  return status !== void 0 && status >= 500;
+};
+
+export { createHttpClient, isForbidden, isNotFound, isServerError, isStatusError, isSuccess, isUnauthorized, parseError, parseFullResponse, parseResponse, withAbortSignal, withFormData, withTimeout };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map