module Ecluse.Core.Registry.Npm.Maintenance (
npmMaintenance,
listingRequestFor,
packumentRequestFor,
versionDeleteRequestsFor,
) where
import Data.Aeson (Object, Value (Object, String), decodeStrict, encode)
import Data.Aeson.Key qualified as Key
import Data.Aeson.KeyMap qualified as KeyMap
import Network.HTTP.Client (Request (method, requestHeaders))
import Network.HTTP.Types.Header (hAccept)
import Ecluse.Core.Ecosystem (Ecosystem (Npm))
import Ecluse.Core.Package (PackageName, unscopedName)
import Ecluse.Core.Registry (
RegistryResponse (responseBody),
UrlFormationError,
renderUrlFormationError,
)
import Ecluse.Core.Registry.Adapter.Capability (
AdapterMaintenance (..),
StoreListing (..),
VersionDelete (..),
)
import Ecluse.Core.Registry.Maintenance (StoreRefusal, storeRefusal)
import Ecluse.Core.Registry.Maintenance.NameSpace (mkNameAlphabet)
import Ecluse.Core.Registry.Npm.Document (tarballUrl)
import Ecluse.Core.Registry.Npm.Maintenance.Listing (packageListingWalk)
import Ecluse.Core.Registry.Npm.Project (npmNameLeadChars)
import Ecluse.Core.Registry.Npm.Request (
MetadataForm (Full),
artifactFileUrl,
jsonPutRequest,
metadataRequest,
packageUrl,
withToken,
)
import Ecluse.Core.Registry.Origin (OriginClient (ocToken), originBaseUrl)
import Ecluse.Core.Registry.Request (joinPath, parseRequestEither)
import Ecluse.Core.Registry.ServedDocument (adjustField)
import Ecluse.Core.Server.Path (encodeComponent, isSafeComponent)
import Ecluse.Core.Text (nonBlank, urlFilenameComponent)
import Ecluse.Core.Version (Version, compareVersions, mkVersion, renderVersion)
npmMaintenance :: AdapterMaintenance
npmMaintenance :: AdapterMaintenance
npmMaintenance =
AdapterMaintenance
{ maintenanceListing :: Maybe StoreListing
maintenanceListing =
StoreListing -> Maybe StoreListing
forall a. a -> Maybe a
Just
StoreListing
{ listingRequest :: OriginClient -> Either UrlFormationError Request
listingRequest = OriginClient -> Either UrlFormationError Request
listingRequestFor
, listingWalk :: Cursor -> Step [PackageName]
listingWalk = Cursor -> Step [PackageName]
packageListingWalk
}
, maintenanceVersionDelete :: Maybe VersionDelete
maintenanceVersionDelete =
VersionDelete -> Maybe VersionDelete
forall a. a -> Maybe a
Just
VersionDelete
{ deleteDocumentRequest :: OriginClient -> PackageName -> Either UrlFormationError Request
deleteDocumentRequest = OriginClient -> PackageName -> Either UrlFormationError Request
packumentRequestFor
, deleteRequests :: OriginClient
-> PackageName
-> Version
-> RegistryResponse
-> Either StoreRefusal (NonEmpty Request)
deleteRequests = OriginClient
-> PackageName
-> Version
-> RegistryResponse
-> Either StoreRefusal (NonEmpty Request)
versionDeleteRequestsFor
}
, maintenanceAlphabet :: NameAlphabet
maintenanceAlphabet = [Char] -> NameAlphabet
mkNameAlphabet [Char]
npmNameLeadChars
}
listingRequestFor :: OriginClient -> Either UrlFormationError Request
listingRequestFor :: OriginClient -> Either UrlFormationError Request
listingRequestFor OriginClient
origin = do
url <- Text -> Text -> Either UrlFormationError Text
joinPath (OriginClient -> Text
originBaseUrl OriginClient
origin) Text
"-/all"
base <- parseRequestEither url
pure . withToken (ocToken origin) $
base{requestHeaders = (hAccept, "application/json") : requestHeaders base}
packumentRequestFor :: OriginClient -> PackageName -> Either UrlFormationError Request
packumentRequestFor :: OriginClient -> PackageName -> Either UrlFormationError Request
packumentRequestFor OriginClient
origin =
Text
-> Maybe ClientCredential
-> MetadataForm
-> PackageName
-> Either UrlFormationError Request
metadataRequest (OriginClient -> Text
originBaseUrl OriginClient
origin) (OriginClient -> Maybe ClientCredential
ocToken OriginClient
origin) MetadataForm
Full
versionDeleteRequestsFor ::
OriginClient ->
PackageName ->
Version ->
RegistryResponse ->
Either StoreRefusal (NonEmpty Request)
versionDeleteRequestsFor :: OriginClient
-> PackageName
-> Version
-> RegistryResponse
-> Either StoreRefusal (NonEmpty Request)
versionDeleteRequestsFor OriginClient
origin PackageName
name Version
version RegistryResponse
response = do
packument <- Method -> Either StoreRefusal Object
decodePackument (RegistryResponse -> Method
responseBody RegistryResponse
response)
revision <- revisionOf packument
versions <- versionsOf packument
manifest <- manifestOf raw versions
if KeyMap.size versions == 1
then deleteWholePackage origin revision name
else
deleteOneVersion
origin
revision
name
(tarballFilename name version manifest)
(removeVersion raw versions packument)
where
raw :: Text
raw = Version -> Text
renderVersion Version
version
deleteWholePackage :: OriginClient -> Text -> PackageName -> Either StoreRefusal (NonEmpty Request)
deleteWholePackage :: OriginClient
-> Text -> PackageName -> Either StoreRefusal (NonEmpty Request)
deleteWholePackage OriginClient
origin Text
revision PackageName
name = do
request <- Either UrlFormationError Request -> Either StoreRefusal Request
forall a. Either UrlFormationError a -> Either StoreRefusal a
unformable (Text -> PackageName -> Either UrlFormationError Text
packageUrl (OriginClient -> Text
originBaseUrl OriginClient
origin) PackageName
name Either UrlFormationError Text
-> (Text -> Either UrlFormationError Request)
-> Either UrlFormationError Request
forall a b.
Either UrlFormationError a
-> (a -> Either UrlFormationError b) -> Either UrlFormationError b
forall (m :: * -> *) a b. Monad m => m a -> (a -> m b) -> m b
>>= OriginClient -> Text -> Text -> Either UrlFormationError Request
deleteAtRevision OriginClient
origin Text
revision)
pure (request :| [])
deleteOneVersion :: OriginClient -> Text -> PackageName -> Text -> Object -> Either StoreRefusal (NonEmpty Request)
deleteOneVersion :: OriginClient
-> Text
-> PackageName
-> Text
-> Object
-> Either StoreRefusal (NonEmpty Request)
deleteOneVersion OriginClient
origin Text
revision PackageName
name Text
filename Object
edited = do
editRequest <- Either UrlFormationError Request -> Either StoreRefusal Request
forall a. Either UrlFormationError a -> Either StoreRefusal a
unformable (OriginClient
-> PackageName
-> Text
-> Object
-> Either UrlFormationError Request
packumentPutRequest OriginClient
origin PackageName
name Text
revision Object
edited)
tarballRequest <- unformable (artifactFileUrl (originBaseUrl origin) name filename >>= deleteAtRevision origin revision)
pure (editRequest :| [tarballRequest])
unformable :: Either UrlFormationError a -> Either StoreRefusal a
unformable :: forall a. Either UrlFormationError a -> Either StoreRefusal a
unformable = (UrlFormationError -> StoreRefusal)
-> Either UrlFormationError a -> Either StoreRefusal a
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 (Text -> Text -> StoreRefusal
storeRefusal Text
"UNFORMABLE_URL" (Text -> StoreRefusal)
-> (UrlFormationError -> Text) -> UrlFormationError -> StoreRefusal
forall b c a. (b -> c) -> (a -> b) -> a -> c
. UrlFormationError -> Text
renderUrlFormationError)
decodePackument :: ByteString -> Either StoreRefusal Object
decodePackument :: Method -> Either StoreRefusal Object
decodePackument Method
body =
StoreRefusal -> Maybe Object -> Either StoreRefusal Object
forall l r. l -> Maybe r -> Either l r
maybeToRight
(Text -> Text -> StoreRefusal
storeRefusal Text
"UNREADABLE_DOCUMENT" Text
"the store's packument is not a JSON object")
(Method -> Maybe Object
forall a. FromJSON a => Method -> Maybe a
decodeStrict Method
body)
revisionOf :: Object -> Either StoreRefusal Text
revisionOf :: Object -> Either StoreRefusal Text
revisionOf Object
packument = case Key -> Object -> Maybe Value
forall v. Key -> KeyMap v -> Maybe v
KeyMap.lookup Key
"_rev" Object
packument of
Just (String Text
revision) | Text -> Bool
isSafeComponent Text
revision -> Text -> Either StoreRefusal Text
forall a b. b -> Either a b
Right Text
revision
Maybe Value
_ ->
StoreRefusal -> Either StoreRefusal Text
forall a b. a -> Either a b
Left (Text -> Text -> StoreRefusal
storeRefusal Text
"NO_REVISION" Text
"the store's packument carries no _rev an edit can address")
versionsOf :: Object -> Either StoreRefusal Object
versionsOf :: Object -> Either StoreRefusal Object
versionsOf Object
packument = case Key -> Object -> Maybe Value
forall v. Key -> KeyMap v -> Maybe v
KeyMap.lookup Key
"versions" Object
packument of
Just (Object Object
versions) -> Object -> Either StoreRefusal Object
forall a b. b -> Either a b
Right Object
versions
Maybe Value
_ ->
StoreRefusal -> Either StoreRefusal Object
forall a b. a -> Either a b
Left (Text -> Text -> StoreRefusal
storeRefusal Text
"UNREADABLE_DOCUMENT" Text
"the store's packument carries no versions object")
manifestOf :: Text -> Object -> Either StoreRefusal Value
manifestOf :: Text -> Object -> Either StoreRefusal Value
manifestOf Text
raw Object
versions =
StoreRefusal -> Maybe Value -> Either StoreRefusal Value
forall l r. l -> Maybe r -> Either l r
maybeToRight
(Text -> Text -> StoreRefusal
storeRefusal Text
"VERSION_ABSENT" Text
"the store's packument holds no such version")
(Key -> Object -> Maybe Value
forall v. Key -> KeyMap v -> Maybe v
KeyMap.lookup (Text -> Key
Key.fromText Text
raw) Object
versions)
packumentPutRequest :: OriginClient -> PackageName -> Text -> Object -> Either UrlFormationError Request
packumentPutRequest :: OriginClient
-> PackageName
-> Text
-> Object
-> Either UrlFormationError Request
packumentPutRequest OriginClient
origin PackageName
name Text
revision Object
packument = do
url <- Text -> Text -> Text
atRevision Text
revision (Text -> Text)
-> Either UrlFormationError Text -> Either UrlFormationError Text
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
<$> Text -> PackageName -> Either UrlFormationError Text
packageUrl (OriginClient -> Text
originBaseUrl OriginClient
origin) PackageName
name
jsonPutRequest (ocToken origin) url (toStrict (encode packument))
deleteAtRevision :: OriginClient -> Text -> Text -> Either UrlFormationError Request
deleteAtRevision :: OriginClient -> Text -> Text -> Either UrlFormationError Request
deleteAtRevision OriginClient
origin Text
revision Text
url = do
base <- Text -> Either UrlFormationError Request
parseRequestEither (Text -> Text -> Text
atRevision Text
revision Text
url)
pure
. withToken (ocToken origin)
$ base
{ method = "DELETE"
, requestHeaders = (hAccept, "application/json") : requestHeaders base
}
atRevision :: Text -> Text -> Text
atRevision :: Text -> Text -> Text
atRevision Text
revision Text
url = Text
url Text -> Text -> Text
forall a. Semigroup a => a -> a -> a
<> Text
"/-rev/" Text -> Text -> Text
forall a. Semigroup a => a -> a -> a
<> Text -> Text
encodeComponent Text
revision
removeVersion :: Text -> Object -> Object -> Object
removeVersion :: Text -> Object -> Object -> Object
removeVersion Text
raw Object
versions Object
packument =
Key -> Value -> Object -> Object
forall v. Key -> v -> KeyMap v -> KeyMap v
KeyMap.insert Key
"versions" (Object -> Value
Object Object
remaining) (Key -> (Value -> Value) -> Object -> Object
adjustField Key
"dist-tags" ((Object -> Object) -> Value -> Value
withinObject Object -> Object
retag) Object
prunedTime)
where
key :: Key
key = Text -> Key
Key.fromText Text
raw
remaining :: Object
remaining = Key -> Object -> Object
forall v. Key -> KeyMap v -> KeyMap v
KeyMap.delete Key
key Object
versions
prunedTime :: Object
prunedTime = Key -> (Value -> Value) -> Object -> Object
adjustField Key
"time" ((Object -> Object) -> Value -> Value
withinObject (Key -> Object -> Object
forall v. Key -> KeyMap v -> KeyMap v
KeyMap.delete Key
key)) Object
packument
retag :: Object -> Object
retag Object
tags = Object -> (Text -> Object) -> Maybe Text -> Object
forall b a. b -> (a -> b) -> Maybe a -> b
maybe Object
kept (\Text
latest -> Key -> Value -> Object -> Object
forall v. Key -> v -> KeyMap v -> KeyMap v
KeyMap.insert Key
"latest" (Text -> Value
String Text
latest) Object
kept) Maybe Text
restoredLatest
where
kept :: Object
kept = (Value -> Bool) -> Object -> Object
forall v. (v -> Bool) -> KeyMap v -> KeyMap v
KeyMap.filter (Value -> Value -> Bool
forall a. Eq a => a -> a -> Bool
/= Text -> Value
String Text
raw) Object
tags
restoredLatest :: Maybe Text
restoredLatest = do
Bool -> Maybe ()
forall (f :: * -> *). Alternative f => Bool -> f ()
guard (Key -> Object -> Maybe Value
forall v. Key -> KeyMap v -> Maybe v
KeyMap.lookup Key
"latest" Object
tags Maybe Value -> Maybe Value -> Bool
forall a. Eq a => a -> a -> Bool
== Value -> Maybe Value
forall a. a -> Maybe a
Just (Text -> Value
String Text
raw))
[Text] -> Maybe Text
greatestVersion ((Key -> Text) -> [Key] -> [Text]
forall a b. (a -> b) -> [a] -> [b]
map Key -> Text
Key.toText (Object -> [Key]
forall v. KeyMap v -> [Key]
KeyMap.keys Object
remaining))
withinObject :: (Object -> Object) -> Value -> Value
withinObject :: (Object -> Object) -> Value -> Value
withinObject Object -> Object
edit = \case
Object Object
inner -> Object -> Value
Object (Object -> Object
edit Object
inner)
Value
other -> Value
other
greatestVersion :: [Text] -> Maybe Text
greatestVersion :: [Text] -> Maybe Text
greatestVersion = (Maybe Text -> Text -> Maybe Text)
-> Maybe Text -> [Text] -> Maybe Text
forall b a. (b -> a -> b) -> b -> [a] -> b
forall (t :: * -> *) b a.
Foldable t =>
(b -> a -> b) -> b -> t a -> b
foldl' Maybe Text -> Text -> Maybe Text
keepGreater Maybe Text
forall a. Maybe a
Nothing
where
keepGreater :: Maybe Text -> Text -> Maybe Text
keepGreater Maybe Text
held Text
candidate = Text -> Maybe Text
forall a. a -> Maybe a
Just (Text -> (Text -> Text) -> Maybe Text -> Text
forall b a. b -> (a -> b) -> Maybe a -> b
maybe Text
candidate (Text -> Text -> Text
greaterOf Text
candidate) Maybe Text
held)
greaterOf :: Text -> Text -> Text
greaterOf :: Text -> Text -> Text
greaterOf Text
a Text
b = if Text -> Text -> Ordering
npmVersionOrdering Text
a Text
b Ordering -> Ordering -> Bool
forall a. Eq a => a -> a -> Bool
== Ordering
GT then Text
a else Text
b
npmVersionOrdering :: Text -> Text -> Ordering
npmVersionOrdering :: Text -> Text -> Ordering
npmVersionOrdering Text
a Text
b = Ordering -> Maybe Ordering -> Ordering
forall a. a -> Maybe a -> a
fromMaybe (Text -> Text -> Ordering
forall a. Ord a => a -> a -> Ordering
compare Text
a Text
b) (Version -> Version -> Maybe Ordering
compareVersions (Ecosystem -> Text -> Version
mkVersion Ecosystem
Npm Text
a) (Ecosystem -> Text -> Version
mkVersion Ecosystem
Npm Text
b))
tarballFilename :: PackageName -> Version -> Value -> Text
tarballFilename :: PackageName -> Version -> Value -> Text
tarballFilename PackageName
name Version
version Value
manifest =
Text -> Maybe Text -> Text
forall a. a -> Maybe a -> a
fromMaybe Text
conventional ((Text -> Bool) -> Maybe Text -> Maybe Text
forall (m :: * -> *) a. MonadPlus m => (a -> Bool) -> m a -> m a
mfilter Text -> Bool
isSafeComponent (Text -> Maybe Text
nonBlank (Text -> Maybe Text) -> Maybe Text -> Maybe Text
forall (m :: * -> *) a b. Monad m => (a -> m b) -> m a -> m b
=<< Value -> Maybe Text
distTarballSegment Value
manifest))
where
conventional :: Text
conventional = PackageName -> Text
unscopedName PackageName
name Text -> Text -> Text
forall a. Semigroup a => a -> a -> a
<> Text
"-" Text -> Text -> Text
forall a. Semigroup a => a -> a -> a
<> Version -> Text
renderVersion Version
version Text -> Text -> Text
forall a. Semigroup a => a -> a -> a
<> Text
".tgz"
distTarballSegment :: Value -> Maybe Text
distTarballSegment :: Value -> Maybe Text
distTarballSegment Value
manifest = Text -> Text
urlFilenameComponent (Text -> Text) -> Maybe Text -> Maybe Text
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
<$> Value -> Maybe Text
tarballUrl Value
manifest