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

-- | Cargo's native read capabilities require measured metadata charge factors.
module Ecluse.Core.Registry.Cargo.Adapter (
    cargoAdapter,
) where

import Data.Map.Strict qualified as Map

import Ecluse.Core.Ecosystem (Ecosystem (Cargo))
import Ecluse.Core.Registry (UrlFormationError (UnparseableUrl))
import Ecluse.Core.Registry.Adapter.Capability (AdapterArtifact (..), AdapterMaintenance (..), AdapterMetadata (..), PrivateArtifactAddressing (AdmittedIndexedArtifactLocation))
import Ecluse.Core.Registry.Adapter.Types (AdapterServe (..), RegistryAdapter (..))
import Ecluse.Core.Registry.Cargo.Credential (cargoCredential)
import Ecluse.Core.Registry.Cargo.FirstParty (cargoFirstPartyNames)
import Ecluse.Core.Registry.Cargo.Metadata (prepareCargoRead)
import Ecluse.Core.Registry.Cargo.Project (cargoNameChars, projectName)
import Ecluse.Core.Registry.Cargo.Publish (cargoPublish)
import Ecluse.Core.Registry.Cargo.Request (cargoArtifactHosts, cargoArtifactRequest)
import Ecluse.Core.Registry.Cargo.Route (cargoRouteSpecs, cargoRouter)
import Ecluse.Core.Registry.Cargo.Serving (assembleCargoDocument, serialiseCargoDocument)
import Ecluse.Core.Registry.FirstParty (FirstPartyDeclaration (FirstPartyDeclaration))
import Ecluse.Core.Registry.Maintenance.NameSpace (mkNameAlphabet)
import Ecluse.Core.Rules.Types (RuleType (AllowScopeType, DenyIfDeprecatedType, DenyInstallTimeExecutionType))
import Ecluse.Core.Server.Admission.Types (ChargeFactors)

-- | Supply native measurements before registering the adapter in the runtime.
cargoAdapter :: ChargeFactors -> RegistryAdapter
cargoAdapter :: ChargeFactors -> RegistryAdapter
cargoAdapter ChargeFactors
factors =
    RegistryAdapter
        { adapterEcosystem :: Ecosystem
adapterEcosystem = Ecosystem
Cargo
        , adapterRuleBlocks :: Map RuleType Text
adapterRuleBlocks =
            [(RuleType, Text)] -> Map RuleType Text
forall k a. Ord k => [(k, a)] -> Map k a
Map.fromList
                [ (RuleType
DenyInstallTimeExecutionType, Text
"Cargo's sparse index does not declare build scripts or procedural macros. This rule is unsupported for the ecosystem.")
                , (RuleType
DenyIfDeprecatedType, Text
"Cargo's sparse index supplies no deprecation flag.")
                , (RuleType
AllowScopeType, Text
"Cargo package names have no scope.")
                ]
        , adapterServe :: AdapterServe
adapterServe =
            AdapterServe
                { serveRouter :: MountRouter
serveRouter = MountRouter
cargoRouter
                , serveRoutes :: NonEmpty RouteSpec
serveRoutes = NonEmpty RouteSpec
cargoRouteSpecs
                , serveCredential :: CredentialMapping
serveCredential = CredentialMapping
cargoCredential
                }
        , adapterMetadata :: AdapterMetadata
adapterMetadata =
            AdapterMetadata
                { metadataRead :: PrepareRead
metadataRead = PrepareRead
prepareCargoRead
                , metadataAssemble :: Text
-> Map SourceId (Snapshot CachedDoc)
-> MergePlan
-> Maybe CachedDoc
-> CachedDoc
metadataAssemble = Text
-> Map SourceId (Snapshot CachedDoc)
-> MergePlan
-> Maybe CachedDoc
-> CachedDoc
assembleCargoDocument
                , metadataSerialise :: CachedDoc -> Either RenderRefused LByteString
metadataSerialise = CachedDoc -> Either RenderRefused LByteString
serialiseCargoDocument
                , metadataChargeFactors :: ChargeFactors
metadataChargeFactors = ChargeFactors
factors
                }
        , adapterArtifact :: AdapterArtifact
adapterArtifact =
            AdapterArtifact
                { artifactByFile :: OriginClient
-> PackageName -> Text -> Either UrlFormationError Request
artifactByFile = \OriginClient
_ PackageName
_ Text
_ -> UrlFormationError -> Either UrlFormationError Request
forall a b. a -> Either a b
Left (Text -> UrlFormationError
UnparseableUrl Text
"Cargo archives require an index-selected location")
                , artifactByUrl :: Maybe ClientCredential -> Text -> Either UrlFormationError Request
artifactByUrl = Maybe ClientCredential -> Text -> Either UrlFormationError Request
cargoArtifactRequest
                , artifactHosts :: [Text]
artifactHosts = [Text]
cargoArtifactHosts
                , artifactPrivateAddressing :: PrivateArtifactAddressing
artifactPrivateAddressing = PrivateArtifactAddressing
AdmittedIndexedArtifactLocation
                }
        , adapterProjectName :: ProjectName
adapterProjectName = Either ParseError PackageName -> Maybe PackageName
forall l r. Either l r -> Maybe r
rightToMaybe (Either ParseError PackageName -> Maybe PackageName)
-> (Text -> Either ParseError PackageName) -> ProjectName
forall b c a. (b -> c) -> (a -> b) -> a -> c
. Text -> Either ParseError PackageName
projectName
        , adapterFirstParty :: FirstPartyDeclaration
adapterFirstParty = FirstPartyNames CargoFirstParty -> FirstPartyDeclaration
forall entry.
(Eq entry, Show entry, Typeable entry) =>
FirstPartyNames entry -> FirstPartyDeclaration
FirstPartyDeclaration FirstPartyNames CargoFirstParty
cargoFirstPartyNames
        , adapterPublish :: Maybe AdapterPublish
adapterPublish = AdapterPublish -> Maybe AdapterPublish
forall a. a -> Maybe a
Just (ChargeFactors -> AdapterPublish
cargoPublish ChargeFactors
factors)
        , adapterMaintenance :: AdapterMaintenance
adapterMaintenance =
            AdapterMaintenance
                { maintenanceListing :: Maybe StoreListing
maintenanceListing = Maybe StoreListing
forall a. Maybe a
Nothing
                , maintenanceVersionDelete :: Maybe VersionDelete
maintenanceVersionDelete = Maybe VersionDelete
forall a. Maybe a
Nothing
                , maintenanceAlphabet :: NameAlphabet
maintenanceAlphabet = String -> NameAlphabet
mkNameAlphabet String
cargoNameChars
                }
        }