goconfig

type BuilderFactory struct {
	// contains filtered or unexported fields
}

type CallbackEvent struct {
	Type        CallbackType           `json:"type"`        // 事件类型
	Timestamp   time.Time              `json:"timestamp"`   // 事件时间
	Source      string                 `json:"source"`      // 事件源（文件路径、环境变量名等）
	OldValue    interface{}            `json:"old_value"`   // 旧值
	NewValue    interface{}            `json:"new_value"`   // 新值
	Environment EnvironmentType        `json:"environment"` // 当前环境
	Error       error                  `json:"error"`       // 错误信息（仅错误回调）
	Metadata    map[string]interface{} `json:"metadata"`    // 附加元数据
	ConfigPath  string                 `json:"config_path"` // 配置文件路径
	Duration    time.Duration          `json:"duration"`    // 事件处理耗时
}

type CallbackFunc func(ctx context.Context, event CallbackEvent) error

type CallbackManager interface {
	// RegisterCallback 注册回调函数
	RegisterCallback(callback CallbackFunc, options CallbackOptions) error

	// UnregisterCallback 注销回调函数
	UnregisterCallback(id string) error

	// TriggerCallbacks 触发回调函数
	TriggerCallbacks(ctx context.Context, event CallbackEvent) error

	// ListCallbacks 列出所有已注册的回调
	ListCallbacks() []string

	// ClearCallbacks 清空所有回调
	ClearCallbacks()

	// HasCallback 检查是否存在指定ID的回调
	HasCallback(id string) bool
}

type CallbackOptions struct {
	ID       string                   // 回调的唯一标识符
	Types    []CallbackType           // 监听的事件类型
	Priority int                      // 优先级（越小越优先）
	Async    bool                     // 是否异步执行
	Timeout  time.Duration            // 超时时间
	Retry    int                      // 重试次数
	Filter   func(CallbackEvent) bool // 事件过滤器
}

type CallbackType string

type CommonCallbackManager struct {
	// contains filtered or unexported fields
}

type ConfigBuilder[T any] interface {
	// WithConfigPath 设置配置文件路径
	WithConfigPath(path string) ConfigBuilder[T]

	// WithSearchPath 设置配置文件搜索路径
	WithSearchPath(path string) ConfigBuilder[T]

	// WithEnvironment 设置运行环境
	WithEnvironment(env EnvironmentType) ConfigBuilder[T]

	// WithPrefix 设置配置文件名前缀
	WithPrefix(prefix string) ConfigBuilder[T]

	// WithPattern 设置文件匹配模式
	WithPattern(pattern string) ConfigBuilder[T]

	// WithHotReload 启用配置热重载功能
	WithHotReload(config *HotReloadConfig) ConfigBuilder[T]

	// WithContext 设置上下文配置选项
	WithContext(options *ContextKeyOptions) ConfigBuilder[T]

	// WithErrorHandler 设置错误处理器
	WithErrorHandler(handler ErrorHandler) ConfigBuilder[T]

	// Build 构建配置管理器
	Build() (*IntegratedConfigManager, error)

	// BuildAndStart 构建并启动配置管理器
	BuildAndStart(ctx ...context.Context) (*IntegratedConfigManager, error)

	// MustBuildAndStart 构建并启动配置管理器（失败时panic）
	MustBuildAndStart(ctx ...context.Context) *IntegratedConfigManager
}

type ConfigBuilderOptions struct {
	ConfigPath      string             `json:"config_path"`       // 配置文件路径
	SearchPath      string             `json:"search_path"`       // 搜索路径
	Environment     EnvironmentType    `json:"environment"`       // 环境类型
	ConfigPrefix    string             `json:"config_prefix"`     // 配置前缀
	Pattern         string             `json:"pattern"`           // 匹配模式
	HotReloadConfig *HotReloadConfig   `json:"hot_reload_config"` // 热重载配置
	ContextOptions  *ContextKeyOptions `json:"context_options"`   // 上下文选项
	ErrorHandler    ErrorHandler       `json:"-"`                 // 错误处理器（不序列化）
}

