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

-- | Durable graph accounting counts aliases per occurrence and complete text backing allocations.
module Ecluse.Core.Mirror.State.Weight (retainedRecordWeight, retainedFragmentWeight, fragmentShellAllowance, sourceEntriesWeight, valueBackingExcess) where

import Data.Aeson (Value (..))
import Data.Aeson.Key qualified as Key
import Data.Aeson.KeyMap qualified as KeyMap
import Data.Map.Strict qualified as Map
import Data.Text.Unsafe (lengthWord8)

import Ecluse.Core.Mirror.State.Format (MirrorStateFormat (msfFragmentShell, msfSourceWeight))
import Ecluse.Core.Mirror.State.Internal
import Ecluse.Core.Package
import Ecluse.Core.Package.Entry (EntryKey)
import Ecluse.Core.Registry (MirrorArtifact (..))
import Ecluse.Core.Registry.CachedDocument (estimateValueBytes)
import Ecluse.Core.Registry.MirrorUpload (ExpectedMirrorFile, expectedArtifact, expectedDescriptor)
import Ecluse.Core.Server.Cache.VersionWeight.Fields
import Ecluse.Core.Server.MemoryModel (expandWireBytesInteger)
import Ecluse.Core.Server.Path (unFilename)
import Ecluse.Core.Text (textStorageBytes)

-- | The project shell covers map roots and fixed identities. Companion bodies belong to their read reservation.
retainedRecordWeight :: MirrorStateFormat -> ProjectMirrorRecord -> Integer
retainedRecordWeight :: MirrorStateFormat -> ProjectMirrorRecord -> Integer
retainedRecordWeight MirrorStateFormat
format ProjectMirrorRecord
record =
    Integer
4096
        Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Text -> Integer
textWeight (StateTarget -> Text
targetKey (ProjectMirrorRecord -> StateTarget
recordTarget ProjectMirrorRecord
record))
        Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ PackageName -> Integer
nameWeight (ProjectMirrorRecord -> PackageName
recordPackage ProjectMirrorRecord
record)
        Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Integer -> Integer
expandWireBytesInteger (Int64 -> Integer
forall a. Integral a => a -> Integer
toInteger (Value -> Int64
estimateValueBytes Value
envelope))
        Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Value -> Integer
valueBackingExcess Value
envelope
        Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ [Integer] -> Integer
forall a (f :: * -> *). (Foldable f, Num a) => f a -> a
sum [Integer
256 Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Text -> Integer
textWeight Text
key Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ MirrorStateFormat -> MirrorVersion -> Integer
versionWeight MirrorStateFormat
format MirrorVersion
version | (Text
key, MirrorVersion
version) <- Map Text MirrorVersion -> [(Text, MirrorVersion)]
forall k a. Map k a -> [(k, a)]
Map.toList (ProjectMirrorRecord -> Map Text MirrorVersion
recordVersions ProjectMirrorRecord
record)]
  where
    envelope :: Value
envelope = Object -> Value
Object (ProjectMirrorRecord -> Object
recordEnvelope ProjectMirrorRecord
record)

versionWeight :: MirrorStateFormat -> MirrorVersion -> Integer
versionWeight :: MirrorStateFormat -> MirrorVersion -> Integer
versionWeight MirrorStateFormat
format MirrorVersion
version =
    [Integer] -> Integer
forall a (f :: * -> *). (Foldable f, Num a) => f a -> a
sum ((StoredMirrorFragment -> Integer)
-> [StoredMirrorFragment] -> [Integer]
forall a b. (a -> b) -> [a] -> [b]
map (MirrorStateFormat -> StoredMirrorFragment -> Integer
retainedFragmentWeight MirrorStateFormat
format) (NonEmpty StoredMirrorFragment -> [StoredMirrorFragment]
forall a. NonEmpty a -> [a]
forall (t :: * -> *) a. Foldable t => t a -> [a]
toList (MirrorVersion -> NonEmpty StoredMirrorFragment
versionFragments MirrorVersion
version)))
        Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ [Integer] -> Integer
forall a (f :: * -> *). (Foldable f, Num a) => f a -> a
sum [Integer
256 Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Text -> Integer
textWeight Text
name Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Hash -> Integer
hashWeight Hash
digest | (Text
name, Hash
digest) <- Map Text Hash -> [(Text, Hash)]
forall k a. Map k a -> [(k, a)]
Map.toList (MirrorVersion -> Map Text Hash
versionVerifiedIdentities MirrorVersion
version)]
        Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ [Integer] -> Integer
forall a (f :: * -> *). (Foldable f, Num a) => f a -> a
sum [Integer
256 Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Text -> Integer
textWeight Text
name Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ CompanionState -> Integer
companionWeight CompanionState
companion | (Text
name, CompanionState
companion) <- Map Text CompanionState -> [(Text, CompanionState)]
forall k a. Map k a -> [(k, a)]
Map.toList (MirrorVersion -> Map Text CompanionState
versionCompanions MirrorVersion
version)]

-- | A fragment's format declares its shell allowance and its stored source's weight.
retainedFragmentWeight :: MirrorStateFormat -> StoredMirrorFragment -> Integer
retainedFragmentWeight :: MirrorStateFormat -> StoredMirrorFragment -> Integer
retainedFragmentWeight MirrorStateFormat
format (StoredMirrorFragment PackageDetails
details MirrorReadData
source NonEmpty ExpectedMirrorFile
expected) =
    MirrorStateFormat -> PackageDetails -> Integer
