[feature] Implement markers API (#1989)

* Implement markers API

Fixes #1856

* Correct import grouping in markers files

* Regenerate Swagger for markers API

* Shorten names for readability

* Cache markers for 6 hours

* Update DB ref

* Update envparsing.sh

3 files changed, 83 insertions, 0 deletions

diff --git a/internal/config/config.go b/internal/config/config.go
index a5b843e3c..bd9fc468c 100644
--- a/internal/config/config.go
+++ b/internal/config/config.go
@@ -226,6 +226,10 @@ type GTSCacheConfiguration struct {
 	ListEntryTTL       time.Duration `name:"list-entry-ttl"`
 	ListEntrySweepFreq time.Duration `name:"list-entry-sweep-freq"`
 
+	MarkerMaxSize   int           `name:"marker-max-size"`
+	MarkerTTL       time.Duration `name:"marker-ttl"`
+	MarkerSweepFreq time.Duration `name:"marker-sweep-freq"`
+
 	MediaMaxSize   int           `name:"media-max-size"`
 	MediaTTL       time.Duration `name:"media-ttl"`
 	MediaSweepFreq time.Duration `name:"media-sweep-freq"`
diff --git a/internal/config/defaults.go b/internal/config/defaults.go
index d48eb2598..ee20fb6a7 100644
--- a/internal/config/defaults.go
+++ b/internal/config/defaults.go
@@ -171,6 +171,10 @@ var Defaults = Configuration{
 			ListEntryTTL:       time.Minute * 30,
 			ListEntrySweepFreq: time.Minute,
 
+			MarkerMaxSize:   2000,
+			MarkerTTL:       time.Hour * 6,
+			MarkerSweepFreq: time.Minute,
+
 			MediaMaxSize:   1000,
 			MediaTTL:       time.Minute * 30,
 			MediaSweepFreq: time.Minute,
diff --git a/internal/config/helpers.gen.go b/internal/config/helpers.gen.go
index a3a394b2d..5eed1b468 100644
--- a/internal/config/helpers.gen.go
+++ b/internal/config/helpers.gen.go
@@ -3228,6 +3228,81 @@ func GetCacheGTSListEntrySweepFreq() time.Duration { return global.GetCacheGTSLi
 // SetCacheGTSListEntrySweepFreq safely sets the value for global configuration 'Cache.GTS.ListEntrySweepFreq' field
 func SetCacheGTSListEntrySweepFreq(v time.Duration) { global.SetCacheGTSListEntrySweepFreq(v) }
 
+// GetCacheGTSMarkerMaxSize safely fetches the Configuration value for state's 'Cache.GTS.MarkerMaxSize' field
+func (st *ConfigState) GetCacheGTSMarkerMaxSize() (v int) {
+	st.mutex.RLock()
+	v = st.config.Cache.GTS.MarkerMaxSize
+	st.mutex.RUnlock()
+	return
+}
+
+// SetCacheGTSMarkerMaxSize safely sets the Configuration value for state's 'Cache.GTS.MarkerMaxSize' field
+func (st *ConfigState) SetCacheGTSMarkerMaxSize(v int) {
+	st.mutex.Lock()
+	defer st.mutex.Unlock()
+	st.config.Cache.GTS.MarkerMaxSize = v
+	st.reloadToViper()
+}
+
+// CacheGTSMarkerMaxSizeFlag returns the flag name for the 'Cache.GTS.MarkerMaxSize' field
+func CacheGTSMarkerMaxSizeFlag() string { return "cache-gts-marker-max-size" }
+
+// GetCacheGTSMarkerMaxSize safely fetches the value for global configuration 'Cache.GTS.MarkerMaxSize' field
+func GetCacheGTSMarkerMaxSize() int { return global.GetCacheGTSMarkerMaxSize() }
+
+// SetCacheGTSMarkerMaxSize safely sets the value for global configuration 'Cache.GTS.MarkerMaxSize' field
+func SetCacheGTSMarkerMaxSize(v int) { global.SetCacheGTSMarkerMaxSize(v) }
+
+// GetCacheGTSMarkerTTL safely fetches the Configuration value for state's 'Cache.GTS.MarkerTTL' field
+func (st *ConfigState) GetCacheGTSMarkerTTL() (v time.Duration) {
+	st.mutex.RLock()
+	v = st.config.Cache.GTS.MarkerTTL
+	st.mutex.RUnlock()
+	return
+}
+
+// SetCacheGTSMarkerTTL safely sets the Configuration value for state's 'Cache.GTS.MarkerTTL' field
+func (st *ConfigState) SetCacheGTSMarkerTTL(v time.Duration) {
+	st.mutex.Lock()
+	defer st.mutex.Unlock()
+	st.config.Cache.GTS.MarkerTTL = v
+	st.reloadToViper()
+}
+
+// CacheGTSMarkerTTLFlag returns the flag name for the 'Cache.GTS.MarkerTTL' field
+func CacheGTSMarkerTTLFlag() string { return "cache-gts-marker-ttl" }
+
+// GetCacheGTSMarkerTTL safely fetches the value for global configuration 'Cache.GTS.MarkerTTL' field
+func GetCacheGTSMarkerTTL() time.Duration { return global.GetCacheGTSMarkerTTL() }
+
+// SetCacheGTSMarkerTTL safely sets the value for global configuration 'Cache.GTS.MarkerTTL' field
+func SetCacheGTSMarkerTTL(v time.Duration) { global.SetCacheGTSMarkerTTL(v) }
+
+// GetCacheGTSMarkerSweepFreq safely fetches the Configuration value for state's 'Cache.GTS.MarkerSweepFreq' field
+func (st *ConfigState) GetCacheGTSMarkerSweepFreq() (v time.Duration) {
+	st.mutex.RLock()
+	v = st.config.Cache.GTS.MarkerSweepFreq
+	st.mutex.RUnlock()
+	return
+}
+
+// SetCacheGTSMarkerSweepFreq safely sets the Configuration value for state's 'Cache.GTS.MarkerSweepFreq' field
+func (st *ConfigState) SetCacheGTSMarkerSweepFreq(v time.Duration) {
+	st.mutex.Lock()
+	defer st.mutex.Unlock()
+	st.config.Cache.GTS.MarkerSweepFreq = v
+	st.reloadToViper()
+}
+
+// CacheGTSMarkerSweepFreqFlag returns the flag name for the 'Cache.GTS.MarkerSweepFreq' field
+func CacheGTSMarkerSweepFreqFlag() string { return "cache-gts-marker-sweep-freq" }
+
+// GetCacheGTSMarkerSweepFreq safely fetches the value for global configuration 'Cache.GTS.MarkerSweepFreq' field
+func GetCacheGTSMarkerSweepFreq() time.Duration { return global.GetCacheGTSMarkerSweepFreq() }
+
+// SetCacheGTSMarkerSweepFreq safely sets the value for global configuration 'Cache.GTS.MarkerSweepFreq' field
+func SetCacheGTSMarkerSweepFreq(v time.Duration) { global.SetCacheGTSMarkerSweepFreq(v) }
+
 // GetCacheGTSMediaMaxSize safely fetches the Configuration value for state's 'Cache.GTS.MediaMaxSize' field
 func (st *ConfigState) GetCacheGTSMediaMaxSize() (v int) {
 	st.mutex.RLock()