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>): Boom<Data> & Decoration;
+
+
 // 4xx Errors
 
 /**

lib/index.js

@@ -136,6 +136,29 @@ exports.boomify = function (err, options) {
 };
 
 
+exports.boomifyAny = function (value, options) {
+
+    // Because message & statusCode are typically used for non-errors, override should not
+    // default to "true" when using boomifyAny with an error.
+    options = Object.assign({ override: false }, options);
+
+    if (value instanceof Error) {
+        return exports.boomify(value, options);
+    }
+
+    const err = new exports.Boom(options.message || 'Unknown error', { statusCode: options.statusCode || 500, data: value, ctor: exports.boomifyAny });
+
+    err.isDeveloperError = true;
+
+    if (options.decorate) {
+        Object.assign(err, options.decorate);
+    }
+
+    return err;
+
+};
+
+
 // 4xx Client Errors
 
 exports.badRequest = function (message, data) {