msfFragmentShell MirrorStateFormat
format PackageDetails
details Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ PackageDetails -> Integer
detailsFieldsWeight PackageDetails
details Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ MirrorStateFormat -> MirrorReadData -> Integer
msfSourceWeight MirrorStateFormat
format MirrorReadData
source Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ [Integer] -> Integer
forall a (f :: * -> *). (Foldable f, Num a) => f a -> a
sum ((ExpectedMirrorFile -> Integer)
-> [ExpectedMirrorFile] -> [Integer]
forall a b. (a -> b) -> [a] -> [b]
map ExpectedMirrorFile -> Integer
expectedWeight (NonEmpty ExpectedMirrorFile -> [ExpectedMirrorFile]
forall a. NonEmpty a -> [a]
forall (t :: * -> *) a. Foldable t => t a -> [a]
toList NonEmpty ExpectedMirrorFile
expected))

-- | A fragment's shell allowance for its identity, parsed version, time and install facts, and source roots.
fragmentShellAllowance :: Integer
fragmentShellAllowance :: Integer
fragmentShellAllowance = Integer
256 Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Integer
16 Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
* Integer
1024

-- | Stored entries' coordinates and the uncounted backing of their values.
sourceEntriesWeight :: [(EntryKey, Value)] -> Integer
sourceEntriesWeight :: [(EntryKey, Value)] -> Integer
sourceEntriesWeight [(EntryKey, Value)]
entries = [Integer] -> Integer
forall a (f :: * -> *). (Foldable f, Num a) => f a -> a
sum [EntryKey -> Integer
weighEntryKey EntryKey
key Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Value -> Integer
valueBackingExcess Value
value | (EntryKey
key, Value
value) <- [(EntryKey, Value)]
entries]

expectedWeight :: ExpectedMirrorFile -> Integer
expectedWeight :: ExpectedMirrorFile -> Integer
expectedWeight ExpectedMirrorFile
expected =
    Integer
256
        Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Integer
256
        Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Artifact -> Integer
artifactWeight (ExpectedMirrorFile -> Artifact
expectedArtifact ExpectedMirrorFile
expected)
        Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Text -> Integer
textWeight (Filename -> Text
unFilename (MirrorArtifact -> Filename
maFilename MirrorArtifact
descriptor))
        Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ [Integer] -> Integer
forall a (f :: * -> *). (Foldable f, Num a) => f a -> a
sum ((Hash -> Integer) -> [Hash] -> [Integer]
forall a b. (a -> b) -> [a] -> [b]
map Hash -> Integer
hashWeight (NonEmpty Hash -> [Hash]
forall a. NonEmpty a -> [a]
forall (t :: * -> *) a. Foldable t => t a -> [a]
toList (MirrorArtifact -> NonEmpty Hash
maHashes MirrorArtifact
descriptor)))
  where
    descriptor :: MirrorArtifact
descriptor = ExpectedMirrorFile -> MirrorArtifact
expectedDescriptor ExpectedMirrorFile
expected

hashWeight :: Hash -> Integer
hashWeight :: Hash -> Integer
hashWeight Hash
digest = Integer
256 Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Text -> Integer
textWeight (Hash -> Text
hashValue Hash
digest)

companionWeight :: CompanionState -> Integer
companionWeight :: CompanionState -> Integer
companionWeight CompanionState
CompanionPending = Integer
0
companionWeight (CompanionRetained (CompanionRef Hash
digest Int
_)) = Integer
256 Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Hash -> Integer
hashWeight Hash
digest

-- | Compact JSON estimates count visible bytes. Add each string or key's uncounted backing allocation.
valueBackingExcess :: Value -> Integer
valueBackingExcess :: Value -> Integer
valueBackingExcess = \case
    String Text
text -> Text -> Integer
textExcess Text
text
    Array Array
values -> [Integer] -> Integer
forall a (f :: * -> *). (Foldable f, Num a) => f a -> a
sum ((Value -> Integer) -> [Value] -> [Integer]
forall a b. (a -> b) -> [a] -> [b]
map Value -> Integer
valueBackingExcess (Array -> [Value]
forall a. Vector a -> [a]
forall (t :: * -> *) a. Foldable t => t a -> [a]
toList Array
values))
    Object Object
fields -> [Integer] -> Integer
forall a (f :: * -> *). (Foldable f, Num a) => f a -> a
sum [Text -> Integer
textExcess (Key -> Text
Key.toText Key
key) Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
+ Value -> Integer
valueBackingExcess Value
value | (Key
key, Value
value) <- Object -> [(Key, Value)]
forall v. KeyMap v -> [(Key, v)]
KeyMap.toList Object
fields]
    Value
_ -> Integer
0
  where
    textExcess :: Text -> Integer
textExcess Text
text = Integer -> Integer -> Integer
forall a. Ord a => a -> a -> a
max Integer
0 (Int -> Integer
forall a. Integral a => a -> Integer
toInteger (Text -> Int
textStorageBytes Text
text) Integer -> Integer -> Integer
forall a. Num a => a -> a -> a
- Int -> Integer
forall a. Integral a => a -> Integer
toInteger (Text -> Int
lengthWord8 Text
text))