Update adapter to Matter 1.4 2 and matter.js 0.16 (nightly)

CLAUDE.md

@@ -0,0 +1,265 @@
+# ioBroker.matter - Project Guide
+
+## Project Overview
+
+This is an ioBroker adapter for Matter protocol support. It enables:
+1. **Controller Mode**: Connect and control Matter-based devices from ioBroker
+2. **Bridge Mode**: Expose ioBroker devices as Matter bridges to external controllers (Google Home, Apple Home, Alexa)
+3. **Device Mode**: Expose individual ioBroker devices as standalone Matter devices
+
+Built on `@matter/main` (matter.js) library and follows the ioBroker adapter development patterns.
+
+## Technology Stack
+
+- **Backend**: TypeScript, Node.js 20+
+- **Frontend**: React 18, Vite, Material-UI
+- **Matter Library**: `@matter/main`, `@matter/nodejs`, `@project-chip/matter.js`
+- **ioBroker Integration**: `@iobroker/adapter-core`, `@iobroker/type-detector`, `@iobroker/dm-utils`
+
+## Project Structure
+
+```
+ioBroker.matter/
+├── src/                      # Backend TypeScript source
+│   ├── main.ts              # Main adapter entry point (MatterAdapter class)
+│   ├── ioBrokerStorageTypes.ts  # Type definitions for ioBroker storage
+│   ├── lib/                 # Core library code
+│   │   ├── devices/         # ioBroker device type implementations
+│   │   ├── DeviceFactory.ts # Factory for creating device instances
+│   │   ├── DeviceManagement.ts # Device management for DM (Device Manager)
+│   │   └── SubscribeManager.ts # State subscription handling
+│   └── matter/              # Matter protocol implementations
+│       ├── BaseServerNode.ts       # Base class for Matter server nodes
+│       ├── BridgedDevicesNode.ts   # Matter bridge implementation
+│       ├── ControllerNode.ts       # Matter controller implementation
+│       ├── DeviceNode.ts           # Single Matter device implementation
+│       ├── GeneralMatterNode.ts    # Shared Matter node functionality
+│       ├── IoBrokerObjectStorage.ts # Matter storage using ioBroker objects
+│       ├── behaviors/              # Custom Matter behaviors
+│       ├── to-iobroker/           # Matter → ioBroker device converters
+│       └── to-matter/             # ioBroker → Matter device converters
+├── src-admin/               # Frontend React application
+│   ├── src/
+│   │   ├── App.tsx         # Main React application
+│   │   ├── types.d.ts      # Shared TypeScript types
+│   │   ├── Tabs/           # Tab components (Controller, Bridges, Devices, Options)
+│   │   └── components/     # Reusable UI components
+│   └── package.json
+├── admin/                   # Built admin UI assets
+├── build/                   # Compiled backend JavaScript
+├── io-package.json          # ioBroker adapter metadata
+└── package.json             # Node.js dependencies
+```
+
+## Build Commands
+
+```bash
+# Install all dependencies (both backend and frontend)
+npm run npm
+
+# Build everything
+npm run build
+
+# Build backend only
+npm run build:ts
+
+# Build frontend only
+npm run build:gui
+
+# Run tests
+npm test
+
+# Lint backend
+npm run lint
+
+# Lint frontend
+npm run lint-frontend
+
+# Format code
+npm run format
+
+# Start dev server for frontend
+cd src-admin && npm start
+
+# Update all dependencies
+npm run update-packages
+```
+
+## Backend Architecture
+
+### Main Adapter (src/main.ts)
+
+The `MatterAdapter` class extends ioBroker's `Adapter` base class:
+
+- **Initialization**: `#onReady()` - Sets up Matter environment, syncs devices, starts nodes
+- **Device Management**: `#devices` (Map), `#bridges` (Map), `#controller` - Track active Matter nodes
+- **Message Handling**: `#onMessage()` - Handles commands from UI via ioBroker messaging
+- **State Changes**: `#onStateChange()` - Delegates to `SubscribeManager`
+- **Object Changes**: `#onObjectChange()` - Syncs device/bridge configurations
+
+### Device Type Detection
+
+Uses `@iobroker/type-detector` to identify device types from ioBroker state structures:
+- Supported types defined in `src/lib/devices/` (Light, Dimmer, Thermostat, Lock, etc.)
+- Each type maps to specific Matter device clusters
+
+### Matter Node Types
+
+1. **BridgedDevicesNode** (`src/matter/BridgedDevicesNode.ts`)
+   - Exposes multiple ioBroker devices as a single Matter bridge
+   - Port 5540 for default (Alexa-compatible) bridge
+
+2. **DeviceNode** (`src/matter/DeviceNode.ts`)
+   - Exposes single ioBroker device as Matter device
+
+3. **ControllerNode** (`src/matter/ControllerNode.ts`)
+   - Pairs with external Matter devices
+   - Creates ioBroker states from Matter device attributes
+
+### Device Mapping
+
+**ioBroker → Matter** (`src/matter/to-matter/`):
+- `GenericDeviceToMatter` - Base class
+- Device-specific implementations (e.g., `LightToMatter.ts`, `ThermostatToMatter.ts`)
+
+**Matter → ioBroker** (`src/matter/to-iobroker/`):
+- `GenericDeviceToIoBroker` - Base class
+- Endpoint-specific implementations
+
+## Frontend Architecture
+
+### Main Application (src-admin/src/App.tsx)
+
+React SPA built with:
+- Material-UI components
+- `@iobroker/adapter-react-v5` for ioBroker integration
+- Vite for bundling
+
+### Tabs
+
+- **Options** (`Tabs/Options.tsx`): General adapter settings
+- **Controller** (`Tabs/Controller.tsx`): Manage paired Matter devices
+- **Bridges** (`Tabs/Bridges.tsx`): Configure Matter bridges
+- **Devices** (`Tabs/Devices.tsx`): Configure standalone Matter devices
+
+### Configuration Handler (components/ConfigHandler.tsx)
+
+Manages synchronization between UI state and ioBroker objects:
+- Loads configuration from `matter.X.bridges.*`, `matter.X.devices.*`, `matter.X.controller`
+- Subscribes to object changes for real-time updates
+- Saves configuration back to ioBroker objects
+
+## Backend ↔ Frontend Communication
+
+### Two-Way Communication Pattern
+
+1. **UI → Backend (Commands)**
+   ```typescript
+   // Frontend sends command via socket
+   socket.sendTo(`matter.${instance}`, 'commandName', payload);
+
+   // Backend handles in #onMessage()
+   async #onMessage(obj: ioBroker.Message): Promise<void> {
+     switch (obj.command) {
+       case 'nodeStates': // ...
+       case 'getLicense': // ...
+       case 'controller*': // Delegated to handleControllerCommand()
+       case 'device*':     // Delegated to handleDeviceCommand()
+     }
+   }
+   ```
+
+2. **Backend → UI (Subscriptions)**
+   ```typescript
+   // Frontend subscribes to instance
+   socket.subscribeOnInstance(`matter.${instance}`, 'gui', null, this.onBackendUpdates);
+
+   // Backend pushes updates via sendToGui()
+   await this.sendToGui({
+     command: 'bridgeStates',
+     states: { [uuid]: nodeState }
+   });
+   ```
+
+### GUI Message Commands
+
+Defined in `src-admin/src/types.d.ts`:
+- `bridgeStates`: Initial state of all bridges/devices
+- `updateStates`: Partial state update
+- `progress`: Show progress dialog
+- `processing`: Show processing indicator
+- `stopped`: Backend stopped notification
+- `updateController`: Refresh controller view
+- `identifyPopup`: Device identification notification
+- `discoveredDevice`: New device found during commissioning
+
+### Object-Based Configuration
+
+Configuration is stored in ioBroker objects:
+
+```
+matter.X.bridges.<uuid>     # Channel object with bridge config in native
+matter.X.devices.<uuid>     # Channel object with device config in native
+matter.X.controller         # Folder object with controller config in native
+matter.X.controller.<nodeId> # Folder for each paired Matter node
+```
+
+Frontend modifies objects → Backend receives via `onObjectChange` → Syncs Matter nodes
+
+## Key Concepts
+
+### Commissioning Flow
+
+1. Device/Bridge created with QR code and manual pairing code
+2. User scans QR code in external controller (Google Home, etc.)
+3. Controller commissions the Matter device
+4. `connectionInfo` updated with controller details
+
+### Controller Pairing Flow
+
+1. Enable controller in settings
+2. Start discovery or enter QR code
+3. Controller pairs with external Matter device
+4. Device endpoints mapped to ioBroker states
+
+### License Checking
+
+Pro subscription required for:
+- More than 1 bridge
+- More than 2 standalone devices
+- More than 5 devices per bridge
+
+Verified via `iobroker.pro` API in `checkLicense()`.
+
+## Development Tips
+
+### Adding New Device Type
+
+1. Create ioBroker device class in `src/lib/devices/NewDevice.ts`
+2. Add to exports in `src/lib/index.ts`
+3. Add factory case in `src/lib/DeviceFactory.ts`
+4. Create Matter mapping in `src/matter/to-matter/NewDeviceToMatter.ts`
+5. Add factory case in `src/matter/to-matter/matterFactory.ts`
+
+### Testing
+
+```bash
+npm test  # Runs mocha tests in test/ directory
+```
+
+### Debug Logging
+
+Set `debug: true` in adapter config to enable verbose matter.js logging.
+
+## Important Files Reference
+
+| File | Purpose |
+|------|---------|
+| `src/main.ts` | Main adapter class, entry point |
+| `src/lib/DeviceFactory.ts` | Creates ioBroker device instances |
+| `src/matter/to-matter/matterFactory.ts` | Creates Matter device mappings |
+| `src/matter/to-iobroker/ioBrokerFactory.ts` | Creates ioBroker mappings for controller |
+| `src-admin/src/App.tsx` | Main React application |
+| `src-admin/src/components/ConfigHandler.tsx` | Config sync between UI and objects |
+| `src-admin/src/types.d.ts` | Shared TypeScript types (used by both) |
+| `io-package.json` | ioBroker adapter metadata |

