[DOC] Events

Author: GianfriAur

README.md

@@ -198,6 +198,37 @@ Event::listen(DataChangeReceived::class, function (DataChangeReceived $e) {
 php artisan opcua:session  # connects, subscribes, publishes — all automatic
 ```
 
+### React to events
+
+47 PSR-14 events are dispatched automatically — connections, reads, writes, alarms, subscriptions, cache, retries. Just register listeners:
+
+```php
+use Illuminate\Support\Facades\Event;
+use PhpOpcua\Client\Event\ClientConnected;
+use PhpOpcua\Client\Event\NodeValueWriteFailed;
+use PhpOpcua\Client\Event\AlarmActivated;
+
+// Log connections
+Event::listen(ClientConnected::class, function ($e) {
+    logger()->info("Connected to {$e->endpointUrl}");
+});
+
+// Track write failures
+Event::listen(NodeValueWriteFailed::class, function ($e) {
+    logger()->warning("Write failed on {$e->nodeId}: 0x" . dechex($e->statusCode));
+});
+
+// Alert operators on alarms
+Event::listen(AlarmActivated::class, function ($e) {
+    Notification::send(
+        User::role('operator')->get(),
+        new AlarmTriggered($e->sourceName, $e->severity, $e->message),
+    );
+});
+```
+
+See [Events documentation](doc/11-events.md) for the full reference of all 47 events.
+
 ### Switch connections
 
 ```php
@@ -276,6 +307,7 @@ echo $mock->callCount('read'); // 1
 | 08 | [Testing](doc/08-testing.md) | MockClient, DataValue factories, unit and integration tests |
 | 09 | [Examples](doc/09-examples.md) | Complete code examples for all features |
 | 10 | [Auto-Publish & Monitoring](doc/10-auto-publish.md) | Auto-publish, auto-connect, event listeners, real-world use case |
+| 11 | [Events](doc/11-events.md) | All 47 PSR-14 events, Laravel listeners, queued handlers, practical examples |
 
 ## Testing
 

doc/10-auto-publish.md

@@ -8,34 +8,34 @@ Auto-publish eliminates the need for manual `publish()` loops when using OPC UA
 
 ```
 ┌──────────────────────────────────────────────────────────────────────────┐
-│                         Laravel Application                             │
+│                         Laravel Application                              │
 │                                                                          │
-│  EventServiceProvider                                                   │
-│    Event::listen(DataChangeReceived::class, ...)                        │
-│    Event::listen(AlarmActivated::class, ...)                            │
+│  EventServiceProvider                                                    │
+│    Event::listen(DataChangeReceived::class, ...)                         │
+│    Event::listen(AlarmActivated::class, ...)                             │
 │                                                                          │
-│  config/opcua.php                                                       │
-│    auto_publish: true                                                   │
+│  config/opcua.php                                                        │
+│    auto_publish: true                                                    │
 │    connections:                                                          │
-│      plc-1: { auto_connect: true, subscriptions: [...] }                │
-│      historian: { }  ← on-demand only                                   │
+│      plc-1: { auto_connect: true, subscriptions: [...] }                 │
+│      historian: { }  ← on-demand only                                    │
 │                                                                          │
 ├──────────────────────────────────────────────────────────────────────────┤
-│  php artisan opcua:session                                              │
+│  php artisan opcua:session                                               │
 │                                                                          │
-│  Daemon (ReactPHP event loop)                                           │
-│    ├── Auto-connect: plc-1 → TCP → OPC UA Server                       │
-│    ├── Create subscriptions + monitored items                           │
-│    ├── AutoPublisher:                                                   │
-│    │     ├── Timer → publish() → events dispatched                      │
-│    │     ├── Acknowledgements tracked                                   │
-│    │     └── Recovery on connection errors                              │
-│    └── IPC socket for runtime requests                                  │
+│  Daemon (ReactPHP event loop)                                            │
+│    ├── Auto-connect: plc-1 → TCP → OPC UA Server                         │
+│    ├── Create subscriptions + monitored items                            │
+│    ├── AutoPublisher:                                                    │
+│    │     ├── Timer → publish() → events dispatched                       │
+│    │     ├── Acknowledgements tracked                                    │
+│    │     └── Recovery on connection errors                               │
+│    └── IPC socket for runtime requests                                   │
 │                                                                          │
-│  Events dispatched:                                                     │
-│    DataChangeReceived → Laravel listener → DB / notification / etc.    │
-│    AlarmActivated → Laravel listener → alert operators                  │
-│    SubscriptionKeepAlive → (optional logging)                           │
+│  Events dispatched:                                                      │
+│    DataChangeReceived → Laravel listener → DB / notification / etc.      │
+│    AlarmActivated → Laravel listener → alert operators                   │
+│    SubscriptionKeepAlive → (optional logging)                            │
 └──────────────────────────────────────────────────────────────────────────┘
 ```
 
@@ -555,7 +555,7 @@ Starting OPC UA Session Manager...
 +---------------------+----------------------------------------------+
 | Setting             | Value                                        |
 +---------------------+----------------------------------------------+
-| Socket              | storage/app/opcua-session-manager.sock        |
+| Socket              | storage/app/opcua-session-manager.sock       |
 | Timeout             | 600s                                         |
 | Auth Token          | configured                                   |
 | Auto-publish        | enabled                                      |