@be-link/ecommerce-backend-bff-service-node-sdk 0.0.1

package/bff/request/strategy.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 请求策略的抽象基类
+ * 定义所有请求策略的公共契约和共享实现
+ */
+export declare abstract class BaseRequestStrategy {
+    /**
+     * 运行环境配置
+     */
+    protected environment: 'production' | 'test';
+    /**
+     * 创建请求策略实例
+     * @param environment - 运行环境 ('production' 或 'test')
+     */
+    constructor(environment: 'production' | 'test');
+    /**
+     * 子类必须实现的请求方法
+     */
+    abstract request<T>(path: string, data?: any, headers?: Record<string, string>): Promise<T>;
+}
+/**
+ * Web/H5 请求策略，使用 axios 进行 HTTP 请求
+ * 为浏览器环境实现请求策略
+ */
+export declare class WebRequestStrategy extends BaseRequestStrategy {
+    /**
+     * 使用 axios 执行 HTTP POST 请求
+     * @param path - API 端点路径
+     * @param data - 请求负载（可选）
+     * @param headers - 要包含在请求中的额外请求头（可选）
+     * @returns Promise，解析为响应数据
+     * @throws BizError 如果是 4xx 客户端错误
+     * @throws SystemError 如果是 5xx 服务器错误或网络错误
+     */
+    request<T>(path: string, data?: any, headers?: Record<string, string>): Promise<T>;
+}
+/**
+ * 微信小程序请求策略，使用 wx.cloud.callContainer
+ * 为微信小程序环境实现请求策略
+ */
+export declare class MiniProgramRequestStrategy extends BaseRequestStrategy {
+    /**
+     * 使用微信云托管容器 API 执行请求
+     * @param path - API 端点路径
+     * @param data - 请求负载（可选）
+     * @param headers - 要包含在请求中的额外请求头（可选）
+     * @returns Promise，解析为响应数据
+     * @throws BizError 如果是 4xx 客户端错误
+     * @throws SystemError 如果是 5xx 服务器错误或微信 API 错误
+     */
+    request<T>(path: string, data?: any, headers?: Record<string, string>): Promise<T>;
+}

package/bff/request/strategy.js

