git.iko.soy/typeable/mandrill
on master help sign in
20 files changed+580−146
since splitsnapshots
unifiedsplit
.gitignore+1 .travis.yml+4−4 README.md+67 mandrill-nightly.yml+10 mandrill.cabal+9−5 src/Network/API/Mandrill.hs+23−21 src/Network/API/Mandrill/HTTP.hs+9−9 src/Network/API/Mandrill/Inbound.hs+78 src/Network/API/Mandrill/Messages.hs+4−4 src/Network/API/Mandrill/Messages/Types.hs+1−1 src/Network/API/Mandrill/Senders.hs+45 src/Network/API/Mandrill/Settings.hs+17−7 src/Network/API/Mandrill/Types.hs+88−67 src/Network/API/Mandrill/Users/Types.hs+1−1 src/Network/API/Mandrill/Webhooks.hs+70 stack.yaml+1−1 test/Main.hs+14−7 test/Online.hs+25−7 test/RawData.hs+59−4 test/Tests.hs+54−8
.gitignore+1
@@ -3,3 +3,4 @@ dist
33cabal.sandbox.config
44shell.nix
55.stack-work
6+tags
.travis.yml+4−4
@@ -5,17 +5,17 @@ notifications:
55 email: false
66
77env:
8− - GHCVER=7.6.2 CABALVER=1.16
98 - GHCVER=7.6.3 CABALVER=1.16
109 - GHCVER=7.8.2 CABALVER=1.18
1110 - GHCVER=7.8.3 CABALVER=1.18
12− - GHCVER=7.10.1 CABALVER=1.22
1311 - GHCVER=7.10.2 CABALVER=1.22
14− - GHCVER=head CABALVER=1.20
12+ - GHCVER=8.0.1 CABALVER=1.22
13+ - GHCVER=head CABALVER=1.22
1514
1615matrix:
1716 allow_failures:
18− - env: GHCVER=head CABALVER=1.20
17+ - env: GHCVER=8.0.1 CABALVER=1.22
18+ - env: GHCVER=head CABALVER=1.22
1919
2020before_install:
2121 - travis_retry sudo add-apt-repository -y ppa:hvr/ghc
README.md+67
@@ -8,6 +8,65 @@ the [Mandrill](http://mandrillapp.com) transactional email service.
88
99# Changelog
1010
11+## Version 0.5.3.5
12+
13+* Replaced dependency on lens with microlens (Courtesy of @tom-bop)
14+
15+## Version 0.5.3.3
16+
17+* Relaxed upper bound on Aeson (see: fpco/stackage/issues/3337)
18+
19+## Version 0.5.3.2
20+
21+* Relaxed upper bound on Aeson (see: fpco/stackage/issues/2449)
22+
23+## Version 0.5.3.1
24+
25+* Relaxed upper bound on Aeson (see: fpco/stackage/issues/2177 )
26+
27+## Version 0.5.3.0
28+
29+* Added support for webhooks (thanks to @mwotton).
30+
31+## Version 0.5.2.3
32+
33+* Added support for aeson-1.0.0.0 by relaxing its upper bound.
34+
35+## Version 0.5.2.2
36+
37+* Added support for QuickCheck-2.9 by relaxing its upper bound.
38+
39+## Version 0.5.2.1
40+
41+* Added `Functor`, `Foldable` and `Traversable` instances to `MandrillResponse` (Courtesy of @dredozubov)
42+
43+## Version 0.5.2.0
44+
45+* Added inbound calls (Courtesy of @mwotton)
46+
47+## Version 0.5.1.0
48+
49+* Relaxed the constraint on `aeson` to allow `0.11.0.0`.
50+
51+## Version 0.5.0.0
52+
53+* Changed the `MandrillHeaders` type synonym from `Value` to `Object`.
54+
55+* Changed the `mmsg_metadata` and `mmdt_values` fields from `MandrillVars` to `Object`.
56+
57+* Changed the `mmsg_global_merge_vars` and `mmvr_vars` fields from `[MandrillVars]` to `[MergeVar]`
58+
59+* Added the `MergeVar` data type:
60+
61+```haskell
62+data MergeVar = MergeVar {
63+ _mv_name :: !Text
64+ , _mv_content :: Value
65+ }
66+```
67+
68+* Removed the `MandrillVars` type synonym.
69+
1170## Version 0.4.0.0
1271
1372* Modified the `Base64ByteString` type to accept another constructor. This
@@ -46,9 +105,17 @@ main = do
46105 + ~~ping.json~~ (as **doesn't return valid json!**)
47106 + ping2.json
48107 + senders.json
108+
49109 - [Messages call](https://mandrillapp.com/api/docs/messages.JSON.html)
50110 + send.json
51111
112+ - [Senders call](https://mandrillapp.com/api/docs/senders.JSON.html)
113+ + verify-domain.json
114+
115+ - [Inbound call](https://mandrillapp.com/api/docs/inbound.JSON.html)
116+ + add-route.json
117+ + add-domain.json
118+
52119# Testing online API
53120
54121To test the online API, first build the package with tests enabled:
mandrill-nightly.ymlnew file+10
@@ -0,0 +1,10 @@
1+flags:
2+ semigroups:
3+ bytestring-builder: false
4+packages:
5+- '.'
6+extra-deps:
7+ - aeson-1.3.0.0
8+ - text-1.2.3.0
9+ - semigroups-0.18.2
10+resolver: lts-9.1
mandrill.cabal+9−5
@@ -1,5 +1,5 @@
11name: mandrill
2−version: 0.4.1.0
2+version: 0.5.3.5
33synopsis: Library for interfacing with the Mandrill JSON API
44description: Pure Haskell client for the Mandrill JSON API
55license: MIT
@@ -8,7 +8,7 @@ author: Alfredo Di Napoli
88maintainer: alfredo.dinapoli@gmail.com
99category: Network
1010build-type: Simple
11−tested-with: GHC == 7.4, GHC == 7.6, GHC == 7.8
11+tested-with: GHC == 7.4, GHC == 7.6, GHC == 7.8, GHC == 7.10.2
1212cabal-version: >=1.10
1313
1414source-repository head
@@ -25,6 +25,9 @@ library
2525 Network.API.Mandrill.Users.Types
2626 Network.API.Mandrill.Messages
2727 Network.API.Mandrill.Messages.Types
28+ Network.API.Mandrill.Inbound
29+ Network.API.Mandrill.Webhooks
30+ Network.API.Mandrill.Senders
2831 other-modules:
2932 Network.API.Mandrill.Utils
3033 Network.API.Mandrill.HTTP
@@ -38,14 +41,15 @@ library
3841 , http-types >= 0.8.0
3942 , http-client >= 0.3.0
4043 , http-client-tls >= 0.2.0.0
41− , aeson >= 0.7.0.3 && < 0.11.0.0
42− , lens >= 4.0
44+ , aeson >= 0.7.0.3 && < 1.5.0.0
45+ , microlens-th >= 0.4.0.0
4346 , blaze-html >= 0.5.0.0
44− , QuickCheck >= 2.6 && < 2.9
47+ , QuickCheck >= 2.6 && < 3.0
4548 , mtl < 3.0
4649 , time
4750 , email-validate >= 1.0.0
4851 , old-locale
52+ , unordered-containers
4953 hs-source-dirs:
5054 src
5155 default-language:
src/Network/API/Mandrill.hs+23−21
@@ -20,18 +20,18 @@ module Network.API.Mandrill (
2020 -- $exampleusage
2121 ) where
2222
23−import Control.Monad.Reader
24−import Control.Lens
25−import Data.Time
26−import Text.Blaze.Html
27−import Network.API.Mandrill.Types as M
28−import Network.API.Mandrill.Messages as M
29−import Network.API.Mandrill.Messages.Types as M
30−import Network.API.Mandrill.Trans as M
31−import Data.Monoid
32−import Text.Email.Validate
33−import qualified Data.Text as T
34−import qualified Data.Aeson as JSON
23+import Control.Monad.Reader
24+import qualified Data.Aeson as JSON
25+import qualified Data.HashMap.Strict as H
26+import Data.Monoid
27+import qualified Data.Text as T
28+import Data.Time
29+import Network.API.Mandrill.Messages as M
30+import Network.API.Mandrill.Messages.Types as M
31+import Network.API.Mandrill.Trans as M
32+import Network.API.Mandrill.Types as M
33+import Text.Blaze.Html
34+import Text.Email.Validate
3535
3636{- $exampleusage
3737
@@ -40,7 +40,7 @@ The API was designed to allow to get you started as quickly as possible:
4040> {-# LANGUAGE OverloadedStrings #-}
4141> import Text.Email.Validate
4242> import Network.API.Mandrill
43−>
43+>
4444> main :: IO ()
4545> main = do
4646> case validate "foo@example.com" of
@@ -66,7 +66,7 @@ emptyMessage f t = MandrillMessage {
6666 , _mmsg_from_email = (MandrillEmail f)
6767 , _mmsg_from_name = Nothing
6868 , _mmsg_to = map newRecipient t
69− , _mmsg_headers = JSON.Null
69+ , _mmsg_headers = H.empty
7070 , _mmsg_important = Nothing
7171 , _mmsg_track_opens = Nothing
7272 , _mmsg_track_clicks = Nothing
@@ -87,7 +87,7 @@ emptyMessage f t = MandrillMessage {
8787 , _mmsg_subaccount = Nothing
8888 , _mmsg_google_analytics_domains = []
8989 , _mmsg_google_analytics_campaign = Nothing
90− , _mmsg_metadata = JSON.Null
90+ , _mmsg_metadata = H.empty
9191 , _mmsg_recipient_metadata = []
9292 , _mmsg_attachments = []
9393 , _mmsg_images = []
@@ -106,7 +106,7 @@ newHtmlMessage :: EmailAddress
106106 -- ^ The HTML body
107107 -> MandrillMessage
108108newHtmlMessage f t subj html = let body = mkMandrillHtml html in
109− ((mmsg_html .~ body) . (mmsg_subject .~ subj)) $ (emptyMessage f t)
109+ (emptyMessage f t) { _mmsg_html = body, _mmsg_subject = subj }
110110
111111--------------------------------------------------------------------------------
112112-- | Create a new template message (no HTML).
@@ -117,7 +117,7 @@ newTemplateMessage :: EmailAddress
117117 -> T.Text
118118 -- ^ Subject
119119 -> MandrillMessage
120−newTemplateMessage f t subj = (mmsg_subject .~ subj) $ (emptyMessage f t)
120+newTemplateMessage f t subj = (emptyMessage f t) { _mmsg_subject = subj }
121121
122122--------------------------------------------------------------------------------
123123-- | Create a new textual message. By default Mandrill doesn't require you
@@ -133,9 +133,11 @@ newTextMessage :: EmailAddress
133133 -- ^ The body, as normal text.
134134 -> MandrillMessage
135135newTextMessage f t subj txt = let body = unsafeMkMandrillHtml txt in
136− ((mmsg_html .~ body) .
137− (mmsg_text .~ Just txt) .
138− (mmsg_subject .~ subj)) (emptyMessage f t)
136+ (emptyMessage f t) {
137+ _mmsg_html = body
138+ , _mmsg_text = Just txt
139+ , _mmsg_subject = subj
140+ }
139141
140142
141143--------------------------------------------------------------------------------
@@ -143,7 +145,7 @@ newTextMessage f t subj txt = let body = unsafeMkMandrillHtml txt in
143145-- 'MandrillMessage' and this function will send an email inside a
144146-- 'MandrillT' transformer. You are not forced to use the 'MandrillT' context
145147-- though. Have a look at "Network.API.Mandrill.Messages" for an IO-based,
146−-- low lever function for sending email.
148+-- low level function for sending email.
147149sendEmail :: MonadIO m
148150 => MandrillMessage
149151 -> MandrillT m (MandrillResponse [MessagesResponse])
src/Network/API/Mandrill/HTTP.hs+9−9
@@ -1,15 +1,15 @@
11{-# LANGUAGE OverloadedStrings #-}
22module Network.API.Mandrill.HTTP where
33
4−import Network.API.Mandrill.Settings
5−import Network.API.Mandrill.Types
6−import qualified Data.Text as T
7−import Data.Monoid
8−import Data.Aeson
9−import Control.Applicative
10−import Network.HTTP.Types
11−import Network.HTTP.Client
12−import Network.HTTP.Client.TLS
4+import Control.Applicative
5+import Data.Aeson
6+import Data.Monoid
7+import qualified Data.Text as T
8+import Network.API.Mandrill.Settings
9+import Network.API.Mandrill.Types
10+import Network.HTTP.Client
11+import Network.HTTP.Client.TLS
12+import Network.HTTP.Types
1313
1414toMandrillResponse :: (MandrillEndpoint ep, FromJSON a, ToJSON rq)
1515 => ep
src/Network/API/Mandrill/Inbound.hsnew file+78
@@ -0,0 +1,78 @@
1+{-# LANGUAGE TemplateHaskell #-}
2+module Network.API.Mandrill.Inbound where
3+import Data.Aeson (FromJSON, ToJSON, parseJSON,
4+ toJSON)
5+import Data.Aeson.TH (defaultOptions, deriveJSON)
6+import Data.Aeson.Types (fieldLabelModifier)
7+import Data.Text (Text)
8+import Lens.Micro.TH (makeLenses)
9+import Network.API.Mandrill.HTTP (toMandrillResponse)
10+import Network.API.Mandrill.Settings
11+import Network.API.Mandrill.Types
12+import Network.HTTP.Client (Manager)
13+
14+data DomainAddRq =
15+ DomainAddRq
16+ { _darq_key :: MandrillKey
17+ , _darq_domain :: Text
18+ } deriving Show
19+
20+makeLenses ''DomainAddRq
21+deriveJSON defaultOptions { fieldLabelModifier = drop 6 } ''DomainAddRq
22+
23+data DomainAddResponse =
24+ DomainAddResponse
25+ { _dares_domain :: Text
26+ , _dares_created_at :: MandrillDate
27+ , _dares_valid_mx :: Bool
28+ } deriving Show
29+
30+
31+
32+makeLenses ''DomainAddResponse
33+deriveJSON defaultOptions { fieldLabelModifier = drop 7 } ''DomainAddResponse
34+
35+data RouteAddResponse =
36+ RouteAddResponse
37+ { _rares_id :: Text
38+ , _rares_pattern :: Text
39+ , _rares_url :: Text
40+ } deriving Show
41+
42+
43+
44+makeLenses ''RouteAddResponse
45+deriveJSON defaultOptions { fieldLabelModifier = drop 7 } ''RouteAddResponse
46+
47+data RouteAddRq =
48+ RouteAddRq
49+ { _rarq_key :: Text
50+ , _rarq_domain :: Text
51+ , _rarq_pattern :: Text
52+ , _rarq_url :: Text
53+ } deriving Show
54+
55+makeLenses ''RouteAddRq
56+deriveJSON defaultOptions { fieldLabelModifier = drop 6 } ''RouteAddRq
57+
58+addDomain :: MandrillKey
59+ -- ^ The API key
60+ -> Text
61+ -- ^ The domain to add
62+ -> Maybe Manager
63+ -> IO (MandrillResponse DomainAddResponse)
64+addDomain k dom = toMandrillResponse DomainsAdd (DomainAddRq k dom)
65+
66+
67+
68+addRoute :: MandrillKey
69+ -- ^ The API key
70+ -> Text
71+ -- ^ The domain to add
72+ -> Text
73+ -- ^ the pattern including wildcards
74+ -> Text
75+ -- ^ URL to forward to
76+ -> Maybe Manager
77+ -> IO (MandrillResponse RouteAddResponse)
78+addRoute k dom pattern forward = toMandrillResponse RoutesAdd (RouteAddRq k dom pattern forward)
src/Network/API/Mandrill/Messages.hs+4−4
@@ -1,13 +1,13 @@
11
22module Network.API.Mandrill.Messages where
33
4−import Network.API.Mandrill.Types
4+import qualified Data.Text as T
5+import Data.Time
6+import Network.API.Mandrill.HTTP
57import Network.API.Mandrill.Messages.Types
68import Network.API.Mandrill.Settings
7−import Network.API.Mandrill.HTTP
9+import Network.API.Mandrill.Types
810import Network.HTTP.Client
9−import Data.Time
10−import qualified Data.Text as T
1111
1212--------------------------------------------------------------------------------
1313-- | Send a new transactional message through Mandrill
src/Network/API/Mandrill/Messages/Types.hs+1−1
@@ -5,12 +5,12 @@ module Network.API.Mandrill.Messages.Types where
55import Data.Char
66import Data.Time
77import qualified Data.Text as T
8−import Control.Lens
98import Control.Monad
109import Data.Monoid
1110import Data.Aeson
1211import Data.Aeson.Types
1312import Data.Aeson.TH
13+import Lens.Micro.TH (makeLenses)
1414
1515import Network.API.Mandrill.Types
1616
src/Network/API/Mandrill/Senders.hsnew file+45
@@ -0,0 +1,45 @@
1+{-# LANGUAGE TemplateHaskell #-}
2+module Network.API.Mandrill.Senders where
3+import Data.Aeson (FromJSON, ToJSON, parseJSON,
4+ toJSON)
5+import Data.Aeson.TH (defaultOptions, deriveJSON)
6+import Data.Aeson.Types (Value (..), fieldLabelModifier)
7+import Data.Text (Text)
8+import Data.Text.Encoding (decodeUtf8, encodeUtf8)
9+import Lens.Micro.TH (makeLenses)
10+import Network.API.Mandrill.HTTP (toMandrillResponse)
11+import Network.API.Mandrill.Settings
12+import Network.API.Mandrill.Types
13+import Network.HTTP.Client (Manager)
14+import qualified Text.Email.Validate as TEV
15+
16+data VerifyDomainRq =
17+ VerifyDomainRq
18+ { _vdrq_key :: MandrillKey
19+ , _vdrq_domain :: Text
20+ , _vdrq_mailbox :: Text
21+ } deriving Show
22+
23+makeLenses ''VerifyDomainRq
24+deriveJSON defaultOptions { fieldLabelModifier = drop 6 } ''VerifyDomainRq
25+
26+data VerifyDomainResponse =
27+ VerifyDomainResponse
28+ { _vdres_status :: Text
29+ , _vdres_domain :: Text
30+ , _vdres_email :: MandrillEmail
31+ } deriving Show
32+
33+makeLenses ''VerifyDomainResponse
34+deriveJSON defaultOptions { fieldLabelModifier = drop 7 } ''VerifyDomainResponse
35+
36+
37+verifyDomain :: MandrillKey
38+ -- ^ The API key
39+ -> TEV.EmailAddress
40+ -- ^ Email address to use for verification
41+ -> Maybe Manager
42+ -> IO (MandrillResponse VerifyDomainResponse)
43+verifyDomain k email =
44+ toMandrillResponse VerifyDomain
45+ (VerifyDomainRq k (decodeUtf8 $ TEV.domainPart email) (decodeUtf8 $ TEV.localPart email))
src/Network/API/Mandrill/Settings.hs+17−7
@@ -15,16 +15,26 @@ data MandrillCalls =
1515 -- Messages API
1616 | MessagesSend
1717 | MessagesSendTemplate
18− | MessagesSearch deriving Show
18+ | MessagesSearch
19+ -- Inbound API
20+ | RoutesAdd
21+ | DomainsAdd
22+ -- Senders API
23+ | VerifyDomain
24+
25+ deriving Show
1926
2027class MandrillEndpoint ep where
2128 toUrl :: ep -> T.Text
2229
2330instance MandrillEndpoint MandrillCalls where
24− toUrl UsersInfo = "users/info.json"
25− toUrl UsersPing = "users/ping.json"
26− toUrl UsersPing2 = "users/ping2.json"
27− toUrl UsersSenders = "users/senders.json"
28− toUrl MessagesSend = "messages/send.json"
31+ toUrl UsersInfo = "users/info.json"
32+ toUrl UsersPing = "users/ping.json"
33+ toUrl UsersPing2 = "users/ping2.json"
34+ toUrl UsersSenders = "users/senders.json"
35+ toUrl MessagesSend = "messages/send.json"
2936 toUrl MessagesSendTemplate = "messages/send-template.json"
30− toUrl MessagesSearch = "messages/search.json"
37+ toUrl MessagesSearch = "messages/search.json"
38+ toUrl DomainsAdd = "inbound/add-domain.json"
39+ toUrl RoutesAdd = "inbound/add-route.json"
40+ toUrl VerifyDomain = "senders/verify-domain.json"
src/Network/API/Mandrill/Types.hs+88−67
@@ -1,35 +1,44 @@
1−{-# LANGUAGE TemplateHaskell #-}
2−{-# LANGUAGE CPP #-}
3−{-# LANGUAGE RankNTypes #-}
1+{-# LANGUAGE CPP #-}
2+{-# LANGUAGE DeriveFoldable #-}
3+{-# LANGUAGE DeriveFunctor #-}
4+{-# LANGUAGE DeriveTraversable #-}
5+{-# LANGUAGE OverloadedStrings #-}
6+{-# LANGUAGE RankNTypes #-}
47{-# LANGUAGE ScopedTypeVariables #-}
5−{-# LANGUAGE OverloadedStrings #-}
8+{-# LANGUAGE TemplateHaskell #-}
69module Network.API.Mandrill.Types where
710
8−import Network.API.Mandrill.Utils
9−import Test.QuickCheck
10−import Text.Email.Validate
11+import Control.Applicative
12+import Control.Monad (mzero)
1113import Data.Char
1214import Data.Maybe
1315import Data.Time
14−import Control.Applicative
16+import Lens.Micro.TH (makeLenses)
17+import Network.API.Mandrill.Utils
18+import Test.QuickCheck
19+import Text.Email.Validate
1520#if MIN_VERSION_time(1,5,0)
16−import Data.Time.Format (TimeLocale, defaultTimeLocale)
21+import Data.Time.Format (TimeLocale, defaultTimeLocale)
1722#else
18−import System.Locale (TimeLocale, defaultTimeLocale)
23+import System.Locale (TimeLocale, defaultTimeLocale)
1924#endif
20−import qualified Data.ByteString as B
21−import qualified Data.ByteString.Base64 as Base64
22−import qualified Data.Text as T
23−import qualified Data.Text.Encoding as TL
24−import qualified Data.Text.Lazy as TL
25−import Control.Lens
26−import Data.Monoid
2725import Data.Aeson
28−import Data.Aeson.Types
2926import Data.Aeson.TH
30−import qualified Text.Blaze.Html as Blaze
27+import Data.Aeson.Types
28+import qualified Data.ByteString as B
29+import qualified Data.ByteString.Base64 as Base64
30+#if !MIN_VERSION_base(4,8,0)
31+import Data.Foldable
32+import Data.Traversable
33+#endif
34+import qualified Data.HashMap.Strict as H
35+import Data.Monoid
36+import qualified Data.Text as T
37+import qualified Data.Text.Encoding as TL
38+import qualified Data.Text.Lazy as TL
39+import qualified Text.Blaze.Html as Blaze
3140import qualified Text.Blaze.Html.Renderer.Text as Blaze
32−
41+import qualified Text.Email.Validate as TEV
3342
3443timeParse :: ParseTime t => TimeLocale -> String -> String -> Maybe t
3544#if MIN_VERSION_time(1,5,0)
@@ -40,11 +49,11 @@ timeParse = parseTime
4049
4150--------------------------------------------------------------------------------
4251data MandrillError = MandrillError {
43− _merr_status :: !T.Text
44− , _merr_code :: !Int
45− , _merr_name :: !T.Text
52+ _merr_status :: !T.Text
53+ , _merr_code :: !Int
54+ , _merr_name :: !T.Text
4655 , _merr_message :: !T.Text
47− } deriving Show
56+ } deriving (Show, Eq)
4857
4958makeLenses ''MandrillError
5059deriveJSON defaultOptions { fieldLabelModifier = drop 6 } ''MandrillError
@@ -69,6 +78,7 @@ data MandrillRejectReason = RR_HardBounce
6978 | RR_InvalidSender
7079 | RR_Invalid
7180 | RR_TestModeLimit
81+ | RR_Unsigned
7282 | RR_Rule deriving Show
7383
7484deriveJSON defaultOptions {
@@ -81,7 +91,7 @@ deriveJSON defaultOptions {
8191-- which can be either a success or a failure.
8292data MandrillResponse k =
8393 MandrillSuccess k
84− | MandrillFailure MandrillError deriving Show
94+ | MandrillFailure MandrillError deriving (Show, Eq, Functor, Foldable, Traversable)
8595
8696instance FromJSON k => FromJSON (MandrillResponse k) where
8797 parseJSON v = case (parseMaybe parseJSON v) :: Maybe k of
@@ -117,9 +127,9 @@ instance FromJSON MandrillEmail where
117127data MandrillRecipient = MandrillRecipient {
118128 _mrec_email :: MandrillEmail
119129 -- ^ The email address of the recipient
120− , _mrec_name :: Maybe T.Text
130+ , _mrec_name :: Maybe T.Text
121131 -- ^ The optional display name to use for the recipient
122− , _mrec_type :: Maybe MandrillRecipientTag
132+ , _mrec_type :: Maybe MandrillRecipientTag
123133 -- ^ The header type to use for the recipient.
124134 -- defaults to "to" if not provided
125135 } deriving Show
@@ -148,6 +158,11 @@ unsafeMkMandrillHtml = MandrillHtml . Blaze.preEscapedToHtml
148158mkMandrillHtml :: Blaze.Html -> MandrillHtml
149159mkMandrillHtml = MandrillHtml
150160
161+#if MIN_VERSION_base(4,11,0)
162+instance Semigroup MandrillHtml where
163+ MandrillHtml m1 <> MandrillHtml m2 = MandrillHtml (m1 <> m2)
164+#endif
165+
151166instance Monoid MandrillHtml where
152167 mempty = MandrillHtml mempty
153168 mappend (MandrillHtml m1) (MandrillHtml m2) = MandrillHtml (m1 <> m2)
@@ -170,17 +185,23 @@ type MandrillTags = T.Text
170185
171186
172187--------------------------------------------------------------------------------
173−type MandrillHeaders = Value
188+type MandrillHeaders = Object
174189
175190
176191--------------------------------------------------------------------------------
177−type MandrillVars = Value
178192
193+data MergeVar = MergeVar {
194+ _mv_name :: !T.Text
195+ , _mv_content :: Value
196+ } deriving Show
197+
198+makeLenses ''MergeVar
199+deriveJSON defaultOptions { fieldLabelModifier = drop 4 } ''MergeVar
179200
180201--------------------------------------------------------------------------------
181202data MandrillMergeVars = MandrillMergeVars {
182203 _mmvr_rcpt :: !T.Text
183− , _mmvr_vars :: [MandrillVars]
204+ , _mmvr_vars :: [MergeVar]
184205 } deriving Show
185206
186207makeLenses ''MandrillMergeVars
@@ -188,8 +209,8 @@ deriveJSON defaultOptions { fieldLabelModifier = drop 6 } ''MandrillMergeVars
188209
189210--------------------------------------------------------------------------------
190211data MandrillMetadata = MandrillMetadata {
191− _mmdt_rcpt :: !T.Text
192− , _mmdt_values :: MandrillVars
212+ _mmdt_rcpt :: !T.Text
213+ , _mmdt_values :: Object
193214 } deriving Show
194215
195216makeLenses ''MandrillMetadata
@@ -213,8 +234,8 @@ instance FromJSON Base64ByteString where
213234
214235--------------------------------------------------------------------------------
215236data MandrillWebContent = MandrillWebContent {
216− _mwct_type :: !T.Text
217− , _mwct_name :: !T.Text
237+ _mwct_type :: !T.Text
238+ , _mwct_name :: !T.Text
218239 -- ^ [for images] the Content ID of the image
219240 -- - use <img src="cid:THIS_VALUE"> to reference the image
220241 -- in your HTML content
@@ -227,67 +248,67 @@ deriveJSON defaultOptions { fieldLabelModifier = drop 6 } ''MandrillWebContent
227248--------------------------------------------------------------------------------
228249-- | The information on the message to send
229250data MandrillMessage = MandrillMessage {
230− _mmsg_html :: MandrillHtml
251+ _mmsg_html :: MandrillHtml
231252 -- ^ The full HTML content to be sent
232− , _mmsg_text :: Maybe T.Text
253+ , _mmsg_text :: Maybe T.Text
233254 -- ^ Optional full text content to be sent
234− , _mmsg_subject :: !T.Text
255+ , _mmsg_subject :: !T.Text
235256 -- ^ The message subject
236− , _mmsg_from_email :: MandrillEmail
257+ , _mmsg_from_email :: MandrillEmail
237258 -- ^ The sender email address
238− , _mmsg_from_name :: Maybe T.Text
259+ , _mmsg_from_name :: Maybe T.Text
239260 -- ^ Optional from name to be used
240− , _mmsg_to :: [MandrillRecipient]
261+ , _mmsg_to :: [MandrillRecipient]
241262 -- ^ A list of recipient information
242− , _mmsg_headers :: MandrillHeaders
263+ , _mmsg_headers :: MandrillHeaders
243264 -- ^ optional extra headers to add to the message (most headers are allowed)
244− , _mmsg_important :: Maybe Bool
265+ , _mmsg_important :: Maybe Bool
245266 -- ^ whether or not this message is important, and should be delivered ahead
246267 -- of non-important messages
247− , _mmsg_track_opens :: Maybe Bool
268+ , _mmsg_track_opens :: Maybe Bool
248269 -- ^ whether or not to turn on open tracking for the message
249− , _mmsg_track_clicks :: Maybe Bool
270+ , _mmsg_track_clicks :: Maybe Bool
250271 -- ^ whether or not to turn on click tracking for the message
251− , _mmsg_auto_text :: Maybe Bool
272+ , _mmsg_auto_text :: Maybe Bool
252273 -- ^ whether or not to automatically generate a text part for messages that are not given text
253− , _mmsg_auto_html :: Maybe Bool
274+ , _mmsg_auto_html :: Maybe Bool
254275 -- ^ whether or not to automatically generate an HTML part for messages that are not given HTML
255− , _mmsg_inline_css :: Maybe Bool
276+ , _mmsg_inline_css :: Maybe Bool
256277 -- ^ whether or not to automatically inline all CSS styles provided in the message HTML
257278 -- - only for HTML documents less than 256KB in size
258− , _mmsg_url_strip_qs :: Maybe Bool
279+ , _mmsg_url_strip_qs :: Maybe Bool
259280 -- ^ whether or not to strip the query string from URLs when aggregating tracked URL data
260− , _mmsg_preserve_recipients :: Maybe Bool
281+ , _mmsg_preserve_recipients :: Maybe Bool
261282 -- ^ whether or not to expose all recipients in to "To" header for each email
262− , _mmsg_view_content_link :: Maybe Bool
283+ , _mmsg_view_content_link :: Maybe Bool
263284 -- ^ set to false to remove content logging for sensitive emails
264− , _mmsg_bcc_address :: Maybe T.Text
285+ , _mmsg_bcc_address :: Maybe T.Text
265286 -- ^ an optional address to receive an exact copy of each recipient's email
266− , _mmsg_tracking_domain :: Maybe T.Text
287+ , _mmsg_tracking_domain :: Maybe T.Text
267288 -- ^ a custom domain to use for tracking opens and clicks instead of mandrillapp.com
268− , _mmsg_signing_domain :: Maybe Bool
269− -- ^ a custom domain to use for SPF/DKIM signing instead of mandrill
289+ , _mmsg_signing_domain :: Maybe Bool
290+ -- ^ a custom domain to use for SPF/DKIM signing instead of mandrill
270291 -- (for "via" or "on behalf of" in email clients)
271− , _mmsg_return_path_domain :: Maybe Bool
292+ , _mmsg_return_path_domain :: Maybe Bool
272293 -- ^ a custom domain to use for the messages's return-path
273− , _mmsg_merge :: Maybe Bool
294+ , _mmsg_merge :: Maybe Bool
274295 -- ^ whether to evaluate merge tags in the message.
275296 -- Will automatically be set to true if either merge_vars
276297 -- or global_merge_vars are provided.
277− , _mmsg_global_merge_vars :: [MandrillVars]
298+ , _mmsg_global_merge_vars :: [MergeVar]
278299 -- ^ global merge variables to use for all recipients. You can override these per recipient.
279− , _mmsg_merge_vars :: [MandrillMergeVars]
300+ , _mmsg_merge_vars :: [MandrillMergeVars]
280301 -- ^ per-recipient merge variables, which override global merge variables with the same name.
281− , _mmsg_tags :: [MandrillTags]
302+ , _mmsg_tags :: [MandrillTags]
282303 -- ^ an array of string to tag the message with. Stats are accumulated using tags,
283304 -- though we only store the first 100 we see, so this should not be unique
284305 -- or change frequently. Tags should be 50 characters or less.
285306 -- Any tags starting with an underscore are reserved for internal use
286307 -- and will cause errors.
287− , _mmsg_subaccount :: Maybe T.Text
308+ , _mmsg_subaccount :: Maybe T.Text
288309 -- ^ the unique id of a subaccount for this message
289310 -- - must already exist or will fail with an error
290− , _mmsg_google_analytics_domains :: [T.Text]
311+ , _mmsg_google_analytics_domains :: [T.Text]
291312 -- ^ an array of strings indicating for which any matching URLs
292313 -- will automatically have Google Analytics parameters appended
293314 -- to their query string automatically.
@@ -295,17 +316,17 @@ data MandrillMessage = MandrillMessage {
295316 -- ^ optional string indicating the value to set for the utm_campaign
296317 -- tracking parameter. If this isn't provided the email's from address
297318 -- will be used instead.
298− , _mmsg_metadata :: MandrillVars
319+ , _mmsg_metadata :: Object
299320 -- ^ metadata an associative array of user metadata. Mandrill will store
300321 -- this metadata and make it available for retrieval.
301322 -- In addition, you can select up to 10 metadata fields to index
302323 -- and make searchable using the Mandrill search api.
303− , _mmsg_recipient_metadata :: [MandrillMetadata]
324+ , _mmsg_recipient_metadata :: [MandrillMetadata]
304325 -- ^ Per-recipient metadata that will override the global values
305326 -- specified in the metadata parameter.
306− , _mmsg_attachments :: [MandrillWebContent]
327+ , _mmsg_attachments :: [MandrillWebContent]
307328 -- ^ an array of supported attachments to add to the message
308− , _mmsg_images :: [MandrillWebContent]
329+ , _mmsg_images :: [MandrillWebContent]
309330 -- ^ an array of embedded images to add to the message
310331 } deriving Show
311332
@@ -319,7 +340,7 @@ instance Arbitrary MandrillMessage where
319340 <*> pure (MandrillEmail . fromJust $ emailAddress "sender@example.com")
320341 <*> pure Nothing
321342 <*> resize 2 arbitrary
322− <*> pure emptyObject
343+ <*> pure H.empty
323344 <*> pure Nothing
324345 <*> pure Nothing
325346 <*> pure Nothing
@@ -340,7 +361,7 @@ instance Arbitrary MandrillMessage where
340361 <*> pure Nothing
341362 <*> pure []
342363 <*> pure Nothing
343− <*> pure emptyObject
364+ <*> pure H.empty
344365 <*> pure []
345366 <*> pure []
346367 <*> pure []
src/Network/API/Mandrill/Users/Types.hs+1−1
@@ -5,12 +5,12 @@ module Network.API.Mandrill.Users.Types where
55import Data.Char
66import Data.Time
77import qualified Data.Text as T
8−import Control.Lens
98import Control.Monad
109import Data.Monoid
1110import Data.Aeson
1211import Data.Aeson.Types
1312import Data.Aeson.TH
13+import Lens.Micro.TH (makeLenses)
1414
1515import Network.API.Mandrill.Types
1616
src/Network/API/Mandrill/Webhooks.hsnew file+70
@@ -0,0 +1,70 @@
1+{-# LANGUAGE OverloadedStrings #-}
2+{-# LANGUAGE TemplateHaskell #-}
3+module Network.API.Mandrill.Webhooks where
4+import Control.Applicative (pure)
5+import Control.Monad (mzero)
6+import Data.Aeson (FromJSON, ToJSON, parseJSON,
7+ toJSON)
8+import Data.Aeson (Value (String))
9+import Data.Aeson.TH (defaultOptions, deriveJSON)
10+import Data.Aeson.Types (fieldLabelModifier)
11+import Data.Set (Set)
12+import Data.Text (Text)
13+import qualified Data.Text as T
14+import Lens.Micro.TH (makeLenses)
15+import Network.API.Mandrill.HTTP (toMandrillResponse)
16+import Network.API.Mandrill.Settings
17+import Network.API.Mandrill.Types
18+import Network.HTTP.Client (Manager)
19+
20+data EventHook
21+ = EventSent
22+ | EventDeferred
23+ | EventHardBounced
24+ | EventSoftBounced
25+ | EventOpened
26+ | EventClicked
27+ | EventMarkedAsSpam
28+ | EventUnsubscribed
29+ | EventRejected
30+ deriving (Ord,Eq)
31+
32+instance Show EventHook where
33+ show e = case e of
34+ EventSent -> "send"
35+ EventDeferred -> "deferral"
36+ EventSoftBounced -> "soft_bounce"
37+ EventHardBounced -> "hard_bounce"
38+ EventOpened -> "open"
39+ EventClicked -> "click"
40+ EventMarkedAsSpam -> "spam"
41+ EventUnsubscribed -> "unsub"
42+ EventRejected -> "reject"
43+instance FromJSON EventHook where
44+ parseJSON (String s) =
45+ case s of
46+ "send" -> pure EventSent
47+ "deferral" -> pure EventDeferred
48+ "soft_bounce" -> pure EventSoftBounced
49+ "hard_bounce" -> pure EventHardBounced
50+ "open" -> pure EventOpened
51+ "click" -> pure EventClicked
52+ "spam" -> pure EventMarkedAsSpam
53+ "reject" -> pure EventRejected
54+ "unsub" -> pure EventUnsubscribed
55+ x -> fail ("can't parse " ++ show x)
56+
57+
58+instance ToJSON EventHook where
59+ toJSON e = String (T.pack $ show e)
60+
61+data WebhookAddRq =
62+ WebhookAddRq
63+ { _warq_key :: MandrillKey
64+ , _warq_url :: Text
65+ , _warq_description :: Text
66+ , _warq_events :: Set EventHook
67+ } deriving Show
68+
69+makeLenses ''WebhookAddRq
70+deriveJSON defaultOptions { fieldLabelModifier = drop 6 } ''WebhookAddRq
stack.yaml+1−1
@@ -2,4 +2,4 @@ flags: {}
22packages:
33- '.'
44extra-deps: []
5−resolver: lts-2.19
5+resolver: lts-11.13
test/Main.hs+14−7
@@ -1,14 +1,14 @@
11{-# LANGUAGE OverloadedStrings #-}
22module Main where
33
4−import System.Environment
54import Data.Monoid
6−import Tests
5+import qualified Data.Text as T
76import Online
7+import System.Environment
88import Test.Tasty
99import Test.Tasty.HUnit
1010import Test.Tasty.QuickCheck
11−import qualified Data.Text as T
11+import Tests
1212
1313----------------------------------------------------------------------
1414withQuickCheckDepth :: TestName -> Int -> [TestTree] -> TestTree
@@ -23,10 +23,12 @@ onlineTestsIfEnabled = do
2323 Nothing -> return []
2424 Just k -> return [
2525 testGroup "Mandrill online tests" [
26− testCase "users/info.json" (testOnlineUsersInfo k)
27− , testCase "users/ping2.json" (testOnlineUsersPing2 k)
28− , testCase "users/senders.json" (testOnlineUsersSenders k)
29− , testCase "messages/send.json" (testOnlineMessagesSend k)
26+ testCase "users/info.json" (testOnlineUsersInfo k)
27+ , testCase "users/ping2.json" (testOnlineUsersPing2 k)
28+ , testCase "users/senders.json" (testOnlineUsersSenders k)
29+ , testCase "messages/send.json" (testOnlineMessagesSend k)
30+ , testCase "inbound/addDomain.json" (testOnlineDomainAdd k)
31+ , testCase "inbound/addRoute.json" (testOnlineRouteAdd k)
3032 ]]
3133
3234----------------------------------------------------------------------
@@ -39,5 +41,10 @@ main = do
3941 testCase "users/info.json API parsing" testUsersInfo
4042 , testCase "users/senders.json API parsing" testUsersSenders
4143 , testCase "messages/send.json API parsing" testMessagesSend
44+ , testCase "messages/send.json API response parsing" testMessagesResponseRejected
45+ , testCase "inbound/add-route.json API response parsing" testRouteAdd
46+ , testCase "inbound/add-domain.json API response parsing" testDomainAdd
47+ , testCase "senders/verify-domain.json API response parsing" testVerifyDomain
48+ , testCase "webhooks/add.json API response parsing" testWebhookAdd
4249 ]
4350 ]
test/Online.hs+25−7
@@ -1,19 +1,20 @@
11{-# LANGUAGE OverloadedStrings #-}
22module Online where
33
4−import Test.QuickCheck
5−import Test.Tasty.HUnit
6−import Text.RawString.QQ
7−import Data.Either
84import Data.Aeson
5+import qualified Data.ByteString.Char8 as C8
6+import Data.Either
97import Network.API.Mandrill.Messages.Types
108import Network.API.Mandrill.Users.Types
11−import qualified Data.ByteString.Char8 as C8
129import RawData
10+import Test.QuickCheck
11+import Test.Tasty.HUnit
12+import Text.RawString.QQ
1313
14+import qualified Network.API.Mandrill.Inbound as API
15+import qualified Network.API.Mandrill.Messages as API
1416import Network.API.Mandrill.Types
15−import qualified Network.API.Mandrill.Messages as API
16−import qualified Network.API.Mandrill.Users as API
17+import qualified Network.API.Mandrill.Users as API
1718
1819--
1920-- Users calls
@@ -50,3 +51,20 @@ testOnlineMessagesSend k = do
5051 case res of
5152 MandrillSuccess _ -> return ()
5253 MandrillFailure e -> fail $ "messages/send.json " ++ show e
54+
55+--
56+-- Inbound calls
57+--
58+testOnlineDomainAdd :: MandrillKey -> Assertion
59+testOnlineDomainAdd k = do
60+ res <- API.addDomain k "foobar.com" Nothing
61+ case res of
62+ MandrillSuccess a -> print a
63+ MandrillFailure e -> fail $ "inbound/add-domain.json " ++ show e
64+
65+testOnlineRouteAdd :: MandrillKey -> Assertion
66+testOnlineRouteAdd k = do
67+ res <- API.addRoute k "foobar.com" "mail-*" "http://requestb.in/19a4frw1" Nothing
68+ case res of
69+ MandrillSuccess a -> print a
70+ MandrillFailure e -> fail $ "inbound/add-domain.json " ++ show e
test/RawData.hs+59−4
@@ -1,10 +1,10 @@
11{-# LANGUAGE QuasiQuotes #-}
22module RawData where
33
4−import Test.QuickCheck
5−import Test.Tasty.HUnit
6−import Text.RawString.QQ
7−import Data.Either
4+import Data.Either
5+import Test.QuickCheck
6+import Test.Tasty.HUnit
7+import Text.RawString.QQ
88
99usersInfoData :: String
1010usersInfoData = [r|
@@ -200,3 +200,58 @@ sendData = [r|
200200 "send_at": "2014-08-17T14:23:02.954Z"
201201}
202202|]
203+
204+
205+messagesResponseRejected = [r|
206+[ { "email" : "foo@bar.com",
207+ "status" : "rejected",
208+ "_id" : "abc123",
209+ "reject_reason": "unsigned"
210+ }
211+]
212+|]
213+
214+
215+domainAdd = [r|
216+{
217+ "domain": "inbound.example.com",
218+ "created_at": "2013-01-01 15:30:27",
219+ "valid_mx": true
220+}
221+|]
222+
223+
224+routeAdd= [r|
225+{
226+ "id": "7.23",
227+ "pattern": "mailbox-*",
228+ "url": "http://example.com/webhook-url"
229+}
230+|]
231+
232+domainVerify = [r|
233+{
234+ "status": "example status",
235+ "domain": "example domain",
236+ "email": "email@domain.com"
237+}
238+|]
239+
240+webhookAdd = [r|
241+{
242+ "key": "example key",
243+ "url": "http://example/webhook-url",
244+ "description": "My Example Webhook",
245+ "events": [
246+ "send",
247+ "deferral",
248+ "hard_bounce",
249+ "soft_bounce",
250+ "open",
251+ "click",
252+ "spam",
253+ "unsub",
254+ "reject"
255+ ]
256+}
257+|]
test/Tests.hs+54−8
@@ -1,13 +1,17 @@
11{-# LANGUAGE CPP #-}
22module Tests where
33
4−import Test.Tasty.HUnit
5−import Data.Either
6−import Data.Aeson
7−import Network.API.Mandrill.Messages.Types
8−import Network.API.Mandrill.Users.Types
9−import qualified Data.ByteString.Char8 as C8
10−import RawData
4+import Data.Aeson
5+import qualified Data.ByteString.Char8 as C8
6+import Data.Either
7+import Network.API.Mandrill.Inbound
8+import Network.API.Mandrill.Messages.Types
9+import Network.API.Mandrill.Senders
10+import Network.API.Mandrill.Types
11+import Network.API.Mandrill.Users.Types
12+import Network.API.Mandrill.Webhooks
13+import RawData
14+import Test.Tasty.HUnit
1115
1216#if defined(__GLASGOW_HASKELL__) && __GLASGOW_HASKELL__ <= 706
1317isRight :: Either a b -> Bool
@@ -16,7 +20,7 @@ isRight _ = True
1620#endif
1721
1822testMessagesSend :: Assertion
19−testMessagesSend =
23+testMessagesSend =
2024 assertBool ("send.json: Parsing failed! " ++ show parsePayload)
2125 (isRight parsePayload)
2226 where
@@ -40,3 +44,45 @@ testUsersSenders = do
4044 where
4145 parsePayload :: Either String UsersSendersResponse
4246 parsePayload = eitherDecodeStrict . C8.pack $ usersSendersData
47+
48+testMessagesResponseRejected :: Assertion
49+testMessagesResponseRejected = do
50+ assertBool ("send.json response: Parsing failed" ++ show parsePayload)
51+ (isRight parsePayload)
52+ where
53+ parsePayload :: Either String (MandrillResponse [MessagesResponse])
54+ parsePayload = eitherDecodeStrict . C8.pack $ messagesResponseRejected
55+
56+testDomainAdd :: Assertion
57+testDomainAdd =
58+ assertBool ("inbound/add-domain.json (response): parsing failed" ++ show parsePayload)
59+ (isRight parsePayload)
60+ where
61+ parsePayload :: Either String DomainAddResponse
62+ parsePayload = eitherDecodeStrict . C8.pack $ domainAdd
63+
64+
65+testRouteAdd :: Assertion
66+testRouteAdd =
67+ assertBool ("inbound/add-route.json (response): parsing failed" ++ show parsePayload)
68+ (isRight parsePayload)
69+ where
70+ parsePayload :: Either String RouteAddResponse
71+ parsePayload = eitherDecodeStrict . C8.pack $ routeAdd
72+
73+testVerifyDomain :: Assertion
74+testVerifyDomain =
75+ assertBool ("senders/verify-domain.json" ++ show parsePayload)
76+ (isRight parsePayload)
77+ where
78+ parsePayload :: Either String VerifyDomainResponse
79+ parsePayload = eitherDecodeStrict . C8.pack $ domainVerify
80+
81+
82+testWebhookAdd :: Assertion
83+testWebhookAdd =
84+ assertBool ("webhooks/add.json (request): parsing failed" ++ show parsePayload)
85+ (isRight parsePayload)
86+ where
87+ parsePayload :: Either String WebhookAddRq
88+ parsePayload = eitherDecodeStrict . C8.pack $ webhookAdd