chore: frontend testing setup (#1739)

* add vitest

* initialize lib w/ tests

* move to dev dep

* run tests in CI

* update file names

* move api folder to lib

* move api and api types to same folder

* update generator outpath

* rm husky

* i guess i _did_ need those types

* reorg types

* extract validators into testable components

* (WIP) start composable testing

* fix import type

* fix linter complaint

* simplify icon type def

* fix linter errors (maybe?)

* rename client file for sorting

frontend/lib/api/admin/admin-about.ts

@@ -0,0 +1,34 @@
+import { BaseAPI } from "../base/base-clients";
+import { AdminAboutInfo, DockerVolumeText, CheckAppConfig } from "~/lib/api/types/admin";
+
+const prefix = "/api";
+
+const routes = {
+  about: `${prefix}/admin/about`,
+  aboutStatistics: `${prefix}/admin/about/statistics`,
+  check: `${prefix}/admin/about/check`,
+  docker: `${prefix}/admin/about/docker/validate`,
+  validationFile: `${prefix}/media/docker/validate.txt`,
+};
+
+export class AdminAboutAPI extends BaseAPI {
+  async about() {
+    return await this.requests.get<AdminAboutInfo>(routes.about);
+  }
+
+  async statistics() {
+    return await this.requests.get(routes.aboutStatistics);
+  }
+
+  async checkApp() {
+    return await this.requests.get<CheckAppConfig>(routes.check);
+  }
+
+  async checkDocker() {
+    return await this.requests.get<DockerVolumeText>(routes.docker);
+  }
+
+  async getDockerValidateFileContents() {
+    return await this.requests.get<string>(routes.validationFile);
+  }
+}

frontend/lib/api/admin/admin-analytics.ts

@@ -0,0 +1,14 @@
+import { BaseAPI } from "../base/base-clients";
+import { MealieAnalytics } from "~/lib/api/types/analytics";
+
+const prefix = "/api";
+
+const routes = {
+  base: `${prefix}/admin/analytics`,
+};
+
+export class AdminAnalyticsApi extends BaseAPI {
+  async getAnalytics() {
+    return await this.requests.get<MealieAnalytics>(routes.base);
+  }
+}

frontend/lib/api/admin/admin-backups.ts

@@ -0,0 +1,33 @@
+import { BaseAPI } from "../base/base-clients";
+import { AllBackups } from "~/lib/api/types/admin";
+import { ErrorResponse, FileTokenResponse, SuccessResponse } from "~/lib/api/types/response";
+
+const prefix = "/api";
+
+const routes = {
+  base: `${prefix}/admin/backups`,
+  item: (name: string) => `${prefix}/admin/backups/${name}`,
+  restore: (name: string) => `${prefix}/admin/backups/${name}/restore`,
+};
+
+export class AdminBackupsApi extends BaseAPI {
+  async getAll() {
+    return await this.requests.get<AllBackups>(routes.base);
+  }
+
+  async create() {
+    return await this.requests.post<SuccessResponse | ErrorResponse>(routes.base, {});
+  }
+
+  async get(fileName: string) {
+    return await this.requests.get<FileTokenResponse>(routes.item(fileName));
+  }
+
+  async delete(fileName: string) {
+    return await this.requests.delete<SuccessResponse | ErrorResponse>(routes.item(fileName));
+  }
+
+  async restore(fileName: string) {
+    return await this.requests.post<SuccessResponse | ErrorResponse>(routes.restore(fileName), {});
+  }
+}

frontend/lib/api/admin/admin-groups.ts

@@ -0,0 +1,19 @@
+import { BaseCRUDAPI } from "../base/base-clients";
+import { GroupBase, GroupInDB } from "~/lib/api/types/user";
+import { GroupAdminUpdate } from "~/lib/api/types/group";
+const prefix = "/api";
+
+const routes = {
+  adminUsers: `${prefix}/admin/groups`,
+  adminUsersId: (id: string) => `${prefix}/admin/groups/${id}`,
+};
+
+export class AdminGroupsApi extends BaseCRUDAPI<GroupBase, GroupInDB, GroupAdminUpdate> {
+  baseRoute: string = routes.adminUsers;
+  itemRoute = routes.adminUsersId;
+
+  async updateOne(id: string, payload: GroupAdminUpdate) {
+    // TODO: This should probably be a patch request, which isn't offered by the API currently
+    return await this.requests.put<GroupInDB, GroupAdminUpdate>(this.itemRoute(id), payload);
+  }
+}

frontend/lib/api/admin/admin-maintenance.ts

@@ -0,0 +1,45 @@
+import { BaseAPI } from "../base/base-clients";
+import { SuccessResponse } from "~/lib/api/types/response";
+import { MaintenanceLogs, MaintenanceStorageDetails, MaintenanceSummary } from "~/lib/api/types/admin";
+
+const prefix = "/api";
+
+const routes = {
+  base: `${prefix}/admin/maintenance`,
+  storage: `${prefix}/admin/maintenance/storage`,
+  logs: (lines: number) => `${prefix}/admin/maintenance/logs?lines=${lines}`,
+  cleanTemp: `${prefix}/admin/maintenance/clean/temp`,
+  cleanImages: `${prefix}/admin/maintenance/clean/images`,
+  cleanRecipeFolders: `${prefix}/admin/maintenance/clean/recipe-folders`,
+  cleanLogFile: `${prefix}/admin/maintenance/clean/logs`,
+};
+
+export class AdminMaintenanceApi extends BaseAPI {
+  async getInfo() {
+    return this.requests.get<MaintenanceSummary>(routes.base);
+  }
+
+  async getStorageDetails() {
+    return await this.requests.get<MaintenanceStorageDetails>(routes.storage);
+  }
+
+  async cleanTemp() {
+    return await this.requests.post<SuccessResponse>(routes.cleanTemp, {});
+  }
+
+  async cleanImages() {
+    return await this.requests.post<SuccessResponse>(routes.cleanImages, {});
+  }
+
+  async cleanRecipeFolders() {
+    return await this.requests.post<SuccessResponse>(routes.cleanRecipeFolders, {});
+  }
+
+  async cleanLogFile() {
+    return await this.requests.post<SuccessResponse>(routes.cleanLogFile, {});
+  }
+
+  async logs(lines: number) {
+    return await this.requests.get<MaintenanceLogs>(routes.logs(lines));
+  }
+}

frontend/lib/api/admin/admin-tasks.ts

@@ -0,0 +1,18 @@
+import { BaseAPI } from "../base/base-clients";
+import { ServerTask } from "~/lib/api/types/server";
+
+const prefix = "/api";
+
+const routes = {
+  base: `${prefix}/admin/server-tasks`,
+};
+
+export class AdminTaskAPI extends BaseAPI {
+  async testTask() {
+    return await this.requests.post<ServerTask>(`${routes.base}`, {});
+  }
+
+  async getAll() {
+    return await this.requests.get<ServerTask[]>(routes.base);
+  }
+}

frontend/lib/api/admin/admin-users.ts

@@ -0,0 +1,19 @@
+import { BaseCRUDAPI } from "../base/base-clients";
+import { UnlockResults, UserIn, UserOut } from "~/lib/api/types/user";
+
+const prefix = "/api";
+
+const routes = {
+  adminUsers: `${prefix}/admin/users`,
+  adminUsersId: (tag: string) => `${prefix}/admin/users/${tag}`,
+  adminResetLockedUsers: (force: boolean) => `${prefix}/admin/users/unlock?force=${force ? "true" : "false"}`,
+};
+
+export class AdminUsersApi extends BaseCRUDAPI<UserIn, UserOut, UserOut> {
+  baseRoute: string = routes.adminUsers;
+  itemRoute = routes.adminUsersId;
+
+  async unlockAllUsers(force = false) {
+    return await this.requests.post<UnlockResults>(routes.adminResetLockedUsers(force), {});
+  }
+}