@openuiai/next 16.2.0 → 16.3.0

package/dist/server/websocket/setup.js

@@ -1,4 +1,4 @@
-// File: packages/next/src/server/websocket/setup.ts
+// File: packages/next/server/websocket/setup.ts
 /* eslint-disable react-hooks/rules-of-hooks */ "use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true

package/dist/server/websocket/setup.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../server/websocket/setup.ts"],"sourcesContent":["// File: packages/next/src/server/websocket/setup.ts\n/* eslint-disable react-hooks/rules-of-hooks */\n\nimport type { IncomingMessage } from 'http'\nimport type { Socket as NetSocket } from 'net'\nimport { WebSocketServer, type WebSocket } from 'next/dist/compiled/ws'\n\nimport * as Log from '../../build/output/log'\nimport setupDebug from 'next/dist/compiled/debug'\nimport type NextNodeServer from '../next-server'\nimport { createServerAdapter, getWebSocketConfig } from './server-adapter'\nimport { getConnectionTracker } from './connection-tracker'\nimport { resolveWebSocketRoute, isWebSocketSupported } from './route-resolver'\nimport { GracefulWebSocketHandler } from './graceful-handler'\nimport { getWebSocketServerOptions, getRouteConfig } from './config'\nimport { getOrInitializeConnectionHandler } from './route-handler'\nimport {\n  initializeHealthMonitor,\n  setupHealthCheckEndpoint,\n  getHealthMonitor,\n} from './health-check'\nimport { rateLimiterManager } from './rate-limiter'\nimport { initializeConnectionPool } from './performance'\nimport { getMemoryManager } from './memory-manager'\nimport {\n  useHttpServer,\n  useWebSocketServer,\n  clearWebSocketServer,\n} from './persistent-servers'\n\nconst debug = setupDebug('next:websocket:setup')\nimport { clearConnectionHandlerCache } from './route-handler'\n\n// Centralized error handler for WebSocket connections\nfunction handleConnectionError(\n  error: unknown,\n  connectionId: string,\n  pathname: string,\n  context: string\n): void {\n  const errorMessage = error instanceof Error ? error.message : String(error)\n\n  // Log the error with context\n  debug(\n    `${context} error:`,\n    pathname,\n    'connection id:',\n    connectionId,\n    'error:',\n    errorMessage\n  )\n\n  // Report to health monitor if available\n  const healthMonitor = getHealthMonitor()\n  if (healthMonitor) {\n    healthMonitor.recordError()\n  }\n\n  // Log to Next.js error system\n  Log.error(`WebSocket ${context}:`, pathname, errorMessage)\n}\n\n// Track servers that already have WebSocket listeners to prevent duplicates\nconst serverListenerMap = new WeakMap<\n  any,\n  {\n    handler: Function\n    wsServer: WebSocketServer\n  }\n>()\n\n// Cleanup function to remove WebSocket listeners and clean up resources\nfunction cleanupWebSocketServer(httpServer: any, wsServer: WebSocketServer) {\n  const existingSetup = serverListenerMap.get(httpServer)\n  if (existingSetup) {\n    httpServer.removeListener('upgrade', existingSetup.handler)\n    serverListenerMap.delete(httpServer)\n  }\n\n  // Clear connection handler cache\n  clearConnectionHandlerCache()\n\n  // Close WebSocket server\n  wsServer.close(() => {\n    debug('WebSocket closed')\n  })\n}\n\n// Sets up the WebSocket server and attaches it to the Next.js HTTP server.\n// This function is called during the NextNodeServer initialization.\n// @param nextServer The Next.js server instance.\nexport function setupWebSocketServer(nextServer: NextNodeServer): void {\n  debug('ws setup starting')\n\n  // Clear any stale state from previous server instances\n  debug('clearing stale websocket state')\n  clearWebSocketServer()\n  clearConnectionHandlerCache()\n\n  // Debug: Log initial state\n  const initialStats = getMemoryManager().getMemoryStats()\n  debug(\n    'initial state - app heap usage:',\n    `${(initialStats.heapUsed / 1024 / 1024).toFixed(2)}MB (${initialStats.percentage.toFixed(1)}% of ${(initialStats.heapTotal / 1024 / 1024).toFixed(0)}MB allocated heap)`,\n    'ws connections:',\n    initialStats.connectionCount\n  )\n\n  // Check if WebSocket support is available\n  if (!isWebSocketSupported(nextServer)) {\n    debug('WebSocket support unavailable')\n    return\n  }\n\n  const config = getWebSocketConfig(nextServer)\n  if (!config.enabled) {\n    debug('WebSocket disabled')\n    return\n  }\n\n  const serverAdapter = createServerAdapter(nextServer)\n  const httpServer = useHttpServer(serverAdapter.getHttpServer())\n\n  if (httpServer === undefined) {\n    // TODO: throw error\n    return\n  }\n\n  // Check if WebSocket listener already exists for this server\n  const existingSetup = serverListenerMap.get(httpServer)\n  if (existingSetup) {\n    debug('ws listener exists')\n    return\n  }\n\n  // Check existing listeners in development\n  if (process.env.NODE_ENV === 'development') {\n    const existingListeners = httpServer.listeners('upgrade')\n    if (existingListeners.length > 0) {\n      debug('existing upgrade listeners:', existingListeners.length)\n    }\n  }\n\n  const wsServerOptions = getWebSocketServerOptions(config)\n  const wsServer = useWebSocketServer(new WebSocketServer(wsServerOptions))\n  // Increase max listeners to prevent warnings\n  if (wsServer) {\n    wsServer.setMaxListeners(20)\n  }\n  if (!wsServer) {\n    Log.error('WebSocketServer init failed')\n    return\n  }\n\n  // Initialize performance optimizations\n  const connectionPool = initializeConnectionPool(\n    config.maxConnections,\n    config.timeout || 300000 // Use timeout or default 5 minutes for idle cleanup\n  )\n\n  // Initialize memory management\n  const memoryManager = getMemoryManager()\n\n  // Initialize health monitoring if enabled\n  if (config.monitoring.metrics || config.monitoring.healthCheck?.enabled) {\n    initializeHealthMonitor(config, wsServer)\n\n    if (config.monitoring.healthCheck?.enabled) {\n      setupHealthCheckEndpoint(config, httpServer)\n    }\n  }\n\n  // The primary upgrade handler attached to the HTTP server.\n  const handleUpgrade = async (\n    request: IncomingMessage,\n    socket: NetSocket,\n    head: Buffer\n  ) => {\n    const requestUrl = request.url || '/'\n    debug('ws upgrade:', requestUrl)\n\n    const tracker = getConnectionTracker()\n\n    // Check for rapid duplicate requests\n    // if (tracker.isRapidDuplicate(requestUrl, socket)) {\n    //   debug('duplicate request blocked')\n    //   return\n    // }\n\n    // Check if this socket is already being processed\n    if (tracker.isSocketActive(socket)) {\n      debug('socket busy, ignoring upgrade')\n      return\n    }\n\n    // Mark this socket as being processed\n    tracker.markSocketActive(socket)\n\n    const parsedUrl = new URL(\n      requestUrl,\n      `ws://${request.headers.host || 'localhost'}`\n    )\n    const pathname = parsedUrl.pathname\n\n    // Create connection context for error handling\n    // const connectionContext = {\n    //   pathname,\n    //   socket,\n    //   request,\n    //   startTime: Date.now()\n    // }\n\n    // Exclude Next.js internal paths like HMR\n    if (pathname.startsWith('/_next/')) {\n      tracker.markSocketInactive(socket)\n      return\n    }\n\n    // Check rate limiting for this route\n    const routeConfig = getRouteConfig(config, pathname)\n    if (routeConfig.rateLimit) {\n      const rateLimit = rateLimiterManager.checkRateLimit(\n        pathname,\n        routeConfig,\n        request,\n        socket\n      )\n      if (!rateLimit.allowed) {\n        debug(`Rate limit exceeded for ${pathname}: ${rateLimit.message}`)\n        socket.destroy() // Rate limit exceeded - close immediately\n        tracker.markSocketInactive(socket)\n        return\n      }\n    }\n\n    // Resolve the WebSocket route\n    const routeResolution = await resolveWebSocketRoute(nextServer, pathname)\n    if (!routeResolution) {\n      debug('no ws route found for:', pathname)\n      socket.destroy()\n      tracker.markSocketInactive(socket)\n      return\n    }\n\n    const { handler: socketHandler, routeParams: _routeParams } =\n      routeResolution\n\n    // Get route configuration\n    const currentRouteConfig = getRouteConfig(config, pathname)\n\n    // Get or initialize the connection handler for this route\n    const connectionHandler = await getOrInitializeConnectionHandler(\n      socketHandler,\n      wsServer,\n      pathname,\n      currentRouteConfig\n    )\n\n    if (!connectionHandler) {\n      Log.error('connection handler init failed:', pathname)\n      socket.destroy()\n      tracker.markSocketInactive(socket)\n      return\n    }\n\n    // If we found a connection handler, delegate the upgrade to the 'ws' library\n    wsServer.handleUpgrade(\n      request,\n      socket,\n      head,\n      async (clientWebSocket: WebSocket, httpRequest: IncomingMessage) => {\n        // Generate unique connection ID\n        const connectionId = crypto.randomUUID()\n        debug(\n          'ws connected to route:',\n          pathname,\n          'connection id:',\n          connectionId\n        )\n\n        // Check memory usage before accepting connection\n        if (!memoryManager.isMemoryUsageAcceptable()) {\n          debug('memory high, rejecting connection')\n          await GracefulWebSocketHandler.closeWebSocketGracefully(\n            clientWebSocket,\n            {\n              code: 1013,\n              reason: 'Server overloaded',\n            }\n          )\n          return\n        }\n\n        // Add to connection pool\n        if (\n          !connectionPool.addConnection(connectionId, clientWebSocket, pathname)\n        ) {\n          debug('connection pool full')\n          await GracefulWebSocketHandler.closeWebSocketGracefully(\n            clientWebSocket,\n            {\n              code: 1013,\n              reason: 'Server at capacity',\n            }\n          )\n          return\n        }\n\n        try {\n          // Call the connection handler function\n          const cleanupFunction = await connectionHandler(\n            clientWebSocket,\n            httpRequest\n          )\n\n          // Always attach close handler for cleanup\n          clientWebSocket.once('close', (code, reason) => {\n            debug(\n              'ws disconnected:',\n              pathname,\n              'connection id:',\n              connectionId,\n              'code:',\n              code,\n              'reason:',\n              reason?.toString()\n            )\n\n            // Prevent double cleanup\n            if (tracker.isConnectionCleanedUp(connectionId)) {\n              debug('connection already cleaned up:', connectionId)\n              return\n            }\n            tracker.markConnectionCleanedUp(connectionId)\n\n            // Remove from connection tracker\n            tracker.markSocketInactive(socket)\n\n            // Run user cleanup function if provided\n            if (typeof cleanupFunction === 'function') {\n              try {\n                cleanupFunction()\n              } catch (e) {\n                handleConnectionError(e, connectionId, pathname, 'cleanup')\n              }\n            }\n          })\n\n          // Note: Connection pool cleanup is handled automatically by setupConnectionHandlers()\n\n          // Add error handler to track connection errors\n          clientWebSocket.on('error', (error) => {\n            handleConnectionError(error, connectionId, pathname, 'connection')\n          })\n\n          // Add heartbeat to detect dead connections\n          // Use unref() so this interval doesn't prevent the process from exiting\n          const heartbeatInterval = setInterval(() => {\n            if (clientWebSocket.readyState === clientWebSocket.OPEN) {\n              debug('sending ping to:', connectionId)\n              clientWebSocket.ping()\n            } else {\n              debug(\n                'connection not open, clearing heartbeat:',\n                connectionId,\n                'state:',\n                clientWebSocket.readyState\n              )\n              clearInterval(heartbeatInterval)\n            }\n          }, 30000) // 30 second heartbeat\n          heartbeatInterval.unref()\n\n          // Clear heartbeat on close\n          clientWebSocket.once('close', () => {\n            if (!tracker.isConnectionCleanedUp(connectionId)) {\n              clearInterval(heartbeatInterval)\n            }\n          })\n\n          if (\n            typeof cleanupFunction !== 'function' &&\n            cleanupFunction !== undefined &&\n            cleanupFunction !== null\n          ) {\n            debug(\n              `Connection handler for ${pathname} returned non-function value: ${typeof cleanupFunction}`\n            )\n          }\n        } catch (e) {\n          handleConnectionError(e, connectionId, pathname, 'handler')\n          clientWebSocket.terminate()\n        }\n\n        // Connection tracking is automatically cleaned up when socket closes\n      }\n    )\n  }\n\n  // Add a unique identifier to the handler for detection\n  Object.defineProperty(handleUpgrade, 'name', { value: 'nextWsHandleUpgrade' })\n\n  // Store the handler reference for cleanup\n  serverListenerMap.set(httpServer, {\n    handler: handleUpgrade,\n    wsServer,\n  })\n\n  // Attach our custom upgrade handler to the HTTP server\n  httpServer.on('upgrade', handleUpgrade)\n  debug('ws upgrade listener ready')\n\n  // Set up cleanup when the server closes\n  httpServer.on('close', () => {\n    debug('cleaning up WebSocket server')\n    cleanupWebSocketServer(httpServer, wsServer)\n  })\n}\n"],"names":["setupWebSocketServer","debug","setupDebug","handleConnectionError","error","connectionId","pathname","context","errorMessage","Error","message","String","healthMonitor","getHealthMonitor","recordError","Log","serverListenerMap","WeakMap","cleanupWebSocketServer","httpServer","wsServer","existingSetup","get","removeListener","handler","delete","clearConnectionHandlerCache","close","nextServer","config","clearWebSocketServer","initialStats","getMemoryManager","getMemoryStats","heapUsed","toFixed","percentage","heapTotal","connectionCount","isWebSocketSupported","getWebSocketConfig","enabled","serverAdapter","createServerAdapter","useHttpServer","getHttpServer","undefined","process","env","NODE_ENV","existingListeners","listeners","length","wsServerOptions","getWebSocketServerOptions","useWebSocketServer","WebSocketServer","setMaxListeners","connectionPool","initializeConnectionPool","maxConnections","timeout","memoryManager","monitoring","metrics","healthCheck","initializeHealthMonitor","setupHealthCheckEndpoint","handleUpgrade","request","socket","head","requestUrl","url","tracker","getConnectionTracker","isSocketActive","markSocketActive","parsedUrl","URL","headers","host","startsWith","markSocketInactive","routeConfig","getRouteConfig","rateLimit","rateLimiterManager","checkRateLimit","allowed","destroy","routeResolution","resolveWebSocketRoute","socketHandler","routeParams","_routeParams","currentRouteConfig","connectionHandler","getOrInitializeConnectionHandler","clientWebSocket","httpRequest","crypto","randomUUID","isMemoryUsageAcceptable","GracefulWebSocketHandler","closeWebSocketGracefully","code","reason","addConnection","cleanupFunction","once","toString","isConnectionCleanedUp","markConnectionCleanedUp","e","on","heartbeatInterval","setInterval","readyState","OPEN","ping","clearInterval","unref","terminate","Object","defineProperty","value","set"],"mappings":"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","ignoreList":[0]}
+{"version":3,"sources":["../../../server/websocket/setup.ts"],"sourcesContent":["// File: packages/next/server/websocket/setup.ts\n/* eslint-disable react-hooks/rules-of-hooks */\n\nimport type { IncomingMessage } from 'http'\nimport type { Socket as NetSocket } from 'net'\nimport { WebSocketServer, type WebSocket } from 'next/dist/compiled/ws'\n\nimport * as Log from '../../build/output/log'\nimport setupDebug from 'next/dist/compiled/debug'\nimport type NextNodeServer from '../next-server'\nimport { createServerAdapter, getWebSocketConfig } from './server-adapter'\nimport { getConnectionTracker } from './connection-tracker'\nimport { resolveWebSocketRoute, isWebSocketSupported } from './route-resolver'\nimport { GracefulWebSocketHandler } from './graceful-handler'\nimport { getWebSocketServerOptions, getRouteConfig } from './config'\nimport { getOrInitializeConnectionHandler } from './route-handler'\nimport {\n  initializeHealthMonitor,\n  setupHealthCheckEndpoint,\n  getHealthMonitor,\n} from './health-check'\nimport { rateLimiterManager } from './rate-limiter'\nimport { initializeConnectionPool } from './performance'\nimport { getMemoryManager } from './memory-manager'\nimport {\n  useHttpServer,\n  useWebSocketServer,\n  clearWebSocketServer,\n} from './persistent-servers'\n\nconst debug = setupDebug('next:websocket:setup')\nimport { clearConnectionHandlerCache } from './route-handler'\n\n// Centralized error handler for WebSocket connections\nfunction handleConnectionError(\n  error: unknown,\n  connectionId: string,\n  pathname: string,\n  context: string\n): void {\n  const errorMessage = error instanceof Error ? error.message : String(error)\n\n  // Log the error with context\n  debug(\n    `${context} error:`,\n    pathname,\n    'connection id:',\n    connectionId,\n    'error:',\n    errorMessage\n  )\n\n  // Report to health monitor if available\n  const healthMonitor = getHealthMonitor()\n  if (healthMonitor) {\n    healthMonitor.recordError()\n  }\n\n  // Log to Next.js error system\n  Log.error(`WebSocket ${context}:`, pathname, errorMessage)\n}\n\n// Track servers that already have WebSocket listeners to prevent duplicates\nconst serverListenerMap = new WeakMap<\n  any,\n  {\n    handler: Function\n    wsServer: WebSocketServer\n  }\n>()\n\n// Cleanup function to remove WebSocket listeners and clean up resources\nfunction cleanupWebSocketServer(httpServer: any, wsServer: WebSocketServer) {\n  const existingSetup = serverListenerMap.get(httpServer)\n  if (existingSetup) {\n    httpServer.removeListener('upgrade', existingSetup.handler)\n    serverListenerMap.delete(httpServer)\n  }\n\n  // Clear connection handler cache\n  clearConnectionHandlerCache()\n\n  // Close WebSocket server\n  wsServer.close(() => {\n    debug('WebSocket closed')\n  })\n}\n\n// Sets up the WebSocket server and attaches it to the Next.js HTTP server.\n// This function is called during the NextNodeServer initialization.\n// @param nextServer The Next.js server instance.\nexport function setupWebSocketServer(nextServer: NextNodeServer): void {\n  debug('ws setup starting')\n\n  // Clear any stale state from previous server instances\n  debug('clearing stale websocket state')\n  clearWebSocketServer()\n  clearConnectionHandlerCache()\n\n  // Debug: Log initial state\n  const initialStats = getMemoryManager().getMemoryStats()\n  debug(\n    'initial state - app heap usage:',\n    `${(initialStats.heapUsed / 1024 / 1024).toFixed(2)}MB (${initialStats.percentage.toFixed(1)}% of ${(initialStats.heapTotal / 1024 / 1024).toFixed(0)}MB allocated heap)`,\n    'ws connections:',\n    initialStats.connectionCount\n  )\n\n  // Check if WebSocket support is available\n  if (!isWebSocketSupported(nextServer)) {\n    debug('WebSocket support unavailable')\n    return\n  }\n\n  const config = getWebSocketConfig(nextServer)\n  if (!config.enabled) {\n    debug('WebSocket disabled')\n    return\n  }\n\n  const serverAdapter = createServerAdapter(nextServer)\n  const httpServer = useHttpServer(serverAdapter.getHttpServer())\n\n  if (httpServer === undefined) {\n    // TODO: throw error\n    return\n  }\n\n  // Check if WebSocket listener already exists for this server\n  const existingSetup = serverListenerMap.get(httpServer)\n  if (existingSetup) {\n    debug('ws listener exists')\n    return\n  }\n\n  // Check existing listeners in development\n  if (process.env.NODE_ENV === 'development') {\n    const existingListeners = httpServer.listeners('upgrade')\n    if (existingListeners.length > 0) {\n      debug('existing upgrade listeners:', existingListeners.length)\n    }\n  }\n\n  const wsServerOptions = getWebSocketServerOptions(config)\n  const wsServer = useWebSocketServer(new WebSocketServer(wsServerOptions))\n  // Increase max listeners to prevent warnings\n  if (wsServer) {\n    wsServer.setMaxListeners(20)\n  }\n  if (!wsServer) {\n    Log.error('WebSocketServer init failed')\n    return\n  }\n\n  // Initialize performance optimizations\n  const connectionPool = initializeConnectionPool(\n    config.maxConnections,\n    config.timeout || 300000 // Use timeout or default 5 minutes for idle cleanup\n  )\n\n  // Initialize memory management\n  const memoryManager = getMemoryManager()\n\n  // Initialize health monitoring if enabled\n  if (config.monitoring.metrics || config.monitoring.healthCheck?.enabled) {\n    initializeHealthMonitor(config, wsServer)\n\n    if (config.monitoring.healthCheck?.enabled) {\n      setupHealthCheckEndpoint(config, httpServer)\n    }\n  }\n\n  // The primary upgrade handler attached to the HTTP server.\n  const handleUpgrade = async (\n    request: IncomingMessage,\n    socket: NetSocket,\n    head: Buffer\n  ) => {\n    const requestUrl = request.url || '/'\n    debug('ws upgrade:', requestUrl)\n\n    const tracker = getConnectionTracker()\n\n    // Check for rapid duplicate requests\n    // if (tracker.isRapidDuplicate(requestUrl, socket)) {\n    //   debug('duplicate request blocked')\n    //   return\n    // }\n\n    // Check if this socket is already being processed\n    if (tracker.isSocketActive(socket)) {\n      debug('socket busy, ignoring upgrade')\n      return\n    }\n\n    // Mark this socket as being processed\n    tracker.markSocketActive(socket)\n\n    const parsedUrl = new URL(\n      requestUrl,\n      `ws://${request.headers.host || 'localhost'}`\n    )\n    const pathname = parsedUrl.pathname\n\n    // Create connection context for error handling\n    // const connectionContext = {\n    //   pathname,\n    //   socket,\n    //   request,\n    //   startTime: Date.now()\n    // }\n\n    // Exclude Next.js internal paths like HMR\n    if (pathname.startsWith('/_next/')) {\n      tracker.markSocketInactive(socket)\n      return\n    }\n\n    // Check rate limiting for this route\n    const routeConfig = getRouteConfig(config, pathname)\n    if (routeConfig.rateLimit) {\n      const rateLimit = rateLimiterManager.checkRateLimit(\n        pathname,\n        routeConfig,\n        request,\n        socket\n      )\n      if (!rateLimit.allowed) {\n        debug(`Rate limit exceeded for ${pathname}: ${rateLimit.message}`)\n        socket.destroy() // Rate limit exceeded - close immediately\n        tracker.markSocketInactive(socket)\n        return\n      }\n    }\n\n    // Resolve the WebSocket route\n    const routeResolution = await resolveWebSocketRoute(nextServer, pathname)\n    if (!routeResolution) {\n      debug('no ws route found for:', pathname)\n      socket.destroy()\n      tracker.markSocketInactive(socket)\n      return\n    }\n\n    const { handler: socketHandler, routeParams: _routeParams } =\n      routeResolution\n\n    // Get route configuration\n    const currentRouteConfig = getRouteConfig(config, pathname)\n\n    // Get or initialize the connection handler for this route\n    const connectionHandler = await getOrInitializeConnectionHandler(\n      socketHandler,\n      wsServer,\n      pathname,\n      currentRouteConfig\n    )\n\n    if (!connectionHandler) {\n      Log.error('connection handler init failed:', pathname)\n      socket.destroy()\n      tracker.markSocketInactive(socket)\n      return\n    }\n\n    // If we found a connection handler, delegate the upgrade to the 'ws' library\n    wsServer.handleUpgrade(\n      request,\n      socket,\n      head,\n      async (clientWebSocket: WebSocket, httpRequest: IncomingMessage) => {\n        // Generate unique connection ID\n        const connectionId = crypto.randomUUID()\n        debug(\n          'ws connected to route:',\n          pathname,\n          'connection id:',\n          connectionId\n        )\n\n        // Check memory usage before accepting connection\n        if (!memoryManager.isMemoryUsageAcceptable()) {\n          debug('memory high, rejecting connection')\n          await GracefulWebSocketHandler.closeWebSocketGracefully(\n            clientWebSocket,\n            {\n              code: 1013,\n              reason: 'Server overloaded',\n            }\n          )\n          return\n        }\n\n        // Add to connection pool\n        if (\n          !connectionPool.addConnection(connectionId, clientWebSocket, pathname)\n        ) {\n          debug('connection pool full')\n          await GracefulWebSocketHandler.closeWebSocketGracefully(\n            clientWebSocket,\n            {\n              code: 1013,\n              reason: 'Server at capacity',\n            }\n          )\n          return\n        }\n\n        try {\n          // Call the connection handler function\n          const cleanupFunction = await connectionHandler(\n            clientWebSocket,\n            httpRequest\n          )\n\n          // Always attach close handler for cleanup\n          clientWebSocket.once('close', (code, reason) => {\n            debug(\n              'ws disconnected:',\n              pathname,\n              'connection id:',\n              connectionId,\n              'code:',\n              code,\n              'reason:',\n              reason?.toString()\n            )\n\n            // Prevent double cleanup\n            if (tracker.isConnectionCleanedUp(connectionId)) {\n              debug('connection already cleaned up:', connectionId)\n              return\n            }\n            tracker.markConnectionCleanedUp(connectionId)\n\n            // Remove from connection tracker\n            tracker.markSocketInactive(socket)\n\n            // Run user cleanup function if provided\n            if (typeof cleanupFunction === 'function') {\n              try {\n                cleanupFunction()\n              } catch (e) {\n                handleConnectionError(e, connectionId, pathname, 'cleanup')\n              }\n            }\n          })\n\n          // Note: Connection pool cleanup is handled automatically by setupConnectionHandlers()\n\n          // Add error handler to track connection errors\n          clientWebSocket.on('error', (error) => {\n            handleConnectionError(error, connectionId, pathname, 'connection')\n          })\n\n          // Add heartbeat to detect dead connections\n          // Use unref() so this interval doesn't prevent the process from exiting\n          const heartbeatInterval = setInterval(() => {\n            if (clientWebSocket.readyState === clientWebSocket.OPEN) {\n              debug('sending ping to:', connectionId)\n              clientWebSocket.ping()\n            } else {\n              debug(\n                'connection not open, clearing heartbeat:',\n                connectionId,\n                'state:',\n                clientWebSocket.readyState\n              )\n              clearInterval(heartbeatInterval)\n            }\n          }, 30000) // 30 second heartbeat\n          heartbeatInterval.unref()\n\n          // Clear heartbeat on close\n          clientWebSocket.once('close', () => {\n            if (!tracker.isConnectionCleanedUp(connectionId)) {\n              clearInterval(heartbeatInterval)\n            }\n          })\n\n          if (\n            typeof cleanupFunction !== 'function' &&\n            cleanupFunction !== undefined &&\n            cleanupFunction !== null\n          ) {\n            debug(\n              `Connection handler for ${pathname} returned non-function value: ${typeof cleanupFunction}`\n            )\n          }\n        } catch (e) {\n          handleConnectionError(e, connectionId, pathname, 'handler')\n          clientWebSocket.terminate()\n        }\n\n        // Connection tracking is automatically cleaned up when socket closes\n      }\n    )\n  }\n\n  // Add a unique identifier to the handler for detection\n  Object.defineProperty(handleUpgrade, 'name', { value: 'nextWsHandleUpgrade' })\n\n  // Store the handler reference for cleanup\n  serverListenerMap.set(httpServer, {\n    handler: handleUpgrade,\n    wsServer,\n  })\n\n  // Attach our custom upgrade handler to the HTTP server\n  httpServer.on('upgrade', handleUpgrade)\n  debug('ws upgrade listener ready')\n\n  // Set up cleanup when the server closes\n  httpServer.on('close', () => {\n    debug('cleaning up WebSocket server')\n    cleanupWebSocketServer(httpServer, wsServer)\n  })\n}\n"],"names":["setupWebSocketServer","debug","setupDebug","handleConnectionError","error","connectionId","pathname","context","errorMessage","Error","message","String","healthMonitor","getHealthMonitor","recordError","Log","serverListenerMap","WeakMap","cleanupWebSocketServer","httpServer","wsServer","existingSetup","get","removeListener","handler","delete","clearConnectionHandlerCache","close","nextServer","config","clearWebSocketServer","initialStats","getMemoryManager","getMemoryStats","heapUsed","toFixed","percentage","heapTotal","connectionCount","isWebSocketSupported","getWebSocketConfig","enabled","serverAdapter","createServerAdapter","useHttpServer","getHttpServer","undefined","process","env","NODE_ENV","existingListeners","listeners","length","wsServerOptions","getWebSocketServerOptions","useWebSocketServer","WebSocketServer","setMaxListeners","connectionPool","initializeConnectionPool","maxConnections","timeout","memoryManager","monitoring","metrics","healthCheck","initializeHealthMonitor","setupHealthCheckEndpoint","handleUpgrade","request","socket","head","requestUrl","url","tracker","getConnectionTracker","isSocketActive","markSocketActive","parsedUrl","URL","headers","host","startsWith","markSocketInactive","routeConfig","getRouteConfig","rateLimit","rateLimiterManager","checkRateLimit","allowed","destroy","routeResolution","resolveWebSocketRoute","socketHandler","routeParams","_routeParams","currentRouteConfig","connectionHandler","getOrInitializeConnectionHandler","clientWebSocket","httpRequest","crypto","randomUUID","isMemoryUsageAcceptable","GracefulWebSocketHandler","closeWebSocketGracefully","code","reason","addConnection","cleanupFunction","once","toString","isConnectionCleanedUp","markConnectionCleanedUp","e","on","heartbeatInterval","setInterval","readyState","OPEN","ping","clearInterval","unref","terminate","Object","defineProperty","value","set"],"mappings":"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","ignoreList":[0]}

