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.

Tested in H2, MySQL, PostgreSQL, MSSQL, Oracle databases.

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

[jenkins-is-staging]

PR builder started
Link: https://github.com/wso2/product-is/actions/runs/12805340782

[jenkins-is-staging]

PR builder completed
Link: https://github.com/wso2/product-is/actions/runs/12805340782
Status: failure

[jenkins-is-staging]

PR builder started
Link: https://github.com/wso2/product-is/actions/runs/12822674920

[jenkins-is-staging]

PR builder completed
Link: https://github.com/wso2/product-is/actions/runs/12822674920
Status: success

[jenkins-is-staging]

Approving the pull request based on the successful pr build https://github.com/wso2/product-is/actions/runs/12822674920