nextcloud / server

lib/private/AppFramework/Services/AppConfig.php

Indentation +307 added lines, -307 removed lines

@@ -16,334 +16,334 @@
 use OCP\IConfig;
 
 class AppConfig implements IAppConfig {
-	public function __construct(
-		private IConfig $config,
-		/** @var \OC\AppConfig */
-		private \OCP\IAppConfig $appConfig,
-		private string $appName,
-	) {
-	}
+    public function __construct(
+        private IConfig $config,
+        /** @var \OC\AppConfig */
+        private \OCP\IAppConfig $appConfig,
+        private string $appName,
+    ) {
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @return string[] list of stored config keys
-	 * @since 20.0.0
-	 */
-	public function getAppKeys(): array {
-		return $this->appConfig->getKeys($this->appName);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @return string[] list of stored config keys
+     * @since 20.0.0
+     */
+    public function getAppKeys(): array {
+        return $this->appConfig->getKeys($this->appName);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @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 29.0.0
-	 */
-	public function hasAppKey(string $key, ?bool $lazy = false): bool {
-		return $this->appConfig->hasKey($this->appName, $key, $lazy);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @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 29.0.0
+     */
+    public function hasAppKey(string $key, ?bool $lazy = false): bool {
+        return $this->appConfig->hasKey($this->appName, $key, $lazy);
+    }
 
-	/**
-	 * @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 $key, ?bool $lazy = false): bool {
-		return $this->appConfig->isSensitive($this->appName, $key, $lazy);
-	}
+    /**
+     * @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 $key, ?bool $lazy = false): bool {
+        return $this->appConfig->isSensitive($this->appName, $key, $lazy);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $key config key
-	 *
-	 * @return bool TRUE if config is lazy loaded
-	 * @throws AppConfigUnknownKeyException if config key is not known
-	 * @see \OCP\IAppConfig for details about lazy loading
-	 * @since 29.0.0
-	 */
-	public function isLazy(string $key): bool {
-		return $this->appConfig->isLazy($this->appName, $key);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @param string $key config key
+     *
+     * @return bool TRUE if config is lazy loaded
+     * @throws AppConfigUnknownKeyException if config key is not known
+     * @see \OCP\IAppConfig for details about lazy loading
+     * @since 29.0.0
+     */
+    public function isLazy(string $key): bool {
+        return $this->appConfig->isLazy($this->appName, $key);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $key 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 getAllAppValues(string $key = '', bool $filtered = false): array {
-		return $this->appConfig->getAllValues($this->appName, $key, $filtered);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @param string $key 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 getAllAppValues(string $key = '', bool $filtered = false): array {
+        return $this->appConfig->getAllValues($this->appName, $key, $filtered);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $key the key of the value, under which will be saved
-	 * @param string $value the value that should be stored
-	 * @since 20.0.0
-	 * @deprecated 29.0.0 use {@see setAppValueString()}
-	 */
-	public function setAppValue(string $key, string $value): void {
-		/** @psalm-suppress InternalMethod */
-		$this->appConfig->setValueMixed($this->appName, $key, $value);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @param string $key the key of the value, under which will be saved
+     * @param string $value the value that should be stored
+     * @since 20.0.0
+     * @deprecated 29.0.0 use {@see setAppValueString()}
+     */
+    public function setAppValue(string $key, string $value): void {
+        /** @psalm-suppress InternalMethod */
+        $this->appConfig->setValueMixed($this->appName, $key, $value);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @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 \OCP\IAppConfig for explanation about lazy loading
-	 */
-	public function setAppValueString(
-		string $key,
-		string $value,
-		bool $lazy = false,
-		bool $sensitive = false,
-	): bool {
-		return $this->appConfig->setValueString($this->appName, $key, $value, $lazy, $sensitive);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @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 \OCP\IAppConfig for explanation about lazy loading
+     */
+    public function setAppValueString(
+        string $key,
+        string $value,
+        bool $lazy = false,
+        bool $sensitive = false,
+    ): bool {
+        return $this->appConfig->setValueString($this->appName, $key, $value, $lazy, $sensitive);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @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 \OCP\IAppConfig for explanation about lazy loading
-	 */
-	public function setAppValueInt(
-		string $key,
-		int $value,
-		bool $lazy = false,
-		bool $sensitive = false,
-	): bool {
-		return $this->appConfig->setValueInt($this->appName, $key, $value, $lazy, $sensitive);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @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 \OCP\IAppConfig for explanation about lazy loading
+     */
+    public function setAppValueInt(
+        string $key,
+        int $value,
+        bool $lazy = false,
+        bool $sensitive = false,
+    ): bool {
+        return $this->appConfig->setValueInt($this->appName, $key, $value, $lazy, $sensitive);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @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 \OCP\IAppConfig for explanation about lazy loading
-	 */
-	public function setAppValueFloat(
-		string $key,
-		float $value,
-		bool $lazy = false,
-		bool $sensitive = false,
-	): bool {
-		return $this->appConfig->setValueFloat($this->appName, $key, $value, $lazy, $sensitive);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @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 \OCP\IAppConfig for explanation about lazy loading
+     */
+    public function setAppValueFloat(
+        string $key,
+        float $value,
+        bool $lazy = false,
+        bool $sensitive = false,
+    ): bool {
+        return $this->appConfig->setValueFloat($this->appName, $key, $value, $lazy, $sensitive);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @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 \OCP\IAppConfig for explanation about lazy loading
-	 */
-	public function setAppValueBool(
-		string $key,
-		bool $value,
-		bool $lazy = false,
-	): bool {
-		return $this->appConfig->setValueBool($this->appName, $key, $value, $lazy);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @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 \OCP\IAppConfig for explanation about lazy loading
+     */
+    public function setAppValueBool(
+        string $key,
+        bool $value,
+        bool $lazy = false,
+    ): bool {
+        return $this->appConfig->setValueBool($this->appName, $key, $value, $lazy);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @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 \OCP\IAppConfig for explanation about lazy loading
-	 */
-	public function setAppValueArray(
-		string $key,
-		array $value,
-		bool $lazy = false,
-		bool $sensitive = false,
-	): bool {
-		return $this->appConfig->setValueArray($this->appName, $key, $value, $lazy, $sensitive);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @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 \OCP\IAppConfig for explanation about lazy loading
+     */
+    public function setAppValueArray(
+        string $key,
+        array $value,
+        bool $lazy = false,
+        bool $sensitive = false,
+    ): bool {
+        return $this->appConfig->setValueArray($this->appName, $key, $value, $lazy, $sensitive);
+    }
 
-	/**
-	 * @param string $key
-	 * @param string $default
-	 *
-	 * @since 20.0.0
-	 * @deprecated 29.0.0 use {@see getAppValueString()}
-	 * @return string
-	 */
-	public function getAppValue(string $key, string $default = ''): string {
-		/** @psalm-suppress InternalMethod */
-		/** @psalm-suppress UndefinedInterfaceMethod */
-		return $this->appConfig->getValueMixed($this->appName, $key, $default);
-	}
+    /**
+     * @param string $key
+     * @param string $default
+     *
+     * @since 20.0.0
+     * @deprecated 29.0.0 use {@see getAppValueString()}
+     * @return string
+     */
+    public function getAppValue(string $key, string $default = ''): string {
+        /** @psalm-suppress InternalMethod */
+        /** @psalm-suppress UndefinedInterfaceMethod */
+        return $this->appConfig->getValueMixed($this->appName, $key, $default);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @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 \OCP\IAppConfig for explanation about lazy loading
-	 */
-	public function getAppValueString(string $key, string $default = '', bool $lazy = false): string {
-		return $this->appConfig->getValueString($this->appName, $key, $default, $lazy);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @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 \OCP\IAppConfig for explanation about lazy loading
+     */
+    public function getAppValueString(string $key, string $default = '', bool $lazy = false): string {
+        return $this->appConfig->getValueString($this->appName, $key, $default, $lazy);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @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 \OCP\IAppConfig for explanation about lazy loading
-	 */
-	public function getAppValueInt(string $key, int $default = 0, bool $lazy = false): int {
-		return $this->appConfig->getValueInt($this->appName, $key, $default, $lazy);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @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 \OCP\IAppConfig for explanation about lazy loading
+     */
+    public function getAppValueInt(string $key, int $default = 0, bool $lazy = false): int {
+        return $this->appConfig->getValueInt($this->appName, $key, $default, $lazy);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @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 \OCP\IAppConfig for explanation about lazy loading
-	 */
-	public function getAppValueFloat(string $key, float $default = 0, bool $lazy = false): float {
-		return $this->appConfig->getValueFloat($this->appName, $key, $default, $lazy);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @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 \OCP\IAppConfig for explanation about lazy loading
+     */
+    public function getAppValueFloat(string $key, float $default = 0, bool $lazy = false): float {
+        return $this->appConfig->getValueFloat($this->appName, $key, $default, $lazy);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @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 \OCP\IAppConfig for explanation about lazy loading
-	 */
-	public function getAppValueBool(string $key, bool $default = false, bool $lazy = false): bool {
-		return $this->appConfig->getValueBool($this->appName, $key, $default, $lazy);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @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 \OCP\IAppConfig for explanation about lazy loading
+     */
+    public function getAppValueBool(string $key, bool $default = false, bool $lazy = false): bool {
+        return $this->appConfig->getValueBool($this->appName, $key, $default, $lazy);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @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 \OCP\IAppConfig for explanation about lazy loading
-	 */
-	public function getAppValueArray(string $key, array $default = [], bool $lazy = false): array {
-		return $this->appConfig->getValueArray($this->appName, $key, $default, $lazy);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @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 \OCP\IAppConfig for explanation about lazy loading
+     */
+    public function getAppValueArray(string $key, array $default = [], bool $lazy = false): array {
+        return $this->appConfig->getValueArray($this->appName, $key, $default, $lazy);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @param string $key the key of the value, under which it was saved
-	 * @since 20.0.0
-	 */
-	public function deleteAppValue(string $key): void {
-		$this->appConfig->deleteKey($this->appName, $key);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @param string $key the key of the value, under which it was saved
+     * @since 20.0.0
+     */
+    public function deleteAppValue(string $key): void {
+        $this->appConfig->deleteKey($this->appName, $key);
+    }
 
-	/**
-	 * @inheritDoc
-	 *
-	 * @since 20.0.0
-	 */
-	public function deleteAppValues(): void {
-		$this->appConfig->deleteApp($this->appName);
-	}
+    /**
+     * @inheritDoc
+     *
+     * @since 20.0.0
+     */
+    public function deleteAppValues(): void {
+        $this->appConfig->deleteApp($this->appName);
+    }
 
-	public function setUserValue(string $userId, string $key, string $value, ?string $preCondition = null): void {
-		$this->config->setUserValue($userId, $this->appName, $key, $value, $preCondition);
-	}
+    public function setUserValue(string $userId, string $key, string $value, ?string $preCondition = null): void {
+        $this->config->setUserValue($userId, $this->appName, $key, $value, $preCondition);
+    }
 
-	public function getUserValue(string $userId, string $key, string $default = ''): string {
-		return $this->config->getUserValue($userId, $this->appName, $key, $default);
-	}
+    public function getUserValue(string $userId, string $key, string $default = ''): string {
+        return $this->config->getUserValue($userId, $this->appName, $key, $default);
+    }
 
-	public function deleteUserValue(string $userId, string $key): void {
-		$this->config->deleteUserValue($userId, $this->appName, $key);
-	}
+    public function deleteUserValue(string $userId, string $key): void {
+        $this->config->deleteUserValue($userId, $this->appName, $key);
+    }
 
-	/**
-	 * Returns the installed versions of all apps
-	 *
-	 * @return array<string, string>
-	 */
-	public function getAppInstalledVersions(bool $onlyEnabled = false): array {
-		return $this->appConfig->getAppInstalledVersions($onlyEnabled);
-	}
+    /**
+     * Returns the installed versions of all apps
+     *
+     * @return array<string, string>
+     */
+    public function getAppInstalledVersions(bool $onlyEnabled = false): array {
+        return $this->appConfig->getAppInstalledVersions($onlyEnabled);
+    }
 }

lib/public/App/IAppManager.php

Indentation +321 added lines, -321 removed lines

@@ -19,325 +19,325 @@
  * @since 8.0.0
  */
 interface IAppManager {
-	/**
-	 * @since 30.0.0
-	 */
-	public const BACKEND_CALDAV = 'caldav';
-
-	/**
-	 * Returns the app information from "appinfo/info.xml" for an app
-	 *
-	 * @param string|null $lang
-	 * @return array|null
-	 * @since 14.0.0
-	 * @since 31.0.0 Usage of $path is discontinued and throws an \InvalidArgumentException, use {@see self::getAppInfoByPath} instead.
-	 */
-	public function getAppInfo(string $appId, bool $path = false, $lang = null);
-
-	/**
-	 * Returns the app information from a given path ending with "/appinfo/info.xml"
-	 *
-	 * @since 31.0.0
-	 */
-	public function getAppInfoByPath(string $path, ?string $lang = null): ?array;
-
-	/**
-	 * Returns the app information from "appinfo/info.xml".
-	 *
-	 * @param string $appId
-	 * @param bool $useCache
-	 * @return string
-	 * @since 14.0.0
-	 */
-	public function getAppVersion(string $appId, bool $useCache = true): string;
-
-	/**
-	 * Returns the installed version of all apps
-	 *
-	 * @return array<string, string>
-	 * @since 32.0.0
-	 */
-	public function getAppInstalledVersions(bool $onlyEnabled = false): array;
-
-	/**
-	 * Returns the app icon or null if none is found
-	 *
-	 * @param string $appId
-	 * @param bool $dark Enable to request a dark icon variant, default is a white icon
-	 * @return string|null
-	 * @since 29.0.0
-	 */
-	public function getAppIcon(string $appId, bool $dark = false): ?string;
-
-	/**
-	 * Check if an app is enabled for user
-	 *
-	 * @param string $appId
-	 * @param \OCP\IUser|null $user (optional) if not defined, the currently loggedin user will be used
-	 * @return bool
-	 * @since 8.0.0
-	 */
-	public function isEnabledForUser($appId, $user = null);
-
-	/**
-	 * Check if an app is enabled in the instance
-	 *
-	 * Notice: This actually checks if the app is enabled and not only if it is installed.
-	 *
-	 * @param string $appId
-	 * @return bool
-	 * @since 8.0.0
-	 * @deprecated 32.0.0 Use either {@see self::isEnabledForUser} or {@see self::isEnabledForAnyone}
-	 */
-	public function isInstalled($appId);
-
-	/**
-	 * Check if an app is enabled in the instance, either for everyone or for specific groups
-	 *
-	 * @since 32.0.0
-	 */
-	public function isEnabledForAnyone(string $appId): bool;
-
-	/**
-	 * Check if an app should be enabled by default
-	 *
-	 * Notice: This actually checks if the app should be enabled by default
-	 * and not if currently installed/enabled
-	 *
-	 * @param string $appId ID of the app
-	 * @since 25.0.0
-	 */
-	public function isDefaultEnabled(string $appId):bool;
-
-	/**
-	 * Load an app, if not already loaded
-	 * @param string $app app id
-	 * @since 27.0.0
-	 */
-	public function loadApp(string $app): void;
-
-	/**
-	 * Check if an app is loaded
-	 * @param string $app app id
-	 * @since 27.0.0
-	 */
-	public function isAppLoaded(string $app): bool;
-
-	/**
-	 * Enable an app for every user
-	 *
-	 * @param string $appId
-	 * @param bool $forceEnable
-	 * @throws AppPathNotFoundException
-	 * @since 8.0.0
-	 */
-	public function enableApp(string $appId, bool $forceEnable = false): void;
-
-	/**
-	 * Whether a list of types contains a protected app type
-	 *
-	 * @param string[] $types
-	 * @return bool
-	 * @since 12.0.0
-	 */
-	public function hasProtectedAppType($types);
-
-	/**
-	 * Enable an app only for specific groups
-	 *
-	 * @param string $appId
-	 * @param \OCP\IGroup[] $groups
-	 * @param bool $forceEnable
-	 * @throws \Exception
-	 * @since 8.0.0
-	 */
-	public function enableAppForGroups(string $appId, array $groups, bool $forceEnable = false): void;
-
-	/**
-	 * Disable an app for every user
-	 *
-	 * @param string $appId
-	 * @param bool $automaticDisabled
-	 * @since 8.0.0
-	 */
-	public function disableApp($appId, $automaticDisabled = false): void;
-
-	/**
-	 * Get the directory for the given app.
-	 *
-	 * @since 11.0.0
-	 * @throws AppPathNotFoundException
-	 */
-	public function getAppPath(string $appId): string;
-
-	/**
-	 * Get the web path for the given app.
-	 *
-	 * @param string $appId
-	 * @return string
-	 * @since 18.0.0
-	 * @throws AppPathNotFoundException
-	 */
-	public function getAppWebPath(string $appId): string;
-
-	/**
-	 * List all apps enabled for a user
-	 *
-	 * @param \OCP\IUser $user
-	 * @return string[]
-	 * @since 8.1.0
-	 */
-	public function getEnabledAppsForUser(IUser $user);
-
-	/**
-	 * List all installed apps
-	 *
-	 * @return string[]
-	 * @since 8.1.0
-	 * @deprecated 32.0.0 Use either {@see self::getEnabledApps} or {@see self::getEnabledAppsForUser}
-	 */
-	public function getInstalledApps();
-
-	/**
-	 * List all apps enabled, either for everyone or for specific groups only
-	 *
-	 * @return list<string>
-	 * @since 32.0.0
-	 */
-	public function getEnabledApps(): array;
-
-	/**
-	 * Clear the cached list of apps when enabling/disabling an app
-	 * @since 8.1.0
-	 */
-	public function clearAppsCache(): void;
-
-	/**
-	 * @param string $appId
-	 * @return boolean
-	 * @since 9.0.0
-	 */
-	public function isShipped($appId);
-
-	/**
-	 * Loads all apps
-	 *
-	 * @param string[] $types
-	 * @return bool
-	 *
-	 * This function walks through the Nextcloud directory and loads all apps
-	 * it can find. A directory contains an app if the file `/appinfo/info.xml`
-	 * exists.
-	 *
-	 * if $types is set to non-empty array, only apps of those types will be loaded
-	 * @since 27.0.0
-	 */
-	public function loadApps(array $types = []): bool;
-
-	/**
-	 * Check if an app is of a specific type
-	 * @since 27.0.0
-	 */
-	public function isType(string $app, array $types): bool;
-
-	/**
-	 * @return string[]
-	 * @since 9.0.0
-	 */
-	public function getAlwaysEnabledApps();
-
-	/**
-	 * @return string[] app IDs
-	 * @since 25.0.0
-	 */
-	public function getDefaultEnabledApps(): array;
-
-	/**
-	 * @param \OCP\IGroup $group
-	 * @return String[]
-	 * @since 17.0.0
-	 */
-	public function getEnabledAppsForGroup(IGroup $group): array;
-
-	/**
-	 * @param String $appId
-	 * @return string[]
-	 * @since 17.0.0
-	 */
-	public function getAppRestriction(string $appId): array;
-
-	/**
-	 * Returns the id of the user's default app
-	 *
-	 * If `user` is not passed, the currently logged in user will be used
-	 *
-	 * @param ?IUser $user User to query default app for
-	 * @param bool $withFallbacks Include fallback values if no default app was configured manually
-	 *                            Before falling back to predefined default apps,
-	 *                            the user defined app order is considered and the first app would be used as the fallback.
-	 *
-	 * @since 25.0.6
-	 * @since 28.0.0 Added optional $withFallbacks parameter
-	 * @deprecated 31.0.0
-	 * Use @see \OCP\INavigationManager::getDefaultEntryIdForUser() instead
-	 */
-	public function getDefaultAppForUser(?IUser $user = null, bool $withFallbacks = true): string;
-
-	/**
-	 * Get the global default apps with fallbacks
-	 *
-	 * @return string[] The default applications
-	 * @since 28.0.0
-	 * @deprecated 31.0.0
-	 * Use @see \OCP\INavigationManager::getDefaultEntryIds() instead
-	 */
-	public function getDefaultApps(): array;
-
-	/**
-	 * Set the global default apps with fallbacks
-	 *
-	 * @param string[] $defaultApps
-	 * @throws \InvalidArgumentException If any of the apps is not installed
-	 * @since 28.0.0
-	 * @deprecated 31.0.0
-	 * Use @see \OCP\INavigationManager::setDefaultEntryIds() instead
-	 */
-	public function setDefaultApps(array $defaultApps): void;
-
-	/**
-	 * Check whether the given backend is required by at least one app.
-	 *
-	 * @param self::BACKEND_* $backend Name of the backend, one of `self::BACKEND_*`
-	 * @return bool True if at least one app requires the backend
-	 *
-	 * @since 30.0.0
-	 */
-	public function isBackendRequired(string $backend): bool;
-
-	/**
-	 * Clean the appId from forbidden characters
-	 *
-	 * @psalm-taint-escape callable
-	 * @psalm-taint-escape cookie
-	 * @psalm-taint-escape file
-	 * @psalm-taint-escape has_quotes
-	 * @psalm-taint-escape header
-	 * @psalm-taint-escape html
-	 * @psalm-taint-escape include
-	 * @psalm-taint-escape ldap
-	 * @psalm-taint-escape shell
-	 * @psalm-taint-escape sql
-	 * @psalm-taint-escape unserialize
-	 *
-	 * @since 31.0.0
-	 */
-	public function cleanAppId(string $app): string;
-
-	/**
-	 * Get a list of all apps in the apps folder
-	 *
-	 * @return list<string> an array of app names (string IDs)
-	 * @since 31.0.0
-	 */
-	public function getAllAppsInAppsFolders(): array;
+    /**
+     * @since 30.0.0
+     */
+    public const BACKEND_CALDAV = 'caldav';
+
+    /**
+     * Returns the app information from "appinfo/info.xml" for an app
+     *
+     * @param string|null $lang
+     * @return array|null
+     * @since 14.0.0
+     * @since 31.0.0 Usage of $path is discontinued and throws an \InvalidArgumentException, use {@see self::getAppInfoByPath} instead.
+     */
+    public function getAppInfo(string $appId, bool $path = false, $lang = null);
+
+    /**
+     * Returns the app information from a given path ending with "/appinfo/info.xml"
+     *
+     * @since 31.0.0
+     */
+    public function getAppInfoByPath(string $path, ?string $lang = null): ?array;
+
+    /**
+     * Returns the app information from "appinfo/info.xml".
+     *
+     * @param string $appId
+     * @param bool $useCache
+     * @return string
+     * @since 14.0.0
+     */
+    public function getAppVersion(string $appId, bool $useCache = true): string;
+
+    /**
+     * Returns the installed version of all apps
+     *
+     * @return array<string, string>
+     * @since 32.0.0
+     */
+    public function getAppInstalledVersions(bool $onlyEnabled = false): array;
+
+    /**
+     * Returns the app icon or null if none is found
+     *
+     * @param string $appId
+     * @param bool $dark Enable to request a dark icon variant, default is a white icon
+     * @return string|null
+     * @since 29.0.0
+     */
+    public function getAppIcon(string $appId, bool $dark = false): ?string;
+
+    /**
+     * Check if an app is enabled for user
+     *
+     * @param string $appId
+     * @param \OCP\IUser|null $user (optional) if not defined, the currently loggedin user will be used
+     * @return bool
+     * @since 8.0.0
+     */
+    public function isEnabledForUser($appId, $user = null);
+
+    /**
+     * Check if an app is enabled in the instance
+     *
+     * Notice: This actually checks if the app is enabled and not only if it is installed.
+     *
+     * @param string $appId
+     * @return bool
+     * @since 8.0.0
+     * @deprecated 32.0.0 Use either {@see self::isEnabledForUser} or {@see self::isEnabledForAnyone}
+     */
+    public function isInstalled($appId);
+
+    /**
+     * Check if an app is enabled in the instance, either for everyone or for specific groups
+     *
+     * @since 32.0.0
+     */
+    public function isEnabledForAnyone(string $appId): bool;
+
+    /**
+     * Check if an app should be enabled by default
+     *
+     * Notice: This actually checks if the app should be enabled by default
+     * and not if currently installed/enabled
+     *
+     * @param string $appId ID of the app
+     * @since 25.0.0
+     */
+    public function isDefaultEnabled(string $appId):bool;
+
+    /**
+     * Load an app, if not already loaded
+     * @param string $app app id
+     * @since 27.0.0
+     */
+    public function loadApp(string $app): void;
+
+    /**
+     * Check if an app is loaded
+     * @param string $app app id
+     * @since 27.0.0
+     */
+    public function isAppLoaded(string $app): bool;
+
+    /**
+     * Enable an app for every user
+     *
+     * @param string $appId
+     * @param bool $forceEnable
+     * @throws AppPathNotFoundException
+     * @since 8.0.0
+     */
+    public function enableApp(string $appId, bool $forceEnable = false): void;
+
+    /**
+     * Whether a list of types contains a protected app type
+     *
+     * @param string[] $types
+     * @return bool
+     * @since 12.0.0
+     */
+    public function hasProtectedAppType($types);
+
+    /**
+     * Enable an app only for specific groups
+     *
+     * @param string $appId
+     * @param \OCP\IGroup[] $groups
+     * @param bool $forceEnable
+     * @throws \Exception
+     * @since 8.0.0
+     */
+    public function enableAppForGroups(string $appId, array $groups, bool $forceEnable = false): void;
+
+    /**
+     * Disable an app for every user
+     *
+     * @param string $appId
+     * @param bool $automaticDisabled
+     * @since 8.0.0
+     */
+    public function disableApp($appId, $automaticDisabled = false): void;
+
+    /**
+     * Get the directory for the given app.
+     *
+     * @since 11.0.0
+     * @throws AppPathNotFoundException
+     */
+    public function getAppPath(string $appId): string;
+
+    /**
+     * Get the web path for the given app.
+     *
+     * @param string $appId
+     * @return string
+     * @since 18.0.0
+     * @throws AppPathNotFoundException
+     */
+    public function getAppWebPath(string $appId): string;
+
+    /**
+     * List all apps enabled for a user
+     *
+     * @param \OCP\IUser $user
+     * @return string[]
+     * @since 8.1.0
+     */
+    public function getEnabledAppsForUser(IUser $user);
+
+    /**
+     * List all installed apps
+     *
+     * @return string[]
+     * @since 8.1.0
+     * @deprecated 32.0.0 Use either {@see self::getEnabledApps} or {@see self::getEnabledAppsForUser}
+     */
+    public function getInstalledApps();
+
+    /**
+     * List all apps enabled, either for everyone or for specific groups only
+     *
+     * @return list<string>
+     * @since 32.0.0
+     */
+    public function getEnabledApps(): array;
+
+    /**
+     * Clear the cached list of apps when enabling/disabling an app
+     * @since 8.1.0
+     */
+    public function clearAppsCache(): void;
+
+    /**
+     * @param string $appId
+     * @return boolean
+     * @since 9.0.0
+     */
+    public function isShipped($appId);
+
+    /**
+     * Loads all apps
+     *
+     * @param string[] $types
+     * @return bool
+     *
+     * This function walks through the Nextcloud directory and loads all apps
+     * it can find. A directory contains an app if the file `/appinfo/info.xml`
+     * exists.
+     *
+     * if $types is set to non-empty array, only apps of those types will be loaded
+     * @since 27.0.0
+     */
+    public function loadApps(array $types = []): bool;
+
+    /**
+     * Check if an app is of a specific type
+     * @since 27.0.0
+     */
+    public function isType(string $app, array $types): bool;
+
+    /**
+     * @return string[]
+     * @since 9.0.0
+     */
+    public function getAlwaysEnabledApps();
+
+    /**
+     * @return string[] app IDs
+     * @since 25.0.0
+     */
+    public function getDefaultEnabledApps(): array;
+
+    /**
+     * @param \OCP\IGroup $group
+     * @return String[]
+     * @since 17.0.0
+     */
+    public function getEnabledAppsForGroup(IGroup $group): array;
+
+    /**
+     * @param String $appId
+     * @return string[]
+     * @since 17.0.0
+     */
+    public function getAppRestriction(string $appId): array;
+
+    /**
+     * Returns the id of the user's default app
+     *
+     * If `user` is not passed, the currently logged in user will be used
+     *
+     * @param ?IUser $user User to query default app for
+     * @param bool $withFallbacks Include fallback values if no default app was configured manually
+     *                            Before falling back to predefined default apps,
+     *                            the user defined app order is considered and the first app would be used as the fallback.
+     *
+     * @since 25.0.6
+     * @since 28.0.0 Added optional $withFallbacks parameter
+     * @deprecated 31.0.0
+     * Use @see \OCP\INavigationManager::getDefaultEntryIdForUser() instead
+     */
+    public function getDefaultAppForUser(?IUser $user = null, bool $withFallbacks = true): string;
+
+    /**
+     * Get the global default apps with fallbacks
+     *
+     * @return string[] The default applications
+     * @since 28.0.0
+     * @deprecated 31.0.0
+     * Use @see \OCP\INavigationManager::getDefaultEntryIds() instead
+     */
+    public function getDefaultApps(): array;
+
+    /**
+     * Set the global default apps with fallbacks
+     *
+     * @param string[] $defaultApps
+     * @throws \InvalidArgumentException If any of the apps is not installed
+     * @since 28.0.0
+     * @deprecated 31.0.0
+     * Use @see \OCP\INavigationManager::setDefaultEntryIds() instead
+     */
+    public function setDefaultApps(array $defaultApps): void;
+
+    /**
+     * Check whether the given backend is required by at least one app.
+     *
+     * @param self::BACKEND_* $backend Name of the backend, one of `self::BACKEND_*`
+     * @return bool True if at least one app requires the backend
+     *
+     * @since 30.0.0
+     */
+    public function isBackendRequired(string $backend): bool;
+
+    /**
+     * Clean the appId from forbidden characters
+     *
+     * @psalm-taint-escape callable
+     * @psalm-taint-escape cookie
+     * @psalm-taint-escape file
+     * @psalm-taint-escape has_quotes
+     * @psalm-taint-escape header
+     * @psalm-taint-escape html
+     * @psalm-taint-escape include
+     * @psalm-taint-escape ldap
+     * @psalm-taint-escape shell
+     * @psalm-taint-escape sql
+     * @psalm-taint-escape unserialize
+     *
+     * @since 31.0.0
+     */
+    public function cleanAppId(string $app): string;
+
+    /**
+     * Get a list of all apps in the apps folder
+     *
+     * @return list<string> an array of app names (string IDs)
+     * @since 31.0.0
+     */
+    public function getAllAppsInAppsFolders(): array;
 }

lib/public/IAppConfig.php

Indentation +485 added lines, -485 removed lines

@@ -30,489 +30,489 @@
  * @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
-
-	/**
-	 * 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
-	 * @since 29.0.0
-	 */
-	public function getKeys(string $app): 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;
-
-	/**
-	 * 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
+
+    /**
+     * 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
+     * @since 29.0.0
+     */
+    public function getKeys(string $app): 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;
+
+    /**
+     * 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;
 }

lib/public/Route/IRoute.php

Indentation +77 added lines, -77 removed lines

@@ -13,90 +13,90 @@
  * @since 7.0.0
  */
 interface IRoute {
-	/**
-	 * Specify PATCH as the method to use with this route
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function patch();
+    /**
+     * Specify PATCH as the method to use with this route
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function patch();
 
-	/**
-	 * Specify the method when this route is to be used
-	 *
-	 * @param string $method HTTP method (uppercase)
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function method($method);
+    /**
+     * Specify the method when this route is to be used
+     *
+     * @param string $method HTTP method (uppercase)
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function method($method);
 
-	/**
-	 * The action to execute when this route matches, includes a file like
-	 * it is called directly
-	 *
-	 * @param string $file
-	 * @return $this
-	 * @since 7.0.0
-	 * @deprecated 32.0.0 Use a proper controller instead
-	 */
-	public function actionInclude($file);
+    /**
+     * The action to execute when this route matches, includes a file like
+     * it is called directly
+     *
+     * @param string $file
+     * @return $this
+     * @since 7.0.0
+     * @deprecated 32.0.0 Use a proper controller instead
+     */
+    public function actionInclude($file);
 
-	/**
-	 * Specify GET as the method to use with this route
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function get();
+    /**
+     * Specify GET as the method to use with this route
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function get();
 
-	/**
-	 * Specify POST as the method to use with this route
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function post();
+    /**
+     * Specify POST as the method to use with this route
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function post();
 
-	/**
-	 * Specify DELETE as the method to use with this route
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function delete();
+    /**
+     * Specify DELETE as the method to use with this route
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function delete();
 
-	/**
-	 * The action to execute when this route matches
-	 *
-	 * @param string|callable $class the class or a callable
-	 * @param string $function the function to use with the class
-	 * @return \OCP\Route\IRoute
-	 *
-	 * This function is called with $class set to a callable or
-	 * to the class with $function
-	 * @since 7.0.0
-	 * @deprecated 32.0.0 Use a proper controller instead
-	 */
-	public function action($class, $function = null);
+    /**
+     * The action to execute when this route matches
+     *
+     * @param string|callable $class the class or a callable
+     * @param string $function the function to use with the class
+     * @return \OCP\Route\IRoute
+     *
+     * This function is called with $class set to a callable or
+     * to the class with $function
+     * @since 7.0.0
+     * @deprecated 32.0.0 Use a proper controller instead
+     */
+    public function action($class, $function = null);
 
-	/**
-	 * Defaults to use for this route
-	 *
-	 * @param array $defaults The defaults
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function defaults($defaults);
+    /**
+     * Defaults to use for this route
+     *
+     * @param array $defaults The defaults
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function defaults($defaults);
 
-	/**
-	 * Requirements for this route
-	 *
-	 * @param array $requirements The requirements
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function requirements($requirements);
+    /**
+     * Requirements for this route
+     *
+     * @param array $requirements The requirements
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function requirements($requirements);
 
-	/**
-	 * Specify PUT as the method to use with this route
-	 * @return \OCP\Route\IRoute
-	 * @since 7.0.0
-	 */
-	public function put();
+    /**
+     * Specify PUT as the method to use with this route
+     * @return \OCP\Route\IRoute
+     * @since 7.0.0
+     */
+    public function put();
 }