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

-- | Sparse index paths and native request credentials over the shared sealed transport.
module Ecluse.Core.Registry.Cargo.Request (
    cargoArtifactHosts,
    cargoIndexPath,
    cargoPrefix,
    cargoIndexRequest,
    cargoConfigRequest,
    cargoArtifactRequest,
) where

import Data.Text qualified as T
import Network.HTTP.Client (Request)

import Ecluse.Core.Credential (ClientCredential)
import Ecluse.Core.Package (PackageName, renderPackageName)
import Ecluse.Core.Registry (UrlFormationError (UnparseableUrl))
import Ecluse.Core.Registry.Cargo.Credential (cargoCredential)
import Ecluse.Core.Registry.Cargo.Project (cargoNameKey, projectName)
import Ecluse.Core.Registry.Request (BaseRequest, artifactRequestByUrl, metadataGet, requestAt)
import Ecluse.Core.Server.Path (encodeComponent)

-- | Public archive hosts are declared independently of discovery responses.
cargoArtifactHosts :: [Text]
cargoArtifactHosts :: [Text]
cargoArtifactHosts = [Text
"https://static.crates.io"]

-- | Prefix spelling follows Cargo's length rule and preserves its input's case.
cargoPrefix :: Text -> Text
cargoPrefix :: Text -> Text
cargoPrefix Text
name = case Text -> Int -> Ordering
T.compareLength Text
name Int
3 of
    Ordering
LT
        | Text -> Bool
T.null Text
name -> Text
""
        | Text -> Int -> Ordering
T.compareLength Text
name Int
1 Ordering -> Ordering -> Bool
forall a. Eq a => a -> a -> Bool
== Ordering
EQ -> Text
"1"
        | Bool
otherwise -> Text
"2"
    Ordering
EQ -> Text
"3/" Text -> Text -> Text
forall a. Semigroup a => a -> a -> a
<> Int -> Text -> Text
T.take Int
1 Text
name
    Ordering
GT -> Int -> Text -> Text
T.take Int
2 Text
name Text -> Text -> Text
forall a. Semigroup a => a -> a -> a
<> Text
"/" Text -> Text -> Text
forall a. Semigroup a => a -> a -> a
<> Int -> Text -> Text
T.take Int
2 (Int -> Text -> Text
T.drop Int
2 Text
name)

-- | Derive a sparse lookup path, folding ASCII case alone.
cargoIndexPath :: PackageName -> Text
cargoIndexPath :: PackageName -> Text
cargoIndexPath PackageName
name = Text -> Text
cargoPrefix Text
key Text -> Text -> Text
forall a. Semigroup a => a -> a -> a
<> Text
"/" Text -> Text -> Text
forall a. Semigroup a => a -> a -> a
<> Text -> Text
encodeComponent Text
key
  where
    key :: Text
key = Text -> Text
cargoNameKey (PackageName -> Text
renderPackageName PackageName
name)

-- | Fetch one native index file under the selected origin's credential posture.
cargoIndexRequest :: BaseRequest -> Maybe ClientCredential -> PackageName -> Either UrlFormationError Request
cargoIndexRequest :: BaseRequest
-> Maybe ClientCredential
-> PackageName
-> Either UrlFormationError Request
cargoIndexRequest BaseRequest
base Maybe ClientCredential
token PackageName
name = do
    parsed <- (ParseError -> UrlFormationError)
-> Either ParseError PackageName
-> Either UrlFormationError PackageName
forall a b c. (a -> b) -> Either a c -> Either b c
forall (p :: * -> * -> *) a b c.
Bifunctor p =>
(a -> b) -> p a c -> p b c
first (UrlFormationError -> ParseError -> UrlFormationError
forall a b. a -> b -> a
const (Text -> UrlFormationError
UnparseableUrl Text
"invalid Cargo index name")) (Text -> Either ParseError PackageName
projectName (PackageName -> Text
renderPackageName PackageName
name))
    unless (parsed == name) (Left (UnparseableUrl "invalid Cargo index ecosystem"))
    metadataGet cargoCredential token "text/plain" <$> requestAt base (cargoIndexPath name)

-- | Fetch discovery only after the origin and its credentials exist.
cargoConfigRequest :: BaseRequest -> Maybe ClientCredential -> Either UrlFormationError Request
cargoConfigRequest :: BaseRequest
-> Maybe ClientCredential -> Either UrlFormationError Request
cargoConfigRequest BaseRequest
base Maybe ClientCredential
token = CredentialMapping
-> Maybe ClientCredential -> ByteString -> Request -> Request
metadataGet CredentialMapping
cargoCredential Maybe ClientCredential
token ByteString
"application/json" (Request -> Request)
-> Either UrlFormationError Request
-> Either UrlFormationError Request
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
<$> BaseRequest -> Text -> Either UrlFormationError Request
requestAt BaseRequest
base Text
"config.json"

-- | Fetch the metadata-bound archive URL without deriving identity from its terminal component.
cargoArtifactRequest :: Maybe ClientCredential -> Text -> Either UrlFormationError Request
cargoArtifactRequest :: Maybe ClientCredential -> Text -> Either UrlFormationError Request
cargoArtifactRequest = CredentialMapping
-> Maybe ClientCredential
-> Text
-> Either UrlFormationError Request
artifactRequestByUrl CredentialMapping
cargoCredential