@exyconn/common 2.3.3 → 2.3.5

package/dist/server/index.d.mts

@@ -3,7 +3,7 @@ export { StatusCode, StatusMessage, statusCode, statusMessage } from './enums/in
 export { LoggerConfig, createLogger, createMorganStream, logger, simpleLogger, stream } from './logger/index.mjs';
 export { DbConnectionOptions, connectDB, disconnectDB, getConnectionStatus } from './db/index.mjs';
 export { AuthRequest, BulkDeleteRequest, ColumnMeta, CrudConfig, JWTPayload, OrgRequest, PaginatedRequest, PaginatedResponse, PaginatedResult, PaginationMeta, ParsedQuery, SortConfig, SortOrder, authenticateApiKey, authenticateJWT, buildDeleteFilter, createBulkDeleteHandler, createCrudControllers, createPaginationMiddleware, extractOrganization, extractSchemaMeta, optionalAuthenticateJWT, parseBulkDelete, queryPagination, queryParser, requireOrganization } from './middleware/index.mjs';
-export { FilterOptions, PackageCheckResult, PackageJson, PackageVersion, PaginationOptions, PaginationResult, buildFilter, buildPagination, buildPaginationMeta, checkPackageServer, formatPackageCheckResult, generateNcuCommand, omitFields, packageCheckServer, pickFields, printPackageCheckSummary, sanitizeDocument, sanitizeUser } from './utils/index.mjs';
+export { FilterOptions, HealthConfig, HealthResponse, PackageCheckResult, PackageJson, PackageVersion, PaginationOptions, PaginationResult, buildFilter, buildPagination, buildPaginationMeta, checkPackageServer, createHealthHandler, createRootHandler, formatPackageCheckResult, generateHealthResponse, generateNcuCommand, omitFields, packageCheckServer, pickFields, printPackageCheckSummary, sanitizeDocument, sanitizeUser } from './utils/index.mjs';
 export { AppConfig, AuthConfig, ConfigBuilder, CorsConfig, CorsOriginsConfig, DEFAULT_AUTH_CONFIG, DEFAULT_CORS_CONFIG, DEFAULT_CORS_ORIGINS, DEFAULT_DATABASE_CONFIG, DEFAULT_LOGGING_CONFIG, DEFAULT_RATE_LIMIT_CONFIG, DEFAULT_RATE_LIMIT_TIERS, DEFAULT_SERVER_CONFIG, DatabaseConfig, EXYCONN_CORS_CONFIG, Environment, LogLevel, LoggingConfig, PERMISSIVE_CORS_CONFIG, RATE_LIMIT_CONFIG, RateLimitConfig, RateLimitResponse, RateLimitTier, RateLimitTierConfig, RateLimiterBuilder, RateLimiterConfig, STRICT_CORS_CONFIG, ServerConfig, buildConfig, corsOptions, createApiKeyGenerator, createApiRateLimiter, createBrandCorsOptions, createConfig, createCorsOptions, createDdosRateLimiter, createMultiBrandCorsOptions, createPrefixedKeyGenerator, createRateLimiter, createStandardRateLimiter, createStrictRateLimiter, createUserKeyGenerator, ddosProtectionLimiter, defaultKeyGenerator, getDatabaseOptions, isDevelopment, isProduction, isTest, rateLimiter, standardRateLimiter, strictRateLimiter } from './configs/index.mjs';
 import 'express';
 import 'winston';

package/dist/server/index.d.ts

@@ -3,7 +3,7 @@ export { StatusCode, StatusMessage, statusCode, statusMessage } from './enums/in
 export { LoggerConfig, createLogger, createMorganStream, logger, simpleLogger, stream } from './logger/index.js';
 export { DbConnectionOptions, connectDB, disconnectDB, getConnectionStatus } from './db/index.js';
 export { AuthRequest, BulkDeleteRequest, ColumnMeta, CrudConfig, JWTPayload, OrgRequest, PaginatedRequest, PaginatedResponse, PaginatedResult, PaginationMeta, ParsedQuery, SortConfig, SortOrder, authenticateApiKey, authenticateJWT, buildDeleteFilter, createBulkDeleteHandler, createCrudControllers, createPaginationMiddleware, extractOrganization, extractSchemaMeta, optionalAuthenticateJWT, parseBulkDelete, queryPagination, queryParser, requireOrganization } from './middleware/index.js';
-export { FilterOptions, PackageCheckResult, PackageJson, PackageVersion, PaginationOptions, PaginationResult, buildFilter, buildPagination, buildPaginationMeta, checkPackageServer, formatPackageCheckResult, generateNcuCommand, omitFields, packageCheckServer, pickFields, printPackageCheckSummary, sanitizeDocument, sanitizeUser } from './utils/index.js';
+export { FilterOptions, HealthConfig, HealthResponse, PackageCheckResult, PackageJson, PackageVersion, PaginationOptions, PaginationResult, buildFilter, buildPagination, buildPaginationMeta, checkPackageServer, createHealthHandler, createRootHandler, formatPackageCheckResult, generateHealthResponse, generateNcuCommand, omitFields, packageCheckServer, pickFields, printPackageCheckSummary, sanitizeDocument, sanitizeUser } from './utils/index.js';
 export { AppConfig, AuthConfig, ConfigBuilder, CorsConfig, CorsOriginsConfig, DEFAULT_AUTH_CONFIG, DEFAULT_CORS_CONFIG, DEFAULT_CORS_ORIGINS, DEFAULT_DATABASE_CONFIG, DEFAULT_LOGGING_CONFIG, DEFAULT_RATE_LIMIT_CONFIG, DEFAULT_RATE_LIMIT_TIERS, DEFAULT_SERVER_CONFIG, DatabaseConfig, EXYCONN_CORS_CONFIG, Environment, LogLevel, LoggingConfig, PERMISSIVE_CORS_CONFIG, RATE_LIMIT_CONFIG, RateLimitConfig, RateLimitResponse, RateLimitTier, RateLimitTierConfig, RateLimiterBuilder, RateLimiterConfig, STRICT_CORS_CONFIG, ServerConfig, buildConfig, corsOptions, createApiKeyGenerator, createApiRateLimiter, createBrandCorsOptions, createConfig, createCorsOptions, createDdosRateLimiter, createMultiBrandCorsOptions, createPrefixedKeyGenerator, createRateLimiter, createStandardRateLimiter, createStrictRateLimiter, createUserKeyGenerator, ddosProtectionLimiter, defaultKeyGenerator, getDatabaseOptions, isDevelopment, isProduction, isTest, rateLimiter, standardRateLimiter, strictRateLimiter } from './configs/index.js';
 import 'express';
 import 'winston';

