Send email via Parse.Cloud.sendEmail

CHANGELOG.md

@@ -8,6 +8,7 @@ __BREAKING CHANGES:__
 ___
 - IMPROVE: Optimize queries on classes with pointer permissions. [#7061](https://github.com/parse-community/parse-server/pull/7061). Thanks to [Pedro Diaz](https://github.com/pdiaz)
 - FIX: request.context for afterFind triggers. [#7078](https://github.com/parse-community/parse-server/pull/7078). Thanks to [dblythy](https://github.com/dblythy)
+- NEW: sendMail via Parse.Cloud.sendMail({...}). [#7089](https://github.com/parse-community/parse-server/pull/7089). Thanks to [dblythy](https://github.com/dblythy)
 
 ### 4.5.0
 [Full Changelog](https://github.com/parse-community/parse-server/compare/4.4.0...4.5.0)

spec/CloudCode.spec.js

@@ -3167,4 +3167,26 @@ describe('afterLogin hook', () => {
     const query = new Parse.Query(TestObject);
     await query.find({ context: { a: 'a' } });
   });
+  it('can send email via Parse.Cloud', async done => {
+    const emailAdapter = {
+      sendMail: mailData => {
+        expect(mailData).toBeDefined();
+        expect(mailData.to).toBe('test');
+        done();
+      },
+    };
+    await reconfigureServer({
+      emailAdapter: emailAdapter,
+    });
+    const mailData = { to: 'test' };
+    await Parse.Cloud.sendMail(mailData);
+  });
+  it('cannot send email without adapter', async () => {
+    try {
+      await Parse.Cloud.sendMail({});
+      fail('Should have failed to send emails.');
+    } catch (e) {
+      expect(e).toBe('You cannot send mail without an email adapter');
+    }
+  });
 });

src/cloud-code/Parse.Cloud.js

@@ -1,5 +1,6 @@
 import { Parse } from 'parse/node';
 import * as triggers from '../triggers';
+const Config = require('../Config');
 
 function isParseObjectConstructor(object) {
   return typeof object === 'function' && Object.prototype.hasOwnProperty.call(object, 'className');
@@ -528,6 +529,30 @@ ParseCloud.beforeConnect = function (handler, validationHandler) {
   );
 };
 
+/**
+ * Sends email through your mail adapter
+ *
+ * **Available in Cloud Code only.**
+ *
+ * **Requires a mail adapter to be set**
+ *
+ * ```
+ * Parse.Cloud.sendMail(data);
+ *```
+ *
+ * @method sendMail
+ * @name Parse.Cloud.sendMail
+ * @param {Any} data The object of the mail data that you'd like to send
+ */
+ParseCloud.sendMail = function (data) {
+  const config = Config.get(Parse.applicationId) || {};
+  const emailAdapter = config.userController.adapter;
+  if (!emailAdapter) {
+    throw 'You cannot send mail without an email adapter';
+  }
+  return emailAdapter.sendMail(data);
+};
+
 /**
  * Registers a before live query subscription function.
  *