mirror of
https://github.com/nuxt/nuxt.git
synced 2024-11-28 16:42:04 +00:00
125 lines
3.3 KiB
TypeScript
125 lines
3.3 KiB
TypeScript
import type { Nitro, NitroDevEventHandler, NitroEventHandler } from 'nitro/types'
|
|
import type { Import } from 'unimport'
|
|
import { normalize } from 'pathe'
|
|
import { useNuxt } from './context'
|
|
import { toArray } from './utils'
|
|
|
|
const HANDLER_METHOD_RE = /\.(get|head|patch|post|put|delete|connect|options|trace)(\.\w+)*$/
|
|
/**
|
|
* normalize handler object
|
|
*
|
|
*/
|
|
function normalizeHandlerMethod (handler: NitroEventHandler) {
|
|
// retrieve method from handler file name
|
|
const [, method = undefined] = handler.handler.match(HANDLER_METHOD_RE) || []
|
|
return {
|
|
method: method as 'get' | 'head' | 'patch' | 'post' | 'put' | 'delete' | 'connect' | 'options' | 'trace' | undefined,
|
|
...handler,
|
|
handler: normalize(handler.handler),
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Adds a nitro server handler
|
|
*
|
|
*/
|
|
export function addServerHandler (handler: NitroEventHandler) {
|
|
useNuxt().options.serverHandlers.push(normalizeHandlerMethod(handler))
|
|
}
|
|
|
|
/**
|
|
* Adds a nitro server handler for development-only
|
|
*
|
|
*/
|
|
export function addDevServerHandler (handler: NitroDevEventHandler) {
|
|
useNuxt().options.devServerHandlers.push(handler)
|
|
}
|
|
|
|
/**
|
|
* Adds a Nitro plugin
|
|
*/
|
|
export function addServerPlugin (plugin: string) {
|
|
const nuxt = useNuxt()
|
|
nuxt.options.nitro.plugins = nuxt.options.nitro.plugins || []
|
|
nuxt.options.nitro.plugins.push(normalize(plugin))
|
|
}
|
|
|
|
/**
|
|
* Adds routes to be prerendered
|
|
*/
|
|
export function addPrerenderRoutes (routes: string | string[]) {
|
|
const nuxt = useNuxt()
|
|
|
|
routes = toArray(routes).filter(Boolean)
|
|
if (!routes.length) {
|
|
return
|
|
}
|
|
nuxt.hook('prerender:routes', (ctx) => {
|
|
for (const route of routes) {
|
|
ctx.routes.add(route)
|
|
}
|
|
})
|
|
}
|
|
|
|
/**
|
|
* Access to the Nitro instance
|
|
*
|
|
* **Note:** You can call `useNitro()` only after `ready` hook.
|
|
*
|
|
* **Note:** Changes to the Nitro instance configuration are not applied.
|
|
* @example
|
|
*
|
|
* ```ts
|
|
* nuxt.hook('ready', () => {
|
|
* console.log(useNitro())
|
|
* })
|
|
* ```
|
|
*/
|
|
export function useNitro (): Nitro {
|
|
const nuxt = useNuxt()
|
|
if (!(nuxt as any)._nitro) {
|
|
throw new Error('Nitro is not initialized yet. You can call `useNitro()` only after `ready` hook.')
|
|
}
|
|
return (nuxt as any)._nitro
|
|
}
|
|
|
|
/**
|
|
* Add server imports to be auto-imported by Nitro
|
|
*/
|
|
export function addServerImports (imports: Import[]) {
|
|
const nuxt = useNuxt()
|
|
nuxt.hook('nitro:config', (config) => {
|
|
config.imports = config.imports || {}
|
|
config.imports.imports = config.imports.imports || []
|
|
config.imports.imports.push(...imports)
|
|
})
|
|
}
|
|
|
|
/**
|
|
* Add directories to be scanned for auto-imports by Nitro
|
|
*/
|
|
export function addServerImportsDir (dirs: string | string[], opts: { prepend?: boolean } = {}) {
|
|
const nuxt = useNuxt()
|
|
const _dirs = toArray(dirs)
|
|
nuxt.hook('nitro:config', (config) => {
|
|
config.imports = config.imports || {}
|
|
config.imports.dirs = config.imports.dirs || []
|
|
config.imports.dirs[opts.prepend ? 'unshift' : 'push'](..._dirs)
|
|
})
|
|
}
|
|
|
|
/**
|
|
* Add directories to be scanned by Nitro. It will check for subdirectories,
|
|
* which will be registered just like the `~/server` folder is.
|
|
*/
|
|
export function addServerScanDir (dirs: string | string[], opts: { prepend?: boolean } = {}) {
|
|
const nuxt = useNuxt()
|
|
nuxt.hook('nitro:config', (config) => {
|
|
config.scanDirs = config.scanDirs || []
|
|
|
|
for (const dir of toArray(dirs)) {
|
|
config.scanDirs[opts.prepend ? 'unshift' : 'push'](dir)
|
|
}
|
|
})
|
|
}
|