@dofe/infra-clients 0.1.1

package/dist/plugin/utils/retry.util.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Retry Utility
+ *
+ * 提供 API 调用重试功能
+ */
+export interface RetryOptions {
+    /** 最大重试次数 */
+    maxRetries?: number;
+    /** 基础延迟时间 (ms) */
+    baseDelay?: number;
+    /** 最大延迟时间 (ms) */
+    maxDelay?: number;
+    /** 是否使用指数退避 */
+    exponentialBackoff?: boolean;
+    /** 重试条件判断函数 */
+    shouldRetry?: (error: any, attempt: number) => boolean;
+    /** 重试时的回调 */
+    onRetry?: (error: any, attempt: number) => void;
+}
+/**
+ * 带重试的异步函数执行器
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *     () => httpService.get('/api/data'),
+ *     { maxRetries: 3, baseDelay: 1000 }
+ * );
+ * ```
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+/**
+ * 创建可重试的函数包装器
+ *
+ * @example
+ * ```typescript
+ * const retryableRequest = createRetryable(
+ *     (url: string) => httpService.get(url),
+ *     { maxRetries: 3 }
+ * );
+ * const result = await retryableRequest('/api/data');
+ * ```
+ */
+export declare function createRetryable<T extends (...args: any[]) => Promise<any>>(fn: T, options?: RetryOptions): T;
+/**
+ * 批量请求并发控制
+ */
+export declare function batchRequest<T, R>(items: T[], handler: (item: T) => Promise<R>, concurrency?: number): Promise<R[]>;
+//# sourceMappingURL=retry.util.d.ts.map

package/dist/plugin/utils/retry.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.util.d.ts","sourceRoot":"","sources":["../../../src/plugin/utils/retry.util.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe;IACf,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACvD,aAAa;IACb,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AA2CD;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CA6BZ;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EACxE,EAAE,EAAE,CAAC,EACL,OAAO,GAAE,YAAiB,GACzB,CAAC,CAGH;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,CAAC,EACrC,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAChC,WAAW,GAAE,MAAU,GACtB,OAAO,CAAC,CAAC,EAAE,CAAC,CAsBd"}

package/dist/plugin/utils/retry.util.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Retry Utility
+ *
+ * 提供 API 调用重试功能
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withRetry = withRetry;
+exports.createRetryable = createRetryable;
+exports.batchRequest = batchRequest;
+const DEFAULT_OPTIONS = {
+    maxRetries: 3,
+    baseDelay: 1000,
+    maxDelay: 30000,
+    exponentialBackoff: true,
+    shouldRetry: (error) => {
+        // 默认重试网络错误和 5xx 错误
+        if (error.code === 'ECONNRESET' || error.code === 'ETIMEDOUT') {
+            return true;
+        }
+        const status = error.response?.status;
+        return status >= 500 && status < 600;
+    },
+    onRetry: () => { },
+};
+/**
+ * 计算延迟时间
+ */
+function calculateDelay(attempt, baseDelay, maxDelay, exponentialBackoff) {
+    if (!exponentialBackoff) {
+        return baseDelay;
+    }
+    // 指数退避 + 抖动
+    const exponentialDelay = baseDelay * Math.pow(2, attempt - 1);
+    const jitter = Math.random() * 0.3 * exponentialDelay;
+    return Math.min(exponentialDelay + jitter, maxDelay);
+}
+/**
+ * 延迟执行
+ */
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * 带重试的异步函数执行器
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *     () => httpService.get('/api/data'),
+ *     { maxRetries: 3, baseDelay: 1000 }
+ * );
+ * ```
+ */
+async function withRetry(fn, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    let lastError;
+    for (let attempt = 1; attempt <= opts.maxRetries + 1; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // 如果是最后一次尝试或不应该重试，直接抛出
+            if (attempt > opts.maxRetries || !opts.shouldRetry(error, attempt)) {
+                throw error;
+            }
+            // 计算延迟并等待
+            const delayMs = calculateDelay(attempt, opts.baseDelay, opts.maxDelay, opts.exponentialBackoff);
+            opts.onRetry(error, attempt);
+            await delay(delayMs);
+        }
+    }
+    throw lastError;
+}
+/**
+ * 创建可重试的函数包装器
+ *
+ * @example
+ * ```typescript
+ * const retryableRequest = createRetryable(
+ *     (url: string) => httpService.get(url),
+ *     { maxRetries: 3 }
+ * );
+ * const result = await retryableRequest('/api/data');
+ * ```
+ */
+function createRetryable(fn, options = {}) {
+    return ((...args) => withRetry(() => fn(...args), options));
+}
+/**
+ * 批量请求并发控制
+ */
+async function batchRequest(items, handler, concurrency = 5) {
+    const results = [];
+    const executing = [];
+    for (const item of items) {
+        const p = handler(item).then((result) => {
+            results.push(result);
+        });
+        executing.push(p);
+        if (executing.length >= concurrency) {
+            await Promise.race(executing);
+            executing.splice(executing.findIndex((e) => e === p), 1);
+        }
+    }
+    await Promise.all(executing);
+    return results;
+}
+//# sourceMappingURL=retry.util.js.map

package/dist/plugin/utils/retry.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.util.js","sourceRoot":"","sources":["../../../src/plugin/utils/retry.util.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@dofe/infra-clients",
+  "version": "0.1.1",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "peerDependencies": {
+    "@nestjs/axios": "^4.0.0",
+    "@nestjs/common": "^11.0.0",
+    "@nestjs/config": "^4.0.0",
+    "@nestjs/core": "^11.0.0",
+    "@dofe/infra-contracts": "^0.1.1",
+    "@dofe/infra-docker": "^0.1.1",
+    "@dofe/infra-shared-services": "^0.1.1",
+    "axios": "^1.7.0",
+    "reflect-metadata": "^0.2.0",
+    "rxjs": "^7.8.0",
+    "nest-winston": "^1.9.7",
+    "winston": "^3.13.0",
+    "class-validator": "^0.14.1",
+    "zod": "^4.3.6",
+    "uuid": "^11.1.0",
+    "@aws-sdk/client-s3": "^3.978.0",
+    "@aws-sdk/client-sts": "^3.1024.0",
+    "@aws-sdk/s3-request-presigner": "^3.978.0",
+    "@google-cloud/storage": "^7.12.0",
+    "nodemailer": "^7.0.3",
+    "qiniu": "^7.12.0",
+    "@volcengine/tos-sdk": "^2.7.6",
+    "lodash": "^4.17.21",
+    "ws": "^8.18.3",
+    "class-transformer": "^0.5.1"
+  },
+  "dependencies": {
+    "@dofe/infra-common": "^0.1.1",
+    "@dofe/infra-redis": "^0.1.1",
+    "@dofe/infra-utils": "^0.1.1"
+  },
+  "devDependencies": {
+    "rimraf": "^5.0.0",
+    "typescript": "^5.4.5"
+  },
+  "type": "commonjs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist"
+  }
+}