initial commit from appmail

api/controllers/messages_api_controller.rb

@@ -0,0 +1,40 @@
+controller :messages do
+  friendly_name "Messages API"
+  description "This API allows you to access message details"
+  authenticator :server
+
+  action :message do
+    title "Return message details"
+    description "Returns all details about a message"
+    param :id, "The ID of the message", :type => Integer, :required => true
+    returns Hash, :structure => :message, :structure_opts => {:paramable => {:expansions => false}}
+    error 'MessageNotFound', "No message found matching provided ID", :attributes => {:id => "The ID of the message"}
+    action do
+      begin
+        message = identity.server.message(params.id)
+      rescue Postal::MessageDB::Message::NotFound => e
+        error 'MessageNotFound', :id => params.id
+      end
+      structure :message, message, :return => true
+    end
+  end
+
+  action :deliveries do
+    title "Return deliveries for a message"
+    description "Returns an array of deliveries which have been attempted for this message"
+    param :id, "The ID of the message", :type => Integer, :required => true
+    returns Array, :structure => :delivery, :structure_opts => {:full => true}
+    error 'MessageNotFound', "No message found matching provided ID", :attributes => {:id => "The ID of the message"}
+    action do
+      begin
+        message = identity.server.message(params.id)
+      rescue Postal::MessageDB::Message::NotFound => e
+        error 'MessageNotFound', :id => params.id
+      end
+      message.deliveries.map do |d|
+        structure :delivery, d
+      end
+    end
+  end
+
+end

api/controllers/send_api_controller.rb

@@ -0,0 +1,109 @@
+controller :send do
+  friendly_name "Send API"
+  description "This API allows you to send messages"
+  authenticator :server
+
+  action :message do
+    title "Send a message"
+    description "This action allows you to send a message by providing the appropriate options"
+    # Acceptable Parameters
+    param :to, "The e-mail addresses of the recipients (max 50)", :type => Array
+    param :cc, "The e-mail addresses of any CC contacts (max 50)", :type => Array
+    param :bcc, "The e-mail addresses of any BCC contacts (max 50)", :type => Array
+    param :from, "The e-mail address of the sender", :type => String
+    param :subject, "The subject of the e-mail", :type => String
+    param :tag, "The tag of the e-mail", :type => String
+    param :reply_to, "Set the reply-to address for the mail", :type => String
+    param :plain_body, "The plain text body of the e-mail", :type => String
+    param :html_body, "The HTML body of the e-mail", :type => String
+    param :attachments, "An array of attachments for this e-mail", :type => Array
+    param :headers, "A hash of additional headers", :type => Hash
+    param :bounce, "Is this message a bounce?", :type => :boolean
+    # Errors
+    error 'ValidationError', "The provided data was not sufficient to send an email", :attributes => {:errors => "A hash of error details"}
+    error 'NoRecipients', "There are no recipients defined to received this message"
+    error 'NoContent', "There is no content defined for this e-mail"
+    error 'TooManyToAddresses', "The maximum number of To addresses has been reached (maximum 50)"
+    error 'TooManyCCAddresses', "The maximum number of CC addresses has been reached (maximum 50)"
+    error 'TooManyBCCAddresses', "The maximum number of BCC addresses has been reached (maximum 50)"
+    error 'FromAddressMissing', "The From address is missing and is required"
+    error 'UnauthenticatedFromAddress', "The From address is not authorised to send mail from this server"
+    error 'AttachmentMissingName', "An attachment is missing a name"
+    error 'AttachmentMissingData', "An attachment is missing data"
+    # Return
+    returns Hash
+    # Action
+    action do
+      attributes = {}
+      attributes[:to] = params.to
+      attributes[:cc] = params.cc
+      attributes[:bcc] = params.bcc
+      attributes[:from] = params.from
+      attributes[:sender] = params.sender
+      attributes[:subject] = params.subject
+      attributes[:reply_to] = params.reply_to
+      attributes[:plain_body] = params.plain_body
+      attributes[:html_body] = params.html_body
+      attributes[:bounce] = params.bounce ? true : false
+      attributes[:tag] = params.tag
+      attributes[:custom_headers] = params.headers
+      attributes[:attachments] = []
+      (params.attachments || []).each do |attachment|
+        next unless attachment.is_a?(Hash)
+        attributes[:attachments] << {:name => attachment['name'], :content_type => attachment['content_type'], :data => attachment['data'], :base64 => true}
+      end
+      message = OutgoingMessagePrototype.new(identity.server, request.ip, 'api', attributes)
+      message.credential = identity
+      if message.valid?
+        result = message.create_messages
+        {:message_id => message.message_id, :messages => result}
+      else
+        error message.errors.first
+      end
+    end
+  end
+
+  action :raw do
+    title "Send a raw RFC2882 message"
+    description "This action allows you to send us a raw RFC2822 formatted message along with the recipients that it should be sent to. This is similar to sending a message through our SMTP service."
+    param :mail_from, "The address that should be logged as sending the message", :type => String, :required => true
+    param :rcpt_to, "The addresses this message should be sent to", :type => Array, :required => true
+    param :data, "A base64 encoded RFC2822 message to send", :type => String, :required => true
+    param :bounce, "Is this message a bounce?", :type => :boolean
+    returns Hash
+    error 'UnauthenticatedFromAddress', "The From address is not authorised to send mail from this server"
+    action do
+      # Decode the raw message
+      raw_message = Base64.decode64(params.data)
+
+      # Parse through mail to get the from/sender headers
+      mail = Mail.new(raw_message.split("\r\n\r\n", 2).first)
+      from_headers = {'from' => mail.from, 'sender' => mail.sender}
+      authenticated_domain = identity.server.find_authenticated_domain_from_headers(from_headers)
+
+      # If we're not authenticated, don't continue
+      if authenticated_domain.nil?
+        error 'UnauthenticatedFromAddress'
+      end
+
+      # Store the result ready to return
+      result = {:message_id => nil, :messages => {}}
+      params.rcpt_to.uniq.each do |rcpt_to|
+        message = identity.server.message_db.new_message
+        message.rcpt_to = rcpt_to
+        message.mail_from = params.mail_from
+        message.raw_message = raw_message
+        message.received_with_ssl = true
+        message.scope = 'outgoing'
+        message.domain_id = authenticated_domain.id
+        message.credential_id = identity.id
+        message.bounce = params.bounce ? 1 : 0
+        message.save
+        result[:message_id] = message.message_id if result[:message_id].nil?
+        result[:messages][rcpt_to] = {:id => message.id, :token => message.token}
+      end
+      result
+    end
+  end
+
+end