The Addresses facade

use RoundlyConsulting\Addresses\DataTransferObjects\AddressData;
use RoundlyConsulting\Addresses\Enums\AddressType;
use RoundlyConsulting\Addresses\Facades\Addresses;

// One owner's address book — any Eloquent model, no trait required.
$book = Addresses::for($supplier);

$book->new()                                    // fluent PendingAddress
    ->type(AddressType::Work)
    ->in('Bratislava')->at('Somewhere 1')->postalCode('81101')->country('SK')
    ->save();
$book->add(AddressData::make(city: 'Košice', street: 'Main 2', postalCode: '04001', countryIso: 'SK'));

$book->all();                                   // Collection<Address>, oldest first
$book->primary();                               // primary across all types (or null)
$book->primary(AddressType::Billing);           // primary of a type
$book->ofType(AddressType::Office);             // collection of a type
$book->setPrimary($address);                    // promote; refuses another owner's or a deleted address
$book->update($address, $data);                 // owner-checked full write
$book->delete($address);                        // owner-checked soft delete

// One address — unscoped, any owner.
Addresses::update($address, $data);             // full write, dispatches AddressUpdated
Addresses::delete($address);                    // soft delete, dispatches AddressDeleted

Addresses::types();                             // the configured type keys
Addresses::typeLabel('billing');                // 'Billing'
Addresses::countryName('sk');                   // resolved name, or 'SK' without a resolver