README.md

@@ -99,8 +99,11 @@ Tests are located in the `test/` directory and use ts-node for direct TypeScript
 
 ## Changelog
 ### **WORK IN PROGRESS**
-* (@GermanBluefox) Replaced I18n package
+* (@Apollon77) Updated to Matter 1.4 2 (matter.js to 0.16.0)
+* (@Apollon77) Also covert values for unit "mired" for Color temperatures
+* (@Apollon77) Increases default color temperature range to 1.000 to 20.000 K
 * (@GermanBluefox) Highlight the devices in GUI when hovering over the device in the device list
+* (@GermanBluefox) Replaced I18n package
 
 ### 0.5.6 (2025-10-21)
 * (@Apollon77) Type detector update, should detect single states in non-device structures better
@@ -110,7 +113,7 @@ Tests are located in the `test/` directory and use ts-node for direct TypeScript
 * (@Apollon77) Correctly shows "in progress changes" in UI when adjusting devices to ovoid overlapping actions
 * (@Apollon77) Fix HSV to RGB calculation for some cases
 * (@Apollon77) Updated matter.js to 0.15.6
-* (@Apollon77) Optimizes shutdown process to ensure everything is properly closed
+* (@Apollon77) Optimizes the shutdown process to ensure everything is properly closed
 
 ### 0.5.4 (2025-10-07)
 * (@Apollon77) Updated matter.js to 0.15.5