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.

[carsonbird]

I'm also dealing with this right now, and haven't found a good solution yet (granted, I've only been working on it today).

But the fact that the supabaseServerClient needs the Nitro request event is weird to me. I understand that it provides all the other benefits of supabase, but that means that I'm having to engineer my Use Cases and my Repositories to all accept nitro events as parameters, which creates tight coupling.

Even the serverSupabaseServiceRole requires the event, but it's not doing row level security. Why does it need access to the server event?

https://supabase.nuxtjs.org/services/serversupabaseservicerole