⚡ Bolt: implement request-level memoization using React cache

.jules/bolt.md

@@ -0,0 +1,3 @@
+## 2026-04-23 - Request Memoization with React 'cache'
+**Learning:** Next.js Server Components can perform multiple database lookups or CPU-intensive tasks (like JWT verification) for the same data across different components in a single request. Using React's 'cache' function allows us to deduplicate these operations within the request lifecycle.
+**Action:** Wrap frequently called data-fetching or expensive utility functions (like auth verification) with 'cache' to ensure they only execute once per request.

lib/auth/session.ts

@@ -2,6 +2,7 @@ import { compare, hash } from 'bcryptjs';
 import { SignJWT, jwtVerify } from 'jose';
 import { cookies } from 'next/headers';
 import { NewUser } from '@/lib/db/schema';
+import { cache } from 'react';
 
 const key = new TextEncoder().encode(process.env.AUTH_SECRET);
 const SALT_ROUNDS = 10;
@@ -30,12 +31,16 @@ export async function signToken(payload: SessionData) {
     .sign(key);
 }
 
-export async function verifyToken(input: string) {
+/**
+ * ⚡ OPTIMIZATION: Memoize JWT verification to avoid redundant CPU-intensive
+ * operations within a single request lifecycle.
+ */
+export const verifyToken = cache(async (input: string) => {
   const { payload } = await jwtVerify(input, key, {
     algorithms: ['HS256'],
   });
   return payload as SessionData;
-}
+});
 
 export async function getSession() {
   const session = (await cookies()).get('session')?.value;

lib/db/queries.ts

@@ -3,8 +3,13 @@ import { db } from './drizzle';
 import { activityLogs, teamMembers, teams, users } from './schema';
 import { cookies } from 'next/headers';
 import { verifyToken } from '@/lib/auth/session';
+import { cache } from 'react';
 
-export async function getUser() {
+/**
+ * ⚡ OPTIMIZATION: Memoize user database lookup to deduplicate queries
+ * across different server components in the same request.
+ */
+export const getUser = cache(async () => {
   const sessionCookie = (await cookies()).get('session');
   if (!sessionCookie || !sessionCookie.value) {
     return null;
@@ -34,7 +39,7 @@ export async function getUser() {
   }
 
   return user[0];
-}
+});
 
 export async function getTeamByStripeCustomerId(customerId: string) {
   const result = await db
@@ -64,7 +69,11 @@ export async function updateTeamSubscription(
     .where(eq(teams.id, teamId));
 }
 
-export async function getUserWithTeam(userId: number) {
+/**
+ * ⚡ OPTIMIZATION: Memoize user-with-team database lookup to deduplicate
+ * queries across different server components in the same request.
+ */
+export const getUserWithTeam = cache(async (userId: number) => {
   const result = await db
     .select({
       user: users,
@@ -76,7 +85,7 @@ export async function getUserWithTeam(userId: number) {
     .limit(1);
 
   return result[0];
-}
+});
 
 export async function getActivityLogs() {
   const user = await getUser();
@@ -99,7 +108,11 @@ export async function getActivityLogs() {
     .limit(10);
 }
 
-export async function getTeamForUser(userId: number) {
+/**
+ * ⚡ OPTIMIZATION: Memoize team-for-user database lookup to deduplicate
+ * queries across different server components in the same request.
+ */
+export const getTeamForUser = cache(async (userId: number) => {
   const result = await db.query.users.findFirst({
     where: eq(users.id, userId),
     with: {
@@ -126,4 +139,4 @@ export async function getTeamForUser(userId: number) {
   });
 
   return result?.teamMembers[0]?.team || null;
-}
+});