improve event processing by adding asynchronous handling for better performance

README.md

@@ -110,15 +110,25 @@ Returns one article by numeric ID. Same usability filter as the list endpoint
 
 ### `GET /events`
 
-Returns a single event and its articles.
+Without `id` — returns a paginated list of events. With `id` — returns a single event and its articles.
 
 #### Query params
 
 | Param | Description |
 |---|---|
-| `id` | Event ID (required) |
+| `id` | Event ID. If present, returns that event with its articles instead of the list |
+| `limit` | Rows to return (list mode only). Default `20`, max `100` |
+| `offset` | Pagination offset (list mode only). Default `0` |
 
-#### Response shape
+#### List response shape
+
+```json
+[
+  { "id": 1, "title": "...", "created_at": "2025-01-01T12:35:10.000Z" }
+]
+```
+
+#### Single event response shape
 
 ```json
 {