configstore

type ChangelogEntry struct {
	ID        int       `json:"id" example:"1"`
	Key       string    `json:"key" example:"server.description"`
	Action    string    `json:"action" example:"set"`
	Value     *string   `json:"value,omitempty"`
	ChangedBy string    `json:"changed_by" example:"admin@example.com"`
	ChangedAt time.Time `json:"changed_at" example:"2026-01-15T14:30:00Z"`
}

type Entry struct {
	Key       string    `json:"key" example:"server.description"`
	Value     string    `json:"value" example:"ACME Corp analytics platform"`
	UpdatedBy string    `json:"updated_by" example:"admin@example.com"`
	UpdatedAt time.Time `json:"updated_at" example:"2026-01-15T14:30:00Z"`
}

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

type Store interface {
	// Get returns a single config entry by key, or ErrNotFound if absent.
	Get(ctx context.Context, key string) (*Entry, error)
	// Set creates or updates a config entry and logs the change.
	Set(ctx context.Context, key, value, author string) error
	// Delete removes a config entry and logs the change. Returns ErrNotFound if absent.
	Delete(ctx context.Context, key, author string) error
	// List returns all config entries, ordered by key.
	List(ctx context.Context) ([]Entry, error)
	// Changelog returns recent config changes, newest first.
	Changelog(ctx context.Context, limit int) ([]ChangelogEntry, error)
	// Mode returns the store mode: "file" or "database".
	Mode() string
}