document event stream customization

Author: taylorotwell

responses.md

@@ -417,7 +417,18 @@ Route::get('/chat', function () {
 });
 ```
 
-This event stream may be consumed via an [EventSource](https://developer.mozilla.org/en-US/docs/Web/API/EventSource) object by your application's frontend. The `eventStream` method will automatically send a `</stream>` update to the event stream when the stream is complete:
+If you would like to customize the name of the event, you may yield an instance of the `StreamedEvent` class:
+
+```php
+use Illuminate\Http\StreamedEvent;
+
+yield new StreamedEvent(
+    event: 'update',
+    data: $response->choices[0],
+);
+```
+
+Event streams may be consumed via an [EventSource](https://developer.mozilla.org/en-US/docs/Web/API/EventSource) object by your application's frontend. The `eventStream` method will automatically send a `</stream>` update to the event stream when the stream is complete:
 
 ```js
 const source = new EventSource('/chat');
@@ -433,6 +444,14 @@ source.addEventListener('update', (event) => {
 })
 ```
 
+To customize the final event that is sent to the event stream, you may provide a `StreamedEvent` instance to the `eventStream` method's `endStreamWith` argument:
+
+```php
+return response()->eventStream(function () {
+    // ...
+}, endStreamWith: new StreamedEvent(event: 'update', data: '</stream>'));
+```
+
 <a name="streamed-downloads"></a>
 #### Streamed Downloads