nextcloud / server

lib/public/Calendar/Room/IManager.php

Indentation +33 added lines, -33 removed lines

@@ -31,41 +31,41 @@
  */
 interface IManager {
 
-	/**
-	 * Registers a room backend
-	 *
-	 * @param string $backendClass
-	 * @return void
-	 * @since 14.0.0
-	 */
-	public function registerBackend(string $backendClass);
+    /**
+     * Registers a room backend
+     *
+     * @param string $backendClass
+     * @return void
+     * @since 14.0.0
+     */
+    public function registerBackend(string $backendClass);
 
-	/**
-	 * Unregisters a room backend
-	 *
-	 * @param string $backendClass
-	 * @return void
-	 * @since 14.0.0
-	 */
-	public function unregisterBackend(string $backendClass);
+    /**
+     * Unregisters a room backend
+     *
+     * @param string $backendClass
+     * @return void
+     * @since 14.0.0
+     */
+    public function unregisterBackend(string $backendClass);
 
-	/**
-	 * @return IBackend[]
-	 * @since 14.0.0
-	 */
-	public function getBackends():array;
+    /**
+     * @return IBackend[]
+     * @since 14.0.0
+     */
+    public function getBackends():array;
 
-	/**
-	 * @param string $backendId
-	 * @return IBackend|null
-	 * @since 14.0.0
-	 */
-	public function getBackend($backendId);
+    /**
+     * @param string $backendId
+     * @return IBackend|null
+     * @since 14.0.0
+     */
+    public function getBackend($backendId);
 
-	/**
-	 * removes all registered backend instances
-	 * @return void
-	 * @since 14.0.0
-	 */
-	public function clear();
+    /**
+     * removes all registered backend instances
+     * @return void
+     * @since 14.0.0
+     */
+    public function clear();
 }

apps/admin_audit/lib/Actions/AppManagement.php

Indentation +28 added lines, -28 removed lines

@@ -26,34 +26,34 @@
 
 class AppManagement extends Action {
 
-	/**
-	 * @param string $appName
-	 */
-	public function enableApp(string $appName) {
-		$this->log('App "%s" enabled',
-			['app' => $appName],
-			['app']
-		);
-	}
+    /**
+     * @param string $appName
+     */
+    public function enableApp(string $appName) {
+        $this->log('App "%s" enabled',
+            ['app' => $appName],
+            ['app']
+        );
+    }
 
-	/**
-	 * @param string $appName
-	 * @param string[] $groups
-	 */
-	public function enableAppForGroups(string $appName, array $groups) {
-		$this->log('App "%1$s" enabled for groups: %2$s',
-			['app' => $appName, 'groups' => implode(', ', $groups)],
-			['app', 'groups']
-		);
-	}
+    /**
+     * @param string $appName
+     * @param string[] $groups
+     */
+    public function enableAppForGroups(string $appName, array $groups) {
+        $this->log('App "%1$s" enabled for groups: %2$s',
+            ['app' => $appName, 'groups' => implode(', ', $groups)],
+            ['app', 'groups']
+        );
+    }
 
-	/**
-	 * @param string $appName
-	 */
-	public function disableApp(string $appName) {
-		$this->log('App "%s" disabled',
-			['app' => $appName],
-			['app']
-		);
-	}
+    /**
+     * @param string $appName
+     */
+    public function disableApp(string $appName) {
+        $this->log('App "%s" disabled',
+            ['app' => $appName],
+            ['app']
+        );
+    }
 }

lib/public/Federation/Exceptions/ProviderAlreadyExistsException.php

Indentation +14 added lines, -14 removed lines

@@ -32,19 +32,19 @@
  */
 class ProviderAlreadyExistsException extends HintException {
 
-	/**
-	 * ProviderAlreadyExistsException constructor.
-	 *
-	 * @since 14.0.0
-	 *
-	 * @param string $newProviderId cloud federation provider ID of the new provider
-	 * @param string $existingProviderName name of cloud federation provider which already use the same ID
-	 */
-	public function __construct($newProviderId, $existingProviderName) {
-		$l = \OC::$server->getL10N('federation');
-		$message = 'ID "' . $newProviderId . '" already used by cloud federation provider "' . $existingProviderName . '"';
-		$hint = $l->t('ID "%1$s" already used by cloud federation provider "%2$s"', [$newProviderId, $existingProviderName]);
-		parent::__construct($message, $hint);
-	}
+    /**
+     * ProviderAlreadyExistsException constructor.
+     *
+     * @since 14.0.0
+     *
+     * @param string $newProviderId cloud federation provider ID of the new provider
+     * @param string $existingProviderName name of cloud federation provider which already use the same ID
+     */
+    public function __construct($newProviderId, $existingProviderName) {
+        $l = \OC::$server->getL10N('federation');
+        $message = 'ID "' . $newProviderId . '" already used by cloud federation provider "' . $existingProviderName . '"';
+        $hint = $l->t('ID "%1$s" already used by cloud federation provider "%2$s"', [$newProviderId, $existingProviderName]);
+        parent::__construct($message, $hint);
+    }
 
 }

