-- SPDX-FileCopyrightText: 2026 Alexandra de Wit
--
-- SPDX-License-Identifier: MIT

-- | Closed Ruby metadata replies preserve admission and transport failures.
module Ecluse.Core.Registry.RubyGems.Route.Response (
    RubyResponse,
    rubyContract,
    rubyReplies,
    rubyBadRequest,
) where

import Network.HTTP.Types (status200, status304, status400, status401, status403, status404, status406, status500, status502, status503)

import Ecluse.Core.Server.Contract (BodySchema (SchemaOpaque, SchemaText), ResponseChoice (..), ResponseContract, ResponseValue, chooseContract, emptyContract, mediaContract, responseValue)
import Ecluse.Core.Server.Pipeline.Packument (PackumentReplies (..), mapPackumentReplies)
import Ecluse.Core.Server.Pipeline.Packument.Response (MetadataResponse, metadataReplies)
import Ecluse.Core.Server.Response (renderRefusal)
import Ecluse.Core.Server.Response.Summary (detailedRejections)

-- | Native successes and local errors have distinct declared status codes.
type RubyResponse = ResponseChoice (ResponseValue LByteString) (MetadataResponse LByteString)

-- | Match every local metadata result, including malformed native requests.
rubyContract :: ByteString -> ResponseContract RubyResponse
rubyContract :: ByteString -> ResponseContract RubyResponse
rubyContract ByteString
media =
    ResponseContract (ResponseValue LByteString)
-> ResponseContract (MetadataResponse LByteString)
-> ResponseContract RubyResponse
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract (Status -> Text -> ResponseContract (ResponseValue LByteString)
text Status
status400 Text
"The native request is malformed or exceeds its limits.") (ResponseContract (MetadataResponse LByteString)
 -> ResponseContract RubyResponse)
-> ResponseContract (MetadataResponse LByteString)
-> ResponseContract RubyResponse
forall a b. (a -> b) -> a -> b
$
        ResponseContract (ResponseValue LByteString)
-> ResponseContract
     (ResponseChoice
        (ResponseValue ())
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString)
                 (ResponseChoice
                    (ResponseValue LByteString)
                    (ResponseChoice
                       (ResponseValue LByteString)
                       (ResponseChoice
                          (ResponseValue LByteString) (ResponseValue LByteString))))))))
-> ResponseContract (MetadataResponse LByteString)
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract (Status
-> Text
-> BodySchema
-> ResponseContract (ResponseValue LByteString)
mediaContract Status
status200 Text
"Admitted native metadata." (ByteString -> BodySchema
SchemaOpaque ByteString
media)) (ResponseContract
   (ResponseChoice
      (ResponseValue ())
      (ResponseChoice
         (ResponseValue LByteString)
         (ResponseChoice
            (ResponseValue LByteString)
            (ResponseChoice
               (ResponseValue LByteString)
               (ResponseChoice
                  (ResponseValue LByteString)
                  (ResponseChoice
                     (ResponseValue LByteString)
                     (ResponseChoice
                        (ResponseValue LByteString) (ResponseValue LByteString))))))))
 -> ResponseContract (MetadataResponse LByteString))
-> ResponseContract
     (ResponseChoice
        (ResponseValue ())
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString)
                 (ResponseChoice
                    (ResponseValue LByteString)
                    (ResponseChoice
                       (ResponseValue LByteString)
                       (ResponseChoice
                          (ResponseValue LByteString) (ResponseValue LByteString))))))))
-> ResponseContract (MetadataResponse LByteString)
forall a b. (a -> b) -> a -> b
$
            ResponseContract (ResponseValue ())
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString)
                 (ResponseChoice
                    (ResponseValue LByteString)
                    (ResponseChoice
                       (ResponseValue LByteString) (ResponseValue LByteString)))))))
-> ResponseContract
     (ResponseChoice
        (ResponseValue ())
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString)
                 (ResponseChoice
                    (ResponseValue LByteString)
                    (ResponseChoice
                       (ResponseValue LByteString)
                       (ResponseChoice
                          (ResponseValue LByteString) (ResponseValue LByteString))))))))
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract (Status -> Text -> ResponseContract (ResponseValue ())
emptyContract Status
status304 Text
"The admitted representation is unchanged.") (ResponseContract
   (ResponseChoice
      (ResponseValue LByteString)
      (ResponseChoice
         (ResponseValue LByteString)
         (ResponseChoice
            (ResponseValue LByteString)
            (ResponseChoice
               (ResponseValue LByteString)
               (ResponseChoice
                  (ResponseValue LByteString)
                  (ResponseChoice
                     (ResponseValue LByteString) (ResponseValue LByteString)))))))
 -> ResponseContract
      (ResponseChoice
         (ResponseValue ())
         (ResponseChoice
            (ResponseValue LByteString)
            (ResponseChoice
               (ResponseValue LByteString)
               (ResponseChoice
                  (ResponseValue LByteString)
                  (ResponseChoice
                     (ResponseValue LByteString)
                     (ResponseChoice
                        (ResponseValue LByteString)
                        (ResponseChoice
                           (ResponseValue LByteString) (ResponseValue LByteString)))))))))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString)
                 (ResponseChoice
                    (ResponseValue LByteString)
                    (ResponseChoice
                       (ResponseValue LByteString) (ResponseValue LByteString)))))))
