gateway

type ClientAuthType string

type FieldSourceKeys struct {
	Header string
	Query  string
	Cookie string
}

type GRPC struct {
	Server  *GRPCServer            `mapstructure:"server" yaml:"server" json:"server"`    // GRPC服务端配置
	Clients map[string]*GRPCClient `mapstructure:"clients" yaml:"clients" json:"clients"` // GRPC客户端配置（key为服务名）
}

type GRPCClient struct {
	ServiceName           string           `mapstructure:"service-name" yaml:"service-name" json:"serviceName"`                                   // 服务名称
	Endpoints             []string         `mapstructure:"endpoints" yaml:"endpoints" json:"endpoints"`                                           // 服务端点列表
	Network               string           `mapstructure:"network" yaml:"network" json:"network"`                                                 // 网络类型 (tcp, tcp4, tcp6, unix)
	MaxRecvMsgSize        int              `mapstructure:"max-recv-msg-size" yaml:"max-recv-msg-size" json:"maxRecvMsgSize"`                      // 最大接收消息大小(字节)
	MaxSendMsgSize        int              `mapstructure:"max-send-msg-size" yaml:"max-send-msg-size" json:"maxSendMsgSize"`                      // 最大发送消息大小(字节)
	KeepaliveTime         int              `mapstructure:"keepalive-time" yaml:"keepalive-time" json:"keepaliveTime"`                             // Keepalive时间(秒)
	KeepaliveTimeout      int              `mapstructure:"keepalive-timeout" yaml:"keepalive-timeout" json:"keepaliveTimeout"`                    // Keepalive超时(秒)
	ConnectionTimeout     int              `mapstructure:"connection-timeout" yaml:"connection-timeout" json:"connectionTimeout"`                 // 连接超时(秒)
	RetryTimes            int              `mapstructure:"retry-times" yaml:"retry-times" json:"retryTimes"`                                      // 重试次数
	EnableLoadBalance     bool             `mapstructure:"enable-load-balance" yaml:"enable-load-balance" json:"enableLoadBalance"`               // 是否启用负载均衡
	LoadBalancePolicy     string           `mapstructure:"load-balance-policy" yaml:"load-balance-policy" json:"loadBalancePolicy"`               // 负载均衡策略
	EnableBreaker         bool             `mapstructure:"enable-breaker" yaml:"enable-breaker" json:"enableBreaker"`                             // 是否启用客户端熔断（默认关闭，未启用时拦截器不入链）
	BreakerKeyMode        string           `mapstructure:"breaker-key-mode" yaml:"breaker-key-mode" json:"breakerKeyMode"`                        // 客户端熔断键粒度 (target_method / target / method)，非法值由使用方回落默认
	EnableTLS             bool             `mapstructure:"enable-tls" yaml:"enable-tls" json:"enableTls"`                                         // 是否启用TLS
	TLSCertFile           string           `mapstructure:"tls-cert-file" yaml:"tls-cert-file" json:"tlsCertFile"`                                 // TLS证书文件
	TLSKeyFile            string           `mapstructure:"tls-key-file" yaml:"tls-key-file" json:"tlsKeyFile"`                                    // TLS密钥文件
	TLSCAFile             string           `mapstructure:"tls-ca-file" yaml:"tls-ca-file" json:"tlsCaFile"`                                       // TLS CA文件
	InitialWindowSize     int32            `mapstructure:"initial-window-size" yaml:"initial-window-size" json:"initialWindowSize"`               // HTTP/2 初始窗口大小（字节）
	InitialConnWindowSize int32            `mapstructure:"initial-conn-window-size" yaml:"initial-conn-window-size" json:"initialConnWindowSize"` // HTTP/2 初始连接窗口大小（字节）
	WaitForReady          bool             `mapstructure:"wait-for-ready" yaml:"wait-for-ready" json:"waitForReady"`                              // 是否等待连接就绪
	EnableCompression     bool             `mapstructure:"enable-compression" yaml:"enable-compression" json:"enableCompression"`                 // 是否启用压缩
	CompressionType       GRPCCompressType `mapstructure:"compression-type" yaml:"compression-type" json:"compressionType"`                       // 压缩算法类型 (gzip, snappy, zstd)
}

