elseware-nodejs 1.11.0 → 1.11.2

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

@@ -27,7 +27,8 @@ var juice__default = /*#__PURE__*/_interopDefault(juice);
 var jwt__default = /*#__PURE__*/_interopDefault(jwt);
 var multer__default = /*#__PURE__*/_interopDefault(multer);
 
-// src/configs/env.ts
+// src/core/constants/defaultOrigins.ts
+var DEFAULT_ALLOWED_ORIGINS = ["http://localhost:3000"];
 
 // src/utils/errorToString.ts
 function errorToString(error) {
@@ -45,119 +46,140 @@ ${error.stack ?? ""}`;
   return String(error);
 }
 
-// src/configs/logger.ts
+// 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 {
-  timestamp = true;
   enabled = true;
-  // Use to configure once at the root
+  timestamp = true;
+  colorsEnabled = true;
+  minimumLevel = "INFO" /* INFO */;
   configure(options = {}) {
-    this.timestamp = options.timestamp ?? this.timestamp;
     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}`);
   }
-  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}`);
+  debug(message) {
+    this.write("DEBUG" /* DEBUG */, message);
   }
-  info(msg) {
-    this.output(`\u{1F539} ${msg}`);
+  info(message) {
+    this.write("INFO" /* INFO */, message);
   }
-  warning(msg) {
-    this.output(`\u26A0\uFE0F ${msg}`);
+  warn(message) {
+    this.write("WARN" /* WARN */, message);
   }
-  danger(message, error) {
+  error(message, error) {
     if (error) {
-      this.output(`\u274C ${message}
+      this.write("ERROR" /* ERROR */, `${message}
 ${errorToString(error)}`);
-    } else {
-      this.output(`\u274C ${message}`);
+      return;
     }
-  }
-  log(msg) {
-    this.output(`\u2022 ${msg}`);
+    this.write("ERROR" /* ERROR */, message);
   }
 };
+
+// src/core/logger/index.ts
 var logger = new Logger();
 
-// src/configs/env.ts
+// src/core/environment/loadEnv.ts
 dotenv__default.default.config({ quiet: true });
 function loadEnv(options) {
   const result = options.schema.safeParse(process.env);
   if (!result.success) {
-    handleError(result.error);
+    handleValidationError(result.error);
   }
-  logger.success("Env Configurations validated");
+  logger.info("Environment variables validated");
   const env = result.data;
   return options.transform ? options.transform(env) : env;
 }
