feat: add option to emit "value update" events after setValue

.vscode/settings.json

@@ -12,40 +12,40 @@
 		"typescriptreact"
 	],
 	"files.exclude": {
-		"node_modules/": false,
-		"coverage/": false,
+		"node_modules/": true,
+		"coverage/": true,
 		".*": false,
-		"**/node_modules/": false,
-		".nyc_output": false,
-		"**/coverage/": false,
-		"**/*.map": false,
-		"**/zwave-js-*.tgz": false,
-		"build": false,
-		"*.d.ts": false,
-		"*.map": false,
-		"**/build": false,
-		"**/*.tsbuildinfo": false,
-		"packages/zwave-js/**/fingerprint.txt": false,
-		"node_modules/zwave-js/**/fingerprint.txt": false,
-		".husky/_/**/*": false,
-		"packages/config/config/devices/index.json": false,
-		"packages/*/package-lock.json": false,
-		".yarn/*": false,
+		"**/node_modules/": true,
+		".nyc_output": true,
+		"**/coverage/": true,
+		"**/*.map": true,
+		"**/zwave-js-*.tgz": true,
+		"build": true,
+		"*.d.ts": true,
+		"*.map": true,
+		"**/build": true,
+		"**/*.tsbuildinfo": true,
+		"packages/zwave-js/**/fingerprint.txt": true,
+		"node_modules/zwave-js/**/fingerprint.txt": true,
+		".husky/_/**/*": true,
+		"packages/config/config/devices/index.json": true,
+		"packages/*/package-lock.json": true,
+		".yarn/*": true,
 		".yarn/patches": false,
 		".yarn/releases": false,
 		".yarn/plugins": false,
 		".yarn/sdks": false,
 		".yarn/versions": false,
-		"**/.pnp.*": false,
-		"**/*.test.js": false,
-		"packages/*/cache": false,
-		"**/.tmp": false,
-		"**/.tmpoh/": false,
-		"**/.tmpozw/": false,
-		"**/.tmpzwa/": false,
-		"**/.secrets": false,
-		"**/.test-payloads": false,
-		"(!test)/cache": false
+		"**/.pnp.*": true,
+		"**/*.test.js": true,
+		"packages/*/cache": true,
+		"**/.tmp": true,
+		"**/.tmpoh/": true,
+		"**/.tmpozw/": true,
+		"**/.tmpzwa/": true,
+		"**/.secrets": true,
+		"**/.test-payloads": true,
+		"(!test)/cache": true
 	},
 	"files.associations": {
 		"**/config/**/*.json": "jsonc"

docs/api/node.md

@@ -71,6 +71,10 @@ This method automatically figures out which commands to send to the node, so you
 -   The required Command Class is not implemented in this library yet
 -   The API for the required Command Class is not implemented in this library yet
 
+> [!ATTENTION] By default, the driver assumes to be talking to a single application. In this scenario a successful `setValue` call is enough for the application to know that the value was changed and update its own cache or UI. Therefore, the `"value updated"` event is not emitted after `setValue` unless the change was verified by the device.
+>
+> To get `"value updated"` events nonetheless, set the driver option `emitValueUpdateAfterSetValue` to `true`.
+
 The `options` bag contains options that influence the resulting commands, for example a transition duration. Each implementation will choose the options that are relevant for it, so you can use the same options everywhere.
 
 <!-- #import SetValueAPIOptions from "zwave-js" -->

packages/zwave-js/src/lib/driver/ZWaveOptions.ts

@@ -145,6 +145,17 @@ export interface ZWaveOptions {
 	 */
 	disableOptimisticValueUpdate?: boolean;
 
+	/**
+	 * By default, the driver assumes to be talking to a single application. In this scenario a successful `setValue` call
+	 * is enough for the application to know that the value was changed and update its own cache or UI.
+	 *
+	 * Therefore, the `"value updated"` event is not emitted after `setValue` unless the change was verified by the device.
+	 * To get `"value updated"` events nonetheless, set this option to `true`.
+	 *
+	 * Default: `false`
+	 */
+	emitValueUpdateAfterSetValue?: boolean;
+
 	/**
 	 * Soft Reset is required after some commands like changing the RF region or restoring an NVM backup.
 	 * Because it may be problematic in certain environments, we provide the user with an option to opt out.

packages/zwave-js/src/lib/node/Node.ts

@@ -834,7 +834,13 @@ export class ZWaveNode extends Endpoint implements SecurityClassOwner {
 			);
 			if (api.isSetValueOptimistic(valueId)) {
 				// If the call did not throw, assume that the call was successful and remember the new value
-				this._valueDB.setValue(valueId, value, { noEvent: true });
+				this._valueDB.setValue(
+					valueId,
+					value,
+					!!this.driver.options.emitValueUpdateAfterSetValue
+						? undefined
+						: { noEvent: true },
+				);
 			}
 
 			return true;