elseware-nodejs 1.11.0 → 1.11.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 elseware Technology
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1 +1,50 @@
 # elseware-nodejs
+
+A modern Node.js utility and application framework powering the Elseware ecosystem.
+
+`elseware-nodejs` provides a collection of reusable components, utilities, middleware, abstractions, and development patterns for building scalable Node.js applications and microservices.
+
+## Features
+
+- TypeScript-first development
+- Express.js integration
+- Repository pattern abstractions
+- Service layer architecture
+- Request context management
+- Structured error handling
+- Validation utilities
+- Logging and observability support
+- Microservice-friendly design
+- Reusable application building blocks
+
+## Installation
+
+```bash
+npm install elseware-nodejs
+```
+
+## Usage
+
+```ts
+import { AppError } from "elseware-nodejs";
+
+throw new AppError("Something went wrong");
+```
+
+## Documentation
+
+Documentation, guides, and usage examples are available in the official repository.
+
+## About elseware Technology
+
+elseware Technology builds tools, frameworks, and solutions for software engineering, cloud computing, game development, and developer productivity.
+
+## Contributing
+
+Contributions, issues, and feature requests are welcome.
+
+## License
+
+This project is licensed under the MIT License.
+
+Copyright © 2026 elseware Technology.

package/dist/index.cjs

@@ -1,6 +1,5 @@
 'use strict';
 
-var dotenv = require('dotenv');
 var mongoose = require('mongoose');
 var crypto = require('crypto');
 var async_hooks = require('async_hooks');
@@ -16,7 +15,6 @@ var multer = require('multer');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
-var dotenv__default = /*#__PURE__*/_interopDefault(dotenv);
 var mongoose__default = /*#__PURE__*/_interopDefault(mongoose);
 var fs3__default = /*#__PURE__*/_interopDefault(fs3);
 var cloudinaryModule__default = /*#__PURE__*/_interopDefault(cloudinaryModule);
@@ -27,138 +25,6 @@ var juice__default = /*#__PURE__*/_interopDefault(juice);
 var jwt__default = /*#__PURE__*/_interopDefault(jwt);
 var multer__default = /*#__PURE__*/_interopDefault(multer);
 
