@revealui/core 0.0.1-pre.0

package/dist/core/constants/UnifiedConstants.ts

@@ -0,0 +1,348 @@
+/**
+ * Unified Constants System
+ *
+ * Consolidates all constant definitions into a single system.
+ * Replaces duplicate constants across 50+ files.
+ */
+
+// ======
+// CACHE CONSTANTS
+// ======
+
+export const CACHE_DEFAULTS = {
+  TTL: 5 * 60 * 1000, // 5 minutes
+  MAX_SIZE: 1000,
+  CLEANUP_INTERVAL: 60 * 1000, // 1 minute
+  ENABLE_LRU: true,
+  ENABLE_HIT_TRACKING: true,
+} as const;
+
+export const CACHE_KEYS = {
+  USER: 'user',
+  SESSION: 'session',
+  POST: 'post',
+  CATEGORY: 'category',
+  PRODUCT: 'product',
+  ORDER: 'order',
+  SETTINGS: 'settings',
+  CONFIG: 'config',
+} as const;
+
+export const CACHE_TAGS = {
+  USER: 'user',
+  POST: 'post',
+  CATEGORY: 'category',
+  PRODUCT: 'product',
+  ORDER: 'order',
+  SETTINGS: 'settings',
+  CONFIG: 'config',
+} as const;
+
+// ======
+// RATE LIMITING CONSTANTS
+// ======
+
+export const RATE_LIMIT_DEFAULTS = {
+  WINDOW_MS: 15 * 60 * 1000, // 15 minutes
+  MAX_REQUESTS: 100,
+  CONTACT_FORM_LIMIT: 5,
+  LOGIN_ATTEMPTS: 5,
+  PASSWORD_RESET_LIMIT: 3,
+  API_LIMIT: 1000,
+} as const;
+
+export const RATE_LIMIT_KEYS = {
+  IP: 'ip',
+  USER: 'user',
+  ENDPOINT: 'endpoint',
+  GLOBAL: 'global',
+} as const;
+
+// ======
+// SECURITY CONSTANTS
+// ======
+
+export const SECURITY_ROLES = {
+  ADMIN: 'admin',
+  MODERATOR: 'moderator',
+  USER: 'user',
+  GUEST: 'guest',
+} as const;
+
+export const SECURITY_PERMISSIONS = {
+  READ: 'read',
+  WRITE: 'write',
+  DELETE: 'delete',
+  ADMIN: 'admin',
+  MODERATE: 'moderate',
+} as const;
+
+export const PASSWORD_REQUIREMENTS = {
+  MIN_LENGTH: 8,
+  MAX_LENGTH: 128,
+  REQUIRE_UPPERCASE: true,
+  REQUIRE_LOWERCASE: true,
+  REQUIRE_NUMBERS: true,
+  REQUIRE_SYMBOLS: true,
+  MAX_ATTEMPTS: 5,
+  LOCKOUT_DURATION: 15 * 60 * 1000, // 15 minutes
+} as const;
+
+export const SESSION_DEFAULTS = {
+  DURATION: 24 * 60 * 60 * 1000, // 24 hours
+  REFRESH_THRESHOLD: 60 * 60 * 1000, // 1 hour
+  MAX_CONCURRENT: 5,
+  CLEANUP_INTERVAL: 60 * 60 * 1000, // 1 hour
+} as const;
+
+// ======
+// HTTP STATUS CODES
+// ======
+
+export const HTTP_STATUS = {
+  OK: 200,
+  CREATED: 201,
+  ACCEPTED: 202,
+  NO_CONTENT: 204,
+  BAD_REQUEST: 400,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  NOT_FOUND: 404,
+  METHOD_NOT_ALLOWED: 405,
+  CONFLICT: 409,
+  UNPROCESSABLE_ENTITY: 422,
+  TOO_MANY_REQUESTS: 429,
+  INTERNAL_SERVER_ERROR: 500,
+  BAD_GATEWAY: 502,
+  SERVICE_UNAVAILABLE: 503,
+  GATEWAY_TIMEOUT: 504,
+} as const;
+
+// ======
+// VALIDATION LIMITS
+// ======
+
+export const VALIDATION_LIMITS = {
+  STRING: {
+    MIN_LENGTH: 1,
+    MAX_LENGTH: 1000,
+    EMAIL_MAX_LENGTH: 254,
+    USERNAME_MIN_LENGTH: 3,
+    USERNAME_MAX_LENGTH: 30,
+    PASSWORD_MIN_LENGTH: 8,
+    PASSWORD_MAX_LENGTH: 128,
+    BIO_MAX_LENGTH: 500,
+    TITLE_MAX_LENGTH: 200,
+    DESCRIPTION_MAX_LENGTH: 1000,
+  },
+  NUMBER: {
+    MIN: 0,
+    MAX: Number.MAX_SAFE_INTEGER,
+    PRICE_MIN: 0,
+    PRICE_MAX: 999999.99,
+    QUANTITY_MIN: 0,
+    QUANTITY_MAX: 9999,
+    RATING_MIN: 1,
+    RATING_MAX: 5,
+  },
+  ARRAY: {
+    MIN_LENGTH: 0,
+    MAX_LENGTH: 100,
+    TAGS_MAX_LENGTH: 10,
+    CATEGORIES_MAX_LENGTH: 5,
+    IMAGES_MAX_LENGTH: 10,
+  },
+  FILE: {
+    MAX_SIZE: 10 * 1024 * 1024, // 10MB
+    ALLOWED_TYPES: ['image/jpeg', 'image/png', 'image/gif', 'image/webp'],
+    MAX_DIMENSIONS: 4096,
+  },
+} as const;
+
+// ======
+// PAGINATION CONSTANTS
+// ======
+
+export const PAGINATION_DEFAULTS = {
+  PAGE: 1,
+  LIMIT: 20,
+  MAX_LIMIT: 100,
+  SORT_ORDER: 'desc' as const,
+  SORT_FIELD: 'createdAt',
+} as const;
+
+export const PAGINATION_LIMITS = {
+  MIN_PAGE: 1,
+  MAX_PAGE: 1000,
+  MIN_LIMIT: 1,
+  MAX_LIMIT: 100,
+} as const;
+
+// ======
+// DATE CONSTANTS
+// ======
+
+export const DATE_FORMATS = {
+  ISO: 'YYYY-MM-DDTHH:mm:ss.sssZ',
+  DATE: 'YYYY-MM-DD',
+  TIME: 'HH:mm:ss',
+  DATETIME: 'YYYY-MM-DD HH:mm:ss',
+  HUMAN: 'MMMM Do, YYYY',
+  SHORT: 'MMM Do, YYYY',
+} as const;
+
+export const DATE_RANGES = {
+  TODAY: 'today',
+  YESTERDAY: 'yesterday',
+  THIS_WEEK: 'this_week',
+  LAST_WEEK: 'last_week',
+  THIS_MONTH: 'this_month',
+  LAST_MONTH: 'last_month',
+  THIS_YEAR: 'this_year',
+  LAST_YEAR: 'last_year',
+} as const;
+
+// ======
+// EMAIL CONSTANTS
+// ======
+
+export const EMAIL_TEMPLATES = {
+  WELCOME: 'welcome',
+  PASSWORD_RESET: 'password_reset',
+  EMAIL_VERIFICATION: 'email_verification',
+  ORDER_CONFIRMATION: 'order_confirmation',
+  ORDER_SHIPPED: 'order_shipped',
+  ORDER_DELIVERED: 'order_delivered',
+  NEWSLETTER: 'newsletter',
+  NOTIFICATION: 'notification',
+} as const;
+
+export const EMAIL_PRIORITIES = {
+  LOW: 'low',
+  NORMAL: 'normal',
+  HIGH: 'high',
+  URGENT: 'urgent',
+} as const;
+
+// ======
+// NOTIFICATION CONSTANTS
+// ======
+
+export const NOTIFICATION_TYPES = {
+  INFO: 'info',
+  SUCCESS: 'success',
+  WARNING: 'warning',
+  ERROR: 'error',
+} as const;
+
+export const NOTIFICATION_CHANNELS = {
+  EMAIL: 'email',
+  PUSH: 'push',
+  SMS: 'sms',
+  IN_APP: 'in_app',
+} as const;
+
+// ======
+// FILE CONSTANTS
+// ======
+
+export const FILE_TYPES = {
+  IMAGE: 'image',
+  VIDEO: 'video',
+  AUDIO: 'audio',
+  DOCUMENT: 'document',
+  ARCHIVE: 'archive',
+  OTHER: 'other',
+} as const;
+
+export const FILE_EXTENSIONS = {
+  IMAGE: ['.jpg', '.jpeg', '.png', '.gif', '.webp', '.svg', '.bmp'],
+  VIDEO: ['.mp4', '.avi', '.mov', '.wmv', '.flv', '.webm'],
+  AUDIO: ['.mp3', '.wav', '.flac', '.aac', '.ogg'],
+  DOCUMENT: ['.pdf', '.doc', '.docx', '.txt', '.rtf'],
+  ARCHIVE: ['.zip', '.rar', '.7z', '.tar', '.gz'],
+} as const;
+
+// ======
+// API CONSTANTS
+// ======
+
+export const API_VERSIONS = {
+  V1: 'v1',
+  V2: 'v2',
+  LATEST: 'v2',
+} as const;
+
+export const API_ENDPOINTS = {
+  AUTH: '/auth',
+  USERS: '/users',
+  POSTS: '/posts',
+  PRODUCTS: '/products',
+  ORDERS: '/orders',
+  CART: '/cart',
+  CATEGORIES: '/categories',
+  TAGS: '/tags',
+  UPLOADS: '/uploads',
+  SEARCH: '/search',
+} as const;
+
+// ======
+// ERROR CODES
+// ======
+
+export const ERROR_CODES = {
+  VALIDATION_ERROR: 'VALIDATION_ERROR',
+  AUTHENTICATION_ERROR: 'AUTHENTICATION_ERROR',
+  AUTHORIZATION_ERROR: 'AUTHORIZATION_ERROR',
+  NOT_FOUND_ERROR: 'NOT_FOUND_ERROR',
+  CONFLICT_ERROR: 'CONFLICT_ERROR',
+  RATE_LIMIT_ERROR: 'RATE_LIMIT_ERROR',
+  INTERNAL_ERROR: 'INTERNAL_ERROR',
+  EXTERNAL_SERVICE_ERROR: 'EXTERNAL_SERVICE_ERROR',
+} as const;
+
+// ======
+// ENVIRONMENT CONSTANTS
+// ======
+
+export const ENVIRONMENTS = {
+  DEVELOPMENT: 'development',
+  STAGING: 'staging',
+  PRODUCTION: 'production',
+  TEST: 'test',
+} as const;
+
+export const LOG_LEVELS = {
+  ERROR: 'error',
+  WARN: 'warn',
+  INFO: 'info',
+  DEBUG: 'debug',
+} as const;
+
+// ======
+// BUSINESS CONSTANTS
+// ======
+
+export const BUSINESS_RULES = {
+  MAX_ORDERS_PER_DAY: 10,
+  MAX_CART_ITEMS: 50,
+  MAX_CART_VALUE: 10000,
+  MIN_ORDER_VALUE: 0,
+  MAX_REFUND_DAYS: 30,
+  MAX_RETURN_DAYS: 14,
+} as const;
+
+export const CURRENCY_DEFAULTS = {
+  CODE: 'USD',
+  SYMBOL: '$',
+  DECIMAL_PLACES: 2,
+  THOUSAND_SEPARATOR: ',',
+  DECIMAL_SEPARATOR: '.',
+} as const;
+
+// ======
+// EXPORTS
+// ======
+
+// All constants are exported directly above - no re-export needed
+

