├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── CONTRIBUTORS.md
├── LICENSE.txt
├── composer.json
├── phpstan-baseline.neon
├── phpstan.neon
└── src
    ├── Account
        ├── Balance.php
        ├── Client.php
        ├── ClientFactory.php
        ├── Config.php
        ├── Network.php
        ├── PrefixPrice.php
        ├── Price.php
        ├── SmsPrice.php
        └── VoicePrice.php
    ├── Application
        ├── Application.php
        ├── ApplicationInterface.php
        ├── Client.php
        ├── ClientFactory.php
        ├── Hydrator.php
        ├── MessagesConfig.php
        ├── RtcConfig.php
        ├── VbcConfig.php
        ├── VoiceConfig.php
        └── Webhook.php
    ├── Client.php
    ├── Client
        ├── APIClient.php
        ├── APIExceptionHandler.php
        ├── APIResource.php
        ├── Callback
        │   ├── Callback.php
        │   └── CallbackInterface.php
        ├── ClientAwareInterface.php
        ├── ClientAwareTrait.php
        ├── Credentials
        │   ├── AbstractCredentials.php
        │   ├── Basic.php
        │   ├── Container.php
        │   ├── CredentialsInterface.php
        │   ├── Gnp.php
        │   ├── Handler
        │   │   ├── AbstractHandler.php
        │   │   ├── BasicHandler.php
        │   │   ├── BasicQueryHandler.php
        │   │   ├── GnpKeypairHandler.php
        │   │   ├── HandlerInterface.php
        │   │   ├── KeypairHandler.php
        │   │   ├── NumberVerificationGnpHandler.php
        │   │   ├── SignatureBodyFormHandler.php
        │   │   ├── SignatureBodyHandler.php
        │   │   ├── SignatureQueryHandler.php
        │   │   ├── SimSwapGnpHandler.php
        │   │   ├── TokenBodyFormHandler.php
        │   │   ├── TokenBodyHandler.php
        │   │   └── TokenQueryHandler.php
        │   ├── Keypair.php
        │   └── SignatureSecret.php
        ├── Exception
        │   ├── Conflict.php
        │   ├── Credentials.php
        │   ├── Exception.php
        │   ├── NotFound.php
        │   ├── Request.php
        │   ├── Server.php
        │   ├── ThrottleException.php
        │   ├── Transport.php
        │   └── Validation.php
        ├── Factory
        │   ├── FactoryInterface.php
        │   └── MapFactory.php
        ├── InvalidResponseException.php
        ├── Request
        │   ├── AbstractRequest.php
        │   ├── RequestInterface.php
        │   └── WrapResponseInterface.php
        ├── Response
        │   ├── AbstractResponse.php
        │   ├── Error.php
        │   ├── Response.php
        │   └── ResponseInterface.php
        ├── ScopeAwareTrait.php
        └── Signature.php
    ├── Conversation
        ├── Client.php
        ├── ClientFactory.php
        ├── ConversationObjects
        │   ├── Channel.php
        │   ├── Conversation.php
        │   ├── ConversationCallback.php
        │   ├── ConversationNumber.php
        │   ├── CreateConversationRequest.php
        │   ├── CreateMemberRequest.php
        │   ├── Event.php
        │   ├── EventRequest.php
        │   ├── Member.php
        │   ├── UpdateConversationRequest.php
        │   └── UpdateMemberRequest.php
        └── Filter
        │   ├── ListConversationFilter.php
        │   ├── ListEventsFilter.php
        │   ├── ListMembersFilter.php
        │   └── ListUserConversationsFilter.php
    ├── Conversion
        ├── Client.php
        └── ClientFactory.php
    ├── Entity
        ├── EntityInterface.php
        ├── Factory
        │   └── FactoryInterface.php
        ├── Filter
        │   ├── DateFilter.php
        │   ├── EmptyFilter.php
        │   ├── FilterInterface.php
        │   └── KeyValueFilter.php
        ├── HasEntityTrait.php
        ├── Hydrator
        │   ├── ArrayHydrateInterface.php
        │   ├── ArrayHydrator.php
        │   ├── ConstructorHydrator.php
        │   └── HydratorInterface.php
        ├── IterableAPICollection.php
        ├── JsonResponseTrait.php
        ├── JsonSerializableInterface.php
        ├── JsonSerializableTrait.php
        ├── JsonUnserializableInterface.php
        ├── NoRequestResponseTrait.php
        ├── Psr7Trait.php
        └── RequestArrayTrait.php
    ├── Insights
        ├── Advanced.php
        ├── AdvancedCnam.php
        ├── Basic.php
        ├── Client.php
        ├── ClientFactory.php
        ├── CnamTrait.php
        ├── Standard.php
        └── StandardCnam.php
    ├── Logger
        ├── LoggerAwareInterface.php
        └── LoggerTrait.php
    ├── Meetings
        ├── Application.php
        ├── ApplicationTheme.php
        ├── Client.php
        ├── ClientFactory.php
        ├── DialInNumber.php
        ├── ExceptionErrorHandler.php
        ├── Recording.php
        ├── Room.php
        └── UrlObject.php
    ├── Messages
        ├── Channel
        │   ├── BaseMessage.php
        │   ├── MMS
        │   │   ├── MMSAudio.php
        │   │   ├── MMSImage.php
        │   │   ├── MMSVideo.php
        │   │   └── MMSvCard.php
        │   ├── Message.php
        │   ├── Messenger
        │   │   ├── InvalidCategoryException.php
        │   │   ├── MessengerAudio.php
        │   │   ├── MessengerFile.php
        │   │   ├── MessengerImage.php
        │   │   ├── MessengerObjectTrait.php
        │   │   ├── MessengerText.php
        │   │   └── MessengerVideo.php
        │   ├── RCS
        │   │   ├── RcsCustom.php
        │   │   ├── RcsFile.php
        │   │   ├── RcsImage.php
        │   │   ├── RcsInvalidTtlException.php
        │   │   ├── RcsText.php
        │   │   └── RcsVideo.php
        │   ├── SMS
        │   │   └── SMSText.php
        │   ├── Viber
        │   │   ├── MessageObjects
        │   │   │   └── ViberActionObject.php
        │   │   ├── ViberFile.php
        │   │   ├── ViberImage.php
        │   │   ├── ViberServiceObjectTrait.php
        │   │   ├── ViberText.php
        │   │   └── ViberVideo.php
        │   └── WhatsApp
        │   │   ├── MessageObjects
        │   │       └── StickerObject.php
        │   │   ├── WhatsAppAudio.php
        │   │   ├── WhatsAppCustom.php
        │   │   ├── WhatsAppFile.php
        │   │   ├── WhatsAppImage.php
        │   │   ├── WhatsAppSticker.php
        │   │   ├── WhatsAppTemplate.php
        │   │   ├── WhatsAppText.php
        │   │   └── WhatsAppVideo.php
        ├── Client.php
        ├── ClientFactory.php
        ├── ExceptionErrorHandler.php
        ├── MessageObjects
        │   ├── AudioObject.php
        │   ├── FileObject.php
        │   ├── ImageObject.php
        │   ├── TemplateObject.php
        │   ├── VCardObject.php
        │   └── VideoObject.php
        ├── MessageTraits
        │   ├── ContextTrait.php
        │   ├── TextTrait.php
        │   └── TtlTrait.php
        └── Webhook
        │   ├── Factory.php
        │   ├── InboundMMS.php
        │   ├── InboundMessenger.php
        │   ├── InboundRCS.php
        │   ├── InboundSMS.php
        │   ├── InboundViber.php
        │   └── InboundWhatsApp.php
    ├── Network
        └── Number
        │   ├── Callback.php
        │   ├── Request.php
        │   └── Response.php
    ├── NumberVerification
        ├── Client.php
        └── ClientFactory.php
    ├── Numbers
        ├── Client.php
        ├── ClientFactory.php
        ├── Filter
        │   ├── AvailableNumbers.php
        │   └── OwnedNumbers.php
        ├── Hydrator.php
        └── Number.php
    ├── ProactiveConnect
        ├── Client.php
        ├── ClientFactory.php
        └── Objects
        │   ├── ListBaseObject.php
        │   ├── ListItem.php
        │   ├── ManualList.php
        │   └── SalesforceList.php
    ├── Redact
        ├── Client.php
        └── ClientFactory.php
    ├── SMS
        ├── Client.php
        ├── ClientFactory.php
        ├── Collection.php
        ├── ExceptionErrorHandler.php
        ├── Message
        │   ├── Binary.php
        │   ├── Message.php
        │   ├── OutboundMessage.php
        │   └── SMS.php
        ├── SentSMS.php
        └── Webhook
        │   ├── DeliveryReceipt.php
        │   ├── Factory.php
        │   └── InboundSMS.php
    ├── Secrets
        ├── Client.php
        ├── ClientFactory.php
        └── Secret.php
    ├── SimSwap
        ├── Client.php
        └── ClientFactory.php
    ├── Subaccount
        ├── Client.php
        ├── ClientFactory.php
        ├── Filter
        │   └── SubaccountFilter.php
        ├── Request
        │   ├── NumberTransferRequest.php
        │   ├── TransferBalanceRequest.php
        │   └── TransferCreditRequest.php
        └── SubaccountObjects
        │   ├── Account.php
        │   ├── BalanceTransfer.php
        │   └── CreditTransfer.php
    ├── Users
        ├── Client.php
        ├── ClientFactory.php
        ├── Filter
        │   └── UserFilter.php
        └── User.php
    ├── Verify
        ├── Check.php
        ├── Client.php
        ├── ClientFactory.php
        ├── ExceptionErrorHandler.php
        ├── Request.php
        ├── RequestPSD2.php
        ├── Verification.php
        └── VerificationInterface.php
    ├── Verify2
        ├── Client.php
        ├── ClientFactory.php
        ├── Filters
        │   └── TemplateFilter.php
        ├── Request
        │   ├── BaseVerifyRequest.php
        │   ├── CreateCustomTemplateFragmentRequest.php
        │   ├── EmailRequest.php
        │   ├── RequestInterface.php
        │   ├── SMSRequest.php
        │   ├── SilentAuthRequest.php
        │   ├── UpdateCustomTemplateRequest.php
        │   ├── VoiceRequest.php
        │   ├── WhatsAppInteractiveRequest.php
        │   └── WhatsAppRequest.php
        ├── Traits
        │   └── CustomTemplateTrait.php
        ├── VerifyObjects
        │   ├── Template.php
        │   ├── TemplateFragment.php
        │   ├── VerificationLocale.php
        │   ├── VerificationWorkflow.php
        │   ├── VerifyEvent.php
        │   ├── VerifySilentAuthEvent.php
        │   ├── VerifyStatusUpdate.php
        │   └── VerifyWhatsAppInteractiveEvent.php
        └── Webhook
        │   └── Factory.php
    ├── Voice
        ├── Call.php
        ├── Call
        │   ├── Call.php
        │   └── Inbound.php
        ├── CallAction.php
        ├── CallFactory.php
        ├── Client.php
        ├── ClientFactory.php
        ├── Endpoint
        │   ├── App.php
        │   ├── EndpointFactory.php
        │   ├── EndpointInterface.php
        │   ├── Phone.php
        │   ├── SIP.php
        │   ├── VBC.php
        │   └── Websocket.php
        ├── Filter
        │   └── VoiceFilter.php
        ├── NCCO
        │   ├── Action
        │   │   ├── ActionInterface.php
        │   │   ├── Connect.php
        │   │   ├── Conversation.php
        │   │   ├── Input.php
        │   │   ├── Notify.php
        │   │   ├── Pay.php
        │   │   ├── Record.php
        │   │   ├── Stream.php
        │   │   └── Talk.php
        │   ├── NCCO.php
        │   └── NCCOFactory.php
        ├── OutboundCall.php
        ├── VoiceObjects
        │   └── AdvancedMachineDetection.php
        ├── Webhook.php
        └── Webhook
        │   ├── Answer.php
        │   ├── Error.php
        │   ├── Event.php
        │   ├── Factory.php
        │   ├── Input.php
        │   ├── Notification.php
        │   ├── Record.php
        │   └── Transfer.php
    └── Webhook
        └── Factory.php


/CONTRIBUTING.md:
--------------------------------------------------------------------------------
 1 | # Getting Involved
 2 |  
 3 | Thanks for your interest in the project, we'd love to have you involved! Check out the sections below to find out more about what to do next...
 4 |  
 5 | ## Opening an Issue
 6 |  
 7 | We always welcome issues, if you've seen something that isn't quite right, or you have a suggestion for a new feature, please go ahead and open an issue in this project. Include as much information as you have, it really helps.
 8 |  
 9 | ## Making a Code Change
10 |  
11 | We're always open to pull requests, but these should be small and clearly described so that we can understand what you're trying to do. Feel free to open an issue first and get some discussion going.
12 |  
13 | When you're ready to start coding, fork this repository to your own GitHub account and make your changes in a new branch. Once you're happy, open a pull request and explain what the change is and why you think we should include it in our project.
14 |  
15 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "vonage/client-core",
 3 |   "type": "library",
 4 |   "description": "PHP Client for using Vonage's API.",
 5 |   "homepage": "https://developer.vonage.com",
 6 |   "license": "Apache-2.0",
 7 |   "authors": [
 8 |     {
 9 |       "name": "James Seconde",
10 |       "email": "jim.seconde@vonage.com",
11 |       "role": "PHP Developer Advocate"
12 |     }
13 |   ],
14 |   "require": {
15 |     "php": "~8.1 || ~8.2 || ~8.3 || ~8.4",
16 |     "ext-mbstring": "*",
17 |     "laminas/laminas-diactoros": "^3.0",
18 |     "lcobucci/jwt": "^4.0|^5.2.0",
19 |     "psr/container": "^1.0 | ^2.0",
20 |     "psr/http-client-implementation": "^1.0",
21 |     "vonage/nexmo-bridge": "^0.1.0",
22 |     "psr/log": "^1.1|^2.0|^3.0",
23 |     "vonage/jwt": "^0.5.0"
24 |   },
25 |   "require-dev": {  
26 |     "guzzlehttp/guzzle": ">=6",
27 |     "helmich/phpunit-json-assert": "^3.3",
28 |     "php-http/mock-client": "^1.4",
29 |     "phpunit/phpunit": "^8.5|^9.4",
30 |     "roave/security-advisories": "dev-latest",
31 |     "squizlabs/php_codesniffer": "^3.5",
32 |     "softcreatr/jsonpath": "^0.7 || ^0.8",
33 |     "phpspec/prophecy-phpunit": "^2.0",
34 |     "rector/rector": "^1.1",
35 |     "phpstan/phpstan": "^1.10"
36 |   },
37 |   "config": {
38 |     "optimize-autoloader": true,
39 |     "preferred-install": "dist",
40 |     "allow-plugins": {
41 |       "php-http/discovery": true
42 |     }
43 |   },
44 |   "autoload": {
45 |     "psr-4": {
46 |       "Vonage\\": "src/"
47 |     }
48 |   },
49 |   "autoload-dev": {
50 |     "psr-4": {
51 |       "VonageTest\\": "test/"
52 |     }
53 |   },
54 |   "minimum-stability": "stable",
55 |   "scripts": {
56 |     "cs-check": "phpcs",
57 |     "cs-fix": "phpcbf",
58 |     "test": "phpunit",
59 |     "phpstan": "phpstan analyse -l 2 src"
60 |   },
61 |   "support": {
62 |     "email": "devrel@vonage.com",
63 |     "issues": "https://github.com/Vonage/vonage-php-sdk-core/issues",
64 |     "source": "https://github.com/Vonage/vonage-php-sdk-core",
65 |     "docs": "https://developer.vonage.com"
66 |   }
67 | }
68 | 


--------------------------------------------------------------------------------
/phpstan-baseline.neon:
--------------------------------------------------------------------------------
 1 | parameters:
 2 | 	ignoreErrors:
 3 | 		-
 4 | 			message: "#^Access to an undefined property Vonage\\\\Account\\\\Price\\:\\:\\$priceMethod\\.$#"
 5 | 			count: 1
 6 | 			path: src/Account/Price.php
 7 | 
 8 | 		-
 9 | 			message: "#^Access to an undefined property Vonage\\\\Application\\\\Application\\:\\:\\$data\\.$#"
10 | 			count: 1
11 | 			path: src/Application/Application.php
12 | 
13 | 		-
14 | 			message: "#^Call to an undefined method Vonage\\\\Application\\\\Client\\:\\:fromArray\\(\\)\\.$#"
15 | 			count: 1
16 | 			path: src/Application/Client.php
17 | 
18 | 		-
19 | 			message: "#^Instantiated class Http\\\\Adapter\\\\Guzzle6\\\\Client not found\\.$#"
20 | 			count: 1
21 | 			path: src/Client.php
22 | 
23 | 		-
24 | 			message: "#^Unsafe usage of new static\\(\\)\\.$#"
25 | 			count: 1
26 | 			path: src/Client/Callback/Callback.php
27 | 
28 | 		-
29 | 			message: "#^Access to an undefined property Vonage\\\\Client\\\\Exception\\\\Request\\:\\:\\$data\\.$#"
30 | 			count: 1
31 | 			path: src/Client/Exception/Request.php
32 | 
33 | 		-
34 | 			message: "#^Call to an undefined method \\$this\\(Vonage\\\\Client\\\\Exception\\\\Request\\)&Vonage\\\\Entity\\\\Hydrator\\\\ArrayHydrateInterface\\:\\:getResponseData\\(\\)\\.$#"
35 | 			count: 1
36 | 			path: src/Client/Exception/Request.php
37 | 
38 | 		-
39 | 			message: "#^Access to an undefined property Vonage\\\\Client\\\\Exception\\\\Server\\:\\:\\$data\\.$#"
40 | 			count: 1
41 | 			path: src/Client/Exception/Server.php
42 | 
43 | 		-
44 | 			message: "#^Call to an undefined method \\$this\\(Vonage\\\\Client\\\\Exception\\\\Server\\)&Vonage\\\\Entity\\\\Hydrator\\\\ArrayHydrateInterface\\:\\:getResponseData\\(\\)\\.$#"
45 | 			count: 1
46 | 			path: src/Client/Exception/Server.php
47 | 
48 | 		-
49 | 			message: "#^Unsafe usage of new static\\(\\)\\.$#"
50 | 			count: 1
51 | 			path: src/Network/Number/Response.php
52 | 
53 | 		-
54 | 			message: "#^Access to an undefined property Vonage\\\\Verify\\\\Verification\\:\\:\\$data\\.$#"
55 | 			count: 1
56 | 			path: src/Verify/Verification.php
57 | 


--------------------------------------------------------------------------------
/phpstan.neon:
--------------------------------------------------------------------------------
1 | includes:
2 |     - phpstan-baseline.neon
3 | 
4 | parameters:
5 | 	level: 0
6 | 	paths:
7 | 		- src


