3a-ecommerce-utils 1.0.0

package/src/api/product.queries.ts

@@ -0,0 +1,144 @@
+export const GET_PRODUCTS_QUERY = `
+  query GetProducts($page: Int, $limit: Int, $search: String, $category: String, $minPrice: Float, $maxPrice: Float, $sortBy: String, $sortOrder: String, $featured: Boolean, $includeInactive: Boolean) {
+    products(page: $page, limit: $limit, search: $search, category: $category, minPrice: $minPrice, maxPrice: $maxPrice, sortBy: $sortBy, sortOrder: $sortOrder, featured: $featured, includeInactive: $includeInactive) {
+      products {
+        id
+        name
+        description
+        price
+        stock
+        category
+        sellerId
+        isActive
+        imageUrl
+        tags
+        rating
+        reviewCount
+        createdAt
+        updatedAt
+      }
+      pagination {
+        page
+        limit
+        total
+        pages
+      }
+    }
+  }
+`;
+
+export const GET_PRODUCT_QUERY = `
+  query GetProduct($id: ID!) {
+    product(id: $id) {
+      id
+      name
+      description
+      price
+      stock
+      category
+      sellerId
+      seller {
+        id
+        name
+        email
+      }
+      isActive
+      imageUrl
+      tags
+      rating
+      reviewCount
+      createdAt
+      updatedAt
+    }
+  }
+`;
+
+export const GET_PRODUCTS_BY_SELLER_QUERY = `
+  query GetProductsBySeller($sellerId: String!) {
+    productsBySeller(sellerId: $sellerId) {
+      id
+      name
+      description
+      price
+      stock
+      category
+      sellerId
+      isActive
+      imageUrl
+      tags
+      rating
+      reviewCount
+      createdAt
+      updatedAt
+    }
+  }
+`;
+
+export const CREATE_PRODUCT_MUTATION = `
+  mutation CreateProduct($input: CreateProductInput!) {
+    createProduct(input: $input) {
+      id
+      name
+      description
+      price
+      stock
+      category
+      sellerId
+      isActive
+      imageUrl
+      tags
+      rating
+      reviewCount
+      createdAt
+      updatedAt
+    }
+  }
+`;
+
+export const UPDATE_PRODUCT_MUTATION = `
+  mutation UpdateProduct($id: ID!, $input: UpdateProductInput!) {
+    updateProduct(id: $id, input: $input) {
+      id
+      name
+      description
+      price
+      stock
+      category
+      sellerId
+      isActive
+      imageUrl
+      tags
+      rating
+      reviewCount
+      createdAt
+      updatedAt
+    }
+  }
+`;
+
+export const DELETE_PRODUCT_MUTATION = `
+  mutation DeleteProduct($id: ID!) {
+    deleteProduct(id: $id)
+  }
+`;
+
+export const SEARCH_PRODUCTS_QUERY = `
+  query SearchProducts($search: String!, $limit: Int) {
+    searchProducts(search: $search, limit: $limit) {
+      id
+      name
+      description
+      price
+      stock
+      category
+      sellerId
+      isActive
+      imageUrl
+      tags
+      rating
+      reviewCount
+      createdAt
+      updatedAt
+    }
+  }
+`;

package/src/api/review.queries.ts

@@ -0,0 +1,56 @@
+export const GET_PRODUCT_REVIEWS_QUERY = `
+  query GetProductReviews($productId: ID!, $page: Int, $limit: Int) {
+    productReviews(productId: $productId, page: $page, limit: $limit) {
+      reviews {
+        id
+        productId
+        userId
+        userName
+        rating
+        comment
+        helpful
+        createdAt
+      }
+      pagination {
+        page
+        limit
+        total
+        pages
+      }
+    }
+  }
+`;
+
+export const CREATE_REVIEW_MUTATION = `
+  mutation CreateReview($productId: ID!, $input: CreateReviewInput!) {
+    createReview(productId: $productId, input: $input) {
+      success
+      message
+      review {
+        id
+        productId
+        userId
+        userName
+        rating
+        comment
+        helpful
+        createdAt
+      }
+    }
+  }
+`;
+
+export const MARK_REVIEW_HELPFUL_MUTATION = `
+  mutation MarkReviewHelpful($reviewId: ID!) {
+    markReviewHelpful(reviewId: $reviewId) {
+      id
+      helpful
+    }
+  }
+`;
+
+export const DELETE_REVIEW_MUTATION = `
+  mutation DeleteReview($reviewId: ID!) {
+    deleteReview(reviewId: $reviewId)
+  }
+`;