-// src/configs/env.ts
-
-// src/utils/errorToString.ts
-function errorToString(error) {
-  if (error instanceof Error) {
-    return `${error.name}: ${error.message}
-${error.stack ?? ""}`;
-  }
-  if (typeof error === "object") {
-    try {
-      return JSON.stringify(error, null, 2);
-    } catch {
-      return "[Unserializable object]";
-    }
-  }
-  return String(error);
-}
-
-// src/configs/logger.ts
-var Logger = class {
-  timestamp = true;
-  enabled = true;
-  // Use to configure once at the root
-  configure(options = {}) {
-    this.timestamp = options.timestamp ?? this.timestamp;
-    this.enabled = options.enabled ?? this.enabled;
-  }
-  format(msg) {
-    if (!this.timestamp) return msg;
-    return `[${(/* @__PURE__ */ new Date()).toISOString()}] ${msg}`;
-  }
-  output(msg) {
-    if (!this.enabled) return;
-    console.log(this.format(msg));
-  }
-  // Log Levels
-  success(msg) {
-    this.output(`\u2705 ${msg}`);
-  }
-  info(msg) {
-    this.output(`\u{1F539} ${msg}`);
-  }
-  warning(msg) {
-    this.output(`\u26A0\uFE0F ${msg}`);
-  }
-  danger(message, error) {
-    if (error) {
-      this.output(`\u274C ${message}
-${errorToString(error)}`);
-    } else {
-      this.output(`\u274C ${message}`);
-    }
-  }
-  log(msg) {
-    this.output(`\u2022 ${msg}`);
-  }
-};
-var logger = new Logger();
-
-// src/configs/env.ts
-dotenv__default.default.config({ quiet: true });
-function loadEnv(options) {
-  const result = options.schema.safeParse(process.env);
-  if (!result.success) {
-    handleError(result.error);
-  }
-  logger.success("Env Configurations validated");
-  const env = result.data;
-  return options.transform ? options.transform(env) : env;
-}
-function handleError(error) {
-  logger.danger("Env validation failed");
-  const grouped = {};
-  error.issues.forEach((err) => {
-    const key = err.path.join(".") || "unknown";
-    const rawValue = key !== "unknown" ? process.env[key] : void 0;
-    const isSecret = key.toLowerCase().includes("secret");
-    const safeValue = isSecret ? "***" : rawValue;
-    const message = [
-      `message: ${err.message}`,
-      `code: ${err.code}`,
-      rawValue !== void 0 ? `value: ${JSON.stringify(safeValue)}` : null
-    ].filter(Boolean).join(" | ");
-    if (!grouped[key]) grouped[key] = [];
-    grouped[key].push(message);
-  });
-  Object.entries(grouped).forEach(([key, messages]) => {
-    logger.info(key);
-    messages.forEach((msg) => logger.log(`   - ${msg}`));
-  });
-  logger.danger("Application startup aborted!");
-  process.exit(1);
-}
-
-// src/configs/cors/allowedOrigins.ts
-function createAllowedOrigins(options = {}) {
-  const { origins, defaults = ["http://localhost:3000"] } = options;
-  let allowedOrigins = [];
-  if (typeof origins === "string") {
-    allowedOrigins = origins.split(",").map((origin) => origin.trim()).filter(Boolean);
-  }
-  if (Array.isArray(origins)) {
-    allowedOrigins = origins.map((origin) => origin.trim()).filter(Boolean);
-  }
-  if (allowedOrigins.length === 0) {
-    allowedOrigins = [...defaults];
-  }
-  return allowedOrigins;
-}
-
-// src/configs/cors/corsOptions.ts
-function createCorsOptions(allowedOrigins) {
-  return {
-    origin(origin, callback) {
-      if (!origin || allowedOrigins.includes(origin)) {
-        return callback(null, true);
-      }
-      return callback(new Error(`CORS blocked: ${origin} is not allowed`));
-    },
-    credentials: true,
-    methods: ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"],
-    allowedHeaders: [
-      "Content-Type",
-      "Authorization",
-      "X-Requested-With",
-      "Accept"
-    ],
-    exposedHeaders: ["Set-Cookie"],
-    optionsSuccessStatus: 204
-  };
-}
-
 // src/data-structures/array/CircularArray.ts
 var CircularArray = class {
   capacity;
@@ -4841,7 +4707,147 @@ var SegmentTree = class {
   }
 };
 
