userep

type GetUserPhotoURLEndpoint struct{}

type GetUserPhotoURLRequest struct {
	// User ID.
	UserID string `path:"id" validate:"required"`
}

type RetrieveUserEndpoint struct{}

type RetrieveUserRequest struct {
	// Identifier for the user.
	//
	// Accepts the user's ID, email address, or username, tried in that order.
	UserID string `path:"id" validate:"required"`
}

type UpdateUserEndpoint struct{}

type UpdateUserRequest struct {
	// User ID.
	UserID string `path:"id" validate:"required"`
	// The user's full display name.
	Name field.Optional[string] `json:"name,omitzero" validate:"omitempty,max=255"`
	// Location of the user's profile image.
	//
	// Uploading a photo through Upload User Photo overwrites whatever is set here.
	ImageUrl field.Optional[string] `json:"image_url,omitzero" validate:"omitempty,max=2083"`
	// When the user's email address was verified.
	//
	// Setting this marks the address as verified outright; no verification email is sent and no verification link is checked.
	EmailVerified field.Optional[time.Time] `json:"email_verified,omitzero"`
}

type UploadUserPhotoEndpoint struct{}

type UploadUserPhotoRequest struct {
	// User ID.
	UserID string `path:"id" validate:"required"`
	// The image itself, sent as the raw request body rather than as JSON or a multipart form.
	RawBody []byte `rawbody:"true"`
	// MIME type of the image (e.g. `image/png`).
	ContentType string `header:"Content-Type"`
}

type UserSvc interface {
	GetUser(ctx context.Context, req *RetrieveUserRequest) (*apiresource.User, *apierror.APIError)
	UpdateUser(ctx context.Context, req *UpdateUserRequest) (*apiresource.User, *apierror.APIError)
	UploadUserPhoto(ctx context.Context, req *UploadUserPhotoRequest) (*apiresource.UserPhotoUploadResult, *apierror.APIError)
	GetUserPhotoURL(ctx context.Context, req *GetUserPhotoURLRequest) (*apiresource.UserPhotoURL, *apierror.APIError)
}

type UserSvcConfig struct {
	// CoreClient (required) is the core-service gRPC client.
	CoreClient pb.CoreServiceClient
}