@@ -6,7 +6,6 @@
6{-# LANGUAGE MultiParamTypeClasses #-}
6{-# LANGUAGE MultiParamTypeClasses #-}
7{-# LANGUAGE OverloadedStrings #-}
7{-# LANGUAGE OverloadedStrings #-}
8{-# LANGUAGE PolyKinds #-}
8{-# LANGUAGE PolyKinds #-}
9−{-# LANGUAGE QuantifiedConstraints #-}
10{-# LANGUAGE RankNTypes #-}
9{-# LANGUAGE RankNTypes #-}
11{-# LANGUAGE ScopedTypeVariables #-}
10{-# LANGUAGE ScopedTypeVariables #-}
12{-# LANGUAGE TypeApplications #-}
11{-# LANGUAGE TypeApplications #-}
@@ -18,9 +17,6 @@ module Servant.Client.Core.HasClient (
19 HasClient (..),
18 HasClient (..),
20 EmptyClient (..),
19 EmptyClient (..),
24 foldMapUnion,
20 foldMapUnion,
25 matchUnion,
21 matchUnion,
@@ -32,11 +28,9 @@ import Control.Arrow
32 (left, (+++))
28 (left, (+++))
33import Control.Monad
29import Control.Monad
35−import qualified Data.ByteString as BS
31+import qualified Data.ByteString.Lazy as BL
36−import qualified Data.ByteString.Lazy as BL
37import Data.Either
32import Data.Either
38 (partitionEithers)
33 (partitionEithers)
39−import Data.Constraint (Dict(..))
40import Data.Foldable
34import Data.Foldable
42import Data.List
36import Data.List
@@ -45,8 +39,7 @@ import Data.Sequence
45 (fromList)
39 (fromList)
46import qualified Data.Text as T
40import qualified Data.Text as T
47import Network.HTTP.Media
41import Network.HTTP.Media
48− (MediaType, matches, parseAccept)
42+ (MediaType, matches, parseAccept, (//))
49−import qualified Network.HTTP.Media as Media
50import qualified Data.Sequence as Seq
43import qualified Data.Sequence as Seq
51import Data.SOP.BasicFunctors
44import Data.SOP.BasicFunctors
52 (I (I), (:.:) (Comp))
45 (I (I), (:.:) (Comp))
@@ -63,33 +56,26 @@ import Data.Text
63import Data.Proxy
56import Data.Proxy
64 (Proxy (Proxy))
57 (Proxy (Proxy))
65import GHC.TypeLits
58import GHC.TypeLits
66− (KnownNat, KnownSymbol, TypeError, symbolVal)
59+ (KnownSymbol, symbolVal)
67import Network.HTTP.Types
60import Network.HTTP.Types
69import qualified Network.HTTP.Types as H
62import qualified Network.HTTP.Types as H
70import Servant.API
63import Servant.API
71 ((:<|>) ((:<|>)), (:>), AuthProtect, BasicAuth, BasicAuthData,
64 ((:<|>) ((:<|>)), (:>), AuthProtect, BasicAuth, BasicAuthData,
72 BuildHeadersTo (..), Capture', CaptureAll, Description,
65 BuildHeadersTo (..), Capture', CaptureAll, Description,
73− EmptyAPI, Fragment, FramingRender (..), FramingUnrender (..),
66+ EmptyAPI, FramingRender (..), FramingUnrender (..),
74 FromSourceIO (..), Header', Headers (..), HttpVersion,
67 FromSourceIO (..), Header', Headers (..), HttpVersion,
75 IsSecure, MimeRender (mimeRender),
68 IsSecure, MimeRender (mimeRender),
76− MimeUnrender (mimeUnrender), NoContent (NoContent),
69+ MimeUnrender (mimeUnrender), NoContent (NoContent), QueryFlag,
77− NoContentVerb, QueryFlag, QueryParam', QueryParams, Raw,
70+ QueryParam', QueryParams, Raw, ReflectMethod (..), RemoteHost,
78− ReflectMethod (..), RemoteHost, ReqBody', SBoolI, Stream,
79− StreamBody', Summary, ToHttpApiData, ToSourceIO (..), Vault,
71+ ReqBody', SBoolI, Stream, StreamBody', Summary, ToHttpApiData,
72+ ToSourceIO (..), Vault, Verb, NoContentVerb, WithNamedContext,
80− Verb, WithNamedContext, WithStatus (..), contentType, getHeadersHList,
73+ contentType, getHeadersHList, getResponse, toQueryParam,
81− getResponse, toEncodedUrlPiece, toUrlPiece, NamedRoutes)
74+ toUrlPiece)
82−import Servant.API.Generic
83− (GenericMode(..), ToServant, ToServantApi
84− , GenericServant, toServant, fromServant)
85import Servant.API.ContentTypes
75import Servant.API.ContentTypes
86 (contentTypes, AllMime (allMime), AllMimeUnrender (allMimeUnrender))
76 (contentTypes, AllMime (allMime), AllMimeUnrender (allMimeUnrender))
87−import Servant.API.Status
89−import Servant.API.TypeLevel (FragmentUnique, AtLeastOneFragment)
90import Servant.API.Modifiers
77import Servant.API.Modifiers
91 (FoldRequired, RequiredArgument, foldRequiredArgument)
78 (FoldRequired, RequiredArgument, foldRequiredArgument)
92−import Servant.API.TypeErrors
93import Servant.API.UVerb
79import Servant.API.UVerb
94 (HasStatus, HasStatuses (Statuses, statuses), UVerb, Union, Unique, inject, statusOf, foldMapUnion, matchUnion)
80 (HasStatus, HasStatuses (Statuses, statuses), UVerb, Union, Unique, inject, statusOf, foldMapUnion, matchUnion)
@@ -208,7 +194,7 @@ instance (KnownSymbol capture, ToHttpApiData a, HasClient m api)
208 clientWithRoute pm (Proxy :: Proxy api)
194 clientWithRoute pm (Proxy :: Proxy api)
209 (appendToPath p req)
195 (appendToPath p req)
211− where p = toEncodedUrlPiece val
197+ where p = (toUrlPiece val)
213 hoistClientMonad pm _ f cl = \a ->
199 hoistClientMonad pm _ f cl = \a ->
214 hoistClientMonad pm (Proxy :: Proxy api) f (cl a)
200 hoistClientMonad pm (Proxy :: Proxy api) f (cl a)
@@ -243,7 +229,7 @@ instance (KnownSymbol capture, ToHttpApiData a, HasClient m sublayout)
243 clientWithRoute pm (Proxy :: Proxy sublayout)
229 clientWithRoute pm (Proxy :: Proxy sublayout)
244 (foldl' (flip appendToPath) req ps)
230 (foldl' (flip appendToPath) req ps)
246− where ps = map toEncodedUrlPiece vals
232+ where ps = map (toUrlPiece) vals
248 hoistClientMonad pm _ f cl = \as ->
234 hoistClientMonad pm _ f cl = \as ->
249 hoistClientMonad pm (Proxy :: Proxy sublayout) f (cl as)
235 hoistClientMonad pm (Proxy :: Proxy sublayout) f (cl as)
@@ -251,11 +237,10 @@ instance (KnownSymbol capture, ToHttpApiData a, HasClient m sublayout)
251instance {-# OVERLAPPABLE #-}
237instance {-# OVERLAPPABLE #-}
252 -- Note [Non-Empty Content Types]
238 -- Note [Non-Empty Content Types]
253 ( RunClient m, MimeUnrender ct a, ReflectMethod method, cts' ~ (ct ': cts)
239 ( RunClient m, MimeUnrender ct a, ReflectMethod method, cts' ~ (ct ': cts)
255 ) => HasClient m (Verb method status cts' a) where
240 ) => HasClient m (Verb method status cts' a) where
256 type Client m (Verb method status cts' a) = m a
241 type Client m (Verb method status cts' a) = m a
257 clientWithRoute _pm Proxy req = do
242 clientWithRoute _pm Proxy req = do
258− response <- runRequestAcceptStatus (Just [status]) req
243+ response <- runRequest req
259 { requestAccept = fromList $ toList accept
244 { requestAccept = fromList $ toList accept
260 , requestMethod = method
245 , requestMethod = method
@@ -263,20 +248,18 @@ instance {-# OVERLAPPABLE #-}
264 accept = contentTypes (Proxy :: Proxy ct)
249 accept = contentTypes (Proxy :: Proxy ct)
265 method = reflectMethod (Proxy :: Proxy method)
250 method = reflectMethod (Proxy :: Proxy method)
266− status = statusFromNat (Proxy :: Proxy status)
268 hoistClientMonad _ _ f ma = f ma
252 hoistClientMonad _ _ f ma = f ma
270instance {-# OVERLAPPING #-}
254instance {-# OVERLAPPING #-}
271− ( RunClient m, ReflectMethod method, KnownNat status
255+ ( RunClient m, ReflectMethod method
272 ) => HasClient m (Verb method status cts NoContent) where
256 ) => HasClient m (Verb method status cts NoContent) where
273 type Client m (Verb method status cts NoContent)
257 type Client m (Verb method status cts NoContent)
274 = m NoContent
258 = m NoContent
275 clientWithRoute _pm Proxy req = do
259 clientWithRoute _pm Proxy req = do
276− _response <- runRequestAcceptStatus (Just [status]) req { requestMethod = method }
260+ _response <- runRequest req { requestMethod = method }
277 return NoContent
261 return NoContent
278 where method = reflectMethod (Proxy :: Proxy method)
262 where method = reflectMethod (Proxy :: Proxy method)
279− status = statusFromNat (Proxy :: Proxy status)
281 hoistClientMonad _ _ f ma = f ma
264 hoistClientMonad _ _ f ma = f ma
@@ -293,13 +276,13 @@ instance (RunClient m, ReflectMethod method) =>
294instance {-# OVERLAPPING #-}
277instance {-# OVERLAPPING #-}
295 -- Note [Non-Empty Content Types]
278 -- Note [Non-Empty Content Types]
296− ( RunClient m, MimeUnrender ct a, BuildHeadersTo ls, KnownNat status
279+ ( RunClient m, MimeUnrender ct a, BuildHeadersTo ls
297 , ReflectMethod method, cts' ~ (ct ': cts)
280 , ReflectMethod method, cts' ~ (ct ': cts)
298 ) => HasClient m (Verb method status cts' (Headers ls a)) where
281 ) => HasClient m (Verb method status cts' (Headers ls a)) where
299 type Client m (Verb method status cts' (Headers ls a))
282 type Client m (Verb method status cts' (Headers ls a))
300 = m (Headers ls a)
283 = m (Headers ls a)
301 clientWithRoute _pm Proxy req = do
284 clientWithRoute _pm Proxy req = do
302− response <- runRequestAcceptStatus (Just [status]) req
285+ response <- runRequest req
303 { requestMethod = method
286 { requestMethod = method
304 , requestAccept = fromList $ toList accept
287 , requestAccept = fromList $ toList accept
@@ -307,51 +290,28 @@ instance {-# OVERLAPPING #-}
307 return $ Headers { getResponse = val
290 return $ Headers { getResponse = val
308 , getHeadersHList = buildHeadersTo . toList $ responseHeaders response
291 , getHeadersHList = buildHeadersTo . toList $ responseHeaders response
311− method = reflectMethod (Proxy :: Proxy method)
293+ where method = reflectMethod (Proxy :: Proxy method)
312− accept = contentTypes (Proxy :: Proxy ct)
294+ accept = contentTypes (Proxy :: Proxy ct)
313− status = statusFromNat (Proxy :: Proxy status)
315 hoistClientMonad _ _ f ma = f ma
296 hoistClientMonad _ _ f ma = f ma
317instance {-# OVERLAPPING #-}
298instance {-# OVERLAPPING #-}
318− ( RunClient m, BuildHeadersTo ls, ReflectMethod method, KnownNat status
299+ ( RunClient m, BuildHeadersTo ls, ReflectMethod method
319 ) => HasClient m (Verb method status cts (Headers ls NoContent)) where
300 ) => HasClient m (Verb method status cts (Headers ls NoContent)) where
320 type Client m (Verb method status cts (Headers ls NoContent))
301 type Client m (Verb method status cts (Headers ls NoContent))
321 = m (Headers ls NoContent)
302 = m (Headers ls NoContent)
322 clientWithRoute _pm Proxy req = do
303 clientWithRoute _pm Proxy req = do
304+ let method = reflectMethod (Proxy :: Proxy method)
323− response <- runRequestAcceptStatus (Just [status]) req { requestMethod = method }
305+ response <- runRequest req { requestMethod = method }
324 return $ Headers { getResponse = NoContent
306 return $ Headers { getResponse = NoContent
325 , getHeadersHList = buildHeadersTo . toList $ responseHeaders response
307 , getHeadersHList = buildHeadersTo . toList $ responseHeaders response
328− method = reflectMethod (Proxy :: Proxy method)
329− status = statusFromNat (Proxy :: Proxy status)
331 hoistClientMonad _ _ f ma = f ma
310 hoistClientMonad _ _ f ma = f ma
333data ClientParseError = ClientParseError MediaType String | ClientStatusMismatch | ClientNoMatchingStatus
312data ClientParseError = ClientParseError MediaType String | ClientStatusMismatch | ClientNoMatchingStatus
334 deriving (Eq, Show)
313 deriving (Eq, Show)
336−class UnrenderResponse (cts :: [*]) (a :: *) where
337− unrenderResponse :: Seq.Seq H.Header -> BL.ByteString -> Proxy cts
338− -> [Either (MediaType, String) a]
340−instance {-# OVERLAPPABLE #-} AllMimeUnrender cts a => UnrenderResponse cts a where
341− unrenderResponse _ body = map parse . allMimeUnrender
342− where parse (mediaType, parser) = left ((,) mediaType) (parser body)
344−instance {-# OVERLAPPING #-} forall cts a h . (UnrenderResponse cts a, BuildHeadersTo h)
345− => UnrenderResponse cts (Headers h a) where
346− unrenderResponse hs body = (map . fmap) setHeaders . unrenderResponse hs body
348− setHeaders :: a -> Headers h a
349− setHeaders x = Headers x (buildHeadersTo (toList hs))
351−instance {-# OVERLAPPING #-} UnrenderResponse cts a
352− => UnrenderResponse cts (WithStatus n a) where
353− unrenderResponse hs body = (map . fmap) WithStatus . unrenderResponse hs body
355instance {-# OVERLAPPING #-}
315instance {-# OVERLAPPING #-}
356 ( RunClient m,
316 ( RunClient m,
357 contentTypes ~ (contentType ': otherContentTypes),
317 contentTypes ~ (contentType ': otherContentTypes),
@@ -360,7 +320,7 @@ instance {-# OVERLAPPING #-}
360 as ~ (a ': as'),
320 as ~ (a ': as'),
361 AllMime contentTypes,
321 AllMime contentTypes,
362 ReflectMethod method,
322 ReflectMethod method,
363− All (UnrenderResponse contentTypes) as,
323+ All (AllMimeUnrender contentTypes) as,
364 All HasStatus as, HasStatuses as',
324 All HasStatus as, HasStatuses as',
365 Unique (Statuses as)
325 Unique (Statuses as)
@@ -383,8 +343,7 @@ instance {-# OVERLAPPING #-}
384 let status = responseStatusCode response
344 let status = responseStatusCode response
385 body = responseBody response
345 body = responseBody response
386− headers = responseHeaders response
387− res = tryParsers status $ mimeUnrenders (Proxy @contentTypes) headers body
346+ res = tryParsers status $ mimeUnrenders (Proxy @contentTypes) body
388 case res of
347 case res of
389 Left errors -> throwClientError $ DecodeFailure (T.pack (show errors)) response
348 Left errors -> throwClientError $ DecodeFailure (T.pack (show errors)) response
390 Right x -> return x
349 Right x -> return x
@@ -405,14 +364,13 @@ instance {-# OVERLAPPING #-}
405 -- | Given a list of types, parses the given response body as each type
364 -- | Given a list of types, parses the given response body as each type
406 mimeUnrenders ::
365 mimeUnrenders ::
407 forall cts xs.
366 forall cts xs.
408− All (UnrenderResponse cts) xs =>
367+ All (AllMimeUnrender cts) xs =>
409 Proxy cts ->
368 Proxy cts ->
411 BL.ByteString ->
369 BL.ByteString ->
412 NP ([] :.: Either (MediaType, String)) xs
370 NP ([] :.: Either (MediaType, String)) xs
413− mimeUnrenders ctp headers body = cpure_NP
371+ mimeUnrenders ctp body = cpure_NP
414− (Proxy @(UnrenderResponse cts))
372+ (Proxy @(AllMimeUnrender cts))
415− (Comp . unrenderResponse headers body $ ctp)
373+ (Comp . map (\(mediaType, parser) -> left ((,) mediaType) (parser body)) . allMimeUnrender $ ctp)
417 hoistClientMonad _ _ nt s = nt s
375 hoistClientMonad _ _ nt s = nt s
@@ -569,7 +527,7 @@ instance (KnownSymbol sym, ToHttpApiData a, HasClient m api, SBoolI (FoldRequire
569 (Proxy :: Proxy mods) add (maybe req add) mparam
527 (Proxy :: Proxy mods) add (maybe req add) mparam
571 add :: a -> Request
529 add :: a -> Request
572− add param = appendToQueryString pname (Just $ encodeQueryParamValue param) req
530+ add param = appendToQueryString pname (Just $ toQueryParam param) req
574 pname :: Text
532 pname :: Text
575 pname = pack $ symbolVal (Proxy :: Proxy sym)
533 pname = pack $ symbolVal (Proxy :: Proxy sym)
@@ -618,7 +576,7 @@ instance (KnownSymbol sym, ToHttpApiData a, HasClient m api)
620 where pname = pack $ symbolVal (Proxy :: Proxy sym)
578 where pname = pack $ symbolVal (Proxy :: Proxy sym)
621− paramlist' = map (Just . encodeQueryParamValue) paramlist
579+ paramlist' = map (Just . toQueryParam) paramlist
623 hoistClientMonad pm _ f cl = \as ->
581 hoistClientMonad pm _ f cl = \as ->
624 hoistClientMonad pm (Proxy :: Proxy api) f (cl as)
582 hoistClientMonad pm (Proxy :: Proxy api) f (cl as)
@@ -740,7 +698,7 @@ instance (KnownSymbol path, HasClient m api) => HasClient m (path :> api) where
740 clientWithRoute pm (Proxy :: Proxy api)
698 clientWithRoute pm (Proxy :: Proxy api)
741 (appendToPath p req)
699 (appendToPath p req)
743− where p = toEncodedUrlPiece $ pack $ symbolVal (Proxy :: Proxy path)
701+ where p = pack $ symbolVal (Proxy :: Proxy path)
745 hoistClientMonad pm _ f cl = hoistClientMonad pm (Proxy :: Proxy api) f cl
703 hoistClientMonad pm _ f cl = hoistClientMonad pm (Proxy :: Proxy api) f cl
@@ -787,29 +745,6 @@ instance ( HasClient m api
787 hoistClientMonad pm _ f cl = \authreq ->
745 hoistClientMonad pm _ f cl = \authreq ->
788 hoistClientMonad pm (Proxy :: Proxy api) f (cl authreq)
746 hoistClientMonad pm (Proxy :: Proxy api) f (cl authreq)
790−-- | Ignore @'Fragment'@ in client functions.
791−-- See <https://ietf.org/rfc/rfc2616.html#section-15.1.3> for more details.
795−-- > type MyApi = "books" :> Fragment Text :> Get '[JSON] [Book]
797−-- > myApi :: Proxy MyApi
800−-- > getBooks :: ClientM [Book]
801−-- > getBooks = client myApi
802−-- > -- then you can just use "getBooksBy" to query that endpoint.
803−-- > -- 'getBooks' for all books.
804−instance (AtLeastOneFragment api, FragmentUnique (Fragment a :> api), HasClient m api
805− ) => HasClient m (Fragment a :> api) where
807− type Client m (Fragment a :> api) = Client m api
809− clientWithRoute pm _ = clientWithRoute pm (Proxy :: Proxy api)
811− hoistClientMonad pm _ = hoistClientMonad pm (Proxy :: Proxy api)
813-- * Basic Authentication
748-- * Basic Authentication
815instance HasClient m api => HasClient m (BasicAuth realm usr :> api) where
750instance HasClient m api => HasClient m (BasicAuth realm usr :> api) where
@@ -821,119 +756,6 @@ instance HasClient m api => HasClient m (BasicAuth realm usr :> api) where
821 hoistClientMonad pm _ f cl = \bauth ->
756 hoistClientMonad pm _ f cl = \bauth ->
822 hoistClientMonad pm (Proxy :: Proxy api) f (cl bauth)
757 hoistClientMonad pm (Proxy :: Proxy api) f (cl bauth)
824−-- | A type that specifies that an API record contains a client implementation.
825−data AsClientT (m :: * -> *)
826−instance GenericMode (AsClientT m) where
827− type AsClientT m :- api = Client m api
830−type GClientConstraints api m =
831− ( GenericServant api (AsClientT m)
832− , Client m (ToServantApi api) ~ ToServant api (AsClientT m)
835−class GClient (api :: * -> *) m where
836− gClientProof :: Dict (GClientConstraints api m)
838−instance GClientConstraints api m => GClient api m where
842− ( forall n. GClient api n
843− , HasClient m (ToServantApi api)
846− => HasClient m (NamedRoutes api) where
847− type Client m (NamedRoutes api) = api (AsClientT m)
849− clientWithRoute :: Proxy m -> Proxy (NamedRoutes api) -> Request -> Client m (NamedRoutes api)
850− clientWithRoute pm _ request =
851− case gClientProof @api @m of
852− Dict -> fromServant $ clientWithRoute pm (Proxy @(ToServantApi api)) request
857− -> Proxy (NamedRoutes api)
858− -> (forall x. ma x -> mb x)
859− -> Client ma (NamedRoutes api)
860− -> Client mb (NamedRoutes api)
861− hoistClientMonad _ _ nat clientA =
862− case (gClientProof @api @ma, gClientProof @api @mb) of
864− fromServant @api @(AsClientT mb) $
865− hoistClientMonad @m @(ToServantApi api) @ma @mb Proxy Proxy nat $
866− toServant @api @(AsClientT ma) clientA
871−-- | Helper to make code using records of clients more readable.
873−-- Can be mixed with (/:) for supplying arguments.
878−-- type Api = NamedRoutes RootApi
880−-- data RootApi mode = RootApi
881−-- { subApi :: mode :- NamedRoutes SubApi
883−-- } deriving Generic
885−-- data SubApi mode = SubApi
886−-- { endpoint :: mode :- Get '[JSON] Person
888−-- } deriving Generic
893−-- rootClient :: RootApi (AsClientT ClientM)
894−-- rootClient = client api
896−-- endpointClient :: ClientM Person
897−-- endpointClient = client // subApi // endpoint
899−(//) :: a -> (a -> b) -> b
902−-- | Convenience function for supplying arguments to client functions when
903−-- working with records of clients.
905−-- Intended to be used in conjunction with '(//)'.
910−-- type Api = NamedRoutes RootApi
912−-- data RootApi mode = RootApi
913−-- { subApi :: mode :- Capture "token" String :> NamedRoutes SubApi
914−-- , hello :: mode :- Capture "name" String :> Get '[JSON] String
916−-- } deriving Generic
918−-- data SubApi mode = SubApi
919−-- { endpoint :: mode :- Get '[JSON] Person
921−-- } deriving Generic
926−-- rootClient :: RootApi (AsClientT ClientM)
927−-- rootClient = client api
929−-- hello :: String -> ClientM String
930−-- hello name = rootClient // hello /: name
932−-- endpointClient :: ClientM Person
933−-- endpointClient = client // subApi /: "foobar123" // endpoint
935−(/:) :: (a -> b -> c) -> b -> a -> c
939{- Note [Non-Empty Content Types]
761{- Note [Non-Empty Content Types]
@@ -959,7 +781,7 @@ for empty and one for non-empty lists).
959checkContentTypeHeader :: RunClient m => Response -> m MediaType
781checkContentTypeHeader :: RunClient m => Response -> m MediaType
960checkContentTypeHeader response =
782checkContentTypeHeader response =
961 case lookup "Content-Type" $ toList $ responseHeaders response of
783 case lookup "Content-Type" $ toList $ responseHeaders response of
962− Nothing -> return $ "application" Media.// "octet-stream"
784+ Nothing -> return $ "application"//"octet-stream"
963 Just t -> case parseAccept t of
785 Just t -> case parseAccept t of
964 Nothing -> throwClientError $ InvalidContentTypeHeader response
786 Nothing -> throwClientError $ InvalidContentTypeHeader response
965 Just t' -> return t'
787 Just t' -> return t'
@@ -975,19 +797,3 @@ decodedAs response ct = do
975 Right val -> return val
797 Right val -> return val
977 accept = toList $ contentTypes ct
799 accept = toList $ contentTypes ct
979−-------------------------------------------------------------------------------
980−-- Custom type errors
981−-------------------------------------------------------------------------------
983−-- Erroring instance for HasClient' when a combinator is not fully applied
984−instance (RunClient m, TypeError (PartialApplication HasClient arr)) => HasClient m ((arr :: a -> b) :> sub)
986− type Client m (arr :> sub) = TypeError (PartialApplication HasClient arr)
987− clientWithRoute _ _ _ = error "unreachable"
988− hoistClientMonad _ _ _ _ = error "unreachable"
990−-- Erroring instances for 'HasClient' for unknown API combinators
991−instance {-# OVERLAPPABLE #-} (RunClient m, TypeError (NoInstanceForSub (HasClient m) ty)) => HasClient m (ty :> sub)
993−instance {-# OVERLAPPABLE #-} (RunClient m, TypeError (NoInstanceFor (HasClient m api))) => HasClient m api