package/dist/server/websocket/types.js

@@ -1,4 +1,4 @@
-// File: packages/next/src/server/websocket/types.ts
+// File: packages/next/server/websocket/types.ts
 "use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true

package/dist/server/websocket/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../server/websocket/types.ts"],"sourcesContent":["// File: packages/next/src/server/websocket/types.ts\n\nimport type { IncomingMessage as HttpIncomingMessage } from 'http'\nimport type {\n  WebSocket,\n  WebSocketServer as WebSocketServerType,\n} from 'next/dist/compiled/ws'\n\n// Awaitable utility type\ntype Awaitable<T> = T | Promise<T>\n\n// Type for the function optionally returned by a connection handler, called on client disconnect.\nexport type OnSocketClose = () => Awaitable<unknown>\n\n// Type for the connection handler function returned by SOCKET\nexport type ConnectionHandler = (\n  // The individual WebSocket client that has connected.\n  client: WebSocket,\n  // The initial HTTP request that initiated the WebSocket upgrade.\n  request: HttpIncomingMessage\n) => Awaitable<OnSocketClose | void | unknown>\n\n// Defines the signature for a WebSocket handler function that can be exported\n// from a Next.js App Router API route file under the name `SOCKET`.\n// This function is called ONCE when the server starts up, not for each connection.\nexport type SocketHandler = (\n  // The WebSocketServer instance managing all connections for this route\n  wss: WebSocketServerType\n) => Awaitable<ConnectionHandler>\n\n// Interface for the structure of a route module that might contain a SOCKET handler.\n// This is used by `route-handler.ts` to safely access the `SOCKET` export,\n// considering potential wrapping by the Next.js compiler or different export styles.\nexport interface RouteModuleWithPossibleSocketHandler {\n  // Common App Router structure: `export default <...>`. The resolved default\n  // might have a `routeModule.userland` structure.\n  default?:\n    | Promise<RouteModuleWithPossibleSocketHandler> // Handle async default exports\n    | RouteModuleWithPossibleSocketHandler // Handle direct object default exports\n\n  // Standard Next.js App Router structure for route handlers\n  routeModule?: {\n    userland?: {\n      SOCKET?: SocketHandler // The target export key\n      // other HTTP methods like GET, POST etc. might also be here\n      [key: string]: unknown\n    }\n  }\n\n  // Alternative structures sometimes used or found in module objects\n  handlers?: {\n    SOCKET?: SocketHandler\n    // other HTTP methods\n    [key: string]: unknown\n  }\n\n  // Direct export of SOCKET (less common with standard App Router conventions but possible)\n  SOCKET?: SocketHandler\n}\n"],"names":[],"mappings":"AAAA,oDAAoD","ignoreList":[0]}
+{"version":3,"sources":["../../../server/websocket/types.ts"],"sourcesContent":["// File: packages/next/server/websocket/types.ts\n\nimport type { IncomingMessage as HttpIncomingMessage } from 'http'\nimport type {\n  WebSocket,\n  WebSocketServer as WebSocketServerType,\n} from 'next/dist/compiled/ws'\n\n// Awaitable utility type\ntype Awaitable<T> = T | Promise<T>\n\n// Type for the function optionally returned by a connection handler, called on client disconnect.\nexport type OnSocketClose = () => Awaitable<unknown>\n\n// Type for the connection handler function returned by SOCKET\nexport type ConnectionHandler = (\n  // The individual WebSocket client that has connected.\n  client: WebSocket,\n  // The initial HTTP request that initiated the WebSocket upgrade.\n  request: HttpIncomingMessage\n) => Awaitable<OnSocketClose | void | unknown>\n\n// Defines the signature for a WebSocket handler function that can be exported\n// from a Next.js App Router API route file under the name `SOCKET`.\n// This function is called ONCE when the server starts up, not for each connection.\nexport type SocketHandler = (\n  // The WebSocketServer instance managing all connections for this route\n  wss: WebSocketServerType\n) => Awaitable<ConnectionHandler>\n\n// Interface for the structure of a route module that might contain a SOCKET handler.\n// This is used by `route-handler.ts` to safely access the `SOCKET` export,\n// considering potential wrapping by the Next.js compiler or different export styles.\nexport interface RouteModuleWithPossibleSocketHandler {\n  // Common App Router structure: `export default <...>`. The resolved default\n  // might have a `routeModule.userland` structure.\n  default?:\n    | Promise<RouteModuleWithPossibleSocketHandler> // Handle async default exports\n    | RouteModuleWithPossibleSocketHandler // Handle direct object default exports\n\n  // Standard Next.js App Router structure for route handlers\n  routeModule?: {\n    userland?: {\n      SOCKET?: SocketHandler // The target export key\n      // other HTTP methods like GET, POST etc. might also be here\n      [key: string]: unknown\n    }\n  }\n\n  // Alternative structures sometimes used or found in module objects\n  handlers?: {\n    SOCKET?: SocketHandler\n    // other HTTP methods\n    [key: string]: unknown\n  }\n\n  // Direct export of SOCKET (less common with standard App Router conventions but possible)\n  SOCKET?: SocketHandler\n}\n"],"names":[],"mappings":"AAAA,gDAAgD","ignoreList":[0]}

