nextcloud / server

lib/private/AppConfig.php

Indentation +1794 added lines, -1794 removed lines

@@ -51,1798 +51,1798 @@
  * @since 29.0.0 - Supporting types and lazy loading
  */
 class AppConfig implements IAppConfig {
-	private const APP_MAX_LENGTH = 32;
-	private const KEY_MAX_LENGTH = 64;
-	private const ENCRYPTION_PREFIX = '$AppConfigEncryption$';
-	private const ENCRYPTION_PREFIX_LENGTH = 21; // strlen(self::ENCRYPTION_PREFIX)
-	private const LOCAL_CACHE_KEY = 'OC\\AppConfig';
-	private const LOCAL_CACHE_TTL = 3;
-
-	/** @var array<string, array<string, string>> ['app_id' => ['config_key' => 'config_value']] */
-	private array $fastCache = [];   // cache for normal config keys
-	/** @var array<string, array<string, string>> ['app_id' => ['config_key' => 'config_value']] */
-	private array $lazyCache = [];   // cache for lazy config keys
-	/** @var array<string, array<string, int>> ['app_id' => ['config_key' => bitflag]] */
-	private array $valueTypes = [];  // type for all config values
-	private bool $fastLoaded = false;
-	private bool $lazyLoaded = false;
-	/** @var array<string, array{entries: array<string, Entry>, aliases: array<string, string>, strictness: Strictness}> ['app_id' => ['strictness' => ConfigLexiconStrictness, 'entries' => ['config_key' => ConfigLexiconEntry[]]] */
-	private array $configLexiconDetails = [];
-	private bool $ignoreLexiconAliases = false;
-	private array $strictnessApplied = [];
-
-	/** @var ?array<string, string> */
-	private ?array $appVersionsCache = null;
-	private ?ICache $localCache = null;
-
-	public function __construct(
-		protected IDBConnection $connection,
-		protected IConfig $config,
-		private readonly ConfigManager $configManager,
-		private readonly PresetManager $presetManager,
-		protected LoggerInterface $logger,
-		protected ICrypto $crypto,
-		readonly CacheFactory $cacheFactory,
-	) {
-		if ($config->getSystemValueBool('cache_app_config', true) && $cacheFactory->isLocalCacheAvailable()) {
-			$cacheFactory->withServerVersionPrefix(function (ICacheFactory $factory) {
-				$this->localCache = $factory->createLocal();
-			});
-		}
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @return list<string> list of app ids
-	 * @since 7.0.0
-	 */
-	public function getApps(): array {
-		$this->loadConfig(lazy: true);
-		$apps = array_merge(array_keys($this->fastCache), array_keys($this->lazyCache));
-		sort($apps);
-
-		return array_values(array_unique($apps));
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @return list<string> list of stored config keys
-	 * @see searchKeys to not load lazy config keys
-	 *
-	 * @since 29.0.0
-	 */
-	public function getKeys(string $app): array {
-		$this->assertParams($app);
-		$this->loadConfig($app, true);
-		$keys = array_merge(array_keys($this->fastCache[$app] ?? []), array_keys($this->lazyCache[$app] ?? []));
-		sort($keys);
-
-		return array_values(array_unique($keys));
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $prefix returns only keys starting with this value
-	 * @param bool $lazy TRUE to search in lazy config keys
-	 * @return list<string> list of stored config keys
-	 * @since 32.0.0
-	 */
-	public function searchKeys(string $app, string $prefix = '', bool $lazy = false): array {
-		$this->assertParams($app);
-		$this->loadConfig($app, $lazy);
-		if ($lazy) {
-			$keys = array_keys($this->lazyCache[$app] ?? []);
-		} else {
-			$keys = array_keys($this->fastCache[$app] ?? []);
-		}
-
-		if ($prefix !== '') {
-			$keys = array_filter($keys, static fn (string $key): bool => str_starts_with($key, $prefix));
-		}
-
-		sort($keys);
-		return array_values(array_unique($keys));
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool|null $lazy TRUE to search within lazy loaded config, NULL to search within all config
-	 *
-	 * @return bool TRUE if key exists
-	 * @since 7.0.0
-	 * @since 29.0.0 Added the $lazy argument
-	 */
-	public function hasKey(string $app, string $key, ?bool $lazy = false): bool {
-		$this->assertParams($app, $key);
-		$this->loadConfig($app, $lazy ?? true);
-		$this->matchAndApplyLexiconDefinition($app, $key);
-
-		$hasLazy = isset($this->lazyCache[$app][$key]);
-		$hasFast = isset($this->fastCache[$app][$key]);
-		if ($lazy === null) {
-			return $hasLazy || $hasFast;
-		} else {
-			return $lazy ? $hasLazy : $hasFast;
-		}
-	}
-
-	/**
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool|null $lazy TRUE to search within lazy loaded config, NULL to search within all config
-	 *
-	 * @return bool
-	 * @throws AppConfigUnknownKeyException if config key is not known
-	 * @since 29.0.0
-	 */
-	public function isSensitive(string $app, string $key, ?bool $lazy = false): bool {
-		$this->assertParams($app, $key);
-		$this->loadConfig(null, $lazy ?? true);
-		$this->matchAndApplyLexiconDefinition($app, $key);
-
-		if (!isset($this->valueTypes[$app][$key])) {
-			throw new AppConfigUnknownKeyException('unknown config key');
-		}
-
-		return $this->isTyped(self::VALUE_SENSITIVE, $this->valueTypes[$app][$key]);
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app if of the app
-	 * @param string $key config key
-	 *
-	 * @return bool TRUE if config is lazy loaded
-	 * @throws AppConfigUnknownKeyException if config key is not known
-	 * @see IAppConfig for details about lazy loading
-	 * @since 29.0.0
-	 */
-	public function isLazy(string $app, string $key): bool {
-		$this->assertParams($app, $key);
-		$this->matchAndApplyLexiconDefinition($app, $key);
-
-		// there is a huge probability the non-lazy config are already loaded
-		if ($this->hasKey($app, $key, false)) {
-			return false;
-		}
-
-		// key not found, we search in the lazy config
-		if ($this->hasKey($app, $key, true)) {
-			return true;
-		}
-
-		throw new AppConfigUnknownKeyException('unknown config key');
-	}
-
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $prefix config keys prefix to search
-	 * @param bool $filtered TRUE to hide sensitive config values. Value are replaced by {@see IConfig::SENSITIVE_VALUE}
-	 *
-	 * @return array<string, string|int|float|bool|array> [configKey => configValue]
-	 * @since 29.0.0
-	 */
-	public function getAllValues(string $app, string $prefix = '', bool $filtered = false): array {
-		$this->assertParams($app, $prefix);
-		// if we want to filter values, we need to get sensitivity
-		$this->loadConfig($app, true);
-		// array_merge() will remove numeric keys (here config keys), so addition arrays instead
-		$values = $this->formatAppValues($app, ($this->fastCache[$app] ?? []) + ($this->lazyCache[$app] ?? []));
-		$values = array_filter(
-			$values,
-			function (string $key) use ($prefix): bool {
-				return str_starts_with($key, $prefix); // filter values based on $prefix
-			}, ARRAY_FILTER_USE_KEY
-		);
-
-		if (!$filtered) {
-			return $values;
-		}
-
-		/**
-		 * Using the old (deprecated) list of sensitive values.
-		 */
-		foreach ($this->getSensitiveKeys($app) as $sensitiveKeyExp) {
-			$sensitiveKeys = preg_grep($sensitiveKeyExp, array_keys($values));
-			foreach ($sensitiveKeys as $sensitiveKey) {
-				$this->valueTypes[$app][$sensitiveKey] = ($this->valueTypes[$app][$sensitiveKey] ?? 0) | self::VALUE_SENSITIVE;
-			}
-		}
-
-		$result = [];
-		foreach ($values as $key => $value) {
-			$result[$key] = $this->isTyped(self::VALUE_SENSITIVE, $this->valueTypes[$app][$key] ?? 0) ? IConfig::SENSITIVE_VALUE : $value;
-		}
-
-		return $result;
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $key config key
-	 * @param bool $lazy search within lazy loaded config
-	 * @param int|null $typedAs enforce type for the returned values ({@see self::VALUE_STRING} and others)
-	 *
-	 * @return array<string, string|int|float|bool|array> [appId => configValue]
-	 * @since 29.0.0
-	 */
-	public function searchValues(string $key, bool $lazy = false, ?int $typedAs = null): array {
-		$this->assertParams('', $key, true);
-		$this->loadConfig(null, $lazy);
-
-		/** @var array<array-key, array<array-key, mixed>> $cache */
-		if ($lazy) {
-			$cache = $this->lazyCache;
-		} else {
-			$cache = $this->fastCache;
-		}
-
-		$values = [];
-		foreach (array_keys($cache) as $app) {
-			if (isset($cache[$app][$key])) {
-				$values[$app] = $this->convertTypedValue($cache[$app][$key], $typedAs ?? $this->getValueType((string)$app, $key, $lazy));
-			}
-		}
-
-		return $values;
-	}
-
-
-	/**
-	 * Get the config value as string.
-	 * If the value does not exist the given default will be returned.
-	 *
-	 * Set lazy to `null` to ignore it and get the value from either source.
-	 *
-	 * **WARNING:** Method is internal and **SHOULD** not be used, as it is better to get the value with a type.
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param string $default config value
-	 * @param null|bool $lazy get config as lazy loaded or not. can be NULL
-	 *
-	 * @return string the value or $default
-	 * @internal
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 * @see getValueString()
-	 * @see getValueInt()
-	 * @see getValueFloat()
-	 * @see getValueBool()
-	 * @see getValueArray()
-	 */
-	public function getValueMixed(
-		string $app,
-		string $key,
-		string $default = '',
-		?bool $lazy = false,
-	): string {
-		try {
-			$lazy = ($lazy === null) ? $this->isLazy($app, $key) : $lazy;
-		} catch (AppConfigUnknownKeyException) {
-			return $default;
-		}
-
-		return $this->getTypedValue(
-			$app,
-			$key,
-			$default,
-			$lazy,
-			self::VALUE_MIXED
-		);
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param string $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return string stored config value or $default if not set in database
-	 * @throws InvalidArgumentException if one of the argument format is invalid
-	 * @throws AppConfigTypeConflictException in case of conflict with the value type set in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 */
-	public function getValueString(
-		string $app,
-		string $key,
-		string $default = '',
-		bool $lazy = false,
-	): string {
-		return $this->getTypedValue($app, $key, $default, $lazy, self::VALUE_STRING);
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param int $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return int stored config value or $default if not set in database
-	 * @throws InvalidArgumentException if one of the argument format is invalid
-	 * @throws AppConfigTypeConflictException in case of conflict with the value type set in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 */
-	public function getValueInt(
-		string $app,
-		string $key,
-		int $default = 0,
-		bool $lazy = false,
-	): int {
-		return (int)$this->getTypedValue($app, $key, (string)$default, $lazy, self::VALUE_INT);
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param float $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return float stored config value or $default if not set in database
-	 * @throws InvalidArgumentException if one of the argument format is invalid
-	 * @throws AppConfigTypeConflictException in case of conflict with the value type set in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 */
-	public function getValueFloat(string $app, string $key, float $default = 0, bool $lazy = false): float {
-		return (float)$this->getTypedValue($app, $key, (string)$default, $lazy, self::VALUE_FLOAT);
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return bool stored config value or $default if not set in database
-	 * @throws InvalidArgumentException if one of the argument format is invalid
-	 * @throws AppConfigTypeConflictException in case of conflict with the value type set in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 */
-	public function getValueBool(string $app, string $key, bool $default = false, bool $lazy = false): bool {
-		$b = strtolower($this->getTypedValue($app, $key, $default ? 'true' : 'false', $lazy, self::VALUE_BOOL));
-		return in_array($b, ['1', 'true', 'yes', 'on']);
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param array $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return array stored config value or $default if not set in database
-	 * @throws InvalidArgumentException if one of the argument format is invalid
-	 * @throws AppConfigTypeConflictException in case of conflict with the value type set in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 */
-	public function getValueArray(
-		string $app,
-		string $key,
-		array $default = [],
-		bool $lazy = false,
-	): array {
-		try {
-			$defaultJson = json_encode($default, JSON_THROW_ON_ERROR);
-			$value = json_decode($this->getTypedValue($app, $key, $defaultJson, $lazy, self::VALUE_ARRAY), true, flags: JSON_THROW_ON_ERROR);
-
-			return is_array($value) ? $value : [];
-		} catch (JsonException) {
-			return [];
-		}
-	}
-
-	/**
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param string $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 * @param int $type value type {@see VALUE_STRING} {@see VALUE_INT}{@see VALUE_FLOAT} {@see VALUE_BOOL} {@see VALUE_ARRAY}
-	 *
-	 * @return string
-	 * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED and different from the requested one
-	 * @throws InvalidArgumentException
-	 */
-	private function getTypedValue(
-		string $app,
-		string $key,
-		string $default,
-		bool $lazy,
-		int $type,
-	): string {
-		$this->assertParams($app, $key, valueType: $type);
-		$origKey = $key;
-		$matched = $this->matchAndApplyLexiconDefinition($app, $key, $lazy, $type, $default);
-		if ($default === null) {
-			// there is no logical reason for it to be null
-			throw new \Exception('default cannot be null');
-		}
-
-		// returns default if strictness of lexicon is set to WARNING (block and report)
-		if (!$matched) {
-			return $default;
-		}
-
-		$this->loadConfig($app, $lazy ?? true);
-
-		/**
-		 * We ignore check if mixed type is requested.
-		 * If type of stored value is set as mixed, we don't filter.
-		 * If type of stored value is defined, we compare with the one requested.
-		 */
-		$knownType = $this->valueTypes[$app][$key] ?? 0;
-		if (!$this->isTyped(self::VALUE_MIXED, $type)
-			&& $knownType > 0
-			&& !$this->isTyped(self::VALUE_MIXED, $knownType)
-			&& !$this->isTyped($type, $knownType)) {
-			$this->logger->warning('conflict with value type from database', ['app' => $app, 'key' => $key, 'type' => $type, 'knownType' => $knownType]);
-			throw new AppConfigTypeConflictException('conflict with value type from database');
-		}
-
-		/**
-		 * - the pair $app/$key cannot exist in both array,
-		 * - we should still return an existing non-lazy value even if current method
-		 *   is called with $lazy is true
-		 *
-		 * This way, lazyCache will be empty until the load for lazy config value is requested.
-		 */
-		if (isset($this->lazyCache[$app][$key])) {
-			$value = $this->lazyCache[$app][$key];
-		} elseif (isset($this->fastCache[$app][$key])) {
-			$value = $this->fastCache[$app][$key];
-		} else {
-			return $default;
-		}
-
-		$sensitive = $this->isTyped(self::VALUE_SENSITIVE, $knownType);
-		if ($sensitive && str_starts_with($value, self::ENCRYPTION_PREFIX)) {
-			// Only decrypt values that are stored encrypted
-			$value = $this->crypto->decrypt(substr($value, self::ENCRYPTION_PREFIX_LENGTH));
-		}
-
-		// in case the key was modified while running matchAndApplyLexiconDefinition() we are
-		// interested to check options in case a modification of the value is needed
-		// ie inverting value from previous key when using lexicon option RENAME_INVERT_BOOLEAN
-		if ($origKey !== $key && $type === self::VALUE_BOOL) {
-			$value = ($this->configManager->convertToBool($value, $this->getLexiconEntry($app, $key))) ? '1' : '0';
-		}
-
-		return $value;
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 *
-	 * @return int type of the value
-	 * @throws AppConfigUnknownKeyException if config key is not known
-	 * @since 29.0.0
-	 * @see VALUE_STRING
-	 * @see VALUE_INT
-	 * @see VALUE_FLOAT
-	 * @see VALUE_BOOL
-	 * @see VALUE_ARRAY
-	 */
-	public function getValueType(string $app, string $key, ?bool $lazy = null): int {
-		$type = self::VALUE_MIXED;
-		$ignorable = $lazy ?? false;
-		$this->matchAndApplyLexiconDefinition($app, $key, $ignorable, $type);
-		if ($type !== self::VALUE_MIXED) {
-			// a modified $type means config key is set in Lexicon
-			return $type;
-		}
-
-		$this->assertParams($app, $key);
-		$this->loadConfig($app, $lazy ?? true);
-
-		if (!isset($this->valueTypes[$app][$key])) {
-			throw new AppConfigUnknownKeyException('unknown config key');
-		}
-
-		$type = $this->valueTypes[$app][$key];
-		$type &= ~self::VALUE_SENSITIVE;
-		return $type;
-	}
-
-
-	/**
-	 * Store a config key and its value in database as VALUE_MIXED
-	 *
-	 * **WARNING:** Method is internal and **MUST** not be used as it is best to set a real value type
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param string $value config value
-	 * @param bool $lazy set config as lazy loaded
-	 * @param bool $sensitive if TRUE value will be hidden when listing config values.
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED
-	 * @internal
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 * @see setValueString()
-	 * @see setValueInt()
-	 * @see setValueFloat()
-	 * @see setValueBool()
-	 * @see setValueArray()
-	 */
-	public function setValueMixed(
-		string $app,
-		string $key,
-		string $value,
-		bool $lazy = false,
-		bool $sensitive = false,
-	): bool {
-		return $this->setTypedValue(
-			$app,
-			$key,
-			$value,
-			$lazy,
-			self::VALUE_MIXED | ($sensitive ? self::VALUE_SENSITIVE : 0)
-		);
-	}
-
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param string $value config value
-	 * @param bool $lazy set config as lazy loaded
-	 * @param bool $sensitive if TRUE value will be hidden when listing config values.
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED and different from the requested one
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 */
-	public function setValueString(
-		string $app,
-		string $key,
-		string $value,
-		bool $lazy = false,
-		bool $sensitive = false,
-	): bool {
-		return $this->setTypedValue(
-			$app,
-			$key,
-			$value,
-			$lazy,
-			self::VALUE_STRING | ($sensitive ? self::VALUE_SENSITIVE : 0)
-		);
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param int $value config value
-	 * @param bool $lazy set config as lazy loaded
-	 * @param bool $sensitive if TRUE value will be hidden when listing config values.
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED and different from the requested one
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 */
-	public function setValueInt(
-		string $app,
-		string $key,
-		int $value,
-		bool $lazy = false,
-		bool $sensitive = false,
-	): bool {
-		if ($value > 2000000000) {
-			$this->logger->debug('You are trying to store an integer value around/above 2,147,483,647. This is a reminder that reaching this theoretical limit on 32 bits system will throw an exception.');
-		}
-
-		return $this->setTypedValue(
-			$app,
-			$key,
-			(string)$value,
-			$lazy,
-			self::VALUE_INT | ($sensitive ? self::VALUE_SENSITIVE : 0)
-		);
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param float $value config value
-	 * @param bool $lazy set config as lazy loaded
-	 * @param bool $sensitive if TRUE value will be hidden when listing config values.
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED and different from the requested one
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 */
-	public function setValueFloat(
-		string $app,
-		string $key,
-		float $value,
-		bool $lazy = false,
-		bool $sensitive = false,
-	): bool {
-		return $this->setTypedValue(
-			$app,
-			$key,
-			(string)$value,
-			$lazy,
-			self::VALUE_FLOAT | ($sensitive ? self::VALUE_SENSITIVE : 0)
-		);
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $value config value
-	 * @param bool $lazy set config as lazy loaded
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED and different from the requested one
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 */
-	public function setValueBool(
-		string $app,
-		string $key,
-		bool $value,
-		bool $lazy = false,
-	): bool {
-		return $this->setTypedValue(
-			$app,
-			$key,
-			($value) ? '1' : '0',
-			$lazy,
-			self::VALUE_BOOL
-		);
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param array $value config value
-	 * @param bool $lazy set config as lazy loaded
-	 * @param bool $sensitive if TRUE value will be hidden when listing config values.
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED and different from the requested one
-	 * @throws JsonException
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 */
-	public function setValueArray(
-		string $app,
-		string $key,
-		array $value,
-		bool $lazy = false,
-		bool $sensitive = false,
-	): bool {
-		try {
-			return $this->setTypedValue(
-				$app,
-				$key,
-				json_encode($value, JSON_THROW_ON_ERROR),
-				$lazy,
-				self::VALUE_ARRAY | ($sensitive ? self::VALUE_SENSITIVE : 0)
-			);
-		} catch (JsonException $e) {
-			$this->logger->warning('could not setValueArray', ['app' => $app, 'key' => $key, 'exception' => $e]);
-			throw $e;
-		}
-	}
-
-	/**
-	 * Store a config key and its value in database
-	 *
-	 * If config key is already known with the exact same config value and same sensitive/lazy status, the
-	 * database is not updated. If config value was previously stored as sensitive, status will not be
-	 * altered.
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param string $value config value
-	 * @param bool $lazy config set as lazy loaded
-	 * @param int $type value type {@see VALUE_STRING} {@see VALUE_INT} {@see VALUE_FLOAT} {@see VALUE_BOOL} {@see VALUE_ARRAY}
-	 *
-	 * @return bool TRUE if value was updated in database
-	 * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED and different from the requested one
-	 * @see IAppConfig for explanation about lazy loading
-	 */
-	private function setTypedValue(
-		string $app,
-		string $key,
-		string $value,
-		bool $lazy,
-		int $type,
-	): bool {
-		$this->assertParams($app, $key);
-		if (!$this->matchAndApplyLexiconDefinition($app, $key, $lazy, $type)) {
-			return false; // returns false as database is not updated
-		}
-		$this->loadConfig(null, $lazy ?? true);
-
-		$sensitive = $this->isTyped(self::VALUE_SENSITIVE, $type);
-		$inserted = $refreshCache = false;
-
-		$origValue = $value;
-		if ($sensitive || ($this->hasKey($app, $key, $lazy) && $this->isSensitive($app, $key, $lazy))) {
-			$value = self::ENCRYPTION_PREFIX . $this->crypto->encrypt($value);
-		}
-
-		if ($this->hasKey($app, $key, $lazy)) {
-			/**
-			 * no update if key is already known with set lazy status and value is
-			 * not different, unless sensitivity is switched from false to true.
-			 */
-			if ($origValue === $this->getTypedValue($app, $key, $value, $lazy ?? true, $type)
-				&& (!$sensitive || $this->isSensitive($app, $key, $lazy))) {
-				return false;
-			}
-		} else {
-			/**
-			 * if key is not known yet, we try to insert.
-			 * It might fail if the key exists with a different lazy flag.
-			 */
-			try {
-				$insert = $this->connection->getQueryBuilder();
-				$insert->insert('appconfig')
-					->setValue('appid', $insert->createNamedParameter($app))
-					->setValue('lazy', $insert->createNamedParameter(($lazy) ? 1 : 0, IQueryBuilder::PARAM_INT))
-					->setValue('type', $insert->createNamedParameter($type, IQueryBuilder::PARAM_INT))
-					->setValue('configkey', $insert->createNamedParameter($key))
-					->setValue('configvalue', $insert->createNamedParameter($value));
-				$insert->executeStatement();
-				$inserted = true;
-			} catch (DBException $e) {
-				if ($e->getReason() !== DBException::REASON_UNIQUE_CONSTRAINT_VIOLATION) {
-					throw $e; // TODO: throw exception or just log and returns false !?
-				}
-			}
-		}
-
-		/**
-		 * We cannot insert a new row, meaning we need to update an already existing one
-		 */
-		if (!$inserted) {
-			$currType = $this->valueTypes[$app][$key] ?? 0;
-			if ($currType === 0) { // this might happen when switching lazy loading status
-				$this->loadConfig(lazy: true);
-				$currType = $this->valueTypes[$app][$key] ?? 0;
-			}
-
-			/**
-			 * This should only happen during the upgrade process from 28 to 29.
-			 * We only log a warning and set it to VALUE_MIXED.
-			 */
-			if ($currType === 0) {
-				$this->logger->warning('Value type is set to zero (0) in database. This is fine only during the upgrade process from 28 to 29.', ['app' => $app, 'key' => $key]);
-				$currType = self::VALUE_MIXED;
-			}
-
-			/**
-			 * we only accept a different type from the one stored in database
-			 * if the one stored in database is not-defined (VALUE_MIXED)
-			 */
-			if (!$this->isTyped(self::VALUE_MIXED, $currType)
-				&& ($type | self::VALUE_SENSITIVE) !== ($currType | self::VALUE_SENSITIVE)) {
-				try {
-					$currType = $this->convertTypeToString($currType);
-					$type = $this->convertTypeToString($type);
-				} catch (AppConfigIncorrectTypeException) {
-					// can be ignored, this was just needed for a better exception message.
-				}
-				throw new AppConfigTypeConflictException('conflict between new type (' . $type . ') and old type (' . $currType . ')');
-			}
-
-			// we fix $type if the stored value, or the new value as it might be changed, is set as sensitive
-			if ($sensitive || $this->isTyped(self::VALUE_SENSITIVE, $currType)) {
-				$type |= self::VALUE_SENSITIVE;
-			}
-
-			try {
-				if ($lazy !== $this->isLazy($app, $key)) {
-					$refreshCache = true;
-				}
-			} catch (AppConfigUnknownKeyException) {
-				// pass
-			}
-
-			$update = $this->connection->getQueryBuilder();
-			$update->update('appconfig')
-				->set('configvalue', $update->createNamedParameter($value))
-				->set('lazy', $update->createNamedParameter(($lazy) ? 1 : 0, IQueryBuilder::PARAM_INT))
-				->set('type', $update->createNamedParameter($type, IQueryBuilder::PARAM_INT))
-				->where($update->expr()->eq('appid', $update->createNamedParameter($app)))
-				->andWhere($update->expr()->eq('configkey', $update->createNamedParameter($key)));
-
-			$update->executeStatement();
-		}
-
-		if ($refreshCache) {
-			$this->clearCache();
-			return true;
-		}
-
-		// update local cache
-		if ($lazy) {
-			$this->lazyCache[$app][$key] = $value;
-		} else {
-			$this->fastCache[$app][$key] = $value;
-		}
-		$this->valueTypes[$app][$key] = $type;
-		$this->clearLocalCache();
-
-		return true;
-	}
-
-	/**
-	 * Change the type of config value.
-	 *
-	 * **WARNING:** Method is internal and **MUST** not be used as it may break things.
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param int $type value type {@see VALUE_STRING} {@see VALUE_INT} {@see VALUE_FLOAT} {@see VALUE_BOOL} {@see VALUE_ARRAY}
-	 *
-	 * @return bool TRUE if database update were necessary
-	 * @throws AppConfigUnknownKeyException if $key is now known in database
-	 * @throws AppConfigIncorrectTypeException if $type is not valid
-	 * @internal
-	 * @since 29.0.0
-	 */
-	public function updateType(string $app, string $key, int $type = self::VALUE_MIXED): bool {
-		$this->assertParams($app, $key);
-		$this->loadConfig(lazy: true);
-		$this->matchAndApplyLexiconDefinition($app, $key);
-		$this->isLazy($app, $key); // confirm key exists
-
-		// type can only be one type
-		if (!in_array($type, [self::VALUE_MIXED, self::VALUE_STRING, self::VALUE_INT, self::VALUE_FLOAT, self::VALUE_BOOL, self::VALUE_ARRAY])) {
-			throw new AppConfigIncorrectTypeException('Unknown value type');
-		}
-
-		$currType = $this->valueTypes[$app][$key];
-		if (($type | self::VALUE_SENSITIVE) === ($currType | self::VALUE_SENSITIVE)) {
-			return false;
-		}
-
-		// we complete with sensitive flag if the stored value is set as sensitive
-		if ($this->isTyped(self::VALUE_SENSITIVE, $currType)) {
-			$type = $type | self::VALUE_SENSITIVE;
-		}
-
-		$update = $this->connection->getQueryBuilder();
-		$update->update('appconfig')
-			->set('type', $update->createNamedParameter($type, IQueryBuilder::PARAM_INT))
-			->where($update->expr()->eq('appid', $update->createNamedParameter($app)))
-			->andWhere($update->expr()->eq('configkey', $update->createNamedParameter($key)));
-		$update->executeStatement();
-		$this->valueTypes[$app][$key] = $type;
-
-		return true;
-	}
-
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $sensitive TRUE to set as sensitive, FALSE to unset
-	 *
-	 * @return bool TRUE if entry was found in database and an update was necessary
-	 * @since 29.0.0
-	 */
-	public function updateSensitive(string $app, string $key, bool $sensitive): bool {
-		$this->assertParams($app, $key);
-		$this->loadConfig(lazy: true);
-		$this->matchAndApplyLexiconDefinition($app, $key);
-
-		try {
-			if ($sensitive === $this->isSensitive($app, $key, null)) {
-				return false;
-			}
-		} catch (AppConfigUnknownKeyException $e) {
-			return false;
-		}
-
-		$lazy = $this->isLazy($app, $key);
-		if ($lazy) {
-			$cache = $this->lazyCache;
-		} else {
-			$cache = $this->fastCache;
-		}
-
-		if (!isset($cache[$app][$key])) {
-			throw new AppConfigUnknownKeyException('unknown config key');
-		}
-
-		/**
-		 * type returned by getValueType() is already cleaned from sensitive flag
-		 * we just need to update it based on $sensitive and store it in database
-		 */
-		$type = $this->getValueType($app, $key);
-		$value = $cache[$app][$key];
-		if ($sensitive) {
-			$type |= self::VALUE_SENSITIVE;
-			$value = self::ENCRYPTION_PREFIX . $this->crypto->encrypt($value);
-		} else {
-			$value = $this->crypto->decrypt(substr($value, self::ENCRYPTION_PREFIX_LENGTH));
-		}
-
-		$update = $this->connection->getQueryBuilder();
-		$update->update('appconfig')
-			->set('type', $update->createNamedParameter($type, IQueryBuilder::PARAM_INT))
-			->set('configvalue', $update->createNamedParameter($value))
-			->where($update->expr()->eq('appid', $update->createNamedParameter($app)))
-			->andWhere($update->expr()->eq('configkey', $update->createNamedParameter($key)));
-		$update->executeStatement();
-
-		$this->valueTypes[$app][$key] = $type;
-
-		return true;
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $lazy TRUE to set as lazy loaded, FALSE to unset
-	 *
-	 * @return bool TRUE if entry was found in database and an update was necessary
-	 * @since 29.0.0
-	 */
-	public function updateLazy(string $app, string $key, bool $lazy): bool {
-		$this->assertParams($app, $key);
-		$this->loadConfig(lazy: true);
-		$this->matchAndApplyLexiconDefinition($app, $key);
-
-		try {
-			if ($lazy === $this->isLazy($app, $key)) {
-				return false;
-			}
-		} catch (AppConfigUnknownKeyException $e) {
-			return false;
-		}
-
-		$update = $this->connection->getQueryBuilder();
-		$update->update('appconfig')
-			->set('lazy', $update->createNamedParameter($lazy ? 1 : 0, IQueryBuilder::PARAM_INT))
-			->where($update->expr()->eq('appid', $update->createNamedParameter($app)))
-			->andWhere($update->expr()->eq('configkey', $update->createNamedParameter($key)));
-		$update->executeStatement();
-
-		// At this point, it is a lot safer to clean cache
-		$this->clearCache();
-
-		return true;
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 *
-	 * @return array
-	 * @throws AppConfigUnknownKeyException if config key is not known in database
-	 * @since 29.0.0
-	 */
-	public function getDetails(string $app, string $key): array {
-		$this->assertParams($app, $key);
-		$this->loadConfig(lazy: true);
-		$this->matchAndApplyLexiconDefinition($app, $key);
-		$lazy = $this->isLazy($app, $key);
-
-		if ($lazy) {
-			$cache = $this->lazyCache;
-		} else {
-			$cache = $this->fastCache;
-		}
-
-		$type = $this->getValueType($app, $key);
-		try {
-			$typeString = $this->convertTypeToString($type);
-		} catch (AppConfigIncorrectTypeException $e) {
-			$this->logger->warning('type stored in database is not correct', ['exception' => $e, 'type' => $type]);
-			$typeString = (string)$type;
-		}
-
-		if (!isset($cache[$app][$key])) {
-			throw new AppConfigUnknownKeyException('unknown config key');
-		}
-
-		$value = $cache[$app][$key];
-		$sensitive = $this->isSensitive($app, $key, null);
-		if ($sensitive && str_starts_with($value, self::ENCRYPTION_PREFIX)) {
-			$value = $this->crypto->decrypt(substr($value, self::ENCRYPTION_PREFIX_LENGTH));
-		}
-
-		return [
-			'app' => $app,
-			'key' => $key,
-			'value' => $value,
-			'type' => $type,
-			'lazy' => $lazy,
-			'typeString' => $typeString,
-			'sensitive' => $sensitive
-		];
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 *
-	 * @return array{app: string, key: string, lazy?: bool, valueType?: ValueType, valueTypeName?: string, sensitive?: bool, internal?: bool, default?: string, definition?: string, note?: string}
-	 * @since 32.0.0
-	 */
-	public function getKeyDetails(string $app, string $key): array {
-		$this->assertParams($app, $key);
-		try {
-			$details = $this->getDetails($app, $key);
-		} catch (AppConfigUnknownKeyException) {
-			$details = [
-				'app' => $app,
-				'key' => $key
-			];
-		}
-
-		/** @var Entry $lexiconEntry */
-		try {
-			$lazy = false;
-			$this->matchAndApplyLexiconDefinition($app, $key, $lazy, lexiconEntry: $lexiconEntry);
-		} catch (AppConfigTypeConflictException|AppConfigUnknownKeyException) {
-			// can be ignored
-		}
-
-		if ($lexiconEntry !== null) {
-			$details = array_merge($details, [
-				'lazy' => $lexiconEntry->isLazy(),
-				'valueType' => $lexiconEntry->getValueType(),
-				'valueTypeName' => $lexiconEntry->getValueType()->name,
-				'sensitive' => $lexiconEntry->isFlagged(self::FLAG_SENSITIVE),
-				'internal' => $lexiconEntry->isFlagged(self::FLAG_INTERNAL),
-				'default' => $lexiconEntry->getDefault($this->presetManager->getLexiconPreset()),
-				'definition' => $lexiconEntry->getDefinition(),
-				'note' => $lexiconEntry->getNote(),
-			]);
-		}
-
-		return array_filter($details, static fn ($v): bool => ($v !== null));
-	}
-
-	/**
-	 * @param string $type
-	 *
-	 * @return int
-	 * @throws AppConfigIncorrectTypeException
-	 * @since 29.0.0
-	 */
-	public function convertTypeToInt(string $type): int {
-		return match (strtolower($type)) {
-			'mixed' => IAppConfig::VALUE_MIXED,
-			'string' => IAppConfig::VALUE_STRING,
-			'integer' => IAppConfig::VALUE_INT,
-			'float' => IAppConfig::VALUE_FLOAT,
-			'boolean' => IAppConfig::VALUE_BOOL,
-			'array' => IAppConfig::VALUE_ARRAY,
-			default => throw new AppConfigIncorrectTypeException('Unknown type ' . $type)
-		};
-	}
-
-	/**
-	 * @param int $type
-	 *
-	 * @return string
-	 * @throws AppConfigIncorrectTypeException
-	 * @since 29.0.0
-	 */
-	public function convertTypeToString(int $type): string {
-		$type &= ~self::VALUE_SENSITIVE;
-
-		return match ($type) {
-			IAppConfig::VALUE_MIXED => 'mixed',
-			IAppConfig::VALUE_STRING => 'string',
-			IAppConfig::VALUE_INT => 'integer',
-			IAppConfig::VALUE_FLOAT => 'float',
-			IAppConfig::VALUE_BOOL => 'boolean',
-			IAppConfig::VALUE_ARRAY => 'array',
-			default => throw new AppConfigIncorrectTypeException('Unknown numeric type ' . $type)
-		};
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 *
-	 * @since 29.0.0
-	 */
-	public function deleteKey(string $app, string $key): void {
-		$this->assertParams($app, $key);
-		$this->matchAndApplyLexiconDefinition($app, $key);
-
-		$qb = $this->connection->getQueryBuilder();
-		$qb->delete('appconfig')
-			->where($qb->expr()->eq('appid', $qb->createNamedParameter($app)))
-			->andWhere($qb->expr()->eq('configkey', $qb->createNamedParameter($key)));
-		$qb->executeStatement();
-
-		unset($this->lazyCache[$app][$key]);
-		unset($this->fastCache[$app][$key]);
-		unset($this->valueTypes[$app][$key]);
-		$this->clearLocalCache();
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $app id of the app
-	 *
-	 * @since 29.0.0
-	 */
-	public function deleteApp(string $app): void {
-		$this->assertParams($app);
-		$qb = $this->connection->getQueryBuilder();
-		$qb->delete('appconfig')
-			->where($qb->expr()->eq('appid', $qb->createNamedParameter($app)));
-		$qb->executeStatement();
-
-		$this->clearCache();
-	}
-
-	/**
-	 * @inheritDoc
-	 *
-	 * @param bool $reload set to TRUE to refill cache instantly after clearing it
-	 *
-	 * @internal
-	 * @since 29.0.0
-	 */
-	public function clearCache(bool $reload = false): void {
-		$this->lazyLoaded = $this->fastLoaded = false;
-		$this->lazyCache = $this->fastCache = $this->valueTypes = $this->configLexiconDetails = [];
-		$this->localCache?->remove(self::LOCAL_CACHE_KEY);
-
-		if (!$reload) {
-			return;
-		}
-
-		$this->loadConfig(lazy: true);
-	}
-
-
-	/**
-	 * For debug purpose.
-	 * Returns the cached data.
-	 *
-	 * @return array
-	 * @since 29.0.0
-	 * @internal
-	 */
-	public function statusCache(): array {
-		return [
-			'fastLoaded' => $this->fastLoaded,
-			'fastCache' => $this->fastCache,
-			'lazyLoaded' => $this->lazyLoaded,
-			'lazyCache' => $this->lazyCache,
-		];
-	}
-
-	/**
-	 * @param int $needle bitflag to search
-	 * @param int $type known value
-	 *
-	 * @return bool TRUE if bitflag $needle is set in $type
-	 */
-	private function isTyped(int $needle, int $type): bool {
-		return (($needle & $type) !== 0);
-	}
-
-	/**
-	 * Confirm the string set for app and key fit the database description
-	 *
-	 * @param string $app assert $app fit in database
-	 * @param string $configKey assert config key fit in database
-	 * @param bool $allowEmptyApp $app can be empty string
-	 * @param int $valueType assert value type is only one type
-	 *
-	 * @throws InvalidArgumentException
-	 */
-	private function assertParams(string $app = '', string $configKey = '', bool $allowEmptyApp = false, int $valueType = -1): void {
-		if (!$allowEmptyApp && $app === '') {
-			throw new InvalidArgumentException('app cannot be an empty string');
-		}
-		if (strlen($app) > self::APP_MAX_LENGTH) {
-			throw new InvalidArgumentException(
-				'Value (' . $app . ') for app is too long (' . self::APP_MAX_LENGTH . ')'
-			);
-		}
-		if (strlen($configKey) > self::KEY_MAX_LENGTH) {
-			throw new InvalidArgumentException('Value (' . $configKey . ') for key is too long (' . self::KEY_MAX_LENGTH . ')');
-		}
-		if ($valueType > -1) {
-			$valueType &= ~self::VALUE_SENSITIVE;
-			if (!in_array($valueType, [self::VALUE_MIXED, self::VALUE_STRING, self::VALUE_INT, self::VALUE_FLOAT, self::VALUE_BOOL, self::VALUE_ARRAY])) {
-				throw new InvalidArgumentException('Unknown value type');
-			}
-		}
-	}
-
-	/**
-	 * Load normal config or config set as lazy loaded
-	 *
-	 * @param bool $lazy set to TRUE to also load config values set as lazy loaded
-	 */
-	private function loadConfig(?string $app = null, bool $lazy = false): void {
-		if ($this->isLoaded($lazy)) {
-			return;
-		}
-
-		// if lazy is null or true, we debug log
-		if ($lazy === true && $app !== null) {
-			$exception = new \RuntimeException('The loading of lazy AppConfig values have been triggered by app "' . $app . '"');
-			$this->logger->debug($exception->getMessage(), ['exception' => $exception, 'app' => $app]);
-		}
-
-		$loadLazyOnly = $lazy && $this->isLoaded();
-
-		/** @var array<mixed> */
-		$cacheContent = $this->localCache?->get(self::LOCAL_CACHE_KEY) ?? [];
-		$includesLazyValues = !empty($cacheContent) && !empty($cacheContent['lazyCache']);
-		if (!empty($cacheContent) && (!$lazy || $includesLazyValues)) {
-			$this->valueTypes = $cacheContent['valueTypes'];
-			$this->fastCache = $cacheContent['fastCache'];
-			$this->fastLoaded = !empty($this->fastCache);
-			if ($includesLazyValues) {
-				$this->lazyCache = $cacheContent['lazyCache'];
-				$this->lazyLoaded = !empty($this->lazyCache);
-			}
-			return;
-		}
-
-		// Otherwise no cache available and we need to fetch from database
-		$qb = $this->connection->getQueryBuilder();
-		$qb->from('appconfig')
-			->select('appid', 'configkey', 'configvalue', 'type');
-
-		if ($lazy === false) {
-			$qb->where($qb->expr()->eq('lazy', $qb->createNamedParameter(0, IQueryBuilder::PARAM_INT)));
-		} else {
-			if ($loadLazyOnly) {
-				$qb->where($qb->expr()->eq('lazy', $qb->createNamedParameter(1, IQueryBuilder::PARAM_INT)));
-			}
-			$qb->addSelect('lazy');
-		}
-
-		$result = $qb->executeQuery();
-		$rows = $result->fetchAll();
-		foreach ($rows as $row) {
-			// most of the time, 'lazy' is not in the select because its value is already known
-			if ($lazy && ((int)$row['lazy']) === 1) {
-				$this->lazyCache[$row['appid']][$row['configkey']] = $row['configvalue'] ?? '';
-			} else {
-				$this->fastCache[$row['appid']][$row['configkey']] = $row['configvalue'] ?? '';
-			}
-			$this->valueTypes[$row['appid']][$row['configkey']] = (int)($row['type'] ?? 0);
-		}
-
-		$result->closeCursor();
-		$this->localCache?->set(
-			self::LOCAL_CACHE_KEY,
-			[
-				'fastCache' => $this->fastCache,
-				'lazyCache' => $this->lazyCache,
-				'valueTypes' => $this->valueTypes,
-			],
-			self::LOCAL_CACHE_TTL,
-		);
-
-		$this->fastLoaded = true;
-		$this->lazyLoaded = $lazy;
-	}
-
-	/**
-	 * @param bool $lazy - If set to true then also check if lazy values are loaded
-	 */
-	private function isLoaded(bool $lazy = false): bool {
-		return $this->fastLoaded && (!$lazy || $this->lazyLoaded);
-	}
-
-	/**
-	 * Gets the config value
-	 *
-	 * @param string $app app
-	 * @param string $key key
-	 * @param string $default - Default value if the key does not exist
-	 *
-	 * @return string the value or $default
-	 * @deprecated 29.0.0 use getValue*()
-	 *
-	 * This function gets a value from the appconfig table. If the key does
-	 * not exist the default value will be returned
-	 */
-	public function getValue($app, $key, $default = '') {
-		$this->loadConfig($app);
-		$this->matchAndApplyLexiconDefinition($app, $key);
-
-		return $this->fastCache[$app][$key] ?? $default;
-	}
-
-	/**
-	 * Sets a value. If the key did not exist before it will be created.
-	 *
-	 * @param string $app app
-	 * @param string $key key
-	 * @param string|float|int $value value
-	 *
-	 * @return bool True if the value was inserted or updated, false if the value was the same
-	 * @throws AppConfigTypeConflictException
-	 * @throws AppConfigUnknownKeyException
-	 * @deprecated 29.0.0
-	 */
-	public function setValue($app, $key, $value) {
-		/**
-		 * TODO: would it be overkill, or decently improve performance, to catch
-		 * call to this method with $key='enabled' and 'hide' config value related
-		 * to $app when the app is disabled (by modifying entry in database: lazy=lazy+2)
-		 * or enabled (lazy=lazy-2)
-		 *
-		 * this solution would remove the loading of config values from disabled app
-		 * unless calling the method.
-		 */
-		return $this->setTypedValue($app, $key, (string)$value, false, self::VALUE_MIXED);
-	}
-
-
-	/**
-	 * get multiple values, either the app or key can be used as wildcard by setting it to false
-	 *
-	 * @param string|false $app
-	 * @param string|false $key
-	 *
-	 * @return array|false
-	 * @deprecated 29.0.0 use {@see getAllValues()}
-	 */
-	public function getValues($app, $key) {
-		if (($app !== false) === ($key !== false)) {
-			return false;
-		}
-
-		$key = ($key === false) ? '' : $key;
-		if (!$app) {
-			return $this->searchValues($key, false, self::VALUE_MIXED);
-		} else {
-			return $this->getAllValues($app, $key);
-		}
-	}
-
-	/**
-	 * get all values of the app or and filters out sensitive data
-	 *
-	 * @param string $app
-	 *
-	 * @return array
-	 * @deprecated 29.0.0 use {@see getAllValues()}
-	 */
-	public function getFilteredValues($app) {
-		return $this->getAllValues($app, filtered: true);
-	}
-
-
-	/**
-	 * **Warning:** avoid default NULL value for $lazy as this will
-	 * load all lazy values from the database
-	 *
-	 * @param string $app
-	 * @param array<string, string> $values ['key' => 'value']
-	 * @param bool|null $lazy
-	 *
-	 * @return array<string, string|int|float|bool|array>
-	 */
-	private function formatAppValues(string $app, array $values, ?bool $lazy = null): array {
-		foreach ($values as $key => $value) {
-			try {
-				$type = $this->getValueType($app, $key, $lazy);
-			} catch (AppConfigUnknownKeyException) {
-				continue;
-			}
-
-			$values[$key] = $this->convertTypedValue($value, $type);
-		}
-
-		return $values;
-	}
-
-	/**
-	 * convert string value to the expected type
-	 *
-	 * @param string $value
-	 * @param int $type
-	 *
-	 * @return string|int|float|bool|array
-	 */
-	private function convertTypedValue(string $value, int $type): string|int|float|bool|array {
-		switch ($type) {
-			case self::VALUE_INT:
-				return (int)$value;
-			case self::VALUE_FLOAT:
-				return (float)$value;
-			case self::VALUE_BOOL:
-				return in_array(strtolower($value), ['1', 'true', 'yes', 'on']);
-			case self::VALUE_ARRAY:
-				try {
-					return json_decode($value, true, flags: JSON_THROW_ON_ERROR);
-				} catch (JsonException $e) {
-					// ignoreable
-				}
-				break;
-		}
-		return $value;
-	}
-
-	/**
-	 * @param string $app
-	 *
-	 * @return string[]
-	 * @deprecated 29.0.0 data sensitivity should be set when calling setValue*()
-	 */
-	private function getSensitiveKeys(string $app): array {
-		$sensitiveValues = [
-			'circles' => [
-				'/^key_pairs$/',
-				'/^local_gskey$/',
-			],
-			'call_summary_bot' => [
-				'/^secret_(.*)$/',
-			],
-			'external' => [
-				'/^sites$/',
-				'/^jwt_token_privkey_(.*)$/',
-			],
-			'globalsiteselector' => [
-				'/^gss\.jwt\.key$/',
-			],
-			'gpgmailer' => [
-				'/^GpgServerKey$/',
-			],
-			'integration_discourse' => [
-				'/^private_key$/',
-				'/^public_key$/',
-			],
-			'integration_dropbox' => [
-				'/^client_id$/',
-				'/^client_secret$/',
-			],
-			'integration_github' => [
-				'/^client_id$/',
-				'/^client_secret$/',
-			],
-			'integration_gitlab' => [
-				'/^client_id$/',
-				'/^client_secret$/',
-				'/^oauth_instance_url$/',
-			],
-			'integration_google' => [
-				'/^client_id$/',
-				'/^client_secret$/',
-			],
-			'integration_jira' => [
-				'/^client_id$/',
-				'/^client_secret$/',
-				'/^forced_instance_url$/',
-			],
-			'integration_onedrive' => [
-				'/^client_id$/',
-				'/^client_secret$/',
-			],
-			'integration_openproject' => [
-				'/^client_id$/',
-				'/^client_secret$/',
-				'/^oauth_instance_url$/',
-			],
-			'integration_reddit' => [
-				'/^client_id$/',
-				'/^client_secret$/',
-			],
-			'integration_suitecrm' => [
-				'/^client_id$/',
-				'/^client_secret$/',
-				'/^oauth_instance_url$/',
-			],
-			'integration_twitter' => [
-				'/^consumer_key$/',
-				'/^consumer_secret$/',
-				'/^followed_user$/',
-			],
-			'integration_zammad' => [
-				'/^client_id$/',
-				'/^client_secret$/',
-				'/^oauth_instance_url$/',
-			],
-			'maps' => [
-				'/^mapboxAPIKEY$/',
-			],
-			'notify_push' => [
-				'/^cookie$/',
-			],
-			'onlyoffice' => [
-				'/^jwt_secret$/',
-			],
-			'passwords' => [
-				'/^SSEv1ServerKey$/',
-			],
-			'serverinfo' => [
-				'/^token$/',
-			],
-			'spreed' => [
-				'/^bridge_bot_password$/',
-				'/^hosted-signaling-server-(.*)$/',
-				'/^recording_servers$/',
-				'/^signaling_servers$/',
-				'/^signaling_ticket_secret$/',
-				'/^signaling_token_privkey_(.*)$/',
-				'/^signaling_token_pubkey_(.*)$/',
-				'/^sip_bridge_dialin_info$/',
-				'/^sip_bridge_shared_secret$/',
-				'/^stun_servers$/',
-				'/^turn_servers$/',
-				'/^turn_server_secret$/',
-			],
-			'support' => [
-				'/^last_response$/',
-				'/^potential_subscription_key$/',
-				'/^subscription_key$/',
-			],
-			'theming' => [
-				'/^imprintUrl$/',
-				'/^privacyUrl$/',
-				'/^slogan$/',
-				'/^url$/',
-			],
-			'twofactor_gateway' => [
-				'/^.*token$/',
-			],
-			'user_ldap' => [
-				'/^(s..)?ldap_agent_password$/',
-			],
-			'user_saml' => [
-				'/^idp-x509cert$/',
-			],
-			'whiteboard' => [
-				'/^jwt_secret_key$/',
-			],
-		];
-
-		return $sensitiveValues[$app] ?? [];
-	}
-
-	/**
-	 * Clear all the cached app config values
-	 * New cache will be generated next time a config value is retrieved
-	 *
-	 * @deprecated 29.0.0 use {@see clearCache()}
-	 */
-	public function clearCachedConfig(): void {
-		$this->clearCache();
-	}
-
-	/**
-	 * Match and apply current use of config values with defined lexicon.
-	 * Set $lazy to NULL only if only interested into checking that $key is alias.
-	 *
-	 * @throws AppConfigUnknownKeyException
-	 * @throws AppConfigTypeConflictException
-	 * @return bool TRUE if everything is fine compared to lexicon or lexicon does not exist
-	 */
-	private function matchAndApplyLexiconDefinition(
-		string $app,
-		string &$key,
-		?bool &$lazy = null,
-		int &$type = self::VALUE_MIXED,
-		?string &$default = null,
-		?Entry &$lexiconEntry = null,
-	): bool {
-		if (in_array($key,
-			[
-				'enabled',
-				'installed_version',
-				'types',
-			])) {
-			return true; // we don't break stuff for this list of config keys.
-		}
-		$configDetails = $this->getConfigDetailsFromLexicon($app);
-		if (array_key_exists($key, $configDetails['aliases']) && !$this->ignoreLexiconAliases) {
-			// in case '$rename' is set in ConfigLexiconEntry, we use the new config key
-			$key = $configDetails['aliases'][$key];
-		}
-
-		if (!array_key_exists($key, $configDetails['entries'])) {
-			return $this->applyLexiconStrictness($configDetails['strictness'], $app . '/' . $key);
-		}
-
-		// if lazy is NULL, we ignore all check on the type/lazyness/default from Lexicon
-		if ($lazy === null) {
-			return true;
-		}
-
-		/** @var Entry $lexiconEntry */
-		$lexiconEntry = $configDetails['entries'][$key];
-		$type &= ~self::VALUE_SENSITIVE;
-
-		$appConfigValueType = $lexiconEntry->getValueType()->toAppConfigFlag();
-		if ($type === self::VALUE_MIXED) {
-			$type = $appConfigValueType; // we overwrite if value was requested as mixed
-		} elseif ($appConfigValueType !== $type) {
-			throw new AppConfigTypeConflictException('The app config key ' . $app . '/' . $key . ' is typed incorrectly in relation to the config lexicon');
-		}
-
-		$lazy = $lexiconEntry->isLazy();
-		// only look for default if needed, default from Lexicon got priority
-		if ($default !== null) {
-			$default = $lexiconEntry->getDefault($this->presetManager->getLexiconPreset()) ?? $default;
-		}
-
-		if ($lexiconEntry->isFlagged(self::FLAG_SENSITIVE)) {
-			$type |= self::VALUE_SENSITIVE;
-		}
-		if ($lexiconEntry->isDeprecated()) {
-			$this->logger->notice('App config key ' . $app . '/' . $key . ' is set as deprecated.');
-		}
-
-		return true;
-	}
-
-	/**
-	 * manage ConfigLexicon behavior based on strictness set in IConfigLexicon
-	 *
-	 * @param Strictness|null $strictness
-	 * @param string $line
-	 *
-	 * @return bool TRUE if conflict can be fully ignored, FALSE if action should be not performed
-	 * @throws AppConfigUnknownKeyException if strictness implies exception
-	 * @see \OCP\Config\Lexicon\ILexicon::getStrictness()
-	 */
-	private function applyLexiconStrictness(?Strictness $strictness, string $configAppKey): bool {
-		if ($strictness === null) {
-			return true;
-		}
-
-		$line = 'The app config key ' . $configAppKey . ' is not defined in the config lexicon';
-		switch ($strictness) {
-			case Strictness::IGNORE:
-				return true;
-			case Strictness::NOTICE:
-				if (!in_array($configAppKey, $this->strictnessApplied, true)) {
-					$this->strictnessApplied[] = $configAppKey;
-					$this->logger->notice($line);
-				}
-				return true;
-			case Strictness::WARNING:
-				if (!in_array($configAppKey, $this->strictnessApplied, true)) {
-					$this->strictnessApplied[] = $configAppKey;
-					$this->logger->warning($line);
-				}
-				return false;
-		}
-
-		throw new AppConfigUnknownKeyException($line);
-	}
-
-	/**
-	 * extract details from registered $appId's config lexicon
-	 *
-	 * @param string $appId
-	 * @internal
-	 *
-	 * @return array{entries: array<string, Entry>, aliases: array<string, string>, strictness: Strictness}
-	 */
-	public function getConfigDetailsFromLexicon(string $appId): array {
-		if (!array_key_exists($appId, $this->configLexiconDetails)) {
-			$entries = $aliases = [];
-			$bootstrapCoordinator = \OCP\Server::get(Coordinator::class);
-			$configLexicon = $bootstrapCoordinator->getRegistrationContext()?->getConfigLexicon($appId);
-			foreach ($configLexicon?->getAppConfigs() ?? [] as $configEntry) {
-				$entries[$configEntry->getKey()] = $configEntry;
-				$newName = $configEntry->getRename();
-				if ($newName !== null) {
-					$aliases[$newName] = $configEntry->getKey();
-				}
-			}
-
-			$this->configLexiconDetails[$appId] = [
-				'entries' => $entries,
-				'aliases' => $aliases,
-				'strictness' => $configLexicon?->getStrictness() ?? Strictness::IGNORE
-			];
-		}
-
-		return $this->configLexiconDetails[$appId];
-	}
-
-	/**
-	 * get Lexicon Entry using appId and config key entry
-	 *
-	 * @return Entry|null NULL if entry does not exist in app's Lexicon
-	 * @internal
-	 */
-	public function getLexiconEntry(string $appId, string $key): ?Entry {
-		return $this->getConfigDetailsFromLexicon($appId)['entries'][$key] ?? null;
-	}
-
-	/**
-	 * if set to TRUE, ignore aliases defined in Config Lexicon during the use of the methods of this class
-	 *
-	 * @internal
-	 */
-	public function ignoreLexiconAliases(bool $ignore): void {
-		$this->ignoreLexiconAliases = $ignore;
-	}
-
-	/**
-	 * Returns the installed versions of all apps
-	 *
-	 * @return array<string, string>
-	 */
-	public function getAppInstalledVersions(bool $onlyEnabled = false): array {
-		if ($this->appVersionsCache === null) {
-			/** @var array<string, string> */
-			$this->appVersionsCache = $this->searchValues('installed_version', false, IAppConfig::VALUE_STRING);
-		}
-		if ($onlyEnabled) {
-			return array_filter(
-				$this->appVersionsCache,
-				fn (string $app): bool => $this->getValueString($app, 'enabled', 'no') !== 'no',
-				ARRAY_FILTER_USE_KEY
-			);
-		}
-		return $this->appVersionsCache;
-	}
-
-	private function clearLocalCache(): void {
-		$this->localCache?->remove(self::LOCAL_CACHE_KEY);
-	}
+    private const APP_MAX_LENGTH = 32;
+    private const KEY_MAX_LENGTH = 64;
+    private const ENCRYPTION_PREFIX = '$AppConfigEncryption$';
+    private const ENCRYPTION_PREFIX_LENGTH = 21; // strlen(self::ENCRYPTION_PREFIX)
+    private const LOCAL_CACHE_KEY = 'OC\\AppConfig';
+    private const LOCAL_CACHE_TTL = 3;
+
+    /** @var array<string, array<string, string>> ['app_id' => ['config_key' => 'config_value']] */
+    private array $fastCache = [];   // cache for normal config keys
+    /** @var array<string, array<string, string>> ['app_id' => ['config_key' => 'config_value']] */
+    private array $lazyCache = [];   // cache for lazy config keys
+    /** @var array<string, array<string, int>> ['app_id' => ['config_key' => bitflag]] */
+    private array $valueTypes = [];  // type for all config values
+    private bool $fastLoaded = false;
+    private bool $lazyLoaded = false;
+    /** @var array<string, array{entries: array<string, Entry>, aliases: array<string, string>, strictness: Strictness}> ['app_id' => ['strictness' => ConfigLexiconStrictness, 'entries' => ['config_key' => ConfigLexiconEntry[]]] */
+    private array $configLexiconDetails = [];
+    private bool $ignoreLexiconAliases = false;
+    private array $strictnessApplied = [];
+
+    /** @var ?array<string, string> */
+    private ?array $appVersionsCache = null;
+    private ?ICache $localCache = null;
+
+    public function __construct(
+        protected IDBConnection $connection,
+        protected IConfig $config,
+        private readonly ConfigManager $configManager,
+        private readonly PresetManager $presetManager,
+        protected LoggerInterface $logger,
+        protected ICrypto $crypto,
+        readonly CacheFactory $cacheFactory,
+    ) {
+        if ($config->getSystemValueBool('cache_app_config', true) && $cacheFactory->isLocalCacheAvailable()) {
+            $cacheFactory->withServerVersionPrefix(function (ICacheFactory $factory) {
+                $this->localCache = $factory->createLocal();
+            });
+        }
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @return list<string> list of app ids
+     * @since 7.0.0
+     */
+    public function getApps(): array {
+        $this->loadConfig(lazy: true);
+        $apps = array_merge(array_keys($this->fastCache), array_keys($this->lazyCache));
+        sort($apps);
+
+        return array_values(array_unique($apps));
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @return list<string> list of stored config keys
+     * @see searchKeys to not load lazy config keys
+     *
+     * @since 29.0.0
+     */
+    public function getKeys(string $app): array {
+        $this->assertParams($app);
+        $this->loadConfig($app, true);
+        $keys = array_merge(array_keys($this->fastCache[$app] ?? []), array_keys($this->lazyCache[$app] ?? []));
+        sort($keys);
+
+        return array_values(array_unique($keys));
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $prefix returns only keys starting with this value
+     * @param bool $lazy TRUE to search in lazy config keys
+     * @return list<string> list of stored config keys
+     * @since 32.0.0
+     */
+    public function searchKeys(string $app, string $prefix = '', bool $lazy = false): array {
+        $this->assertParams($app);
+        $this->loadConfig($app, $lazy);
+        if ($lazy) {
+            $keys = array_keys($this->lazyCache[$app] ?? []);
+        } else {
+            $keys = array_keys($this->fastCache[$app] ?? []);
+        }
+
+        if ($prefix !== '') {
+            $keys = array_filter($keys, static fn (string $key): bool => str_starts_with($key, $prefix));
+        }
+
+        sort($keys);
+        return array_values(array_unique($keys));
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool|null $lazy TRUE to search within lazy loaded config, NULL to search within all config
+     *
+     * @return bool TRUE if key exists
+     * @since 7.0.0
+     * @since 29.0.0 Added the $lazy argument
+     */
+    public function hasKey(string $app, string $key, ?bool $lazy = false): bool {
+        $this->assertParams($app, $key);
+        $this->loadConfig($app, $lazy ?? true);
+        $this->matchAndApplyLexiconDefinition($app, $key);
+
+        $hasLazy = isset($this->lazyCache[$app][$key]);
+        $hasFast = isset($this->fastCache[$app][$key]);
+        if ($lazy === null) {
+            return $hasLazy || $hasFast;
+        } else {
+            return $lazy ? $hasLazy : $hasFast;
+        }
+    }
+
+    /**
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool|null $lazy TRUE to search within lazy loaded config, NULL to search within all config
+     *
+     * @return bool
+     * @throws AppConfigUnknownKeyException if config key is not known
+     * @since 29.0.0
+     */
+    public function isSensitive(string $app, string $key, ?bool $lazy = false): bool {
+        $this->assertParams($app, $key);
+        $this->loadConfig(null, $lazy ?? true);
+        $this->matchAndApplyLexiconDefinition($app, $key);
+
+        if (!isset($this->valueTypes[$app][$key])) {
+            throw new AppConfigUnknownKeyException('unknown config key');
+        }
+
+        return $this->isTyped(self::VALUE_SENSITIVE, $this->valueTypes[$app][$key]);
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app if of the app
+     * @param string $key config key
+     *
+     * @return bool TRUE if config is lazy loaded
+     * @throws AppConfigUnknownKeyException if config key is not known
+     * @see IAppConfig for details about lazy loading
+     * @since 29.0.0
+     */
+    public function isLazy(string $app, string $key): bool {
+        $this->assertParams($app, $key);
+        $this->matchAndApplyLexiconDefinition($app, $key);
+
+        // there is a huge probability the non-lazy config are already loaded
+        if ($this->hasKey($app, $key, false)) {
+            return false;
+        }
+
+        // key not found, we search in the lazy config
+        if ($this->hasKey($app, $key, true)) {
+            return true;
+        }
+
+        throw new AppConfigUnknownKeyException('unknown config key');
+    }
+
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $prefix config keys prefix to search
+     * @param bool $filtered TRUE to hide sensitive config values. Value are replaced by {@see IConfig::SENSITIVE_VALUE}
+     *
+     * @return array<string, string|int|float|bool|array> [configKey => configValue]
+     * @since 29.0.0
+     */
+    public function getAllValues(string $app, string $prefix = '', bool $filtered = false): array {
+        $this->assertParams($app, $prefix);
+        // if we want to filter values, we need to get sensitivity
+        $this->loadConfig($app, true);
+        // array_merge() will remove numeric keys (here config keys), so addition arrays instead
+        $values = $this->formatAppValues($app, ($this->fastCache[$app] ?? []) + ($this->lazyCache[$app] ?? []));
+        $values = array_filter(
+            $values,
+            function (string $key) use ($prefix): bool {
+                return str_starts_with($key, $prefix); // filter values based on $prefix
+            }, ARRAY_FILTER_USE_KEY
+        );
+
+        if (!$filtered) {
+            return $values;
+        }
+
+        /**
+         * Using the old (deprecated) list of sensitive values.
+         */
+        foreach ($this->getSensitiveKeys($app) as $sensitiveKeyExp) {
+            $sensitiveKeys = preg_grep($sensitiveKeyExp, array_keys($values));
+            foreach ($sensitiveKeys as $sensitiveKey) {
+                $this->valueTypes[$app][$sensitiveKey] = ($this->valueTypes[$app][$sensitiveKey] ?? 0) | self::VALUE_SENSITIVE;
+            }
+        }
+
+        $result = [];
+        foreach ($values as $key => $value) {
+            $result[$key] = $this->isTyped(self::VALUE_SENSITIVE, $this->valueTypes[$app][$key] ?? 0) ? IConfig::SENSITIVE_VALUE : $value;
+        }
+
+        return $result;
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $key config key
+     * @param bool $lazy search within lazy loaded config
+     * @param int|null $typedAs enforce type for the returned values ({@see self::VALUE_STRING} and others)
+     *
+     * @return array<string, string|int|float|bool|array> [appId => configValue]
+     * @since 29.0.0
+     */
+    public function searchValues(string $key, bool $lazy = false, ?int $typedAs = null): array {
+        $this->assertParams('', $key, true);
+        $this->loadConfig(null, $lazy);
+
+        /** @var array<array-key, array<array-key, mixed>> $cache */
+        if ($lazy) {
+            $cache = $this->lazyCache;
+        } else {
+            $cache = $this->fastCache;
+        }
+
+        $values = [];
+        foreach (array_keys($cache) as $app) {
+            if (isset($cache[$app][$key])) {
+                $values[$app] = $this->convertTypedValue($cache[$app][$key], $typedAs ?? $this->getValueType((string)$app, $key, $lazy));
+            }
+        }
+
+        return $values;
+    }
+
+
+    /**
+     * Get the config value as string.
+     * If the value does not exist the given default will be returned.
+     *
+     * Set lazy to `null` to ignore it and get the value from either source.
+     *
+     * **WARNING:** Method is internal and **SHOULD** not be used, as it is better to get the value with a type.
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param string $default config value
+     * @param null|bool $lazy get config as lazy loaded or not. can be NULL
+     *
+     * @return string the value or $default
+     * @internal
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     * @see getValueString()
+     * @see getValueInt()
+     * @see getValueFloat()
+     * @see getValueBool()
+     * @see getValueArray()
+     */
+    public function getValueMixed(
+        string $app,
+        string $key,
+        string $default = '',
+        ?bool $lazy = false,
+    ): string {
+        try {
+            $lazy = ($lazy === null) ? $this->isLazy($app, $key) : $lazy;
+        } catch (AppConfigUnknownKeyException) {
+            return $default;
+        }
+
+        return $this->getTypedValue(
+            $app,
+            $key,
+            $default,
+            $lazy,
+            self::VALUE_MIXED
+        );
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param string $default default value
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return string stored config value or $default if not set in database
+     * @throws InvalidArgumentException if one of the argument format is invalid
+     * @throws AppConfigTypeConflictException in case of conflict with the value type set in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     */
+    public function getValueString(
+        string $app,
+        string $key,
+        string $default = '',
+        bool $lazy = false,
+    ): string {
+        return $this->getTypedValue($app, $key, $default, $lazy, self::VALUE_STRING);
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param int $default default value
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return int stored config value or $default if not set in database
+     * @throws InvalidArgumentException if one of the argument format is invalid
+     * @throws AppConfigTypeConflictException in case of conflict with the value type set in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     */
+    public function getValueInt(
+        string $app,
+        string $key,
+        int $default = 0,
+        bool $lazy = false,
+    ): int {
+        return (int)$this->getTypedValue($app, $key, (string)$default, $lazy, self::VALUE_INT);
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param float $default default value
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return float stored config value or $default if not set in database
+     * @throws InvalidArgumentException if one of the argument format is invalid
+     * @throws AppConfigTypeConflictException in case of conflict with the value type set in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     */
+    public function getValueFloat(string $app, string $key, float $default = 0, bool $lazy = false): float {
+        return (float)$this->getTypedValue($app, $key, (string)$default, $lazy, self::VALUE_FLOAT);
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $default default value
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return bool stored config value or $default if not set in database
+     * @throws InvalidArgumentException if one of the argument format is invalid
+     * @throws AppConfigTypeConflictException in case of conflict with the value type set in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     */
+    public function getValueBool(string $app, string $key, bool $default = false, bool $lazy = false): bool {
+        $b = strtolower($this->getTypedValue($app, $key, $default ? 'true' : 'false', $lazy, self::VALUE_BOOL));
+        return in_array($b, ['1', 'true', 'yes', 'on']);
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param array $default default value
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return array stored config value or $default if not set in database
+     * @throws InvalidArgumentException if one of the argument format is invalid
+     * @throws AppConfigTypeConflictException in case of conflict with the value type set in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     */
+    public function getValueArray(
+        string $app,
+        string $key,
+        array $default = [],
+        bool $lazy = false,
+    ): array {
+        try {
+            $defaultJson = json_encode($default, JSON_THROW_ON_ERROR);
+            $value = json_decode($this->getTypedValue($app, $key, $defaultJson, $lazy, self::VALUE_ARRAY), true, flags: JSON_THROW_ON_ERROR);
+
+            return is_array($value) ? $value : [];
+        } catch (JsonException) {
+            return [];
+        }
+    }
+
+    /**
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param string $default default value
+     * @param bool $lazy search within lazy loaded config
+     * @param int $type value type {@see VALUE_STRING} {@see VALUE_INT}{@see VALUE_FLOAT} {@see VALUE_BOOL} {@see VALUE_ARRAY}
+     *
+     * @return string
+     * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED and different from the requested one
+     * @throws InvalidArgumentException
+     */
+    private function getTypedValue(
+        string $app,
+        string $key,
+        string $default,
+        bool $lazy,
+        int $type,
+    ): string {
+        $this->assertParams($app, $key, valueType: $type);
+        $origKey = $key;
+        $matched = $this->matchAndApplyLexiconDefinition($app, $key, $lazy, $type, $default);
+        if ($default === null) {
+            // there is no logical reason for it to be null
+            throw new \Exception('default cannot be null');
+        }
+
+        // returns default if strictness of lexicon is set to WARNING (block and report)
+        if (!$matched) {
+            return $default;
+        }
+
+        $this->loadConfig($app, $lazy ?? true);
+
+        /**
+         * We ignore check if mixed type is requested.
+         * If type of stored value is set as mixed, we don't filter.
+         * If type of stored value is defined, we compare with the one requested.
+         */
+        $knownType = $this->valueTypes[$app][$key] ?? 0;
+        if (!$this->isTyped(self::VALUE_MIXED, $type)
+            && $knownType > 0
+            && !$this->isTyped(self::VALUE_MIXED, $knownType)
+            && !$this->isTyped($type, $knownType)) {
+            $this->logger->warning('conflict with value type from database', ['app' => $app, 'key' => $key, 'type' => $type, 'knownType' => $knownType]);
+            throw new AppConfigTypeConflictException('conflict with value type from database');
+        }
+
+        /**
+         * - the pair $app/$key cannot exist in both array,
+         * - we should still return an existing non-lazy value even if current method
+         *   is called with $lazy is true
+         *
+         * This way, lazyCache will be empty until the load for lazy config value is requested.
+         */
+        if (isset($this->lazyCache[$app][$key])) {
+            $value = $this->lazyCache[$app][$key];
+        } elseif (isset($this->fastCache[$app][$key])) {
+            $value = $this->fastCache[$app][$key];
+        } else {
+            return $default;
+        }
+
+        $sensitive = $this->isTyped(self::VALUE_SENSITIVE, $knownType);
+        if ($sensitive && str_starts_with($value, self::ENCRYPTION_PREFIX)) {
+            // Only decrypt values that are stored encrypted
+            $value = $this->crypto->decrypt(substr($value, self::ENCRYPTION_PREFIX_LENGTH));
+        }
+
+        // in case the key was modified while running matchAndApplyLexiconDefinition() we are
+        // interested to check options in case a modification of the value is needed
+        // ie inverting value from previous key when using lexicon option RENAME_INVERT_BOOLEAN
+        if ($origKey !== $key && $type === self::VALUE_BOOL) {
+            $value = ($this->configManager->convertToBool($value, $this->getLexiconEntry($app, $key))) ? '1' : '0';
+        }
+
+        return $value;
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     *
+     * @return int type of the value
+     * @throws AppConfigUnknownKeyException if config key is not known
+     * @since 29.0.0
+     * @see VALUE_STRING
+     * @see VALUE_INT
+     * @see VALUE_FLOAT
+     * @see VALUE_BOOL
+     * @see VALUE_ARRAY
+     */
+    public function getValueType(string $app, string $key, ?bool $lazy = null): int {
+        $type = self::VALUE_MIXED;
+        $ignorable = $lazy ?? false;
+        $this->matchAndApplyLexiconDefinition($app, $key, $ignorable, $type);
+        if ($type !== self::VALUE_MIXED) {
+            // a modified $type means config key is set in Lexicon
+            return $type;
+        }
+
+        $this->assertParams($app, $key);
+        $this->loadConfig($app, $lazy ?? true);
+
+        if (!isset($this->valueTypes[$app][$key])) {
+            throw new AppConfigUnknownKeyException('unknown config key');
+        }
+
+        $type = $this->valueTypes[$app][$key];
+        $type &= ~self::VALUE_SENSITIVE;
+        return $type;
+    }
+
+
+    /**
+     * Store a config key and its value in database as VALUE_MIXED
+     *
+     * **WARNING:** Method is internal and **MUST** not be used as it is best to set a real value type
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param string $value config value
+     * @param bool $lazy set config as lazy loaded
+     * @param bool $sensitive if TRUE value will be hidden when listing config values.
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED
+     * @internal
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     * @see setValueString()
+     * @see setValueInt()
+     * @see setValueFloat()
+     * @see setValueBool()
+     * @see setValueArray()
+     */
+    public function setValueMixed(
+        string $app,
+        string $key,
+        string $value,
+        bool $lazy = false,
+        bool $sensitive = false,
+    ): bool {
+        return $this->setTypedValue(
+            $app,
+            $key,
+            $value,
+            $lazy,
+            self::VALUE_MIXED | ($sensitive ? self::VALUE_SENSITIVE : 0)
+        );
+    }
+
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param string $value config value
+     * @param bool $lazy set config as lazy loaded
+     * @param bool $sensitive if TRUE value will be hidden when listing config values.
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED and different from the requested one
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     */
+    public function setValueString(
+        string $app,
+        string $key,
+        string $value,
+        bool $lazy = false,
+        bool $sensitive = false,
+    ): bool {
+        return $this->setTypedValue(
+            $app,
+            $key,
+            $value,
+            $lazy,
+            self::VALUE_STRING | ($sensitive ? self::VALUE_SENSITIVE : 0)
+        );
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param int $value config value
+     * @param bool $lazy set config as lazy loaded
+     * @param bool $sensitive if TRUE value will be hidden when listing config values.
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED and different from the requested one
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     */
+    public function setValueInt(
+        string $app,
+        string $key,
+        int $value,
+        bool $lazy = false,
+        bool $sensitive = false,
+    ): bool {
+        if ($value > 2000000000) {
+            $this->logger->debug('You are trying to store an integer value around/above 2,147,483,647. This is a reminder that reaching this theoretical limit on 32 bits system will throw an exception.');
+        }
+
+        return $this->setTypedValue(
+            $app,
+            $key,
+            (string)$value,
+            $lazy,
+            self::VALUE_INT | ($sensitive ? self::VALUE_SENSITIVE : 0)
+        );
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param float $value config value
+     * @param bool $lazy set config as lazy loaded
+     * @param bool $sensitive if TRUE value will be hidden when listing config values.
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED and different from the requested one
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     */
+    public function setValueFloat(
+        string $app,
+        string $key,
+        float $value,
+        bool $lazy = false,
+        bool $sensitive = false,
+    ): bool {
+        return $this->setTypedValue(
+            $app,
+            $key,
+            (string)$value,
+            $lazy,
+            self::VALUE_FLOAT | ($sensitive ? self::VALUE_SENSITIVE : 0)
+        );
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $value config value
+     * @param bool $lazy set config as lazy loaded
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED and different from the requested one
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     */
+    public function setValueBool(
+        string $app,
+        string $key,
+        bool $value,
+        bool $lazy = false,
+    ): bool {
+        return $this->setTypedValue(
+            $app,
+            $key,
+            ($value) ? '1' : '0',
+            $lazy,
+            self::VALUE_BOOL
+        );
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param array $value config value
+     * @param bool $lazy set config as lazy loaded
+     * @param bool $sensitive if TRUE value will be hidden when listing config values.
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED and different from the requested one
+     * @throws JsonException
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     */
+    public function setValueArray(
+        string $app,
+        string $key,
+        array $value,
+        bool $lazy = false,
+        bool $sensitive = false,
+    ): bool {
+        try {
+            return $this->setTypedValue(
+                $app,
+                $key,
+                json_encode($value, JSON_THROW_ON_ERROR),
+                $lazy,
+                self::VALUE_ARRAY | ($sensitive ? self::VALUE_SENSITIVE : 0)
+            );
+        } catch (JsonException $e) {
+            $this->logger->warning('could not setValueArray', ['app' => $app, 'key' => $key, 'exception' => $e]);
+            throw $e;
+        }
+    }
+
+    /**
+     * Store a config key and its value in database
+     *
+     * If config key is already known with the exact same config value and same sensitive/lazy status, the
+     * database is not updated. If config value was previously stored as sensitive, status will not be
+     * altered.
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param string $value config value
+     * @param bool $lazy config set as lazy loaded
+     * @param int $type value type {@see VALUE_STRING} {@see VALUE_INT} {@see VALUE_FLOAT} {@see VALUE_BOOL} {@see VALUE_ARRAY}
+     *
+     * @return bool TRUE if value was updated in database
+     * @throws AppConfigTypeConflictException if type from database is not VALUE_MIXED and different from the requested one
+     * @see IAppConfig for explanation about lazy loading
+     */
+    private function setTypedValue(
+        string $app,
+        string $key,
+        string $value,
+        bool $lazy,
+        int $type,
+    ): bool {
+        $this->assertParams($app, $key);
+        if (!$this->matchAndApplyLexiconDefinition($app, $key, $lazy, $type)) {
+            return false; // returns false as database is not updated
+        }
+        $this->loadConfig(null, $lazy ?? true);
+
+        $sensitive = $this->isTyped(self::VALUE_SENSITIVE, $type);
+        $inserted = $refreshCache = false;
+
+        $origValue = $value;
+        if ($sensitive || ($this->hasKey($app, $key, $lazy) && $this->isSensitive($app, $key, $lazy))) {
+            $value = self::ENCRYPTION_PREFIX . $this->crypto->encrypt($value);
+        }
+
+        if ($this->hasKey($app, $key, $lazy)) {
+            /**
+             * no update if key is already known with set lazy status and value is
+             * not different, unless sensitivity is switched from false to true.
+             */
+            if ($origValue === $this->getTypedValue($app, $key, $value, $lazy ?? true, $type)
+                && (!$sensitive || $this->isSensitive($app, $key, $lazy))) {
+                return false;
+            }
+        } else {
+            /**
+             * if key is not known yet, we try to insert.
+             * It might fail if the key exists with a different lazy flag.
+             */
+            try {
+                $insert = $this->connection->getQueryBuilder();
+                $insert->insert('appconfig')
+                    ->setValue('appid', $insert->createNamedParameter($app))
+                    ->setValue('lazy', $insert->createNamedParameter(($lazy) ? 1 : 0, IQueryBuilder::PARAM_INT))
+                    ->setValue('type', $insert->createNamedParameter($type, IQueryBuilder::PARAM_INT))
+                    ->setValue('configkey', $insert->createNamedParameter($key))
+                    ->setValue('configvalue', $insert->createNamedParameter($value));
+                $insert->executeStatement();
+                $inserted = true;
+            } catch (DBException $e) {
+                if ($e->getReason() !== DBException::REASON_UNIQUE_CONSTRAINT_VIOLATION) {
+                    throw $e; // TODO: throw exception or just log and returns false !?
+                }
+            }
+        }
+
+        /**
+         * We cannot insert a new row, meaning we need to update an already existing one
+         */
+        if (!$inserted) {
+            $currType = $this->valueTypes[$app][$key] ?? 0;
+            if ($currType === 0) { // this might happen when switching lazy loading status
+                $this->loadConfig(lazy: true);
+                $currType = $this->valueTypes[$app][$key] ?? 0;
+            }
+
+            /**
+             * This should only happen during the upgrade process from 28 to 29.
+             * We only log a warning and set it to VALUE_MIXED.
+             */
+            if ($currType === 0) {
+                $this->logger->warning('Value type is set to zero (0) in database. This is fine only during the upgrade process from 28 to 29.', ['app' => $app, 'key' => $key]);
+                $currType = self::VALUE_MIXED;
+            }
+
+            /**
+             * we only accept a different type from the one stored in database
+             * if the one stored in database is not-defined (VALUE_MIXED)
+             */
+            if (!$this->isTyped(self::VALUE_MIXED, $currType)
+                && ($type | self::VALUE_SENSITIVE) !== ($currType | self::VALUE_SENSITIVE)) {
+                try {
+                    $currType = $this->convertTypeToString($currType);
+                    $type = $this->convertTypeToString($type);
+                } catch (AppConfigIncorrectTypeException) {
+                    // can be ignored, this was just needed for a better exception message.
+                }
+                throw new AppConfigTypeConflictException('conflict between new type (' . $type . ') and old type (' . $currType . ')');
+            }
+
+            // we fix $type if the stored value, or the new value as it might be changed, is set as sensitive
+            if ($sensitive || $this->isTyped(self::VALUE_SENSITIVE, $currType)) {
+                $type |= self::VALUE_SENSITIVE;
+            }
+
+            try {
+                if ($lazy !== $this->isLazy($app, $key)) {
+                    $refreshCache = true;
+                }
+            } catch (AppConfigUnknownKeyException) {
+                // pass
+            }
+
+            $update = $this->connection->getQueryBuilder();
+            $update->update('appconfig')
+                ->set('configvalue', $update->createNamedParameter($value))
+                ->set('lazy', $update->createNamedParameter(($lazy) ? 1 : 0, IQueryBuilder::PARAM_INT))
+                ->set('type', $update->createNamedParameter($type, IQueryBuilder::PARAM_INT))
+                ->where($update->expr()->eq('appid', $update->createNamedParameter($app)))
+                ->andWhere($update->expr()->eq('configkey', $update->createNamedParameter($key)));
+
+            $update->executeStatement();
+        }
+
+        if ($refreshCache) {
+            $this->clearCache();
+            return true;
+        }
+
+        // update local cache
+        if ($lazy) {
+            $this->lazyCache[$app][$key] = $value;
+        } else {
+            $this->fastCache[$app][$key] = $value;
+        }
+        $this->valueTypes[$app][$key] = $type;
+        $this->clearLocalCache();
+
+        return true;
+    }
+
+    /**
+     * Change the type of config value.
+     *
+     * **WARNING:** Method is internal and **MUST** not be used as it may break things.
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param int $type value type {@see VALUE_STRING} {@see VALUE_INT} {@see VALUE_FLOAT} {@see VALUE_BOOL} {@see VALUE_ARRAY}
+     *
+     * @return bool TRUE if database update were necessary
+     * @throws AppConfigUnknownKeyException if $key is now known in database
+     * @throws AppConfigIncorrectTypeException if $type is not valid
+     * @internal
+     * @since 29.0.0
+     */
+    public function updateType(string $app, string $key, int $type = self::VALUE_MIXED): bool {
+        $this->assertParams($app, $key);
+        $this->loadConfig(lazy: true);
+        $this->matchAndApplyLexiconDefinition($app, $key);
+        $this->isLazy($app, $key); // confirm key exists
+
+        // type can only be one type
+        if (!in_array($type, [self::VALUE_MIXED, self::VALUE_STRING, self::VALUE_INT, self::VALUE_FLOAT, self::VALUE_BOOL, self::VALUE_ARRAY])) {
+            throw new AppConfigIncorrectTypeException('Unknown value type');
+        }
+
+        $currType = $this->valueTypes[$app][$key];
+        if (($type | self::VALUE_SENSITIVE) === ($currType | self::VALUE_SENSITIVE)) {
+            return false;
+        }
+
+        // we complete with sensitive flag if the stored value is set as sensitive
+        if ($this->isTyped(self::VALUE_SENSITIVE, $currType)) {
+            $type = $type | self::VALUE_SENSITIVE;
+        }
+
+        $update = $this->connection->getQueryBuilder();
+        $update->update('appconfig')
+            ->set('type', $update->createNamedParameter($type, IQueryBuilder::PARAM_INT))
+            ->where($update->expr()->eq('appid', $update->createNamedParameter($app)))
+            ->andWhere($update->expr()->eq('configkey', $update->createNamedParameter($key)));
+        $update->executeStatement();
+        $this->valueTypes[$app][$key] = $type;
+
+        return true;
+    }
+
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $sensitive TRUE to set as sensitive, FALSE to unset
+     *
+     * @return bool TRUE if entry was found in database and an update was necessary
+     * @since 29.0.0
+     */
+    public function updateSensitive(string $app, string $key, bool $sensitive): bool {
+        $this->assertParams($app, $key);
+        $this->loadConfig(lazy: true);
+        $this->matchAndApplyLexiconDefinition($app, $key);
+
+        try {
+            if ($sensitive === $this->isSensitive($app, $key, null)) {
+                return false;
+            }
+        } catch (AppConfigUnknownKeyException $e) {
+            return false;
+        }
+
+        $lazy = $this->isLazy($app, $key);
+        if ($lazy) {
+            $cache = $this->lazyCache;
+        } else {
+            $cache = $this->fastCache;
+        }
+
+        if (!isset($cache[$app][$key])) {
+            throw new AppConfigUnknownKeyException('unknown config key');
+        }
+
+        /**
+         * type returned by getValueType() is already cleaned from sensitive flag
+         * we just need to update it based on $sensitive and store it in database
+         */
+        $type = $this->getValueType($app, $key);
+        $value = $cache[$app][$key];
+        if ($sensitive) {
+            $type |= self::VALUE_SENSITIVE;
+            $value = self::ENCRYPTION_PREFIX . $this->crypto->encrypt($value);
+        } else {
+            $value = $this->crypto->decrypt(substr($value, self::ENCRYPTION_PREFIX_LENGTH));
+        }
+
+        $update = $this->connection->getQueryBuilder();
+        $update->update('appconfig')
+            ->set('type', $update->createNamedParameter($type, IQueryBuilder::PARAM_INT))
+            ->set('configvalue', $update->createNamedParameter($value))
+            ->where($update->expr()->eq('appid', $update->createNamedParameter($app)))
+            ->andWhere($update->expr()->eq('configkey', $update->createNamedParameter($key)));
+        $update->executeStatement();
+
+        $this->valueTypes[$app][$key] = $type;
+
+        return true;
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $lazy TRUE to set as lazy loaded, FALSE to unset
+     *
+     * @return bool TRUE if entry was found in database and an update was necessary
+     * @since 29.0.0
+     */
+    public function updateLazy(string $app, string $key, bool $lazy): bool {
+        $this->assertParams($app, $key);
+        $this->loadConfig(lazy: true);
+        $this->matchAndApplyLexiconDefinition($app, $key);
+
+        try {
+            if ($lazy === $this->isLazy($app, $key)) {
+                return false;
+            }
+        } catch (AppConfigUnknownKeyException $e) {
+            return false;
+        }
+
+        $update = $this->connection->getQueryBuilder();
+        $update->update('appconfig')
+            ->set('lazy', $update->createNamedParameter($lazy ? 1 : 0, IQueryBuilder::PARAM_INT))
+            ->where($update->expr()->eq('appid', $update->createNamedParameter($app)))
+            ->andWhere($update->expr()->eq('configkey', $update->createNamedParameter($key)));
+        $update->executeStatement();
+
+        // At this point, it is a lot safer to clean cache
+        $this->clearCache();
+
+        return true;
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     *
+     * @return array
+     * @throws AppConfigUnknownKeyException if config key is not known in database
+     * @since 29.0.0
+     */
+    public function getDetails(string $app, string $key): array {
+        $this->assertParams($app, $key);
+        $this->loadConfig(lazy: true);
+        $this->matchAndApplyLexiconDefinition($app, $key);
+        $lazy = $this->isLazy($app, $key);
+
+        if ($lazy) {
+            $cache = $this->lazyCache;
+        } else {
+            $cache = $this->fastCache;
+        }
+
+        $type = $this->getValueType($app, $key);
+        try {
+            $typeString = $this->convertTypeToString($type);
+        } catch (AppConfigIncorrectTypeException $e) {
+            $this->logger->warning('type stored in database is not correct', ['exception' => $e, 'type' => $type]);
+            $typeString = (string)$type;
+        }
+
+        if (!isset($cache[$app][$key])) {
+            throw new AppConfigUnknownKeyException('unknown config key');
+        }
+
+        $value = $cache[$app][$key];
+        $sensitive = $this->isSensitive($app, $key, null);
+        if ($sensitive && str_starts_with($value, self::ENCRYPTION_PREFIX)) {
+            $value = $this->crypto->decrypt(substr($value, self::ENCRYPTION_PREFIX_LENGTH));
+        }
+
+        return [
+            'app' => $app,
+            'key' => $key,
+            'value' => $value,
+            'type' => $type,
+            'lazy' => $lazy,
+            'typeString' => $typeString,
+            'sensitive' => $sensitive
+        ];
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     *
+     * @return array{app: string, key: string, lazy?: bool, valueType?: ValueType, valueTypeName?: string, sensitive?: bool, internal?: bool, default?: string, definition?: string, note?: string}
+     * @since 32.0.0
+     */
+    public function getKeyDetails(string $app, string $key): array {
+        $this->assertParams($app, $key);
+        try {
+            $details = $this->getDetails($app, $key);
+        } catch (AppConfigUnknownKeyException) {
+            $details = [
+                'app' => $app,
+                'key' => $key
+            ];
+        }
+
+        /** @var Entry $lexiconEntry */
+        try {
+            $lazy = false;
+            $this->matchAndApplyLexiconDefinition($app, $key, $lazy, lexiconEntry: $lexiconEntry);
+        } catch (AppConfigTypeConflictException|AppConfigUnknownKeyException) {
+            // can be ignored
+        }
+
+        if ($lexiconEntry !== null) {
+            $details = array_merge($details, [
+                'lazy' => $lexiconEntry->isLazy(),
+                'valueType' => $lexiconEntry->getValueType(),
+                'valueTypeName' => $lexiconEntry->getValueType()->name,
+                'sensitive' => $lexiconEntry->isFlagged(self::FLAG_SENSITIVE),
+                'internal' => $lexiconEntry->isFlagged(self::FLAG_INTERNAL),
+                'default' => $lexiconEntry->getDefault($this->presetManager->getLexiconPreset()),
+                'definition' => $lexiconEntry->getDefinition(),
+                'note' => $lexiconEntry->getNote(),
+            ]);
+        }
+
+        return array_filter($details, static fn ($v): bool => ($v !== null));
+    }
+
+    /**
+     * @param string $type
+     *
+     * @return int
+     * @throws AppConfigIncorrectTypeException
+     * @since 29.0.0
+     */
+    public function convertTypeToInt(string $type): int {
+        return match (strtolower($type)) {
+            'mixed' => IAppConfig::VALUE_MIXED,
+            'string' => IAppConfig::VALUE_STRING,
+            'integer' => IAppConfig::VALUE_INT,
+            'float' => IAppConfig::VALUE_FLOAT,
+            'boolean' => IAppConfig::VALUE_BOOL,
+            'array' => IAppConfig::VALUE_ARRAY,
+            default => throw new AppConfigIncorrectTypeException('Unknown type ' . $type)
+        };
+    }
+
+    /**
+     * @param int $type
+     *
+     * @return string
+     * @throws AppConfigIncorrectTypeException
+     * @since 29.0.0
+     */
+    public function convertTypeToString(int $type): string {
+        $type &= ~self::VALUE_SENSITIVE;
+
+        return match ($type) {
+            IAppConfig::VALUE_MIXED => 'mixed',
+            IAppConfig::VALUE_STRING => 'string',
+            IAppConfig::VALUE_INT => 'integer',
+            IAppConfig::VALUE_FLOAT => 'float',
+            IAppConfig::VALUE_BOOL => 'boolean',
+            IAppConfig::VALUE_ARRAY => 'array',
+            default => throw new AppConfigIncorrectTypeException('Unknown numeric type ' . $type)
+        };
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     *
+     * @since 29.0.0
+     */
+    public function deleteKey(string $app, string $key): void {
+        $this->assertParams($app, $key);
+        $this->matchAndApplyLexiconDefinition($app, $key);
+
+        $qb = $this->connection->getQueryBuilder();
+        $qb->delete('appconfig')
+            ->where($qb->expr()->eq('appid', $qb->createNamedParameter($app)))
+            ->andWhere($qb->expr()->eq('configkey', $qb->createNamedParameter($key)));
+        $qb->executeStatement();
+
+        unset($this->lazyCache[$app][$key]);
+        unset($this->fastCache[$app][$key]);
+        unset($this->valueTypes[$app][$key]);
+        $this->clearLocalCache();
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param string $app id of the app
+     *
+     * @since 29.0.0
+     */
+    public function deleteApp(string $app): void {
+        $this->assertParams($app);
+        $qb = $this->connection->getQueryBuilder();
+        $qb->delete('appconfig')
+            ->where($qb->expr()->eq('appid', $qb->createNamedParameter($app)));
+        $qb->executeStatement();
+
+        $this->clearCache();
+    }
+
+    /**
+     * @inheritDoc
+     *
+     * @param bool $reload set to TRUE to refill cache instantly after clearing it
+     *
+     * @internal
+     * @since 29.0.0
+     */
+    public function clearCache(bool $reload = false): void {
+        $this->lazyLoaded = $this->fastLoaded = false;
+        $this->lazyCache = $this->fastCache = $this->valueTypes = $this->configLexiconDetails = [];
+        $this->localCache?->remove(self::LOCAL_CACHE_KEY);
+
+        if (!$reload) {
+            return;
+        }
+
+        $this->loadConfig(lazy: true);
+    }
+
+
+    /**
+     * For debug purpose.
+     * Returns the cached data.
+     *
+     * @return array
+     * @since 29.0.0
+     * @internal
+     */
+    public function statusCache(): array {
+        return [
+            'fastLoaded' => $this->fastLoaded,
+            'fastCache' => $this->fastCache,
+            'lazyLoaded' => $this->lazyLoaded,
+            'lazyCache' => $this->lazyCache,
+        ];
+    }
+
+    /**
+     * @param int $needle bitflag to search
+     * @param int $type known value
+     *
+     * @return bool TRUE if bitflag $needle is set in $type
+     */
+    private function isTyped(int $needle, int $type): bool {
+        return (($needle & $type) !== 0);
+    }
+
+    /**
+     * Confirm the string set for app and key fit the database description
+     *
+     * @param string $app assert $app fit in database
+     * @param string $configKey assert config key fit in database
+     * @param bool $allowEmptyApp $app can be empty string
+     * @param int $valueType assert value type is only one type
+     *
+     * @throws InvalidArgumentException
+     */
+    private function assertParams(string $app = '', string $configKey = '', bool $allowEmptyApp = false, int $valueType = -1): void {
+        if (!$allowEmptyApp && $app === '') {
+            throw new InvalidArgumentException('app cannot be an empty string');
+        }
+        if (strlen($app) > self::APP_MAX_LENGTH) {
+            throw new InvalidArgumentException(
+                'Value (' . $app . ') for app is too long (' . self::APP_MAX_LENGTH . ')'
+            );
+        }
+        if (strlen($configKey) > self::KEY_MAX_LENGTH) {
+            throw new InvalidArgumentException('Value (' . $configKey . ') for key is too long (' . self::KEY_MAX_LENGTH . ')');
+        }
+        if ($valueType > -1) {
+            $valueType &= ~self::VALUE_SENSITIVE;
+            if (!in_array($valueType, [self::VALUE_MIXED, self::VALUE_STRING, self::VALUE_INT, self::VALUE_FLOAT, self::VALUE_BOOL, self::VALUE_ARRAY])) {
+                throw new InvalidArgumentException('Unknown value type');
+            }
+        }
+    }
+
+    /**
+     * Load normal config or config set as lazy loaded
+     *
+     * @param bool $lazy set to TRUE to also load config values set as lazy loaded
+     */
+    private function loadConfig(?string $app = null, bool $lazy = false): void {
+        if ($this->isLoaded($lazy)) {
+            return;
+        }
+
+        // if lazy is null or true, we debug log
+        if ($lazy === true && $app !== null) {
+            $exception = new \RuntimeException('The loading of lazy AppConfig values have been triggered by app "' . $app . '"');
+            $this->logger->debug($exception->getMessage(), ['exception' => $exception, 'app' => $app]);
+        }
+
+        $loadLazyOnly = $lazy && $this->isLoaded();
+
+        /** @var array<mixed> */
+        $cacheContent = $this->localCache?->get(self::LOCAL_CACHE_KEY) ?? [];
+        $includesLazyValues = !empty($cacheContent) && !empty($cacheContent['lazyCache']);
+        if (!empty($cacheContent) && (!$lazy || $includesLazyValues)) {
+            $this->valueTypes = $cacheContent['valueTypes'];
+            $this->fastCache = $cacheContent['fastCache'];
+            $this->fastLoaded = !empty($this->fastCache);
+            if ($includesLazyValues) {
+                $this->lazyCache = $cacheContent['lazyCache'];
+                $this->lazyLoaded = !empty($this->lazyCache);
+            }
+            return;
+        }
+
+        // Otherwise no cache available and we need to fetch from database
+        $qb = $this->connection->getQueryBuilder();
+        $qb->from('appconfig')
+            ->select('appid', 'configkey', 'configvalue', 'type');
+
+        if ($lazy === false) {
+            $qb->where($qb->expr()->eq('lazy', $qb->createNamedParameter(0, IQueryBuilder::PARAM_INT)));
+        } else {
+            if ($loadLazyOnly) {
+                $qb->where($qb->expr()->eq('lazy', $qb->createNamedParameter(1, IQueryBuilder::PARAM_INT)));
+            }
+            $qb->addSelect('lazy');
+        }
+
+        $result = $qb->executeQuery();
+        $rows = $result->fetchAll();
+        foreach ($rows as $row) {
+            // most of the time, 'lazy' is not in the select because its value is already known
+            if ($lazy && ((int)$row['lazy']) === 1) {
+                $this->lazyCache[$row['appid']][$row['configkey']] = $row['configvalue'] ?? '';
+            } else {
+                $this->fastCache[$row['appid']][$row['configkey']] = $row['configvalue'] ?? '';
+            }
+            $this->valueTypes[$row['appid']][$row['configkey']] = (int)($row['type'] ?? 0);
+        }
+
+        $result->closeCursor();
+        $this->localCache?->set(
+            self::LOCAL_CACHE_KEY,
+            [
+                'fastCache' => $this->fastCache,
+                'lazyCache' => $this->lazyCache,
+                'valueTypes' => $this->valueTypes,
+            ],
+            self::LOCAL_CACHE_TTL,
+        );
+
+        $this->fastLoaded = true;
+        $this->lazyLoaded = $lazy;
+    }
+
+    /**
+     * @param bool $lazy - If set to true then also check if lazy values are loaded
+     */
+    private function isLoaded(bool $lazy = false): bool {
+        return $this->fastLoaded && (!$lazy || $this->lazyLoaded);
+    }
+
+    /**
+     * Gets the config value
+     *
+     * @param string $app app
+     * @param string $key key
+     * @param string $default - Default value if the key does not exist
+     *
+     * @return string the value or $default
+     * @deprecated 29.0.0 use getValue*()
+     *
+     * This function gets a value from the appconfig table. If the key does
+     * not exist the default value will be returned
+     */
+    public function getValue($app, $key, $default = '') {
+        $this->loadConfig($app);
+        $this->matchAndApplyLexiconDefinition($app, $key);
+
+        return $this->fastCache[$app][$key] ?? $default;
+    }
+
+    /**
+     * Sets a value. If the key did not exist before it will be created.
+     *
+     * @param string $app app
+     * @param string $key key
+     * @param string|float|int $value value
+     *
+     * @return bool True if the value was inserted or updated, false if the value was the same
+     * @throws AppConfigTypeConflictException
+     * @throws AppConfigUnknownKeyException
+     * @deprecated 29.0.0
+     */
+    public function setValue($app, $key, $value) {
+        /**
+         * TODO: would it be overkill, or decently improve performance, to catch
+         * call to this method with $key='enabled' and 'hide' config value related
+         * to $app when the app is disabled (by modifying entry in database: lazy=lazy+2)
+         * or enabled (lazy=lazy-2)
+         *
+         * this solution would remove the loading of config values from disabled app
+         * unless calling the method.
+         */
+        return $this->setTypedValue($app, $key, (string)$value, false, self::VALUE_MIXED);
+    }
+
+
+    /**
+     * get multiple values, either the app or key can be used as wildcard by setting it to false
+     *
+     * @param string|false $app
+     * @param string|false $key
+     *
+     * @return array|false
+     * @deprecated 29.0.0 use {@see getAllValues()}
+     */
+    public function getValues($app, $key) {
+        if (($app !== false) === ($key !== false)) {
+            return false;
+        }
+
+        $key = ($key === false) ? '' : $key;
+        if (!$app) {
+            return $this->searchValues($key, false, self::VALUE_MIXED);
+        } else {
+            return $this->getAllValues($app, $key);
+        }
+    }
+
+    /**
+     * get all values of the app or and filters out sensitive data
+     *
+     * @param string $app
+     *
+     * @return array
+     * @deprecated 29.0.0 use {@see getAllValues()}
+     */
+    public function getFilteredValues($app) {
+        return $this->getAllValues($app, filtered: true);
+    }
+
+
+    /**
+     * **Warning:** avoid default NULL value for $lazy as this will
+     * load all lazy values from the database
+     *
+     * @param string $app
+     * @param array<string, string> $values ['key' => 'value']
+     * @param bool|null $lazy
+     *
+     * @return array<string, string|int|float|bool|array>
+     */
+    private function formatAppValues(string $app, array $values, ?bool $lazy = null): array {
+        foreach ($values as $key => $value) {
+            try {
+                $type = $this->getValueType($app, $key, $lazy);
+            } catch (AppConfigUnknownKeyException) {
+                continue;
+            }
+
+            $values[$key] = $this->convertTypedValue($value, $type);
+        }
+
+        return $values;
+    }
+
+    /**
+     * convert string value to the expected type
+     *
+     * @param string $value
+     * @param int $type
+     *
+     * @return string|int|float|bool|array
+     */
+    private function convertTypedValue(string $value, int $type): string|int|float|bool|array {
+        switch ($type) {
+            case self::VALUE_INT:
+                return (int)$value;
+            case self::VALUE_FLOAT:
+                return (float)$value;
+            case self::VALUE_BOOL:
+                return in_array(strtolower($value), ['1', 'true', 'yes', 'on']);
+            case self::VALUE_ARRAY:
+                try {
+                    return json_decode($value, true, flags: JSON_THROW_ON_ERROR);
+                } catch (JsonException $e) {
+                    // ignoreable
+                }
+                break;
+        }
+        return $value;
+    }
+
+    /**
+     * @param string $app
+     *
+     * @return string[]
+     * @deprecated 29.0.0 data sensitivity should be set when calling setValue*()
+     */
+    private function getSensitiveKeys(string $app): array {
+        $sensitiveValues = [
+            'circles' => [
+                '/^key_pairs$/',
+                '/^local_gskey$/',
+            ],
+            'call_summary_bot' => [
+                '/^secret_(.*)$/',
+            ],
+            'external' => [
+                '/^sites$/',
+                '/^jwt_token_privkey_(.*)$/',
+            ],
+            'globalsiteselector' => [
+                '/^gss\.jwt\.key$/',
+            ],
+            'gpgmailer' => [
+                '/^GpgServerKey$/',
+            ],
+            'integration_discourse' => [
+                '/^private_key$/',
+                '/^public_key$/',
+            ],
+            'integration_dropbox' => [
+                '/^client_id$/',
+                '/^client_secret$/',
+            ],
+            'integration_github' => [
+                '/^client_id$/',
+                '/^client_secret$/',
+            ],
+            'integration_gitlab' => [
+                '/^client_id$/',
+                '/^client_secret$/',
+                '/^oauth_instance_url$/',
+            ],
+            'integration_google' => [
+                '/^client_id$/',
+                '/^client_secret$/',
+            ],
+            'integration_jira' => [
+                '/^client_id$/',
+                '/^client_secret$/',
+                '/^forced_instance_url$/',
+            ],
+            'integration_onedrive' => [
+                '/^client_id$/',
+                '/^client_secret$/',
+            ],
+            'integration_openproject' => [
+                '/^client_id$/',
+                '/^client_secret$/',
+                '/^oauth_instance_url$/',
+            ],
+            'integration_reddit' => [
+                '/^client_id$/',
+                '/^client_secret$/',
+            ],
+            'integration_suitecrm' => [
+                '/^client_id$/',
+                '/^client_secret$/',
+                '/^oauth_instance_url$/',
+            ],
+            'integration_twitter' => [
+                '/^consumer_key$/',
+                '/^consumer_secret$/',
+                '/^followed_user$/',
+            ],
+            'integration_zammad' => [
+                '/^client_id$/',
+                '/^client_secret$/',
+                '/^oauth_instance_url$/',
+            ],
+            'maps' => [
+                '/^mapboxAPIKEY$/',
+            ],
+            'notify_push' => [
+                '/^cookie$/',
+            ],
+            'onlyoffice' => [
+                '/^jwt_secret$/',
+            ],
+            'passwords' => [
+                '/^SSEv1ServerKey$/',
+            ],
+            'serverinfo' => [
+                '/^token$/',
+            ],
+            'spreed' => [
+                '/^bridge_bot_password$/',
+                '/^hosted-signaling-server-(.*)$/',
+                '/^recording_servers$/',
+                '/^signaling_servers$/',
+                '/^signaling_ticket_secret$/',
+                '/^signaling_token_privkey_(.*)$/',
+                '/^signaling_token_pubkey_(.*)$/',
+                '/^sip_bridge_dialin_info$/',
+                '/^sip_bridge_shared_secret$/',
+                '/^stun_servers$/',
+                '/^turn_servers$/',
+                '/^turn_server_secret$/',
+            ],
+            'support' => [
+                '/^last_response$/',
+                '/^potential_subscription_key$/',
+                '/^subscription_key$/',
+            ],
+            'theming' => [
+                '/^imprintUrl$/',
+                '/^privacyUrl$/',
+                '/^slogan$/',
+                '/^url$/',
+            ],
+            'twofactor_gateway' => [
+                '/^.*token$/',
+            ],
+            'user_ldap' => [
+                '/^(s..)?ldap_agent_password$/',
+            ],
+            'user_saml' => [
+                '/^idp-x509cert$/',
+            ],
+            'whiteboard' => [
+                '/^jwt_secret_key$/',
+            ],
+        ];
+
+        return $sensitiveValues[$app] ?? [];
+    }
+
+    /**
+     * Clear all the cached app config values
+     * New cache will be generated next time a config value is retrieved
+     *
+     * @deprecated 29.0.0 use {@see clearCache()}
+     */
+    public function clearCachedConfig(): void {
+        $this->clearCache();
+    }
+
+    /**
+     * Match and apply current use of config values with defined lexicon.
+     * Set $lazy to NULL only if only interested into checking that $key is alias.
+     *
+     * @throws AppConfigUnknownKeyException
+     * @throws AppConfigTypeConflictException
+     * @return bool TRUE if everything is fine compared to lexicon or lexicon does not exist
+     */
+    private function matchAndApplyLexiconDefinition(
+        string $app,
+        string &$key,
+        ?bool &$lazy = null,
+        int &$type = self::VALUE_MIXED,
+        ?string &$default = null,
+        ?Entry &$lexiconEntry = null,
+    ): bool {
+        if (in_array($key,
+            [
+                'enabled',
+                'installed_version',
+                'types',
+            ])) {
+            return true; // we don't break stuff for this list of config keys.
+        }
+        $configDetails = $this->getConfigDetailsFromLexicon($app);
+        if (array_key_exists($key, $configDetails['aliases']) && !$this->ignoreLexiconAliases) {
+            // in case '$rename' is set in ConfigLexiconEntry, we use the new config key
+            $key = $configDetails['aliases'][$key];
+        }
+
+        if (!array_key_exists($key, $configDetails['entries'])) {
+            return $this->applyLexiconStrictness($configDetails['strictness'], $app . '/' . $key);
+        }
+
+        // if lazy is NULL, we ignore all check on the type/lazyness/default from Lexicon
+        if ($lazy === null) {
+            return true;
+        }
+
+        /** @var Entry $lexiconEntry */
+        $lexiconEntry = $configDetails['entries'][$key];
+        $type &= ~self::VALUE_SENSITIVE;
+
+        $appConfigValueType = $lexiconEntry->getValueType()->toAppConfigFlag();
+        if ($type === self::VALUE_MIXED) {
+            $type = $appConfigValueType; // we overwrite if value was requested as mixed
+        } elseif ($appConfigValueType !== $type) {
+            throw new AppConfigTypeConflictException('The app config key ' . $app . '/' . $key . ' is typed incorrectly in relation to the config lexicon');
+        }
+
+        $lazy = $lexiconEntry->isLazy();
+        // only look for default if needed, default from Lexicon got priority
+        if ($default !== null) {
+            $default = $lexiconEntry->getDefault($this->presetManager->getLexiconPreset()) ?? $default;
+        }
+
+        if ($lexiconEntry->isFlagged(self::FLAG_SENSITIVE)) {
+            $type |= self::VALUE_SENSITIVE;
+        }
+        if ($lexiconEntry->isDeprecated()) {
+            $this->logger->notice('App config key ' . $app . '/' . $key . ' is set as deprecated.');
+        }
+
+        return true;
+    }
+
+    /**
+     * manage ConfigLexicon behavior based on strictness set in IConfigLexicon
+     *
+     * @param Strictness|null $strictness
+     * @param string $line
+     *
+     * @return bool TRUE if conflict can be fully ignored, FALSE if action should be not performed
+     * @throws AppConfigUnknownKeyException if strictness implies exception
+     * @see \OCP\Config\Lexicon\ILexicon::getStrictness()
+     */
+    private function applyLexiconStrictness(?Strictness $strictness, string $configAppKey): bool {
+        if ($strictness === null) {
+            return true;
+        }
+
+        $line = 'The app config key ' . $configAppKey . ' is not defined in the config lexicon';
+        switch ($strictness) {
+            case Strictness::IGNORE:
+                return true;
+            case Strictness::NOTICE:
+                if (!in_array($configAppKey, $this->strictnessApplied, true)) {
+                    $this->strictnessApplied[] = $configAppKey;
+                    $this->logger->notice($line);
+                }
+                return true;
+            case Strictness::WARNING:
+                if (!in_array($configAppKey, $this->strictnessApplied, true)) {
+                    $this->strictnessApplied[] = $configAppKey;
+                    $this->logger->warning($line);
+                }
+                return false;
+        }
+
+        throw new AppConfigUnknownKeyException($line);
+    }
+
+    /**
+     * extract details from registered $appId's config lexicon
+     *
+     * @param string $appId
+     * @internal
+     *
+     * @return array{entries: array<string, Entry>, aliases: array<string, string>, strictness: Strictness}
+     */
+    public function getConfigDetailsFromLexicon(string $appId): array {
+        if (!array_key_exists($appId, $this->configLexiconDetails)) {
+            $entries = $aliases = [];
+            $bootstrapCoordinator = \OCP\Server::get(Coordinator::class);
+            $configLexicon = $bootstrapCoordinator->getRegistrationContext()?->getConfigLexicon($appId);
+            foreach ($configLexicon?->getAppConfigs() ?? [] as $configEntry) {
+                $entries[$configEntry->getKey()] = $configEntry;
+                $newName = $configEntry->getRename();
+                if ($newName !== null) {
+                    $aliases[$newName] = $configEntry->getKey();
+                }
+            }
+
+            $this->configLexiconDetails[$appId] = [
+                'entries' => $entries,
+                'aliases' => $aliases,
+                'strictness' => $configLexicon?->getStrictness() ?? Strictness::IGNORE
+            ];
+        }
+
+        return $this->configLexiconDetails[$appId];
+    }
+
+    /**
+     * get Lexicon Entry using appId and config key entry
+     *
+     * @return Entry|null NULL if entry does not exist in app's Lexicon
+     * @internal
+     */
+    public function getLexiconEntry(string $appId, string $key): ?Entry {
+        return $this->getConfigDetailsFromLexicon($appId)['entries'][$key] ?? null;
+    }
+
+    /**
+     * if set to TRUE, ignore aliases defined in Config Lexicon during the use of the methods of this class
+     *
+     * @internal
+     */
+    public function ignoreLexiconAliases(bool $ignore): void {
+        $this->ignoreLexiconAliases = $ignore;
+    }
+
+    /**
+     * Returns the installed versions of all apps
+     *
+     * @return array<string, string>
+     */
+    public function getAppInstalledVersions(bool $onlyEnabled = false): array {
+        if ($this->appVersionsCache === null) {
+            /** @var array<string, string> */
+            $this->appVersionsCache = $this->searchValues('installed_version', false, IAppConfig::VALUE_STRING);
+        }
+        if ($onlyEnabled) {
+            return array_filter(
+                $this->appVersionsCache,
+                fn (string $app): bool => $this->getValueString($app, 'enabled', 'no') !== 'no',
+                ARRAY_FILTER_USE_KEY
+            );
+        }
+        return $this->appVersionsCache;
+    }
+
+    private function clearLocalCache(): void {
+        $this->localCache?->remove(self::LOCAL_CACHE_KEY);
+    }
 }

lib/public/Config/IUserConfig.php

Indentation +713 added lines, -713 removed lines

@@ -30,717 +30,717 @@
  */
 #[Consumable(since: '32.0.0')]
 interface IUserConfig {
-	/**
-	 * @since 32.0.0
-	 */
-	public const FLAG_SENSITIVE = 1;   // value is sensitive
-	/**
-	 * @since 32.0.0
-	 */
-	public const FLAG_INDEXED = 2;    // value should be indexed
-	/**
-	 * @since 33.0.0
-	 */
-	public const FLAG_INTERNAL = 4;   // value is considered internal and can be hidden from listing
-
-	/**
-	 * Get list of all userIds with config stored in database.
-	 * If $appId is specified, will only limit the search to this value
-	 *
-	 * **WARNING:** ignore any cache and get data directly from database.
-	 *
-	 * @param string $appId optional id of app
-	 *
-	 * @return list<string> list of userIds
-	 *
-	 * @since 32.0.0
-	 */
-	public function getUserIds(string $appId = ''): array;
-
-	/**
-	 * Get list of all apps that have at least one config
-	 * value related to $userId stored in database
-	 *
-	 * **WARNING:** ignore lazy filtering, all user config are loaded from database
-	 *
-	 * @param string $userId id of the user
-	 *
-	 * @return list<string> list of app ids
-	 *
-	 * @since 32.0.0
-	 */
-	public function getApps(string $userId): array;
-
-	/**
-	 * Returns all keys stored in database, related to user+app.
-	 * Please note that the values are not returned.
-	 *
-	 * **WARNING:** ignore lazy filtering, all user config are loaded from database
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 *
-	 * @return list<string> list of stored config keys
-	 *
-	 * @since 32.0.0
-	 */
-	public function getKeys(string $userId, string $app): array;
-
-	/**
-	 * Check if a key exists in the list of stored config values.
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return bool TRUE if key exists
-	 *
-	 * @since 32.0.0
-	 */
-	public function hasKey(string $userId, string $app, string $key, ?bool $lazy = false): bool;
-
-	/**
-	 * best way to see if a value is set as sensitive (not displayed in report)
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool|null $lazy search within lazy loaded config
-	 *
-	 * @return bool TRUE if value is sensitive
-	 * @throws UnknownKeyException if config key is not known
-	 *
-	 * @since 32.0.0
-	 */
-	public function isSensitive(string $userId, string $app, string $key, ?bool $lazy = false): bool;
-
-	/**
-	 * best way to see if a value is set as indexed (so it can be search)
-	 *
-	 * @see self::searchUsersByValueString()
-	 * @see self::searchUsersByValueInt()
-	 * @see self::searchUsersByValueBool()
-	 * @see self::searchUsersByValues()
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool|null $lazy search within lazy loaded config
-	 *
-	 * @return bool TRUE if value is sensitive
-	 * @throws UnknownKeyException if config key is not known
-	 *
-	 * @since 32.0.0
-	 */
-	public function isIndexed(string $userId, string $app, string $key, ?bool $lazy = false): bool;
-
-	/**
-	 * Returns if the config key stored in database is lazy loaded
-	 *
-	 * **WARNING:** ignore lazy filtering, all config values are loaded from database
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 *
-	 * @return bool TRUE if config is lazy loaded
-	 * @throws UnknownKeyException if config key is not known
-	 * @see IUserConfig for details about lazy loading
-	 *
-	 * @since 32.0.0
-	 */
-	public function isLazy(string $userId, string $app, string $key): bool;
-
-	/**
-	 * List all config values from an app with config key starting with $key.
-	 * Returns an array with config key as key, stored value as value.
-	 *
-	 * **WARNING:** ignore lazy filtering, all config values are loaded from database
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $prefix config keys prefix to search, can be empty.
-	 * @param bool $filtered filter sensitive config values
-	 *
-	 * @return array<string, string|int|float|bool|array> [key => value]
-	 *
-	 * @since 32.0.0
-	 */
-	public function getValues(string $userId, string $app, string $prefix = '', bool $filtered = false): array;
-
-	/**
-	 * List all config values of a user.
-	 * Returns an array with config key as key, stored value as value.
-	 *
-	 * **WARNING:** ignore lazy filtering, all config values are loaded from database
-	 *
-	 * @param string $userId id of the user
-	 * @param bool $filtered filter sensitive config values
-	 *
-	 * @return array<string, string|int|float|bool|array> [key => value]
-	 *
-	 * @since 32.0.0
-	 */
-	public function getAllValues(string $userId, bool $filtered = false): array;
-
-	/**
-	 * List all apps storing a specific config key and its stored value.
-	 * Returns an array with appId as key, stored value as value.
-	 *
-	 * @param string $userId id of the user
-	 * @param string $key config key
-	 * @param bool $lazy search within lazy loaded config
-	 * @param ValueType|null $typedAs enforce type for the returned values
-	 *
-	 * @return array<string, string|int|float|bool|array> [appId => value]
-	 *
-	 * @since 32.0.0
-	 */
-	public function getValuesByApps(string $userId, string $key, bool $lazy = false, ?ValueType $typedAs = null): array;
-
-	/**
-	 * List all users storing a specific config key and its stored value.
-	 * Returns an array with userId as key, stored value as value.
-	 *
-	 * **WARNING:** no caching, generate a fresh request
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param ValueType|null $typedAs enforce type for the returned values
-	 * @param array|null $userIds limit the search to a list of user ids
-	 *
-	 * @return array<string, string|int|float|bool|array> [userId => value]
-	 *
-	 * @since 32.0.0
-	 */
-	public function getValuesByUsers(string $app, string $key, ?ValueType $typedAs = null, ?array $userIds = null): array;
-
-	/**
-	 * List all users storing a specific config key/value pair.
-	 * Returns a list of user ids.
-	 *
-	 * **WARNING:** no caching, generate a fresh request
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param string $value config value
-	 * @param bool $caseInsensitive non-case-sensitive search, only works if $value is a string
-	 *
-	 * @return Generator<string>
-	 *
-	 * @since 32.0.0
-	 */
-	public function searchUsersByValueString(string $app, string $key, string $value, bool $caseInsensitive = false): Generator;
-
-	/**
-	 * List all users storing a specific config key/value pair.
-	 * Returns a list of user ids.
-	 *
-	 * **WARNING:** no caching, generate a fresh request
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param int $value config value
-	 *
-	 * @return Generator<string>
-	 *
-	 * @since 32.0.0
-	 */
-	public function searchUsersByValueInt(string $app, string $key, int $value): Generator;
-
-	/**
-	 * List all users storing a specific config key/value pair.
-	 * Returns a list of user ids.
-	 *
-	 * **WARNING:** no caching, generate a fresh request
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param array $values list of possible config values
-	 *
-	 * @return Generator<string>
-	 *
-	 * @since 32.0.0
-	 */
-	public function searchUsersByValues(string $app, string $key, array $values): Generator;
-
-	/**
-	 * List all users storing a specific config key/value pair.
-	 * Returns a list of user ids.
-	 *
-	 * **WARNING:** no caching, generate a fresh request
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $value config value
-	 *
-	 * @return Generator<string>
-	 *
-	 * @since 32.0.0
-	 */
-	public function searchUsersByValueBool(string $app, string $key, bool $value): Generator;
-
-	/**
-	 * Get user config assigned to a config key.
-	 * If config key is not found in database, default value is returned.
-	 * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param string $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return string stored config value or $default if not set in database
-	 *
-	 * @since 32.0.0
-	 *
-	 * @see IUserConfig for explanation about lazy loading
-	 * @see getValueInt()
-	 * @see getValueFloat()
-	 * @see getValueBool()
-	 * @see getValueArray()
-	 */
-	public function getValueString(string $userId, string $app, string $key, string $default = '', bool $lazy = false): string;
-
-	/**
-	 * Get config value assigned to a config key.
-	 * If config key is not found in database, default value is returned.
-	 * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param int $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return int stored config value or $default if not set in database
-	 *
-	 * @since 32.0.0
-	 *
-	 * @see IUserConfig for explanation about lazy loading
-	 * @see getValueString()
-	 * @see getValueFloat()
-	 * @see getValueBool()
-	 * @see getValueArray()
-	 */
-	public function getValueInt(string $userId, string $app, string $key, int $default = 0, bool $lazy = false): int;
-
-	/**
-	 * Get config value assigned to a config key.
-	 * If config key is not found in database, default value is returned.
-	 * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param float $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return float stored config value or $default if not set in database
-	 *
-	 * @since 32.0.0
-	 *
-	 * @see IUserConfig for explanation about lazy loading
-	 * @see getValueString()
-	 * @see getValueInt()
-	 * @see getValueBool()
-	 * @see getValueArray()
-	 */
-	public function getValueFloat(string $userId, string $app, string $key, float $default = 0, bool $lazy = false): float;
-
-	/**
-	 * Get config value assigned to a config key.
-	 * If config key is not found in database, default value is returned.
-	 * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return bool stored config value or $default if not set in database
-	 *
-	 * @since 32.0.0
-	 *
-	 * @see IUserPrefences for explanation about lazy loading
-	 * @see getValueString()
-	 * @see getValueInt()
-	 * @see getValueFloat()
-	 * @see getValueArray()
-	 */
-	public function getValueBool(string $userId, string $app, string $key, bool $default = false, bool $lazy = false): bool;
-
-	/**
-	 * Get config value assigned to a config key.
-	 * If config key is not found in database, default value is returned.
-	 * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param array $default default value`
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return array stored config value or $default if not set in database
-	 *
-	 * @since 32.0.0
-	 *
-	 * @see IUserConfig for explanation about lazy loading
-	 * @see getValueString()
-	 * @see getValueInt()
-	 * @see getValueFloat()
-	 * @see getValueBool()
-	 */
-	public function getValueArray(string $userId, string $app, string $key, array $default = [], bool $lazy = false): array;
-
-	/**
-	 * returns the type of config value
-	 *
-	 * **WARNING:** ignore lazy filtering, all config values are loaded from database
-	 *              unless lazy is set to false
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool|null $lazy
-	 *
-	 * @return ValueType type of the value
-	 * @throws UnknownKeyException if config key is not known
-	 * @throws IncorrectTypeException if config value type is not known
-	 *
-	 * @since 32.0.0
-	 */
-	public function getValueType(string $userId, string $app, string $key, ?bool $lazy = null): ValueType;
-
-	/**
-	 * returns a bitflag related to config value
-	 *
-	 * **WARNING:** ignore lazy filtering, all config values are loaded from database
-	 *              unless lazy is set to false
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $lazy lazy loading
-	 *
-	 * @return int a bitflag in relation to the config value
-	 * @throws UnknownKeyException if config key is not known
-	 * @throws IncorrectTypeException if config value type is not known
-	 *
-	 * @since 32.0.0
-	 */
-	public function getValueFlags(string $userId, string $app, string $key, bool $lazy = false): int;
-
-	/**
-	 * Store a config key and its value in database
-	 *
-	 * If config key is already known with the exact same config value, the database is not updated.
-	 * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
-	 *
-	 * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param string $value config value
-	 * @param bool $sensitive if TRUE value will be hidden when listing config values.
-	 * @param bool $lazy set config as lazy loaded
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 *
-	 * @since 32.0.0
-	 *
-	 * @see IUserConfig for explanation about lazy loading
-	 * @see setValueInt()
-	 * @see setValueFloat()
-	 * @see setValueBool()
-	 * @see setValueArray()
-	 */
-	public function setValueString(string $userId, string $app, string $key, string $value, bool $lazy = false, int $flags = 0): bool;
-
-	/**
-	 * Store a config key and its value in database
-	 *
-	 * When handling huge value around and/or above 2,147,483,647, a debug log will be generated
-	 * on 64bits system, as php int type reach its limit (and throw an exception) on 32bits when using huge numbers.
-	 *
-	 * When using huge numbers, it is advised to use {@see \OCP\Util::numericToNumber()} and {@see setValueString()}
-	 *
-	 * If config key is already known with the exact same config value, the database is not updated.
-	 * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
-	 *
-	 * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param int $value config value
-	 * @param bool $sensitive if TRUE value will be hidden when listing config values.
-	 * @param bool $lazy set config as lazy loaded
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 *
-	 * @since 32.0.0
-	 *
-	 * @see IUserConfig for explanation about lazy loading
-	 * @see setValueString()
-	 * @see setValueFloat()
-	 * @see setValueBool()
-	 * @see setValueArray()
-	 */
-	public function setValueInt(string $userId, string $app, string $key, int $value, bool $lazy = false, int $flags = 0): bool;
-
-	/**
-	 * Store a config key and its value in database.
-	 *
-	 * If config key is already known with the exact same config value, the database is not updated.
-	 * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
-	 *
-	 * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param float $value config value
-	 * @param bool $sensitive if TRUE value will be hidden when listing config values.
-	 * @param bool $lazy set config as lazy loaded
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 *
-	 * @since 32.0.0
-	 *
-	 * @see IUserConfig for explanation about lazy loading
-	 * @see setValueString()
-	 * @see setValueInt()
-	 * @see setValueBool()
-	 * @see setValueArray()
-	 */
-	public function setValueFloat(string $userId, string $app, string $key, float $value, bool $lazy = false, int $flags = 0): bool;
-
-	/**
-	 * Store a config key and its value in database
-	 *
-	 * If config key is already known with the exact same config value, the database is not updated.
-	 * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
-	 *
-	 * If config value was previously stored as lazy loaded, status cannot be altered without using {@see deleteKey()} first
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $value config value
-	 * @param bool $lazy set config as lazy loaded
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 *
-	 * @since 32.0.0
-	 *
-	 * @see IUserConfig for explanation about lazy loading
-	 * @see setValueString()
-	 * @see setValueInt()
-	 * @see setValueFloat()
-	 * @see setValueArray()
-	 */
-	public function setValueBool(string $userId, string $app, string $key, bool $value, bool $lazy = false): bool;
-
-	/**
-	 * Store a config key and its value in database
-	 *
-	 * If config key is already known with the exact same config value, the database is not updated.
-	 * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
-	 *
-	 * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param array $value config value
-	 * @param bool $sensitive if TRUE value will be hidden when listing config values.
-	 * @param bool $lazy set config as lazy loaded
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 *
-	 * @since 32.0.0
-	 *
-	 * @see IUserConfig for explanation about lazy loading
-	 * @see setValueString()
-	 * @see setValueInt()
-	 * @see setValueFloat()
-	 * @see setValueBool()
-	 */
-	public function setValueArray(string $userId, string $app, string $key, array $value, bool $lazy = false, int $flags = 0): bool;
-
-	/**
-	 * switch sensitive status of a config value
-	 *
-	 * **WARNING:** ignore lazy filtering, all config values are loaded from database
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $sensitive TRUE to set as sensitive, FALSE to unset
-	 *
-	 * @return bool TRUE if database update were necessary
-	 *
-	 * @since 32.0.0
-	 */
-	public function updateSensitive(string $userId, string $app, string $key, bool $sensitive): bool;
-
-	/**
-	 * switch sensitive loading status of a config key for all users
-	 *
-	 * **Warning:** heavy on resources, MUST only be used on occ command or migrations
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $sensitive TRUE to set as sensitive, FALSE to unset
-	 *
-	 * @since 32.0.0
-	 */
-	public function updateGlobalSensitive(string $app, string $key, bool $sensitive): void;
-
-
-	/**
-	 * switch indexed status of a config value
-	 *
-	 *  **WARNING:** ignore lazy filtering, all config values are loaded from database
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $indexed TRUE to set as indexed, FALSE to unset
-	 *
-	 * @return bool TRUE if database update were necessary
-	 *
-	 * @since 32.0.0
-	 */
-	public function updateIndexed(string $userId, string $app, string $key, bool $indexed): bool;
-
-	/**
-	 * switch sensitive loading status of a config key for all users
-	 *
-	 * **Warning:** heavy on resources, MUST only be used on occ command or migrations
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $indexed TRUE to set as indexed, FALSE to unset
-	 *
-	 * @since 32.0.0
-	 */
-	public function updateGlobalIndexed(string $app, string $key, bool $indexed): void;
-
-	/**
-	 * switch lazy loading status of a config value
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $lazy TRUE to set as lazy loaded, FALSE to unset
-	 *
-	 * @return bool TRUE if database update was necessary
-	 *
-	 * @since 32.0.0
-	 */
-	public function updateLazy(string $userId, string $app, string $key, bool $lazy): bool;
-
-	/**
-	 * switch lazy loading status of a config key for all users
-	 *
-	 * **Warning:** heavy on resources, MUST only be used on occ command or migrations
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $lazy TRUE to set as lazy loaded, FALSE to unset
-	 *
-	 * @since 32.0.0
-	 */
-	public function updateGlobalLazy(string $app, string $key, bool $lazy): void;
-
-	/**
-	 * returns an array contains details about a config value
-	 *
-	 * ```
-	 * [
-	 *   "app" => "myapp",
-	 *   "key" => "mykey",
-	 *   "value" => "its_value",
-	 *   "lazy" => false,
-	 *   "type" => 4,
-	 *   "typeString" => "string",
-	 *   'sensitive' => true
-	 * ]
-	 * ```
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 *
-	 * @return array
-	 * @throws UnknownKeyException if config key is not known in database
-	 *
-	 * @since 32.0.0
-	 */
-	public function getDetails(string $userId, string $app, string $key): array;
-
-	/**
-	 * Delete single config key from database.
-	 *
-	 * @param string $userId id of the user
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 *
-	 * @since 32.0.0
-	 */
-	public function deleteUserConfig(string $userId, string $app, string $key): void;
-
-	/**
-	 * Delete config values from all users linked to a specific config keys
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 *
-	 * @since 32.0.0
-	 */
-	public function deleteKey(string $app, string $key): void;
-
-	/**
-	 * delete all config keys linked to an app
-	 *
-	 * @param string $app id of the app
-	 *
-	 * @since 32.0.0
-	 */
-	public function deleteApp(string $app): void;
-
-	/**
-	 * delete all config keys linked to a user
-	 *
-	 * @param string $userId id of the user
-	 *
-	 * @since 32.0.0
-	 */
-	public function deleteAllUserConfig(string $userId): void;
-
-	/**
-	 * Clear the cache for a single user
-	 *
-	 * The cache will be rebuilt only the next time a user config is requested.
-	 *
-	 * @param string $userId id of the user
-	 * @param bool $reload set to TRUE to refill cache instantly after clearing it
-	 *
-	 * @since 32.0.0
-	 */
-	public function clearCache(string $userId, bool $reload = false): void;
-
-	/**
-	 * Clear the cache for all users.
-	 * The cache will be rebuilt only the next time a user config is requested.
-	 *
-	 * @since 32.0.0
-	 */
-	public function clearCacheAll(): void;
+    /**
+     * @since 32.0.0
+     */
+    public const FLAG_SENSITIVE = 1;   // value is sensitive
+    /**
+     * @since 32.0.0
+     */
+    public const FLAG_INDEXED = 2;    // value should be indexed
+    /**
+     * @since 33.0.0
+     */
+    public const FLAG_INTERNAL = 4;   // value is considered internal and can be hidden from listing
+
+    /**
+     * Get list of all userIds with config stored in database.
+     * If $appId is specified, will only limit the search to this value
+     *
+     * **WARNING:** ignore any cache and get data directly from database.
+     *
+     * @param string $appId optional id of app
+     *
+     * @return list<string> list of userIds
+     *
+     * @since 32.0.0
+     */
+    public function getUserIds(string $appId = ''): array;
+
+    /**
+     * Get list of all apps that have at least one config
+     * value related to $userId stored in database
+     *
+     * **WARNING:** ignore lazy filtering, all user config are loaded from database
+     *
+     * @param string $userId id of the user
+     *
+     * @return list<string> list of app ids
+     *
+     * @since 32.0.0
+     */
+    public function getApps(string $userId): array;
+
+    /**
+     * Returns all keys stored in database, related to user+app.
+     * Please note that the values are not returned.
+     *
+     * **WARNING:** ignore lazy filtering, all user config are loaded from database
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     *
+     * @return list<string> list of stored config keys
+     *
+     * @since 32.0.0
+     */
+    public function getKeys(string $userId, string $app): array;
+
+    /**
+     * Check if a key exists in the list of stored config values.
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return bool TRUE if key exists
+     *
+     * @since 32.0.0
+     */
+    public function hasKey(string $userId, string $app, string $key, ?bool $lazy = false): bool;
+
+    /**
+     * best way to see if a value is set as sensitive (not displayed in report)
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool|null $lazy search within lazy loaded config
+     *
+     * @return bool TRUE if value is sensitive
+     * @throws UnknownKeyException if config key is not known
+     *
+     * @since 32.0.0
+     */
+    public function isSensitive(string $userId, string $app, string $key, ?bool $lazy = false): bool;
+
+    /**
+     * best way to see if a value is set as indexed (so it can be search)
+     *
+     * @see self::searchUsersByValueString()
+     * @see self::searchUsersByValueInt()
+     * @see self::searchUsersByValueBool()
+     * @see self::searchUsersByValues()
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool|null $lazy search within lazy loaded config
+     *
+     * @return bool TRUE if value is sensitive
+     * @throws UnknownKeyException if config key is not known
+     *
+     * @since 32.0.0
+     */
+    public function isIndexed(string $userId, string $app, string $key, ?bool $lazy = false): bool;
+
+    /**
+     * Returns if the config key stored in database is lazy loaded
+     *
+     * **WARNING:** ignore lazy filtering, all config values are loaded from database
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     *
+     * @return bool TRUE if config is lazy loaded
+     * @throws UnknownKeyException if config key is not known
+     * @see IUserConfig for details about lazy loading
+     *
+     * @since 32.0.0
+     */
+    public function isLazy(string $userId, string $app, string $key): bool;
+
+    /**
+     * List all config values from an app with config key starting with $key.
+     * Returns an array with config key as key, stored value as value.
+     *
+     * **WARNING:** ignore lazy filtering, all config values are loaded from database
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $prefix config keys prefix to search, can be empty.
+     * @param bool $filtered filter sensitive config values
+     *
+     * @return array<string, string|int|float|bool|array> [key => value]
+     *
+     * @since 32.0.0
+     */
+    public function getValues(string $userId, string $app, string $prefix = '', bool $filtered = false): array;
+
+    /**
+     * List all config values of a user.
+     * Returns an array with config key as key, stored value as value.
+     *
+     * **WARNING:** ignore lazy filtering, all config values are loaded from database
+     *
+     * @param string $userId id of the user
+     * @param bool $filtered filter sensitive config values
+     *
+     * @return array<string, string|int|float|bool|array> [key => value]
+     *
+     * @since 32.0.0
+     */
+    public function getAllValues(string $userId, bool $filtered = false): array;
+
+    /**
+     * List all apps storing a specific config key and its stored value.
+     * Returns an array with appId as key, stored value as value.
+     *
+     * @param string $userId id of the user
+     * @param string $key config key
+     * @param bool $lazy search within lazy loaded config
+     * @param ValueType|null $typedAs enforce type for the returned values
+     *
+     * @return array<string, string|int|float|bool|array> [appId => value]
+     *
+     * @since 32.0.0
+     */
+    public function getValuesByApps(string $userId, string $key, bool $lazy = false, ?ValueType $typedAs = null): array;
+
+    /**
+     * List all users storing a specific config key and its stored value.
+     * Returns an array with userId as key, stored value as value.
+     *
+     * **WARNING:** no caching, generate a fresh request
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param ValueType|null $typedAs enforce type for the returned values
+     * @param array|null $userIds limit the search to a list of user ids
+     *
+     * @return array<string, string|int|float|bool|array> [userId => value]
+     *
+     * @since 32.0.0
+     */
+    public function getValuesByUsers(string $app, string $key, ?ValueType $typedAs = null, ?array $userIds = null): array;
+
+    /**
+     * List all users storing a specific config key/value pair.
+     * Returns a list of user ids.
+     *
+     * **WARNING:** no caching, generate a fresh request
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param string $value config value
+     * @param bool $caseInsensitive non-case-sensitive search, only works if $value is a string
+     *
+     * @return Generator<string>
+     *
+     * @since 32.0.0
+     */
+    public function searchUsersByValueString(string $app, string $key, string $value, bool $caseInsensitive = false): Generator;
+
+    /**
+     * List all users storing a specific config key/value pair.
+     * Returns a list of user ids.
+     *
+     * **WARNING:** no caching, generate a fresh request
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param int $value config value
+     *
+     * @return Generator<string>
+     *
+     * @since 32.0.0
+     */
+    public function searchUsersByValueInt(string $app, string $key, int $value): Generator;
+
+    /**
+     * List all users storing a specific config key/value pair.
+     * Returns a list of user ids.
+     *
+     * **WARNING:** no caching, generate a fresh request
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param array $values list of possible config values
+     *
+     * @return Generator<string>
+     *
+     * @since 32.0.0
+     */
+    public function searchUsersByValues(string $app, string $key, array $values): Generator;
+
+    /**
+     * List all users storing a specific config key/value pair.
+     * Returns a list of user ids.
+     *
+     * **WARNING:** no caching, generate a fresh request
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $value config value
+     *
+     * @return Generator<string>
+     *
+     * @since 32.0.0
+     */
+    public function searchUsersByValueBool(string $app, string $key, bool $value): Generator;
+
+    /**
+     * Get user config assigned to a config key.
+     * If config key is not found in database, default value is returned.
+     * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param string $default default value
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return string stored config value or $default if not set in database
+     *
+     * @since 32.0.0
+     *
+     * @see IUserConfig for explanation about lazy loading
+     * @see getValueInt()
+     * @see getValueFloat()
+     * @see getValueBool()
+     * @see getValueArray()
+     */
+    public function getValueString(string $userId, string $app, string $key, string $default = '', bool $lazy = false): string;
+
+    /**
+     * Get config value assigned to a config key.
+     * If config key is not found in database, default value is returned.
+     * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param int $default default value
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return int stored config value or $default if not set in database
+     *
+     * @since 32.0.0
+     *
+     * @see IUserConfig for explanation about lazy loading
+     * @see getValueString()
+     * @see getValueFloat()
+     * @see getValueBool()
+     * @see getValueArray()
+     */
+    public function getValueInt(string $userId, string $app, string $key, int $default = 0, bool $lazy = false): int;
+
+    /**
+     * Get config value assigned to a config key.
+     * If config key is not found in database, default value is returned.
+     * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param float $default default value
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return float stored config value or $default if not set in database
+     *
+     * @since 32.0.0
+     *
+     * @see IUserConfig for explanation about lazy loading
+     * @see getValueString()
+     * @see getValueInt()
+     * @see getValueBool()
+     * @see getValueArray()
+     */
+    public function getValueFloat(string $userId, string $app, string $key, float $default = 0, bool $lazy = false): float;
+
+    /**
+     * Get config value assigned to a config key.
+     * If config key is not found in database, default value is returned.
+     * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $default default value
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return bool stored config value or $default if not set in database
+     *
+     * @since 32.0.0
+     *
+     * @see IUserPrefences for explanation about lazy loading
+     * @see getValueString()
+     * @see getValueInt()
+     * @see getValueFloat()
+     * @see getValueArray()
+     */
+    public function getValueBool(string $userId, string $app, string $key, bool $default = false, bool $lazy = false): bool;
+
+    /**
+     * Get config value assigned to a config key.
+     * If config key is not found in database, default value is returned.
+     * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param array $default default value`
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return array stored config value or $default if not set in database
+     *
+     * @since 32.0.0
+     *
+     * @see IUserConfig for explanation about lazy loading
+     * @see getValueString()
+     * @see getValueInt()
+     * @see getValueFloat()
+     * @see getValueBool()
+     */
+    public function getValueArray(string $userId, string $app, string $key, array $default = [], bool $lazy = false): array;
+
+    /**
+     * returns the type of config value
+     *
+     * **WARNING:** ignore lazy filtering, all config values are loaded from database
+     *              unless lazy is set to false
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool|null $lazy
+     *
+     * @return ValueType type of the value
+     * @throws UnknownKeyException if config key is not known
+     * @throws IncorrectTypeException if config value type is not known
+     *
+     * @since 32.0.0
+     */
+    public function getValueType(string $userId, string $app, string $key, ?bool $lazy = null): ValueType;
+
+    /**
+     * returns a bitflag related to config value
+     *
+     * **WARNING:** ignore lazy filtering, all config values are loaded from database
+     *              unless lazy is set to false
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $lazy lazy loading
+     *
+     * @return int a bitflag in relation to the config value
+     * @throws UnknownKeyException if config key is not known
+     * @throws IncorrectTypeException if config value type is not known
+     *
+     * @since 32.0.0
+     */
+    public function getValueFlags(string $userId, string $app, string $key, bool $lazy = false): int;
+
+    /**
+     * Store a config key and its value in database
+     *
+     * If config key is already known with the exact same config value, the database is not updated.
+     * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
+     *
+     * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param string $value config value
+     * @param bool $sensitive if TRUE value will be hidden when listing config values.
+     * @param bool $lazy set config as lazy loaded
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     *
+     * @since 32.0.0
+     *
+     * @see IUserConfig for explanation about lazy loading
+     * @see setValueInt()
+     * @see setValueFloat()
+     * @see setValueBool()
+     * @see setValueArray()
+     */
+    public function setValueString(string $userId, string $app, string $key, string $value, bool $lazy = false, int $flags = 0): bool;
+
+    /**
+     * Store a config key and its value in database
+     *
+     * When handling huge value around and/or above 2,147,483,647, a debug log will be generated
+     * on 64bits system, as php int type reach its limit (and throw an exception) on 32bits when using huge numbers.
+     *
+     * When using huge numbers, it is advised to use {@see \OCP\Util::numericToNumber()} and {@see setValueString()}
+     *
+     * If config key is already known with the exact same config value, the database is not updated.
+     * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
+     *
+     * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param int $value config value
+     * @param bool $sensitive if TRUE value will be hidden when listing config values.
+     * @param bool $lazy set config as lazy loaded
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     *
+     * @since 32.0.0
+     *
+     * @see IUserConfig for explanation about lazy loading
+     * @see setValueString()
+     * @see setValueFloat()
+     * @see setValueBool()
+     * @see setValueArray()
+     */
+    public function setValueInt(string $userId, string $app, string $key, int $value, bool $lazy = false, int $flags = 0): bool;
+
+    /**
+     * Store a config key and its value in database.
+     *
+     * If config key is already known with the exact same config value, the database is not updated.
+     * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
+     *
+     * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param float $value config value
+     * @param bool $sensitive if TRUE value will be hidden when listing config values.
+     * @param bool $lazy set config as lazy loaded
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     *
+     * @since 32.0.0
+     *
+     * @see IUserConfig for explanation about lazy loading
+     * @see setValueString()
+     * @see setValueInt()
+     * @see setValueBool()
+     * @see setValueArray()
+     */
+    public function setValueFloat(string $userId, string $app, string $key, float $value, bool $lazy = false, int $flags = 0): bool;
+
+    /**
+     * Store a config key and its value in database
+     *
+     * If config key is already known with the exact same config value, the database is not updated.
+     * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
+     *
+     * If config value was previously stored as lazy loaded, status cannot be altered without using {@see deleteKey()} first
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $value config value
+     * @param bool $lazy set config as lazy loaded
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     *
+     * @since 32.0.0
+     *
+     * @see IUserConfig for explanation about lazy loading
+     * @see setValueString()
+     * @see setValueInt()
+     * @see setValueFloat()
+     * @see setValueArray()
+     */
+    public function setValueBool(string $userId, string $app, string $key, bool $value, bool $lazy = false): bool;
+
+    /**
+     * Store a config key and its value in database
+     *
+     * If config key is already known with the exact same config value, the database is not updated.
+     * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
+     *
+     * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param array $value config value
+     * @param bool $sensitive if TRUE value will be hidden when listing config values.
+     * @param bool $lazy set config as lazy loaded
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     *
+     * @since 32.0.0
+     *
+     * @see IUserConfig for explanation about lazy loading
+     * @see setValueString()
+     * @see setValueInt()
+     * @see setValueFloat()
+     * @see setValueBool()
+     */
+    public function setValueArray(string $userId, string $app, string $key, array $value, bool $lazy = false, int $flags = 0): bool;
+
+    /**
+     * switch sensitive status of a config value
+     *
+     * **WARNING:** ignore lazy filtering, all config values are loaded from database
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $sensitive TRUE to set as sensitive, FALSE to unset
+     *
+     * @return bool TRUE if database update were necessary
+     *
+     * @since 32.0.0
+     */
+    public function updateSensitive(string $userId, string $app, string $key, bool $sensitive): bool;
+
+    /**
+     * switch sensitive loading status of a config key for all users
+     *
+     * **Warning:** heavy on resources, MUST only be used on occ command or migrations
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $sensitive TRUE to set as sensitive, FALSE to unset
+     *
+     * @since 32.0.0
+     */
+    public function updateGlobalSensitive(string $app, string $key, bool $sensitive): void;
+
+
+    /**
+     * switch indexed status of a config value
+     *
+     *  **WARNING:** ignore lazy filtering, all config values are loaded from database
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $indexed TRUE to set as indexed, FALSE to unset
+     *
+     * @return bool TRUE if database update were necessary
+     *
+     * @since 32.0.0
+     */
+    public function updateIndexed(string $userId, string $app, string $key, bool $indexed): bool;
+
+    /**
+     * switch sensitive loading status of a config key for all users
+     *
+     * **Warning:** heavy on resources, MUST only be used on occ command or migrations
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $indexed TRUE to set as indexed, FALSE to unset
+     *
+     * @since 32.0.0
+     */
+    public function updateGlobalIndexed(string $app, string $key, bool $indexed): void;
+
+    /**
+     * switch lazy loading status of a config value
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $lazy TRUE to set as lazy loaded, FALSE to unset
+     *
+     * @return bool TRUE if database update was necessary
+     *
+     * @since 32.0.0
+     */
+    public function updateLazy(string $userId, string $app, string $key, bool $lazy): bool;
+
+    /**
+     * switch lazy loading status of a config key for all users
+     *
+     * **Warning:** heavy on resources, MUST only be used on occ command or migrations
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $lazy TRUE to set as lazy loaded, FALSE to unset
+     *
+     * @since 32.0.0
+     */
+    public function updateGlobalLazy(string $app, string $key, bool $lazy): void;
+
+    /**
+     * returns an array contains details about a config value
+     *
+     * ```
+     * [
+     *   "app" => "myapp",
+     *   "key" => "mykey",
+     *   "value" => "its_value",
+     *   "lazy" => false,
+     *   "type" => 4,
+     *   "typeString" => "string",
+     *   'sensitive' => true
+     * ]
+     * ```
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     *
+     * @return array
+     * @throws UnknownKeyException if config key is not known in database
+     *
+     * @since 32.0.0
+     */
+    public function getDetails(string $userId, string $app, string $key): array;
+
+    /**
+     * Delete single config key from database.
+     *
+     * @param string $userId id of the user
+     * @param string $app id of the app
+     * @param string $key config key
+     *
+     * @since 32.0.0
+     */
+    public function deleteUserConfig(string $userId, string $app, string $key): void;
+
+    /**
+     * Delete config values from all users linked to a specific config keys
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     *
+     * @since 32.0.0
+     */
+    public function deleteKey(string $app, string $key): void;
+
+    /**
+     * delete all config keys linked to an app
+     *
+     * @param string $app id of the app
+     *
+     * @since 32.0.0
+     */
+    public function deleteApp(string $app): void;
+
+    /**
+     * delete all config keys linked to a user
+     *
+     * @param string $userId id of the user
+     *
+     * @since 32.0.0
+     */
+    public function deleteAllUserConfig(string $userId): void;
+
+    /**
+     * Clear the cache for a single user
+     *
+     * The cache will be rebuilt only the next time a user config is requested.
+     *
+     * @param string $userId id of the user
+     * @param bool $reload set to TRUE to refill cache instantly after clearing it
+     *
+     * @since 32.0.0
+     */
+    public function clearCache(string $userId, bool $reload = false): void;
+
+    /**
+     * Clear the cache for all users.
+     * The cache will be rebuilt only the next time a user config is requested.
+     *
+     * @since 32.0.0
+     */
+    public function clearCacheAll(): void;
 }

Spacing +3 added lines, -3 removed lines

@@ -33,15 +33,15 @@
 	/**
 	 * @since 32.0.0
 	 */
-	public const FLAG_SENSITIVE = 1;   // value is sensitive
+	public const FLAG_SENSITIVE = 1; // value is sensitive
 	/**
 	 * @since 32.0.0
 	 */
-	public const FLAG_INDEXED = 2;    // value should be indexed
+	public const FLAG_INDEXED = 2; // value should be indexed
 	/**
 	 * @since 33.0.0
 	 */
-	public const FLAG_INTERNAL = 4;   // value is considered internal and can be hidden from listing
+	public const FLAG_INTERNAL = 4; // value is considered internal and can be hidden from listing
 
 	/**
 	 * Get list of all userIds with config stored in database.

lib/public/IAppConfig.php

Indentation +530 added lines, -530 removed lines

@@ -31,534 +31,534 @@
  * @since 29.0.0 - Supporting types and lazy loading
  */
 interface IAppConfig {
-	/** @since 29.0.0 */
-	public const VALUE_SENSITIVE = 1;
-	/** @since 29.0.0 */
-	public const VALUE_MIXED = 2;
-	/** @since 29.0.0 */
-	public const VALUE_STRING = 4;
-	/** @since 29.0.0 */
-	public const VALUE_INT = 8;
-	/** @since 29.0.0 */
-	public const VALUE_FLOAT = 16;
-	/** @since 29.0.0 */
-	public const VALUE_BOOL = 32;
-	/** @since 29.0.0 */
-	public const VALUE_ARRAY = 64;
-
-	/** @since 31.0.0 */
-	public const FLAG_SENSITIVE = 1;   // value is sensitive
-	/**
-	 * @since 33.0.0
-	 */
-	public const FLAG_INTERNAL = 4;   // value is considered internal and can be hidden from listing
-
-	/**
-	 * Get list of all apps that have at least one config value stored in database
-	 *
-	 * **WARNING:** ignore lazy filtering, all config values are loaded from database
-	 *
-	 * @return list<string> list of app ids
-	 * @since 7.0.0
-	 */
-	public function getApps(): array;
-
-	/**
-	 * Returns all keys stored in database, related to an app.
-	 * Please note that the values are not returned.
-	 *
-	 * **WARNING:** ignore lazy filtering, all config values are loaded from database
-	 *
-	 * @param string $app id of the app
-	 * @return list<string> list of stored config keys
-	 * @see searchKeys to avoid loading lazy config keys
-	 *
-	 * @since 29.0.0
-	 */
-	public function getKeys(string $app): array;
-
-	/**
-	 * Returns list of keys stored in database, related to an app.
-	 * Please note that the values are not returned.
-	 *
-	 * @param string $app id of the app
-	 * @param string $prefix returns only keys starting with this value
-	 * @param bool $lazy TRUE to search in lazy config keys
-	 *
-	 * @return list<string> list of stored config keys
-	 * @since 32.0.0
-	 */
-	public function searchKeys(string $app, string $prefix = '', bool $lazy = false): array;
-
-	/**
-	 * Check if a key exists in the list of stored config values.
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return bool TRUE if key exists
-	 * @since 29.0.0 Added the $lazy argument
-	 * @since 7.0.0
-	 */
-	public function hasKey(string $app, string $key, ?bool $lazy = false): bool;
-
-	/**
-	 * best way to see if a value is set as sensitive (not displayed in report)
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool|null $lazy search within lazy loaded config
-	 *
-	 * @return bool TRUE if value is sensitive
-	 * @throws AppConfigUnknownKeyException if config key is not known
-	 * @since 29.0.0
-	 */
-	public function isSensitive(string $app, string $key, ?bool $lazy = false): bool;
-
-	/**
-	 * Returns if the config key stored in database is lazy loaded
-	 *
-	 * **WARNING:** ignore lazy filtering, all config values are loaded from database
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 *
-	 * @return bool TRUE if config is lazy loaded
-	 * @throws AppConfigUnknownKeyException if config key is not known
-	 * @see IAppConfig for details about lazy loading
-	 * @since 29.0.0
-	 */
-	public function isLazy(string $app, string $key): bool;
-
-	/**
-	 * List all config values from an app with config key starting with $key.
-	 * Returns an array with config key as key, stored value as value.
-	 *
-	 * **WARNING:** ignore lazy filtering, all config values are loaded from database
-	 *
-	 * @param string $app id of the app
-	 * @param string $prefix config keys prefix to search, can be empty.
-	 * @param bool $filtered filter sensitive config values
-	 *
-	 * @return array<string, string|int|float|bool|array> [configKey => configValue]
-	 * @since 29.0.0
-	 */
-	public function getAllValues(string $app, string $prefix = '', bool $filtered = false): array;
-
-	/**
-	 * List all apps storing a specific config key and its stored value.
-	 * Returns an array with appId as key, stored value as value.
-	 *
-	 * @param string $key config key
-	 * @param bool $lazy search within lazy loaded config
-	 * @param int|null $typedAs enforce type for the returned values {@see self::VALUE_STRING} and others
-	 *
-	 * @return array<string, string|int|float|bool|array> [appId => configValue]
-	 * @since 29.0.0
-	 */
-	public function searchValues(string $key, bool $lazy = false, ?int $typedAs = null): array;
-
-	/**
-	 * Get config value assigned to a config key.
-	 * If config key is not found in database, default value is returned.
-	 * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param string $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return string stored config value or $default if not set in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 * @see getValueInt()
-	 * @see getValueFloat()
-	 * @see getValueBool()
-	 * @see getValueArray()
-	 */
-	public function getValueString(string $app, string $key, string $default = '', bool $lazy = false): string;
-
-	/**
-	 * Get config value assigned to a config key.
-	 * If config key is not found in database, default value is returned.
-	 * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param int $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return int stored config value or $default if not set in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 * @see getValueString()
-	 * @see getValueFloat()
-	 * @see getValueBool()
-	 * @see getValueArray()
-	 */
-	public function getValueInt(string $app, string $key, int $default = 0, bool $lazy = false): int;
-
-	/**
-	 * Get config value assigned to a config key.
-	 * If config key is not found in database, default value is returned.
-	 * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param float $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return float stored config value or $default if not set in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 * @see getValueString()
-	 * @see getValueInt()
-	 * @see getValueBool()
-	 * @see getValueArray()
-	 */
-	public function getValueFloat(string $app, string $key, float $default = 0, bool $lazy = false): float;
-
-	/**
-	 * Get config value assigned to a config key.
-	 * If config key is not found in database, default value is returned.
-	 * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return bool stored config value or $default if not set in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 * @see getValueString()
-	 * @see getValueInt()
-	 * @see getValueFloat()
-	 * @see getValueArray()
-	 */
-	public function getValueBool(string $app, string $key, bool $default = false, bool $lazy = false): bool;
-
-	/**
-	 * Get config value assigned to a config key.
-	 * If config key is not found in database, default value is returned.
-	 * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param array $default default value
-	 * @param bool $lazy search within lazy loaded config
-	 *
-	 * @return array stored config value or $default if not set in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 * @see getValueString()
-	 * @see getValueInt()
-	 * @see getValueFloat()
-	 * @see getValueBool()
-	 */
-	public function getValueArray(string $app, string $key, array $default = [], bool $lazy = false): array;
-
-	/**
-	 * returns the type of config value
-	 *
-	 * **WARNING:** ignore lazy filtering, all config values are loaded from database
-	 *              unless lazy is set to false
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool|null $lazy
-	 *
-	 * @return int
-	 * @throws AppConfigUnknownKeyException
-	 * @since 29.0.0
-	 * @see VALUE_STRING
-	 * @see VALUE_INT
-	 * @see VALUE_FLOAT
-	 * @see VALUE_BOOL
-	 * @see VALUE_ARRAY
-	 */
-	public function getValueType(string $app, string $key, ?bool $lazy = null): int;
-
-	/**
-	 * Store a config key and its value in database
-	 *
-	 * If config key is already known with the exact same config value, the database is not updated.
-	 * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
-	 *
-	 * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param string $value config value
-	 * @param bool $sensitive if TRUE value will be hidden when listing config values.
-	 * @param bool $lazy set config as lazy loaded
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 * @see setValueInt()
-	 * @see setValueFloat()
-	 * @see setValueBool()
-	 * @see setValueArray()
-	 */
-	public function setValueString(string $app, string $key, string $value, bool $lazy = false, bool $sensitive = false): bool;
-
-	/**
-	 * Store a config key and its value in database
-	 *
-	 * When handling huge value around and/or above 2,147,483,647, a debug log will be generated
-	 * on 64bits system, as php int type reach its limit (and throw an exception) on 32bits when using huge numbers.
-	 *
-	 * When using huge numbers, it is advised to use {@see \OCP\Util::numericToNumber()} and {@see setValueString()}
-	 *
-	 * If config key is already known with the exact same config value, the database is not updated.
-	 * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
-	 *
-	 * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param int $value config value
-	 * @param bool $sensitive if TRUE value will be hidden when listing config values.
-	 * @param bool $lazy set config as lazy loaded
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 * @see setValueString()
-	 * @see setValueFloat()
-	 * @see setValueBool()
-	 * @see setValueArray()
-	 */
-	public function setValueInt(string $app, string $key, int $value, bool $lazy = false, bool $sensitive = false): bool;
-
-	/**
-	 * Store a config key and its value in database.
-	 *
-	 * If config key is already known with the exact same config value, the database is not updated.
-	 * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
-	 *
-	 * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param float $value config value
-	 * @param bool $sensitive if TRUE value will be hidden when listing config values.
-	 * @param bool $lazy set config as lazy loaded
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 * @see setValueString()
-	 * @see setValueInt()
-	 * @see setValueBool()
-	 * @see setValueArray()
-	 */
-	public function setValueFloat(string $app, string $key, float $value, bool $lazy = false, bool $sensitive = false): bool;
-
-	/**
-	 * Store a config key and its value in database
-	 *
-	 * If config key is already known with the exact same config value, the database is not updated.
-	 * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
-	 *
-	 * If config value was previously stored as lazy loaded, status cannot be altered without using {@see deleteKey()} first
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $value config value
-	 * @param bool $lazy set config as lazy loaded
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 * @see setValueString()
-	 * @see setValueInt()
-	 * @see setValueFloat()
-	 * @see setValueArray()
-	 */
-	public function setValueBool(string $app, string $key, bool $value, bool $lazy = false): bool;
-
-	/**
-	 * Store a config key and its value in database
-	 *
-	 * If config key is already known with the exact same config value, the database is not updated.
-	 * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
-	 *
-	 * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param array $value config value
-	 * @param bool $sensitive if TRUE value will be hidden when listing config values.
-	 * @param bool $lazy set config as lazy loaded
-	 *
-	 * @return bool TRUE if value was different, therefor updated in database
-	 * @since 29.0.0
-	 * @see IAppConfig for explanation about lazy loading
-	 * @see setValueString()
-	 * @see setValueInt()
-	 * @see setValueFloat()
-	 * @see setValueBool()
-	 */
-	public function setValueArray(string $app, string $key, array $value, bool $lazy = false, bool $sensitive = false): bool;
-
-	/**
-	 * switch sensitive status of a config value
-	 *
-	 * **WARNING:** ignore lazy filtering, all config values are loaded from database
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $sensitive TRUE to set as sensitive, FALSE to unset
-	 *
-	 * @return bool TRUE if database update were necessary
-	 * @since 29.0.0
-	 */
-	public function updateSensitive(string $app, string $key, bool $sensitive): bool;
-
-	/**
-	 * switch lazy loading status of a config value
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @param bool $lazy TRUE to set as lazy loaded, FALSE to unset
-	 *
-	 * @return bool TRUE if database update was necessary
-	 * @since 29.0.0
-	 */
-	public function updateLazy(string $app, string $key, bool $lazy): bool;
-
-	/**
-	 * returns an array contains details about a config value
-	 *
-	 * ```
-	 * [
-	 *   "app" => "myapp",
-	 *   "key" => "mykey",
-	 *   "value" => "its_value",
-	 *   "lazy" => false,
-	 *   "type" => 4,
-	 *   "typeString" => "string",
-	 *   'sensitive' => true
-	 * ]
-	 * ```
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 *
-	 * @return array
-	 * @throws AppConfigUnknownKeyException if config key is not known in database
-	 * @since 29.0.0
-	 */
-	public function getDetails(string $app, string $key): array;
-
-	/**
-	 * returns an array containing details about a config key.
-	 * key/value pair are available only if it exists.
-	 *
-	 * ```
-	 * [
-	 *   "app" => "myapp",
-	 *   "key" => "mykey",
-	 *   "value" => "current_value",
-	 *   "default" => "default_if_available",
-	 *   "definition" => "this is what it does",
-	 *   "note" => "enabling this is not compatible with that",
-	 *   "lazy" => false,
-	 *   "type" => 4,
-	 *   "typeString" => "string",
-	 *   'sensitive' => false
-	 * ]
-	 * ```
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 *
-	 * @return array{app: string, key: string, lazy?: bool, valueType?: ValueType, valueTypeName?: string, sensitive?: bool, internal?: bool, default?: string, definition?: string, note?: string}
-	 * @since 32.0.0
-	 */
-	public function getKeyDetails(string $app, string $key): array;
-
-	/**
-	 * Convert string like 'string', 'integer', 'float', 'bool' or 'array' to
-	 * to bitflag {@see VALUE_STRING}, {@see VALUE_INT}, {@see VALUE_FLOAT},
-	 * {@see VALUE_BOOL} and {@see VALUE_ARRAY}
-	 *
-	 * @param string $type
-	 *
-	 * @return int
-	 * @since 29.0.0
-	 */
-	public function convertTypeToInt(string $type): int;
-
-	/**
-	 * Convert bitflag {@see VALUE_STRING}, {@see VALUE_INT}, {@see VALUE_FLOAT},
-	 * {@see VALUE_BOOL} and {@see VALUE_ARRAY} to human-readable string
-	 *
-	 * @param int $type
-	 *
-	 * @return string
-	 * @since 29.0.0
-	 */
-	public function convertTypeToString(int $type): string;
-
-	/**
-	 * Delete single config key from database.
-	 *
-	 * @param string $app id of the app
-	 * @param string $key config key
-	 * @since 29.0.0
-	 */
-	public function deleteKey(string $app, string $key): void;
-
-	/**
-	 * delete all config keys linked to an app
-	 *
-	 * @param string $app id of the app
-	 * @since 29.0.0
-	 */
-	public function deleteApp(string $app): void;
-
-	/**
-	 * Clear the cache.
-	 *
-	 * The cache will be rebuilt only the next time a config value is requested.
-	 *
-	 * @param bool $reload set to TRUE to refill cache instantly after clearing it
-	 * @since 29.0.0
-	 */
-	public function clearCache(bool $reload = false): void;
-
-	/**
-	 * get multiply values, either the app or key can be used as wildcard by setting it to false
-	 *
-	 * @param string|false $key
-	 * @param string|false $app
-	 *
-	 * @return array|false
-	 * @since 7.0.0
-	 * @deprecated 29.0.0 Use {@see getAllValues()} or {@see searchValues()}
-	 */
-	public function getValues($app, $key);
-
-	/**
-	 * get all values of the app or and filters out sensitive data
-	 *
-	 * @param string $app
-	 *
-	 * @return array
-	 * @since 12.0.0
-	 * @deprecated 29.0.0 Use {@see getAllValues()} or {@see searchValues()}
-	 */
-	public function getFilteredValues($app);
-
-	/**
-	 * Returns the installed version of all apps
-	 *
-	 * @return array<string, string>
-	 * @since 32.0.0
-	 */
-	public function getAppInstalledVersions(bool $onlyEnabled = false): array;
+    /** @since 29.0.0 */
+    public const VALUE_SENSITIVE = 1;
+    /** @since 29.0.0 */
+    public const VALUE_MIXED = 2;
+    /** @since 29.0.0 */
+    public const VALUE_STRING = 4;
+    /** @since 29.0.0 */
+    public const VALUE_INT = 8;
+    /** @since 29.0.0 */
+    public const VALUE_FLOAT = 16;
+    /** @since 29.0.0 */
+    public const VALUE_BOOL = 32;
+    /** @since 29.0.0 */
+    public const VALUE_ARRAY = 64;
+
+    /** @since 31.0.0 */
+    public const FLAG_SENSITIVE = 1;   // value is sensitive
+    /**
+     * @since 33.0.0
+     */
+    public const FLAG_INTERNAL = 4;   // value is considered internal and can be hidden from listing
+
+    /**
+     * Get list of all apps that have at least one config value stored in database
+     *
+     * **WARNING:** ignore lazy filtering, all config values are loaded from database
+     *
+     * @return list<string> list of app ids
+     * @since 7.0.0
+     */
+    public function getApps(): array;
+
+    /**
+     * Returns all keys stored in database, related to an app.
+     * Please note that the values are not returned.
+     *
+     * **WARNING:** ignore lazy filtering, all config values are loaded from database
+     *
+     * @param string $app id of the app
+     * @return list<string> list of stored config keys
+     * @see searchKeys to avoid loading lazy config keys
+     *
+     * @since 29.0.0
+     */
+    public function getKeys(string $app): array;
+
+    /**
+     * Returns list of keys stored in database, related to an app.
+     * Please note that the values are not returned.
+     *
+     * @param string $app id of the app
+     * @param string $prefix returns only keys starting with this value
+     * @param bool $lazy TRUE to search in lazy config keys
+     *
+     * @return list<string> list of stored config keys
+     * @since 32.0.0
+     */
+    public function searchKeys(string $app, string $prefix = '', bool $lazy = false): array;
+
+    /**
+     * Check if a key exists in the list of stored config values.
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return bool TRUE if key exists
+     * @since 29.0.0 Added the $lazy argument
+     * @since 7.0.0
+     */
+    public function hasKey(string $app, string $key, ?bool $lazy = false): bool;
+
+    /**
+     * best way to see if a value is set as sensitive (not displayed in report)
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool|null $lazy search within lazy loaded config
+     *
+     * @return bool TRUE if value is sensitive
+     * @throws AppConfigUnknownKeyException if config key is not known
+     * @since 29.0.0
+     */
+    public function isSensitive(string $app, string $key, ?bool $lazy = false): bool;
+
+    /**
+     * Returns if the config key stored in database is lazy loaded
+     *
+     * **WARNING:** ignore lazy filtering, all config values are loaded from database
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     *
+     * @return bool TRUE if config is lazy loaded
+     * @throws AppConfigUnknownKeyException if config key is not known
+     * @see IAppConfig for details about lazy loading
+     * @since 29.0.0
+     */
+    public function isLazy(string $app, string $key): bool;
+
+    /**
+     * List all config values from an app with config key starting with $key.
+     * Returns an array with config key as key, stored value as value.
+     *
+     * **WARNING:** ignore lazy filtering, all config values are loaded from database
+     *
+     * @param string $app id of the app
+     * @param string $prefix config keys prefix to search, can be empty.
+     * @param bool $filtered filter sensitive config values
+     *
+     * @return array<string, string|int|float|bool|array> [configKey => configValue]
+     * @since 29.0.0
+     */
+    public function getAllValues(string $app, string $prefix = '', bool $filtered = false): array;
+
+    /**
+     * List all apps storing a specific config key and its stored value.
+     * Returns an array with appId as key, stored value as value.
+     *
+     * @param string $key config key
+     * @param bool $lazy search within lazy loaded config
+     * @param int|null $typedAs enforce type for the returned values {@see self::VALUE_STRING} and others
+     *
+     * @return array<string, string|int|float|bool|array> [appId => configValue]
+     * @since 29.0.0
+     */
+    public function searchValues(string $key, bool $lazy = false, ?int $typedAs = null): array;
+
+    /**
+     * Get config value assigned to a config key.
+     * If config key is not found in database, default value is returned.
+     * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param string $default default value
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return string stored config value or $default if not set in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     * @see getValueInt()
+     * @see getValueFloat()
+     * @see getValueBool()
+     * @see getValueArray()
+     */
+    public function getValueString(string $app, string $key, string $default = '', bool $lazy = false): string;
+
+    /**
+     * Get config value assigned to a config key.
+     * If config key is not found in database, default value is returned.
+     * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param int $default default value
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return int stored config value or $default if not set in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     * @see getValueString()
+     * @see getValueFloat()
+     * @see getValueBool()
+     * @see getValueArray()
+     */
+    public function getValueInt(string $app, string $key, int $default = 0, bool $lazy = false): int;
+
+    /**
+     * Get config value assigned to a config key.
+     * If config key is not found in database, default value is returned.
+     * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param float $default default value
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return float stored config value or $default if not set in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     * @see getValueString()
+     * @see getValueInt()
+     * @see getValueBool()
+     * @see getValueArray()
+     */
+    public function getValueFloat(string $app, string $key, float $default = 0, bool $lazy = false): float;
+
+    /**
+     * Get config value assigned to a config key.
+     * If config key is not found in database, default value is returned.
+     * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $default default value
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return bool stored config value or $default if not set in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     * @see getValueString()
+     * @see getValueInt()
+     * @see getValueFloat()
+     * @see getValueArray()
+     */
+    public function getValueBool(string $app, string $key, bool $default = false, bool $lazy = false): bool;
+
+    /**
+     * Get config value assigned to a config key.
+     * If config key is not found in database, default value is returned.
+     * If config key is set as lazy loaded, the $lazy argument needs to be set to TRUE.
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param array $default default value
+     * @param bool $lazy search within lazy loaded config
+     *
+     * @return array stored config value or $default if not set in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     * @see getValueString()
+     * @see getValueInt()
+     * @see getValueFloat()
+     * @see getValueBool()
+     */
+    public function getValueArray(string $app, string $key, array $default = [], bool $lazy = false): array;
+
+    /**
+     * returns the type of config value
+     *
+     * **WARNING:** ignore lazy filtering, all config values are loaded from database
+     *              unless lazy is set to false
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool|null $lazy
+     *
+     * @return int
+     * @throws AppConfigUnknownKeyException
+     * @since 29.0.0
+     * @see VALUE_STRING
+     * @see VALUE_INT
+     * @see VALUE_FLOAT
+     * @see VALUE_BOOL
+     * @see VALUE_ARRAY
+     */
+    public function getValueType(string $app, string $key, ?bool $lazy = null): int;
+
+    /**
+     * Store a config key and its value in database
+     *
+     * If config key is already known with the exact same config value, the database is not updated.
+     * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
+     *
+     * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param string $value config value
+     * @param bool $sensitive if TRUE value will be hidden when listing config values.
+     * @param bool $lazy set config as lazy loaded
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     * @see setValueInt()
+     * @see setValueFloat()
+     * @see setValueBool()
+     * @see setValueArray()
+     */
+    public function setValueString(string $app, string $key, string $value, bool $lazy = false, bool $sensitive = false): bool;
+
+    /**
+     * Store a config key and its value in database
+     *
+     * When handling huge value around and/or above 2,147,483,647, a debug log will be generated
+     * on 64bits system, as php int type reach its limit (and throw an exception) on 32bits when using huge numbers.
+     *
+     * When using huge numbers, it is advised to use {@see \OCP\Util::numericToNumber()} and {@see setValueString()}
+     *
+     * If config key is already known with the exact same config value, the database is not updated.
+     * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
+     *
+     * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param int $value config value
+     * @param bool $sensitive if TRUE value will be hidden when listing config values.
+     * @param bool $lazy set config as lazy loaded
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     * @see setValueString()
+     * @see setValueFloat()
+     * @see setValueBool()
+     * @see setValueArray()
+     */
+    public function setValueInt(string $app, string $key, int $value, bool $lazy = false, bool $sensitive = false): bool;
+
+    /**
+     * Store a config key and its value in database.
+     *
+     * If config key is already known with the exact same config value, the database is not updated.
+     * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
+     *
+     * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param float $value config value
+     * @param bool $sensitive if TRUE value will be hidden when listing config values.
+     * @param bool $lazy set config as lazy loaded
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     * @see setValueString()
+     * @see setValueInt()
+     * @see setValueBool()
+     * @see setValueArray()
+     */
+    public function setValueFloat(string $app, string $key, float $value, bool $lazy = false, bool $sensitive = false): bool;
+
+    /**
+     * Store a config key and its value in database
+     *
+     * If config key is already known with the exact same config value, the database is not updated.
+     * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
+     *
+     * If config value was previously stored as lazy loaded, status cannot be altered without using {@see deleteKey()} first
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $value config value
+     * @param bool $lazy set config as lazy loaded
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     * @see setValueString()
+     * @see setValueInt()
+     * @see setValueFloat()
+     * @see setValueArray()
+     */
+    public function setValueBool(string $app, string $key, bool $value, bool $lazy = false): bool;
+
+    /**
+     * Store a config key and its value in database
+     *
+     * If config key is already known with the exact same config value, the database is not updated.
+     * If config key is not supposed to be read during the boot of the cloud, it is advised to set it as lazy loaded.
+     *
+     * If config value was previously stored as sensitive or lazy loaded, status cannot be altered without using {@see deleteKey()} first
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param array $value config value
+     * @param bool $sensitive if TRUE value will be hidden when listing config values.
+     * @param bool $lazy set config as lazy loaded
+     *
+     * @return bool TRUE if value was different, therefor updated in database
+     * @since 29.0.0
+     * @see IAppConfig for explanation about lazy loading
+     * @see setValueString()
+     * @see setValueInt()
+     * @see setValueFloat()
+     * @see setValueBool()
+     */
+    public function setValueArray(string $app, string $key, array $value, bool $lazy = false, bool $sensitive = false): bool;
+
+    /**
+     * switch sensitive status of a config value
+     *
+     * **WARNING:** ignore lazy filtering, all config values are loaded from database
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $sensitive TRUE to set as sensitive, FALSE to unset
+     *
+     * @return bool TRUE if database update were necessary
+     * @since 29.0.0
+     */
+    public function updateSensitive(string $app, string $key, bool $sensitive): bool;
+
+    /**
+     * switch lazy loading status of a config value
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @param bool $lazy TRUE to set as lazy loaded, FALSE to unset
+     *
+     * @return bool TRUE if database update was necessary
+     * @since 29.0.0
+     */
+    public function updateLazy(string $app, string $key, bool $lazy): bool;
+
+    /**
+     * returns an array contains details about a config value
+     *
+     * ```
+     * [
+     *   "app" => "myapp",
+     *   "key" => "mykey",
+     *   "value" => "its_value",
+     *   "lazy" => false,
+     *   "type" => 4,
+     *   "typeString" => "string",
+     *   'sensitive' => true
+     * ]
+     * ```
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     *
+     * @return array
+     * @throws AppConfigUnknownKeyException if config key is not known in database
+     * @since 29.0.0
+     */
+    public function getDetails(string $app, string $key): array;
+
+    /**
+     * returns an array containing details about a config key.
+     * key/value pair are available only if it exists.
+     *
+     * ```
+     * [
+     *   "app" => "myapp",
+     *   "key" => "mykey",
+     *   "value" => "current_value",
+     *   "default" => "default_if_available",
+     *   "definition" => "this is what it does",
+     *   "note" => "enabling this is not compatible with that",
+     *   "lazy" => false,
+     *   "type" => 4,
+     *   "typeString" => "string",
+     *   'sensitive' => false
+     * ]
+     * ```
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     *
+     * @return array{app: string, key: string, lazy?: bool, valueType?: ValueType, valueTypeName?: string, sensitive?: bool, internal?: bool, default?: string, definition?: string, note?: string}
+     * @since 32.0.0
+     */
+    public function getKeyDetails(string $app, string $key): array;
+
+    /**
+     * Convert string like 'string', 'integer', 'float', 'bool' or 'array' to
+     * to bitflag {@see VALUE_STRING}, {@see VALUE_INT}, {@see VALUE_FLOAT},
+     * {@see VALUE_BOOL} and {@see VALUE_ARRAY}
+     *
+     * @param string $type
+     *
+     * @return int
+     * @since 29.0.0
+     */
+    public function convertTypeToInt(string $type): int;
+
+    /**
+     * Convert bitflag {@see VALUE_STRING}, {@see VALUE_INT}, {@see VALUE_FLOAT},
+     * {@see VALUE_BOOL} and {@see VALUE_ARRAY} to human-readable string
+     *
+     * @param int $type
+     *
+     * @return string
+     * @since 29.0.0
+     */
+    public function convertTypeToString(int $type): string;
+
+    /**
+     * Delete single config key from database.
+     *
+     * @param string $app id of the app
+     * @param string $key config key
+     * @since 29.0.0
+     */
+    public function deleteKey(string $app, string $key): void;
+
+    /**
+     * delete all config keys linked to an app
+     *
+     * @param string $app id of the app
+     * @since 29.0.0
+     */
+    public function deleteApp(string $app): void;
+
+    /**
+     * Clear the cache.
+     *
+     * The cache will be rebuilt only the next time a config value is requested.
+     *
+     * @param bool $reload set to TRUE to refill cache instantly after clearing it
+     * @since 29.0.0
+     */
+    public function clearCache(bool $reload = false): void;
+
+    /**
+     * get multiply values, either the app or key can be used as wildcard by setting it to false
+     *
+     * @param string|false $key
+     * @param string|false $app
+     *
+     * @return array|false
+     * @since 7.0.0
+     * @deprecated 29.0.0 Use {@see getAllValues()} or {@see searchValues()}
+     */
+    public function getValues($app, $key);
+
+    /**
+     * get all values of the app or and filters out sensitive data
+     *
+     * @param string $app
+     *
+     * @return array
+     * @since 12.0.0
+     * @deprecated 29.0.0 Use {@see getAllValues()} or {@see searchValues()}
+     */
+    public function getFilteredValues($app);
+
+    /**
+     * Returns the installed version of all apps
+     *
+     * @return array<string, string>
+     * @since 32.0.0
+     */
+    public function getAppInstalledVersions(bool $onlyEnabled = false): array;
 }

Spacing +2 added lines, -2 removed lines

@@ -47,11 +47,11 @@
 	public const VALUE_ARRAY = 64;
 
 	/** @since 31.0.0 */
-	public const FLAG_SENSITIVE = 1;   // value is sensitive
+	public const FLAG_SENSITIVE = 1; // value is sensitive
 	/**
 	 * @since 33.0.0
 	 */
-	public const FLAG_INTERNAL = 4;   // value is considered internal and can be hidden from listing
+	public const FLAG_INTERNAL = 4; // value is considered internal and can be hidden from listing
 
 	/**
 	 * Get list of all apps that have at least one config value stored in database

core/Command/Config/App/SetConfig.php

Indentation +228 added lines, -228 removed lines

@@ -19,232 +19,232 @@
 use Symfony\Component\Console\Question\Question;
 
 class SetConfig extends Base {
-	protected function configure() {
-		parent::configure();
-
-		$this
-			->setName('config:app:set')
-			->setDescription('Set an app config value')
-			->addArgument(
-				'app',
-				InputArgument::REQUIRED,
-				'Name of the app'
-			)
-			->addArgument(
-				'name',
-				InputArgument::REQUIRED,
-				'Name of the config to set'
-			)
-			->addOption(
-				'value',
-				null,
-				InputOption::VALUE_REQUIRED,
-				'The new value of the config'
-			)
-			->addOption(
-				'type',
-				null,
-				InputOption::VALUE_REQUIRED,
-				'Value type [string, integer, float, boolean, array]',
-				'string'
-			)
-			->addOption(
-				'lazy',
-				null,
-				InputOption::VALUE_NEGATABLE,
-				'Set value as lazy loaded',
-			)
-			->addOption(
-				'sensitive',
-				null,
-				InputOption::VALUE_NEGATABLE,
-				'Set value as sensitive',
-			)
-			->addOption(
-				'internal',
-				null,
-				InputOption::VALUE_NONE,
-				'Confirm the edit of an internal value',
-			)
-			->addOption(
-				'update-only',
-				null,
-				InputOption::VALUE_NONE,
-				'Only updates the value, if it is not set before, it is not being added'
-			)
-		;
-	}
-
-	protected function execute(InputInterface $input, OutputInterface $output): int {
-		$appName = $input->getArgument('app');
-		$configName = $input->getArgument('name');
-
-		if (!($this->appConfig instanceof AppConfig)) {
-			throw new \Exception('Only compatible with OC\AppConfig as it uses internal methods');
-		}
-
-		if ($input->hasParameterOption('--update-only') && !$this->appConfig->hasKey($appName, $configName)) {
-			$output->writeln(
-				'<comment>Config value ' . $configName . ' for app ' . $appName
-				. ' not updated, as it has not been set before.</comment>'
-			);
-
-			return 1;
-		}
-
-		$type = $typeString = null;
-		if ($input->hasParameterOption('--type')) {
-			$typeString = $input->getOption('type');
-			$type = $this->appConfig->convertTypeToInt($typeString);
-		}
-
-		/**
-		 * If --Value is not specified, returns an exception if no value exists in database
-		 * compare with current status in database and displays a reminder that this can break things.
-		 * confirmation is required by admin, unless --no-interaction
-		 */
-		$updated = false;
-		if (!$input->hasParameterOption('--value')) {
-			if (!$input->getOption('lazy') && $this->appConfig->isLazy($appName, $configName) && $this->ask($input, $output, 'NOT LAZY')) {
-				$updated = $this->appConfig->updateLazy($appName, $configName, false);
-			}
-			if ($input->getOption('lazy') && !$this->appConfig->isLazy($appName, $configName) && $this->ask($input, $output, 'LAZY')) {
-				$updated = $this->appConfig->updateLazy($appName, $configName, true) || $updated;
-			}
-			if (!$input->getOption('sensitive') && $this->appConfig->isSensitive($appName, $configName) && $this->ask($input, $output, 'NOT SENSITIVE')) {
-				$updated = $this->appConfig->updateSensitive($appName, $configName, false) || $updated;
-			}
-			if ($input->getOption('sensitive') && !$this->appConfig->isSensitive($appName, $configName) && $this->ask($input, $output, 'SENSITIVE')) {
-				$updated = $this->appConfig->updateSensitive($appName, $configName, true) || $updated;
-			}
-			if ($type !== null && $type !== $this->appConfig->getValueType($appName, $configName) && $typeString !== null && $this->ask($input, $output, $typeString)) {
-				$updated = $this->appConfig->updateType($appName, $configName, $type) || $updated;
-			}
-		} else {
-			/**
-			 * If --type is specified in the command line, we upgrade the type in database
-			 * after a confirmation from admin.
-			 * If not we get the type from current stored value or VALUE_MIXED as default.
-			 */
-			try {
-				$currType = $this->appConfig->getValueType($appName, $configName);
-				if ($type === null || $typeString === null || $type === $currType || !$this->ask($input, $output, $typeString)) {
-					$type = $currType;
-				} else {
-					$updated = $this->appConfig->updateType($appName, $configName, $type);
-				}
-			} catch (AppConfigUnknownKeyException) {
-				$type = $type ?? IAppConfig::VALUE_MIXED;
-			}
-
-			/**
-			 * if --lazy/--no-lazy option are set, compare with data stored in database.
-			 * If no data in database, or identical, continue.
-			 * If different, ask admin for confirmation.
-			 */
-			$lazy = $input->getOption('lazy');
-			try {
-				$currLazy = $this->appConfig->isLazy($appName, $configName);
-				if ($lazy === null || $lazy === $currLazy || !$this->ask($input, $output, ($lazy) ? 'LAZY' : 'NOT LAZY')) {
-					$lazy = $currLazy;
-				}
-			} catch (AppConfigUnknownKeyException) {
-				$lazy = $lazy ?? false;
-			}
-
-			/**
-			 * same with sensitive status
-			 */
-			$sensitive = $input->getOption('sensitive');
-			try {
-				$currSensitive = $this->appConfig->isSensitive($appName, $configName, null);
-				if ($sensitive === null || $sensitive === $currSensitive || !$this->ask($input, $output, ($sensitive) ? 'SENSITIVE' : 'NOT SENSITIVE')) {
-					$sensitive = $currSensitive;
-				}
-			} catch (AppConfigUnknownKeyException) {
-				$sensitive = $sensitive ?? false;
-			}
-
-			if (!$input->getOption('internal') && ($this->appConfig->getKeyDetails($appName, $configName)['internal'] ?? false)) {
-				$output->writeln('<error>Config key is set as INTERNAL and modifying it might induce strange behavior or break user experience.</error>');
-				$output->writeln('please use option <comment>--internal</comment> to confirm your action');
-				return self::FAILURE;
-			}
-
-			$value = (string)$input->getOption('value');
-			switch ($type) {
-				case IAppConfig::VALUE_MIXED:
-					$updated = $this->appConfig->setValueMixed($appName, $configName, $value, $lazy, $sensitive);
-					break;
-
-				case IAppConfig::VALUE_STRING:
-					$updated = $this->appConfig->setValueString($appName, $configName, $value, $lazy, $sensitive);
-					break;
-
-				case IAppConfig::VALUE_INT:
-					$updated = $this->appConfig->setValueInt($appName, $configName, $this->configManager->convertToInt($value), $lazy, $sensitive);
-					break;
-
-				case IAppConfig::VALUE_FLOAT:
-					$updated = $this->appConfig->setValueFloat($appName, $configName, $this->configManager->convertToFloat($value), $lazy, $sensitive);
-					break;
-
-				case IAppConfig::VALUE_BOOL:
-					$updated = $this->appConfig->setValueBool($appName, $configName, $this->configManager->convertToBool($value), $lazy);
-					break;
-
-				case IAppConfig::VALUE_ARRAY:
-					$updated = $this->appConfig->setValueArray($appName, $configName, $this->configManager->convertToArray($value), $lazy, $sensitive);
-					break;
-			}
-		}
-
-		if ($updated) {
-			$current = $this->appConfig->getDetails($appName, $configName);
-			$output->writeln(
-				sprintf(
-					"<info>Config value '%s' for app '%s' is now set to '%s', stored as %s in %s</info>",
-					$configName,
-					$appName,
-					$current['sensitive'] ? '<sensitive>' : $current['value'],
-					$current['typeString'],
-					$current['lazy'] ? 'lazy cache' : 'fast cache'
-				)
-			);
-			$keyDetails = $this->appConfig->getKeyDetails($appName, $configName);
-			if (($keyDetails['note'] ?? '') !== '') {
-				$output->writeln('<comment>Note:</comment> ' . $keyDetails['note']);
-			}
-
-		} else {
-			$output->writeln('<info>Config value were not updated</info>');
-		}
-
-		return 0;
-	}
-
-	private function ask(InputInterface $input, OutputInterface $output, string $request): bool {
-		/** @var QuestionHelper $helper */
-		$helper = $this->getHelper('question');
-		if ($input->getOption('no-interaction')) {
-			return true;
-		}
-
-		$output->writeln(sprintf('You are about to set config value %s as <info>%s</info>',
-			'<info>' . $input->getArgument('app') . '</info>/<info>' . $input->getArgument('name') . '</info>',
-			strtoupper($request)
-		));
-		$output->writeln('');
-		$output->writeln('<comment>This might break thing, affect performance on your instance or its security!</comment>');
-
-		$result = (strtolower((string)$helper->ask(
-			$input,
-			$output,
-			new Question('<comment>Confirm this action by typing \'yes\'</comment>: '))) === 'yes');
-
-		$output->writeln(($result) ? 'done' : 'cancelled');
-		$output->writeln('');
-
-		return $result;
-	}
+    protected function configure() {
+        parent::configure();
+
+        $this
+            ->setName('config:app:set')
+            ->setDescription('Set an app config value')
+            ->addArgument(
+                'app',
+                InputArgument::REQUIRED,
+                'Name of the app'
+            )
+            ->addArgument(
+                'name',
+                InputArgument::REQUIRED,
+                'Name of the config to set'
+            )
+            ->addOption(
+                'value',
+                null,
+                InputOption::VALUE_REQUIRED,
+                'The new value of the config'
+            )
+            ->addOption(
+                'type',
+                null,
+                InputOption::VALUE_REQUIRED,
+                'Value type [string, integer, float, boolean, array]',
+                'string'
+            )
+            ->addOption(
+                'lazy',
+                null,
+                InputOption::VALUE_NEGATABLE,
+                'Set value as lazy loaded',
+            )
+            ->addOption(
+                'sensitive',
+                null,
+                InputOption::VALUE_NEGATABLE,
+                'Set value as sensitive',
+            )
+            ->addOption(
+                'internal',
+                null,
+                InputOption::VALUE_NONE,
+                'Confirm the edit of an internal value',
+            )
+            ->addOption(
+                'update-only',
+                null,
+                InputOption::VALUE_NONE,
+                'Only updates the value, if it is not set before, it is not being added'
+            )
+        ;
+    }
+
+    protected function execute(InputInterface $input, OutputInterface $output): int {
+        $appName = $input->getArgument('app');
+        $configName = $input->getArgument('name');
+
+        if (!($this->appConfig instanceof AppConfig)) {
+            throw new \Exception('Only compatible with OC\AppConfig as it uses internal methods');
+        }
+
+        if ($input->hasParameterOption('--update-only') && !$this->appConfig->hasKey($appName, $configName)) {
+            $output->writeln(
+                '<comment>Config value ' . $configName . ' for app ' . $appName
+                . ' not updated, as it has not been set before.</comment>'
+            );
+
+            return 1;
+        }
+
+        $type = $typeString = null;
+        if ($input->hasParameterOption('--type')) {
+            $typeString = $input->getOption('type');
+            $type = $this->appConfig->convertTypeToInt($typeString);
+        }
+
+        /**
+         * If --Value is not specified, returns an exception if no value exists in database
+         * compare with current status in database and displays a reminder that this can break things.
+         * confirmation is required by admin, unless --no-interaction
+         */
+        $updated = false;
+        if (!$input->hasParameterOption('--value')) {
+            if (!$input->getOption('lazy') && $this->appConfig->isLazy($appName, $configName) && $this->ask($input, $output, 'NOT LAZY')) {
+                $updated = $this->appConfig->updateLazy($appName, $configName, false);
+            }
+            if ($input->getOption('lazy') && !$this->appConfig->isLazy($appName, $configName) && $this->ask($input, $output, 'LAZY')) {
+                $updated = $this->appConfig->updateLazy($appName, $configName, true) || $updated;
+            }
+            if (!$input->getOption('sensitive') && $this->appConfig->isSensitive($appName, $configName) && $this->ask($input, $output, 'NOT SENSITIVE')) {
+                $updated = $this->appConfig->updateSensitive($appName, $configName, false) || $updated;
+            }
+            if ($input->getOption('sensitive') && !$this->appConfig->isSensitive($appName, $configName) && $this->ask($input, $output, 'SENSITIVE')) {
+                $updated = $this->appConfig->updateSensitive($appName, $configName, true) || $updated;
+            }
+            if ($type !== null && $type !== $this->appConfig->getValueType($appName, $configName) && $typeString !== null && $this->ask($input, $output, $typeString)) {
+                $updated = $this->appConfig->updateType($appName, $configName, $type) || $updated;
+            }
+        } else {
+            /**
+             * If --type is specified in the command line, we upgrade the type in database
+             * after a confirmation from admin.
+             * If not we get the type from current stored value or VALUE_MIXED as default.
+             */
+            try {
+                $currType = $this->appConfig->getValueType($appName, $configName);
+                if ($type === null || $typeString === null || $type === $currType || !$this->ask($input, $output, $typeString)) {
+                    $type = $currType;
+                } else {
+                    $updated = $this->appConfig->updateType($appName, $configName, $type);
+                }
+            } catch (AppConfigUnknownKeyException) {
+                $type = $type ?? IAppConfig::VALUE_MIXED;
+            }
+
+            /**
+             * if --lazy/--no-lazy option are set, compare with data stored in database.
+             * If no data in database, or identical, continue.
+             * If different, ask admin for confirmation.
+             */
+            $lazy = $input->getOption('lazy');
+            try {
+                $currLazy = $this->appConfig->isLazy($appName, $configName);
+                if ($lazy === null || $lazy === $currLazy || !$this->ask($input, $output, ($lazy) ? 'LAZY' : 'NOT LAZY')) {
+                    $lazy = $currLazy;
+                }
+            } catch (AppConfigUnknownKeyException) {
+                $lazy = $lazy ?? false;
+            }
+
+            /**
+             * same with sensitive status
+             */
+            $sensitive = $input->getOption('sensitive');
+            try {
+                $currSensitive = $this->appConfig->isSensitive($appName, $configName, null);
+                if ($sensitive === null || $sensitive === $currSensitive || !$this->ask($input, $output, ($sensitive) ? 'SENSITIVE' : 'NOT SENSITIVE')) {
+                    $sensitive = $currSensitive;
+                }
+            } catch (AppConfigUnknownKeyException) {
+                $sensitive = $sensitive ?? false;
+            }
+
+            if (!$input->getOption('internal') && ($this->appConfig->getKeyDetails($appName, $configName)['internal'] ?? false)) {
+                $output->writeln('<error>Config key is set as INTERNAL and modifying it might induce strange behavior or break user experience.</error>');
+                $output->writeln('please use option <comment>--internal</comment> to confirm your action');
+                return self::FAILURE;
+            }
+
+            $value = (string)$input->getOption('value');
+            switch ($type) {
+                case IAppConfig::VALUE_MIXED:
+                    $updated = $this->appConfig->setValueMixed($appName, $configName, $value, $lazy, $sensitive);
+                    break;
+
+                case IAppConfig::VALUE_STRING:
+                    $updated = $this->appConfig->setValueString($appName, $configName, $value, $lazy, $sensitive);
+                    break;
+
+                case IAppConfig::VALUE_INT:
+                    $updated = $this->appConfig->setValueInt($appName, $configName, $this->configManager->convertToInt($value), $lazy, $sensitive);
+                    break;
+
+                case IAppConfig::VALUE_FLOAT:
+                    $updated = $this->appConfig->setValueFloat($appName, $configName, $this->configManager->convertToFloat($value), $lazy, $sensitive);
+                    break;
+
+                case IAppConfig::VALUE_BOOL:
+                    $updated = $this->appConfig->setValueBool($appName, $configName, $this->configManager->convertToBool($value), $lazy);
+                    break;
+
+                case IAppConfig::VALUE_ARRAY:
+                    $updated = $this->appConfig->setValueArray($appName, $configName, $this->configManager->convertToArray($value), $lazy, $sensitive);
+                    break;
+            }
+        }
+
+        if ($updated) {
+            $current = $this->appConfig->getDetails($appName, $configName);
+            $output->writeln(
+                sprintf(
+                    "<info>Config value '%s' for app '%s' is now set to '%s', stored as %s in %s</info>",
+                    $configName,
+                    $appName,
+                    $current['sensitive'] ? '<sensitive>' : $current['value'],
+                    $current['typeString'],
+                    $current['lazy'] ? 'lazy cache' : 'fast cache'
+                )
+            );
+            $keyDetails = $this->appConfig->getKeyDetails($appName, $configName);
+            if (($keyDetails['note'] ?? '') !== '') {
+                $output->writeln('<comment>Note:</comment> ' . $keyDetails['note']);
+            }
+
+        } else {
+            $output->writeln('<info>Config value were not updated</info>');
+        }
+
+        return 0;
+    }
+
+    private function ask(InputInterface $input, OutputInterface $output, string $request): bool {
+        /** @var QuestionHelper $helper */
+        $helper = $this->getHelper('question');
+        if ($input->getOption('no-interaction')) {
+            return true;
+        }
+
+        $output->writeln(sprintf('You are about to set config value %s as <info>%s</info>',
+            '<info>' . $input->getArgument('app') . '</info>/<info>' . $input->getArgument('name') . '</info>',
+            strtoupper($request)
+        ));
+        $output->writeln('');
+        $output->writeln('<comment>This might break thing, affect performance on your instance or its security!</comment>');
+
+        $result = (strtolower((string)$helper->ask(
+            $input,
+            $output,
+            new Question('<comment>Confirm this action by typing \'yes\'</comment>: '))) === 'yes');
+
+        $output->writeln(($result) ? 'done' : 'cancelled');
+        $output->writeln('');
+
+        return $result;
+    }
 }

Spacing +5 added lines, -5 removed lines

@@ -85,7 +85,7 @@ 
 
 		if ($input->hasParameterOption('--update-only') && !$this->appConfig->hasKey($appName, $configName)) {
 			$output->writeln(
-				'<comment>Config value ' . $configName . ' for app ' . $appName
+				'<comment>Config value '.$configName.' for app '.$appName
 				. ' not updated, as it has not been set before.</comment>'
 			);
 
@@ -171,7 +171,7 @@ 
 				return self::FAILURE;
 			}
 
-			$value = (string)$input->getOption('value');
+			$value = (string) $input->getOption('value');
 			switch ($type) {
 				case IAppConfig::VALUE_MIXED:
 					$updated = $this->appConfig->setValueMixed($appName, $configName, $value, $lazy, $sensitive);
@@ -213,7 +213,7 @@ 
 			);
 			$keyDetails = $this->appConfig->getKeyDetails($appName, $configName);
 			if (($keyDetails['note'] ?? '') !== '') {
-				$output->writeln('<comment>Note:</comment> ' . $keyDetails['note']);
+				$output->writeln('<comment>Note:</comment> '.$keyDetails['note']);
 			}
 
 		} else {
@@ -231,13 +231,13 @@ 
 		}
 
 		$output->writeln(sprintf('You are about to set config value %s as <info>%s</info>',
-			'<info>' . $input->getArgument('app') . '</info>/<info>' . $input->getArgument('name') . '</info>',
+			'<info>'.$input->getArgument('app').'</info>/<info>'.$input->getArgument('name').'</info>',
 			strtoupper($request)
 		));
 		$output->writeln('');
 		$output->writeln('<comment>This might break thing, affect performance on your instance or its security!</comment>');
 
-		$result = (strtolower((string)$helper->ask(
+		$result = (strtolower((string) $helper->ask(
 			$input,
 			$output,
 			new Question('<comment>Confirm this action by typing \'yes\'</comment>: '))) === 'yes');