@@ -0,0 +1,188 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MiniProgramRequestStrategy = exports.WebRequestStrategy = exports.BaseRequestStrategy = void 0;
+const axios_1 = __importDefault(require("axios"));
+const errors_1 = require("../../errors");
+const env_1 = require("../../utils/env");
+/**
+ * 请求策略的抽象基类
+ * 定义所有请求策略的公共契约和共享实现
+ */
+class BaseRequestStrategy {
+    /**
+     * 创建请求策略实例
+     * @param environment - 运行环境 ('production' 或 'test')
+     */
+    constructor(environment) {
+        this.environment = environment;
+    }
+}
+exports.BaseRequestStrategy = BaseRequestStrategy;
+/**
+ * Web/H5 请求策略，使用 axios 进行 HTTP 请求
+ * 为浏览器环境实现请求策略
+ */
+class WebRequestStrategy extends BaseRequestStrategy {
+    /**
+     * 使用 axios 执行 HTTP POST 请求
+     * @param path - API 端点路径
+     * @param data - 请求负载（可选）
+     * @param headers - 要包含在请求中的额外请求头（可选）
+     * @returns Promise，解析为响应数据
+     * @throws BizError 如果是 4xx 客户端错误
+     * @throws SystemError 如果是 5xx 服务器错误或网络错误
+     */
+    async request(path, data, headers = {}) {
+        const requestId = headers['X-Request-Id'] || 'unknown';
+        const url = `${(0, env_1.getContainerHost)(this.environment)}${path}`;
+        try {
+            if (console?.info) {
+                console.info(`[SDK][${requestId}] 发起请求: ${url}`, data ? `参数: ${JSON.stringify(data)}` : '');
+            }
+            const response = await axios_1.default.post(url, data, {
+                headers,
+                timeout: 60000, // 60 秒超时
+            });
+            // 检查响应是否表示成功
+            if (response.status >= 200 && response.status < 300) {
+                const responseData = response.data;
+                // 成功响应：返回完整响应对象（包含 data, message, success, requestId）
+                // 前端可以访问 result.data, result.message, result.success, result.requestId
+                return responseData;
+            }
+            // 非 2xx 状态码
+            const errorMessage = response.data?.message || '请求失败';
+            if (console?.error) {
+                console.error(`[SDK][${requestId}] HTTP 错误: ${errorMessage}`, `状态码: ${response.status}`);
+            }
+            const ErrorClass = response.status >= 400 && response.status < 500 ? errors_1.BizError : errors_1.SystemError;
+            throw new ErrorClass(errorMessage, response.status);
+        }
+        catch (error) {
+            // 如果已经是 SdkError（包括 BizError 和 SystemError），直接重新抛出
+            if (error instanceof errors_1.SdkError) {
+                throw error;
+            }
+            // 处理 axios 错误
+            if (axios_1.default.isAxiosError(error)) {
+                const axiosError = error;
+                const statusCode = axiosError.response?.status || 500;
+                const message = axiosError.response?.data?.message || axiosError.message || '请求失败';
+                if (console?.error) {
+                    console.error(`[SDK][${requestId}] Axios 错误: ${message}`);
+                    if (axiosError.response) {
+                        console.error(`[SDK][${requestId}] 响应状态: ${axiosError.response.status}`);
+                        console.error(`[SDK][${requestId}] 响应数据:`, JSON.stringify(axiosError.response.data));
+                    }
+                    else {
+                        console.error(`[SDK][${requestId}] 错误信息: ${axiosError.message}`);
+                    }
+                }
+                // 根据状态码选择错误类型
+                const ErrorClass = axiosError.response
+                    ? axiosError.response.status >= 400 && axiosError.response.status < 500
+                        ? errors_1.BizError
+                        : errors_1.SystemError
+                    : errors_1.SystemError;
+                throw new ErrorClass(message, statusCode);
+            }
+            // 处理其他未知错误
+            const errorMessage = error instanceof Error ? error.message : '发生未知错误';
+            if (console?.error) {
+                console.error(`[SDK][${requestId}] 未知错误: ${errorMessage}`);
+            }
+            throw new errors_1.SystemError(errorMessage, 500);
+        }
+    }
+}
+exports.WebRequestStrategy = WebRequestStrategy;
+/**
+ * 微信小程序请求策略，使用 wx.cloud.callContainer
+ * 为微信小程序环境实现请求策略
+ */
+class MiniProgramRequestStrategy extends BaseRequestStrategy {
+    /**
+     * 使用微信云托管容器 API 执行请求
+     * @param path - API 端点路径
+     * @param data - 请求负载（可选）
+     * @param headers - 要包含在请求中的额外请求头（可选）
+     * @returns Promise，解析为响应数据
+     * @throws BizError 如果是 4xx 客户端错误
+     * @throws SystemError 如果是 5xx 服务器错误或微信 API 错误
+     */
+    async request(path, data, headers = {}) {
+        const requestId = headers['X-Request-Id'] || 'unknown';
+        try {
+            // 类型守卫，确保 wx 可用
+            // 使用 any 类型避免类型定义冲突
+            const wxGlobal = typeof wx !== 'undefined' ? wx : null;
+            if (!wxGlobal || !wxGlobal.cloud) {
+                if (console?.error) {
+                    console.error(`[SDK][${requestId}] 微信小程序环境不可用`);
+                }
+                throw new errors_1.SystemError('微信小程序环境不可用', 500);
+            }
+            // 构造包含微信特定字段的请求头
+            const requestHeaders = {
+                ...headers,
+                'X-WX-SERVICE': (0, env_1.getContainerService)(this.environment),
+            };
+            if (console?.info) {
+                console.info(`[SDK][${requestId}] 发起小程序云调用: ${path}`, `环境: ${(0, env_1.getContainerEnv)(this.environment)}`, data ? `参数: ${JSON.stringify(data)}` : '');
+            }
+            // 调用微信云托管容器
+            const response = await wxGlobal.cloud.callContainer({
+                config: {
+                    env: (0, env_1.getContainerEnv)(this.environment),
+                },
+                path,
+                method: 'POST',
+                header: requestHeaders,
+                data,
+                timeout: 100000, // 100 秒超时
+            });
+            // 记录微信云调用 ID
+            if (console?.info && response.callID) {
+                console.info(`[SDK][${requestId}] 微信云调用 ID: ${response.callID}`);
+            }
+            // 检查响应状态码是否表示成功
+            if (response.statusCode >= 200 && response.statusCode < 300) {
+                const responseData = response.data;
+                // 成功响应：返回完整响应对象（包含 data, message, success, requestId）
+                // 前端可以访问 result.data, result.message, result.success, result.requestId
+                return responseData;
+            }
+            // 非 2xx 状态码
+            const errorMessage = response.data?.message || '请求失败';
+            if (console?.error) {
+                console.error(`[SDK][${requestId}] HTTP 错误: ${errorMessage}`, `状态码: ${response.statusCode}`, `微信云调用 ID: ${response.callID || 'unknown'}`, `响应数据: ${JSON.stringify(response.data)}`);
+            }
+            const ErrorClass = response.statusCode >= 400 && response.statusCode < 500 ? errors_1.BizError : errors_1.SystemError;
+            throw new ErrorClass(errorMessage, response.statusCode);
+        }
+        catch (error) {
+            // 如果已经是 SdkError（包括 BizError 和 SystemError），直接重新抛出
+            if (error instanceof errors_1.SdkError) {
+                throw error;
+            }
+            // 处理微信 API 错误
+            if (error && typeof error === 'object' && 'errMsg' in error) {
+                const errorMessage = error.errMsg || '微信 API 调用失败';
+                if (console?.error) {
+                    console.error(`[SDK][${requestId}] 微信 API 错误: ${errorMessage}`);
+                }
+                throw new errors_1.SystemError(errorMessage, 500);
+            }
+            // 处理其他未知错误
+            const errorMessage = error instanceof Error ? error.message : '发生未知错误';
+            if (console?.error) {
+                console.error(`[SDK][${requestId}] 未知错误: ${errorMessage}`);
+            }
+            throw new errors_1.SystemError(errorMessage, 500);
+        }
+    }
+}
+exports.MiniProgramRequestStrategy = MiniProgramRequestStrategy;

