3a-ecommerce-utils 1.0.0

package/dist/validation/server.mjs

@@ -0,0 +1,168 @@
+import {
+  LogLevel,
+  batchValidate,
+  isValidCouponCode,
+  isValidEmail,
+  isValidObjectId,
+  isValidPassword,
+  isValidPhone,
+  isValidPostalCode,
+  isValidSku,
+  isValidUrl,
+  validateCouponCode,
+  validateDate,
+  validateDateRange,
+  validateDiscountPercentage,
+  validateEmail,
+  validateName,
+  validateObjectId,
+  validatePagination,
+  validatePassword,
+  validatePhone,
+  validatePostalCode,
+  validatePrice,
+  validateQuantity,
+  validateRating,
+  validateSku,
+  validateUrl
+} from "../chunk-PEAZVBSD.mjs";
+
+// src/validation/server.ts
+import { validationResult } from "express-validator";
+
+// src/api/logger.ts
+import fs from "fs";
+import path from "path";
+var LOG_LEVEL_PRIORITY = {
+  [LogLevel.DEBUG]: 0,
+  [LogLevel.INFO]: 1,
+  [LogLevel.WARN]: 2,
+  [LogLevel.ERROR]: 3
+};
+var Logger = class {
+  static configure(options) {
+    if (options.maxLogs !== void 0) this.maxLogs = options.maxLogs;
+    if (options.enableConsole !== void 0) this.enableConsole = options.enableConsole;
+    if (options.enableFile !== void 0) this.enableFile = options.enableFile;
+    if (options.logFilePath) this.logFilePath = options.logFilePath;
+    if (options.logLevel) {
+      const level = typeof options.logLevel === "string" ? options.logLevel.toUpperCase() : options.logLevel;
+      if (Object.values(LogLevel).includes(level)) {
+        this.logLevel = level;
+      }
+    }
+  }
+  static shouldLog(level) {
+    return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[this.logLevel];
+  }
+  static addLog(entry) {
+    this.logs.push(entry);
+    if (this.logs.length > this.maxLogs) this.logs.shift();
+    if (this.enableFile) {
+      fs.mkdirSync(path.dirname(this.logFilePath), { recursive: true });
+      fs.appendFileSync(this.logFilePath, JSON.stringify(entry) + "\n");
+    }
+  }
+  static format(entry) {
+    return `[${entry.timestamp}] [${entry.level}]${entry.context ? ` [${entry.context}]` : ""}: ${entry.message}`;
+  }
+  static debug(message, data, context) {
+    this.log(LogLevel.DEBUG, message, data, context);
+  }
+  static info(message, data, context) {
+    this.log(LogLevel.INFO, message, data, context);
+  }
+  static warn(message, data, context) {
+    this.log(LogLevel.WARN, message, data, context);
+  }
+  static error(message, error, context) {
+    this.log(LogLevel.ERROR, message, error, context);
+  }
+  static log(level, message, data, context) {
+    if (!this.shouldLog(level)) return;
+    const entry = {
+      level,
+      message,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      data,
+      context
+    };
+    this.addLog(entry);
+    if (!this.enableConsole) return;
+    const formatted = this.format(entry);
+    switch (level) {
+      case LogLevel.ERROR:
+        console.error(formatted, data ?? "");
+        break;
+      case LogLevel.WARN:
+        console.warn(formatted, data ?? "");
+        break;
+      case LogLevel.INFO:
+        console.info(formatted, data ?? "");
+        break;
+      default:
+        console.debug(formatted, data ?? "");
+    }
+  }
+  static getLogs(level) {
+    return level ? this.logs.filter((l) => l.level === level) : [...this.logs];
+  }
+  static clearLogs() {
+    this.logs = [];
+    if (this.enableFile && fs.existsSync(this.logFilePath)) {
+      fs.unlinkSync(this.logFilePath);
+    }
+  }
+};
+Logger.logs = [];
+Logger.maxLogs = 1e3;
+Logger.enableConsole = true;
+Logger.enableFile = false;
+Logger.logFilePath = path.join(process.cwd(), "logs/app.log");
+Logger.logLevel = LogLevel.DEBUG;
+
+// src/validation/server.ts
+var validate = (req, res, next) => {
+  const errors = validationResult(req);
+  if (!errors.isEmpty()) {
+    res.status(400).json({
+      success: false,
+      message: "Validation failed",
+      errors: errors.array().map((err) => ({
+        field: err.type === "field" ? err.path : void 0,
+        message: err.msg
+      }))
+    });
+    return;
+  }
+  next();
+};
+export {
+  Logger,
+  batchValidate,
+  isValidCouponCode,
+  isValidEmail,
+  isValidObjectId,
+  isValidPassword,
+  isValidPhone,
+  isValidPostalCode,
+  isValidSku,
+  isValidUrl,
+  validate,
+  validateCouponCode,
+  validateDate,
+  validateDateRange,
+  validateDiscountPercentage,
+  validateEmail,
+  validateName,
+  validateObjectId,
+  validatePagination,
+  validatePassword,
+  validatePhone,
+  validatePostalCode,
+  validatePrice,
+  validateQuantity,
+  validateRating,
+  validateSku,
+  validateUrl
+};

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "3a-ecommerce-utils",
+  "version": "1.0.0",
+  "description": "Utility functions for 3A Softwares E-Commerce",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/validation/server.d.ts",
+      "import": "./dist/validation/server.mjs",
+      "require": "./dist/validation/server.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/validation/server.ts --format cjs,esm --dts --clean --external 3a-ecommerce-types",
+    "prepublishOnly": "npm run build",
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "keywords": [
+    "ecommerce",
+    "utils",
+    "utilities",
+    "typescript",
+    "microservices"
+  ],
+  "author": "3aSoftwares",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/3asoftwares/E-Commerce-Microservices-Platform.git",
+    "directory": "packages/utils"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "3a-ecommerce-types": "^1.0.0"
+  },
+  "peerDependencies": {
+    "express": "^4.18.2",
+    "express-validator": "^7.0.1"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    },
+    "express-validator": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@vitest/coverage-v8": "^4.0.16",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16"
+  }
+}