package/dist/shared/lib/errors/canary-only-config-error.js

@@ -21,7 +21,7 @@ _export(exports, {
     }
 });
 function isStableBuild() {
-    return !"16.2.0"?.includes('canary') && !process.env.__NEXT_TEST_MODE && !process.env.NEXT_PRIVATE_LOCAL_DEV;
+    return !"16.3.0"?.includes('canary') && !process.env.__NEXT_TEST_MODE && !process.env.NEXT_PRIVATE_LOCAL_DEV;
 }
 class CanaryOnlyConfigError extends Error {
     constructor(arg){

package/dist/string/encode-uri-path.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "encodeURIPath", {
+    enumerable: true,
+    get: function() {
+        return encodeURIPath;
+    }
+});
+function encodeURIPath(file) {
+    return file.split('/').map((p)=>encodeURIComponent(p)).join('/');
+}
+
+//# sourceMappingURL=encode-uri-path.js.map

package/dist/string/encode-uri-path.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../string/encode-uri-path.ts"],"sourcesContent":["export function encodeURIPath(file: string) {\n  return file\n    .split('/')\n    .map((p) => encodeURIComponent(p))\n    .join('/')\n}\n"],"names":["encodeURIPath","file","split","map","p","encodeURIComponent","join"],"mappings":";;;;+BAAgBA;;;eAAAA;;;AAAT,SAASA,cAAcC,IAAY;IACxC,OAAOA,KACJC,KAAK,CAAC,KACNC,GAAG,CAAC,CAACC,IAAMC,mBAAmBD,IAC9BE,IAAI,CAAC;AACV","ignoreList":[0]}

package/dist/string/escape-regexp.js

@@ -0,0 +1,22 @@
+// regexp is based on https://github.com/sindresorhus/escape-string-regexp
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "escapeStringRegexp", {
+    enumerable: true,
+    get: function() {
+        return escapeStringRegexp;
+    }
+});
+const reHasRegExp = /[|\\{}()[\]^$+*?.-]/;
+const reReplaceRegExp = /[|\\{}()[\]^$+*?.-]/g;
+function escapeStringRegexp(str) {
+    // see also: https://github.com/lodash/lodash/blob/2da024c3b4f9947a48517639de7560457cd4ec6c/escapeRegExp.js#L23
+    if (reHasRegExp.test(str)) {
+        return str.replace(reReplaceRegExp, '\\$&');
+    }
+    return str;
+}
+
+//# sourceMappingURL=escape-regexp.js.map

