Add sort parameter to getFlagSnapshots API

[jamessalvatore]

Description

Add a sort parameter with values ASC and DESC to the getFlagSnapshots API.

Motivation and Context

This change allows API users to receive snapshots in ascending order if they wish to, rather than always receiving results in descending order (the current behavior).

How Has This Been Tested?

Tested locally that the change is backwards compatible, such that snapshots are received in descending order when the query parameter is not specified:

curl http://localhost:18000/api/v1/flags/1/snapshots\?limit\=2

[
  {
    "flag": {
      "dataRecordsEnabled": false,
      "description": "test",
      "enabled": false,
      "id": 1,
      "key": "kxjfenfcgu4xdcyq1",
      "segments": [],
      "tags": [],
      "updatedAt": "2023-10-06T16:10:55.490-04:00",
      "variants": []
    },
    "id": 5,
    "updatedAt": "2023-10-06T20:10:55Z"
  },
  {
    "flag": {
      "dataRecordsEnabled": false,
      "description": "test",
      "enabled": false,
      "id": 1,
      "key": "kxjfenfcgu4xdcyq1",
      "segments": [],
      "tags": [],
      "updatedAt": "2023-10-06T16:10:55.080-04:00",
      "variants": []
    },
    "id": 4,
    "updatedAt": "2023-10-06T20:10:55Z"
  }
]

Tested locally that snapshots are received in ascending order when specified:

curl http://localhost:18000/api/v1/flags/1/snapshots\?limit\=2\&sort\=ASC

[
  {
    "flag": {
      "dataRecordsEnabled": false,
      "description": "test",
      "enabled": false,
      "id": 1,
      "key": "kxjfenfcgu4xdcyq1",
      "segments": [],
      "tags": [],
      "updatedAt": "2023-10-06T16:10:50.781-04:00",
      "variants": []
    },
    "id": 1,
    "updatedAt": "2023-10-06T20:10:50Z"
  },
  {
    "flag": {
      "dataRecordsEnabled": false,
      "description": "test",
      "enabled": false,
      "id": 1,
      "key": "kxjfenfcgu4xdcyq1",
      "segments": [],
      "tags": [],
      "updatedAt": "2023-10-06T16:10:54.208-04:00",
      "variants": []
    },
    "id": 2,
    "updatedAt": "2023-10-06T20:10:54Z"
  }
]

Tested locally that snapshots are received in descending order when specified:

curl http://localhost:18000/api/v1/flags/1/snapshots\?limit\=2\&sort\=DESC

[
  {
    "flag": {
      "dataRecordsEnabled": false,
      "description": "test",
      "enabled": false,
      "id": 1,
      "key": "kxjfenfcgu4xdcyq1",
      "segments": [],
      "tags": [],
      "updatedAt": "2023-10-06T16:10:55.490-04:00",
      "variants": []
    },
    "id": 5,
    "updatedAt": "2023-10-06T20:10:55Z"
  },
  {
    "flag": {
      "dataRecordsEnabled": false,
      "description": "test",
      "enabled": false,
      "id": 1,
      "key": "kxjfenfcgu4xdcyq1",
      "segments": [],
      "tags": [],
      "updatedAt": "2023-10-06T16:10:55.080-04:00",
      "variants": []
    },
    "id": 4,
    "updatedAt": "2023-10-06T20:10:55Z"
  }
]

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

• My code follows the code style of this project.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have added tests to cover my changes.
• All new and existing tests passed.

[ghost]

👇 Click on the image for a new way to code review

Legend

[nothing0012]

LGTM! Thanks for the PR

[jamessalvatore]

Hi @nothing0012 , thanks for merging this PR.

Would it be possible to create a new release that includes these changes? Thanks very much!