SDK-2745: Add Enforce Handoff to SDKs for IDV Create Session

[mehmet-yoti]

Automated PR created by n8n. Related Jira Issue: SDK-2745

[mehmet-yoti]

@copilot Do Below Task To implement the new "enforce_handoff" configuration in our SDK, we need to follow a detailed plan that involves several key tasks. The objective is to ensure that this configuration is correctly integrated and that error handling is provided as specified. Here's a breakdown of the steps required:

1. Understand Requirements

• Review Documentation: Before proceeding, ensure you have a clear understanding of the requirements by reviewing the DOCS-3523 ticket and any related documentation.
• Clarify Functionality: Confirm the purpose of the "enforce_handoff" property and how it should function similarly to "allow_handoff."

2. Update SDK Configuration

• Modify Config Schema:
  • Update the SDK configuration schema to include the "enforce_handoff" property.
  • Ensure default behaviors and potential states (true, false, undefined) are clearly defined.

3. Implement Logic for "enforce_handoff"

• Validation Logic:
  • Implement logic to check the state of both "enforce_handoff" and "allow_handoff".
  • Ensure that "enforce_handoff" cannot be set to true if "allow_handoff" is false.

4. Integrate IDV API Validation

• API Validation:
  • Utilize the IDV API to validate the current configuration state whenever "enforce_handoff" is set.
  • Ensure that erroneous configurations are caught by the API and the SDK reacts accordingly.

5. Error Handling

• Define Error Messages:
  • Create clear error messages for cases when "enforce_handoff" is improperly configured (e.g., set to true while "allow_handoff" is false).
• Expose Errors:
  • Ensure that these errors are exposed to the SDK users in a user-friendly manner.

6. Testing

• Unit Tests:
  • Write unit tests to cover all possible configurations of "enforce_handoff" and "allow_handoff".
  • Ensure tests cover validation logic and error handling.
• Integration Tests:
  • Perform integration tests with the IDV API to ensure validation checks are correctly executed.

7. Update Documentation

• User Documentation:
  • Update the SDK documentation to include the new "enforce_handoff" option, detailing its purpose, usage, and known constraints.
• Developer Documentation:
  • Provide an updated guide or notes for developers detailing the implementation logic and integration with IDV API.

8. Review and Deployment

• Code Review:
  • Conduct a thorough code review with peers to catch any potential issues or improvements.
• Deployment:
  • Schedule deployment ensuring all dependencies and configurations are accounted for.

9. Post-Deployment Monitoring and Support

• Monitoring:
  • Monitor the SDK's behavior post-deployment to catch any unexpected errors or configuration issues early.
• Support:
  • Have a support plan in place in case users encounter issues or have questions regarding the new configuration.

By following these steps, the "enforce_handoff" configuration should be successfully integrated into the SDK, with appropriate error handling and API validation as specified.

[Copilot]

@mehmet-yoti I've opened a new pull request, #388, to work on those changes. Once the pull request is ready, I'll request review from you.