3a-ecommerce-utils 1.0.0

package/src/constants/index.ts

@@ -0,0 +1,312 @@
+
+export const SHELL_APP_URL = 'http://localhost:3000';
+export const ADMIN_APP_URL = 'http://localhost:3001';
+export const SELLER_APP_URL = 'http://localhost:3002';
+export const STOREFRONT_APP_URL = 'http://localhost:3003';
+
+// PORT CONFIGURATIONS
+// auth-3011, category-3012, coupon-3013, product-3014, order-3015, graphql-4000
+export const PORT_CONFIG = {
+  AUTH_SERVICE: 3011,
+  CATEGORY_SERVICE: 3012,
+  COUPON_SERVICE: 3013,
+  PRODUCT_SERVICE: 3014,
+  ORDER_SERVICE: 3015,
+  GRAPHQL_GATEWAY: 4000,
+  STOREFRONT_APP: 3000,
+  ADMIN_APP: 3001,
+  SELLER_APP: 3002,
+  SHELL_APP: 3003,
+};
+
+// SERVICE URLS
+export const SERVICE_URLS = {
+  AUTH_SERVICE: `http://localhost:${PORT_CONFIG.AUTH_SERVICE}`,
+  CATEGORY_SERVICE: `http://localhost:${PORT_CONFIG.CATEGORY_SERVICE}`,
+  COUPON_SERVICE: `http://localhost:${PORT_CONFIG.COUPON_SERVICE}`,
+  PRODUCT_SERVICE: `http://localhost:${PORT_CONFIG.PRODUCT_SERVICE}`,
+  ORDER_SERVICE: `http://localhost:${PORT_CONFIG.ORDER_SERVICE}`,
+  GRAPHQL_GATEWAY: `http://localhost:${PORT_CONFIG.GRAPHQL_GATEWAY}/graphql`,
+  AUTH_API: `http://localhost:${PORT_CONFIG.AUTH_SERVICE}/api`,
+  CATEGORY_API: `http://localhost:${PORT_CONFIG.CATEGORY_SERVICE}/api`,
+  COUPON_API: `http://localhost:${PORT_CONFIG.COUPON_SERVICE}/api`,
+  PRODUCT_API: `http://localhost:${PORT_CONFIG.PRODUCT_SERVICE}/api`,
+  ORDER_API: `http://localhost:${PORT_CONFIG.ORDER_SERVICE}/api`,
+};
+
+// DATABASE CONFIGURATION
+export const DATABASE_CONFIG = {
+  MONGODB_URI: 'mongodb+srv://admin:admin@cluster0.wei5wdz.mongodb.net/ecommerce?appName=Cluster0',
+  REDIS_URL: 'redis://localhost:6379',
+};
+
+// CORS ALLOWED ORIGINS
+export const DEFAULT_CORS_ORIGINS = [
+  'http://localhost:3000',
+  'http://localhost:3001',
+  'http://localhost:3002',
+  'http://localhost:3003',
+];
+
+// JWT & AUTH CONFIGURATION
+export const JWT_CONFIG = {
+  ACCESS_TOKEN_EXPIRY: '1h',
+  REFRESH_TOKEN_EXPIRY: '7d',
+  PASSWORD_MIN_LENGTH: 8,
+  PASSWORD_PATTERN: /^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&])[A-Za-z\d@$!%*?&]{8,}$/,
+};
+
+// PAGINATION CONFIGURATION
+export const PAGINATION = {
+  DEFAULT_PAGE: 1,
+  DEFAULT_LIMIT: 10,
+  DEFAULT_PAGE_SIZE: 20,
+  MAX_PAGE_SIZE: 100,
+  MIN_PAGE_SIZE: 1,
+  DEFAULT_SORT_BY: 'createdAt',
+  DEFAULT_SORT_ORDER: 'DESC' as const,
+};
+
+// PRODUCT CONFIGURATION
+export const PRODUCT_CONFIG = {
+  MIN_PRICE: 0,
+  MAX_PRICE: 999999.99,
+  MIN_STOCK: 0,
+  MAX_RATING: 5,
+  MIN_RATING: 0,
+  DEFAULT_RATING: 0,
+  MAX_IMAGE_SIZE: 5 * 1024 * 1024, // 5MB
+  ALLOWED_IMAGE_TYPES: ['image/jpeg', 'image/png', 'image/webp'],
+};
+
+// ORDER CONFIGURATION
+export const ORDER_CONFIG = {
+  TAX_RATE: 0.1, // 10% tax
+  SHIPPING_COST_STANDARD: 50,
+  SHIPPING_COST_EXPRESS: 150,
+  SHIPPING_COST_OVERNIGHT: 300,
+  MIN_ORDER_AMOUNT: 0,
+  MAX_ORDER_ITEMS: 1000,
+};
+
+// COUPON CONFIGURATION
+export const COUPON_CONFIG = {
+  CODE_LENGTH: 6,
+  CODE_UPPERCASE: true,
+  MAX_DISCOUNT_PERCENTAGE: 100,
+  MAX_DISCOUNT_FIXED: 999999.99,
+  MIN_PURCHASE_REQUIRED: 0,
+};
+
+// API ENDPOINTS (PATHS)
+export const API_ENDPOINTS = {
+  AUTH: {
+    LOGIN: '/api/auth/login',
+    REGISTER: '/api/auth/register',
+    LOGOUT: '/api/auth/logout',
+    PROFILE: '/api/auth/profile',
+    REFRESH: '/api/auth/refresh',
+    VERIFY: '/api/auth/verify',
+  },
+  PRODUCTS: {
+    LIST: '/api/products',
+    CREATE: '/api/products',
+    GET: '/api/products/:id',
+    UPDATE: '/api/products/:id',
+    DELETE: '/api/products/:id',
+    SEARCH: '/api/products/search',
+  },
+  ORDERS: {
+    LIST: '/api/orders',
+    CREATE: '/api/orders',
+    GET: '/api/orders/:id',
+    UPDATE: '/api/orders/:id',
+    CANCEL: '/api/orders/:id/cancel',
+    TRACK: '/api/orders/:id/track',
+  },
+  CATEGORIES: {
+    LIST: '/api/categories',
+    CREATE: '/api/categories',
+    GET: '/api/categories/:id',
+    UPDATE: '/api/categories/:id',
+    DELETE: '/api/categories/:id',
+  },
+  COUPONS: {
+    LIST: '/api/coupons',
+    CREATE: '/api/coupons',
+    GET: '/api/coupons/:id',
+    UPDATE: '/api/coupons/:id',
+    DELETE: '/api/coupons/:id',
+    VALIDATE: '/api/coupons/validate/:code',
+  },
+};
+
+// HTTP STATUS CODES
+export const HTTP_STATUS = {
+  OK: 200,
+  CREATED: 201,
+  NO_CONTENT: 204,
+  BAD_REQUEST: 400,
+  UNAUTHORIZED: 401,
+  FORBIDDEN: 403,
+  NOT_FOUND: 404,
+  CONFLICT: 409,
+  UNPROCESSABLE_ENTITY: 422,
+  INTERNAL_SERVER_ERROR: 500,
+  SERVICE_UNAVAILABLE: 503,
+};
+
+// ERROR MESSAGES
+export const ERROR_MESSAGES = {
+  // Auth errors
+  UNAUTHORIZED: 'Unauthorized access',
+  FORBIDDEN: 'Forbidden access',
+  NO_TOKEN: 'No token provided. Access denied.',
+  INVALID_TOKEN: 'Invalid or expired token',
+  INVALID_CREDENTIALS: 'Invalid email or password',
+  USER_EXISTS: 'User with this email already exists',
+  USER_NOT_FOUND: 'User not found',
+  ACCOUNT_DEACTIVATED: 'Account is deactivated. Please contact support.',
+  EMAIL_PASSWORD_MISMATCH: 'Email and password does not match.',
+
+  // General errors
+  NOT_FOUND: 'Resource not found',
+  VALIDATION_FAILED: 'Validation failed',
+  INTERNAL_ERROR: 'Internal server error',
+  SERVICE_UNAVAILABLE: 'Service temporarily unavailable',
+  FAILED_TO_FETCH: 'Failed to fetch data',
+
+  // Product errors
+  PRODUCT_NOT_FOUND: 'Product not found',
+  INSUFFICIENT_STOCK: 'Insufficient stock available',
+  FAILED_TO_GET_PRODUCTS: 'Failed to get products',
+  FAILED_TO_CREATE_PRODUCT: 'Failed to create product',
+  FAILED_TO_UPDATE_PRODUCT: 'Failed to update product',
+  FAILED_TO_DELETE_PRODUCT: 'Failed to delete product',
+
+  // Category errors
+  CATEGORY_NOT_FOUND: 'Category not found',
+  FAILED_TO_GET_CATEGORIES: 'Failed to get categories',
+  FAILED_TO_CREATE_CATEGORY: 'Failed to create category',
+  FAILED_TO_UPDATE_CATEGORY: 'Failed to update category',
+  FAILED_TO_DELETE_CATEGORY: 'Failed to delete category',
+
+  // Order errors
+  ORDER_NOT_FOUND: 'Order not found',
+  INVALID_ORDER_STATUS: 'Invalid order status',
+  FAILED_TO_GET_ORDERS: 'Failed to get orders',
+  FAILED_TO_CREATE_ORDER: 'Failed to create order',
+  FAILED_TO_UPDATE_ORDER: 'Failed to update order',
+
+  // Coupon errors
+  INVALID_COUPON: 'Invalid or expired coupon',
+  COUPON_NOT_FOUND: 'Coupon not found',
+  COUPON_EXPIRED: 'Coupon has expired',
+  COUPON_LIMIT_REACHED: 'Coupon usage limit reached',
+  FAILED_TO_GET_COUPONS: 'Failed to get coupons',
+  FAILED_TO_CREATE_COUPON: 'Failed to create coupon',
+  FAILED_TO_UPDATE_COUPON: 'Failed to update coupon',
+  FAILED_TO_DELETE_COUPON: 'Failed to delete coupon',
+
+  // Review errors
+  REVIEW_NOT_FOUND: 'Review not found',
+  DUPLICATE_REVIEW: 'You have already reviewed this product',
+  OWN_REVIEW_ONLY: 'You can only delete your own reviews',
+  FAILED_TO_GET_REVIEWS: 'Failed to get reviews',
+  FAILED_TO_CREATE_REVIEW: 'Failed to create review',
+  FAILED_TO_DELETE_REVIEW: 'Failed to delete review',
+
+  // Address errors
+  ADDRESS_NOT_FOUND: 'Address not found',
+  FAILED_TO_GET_ADDRESSES: 'Failed to get addresses',
+};
+
+// SUCCESS MESSAGES
+export const SUCCESS_MESSAGES = {
+  // General
+  CREATED: 'Resource created successfully',
+  UPDATED: 'Resource updated successfully',
+  DELETED: 'Resource deleted successfully',
+  FETCHED: 'Data fetched successfully',
+
+  // Auth
+  USER_REGISTERED: 'User registered successfully',
+  LOGIN_SUCCESS: 'Login successful',
+  LOGOUT_SUCCESS: 'Logout successful',
+  PROFILE_UPDATED: 'Profile updated successfully',
+  PASSWORD_CHANGED: 'Password changed successfully',
+
+  // Product
+  PRODUCT_CREATED: 'Product created successfully',
+  PRODUCT_UPDATED: 'Product updated successfully',
+  PRODUCT_DELETED: 'Product deleted successfully',
+
+  // Category
+  CATEGORY_CREATED: 'Category created successfully',
+  CATEGORY_UPDATED: 'Category updated successfully',
+  CATEGORY_DELETED: 'Category deleted successfully',
+
+  // Order
+  ORDER_PLACED: 'Order placed successfully',
+  ORDER_UPDATED: 'Order updated successfully',
+  ORDER_CANCELLED: 'Order cancelled successfully',
+
+  // Coupon
+  COUPON_CREATED: 'Coupon created successfully',
+  COUPON_UPDATED: 'Coupon updated successfully',
+  COUPON_DELETED: 'Coupon deleted successfully',
+  COUPON_APPLIED: 'Coupon applied successfully',
+
+  // Review
+  REVIEW_SUBMITTED: 'Review submitted successfully',
+  REVIEW_DELETED: 'Review deleted successfully',
+
+  // Payment
+  PAYMENT_SUCCESSFUL: 'Payment processed successfully',
+};
+
+// CACHE CONFIGURATION
+export const CACHE_CONFIG = {
+  DASHBOARD_STATS_TTL: 30000, // 30 seconds
+  DASHBOARD_STATS_REFETCH: 60000, // 1 minute
+  PRODUCTS_TTL: 60000, // 1 minute
+  CATEGORIES_TTL: 120000, // 2 minutes
+  USER_PROFILE_TTL: 300000, // 5 minutes
+  ORDERS_TTL: 30000, // 30 seconds
+};
+
+// TIMEOUT CONFIGURATION (milliseconds)
+export const TIMEOUT_CONFIG = {
+  API_REQUEST: 30000, // 30 seconds
+  DATABASE: 10000, // 10 seconds
+  GRAPHQL: 15000, // 15 seconds
+};
+
+// REGEX PATTERNS (for validation)
+export const REGEX_PATTERNS = {
+  EMAIL: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
+  PHONE: /^[\d\-\s()]{10,}$/,
+  POSTAL_CODE: /^\d{5,6}$/,
+  COUPON_CODE: /^[A-Z0-9]{6,20}$/,
+  PRODUCT_SKU: /^[A-Z0-9\-]{3,20}$/,
+  URL: /^(https?:\/\/)?([\da-z.-]+)\.([a-z.]{2,6})([/\w.-]*)*\/?$/,
+};
+
+// ENVIRONMENT PRESETS
+export const ENV_PRESETS = {
+  DEVELOPMENT: {
+    corsOrigins: DEFAULT_CORS_ORIGINS,
+    logLevel: 'debug',
+    apiTimeout: TIMEOUT_CONFIG.API_REQUEST,
+  },
+  PRODUCTION: {
+    corsOrigins: ['https://ecommerce.example.com', 'https://admin.ecommerce.example.com'],
+    logLevel: 'info',
+    apiTimeout: TIMEOUT_CONFIG.API_REQUEST,
+  },
+  TESTING: {
+    corsOrigins: ['http://localhost:*'],
+    logLevel: 'error',
+    apiTimeout: TIMEOUT_CONFIG.API_REQUEST,
+  },
+};

