elseware-nodejs 1.11.6 → 1.11.8

package/LICENSE

@@ -1,21 +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
+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,50 +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.
-
+# 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

@@ -1942,6 +1942,7 @@ var CircularQueue = class {
     }
     this.data = new Array(capacity);
   }
+  capacity;
   data;
   head = 0;
   tail = 0;
@@ -4919,6 +4920,8 @@ var DatabaseManager = class {
     this.provider = provider;
     this.options = options;
   }
+  provider;
+  options;
   async connect() {
     try {
       await this.provider.connect();
@@ -4969,6 +4972,7 @@ var MongoDatabaseProvider = class {
   constructor(config) {
     this.config = config;
   }
+  config;
   async connect() {
     mongoose__default.default.set("strictQuery", this.config.strictQuery ?? true);
     await mongoose__default.default.connect(this.config.uri);
@@ -5000,33 +5004,41 @@ var AsyncHandler = (fn) => (req, res, next) => {
   Promise.resolve(fn(req, res, next)).catch(next);
 };
 
-// src/infrastructure/http/query/QueryConstants.ts
-var QUERY_RESERVED_FIELDS = [
-  "page",
-  "limit",
-  "sort",
-  "fields",
-  "populate"
-];
-var DEFAULT_PAGE = 1;
-var DEFAULT_LIMIT = 100;
-var DEFAULT_SORT_DIRECTION = "asc";
-var SUPPORTED_OPERATORS = [
-  "eq",
-  "ne",
-  "gt",
-  "gte",
-  "lt",
-  "lte",
-  "in",
-  "nin",
-  "contains",
-  "startsWith",
-  "endsWith"
-];
+// src/infrastructure/http/query/ApiFeaturesConfig.ts
+var DefaultApiFeaturesConfig = {
+  defaultPage: 1,
+  defaultLimit: 100,
+  maxLimit: 1e3,
+  reservedFields: ["page", "limit", "sort", "fields", "populate"],
+  supportedOperators: [
+    "eq",
+    "ne",
+    "gt",
+    "gte",
+    "lt",
+    "lte",
+    "in",
+    "nin",
+    "contains",
+    "startsWith",
+    "endsWith"
+  ]
+};
 
 // src/infrastructure/http/query/ApiFeatures.ts
 var ApiFeatures = class {
+  static config = {
+    ...DefaultApiFeaturesConfig
+  };
+  static configure(config) {
+    this.config = {
+      ...this.config,
+      ...config
+    };
+  }
+  static getConfig() {
+    return this.config;
+  }
   static parse(query) {
     return {
       filters: this.parseFilters(query),
@@ -5039,12 +5051,11 @@ var ApiFeatures = class {
   static parseFilters(query) {
     const filters = [];
     Object.entries(query).forEach(([key, value]) => {
-      if (QUERY_RESERVED_FIELDS.includes(key)) {
+      if (this.config.reservedFields.includes(key)) {
         return;
       }
-      const match = key.match(
-        /^(.+)\[(eq|ne|gt|gte|lt|lte|in|nin|contains|startsWith|endsWith)\]$/
-      );
+      const operatorsPattern = this.config.supportedOperators.join("|");
+      const match = key.match(new RegExp(`^(.+)\\[(${operatorsPattern})\\]$`));
       if (match) {
         filters.push({
           field: match[1],
@@ -5094,8 +5105,9 @@ var ApiFeatures = class {
     return populate.split(",").map((field) => field.trim()).filter(Boolean);
   }
   static parsePagination(query) {
-    const page = Number(query.page) || DEFAULT_PAGE;
-    const limit = Number(query.limit) || DEFAULT_LIMIT;
+    const page = Math.max(1, Number(query.page) || this.config.defaultPage);
+    const requestedLimit = Number(query.limit) || this.config.defaultLimit;
+    const limit = Math.min(Math.max(1, requestedLimit), this.config.maxLimit);
     return {
       page,
       limit
@@ -5383,6 +5395,7 @@ var JoiValidator = class {
   constructor(schema) {
     this.schema = schema;
   }
+  schema;
   validate(data) {
     const result = this.schema.validate(data, {
       abortEarly: false,
@@ -5411,6 +5424,7 @@ var ZodValidator = class {
   constructor(schema) {
     this.schema = schema;
   }
+  schema;
   validate(data) {
     const result = this.schema.safeParse(data);
     if (!result.success) {
@@ -5599,6 +5613,7 @@ var BearerTokenStrategy = class {
   constructor(tokenProvider) {
     this.tokenProvider = tokenProvider;
   }
+  tokenProvider;
   async getHeaders() {
     const token = await this.tokenProvider.getToken();
     return {
@@ -5612,6 +5627,7 @@ var StaticTokenProvider = class {
   constructor(token) {
     this.token = token;
   }
+  token;
   getToken() {
     return this.token;
   }
@@ -5655,9 +5671,9 @@ var HttpClient = class {
     let attempt = 0;
     let lastError;
     while (true) {
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), this.timeout);
       try {
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), this.timeout);
         const authHeaders = await this.authStrategy?.getHeaders();
         const response = await fetch(`${this.baseUrl}${path2}`, {
           method,
@@ -5671,17 +5687,19 @@ var HttpClient = class {
           body: body !== void 0 ? JSON.stringify(body) : void 0
         });
         clearTimeout(timeout);
-        const json = await response.json();
+        const parsedBody = await this.parseResponseBody(response);
         if (!response.ok) {
+          const payload = parsedBody;
           throw new AppError(
-            json?.message ?? "HTTP request failed",
+            payload?.message ?? response.statusText ?? "HTTP request failed",
             response.status,
             {
-              code: json?.code ?? "HTTP_REQUEST_FAILED",
+              code: payload?.code ?? "HTTP_REQUEST_FAILED",
               details: {
                 service: this.serviceName,
                 method,
-                path: path2
+                path: path2,
+                status: response.status
               }
             }
           );
@@ -5690,8 +5708,9 @@ var HttpClient = class {
         logger.info(
           `[${this.serviceName}]` + (correlationId2 ? ` [${correlationId2}]` : "") + ` ${method} ${path2}`
         );
-        return json;
+        return parsedBody;
       } catch (error) {
+        clearTimeout(timeout);
         lastError = error;
         if (this.retryPolicy.shouldRetry(attempt, error)) {
           const delay = this.retryPolicy.getDelay(attempt, error);
@@ -5712,6 +5731,31 @@ var HttpClient = class {
     );
     throw lastError;
   }
+  async parseResponseBody(response) {
+    if (response.status === 204) {
+      return null;
+    }
+    const responseLike = response;
+    const contentType = response.headers?.get?.("content-type") ?? "";
+    if (contentType.includes("application/json") && typeof responseLike.json === "function") {
+      return responseLike.json();
+    }
+    if (typeof responseLike.json === "function") {
+      try {
+        return await responseLike.json();
+      } catch {
+      }
+    }
+    if (typeof responseLike.text === "function") {
+      const text = await responseLike.text();
+      return {
+        message: text || response.statusText || "HTTP request failed"
+      };
+    }
+    return {
+      message: response.statusText || "HTTP request failed"
+    };
+  }
   sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
   }
@@ -6368,10 +6412,8 @@ exports.ConsistentHash = ConsistentHash;
 exports.CorrelationId = CorrelationId;
 exports.CountMinSketch = CountMinSketch;
 exports.CrudControllerFactory = CrudControllerFactory;
-exports.DEFAULT_LIMIT = DEFAULT_LIMIT;
-exports.DEFAULT_PAGE = DEFAULT_PAGE;
-exports.DEFAULT_SORT_DIRECTION = DEFAULT_SORT_DIRECTION;
 exports.DatabaseManager = DatabaseManager;
+exports.DefaultApiFeaturesConfig = DefaultApiFeaturesConfig;
 exports.Deque = Deque;
 exports.DirectedGraph = DirectedGraph;
 exports.DisjointSetUnion = DisjointSetUnion;
@@ -6410,14 +6452,12 @@ exports.OrderedSet = OrderedSet;
 exports.PairingHeap = PairingHeap;
 exports.PairingNode = PairingNode;
 exports.PriorityQueue = PriorityQueue;
-exports.QUERY_RESERVED_FIELDS = QUERY_RESERVED_FIELDS;
 exports.QuadTree = QuadTree;
 exports.Queue = Queue;
 exports.RadixTree = RadixTree;
 exports.RedBlackTree = RedBlackTree;
 exports.RequestContext = RequestContext;
 exports.SMTPProvider = SMTPProvider;
-exports.SUPPORTED_OPERATORS = SUPPORTED_OPERATORS;
 exports.SegmentTree = SegmentTree;
 exports.ServiceClient = ServiceClient;
 exports.Set = Set2;