package/errors/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * SDK 相关错误的基础错误类
+ * 扩展标准 Error 类，添加 HTTP 状态码
+ */
+export declare class SdkError extends Error {
+    readonly statusCode: number;
+    /**
+     * 创建新的 SdkError 实例
+     * @param message - 人类可读的错误描述
+     * @param statusCode - 失败请求的 HTTP 状态码
+     */
+    constructor(message: string, statusCode: number);
+}
+/**
+ * 业务错误类 - 用于 4xx 客户端错误
+ * 通常表示请求参数错误、权限不足等业务层面的问题
+ */
+export declare class BizError extends SdkError {
+    constructor(message: string, statusCode?: number);
+}
+/**
+ * 系统错误类 - 用于 5xx 服务器错误
+ * 通常表示服务器内部错误、网络问题等系统层面的问题
+ */
+export declare class SystemError extends SdkError {
+    constructor(message: string, statusCode?: number);
+}

package/errors/index.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemError = exports.BizError = exports.SdkError = void 0;
+/**
+ * SDK 相关错误的基础错误类
+ * 扩展标准 Error 类，添加 HTTP 状态码
+ */
+class SdkError extends Error {
+    /**
+     * 创建新的 SdkError 实例
+     * @param message - 人类可读的错误描述
+     * @param statusCode - 失败请求的 HTTP 状态码
+     */
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = 'SdkError';
+        // 维护错误抛出位置的正确堆栈跟踪（仅在 V8 上可用）
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, SdkError);
+        }
+    }
+}
+exports.SdkError = SdkError;
+/**
+ * 业务错误类 - 用于 4xx 客户端错误
+ * 通常表示请求参数错误、权限不足等业务层面的问题
+ */
+class BizError extends SdkError {
+    constructor(message, statusCode = 400) {
+        super(message, statusCode);
+        this.name = 'BizError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, BizError);
+        }
+    }
+}
+exports.BizError = BizError;
+/**
+ * 系统错误类 - 用于 5xx 服务器错误
+ * 通常表示服务器内部错误、网络问题等系统层面的问题
+ */
+class SystemError extends SdkError {
+    constructor(message, statusCode = 500) {
+        super(message, statusCode);
+        this.name = 'SystemError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, SystemError);
+        }
+    }
+}
+exports.SystemError = SystemError;

