⭐ feat: Add Games (#276)

## Description
<!-- Briefly describe the purpose and scope of your changes -->


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- **New Features**
- Introduced comprehensive management of game libraries, including
adding, removing, and listing games in a user's Steam library.
- Added new API endpoints for retrieving detailed game information by ID
and listing all games in a user's library.
- Enabled friend-related API endpoints to list friends and fetch friend
details by SteamID.
- Added category and base game data structures with validation and
serialization for enriched game metadata.
- Introduced ownership update functionality for Steam accounts during
login.
- Added new game and category linking to support detailed game metadata
and categorization.
- Introduced member retrieval functions for enhanced team and user
management.

- **Improvements**
- Enhanced authentication to enforce team membership checks and provide
member-level access control.
- Improved Steam account ownership handling to ensure accurate user
association.
  - Added indexes to friend relationships for optimized querying.
  - Refined API routing structure with added game and friend routes.
- Improved friend listing queries for efficiency and data completeness.

- **Bug Fixes**
  - Fixed formatting issues in permissions related to Steam accounts.

- **Other**
- Refined event handling for user account refresh based on user ID
instead of email.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

packages/functions/src/api/friend.ts

@@ -0,0 +1,94 @@
+import { z } from "zod"
+import { Hono } from "hono";
+import { validator } from "hono-openapi/zod";
+import { describeRoute } from "hono-openapi";
+import { Examples } from "@nestri/core/examples";
+import { Friend } from "@nestri/core/friend/index";
+import { ErrorResponses, notPublic, Result } from "./utils";
+import { ErrorCodes, VisibleError } from "@nestri/core/error";
+
+export namespace FriendApi {
+    export const route = new Hono()
+        .use(notPublic)
+        .get("/",
+            describeRoute({
+                tags: ["Friend"],
+                summary: "List friends accounts",
+                description: "List all this user's friends accounts",
+                responses: {
+                    200: {
+                        content: {
+                            "application/json": {
+                                schema: Result(
+                                    Friend.Info.array().openapi({
+                                        description: "All friends accounts",
+                                        example: [Examples.Friend]
+                                    })
+                                ),
+                            },
+                        },
+                        description: "Friends accounts details"
+                    },
+                    400: ErrorResponses[400],
+                    404: ErrorResponses[404],
+                    429: ErrorResponses[429],
+                }
+            }),
+            async (c) =>
+                c.json({
+                    data: await Friend.list()
+                })
+        )
+        .get("/:id",
+            describeRoute({
+                tags: ["Friend"],
+                summary: "Get a friend",
+                description: "Get a friend's details by their SteamID",
+                responses: {
+                    200: {
+                        content: {
+                            "application/json": {
+                                schema: Result(
+                                    Friend.Info.openapi({
+                                        description: "Friend's accounts",
+                                        example: Examples.Friend
+                                    })
+                                ),
+                            },
+                        },
+                        description: "Friends accounts details"
+                    },
+                    400: ErrorResponses[400],
+                    404: ErrorResponses[404],
+                    429: ErrorResponses[429],
+                }
+            }),
+            validator(
+                "param",
+                z.object({
+                    id: z.string().openapi({
+                        description: "ID of the friend to get",
+                        example: Examples.Friend.id,
+                    }),
+                }),
+            ),
+            async (c) => {
+                const friendSteamID = c.req.valid("param").id
+
+                const friend = await Friend.fromFriendID(friendSteamID)
+
+                if (!friend) {
+                    throw new VisibleError(
+                        "not_found",
+                        ErrorCodes.NotFound.RESOURCE_NOT_FOUND,
+                        `Friend ${friendSteamID} not found`
+                    )
+                }
+
+                return c.json({
+                    data: friend
+                })
+
+            }
+        )
+}