package/dist/string/escape-regexp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../string/escape-regexp.ts"],"sourcesContent":["// regexp is based on https://github.com/sindresorhus/escape-string-regexp\nconst reHasRegExp = /[|\\\\{}()[\\]^$+*?.-]/\nconst reReplaceRegExp = /[|\\\\{}()[\\]^$+*?.-]/g\n\nexport function escapeStringRegexp(str: string) {\n  // see also: https://github.com/lodash/lodash/blob/2da024c3b4f9947a48517639de7560457cd4ec6c/escapeRegExp.js#L23\n  if (reHasRegExp.test(str)) {\n    return str.replace(reReplaceRegExp, '\\\\$&')\n  }\n  return str\n}\n"],"names":["escapeStringRegexp","reHasRegExp","reReplaceRegExp","str","test","replace"],"mappings":"AAAA,0EAA0E;;;;;+BAI1DA;;;eAAAA;;;AAHhB,MAAMC,cAAc;AACpB,MAAMC,kBAAkB;AAEjB,SAASF,mBAAmBG,GAAW;IAC5C,+GAA+G;IAC/G,IAAIF,YAAYG,IAAI,CAACD,MAAM;QACzB,OAAOA,IAAIE,OAAO,CAACH,iBAAiB;IACtC;IACA,OAAOC;AACT","ignoreList":[0]}