lib/public/AppFramework/Utility/ITimeFactory.php

Indentation +12 added lines, -12 removed lines

@@ -31,18 +31,18 @@
  */
 interface ITimeFactory {
 
-	/**
-	 * @return int the result of a call to time()
-	 * @since 8.0.0
-	 */
-	public function getTime(): int;
+    /**
+     * @return int the result of a call to time()
+     * @since 8.0.0
+     */
+    public function getTime(): int;
 
-	/**
-	 * @param string $time
-	 * @param \DateTimeZone $timezone
-	 * @return \DateTime
-	 * @since 15.0.0
-	 */
-	public function getDateTime(string $time = 'now', \DateTimeZone $timezone = null): \DateTime;
+    /**
+     * @param string $time
+     * @param \DateTimeZone $timezone
+     * @return \DateTime
+     * @since 15.0.0
+     */
+    public function getDateTime(string $time = 'now', \DateTimeZone $timezone = null): \DateTime;
 
 }

lib/private/AppFramework/Utility/TimeFactory.php

Indentation +16 added lines, -16 removed lines

@@ -34,21 +34,21 @@
 class TimeFactory implements ITimeFactory {
 
 
-	/**
-	 * @return int the result of a call to time()
-	 */
-	public function getTime(): int {
-		return time();
-	}
-
-	/**
-	 * @param string $time
-	 * @param \DateTimeZone $timezone
-	 * @return \DateTime
-	 * @since 15.0.0
-	 */
-	public function getDateTime(string $time = 'now', \DateTimeZone $timezone = null): \DateTime {
-		return new \DateTime($time, $timezone);
-	}
+    /**
+     * @return int the result of a call to time()
+     */
+    public function getTime(): int {
+        return time();
+    }
+
+    /**
+     * @param string $time
+     * @param \DateTimeZone $timezone
+     * @return \DateTime
+     * @since 15.0.0
+     */
+    public function getDateTime(string $time = 'now', \DateTimeZone $timezone = null): \DateTime {
+        return new \DateTime($time, $timezone);
+    }
 
 }

core/Command/TwoFactorAuth/Enforce.php

Indentation +69 added lines, -69 removed lines

