Configuration

The published config/addresses.php in full (comments trimmed):

use RoundlyConsulting\Addresses\Address;
use RoundlyConsulting\Addresses\Enums\AddressType;

return [
    'model' => Address::class,

    'key_type' => env('ADDRESSES_KEY_TYPE', 'bigint'),   // bigint | uuid | ulid

    'default_type' => AddressType::Default->value,

    'normalise_country' => true,

    'country_resolver' => null,

    'facade_alias' => 'Addresses',
];

Every key

Environment

Only the owner key type is env-backed — the other keys are literal values you change in the published file:

ADDRESSES_KEY_TYPE=uuid

default_type

default_type is the type an address gets when its creator names none — the fluent builder without ->type(), AddressData without type and createAddress() without type all fall back to it, and a key that is not set (absent, null or blank) means AddressType::Default. It is read when such an address is built — matching ignores case and padding — so any other value that is not an AddressType case (default, billing, shipping, home, work, office) throws InvalidAddressTypeException at that point:

// config/addresses.php
'default_type' => 'billing',

// an address created without a type now gets AddressType::Billing
$customer->newAddress()
    ->in('Bratislava')->at('Somewhere 1')->postalCode('81101')->country('SK')
    ->save();

facade_alias

Set facade_alias to another name (for example Locations) to register the facade under that alias, or to null (or a false spelling: false, 0, off, no) to skip the alias entirely; a blank value is not set and keeps Addresses. The alias comes from config only — the package’s composer.json declares none for package discovery — and importing RoundlyConsulting\Addresses\Facades\Addresses works either way.