feat(specs): add with transformation helpers (generated)

algolia/api-clients-automation#4931

Co-authored-by: algolia-bot <[email protected]>
Co-authored-by: Clément Vannicatte <[email protected]>

Author: algolia-bot

lib/Model/Ingestion/WatchResponse.php

@@ -258,7 +258,7 @@ public function getData()
     /**
      * Sets data.
      *
-     * @param null|object[] $data when used with discovering or validating sources, the sampled data of your source is returned
+     * @param null|object[] $data This field is always null when used with the Push endpoint. When used for a source discover or source validate run, it will include the sampled data of the source.
      *
      * @return self
      */
@@ -282,7 +282,7 @@ public function getEvents()
     /**
      * Sets events.
      *
-     * @param null|Event[] $events in case of error, observability events will be added to the response, if any
+     * @param null|Event[] $events in case of error, observability events will be added to the response
      *
      * @return self
      */
@@ -306,7 +306,7 @@ public function getMessage()
     /**
      * Sets message.
      *
-     * @param null|string $message a message describing the outcome of a validate run
+     * @param null|string $message a message describing the outcome of the operation that has been ran (push, discover or validate) run
      *
      * @return self
      */