feat: add teams (#848)

## Description

Add support for teams which will allow users to collaborate on
documents.

Teams features allows users to:

- Create, manage and transfer teams
- Manage team members
- Manage team emails
- Manage a shared team inbox and documents

These changes do NOT include the following, which are planned for a
future release:

- Team templates
- Team API
- Search menu integration

## Testing Performed

- Added E2E tests for general team management
- Added E2E tests to validate document counts

## Checklist

- [X] I have tested these changes locally and they work as expected.
- [X] I have added/updated tests that prove the effectiveness of these
changes.
- [ ] I have updated the documentation to reflect these changes, if
applicable.
- [X] I have followed the project's coding style guidelines.

apps/web/src/middleware.ts

@@ -1,14 +1,62 @@
-import { NextRequest, NextResponse } from 'next/server';
+import { cookies } from 'next/headers';
+import type { NextRequest } from 'next/server';
+import { NextResponse } from 'next/server';
 
 import { getToken } from 'next-auth/jwt';
 
+import { TEAM_URL_ROOT_REGEX } from '@documenso/lib/constants/teams';
+import { formatDocumentsPath } from '@documenso/lib/utils/teams';
+
 export default async function middleware(req: NextRequest) {
+  const preferredTeamUrl = cookies().get('preferred-team-url');
+
+  const referrer = req.headers.get('referer');
+  const referrerUrl = referrer ? new URL(referrer) : null;
+  const referrerPathname = referrerUrl ? referrerUrl.pathname : null;
+
+  // Whether to reset the preferred team url cookie if the user accesses a non team page from a team page.
+  const resetPreferredTeamUrl =
+    referrerPathname &&
+    referrerPathname.startsWith('/t/') &&
+    (!req.nextUrl.pathname.startsWith('/t/') || req.nextUrl.pathname === '/');
+
+  // Redirect root page to `/documents` or `/t/{preferredTeamUrl}/documents`.
   if (req.nextUrl.pathname === '/') {
-    const redirectUrl = new URL('/documents', req.url);
+    const redirectUrlPath = formatDocumentsPath(
+      resetPreferredTeamUrl ? undefined : preferredTeamUrl?.value,
+    );
+
+    const redirectUrl = new URL(redirectUrlPath, req.url);
+    const response = NextResponse.redirect(redirectUrl);
+
+    return response;
+  }
+
+  // Redirect `/t` to `/settings/teams`.
+  if (req.nextUrl.pathname === '/t') {
+    const redirectUrl = new URL('/settings/teams', req.url);
 
     return NextResponse.redirect(redirectUrl);
   }
 
+  // Redirect `/t/<team_url>` to `/t/<team_url>/documents`.
+  if (TEAM_URL_ROOT_REGEX.test(req.nextUrl.pathname)) {
+    const redirectUrl = new URL(`${req.nextUrl.pathname}/documents`, req.url);
+
+    const response = NextResponse.redirect(redirectUrl);
+    response.cookies.set('preferred-team-url', req.nextUrl.pathname.replace('/t/', ''));
+
+    return response;
+  }
+
+  // Set the preferred team url cookie if user accesses a team page.
+  if (req.nextUrl.pathname.startsWith('/t/')) {
+    const response = NextResponse.next();
+    response.cookies.set('preferred-team-url', req.nextUrl.pathname.split('/')[2]);
+
+    return response;
+  }
+
   if (req.nextUrl.pathname.startsWith('/signin')) {
     const token = await getToken({ req });
 
@@ -19,5 +67,34 @@ export default async function middleware(req: NextRequest) {
     }
   }
 
+  // Clear preferred team url cookie if user accesses a non team page from a team page.
+  if (resetPreferredTeamUrl || req.nextUrl.pathname === '/documents') {
+    const response = NextResponse.next();
+    response.cookies.set('preferred-team-url', '');
+
+    return response;
+  }
+
   return NextResponse.next();
 }
+
+export const config = {
+  matcher: [
+    /*
+     * Match all request paths except for the ones starting with:
+     * - api (API routes)
+     * - _next/static (static files)
+     * - _next/image (image optimization files)
+     * - favicon.ico (favicon file)
+     * - ingest (analytics)
+     * - site.webmanifest
+     */
+    {
+      source: '/((?!api|_next/static|_next/image|ingest|favicon|site.webmanifest).*)',
+      missing: [
+        { type: 'header', key: 'next-router-prefetch' },
+        { type: 'header', key: 'purpose', value: 'prefetch' },
+      ],
+    },
+  ],
+};