@dangao/bun-server 1.3.0 → 1.4.0

package/dist/microservice/service-registry/types.d.ts

@@ -0,0 +1,121 @@
+/**
+ * 服务注册中心抽象接口
+ * 定义服务注册与发现的核心能力，不依赖具体实现
+ */
+export interface ServiceRegistry {
+    /**
+     * 注册服务实例
+     * @param instance - 服务实例信息
+     */
+    register(instance: ServiceInstance): Promise<void>;
+    /**
+     * 注销服务实例
+     * @param instance - 服务实例信息
+     */
+    deregister(instance: ServiceInstance): Promise<void>;
+    /**
+     * 续约服务实例（心跳）
+     * @param instance - 服务实例信息
+     */
+    renew(instance: ServiceInstance): Promise<void>;
+    /**
+     * 查询服务实例列表
+     * @param serviceName - 服务名
+     * @param options - 查询选项
+     * @returns 服务实例列表
+     */
+    getInstances(serviceName: string, options?: GetInstancesOptions): Promise<ServiceInstance[]>;
+    /**
+     * 监听服务实例变更
+     * @param serviceName - 服务名
+     * @param listener - 变更监听器
+     * @param options - 查询选项（可选）
+     * @returns 取消监听的函数
+     */
+    watchInstances(serviceName: string, listener: InstancesChangeListener, options?: GetInstancesOptions): () => void;
+    /**
+     * 关闭注册中心连接
+     */
+    close(): Promise<void>;
+}
+/**
+ * 服务实例信息
+ */
+export interface ServiceInstance {
+    /**
+     * 服务名
+     */
+    serviceName: string;
+    /**
+     * 实例 IP
+     */
+    ip: string;
+    /**
+     * 实例端口
+     */
+    port: number;
+    /**
+     * 权重（可选）
+     */
+    weight?: number;
+    /**
+     * 是否健康（可选）
+     */
+    healthy?: boolean;
+    /**
+     * 是否启用（可选）
+     */
+    enabled?: boolean;
+    /**
+     * 元数据（可选）
+     */
+    metadata?: Record<string, string>;
+    /**
+     * 集群名称（可选）
+     */
+    clusterName?: string;
+    /**
+     * 命名空间 ID（可选）
+     */
+    namespaceId?: string;
+    /**
+     * 分组名称（可选）
+     */
+    groupName?: string;
+}
+/**
+ * 服务实例查询选项
+ */
+export interface GetInstancesOptions {
+    /**
+     * 命名空间 ID（可选）
+     */
+    namespaceId?: string;
+    /**
+     * 分组名称（可选）
+     */
+    groupName?: string;
+    /**
+     * 集群名称（可选）
+     */
+    clusterName?: string;
+    /**
+     * 是否只返回健康实例（可选）
+     */
+    healthyOnly?: boolean;
+}
+/**
+ * 服务实例变更监听器
+ */
+export interface InstancesChangeListener {
+    /**
+     * 服务实例变更回调
+     * @param instances - 新的服务实例列表
+     */
+    (instances: ServiceInstance[]): void;
+}
+/**
+ * ServiceRegistry Token（用于依赖注入）
+ */
+export declare const SERVICE_REGISTRY_TOKEN: unique symbol;
+//# sourceMappingURL=types.d.ts.map

package/dist/microservice/service-registry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/microservice/service-registry/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;;;OAGG;IACH,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,YAAY,CACV,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAE9B;;;;;;OAMG;IACH,cAAc,CACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,uBAAuB,EACjC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,MAAM,IAAI,CAAC;IAEd;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAElC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;CACtC;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,eAAmC,CAAC"}

package/dist/microservice/tracing/collectors.d.ts

@@ -0,0 +1,27 @@
+import type { Span, TraceCollector } from './types';
+/**
+ * 控制台追踪收集器（用于调试）
+ */
+export declare class ConsoleTraceCollector implements TraceCollector {
+    collect(span: Span): void;
+}
+/**
+ * 内存追踪收集器（用于测试和开发）
+ */
+export declare class MemoryTraceCollector implements TraceCollector {
+    private readonly spans;
+    collect(span: Span): void;
+    /**
+     * 获取所有收集的 Span
+     */
+    getSpans(): Span[];
+    /**
+     * 清空收集的 Span
+     */
+    clear(): void;
+    /**
+     * 获取指定 Trace ID 的所有 Span
+     */
+    getSpansByTraceId(traceId: string): Span[];
+}
+//# sourceMappingURL=collectors.d.ts.map

