refactor: replace address field with street_name, house_number, and address_addition in AdditionalAddress and Contact classes; mark old address field as deprecated

Author: mgjgid

src/Resources/Contacts/AdditionalAddresses/AdditionalAddress.php

@@ -22,11 +22,17 @@ class AdditionalAddress extends Resource
     const DELETE_REQUEST = DeleteAdditionalAddressRequest::class;
     const QUERY_BUILDER = AdditionalAddressQueryBuilder::class;
 
+
+    /** @deprecated use street_name, house_number, address_addition instead. */
+    public readonly ?string $address;
+
     public function __construct(
         public ?int $id = null,
         public ?int $contact_id = null,
         public ?string $name = null,
-        public ?string $address = null,
+        public ?string $street_name = null,
+        public ?string $house_number = null,
+        public ?string $address_addition = null,
         public ?string $postcode = null,
         public ?string $city = null,
         public ?int $country_id = null,

src/Resources/Contacts/Contacts/Contact.php

@@ -33,6 +33,9 @@ class Contact extends Resource
     public ?string $updated_at;
     public ?string $profile_image;
 
+    /** @deprecated use street_name, house_number, address_addition instead. */
+    public readonly ?string $address;
+
     public function __construct(
         public int|ContactType $contact_type_id = ContactType::COMPANY,
         public ?int $id = null,
@@ -43,7 +46,9 @@ public function __construct(
         public ?string $salutation_form = null,
         public ?int $titel_id = null,
         public ?string $birthday = null,
-        public ?string $address = null,
+        public ?string $street_name = null,
+        public ?string $house_number = null,
+        public ?string $address_addition = null,
         public ?string $postcode = null,
         public ?string $city = null,
         public ?int $country_id = null,

tests/Resources/Contacts/AdditionalAddresses/AdditionalAddressRequestsTest.php

@@ -13,7 +13,9 @@
         id: null,
         contact_id: testContactId(),
         name: fake()->word(),
-        address: fake()->streetAddress(),
+        street_name: fake()->streetName(),
+        house_number: fake()->buildingNumber(),
+        address_addition: fake()->secondaryAddress(),
         postcode: fake()->postcode(),
         city: fake()->city(),
         subject: fake()->sentence(),

tests/Resources/Contacts/Contacts/ContactRequestsTest.php

@@ -14,10 +14,11 @@
 
 it('can create a Contact', function () use (&$testContact) {
     $contact = new Contact(
+        contact_type_id: fake()->randomElement([ContactType::PERSON, ContactType::COMPANY]),
         name_1: fake()->firstName(),
-        contact_type_id: ContactType::PERSON,
         name_2: fake()->lastName(),
-        address: fake()->streetAddress(),
+        street_name: fake()->streetName(),
+        house_number: fake()->buildingNumber(),
         postcode: fake()->randomNumber(4),
         city: fake()->city(),
         mail: fake()->safeEmail(),