package/dist/string/normalize-path.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "normalizePath", {
+    enumerable: true,
+    get: function() {
+        return normalizePath;
+    }
+});
+const _path = /*#__PURE__*/ _interop_require_default(require("path"));
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+function normalizePath(file) {
+    return _path.default.sep === '\\' ? file.replace(/\\/g, '/') : file;
+}
+
+//# sourceMappingURL=normalize-path.js.map

package/dist/string/normalize-path.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../string/normalize-path.ts"],"sourcesContent":["import path from 'path'\n\nexport function normalizePath(file: string) {\n  return path.sep === '\\\\' ? file.replace(/\\\\/g, '/') : file\n}\n"],"names":["normalizePath","file","path","sep","replace"],"mappings":";;;;+BAEgBA;;;eAAAA;;;6DAFC;;;;;;AAEV,SAASA,cAAcC,IAAY;IACxC,OAAOC,aAAI,CAACC,GAAG,KAAK,OAAOF,KAAKG,OAAO,CAAC,OAAO,OAAOH;AACxD","ignoreList":[0]}

package/dist/string/oxford-comma-list.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "getOxfordCommaList", {
+    enumerable: true,
+    get: function() {
+        return getOxfordCommaList;
+    }
+});
+function getOxfordCommaList(items) {
+    return items.map((v, index, { length })=>(index > 0 ? index === length - 1 ? length > 2 ? ', and ' : ' and ' : ', ' : '') + v).join('');
+}
+
+//# sourceMappingURL=oxford-comma-list.js.map

