@exyconn/common 1.0.0 → 2.0.0

package/README.md

@@ -14,12 +14,14 @@ 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
+- 🖥️ **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
+- 📅 **Date utilities** - Enhanced date-fns with timezone support
+- 🎨 **Brand Identity** - Complete brand configs with logos, colors, and SEO
+- 🔢 **Enums & Constants** - STATUS, SORT, ROLE, BREAKPOINTS, and more
 
 ## Usage
 
@@ -128,13 +130,16 @@ import {
 ### Data Modules
 
 ```typescript
-// Countries with nested states/cities
+// Countries with nested states/cities + flags
 import { 
   countries, 
   getCountryByCode, 
   getStatesByCountry, 
   getCitiesByState,
-  searchCountries
+  searchCountries,
+  getFlag,
+  getAllCountriesWithFlags,
+  codeToFlag
 } from '@exyconn/common/data/countries';
 
 // Currencies
@@ -156,12 +161,56 @@ import {
   getCommonTimezones
 } from '@exyconn/common/data/timezones';
 
-// Brand logos (all 5 companies)
+// Regex patterns
 import { 
-  brands, 
-  getBrandByName, 
-  getAllBrands 
-} from '@exyconn/common/data/logos';
+  REGEX,
+  EMAIL,
+  PASSWORD_STRONG,
+  PHONE_INTERNATIONAL,
+  UUID,
+  URL_STRICT
+} from '@exyconn/common/data/regex';
+
+// Brand Identity
+import {
+  BRANDS,
+  APPS,
+  getBrandById,
+  getBrandByDomain,
+  getThemedLogo,
+  createAppConfig
+} from '@exyconn/common/data/brand-identity';
+```
+
+### Enums & Constants
+
+```typescript
+import {
+  // Status enums
+  STATUS,
+  USER_STATUS,
+  ORDER_STATUS,
+  PAYMENT_STATUS,
+  TASK_STATUS,
+  
+  // Sort options
+  SORT,
+  SORT_DIRECTION,
+  
+  // Roles & permissions
+  ROLE,
+  PERMISSION_LEVEL,
+  
+  // UI constants
+  BREAKPOINTS,
+  MEDIA_QUERIES,
+  THEME,
+  
+  // Other
+  PRIORITY,
+  VISIBILITY,
+  NOTIFICATION_TYPE
+} from '@exyconn/common/shared/constants/enums';
 ```
 
 ## Data Module Details
@@ -170,6 +219,7 @@ import {
 - 50+ countries with full details
 - Nested states/cities for major countries
 - Includes phone codes, currencies, timezones
+- **NEW:** Emoji flags with `getFlag()` and `codeToFlag()` helpers
 
 ### Currencies
 - 100+ world currencies
@@ -185,14 +235,46 @@ import {
 - Common timezone presets
 - Search and filter functions
 
-### Brand Logos
-All 5 Exyconn company brands with light/dark mode support:
+### Regex Patterns
+100+ common regex patterns organized by category:
+- **Email** - Basic, RFC5322, common domains
+- **Password** - Weak to very strong
+- **Phone** - International, US, India, UK
+- **Postal** - ZIP, PIN, UK, Canada, Germany
+- **IDs** - UUID, MongoDB ObjectId, Aadhaar, PAN, SSN
+- **URL** - Basic, strict, domain, localhost
+- **Credit Card** - Visa, Mastercard, Amex, etc.
+- **Date/Time** - ISO, various formats
+- **Colors** - Hex, RGB, RGBA, HSL
+- **And more!**
+
+### Brand Identity
+Complete brand configuration for all 5 Exyconn projects:
+- **Logo variants:** light, dark, logoOnly, darkLogoOnly
+- **Colors:** primary, secondary, accent
+- **Contact:** support email, sales email
+- **Social links:** Twitter, LinkedIn, GitHub, etc.
+- **SEO config:** title, description, keywords
+
+Projects:
 - **botify.life** - AI/Bot platform
 - **exyconn.com** - Main Exyconn brand
 - **partywings.fun** - Event platform
 - **sibera.work** - Work management
 - **spentiva.com** - Finance platform
 
+### Enums & Breakpoints
+Comprehensive enums for consistent data handling:
+- **STATUS** - active, pending, approved, archived...
+- **USER_STATUS** - active, suspended, banned...
+- **ORDER_STATUS** - pending, confirmed, shipped...
+- **PAYMENT_STATUS** - pending, completed, refunded...
+- **TASK_STATUS** - todo, in_progress, done...
+- **SORT** - newest, oldest, alphabetical, popular...
+- **ROLE** - super_admin, admin, user, viewer...
+- **PRIORITY** - low, medium, high, critical
+- **BREAKPOINTS** - xs, sm, md, lg, xl, 2xl (Tailwind-compatible)
+
 ## React Hooks
 
 | Hook | Description |
@@ -230,28 +312,31 @@ All peer dependencies are optional - only install what you need:
 
 ```
 @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
+├── /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
+│   ├── /constants       # Enums, breakpoints, status codes
+│   └── /utils           # Date-time utilities
+└── /data                # Static data modules
+    ├── /countries       # Countries with states/cities/flags
+    ├── /currencies      # World currencies
+    ├── /phone-codes     # International phone codes
+    ├── /timezones       # Timezones
+    ├── /regex           # Common regex patterns
+    ├── /brand-identity  # Complete brand configs
+    └── /logos           # Brand logos (deprecated, use brand-identity)
 ```
 
 ## License

package/dist/client/index.d.mts

@@ -1,7 +1,7 @@
 export { ApiResponse, HttpClientOptions, PaginatedResponse, createHttpClient, isForbidden, isNotFound, isServerError, isStatusError, isSuccess, isUnauthorized, parseError, parseFullResponse, parseResponse, withAbortSignal, withFormData, withTimeout } from './http/index.mjs';
 export { ClientLogger, ClientLoggerConfig, LogLevel, clientLogger, createClientLogger } from './logger/index.mjs';
-export { ApiUrlBuilder, ApiUrlConfig, EventEmitter, addDays, appEvents, camelToKebab, capitalize, capitalizeWords, copyToClipboard, createApiEndpoints, createApiUrlBuilder, createEmptyPaginationMeta, createErrorResponse, createEventEmitter, createSuccessResponse, endOfDay, formatDate, formatDateForInput, formatDateTime, formatDateTimeForInput, formatRelativeTime, getErrorMessage, getNextPage, getPrevPage, getResponseData, hasData, hasMorePages, isClipboardAvailable, isErrorResponse, isFuture, isPast, isSuccessResponse, isToday, kebabToCamel, readFromClipboard, slugify, slugifyUnique, startOfDay, truncate, truncateWords, unslugify } from './utils/index.mjs';
-export { S as SetValue, m as SnackbarSeverity, n as SnackbarState, T as ThemeMode, k as UseCopyToClipboardReturn, U as UseLocalStorageOptions, l as UsePageTitleOptions, o as UseSnackbarReturn, W as WindowSize, b as useCopyToClipboard, a as useDebounce, d as useInterval, r as useIsDesktop, p as useIsMobile, s as useIsMobileOrTablet, q as useIsTablet, u as useLocalStorage, g as useMediaQuery, h as useOnClickOutside, c as usePageTitle, f as useSnackbar, e as useThemeDetector, j as useWindowSize } from '../index-Du0LLt9f.mjs';
+export { ApiUrlBuilder, ApiUrlConfig, EventEmitter, NpmRegistryResponse, PackageCheckResult, PackageJson, PackageVersion, addDays, appEvents, camelToKebab, capitalize, capitalizeWords, checkPackage, copyToClipboard, createApiEndpoints, createApiUrlBuilder, createEmptyPaginationMeta, createErrorResponse, createEventEmitter, createSuccessResponse, endOfDay, formatDate, formatDateForInput, formatDateTime, formatDateTimeForInput, formatPackageCheckResult, formatRelativeTime, generateNcuCommand, getErrorMessage, getNextPage, getPrevPage, getResponseData, hasData, hasMorePages, isClipboardAvailable, isErrorResponse, isFuture, isPast, isSuccessResponse, isToday, kebabToCamel, packageCheck, readFromClipboard, slugify, slugifyUnique, startOfDay, truncate, truncateWords, unslugify } from './utils/index.mjs';
+export { aC as BatteryState, aV as Dimensions, aG as GeolocationState, at as MousePosition, aD as NetworkState, a4 as ObjectStateUpdate, aB as OrientationState, aT as RenderInfo, aQ as ScriptStatus, aL as SetValue, aZ as SnackbarSeverity, a_ as SnackbarState, aK as ThemeMode, af as UseContinuousRetryOptions, ag as UseContinuousRetryReturn, aw as UseCopyToClipboardReturn, ad as UseCountdownOptions, ae as UseCountdownReturn, a2 as UseCounterOptions, a3 as UseCounterReturn, ak as UseDocumentTitleOptions, aO as UseFetchOptions, aP as UseFetchReturn, aH as UseGeolocationOptions, aI as UseGeolocationReturn, a7 as UseHistoryStateOptions, a6 as UseHistoryStateReturn, aq as UseHoverReturn, aE as UseIdleOptions, aF as UseIdleReturn, aX as UseIntersectionObserverOptions, aY as UseIntersectionObserverReturn, ao as UseKeyPressOptions, ap as UseKeyPressReturn, a9 as UseListReturn, aM as UseLocalStorageOptions, aU as UseLoggerOptions, ar as UseLongPressOptions, as as UseLongPressReturn, aa as UseMapReturn, aW as UseMeasureReturn, au as UseMouseOptions, av as UseMouseReturn, a5 as UseObjectStateReturn, an as UsePageLeaveOptions, al as UsePageTitleOptions, aJ as UsePreferredLanguageReturn, a8 as UseQueueReturn, aR as UseScriptOptions, aS as UseScriptReturn, aN as UseSessionStorageOptions, ab as UseSetReturn, a$ as UseSnackbarReturn, ac as UseTimeoutReturn, a1 as UseToggleReturn, am as UseVisibilityChangeReturn, aj as UseWindowScrollReturn, ai as WindowScrollPosition, ah as WindowSize, N as useBattery, G as useClickAway, r as useContinuousRetry, K as useCopyToClipboard, q as useCountdown, a as useCounter, k as useDebounce, b as useDefault, v as useDocumentTitle, D as useEventListener, x as useFavicon, V as useFetch, Q as useGeolocation, e as useHistoryState, F as useHover, P as useIdle, $ as useIntersectionObserver, n as useInterval, o as useIntervalWhen, B as useIsClient, az as useIsDesktop, C as useIsFirstRender, ax as useIsMobile, aA as useIsMobileOrTablet, ay as useIsTablet, E as useKeyPress, g as useList, T as useLocalStorage, A as useLockBodyScroll, Z as useLogger, I as useLongPress, h as useMap, _ as useMeasure, L as useMediaQuery, J as useMouse, O as useNetworkState, d as useObjectState, H as useOnClickOutside, M as useOrientation, z as usePageLeave, w as usePageTitle, R as usePreferredLanguage, c as usePrevious, f as useQueue, p as useRandomInterval, Y as useRenderCount, X as useRenderInfo, W as useScript, U as useSessionStorage, j as useSet, a0 as useSnackbar, S as useThemeDetector, l as useThrottle, m as useTimeout, u as useToggle, y as useVisibilityChange, t as useWindowScroll, s as useWindowSize } from '../index-CIUdLBjA.mjs';
 import 'axios';
 import '../response.types-D--UhLJq.mjs';
 import 'react';

package/dist/client/index.d.ts

@@ -1,7 +1,7 @@
 export { ApiResponse, HttpClientOptions, PaginatedResponse, createHttpClient, isForbidden, isNotFound, isServerError, isStatusError, isSuccess, isUnauthorized, parseError, parseFullResponse, parseResponse, withAbortSignal, withFormData, withTimeout } from './http/index.js';
 export { ClientLogger, ClientLoggerConfig, LogLevel, clientLogger, createClientLogger } from './logger/index.js';
-export { ApiUrlBuilder, ApiUrlConfig, EventEmitter, addDays, appEvents, camelToKebab, capitalize, capitalizeWords, copyToClipboard, createApiEndpoints, createApiUrlBuilder, createEmptyPaginationMeta, createErrorResponse, createEventEmitter, createSuccessResponse, endOfDay, formatDate, formatDateForInput, formatDateTime, formatDateTimeForInput, formatRelativeTime, getErrorMessage, getNextPage, getPrevPage, getResponseData, hasData, hasMorePages, isClipboardAvailable, isErrorResponse, isFuture, isPast, isSuccessResponse, isToday, kebabToCamel, readFromClipboard, slugify, slugifyUnique, startOfDay, truncate, truncateWords, unslugify } from './utils/index.js';
-export { S as SetValue, m as SnackbarSeverity, n as SnackbarState, T as ThemeMode, k as UseCopyToClipboardReturn, U as UseLocalStorageOptions, l as UsePageTitleOptions, o as UseSnackbarReturn, W as WindowSize, b as useCopyToClipboard, a as useDebounce, d as useInterval, r as useIsDesktop, p as useIsMobile, s as useIsMobileOrTablet, q as useIsTablet, u as useLocalStorage, g as useMediaQuery, h as useOnClickOutside, c as usePageTitle, f as useSnackbar, e as useThemeDetector, j as useWindowSize } from '../index-BNdT-2X4.js';
+export { ApiUrlBuilder, ApiUrlConfig, EventEmitter, NpmRegistryResponse, PackageCheckResult, PackageJson, PackageVersion, addDays, appEvents, camelToKebab, capitalize, capitalizeWords, checkPackage, copyToClipboard, createApiEndpoints, createApiUrlBuilder, createEmptyPaginationMeta, createErrorResponse, createEventEmitter, createSuccessResponse, endOfDay, formatDate, formatDateForInput, formatDateTime, formatDateTimeForInput, formatPackageCheckResult, formatRelativeTime, generateNcuCommand, getErrorMessage, getNextPage, getPrevPage, getResponseData, hasData, hasMorePages, isClipboardAvailable, isErrorResponse, isFuture, isPast, isSuccessResponse, isToday, kebabToCamel, packageCheck, readFromClipboard, slugify, slugifyUnique, startOfDay, truncate, truncateWords, unslugify } from './utils/index.js';
+export { aC as BatteryState, aV as Dimensions, aG as GeolocationState, at as MousePosition, aD as NetworkState, a4 as ObjectStateUpdate, aB as OrientationState, aT as RenderInfo, aQ as ScriptStatus, aL as SetValue, aZ as SnackbarSeverity, a_ as SnackbarState, aK as ThemeMode, af as UseContinuousRetryOptions, ag as UseContinuousRetryReturn, aw as UseCopyToClipboardReturn, ad as UseCountdownOptions, ae as UseCountdownReturn, a2 as UseCounterOptions, a3 as UseCounterReturn, ak as UseDocumentTitleOptions, aO as UseFetchOptions, aP as UseFetchReturn, aH as UseGeolocationOptions, aI as UseGeolocationReturn, a7 as UseHistoryStateOptions, a6 as UseHistoryStateReturn, aq as UseHoverReturn, aE as UseIdleOptions, aF as UseIdleReturn, aX as UseIntersectionObserverOptions, aY as UseIntersectionObserverReturn, ao as UseKeyPressOptions, ap as UseKeyPressReturn, a9 as UseListReturn, aM as UseLocalStorageOptions, aU as UseLoggerOptions, ar as UseLongPressOptions, as as UseLongPressReturn, aa as UseMapReturn, aW as UseMeasureReturn, au as UseMouseOptions, av as UseMouseReturn, a5 as UseObjectStateReturn, an as UsePageLeaveOptions, al as UsePageTitleOptions, aJ as UsePreferredLanguageReturn, a8 as UseQueueReturn, aR as UseScriptOptions, aS as UseScriptReturn, aN as UseSessionStorageOptions, ab as UseSetReturn, a$ as UseSnackbarReturn, ac as UseTimeoutReturn, a1 as UseToggleReturn, am as UseVisibilityChangeReturn, aj as UseWindowScrollReturn, ai as WindowScrollPosition, ah as WindowSize, N as useBattery, G as useClickAway, r as useContinuousRetry, K as useCopyToClipboard, q as useCountdown, a as useCounter, k as useDebounce, b as useDefault, v as useDocumentTitle, D as useEventListener, x as useFavicon, V as useFetch, Q as useGeolocation, e as useHistoryState, F as useHover, P as useIdle, $ as useIntersectionObserver, n as useInterval, o as useIntervalWhen, B as useIsClient, az as useIsDesktop, C as useIsFirstRender, ax as useIsMobile, aA as useIsMobileOrTablet, ay as useIsTablet, E as useKeyPress, g as useList, T as useLocalStorage, A as useLockBodyScroll, Z as useLogger, I as useLongPress, h as useMap, _ as useMeasure, L as useMediaQuery, J as useMouse, O as useNetworkState, d as useObjectState, H as useOnClickOutside, M as useOrientation, z as usePageLeave, w as usePageTitle, R as usePreferredLanguage, c as usePrevious, f as useQueue, p as useRandomInterval, Y as useRenderCount, X as useRenderInfo, W as useScript, U as useSessionStorage, j as useSet, a0 as useSnackbar, S as useThemeDetector, l as useThrottle, m as useTimeout, u as useToggle, y as useVisibilityChange, t as useWindowScroll, s as useWindowSize } from '../index-BLltj-zN.js';
 import 'axios';
 import '../response.types-D--UhLJq.js';
 import 'react';