@iobroker/dm-utils 0.6.11 → 1.0.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023-2024 ioBroker Community Developers
+Copyright (c) 2023-2025 ioBroker Community Developers
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -114,7 +114,7 @@ In most cases, you will get all states of your instance and fill the array with
 
 Every array entry is an object of type `DeviceInfo` which has the following properties:
 
-- `id` (string): a unique (human readable) identifier of the device (it must be unique for your adapter instance only)
+- `id` (string): a unique (human-readable) identifier of the device (it must be unique for your adapter instance only)
 - `name` (string or translations): the human-readable name of this device
 - `status` (optional): the current status of the device, which can be one of:
   - `"disconnected"`
@@ -197,8 +197,8 @@ This method is called when the user clicks on a control (i.e., slider) in the de
 
 The parameters of this method are:
 - `deviceId` (string): the `id` that was given in `listDevices()` --> `[].id`
-- `controlId` (string): the `id` that was given in `listDevices()` --> `[].controls[].id`
-- `state` (string | number | boolean): new state for the control, that will be sent to real device
+- `controlId` (string): the `id` that was given in `listDevices()` --> `[].controls[].id`. There are some reserved control names, you can find the list below.
+- `state` (string | number | boolean): new state for the control, that will be sent to a real device
 - `context` (object): object containing helper methods that can be used when executing the action
 
 The returned object must contain:
@@ -206,6 +206,9 @@ The returned object must contain:
 
 This method can be implemented asynchronously and can take a lot of time to complete.
 
+Reserved control names:
+- `disabled` - The disabled control has its own pre-defined place on the device card and is used to disable the device. The state of this control is boolean.
+
 ### `handleDeviceControlState(deviceId: string, controlId: string, context: MessageContext)
 
 This method is called when GUI requests the update of the state.
@@ -226,7 +229,11 @@ To allow your adapter to interact with the user, you can use "actions".
 
 As described above, there are actions on the instance and on devices. The behavior of both methods is similar.
 
-Inside an action method (`handleInstanceAction()` or `handleDeviceAction()`) you can perform arbitrary actions, like talking to a device or API, and you can interact with the user. For interactions, there are methods you can call on `context`:
+Inside an action method (`handleInstanceAction()` or `handleDeviceAction()`) you can perform arbitrary actions, like talking to a device or API, and you can interact with the user.
+For interactions, there are methods you can call on `context`:
+
+There are some reserved action names, you can find the list below:
+- `status` - This action is called when the user clicks on the status icon. So to implement the "click-on-status" functionality, the developer has to implement this action.
 
 ### `showMessage(text: ioBroker.StringOrTranslated)`
 
@@ -295,6 +302,15 @@ This method returns a promise that resolves to a `ProgressDialog` object.
 	### **WORK IN PROGRESS**
 -->
 ## Changelog
+### 1.0.1 (2025-01-09)
+
+* (@GermanBluefox) Added description for `disabled` control and `status` action.
+
+### 1.0.0 (2025-01-08)
+
+* (@GermanBluefox) Added `disabled` options for a device
+* (@GermanBluefox) Major release just because is good enough. No breaking changes.
+
 ### 0.6.11 (2024-12-11)
 
 * (@GermanBluefox) Do not close handler for progress
@@ -366,7 +382,7 @@ This method returns a promise that resolves to a `ProgressDialog` object.
 ## License
 MIT License
 
-Copyright (c) 2023-2024 ioBroker Community Developers
+Copyright (c) 2023-2025 ioBroker Community Developers
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/build/types/base.d.ts

@@ -101,6 +101,7 @@ export interface DeviceInfo<T extends ActionType = 'api'> {
     actions?: DeviceAction<T>[];
     controls?: DeviceControl<T>[];
     hasDetails?: boolean;
+    /** Device type for grouping */
     group?: {
         key: string;
         name?: ioBroker.StringOrTranslated;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iobroker/dm-utils",
-  "version": "0.6.11",
+  "version": "1.0.1",
   "description": "ioBroker Device Manager utilities for backend",
   "main": "build/index.js",
   "publishConfig": {
@@ -16,7 +16,7 @@
     "release-patch": "release-script patch --yes",
     "release-minor": "release-script minor --yes",
     "release-major": "release-script major --yes",
-    "update-packages": "ncu --upgrade",
+    "update-packages": "npx -y npm-check-updates --upgrade",
     "npm": "npm i -f"
   },
   "author": "UncleSamSwiss",
@@ -28,7 +28,7 @@
     "@alcalzone/release-script": "^3.8.0",
     "@alcalzone/release-script-plugin-license": "^3.7.0",
     "@iobroker/eslint-config": "^1.0.0",
-    "@types/node": "^22.10.2",
+    "@types/node": "^22.10.5",
     "axios": "^1.7.9",
     "typescript": "^5.7.2"
   },