server/packages/api/routes/api/v1/notifications/[id]/index.ts

import {
    Notification as NotificationSchema,
    RolePermission,
} from "@versia/client/schemas";
import { ApiError } from "@versia/kit";
import { Notification } from "@versia/kit/db";
import { describeRoute } from "hono-openapi";
import { resolver, validator } from "hono-openapi/zod";
import { z } from "zod";
import { apiRoute, auth, handleZodError } from "@/api";

export default apiRoute((app) =>
    app.get(
        "/api/v1/notifications/:id",
        describeRoute({
            summary: "Get a single notification",
            description:
                "View information about a notification with a given ID.",
            externalDocs: {
                url: "https://docs.joinmastodon.org/methods/notifications/#get",
            },
            tags: ["Notifications"],
            responses: {
                200: {
                    description: "A single Notification",
                    content: {
                        "application/json": {
                            schema: resolver(NotificationSchema),
                        },
                    },
                },
                404: ApiError.notificationNotFound().schema,
                401: ApiError.missingAuthentication().schema,
            },
        }),
        auth({
            auth: true,
            permissions: [RolePermission.ManageOwnNotifications],
            scopes: ["read:notifications"],
        }),
        validator(
            "param",
            z.object({
                id: NotificationSchema.shape.id,
            }),
            handleZodError,
        ),
        async (context) => {
            const { id } = context.req.valid("param");

            const { user } = context.get("auth");

            const notification = await Notification.fromId(id, user.id);

            if (!notification || notification.data.notifiedId !== user.id) {
                throw ApiError.notificationNotFound();
            }

            return context.json(await notification.toApi(), 200);
        },
    ),
);