From 80ce84e2fea099dc743ee9a8d1910305d3110fe7 Mon Sep 17 00:00:00 2001
From: Alessandro Schwaiger <aless2003@gmx.at>
Date: Sat, 23 Mar 2024 16:00:41 +0100
Subject: [PATCH 01/17] Tracking via Suwayomi works fine now

---
 .run/Dev.run.xml                              |   1 +
 build.gradle                                  |   4 +
 .../dialog/tracking/tracking-dialog.css       |   7 +
 schemas/schema.graphql                        | 293 ++++++++++++++++--
 .../tachideskvaadinui/api/AuthAPI.java        |  32 +-
 .../dialog/tracking/TrackingDialog.java       | 104 +++++--
 .../tracking/TrackingMangaChoiceDialog.java   |  53 ++--
 .../tracking/provider/AniListProvider.java    |  39 +++
 .../tracking/provider/SuwayomiProvider.java   |  37 +++
 .../tracking/provider/TrackerProvider.java    |  34 ++
 .../data/tracking/Tracker.java                |   5 +
 .../tracking/search/TrackerSearchResult.java  | 129 ++++++++
 .../services/SuwayomiSettingsService.java     |   2 +-
 .../TrackingCommunicationService.java         |   1 +
 .../services/WebClientService.java            |  14 +
 .../SuwayomiSettingsClient.java               |   2 +-
 .../suwayomi/SuwayomiTrackingClient.java      | 173 +++++++++++
 .../{ => tracker}/AniListAPIService.java      |   3 +-
 .../tracker/MyAnimeListAPIService.java        |  14 +
 .../tracker/SuwayomiTrackingService.java      | 114 +++++++
 .../tachideskvaadinui/view/AniListView.java   |   2 +-
 .../tachideskvaadinui/view/MangaView.java     |  11 +-
 src/main/resources/schema/self.graphql        |   1 +
 23 files changed, 997 insertions(+), 78 deletions(-)
 create mode 100644 src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java
 create mode 100644 src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/SuwayomiProvider.java
 create mode 100644 src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
 create mode 100644 src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
 rename src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/{ => suwayomi}/SuwayomiSettingsClient.java (96%)
 create mode 100644 src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
 rename src/main/java/online/hatsunemiku/tachideskvaadinui/services/{ => tracker}/AniListAPIService.java (99%)
 create mode 100644 src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
 create mode 100644 src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
 create mode 100644 src/main/resources/schema/self.graphql

diff --git a/.run/Dev.run.xml b/.run/Dev.run.xml
index 5ab3628f..3fb1c8f7 100644
--- a/.run/Dev.run.xml
+++ b/.run/Dev.run.xml
@@ -3,6 +3,7 @@
     <option name="ACTIVE_PROFILES" value="dev" />
     <option name="FRAME_DEACTIVATION_UPDATE_POLICY" value="UpdateClassesAndResources" />
     <module name="Tachidesk-VaadinUI.main" />
+    <option name="SHORTEN_COMMAND_LINE" value="ARGS_FILE" />
     <option name="SPRING_BOOT_MAIN_CLASS" value="online.hatsunemiku.tachideskvaadinui.TachideskVaadinUiApplication" />
     <method v="2">
       <option name="Make" enabled="true" />
diff --git a/build.gradle b/build.gradle
index a123b9ce..ac1cdd04 100644
--- a/build.gradle
+++ b/build.gradle
@@ -65,6 +65,9 @@ dependencies {
     implementation 'io.github.openfeign.form:feign-form-spring:3.8.0'
     implementation 'io.github.openfeign:feign-okhttp:12.4'
 
+    //GraphQL
+    implementation "com.netflix.graphql.dgs:graphql-dgs-spring-boot-starter"
+
     implementation 'pl.unforgiven:superfields:0.18.3'
     implementation 'com.squareup.okhttp3:okhttp:4.11.0'
     implementation 'commons-validator:commons-validator:1.7'
@@ -85,6 +88,7 @@ dependencies {
 dependencyManagement {
     imports {
         mavenBom "com.vaadin:vaadin-bom:${vaadinVersion}"
+        mavenBom "com.netflix.graphql.dgs:graphql-dgs-platform-dependencies:latest.release"
     }
 }
 
diff --git a/frontend/css/components/dialog/tracking/tracking-dialog.css b/frontend/css/components/dialog/tracking/tracking-dialog.css
index 20d88a6e..f1a952b7 100644
--- a/frontend/css/components/dialog/tracking/tracking-dialog.css
+++ b/frontend/css/components/dialog/tracking/tracking-dialog.css
@@ -96,4 +96,11 @@
     justify-content: space-between;
     align-items: center;
     padding: 1rem;
+}
+
+#tracking-dialog-tracker-buttons {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
 }
\ No newline at end of file
diff --git a/schemas/schema.graphql b/schemas/schema.graphql
index 9c7fd761..560fc012 100644
--- a/schemas/schema.graphql
+++ b/schemas/schema.graphql
@@ -33,6 +33,18 @@ type BackupRestoreStatus {
   totalManga: Int!
 }
 
