Reading addresses

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

$book = Addresses::for($payer);

$book->all();                                                  // Collection<Address>, oldest first
$book->primary();                                              // primary across all types (or null)
$book->primary(AddressType::Office);                           // primary of a type
$book->ofType(AddressType::Shipping);                          // collection of a type

// Model trait shortcuts (they go through the same book):
$payer->addresses;                                             // all addresses (relation)
$payer->getAddressOfType(AddressType::Home);                   // first of a type
$payer->getAddressOfType(AddressType::Home, onlyPrimary: true); // first primary of a type
$payer->getPrimaryAddressOfType(AddressType::Office);          // the same, as a shorthand
$payer->primaryAddress();                                      // primary across all types
$payer->primaryAddress(AddressType::Office);                   // primary of a type
$payer->addressesOfType(AddressType::Shipping);                // collection of a type
$payer->hasAddresses();                                        // bool

// the helpers run a query on every call — for lists, eager-load the relation once
$customers = Customer::with('addresses')->get();

foreach ($customers as $customer) {
    $customer->addresses->where('is_primary', true);   // filtered in memory, no extra query
}