feat(singer): add CRUD endpoints for singers

apps/backend/src/handlers/catalog/singer/create.ts

@@ -0,0 +1,32 @@
+import { Elysia } from "elysia";
+import {
+	CreateSingerRequestSchema,
+	ErrorResponseSchema,
+	SingerResponseSchema,
+	singerService,
+} from "@cvsa/core";
+import { authMiddleware } from "@/middlewares";
+import { traceTask } from "@/common/trace";
+
+export const singerCreateHandler = new Elysia({ name: "singerCreateHandler" })
+	.use(authMiddleware)
+	.post(
+		"/singer",
+		async ({ body, status }) => {
+			const singer = await traceTask("singerService.create", async () => {
+				return await singerService.create(body);
+			});
+			return status(201, singer);
+		},
+		{
+			body: CreateSingerRequestSchema,
+			detail: {
+				summary: "Create Singer",
+				description: "Create a new singer entry in the catalog. Requires authentication.",
+			},
+			response: {
+				201: SingerResponseSchema,
+				401: ErrorResponseSchema,
+			},
+		}
+	);

apps/backend/src/handlers/catalog/singer/delete.ts

@@ -0,0 +1,34 @@
+import { Elysia } from "elysia";
+import { z } from "zod";
+import { ErrorResponseSchema, singerService } from "@cvsa/core";
+import { authMiddleware } from "@/middlewares";
+import { traceTask } from "@/common/trace";
+
+export const singerDeleteHandler = new Elysia({ name: "singerDeleteHandler" })
+	.use(authMiddleware)
+	.delete(
+		"/singer/:id",
+		async ({ params, set }) => {
+			await traceTask("singerService.delete", async () => {
+				return await singerService.delete(params.id);
+			});
+			set.status = 204;
+			return null;
+		},
+		{
+			params: z.object({
+				id: z.coerce.number().int().positive(),
+			}),
+			detail: {
+				summary: "Delete Singer",
+				description:
+					"Soft delete a singer from the catalog. Requires authentication. The singer record is marked as deleted but retained in the database for data integrity.",
+			},
+			response: {
+				204: z.null(),
+				400: ErrorResponseSchema,
+				401: ErrorResponseSchema,
+				404: ErrorResponseSchema,
+			},
+		}
+	);

apps/backend/src/handlers/catalog/singer/get.ts

@@ -0,0 +1,29 @@
+import { Elysia } from "elysia";
+import { ErrorResponseSchema, SingerDetailsResponseSchema, singerService } from "@cvsa/core";
+import z from "zod";
+import { traceTask } from "@/common/trace";
+
+export const singerGetHandler = new Elysia().get(
+	"/singer/:id",
+	async ({ params, status }) => {
+		const singer = await traceTask("singerService.getDetails", async () => {
+			return await singerService.getDetails(params.id);
+		});
+		return status(200, singer);
+	},
+	{
+		detail: {
+			summary: "Get Singer",
+			description:
+				"Retrieve detailed information about a specific singer by its ID. Includes name, description, language, and metadata.",
+		},
+		response: {
+			200: SingerDetailsResponseSchema,
+			400: ErrorResponseSchema,
+			404: ErrorResponseSchema,
+		},
+		params: z.object({
+			id: z.coerce.number().int().positive(),
+		}),
+	}
+);

apps/backend/src/handlers/catalog/singer/index.ts

@@ -0,0 +1,13 @@
+import { Elysia } from "elysia";
+import { singerCreateHandler } from "./create";
+import { singerUpdateHandler } from "./update";
+import { singerDeleteHandler } from "./delete";
+import { singerGetHandler } from "./get";
+import { singerSearchHandler } from "./search";
+
+export const singerHandler = new Elysia({ name: "singerHandler" })
+	.use(singerGetHandler)
+	.use(singerCreateHandler)
+	.use(singerUpdateHandler)
+	.use(singerDeleteHandler)
+	.use(singerSearchHandler);

apps/backend/src/handlers/catalog/singer/search.ts

@@ -0,0 +1,25 @@
+import { Elysia } from "elysia";
+import { singerSearchService } from "@cvsa/core";
+import z from "zod";
+import { traceTask } from "@/common/trace";
+
+// TODO: add corresponding DTO and response schema
+export const singerSearchHandler = new Elysia().get(
+	"/singers",
+	async ({ query, status }) => {
+		const song = await traceTask("singerSearchService.search", async () => {
+			return await singerSearchService.search(query.q || "");
+		});
+		return status(200, song);
+	},
+	{
+		detail: {
+			summary: "Search for Singers",
+			description:
+				"Full-text search across singer names, and descriptions. Returns a list of matching signers ordered by relevance.",
+		},
+		query: z.object({
+			q: z.string().optional(),
+		}),
+	}
+);

apps/backend/src/handlers/catalog/singer/update.ts

@@ -0,0 +1,39 @@
+import { Elysia } from "elysia";
+import { z } from "zod";
+import {
+	UpdateSingerRequestSchema,
+	ErrorResponseSchema,
+	singerService,
+	SingerResponseSchema,
+} from "@cvsa/core";
+import { authMiddleware } from "@/middlewares";
+import { traceTask } from "@/common/trace";
+
+export const singerUpdateHandler = new Elysia({ name: "singerUpdateHandler" })
+	.use(authMiddleware)
+	.patch(
+		"/singer/:id",
+		async ({ params, body, status }) => {
+			const singer = await traceTask("singerService.update", async () => {
+				return await singerService.update(params.id, body);
+			});
+			return status(200, singer);
+		},
+		{
+			body: UpdateSingerRequestSchema,
+			params: z.object({
+				id: z.coerce.number().int().positive(),
+			}),
+			detail: {
+				summary: "Update Singer",
+				description:
+					"Update metadata of an existing singer identified by its ID. Requires authentication.",
+			},
+			response: {
+				200: SingerResponseSchema,
+				400: ErrorResponseSchema,
+				401: ErrorResponseSchema,
+				404: ErrorResponseSchema,
+			},
+		}
+	);

apps/backend/src/handlers/index.ts

@@ -2,4 +2,5 @@ export * from "./auth";
 export * from "./catalog/song";
 export * from "./catalog/engine";
 export * from "./catalog/artist";
+export * from "./catalog/singer";
 export * from "./dev";

apps/backend/src/index.ts

@@ -2,7 +2,13 @@ import { Elysia } from "elysia";
 import { onAfterHandler } from "./onAfterHandle";
 import { getBindingInfo, logStartup } from "./startMessage";
 import pkg from "../package.json";
-import { authHandler, songHandler, engineHandler, artistHandler } from "@handlers/index";
+import {
+	authHandler,
+	songHandler,
+	engineHandler,
+	artistHandler,
+	singerHandler,
+} from "@handlers/index";
 import { errorHandler } from "./errorHandler";
 import { openapi } from "@elysiajs/openapi";
 import { requestLoggerMiddleware } from "@/middlewares";
@@ -58,6 +64,7 @@ export const app = new Elysia({
 	.use(songHandler)
 	.use(engineHandler)
 	.use(artistHandler)
+	.use(singerHandler)
 	.use(devHandler)
 	.listen(16412);