Improve Idle Account Suspension API to return disabled and non-disabled users

[KaveeshaPiumini]

Purpose

This PR enhance the getInactiveUsers API to:

• Filtering disabled users from all inactive users for a given time period.
• Filtering non-disabled users from all inactive users for a given time period.

Implementation

Implementation introduces a new queryParameter, filter, to decide on whether to include disabled users or exclude disabled users.
When filter=isDisabled eq true it returns all the inactive and disabled users for a given time period whose account state is DISABLED.
When filter=isDisabled eq false it returns all the inactive and non-disabled users for a given time period.

Example

Sample Request
https://localhost:9443/api/idle-account-identification/v1/inactive-users?inactiveAfter=2024-12-21&excludeBefore=2024-12-11&filter=isDisabled eq false

Sample Response

[
    {
        "userId": "a0b6793e-d996-4bc8-b600-ff8d3ce5fc9a",
        "username": "kim",
        "userStoreDomain": "PRIMARY"
    },
    {
        "userId": "c7d21584-483e-4177-a5e5-a7da6f3edef7",
        "username": "kimthree",
        "userStoreDomain": "PRIMARY"
    }
] 

Related Issue

• Improve Idle Account Suspension API to return disabled and non-disabled users product-is#21907

Merge After

• Improve Idle Account Suspension API to return disabled and non-disabled users wso2-extensions/identity-governance#901