<?php
/**
 * Self-check for the three-tier phone cascade (plugin 3.3.0).
 *
 *   this page's own phone  →  the site's cities/locations default  →  phone_primary
 *
 * Run: php plugins/a1-tools/tests/phone-cascade.test.php
 *
 * a1tools_add_phone_default() is pure PHP with no WordPress dependency, so we
 * require the data layer with ABSPATH defined and call it directly. The final
 * array_merge() against the main variables is what supplies the phone_primary
 * tier, so each case asserts on the merged result — that is what the widgets
 * and shortcodes actually read.
 *
 * @package A1_Tools
 */

define( 'ABSPATH', __DIR__ );

// Minimal WordPress surface so the data layer loads outside WP. Only what the
// functions under test actually touch.
$GLOBALS['a1_actions'] = array();
function do_action( $hook ) {
	$GLOBALS['a1_actions'][] = $hook;
}

require_once __DIR__ . '/../includes/a1-tools-data.php';

$failures = 0;

/**
 * Assert helper.
 *
 * @param string $label    Case description.
 * @param string $expected Expected phone.
 * @param string $actual   Actual phone.
 * @return void
 */
function check( $label, $expected, $actual ) {
	global $failures;
	if ( $expected === $actual ) {
		echo "  ok   $label\n";
		return;
	}
	$failures++;
	echo "  FAIL $label — expected '$expected', got '$actual'\n";
}

/**
 * Resolve the phone a page ends up showing.
 *
 * @param string $page_phone   The city/location row's own phone ('' = unset).
 * @param string $tier_default The site's all-cities/all-locations default.
 * @param string $primary      The site's main number.
 * @return string
 */
function resolve( $page_phone, $tier_default, $primary ) {
	$variables = array(
		'phone_primary'        => $primary,
		'phone_cities_default' => $tier_default,
	);
	$overrides = array();
	a1tools_add_override( $overrides, 'phone_primary', array( 'phone' => $page_phone ), 'phone' );
	a1tools_add_phone_default( $overrides, $variables, 'phone_cities_default' );
	$merged = array_merge( $variables, $overrides );
	return $merged['phone_primary'];
}

echo "phone cascade\n";

// The headline case from the spec: A1 Chimney ATL.
check(
	'city with its own phone beats both upper tiers',
	'(888) 283-1000',
	resolve( '(888) 283-1000', '(888) 283-2000', '(888) 283-2999' )
);
check(
	'city with no phone falls to the all-cities default',
	'(888) 283-2000',
	resolve( '', '(888) 283-2000', '(888) 283-2999' )
);
check(
	'no city phone and no default falls all the way to primary',
	'(888) 283-2999',
	resolve( '', '', '(888) 283-2999' )
);

// Blank-ish values must not win — a whitespace-only column is "unset".
check(
	'whitespace-only city phone is treated as unset',
	'(888) 283-2000',
	resolve( '   ', '(888) 283-2000', '(888) 283-2999' )
);
check(
	'whitespace-only default is skipped',
	'(888) 283-2999',
	resolve( '', '   ', '(888) 283-2999' )
);

// Regression guard: the default must never overwrite a page that set its own,
// which is the one way this cascade can silently invert.
$overrides = array( 'phone_primary' => '(888) 283-1000' );
a1tools_add_phone_default( $overrides, array( 'phone_cities_default' => '(888) 283-2000' ), 'phone_cities_default' );
check( 'default never overwrites an existing page override', '(888) 283-1000', $overrides['phone_primary'] );

// A site that has not adopted the feature must behave exactly as before.
$overrides = array();
a1tools_add_phone_default( $overrides, array( 'phone_primary' => '(888) 283-2999' ), 'phone_cities_default' );
check( 'missing default column is a no-op', '', isset( $overrides['phone_primary'] ) ? $overrides['phone_primary'] : '' );

// Page-cache purge: on a site with no caching plugin installed, every direct
// call must be guarded away and only the (harmless) hooks fire. If this ever
// fatals, saving site variables fatals with it.
echo "\npage cache purge\n";
$GLOBALS['a1_actions'] = array();
a1tools_purge_page_cache();
check( 'survives with no cache plugin installed', 'yes', 'yes' );
check(
	'fires the SiteGround + LiteSpeed purge hooks',
	'sg_cachepress_purge_cache,litespeed_purge_all',
	implode( ',', $GLOBALS['a1_actions'] )
);

echo $failures ? "\n$failures FAILED\n" : "\nall passed\n";
exit( $failures ? 1 : 0 );