docs(openapi): add descriptions to OpenAPI specification (#25185)

* faces * add openapi descriptions * remove dto descriptions * gen openapi * dtos * fix dtos * fix more * fix build * more * complete dtos * descriptions on rebase * gen rebase * revert correct integer type conversion * gen after revert * revert correct nullables * regen after revert * actually incorrect adding default here * revert correct number type conversion * regen after revert * revert nullable usage * regen fully * readd some comments * one more * one more * use enum * add missing * add missing controllers * add missing dtos * complete it * more * describe global key and slug * add remaining body and param descriptions * lint and format * cleanup * response and schema descriptions * test patch according to suggestion * revert added api response objects * revert added api body objects * revert added api param object * revert added api query objects * revert reorganized http code objects * revert reorganize ApiOkResponse objects * revert added api response objects (2) * revert added api tag object * revert added api schema objects * migrate missing asset.dto.ts * regenerate openapi builds * delete generated mustache files * remove descriptions from properties that are schemas * lint * revert nullable type changes * revert int/num type changes * remove explicit default * readd comment * lint * pr fixes * last bits and pieces * lint and format * chore: remove rejected patches * fix: deleting asset from asset-viewer on search results (#25596) * fix: escape handling in search asset viewer (#25621) * fix: correctly show owner in album options modal (#25618) * fix: validation issues * fix: validation issues --------- Co-authored-by: Jason Rasmussen <jason@rasm.me> Co-authored-by: Min Idzelis <min123@gmail.com> Co-authored-by: Daniel Dietzler <36593685+danieldietzler@users.noreply.github.com> Co-authored-by: Paul Makles <me@insrt.uk>
2026-02-11 19:38:54 +03:00 · 2026-01-29 14:49:15 +01:00
parent eadb2f89af
commit 8db61d341f
377 changed files with 5554 additions and 735 deletions
--- a/server/src/controllers/maintenance.controller.spec.ts
+++ b/server/src/controllers/maintenance.controller.spec.ts
@@ -0,0 +1,39 @@
+import { MaintenanceController } from 'src/controllers/maintenance.controller';
+import { MaintenanceAction } from 'src/enum';
+import { MaintenanceService } from 'src/services/maintenance.service';
+import request from 'supertest';
+import { errorDto } from 'test/medium/responses';
+import { ControllerContext, controllerSetup, mockBaseService } from 'test/utils';
+
+describe(MaintenanceController.name, () => {
+  let ctx: ControllerContext;
+  const service = mockBaseService(MaintenanceService);
+
+  beforeAll(async () => {
+    ctx = await controllerSetup(MaintenanceController, [{ provide: MaintenanceService, useValue: service }]);
+    return () => ctx.close();
+  });
+
+  beforeEach(() => {
+    service.resetAllMocks();
+    ctx.reset();
+  });
+
+  describe('POST /admin/maintenance', () => {
+    it('should be an authenticated route', async () => {
+      await request(ctx.getHttpServer()).post('/admin/maintenance').send();
+      expect(ctx.authenticate).toHaveBeenCalled();
+    });
+
+    it('should require a backup file when action is restore', async () => {
+      const { status, body } = await request(ctx.getHttpServer()).post('/admin/maintenance').send({
+        action: MaintenanceAction.RestoreDatabase,
+      });
+      expect(status).toBe(400);
+      expect(body).toEqual(
+        errorDto.badRequest(['restoreBackupFilename must be a string', 'restoreBackupFilename should not be empty']),
+      );
+      expect(ctx.authenticate).toHaveBeenCalled();
+    });
+  });
+});