<?php
/**
 * Public PHP API for other plugins running on the same site.
 *
 * Every function is safe to call once plugins are loaded (on `plugins_loaded` priority 20 or later,
 * `init`, admin pages, cron). Check for AngelForce Cache first:
 *
 *     if ( function_exists( 'velox_get_status' ) ) { $status = velox_get_status(); }
 *
 * Nothing here sends data off the site. Hooks other plugins can use:
 *
 * - do_action( 'velox_purged_all' )               after the whole cache was cleared
 * - do_action( 'velox_purged_url', $url )         after one page was cleared
 * - do_action( 'velox_settings_saved', $settings ) after the settings changed
 * - apply_filters( 'velox_is_cacheable', $bool )  return false to keep the current page out of the cache
 * - apply_filters( 'velox_compat_delay_exclude', $tokens ) script tokens that are never delayed
 * - apply_filters( 'velox_compat_css_safelist', $tokens )  CSS selectors always kept
 *
 * @package Velox_Cache
 */

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

/** API version, raised when a function's return shape changes. */
define( 'VELOX_API_VERSION', 1 );

if ( ! function_exists( 'velox_get_status' ) ) {
	/**
	 * Cache and optimization status.
	 *
	 * @return array{version:string,api:int,cache_enabled:bool,static_serve:bool,pages:int,size_bytes:int,last_purge:int,preload_remaining:int,optimizations:string[]}
	 */
	function velox_get_status() {
		$s     = Velox_Settings::all();
		$stats = Velox_Cache::stats();
		$on    = array();
		foreach ( array( 'html_minify', 'css_minify', 'defer_js', 'delay_js', 'critical_css', 'rucss', 'lazy_images', 'lazy_iframes', 'lazy_youtube', 'lcp_priority', 'img_dimensions', 'font_swap', 'webp', 'avif', 'gzip', 'browser_cache', 'force_https', 'www_redirect' ) as $k ) {
			if ( ! empty( $s[ $k ] ) ) {
				$on[] = $k;
			}
		}
		return array(
			'version'           => VELOX_VERSION,
			'api'               => VELOX_API_VERSION,
			'cache_enabled'     => (bool) $s['cache_enabled'],
			'static_serve'      => (bool) $s['static_serve'],
			'pages'             => (int) $stats['pages'],
			'size_bytes'        => (int) $stats['size'],
			'last_purge'        => (int) get_option( 'velox_last_purge', 0 ),
			'preload_remaining' => (int) Velox_Preload::remaining(),
			'optimizations'     => $on,
		);
	}
}

if ( ! function_exists( 'velox_get_server_stats' ) ) {
	/**
	 * Current server values plus the hourly history of the last 7 days.
	 *
	 * @return array{now:array,history:array}
	 */
	function velox_get_server_stats() {
		return array(
			'now'     => Velox_Server::now(),
			'history' => Velox_Server::history(),
		);
	}
}

if ( ! function_exists( 'velox_get_vitals' ) ) {
	/**
	 * Core Web Vitals from real visitors (75th percentile per device), empty when measuring is off.
	 *
	 * @return array
	 */
	function velox_get_vitals() {
		return Velox_Settings::get( 'rum' ) ? Velox_Vitals::summary() : array();
	}
}

if ( ! function_exists( 'velox_purge_url' ) ) {
	/**
	 * Clears the cached copies of one page of this site.
	 *
	 * @param string $url Full URL on this site.
	 * @return bool False when the URL belongs to another host.
	 */
	function velox_purge_url( $url ) {
		$url = esc_url_raw( (string) $url );
		if ( '' === $url || strtolower( (string) wp_parse_url( $url, PHP_URL_HOST ) ) !== strtolower( (string) wp_parse_url( home_url(), PHP_URL_HOST ) ) ) {
			return false;
		}
		Velox_Cache::purge_url( $url );
		return true;
	}
}

if ( ! function_exists( 'velox_purge_all' ) ) {
	/** Clears the whole page cache (and Cloudflare, when connected). */
	function velox_purge_all() {
		Velox_Cache::purge_all();
	}
}

if ( ! function_exists( 'velox_preload' ) ) {
	/** Starts rebuilding the cache in the background (when preload is on). */
	function velox_preload() {
		Velox_Preload::schedule();
	}
}