package/dist/server/index.js

@@ -2,19 +2,22 @@
 
 var winston = require('winston');
 var DailyRotateFile = require('winston-daily-rotate-file');
-var path = require('path');
+var path2 = require('path');
 var mongoose = require('mongoose');
 var jwt = require('jsonwebtoken');
 var fs = require('fs');
+var os = require('os');
 var rateLimit = require('express-rate-limit');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var winston__default = /*#__PURE__*/_interopDefault(winston);
 var DailyRotateFile__default = /*#__PURE__*/_interopDefault(DailyRotateFile);
-var path__default = /*#__PURE__*/_interopDefault(path);
+var path2__default = /*#__PURE__*/_interopDefault(path2);
 var mongoose__default = /*#__PURE__*/_interopDefault(mongoose);
 var jwt__default = /*#__PURE__*/_interopDefault(jwt);
+var fs__default = /*#__PURE__*/_interopDefault(fs);
+var os__default = /*#__PURE__*/_interopDefault(os);
 var rateLimit__default = /*#__PURE__*/_interopDefault(rateLimit);
 
 // src/server/enums/status.ts
@@ -227,7 +230,7 @@ var createLogger = (config = {}) => {
     }),
     // Combined logs (all levels)
     new DailyRotateFile__default.default({
-      filename: path__default.default.join(finalConfig.logsDir, "combined-%DATE%.log"),
+      filename: path2__default.default.join(finalConfig.logsDir, "combined-%DATE%.log"),
       datePattern: "YYYY-MM-DD",
       maxSize: finalConfig.maxSize,
       maxFiles: finalConfig.maxFiles,
@@ -235,7 +238,7 @@ var createLogger = (config = {}) => {
     }),
     // Error logs only
     new DailyRotateFile__default.default({
-      filename: path__default.default.join(finalConfig.logsDir, "error-%DATE%.log"),
+      filename: path2__default.default.join(finalConfig.logsDir, "error-%DATE%.log"),
       datePattern: "YYYY-MM-DD",
       level: "error",
       maxSize: finalConfig.maxSize,
@@ -1190,7 +1193,7 @@ async function loadPackageJson(source) {
     }
     return response.json();
   }
-  const filePath = path.resolve(source);
+  const filePath = path2.resolve(source);
   if (!fs.existsSync(filePath)) {
     throw new Error(`File not found: ${filePath}`);
   }
@@ -1344,6 +1347,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__default.default.join(process.cwd(), "package.json"),
+      path2__default.default.join(__dirname, "..", "..", "..", "..", "package.json"),
+      path2__default.default.join(__dirname, "..", "..", "package.json")
+    ];
+    for (const pkgPath of possiblePaths) {
+      if (fs__default.default.existsSync(pkgPath)) {
+        const pkg = JSON.parse(fs__default.default.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__default.default.totalmem();
+  const freeMem = os__default.default.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__default.default.platform(),
+      arch: os__default.default.arch()
+    },
+    system: {
+      hostname: os__default.default.hostname(),
+      memoryUsedMB: Math.round(usedMem / 1024 / 1024),
+      memoryTotalMB: Math.round(totalMem / 1024 / 1024),
+      memoryFreePercent: Math.round(freeMem / totalMem * 100),
+      cpuLoad: os__default.default.loadavg().map((l) => Math.round(l * 100) / 100),
+      cpuCount: os__default.default.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 = {
@@ -2041,12 +2188,14 @@ exports.createConfig = createConfig;
 exports.createCorsOptions = createCorsOptions;
 exports.createCrudControllers = createCrudControllers;
 exports.createDdosRateLimiter = createDdosRateLimiter;
+exports.createHealthHandler = createHealthHandler;
 exports.createLogger = createLogger;
 exports.createMorganStream = createMorganStream;
 exports.createMultiBrandCorsOptions = createMultiBrandCorsOptions;
 exports.createPaginationMiddleware = createPaginationMiddleware;
 exports.createPrefixedKeyGenerator = createPrefixedKeyGenerator;
 exports.createRateLimiter = createRateLimiter;
+exports.createRootHandler = createRootHandler;
 exports.createStandardRateLimiter = createStandardRateLimiter;
 exports.createStrictRateLimiter = createStrictRateLimiter;
 exports.createUserKeyGenerator = createUserKeyGenerator;
@@ -2060,6 +2209,7 @@ exports.extractOrganization = extractOrganization;
 exports.extractSchemaMeta = extractSchemaMeta;
 exports.forbiddenResponse = forbiddenResponse;
 exports.formatPackageCheckResult = formatPackageCheckResult;
+exports.generateHealthResponse = generateHealthResponse;
 exports.generateNcuCommand = generateNcuCommand;
 exports.getConnectionStatus = getConnectionStatus;
 exports.getDatabaseOptions = getDatabaseOptions;