@@ -36,81 +36,81 @@
 
 class Enforce extends Command {
 
-	/** @var MandatoryTwoFactor */
-	private $mandatoryTwoFactor;
+    /** @var MandatoryTwoFactor */
+    private $mandatoryTwoFactor;
 
-	public function __construct(MandatoryTwoFactor $mandatoryTwoFactor) {
-		parent::__construct();
+    public function __construct(MandatoryTwoFactor $mandatoryTwoFactor) {
+        parent::__construct();
 
-		$this->mandatoryTwoFactor = $mandatoryTwoFactor;
-	}
+        $this->mandatoryTwoFactor = $mandatoryTwoFactor;
+    }
 
-	protected function configure() {
-		$this->setName('twofactorauth:enforce');
-		$this->setDescription('Enabled/disable enforced two-factor authentication');
-		$this->addOption(
-			'on',
-			null,
-			InputOption::VALUE_NONE,
-			'enforce two-factor authentication'
-		);
-		$this->addOption(
-			'off',
-			null,
-			InputOption::VALUE_NONE,
-			'don\'t enforce two-factor authenticaton'
-		);
-		$this->addOption(
-			'group',
-			null,
-			InputOption::VALUE_OPTIONAL | InputOption::VALUE_IS_ARRAY,
-			'enforce only for the given group(s)'
-		);
-		$this->addOption(
-			'exclude',
-			null,
-			InputOption::VALUE_OPTIONAL | InputOption::VALUE_IS_ARRAY,
-			'exclude mandatory two-factor auth for the given group(s)'
-		);
-	}
+    protected function configure() {
+        $this->setName('twofactorauth:enforce');
+        $this->setDescription('Enabled/disable enforced two-factor authentication');
+        $this->addOption(
+            'on',
+            null,
+            InputOption::VALUE_NONE,
+            'enforce two-factor authentication'
+        );
+        $this->addOption(
+            'off',
+            null,
+            InputOption::VALUE_NONE,
+            'don\'t enforce two-factor authenticaton'
+        );
+        $this->addOption(
+            'group',
+            null,
+            InputOption::VALUE_OPTIONAL | InputOption::VALUE_IS_ARRAY,
+            'enforce only for the given group(s)'
+        );
+        $this->addOption(
+            'exclude',
+            null,
+            InputOption::VALUE_OPTIONAL | InputOption::VALUE_IS_ARRAY,
+            'exclude mandatory two-factor auth for the given group(s)'
+        );
+    }
 
-	protected function execute(InputInterface $input, OutputInterface $output) {
-		if ($input->getOption('on')) {
-			$enforcedGroups = $input->getOption('group');
-			$excludedGroups = $input->getOption('exclude');
-			$this->mandatoryTwoFactor->setState(new EnforcementState(true, $enforcedGroups, $excludedGroups));
-		} elseif ($input->getOption('off')) {
-			$this->mandatoryTwoFactor->setState(new EnforcementState(false));
-		}
+    protected function execute(InputInterface $input, OutputInterface $output) {
+        if ($input->getOption('on')) {
+            $enforcedGroups = $input->getOption('group');
+            $excludedGroups = $input->getOption('exclude');
+            $this->mandatoryTwoFactor->setState(new EnforcementState(true, $enforcedGroups, $excludedGroups));
+        } elseif ($input->getOption('off')) {
+            $this->mandatoryTwoFactor->setState(new EnforcementState(false));
+        }
 
-		$state = $this->mandatoryTwoFactor->getState();
-		if ($state->isEnforced()) {
-			$this->writeEnforced($output, $state);
-		} else {
-			$this->writeNotEnforced($output);
-		}
-	}
+        $state = $this->mandatoryTwoFactor->getState();
+        if ($state->isEnforced()) {
+            $this->writeEnforced($output, $state);
+        } else {
+            $this->writeNotEnforced($output);
+        }
+    }
 
-	/**
-	 * @param OutputInterface $output
-	 */
-	protected function writeEnforced(OutputInterface $output, EnforcementState $state) {
-		if (empty($state->getEnforcedGroups())) {
-			$message = 'Two-factor authentication is enforced for all users';
-		} else {
-			$message = 'Two-factor authentication is enforced for members of the group(s) ' . implode(', ', $state->getEnforcedGroups());
-		}
-		if (!empty($state->getExcludedGroups())) {
-			$message .= ', except members of ' . implode(', ', $state->getExcludedGroups());
-		}
-		$output->writeln($message);
-	}
+    /**
+     * @param OutputInterface $output
+     */
+    protected function writeEnforced(OutputInterface $output, EnforcementState $state) {
+        if (empty($state->getEnforcedGroups())) {
+            $message = 'Two-factor authentication is enforced for all users';
+        } else {
+            $message = 'Two-factor authentication is enforced for members of the group(s) ' . implode(', ', $state->getEnforcedGroups());
+        }
+        if (!empty($state->getExcludedGroups())) {
+            $message .= ', except members of ' . implode(', ', $state->getExcludedGroups());
+        }
+        $output->writeln($message);
+    }
 
-	/**
-	 * @param OutputInterface $output
-	 */
-	protected function writeNotEnforced(OutputInterface $output) {
-		$output->writeln('Two-factor authentication is not enforced');
-	}
+    /**
+     * @param OutputInterface $output
+     */
+    protected function writeNotEnforced(OutputInterface $output) {
+        $output->writeln('Two-factor authentication is not enforced');
+    }
 
 }

lib/private/Dashboard/DashboardManager.php

Indentation +97 added lines, -97 removed lines

