[rules] Expose _getTriggeredData & Adjust for backward compat with UI scripts

[florian-h05]

Closes #443.

Description

• Exposes the _getTriggeredData utility from the rules namespace, which converts the Java event data to pure JS.
• Adds optional backwards compatibilty with the pure Java event object in UI-based environments by adding its event properties to the event object if a flag is set. Accessing these properties logs warnings.
• One minor breaking change for UI-based environments: The .payload property of _getTriggeredData returns a object, the pure Java version returns a JSON string that has to be parsed by the user.

Testing

I used the following script to check for potential differences / verify same behaviour:

var newEvent = rules._getTriggeredData(ctx, true)

console.error('itemState')
console.log(event.itemState)
console.log(newEvent.itemState)

console.error('oldItemState')
console.log(event.oldItemState)
console.log(newEvent.oldItemState)

console.error('itemCommand')
console.log(event.itemCommand)
console.log(newEvent.itemCommand)

console.error('itemName')
console.log(event.itemName)
console.log(newEvent.itemName)

console.error('type')
console.log(event.type)
console.log(newEvent.type)

console.error('event')
console.log(event.event)
console.log(newEvent.event)

console.error('payload')
console.log(event.payload)
console.log(newEvent.payload)

[Copilot]

Pull Request Overview

This PR exposes the internal _getTriggeredData utility function from the rules namespace to convert Java event data to JavaScript objects, while adding optional backward compatibility for UI-based environments.

• Exposes _getTriggeredData function in the module exports for external use
• Adds backward compatibility layer with deprecated property warnings for UI scripts
• Introduces parameter to control backward compatibility behavior

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}