server/api/api/v1/profile/header.ts

import { apiRoute, auth } from "@/api";
import { Account } from "@versia/client/schemas";
import { RolePermission } from "@versia/client/schemas";
import { describeRoute } from "hono-openapi";
import { resolver } from "hono-openapi/zod";
import { ApiError } from "~/classes/errors/api-error";

export default apiRoute((app) =>
    app.delete(
        "/api/v1/profile/header",
        describeRoute({
            summary: "Delete profile header",
            description:
                "Deletes the header image associated with the user’s profile.",
            externalDocs: {
                url: "https://docs.joinmastodon.org/methods/profile/#delete-profile-header",
            },
            tags: ["Profiles"],
            responses: {
                200: {
                    description:
                        "The header was successfully deleted from the user’s profile. If there were no header associated with the profile, the response will still indicate a successful deletion.",
                    content: {
                        "application/json": {
                            schema: resolver(Account),
                        },
                    },
                },
                401: ApiError.missingAuthentication().schema,
                422: ApiError.validationFailed().schema,
            },
        }),
        auth({
            auth: true,
            permissions: [RolePermission.ManageOwnAccount],
            scopes: ["write:account"],
        }),
        async (context) => {
            const { user } = context.get("auth");

            await user.header?.delete();
            await user.reload();
            return context.json(user.toApi(true), 200);
        },
    ),
);