<?php
/**
 * ABDS Connect — the single "Buy ABDS Connect Pro" URL builder. Kept in its
 * own file (no hook registrations at file scope, unlike leads.php) so it can
 * be unit-tested by requiring just this file, the same pure-logic pattern
 * abds-seo uses.
 *
 * @package ABDS_Connect
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * The license server's buy page — the base every "Buy"/"Upgrade" link in this
 * plugin resolves against. A constant, not a literal repeated at each call
 * site, so it can be changed in one place.
 */
if ( ! defined( 'ABDS_CONNECT_BUY_URL_BASE' ) ) {
	define( 'ABDS_CONNECT_BUY_URL_BASE', 'https://license.abds-seo.com/buy/' );
}

/**
 * Single source of truth for every "Buy ABDS Connect Pro" link in this
 * plugin: builds the license-server buy-page URL with the tier/period/
 * currency/product preselected, plus a UTM trail identifying which on-screen
 * CTA was clicked.
 *
 * `tier`/`product` come from reading abds-license-server's
 * ABDS_LS_Plan_Catalog directly (purchasable_tiers('abds-connect') === ['pro'],
 * PRODUCT_ABDS_CONNECT === 'abds-connect') — not guessed. Still worth a final
 * cross-check against the live license-server's own settings before this
 * link goes out for real; that confirmation is the site owner's, not code's,
 * to give — hence the filter below rather than a hardcoded array, so the
 * values can be corrected without touching any markup.
 *
 * TODO: owner to confirm tier/product/period/currency defaults against the
 * license server's own configuration before 1.3.0 ships.
 *
 * @param string $context Identifies which on-screen CTA this is (e.g.
 *                         'settings_license', 'settings_pro_banner',
 *                         'plans_page') — becomes utm_content.
 * @return string The escaped buy-page URL.
 */
function abds_connect_buy_url( $context ) {
	$params                = apply_filters(
		'abds_connect_buy_url_params',
		array(
			'tier'       => 'pro',
			'period'     => 'monthly',
			'currency'   => 'usd',
			'product'    => 'abds-connect',
			'utm_source' => 'plugin',
			'utm_medium' => 'software',
		),
		$context
	);
	$params['utm_content'] = (string) $context;

	return esc_url( add_query_arg( $params, ABDS_CONNECT_BUY_URL_BASE ) );
}