@exyconn/common 2.3.4 → 2.3.6

package/dist/index.mjs

@@ -1,9 +1,10 @@
 import winston from 'winston';
 import DailyRotateFile from 'winston-daily-rotate-file';
-import path, { resolve } from 'path';
+import path2, { resolve } from 'path';
 import mongoose, { Types } from 'mongoose';
 import jwt from 'jsonwebtoken';
-import { existsSync, readFileSync } from 'fs';
+import fs, { existsSync, readFileSync } from 'fs';
+import os from 'os';
 import rateLimit from 'express-rate-limit';
 import axios from 'axios';
 import { createContext, useState, useCallback, useMemo, useRef, useEffect, useContext } from 'react';
@@ -58,12 +59,14 @@ __export(server_exports, {
   createCorsOptions: () => createCorsOptions,
   createCrudControllers: () => createCrudControllers,
   createDdosRateLimiter: () => createDdosRateLimiter,
+  createHealthHandler: () => createHealthHandler,
   createLogger: () => createLogger,
   createMorganStream: () => createMorganStream,
   createMultiBrandCorsOptions: () => createMultiBrandCorsOptions,
   createPaginationMiddleware: () => createPaginationMiddleware,
   createPrefixedKeyGenerator: () => createPrefixedKeyGenerator,
   createRateLimiter: () => createRateLimiter,
+  createRootHandler: () => createRootHandler,
   createStandardRateLimiter: () => createStandardRateLimiter,
   createStrictRateLimiter: () => createStrictRateLimiter,
   createUserKeyGenerator: () => createUserKeyGenerator,
@@ -77,6 +80,7 @@ __export(server_exports, {
   extractSchemaMeta: () => extractSchemaMeta,
   forbiddenResponse: () => forbiddenResponse,
   formatPackageCheckResult: () => formatPackageCheckResult,
+  generateHealthResponse: () => generateHealthResponse,
   generateNcuCommand: () => generateNcuCommand,
   getConnectionStatus: () => getConnectionStatus,
   getDatabaseOptions: () => getDatabaseOptions,
@@ -321,7 +325,7 @@ var createLogger = (config = {}) => {
     }),
     // Combined logs (all levels)
     new DailyRotateFile({
-      filename: path.join(finalConfig.logsDir, "combined-%DATE%.log"),
+      filename: path2.join(finalConfig.logsDir, "combined-%DATE%.log"),
       datePattern: "YYYY-MM-DD",
       maxSize: finalConfig.maxSize,
       maxFiles: finalConfig.maxFiles,
@@ -329,7 +333,7 @@ var createLogger = (config = {}) => {
     }),
     // Error logs only
     new DailyRotateFile({
-      filename: path.join(finalConfig.logsDir, "error-%DATE%.log"),
+      filename: path2.join(finalConfig.logsDir, "error-%DATE%.log"),
       datePattern: "YYYY-MM-DD",
       level: "error",
       maxSize: finalConfig.maxSize,
@@ -790,7 +794,7 @@ function createCrudControllers(config) {
   };
   const getById = async (req, res, _next) => {
     try {
-      const { id } = req.params;
+      const id = req.params.id;
       if (!id || !Types.ObjectId.isValid(id)) {
         badRequestResponse(res, "Invalid ID format");
         return;
@@ -865,7 +869,7 @@ function createCrudControllers(config) {
   };
   const update = async (req, res, _next) => {
     try {
-      const { id } = req.params;
+      const id = req.params.id;
       if (!id || !Types.ObjectId.isValid(id)) {
         badRequestResponse(res, "Invalid ID format");
         return;
@@ -909,7 +913,7 @@ function createCrudControllers(config) {
   };
   const deleteOne = async (req, res, _next) => {
     try {
-      const { id } = req.params;
+      const id = req.params.id;
       if (!id || !Types.ObjectId.isValid(id)) {
         badRequestResponse(res, "Invalid ID format");
         return;
@@ -1438,6 +1442,150 @@ var packageCheckServer = {
   generateNcuCommand,
   print: printPackageCheckSummary
 };
+var serverStartTime = Date.now();
+function getTimezoneOffset() {
+  const offset = (/* @__PURE__ */ new Date()).getTimezoneOffset();
+  const hours = Math.floor(Math.abs(offset) / 60);
+  const minutes = Math.abs(offset) % 60;
+  const sign = offset <= 0 ? "+" : "-";
+  return `${sign}${hours.toString().padStart(2, "0")}:${minutes.toString().padStart(2, "0")}`;
+}
+function getTimezoneName() {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone;
+  } catch {
+    return "UTC";
+  }
+}
+function getPackageInfo(criticalPackages = []) {
+  try {
+    const possiblePaths = [
+      path2.join(process.cwd(), "package.json"),
+      path2.join(__dirname, "..", "..", "..", "..", "package.json"),
+      path2.join(__dirname, "..", "..", "package.json")
+    ];
+    for (const pkgPath of possiblePaths) {
+      if (fs.existsSync(pkgPath)) {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+        const deps = pkg.dependencies || {};
+        const devDeps = pkg.devDependencies || {};
+        const total = Object.keys(deps).length + Object.keys(devDeps).length;
+        const critical = {};
+        for (const pkgName of criticalPackages) {
+          if (deps[pkgName]) {
+            critical[pkgName] = deps[pkgName].replace("^", "").replace("~", "");
+          }
+        }
+        return { total, critical };
+      }
+    }
+  } catch {
+  }
+  return { total: 0, critical: {} };
+}
+async function generateHealthResponse(config) {
+  const startTime = Date.now();
+  const now = /* @__PURE__ */ new Date();
+  let dependencies = {};
+  if (config.checkDependencies) {
+    try {
+      dependencies = await config.checkDependencies();
+    } catch {
+      dependencies = { error: "DOWN" };
+    }
+  }
+  const hasDownDep = Object.values(dependencies).includes("DOWN");
+  const status = hasDownDep ? "DEGRADED" : "UP";
+  const defaultCriticalPackages = ["express", "mongoose", "cors", "dotenv"];
+  const packageInfo = getPackageInfo(config.criticalPackages || defaultCriticalPackages);
+  const totalMem = os.totalmem();
+  const freeMem = os.freemem();
+  const usedMem = totalMem - freeMem;
+  const isProduction2 = process.env.NODE_ENV === "production";
+  const serverUrl = isProduction2 ? `https://${config.domain}` : `http://localhost:${config.port}`;
+  const response = {
+    status,
+    app: config.name,
+    env: process.env.NODE_ENV || "development",
+    version: config.version,
+    urls: {
+      ...config.uiUrl && { ui: config.uiUrl },
+      server: config.serverUrl || serverUrl,
+      health: `${config.serverUrl || serverUrl}/health`
+    },
+    time: {
+      serverTime: now.toISOString(),
+      timezone: getTimezoneName(),
+      offset: getTimezoneOffset(),
+      epoch: Math.floor(now.getTime() / 1e3)
+    },
+    uptimeSec: Math.floor((Date.now() - serverStartTime) / 1e3),
+    node: {
+      version: process.version,
+      platform: os.platform(),
+      arch: os.arch()
+    },
+    system: {
+      hostname: os.hostname(),
+      memoryUsedMB: Math.round(usedMem / 1024 / 1024),
+      memoryTotalMB: Math.round(totalMem / 1024 / 1024),
+      memoryFreePercent: Math.round(freeMem / totalMem * 100),
+      cpuLoad: os.loadavg().map((l) => Math.round(l * 100) / 100),
+      cpuCount: os.cpus().length
+    },
+    packages: {
+      appVersion: config.version,
+      totalDependencies: packageInfo.total,
+      critical: packageInfo.critical
+    },
+    dependencies,
+    ...config.infra && { infra: config.infra },
+    responseTimeMs: Date.now() - startTime
+  };
+  return response;
+}
+function createHealthHandler(config) {
+  return async (_req, res) => {
+    try {
+      const health = await generateHealthResponse(config);
+      const statusCode2 = health.status === "UP" ? 200 : health.status === "DEGRADED" ? 200 : 503;
+      res.status(statusCode2).json(health);
+    } catch (error) {
+      res.status(503).json({
+        status: "DOWN",
+        app: config.name,
+        env: process.env.NODE_ENV || "development",
+        version: config.version,
+        error: error instanceof Error ? error.message : "Unknown error",
+        time: {
+          serverTime: (/* @__PURE__ */ new Date()).toISOString(),
+          timezone: getTimezoneName(),
+          offset: getTimezoneOffset(),
+          epoch: Math.floor(Date.now() / 1e3)
+        }
+      });
+    }
+  };
+}
+function createRootHandler(config) {
+  return async (_req, res) => {
+    try {
+      const health = await generateHealthResponse(config);
+      res.json({
+        message: `Welcome to ${config.name}`,
+        description: config.description || `${config.name} API Server`,
+        ...config.endpoints && { endpoints: config.endpoints },
+        ...health
+      });
+    } catch (error) {
+      res.status(503).json({
+        status: "DOWN",
+        app: config.name,
+        error: error instanceof Error ? error.message : "Unknown error"
+      });
+    }
+  };
+}
 
 // src/server/configs/cors.config.ts
 var DEFAULT_CORS_CONFIG = {
@@ -1719,6 +1867,8 @@ var createApiRateLimiter = (config = {}, options = {}) => {
   });
 };
 var RateLimiterBuilder = class {
+  config;
+  options;
   constructor(preset = "STANDARD") {
     const presetConfig = DEFAULT_RATE_LIMIT_TIERS[preset];
     this.config = {
@@ -1920,6 +2070,7 @@ function deepMerge(target, source) {
   return result;
 }
 var ConfigBuilder = class {
+  config;
   constructor() {
     this.config = {
       server: { ...DEFAULT_SERVER_CONFIG },
@@ -2281,9 +2432,7 @@ __export(client_exports, {
 
 // src/client/http/logger.ts
 var Logger = class {
-  constructor() {
-    this.isDevelopment = typeof window !== "undefined" && window.location.hostname === "localhost";
-  }
+  isDevelopment = typeof window !== "undefined" && window.location.hostname === "localhost";
   /**
    * Log informational messages
    */
@@ -2496,9 +2645,9 @@ var parsePaginatedResponse = (response) => {
     return { items: [], total: 0, page: 1, limit: 10 };
   }
 };
-var extractNestedData = (response, path2, fallback = null) => {
+var extractNestedData = (response, path3, fallback = null) => {
   try {
-    const keys = path2.split(".");
+    const keys = path3.split(".");
     let current = response;
     for (const key of keys) {
       if (current && typeof current === "object" && key in current) {
@@ -2829,8 +2978,10 @@ var LOG_LEVELS = {
   error: 3
 };
 var ClientLogger = class {
+  config;
+  buffer = [];
+  flushTimer;
   constructor(config = {}) {
-    this.buffer = [];
     this.config = {
       enabled: config.enabled ?? process.env.NODE_ENV !== "production",
       minLevel: config.minLevel ?? "debug",
@@ -6632,11 +6783,11 @@ function getContrastColor(hex) {
 }
 function flattenToCssVars(obj, prefix = "--ec") {
   const result = {};
-  function flatten(current, path2 = []) {
+  function flatten(current, path3 = []) {
     for (const key in current) {
       if (Object.prototype.hasOwnProperty.call(current, key)) {
         const value = current[key];
-        const newPath = [...path2, key];
+        const newPath = [...path3, key];
         const varName = `${prefix}-${newPath.join("-")}`;
         if (value && typeof value === "object" && !Array.isArray(value)) {
           flatten(value, newPath);
@@ -6894,8 +7045,8 @@ function ThemeProvider({
   );
   return /* @__PURE__ */ jsx(ThemeContext.Provider, { value: contextValue, children });
 }
-function cssVar(path2, prefix = "--ec") {
-  return `var(${prefix}-${path2.replace(/\./g, "-")})`;
+function cssVar(path3, prefix = "--ec") {
+  return `var(${prefix}-${path3.replace(/\./g, "-")})`;
 }
 function useThemeValue(selector) {
   const { theme } = useTheme();