Add IM UserStatus service for im.user.status.* methods

[mesilov]

Q	A
Bug fix?	no
New feature?	yes
Deprecations?	no
Issues	Fix #430
License	MIT

Description

This PR adds a new UserStatus service under src/Services/IM/User/Service/ that wraps four REST API methods for managing user status in Bitrix24:

• im.user.status.get — retrieves the current user's status (online, idle, away, dnd, offline)
• im.user.status.set — sets a custom status
• im.user.status.idle.start — enables automatic "Away" status
• im.user.status.idle.end — disables automatic "Away" status

Key Changes

New Files:

• src/Services/IM/User/UserStatusType.php — String-backed enum for valid status values
• src/Services/IM/User/Result/UserStatusResult.php — Custom result class with status(): string accessor
• src/Services/IM/User/Service/UserStatus.php — Service class with four methods
• tests/Unit/Services/IM/User/Service/UserStatusTest.php — Unit tests
• tests/Integration/Services/IM/User/Service/UserStatusTest.php — Integration tests

Modified Files:

• src/Services/IM/IMServiceBuilder.php — Added userStatus() method to expose the service
• phpunit.xml.dist — Added integration test suite
• Makefile — Added test target
• CHANGELOG.md — Documented the new feature

Usage Example

$userStatus = $serviceBuilder->getIMScope()->userStatus();

// Get current status
$result = $userStatus->get();
$status = $result->status(); // Returns: "online", "idle", "away", "dnd", or "offline"

// Set status
$userStatus->set(UserStatusType::Online);

// Enable/disable automatic away
$userStatus->idleStart();
$userStatus->idleEnd();

Testing

• Unit tests verify service instantiation
• Integration tests validate all four methods against a real portal
• All linting and type-checking passes (phpstan, deptrac, rector, cs-fixer)

https://claude.ai/code/session_015PC3VWnQepqMPssMpMacy6