@@ -46,103 +46,103 @@
 class DashboardManager implements IDashboardManager {
 
 
-	/** @var IWidgetsService */
-	private $widgetsService;
-
-	/** @var IEventsService */
-	private $eventsService;
-
-
-	/**
-	 * @param IEventsService $eventsService
-	 */
-	public function registerEventsService(IEventsService $eventsService) {
-		$this->eventsService = $eventsService;
-	}
-
-
-	/**
-	 * @param IWidgetsService $widgetsService
-	 */
-	public function registerWidgetsService(IWidgetsService $widgetsService) {
-		$this->widgetsService = $widgetsService;
-	}
-
-
-	/**
-	 * @param string $widgetId
-	 * @param string $userId
-	 *
-	 * @return IWidgetConfig
-	 * @throws DashboardAppNotAvailableException
-	 */
-	public function getWidgetConfig(string $widgetId, string $userId): IWidgetConfig {
-		return $this->getWidgetsService()->getWidgetConfig($widgetId, $userId);
-	}
-
-
-	/**
-	 * @param string $widgetId
-	 * @param array $users
-	 * @param array $payload
-	 * @param string $uniqueId
-	 *
-	 * @throws DashboardAppNotAvailableException
-	 */
-	public function createUsersEvent(string $widgetId, array $users, array $payload, string $uniqueId = '') {
-		$this->getEventsService()->createUsersEvent($widgetId, $users, $payload, $uniqueId);
-	}
-
-
-	/**
-	 * @param string $widgetId
-	 * @param array $groups
-	 * @param array $payload
-	 * @param string $uniqueId
-	 *
-	 * @throws DashboardAppNotAvailableException
-	 */
-	public function createGroupsEvent(string $widgetId, array $groups, array $payload, string $uniqueId = '') {
-		$this->getEventsService()->createGroupsEvent($widgetId, $groups, $payload, $uniqueId);
-	}
-
-
-	/**
-	 * @param string $widgetId
-	 * @param array $payload
-	 * @param string $uniqueId
-	 *
-	 * @throws DashboardAppNotAvailableException
-	 */
-	public function createGlobalEvent(string $widgetId, array $payload, string $uniqueId = '') {
-		$this->getEventsService()->createGlobalEvent($widgetId, $payload, $uniqueId);
-	}
-
-
-	/**
-	 * @return IWidgetsService
-	 * @throws DashboardAppNotAvailableException
-	 */
-	private function getWidgetsService() {
-		if ($this->widgetsService === null) {
-			throw new DashboardAppNotAvailableException('No IWidgetsService registered');
-		}
-
-		return $this->widgetsService;
-	}
-
-
-	/**
-	 * @return IEventsService
-	 * @throws DashboardAppNotAvailableException
-	 */
-	private function getEventsService() {
-		if ($this->eventsService === null) {
-			throw new DashboardAppNotAvailableException('No IEventsService registered');
-		}
-
-		return $this->eventsService;
-	}
+    /** @var IWidgetsService */
+    private $widgetsService;
+
+    /** @var IEventsService */
+    private $eventsService;
+
+
+    /**
+     * @param IEventsService $eventsService
+     */
+    public function registerEventsService(IEventsService $eventsService) {
+        $this->eventsService = $eventsService;
+    }
+
+
+    /**
+     * @param IWidgetsService $widgetsService
+     */
+    public function registerWidgetsService(IWidgetsService $widgetsService) {
+        $this->widgetsService = $widgetsService;
+    }
+
+
+    /**
+     * @param string $widgetId
+     * @param string $userId
+     *
+     * @return IWidgetConfig
+     * @throws DashboardAppNotAvailableException
+     */
+    public function getWidgetConfig(string $widgetId, string $userId): IWidgetConfig {
+        return $this->getWidgetsService()->getWidgetConfig($widgetId, $userId);
+    }
+
+
+    /**
+     * @param string $widgetId
+     * @param array $users
+     * @param array $payload
+     * @param string $uniqueId
+     *
+     * @throws DashboardAppNotAvailableException
+     */
+    public function createUsersEvent(string $widgetId, array $users, array $payload, string $uniqueId = '') {
+        $this->getEventsService()->createUsersEvent($widgetId, $users, $payload, $uniqueId);
+    }
+
+
+    /**
+     * @param string $widgetId
+     * @param array $groups
+     * @param array $payload
+     * @param string $uniqueId
+     *
+     * @throws DashboardAppNotAvailableException
+     */
+    public function createGroupsEvent(string $widgetId, array $groups, array $payload, string $uniqueId = '') {
+        $this->getEventsService()->createGroupsEvent($widgetId, $groups, $payload, $uniqueId);
+    }
+
+
+    /**
+     * @param string $widgetId
+     * @param array $payload
+     * @param string $uniqueId
+     *
+     * @throws DashboardAppNotAvailableException
+     */
+    public function createGlobalEvent(string $widgetId, array $payload, string $uniqueId = '') {
+        $this->getEventsService()->createGlobalEvent($widgetId, $payload, $uniqueId);
+    }
+
+
+    /**
+     * @return IWidgetsService
+     * @throws DashboardAppNotAvailableException
+     */
+    private function getWidgetsService() {
+        if ($this->widgetsService === null) {
+            throw new DashboardAppNotAvailableException('No IWidgetsService registered');
+        }
+
+        return $this->widgetsService;
+    }
+
+
+    /**
+     * @return IEventsService
+     * @throws DashboardAppNotAvailableException
+     */
+    private function getEventsService() {
+        if ($this->eventsService === null) {
+            throw new DashboardAppNotAvailableException('No IEventsService registered');
+        }
+
+        return $this->eventsService;
+    }
 
 }
 

