[UPD] rel v4.0.1 & AutoPublisher feature

Author: GianfriAur

CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [4.0.1] - 2026-04-09
+
+### Added
+
+- **Auto-publish.** New `auto_publish` config key in `session_manager` section. When enabled, the daemon automatically calls `publish()` for sessions with active subscriptions and dispatches PSR-14 events (`DataChangeReceived`, `EventNotificationReceived`, `AlarmActivated`, etc.) to Laravel's event system. No manual publish loop required — register listeners in your `EventServiceProvider` to handle notifications.
+- **Per-connection auto-connect.** New `auto_connect` config key per connection. When `true` (and `auto_publish` is enabled), the daemon auto-connects to the endpoint on startup and registers the subscriptions defined in the new `subscriptions` config key. Connections without `auto_connect` are managed imperatively as before.
+- **Declarative subscription config.** New `subscriptions` config key per connection. Define `monitored_items` and `event_monitored_items` directly in `config/opcua.php` — the daemon creates them automatically on startup. Each subscription supports `publishing_interval`, `max_keep_alive_count`, `lifetime_count`, `priority`, and per-item `sampling_interval`, `queue_size`, `client_handle`, `select_fields`.
+- **Event dispatcher injection into daemon.** `SessionCommand` resolves `EventDispatcherInterface` from the Laravel container and passes it to the daemon. All OPC UA client events (47 events) are dispatched through Laravel's event system when auto-publish is active.
+- `SessionCommand::buildAutoConnectConfig()` — reads connections with `auto_connect: true` and builds the daemon's auto-connect configuration.
+- `SessionCommand::mapToDaemonConfig()` — maps Laravel connection config keys (`security_policy`, `timeout`, `client_certificate`, etc.) to the daemon's internal format (`securityPolicy`, `opcuaTimeout`, `clientCertPath`, etc.).
+- `SessionCommand::resolveEventDispatcher()` — resolves `EventDispatcherInterface` from the Laravel container.
+- `SessionCommand::resolveSecurityPolicyUri()` and `resolveSecurityModeValue()` — helper methods for security config mapping.
+- New `.env` variable: `OPCUA_AUTO_PUBLISH`.
+- Auto-publish status displayed in the `opcua:session` startup table.
+- Auto-connect summary displayed before daemon startup when connections are configured.
+- Unit tests for `buildAutoConnectConfig`, `mapToDaemonConfig`, auto-publish flag passing, event dispatcher resolution, auto-connect filtering.
+- New documentation: [Auto-Publish & Monitoring](doc/10-auto-publish.md) with real-world industrial use case.
+
+### Changed
+
+- Updated dependency `php-opcua/opcua-session-manager` from `^4.0.0` to `^4.0.3` (required for auto-publish and auto-connect support).
+- `SessionCommand::createDaemon()` now accepts `?EventDispatcherInterface $clientEventDispatcher` and `bool $autoPublish` parameters.
+
 ## [4.0.0] - 2026-04-7
 
 ### Changed

README.md

