@dangao/bun-server 3.2.0 → 3.3.1

package/docs/microservice-nacos.md

@@ -5,6 +5,7 @@ This document introduces how to use Nacos as a configuration center and service
 ## Table of Contents
 
 - [Overview](#overview)
+- [Namespace](#namespace)
 - [Nacos Installation](#nacos-installation)
 - [Configuration Center Integration](#configuration-center-integration)
 - [Service Registry Integration](#service-registry-integration)
@@ -20,6 +21,26 @@ Bun Server Framework provides Nacos 3.X support through the `@dangao/nacos-clien
 - **Service Discovery**: Service instance querying and watching
 - **Open API**: Based on Nacos 3.X Open API implementation
 
+## Namespace
+
+The default namespace shown as **public** in the Nacos console maps to an **empty string** `""` in the Open API, not the literal `"public"`.
+
+`@dangao/nacos-client` **0.1.2+** automatically sends `namespaceId=` (empty value) when `namespaceId` is not configured, for both configuration and service discovery. Versions 0.1.1 and earlier omitted the parameter entirely, causing Nacos 3.x to return `code=20004`.
+
+**Recommended**: omit `namespaceId` in client config for the public namespace:
+
+```typescript
+nacos: {
+  client: {
+    serverList: ['http://localhost:8848'],
+    username: 'nacos',
+    password: 'nacos',
+  },
+},
+```
+
+For a custom namespace, pass the ID from the console (usually a UUID). If you patched `@dangao/nacos-client@0.1.1` with `bun patch`, remove `patchedDependencies` and the patch file after upgrading to 0.1.2+.
+
 ## Nacos Installation
 
 ### Docker Installation (Recommended)
@@ -48,7 +69,6 @@ app.registerModule(
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],
-        namespaceId: 'public',
         username: 'nacos',
         password: 'nacos',
       },
@@ -125,7 +145,6 @@ app.registerModule(
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],
-        namespaceId: 'public',
         username: 'nacos',
         password: 'nacos',
       },
@@ -197,7 +216,6 @@ import {
 
 const instances = await serviceRegistry.getInstances('user-service', {
   healthyOnly: true,
-  namespaceId: 'public',
 });
 
 // Watch for service instance changes
@@ -226,7 +244,6 @@ ConfigCenterModule.forRoot({
   nacos: {
     client: {
       serverList: ['http://localhost:8848'],
-      namespaceId: 'public',
       username: 'nacos',
       password: 'nacos',
     },
@@ -239,7 +256,6 @@ ServiceRegistryModule.forRoot({
   nacos: {
     client: {
       serverList: ['http://localhost:8848'],
-      namespaceId: 'public',
       username: 'nacos',
       password: 'nacos',
     },
@@ -337,6 +353,17 @@ await app.listen(3000);
 - Check if configuration watch callback is correctly implemented
 - Check logs to confirm if configuration changes are detected
 
+### 6. Public Namespace Returns 20004
+
+**Issue**: `getConfig` or service registration/discovery returns `code=20004` when `namespaceId` is not configured
+
+**Cause**: Nacos 3.x requires `namespaceId=` (empty value) in requests; `@dangao/nacos-client` 0.1.1 and earlier omitted the parameter
+
+**Solutions**:
+- Upgrade `@dangao/nacos-client` to **0.1.2+** (pulled in via framework dependency, or pin explicitly in downstream projects)
+- Remove any `bun patch` workaround
+- Do not set `namespaceId` to the literal `"public"`; public maps to an empty string—omit the config instead
+
 ## Reference Resources
 
 - [Nacos Official Documentation](https://nacos.io/docs/latest/)

package/docs/microservice-service-registry.md

@@ -22,6 +22,8 @@ Service registration and discovery provides core capabilities in microservice ar
 - **Health Check**: Automatically update service health status based on health check results
 - **Instance Watching**: Watch for service instance changes
 
+> **Namespace**: Omit `namespaceId` for the Nacos public namespace. See [Nacos Integration - Namespace](./microservice-nacos.md#namespace).
+
 ## Quick Start
 
 ### 1. Register Service Registry Module
@@ -39,7 +41,6 @@ app.registerModule(
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],
-        namespaceId: 'public',
         username: 'nacos',
         password: 'nacos',
       },
@@ -95,7 +96,6 @@ The simplest way is to use the `@ServiceRegistry` decorator:
     region: 'us-east',
   },
   clusterName: 'default',
-  namespaceId: 'public',
   groupName: 'DEFAULT_GROUP',
 })
 @Controller('/api/users')
@@ -113,7 +113,7 @@ class UserController {
 - `healthy`: Initial health status
 - `metadata`: Service metadata (version, region, etc.)
 - `clusterName`: Cluster name
-- `namespaceId`: Namespace
+- `namespaceId`: Namespace ID; omit for public (empty string). See [Nacos Integration - Namespace](./microservice-nacos.md#namespace)
 - `groupName`: Group name
 
 ### Manual Registration
@@ -182,7 +182,6 @@ import type { ServiceInstance } from '@dangao/bun-server';
 class MyService {
   @ServiceDiscovery('user-service', {
     healthyOnly: true, // Only get healthy instances
-    namespaceId: 'public',
     groupName: 'DEFAULT_GROUP',
   })
   public instances: ServiceInstance[] = [];
@@ -200,7 +199,6 @@ class MyService {
 // Get service instance list
 const instances = await serviceRegistry.getInstances('user-service', {
   healthyOnly: true,
-  namespaceId: 'public',
   groupName: 'DEFAULT_GROUP',
   clusterName: 'default',
 });
@@ -214,7 +212,6 @@ const unsubscribe = serviceRegistry.watchInstances(
     updateLocalCache(newInstances);
   },
   {
-    namespaceId: 'public',
     groupName: 'DEFAULT_GROUP',
   },
 );

package/docs/microservice.md

@@ -40,7 +40,6 @@ app.registerModule(
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],
-        namespaceId: 'public',
         username: 'nacos',
         password: 'nacos',
       },
@@ -55,7 +54,6 @@ app.registerModule(
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],
-        namespaceId: 'public',
         username: 'nacos',
         password: 'nacos',
       },
@@ -230,7 +228,6 @@ class MyService {
 ```typescript
 const instances = await serviceRegistry.getInstances('user-service', {
   healthyOnly: true,
-  namespaceId: 'public',
 });
 
 // Watch for service instance changes

package/docs/zh/microservice-config-center.md

@@ -21,6 +21,8 @@
 - **配置优先级**：配置中心配置 > 环境变量 > 默认配置
 - **配置监听**：监听配置变更，自动刷新应用配置
 
+> **命名空间**：使用 Nacos public 命名空间（控制台默认）时，省略 `namespaceId` 即可。请勿设为字面量 `"public"`。详见 [Nacos 集成文档 - 命名空间](./microservice-nacos.md#命名空间)。
+
 ## 快速开始
 
 ### 1. 注册配置中心模块
@@ -37,7 +39,6 @@ app.registerModule(
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],
-        namespaceId: 'public',
         username: 'nacos',
         password: 'nacos',
       },

package/docs/zh/microservice-nacos.md

@@ -5,6 +5,7 @@
 ## 目录
 
 - [概述](#概述)
+- [命名空间](#命名空间)
 - [Nacos 安装](#nacos-安装)
 - [配置中心集成](#配置中心集成)
 - [服务注册中心集成](#服务注册中心集成)
@@ -20,6 +21,26 @@ Bun Server Framework 通过 `@dangao/nacos-client` 包提供 Nacos 3.X 支持，
 - **服务发现**：服务实例查询和监听
 - **Open API**：基于 Nacos 3.X Open API 实现
 
+## 命名空间
+
+Nacos 控制台默认命名空间显示为 **public**，但其 Open API 中的 ID 是**空字符串** `""`，不是字面量 `"public"`。
+
+`@dangao/nacos-client` **0.1.2+** 在未配置 `namespaceId` 时会自动在请求中附带 `namespaceId=`（空值），适用于配置读取与服务发现。0.1.1 及更早版本会完全省略该参数，导致 Nacos 3.x 返回 `code=20004`。
+
+**推荐做法**：使用 public 命名空间时，省略客户端配置中的 `namespaceId`：
+
+```typescript
+nacos: {
+  client: {
+    serverList: ['http://localhost:8848'],
+    username: 'nacos',
+    password: 'nacos',
+  },
+},
+```
+
+自定义命名空间时传入控制台中的 ID（通常为 UUID）。若曾对 `@dangao/nacos-client@0.1.1` 使用 `bun patch`，升级至 0.1.2+ 后请移除 `patchedDependencies` 及对应 patch 文件。
+
 ## Nacos 安装
 
 ### Docker 安装（推荐）
@@ -48,7 +69,6 @@ app.registerModule(
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],
-        namespaceId: 'public',
         username: 'nacos',
         password: 'nacos',
       },
@@ -125,7 +145,6 @@ app.registerModule(
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],
-        namespaceId: 'public',
         username: 'nacos',
         password: 'nacos',
       },
@@ -197,7 +216,6 @@ import {
 
 const instances = await serviceRegistry.getInstances('user-service', {
   healthyOnly: true,
-  namespaceId: 'public',
 });
 
 // 监听服务实例变更
@@ -226,7 +244,6 @@ ConfigCenterModule.forRoot({
   nacos: {
     client: {
       serverList: ['http://localhost:8848'],
-      namespaceId: 'public',
       username: 'nacos',
       password: 'nacos',
     },
@@ -239,7 +256,6 @@ ServiceRegistryModule.forRoot({
   nacos: {
     client: {
       serverList: ['http://localhost:8848'],
-      namespaceId: 'public',
       username: 'nacos',
       password: 'nacos',
     },
@@ -337,6 +353,17 @@ await app.listen(3000);
 - 检查配置监听回调是否正确实现
 - 查看日志确认配置变更是否被检测到
 
+### 6. public 命名空间返回 20004
+
+**问题**：未配置 `namespaceId` 时，`getConfig` / 服务注册或发现返回 `code=20004`
+
+**原因**：Nacos 3.x 要求请求携带 `namespaceId=`（空值）；0.1.1 及更早的 `@dangao/nacos-client` 会完全省略该参数
+
+**解决方案**：
+- 升级 `@dangao/nacos-client` 至 **0.1.2+**（框架依赖会自动带入，也可在下游项目中显式升级）
+- 移除 `bun patch`（如有）
+- 不要将 `namespaceId` 设为字面量 `"public"`；public 对应空字符串，推荐直接省略配置
+
 ## 参考资源
 
 - [Nacos 官方文档](https://nacos.io/docs/latest/)

package/docs/zh/microservice-service-registry.md

@@ -22,6 +22,8 @@
 - **健康检查**：自动根据健康检查状态更新服务健康状态
 - **实例监听**：监听服务实例变更
 
+> **命名空间**：使用 Nacos public 命名空间时省略 `namespaceId`。详见 [Nacos 集成文档 - 命名空间](./microservice-nacos.md#命名空间)。
+
 ## 快速开始
 
 ### 1. 注册服务注册中心模块
@@ -39,7 +41,6 @@ app.registerModule(
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],
-        namespaceId: 'public',
         username: 'nacos',
         password: 'nacos',
       },
@@ -94,7 +95,6 @@ await app.listen(3000);
     region: 'us-east',
   },
   clusterName: 'default',
-  namespaceId: 'public',
   groupName: 'DEFAULT_GROUP',
 })
 @Controller('/api/users')
@@ -112,7 +112,7 @@ class UserController {
 - `healthy`：初始健康状态
 - `metadata`：服务元数据（版本、区域等）
 - `clusterName`：集群名
-- `namespaceId`：命名空间
+- `namespaceId`：命名空间 ID；省略表示 public（空字符串）。详见 [Nacos 集成文档 - 命名空间](./microservice-nacos.md#命名空间)
 - `groupName`：分组名
 
 ### 手动注册
@@ -181,7 +181,6 @@ import type { ServiceInstance } from '@dangao/bun-server';
 class MyService {
   @ServiceDiscovery('user-service', {
     healthyOnly: true, // 只获取健康实例
-    namespaceId: 'public',
     groupName: 'DEFAULT_GROUP',
   })
   public instances: ServiceInstance[] = [];
@@ -199,7 +198,6 @@ class MyService {
 // 获取服务实例列表
 const instances = await serviceRegistry.getInstances('user-service', {
   healthyOnly: true,
-  namespaceId: 'public',
   groupName: 'DEFAULT_GROUP',
   clusterName: 'default',
 });
@@ -213,7 +211,6 @@ const unsubscribe = serviceRegistry.watchInstances(
     updateLocalCache(newInstances);
   },
   {
-    namespaceId: 'public',
     groupName: 'DEFAULT_GROUP',
   },
 );

package/docs/zh/microservice.md

@@ -40,7 +40,6 @@ app.registerModule(
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],
-        namespaceId: 'public',
         username: 'nacos',
         password: 'nacos',
       },
@@ -55,7 +54,6 @@ app.registerModule(
     nacos: {
       client: {
         serverList: ['http://localhost:8848'],
-        namespaceId: 'public',
         username: 'nacos',
         password: 'nacos',
       },
@@ -230,7 +228,6 @@ class MyService {
 ```typescript
 const instances = await serviceRegistry.getInstances('user-service', {
   healthyOnly: true,
-  namespaceId: 'public',
 });
 
 // 监听服务实例变更

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dangao/bun-server",
-  "version": "3.2.0",
+  "version": "3.3.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -48,7 +48,7 @@
     "test:bun": "bun test tests/platform/bun",
     "test:node": "vitest run tests/platform/node",
     "test:platform": "bun run test:bun && bun run test:node",
-    "type-check": "tsc --noEmit",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit && tsc -p tsconfig.test.json --noEmit",
     "clean": "rm -rf dist",
     "bundle": "bun build src/index.ts --target=bun --format=esm --outfile=dist/index.js --external reflect-metadata --external @dangao/logsmith --external @dangao/nacos-client --external @vscode/sqlite3",
     "bundle:node": "bun build src/index.ts --target=node --packages=external --outfile=dist/index.node.mjs",
@@ -79,7 +79,7 @@
   },
   "dependencies": {
     "@dangao/logsmith": "0.2.0",
-    "@dangao/nacos-client": "0.1.1",
+    "@dangao/nacos-client": "0.1.2",
     "json5": "^2.2.3",
     "jsonc-parser": "^3.3.1",
     "marked": "^18.0.0",
@@ -88,4 +88,4 @@
     "postgres": "^3.4.9",
     "reflect-metadata": "^0.2.2"
   }
-}
+}

package/src/ai/types.ts

@@ -144,6 +144,11 @@ export const AI_SERVICE_TOKEN = Symbol('@dangao/bun-server:ai:service');
 export const AI_MODULE_OPTIONS_TOKEN = Symbol('@dangao/bun-server:ai:options');
 export const AI_TOOL_REGISTRY_TOKEN = Symbol('@dangao/bun-server:ai:tool-registry');
 
+/**
+ * Metadata key for AiModule options.
+ */
+export const MODULE_METADATA_KEY = '@dangao/bun-server:ai:module';
+
 /**
  * Metadata key for @AiTool decorator
  */

package/src/auth/types.ts

@@ -93,6 +93,10 @@ export interface OAuth2Client {
    * 允许的授权类型
    */
   grantTypes: ('authorization_code' | 'refresh_token')[];
+  /**
+   * 允许的 OAuth2 scope 列表
+   */
+  scopes?: string[];
 }
 
 /**
@@ -245,4 +249,3 @@ export interface AuthContext {
    */
   isAuthenticated: boolean;
 }
-

package/src/cache/interceptors.ts

@@ -91,8 +91,8 @@ export class CacheableInterceptor extends BaseInterceptor {
   public async execute<T>(
     target: unknown,
     propertyKey: string | symbol,
-    originalMethod: (...args: unknown[]) => T | Promise<T>,
-    args: unknown[],
+    originalMethod: (...args: any[]) => T | Promise<T>,
+    args: any[],
     container: Container,
     context?: Context,
   ): Promise<T> {
@@ -164,8 +164,8 @@ export class CacheEvictInterceptor extends BaseInterceptor {
   public async execute<T>(
     target: unknown,
     propertyKey: string | symbol,
-    originalMethod: (...args: unknown[]) => T | Promise<T>,
-    args: unknown[],
+    originalMethod: (...args: any[]) => T | Promise<T>,
+    args: any[],
     container: Container,
     context?: Context,
   ): Promise<T> {
@@ -238,8 +238,8 @@ export class CachePutInterceptor extends BaseInterceptor {
   public async execute<T>(
     target: unknown,
     propertyKey: string | symbol,
-    originalMethod: (...args: unknown[]) => T | Promise<T>,
-    args: unknown[],
+    originalMethod: (...args: any[]) => T | Promise<T>,
+    args: any[],
     container: Container,
     context?: Context,
   ): Promise<T> {

package/src/cache/service-proxy.ts

@@ -87,9 +87,9 @@ export class CacheServiceProxy {
 
         // 返回包装后的方法
         // 使用原型方法以确保拦截器能获取到正确的元数据
-        const originalMethod = prototypeMethod as (...args: unknown[]) => unknown;
+        const originalMethod = prototypeMethod as (...args: any[]) => unknown;
 
-        return async function (this: T, ...args: unknown[]): Promise<unknown> {
+        return async function (this: T, ...args: any[]): Promise<unknown> {
           // 按优先级执行拦截器：CacheEvict (beforeInvocation) -> Cacheable/CachePut -> CacheEvict (afterInvocation)
 
           // 如果有 @CacheEvict 且配置了 beforeInvocation

package/src/cache/service.ts

@@ -13,11 +13,14 @@ export class CacheService {
   private keyPrefix: string;
 
   public constructor(
-    @Inject(CACHE_OPTIONS_TOKEN) options: CacheModuleOptions,
+    @Inject(CACHE_OPTIONS_TOKEN) options: CacheModuleOptions | CacheStore,
   ) {
-    this.store = options.store!;
-    this.defaultTtl = options.defaultTtl ?? 3600000; // 1 小时
-    this.keyPrefix = options.keyPrefix ?? '';
+    const resolvedOptions: CacheModuleOptions = isCacheStore(options)
+      ? { store: options }
+      : options;
+    this.store = resolvedOptions.store!;
+    this.defaultTtl = resolvedOptions.defaultTtl ?? 3600000; // 1 小时
+    this.keyPrefix = resolvedOptions.keyPrefix ?? '';
   }
 
   /**
@@ -25,7 +28,7 @@ export class CacheService {
    * @param key - 缓存键
    * @returns 缓存值，如果不存在则返回 undefined
    */
-  public async get<T = unknown>(key: string): Promise<T | undefined> {
+  public async get<T = any>(key: string): Promise<T | undefined> {
     return this.store.get<T>(this.getKey(key));
   }
 
@@ -36,7 +39,7 @@ export class CacheService {
    * @param ttl - 过期时间（毫秒），0 表示永不过期，undefined 使用默认 TTL
    * @returns 是否设置成功
    */
-  public async set<T = unknown>(
+  public async set<T = any>(
     key: string,
     value: T,
     ttl?: number,
@@ -76,7 +79,7 @@ export class CacheService {
    * @param keys - 缓存键数组
    * @returns 缓存值映射
    */
-  public async getMany<T = unknown>(
+  public async getMany<T = any>(
     keys: string[],
   ): Promise<Map<string, T>> {
     const prefixedKeys = keys.map((k) => this.getKey(k));
@@ -97,7 +100,7 @@ export class CacheService {
    * @param ttl - 过期时间（毫秒），0 表示永不过期，undefined 使用默认 TTL
    * @returns 是否设置成功
    */
-  public async setMany<T = unknown>(
+  public async setMany<T = any>(
     entries: Array<{ key: string; value: T }>,
     ttl?: number,
   ): Promise<boolean> {
@@ -149,3 +152,9 @@ export class CacheService {
     return this.keyPrefix ? `${this.keyPrefix}${key}` : key;
   }
 }
+
+function isCacheStore(value: CacheModuleOptions | CacheStore): value is CacheStore {
+  return typeof (value as CacheStore).get === 'function' &&
+    typeof (value as CacheStore).set === 'function' &&
+    typeof (value as CacheStore).delete === 'function';
+}

package/src/cache/types.ts

@@ -7,7 +7,7 @@ export interface CacheStore {
    * @param key - 缓存键
    * @returns 缓存值，如果不存在则返回 undefined
    */
-  get<T = unknown>(key: string): Promise<T | undefined>;
+  get<T = any>(key: string): Promise<T | undefined>;
 
   /**
    * 设置缓存值
@@ -16,7 +16,7 @@ export interface CacheStore {
    * @param ttl - 过期时间（毫秒），0 表示永不过期
    * @returns 是否设置成功
    */
-  set<T = unknown>(key: string, value: T, ttl?: number): Promise<boolean>;
+  set<T = any>(key: string, value: T, ttl?: number): Promise<boolean>;
 
   /**
    * 删除缓存
@@ -43,7 +43,7 @@ export interface CacheStore {
    * @param keys - 缓存键数组
    * @returns 缓存值映射
    */
-  getMany<T = unknown>(keys: string[]): Promise<Map<string, T>>;
+  getMany<T = any>(keys: string[]): Promise<Map<string, T>>;
 
   /**
    * 设置多个缓存值
@@ -51,7 +51,7 @@ export interface CacheStore {
    * @param ttl - 过期时间（毫秒），0 表示永不过期
    * @returns 是否设置成功
    */
-  setMany<T = unknown>(
+  setMany<T = any>(
     entries: Array<{ key: string; value: T }>,
     ttl?: number,
   ): Promise<boolean>;
@@ -84,7 +84,7 @@ export class MemoryCacheStore implements CacheStore {
     }
   }
 
-  public async get<T = unknown>(key: string): Promise<T | undefined> {
+  public async get<T = any>(key: string): Promise<T | undefined> {
     const entry = this.store.get(key);
     if (!entry) {
       return undefined;
@@ -99,7 +99,7 @@ export class MemoryCacheStore implements CacheStore {
     return entry.value as T;
   }
 
-  public async set<T = unknown>(
+  public async set<T = any>(
     key: string,
     value: T,
     ttl?: number,
@@ -133,7 +133,7 @@ export class MemoryCacheStore implements CacheStore {
     return true;
   }
 
-  public async getMany<T = unknown>(
+  public async getMany<T = any>(
     keys: string[],
   ): Promise<Map<string, T>> {
     const result = new Map<string, T>();
@@ -154,7 +154,7 @@ export class MemoryCacheStore implements CacheStore {
     return result;
   }
 
-  public async setMany<T = unknown>(
+  public async setMany<T = any>(
     entries: Array<{ key: string; value: T }>,
     ttl?: number,
   ): Promise<boolean> {
@@ -239,7 +239,7 @@ export class RedisCacheStore implements CacheStore {
     return `${this.keyPrefix}${key}`;
   }
 
-  public async get<T = unknown>(key: string): Promise<T | undefined> {
+  public async get<T = any>(key: string): Promise<T | undefined> {
     const value = await this.client.get(this.getKey(key));
     if (value === null) {
       return undefined;
@@ -251,7 +251,7 @@ export class RedisCacheStore implements CacheStore {
     }
   }
 
-  public async set<T = unknown>(
+  public async set<T = any>(
     key: string,
     value: T,
     ttl?: number,
@@ -296,7 +296,7 @@ export class RedisCacheStore implements CacheStore {
     }
   }
 
-  public async getMany<T = unknown>(
+  public async getMany<T = any>(
     keys: string[],
   ): Promise<Map<string, T>> {
     const result = new Map<string, T>();
@@ -325,7 +325,7 @@ export class RedisCacheStore implements CacheStore {
     return result;
   }
 
-  public async setMany<T = unknown>(
+  public async setMany<T = any>(
     entries: Array<{ key: string; value: T }>,
     ttl?: number,
   ): Promise<boolean> {

package/src/config/service.ts

@@ -67,12 +67,12 @@ export class ConfigService<TConfig extends Record<string, unknown> = Record<stri
    * 更新配置（用于配置中心动态刷新）
    * @param newConfig - 新配置对象
    */
-  public updateConfig(newConfig: TConfig): void {
-    this.config = newConfig;
+  public updateConfig(newConfig: TConfig | Record<string, unknown>): void {
+    this.config = newConfig as TConfig;
     // 通知所有监听器
     for (const listener of this.configUpdateListeners) {
       try {
-        listener(newConfig);
+        listener(this.config);
       } catch (error) {
         console.error('[ConfigService] Error in config update listener:', error);
       }
@@ -83,7 +83,7 @@ export class ConfigService<TConfig extends Record<string, unknown> = Record<stri
    * 合并配置（用于配置中心增量更新）
    * @param partialConfig - 部分配置对象
    */
-  public mergeConfig(partialConfig: Partial<TConfig>): void {
+  public mergeConfig(partialConfig: Partial<TConfig> | Record<string, unknown>): void {
     this.config = {
       ...this.config,
       ...partialConfig,
@@ -125,6 +125,8 @@ export class ConfigService<TConfig extends Record<string, unknown> = Record<stri
    * @param key - 配置键（如 "db.host"）
    * @param defaultValue - 默认值（可选）
    */
+  public get(key: string): any;
+  public get<T>(key: string, defaultValue?: T): T | undefined;
   public get<T = unknown>(key: string, defaultValue?: T): T | undefined {
     const namespacedKey = this.applyNamespace(key);
     const value = this.getValueByPath(this.config, namespacedKey);
@@ -138,6 +140,8 @@ export class ConfigService<TConfig extends Record<string, unknown> = Record<stri
    * 获取必需的配置值，如果不存在则抛出错误
    * @param key - 配置键
    */
+  public getRequired(key: string): any;
+  public getRequired<T>(key: string): T;
   public getRequired<T = unknown>(key: string): T {
     const value = this.get<T>(key);
     if (value === undefined) {
@@ -191,5 +195,3 @@ export class ConfigService<TConfig extends Record<string, unknown> = Record<stri
     return current;
   }
 }
-
-