fix: Properly add psalm stubs

Signed-off-by: Ferdinand Thiessen <[email protected]>

lib/Listener/AnalyticsDatasourceListener.php

@@ -18,7 +18,7 @@
 use OCP\EventDispatcher\IEventListener;
 
 /**
- * @template-implements IEventListener<Event|DatasourceEvent>
+ * @template-implements IEventListener<DatasourceEvent>
  */
 class AnalyticsDatasourceListener implements IEventListener {
 	public function handle(Event $event): void {

tests/stubs/OCA-Analytics-IDatasource.php

@@ -1,7 +1,92 @@
 <?php
 
-namespace OCA\Analytics\Datasource;
+namespace OCA\Analytics\Datasource {
 
-interface IDatasource {
-    public function getName(): string;
+	use OCP\EventDispatcher\Event;
+
+	/**
+	 * Class CommentsEntityEvent
+	 *
+	 * @since 9.1.0
+	 */
+	interface DatasourceEvent extends Event {
+
+		/**
+		 * @param string $datasource
+		 * @since 9.1.0
+		 */
+		public function registerDatasource(string $datasource): void;
+
+		/**
+		 * @return \Closure[]
+		 * @since 9.1.0
+		 */
+		public function getDataSources(): array;
+	}
+
+	/**
+	 * Interface IDatasource
+	 *
+	 * @since 3.1.0
+	 */
+	interface IDatasource {
+
+		/**
+		 * @return string Display Name of the datasource
+		 * @since 3.1.0
+		 */
+		public function getName(): string;
+
+		/**
+		 * @return int 2 digit unique datasource id
+		 * @since 3.1.0
+		 */
+		public function getId(): int;
+
+		/**
+		 * available options of the data source
+		 *
+		 * return needs to be an array and can consist of many fields.
+		 * every field needs to provide the following format
+		 *  id          *mandatory*     = name of the option for the readData
+		 *  name        *mandatory*     = displayed name of the input field in the UI
+		 *  type        *optional*      =   'tf' to create a dropdown. Values need to be provided in the placeholder separated with "/".
+		 *                                  'filePicker' will launch the file picker
+		 *                                  'columnPicker' will launch the file picker
+		 *                                  'number' for a number-only input field
+		 *                                  'section' will create a click-able section header and hide all options afterwards per default
+		 *                                  'longtext' will create a text area input
+		 *  placeholder *mandatory*     = help text for the input field in the UI
+		 *                                for type=tf:
+		 *                                  e.g. "true/false"
+		 *                                  if value/text pairs are required for the dropdown/option, the values need to be separated with "-" in addition.
+		 *                                  e.g. "eq-equal/gt-greater"
+		 *                                  to avoid translation of the technical strings, separate them
+		 *                                  'true-' - $this->l10n->t('Yes').'/false-'.$this->l10n->t('No')
+		 *
+		 *  example:
+		 *  {['id' => 'datatype', 'name' => 'Type of Data', 'type' => 'tf', 'placeholder' => 'adaptation/absolute']}
+		 *
+		 * @return array
+		 * @since 3.1.0
+		 */
+		public function getTemplate(): array;
+
+		/**
+		 * Read the Data
+		 *
+		 * return needs to be an array
+		 *  [
+		 *      'header' => $header,  //array('column header 1', 'column header 2','column header 3')
+		 *      'dimensions' => array_slice($header, 0, count($header) - 1),
+		 *      'data' => $data,
+		 *      'error' => 0,         // INT 0 = no error
+		 *  ]
+		 *
+		 * @param $option
+		 * @return array available options of the data source
+		 * @since 3.1.0
+		 */
+		public function readData($option): array;
+	}
 }