validate

type CustomValidator ¶

type CustomValidator interface {
	Validate(value any) error
}

CustomValidator interface for custom validators (renamed to avoid conflict)

type DBExecutor ¶

type DBExecutor interface {
	// QueryRow executes a query expected to return at most one row.
	// The query must accept a single text argument and return a single integer
	// (the count). This is sufficient for EXISTS and UNIQUE checks.
	QueryRow(ctx context.Context, sql string, args ...any) DBRow
}

DBExecutor is the minimal interface the validator needs to run DB-backed rules. It is satisfied by *sql.DB, *database.DB, or any custom adapter.

Migration from the old API:

// Before:
validate.New(db)

// After:
validate.New(validate.WithDB(dbAdapter))
// or simply:
validate.New()  // no DB rules (exists/unique will be skipped)

type DBRow ¶

type DBRow interface {
	Scan(dest ...any) error
}

DBRow is the minimal interface for scanning a single value from a query.

type Field ¶

type Field struct {
	Name     string
	Value    any
	Rules    []*Rule
	Required bool
	Optional bool
}

Field represents a field to be validated

type FieldBuilder ¶

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

FieldBuilder provides fluent interface for building field validations

func (fb *FieldBuilder) Alpha() *FieldBuilder

func (fb *FieldBuilder) AlphaNumeric() *FieldBuilder

func (fb *FieldBuilder) Custom(validator func(any) error, message string) *FieldBuilder

func (fb *FieldBuilder) Date() *FieldBuilder

func (fb *FieldBuilder) DateTime() *FieldBuilder

func (fb *FieldBuilder) Email() *FieldBuilder

func (fb *FieldBuilder) In(values ...any) *FieldBuilder

func (fb *FieldBuilder) Integer() *FieldBuilder

func (fb *FieldBuilder) JSON() *FieldBuilder

func (fb *FieldBuilder) Max(max float64) *FieldBuilder

func (fb *FieldBuilder) MaxLength(max int) *FieldBuilder

func (fb *FieldBuilder) Min(min float64) *FieldBuilder

func (fb *FieldBuilder) MinLength(min int) *FieldBuilder

func (fb *FieldBuilder) NotIn(values ...any) *FieldBuilder

func (fb *FieldBuilder) Numeric() *FieldBuilder

func (fb *FieldBuilder) OneOf(values ...string) *FieldBuilder

func (fb *FieldBuilder) Optional() *FieldBuilder

func (fb *FieldBuilder) Password() *FieldBuilder

func (fb *FieldBuilder) Pattern(pattern string) *FieldBuilder

func (fb *FieldBuilder) Phone() *FieldBuilder

func (fb *FieldBuilder) Required() *FieldBuilder

func (fb *FieldBuilder) URL() *FieldBuilder

func (fb *FieldBuilder) UUID() *FieldBuilder

type MessageFormatter ¶

type MessageFormatter func(fe validator.FieldError, locale ...string) string

MessageFormatter is a function that formats a field error into a human-readable string. It can optionally take a locale for i18n support.

type Rule ¶

type Rule struct {
	Name       string
	Validator  func(any) error
	Message    string
	StopOnFail bool
}

Rule represents a validation rule

type ValidationErrors ¶

type ValidationErrors struct {
	Fields map[string][]string `json:"fields"`
}

ValidationErrors holds structured field validation errors.

func NewValidationErrors() *ValidationErrors

func (ve *ValidationErrors) Add(field string, message string)

func (ve *ValidationErrors) Error() string

func (ve *ValidationErrors) HasErrors() bool

type ValidationResult ¶

type ValidationResult struct {
	Valid  bool              `json:"valid"`
	Errors map[string]string `json:"errors"`
}

ValidationResult represents the result of validation

func Struct(s any) *ValidationResult

type Validator ¶

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

Validator wraps go-playground/validator with custom configurations.

func New(opts ...ValidatorOption) *Validator

v := validate.New(validate.WithDB(dbAdapter), validate.WithMessageFormatter(i18nFn))

func (v *Validator) BindAndValidate(r *http.Request, val any) error

func (v *Validator) Validate(s any) error

func (v *Validator) ValidateStruct(obj any, locale ...string) error

type ValidatorOption ¶

type ValidatorOption func(*Validator)

ValidatorOption configures the Validator.

func WithCustomRule(tag string, fn validator.Func) ValidatorOption

func WithDB(db DBExecutor) ValidatorOption

func WithMessageFormatter(formatter MessageFormatter) ValidatorOption

type ValidatorSet ¶

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

ValidatorSet represents a collection of validation rules

func NewValidatorSet() *ValidatorSet

func (vs *ValidatorSet) Field(name string, value any) *FieldBuilder

func (vs *ValidatorSet) Validate() *ValidationResult