settings

type LibrarySettingsResponse ¶ added in v0.0.32

type LibrarySettingsResponse struct {
	SortSpec *string `json:"sort_spec"`
}

LibrarySettingsResponse is the response for GET/PUT /settings/libraries/:library_id.

type Service ¶

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

func NewService(db *bun.DB) *Service

func (svc *Service) GetLibrarySettings(ctx context.Context, userID, libraryID int) (*models.UserLibrarySettings, error)

func (svc *Service) GetViewerSettings(ctx context.Context, userID int) (*models.UserSettings, error)

func (svc *Service) UpdateViewerSettings(
	ctx context.Context,
	userID int,
	update ViewerSettingsUpdate,
) (*models.UserSettings, error)

func (svc *Service) UpsertLibrarySort(ctx context.Context, userID, libraryID int, sortSpec *string) (*models.UserLibrarySettings, error)

type UpdateLibrarySettingsPayload ¶ added in v0.0.32

type UpdateLibrarySettingsPayload struct {
	SortSpec *string `json:"sort_spec" validate:"omitempty,max=200"`
}

UpdateLibrarySettingsPayload is the request body for PUT /settings/libraries/:library_id.

SortSpec is a pointer so the client can distinguish "unset" (omit field from JSON) from "clear the saved default" (send null). A null body clears the saved sort; omitting the field leaves it untouched.

max=200 caps the input length defensively at bind time. The longest possible legitimate spec — every field at the longest direction — fits comfortably under 200 chars (sortspec.MaxLevels=10), so 200 is a generous upper bound that still rejects pathological input before it reaches sortspec.Parse.

type ViewerSettingsPayload ¶

type ViewerSettingsPayload struct {
	PreloadCount *int    `json:"preload_count,omitempty"`
	FitMode      *string `json:"fit_mode,omitempty"`
	EpubFontSize *int    `json:"viewer_epub_font_size,omitempty"`
	EpubTheme    *string `json:"viewer_epub_theme,omitempty"`
	EpubFlow     *string `json:"viewer_epub_flow,omitempty"`
}

ViewerSettingsPayload is the request body for updating viewer settings.

All fields are pointers so clients can send partial updates. Omitting a field (or sending it as null) leaves the current value untouched; sending a value updates just that field.

Field shape must stay identical to ViewerSettingsUpdate (same field names, same types, same order) — the handler converts between them with `ViewerSettingsUpdate(payload)`. Drifting either one breaks that cast.

type ViewerSettingsResponse ¶

type ViewerSettingsResponse struct {
	PreloadCount int    `json:"preload_count"`
	FitMode      string `json:"fit_mode"`
	EpubFontSize int    `json:"viewer_epub_font_size"`
	EpubTheme    string `json:"viewer_epub_theme"`
	EpubFlow     string `json:"viewer_epub_flow"`
}

ViewerSettingsResponse is the response for viewer settings.

type ViewerSettingsUpdate ¶ added in v0.0.35

type ViewerSettingsUpdate struct {
	PreloadCount *int
	FitMode      *string
	EpubFontSize *int
	EpubTheme    *string
	EpubFlow     *string
}

ViewerSettingsUpdate describes a partial update to viewer settings. Any field left nil is left untouched; fields set to a non-nil value are persisted. This lets clients change one setting without having to read and echo every other setting first.