elseware-nodejs 1.9.1 → 1.11.0

package/dist/index.d.cts

@@ -1994,6 +1994,145 @@ declare class ZodValidator implements IValidator {
     validate<T = unknown>(data: unknown): ValidationResult<T>;
 }
 
+interface RequestContextOptions {
+    /**
+     * Header used for correlation id propagation.
+     *
+     * Default:
+     * X-Correlation-Id
+     */
+    correlationHeaderName?: string;
+    /**
+     * Whether to expose the correlation id
+     * back to the client in response headers.
+     *
+     * Default:
+     * true
+     */
+    exposeHeader?: boolean;
+}
+
+declare function createRequestContextMiddleware(options?: RequestContextOptions): RequestHandler;
+
+declare class CorrelationId {
+    static generate(): string;
+}
+
+interface RequestContextData {
+    correlationId: string;
+    requestId?: string;
+    userId?: string;
+    tenantId?: string;
+}
+declare class RequestContext {
+    private static readonly storage;
+    static run<T>(context: RequestContextData, callback: () => T): T;
+    static get(): RequestContextData | undefined;
+    static getCorrelationId(): string | undefined;
+    static getRequestId(): string | undefined;
+    static getUserId(): string | undefined;
+    static getTenantId(): string | undefined;
+}
+
+declare class TracingHeaders {
+    static build(): Record<string, string>;
+}
+
+interface RetryPolicy {
+    shouldRetry(attempt: number, error?: unknown): boolean;
+    getDelay(attempt: number, error?: unknown): number;
+}
+
+interface ExponentialBackoffOptions {
+    retries?: number;
+    baseDelay?: number;
+    maxDelay?: number;
+}
+declare class ExponentialBackoffRetryPolicy implements RetryPolicy {
+    private readonly retries;
+    private readonly baseDelay;
+    private readonly maxDelay;
+    constructor(options?: ExponentialBackoffOptions);
+    shouldRetry(attempt: number): boolean;
+    getDelay(attempt: number): number;
+}
+
+interface FixedRetryPolicyOptions {
+    retries?: number;
+    delay?: number;
+}
+declare class FixedRetryPolicy implements RetryPolicy {
+    private readonly retries;
+    private readonly delay;
+    constructor(options?: FixedRetryPolicyOptions);
+    shouldRetry(attempt: number): boolean;
+    getDelay(_attempt: number, _error?: unknown): number;
+}
+
+interface AuthStrategy {
+    getHeaders(): Promise<Record<string, string>>;
+}
+
+interface TokenProvider {
+    getToken(): Promise<string> | string;
+}
+
+declare class BearerTokenStrategy implements AuthStrategy {
+    private readonly tokenProvider;
+    constructor(tokenProvider: TokenProvider);
+    getHeaders(): Promise<Record<string, string>>;
+}
+
+declare class StaticTokenProvider implements TokenProvider {
+    private readonly token;
+    constructor(token: string);
+    getToken(): string;
+}
+
+interface HttpClientOptions {
+    timeout?: number;
+    headers?: Record<string, string>;
+    serviceName?: string;
+    retryPolicy?: RetryPolicy;
+}
+
+declare class HttpClient {
+    protected readonly baseUrl: string;
+    protected readonly timeout: number;
+    protected readonly headers: Record<string, string>;
+    protected readonly serviceName: string;
+    protected readonly authStrategy?: AuthStrategy;
+    protected readonly retryPolicy: RetryPolicy;
+    constructor(baseUrl: string, options?: HttpClientOptions & {
+        authStrategy?: AuthStrategy;
+    });
+    protected get<T>(path: string): Promise<T>;
+    protected post<T>(path: string, body?: unknown): Promise<T>;
+    protected put<T>(path: string, body?: unknown): Promise<T>;
+    protected patch<T>(path: string, body?: unknown): Promise<T>;
+    protected delete<T>(path: string): Promise<T>;
+    private request;
+    private sleep;
+}
+
+declare abstract class ServiceClient extends HttpClient {
+    protected getData<T>(path: string): Promise<T>;
+    protected postData<T>(path: string, body?: unknown): Promise<T>;
+    protected putData<T>(path: string, body?: unknown): Promise<T>;
+    protected patchData<T>(path: string, body?: unknown): Promise<T>;
+    protected deleteData<T>(path: string): Promise<T>;
+}
+
+declare abstract class InternalServiceClient extends ServiceClient {
+    constructor(baseUrl: string, serviceToken: string, serviceName?: string);
+}
+
+interface ServiceResponse<T> {
+    status: string;
+    message?: string;
+    data: T;
+}
+
 declare class MongoRepository<T> implements Repository<T> {
     protected model: Model<T>;
     constructor(model: Model<T>);
@@ -2176,4 +2315,4 @@ declare function toMinutes(ms: number): number;
 declare function toHours(ms: number): number;
 declare function sleep(ms: number): Promise<void>;
 
-export { AVLTree, AdjacencyList, AdjacencyMatrix, type AdjacentEdge, type AllowedOriginsOptions, ApiFeatures, type ApiMeta, ApiResponse, type ApiResponseOptions, AppError, AsyncHandler, type AsyncRequestHandler, type AuthenticatedUser, type AzureBlobStorageConfig, AzureBlobStorageService, BPlusTree, BTree, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, type CloudinaryConfig, CloudinaryService, ConsistentHash, CountMinSketch, CrudControllerFactory, type CrudControllerOptions, DEFAULT_LIMIT, DEFAULT_PAGE, DEFAULT_SORT_DIRECTION, type DatabaseConnectionOptions, DatabaseManager, type DatabaseProvider, Deque, type DirectedEdge, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, type Edge, type EmailProvider, EmailService, type ErrorMeta, ErrorMiddleware, FenwickTree, FibNode, FibonacciHeap, type Filter, Graph, HashMap, HashSet, HyperLogLog, type IValidator, type Interval, IntervalTree, JWTService, type JWTServiceOptions, JoiValidator, KDTree, LFUCache, LRUCache, type LoggerOptions, MaxHeap, MaxStack, MinHeap, MinStack, type MongoDatabaseConfig, MongoDatabaseProvider, MongoRepository, MulterFileHandlerService, MultiSet, Node, OrderedSet, type PaginationMeta, type PaginationQuery, PairingHeap, PairingNode, type ParsedQuery, type PickOptions, type Point, type Point2D, PriorityQueue, type ProgressCallback, QUERY_RESERVED_FIELDS, QuadTree, type QueryFilter, type QueryOperator, type QueryOptions, type QuerySort, Queue, RadixTree, type Rect, RedBlackTree, type Repository, SMTPProvider, SUPPORTED_OPERATORS, SegmentTree, type Select, type SendEmailOptions, Set, SinglyLinkedList, type Sort, SparseTable, SplayTree, Stack, type StandardApiResponse, StaticArray, SuffixArray, SuffixTree, TemplateEngine, TernarySearchTree, TreeNode, Trie, type UpdateQueryOptions, type UploadOptions, type ValidationResult, type ValidationSchema, ZodValidator, authMiddleware, createAllowedOrigins, createCorsOptions, days, errorToString, hours, isJoiSchema, isZodSchema, loadEnv, logger, milliseconds, minutes, pickFields, seconds, sleep, toHours, toMinutes, toSeconds, validate };
+export { AVLTree, AdjacencyList, AdjacencyMatrix, type AdjacentEdge, type AllowedOriginsOptions, ApiFeatures, type ApiMeta, ApiResponse, type ApiResponseOptions, AppError, AsyncHandler, type AsyncRequestHandler, type AuthStrategy, type AuthenticatedUser, type AzureBlobStorageConfig, AzureBlobStorageService, BPlusTree, BTree, BearerTokenStrategy, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, type CloudinaryConfig, CloudinaryService, ConsistentHash, CorrelationId, CountMinSketch, CrudControllerFactory, type CrudControllerOptions, DEFAULT_LIMIT, DEFAULT_PAGE, DEFAULT_SORT_DIRECTION, type DatabaseConnectionOptions, DatabaseManager, type DatabaseProvider, Deque, type DirectedEdge, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, type Edge, type EmailProvider, EmailService, type ErrorMeta, ErrorMiddleware, type ExponentialBackoffOptions, ExponentialBackoffRetryPolicy, FenwickTree, FibNode, FibonacciHeap, type Filter, FixedRetryPolicy, type FixedRetryPolicyOptions, Graph, HashMap, HashSet, HttpClient, type HttpClientOptions, HyperLogLog, type IValidator, InternalServiceClient, type Interval, IntervalTree, JWTService, type JWTServiceOptions, JoiValidator, KDTree, LFUCache, LRUCache, type LoggerOptions, MaxHeap, MaxStack, MinHeap, MinStack, type MongoDatabaseConfig, MongoDatabaseProvider, MongoRepository, MulterFileHandlerService, MultiSet, Node, OrderedSet, type PaginationMeta, type PaginationQuery, PairingHeap, PairingNode, type ParsedQuery, type PickOptions, type Point, type Point2D, PriorityQueue, type ProgressCallback, QUERY_RESERVED_FIELDS, QuadTree, type QueryFilter, type QueryOperator, type QueryOptions, type QuerySort, Queue, RadixTree, type Rect, RedBlackTree, type Repository, RequestContext, type RequestContextData, type RequestContextOptions, type RetryPolicy, SMTPProvider, SUPPORTED_OPERATORS, SegmentTree, type Select, type SendEmailOptions, ServiceClient, type ServiceResponse, Set, SinglyLinkedList, type Sort, SparseTable, SplayTree, Stack, type StandardApiResponse, StaticArray, StaticTokenProvider, SuffixArray, SuffixTree, TemplateEngine, TernarySearchTree, type TokenProvider, TracingHeaders, TreeNode, Trie, type UpdateQueryOptions, type UploadOptions, type ValidationResult, type ValidationSchema, ZodValidator, authMiddleware, createAllowedOrigins, createCorsOptions, createRequestContextMiddleware, days, errorToString, hours, isJoiSchema, isZodSchema, loadEnv, logger, milliseconds, minutes, pickFields, seconds, sleep, toHours, toMinutes, toSeconds, validate };

package/dist/index.d.ts

@@ -1994,6 +1994,145 @@ declare class ZodValidator implements IValidator {
     validate<T = unknown>(data: unknown): ValidationResult<T>;
 }
 
+interface RequestContextOptions {
+    /**
+     * Header used for correlation id propagation.
+     *
+     * Default:
+     * X-Correlation-Id
+     */
+    correlationHeaderName?: string;
+    /**
+     * Whether to expose the correlation id
+     * back to the client in response headers.
+     *
+     * Default:
+     * true
+     */
+    exposeHeader?: boolean;
+}
+
+declare function createRequestContextMiddleware(options?: RequestContextOptions): RequestHandler;
+
+declare class CorrelationId {
+    static generate(): string;
+}
+
+interface RequestContextData {
+    correlationId: string;
+    requestId?: string;
+    userId?: string;
+    tenantId?: string;
+}
+declare class RequestContext {
+    private static readonly storage;
+    static run<T>(context: RequestContextData, callback: () => T): T;
+    static get(): RequestContextData | undefined;
+    static getCorrelationId(): string | undefined;
+    static getRequestId(): string | undefined;
+    static getUserId(): string | undefined;
+    static getTenantId(): string | undefined;
+}
+
+declare class TracingHeaders {
+    static build(): Record<string, string>;
+}
+
+interface RetryPolicy {
+    shouldRetry(attempt: number, error?: unknown): boolean;
+    getDelay(attempt: number, error?: unknown): number;
+}
+
+interface ExponentialBackoffOptions {
+    retries?: number;
+    baseDelay?: number;
+    maxDelay?: number;
+}
+declare class ExponentialBackoffRetryPolicy implements RetryPolicy {
+    private readonly retries;
+    private readonly baseDelay;
+    private readonly maxDelay;
+    constructor(options?: ExponentialBackoffOptions);
+    shouldRetry(attempt: number): boolean;
+    getDelay(attempt: number): number;
+}
+
+interface FixedRetryPolicyOptions {
+    retries?: number;
+    delay?: number;
+}
+declare class FixedRetryPolicy implements RetryPolicy {
+    private readonly retries;
+    private readonly delay;
+    constructor(options?: FixedRetryPolicyOptions);
+    shouldRetry(attempt: number): boolean;
+    getDelay(_attempt: number, _error?: unknown): number;
+}
+
+interface AuthStrategy {
+    getHeaders(): Promise<Record<string, string>>;
+}
+
+interface TokenProvider {
+    getToken(): Promise<string> | string;
+}
+
+declare class BearerTokenStrategy implements AuthStrategy {
+    private readonly tokenProvider;
+    constructor(tokenProvider: TokenProvider);
+    getHeaders(): Promise<Record<string, string>>;
+}
+
+declare class StaticTokenProvider implements TokenProvider {
+    private readonly token;
+    constructor(token: string);
+    getToken(): string;
+}
+
+interface HttpClientOptions {
+    timeout?: number;
+    headers?: Record<string, string>;
+    serviceName?: string;
+    retryPolicy?: RetryPolicy;
+}
+
+declare class HttpClient {
+    protected readonly baseUrl: string;
+    protected readonly timeout: number;
+    protected readonly headers: Record<string, string>;
+    protected readonly serviceName: string;
+    protected readonly authStrategy?: AuthStrategy;
+    protected readonly retryPolicy: RetryPolicy;
+    constructor(baseUrl: string, options?: HttpClientOptions & {
+        authStrategy?: AuthStrategy;
+    });
+    protected get<T>(path: string): Promise<T>;
+    protected post<T>(path: string, body?: unknown): Promise<T>;
+    protected put<T>(path: string, body?: unknown): Promise<T>;
+    protected patch<T>(path: string, body?: unknown): Promise<T>;
+    protected delete<T>(path: string): Promise<T>;
+    private request;
+    private sleep;
+}
+
+declare abstract class ServiceClient extends HttpClient {
+    protected getData<T>(path: string): Promise<T>;
+    protected postData<T>(path: string, body?: unknown): Promise<T>;
+    protected putData<T>(path: string, body?: unknown): Promise<T>;
+    protected patchData<T>(path: string, body?: unknown): Promise<T>;
+    protected deleteData<T>(path: string): Promise<T>;
+}
+
+declare abstract class InternalServiceClient extends ServiceClient {
+    constructor(baseUrl: string, serviceToken: string, serviceName?: string);
+}
+
+interface ServiceResponse<T> {
+    status: string;
+    message?: string;
+    data: T;
+}
+
 declare class MongoRepository<T> implements Repository<T> {
     protected model: Model<T>;
     constructor(model: Model<T>);
@@ -2176,4 +2315,4 @@ declare function toMinutes(ms: number): number;
 declare function toHours(ms: number): number;
 declare function sleep(ms: number): Promise<void>;
 
-export { AVLTree, AdjacencyList, AdjacencyMatrix, type AdjacentEdge, type AllowedOriginsOptions, ApiFeatures, type ApiMeta, ApiResponse, type ApiResponseOptions, AppError, AsyncHandler, type AsyncRequestHandler, type AuthenticatedUser, type AzureBlobStorageConfig, AzureBlobStorageService, BPlusTree, BTree, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, type CloudinaryConfig, CloudinaryService, ConsistentHash, CountMinSketch, CrudControllerFactory, type CrudControllerOptions, DEFAULT_LIMIT, DEFAULT_PAGE, DEFAULT_SORT_DIRECTION, type DatabaseConnectionOptions, DatabaseManager, type DatabaseProvider, Deque, type DirectedEdge, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, type Edge, type EmailProvider, EmailService, type ErrorMeta, ErrorMiddleware, FenwickTree, FibNode, FibonacciHeap, type Filter, Graph, HashMap, HashSet, HyperLogLog, type IValidator, type Interval, IntervalTree, JWTService, type JWTServiceOptions, JoiValidator, KDTree, LFUCache, LRUCache, type LoggerOptions, MaxHeap, MaxStack, MinHeap, MinStack, type MongoDatabaseConfig, MongoDatabaseProvider, MongoRepository, MulterFileHandlerService, MultiSet, Node, OrderedSet, type PaginationMeta, type PaginationQuery, PairingHeap, PairingNode, type ParsedQuery, type PickOptions, type Point, type Point2D, PriorityQueue, type ProgressCallback, QUERY_RESERVED_FIELDS, QuadTree, type QueryFilter, type QueryOperator, type QueryOptions, type QuerySort, Queue, RadixTree, type Rect, RedBlackTree, type Repository, SMTPProvider, SUPPORTED_OPERATORS, SegmentTree, type Select, type SendEmailOptions, Set, SinglyLinkedList, type Sort, SparseTable, SplayTree, Stack, type StandardApiResponse, StaticArray, SuffixArray, SuffixTree, TemplateEngine, TernarySearchTree, TreeNode, Trie, type UpdateQueryOptions, type UploadOptions, type ValidationResult, type ValidationSchema, ZodValidator, authMiddleware, createAllowedOrigins, createCorsOptions, days, errorToString, hours, isJoiSchema, isZodSchema, loadEnv, logger, milliseconds, minutes, pickFields, seconds, sleep, toHours, toMinutes, toSeconds, validate };
+export { AVLTree, AdjacencyList, AdjacencyMatrix, type AdjacentEdge, type AllowedOriginsOptions, ApiFeatures, type ApiMeta, ApiResponse, type ApiResponseOptions, AppError, AsyncHandler, type AsyncRequestHandler, type AuthStrategy, type AuthenticatedUser, type AzureBlobStorageConfig, AzureBlobStorageService, BPlusTree, BTree, BearerTokenStrategy, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, type CloudinaryConfig, CloudinaryService, ConsistentHash, CorrelationId, CountMinSketch, CrudControllerFactory, type CrudControllerOptions, DEFAULT_LIMIT, DEFAULT_PAGE, DEFAULT_SORT_DIRECTION, type DatabaseConnectionOptions, DatabaseManager, type DatabaseProvider, Deque, type DirectedEdge, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, type Edge, type EmailProvider, EmailService, type ErrorMeta, ErrorMiddleware, type ExponentialBackoffOptions, ExponentialBackoffRetryPolicy, FenwickTree, FibNode, FibonacciHeap, type Filter, FixedRetryPolicy, type FixedRetryPolicyOptions, Graph, HashMap, HashSet, HttpClient, type HttpClientOptions, HyperLogLog, type IValidator, InternalServiceClient, type Interval, IntervalTree, JWTService, type JWTServiceOptions, JoiValidator, KDTree, LFUCache, LRUCache, type LoggerOptions, MaxHeap, MaxStack, MinHeap, MinStack, type MongoDatabaseConfig, MongoDatabaseProvider, MongoRepository, MulterFileHandlerService, MultiSet, Node, OrderedSet, type PaginationMeta, type PaginationQuery, PairingHeap, PairingNode, type ParsedQuery, type PickOptions, type Point, type Point2D, PriorityQueue, type ProgressCallback, QUERY_RESERVED_FIELDS, QuadTree, type QueryFilter, type QueryOperator, type QueryOptions, type QuerySort, Queue, RadixTree, type Rect, RedBlackTree, type Repository, RequestContext, type RequestContextData, type RequestContextOptions, type RetryPolicy, SMTPProvider, SUPPORTED_OPERATORS, SegmentTree, type Select, type SendEmailOptions, ServiceClient, type ServiceResponse, Set, SinglyLinkedList, type Sort, SparseTable, SplayTree, Stack, type StandardApiResponse, StaticArray, StaticTokenProvider, SuffixArray, SuffixTree, TemplateEngine, TernarySearchTree, type TokenProvider, TracingHeaders, TreeNode, Trie, type UpdateQueryOptions, type UploadOptions, type ValidationResult, type ValidationSchema, ZodValidator, authMiddleware, createAllowedOrigins, createCorsOptions, createRequestContextMiddleware, days, errorToString, hours, isJoiSchema, isZodSchema, loadEnv, logger, milliseconds, minutes, pickFields, seconds, sleep, toHours, toMinutes, toSeconds, validate };

package/dist/index.js

@@ -1,5 +1,7 @@
 import dotenv from 'dotenv';
 import mongoose from 'mongoose';
+import { randomUUID } from 'crypto';
+import { AsyncLocalStorage } from 'async_hooks';
 import { BlobServiceClient, StorageSharedKeyCredential, generateBlobSASQueryParameters, BlobSASPermissions } from '@azure/storage-blob';
 import fs3 from 'fs';
 import cloudinaryModule from 'cloudinary';
@@ -1904,7 +1906,6 @@ var CircularQueue = class {
     }
     this.data = new Array(capacity);
   }
-  capacity;
   data;
   head = 0;
   tail = 0;
@@ -4833,8 +4834,6 @@ var DatabaseManager = class {
     this.provider = provider;
     this.options = options;
   }
-  provider;
-  options;
   async connect() {
     try {
       await this.provider.connect();
@@ -4877,7 +4876,6 @@ var MongoDatabaseProvider = class {
   constructor(config) {
     this.config = config;
   }
-  config;
   async connect() {
     mongoose.set("strictQuery", this.config.strictQuery ?? true);
     await mongoose.connect(this.config.uri);
@@ -5308,7 +5306,6 @@ var JoiValidator = class {
   constructor(schema) {
     this.schema = schema;
   }
-  schema;
   validate(data) {
     const result = this.schema.validate(data, {
       abortEarly: false,
@@ -5337,7 +5334,6 @@ var ZodValidator = class {
   constructor(schema) {
     this.schema = schema;
   }
-  schema;
   validate(data) {
     const result = this.schema.safeParse(data);
     if (!result.success) {
@@ -5415,6 +5411,275 @@ function pickFields(obj, fields, options = {}) {
   }
   return result;
 }
+var CorrelationId = class {
+  static generate() {
+    return randomUUID();
+  }
+};
+var RequestContext = class {
+  static storage = new 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 {
@@ -6003,6 +6268,6 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-export { AVLTree, AdjacencyList, AdjacencyMatrix, ApiFeatures, ApiResponse, AppError, AsyncHandler, AzureBlobStorageService, BPlusTree, BTree, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, CloudinaryService, ConsistentHash, CountMinSketch, CrudControllerFactory, DEFAULT_LIMIT, DEFAULT_PAGE, DEFAULT_SORT_DIRECTION, DatabaseManager, Deque, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, EmailService, ErrorMiddleware, FenwickTree, FibNode, FibonacciHeap, Graph, HashMap, HashSet, HyperLogLog, IntervalTree, JWTService, JoiValidator, KDTree, LFUCache, LRUCache, MaxHeap, MaxStack, MinHeap, MinStack, MongoDatabaseProvider, MongoRepository, MulterFileHandlerService, MultiSet, Node, OrderedSet, PairingHeap, PairingNode, PriorityQueue, QUERY_RESERVED_FIELDS, QuadTree, Queue, RadixTree, RedBlackTree, SMTPProvider, SUPPORTED_OPERATORS, SegmentTree, Set2 as Set, SinglyLinkedList, SparseTable, SplayTree, Stack, StaticArray, SuffixArray, SuffixTree, TemplateEngine, TernarySearchTree, TreeNode, Trie, ZodValidator, authMiddleware, createAllowedOrigins, createCorsOptions, days, errorToString, hours, isJoiSchema, isZodSchema, loadEnv, logger, milliseconds, minutes, pickFields, seconds, sleep, toHours, toMinutes, toSeconds, validate };
+export { AVLTree, AdjacencyList, AdjacencyMatrix, ApiFeatures, ApiResponse, AppError, AsyncHandler, AzureBlobStorageService, BPlusTree, BTree, BearerTokenStrategy, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, CloudinaryService, ConsistentHash, CorrelationId, CountMinSketch, CrudControllerFactory, DEFAULT_LIMIT, DEFAULT_PAGE, DEFAULT_SORT_DIRECTION, DatabaseManager, Deque, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, EmailService, ErrorMiddleware, ExponentialBackoffRetryPolicy, FenwickTree, FibNode, FibonacciHeap, FixedRetryPolicy, Graph, HashMap, HashSet, HttpClient, HyperLogLog, InternalServiceClient, IntervalTree, JWTService, JoiValidator, KDTree, LFUCache, LRUCache, MaxHeap, MaxStack, MinHeap, MinStack, MongoDatabaseProvider, MongoRepository, MulterFileHandlerService, MultiSet, Node, OrderedSet, PairingHeap, PairingNode, PriorityQueue, QUERY_RESERVED_FIELDS, QuadTree, Queue, RadixTree, RedBlackTree, RequestContext, SMTPProvider, SUPPORTED_OPERATORS, SegmentTree, ServiceClient, Set2 as Set, SinglyLinkedList, SparseTable, SplayTree, Stack, StaticArray, StaticTokenProvider, SuffixArray, SuffixTree, TemplateEngine, TernarySearchTree, TracingHeaders, TreeNode, Trie, ZodValidator, authMiddleware, createAllowedOrigins, createCorsOptions, createRequestContextMiddleware, days, errorToString, hours, isJoiSchema, isZodSchema, loadEnv, logger, milliseconds, minutes, pickFields, seconds, sleep, toHours, toMinutes, toSeconds, validate };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map