@lucaapp/service-utils 2.0.8 → 3.0.0

package/dist/index.d.ts

@@ -11,4 +11,5 @@ export * from './lib/wsEvent';
 export * from './lib/lifecycle';
 export * from './lib/logger';
 export * from './lib/datetime';
+export * from './lib/proxy';
 export * from './types';

package/dist/index.js

@@ -27,4 +27,5 @@ __exportStar(require("./lib/wsEvent"), exports);
 __exportStar(require("./lib/lifecycle"), exports);
 __exportStar(require("./lib/logger"), exports);
 __exportStar(require("./lib/datetime"), exports);
+__exportStar(require("./lib/proxy"), exports);
 __exportStar(require("./types"), exports);

package/dist/lib/datetime/dateConversion.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Converts a Date object or string to ISO date format (YYYY-MM-DD)
+ * Returns undefined if the input is null, undefined, or invalid
+ */
+export declare const toISODateString: (date: Date | string | null | undefined) => string | undefined;
+/**
+ * Converts an ISO date string to a Date object
+ * Returns undefined if the input is null, undefined, or invalid
+ */
+export declare const toDateObject: (date: string | null | undefined) => Date | undefined;

package/dist/lib/datetime/dateConversion.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toDateObject = exports.toISODateString = void 0;
+const moment_1 = __importDefault(require("moment"));
+const DATE_FORMAT_ISO = 'YYYY-MM-DD';
+/**
+ * Converts a Date object or string to ISO date format (YYYY-MM-DD)
+ * Returns undefined if the input is null, undefined, or invalid
+ */
+const toISODateString = (date) => {
+    if (!date)
+        return undefined;
+    const momentDate = (0, moment_1.default)(date);
+    if (!momentDate.isValid())
+        return undefined;
+    return momentDate.format(DATE_FORMAT_ISO);
+};
+exports.toISODateString = toISODateString;
+/**
+ * Converts an ISO date string to a Date object
+ * Returns undefined if the input is null, undefined, or invalid
+ */
+const toDateObject = (date) => {
+    if (!date)
+        return undefined;
+    const momentDate = (0, moment_1.default)(date);
+    if (!momentDate.isValid())
+        return undefined;
+    return momentDate.toDate();
+};
+exports.toDateObject = toDateObject;

package/dist/lib/datetime/index.d.ts

@@ -1 +1,2 @@
 export * from './datetime';
+export * from './dateConversion';

package/dist/lib/datetime/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./datetime"), exports);
+__exportStar(require("./dateConversion"), exports);

package/dist/lib/proxy/index.d.ts

@@ -0,0 +1 @@
+export * from './proxy';

package/dist/lib/proxy/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./proxy"), exports);

package/dist/lib/proxy/proxy.d.ts

@@ -0,0 +1,37 @@
+import { AxiosError, AxiosInstance, AxiosRequestConfig } from 'axios';
+import { HttpsProxyAgent } from 'https-proxy-agent';
+import https from 'https';
+export interface ProxyConfig {
+    https?: string | null;
+    http?: string | null;
+    retries?: number;
+    timeout?: number;
+}
+export interface ProxyClientOptions {
+    proxy?: string | null;
+    timeout?: number;
+    throttleRequestsPerSecond?: number;
+    rejectUnauthorized?: boolean;
+    retryCondition?: (error: AxiosError) => boolean;
+    onRetry?: (retryCount: number, error: AxiosError, requestConfig: AxiosRequestConfig) => void;
+}
+/**
+ * Creates an HTTPS proxy agent for the given proxy URL
+ */
+export declare const createHttpsProxyAgent: (proxy: string) => HttpsProxyAgent<string>;
+/**
+ * Creates a proxy-aware Axios client with configurable options
+ */
+export declare const createProxyClient: ({ proxy, timeout, throttleRequestsPerSecond, rejectUnauthorized, retryCondition, onRetry, }?: ProxyClientOptions) => AxiosInstance;
+/**
+ * Parses proxy configuration from URL string
+ */
+export declare const getProxyConfig: (proxyUrl?: string | null) => {
+    host: string;
+    port: number;
+} | undefined;
+/**
+ * Creates a proxy agent based on configuration
+ * Falls back to regular HTTPS agent if no proxy is configured
+ */
+export declare const createProxyAgent: (proxyUrl?: string | null, rejectUnauthorized?: boolean) => HttpsProxyAgent<string> | https.Agent;