-// src/database/DatabaseManager.ts
+// src/core/constants/defaultOrigins.ts
+var DEFAULT_ALLOWED_ORIGINS = ["http://localhost:3000"];
+
+// src/infrastructure/cors/createAllowedOrigins.ts
+function createAllowedOrigins(options = {}) {
+  const { origins, defaults = DEFAULT_ALLOWED_ORIGINS } = options;
+  let allowedOrigins = [];
+  if (typeof origins === "string") {
+    allowedOrigins = origins.split(",").map((origin) => origin.trim()).filter(Boolean);
+  }
+  if (Array.isArray(origins)) {
+    allowedOrigins = origins.map((origin) => origin.trim()).filter(Boolean);
+  }
+  if (allowedOrigins.length === 0) {
+    allowedOrigins = [...defaults];
+  }
+  return allowedOrigins;
+}
+
+// src/infrastructure/cors/createCorsOptions.ts
+function createCorsOptions(allowedOrigins) {
+  return {
+    origin(origin, callback) {
+      if (!origin || allowedOrigins.includes(origin)) {
+        return callback(null, true);
+      }
+      return callback(new Error(`CORS blocked: ${origin} is not allowed`));
+    },
+    credentials: true,
+    methods: ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"],
+    allowedHeaders: [
+      "Content-Type",
+      "Authorization",
+      "X-Requested-With",
+      "Accept"
+    ],
+    exposedHeaders: ["Set-Cookie"],
+    optionsSuccessStatus: 204
+  };
+}
+
+// src/utils/errorToString.ts
+function errorToString(error) {
+  if (error instanceof Error) {
+    return `${error.name}: ${error.message}
+${error.stack ?? ""}`;
+  }
+  if (typeof error === "object") {
+    try {
+      return JSON.stringify(error, null, 2);
+    } catch {
+      return "[Unserializable object]";
+    }
+  }
+  return String(error);
+}
+
+// src/core/logger/colors.ts
+var colors = {
+  reset: "\x1B[0m",
+  blue: "\x1B[34m",
+  yellow: "\x1B[33m",
+  red: "\x1B[31m",
+  cyan: "\x1B[36m"
+};
+
+// src/core/logger/Logger.ts
+var Logger = class {
+  enabled = true;
+  timestamp = true;
+  colorsEnabled = true;
+  minimumLevel = "INFO" /* INFO */;
+  configure(options = {}) {
+    this.enabled = options.enabled ?? this.enabled;
+    this.timestamp = options.timestamp ?? this.timestamp;
+    this.colorsEnabled = options.colors ?? this.colorsEnabled;
+    this.minimumLevel = options.level ?? this.minimumLevel;
+  }
+  levelWeight(level) {
+    switch (level) {
+      case "DEBUG" /* DEBUG */:
+        return 10;
+      case "INFO" /* INFO */:
+        return 20;
+      case "WARN" /* WARN */:
+        return 30;
+      case "ERROR" /* ERROR */:
+        return 40;
+    }
+  }
+  shouldLog(level) {
+    return this.levelWeight(level) >= this.levelWeight(this.minimumLevel);
+  }
+  formatLevel(level) {
+    if (!this.colorsEnabled) {
+      return level;
+    }
+    switch (level) {
+      case "DEBUG" /* DEBUG */:
+        return `${colors.cyan}${level}${colors.reset}`;
+      case "INFO" /* INFO */:
+        return `${colors.blue}${level}${colors.reset}`;
+      case "WARN" /* WARN */:
+        return `${colors.yellow}${level}${colors.reset}`;
+      case "ERROR" /* ERROR */:
+        return `${colors.red}${level}${colors.reset}`;
+    }
+  }
+  write(level, message) {
+    if (!this.enabled) {
+      return;
+    }
+    if (!this.shouldLog(level)) {
+      return;
+    }
+    const timestamp = this.timestamp ? `[${(/* @__PURE__ */ new Date()).toISOString()}] ` : "";
+    console.log(`${timestamp}[${this.formatLevel(level)}] ${message}`);
+  }
+  debug(message) {
+    this.write("DEBUG" /* DEBUG */, message);
+  }
+  info(message) {
+    this.write("INFO" /* INFO */, message);
+  }
+  warn(message) {
+    this.write("WARN" /* WARN */, message);
+  }
+  error(message, error) {
+    if (error) {
+      this.write("ERROR" /* ERROR */, `${message}
+${errorToString(error)}`);
+      return;
+    }
+    this.write("ERROR" /* ERROR */, message);
+  }
+};
+
+// src/core/logger/index.ts
+var logger = new Logger();
+
+// src/infrastructure/database/DatabaseManager.ts
 var DatabaseManager = class {
   constructor(provider, options = {
     enableShutdownHooks: true
@@ -4852,21 +4858,21 @@ var DatabaseManager = class {
   async connect() {
     try {
       await this.provider.connect();
-      logger.success("Database connected successfully");
+      logger.info("Database connected");
       if (this.options.enableShutdownHooks) {
         this.registerShutdownHooks();
       }
     } catch (error) {
-      logger.danger("Database connection failed", error);
+      logger.error("Database connection failed", error);
       throw error;
     }
   }
   async disconnect() {
     try {
       await this.provider.disconnect();
-      logger.success("Database connection closed");
+      logger.info("Database disconnected");
     } catch (error) {
-      logger.danger("Database disconnect failed", error);
+      logger.error("Database disconnect failed", error);
       throw error;
     }
   }
@@ -4878,12 +4884,20 @@ var DatabaseManager = class {
   }
   registerShutdownHooks() {
     process.once("SIGINT", async () => {
-      await this.disconnect();
-      process.exit(0);
+      logger.info("SIGINT received, shutting down database connection");
+      try {
+        await this.disconnect();
+      } finally {
+        process.exit(0);
+      }
     });
     process.once("SIGTERM", async () => {
-      await this.disconnect();
-      process.exit(0);
+      logger.info("SIGTERM received, shutting down database connection");
+      try {
+        await this.disconnect();
+      } finally {
+        process.exit(0);
+      }
     });
   }
 };
@@ -4917,7 +4931,7 @@ var MongoDatabaseProvider = class {
   }
 };
 
-// src/errors/appError.ts
+// src/core/errors/AppError.ts
 var AppError = class extends Error {
   statusCode;
   status;
@@ -4927,20 +4941,20 @@ var AppError = class extends Error {
   constructor(message, statusCode = 500, options) {
     super(message);
     this.statusCode = statusCode;
-    this.status = `${statusCode}`.startsWith("4") ? "fail" : "error";
-    this.isOperational = true;
+    this.status = statusCode >= 400 && statusCode < 500 ? "fail" : "error";
+    this.isOperational = options?.isOperational ?? true;
     this.code = options?.code;
     this.details = options?.details;
     Error.captureStackTrace(this, this.constructor);
   }
 };
 
-// src/http/handlers/AsyncHandler.ts
+// src/infrastructure/http/handlers/AsyncHandler.ts
 var AsyncHandler = (fn) => (req, res, next) => {
   Promise.resolve(fn(req, res, next)).catch(next);
 };
 
-// src/http/query/QueryConstants.ts
+// src/infrastructure/http/query/QueryConstants.ts
 var QUERY_RESERVED_FIELDS = [
   "page",
   "limit",
@@ -4965,7 +4979,7 @@ var SUPPORTED_OPERATORS = [
   "endsWith"
 ];
 
-// src/http/query/ApiFeatures.ts
+// src/infrastructure/http/query/ApiFeatures.ts
 var ApiFeatures = class {
   static parse(query) {
     return {
@@ -5043,7 +5057,7 @@ var ApiFeatures = class {
   }
 };
 
-// src/http/responses/ApiResponse.ts
+// src/infrastructure/http/responses/ApiResponse.ts
 var ApiResponse = class _ApiResponse {
   static send(res, options) {
     const {
@@ -5117,7 +5131,7 @@ var ApiResponse = class _ApiResponse {
   }
 };
 
-// src/http/controllers/CrudControllerFactory.ts
+// src/infrastructure/http/controllers/CrudControllerFactory.ts
 var CrudControllerFactory = class {
   static create(repository, options = {}) {
     const resourceName = options.resourceName ?? "Resource";
@@ -5219,12 +5233,12 @@ var CrudControllerFactory = class {
   }
 };
 
-// src/http/middleware/AuthMiddleware.ts
+// src/infrastructure/http/middleware/AuthMiddleware.ts
 var authMiddleware = (_req, _res, next) => {
   next();
 };
 
-// src/http/middleware/ErrorMiddleware.ts
+// src/infrastructure/http/middleware/ErrorMiddleware.ts
 var handleCastError = (err) => new AppError(`Invalid ${err.path}: ${err.value}`, 400, {
   code: "INVALID_ID"
 });
@@ -5254,11 +5268,13 @@ var ErrorMiddleware = (isProduction = false) => (err, _req, res, _next) => {
   if (err instanceof AppError) {
     error = err;
   } else if (err instanceof Error) {
-    error = new AppError(err.message, 500);
-    error.isOperational = false;
+    error = new AppError(err.message, 500, {
+      isOperational: false
+    });
   } else {
-    error = new AppError("Internal Server Error", 500);
-    error.isOperational = false;
+    error = new AppError("Internal Server Error", 500, {
+      isOperational: false
+    });
   }
   if (err && err.name === "CastError") {
     error = handleCastError(err);
@@ -5278,9 +5294,9 @@ var ErrorMiddleware = (isProduction = false) => (err, _req, res, _next) => {
     error = handleJWTExpiredError();
   }
   if (!error.isOperational) {
-    logger.danger("Programming error", err);
+    logger.error("Programming error", err);
   } else {
-    logger.danger("Operational error", {
+    logger.error("Operational error", {
       message: error.message
     });
   }
@@ -5308,7 +5324,7 @@ var ErrorMiddleware = (isProduction = false) => (err, _req, res, _next) => {
   });
 };
 
-// src/http/validation/Validator.ts
+// src/infrastructure/http/validation/Validator.ts
 var isJoiSchema = (schema) => {
   return typeof schema === "object" && schema !== null && "validate" in schema;
 };
@@ -5316,7 +5332,7 @@ var isZodSchema = (schema) => {
   return typeof schema === "object" && schema !== null && "safeParse" in schema;
 };
 
-// src/http/validation/JoiValidator.ts
+// src/infrastructure/http/validation/JoiValidator.ts
 var JoiValidator = class {
   constructor(schema) {
     this.schema = schema;
@@ -5344,7 +5360,7 @@ var JoiValidator = class {
   }
 };
 
-// src/http/validation/ZodValidator.ts
+// src/infrastructure/http/validation/ZodValidator.ts
 var ZodValidator = class {
   constructor(schema) {
     this.schema = schema;
@@ -5369,7 +5385,7 @@ var ZodValidator = class {
   }
 };
 
-// src/http/middleware/ValidationMiddleware.ts
+// src/infrastructure/http/middleware/ValidationMiddleware.ts
 var validate = (schema) => (req, _res, next) => {
   let result;
   if (isJoiSchema(schema)) {
@@ -5391,7 +5407,7 @@ var validate = (schema) => (req, _res, next) => {
   next();
 };
 
-// src/http/utils/PickFields.ts
+// src/infrastructure/http/utils/PickFields.ts
 function pickFields(obj, fields, options = {}) {
   const removeUndefined = options.removeUndefined ?? false;
   const removeNull = options.removeNull ?? false;
@@ -5453,7 +5469,7 @@ var RequestContext = class {
   }
 };
 
-// src/networking/middleware/RequestContextMiddleware.ts
+// src/infrastructure/networking/middleware/RequestContextMiddleware.ts
 function createRequestContextMiddleware(options = {}) {
   const {
     correlationHeaderName = "X-Correlation-Id",
@@ -5473,7 +5489,7 @@ function createRequestContextMiddleware(options = {}) {
   };
 }
 
-// src/networking/observability/TracingHeaders.ts
+// src/infrastructure/networking/observability/TracingHeaders.ts
 var TracingHeaders = class {
   static build() {
     const headers = {};
@@ -5497,7 +5513,7 @@ var TracingHeaders = class {
   }
 };
 
-// src/networking/resilience/ExponentialBackoffRetryPolicy.ts
+// src/infrastructure/networking/resilience/ExponentialBackoffRetryPolicy.ts
 var ExponentialBackoffRetryPolicy = class {
   retries;
   baseDelay;
@@ -5516,7 +5532,7 @@ var ExponentialBackoffRetryPolicy = class {
   }
 };
 
-// src/networking/resilience/FixedRetryPolicy.ts
+// src/infrastructure/networking/resilience/FixedRetryPolicy.ts
 var FixedRetryPolicy = class {
   retries;
   delay;
@@ -5532,7 +5548,7 @@ var FixedRetryPolicy = class {
   }
 };
 
-// src/networking/security/BearerTokenStrategy.ts
+// src/infrastructure/networking/security/BearerTokenStrategy.ts
 var BearerTokenStrategy = class {
   constructor(tokenProvider) {
     this.tokenProvider = tokenProvider;
@@ -5545,7 +5561,7 @@ var BearerTokenStrategy = class {
   }
 };
 
-// src/networking/security/StaticTokenProvider.ts
+// src/infrastructure/networking/security/StaticTokenProvider.ts
 var StaticTokenProvider = class {
   constructor(token) {
     this.token = token;
@@ -5555,7 +5571,7 @@ var StaticTokenProvider = class {
   }
 };
 
-// src/networking/transport/HttpClient.ts
+// src/infrastructure/networking/transport/HttpClient.ts
 var HttpClient = class {
   baseUrl;
   timeout;
@@ -5633,7 +5649,7 @@ var HttpClient = class {
         lastError = error;
         if (this.retryPolicy.shouldRetry(attempt, error)) {
           const delay = this.retryPolicy.getDelay(attempt, error);
-          logger.warning(
+          logger.warn(
             `[${this.serviceName}] retry ${attempt + 1} after ${delay}ms`
           );
           await this.sleep(delay);
@@ -5644,7 +5660,7 @@ var HttpClient = class {
       }
     }
     const correlationId = RequestContext.getCorrelationId();
-    logger.danger(
+    logger.error(
       `[${this.serviceName}]` + (correlationId ? ` [${correlationId}]` : "") + ` request failed`,
       lastError
     );
@@ -5655,7 +5671,7 @@ var HttpClient = class {
   }
 };
 
-// src/networking/services/ServiceClient.ts
+// src/infrastructure/networking/services/ServiceClient.ts
 var ServiceClient = class extends HttpClient {
   async getData(path2) {
     const response = await super.get(path2);
@@ -5679,7 +5695,7 @@ var ServiceClient = class extends HttpClient {
   }
 };
 
-// src/networking/services/InternalServiceClient.ts
+// src/infrastructure/networking/services/InternalServiceClient.ts
 var InternalServiceClient = class extends ServiceClient {
   constructor(baseUrl, serviceToken, serviceName) {
     super(baseUrl, {
@@ -6118,7 +6134,7 @@ var JWTService = class {
     try {
       return jwt__default.default.verify(token, this.accessSecret);
     } catch (err) {
-      logger.danger("Access token verification failed:", err.message);
+      logger.error("Access token verification failed:", err.message);
       return null;
     }
   }
@@ -6126,7 +6142,7 @@ var JWTService = class {
     try {
       return jwt__default.default.verify(token, this.refreshSecret);
     } catch (err) {
-      logger.danger("Refresh token verification failed:", err.message);
+      logger.error("Refresh token verification failed:", err.message);
       return null;
     }
   }
@@ -6288,7 +6304,6 @@ exports.AdjacencyList = AdjacencyList;
 exports.AdjacencyMatrix = AdjacencyMatrix;
 exports.ApiFeatures = ApiFeatures;
 exports.ApiResponse = ApiResponse;
-exports.AppError = AppError;
 exports.AsyncHandler = AsyncHandler;
 exports.AzureBlobStorageService = AzureBlobStorageService;
 exports.BPlusTree = BPlusTree;
@@ -6381,8 +6396,6 @@ exports.errorToString = errorToString;
 exports.hours = hours;
 exports.isJoiSchema = isJoiSchema;
 exports.isZodSchema = isZodSchema;
-exports.loadEnv = loadEnv;
-exports.logger = logger;
 exports.milliseconds = milliseconds;
 exports.minutes = minutes;
 exports.pickFields = pickFields;