Move createError utility to its own package (fastify#2339)

Author: delvedor

docs/Plugins-Guide.md

@@ -12,6 +12,7 @@ Fastify was built from the beginning to be an extremely modular system. We built
 - [How to handle encapsulation and distribution](#distribution)
 - [ESM support](#esm-support)
 - [Handle errors](#handle-errors)
+- [Custom errors](#custom-errors)
 - [Let's start!](#start)
 
 <a name="register"></a>
@@ -319,6 +320,16 @@ fastify
   })
 ```
 
+<a name="custom-errors"></a>
+## Custom errors
+If your plugin needs to expose custom errors, you can easily generate consistent error objects across your codebase and plugins with the [`fastify-error`](https://github.com/fastify/fastify-error) module.
+
+```js
+const createError = require('fastify-error')
+const CustomError = createError('ERROR_CODE', 'message')
+console.log(new CustomError())
+```
+
 <a name="start"></a>
 ## Let's start!
 Awesome, now you know everything you need to know about Fastify and its plugin system to start building your first plugin, and please if you do, tell us! We will add it to the [*ecosystem*](https://github.com/fastify/fastify#ecosystem) section of our documentation!

fastify.d.ts

@@ -9,7 +9,7 @@ import { FastifyLoggerInstance, FastifyLoggerOptions } from './types/logger'
 import { FastifyInstance } from './types/instance'
 import { FastifyServerFactory } from './types/serverFactory'
 import * as ajv from 'ajv'
-import { FastifyError } from './types/error'
+import { FastifyError } from 'fastify-error'
 import { FastifyReply } from './types/reply'
 
 /**
@@ -126,7 +126,7 @@ export { FastifyContext } from './types/context'
 export { RouteHandlerMethod, RouteOptions, RouteShorthandMethod, RouteShorthandOptions, RouteShorthandOptionsWithHandler } from './types/route'
 export * from './types/register'
 export { FastifyBodyParser, FastifyContentTypeParser, AddContentTypeParser, hasContentTypeParser } from './types/content-type-parser'
-export { FastifyError, ValidationResult } from './types/error'
+export { FastifyError, ValidationResult } from 'fastify-error'
 export { FastifySchema, FastifySchemaCompiler } from './types/schema'
 export { HTTPMethods, RawServerBase, RawRequestDefaultExpression, RawReplyDefaultExpression, RawServerDefault, ContextConfigDefault, RequestBodyDefault, RequestQuerystringDefault, RequestParamsDefault, RequestHeadersDefault } from './types/utils'
 export * from './types/hooks'

fastify.js

@@ -42,10 +42,8 @@ const build404 = require('./lib/fourOhFour')
 const getSecuredInitialConfig = require('./lib/initialConfigValidation')
 const { defaultInitOptions } = getSecuredInitialConfig
 const {
-  codes: {
-    FST_ERR_BAD_URL,
-    FST_ERR_MISSING_MIDDLEWARE
-  }
+  FST_ERR_BAD_URL,
+  FST_ERR_MISSING_MIDDLEWARE
 } = require('./lib/errors')
 
 function fastify (options) {

lib/contentTypeParser.js

@@ -12,17 +12,15 @@ const {
 } = require('./symbols')
 
 const {
-  codes: {
-    FST_ERR_CTP_INVALID_TYPE,
-    FST_ERR_CTP_EMPTY_TYPE,
-    FST_ERR_CTP_ALREADY_PRESENT,
-    FST_ERR_CTP_INVALID_HANDLER,
-    FST_ERR_CTP_INVALID_PARSE_TYPE,
-    FST_ERR_CTP_BODY_TOO_LARGE,
-    FST_ERR_CTP_INVALID_MEDIA_TYPE,
-    FST_ERR_CTP_INVALID_CONTENT_LENGTH,
-    FST_ERR_CTP_EMPTY_JSON_BODY
-  }
+  FST_ERR_CTP_INVALID_TYPE,
+  FST_ERR_CTP_EMPTY_TYPE,
+  FST_ERR_CTP_ALREADY_PRESENT,
+  FST_ERR_CTP_INVALID_HANDLER,
+  FST_ERR_CTP_INVALID_PARSE_TYPE,
+  FST_ERR_CTP_BODY_TOO_LARGE,
+  FST_ERR_CTP_INVALID_MEDIA_TYPE,
+  FST_ERR_CTP_INVALID_CONTENT_LENGTH,
+  FST_ERR_CTP_EMPTY_JSON_BODY
 } = require('./errors')
 const { emitWarning } = require('./warnings')
 

lib/decorate.js

@@ -9,11 +9,9 @@ const {
 } = require('./symbols.js')
 
 const {
-  codes: {
-    FST_ERR_DEC_ALREADY_PRESENT,
-    FST_ERR_DEC_MISSING_DEPENDENCY,
-    FST_ERR_DEC_AFTER_START
-  }
+  FST_ERR_DEC_ALREADY_PRESENT,
+  FST_ERR_DEC_MISSING_DEPENDENCY,
+  FST_ERR_DEC_AFTER_START
 } = require('./errors')
 
 function decorate (instance, name, fn, dependencies) {