Problem
The Bitrix24 REST API methods im.search.* (search chats/users/departments and manage last-search history) are not yet supported by the SDK.
Proposed solution
Add a new service src/Services/IM/Search/Service/Search.php that wraps the following REST methods, following patterns in other src/Services/<Scope>/ folders. Scope: im.
Methods to implement
Legacy methods (im.search.last.*) work only in the previous chat UI version per the docs; include them for API completeness but mark as legacy in PHPDoc.
Acceptance criteria
Part of #422.
Problem
The Bitrix24 REST API methods
im.search.*(search chats/users/departments and manage last-search history) are not yet supported by the SDK.Proposed solution
Add a new service
src/Services/IM/Search/Service/Search.phpthat wraps the following REST methods, following patterns in othersrc/Services/<Scope>/folders. Scope:im.Methods to implement
im.search.chat.list— search chats accessible to the current userim.search.user.list— search users by name, position, departmentim.search.department.list— search departments by titleim.search.last.add— add a dialog to the last-search history (legacy)im.search.last.get— get the last-search history (legacy)im.search.last.delete— remove a dialog from the last-search history (legacy)Legacy methods (
im.search.last.*) work only in the previous chat UI version per the docs; include them for API completeness but mark as legacy in PHPDoc.Acceptance criteria
Bitrix24\SDK\Services\IM\Search\Service\Searchimplements each method with correct parameter mapping and#[ApiEndpointMetadata]/#[ApiServiceMetadata(new Scope(['im']))]attributesIMServiceBuilder::search()exposes the new serviceSearchChatItemResult,SearchUserItemResult,SearchDepartmentItemResultwith@property-readannotations cover all returned fieldstests/Unit/Services/IM/Search/Service/SearchTest.phppass (make test-unit)tests/Integration/Services/IM/Search/Service/SearchTest.phppasstests/Integration/Services/IM/Search/Result/pass for every*ItemResult(annotation completeness + type-cast checks)make test-integration-im-searchtarget added toMakefileand a suite added tophpunit.xml.distCHANGELOG.mdentry under## 3.2.0 – UNRELEASED→### Addedwith link to this issuePart of #422.