<?php
/**
 * Monorepo license + Freemius bootstrap (mapped via wp-env mu-plugin or relative path).
 *
 * Safe to load from multiple plugin copies (function_exists guards).
 *
 * @package PluginSuite
 */

defined( 'ABSPATH' ) || exit;

// phpcs:disable WordPress.NamingConventions.PrefixAllGlobals -- shared by every suite plugin, not owned by one product prefix.

if ( ! function_exists( 'plugin_suite_register' ) ) {
	/**
	 * Load shared licensing layer and register a plugin with the Freemius bridge.
	 */
	function plugin_suite_register( string $slug, string $main_file ): void {
		static $core_loaded = false;

		if ( ! $core_loaded ) {
			require_once __DIR__ . '/freemius-products.php';
			require_once __DIR__ . '/class-license.php';
			$core_loaded = true;
		}

		// Calling plugin may ship a newer freemius-products.php — merge via its path.
		$bundled = dirname( $main_file ) . '/includes/plugin-suite-shared/freemius-products.php';
		if ( is_readable( $bundled ) ) {
			require_once $bundled;
		}

		if ( ! class_exists( \PluginSuite\Shared\FreemiusBridge::class, false ) ) {
			foreach (
				[
					dirname( $main_file ) . '/includes/plugin-suite-shared/class-freemius-bridge.php',
					__DIR__ . '/class-freemius-bridge.php',
				] as $bridge
			) {
				if ( is_readable( $bridge ) ) {
					require_once $bridge;
					break;
				}
			}
		}

		if ( class_exists( \PluginSuite\Shared\FreemiusBridge::class, false ) ) {
			\PluginSuite\Shared\FreemiusBridge::register( $slug, $main_file );
		}
	}
}

if ( ! function_exists( 'plugin_suite_vendor_root' ) ) {
	/**
	 * Directory containing vendor/autoload.php for the active layout.
	 */
	function plugin_suite_vendor_root(): string {
		static $root = null;
		if ( null !== $root ) {
			return $root;
		}

		$candidates = [
			dirname( __DIR__, 2 ),
			dirname( __DIR__, 2 ) . '/plugin-suite',
			dirname( __DIR__, 3 ),
		];

		foreach ( $candidates as $dir ) {
			if ( is_readable( $dir . '/vendor/autoload.php' ) ) {
				$root = $dir;
				return $root;
			}
		}

		$root = '';
		return $root;
	}
}

if ( ! function_exists( 'plugin_suite_register_uninstall_hook' ) ) {
	/**
	 * Register uninstall cleanup for Freemius (after_uninstall) or WP fallback.
	 *
	 * @param object   $fs        Freemius SDK or license stub.
	 * @param string   $main_file Main plugin file path.
	 * @param callable $cleanup   Uninstall callback.
	 */
	function plugin_suite_register_uninstall_hook( object $fs, string $main_file, callable $cleanup ): void {
		if ( method_exists( $fs, 'add_action' ) ) {
			$fs->add_action( 'after_uninstall', $cleanup );
			return;
		}

		register_uninstall_hook( $main_file, $cleanup );
	}
}

if ( ! function_exists( 'plugin_suite_fs_can_use_pro' ) ) {
	/**
	 * Safe Pro gate for code that remains in Free ZIPs.
	 *
	 * Freemius strips methods named `*__premium_only` from Free builds, but may leave
	 * `$fs->is__premium_only() && can_use_premium_code()` assignments. Never call
	 * `is__premium_only()` unless the method exists on the instance.
	 *
	 * Keep `if ( *_fs()->is__premium_only() ) { ... }` blocks for preprocessor stripping.
	 */
	function plugin_suite_fs_can_use_pro( object $fs ): bool {
		if ( ! method_exists( $fs, 'can_use_premium_code' ) || ! $fs->can_use_premium_code() ) {
			return false;
		}
		if ( method_exists( $fs, 'is__premium_only' ) ) {
			return (bool) $fs->is__premium_only();
		}
		// License stub (Freemius-safe name — not stripped).
		if ( method_exists( $fs, 'is_premium_build' ) ) {
			return (bool) $fs->is_premium_build();
		}
		return false;
	}
}