385 publish b24 php sdk beta 3 #396

…tRepository add contracts account repository for Bitrix24

…-root-folder add security file in root folder

…iconnector 317 add new scope code biconnector

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

fix typehint

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

fix typehint in DealCategoryItemResult

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

rename batch interface

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

fix contracts for apps

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

add service builder factory

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

331 add auth node in telephony

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

fix undefined index error

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

…ter-result add method isError

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

…ter-result add method isError - fix

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

339 add scope user

- Добавлена часть кода в тесте для поиска созданных контактов с помощью батча и метода list.

…' into add-support-for-operating-timing

- В тест добавлена часть с update использующая батч.

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

…g-timing add support for operating timing

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

# Conflicts: # tools/Commands/GenerateContactsCommand.php

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

…ming 340 add support for operating timing

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

add batch support for crm-items

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

add bitrix24 user id

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

change signatures in application contracts

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

add deal stage semantic id

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

fix errors for scope

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

fix errors for Core

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

add x-request-id support

The Request ID parameter is now included in query strings in addition to the header field for improved tracking. This change was made to accommodate for the current version of the Bitrix24 API that does not use Request ID from headers. A corresponding `getQueryStringParameterName` method was also added to the `RequestIdGeneratorInterface`. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Add Request ID to query string parameters

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

add windows platforms in unit-tests

# Conflicts: # CHANGELOG.md # src/Core/Batch.php # src/Services/CRM/Common/Result/AbstractCrmItem.php

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

…ifields 338 fix return type for crm multifields

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

change query string parameter name

New classes related to Catalog scope services have been created and integrated into the existing structure. This includes product-related result classes `ProductResult`, `ProductsResult`, `ProductItemResult` and service classes `Product` and `Batch`. Additionally, a `CatalogServiceBuilder` is added to construct the catalog service, and a `ProductType` enumeration has been defined to set product types. The commit also includes an update in the `CHANGELOG.md`. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Updated workflow configurations to support both Ubuntu and Windows OS. The changes cover PHPUnit tests, PHPStan, Vendor integration, and Integration tests by adding matrix-operating-system variables. These modifications also include updates in the supported PHP versions, and disabling the "fail-fast" strategy to ensure tests across all OS complete before reporting. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit updates the PHP version requirement in composer.json to allow either 8.2.* or 8.3.*, reflecting its compatibility with both. Moreover, the README file has been significantly refactored, removing unnecessary content, correcting a typo, and reorganizing the architecture section. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This update adds new catalog service-related functions in the CatalogServiceBuilder file and introduces several methods for product service. These methods include functions to add, delete, and retrieve products. Additionally, several integration tests have been introduced to ensure the correct functioning of these new methods. Also, an example phpstan static analyzer command's been added to Makefile, and PHP requirement has been adjusted to support PHP 8.2. Plus, the README file has been refactored for clarity and better organization. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Implement catalog scope services

306 beta 1

The data provider methods used in various test cases have been changed to static. This change was applied to "CredentialsTest", "ApplicationStatusTest", "ApplicationProfileTest", "DefaultRequestIdGeneratorTest", and "TimeTest". An additional command has also been added to the Makefile for running unit tests. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Constants in DefaultRequestIdGenerator were refactored to remove 'string' and 'array' type declarations. These changes conform to PHP constants declaration rules, which do not require type specification. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The constant CRM_USERFIELD_PREFIX in the AbstractCrmItem class has been updated to remove the 'string' type declaration, in accordance with PHP's constants declaration rules which do not require specifying the type. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The constant CRM_USERFIELD_PREFIX in the AbstractCatalogItem class has been updated to remove the 'string' type declaration, keeping in line with PHP's convention for declaring constants which does not require specifying the type. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The release date for version 2.0-beta.1 in the CHANGELOG.md file has been updated. Additionally, the PHP support information has also been changed to reflect the added support for PHP 8.2 and 8.3, and the removal of support for PHP 8.0 and 8.1. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

bitrix24-php-sdk beta 1 build

bitrix24-php-sdk beta-1

The versions of several dependencies in the composer.json file have been updated. This applies to both the main requirements and the development requirements. The upgrades ensure compatibility with the latest versions, improving overall functionality and performance. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Update dependency versions in composer.json