type GRPCCompressType string

type GRPCServer struct {
	Enable             bool             `mapstructure:"enable" yaml:"enable" json:"enable"`                                         // 是否启用GRPC服务
	Host               string           `mapstructure:"host" yaml:"host" json:"host"`                                               // 主机地址
	Port               int              `mapstructure:"port" yaml:"port" json:"port"`                                               // 端口
	Network            string           `mapstructure:"network" yaml:"network" json:"network"`                                      // 网络类型 (tcp, tcp4, tcp6, unix)
	MaxRecvMsgSize     int              `mapstructure:"max-recv-msg-size" yaml:"max-recv-msg-size" json:"maxRecvMsgSize"`           // 最大接收消息大小(字节)
	MaxSendMsgSize     int              `mapstructure:"max-send-msg-size" yaml:"max-send-msg-size" json:"maxSendMsgSize"`           // 最大发送消息大小(字节)
	KeepaliveTime      int              `mapstructure:"keepalive-time" yaml:"keepalive-time" json:"keepaliveTime"`                  // Keepalive时间(秒)
	KeepaliveTimeout   int              `mapstructure:"keepalive-timeout" yaml:"keepalive-timeout" json:"keepaliveTimeout"`         // Keepalive超时(秒)
	ConnectionTimeout  int              `mapstructure:"connection-timeout" yaml:"connection-timeout" json:"connectionTimeout"`      // 连接超时(秒)
	EnableReflection   bool             `mapstructure:"enable-reflection" yaml:"enable-reflection" json:"enableReflection"`         // 是否启用反射
	EnableProtobufResp bool             `mapstructure:"enable-protobuf-resp" yaml:"enable-protobuf-resp" json:"enableProtobufResp"` // 是否启用protobuf格式响应（grpc-gateway场景下默认返回JSON，开启后返回原始protobuf）
	EnableCompression  bool             `mapstructure:"enable-compression" yaml:"enable-compression" json:"enableCompression"`      // 是否启用压缩
	CompressionType    GRPCCompressType `mapstructure:"compression-type" yaml:"compression-type" json:"compressionType"`            // 压缩算法类型 (gzip, snappy, zstd)
	CompressionLevel   int              `mapstructure:"compression-level" yaml:"compression-level" json:"compressionLevel"`         // 压缩级别 (gzip: 1-9, zstd: 1-22, snappy: 忽略此值)
	MinCompressSize    int              `mapstructure:"min-compress-size" yaml:"min-compress-size" json:"minCompressSize"`          // 最小压缩大小(字节)，小于此大小不压缩
	Endpoint           string           `mapstructure:"-" yaml:"-" json:""`                                                         // 完整的服务端点地址（自动计算）
}

