Help: Testing Nuxt API Routes Using serverSupabaseServiceRole and serverSupabaseUser with Vitest

[cubinet-code]

Hi everyone,

I’m currently writing tests for Nuxt server API routes using Vitest, and I’m having trouble mocking the Supabase utilities provided by #supabase/server — specifically serverSupabaseUser(event) and serverSupabaseServiceRole(event).

Despite searching extensively, I haven’t found any clear examples or official documentation on how to test Nuxt routes that depend on these functions. The serverSupabaseUser is used to get the authenticated user, and serverSupabaseServiceRole gives a service client for queries. Both are deeply integrated into route logic, so I need a way to mock or stub them to write proper unit tests.

Example route I’m testing

Here’s a simplified version of the route handler (in server/api/accounts/index.ts):

import {
  serverSupabaseServiceRole,
  serverSupabaseUser,
} from "#supabase/server";

export default defineEventHandler(async (event) => {
  const user = await serverSupabaseUser(event);

  if (!user) {
    throw createError({ statusCode: 401, statusMessage: "Unauthorized" });
  }

  const supabase = serverSupabaseServiceRole(event);

  switch (event.method) {
    case "GET":
      return await getAccounts(supabase, user.id);
    case "POST":
      const body = await readBody(event);
      return await createAccount(supabase, user.id, body);
    default:
      throw createError({ statusCode: 405, statusMessage: "Method Not Allowed" });
  }
});

What I’ve tried

• Using vi.mock("#supabase/server", ...) didn’t seem to affect the behavior when running the test.
• Wrapping the route handler in a custom mock context doesn’t work easily due to the defineEventHandler API.
• Couldn’t find examples or helpers in Nuxt or Supabase docs that explain how to properly mock those specific imports in a test.

What I need help with

• How can I mock serverSupabaseUser and serverSupabaseServiceRole for testing my route handlers?
• Is there a recommended pattern for testing API routes in Nuxt that use Supabase server utilities?
• If anyone has working examples using vitest + Nuxt + Supabase, I’d really appreciate it!

⸻

Thanks in advance! 🙏

If I find a solution, I’ll be sure to post it here for others.