package/src/api/address.queries.ts

@@ -0,0 +1,96 @@
+// Address Queries
+export const GET_MY_ADDRESSES_QUERY = `
+  query GetMyAddresses {
+    myAddresses {
+      addresses {
+        id
+        userId
+        street
+        city
+        state
+        zip
+        country
+        isDefault
+        label
+        createdAt
+        updatedAt
+      }
+    }
+  }
+`;
+
+// Address Mutations
+export const ADD_ADDRESS_MUTATION = `
+  mutation AddAddress($input: AddAddressInput!) {
+    addAddress(input: $input) {
+      success
+      message
+      address {
+        id
+        userId
+        street
+        city
+        state
+        zip
+        country
+        isDefault
+        label
+        createdAt
+        updatedAt
+      }
+    }
+  }
+`;
+
+export const UPDATE_ADDRESS_MUTATION = `
+  mutation UpdateAddress($id: ID!, $input: UpdateAddressInput!) {
+    updateAddress(id: $id, input: $input) {
+      success
+      message
+      address {
+        id
+        userId
+        street
+        city
+        state
+        zip
+        country
+        isDefault
+        label
+        createdAt
+        updatedAt
+      }
+    }
+  }
+`;
+
+export const DELETE_ADDRESS_MUTATION = `
+  mutation DeleteAddress($id: ID!) {
+    deleteAddress(id: $id) {
+      success
+      message
+    }
+  }
+`;
+
+export const SET_DEFAULT_ADDRESS_MUTATION = `
+  mutation SetDefaultAddress($id: ID!) {
+    setDefaultAddress(id: $id) {
+      success
+      message
+      address {
+        id
+        userId
+        street
+        city
+        state
+        zip
+        country
+        isDefault
+        label
+        createdAt
+        updatedAt
+      }
+    }
+  }
+`;

package/src/api/category.queries.ts

