api.lua

-- see: mail.md

-- translation
local S = mail.S

local f = string.format

mail.registered_on_receives = {}
function mail.register_on_receive(func)
	mail.registered_on_receives[#mail.registered_on_receives + 1] = func
end

mail.registered_on_player_receives = {}
function mail.register_on_player_receive(func)
	table.insert(mail.registered_on_player_receives, func)
end

mail.registered_recipient_handlers = {}
function mail.register_recipient_handler(func)
	table.insert(mail.registered_recipient_handlers, func)
end

function mail.send(m)
	if type(m.from) ~= "string" then return false, "'from' is not a string" end
	if type(m.to or "") ~= "string" then return false, "'to' is not a string" end
	if type(m.cc or "") ~= "string" then return false, "'cc' is not a string" end
	if type(m.bcc or "") ~= "string" then return false, "'bcc' is not a string" end
	if type(m.subject or "") ~= "string" then return false, "'subject' is not a string" end
	if type(m.body) ~= "string" then return false, "'body' is not a string" end

	-- defaults
	m.subject = m.subject or "(No subject)"

	-- normalize to, cc and bcc while compiling a list of all recipients
	local recipients = {}
	local undeliverable = {}
	m.to = mail.concat_player_list(mail.extract_maillists(m.to, m.from))
	m.to = mail.normalize_players_and_add_recipients(m.from, m.to, recipients, undeliverable)
	if m.cc then
		m.cc = mail.concat_player_list(mail.extract_maillists(m.cc, m.from))
		m.cc = mail.normalize_players_and_add_recipients(mail.from, m.cc, recipients, undeliverable)
	end
	if m.bcc then
		m.bcc = mail.concat_player_list(mail.extract_maillists(m.bcc, m.from))
		m.bcc = mail.normalize_players_and_add_recipients(m.from, m.bcc, recipients, undeliverable)
	end

	if next(undeliverable) then -- table is not empty
		local undeliverable_reason = {S("The mail could not be sent:")}
		for _, reason in pairs(undeliverable) do
			table.insert(undeliverable_reason, reason)
		end
		return false, table.concat(undeliverable_reason, "\n")
	elseif not next(recipients) then
		return false, S("You did not specify any valid recipient.")
	end

	local extra = {}
	local extra_log
	if m.cc then
		table.insert(extra, "CC: " .. m.cc)
	end
	if m.bcc then
		table.insert(extra, "BCC: " .. m.bcc)
	end
	if #extra > 0 then
		extra_log = f(" (%s)", table.concat(extra, " - "))
	else
		extra_log = ""
	end

	core.log("action", f("[mail] %q send mail to %q%s with subject %q and body %q",
		m.from, m.to, extra_log, m.subject, m.body
	))

	local id
	if m.id then
		mail.delete_mail(m.from, m.id)
		id = m.id
	end

	-- form the actual mail
	local msg = {
		id = id or mail.new_uuid(),
		from = m.from,
		to = m.to,
		cc = m.cc,
		bcc = m.bcc,
		subject = m.subject,
		body = m.body,
		time = os.time(),
	}

	-- add in senders outbox
	local entry = mail.get_storage_entry(m.from)
	table.insert(entry.outbox, 1, msg)
	mail.set_storage_entry(m.from, entry)
	msg.spam = #mail.check_spam(msg) >= 1

	-- add in every receivers inbox
	for _, deliver in pairs(recipients) do
		deliver(msg)
	end

	for i=1, #mail.registered_on_receives do
		if mail.registered_on_receives[i](m) then
			break
		end
	end

	return true
end

function mail.save_draft(m)
	if type(m.from) ~= "string" then return false, "'from' is not a string" end
	if type(m.to or "") ~= "string" then return false, "'to' is not a string" end
	if type(m.cc or "") ~= "string" then return false, "'cc' is not a string" end
	if type(m.bcc or "") ~= "string" then return false, "'bcc' is not a string" end
	if type(m.subject or "") ~= "string" then return false, "'subject' is not a string" end
	if type(m.body) ~= "string" then return false, "'body' is not a string" end

	-- defaults
	m.subject = m.subject or "(No subject)"

	core.log("verbose", f("[mail] %q saves draft with subject %q and body %q",
		m.from, m.subject, m.body
	))

	-- remove it is an update
	local id
	if m.id then
		mail.delete_mail(m.from, m.id)
		id = m.id
	end

	-- add (again ie. update) in sender drafts
	local entry = mail.get_storage_entry(m.from)
	table.insert(entry.drafts, 1, {
		id = id or mail.new_uuid(),
		from = m.from,
		to = m.to,
		cc = m.cc,
		bcc = m.bcc,
		subject = m.subject,
		body = m.body,
		time = os.time(),
	})
	mail.set_storage_entry(m.from, entry)

	return true

end