type Gateway struct {
	ModuleName     string                       `mapstructure:"module-name" yaml:"module-name" json:"moduleName"`             // 模块名称
	Name           string                       `mapstructure:"name" yaml:"name" json:"name"`                                 // 网关名称
	Enabled        bool                         `mapstructure:"enabled" yaml:"enabled" json:"enabled"`                        // 是否启用网关
	Debug          bool                         `mapstructure:"debug" yaml:"debug" json:"debug"`                              // 是否启用调试模式
	Version        string                       `mapstructure:"version" yaml:"version" json:"version"`                        // 版本号
	Environment    string                       `mapstructure:"environment" yaml:"environment" json:"environment"`            // 环境 (dev, test, prod)
	BuildTime      string                       `mapstructure:"build-time" yaml:"build-time" json:"buildTime"`                // 构建时间
	BuildUser      string                       `mapstructure:"build-user" yaml:"build-user" json:"buildUser"`                // 构建用户
	GoVersion      string                       `mapstructure:"go-version" yaml:"go-version" json:"goVersion"`                // Go版本
	GitCommit      string                       `mapstructure:"git-commit" yaml:"git-commit" json:"gitCommit"`                // Git提交哈希
	GitBranch      string                       `mapstructure:"git-branch" yaml:"git-branch" json:"gitBranch"`                // Git分支
	GitTag         string                       `mapstructure:"git-tag" yaml:"git-tag" json:"gitTag"`                         // Git标签
	JSON           *JSON                        `mapstructure:"json" yaml:"json" json:"json"`                                 // JSON序列化配置
	HTTPServer     *HTTPServer                  `mapstructure:"http" yaml:"http" json:"http"`                                 // HTTP服务器配置（主监听器）
	Listeners      []*Listener                  `mapstructure:"listeners" yaml:"listeners" json:"listeners"`                  // 命名监听器列表（支持多端口，如 Ops/Tenant 分离）
	GRPC           *GRPC                        `mapstructure:"grpc" yaml:"grpc" json:"grpc"`                                 // GRPC配置
	Cache          *cache.Cache                 `mapstructure:"cache" yaml:"cache" json:"cache"`                              // 缓存配置(包含Redis)
	Database       *database.Database           `mapstructure:"database" yaml:"database" json:"database"`                     // 数据库统一配置
	ClickHouse     *tsdb.ClickHouse             `mapstructure:"clickhouse" yaml:"clickhouse" json:"clickhouse"`               // ClickHouse数据库配置
	Etcd           *etcd.Etcd                   `mapstructure:"etcd" yaml:"etcd" json:"etcd"`                                 // Etcd配置
	Kafka          *kafka.Kafka                 `mapstructure:"kafka" yaml:"kafka" json:"kafka"`                              // Kafka配置
	Mqtt           *queue.Mqtt                  `mapstructure:"mqtt" yaml:"mqtt" json:"mqtt"`                                 // MQTT配置
	Nats           *queue.Nats                  `mapstructure:"nats" yaml:"nats" json:"nats"`                                 // NATS配置
	Elasticsearch  *elasticsearch.Elasticsearch `mapstructure:"elasticsearch" yaml:"elasticsearch" json:"elasticsearch"`      // Elasticsearch配置
	Smtp           *smtp.Smtp                   `mapstructure:"smtp" yaml:"smtp" json:"smtp"`                                 // SMTP邮件服务配置
	Health         *health.Health               `mapstructure:"health" yaml:"health" json:"health"`                           // 健康检查配置
	Monitoring     *monitoring.Monitoring       `mapstructure:"monitoring" yaml:"monitoring" json:"monitoring"`               // 监控配置
	Security       *security.Security           `mapstructure:"security" yaml:"security" json:"security"`                     // 安全配置
	RequestContext *RequestContext              `mapstructure:"request-context" yaml:"request-context" json:"requestContext"` // 统一请求提取配置
	Middleware     *middleware.Middleware       `mapstructure:"middleware" yaml:"middleware" json:"middleware"`               // 中间件配置
	CORS           *cors.Cors                   `mapstructure:"cors" yaml:"cors" json:"cors"`                                 // CORS配置
	JWT            *jwt.JWT                     `mapstructure:"jwt" yaml:"jwt" json:"jwt"`                                    // JWT配置
	Swagger        *swagger.Swagger             `mapstructure:"swagger" yaml:"swagger" json:"swagger"`                        // Swagger配置
	Banner         *banner.Banner               `mapstructure:"banner" yaml:"banner" json:"banner"`                           // Banner配置
	RateLimit      *ratelimit.RateLimit         `mapstructure:"rate-limit" yaml:"rate-limit" json:"rateLimit"`                // 限流配置
	WSC            *wsc.WSC                     `mapstructure:"wsc" yaml:"wsc" json:"wsc"`                                    // WebSocket通信配置
	Jobs           *jobs.Jobs                   `mapstructure:"jobs" yaml:"jobs" json:"jobs"`                                 // Job调度配置
	Extensions     map[string]any               `mapstructure:"extensions" yaml:"extensions" json:"extensions"`               // 扩展配置字段，供第三方自定义使用
}

