@be-link/shield-for-tcb-node-sdk 1.0.14 → 1.0.16

package/README.md

@@ -182,12 +182,78 @@ error 级别日志不受 `enableInfoLog` 影响，始终打印：
 |------|------|
 | `setup()` | 初始化并启动定时刷新，幂等操作 |
 | `getConfig<T>()` | 获取类型化的配置对象 |
+| `getValue<T>(key, defaultValue?)` | 根据 key 获取配置值，支持默认值 |
+| `isSwitchEnabled(key, defaultValue?)` | 获取布尔开关状态 |
+| `isHitGrey(configKey, identifier, defaultValue?)` | 判断是否命中灰度流量 |
 | `refresh()` | 手动触发一次配置刷新 |
 | `stop()` | 停止定时刷新，清理资源 |
 | `waitForSetup()` | 等待初始化完成 |
 | `isSetup` | 是否已完成初始化（只读属性） |
 | `config` | 当前缓存的配置（原始 Record，只读属性） |
 
+### 获取配置值
+
+```typescript
+// 获取配置（带默认值）
+const port = manager.getValue('API_PORT', 8090)
+
+// 获取配置并指定类型
+const isEnabled = manager.getValue<boolean>('FEATURE.ENABLED', false)
+```
+
+### 开关状态检查
+
+```typescript
+// 检查功能是否开启（支持 true/false, 1/0, yes/no, on/off 等多种格式）
+const isEnabled = manager.isSwitchEnabled('FEATURE.ENABLED')
+
+// 指定默认值为 true
+const isDebug = manager.isSwitchEnabled('DEBUG_MODE', true)
+```
+
+### 灰度流量控制
+
+```typescript
+// 流量控制配置结构
+interface TrafficControlConfig {
+  enabled: boolean           // 总开关
+  totalBuckets: number       // 总桶数
+  effectiveBuckets: number   // 生效桶数（0 到 effectiveBuckets-1 生效）
+  whitelist?: string[]       // 白名单（命中后视为生效）
+  blacklist?: string[]       // 黑名单（命中后视为不生效）
+}
+
+// 判断用户是否命中灰度流量
+const isHit = manager.isHitGrey('TRAFFIC_SPLIT', userId, false)
+if (isHit) {
+  // 灰度流量逻辑
+}
+```
+
+### 批量获取配置
+
+```typescript
+// 原始格式
+const configs = await backendConfigServiceV2.fetchConfigs({
+  service: 'TestService',
+  keys: ['TestServiceKey1', 'TestServiceKey2'],
+  env: 'local'
+})
+// 返回: { 'TestServiceKey1': { value: 'xxx', value_type: 'string' }, ... }
+
+// 自动解析类型（推荐）
+const values = await backendConfigServiceV2.getConfigValues(
+  'TestService',
+  ['TestServiceKey1', 'TestServiceKey2', 'TestServiceKey3'],
+  'local'
+)
+// 返回: {
+  //   'TestServiceKey1': 'xxx',
+  //   'TestServiceKey2': 123,
+  //   'TestServiceKey3': true
+  // }
+```
+
 ## 发布流程
 
 ### 自动发布（推荐）

package/modules/config/ShieldConfigManager.js

@@ -112,10 +112,10 @@ class ShieldConfigManager {
         }
         __classPrivateFieldSet(this, _ShieldConfigManager_serviceName, options.serviceName, "f");
         __classPrivateFieldSet(this, _ShieldConfigManager_env, options.env || process.env.NODE_ENV, "f");
-        __classPrivateFieldSet(this, _ShieldConfigManager_refreshIntervalMs, options.refreshIntervalMs ?? DEFAULT_REFRESH_INTERVAL_MS, "f");
-        __classPrivateFieldSet(this, _ShieldConfigManager_fetchTimeoutMs, options.fetchTimeoutMs ?? DEFAULT_FETCH_TIMEOUT_MS, "f");
-        __classPrivateFieldSet(this, _ShieldConfigManager_enableInfoLog, options.enableInfoLog ?? false, "f");
-        const baseLogger = options.logger ?? defaultLogger;
+        __classPrivateFieldSet(this, _ShieldConfigManager_refreshIntervalMs, options.refreshIntervalMs || DEFAULT_REFRESH_INTERVAL_MS, "f");
+        __classPrivateFieldSet(this, _ShieldConfigManager_fetchTimeoutMs, options.fetchTimeoutMs || DEFAULT_FETCH_TIMEOUT_MS, "f");
+        __classPrivateFieldSet(this, _ShieldConfigManager_enableInfoLog, options.enableInfoLog || false, "f");
+        const baseLogger = options.logger || defaultLogger;
         __classPrivateFieldSet(this, _ShieldConfigManager_logger, __classPrivateFieldGet(this, _ShieldConfigManager_enableInfoLog, "f") ? baseLogger : { ...baseLogger, info: () => { } }, "f");
     }
     /** 当前缓存的配置副本（原始 Record） */
@@ -181,7 +181,7 @@ class ShieldConfigManager {
      * @returns 泛型 T 类型的配置对象
      */
     getConfig() {
-        return __classPrivateFieldGet(this, _ShieldConfigManager_config, "f") ?? null;
+        return __classPrivateFieldGet(this, _ShieldConfigManager_config, "f") || null;
     }
     /**
      * 根据 config_key 获取对应的配置值

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@be-link/shield-for-tcb-node-sdk",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "ShieldForTCB Node.js SDK",
   "main": "index.js",
   "types": "index.d.ts",
@@ -15,7 +15,7 @@
     "access": "public"
   },
   "dependencies": {
-    "axios": "1.13.2",
+    "axios": "0.27.2",
     "axios-retry": "^4.0.0",
     "uuid": "^9.0.1"
   },

package/utils/http.js

@@ -44,7 +44,7 @@ const axios_retry_1 = __importDefault(require("axios-retry"));
 (0, axios_retry_1.default)(axios_1.default, {
     retries: 1,
     retryCondition(error) {
-        return error.response?.status === 502;
+        return !!(error.response && error.response.status === 502);
     },
     retryDelay: (retryCount) => {
         console.info(`retryCount: ${retryCount}, retryDelay: ${retryCount * 500}`);
@@ -65,7 +65,7 @@ async function callApi(url, request, options) {
         return responseData.data;
     }
     catch (error) {
-        if (options?.skipErrorHandling) {
+        if (options && options.skipErrorHandling) {
             throw error;
         }
         const axiosError = error;
@@ -114,7 +114,7 @@ async function getApi(url, options) {
         return responseData.data;
     }
     catch (error) {
-        if (options?.skipErrorHandling) {
+        if (options && options.skipErrorHandling) {
             throw error;
         }
         const axiosError = error;