package/dist/microservice/tracing/collectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectors.d.ts","sourceRoot":"","sources":["../../../src/microservice/tracing/collectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEpD;;GAEG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IACnD,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;CAUjC;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAE7B,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAIhC;;OAEG;IACI,QAAQ,IAAI,IAAI,EAAE;IAIzB;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACI,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE;CAGlD"}

package/dist/microservice/tracing/index.d.ts

@@ -0,0 +1,4 @@
+export { Tracer } from './tracer';
+export { ConsoleTraceCollector, MemoryTraceCollector } from './collectors';
+export { SpanStatus, SpanKind, type TraceId, type SpanId, type SpanContext, type Span, type SpanTags, type SpanEvent, type TracingOptions, type TraceCollector, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/microservice/tracing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/microservice/tracing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EACL,UAAU,EACV,QAAQ,EACR,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,SAAS,CAAC"}

package/dist/microservice/tracing/tracer.d.ts

@@ -0,0 +1,59 @@
+import { SpanKind, SpanStatus, type SpanId, type SpanContext, type Span, type SpanTags, type SpanEvent, type TracingOptions, type TraceCollector } from './types';
+/**
+ * 分布式追踪器
+ */
+export declare class Tracer {
+    private readonly options;
+    private readonly collectors;
+    private readonly activeSpans;
+    constructor(options?: TracingOptions);
+    /**
+     * 添加追踪数据收集器
+     */
+    addCollector(collector: TraceCollector): void;
+    /**
+     * 开始新的 Span
+     */
+    startSpan(name: string, kind?: SpanKind, parentContext?: SpanContext): Span;
+    /**
+     * 结束 Span
+     */
+    endSpan(spanId: SpanId, status?: SpanStatus, error?: Error): void;
+    /**
+     * 设置 Span 标签
+     */
+    setSpanTag(spanId: SpanId, key: string, value: string | number | boolean): void;
+    /**
+     * 设置 Span 标签（批量）
+     */
+    setSpanTags(spanId: SpanId, tags: SpanTags): void;
+    /**
+     * 添加 Span 事件
+     */
+    addSpanEvent(spanId: SpanId, event: Omit<SpanEvent, 'timestamp'>): void;
+    /**
+     * 获取当前 Span 上下文（用于传播）
+     */
+    getCurrentSpanContext(spanId: SpanId): SpanContext | undefined;
+    /**
+     * 从 HTTP 头中提取 Span 上下文
+     */
+    extractFromHeaders(headers: Record<string, string>): SpanContext | undefined;
+    /**
+     * 将 Span 上下文注入到 HTTP 头中
+     */
+    injectToHeaders(context: SpanContext): Record<string, string>;
+    /**
+     * 创建空的 Span（未启用追踪时使用）
+     */
+    private createEmptySpan;
+    /**
+     * 刷新所有收集器
+     */
+    flush(): Promise<void>;
+    /**
+     * 关闭追踪器
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=tracer.d.ts.map

package/dist/microservice/tracing/tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../../src/microservice/tracing/tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,UAAU,EAEV,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,SAAS,CAAC;AA4BjB;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGtB;IACF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;gBAEzC,OAAO,GAAE,cAAmB;IAS/C;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI;IAIpD;;OAEG;IACI,SAAS,CACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,QAA4B,EAClC,aAAa,CAAC,EAAE,WAAW,GAC1B,IAAI;IAyCP;;OAEG;IACI,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,UAA0B,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IA4BvF;;OAEG;IACI,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI;IAUtF;;OAEG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;IAUxD;;OAEG;IACI,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG,IAAI;IAa9E;;OAEG;IACI,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAKrE;;OAEG;IACI,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,WAAW,GAAG,SAAS;IAkBnF;;OAEG;IACI,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAiBpE;;OAEG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAYnC;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAepC"}

package/dist/microservice/tracing/types.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Trace ID 类型
+ */
+export type TraceId = string;
+/**
+ * Span ID 类型
+ */
+export type SpanId = string;
+/**
+ * Span 状态
+ */
+export declare enum SpanStatus {
+    /**
+     * 未设置
+     */
+    UNSET = "UNSET",
+    /**
+     * 成功
+     */
+    OK = "OK",
+    /**
+     * 错误
+     */
+    ERROR = "ERROR"
+}
+/**
+ * Span 类型
+ */
+export declare enum SpanKind {
+    /**
+     * 客户端（发起请求）
+     */
+    CLIENT = "CLIENT",
+    /**
+     * 服务端（处理请求）
+     */
+    SERVER = "SERVER",
+    /**
+     * 内部（内部操作）
+     */
+    INTERNAL = "INTERNAL"
+}
+/**
+ * Span 上下文
+ */
+export interface SpanContext {
+    /**
+     * Trace ID
+     */
+    traceId: TraceId;
+    /**
+     * Span ID
+     */
+    spanId: SpanId;
+    /**
+     * 父 Span ID（可选）
+     */
+    parentSpanId?: SpanId;
+    /**
+     * 是否采样
+     */
+    sampled?: boolean;
+    /**
+     * 标志位（用于传播）
+     */
+    flags?: number;
+}
+/**
+ * Span 标签
+ */
+export type SpanTags = Record<string, string | number | boolean>;
+/**
+ * Span 事件
+ */
+export interface SpanEvent {
+    /**
+     * 事件名称
+     */
+    name: string;
+    /**
+     * 时间戳（毫秒）
+     */
+    timestamp: number;
+    /**
+     * 事件属性
+     */
+    attributes?: Record<string, string | number | boolean>;
+}
+/**
+ * Span 数据
+ */
+export interface Span {
+    /**
+     * Span 上下文
+     */
+    context: SpanContext;
+    /**
+     * Span 名称
+     */
+    name: string;
+    /**
+     * Span 类型
+     */
+    kind: SpanKind;
+    /**
+     * 开始时间（毫秒）
+     */
+    startTime: number;
+    /**
+     * 结束时间（毫秒，可选）
+     */
+    endTime?: number;
+    /**
+     * 持续时间（毫秒）
+     */
+    duration?: number;
+    /**
+     * 状态
+     */
+    status: SpanStatus;
+    /**
+     * 错误信息（可选）
+     */
+    error?: Error;
+    /**
+     * 标签
+     */
+    tags?: SpanTags;
+    /**
+     * 事件列表
+     */
+    events?: SpanEvent[];
+    /**
+     * 子 Span 列表
+     */
+    children?: Span[];
+}
+/**
+ * 追踪配置选项
+ */
+export interface TracingOptions {
+    /**
+     * 采样率（0-1）
+     * @default 1.0
+     */
+    samplingRate?: number;
+    /**
+     * 是否启用追踪
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Trace ID 生成器
+     */
+    traceIdGenerator?: () => TraceId;
+    /**
+     * Span ID 生成器
+     */
+    spanIdGenerator?: () => SpanId;
+}
+/**
+ * 追踪数据收集器接口
+ */
+export interface TraceCollector {
+    /**
+     * 收集 Span 数据
+     * @param span - Span 数据
+     */
+    collect(span: Span): void | Promise<void>;
+    /**
+     * 刷新数据（可选）
+     */
+    flush?(): void | Promise<void>;
+    /**
+     * 关闭收集器
+     */
+    close?(): void | Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/microservice/tracing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/microservice/tracing/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B;;GAEG;AACH,oBAAY,UAAU;IACpB;;OAEG;IACH,KAAK,UAAU;IAEf;;OAEG;IACH,EAAE,OAAO;IAET;;OAEG;IACH,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,oBAAY,QAAQ;IAClB;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC;IAEjC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;OAEG;IACH,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B;;OAEG;IACH,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC"}

package/dist/request/request.d.ts

@@ -1,3 +1,4 @@
+import { type URLSearchParams, URL } from 'url';
 /**
  * 请求封装类
  * 扩展原生 Request，提供便捷方法

package/dist/request/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/request/request.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,cAAc;IACzB;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACH,SAAgB,GAAG,EAAE,GAAG,CAAC;IAEzB;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAgB,KAAK,EAAE,eAAe,CAAC;IAEvC;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,KAAK,CAAC,CAAU;IAExB;;OAEG;IACH,OAAO,CAAC,WAAW,CAAkB;gBAElB,OAAO,EAAE,OAAO;IASnC;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAQrC;;;OAGG;IACI,OAAO,IAAI,OAAO;IAIzB;;;;OAIG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI3C;;;OAGG;IACI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQ5C;;;;OAIG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAG7C"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/request/request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAEhD;;;GAGG;AACH,qBAAa,cAAc;IACzB;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACH,SAAgB,GAAG,EAAE,GAAG,CAAC;IAEzB;;OAEG;IACH,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,SAAgB,KAAK,EAAE,eAAe,CAAC;IAEvC;;OAEG;IACH,SAAgB,OAAO,EAAE,OAAO,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,KAAK,CAAC,CAAU;IAExB;;OAEG;IACH,OAAO,CAAC,WAAW,CAAkB;gBAElB,OAAO,EAAE,OAAO;IASnC;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAQrC;;;OAGG;IACI,OAAO,IAAI,OAAO;IAIzB;;;;OAIG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAI3C;;;OAGG;IACI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAQ5C;;;;OAIG;IACI,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAG7C"}

package/docs/microservice-config-center.md

@@ -0,0 +1,258 @@
+# 配置中心使用指南
+
+本文档介绍如何使用 Bun Server Framework 的配置中心功能。
+
+## 目录
+
+- [概述](#概述)
+- [快速开始](#快速开始)
+- [基本使用](#基本使用)
+- [配置热更新](#配置热更新)
+- [ConfigModule 集成](#configmodule-集成)
+- [装饰器使用](#装饰器使用)
+- [最佳实践](#最佳实践)
+
+## 概述
+
+配置中心提供了集中式配置管理能力，支持：
+
+- **动态配置**：从配置中心获取配置，支持配置热更新
+- **多环境支持**：通过命名空间和分组管理不同环境的配置
+- **配置优先级**：配置中心配置 > 环境变量 > 默认配置
+- **配置监听**：监听配置变更，自动刷新应用配置
+
+## 快速开始
+
+### 1. 注册配置中心模块
+
+```typescript
+import { Application } from '@dangao/bun-server';
+import { ConfigCenterModule } from '@dangao/bun-server';
+
+const app = new Application();
+
+app.registerModule(
+  ConfigCenterModule.forRoot({
+    provider: 'nacos',
+    nacos: {
+      client: {
+        serverList: ['http://localhost:8848'],
+        namespaceId: 'public',
+        username: 'nacos',
+        password: 'nacos',
+      },
+      watchInterval: 3000, // 配置轮询间隔（毫秒）
+    },
+  }),
+);
+```
+
+### 2. 使用配置中心
+
+```typescript
+import {
+  CONFIG_CENTER_TOKEN,
+  type ConfigCenter,
+} from '@dangao/bun-server';
+import { Inject, Injectable } from '@dangao/bun-server';
+
+@Injectable()
+class MyService {
+  public constructor(
+    @Inject(CONFIG_CENTER_TOKEN) private readonly configCenter: ConfigCenter,
+  ) {}
+
+  public async getConfig() {
+    const result = await this.configCenter.getConfig(
+      'my-config',
+      'DEFAULT_GROUP',
+    );
+    return JSON.parse(result.content);
+  }
+}
+```
+
+## 基本使用
+
+### 获取配置
+
+```typescript
+// 基本用法
+const config = await configCenter.getConfig('my-config', 'DEFAULT_GROUP');
+
+// 指定命名空间
+const config = await configCenter.getConfig(
+  'my-config',
+  'DEFAULT_GROUP',
+  'production',
+);
+```
+
+### 配置结果
+
+`getConfig` 返回 `ConfigResult` 对象：
+
+```typescript
+interface ConfigResult {
+  content: string;        // 配置内容
+  md5: string;           // 配置 MD5（用于判断是否变更）
+  lastModified: number;  // 最后修改时间（时间戳）
+  contentType: string;   // 内容类型
+}
+```
+
+### 监听配置变更
+
+```typescript
+const unsubscribe = configCenter.watchConfig(
+  'my-config',
+  'DEFAULT_GROUP',
+  (newConfig) => {
+    console.log('Config updated:', newConfig.content);
+    // 更新应用配置
+    updateAppConfig(JSON.parse(newConfig.content));
+  },
+);
+
+// 取消监听
+unsubscribe();
+```
+
+## 配置热更新
+
+配置中心支持配置热更新，通过轮询机制检测配置变更：
+
+```typescript
+ConfigCenterModule.forRoot({
+  provider: 'nacos',
+  nacos: {
+    watchInterval: 3000, // 每 3 秒检查一次配置变更
+  },
+});
+
+// 监听配置变更
+configCenter.watchConfig('my-config', 'DEFAULT_GROUP', (newConfig) => {
+  // 配置变更时自动调用
+  console.log('Config hot updated:', newConfig.content);
+});
+```
+
+## ConfigModule 集成
+
+ConfigModule 支持与配置中心深度集成，配置变更会自动刷新 ConfigService：
+
+```typescript
+import { ConfigModule } from '@dangao/bun-server';
+
+ConfigModule.forRoot({
+  defaultConfig: {
+    app: {
+      name: 'MyApp',
+      port: 3000,
+    },
+  },
+  configCenter: {
+    enabled: true,
+    configs: new Map([
+      ['app.name', { dataId: 'app-name', groupName: 'DEFAULT_GROUP' }],
+      ['app.port', { dataId: 'app-port', groupName: 'DEFAULT_GROUP' }],
+    ]),
+    configCenterPriority: true, // 配置中心配置优先级最高
+  },
+});
+
+// 使用 ConfigService
+import { CONFIG_SERVICE_TOKEN, ConfigService } from '@dangao/bun-server';
+
+@Injectable()
+class MyService {
+  public constructor(
+    @Inject(CONFIG_SERVICE_TOKEN) private readonly config: ConfigService,
+  ) {}
+
+  public getAppName() {
+    // 自动从配置中心获取，配置变更时自动更新
+    return this.config.get<string>('app.name');
+  }
+}
+```
+
+### 配置优先级
+
+- `configCenterPriority: true`（默认）：配置中心 > 环境变量 > 默认配置
+- `configCenterPriority: false`：默认配置 > 环境变量 > 配置中心
+
+## 装饰器使用
+
+### @ConfigCenterValue
+
+自动注入配置值：
+
+```typescript
+import { ConfigCenterValue, Injectable } from '@dangao/bun-server';
+
+@Injectable()
+class MyService {
+  @ConfigCenterValue('app-name', 'DEFAULT_GROUP', {
+    defaultValue: 'MyApp',
+    watch: true, // 监听配置变更
+  })
+  public appName: string = '';
+
+  public getAppName() {
+    return this.appName; // 自动从配置中心获取
+  }
+}
+```
+
+### @NacosValue
+
+Nacos 特定的配置值注入（便捷别名）：
+
+```typescript
+import { NacosValue, Injectable } from '@dangao/bun-server';
+
+@Injectable()
+class MyService {
+  @NacosValue('app-name', 'DEFAULT_GROUP', {
+    defaultValue: 'MyApp',
+  })
+  public appName: string = '';
+}
+```
+
+## 最佳实践
+
+### 1. 配置组织
+
+- **命名空间**：用于区分不同环境（dev、test、prod）
+- **分组**：用于逻辑分组（DEFAULT_GROUP、DATABASE_GROUP 等）
+- **DataId**：配置的唯一标识
+
+### 2. 配置格式
+
+- 推荐使用 JSON 格式存储配置
+- 支持纯文本配置（如 properties、yaml 等）
+
+### 3. 配置监听
+
+- 为关键配置启用监听（`watch: true`）
+- 配置变更时及时更新应用状态
+- 避免频繁的配置变更
+
+### 4. 错误处理
+
+- 配置获取失败时使用默认值
+- 记录配置获取错误日志
+- 实现配置降级策略
+
+### 5. 性能优化
+
+- 合理设置 `watchInterval`（建议 3-10 秒）
+- 使用配置缓存减少 API 调用
+- 批量获取配置（如果支持）
+
+## 示例
+
+完整示例请参考 `examples/microservice-app.ts`。
+