Should extend os.getAvailableOsVersions() & os.isSupportedOsUpgrade() to support ESR

[alexgg]

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

[jellyfish-bot]

[alexgg] This has attached https://jel.ly.fish/c47c7880-afd1-481e-9812-af113d46857d

[jellyfish-bot]

[phil-d-wilson] This has attached https://jel.ly.fish/25bc98d3-6fd4-4864-b7ce-849726a34523

[phil-d-wilson]

I've attached the above support thread, since this also means that the CLI cannot update an ESR device, since the command passes in the current OS Version and sdk.models.os.getAvailableOsVersions returns undefined when an ESR version is passed.