[UPD] rel v4.0.0

Author: GianfriAur

.github/ISSUE_TEMPLATE/bug_report.md

@@ -29,7 +29,7 @@ What actually happened. Include error messages or exceptions if applicable.
 
 - PHP version:
 - Library version:
-- opcua-php-client version:
+- opcua-client version:
 - OPC UA server: (e.g., open62541, Prosys, Unified Automation, etc.)
 - OS:
 

.github/ISSUE_TEMPLATE/question.md

@@ -22,5 +22,5 @@ What are you trying to achieve? Include relevant code if applicable.
 
 - PHP version:
 - Library version:
-- opcua-php-client version:
+- opcua-client version:
 - OPC UA server: (e.g., open62541, Prosys, Unified Automation, etc.)

.github/workflows/tests.yml

@@ -31,7 +31,7 @@ jobs:
 
       - name: Start OPC UA test servers
         id: opcua
-        uses: GianfriAur/opcua-test-server-suite@v1.1.4
+        uses: php-opcua/opcua-test-suite@v1.1.5
 
       - name: Run tests
         env:

CHANGELOG.md

@@ -1,10 +1,58 @@
 # Changelog
 
+## [4.0.0] - 2026-03-26
+
+### Rebranding
+
+- **Package renamed** from `php-opcua/opcua-client-session-manager` to `php-opcua/opcua-session-manager`.
+- **Namespace renamed** from `Gianfriaur\OpcuaSessionManager` to `PhpOpcua\SessionManager`. All classes, tests, and configuration updated accordingly.
+- **Dependency renamed** from `gianfriaur/opcua-php-client` to `php-opcua/opcua-client`. Dependency namespace changed from `Gianfriaur\OpcuaPhpClient` to `PhpOpcua\Client`.
+- **Repository moved** to [github.com/php-opcua/opcua-session-manager](https://github.com/php-opcua/opcua-session-manager).
+- All documentation, URLs, composer.json metadata, and code references updated to reflect the new organization.
+
+### Changed
+
+- **Breaking**: Updated dependency `php-opcua/opcua-client` from `^3.0` to `^4.0`.
+- **Breaking**: **ClientBuilder/Client split.** The daemon's `CommandHandler` now uses `ClientBuilder::create()` instead of `new Client()`. All configuration (security, timeout, cache, batching, etc.) is applied to the builder before calling `connect()`, which returns a `Client` instance. This mirrors the upstream v4.0.0 architecture change. No impact on `ManagedClient` consumers — the proxy API remains the same.
+- **Breaking**: `write()` type parameter is now nullable (`?BuiltinType $type = null`). When omitted, the daemon's underlying client auto-detects the node's type by reading it first, then caches the result for subsequent writes. Existing code passing an explicit `BuiltinType` continues to work unchanged.
+- **Breaking**: `writeMulti()` items can now have a nullable `type` field. When `type` is null or omitted, auto-detection is used per-node.
+- `read()` now accepts a third parameter `bool $refresh = false`. When `true`, the daemon bypasses the read metadata cache and forces a server read. Default `false` preserves existing behaviour.
+- Method whitelist expanded from 37 to 45 methods to support all new v4.0.0 operations.
+- `psr/event-dispatcher` ^1.0 added as dependency (interface-only package, zero runtime code).
+
+### Added
+
+- **`modifyMonitoredItems(int $subscriptionId, array $itemsToModify): MonitoredItemModifyResult[]`** — Change sampling interval, queue size, and other parameters on existing monitored items without recreating them. Proxied to the daemon's underlying `Client`. Returns `MonitoredItemModifyResult[]` with revised parameters.
+- **`setTriggering(int $subscriptionId, int $triggeringItemId, array $linksToAdd, array $linksToRemove): SetTriggeringResult`** — Configure a monitored item as a trigger for other items. Linked items are only sampled when the trigger changes. Returns `SetTriggeringResult` with per-link status codes.
+- **Trust store support (daemon-side).** Server certificate validation can now be configured through `ManagedClient`:
+  - `setTrustStorePath(string)` — Set the file-based trust store path. The daemon creates a `FileTrustStore` instance.
+  - `setTrustPolicy(?TrustPolicy)` — Set the validation level: `Fingerprint`, `FingerprintAndExpiry`, or `Full`. Pass `null` to disable.
+  - `autoAccept(bool $enabled, bool $force)` — Enable TOFU (Trust On First Use) for unknown server certificates.
+  - `trustCertificate(string $certDer)` — Manually trust a DER-encoded certificate (proxied to daemon via IPC).
+  - `untrustCertificate(string $fingerprint)` — Remove a certificate from the trust store (proxied to daemon via IPC).
+  - `getTrustPolicy(): ?TrustPolicy` — Get the current trust policy.
+  - `getTrustStore(): ?TrustStoreInterface` — Returns `null` on `ManagedClient` (trust store lives daemon-side).
+- **Write type auto-detection forwarding.** `setAutoDetectWriteType(bool)` on `ManagedClient` configures whether the daemon's `Client` auto-detects write types. Enabled by default.
+- **Read metadata cache forwarding.** `setReadMetadataCache(bool)` on `ManagedClient` enables caching of non-Value attributes (DisplayName, BrowseName, DataType, etc.) on the daemon's `Client`.
+- **PSR-14 Event Dispatcher interface compliance.** `ManagedClient` now exposes `setEventDispatcher(EventDispatcherInterface)` and `getEventDispatcher()`. Events are dispatched locally on the `ManagedClient` side (daemon-side events are handled by the daemon's own dispatcher). Default: `NullEventDispatcher`.
+- `TypeSerializer` now serializes/deserializes `MonitoredItemModifyResult`, `SetTriggeringResult`, and `ExtensionObject` DTOs.
+- `TypeSerializer::deserializeBuiltinType()` now accepts `?int` and returns `?BuiltinType` for nullable write type support.
+- `TypeSerializer` handles `ExtensionObject` values inside `Variant` deserialization.
+- New IPC config keys in the `open` command: `trustStorePath`, `trustPolicy`, `autoAccept`, `autoAcceptForce`, `autoDetectWriteType`, `readMetadataCache`.
+- `CommandHandler` now configures `ClientBuilder` with trust store, trust policy, auto-accept, auto-detect write type, and read metadata cache settings from the IPC `open` command.
+
+### Breaking Changes
+
+- Package name changed: `composer require php-opcua/opcua-session-manager` (was `php-opcua/opcua-client-session-manager`).
+- Namespace changed: `PhpOpcua\SessionManager\` (was `Gianfriaur\OpcuaSessionManager\`).
+- `write()` signature changed from `write(NodeId|string, mixed, BuiltinType)` to `write(NodeId|string, mixed, ?BuiltinType = null)`. The third parameter is now optional.
+- Dependency `php-opcua/opcua-client` ^4.0 required (was `php-opcua/opcua-client` ^3.0).
+
 ## [3.0.0] - 2026-03-23
 
 ### Changed
 
-- **Breaking**: Updated dependency `gianfriaur/opcua-php-client` from `^2.0` to `^3.0`.
+- **Breaking**: Updated dependency `php-opcua/opcua-client` from `^2.0` to `^3.0`.
 - **Breaking**: `nodeClassMask` parameter replaced with `nodeClasses` array. Browse methods (`browse()`, `browseWithContinuation()`, `browseAll()`, `browseRecursive()`) now accept `NodeClass[] $nodeClasses = []` instead of `int $nodeClassMask = 0`. Pass an array of `NodeClass` enum values (e.g. `[NodeClass::Object, NodeClass::Variable]`) instead of a raw bitmask integer. Empty array means all classes (same as the old `0`).
 - **Breaking**: Strict return types for all service responses. The following methods now return typed DTOs instead of associative arrays:
   - `createSubscription()` → `SubscriptionResult` (`->subscriptionId`, `->revisedPublishingInterval`, `->revisedLifetimeCount`, `->revisedMaxKeepAliveCount`)
@@ -15,7 +63,7 @@
   - `publish()` → `PublishResult` (`->subscriptionId`, `->sequenceNumber`, `->moreNotifications`, `->notifications`, `->availableSequenceNumbers`)
   - `translateBrowsePaths()` → `BrowsePathResult[]` (`->statusCode`, `->targets`) with `BrowsePathTarget` (`->targetId`, `->remainingPathIndex`)
 - **Breaking**: Ambiguous `$items` parameters renamed for named parameter clarity: `readMulti($readItems)`, `writeMulti($writeItems)`, `createMonitoredItems($subscriptionId, $monitoredItems)`. Only affects code using named parameters.
-- All `TypeSerializer` getters updated to use `public readonly` properties from `opcua-php-client` v3.0.0 (`$ref->nodeId` instead of `$ref->getNodeId()`, etc.).
+- All `TypeSerializer` getters updated to use `public readonly` properties from `opcua-client` v3.0.0 (`$ref->nodeId` instead of `$ref->getNodeId()`, etc.).
 - `TypeSerializer` now preserves `Variant` multi-dimensional array dimensions through serialization/deserialization roundtrips.
 - Method whitelist expanded from 32 to 37 methods to support all new v3.0.0 operations.
 
@@ -55,7 +103,7 @@
 
 ### Changed
 
-- **Breaking**: Updated dependency `gianfriaur/opcua-php-client` from `^1.1` to `^2.0`.
+- **Breaking**: Updated dependency `php-opcua/opcua-client` from `^1.1` to `^2.0`.
 - **Breaking**: `browse()` and `browseWithContinuation()` `$direction` parameter changed from `int` to `BrowseDirection` enum. Replace raw integers (`0`, `1`) with `BrowseDirection::Forward`, `BrowseDirection::Inverse`, or `BrowseDirection::Both`.
 - Updated CI test server suite from `opcua-test-server-suite@v1.1.2` to `@v1.1.4`.
 - Method whitelist expanded from 18 to 32 methods to support all new v2.0.0 operations.
@@ -81,9 +129,9 @@
 
 ### Changed
 
-- Updated dependency `gianfriaur/opcua-php-client` from `^1.0` to `^1.1`, requiring the new auto-generated certificate feature introduced in that release.
+- Updated dependency `php-opcua/opcua-client` from `^1.0` to `^1.1`, requiring the new auto-generated certificate feature introduced in that release.
 
 ### Added
 
-- **Auto-generated client certificate support.** When a secure connection is opened through the daemon with `SecurityPolicy` and `SecurityMode` configured but no `clientCertPath`/`clientKeyPath` provided, the underlying `Client` automatically generates an in-memory self-signed certificate. The behaviour is transparent and inherited from `opcua-php-client` v1.1 — no changes required in `ManagedClient` or `CommandHandler`.
+- **Auto-generated client certificate support.** When a secure connection is opened through the daemon with `SecurityPolicy` and `SecurityMode` configured but no `clientCertPath`/`clientKeyPath` provided, the underlying `Client` automatically generates an in-memory self-signed certificate. The behaviour is transparent and inherited from `opcua-client` v1.1 — no changes required in `ManagedClient` or `CommandHandler`.
 - Unit and integration tests for the auto-generated certificate flow.

CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# Contributing to OPC UA PHP Client Session Manager
+# Contributing to OPC UA Session Manager
 
 ## Welcome!
 
@@ -13,13 +13,13 @@ If you have any questions or need help getting started, don't hesitate to open a
 - PHP >= 8.2
 - `ext-openssl`
 - Composer
-- [opcua-test-server-suite](https://github.com/GianfriAur/opcua-test-server-suite) (for integration tests)
+- [opcua-test-server-suite](https://github.com/php-opcua/opcua-test-server-suite) (for integration tests)
 
 ### Installation
 
 ```bash
-git clone https://github.com/gianfriaur/opcua-php-client-session-manager.git
-cd opcua-php-client-session-manager
+git clone https://github.com/php-opcua/opcua-session-manager.git
+cd opcua-session-manager
 composer install
 ```
 
@@ -28,7 +28,7 @@ composer install
 Integration tests require the OPC UA test server suite running locally:
 
 ```bash
-git clone https://github.com/GianfriAur/opcua-test-server-suite.git
+git clone https://github.com/php-opcua/opcua-test-server-suite.git
 cd opcua-test-server-suite
 docker compose up -d
 ```
@@ -89,7 +89,7 @@ tests/
 
 ### Transparent IPC Proxy
 
-`ManagedClient` implements `OpcUaClientInterface` from `gianfriaur/opcua-php-client` and proxies every call to the daemon over a Unix socket. The goal is a drop-in replacement: any code using `Client` should work with `ManagedClient` without changes.
+`ManagedClient` implements `OpcUaClientInterface` from `php-opcua/opcua-client` and proxies every call to the daemon over a Unix socket. The goal is a drop-in replacement: any code using `Client` should work with `ManagedClient` without changes.
 
 ### Security by Default
 
@@ -101,7 +101,7 @@ The daemon (ReactPHP event loop) keeps OPC UA sessions alive in memory across PH
 
 ### Public Readonly DTOs
 
-All service response types use `public readonly` properties matching `opcua-php-client` v3.0.0. `TypeSerializer` handles bidirectional conversion between these DTOs and JSON-safe arrays for IPC transport.
+All service response types use `public readonly` properties matching `opcua-client` v4.0.0. `TypeSerializer` handles bidirectional conversion between these DTOs and JSON-safe arrays for IPC transport.
 
 ## Guidelines
 
@@ -131,7 +131,7 @@ All service response types use `public readonly` properties matching `opcua-php-
 
 ### TypeSerializer Changes
 
-- New DTO types from `opcua-php-client` must have both `serialize*()` and `deserialize*()` methods
+- New DTO types from `opcua-client` must have both `serialize*()` and `deserialize*()` methods
 - Use public readonly properties, not deprecated getters
 - The generic `serialize()` method must handle the new type via `instanceof`
 
@@ -168,4 +168,4 @@ All service response types use `public readonly` properties matching `opcua-php-
 
 ## Reporting Issues
 
-Use the [issue tracker](https://github.com/gianfriaur/opcua-php-client-session-manager/issues) to report bugs, request features, or ask questions.
+Use the [issue tracker](https://github.com/php-opcua/opcua-session-manager/issues) to report bugs, request features, or ask questions.

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Gianfrancesco
+Copyright (c) 2026 Gianfrancesco (php-opcua)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -9,16 +9,16 @@
 </div>
 
 <p align="center">
-  <a href="https://github.com/GianfriAur/opcua-php-client-session-manager/actions/workflows/tests.yml"><img src="https://img.shields.io/github/actions/workflow/status/GianfriAur/opcua-php-client-session-manager/tests.yml?branch=master&label=tests&style=flat-square" alt="Tests"></a>
-  <a href="https://codecov.io/gh/GianfriAur/opcua-php-client-session-manager"><img src="https://img.shields.io/codecov/c/github/GianfriAur/opcua-php-client-session-manager?style=flat-square&logo=codecov" alt="Coverage"></a>
-  <a href="https://packagist.org/packages/gianfriaur/opcua-php-client-session-manager"><img src="https://img.shields.io/packagist/v/gianfriaur/opcua-php-client-session-manager?style=flat-square&label=packagist" alt="Latest Version"></a>
-  <a href="https://packagist.org/packages/gianfriaur/opcua-php-client-session-manager"><img src="https://img.shields.io/packagist/php-v/gianfriaur/opcua-php-client-session-manager?style=flat-square" alt="PHP Version"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/GianfriAur/opcua-php-client-session-manager?style=flat-square" alt="License"></a>
+  <a href="https://github.com/php-opcua/opcua-session-manager/actions/workflows/tests.yml"><img src="https://img.shields.io/github/actions/workflow/status/php-opcua/opcua-session-manager/tests.yml?branch=master&label=tests&style=flat-square" alt="Tests"></a>
+  <a href="https://codecov.io/gh/php-opcua/opcua-session-manager"><img src="https://img.shields.io/codecov/c/github/php-opcua/opcua-session-manager?style=flat-square&logo=codecov" alt="Coverage"></a>
+  <a href="https://packagist.org/packages/php-opcua/opcua-session-manager"><img src="https://img.shields.io/packagist/v/php-opcua/opcua-session-manager?style=flat-square&label=packagist" alt="Latest Version"></a>
+  <a href="https://packagist.org/packages/php-opcua/opcua-session-manager"><img src="https://img.shields.io/packagist/php-v/php-opcua/opcua-session-manager?style=flat-square" alt="PHP Version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/php-opcua/opcua-session-manager?style=flat-square" alt="License"></a>
 </p>
 
 ---
 
-Keep OPC UA sessions alive across PHP requests. A daemon-based session manager for [`opcua-php-client`](https://github.com/GianfriAur/opcua-php-client) that eliminates the 50–200ms connection handshake overhead on every HTTP request.
+Keep OPC UA sessions alive across PHP requests. A daemon-based session manager for [`opcua-client`](https://github.com/php-opcua/opcua-client) that eliminates the 50–200ms connection handshake overhead on every HTTP request.
 
 PHP's request/response model destroys all state — including network connections — at the end of every request. OPC UA requires a 5-step handshake (TCP → Hello/Ack → OpenSecureChannel → CreateSession → ActivateSession) that must be repeated every single time. This package solves the problem with a long-running [ReactPHP](https://reactphp.org/) daemon that holds sessions in memory, communicating with PHP applications via a lightweight Unix socket IPC protocol.
 
@@ -36,7 +36,7 @@ PHP's request/response model destroys all state — including network connection
 ## Quick Start
 
 ```bash
-composer require gianfriaur/opcua-php-client-session-manager
+composer require php-opcua/opcua-session-manager
 ```
 
 ### 1. Start the daemon
@@ -48,7 +48,7 @@ php bin/opcua-session-manager
 ### 2. Use ManagedClient in your PHP code
 
 ```php
-use Gianfriaur\OpcuaSessionManager\Client\ManagedClient;
+use PhpOpcua\SessionManager\Client\ManagedClient;
 
 $client = new ManagedClient();
 $client->connect('opc.tcp://localhost:4840');
@@ -102,8 +102,11 @@ $results = $client->readMulti()
 ### Write to a PLC
 
 ```php
-use Gianfriaur\OpcuaPhpClient\Types\BuiltinType;
+// Auto-detection (v4) — type inferred automatically
+$client->write('ns=2;i=1001', 42);
 
+// Explicit type (still supported)
+use PhpOpcua\Client\Types\BuiltinType;
 $client->write('ns=2;i=1001', 42, BuiltinType::Int32);
 ```
 
@@ -125,8 +128,8 @@ foreach ($response->notifications as $notif) {
 ### Secure connection with authentication
 
 ```php
-use Gianfriaur\OpcuaPhpClient\Security\SecurityPolicy;
-use Gianfriaur\OpcuaPhpClient\Security\SecurityMode;
+use PhpOpcua\Client\Security\SecurityPolicy;
+use PhpOpcua\Client\Security\SecurityMode;
 
 $client = new ManagedClient(
     socketPath: '/var/run/opcua-session-manager.sock',
@@ -272,18 +275,18 @@ OPCUA_AUTH_TOKEN=$(cat /etc/opcua/daemon.token) php bin/opcua-session-manager \
 ./vendor/bin/pest tests/Integration/ --group=integration   # integration only
 ```
 
-340+ tests (unit + integration) covering browse, read/write, subscriptions, method calls, path resolution, connection state, security, type serialization, session persistence, session recovery, and all v3.0.0 DTOs.
+340+ tests (unit + integration) covering browse, read/write, subscriptions, method calls, path resolution, connection state, security, type serialization, session persistence, session recovery, and all v4.0.0 DTOs.
 
 > **Note on coverage:** `SessionManagerDaemon` is excluded from coverage reports because it runs as a separate long-lived process (ReactPHP event loop). PHP coverage tools (pcov, xdebug) only instrument the test runner process — they cannot track code executing inside a subprocess started via `proc_open()`. The daemon is fully tested by the integration suite, which starts a real daemon, sends IPC commands, and verifies responses. This is a known limitation shared by other daemon-based PHP packages (Laravel Horizon, Symfony Messenger, RoadRunner workers).
 
 ## Ecosystem
 
 | Package | Description |
 |---------|-------------|
-| [opcua-php-client](https://github.com/GianfriAur/opcua-php-client) | Pure PHP OPC UA client — the core protocol implementation |
-| [opcua-php-client-session-manager](https://github.com/GianfriAur/opcua-php-client-session-manager) | Session persistence daemon (this package) |
-| [opcua-laravel-client](https://github.com/GianfriAur/opcua-laravel-client) | Laravel integration — service provider, facade, config |
-| [opcua-test-server-suite](https://github.com/GianfriAur/opcua-test-server-suite) | Docker-based OPC UA test servers for integration testing |
+| [opcua-client](https://github.com/php-opcua/opcua-client) | Pure PHP OPC UA client — the core protocol implementation |
+| [opcua-session-manager](https://github.com/php-opcua/opcua-session-manager) | Session persistence daemon (this package) |
+| [opcua-laravel-client](https://github.com/php-opcua/opcua-laravel-client) | Laravel integration — service provider, facade, config |
+| [opcua-test-server-suite](https://github.com/php-opcua/opcua-test-server-suite) | Docker-based OPC UA test servers for integration testing |
 
 ## Roadmap