elseware-nodejs 1.9.0 → 1.10.0

package/README.md

@@ -1 +1 @@
-# elseware-nodejs
+# elseware-nodejs

package/dist/index.cjs

@@ -2,6 +2,8 @@
 
 var dotenv = require('dotenv');
 var mongoose = require('mongoose');
+var crypto = require('crypto');
+var async_hooks = require('async_hooks');
 var storageBlob = require('@azure/storage-blob');
 var fs3 = require('fs');
 var cloudinaryModule = require('cloudinary');
@@ -1919,7 +1921,6 @@ var CircularQueue = class {
     }
     this.data = new Array(capacity);
   }
-  capacity;
   data;
   head = 0;
   tail = 0;
@@ -4848,8 +4849,6 @@ var DatabaseManager = class {
     this.provider = provider;
     this.options = options;
   }
-  provider;
-  options;
   async connect() {
     try {
       await this.provider.connect();
@@ -4892,7 +4891,6 @@ 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);
@@ -5323,7 +5321,6 @@ var JoiValidator = class {
   constructor(schema) {
     this.schema = schema;
   }
-  schema;
   validate(data) {
     const result = this.schema.validate(data, {
       abortEarly: false,
@@ -5352,7 +5349,6 @@ var ZodValidator = class {
   constructor(schema) {
     this.schema = schema;
   }
-  schema;
   validate(data) {
     const result = this.schema.safeParse(data);
     if (!result.success) {
@@ -5430,6 +5426,255 @@ function pickFields(obj, fields, options = {}) {
   }
   return result;
 }
+var CorrelationId = class {
+  static generate() {
+    return crypto.randomUUID();
+  }
+};
+var RequestContext = class {
+  static storage = new async_hooks.AsyncLocalStorage();
+  static run(context, callback) {
+    return this.storage.run(context, callback);
+  }
+  static get() {
+    return this.storage.getStore();
+  }
+  static getCorrelationId() {
+    return this.get()?.correlationId;
+  }
+  static getRequestId() {
+    return this.get()?.requestId;
+  }
+  static getUserId() {
+    return this.get()?.userId;
+  }
+  static getTenantId() {
+    return this.get()?.tenantId;
+  }
+};
+
+// src/networking/observability/TracingHeaders.ts
+var TracingHeaders = class {
+  static build() {
+    const headers = {};
+    const correlationId = RequestContext.getCorrelationId();
+    const requestId = RequestContext.getRequestId();
+    const userId = RequestContext.getUserId();
+    const tenantId = RequestContext.getTenantId();
+    if (correlationId) {
+      headers["X-Correlation-Id"] = correlationId;
+    }
+    if (requestId) {
+      headers["X-Request-Id"] = requestId;
+    }
+    if (userId) {
+      headers["X-User-Id"] = userId;
+    }
+    if (tenantId) {
+      headers["X-Tenant-Id"] = tenantId;
+    }
+    return headers;
+  }
+};
+
+// src/networking/resilience/ExponentialBackoffRetryPolicy.ts
+var ExponentialBackoffRetryPolicy = class {
+  retries;
+  baseDelay;
+  maxDelay;
+  constructor(options = {}) {
+    this.retries = options.retries ?? 5;
+    this.baseDelay = options.baseDelay ?? 200;
+    this.maxDelay = options.maxDelay ?? 1e4;
+  }
+  shouldRetry(attempt) {
+    return attempt < this.retries;
+  }
+  getDelay(attempt) {
+    const delay = this.baseDelay * Math.pow(2, attempt);
+    return Math.min(delay, this.maxDelay);
+  }
+};
+
+// src/networking/resilience/FixedRetryPolicy.ts
+var FixedRetryPolicy = class {
+  retries;
+  delay;
+  constructor(options = {}) {
+    this.retries = options.retries ?? 2;
+    this.delay = options.delay ?? 500;
+  }
+  shouldRetry(attempt) {
+    return attempt < this.retries;
+  }
+  getDelay(_attempt, _error) {
+    return this.delay;
+  }
+};
+
+// src/networking/security/BearerTokenStrategy.ts
+var BearerTokenStrategy = class {
+  constructor(tokenProvider) {
+    this.tokenProvider = tokenProvider;
+  }
+  async getHeaders() {
+    const token = await this.tokenProvider.getToken();
+    return {
+      Authorization: `Bearer ${token}`
+    };
+  }
+};
+
+// src/networking/security/StaticTokenProvider.ts
+var StaticTokenProvider = class {
+  constructor(token) {
+    this.token = token;
+  }
+  getToken() {
+    return this.token;
+  }
+};
+
+// src/networking/transport/HttpClient.ts
+var HttpClient = class {
+  baseUrl;
+  timeout;
+  headers;
+  serviceName;
+  authStrategy;
+  retryPolicy;
+  constructor(baseUrl, options = {}) {
+    this.baseUrl = baseUrl;
+    this.timeout = options.timeout ?? 5e3;
+    this.headers = options.headers ?? {};
+    this.serviceName = options.serviceName ?? "UnknownService";
+    this.authStrategy = options.authStrategy;
+    this.retryPolicy = options.retryPolicy ?? new FixedRetryPolicy({
+      retries: 2,
+      delay: 500
+    });
+  }
+  async get(path2) {
+    return this.request("GET", path2);
+  }
+  async post(path2, body) {
+    return this.request("POST", path2, body);
+  }
+  async put(path2, body) {
+    return this.request("PUT", path2, body);
+  }
+  async patch(path2, body) {
+    return this.request("PATCH", path2, body);
+  }
+  async delete(path2) {
+    return this.request("DELETE", path2);
+  }
+  async request(method, path2, body) {
+    let attempt = 0;
+    let lastError;
+    while (true) {
+      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,
+          signal: controller.signal,
+          headers: {
+            "Content-Type": "application/json",
+            ...TracingHeaders.build(),
+            ...this.headers,
+            ...authHeaders
+          },
+          body: body !== void 0 ? JSON.stringify(body) : void 0
+        });
+        clearTimeout(timeout);
+        const json = await response.json();
+        if (!response.ok) {
+          throw new AppError(
+            json?.message ?? "HTTP request failed",
+            response.status,
+            {
+              code: json?.code ?? "HTTP_REQUEST_FAILED",
+              details: {
+                service: this.serviceName,
+                method,
+                path: path2
+              }
+            }
+          );
+        }
+        const correlationId2 = RequestContext.getCorrelationId();
+        logger.info(
+          `[${this.serviceName}]` + (correlationId2 ? ` [${correlationId2}]` : "") + ` ${method} ${path2}`
+        );
+        return json;
+      } catch (error) {
+        lastError = error;
+        if (this.retryPolicy.shouldRetry(attempt, error)) {
+          const delay = this.retryPolicy.getDelay(attempt, error);
+          logger.warning(
+            `[${this.serviceName}] retry ${attempt + 1} after ${delay}ms`
+          );
+          await this.sleep(delay);
+          attempt++;
+          continue;
+        }
+        break;
+      }
+    }
+    const correlationId = RequestContext.getCorrelationId();
+    logger.danger(
+      `[${this.serviceName}]` + (correlationId ? ` [${correlationId}]` : "") + ` request failed`,
+      lastError
+    );
+    throw lastError;
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+// src/networking/services/ServiceClient.ts
+var ServiceClient = class extends HttpClient {
+  async getData(path2) {
+    const response = await super.get(path2);
+    return response.data;
+  }
+  async postData(path2, body) {
+    const response = await super.post(path2, body);
+    return response.data;
+  }
+  async putData(path2, body) {
+    const response = await super.put(path2, body);
+    return response.data;
+  }
+  async patchData(path2, body) {
+    const response = await super.patch(path2, body);
+    return response.data;
+  }
+  async deleteData(path2) {
+    const response = await super.delete(path2);
+    return response.data;
+  }
+};
+
+// src/networking/services/InternalServiceClient.ts
+var InternalServiceClient = class extends ServiceClient {
+  constructor(baseUrl, serviceToken, serviceName) {
+    super(baseUrl, {
+      serviceName,
+      authStrategy: new BearerTokenStrategy(
+        new StaticTokenProvider(serviceToken)
+      ),
+      timeout: 5e3,
+      retryPolicy: new ExponentialBackoffRetryPolicy({
+        retries: 3,
+        baseDelay: 200
+      })
+    });
+  }
+};
 
 // src/repositories/providers/MongoRepository.ts
 var MongoRepository = class {
@@ -5438,7 +5683,9 @@ var MongoRepository = class {
     this.model = model;
   }
   buildSelect(select) {
-    if (!select) return void 0;
+    if (!select) {
+      return void 0;
+    }
     if (Array.isArray(select)) {
       return select.join(" ");
     }
@@ -5446,14 +5693,22 @@ var MongoRepository = class {
   }
   applyQueryOptions(query, options) {
     const select = this.buildSelect(options.select);
-    if (select) query = query.select(select);
-    if (options.sort) query = query.sort(options.sort);
-    if (options.limit) query = query.limit(options.limit);
-    if (options.skip) query = query.skip(options.skip);
+    if (select) {
+      query = query.select(select);
+    }
+    if (options.sort) {
+      query = query.sort(options.sort);
+    }
+    if (options.limit) {
+      query = query.limit(options.limit);
+    }
+    if (options.skip) {
+      query = query.skip(options.skip);
+    }
     if (options.populate) {
       if (Array.isArray(options.populate)) {
-        options.populate.forEach((p) => {
-          query = query.populate(p);
+        options.populate.forEach((item) => {
+          query = query.populate(item);
         });
       } else {
         query = query.populate(options.populate);
@@ -5462,7 +5717,13 @@ var MongoRepository = class {
     return query;
   }
   toPlain(doc) {
-    return doc.toObject();
+    if (!doc) {
+      return doc;
+    }
+    return typeof doc.toObject === "function" ? doc.toObject() : doc;
+  }
+  toPlainArray(docs) {
+    return docs.map((doc) => this.toPlain(doc));
   }
   /**
    * Create
@@ -5473,7 +5734,7 @@ var MongoRepository = class {
   }
   async createMany(data) {
     const docs = await this.model.insertMany(data);
-    return docs.map((doc) => this.toPlain(doc));
+    return this.toPlainArray(docs);
   }
   /**
    * Read
@@ -5481,22 +5742,26 @@ var MongoRepository = class {
   async findAll(filter = {}, options = {}) {
     let query = this.model.find(filter);
     query = this.applyQueryOptions(query, options);
-    return query.exec();
+    return query.lean().exec();
   }
   async findById(id, options = {}) {
     let query = this.model.findById(id);
     query = this.applyQueryOptions(query, options);
-    return query.exec();
+    return query.lean().exec();
   }
   async findOne(filter = {}, options = {}) {
     let query = this.model.findOne(filter);
     query = this.applyQueryOptions(query, options);
-    return query.exec();
+    return query.lean().exec();
   }
   async findManyByIds(ids, options = {}) {
-    let query = this.model.find({ _id: { $in: ids } });
+    let query = this.model.find({
+      _id: {
+        $in: ids
+      }
+    });
     query = this.applyQueryOptions(query, options);
-    return query.exec();
+    return query.lean().exec();
   }
   async count(filter) {
     return this.model.countDocuments(filter).exec();
@@ -5509,12 +5774,22 @@ var MongoRepository = class {
    * Update
    */
   async updateById(id, data, options) {
-    const finalOptions = { new: true, runValidators: true, ...options };
-    return this.model.findByIdAndUpdate(id, data, finalOptions).exec();
+    const finalOptions = {
+      new: true,
+      runValidators: true,
+      ...options
+    };
+    const doc = await this.model.findByIdAndUpdate(id, data, finalOptions).exec();
+    return doc ? this.toPlain(doc) : null;
   }
   async updateOne(filter, data, options) {
-    const finalOptions = { new: true, runValidators: true, ...options };
-    return this.model.findOneAndUpdate(filter, data, finalOptions).exec();
+    const finalOptions = {
+      new: true,
+      runValidators: true,
+      ...options
+    };
+    const doc = await this.model.findOneAndUpdate(filter, data, finalOptions).exec();
+    return doc ? this.toPlain(doc) : null;
   }
   async updateMany(filter, data) {
     const result = await this.model.updateMany(filter, data).exec();
@@ -5524,10 +5799,12 @@ var MongoRepository = class {
    * Delete
    */
   async deleteById(id) {
-    return this.model.findByIdAndDelete(id).exec();
+    const doc = await this.model.findByIdAndDelete(id).exec();
+    return doc ? this.toPlain(doc) : null;
   }
   async deleteOne(filter) {
-    return this.model.findOneAndDelete(filter).exec();
+    const doc = await this.model.findOneAndDelete(filter).exec();
+    return doc ? this.toPlain(doc) : null;
   }
   async deleteMany(filter) {
     const result = await this.model.deleteMany(filter).exec();
@@ -5996,6 +6273,7 @@ exports.AsyncHandler = AsyncHandler;
 exports.AzureBlobStorageService = AzureBlobStorageService;
 exports.BPlusTree = BPlusTree;
 exports.BTree = BTree;
+exports.BearerTokenStrategy = BearerTokenStrategy;
 exports.BinaryHeap = BinaryHeap;
 exports.BinarySearchTree = BinarySearchTree;
 exports.BinaryTree = BinaryTree;
@@ -6005,6 +6283,7 @@ exports.CircularLinkedList = CircularLinkedList;
 exports.CircularQueue = CircularQueue;
 exports.CloudinaryService = CloudinaryService;
 exports.ConsistentHash = ConsistentHash;
+exports.CorrelationId = CorrelationId;
 exports.CountMinSketch = CountMinSketch;
 exports.CrudControllerFactory = CrudControllerFactory;
 exports.DEFAULT_LIMIT = DEFAULT_LIMIT;
@@ -6018,13 +6297,17 @@ exports.DoublyLinkedList = DoublyLinkedList;
 exports.DynamicArray = DynamicArray;
 exports.EmailService = EmailService;
 exports.ErrorMiddleware = ErrorMiddleware;
+exports.ExponentialBackoffRetryPolicy = ExponentialBackoffRetryPolicy;
 exports.FenwickTree = FenwickTree;
 exports.FibNode = FibNode;
 exports.FibonacciHeap = FibonacciHeap;
+exports.FixedRetryPolicy = FixedRetryPolicy;
 exports.Graph = Graph;
 exports.HashMap = HashMap;
 exports.HashSet = HashSet;
+exports.HttpClient = HttpClient;
 exports.HyperLogLog = HyperLogLog;
+exports.InternalServiceClient = InternalServiceClient;
 exports.IntervalTree = IntervalTree;
 exports.JWTService = JWTService;
 exports.JoiValidator = JoiValidator;
@@ -6049,19 +6332,23 @@ 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;
 exports.SinglyLinkedList = SinglyLinkedList;
 exports.SparseTable = SparseTable;
 exports.SplayTree = SplayTree;
 exports.Stack = Stack;
 exports.StaticArray = StaticArray;
+exports.StaticTokenProvider = StaticTokenProvider;
 exports.SuffixArray = SuffixArray;
 exports.SuffixTree = SuffixTree;
 exports.TemplateEngine = TemplateEngine;
 exports.TernarySearchTree = TernarySearchTree;
+exports.TracingHeaders = TracingHeaders;
 exports.TreeNode = TreeNode;
 exports.Trie = Trie;
 exports.ZodValidator = ZodValidator;