Connection: add partner codes to connection URLs & deprecate Partner package

projects/packages/connection/changelog/fix-connection-partner-standalone-sites

@@ -0,0 +1,4 @@
+Significance: patch
+Type: fixed
+
+Connection: ensure that partner partners are passed on during the connection process, regardless of the plugin you use to connect.

projects/packages/connection/docs/partner-tools.md

@@ -0,0 +1,37 @@
+# Partner Tools
+
+The Connection package includes 2 classes, `Automattic\Jetpack\Partner` and `Automattic\Jetpack\Partner_Coupon`, that provide support functions for Jetpack hosting partners.
+
+### Usage for hosting partners
+
+As a hosting partner you will need to set either the subsidiary id or the affiliate code. Both can be set via an option or a filter (but please do not set them using an option and filter simultaneously as this may not result in the desired effect).
+
+The most straight forward way to set these is by using an option:
+
+```php
+// Set or update subsidiary id. Note that subsidiary id is a string that will be filtered
+// with WordPress' sanitize_key() so make sure it conforms to the regex [^a-z0-9_\-].
+update_option( 'jetpack_partner_subsidiary_id', '<subsidiary id here>', true );
+
+// Set or update the affiliate code.
+update_option( 'jetpack_affiliate_code', '<affiliate code here>', true );
+```
+
+Another way to set these is via a filter. This requires creating a function that returns the desired value.
+
+```php
+// Set the subsidairy id. Note that subsidiary id is a string that will be filtered
+// with WordPress' sanitize_key() so make sure it conforms to the regex [^a-z0-9_\-].
+function subsidiary_filter( ) {
+	return '<subsidiary id here>';
+}
+
+add_filter( 'jetpack_partner_subsidiary_id', 'subsidiary_filter' );
+
+// Set the affiliate code.
+function affiliate_filter( ) {
+	return '<affiliate code here>';
+}
+
+add_filter( 'jetpack_affiliate_code', 'affiliate_filter' );
+```

projects/packages/connection/src/class-manager.php

@@ -10,6 +10,7 @@
 use Automattic\Jetpack\A8c_Mc_Stats;
 use Automattic\Jetpack\Constants;
 use Automattic\Jetpack\Heartbeat;
+use Automattic\Jetpack\Partner;
 use Automattic\Jetpack\Roles;
 use Automattic\Jetpack\Status;
 use Automattic\Jetpack\Status\Host;
@@ -138,6 +139,9 @@ public static function configure() {
 
 		// Initialize token locks.
 		new Tokens_Locks();
+
+		// Initial Partner management.
+		Partner::init();
 	}
 
 	/**
@@ -1924,7 +1928,10 @@ public function get_authorization_url( $user = null, $redirect = null ) {
 
 		$api_url = $this->api_url( 'authorize' );
 
-		return add_query_arg( $body, $api_url );
+		$url = add_query_arg( $body, $api_url );
+
+		/** This filter is documented in plugins/jetpack/class-jetpack.php  */
+		return apply_filters( 'jetpack_build_authorize_url', $url );
 	}
 
 	/**