(Node.js) Upload (Append) Email to an IMAP Mailbox and get the UID of the Appended Email

Upload / append an email to an IMAP mailbox and get the UID of the appended email.

Install Chilkat for Node.js and Electron using npm at Chilkat npm packages for Node.js Chilkat npm packages for Electron on Windows, Linux, MacOSX, and ARM

var os = require('os');
if (os.platform() == 'win32') {  
    if (os.arch() == 'ia32') {
        var chilkat = require('@chilkat/ck-node21-win-ia32');
    } else {
        var chilkat = require('@chilkat/ck-node21-win64'); 
    }
} else if (os.platform() == 'linux') {
    if (os.arch() == 'arm') {
        var chilkat = require('@chilkat/ck-node21-arm');
    } else if (os.arch() == 'x86') {
        var chilkat = require('@chilkat/ck-node21-linux32');
    } else {
        var chilkat = require('@chilkat/ck-node21-linux64');
    }
} else if (os.platform() == 'darwin') {
    if (os.arch() == 'arm64') {
        var chilkat = require('@chilkat/ck-node21-mac-m1');
    } else {
        var chilkat = require('@chilkat/ck-node21-macosx');
    }
}

function chilkatExample() {

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    var imap = new chilkat.Imap();

    // Connect to an IMAP server.
    // Use TLS
    imap.Ssl = true;
    imap.Port = 993;
    var success = imap.Connect("imap.someMailServer.com");
    if (success !== true) {
        console.log(imap.LastErrorText);
        return;
    }

    // Login
    success = imap.Login("myLogin","myPassword");
    if (success !== true) {
        console.log(imap.LastErrorText);
        return;
    }

    // Check the capabilities of the IMAP server.
    var cap = imap.Capability();
    console.log("IMAP capabilities: " + cap);

    // If the capabilities string contains the substring "UIDPLUS", then 
    // the UID of the appended email will be available in the AppendUid property (see below).

    // For example, the GMail IMAP server has these capabilities (at this current time)
    // * CAPABILITY IMAP4rev1 UNSELECT IDLE NAMESPACE QUOTA ID XLIST CHILDREN 
    // X-GM-EXT-1 UIDPLUS COMPRESS=DEFLATE ENABLE MOVE CONDSTORE ESEARCH UTF8=ACCEPT 
    // APPENDLIMIT=35882577 LIST-EXTENDED LIST-STATUS

    var email = new chilkat.Email();

    // Load the email from a .eml file.
    success = email.LoadEml("myEmail.eml");
    if (success !== true) {
        console.log(email.LastErrorText);
        return;
    }

    success = imap.AppendMail("Inbox",email);
    if (success !== true) {
        console.log(imap.LastErrorText);
        return;
    }

    // If the IMAP server supports the UIDPLUS extension, then the 
    // imap.AppendUid will contain the UID of the appended email.
    // Otherwise AppendUid will be 0.
    console.log("UID of appended email: " + imap.AppendUid);

    // If the IMAP server does NOT have UIDPLUS, then a program can 
    // first select the mailbox, get the value of the UidNext property,
    // and then append.  The appended email SHOULD have a UID equal to 
    // the UidNext that was obtained just prior to appending (assuming no other
    // program is simultaneously appending an email to the same mailbox).

    // Note: It is not required to select a mailbox to append.  The select is only
    // done for the purpose of obtaining the UIDNEXT value.
    success = imap.SelectMailbox("Inbox");
    if (success !== true) {
        console.log(imap.LastErrorText);
        return;
    }

    var uidNext = imap.UidNext;

    success = imap.AppendMail("Inbox",email);
    if (success !== true) {
        console.log(imap.LastErrorText);
        return;
    }

    console.log("The UID of the appended email SHOULD be " + uidNext);

    console.log("Email uploaded to Inbox!");

    // Disconnect from the IMAP server.
    success = imap.Disconnect();

}

chilkatExample();