elseware-nodejs 1.9.1 → 1.11.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,275 @@ 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/middleware/RequestContextMiddleware.ts
+function createRequestContextMiddleware(options = {}) {
+  const {
+    correlationHeaderName = "X-Correlation-Id",
+    exposeHeader = true
+  } = options;
+  return (req, res, next) => {
+    const correlationId = req.header(correlationHeaderName) ?? CorrelationId.generate();
+    if (exposeHeader) {
+      res.setHeader(correlationHeaderName, correlationId);
+    }
+    RequestContext.run(
+      {
+        correlationId
+      },
+      () => next()
+    );
+  };
+}
+
+// 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 {
@@ -6028,6 +6293,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;
@@ -6037,6 +6303,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;
@@ -6050,13 +6317,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;
@@ -6081,25 +6352,30 @@ 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;
 exports.authMiddleware = authMiddleware;
 exports.createAllowedOrigins = createAllowedOrigins;
 exports.createCorsOptions = createCorsOptions;
+exports.createRequestContextMiddleware = createRequestContextMiddleware;
 exports.days = days;
 exports.errorToString = errorToString;
 exports.hours = hours;