feat(artist): add CRUD endpoints for artists

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

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

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

@@ -0,0 +1,34 @@
+import { Elysia } from "elysia";
+import { z } from "zod";
+import { ErrorResponseSchema, artistService } from "@cvsa/core";
+import { authMiddleware } from "@/middlewares";
+import { traceTask } from "@/common/trace";
+
+export const artistDeleteHandler = new Elysia({ name: "artistDeleteHandler" })
+	.use(authMiddleware)
+	.delete(
+		"/artist/:id",
+		async ({ params, set }) => {
+			await traceTask("artistService.delete", async () => {
+				return await artistService.delete(params.id);
+			});
+			set.status = 204;
+			return null;
+		},
+		{
+			params: z.object({
+				id: z.coerce.number().int().positive(),
+			}),
+			detail: {
+				summary: "Delete Artist",
+				description:
+					"Soft delete an artist from the catalog. Requires authentication. The artist 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/artist/get.ts

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

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

@@ -0,0 +1,11 @@
+import { Elysia } from "elysia";
+import { artistCreateHandler } from "./create";
+import { artistUpdateHandler } from "./update";
+import { artistDeleteHandler } from "./delete";
+import { artistDetailsHandler } from "./get";
+
+export const artistHandler = new Elysia({ name: "artistHandler" })
+	.use(artistDetailsHandler)
+	.use(artistCreateHandler)
+	.use(artistUpdateHandler)
+	.use(artistDeleteHandler);

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

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

apps/backend/src/handlers/index.ts

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

apps/backend/src/index.ts

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