lib/public/Dashboard/IDashboardWidget.php

Indentation +88 added lines, -88 removed lines

@@ -54,94 +54,94 @@
  */
 interface IDashboardWidget {
 
-	/**
-	 * Should returns the (unique) Id of the widget.
-	 *
-	 * @since 15.0.0
-	 *
-	 * @return string
-	 */
-	public function getId(): string;
-
-
-	/**
-	 * Should returns the [display] name of the widget.
-	 *
-	 * @since 15.0.0
-	 *
-	 * @return string
-	 */
-	public function getName(): string;
-
-
-	/**
-	 * Should returns some text describing the widget.
-	 * This description is displayed in the listing of the available widgets.
-	 *
-	 * @since 15.0.0
-	 *
-	 * @return string
-	 */
-	public function getDescription(): string;
-
-
-	/**
-	 * Must generate and return a WidgetTemplate that define important stuff
-	 * about the Widget: icon, content, css or javascript.
-	 *
-	 * @see WidgetTemplate
-	 *
-	 * @since 15.0.0
-	 *
-	 * @return WidgetTemplate
-	 */
-	public function getWidgetTemplate(): WidgetTemplate;
-
-
-	/**
-	 * Must create and return a WidgetSetup containing the general setup of
-	 * the widget
-	 *
-	 * @see WidgetSetup
-	 *
-	 * @since 15.0.0
-	 *
-	 * @return WidgetSetup
-	 */
-	public function getWidgetSetup(): WidgetSetup;
-
-
-	/**
-	 * This method is called when a widget is loaded on the dashboard.
-	 * A widget is 'loaded on the dashboard' when one of these conditions
-	 * occurs:
-	 *
-	 * - the user is adding the widget on his dashboard,
-	 * - the user already added the widget on his dashboard and he is opening
-	 *   the dashboard app.
-	 *
-	 * @see IWidgetConfig
-	 *
-	 * @since 15.0.0
-	 *
-	 * @param IWidgetConfig $settings
-	 */
-	public function loadWidget(IWidgetConfig $settings);
-
-
-	/**
-	 * This method s executed when the widget call the net.requestWidget()
-	 * from the Javascript API.
-	 *
-	 * This is used by the frontend to communicate with the backend.
-	 *
-	 * @see IWidgetRequest
-	 *
-	 * @since 15.0.0
-	 *
-	 * @param IWidgetRequest $request
-	 */
-	public function requestWidget(IWidgetRequest $request);
+    /**
+     * Should returns the (unique) Id of the widget.
+     *
+     * @since 15.0.0
+     *
+     * @return string
+     */
+    public function getId(): string;
+
+
+    /**
+     * Should returns the [display] name of the widget.
+     *
+     * @since 15.0.0
+     *
+     * @return string
+     */
+    public function getName(): string;
+
+
+    /**
+     * Should returns some text describing the widget.
+     * This description is displayed in the listing of the available widgets.
+     *
+     * @since 15.0.0
+     *
+     * @return string
+     */
+    public function getDescription(): string;
+
+
+    /**
+     * Must generate and return a WidgetTemplate that define important stuff
+     * about the Widget: icon, content, css or javascript.
+     *
+     * @see WidgetTemplate
+     *
+     * @since 15.0.0
+     *
+     * @return WidgetTemplate
+     */
+    public function getWidgetTemplate(): WidgetTemplate;
+
+
+    /**
+     * Must create and return a WidgetSetup containing the general setup of
+     * the widget
+     *
+     * @see WidgetSetup
+     *
+     * @since 15.0.0
+     *
+     * @return WidgetSetup
+     */
+    public function getWidgetSetup(): WidgetSetup;
+
+
+    /**
+     * This method is called when a widget is loaded on the dashboard.
+     * A widget is 'loaded on the dashboard' when one of these conditions
+     * occurs:
+     *
+     * - the user is adding the widget on his dashboard,
+     * - the user already added the widget on his dashboard and he is opening
+     *   the dashboard app.
+     *
+     * @see IWidgetConfig
+     *
+     * @since 15.0.0
+     *
+     * @param IWidgetConfig $settings
+     */
+    public function loadWidget(IWidgetConfig $settings);
+
+
+    /**
+     * This method s executed when the widget call the net.requestWidget()
+     * from the Javascript API.
+     *
+     * This is used by the frontend to communicate with the backend.
+     *
+     * @see IWidgetRequest
+     *
+     * @since 15.0.0
+     *
+     * @param IWidgetRequest $request
+     */
+    public function requestWidget(IWidgetRequest $request);
 
 }
 