package/src/api/user.queries.ts

@@ -0,0 +1,232 @@
+export const GET_USERS_QUERY = `
+  query GetUsers($page: Int, $limit: Int, $search: String, $role: String) {
+    users(page: $page, limit: $limit, search: $search, role: $role) {
+      users {
+        id
+        name
+        email
+        role
+        isActive
+        emailVerified
+        createdAt
+        lastLogin
+      }
+      pagination {
+        page
+        limit
+        total
+        pages
+        sellerCount
+        adminCount
+        customerCount
+      }
+    }
+  }
+`;
+
+export const GET_USER_QUERY = `
+  query GetUser($id: ID!) {
+    user(id: $id) {
+      id
+      name
+      email
+      role
+      isActive
+      emailVerified
+      createdAt
+      lastLogin
+    }
+  }
+`;
+
+export const GET_USER_BY_ID_QUERY = `
+  query GetUserById($id: ID!) {
+    getUserById(id: $id) {
+      user {
+        id
+        name
+        email
+        role
+        isActive
+        emailVerified
+        createdAt
+        lastLogin
+      }
+      accessToken
+      refreshToken
+      tokenExpiry
+    }
+  }
+`;
+
+export const GET_ME_QUERY = `
+  query GetMe {
+    me {
+      id
+      name
+      email
+      role
+      isActive
+      emailVerified
+      createdAt
+      lastLogin
+    }
+  }
+`;
+
+export const LOGIN_MUTATION = `
+  mutation Login($input: LoginInput!) {
+    login(input: $input) {
+      user {
+        id
+        name
+        email
+        role
+        isActive
+        emailVerified
+        createdAt
+      }
+      accessToken
+      refreshToken
+    }
+  }
+`;
+
+export const REGISTER_MUTATION = `
+  mutation Register($input: RegisterInput!) {
+    register(input: $input) {
+      user {
+        id
+        name
+        email
+        role
+        isActive
+        emailVerified
+        createdAt
+      }
+      accessToken
+      refreshToken
+    }
+  }
+`;
+
+export const GOOGLE_AUTH_MUTATION = `
+  mutation GoogleAuth($input: GoogleAuthInput!) {
+    googleAuth(input: $input) {
+      user {
+        id
+        name
+        email
+        role
+        isActive
+        emailVerified
+        createdAt
+        profilePicture
+      }
+      accessToken
+      refreshToken
+    }
+  }
+`;
+
+export const LOGOUT_MUTATION = `
+  mutation Logout {
+    logout
+  }
+`;
+
+export const UPDATE_USER_ROLE_MUTATION = `
+  mutation UpdateUserRole($id: ID!, $role: String!) {
+    updateUserRole(id: $id, role: $role) {
+      id
+      name
+      email
+      role
+      isActive
+      emailVerified
+      createdAt
+      lastLogin
+    }
+  }
+`;
+
+export const DELETE_USER_MUTATION = `
+  mutation DeleteUser($id: ID!) {
+    deleteUser(id: $id)
+  }
+`;
+
+export const SEND_VERIFICATION_EMAIL_MUTATION = `
+  mutation SendVerificationEmail($source: String) {
+    sendVerificationEmail(source: $source) {
+      success
+      message
+    }
+  }
+`;
+
+export const VERIFY_EMAIL_MUTATION = `
+  mutation VerifyEmail {
+    verifyEmail {
+      success
+      message
+      user {
+        id
+        name
+        email
+        role
+        isActive
+        emailVerified
+        createdAt
+      }
+    }
+  }
+`;
+
+export const FORGOT_PASSWORD_MUTATION = `
+  mutation ForgotPassword($email: String!, $role: String!) {
+    forgotPassword(email: $email, role: $role) {
+      success
+      message
+      resetToken
+      resetUrl
+    }
+  }
+`;
+
+export const RESET_PASSWORD_MUTATION = `
+  mutation ResetPassword($token: String!, $password: String!, $confirmPassword: String!) {
+    resetPassword(token: $token, password: $password, confirmPassword: $confirmPassword) {
+      success
+      message
+    }
+  }
+`;
+
+export const VALIDATE_RESET_TOKEN_QUERY = `
+  query ValidateResetToken($token: String!) {
+    validateResetToken(token: $token) {
+      success
+      message
+      email
+    }
+  }
+`;
+
+export const UPDATE_PROFILE_MUTATION = `
+  mutation UpdateProfile($input: UpdateProfileInput!) {
+    updateProfile(input: $input) {
+      success
+      message
+      user {
+        id
+        name
+        email
+        role
+        isActive
+        emailVerified
+        createdAt
+      }
+    }
+  }
+`;

