feat: allow boomifying any value (hapijs#291)

Creation of a new boomifyAny that allows creating a boom error from an
"unknown" value.

Refs hapijs#291

lib/index.d.ts

@@ -153,6 +153,17 @@ export function isBoom(obj: unknown, statusCode?: number): obj is Boom;
 export function boomify<Data, Decoration>(err: Error, options?: Options<Data> & Decorate<Decoration>): Boom<Data> & Decoration;
 
 
+/**
+* Specifies if an error object is a valid boom object
+*
+* @param err - The error object to decorate
+* @param options - Options object
+*
+* @returns A decorated boom object
+*/
+export function boomifyAny<Data, Decoration>(err: unknown, options?: Options<Data> & Decorate<Decoration> & ({ onlyError: true } | { onlyError?: false; stringAsMessage?: boolean })): Boom<Data> & Decoration;
+
+
 // 4xx Errors
 
 /**

lib/index.js

@@ -136,6 +136,26 @@ exports.boomify = function (err, options) {
 };
 
 
+exports.boomifyAny = function (value, options) {
+
+    if (value instanceof Error) {
+        return exports.boomify(value, options);
+    }
+
+    options = options || {};
+
+    if (options.onlyError) {
+        const err = internals.serverError('Non-error used as error', value, 500, exports.boomifyAny);
+        err.isDeveloperError = true;
+        return err;
+    }
+
+    const message = (options.stringAsMessage && typeof value === 'string' && value) || options.message || 'Unknown error';
+
+    return new exports.Boom(message, { statusCode: options.statusCode || 500, data: value, ctor: exports.boomifyAny });
+};
+
+
 // 4xx Client Errors
 
 exports.badRequest = function (message, data) {