package/dist/string/oxford-comma-list.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../string/oxford-comma-list.ts"],"sourcesContent":["export function getOxfordCommaList(items: string[]): string {\n  return items\n    .map(\n      (v, index, { length }) =>\n        (index > 0\n          ? index === length - 1\n            ? length > 2\n              ? ', and '\n              : ' and '\n            : ', '\n          : '') + v\n    )\n    .join('')\n}\n"],"names":["getOxfordCommaList","items","map","v","index","length","join"],"mappings":";;;;+BAAgBA;;;eAAAA;;;AAAT,SAASA,mBAAmBC,KAAe;IAChD,OAAOA,MACJC,GAAG,CACF,CAACC,GAAGC,OAAO,EAAEC,MAAM,EAAE,GACnB,AAACD,CAAAA,QAAQ,IACLA,UAAUC,SAAS,IACjBA,SAAS,IACP,WACA,UACF,OACF,EAAC,IAAKF,GAEbG,IAAI,CAAC;AACV","ignoreList":[0]}

package/dist/string/pretty-bytes.js

@@ -0,0 +1,74 @@
+/*
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+*/ "use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return prettyBytes;
+    }
+});
+const UNITS = [
+    'B',
+    'kB',
+    'MB',
+    'GB',
+    'TB',
+    'PB',
+    'EB',
+    'ZB',
+    'YB'
+];
+/*
+Formats the given number using `Number#toLocaleString`.
+- If locale is a string, the value is expected to be a locale-key (for example: `de`).
+- If locale is true, the system default locale is used for translation.
+- If no value for locale is specified, the number is returned unmodified.
+*/ const toLocaleString = (number, locale)=>{
+    let result = number;
+    if (typeof locale === 'string') {
+        result = number.toLocaleString(locale);
+    } else if (locale === true) {
+        result = number.toLocaleString();
+    }
+    return result;
+};
+function prettyBytes(number, options) {
+    if (!Number.isFinite(number)) {
+        throw Object.defineProperty(new TypeError(`Expected a finite number, got ${typeof number}: ${number}`), "__NEXT_ERROR_CODE", {
+            value: "E572",
+            enumerable: false,
+            configurable: true
+        });
+    }
+    options = Object.assign({}, options);
+    if (options.signed && number === 0) {
+        return ' 0 B';
+    }
+    const isNegative = number < 0;
+    const prefix = isNegative ? '-' : options.signed ? '+' : '';
+    if (isNegative) {
+        number = -number;
+    }
+    if (number < 1) {
+        const numberString = toLocaleString(number, options.locale);
+        return prefix + numberString + ' B';
+    }
+    const exponent = Math.min(Math.floor(Math.log10(number) / 3), UNITS.length - 1);
+    number = Number((number / Math.pow(1000, exponent)).toPrecision(3));
+    const numberString = toLocaleString(number, options.locale);
+    const unit = UNITS[exponent];
+    return prefix + numberString + ' ' + unit;
+}
+
+//# sourceMappingURL=pretty-bytes.js.map

package/dist/string/pretty-bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../string/pretty-bytes.ts"],"sourcesContent":["/*\nMIT License\n\nCopyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n*/\n\nconst UNITS = ['B', 'kB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']\n\n/*\nFormats the given number using `Number#toLocaleString`.\n- If locale is a string, the value is expected to be a locale-key (for example: `de`).\n- If locale is true, the system default locale is used for translation.\n- If no value for locale is specified, the number is returned unmodified.\n*/\nconst toLocaleString = (number: number, locale: any) => {\n  let result: any = number\n  if (typeof locale === 'string') {\n    result = number.toLocaleString(locale)\n  } else if (locale === true) {\n    result = number.toLocaleString()\n  }\n\n  return result\n}\n\nexport default function prettyBytes(number: number, options?: any): string {\n  if (!Number.isFinite(number)) {\n    throw new TypeError(\n      `Expected a finite number, got ${typeof number}: ${number}`\n    )\n  }\n\n  options = Object.assign({}, options)\n\n  if (options.signed && number === 0) {\n    return ' 0 B'\n  }\n\n  const isNegative = number < 0\n  const prefix = isNegative ? '-' : options.signed ? '+' : ''\n\n  if (isNegative) {\n    number = -number\n  }\n\n  if (number < 1) {\n    const numberString = toLocaleString(number, options.locale)\n    return prefix + numberString + ' B'\n  }\n\n  const exponent = Math.min(\n    Math.floor(Math.log10(number) / 3),\n    UNITS.length - 1\n  )\n\n  number = Number((number / Math.pow(1000, exponent)).toPrecision(3))\n  const numberString = toLocaleString(number, options.locale)\n\n  const unit = UNITS[exponent]\n\n  return prefix + numberString + ' ' + unit\n}\n"],"names":["prettyBytes","UNITS","toLocaleString","number","locale","result","options","Number","isFinite","TypeError","Object","assign","signed","isNegative","prefix","numberString","exponent","Math","min","floor","log10","length","pow","toPrecision","unit"],"mappings":"AAAA;;;;;;;;;;AAUA;;;;+BAqBA;;;eAAwBA;;;AAnBxB,MAAMC,QAAQ;IAAC;IAAK;IAAM;IAAM;IAAM;IAAM;IAAM;IAAM;IAAM;CAAK;AAEnE;;;;;AAKA,GACA,MAAMC,iBAAiB,CAACC,QAAgBC;IACtC,IAAIC,SAAcF;IAClB,IAAI,OAAOC,WAAW,UAAU;QAC9BC,SAASF,OAAOD,cAAc,CAACE;IACjC,OAAO,IAAIA,WAAW,MAAM;QAC1BC,SAASF,OAAOD,cAAc;IAChC;IAEA,OAAOG;AACT;AAEe,SAASL,YAAYG,MAAc,EAAEG,OAAa;IAC/D,IAAI,CAACC,OAAOC,QAAQ,CAACL,SAAS;QAC5B,MAAM,qBAEL,CAFK,IAAIM,UACR,CAAC,8BAA8B,EAAE,OAAON,OAAO,EAAE,EAAEA,QAAQ,GADvD,qBAAA;mBAAA;wBAAA;0BAAA;QAEN;IACF;IAEAG,UAAUI,OAAOC,MAAM,CAAC,CAAC,GAAGL;IAE5B,IAAIA,QAAQM,MAAM,IAAIT,WAAW,GAAG;QAClC,OAAO;IACT;IAEA,MAAMU,aAAaV,SAAS;IAC5B,MAAMW,SAASD,aAAa,MAAMP,QAAQM,MAAM,GAAG,MAAM;IAEzD,IAAIC,YAAY;QACdV,SAAS,CAACA;IACZ;IAEA,IAAIA,SAAS,GAAG;QACd,MAAMY,eAAeb,eAAeC,QAAQG,QAAQF,MAAM;QAC1D,OAAOU,SAASC,eAAe;IACjC;IAEA,MAAMC,WAAWC,KAAKC,GAAG,CACvBD,KAAKE,KAAK,CAACF,KAAKG,KAAK,CAACjB,UAAU,IAChCF,MAAMoB,MAAM,GAAG;IAGjBlB,SAASI,OAAO,AAACJ,CAAAA,SAASc,KAAKK,GAAG,CAAC,MAAMN,SAAQ,EAAGO,WAAW,CAAC;IAChE,MAAMR,eAAeb,eAAeC,QAAQG,QAAQF,MAAM;IAE1D,MAAMoB,OAAOvB,KAAK,CAACe,SAAS;IAE5B,OAAOF,SAASC,eAAe,MAAMS;AACvC","ignoreList":[0]}

