companion-feedbacks

Define feedbacks inside an UpdateFeedbacks function that calls self.setFeedbackDefinitions() with CompanionFeedbackDefinition entries. Each boolean feedback needs a type, name, options, defaultStyle using combineRgb() colors, and a callback returning true or false.

Boolean feedbacks return true to apply a predefined defaultStyle, suiting simple on/off indicators. Advanced feedbacks return a full CompanionAdvancedFeedbackResult with custom text, PNG images, colors, size, and alignment for complete rendering control.

Update your module's cached state first, then call self.checkFeedbacks('feedback_id') for specific feedbacks or self.checkAllFeedbacks() for all of them. Companion re-runs the callbacks and applies the resulting styles to buttons.

Use subscribe to start polling or monitoring when a feedback is placed on a button, and unsubscribe to stop it when removed. Always implement unsubscribe alongside subscribe to avoid resource leaks from orphaned polling loops.

Feedback callbacks must be fast and read from cached module state rather than querying devices synchronously. Store device data in module state as it arrives, then have callbacks compute results from that cache with fallback defaults.