Merge branch 'main' into PHP8.4Take2

Author: tiwarishubham635

CHANGES.md

@@ -1,6 +1,78 @@
 twilio-php Changelog
 ====================
 
+[2025-03-20] Version 8.4.1
+--------------------------
+**Library - Chore**
+- [PR #851](https://github.com/twilio/twilio-php/pull/851): fix seralization. Thanks to [@manisha1997](https://github.com/manisha1997)!
+
+**Accounts**
+- Update Safelist API docs as part of prefix supoort
+
+**Flex**
+- Removing `first_name`, `last_name`, and `friendly_name` from the Flex User API
+
+**Messaging**
+- Add missing tests under transaction/phone_numbers and transaction/short_code
+
+
+[2025-03-11] Version 8.4.0
+--------------------------
+**Api**
+- Add the missing `emergency_enabled` field for `Address Service` endpoints
+
+**Messaging**
+- Add missing enums for A2P and TF
+
+**Numbers**
+- add missing enum values to hosted_number_order_status
+
+**Twiml**
+- Convert Twiml Attribute `speechModel` of type enum to string **(breaking change)**
+
+
+[2025-02-20] Version 8.3.15
+---------------------------
+**Flex**
+- Adding Digital Transfers APIs under v1/Interactions
+
+**Numbers**
+- Convert webhook_type to ienum type in v1/Porting/Configuration/Webhook/{webhook_type}
+
+**Trusthub**
+- Changing TrustHub SupportingDocument status enum from lowercase to uppercase since kyc-orch returns status capitalized and rest proxy requires strict casing
+
+
+[2025-02-11] Version 8.3.14
+---------------------------
+**Api**
+- Change downstream url and change media type for file `base/api/v2010/validation_request.json`.
+
+**Intelligence**
+- Add json_results for Generative JSON operator results
+
+**Messaging**
+- Add DestinationAlphaSender API to support Country-Specific Alpha Senders
+
+**Video**
+- Change codec type from enum to case-insensitive enum in recording and room_recording apis
+
+
+[2025-01-28] Version 8.3.13
+---------------------------
+**Api**
+- Add open-api file tag to `conference/call recordings` and `recording_transcriptions`.
+
+**Events**
+- Add support for subaccount subscriptions (beta)
+
+**Insights**
+- add new region to conference APIs
+
+**Lookups**
+- Add new `parnter_sub_id` query parameter to the lookup request
+
+
 [2025-01-13] Version 8.3.12
 ---------------------------
 **Library - Chore**

src/Twilio/Rest/Accounts/V1/BulkConsentsList.php

@@ -45,7 +45,7 @@ public function __construct(
     /**
      * Create the BulkConsentsInstance
      *
-     * @param array[] $items This is a list of objects that describes a contact's opt-in status. Each object contains the following fields: `contact_id`, which must be a string representing phone number in [E.164 format](https://www.twilio.com/docs/glossary/what-e164); `correlation_id`, a unique 32-character UUID used to uniquely map the request item with the response item; `sender_id`, which can be either a valid messaging service SID or a from phone number; `status`, a string representing the consent status. Can be one of [`opt-in`, `opt-out`]; and `source`, a string indicating the medium through which the consent was collected. Can be one of [`website`, `offline`, `opt-in-message`, `opt-out-message`, `others`].
+     * @param object[] $items This is a list of objects that describes a contact's opt-in status. Each object contains the following fields: `contact_id`, which must be a string representing phone number in [E.164 format](https://www.twilio.com/docs/glossary/what-e164); `correlation_id`, a unique 32-character UUID used to uniquely map the request item with the response item; `sender_id`, which can be either a valid messaging service SID or a from phone number; `status`, a string representing the consent status. Can be one of [`opt-in`, `opt-out`]; and `source`, a string indicating the medium through which the consent was collected. Can be one of [`website`, `offline`, `opt-in-message`, `opt-out-message`, `others`].
      * @return BulkConsentsInstance Created BulkConsentsInstance
      * @throws TwilioException When an HTTP error occurs.
      */

src/Twilio/Rest/Accounts/V1/BulkContactsList.php

@@ -45,7 +45,7 @@ public function __construct(
     /**
      * Create the BulkContactsInstance
      *
-     * @param array[] $items A list of objects where each object represents a contact's details. Each object includes the following fields: `contact_id`, which must be a string representing phone number in [E.164 format](https://www.twilio.com/docs/glossary/what-e164); `correlation_id`, a unique 32-character UUID that maps the response to the original request; `country_iso_code`, a string representing the country using the ISO format (e.g., US for the United States); and `zip_code`, a string representing the postal code.
+     * @param object[] $items A list of objects where each object represents a contact's details. Each object includes the following fields: `contact_id`, which must be a string representing phone number in [E.164 format](https://www.twilio.com/docs/glossary/what-e164); `correlation_id`, a unique 32-character UUID that maps the response to the original request; `country_iso_code`, a string representing the country using the ISO format (e.g., US for the United States); and `zip_code`, a string representing the postal code.
      * @return BulkContactsInstance Created BulkContactsInstance
      * @throws TwilioException When an HTTP error occurs.
      */

src/Twilio/Rest/Accounts/V1/SafelistList.php

@@ -45,7 +45,7 @@ public function __construct(
     /**
      * Create the SafelistInstance
      *
-     * @param string $phoneNumber The phone number to be added in SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+     * @param string $phoneNumber The phone number or phone number 1k prefix to be added in SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
      * @return SafelistInstance Created SafelistInstance
      * @throws TwilioException When an HTTP error occurs.
      */

src/Twilio/Rest/Accounts/V1/SafelistOptions.php

@@ -22,7 +22,7 @@ abstract class SafelistOptions
 {
 
     /**
-     * @param string $phoneNumber The phone number to be removed from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+     * @param string $phoneNumber The phone number or phone number 1k prefix to be removed from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
      * @return DeleteSafelistOptions Options builder
      */
     public static function delete(
@@ -37,7 +37,7 @@ public static function delete(
     }
 
     /**
-     * @param string $phoneNumber The phone number to be fetched from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+     * @param string $phoneNumber The phone number or phone number 1k prefix to be fetched from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
      * @return FetchSafelistOptions Options builder
      */
     public static function fetch(
@@ -57,7 +57,7 @@ public static function fetch(
 class DeleteSafelistOptions extends Options
     {
     /**
-     * @param string $phoneNumber The phone number to be removed from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+     * @param string $phoneNumber The phone number or phone number 1k prefix to be removed from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
      */
     public function __construct(
 
@@ -68,9 +68,9 @@ public function __construct(
     }
 
     /**
-     * The phone number to be removed from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+     * The phone number or phone number 1k prefix to be removed from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
      *
-     * @param string $phoneNumber The phone number to be removed from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+     * @param string $phoneNumber The phone number or phone number 1k prefix to be removed from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
      * @return $this Fluent Builder
      */
     public function setPhoneNumber(string $phoneNumber): self
@@ -94,7 +94,7 @@ public function __toString(): string
 class FetchSafelistOptions extends Options
     {
     /**
-     * @param string $phoneNumber The phone number to be fetched from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+     * @param string $phoneNumber The phone number or phone number 1k prefix to be fetched from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
      */
     public function __construct(
 
@@ -105,9 +105,9 @@ public function __construct(
     }
 
     /**
-     * The phone number to be fetched from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+     * The phone number or phone number 1k prefix to be fetched from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
      *
-     * @param string $phoneNumber The phone number to be fetched from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
+     * @param string $phoneNumber The phone number or phone number 1k prefix to be fetched from SafeList. Phone numbers must be in [E.164 format](https://www.twilio.com/docs/glossary/what-e164).
      * @return $this Fluent Builder
      */
     public function setPhoneNumber(string $phoneNumber): self

src/Twilio/Rest/Api/V2010/Account/AddressList.php

@@ -174,6 +174,8 @@ public function page(
                 $options['customerName'],
             'FriendlyName' =>
                 $options['friendlyName'],
+            'EmergencyEnabled' =>
+                Serialize::booleanToString($options['emergencyEnabled']),
             'IsoCountry' =>
                 $options['isoCountry'],
             'PageToken' => $pageToken,

src/Twilio/Rest/Api/V2010/Account/AddressOptions.php

@@ -49,26 +49,29 @@ public static function create(
     /**
      * @param string $customerName The `customer_name` of the Address resources to read.
      * @param string $friendlyName The string that identifies the Address resources to read.
+     * @param bool $emergencyEnabled Whether the address can be associated to a number for emergency calling.
      * @param string $isoCountry The ISO country code of the Address resources to read.
      * @return ReadAddressOptions Options builder
      */
     public static function read(
 
         string $customerName = Values::NONE,
         string $friendlyName = Values::NONE,
+        bool $emergencyEnabled = Values::BOOL_NONE,
         string $isoCountry = Values::NONE
 
     ): ReadAddressOptions
     {
         return new ReadAddressOptions(
             $customerName,
             $friendlyName,
+            $emergencyEnabled,
             $isoCountry
         );
     }
 
     /**
-     * @param string $friendlyName A descriptive string that you create to describe the address. It can be up to 64 characters long.
+     * @param string $friendlyName A descriptive string that you create to describe the new address. It can be up to 64 characters long for Regulatory Compliance addresses and 32 characters long for Emergency addresses.
      * @param string $customerName The name to associate with the address.
      * @param string $street The number and street address of the address.
      * @param string $city The city of the address.
@@ -197,17 +200,20 @@ class ReadAddressOptions extends Options
     /**
      * @param string $customerName The `customer_name` of the Address resources to read.
      * @param string $friendlyName The string that identifies the Address resources to read.
+     * @param bool $emergencyEnabled Whether the address can be associated to a number for emergency calling.
      * @param string $isoCountry The ISO country code of the Address resources to read.
      */
     public function __construct(
 
         string $customerName = Values::NONE,
         string $friendlyName = Values::NONE,
+        bool $emergencyEnabled = Values::BOOL_NONE,
         string $isoCountry = Values::NONE
 
     ) {
         $this->options['customerName'] = $customerName;
         $this->options['friendlyName'] = $friendlyName;
+        $this->options['emergencyEnabled'] = $emergencyEnabled;
         $this->options['isoCountry'] = $isoCountry;
     }
 
@@ -235,6 +241,18 @@ public function setFriendlyName(string $friendlyName): self
         return $this;
     }
 
+    /**
+     * Whether the address can be associated to a number for emergency calling.
+     *
+     * @param bool $emergencyEnabled Whether the address can be associated to a number for emergency calling.
+     * @return $this Fluent Builder
+     */
+    public function setEmergencyEnabled(bool $emergencyEnabled): self
+    {
+        $this->options['emergencyEnabled'] = $emergencyEnabled;
+        return $this;
+    }
+
     /**
      * The ISO country code of the Address resources to read.
      *
@@ -262,7 +280,7 @@ public function __toString(): string
 class UpdateAddressOptions extends Options
     {
     /**
-     * @param string $friendlyName A descriptive string that you create to describe the address. It can be up to 64 characters long.
+     * @param string $friendlyName A descriptive string that you create to describe the new address. It can be up to 64 characters long for Regulatory Compliance addresses and 32 characters long for Emergency addresses.
      * @param string $customerName The name to associate with the address.
      * @param string $street The number and street address of the address.
      * @param string $city The city of the address.
@@ -297,9 +315,9 @@ public function __construct(
     }
 
     /**
-     * A descriptive string that you create to describe the address. It can be up to 64 characters long.
+     * A descriptive string that you create to describe the new address. It can be up to 64 characters long for Regulatory Compliance addresses and 32 characters long for Emergency addresses.
      *
-     * @param string $friendlyName A descriptive string that you create to describe the address. It can be up to 64 characters long.
+     * @param string $friendlyName A descriptive string that you create to describe the new address. It can be up to 64 characters long for Regulatory Compliance addresses and 32 characters long for Emergency addresses.
      * @return $this Fluent Builder
      */
     public function setFriendlyName(string $friendlyName): self

src/Twilio/Rest/Api/V2010/Account/Call/TranscriptionOptions.php

@@ -34,7 +34,7 @@ abstract class TranscriptionOptions
      * @param string $speechModel Recognition model used by the transcription engine, among those supported by the provider
      * @param string $hints A Phrase contains words and phrase \\\"hints\\\" so that the speech recognition engine is more likely to recognize them.
      * @param bool $enableAutomaticPunctuation The provider will add punctuation to recognition result
-     * @param string $intelligenceService The SID of the [Voice Intelligence Service](https://www.twilio.com/docs/voice/intelligence/api/service-resource) for persisting transcripts and running post-call Language Operators .
+     * @param string $intelligenceService The SID or unique name of the [Voice Intelligence Service](https://www.twilio.com/docs/voice/intelligence/api/service-resource) for persisting transcripts and running post-call Language Operators .
      * @return CreateTranscriptionOptions Options builder
      */
     public static function create(
@@ -93,7 +93,7 @@ class CreateTranscriptionOptions extends Options
      * @param string $speechModel Recognition model used by the transcription engine, among those supported by the provider
      * @param string $hints A Phrase contains words and phrase \\\"hints\\\" so that the speech recognition engine is more likely to recognize them.
      * @param bool $enableAutomaticPunctuation The provider will add punctuation to recognition result
-     * @param string $intelligenceService The SID of the [Voice Intelligence Service](https://www.twilio.com/docs/voice/intelligence/api/service-resource) for persisting transcripts and running post-call Language Operators .
+     * @param string $intelligenceService The SID or unique name of the [Voice Intelligence Service](https://www.twilio.com/docs/voice/intelligence/api/service-resource) for persisting transcripts and running post-call Language Operators .
      */
     public function __construct(
 
@@ -284,9 +284,9 @@ public function setEnableAutomaticPunctuation(bool $enableAutomaticPunctuation):
     }
 
     /**
-     * The SID of the [Voice Intelligence Service](https://www.twilio.com/docs/voice/intelligence/api/service-resource) for persisting transcripts and running post-call Language Operators .
+     * The SID or unique name of the [Voice Intelligence Service](https://www.twilio.com/docs/voice/intelligence/api/service-resource) for persisting transcripts and running post-call Language Operators .
      *
-     * @param string $intelligenceService The SID of the [Voice Intelligence Service](https://www.twilio.com/docs/voice/intelligence/api/service-resource) for persisting transcripts and running post-call Language Operators .
+     * @param string $intelligenceService The SID or unique name of the [Voice Intelligence Service](https://www.twilio.com/docs/voice/intelligence/api/service-resource) for persisting transcripts and running post-call Language Operators .
      * @return $this Fluent Builder
      */
     public function setIntelligenceService(string $intelligenceService): self