package/index.d.ts

@@ -0,0 +1,54 @@
+import { ExampleService } from './bff/modules/example/service';
+import DemoService from './bff/modules/demo/service';
+import type { SdkOptions } from './types';
+/**
+ * EcommerceBackendBffSDK - 统一平台 SDK 的主入口
+ * 支持 Web/H5 和微信小程序环境
+ *
+ * @example
+ * ```typescript
+ * // Web/H5 环境 - 生产环境
+ * const sdk = new EcommerceBackendBffSDK({
+ *   getToken: async () => localStorage.getItem('token') || '',
+ *   getUserId: async () => localStorage.getItem('userId') || '',
+ *   environment: 'production'
+ * })
+ *
+ * // 小程序环境 - 测试环境
+ * const sdk = new EcommerceBackendBffSDK({
+ *   getToken: async () => wx.getStorageSync('token') || '',
+ *   getUserId: async () => wx.getStorageSync('userId') || '',
+ *   environment: 'test'
+ * })
+ *
+ * // 使用服务模块
+ * const profile = await sdk.example.getUserProfile('user123')
+ * const demoResult = await sdk.demo.demoFunc({ demoParam: 'test' })
+ * ```
+ */
+export declare class EcommerceBackendBffSDK {
+    /**
+     * HttpClient 实例，管理平台特定的请求策略
+     */
+    private http;
+    /**
+     * 示例服务模块，演示 SDK 使用模式
+     */
+    example: ExampleService;
+    /**
+     * Demo 服务模块（从旧版 config 服务迁移而来）
+     */
+    demo: DemoService;
+    /**
+     * 使用配置选项初始化 SDK
+     * @param options - SDK 配置，包含凭证回调函数
+     */
+    constructor(options: SdkOptions);
+}
+export { default as DemoService } from './bff/modules/demo/service';
+export { ExampleService } from './bff/modules/example/service';
+export type { Service as DemoControllerTypes } from './bff/modules/demo/types';
+export type { Service as EcommerceBackendBffServiceControllerTypes } from './bff/modules/demo/types';
+export type { Service as ExampleServiceTypes } from './bff/modules/example/types';
+export { SdkError, BizError, SystemError } from './errors';
+export type { SdkOptions, IRequestStrategy, StandardResponse } from './types';

package/index.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SystemError = exports.BizError = exports.SdkError = exports.ExampleService = exports.DemoService = exports.EcommerceBackendBffSDK = void 0;
+const client_1 = require("./bff/request/client");
+const service_1 = require("./bff/modules/example/service");
+const service_2 = __importDefault(require("./bff/modules/demo/service"));
+/**
+ * EcommerceBackendBffSDK - 统一平台 SDK 的主入口
+ * 支持 Web/H5 和微信小程序环境
+ *
+ * @example
+ * ```typescript
+ * // Web/H5 环境 - 生产环境
+ * const sdk = new EcommerceBackendBffSDK({
+ *   getToken: async () => localStorage.getItem('token') || '',
+ *   getUserId: async () => localStorage.getItem('userId') || '',
+ *   environment: 'production'
+ * })
+ *
+ * // 小程序环境 - 测试环境
+ * const sdk = new EcommerceBackendBffSDK({
+ *   getToken: async () => wx.getStorageSync('token') || '',
+ *   getUserId: async () => wx.getStorageSync('userId') || '',
+ *   environment: 'test'
+ * })
+ *
+ * // 使用服务模块
+ * const profile = await sdk.example.getUserProfile('user123')
+ * const demoResult = await sdk.demo.demoFunc({ demoParam: 'test' })
+ * ```
+ */
+class EcommerceBackendBffSDK {
+    /**
+     * 使用配置选项初始化 SDK
+     * @param options - SDK 配置，包含凭证回调函数
+     */
+    constructor(options) {
+        // 使用提供的选项初始化 HttpClient
+        this.http = new client_1.HttpClient(options);
+        // 使用 HttpClient 实例化所有服务模块
+        this.example = new service_1.ExampleService(this.http);
+        this.demo = new service_2.default(this.http);
+    }
+}
+exports.EcommerceBackendBffSDK = EcommerceBackendBffSDK;
+// 导出服务类以便直接实例化（如需要）
+var service_3 = require("./bff/modules/demo/service");
+Object.defineProperty(exports, "DemoService", { enumerable: true, get: function () { return __importDefault(service_3).default; } });
+var service_4 = require("./bff/modules/example/service");
+Object.defineProperty(exports, "ExampleService", { enumerable: true, get: function () { return service_4.ExampleService; } });
+// 错误类
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "SdkError", { enumerable: true, get: function () { return errors_1.SdkError; } });
+Object.defineProperty(exports, "BizError", { enumerable: true, get: function () { return errors_1.BizError; } });
+Object.defineProperty(exports, "SystemError", { enumerable: true, get: function () { return errors_1.SystemError; } });

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@be-link/ecommerce-backend-bff-service-node-sdk",
+  "version": "0.0.1",
+  "description": "EcommerceBackendBffService Node.js SDK",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "author": "",
+  "license": "ISC",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "axios": "1.13.2"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "jest": "^29.5.0",
+    "ts-jest": "^29.1.0",
+    "tsoa": "^6.6.0",
+    "typescript": "^5.0.0"
+  },
+  "scripts": {
+    "build": "rm -rf ./dist && tsc && cp package.json README.md ./dist/ 2>/dev/null || true",
+    "test": "jest --passWithNoTests",
+    "test:coverage": "jest --coverage --passWithNoTests",
+    "swagger": "tsoa spec",
+    "build:swagger": "npm run swagger && npm run build && npm run swagger"
+  }
+}

