feature / normalize-rank-feature

[tomas862]

No description provided.

[gemini-code-assist]

Code Review

This pull request introduces a mode parameter to NormalizeRequest and a taskId to NormalizeFieldResult to support different normalization modes and asynchronous processing. The review feedback recommends adding validation for the mode parameter to ensure it only accepts 'linear' or 'rank' values, improving the robustness of the SDK.

[gemini-code-assist]

The mode parameter is currently not validated. To improve robustness and prevent sending invalid values to the API, it's best to validate that $mode is either null, 'linear', or 'rank', as specified in the PHPDoc. This provides early feedback to the developer using the SDK.

        if ($mode !== null && !in_array($mode, ['linear', 'rank'], true)) {
            throw new InvalidArgumentException(
                'Invalid normalization mode. Allowed values are "linear" or "rank".',
                'mode',
                $mode
            );
        }

        $this->validateFields($fields);