users

type GetResponse struct {
	ID        int64        `json:"id"         example:"42"`
	Email     string       `json:"email"      example:"user@example.com"`
	Name      string       `json:"name"       example:"user"`
	Role      users.Role   `json:"role"       example:"user"                 enums:"admin,user"`
	Status    users.Status `json:"status"     example:"active"               enums:"pending,active,blocked"`
	CreatedAt time.Time    `json:"created_at" example:"2026-04-06T10:00:00Z"`
	UpdatedAt time.Time    `json:"updated_at" example:"2026-04-06T10:00:00Z"`
}

type Handler struct {
	handler.Base
	// contains filtered or unexported fields
}

type ListFilter struct {
	Status *users.Status `query:"status" validate:"omitempty,oneof=pending active blocked" enums:"pending,active,blocked"`
	Role   *users.Role   `query:"role"   validate:"omitempty,oneof=admin user"             enums:"admin,user"`
	Limit  int           `query:"limit"  validate:"min=1,max=100"                                                         default:"20"`
	Offset int           `query:"offset" validate:"min=0"                                                                 default:"0"`
}

type ListResponse struct {
	Items []GetResponse `json:"items"`
	Total int           `json:"total" example:"42"`
}

type SearchQuery struct {
	dto.PaginationQuery

	Query string `query:"query" validate:"required,min=1,max=255"`
}

type UpdateRequest struct {
	Status *users.Status `json:"status,omitempty" validate:"omitempty,oneof=pending active blocked" enums:"pending,active,blocked"`
	Role   *users.Role   `json:"role,omitempty"   validate:"omitempty,oneof=admin user"             enums:"admin,user"`
}