package/dist/telemetry/anonymous-meta.js

@@ -81,7 +81,7 @@ function getAnonymousMeta() {
         isWsl: _iswsl.default,
         isCI: _ciinfo.isCI,
         ciName: _ciinfo.isCI && _ciinfo.name || null,
-        nextVersion: "16.2.0"
+        nextVersion: "16.3.0"
     };
     return traits;
 }

package/dist/telemetry/events/session-stopped.js

@@ -11,11 +11,11 @@ Object.defineProperty(exports, "eventCliSessionStopped", {
 const EVENT_VERSION = 'NEXT_CLI_SESSION_STOPPED';
 function eventCliSessionStopped(event) {
     // This should be an invariant, if it fails our build tooling is broken.
-    if (typeof "16.2.0" !== 'string') {
+    if (typeof "16.3.0" !== 'string') {
         return [];
     }
     const payload = {
-        nextVersion: "16.2.0",
+        nextVersion: "16.3.0",
         nodeVersion: process.version,
         cliCommand: event.cliCommand,
         durationMilliseconds: event.durationMilliseconds,

package/dist/telemetry/events/version.js

@@ -12,12 +12,12 @@ const EVENT_VERSION = 'NEXT_CLI_SESSION_STARTED';
 function eventCliSession(nextConfig, event) {
     var _nextConfig_experimental_staleTimes, _nextConfig_experimental_staleTimes1, _nextConfig_reactCompiler, _nextConfig_reactCompiler1;
     // This should be an invariant, if it fails our build tooling is broken.
-    if (typeof "16.2.0" !== 'string') {
+    if (typeof "16.3.0" !== 'string') {
         return [];
     }
     const { images, i18n } = nextConfig || {};
     const payload = {
-        nextVersion: "16.2.0",
+        nextVersion: "16.3.0",
         nodeVersion: process.version,
         cliCommand: event.cliCommand,
         isSrcDir: event.isSrcDir,

package/dist/typescript/diagnosticFormatter.js

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "getFormattedDiagnostic", {
+    enumerable: true,
+    get: function() {
+        return getFormattedDiagnostic;
+    }
+});
+const _picocolors = require("../lib/picocolors");
+const _path = /*#__PURE__*/ _interop_require_default(require("path"));
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+function getFormattedLinkDiagnosticMessageText(diagnostic) {
+    const message = diagnostic.messageText;
+    if (typeof message === 'string' && diagnostic.code === 2322) {
+        const match = message.match(/Type '"(.+)"' is not assignable to type 'RouteImpl<.+> \| UrlObject'\./) || message.match(/Type '"(.+)"' is not assignable to type 'UrlObject \| RouteImpl<.+>'\./);
+        if (match) {
+            const [, href] = match;
+            return `"${(0, _picocolors.bold)(href)}" is not an existing route. If it is intentional, please type it explicitly with \`as Route\`.`;
+        } else if (message === "Type 'string' is not assignable to type 'UrlObject'.") {
+            var _diagnostic_relatedInformation_, _diagnostic_relatedInformation;
+            const relatedMessage = (_diagnostic_relatedInformation = diagnostic.relatedInformation) == null ? void 0 : (_diagnostic_relatedInformation_ = _diagnostic_relatedInformation[0]) == null ? void 0 : _diagnostic_relatedInformation_.messageText;
+            if (typeof relatedMessage === 'string' && relatedMessage.match(/The expected type comes from property 'href' which is declared here on type 'IntrinsicAttributes & /)) {
+                return `Invalid \`href\` property of \`Link\`: the route does not exist. If it is intentional, please type it explicitly with \`as Route\`.`;
+            }
+        }
+    } else if (typeof message === 'string' && diagnostic.code === 2820) {
+        const match = message.match(/Type '"(.+)"' is not assignable to type 'RouteImpl<.+> \| UrlObject'\. Did you mean '"(.+)"'?/) || message.match(/Type '"(.+)"' is not assignable to type 'UrlObject \| RouteImpl<.+>'\. Did you mean '"(.+)"'?/);
+        if (match) {
+            const [, href, suggestion] = match;
+            return `"${(0, _picocolors.bold)(href)}" is not an existing route. Did you mean "${(0, _picocolors.bold)(suggestion)}" instead? If it is intentional, please type it explicitly with \`as Route\`.`;
+        }
+    }
+}
+function getFormattedLayoutAndPageDiagnosticMessageText(relativeSourceFilepath, diagnostic) {
+    const message = typeof diagnostic.messageText === 'string' ? diagnostic : diagnostic.messageText;
+    const messageText = message.messageText;
+    if (typeof messageText === 'string') {
+        const type = /page\.[^.]+$/.test(relativeSourceFilepath) ? 'Page' : /route\.[^.]+$/.test(relativeSourceFilepath) ? 'Route' : 'Layout';
+        // Reference of error codes:
+        // https://github.com/Microsoft/TypeScript/blob/main/src/compiler/diagnosticMessages.json
+        switch(message.code){
+            case 2344:
+                const filepathAndType = messageText.match(/typeof import\("(.+)"\)/);
+                if (filepathAndType) {
+                    let main = `${type} "${(0, _picocolors.bold)(relativeSourceFilepath)}" does not match the required types of a Next.js ${type}.`;
+                    function processNext(indent, next) {
+                        if (!next) return;
+                        for (const item of next){
+                            switch(item.code){
+                                case 2200:
+                                    const mismatchedField = item.messageText.match(/The types of '(.+)'/);
+                                    if (mismatchedField) {
+                                        main += '\n' + ' '.repeat(indent * 2);
+                                        main += `"${(0, _picocolors.bold)(mismatchedField[1])}" has the wrong type:`;
+                                    }
+                                    break;
+                                case 2322:
+                                    const types = item.messageText.match(/Type '(.+)' is not assignable to type '(.+)'./);
+                                    if (types) {
+                                        main += '\n' + ' '.repeat(indent * 2);
+                                        if (types[2] === 'PageComponent' || types[2] === 'LayoutComponent') {
+                                            main += `The exported ${type} component isn't correctly typed.`;
+                                        } else {
+                                            main += `Expected "${(0, _picocolors.bold)(types[2].replace('"__invalid_negative_number__"', 'number (>= 0)'))}", got "${(0, _picocolors.bold)(types[1])}".`;
+                                        }
+                                    }
+                                    break;
+                                case 2326:
+                                    const invalidConfig = item.messageText.match(/Types of property '(.+)' are incompatible\./);
+                                    main += '\n' + ' '.repeat(indent * 2);
+                                    main += `Invalid configuration${invalidConfig ? ` "${(0, _picocolors.bold)(invalidConfig[1])}"` : ''}:`;
+                                    break;
+                                case 2530:
+                                    const invalidField = item.messageText.match(/Property '(.+)' is incompatible with index signature/);
+                                    if (invalidField) {
+                                        main += '\n' + ' '.repeat(indent * 2);
+                                        main += `"${(0, _picocolors.bold)(invalidField[1])}" is not a valid ${type} export field.`;
+                                    }
+                                    return;
+                                case 2739:
+                                    const invalidProp = item.messageText.match(/Type '(.+)' is missing the following properties from type '(.+)'/);
+                                    if (invalidProp) {
+                                        if (invalidProp[1] === 'LayoutProps' || invalidProp[1] === 'PageProps') {
+                                            main += '\n' + ' '.repeat(indent * 2);
+                                            main += `Prop "${invalidProp[2]}" is incompatible with the ${type}.`;
+                                        }
+                                    }
+                                    break;
+                                case 2559:
+                                    const invalid = item.messageText.match(/Type '(.+)' has/);
+                                    if (invalid) {
+                                        main += '\n' + ' '.repeat(indent * 2);
+                                        main += `Type "${(0, _picocolors.bold)(invalid[1])}" isn't allowed.`;
+                                    }
+                                    break;
+                                case 2741:
+                                    const incompatPageProp = item.messageText.match(/Property '(.+)' is missing in type 'PageProps'/);
+                                    if (incompatPageProp) {
+                                        main += '\n' + ' '.repeat(indent * 2);
+                                        main += `Prop "${(0, _picocolors.bold)(incompatPageProp[1])}" will never be passed. Remove it from the component's props.`;
+                                    } else {
+                                        const extraLayoutProp = item.messageText.match(/Property '(.+)' is missing in type 'LayoutProps' but required in type '(.+)'/);
+                                        if (extraLayoutProp) {
+                                            main += '\n' + ' '.repeat(indent * 2);
+                                            main += `Prop "${(0, _picocolors.bold)(extraLayoutProp[1])}" is not valid for this Layout, remove it to fix.`;
+                                        }
+                                    }
+                                    break;
+                                default:
+                            }
+                            processNext(indent + 1, item.next);
+                        }
+                    }
+                    if ('next' in message) processNext(1, message.next);
+                    return main;
+                }
+                const invalidExportFnArg = messageText.match(/Type 'OmitWithTag<(.+), .+, "(.+)">' does not satisfy the constraint/);
+                if (invalidExportFnArg) {
+                    const main = `${type} "${(0, _picocolors.bold)(relativeSourceFilepath)}" has an invalid "${(0, _picocolors.bold)(invalidExportFnArg[2])}" export:\n  Type "${(0, _picocolors.bold)(invalidExportFnArg[1])}" is not valid.`;
+                    return main;
+                }
+                function processNextItems(indent, next) {
+                    if (!next) return '';
+                    let result = '';
+                    for (const item of next){
+                        switch(item.code){
+                            case 2322:
+                                const types = item.messageText.match(/Type '(.+)' is not assignable to type '(.+)'./);
+                                if (types) {
+                                    result += '\n' + ' '.repeat(indent * 2);
+                                    result += `Expected "${(0, _picocolors.bold)(types[2])}", got "${(0, _picocolors.bold)(types[1])}".`;
+                                }
+                                break;
+                            default:
+                        }
+                        result += processNextItems(indent + 1, item.next);
+                    }
+                    return result;
+                }
+                const invalidParamFn = messageText.match(/Type '{ __tag__: (.+); __param_position__: "(.*)"; __param_type__: (.+); }' does not satisfy/);
+                if (invalidParamFn) {
+                    let main = `${type} "${(0, _picocolors.bold)(relativeSourceFilepath)}" has an invalid ${invalidParamFn[1]} export:\n  Type "${(0, _picocolors.bold)(invalidParamFn[3])}" is not a valid type for the function's ${invalidParamFn[2]} argument.`;
+                    if ('next' in message) main += processNextItems(1, message.next);
+                    return main;
+                }
+                const invalidExportFnReturn = messageText.match(/Type '{ __tag__: "(.+)"; __return_type__: (.+); }' does not satisfy/);
+                if (invalidExportFnReturn) {
+                    let main = `${type} "${(0, _picocolors.bold)(relativeSourceFilepath)}" has an invalid export:\n  "${(0, _picocolors.bold)(invalidExportFnReturn[2])}" is not a valid ${invalidExportFnReturn[1]} return type:`;
+                    if ('next' in message) main += processNextItems(1, message.next);
+                    return main;
+                }
+                break;
+            case 2345:
+                const filepathAndInvalidExport = messageText.match(/'typeof import\("(.+)"\)'.+Impossible<"(.+)">/);
+                if (filepathAndInvalidExport) {
+                    const main = `${type} "${(0, _picocolors.bold)(relativeSourceFilepath)}" exports an invalid "${(0, _picocolors.bold)(filepathAndInvalidExport[2])}" field. ${type} should only export a default React component and configuration options. Learn more: https://nextjs.org/docs/messages/invalid-segment-export`;
+                    return main;
+                }
+                break;
+            case 2559:
+                const invalid = messageText.match(/Type '(.+)' has no properties in common with type '(.+)'/);
+                if (invalid) {
+                    const main = `${type} "${(0, _picocolors.bold)(relativeSourceFilepath)}" contains an invalid type "${(0, _picocolors.bold)(invalid[1])}" as ${invalid[2]}.`;
+                    return main;
+                }
+                break;
+            default:
+        }
+    }
+}
+function getAppEntrySourceFilePath(baseDir, diagnostic) {
+    var _diagnostic_file_text_trim_match, _diagnostic_file;
+    const sourceFilepath = ((_diagnostic_file = diagnostic.file) == null ? void 0 : (_diagnostic_file_text_trim_match = _diagnostic_file.text.trim().match(/^\/\/ File: (.+)\n/)) == null ? void 0 : _diagnostic_file_text_trim_match[1]) || '';
+    return _path.default.relative(baseDir, sourceFilepath);
+}
+function getFormattedDiagnostic(ts, baseDir, distDir, diagnostic, isAppDirEnabled) {
+    var _diagnostic_file;
+    // If the error comes from .next/types/, we handle it specially.
+    const isLayoutOrPageError = isAppDirEnabled && ((_diagnostic_file = diagnostic.file) == null ? void 0 : _diagnostic_file.fileName.startsWith(_path.default.join(baseDir, distDir, 'types')));
+    let message = '';
+    const appPath = isLayoutOrPageError ? getAppEntrySourceFilePath(baseDir, diagnostic) : null;
+    const linkReason = getFormattedLinkDiagnosticMessageText(diagnostic);
+    const appReason = !linkReason && isLayoutOrPageError && appPath ? getFormattedLayoutAndPageDiagnosticMessageText(appPath, diagnostic) : null;
+    const reason = linkReason || appReason || ts.flattenDiagnosticMessageText(diagnostic.messageText, '\n');
+    const category = diagnostic.category;
+    switch(category){
+        // Warning
+        case ts.DiagnosticCategory.Warning:
+            {
+                message += (0, _picocolors.yellow)((0, _picocolors.bold)('Type warning')) + ': ';
+                break;
+            }
+        // Error
+        case ts.DiagnosticCategory.Error:
+            {
+                message += (0, _picocolors.red)((0, _picocolors.bold)('Type error')) + ': ';
+                break;
+            }
+        // 2 = Suggestion, 3 = Message
+        case ts.DiagnosticCategory.Suggestion:
+        case ts.DiagnosticCategory.Message:
+            message += (0, _picocolors.cyan)((0, _picocolors.bold)(category === 2 ? 'Suggestion' : 'Info')) + ': ';
+            break;
+        default:
+            {
+                category;
+            }
+    }
+    message += reason + '\n';
+    if (!isLayoutOrPageError && diagnostic.file) {
+        const { codeFrameColumns } = require('next/dist/compiled/babel/code-frame');
+        const pos = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);
+        const line = pos.line + 1;
+        const character = pos.character + 1;
+        let fileName = _path.default.posix.normalize(_path.default.relative(baseDir, diagnostic.file.fileName).replace(/\\/g, '/'));
+        if (!fileName.startsWith('.')) {
+            fileName = './' + fileName;
+        }
+        message = (0, _picocolors.cyan)(fileName) + ':' + (0, _picocolors.yellow)(line.toString()) + ':' + (0, _picocolors.yellow)(character.toString()) + '\n' + message;
+        message += '\n' + codeFrameColumns(diagnostic.file.getFullText(diagnostic.file.getSourceFile()), {
+            start: {
+                line: line,
+                column: character
+            }
+        }, {
+            forceColor: true
+        });
+    } else if (isLayoutOrPageError && appPath) {
+        message = (0, _picocolors.cyan)(appPath) + '\n' + message;
+    }
+    return message;
+}
+
+//# sourceMappingURL=diagnosticFormatter.js.map