package/src/cookies.ts

@@ -0,0 +1,104 @@
+/**
+ * Cookie utility functions for secure authentication storage
+ */
+
+export interface CookieOptions {
+  expires?: number; // days
+  path?: string;
+  domain?: string;
+  secure?: boolean;
+  sameSite?: 'Strict' | 'Lax' | 'None';
+}
+
+const DEFAULT_OPTIONS: CookieOptions = {
+  path: '/',
+  secure: process.env.NODE_ENV === 'production',
+  sameSite: 'Lax',
+};
+
+/**
+ * Set a cookie with the given name, value, and options
+ */
+export const setCookie = (name: string, value: string, options: CookieOptions = {}): void => {
+  if (typeof document === 'undefined') return;
+
+  const opts = { ...DEFAULT_OPTIONS, ...options };
+  let cookieString = `${encodeURIComponent(name)}=${encodeURIComponent(value)}`;
+
+  if (opts.expires) {
+    const date = new Date();
+    date.setTime(date.getTime() + opts.expires * 24 * 60 * 60 * 1000);
+    cookieString += `; expires=${date.toUTCString()}`;
+  }
+
+  if (opts.path) {
+    cookieString += `; path=${opts.path}`;
+  }
+
+  if (opts.domain) {
+    cookieString += `; domain=${opts.domain}`;
+  }
+
+  if (opts.secure) {
+    cookieString += '; secure';
+  }
+
+  if (opts.sameSite) {
+    cookieString += `; samesite=${opts.sameSite}`;
+  }
+
+  document.cookie = cookieString;
+};
+
+/**
+ * Get a cookie value by name
+ */
+export const getCookie = (name: string): string | null => {
+  if (typeof document === 'undefined') return null;
+
+  const nameEQ = `${encodeURIComponent(name)}=`;
+  const cookies = document.cookie.split(';');
+
+  for (let cookie of cookies) {
+    cookie = cookie.trim();
+    if (cookie.indexOf(nameEQ) === 0) {
+      return decodeURIComponent(cookie.substring(nameEQ.length));
+    }
+  }
+
+  return null;
+};
+
+/**
+ * Remove a cookie by name
+ */
+export const removeCookie = (name: string, options: CookieOptions = {}): void => {
+  if (typeof document === 'undefined') return;
+
+  const opts = { ...DEFAULT_OPTIONS, ...options };
+  setCookie(name, '', { ...opts, expires: -1 });
+};
+
+/**
+ * Check if cookies are enabled in the browser
+ */
+export const areCookiesEnabled = (): boolean => {
+  if (typeof document === 'undefined') return false;
+
+  try {
+    document.cookie = 'cookietest=1';
+    const result = document.cookie.indexOf('cookietest=') !== -1;
+    document.cookie = 'cookietest=1; expires=Thu, 01-Jan-1970 00:00:01 GMT';
+    return result;
+  } catch {
+    return false;
+  }
+};
+
+// Cookie names for auth data
+export const AUTH_COOKIE_NAMES = {
+  ACCESS_TOKEN: 'accessToken',
+  REFRESH_TOKEN: 'refreshToken',
+  TOKEN_EXPIRY: 'tokenExpiry',
+  USER: 'user',
+} as const;