Add enforce_handoff configuration with validation for IDV session creation

[Copilot]

Implements the enforce_handoff configuration option for IDV session creation as specified in SDK-2745. This property works alongside allow_handoff to control handoff behavior during identity verification sessions.

Changes

• SdkConfig: Added enforceHandoff property with getter and validation
• SdkConfigBuilder: Added withEnforceHandoff(bool) builder method
• Validation: Throws DocScanException when enforce_handoff=true while allow_handoff=false
• Tests: Added 8 test cases covering all configuration combinations and edge cases
• Serialization: Updated JSON output to include enforce_handoff field

Usage

$sdkConfig = (new SdkConfigBuilder())
    ->withAllowHandoff(true)
    ->withEnforceHandoff(true)  // Requires allow_handoff=true or null
    ->build();

// Invalid configuration throws exception
$invalid = (new SdkConfigBuilder())
    ->withAllowHandoff(false)
    ->withEnforceHandoff(true)  // DocScanException: enforce_handoff cannot be set to true when allow_handoff is false
    ->build();

The property accepts true, false, or null (undefined). Additional API-level validation will occur server-side during session creation.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[Copilot]

Just as a heads up, I was blocked by some firewall rules while working on your feedback. Expand below for details.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/repos/phpstan/extension-installer/zipball/66c7adc9dfa38b6b5838a9fb728b68a7d8348051
  • Triggering command: /usr/bin/php8.3 /usr/bin/php8.3 -n -c /tmp/M2PqIj /usr/bin/composer install (http block)
  • Triggering command: /usr/bin/php8.3 /usr/bin/php8.3 -n -c /tmp/jGfSiN /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/phpstan/phpstan/zipball/48236ddf823547081b2b153d1cd2994b784328c3
  • Triggering command: /usr/bin/php8.3 /usr/bin/php8.3 -n -c /tmp/jGfSiN /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/deprecation-contracts/zipball/63afe740e99a13ba87ec199bb07bbdee937a5b62
  • Triggering command: /usr/bin/php8.3 /usr/bin/php8.3 -n -c /tmp/jGfSiN /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/polyfill-ctype/zipball/a3cc8b044a6ea513310cbd48ef7333b384945638
  • Triggering command: /usr/bin/php8.3 /usr/bin/php8.3 -n -c /tmp/jGfSiN /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/380872130d3a5dd3ace2f4010d95125fde5d5c70
  • Triggering command: /usr/bin/php8.3 /usr/bin/php8.3 -n -c /tmp/jGfSiN /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/3833d7255cc303546435cb650316bff708a1c75c
  • Triggering command: /usr/bin/php8.3 /usr/bin/php8.3 -n -c /tmp/M2PqIj /usr/bin/composer install (http block)
  • Triggering command: /usr/bin/php8.3 /usr/bin/php8.3 -n -c /tmp/jGfSiN /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/polyfill-mbstring/zipball/6d857f4d76bd4b343eac26d6b539585d2bc56493
  • Triggering command: /usr/bin/php8.3 /usr/bin/php8.3 -n -c /tmp/M2PqIj /usr/bin/composer install (http block)
  • Triggering command: /usr/bin/php8.3 /usr/bin/php8.3 -n -c /tmp/jGfSiN /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/string/zipball/5621f039a71a11c87c106c1c598bdcd04a19aeea
  • Triggering command: /usr/bin/php8.3 /usr/bin/php8.3 -n -c /tmp/jGfSiN /usr/bin/composer install --no-interaction (http block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)