type ConfigContext struct {
	Environment EnvironmentType        `json:"environment"` // 当前环境
	Config      interface{}            `json:"config"`      // 配置对象
	Metadata    map[string]interface{} `json:"metadata"`    // 元数据
	CreatedAt   time.Time              `json:"created_at"`  // 创建时间
	UpdatedAt   time.Time              `json:"updated_at"`  // 更新时间
}

type ConfigDiscovery struct {
	// 支持的配置文件扩展名，按优先级排序
	SupportedExtensions []string
	// 默认配置文件名（不含扩展名）
	DefaultNames []string
	// 环境特定的配置文件前缀
	EnvPrefixes map[EnvironmentType][]string
}

type ConfigError struct {
	Type       ErrorType              `json:"type"`        // 错误类型
	Severity   ErrorSeverity          `json:"severity"`    // 严重程度
	Message    string                 `json:"message"`     // 错误消息
	Source     string                 `json:"source"`      // 错误来源
	Timestamp  time.Time              `json:"timestamp"`   // 错误时间
	StackTrace string                 `json:"stack_trace"` // 堆栈跟踪
	Context    map[string]interface{} `json:"context"`     // 错误上下文
	Cause      error                  `json:"cause"`       // 原始错误
	Retryable  bool                   `json:"retryable"`   // 是否可重试
	Code       string                 `json:"code"`        // 错误代码
}

type ConfigErrorHandler struct {
	// contains filtered or unexported fields
}

type ConfigFileInfo struct {
	Path        string          `json:"path"`        // 文件完整路径
	Name        string          `json:"name"`        // 文件名（含扩展名）
	BaseName    string          `json:"base_name"`   // 文件名（不含扩展名）
	Extension   string          `json:"extension"`   // 文件扩展名
	Environment EnvironmentType `json:"environment"` // 环境类型
	Priority    int             `json:"priority"`    // 优先级（数字越小优先级越高）
	Exists      bool            `json:"exists"`      // 文件是否存在
}

type ConfigFormatter struct {
	// contains filtered or unexported fields
}

type ConfigLogger struct {
	// contains filtered or unexported fields
}

type ContextKey string

type ContextKeyHelper struct{}

type ContextKeyOptions struct {
	Key   ContextKey
	Value EnvironmentType
}

type ContextManager struct {
	// contains filtered or unexported fields
}

type Environment struct {
	CheckFrequency time.Duration // 检查频率

	Value EnvironmentType // 当前环境值
	// contains filtered or unexported fields
}

type EnvironmentCallback func(oldEnv, newEnv EnvironmentType) error

type EnvironmentCallbackInfo struct {
	ID       string              // 回调唯一标识
	Callback EnvironmentCallback // 回调函数
	Priority int                 // 优先级（数字越小优先级越高）
	Async    bool                // 是否异步执行
}

type EnvironmentInterface interface {
	SetEnvironment(value EnvironmentType) *Environment
	CheckAndUpdateEnv()
	SetCheckFrequency(frequency time.Duration) *Environment
	StopWatch()
	ClearEnv()
	RegisterCallback(id string, callback EnvironmentCallback, priority int, async bool) error
	UnregisterCallback(id string) error
	ListCallbacks() []string
	ClearCallbacks()
}

type EnvironmentManager struct {
	// contains filtered or unexported fields
}

type EnvironmentType string

type ErrorCallback func(ctx context.Context, configErr *ConfigError) error

type ErrorFilter struct {
	ID         string          `json:"id"`         // 回调ID
	Types      []ErrorType     `json:"types"`      // 监听的错误类型
	Severities []ErrorSeverity `json:"severities"` // 监听的严重程度
	Sources    []string        `json:"sources"`    // 监听的错误来源
}

