fix: use import.meta.resolve() to convert module specifiers to absolute paths

productdevbook · claude · productdevbook · commit 14c3198355b7 · 2026-01-28T13:00:29.000+03:00
This ensures route handler paths are correctly resolved both in local
development (monorepo symlinks) and in CI/production (npm install).

The previous approach used bare module specifiers like
'nitro-graphql/nitro/routes/graphql-yoga' which rolldown couldn't resolve
due to missing tsconfig. Now we use import.meta.resolve() at config time
to convert these to absolute filesystem paths that the bundler can handle.

Co-Authored-By: Claude Opus 4.5 &lt;noreply@anthropic.com&gt;
diff --git a/src/nitro/setup/routes.ts b/src/nitro/setup/routes.ts
@@ -3,12 +3,23 @@
  */
 
 import type { Nitro } from 'nitro/types'
+import { fileURLToPath } from 'node:url'
 import { ENDPOINT_DEBUG, GRAPHQL_HTTP_METHODS } from '../../core/constants'
 
+/**
+ * Resolve a module specifier to an absolute filesystem path.
+ * Uses import.meta.resolve() to handle both:
+ * - Local development (monorepo symlinks resolve to local source)
+ * - CI/Production (npm install resolves to node_modules)
+ */
+function resolveHandler(specifier: string): string {
+  return fileURLToPath(import.meta.resolve(specifier))
+}
+
 /**
  * Register GraphQL route handlers
  *
- * Uses module specifiers instead of filesystem paths for route handlers.
+ * Uses import.meta.resolve() to convert module specifiers to absolute paths.
  * This ensures handlers are resolved correctly both in local development
  * (monorepo symlink) and in CI/production (installed from npm).
  */
@@ -22,15 +33,15 @@ export function registerRouteHandlers(nitro: Nitro): void {
     for (const method of GRAPHQL_HTTP_METHODS) {
       nitro.options.handlers.push({
         route: endpoint,
-        handler: 'nitro-graphql/nitro/routes/graphql-yoga',
+        handler: resolveHandler('nitro-graphql/nitro/routes/graphql-yoga'),
         method,
       })
     }
 
     // Apollo Sandbox script proxy (cacheable)
     nitro.options.handlers.push({
       route: `${endpoint}/sandbox.js`,
-      handler: 'nitro-graphql/nitro/routes/apollo-sandbox-script',
+      handler: resolveHandler('nitro-graphql/nitro/routes/apollo-sandbox-script'),
       method: 'GET',
     })
 
@@ -40,7 +51,7 @@ export function registerRouteHandlers(nitro: Nitro): void {
       const wsPath = subscriptions.websocket?.path || `${endpoint}/ws`
       nitro.options.handlers.push({
         route: wsPath,
-        handler: 'nitro-graphql/nitro/routes/graphql-yoga-ws',
+        handler: resolveHandler('nitro-graphql/nitro/routes/graphql-yoga-ws'),
       })
     }
   }
@@ -49,7 +60,7 @@ export function registerRouteHandlers(nitro: Nitro): void {
     for (const method of GRAPHQL_HTTP_METHODS) {
       nitro.options.handlers.push({
         route: endpoint,
-        handler: 'nitro-graphql/nitro/routes/apollo-server',
+        handler: resolveHandler('nitro-graphql/nitro/routes/apollo-server'),
         method,
       })
     }
@@ -60,23 +71,23 @@ export function registerRouteHandlers(nitro: Nitro): void {
       const wsPath = subscriptions.websocket?.path || `${endpoint}/ws`
       nitro.options.handlers.push({
         route: wsPath,
-        handler: 'nitro-graphql/nitro/routes/apollo-server-ws',
+        handler: resolveHandler('nitro-graphql/nitro/routes/apollo-server-ws'),
       })
     }
   }
 
   // Health check endpoint
   nitro.options.handlers.push({
     route: nitro.options.runtimeConfig.graphql?.endpoint?.healthCheck || '/api/graphql/health',
-    handler: 'nitro-graphql/nitro/routes/health',
+    handler: resolveHandler('nitro-graphql/nitro/routes/health'),
     method: 'GET',
   })
 
   // Debug endpoint (development only)
   if (nitro.options.dev) {
     nitro.options.handlers.push({
       route: ENDPOINT_DEBUG,
-      handler: 'nitro-graphql/nitro/routes/debug',
+      handler: resolveHandler('nitro-graphql/nitro/routes/debug'),
       method: 'GET',
     })
   }
