feat: endpoint versioning (#23858)

server/src/controllers/job.controller.ts

@@ -1,5 +1,6 @@
 import { Body, Controller, Get, HttpCode, HttpStatus, Param, Post, Put } from '@nestjs/common';
-import { ApiOperation, ApiTags } from '@nestjs/swagger';
+import { ApiTags } from '@nestjs/swagger';
+import { Endpoint, HistoryBuilder } from 'src/decorators';
 import { AllJobStatusResponseDto, JobCommandDto, JobCreateDto, JobIdParamDto, JobStatusDto } from 'src/dtos/job.dto';
 import { ApiTag, Permission } from 'src/enum';
 import { Authenticated } from 'src/middleware/auth.guard';
@@ -12,9 +13,10 @@ export class JobController {
 
   @Get()
   @Authenticated({ permission: Permission.JobRead, admin: true })
-  @ApiOperation({
+  @Endpoint({
     summary: 'Retrieve queue counts and status',
     description: 'Retrieve the counts of the current queue, as well as the current status.',
+    history: new HistoryBuilder().added('v1').beta('v1').stable('v2'),
   })
   getAllJobsStatus(): Promise<AllJobStatusResponseDto> {
     return this.service.getAllJobsStatus();
@@ -23,10 +25,11 @@ export class JobController {
   @Post()
   @Authenticated({ permission: Permission.JobCreate, admin: true })
   @HttpCode(HttpStatus.NO_CONTENT)
-  @ApiOperation({
+  @Endpoint({
     summary: 'Create a manual job',
     description:
       'Run a specific job. Most jobs are queued automatically, but this endpoint allows for manual creation of a handful of jobs, including various cleanup tasks, as well as creating a new database backup.',
+    history: new HistoryBuilder().added('v1').beta('v1').stable('v2'),
   })
   createJob(@Body() dto: JobCreateDto): Promise<void> {
     return this.service.create(dto);
@@ -34,10 +37,11 @@ export class JobController {
 
   @Put(':id')
   @Authenticated({ permission: Permission.JobCreate, admin: true })
-  @ApiOperation({
+  @Endpoint({
     summary: 'Run jobs',
     description:
       'Queue all assets for a specific job type. Defaults to only queueing assets that have not yet been processed, but the force command can be used to re-process all assets.',
+    history: new HistoryBuilder().added('v1').beta('v1').stable('v2'),
   })
   sendJobCommand(@Param() { id }: JobIdParamDto, @Body() dto: JobCommandDto): Promise<JobStatusDto> {
     return this.service.handleCommand(id, dto);