/** * Email address UI utilities * * You probably want formatEmailAddress(address) */ function _getEmailDisplayPreference() { const pref = window.egw.preference("emailTag", "mail") ?? ""; switch(pref) { case "fullemail": return "full" default: case "onlyname": return "name"; case "onlyemail": return "email"; case "domain": return "domain"; } } const email_cache : { [address : string] : ContactInfo | false } = {}; let contact_request : Promise; let contact_requests : { [key : string] : Array; } = {}; /** * Cache information about a contact */ export interface ContactInfo { id : number, n_fn : string, lname? : string, fname? : string, photo? : string, email? : string, email_home : string } /** * Get contact information using an email address * * @param {string} email * @returns {Promise} */ export function checkContact(email : string) : Promise { if(typeof email_cache[email] !== "undefined") { return Promise.resolve(email_cache[email]); } if(!contact_request && window.egw) { contact_request = window.egw.jsonq('EGroupware\\Api\\Etemplate\\Widget\\Url::ajax_contact', [[]], null, null, (parameters) => { for(const email in contact_requests) { parameters[0].push(email); } }).then((result) => { for(const email in contact_requests) { email_cache[email] = result[email]; contact_requests[email].forEach((resolve) => { resolve(result[email]); }); } contact_request = null; contact_requests = {}; }); } if(typeof contact_requests[email] === 'undefined') { contact_requests[email] = []; } return new Promise(resolve => { contact_requests[email].push(resolve); }); } /** * if we have a "name " value split it into name & email * @param email_string * * @return {name:string, email:string} */ export function splitEmail(email_string) : { name : string, email : string } { let split = {name: "", email: email_string}; if(email_string && email_string.indexOf('<') !== -1) { const parts = email_string.split('<'); if(parts[0]) { split.email = parts[1].substring(0, parts[1].length - 1).trim(); split.name = parts[0].trim(); // remove quotes while((split.name[0] === '"' || split.name[0] === "'") && split.name[0] === split.name.substr(-1)) { split.name = split.name.substring(1, split.name.length - 1); } } else // --> email { split.email = parts[1].substring(0, email_string.length - 1); } } return split; } /** * Format an email address according to user preference * * @param address * @param {"full" | "email" | "name" | "domain"} emailDisplayFormat * @returns {any} */ export async function formatEmailAddress(address : string, emailDisplayFormat? : "full" | "email" | "name" | "domain") : Promise { if(!address || !address.trim()) { return ""; } if(!emailDisplayFormat) { emailDisplayFormat = _getEmailDisplayPreference(); } const split = splitEmail(address); let content = address; let contact; if(!split.name && (contact = await checkContact(address))) { split.name = contact.n_fn; } if(split.name) { switch(emailDisplayFormat) { case "full": content = split.name + " <" + split.email + ">"; break; case "email": content = split.email; break; case "name": default: content = split.name; break; case "domain": content = split.name + " (" + split.email.split("@").pop() + ")"; break; } } return content; }