-- Copyright (C) 2010 John Millikin <jmillikin@gmail.com>
--
-- This program is free software: you can redistribute it and/or modify
-- it under the terms of the GNU General Public License as published by
-- the Free Software Foundation, either version 3 of the License, or
-- any later version.
--
-- This program is distributed in the hope that it will be useful,
-- but WITHOUT ANY WARRANTY; without even the implied warranty of
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-- GNU General Public License for more details.
--
-- You should have received a copy of the GNU General Public License
-- along with this program. If not, see <http://www.gnu.org/licenses/>.
{-# LANGUAGE TypeFamilies #-}
{-# LANGUAGE OverloadedStrings #-}
module Network.Protocol.XMPP.Monad
( XMPP (..)
, Error (..)
, Context (..)
, runXMPP
, startXMPP
, restartXMPP
, getHandle
, getContext
, readEvents
, getElement
, getStanza
, putBytes
, putElement
, putStanza
) where
import qualified Control.Applicative as A
import Control.Monad (ap)
import Control.Monad.Fix (MonadFix, mfix)
import Control.Monad.Trans (MonadIO, liftIO)
import qualified Control.Monad.Error as E
import qualified Control.Monad.Reader as R
import qualified Data.ByteString.Lazy.Char8 as B
import Data.Text.Lazy (Text)
import Data.Text.Lazy.Encoding (encodeUtf8)
import qualified Data.FailableList as FL
import qualified Text.XML.LibXML.SAX as SAX
import Network.Protocol.XMPP.ErrorT
import qualified Network.Protocol.XMPP.Handle as H
import qualified Network.Protocol.XMPP.Stanza as S
import qualified Network.Protocol.XMPP.XML as X
data Error
= InvalidStanza X.Element
| InvalidBindResult S.ReceivedStanza
| AuthenticationFailure
| AuthenticationError Text
| TransportError Text
| MarkupError Text
| NoComponentStreamID
| ComponentHandshakeFailed
deriving (Show)
data Context = Context H.Handle Text SAX.Parser
newtype XMPP a = XMPP { unXMPP :: ErrorT Error (R.ReaderT Context IO) a }
instance Functor XMPP where
fmap f = XMPP . fmap f . unXMPP
instance Monad XMPP where
return = XMPP . return
m >>= f = XMPP $ unXMPP m >>= unXMPP . f
instance MonadIO XMPP where
liftIO = XMPP . liftIO
instance E.MonadError XMPP where
type E.ErrorType XMPP = Error
throwError = XMPP . E.throwError
catchError m h = XMPP $ E.catchError (unXMPP m) (unXMPP . h)
instance A.Applicative XMPP where
pure = return
(<*>) = ap
instance MonadFix XMPP where
mfix f = XMPP $ mfix $ unXMPP . f
runXMPP :: Context -> XMPP a -> IO (Either Error a)
runXMPP ctx xmpp = R.runReaderT (runErrorT (unXMPP xmpp)) ctx
startXMPP :: H.Handle -> Text -> XMPP a -> IO (Either Error a)
startXMPP h ns xmpp = do
sax <- SAX.newParser
runXMPP (Context h ns sax) xmpp
restartXMPP :: Maybe H.Handle -> XMPP a -> XMPP a
restartXMPP newH xmpp = do
Context oldH ns _ <- getContext
sax <- liftIO SAX.newParser
let ctx = Context (maybe oldH id newH) ns sax
XMPP $ R.local (const ctx) (unXMPP xmpp)
getContext :: XMPP Context
getContext = XMPP R.ask
getHandle :: XMPP H.Handle
getHandle = do
Context h _ _ <- getContext
return h
liftTLS :: ErrorT Text IO a -> XMPP a
liftTLS io = do
res <- liftIO $ runErrorT io
case res of
Left err -> E.throwError $ TransportError err
Right x -> return x
putBytes :: B.ByteString -> XMPP ()
putBytes bytes = do
h <- getHandle
liftTLS $ H.hPutBytes h bytes
putElement :: X.Element -> XMPP ()
putElement = putBytes . encodeUtf8 . X.serialiseElement
putStanza :: S.Stanza a => a -> XMPP ()
putStanza = putElement . S.stanzaToElement
readEvents :: (Integer -> SAX.Event -> Bool) -> XMPP [SAX.Event]
readEvents done = xmpp where
xmpp = do
Context h _ p <- getContext
let nextEvents = do
-- TODO: read in larger increments
bytes <- liftTLS $ H.hGetBytes h 1
failable <- liftIO $ SAX.parse p bytes False
failableToList failable
X.readEvents done nextEvents
failableToList f = case f of
FL.Fail (SAX.Error e) -> E.throwError $ MarkupError e
FL.Done -> return []
FL.Next e es -> do
es' <- failableToList es
return $ e : es'
getElement :: XMPP X.Element
getElement = xmpp where
xmpp = do
events <- readEvents endOfTree
case X.eventsToElement events of
Just x -> return x
Nothing -> E.throwError $ MarkupError "getElement: invalid event list"
endOfTree 0 (SAX.EndElement _) = True
endOfTree _ _ = False
getStanza :: XMPP S.ReceivedStanza
getStanza = do
elemt <- getElement
Context _ ns _ <- getContext
case S.elementToStanza ns elemt of
Just x -> return x
Nothing -> E.throwError $ InvalidStanza elemt