package/types/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * SDK 初始化的配置选项
+ */
+export interface SdkOptions {
+    /**
+     * 获取认证令牌的回调函数
+     * 可以是同步或异步的
+     */
+    getToken: () => string | Promise<string>;
+    /**
+     * 获取用户 ID 的回调函数
+     * 可以是同步或异步的
+     */
+    getUserId: () => string | Promise<string>;
+    /**
+     * 运行环境配置（必传）
+     * - 'production': 生产环境
+     * - 'test': 测试环境
+     */
+    environment: 'production' | 'test';
+}
+/**
+ * 后端标准响应格式
+ * 所有 API 响应都遵循此格式
+ */
+export interface StandardResponse<T> {
+    /**
+     * 业务数据
+     */
+    data: T;
+    /**
+     * 响应消息
+     */
+    message: string;
+    /**
+     * 是否成功
+     */
+    success: boolean;
+    /**
+     * 请求 ID，用于追踪和调试
+     */
+    requestId: string;
+}
+/**
+ * 平台特定请求策略的接口
+ * 实现处理 Web/H5 HTTP 请求或微信小程序云托管容器调用
+ */
+export interface IRequestStrategy {
+    /**
+     * 向后端服务执行请求
+     * @param path - API 端点路径（例如 '/api/v1/user/get-profile'）
+     * @param data - 请求负载（可选）
+     * @param headers - 额外的自定义请求头（可选）
+     * @returns Promise，解析为响应数据
+     */
+    request<T>(path: string, data?: any, headers?: Record<string, string>): Promise<T>;
+}

package/types/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/utils/env.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 检测运行时环境是否为微信小程序
+ * @returns 如果在微信小程序环境中运行则返回 true
+ */
+export declare function isMiniProgram(): boolean;
+/**
+ * 根据环境获取容器主机 URL
+ * @param environment - 运行环境 ('production' 或 'test')
+ * @returns 容器主机 URL
+ */
+export declare function getContainerHost(environment: 'production' | 'test'): string;
+/**
+ * 根据环境获取微信云环境标识符
+ * @param environment - 运行环境 ('production' 或 'test')
+ * @returns 云环境标识符
+ */
+export declare function getContainerEnv(environment: 'production' | 'test'): string;
+/**
+ * 根据环境获取微信云服务名称
+ * @param environment - 运行环境 ('production' 或 'test')
+ * @returns 云服务名称
+ */
+export declare function getContainerService(environment: 'production' | 'test'): string;