@@ -28,6 +28,8 @@ Laravel integration for [OPC UA](https://opcfoundation.org/about/opc-technologie
 - **Laravel-native logging and caching** — your log channel and cache store are automatically injected into every OPC UA client
 - **All OPC UA operations** — browse, read, write, method calls, subscriptions, events, history, path resolution, type discovery
 - **PSR-14 events** — 47 dispatched events covering every OPC UA operation for observability and extensibility
+- **Auto-publish** — daemon monitors subscriptions automatically and dispatches PSR-14 events to your Laravel listeners — no manual publish loop
+- **Auto-connect** — define subscriptions in `config/opcua.php` per connection and the daemon sets them up at startup
 - **Trust store** — certificate trust management with configurable policies and auto-accept modes
 - **Write auto-detection** — omit the type parameter and let the client detect the correct OPC UA type automatically
 
@@ -155,6 +157,46 @@ $client->deleteSubscription($sub->subscriptionId);
 $client->disconnect();
 ```
 
+### Auto-publish — no manual publish loop
+
+With `auto_publish` enabled, the daemon handles subscriptions automatically. Just register Laravel event listeners:
+
+```php
+// config/opcua.php
+'session_manager' => ['auto_publish' => true],
+
+'connections' => [
+    'plc-1' => [
+        'endpoint' => 'opc.tcp://192.168.1.10:4840',
+        'auto_connect' => true,
+        'subscriptions' => [
+            [
+                'publishing_interval' => 500.0,
+                'monitored_items' => [
+                    ['node_id' => 'ns=2;s=Temperature', 'client_handle' => 1],
+                ],
+            ],
+        ],
+    ],
+],
+```
+
+```php
+// EventServiceProvider
+use PhpOpcua\Client\Event\DataChangeReceived;
+
+Event::listen(DataChangeReceived::class, function (DataChangeReceived $e) {
+    DB::table('sensor_readings')->insert([
+        'value' => $e->dataValue->getValue(),
+        'client_handle' => $e->clientHandle,
+    ]);
+});
+```
+
+```bash
+php artisan opcua:session  # connects, subscribes, publishes — all automatic
+```
+
 ### Switch connections
 
 ```php
@@ -205,6 +247,8 @@ echo $mock->callCount('read'); // 1
 | **Read Metadata Cache** | Cached node metadata avoids redundant reads; refresh on demand with `read($nodeId, refresh: true)` |
 | **Trust Store** | `FileTrustStore` with configurable `TrustPolicy`, auto-accept modes, and certificate management |
 | **Type Discovery** | `discoverDataTypes()` auto-detects custom server structures |
+| **Auto-Publish** | Daemon auto-publishes for sessions with subscriptions, dispatches PSR-14 events to Laravel listeners |
+| **Auto-Connect** | Per-connection `auto_connect` with declarative `subscriptions` config — daemon sets up monitoring on startup |
 | **Subscription Management** | `createMonitoredItems()`, `modifyMonitoredItems()`, `setTriggering()`, `transferSubscriptions()` |
 | **MockClient** | Test without a server — register handlers, assert calls |
 | **Timeout & Retry** | Per-connection `timeout`, `auto_retry` via config or fluent API |
@@ -228,6 +272,7 @@ echo $mock->callCount('read'); // 1
 | 07 | [Security](doc/07-security.md) | Policies, modes, certificates, authentication |
 | 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 |
 
 ## Testing
 

composer.json

@@ -12,7 +12,7 @@
     "require": {
         "php": "^8.2",
         "php-opcua/opcua-client": "^4.0.0",
-        "php-opcua/opcua-session-manager": "^4.0.0",
+        "php-opcua/opcua-session-manager": "^4.0.3",
         "psr/event-dispatcher": "^1.0",
         "illuminate/support": "^11.0|^12.0|^13.0",
         "illuminate/console": "^11.0|^12.0|^13.0",

config/opcua.php

@@ -43,6 +43,12 @@
         // Daemon client cache — uses a Laravel cache store.
         // Falls back to Laravel's default cache store when not specified.
         'cache_store' => env('OPCUA_CACHE_STORE', env('CACHE_STORE', 'file')),
+
+        // Auto-publish: when enabled, the daemon automatically calls publish()
+        // for sessions with active subscriptions. Notifications are delivered
+        // via PSR-14 events (DataChangeReceived, EventNotificationReceived,
+        // AlarmActivated, etc.). Register listeners in your EventServiceProvider.
+        'auto_publish' => env('OPCUA_AUTO_PUBLISH', false),
     ],
 
     /*
@@ -95,6 +101,30 @@
 
             // Read metadata cache (v4.0+ — caches non-Value attribute reads)
             'read_metadata_cache' => env('OPCUA_READ_METADATA_CACHE',false),
+
+            // Auto-connect (optional) — when true and auto_publish is enabled,
+            // the daemon connects to this endpoint on startup and registers
+            // the subscriptions defined below.
+            // 'auto_connect' => false,
+
+            // Subscriptions (optional) — auto-registered when auto_connect is true.
+            // Each subscription can have monitored_items and/or event_monitored_items.
+            // 'subscriptions' => [
+            //     [
+            //         'publishing_interval' => 500.0,
+            //         'max_keep_alive_count' => 5,
+            //         'monitored_items' => [
+            //             ['node_id' => 'ns=2;s=Temperature', 'client_handle' => 1],
+            //         ],
+            //         'event_monitored_items' => [
+            //             [
+            //                 'node_id' => 'i=2253',
+            //                 'client_handle' => 10,
+            //                 'select_fields' => ['EventId', 'EventType', 'SourceName', 'Time', 'Message', 'Severity'],
+            //             ],
+            //         ],
+            //     ],
+            // ],
         ],
 
     ],