import { existsSync, promises as fsp, readFileSync } from 'node:fs' import { cpus } from 'node:os' import { join, normalize, relative, resolve } from 'pathe' import { createRouter as createRadixRouter, exportMatcher, toRouteMatcher } from 'radix3' import { randomUUID } from 'uncrypto' import { joinURL, withTrailingSlash } from 'ufo' import { build, copyPublicAssets, createDevServer, createNitro, prepare, prerender, scanHandlers, writeTypes } from 'nitropack' import type { Nitro, NitroConfig } from 'nitropack' import { logger, resolveIgnorePatterns, resolveNuxtModule } from '@nuxt/kit' import escapeRE from 'escape-string-regexp' import { defu } from 'defu' import fsExtra from 'fs-extra' import { dynamicEventHandler } from 'h3' import type { Nuxt, RuntimeConfig } from 'nuxt/schema' // @ts-expect-error TODO: add legacy type support for subpath imports import { template as defaultSpaLoadingTemplate } from '@nuxt/ui-templates/templates/spa-loading-icon.mjs' import { version as nuxtVersion } from '../../package.json' import { distDir } from '../dirs' import { ImportProtectionPlugin } from './plugins/import-protection' export async function initNitro (nuxt: Nuxt & { _nitro?: Nitro }) { // Resolve config const _nitroConfig = ((nuxt.options as any).nitro || {}) as NitroConfig const excludePaths = nuxt.options._layers .flatMap(l => [ l.cwd.match(/(?<=\/)node_modules\/(.+)$/)?.[1], l.cwd.match(/\.pnpm\/.+\/node_modules\/(.+)$/)?.[1] ]) .filter((dir): dir is string => Boolean(dir)) .map(dir => escapeRE(dir)) const excludePattern = excludePaths.length ? [new RegExp(`node_modules\\/(?!${excludePaths.join('|')})`)] : [/node_modules/] const rootDirWithSlash = withTrailingSlash(nuxt.options.rootDir) const modules = await resolveNuxtModule(rootDirWithSlash, nuxt.options._installedModules .filter(m => m.entryPath) .map(m => m.entryPath) ) const nitroConfig: NitroConfig = defu(_nitroConfig, { debug: nuxt.options.debug, rootDir: nuxt.options.rootDir, workspaceDir: nuxt.options.workspaceDir, srcDir: nuxt.options.serverDir, dev: nuxt.options.dev, buildDir: nuxt.options.buildDir, experimental: { asyncContext: nuxt.options.experimental.asyncContext, typescriptBundlerResolution: nuxt.options.experimental.typescriptBundlerResolution || nuxt.options.typescript?.tsConfig?.compilerOptions?.moduleResolution?.toLowerCase() === 'bundler' || _nitroConfig.typescript?.tsConfig?.compilerOptions?.moduleResolution?.toLowerCase() === 'bundler' }, framework: { name: 'nuxt', version: nuxtVersion }, imports: { autoImport: nuxt.options.imports.autoImport as boolean, imports: [ { as: '__buildAssetsURL', name: 'buildAssetsURL', from: resolve(distDir, 'core/runtime/nitro/paths') }, { as: '__publicAssetsURL', name: 'publicAssetsURL', from: resolve(distDir, 'core/runtime/nitro/paths') }, { // TODO: Remove after https://github.com/unjs/nitro/issues/1049 as: 'defineAppConfig', name: 'defineAppConfig', from: resolve(distDir, 'core/runtime/nitro/config'), priority: -1 } ], exclude: [...excludePattern, /[\\/]\.git[\\/]/] }, esbuild: { options: { exclude: excludePattern } }, analyze: nuxt.options.build.analyze && (nuxt.options.build.analyze === true || nuxt.options.build.analyze.enabled) ? { template: 'treemap', projectRoot: nuxt.options.rootDir, filename: join(nuxt.options.analyzeDir, '{name}.html') } : false, scanDirs: nuxt.options._layers.map(layer => (layer.config.serverDir || layer.config.srcDir) && resolve(layer.cwd, layer.config.serverDir || resolve(layer.config.srcDir, 'server'))).filter(Boolean), renderer: resolve(distDir, 'core/runtime/nitro/renderer'), errorHandler: resolve(distDir, 'core/runtime/nitro/error'), nodeModulesDirs: nuxt.options.modulesDir, handlers: nuxt.options.serverHandlers, devHandlers: [], baseURL: nuxt.options.app.baseURL, virtual: { '#internal/nuxt.config.mjs': () => nuxt.vfs['#build/nuxt.config'], '#spa-template': () => `export const template = ${JSON.stringify(spaLoadingTemplate(nuxt))}` }, routeRules: { '/__nuxt_error': { cache: false } }, runtimeConfig: { ...nuxt.options.runtimeConfig, app: { ...nuxt.options.runtimeConfig.app, baseURL: nuxt.options.runtimeConfig.app.baseURL.startsWith('./') ? nuxt.options.runtimeConfig.app.baseURL.slice(1) : nuxt.options.runtimeConfig.app.baseURL }, nitro: { envPrefix: 'NUXT_', // TODO: address upstream issue with defu types...? ...nuxt.options.runtimeConfig.nitro satisfies RuntimeConfig['nitro'] as any } } , appConfig: nuxt.options.appConfig, appConfigFiles: nuxt.options._layers.map( layer => resolve(layer.config.srcDir, 'app.config') ), typescript: { strict: true, generateTsConfig: true, tsconfigPath: 'tsconfig.server.json', tsConfig: { include: [ join(nuxt.options.buildDir, 'types/nitro-nuxt.d.ts'), ...modules.map(m => join(relativeWithDot(nuxt.options.buildDir, m), 'runtime/server')) ], exclude: [ ...nuxt.options.modulesDir.map(m => relativeWithDot(nuxt.options.buildDir, m)), // nitro generate output: https://github.com/nuxt/nuxt/blob/main/packages/nuxt/src/core/nitro.ts#L186 relativeWithDot(nuxt.options.buildDir, resolve(nuxt.options.rootDir, 'dist')) ] } }, publicAssets: [ nuxt.options.dev ? { dir: resolve(nuxt.options.buildDir, 'dist/client') } : { dir: join(nuxt.options.buildDir, 'dist/client', nuxt.options.app.buildAssetsDir), maxAge: 31536000 /* 1 year */, baseURL: nuxt.options.app.buildAssetsDir }, ...nuxt.options._layers .map(layer => join(layer.config.srcDir, (layer.config.rootDir === nuxt.options.rootDir ? nuxt.options : layer.config).dir?.public || 'public')) .filter(dir => existsSync(dir)) .map(dir => ({ dir })) ], prerender: { failOnError: true, concurrency: cpus().length * 4 || 4, routes: ([] as string[]).concat(nuxt.options.generate.routes) }, sourceMap: nuxt.options.sourcemap.server, externals: { inline: [ ...(nuxt.options.dev ? [] : [ ...nuxt.options.experimental.externalVue ? [] : ['vue', '@vue/'], '@nuxt/', nuxt.options.buildDir ]), ...nuxt.options.build.transpile.filter((i): i is string => typeof i === 'string'), 'nuxt/dist', 'nuxt3/dist', 'nuxt-nightly/dist', distDir ], traceInclude: [ // force include files used in generated code from the runtime-compiler ...(nuxt.options.vue.runtimeCompiler && !nuxt.options.experimental.externalVue) ? [ ...nuxt.options.modulesDir.reduce((targets, path) => { const serverRendererPath = resolve(path, 'vue/server-renderer/index.js') if (existsSync(serverRendererPath)) { targets.push(serverRendererPath) } return targets }, []) ] : [] ] }, alias: { // Vue 3 mocks ...nuxt.options.vue.runtimeCompiler || nuxt.options.experimental.externalVue ? {} : { 'estree-walker': 'unenv/runtime/mock/proxy', '@babel/parser': 'unenv/runtime/mock/proxy', '@vue/compiler-core': 'unenv/runtime/mock/proxy', '@vue/compiler-dom': 'unenv/runtime/mock/proxy', '@vue/compiler-ssr': 'unenv/runtime/mock/proxy' }, '@vue/devtools-api': 'vue-devtools-stub', // Paths '#paths': resolve(distDir, 'core/runtime/nitro/paths'), // Nuxt aliases ...nuxt.options.alias }, replace: { 'process.env.NUXT_NO_SSR': nuxt.options.ssr === false, 'process.env.NUXT_EARLY_HINTS': nuxt.options.experimental.writeEarlyHints !== false, 'process.env.NUXT_NO_SCRIPTS': !!nuxt.options.experimental.noScripts && !nuxt.options.dev, 'process.env.NUXT_INLINE_STYLES': !!nuxt.options.experimental.inlineSSRStyles, 'process.env.NUXT_JSON_PAYLOADS': !!nuxt.options.experimental.renderJsonPayloads, 'process.env.NUXT_COMPONENT_ISLANDS': !!nuxt.options.experimental.componentIslands, 'process.env.NUXT_ASYNC_CONTEXT': !!nuxt.options.experimental.asyncContext, 'process.dev': nuxt.options.dev, __VUE_PROD_DEVTOOLS__: false }, rollupConfig: { output: {}, plugins: [] } } satisfies NitroConfig) // Resolve user-provided paths nitroConfig.srcDir = resolve(nuxt.options.rootDir, nuxt.options.srcDir, nitroConfig.srcDir!) nitroConfig.ignore = [...(nitroConfig.ignore || []), ...resolveIgnorePatterns(nitroConfig.srcDir)] // Add app manifest handler and prerender configuration if (nuxt.options.experimental.appManifest) { // @ts-expect-error untyped nuxt property const buildId = nuxt.options.appConfig.nuxt!.buildId ||= (nuxt.options.dev ? 'dev' : nuxt.options.test ? 'test' : randomUUID()) const buildTimestamp = Date.now() const manifestPrefix = joinURL(nuxt.options.app.buildAssetsDir, 'builds') const tempDir = join(nuxt.options.buildDir, 'manifest') nitroConfig.prerender ||= {} nitroConfig.prerender.ignore ||= [] nitroConfig.prerender.ignore.push(manifestPrefix) nitroConfig.publicAssets!.unshift( // build manifest { dir: join(tempDir, 'meta'), maxAge: 31536000 /* 1 year */, baseURL: joinURL(manifestPrefix, 'meta') }, // latest build { dir: tempDir, maxAge: 1, baseURL: manifestPrefix } ) nuxt.hook('nitro:init', (nitro) => { nitro.hooks.hook('rollup:before', async (nitro) => { const routeRules = {} as Record const _routeRules = nitro.options.routeRules for (const key in _routeRules) { if (key === '/__nuxt_error') { continue } const filteredRules = Object.entries(_routeRules[key]) .filter(([key, value]) => ['prerender', 'redirect'].includes(key) && value) .map(([key, value]: any) => { if (key === 'redirect') { return [key, typeof value === 'string' ? value : value.to] } return [key, value] }) if (filteredRules.length > 0) { routeRules[key] = Object.fromEntries(filteredRules) } } // Add pages prerendered but not covered by route rules const prerenderedRoutes = new Set() const routeRulesMatcher = toRouteMatcher( createRadixRouter({ routes: routeRules }) ) const payloadSuffix = nuxt.options.experimental.renderJsonPayloads ? '/_payload.json' : '/_payload.js' for (const route of nitro._prerenderedRoutes || []) { if (!route.error && route.route.endsWith(payloadSuffix)) { const url = route.route.slice(0, -payloadSuffix.length) || '/' const rules = defu({}, ...routeRulesMatcher.matchAll(url).reverse()) as Record if (!rules.prerender) { prerenderedRoutes.add(url) } } } const manifest = { id: buildId, timestamp: buildTimestamp, matcher: exportMatcher(routeRulesMatcher), prerendered: nuxt.options.dev ? [] : [...prerenderedRoutes] } await fsp.mkdir(join(tempDir, 'meta'), { recursive: true }) await fsp.writeFile(join(tempDir, 'latest.json'), JSON.stringify({ id: buildId, timestamp: buildTimestamp })) await fsp.writeFile(join(tempDir, `meta/${buildId}.json`), JSON.stringify(manifest)) }) }) } // Add fallback server for `ssr: false` if (!nuxt.options.ssr) { nitroConfig.virtual!['#build/dist/server/server.mjs'] = 'export default () => {}' // In case a non-normalized absolute path is called for on Windows if (process.platform === 'win32') { nitroConfig.virtual!['#build/dist/server/server.mjs'.replace(/\//g, '\\')] = 'export default () => {}' } } if (nuxt.options.builder === '@nuxt/webpack-builder' || nuxt.options.dev) { nitroConfig.virtual!['#build/dist/server/styles.mjs'] = 'export default {}' // In case a non-normalized absolute path is called for on Windows if (process.platform === 'win32') { nitroConfig.virtual!['#build/dist/server/styles.mjs'.replace(/\//g, '\\')] = 'export default {}' } } // Add backward-compatible middleware to respect `x-nuxt-no-ssr` header if (nuxt.options.experimental.respectNoSSRHeader) { nitroConfig.handlers = nitroConfig.handlers || [] nitroConfig.handlers.push({ handler: resolve(distDir, 'core/runtime/nitro/no-ssr'), middleware: true }) } // Register nuxt protection patterns nitroConfig.rollupConfig!.plugins = await nitroConfig.rollupConfig!.plugins || [] nitroConfig.rollupConfig!.plugins = Array.isArray(nitroConfig.rollupConfig!.plugins) ? nitroConfig.rollupConfig!.plugins : [nitroConfig.rollupConfig!.plugins] nitroConfig.rollupConfig!.plugins!.push( // @ts-expect-error rollup 4 types ImportProtectionPlugin.rollup({ rootDir: nuxt.options.rootDir, patterns: [ ...['#app', /^#build(\/|$)/] .map(p => [p, 'Vue app aliases are not allowed in server routes.']) as [RegExp | string, string][] ], exclude: [/core[\\/]runtime[\\/]nitro[\\/]renderer/] }) ) // Extend nitro config with hook await nuxt.callHook('nitro:config', nitroConfig) // TODO: extract to shared utility? const excludedAlias = [/^@vue\/.*$/, '#imports', '#vue-router', 'vue-demi', /^#app/] const basePath = nitroConfig.typescript!.tsConfig!.compilerOptions?.baseUrl ? resolve(nuxt.options.buildDir, nitroConfig.typescript!.tsConfig!.compilerOptions?.baseUrl) : nuxt.options.buildDir const aliases = nitroConfig.alias! const tsConfig = nitroConfig.typescript!.tsConfig! tsConfig.compilerOptions = tsConfig.compilerOptions || {} tsConfig.compilerOptions.paths = tsConfig.compilerOptions.paths || {} for (const _alias in aliases) { const alias = _alias as keyof typeof aliases if (excludedAlias.some(pattern => typeof pattern === 'string' ? alias === pattern : pattern.test(alias))) { continue } if (alias in tsConfig.compilerOptions.paths) { continue } const absolutePath = resolve(basePath, aliases[alias]!) const stats = await fsp.stat(absolutePath).catch(() => null /* file does not exist */) if (stats?.isDirectory()) { tsConfig.compilerOptions.paths[alias] = [absolutePath] tsConfig.compilerOptions.paths[`${alias}/*`] = [`${absolutePath}/*`] } else { tsConfig.compilerOptions.paths[alias] = [absolutePath.replace(/(?<=\w)\.\w+$/g, '')] /* remove extension */ } } // Init nitro const nitro = await createNitro(nitroConfig) // Trigger Nitro reload when SPA loading template changes nuxt.hook('builder:watch', async (_event, path) => { if (normalize(path) === spaLoadingTemplatePath(nuxt)) { await nitro.hooks.callHook('rollup:reload') } }) // Set prerender-only options nitro.options._config.storage ||= {} nitro.options._config.storage['internal:nuxt:prerender'] = { driver: 'memory' } nitro.options._config.storage['internal:nuxt:prerender:island'] = { driver: 'lruCache', max: 1000 } nitro.options._config.storage['internal:nuxt:prerender:payload'] = { driver: 'lruCache', max: 1000 } // Expose nitro to modules and kit nuxt._nitro = nitro await nuxt.callHook('nitro:init', nitro) // Connect vfs storages nitro.vfs = nuxt.vfs = nitro.vfs || nuxt.vfs || {} // Connect hooks nuxt.hook('close', () => nitro.hooks.callHook('close')) nitro.hooks.hook('prerender:routes', (routes) => { return nuxt.callHook('prerender:routes', { routes }) }) // Enable runtime compiler client side if (nuxt.options.vue.runtimeCompiler) { nuxt.hook('vite:extendConfig', (config, { isClient }) => { if (isClient) { if (Array.isArray(config.resolve!.alias)) { config.resolve!.alias.push({ find: 'vue', replacement: 'vue/dist/vue.esm-bundler' }) } else { config.resolve!.alias = { ...config.resolve!.alias, vue: 'vue/dist/vue.esm-bundler' } } } }) nuxt.hook('webpack:config', (configuration) => { const clientConfig = configuration.find(config => config.name === 'client') if (!clientConfig!.resolve) { clientConfig!.resolve!.alias = {} } if (Array.isArray(clientConfig!.resolve!.alias)) { clientConfig!.resolve!.alias.push({ name: 'vue', alias: 'vue/dist/vue.esm-bundler' }) } else { clientConfig!.resolve!.alias!.vue = 'vue/dist/vue.esm-bundler' } }) } // Setup handlers const devMiddlewareHandler = dynamicEventHandler() nitro.options.devHandlers.unshift({ handler: devMiddlewareHandler }) nitro.options.devHandlers.push(...nuxt.options.devServerHandlers) nitro.options.handlers.unshift({ route: '/__nuxt_error', lazy: true, handler: resolve(distDir, 'core/runtime/nitro/renderer') }) if (!nuxt.options.dev && nuxt.options.experimental.noVueServer) { nitro.hooks.hook('rollup:before', (nitro) => { if (nitro.options.preset === 'nitro-prerender') { return } const nuxtErrorHandler = nitro.options.handlers.findIndex(h => h.route === '/__nuxt_error') if (nuxtErrorHandler >= 0) { nitro.options.handlers.splice(nuxtErrorHandler, 1) } nitro.options.renderer = undefined nitro.options.errorHandler = '#internal/nitro/error' }) } // Add typed route responses nuxt.hook('prepare:types', async (opts) => { if (!nuxt.options.dev) { await scanHandlers(nitro) await writeTypes(nitro) } // Exclude nitro output dir from typescript opts.tsConfig.exclude = opts.tsConfig.exclude || [] opts.tsConfig.exclude.push(relative(nuxt.options.buildDir, resolve(nuxt.options.rootDir, nitro.options.output.dir))) opts.references.push({ path: resolve(nuxt.options.buildDir, 'types/nitro.d.ts') }) }) if (nitro.options.static) { nitro.hooks.hook('prerender:routes', (routes) => { for (const route of [nuxt.options.ssr ? '/' : '/index.html', '/200.html', '/404.html']) { routes.add(route) } }) } // Copy public assets after prerender so app manifest can be present if (!nuxt.options.dev) { nitro.hooks.hook('rollup:before', async (nitro) => { await copyPublicAssets(nitro) await nuxt.callHook('nitro:build:public-assets', nitro) }) } // nuxt build/dev nuxt.hook('build:done', async () => { await nuxt.callHook('nitro:build:before', nitro) if (nuxt.options.dev) { await build(nitro) } else { await prepare(nitro) await prerender(nitro) logger.restoreAll() await build(nitro) logger.wrapAll() if (nitro.options.static) { const distDir = resolve(nuxt.options.rootDir, 'dist') if (!existsSync(distDir)) { await fsp.symlink(nitro.options.output.publicDir, distDir, 'junction').catch(() => {}) } } } }) // nuxt dev if (nuxt.options.dev) { nuxt.hook('webpack:compile', ({ compiler }) => { compiler.outputFileSystem = { ...fsExtra, join } as any }) nuxt.hook('webpack:compiled', () => { nuxt.server.reload() }) nuxt.hook('vite:compiled', () => { nuxt.server.reload() }) nuxt.hook('server:devHandler', (h) => { devMiddlewareHandler.set(h) }) nuxt.server = createDevServer(nitro) const waitUntilCompile = new Promise(resolve => nitro.hooks.hook('compiled', () => resolve())) nuxt.hook('build:done', () => waitUntilCompile) } } function relativeWithDot (from: string, to: string) { return relative(from, to).replace(/^([^.])/, './$1') || '.' } function spaLoadingTemplatePath (nuxt: Nuxt) { return typeof nuxt.options.spaLoadingTemplate === 'string' ? resolve(nuxt.options.srcDir, nuxt.options.spaLoadingTemplate) : resolve(nuxt.options.srcDir, 'app/spa-loading-template.html') } function spaLoadingTemplate (nuxt: Nuxt) { if (nuxt.options.spaLoadingTemplate === false) { return '' } const spaLoadingTemplate = spaLoadingTemplatePath(nuxt) try { if (existsSync(spaLoadingTemplate)) { return readFileSync(spaLoadingTemplate, 'utf-8') } } catch { // fall through if we have issues reading the file } if (nuxt.options.spaLoadingTemplate === true) { return defaultSpaLoadingTemplate({}) } if (nuxt.options.spaLoadingTemplate) { logger.warn(`Could not load custom \`spaLoadingTemplate\` path as it does not exist: \`${nuxt.options.spaLoadingTemplate}\`.`) } return '' }