This commit introduces an example of how to use bitrix24-php-sdk with webhooks. It includes the configuration needed to set up the SDK with a webhook URL, and an example of how to fetch and display information about a deal. Additionally, a task in the README.md file has been marked as complete. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This update adds new workflow services which provide support for working with workflow templates. Additionally, a necessary update in the changelog has been made to provide transparency to users about the added 'bizproc' services and new features in the workflow module. This step towards enriching Bitrix24 SDK with workflow enhancements could help in managing workflows better and provide users with more flexibility and control. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The update introduces a new Workflow service in the WorkflowsServiceBuilder, including supporting classes such as Batch and WorkflowInstanceItemResult. It also includes methods for workflow instances and their results. The additions provide functionality to list launched workflows and handle batch operations. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Two new classes, WorkflowInstanceStartResult and WorkflowDocumentType, have been created. A start method has been introduced in the workflow service responsible for initiating a new workflow instance. It covers different types of document workflows, handles exceptions, and provides clear argument invalidation messages. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

…sult` This commit introduces the `DealSemanticStage` enum, furthering the options available for the `STAGE_SEMANTIC_ID` field of the `DealItemResult` class. This change provides more precise type information. Also, the types of several properties in the `DealItemResult` class are updated to nullable ones to better reflect possible data states. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The commit updates the version constraints for multiple packages in composer.json, making them more flexible by allowing both current and one previous major version. This should ease package updates and compatibility issues in the future. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The typo in the version constraint for the psr/log dependency in the composer.json file has been corrected. This revision ensures the correct versions (^2 or ^3) of the Signed-off-by: mesilov <mesilov.maxim@gmail.com>

…-bizproc-scope-support-in-services

371 publish b24 php sdk beta 2

Two new specific exceptions have been added, 'ActivityOrRobotAlreadyInstalledException' and 'ActivityOrRobotValidationFailureException' in the workflow services. These exceptions are to be thrown in situations where an activity or robot is already installed or fails validation. This improves error handling by distinguishing specific scenarios during the API's error handling process. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This update introduces a new Robot service to the Workflows, which adds support for automation rules in the application. It includes functionalities for registration, deletion and updating of these rules, along with related result reporting features and work property enumeration. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

New classes have been added to handle Workflow Events, which support the initialization of the Event Service, handling Robot Requests, and sending events with return values. Modifications have also been done on the AccessToken and WorkflowsServiceBuilder classes to support this new feature. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit updates the CHANGELOG.md to reflect the changes going into the 2.0-beta.3 release of the bitrix24-php-sdk. This includes the addition of the 'bizproc' scope and related services for working with workflows, as well as a new method for initializing from a robot request. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit introduces new functionalities for workflows and activities services. It includes adding methods to enable recording data in the workflow log, retrieval of installed activities, option to update activity fields, add and delete activities. Also, added necessary result classes and updated the access token method name. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit updates the versions of the 'symfony/console' and 'symfony/dotenv' dependencies in the 'composer.json' file. Additionally, the CHANGELOG has been updated, expanding the description of workflow services and their features. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Implemented the ability to stop an active workflow in the Workflow service, returning the result in a new WorkflowTerminationResult class. Also updated the WorkflowActivityDocumentType class to replace targetDocumentType with targetDocumentId. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Added case for 'access_denied' error status in the ApiLevelErrorHandler. Also replaced 'body' with 'rawResponse' in logging actions for more clarity. The Core.php file now throws the 'AuthForbiddenException' to the ErrorHandler to handle, leading to better error management. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The integration.yml GitHub workflow has been eliminated, as seen in the deletion of related codes and configurations. The workflow was responsible for running integration tests in different PHP versions and operating systems. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Updated the structure of Workflows services and incorporated new functionalities. This includes the ability to delete and launch workflows, and stop active ones. Additionally, implemented workflow templates add and delete features. Introduced Base64 encoding within the file system and now handle file not found exception. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit introduces exception handling for API calls attempting to update records without providing any fields to update. This checks for zero-count field arrays and throws an InvalidArgumentException in such cases. Additionally, service descriptions in the Workflow Templates have been updated for better clarity. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Introduced "nesbot/carbon" version 3.3.* as a new dependency in composer.json. Updated CHANGELOG.md to reflect the added dependency. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit introduces the task service for workflows along with the relevant types and results. WorkflowTaskStatusType, WorkflowTaskUserStatusType, and WorkflowTaskCompleteStatusType enums are added for various status types. WorkflowTasksResult and WorkflowTaskItemResult classes are created to handle task results. The ServiceBuilder has been updated to produce the new task service. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The commit mainly updates the PHPStan configuration in the Makefile and phpstan.neon.dist, increasing memory limit and setting parallel processing parameters. It also refactors the Task service by expanding function parameter arrays into multiple lines for improved readability and maintainability. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

A new feature has been introduced to handle completion of workflow tasks. This included the addition of a new 'complete' method in the workflows task service, the WorkflowTaskAlreadyCompletedException for handling task already completed errors, and the WorkflowTaskCompleteResult for managing the task completion result. The CHANGELOG and documentation have been updated accordingly. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Added Rector to the project for static code analysis and cleaning. The Makefile has been updated with a linter for Rector, and a linter fixer has been provided. Additionally, 'rector/rector' was added to the composer.json dependencies. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit includes a few changes, mainly focused on code cleanup. It removes redundant properties and type conversions while enhancing string manipulations for better robustness. It also simplifies method signatures by removing unnecessary parameters, making the code more concise and easier to read. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

In this commit, Rector was added to the project to enhance the quality of the code and expedite the release cycle. With the help of Rector, regular code refactoring tasks get simplified and can be performed more swiftly, thus shortening the overall time for releases. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

…-services 376 add bizproc scope support in services

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Introduced `CallType` and `CrmEntityType` within the `Telephony\Common` namespace, providing enum definitions for call and CRM entity types. Also added `TelephonyServiceBuilder` for Telephony related service construction, along with a new `ExternalCall` service under `Telephony\ExternalCall\Service`. All changes are reflected in the updated CHANGELOG. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Added a new service for handling external calls in the telephony section. This feature enables registering calls in Bitrix24, including objects that correspond to numbers in CRM. Also improved error handling by adding a new exception for scenarios where a user is not found or is not active. Removed redundant comments in ServiceBuilder.php and added a test for the new service. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This update to the "ExternalCall" service adds advanced telephony functionality. The revised service now includes methods for handling call records, CRM entity retrieval, completion of calls, and interaction with the call UI. Exception handling has been improved with more specific error types and some minor changes have made to response and parameter types for better accuracy and clarity. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit refines the implemented telephony services, notably by improving the call record functionality and adding FileNotFoundException. Two new classes, CallRecordUploadUrlResult and CallRecordUploadUrlItemResult, were added. PHPUnit coverage was also expanded, with tests for hiding, showing, and finishing calls added to the ExternalCallTest class. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This update introduces the ability to add a call transcript to the Telephony service. A new test has been added for this feature, along with various new classes to handle transcript information, such as TranscriptMessage and TranscriptMessageSide. The TelephonyServiceBuilder has also been updated to include call services. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The destructor was removed from the Response.php file because it included logging that was deemed unnecessary. The associated logging for responseInfo, networkTimings, and restTimings was relying on possibly uninvoked getResponseData method and an unfinished asynchronous request. This operation makes the logic of the code more straightforward and avoid redundancy. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The Makefile and phpunit.xml.dist have been updated to include a new PHPUnit test suite. This dedicated test suite focuses on the integration tests for telephony scope. The aim is to segregate and improve the manageability of tests related to telephony. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The data type of `CONTACT_ID` and `CONTACT_IDS` has been changed from string to int and array of ints respectively in CRM Deal Service. This is to ensure the consistency and appropriateness of the data types used across the service. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The commit primarily addresses the renaming of variables and adjusting the visibility of setUp functions in the Telephony test classes. Variables such as '$sb' and '$cost' have been renamed to more meaningful names like '$serviceBuilder' and '$money'. The visibility of 'setUp' functions has been changed from public to protected for better encapsulation. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit introduces a new service for managing telephony external lines, complete with unit tests. Changes include adding a new test suite for workflow integrations and creating new files for the telephony external line service, batch operations, and relevant test cases. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

A new method has been added to the ExternalLine service to retrieve the list of external lines of an application. Alongside, new result classes ExternalLineItemResult and ExternalLinesResult have been created. Additionally, configuration in rector.php has been adjusted for cache and rule sets management. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

A delete method has been implemented in the ExternalLine service, which allows to delete an external line. The method is tested in the ExternalLineTest class where a line is added, verified, deleted, and the deletion is confirmed. A new result object, EmptyResult, has been introduced to cover cases where a function doesn't return any specific data. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Removed unnecessary imports and reorganized the code in Telephony service unit tests, ensuring a cleaner and more maintainable structure. Also enhanced the external line functionalities, refining the methods for adding and deleting an external line. Furthermore, changes in the import process have been made in the Rector configuration for more efficient handling of unused imports. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit introduces a few changes to clean up and optimize the code. The code for the Telephony services tests has been refactored for improved readability by using class imports instead of fully qualified class names. The Makefile has been updated with more descriptive commands. Additionally, unnecessary type casting in the test for adding and deleting external lines has been removed, providing a slight performance boost. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

In this update, multiple unused import statements were removed from several files, enhancing code cleanliness. Additionally, variable names were updated for improved readability. Some syntax changes were made as well, such as revising switch cases to match conditionals for better efficiency. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The configuration for the Rector has been updated to stop the removal of unused imports. This change ensures that all imports, whether used or not, are retained in the code. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This code update introduces support for SIP lines in the Voximplant namespace. SIP support includes methods to get a list of SIP lines, add a new SIP line, and delete a SIP line. This enhancement in the telephony service makes the overall application more equipped for handling voice services. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Introduced a new status function for SIP registration mainly for cloud hosted PBX. This includes the creation of relevant new classes such as `SipLineStatusItemResult`, `SipLineStatusResult`, and `SipRegistrationStatus`. Updated the `CHANGELOG.md` to reflect these changes. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Enhanced SIP tests in the SipTest.php by adding test assertions for add and delete line methods, as well as get line status method. The 'tearDown' method was updated to delete all cloud PBX lines after each test to ensure a clean testing environment. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The code now includes a new method for updating SIP line settings in the Voximplant Sip Service. Functionality for this method is supported by validation checks and relevant exceptions. A corresponding unit test to confirm the behavior of the update functionality has also been added. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The Credentials.php file is updated with a method 'isWebhookContext' that checks the current context initialization. The CredentialsTest.php and phpstan.neon.dist files were also modified to incorporate new tests and directories. The files related to documentation have been updated accordingly. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

A new exception class, MethodConfirmWaitingException, has been added specifically for handling cases where the `method_confirm_waiting` error occurs. This helps improve granularity in handling different types of errors. The error reporting logic in the Core.php file has been updated to use a switch case structure instead of if conditions, to better manage different error types. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Added methods to deactivate, activate and get the user settings for the Voximplant SIP service. Included additional classes and files for better organization. These additions help manage SIP-phone availability per user and retrieve user settings effectively. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

…n tests Added AccessTokenRepositoryInterface to handle access token operations and its implementation, AccessTokenFileStorage. The provided interface and implementation allows managing access tokens, checking their availability, and saving new tokens. Also, setup for integration tests has been modified to support these changes. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The commit includes the addition of services that enable the management of TTS Voices and InfoCalls in Voximplant. The new services include methods for listing available voices for speech generation and initiating calls with specific parameters. Corresponding test cases and results structure for these services were also added and defined. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This update introduces new services to handle Voximplant sip lines. Features added include setting the SIP line as outgoing by default, returning all available outgoing lines, and getting or setting the line by default for outgoing calls. Relevant tests are also incorporated to ensure functionality. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit includes addition of InfoCall Service under Voximplant telephony, with function to start a call with text or sound. Accompanying unit tests for the functionality have also been created. Additionally, minor code refactoring and variable renaming have taken place in voice test classes for clarity. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Extended Software Development Kit (SDK) services for telephony with a function to fetch links for browsing telephony scope pages. Introduced corresponding Voximplant service classes and related unit tests. The new method fetches a set of vital navigation links, helping to facilitate telephony operations by users. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit adds a new method, getConnectorStatus, to the Sip service in the telephony module. This new method retrieves the current status of the SIP Connector. It also includes a corresponding test case in the SipTest integration test and updates the CHANGELOG.md file to document this new functionality. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This update introduces several telephony-related events and an EventManager to manage them. The events include 'OnExternalCallBackStart', 'OnExternalCallStart', 'OnVoximplantCallEnd', 'OnVoximplantCallInit', 'OnVoximplantCallStart'. This will significantly enhance the functionality of the telephony feature in the application by allowing more interaction possibilities. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

A blank line was added to the TelephonyEventsFabric file for improved readability. The CHANGELOG was also updated to include the addition of events with payload and `TelephonyEventsFabric`. A section for "Deleted" events was prepared but is currently empty. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The OnApplicationInstall/Auth.php and OnApplicationUninstall/Auth.php files have been deleted. These were unnecessary as they were no longer being used in the application, simplifying the overall structure. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

rewrite scope telephony

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

…24-user-id Fix typecast error for User ID

A check has been added in User.get method, to set a default argument as ascending order of IDs when no explicit order is provided. A corresponding test case 'test get users list with default arguments' has also been included to validate the functionality. The CHAGELOG.md is updated to reflect this fix. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Add default arguments handling in User.get method

Added a new test file named BatchGetTraversableTest to cover the usage of batch operations for managing contacts. Also updated the CHANGELOG to include the fix regarding the limit argument not working in batch list and read model. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

A new path to the Core directory was added to the Rector configuration. This ensures that our Rector tool can identify and manage code within this new directory. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

In this commit, code clarity and efficiency have been improved across several classes. Unnecessary comments and excessive lines of code have been removed. Additionally, all the constructors and property assignments have been updated to use PHP 7.4 syntax, which provides a more concise way to declare and initialize class properties. In some places, the error messages have been updated to be more descriptive. Finally, the conditionals and the loop iterations have been optimized for better performance. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit focuses on restructuring DTO classes to improve readability and efficiency. Specific changes include making classes read-only, reducing unnecessary lines of code and using concise property promotion in the constructor parameters. The refactored classes include Time, ResponseData, Pagination, RenewedAccessToken, and Response. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The 'order' parameter in Batch.php was updated to be populated with the $order variable, previously it was initiated as an empty array. This change accommodates more specific sorting requirements in batch operations. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Integration tests have been added for the Core component. The Makefile and phpunit.xml.dist files were updated to reflect these new tests. Further, exceptions in CoreTest.php and Core.php have been adjusted to better handle Transport and Json exceptions. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The Credentials constructor has been simplified by removing redundant comments and checks. Error checking has been improved - it now ensures that either an AccessToken or WebhookUrl must be set for authentication. The code readability has also been enhanced by removing the full namespace from instance checks, using the imported class names instead. A minor change was also made in the Batch.php file to enhance code formatting. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

…rk-in-batch-list Add BatchGetTraversableTest and update CHANGELOG

The existing dependency on `ramsey/uuid` has been replaced with `symfony/uid` in the codebase. This change is reflected in the `Command` constructor of `src/Core/Commands/Command.php`, and anywhere else where the ID of a command was previously retrieved using `getUuid()`. The `getName()` method has also been replaced with `getId()`. The composer.json and CHANGELOG files have been updated correspondingly. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

…uuid-to-symfony-uuid Replace `ramsey/uuid` with `symfony/uid` package

Deleted the Bitrix24Account contracts: Bitrix24AccountInterface, Bitrix24AccountRepositoryInterface, and Bitrix24AccountStatus. This is part of a broader refactor of the Bitrix24\SDK\Application\Contracts as noted in the changelog. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Added two new PHP classes under the directory src/Application/Contracts/Bitrix24Accounts/Entity. `Bitrix24AccountInterface` provides an interface for handling Bitrix24 account related operations. `Bitrix24AccountStatus` is an enumeration that defines possible statuses for a Bitrix24 account. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The commit involves the deletion of several redundant files related to the documentation of the project. The files were scattered across different sections like Core, Results, Events, and Application. They consisted of guidelines for adding new functionality, usage of different features, and instructions for tasks like Authorization on the portal. These files were not serving any purpose and cluttering the repository, hence removed. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

…x24AccountInterface A new file, Bitrix24AccountRepositoryInterface, has been created which defines the methods to interact with Bitrix24 account data in a data store. Additionally, the Bitrix24AccountInterface has been updated to throw an InvalidArgumentException where needed to make error handling more explicit and robust. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The AccessToken class has been renamed to AuthToken. This was accompanied by the renaming and modification of related methods, variables, and usages across multiple files. A new file was created, RenewedAuthToken.php, while the old RenewedAccessToken.php was deleted. WebhookUrl usage has also been adjusted. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit adjusts various import paths in the ServiceBuilderFactory class and updates the corresponding references in the code. The AccessToken import and references have been changed to AuthToken. The Bitrix24AccountInterface has been moved to another directory and the changes have been reflected. Certain use statements for exceptions have also been added. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The AccessToken class has been replaced with the AuthToken class across several modules. This includes changes in method arguments, object initializations, and class properties. The goal is to maintain consistency throughout the application by using the newly introduced AuthToken class. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The code changes replace the usage of AccessToken with AuthToken in the Core and Credentials test files. The AccessToken class is replaced globally with the AuthToken class to reflect changes or improvements in the authorization process. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The authToken parameters in the Core classes 'RenewedAuthToken' and 'Credentials' have been refactored. In 'RenewedAuthToken', unnecessary authToken and applicationStatus parameters were removed. In 'Credentials', variable name 'accessToken' was changed to 'authToken' for consistency and clarity. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

A new file containing a test implementation of the Bitrix24AccountInterface has been added, which includes methods for checking user status, managing authentication tokens, updating domain URL, and handling application installation and upgrade cases. The created tests help ensure the functionality and reliability of the system with Bitrix24Accounts. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Renamed the testing and reference implementation classes of Bitrix24AccountInterface and adjusted the methods due to changes in their behavior. Also added new methods for ApplicationStatus testing. This refactoring is important to ensure accurate testing and representation of our Bitrix24Accounts and their statuses. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The test method in ApplicationStatusTest.php has been updated from checking if the application status is local to checking if it is a subscription. This change will ensure that the unit tests are accurately reflecting the application's subscription status. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The commit includes the addition of a sorting step in the Scope constructor that ensures that the order of scope values is consistent. Also, a new method 'equal' has been added to compare if two scope instances are equal based on their values. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Added test case 'testEqual' to enhance the coverage of code in ScopeTest. Simplified the occurrences of UnknownScopeCodeException in all test cases, and corrected the order of scope codes inside the 'testInitFromString' test case. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This update adds more unit tests to validate application behavior. Particularly, tests for methods like 'isApplicationTokenValid', 'getCreatedAt', and 'getUpdatedAt' have been included. Also, the account status change from 'active' to 'blocked' has been corrected. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit updates all test cases to use native PHP8 attribute syntax instead of comments for PHPUnit annotations. The method visibility has also been adjusted to be compliant with the PHPUnit v9. Additionally, multiple unnecessary comment blocks have been removed from the source codes for better readability. All changes have been made across various classes and test cases. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The AccessToken and related classes and interfaces have been replaced with AuthToken and relevant entities across the SDK tests. The main aim was to unify the nomenclature and make it more expressive and intuitive. For instance, the AccessTokenFileStorage has been renamed to AuthTokenFileStorage, and methods and variables have been renamed accordingly. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

An interface AuthTokenRepositoryInterface has been added under the ApplicationBridge in tests. At the same time, an unnecessary use statement, AccessTokenFileStorage, has been removed from Fabric.php in Integration tests. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Created a new documentation file for the Bitrix24Accounts in the Application Contracts. This documentation includes an account state diagram and a detailed breakdown of repository methods. Each method is explained with its associated use cases to aid in understanding and implementation. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit expands the Bitrix24AccountRepositoryInterface with new methods for handling Bitrix24 accounts. It includes methods for saving and deleting Bitrix24 accounts, and for fetching accounts by id or specific characteristics. This update provides enhanced functionality to interact with Bitrix24 account data, from basic CRUD operations to more granular lookups based on account status and attributes. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The documentation for Bitrix24Accounts has been revised. A summary line has been added to better provide context and understandability to its content. It now contains a clear brief about storing auth tokens and methods for working with a Bitrix24 account. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Added new entities for "FullName" and "ContactPersonStatus", alongside an interface for "ContactPerson" under the Contracts namespace. Also, sample entity implementation has been added for testing purposes only. Dependencies in composer.json have also been updated to include necessary libraries and tools for these new implementations. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Expanded the DemoDataGenerator class to improve test data variety. Added additional methods to generate random but realistic data. Created a new ContactPerson entity method for marking a user as deleted, enhancing the functionality for manipulations with user status. Updated corresponding tests to cover new features. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit introduces the InMemoryContactPersonRepositoryImplementation class, which provides an in-memory implementation of the ContactPersonRepositoryInterface. It also includes associated unit test cases to ensure that the implementation behaves as expected. This mainly assists developers in the process of testing without needing a real database. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Updated method calls in InfoCall tests to use `getNationalNumber()` from `DemoDataGenerator::getMobilePhone()`. This change ensures we're passing the correct format of mobile phone number to `startWithText` and `startWithSound` methods. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

A variety of changes have been made across several files to enhance readability and optimize semantics. This includes implementing the Stringable interface in the FullName class and cleaning up variable names to be more descriptive. Additionally, unnecessary comments have been removed and elements in the Scope class are now transformed to lowercase in a more concise way. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit refactors several variable names across multiple methods in the codebase to increase readability. Changes include renaming "item" to "contactPerson", "userRepository" to "userRepo", "mobilePhone" to "phoneNumber" among others. The objective is to ensure that the names are meaningful and accurately reflect their purpose within the code. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The method findByExternalId within the ContactPersonRepository has been expanded to account for various scenarios. It now checks for empty ExternalId input and returns an array, instead of a single output, because a contact person can have multiple installations across different portals. Associated tests have been added or updated accordingly. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Updated variable names in various telephony test files for a better understanding of the return value being reflected. The new names specifically indicate the action taken and the result received, making the purpose of each test step clearer. This change upholds the quality of the codebase by promoting readability and maintainability. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

A line to ignore PHPStan analysis was added to the `findByExternalId('')` method call in the `ContactPersonRepositoryInterfaceTest.php` test. This annotative change helps to suppress the PHPStan error that's triggered by this particular line of testing code. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

The settings for failOnRisky and failOnWarning within PHPUnit configurations have been updated from true to false. This change allows tests to continue running even if there are risks or warnings, giving the opportunity to see a comprehensive list of all issues rather than stopping at the first one encountered. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Test file renaming and reorganizing has been done to streamline namespaces. Additionally, the phpunit configuration has been updated to fail on risky tests. Unused imports have also been removed from various test files, improving code readability. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Created new event classes for the ContactPerson entity in the Application Contracts layer, aimed to deal with various situations such as contact creation, block, unblock, or deletion. Also included is the full documentation file describing ContactPerson's methods, states, repository methods, and events. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This update adds an application installation interface for setting up interactions between the application and the Bitrix24 API. A Bitrix24 user ID field is also added to the contact person interface. This modification extends the functionality of the contact person, enabling more advanced data tracking. The new ID field maps a Bitrix24 user with a contact person, if there is any association. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Implemented detailed application installation status management in the `ApplicationInstallationInterface` with corresponding methods. Introduced `ApplicationInstallationStatus` enum to define possible states. Included updates to contact person handling and external ID management. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Introduced the ability to set and get the Bitrix24 partner ID for contact persons. Updated tests and documentation to support this new functionality, ensuring comprehensive test coverage and proper documentation. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Extended the ContactPerson entities and their respective tests to include the bitrix24PartnerId/UUid field. This change ensures that we can store and retrieve Bitrix24 partner UUIDs for contact persons, enhancing our data handling capabilities. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Implemented ApplicationInstallationReferenceEntityImplementation for testing ApplicationInstallationInterface. Updated ApplicationInstallationInterface with new methods for managing portal license family and users count. Added tests to validate the new implementation and methods. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Introduce validation logic to check the status before changing application installation status to active or deleted. Also, added extensive unit tests to cover these new behaviors for better reliability and clarity. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Added precondition checks for application status changes. Enhanced documentation for clarity in interface methods with new constraints. Comprehensive tests for `markAsActive`, `markAsBlocked`, and other status-related methods were introduced to ensure correct behavior. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Initialize 'comment' to null, validate 'externalId' input, and introduce ApplicationInstallationRepositoryInterface for persistence operations. Added new exception handling for application installation not found scenarios. Includes in-memory repository implementation and associated tests. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Added a new method `getById` to `ApplicationInstallationRepositoryInterface`. Renamed the test path prefix to `Unit`. Included various new tests for application installations, updating and reorganizing the existing structure. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Introduced the `Bitrix24PartnerStatus` enum to define partner statuses, and a `Bitrix24PartnerInterface` to standardize partner management operations, including partner creation, status changes, and retrieving partner information. This standardization aims to streamline interactions with Bitrix24 partner entities. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Introduce Bitrix24 Partner entity classes and a repository interface with in-memory implementations for testing. Added tests cover save, delete, getById, and associated functions to ensure data persistence operations work correctly. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Locking the phpstan version to 1.11.7 ensures stable and consistent builds. This change avoids potential issues from future updates to the phpstan package. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Replaced Fabric::getLogger with Psr\Log\NullLogger in multiple InMemory repository implementations for consistent logging behavior in unit tests. Adjusted test suite configuration to display warnings. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Updated README for better clarity and readability by adjusting formatting and adding new sections. Improved instructions for running tests and included additional examples for application setup in Bitrix24. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

…ts-and-add-documentation-for-use-cases refactor app contracts and add documentation for use cases

Updated the release date for version 2.0-beta.3 from July 1, 2024, to August 15, 2024. Additionally, noted the migration from `DateTimeImmutable` to `CarbonImmutable` from the Carbon library. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Replace all instances of DateTimeImmutable with CarbonImmutable for improved functionality and better date manipulation capabilities. Adjusted corresponding function calls and tests to align with CarbonImmutable's interface. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Updated CRM models to include new discount-related fields and types. Improved type annotation consistency by switching to CarbonImmutable for date fields. Enhanced integration tests to cover new discount properties and validation. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit introduces new enums for CRM Activity types and directions. Also, it adds a data filter class to handle field exclusion by prefix, and updates integration tests to use these new enums. These changes improve the code maintainability and readability in the CRM module. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Introduced a new trait `CustomBitrix24Assertions` for verifying Bitrix24 API fields against PHPDoc annotations. Incorporated the new assertion in `ContactTest` and adjusted `composer.json` to include necessary dependencies. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Implemented API metadata attributes for service and method documentation. Added GenerateCoverageDocumentationCommand to generate API coverage documentation in Markdown format. This enhances maintainability and provides comprehensive API documentation automatically. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Added `ApiServiceMetadata` and `ApiEndpointMetadata` annotations to relevant classes and methods. Updated methods to handle system and personal notifications, including new functionalities for deleting and marking notifications as read or unread. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

This commit deletes legacy example files and directories that are no longer needed. The removed files include outdated webhook, telephony, and workflow examples that had hardcoded values and were not aligned with the current project architecture. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Deleted outdated local application files including .env, activity-handler.php, and robot-handler.php. Updated README with detailed instructions and examples on working with webhooks and local applications. Added a new composer.json for dependency management in the local-application directory. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Relocated the "Sponsors" section to improve the document's structure. This ensures that sponsorship details are positioned closer to the contributors' section, enhancing logical flow. Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Signed-off-by: mesilov <mesilov.maxim@gmail.com>

Update CHANGELOG.md for new target release date

385 publish b24 php sdk beta 3 #396

385 publish b24 php sdk beta 3 #396

Commits on Oct 31, 2022

Commits on Nov 23, 2022

Commits on Jan 30, 2023

Commits on Feb 17, 2023

Commits on Mar 14, 2023

Commits on Mar 17, 2023

Commits on Mar 19, 2023

Commits on Mar 22, 2023

Commits on Mar 23, 2023

Commits on Mar 24, 2023

Commits on Mar 27, 2023

Commits on Apr 3, 2023

Commits on Apr 15, 2023

Commits on Aug 6, 2023

Commits on Aug 7, 2023

Commits on Aug 13, 2023

Commits on Aug 21, 2023

Commits on Aug 23, 2023

Commits on Aug 26, 2023

Commits on Aug 28, 2023

Commits on Sep 6, 2023

Commits on Sep 8, 2023

Commits on Nov 24, 2023

Commits on Nov 25, 2023

Commits on Dec 9, 2023

Commits on Jan 3, 2024

Commits on Jan 4, 2024

Commits on Jan 12, 2024

Commits on Feb 4, 2024

Commits on Feb 17, 2024

Commits on Feb 18, 2024

Commits on Mar 13, 2024

Commits on Mar 31, 2024

Commits on Apr 1, 2024

Commits on Apr 3, 2024

Commits on Apr 11, 2024

Commits on Apr 12, 2024

Commits on Apr 20, 2024

Commits on Apr 21, 2024

Commits on May 1, 2024

Commits on May 3, 2024

Commits on May 4, 2024

Commits on May 5, 2024

Commits on May 23, 2024

Commits on May 24, 2024

Commits on May 26, 2024

Commits on May 27, 2024

Commits on May 28, 2024

Commits on May 29, 2024

Commits on Jun 2, 2024

Commits on Jun 15, 2024

Commits on Jun 19, 2024

Commits on Jun 20, 2024

Commits on Jun 26, 2024

Commits on Jun 27, 2024

Commits on Jun 29, 2024

Commits on Jun 30, 2024

Commits on Jul 2, 2024

Commits on Jul 3, 2024

Commits on Jul 4, 2024

Commits on Jul 6, 2024

Commits on Jul 7, 2024

Commits on Jul 10, 2024

Commits on Jul 13, 2024

Commits on Jul 21, 2024

Commits on Jul 22, 2024

Commits on Jul 23, 2024

Commits on Jul 24, 2024

Commits on Jul 26, 2024

Commits on Jul 27, 2024

Commits on Jul 28, 2024

Commits on Jul 30, 2024

Commits on Aug 6, 2024

Commits on Aug 10, 2024

Commits on Aug 11, 2024

Commits on Aug 12, 2024

Commits on Aug 17, 2024

Commits on Aug 18, 2024