type HTTP2 struct {
	MaxConcurrentStreams  uint32 `mapstructure:"max-concurrent-streams" yaml:"max-concurrent-streams" json:"maxConcurrentStreams"`      // 单个连接最大并发流数
	MaxReadFrameSize      uint32 `mapstructure:"max-read-frame-size" yaml:"max-read-frame-size" json:"maxReadFrameSize"`                // 最大读取帧大小
	InitialWindowSize     int32  `mapstructure:"initial-window-size" yaml:"initial-window-size" json:"initialWindowSize"`               // 初始窗口大小
	InitialConnWindowSize int32  `mapstructure:"initial-conn-window-size" yaml:"initial-conn-window-size" json:"initialConnWindowSize"` // 初始连接窗口大小
}

type HTTPServer struct {
	ModuleName           string            `mapstructure:"module-name" yaml:"module-name" json:"moduleName"`                                 // 模块名称
	Host                 string            `mapstructure:"host" yaml:"host" json:"host"`                                                     // 主机地址
	Port                 int               `mapstructure:"port" yaml:"port" json:"port"`                                                     // 端口
	Network              string            `mapstructure:"network" yaml:"network" json:"network"`                                            // 网络类型: tcp, tcp4, tcp6
	ReadTimeout          int               `mapstructure:"read-timeout" yaml:"read-timeout" json:"readTimeout"`                              // 读取超时(秒)
	ReadHeaderTimeout    int               `mapstructure:"read-header-timeout" yaml:"read-header-timeout" json:"readHeaderTimeout"`          // 读取请求头超时(秒)，防止慢速攻击
	WriteTimeout         int               `mapstructure:"write-timeout" yaml:"write-timeout" json:"writeTimeout"`                           // 写入超时(秒)
	IdleTimeout          int               `mapstructure:"idle-timeout" yaml:"idle-timeout" json:"idleTimeout"`                              // 空闲超时(秒)
	MaxHeaderBytes       int               `mapstructure:"max-header-bytes" yaml:"max-header-bytes" json:"maxHeaderBytes"`                   // 最大请求头字节数
	EnableTls            bool              `mapstructure:"enable-tls" yaml:"enable-tls" json:"enableTls"`                                    // 是否启用TLS
	TLS                  *TLS              `mapstructure:"tls" yaml:"tls" json:"tls"`                                                        // TLS配置
	Headers              map[string]string `mapstructure:"headers" yaml:"headers" json:"headers"`                                            // 自定义头部
	Endpoint             string            `mapstructure:"-" yaml:"-" json:""`                                                               // 完整的服务端点地址（自动计算，不从配置文件读取）
	EnableGzipCompress   bool              `mapstructure:"enable-gzip-compress" yaml:"enable-gzip-compress" json:"enableGzipCompress"`       // 是否启用Gzip压缩
	GzipCompressionLevel int               `mapstructure:"gzip-compression-level" yaml:"gzip-compression-level" json:"gzipCompressionLevel"` // Gzip压缩级别 (1-9, 默认5)
	GzipMinSize          int               `mapstructure:"gzip-min-size" yaml:"gzip-min-size" json:"gzipMinSize"`                            // Gzip最小压缩大小（字节），小于此大小不压缩（默认1024）
	GzipSkipPaths        []string          `mapstructure:"gzip-skip-paths" yaml:"gzip-skip-paths" json:"gzipSkipPaths"`                      // Gzip跳过的路径前缀列表
	GzipSkipExtensions   []string          `mapstructure:"gzip-skip-extensions" yaml:"gzip-skip-extensions" json:"gzipSkipExtensions"`       // Gzip跳过的文件扩展名列表
	EnableHTTP2          bool              `mapstructure:"enable-http2" yaml:"enable-http2" json:"enableHttp2"`                              // 是否启用HTTP/2（h2c）
	HTTP2                *HTTP2            `mapstructure:"http2" yaml:"http2" json:"http2"`                                                  // HTTP/2配置
}