type ErrorHandler interface {
	// HandleError 处理错误
	HandleError(ctx context.Context, err error) *ConfigError

	// ClassifyError 分类错误
	ClassifyError(err error) (*ConfigError, ErrorType, ErrorSeverity)

	// RegisterErrorCallback 注册错误回调
	RegisterErrorCallback(callback ErrorCallback, filter ErrorFilter) error

	// UnregisterErrorCallback 注销错误回调
	UnregisterErrorCallback(id string) error

	// GetErrorStats 获取错误统计
	GetErrorStats() *ErrorStats

	// ClearErrorStats 清除错误统计
	ClearErrorStats()
}

type ErrorSeverity int

type ErrorStats struct {
	TotalErrors      int                   `json:"total_errors"`       // 总错误数
	ErrorsByType     map[ErrorType]int     `json:"errors_by_type"`     // 按类型分类
	ErrorsBySeverity map[ErrorSeverity]int `json:"errors_by_severity"` // 按严重程度分类
	ErrorsBySource   map[string]int        `json:"errors_by_source"`   // 按来源分类
	LastError        *ConfigError          `json:"last_error"`         // 最后一个错误
	FirstSeen        time.Time             `json:"first_seen"`         // 第一次看到错误的时间
	LastSeen         time.Time             `json:"last_seen"`          // 最后一次看到错误的时间
	RecentErrors     []*ConfigError        `json:"recent_errors"`      // 最近的错误（最多保留100个）
}

type ErrorType string

type HotReloadConfig struct {
	Enabled         bool          `yaml:"enabled" json:"enabled"`                   // 是否启用热更新
	WatchInterval   time.Duration `yaml:"watch_interval" json:"watch_interval"`     // 监控间隔
	DebounceDelay   time.Duration `yaml:"debounce_delay" json:"debounce_delay"`     // 防抖延迟
	MaxRetries      int           `yaml:"max_retries" json:"max_retries"`           // 最大重试次数
	CallbackTimeout time.Duration `yaml:"callback_timeout" json:"callback_timeout"` // 回调超时
	EnableEnvWatch  bool          `yaml:"enable_env_watch" json:"enable_env_watch"` // 是否监控环境变量
}

type HotReloader interface {
	CallbackManager
	// Start 启动热更新监控
	Start(ctx context.Context) error
	// Stop 停止热更新监控
	Stop() error
	// Reload 手动重新加载配置
	Reload(ctx context.Context) error
	// IsRunning 检查是否正在运行
	IsRunning() bool
	// GetConfig 获取当前配置
	GetConfig() interface{}
	// SetConfig 设置配置
	SetConfig(config interface{}) error
}

type IntegratedConfigManager struct {
	// contains filtered or unexported fields
}

type IntegratedConfigOptions struct {
	ConfigPath      string             // 配置文件路径
	Environment     EnvironmentType    // 初始环境
	HotReloadConfig *HotReloadConfig   // 热更新配置
	ContextOptions  *ContextKeyOptions // 上下文选项
	ErrorHandler    ErrorHandler       // 错误处理器
}

type ManagerBuilder[T any] struct {
	// contains filtered or unexported fields
}

type ModuleConfig struct {
	Name          string             // 模块名称
	PackageName   string             // 包名
	DefaultFunc   func() interface{} // 默认配置函数
	OutputSubDir  string             // 输出子目录
	SourceFile    string             // 源文件路径
	StructName    string             // 结构体名称
	Description   string             // 模块描述
	Enabled       bool               // 是否启用此模块生成
	LastGenerated time.Time          // 最后生成时间
}

type SmartConfigGenerator struct {
	BaseOutputDir     string                  // 基础输出目录
	Logger            *gologger.Logger        // 日志记录器
	ModuleRegistry    map[string]ModuleConfig // 模块注册表
	ForceRegenerate   bool                    // 是否强制重新生成
	IncludeComments   bool                    // 是否包含注释
	GenerateJSON      bool                    // 是否生成JSON
	GenerateYAML      bool                    // 是否生成YAML
	BackupExisting    bool                    // 是否备份现有文件
	OverwriteExisting bool                    // 是否覆盖现有文件
	// contains filtered or unexported fields
}