initial

Author: dblythy

spec/CloudCode.spec.js

@@ -3167,4 +3167,18 @@ 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);
+  });
 });

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,34 @@ 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.emailAdapter;
+  if (!emailAdapter) {
+    throw 'You cannot send mail without an email adapter';
+  }
+  const sendMail = emailAdapter.sendMail;
+  if (!sendMail || typeof sendMail !== 'function') {
+    throw 'This adapter does not support sendMail';
+  }
+  return sendMail(data);
+};
+
 /**
  * Registers a before live query subscription function.
  *