feat: add song search functionality with pagination and sorting, update API routes for Swagger documentation

Author: tomast1337

apps/backend/src/main.ts

@@ -10,7 +10,7 @@ const logger: Logger = new Logger('main.ts');
 
 async function bootstrap() {
   const app = await NestFactory.create(AppModule);
-  app.setGlobalPrefix('api/v1');
+  app.setGlobalPrefix('v1');
 
   const parseTokenPipe = app.get<ParseTokenPipe>(ParseTokenPipe);
 
@@ -56,7 +56,7 @@ bootstrap()
     logger.warn(`Application is running on: http://localhost:${port}`);
 
     if (process.env.NODE_ENV === 'development') {
-      logger.warn(`Swagger is running on: http://localhost:${port}/api/doc`);
+      logger.warn(`Swagger is running on: http://localhost:${port}/docs`);
     }
   })
   .catch((error) => {

apps/backend/src/song/song.controller.ts

@@ -76,6 +76,17 @@ export class SongController {
     return await this.songService.getSongByPage(query);
   }
 
+  @Get('/search')
+  @ApiOperation({
+    summary: 'Search songs by keywords with pagination and sorting',
+  })
+  public async searchSongs(
+    @Query() query: PageQueryDTO,
+    @Query('q') q: string,
+  ): Promise<SongPreviewDto[]> {
+    return await this.songService.searchSongs(query, q ?? '');
+  }
+
   @Get('/:id')
   @ApiOperation({ summary: 'Get song info by ID' })
   public async getSong(

apps/backend/src/song/song.service.ts

@@ -202,6 +202,48 @@ export class SongService {
       })
       .skip(page * limit - limit)
       .limit(limit)
+      .populate('uploader', 'username publicName profileImage -_id')
+      .exec()) as unknown as SongWithUser[];
+
+    return songs.map((song) => SongPreviewDto.fromSongDocumentWithUser(song));
+  }
+
+  public async searchSongs(
+    query: PageQueryDTO,
+    q: string,
+  ): Promise<SongPreviewDto[]> {
+    const page = parseInt(query.page?.toString() ?? '1');
+    const limit = parseInt(query.limit?.toString() ?? '10');
+    const order = query.order ? query.order : false;
+    const allowedSorts = new Set(['likeCount', 'createdAt', 'playCount']);
+    const sortField = allowedSorts.has(query.sort ?? '')
+      ? (query.sort as string)
+      : 'createdAt';
+
+    const terms = (q || '')
+      .split(/\s+/)
+      .map((t) => t.trim())
+      .filter((t) => t.length > 0);
+
+    // Build Google-like search: all words must appear across any of the fields
+    const andClauses = terms.map((word) => ({
+      $or: [
+        { title: { $regex: word, $options: 'i' } },
+        { originalAuthor: { $regex: word, $options: 'i' } },
+        { description: { $regex: word, $options: 'i' } },
+      ],
+    }));
+
+    const mongoQuery: any = {
+      visibility: 'public',
+      ...(andClauses.length > 0 ? { $and: andClauses } : {}),
+    };
+
+    const songs = (await this.songModel
+      .find(mongoQuery)
+      .sort({ [sortField]: order ? 1 : -1 })
+      .skip(limit * (page - 1))
+      .limit(limit)
       .populate('uploader', 'username profileImage -_id')
       .exec()) as unknown as SongWithUser[];
 

packages/database/src/song/dto/SongView.dto.ts

@@ -14,6 +14,7 @@ import type { CategoryType, LicenseType, VisibilityType } from './types';
 
 export type SongViewUploader = {
   username: string;
+  publicName: string;
   profileImage: string;
 };