Handle rosapi param responses

[bjsowa]

Public API Changes
None

Description
Thanks to RobotWebTools/rosbridge_suite#1001, since ROS 2 Jazzy, rosapi param services return the successful bool and fill the reason for failure if the operation does not succeed.

This PR adds the logic for handling these additional fields.

[EzraBrooks]

was that backported to humble? roslibjs only has one release channel so I don't think we should break API here if not until Humble is EOL.

[bjsowa]

was that backported to humble? roslibjs only has one release channel so I don't think we should break API here if not until Humble is EOL.

It was not backported but this should still be compatible with humble

[EzraBrooks]

agree with copilot about not duplicating the code three places, otherwise LGTM. I only skimmed it the first time and didn't notice that you wrote it in a back-compatible way by checking for the presence of the successful member.

maybe we need to make failedCallback mandatory in a future version, otherwise if someone promisifies this callback-style function this'll just hang forever?

[Copilot]

Pull Request Overview

Updates the Param class to handle the new response format from rosapi parameter services in ROS 2 Jazzy, which now includes a successful boolean field and optional reason for failures.

• Added response validation checking result.successful before processing parameter operations
• Updated error handling to use the service-provided reason field when operations fail
• Modified documentation to clarify that failed callbacks now handle both service call failures and unsuccessful parameter operations

---

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

[bjsowa]

@EzraBrooks I simplified it a bit by skipping the "undefined check" (result.successful === false will return false if successful is undefined) and also changed it so that the normal callback is still called if result is unsuccessful and failedCallback is not provided to keep the old behavior. Let me know what you think