package/dist/core/dom/applyHeadSettings.tsx

@@ -0,0 +1,13 @@
+export { applyHeadSettings };
+
+type Value = string | null | undefined;
+
+// - We skip if `undefined` as we shouldn't remove values set by the Head setting.
+// - Setting a default prevents the previous value to be leaked: upon client-side navigation, the value set by the previous page won't be removed if the next page doesn't override it.
+//   - Most of the time, the user sets a default himself (i.e. a value defined at /pages/+config.js)
+//     - If he doesn't have a default then he can use `null` to opt into Reveal's defaults
+
+function applyHeadSettings(title: Value, lang: Value) {
+  if (title !== undefined) document.title = title || "";
+  if (lang !== undefined) document.documentElement.lang = lang || "en";
+}

package/dist/core/dom/onPageVisibilityChange.ts

@@ -0,0 +1,17 @@
+export { onPageHide };
+export { onPageShow };
+
+function onPageHide(listener: () => void) {
+  window.addEventListener("visibilitychange", () => {
+    if (document.visibilityState === "hidden") {
+      listener();
+    }
+  });
+}
+function onPageShow(listener: () => void) {
+  window.addEventListener("visibilitychange", () => {
+    if (document.visibilityState === "visible") {
+      listener();
+    }
+  });
+}

package/dist/core/dom/updateDocumentHead.ts

@@ -0,0 +1,15 @@
+const updateDocumentHead = (title = "", description = "") => {
+  if (typeof document !== "undefined") {
+    document.title = title;
+
+    const metaDescription = document.querySelector('meta[name="description"]');
+
+    if (metaDescription) {
+      metaDescription.setAttribute("content", description);
+    }
+
+    return document;
+  }
+};
+
+export default updateDocumentHead;