⭐ feat(www): Finish up on the onboarding (#210)

Merging this prematurely to make sure the team is on the same boat... like dang! We need to find a better way to do this. 

Plus it has become too big

packages/functions/src/api/account.ts

@@ -1,12 +1,13 @@
 import { z } from "zod";
 import { Hono } from "hono";
 import { notPublic } from "./auth";
-import { Result } from "../common";
-import { resolver } from "hono-openapi/zod";
 import { describeRoute } from "hono-openapi";
 import { User } from "@nestri/core/user/index";
 import { Team } from "@nestri/core/team/index";
 import { assertActor } from "@nestri/core/actor";
+import { Examples } from "@nestri/core/examples";
+import { ErrorResponses, Result } from "./common";
+import { ErrorCodes, VisibleError } from "@nestri/core/error";
 
 export module AccountApi {
     export const route = new Hono()
@@ -14,8 +15,8 @@ export module AccountApi {
         .get("/",
             describeRoute({
                 tags: ["Account"],
-                summary: "Retrieve the current user's details",
-                description: "Returns the user's account details, plus the teams they have joined",
+                summary: "Get user account",
+                description: "Get the current user's account details",
                 responses: {
                     200: {
                         content: {
@@ -24,35 +25,36 @@ export module AccountApi {
                                     z.object({
                                         ...User.Info.shape,
                                         teams: Team.Info.array(),
+                                    }).openapi({
+                                        description: "User account information",
+                                        example: { ...Examples.User, teams: [Examples.Team] }
                                     })
                                 ),
                             },
                         },
-                        description: "Successfully retrieved account details"
-                    },
-                    404: {
-                        content: {
-                            "application/json": {
-                                schema: resolver(z.object({ error: z.string() })),
-                            },
-                        },
-                        description: "This account does not exist",
+                        description: "User account details"
                     },
+                    404: ErrorResponses[404]
                 }
             }),
             async (c) => {
                 const actor = assertActor("user");
                 const [currentUser, teams] = await Promise.all([User.fromID(actor.properties.userID), User.teams()])
 
-                if (!currentUser) return c.json({ error: "This account does not exist; it may have been deleted" }, 404)
+                if (!currentUser)
+                    throw new VisibleError(
+                        "not_found",
+                        ErrorCodes.NotFound.RESOURCE_NOT_FOUND,
+                        "User not found",
+                    );
 
                 const { id, email, name, polarCustomerID, avatarUrl, discriminator } = currentUser
 
                 return c.json({
                     data: {
                         id,
-                        email,
                         name,
+                        email,
                         teams,
                         avatarUrl,
                         discriminator,