-function handleError(error) {
-  logger.danger("Env validation failed");
+function handleValidationError(error) {
+  logger.error("Environment validation failed");
   const grouped = {};
-  error.issues.forEach((err) => {
-    const key = err.path.join(".") || "unknown";
+  error.issues.forEach((issue) => {
+    const key = issue.path.join(".") || "unknown";
     const rawValue = key !== "unknown" ? process.env[key] : void 0;
-    const isSecret = key.toLowerCase().includes("secret");
-    const safeValue = isSecret ? "***" : rawValue;
+    const safeValue = key.toLowerCase().includes("secret") ? "***" : rawValue;
     const message = [
-      `message: ${err.message}`,
-      `code: ${err.code}`,
+      `message: ${issue.message}`,
+      `code: ${issue.code}`,
       rawValue !== void 0 ? `value: ${JSON.stringify(safeValue)}` : null
     ].filter(Boolean).join(" | ");
-    if (!grouped[key]) grouped[key] = [];
+    grouped[key] ??= [];
     grouped[key].push(message);
   });
   Object.entries(grouped).forEach(([key, messages]) => {
-    logger.info(key);
-    messages.forEach((msg) => logger.log(`   - ${msg}`));
+    logger.error(`ENV: ${key}`);
+    messages.forEach((message) => logger.error(`   - ${message}`));
   });
-  logger.danger("Application startup aborted!");
+  logger.error("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];
+// src/core/errors/AppError.ts
+var AppError = class extends Error {
+  statusCode;
+  status;
+  isOperational;
+  code;
+  details;
+  constructor(message, statusCode = 500, options) {
+    super(message);
+    this.statusCode = statusCode;
+    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);
   }
-  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 {
@@ -4841,7 +4863,45 @@ var SegmentTree = class {
   }
 };
 
-// src/database/DatabaseManager.ts
+// 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/infrastructure/database/DatabaseManager.ts
 var DatabaseManager = class {
   constructor(provider, options = {
     enableShutdownHooks: true
@@ -4852,21 +4912,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 +4938,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,30 +4985,12 @@ var MongoDatabaseProvider = class {
   }
 };
 
-// src/errors/appError.ts
-var AppError = class extends Error {
-  statusCode;
-  status;
-  isOperational;
-  code;
-  details;
-  constructor(message, statusCode = 500, options) {
-    super(message);
-    this.statusCode = statusCode;
-    this.status = `${statusCode}`.startsWith("4") ? "fail" : "error";
-    this.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 +5015,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 +5093,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 +5167,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 +5269,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"
 });
@@ -5234,7 +5284,7 @@ var handleDuplicateKey = (err) => {
     code: "DUPLICATE_FIELD"
   });
 };
-var handleValidationError = (err) => {
+var handleValidationError2 = (err) => {
   const errors = Object.entries(err.errors).reduce(
     (acc, [key, value]) => {
       acc[key] = value.message;
@@ -5254,11 +5304,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);
@@ -5269,7 +5321,7 @@ var ErrorMiddleware = (isProduction = false) => (err, _req, res, _next) => {
     );
   }
   if (err && err.name === "ValidationError") {
-    error = handleValidationError(err);
+    error = handleValidationError2(err);
   }
   if (err?.name === "JsonWebTokenError") {
     error = handleJWTError();
@@ -5278,9 +5330,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 +5360,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 +5368,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 +5396,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 +5421,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 +5443,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 +5505,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 +5525,7 @@ function createRequestContextMiddleware(options = {}) {
   };
 }
 
-// src/networking/observability/TracingHeaders.ts
+// src/infrastructure/networking/observability/TracingHeaders.ts
 var TracingHeaders = class {
   static build() {
     const headers = {};
@@ -5497,7 +5549,7 @@ var TracingHeaders = class {
   }
 };
 
-// src/networking/resilience/ExponentialBackoffRetryPolicy.ts
+// src/infrastructure/networking/resilience/ExponentialBackoffRetryPolicy.ts
 var ExponentialBackoffRetryPolicy = class {
   retries;
   baseDelay;
@@ -5516,7 +5568,7 @@ var ExponentialBackoffRetryPolicy = class {
   }
 };
 
-// src/networking/resilience/FixedRetryPolicy.ts
+// src/infrastructure/networking/resilience/FixedRetryPolicy.ts
 var FixedRetryPolicy = class {
   retries;
   delay;
@@ -5532,7 +5584,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 +5597,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 +5607,7 @@ var StaticTokenProvider = class {
   }
 };
 
-// src/networking/transport/HttpClient.ts
+// src/infrastructure/networking/transport/HttpClient.ts
 var HttpClient = class {
   baseUrl;
   timeout;
@@ -5633,7 +5685,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 +5696,7 @@ var HttpClient = class {
       }
     }
     const correlationId = RequestContext.getCorrelationId();
-    logger.danger(
+    logger.error(
       `[${this.serviceName}]` + (correlationId ? ` [${correlationId}]` : "") + ` request failed`,
       lastError
     );
@@ -5655,7 +5707,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 +5731,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 +6170,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 +6178,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;
     }
   }
@@ -6306,6 +6358,7 @@ exports.ConsistentHash = ConsistentHash;
 exports.CorrelationId = CorrelationId;
 exports.CountMinSketch = CountMinSketch;
 exports.CrudControllerFactory = CrudControllerFactory;
+exports.DEFAULT_ALLOWED_ORIGINS = DEFAULT_ALLOWED_ORIGINS;
 exports.DEFAULT_LIMIT = DEFAULT_LIMIT;
 exports.DEFAULT_PAGE = DEFAULT_PAGE;
 exports.DEFAULT_SORT_DIRECTION = DEFAULT_SORT_DIRECTION;
@@ -6334,6 +6387,7 @@ exports.JoiValidator = JoiValidator;
 exports.KDTree = KDTree;
 exports.LFUCache = LFUCache;
 exports.LRUCache = LRUCache;
+exports.Logger = Logger;
 exports.MaxHeap = MaxHeap;
 exports.MaxStack = MaxStack;
 exports.MinHeap = MinHeap;