Add optional license param to provide in auth url callback

Author: tarecord

src/Uplink/Auth/Auth_Url_Builder.php

@@ -35,10 +35,11 @@ public function __construct(
 	 *
 	 * @param  string  $slug  The product/service slug.
 	 * @param  string  $domain  An optional domain associated with a license key to pass along.
+	 * @param  string  $license  An optional license key to pass along.
 	 *
 	 * @return string
 	 */
-	public function build( string $slug, string $domain = '' ): string {
+	public function build( string $slug, string $domain = '', string $license = '' ): string {
 		global $pagenow;
 
 		if ( empty( $pagenow ) ) {
@@ -53,8 +54,9 @@ public function build( string $slug, string $domain = '' ): string {
 
 		// Query arguments to combine with $_GET and add to the authorization URL.
 		$args = [
-			'uplink_domain' => $domain,
-			'uplink_slug'   => $slug,
+			'uplink_domain'  => $domain,
+			'uplink_slug'    => $slug,
+			'uplink_license' => $license,
 		];
 
 		$url = add_query_arg(
@@ -69,5 +71,4 @@ public function build( string $slug, string $domain = '' ): string {
 			] )
 		);
 	}
-
 }

tests/wpunit/Auth/AuthUrlBuilderTest.php

@@ -0,0 +1,63 @@
+<?php declare( strict_types=1 );
+
+namespace StellarWP\Uplink\Tests\Auth;
+
+use StellarWP\Uplink\API\V3\Auth\Auth_Url;
+use StellarWP\Uplink\Auth\Auth_Url_Builder;
+use StellarWP\Uplink\Auth\Nonce;
+use StellarWP\Uplink\Config;
+use StellarWP\Uplink\Tests\Traits\With_Uopz;
+use StellarWP\Uplink\Tests\UplinkTestCase;
+use StellarWP\Uplink\Uplink;
+
+final class AuthUrlBuilderTest extends UplinkTestCase {
+
+	use With_Uopz;
+
+	/**
+	 * @var Auth_Url_Builder
+	 */
+	private $auth_url_builder;
+
+	protected function setUp(): void {
+		parent::setUp();
+
+		Config::set_token_auth_prefix( 'kadence_' );
+
+		// Run init again to reload all providers.
+		Uplink::init();
+
+		$this->set_class_fn_return( Auth_Url::class, 'get', 'https://theeventscalendar.com/account-auth' );
+		$this->set_class_fn_return( Nonce::class, 'create', 'abcd1234' );
+
+		$this->auth_url_builder = $this->container->get( Auth_Url_Builder::class );
+	}
+
+	public function test_it_builds_url(): void {
+		$url = $this->auth_url_builder->build( 'the-events-calendar', 'theeventscalendar.com' );
+
+		$callback = base64_encode( 'http://wordpress.test/wp-admin/index.php?uplink_domain=theeventscalendar.com&uplink_slug=the-events-calendar&_uplink_nonce=abcd1234' );
+		$expected = 'https://theeventscalendar.com/account-auth?uplink_callback=' . rawurlencode( $callback );
+
+		$this->assertSame( $expected, $url );
+	}
+
+	public function test_it_builds_url_with_license(): void {
+		$url = $this->auth_url_builder->build( 'the-events-calendar', 'theeventscalendar.com', 'some-license-key' );
+
+		$callback = base64_encode( 'http://wordpress.test/wp-admin/index.php?uplink_domain=theeventscalendar.com&uplink_slug=the-events-calendar&uplink_license=some-license-key&_uplink_nonce=abcd1234' );
+		$expected = 'https://theeventscalendar.com/account-auth?uplink_callback=' . rawurlencode( $callback );
+
+		$this->assertSame( $expected, $url );
+	}
+
+	public function test_it_builds_url_with_empty_license(): void {
+		$url = $this->auth_url_builder->build( 'the-events-calendar', 'theeventscalendar.com', '' );
+
+		$callback = base64_encode( 'http://wordpress.test/wp-admin/index.php?uplink_domain=theeventscalendar.com&uplink_slug=the-events-calendar&_uplink_nonce=abcd1234' );
+		$expected = 'https://theeventscalendar.com/account-auth?uplink_callback=' . rawurlencode( $callback );
+
+		$this->assertSame( $expected, $url );
+	}
+
+}