+input BindTrackInput {
+  clientMutationId: String
+  mangaId: Int!
+  remoteId: LongString!
+  trackerId: Int!
+}
+
+type BindTrackPayload {
+  clientMutationId: String
+  trackRecord: TrackRecordType!
+}
+
 input BooleanFilterInput {
   distinctFrom: Boolean
   equalTo: Boolean
@@ -98,7 +110,8 @@ enum CategoryOrderBy {
 type CategoryType {
   default: Boolean!
   id: Int!
-  includeInUpdate: IncludeInUpdate!
+  includeInDownload: IncludeOrExclude!
+  includeInUpdate: IncludeOrExclude!
   name: String!
   order: Int!
   mangas: MangaNodeList!
@@ -260,7 +273,8 @@ type CreateBackupPayload {
 input CreateCategoryInput {
   clientMutationId: String
   default: Boolean
-  includeInUpdate: IncludeInUpdate
+  includeInDownload: IncludeOrExclude
+  includeInUpdate: IncludeOrExclude
   name: String!
   order: Int
 }
@@ -350,6 +364,18 @@ type DeleteMangaMetaPayload {
   meta: MangaMetaType
 }
 
+input DeleteSourceMetaInput {
+  clientMutationId: String
+  key: String!
+  sourceId: LongString!
+}
+
+type DeleteSourceMetaPayload {
+  clientMutationId: String
+  meta: SourceMetaType
+  source: SourceType
+}
+
 input DequeueChapterDownloadInput {
   clientMutationId: String
   id: Int!
@@ -370,14 +396,18 @@ type DequeueChapterDownloadsPayload {
   downloadStatus: DownloadStatus!
 }
 
-input DownloadAheadInput {
-  clientMutationId: String
-  latestReadChapterIds: [Int!]
-  mangaIds: [Int!]!
-}
-
-type DownloadAheadPayload {
-  clientMutationId: String
+input DoubleFilterInput {
+  distinctFrom: Float
+  equalTo: Float
+  greaterThan: Float
+  greaterThanOrEqualTo: Float
+  in: [Float!]
+  isNull: Boolean
+  lessThan: Float
+  lessThanOrEqualTo: Float
+  notDistinctFrom: Float
+  notEqualTo: Float
+  notIn: [Float!]
 }
 
 type DownloadEdge implements Edge {
@@ -637,7 +667,7 @@ type HeaderFilter {
   name: String!
 }
 
-enum IncludeInUpdate {
+enum IncludeOrExclude {
   EXCLUDE
   INCLUDE
   UNSET
@@ -682,6 +712,42 @@ type ListPreference {
   visible: Boolean!
 }
 
+input LoginTrackerCredentialsInput {
+  clientMutationId: String
+  password: String!
+  trackerId: Int!
+  username: String!
+}
+
+type LoginTrackerCredentialsPayload {
+  clientMutationId: String
+  isLoggedIn: Boolean!
+  tracker: TrackerType!
+}
+
+input LoginTrackerOAuthInput {
+  callbackUrl: String!
+  clientMutationId: String
+  trackerId: Int!
+}
+
+type LoginTrackerOAuthPayload {
+  clientMutationId: String
+  isLoggedIn: Boolean!
+  tracker: TrackerType!
+}
+
+input LogoutTrackerInput {
+  clientMutationId: String
+  trackerId: Int!
+}
+
+type LogoutTrackerPayload {
+  clientMutationId: String
+  isLoggedIn: Boolean!
+  tracker: TrackerType!
+}
+
 input LongFilterInput {
   distinctFrom: LongString
   equalTo: LongString
@@ -813,6 +879,7 @@ type MangaType {
   sourceId: LongString!
   status: MangaStatus!
   thumbnailUrl: String
+  thumbnailUrlLastFetched: LongString
   title: String!
   updateStrategy: UpdateStrategy!
   url: String!
@@ -822,8 +889,12 @@ type MangaType {
   chaptersAge: LongString
   downloadCount: Int!
   lastReadChapter: ChapterType
+  latestFetchedChapter: ChapterType
+  latestReadChapter: ChapterType
+  latestUploadedChapter: ChapterType
   meta: [MangaMetaType!]!
   source: SourceType
+  trackRecords: TrackRecordNodeList!
   unreadCount: Int!
 }
 
@@ -891,7 +962,6 @@ type Mutation {
   deleteDownloadedChapters(input: DeleteDownloadedChaptersInput!): DeleteDownloadedChaptersPayload!
   dequeueChapterDownload(input: DequeueChapterDownloadInput!): DequeueChapterDownloadPayload!
   dequeueChapterDownloads(input: DequeueChapterDownloadsInput!): DequeueChapterDownloadsPayload!
-  downloadAhead(input: DownloadAheadInput!): DownloadAheadPayload!
   enqueueChapterDownload(input: EnqueueChapterDownloadInput!): EnqueueChapterDownloadPayload!
   enqueueChapterDownloads(input: EnqueueChapterDownloadsInput!): EnqueueChapterDownloadsPayload!
   reorderChapterDownload(input: ReorderChapterDownloadInput!): ReorderChapterDownloadPayload!
@@ -913,14 +983,21 @@ type Mutation {
   setGlobalMeta(input: SetGlobalMetaInput!): SetGlobalMetaPayload!
   resetSettings(input: ResetSettingsInput!): ResetSettingsPayload!
   setSettings(input: SetSettingsInput!): SetSettingsPayload!
+  deleteSourceMeta(input: DeleteSourceMetaInput!): DeleteSourceMetaPayload!
   fetchSourceManga(input: FetchSourceMangaInput!): FetchSourceMangaPayload!
+  setSourceMeta(input: SetSourceMetaInput!): SetSourceMetaPayload!
   updateSourcePreference(input: UpdateSourcePreferenceInput!): UpdateSourcePreferencePayload!
+  bindTrack(input: BindTrackInput!): BindTrackPayload!
+  loginTrackerCredentials(input: LoginTrackerCredentialsInput!): LoginTrackerCredentialsPayload!
+  loginTrackerOAuth(input: LoginTrackerOAuthInput!): LoginTrackerOAuthPayload!
+  logoutTracker(input: LogoutTrackerInput!): LogoutTrackerPayload!
+  updateTrack(input: UpdateTrackInput!): UpdateTrackPayload!
   updateCategoryManga(input: UpdateCategoryMangaInput!): UpdateCategoryMangaPayload!
   updateLibraryManga(input: UpdateLibraryMangaInput!): UpdateLibraryMangaPayload!
   updateStop(input: UpdateStopInput!): UpdateStopPayload!
 }
 
-union Node = CategoryMetaType | CategoryType | ChapterMetaType | ChapterType | DownloadType | ExtensionType | GlobalMetaType | MangaMetaType | MangaType | PartialSettingsType | SettingsType | SourceType | TrackRecordType | TrackerType
+union Node = CategoryMetaType | CategoryType | ChapterMetaType | ChapterType | DownloadType | ExtensionType | GlobalMetaType | MangaMetaType | MangaType | PartialSettingsType | SettingsType | SourceMetaType | SourceType | TrackRecordType | TrackerType
 
 interface NodeList {
   """
@@ -953,8 +1030,9 @@ type PageInfo {
 }
 
 type PartialSettingsType implements Settings {
-  autoDownloadAheadLimit: Int
+  autoDownloadAheadLimit: Int @deprecated(reason: "Replaced with autoDownloadNewChaptersLimit, replace with autoDownloadNewChaptersLimit")
   autoDownloadNewChapters: Boolean
+  autoDownloadNewChaptersLimit: Int
   backupInterval: Int
   backupPath: String
   backupTTL: Int
@@ -971,6 +1049,11 @@ type PartialSettingsType implements Settings {
   excludeNotStarted: Boolean
   excludeUnreadChapters: Boolean
   extensionRepos: [String!]
+  flareSolverrEnabled: Boolean
+  flareSolverrSessionName: String
+  flareSolverrSessionTtl: Int
+  flareSolverrTimeout: Int
+  flareSolverrUrl: String
   globalUpdateInterval: Float
   gqlDebugLogsEnabled: Boolean
   initialOpenInBrowserEnabled: Boolean
@@ -980,7 +1063,10 @@ type PartialSettingsType implements Settings {
   port: Int
   socksProxyEnabled: Boolean
   socksProxyHost: String
+  socksProxyPassword: String
   socksProxyPort: String
+  socksProxyUsername: String
+  socksProxyVersion: Int
   systemTrayEnabled: Boolean
   updateMangas: Boolean
   webUIChannel: WebUIChannel
@@ -990,8 +1076,8 @@ type PartialSettingsType implements Settings {
 }
 
 input PartialSettingsTypeInput {
-  autoDownloadAheadLimit: Int
   autoDownloadNewChapters: Boolean
+  autoDownloadNewChaptersLimit: Int
   backupInterval: Int
   backupPath: String
   backupTTL: Int
@@ -1008,6 +1094,11 @@ input PartialSettingsTypeInput {
   excludeNotStarted: Boolean
   excludeUnreadChapters: Boolean
   extensionRepos: [String!]
+  flareSolverrEnabled: Boolean
+  flareSolverrSessionName: String
+  flareSolverrSessionTtl: Int
+  flareSolverrTimeout: Int
+  flareSolverrUrl: String
   globalUpdateInterval: Float
   gqlDebugLogsEnabled: Boolean
   initialOpenInBrowserEnabled: Boolean
@@ -1017,7 +1108,10 @@ input PartialSettingsTypeInput {
   port: Int
   socksProxyEnabled: Boolean
   socksProxyHost: String
+  socksProxyPassword: String
   socksProxyPort: String
+  socksProxyUsername: String
+  socksProxyVersion: Int
   systemTrayEnabled: Boolean
   updateMangas: Boolean
   webUIChannel: WebUIChannel
@@ -1050,6 +1144,11 @@ type Query {
   settings: SettingsType!
   source(id: LongString!): SourceType!
   sources(condition: SourceConditionInput, filter: SourceFilterInput, orderBy: SourceOrderBy, orderByType: SortOrder, before: Cursor, after: Cursor, first: Int, last: Int, offset: Int): SourceNodeList!
+  searchTracker(input: SearchTrackerInput!): SearchTrackerPayload!
+  trackRecord(id: Int!): TrackRecordType!
+  trackRecords(condition: TrackRecordConditionInput, filter: TrackRecordFilterInput, orderBy: TrackRecordOrderBy, orderByType: SortOrder, before: Cursor, after: Cursor, first: Int, last: Int, offset: Int): TrackRecordNodeList!
+  tracker(id: Int!): TrackerType!
+  trackers(condition: TrackerConditionInput, orderBy: TrackerOrderBy, orderByType: SortOrder, before: Cursor, after: Cursor, first: Int, last: Int, offset: Int): TrackerNodeList!
   lastUpdateTimestamp: LastUpdateTimestampPayload!
   updateStatus: UpdateStatus!
 }
@@ -1085,6 +1184,15 @@ type RestoreBackupPayload {
   status: BackupRestoreStatus
 }
 
+input SearchTrackerInput {
+  query: String!
+  trackerId: Int!
+}
+
+type SearchTrackerPayload {
+  trackSearches: [TrackSearchType!]!
+}
+
 type SelectFilter {
   default: Int!
   name: String!
@@ -1145,9 +1253,20 @@ type SetSettingsPayload {
   settings: SettingsType!
 }
 
+input SetSourceMetaInput {
+  clientMutationId: String
+  meta: SourceMetaTypeInput!
+}
+
+type SetSourceMetaPayload {
+  clientMutationId: String
+  meta: SourceMetaType!
+}
+
 interface Settings {
-  autoDownloadAheadLimit: Int
+  autoDownloadAheadLimit: Int @deprecated(reason: "Replaced with autoDownloadNewChaptersLimit, replace with autoDownloadNewChaptersLimit")
   autoDownloadNewChapters: Boolean
+  autoDownloadNewChaptersLimit: Int
   backupInterval: Int
   backupPath: String
   backupTTL: Int
@@ -1164,6 +1283,11 @@ interface Settings {
   excludeNotStarted: Boolean
   excludeUnreadChapters: Boolean
   extensionRepos: [String!]
+  flareSolverrEnabled: Boolean
+  flareSolverrSessionName: String
+  flareSolverrSessionTtl: Int
+  flareSolverrTimeout: Int
+  flareSolverrUrl: String
   globalUpdateInterval: Float
   gqlDebugLogsEnabled: Boolean
   initialOpenInBrowserEnabled: Boolean
@@ -1173,7 +1297,10 @@ interface Settings {
   port: Int
   socksProxyEnabled: Boolean
   socksProxyHost: String
+  socksProxyPassword: String
   socksProxyPort: String
+  socksProxyUsername: String
+  socksProxyVersion: Int
   systemTrayEnabled: Boolean
   updateMangas: Boolean
   webUIChannel: WebUIChannel
@@ -1183,8 +1310,9 @@ interface Settings {
 }
 
 type SettingsType implements Settings {
-  autoDownloadAheadLimit: Int!
+  autoDownloadAheadLimit: Int! @deprecated(reason: "Replaced with autoDownloadNewChaptersLimit, replace with autoDownloadNewChaptersLimit")
   autoDownloadNewChapters: Boolean!
+  autoDownloadNewChaptersLimit: Int!
   backupInterval: Int!
   backupPath: String!
   backupTTL: Int!
@@ -1201,6 +1329,11 @@ type SettingsType implements Settings {
   excludeNotStarted: Boolean!
   excludeUnreadChapters: Boolean!
   extensionRepos: [String!]!
+  flareSolverrEnabled: Boolean!
+  flareSolverrSessionName: String!
+  flareSolverrSessionTtl: Int!
+  flareSolverrTimeout: Int!
+  flareSolverrUrl: String!
   globalUpdateInterval: Float!
   gqlDebugLogsEnabled: Boolean!
   initialOpenInBrowserEnabled: Boolean!
@@ -1210,7 +1343,10 @@ type SettingsType implements Settings {
   port: Int!
   socksProxyEnabled: Boolean!
   socksProxyHost: String!
+  socksProxyPassword: String!
   socksProxyPort: String!
+  socksProxyUsername: String!
+  socksProxyVersion: Int!
   systemTrayEnabled: Boolean!
   updateMangas: Boolean!
   webUIChannel: WebUIChannel!
@@ -1266,6 +1402,19 @@ input SourceFilterInput {
   or: [SourceFilterInput!]
 }
 
+type SourceMetaType implements MetaType {
+  key: String!
+  sourceId: LongString!
+  value: String!
+  source: SourceType!
+}
+
+input SourceMetaTypeInput {
+  key: String!
+  sourceId: LongString!
+  value: String!
+}
+
 type SourceNodeList implements NodeList {
   edges: [SourceEdge!]!
   nodes: [SourceType!]!
@@ -1300,6 +1449,7 @@ type SourceType {
   extension: ExtensionType!
   filters: [Filter!]!
   manga: MangaNodeList!
+  meta: [SourceMetaType!]!
   preferences: [Preference!]!
 }
 
@@ -1379,6 +1529,13 @@ type TextFilter {
   name: String!
 }
 
+input TrackerConditionInput {
+  icon: String
+  id: Int
+  isLoggedIn: Boolean
+  name: String
+}
+
 type TrackerEdge implements Edge {
   cursor: Cursor!
   node: TrackerType!
@@ -1391,20 +1548,64 @@ type TrackerNodeList implements NodeList {
   totalCount: Int!
 }
 
+enum TrackerOrderBy {
+  ID
+  NAME
+  IS_LOGGED_IN
+}
+
 type TrackerType {
   authUrl: String
   icon: String!
   id: Int!
   isLoggedIn: Boolean!
   name: String!
+  isTokenExpired: Boolean!
+  scores: [String!]!
+  statuses: [TrackStatusType!]!
   trackRecords: TrackRecordNodeList!
 }
 
+input TrackRecordConditionInput {
+  finishDate: LongString
+  id: Int
+  lastChapterRead: Float
+  libraryId: LongString
+  mangaId: Int
+  remoteId: LongString
+  remoteUrl: String
+  score: Float
+  startDate: LongString
+  status: Int
+  title: String
+  totalChapters: Int
+  trackerId: Int
+}
+
 type TrackRecordEdge implements Edge {
   cursor: Cursor!
   node: TrackRecordType!
 }
 
+input TrackRecordFilterInput {
+  and: [TrackRecordFilterInput!]
+  finishDate: LongFilterInput
+  id: IntFilterInput
+  lastChapterRead: DoubleFilterInput
+  libraryId: LongFilterInput
+  mangaId: IntFilterInput
+  not: TrackRecordFilterInput
+  or: [TrackRecordFilterInput!]
+  remoteId: LongFilterInput
+  remoteUrl: StringFilterInput
+  score: DoubleFilterInput
+  startDate: LongFilterInput
+  status: IntFilterInput
+  title: StringFilterInput
+  totalChapters: IntFilterInput
+  trackerId: IntFilterInput
+}
+
 type TrackRecordNodeList implements NodeList {
   edges: [TrackRecordEdge!]!
   nodes: [TrackRecordType!]!
@@ -1412,6 +1613,19 @@ type TrackRecordNodeList implements NodeList {
   totalCount: Int!
 }
 
+enum TrackRecordOrderBy {
+  ID
+  MANGA_ID
+  TRACKER_ID
+  REMOTE_ID
+  TITLE
+  LAST_CHAPTER_READ
+  TOTAL_CHAPTERS
+  SCORE
+  START_DATE
+  FINISH_DATE
+}
+
 type TrackRecordType {
   finishDate: LongString!
   id: Int!
@@ -1423,14 +1637,34 @@ type TrackRecordType {
   score: Float!
   startDate: LongString!
   status: Int!
-  syncId: Int!
   title: String!
   totalChapters: Int!
+  trackerId: Int!
   displayScore: String!
   manga: MangaType!
   tracker: TrackerType!
 }
 
+type TrackSearchType {
+  coverUrl: String!
+  id: Int!
+  publishingStatus: String!
+  publishingType: String!
+  remoteId: LongString!
+  startDate: String!
+  summary: String!
+  title: String!
+  totalChapters: Int!
+  trackerId: Int!
+  trackingUrl: String!
+  tracker: TrackerType!
+}
+
+type TrackStatusType {
+  name: String!
+  value: Int!
+}
+
 enum TriState {
   IGNORE
   INCLUDE
@@ -1482,7 +1716,8 @@ type UpdateCategoryOrderPayload {
 
 input UpdateCategoryPatchInput {
   default: Boolean
-  includeInUpdate: IncludeInUpdate
+  includeInDownload: IncludeOrExclude
+  includeInUpdate: IncludeOrExclude
   name: String
 }
 
@@ -1661,6 +1896,22 @@ enum UpdateStrategy {
   ONLY_FETCH_ONCE
 }
 
+input UpdateTrackInput {
+  clientMutationId: String
+  finishDate: LongString
+  lastChapterRead: Float
+  recordId: Int!
+  scoreString: String
+  startDate: LongString
+  status: Int
+  unbind: Boolean
+}
+
+type UpdateTrackPayload {
+  clientMutationId: String
+  trackRecord: TrackRecordType
+}
+
 """A file part in a multipart request"""
 scalar Upload
 
@@ -1685,6 +1936,7 @@ enum WebUIChannel {
 
 enum WebUIFlavor {
   WEBUI
+  VUI
   CUSTOM
 }
 
@@ -1717,5 +1969,4 @@ type WebUIUpdateStatus {
   info: WebUIUpdateInfo!
   progress: Int!
   state: UpdateState!
-}
-
+}
\ No newline at end of file
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
index 6e90af10..c9d3b76f 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
@@ -6,27 +6,33 @@
 
 package online.hatsunemiku.tachideskvaadinui.api;
 
+import elemental.json.Json;
+import elemental.json.JsonObject;
+import jakarta.servlet.http.HttpServletRequest;
 import lombok.extern.slf4j.Slf4j;
+import online.hatsunemiku.tachideskvaadinui.data.settings.Settings;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.OAuthResponse;
+import online.hatsunemiku.tachideskvaadinui.services.SettingsService;
 import online.hatsunemiku.tachideskvaadinui.services.TrackingDataService;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService;
 import org.intellij.lang.annotations.Language;
 import org.springframework.http.MediaType;
-import org.springframework.web.bind.annotation.GetMapping;
-import org.springframework.web.bind.annotation.PostMapping;
-import org.springframework.web.bind.annotation.RequestBody;
-import org.springframework.web.bind.annotation.RequestMapping;
-import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.bind.annotation.*;
 import org.springframework.web.servlet.view.RedirectView;
 
+import java.util.Map;
+
 @RestController
 @RequestMapping("validate")
 @Slf4j
 public class AuthAPI {
 
   private final TrackingDataService dataService;
+  private final SuwayomiTrackingService suwayomiTrackingService;
 
-  public AuthAPI(TrackingDataService dataService) {
+  public AuthAPI(TrackingDataService dataService, SuwayomiTrackingService suwayomiTrackingService) {
     this.dataService = dataService;
+    this.suwayomiTrackingService = suwayomiTrackingService;
   }
 
   /**
@@ -94,6 +100,20 @@ public String validateAniListToken() {
     return html;
   }
 
+  @GetMapping("suwayomi")
+  public RedirectView authenticateSuwayomi(HttpServletRequest request, @RequestParam("state") String json) {
+    String url = request.getRequestURL() + "?" + request.getQueryString();
+
+    JsonObject state = Json.parse(json);
+
+    int trackerId = (int) state.getNumber("trackerId");
+
+    suwayomiTrackingService.loginSuwayomi(url, trackerId);
+
+    return new RedirectView("/");
+  }
+
+
   /**
    * Validates the AniList token received in the request body. If the token is valid, it is saved in
    * the application settings. Otherwise, redirects the user to the homepage.
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
index 8fae8d0b..632d940c 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
@@ -17,18 +17,22 @@
 import com.vaadin.flow.component.notification.NotificationVariant;
 import com.vaadin.flow.component.orderedlayout.VerticalLayout;
 import com.vaadin.flow.theme.lumo.LumoIcon;
+import graphql.GraphQLError;
 import java.time.LocalDate;
 import java.util.Objects;
-import java.util.Optional;
 import lombok.extern.slf4j.Slf4j;
+import online.hatsunemiku.tachideskvaadinui.component.dialog.tracking.provider.AniListProvider;
+import online.hatsunemiku.tachideskvaadinui.component.dialog.tracking.provider.SuwayomiProvider;
+import online.hatsunemiku.tachideskvaadinui.component.dialog.tracking.provider.TrackerProvider;
 import online.hatsunemiku.tachideskvaadinui.data.tachidesk.Manga;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.Tracker;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.AniListScoreFormat;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.AniListStatus;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.common.MediaDate;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.responses.AniListMangaStatistics;
-import online.hatsunemiku.tachideskvaadinui.services.AniListAPIService;
 import online.hatsunemiku.tachideskvaadinui.services.TrackingDataService;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService;
 import org.jetbrains.annotations.NotNull;
 import org.springframework.web.reactive.function.client.WebClientRequestException;
 import org.springframework.web.reactive.function.client.WebClientResponseException;
@@ -40,17 +44,22 @@
 public class TrackingDialog extends Dialog {
 
   private final AniListAPIService aniListAPI;
+  private final SuwayomiTrackingService suwayomiTrackingService;
   private final TrackingDataService dataService;
 
   public TrackingDialog(
-      TrackingDataService dataService, Manga manga, AniListAPIService aniListAPIService) {
+      TrackingDataService dataService,
+      Manga manga,
+      AniListAPIService aniListAPIService,
+      SuwayomiTrackingService suwayomiTrackingService) {
     super();
     this.dataService = dataService;
     this.aniListAPI = aniListAPIService;
+    this.suwayomiTrackingService = suwayomiTrackingService;
 
     Tracker tracker = dataService.getTracker(manga.getId());
 
-    if (!tracker.hasAniListId() || !aniListAPI.hasAniListToken()) {
+    if (!tracker.hasAniListId()) {
       addTrackingButtons(manga, aniListAPIService, tracker);
     } else {
 
@@ -73,31 +82,80 @@ public TrackingDialog(
   private void addTrackingButtons(
       Manga manga, AniListAPIService aniListAPIService, Tracker tracker) {
     VerticalLayout buttons = new VerticalLayout();
+    buttons.setId("tracking-dialog-tracker-buttons");
+
     Button aniListBtn = new Button("Anilist");
+    Button malBtn = new Button("MyAnimeList");
+
     aniListBtn.addClickListener(
         e -> {
+          boolean isAniListAuthenticated = true;
+
           if (!aniListAPIService.hasAniListToken()) {
             String url = aniListAPIService.getAniListAuthUrl();
             getUI().ifPresent(ui -> ui.getPage().open(url));
+            isAniListAuthenticated = false;
+          }
+
+          if (!suwayomiTrackingService.isAniListAuthenticated()) {
+            String url = suwayomiTrackingService.getAniListAuthUrl();
+            getUI().ifPresent(ui -> ui.getPage().open(url));
+            isAniListAuthenticated = false;
+          }
+
+          if (!isAniListAuthenticated) {
             return;
           }
 
+          TrackerProvider provider = new AniListProvider(aniListAPIService,
+              suwayomiTrackingService);
+
           try {
-            displaySearch(manga.getTitle(), manga.getId());
+            displaySearch(manga.getTitle(), manga.getId(), provider);
           } catch (WebClientResponseException.InternalServerError
-              | WebClientRequestException error) {
+                   | WebClientRequestException error) {
             log.error("Invalid response from AniList", error);
             Notification notification = new Notification();
             notification.addThemeVariants(NotificationVariant.LUMO_ERROR);
             notification.setText("Couldn't correctly connect to AniList\nPlease try again");
             notification.open();
           }
-          updateButtons(aniListBtn, tracker);
+          updateButtons(aniListBtn, malBtn, tracker);
         });
 
-    updateButtons(aniListBtn, tracker);
+    malBtn.addClickListener(e -> {
+
+      if (!suwayomiTrackingService.isMALAuthenticated()) {
+        String url = suwayomiTrackingService.getMALAuthUrl();
+        getUI().ifPresent(ui -> ui.getPage().open(url));
+        return;
+      }
 
-    buttons.add(aniListBtn);
+      TrackerProvider provider = new SuwayomiProvider(suwayomiTrackingService);
+
+      try {
+        displaySearch(manga.getTitle(), manga.getId(), provider);
+      } catch (WebClientResponseException.InternalServerError
+               | WebClientRequestException error) {
+        log.error("Invalid response from MyAnimeList", error);
+        Notification notification = new Notification();
+        notification.addThemeVariants(NotificationVariant.LUMO_ERROR);
+        notification.setText("Couldn't correctly connect to MyAnimeList\nPlease try again");
+        notification.open();
+      } catch (RuntimeException ex) {
+        log.error("Error displaying search", ex);
+        Notification notification = new Notification();
+        notification.addThemeVariants(NotificationVariant.LUMO_ERROR);
+        notification.setText("Error displaying search: " + ex.getMessage());
+        notification.open();
+      }
+
+      updateButtons(aniListBtn, malBtn, tracker);
+    });
+
+    updateButtons(aniListBtn, malBtn, tracker);
+
+    buttons.add(aniListBtn, malBtn);
 
     add(buttons);
   }
@@ -120,10 +178,10 @@ private Div getTrackingStatistics(Tracker tracker) throws RuntimeException {
       notification.addThemeVariants(NotificationVariant.LUMO_ERROR);
       notification.setText(
           """
-          The manga wasn't found on AniList.
-          Removing AniList tracking for this Manga.
-          You can add it again if you want to track it with AniList.
-          """);
+              The manga wasn't found on AniList.
+              Removing AniList tracking for this Manga.
+              You can add it again if you want to track it with AniList.
+              """);
       notification.setDuration(5000);
       notification.open();
       tracker.removeAniListId();
@@ -134,7 +192,7 @@ private Div getTrackingStatistics(Tracker tracker) throws RuntimeException {
 
     ComboBox<AniListStatus> status = getTrackingStatusField(tracker, mangaStats);
 
-    var maxChapters = aniListAPI.getChapterCount(tracker.getAniListId());
+    var maxChapters = aniListAPI.getChapterCount(tracker.getAniListId()).orElse(null);
 
     SuperIntegerField chapter = getTrackingChapterField(tracker, mangaStats, maxChapters);
 
@@ -333,7 +391,7 @@ private ComboBox<AniListStatus> getTrackingStatusField(
 
   @NotNull
   private SuperIntegerField getTrackingChapterField(
-      Tracker tracker, AniListMangaStatistics mangaStats, Optional<Integer> maxChapters) {
+      Tracker tracker, AniListMangaStatistics mangaStats, Integer maxChapters) {
     SuperIntegerField chapter = new SuperIntegerField();
     chapter.setPreventingInvalidInput(true);
     chapter.setValue(mangaStats.progress());
@@ -355,7 +413,7 @@ private SuperIntegerField getTrackingChapterField(
             return;
           }
 
-          if (maxChapters.isPresent() && e.getValue() > maxChapters.get()) {
+          if (maxChapters != null && e.getValue() > maxChapters) {
             chapter.setValue(e.getOldValue());
             return;
           }
@@ -365,8 +423,8 @@ private SuperIntegerField getTrackingChapterField(
     return chapter;
   }
 
-  private void displaySearch(String mangaName, long mangaId) {
-    var dialog = new TrackingMangaChoiceDialog(mangaName, mangaId, aniListAPI, dataService);
+  private void displaySearch(String mangaName, long mangaId, TrackerProvider trackerProvider) {
+    var dialog = new TrackingMangaChoiceDialog(mangaName, mangaId, trackerProvider, dataService);
     dialog.open();
 
     dialog.addOpenedChangeListener(
@@ -381,12 +439,20 @@ private void displaySearch(String mangaName, long mangaId) {
         });
   }
 
-  private void updateButtons(Button aniListBtn, Tracker tracker) {
+  private void updateButtons(Button aniListBtn, Button malBtn, Tracker tracker) {
     if (tracker.hasAniListId()) {
       aniListBtn.setIcon(LumoIcon.CHECKMARK.create());
       log.info("AniList ID: {}", tracker.getAniListId());
     } else {
       aniListBtn.setIcon(LumoIcon.CROSS.create());
     }
+
+    if (tracker.hasMalId()) {
+      malBtn.setIcon(LumoIcon.CHECKMARK.create());
+      log.info("MAL ID: {}", tracker.getMalId());
+    } else {
+      malBtn.setIcon(LumoIcon.CROSS.create());
+    }
+
   }
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
index dfdad921..b23d7528 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
@@ -19,9 +19,12 @@
 import com.vaadin.flow.data.renderer.ComponentRenderer;
 import java.util.List;
 import java.util.concurrent.atomic.AtomicReference;
+import javax.sound.midi.Track;
+import online.hatsunemiku.tachideskvaadinui.component.dialog.tracking.provider.TrackerProvider;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.AniListMedia;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.common.MediaDate;
-import online.hatsunemiku.tachideskvaadinui.services.AniListAPIService;
+import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
 import online.hatsunemiku.tachideskvaadinui.services.TrackingDataService;
 import org.jetbrains.annotations.NotNull;
 import org.vaadin.miki.shared.labels.LabelPosition;
@@ -32,7 +35,7 @@ public class TrackingMangaChoiceDialog extends Dialog {
   public TrackingMangaChoiceDialog(
       String mangaName,
       long mangaId,
-      AniListAPIService aniListAPI,
+      TrackerProvider trackerProvider,
       TrackingDataService dataService) {
 
     this.setClassName("tracking-manga-choice-dialog");
@@ -40,15 +43,14 @@ public TrackingMangaChoiceDialog(
     TextField searchField = new TextField("Search Manga");
     searchField.setValue(mangaName);
 
-    var apiResponse = aniListAPI.searchManga(mangaName);
-    var mangaList = apiResponse.data().page().media();
+    var mangaList = trackerProvider.search(mangaName);
 
-    AtomicReference<AniListMedia> selectedManga = new AtomicReference<>();
+    AtomicReference<TrackerSearchResult> selectedManga = new AtomicReference<>();
 
     Div noResults = new Div("No results found");
     noResults.setId("no-search-results-text");
 
-    ListBox<AniListMedia> searchResults = new ListBox<>();
+    ListBox<TrackerSearchResult> searchResults = new ListBox<>();
     searchResults.addClassName("manga-search-results");
     searchResults.setRenderer(getRenderer());
     searchResults.setItems(mangaList);
@@ -59,7 +61,7 @@ public TrackingMangaChoiceDialog(
 
     searchResults.addValueChangeListener(
         e -> {
-          AniListMedia selected = e.getValue();
+          TrackerSearchResult selected = e.getValue();
 
           if (selected == null) {
             return;
@@ -77,10 +79,10 @@ public TrackingMangaChoiceDialog(
             return;
           }
 
-          var response = aniListAPI.searchManga(value);
+          var results = trackerProvider.search(value);
           mangaList.clear();
 
-          mangaList.addAll(response.data().page().media());
+          mangaList.addAll(results);
 
           searchResults.getDataProvider().refreshAll();
         });
@@ -91,6 +93,12 @@ public TrackingMangaChoiceDialog(
 
     Checkbox privateCheckbox = new Checkbox("Private");
 
+    if (!trackerProvider.canSetPrivate()) {
+      privateCheckbox.setEnabled(false);
+      privateCheckbox.addClickListener(e -> privateCheckbox.getTooltip().setOpened(true));
+      privateCheckbox.setTooltipText("This tracker does not support private entries");
+    }
+
     var buttons = new Div();
 
     Button closeBtn = new Button("Close");
@@ -105,13 +113,11 @@ public TrackingMangaChoiceDialog(
             Notification.show("Please select a manga to save");
             return;
           }
-          int aniListId = manga.id();
+          int aniListId = manga.getRemoteId();
 
-          boolean isPrivate = privateCheckbox.getValue();
+          boolean isPrivate = trackerProvider.canSetPrivate() && privateCheckbox.getValue();
 
-          if (!aniListAPI.isMangaInList(aniListId)) {
-            aniListAPI.addMangaToList(aniListId, isPrivate);
-          }
+          trackerProvider.submitToTracker(isPrivate, manga.getId(), manga.getRemoteId());
 
           dataService.getTracker(mangaId).setAniListId(aniListId);
           dataService.getTracker(mangaId).setPrivate(privateCheckbox.getValue());
@@ -127,7 +133,7 @@ public TrackingMangaChoiceDialog(
   }
 
   private static void changeSearchResultsVisibility(
-      List<AniListMedia> mangaList, ListBox<AniListMedia> searchResults, Div noResults) {
+      List<TrackerSearchResult> mangaList, ListBox<TrackerSearchResult> searchResults, Div noResults) {
     if (mangaList.isEmpty()) {
       searchResults.setVisible(false);
       noResults.setVisible(true);
@@ -138,18 +144,16 @@ private static void changeSearchResultsVisibility(
   }
 
   @NotNull
-  private static ComponentRenderer<Component, AniListMedia> getRenderer() {
+  private static ComponentRenderer<Component, TrackerSearchResult> getRenderer() {
     return new ComponentRenderer<>(
         media -> {
           Div content = new Div();
           content.setClassName("manga-search-result");
 
-          MediaDate mangaDate = media.date();
-
           Div upperHalf = new Div();
           upperHalf.setClassName("manga-search-result-upper-half");
 
-          Image image = new Image(media.coverImage().large(), "Cover Image");
+          Image image = new Image(media.getCoverUrl(), "Cover Image");
 
           Div data = new Div();
 
@@ -157,7 +161,7 @@ private static ComponentRenderer<Component, AniListMedia> getRenderer() {
               new LabelField<String>()
                   .withLabelPosition(LabelPosition.BEFORE_MIDDLE)
                   .withLabel("Title")
-                  .withValue(media.title().userPreferred());
+                  .withValue(media.getTitle());
 
           title.setClassName("manga-search-result-attribute");
 
@@ -165,16 +169,15 @@ private static ComponentRenderer<Component, AniListMedia> getRenderer() {
               new LabelField<String>()
                   .withLabelPosition(LabelPosition.BEFORE_MIDDLE)
                   .withLabel("Type")
-                  .withValue(media.format());
+                  .withValue(media.getTypeFormatted());
 
           type.addClassName("manga-search-result-attribute");
 
-          String date = "%s-%s-%s".formatted(mangaDate.year(), mangaDate.month(), mangaDate.day());
           LabelField<String> started =
               new LabelField<String>()
                   .withLabelPosition(LabelPosition.BEFORE_MIDDLE)
                   .withLabel("Started")
-                  .withValue(date);
+                  .withValue(media.getStartDate());
 
           started.addClassName("manga-search-result-attribute");
 
@@ -182,7 +185,7 @@ private static ComponentRenderer<Component, AniListMedia> getRenderer() {
               new LabelField<String>()
                   .withLabelPosition(LabelPosition.BEFORE_MIDDLE)
                   .withLabel("Status")
-                  .withValue(media.status());
+                  .withValue(media.getStatusFormatted());
 
           status.addClassName("manga-search-result-attribute");
 
@@ -191,7 +194,7 @@ private static ComponentRenderer<Component, AniListMedia> getRenderer() {
 
           upperHalf.add(image, data);
 
-          Text description = new Text(media.description());
+          Text description = new Text(media.getSummary());
 
           content.add(upperHalf, description);
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java
new file mode 100644
index 00000000..5b3345c7
--- /dev/null
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java
@@ -0,0 +1,39 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package online.hatsunemiku.tachideskvaadinui.component.dialog.tracking.provider;
+
+import lombok.AllArgsConstructor;
+import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService;
+
+import java.util.List;
+
+@AllArgsConstructor
+public class AniListProvider implements TrackerProvider {
+    private AniListAPIService aniListAPI;
+    private SuwayomiTrackingService suwayomiAPI;
+
+    @Override
+    public boolean canSetPrivate() {
+        return true;
+    }
+
+    @Override
+    public List<TrackerSearchResult> search(String query) {
+        return suwayomiAPI.searchAniList(query);
+    }
+
+    @Override
+    public void submitToTracker(boolean isPrivate, int mangaId, int externalId) {
+        if (isPrivate && !aniListAPI.isMangaInList(externalId)) {
+            aniListAPI.addMangaToList(mangaId, true);
+        }
+
+        suwayomiAPI.trackOnAniList(mangaId, externalId);
+    }
+}
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/SuwayomiProvider.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/SuwayomiProvider.java
new file mode 100644
index 00000000..9fae3b6d
--- /dev/null
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/SuwayomiProvider.java
@@ -0,0 +1,37 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package online.hatsunemiku.tachideskvaadinui.component.dialog.tracking.provider;
+
+import java.util.List;
+import lombok.AllArgsConstructor;
+import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService;
+
+@AllArgsConstructor
+public class SuwayomiProvider implements TrackerProvider {
+
+  private SuwayomiTrackingService suwayomiAPI;
+
+  @Override
+  public boolean canSetPrivate() {
+    return false;
+  }
+
+  @Override
+  public List<TrackerSearchResult> search(String query) {
+    return suwayomiAPI.searchMAL(query);
+  }
+
+  @Override
+  public void submitToTracker(boolean isPrivate, int mangaId, int externalId) {
+    if (isPrivate) {
+      throw new IllegalArgumentException("Suwayomi does not support private entries");
+    }
+
+    suwayomiAPI.trackOnMAL(mangaId, externalId);
+  }
+}
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
new file mode 100644
index 00000000..4faf1a0a
--- /dev/null
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
@@ -0,0 +1,34 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package online.hatsunemiku.tachideskvaadinui.component.dialog.tracking.provider;
+
+import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
+
+import java.util.List;
+
+public interface TrackerProvider {
+
+
+    public boolean canSetPrivate();
+
+    public List<TrackerSearchResult> search(String query);
+
+    /**
+     * @param isPrivate whether the entry should be set to private
+     * @param mangaId the id of the manga according to Suwayomi
+     * @param externalId the id of the manga on the tracker
+     * @throws IllegalArgumentException if `isPrivate` is set to true and the tracker does not support private entries
+     */
+    public void submitToTracker(boolean isPrivate, int mangaId, int externalId);
+
+    /**
+     * Equivalent to calling `submitToTracker(false, mangaId, externalId)`
+     */
+    public default void submitToTracker(int mangaId, int externalId) {
+        submitToTracker(false, mangaId, externalId);
+    }
+}
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
index 2ed3e3dc..85e9350c 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
@@ -14,12 +14,17 @@ public class Tracker {
 
   @Setter private long mangaId;
   private int aniListId;
+  private int malId;
   private boolean isPrivate;
 
   public boolean hasAniListId() {
     return aniListId != 0;
   }
 
+  public boolean hasMalId() {
+    return malId != 0;
+  }
+
   public void removeAniListId() {
     aniListId = 0;
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
new file mode 100644
index 00000000..7a792910
--- /dev/null
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
@@ -0,0 +1,129 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package online.hatsunemiku.tachideskvaadinui.data.tracking.search;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.Getter;
+
+import java.util.Objects;
+
+@Getter
+public final class TrackerSearchResult {
+  /**
+   * The url of the cover image for the manga.
+   */
+  @JsonProperty("coverUrl")
+  private final String coverUrl;
+
+  /**
+   * The id of the manga on Suwayomi.
+   */
+  @JsonProperty("id")
+  private final int id;
+
+  /**
+   * The id of the manga on the tracker site.
+   */
+  @JsonProperty("remoteId")
+  private final int remoteId;
+
+  /**
+   * The publishing status of the manga.
+   */
+  @JsonProperty("publishingStatus")
+  private final String status;
+
+  /**
+   * The type of media - e.g. manga, light novel, web novel, etc.
+   */
+  @JsonProperty("publishingType")
+  private final String type;
+
+  /**
+   * The date on which the manga started publishing.
+   */
+  @JsonProperty("startDate")
+  private final String startDate;
+
+  /**
+   * A summary of the manga.
+   */
+  @JsonProperty("summary")
+  private final String summary;
+
+  /**
+   * The title of the manga.
+   */
+  @JsonProperty("title")
+  private final String title;
+
+  /**
+   * The total number of chapters in the manga.
+   */
+  @JsonProperty("totalChapters")
+  private final int totalChapters;
+
+  /**
+   * The url of the manga on the tracker site.
+   * For AniList for example: <a href="https://anilist.co/manga/112981">https://anilist.co/manga/112981</a>
+   */
+  @JsonProperty("trackingUrl")
+  private final String trackingUrl;
+
+  public TrackerSearchResult(
+      @JsonProperty("coverUrl") String coverUrl,
+      @JsonProperty("id") int id,
+      @JsonProperty("remoteId") int remoteId,
+      @JsonProperty("publishingStatus") String status,
+      @JsonProperty("publishingType") String type,
+      @JsonProperty("startDate") String startDate,
+      @JsonProperty("summary") String summary,
+      @JsonProperty("title") String title,
+      @JsonProperty("totalChapters") int totalChapters,
+      @JsonProperty("trackingUrl") String trackingUrl) {
+    this.coverUrl = coverUrl;
+    this.id = id;
+    this.remoteId = remoteId;
+    this.status = status;
+    this.type = type;
+    this.startDate = startDate;
+    this.summary = summary;
+    this.title = title;
+    this.totalChapters = totalChapters;
+    this.trackingUrl = trackingUrl;
+  }
+
+  @Override
+  public boolean equals(Object obj) {
+    if (obj == this) return true;
+    if (obj == null || obj.getClass() != this.getClass()) return false;
+    var that = (TrackerSearchResult) obj;
+    return Objects.equals(this.coverUrl, that.coverUrl)
+        && this.id == that.id
+        && Objects.equals(this.status, that.status)
+        && Objects.equals(this.type, that.type)
+        && Objects.equals(this.startDate, that.startDate)
+        && Objects.equals(this.summary, that.summary)
+        && Objects.equals(this.title, that.title)
+        && this.totalChapters == that.totalChapters
+        && Objects.equals(this.trackingUrl, that.trackingUrl);
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(
+        coverUrl, id, status, type, startDate, summary, title, totalChapters, trackingUrl);
+  }
+
+  public String getTypeFormatted() {
+    return type.substring(0, 1).toUpperCase() + type.substring(1).toLowerCase();
+  }
+
+  public String getStatusFormatted() {
+    return status.substring(0, 1).toUpperCase() + status.substring(1).toLowerCase();
+  }
+}
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
index f47dca66..f14239a7 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
@@ -9,7 +9,7 @@
 import java.util.ArrayList;
 import java.util.List;
 import online.hatsunemiku.tachideskvaadinui.data.tachidesk.ExtensionRepo;
-import online.hatsunemiku.tachideskvaadinui.services.client.SuwayomiSettingsClient;
+import online.hatsunemiku.tachideskvaadinui.services.client.suwayomi.SuwayomiSettingsClient;
 import org.springframework.stereotype.Service;
 
 @Service
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/TrackingCommunicationService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/TrackingCommunicationService.java
index c0f2b5c2..4ae0badd 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/TrackingCommunicationService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/TrackingCommunicationService.java
@@ -7,6 +7,7 @@
 package online.hatsunemiku.tachideskvaadinui.services;
 
 import lombok.extern.slf4j.Slf4j;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
 import org.springframework.stereotype.Service;
 
 @Service
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java
index e0ab8d8f..ecb9a467 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java
@@ -6,6 +6,8 @@
 
 package online.hatsunemiku.tachideskvaadinui.services;
 
+import com.netflix.graphql.dgs.client.MonoGraphQLClient;
+import com.netflix.graphql.dgs.client.WebClientGraphQLClient;
 import jakarta.annotation.PreDestroy;
 import java.net.URI;
 import java.time.Duration;
@@ -30,6 +32,7 @@ public class WebClientService {
   private WebClient webClient;
   private HttpGraphQlClient graphQlClient;
   private WebSocketGraphQlClient webSocketGraphQlClient;
+  private WebClientGraphQLClient dgsGraphQlClient;
 
   public WebClientService(SettingsService settingsService) {
     Settings settings = settingsService.getSettings();
@@ -37,6 +40,7 @@ public WebClientService(SettingsService settingsService) {
     this.webClient = WebClient.create(settings.getUrl());
     initGraphQlClient(settings.getUrl());
     initWebSocketGraphQlClient(settings.getUrl());
+    initDgsGraphQlClient(settings.getUrl());
   }
 
   @EventListener(UrlChangeEvent.class)
@@ -45,6 +49,7 @@ protected void onUrlChange(UrlChangeEvent event) {
 
     initGraphQlClient(event.getUrl());
     initWebSocketGraphQlClient(event.getUrl());
+    initDgsGraphQlClient(event.getUrl());
   }
 
   @PreDestroy
@@ -86,4 +91,13 @@ private void initWebSocketGraphQlClient(String url) {
 
     this.webSocketGraphQlClient = WebSocketGraphQlClient.create(uri, webSocketClient);
   }
+
+  private void initDgsGraphQlClient(String url) {
+    url = url + "/api/graphql";
+    url = url.replace("//api", "/api");
+
+    WebClient internal = WebClient.create(url);
+
+    this.dgsGraphQlClient = MonoGraphQLClient.createWithWebClient(internal);
+  }
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/SuwayomiSettingsClient.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
similarity index 96%
rename from src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/SuwayomiSettingsClient.java
rename to src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
index 03a4df1a..7d1b74b0 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/SuwayomiSettingsClient.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
@@ -4,7 +4,7 @@
  * file, You can obtain one at https://mozilla.org/MPL/2.0/.
  */
 
-package online.hatsunemiku.tachideskvaadinui.services.client;
+package online.hatsunemiku.tachideskvaadinui.services.client.suwayomi;
 
 import java.util.List;
 import online.hatsunemiku.tachideskvaadinui.services.WebClientService;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
new file mode 100644
index 00000000..b635cb62
--- /dev/null
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
@@ -0,0 +1,173 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package online.hatsunemiku.tachideskvaadinui.services.client.suwayomi;
+
+import com.jayway.jsonpath.TypeRef;
+import java.time.Duration;
+import java.util.logging.Level;
+import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
+import online.hatsunemiku.tachideskvaadinui.services.WebClientService;
+import org.intellij.lang.annotations.Language;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
+import java.util.Map;
+
+@Component
+public class SuwayomiTrackingClient {
+
+  private static final Logger log = LoggerFactory.getLogger(SuwayomiTrackingClient.class);
+  private final WebClientService clientService;
+
+  public SuwayomiTrackingClient(WebClientService clientService) {
+    this.clientService = clientService;
+  }
+
+  public boolean isTrackerLoggedIn(int id) {
+    @Language("graphql")
+    String query =
+        """
+            query IsTrackerLoggedIn($id: Int!) {
+              tracker(id: $id) {
+                isLoggedIn
+                isTokenExpired
+              }
+            }
+            """;
+
+    Map<String, Integer> variables = Map.of("id", id);
+
+    var graphClient = clientService.getDgsGraphQlClient();
+
+    var response = graphClient.reactiveExecuteQuery(query, variables).block();
+
+    if (response == null) {
+      throw new RuntimeException("Error while checking if tracker is logged in");
+    }
+
+    return response.extractValueAsObject("tracker.isLoggedIn", Boolean.class);
+  }
+
+  public String getTrackerAuthUrl(int id) {
+    @Language("graphql")
+    String query =
+        """
+            query GetTrackerAuthUrl($id: Int!) {
+              tracker(id: $id) {
+                authUrl
+              }
+            }
+            """;
+
+    Map<String, Integer> variables = Map.of("id", id);
+
+    var graphClient = clientService.getDgsGraphQlClient();
+
+    var response = graphClient.reactiveExecuteQuery(query, variables).block();
+
+    if (response == null) {
+      throw new RuntimeException("Error while getting tracker auth url");
+    }
+
+    return response.extractValueAsObject("tracker.authUrl", String.class);
+  }
+
+  public void loginTracker(String url, int id) {
+    @Language("graphql")
+    String query = """
+        mutation LoginTracker($url: String!, $trackerId: Int!) {
+          loginTrackerOAuth(input: {callbackUrl: $url, trackerId: $trackerId}) {
+            isLoggedIn
+          }
+        }
+        """;
+
+    Map<String, Object> variables = Map.of("url", url, "trackerId", id);
+
+    var graphClient = clientService.getDgsGraphQlClient();
+
+    var response = graphClient.reactiveExecuteQuery(query, variables).block();
+
+    if (response == null) {
+      throw new RuntimeException("Error while logging in tracker");
+    }
+
+    if (!response.extractValueAsObject("loginTrackerOAuth.isLoggedIn", Boolean.class)) {
+      log.error("Server returned false after logging in the tracker with id {}", id);
+    }
+  }
+
+  public List<TrackerSearchResult> searchTracker(String query, int id) {
+    @Language("graphql")
+    String graphQuery = """
+        query searchTracker($query: String!, $id: Int!) {
+          searchTracker(input: {query: $query, trackerId: $id}) {
+            trackSearches {
+              coverUrl
+              id
+              publishingStatus
+              publishingType
+              remoteId
+              startDate
+              summary
+              title
+              totalChapters
+              trackingUrl
+            }
+          }
+        }
+        """;
+
+    Map<String, Object> variables = Map.of("query", query, "id", id);
+
+    var graphClient = clientService.getDgsGraphQlClient();
+
+    var response = graphClient.reactiveExecuteQuery(graphQuery, variables).block();
+
+    if (response == null) {
+      throw new RuntimeException("Error while searching tracker");
+    }
+
+    if (response.hasErrors()) {
+      String errorText = "Error while searching tracker: " + response.getErrors();
+      log.error(errorText);
+      throw new RuntimeException(errorText);
+    }
+
+    TypeRef<List<TrackerSearchResult>> typeRef = new TypeRef<>() {
+    };
+
+    return response.extractValueAsObject("searchTracker.trackSearches", typeRef);
+  }
+
+  public void trackMangaOnTracker(int mangaId, int externalId, int trackerId) {
+    @Language("graphql")
+    var query = """
+        mutation TrackManga($mangaId: Int!, $remoteId: Int!, $trackerId: Int!) {
+          bindTrack(input: {mangaId: $mangaId, remoteId: $remoteId, trackerId: $trackerId}) {
+            trackRecord {
+              id
+            }
+          }
+        }
+        """;
+
+    var variables = Map.of("mangaId", mangaId, "externalId", externalId, "trackerId", trackerId);
+
+    var graphClient = clientService.getDgsGraphQlClient();
+
+    Duration timeout = Duration.ofSeconds(60);
+    var optional = graphClient.reactiveExecuteQuery(query, variables).blockOptional(timeout);
+
+    if (optional.isEmpty()) {
+      throw new RuntimeException(
+          "Didn't receive a response from the server after trying to track the manga");
+    }
+  }
+}
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/AniListAPIService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
similarity index 99%
rename from src/main/java/online/hatsunemiku/tachideskvaadinui/services/AniListAPIService.java
rename to src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
index 97954d91..d57270d8 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/AniListAPIService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
@@ -4,7 +4,7 @@
  * file, You can obtain one at https://mozilla.org/MPL/2.0/.
  */
 
-package online.hatsunemiku.tachideskvaadinui.services;
+package online.hatsunemiku.tachideskvaadinui.services.tracker;
 
 import static online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.AniListStatus.CURRENT;
 
@@ -32,6 +32,7 @@
 import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.responses.AniListChangePrivacyStatusResponse;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.responses.AniListChangeStatusResponse;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.responses.AniListMangaStatistics;
+import online.hatsunemiku.tachideskvaadinui.services.TrackingDataService;
 import org.jetbrains.annotations.Nullable;
 import org.springframework.http.MediaType;
 import org.springframework.stereotype.Service;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
new file mode 100644
index 00000000..d3b3ca4c
--- /dev/null
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
@@ -0,0 +1,14 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package online.hatsunemiku.tachideskvaadinui.services.tracker;
+
+import org.springframework.stereotype.Service;
+
+@Service
+public class MyAnimeListAPIService {
+
+}
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
new file mode 100644
index 00000000..cd5d2f4d
--- /dev/null
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
@@ -0,0 +1,114 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package online.hatsunemiku.tachideskvaadinui.services.tracker;
+
+import javax.sound.midi.Track;
+import lombok.Getter;
+import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
+import online.hatsunemiku.tachideskvaadinui.services.SettingsService;
+import online.hatsunemiku.tachideskvaadinui.services.client.suwayomi.SuwayomiTrackingClient;
+import org.springframework.stereotype.Service;
+
+import java.util.Arrays;
+import java.util.List;
+
+@Service
+public class SuwayomiTrackingService {
+  private final SuwayomiTrackingClient client;
+  private final SettingsService settingsService;
+
+  public SuwayomiTrackingService(SuwayomiTrackingClient client, SettingsService settingsService) {
+    this.client = client;
+    this.settingsService = settingsService;
+  }
+
+  public boolean isAniListAuthenticated() {
+    int id = TrackerType.ANILIST.id;
+    return client.isTrackerLoggedIn(id);
+  }
+
+  public boolean isMALAuthenticated() {
+    int id = TrackerType.MAL.id;
+    return client.isTrackerLoggedIn(id);
+  }
+
+  public String getAniListAuthUrl() {
+    int id = TrackerType.ANILIST.id;
+    return client.getTrackerAuthUrl(id) + getStateAuthParam(id);
+  }
+
+  public String getMALAuthUrl() {
+    int id = TrackerType.MAL.id;
+    return client.getTrackerAuthUrl(id) + getStateAuthParam(id);
+  }
+
+  public List<TrackerSearchResult> searchAniList(String query) {
+    int id = TrackerType.ANILIST.id;
+    return client.searchTracker(query, id);
+  }
+
+    public List<TrackerSearchResult> searchMAL(String query) {
+        int id = TrackerType.MAL.id;
+        return client.searchTracker(query, id);
+    }
+
+  public void trackOnAniList(int mangaId, int externalId) {
+    int id = TrackerType.ANILIST.id;
+    client.trackMangaOnTracker(mangaId, externalId, id);
+  }
+
+  public void trackOnMAL(int mangaId, int externalId) {
+    int id = TrackerType.MAL.id;
+    client.trackMangaOnTracker(mangaId, externalId, id);
+  }
+
+
+  public void loginSuwayomi(String url, int trackerId) {
+    client.loginTracker(url, trackerId);
+  }
+
+  private String getStateAuthParam(int id) {
+
+      String jsonTemplate =
+        """
+    {\
+    "redirectUrl":"http://localhost:8080/validate/suwayomi",\
+    "trackerId":%d,\
+    "anyOtherInfo":"%s"\
+    }\
+    """.strip();
+
+    String template = "&state=%s";
+
+    String trackerName = TrackerType.fromId(id).name();
+
+    String json = jsonTemplate.formatted(id, trackerName);
+
+    return template.formatted(json);
+  }
+
+  @Getter
+  private enum TrackerType {
+    MAL(1),
+    ANILIST(2);
+
+    private final int id;
+
+    TrackerType(int id) {
+      this.id = id;
+    }
+
+    public static TrackerType fromId(int id) {
+      var match = Arrays.stream(TrackerType.values())
+              .filter(trackerType -> trackerType.id == id)
+              .findFirst();
+
+        return match.orElse(null);
+
+    }
+  }
+}
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/AniListView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/AniListView.java
index 32069ec5..7b55caf9 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/AniListView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/AniListView.java
@@ -15,7 +15,7 @@
 import online.hatsunemiku.tachideskvaadinui.component.card.AniListMediaCard;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.AniListMedia;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.MangaList;
-import online.hatsunemiku.tachideskvaadinui.services.AniListAPIService;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
 import online.hatsunemiku.tachideskvaadinui.view.layout.StandardLayout;
 
 @Route("anilist")
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
index b25b394b..d7a72e1b 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
@@ -32,10 +32,11 @@
 import online.hatsunemiku.tachideskvaadinui.data.settings.Settings;
 import online.hatsunemiku.tachideskvaadinui.data.tachidesk.Chapter;
 import online.hatsunemiku.tachideskvaadinui.data.tachidesk.Manga;
-import online.hatsunemiku.tachideskvaadinui.services.AniListAPIService;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
 import online.hatsunemiku.tachideskvaadinui.services.MangaService;
 import online.hatsunemiku.tachideskvaadinui.services.SettingsService;
 import online.hatsunemiku.tachideskvaadinui.services.TrackingDataService;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService;
 import online.hatsunemiku.tachideskvaadinui.utils.RouteUtils;
 import online.hatsunemiku.tachideskvaadinui.view.layout.StandardLayout;
 import org.jetbrains.annotations.NotNull;
@@ -48,17 +49,20 @@ public class MangaView extends StandardLayout implements BeforeEnterObserver {
   private final SettingsService settingsService;
   private final AniListAPIService aniListAPIService;
   private final TrackingDataService dataService;
+  private final SuwayomiTrackingService suwayomiTrackingService;
 
   public MangaView(
       MangaService mangaService,
       SettingsService settingsService,
       AniListAPIService aniListAPIService,
-      TrackingDataService dataService) {
+      TrackingDataService dataService,
+      SuwayomiTrackingService suwayomiTrackingService) {
     super("Manga");
     this.mangaService = mangaService;
     this.settingsService = settingsService;
     this.aniListAPIService = aniListAPIService;
     this.dataService = dataService;
+    this.suwayomiTrackingService = suwayomiTrackingService;
   }
 
   @Override
@@ -132,7 +136,8 @@ private Div getButtons(Manga manga, List<Chapter> chapters) {
 
     trackBtn.addClickListener(
         e -> {
-          TrackingDialog dialog = new TrackingDialog(dataService, manga, aniListAPIService);
+          var dialog =
+              new TrackingDialog(dataService, manga, aniListAPIService, suwayomiTrackingService);
           dialog.open();
         });
 
diff --git a/src/main/resources/schema/self.graphql b/src/main/resources/schema/self.graphql
new file mode 100644
index 00000000..e20fbb4c
--- /dev/null
+++ b/src/main/resources/schema/self.graphql
@@ -0,0 +1 @@
+# Just there for DGS not to complain about missing schema
\ No newline at end of file

From 6d03158580bfb8bf3e0bd53cbb7b1e787d9b51b3 Mon Sep 17 00:00:00 2001
From: Alessandro Schwaiger <aless2003@gmx.at>
Date: Sat, 23 Mar 2024 16:02:04 +0100
Subject: [PATCH 02/17] removed unused imports

---
 .../hatsunemiku/tachideskvaadinui/api/AuthAPI.java    | 11 ++++++-----
 .../component/dialog/tracking/TrackingDialog.java     |  1 -
 .../dialog/tracking/TrackingMangaChoiceDialog.java    |  4 ----
 .../client/suwayomi/SuwayomiTrackingClient.java       |  6 ++----
 .../services/tracker/SuwayomiTrackingService.java     |  6 ++----
 5 files changed, 10 insertions(+), 18 deletions(-)

diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
index c9d3b76f..d31ef588 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
@@ -10,18 +10,19 @@
 import elemental.json.JsonObject;
 import jakarta.servlet.http.HttpServletRequest;
 import lombok.extern.slf4j.Slf4j;
-import online.hatsunemiku.tachideskvaadinui.data.settings.Settings;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.OAuthResponse;
-import online.hatsunemiku.tachideskvaadinui.services.SettingsService;
 import online.hatsunemiku.tachideskvaadinui.services.TrackingDataService;
 import online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService;
 import org.intellij.lang.annotations.Language;
 import org.springframework.http.MediaType;
-import org.springframework.web.bind.annotation.*;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
 import org.springframework.web.servlet.view.RedirectView;
 
-import java.util.Map;
-
 @RestController
 @RequestMapping("validate")
 @Slf4j
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
index 632d940c..80db4af2 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
@@ -17,7 +17,6 @@
 import com.vaadin.flow.component.notification.NotificationVariant;
 import com.vaadin.flow.component.orderedlayout.VerticalLayout;
 import com.vaadin.flow.theme.lumo.LumoIcon;
-import graphql.GraphQLError;
 import java.time.LocalDate;
 import java.util.Objects;
 import lombok.extern.slf4j.Slf4j;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
index b23d7528..895bf013 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
@@ -19,12 +19,8 @@
 import com.vaadin.flow.data.renderer.ComponentRenderer;
 import java.util.List;
 import java.util.concurrent.atomic.AtomicReference;
-import javax.sound.midi.Track;
 import online.hatsunemiku.tachideskvaadinui.component.dialog.tracking.provider.TrackerProvider;
-import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.AniListMedia;
-import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.common.MediaDate;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
-import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
 import online.hatsunemiku.tachideskvaadinui.services.TrackingDataService;
 import org.jetbrains.annotations.NotNull;
 import org.vaadin.miki.shared.labels.LabelPosition;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
index b635cb62..a9355e44 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
@@ -8,7 +8,8 @@
 
 import com.jayway.jsonpath.TypeRef;
 import java.time.Duration;
-import java.util.logging.Level;
+import java.util.List;
+import java.util.Map;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
 import online.hatsunemiku.tachideskvaadinui.services.WebClientService;
 import org.intellij.lang.annotations.Language;
@@ -16,9 +17,6 @@
 import org.slf4j.LoggerFactory;
 import org.springframework.stereotype.Component;
 
-import java.util.List;
-import java.util.Map;
-
 @Component
 public class SuwayomiTrackingClient {
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
index cd5d2f4d..ce77063d 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
@@ -6,16 +6,14 @@
 
 package online.hatsunemiku.tachideskvaadinui.services.tracker;
 
-import javax.sound.midi.Track;
+import java.util.Arrays;
+import java.util.List;
 import lombok.Getter;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
 import online.hatsunemiku.tachideskvaadinui.services.SettingsService;
 import online.hatsunemiku.tachideskvaadinui.services.client.suwayomi.SuwayomiTrackingClient;
 import org.springframework.stereotype.Service;
 
-import java.util.Arrays;
-import java.util.List;
-
 @Service
 public class SuwayomiTrackingService {
   private final SuwayomiTrackingClient client;

From ee78cca8e44c3dff29e47defbe0860814f21a3aa Mon Sep 17 00:00:00 2001
From: Alessandro Schwaiger <aless2003@gmx.at>
Date: Tue, 2 Apr 2024 01:09:23 +0200
Subject: [PATCH 03/17] Add support for MyAnimeList manga import

Introduced a new feature for importing manga from MyAnimeList (MAL). Implemented the necessary backend functionality and views with better code sharing between import views. Also added support for refresh tokens to manage session continuity in MAL API service.
---
 build.gradle                                  |   7 +
 frontend/css/views/anilist.css                |  32 ----
 frontend/css/views/imports/importCommons.css  |  25 +++
 frontend/css/views/search-view.css            |   1 +
 .../tachideskvaadinui/api/AuthAPI.java        |  23 ++-
 .../component/card/MalMediaCard.java          |  21 +++
 .../tachideskvaadinui/config/HttpConfig.java  |   6 +
 .../data/tracking/OAuthData.java              |  42 ++++-
 .../data/tracking/OAuthResponse.java          |  11 +-
 .../data/tracking/TrackerTokens.java          |  18 +++
 .../tracker/MyAnimeListAPIService.java        | 144 ++++++++++++++++++
 .../tachideskvaadinui/view/AniListView.java   |  79 ----------
 .../tachideskvaadinui/view/SearchView.java    |  49 ++++--
 .../view/layout/TrackingLayout.java           |  62 ++++++++
 .../view/trackers/AniListView.java            | 102 +++++++++++++
 .../view/trackers/MALView.java                | 107 +++++++++++++
 16 files changed, 603 insertions(+), 126 deletions(-)
 create mode 100644 frontend/css/views/imports/importCommons.css
 create mode 100644 src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
 delete mode 100644 src/main/java/online/hatsunemiku/tachideskvaadinui/view/AniListView.java
 create mode 100644 src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
 create mode 100644 src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
 create mode 100644 src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java

diff --git a/build.gradle b/build.gradle
index ac1cdd04..45990ca2 100644
--- a/build.gradle
+++ b/build.gradle
@@ -65,9 +65,16 @@ dependencies {
     implementation 'io.github.openfeign.form:feign-form-spring:3.8.0'
     implementation 'io.github.openfeign:feign-okhttp:12.4'
 
+    //MAL API
+    implementation 'dev.katsute:mal4j:3.4.2'
+
     //GraphQL
     implementation "com.netflix.graphql.dgs:graphql-dgs-spring-boot-starter"
 
+    //Apache Commons codec -> used for URL encoding
+    implementation 'commons-codec:commons-codec:1.16.1'
+
+
     implementation 'pl.unforgiven:superfields:0.18.3'
     implementation 'com.squareup.okhttp3:okhttp:4.11.0'
     implementation 'commons-validator:commons-validator:1.7'
diff --git a/frontend/css/views/anilist.css b/frontend/css/views/anilist.css
index 471bfccd..4b4a4520 100644
--- a/frontend/css/views/anilist.css
+++ b/frontend/css/views/anilist.css
@@ -4,35 +4,3 @@
  * file, You can obtain one at https://mozilla.org/MPL/2.0/.
  */
 
-.anilist-title-section {
-  display: flex;
-  justify-content: center;
-  width: 100%;
-  background-color: var(--miku-unselected-color);
-  color: var(--miku-main-color);
-  font-size: 1.5rem;
-  font-weight: 600;
-  margin-bottom: 0.6rem;
-  padding: 0.2rem;
-  border-radius: 0.5rem;
-}
-
-.anilist-content {
-  width: 100%;
-  padding: 0.6rem;
-  border: 2px solid var(--miku-main-color);
-  border-radius: 0.5rem;
-}
-
-.anilist-content-grid {
-  display: grid;
-  grid-template-columns: repeat(5, minmax(200px, 1fr));
-  grid-gap: 1rem;
-}
-
-.anilist-view .button-container {
-  display: flex;
-  justify-content: center;
-  width: 100%;
-  height: 100%;
-}
\ No newline at end of file
diff --git a/frontend/css/views/imports/importCommons.css b/frontend/css/views/imports/importCommons.css
new file mode 100644
index 00000000..02cbbdf4
--- /dev/null
+++ b/frontend/css/views/imports/importCommons.css
@@ -0,0 +1,25 @@
+.import-title-section {
+  display: flex;
+  justify-content: center;
+  width: 100%;
+  background-color: var(--miku-unselected-color);
+  color: var(--miku-main-color);
+  font-size: 1.5rem;
+  font-weight: 600;
+  margin-bottom: 0.6rem;
+  padding: 0.2rem;
+  border-radius: 0.5rem;
+}
+
+.import-content {
+  width: 100%;
+  padding: 0.6rem;
+  border: 2px solid var(--miku-main-color);
+  border-radius: 0.5rem;
+}
+
+.import-content-grid {
+  display: grid;
+  grid-template-columns: repeat(5, minmax(200px, 1fr));
+  grid-gap: 1rem;
+}
\ No newline at end of file
diff --git a/frontend/css/views/search-view.css b/frontend/css/views/search-view.css
index 1d6649a1..6f769806 100644
--- a/frontend/css/views/search-view.css
+++ b/frontend/css/views/search-view.css
@@ -60,4 +60,5 @@
   justify-content: center;
   align-items: center;
   margin-top: 1rem;
+  gap: .5rem;
 }
\ No newline at end of file
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
index d31ef588..09aa2ddc 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
@@ -12,6 +12,7 @@
 import lombok.extern.slf4j.Slf4j;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.OAuthResponse;
 import online.hatsunemiku.tachideskvaadinui.services.TrackingDataService;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.MyAnimeListAPIService;
 import online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService;
 import org.intellij.lang.annotations.Language;
 import org.springframework.http.MediaType;
@@ -30,10 +31,12 @@ public class AuthAPI {
 
   private final TrackingDataService dataService;
   private final SuwayomiTrackingService suwayomiTrackingService;
+  private final MyAnimeListAPIService malAPI;
 
-  public AuthAPI(TrackingDataService dataService, SuwayomiTrackingService suwayomiTrackingService) {
+  public AuthAPI(TrackingDataService dataService, SuwayomiTrackingService suwayomiTrackingService, MyAnimeListAPIService malAPI) {
     this.dataService = dataService;
     this.suwayomiTrackingService = suwayomiTrackingService;
+    this.malAPI = malAPI;
   }
 
   /**
@@ -140,4 +143,22 @@ public RedirectView redirectAniListToken(@RequestBody OAuthResponse response) {
     dataService.getTokens().setAniListAuth(response);
     return new RedirectView("/");
   }
+
+  //mal = http://localhost:8080/validate/mal?code={code}
+  @GetMapping("mal")
+  public RedirectView validateMALToken(@RequestParam("code") String code, @RequestParam("state") MALTokenState state) {
+    log.info("Validating MAL token");
+
+    log.info("Code: {}", code);
+    log.info("state: {}", state);
+
+    malAPI.exchangeCodeForTokens(code, state.pkceId());
+
+    return new RedirectView("/");
+  }
+
+  public record MALTokenState(String pkceId) {
+
+  }
+
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
new file mode 100644
index 00000000..06a29df7
--- /dev/null
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
@@ -0,0 +1,21 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package online.hatsunemiku.tachideskvaadinui.component.card;
+
+import dev.katsute.mal4j.manga.Manga;
+
+public class MalMediaCard extends Card {
+
+  public MalMediaCard(Manga manga) {
+    super(manga.getTitle(), manga.getMainPicture().getLargeURL());
+
+    setHref("/search/" + manga.getTitle());
+  }
+
+
+
+}
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
index 16b97f5d..53b52843 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
@@ -10,6 +10,7 @@
 import org.springframework.context.annotation.Bean;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.web.client.RestTemplate;
+import org.springframework.web.reactive.function.client.WebClient;
 
 @Configuration
 public class HttpConfig {
@@ -18,4 +19,9 @@ public class HttpConfig {
   public RestTemplate buildRestTemplate(RestTemplateBuilder builder) {
     return builder.build();
   }
+
+  @Bean
+  public WebClient standardWebClient() {
+    return WebClient.create();
+  }
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
index 7fd7b891..72b67138 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
@@ -6,10 +6,13 @@
 
 package online.hatsunemiku.tachideskvaadinui.data.tracking;
 
+import com.fasterxml.jackson.annotation.JsonAlias;
 import com.fasterxml.jackson.annotation.JsonCreator;
 import com.fasterxml.jackson.annotation.JsonIgnore;
 import com.fasterxml.jackson.annotation.JsonProperty;
+import dev.katsute.mal4j.AccessToken;
 import java.time.Instant;
+import javax.annotation.Nullable;
 import lombok.Getter;
 
 public class OAuthData {
@@ -25,9 +28,14 @@ public class OAuthData {
   @JsonProperty("expires")
   private final String expires;
 
+  @Getter
+  @JsonProperty("refresh_token")
+  private final String refreshToken;
+
   OAuthData(OAuthResponse response) {
     String access_token = response.getAccessToken();
     String token_type = response.getTokenType();
+    String refresh_token = response.getRefreshToken();
 
     Instant now = Instant.now();
     Instant expires_in = now.plusSeconds(response.getExpiresIn());
@@ -37,13 +45,45 @@ public class OAuthData {
     this.accessToken = access_token;
     this.tokenType = token_type;
     this.expires = expires;
+    this.refreshToken = refresh_token;
+  }
+
+  public OAuthData(AccessToken token) {
+    String access_token = token.getToken();
+    String token_type = "Bearer";
+    String refresh_token = token.getRefreshToken();
+
+    Instant expiry = Instant.ofEpochSecond(token.getExpiryEpochSeconds());
+    String expires = expiry.toString();
+
+    this.accessToken = access_token;
+    this.tokenType = token_type;
+    this.expires = expires;
+    this.refreshToken = refresh_token;
   }
 
   @JsonCreator
-  private OAuthData(String accessToken, String tokenType, String expires) {
+  private OAuthData(String accessToken,
+      String tokenType,
+      @JsonAlias("expires_in") @JsonProperty("expires") String expires,
+      @Nullable String refreshToken) {
     this.accessToken = accessToken;
     this.tokenType = tokenType;
+
+    Instant expiry;
+
+    try {
+      int expiresIn = Integer.parseInt(expires);
+      expiry = Instant.now().plusSeconds(expiresIn);
+    } catch (NumberFormatException e) {
+      expiry = Instant.parse(expires);
+    }
+
+    //formats to ISO 8601 -> YYYY-MM-DDTHH:MM:SSZ Example: 2024-02-27T19:17:51Z
+    expires = expiry.toString();
+
     this.expires = expires;
+    this.refreshToken = refreshToken;
   }
 
   @JsonIgnore
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java
index 85b544d2..2758f7d8 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java
@@ -7,9 +7,12 @@
 package online.hatsunemiku.tachideskvaadinui.data.tracking;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
+import java.time.Instant;
 import lombok.Getter;
+import lombok.NoArgsConstructor;
 
 @Getter
+@NoArgsConstructor
 public class OAuthResponse {
 
   @JsonProperty("access_token")
@@ -22,5 +25,11 @@ public class OAuthResponse {
   private String tokenType;
 
   @JsonProperty("expires_in")
-  private int expiresIn;
+  private long expiresIn;
+
+  public OAuthResponse(String accessToken, Instant expiresIn, String tokenType) {
+    this.accessToken = accessToken;
+    this.expiresIn = expiresIn.getEpochSecond();
+    this.tokenType = tokenType;
+  }
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
index 7fcf9832..6ec2b309 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
@@ -8,10 +8,13 @@
 
 import java.time.Instant;
 import lombok.Getter;
+import lombok.Setter;
 
 @Getter
 public class TrackerTokens {
   private OAuthData aniListToken;
+  @Setter
+  private OAuthData malToken;
 
   public TrackerTokens() {
     aniListToken = null;
@@ -29,6 +32,21 @@ public boolean hasAniListToken() {
     return !aniListToken.getExpiresAsInstant().isBefore(Instant.now());
   }
 
+  public boolean hasMalToken() {
+    if (malToken == null) {
+      return false;
+    }
+
+    if (malToken.getAccessToken().isEmpty()) {
+      return false;
+    }
+
+    boolean expired = malToken.getExpiresAsInstant()
+        .isBefore(Instant.now());
+
+    return malToken.getRefreshToken() != null || !expired;
+  }
+
   public void setAniListAuth(OAuthResponse response) {
     aniListToken = new OAuthData(response);
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
index d3b3ca4c..168b8b76 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
@@ -6,9 +6,153 @@
 
 package online.hatsunemiku.tachideskvaadinui.services.tracker;
 
+import com.github.benmanes.caffeine.cache.Cache;
+import com.github.benmanes.caffeine.cache.Caffeine;
+import dev.katsute.mal4j.AccessToken;
+import dev.katsute.mal4j.Authorization;
+import dev.katsute.mal4j.MyAnimeList;
+import dev.katsute.mal4j.MyAnimeListAuthenticator;
+import dev.katsute.mal4j.PaginatedIterator;
+import dev.katsute.mal4j.manga.Manga;
+import dev.katsute.mal4j.manga.MangaListStatus;
+import dev.katsute.mal4j.manga.property.MangaSort;
+import dev.katsute.mal4j.manga.property.MangaStatus;
+import java.net.URLEncoder;
+import java.nio.charset.StandardCharsets;
+import java.time.Instant;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.UUID;
+import java.util.concurrent.TimeUnit;
+import javax.annotation.Nullable;
+import online.hatsunemiku.tachideskvaadinui.data.tracking.OAuthData;
+import online.hatsunemiku.tachideskvaadinui.services.TrackingDataService;
+import org.jetbrains.annotations.NotNull;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 import org.springframework.stereotype.Service;
+import org.springframework.util.LinkedMultiValueMap;
+import org.springframework.util.MultiValueMap;
+import org.springframework.web.reactive.function.client.WebClient;
 
 @Service
 public class MyAnimeListAPIService {
 
+  private static final Logger log = LoggerFactory.getLogger(MyAnimeListAPIService.class);
+  private final String CLIENT_ID = "a039c56fb609cd33ebd59381a6e9b460";
+  private final TrackingDataService tds;
+  private final WebClient webClient;
+  private final Cache<UUID, String> pkceCache;
+  @Nullable
+  private MyAnimeList mal;
+
+  public MyAnimeListAPIService(TrackingDataService tds, WebClient webClient) {
+    this.tds = tds;
+    this.webClient = webClient;
+    this.pkceCache = Caffeine.newBuilder()
+        .expireAfterWrite(10, TimeUnit.MINUTES)
+        .build();
+
+    if (!tds.getTokens().hasMalToken()) {
+      return;
+    }
+
+    OAuthData data = tds.getTokens().getMalToken();
+
+    if (data.getExpiresAsInstant().isBefore(Instant.now())) {
+      var newData = refreshToken(data.getRefreshToken());
+      tds.getTokens().setMalToken(newData);
+
+      data = newData;
+    }
+
+    authenticateMALWithToken(data);
+  }
+
+  private void authenticateMALWithToken(OAuthData data) {
+    this.mal = MyAnimeList.withToken(data.getAccessToken());
+  }
+
+
+  @NotNull
+  public String getAuthUrl() {
+    String baseUrl = "https://myanimelist.net/v1/oauth2/authorize";
+    String responseType = "code";
+    String codeChallenge = MyAnimeListAuthenticator.generatePKCE(128);
+
+    UUID pkceId = UUID.randomUUID();
+
+    pkceCache.put(pkceId, codeChallenge);
+
+    String stateParam = "{\"pkceId\"=\"%s\"}";
+    stateParam = URLEncoder.encode(stateParam.formatted(pkceId), StandardCharsets.UTF_8);
+
+    String params = "response_type=%s&client_id=%s&code_challenge=%s&state=%s";
+    params = params.formatted(responseType, CLIENT_ID, codeChallenge, pkceId.toString(),
+        stateParam);
+
+    return "%s?%s".formatted(baseUrl, params);
+  }
+
+
+  public boolean hasMalToken() {
+    return tds.getTokens().hasMalToken();
+  }
+
+  public void exchangeCodeForTokens(String code, String pkceId) {
+
+    String pkce = pkceCache.getIfPresent(UUID.fromString(pkceId));
+
+    if (pkce == null) {
+      throw new IllegalArgumentException("Invalid PKCE ID");
+    }
+
+    Authorization auth = new Authorization(CLIENT_ID, null, code, pkce);
+
+    MyAnimeListAuthenticator oauth = new MyAnimeListAuthenticator(auth);
+    AccessToken token = oauth.getAccessToken();
+
+    OAuthData data = new OAuthData(token);
+
+    tds.getTokens().setMalToken(data);
+
+    authenticateMALWithToken(data);
+  }
+
+  private OAuthData refreshToken(String refreshToken) {
+    MultiValueMap<String, String> body = new LinkedMultiValueMap<>();
+    body.add("grant_type", "refresh_token");
+    body.add("refresh_token", refreshToken);
+
+    return webClient.post()
+        .uri("https://myanimelist.net/v1/oauth2/token")
+        .headers(headers -> headers.setBasicAuth(CLIENT_ID, ""))
+        .bodyValue(body)
+        .retrieve()
+        .bodyToMono(OAuthData.class)
+        .block();
+  }
+
+  public List<Manga> getMangaWithStatus(MangaStatus status) {
+    if (mal == null) {
+      throw new IllegalStateException("Not authenticated with MAL");
+    }
+
+    PaginatedIterator<MangaListStatus> iter = mal.getUserMangaListing()
+        .withStatus(status)
+        .sortBy(MangaSort.Title)
+        .includeNSFW()
+        .searchAll();
+
+    var list = new ArrayList<MangaListStatus>();
+
+    while (iter.hasNext()) {
+      list.add(iter.next());
+    }
+
+    log.debug("Got {} manga with status {}", list.size(), status.name());
+
+    return list.stream().map(MangaListStatus::getManga).toList();
+  }
+
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/AniListView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/AniListView.java
deleted file mode 100644
index 7b55caf9..00000000
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/AniListView.java
+++ /dev/null
@@ -1,79 +0,0 @@
-/*
- * This Source Code Form is subject to the terms of the Mozilla Public
- * License, v. 2.0. If a copy of the MPL was not distributed with this
- * file, You can obtain one at https://mozilla.org/MPL/2.0/.
- */
-
-package online.hatsunemiku.tachideskvaadinui.view;
-
-import com.vaadin.flow.component.button.Button;
-import com.vaadin.flow.component.dependency.CssImport;
-import com.vaadin.flow.component.html.Div;
-import com.vaadin.flow.component.orderedlayout.VerticalLayout;
-import com.vaadin.flow.router.Route;
-import java.util.List;
-import online.hatsunemiku.tachideskvaadinui.component.card.AniListMediaCard;
-import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.AniListMedia;
-import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.MangaList;
-import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
-import online.hatsunemiku.tachideskvaadinui.view.layout.StandardLayout;
-
-@Route("anilist")
-@CssImport("./css/views/anilist.css")
-public class AniListView extends StandardLayout {
-  public AniListView(AniListAPIService apiService) {
-    super("AniList");
-
-    addClassName("anilist-view");
-
-    if (!apiService.hasAniListToken()) {
-
-      Div content = new Div();
-      content.addClassName("button-container");
-
-      Button authBtn = new Button("Authenticate");
-      authBtn.addClickListener(
-          e -> {
-            String url = apiService.getAniListAuthUrl();
-            getUI().ifPresent(ui -> ui.getPage().open(url));
-          });
-
-      content.add(authBtn);
-      setContent(content);
-      return;
-    }
-
-    MangaList list = apiService.getMangaList();
-
-    VerticalLayout content = new VerticalLayout();
-
-    var reading = getContentSection("Reading", list.reading());
-    var planToRead = getContentSection("Plan to read", list.planToRead());
-    var completed = getContentSection("Completed", list.completed());
-    var onHold = getContentSection("On hold", list.onHold());
-    var dropped = getContentSection("Dropped", list.dropped());
-
-    content.add(reading, planToRead, completed, onHold, dropped);
-
-    setContent(content);
-  }
-
-  private Div getContentSection(String title, List<AniListMedia> media) {
-    Div section = new Div();
-    section.addClassName("anilist-content");
-
-    Div titleSection = new Div();
-    titleSection.addClassName("anilist-title-section");
-    titleSection.setText(title);
-
-    Div contentGrid = new Div();
-    contentGrid.addClassName("anilist-content-grid");
-
-    for (AniListMedia manga : media) {
-      contentGrid.add(new AniListMediaCard(manga));
-    }
-
-    section.add(titleSection, contentGrid);
-    return section;
-  }
-}
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
index fa4f3f2d..36620c03 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
@@ -42,6 +42,8 @@
 import online.hatsunemiku.tachideskvaadinui.services.SettingsService;
 import online.hatsunemiku.tachideskvaadinui.services.SourceService;
 import online.hatsunemiku.tachideskvaadinui.view.layout.StandardLayout;
+import online.hatsunemiku.tachideskvaadinui.view.trackers.AniListView;
+import online.hatsunemiku.tachideskvaadinui.view.trackers.MALView;
 import org.jetbrains.annotations.NotNull;
 import org.springframework.core.io.ClassPathResource;
 import org.springframework.core.io.Resource;
@@ -78,6 +80,40 @@ public SearchView(
     Div btnContainer = new Div();
     btnContainer.addClassName("search-btn-container");
 
+    Button aniListImportBtn = getALImportBtn();
+    Button malImportBtn = getMalImportBtn();
+
+    btnContainer.add(aniListImportBtn, malImportBtn);
+
+    Div content = new Div();
+    content.setClassName("search-content");
+
+    content.add(btnContainer);
+    content.add(searchField);
+    content.add(langFilter);
+    content.add(searchResults);
+
+    setContent(content);
+  }
+
+  @NotNull
+  private Button getMalImportBtn() {
+    Button malImportBtn = new Button("Import from MAL", VaadinIcon.DOWNLOAD.create());
+
+    malImportBtn.addClickListener(e -> {
+      UI ui = getUI().orElse(UI.getCurrent());
+
+      if (ui == null) {
+        return;
+      }
+
+      ui.navigate(MALView.class);
+    });
+    return malImportBtn;
+  }
+
+  @NotNull
+  private Button getALImportBtn() {
     Button importBtn = new Button("Import from AniList", VaadinIcon.DOWNLOAD.create());
     importBtn.addClickListener(
         e -> {
@@ -94,18 +130,7 @@ public SearchView(
 
           ui.navigate(AniListView.class);
         });
-
-    btnContainer.add(importBtn);
-
-    Div content = new Div();
-    content.setClassName("search-content");
-
-    content.add(btnContainer);
-    content.add(searchField);
-    content.add(langFilter);
-    content.add(searchResults);
-
-    setContent(content);
+    return importBtn;
   }
 
   @NotNull
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
new file mode 100644
index 00000000..0bfb86ea
--- /dev/null
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
@@ -0,0 +1,62 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package online.hatsunemiku.tachideskvaadinui.view.layout;
+
+import com.vaadin.flow.component.button.Button;
+import com.vaadin.flow.component.dependency.CssImport;
+import com.vaadin.flow.component.html.Div;
+import com.vaadin.flow.component.orderedlayout.VerticalLayout;
+@CssImport("./css/views/imports/importCommons.css")
+public abstract class TrackingLayout extends StandardLayout {
+
+  public TrackingLayout(String title) {
+    super(title);
+
+    addClassName("tracking-layout");
+  }
+
+  protected void init() {
+    if (!hasToken()) {
+      Div content = new Div();
+      content.addClassName("button-container");
+
+      Button authBtn = new Button("Authenticate");
+      authBtn.addClickListener(e -> authenticate());
+
+      content.add(authBtn);
+      setContent(content);
+      return;
+    }
+
+    var reading = getReadingSection();
+    var planToRead = getPlanToReadSection();
+    var completed = getCompletedSection();
+    var onHold = getOnHoldSection();
+    var dropped = getDroppedSection();
+
+    VerticalLayout content = new VerticalLayout();
+
+    content.add(reading, planToRead, completed, onHold, dropped);
+
+    setContent(content);
+  }
+
+  public abstract boolean hasToken();
+
+  public abstract void authenticate();
+
+  public abstract Div getReadingSection();
+
+  public abstract Div getPlanToReadSection();
+
+  public abstract Div getCompletedSection();
+
+  public abstract Div getOnHoldSection();
+
+  public abstract Div getDroppedSection();
+
+}
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
new file mode 100644
index 00000000..ea254199
--- /dev/null
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
@@ -0,0 +1,102 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package online.hatsunemiku.tachideskvaadinui.view.trackers;
+
+import com.vaadin.flow.component.UI;
+import com.vaadin.flow.component.dependency.CssImport;
+import com.vaadin.flow.component.html.Div;
+import com.vaadin.flow.router.Route;
+import java.util.List;
+import online.hatsunemiku.tachideskvaadinui.component.card.AniListMediaCard;
+import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.AniListMedia;
+import online.hatsunemiku.tachideskvaadinui.data.tracking.anilist.MangaList;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
+import online.hatsunemiku.tachideskvaadinui.view.layout.TrackingLayout;
+
+@Route("anilist")
+@CssImport("./css/views/anilist.css")
+public class AniListView extends TrackingLayout {
+
+  private final AniListAPIService aniListAPI;
+  private final MangaList list;
+
+  public AniListView(AniListAPIService apiService) {
+    super("AniList");
+
+    addClassName("anilist-view");
+
+    this.aniListAPI = apiService;
+    this.list = apiService.getMangaList();
+
+    init();
+  }
+
+  private Div getContentSection(String title, List<AniListMedia> media) {
+    Div section = new Div();
+    section.addClassName("import-content");
+
+    Div titleSection = new Div();
+    titleSection.addClassName("import-title-section");
+    titleSection.setText(title);
+
+    Div contentGrid = new Div();
+    contentGrid.addClassName("import-content-grid");
+
+    for (AniListMedia manga : media) {
+      contentGrid.add(new AniListMediaCard(manga));
+    }
+
+    section.add(titleSection, contentGrid);
+    return section;
+  }
+
+
+  @Override
+  public boolean hasToken() {
+    return aniListAPI.hasAniListToken();
+  }
+
+  @Override
+  public void authenticate() {
+    String url = aniListAPI.getAniListAuthUrl();
+
+    var ui = getUI().orElse(UI.getCurrent());
+
+    if (ui == null) {
+      throw new IllegalStateException("No UI found");
+    }
+
+    ui.getPage().open(url);
+  }
+
+  @Override
+  public Div getReadingSection() {
+    return getContentSection("Reading", list.reading());
+  }
+
+  @Override
+  public Div getPlanToReadSection() {
+    return getContentSection("Plan to read", list.planToRead());
+  }
+
+  @Override
+  public Div getCompletedSection() {
+    return getContentSection("Completed", list.completed());
+  }
+
+  @Override
+  public Div getOnHoldSection() {
+    return getContentSection("On hold", list.onHold());
+  }
+
+  @Override
+  public Div getDroppedSection() {
+    return getContentSection("Dropped", list.dropped());
+  }
+
+
+}
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
new file mode 100644
index 00000000..bf699a36
--- /dev/null
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
@@ -0,0 +1,107 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package online.hatsunemiku.tachideskvaadinui.view.trackers;
+
+import com.vaadin.flow.component.UI;
+import com.vaadin.flow.component.html.Div;
+import com.vaadin.flow.router.Route;
+import dev.katsute.mal4j.manga.Manga;
+import dev.katsute.mal4j.manga.property.MangaStatus;
+import java.util.List;
+import online.hatsunemiku.tachideskvaadinui.component.card.MalMediaCard;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.MyAnimeListAPIService;
+import online.hatsunemiku.tachideskvaadinui.view.layout.TrackingLayout;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+@Route("mal")
+public class MALView extends TrackingLayout {
+
+  private static final Logger log = LoggerFactory.getLogger(MALView.class);
+  private final MyAnimeListAPIService malAPI;
+
+  public MALView(MyAnimeListAPIService malAPI) {
+    super("MyAnimeList");
+
+    this.malAPI = malAPI;
+
+    init();
+  }
+
+  @Override
+  public boolean hasToken() {
+    return malAPI.hasMalToken();
+  }
+
+  @Override
+  public void authenticate() {
+    var auth = malAPI.getAuthUrl();
+    var ui = getUI().orElse(UI.getCurrent());
+
+    if (ui == null) {
+      log.debug("Couldn't authenticate MAL: UI is null");
+      return;
+    }
+
+    ui.getPage().open(auth);
+  }
+
+  @Override
+  public Div getReadingSection() {
+    var list = malAPI.getMangaWithStatus(MangaStatus.Reading);
+
+    return getContentSection("Reading", list);
+  }
+
+  @Override
+  public Div getPlanToReadSection() {
+    var list = malAPI.getMangaWithStatus(MangaStatus.PlanToRead);
+
+    return getContentSection("Plan to Read", list);
+  }
+
+  @Override
+  public Div getCompletedSection() {
+    var list = malAPI.getMangaWithStatus(MangaStatus.Completed);
+
+    return getContentSection("Completed", list);
+  }
+
+  @Override
+  public Div getOnHoldSection() {
+    var list = malAPI.getMangaWithStatus(MangaStatus.OnHold);
+
+    return getContentSection("On Hold", list);
+  }
+
+  @Override
+  public Div getDroppedSection() {
+    var list = malAPI.getMangaWithStatus(MangaStatus.Dropped);
+
+    return getContentSection("Dropped", list);
+  }
+
+
+  private Div getContentSection(String title, List<Manga> media) {
+    Div section = new Div();
+    section.addClassName("import-content");
+
+    Div titleSection = new Div();
+    titleSection.addClassName("import-title-section");
+    titleSection.setText(title);
+
+    Div contentGrid = new Div();
+    contentGrid.addClassName("import-content-grid");
+
+    for (Manga manga : media) {
+      contentGrid.add(new MalMediaCard(manga));
+    }
+
+    section.add(titleSection, contentGrid);
+    return section;
+  }
+}

From 9b60988f5ab16cc64b4e34142d7fa0a338d4296b Mon Sep 17 00:00:00 2001
From: Alessandro Schwaiger <aless2003@gmx.at>
Date: Tue, 2 Apr 2024 23:12:01 +0200
Subject: [PATCH 04/17] Refactor getContentSection method to avoid code
 duplication.

The redundant getContentSection method has been eliminated from the AniListView and MALView files. It has been moved to the TrackingLayout, improving maintainability of the code.
---
 .../view/layout/TrackingLayout.java           | 20 +++++++++
 .../view/trackers/AniListView.java            | 45 +++++++++----------
 .../view/trackers/MALView.java                | 43 +++++++++---------
 3 files changed, 61 insertions(+), 47 deletions(-)

diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
index 0bfb86ea..ecbfaefa 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
@@ -10,6 +10,9 @@
 import com.vaadin.flow.component.dependency.CssImport;
 import com.vaadin.flow.component.html.Div;
 import com.vaadin.flow.component.orderedlayout.VerticalLayout;
+import java.util.List;
+import online.hatsunemiku.tachideskvaadinui.component.card.Card;
+
 @CssImport("./css/views/imports/importCommons.css")
 public abstract class TrackingLayout extends StandardLayout {
 
@@ -58,5 +61,22 @@ protected void init() {
   public abstract Div getOnHoldSection();
 
   public abstract Div getDroppedSection();
+  public Div getContentSection(String title, List<? extends Card> content) {
+    Div section = new Div();
+    section.addClassName("import-content");
+
+    Div titleSection = new Div();
+    titleSection.addClassName("import-title-section");
+    titleSection.setText(title);
+
+    Div contentGrid = new Div();
+    contentGrid.addClassName("import-content-grid");
+
+    content.forEach(contentGrid::add);
+
+    section.add(titleSection, contentGrid);
+
+    return section;
+  }
 
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
index ea254199..6f530ee0 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
@@ -35,25 +35,6 @@ public AniListView(AniListAPIService apiService) {
     init();
   }
 
-  private Div getContentSection(String title, List<AniListMedia> media) {
-    Div section = new Div();
-    section.addClassName("import-content");
-
-    Div titleSection = new Div();
-    titleSection.addClassName("import-title-section");
-    titleSection.setText(title);
-
-    Div contentGrid = new Div();
-    contentGrid.addClassName("import-content-grid");
-
-    for (AniListMedia manga : media) {
-      contentGrid.add(new AniListMediaCard(manga));
-    }
-
-    section.add(titleSection, contentGrid);
-    return section;
-  }
-
 
   @Override
   public boolean hasToken() {
@@ -75,27 +56,43 @@ public void authenticate() {
 
   @Override
   public Div getReadingSection() {
-    return getContentSection("Reading", list.reading());
+    var cards = getCards(list.reading());
+
+    return getContentSection("Reading", cards);
   }
 
   @Override
   public Div getPlanToReadSection() {
-    return getContentSection("Plan to read", list.planToRead());
+    var cards = getCards(list.planToRead());
+
+    return getContentSection("Plan to read", cards);
   }
 
   @Override
   public Div getCompletedSection() {
-    return getContentSection("Completed", list.completed());
+    var cards = getCards(list.completed());
+
+    return getContentSection("Completed", cards);
   }
 
   @Override
   public Div getOnHoldSection() {
-    return getContentSection("On hold", list.onHold());
+    var cards = getCards(list.onHold());
+
+    return getContentSection("On hold", cards);
   }
 
   @Override
   public Div getDroppedSection() {
-    return getContentSection("Dropped", list.dropped());
+    var cards = getCards(list.dropped());
+
+    return getContentSection("Dropped", cards);
+  }
+
+  private List<AniListMediaCard> getCards(List<AniListMedia> media) {
+    return media.stream()
+        .map(AniListMediaCard::new)
+        .toList();
   }
 
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
index bf699a36..29a78c40 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
@@ -54,54 +54,51 @@ public void authenticate() {
   public Div getReadingSection() {
     var list = malAPI.getMangaWithStatus(MangaStatus.Reading);
 
-    return getContentSection("Reading", list);
+    var cards = getCards(list);
+
+    return getContentSection("Reading", cards);
   }
 
   @Override
   public Div getPlanToReadSection() {
     var list = malAPI.getMangaWithStatus(MangaStatus.PlanToRead);
 
-    return getContentSection("Plan to Read", list);
+    var cards = getCards(list);
+
+    return getContentSection("Plan to Read", cards);
   }
 
   @Override
   public Div getCompletedSection() {
     var list = malAPI.getMangaWithStatus(MangaStatus.Completed);
 
-    return getContentSection("Completed", list);
+    var cards = getCards(list);
+
+    return getContentSection("Completed", cards);
   }
 
   @Override
   public Div getOnHoldSection() {
     var list = malAPI.getMangaWithStatus(MangaStatus.OnHold);
 
-    return getContentSection("On Hold", list);
+    var cards = getCards(list);
+
+    return getContentSection("On Hold", cards);
   }
 
   @Override
   public Div getDroppedSection() {
     var list = malAPI.getMangaWithStatus(MangaStatus.Dropped);
 
-    return getContentSection("Dropped", list);
-  }
-
+    var cards = getCards(list);
 
-  private Div getContentSection(String title, List<Manga> media) {
-    Div section = new Div();
-    section.addClassName("import-content");
-
-    Div titleSection = new Div();
-    titleSection.addClassName("import-title-section");
-    titleSection.setText(title);
-
-    Div contentGrid = new Div();
-    contentGrid.addClassName("import-content-grid");
-
-    for (Manga manga : media) {
-      contentGrid.add(new MalMediaCard(manga));
-    }
+    return getContentSection("Dropped", cards);
+  }
 
-    section.add(titleSection, contentGrid);
-    return section;
+  private List<MalMediaCard> getCards(List<Manga> media) {
+    return media.stream()
+        .map(MalMediaCard::new)
+        .toList();
   }
+
 }

From 3ef686c45ae67190ee9bfbf8c05f763802d9f0f1 Mon Sep 17 00:00:00 2001
From: "deepsource-autofix[bot]"
 <62050782+deepsource-autofix[bot]@users.noreply.github.com>
Date: Tue, 2 Apr 2024 21:33:18 +0000
Subject: [PATCH 05/17] style: format code with Google Java Format

This commit fixes the style issues introduced in 9b60988 according to the output
from Google Java Format.

Details: https://github.com/Suwayomi/Suwayomi-VaadinUI/pull/106
---
 .../tachideskvaadinui/api/AuthAPI.java        | 19 +++---
 .../component/card/MalMediaCard.java          |  3 -
 .../dialog/tracking/TrackingDialog.java       | 59 +++++++++----------
 .../tracking/TrackingMangaChoiceDialog.java   |  4 +-
 .../tracking/provider/AniListProvider.java    | 41 +++++++------
 .../tracking/provider/TrackerProvider.java    | 33 +++++------
 .../data/tracking/OAuthData.java              |  5 +-
 .../data/tracking/TrackerTokens.java          |  6 +-
 .../tracking/search/TrackerSearchResult.java  | 43 ++++----------
 .../suwayomi/SuwayomiTrackingClient.java      | 12 ++--
 .../tracker/MyAnimeListAPIService.java        | 28 ++++-----
 .../tracker/SuwayomiTrackingService.java      | 20 +++----
 .../tachideskvaadinui/view/MangaView.java     |  2 +-
 .../tachideskvaadinui/view/SearchView.java    | 15 ++---
 .../view/layout/TrackingLayout.java           |  2 +-
 .../view/trackers/AniListView.java            |  7 +--
 .../view/trackers/MALView.java                |  5 +-
 17 files changed, 135 insertions(+), 169 deletions(-)

diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
index 09aa2ddc..a344513d 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
@@ -33,7 +33,10 @@ public class AuthAPI {
   private final SuwayomiTrackingService suwayomiTrackingService;
   private final MyAnimeListAPIService malAPI;
 
-  public AuthAPI(TrackingDataService dataService, SuwayomiTrackingService suwayomiTrackingService, MyAnimeListAPIService malAPI) {
+  public AuthAPI(
+      TrackingDataService dataService,
+      SuwayomiTrackingService suwayomiTrackingService,
+      MyAnimeListAPIService malAPI) {
     this.dataService = dataService;
     this.suwayomiTrackingService = suwayomiTrackingService;
     this.malAPI = malAPI;
@@ -105,7 +108,8 @@ public String validateAniListToken() {
   }
 
   @GetMapping("suwayomi")
-  public RedirectView authenticateSuwayomi(HttpServletRequest request, @RequestParam("state") String json) {
+  public RedirectView authenticateSuwayomi(
+      HttpServletRequest request, @RequestParam("state") String json) {
     String url = request.getRequestURL() + "?" + request.getQueryString();
 
     JsonObject state = Json.parse(json);
@@ -117,7 +121,6 @@ public RedirectView authenticateSuwayomi(HttpServletRequest request, @RequestPar
     return new RedirectView("/");
   }
 
-
   /**
    * Validates the AniList token received in the request body. If the token is valid, it is saved in
    * the application settings. Otherwise, redirects the user to the homepage.
@@ -144,9 +147,10 @@ public RedirectView redirectAniListToken(@RequestBody OAuthResponse response) {
     return new RedirectView("/");
   }
 
-  //mal = http://localhost:8080/validate/mal?code={code}
+  // mal = http://localhost:8080/validate/mal?code={code}
   @GetMapping("mal")
-  public RedirectView validateMALToken(@RequestParam("code") String code, @RequestParam("state") MALTokenState state) {
+  public RedirectView validateMALToken(
+      @RequestParam("code") String code, @RequestParam("state") MALTokenState state) {
     log.info("Validating MAL token");
 
     log.info("Code: {}", code);
@@ -157,8 +161,5 @@ public RedirectView validateMALToken(@RequestParam("code") String code, @Request
     return new RedirectView("/");
   }
 
-  public record MALTokenState(String pkceId) {
-
-  }
-
+  public record MALTokenState(String pkceId) {}
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
index 06a29df7..ba0bf045 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
@@ -15,7 +15,4 @@ public MalMediaCard(Manga manga) {
 
     setHref("/search/" + manga.getTitle());
   }
-
-
-
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
index 80db4af2..7fc6743c 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
@@ -106,13 +106,13 @@ private void addTrackingButtons(
             return;
           }
 
-          TrackerProvider provider = new AniListProvider(aniListAPIService,
-              suwayomiTrackingService);
+          TrackerProvider provider =
+              new AniListProvider(aniListAPIService, suwayomiTrackingService);
 
           try {
             displaySearch(manga.getTitle(), manga.getId(), provider);
           } catch (WebClientResponseException.InternalServerError
-                   | WebClientRequestException error) {
+              | WebClientRequestException error) {
             log.error("Invalid response from AniList", error);
             Notification notification = new Notification();
             notification.addThemeVariants(NotificationVariant.LUMO_ERROR);
@@ -122,35 +122,35 @@ private void addTrackingButtons(
           updateButtons(aniListBtn, malBtn, tracker);
         });
 
-    malBtn.addClickListener(e -> {
-
-      if (!suwayomiTrackingService.isMALAuthenticated()) {
-        String url = suwayomiTrackingService.getMALAuthUrl();
-        getUI().ifPresent(ui -> ui.getPage().open(url));
-        return;
-      }
+    malBtn.addClickListener(
+        e -> {
+          if (!suwayomiTrackingService.isMALAuthenticated()) {
+            String url = suwayomiTrackingService.getMALAuthUrl();
+            getUI().ifPresent(ui -> ui.getPage().open(url));
+            return;
+          }
 
-      TrackerProvider provider = new SuwayomiProvider(suwayomiTrackingService);
+          TrackerProvider provider = new SuwayomiProvider(suwayomiTrackingService);
 
-      try {
-        displaySearch(manga.getTitle(), manga.getId(), provider);
-      } catch (WebClientResponseException.InternalServerError
-               | WebClientRequestException error) {
-        log.error("Invalid response from MyAnimeList", error);
-        Notification notification = new Notification();
-        notification.addThemeVariants(NotificationVariant.LUMO_ERROR);
-        notification.setText("Couldn't correctly connect to MyAnimeList\nPlease try again");
-        notification.open();
-      } catch (RuntimeException ex) {
-        log.error("Error displaying search", ex);
-        Notification notification = new Notification();
-        notification.addThemeVariants(NotificationVariant.LUMO_ERROR);
-        notification.setText("Error displaying search: " + ex.getMessage());
-        notification.open();
-      }
+          try {
+            displaySearch(manga.getTitle(), manga.getId(), provider);
+          } catch (WebClientResponseException.InternalServerError
+              | WebClientRequestException error) {
+            log.error("Invalid response from MyAnimeList", error);
+            Notification notification = new Notification();
+            notification.addThemeVariants(NotificationVariant.LUMO_ERROR);
+            notification.setText("Couldn't correctly connect to MyAnimeList\nPlease try again");
+            notification.open();
+          } catch (RuntimeException ex) {
+            log.error("Error displaying search", ex);
+            Notification notification = new Notification();
+            notification.addThemeVariants(NotificationVariant.LUMO_ERROR);
+            notification.setText("Error displaying search: " + ex.getMessage());
+            notification.open();
+          }
 
-      updateButtons(aniListBtn, malBtn, tracker);
-    });
+          updateButtons(aniListBtn, malBtn, tracker);
+        });
 
     updateButtons(aniListBtn, malBtn, tracker);
 
@@ -452,6 +452,5 @@ private void updateButtons(Button aniListBtn, Button malBtn, Tracker tracker) {
     } else {
       malBtn.setIcon(LumoIcon.CROSS.create());
     }
-
   }
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
index 895bf013..28ca1fb4 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
@@ -129,7 +129,9 @@ public TrackingMangaChoiceDialog(
   }
 
   private static void changeSearchResultsVisibility(
-      List<TrackerSearchResult> mangaList, ListBox<TrackerSearchResult> searchResults, Div noResults) {
+      List<TrackerSearchResult> mangaList,
+      ListBox<TrackerSearchResult> searchResults,
+      Div noResults) {
     if (mangaList.isEmpty()) {
       searchResults.setVisible(false);
       noResults.setVisible(true);
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java
index 5b3345c7..a267ee1f 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java
@@ -6,34 +6,33 @@
 
 package online.hatsunemiku.tachideskvaadinui.component.dialog.tracking.provider;
 
+import java.util.List;
 import lombok.AllArgsConstructor;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
 import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
 import online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService;
 
-import java.util.List;
-
 @AllArgsConstructor
 public class AniListProvider implements TrackerProvider {
-    private AniListAPIService aniListAPI;
-    private SuwayomiTrackingService suwayomiAPI;
-
-    @Override
-    public boolean canSetPrivate() {
-        return true;
+  private AniListAPIService aniListAPI;
+  private SuwayomiTrackingService suwayomiAPI;
+
+  @Override
+  public boolean canSetPrivate() {
+    return true;
+  }
+
+  @Override
+  public List<TrackerSearchResult> search(String query) {
+    return suwayomiAPI.searchAniList(query);
+  }
+
+  @Override
+  public void submitToTracker(boolean isPrivate, int mangaId, int externalId) {
+    if (isPrivate && !aniListAPI.isMangaInList(externalId)) {
+      aniListAPI.addMangaToList(mangaId, true);
     }
 
-    @Override
-    public List<TrackerSearchResult> search(String query) {
-        return suwayomiAPI.searchAniList(query);
-    }
-
-    @Override
-    public void submitToTracker(boolean isPrivate, int mangaId, int externalId) {
-        if (isPrivate && !aniListAPI.isMangaInList(externalId)) {
-            aniListAPI.addMangaToList(mangaId, true);
-        }
-
-        suwayomiAPI.trackOnAniList(mangaId, externalId);
-    }
+    suwayomiAPI.trackOnAniList(mangaId, externalId);
+  }
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
index 4faf1a0a..0be3d3e9 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
@@ -6,29 +6,26 @@
 
 package online.hatsunemiku.tachideskvaadinui.component.dialog.tracking.provider;
 
-import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
-
 import java.util.List;
+import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
 
 public interface TrackerProvider {
 
+  public boolean canSetPrivate();
 
-    public boolean canSetPrivate();
-
-    public List<TrackerSearchResult> search(String query);
+  public List<TrackerSearchResult> search(String query);
 
-    /**
-     * @param isPrivate whether the entry should be set to private
-     * @param mangaId the id of the manga according to Suwayomi
-     * @param externalId the id of the manga on the tracker
-     * @throws IllegalArgumentException if `isPrivate` is set to true and the tracker does not support private entries
-     */
-    public void submitToTracker(boolean isPrivate, int mangaId, int externalId);
+  /**
+   * @param isPrivate whether the entry should be set to private
+   * @param mangaId the id of the manga according to Suwayomi
+   * @param externalId the id of the manga on the tracker
+   * @throws IllegalArgumentException if `isPrivate` is set to true and the tracker does not support
+   *     private entries
+   */
+  public void submitToTracker(boolean isPrivate, int mangaId, int externalId);
 
-    /**
-     * Equivalent to calling `submitToTracker(false, mangaId, externalId)`
-     */
-    public default void submitToTracker(int mangaId, int externalId) {
-        submitToTracker(false, mangaId, externalId);
-    }
+  /** Equivalent to calling `submitToTracker(false, mangaId, externalId)` */
+  public default void submitToTracker(int mangaId, int externalId) {
+    submitToTracker(false, mangaId, externalId);
+  }
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
index 72b67138..ab838122 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
@@ -63,7 +63,8 @@ public OAuthData(AccessToken token) {
   }
 
   @JsonCreator
-  private OAuthData(String accessToken,
+  private OAuthData(
+      String accessToken,
       String tokenType,
       @JsonAlias("expires_in") @JsonProperty("expires") String expires,
       @Nullable String refreshToken) {
@@ -79,7 +80,7 @@ private OAuthData(String accessToken,
       expiry = Instant.parse(expires);
     }
 
-    //formats to ISO 8601 -> YYYY-MM-DDTHH:MM:SSZ Example: 2024-02-27T19:17:51Z
+    // formats to ISO 8601 -> YYYY-MM-DDTHH:MM:SSZ Example: 2024-02-27T19:17:51Z
     expires = expiry.toString();
 
     this.expires = expires;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
index 6ec2b309..80873d59 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
@@ -13,8 +13,7 @@
 @Getter
 public class TrackerTokens {
   private OAuthData aniListToken;
-  @Setter
-  private OAuthData malToken;
+  @Setter private OAuthData malToken;
 
   public TrackerTokens() {
     aniListToken = null;
@@ -41,8 +40,7 @@ public boolean hasMalToken() {
       return false;
     }
 
-    boolean expired = malToken.getExpiresAsInstant()
-        .isBefore(Instant.now());
+    boolean expired = malToken.getExpiresAsInstant().isBefore(Instant.now());
 
     return malToken.getRefreshToken() != null || !expired;
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
index 7a792910..ca77bf44 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
@@ -7,69 +7,50 @@
 package online.hatsunemiku.tachideskvaadinui.data.tracking.search;
 
 import com.fasterxml.jackson.annotation.JsonProperty;
-import lombok.Getter;
-
 import java.util.Objects;
+import lombok.Getter;
 
 @Getter
 public final class TrackerSearchResult {
-  /**
-   * The url of the cover image for the manga.
-   */
+  /** The url of the cover image for the manga. */
   @JsonProperty("coverUrl")
   private final String coverUrl;
 
-  /**
-   * The id of the manga on Suwayomi.
-   */
+  /** The id of the manga on Suwayomi. */
   @JsonProperty("id")
   private final int id;
 
-  /**
-   * The id of the manga on the tracker site.
-   */
+  /** The id of the manga on the tracker site. */
   @JsonProperty("remoteId")
   private final int remoteId;
 
-  /**
-   * The publishing status of the manga.
-   */
+  /** The publishing status of the manga. */
   @JsonProperty("publishingStatus")
   private final String status;
 
-  /**
-   * The type of media - e.g. manga, light novel, web novel, etc.
-   */
+  /** The type of media - e.g. manga, light novel, web novel, etc. */
   @JsonProperty("publishingType")
   private final String type;
 
-  /**
-   * The date on which the manga started publishing.
-   */
+  /** The date on which the manga started publishing. */
   @JsonProperty("startDate")
   private final String startDate;
 
-  /**
-   * A summary of the manga.
-   */
+  /** A summary of the manga. */
   @JsonProperty("summary")
   private final String summary;
 
-  /**
-   * The title of the manga.
-   */
+  /** The title of the manga. */
   @JsonProperty("title")
   private final String title;
 
-  /**
-   * The total number of chapters in the manga.
-   */
+  /** The total number of chapters in the manga. */
   @JsonProperty("totalChapters")
   private final int totalChapters;
 
   /**
-   * The url of the manga on the tracker site.
-   * For AniList for example: <a href="https://anilist.co/manga/112981">https://anilist.co/manga/112981</a>
+   * The url of the manga on the tracker site. For AniList for example: <a
+   * href="https://anilist.co/manga/112981">https://anilist.co/manga/112981</a>
    */
   @JsonProperty("trackingUrl")
   private final String trackingUrl;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
index a9355e44..2f640d97 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
@@ -78,7 +78,8 @@ query GetTrackerAuthUrl($id: Int!) {
 
   public void loginTracker(String url, int id) {
     @Language("graphql")
-    String query = """
+    String query =
+        """
         mutation LoginTracker($url: String!, $trackerId: Int!) {
           loginTrackerOAuth(input: {callbackUrl: $url, trackerId: $trackerId}) {
             isLoggedIn
@@ -103,7 +104,8 @@ mutation LoginTracker($url: String!, $trackerId: Int!) {
 
   public List<TrackerSearchResult> searchTracker(String query, int id) {
     @Language("graphql")
-    String graphQuery = """
+    String graphQuery =
+        """
         query searchTracker($query: String!, $id: Int!) {
           searchTracker(input: {query: $query, trackerId: $id}) {
             trackSearches {
@@ -138,15 +140,15 @@ query searchTracker($query: String!, $id: Int!) {
       throw new RuntimeException(errorText);
     }
 
-    TypeRef<List<TrackerSearchResult>> typeRef = new TypeRef<>() {
-    };
+    TypeRef<List<TrackerSearchResult>> typeRef = new TypeRef<>() {};
 
     return response.extractValueAsObject("searchTracker.trackSearches", typeRef);
   }
 
   public void trackMangaOnTracker(int mangaId, int externalId, int trackerId) {
     @Language("graphql")
-    var query = """
+    var query =
+        """
         mutation TrackManga($mangaId: Int!, $remoteId: Int!, $trackerId: Int!) {
           bindTrack(input: {mangaId: $mangaId, remoteId: $remoteId, trackerId: $trackerId}) {
             trackRecord {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
index 168b8b76..789720a2 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
@@ -43,15 +43,12 @@ public class MyAnimeListAPIService {
   private final TrackingDataService tds;
   private final WebClient webClient;
   private final Cache<UUID, String> pkceCache;
-  @Nullable
-  private MyAnimeList mal;
+  @Nullable private MyAnimeList mal;
 
   public MyAnimeListAPIService(TrackingDataService tds, WebClient webClient) {
     this.tds = tds;
     this.webClient = webClient;
-    this.pkceCache = Caffeine.newBuilder()
-        .expireAfterWrite(10, TimeUnit.MINUTES)
-        .build();
+    this.pkceCache = Caffeine.newBuilder().expireAfterWrite(10, TimeUnit.MINUTES).build();
 
     if (!tds.getTokens().hasMalToken()) {
       return;
@@ -73,7 +70,6 @@ private void authenticateMALWithToken(OAuthData data) {
     this.mal = MyAnimeList.withToken(data.getAccessToken());
   }
 
-
   @NotNull
   public String getAuthUrl() {
     String baseUrl = "https://myanimelist.net/v1/oauth2/authorize";
@@ -88,13 +84,12 @@ public String getAuthUrl() {
     stateParam = URLEncoder.encode(stateParam.formatted(pkceId), StandardCharsets.UTF_8);
 
     String params = "response_type=%s&client_id=%s&code_challenge=%s&state=%s";
-    params = params.formatted(responseType, CLIENT_ID, codeChallenge, pkceId.toString(),
-        stateParam);
+    params =
+        params.formatted(responseType, CLIENT_ID, codeChallenge, pkceId.toString(), stateParam);
 
     return "%s?%s".formatted(baseUrl, params);
   }
 
-
   public boolean hasMalToken() {
     return tds.getTokens().hasMalToken();
   }
@@ -124,7 +119,8 @@ private OAuthData refreshToken(String refreshToken) {
     body.add("grant_type", "refresh_token");
     body.add("refresh_token", refreshToken);
 
-    return webClient.post()
+    return webClient
+        .post()
         .uri("https://myanimelist.net/v1/oauth2/token")
         .headers(headers -> headers.setBasicAuth(CLIENT_ID, ""))
         .bodyValue(body)
@@ -138,11 +134,12 @@ public List<Manga> getMangaWithStatus(MangaStatus status) {
       throw new IllegalStateException("Not authenticated with MAL");
     }
 
-    PaginatedIterator<MangaListStatus> iter = mal.getUserMangaListing()
-        .withStatus(status)
-        .sortBy(MangaSort.Title)
-        .includeNSFW()
-        .searchAll();
+    PaginatedIterator<MangaListStatus> iter =
+        mal.getUserMangaListing()
+            .withStatus(status)
+            .sortBy(MangaSort.Title)
+            .includeNSFW()
+            .searchAll();
 
     var list = new ArrayList<MangaListStatus>();
 
@@ -154,5 +151,4 @@ public List<Manga> getMangaWithStatus(MangaStatus status) {
 
     return list.stream().map(MangaListStatus::getManga).toList();
   }
-
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
index ce77063d..be1be77f 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
@@ -49,10 +49,10 @@ public List<TrackerSearchResult> searchAniList(String query) {
     return client.searchTracker(query, id);
   }
 
-    public List<TrackerSearchResult> searchMAL(String query) {
-        int id = TrackerType.MAL.id;
-        return client.searchTracker(query, id);
-    }
+  public List<TrackerSearchResult> searchMAL(String query) {
+    int id = TrackerType.MAL.id;
+    return client.searchTracker(query, id);
+  }
 
   public void trackOnAniList(int mangaId, int externalId) {
     int id = TrackerType.ANILIST.id;
@@ -64,21 +64,21 @@ public void trackOnMAL(int mangaId, int externalId) {
     client.trackMangaOnTracker(mangaId, externalId, id);
   }
 
-
   public void loginSuwayomi(String url, int trackerId) {
     client.loginTracker(url, trackerId);
   }
 
   private String getStateAuthParam(int id) {
 
-      String jsonTemplate =
+    String jsonTemplate =
         """
     {\
     "redirectUrl":"http://localhost:8080/validate/suwayomi",\
     "trackerId":%d,\
     "anyOtherInfo":"%s"\
     }\
-    """.strip();
+    """
+            .strip();
 
     String template = "&state=%s";
 
@@ -101,12 +101,12 @@ private enum TrackerType {
     }
 
     public static TrackerType fromId(int id) {
-      var match = Arrays.stream(TrackerType.values())
+      var match =
+          Arrays.stream(TrackerType.values())
               .filter(trackerType -> trackerType.id == id)
               .findFirst();
 
-        return match.orElse(null);
-
+      return match.orElse(null);
     }
   }
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
index d7a72e1b..ed65c8f2 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
@@ -32,10 +32,10 @@
 import online.hatsunemiku.tachideskvaadinui.data.settings.Settings;
 import online.hatsunemiku.tachideskvaadinui.data.tachidesk.Chapter;
 import online.hatsunemiku.tachideskvaadinui.data.tachidesk.Manga;
-import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
 import online.hatsunemiku.tachideskvaadinui.services.MangaService;
 import online.hatsunemiku.tachideskvaadinui.services.SettingsService;
 import online.hatsunemiku.tachideskvaadinui.services.TrackingDataService;
+import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
 import online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService;
 import online.hatsunemiku.tachideskvaadinui.utils.RouteUtils;
 import online.hatsunemiku.tachideskvaadinui.view.layout.StandardLayout;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
index 36620c03..a27417cd 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
@@ -100,15 +100,16 @@ public SearchView(
   private Button getMalImportBtn() {
     Button malImportBtn = new Button("Import from MAL", VaadinIcon.DOWNLOAD.create());
 
-    malImportBtn.addClickListener(e -> {
-      UI ui = getUI().orElse(UI.getCurrent());
+    malImportBtn.addClickListener(
+        e -> {
+          UI ui = getUI().orElse(UI.getCurrent());
 
-      if (ui == null) {
-        return;
-      }
+          if (ui == null) {
+            return;
+          }
 
-      ui.navigate(MALView.class);
-    });
+          ui.navigate(MALView.class);
+        });
     return malImportBtn;
   }
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
index ecbfaefa..ee6d8227 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
@@ -61,6 +61,7 @@ protected void init() {
   public abstract Div getOnHoldSection();
 
   public abstract Div getDroppedSection();
+
   public Div getContentSection(String title, List<? extends Card> content) {
     Div section = new Div();
     section.addClassName("import-content");
@@ -78,5 +79,4 @@ public Div getContentSection(String title, List<? extends Card> content) {
 
     return section;
   }
-
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
index 6f530ee0..2c696701 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
@@ -35,7 +35,6 @@ public AniListView(AniListAPIService apiService) {
     init();
   }
 
-
   @Override
   public boolean hasToken() {
     return aniListAPI.hasAniListToken();
@@ -90,10 +89,6 @@ public Div getDroppedSection() {
   }
 
   private List<AniListMediaCard> getCards(List<AniListMedia> media) {
-    return media.stream()
-        .map(AniListMediaCard::new)
-        .toList();
+    return media.stream().map(AniListMediaCard::new).toList();
   }
-
-
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
index 29a78c40..ad1bc610 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
@@ -96,9 +96,6 @@ public Div getDroppedSection() {
   }
 
   private List<MalMediaCard> getCards(List<Manga> media) {
-    return media.stream()
-        .map(MalMediaCard::new)
-        .toList();
+    return media.stream().map(MalMediaCard::new).toList();
   }
-
 }

From 924b2dd1a14d8852371eeff9760726211850983e Mon Sep 17 00:00:00 2001
From: Alessandro Schwaiger <aless2003@gmx.at>
Date: Tue, 2 Apr 2024 23:39:46 +0200
Subject: [PATCH 06/17] Fix JAVA-D1003 and remove unused variable

---
 .../online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java | 4 ++++
 .../services/tracker/SuwayomiTrackingService.java         | 8 ++++----
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
index 09aa2ddc..e4c62da0 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
@@ -157,6 +157,10 @@ public RedirectView validateMALToken(@RequestParam("code") String code, @Request
     return new RedirectView("/");
   }
 
+  /**
+   * Represents the state parameter of a MAL token response.
+   * Contains the PKCE (Proof Key for Code Exchange) ID to be used in the token exchange.
+   */
   public record MALTokenState(String pkceId) {
 
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
index ce77063d..981fbc83 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
@@ -10,18 +10,15 @@
 import java.util.List;
 import lombok.Getter;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
-import online.hatsunemiku.tachideskvaadinui.services.SettingsService;
 import online.hatsunemiku.tachideskvaadinui.services.client.suwayomi.SuwayomiTrackingClient;
 import org.springframework.stereotype.Service;
 
 @Service
 public class SuwayomiTrackingService {
   private final SuwayomiTrackingClient client;
-  private final SettingsService settingsService;
 
-  public SuwayomiTrackingService(SuwayomiTrackingClient client, SettingsService settingsService) {
+  public SuwayomiTrackingService(SuwayomiTrackingClient client) {
     this.client = client;
-    this.settingsService = settingsService;
   }
 
   public boolean isAniListAuthenticated() {
@@ -89,6 +86,9 @@ private String getStateAuthParam(int id) {
     return template.formatted(json);
   }
 
+  /**
+   * An enumeration representing different types of trackers.
+   */
   @Getter
   private enum TrackerType {
     MAL(1),

From f1579f7001d0211fa8565901cee68449670402d0 Mon Sep 17 00:00:00 2001
From: "deepsource-autofix[bot]"
 <62050782+deepsource-autofix[bot]@users.noreply.github.com>
Date: Tue, 2 Apr 2024 21:41:51 +0000
Subject: [PATCH 07/17] style: format code with Google Java Format

This commit fixes the style issues introduced in ec6aa3b according to the output
from Google Java Format.

Details: https://github.com/Suwayomi/Suwayomi-VaadinUI/pull/106
---
 .../hatsunemiku/tachideskvaadinui/api/AuthAPI.java     | 10 +++-------
 .../services/tracker/SuwayomiTrackingService.java      |  4 +---
 2 files changed, 4 insertions(+), 10 deletions(-)

diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
index 3303694b..60ab65fb 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
@@ -121,7 +121,6 @@ public RedirectView authenticateSuwayomi(
     return new RedirectView("/");
   }
 
-
   /**
    * Validates the AniList token received in the request body. If the token is valid, it is saved in
    * the application settings. Otherwise, redirects the user to the homepage.
@@ -163,11 +162,8 @@ public RedirectView validateMALToken(
   }
 
   /**
-   * Represents the state parameter of a MAL token response.
-   * Contains the PKCE (Proof Key for Code Exchange) ID to be used in the token exchange.
+   * Represents the state parameter of a MAL token response. Contains the PKCE (Proof Key for Code
+   * Exchange) ID to be used in the token exchange.
    */
-  public record MALTokenState(String pkceId) {
-
-  }
-
+  public record MALTokenState(String pkceId) {}
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
index f847eae6..54183477 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
@@ -86,9 +86,7 @@ private String getStateAuthParam(int id) {
     return template.formatted(json);
   }
 
-  /**
-   * An enumeration representing different types of trackers.
-   */
+  /** An enumeration representing different types of trackers. */
   @Getter
   private enum TrackerType {
     MAL(1),

From 37e78c5af1f8e7ca8cea3a0927b1c7fd9c1d2470 Mon Sep 17 00:00:00 2001
From: "deepsource-autofix[bot]"
 <62050782+deepsource-autofix[bot]@users.noreply.github.com>
Date: Wed, 3 Apr 2024 18:21:17 +0000
Subject: [PATCH 08/17] refactor: autofix issues in 1 file

Resolved issues in src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java with DeepSource Autofix
---
 .../tachideskvaadinui/view/layout/TrackingLayout.java           | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
index ee6d8227..04254223 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
@@ -16,7 +16,7 @@
 @CssImport("./css/views/imports/importCommons.css")
 public abstract class TrackingLayout extends StandardLayout {
 
-  public TrackingLayout(String title) {
+  protected TrackingLayout(String title) {
     super(title);
 
     addClassName("tracking-layout");

From 54480c7fd77296e84240d01922c1afdb7bab303b Mon Sep 17 00:00:00 2001
From: Alessandro Schwaiger <aless2003@gmx.at>
Date: Thu, 4 Apr 2024 22:22:38 +0200
Subject: [PATCH 09/17] Fix JAVA-D1002

Added docs to Constructors
---
 .../tachideskvaadinui/api/AuthAPI.java        |  7 ++
 .../component/card/MalMediaCard.java          |  5 ++
 .../dialog/tracking/TrackingDialog.java       |  8 ++
 .../tracking/TrackingMangaChoiceDialog.java   |  8 ++
 .../data/tracking/OAuthData.java              | 21 +++++
 .../data/tracking/OAuthResponse.java          |  9 +++
 .../data/tracking/TrackerTokens.java          |  3 +
 .../tracking/search/TrackerSearchResult.java  | 78 ++++++++++++++-----
 .../services/SuwayomiSettingsService.java     |  6 ++
 .../services/WebClientService.java            |  5 ++
 .../suwayomi/SuwayomiTrackingClient.java      |  5 ++
 .../tracker/MyAnimeListAPIService.java        |  6 ++
 .../tracker/SuwayomiTrackingService.java      | 24 ++++--
 .../tachideskvaadinui/view/MangaView.java     |  9 +++
 .../tachideskvaadinui/view/SearchView.java    |  7 ++
 .../view/layout/TrackingLayout.java           |  5 ++
 .../view/trackers/AniListView.java            |  5 ++
 .../view/trackers/MALView.java                |  5 ++
 18 files changed, 191 insertions(+), 25 deletions(-)

diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
index 3303694b..2505f705 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
@@ -33,6 +33,13 @@ public class AuthAPI {
   private final SuwayomiTrackingService suwayomiTrackingService;
   private final MyAnimeListAPIService malAPI;
 
+  /**
+   * Creates a new instance of the {@link AuthAPI} class.
+   *
+   * @param dataService the {@link TrackingDataService} instance used to store the authentication.
+   * @param suwayomiTrackingService the {@link SuwayomiTrackingService} instance used to authenticate with Suwayomi.
+   * @param malAPI the {@link MyAnimeListAPIService} instance used to authenticate with MyAnimeList.
+   */
   public AuthAPI(
       TrackingDataService dataService,
       SuwayomiTrackingService suwayomiTrackingService,
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
index ba0bf045..e11a6e86 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
@@ -10,6 +10,11 @@
 
 public class MalMediaCard extends Card {
 
+  /**
+   * Creates a new instance of the {@link MalMediaCard} class.
+   *
+   * @param manga the {@link Manga} object to create a card component for.
+   */
   public MalMediaCard(Manga manga) {
     super(manga.getTitle(), manga.getMainPicture().getLargeURL());
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
index 7fc6743c..0191f217 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
@@ -46,6 +46,14 @@ public class TrackingDialog extends Dialog {
   private final SuwayomiTrackingService suwayomiTrackingService;
   private final TrackingDataService dataService;
 
+  /**
+   * Constructs a {@link TrackingDialog} with the given parameters.
+   *
+   * @param dataService             The {@link TrackingDataService} used for storing tracking data.
+   * @param manga                   the {@link Manga} to track with the dialog.
+   * @param aniListAPIService       the {@link AniListAPIService} used for making requests to the AniList API.
+   * @param suwayomiTrackingService the {@link SuwayomiTrackingService} used for making requests to the Suwayomi API.
+   */
   public TrackingDialog(
       TrackingDataService dataService,
       Manga manga,
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
index 28ca1fb4..cae61831 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
@@ -28,6 +28,14 @@
 
 public class TrackingMangaChoiceDialog extends Dialog {
 
+  /**
+   * Constructs a {@link TrackingMangaChoiceDialog}.
+   *
+   * @param mangaName the name of the manga to search
+   * @param mangaId the ID of the manga on Suwayomi
+   * @param trackerProvider the {@link TrackerProvider} to use for tracking activities.
+   * @param dataService the {@link TrackingDataService} to use for saving tracking data.
+   */
   public TrackingMangaChoiceDialog(
       String mangaName,
       long mangaId,
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
index ab838122..0b401558 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
@@ -12,6 +12,7 @@
 import com.fasterxml.jackson.annotation.JsonProperty;
 import dev.katsute.mal4j.AccessToken;
 import java.time.Instant;
+import java.time.format.DateTimeFormatter;
 import javax.annotation.Nullable;
 import lombok.Getter;
 
@@ -32,6 +33,12 @@ public class OAuthData {
   @JsonProperty("refresh_token")
   private final String refreshToken;
 
+  /**
+   * Constructs an {@link OAuthData} object from an OAuthResponse.
+   *
+   * @param response the {@link OAuthResponse} object to deconstruct into an {@link OAuthData}
+   *                 object.
+   */
   OAuthData(OAuthResponse response) {
     String access_token = response.getAccessToken();
     String token_type = response.getTokenType();
@@ -48,6 +55,12 @@ public class OAuthData {
     this.refreshToken = refresh_token;
   }
 
+  /**
+   * Constructs an {@link OAuthData} object from an {@link AccessToken} object.
+   *
+   * @param token the {@link AccessToken} object used to construct the OAuthData. It contains the
+   *              necessary data, such as the access token, refresh token, and expiry information.
+   */
   public OAuthData(AccessToken token) {
     String access_token = token.getToken();
     String token_type = "Bearer";
@@ -62,6 +75,14 @@ public OAuthData(AccessToken token) {
     this.refreshToken = refresh_token;
   }
 
+  /**
+   * Constructs an {@link OAuthData} object. Only used for deserialization purposes.
+   *
+   * @param accessToken  the access token for OAuth authentication.
+   * @param tokenType    the type of token returned by the OAuth server. e.g. "Bearer".
+   * @param expires      the expiry time of the access token as a {@link String}. This can be either a number of seconds or an ISO 8601 formatted date. see {@link DateTimeFormatter#ISO_INSTANT}
+   * @param refreshToken the refresh token for OAuth authentication. May be null.
+   */
   @JsonCreator
   private OAuthData(
       String accessToken,
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java
index 2758f7d8..adc1fa8a 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java
@@ -27,6 +27,15 @@ public class OAuthResponse {
   @JsonProperty("expires_in")
   private long expiresIn;
 
+  /**
+   * Creates a new instance of the {@link OAuthResponse} class.
+   *
+   * @param accessToken the access token returned by the OAuth server.
+   * @param expiresIn   the {@link Instant} instance that represents the point in time at which the
+   *                    access token expires.
+   * @param tokenType   the type of token returned by the OAuth Server. e.g. "Bearer".
+   */
+  @SuppressWarnings("unused") // Used by Spring when deserializing a request in AuthAPI
   public OAuthResponse(String accessToken, Instant expiresIn, String tokenType) {
     this.accessToken = accessToken;
     this.expiresIn = expiresIn.getEpochSecond();
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
index 80873d59..033e4641 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
@@ -15,6 +15,9 @@ public class TrackerTokens {
   private OAuthData aniListToken;
   @Setter private OAuthData malToken;
 
+  /**
+   * Creates a new instance of the {@link TrackerTokens} class.
+   */
   public TrackerTokens() {
     aniListToken = null;
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
index ca77bf44..100334fd 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
@@ -9,42 +9,62 @@
 import com.fasterxml.jackson.annotation.JsonProperty;
 import java.util.Objects;
 import lombok.Getter;
+import org.jetbrains.annotations.Contract;
 
 @Getter
 public final class TrackerSearchResult {
-  /** The url of the cover image for the manga. */
+
+  /**
+   * The url of the cover image for the manga.
+   */
   @JsonProperty("coverUrl")
   private final String coverUrl;
 
-  /** The id of the manga on Suwayomi. */
+  /**
+   * The id of the manga on Suwayomi.
+   */
   @JsonProperty("id")
   private final int id;
 
-  /** The id of the manga on the tracker site. */
+  /**
+   * The id of the manga on the tracker site.
+   */
   @JsonProperty("remoteId")
   private final int remoteId;
 
-  /** The publishing status of the manga. */
+  /**
+   * The publishing status of the manga.
+   */
   @JsonProperty("publishingStatus")
   private final String status;
 
-  /** The type of media - e.g. manga, light novel, web novel, etc. */
+  /**
+   * The type of media - e.g. manga, light novel, web novel, etc.
+   */
   @JsonProperty("publishingType")
   private final String type;
 
-  /** The date on which the manga started publishing. */
+  /**
+   * The date on which the manga started publishing.
+   */
   @JsonProperty("startDate")
   private final String startDate;
 
-  /** A summary of the manga. */
+  /**
+   * A summary of the manga.
+   */
   @JsonProperty("summary")
   private final String summary;
 
-  /** The title of the manga. */
+  /**
+   * The title of the manga.
+   */
   @JsonProperty("title")
   private final String title;
 
-  /** The total number of chapters in the manga. */
+  /**
+   * The total number of chapters in the manga.
+   */
   @JsonProperty("totalChapters")
   private final int totalChapters;
 
@@ -55,6 +75,22 @@ public final class TrackerSearchResult {
   @JsonProperty("trackingUrl")
   private final String trackingUrl;
 
+  /**
+   * Constructs a new instance of the {@link TrackerSearchResult} class. This is used for
+   * deserializing the JSON response from the Suwayomi Server.
+   *
+   * @param coverUrl      The url of the cover image for the manga.
+   * @param id            The id of the manga on Suwayomi.
+   * @param remoteId      The id of the manga on the tracker site. e.g. AniList, MAL, etc.
+   * @param status        The publishing status of the manga. e.g. Finished, Publishing, etc.
+   * @param type          The type of media - e.g. manga, light novel, web novel, etc.
+   * @param startDate     The date on which the manga started publishing.
+   * @param summary       A summary/description of the manga.
+   * @param title         The title of the manga.
+   * @param totalChapters The total number of chapters in the manga.
+   * @param trackingUrl   The url of the manga on the tracker site.
+   */
+  @Contract(pure = true)
   public TrackerSearchResult(
       @JsonProperty("coverUrl") String coverUrl,
       @JsonProperty("id") int id,
@@ -80,18 +116,22 @@ public TrackerSearchResult(
 
   @Override
   public boolean equals(Object obj) {
-    if (obj == this) return true;
-    if (obj == null || obj.getClass() != this.getClass()) return false;
+    if (obj == this) {
+      return true;
+    }
+    if (obj == null || obj.getClass() != this.getClass()) {
+      return false;
+    }
     var that = (TrackerSearchResult) obj;
     return Objects.equals(this.coverUrl, that.coverUrl)
-        && this.id == that.id
-        && Objects.equals(this.status, that.status)
-        && Objects.equals(this.type, that.type)
-        && Objects.equals(this.startDate, that.startDate)
-        && Objects.equals(this.summary, that.summary)
-        && Objects.equals(this.title, that.title)
-        && this.totalChapters == that.totalChapters
-        && Objects.equals(this.trackingUrl, that.trackingUrl);
+           && this.id == that.id
+           && Objects.equals(this.status, that.status)
+           && Objects.equals(this.type, that.type)
+           && Objects.equals(this.startDate, that.startDate)
+           && Objects.equals(this.summary, that.summary)
+           && Objects.equals(this.title, that.title)
+           && this.totalChapters == that.totalChapters
+           && Objects.equals(this.trackingUrl, that.trackingUrl);
   }
 
   @Override
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
index f14239a7..dd6a8806 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
@@ -17,6 +17,12 @@ public class SuwayomiSettingsService {
 
   private final SuwayomiSettingsClient client;
 
+  /**
+   * Creates a new instance of the {@link SuwayomiSettingsService} class.
+   *
+   * @param client the {@link SuwayomiSettingsClient} used for making API requests to the Suwayomi
+   *               Server.
+   */
   public SuwayomiSettingsService(SuwayomiSettingsClient client) {
     this.client = client;
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java
index ecb9a467..8b017e1e 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java
@@ -34,6 +34,11 @@ public class WebClientService {
   private WebSocketGraphQlClient webSocketGraphQlClient;
   private WebClientGraphQLClient dgsGraphQlClient;
 
+  /**
+   * Creates a new instance of the {@link WebClientService} class.
+   *
+   * @param settingsService the {@link SettingsService} used for getting the current settings.
+   */
   public WebClientService(SettingsService settingsService) {
     Settings settings = settingsService.getSettings();
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
index 2f640d97..dae8f1dc 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
@@ -23,6 +23,11 @@ public class SuwayomiTrackingClient {
   private static final Logger log = LoggerFactory.getLogger(SuwayomiTrackingClient.class);
   private final WebClientService clientService;
 
+  /**
+   * Creates a new instance of the {@link SuwayomiTrackingClient} class.
+   *
+   * @param clientService the {@link WebClientService} used for making API requests
+   */
   public SuwayomiTrackingClient(WebClientService clientService) {
     this.clientService = clientService;
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
index 789720a2..5e0b46fe 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
@@ -45,6 +45,12 @@ public class MyAnimeListAPIService {
   private final Cache<UUID, String> pkceCache;
   @Nullable private MyAnimeList mal;
 
+  /**
+   * Initializes an instance of the MyAnimeListAPIService class.
+   *
+   * @param tds        The {@link TrackingDataService} used for storing tokens.
+   * @param webClient  The {@link WebClient} used for making requests to the MAL API.
+   */
   public MyAnimeListAPIService(TrackingDataService tds, WebClient webClient) {
     this.tds = tds;
     this.webClient = webClient;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
index f847eae6..7c702a35 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
@@ -15,8 +15,15 @@
 
 @Service
 public class SuwayomiTrackingService {
+
   private final SuwayomiTrackingClient client;
 
+  /**
+   * Represents a Suwayomi Tracking Service.
+   *
+   * @param client the {@link SuwayomiTrackingClient} used for handling tracking requests to the
+   *               Suwayomi Server.
+   */
   public SuwayomiTrackingService(SuwayomiTrackingClient client) {
     this.client = client;
   }
@@ -69,12 +76,12 @@ private String getStateAuthParam(int id) {
 
     String jsonTemplate =
         """
-    {\
-    "redirectUrl":"http://localhost:8080/validate/suwayomi",\
-    "trackerId":%d,\
-    "anyOtherInfo":"%s"\
-    }\
-    """
+            {\
+            "redirectUrl":"http://localhost:8080/validate/suwayomi",\
+            "trackerId":%d,\
+            "anyOtherInfo":"%s"\
+            }\
+            """
             .strip();
 
     String template = "&state=%s";
@@ -96,6 +103,11 @@ private enum TrackerType {
 
     private final int id;
 
+    /**
+     * Instantiates a TrackerType object with the specified id.
+     *
+     * @param id the id of the Tracker on the Suwayomi Server
+     */
     TrackerType(int id) {
       this.id = id;
     }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
index ed65c8f2..51ff09da 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
@@ -51,6 +51,15 @@ public class MangaView extends StandardLayout implements BeforeEnterObserver {
   private final TrackingDataService dataService;
   private final SuwayomiTrackingService suwayomiTrackingService;
 
+  /**
+   * Creates a MangaView object.
+   *
+   * @param mangaService The {@link MangaService} for accessing the manga data from the server.
+   * @param settingsService The {@link SettingsService} for accessing and managing application settings.
+   * @param aniListAPIService The {@link AniListAPIService} for connecting to the AniList API.
+   * @param dataService The {@link TrackingDataService} for tracking manga reading data.
+   * @param suwayomiTrackingService The {@link SuwayomiTrackingService} for Suwayomi tracking.
+   */
   public MangaView(
       MangaService mangaService,
       SettingsService settingsService,
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
index a27417cd..ef2fc7c4 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
@@ -62,6 +62,13 @@ public class SearchView extends StandardLayout implements HasUrlParameter<String
   private final SearchService searchService;
   private final SettingsService settingsService;
 
+  /**
+   * Constructs a SearchView object.
+   *
+   * @param sourceService   the {@link SourceService} used for retrieving manga sources
+   * @param searchService   the {@link SearchService} used for performing search operations
+   * @param settingsService the {@link SettingsService} used for accessing search settings
+   */
   public SearchView(
       SourceService sourceService, SearchService searchService, SettingsService settingsService) {
     super("Search");
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
index ee6d8227..c630ae1a 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
@@ -16,6 +16,11 @@
 @CssImport("./css/views/imports/importCommons.css")
 public abstract class TrackingLayout extends StandardLayout {
 
+  /**
+   * Creates the base Structure for the layout.
+   *
+   * @param title the title of the view to display
+   */
   public TrackingLayout(String title) {
     super(title);
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
index 2c696701..fa07d453 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
@@ -24,6 +24,11 @@ public class AniListView extends TrackingLayout {
   private final AniListAPIService aniListAPI;
   private final MangaList list;
 
+  /**
+   * AniListView is a view for displaying AniList entries to import.
+   *
+   * @param apiService the {@link AniListAPIService} instance to use for fetching data from AniList
+   */
   public AniListView(AniListAPIService apiService) {
     super("AniList");
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
index ad1bc610..395cc6b0 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
@@ -24,6 +24,11 @@ public class MALView extends TrackingLayout {
   private static final Logger log = LoggerFactory.getLogger(MALView.class);
   private final MyAnimeListAPIService malAPI;
 
+  /**
+   * MALView is a view for displaying MyAnimeList entries to import.
+   *
+   * @param malAPI An instance of the {@link MyAnimeListAPIService} class
+   */
   public MALView(MyAnimeListAPIService malAPI) {
     super("MyAnimeList");
 

From b13ba948b57e0a73d07635c96203ff2c07a2615c Mon Sep 17 00:00:00 2001
From: Alessandro Schwaiger <aless2003@gmx.at>
Date: Thu, 4 Apr 2024 23:03:54 +0200
Subject: [PATCH 10/17] Fix JAVA-D1000

Added docs to classes for this PR
---
 .../tachideskvaadinui/api/AuthAPI.java        |   3 +
 .../component/card/MalMediaCard.java          |   3 +
 .../dialog/tracking/TrackingDialog.java       |   4 +
 .../tracking/TrackingMangaChoiceDialog.java   |   3 +
 .../tracking/provider/AniListProvider.java    |   4 +
 .../tracking/provider/SuwayomiProvider.java   |   5 +
 .../tracking/provider/TrackerProvider.java    |  15 ++-
 .../tachideskvaadinui/config/HttpConfig.java  |   3 +
 .../data/tracking/OAuthData.java              |  10 +-
 .../data/tracking/OAuthResponse.java          |   3 +
 .../data/tracking/Tracker.java                |  20 ++-
 .../data/tracking/TrackerTokens.java          |   4 +
 .../tracking/search/TrackerSearchResult.java  |   7 ++
 .../services/WebClientService.java            |   4 +
 .../suwayomi/SuwayomiSettingsClient.java      |   4 +
 .../suwayomi/SuwayomiTrackingClient.java      |   3 +
 .../services/tracker/AniListAPIService.java   | 116 +++++++++---------
 .../tracker/MyAnimeListAPIService.java        |  13 +-
 .../tracker/SuwayomiTrackingService.java      |   5 +
 .../tachideskvaadinui/view/MangaView.java     |  25 ++--
 .../tachideskvaadinui/view/SearchView.java    |   6 +-
 .../view/layout/TrackingLayout.java           |   3 +
 .../view/trackers/AniListView.java            |   3 +
 .../view/trackers/MALView.java                |   3 +
 24 files changed, 196 insertions(+), 73 deletions(-)

diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
index 2505f705..e4620688 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
@@ -24,6 +24,9 @@
 import org.springframework.web.bind.annotation.RestController;
 import org.springframework.web.servlet.view.RedirectView;
 
+/**
+ * Handles authentication and token validation for various services.
+ */
 @RestController
 @RequestMapping("validate")
 @Slf4j
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
index e11a6e86..7ed520b4 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
@@ -8,6 +8,9 @@
 
 import dev.katsute.mal4j.manga.Manga;
 
+/**
+ * Represents a {@link Card} component for displaying Manga information from MyAnimeList.
+ */
 public class MalMediaCard extends Card {
 
   /**
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
index 0191f217..81fb0058 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
@@ -38,6 +38,10 @@
 import org.vaadin.miki.superfields.dates.SuperDatePicker;
 import org.vaadin.miki.superfields.numbers.SuperIntegerField;
 
+/**
+ * TrackingDialog is a custom dialog component used for tracking manga progress with Tracking services.
+ * It also allows the user to authenticate with a tracking service.
+ */
 @CssImport("./css/components/dialog/tracking/tracking-dialog.css")
 @Slf4j
 public class TrackingDialog extends Dialog {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
index cae61831..4b293cf8 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
@@ -26,6 +26,9 @@
 import org.vaadin.miki.shared.labels.LabelPosition;
 import org.vaadin.miki.superfields.text.LabelField;
 
+/**
+ * Represents a dialog for choosing and tracking a manga.
+ */
 public class TrackingMangaChoiceDialog extends Dialog {
 
   /**
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java
index a267ee1f..35a75263 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java
@@ -12,6 +12,10 @@
 import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
 import online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService;
 
+/**
+ * The AniListProvider class is an implementation of the {@link TrackerProvider} interface.
+ * It provides methods for searching for manga on the AniList tracker and submitting manga to the tracker.
+ */
 @AllArgsConstructor
 public class AniListProvider implements TrackerProvider {
   private AniListAPIService aniListAPI;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/SuwayomiProvider.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/SuwayomiProvider.java
index 9fae3b6d..16f0b150 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/SuwayomiProvider.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/SuwayomiProvider.java
@@ -11,6 +11,11 @@
 import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
 import online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService;
 
+/**
+ * Represents a provider for the Suwayomi tracking service. This class provides methods for
+ * interacting with the Suwayomi API and handling tracking requests to Suwayomi tracking services.
+ * It implements the {@link TrackerProvider} interface.
+ */
 @AllArgsConstructor
 public class SuwayomiProvider implements TrackerProvider {
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
index 0be3d3e9..36bb4533 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
@@ -9,6 +9,11 @@
 import java.util.List;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
 
+/**
+ * Represents a provider for a tracking service. It contains methods for searching for manga on the
+ * tracker and submitting manga to the tracker. Implementations of this interface are responsible
+ * for handling the specifics of the tracker's API.
+ */
 public interface TrackerProvider {
 
   public boolean canSetPrivate();
@@ -16,15 +21,17 @@ public interface TrackerProvider {
   public List<TrackerSearchResult> search(String query);
 
   /**
-   * @param isPrivate whether the entry should be set to private
-   * @param mangaId the id of the manga according to Suwayomi
+   * @param isPrivate  whether the entry should be set to private
+   * @param mangaId    the id of the manga according to Suwayomi
    * @param externalId the id of the manga on the tracker
    * @throws IllegalArgumentException if `isPrivate` is set to true and the tracker does not support
-   *     private entries
+   *                                  private entries
    */
   public void submitToTracker(boolean isPrivate, int mangaId, int externalId);
 
-  /** Equivalent to calling `submitToTracker(false, mangaId, externalId)` */
+  /**
+   * Equivalent to calling `submitToTracker(false, mangaId, externalId)`
+   */
   public default void submitToTracker(int mangaId, int externalId) {
     submitToTracker(false, mangaId, externalId);
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
index 53b52843..3ccbb7ca 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
@@ -12,6 +12,9 @@
 import org.springframework.web.client.RestTemplate;
 import org.springframework.web.reactive.function.client.WebClient;
 
+/**
+ * Is used to configure the HTTP related beans.
+ */
 @Configuration
 public class HttpConfig {
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
index 0b401558..19764c26 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
@@ -16,6 +16,12 @@
 import javax.annotation.Nullable;
 import lombok.Getter;
 
+/**
+ * Represents a data object that contains the necessary information for OAuth authentication.
+ * <p>
+ * This class serves as the translated form of various OAuth responses from different OAuth servers
+ * and should be used to store the necessary data for authentication.
+ */
 public class OAuthData {
 
   @Getter
@@ -80,7 +86,9 @@ public OAuthData(AccessToken token) {
    *
    * @param accessToken  the access token for OAuth authentication.
    * @param tokenType    the type of token returned by the OAuth server. e.g. "Bearer".
-   * @param expires      the expiry time of the access token as a {@link String}. This can be either a number of seconds or an ISO 8601 formatted date. see {@link DateTimeFormatter#ISO_INSTANT}
+   * @param expires      the expiry time of the access token as a {@link String}. This can be either
+   *                     a number of seconds or an ISO 8601 formatted date. see
+   *                     {@link DateTimeFormatter#ISO_INSTANT}
    * @param refreshToken the refresh token for OAuth authentication. May be null.
    */
   @JsonCreator
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java
index adc1fa8a..0209db96 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java
@@ -11,6 +11,9 @@
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 
+/**
+ * Represents the response of an OAuth request from AniList.
+ */
 @Getter
 @NoArgsConstructor
 public class OAuthResponse {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
index 85e9350c..92a8c28a 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
@@ -9,12 +9,30 @@
 import lombok.Data;
 import lombok.Setter;
 
+/**
+ * Represents a tracked manga. It contains fields for a manga ID, an AniList ID, a MyAnimeList ID,
+ * and a flag indicating if the tracker is private.
+ */
 @Data
 public class Tracker {
 
-  @Setter private long mangaId;
+  /**
+   * Represents the ID of a manga on the Suwayomi Server.
+   */
+  @Setter
+  private long mangaId;
+  /**
+   * Represents the ID of a manga on AniList.
+   */
   private int aniListId;
+  /**
+   * Represents the ID of a manga on MyAnimeList.
+   */
   private int malId;
+  /**
+   * Represents whether the tracker should be treated as private. If true, the tracked manga should
+   * if possible be marked as private on external trackers.
+   */
   private boolean isPrivate;
 
   public boolean hasAniListId() {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
index 033e4641..75941f59 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
@@ -10,6 +10,10 @@
 import lombok.Getter;
 import lombok.Setter;
 
+/**
+ * This class represents the tokens used for authentication with different tracker APIs.
+ * It stores {@link OAuthData} for each API.
+ */
 @Getter
 public class TrackerTokens {
   private OAuthData aniListToken;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
index 100334fd..1cbe1beb 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
@@ -11,6 +11,13 @@
 import lombok.Getter;
 import org.jetbrains.annotations.Contract;
 
+/**
+ * Represents the search result for a manga on a tracker on the Suwayomi Server.
+ * <p>
+ * This class is used for deserializing the JSON response from the Suwayomi Server and contains
+ * useful information about the manga, as well as metadata that can be used to retrieve more
+ * information.
+ */
 @Getter
 public final class TrackerSearchResult {
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java
index 8b017e1e..565ff63d 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java
@@ -24,6 +24,10 @@
 import org.springframework.web.reactive.socket.client.StandardWebSocketClient;
 import org.springframework.web.reactive.socket.client.WebSocketClient;
 
+/**
+ * The WebClientService class is responsible for creating and managing clients used by other
+ * services to communicate with APIs.
+ */
 @Getter
 @Service
 public class WebClientService {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
index 7d1b74b0..ebe6ac22 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
@@ -10,6 +10,10 @@
 import online.hatsunemiku.tachideskvaadinui.services.WebClientService;
 import org.springframework.stereotype.Component;
 
+/**
+ * The SuwayomiSettingsClient class is responsible for making API requests to the Suwayomi Server
+ * for updating and retrieving server settings.
+ */
 @Component
 public class SuwayomiSettingsClient {
   private final WebClientService clientService;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
index dae8f1dc..b1b78424 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
@@ -17,6 +17,9 @@
 import org.slf4j.LoggerFactory;
 import org.springframework.stereotype.Component;
 
+/**
+ * The SuwayomiTrackingClient class provides methods to interact with a Suwayomi tracker through GraphQL API requests.
+ */
 @Component
 public class SuwayomiTrackingClient {
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
index d57270d8..51cf671c 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
@@ -41,6 +41,10 @@
 import org.springframework.web.reactive.function.client.WebClientResponseException;
 import reactor.core.publisher.Mono;
 
+/**
+ * Is responsible for interacting with the AniList API. This class provides methods for retrieving
+ * and updating AniList tokens, searching for manga, and managing manga lists.
+ */
 @Service
 @Slf4j
 public class AniListAPIService {
@@ -60,8 +64,9 @@ public class AniListAPIService {
    * dependencies.
    *
    * @param dataService the TrackingDataService object to be used for retrieving and updating the
-   *     AniList token and manga trackers
-   * @param mapper the ObjectMapper object to be used for serializing and deserializing JSON data.
+   *                    AniList token and manga trackers
+   * @param mapper      the ObjectMapper object to be used for serializing and deserializing JSON
+   *                    data.
    */
   public AniListAPIService(TrackingDataService dataService, ObjectMapper mapper) {
     this.dataService = dataService;
@@ -79,7 +84,7 @@ public AniListAPIService(TrackingDataService dataService, ObjectMapper mapper) {
    * Retrieves the AniList token from the settings.
    *
    * @return an Optional containing the AniList token if it is present, otherwise returns an empty
-   *     Optional
+   * Optional
    */
   private Optional<OAuthData> getAniListToken() {
     TrackerTokens trackerTokens = dataService.getTokens();
@@ -105,7 +110,7 @@ public boolean hasAniListToken() {
    *
    * @return the AniList token header as a string
    * @throws IllegalStateException if there is no AniList token available or if the token is not
-   *     valid.
+   *                               valid.
    */
   private String getAniListTokenHeader() {
     if (!hasAniListToken()) {
@@ -192,7 +197,7 @@ query Search($search: String) {
    *
    * @return The current user's ID
    * @throws RuntimeException If no AniList token is available or if there is an error retrieving
-   *     the user ID
+   *                          the user ID
    */
   private int getCurrentUserId() {
     if (!hasAniListToken()) {
@@ -339,8 +344,8 @@ public void addMangaToList(int mangaId, boolean isPrivate) {
    * @param mangaId The ID of the manga.
    * @return The AniListMangaStatistics object containing the manga statistics.
    * @throws WebClientResponseException.NotFound If the manga with the specified ID is not found.
-   * @throws RuntimeException If the response is null, or if there is an error parsing the JSON
-   *     response.
+   * @throws RuntimeException                    If the response is null, or if there is an error
+   *                                             parsing the JSON response.
    */
   public AniListMangaStatistics getMangaFromList(int mangaId) {
     String query =
@@ -686,54 +691,54 @@ public void updateMangaEndDate(int aniListId, MediaDate date) {
    * Retrieves the user's manga list.
    *
    * @return The manga list containing the user's reading, plan to read, completed, on hold, and
-   *     dropped manga
+   * dropped manga
    * @throws RuntimeException If an error occurs while retrieving the manga list
    */
   public MangaList getMangaList() {
     String query =
         """
-        query ($userId: Int) {
-          MediaListCollection(userId: $userId, type: MANGA) {
-            lists {
-              entries {
-                id
-                mediaId
-                status
-                progress
-                score
-                startedAt {
-                  year
-                  month
-                  day
-                }
-                completedAt {
-                  year
-                  month
-                  day
-                }
-                media {
-                  title {
-                    romaji
-                    english
-                    native
-                  }
-                  coverImage {
-                    large
-                    medium
+            query ($userId: Int) {
+              MediaListCollection(userId: $userId, type: MANGA) {
+                lists {
+                  entries {
+                    id
+                    mediaId
+                    status
+                    progress
+                    score
+                    startedAt {
+                      year
+                      month
+                      day
+                    }
+                    completedAt {
+                      year
+                      month
+                      day
+                    }
+                    media {
+                      title {
+                        romaji
+                        english
+                        native
+                      }
+                      coverImage {
+                        large
+                        medium
+                      }
+                    }
                   }
                 }
               }
             }
-          }
-        }
-        """;
+            """;
 
     String variables =
         """
-        {
-          "userId": %s
-        }
-        """.formatted(getCurrentUserId());
+            {
+              "userId": %s
+            }
+            """.formatted(getCurrentUserId());
 
     String response = sendAuthGraphQLRequest(query, variables);
 
@@ -754,7 +759,8 @@ public MangaList getMangaList() {
     for (int i = 0; i < listSize; i++) {
       var list = lists.getObject(i).getArray("entries");
 
-      var typeRef = new TypeReference<List<AniListMedia>>() {};
+      var typeRef = new TypeReference<List<AniListMedia>>() {
+      };
       try {
         for (int j = 0; j < list.length(); j++) {
           replaceMediaWithImageAndTitle(list, j);
@@ -789,7 +795,7 @@ public MangaList getMangaList() {
    * Replaces the "media" object in a JsonArray with "coverImage" and "title" objects.
    *
    * @param list The JsonArray containing the media object to be replaced
-   * @param j The index of the media object within the JsonArray
+   * @param j    The index of the media object within the JsonArray
    */
   private void replaceMediaWithImageAndTitle(JsonArray list, int j) {
     var media = list.getObject(j).getObject("media");
@@ -882,20 +888,20 @@ public void removeMangaFromList(int aniListId) {
     // language=graphql
     String query =
         """
-    mutation ($entryId: Int) {
-      DeleteMediaListEntry(id: $entryId) {
-        deleted
-      }
-    }
-    """;
+            mutation ($entryId: Int) {
+              DeleteMediaListEntry(id: $entryId) {
+                deleted
+              }
+            }
+            """;
 
     int entryId = getMangaListEntryId(aniListId);
 
     var variables = """
-    {
-      "entryId": %s
-    }
-    """.formatted(entryId);
+        {
+          "entryId": %s
+        }
+        """.formatted(entryId);
 
     var json = Json.parse(sendAuthGraphQLRequest(query, variables));
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
index 5e0b46fe..07793a54 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
@@ -35,6 +35,12 @@
 import org.springframework.util.MultiValueMap;
 import org.springframework.web.reactive.function.client.WebClient;
 
+/**
+ * The MyAnimeListAPIService class is responsible for interacting with the MyAnimeList API.
+ * <p>
+ * This class provides methods for authentication with MyAnimeList and retrieving manga/user
+ * information from the API.
+ */
 @Service
 public class MyAnimeListAPIService {
 
@@ -43,13 +49,14 @@ public class MyAnimeListAPIService {
   private final TrackingDataService tds;
   private final WebClient webClient;
   private final Cache<UUID, String> pkceCache;
-  @Nullable private MyAnimeList mal;
+  @Nullable
+  private MyAnimeList mal;
 
   /**
    * Initializes an instance of the MyAnimeListAPIService class.
    *
-   * @param tds        The {@link TrackingDataService} used for storing tokens.
-   * @param webClient  The {@link WebClient} used for making requests to the MAL API.
+   * @param tds       The {@link TrackingDataService} used for storing tokens.
+   * @param webClient The {@link WebClient} used for making requests to the MAL API.
    */
   public MyAnimeListAPIService(TrackingDataService tds, WebClient webClient) {
     this.tds = tds;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
index 7c702a35..468748ad 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
@@ -13,6 +13,11 @@
 import online.hatsunemiku.tachideskvaadinui.services.client.suwayomi.SuwayomiTrackingClient;
 import org.springframework.stereotype.Service;
 
+/**
+ * Represents a Service for handling tracking requests to the Suwayomi Server. This service is a
+ * wrapper around the {@link SuwayomiTrackingClient} class and provides methods to abstract the
+ * inner workings of the client. Also provides convenience methods for handling tracking requests.
+ */
 @Service
 public class SuwayomiTrackingService {
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
index 51ff09da..bf659ae1 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
@@ -41,6 +41,10 @@
 import online.hatsunemiku.tachideskvaadinui.view.layout.StandardLayout;
 import org.jetbrains.annotations.NotNull;
 
+/**
+ * MangaView is a view for displaying manga information such as chapters and cover image. It also
+ * allows the user to download chapters, add the manga to their library and more.
+ */
 @Route("manga/:id(\\d+)")
 @CssImport("./css/manga.css")
 public class MangaView extends StandardLayout implements BeforeEnterObserver {
@@ -54,10 +58,14 @@ public class MangaView extends StandardLayout implements BeforeEnterObserver {
   /**
    * Creates a MangaView object.
    *
-   * @param mangaService The {@link MangaService} for accessing the manga data from the server.
-   * @param settingsService The {@link SettingsService} for accessing and managing application settings.
-   * @param aniListAPIService The {@link AniListAPIService} for connecting to the AniList API.
-   * @param dataService The {@link TrackingDataService} for tracking manga reading data.
+   * @param mangaService            The {@link MangaService} for accessing the manga data from the
+   *                                server.
+   * @param settingsService         The {@link SettingsService} for accessing and managing
+   *                                application settings.
+   * @param aniListAPIService       The {@link AniListAPIService} for connecting to the AniList
+   *                                API.
+   * @param dataService             The {@link TrackingDataService} for tracking manga reading
+   *                                data.
    * @param suwayomiTrackingService The {@link SuwayomiTrackingService} for Suwayomi tracking.
    */
   public MangaView(
@@ -187,7 +195,7 @@ private Button getDownloadBtn(List<Chapter> chapters) {
    * Creates and retrieves the resume button for a manga, which allows the user to resume reading
    * from the last chapter they left off.
    *
-   * @param manga The manga object for which to retrieve the resume button.
+   * @param manga    The manga object for which to retrieve the resume button.
    * @param chapters The list of chapters available for the manga.
    * @return The resume button with the appropriate click listener.
    */
@@ -304,9 +312,10 @@ public static class DownloadAllChapterEvent extends ComponentEvent<MangaView> {
      * Creates a new event using the given source and indicator whether the event originated from
      * the client side or the server side.
      *
-     * @param source the source component
-     * @param fromClient <code>true</code> if the event originated from the client side, <code>false
-     *     </code> otherwise
+     * @param source     the source component
+     * @param fromClient <code>true</code> if the event originated from the client side,
+     *                   <code>false
+     *                   </code> otherwise
      */
     public DownloadAllChapterEvent(MangaView source, boolean fromClient) {
       super(source, fromClient);
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
index ef2fc7c4..758f528c 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
@@ -50,6 +50,10 @@
 import org.vaadin.miki.shared.text.TextInputMode;
 import org.vaadin.miki.superfields.text.SuperTextField;
 
+/**
+ * SearchView is a view used for searching sources for manga. It allows the user to search for manga
+ * across all sources with a language filter to narrow down the search results.
+ */
 @CssImport("./css/views/search-view.css")
 @Slf4j
 @Route("search")
@@ -252,7 +256,7 @@ public void search(String query) {
   /**
    * Adds a search result to the user interface.
    *
-   * @param source the source of the search result
+   * @param source    the source of the search result
    * @param mangaList the list of manga from the search result
    * @return true if the search result was successfully added, otherwise false
    */
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
index c630ae1a..2fa0816a 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
@@ -13,6 +13,9 @@
 import java.util.List;
 import online.hatsunemiku.tachideskvaadinui.component.card.Card;
 
+/**
+ * TrackingLayout is a layout/base for displaying tracking information to import.
+ */
 @CssImport("./css/views/imports/importCommons.css")
 public abstract class TrackingLayout extends StandardLayout {
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
index fa07d453..99ff612c 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
@@ -17,6 +17,9 @@
 import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
 import online.hatsunemiku.tachideskvaadinui.view.layout.TrackingLayout;
 
+/**
+ * AniListView is a view for displaying AniList entries to import.
+ */
 @Route("anilist")
 @CssImport("./css/views/anilist.css")
 public class AniListView extends TrackingLayout {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
index 395cc6b0..25c38416 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
@@ -18,6 +18,9 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+/**
+ * MALView is a view for displaying MyAnimeList entries to import.
+ */
 @Route("mal")
 public class MALView extends TrackingLayout {
 

From dce73a3ae17fc277192f70428686270239388bf8 Mon Sep 17 00:00:00 2001
From: "deepsource-autofix[bot]"
 <62050782+deepsource-autofix[bot]@users.noreply.github.com>
Date: Thu, 4 Apr 2024 21:06:28 +0000
Subject: [PATCH 11/17] style: format code with Google Java Format

This commit fixes the style issues introduced in 8855fe5 according to the output
from Google Java Format.

Details: https://github.com/Suwayomi/Suwayomi-VaadinUI/pull/106
---
 .../tachideskvaadinui/api/AuthAPI.java        |  7 +-
 .../component/card/MalMediaCard.java          |  4 +-
 .../dialog/tracking/TrackingDialog.java       | 14 ++--
 .../tracking/TrackingMangaChoiceDialog.java   |  4 +-
 .../tracking/provider/AniListProvider.java    |  5 +-
 .../tracking/provider/TrackerProvider.java    | 10 +--
 .../tachideskvaadinui/config/HttpConfig.java  |  4 +-
 .../data/tracking/OAuthData.java              | 19 +++--
 .../data/tracking/OAuthResponse.java          | 10 +--
 .../data/tracking/Tracker.java                | 18 ++---
 .../data/tracking/TrackerTokens.java          |  8 +-
 .../tracking/search/TrackerSearchResult.java  | 74 +++++++------------
 .../services/SuwayomiSettingsService.java     |  2 +-
 .../suwayomi/SuwayomiTrackingClient.java      |  3 +-
 .../services/tracker/AniListAPIService.java   | 25 +++----
 .../tracker/MyAnimeListAPIService.java        |  9 +--
 .../tracker/SuwayomiTrackingService.java      |  2 +-
 .../tachideskvaadinui/view/MangaView.java     | 20 ++---
 .../tachideskvaadinui/view/SearchView.java    |  6 +-
 .../view/layout/TrackingLayout.java           |  4 +-
 .../view/trackers/AniListView.java            |  4 +-
 .../view/trackers/MALView.java                |  4 +-
 22 files changed, 106 insertions(+), 150 deletions(-)

diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
index fdad6990..e0633548 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
@@ -24,9 +24,7 @@
 import org.springframework.web.bind.annotation.RestController;
 import org.springframework.web.servlet.view.RedirectView;
 
-/**
- * Handles authentication and token validation for various services.
- */
+/** Handles authentication and token validation for various services. */
 @RestController
 @RequestMapping("validate")
 @Slf4j
@@ -40,7 +38,8 @@ public class AuthAPI {
    * Creates a new instance of the {@link AuthAPI} class.
    *
    * @param dataService the {@link TrackingDataService} instance used to store the authentication.
-   * @param suwayomiTrackingService the {@link SuwayomiTrackingService} instance used to authenticate with Suwayomi.
+   * @param suwayomiTrackingService the {@link SuwayomiTrackingService} instance used to
+   *     authenticate with Suwayomi.
    * @param malAPI the {@link MyAnimeListAPIService} instance used to authenticate with MyAnimeList.
    */
   public AuthAPI(
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
index 7ed520b4..451e05cd 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/card/MalMediaCard.java
@@ -8,9 +8,7 @@
 
 import dev.katsute.mal4j.manga.Manga;
 
-/**
- * Represents a {@link Card} component for displaying Manga information from MyAnimeList.
- */
+/** Represents a {@link Card} component for displaying Manga information from MyAnimeList. */
 public class MalMediaCard extends Card {
 
   /**
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
index 81fb0058..f5bf54b5 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
@@ -39,8 +39,8 @@
 import org.vaadin.miki.superfields.numbers.SuperIntegerField;
 
 /**
- * TrackingDialog is a custom dialog component used for tracking manga progress with Tracking services.
- * It also allows the user to authenticate with a tracking service.
+ * TrackingDialog is a custom dialog component used for tracking manga progress with Tracking
+ * services. It also allows the user to authenticate with a tracking service.
  */
 @CssImport("./css/components/dialog/tracking/tracking-dialog.css")
 @Slf4j
@@ -53,10 +53,12 @@ public class TrackingDialog extends Dialog {
   /**
    * Constructs a {@link TrackingDialog} with the given parameters.
    *
-   * @param dataService             The {@link TrackingDataService} used for storing tracking data.
-   * @param manga                   the {@link Manga} to track with the dialog.
-   * @param aniListAPIService       the {@link AniListAPIService} used for making requests to the AniList API.
-   * @param suwayomiTrackingService the {@link SuwayomiTrackingService} used for making requests to the Suwayomi API.
+   * @param dataService The {@link TrackingDataService} used for storing tracking data.
+   * @param manga the {@link Manga} to track with the dialog.
+   * @param aniListAPIService the {@link AniListAPIService} used for making requests to the AniList
+   *     API.
+   * @param suwayomiTrackingService the {@link SuwayomiTrackingService} used for making requests to
+   *     the Suwayomi API.
    */
   public TrackingDialog(
       TrackingDataService dataService,
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
index 4b293cf8..a79a2749 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
@@ -26,9 +26,7 @@
 import org.vaadin.miki.shared.labels.LabelPosition;
 import org.vaadin.miki.superfields.text.LabelField;
 
-/**
- * Represents a dialog for choosing and tracking a manga.
- */
+/** Represents a dialog for choosing and tracking a manga. */
 public class TrackingMangaChoiceDialog extends Dialog {
 
   /**
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java
index 35a75263..b3076272 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/AniListProvider.java
@@ -13,8 +13,9 @@
 import online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService;
 
 /**
- * The AniListProvider class is an implementation of the {@link TrackerProvider} interface.
- * It provides methods for searching for manga on the AniList tracker and submitting manga to the tracker.
+ * The AniListProvider class is an implementation of the {@link TrackerProvider} interface. It
+ * provides methods for searching for manga on the AniList tracker and submitting manga to the
+ * tracker.
  */
 @AllArgsConstructor
 public class AniListProvider implements TrackerProvider {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
index 36bb4533..9e59d3ab 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
@@ -21,17 +21,15 @@ public interface TrackerProvider {
   public List<TrackerSearchResult> search(String query);
 
   /**
-   * @param isPrivate  whether the entry should be set to private
-   * @param mangaId    the id of the manga according to Suwayomi
+   * @param isPrivate whether the entry should be set to private
+   * @param mangaId the id of the manga according to Suwayomi
    * @param externalId the id of the manga on the tracker
    * @throws IllegalArgumentException if `isPrivate` is set to true and the tracker does not support
-   *                                  private entries
+   *     private entries
    */
   public void submitToTracker(boolean isPrivate, int mangaId, int externalId);
 
-  /**
-   * Equivalent to calling `submitToTracker(false, mangaId, externalId)`
-   */
+  /** Equivalent to calling `submitToTracker(false, mangaId, externalId)` */
   public default void submitToTracker(int mangaId, int externalId) {
     submitToTracker(false, mangaId, externalId);
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
index 3ccbb7ca..311157d9 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
@@ -12,9 +12,7 @@
 import org.springframework.web.client.RestTemplate;
 import org.springframework.web.reactive.function.client.WebClient;
 
-/**
- * Is used to configure the HTTP related beans.
- */
+/** Is used to configure the HTTP related beans. */
 @Configuration
 public class HttpConfig {
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
index 19764c26..2ba4d9a6 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
@@ -18,9 +18,9 @@
 
 /**
  * Represents a data object that contains the necessary information for OAuth authentication.
- * <p>
- * This class serves as the translated form of various OAuth responses from different OAuth servers
- * and should be used to store the necessary data for authentication.
+ *
+ * <p>This class serves as the translated form of various OAuth responses from different OAuth
+ * servers and should be used to store the necessary data for authentication.
  */
 public class OAuthData {
 
@@ -43,7 +43,7 @@ public class OAuthData {
    * Constructs an {@link OAuthData} object from an OAuthResponse.
    *
    * @param response the {@link OAuthResponse} object to deconstruct into an {@link OAuthData}
-   *                 object.
+   *     object.
    */
   OAuthData(OAuthResponse response) {
     String access_token = response.getAccessToken();
@@ -65,7 +65,7 @@ public class OAuthData {
    * Constructs an {@link OAuthData} object from an {@link AccessToken} object.
    *
    * @param token the {@link AccessToken} object used to construct the OAuthData. It contains the
-   *              necessary data, such as the access token, refresh token, and expiry information.
+   *     necessary data, such as the access token, refresh token, and expiry information.
    */
   public OAuthData(AccessToken token) {
     String access_token = token.getToken();
@@ -84,11 +84,10 @@ public OAuthData(AccessToken token) {
   /**
    * Constructs an {@link OAuthData} object. Only used for deserialization purposes.
    *
-   * @param accessToken  the access token for OAuth authentication.
-   * @param tokenType    the type of token returned by the OAuth server. e.g. "Bearer".
-   * @param expires      the expiry time of the access token as a {@link String}. This can be either
-   *                     a number of seconds or an ISO 8601 formatted date. see
-   *                     {@link DateTimeFormatter#ISO_INSTANT}
+   * @param accessToken the access token for OAuth authentication.
+   * @param tokenType the type of token returned by the OAuth server. e.g. "Bearer".
+   * @param expires the expiry time of the access token as a {@link String}. This can be either a
+   *     number of seconds or an ISO 8601 formatted date. see {@link DateTimeFormatter#ISO_INSTANT}
    * @param refreshToken the refresh token for OAuth authentication. May be null.
    */
   @JsonCreator
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java
index 0209db96..7741cd90 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthResponse.java
@@ -11,9 +11,7 @@
 import lombok.Getter;
 import lombok.NoArgsConstructor;
 
-/**
- * Represents the response of an OAuth request from AniList.
- */
+/** Represents the response of an OAuth request from AniList. */
 @Getter
 @NoArgsConstructor
 public class OAuthResponse {
@@ -34,9 +32,9 @@ public class OAuthResponse {
    * Creates a new instance of the {@link OAuthResponse} class.
    *
    * @param accessToken the access token returned by the OAuth server.
-   * @param expiresIn   the {@link Instant} instance that represents the point in time at which the
-   *                    access token expires.
-   * @param tokenType   the type of token returned by the OAuth Server. e.g. "Bearer".
+   * @param expiresIn the {@link Instant} instance that represents the point in time at which the
+   *     access token expires.
+   * @param tokenType the type of token returned by the OAuth Server. e.g. "Bearer".
    */
   @SuppressWarnings("unused") // Used by Spring when deserializing a request in AuthAPI
   public OAuthResponse(String accessToken, Instant expiresIn, String tokenType) {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
index 92a8c28a..7d4f1b25 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
@@ -16,19 +16,15 @@
 @Data
 public class Tracker {
 
-  /**
-   * Represents the ID of a manga on the Suwayomi Server.
-   */
-  @Setter
-  private long mangaId;
-  /**
-   * Represents the ID of a manga on AniList.
-   */
+  /** Represents the ID of a manga on the Suwayomi Server. */
+  @Setter private long mangaId;
+
+  /** Represents the ID of a manga on AniList. */
   private int aniListId;
-  /**
-   * Represents the ID of a manga on MyAnimeList.
-   */
+
+  /** Represents the ID of a manga on MyAnimeList. */
   private int malId;
+
   /**
    * Represents whether the tracker should be treated as private. If true, the tracked manga should
    * if possible be marked as private on external trackers.
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
index 75941f59..2be0a07e 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
@@ -11,17 +11,15 @@
 import lombok.Setter;
 
 /**
- * This class represents the tokens used for authentication with different tracker APIs.
- * It stores {@link OAuthData} for each API.
+ * This class represents the tokens used for authentication with different tracker APIs. It stores
+ * {@link OAuthData} for each API.
  */
 @Getter
 public class TrackerTokens {
   private OAuthData aniListToken;
   @Setter private OAuthData malToken;
 
-  /**
-   * Creates a new instance of the {@link TrackerTokens} class.
-   */
+  /** Creates a new instance of the {@link TrackerTokens} class. */
   public TrackerTokens() {
     aniListToken = null;
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
index 1cbe1beb..79a6f231 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
@@ -13,65 +13,47 @@
 
 /**
  * Represents the search result for a manga on a tracker on the Suwayomi Server.
- * <p>
- * This class is used for deserializing the JSON response from the Suwayomi Server and contains
+ *
+ * <p>This class is used for deserializing the JSON response from the Suwayomi Server and contains
  * useful information about the manga, as well as metadata that can be used to retrieve more
  * information.
  */
 @Getter
 public final class TrackerSearchResult {
 
-  /**
-   * The url of the cover image for the manga.
-   */
+  /** The url of the cover image for the manga. */
   @JsonProperty("coverUrl")
   private final String coverUrl;
 
-  /**
-   * The id of the manga on Suwayomi.
-   */
+  /** The id of the manga on Suwayomi. */
   @JsonProperty("id")
   private final int id;
 
-  /**
-   * The id of the manga on the tracker site.
-   */
+  /** The id of the manga on the tracker site. */
   @JsonProperty("remoteId")
   private final int remoteId;
 
-  /**
-   * The publishing status of the manga.
-   */
+  /** The publishing status of the manga. */
   @JsonProperty("publishingStatus")
   private final String status;
 
-  /**
-   * The type of media - e.g. manga, light novel, web novel, etc.
-   */
+  /** The type of media - e.g. manga, light novel, web novel, etc. */
   @JsonProperty("publishingType")
   private final String type;
 
-  /**
-   * The date on which the manga started publishing.
-   */
+  /** The date on which the manga started publishing. */
   @JsonProperty("startDate")
   private final String startDate;
 
-  /**
-   * A summary of the manga.
-   */
+  /** A summary of the manga. */
   @JsonProperty("summary")
   private final String summary;
 
-  /**
-   * The title of the manga.
-   */
+  /** The title of the manga. */
   @JsonProperty("title")
   private final String title;
 
-  /**
-   * The total number of chapters in the manga.
-   */
+  /** The total number of chapters in the manga. */
   @JsonProperty("totalChapters")
   private final int totalChapters;
 
@@ -86,16 +68,16 @@ public final class TrackerSearchResult {
    * Constructs a new instance of the {@link TrackerSearchResult} class. This is used for
    * deserializing the JSON response from the Suwayomi Server.
    *
-   * @param coverUrl      The url of the cover image for the manga.
-   * @param id            The id of the manga on Suwayomi.
-   * @param remoteId      The id of the manga on the tracker site. e.g. AniList, MAL, etc.
-   * @param status        The publishing status of the manga. e.g. Finished, Publishing, etc.
-   * @param type          The type of media - e.g. manga, light novel, web novel, etc.
-   * @param startDate     The date on which the manga started publishing.
-   * @param summary       A summary/description of the manga.
-   * @param title         The title of the manga.
+   * @param coverUrl The url of the cover image for the manga.
+   * @param id The id of the manga on Suwayomi.
+   * @param remoteId The id of the manga on the tracker site. e.g. AniList, MAL, etc.
+   * @param status The publishing status of the manga. e.g. Finished, Publishing, etc.
+   * @param type The type of media - e.g. manga, light novel, web novel, etc.
+   * @param startDate The date on which the manga started publishing.
+   * @param summary A summary/description of the manga.
+   * @param title The title of the manga.
    * @param totalChapters The total number of chapters in the manga.
-   * @param trackingUrl   The url of the manga on the tracker site.
+   * @param trackingUrl The url of the manga on the tracker site.
    */
   @Contract(pure = true)
   public TrackerSearchResult(
@@ -131,14 +113,14 @@ public boolean equals(Object obj) {
     }
     var that = (TrackerSearchResult) obj;
     return Objects.equals(this.coverUrl, that.coverUrl)
-           && this.id == that.id
-           && Objects.equals(this.status, that.status)
-           && Objects.equals(this.type, that.type)
-           && Objects.equals(this.startDate, that.startDate)
-           && Objects.equals(this.summary, that.summary)
-           && Objects.equals(this.title, that.title)
-           && this.totalChapters == that.totalChapters
-           && Objects.equals(this.trackingUrl, that.trackingUrl);
+        && this.id == that.id
+        && Objects.equals(this.status, that.status)
+        && Objects.equals(this.type, that.type)
+        && Objects.equals(this.startDate, that.startDate)
+        && Objects.equals(this.summary, that.summary)
+        && Objects.equals(this.title, that.title)
+        && this.totalChapters == that.totalChapters
+        && Objects.equals(this.trackingUrl, that.trackingUrl);
   }
 
   @Override
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
index dd6a8806..2428e61a 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
@@ -21,7 +21,7 @@ public class SuwayomiSettingsService {
    * Creates a new instance of the {@link SuwayomiSettingsService} class.
    *
    * @param client the {@link SuwayomiSettingsClient} used for making API requests to the Suwayomi
-   *               Server.
+   *     Server.
    */
   public SuwayomiSettingsService(SuwayomiSettingsClient client) {
     this.client = client;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
index b1b78424..d7fda560 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
@@ -18,7 +18,8 @@
 import org.springframework.stereotype.Component;
 
 /**
- * The SuwayomiTrackingClient class provides methods to interact with a Suwayomi tracker through GraphQL API requests.
+ * The SuwayomiTrackingClient class provides methods to interact with a Suwayomi tracker through
+ * GraphQL API requests.
  */
 @Component
 public class SuwayomiTrackingClient {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
index 51cf671c..554e8d5a 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
@@ -64,9 +64,8 @@ public class AniListAPIService {
    * dependencies.
    *
    * @param dataService the TrackingDataService object to be used for retrieving and updating the
-   *                    AniList token and manga trackers
-   * @param mapper      the ObjectMapper object to be used for serializing and deserializing JSON
-   *                    data.
+   *     AniList token and manga trackers
+   * @param mapper the ObjectMapper object to be used for serializing and deserializing JSON data.
    */
   public AniListAPIService(TrackingDataService dataService, ObjectMapper mapper) {
     this.dataService = dataService;
@@ -84,7 +83,7 @@ public AniListAPIService(TrackingDataService dataService, ObjectMapper mapper) {
    * Retrieves the AniList token from the settings.
    *
    * @return an Optional containing the AniList token if it is present, otherwise returns an empty
-   * Optional
+   *     Optional
    */
   private Optional<OAuthData> getAniListToken() {
     TrackerTokens trackerTokens = dataService.getTokens();
@@ -110,7 +109,7 @@ public boolean hasAniListToken() {
    *
    * @return the AniList token header as a string
    * @throws IllegalStateException if there is no AniList token available or if the token is not
-   *                               valid.
+   *     valid.
    */
   private String getAniListTokenHeader() {
     if (!hasAniListToken()) {
@@ -197,7 +196,7 @@ query Search($search: String) {
    *
    * @return The current user's ID
    * @throws RuntimeException If no AniList token is available or if there is an error retrieving
-   *                          the user ID
+   *     the user ID
    */
   private int getCurrentUserId() {
     if (!hasAniListToken()) {
@@ -344,8 +343,8 @@ public void addMangaToList(int mangaId, boolean isPrivate) {
    * @param mangaId The ID of the manga.
    * @return The AniListMangaStatistics object containing the manga statistics.
    * @throws WebClientResponseException.NotFound If the manga with the specified ID is not found.
-   * @throws RuntimeException                    If the response is null, or if there is an error
-   *                                             parsing the JSON response.
+   * @throws RuntimeException If the response is null, or if there is an error parsing the JSON
+   *     response.
    */
   public AniListMangaStatistics getMangaFromList(int mangaId) {
     String query =
@@ -691,7 +690,7 @@ public void updateMangaEndDate(int aniListId, MediaDate date) {
    * Retrieves the user's manga list.
    *
    * @return The manga list containing the user's reading, plan to read, completed, on hold, and
-   * dropped manga
+   *     dropped manga
    * @throws RuntimeException If an error occurs while retrieving the manga list
    */
   public MangaList getMangaList() {
@@ -738,7 +737,8 @@ public MangaList getMangaList() {
             {
               "userId": %s
             }
-            """.formatted(getCurrentUserId());
+            """
+            .formatted(getCurrentUserId());
 
     String response = sendAuthGraphQLRequest(query, variables);
 
@@ -759,8 +759,7 @@ public MangaList getMangaList() {
     for (int i = 0; i < listSize; i++) {
       var list = lists.getObject(i).getArray("entries");
 
-      var typeRef = new TypeReference<List<AniListMedia>>() {
-      };
+      var typeRef = new TypeReference<List<AniListMedia>>() {};
       try {
         for (int j = 0; j < list.length(); j++) {
           replaceMediaWithImageAndTitle(list, j);
@@ -795,7 +794,7 @@ public MangaList getMangaList() {
    * Replaces the "media" object in a JsonArray with "coverImage" and "title" objects.
    *
    * @param list The JsonArray containing the media object to be replaced
-   * @param j    The index of the media object within the JsonArray
+   * @param j The index of the media object within the JsonArray
    */
   private void replaceMediaWithImageAndTitle(JsonArray list, int j) {
     var media = list.getObject(j).getObject("media");
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
index 07793a54..8ca97021 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
@@ -37,8 +37,8 @@
 
 /**
  * The MyAnimeListAPIService class is responsible for interacting with the MyAnimeList API.
- * <p>
- * This class provides methods for authentication with MyAnimeList and retrieving manga/user
+ *
+ * <p>This class provides methods for authentication with MyAnimeList and retrieving manga/user
  * information from the API.
  */
 @Service
@@ -49,13 +49,12 @@ public class MyAnimeListAPIService {
   private final TrackingDataService tds;
   private final WebClient webClient;
   private final Cache<UUID, String> pkceCache;
-  @Nullable
-  private MyAnimeList mal;
+  @Nullable private MyAnimeList mal;
 
   /**
    * Initializes an instance of the MyAnimeListAPIService class.
    *
-   * @param tds       The {@link TrackingDataService} used for storing tokens.
+   * @param tds The {@link TrackingDataService} used for storing tokens.
    * @param webClient The {@link WebClient} used for making requests to the MAL API.
    */
   public MyAnimeListAPIService(TrackingDataService tds, WebClient webClient) {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
index 20ee5ddd..f3d1838e 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
@@ -27,7 +27,7 @@ public class SuwayomiTrackingService {
    * Represents a Suwayomi Tracking Service.
    *
    * @param client the {@link SuwayomiTrackingClient} used for handling tracking requests to the
-   *               Suwayomi Server.
+   *     Suwayomi Server.
    */
   public SuwayomiTrackingService(SuwayomiTrackingClient client) {
     this.client = client;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
index bf659ae1..e5f326e4 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
@@ -58,14 +58,11 @@ public class MangaView extends StandardLayout implements BeforeEnterObserver {
   /**
    * Creates a MangaView object.
    *
-   * @param mangaService            The {@link MangaService} for accessing the manga data from the
-   *                                server.
-   * @param settingsService         The {@link SettingsService} for accessing and managing
-   *                                application settings.
-   * @param aniListAPIService       The {@link AniListAPIService} for connecting to the AniList
-   *                                API.
-   * @param dataService             The {@link TrackingDataService} for tracking manga reading
-   *                                data.
+   * @param mangaService The {@link MangaService} for accessing the manga data from the server.
+   * @param settingsService The {@link SettingsService} for accessing and managing application
+   *     settings.
+   * @param aniListAPIService The {@link AniListAPIService} for connecting to the AniList API.
+   * @param dataService The {@link TrackingDataService} for tracking manga reading data.
    * @param suwayomiTrackingService The {@link SuwayomiTrackingService} for Suwayomi tracking.
    */
   public MangaView(
@@ -195,7 +192,7 @@ private Button getDownloadBtn(List<Chapter> chapters) {
    * Creates and retrieves the resume button for a manga, which allows the user to resume reading
    * from the last chapter they left off.
    *
-   * @param manga    The manga object for which to retrieve the resume button.
+   * @param manga The manga object for which to retrieve the resume button.
    * @param chapters The list of chapters available for the manga.
    * @return The resume button with the appropriate click listener.
    */
@@ -312,9 +309,8 @@ public static class DownloadAllChapterEvent extends ComponentEvent<MangaView> {
      * Creates a new event using the given source and indicator whether the event originated from
      * the client side or the server side.
      *
-     * @param source     the source component
-     * @param fromClient <code>true</code> if the event originated from the client side,
-     *                   <code>false
+     * @param source the source component
+     * @param fromClient <code>true</code> if the event originated from the client side, <code>false
      *                   </code> otherwise
      */
     public DownloadAllChapterEvent(MangaView source, boolean fromClient) {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
index 758f528c..4a338950 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
@@ -69,8 +69,8 @@ public class SearchView extends StandardLayout implements HasUrlParameter<String
   /**
    * Constructs a SearchView object.
    *
-   * @param sourceService   the {@link SourceService} used for retrieving manga sources
-   * @param searchService   the {@link SearchService} used for performing search operations
+   * @param sourceService the {@link SourceService} used for retrieving manga sources
+   * @param searchService the {@link SearchService} used for performing search operations
    * @param settingsService the {@link SettingsService} used for accessing search settings
    */
   public SearchView(
@@ -256,7 +256,7 @@ public void search(String query) {
   /**
    * Adds a search result to the user interface.
    *
-   * @param source    the source of the search result
+   * @param source the source of the search result
    * @param mangaList the list of manga from the search result
    * @return true if the search result was successfully added, otherwise false
    */
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
index 3ee32fcd..65b3b036 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
@@ -13,9 +13,7 @@
 import java.util.List;
 import online.hatsunemiku.tachideskvaadinui.component.card.Card;
 
-/**
- * TrackingLayout is a layout/base for displaying tracking information to import.
- */
+/** TrackingLayout is a layout/base for displaying tracking information to import. */
 @CssImport("./css/views/imports/importCommons.css")
 public abstract class TrackingLayout extends StandardLayout {
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
index 99ff612c..922ee819 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
@@ -17,9 +17,7 @@
 import online.hatsunemiku.tachideskvaadinui.services.tracker.AniListAPIService;
 import online.hatsunemiku.tachideskvaadinui.view.layout.TrackingLayout;
 
-/**
- * AniListView is a view for displaying AniList entries to import.
- */
+/** AniListView is a view for displaying AniList entries to import. */
 @Route("anilist")
 @CssImport("./css/views/anilist.css")
 public class AniListView extends TrackingLayout {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
index 25c38416..a1abf85b 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
@@ -18,9 +18,7 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
-/**
- * MALView is a view for displaying MyAnimeList entries to import.
- */
+/** MALView is a view for displaying MyAnimeList entries to import. */
 @Route("mal")
 public class MALView extends TrackingLayout {
 

From b2694cd003de577546b6f0a8f656d2ad0e1f17d7 Mon Sep 17 00:00:00 2001
From: Alessandro Schwaiger <aless2003@gmx.at>
Date: Thu, 4 Apr 2024 23:11:08 +0200
Subject: [PATCH 12/17] Add docs to SuwayomiSettingsClient and
 SuwayomiSettingsService missed in a previous commit

---
 .../services/SuwayomiSettingsService.java                  | 7 ++++++-
 .../services/client/suwayomi/SuwayomiSettingsClient.java   | 7 +++++++
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
index 2428e61a..58f07f7b 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
@@ -12,6 +12,11 @@
 import online.hatsunemiku.tachideskvaadinui.services.client.suwayomi.SuwayomiSettingsClient;
 import org.springframework.stereotype.Service;
 
+/**
+ * Responsible for managing Suwayomi server settings. This class is an abstraction over the
+ * {@link SuwayomiSettingsClient} class and provides methods for updating and retrieving Suwayomi
+ * server settings.
+ */
 @Service
 public class SuwayomiSettingsService {
 
@@ -21,7 +26,7 @@ public class SuwayomiSettingsService {
    * Creates a new instance of the {@link SuwayomiSettingsService} class.
    *
    * @param client the {@link SuwayomiSettingsClient} used for making API requests to the Suwayomi
-   *     Server.
+   *               Server.
    */
   public SuwayomiSettingsService(SuwayomiSettingsClient client) {
     this.client = client;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
index ebe6ac22..b9052b92 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
@@ -16,8 +16,15 @@
  */
 @Component
 public class SuwayomiSettingsClient {
+
   private final WebClientService clientService;
 
+  /**
+   * Creates a new instance of the {@link SuwayomiSettingsClient} class.
+   *
+   * @param clientService the {@link WebClientService} used for making API requests to the Suwayomi
+   *                      Server.
+   */
   public SuwayomiSettingsClient(WebClientService clientService) {
     this.clientService = clientService;
   }

From e51bdf0b462bd0851359302a051e69459c1b8647 Mon Sep 17 00:00:00 2001
From: "deepsource-autofix[bot]"
 <62050782+deepsource-autofix[bot]@users.noreply.github.com>
Date: Thu, 4 Apr 2024 21:11:36 +0000
Subject: [PATCH 13/17] style: format code with Google Java Format

This commit fixes the style issues introduced in b2694cd according to the output
from Google Java Format.

Details: https://github.com/Suwayomi/Suwayomi-VaadinUI/pull/106
---
 .../services/SuwayomiSettingsService.java                 | 8 ++++----
 .../services/client/suwayomi/SuwayomiSettingsClient.java  | 2 +-
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
index 58f07f7b..409e0c22 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/SuwayomiSettingsService.java
@@ -13,9 +13,9 @@
 import org.springframework.stereotype.Service;
 
 /**
- * Responsible for managing Suwayomi server settings. This class is an abstraction over the
- * {@link SuwayomiSettingsClient} class and provides methods for updating and retrieving Suwayomi
- * server settings.
+ * Responsible for managing Suwayomi server settings. This class is an abstraction over the {@link
+ * SuwayomiSettingsClient} class and provides methods for updating and retrieving Suwayomi server
+ * settings.
  */
 @Service
 public class SuwayomiSettingsService {
@@ -26,7 +26,7 @@ public class SuwayomiSettingsService {
    * Creates a new instance of the {@link SuwayomiSettingsService} class.
    *
    * @param client the {@link SuwayomiSettingsClient} used for making API requests to the Suwayomi
-   *               Server.
+   *     Server.
    */
   public SuwayomiSettingsService(SuwayomiSettingsClient client) {
     this.client = client;
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
index b9052b92..7d3405ff 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
@@ -23,7 +23,7 @@ public class SuwayomiSettingsClient {
    * Creates a new instance of the {@link SuwayomiSettingsClient} class.
    *
    * @param clientService the {@link WebClientService} used for making API requests to the Suwayomi
-   *                      Server.
+   *     Server.
    */
   public SuwayomiSettingsClient(WebClientService clientService) {
     this.clientService = clientService;

From c3a185c1231e196247e23856f4e8457ac78601b1 Mon Sep 17 00:00:00 2001
From: Alessandro Schwaiger <aless2003@gmx.at>
Date: Sat, 6 Apr 2024 23:19:32 +0200
Subject: [PATCH 14/17] Fix JAVA-D1001

Adds Documentation to methods that were introduced in a previous commit
---
 .../tachideskvaadinui/api/AuthAPI.java        |  97 ++++++++++-------
 .../dialog/tracking/TrackingDialog.java       |  29 +++--
 .../tracking/TrackingMangaChoiceDialog.java   |  23 +++-
 .../tracking/provider/TrackerProvider.java    |  30 ++++--
 .../tachideskvaadinui/config/HttpConfig.java  |   9 ++
 .../data/tracking/OAuthData.java              |   4 +
 .../data/tracking/Tracker.java                |   4 +
 .../data/tracking/TrackerTokens.java          |  12 +++
 .../tracking/search/TrackerSearchResult.java  |   8 ++
 .../services/WebClientService.java            |  11 ++
 .../suwayomi/SuwayomiSettingsClient.java      |   9 ++
 .../suwayomi/SuwayomiTrackingClient.java      | 102 ++++++++++++------
 .../services/tracker/AniListAPIService.java   |  89 +++++++++++++--
 .../tracker/MyAnimeListAPIService.java        |  43 +++++++-
 .../tracker/SuwayomiTrackingService.java      |  80 +++++++++++++-
 .../tachideskvaadinui/view/MangaView.java     |   7 ++
 .../tachideskvaadinui/view/SearchView.java    |  18 +++-
 .../view/layout/TrackingLayout.java           |  60 ++++++++++-
 .../view/trackers/AniListView.java            |   6 ++
 .../view/trackers/MALView.java                |   6 ++
 20 files changed, 537 insertions(+), 110 deletions(-)

diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
index e0633548..6f223764 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
@@ -24,7 +24,9 @@
 import org.springframework.web.bind.annotation.RestController;
 import org.springframework.web.servlet.view.RedirectView;
 
-/** Handles authentication and token validation for various services. */
+/**
+ * Handles authentication and token validation for various services.
+ */
 @RestController
 @RequestMapping("validate")
 @Slf4j
@@ -37,10 +39,12 @@ public class AuthAPI {
   /**
    * Creates a new instance of the {@link AuthAPI} class.
    *
-   * @param dataService the {@link TrackingDataService} instance used to store the authentication.
+   * @param dataService             the {@link TrackingDataService} instance used to store the
+   *                                authentication.
    * @param suwayomiTrackingService the {@link SuwayomiTrackingService} instance used to
-   *     authenticate with Suwayomi.
-   * @param malAPI the {@link MyAnimeListAPIService} instance used to authenticate with MyAnimeList.
+   *                                authenticate with Suwayomi.
+   * @param malAPI                  the {@link MyAnimeListAPIService} instance used to authenticate
+   *                                with MyAnimeList.
    */
   public AuthAPI(
       TrackingDataService dataService,
@@ -57,65 +61,74 @@ public AuthAPI(
    * URL.
    *
    * @return the HTML content with the JavaScript code to execute the data extraction and redirect
-   *     to the response URL
+   * to the response URL
    */
   @GetMapping(value = "anilist", produces = MediaType.TEXT_HTML_VALUE)
   public String validateAniListToken() {
     @Language("JavaScript")
     String jsToExecute =
         """
-        var hash = window.location.hash.substring(1);
+            var hash = window.location.hash.substring(1);
 
-        // Split the hash by & to get an array of key-value pairs
-        var pairs = hash.split("&");
+            // Split the hash by & to get an array of key-value pairs
+            var pairs = hash.split("&");
 
-        // Create an empty object to store the fragments
-        var fragments = {};
+            // Create an empty object to store the fragments
+            var fragments = {};
 
-        // Loop through the pairs and assign them to the object
-        for (var i = 0; i < pairs.length; i++) {
-          // Split each pair by = to get the key and value
-          var pair = pairs[i].split("=");
-          // Decode the key and value and assign them to the object
-          fragments[decodeURIComponent(pair[0])] = decodeURIComponent(pair[1]);
-        }
+            // Loop through the pairs and assign them to the object
+            for (var i = 0; i < pairs.length; i++) {
+              // Split each pair by = to get the key and value
+              var pair = pairs[i].split("=");
+              // Decode the key and value and assign them to the object
+              fragments[decodeURIComponent(pair[0])] = decodeURIComponent(pair[1]);
+            }
 
-        console.log(fragments);
+            console.log(fragments);
 
-        var body = JSON.stringify(fragments);
+            var body = JSON.stringify(fragments);
 
-        console.log(body);
+            console.log(body);
 
-        fetch('/validate/anilist', {
-          method: 'POST',
-          headers: {
-            'Content-Type': 'application/json'
-          },
-          body: body
-        }).then(response => {
-          console.log(response);
-          window.location.href = response.url;
-        })
-        .catch((error) => {
-          console.error('Error:', error);
-        });
+            fetch('/validate/anilist', {
+              method: 'POST',
+              headers: {
+                'Content-Type': 'application/json'
+              },
+              body: body
+            }).then(response => {
+              console.log(response);
+              window.location.href = response.url;
+            })
+            .catch((error) => {
+              console.error('Error:', error);
+            });
 
-        """;
+            """;
 
     @Language("HTML")
     String html =
         """
-        <script>
-          document.addEventListener("DOMContentLoaded", function() {
-            %s
-          });
-        </script>
-        """
+            <script>
+              document.addEventListener("DOMContentLoaded", function() {
+                %s
+              });
+            </script>
+            """
             .formatted(jsToExecute);
 
     return html;
   }
 
+  /**
+   * Parses the request information required to authenticate the Suwayomi Server with tracking
+   * services.
+   *
+   * @param request the {@link HttpServletRequest} used to retrieve the requested URL
+   * @param json    the JSON string containing the state information
+   * @return the {@link RedirectView} object to redirect the user to the appropriate page after
+   * authentication is done
+   */
   @GetMapping("suwayomi")
   public RedirectView authenticateSuwayomi(
       HttpServletRequest request, @RequestParam("state") String json) {
@@ -174,5 +187,7 @@ public RedirectView validateMALToken(
    * Represents the state parameter of a MAL token response. Contains the PKCE (Proof Key for Code
    * Exchange) ID to be used in the token exchange.
    */
-  public record MALTokenState(String pkceId) {}
+  public record MALTokenState(String pkceId) {
+
+  }
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
index f5bf54b5..a4b717bc 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
@@ -53,12 +53,12 @@ public class TrackingDialog extends Dialog {
   /**
    * Constructs a {@link TrackingDialog} with the given parameters.
    *
-   * @param dataService The {@link TrackingDataService} used for storing tracking data.
-   * @param manga the {@link Manga} to track with the dialog.
-   * @param aniListAPIService the {@link AniListAPIService} used for making requests to the AniList
-   *     API.
+   * @param dataService             The {@link TrackingDataService} used for storing tracking data.
+   * @param manga                   the {@link Manga} to track with the dialog.
+   * @param aniListAPIService       the {@link AniListAPIService} used for making requests to the
+   *                                AniList API.
    * @param suwayomiTrackingService the {@link SuwayomiTrackingService} used for making requests to
-   *     the Suwayomi API.
+   *                                the Suwayomi API.
    */
   public TrackingDialog(
       TrackingDataService dataService,
@@ -92,6 +92,14 @@ public TrackingDialog(
     }
   }
 
+  /**
+   * Adds the tracking buttons to the dialog.
+   *
+   * @param manga             the {@link Manga} to track
+   * @param aniListAPIService the {@link AniListAPIService} to communicate with AniList with
+   * @param tracker           the {@link Tracker} instance to update the button states via
+   *                          {@link #updateButtons(Button, Button, Tracker)}
+   */
   private void addTrackingButtons(
       Manga manga, AniListAPIService aniListAPIService, Tracker tracker) {
     VerticalLayout buttons = new VerticalLayout();
@@ -126,7 +134,7 @@ private void addTrackingButtons(
           try {
             displaySearch(manga.getTitle(), manga.getId(), provider);
           } catch (WebClientResponseException.InternalServerError
-              | WebClientRequestException error) {
+                   | WebClientRequestException error) {
             log.error("Invalid response from AniList", error);
             Notification notification = new Notification();
             notification.addThemeVariants(NotificationVariant.LUMO_ERROR);
@@ -149,7 +157,7 @@ private void addTrackingButtons(
           try {
             displaySearch(manga.getTitle(), manga.getId(), provider);
           } catch (WebClientResponseException.InternalServerError
-              | WebClientRequestException error) {
+                   | WebClientRequestException error) {
             log.error("Invalid response from MyAnimeList", error);
             Notification notification = new Notification();
             notification.addThemeVariants(NotificationVariant.LUMO_ERROR);
@@ -452,6 +460,13 @@ private void displaySearch(String mangaName, long mangaId, TrackerProvider track
         });
   }
 
+  /**
+   * Updates the tracking buttons with the current tracking status.
+   *
+   * @param aniListBtn the AniList tracking button
+   * @param malBtn     the MyAnimeList tracking button
+   * @param tracker    the tracker to check the status of
+   */
   private void updateButtons(Button aniListBtn, Button malBtn, Tracker tracker) {
     if (tracker.hasAniListId()) {
       aniListBtn.setIcon(LumoIcon.CHECKMARK.create());
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
index a79a2749..d2cdfcac 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
@@ -26,16 +26,18 @@
 import org.vaadin.miki.shared.labels.LabelPosition;
 import org.vaadin.miki.superfields.text.LabelField;
 
-/** Represents a dialog for choosing and tracking a manga. */
+/**
+ * Represents a dialog for choosing and tracking a manga.
+ */
 public class TrackingMangaChoiceDialog extends Dialog {
 
   /**
    * Constructs a {@link TrackingMangaChoiceDialog}.
    *
-   * @param mangaName the name of the manga to search
-   * @param mangaId the ID of the manga on Suwayomi
+   * @param mangaName       the name of the manga to search
+   * @param mangaId         the ID of the manga on Suwayomi
    * @param trackerProvider the {@link TrackerProvider} to use for tracking activities.
-   * @param dataService the {@link TrackingDataService} to use for saving tracking data.
+   * @param dataService     the {@link TrackingDataService} to use for saving tracking data.
    */
   public TrackingMangaChoiceDialog(
       String mangaName,
@@ -137,6 +139,14 @@ public TrackingMangaChoiceDialog(
     footer.add(privateCheckbox, buttons);
   }
 
+  /**
+   * Changes the visibility of the search results and the no results text based on whether the
+   * search results are empty or not.
+   *
+   * @param mangaList     the list of {@link TrackerSearchResult search results}
+   * @param searchResults the {@link ListBox} containing the search results
+   * @param noResults     the {@link Div} containing the no results text
+   */
   private static void changeSearchResultsVisibility(
       List<TrackerSearchResult> mangaList,
       ListBox<TrackerSearchResult> searchResults,
@@ -150,6 +160,11 @@ private static void changeSearchResultsVisibility(
     }
   }
 
+  /**
+   * Creates a {@link ComponentRenderer} used to render {@link TrackerSearchResult} on the UI.
+   *
+   * @return a {@link ComponentRenderer} used to render {@link TrackerSearchResult} on the UI.
+   */
   @NotNull
   private static ComponentRenderer<Component, TrackerSearchResult> getRenderer() {
     return new ComponentRenderer<>(
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
index 9e59d3ab..cbb5ac65 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
@@ -16,21 +16,35 @@
  */
 public interface TrackerProvider {
 
-  public boolean canSetPrivate();
+  /**
+   * Checks if the tracker supports setting entries to private.
+   *
+   * @return {@code true} if the tracker supports setting entries to private, {@code false}
+   * otherwise
+   */
+  boolean canSetPrivate();
 
-  public List<TrackerSearchResult> search(String query);
+  /**
+   * Searches for manga on the tracker.
+   *
+   * @param query the search query to use when searching for manga
+   * @return a list of {@link TrackerSearchResult} objects representing the search results
+   */
+  List<TrackerSearchResult> search(String query);
 
   /**
-   * @param isPrivate whether the entry should be set to private
-   * @param mangaId the id of the manga according to Suwayomi
+   * @param isPrivate  whether the entry should be set to private
+   * @param mangaId    the id of the manga according to Suwayomi
    * @param externalId the id of the manga on the tracker
    * @throws IllegalArgumentException if `isPrivate` is set to true and the tracker does not support
-   *     private entries
+   *                                  private entries
    */
-  public void submitToTracker(boolean isPrivate, int mangaId, int externalId);
+  void submitToTracker(boolean isPrivate, int mangaId, int externalId);
 
-  /** Equivalent to calling `submitToTracker(false, mangaId, externalId)` */
-  public default void submitToTracker(int mangaId, int externalId) {
+  /**
+   * Equivalent to calling `submitToTracker(false, mangaId, externalId)`
+   */
+  default void submitToTracker(int mangaId, int externalId) {
     submitToTracker(false, mangaId, externalId);
   }
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
index 311157d9..d9a4948f 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
@@ -16,11 +16,20 @@
 @Configuration
 public class HttpConfig {
 
+  /**
+   * Creates a new and configured instance of the {@link RestTemplate} class.
+   * @param builder the {@link RestTemplateBuilder} used to build the {@link RestTemplate} instance.
+   * @return a new instance of the {@link RestTemplate} class.
+   */
   @Bean
   public RestTemplate buildRestTemplate(RestTemplateBuilder builder) {
     return builder.build();
   }
 
+  /**
+   * Creates a new and configured instance of the {@link WebClient} class.
+   * @return a new instance of the {@link WebClient} class.
+   */
   @Bean
   public WebClient standardWebClient() {
     return WebClient.create();
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
index 2ba4d9a6..57c7618e 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
@@ -115,6 +115,10 @@ private OAuthData(
     this.refreshToken = refreshToken;
   }
 
+  /**
+   * Retrieves the expiry time of the access token as an {@link Instant}.
+   * @return an {@link Instant} object representing the expiry time of the access token.
+   */
   @JsonIgnore
   public Instant getExpiresAsInstant() {
     return Instant.parse(expires);
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
index 7d4f1b25..992a3c88 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
@@ -35,6 +35,10 @@ public boolean hasAniListId() {
     return aniListId != 0;
   }
 
+  /**
+   * Checks if the tracker has a MyAnimeList ID.
+   * @return {@code true} if the tracker has a MyAnimeList ID, {@code false} otherwise
+   */
   public boolean hasMalId() {
     return malId != 0;
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
index 2be0a07e..de2780fa 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
@@ -24,6 +24,10 @@ public TrackerTokens() {
     aniListToken = null;
   }
 
+  /**
+   * Checks if the AniList token is present and not expired.
+   * @return {@code true} if the AniList token is present and not expired, {@code false} otherwise.
+   */
   public boolean hasAniListToken() {
     if (aniListToken == null) {
       return false;
@@ -36,6 +40,10 @@ public boolean hasAniListToken() {
     return !aniListToken.getExpiresAsInstant().isBefore(Instant.now());
   }
 
+  /**
+   * Checks if the MAL token is present and not expired.
+   * @return {@code true} if the MAL token is present and not expired, {@code false} otherwise.
+   */
   public boolean hasMalToken() {
     if (malToken == null) {
       return false;
@@ -50,6 +58,10 @@ public boolean hasMalToken() {
     return malToken.getRefreshToken() != null || !expired;
   }
 
+  /**
+   * Sets the AniList authentication data.
+   * @param response the {@link OAuthResponse} containing the AniList authentication data.
+   */
   public void setAniListAuth(OAuthResponse response) {
     aniListToken = new OAuthData(response);
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
index 79a6f231..27103a72 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
@@ -129,10 +129,18 @@ public int hashCode() {
         coverUrl, id, status, type, startDate, summary, title, totalChapters, trackingUrl);
   }
 
+  /**
+   * Returns the type of the manga formatted with the first letter capitalized.
+   * @return The formatted type of the manga.
+   */
   public String getTypeFormatted() {
     return type.substring(0, 1).toUpperCase() + type.substring(1).toLowerCase();
   }
 
+  /**
+   * Returns the status of the manga formatted with the first letter capitalized.
+   * @return The formatted status of the manga.
+   */
   public String getStatusFormatted() {
     return status.substring(0, 1).toUpperCase() + status.substring(1).toLowerCase();
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java
index 565ff63d..091e5a61 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/WebClientService.java
@@ -52,6 +52,12 @@ public WebClientService(SettingsService settingsService) {
     initDgsGraphQlClient(settings.getUrl());
   }
 
+  /**
+   * Handles an {@link UrlChangeEvent} by updating the clients with the new URL of the server
+   * instance. Should only be called by Spring when an {@link UrlChangeEvent} is published.
+   *
+   * @param event the {@link UrlChangeEvent} to handle.
+   */
   @EventListener(UrlChangeEvent.class)
   protected void onUrlChange(UrlChangeEvent event) {
     this.webClient = WebClient.create(event.getUrl());
@@ -101,6 +107,11 @@ private void initWebSocketGraphQlClient(String url) {
     this.webSocketGraphQlClient = WebSocketGraphQlClient.create(uri, webSocketClient);
   }
 
+  /**
+   * Initializes the DGS GraphQL client.
+   *
+   * @param url the URL of the GraphQL server without the {@code /api/graphql} path.
+   */
   private void initDgsGraphQlClient(String url) {
     url = url + "/api/graphql";
     url = url.replace("//api", "/api");
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
index 7d3405ff..3dad167e 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
@@ -29,6 +29,11 @@ public SuwayomiSettingsClient(WebClientService clientService) {
     this.clientService = clientService;
   }
 
+  /**
+   * Updates the user's extension repositories on the Suwayomi Server.
+   * @param extensionRepoUrls a list of extension repository URLs as strings.
+   * @return {@code true} if the extension repositories were updated successfully, {@code false}
+   */
   public boolean updateExtensionRepos(List<String> extensionRepoUrls) {
     // language=GraphQL
     String query =
@@ -60,6 +65,10 @@ mutation UpdateExtensionRepos($extensionRepoUrls: [String!]) {
     return extensionRepos.equals(extensionRepoUrls);
   }
 
+  /**
+   * Retrieves the user's extension repositories from the Suwayomi Server.
+   * @return a list of extension repository URLs as strings.
+   */
   public List<String> getExtensionRepos() {
     // language=GraphQL
     String query =
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
index d7fda560..403280e6 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
@@ -36,6 +36,14 @@ public SuwayomiTrackingClient(WebClientService clientService) {
     this.clientService = clientService;
   }
 
+  /**
+   * Checks if a tracker with the provided ID is logged in.
+   * @param id the ID of the tracker to check if it is logged in
+   * @return {@code true} if the tracker is logged in, {@code false} otherwise
+   *
+   * @see online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService.TrackerType
+   */
+  @SuppressWarnings("JavadocReference")
   public boolean isTrackerLoggedIn(int id) {
     @Language("graphql")
     String query =
@@ -61,6 +69,14 @@ query IsTrackerLoggedIn($id: Int!) {
     return response.extractValueAsObject("tracker.isLoggedIn", Boolean.class);
   }
 
+  /**
+   * Gets the authentication URL for a tracker with the provided ID.
+   * @param id the ID of the tracker to get the authentication URL for
+   * @return the authentication URL for the tracker
+   *
+   * @see online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService.TrackerType
+   */
+  @SuppressWarnings("JavadocReference")
   public String getTrackerAuthUrl(int id) {
     @Language("graphql")
     String query =
@@ -85,16 +101,21 @@ query GetTrackerAuthUrl($id: Int!) {
     return response.extractValueAsObject("tracker.authUrl", String.class);
   }
 
+  /**
+   * Logs in to a tracker using the provided redirect URL and tracker ID.
+   * @param url the redirect URL to log in to the tracker
+   * @param id the ID of the tracker to log in to
+   */
   public void loginTracker(String url, int id) {
     @Language("graphql")
     String query =
         """
-        mutation LoginTracker($url: String!, $trackerId: Int!) {
-          loginTrackerOAuth(input: {callbackUrl: $url, trackerId: $trackerId}) {
-            isLoggedIn
-          }
-        }
-        """;
+            mutation LoginTracker($url: String!, $trackerId: Int!) {
+              loginTrackerOAuth(input: {callbackUrl: $url, trackerId: $trackerId}) {
+                isLoggedIn
+              }
+            }
+            """;
 
     Map<String, Object> variables = Map.of("url", url, "trackerId", id);
 
@@ -111,27 +132,36 @@ mutation LoginTracker($url: String!, $trackerId: Int!) {
     }
   }
 
+  /**
+   * Searches for a manga on a tracker using the provided query and tracker ID.
+   * @param query the search query for the manga
+   * @param id the ID of the tracker to search on
+   * @return a list of {@link TrackerSearchResult} objects representing the search results
+   *
+   * @see online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService.TrackerType
+   */
+  @SuppressWarnings("JavadocReference")
   public List<TrackerSearchResult> searchTracker(String query, int id) {
     @Language("graphql")
     String graphQuery =
         """
-        query searchTracker($query: String!, $id: Int!) {
-          searchTracker(input: {query: $query, trackerId: $id}) {
-            trackSearches {
-              coverUrl
-              id
-              publishingStatus
-              publishingType
-              remoteId
-              startDate
-              summary
-              title
-              totalChapters
-              trackingUrl
+            query searchTracker($query: String!, $id: Int!) {
+              searchTracker(input: {query: $query, trackerId: $id}) {
+                trackSearches {
+                  coverUrl
+                  id
+                  publishingStatus
+                  publishingType
+                  remoteId
+                  startDate
+                  summary
+                  title
+                  totalChapters
+                  trackingUrl
+                }
+              }
             }
-          }
-        }
-        """;
+            """;
 
     Map<String, Object> variables = Map.of("query", query, "id", id);
 
@@ -149,23 +179,35 @@ query searchTracker($query: String!, $id: Int!) {
       throw new RuntimeException(errorText);
     }
 
-    TypeRef<List<TrackerSearchResult>> typeRef = new TypeRef<>() {};
+    TypeRef<List<TrackerSearchResult>> typeRef = new TypeRef<>() {
+    };
 
     return response.extractValueAsObject("searchTracker.trackSearches", typeRef);
   }
 
+  /**
+   * Tracks a manga on a tracker using the provided manga ID, external ID, and tracker ID.
+   *
+   * @param mangaId    the Suwayomi ID of the manga to be tracked
+   * @param externalId the external ID of the manga on the tracker. This is the ID of the manga on
+   *                   the tracker's website.
+   * @param trackerId the ID of the tracker to track the manga on.
+   *
+   * @see online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService.TrackerType
+   */
+  @SuppressWarnings("JavadocReference")
   public void trackMangaOnTracker(int mangaId, int externalId, int trackerId) {
     @Language("graphql")
     var query =
         """
-        mutation TrackManga($mangaId: Int!, $remoteId: Int!, $trackerId: Int!) {
-          bindTrack(input: {mangaId: $mangaId, remoteId: $remoteId, trackerId: $trackerId}) {
-            trackRecord {
-              id
+            mutation TrackManga($mangaId: Int!, $remoteId: Int!, $trackerId: Int!) {
+              bindTrack(input: {mangaId: $mangaId, remoteId: $remoteId, trackerId: $trackerId}) {
+                trackRecord {
+                  id
+                }
+              }
             }
-          }
-        }
-        """;
+            """;
 
     var variables = Map.of("mangaId", mangaId, "externalId", externalId, "trackerId", trackerId);
 
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
index 554e8d5a..0466580d 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
@@ -64,8 +64,9 @@ public class AniListAPIService {
    * dependencies.
    *
    * @param dataService the TrackingDataService object to be used for retrieving and updating the
-   *     AniList token and manga trackers
-   * @param mapper the ObjectMapper object to be used for serializing and deserializing JSON data.
+   *                    AniList token and manga trackers
+   * @param mapper      the ObjectMapper object to be used for serializing and deserializing JSON
+   *                    data.
    */
   public AniListAPIService(TrackingDataService dataService, ObjectMapper mapper) {
     this.dataService = dataService;
@@ -83,7 +84,7 @@ public AniListAPIService(TrackingDataService dataService, ObjectMapper mapper) {
    * Retrieves the AniList token from the settings.
    *
    * @return an Optional containing the AniList token if it is present, otherwise returns an empty
-   *     Optional
+   * Optional
    */
   private Optional<OAuthData> getAniListToken() {
     TrackerTokens trackerTokens = dataService.getTokens();
@@ -109,7 +110,7 @@ public boolean hasAniListToken() {
    *
    * @return the AniList token header as a string
    * @throws IllegalStateException if there is no AniList token available or if the token is not
-   *     valid.
+   *                               valid.
    */
   private String getAniListTokenHeader() {
     if (!hasAniListToken()) {
@@ -196,7 +197,7 @@ query Search($search: String) {
    *
    * @return The current user's ID
    * @throws RuntimeException If no AniList token is available or if there is an error retrieving
-   *     the user ID
+   *                          the user ID
    */
   private int getCurrentUserId() {
     if (!hasAniListToken()) {
@@ -343,8 +344,8 @@ public void addMangaToList(int mangaId, boolean isPrivate) {
    * @param mangaId The ID of the manga.
    * @return The AniListMangaStatistics object containing the manga statistics.
    * @throws WebClientResponseException.NotFound If the manga with the specified ID is not found.
-   * @throws RuntimeException If the response is null, or if there is an error parsing the JSON
-   *     response.
+   * @throws RuntimeException                    If the response is null, or if there is an error
+   *                                             parsing the JSON response.
    */
   public AniListMangaStatistics getMangaFromList(int mangaId) {
     String query =
@@ -414,6 +415,10 @@ public AniListMangaStatistics getMangaFromList(int mangaId) {
     }
   }
 
+  /**
+   * Retrieves the user's score format from AniList.
+   * @return The user's score format as an {@link AniListScoreFormat} enum value.
+   */
   public AniListScoreFormat getScoreFormat() {
     String query =
         """
@@ -445,6 +450,13 @@ public AniListScoreFormat getScoreFormat() {
     return AniListScoreFormat.valueOf(scoreFormat);
   }
 
+  /**
+   * Retrieves the chapter count of the manga with the given AniList ID.
+   *
+   * @param mangaId The AniList ID of the manga to retrieve the chapter count for
+   * @return The chapter count of the manga as an {@link Optional} Integer. If the chapter count is not
+   * available, an empty {@link Optional} is returned.
+   */
   public Optional<Integer> getChapterCount(int mangaId) {
     String query =
         """
@@ -480,6 +492,14 @@ public Optional<Integer> getChapterCount(int mangaId) {
     return Optional.of((int) possibleInt.asNumber());
   }
 
+  /**
+   * Sends a GraphQL request to the AniList API with the given query and variables. Additionally,
+   * the request is authenticated with the user's AniList token, so the user must be logged in.
+   *
+   * @param query     The GraphQL query to send
+   * @param variables The variables to send with the query
+   * @return The response from the AniList API as a String, usually in JSON format
+   */
   @Nullable
   private String sendAuthGraphQLRequest(String query, String variables) {
     GraphQLRequest request = new GraphQLRequest(query, variables);
@@ -494,6 +514,12 @@ private String sendAuthGraphQLRequest(String query, String variables) {
         .block();
   }
 
+  /**
+   * Updates the progress of the manga with the given AniList ID.
+   *
+   * @param mangaId       The AniList ID of the manga to update
+   * @param mangaProgress The new progress of the manga
+   */
   public void updateMangaProgress(int mangaId, float mangaProgress) {
     String query =
         """
@@ -529,6 +555,12 @@ public void updateMangaProgress(int mangaId, float mangaProgress) {
     }
   }
 
+  /**
+   * Updates the status of the manga with the given AniList ID.
+   *
+   * @param aniListId The AniList ID of the manga to update
+   * @param value     The new status of the manga as an {@link AniListStatus} enum value
+   */
   public void updateMangaStatus(int aniListId, AniListStatus value) {
     String query =
         """
@@ -564,6 +596,12 @@ public void updateMangaStatus(int aniListId, AniListStatus value) {
     }
   }
 
+  /**
+   * Updates the score of the manga with the given AniList ID.
+   *
+   * @param aniListId The AniList ID of the manga to update
+   * @param value     The new score of the manga. Range depends on the user's score format.
+   */
   public void updateMangaScore(int aniListId, int value) {
 
     String query =
@@ -600,6 +638,12 @@ public void updateMangaScore(int aniListId, int value) {
     }
   }
 
+  /**
+   * Updates the start date of the manga with the given AniList ID.
+   *
+   * @param aniListId The AniList ID of the manga to update
+   * @param date      The new start date of the manga as a {@link MediaDate} object
+   */
   public void updateMangaStartDate(int aniListId, MediaDate date) {
     String query =
         """
@@ -643,6 +687,12 @@ public void updateMangaStartDate(int aniListId, MediaDate date) {
     }
   }
 
+  /**
+   * Updates the end date of the manga with the given AniList ID.
+   *
+   * @param aniListId The AniList ID of the manga to update
+   * @param date      The new end date of the manga as a {@link MediaDate} object
+   */
   public void updateMangaEndDate(int aniListId, MediaDate date) {
     String query =
         """
@@ -690,7 +740,7 @@ public void updateMangaEndDate(int aniListId, MediaDate date) {
    * Retrieves the user's manga list.
    *
    * @return The manga list containing the user's reading, plan to read, completed, on hold, and
-   *     dropped manga
+   * dropped manga
    * @throws RuntimeException If an error occurs while retrieving the manga list
    */
   public MangaList getMangaList() {
@@ -759,7 +809,8 @@ public MangaList getMangaList() {
     for (int i = 0; i < listSize; i++) {
       var list = lists.getObject(i).getArray("entries");
 
-      var typeRef = new TypeReference<List<AniListMedia>>() {};
+      var typeRef = new TypeReference<List<AniListMedia>>() {
+      };
       try {
         for (int j = 0; j < list.length(); j++) {
           replaceMediaWithImageAndTitle(list, j);
@@ -794,7 +845,7 @@ public MangaList getMangaList() {
    * Replaces the "media" object in a JsonArray with "coverImage" and "title" objects.
    *
    * @param list The JsonArray containing the media object to be replaced
-   * @param j The index of the media object within the JsonArray
+   * @param j    The index of the media object within the JsonArray
    */
   private void replaceMediaWithImageAndTitle(JsonArray list, int j) {
     var media = list.getObject(j).getObject("media");
@@ -821,6 +872,13 @@ private JsonArray getListsFromResponse(String response) {
     return collection.getArray("lists");
   }
 
+  /**
+   * Updates the privacy status of the manga with the given AniList ID.
+   *
+   * @param aniListId The AniList ID of the manga to update
+   * @param isPrivate The new privacy status of the manga. {@code true} if the manga is private, {@code false}
+   *                  otherwise
+   */
   public void updateMangaPrivacyStatus(int aniListId, boolean isPrivate) {
     // language=graphql
     String query =
@@ -857,6 +915,12 @@ public void updateMangaPrivacyStatus(int aniListId, boolean isPrivate) {
     }
   }
 
+  /**
+   * Retrieves the entry ID of the manga with the given AniList ID in the user's list.
+   *
+   * @param mangaId The AniList ID of the manga to retrieve
+   * @return The entry ID of the manga in the user's list
+   */
   private int getMangaListEntryId(int mangaId) {
     // language=graphql
     String query =
@@ -883,6 +947,11 @@ private int getMangaListEntryId(int mangaId) {
     return (int) json.getObject("data").getObject("MediaList").getNumber("id");
   }
 
+  /**
+   * Removes the manga with the given AniList ID from the user's list.
+   *
+   * @param aniListId The AniList ID of the manga to remove
+   */
   public void removeMangaFromList(int aniListId) {
     // language=graphql
     String query =
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
index 8ca97021..81e86e83 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
@@ -49,12 +49,13 @@ public class MyAnimeListAPIService {
   private final TrackingDataService tds;
   private final WebClient webClient;
   private final Cache<UUID, String> pkceCache;
-  @Nullable private MyAnimeList mal;
+  @Nullable
+  private MyAnimeList mal;
 
   /**
    * Initializes an instance of the MyAnimeListAPIService class.
    *
-   * @param tds The {@link TrackingDataService} used for storing tokens.
+   * @param tds       The {@link TrackingDataService} used for storing tokens.
    * @param webClient The {@link WebClient} used for making requests to the MAL API.
    */
   public MyAnimeListAPIService(TrackingDataService tds, WebClient webClient) {
@@ -78,10 +79,22 @@ public MyAnimeListAPIService(TrackingDataService tds, WebClient webClient) {
     authenticateMALWithToken(data);
   }
 
+  /**
+   * Authenticates the MAL API with the provided {@link OAuthData} object containing the access token.
+   * The resulting {@link MyAnimeList} object is stored in {@link #mal}
+   *
+   * @param data The {@link OAuthData} object containing the access token.
+   */
   private void authenticateMALWithToken(OAuthData data) {
     this.mal = MyAnimeList.withToken(data.getAccessToken());
   }
 
+  /**
+   * Generates the authorization URL for MyAnimeList. This URL is used to authenticate the user with
+   * the MAL API.
+   *
+   * @return The authorization URL for MyAnimeList.
+   */
   @NotNull
   public String getAuthUrl() {
     String baseUrl = "https://myanimelist.net/v1/oauth2/authorize";
@@ -102,12 +115,23 @@ public String getAuthUrl() {
     return "%s?%s".formatted(baseUrl, params);
   }
 
+  /**
+   * Checks if the user has a valid MAL token.
+   *
+   * @return {@code true} if the user has a valid MAL token, {@code false} otherwise.
+   */
   public boolean hasMalToken() {
     return tds.getTokens().hasMalToken();
   }
 
+  /**
+   * Exchanges the authorization code for an access and refresh token. Verifies the PKCE ID before
+   * exchanging the code for tokens.
+   *
+   * @param code   The authorization code to exchange for tokens.
+   * @param pkceId The PKCE ID used for generating the code challenge.
+   */
   public void exchangeCodeForTokens(String code, String pkceId) {
-
     String pkce = pkceCache.getIfPresent(UUID.fromString(pkceId));
 
     if (pkce == null) {
@@ -126,6 +150,12 @@ public void exchangeCodeForTokens(String code, String pkceId) {
     authenticateMALWithToken(data);
   }
 
+  /**
+   * Refreshes the access token using the refresh token.
+   *
+   * @param refreshToken The refresh token to use for refreshing the access token.
+   * @return An {@link OAuthData} object containing the new access token and refresh token.
+   */
   private OAuthData refreshToken(String refreshToken) {
     MultiValueMap<String, String> body = new LinkedMultiValueMap<>();
     body.add("grant_type", "refresh_token");
@@ -141,6 +171,13 @@ private OAuthData refreshToken(String refreshToken) {
         .block();
   }
 
+  /**
+   * Retrieves a list of {@link Manga} objects with the specified status.
+   *
+   * @param status The {@link MangaStatus} enum value representing the status of the manga.
+   * @return A List of {@link Manga} objects with the specified status.
+   * @throws IllegalStateException If not authenticated with MyAnimeList (MAL).
+   */
   public List<Manga> getMangaWithStatus(MangaStatus status) {
     if (mal == null) {
       throw new IllegalStateException("Not authenticated with MAL");
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
index f3d1838e..33ed1e37 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
@@ -8,6 +8,7 @@
 
 import java.util.Arrays;
 import java.util.List;
+import javax.annotation.Nullable;
 import lombok.Getter;
 import online.hatsunemiku.tachideskvaadinui.data.tracking.search.TrackerSearchResult;
 import online.hatsunemiku.tachideskvaadinui.services.client.suwayomi.SuwayomiTrackingClient;
@@ -27,56 +28,114 @@ public class SuwayomiTrackingService {
    * Represents a Suwayomi Tracking Service.
    *
    * @param client the {@link SuwayomiTrackingClient} used for handling tracking requests to the
-   *     Suwayomi Server.
+   *               Suwayomi Server.
    */
   public SuwayomiTrackingService(SuwayomiTrackingClient client) {
     this.client = client;
   }
 
+  /**
+   * Checks if the Suwayomi tracking service is authenticated with AniList.
+   *
+   * @return true if the Suwayomi tracking service is authenticated with AniList, false otherwise
+   */
   public boolean isAniListAuthenticated() {
     int id = TrackerType.ANILIST.id;
     return client.isTrackerLoggedIn(id);
   }
 
+  /**
+   * Checks if the Suwayomi tracking service is authenticated with MyAnimeList (MAL).
+   *
+   * @return true if the Suwayomi tracking service is authenticated with MAL, false otherwise
+   */
   public boolean isMALAuthenticated() {
     int id = TrackerType.MAL.id;
     return client.isTrackerLoggedIn(id);
   }
 
+  /**
+   * Constructs the AniList authentication URL. This URL is used to authenticate the User with the
+   * AniList API.
+   *
+   * @return the AniList authentication URL as a string
+   */
   public String getAniListAuthUrl() {
     int id = TrackerType.ANILIST.id;
     return client.getTrackerAuthUrl(id) + getStateAuthParam(id);
   }
 
+  /**
+   * Constructs the MyAnimeList (MAL) authentication URL. This URL is used to authenticate the User
+   * with the MAL API.
+   *
+   * @return the MAL authentication URL as a string
+   */
   public String getMALAuthUrl() {
     int id = TrackerType.MAL.id;
     return client.getTrackerAuthUrl(id) + getStateAuthParam(id);
   }
 
+  /**
+   * Searches for manga on AniList using the provided query.
+   *
+   * @param query the search query for manga
+   * @return a list of {@link TrackerSearchResult} objects representing the search results
+   */
   public List<TrackerSearchResult> searchAniList(String query) {
     int id = TrackerType.ANILIST.id;
     return client.searchTracker(query, id);
   }
 
+  /**
+   * Searches for manga on MyAnimeList (MAL) using the provided query.
+   *
+   * @param query the search query for manga
+   * @return a list of {@link TrackerSearchResult} objects representing the search results
+   */
   public List<TrackerSearchResult> searchMAL(String query) {
     int id = TrackerType.MAL.id;
     return client.searchTracker(query, id);
   }
 
+  /**
+   * Tracks a manga on AniList using the provided manga ID and external ID.
+   *
+   * @param mangaId    the ID of the manga to be tracked
+   * @param externalId the external ID of the manga on AniList
+   */
   public void trackOnAniList(int mangaId, int externalId) {
     int id = TrackerType.ANILIST.id;
     client.trackMangaOnTracker(mangaId, externalId, id);
   }
 
+  /**
+   * Tracks a manga on MyAnimeList (MAL) using the provided manga ID and external ID.
+   *
+   * @param mangaId    the ID of the manga to be tracked
+   * @param externalId the external ID of the manga on MAL
+   */
   public void trackOnMAL(int mangaId, int externalId) {
     int id = TrackerType.MAL.id;
     client.trackMangaOnTracker(mangaId, externalId, id);
   }
 
+  /**
+   * Logs in to the Suwayomi tracker with the specified URL and tracker ID.
+   *
+   * @param url       the URL used for the login callback
+   * @param trackerId the ID of the tracker to log in to
+   */
   public void loginSuwayomi(String url, int trackerId) {
     client.loginTracker(url, trackerId);
   }
 
+  /**
+   * Retrieves the state authentication parameter for the specified tracker.
+   *
+   * @param id the ID of the tracker
+   * @return the state authentication parameter as a formatted string
+   */
   private String getStateAuthParam(int id) {
 
     String jsonTemplate =
@@ -91,14 +150,22 @@ private String getStateAuthParam(int id) {
 
     String template = "&state=%s";
 
-    String trackerName = TrackerType.fromId(id).name();
+    TrackerType trackerType = TrackerType.fromId(id);
+
+    if (trackerType == null) {
+      throw new IllegalArgumentException("Invalid tracker ID");
+    }
+
+    String trackerName = trackerType.name();
 
     String json = jsonTemplate.formatted(id, trackerName);
 
     return template.formatted(json);
   }
 
-  /** An enumeration representing different types of trackers. */
+  /**
+   * An enumeration representing different types of trackers.
+   */
   @Getter
   private enum TrackerType {
     MAL(1),
@@ -115,6 +182,13 @@ private enum TrackerType {
       this.id = id;
     }
 
+    /**
+     * Retrieves the {@link TrackerType} object based on the provided id.
+     *
+     * @param id the id of the TrackerType
+     * @return the corresponding {@link TrackerType} object, or null if no match is found
+     */
+    @Nullable
     public static TrackerType fromId(int id) {
       var match =
           Arrays.stream(TrackerType.values())
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
index e5f326e4..b24ff59e 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/MangaView.java
@@ -135,6 +135,13 @@ public void beforeEnter(BeforeEnterEvent event) {
     setContent(container);
   }
 
+  /**
+   * Retrieves and constructs the buttons needed for functionality for a manga.
+   *
+   * @param manga The {@link Manga} object for which to retrieve the buttons.
+   * @param chapters The list of {@link Chapter} objects available for the manga.
+   * @return The constructed {@link Div} element containing the buttons.
+   */
   @NotNull
   private Div getButtons(Manga manga, List<Chapter> chapters) {
     Div buttons = new Div();
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
index 4a338950..76e78317 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
@@ -69,8 +69,8 @@ public class SearchView extends StandardLayout implements HasUrlParameter<String
   /**
    * Constructs a SearchView object.
    *
-   * @param sourceService the {@link SourceService} used for retrieving manga sources
-   * @param searchService the {@link SearchService} used for performing search operations
+   * @param sourceService   the {@link SourceService} used for retrieving manga sources
+   * @param searchService   the {@link SearchService} used for performing search operations
    * @param settingsService the {@link SettingsService} used for accessing search settings
    */
   public SearchView(
@@ -107,6 +107,12 @@ public SearchView(
     setContent(content);
   }
 
+  /**
+   * Retrieves the "Import from MAL" button. This button is used to navigate to the
+   * {@link MALView}.
+   *
+   * @return the button that navigates to the {@link MALView}
+   */
   @NotNull
   private Button getMalImportBtn() {
     Button malImportBtn = new Button("Import from MAL", VaadinIcon.DOWNLOAD.create());
@@ -124,6 +130,12 @@ private Button getMalImportBtn() {
     return malImportBtn;
   }
 
+  /**
+   * Retrieves the "Import from AniList" button. This button is used to navigate to the
+   * {@link AniListView}.
+   *
+   * @return The button that navigates to the {@link AniListView}
+   */
   @NotNull
   private Button getALImportBtn() {
     Button importBtn = new Button("Import from AniList", VaadinIcon.DOWNLOAD.create());
@@ -256,7 +268,7 @@ public void search(String query) {
   /**
    * Adds a search result to the user interface.
    *
-   * @param source the source of the search result
+   * @param source    the source of the search result
    * @param mangaList the list of manga from the search result
    * @return true if the search result was successfully added, otherwise false
    */
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
index 65b3b036..c3eb13ca 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
@@ -13,7 +13,9 @@
 import java.util.List;
 import online.hatsunemiku.tachideskvaadinui.component.card.Card;
 
-/** TrackingLayout is a layout/base for displaying tracking information to import. */
+/**
+ * TrackingLayout is a layout/base for displaying tracking information to import.
+ */
 @CssImport("./css/views/imports/importCommons.css")
 public abstract class TrackingLayout extends StandardLayout {
 
@@ -28,6 +30,11 @@ protected TrackingLayout(String title) {
     addClassName("tracking-layout");
   }
 
+  /**
+   * Initializes the tracking layout based on the availability of a token.
+   * If a token is available, it creates and adds the necessary sections to the layout.
+   * If a token is not available, it adds an authentication button to the layout.
+   */
   protected void init() {
     if (!hasToken()) {
       Div content = new Div();
@@ -41,6 +48,8 @@ protected void init() {
       return;
     }
 
+    //TODO style auth button
+
     var reading = getReadingSection();
     var planToRead = getPlanToReadSection();
     var completed = getCompletedSection();
@@ -54,20 +63,69 @@ protected void init() {
     setContent(content);
   }
 
+  /**
+   * Checks if there's a token available for the Tracking Service. This method should be implemented
+   * by subclasses.
+   *
+   * @return {@code true} if the subclass has a token, {@code false} otherwise
+   */
   public abstract boolean hasToken();
 
+  /**
+   * Authenticates the user with the Tracking Service. This method should be implemented by
+   * subclasses to perform the necessary authentication logic.
+   */
   public abstract void authenticate();
 
+  /**
+   * Returns the `Reading` manga section for the tracking layout. This method should be implemented
+   * by subclasses.
+   *
+   * @return the `Reading` section as a Div element
+   */
+
   public abstract Div getReadingSection();
 
+  /**
+   * Returns the `Plan to Read` manga section for the tracking layout. This method should be
+   * implemented by subclasses.
+   *
+   * @return the `Plan to Read` section as a Div element
+   */
+
   public abstract Div getPlanToReadSection();
 
+  /**
+   * Returns the `Completed` manga section for the tracking layout. This method should be
+   * implemented by subclasses.
+   *
+   * @return the `Completed` section as a Div element
+   */
   public abstract Div getCompletedSection();
 
+  /**
+   * Returns the `On Hold` manga section for the tracking layout. This method should be implemented
+   * by subclasses.
+   *
+   * @return the `On Hold` section as a Div element
+   */
   public abstract Div getOnHoldSection();
 
+  /**
+   * Returns the `Dropped` manga section for the tracking layout. This method should be implemented
+   * by subclasses.
+   *
+   * @return the `Dropped` section as a Div element
+   */
   public abstract Div getDroppedSection();
 
+  /**
+   * Generates a content section containing a title and a list of cards.
+   *
+   * @param title   the title of the content section
+   * @param content the list of cards to be added to the content section
+   * @return a Div element representing the content section
+   */
   public Div getContentSection(String title, List<? extends Card> content) {
     Div section = new Div();
     section.addClassName("import-content");
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
index 922ee819..9b1a1ab2 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
@@ -94,6 +94,12 @@ public Div getDroppedSection() {
     return getContentSection("Dropped", cards);
   }
 
+  /**
+   * Returns a list of {@link AniListMediaCard} objects based on the provided list of {@link AniListMedia} objects.
+   *
+   * @param media the list of {@link AniListMedia} objects to convert to cards
+   * @return a list of {@link AniListMediaCard} objects
+   */
   private List<AniListMediaCard> getCards(List<AniListMedia> media) {
     return media.stream().map(AniListMediaCard::new).toList();
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
index a1abf85b..aa187dbb 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
@@ -101,6 +101,12 @@ public Div getDroppedSection() {
     return getContentSection("Dropped", cards);
   }
 
+  /**
+   * Retrieves a list of {@link MalMediaCard} objects based on the given list of {@link Manga} objects.
+   *
+   * @param media the list of {@link Manga} objects from which to create the cards.
+   * @return a list of {@link MalMediaCard} objects.
+   */
   private List<MalMediaCard> getCards(List<Manga> media) {
     return media.stream().map(MalMediaCard::new).toList();
   }

From 8e66f59c1a9e9e666ff00cef67d2b993859db0e8 Mon Sep 17 00:00:00 2001
From: "deepsource-autofix[bot]"
 <62050782+deepsource-autofix[bot]@users.noreply.github.com>
Date: Sat, 6 Apr 2024 21:20:20 +0000
Subject: [PATCH 15/17] style: format code with Google Java Format

This commit fixes the style issues introduced in c3a185c according to the output
from Google Java Format.

Details: https://github.com/Suwayomi/Suwayomi-VaadinUI/pull/106
---
 .../tachideskvaadinui/api/AuthAPI.java        | 22 ++++------
 .../dialog/tracking/TrackingDialog.java       | 24 +++++------
 .../tracking/TrackingMangaChoiceDialog.java   | 14 +++---
 .../tracking/provider/TrackerProvider.java    | 12 +++---
 .../tachideskvaadinui/config/HttpConfig.java  |  2 +
 .../data/tracking/OAuthData.java              |  1 +
 .../data/tracking/Tracker.java                |  1 +
 .../data/tracking/TrackerTokens.java          |  3 ++
 .../tracking/search/TrackerSearchResult.java  |  2 +
 .../suwayomi/SuwayomiSettingsClient.java      |  2 +
 .../suwayomi/SuwayomiTrackingClient.java      | 15 +++----
 .../services/tracker/AniListAPIService.java   | 43 +++++++++----------
 .../tracker/MyAnimeListAPIService.java        | 11 +++--
 .../tracker/SuwayomiTrackingService.java      | 12 +++---
 .../tachideskvaadinui/view/SearchView.java    | 13 +++---
 .../view/layout/TrackingLayout.java           | 16 +++----
 .../view/trackers/AniListView.java            |  3 +-
 .../view/trackers/MALView.java                |  3 +-
 18 files changed, 96 insertions(+), 103 deletions(-)

diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
index 6f223764..b82c0f28 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/api/AuthAPI.java
@@ -24,9 +24,7 @@
 import org.springframework.web.bind.annotation.RestController;
 import org.springframework.web.servlet.view.RedirectView;
 
-/**
- * Handles authentication and token validation for various services.
- */
+/** Handles authentication and token validation for various services. */
 @RestController
 @RequestMapping("validate")
 @Slf4j
@@ -39,12 +37,10 @@ public class AuthAPI {
   /**
    * Creates a new instance of the {@link AuthAPI} class.
    *
-   * @param dataService             the {@link TrackingDataService} instance used to store the
-   *                                authentication.
+   * @param dataService the {@link TrackingDataService} instance used to store the authentication.
    * @param suwayomiTrackingService the {@link SuwayomiTrackingService} instance used to
-   *                                authenticate with Suwayomi.
-   * @param malAPI                  the {@link MyAnimeListAPIService} instance used to authenticate
-   *                                with MyAnimeList.
+   *     authenticate with Suwayomi.
+   * @param malAPI the {@link MyAnimeListAPIService} instance used to authenticate with MyAnimeList.
    */
   public AuthAPI(
       TrackingDataService dataService,
@@ -61,7 +57,7 @@ public AuthAPI(
    * URL.
    *
    * @return the HTML content with the JavaScript code to execute the data extraction and redirect
-   * to the response URL
+   *     to the response URL
    */
   @GetMapping(value = "anilist", produces = MediaType.TEXT_HTML_VALUE)
   public String validateAniListToken() {
@@ -125,9 +121,9 @@ public String validateAniListToken() {
    * services.
    *
    * @param request the {@link HttpServletRequest} used to retrieve the requested URL
-   * @param json    the JSON string containing the state information
+   * @param json the JSON string containing the state information
    * @return the {@link RedirectView} object to redirect the user to the appropriate page after
-   * authentication is done
+   *     authentication is done
    */
   @GetMapping("suwayomi")
   public RedirectView authenticateSuwayomi(
@@ -187,7 +183,5 @@ public RedirectView validateMALToken(
    * Represents the state parameter of a MAL token response. Contains the PKCE (Proof Key for Code
    * Exchange) ID to be used in the token exchange.
    */
-  public record MALTokenState(String pkceId) {
-
-  }
+  public record MALTokenState(String pkceId) {}
 }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
index a4b717bc..b14ce093 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingDialog.java
@@ -53,12 +53,12 @@ public class TrackingDialog extends Dialog {
   /**
    * Constructs a {@link TrackingDialog} with the given parameters.
    *
-   * @param dataService             The {@link TrackingDataService} used for storing tracking data.
-   * @param manga                   the {@link Manga} to track with the dialog.
-   * @param aniListAPIService       the {@link AniListAPIService} used for making requests to the
-   *                                AniList API.
+   * @param dataService The {@link TrackingDataService} used for storing tracking data.
+   * @param manga the {@link Manga} to track with the dialog.
+   * @param aniListAPIService the {@link AniListAPIService} used for making requests to the AniList
+   *     API.
    * @param suwayomiTrackingService the {@link SuwayomiTrackingService} used for making requests to
-   *                                the Suwayomi API.
+   *     the Suwayomi API.
    */
   public TrackingDialog(
       TrackingDataService dataService,
@@ -95,10 +95,10 @@ public TrackingDialog(
   /**
    * Adds the tracking buttons to the dialog.
    *
-   * @param manga             the {@link Manga} to track
+   * @param manga the {@link Manga} to track
    * @param aniListAPIService the {@link AniListAPIService} to communicate with AniList with
-   * @param tracker           the {@link Tracker} instance to update the button states via
-   *                          {@link #updateButtons(Button, Button, Tracker)}
+   * @param tracker the {@link Tracker} instance to update the button states via {@link
+   *     #updateButtons(Button, Button, Tracker)}
    */
   private void addTrackingButtons(
       Manga manga, AniListAPIService aniListAPIService, Tracker tracker) {
@@ -134,7 +134,7 @@ private void addTrackingButtons(
           try {
             displaySearch(manga.getTitle(), manga.getId(), provider);
           } catch (WebClientResponseException.InternalServerError
-                   | WebClientRequestException error) {
+              | WebClientRequestException error) {
             log.error("Invalid response from AniList", error);
             Notification notification = new Notification();
             notification.addThemeVariants(NotificationVariant.LUMO_ERROR);
@@ -157,7 +157,7 @@ private void addTrackingButtons(
           try {
             displaySearch(manga.getTitle(), manga.getId(), provider);
           } catch (WebClientResponseException.InternalServerError
-                   | WebClientRequestException error) {
+              | WebClientRequestException error) {
             log.error("Invalid response from MyAnimeList", error);
             Notification notification = new Notification();
             notification.addThemeVariants(NotificationVariant.LUMO_ERROR);
@@ -464,8 +464,8 @@ private void displaySearch(String mangaName, long mangaId, TrackerProvider track
    * Updates the tracking buttons with the current tracking status.
    *
    * @param aniListBtn the AniList tracking button
-   * @param malBtn     the MyAnimeList tracking button
-   * @param tracker    the tracker to check the status of
+   * @param malBtn the MyAnimeList tracking button
+   * @param tracker the tracker to check the status of
    */
   private void updateButtons(Button aniListBtn, Button malBtn, Tracker tracker) {
     if (tracker.hasAniListId()) {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
index d2cdfcac..68e8c1b9 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/TrackingMangaChoiceDialog.java
@@ -26,18 +26,16 @@
 import org.vaadin.miki.shared.labels.LabelPosition;
 import org.vaadin.miki.superfields.text.LabelField;
 
-/**
- * Represents a dialog for choosing and tracking a manga.
- */
+/** Represents a dialog for choosing and tracking a manga. */
 public class TrackingMangaChoiceDialog extends Dialog {
 
   /**
    * Constructs a {@link TrackingMangaChoiceDialog}.
    *
-   * @param mangaName       the name of the manga to search
-   * @param mangaId         the ID of the manga on Suwayomi
+   * @param mangaName the name of the manga to search
+   * @param mangaId the ID of the manga on Suwayomi
    * @param trackerProvider the {@link TrackerProvider} to use for tracking activities.
-   * @param dataService     the {@link TrackingDataService} to use for saving tracking data.
+   * @param dataService the {@link TrackingDataService} to use for saving tracking data.
    */
   public TrackingMangaChoiceDialog(
       String mangaName,
@@ -143,9 +141,9 @@ public TrackingMangaChoiceDialog(
    * Changes the visibility of the search results and the no results text based on whether the
    * search results are empty or not.
    *
-   * @param mangaList     the list of {@link TrackerSearchResult search results}
+   * @param mangaList the list of {@link TrackerSearchResult search results}
    * @param searchResults the {@link ListBox} containing the search results
-   * @param noResults     the {@link Div} containing the no results text
+   * @param noResults the {@link Div} containing the no results text
    */
   private static void changeSearchResultsVisibility(
       List<TrackerSearchResult> mangaList,
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
index cbb5ac65..d894326b 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/component/dialog/tracking/provider/TrackerProvider.java
@@ -20,7 +20,7 @@ public interface TrackerProvider {
    * Checks if the tracker supports setting entries to private.
    *
    * @return {@code true} if the tracker supports setting entries to private, {@code false}
-   * otherwise
+   *     otherwise
    */
   boolean canSetPrivate();
 
@@ -33,17 +33,15 @@ public interface TrackerProvider {
   List<TrackerSearchResult> search(String query);
 
   /**
-   * @param isPrivate  whether the entry should be set to private
-   * @param mangaId    the id of the manga according to Suwayomi
+   * @param isPrivate whether the entry should be set to private
+   * @param mangaId the id of the manga according to Suwayomi
    * @param externalId the id of the manga on the tracker
    * @throws IllegalArgumentException if `isPrivate` is set to true and the tracker does not support
-   *                                  private entries
+   *     private entries
    */
   void submitToTracker(boolean isPrivate, int mangaId, int externalId);
 
-  /**
-   * Equivalent to calling `submitToTracker(false, mangaId, externalId)`
-   */
+  /** Equivalent to calling `submitToTracker(false, mangaId, externalId)` */
   default void submitToTracker(int mangaId, int externalId) {
     submitToTracker(false, mangaId, externalId);
   }
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
index d9a4948f..3ed708d0 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/config/HttpConfig.java
@@ -18,6 +18,7 @@ public class HttpConfig {
 
   /**
    * Creates a new and configured instance of the {@link RestTemplate} class.
+   *
    * @param builder the {@link RestTemplateBuilder} used to build the {@link RestTemplate} instance.
    * @return a new instance of the {@link RestTemplate} class.
    */
@@ -28,6 +29,7 @@ public RestTemplate buildRestTemplate(RestTemplateBuilder builder) {
 
   /**
    * Creates a new and configured instance of the {@link WebClient} class.
+   *
    * @return a new instance of the {@link WebClient} class.
    */
   @Bean
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
index 57c7618e..9ca4db4f 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/OAuthData.java
@@ -117,6 +117,7 @@ private OAuthData(
 
   /**
    * Retrieves the expiry time of the access token as an {@link Instant}.
+   *
    * @return an {@link Instant} object representing the expiry time of the access token.
    */
   @JsonIgnore
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
index 992a3c88..374d4819 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/Tracker.java
@@ -37,6 +37,7 @@ public boolean hasAniListId() {
 
   /**
    * Checks if the tracker has a MyAnimeList ID.
+   *
    * @return {@code true} if the tracker has a MyAnimeList ID, {@code false} otherwise
    */
   public boolean hasMalId() {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
index de2780fa..b00fa207 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/TrackerTokens.java
@@ -26,6 +26,7 @@ public TrackerTokens() {
 
   /**
    * Checks if the AniList token is present and not expired.
+   *
    * @return {@code true} if the AniList token is present and not expired, {@code false} otherwise.
    */
   public boolean hasAniListToken() {
@@ -42,6 +43,7 @@ public boolean hasAniListToken() {
 
   /**
    * Checks if the MAL token is present and not expired.
+   *
    * @return {@code true} if the MAL token is present and not expired, {@code false} otherwise.
    */
   public boolean hasMalToken() {
@@ -60,6 +62,7 @@ public boolean hasMalToken() {
 
   /**
    * Sets the AniList authentication data.
+   *
    * @param response the {@link OAuthResponse} containing the AniList authentication data.
    */
   public void setAniListAuth(OAuthResponse response) {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
index 27103a72..df3333e1 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/data/tracking/search/TrackerSearchResult.java
@@ -131,6 +131,7 @@ public int hashCode() {
 
   /**
    * Returns the type of the manga formatted with the first letter capitalized.
+   *
    * @return The formatted type of the manga.
    */
   public String getTypeFormatted() {
@@ -139,6 +140,7 @@ public String getTypeFormatted() {
 
   /**
    * Returns the status of the manga formatted with the first letter capitalized.
+   *
    * @return The formatted status of the manga.
    */
   public String getStatusFormatted() {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
index 3dad167e..e0891086 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiSettingsClient.java
@@ -31,6 +31,7 @@ public SuwayomiSettingsClient(WebClientService clientService) {
 
   /**
    * Updates the user's extension repositories on the Suwayomi Server.
+   *
    * @param extensionRepoUrls a list of extension repository URLs as strings.
    * @return {@code true} if the extension repositories were updated successfully, {@code false}
    */
@@ -67,6 +68,7 @@ mutation UpdateExtensionRepos($extensionRepoUrls: [String!]) {
 
   /**
    * Retrieves the user's extension repositories from the Suwayomi Server.
+   *
    * @return a list of extension repository URLs as strings.
    */
   public List<String> getExtensionRepos() {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
index 403280e6..e1b993b3 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/client/suwayomi/SuwayomiTrackingClient.java
@@ -38,9 +38,9 @@ public SuwayomiTrackingClient(WebClientService clientService) {
 
   /**
    * Checks if a tracker with the provided ID is logged in.
+   *
    * @param id the ID of the tracker to check if it is logged in
    * @return {@code true} if the tracker is logged in, {@code false} otherwise
-   *
    * @see online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService.TrackerType
    */
   @SuppressWarnings("JavadocReference")
@@ -71,9 +71,9 @@ query IsTrackerLoggedIn($id: Int!) {
 
   /**
    * Gets the authentication URL for a tracker with the provided ID.
+   *
    * @param id the ID of the tracker to get the authentication URL for
    * @return the authentication URL for the tracker
-   *
    * @see online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService.TrackerType
    */
   @SuppressWarnings("JavadocReference")
@@ -103,6 +103,7 @@ query GetTrackerAuthUrl($id: Int!) {
 
   /**
    * Logs in to a tracker using the provided redirect URL and tracker ID.
+   *
    * @param url the redirect URL to log in to the tracker
    * @param id the ID of the tracker to log in to
    */
@@ -134,10 +135,10 @@ mutation LoginTracker($url: String!, $trackerId: Int!) {
 
   /**
    * Searches for a manga on a tracker using the provided query and tracker ID.
+   *
    * @param query the search query for the manga
    * @param id the ID of the tracker to search on
    * @return a list of {@link TrackerSearchResult} objects representing the search results
-   *
    * @see online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService.TrackerType
    */
   @SuppressWarnings("JavadocReference")
@@ -179,8 +180,7 @@ query searchTracker($query: String!, $id: Int!) {
       throw new RuntimeException(errorText);
     }
 
-    TypeRef<List<TrackerSearchResult>> typeRef = new TypeRef<>() {
-    };
+    TypeRef<List<TrackerSearchResult>> typeRef = new TypeRef<>() {};
 
     return response.extractValueAsObject("searchTracker.trackSearches", typeRef);
   }
@@ -188,11 +188,10 @@ query searchTracker($query: String!, $id: Int!) {
   /**
    * Tracks a manga on a tracker using the provided manga ID, external ID, and tracker ID.
    *
-   * @param mangaId    the Suwayomi ID of the manga to be tracked
+   * @param mangaId the Suwayomi ID of the manga to be tracked
    * @param externalId the external ID of the manga on the tracker. This is the ID of the manga on
-   *                   the tracker's website.
+   *     the tracker's website.
    * @param trackerId the ID of the tracker to track the manga on.
-   *
    * @see online.hatsunemiku.tachideskvaadinui.services.tracker.SuwayomiTrackingService.TrackerType
    */
   @SuppressWarnings("JavadocReference")
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
index 0466580d..49a2dc50 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/AniListAPIService.java
@@ -64,9 +64,8 @@ public class AniListAPIService {
    * dependencies.
    *
    * @param dataService the TrackingDataService object to be used for retrieving and updating the
-   *                    AniList token and manga trackers
-   * @param mapper      the ObjectMapper object to be used for serializing and deserializing JSON
-   *                    data.
+   *     AniList token and manga trackers
+   * @param mapper the ObjectMapper object to be used for serializing and deserializing JSON data.
    */
   public AniListAPIService(TrackingDataService dataService, ObjectMapper mapper) {
     this.dataService = dataService;
@@ -84,7 +83,7 @@ public AniListAPIService(TrackingDataService dataService, ObjectMapper mapper) {
    * Retrieves the AniList token from the settings.
    *
    * @return an Optional containing the AniList token if it is present, otherwise returns an empty
-   * Optional
+   *     Optional
    */
   private Optional<OAuthData> getAniListToken() {
     TrackerTokens trackerTokens = dataService.getTokens();
@@ -110,7 +109,7 @@ public boolean hasAniListToken() {
    *
    * @return the AniList token header as a string
    * @throws IllegalStateException if there is no AniList token available or if the token is not
-   *                               valid.
+   *     valid.
    */
   private String getAniListTokenHeader() {
     if (!hasAniListToken()) {
@@ -197,7 +196,7 @@ query Search($search: String) {
    *
    * @return The current user's ID
    * @throws RuntimeException If no AniList token is available or if there is an error retrieving
-   *                          the user ID
+   *     the user ID
    */
   private int getCurrentUserId() {
     if (!hasAniListToken()) {
@@ -344,8 +343,8 @@ public void addMangaToList(int mangaId, boolean isPrivate) {
    * @param mangaId The ID of the manga.
    * @return The AniListMangaStatistics object containing the manga statistics.
    * @throws WebClientResponseException.NotFound If the manga with the specified ID is not found.
-   * @throws RuntimeException                    If the response is null, or if there is an error
-   *                                             parsing the JSON response.
+   * @throws RuntimeException If the response is null, or if there is an error parsing the JSON
+   *     response.
    */
   public AniListMangaStatistics getMangaFromList(int mangaId) {
     String query =
@@ -417,6 +416,7 @@ public AniListMangaStatistics getMangaFromList(int mangaId) {
 
   /**
    * Retrieves the user's score format from AniList.
+   *
    * @return The user's score format as an {@link AniListScoreFormat} enum value.
    */
   public AniListScoreFormat getScoreFormat() {
@@ -454,8 +454,8 @@ public AniListScoreFormat getScoreFormat() {
    * Retrieves the chapter count of the manga with the given AniList ID.
    *
    * @param mangaId The AniList ID of the manga to retrieve the chapter count for
-   * @return The chapter count of the manga as an {@link Optional} Integer. If the chapter count is not
-   * available, an empty {@link Optional} is returned.
+   * @return The chapter count of the manga as an {@link Optional} Integer. If the chapter count is
+   *     not available, an empty {@link Optional} is returned.
    */
   public Optional<Integer> getChapterCount(int mangaId) {
     String query =
@@ -496,7 +496,7 @@ public Optional<Integer> getChapterCount(int mangaId) {
    * Sends a GraphQL request to the AniList API with the given query and variables. Additionally,
    * the request is authenticated with the user's AniList token, so the user must be logged in.
    *
-   * @param query     The GraphQL query to send
+   * @param query The GraphQL query to send
    * @param variables The variables to send with the query
    * @return The response from the AniList API as a String, usually in JSON format
    */
@@ -517,7 +517,7 @@ private String sendAuthGraphQLRequest(String query, String variables) {
   /**
    * Updates the progress of the manga with the given AniList ID.
    *
-   * @param mangaId       The AniList ID of the manga to update
+   * @param mangaId The AniList ID of the manga to update
    * @param mangaProgress The new progress of the manga
    */
   public void updateMangaProgress(int mangaId, float mangaProgress) {
@@ -559,7 +559,7 @@ public void updateMangaProgress(int mangaId, float mangaProgress) {
    * Updates the status of the manga with the given AniList ID.
    *
    * @param aniListId The AniList ID of the manga to update
-   * @param value     The new status of the manga as an {@link AniListStatus} enum value
+   * @param value The new status of the manga as an {@link AniListStatus} enum value
    */
   public void updateMangaStatus(int aniListId, AniListStatus value) {
     String query =
@@ -600,7 +600,7 @@ public void updateMangaStatus(int aniListId, AniListStatus value) {
    * Updates the score of the manga with the given AniList ID.
    *
    * @param aniListId The AniList ID of the manga to update
-   * @param value     The new score of the manga. Range depends on the user's score format.
+   * @param value The new score of the manga. Range depends on the user's score format.
    */
   public void updateMangaScore(int aniListId, int value) {
 
@@ -642,7 +642,7 @@ public void updateMangaScore(int aniListId, int value) {
    * Updates the start date of the manga with the given AniList ID.
    *
    * @param aniListId The AniList ID of the manga to update
-   * @param date      The new start date of the manga as a {@link MediaDate} object
+   * @param date The new start date of the manga as a {@link MediaDate} object
    */
   public void updateMangaStartDate(int aniListId, MediaDate date) {
     String query =
@@ -691,7 +691,7 @@ public void updateMangaStartDate(int aniListId, MediaDate date) {
    * Updates the end date of the manga with the given AniList ID.
    *
    * @param aniListId The AniList ID of the manga to update
-   * @param date      The new end date of the manga as a {@link MediaDate} object
+   * @param date The new end date of the manga as a {@link MediaDate} object
    */
   public void updateMangaEndDate(int aniListId, MediaDate date) {
     String query =
@@ -740,7 +740,7 @@ public void updateMangaEndDate(int aniListId, MediaDate date) {
    * Retrieves the user's manga list.
    *
    * @return The manga list containing the user's reading, plan to read, completed, on hold, and
-   * dropped manga
+   *     dropped manga
    * @throws RuntimeException If an error occurs while retrieving the manga list
    */
   public MangaList getMangaList() {
@@ -809,8 +809,7 @@ public MangaList getMangaList() {
     for (int i = 0; i < listSize; i++) {
       var list = lists.getObject(i).getArray("entries");
 
-      var typeRef = new TypeReference<List<AniListMedia>>() {
-      };
+      var typeRef = new TypeReference<List<AniListMedia>>() {};
       try {
         for (int j = 0; j < list.length(); j++) {
           replaceMediaWithImageAndTitle(list, j);
@@ -845,7 +844,7 @@ public MangaList getMangaList() {
    * Replaces the "media" object in a JsonArray with "coverImage" and "title" objects.
    *
    * @param list The JsonArray containing the media object to be replaced
-   * @param j    The index of the media object within the JsonArray
+   * @param j The index of the media object within the JsonArray
    */
   private void replaceMediaWithImageAndTitle(JsonArray list, int j) {
     var media = list.getObject(j).getObject("media");
@@ -876,8 +875,8 @@ private JsonArray getListsFromResponse(String response) {
    * Updates the privacy status of the manga with the given AniList ID.
    *
    * @param aniListId The AniList ID of the manga to update
-   * @param isPrivate The new privacy status of the manga. {@code true} if the manga is private, {@code false}
-   *                  otherwise
+   * @param isPrivate The new privacy status of the manga. {@code true} if the manga is private,
+   *     {@code false} otherwise
    */
   public void updateMangaPrivacyStatus(int aniListId, boolean isPrivate) {
     // language=graphql
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
index 81e86e83..91bf8422 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/MyAnimeListAPIService.java
@@ -49,13 +49,12 @@ public class MyAnimeListAPIService {
   private final TrackingDataService tds;
   private final WebClient webClient;
   private final Cache<UUID, String> pkceCache;
-  @Nullable
-  private MyAnimeList mal;
+  @Nullable private MyAnimeList mal;
 
   /**
    * Initializes an instance of the MyAnimeListAPIService class.
    *
-   * @param tds       The {@link TrackingDataService} used for storing tokens.
+   * @param tds The {@link TrackingDataService} used for storing tokens.
    * @param webClient The {@link WebClient} used for making requests to the MAL API.
    */
   public MyAnimeListAPIService(TrackingDataService tds, WebClient webClient) {
@@ -80,8 +79,8 @@ public MyAnimeListAPIService(TrackingDataService tds, WebClient webClient) {
   }
 
   /**
-   * Authenticates the MAL API with the provided {@link OAuthData} object containing the access token.
-   * The resulting {@link MyAnimeList} object is stored in {@link #mal}
+   * Authenticates the MAL API with the provided {@link OAuthData} object containing the access
+   * token. The resulting {@link MyAnimeList} object is stored in {@link #mal}
    *
    * @param data The {@link OAuthData} object containing the access token.
    */
@@ -128,7 +127,7 @@ public boolean hasMalToken() {
    * Exchanges the authorization code for an access and refresh token. Verifies the PKCE ID before
    * exchanging the code for tokens.
    *
-   * @param code   The authorization code to exchange for tokens.
+   * @param code The authorization code to exchange for tokens.
    * @param pkceId The PKCE ID used for generating the code challenge.
    */
   public void exchangeCodeForTokens(String code, String pkceId) {
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
index 33ed1e37..63aeddf3 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/services/tracker/SuwayomiTrackingService.java
@@ -28,7 +28,7 @@ public class SuwayomiTrackingService {
    * Represents a Suwayomi Tracking Service.
    *
    * @param client the {@link SuwayomiTrackingClient} used for handling tracking requests to the
-   *               Suwayomi Server.
+   *     Suwayomi Server.
    */
   public SuwayomiTrackingService(SuwayomiTrackingClient client) {
     this.client = client;
@@ -101,7 +101,7 @@ public List<TrackerSearchResult> searchMAL(String query) {
   /**
    * Tracks a manga on AniList using the provided manga ID and external ID.
    *
-   * @param mangaId    the ID of the manga to be tracked
+   * @param mangaId the ID of the manga to be tracked
    * @param externalId the external ID of the manga on AniList
    */
   public void trackOnAniList(int mangaId, int externalId) {
@@ -112,7 +112,7 @@ public void trackOnAniList(int mangaId, int externalId) {
   /**
    * Tracks a manga on MyAnimeList (MAL) using the provided manga ID and external ID.
    *
-   * @param mangaId    the ID of the manga to be tracked
+   * @param mangaId the ID of the manga to be tracked
    * @param externalId the external ID of the manga on MAL
    */
   public void trackOnMAL(int mangaId, int externalId) {
@@ -123,7 +123,7 @@ public void trackOnMAL(int mangaId, int externalId) {
   /**
    * Logs in to the Suwayomi tracker with the specified URL and tracker ID.
    *
-   * @param url       the URL used for the login callback
+   * @param url the URL used for the login callback
    * @param trackerId the ID of the tracker to log in to
    */
   public void loginSuwayomi(String url, int trackerId) {
@@ -163,9 +163,7 @@ private String getStateAuthParam(int id) {
     return template.formatted(json);
   }
 
-  /**
-   * An enumeration representing different types of trackers.
-   */
+  /** An enumeration representing different types of trackers. */
   @Getter
   private enum TrackerType {
     MAL(1),
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
index 76e78317..f57c095b 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/SearchView.java
@@ -69,8 +69,8 @@ public class SearchView extends StandardLayout implements HasUrlParameter<String
   /**
    * Constructs a SearchView object.
    *
-   * @param sourceService   the {@link SourceService} used for retrieving manga sources
-   * @param searchService   the {@link SearchService} used for performing search operations
+   * @param sourceService the {@link SourceService} used for retrieving manga sources
+   * @param searchService the {@link SearchService} used for performing search operations
    * @param settingsService the {@link SettingsService} used for accessing search settings
    */
   public SearchView(
@@ -108,8 +108,7 @@ public SearchView(
   }
 
   /**
-   * Retrieves the "Import from MAL" button. This button is used to navigate to the
-   * {@link MALView}.
+   * Retrieves the "Import from MAL" button. This button is used to navigate to the {@link MALView}.
    *
    * @return the button that navigates to the {@link MALView}
    */
@@ -131,8 +130,8 @@ private Button getMalImportBtn() {
   }
 
   /**
-   * Retrieves the "Import from AniList" button. This button is used to navigate to the
-   * {@link AniListView}.
+   * Retrieves the "Import from AniList" button. This button is used to navigate to the {@link
+   * AniListView}.
    *
    * @return The button that navigates to the {@link AniListView}
    */
@@ -268,7 +267,7 @@ public void search(String query) {
   /**
    * Adds a search result to the user interface.
    *
-   * @param source    the source of the search result
+   * @param source the source of the search result
    * @param mangaList the list of manga from the search result
    * @return true if the search result was successfully added, otherwise false
    */
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
index c3eb13ca..ccb583b1 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
@@ -13,9 +13,7 @@
 import java.util.List;
 import online.hatsunemiku.tachideskvaadinui.component.card.Card;
 
-/**
- * TrackingLayout is a layout/base for displaying tracking information to import.
- */
+/** TrackingLayout is a layout/base for displaying tracking information to import. */
 @CssImport("./css/views/imports/importCommons.css")
 public abstract class TrackingLayout extends StandardLayout {
 
@@ -31,9 +29,9 @@ protected TrackingLayout(String title) {
   }
 
   /**
-   * Initializes the tracking layout based on the availability of a token.
-   * If a token is available, it creates and adds the necessary sections to the layout.
-   * If a token is not available, it adds an authentication button to the layout.
+   * Initializes the tracking layout based on the availability of a token. If a token is available,
+   * it creates and adds the necessary sections to the layout. If a token is not available, it adds
+   * an authentication button to the layout.
    */
   protected void init() {
     if (!hasToken()) {
@@ -48,7 +46,7 @@ protected void init() {
       return;
     }
 
-    //TODO style auth button
+    // TODO style auth button
 
     var reading = getReadingSection();
     var planToRead = getPlanToReadSection();
@@ -83,7 +81,6 @@ protected void init() {
    *
    * @return the `Reading` section as a Div element
    */
-
   public abstract Div getReadingSection();
 
   /**
@@ -92,7 +89,6 @@ protected void init() {
    *
    * @return the `Plan to Read` section as a Div element
    */
-
   public abstract Div getPlanToReadSection();
 
   /**
@@ -122,7 +118,7 @@ protected void init() {
   /**
    * Generates a content section containing a title and a list of cards.
    *
-   * @param title   the title of the content section
+   * @param title the title of the content section
    * @param content the list of cards to be added to the content section
    * @return a Div element representing the content section
    */
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
index 9b1a1ab2..864e612f 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/AniListView.java
@@ -95,7 +95,8 @@ public Div getDroppedSection() {
   }
 
   /**
-   * Returns a list of {@link AniListMediaCard} objects based on the provided list of {@link AniListMedia} objects.
+   * Returns a list of {@link AniListMediaCard} objects based on the provided list of {@link
+   * AniListMedia} objects.
    *
    * @param media the list of {@link AniListMedia} objects to convert to cards
    * @return a list of {@link AniListMediaCard} objects
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
index aa187dbb..dd12c90f 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/trackers/MALView.java
@@ -102,7 +102,8 @@ public Div getDroppedSection() {
   }
 
   /**
-   * Retrieves a list of {@link MalMediaCard} objects based on the given list of {@link Manga} objects.
+   * Retrieves a list of {@link MalMediaCard} objects based on the given list of {@link Manga}
+   * objects.
    *
    * @param media the list of {@link Manga} objects from which to create the cards.
    * @return a list of {@link MalMediaCard} objects.

From 96e3c8b09988fbba6528df8043fc30e3c49c488d Mon Sep 17 00:00:00 2001
From: Alessandro Schwaiger <aless2003@gmx.at>
Date: Mon, 8 Apr 2024 21:41:27 +0200
Subject: [PATCH 16/17] Make sure the Authentication button is in the center of
 the screen.

---
 frontend/css/views/imports/importCommons.css              | 8 ++++++++
 .../tachideskvaadinui/view/layout/TrackingLayout.java     | 4 +---
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/frontend/css/views/imports/importCommons.css b/frontend/css/views/imports/importCommons.css
index 02cbbdf4..d238cbfe 100644
--- a/frontend/css/views/imports/importCommons.css
+++ b/frontend/css/views/imports/importCommons.css
@@ -22,4 +22,12 @@
   display: grid;
   grid-template-columns: repeat(5, minmax(200px, 1fr));
   grid-gap: 1rem;
+}
+
+.import-button-container {
+  display: flex;
+  /*grow horizontally*/
+  width: 100%;
+  justify-content: center;
+  margin-top: 1rem;
 }
\ No newline at end of file
diff --git a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
index ccb583b1..0efb85a0 100644
--- a/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
+++ b/src/main/java/online/hatsunemiku/tachideskvaadinui/view/layout/TrackingLayout.java
@@ -36,7 +36,7 @@ protected TrackingLayout(String title) {
   protected void init() {
     if (!hasToken()) {
       Div content = new Div();
-      content.addClassName("button-container");
+      content.addClassName("import-button-container");
 
       Button authBtn = new Button("Authenticate");
       authBtn.addClickListener(e -> authenticate());
@@ -46,8 +46,6 @@ protected void init() {
       return;
     }
 
-    // TODO style auth button
-
     var reading = getReadingSection();
     var planToRead = getPlanToReadSection();
     var completed = getCompletedSection();

From c23b18677a5c632ca3793b111cf374f52add79e4 Mon Sep 17 00:00:00 2001
From: Alessandro Schwaiger <aless2003@gmx.at>
Date: Mon, 8 Apr 2024 21:44:40 +0200
Subject: [PATCH 17/17] Bump Version

---
 build.gradle | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/build.gradle b/build.gradle
index 45990ca2..f8364352 100644
--- a/build.gradle
+++ b/build.gradle
@@ -16,7 +16,7 @@ plugins {
 }
 
 group = 'online.hatsunemiku'
-version = '1.5.0'
+version = '1.6.0'
 sourceCompatibility = JavaVersion.VERSION_17
 targetCompatibility = JavaVersion.VERSION_17