feat: add complex user invitation and management features

- Implemented complex member and invitation schemas using Zod for validation.
- Created new API endpoints for inviting, accepting, revoking, and canceling complex user invitations.
- Developed handlers for managing complex users, including listing, inviting, revoking, and canceling invitations.
- Added frontend components for displaying and managing complex users and invitations.
- Introduced session storage management for pending invitations.
- Integrated Gravatar for user avatars based on email.
- Created database migration for complex invitations table.

apps/backend/src/modules/complex/handlers/invite-complex-user.handler.ts

@@ -0,0 +1,33 @@
+import {
+  ComplexMembersError,
+  inviteComplexUser,
+} from '@/modules/complex/services/complex-members.service';
+import type { AppContext } from '@/types/hono';
+import type { InviteComplexUserInput } from '@repo/api-contract';
+import { z } from 'zod';
+
+const complexParamsSchema = z.object({
+  id: z.uuid(),
+});
+
+export async function inviteComplexUserHandler(c: AppContext) {
+  const user = c.get('user');
+  const params = complexParamsSchema.parse(c.req.param());
+  const payload = c.req.valid('json' as never) as InviteComplexUserInput;
+
+  try {
+    const result = await inviteComplexUser(user.id, params.id, payload);
+    return c.json(result, 201);
+  } catch (error) {
+    if (error instanceof ComplexMembersError) {
+      return c.json(
+        { message: error.message },
+        {
+          status: error.status,
+        }
+      );
+    }
+
+    throw error;
+  }
+}