package/dist/lib/proxy/proxy.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProxyAgent = exports.getProxyConfig = exports.createProxyClient = exports.createHttpsProxyAgent = void 0;
+const axios_1 = __importDefault(require("axios"));
+const axios_rate_limit_1 = __importDefault(require("axios-rate-limit"));
+const axios_retry_1 = __importDefault(require("axios-retry"));
+const https_proxy_agent_1 = require("https-proxy-agent");
+const https_1 = __importDefault(require("https"));
+/**
+ * Creates an HTTPS proxy agent for the given proxy URL
+ */
+const createHttpsProxyAgent = (proxy) => new https_proxy_agent_1.HttpsProxyAgent(proxy);
+exports.createHttpsProxyAgent = createHttpsProxyAgent;
+/**
+ * Default retry condition that excludes 429 Too Many Requests from retries
+ */
+const defaultRetryCondition = (error) => {
+    // Do not retry on 429 Too Many Requests
+    if (error.response && error.response.status === 429) {
+        return false;
+    }
+    return axios_retry_1.default.isNetworkOrIdempotentRequestError(error);
+};
+/**
+ * Creates a proxy-aware Axios client with configurable options
+ */
+const createProxyClient = ({ proxy, timeout = 120000, throttleRequestsPerSecond, rejectUnauthorized = true, retryCondition = defaultRetryCondition, onRetry, } = {}) => {
+    const retryConfig = {
+        retries: 3,
+        retryDelay: axios_retry_1.default.exponentialDelay,
+        shouldResetTimeout: true,
+        retryCondition,
+        onRetry,
+    };
+    let client;
+    if (!proxy) {
+        // No proxy - create regular client
+        client = axios_1.default.create({
+            proxy: false,
+            timeout,
+            httpsAgent: new https_1.default.Agent({
+                rejectUnauthorized,
+            }),
+        });
+    }
+    else {
+        // With proxy - create proxy-aware client
+        client = axios_1.default.create({
+            httpsAgent: (0, exports.createHttpsProxyAgent)(proxy),
+            proxy: false,
+            timeout,
+        });
+    }
+    // Apply retry configuration
+    (0, axios_retry_1.default)(client, retryConfig);
+    // Apply rate limiting if specified
+    if (throttleRequestsPerSecond) {
+        (0, axios_rate_limit_1.default)(client, { maxRPS: throttleRequestsPerSecond });
+    }
+    return client;
+};
+exports.createProxyClient = createProxyClient;
+/**
+ * Parses proxy configuration from URL string
+ */
+const getProxyConfig = (proxyUrl) => {
+    if (!proxyUrl) {
+        return undefined;
+    }
+    try {
+        const { hostname, port } = new URL(proxyUrl);
+        return {
+            host: hostname,
+            port: Number(port) || 8080,
+        };
+    }
+    catch (error) {
+        console.error('Error parsing proxy URL:', error);
+        return undefined;
+    }
+};
+exports.getProxyConfig = getProxyConfig;
+/**
+ * Creates a proxy agent based on configuration
+ * Falls back to regular HTTPS agent if no proxy is configured
+ */
+const createProxyAgent = (proxyUrl, rejectUnauthorized = true) => {
+    if (proxyUrl) {
+        return (0, exports.createHttpsProxyAgent)(proxyUrl);
+    }
+    return new https_1.default.Agent({
+        rejectUnauthorized,
+    });
+};
+exports.createProxyAgent = createProxyAgent;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucaapp/service-utils",
-  "version": "2.0.8",
+  "version": "3.0.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -28,12 +28,15 @@
     "@types/node": "22.13.11",
     "@types/response-time": "^2.3.9",
     "@types/swagger-ui-express": "4.1.3",
-    "axios": "^1.8.2",
+    "axios": "^1.11.0",
+    "axios-rate-limit": "^1.4.0",
+    "axios-retry": "^4.5.0",
     "body-parser": "^2.2.0",
     "busboy": "^1.6.0",
     "cls-rtracer": "^2.6.3",
     "express": "4.21.2",
     "express-async-errors": "3.1.1",
+    "https-proxy-agent": "^7.0.6",
     "jose": "4.15.9",
     "kafkajs": "2.1.0",
     "libphonenumber-js": "1.9.44",
@@ -84,8 +87,8 @@
     "cookie": ">= 1.0.2",
     "string-width": "4.2.3",
     "@types/express": "4.17.23",
-    "esbuild": "^0.25.6",
-    "axios": "^1.8.2",
+    "esbuild": "^0.25.7",
+    "axios": "^1.11.0",
     "vite": "6.2.5"
   }
 }