add support for another endpoint

Author: NickOvt

lib/api/messages.js

@@ -1599,7 +1599,8 @@ module.exports = (db, server, messageHandler, userHandler, storageHandler, setti
                     }),
                     previousDeleted: Joi.boolean()
                 })
-            }
+            },
+            include: true
         },
         tools.responseWrapper(async (req, res) => {
             res.charSet('utf-8');
@@ -1955,18 +1956,48 @@ module.exports = (db, server, messageHandler, userHandler, storageHandler, setti
     );
 
     server.post(
-        '/users/:user/mailboxes/:mailbox/messages/:message/forward',
-        tools.responseWrapper(async (req, res) => {
-            res.charSet('utf-8');
-
-            const schema = Joi.object().keys({
+        {
+            path: '/users/:user/mailboxes/:mailbox/messages/:message/forward',
+            pathParams: {
                 user: Joi.string().hex().lowercase().length(24).required(),
                 mailbox: Joi.string().hex().lowercase().length(24).required(),
-                message: Joi.number().required(),
+                message: Joi.number().required()
+            },
+            summary: 'Forward stored Message',
+            description:
+                'This method allows either to re-forward a message to an original forward target or forward it to some other address. This is useful if a user had forwarding turned on but the message was not delivered so you can try again. Forwarding does not modify the original message.',
+            requestBody: {
                 target: Joi.number().min(1).max(1000),
                 addresses: Joi.array().items(Joi.string().email({ tlds: false })),
                 sess: sessSchema,
                 ip: sessIPSchema
+            },
+            queryParams: {},
+            tags: ['Messages'],
+            response: {
+                200: Joi.object({
+                    success: Joi.boolean(),
+                    queueId: Joi.string(),
+                    forwarded: Joi.array().items(
+                        Joi.object({
+                            seq: Joi.string(),
+                            type: Joi.string(),
+                            value: Joi.string()
+                        }).$_setFlag('objectName', 'Forwarded')
+                    )
+                })
+            },
+            include: true
+        },
+        tools.responseWrapper(async (req, res) => {
+            res.charSet('utf-8');
+
+            const { pathParams, requestBody, queryParams } = req.route.spec;
+
+            const schema = Joi.object({
+                ...pathParams,
+                ...requestBody,
+                ...queryParams
             });
 
             const result = schema.validate(req.params, {