type JSON struct {
	UseProtoNames   bool `mapstructure:"use-proto-names" yaml:"use-proto-names" json:"useProtoNames"`     // 使用proto字段名(snake_case)，如 snake_case 而不是 snakeCase
	EmitUnpopulated bool `mapstructure:"emit-unpopulated" yaml:"emit-unpopulated" json:"emitUnpopulated"` // 输出所有字段，包括零值字段
	DiscardUnknown  bool `mapstructure:"discard-unknown" yaml:"discard-unknown" json:"discardUnknown"`    // 反序列化时忽略未知字段
}

type Listener struct {
	Name     string `mapstructure:"name" yaml:"name" json:"name"`          // 监听器名称（如 "ops", "tenant"）
	Host     string `mapstructure:"host" yaml:"host" json:"host"`          // 主机地址
	Port     int    `mapstructure:"port" yaml:"port" json:"port"`          // 端口
	Network  string `mapstructure:"network" yaml:"network" json:"network"` // 网络类型: tcp, tcp4, tcp6
	Endpoint string `mapstructure:"-" yaml:"-" json:""`                    // 完整端点地址（自动计算）
}

type RequestContext struct {
	// 标准请求头
	AuthorizationSources []common.AttributeSource `mapstructure:"authorization-sources" yaml:"authorization-sources" json:"authorizationSources"` // Authorization 提取来源
	AuthPayloadSources   []common.AttributeSource `mapstructure:"auth-payload-sources" yaml:"auth-payload-sources" json:"authPayloadSources"`     // Auth-Payload 提取来源
	JtiSources           []common.AttributeSource `mapstructure:"jti-sources" yaml:"jti-sources" json:"jtiSources"`                               // Jti 提取来源
	FamilyIdSources      []common.AttributeSource `mapstructure:"family-id-sources" yaml:"family-id-sources" json:"familyIdSources"`              // FamilyId 提取来源
	UserAgentSources     []common.AttributeSource `mapstructure:"user-agent-sources" yaml:"user-agent-sources" json:"userAgentSources"`           // User-Agent 提取来源
	AcceptSources        []common.AttributeSource `mapstructure:"accept-sources" yaml:"accept-sources" json:"acceptSources"`                      // Accept 提取来源
	CacheControlSources  []common.AttributeSource `mapstructure:"cache-control-sources" yaml:"cache-control-sources" json:"cacheControlSources"`  // Cache-Control 提取来源
	ConnectionSources    []common.AttributeSource `mapstructure:"connection-sources" yaml:"connection-sources" json:"connectionSources"`          // Connection 提取来源

	// 自定义请求头
	RequestIDSources      []common.AttributeSource `mapstructure:"request-id-sources" yaml:"request-id-sources" json:"requestIdSources"`                // X-Request-Id 提取来源
	TraceIDSources        []common.AttributeSource `mapstructure:"trace-id-sources" yaml:"trace-id-sources" json:"traceIdSources"`                      // X-Trace-Id 提取来源
	RealIPSources         []common.AttributeSource `mapstructure:"real-ip-sources" yaml:"real-ip-sources" json:"realIpSources"`                         // X-Real-IP 提取来源
	ForwardedForSources   []common.AttributeSource `mapstructure:"forwarded-for-sources" yaml:"forwarded-for-sources" json:"forwardedForSources"`       // X-Forwarded-For 提取来源
	ForwardedProtoSources []common.AttributeSource `mapstructure:"forwarded-proto-sources" yaml:"forwarded-proto-sources" json:"forwardedProtoSources"` // X-Forwarded-Proto 提取来源
	ForwardedHostSources  []common.AttributeSource `mapstructure:"forwarded-host-sources" yaml:"forwarded-host-sources" json:"forwardedHostSources"`    // X-Forwarded-Host 提取来源

	// 用户上下文相关头部
	ClientIDSources   []common.AttributeSource `mapstructure:"client-id-sources" yaml:"client-id-sources" json:"clientIdSources"`       // X-Client-ID 提取来源
	UserIDSources     []common.AttributeSource `mapstructure:"user-id-sources" yaml:"user-id-sources" json:"userIdSources"`             // X-User-ID 提取来源
	UserTypeSources   []common.AttributeSource `mapstructure:"user-type-sources" yaml:"user-type-sources" json:"userTypeSources"`       // X-User-Type 提取来源
	TenantIDSources   []common.AttributeSource `mapstructure:"tenant-id-sources" yaml:"tenant-id-sources" json:"tenantIdSources"`       // X-Tenant-ID 提取来源
	TenantCodeSources []common.AttributeSource `mapstructure:"tenant-code-sources" yaml:"tenant-code-sources" json:"tenantCodeSources"` // X-Tenant-Code 提取来源
	SessionIDSources  []common.AttributeSource `mapstructure:"session-id-sources" yaml:"session-id-sources" json:"sessionIdSources"`    // X-Session-ID 提取来源
	TimezoneSources   []common.AttributeSource `mapstructure:"timezone-sources" yaml:"timezone-sources" json:"timezoneSources"`         // X-Timezone 提取来源
	IDSources         []common.AttributeSource `mapstructure:"id-sources" yaml:"id-sources" json:"idSources"`                           // X-ID 提取来源
	DomainSources     []common.AttributeSource `mapstructure:"domain-sources" yaml:"domain-sources" json:"domainSources"`               // X-Domain 提取来源
	RoleCodeSources   []common.AttributeSource `mapstructure:"role-code-sources" yaml:"role-code-sources" json:"roleCodeSources"`       // X-Role-Code 提取来源
	PushTokenSources  []common.AttributeSource `mapstructure:"push-token-sources" yaml:"push-token-sources" json:"pushTokenSources"`    // X-Push-Token 提取来源
	TokenSources      []common.AttributeSource `mapstructure:"token-sources" yaml:"token-sources" json:"tokenSources"`                  // X-Token 提取来源

	// 设备和应用相关头部
	DeviceIDSources     []common.AttributeSource `mapstructure:"device-id-sources" yaml:"device-id-sources" json:"deviceIdSources"`             // X-Device-Id / X-Device-ID 提取来源
	AppIDSources        []common.AttributeSource `mapstructure:"app-id-sources" yaml:"app-id-sources" json:"appIdSources"`                      // X-App-Id 提取来源
	AppVersionSources   []common.AttributeSource `mapstructure:"app-version-sources" yaml:"app-version-sources" json:"appVersionSources"`       // X-App-Version 提取来源
	PlatformSources     []common.AttributeSource `mapstructure:"platform-sources" yaml:"platform-sources" json:"platformSources"`               // X-Platform 提取来源
	PlatformIDSources   []common.AttributeSource `mapstructure:"platform-id-sources" yaml:"platform-id-sources" json:"platformIDSources"`       // X-Platform-ID 提取来源
	PlatformCodeSources []common.AttributeSource `mapstructure:"platform-code-sources" yaml:"platform-code-sources" json:"platformCodeSources"` // X-Platform-Code 提取来源
	RegionIDSources     []common.AttributeSource `mapstructure:"region-id-sources" yaml:"region-id-sources" json:"regionIDSources"`             // X-Region-ID 提取来源
	RegionCodeSources   []common.AttributeSource `mapstructure:"region-code-sources" yaml:"region-code-sources" json:"regionCodeSources"`       // X-Region-Code 提取来源
	AgentLineIDSources  []common.AttributeSource `mapstructure:"agent-line-id-sources" yaml:"agent-line-id-sources" json:"agentLineIDSources"`  // X-Agent-Line 提取来源
	TimestampSources    []common.AttributeSource `mapstructure:"timestamp-sources" yaml:"timestamp-sources" json:"timestampSources"`            // X-Timestamp 提取来源
	SignatureSources    []common.AttributeSource `mapstructure:"signature-sources" yaml:"signature-sources" json:"signatureSources"`            // X-Signature 提取来源
	NonceSources        []common.AttributeSource `mapstructure:"nonce-sources" yaml:"nonce-sources" json:"nonceSources"`                        // X-Nonce 提取来源
	AccessKeySources    []common.AttributeSource `mapstructure:"access-key-sources" yaml:"access-key-sources" json:"accessKeySources"`          // X-Access-Key 提取来源

	// 其他请求头
	OriginSources    []common.AttributeSource `mapstructure:"origin-sources" yaml:"origin-sources" json:"originSources"`            // Origin 提取来源
	CSRFTokenSources []common.AttributeSource `mapstructure:"csrf-token-sources" yaml:"csrf-token-sources" json:"csrfTokenSources"` // X-CSRF-Token 提取来源
}

