Expected Behavior

The isSupportedOsUpdate and getSupportedOsUpdateVersions should support ESR versions directly.

Instead of having to do :
sdk.models.os.isSupportedOsUpgrade('raspberry-pi', device.os_version, targetOsRelease.basedOnVersion)
Just do:
sdk.models.os.isSupportedOsUpgrade('raspberry-pi', device.os_version, targetESRversion)

Actual Behavior

Currently to perform an ESR update we need to:

1. Get all versions with sdk.models.os.getAvailableOsVersions('raspberrypi3') and filter out the required ESR version. For example for 2023.1.0 we get:

{
    "id": 2441888,
    "known_issue_list": null,
    "raw_version": "2023.1.0",
    "phase": null,
    "osType": "esr",
    "line": "next",
    "strippedVersion": "2023.1.0",
    "rawVersion": "2023.1.0",
    "basedOnVersion": "v2.107.40",
    "formattedVersion": "v2023.1.0 (next, recommended)",
    "isRecommended": true
}

2. Check whether it is a valid version to update to with sdk.models.os.isSupportedOsUpgrade('raspberry-pi', device.os_version, targetOsRelease.basedOnVersion), for example sdk.models.os.isSupportedOsUpgrade('raspberry-pi', 'v2.95.0' , 'v2.107.40')

3. And then trigger the update with sdk.models.device.startOsUpdate('7cf02a687b74206f92cb455969cf8e98', '2023.1.0')

References

https://balena.zulipchat.com/#narrow/stream/345882-_help/topic/Get.20balena.20ESR.20balenaOs.20version.20from.20the.20SDKs
https://jel.ly.fish/support-thread-1-0-0-front-cnv-dq6tkct