webcit-ng/static/js/view_mail.js

   1 // This module handles the view for "mailbox" rooms.
   2 //
   3 // Copyright (c) 2016-2023 by the citadel.org team
   4 //
   5 // This program is open source software.  Use, duplication, or
   6 // disclosure are subject to the GNU General Public License v3.
   7
   8
   9 var displayed_message = 0;                                                      // ID of message currently being displayed
  10 var RefreshMailboxInterval;                                                     // We store our refresh timer here
  11 var highest_mailnum;                                                            // This is used to detect newly arrived mail
  12 var newmail_notify = {
  13         NO  : 0,                                                                // do not perform new mail notifications
  14         YES : 1                                                                 // yes, perform new mail notifications
  15 };
  16
  17
  18 // This is the async back end for mail_delete_selected()
  19 mail_delete_func = async(table, row) => {
  20         let m = parseInt(row["id"].substring(12));                              // derive msgnum from row id
  21
  22         if (is_trash_folder) {
  23                 response = await fetch(
  24                         "/ctdl/r/" + escapeHTMLURI(current_room) + "/" + m,
  25                         {
  26                                 method: "DELETE"                                // If this is the Trash folder, delete permanently
  27                         },
  28                 );
  29         }
  30         else {
  31                 response = await fetch(
  32                         "/ctdl/r/" + escapeHTMLURI(current_room) + "/" + m,
  33                         {
  34                                 method: "MOVE",                                 // Otherwise, move to the Trash folder
  35                                 headers: { "Destination" : "/ctdl/r/_TRASH_" }
  36                         },
  37                 );
  38         }
  39
  40         if (response.ok) {                              // If the server accepted the delete, blank out the message div
  41                 table.deleteRow(row.rowIndex);
  42                 if (m == displayed_message) {
  43                         document.getElementById("ctdl-mailbox-reading-pane").innerHTML = "";
  44                         displayed_message = 0;
  45                 }
  46         }
  47 }
  48
  49
  50 // Delete the selected messages (can be activated by mouse click or keypress)
  51 function mail_delete_selected() {
  52         var table = document.getElementById("ctdl-onscreen-mailbox");
  53         var i, row;
  54         for (i=0; row=table.rows[i]; ++i) {
  55                 if (row.classList.contains("ctdl-mail-selected")) {
  56                         mail_delete_func(table, row);
  57                 }
  58         }
  59 }
  60
  61
  62 // Handler function for keypresses detected while the mail view is displayed.  Mainly for deleting messages.
  63 function mail_keypress(event) {
  64
  65         // If the "ctdl-mailbox-pane" no longer exists, the user has navigated to a different part of the site,
  66         // so cancel the event listener.
  67         try {
  68                 document.getElementById("ctdl-mailbox-pane").innerHTML;
  69         }
  70         catch {
  71                 document.removeEventListener("keydown", mail_keypress);
  72                 return;
  73         }
  74
  75         const key = event.key.toLowerCase();
  76         if (key == "delete") {
  77                 mail_delete_selected();
  78         }
  79
  80 }
  81
  82
  83 // Render reply address for a message (FIXME figure out how to deal with "reply-to:")
  84 function reply_addr(msg) {
  85         //if (msg.locl) {
  86                 //return([msg.from]);
  87         //}
  88         //else {
  89                 return([msg.from + " &lt;" + msg.rfca + "&gt;"]);
  90         //}
  91 }
  92
  93
  94 // Render the To: recipients for a reply-all operation
  95 function replyall_to(msg) {
  96         return([...reply_addr(msg), ...msg.rcpt]);
  97 }
  98
  99
 100 // Render a message into the mailbox view
 101 // (We want the message number and the message itself because we need to keep the msgnum for reply purposes)
 102 function mail_render_one(msgnum, msg, target_div, include_controls) {
 103         let div = "";
 104         try {
 105                 outmsg =
 106                   "<div class=\"ctdl-mmsg-wrapper\">"                           // begin message wrapper
 107                 ;
 108
 109                 if (include_controls) {                                         // omit controls if this is a pull quote
 110                         outmsg +=
 111                           render_userpic(msg.from)                              // user avatar
 112                         + "<div class=\"ctdl-mmsg-content\">"                   // begin content
 113                         + "<div class=\"ctdl-msg-header\">"                     // begin header
 114                         + "<span class=\"ctdl-msg-header-info\">"               // begin header info on left side
 115                         + render_msg_author(msg, views.VIEW_MAILBOX)
 116                         + "<span class=\"ctdl-msgdate\">"
 117                         + string_timestamp(msg.time,0)
 118                         + "</span>"                                             // end msgdate
 119                         + "</span>"                                             // end header info on left side
 120                         + "<span class=\"ctdl-msg-header-buttons\">"            // begin buttons on right side
 121
 122                         + "<span class=\"ctdl-msg-button\">"                    // Reply (mail is always Quoted)
 123                         + "<a href=\"javascript:mail_compose(true,'"+msg.wefw+"','"+msgnum+"', reply_addr(msg), [], 'Re: '+msg.subj);\">"
 124                         + "<i class=\"fa fa-reply\"></i> "
 125                         + _("Reply")
 126                         + "</a></span>"
 127
 128                         + "<span class=\"ctdl-msg-button\">"                    // Reply-All (mail is always Quoted)
 129                         + "<a href=\"javascript:mail_compose(true,'"+msg.wefw+"','"+msgnum+"', replyall_to(msg), msg.cccc, 'Re: '+msg.subj);\">"
 130                         + "<i class=\"fa fa-reply-all\"></i> "
 131                         + _("ReplyAll")
 132                         + "</a></span>";
 133
 134                         if (can_delete_messages) {
 135                                 outmsg +=
 136                                 "<span class=\"ctdl-msg-button\">"
 137                                 + "<a href=\"javascript:forum_delete_message('"+div+"','"+msg.msgnum+"');\">"
 138                                 + "<i class=\"fa fa-trash\"></i> "
 139                                 + _("Delete")
 140                                 + "</a></span>";
 141                         }
 142
 143                         outmsg +=
 144                           "</span>";                                            // end buttons on right side
 145
 146                         // Display the To: recipients, if any are present
 147                         if (msg.rcpt) {
 148                                 outmsg += "<br><span>" + _("To:") + " ";
 149                                 for (var r=0; r<msg.rcpt.length; ++r) {
 150                                         if (r != 0) {
 151                                                 outmsg += ", ";
 152                                         }
 153                                         outmsg += escapeHTML(msg.rcpt[r]);
 154                                 }
 155                                 outmsg += "</span>";
 156                         }
 157
 158                         // Display the Cc: recipients, if any are present
 159                         if (msg.cccc) {
 160                                 outmsg += "<br><span>" + _("Cc:") + " ";
 161                                 for (var r=0; r<msg.cccc.length; ++r) {
 162                                         if (r != 0) {
 163                                                 outmsg += ", ";
 164                                         }
 165                                         outmsg += escapeHTML(msg.cccc[r]);
 166                                 }
 167                                 outmsg += "</span>";
 168                         }
 169
 170                         // Display a subject line, but only if the message has a subject (internal Citadel messages often don't)
 171                         if (msg.subj) {
 172                                 outmsg +=
 173                                 "<br><span class=\"ctdl-msgsubject\">" + msg.subj + "</span>";
 174                         }
 175
 176                         outmsg +=
 177                           "</div>";                                             // end header
 178                 }
 179
 180                 outmsg +=
 181                   "<div class=\"ctdl-msg-body\" id=\"" + div + "_body\">"       // begin body
 182                 + msg.text
 183                 + "</div>"                                                      // end body
 184                 + "</div>"                                                      // end content
 185                 + "</div>"                                                      // end wrapper
 186                 ;
 187         }
 188         catch(err) {
 189                 outmsg = "<div class=\"ctdl-mmsg-wrapper\">" + err.message + "</div>";
 190         }
 191
 192         target_div.innerHTML = outmsg;
 193 }
 194
 195
 196 // display an individual message (note: this wants an actual div object, not a string containing the name of a div)
 197 function mail_display_message(msgnum, target_div, include_controls) {
 198         url = "/ctdl/r/" + escapeHTMLURI(current_room) + "/" + msgnum + "/json";
 199         mail_fetch_msg = async() => {
 200                 response = await fetch(url);
 201                 msg = await(response.json());
 202                 if (response.ok) {
 203                         mail_render_one(msgnum, msg, target_div, include_controls);
 204                 }
 205         }
 206         mail_fetch_msg();
 207 }
 208
 209
 210 // A message has been selected...
 211 function click_message(event, msgnum) {
 212         var table = document.getElementById("ctdl-onscreen-mailbox");
 213         var i, m, row;
 214
 215         // ctrl + click = toggle an individual message without changing existing selection
 216         if (event.ctrlKey) {
 217                 document.getElementById("ctdl-msgsum-" + msgnum).classList.toggle("ctdl-mail-selected");
 218         }
 219
 220         // shift + click = select a range of messages
 221         else if (event.shiftKey) {
 222                 for (i=0; row=table.rows[i]; ++i) {
 223                         m = parseInt(row["id"].substring(12));                          // derive msgnum from row id
 224                         if (
 225                                 ((msgnum >= displayed_message) && (m >= displayed_message) && (m <= msgnum))
 226                                 || ((msgnum <= displayed_message) && (m <= displayed_message) && (m >= msgnum))
 227                         ) {
 228                                 row.classList.add("ctdl-mail-selected");
 229                         }
 230                         else {
 231                                 row.classList.remove("ctdl-mail-selected");
 232                         }
 233                 }
 234         }
 235
 236         // click + no modifiers = select one message and unselect all others
 237         else {
 238                 for (i=0; row=table.rows[i]; ++i) {
 239                         if (row["id"] == "ctdl-msgsum-" + msgnum) {
 240                                 row.classList.add("ctdl-mail-selected");
 241                         }
 242                         else {
 243                                 row.classList.remove("ctdl-mail-selected");
 244                         }
 245                 }
 246         }
 247
 248         // display the message if it isn't already displayed
 249         if (displayed_message != msgnum) {
 250                 displayed_message = msgnum;
 251                 mail_display_message(msgnum, document.getElementById("ctdl-mailbox-reading-pane"), 1);
 252         }
 253 }
 254
 255
 256 // render one row in the mailbox table (this could be called from one of several places)
 257 function mail_render_row(msg, is_selected) {
 258         row     = "<tr "
 259                 + "id=\"ctdl-msgsum-" + msg["msgnum"] + "\" "
 260                 + (is_selected ? "class=\"ctdl-mail-selected\" " : "")
 261                 + "onClick=\"click_message(event," + msg["msgnum"] + ");\""
 262                 + "onselectstart=\"return false;\""
 263                 + ">"
 264                 + "<td class=\"ctdl-mail-subject\">" + msg["subject"] + "</td>"
 265                 + "<td class=\"ctdl-mail-sender\">" + msg["author"] + "</td>"
 266                 + "<td class=\"ctdl-mail-date\">" + string_timestamp(msg["time"],1) + "</td>"
 267                 + "<td class=\"ctdl-mail-msgnum\">" + msg["msgnum"] + "</td>"
 268                 + "</tr>";
 269         return(row);
 270 }
 271
 272
 273 // RENDERER FOR THIS VIEW
 274 function view_render_mail() {
 275         // Put the "enter new message" button into the topbar
 276         document.getElementById("ctdl-newmsg-button").innerHTML = "<i class=\"fa fa-edit\"></i>" + _("Write mail");
 277         document.getElementById("ctdl-newmsg-button").style.display = "block";
 278
 279         // Put the "delete message(s)" button into the topbar
 280         let d = document.getElementById("ctdl-delete-button");
 281         d.innerHTML = "<i class=\"fa fa-trash\"></i>" + _("Delete");
 282         d.style.display = "block";
 283         //d.addEventListener("click", mail_delete_selected);
 284
 285         document.getElementById("ctdl-main").innerHTML
 286                 = "<div id=\"ctdl-mailbox-grid-container\" class=\"ctdl-mailbox-grid-container\">"
 287                 + "<div id=\"ctdl-mailbox-pane\" class=\"ctdl-mailbox-pane\"></div>"
 288                 + "<div id=\"ctdl-mailbox-reading-pane\" class=\"ctdl-mailbox-reading-pane\"></div>"
 289                 + "</div>"
 290         ;
 291
 292         highest_mailnum = 0;                                    // Keep track of highest message number to track newly arrived messages
 293         render_mailbox_display(newmail_notify.NO);
 294         try {                                                   // if this was already set up, clear it so there aren't multiple
 295                 clearInterval(RefreshMailboxInterval);
 296         }
 297         catch {
 298         }
 299         RefreshMailboxInterval = setInterval(refresh_mail_display, 10000);
 300 }
 301
 302
 303 // Refresh the mailbox, either for the first time or whenever needed
 304 function refresh_mail_display() {
 305         // If the "ctdl-mailbox-pane" no longer exists, the user has navigated to a different part of the site,
 306         // so cancel the refresh.
 307         try {
 308                 document.getElementById("ctdl-mailbox-pane").innerHTML;
 309         }
 310         catch {
 311                 clearInterval(RefreshMailboxInterval);
 312                 return;
 313         }
 314
 315         // Ask the server if the room has been written to since our last look at it.
 316         url = "/ctdl/r/" + escapeHTMLURI(current_room) + "/stat";
 317         fetch_stat = async() => {
 318                 response = await fetch(url);
 319                 stat = await(response.json());
 320                 if (stat.room_mtime > room_mtime) {                     // FIXME commented out to force refreshes
 321                         room_mtime = stat.room_mtime;
 322                         render_mailbox_display(newmail_notify.YES);
 323                 }
 324         }
 325         fetch_stat();
 326 }
 327
 328
 329 // This is where the rendering of the message list in the mailbox view is performed.
 330 // Set notify to newmail_notify.NO or newmail_notify.YES depending on whether we are interested in the arrival of new messages.
 331 function render_mailbox_display(notify) {
 332
 333         url = "/ctdl/r/" + escapeHTMLURI(current_room) + "/mailbox";
 334         fetch_mailbox = async() => {
 335                 response = await fetch(url);
 336                 msgs = await(response.json());
 337                 if (response.ok) {
 338                         var previously_selected = [];
 339                         var oldtable = document.getElementById("ctdl-onscreen-mailbox");
 340                         var i, row;
 341
 342                         // If one or more messages was already selected, remember them so we can re-select them
 343                         if ( (displayed_message > 0) && (oldtable) ) {
 344                                 for (i=0; row=oldtable.rows[i]; ++i) {
 345                                         if (row.classList.contains("ctdl-mail-selected")) {
 346                                                 previously_selected.push(parseInt(row["id"].substring(12)));
 347                                         }
 348                                 }
 349                         }
 350
 351                         // begin rendering the mailbox table
 352                         box =   "<table id=\"ctdl-onscreen-mailbox\" class=\"ctdl-mailbox-table\" width=100%><tr>"
 353                                 + "<th>" + _("Subject") + "</th>"
 354                                 + "<th>" + _("Sender") + "</th>"
 355                                 + "<th>" + _("Date") + "</th>"
 356                                 + "<th>#</th>"
 357                                 + "</tr>";
 358
 359                         for (let i=0; i<msgs.length; ++i) {
 360                                 let m = parseInt(msgs[i].msgnum);
 361                                 let s = (previously_selected.includes(m));
 362                                 box += mail_render_row(msgs[i], s);
 363                                 if (m > highest_mailnum) {
 364                                         highest_mailnum = m;
 365                                 }
 366                         }
 367
 368                         box +=  "</table>";
 369                         document.getElementById("ctdl-mailbox-pane").innerHTML = box;
 370                         document.addEventListener("keydown", mail_keypress);
 371                 }
 372         }
 373         fetch_mailbox();
 374 }
 375
 376
 377 // Compose a new mail message (called by the Reply button here, or by the dispatcher in views.js)
 378 function mail_compose(is_quoted, references, quoted_msgnum, m_to, m_cc, m_subject) {
 379         // m_to will be an array of zero or more recipients for the To: field.  Convert it to a string.
 380         if (m_to) {
 381                 m_to = Array.from(new Set(m_to));       // remove dupes
 382                 m_to_str = "";
 383                 for (i=0; i<m_to.length; ++i) {
 384                         if (i > 0) {
 385                                 m_to_str += ", ";
 386                         }
 387                         m_to_str += m_to[i].replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 388                 }
 389         }
 390         else {
 391                 m_to_str = "";
 392         }
 393
 394         // m_to will be an array of zero or more recipients for the Cc: field.  Convert it to a string.
 395         if (m_cc) {
 396                 m_cc = Array.from(new Set(m_cc));       // remove dupes
 397                 m_cc_str = "";
 398                 for (i=0; i<m_cc.length; ++i) {
 399                         if (i > 0) {
 400                                 m_cc_str += ", ";
 401                         }
 402                         m_cc_str += m_cc[i].replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 403                 }
 404         }
 405         else {
 406                 m_cc_str = "";
 407         }
 408
 409         quoted_div_name = randomString();
 410
 411         // Make the "Write mail" button disappear.  We're already there!
 412         document.getElementById("ctdl-newmsg-button").style.display = "none";
 413
 414         // is_quoted    true or false depending on whether the user selected "reply quoted" (is this appropriate for mail?)
 415         // references   list of references, be sure to use this in a reply
 416         // msgid        if a reply, the msgid of the most recent message in the chain, the one to which we are replying
 417
 418         // Now display the screen.
 419         compose_screen =
 420                 // Hidden values that we are storing right here in the document tree for later
 421                   "<input id=\"ctdl_mc_is_quoted\" style=\"display:none\" value=\"" + is_quoted + "\"></input>"
 422                 + "<input id=\"ctdl_mc_references\" style=\"display:none\" value=\"" + references + "\"></input>"
 423
 424                 // Header fields, the composition window, and the button bar are arranged using a Grid layout.
 425                 + "<div id=\"ctdl-compose-mail\" class=\"ctdl-compose-mail\">"
 426
 427                 // Visible To: field, plus a box to make the CC/BCC lines appear
 428                 + "<div class=\"ctdl-compose-to-label\">" + _("To:") + "</div>"
 429                 + "<div class=\"ctdl-compose-to-line\">"
 430                 + "<div class=\"ctdl-compose-to-field\" id=\"ctdl-compose-to-field\" contenteditable=\"true\">" + m_to_str + "</div>"
 431                 + "<div class=\"ctdl-cc-bcc-buttons ctdl-msg-button\" id=\"ctdl-cc-bcc-buttons\" "
 432                 + "onClick=\"make_cc_bcc_visible()\">"
 433                 + _("CC:") + "/" + _("BCC:") + "</div>"
 434                 + "</div>"
 435
 436                 // CC/BCC
 437                 + "<div class=\"ctdl-compose-cc-label\" id=\"ctdl-compose-cc-label\">" + _("CC:") + "</div>"
 438                 + "<div class=\"ctdl-compose-cc-field\" id=\"ctdl-compose-cc-field\" contenteditable=\"true\">" + m_cc_str + "</div>"
 439                 + "<div class=\"ctdl-compose-bcc-label\" id=\"ctdl-compose-bcc-label\">" + _("BCC:") + "</div>"
 440                 + "<div class=\"ctdl-compose-bcc-field\" id=\"ctdl-compose-bcc-field\" contenteditable=\"true\"></div>"
 441
 442                 // Visible subject field
 443                 + "<div class=\"ctdl-compose-subject-label\">" + _("Subject:") + "</div>"
 444                 + "<div class=\"ctdl-compose-subject-field\" id=\"ctdl-compose-subject-field\" contenteditable=\"true\">" + m_subject + "</div>"
 445
 446                 // Message composition box
 447                 + "<div class=\"ctdl-compose-message-box\" id=\"ctdl-editor-body\" contenteditable=\"true\">"
 448         ;
 449
 450         if (is_quoted) {
 451                 compose_screen += "<br><br><blockquote><div id=\"" + quoted_div_name + "\"></div></blockquote>";
 452         }
 453
 454         compose_screen +=
 455                   "</div>"
 456
 457                 // The button bar is a Grid element, and is also a Flexbox container.
 458                 + "<div class=\"ctdl-compose-toolbar\">"
 459                 + "<span class=\"ctdl-msg-button\" onclick=\"mail_send_message()\"><i class=\"fa fa-paper-plane\" style=\"color:green\"></i> " + _("Send message") + "</span>"
 460                 + "<span class=\"ctdl-msg-button\">" + _("Save to Drafts") + "</span>"
 461                 + "<span class=\"ctdl-msg-button\">" + _("Attachments:") + " 0" + "</span>"
 462                 + "<span class=\"ctdl-msg-button\">" + _("Contacts") + "</span>"
 463                 + "<span class=\"ctdl-msg-button\" onClick=\"gotoroom(current_room)\"><i class=\"fa fa-trash\" style=\"color:red\"></i> " + _("Cancel") + "</span>"
 464                 + "</div>"
 465         ;
 466
 467         document.getElementById("ctdl-main").innerHTML = compose_screen;
 468         mail_display_message(quoted_msgnum, document.getElementById(quoted_div_name), 0);
 469         if (m_cc) {
 470                 document.getElementById("ctdl-compose-cc-label").style.display = "block";
 471                 document.getElementById("ctdl-compose-cc-field").style.display = "block";
 472         }
 473 }
 474
 475
 476 // Called when the user clicks the button to make the hidden "CC" and "BCC" lines appear.
 477 // It is also called automatically during a Reply when CC is pre-populated.
 478 function make_cc_bcc_visible() {
 479         document.getElementById("ctdl-cc-bcc-buttons").style.display = "none";
 480         document.getElementById("ctdl-compose-bcc-label").style.display = "block";
 481         document.getElementById("ctdl-compose-bcc-field").style.display = "block";
 482 }
 483
 484
 485 // Helper function for mail_send_messages() to extract and decode metadata values.
 486 function msm_field(element_name, separator) {
 487         let s1 = document.getElementById(element_name).innerHTML;
 488         let s2 = s1.replaceAll("|",separator);          // Replace "|" with "!" because "|" is a field separator in Citadel wire protocol
 489         let s3 = decodeURI(s2);
 490         let s4 = document.createElement("textarea");    // This One Weird Trick Unescapes All HTML Entities
 491         s4.innerHTML = s3;
 492         let s5 = s4.value;
 493         return(s5);
 494 }
 495
 496
 497 // Save the posted message to the server
 498 function mail_send_message() {
 499
 500         document.body.style.cursor = "wait";
 501         let url = "/ctdl/r/" + escapeHTMLURI(current_room)
 502                 + "/dummy_name_for_new_mail"
 503                 + "?wefw="      + msm_field("ctdl_mc_references", "!")                          // references (if present)
 504                 + "&subj="      + msm_field("ctdl-compose-subject-field", " ")                  // subject (if present)
 505                 + "&mailto="    + msm_field("ctdl-compose-to-field", ",")                       // To: (required)
 506                 + "&mailcc="    + msm_field("ctdl-compose-cc-field", ",")                       // Cc: (if present)
 507                 + "&mailbcc="   + msm_field("ctdl-compose-bcc-field", ",")                      // Bcc: (if present)
 508         ;
 509         boundary = randomString();
 510         body_text =
 511                 "--" + boundary + "\r\n"
 512                 + "Content-type: text/html\r\n"
 513                 + "Content-transfer-encoding: quoted-printable\r\n"
 514                 + "\r\n"
 515                 + quoted_printable_encode(
 516                         "<html><body>" + document.getElementById("ctdl-editor-body").innerHTML + "</body></html>"
 517                 ) + "\r\n"
 518                 + "--" + boundary + "--\r\n"
 519         ;
 520
 521         var request = new XMLHttpRequest();
 522         request.open("PUT", url, true);
 523         request.setRequestHeader("Content-type", "multipart/mixed; boundary=\"" + boundary + "\"");
 524         request.onreadystatechange = function() {
 525                 if (request.readyState == 4) {
 526                         document.body.style.cursor = "default";
 527                         if (Math.trunc(request.status / 100) == 2) {
 528                                 headers = request.getAllResponseHeaders().split("\n");
 529                                 for (var i in headers) {
 530                                         if (headers[i].startsWith("etag: ")) {
 531                                                 new_msg_num = headers[i].split(" ")[1];
 532                                         }
 533                                 }
 534
 535                                 // After saving the message, go back to the mailbox view.
 536                                 gotoroom(current_room);
 537
 538                         }
 539                         else {
 540                                 error_message = request.responseText;
 541                                 if (error_message.length == 0) {
 542                                         error_message = _("An error has occurred.");
 543                                 }
 544                                 alert(error_message);                                           // editor remains open
 545                         }
 546                 }
 547         };
 548         request.send(body_text);
 549 }