type SourceKeys struct {
	ID             FieldSourceKeys
	TraceID        FieldSourceKeys
	RequestID      FieldSourceKeys
	Authorization  FieldSourceKeys
	AuthPayload    FieldSourceKeys
	Jti            FieldSourceKeys
	FamilyId       FieldSourceKeys
	UserAgent      FieldSourceKeys
	ClientID       FieldSourceKeys
	UserID         FieldSourceKeys
	UserType       FieldSourceKeys
	Domain         FieldSourceKeys
	RoleCode       FieldSourceKeys
	TenantID       FieldSourceKeys
	TenantCode     FieldSourceKeys
	SessionID      FieldSourceKeys
	Timezone       FieldSourceKeys
	RealIP         FieldSourceKeys
	ForwardedFor   FieldSourceKeys
	ForwardedProto FieldSourceKeys
	ForwardedHost  FieldSourceKeys
	DeviceID       FieldSourceKeys
	AppID          FieldSourceKeys
	AppVersion     FieldSourceKeys
	PlatformID     FieldSourceKeys
	PlatformCode   FieldSourceKeys
	RegionID       FieldSourceKeys
	RegionCode     FieldSourceKeys
	AgentLineID    FieldSourceKeys
	Timestamp      FieldSourceKeys
	Signature      FieldSourceKeys
	Nonce          FieldSourceKeys
	AccessKey      FieldSourceKeys
	PushToken      FieldSourceKeys
	Token          FieldSourceKeys
	Origin         FieldSourceKeys
	CSRFToken      FieldSourceKeys
}

