// Type definitions for Google Apps Script 2019-09-11
// Project: https://developers.google.com/apps-script/
// Definitions by: motemen <https://github.com/motemen/>
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped

/// <reference path="google-apps-script.types.d.ts" />

declare namespace GoogleAppsScript {
  export module Mail {
    export type MailAdvancedParameters = {
      /** an array of files to send with the email */
      attachments?: Base.BlobSource[]
      /** a comma-separated list of email addresses to BCC */
      bcc?: string
      /** the body of the email */
      body?: string
      /** a comma-separated list of email addresses to CC */
      cc?: string
      /** if set, devices capable of rendering HTML will use it instead of the required body argument; you can add an optional inlineImages field in HTML body if you have inlined images for your email */
      htmlBody?: string
      /** a JavaScript object containing a mapping from image key (String) to image data (BlobSource); this assumes that the htmlBody parameter is used and contains references to these images in the format <img src="cid:imageKey" /> */
      inlineImages?: { [imageKey: string]: Base.BlobSource }
      /** the name of the sender of the email (default: the user's name) */
      name?: string
      /** true if the email should be sent from a generic no-reply email address to discourage recipients from responding to emails; this option is only possible for G Suite accounts, not Gmail users */
      noReply?: boolean
      /** an email address to use as the default reply-to address (default: the user's email address) */
      replyTo?: string
      /** the subject of the email */
      subject?: string
      /** the address of the recipient */
      to?: string
    }
    /**
     * Sends email.
     *
     * This service allows users to send emails with complete control over the content of the email.
     * Unlike GmailApp, MailApp's sole purpose is sending email. MailApp cannot access a user's Gmail
     * inbox.
     *
     * Changes to scripts written using GmailApp are more likely to trigger a re-authorization
     * request from a user than MailApp scripts.
     */
    export interface MailApp {
      getRemainingDailyQuota(): Integer;
      sendEmail(message: MailAdvancedParameters): void;
      sendEmail(recipient: string, subject: string, body: string): void;
      sendEmail(recipient: string, subject: string, body: string, options: MailAdvancedParameters): void;
      sendEmail(to: string, replyTo: string, subject: string, body: string): void;
    }

  }
}

declare var MailApp: GoogleAppsScript.Mail.MailApp;