-> ResponseContract
     (ResponseChoice
        (ResponseValue ())
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString)
                 (ResponseChoice
                    (ResponseValue LByteString)
                    (ResponseChoice
                       (ResponseValue LByteString)
                       (ResponseChoice
                          (ResponseValue LByteString) (ResponseValue LByteString))))))))
forall a b. (a -> b) -> a -> b
$
                ResponseContract (ResponseValue LByteString)
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString)
                 (ResponseChoice
                    (ResponseValue LByteString) (ResponseValue LByteString))))))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString)
                 (ResponseChoice
                    (ResponseValue LByteString)
                    (ResponseChoice
                       (ResponseValue LByteString) (ResponseValue LByteString)))))))
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract (Status -> Text -> ResponseContract (ResponseValue LByteString)
text Status
status401 Text
"Authentication is required.") (ResponseContract
   (ResponseChoice
      (ResponseValue LByteString)
      (ResponseChoice
         (ResponseValue LByteString)
         (ResponseChoice
            (ResponseValue LByteString)
            (ResponseChoice
               (ResponseValue LByteString)
               (ResponseChoice
                  (ResponseValue LByteString) (ResponseValue LByteString))))))
 -> ResponseContract
      (ResponseChoice
         (ResponseValue LByteString)
         (ResponseChoice
            (ResponseValue LByteString)
            (ResponseChoice
               (ResponseValue LByteString)
               (ResponseChoice
                  (ResponseValue LByteString)
                  (ResponseChoice
                     (ResponseValue LByteString)
                     (ResponseChoice
                        (ResponseValue LByteString) (ResponseValue LByteString))))))))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString)
                 (ResponseChoice
                    (ResponseValue LByteString) (ResponseValue LByteString))))))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString)
                 (ResponseChoice
                    (ResponseValue LByteString)
                    (ResponseChoice
                       (ResponseValue LByteString) (ResponseValue LByteString)))))))
forall a b. (a -> b) -> a -> b
$
                    ResponseContract (ResponseValue LByteString)
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString) (ResponseValue LByteString)))))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString)
                 (ResponseChoice
                    (ResponseValue LByteString) (ResponseValue LByteString))))))
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract (Status -> Text -> ResponseContract (ResponseValue LByteString)
text Status
status403 Text
"Access or admission was refused.") (ResponseContract
   (ResponseChoice
      (ResponseValue LByteString)
      (ResponseChoice
         (ResponseValue LByteString)
         (ResponseChoice
            (ResponseValue LByteString)
            (ResponseChoice
               (ResponseValue LByteString) (ResponseValue LByteString)))))
 -> ResponseContract
      (ResponseChoice
         (ResponseValue LByteString)
         (ResponseChoice
            (ResponseValue LByteString)
            (ResponseChoice
               (ResponseValue LByteString)
               (ResponseChoice
                  (ResponseValue LByteString)
                  (ResponseChoice
                     (ResponseValue LByteString) (ResponseValue LByteString)))))))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString) (ResponseValue LByteString)))))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString)
                 (ResponseChoice
                    (ResponseValue LByteString) (ResponseValue LByteString))))))
forall a b. (a -> b) -> a -> b
$
                        ResponseContract (ResponseValue LByteString)
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString) (ResponseValue LByteString))))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString) (ResponseValue LByteString)))))
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract (Status -> Text -> ResponseContract (ResponseValue LByteString)
text Status
status404 Text
"The requested gem or coordinate is absent, the gem lists no version, or no version of the gem passed policy and admission.") (ResponseContract
   (ResponseChoice
      (ResponseValue LByteString)
      (ResponseChoice
         (ResponseValue LByteString)
         (ResponseChoice
            (ResponseValue LByteString) (ResponseValue LByteString))))
 -> ResponseContract
      (ResponseChoice
         (ResponseValue LByteString)
         (ResponseChoice
            (ResponseValue LByteString)
            (ResponseChoice
               (ResponseValue LByteString)
               (ResponseChoice
                  (ResponseValue LByteString) (ResponseValue LByteString))))))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString) (ResponseValue LByteString))))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString)
              (ResponseChoice
                 (ResponseValue LByteString) (ResponseValue LByteString)))))
