api

type CertificateCreateResponse struct {
	CertificateID int32 `json:"certificate_id"`
}

type CertificateGenerateRequest struct {
	Name           string `json:"name" validate:"required"`
	CommonName     string `json:"common_name" validate:"required"`
	SubjectAltName string `json:"subject_alt_name"`
	CAID           int32  `json:"ca_id" validate:"required"`
}

type CertificateUpdateRequest struct {
	Comments string `json:"comments"`
}

type CertificateUploadRequest struct {
	Type     string `json:"type" form:"type" validate:"required"`
	IsCA     bool   `json:"is_ca" form:"is_ca"`
	Name     string `json:"name" form:"name" validate:"required"`
	Password string `json:"password" form:"password"`
}

type Context interface {
	// echo wrap: echo.Context for request/response handling,
	// context.Context for cancellation/deadline propagation, plus
	// thin helpers over Echo's parameter binders.
	echo.Context
	context.Context
	BindQuery() *echo.ValueBinder
	BindPath() *echo.ValueBinder
	BindForm() *echo.ValueBinder
	BindAny(i any) error

	// helpers: typed accessors for values stashed into the echo
	// context by middleware (auth, tracing). They return (_, false)
	// when the value is missing or the wrong type, so handlers don't
	// have to repeat the assertion dance.
	Credential() (*entity.Credential, bool)
	Session() (*entity.Session, bool)
	TraceID() (string, bool)
}

type HandlerFunc func(Context) error

type HelloWorldCreateRequest struct {
	Message string `json:"message" form:"message" query:"message" validate:"required"`
}

type LoginRequest struct {
	Username string `json:"username" form:"username" validate:"required"`
	Password string `json:"password" form:"password" validate:"required"`
}

type LoginResponse struct {
	RequirePasswordReset bool `json:"require_password_reset"`
}

type UserCreateRequest struct {
	Username       string `json:"username" validate:"required"`
	Password       string `json:"password" validate:"required"`
	Title          string `json:"title"`
	FirstName      string `json:"first_name"`
	LastName       string `json:"last_name"`
	Email          string `json:"email"`
	Role           string `json:"role" validate:"required"`
	ChangePassword bool   `json:"change_password"`
}

type UserCreateResponse struct {
	UserID int32 `json:"user_id"`
}

type UserResetPasswordRequest struct {
	Password    string `json:"password" validate:"required"`
	OldPassword string `json:"old_password"`
}

type UserUpdateRequest struct {
	Username       *string `json:"username,omitempty"`
	Title          *string `json:"title,omitempty"`
	FirstName      *string `json:"first_name,omitempty"`
	LastName       *string `json:"last_name,omitempty"`
	Email          *string `json:"email,omitempty"`
	Role           *string `json:"role,omitempty"`
	ChangePassword bool    `json:"change_password"`
}

type WebSocketHandlerFunc func(Context, *websocket.Conn) error