lib/public/Dashboard/Model/IWidgetRequest.php

Indentation +84 added lines, -84 removed lines

@@ -48,90 +48,90 @@
  */
 interface IWidgetRequest {
 
-	/**
-	 * Get the widgetId.
-	 *
-	 * @since 15.0.0
-	 *
-	 * @return string
-	 */
-	public function getWidgetId(): string;
-
-
-	/**
-	 * Get the WidgetClass.
-	 *
-	 * @since 15.0.0
-	 *
-	 * @return IDashboardWidget
-	 */
-	public function getWidget(): IDashboardWidget;
-
-
-	/**
-	 * Get the 'request' string sent by the request from the front-end with
-	 * the format:
-	 *
-	 *  net.requestWidget(
-	 *    {
-	 *     widget: widgetId,
-	 *     request: request,
-	 *     value: value
-	 *    },
-	 *    callback);
-	 *
-	 * @since 15.0.0
-	 *
-	 * @return string
-	 */
-	public function getRequest(): string;
-
-
-	/**
-	 * Get the 'value' string sent by the request from the front-end.
-	 *
-	 * @see getRequest
-	 *
-	 * @since 15.0.0
-	 *
-	 * @return string
-	 */
-	public function getValue(): string;
-
-
-	/**
-	 * Returns the result.
-	 *
-	 * @since 15.0.0
-	 *
-	 * @return array
-	 */
-	public function getResult(): array;
-
-
-	/**
-	 * add a result (as string)
-	 *
-	 * @since 15.0.0
-	 *
-	 * @param string $key
-	 * @param string $result
-	 *
-	 * @return $this
-	 */
-	public function addResult(string $key, string $result): IWidgetRequest;
-
-	/**
-	 * add a result (as array)
-	 *
-	 * @since 15.0.0
-	 *
-	 * @param string $key
-	 * @param array $result
-	 *
-	 * @return $this
-	 */
-	public function addResultArray(string $key, array $result): IWidgetRequest;
+    /**
+     * Get the widgetId.
+     *
+     * @since 15.0.0
+     *
+     * @return string
+     */
+    public function getWidgetId(): string;
+
+
+    /**
+     * Get the WidgetClass.
+     *
+     * @since 15.0.0
+     *
+     * @return IDashboardWidget
+     */
+    public function getWidget(): IDashboardWidget;
+
+
+    /**
+     * Get the 'request' string sent by the request from the front-end with
+     * the format:
+     *
+     *  net.requestWidget(
+     *    {
+     *     widget: widgetId,
+     *     request: request,
+     *     value: value
+     *    },
+     *    callback);
+     *
+     * @since 15.0.0
+     *
+     * @return string
+     */
+    public function getRequest(): string;
+
+
+    /**
+     * Get the 'value' string sent by the request from the front-end.
+     *
+     * @see getRequest
+     *
+     * @since 15.0.0
+     *
+     * @return string
+     */
+    public function getValue(): string;
+
+
+    /**
+     * Returns the result.
+     *
+     * @since 15.0.0
+     *
+     * @return array
+     */
+    public function getResult(): array;
+
+
+    /**
+     * add a result (as string)
+     *
+     * @since 15.0.0
+     *
+     * @param string $key
+     * @param string $result
+     *
+     * @return $this
+     */
+    public function addResult(string $key, string $result): IWidgetRequest;
+
+    /**
+     * add a result (as array)
+     *
+     * @since 15.0.0
+     *
+     * @param string $key
+     * @param array $result
+     *
+     * @return $this
+     */
+    public function addResultArray(string $key, array $result): IWidgetRequest;
 
 }