--------------------------------------------------------------------------------
/src/Account/Balance.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Account;
 6 | 
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | class Balance implements
10 |     ArrayHydrateInterface
11 | {
12 |     protected array $data;
13 | 
14 |     public function __construct(float $balance, bool $autoReload)
15 |     {
16 |         $this->data['balance'] = $balance;
17 |         $this->data['auto_reload'] = $autoReload;
18 |     }
19 | 
20 |     public function getBalance(): float
21 |     {
22 |         return $this->data['balance'];
23 |     }
24 | 
25 |     public function getAutoReload(): bool
26 |     {
27 |         return $this->data['auto_reload'];
28 |     }
29 | 
30 |     public function fromArray(array $data): void
31 |     {
32 |         $this->data = [
33 |             'balance' => $data['value'],
34 |             'auto_reload' => $data['autoReload']
35 |         ];
36 |     }
37 | 
38 |     public function toArray(): array
39 |     {
40 |         return $this->data;
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Account/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Account;
 6 | 
 7 | use Psr\Container\ContainerInterface;
 8 | use Vonage\Client\APIResource;
 9 | use Vonage\Client\Credentials\Handler\BasicHandler;
10 | 
11 | class ClientFactory
12 | {
13 |     public function __invoke(ContainerInterface $container): Client
14 |     {
15 |         /** @var APIResource $accountApi */
16 |         $accountApi = $container->make(APIResource::class);
17 |         $accountApi
18 |             ->setBaseUrl($accountApi->getClient()->getRestUrl())
19 |             ->setIsHAL(false)
20 |             ->setBaseUri('/account')
21 |             ->setAuthHandlers(new BasicHandler())
22 |         ;
23 | 
24 |         return new Client($accountApi);
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Account/Network.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Account;
 6 | 
 7 | use Vonage\Entity\EntityInterface;
 8 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 9 | use Vonage\Entity\JsonResponseTrait;
10 | use Vonage\Entity\JsonSerializableTrait;
11 | use Vonage\Entity\NoRequestResponseTrait;
12 | 
13 | use function ltrim;
14 | use function preg_replace;
15 | use function strtolower;
16 | 
17 | class Network implements
18 |     EntityInterface,
19 |     ArrayHydrateInterface
20 | {
21 |     use JsonSerializableTrait;
22 |     use NoRequestResponseTrait;
23 |     use JsonResponseTrait;
24 | 
25 |     protected array $data = [];
26 | 
27 |     public function __construct(int|string $networkCode, int|string $networkName)
28 |     {
29 |         $this->data['network_code'] = (string)$networkCode;
30 |         $this->data['network_name'] = (string)$networkName;
31 |     }
32 | 
33 |     public function getCode(): string
34 |     {
35 |         return $this->data['network_code'];
36 |     }
37 | 
38 |     public function getName(): string
39 |     {
40 |         return $this->data['network_name'];
41 |     }
42 | 
43 |     public function getOutboundSmsPrice(): mixed
44 |     {
45 |         return $this->data['sms_price'] ?? $this->data['price'];
46 |     }
47 | 
48 |     public function getOutboundVoicePrice(): mixed
49 |     {
50 |         return $this->data['voice_price'] ?? $this->data['price'];
51 |     }
52 | 
53 |     public function getPrefixPrice()
54 |     {
55 |         return $this->data['mt_price'];
56 |     }
57 | 
58 |     public function getCurrency()
59 |     {
60 |         return $this->data['currency'];
61 |     }
62 | 
63 |     public function fromArray(array $data): void
64 |     {
65 |         // Convert CamelCase to snake_case as that's how we use array access in every other object
66 |         $storage = [];
67 | 
68 |         foreach ($data as $k => $v) {
69 |             $k = strtolower(ltrim((string) preg_replace('/[A-Z]([A-Z](?![a-z]))*/', '_$0', $k), '_'));
70 |             $storage[$k] = $v;
71 |         }
72 | 
73 |         $this->data = $storage;
74 |     }
75 | 
76 |     public function toArray(): array
77 |     {
78 |         return $this->data;
79 |     }
80 | }
81 | 


--------------------------------------------------------------------------------
/src/Account/PrefixPrice.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Account;
 6 | 
 7 | use Vonage\Client\Exception\Exception as ClientException;
 8 | 
 9 | class PrefixPrice extends Price
10 | {
11 |     protected string $priceMethod = 'getPrefixPrice';
12 | 
13 |     public function getCurrency(): ?string
14 |     {
15 |         throw new ClientException('Currency is unavailable from this endpoint');
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Account/SmsPrice.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Account;
 6 | 
 7 | class SmsPrice extends Price
 8 | {
 9 |     protected string $priceMethod = 'getOutboundSmsPrice';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Account/VoicePrice.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Account;
 6 | 
 7 | class VoicePrice extends Price
 8 | {
 9 |     protected string $priceMethod = 'getOutboundVoicePrice';
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Application/ApplicationInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Application;
 6 | 
 7 | use Vonage\Entity\EntityInterface;
 8 | 
 9 | interface ApplicationInterface extends EntityInterface
10 | {
11 |     public function getId(): ?string;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Application/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Application;
 6 | 
 7 | use Psr\Container\ContainerInterface;
 8 | use Vonage\Client\APIResource;
 9 | use Vonage\Client\Credentials\Handler\BasicHandler;
10 | 
11 | class ClientFactory
12 | {
13 |     public function __invoke(ContainerInterface $container): Client
14 |     {
15 |         /** @var APIResource $api */
16 |         $api = $container->make(APIResource::class);
17 |         $api
18 |             ->setBaseUri('/v2/applications')
19 |             ->setCollectionName('applications')
20 |             ->setAuthHandlers(new BasicHandler());
21 | 
22 |         return new Client($api, new Hydrator());
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Application/MessagesConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Application;
 6 | 
 7 | use function trigger_error;
 8 | 
 9 | class MessagesConfig
10 | {
11 |     public const INBOUND = 'inbound_url';
12 |     public const STATUS = 'status_url';
13 | 
14 |     protected array $webhooks = [];
15 | 
16 |     public function setWebhook($type, $url, $method = null): self
17 |     {
18 |         if (!$url instanceof Webhook) {
19 |             trigger_error(
20 |                 'Passing a string URL and method are deprecated, please pass a Webhook object instead',
21 |                 E_USER_DEPRECATED
22 |             );
23 | 
24 |             $url = new Webhook($url, $method);
25 |         }
26 | 
27 |         $this->webhooks[$type] = $url;
28 | 
29 |         return $this;
30 |     }
31 | 
32 |     public function getWebhook($type)
33 |     {
34 |         return $this->webhooks[$type] ?? null;
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Application/RtcConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Application;
 6 | 
 7 | use function trigger_error;
 8 | 
 9 | class RtcConfig
10 | {
11 |     public const EVENT = 'event_url';
12 | 
13 |     protected array $webhooks = [];
14 | 
15 |     public function setWebhook($type, $url, $method = null): self
16 |     {
17 |         if (!$url instanceof Webhook) {
18 |             trigger_error(
19 |                 'Passing a string URL and method are deprecated, please pass a Webhook object instead',
20 |                 E_USER_DEPRECATED
21 |             );
22 | 
23 |             $url = new Webhook($url, $method);
24 |         }
25 | 
26 |         $this->webhooks[$type] = $url;
27 | 
28 |         return $this;
29 |     }
30 | 
31 |     public function getWebhook($type)
32 |     {
33 |         return $this->webhooks[$type] ?? null;
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Application/VbcConfig.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Application;
 6 | 
 7 | class VbcConfig
 8 | {
 9 |     protected bool $enabled = false;
10 | 
11 |     public function enable(): void
12 |     {
13 |         $this->enabled = true;
14 |     }
15 | 
16 |     public function disable(): void
17 |     {
18 |         $this->enabled = false;
19 |     }
20 | 
21 |     public function isEnabled(): bool
22 |     {
23 |         return $this->enabled;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Application/Webhook.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Application;
 6 | 
 7 | class Webhook implements \Stringable
 8 | {
 9 |     public const METHOD_POST = 'POST';
10 |     public const METHOD_GET = 'GET';
11 |     public ?string $socketTimeout = null;
12 |     public ?string $connectionTimeout = null;
13 | 
14 |     public function __construct(protected ?string $url, protected ?string $method = self::METHOD_POST)
15 |     {
16 |     }
17 | 
18 |     public function getMethod(): ?string
19 |     {
20 |         return $this->method;
21 |     }
22 | 
23 |     public function getUrl(): ?string
24 |     {
25 |         return $this->url;
26 |     }
27 | 
28 |     public function __toString(): string
29 |     {
30 |         return (string) $this->getUrl();
31 |     }
32 | 
33 |     public function getSocketTimeout(): ?string
34 |     {
35 |         return $this->socketTimeout;
36 |     }
37 | 
38 |     public function setSocketTimeout(?string $socketTimeout): static
39 |     {
40 |         $this->socketTimeout = $socketTimeout;
41 | 
42 |         return $this;
43 |     }
44 | 
45 |     public function getConnectionTimeout(): ?string
46 |     {
47 |         return $this->connectionTimeout;
48 |     }
49 | 
50 |     public function setConnectionTimeout(?string $connectionTimeout): static
51 |     {
52 |         $this->connectionTimeout = $connectionTimeout;
53 | 
54 |         return $this;
55 |     }
56 | }
57 | 


--------------------------------------------------------------------------------
/src/Client/APIClient.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client;
 6 | 
 7 | interface APIClient
 8 | {
 9 |     public function getAPIResource(): APIResource;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Client/Callback/Callback.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Callback;
 6 | 
 7 | use InvalidArgumentException;
 8 | use RuntimeException;
 9 | 
10 | use function array_diff;
11 | use function array_keys;
12 | use function array_merge;
13 | use function implode;
14 | use function strtolower;
15 | 
16 | class Callback implements CallbackInterface
17 | {
18 |     public const ENV_ALL = 'all';
19 |     public const ENV_POST = 'post';
20 |     public const ENV_GET = 'get';
21 | 
22 |     protected array $expected = [];
23 | 
24 |     protected array $data;
25 | 
26 |     public function __construct(array $data)
27 |     {
28 |         $keys = array_keys($data);
29 |         $missing = array_diff($this->expected, $keys);
30 | 
31 |         if ($missing) {
32 |             throw new RuntimeException('missing expected callback keys: ' . implode(', ', $missing));
33 |         }
34 | 
35 |         $this->data = $data;
36 |     }
37 | 
38 |     public function getData(): array
39 |     {
40 |         return $this->data;
41 |     }
42 | 
43 |     public static function fromEnv(string $source = self::ENV_ALL): callable|Callback
44 |     {
45 |         $data = match (strtolower($source)) {
46 |             'post' => $_POST,
47 |             'get' => $_GET,
48 |             'all' => array_merge($_GET, $_POST),
49 |             default => throw new InvalidArgumentException('invalid source: ' . $source),
50 |         };
51 | 
52 |         return new static($data);
53 |     }
54 | }
55 | 


--------------------------------------------------------------------------------
/src/Client/Callback/CallbackInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Callback;
 6 | 
 7 | interface CallbackInterface
 8 | {
 9 |     public function getData();
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Client/ClientAwareInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client;
 6 | 
 7 | use Vonage\Client;
 8 | 
 9 | interface ClientAwareInterface
10 | {
11 |     public function setClient(Client $client);
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Client/ClientAwareTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client;
 6 | 
 7 | use RuntimeException;
 8 | use Vonage\Client;
 9 | 
10 | trait ClientAwareTrait
11 | {
12 |     /**
13 |      * @var Client
14 |      */
15 |     protected $client;
16 | 
17 |     public function setClient(Client $client): self
18 |     {
19 |         $this->client = $client;
20 | 
21 |         return $this;
22 |     }
23 | 
24 |     public function getClient(): ?Client
25 |     {
26 |         if (isset($this->client)) {
27 |             return $this->client;
28 |         }
29 | 
30 |         throw new RuntimeException('Vonage\Client not set');
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/AbstractCredentials.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Credentials;
 6 | 
 7 | abstract class AbstractCredentials implements CredentialsInterface
 8 | {
 9 |     protected array $credentials = [];
10 | 
11 |     /**
12 |      * @noinspection MagicMethodsValidityInspection
13 |      */
14 |     public function __get($name)
15 |     {
16 |         return $this->credentials[$name];
17 |     }
18 | 
19 |     public function asArray(): array
20 |     {
21 |         return $this->credentials;
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Basic.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Credentials;
 6 | 
 7 | /**
 8 |  * Class Basic
 9 |  * Read-only container for api key and secret.
10 |  */
11 | class Basic extends AbstractCredentials
12 | {
13 |     /**
14 |      * Create a credential set with an API key and secret.
15 |      */
16 |     public function __construct($key, $secret)
17 |     {
18 |         $this->credentials['api_key'] = (string)$key;
19 |         $this->credentials['api_secret'] = (string)$secret;
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Container.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Credentials;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | use function func_get_args;
10 | use function is_array;
11 | 
12 | class Container extends AbstractCredentials
13 | {
14 |     protected array $types = [
15 |         Basic::class,
16 |         SignatureSecret::class,
17 |         Keypair::class,
18 |         Gnp::class
19 |     ];
20 | 
21 |     /**
22 |      * @var array
23 |      */
24 |     protected array $credentials;
25 | 
26 |     public function __construct($credentials)
27 |     {
28 |         if (!is_array($credentials)) {
29 |             $credentials = func_get_args();
30 |         }
31 | 
32 |         foreach ($credentials as $credential) {
33 |             $this->addCredential($credential);
34 |         }
35 |     }
36 | 
37 |     protected function addCredential(CredentialsInterface $credential): void
38 |     {
39 |         $type = $this->getType($credential);
40 | 
41 |         if (isset($this->credentials[$type])) {
42 |             throw new RuntimeException('can not use more than one of a single credential type');
43 |         }
44 | 
45 |         $this->credentials[$type] = $credential;
46 |     }
47 | 
48 |     protected function getType(CredentialsInterface $credential): ?string
49 |     {
50 |         foreach ($this->types as $type) {
51 |             if ($credential instanceof $type) {
52 |                 return $type;
53 |             }
54 |         }
55 | 
56 |         return null;
57 |     }
58 | 
59 |     public function get($type)
60 |     {
61 |         if (!isset($this->credentials[$type])) {
62 |             throw new RuntimeException('credential not set');
63 |         }
64 | 
65 |         return $this->credentials[$type];
66 |     }
67 | 
68 |     public function has($type): bool
69 |     {
70 |         return isset($this->credentials[$type]);
71 |     }
72 | 
73 |     public function generateJwt($claims)
74 |     {
75 |         return $this->credentials[Keypair::class]->generateJwt($claims);
76 |     }
77 | }
78 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/CredentialsInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Credentials;
 6 | 
 7 | interface CredentialsInterface
 8 | {
 9 |     public function asArray();
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Handler/AbstractHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Client\Credentials\Handler;
 4 | 
 5 | use Psr\Http\Message\RequestInterface;
 6 | use Vonage\Client\Credentials\Container;
 7 | use Vonage\Client\Credentials\CredentialsInterface;
 8 | 
 9 | abstract class AbstractHandler implements HandlerInterface
10 | {
11 |     abstract public function __invoke(RequestInterface $request, CredentialsInterface $credentials): RequestInterface;
12 | 
13 |     protected function extract(string $class, CredentialsInterface $credentials): CredentialsInterface
14 |     {
15 |         if ($credentials instanceof $class) {
16 |             return $credentials;
17 |         }
18 | 
19 |         if ($credentials instanceof Container) {
20 |             $creds = $credentials->get($class);
21 |             if (!is_null($creds)) {
22 |                 return $creds;
23 |             }
24 |         }
25 | 
26 |         throw new \RuntimeException('Requested auth type not found');
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Handler/BasicHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Client\Credentials\Handler;
 4 | 
 5 | use Psr\Http\Message\RequestInterface;
 6 | use Vonage\Client\Credentials\Basic;
 7 | use Vonage\Client\Credentials\CredentialsInterface;
 8 | 
 9 | class BasicHandler extends AbstractHandler
10 | {
11 |     public function __invoke(RequestInterface $request, CredentialsInterface $credentials): RequestInterface
12 |     {
13 |         $credentials = $this->extract(Basic::class, $credentials);
14 | 
15 |         $c = $credentials->asArray();
16 |         $cx = base64_encode($c['api_key'] . ':' . $c['api_secret']);
17 | 
18 |         return $request->withHeader('Authorization', 'Basic ' . $cx);
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Handler/BasicQueryHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Client\Credentials\Handler;
 4 | 
 5 | use Psr\Http\Message\RequestInterface;
 6 | use Vonage\Client\Credentials\Basic;
 7 | use Vonage\Client\Credentials\CredentialsInterface;
 8 | 
 9 | class BasicQueryHandler extends AbstractHandler
10 | {
11 |     public function __invoke(RequestInterface $request, CredentialsInterface $credentials): RequestInterface
12 |     {
13 |         $credentials = $this->extract(Basic::class, $credentials);
14 |         parse_str($request->getUri()->getQuery(), $query);
15 |         $query = array_merge($query, $credentials->asArray());
16 | 
17 |         return $request->withUri($request->getUri()->withQuery(http_build_query($query)));
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Handler/GnpKeypairHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Client\Credentials\Handler;
 4 | 
 5 | use Psr\Http\Message\RequestInterface;
 6 | use Vonage\Client\Credentials\CredentialsInterface;
 7 | use Vonage\Client\Credentials\Gnp;
 8 | use Vonage\Client\Credentials\Keypair;
 9 | 
10 | class GnpKeypairHandler extends AbstractHandler
11 | {
12 |     public function __invoke(RequestInterface $request, CredentialsInterface $credentials): RequestInterface
13 |     {
14 |         /** @var Keypair $credentials  */
15 |         $credentials = $this->extract(Gnp::class, $credentials);
16 |         $token = $credentials->generateJwt();
17 | 
18 |         return $request->withHeader('Authorization', 'Bearer ' . $token->toString());
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Handler/HandlerInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Client\Credentials\Handler;
 4 | 
 5 | use Psr\Http\Message\RequestInterface;
 6 | use Vonage\Client\Credentials\CredentialsInterface;
 7 | 
 8 | interface HandlerInterface
 9 | {
10 |     /**
11 |      * Add authentication to a request
12 |      */
13 |     public function __invoke(RequestInterface $request, CredentialsInterface $credentials): RequestInterface;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Handler/KeypairHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Client\Credentials\Handler;
 4 | 
 5 | use Psr\Http\Message\RequestInterface;
 6 | use Vonage\Client\Credentials\CredentialsInterface;
 7 | use Vonage\Client\Credentials\Keypair;
 8 | 
 9 | class KeypairHandler extends AbstractHandler
10 | {
11 |     public function __invoke(RequestInterface $request, CredentialsInterface $credentials): RequestInterface
12 |     {
13 |         /** @var Keypair $credentials  */
14 |         $credentials = $this->extract(Keypair::class, $credentials);
15 |         $token = $credentials->generateJwt();
16 | 
17 |         return $request->withHeader('Authorization', 'Bearer ' . $token->toString());
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Handler/NumberVerificationGnpHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Client\Credentials\Handler;
 4 | 
 5 | use Psr\Http\Message\RequestInterface;
 6 | use Vonage\Client;
 7 | use Vonage\Client\APIResource;
 8 | use Vonage\Client\Credentials\CredentialsInterface;
 9 | use Vonage\Client\Credentials\Gnp;
10 | 
11 | /**
12 |  * This handler is for Vonage GNP APIs that require the CAMARA standard OAuth Flow
13 |  */
14 | class NumberVerificationGnpHandler extends SimSwapGnpHandler
15 | {
16 |     use Client\ClientAwareTrait;
17 |     use Client\ScopeAwareTrait;
18 | 
19 |     protected ?string $baseUrl = null;
20 |     protected ?string $tokenUrl = null;
21 | 
22 |     public function getBaseUrl(): ?string
23 |     {
24 |         return $this->baseUrl;
25 |     }
26 | 
27 |     public function setBaseUrl(?string $baseUrl): NumberVerificationGnpHandler
28 |     {
29 |         $this->baseUrl = $baseUrl;
30 |         return $this;
31 |     }
32 | 
33 |     public function getTokenUrl(): ?string
34 |     {
35 |         return $this->tokenUrl;
36 |     }
37 | 
38 |     public function setTokenUrl(?string $tokenUrl): NumberVerificationGnpHandler
39 |     {
40 |         $this->tokenUrl = $tokenUrl;
41 |         return $this;
42 |     }
43 | 
44 |     public function __invoke(RequestInterface $request, CredentialsInterface $credentials): RequestInterface
45 |     {
46 |         /** @var Gnp $credentials  */
47 |         $credentials = $this->extract(Gnp::class, $credentials);
48 | 
49 |         // submit the code to CAMARA endpoint
50 |         $api = new APIResource();
51 |         $api->setAuthHandlers(new GnpKeypairHandler());
52 |         $api->setClient($this->getClient());
53 |         $api->setBaseUrl('https://api-eu.vonage.com/oauth2/token');
54 | 
55 |         $tokenResponse = $api->submit([
56 |             'grant_type' => 'authorization_code',
57 |             'code' => $credentials->getCode(),
58 |             'redirect_uri' => $credentials->getRedirectUri()
59 |         ]);
60 | 
61 |         $payload = json_decode($tokenResponse, true);
62 | 
63 |         // Add CAMARA Access Token to request and return to make API call
64 |         return $request->withHeader('Authorization', 'Bearer ' . $payload['access_token']);
65 |     }
66 | }
67 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Handler/SignatureBodyFormHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Client\Credentials\Handler;
 4 | 
 5 | use GuzzleHttp\Psr7\Utils;
 6 | use Psr\Http\Message\RequestInterface;
 7 | use Vonage\Client\Credentials\CredentialsInterface;
 8 | use Vonage\Client\Credentials\SignatureSecret;
 9 | use Vonage\Client\Signature;
10 | 
11 | class SignatureBodyFormHandler extends AbstractHandler
12 | {
13 |     public function __invoke(RequestInterface $request, CredentialsInterface $credentials): RequestInterface
14 |     {
15 |         $credentials = $this->extract(SignatureSecret::class, $credentials);
16 |         $credentialsArray = $credentials->asArray();
17 | 
18 |         $body = $request->getBody();
19 |         $body->rewind();
20 |         $content = $body->getContents();
21 | 
22 |         $params = [];
23 |         parse_str($content, $params);
24 |         $params['api_key'] = $credentialsArray['api_key'];
25 | 
26 |         $signature = new Signature(
27 |             $params,
28 |             $credentialsArray['signature_secret'],
29 |             $credentialsArray['signature_method']
30 |         );
31 | 
32 |         $params = $signature->getSignedParams();
33 | 
34 |         $newBody = Utils::streamFor(http_build_query($params, '', '&'));
35 |         return $request->withBody($newBody);
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Handler/SignatureBodyHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Client\Credentials\Handler;
 4 | 
 5 | use Psr\Http\Message\RequestInterface;
 6 | use Vonage\Client\Credentials\CredentialsInterface;
 7 | use Vonage\Client\Credentials\SignatureSecret;
 8 | use Vonage\Client\Signature;
 9 | 
10 | class SignatureBodyHandler extends AbstractHandler
11 | {
12 |     public function __invoke(RequestInterface $request, CredentialsInterface $credentials): RequestInterface
13 |     {
14 |         $credentials = $this->extract(SignatureSecret::class, $credentials);
15 |         $credentialsArray = $credentials->asArray();
16 | 
17 |         $body = $request->getBody();
18 |         $body->rewind();
19 |         $content = $body->getContents();
20 |         $params = json_decode($content, true);
21 |         $params['api_key'] = $credentialsArray['api_key'];
22 | 
23 |         $signature = new Signature(
24 |             $params,
25 |             $credentialsArray['signature_secret'],
26 |             $credentialsArray['signature_method']
27 |         );
28 | 
29 |         $body->rewind();
30 |         $body->write(json_encode($signature->getSignedParams()));
31 | 
32 |         return $request;
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Handler/SignatureQueryHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Client\Credentials\Handler;
 4 | 
 5 | use Psr\Http\Message\RequestInterface;
 6 | use Vonage\Client\Credentials\CredentialsInterface;
 7 | use Vonage\Client\Credentials\SignatureSecret;
 8 | use Vonage\Client\Signature;
 9 | 
10 | class SignatureQueryHandler extends AbstractHandler
11 | {
12 |     public function __invoke(RequestInterface $request, CredentialsInterface $credentials): RequestInterface
13 |     {
14 |         $credentials = $this->extract(SignatureSecret::class, $credentials);
15 |         $credentialsArray = $credentials->asArray();
16 | 
17 |         $query = [];
18 |         parse_str($request->getUri()->getQuery(), $query);
19 |         $query['api_key'] = $credentialsArray['api_key'];
20 | 
21 |         $signature = new Signature(
22 |             $query,
23 |             $credentialsArray['signature_secret'],
24 |             $credentialsArray['signature_method']
25 |         );
26 | 
27 |         return $request->withUri(
28 |             $request->getUri()->withQuery(http_build_query($signature->getSignedParams()))
29 |         );
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Handler/TokenBodyFormHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Client\Credentials\Handler;
 4 | 
 5 | use Vonage\Client\Credentials\Basic;
 6 | use Psr\Http\Message\RequestInterface;
 7 | use Vonage\Client\Credentials\CredentialsInterface;
 8 | 
 9 | class TokenBodyFormHandler extends AbstractHandler
10 | {
11 |     public function __invoke(RequestInterface $request, CredentialsInterface $credentials): RequestInterface
12 |     {
13 |         $credentials = $this->extract(Basic::class, $credentials);
14 |         $body = $request->getBody();
15 |         $body->rewind();
16 |         $content = $body->getContents();
17 |         $params = [];
18 |         parse_str($content, $params);
19 |         $params = array_merge($params, $credentials->asArray());
20 |         $body->rewind();
21 |         $body->write(http_build_query($params, '', '&'));
22 | 
23 |         return $request;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Handler/TokenBodyHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Client\Credentials\Handler;
 4 | 
 5 | use Vonage\Client\Credentials\Basic;
 6 | use Psr\Http\Message\RequestInterface;
 7 | use Vonage\Client\Credentials\CredentialsInterface;
 8 | 
 9 | class TokenBodyHandler extends AbstractHandler
10 | {
11 |     public function __invoke(RequestInterface $request, CredentialsInterface $credentials): RequestInterface
12 |     {
13 |         $credentials = $this->extract(Basic::class, $credentials);
14 | 
15 |         // We have to do some clunky body pointer rewinding here
16 |         $existingBody = $request->getBody();
17 |         $existingBody->rewind();
18 |         $existingBodyContent = $existingBody->getContents();
19 |         $existingBody->rewind();
20 |         $existingBodyArray = json_decode($existingBodyContent, true);
21 | 
22 |         // The request body will now be the existing body plus the basic creds
23 |         $mergedBodyArray = array_merge($existingBodyArray, $credentials->asArray());
24 | 
25 |         return $request->withBody(\GuzzleHttp\Psr7\Utils::streamFor(json_encode($mergedBodyArray)));
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/Handler/TokenQueryHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Client\Credentials\Handler;
 4 | 
 5 | use Vonage\Client\Credentials\Basic;
 6 | use Psr\Http\Message\RequestInterface;
 7 | use Vonage\Client\Credentials\CredentialsInterface;
 8 | 
 9 | class TokenQueryHandler extends AbstractHandler
10 | {
11 |     public function __invoke(RequestInterface $request, CredentialsInterface $credentials): RequestInterface
12 |     {
13 |         $credentials = $this->extract(Basic::class, $credentials);
14 |         $query = [];
15 |         parse_str($request->getUri()->getQuery(), $query);
16 |         $query = array_merge($query, $credentials->asArray());
17 | 
18 |         $request = $request->withUri($request->getUri()->withQuery(http_build_query($query)));
19 | 
20 |         return $request;
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Client/Credentials/SignatureSecret.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Credentials;
 6 | 
 7 | class SignatureSecret extends AbstractCredentials
 8 | {
 9 |     /**
10 |      * Create a credential set with an API key and signature secret.
11 |      */
12 |     public function __construct($key, $signature_secret, string $method = 'md5hash')
13 |     {
14 |         $this->credentials['api_key'] = $key;
15 |         $this->credentials['signature_secret'] = $signature_secret;
16 |         $this->credentials['signature_method'] = $method;
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Client/Exception/Conflict.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Exception;
 6 | 
 7 | class Conflict extends \Exception
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Client/Exception/Credentials.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Exception;
 6 | 
 7 | class Credentials extends \Exception
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Client/Exception/Exception.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Exception;
 6 | 
 7 | class Exception extends \Exception
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Client/Exception/NotFound.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Exception;
 6 | 
 7 | class NotFound extends \Exception
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Client/Exception/Request.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Exception;
 6 | 
 7 | use Vonage\Entity\HasEntityTrait;
 8 | use Vonage\Entity\Psr7Trait;
 9 | 
10 | class Request extends Exception
11 | {
12 |     use HasEntityTrait;
13 |     use Psr7Trait;
14 | 
15 |     protected string $requestId;
16 |     protected string $networkId;
17 | 
18 |     public function setRequestId(string $requestId): void
19 |     {
20 |         $this->requestId = $requestId;
21 |     }
22 | 
23 |     public function getRequestId(): string
24 |     {
25 |         return $this->requestId;
26 |     }
27 | 
28 |     public function setNetworkId(string $networkId): void
29 |     {
30 |         $this->networkId = $networkId;
31 |     }
32 | 
33 |     public function getNetworkId(): string
34 |     {
35 |         return $this->networkId;
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/Client/Exception/Server.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Exception;
 6 | 
 7 | use Vonage\Entity\HasEntityTrait;
 8 | use Vonage\Entity\Psr7Trait;
 9 | 
10 | class Server extends Exception
11 | {
12 |     use HasEntityTrait;
13 |     use Psr7Trait;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Client/Exception/ThrottleException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Exception;
 6 | 
 7 | class ThrottleException extends Server
 8 | {
 9 |     /**
10 |      * @var int
11 |      */
12 |     protected $timeout;
13 | 
14 |     public function setTimeout(int $seconds): void
15 |     {
16 |         $this->timeout = $seconds;
17 |     }
18 | 
19 |     public function getTimeout(): int
20 |     {
21 |         return $this->timeout;
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Client/Exception/Transport.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Exception;
 6 | 
 7 | class Transport extends Exception
 8 | {
 9 | }
10 | 


--------------------------------------------------------------------------------
/src/Client/Exception/Validation.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Exception;
 6 | 
 7 | use Throwable;
 8 | 
 9 | class Validation extends Request
10 | {
11 |     public function __construct(
12 |         string $message = '',
13 |         int $code = 0,
14 |         ?Throwable $previous = null,
15 |         private readonly array $errors = []
16 |     ) {
17 |         parent::__construct($message, $code, $previous);
18 |     }
19 | 
20 |     public function getValidationErrors(): array
21 |     {
22 |         return $this->errors;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Client/Factory/FactoryInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Factory;
 6 | 
 7 | /**
 8 |  * Interface FactoryInterface
 9 |  *
10 |  * Factor create API clients (clients specific to single API, that leverages Vonage\Client for HTTP communication and
11 |  * common functionality).
12 |  */
13 | interface FactoryInterface
14 | {
15 |     public function hasApi(string $api): bool;
16 | 
17 |     public function getApi(string $api);
18 | 
19 |     public function make(string $key);
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Client/InvalidResponseException.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client;
 6 | 
 7 | use Exception;
 8 | 
 9 | class InvalidResponseException extends Exception
10 | {
11 | }
12 | 


--------------------------------------------------------------------------------
/src/Client/Request/AbstractRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Request;
 6 | 
 7 | use function array_filter;
 8 | 
 9 | abstract class AbstractRequest implements RequestInterface
10 | {
11 |     /**
12 |      * @var array
13 |      */
14 |     protected $params = [];
15 | 
16 |     public function getParams(): array
17 |     {
18 |         return array_filter($this->params, 'is_scalar');
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Client/Request/RequestInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Request;
 6 | 
 7 | interface RequestInterface
 8 | {
 9 |     public function getParams(): array;
10 | 
11 |     public function getURI(): string;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Client/Request/WrapResponseInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Request;
 6 | 
 7 | use Vonage\Client\Response\ResponseInterface;
 8 | 
 9 | interface WrapResponseInterface
10 | {
11 |     public function wrapResponse(ResponseInterface $response): ResponseInterface;
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Client/Response/AbstractResponse.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Response;
 6 | 
 7 | abstract class AbstractResponse implements ResponseInterface
 8 | {
 9 |     /**
10 |      * @var array
11 |      */
12 |     protected $data;
13 | 
14 |     public function getData(): array
15 |     {
16 |         return $this->data;
17 |     }
18 | 
19 |     public function isSuccess(): bool
20 |     {
21 |         return isset($this->data['status']) && (int)$this->data['status'] === 0;
22 |     }
23 | 
24 |     public function isError(): bool
25 |     {
26 |         return !$this->isSuccess();
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Client/Response/Error.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Response;
 6 | 
 7 | class Error extends Response
 8 | {
 9 |     public function __construct(array $data)
10 |     {
11 |         //normalize the data
12 |         if (isset($data['error_text'])) {
13 |             $data['error-text'] = $data['error_text'];
14 |         }
15 | 
16 |         $this->expected = ['status', 'error-text'];
17 | 
18 |         parent::__construct($data);
19 |     }
20 | 
21 |     public function isError(): bool
22 |     {
23 |         return true;
24 |     }
25 | 
26 |     public function isSuccess(): bool
27 |     {
28 |         return false;
29 |     }
30 | 
31 |     public function getCode(): int
32 |     {
33 |         return (int)$this->data['status'];
34 |     }
35 | 
36 |     public function getMessage(): string
37 |     {
38 |         return (string)$this->data['error-text'];
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Client/Response/Response.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Response;
 6 | 
 7 | use RuntimeException;
 8 | 
 9 | use function array_diff;
10 | use function array_keys;
11 | use function implode;
12 | 
13 | class Response extends AbstractResponse
14 | {
15 |     /**
16 |      * Allow specific responses to easily define required parameters.
17 |      *
18 |      * @var array
19 |      */
20 |     protected $expected = [];
21 | 
22 |     public function __construct(array $data)
23 |     {
24 |         $keys = array_keys($data);
25 |         $missing = array_diff($this->expected, $keys);
26 | 
27 |         if ($missing) {
28 |             throw new RuntimeException('missing expected response keys: ' . implode(', ', $missing));
29 |         }
30 | 
31 |         $this->data = $data;
32 |     }
33 | }
34 | 


--------------------------------------------------------------------------------
/src/Client/Response/ResponseInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client\Response;
 6 | 
 7 | interface ResponseInterface
 8 | {
 9 |     public function getData(): array;
10 | 
11 |     public function isError(): bool;
12 | 
13 |     public function isSuccess(): bool;
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Client/ScopeAwareTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Client;
 6 | 
 7 | use RuntimeException;
 8 | use Vonage\Client;
 9 | 
10 | trait ScopeAwareTrait
11 | {
12 |     protected ?string $scope = null;
13 | 
14 |     public function setScope(string $scope): self
15 |     {
16 |         $this->scope = $scope;
17 | 
18 |         return $this;
19 |     }
20 | 
21 |     public function getScope(): ?string
22 |     {
23 |         return $this->scope;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Conversation/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Conversation;
 4 | 
 5 | use Psr\Container\ContainerInterface;
 6 | use Vonage\Client\APIResource;
 7 | use Vonage\Client\Credentials\Handler\KeypairHandler;
 8 | 
 9 | class ClientFactory
10 | {
11 |     public function __invoke(ContainerInterface $container): Client
12 |     {
13 |         /** @var APIResource $api */
14 |         $api = $container->make(APIResource::class);
15 |         $api->setIsHAL(true)
16 |             ->setErrorsOn200(false)
17 |             ->setAuthHandlers(new KeypairHandler())
18 |             ->setBaseUrl('https://api.nexmo.com/v1/conversations');
19 | 
20 |         return new Client($api);
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Conversation/ConversationObjects/Conversation.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Conversation\ConversationObjects;
 6 | 
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | class Conversation implements ArrayHydrateInterface
10 | {
11 |     protected array $data;
12 | 
13 |     public function __construct()
14 |     {
15 |     }
16 | 
17 |     public function fromArray(array $data): void
18 |     {
19 |         $this->data = $data;
20 |     }
21 | 
22 |     public function toArray(): array
23 |     {
24 |         return $this->data;
25 |     }
26 | 
27 |     public function __get(string $name)
28 |     {
29 |         return $this->data[$name];
30 |     }
31 | 
32 |     public function __set(string $name, $value)
33 |     {
34 |         $this->data[$name] = $value;
35 |     }
36 | 
37 |     public function __isset(string $name): bool
38 |     {
39 |         return isset($this->data[$name]);
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Conversation/ConversationObjects/ConversationNumber.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Conversation\ConversationObjects;
 6 | 
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | class ConversationNumber implements ArrayHydrateInterface
10 | {
11 |     public const PHONE_TYPE = 'phone';
12 | 
13 |     protected string $type = self::PHONE_TYPE;
14 | 
15 |     public function __construct(
16 |         protected ?string $number,
17 |     ) {
18 |     }
19 | 
20 |     public function getType(): string
21 |     {
22 |         return $this->type;
23 |     }
24 | 
25 |     public function getNumber(): ?string
26 |     {
27 |         return $this->number;
28 |     }
29 | 
30 |     public function setNumber(?string $number): ConversationNumber
31 |     {
32 |         $this->number = $number;
33 | 
34 |         return $this;
35 |     }
36 | 
37 |     public function fromArray(array $data): static
38 |     {
39 |         if (isset($data['number'])) {
40 |             $this->number = $data['number'];
41 |         }
42 | 
43 |         return $this;
44 |     }
45 | 
46 |     public function toArray(): array
47 |     {
48 |         return [
49 |             'type' => $this->getType(),
50 |             'number' => $this->getNumber()
51 |         ];
52 |     }
53 | }
54 | 


--------------------------------------------------------------------------------
/src/Conversation/ConversationObjects/Event.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Conversation\ConversationObjects;
 6 | 
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | class Event implements ArrayHydrateInterface
10 | {
11 |     protected array $data;
12 | 
13 |     public function __construct()
14 |     {
15 |     }
16 | 
17 |     public function fromArray(array $data): void
18 |     {
19 |         $this->data = $data;
20 |     }
21 | 
22 |     public function toArray(): array
23 |     {
24 |         return $this->data;
25 |     }
26 | 
27 |     public function __get(string $name)
28 |     {
29 |         return $this->data[$name];
30 |     }
31 | 
32 |     public function __set(string $name, $value)
33 |     {
34 |         $this->data[$name] = $value;
35 |     }
36 | 
37 |     public function __isset(string $name): bool
38 |     {
39 |         return isset($this->data[$name]);
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Conversation/ConversationObjects/EventRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Conversation\ConversationObjects;
 6 | 
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | class EventRequest implements ArrayHydrateInterface
10 | {
11 |     public function __construct(
12 |         protected string $conversationId,
13 |         protected string $eventType,
14 |         protected string $from,
15 |         protected array $body
16 |     ) {
17 |     }
18 | 
19 |     public function toArray(): array
20 |     {
21 |         return [
22 |             'type' => $this->getEventType(),
23 |             'from' => $this->getFrom(),
24 |             'body' => $this->getBody()
25 |         ];
26 |     }
27 | 
28 |     public function fromArray(array $data): EventRequest
29 |     {
30 |         $this->from = $data['from'];
31 |         $this->eventType = $data['type'];
32 |         $this->body = $data['body'];
33 | 
34 |         return $this;
35 |     }
36 | 
37 |     public function getEventType(): string
38 |     {
39 |         return $this->eventType;
40 |     }
41 | 
42 |     public function setEventType(string $eventType): EventRequest
43 |     {
44 |         $this->eventType = $eventType;
45 | 
46 |         return $this;
47 |     }
48 | 
49 |     public function getFrom(): string
50 |     {
51 |         return $this->from;
52 |     }
53 | 
54 |     public function setFrom(string $from): EventRequest
55 |     {
56 |         $this->from = $from;
57 | 
58 |         return $this;
59 |     }
60 | 
61 |     public function getBody(): array
62 |     {
63 |         return $this->body;
64 |     }
65 | 
66 |     public function setBody(array $body): EventRequest
67 |     {
68 |         $this->body = $body;
69 | 
70 |         return $this;
71 |     }
72 | 
73 |     public function getConversationId(): string
74 |     {
75 |         return $this->conversationId;
76 |     }
77 | 
78 |     public function setConversationId(string $conversationId): EventRequest
79 |     {
80 |         $this->conversationId = $conversationId;
81 | 
82 |         return $this;
83 |     }
84 | }
85 | 


--------------------------------------------------------------------------------
/src/Conversation/ConversationObjects/Member.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Conversation\ConversationObjects;
 6 | 
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | class Member implements ArrayHydrateInterface
10 | {
11 |     protected array $data;
12 | 
13 |     public function __construct()
14 |     {
15 |     }
16 | 
17 |     public function fromArray(array $data): void
18 |     {
19 |         $this->data = $data;
20 |     }
21 | 
22 |     public function toArray(): array
23 |     {
24 |         return $this->data;
25 |     }
26 | 
27 |     public function __get(string $name)
28 |     {
29 |         return $this->data[$name];
30 |     }
31 | 
32 |     public function __set(string $name, $value)
33 |     {
34 |         $this->data[$name] = $value;
35 |     }
36 | 
37 |     public function __isset(string $name): bool
38 |     {
39 |         return isset($this->data[$name]);
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Conversation/ConversationObjects/UpdateConversationRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Conversation\ConversationObjects;
 6 | 
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | class UpdateConversationRequest implements ArrayHydrateInterface
10 | {
11 |     protected CreateConversationRequest $conversationRequest;
12 | 
13 |     public function __construct(
14 |         protected string $id,
15 |         protected array $data
16 |     ) {
17 |         $this->conversationRequest = new CreateConversationRequest(null, null, null);
18 |         $this->conversationRequest->fromArray($this->data);
19 |     }
20 | 
21 |     public function fromArray(array $data): static
22 |     {
23 |         $this->conversationRequest->fromArray($data);
24 | 
25 |         return $this;
26 |     }
27 | 
28 |     public function toArray(): array
29 |     {
30 |         return $this->conversationRequest->toArray();
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Conversation/Filter/ListMembersFilter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Conversation\Filter;
 6 | 
 7 | use Vonage\Entity\Filter\FilterInterface;
 8 | 
 9 | class ListMembersFilter implements FilterInterface
10 | {
11 |     protected int $pageSize = 10;
12 |     protected string $order = 'asc';
13 |     private const VALID_ORDERS = ['asc', 'ASC', 'desc', 'DESC'];
14 | 
15 |     /**
16 |      * @var string|null
17 |      * Private as you should only follow cursors provided, not set them
18 |      */
19 |     private ?string $cursor = null;
20 | 
21 |     public function __construct()
22 |     {
23 |     }
24 | 
25 |     public function getPageSize(): ?int
26 |     {
27 |         return $this->pageSize;
28 |     }
29 | 
30 |     public function setPageSize(?int $pageSize): ListMembersFilter
31 |     {
32 |         $this->pageSize = $pageSize;
33 | 
34 |         return $this;
35 |     }
36 | 
37 |     public function getOrder(): string
38 |     {
39 |         return $this->order;
40 |     }
41 | 
42 |     public function setOrder(string $order): ListMembersFilter
43 |     {
44 |         if (!in_array($order, self::VALID_ORDERS)) {
45 |             throw new \InvalidArgumentException($order . ' is an invalid order value');
46 |         }
47 | 
48 |         $this->order = $order;
49 | 
50 |         return $this;
51 |     }
52 | 
53 |     public function setCursor(?string $cursor): ListMembersFilter
54 |     {
55 |         $this->cursor = $cursor;
56 | 
57 |         return $this;
58 |     }
59 | 
60 |     public function getQuery(): array
61 |     {
62 |         $query = [];
63 | 
64 |         if ($this->getPageSize()) {
65 |             $query['page_size'] = $this->getPageSize();
66 |         }
67 | 
68 |         $query['order'] = $this->getOrder();
69 | 
70 |         return $query;
71 |     }
72 | }
73 | 


--------------------------------------------------------------------------------
/src/Conversion/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Conversion;
 6 | 
 7 | use Psr\Container\ContainerInterface;
 8 | use Vonage\Client\APIResource;
 9 | use Vonage\Client\Credentials\Handler\BasicHandler;
10 | 
11 | /**
12 |  * @TODO Finish this Namespace
13 |  */
14 | class ClientFactory
15 | {
16 |     public function __invoke(ContainerInterface $container): Client
17 |     {
18 |         /** @var APIResource $api */
19 |         $api = $container->make(APIResource::class);
20 |         $api->setBaseUri('/conversions/');
21 |         $api->setAuthHandlers(new BasicHandler());
22 | 
23 |         return new Client($api);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Entity/EntityInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity;
 6 | 
 7 | use Psr\Http\Message\RequestInterface;
 8 | use Psr\Http\Message\ResponseInterface;
 9 | 
10 | interface EntityInterface
11 | {
12 |     public function getRequest();
13 | 
14 |     public function getRequestData(bool $sent = true);
15 | 
16 |     public function getResponse();
17 | 
18 |     public function getResponseData();
19 | 
20 |     public function setResponse(ResponseInterface $response);
21 | 
22 |     public function setRequest(RequestInterface $request);
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Entity/Factory/FactoryInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity\Factory;
 6 | 
 7 | interface FactoryInterface
 8 | {
 9 |     public function create(array $data);
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Entity/Filter/DateFilter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity\Filter;
 6 | 
 7 | use DateTime;
 8 | 
 9 | /**
10 |  * Simple value object for application filtering.
11 |  */
12 | class DateFilter implements FilterInterface
13 | {
14 |     public const FORMAT = 'Y:m:d:H:i:s';
15 | 
16 |     protected DateTime $start;
17 |     protected DateTime $end;
18 | 
19 |     public function __construct(DateTime $start, DateTime $end)
20 |     {
21 |         if ($start < $end) {
22 |             $this->start = $start;
23 |             $this->end = $end;
24 |         } else {
25 |             $this->start = $end;
26 |             $this->end = $start;
27 |         }
28 |     }
29 | 
30 |     public function getQuery(): array
31 |     {
32 |         return [
33 |             'date' => $this->start->format(self::FORMAT) . '-' . $this->end->format(self::FORMAT)
34 |         ];
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Entity/Filter/EmptyFilter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity\Filter;
 6 | 
 7 | class EmptyFilter implements FilterInterface
 8 | {
 9 |     public function getQuery(): array
10 |     {
11 |         return [];
12 |     }
13 | }
14 | 


--------------------------------------------------------------------------------
/src/Entity/Filter/FilterInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity\Filter;
 6 | 
 7 | interface FilterInterface
 8 | {
 9 |     public function getQuery();
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Entity/Filter/KeyValueFilter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity\Filter;
 6 | 
 7 | /**
 8 |  * A very simple key-value filter that can be used when less magic is needed
 9 |  */
10 | class KeyValueFilter implements FilterInterface
11 | {
12 |     /**
13 |      * @param array<string, string> $query
14 |      */
15 |     public function __construct(protected array $query = [])
16 |     {
17 |     }
18 | 
19 |     public function getQuery(): array
20 |     {
21 |         return $this->query;
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Entity/HasEntityTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity;
 6 | 
 7 | trait HasEntityTrait
 8 | {
 9 |     protected $entity;
10 | 
11 |     public function setEntity($entity): void
12 |     {
13 |         $this->entity = $entity;
14 |     }
15 | 
16 |     public function getEntity()
17 |     {
18 |         return $this->entity;
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Entity/Hydrator/ArrayHydrateInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity\Hydrator;
 6 | 
 7 | /**
 8 |  * Interface for allowing an entity to be converted to/from an array
 9 |  * While the built-in `JsonSerializable` interface is nice, it's not
10 |  * always semantically correct. This provides a much more clear set
11 |  * of functions for handling this. Ideally, if an entity also
12 |  * implements `JsonSerializable`, those functions can just wrap these
13 |  */
14 | interface ArrayHydrateInterface
15 | {
16 |     public function fromArray(array $data);
17 | 
18 |     public function toArray(): array;
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Entity/Hydrator/ArrayHydrator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity\Hydrator;
 6 | 
 7 | class ArrayHydrator implements HydratorInterface
 8 | {
 9 |     protected ArrayHydrateInterface $prototype;
10 | 
11 |     public function hydrate(array $data): ArrayHydrateInterface
12 |     {
13 |         $object = clone $this->prototype;
14 |         $object->fromArray($data);
15 | 
16 |         return $object;
17 |     }
18 | 
19 |     public function hydrateObject(array $data, $object)
20 |     {
21 |         $object->fromArray($data);
22 | 
23 |         return $object;
24 |     }
25 | 
26 |     public function setPrototype(ArrayHydrateInterface $prototype): void
27 |     {
28 |         $this->prototype = $prototype;
29 |     }
30 | }
31 | 


--------------------------------------------------------------------------------
/src/Entity/Hydrator/ConstructorHydrator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity\Hydrator;
 6 | 
 7 | class ConstructorHydrator implements HydratorInterface
 8 | {
 9 |     protected string $prototype;
10 | 
11 |     public function hydrate(array $data): mixed
12 |     {
13 |         $className = $this->prototype;
14 |         return new $className($data);
15 |     }
16 | 
17 |     public function hydrateObject(array $data, $object): never
18 |     {
19 |         throw new \RuntimeException('Constructor Hydration can not happen on an existing object');
20 |     }
21 | 
22 |     public function setPrototype(string $prototype): void
23 |     {
24 |         $this->prototype = $prototype;
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Entity/Hydrator/HydratorInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity\Hydrator;
 6 | 
 7 | interface HydratorInterface
 8 | {
 9 |     /**
10 |      * Hydrate an object that the hydrator creates
11 |      */
12 |     public function hydrate(array $data);
13 | 
14 |     /**
15 |      * Hydrate an existing object created outside of the hydrator
16 |      */
17 |     public function hydrateObject(array $data, $object);
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Entity/JsonResponseTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity;
 6 | 
 7 | use Exception;
 8 | use Psr\Http\Message\ResponseInterface;
 9 | use RuntimeException;
10 | 
11 | use function json_decode;
12 | use function sprintf;
13 | 
14 | /**
15 |  * @deprecated This data will be better exposed at the model level
16 |  */
17 | trait JsonResponseTrait
18 | {
19 |     protected $responseJson;
20 | 
21 |     /**
22 |      * @throws Exception
23 |      *
24 |      * @return array|mixed
25 |      */
26 |     public function getResponseData()
27 |     {
28 |         if (!($this instanceof EntityInterface)) {
29 |             throw new RuntimeException(
30 |                 sprintf(
31 |                     '%s can only be used if the class implements %s',
32 |                     __TRAIT__,
33 |                     EntityInterface::class
34 |                 )
35 |             );
36 |         }
37 | 
38 |         /** @phpstan-ignore-next-line */
39 |         if (($response = @$this->getResponse()) && ($response instanceof ResponseInterface)) {
40 |             if ($response->getBody()->isSeekable()) {
41 |                 $response->getBody()->rewind();
42 |             }
43 | 
44 |             $body = $response->getBody()->getContents();
45 |             $this->responseJson = json_decode($body, true);
46 | 
47 |             return $this->responseJson;
48 |         }
49 | 
50 |         return [];
51 |     }
52 | }
53 | 


--------------------------------------------------------------------------------
/src/Entity/JsonSerializableInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity;
 6 | 
 7 | use JsonSerializable;
 8 | 
 9 | /**
10 |  * Identifies the Entity as using JsonSerializable to prepare request data.
11 |  */
12 | interface JsonSerializableInterface extends JsonSerializable
13 | {
14 | }
15 | 


--------------------------------------------------------------------------------
/src/Entity/JsonSerializableTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity;
 6 | 
 7 | use JsonSerializable;
 8 | use Vonage\Client\Exception\Exception as ClientException;
 9 | 
10 | use function sprintf;
11 | 
12 | /**
13 |  * Implements getRequestData from EntityInterface based on the entity's jsonSerialize().
14 |  *
15 |  * @see EntityInterface::getRequestData()
16 |  * @deprecated Each model will handle serializing to/from JSON via hydrators
17 |  */
18 | trait JsonSerializableTrait
19 | {
20 |     /**
21 |      * Get an array of params to use in an API request.
22 |      *
23 |      * @param bool $sent
24 |      *
25 |      * @throws ClientException
26 |      */
27 |     public function getRequestData($sent = true)
28 |     {
29 |         if (!($this instanceof EntityInterface)) {
30 |             throw new ClientException(
31 |                 sprintf(
32 |                     '%s can only be used if the class implements %s',
33 |                     __TRAIT__,
34 |                     EntityInterface::class
35 |                 )
36 |             );
37 |         }
38 | 
39 |         if (!($this instanceof JsonSerializable)) {
40 |             throw new ClientException(
41 |                 sprintf(
42 |                     '%s can only be used if the class implements %s',
43 |                     __TRAIT__,
44 |                     JsonSerializable::class
45 |                 )
46 |             );
47 |         }
48 | 
49 |         //TODO, figure out what the request data actually was
50 |         $sent && $this->getRequest();
51 | 
52 |         return $this->jsonSerialize();
53 |     }
54 | }
55 | 


--------------------------------------------------------------------------------
/src/Entity/JsonUnserializableInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity;
 6 | 
 7 | /**
 8 |  * Identifies the Entity as using JsonSerializable to prepare request data.
 9 |  *
10 |  * @deprecated Please use a more appropriate hydrator, like ArrayHydrator
11 |  */
12 | interface JsonUnserializableInterface
13 | {
14 |     /**
15 |      * Update the object state with the json data (as an array)
16 |      *
17 |      * @deprecated Implement ArrayHydrator instead as it is more semantically correct
18 |      */
19 |     public function jsonUnserialize(array $json): void;
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Entity/NoRequestResponseTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Entity;
 6 | 
 7 | use Psr\Http\Message\RequestInterface;
 8 | use Psr\Http\Message\ResponseInterface;
 9 | use RuntimeException;
10 | 
11 | /**
12 |  * Class NoRequestResponseTrait
13 |  *
14 |  * Allow an entity to contain last request / response objects.
15 |  *
16 |  * @deprecated This information will no longer be available at the model level but the API client level
17 |  */
18 | trait NoRequestResponseTrait
19 | {
20 |     /**
21 |      * @param ResponseInterface $response deprecated
22 |      */
23 |     public function setResponse(ResponseInterface $response): void
24 |     {
25 |         throw new RuntimeException(self::class . ' does not support request / response');
26 |     }
27 | 
28 |     /**
29 |      * @param RequestInterface $request deprecated
30 |      */
31 |     public function setRequest(RequestInterface $request): void
32 |     {
33 |         throw new RuntimeException(self::class . ' does not support request / response');
34 |     }
35 | 
36 |     public function getRequest(): void
37 |     {
38 |     }
39 | 
40 |     public function getResponse(): void
41 |     {
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/src/Insights/Advanced.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Insights;
 6 | 
 7 | class Advanced extends Standard
 8 | {
 9 |     public function getValidNumber(): mixed
10 |     {
11 |         return $this->data['valid_number'];
12 |     }
13 | 
14 |     public function getReachable(): mixed
15 |     {
16 |         return $this->data['reachable'];
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Insights/AdvancedCnam.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Insights;
 6 | 
 7 | class AdvancedCnam extends Advanced
 8 | {
 9 |     use CnamTrait;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Insights/Basic.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Insights;
 6 | 
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | class Basic implements ArrayHydrateInterface
10 | {
11 |     protected array $data = [];
12 | 
13 |     public function __construct(string $number)
14 |     {
15 |         $this->data['national_format_number'] = $number;
16 |     }
17 | 
18 |     public function getRequestId(): string
19 |     {
20 |         return $this->data['request_id'];
21 |     }
22 | 
23 |     public function getNationalFormatNumber(): string
24 |     {
25 |         return $this->data['national_format_number'];
26 |     }
27 | 
28 |     public function getInternationalFormatNumber(): string
29 |     {
30 |         return $this->data['international_format_number'];
31 |     }
32 | 
33 |     public function getCountryCode(): string
34 |     {
35 |         return $this->data['country_code'];
36 |     }
37 | 
38 |     public function getCountryCodeISO3(): string
39 |     {
40 |         return $this->data['country_code_iso3'];
41 |     }
42 | 
43 |     public function getCountryName(): string
44 |     {
45 |         return $this->data['country_name'];
46 |     }
47 | 
48 |     public function getCountryPrefix(): string
49 |     {
50 |         return $this->data['country_prefix'];
51 |     }
52 | 
53 |     public function fromArray(array $data): void
54 |     {
55 |         $this->data = $data;
56 |     }
57 | 
58 |     public function toArray(): array
59 |     {
60 |         return $this->data;
61 |     }
62 | }
63 | 


--------------------------------------------------------------------------------
/src/Insights/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Insights;
 6 | 
 7 | use Psr\Container\ContainerInterface;
 8 | use Vonage\Client\APIResource;
 9 | use Vonage\Client\Credentials\Handler\BasicHandler;
10 | use Vonage\Client\Credentials\Handler\BasicQueryHandler;
11 | 
12 | class ClientFactory
13 | {
14 |     public function __invoke(ContainerInterface $container): Client
15 |     {
16 |         /** @var APIResource $api */
17 |         $api = $container->make(APIResource::class);
18 |         $api->setIsHAL(false);
19 |         $api->setAuthHandlers(new BasicHandler());
20 | 
21 |         return new Client($api);
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Insights/CnamTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Insights;
 6 | 
 7 | trait CnamTrait
 8 | {
 9 |     public function getCallerName(): ?string
10 |     {
11 |         return $this->data['caller_name'] ?? null;
12 |     }
13 | 
14 |     public function getFirstName(): ?string
15 |     {
16 |         return $this->data['first_name'] ?? null;
17 |     }
18 | 
19 |     public function getLastName(): ?string
20 |     {
21 |         return $this->data['last_name'] ?? null;
22 |     }
23 | 
24 |     public function getCallerType(): ?string
25 |     {
26 |         return $this->data['caller_type'] ?? null;
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Insights/Standard.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Insights;
 6 | 
 7 | class Standard extends Basic
 8 | {
 9 |     public function getCurrentCarrier(): mixed
10 |     {
11 |         return $this->data['current_carrier'];
12 |     }
13 | 
14 |     public function getOriginalCarrier(): mixed
15 |     {
16 |         return $this->data['original_carrier'];
17 |     }
18 | 
19 |     public function getPorted(): mixed
20 |     {
21 |         return $this->data['ported'];
22 |     }
23 | 
24 |     public function getRefundPrice(): mixed
25 |     {
26 |         return $this->data['refund_price'];
27 |     }
28 | 
29 |     public function getRequestPrice(): mixed
30 |     {
31 |         return $this->data['request_price'];
32 |     }
33 | 
34 |     public function getRemainingBalance(): mixed
35 |     {
36 |         return $this->data['remaining_balance'];
37 |     }
38 | 
39 |     public function getRoaming(): mixed
40 |     {
41 |         return $this->data['roaming'];
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/src/Insights/StandardCnam.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Insights;
 6 | 
 7 | class StandardCnam extends Standard
 8 | {
 9 |     use CnamTrait;
10 | }
11 | 


--------------------------------------------------------------------------------
/src/Logger/LoggerAwareInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Logger;
 4 | 
 5 | use Psr\Log\LoggerInterface;
 6 | 
 7 | interface LoggerAwareInterface
 8 | {
 9 |     public function getLogger(): ?LoggerInterface;
10 | 
11 |     /**
12 |      * @param int|string $level Level of message that we are logging
13 |      * @param array<mixed> $context Additional information for context
14 |      */
15 |     public function log(int|string $level, string $message, array $context = []): void;
16 | 
17 |     public function setLogger(LoggerInterface $logger): void;
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Logger/LoggerTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Logger;
 4 | 
 5 | use Psr\Log\LoggerInterface;
 6 | 
 7 | trait LoggerTrait
 8 | {
 9 |     /**
10 |      * @var LoggerInterface
11 |      */
12 |     protected $logger;
13 | 
14 |     public function getLogger(): ?LoggerInterface
15 |     {
16 |         return $this->logger;
17 |     }
18 | 
19 |     /**
20 |      * @param int|string $level Level of message that we are logging
21 |      * @param array<mixed> $context Additional information for context
22 |      */
23 |     public function log(int|string $level, string $message, array $context = []): void
24 |     {
25 |         $logger = $this->getLogger();
26 |         if ($logger) {
27 |             $logger->log($level, $message, $context);
28 |         }
29 |     }
30 | 
31 |     public function setLogger(LoggerInterface $logger): void
32 |     {
33 |         $this->logger = $logger;
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Meetings/Application.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Meetings;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class Application implements ArrayHydrateInterface
 8 | {
 9 |     private array $data;
10 | 
11 |     public function fromArray(array $data): void
12 |     {
13 |         $this->data = $data;
14 |     }
15 | 
16 |     public function toArray(): array
17 |     {
18 |         return $this->data;
19 |     }
20 | 
21 |     public function __get($name)
22 |     {
23 |         return $this->data[$name];
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Meetings/ApplicationTheme.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Meetings;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class ApplicationTheme implements ArrayHydrateInterface
 8 | {
 9 |     private array $data;
10 | 
11 |     public function fromArray(array $data): void
12 |     {
13 |         $this->data = $data;
14 |     }
15 | 
16 |     public function toArray(): array
17 |     {
18 |         return $this->data;
19 |     }
20 | 
21 |     public function __get($name)
22 |     {
23 |         return $this->data[$name];
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Meetings/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Meetings;
 6 | 
 7 | use Psr\Container\ContainerInterface;
 8 | use Vonage\Client\APIResource;
 9 | use Vonage\Client\Credentials\Handler\KeypairHandler;
10 | 
11 | class ClientFactory
12 | {
13 |     public function __invoke(ContainerInterface $container): Client
14 |     {
15 |         /** @var APIResource $api */
16 |         $api = $container->make(APIResource::class);
17 |         $api
18 |             ->setBaseUrl('https://api-eu.vonage.com/v1/meetings/')
19 |             ->setExceptionErrorHandler(new ExceptionErrorHandler())
20 |             ->setAuthHandlers(new KeypairHandler());
21 | 
22 |         return new Client($api);
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Meetings/DialInNumber.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Meetings;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class DialInNumber implements ArrayHydrateInterface
 8 | {
 9 |     private array $data;
10 | 
11 |     public function fromArray(array $data): void
12 |     {
13 |         $this->data = $data;
14 |     }
15 | 
16 |     public function toArray(): array
17 |     {
18 |         return $this->data;
19 |     }
20 | 
21 |     public function __get($name)
22 |     {
23 |         return $this->data[$name];
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Meetings/ExceptionErrorHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Meetings;
 6 | 
 7 | use Psr\Http\Message\RequestInterface;
 8 | use Psr\Http\Message\ResponseInterface;
 9 | use Vonage\Client\Exception\Conflict;
10 | use Vonage\Client\Exception\Credentials;
11 | use Vonage\Client\Exception\NotFound;
12 | use Vonage\Client\Exception\Validation;
13 | 
14 | class ExceptionErrorHandler
15 | {
16 |     public function __invoke(ResponseInterface $response, RequestInterface $request): void
17 |     {
18 |         match ($response->getStatusCode()) {
19 |             400 => throw new Validation('The request data was invalid'),
20 |             403 => throw new Credentials('You are not authorised to perform this request'),
21 |             404 => throw new NotFound('No resource found'),
22 |             409 => throw new Conflict('Entity conflict')
23 |         };
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Meetings/Recording.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Meetings;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class Recording implements ArrayHydrateInterface
 8 | {
 9 |     private array $data;
10 | 
11 |     public function fromArray(array $data): void
12 |     {
13 |         $this->data = $data;
14 |     }
15 | 
16 |     public function toArray(): array
17 |     {
18 |         return $this->data;
19 |     }
20 | 
21 |     public function __get($name)
22 |     {
23 |         return $this->data[$name];
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Meetings/Room.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Meetings;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class Room implements ArrayHydrateInterface
 8 | {
 9 |     protected array $data;
10 | 
11 |     public function fromArray(array $data): static
12 |     {
13 |         if (!isset($data['display_name'])) {
14 |             throw new \InvalidArgumentException('A room object must contain a display_name');
15 |         }
16 | 
17 |         $this->data = $data;
18 | 
19 |         return $this;
20 |     }
21 | 
22 |     public function toArray(): array
23 |     {
24 |         return array_filter($this->data, static fn ($value) => $value !== '');
25 |     }
26 | 
27 |     public function __get($value)
28 |     {
29 |         return $this->data[$value];
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Meetings/UrlObject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Meetings;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class UrlObject implements ArrayHydrateInterface
 8 | {
 9 |     private array $data;
10 | 
11 |     public function fromArray(array $data): void
12 |     {
13 |         $this->data = $data;
14 |     }
15 | 
16 |     public function toArray(): array
17 |     {
18 |         return $this->data;
19 |     }
20 | 
21 |     public function __get($name)
22 |     {
23 |         return $this->data[$name];
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/MMS/MMSAudio.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\MMS;
 4 | 
 5 | use Vonage\Messages\MessageObjects\AudioObject;
 6 | use Vonage\Messages\Channel\BaseMessage;
 7 | use Vonage\Messages\MessageTraits\TtlTrait;
 8 | 
 9 | class MMSAudio extends BaseMessage
10 | {
11 |     use TtlTrait;
12 | 
13 |     protected string $channel = 'mms';
14 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_AUDIO;
15 |     protected bool $validatesE164 = true;
16 | 
17 |     public function __construct(
18 |         string $to,
19 |         string $from,
20 |         protected AudioObject $audioObject
21 |     ) {
22 |         $this->to = $to;
23 |         $this->from = $from;
24 |     }
25 | 
26 |     public function validatesE164(): bool
27 |     {
28 |         return $this->validatesE164;
29 |     }
30 | 
31 |     public function toArray(): array
32 |     {
33 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
34 |         $returnArray['audio'] = $this->audioObject->toArray();
35 | 
36 |         if (!is_null($this->ttl)) {
37 |             $returnArray['ttl'] = $this->ttl;
38 |         }
39 | 
40 |         return $returnArray;
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/MMS/MMSImage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\MMS;
 4 | 
 5 | use Vonage\Messages\MessageObjects\ImageObject;
 6 | use Vonage\Messages\Channel\BaseMessage;
 7 | use Vonage\Messages\MessageTraits\TtlTrait;
 8 | 
 9 | class MMSImage extends BaseMessage
10 | {
11 |     use TtlTrait;
12 | 
13 |     protected string $channel = 'mms';
14 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_IMAGE;
15 |     protected bool $validatesE164 = true;
16 | 
17 |     public function __construct(
18 |         string $to,
19 |         string $from,
20 |         protected ImageObject $image
21 |     ) {
22 |         $this->to = $to;
23 |         $this->from = $from;
24 |     }
25 | 
26 |     public function validatesE164(): bool
27 |     {
28 |         return $this->validatesE164;
29 |     }
30 | 
31 |     public function toArray(): array
32 |     {
33 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
34 |         $returnArray['image'] = $this->image->toArray();
35 | 
36 |         if (!is_null($this->ttl)) {
37 |             $returnArray['ttl'] = $this->ttl;
38 |         }
39 | 
40 |         return $returnArray;
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/MMS/MMSVideo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\MMS;
 4 | 
 5 | use Vonage\Messages\MessageObjects\AudioObject;
 6 | use Vonage\Messages\MessageObjects\VideoObject;
 7 | use Vonage\Messages\Channel\BaseMessage;
 8 | use Vonage\Messages\MessageTraits\TtlTrait;
 9 | 
10 | class MMSVideo extends BaseMessage
11 | {
12 |     use TtlTrait;
13 | 
14 |     protected string $channel = 'mms';
15 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_VIDEO;
16 |     protected bool $validatesE164 = true;
17 | 
18 |     public function __construct(
19 |         string $to,
20 |         string $from,
21 |         protected VideoObject $videoObject
22 |     ) {
23 |         $this->to = $to;
24 |         $this->from = $from;
25 |     }
26 | 
27 |     public function validatesE164(): bool
28 |     {
29 |         return $this->validatesE164;
30 |     }
31 | 
32 |     public function toArray(): array
33 |     {
34 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
35 |         $returnArray['video'] = $this->videoObject->toArray();
36 | 
37 |         if (!is_null($this->ttl)) {
38 |             $returnArray['ttl'] = $this->ttl;
39 |         }
40 | 
41 |         return $returnArray;
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/MMS/MMSvCard.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\MMS;
 4 | 
 5 | use Vonage\Messages\MessageObjects\VCardObject;
 6 | use Vonage\Messages\Channel\BaseMessage;
 7 | use Vonage\Messages\MessageTraits\TtlTrait;
 8 | 
 9 | class MMSvCard extends BaseMessage
10 | {
11 |     use TtlTrait;
12 | 
13 |     protected string $channel = 'mms';
14 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_VCARD;
15 |     protected bool $validatesE164 = true;
16 | 
17 |     public function __construct(
18 |         string $to,
19 |         string $from,
20 |         protected VCardObject $vCard
21 |     ) {
22 |         $this->to = $to;
23 |         $this->from = $from;
24 |     }
25 | 
26 |     public function validatesE164(): bool
27 |     {
28 |         return $this->validatesE164;
29 |     }
30 | 
31 |     public function toArray(): array
32 |     {
33 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
34 |         $returnArray['vcard'] = $this->vCard->toArray();
35 | 
36 |         if (!is_null($this->ttl)) {
37 |             $returnArray['ttl'] = $this->ttl;
38 |         }
39 | 
40 |         return $returnArray;
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/Message.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Messages\Channel;
 6 | 
 7 | interface Message
 8 | {
 9 |     public function toArray(): array;
10 |     public function getTo(): string;
11 |     public function setTo(string $to): void;
12 |     public function getFrom(): string;
13 |     public function setFrom(string $from): void;
14 |     public function getClientRef(): ?string;
15 |     public function getChannel(): string;
16 |     public function getSubType(): string;
17 |     public function setClientRef(string $clientRef): void;
18 |     public function getWebhookUrl(): ?string;
19 |     public function setWebhookUrl(string $url): void;
20 |     public function getWebhookVersion(): ?string;
21 |     public function setWebhookVersion(string $version): void;
22 |     public function validatesE164(): bool;
23 | 
24 |     /**
25 |      * All message types have shared outputs required by the endpoint.
26 |      * Child classes are required to call this before assembling their
27 |      * own specific output
28 |      *
29 |      * @return array
30 |      */
31 |     public function getBaseMessageUniversalOutputArray(): array;
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/Messenger/InvalidCategoryException.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | namespace Vonage\Messages\Channel\Messenger;
4 | 
5 | class InvalidCategoryException extends \Exception
6 | {
7 | }
8 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/Messenger/MessengerAudio.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\Messenger;
 4 | 
 5 | use Vonage\Messages\MessageObjects\AudioObject;
 6 | use Vonage\Messages\Channel\BaseMessage;
 7 | 
 8 | class MessengerAudio extends BaseMessage
 9 | {
10 |     use MessengerObjectTrait;
11 | 
12 |     protected string $channel = 'messenger';
13 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_AUDIO;
14 |     protected bool $validatesE164 = false;
15 | 
16 |     public function __construct(
17 |         string $to,
18 |         string $from,
19 |         protected AudioObject $audioObject,
20 |         ?string $category = null,
21 |         ?string $tag = null
22 |     ) {
23 |         $this->to = $to;
24 |         $this->from = $from;
25 |         $this->category = $category;
26 |         $this->tag = $tag;
27 |     }
28 | 
29 |     public function validatesE164(): bool
30 |     {
31 |         return $this->validatesE164;
32 |     }
33 | 
34 |     public function toArray(): array
35 |     {
36 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
37 |         $returnArray['audio'] = $this->audioObject->toArray();
38 | 
39 |         if ($this->requiresMessengerObject()) {
40 |             $returnArray['messenger'] = $this->getMessengerObject();
41 |         }
42 | 
43 |         return $returnArray;
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/Messenger/MessengerFile.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\Messenger;
 4 | 
 5 | use Vonage\Messages\MessageObjects\FileObject;
 6 | use Vonage\Messages\Channel\BaseMessage;
 7 | 
 8 | class MessengerFile extends BaseMessage
 9 | {
10 |     use MessengerObjectTrait;
11 | 
12 |     protected string $channel = 'messenger';
13 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_FILE;
14 |     protected bool $validatesE164 = false;
15 | 
16 |     public function __construct(
17 |         string $to,
18 |         string $from,
19 |         protected FileObject $fileObject,
20 |         ?string $category = null,
21 |         ?string $tag = null
22 |     ) {
23 |         $this->to = $to;
24 |         $this->from = $from;
25 |         $this->category = $category;
26 |         $this->tag = $tag;
27 |     }
28 | 
29 |     public function toArray(): array
30 |     {
31 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
32 |         $returnArray['file'] = $this->fileObject->toArray();
33 | 
34 |         if ($this->requiresMessengerObject()) {
35 |             $returnArray['messenger'] = $this->getMessengerObject();
36 |         }
37 | 
38 |         return $returnArray;
39 |     }
40 | 
41 |     public function validatesE164(): bool
42 |     {
43 |         return $this->validatesE164;
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/Messenger/MessengerImage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\Messenger;
 4 | 
 5 | use Vonage\Messages\MessageObjects\ImageObject;
 6 | use Vonage\Messages\Channel\BaseMessage;
 7 | 
 8 | class MessengerImage extends BaseMessage
 9 | {
10 |     use MessengerObjectTrait;
11 | 
12 |     protected string $channel = 'messenger';
13 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_IMAGE;
14 |     protected bool $validatesE164 = false;
15 | 
16 |     public function __construct(
17 |         string $to,
18 |         string $from,
19 |         protected ImageObject $image,
20 |         ?string $category = null,
21 |         ?string $tag = null
22 |     ) {
23 |         $this->to = $to;
24 |         $this->from = $from;
25 |         $this->category = $category;
26 |         $this->tag = $tag;
27 |     }
28 | 
29 |     public function toArray(): array
30 |     {
31 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
32 |         $returnArray['image'] = $this->image->toArray();
33 | 
34 |         if ($this->requiresMessengerObject()) {
35 |             $returnArray['messenger'] = $this->getMessengerObject();
36 |         }
37 | 
38 |         return $returnArray;
39 |     }
40 | 
41 |     public function validatesE164(): bool
42 |     {
43 |         return $this->validatesE164;
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/Messenger/MessengerObjectTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\Messenger;
 4 | 
 5 | trait MessengerObjectTrait
 6 | {
 7 |     private ?string $category;
 8 |     private ?string $tag;
 9 | 
10 |     public function getCategory(): ?string
11 |     {
12 |         return $this->category;
13 |     }
14 | 
15 |     public function requiresMessengerObject(): bool
16 |     {
17 |         return $this->getTag() || $this->getCategory();
18 |     }
19 | 
20 |     public function setCategory(string $category): void
21 |     {
22 |         $this->category = $category;
23 |     }
24 | 
25 |     public function getTag(): ?string
26 |     {
27 |         return $this->tag;
28 |     }
29 | 
30 |     public function setTag(string $tag): void
31 |     {
32 |         $this->tag = $tag;
33 |     }
34 | 
35 |     public function getMessengerObject(): array
36 |     {
37 |         $messengerObject = [
38 |             'category' => $this->getCategory(),
39 |         ];
40 | 
41 |         if ($this->getTag()) {
42 |             $messengerObject['tag'] = $this->getTag();
43 |         }
44 | 
45 |         return $messengerObject;
46 |     }
47 | }
48 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/Messenger/MessengerText.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\Messenger;
 4 | 
 5 | use Vonage\Messages\MessageTraits\TextTrait;
 6 | use Vonage\Messages\Channel\BaseMessage;
 7 | 
 8 | class MessengerText extends BaseMessage
 9 | {
10 |     use TextTrait;
11 |     use MessengerObjectTrait;
12 | 
13 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_TEXT;
14 |     protected string $channel = 'messenger';
15 |     protected bool $validatesE164 = false;
16 | 
17 |     public function __construct(
18 |         string $to,
19 |         string $from,
20 |         string $text,
21 |         ?string $category = null,
22 |         ?string $tag = null
23 |     ) {
24 |         $this->to = $to;
25 |         $this->from = $from;
26 |         $this->text = $text;
27 |         $this->category = $category;
28 |         $this->tag = $tag;
29 |     }
30 | 
31 |     public function validatesE164(): bool
32 |     {
33 |         return $this->validatesE164;
34 |     }
35 | 
36 |     public function toArray(): array
37 |     {
38 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
39 |         $returnArray['text'] = $this->getText();
40 | 
41 |         if ($this->requiresMessengerObject()) {
42 |             $returnArray['messenger'] = $this->getMessengerObject();
43 |         }
44 | 
45 |         return $returnArray;
46 |     }
47 | }
48 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/Messenger/MessengerVideo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\Messenger;
 4 | 
 5 | use Vonage\Messages\MessageObjects\VideoObject;
 6 | use Vonage\Messages\Channel\BaseMessage;
 7 | 
 8 | class MessengerVideo extends BaseMessage
 9 | {
10 |     use MessengerObjectTrait;
11 | 
12 |     protected string $channel = 'messenger';
13 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_VIDEO;
14 |     protected bool $validatesE164 = false;
15 | 
16 |     public function __construct(
17 |         string $to,
18 |         string $from,
19 |         protected VideoObject $videoObject,
20 |         ?string $category = null,
21 |         ?string $tag = null
22 |     ) {
23 |         $this->to = $to;
24 |         $this->from = $from;
25 |         $this->category = $category;
26 |         $this->tag = $tag;
27 |     }
28 | 
29 |     public function validatesE164(): bool
30 |     {
31 |         return $this->validatesE164;
32 |     }
33 | 
34 |     public function toArray(): array
35 |     {
36 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
37 |         $returnArray['video'] = $this->videoObject->toArray();
38 | 
39 |         if ($this->requiresMessengerObject()) {
40 |             $returnArray['messenger'] = $this->getMessengerObject();
41 |         }
42 | 
43 |         return $returnArray;
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/RCS/RcsInvalidTtlException.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | namespace Vonage\Messages\Channel\RCS;
4 | 
5 | class RcsInvalidTtlException extends \Exception
6 | {
7 | }
8 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/RCS/RcsText.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\RCS;
 4 | 
 5 | use Vonage\Messages\MessageTraits\TextTrait;
 6 | use Vonage\Messages\Channel\BaseMessage;
 7 | use Vonage\Messages\MessageTraits\TtlTrait;
 8 | 
 9 | class RcsText extends BaseMessage
10 | {
11 |     use TextTrait;
12 |     use TtlTrait;
13 | 
14 |     protected const RCS_TEXT_MIN_TTL = 300;
15 |     protected const RCS_TEXT_MAX_TTL = 259200;
16 | 
17 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_TEXT;
18 |     protected string $channel = 'rcs';
19 |     protected bool $validatesE164 = true;
20 | 
21 |     public function __construct(
22 |         string $to,
23 |         string $from,
24 |         string $message
25 |     ) {
26 |         $this->to = $to;
27 |         $this->from = $from;
28 |         $this->text = $message;
29 |     }
30 | 
31 |     public function validatesE164(): bool
32 |     {
33 |         return $this->validatesE164;
34 |     }
35 | 
36 |     public function setTtl(?int $ttl): void
37 |     {
38 |         $range = [
39 |             'options' => [
40 |                 'min_range' => self::RCS_TEXT_MIN_TTL,
41 |                 'max_range' => self::RCS_TEXT_MAX_TTL
42 |             ]
43 |         ];
44 | 
45 |         if (!filter_var($ttl, FILTER_VALIDATE_INT, $range)) {
46 |             throw new RcsInvalidTtlException('Timeout ' . $ttl . ' is not valid');
47 |         }
48 | 
49 |         $this->ttl = $ttl;
50 |     }
51 | 
52 |     public function toArray(): array
53 |     {
54 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
55 |         $returnArray['text'] = $this->getText();
56 | 
57 |         if ($this->getClientRef()) {
58 |             $returnArray['client_ref'] = $this->getClientRef();
59 |         }
60 | 
61 |         if ($this->getWebhookUrl()) {
62 |             $returnArray['webhook_url'] = $this->getWebhookUrl();
63 |         }
64 | 
65 |         if ($this->getTtl()) {
66 |             $returnArray['ttl'] = $this->getTtl();
67 |         }
68 | 
69 |         return $returnArray;
70 |     }
71 | }
72 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/Viber/MessageObjects/ViberActionObject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\Viber\MessageObjects;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class ViberActionObject implements ArrayHydrateInterface
 8 | {
 9 |     public function __construct(private string $url, private string $text = '')
10 |     {
11 |     }
12 | 
13 |     public function fromArray(array $data): ViberActionObject
14 |     {
15 |         $this->url = $data['url'];
16 |         $this->text = $data['text'];
17 | 
18 |         return $this;
19 |     }
20 | 
21 |     public function toArray(): array
22 |     {
23 |         return [
24 |             'url' => $this->getUrl(),
25 |             'text' => $this->getText()
26 |         ];
27 |     }
28 | 
29 |     public function getUrl(): string
30 |     {
31 |         return $this->url;
32 |     }
33 | 
34 |     public function getText(): string
35 |     {
36 |         return $this->text;
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/Viber/ViberFile.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\Viber;
 4 | 
 5 | use Vonage\Messages\MessageObjects\FileObject;
 6 | use Vonage\Messages\Channel\BaseMessage;
 7 | 
 8 | class ViberFile extends BaseMessage
 9 | {
10 |     use ViberServiceObjectTrait;
11 | 
12 |     protected string $channel = 'viber_service';
13 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_FILE;
14 |     protected bool $validatesE164 = true;
15 | 
16 |     public function __construct(
17 |         string $to,
18 |         string $from,
19 |         protected FileObject $fileObject
20 |     ) {
21 |         $this->to = $to;
22 |         $this->from = $from;
23 |     }
24 | 
25 |     public function validatesE164(): bool
26 |     {
27 |         return $this->validatesE164;
28 |     }
29 | 
30 |     public function toArray(): array
31 |     {
32 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
33 |         $returnArray['file'] = $this->fileObject->toArray();
34 | 
35 |         if ($this->requiresViberServiceObject()) {
36 |             $this->getCategory() ? $returnArray['viber_service']['category'] = $this->getCategory() : null;
37 |             $this->getTtl() ? $returnArray['viber_service']['ttl'] = $this->getTtl() : null;
38 |             $this->getType() ? $returnArray['viber_service']['type'] = $this->getType() : null;
39 |         }
40 | 
41 |         return $returnArray;
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/Viber/ViberImage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\Viber;
 4 | 
 5 | use Vonage\Messages\Channel\Viber\MessageObjects\ViberActionObject;
 6 | use Vonage\Messages\MessageObjects\ImageObject;
 7 | use Vonage\Messages\Channel\BaseMessage;
 8 | 
 9 | class ViberImage extends BaseMessage
10 | {
11 |     use ViberServiceObjectTrait;
12 | 
13 |     protected string $channel = 'viber_service';
14 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_IMAGE;
15 |     protected bool $validatesE164 = true;
16 | 
17 |     public function __construct(
18 |         string $to,
19 |         string $from,
20 |         protected ImageObject $image,
21 |         ?string $category = null,
22 |         ?int $ttl = null,
23 |         ?string $type = null,
24 |         ?ViberActionObject $viberActionObject = null
25 |     ) {
26 |         $this->to = $to;
27 |         $this->from = $from;
28 |         $this->category = $category;
29 |         $this->ttl = $ttl;
30 |         $this->type = $type;
31 |         $this->action = $viberActionObject;
32 |     }
33 | 
34 |     public function validatesE164(): bool
35 |     {
36 |         return $this->validatesE164;
37 |     }
38 | 
39 |     public function toArray(): array
40 |     {
41 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
42 |         $returnArray['image'] = $this->image->toArray();
43 | 
44 |         if ($this->requiresViberServiceObject()) {
45 |             $this->getCategory() ? $returnArray['viber_service']['category'] = $this->getCategory() : null;
46 |             $this->getTtl() ? $returnArray['viber_service']['ttl'] = $this->getTtl() : null;
47 |             $this->getType() ? $returnArray['viber_service']['type'] = $this->getType() : null;
48 |             $this->getAction() ? $returnArray['viber_service']['action'] = $this->getAction()->toArray() : null;
49 |         }
50 | 
51 |         return array_filter($returnArray);
52 |     }
53 | }
54 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/Viber/ViberServiceObjectTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\Viber;
 4 | 
 5 | use Vonage\Messages\Channel\Viber\MessageObjects\ViberActionObject;
 6 | 
 7 | trait ViberServiceObjectTrait
 8 | {
 9 |     private ?string $category = null;
10 |     private ?int $ttl = null;
11 |     private ?string $type = null;
12 |     private ?ViberActionObject $action = null;
13 |     private string $duration;
14 |     private string $fileSize;
15 | 
16 |     public function requiresViberServiceObject(): bool
17 |     {
18 |         return $this->getCategory() || $this->getTtl() || $this->getType() || $this->getAction();
19 |     }
20 | 
21 |     public function getCategory(): ?string
22 |     {
23 |         return $this->category;
24 |     }
25 | 
26 |     public function setCategory(?string $category): static
27 |     {
28 |         $this->category = $category;
29 | 
30 |         return $this;
31 |     }
32 | 
33 |     public function getTtl(): ?int
34 |     {
35 |         return $this->ttl;
36 |     }
37 | 
38 |     public function setTtl(int $ttl): static
39 |     {
40 |         $this->ttl = $ttl;
41 | 
42 |         return $this;
43 |     }
44 | 
45 |     public function getType(): ?string
46 |     {
47 |         return $this->type;
48 |     }
49 | 
50 |     public function setType(string $type): static
51 |     {
52 |         $this->type = $type;
53 | 
54 |         return $this;
55 |     }
56 | 
57 |     public function getAction(): ?ViberActionObject
58 |     {
59 |         return $this->action;
60 |     }
61 | 
62 |     public function setAction(ViberActionObject $viberActionObject): static
63 |     {
64 |         $this->action = $viberActionObject;
65 | 
66 |         return $this;
67 |     }
68 | 
69 |     public function getDuration(): string
70 |     {
71 |         return $this->duration;
72 |     }
73 | 
74 |     public function setDuration(string $duration): void
75 |     {
76 |         $this->duration = $duration;
77 |     }
78 | 
79 |     public function getFileSize(): string
80 |     {
81 |         return $this->fileSize;
82 |     }
83 | 
84 |     public function setFileSize(string $fileSize): void
85 |     {
86 |         $this->fileSize = $fileSize;
87 |     }
88 | }
89 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/Viber/ViberText.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\Viber;
 4 | 
 5 | use Vonage\Messages\Channel\Viber\MessageObjects\ViberActionObject;
 6 | use Vonage\Messages\MessageTraits\TextTrait;
 7 | use Vonage\Messages\Channel\BaseMessage;
 8 | 
 9 | class ViberText extends BaseMessage
10 | {
11 |     use TextTrait;
12 |     use ViberServiceObjectTrait;
13 | 
14 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_TEXT;
15 |     protected string $channel = 'viber_service';
16 |     protected bool $validatesE164 = true;
17 | 
18 |     public function __construct(
19 |         string $to,
20 |         string $from,
21 |         string $message,
22 |         ?string $category = null,
23 |         ?int $ttl = null,
24 |         ?string $type = null,
25 |         ?ViberActionObject $viberActionObject = null,
26 |     ) {
27 |         $this->to = $to;
28 |         $this->from = $from;
29 |         $this->text = $message;
30 |         $this->category = $category;
31 |         $this->ttl = $ttl;
32 |         $this->type = $type;
33 |         $this->action = $viberActionObject;
34 |     }
35 | 
36 |     public function validatesE164(): bool
37 |     {
38 |         return $this->validatesE164;
39 |     }
40 | 
41 |     public function toArray(): array
42 |     {
43 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
44 |         $returnArray['text'] = $this->getText();
45 | 
46 |         if ($this->requiresViberServiceObject()) {
47 |             $this->getCategory() ? $returnArray['viber_service']['category'] = $this->getCategory() : null;
48 |             $this->getTtl() ? $returnArray['viber_service']['ttl'] = $this->getTtl() : null;
49 |             $this->getType() ? $returnArray['viber_service']['type'] = $this->getType() : null;
50 |             $this->getAction() ? $returnArray['viber_service']['action'] = $this->getAction()->toArray() : null;
51 |         }
52 | 
53 |         return array_filter($returnArray);
54 |     }
55 | }
56 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/Viber/ViberVideo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\Viber;
 4 | 
 5 | use Vonage\Messages\MessageObjects\VideoObject;
 6 | use Vonage\Messages\MessageTraits\TextTrait;
 7 | use Vonage\Messages\Channel\BaseMessage;
 8 | 
 9 | class ViberVideo extends BaseMessage
10 | {
11 |     use TextTrait;
12 |     use ViberServiceObjectTrait;
13 | 
14 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_VIDEO;
15 |     protected string $channel = 'viber_service';
16 |     protected bool $validatesE164 = true;
17 | 
18 |     public function __construct(
19 |         string $to,
20 |         string $from,
21 |         protected string $thumbUrl,
22 |         protected VideoObject $videoObject,
23 |         string $duration,
24 |         string $fileSize
25 |     ) {
26 |         $this->fileSize = $fileSize;
27 |         $this->duration = $duration;
28 |         $this->to = $to;
29 |         $this->from = $from;
30 |     }
31 | 
32 |     public function validatesE164(): bool
33 |     {
34 |         return $this->validatesE164;
35 |     }
36 | 
37 |     public function toArray(): array
38 |     {
39 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
40 |         $videoArray = $this->videoObject->toArray();
41 |         $videoArray['thumb_url'] = $this->thumbUrl;
42 |         $returnArray['video'] = $videoArray;
43 | 
44 |         $returnArray['viber_service']['duration'] = $this->getDuration();
45 |         $returnArray['viber_service']['file_size'] = $this->getFileSize();
46 | 
47 |         $this->getCategory() ? $returnArray['viber_service']['category'] = $this->getCategory() : null;
48 |         $this->getTtl() ? $returnArray['viber_service']['ttl'] = $this->getTtl() : null;
49 |         $this->getType() ? $returnArray['viber_service']['type'] = $this->getType() : null;
50 |         $this->getAction() ? $returnArray['viber_service']['action'] = $this->getAction()->toArray() : null;
51 | 
52 |         return $returnArray;
53 |     }
54 | }
55 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/WhatsApp/MessageObjects/StickerObject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\WhatsApp\MessageObjects;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class StickerObject implements ArrayHydrateInterface
 8 | {
 9 |     public const STICKER_URL = 'url';
10 |     public const STICKER_ID = 'id';
11 | 
12 |     private array $allowedTypes = [
13 |         self::STICKER_URL,
14 |         self::STICKER_ID
15 |     ];
16 | 
17 |     public function __construct(private string $type, private string $value = '')
18 |     {
19 |         if (! in_array($type, $this->allowedTypes, true)) {
20 |             throw new \InvalidArgumentException($type . ' is an invalid type of Sticker');
21 |         }
22 |     }
23 | 
24 |     public function fromArray(array $data): StickerObject
25 |     {
26 |         if (! in_array($data['type'], $this->allowedTypes, true)) {
27 |             throw new \InvalidArgumentException($data['type'] . ' is an invalid type of Sticker');
28 |         }
29 | 
30 |         return $this;
31 |     }
32 | 
33 |     /**
34 |      * @return string
35 |      */
36 |     public function getType(): string
37 |     {
38 |         return $this->type;
39 |     }
40 | 
41 |     /**
42 |      * @param string $type
43 |      */
44 |     public function setType(string $type): void
45 |     {
46 |         $this->type = $type;
47 |     }
48 | 
49 |     /**
50 |      * @return string
51 |      */
52 |     public function getValue(): string
53 |     {
54 |         return $this->value;
55 |     }
56 | 
57 |     /**
58 |      * @param string $value
59 |      */
60 |     public function setValue(string $value): void
61 |     {
62 |         $this->value = $value;
63 |     }
64 | 
65 |     public function toArray(): array
66 |     {
67 |         return [$this->getType() => $this->getValue()];
68 |     }
69 | }
70 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/WhatsApp/WhatsAppAudio.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\WhatsApp;
 4 | 
 5 | use Vonage\Messages\MessageObjects\AudioObject;
 6 | use Vonage\Messages\Channel\BaseMessage;
 7 | use Vonage\Messages\MessageTraits\ContextTrait;
 8 | 
 9 | class WhatsAppAudio extends BaseMessage
10 | {
11 |     use ContextTrait;
12 | 
13 |     protected string $channel = 'whatsapp';
14 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_AUDIO;
15 |     protected bool $validatesE164 = true;
16 | 
17 |     public function __construct(
18 |         string $to,
19 |         string $from,
20 |         protected AudioObject $audioObject
21 |     ) {
22 |         $this->to = $to;
23 |         $this->from = $from;
24 |     }
25 | 
26 |     public function validatesE164(): bool
27 |     {
28 |         return $this->validatesE164;
29 |     }
30 | 
31 |     public function toArray(): array
32 |     {
33 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
34 |         $returnArray['audio'] = $this->audioObject->toArray();
35 |         $returnArray['context'] = $this->context ?? null;
36 | 
37 |         return $returnArray;
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/WhatsApp/WhatsAppCustom.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\WhatsApp;
 4 | 
 5 | use Vonage\Messages\Channel\BaseMessage;
 6 | use Vonage\Messages\MessageTraits\ContextTrait;
 7 | 
 8 | class WhatsAppCustom extends BaseMessage
 9 | {
10 |     use ContextTrait;
11 | 
12 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_CUSTOM;
13 |     protected string $channel = 'whatsapp';
14 |     protected bool $validatesE164 = true;
15 | 
16 |     public function __construct(
17 |         string $to,
18 |         string $from,
19 |         protected array $custom
20 |     ) {
21 |         $this->to = $to;
22 |         $this->from = $from;
23 |     }
24 | 
25 |     public function validatesE164(): bool
26 |     {
27 |         return $this->validatesE164;
28 |     }
29 | 
30 |     public function setCustom(array $custom): void
31 |     {
32 |         $this->custom = $custom;
33 |     }
34 | 
35 |     public function getCustom(): array
36 |     {
37 |         return $this->custom;
38 |     }
39 | 
40 |     public function toArray(): array
41 |     {
42 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
43 |         $returnArray['custom'] = $this->getCustom();
44 |         $returnArray['context'] = $this->context ?? null;
45 | 
46 |         return $returnArray;
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/WhatsApp/WhatsAppFile.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\WhatsApp;
 4 | 
 5 | use Vonage\Messages\MessageObjects\FileObject;
 6 | use Vonage\Messages\Channel\BaseMessage;
 7 | use Vonage\Messages\MessageTraits\ContextTrait;
 8 | 
 9 | class WhatsAppFile extends BaseMessage
10 | {
11 |     use ContextTrait;
12 | 
13 |     protected string $channel = 'whatsapp';
14 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_FILE;
15 |     protected bool $validatesE164 = true;
16 | 
17 |     public function __construct(
18 |         string $to,
19 |         string $from,
20 |         protected FileObject $fileObject
21 |     ) {
22 |         $this->to = $to;
23 |         $this->from = $from;
24 |     }
25 | 
26 |     public function validatesE164(): bool
27 |     {
28 |         return $this->validatesE164;
29 |     }
30 | 
31 |     public function toArray(): array
32 |     {
33 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
34 |         $returnArray['file'] = $this->fileObject->toArray();
35 |         $returnArray['context'] = $this->context ?? null;
36 | 
37 |         return $returnArray;
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/WhatsApp/WhatsAppImage.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\WhatsApp;
 4 | 
 5 | use Vonage\Messages\MessageObjects\ImageObject;
 6 | use Vonage\Messages\Channel\BaseMessage;
 7 | use Vonage\Messages\MessageTraits\ContextTrait;
 8 | 
 9 | class WhatsAppImage extends BaseMessage
10 | {
11 |     use ContextTrait;
12 | 
13 |     protected string $channel = 'whatsapp';
14 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_IMAGE;
15 |     protected bool $validatesE164 = true;
16 | 
17 |     public function __construct(
18 |         string $to,
19 |         string $from,
20 |         protected ImageObject $image
21 |     ) {
22 |         $this->to = $to;
23 |         $this->from = $from;
24 |     }
25 | 
26 |     public function validatesE164(): bool
27 |     {
28 |         return $this->validatesE164;
29 |     }
30 | 
31 |     public function toArray(): array
32 |     {
33 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
34 |         $returnArray['image'] = $this->image->toArray();
35 |         $returnArray['context'] = $this->context ?? null;
36 | 
37 |         return $returnArray;
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/WhatsApp/WhatsAppSticker.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\WhatsApp;
 4 | 
 5 | use Vonage\Messages\Channel\BaseMessage;
 6 | use Vonage\Messages\Channel\WhatsApp\MessageObjects\StickerObject;
 7 | use Vonage\Messages\MessageTraits\ContextTrait;
 8 | 
 9 | class WhatsAppSticker extends BaseMessage
10 | {
11 |     use ContextTrait;
12 | 
13 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_STICKER;
14 |     protected string $channel = 'whatsapp';
15 |     protected bool $validatesE164 = true;
16 | 
17 |     public function __construct(
18 |         string $to,
19 |         string $from,
20 |         protected StickerObject $sticker
21 |     ) {
22 |         $this->to = $to;
23 |         $this->from = $from;
24 |     }
25 | 
26 |     public function validatesE164(): bool
27 |     {
28 |         return $this->validatesE164;
29 |     }
30 | 
31 |     public function getSticker(): StickerObject
32 |     {
33 |         return $this->sticker;
34 |     }
35 | 
36 |     public function setSticker(StickerObject $sticker): static
37 |     {
38 |         $this->sticker = $sticker;
39 | 
40 |         return $this;
41 |     }
42 | 
43 |     public function toArray(): array
44 |     {
45 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
46 |         $returnArray['sticker'] = $this->getSticker()->toArray();
47 |         $returnArray['context'] = $this->context ?? null;
48 | 
49 |         return $returnArray;
50 |     }
51 | }
52 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/WhatsApp/WhatsAppTemplate.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\WhatsApp;
 4 | 
 5 | use Vonage\Messages\MessageObjects\FileObject;
 6 | use Vonage\Messages\MessageObjects\TemplateObject;
 7 | use Vonage\Messages\Channel\BaseMessage;
 8 | use Vonage\Messages\MessageTraits\ContextTrait;
 9 | 
10 | class WhatsAppTemplate extends BaseMessage
11 | {
12 |     use ContextTrait;
13 | 
14 |     protected string $channel = 'whatsapp';
15 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_TEMPLATE;
16 |     protected bool $validatesE164 = true;
17 | 
18 |     public function __construct(
19 |         string $to,
20 |         string $from,
21 |         protected TemplateObject $templateObject,
22 |         protected string $locale
23 |     ) {
24 |         $this->to = $to;
25 |         $this->from = $from;
26 |     }
27 | 
28 |     public function validatesE164(): bool
29 |     {
30 |         return $this->validatesE164;
31 |     }
32 | 
33 |     public function toArray(): array
34 |     {
35 |         $returnArray = [
36 |             'template' => $this->templateObject->toArray(),
37 |             'whatsapp' => [
38 |                 'policy' => 'deterministic',
39 |                 'locale' => $this->getLocale()
40 |             ]
41 |         ];
42 | 
43 |         $returnArray['context'] = $this->context ?? null;
44 | 
45 |         return array_merge($this->getBaseMessageUniversalOutputArray(), $returnArray);
46 |     }
47 | 
48 |     public function getLocale(): string
49 |     {
50 |         return $this->locale;
51 |     }
52 | 
53 |     public function setLocale($locale): void
54 |     {
55 |         $this->locale = $locale;
56 |     }
57 | }
58 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/WhatsApp/WhatsAppText.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\WhatsApp;
 4 | 
 5 | use Vonage\Messages\MessageTraits\ContextTrait;
 6 | use Vonage\Messages\MessageTraits\TextTrait;
 7 | use Vonage\Messages\Channel\BaseMessage;
 8 | 
 9 | class WhatsAppText extends BaseMessage
10 | {
11 |     use ContextTrait;
12 |     use TextTrait;
13 | 
14 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_TEXT;
15 |     protected string $channel = 'whatsapp';
16 |     protected bool $validatesE164 = true;
17 | 
18 |     public function __construct(
19 |         string $to,
20 |         string $from,
21 |         string $text
22 |     ) {
23 |         $this->to = $to;
24 |         $this->from = $from;
25 |         $this->text = $text;
26 |     }
27 | 
28 |     public function validatesE164(): bool
29 |     {
30 |         return $this->validatesE164;
31 |     }
32 | 
33 |     public function toArray(): array
34 |     {
35 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
36 |         $returnArray['text'] = $this->getText();
37 |         $returnArray['context'] = $this->context ?? null;
38 | 
39 |         return $returnArray;
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Messages/Channel/WhatsApp/WhatsAppVideo.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\Channel\WhatsApp;
 4 | 
 5 | use Vonage\Messages\MessageObjects\VideoObject;
 6 | use Vonage\Messages\Channel\BaseMessage;
 7 | use Vonage\Messages\MessageTraits\ContextTrait;
 8 | 
 9 | class WhatsAppVideo extends BaseMessage
10 | {
11 |     use ContextTrait;
12 | 
13 |     protected string $channel = 'whatsapp';
14 |     protected string $subType = BaseMessage::MESSAGES_SUBTYPE_VIDEO;
15 |     protected bool $validatesE164 = true;
16 | 
17 |     public function __construct(
18 |         string $to,
19 |         string $from,
20 |         protected VideoObject $videoObject
21 |     ) {
22 |         $this->to = $to;
23 |         $this->from = $from;
24 |     }
25 | 
26 |     public function validatesE164(): bool
27 |     {
28 |         return $this->validatesE164;
29 |     }
30 | 
31 |     public function toArray(): array
32 |     {
33 |         $returnArray = $this->getBaseMessageUniversalOutputArray();
34 |         $returnArray['video'] = $this->videoObject->toArray();
35 |         $returnArray['context'] = $this->context ?? null;
36 | 
37 |         return $returnArray;
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/src/Messages/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages;
 4 | 
 5 | use Psr\Container\ContainerInterface;
 6 | use Vonage\Client\APIResource;
 7 | use Vonage\Client\Credentials\Handler\BasicHandler;
 8 | use Vonage\Client\Credentials\Handler\KeypairHandler;
 9 | 
10 | class ClientFactory
11 | {
12 |     public function __invoke(ContainerInterface $container): Client
13 |     {
14 |         /** @var APIResource $api */
15 |         $api = $container->make(APIResource::class);
16 |         $api
17 |             ->setBaseUrl($api->getClient()->getApiUrl() . '/v1/messages')
18 |             ->setIsHAL(false)
19 |             ->setErrorsOn200(false)
20 |             ->setAuthHandlers([new KeypairHandler(), new BasicHandler()])
21 |             ->setExceptionErrorHandler(new ExceptionErrorHandler());
22 | 
23 |         return new Client($api);
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Messages/ExceptionErrorHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Messages;
 6 | 
 7 | use JsonException;
 8 | use Psr\Http\Message\RequestInterface;
 9 | use Psr\Http\Message\ResponseInterface;
10 | use Vonage\Client\Exception as ClientException;
11 | use Vonage\Client\Exception\ThrottleException;
12 | 
13 | use function json_decode;
14 | 
15 | class ExceptionErrorHandler
16 | {
17 |     /**
18 |      * @throws ClientException\Request
19 |      * @throws ClientException\Server
20 |      * @throws ThrottleException|JsonException
21 |      */
22 |     public function __invoke(ResponseInterface $response, RequestInterface $request)
23 |     {
24 |         $responseBody = json_decode(
25 |             $response->getBody()->getContents(),
26 |             true,
27 |             512,
28 |             JSON_THROW_ON_ERROR
29 |         );
30 |         $statusCode = (int)$response->getStatusCode();
31 | 
32 |         if ($statusCode === 429) {
33 |             throw new ThrottleException(
34 |                 $responseBody['title'] . ': ' . $responseBody['detail'],
35 |                 $response->getStatusCode()
36 |             );
37 |         }
38 | 
39 |         if ($statusCode >= 500 && $statusCode <= 599) {
40 |             throw new ClientException\Server($responseBody['title'] . ': ' . $responseBody['detail']);
41 |         }
42 | 
43 |         $message = $responseBody['title'] ?? '';
44 | 
45 |         if (isset($responseBody['detail'])) {
46 |             $message .= ': ' . $responseBody['detail'];
47 |         }
48 | 
49 |         throw new ClientException\Request($message);
50 |     }
51 | }
52 | 


--------------------------------------------------------------------------------
/src/Messages/MessageObjects/AudioObject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\MessageObjects;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class AudioObject implements ArrayHydrateInterface
 8 | {
 9 |     /**
10 |      * Legacy to pass in a caption as this should never have been supported. Nothing will happen if you pass one in.
11 |      */
12 |     public function __construct(private string $url, private readonly ?string $caption = null)
13 |     {
14 |     }
15 | 
16 |     public function fromArray(array $data): AudioObject
17 |     {
18 |         $this->url = $data['url'];
19 | 
20 |         return $this;
21 |     }
22 | 
23 |     public function toArray(): array
24 |     {
25 |         return [
26 |             'url' => $this->url
27 |         ];
28 |     }
29 | 
30 |     public function getUrl(): string
31 |     {
32 |         return $this->url;
33 |     }
34 | 
35 |     /**
36 |      * @deprecated Unsupported
37 |      * @return string
38 |      */
39 |     public function getCaption(): string
40 |     {
41 |         trigger_error(
42 |             'Captions are not supported in this API, this will error at server level.',
43 |             E_USER_DEPRECATED
44 |         );
45 | 
46 |         return $this->caption;
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Messages/MessageObjects/FileObject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\MessageObjects;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class FileObject implements ArrayHydrateInterface
 8 | {
 9 |     public function __construct(
10 |         private string $url,
11 |         private string $caption = '',
12 |         private ?string $name = null,
13 |     ) {
14 |     }
15 | 
16 |     public function fromArray(array $data): FileObject
17 |     {
18 |         $this->url = $data['url'];
19 | 
20 |         if (isset($data['caption'])) {
21 |             $this->caption = $data['caption'];
22 |         }
23 | 
24 |         if (isset($data['name'])) {
25 |             $this->name = $data['name'];
26 |         }
27 | 
28 |         return $this;
29 |     }
30 | 
31 |     public function toArray(): array
32 |     {
33 |         $returnArray = [
34 |             'url' => $this->url
35 |         ];
36 | 
37 |         if ($this->getCaption()) {
38 |             $returnArray['caption'] = $this->getCaption();
39 |         }
40 | 
41 |         if ($this->getName()) {
42 |             $returnArray['name'] = $this->getName();
43 |         }
44 | 
45 |         return $returnArray;
46 |     }
47 | 
48 |     public function getUrl(): string
49 |     {
50 |         return $this->url;
51 |     }
52 | 
53 |     public function getCaption(): string
54 |     {
55 |         return $this->caption;
56 |     }
57 | 
58 |     public function getName(): ?string
59 |     {
60 |         return $this->name;
61 |     }
62 | 
63 |     public function setName(?string $name): void
64 |     {
65 |         $this->name = $name;
66 |     }
67 | }
68 | 


--------------------------------------------------------------------------------
/src/Messages/MessageObjects/ImageObject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\MessageObjects;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class ImageObject implements ArrayHydrateInterface
 8 | {
 9 |     public function __construct(
10 |         private string $url,
11 |         private string $caption = '',
12 |     ) {
13 |     }
14 | 
15 |     public function fromArray(array $data): ImageObject
16 |     {
17 |         $this->url = $data['url'];
18 | 
19 |         if (isset($data['caption'])) {
20 |             $this->caption = $data['caption'];
21 |         }
22 | 
23 |         return $this;
24 |     }
25 | 
26 |     public function toArray(): array
27 |     {
28 |         $returnArray = [
29 |             'url' => $this->url
30 |         ];
31 | 
32 |         if ($this->getCaption()) {
33 |             $returnArray['caption'] = $this->getCaption();
34 |         }
35 | 
36 |         return $returnArray;
37 |     }
38 | 
39 |     public function getUrl(): string
40 |     {
41 |         return $this->url;
42 |     }
43 | 
44 |     public function getCaption(): string
45 |     {
46 |         return $this->caption;
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Messages/MessageObjects/TemplateObject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\MessageObjects;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class TemplateObject implements ArrayHydrateInterface
 8 | {
 9 |     public function __construct(private string $name, private array $parameters)
10 |     {
11 |     }
12 | 
13 |     public function fromArray(array $data): TemplateObject
14 |     {
15 |         $this->name = $data['name'];
16 | 
17 |         if (isset($data['parameters'])) {
18 |             $this->parameters = $data['parameters'];
19 |         }
20 | 
21 |         return $this;
22 |     }
23 | 
24 |     public function toArray(): array
25 |     {
26 |         $returnArray = [
27 |             'name' => $this->name
28 |         ];
29 | 
30 |         if ($this->parameters) {
31 |             $returnArray['parameters'] = $this->parameters;
32 |         }
33 | 
34 |         return $returnArray;
35 |     }
36 | 
37 |     public function getName(): string
38 |     {
39 |         return $this->name;
40 |     }
41 | 
42 |     public function getParameters(): array
43 |     {
44 |         return $this->parameters;
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/src/Messages/MessageObjects/VCardObject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\MessageObjects;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class VCardObject implements ArrayHydrateInterface
 8 | {
 9 |     public function __construct(
10 |         private string $url,
11 |         private ?string $caption = null
12 |     ) {
13 |     }
14 | 
15 |     public function fromArray(array $data): VCardObject
16 |     {
17 |         $this->url = $data['url'];
18 | 
19 |         return $this;
20 |     }
21 | 
22 |     public function toArray(): array
23 |     {
24 |         return [
25 |             'url' => $this->url
26 |         ];
27 |     }
28 | 
29 |     public function getUrl(): string
30 |     {
31 |         return $this->url;
32 |     }
33 | 
34 |     public function getCaption(): ?string
35 |     {
36 |         return $this->caption;
37 |     }
38 | 
39 |     public function setCaption(?string $caption): void
40 |     {
41 |         $this->caption = $caption;
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/src/Messages/MessageObjects/VideoObject.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\MessageObjects;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class VideoObject implements ArrayHydrateInterface
 8 | {
 9 |     public function __construct(private string $url, private string $caption = '')
10 |     {
11 |     }
12 | 
13 |     public function fromArray(array $data): VideoObject
14 |     {
15 |         $this->url = $data['url'];
16 | 
17 |         if (isset($data['caption'])) {
18 |             $this->caption = $data['caption'];
19 |         }
20 | 
21 |         return $this;
22 |     }
23 | 
24 |     public function toArray(): array
25 |     {
26 |         $returnArray = [
27 |             'url' => $this->url
28 |         ];
29 | 
30 |         if ($this->getCaption()) {
31 |             $returnArray['caption'] = $this->getCaption();
32 |         }
33 | 
34 |         return $returnArray;
35 |     }
36 | 
37 |     public function getUrl(): string
38 |     {
39 |         return $this->url;
40 |     }
41 | 
42 |     public function getCaption(): string
43 |     {
44 |         return $this->caption;
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/src/Messages/MessageTraits/ContextTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\MessageTraits;
 4 | 
 5 | trait ContextTrait
 6 | {
 7 |     private ?array $context;
 8 | 
 9 |     public function getContext(): ?array
10 |     {
11 |         return $this->context;
12 |     }
13 | 
14 |     public function setContext(?array $context): static
15 |     {
16 |         $this->context = $context;
17 | 
18 |         return $this;
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Messages/MessageTraits/TextTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\MessageTraits;
 4 | 
 5 | trait TextTrait
 6 | {
 7 |     private string $text;
 8 | 
 9 |     public function getText(): string
10 |     {
11 |         return $this->text;
12 |     }
13 | 
14 |     public function setText(string $text): void
15 |     {
16 |         $this->text = $text;
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Messages/MessageTraits/TtlTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Messages\MessageTraits;
 4 | 
 5 | trait TtlTrait
 6 | {
 7 |     private ?int $ttl;
 8 | 
 9 |     public function getTtl(): ?int
10 |     {
11 |         return $this->ttl;
12 |     }
13 | 
14 |     public function setTTl(?int $ttl): static
15 |     {
16 |         $this->ttl = $ttl;
17 | 
18 |         return $this;
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/src/Messages/Webhook/Factory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Messages\Webhook;
 6 | 
 7 | use InvalidArgumentException;
 8 | use Vonage\Webhook\Factory as WebhookFactory;
 9 | 
10 | class Factory extends WebhookFactory
11 | {
12 |     protected static array $classMap = [
13 |         'sms' => 'Vonage\Messages\Webhook\InboundSMS',
14 |         'mms' => 'Vonage\Messages\Webhook\InboundMMS',
15 |         'rcs' => 'Vonage\Messages\Webhook\InboundRCS',
16 |         'whatsapp' => 'Vonage\Messages\Webhook\InboundWhatsApp',
17 |         'messenger' => 'Vonage\Messages\Webhook\InboundMessenger',
18 |         'viber_service' => 'Vonage\Messages\Webhook\InboundViber'
19 |     ];
20 | 
21 |     public static function createFromArray(array $data): mixed
22 |     {
23 |         if (!isset($data['channel'])) {
24 |             throw new InvalidArgumentException("The 'channel' key is missing in the incoming data.");
25 |         }
26 | 
27 |         $channel = $data['channel'];
28 | 
29 |         if (!array_key_exists($channel, self::$classMap)) {
30 |             throw new InvalidArgumentException("Unable to determine incoming webhook type for channel: {$channel}");
31 |         }
32 | 
33 |         return new self::$classMap[$channel]();
34 |     }
35 | }
36 | 


--------------------------------------------------------------------------------
/src/Messages/Webhook/InboundMMS.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Messages\Webhook;
 6 | 
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | final class InboundMMS implements ArrayHydrateInterface
10 | {
11 |     protected ?array $data = null;
12 | 
13 |     public function fromArray(array $data): self
14 |     {
15 |         $this->data = $data;
16 |         return $this;
17 |     }
18 | 
19 |     public function toArray(): array
20 |     {
21 |         return $this->data;
22 |     }
23 | 
24 |     public function __get($name)
25 |     {
26 |         return $this->data[$name];
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Messages/Webhook/InboundMessenger.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Messages\Webhook;
 6 | 
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | final class InboundMessenger implements ArrayHydrateInterface
10 | {
11 |     protected ?array $data = null;
12 | 
13 |     public function fromArray(array $data): self
14 |     {
15 |         $this->data = $data;
16 |         return $this;
17 |     }
18 | 
19 |     public function toArray(): array
20 |     {
21 |         return $this->data;
22 |     }
23 | 
24 |     public function __get($name)
25 |     {
26 |         return $this->data[$name];
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Messages/Webhook/InboundRCS.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Messages\Webhook;
 6 | 
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | final class InboundRCS implements ArrayHydrateInterface
10 | {
11 |     protected ?array $data = null;
12 | 
13 |     public function fromArray(array $data): self
14 |     {
15 |         $this->data = $data;
16 |         return $this;
17 |     }
18 | 
19 |     public function toArray(): array
20 |     {
21 |         return $this->data;
22 |     }
23 | 
24 |     public function __get($name)
25 |     {
26 |         return $this->data[$name];
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Messages/Webhook/InboundSMS.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Messages\Webhook;
 6 | 
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | final class InboundSMS implements ArrayHydrateInterface
10 | {
11 |     protected ?array $data = null;
12 | 
13 |     public function fromArray(array $data): self
14 |     {
15 |         $this->data = $data;
16 |         return $this;
17 |     }
18 | 
19 |     public function toArray(): array
20 |     {
21 |         return $this->data;
22 |     }
23 | 
24 |     public function __get($name)
25 |     {
26 |         return $this->data[$name];
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Messages/Webhook/InboundViber.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Messages\Webhook;
 6 | 
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | final class InboundViber implements ArrayHydrateInterface
10 | {
11 |     protected ?array $data = null;
12 | 
13 |     public function fromArray(array $data): self
14 |     {
15 |         $this->data = $data;
16 |         return $this;
17 |     }
18 | 
19 |     public function toArray(): array
20 |     {
21 |         return $this->data;
22 |     }
23 | 
24 |     public function __get($name)
25 |     {
26 |         return $this->data[$name];
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Messages/Webhook/InboundWhatsApp.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Messages\Webhook;
 6 | 
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | final class InboundWhatsApp implements ArrayHydrateInterface
10 | {
11 |     protected ?array $data = null;
12 | 
13 |     public function fromArray(array $data): self
14 |     {
15 |         $this->data = $data;
16 |         return $this;
17 |     }
18 | 
19 |     public function toArray(): array
20 |     {
21 |         return $this->data;
22 |     }
23 | 
24 |     public function __get($name)
25 |     {
26 |         return $this->data[$name];
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Network/Number/Request.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Network\Number;
 6 | 
 7 | use Vonage\Client\Request\AbstractRequest;
 8 | use Vonage\Client\Request\WrapResponseInterface;
 9 | use Vonage\Client\Response\Error;
10 | use Vonage\Client\Response\ResponseInterface;
11 | 
12 | use function implode;
13 | 
14 | class Request extends AbstractRequest implements WrapResponseInterface
15 | {
16 |     public const FEATURE_TYPE = 'type';
17 |     public const FEATURE_VALID = 'valid';
18 |     public const FEATURE_REACHABLE = 'reachable';
19 |     public const FEATURE_CARRIER = 'carrier';
20 |     public const FEATURE_PORTED = 'ported';
21 |     public const FEATURE_ROAMING = 'roaming';
22 |     public const FEATURE_SUBSCRIBER = 'subscriber';
23 | 
24 |     /**
25 |      * @var array
26 |      */
27 |     protected $params;
28 | 
29 |     public function __construct($number, $callback, array $features = [], $timeout = null, $method = null, $ref = null)
30 |     {
31 |         $this->params['number'] = $number;
32 |         $this->params['callback'] = $callback;
33 |         $this->params['callback_timeout'] = $timeout;
34 |         $this->params['callback_method'] = $method;
35 |         $this->params['client_ref'] = $ref;
36 | 
37 |         if (!empty($features)) {
38 |             $this->params['features'] = implode(',', $features);
39 |         }
40 |     }
41 | 
42 |     public function getURI(): string
43 |     {
44 |         return '/ni/json';
45 |     }
46 | 
47 |     public function wrapResponse(ResponseInterface $response): ResponseInterface
48 |     {
49 |         if ($response->isError()) {
50 |             return new Error($response->getData());
51 |         }
52 | 
53 |         return new Response($response->getData());
54 |     }
55 | }
56 | 


--------------------------------------------------------------------------------
/src/NumberVerification/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\NumberVerification;
 4 | 
 5 | use Psr\Container\ContainerInterface;
 6 | use Vonage\Client\APIResource;
 7 | use Vonage\Client\Credentials\Handler\NumberVerificationGnpHandler;
 8 | 
 9 | class ClientFactory
10 | {
11 |     public function __invoke(ContainerInterface $container): Client
12 |     {
13 |         $handler = new NumberVerificationGnpHandler();
14 |         $handler->setBaseUrl('https://oidc.idp.vonage.com/oauth2/auth');
15 |         $handler->setTokenUrl('https://api-eu.vonage.com/oauth2/token');
16 |         $handler->setScope('openid+dpv:FraudPreventionAndDetection#number-verification-verify-read');
17 | 
18 |         $client = $container->get(\Vonage\Client::class);
19 |         $handler->setClient($client);
20 | 
21 |         /** @var APIResource $api */
22 |         $api = $container->make(APIResource::class);
23 |         $api
24 |             ->setBaseUrl('https://api-eu.vonage.com/camara/number-verification/v031')
25 |             ->setIsHAL(false)
26 |             ->setClient($client)
27 |             ->setErrorsOn200(false)
28 |             ->setAuthHandlers($handler);
29 | 
30 |         return new Client($api);
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Numbers/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Numbers;
 6 | 
 7 | use Psr\Container\ContainerInterface;
 8 | use Vonage\Client\APIResource;
 9 | use Vonage\Client\Credentials\Handler\BasicHandler;
10 | 
11 | class ClientFactory
12 | {
13 |     public function __invoke(ContainerInterface $container): Client
14 |     {
15 |         /** @var APIResource $api */
16 |         $api = $container->make(APIResource::class);
17 |         $api
18 |             ->setBaseUrl($api->getClient()->getRestUrl())
19 |             ->setIsHAL(false)
20 |             ->setAuthHandlers(new BasicHandler());
21 | 
22 |         return new Client($api);
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Numbers/Hydrator.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Numbers;
 6 | 
 7 | use Vonage\Entity\Hydrator\HydratorInterface;
 8 | 
 9 | class Hydrator implements HydratorInterface
10 | {
11 |     public function hydrate(array $data)
12 |     {
13 |         $number = new Number();
14 |         return $this->hydrateObject($data, $number);
15 |     }
16 | 
17 |     public function hydrateObject(array $data, $object)
18 |     {
19 |         $object->fromArray($data);
20 |         return $object;
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/ProactiveConnect/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\ProactiveConnect;
 4 | 
 5 | use Psr\Container\ContainerInterface;
 6 | use Vonage\Client\APIResource;
 7 | use Vonage\Client\Credentials\Handler\KeypairHandler;
 8 | 
 9 | class ClientFactory
10 | {
11 |     public function __invoke(ContainerInterface $container): Client
12 |     {
13 |         $api = $container->make(APIResource::class);
14 |         $api->setIsHAL(false)
15 |             ->setErrorsOn200(false)
16 |             ->setAuthHandlers([new KeypairHandler()])
17 |             ->setBaseUrl('https://api-eu.vonage.com/v0.1/bulk/');
18 | 
19 |         return new Client($api);
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/src/ProactiveConnect/Objects/ListBaseObject.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | namespace Vonage\ProactiveConnect\Objects;
4 | 
5 | abstract class ListBaseObject
6 | {
7 | }
8 | 


--------------------------------------------------------------------------------
/src/ProactiveConnect/Objects/ListItem.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\ProactiveConnect\Objects;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class ListItem implements ArrayHydrateInterface
 8 | {
 9 |     public function __construct(protected array $data)
10 |     {
11 |     }
12 | 
13 |     public function set($name, $value): static
14 |     {
15 |         $this->data[$name] = $value;
16 | 
17 |         return $this;
18 |     }
19 | 
20 |     public function get(string $name)
21 |     {
22 |         return $this->data[$name];
23 |     }
24 | 
25 |     public function fromArray(array $data): void
26 |     {
27 |         $this->data = $data;
28 |     }
29 | 
30 |     public function toArray(): array
31 |     {
32 |         return [
33 |             'data' => $this->data
34 |         ];
35 |     }
36 | }
37 | 


--------------------------------------------------------------------------------
/src/Redact/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Redact;
 6 | 
 7 | use Psr\Container\ContainerInterface;
 8 | use Vonage\Client\APIExceptionHandler;
 9 | use Vonage\Client\APIResource;
10 | use Vonage\Client\Credentials\Handler\BasicHandler;
11 | 
12 | /**
13 |  * @todo Finish this Namespace
14 |  */
15 | class ClientFactory
16 | {
17 |     public function __invoke(ContainerInterface $container): Client
18 |     {
19 |         /** @var APIResource $api */
20 |         $api = $container->make(APIResource::class);
21 |         $api
22 |             ->setBaseUri('/v1/redact/transaction')
23 |             ->setAuthHandlers(new BasicHandler())
24 |             ->setCollectionName('');
25 | 
26 |         // This API has a slightly different format for the error message, so override
27 |         $exceptionHandler = $api->getExceptionErrorHandler();
28 | 
29 |         if ($exceptionHandler instanceof APIExceptionHandler) {
30 |             $exceptionHandler->setRfc7807Format("%s - %s. See %s for more information");
31 |         }
32 | 
33 |         $api->setExceptionErrorHandler($exceptionHandler);
34 | 
35 |         return new Client($api);
36 |     }
37 | }
38 | 


--------------------------------------------------------------------------------
/src/SMS/Client.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\SMS;
 6 | 
 7 | use Psr\Http\Client\ClientExceptionInterface;
 8 | use Psr\Log\LogLevel;
 9 | use Vonage\Client\APIClient;
10 | use Vonage\Client\APIResource;
11 | use Vonage\Client\Exception\Exception as ClientException;
12 | use Vonage\Client\Exception\ThrottleException;
13 | use Vonage\Logger\LoggerTrait;
14 | use Vonage\SMS\Message\Message;
15 | 
16 | use function sleep;
17 | 
18 | class Client implements APIClient
19 | {
20 |     use LoggerTrait;
21 | 
22 |     public function __construct(protected APIResource $api)
23 |     {
24 |     }
25 | 
26 |     public function getAPIResource(): APIResource
27 |     {
28 |         return $this->api;
29 |     }
30 | 
31 |     /**
32 |      * @throws ClientExceptionInterface
33 |      * @throws ClientException
34 |      */
35 |     public function send(Message $message): Collection
36 |     {
37 |         if ($warningMessage = $message->getWarningMessage()) {
38 |             $this->log(LogLevel::WARNING, $warningMessage);
39 |         }
40 | 
41 |         try {
42 |             $response = $this->api->create($message->toArray(), '/sms/json');
43 | 
44 |             return new Collection($response);
45 |         } catch (ThrottleException $e) {
46 |             sleep($e->getTimeout());
47 | 
48 |             return $this->send($message);
49 |         }
50 |     }
51 | 
52 |     /**
53 |      * @throws ClientExceptionInterface
54 |      * @throws ClientException
55 |      */
56 |     public function sendTwoFactor(string $number, int $pin): SentSMS
57 |     {
58 |         $response = $this->api->create(
59 |             ['to' => $number, 'pin' => $pin],
60 |             '/sc/us/2fa/json'
61 |         );
62 | 
63 |         return new SentSMS($response['messages'][0]);
64 |     }
65 | 
66 |     /**
67 |      * @throws ClientExceptionInterface
68 |      * @throws ClientException
69 |      */
70 |     public function sendAlert(string $number, array $templateReplacements): Collection
71 |     {
72 |         $response = $this->api->create(
73 |             ['to' => $number] + $templateReplacements,
74 |             '/sc/us/alert/json'
75 |         );
76 |         return new Collection($response);
77 |     }
78 | }
79 | 


--------------------------------------------------------------------------------
/src/SMS/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\SMS;
 6 | 
 7 | use Psr\Container\ContainerInterface;
 8 | use Vonage\Client\APIResource;
 9 | use Vonage\Client\Credentials\Handler\BasicHandler;
10 | use Vonage\Client\Credentials\Handler\SignatureBodyHandler;
11 | 
12 | class ClientFactory
13 | {
14 |     public function __invoke(ContainerInterface $container): Client
15 |     {
16 |         /** @var APIResource $api */
17 |         $api = $container->make(APIResource::class);
18 |         $api
19 |             ->setBaseUrl($api->getClient()->getRestUrl())
20 |             ->setCollectionName('messages')
21 |             ->setIsHAL(false)
22 |             ->setErrorsOn200(true)
23 |             ->setExceptionErrorHandler(new ExceptionErrorHandler())
24 |             ->setAuthHandlers([new BasicHandler(), new SignatureBodyHandler()]);
25 | 
26 |         return new Client($api);
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/src/SMS/Collection.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\SMS;
 6 | 
 7 | use Countable;
 8 | use Iterator;
 9 | 
10 | class Collection implements Countable, Iterator
11 | {
12 |     protected int $current = 0;
13 | 
14 |     /**
15 |      * @param array<string, int|array<string, mixed>> $data
16 |      */
17 |     public function __construct(protected array $data)
18 |     {
19 |     }
20 | 
21 |     public function count(): int
22 |     {
23 |         return (int)$this->data['message-count'];
24 |     }
25 | 
26 |     public function current(): SentSMS
27 |     {
28 |         return new SentSMS($this->data['messages'][$this->current]);
29 |     }
30 | 
31 |     /**
32 |      * @return bool|float|int|string|null
33 |      */
34 |     #[\ReturnTypeWillChange]
35 |     public function key()
36 |     {
37 |         return $this->current;
38 |     }
39 | 
40 |     public function next(): void
41 |     {
42 |         $this->current++;
43 |     }
44 | 
45 |     public function rewind(): void
46 |     {
47 |         $this->current = 0;
48 |     }
49 | 
50 |     public function valid(): bool
51 |     {
52 |         return isset($this->data['messages'][$this->current]);
53 |     }
54 | 
55 |     public function getAllMessagesRaw(): array
56 |     {
57 |         return $this->data;
58 |     }
59 | }
60 | 


--------------------------------------------------------------------------------
/src/SMS/Message/Binary.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\SMS\Message;
 6 | 
 7 | class Binary extends OutboundMessage
 8 | {
 9 |     /**
10 |      * @var string
11 |      */
12 |     protected string $type = 'binary';
13 | 
14 |     public function __construct(string $to, string $from, protected string $body, protected string $udh, protected ?int $protocolId = null)
15 |     {
16 |         parent::__construct($to, $from);
17 |     }
18 | 
19 |     /**
20 |      * @return mixed
21 |      */
22 |     public function toArray(): array
23 |     {
24 |         $data = [
25 |             'body' => $this->getBody(),
26 |             'udh' => $this->getUdh(),
27 |         ];
28 | 
29 |         if ($this->getProtocolId()) {
30 |             $data['protocol-id'] = $this->getProtocolId();
31 |         }
32 | 
33 |         $data = $this->appendUniversalOptions($data);
34 | 
35 |         return $data;
36 |     }
37 | 
38 |     public function getBody(): string
39 |     {
40 |         return $this->body;
41 |     }
42 | 
43 |     public function getUdh(): string
44 |     {
45 |         return $this->udh;
46 |     }
47 | 
48 |     public function getProtocolId(): ?int
49 |     {
50 |         return $this->protocolId;
51 |     }
52 | }
53 | 


--------------------------------------------------------------------------------
/src/SMS/Message/Message.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\SMS\Message;
 6 | 
 7 | interface Message
 8 | {
 9 |     public function toArray(): array;
10 |     public function getErrorMessage(): ?string;
11 |     public function getWarningMessage(): ?string;
12 |     public function setWarningMessage(?string $errorMessage): void;
13 | }
14 | 


--------------------------------------------------------------------------------
/src/SMS/SentSMS.php:
--------------------------------------------------------------------------------
  1 | <?php
  2 | 
  3 | declare(strict_types=1);
  4 | 
  5 | namespace Vonage\SMS;
  6 | 
  7 | class SentSMS
  8 | {
  9 |     /**
 10 |      * @var ?string
 11 |      */
 12 |     protected $accountRef;
 13 | 
 14 |     /**
 15 |      * @var ?string
 16 |      */
 17 |     protected $clientRef;
 18 | 
 19 |     /**
 20 |      * @var string
 21 |      */
 22 |     protected $messageId;
 23 | 
 24 |     /**
 25 |      * @var string
 26 |      */
 27 |     protected $messagePrice;
 28 | 
 29 |     /**
 30 |      * @var string
 31 |      */
 32 |     protected $network;
 33 | 
 34 |     /**
 35 |      * @var string
 36 |      */
 37 |     protected $remainingBalance;
 38 | 
 39 |     /**
 40 |      * @var int
 41 |      */
 42 |     protected $status;
 43 | 
 44 |     /**
 45 |      * @var string
 46 |      */
 47 |     protected $to;
 48 | 
 49 |     public function __construct(array $data)
 50 |     {
 51 |         $this->accountRef = $data['account-ref'] ?? null;
 52 |         $this->clientRef = $data['client-ref'] ?? null;
 53 |         $this->to = $data['to'];
 54 |         $this->messageId = $data['message-id'];
 55 |         $this->status = (int)$data['status'];
 56 |         $this->remainingBalance = $data['remaining-balance'];
 57 |         $this->messagePrice = $data['message-price'];
 58 |         $this->network = $data['network'];
 59 |     }
 60 | 
 61 |     public function getAccountRef(): ?string
 62 |     {
 63 |         return $this->accountRef;
 64 |     }
 65 | 
 66 |     public function getClientRef(): ?string
 67 |     {
 68 |         return $this->clientRef;
 69 |     }
 70 | 
 71 |     public function getMessageId(): string
 72 |     {
 73 |         return $this->messageId;
 74 |     }
 75 | 
 76 |     public function getMessagePrice(): string
 77 |     {
 78 |         return $this->messagePrice;
 79 |     }
 80 | 
 81 |     public function getNetwork(): string
 82 |     {
 83 |         return $this->network;
 84 |     }
 85 | 
 86 |     public function getRemainingBalance(): string
 87 |     {
 88 |         return $this->remainingBalance;
 89 |     }
 90 | 
 91 |     public function getStatus(): int
 92 |     {
 93 |         return $this->status;
 94 |     }
 95 | 
 96 |     public function getTo(): string
 97 |     {
 98 |         return $this->to;
 99 |     }
100 | }
101 | 


--------------------------------------------------------------------------------
/src/SMS/Webhook/Factory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\SMS\Webhook;
 6 | 
 7 | use Exception;
 8 | use InvalidArgumentException;
 9 | use Vonage\Webhook\Factory as WebhookFactory;
10 | 
11 | use function array_intersect;
12 | use function array_key_exists;
13 | use function array_keys;
14 | use function count;
15 | 
16 | class Factory extends WebhookFactory
17 | {
18 |     /**
19 |      * @throws Exception
20 |      *
21 |      * @return mixed|DeliveryReceipt|InboundSMS
22 |      */
23 |     public static function createFromArray(array $data)
24 |     {
25 |         // We are dealing with only two webhooks here. One has the text field, one does not.
26 |         // A sort of if/else style block here smells a bit, ideally the backend needs to change.
27 | 
28 |         if (!array_key_exists('text', $data)) {
29 |             return new DeliveryReceipt($data);
30 |         }
31 | 
32 |         if (
33 |             count(array_intersect(array_keys($data), InboundSMS::$requiredFields))
34 |             === count(InboundSMS::$requiredFields)
35 |         ) {
36 |             return new InboundSMS($data);
37 |         }
38 | 
39 |         throw new InvalidArgumentException("Unable to determine incoming webhook type");
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Secrets/Client.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Secrets;
 4 | 
 5 | use Vonage\Client\APIClient;
 6 | use Vonage\Client\APIResource;
 7 | use Vonage\Entity\Hydrator\ArrayHydrator;
 8 | use Vonage\Entity\IterableAPICollection;
 9 | 
10 | class Client implements APIClient
11 | {
12 |     public function __construct(protected APIResource $api)
13 |     {
14 |     }
15 | 
16 |     public function getAPIResource(): APIResource
17 |     {
18 |         return $this->api;
19 |     }
20 | 
21 |     public function get(string $accountId, string $id): Secret
22 |     {
23 |         $data = $this->api->get("{$accountId}/secrets/{$id}");
24 | 
25 |         return new Secret($data);
26 |     }
27 | 
28 |     public function list(string $accountId): IterableAPICollection
29 |     {
30 |         $collection = $this->api->search(null, "/accounts/{$accountId}/secrets");
31 |         $hydrator = new ArrayHydrator();
32 |         $hydrator->setPrototype(new Secret());
33 |         $collection->setHydrator($hydrator);
34 | 
35 |         return $collection;
36 |     }
37 | 
38 |     public function create(string $accountId, string $secret): Secret
39 |     {
40 |         $response = $this->api->create(['secret' => $secret], "/{$accountId}/secrets");
41 |         return new Secret($response);
42 |     }
43 | 
44 |     public function revoke(string $accountId, string $id)
45 |     {
46 |         $this->api->delete("{$accountId}/secrets/{$id}");
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Secrets/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Secrets;
 6 | 
 7 | use Vonage\Client\APIResource;
 8 | use Vonage\Client\Credentials\Handler\BasicHandler;
 9 | use Vonage\Client\Factory\FactoryInterface;
10 | 
11 | class ClientFactory
12 | {
13 |     public function __invoke(FactoryInterface $container): Client
14 |     {
15 |         $api = $container->make(APIResource::class);
16 |         $api->setBaseUri('/accounts')
17 |             ->setAuthHandlers(new BasicHandler())
18 |             ->setCollectionName('secrets');
19 | 
20 |         return new Client($api);
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Secrets/Secret.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Secrets;
 4 | 
 5 | use DateTimeImmutable;
 6 | use DateTimeInterface;
 7 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 8 | 
 9 | class Secret implements ArrayHydrateInterface
10 | {
11 |     protected DateTimeImmutable $createdAt;
12 | 
13 |     protected string $id;
14 | 
15 |     public function __construct(array $data = [])
16 |     {
17 |         if (!empty($data)) {
18 |             $this->fromArray($data);
19 |         }
20 |     }
21 | 
22 |     public function getId(): string
23 |     {
24 |         return $this->id;
25 |     }
26 | 
27 |     public function getCreatedAt(): DateTimeInterface
28 |     {
29 |         return $this->createdAt;
30 |     }
31 | 
32 |     public function fromArray(array $data)
33 |     {
34 |         $this->id = $data['id'];
35 |         $this->createdAt = new DateTimeImmutable($data['created_at']);
36 |     }
37 | 
38 |     public function toArray(): array
39 |     {
40 |         return [
41 |             'id' => $this->id,
42 |             'created_at' => $this->createdAt->format('Y-m-d\TH:i:s\Z'),
43 |         ];
44 |     }
45 | }
46 | 


--------------------------------------------------------------------------------
/src/SimSwap/Client.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\SimSwap;
 6 | 
 7 | use Vonage\Client\APIClient;
 8 | use Vonage\Client\APIResource;
 9 | use Vonage\Client\Credentials\Handler\SimSwapGnpHandler;
10 | 
11 | class Client implements APIClient
12 | {
13 |     public function __construct(protected APIResource $api)
14 |     {
15 |     }
16 | 
17 |     public function getAPIResource(): APIResource
18 |     {
19 |         return $this->api;
20 |     }
21 | 
22 |     public function checkSimSwap(string $number, ?int $maxAge = null)
23 |     {
24 |         /** @var SimSwapGnpHandler $handler */
25 |         $handler = $this->getAPIResource()->getAuthHandlers()[0];
26 |         $handler->setScope('dpv:FraudPreventionAndDetection#check-sim-swap');
27 | 
28 |         if (!$handler instanceof SimSwapGnpHandler) {
29 |             throw new \RuntimeException('SimSwap Client has been misconfigured. Only a GNP Handler can be used');
30 |         }
31 | 
32 |         $payload = [
33 |             'phoneNumber' => $number
34 |         ];
35 | 
36 |         if (!is_null($maxAge)) {
37 |             $payload['maxAge'] = $maxAge;
38 |         }
39 | 
40 |         $response = $this->getAPIResource()->create($payload, 'check');
41 | 
42 |         return $response['swapped'];
43 |     }
44 | 
45 |     public function checkSimSwapDate(string $number): string
46 |     {
47 |         /** @var SimSwapGnpHandler $handler */
48 |         $handler = $this->getAPIResource()->getAuthHandlers()[0];
49 |         $handler->setScope('dpv:FraudPreventionAndDetection#retrieve-sim-swap-date');
50 | 
51 |         if (!$handler instanceof SimSwapGnpHandler) {
52 |             throw new \RuntimeException('SimSwap Client has been misconfigured. Only a GNP Handler can be used');
53 |         }
54 | 
55 |         $response = $this->getAPIResource()->create(['phoneNumber' => $number], 'retrieve-date');
56 | 
57 |         return $response['latestSimChange'];
58 |     }
59 | }
60 | 


--------------------------------------------------------------------------------
/src/SimSwap/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\SimSwap;
 4 | 
 5 | use Psr\Container\ContainerInterface;
 6 | use Vonage\Client\APIResource;
 7 | use Vonage\Client\Credentials\Handler\SimSwapGnpHandler;
 8 | 
 9 | class ClientFactory
10 | {
11 |     public function __invoke(ContainerInterface $container): Client
12 |     {
13 |         $handler = new SimSwapGnpHandler();
14 |         $handler->setBaseUrl('https://api-eu.vonage.com/oauth2/bc-authorize');
15 |         $handler->setTokenUrl('https://api-eu.vonage.com/oauth2/token');
16 | 
17 |         $client = $container->get(\Vonage\Client::class);
18 |         $handler->setClient($client);
19 | 
20 |         /** @var APIResource $api */
21 |         $api = $container->make(APIResource::class);
22 |         $api
23 |             ->setBaseUrl('https://api-eu.vonage.com/camara/sim-swap/v040')
24 |             ->setIsHAL(false)
25 |             ->setClient($client)
26 |             ->setErrorsOn200(false)
27 |             ->setAuthHandlers($handler);
28 | 
29 |         return new Client($api);
30 |     }
31 | }
32 | 


--------------------------------------------------------------------------------
/src/Subaccount/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Subaccount;
 4 | 
 5 | use Psr\Container\ContainerInterface;
 6 | use Vonage\Client\APIResource;
 7 | 
 8 | class ClientFactory
 9 | {
10 |     public function __invoke(ContainerInterface $container): Client
11 |     {
12 |         $api = $container->make(APIResource::class);
13 |         $api->setIsHAL(true)
14 |             ->setErrorsOn200(false)
15 |             ->setBaseUrl('https://api.nexmo.com/accounts');
16 | 
17 |         return new Client($api);
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Subaccount/Request/TransferBalanceRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Subaccount\Request;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class TransferBalanceRequest implements ArrayHydrateInterface
 8 | {
 9 |     private string $from;
10 |     private string $to;
11 |     private string $amount;
12 |     private string $reference;
13 | 
14 |     public function __construct(protected string $apiKey)
15 |     {
16 |     }
17 |     public function getFrom(): string
18 |     {
19 |         return $this->from;
20 |     }
21 | 
22 |     public function setFrom(string $from): self
23 |     {
24 |         $this->from = $from;
25 | 
26 |         return $this;
27 |     }
28 | 
29 |     public function getTo(): string
30 |     {
31 |         return $this->to;
32 |     }
33 | 
34 |     public function setTo(string $to): self
35 |     {
36 |         $this->to = $to;
37 | 
38 |         return $this;
39 |     }
40 | 
41 |     public function getAmount(): string
42 |     {
43 |         return $this->amount;
44 |     }
45 | 
46 |     public function setAmount(string $amount): self
47 |     {
48 |         $this->amount = $amount;
49 | 
50 |         return $this;
51 |     }
52 | 
53 |     public function getReference(): string
54 |     {
55 |         return $this->reference;
56 |     }
57 | 
58 |     public function setReference(string $reference): self
59 |     {
60 |         $this->reference = $reference;
61 | 
62 |         return $this;
63 |     }
64 | 
65 |     public function getApiKey(): string
66 |     {
67 |         return $this->apiKey;
68 |     }
69 | 
70 |     public function setApiKey(string $apiKey): self
71 |     {
72 |         $this->apiKey = $apiKey;
73 | 
74 |         return $this;
75 |     }
76 | 
77 |     public function fromArray(array $data): static
78 |     {
79 |         $this->from = $data['from'];
80 |         $this->to = $data['to'];
81 |         $this->amount = $data['amount'];
82 |         $this->reference = $data['reference'];
83 | 
84 |         return $this;
85 |     }
86 | 
87 |     public function toArray(): array
88 |     {
89 |         return [
90 |             'from' => $this->getFrom(),
91 |             'to' => $this->getTo(),
92 |             'amount' => (float)$this->getAmount(),
93 |             'reference' => $this->getReference()
94 |         ];
95 |     }
96 | }
97 | 


--------------------------------------------------------------------------------
/src/Users/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Users;
 6 | 
 7 | use Psr\Container\ContainerInterface;
 8 | use Vonage\Client\APIResource;
 9 | use Vonage\Client\Credentials\Handler\KeypairHandler;
10 | use Vonage\Entity\Hydrator\ArrayHydrator;
11 | 
12 | class ClientFactory
13 | {
14 |     public function __invoke(ContainerInterface $container): Client
15 |     {
16 |         $api = $container->make(APIResource::class);
17 |         $api
18 |             ->setBaseUri('/v1/users')
19 |             ->setCollectionName('users')
20 |             ->setAuthHandlers(new KeypairHandler());
21 | 
22 |         $hydrator = new ArrayHydrator();
23 |         $hydrator->setPrototype(new User());
24 | 
25 |         return new Client($api, $hydrator);
26 |     }
27 | }
28 | 


--------------------------------------------------------------------------------
/src/Users/Filter/UserFilter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Users\Filter;
 6 | 
 7 | use InvalidArgumentException;
 8 | use Vonage\Entity\Filter\FilterInterface;
 9 | 
10 | class UserFilter implements FilterInterface
11 | {
12 |     public const ORDER_ASC = 'asc';
13 |     public const ORDER_DESC = 'desc';
14 | 
15 |     protected ?int $pageSize = null;
16 | 
17 |     protected ?string $order = null;
18 |     protected ?string $cursor = null;
19 | 
20 |     public function getQuery(): array
21 |     {
22 |         $query = [];
23 | 
24 |         if ($this->pageSize !== null) {
25 |             $query['page_size'] = $this->getPageSize();
26 |         }
27 | 
28 |         if ($this->order !== null) {
29 |             $query['order'] = $this->getOrder();
30 |         }
31 | 
32 |         if ($this->cursor !== null) {
33 |             $query['cursor'] = $this->getCursor();
34 |         }
35 | 
36 |         return $query;
37 |     }
38 | 
39 |     public function getPageSize(): int
40 |     {
41 |         return $this->pageSize;
42 |     }
43 | 
44 |     public function setPageSize(int $pageSize): static
45 |     {
46 |         $this->pageSize = $pageSize;
47 | 
48 |         return $this;
49 |     }
50 | 
51 |     public function getOrder(): string
52 |     {
53 |         return $this->order;
54 |     }
55 | 
56 |     public function setOrder(string $order): static
57 |     {
58 |         if ($order !== self::ORDER_ASC && $order !== self::ORDER_DESC) {
59 |             throw new InvalidArgumentException('Order must be `asc` or `desc`');
60 |         }
61 | 
62 |         $this->order = $order;
63 | 
64 |         return $this;
65 |     }
66 | 
67 |     public function getCursor(): ?string
68 |     {
69 |         return $this->cursor;
70 |     }
71 | 
72 |     public function setCursor(?string $cursor): static
73 |     {
74 |         $this->cursor = $cursor;
75 | 
76 |         return $this;
77 |     }
78 | }
79 | 


--------------------------------------------------------------------------------
/src/Verify/Check.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Verify;
 6 | 
 7 | use DateTime;
 8 | use Exception;
 9 | 
10 | class Check
11 | {
12 |     /**
13 |      * Possible status of checking a code.
14 |      */
15 |     public const VALID = 'VALID';
16 |     public const INVALID = 'INVALID';
17 | 
18 |     public function __construct(protected array $data)
19 |     {
20 |     }
21 | 
22 |     public function getCode(): mixed
23 |     {
24 |         return $this->data['code'];
25 |     }
26 | 
27 |     /**
28 |      * @throws Exception
29 |      */
30 |     public function getDate(): DateTime
31 |     {
32 |         return new DateTime($this->data['date_received']);
33 |     }
34 | 
35 |     public function getStatus()
36 |     {
37 |         return $this->data['status'];
38 |     }
39 | 
40 |     public function getIpAddress()
41 |     {
42 |         return $this->data['ip_address'];
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Verify/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Verify;
 6 | 
 7 | use Psr\Container\ContainerInterface;
 8 | use Vonage\Client\APIResource;
 9 | use Vonage\Client\Credentials\Handler\TokenBodyHandler;
10 | 
11 | class ClientFactory
12 | {
13 |     public function __invoke(ContainerInterface $container): Client
14 |     {
15 |         /** @var APIResource $api */
16 |         $api = $container->make(APIResource::class);
17 |         $api
18 |             ->setIsHAL(false)
19 |             ->setBaseUri('/verify')
20 |             ->setErrorsOn200(true)
21 |             ->setAuthHandlers(new TokenBodyHandler())
22 |             ->setExceptionErrorHandler(new ExceptionErrorHandler());
23 | 
24 |         return new Client($api);
25 |     }
26 | }
27 | 


--------------------------------------------------------------------------------
/src/Verify/ExceptionErrorHandler.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Verify;
 6 | 
 7 | use Psr\Http\Message\RequestInterface;
 8 | use Psr\Http\Message\ResponseInterface;
 9 | use Vonage\Client\Exception\Request;
10 | 
11 | use function json_decode;
12 | 
13 | /**
14 |  * Error handler for API requests returned by the Verify API
15 |  */
16 | class ExceptionErrorHandler
17 | {
18 |     /**
19 |      * @todo This should throw a Server exception instead of Request, fix next major release
20 |      * @throws Request
21 |      */
22 |     public function __invoke(ResponseInterface $response, RequestInterface $request): void
23 |     {
24 |         $data = json_decode($response->getBody()->getContents(), true);
25 |         $response->getBody()->rewind();
26 |         $e = null;
27 | 
28 |         if (!isset($data['status'])) {
29 |             $e = new Request('unexpected response from API');
30 |             $e->setEntity($data);
31 |             throw $e;
32 |         }
33 | 
34 |         //normalize errors (client vrs server)
35 |         switch ($data['status']) {
36 |             // These exist because `status` is valid in both the error
37 |             // response and a success response, but serve different purposes
38 |             // in each case
39 |             case 'IN PROGRESS':
40 |             case 'SUCCESS':
41 |             case 'FAILED':
42 |             case 'EXPIRED':
43 |             case 'CANCELLED':
44 |             case '0':
45 |                 break;
46 |             case '5':
47 |             default:
48 |                 $e = new Request($data['error_text'], (int)$data['status']);
49 |                 $e->setEntity($data);
50 |                 throw $e;
51 |         }
52 |     }
53 | }
54 | 


--------------------------------------------------------------------------------
/src/Verify/VerificationInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Verify;
 6 | 
 7 | use Vonage\Entity\EntityInterface;
 8 | 
 9 | interface VerificationInterface extends EntityInterface
10 | {
11 |     public function getNumber();
12 | 
13 |     public function setCountry($country);
14 | 
15 |     public function setSenderId($id);
16 | 
17 |     public function setCodeLength($length);
18 | 
19 |     public function setLanguage($language);
20 | 
21 |     public function setRequireType($type);
22 | 
23 |     public function setPinExpiry($time);
24 | 
25 |     public function setWaitTime($time);
26 | 
27 |     public function setWorkflowId($workflow_id);
28 | }
29 | 


--------------------------------------------------------------------------------
/src/Verify2/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2;
 4 | 
 5 | use Psr\Container\ContainerInterface;
 6 | use Vonage\Client\APIResource;
 7 | use Vonage\Client\Credentials\Handler\BasicHandler;
 8 | use Vonage\Client\Credentials\Handler\KeypairHandler;
 9 | 
10 | class ClientFactory
11 | {
12 |     public function __invoke(ContainerInterface $container): Client
13 |     {
14 |         $api = $container->make(APIResource::class);
15 |         $api->setIsHAL(false)
16 |             ->setErrorsOn200(false)
17 |             ->setAuthHandlers([new KeypairHandler(), new BasicHandler()])
18 |             ->setBaseUrl('https://api.nexmo.com/v2/verify');
19 | 
20 |         return new Client($api);
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Verify2/Filters/TemplateFilter.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Verify2\Filters;
 6 | 
 7 | use Vonage\Entity\Filter\FilterInterface;
 8 | 
 9 | class TemplateFilter implements FilterInterface
10 | {
11 |     protected ?int $pageSize = null;
12 |     protected ?int $page = null;
13 | 
14 |     public function getQuery(): array
15 |     {
16 |         $return = [];
17 | 
18 |         if ($this->getPage()) {
19 |             $return['page'] = $this->getPage();
20 |         }
21 | 
22 |         if ($this->getPageSize()) {
23 |             $return['page_size'] = $this->getPageSize();
24 |         }
25 | 
26 |         return $return;
27 |     }
28 | 
29 |     public function getPageSize(): ?int
30 |     {
31 |         return $this->pageSize;
32 |     }
33 | 
34 |     public function setPageSize(int $pageSize): self
35 |     {
36 |         $this->pageSize = $pageSize;
37 | 
38 |         return $this;
39 |     }
40 | 
41 |     public function getPage(): ?int
42 |     {
43 |         return $this->page;
44 |     }
45 | 
46 |     public function setPage(int $page): self
47 |     {
48 |         $this->page = $page;
49 | 
50 |         return $this;
51 |     }
52 | }
53 | 


--------------------------------------------------------------------------------
/src/Verify2/Request/EmailRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\Request;
 4 | 
 5 | use InvalidArgumentException;
 6 | use Vonage\Verify2\VerifyObjects\VerificationLocale;
 7 | use Vonage\Verify2\VerifyObjects\VerificationWorkflow;
 8 | 
 9 | class EmailRequest extends BaseVerifyRequest
10 | {
11 |     public function __construct(
12 |         protected string $to,
13 |         protected string $brand,
14 |         protected string $from,
15 |         protected ?VerificationLocale $locale = null,
16 |     ) {
17 |         if (!self::isBrandValid($this->brand)) {
18 |             throw new InvalidArgumentException('The brand name cannot be longer than 16 characters.');
19 |         }
20 | 
21 |         if (!$this->locale) {
22 |             $this->locale = new VerificationLocale();
23 |         }
24 | 
25 |         if ($this->code) {
26 |             $this->setCode($this->code);
27 |         }
28 | 
29 |         $workflow = new VerificationWorkflow(VerificationWorkflow::WORKFLOW_EMAIL, $to, $from);
30 | 
31 |         $this->addWorkflow($workflow);
32 |     }
33 | 
34 |     public function toArray(): array
35 |     {
36 |         return $this->getBaseVerifyUniversalOutputArray();
37 |     }
38 | }
39 | 


--------------------------------------------------------------------------------
/src/Verify2/Request/RequestInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\Request;
 4 | 
 5 | use Vonage\Verify2\VerifyObjects\VerificationLocale;
 6 | use Vonage\Verify2\VerifyObjects\VerificationWorkflow;
 7 | 
 8 | interface RequestInterface
 9 | {
10 |     public function setLocale(VerificationLocale $verificationLocale): static;
11 |     public function setTimeout(int $timeout): static;
12 |     public function setClientRef(string $clientRef): static;
13 |     public function setLength(int $length): static;
14 |     public function setBrand(string $brand): static;
15 |     public function addWorkflow(VerificationWorkflow $verificationWorkflow): static;
16 |     public function getLocale(): ?VerificationLocale;
17 |     public function getTimeout(): int;
18 |     public function getClientRef(): ?string;
19 |     public function getLength(): int;
20 |     public function getBrand(): string;
21 |     public function getWorkflows(): array;
22 |     public function getBaseVerifyUniversalOutputArray(): array;
23 |     public function setCode(string $code): static;
24 |     public function getCode(): ?string;
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Verify2/Request/SMSRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\Request;
 4 | 
 5 | use InvalidArgumentException;
 6 | use Vonage\Verify2\Traits\CustomTemplateTrait;
 7 | use Vonage\Verify2\VerifyObjects\VerificationLocale;
 8 | use Vonage\Verify2\VerifyObjects\VerificationWorkflow;
 9 | 
10 | class SMSRequest extends BaseVerifyRequest
11 | {
12 |     use CustomTemplateTrait;
13 | 
14 |     public function __construct(
15 |         protected string $to,
16 |         protected string $brand,
17 |         protected ?VerificationLocale $locale = null,
18 |         protected string $from = '',
19 |         protected string $entityId = '',
20 |         protected string $contentId = ''
21 |     ) {
22 |         if (!self::isBrandValid($this->brand)) {
23 |             throw new InvalidArgumentException('The brand name cannot be longer than 16 characters.');
24 |         }
25 | 
26 |         if (!$this->locale) {
27 |             $this->locale = new VerificationLocale();
28 |         }
29 | 
30 |         $customKeys = array_filter([
31 |             'entity_id' => $this->entityId,
32 |             'content_id' => $this->contentId
33 |         ]);
34 | 
35 |         $workflow = new VerificationWorkflow(VerificationWorkflow::WORKFLOW_SMS, $to, $from, $customKeys);
36 | 
37 |         $this->addWorkflow($workflow);
38 |     }
39 | 
40 |     public function toArray(): array
41 |     {
42 |         $return = $this->getBaseVerifyUniversalOutputArray();
43 | 
44 |         if (!is_null($this->getTemplateId())) {
45 |             $return['template_id'] = $this->getTemplateId();
46 |         }
47 | 
48 |         return $return;
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/src/Verify2/Request/SilentAuthRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\Request;
 4 | 
 5 | use InvalidArgumentException;
 6 | use Vonage\Verify2\VerifyObjects\VerificationWorkflow;
 7 | 
 8 | class SilentAuthRequest extends BaseVerifyRequest
 9 | {
10 |     public function __construct(
11 |         protected string $to,
12 |         protected string $brand,
13 |         protected ?string $redirectUrl = null
14 |     ) {
15 |         if (!self::isBrandValid($this->brand)) {
16 |             throw new InvalidArgumentException('The brand name cannot be longer than 16 characters.');
17 |         }
18 | 
19 |         $workflow = new VerificationWorkflow(VerificationWorkflow::WORKFLOW_SILENT_AUTH, $to);
20 | 
21 |         if ($this->redirectUrl) {
22 |             $workflow->setCustomKeys(['redirect_url' => $this->redirectUrl]);
23 |         }
24 | 
25 |         $this->addWorkflow($workflow);
26 |     }
27 | 
28 |     public function toArray(): array
29 |     {
30 |         return [
31 |             'brand' => $this->getBrand(),
32 |             'workflow' => $this->getWorkflows()
33 |         ];
34 |     }
35 | 
36 |     public static function isValidWorkflow(array $workflows): bool
37 |     {
38 |         $firstWorkflow = $workflows[0];
39 | 
40 |         if ($firstWorkflow['channel'] == VerificationWorkflow::WORKFLOW_SILENT_AUTH) {
41 |             return true;
42 |         }
43 | 
44 |         return false;
45 |     }
46 | }
47 | 


--------------------------------------------------------------------------------
/src/Verify2/Request/UpdateCustomTemplateRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\Request;
 4 | 
 5 | use InvalidArgumentException;
 6 | use Vonage\Verify2\VerifyObjects\VerificationLocale;
 7 | use Vonage\Verify2\VerifyObjects\VerificationWorkflow;
 8 | 
 9 | class UpdateCustomTemplateRequest extends BaseVerifyRequest
10 | {
11 |     public function __construct(
12 |         protected ?string $name = null,
13 |         protected ?bool $isDefault = null,
14 |     ) {
15 |     }
16 | 
17 |     public function getName(): ?string
18 |     {
19 |         return $this->name;
20 |     }
21 | 
22 |     public function setName(?string $name): UpdateCustomTemplateRequest
23 |     {
24 |         $this->name = $name;
25 |         return $this;
26 |     }
27 | 
28 |     public function getIsDefault(): ?bool
29 |     {
30 |         return $this->isDefault;
31 |     }
32 | 
33 |     public function setIsDefault(?bool $isDefault): UpdateCustomTemplateRequest
34 |     {
35 |         $this->isDefault = $isDefault;
36 |         return $this;
37 |     }
38 | 
39 |     public function toArray(): array
40 |     {
41 |         $return = [];
42 | 
43 |         if ($this->getName()) {
44 |             $return['name'] = $this->getName();
45 |         }
46 | 
47 |         if ($this->getIsDefault()) {
48 |             $return['is_default'] = $this->getIsDefault();
49 |         }
50 | 
51 |         return $return;
52 |     }
53 | }
54 | 


--------------------------------------------------------------------------------
/src/Verify2/Request/VoiceRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\Request;
 4 | 
 5 | use InvalidArgumentException;
 6 | use Vonage\Verify2\Traits\CustomTemplateTrait;
 7 | use Vonage\Verify2\VerifyObjects\VerificationLocale;
 8 | use Vonage\Verify2\VerifyObjects\VerificationWorkflow;
 9 | 
10 | class VoiceRequest extends BaseVerifyRequest
11 | {
12 |     use CustomTemplateTrait;
13 | 
14 |     public function __construct(
15 |         protected string $to,
16 |         protected string $brand,
17 |         protected ?VerificationLocale $locale = null,
18 |     ) {
19 |         if (!self::isBrandValid($this->brand)) {
20 |             throw new InvalidArgumentException('The brand name cannot be longer than 16 characters.');
21 |         }
22 | 
23 |         if (!$this->locale) {
24 |             $this->locale = new VerificationLocale();
25 |         }
26 | 
27 |         $workflow = new VerificationWorkflow(VerificationWorkflow::WORKFLOW_VOICE, $to);
28 | 
29 |         if ($this->code) {
30 |             $workflow->setCode($this->code);
31 |         }
32 | 
33 |         $this->addWorkflow($workflow);
34 |     }
35 | 
36 |     public function toArray(): array
37 |     {
38 |         return $this->getBaseVerifyUniversalOutputArray();
39 |     }
40 | }
41 | 


--------------------------------------------------------------------------------
/src/Verify2/Request/WhatsAppInteractiveRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\Request;
 4 | 
 5 | use InvalidArgumentException;
 6 | use Vonage\Verify2\VerifyObjects\VerificationLocale;
 7 | use Vonage\Verify2\VerifyObjects\VerificationWorkflow;
 8 | 
 9 | class WhatsAppInteractiveRequest extends BaseVerifyRequest
10 | {
11 |     public function __construct(
12 |         protected string $to,
13 |         protected string $brand,
14 |         protected ?VerificationLocale $locale = null
15 |     ) {
16 |         if (!self::isBrandValid($this->brand)) {
17 |             throw new InvalidArgumentException('The brand name cannot be longer than 16 characters.');
18 |         }
19 | 
20 |         if (!$this->locale) {
21 |             $this->locale = new VerificationLocale();
22 |         }
23 | 
24 |         $workflow = new VerificationWorkflow(VerificationWorkflow::WORKFLOW_WHATSAPP_INTERACTIVE, $to);
25 |         $this->addWorkflow($workflow);
26 |     }
27 | 
28 |     public function toArray(): array
29 |     {
30 |         return $this->getBaseVerifyUniversalOutputArray();
31 |     }
32 | }
33 | 


--------------------------------------------------------------------------------
/src/Verify2/Request/WhatsAppRequest.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\Request;
 4 | 
 5 | use InvalidArgumentException;
 6 | use Vonage\Verify2\VerifyObjects\VerificationLocale;
 7 | use Vonage\Verify2\VerifyObjects\VerificationWorkflow;
 8 | 
 9 | class WhatsAppRequest extends BaseVerifyRequest
10 | {
11 |     public function __construct(
12 |         protected string $to,
13 |         protected string $brand,
14 |         protected string $from,
15 |         protected ?VerificationLocale $locale = null,
16 |     ) {
17 |         if (!self::isBrandValid($this->brand)) {
18 |             throw new InvalidArgumentException('The brand name cannot be longer than 16 characters.');
19 |         }
20 | 
21 |         if (!$this->locale) {
22 |             $this->locale = new VerificationLocale();
23 |         }
24 | 
25 |         $workflow = new VerificationWorkflow(VerificationWorkflow::WORKFLOW_WHATSAPP, $to, $from);
26 | 
27 |         $this->addWorkflow($workflow);
28 |     }
29 | 
30 |     public function toArray(): array
31 |     {
32 |         return $this->getBaseVerifyUniversalOutputArray();
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Verify2/Traits/CustomTemplateTrait.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\Traits;
 4 | 
 5 | trait CustomTemplateTrait
 6 | {
 7 |     protected ?string $templateId = null;
 8 | 
 9 |     public function getTemplateId(): ?string
10 |     {
11 |         return $this->templateId;
12 |     }
13 | 
14 |     public function setTemplateId(string $templateId): string
15 |     {
16 |         return $this->templateId = $templateId;
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/Verify2/VerifyObjects/Template.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\VerifyObjects;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class Template implements ArrayHydrateInterface
 8 | {
 9 |     public function __construct(private ?array $data = null)
10 |     {
11 |     }
12 | 
13 |     public function __get($property)
14 |     {
15 |         return $this->data[$property] ?? null;
16 |     }
17 | 
18 |     public function __set($property, $value)
19 |     {
20 |         $this->data[$property] = $value;
21 | 
22 |         return $this;
23 |     }
24 | 
25 |     public function __isset(string $name): bool
26 |     {
27 |         return isset($this->data[$name]);
28 |     }
29 | 
30 |     public function fromArray(array $data): static
31 |     {
32 |         $this->data = $data;
33 | 
34 |         return $this;
35 |     }
36 | 
37 |     public function toArray(): array
38 |     {
39 |         return $this->data;
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Verify2/VerifyObjects/TemplateFragment.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\VerifyObjects;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class TemplateFragment implements ArrayHydrateInterface
 8 | {
 9 |     public function __construct(private ?array $data = null)
10 |     {
11 |     }
12 | 
13 |     public function __get($property)
14 |     {
15 |         return $this->data[$property] ?? null;
16 |     }
17 | 
18 |     public function __set($property, $value)
19 |     {
20 |         $this->data[$property] = $value;
21 | 
22 |         return $this;
23 |     }
24 | 
25 |     public function __isset(string $name): bool
26 |     {
27 |         return isset($this->data[$name]);
28 |     }
29 | 
30 |     public function fromArray(array $data): static
31 |     {
32 |         $this->data = $data;
33 | 
34 |         return $this;
35 |     }
36 | 
37 |     public function toArray(): array
38 |     {
39 |         return $this->data;
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Verify2/VerifyObjects/VerificationLocale.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\VerifyObjects;
 4 | 
 5 | class VerificationLocale
 6 | {
 7 |     public function __construct(protected string $code = 'en-us')
 8 |     {
 9 |     }
10 | 
11 |     public function getCode(): string
12 |     {
13 |         return $this->code;
14 |     }
15 | 
16 |     public function setCode(string $code): static
17 |     {
18 |         $this->code = $code;
19 | 
20 |         return $this;
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/src/Verify2/VerifyObjects/VerifyEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\VerifyObjects;
 4 | 
 5 | class VerifyEvent
 6 | {
 7 |     public function __construct(private array $data)
 8 |     {
 9 |     }
10 | 
11 |     public function __get($property)
12 |     {
13 |         return $this->data[$property] ?? null;
14 |     }
15 | 
16 |     public function __set($property, $value)
17 |     {
18 |         $this->data[$property] = $value;
19 | 
20 |         return $this;
21 |     }
22 | 
23 |     public function __isset(string $name): bool
24 |     {
25 |         return isset($this->data[$name]);
26 |     }
27 | 
28 |     public function fromArray(array $data): static
29 |     {
30 |         $this->data = $data;
31 | 
32 |         return $this;
33 |     }
34 | 
35 |     public function toArray(): array
36 |     {
37 |         return $this->data;
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/src/Verify2/VerifyObjects/VerifySilentAuthEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\VerifyObjects;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class VerifySilentAuthEvent implements ArrayHydrateInterface
 8 | {
 9 |     public function __construct(private array $data)
10 |     {
11 |     }
12 | 
13 |     public function __get($property)
14 |     {
15 |         return $this->data[$property] ?? null;
16 |     }
17 | 
18 |     public function __set($property, $value)
19 |     {
20 |         $this->data[$property] = $value;
21 | 
22 |         return $this;
23 |     }
24 | 
25 |     public function __isset(string $name): bool
26 |     {
27 |         return isset($this->data[$name]);
28 |     }
29 | 
30 |     public function fromArray(array $data): static
31 |     {
32 |         $this->data = $data;
33 | 
34 |         return $this;
35 |     }
36 | 
37 |     public function toArray(): array
38 |     {
39 |         return $this->data;
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Verify2/VerifyObjects/VerifyStatusUpdate.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\VerifyObjects;
 4 | 
 5 | class VerifyStatusUpdate
 6 | {
 7 |     public function __construct(private array $data)
 8 |     {
 9 |     }
10 | 
11 |     public function __get($property)
12 |     {
13 |         return $this->data[$property] ?? null;
14 |     }
15 | 
16 |     public function __set($property, $value)
17 |     {
18 |         $this->data[$property] = $value;
19 | 
20 |         return $this;
21 |     }
22 | 
23 |     public function __isset(string $name): bool
24 |     {
25 |         return isset($this->data[$name]);
26 |     }
27 | 
28 |     public function fromArray(array $data): static
29 |     {
30 |         $this->data = $data;
31 | 
32 |         return $this;
33 |     }
34 | 
35 |     public function toArray(): array
36 |     {
37 |         return $this->data;
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/src/Verify2/VerifyObjects/VerifyWhatsAppInteractiveEvent.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\VerifyObjects;
 4 | 
 5 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 6 | 
 7 | class VerifyWhatsAppInteractiveEvent implements ArrayHydrateInterface
 8 | {
 9 |     public function __construct(private array $data)
10 |     {
11 |     }
12 | 
13 |     public function __get($property)
14 |     {
15 |         return $this->data[$property] ?? null;
16 |     }
17 | 
18 |     public function __set($property, $value)
19 |     {
20 |         $this->data[$property] = $value;
21 | 
22 |         return $this;
23 |     }
24 | 
25 |     public function __isset(string $name): bool
26 |     {
27 |         return isset($this->data[$name]);
28 |     }
29 | 
30 |     public function fromArray(array $data): static
31 |     {
32 |         $this->data = $data;
33 | 
34 |         return $this;
35 |     }
36 | 
37 |     public function toArray(): array
38 |     {
39 |         return $this->data;
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Verify2/Webhook/Factory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace Vonage\Verify2\Webhook;
 4 | 
 5 | use Vonage\Verify2\VerifyObjects\VerifyEvent;
 6 | use Vonage\Verify2\VerifyObjects\VerifySilentAuthEvent;
 7 | use Vonage\Verify2\VerifyObjects\VerifyStatusUpdate;
 8 | use Vonage\Verify2\VerifyObjects\VerifyWhatsAppInteractiveEvent;
 9 | 
10 | class Factory extends \Vonage\Webhook\Factory
11 | {
12 |     /**
13 |      * Warning: This logic is fairly brittle, since there are no current better ways of determining
14 |      * the type of event or update.
15 |      */
16 |     public static function createFromArray(array $data)
17 |     {
18 |         if ($data['type'] === 'event') {
19 |             if ($data['channel'] === 'silent_auth') {
20 |                 return new VerifySilentAuthEvent($data);
21 |             }
22 |             if ($data['channel'] === 'whatsapp_interactive') {
23 |                 return new VerifyWhatsAppInteractiveEvent($data);
24 |             }
25 |             return new VerifyEvent($data);
26 |         }
27 | 
28 |         if ($data['type'] === 'summary') {
29 |             return new VerifyStatusUpdate($data);
30 |         }
31 | 
32 |         throw new \OutOfBoundsException('Could not create Verify2 Object from payload');
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/src/Voice/Call/Inbound.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\Call;
 6 | 
 7 | /**
 8 |  * @deprecated This objects are no longer viable and will be removed in a future version
 9 |  */
10 | class Inbound
11 | {
12 | }
13 | 


--------------------------------------------------------------------------------
/src/Voice/CallAction.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice;
 6 | 
 7 | /**
 8 |  * Collection of actions that can be used to modify a call
 9 |  */
10 | class CallAction
11 | {
12 |     public const EARMUFF = 'earmuff';
13 |     public const HANGUP = 'hangup';
14 |     public const MUTE = 'mute';
15 |     public const UNEARMUFF = 'unearmuff';
16 |     public const UNMUTE = 'unmute';
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Voice/CallFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice;
 6 | 
 7 | use Exception;
 8 | use Vonage\Entity\Factory\FactoryInterface;
 9 | 
10 | class CallFactory implements FactoryInterface
11 | {
12 |     /**
13 |      * @throws Exception
14 |      */
15 |     public function create(array $data): Call
16 |     {
17 |         return new Call($data);
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/src/Voice/ClientFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice;
 6 | 
 7 | use Psr\Container\ContainerInterface;
 8 | use Vonage\Client\APIResource;
 9 | use Vonage\Client\Credentials\Handler\KeypairHandler;
10 | 
11 | class ClientFactory
12 | {
13 |     public function __invoke(ContainerInterface $container): Client
14 |     {
15 |         /** @var APIResource $api */
16 |         $api = $container->make(APIResource::class);
17 |         $api
18 |             ->setBaseUri('/v1/calls')
19 |             ->setAuthHandlers(new KeypairHandler())
20 |             ->setCollectionName('calls');
21 | 
22 |         return new Client($api);
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/src/Voice/Endpoint/App.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\Endpoint;
 6 | 
 7 | class App implements EndpointInterface
 8 | {
 9 |     public function __construct(protected string $id)
10 |     {
11 |     }
12 | 
13 |     public static function factory(string $user): App
14 |     {
15 |         return new App($user);
16 |     }
17 | 
18 |     /**
19 |      * @return array{type: string, user: string}
20 |      */
21 |     public function jsonSerialize(): array
22 |     {
23 |         return $this->toArray();
24 |     }
25 | 
26 |     /**
27 |      * @return array{type: string, user: string}
28 |      */
29 |     public function toArray(): array
30 |     {
31 |         return [
32 |             'type' => 'app',
33 |             'user' => $this->id,
34 |         ];
35 |     }
36 | 
37 |     public function getId(): string
38 |     {
39 |         return $this->id;
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Voice/Endpoint/EndpointFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\Endpoint;
 6 | 
 7 | use RuntimeException;
 8 | use Vonage\Entity\Factory\FactoryInterface;
 9 | 
10 | class EndpointFactory implements FactoryInterface
11 | {
12 |     public function create(array $data): ?EndpointInterface
13 |     {
14 |         return match ($data['type']) {
15 |             'app' => App::factory($data['user']),
16 |             'phone' => Phone::factory($data['number'], $data),
17 |             'sip' => SIP::factory($data['uri'], $data),
18 |             'vbc' => VBC::factory($data['extension']),
19 |             'websocket' => Websocket::factory($data['uri'], $data),
20 |             default => throw new RuntimeException('Unknown endpoint type'),
21 |         };
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/src/Voice/Endpoint/EndpointInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\Endpoint;
 6 | 
 7 | use JsonSerializable;
 8 | 
 9 | interface EndpointInterface extends JsonSerializable
10 | {
11 |     public function getId(): string;
12 | 
13 |     /**
14 |      * @return array<string, array>
15 |      */
16 |     public function toArray(): array;
17 | }
18 | 


--------------------------------------------------------------------------------
/src/Voice/Endpoint/SIP.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\Endpoint;
 6 | 
 7 | class SIP implements EndpointInterface
 8 | {
 9 |     /**
10 |      * @var array<string, string>
11 |      */
12 |     protected array $headers = [];
13 | 
14 |     public function __construct(protected string $id, array $headers = [])
15 |     {
16 |         $this->setHeaders($headers);
17 |     }
18 | 
19 |     public static function factory(string $uri, array $headers = []): SIP
20 |     {
21 |         return new SIP($uri, $headers);
22 |     }
23 | 
24 |     /**
25 |      * @return array{type: string, uri: string, headers?: array<string, string>}
26 |      */
27 |     public function jsonSerialize(): array
28 |     {
29 |         return $this->toArray();
30 |     }
31 | 
32 |     /**
33 |      * @return array{type: string, uri: string, headers?: array<string, string>}
34 |      */
35 |     public function toArray(): array
36 |     {
37 |         $data = [
38 |             'type' => 'sip',
39 |             'uri' => $this->id,
40 |         ];
41 | 
42 |         if (!empty($this->getHeaders())) {
43 |             $data['headers'] = $this->getHeaders();
44 |         }
45 | 
46 |         return $data;
47 |     }
48 | 
49 |     public function getId(): string
50 |     {
51 |         return $this->id;
52 |     }
53 | 
54 |     public function getHeaders(): array
55 |     {
56 |         return $this->headers;
57 |     }
58 | 
59 |     /**
60 |      * @return $this
61 |      */
62 |     public function addHeader(string $key, string $value): self
63 |     {
64 |         $this->headers[$key] = $value;
65 | 
66 |         return $this;
67 |     }
68 | 
69 |     /**
70 |      * @return $this
71 |      */
72 |     public function setHeaders(array $headers): self
73 |     {
74 |         $this->headers = $headers;
75 | 
76 |         return $this;
77 |     }
78 | }
79 | 


--------------------------------------------------------------------------------
/src/Voice/Endpoint/VBC.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\Endpoint;
 6 | 
 7 | class VBC implements EndpointInterface
 8 | {
 9 |     public function __construct(protected string $id)
10 |     {
11 |     }
12 | 
13 |     public static function factory(string $extension): VBC
14 |     {
15 |         return new VBC($extension);
16 |     }
17 | 
18 |     /**
19 |      * @return array{type: string, user: string}
20 |      */
21 |     public function jsonSerialize(): array
22 |     {
23 |         return $this->toArray();
24 |     }
25 | 
26 |     /**
27 |      * @return array{type: string, user: string}
28 |      */
29 |     public function toArray(): array
30 |     {
31 |         return [
32 |             'type' => 'vbc',
33 |             'extension' => $this->id,
34 |         ];
35 |     }
36 | 
37 |     public function getId(): string
38 |     {
39 |         return $this->id;
40 |     }
41 | }
42 | 


--------------------------------------------------------------------------------
/src/Voice/NCCO/Action/ActionInterface.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\NCCO\Action;
 6 | 
 7 | use JsonSerializable;
 8 | 
 9 | interface ActionInterface extends JsonSerializable
10 | {
11 |     /**
12 |      * @return array<string, string>
13 |      */
14 |     public function toNCCOArray(): array;
15 | }
16 | 


--------------------------------------------------------------------------------
/src/Voice/NCCO/NCCO.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\NCCO;
 6 | 
 7 | use JsonSerializable;
 8 | use Vonage\Entity\Hydrator\ArrayHydrateInterface;
 9 | use Vonage\Voice\NCCO\Action\ActionInterface;
10 | 
11 | class NCCO implements ArrayHydrateInterface, JsonSerializable
12 | {
13 |     /**
14 |      * @var array<ActionInterface>
15 |      */
16 |     protected array $actions = [];
17 | 
18 |     public function addAction(ActionInterface $action): self
19 |     {
20 |         $this->actions[] = $action;
21 |         return $this;
22 |     }
23 | 
24 |     public function fromArray(array $data): void
25 |     {
26 |         $factory = new NCCOFactory();
27 | 
28 |         foreach ($data as $rawNCCO) {
29 |             $action = $factory->build($rawNCCO);
30 |             $this->addAction($action);
31 |         }
32 |     }
33 | 
34 |     /**
35 |      * @return array<array<string, string>>
36 |      */
37 |     public function jsonSerialize(): array
38 |     {
39 |         return $this->toArray();
40 |     }
41 | 
42 |     /**
43 |      * @return array<array<string, string>>
44 |      */
45 |     public function toArray(): array
46 |     {
47 |         $data = [];
48 | 
49 |         foreach ($this->actions as $action) {
50 |             $data[] = $action->toNCCOArray();
51 |         }
52 | 
53 |         return $data;
54 |     }
55 | }
56 | 


--------------------------------------------------------------------------------
/src/Voice/NCCO/NCCOFactory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\NCCO;
 6 | 
 7 | use InvalidArgumentException;
 8 | use Vonage\Voice\Endpoint\EndpointFactory;
 9 | use Vonage\Voice\NCCO\Action\ActionInterface;
10 | use Vonage\Voice\NCCO\Action\Connect;
11 | use Vonage\Voice\NCCO\Action\Conversation;
12 | use Vonage\Voice\NCCO\Action\Input;
13 | use Vonage\Voice\NCCO\Action\Notify;
14 | use Vonage\Voice\NCCO\Action\Record;
15 | use Vonage\Voice\NCCO\Action\Stream;
16 | use Vonage\Voice\NCCO\Action\Talk;
17 | 
18 | class NCCOFactory
19 | {
20 |     public function build(array $data): ActionInterface
21 |     {
22 |         switch ($data['action']) {
23 |             case 'connect':
24 |                 $factory = new EndpointFactory();
25 |                 $endpoint = $factory->create($data['endpoint'][0]);
26 | 
27 |                 if (null !== $endpoint) {
28 |                     return Connect::factory($endpoint);
29 |                 }
30 | 
31 |                 throw new InvalidArgumentException("Malformed NCCO Action " . $data['endpoint'][0]);
32 |             case 'conversation':
33 |                 return Conversation::factory($data['name'], $data);
34 |             case 'input':
35 |                 return Input::factory($data);
36 |             case 'notify':
37 |                 return Notify::factory($data['payload'], $data);
38 |             case 'record':
39 |                 return Record::factory($data);
40 |             case 'stream':
41 |                 return Stream::factory($data['streamUrl'], $data);
42 |             case 'talk':
43 |                 return Talk::factory($data['text'], $data);
44 |             default:
45 |                 throw new InvalidArgumentException("Unknown NCCO Action " . $data['action']);
46 |         }
47 |     }
48 | }
49 | 


--------------------------------------------------------------------------------
/src/Voice/Webhook.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice;
 6 | 
 7 | class Webhook
 8 | {
 9 |     public const METHOD_GET = 'GET';
10 |     public const METHOD_POST = 'POST';
11 | 
12 |     public function __construct(protected string $url, protected string $method = self::METHOD_POST)
13 |     {
14 |     }
15 | 
16 |     public function getMethod(): string
17 |     {
18 |         return $this->method;
19 |     }
20 | 
21 |     public function getUrl(): string
22 |     {
23 |         return $this->url;
24 |     }
25 | }
26 | 


--------------------------------------------------------------------------------
/src/Voice/Webhook/Answer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\Webhook;
 6 | 
 7 | class Answer
 8 | {
 9 |     protected ?string $conversationUuid = null;
10 | 
11 |     protected ?string $from = null;
12 | 
13 |     protected ?string $to = null;
14 | 
15 |     protected ?string $uuid = null;
16 | 
17 |     public function __construct(array $event)
18 |     {
19 |         $this->from = $event['from'];
20 |         $this->to = $event['to'];
21 |         $this->uuid = $event['uuid'] ?? $event['call_uuid'];
22 |         $this->conversationUuid = $event['conversation_uuid'];
23 |     }
24 | 
25 |     public function getConversationUuid(): string
26 |     {
27 |         return $this->conversationUuid;
28 |     }
29 | 
30 |     public function getFrom(): string
31 |     {
32 |         return $this->from;
33 |     }
34 | 
35 |     public function getTo(): string
36 |     {
37 |         return $this->to;
38 |     }
39 | 
40 |     public function getUuid(): string
41 |     {
42 |         return $this->uuid;
43 |     }
44 | }
45 | 


--------------------------------------------------------------------------------
/src/Voice/Webhook/Error.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\Webhook;
 6 | 
 7 | use DateTimeImmutable;
 8 | use Exception;
 9 | 
10 | class Error
11 | {
12 |     protected ?string $conversationUuid = null;
13 | 
14 |     protected ?string $reason = null;
15 | 
16 |     protected ?DateTimeImmutable $timestamp = null;
17 | 
18 |     /**
19 |      * @throws Exception
20 |      */
21 |     public function __construct(array $event)
22 |     {
23 |         $this->conversationUuid = $event['conversation_uuid'];
24 |         $this->reason = $event['reason'];
25 |         $this->timestamp = new DateTimeImmutable($event['timestamp']);
26 |     }
27 | 
28 |     public function getConversationUuid(): string
29 |     {
30 |         return $this->conversationUuid;
31 |     }
32 | 
33 |     public function getReason(): string
34 |     {
35 |         return $this->reason;
36 |     }
37 | 
38 |     public function getTimestamp(): DateTimeImmutable
39 |     {
40 |         return $this->timestamp;
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/src/Voice/Webhook/Factory.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\Webhook;
 6 | 
 7 | use Exception;
 8 | use InvalidArgumentException;
 9 | use Vonage\Webhook\Factory as WebhookFactory;
10 | 
11 | use function array_diff;
12 | use function array_key_exists;
13 | use function array_keys;
14 | use function count;
15 | 
16 | class Factory extends WebhookFactory
17 | {
18 |     /**
19 |      * @throws Exception
20 |      *
21 |      * @return mixed|Answer|Error|Event|Input|Notification|Record|Transfer
22 |      */
23 |     public static function createFromArray(array $data): mixed
24 |     {
25 |         if (array_key_exists('status', $data)) {
26 |             return new Event($data);
27 |         }
28 | 
29 |         // Answer webhooks have no defining type other than length and keys
30 |         if (count($data) === 4 && array_diff(array_keys($data), ['to', 'from', 'uuid', 'conversation_uuid']) === []) {
31 |             return new Answer($data);
32 |         }
33 | 
34 |         if (array_key_exists('type', $data) && $data['type'] === 'transfer') {
35 |             return new Transfer($data);
36 |         }
37 | 
38 |         if (array_key_exists('recording_url', $data)) {
39 |             return new Record($data);
40 |         }
41 | 
42 |         if (array_key_exists('reason', $data)) {
43 |             return new Error($data);
44 |         }
45 | 
46 |         if (array_key_exists('payload', $data)) {
47 |             return new Notification($data);
48 |         }
49 | 
50 |         if (array_key_exists('speech', $data) || array_key_exists('dtmf', $data)) {
51 |             return new Input($data);
52 |         }
53 | 
54 |         throw new InvalidArgumentException('Unable to detect incoming webhook type');
55 |     }
56 | }
57 | 


--------------------------------------------------------------------------------
/src/Voice/Webhook/Input.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\Webhook;
 6 | 
 7 | use DateTimeImmutable;
 8 | use Exception;
 9 | 
10 | use function is_string;
11 | use function json_decode;
12 | 
13 | class Input
14 | {
15 |     protected ?array $speech = null;
16 | 
17 |     protected ?array $dtmf = null;
18 | 
19 |     protected ?string $from = null;
20 | 
21 |     protected ?string $to = null;
22 | 
23 |     protected ?string $uuid = null;
24 | 
25 |     protected ?string $conversationUuid = null;
26 | 
27 |     protected ?DateTimeImmutable $timestamp = null;
28 | 
29 |     /**
30 |      * @throws Exception
31 |      */
32 |     public function __construct(array $data)
33 |     {
34 |         // GET requests push this in as a string
35 |         if (is_string($data['speech'])) {
36 |             $data['speech'] = json_decode($data['speech'], true);
37 |         }
38 | 
39 |         $this->speech = $data['speech'];
40 | 
41 |         // GET requests push this in as a string
42 |         if (is_string($data['dtmf'])) {
43 |             $data['dtmf'] = json_decode($data['dtmf'], true);
44 |         }
45 | 
46 |         $this->dtmf = $data['dtmf'];
47 |         $this->to = $data['to'];
48 |         $this->from = $data['from'];
49 |         $this->uuid = $data['uuid'];
50 |         $this->conversationUuid = $data['conversation_uuid'];
51 |         $this->timestamp = new DateTimeImmutable($data['timestamp']);
52 |     }
53 | 
54 |     public function getSpeech(): array
55 |     {
56 |         return $this->speech;
57 |     }
58 | 
59 |     public function getDtmf(): array
60 |     {
61 |         return $this->dtmf;
62 |     }
63 | 
64 |     public function getFrom(): string
65 |     {
66 |         return $this->from;
67 |     }
68 | 
69 |     public function getTo(): string
70 |     {
71 |         return $this->to;
72 |     }
73 | 
74 |     public function getUuid(): string
75 |     {
76 |         return $this->uuid;
77 |     }
78 | 
79 |     public function getConversationUuid(): string
80 |     {
81 |         return $this->conversationUuid;
82 |     }
83 | 
84 |     public function getTimestamp(): DateTimeImmutable
85 |     {
86 |         return $this->timestamp;
87 |     }
88 | }
89 | 


--------------------------------------------------------------------------------
/src/Voice/Webhook/Notification.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\Webhook;
 6 | 
 7 | use DateTimeImmutable;
 8 | use Exception;
 9 | 
10 | use function is_string;
11 | use function json_decode;
12 | 
13 | class Notification
14 | {
15 |     /**
16 |      * @var array<string, mixed>
17 |      */
18 |     protected ?array $payload = null;
19 | 
20 |     protected ?string $conversationUuid = null;
21 | 
22 |     protected ?DateTimeImmutable $timestamp = null;
23 | 
24 |     /**
25 |      * @throws Exception
26 |      */
27 |     public function __construct(array $data)
28 |     {
29 |         if (is_string($data['payload'])) {
30 |             $data['payload'] = json_decode($data['payload'], true);
31 |         }
32 | 
33 |         $this->payload = $data['payload'];
34 |         $this->conversationUuid = $data['conversation_uuid'];
35 |         $this->timestamp = new DateTimeImmutable($data['timestamp']);
36 |     }
37 | 
38 |     public function getPayload(): array
39 |     {
40 |         return $this->payload;
41 |     }
42 | 
43 |     public function getConversationUuid(): string
44 |     {
45 |         return $this->conversationUuid;
46 |     }
47 | 
48 |     public function getTimestamp(): DateTimeImmutable
49 |     {
50 |         return $this->timestamp;
51 |     }
52 | }
53 | 


--------------------------------------------------------------------------------
/src/Voice/Webhook/Record.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\Webhook;
 6 | 
 7 | use DateTimeImmutable;
 8 | use Exception;
 9 | 
10 | class Record
11 | {
12 |     protected ?DateTimeImmutable $startTime = null;
13 | 
14 |     protected ?string $recordingUrl = null;
15 | 
16 |     protected ?int $size = null;
17 | 
18 |     protected ?string $recordingUuid = null;
19 | 
20 |     protected ?DateTimeImmutable $endTime = null;
21 | 
22 |     protected ?string $conversationUuid = null;
23 | 
24 |     protected ?DateTimeImmutable $timestamp = null;
25 | 
26 |     /**
27 |      * @throws Exception
28 |      */
29 |     public function __construct(array $event)
30 |     {
31 |         $this->startTime = new DateTimeImmutable($event['start_time']);
32 |         $this->endTime = new DateTimeImmutable($event['end_time']);
33 |         $this->timestamp = new DateTimeImmutable($event['timestamp']);
34 |         $this->recordingUrl = $event['recording_url'];
35 |         $this->recordingUuid = $event['recording_uuid'];
36 |         $this->conversationUuid = $event['conversation_uuid'];
37 |         $this->size = (int)$event['size'];
38 |     }
39 | 
40 |     public function getStartTime(): DateTimeImmutable
41 |     {
42 |         return $this->startTime;
43 |     }
44 | 
45 |     public function getRecordingUrl(): string
46 |     {
47 |         return $this->recordingUrl;
48 |     }
49 | 
50 |     public function getSize(): int
51 |     {
52 |         return $this->size;
53 |     }
54 | 
55 |     public function getRecordingUuid(): string
56 |     {
57 |         return $this->recordingUuid;
58 |     }
59 | 
60 |     public function getEndTime(): DateTimeImmutable
61 |     {
62 |         return $this->endTime;
63 |     }
64 | 
65 |     public function getConversationUuid(): string
66 |     {
67 |         return $this->conversationUuid;
68 |     }
69 | 
70 |     public function getTimestamp(): DateTimeImmutable
71 |     {
72 |         return $this->timestamp;
73 |     }
74 | }
75 | 


--------------------------------------------------------------------------------
/src/Voice/Webhook/Transfer.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | declare(strict_types=1);
 4 | 
 5 | namespace Vonage\Voice\Webhook;
 6 | 
 7 | use DateTimeImmutable;
 8 | use Exception;
 9 | 
10 | class Transfer
11 | {
12 |     protected ?string $conversationUuidFrom = null;
13 | 
14 |     protected ?string $conversationUuidTo = null;
15 | 
16 |     protected ?string $uuid = null;
17 | 
18 |     protected ?DateTimeImmutable $timestamp = null;
19 | 
20 |     /**
21 |      * @throws Exception
22 |      */
23 |     public function __construct(array $event)
24 |     {
25 |         $this->conversationUuidFrom = $event['conversation_uuid_from'];
26 |         $this->conversationUuidTo = $event['conversation_uuid_to'];
27 |         $this->uuid = $event['uuid'];
28 |         $this->timestamp = new DateTimeImmutable($event['timestamp']);
29 |     }
30 | 
31 |     public function getConversationUuidFrom(): string
32 |     {
33 |         return $this->conversationUuidFrom;
34 |     }
35 | 
36 |     public function getConversationUuidTo(): string
37 |     {
38 |         return $this->conversationUuidTo;
39 |     }
40 | 
41 |     public function getUuid(): string
42 |     {
43 |         return $this->uuid;
44 |     }
45 | 
46 |     public function getTimestamp(): DateTimeImmutable
47 |     {
48 |         return $this->timestamp;
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------