forall a b. (a -> b) -> a -> b
$
                            ResponseContract (ResponseValue LByteString)
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString) (ResponseValue LByteString)))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString) (ResponseValue LByteString))))
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract (Status -> Text -> ResponseContract (ResponseValue LByteString)
text Status
status406 Text
"The representation is unavailable.") (ResponseContract
   (ResponseChoice
      (ResponseValue LByteString)
      (ResponseChoice
         (ResponseValue LByteString) (ResponseValue LByteString)))
 -> ResponseContract
      (ResponseChoice
         (ResponseValue LByteString)
         (ResponseChoice
            (ResponseValue LByteString)
            (ResponseChoice
               (ResponseValue LByteString) (ResponseValue LByteString)))))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString) (ResponseValue LByteString)))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString)
           (ResponseChoice
              (ResponseValue LByteString) (ResponseValue LByteString))))
forall a b. (a -> b) -> a -> b
$
                                ResponseContract (ResponseValue LByteString)
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString) (ResponseValue LByteString))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString) (ResponseValue LByteString)))
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract (Status -> Text -> ResponseContract (ResponseValue LByteString)
text Status
status500 Text
"The registry could not decide.") (ResponseContract
   (ResponseChoice
      (ResponseValue LByteString) (ResponseValue LByteString))
 -> ResponseContract
      (ResponseChoice
         (ResponseValue LByteString)
         (ResponseChoice
            (ResponseValue LByteString) (ResponseValue LByteString))))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString) (ResponseValue LByteString))
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString)
        (ResponseChoice
           (ResponseValue LByteString) (ResponseValue LByteString)))
forall a b. (a -> b) -> a -> b
$
                                    ResponseContract (ResponseValue LByteString)
-> ResponseContract (ResponseValue LByteString)
-> ResponseContract
     (ResponseChoice
        (ResponseValue LByteString) (ResponseValue LByteString))
forall a b.
ResponseContract a
-> ResponseContract b -> ResponseContract (ResponseChoice a b)
chooseContract (Status -> Text -> ResponseContract (ResponseValue LByteString)
text Status
status502 Text
"An origin reply was invalid or unusable.") (Status -> Text -> ResponseContract (ResponseValue LByteString)
text Status
status503 Text
"The registry is temporarily unavailable.")
  where
    text :: Status -> Text -> ResponseContract (ResponseValue LByteString)
text Status
status Text
description = Status
-> Text
-> BodySchema
-> ResponseContract (ResponseValue LByteString)
mediaContract Status
status Text
description (ByteString -> BodySchema
SchemaText ByteString
"text/plain")

-- | Preserve the shared failure classification, including a local 403 for a private 401 or 403, while encoding native bytes.
rubyReplies :: PackumentReplies RubyResponse
rubyReplies :: PackumentReplies RubyResponse
rubyReplies = (MetadataResponse LByteString -> RubyResponse)
-> PackumentReplies (MetadataResponse LByteString)
-> PackumentReplies RubyResponse
forall a b. (a -> b) -> PackumentReplies a -> PackumentReplies b
mapPackumentReplies MetadataResponse LByteString -> RubyResponse
forall a b. b -> ResponseChoice a b
SecondResponse (([ServeDecision] -> Text)
-> (Refusal -> LByteString)
-> PackumentReplies (MetadataResponse LByteString)
forall refusal.
([ServeDecision] -> Text)
-> (Refusal -> refusal)
-> PackumentReplies (MetadataResponse refusal)
metadataReplies [ServeDecision] -> Text
detailedRejections (ByteString -> LByteString
forall l s. LazyStrict l s => s -> l
fromStrict (ByteString -> LByteString)
-> (Refusal -> ByteString) -> Refusal -> LByteString
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Text -> ByteString
forall a b. ConvertUtf8 a b => a -> b
encodeUtf8 (Text -> ByteString) -> (Refusal -> Text) -> Refusal -> ByteString
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Refusal -> Text
renderRefusal))

-- | Refuse query syntax before admission or upstream work.
rubyBadRequest :: Text -> RubyResponse
rubyBadRequest :: Text -> RubyResponse
rubyBadRequest = ResponseValue LByteString -> RubyResponse
forall a b. a -> ResponseChoice a b
FirstResponse (ResponseValue LByteString -> RubyResponse)
-> (Text -> ResponseValue LByteString) -> Text -> RubyResponse
forall b c a. (b -> c) -> (a -> b) -> a -> c
. [Header] -> LByteString -> ResponseValue LByteString
forall a. [Header] -> a -> ResponseValue a
responseValue [] (LByteString -> ResponseValue LByteString)
-> (Text -> LByteString) -> Text -> ResponseValue LByteString
forall b c a. (b -> c) -> (a -> b) -> a -> c
. ByteString -> LByteString
forall l s. LazyStrict l s => s -> l
fromStrict (ByteString -> LByteString)
-> (Text -> ByteString) -> Text -> LByteString
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Text -> ByteString
forall a b. ConvertUtf8 a b => a -> b
encodeUtf8