@@ -0,0 +1,85 @@
+export const GET_CATEGORIES_QUERY = `
+  query GetCategories($filter: CategoryFilterInput) {
+    categories(filter: $filter) {
+      success
+      message
+      data {
+        id
+        name
+        description
+        icon
+        slug
+        isActive
+        productCount
+        createdAt
+        updatedAt
+      }
+      count
+    }
+  }
+`;
+
+export const GET_CATEGORY_QUERY = `
+  query GetCategory($id: String!) {
+    category(id: $id) {
+      id
+      name
+      description
+      icon
+      slug
+      isActive
+      productCount
+      createdAt
+      updatedAt
+    }
+  }
+`;
+
+export const CREATE_CATEGORY_MUTATION = `
+  mutation CreateCategory($input: CategoryInput!) {
+    createCategory(input: $input) {
+      success
+      message
+      data {
+        id
+        name
+        description
+        icon
+        slug
+        isActive
+        productCount
+        createdAt
+        updatedAt
+      }
+    }
+  }
+`;
+
+export const UPDATE_CATEGORY_MUTATION = `
+  mutation UpdateCategory($id: ID!, $input: CategoryInput!) {
+    updateCategory(id: $id, input: $input) {
+      success
+      message
+      data {
+        id
+        name
+        description
+        icon
+        slug
+        isActive
+        productCount
+        createdAt
+        updatedAt
+      }
+    }
+  }
+`;
+
+export const DELETE_CATEGORY_MUTATION = `
+  mutation DeleteCategory($id: ID!) {
+    deleteCategory(id: $id) {
+      success
+      message
+    }
+  }
+`;

package/src/api/coupon.queries.ts

@@ -0,0 +1,120 @@
+export const GET_COUPONS_QUERY = `
+  query GetCoupons($page: Int, $limit: Int, $isActive: Boolean, $search: String) {
+    coupons(page: $page, limit: $limit, isActive: $isActive, search: $search) {
+      coupons {
+        id
+        code
+        description
+        discountType
+        discount
+        minPurchase
+        maxDiscount
+        validFrom
+        validTo
+        usageLimit
+        usageCount
+        isActive
+        createdAt
+        updatedAt
+      }
+      pagination {
+        page
+        limit
+        total
+        pages
+      }
+    }
+  }
+`;
+
+export const GET_COUPON_QUERY = `
+  query GetCoupon($id: ID!) {
+    coupon(id: $id) {
+      id
+      code
+      description
+      discountType
+      discount
+      minPurchase
+      maxDiscount
+      validFrom
+      validTo
+      usageLimit
+      usageCount
+      isActive
+      createdAt
+      updatedAt
+    }
+  }
+`;
+
+export const VALIDATE_COUPON_QUERY = `
+  query ValidateCoupon($code: String!, $orderTotal: Float!) {
+    validateCoupon(code: $code, orderTotal: $orderTotal) {
+      valid
+      discount
+      discountValue
+      finalTotal
+      discountType
+      message
+      code
+    }
+  }
+`;
+
+export const CREATE_COUPON_MUTATION = `
+  mutation CreateCoupon($input: CreateCouponInput!) {
+    createCoupon(input: $input) {
+      id
+      code
+      description
+      discountType
+      discount
+      minPurchase
+      maxDiscount
+      validFrom
+      validTo
+      usageLimit
+      usageCount
+      isActive
+      createdAt
+      updatedAt
+    }
+  }
+`;
+
+export const UPDATE_COUPON_MUTATION = `
+  mutation UpdateCoupon($id: ID!, $input: UpdateCouponInput!) {
+    updateCoupon(id: $id, input: $input) {
+      id
+      code
+      description
+      discountType
+      discount
+      minPurchase
+      maxDiscount
+      validFrom
+      validTo
+      usageLimit
+      usageCount
+      isActive
+      createdAt
+      updatedAt
+    }
+  }
+`;
+
+export const DELETE_COUPON_MUTATION = `
+  mutation DeleteCoupon($id: ID!) {
+    deleteCoupon(id: $id)
+  }
+`;
+
+export const TOGGLE_COUPON_STATUS_MUTATION = `
+  mutation ToggleCouponStatus($id: ID!) {
+    toggleCouponStatus(id: $id) {
+      id
+      isActive
+    }
+  }
+`;

package/src/api/dashboard.queries.ts

@@ -0,0 +1,35 @@
+export const DASHBOARD_STATS_QUERY = `
+  query GetDashboardStats {
+    dashboardStats {
+      totalUsers
+      totalOrders
+      totalRevenue
+      pendingOrders
+    }
+  }
+`;
+
+export const SALES_ANALYTICS_QUERY = `
+  query GetSalesAnalytics($period: String!) {
+    salesAnalytics(period: $period) {
+      daily {
+        date
+        sales
+        orders
+        revenue
+      }
+      weekly {
+        date
+        sales
+        orders
+        revenue
+      }
+      monthly {
+        date
+        sales
+        orders
+        revenue
+      }
+    }
+  }
+`;