package/src/assets/index.ts

@@ -0,0 +1 @@
+export {};

package/src/assets.d.ts

@@ -0,0 +1,29 @@
+declare module '*.png' {
+  const content: string;
+  export default content;
+}
+
+declare module '*.jpg' {
+  const content: string;
+  export default content;
+}
+
+declare module '*.jpeg' {
+  const content: string;
+  export default content;
+}
+
+declare module '*.svg' {
+  const content: string;
+  export default content;
+}
+
+declare module '*.gif' {
+  const content: string;
+  export default content;
+}
+
+declare module '*.webp' {
+  const content: string;
+  export default content;
+}

package/src/auth.ts

@@ -0,0 +1,176 @@
+import { SHELL_APP_URL } from './constants';
+import {
+  setCookie,
+  getCookie,
+  removeCookie,
+  AUTH_COOKIE_NAMES,
+} from './cookies';
+
+export interface AuthTokens {
+  accessToken: string;
+  refreshToken?: string;
+  expiresIn?: number;
+}
+
+export interface StoredAuth {
+  user: any;
+  token: string;
+  expiresIn: number;
+}
+
+// Cookie expiry in days
+const ACCESS_TOKEN_EXPIRY = 1; // 1 day
+const REFRESH_TOKEN_EXPIRY = 7; // 7 days
+
+export const storeAuth = (data: {
+  user: any;
+  accessToken: string;
+  refreshToken?: string;
+  expiresIn?: number;
+}) => {
+  // Store user data
+  setCookie(AUTH_COOKIE_NAMES.USER, JSON.stringify(data.user), {
+    expires: REFRESH_TOKEN_EXPIRY,
+  });
+
+  // Store access token
+  setCookie(AUTH_COOKIE_NAMES.ACCESS_TOKEN, data.accessToken, {
+    expires: ACCESS_TOKEN_EXPIRY,
+  });
+
+  // Store refresh token if provided
+  if (data.refreshToken) {
+    setCookie(AUTH_COOKIE_NAMES.REFRESH_TOKEN, data.refreshToken, {
+      expires: REFRESH_TOKEN_EXPIRY,
+    });
+  }
+
+  // Calculate and store token expiry time
+  const expiresIn = data.expiresIn || 3600;
+  const expiryTime = new Date().getTime() + expiresIn * 1000;
+  setCookie(AUTH_COOKIE_NAMES.TOKEN_EXPIRY, expiryTime.toString(), {
+    expires: ACCESS_TOKEN_EXPIRY,
+  });
+};
+
+export const getStoredAuth = (): StoredAuth | null => {
+  const userStr = getCookie(AUTH_COOKIE_NAMES.USER);
+  const token = getCookie(AUTH_COOKIE_NAMES.ACCESS_TOKEN);
+  const expiryStr = getCookie(AUTH_COOKIE_NAMES.TOKEN_EXPIRY);
+
+  if (!userStr || !token) {
+    return null;
+  }
+
+  try {
+    const user = JSON.parse(userStr);
+    const expiresIn = expiryStr ? parseInt(expiryStr) - new Date().getTime() : 0;
+
+    return {
+      user,
+      token,
+      expiresIn: Math.max(0, expiresIn),
+    };
+  } catch {
+    return null;
+  }
+};
+
+export const isTokenExpired = (): boolean => {
+  const tokenExpiry = getCookie(AUTH_COOKIE_NAMES.TOKEN_EXPIRY);
+
+  if (!tokenExpiry) {
+    return true;
+  }
+
+  const now = new Date().getTime();
+  return now > parseInt(tokenExpiry);
+};
+
+export const willTokenExpireSoon = (): boolean => {
+  const tokenExpiry = getCookie(AUTH_COOKIE_NAMES.TOKEN_EXPIRY);
+
+  if (!tokenExpiry) {
+    return true;
+  }
+
+  const now = new Date().getTime();
+  const expiryTime = parseInt(tokenExpiry);
+  const timeUntilExpiry = expiryTime - now;
+
+  return timeUntilExpiry < 300000;
+};
+
+export const clearAuth = () => {
+  removeCookie(AUTH_COOKIE_NAMES.USER);
+  removeCookie(AUTH_COOKIE_NAMES.ACCESS_TOKEN);
+  removeCookie(AUTH_COOKIE_NAMES.REFRESH_TOKEN);
+  removeCookie(AUTH_COOKIE_NAMES.TOKEN_EXPIRY);
+};
+
+export const validateUserRole = (requiredRole: string): boolean => {
+  const userStr = getCookie(AUTH_COOKIE_NAMES.USER);
+
+  if (!userStr) {
+    return false;
+  }
+
+  try {
+    const user = JSON.parse(userStr);
+    return user.role === requiredRole;
+  } catch {
+    return false;
+  }
+};
+
+export const getCurrentUser = () => {
+  const userStr = getCookie(AUTH_COOKIE_NAMES.USER);
+
+  if (!userStr) {
+    return null;
+  }
+
+  try {
+    return JSON.parse(userStr);
+  } catch {
+    return null;
+  }
+};
+
+export const getAccessToken = (): string | null => {
+  return getCookie(AUTH_COOKIE_NAMES.ACCESS_TOKEN);
+};
+
+export const getRefreshToken = (): string | null => {
+  return getCookie(AUTH_COOKIE_NAMES.REFRESH_TOKEN);
+};
+
+export const updateAccessToken = (newToken: string, expiresIn?: number) => {
+  setCookie(AUTH_COOKIE_NAMES.ACCESS_TOKEN, newToken, {
+    expires: ACCESS_TOKEN_EXPIRY,
+  });
+
+  if (expiresIn) {
+    const expiryTime = new Date().getTime() + expiresIn * 1000;
+    setCookie(AUTH_COOKIE_NAMES.TOKEN_EXPIRY, expiryTime.toString(), {
+      expires: ACCESS_TOKEN_EXPIRY,
+    });
+  }
+};
+
+export const setupAutoRefresh = (refreshFn: () => Promise<void>) => {
+  const checkAndRefresh = async () => {
+    if (willTokenExpireSoon() && !isTokenExpired()) {
+      try {
+        await refreshFn();
+      } catch (error) {
+        clearAuth();
+        window.location.href = SHELL_APP_URL;
+      }
+    }
+  };
+
+  const interval = setInterval(checkAndRefresh, 5 * 60 * 1000);
+
+  return () => clearInterval(interval);
+};

package/src/config/jest.backend.config.js

@@ -0,0 +1,42 @@
+/** 
+ * Base Jest configuration for backend Node.js services
+ * @type {import('jest').Config} 
+ */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src', '<rootDir>/tests'],
+  testMatch: ['**/*.test.ts', '**/*.spec.ts'],
+  transform: {
+    '^.+\\.tsx?$': [
+      'ts-jest',
+      {
+        tsconfig: 'tsconfig.json',
+      },
+    ],
+  },
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/swagger/**',
+    '!src/index.ts',
+  ],
+  coverageDirectory: 'coverage',
+  coverageReporters: ['text', 'lcov', 'html'],
+  coverageThreshold: {
+    global: {
+      branches: 60,
+      functions: 70,
+      lines: 70,
+      statements: 70,
+    },
+  },
+  setupFilesAfterEnv: ['<rootDir>/tests/setup.ts'],
+  testTimeout: 10000,
+  verbose: true,
+  moduleNameMapper: {
+    '^@e-commerce/utils/server$': '<rootDir>/tests/__mocks__/utils.ts',
+    '^@e-commerce/types$': '<rootDir>/../../packages/types/src/index.ts',
+  },
+};