Add IM\Counters service for im.counters.get (#433)

[mesilov]

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

Description

This PR adds support for the Bitrix24 REST API method im.counters.get, which retrieves unread message and notification counters for the currently authenticated user.

Changes

New Service Structure:

• IM\Counters\Service\Counters – Service class with get() method
• IM\Counters\Result\CountersResult – Result wrapper for the API response
• IM\Counters\Result\CountersItemResult – Item class with typed properties for counter fields (TYPE, MESSAGE, NOTIFY, CHAT, LINES)

Integration:

• Added counters() method to IMServiceBuilder for service access
• Updated IMServiceBuilder test to verify service caching

Testing:

• Unit test for service instantiation
• Integration tests for API response validation and type casting
• Custom assertions verify all API response fields are properly annotated and type-cast

Configuration:

• Added test suite configuration in phpunit.xml.dist
• Added Makefile target for running IM Counters integration tests
• Updated CHANGELOG.md

Usage Example

$sdk = new Bitrix24\SDK\Bitrix24(credentials);
$counters = $sdk->getServiceBuilder()->getIMScope()->counters()->get()->counters();

echo $counters->MESSAGE;  // int
echo $counters->NOTIFY;   // int
echo $counters->CHAT;     // int
echo $counters->LINES;    // int
echo $counters->TYPE;     // string

Test Plan

All automated tests pass:

• Unit tests verify service instantiation
• Integration tests validate API response structure and field type casting
• Deptrac compliance verified (no new layer violations)

https://claude.ai/code/session_017PUmAzXXyQAH4YfWJwDzzo