package/utils/env.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMiniProgram = isMiniProgram;
+exports.getContainerHost = getContainerHost;
+exports.getContainerEnv = getContainerEnv;
+exports.getContainerService = getContainerService;
+/**
+ * 检测运行时环境是否为微信小程序
+ * @returns 如果在微信小程序环境中运行则返回 true
+ */
+function isMiniProgram() {
+    return typeof wx !== 'undefined' && !!wx.cloud;
+}
+/**
+ * 根据环境获取容器主机 URL
+ * @param environment - 运行环境 ('production' 或 'test')
+ * @returns 容器主机 URL
+ */
+function getContainerHost(environment) {
+    // 生产环境和测试环境使用不同的主机地址
+    return environment === 'production'
+        ? 'http://bxbvjnca.tfs.cwl9ok0a.mk2u3r3l.com:8090' // 生产环境
+        : 'http://bxbvjnca.tfs.cwl9ok0a.mk2u3r3l.com:8090'; // 测试环境
+}
+/**
+ * 根据环境获取微信云环境标识符
+ * @param environment - 运行环境 ('production' 或 'test')
+ * @returns 云环境标识符
+ */
+function getContainerEnv(environment) {
+    return environment === 'production' ? 'prod-1g8x9y7z' : 'test-2h3j4k5l';
+}
+/**
+ * 根据环境获取微信云服务名称
+ * @param environment - 运行环境 ('production' 或 'test')
+ * @returns 云服务名称
+ */
+function getContainerService(environment) {
+    return environment === 'production' ? 'bff-container-prod' : 'bff-container-test';
+}

package/utils/http.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 旧版 callApi 函数，用于向后兼容
+ * @deprecated 请改用新的 HttpClient 和服务模块
+ */
+export declare function callApi<T extends (...args: any[]) => Promise<any>>(url: string, request?: Parameters<T>[0]): Promise<Awaited<ReturnType<T>>>;

package/utils/http.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callApi = callApi;
+const axios_1 = __importDefault(require("axios"));
+/**
+ * 生成简单的请求 ID
+ */
+function generateRequestId() {
+    return `req_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
+/**
+ * 旧版 callApi 函数，用于向后兼容
+ * @deprecated 请改用新的 HttpClient 和服务模块
+ */
+async function callApi(url, request) {
+    const requestId = generateRequestId();
+    try {
+        console.info(`准备发起ecommerce-backend-bff-service请求[${requestId}]: ${url}, 参数: ${JSON.stringify(request)}`);
+        const response = await axios_1.default.post(url, request, { headers: { 'x-request-id': requestId } });
+        const responseData = response.data;
+        return responseData.data;
+    }
+    catch (error) {
+        const axiosError = error;
+        if (axiosError.response) {
+            const response = axiosError.response;
+            const data = response.data;
+            console.error(`ecommerce-backend-bff-service 异常: ${axiosError.message},requestId: ${requestId}`);
+            console.info('响应信息', data.message);
+            console.error('异常堆栈', JSON.stringify(error.stack));
+            throw new Error(data.errorType + ' - ' + data.message);
+        }
+        console.error(`ecommerce-backend-bff-service 未知异常: ${axiosError.message}`, error.stack);
+        throw error;
+    }
+}

package/utils/string.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 将驼峰命名字符串转换为短横线命名
+ * @param str 驼峰命名字符串
+ * @returns 短横线命名字符串
+ * @example
+ * camelToKebabCase('fetchConfig') // 'fetch-config'
+ * camelToKebabCase('getCosTempSecret') // 'get-cos-temp-secret'
+ * camelToKebabCase('getUserProfile') // 'get-user-profile'
+ * camelToKebabCase('API') // 'api'
+ * camelToKebabCase('myHTTPRequest') // 'my-http-request'
+ */
+export declare function camelToKebabCase(str: string): string;

package/utils/string.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.camelToKebabCase = camelToKebabCase;
+/**
+ * 将驼峰命名字符串转换为短横线命名
+ * @param str 驼峰命名字符串
+ * @returns 短横线命名字符串
+ * @example
+ * camelToKebabCase('fetchConfig') // 'fetch-config'
+ * camelToKebabCase('getCosTempSecret') // 'get-cos-temp-secret'
+ * camelToKebabCase('getUserProfile') // 'get-user-profile'
+ * camelToKebabCase('API') // 'api'
+ * camelToKebabCase('myHTTPRequest') // 'my-http-request'
+ */
+function camelToKebabCase(str) {
+    return str
+        .replace(/([A-Z])/g, '-$1')
+        .toLowerCase()
+        .replace(/^-/, ''); // 如果存在则移除前导连字符
+}