libraryevents

type CleanupStatus string

type Listener interface {
	// OnLibraryResolved is called once a library resolution attempt
	// finishes. result reflects whether the library was served from the
	// cache, freshly downloaded, or the resolution failed.
	OnLibraryResolved(library string, result ResolutionResult)

	// OnLibraryDownload is called when a library has been fetched from a
	// registry, with the time spent on the download. Not called on cache
	// hits or failures before the download step.
	OnLibraryDownload(library, registry string, duration time.Duration)

	// OnLibraryCleanup is called for every cleanup attempt, including ones
	// that were skipped because the library is still in use.
	OnLibraryCleanup(library string, status CleanupStatus, strategy string)

	// OnLibraryCached is called when a new library version has been stored
	// on disk. cachedCount and cachedBytes are the per-library aggregates
	// after the addition, suitable for a Gauge.Set.
	OnLibraryCached(library string, cachedCount int, cachedBytes int64)

	// OnLibraryEvicted is called when a library has been removed from
	// disk. cachedCount and cachedBytes are the per-library aggregates
	// after the removal (zero when the last version is gone), suitable
	// for a Gauge.Set.
	OnLibraryEvicted(library string, cachedCount int, cachedBytes int64)

	// OnVolumeLinked is called once a volume has been linked to a cached
	// library version. volumeLinks is the per-library aggregate after
	// the link, suitable for a Gauge.Set.
	OnVolumeLinked(library string, volumeLinks int)

	// OnVolumeUnlinked is called once a volume has been unlinked from a
	// cached library version. volumeLinks is the per-library aggregate
	// after the unlink (zero when the last volume is gone).
	OnVolumeUnlinked(library string, volumeLinks int)

	// OnSnapshot is called once at LibraryManager construction so the
	// listener can seed its gauges with the persisted state and avoid the
	// cold-start gap until the next event.
	OnSnapshot(snapshot Snapshot)
}

type NoopListener struct{}

type ResolutionResult string

type Snapshot struct {
	// CachedCountByLibrary maps each library to the number of cached
	// versions (library IDs) currently on disk for that library.
	CachedCountByLibrary map[string]int
	// CachedBytesByLibrary maps each library to the cumulative on-disk
	// size, in bytes, of the cached versions for that library.
	CachedBytesByLibrary map[string]int64
	// VolumeLinksByLibrary maps each library to the number of volumes
	// currently linked to any of its cached versions.
	VolumeLinksByLibrary map[string]int
}