[4.7] Upgrade events

[lukeholder]

Description

Added the ability to hook into the upgrade command after it has run, but before v3 tables and columns are dropped.

Event Model: \craft\commerce\events\UpgradeEvent
Event: \craft\commerce\console\controllers\UpgradeController::EVENT_BEFORE_DROP_V3_DATABASE_ENTITIES

Event includes the column mapping so previous address IDs can be accessed and migrated by custom module or plugin code:

commerce/src/console/controllers/UpgradeController.php

Lines 99 to 128 in 6dfad2b

	private array $_v3droppableColumns = [
	['table' => '{{%commerce_taxzones}}', 'column' => 'v3isCountryBased'],
	['table' => '{{%commerce_shippingzones}}', 'column' => 'v3isCountryBased'],
	['table' => '{{%commerce_taxzones}}', 'column' => 'v3zipCodeConditionFormula'],
	['table' => '{{%commerce_shippingzones}}', 'column' => 'v3zipCodeConditionFormula'],
	['table' => '{{%commerce_orders}}', 'column' => 'v3customerId'],
	['table' => '{{%commerce_orders}}', 'column' => 'v3billingAddressId'],
	['table' => '{{%commerce_orders}}', 'column' => 'v3shippingAddressId'],
	['table' => '{{%commerce_orders}}', 'column' => 'v3estimatedBillingAddressId'],
	['table' => '{{%commerce_orders}}', 'column' => 'v3estimatedShippingAddressId'],
	['table' => '{{%commerce_customers}}', 'column' => 'v3userId'],
	['table' => '{{%commerce_customers}}', 'column' => 'v3primaryBillingAddressId'],
	['table' => '{{%commerce_customers}}', 'column' => 'v3primaryShippingAddressId'],
	['table' => '{{%commerce_customer_discountuses}}', 'column' => 'v3customerId'],
	['table' => '{{%commerce_orderhistories}}', 'column' => 'v3customerId'],
	];
	private array $_v3tables = [
	'{{%commerce_addresses}}',
	'{{%commerce_customers_addresses}}',
	'{{%commerce_countries}}',
	'{{%commerce_states}}',
	'{{%commerce_shippingzone_countries}}',
	'{{%commerce_shippingzone_states}}',
	'{{%commerce_taxzone_countries}}',
	'{{%commerce_taxzone_states}}',
	];