type TLS struct {
	CertFile            string         `mapstructure:"cert-file" yaml:"cert-file" json:"certFile"`                                    // 证书文件路径
	KeyFile             string         `mapstructure:"key-file" yaml:"key-file" json:"keyFile"`                                       // 私钥文件路径
	CAFile              string         `mapstructure:"ca-file" yaml:"ca-file" json:"caFile"`                                          // CA文件路径
	MinVersion          TLSVersion     `mapstructure:"min-version" yaml:"min-version" json:"minVersion"`                              // 最小TLS版本
	PreferServerCiphers bool           `mapstructure:"prefer-server-ciphers" yaml:"prefer-server-ciphers" json:"preferServerCiphers"` // 优先使用服务器密码套件
	NextProtos          []string       `mapstructure:"next-protos" yaml:"next-protos" json:"nextProtos"`                              // ALPN协议列表（如: h2, http/1.1）
	InsecureSkipVerify  bool           `mapstructure:"insecure-skip-verify" yaml:"insecure-skip-verify" json:"insecureSkipVerify"`    // 跳过证书验证（仅用于开发环境）
	ClientAuth          ClientAuthType `mapstructure:"client-auth" yaml:"client-auth" json:"clientAuth"`                              // 客户端认证模式
}

type TLSVersion string