<?php

namespace AcademicCrew\Core;

/**
 * Freemius SDK accessor.
 *
 * The SDK itself is bootstrapped in the main plugin file (academiccrew.php)
 * via the global academiccrew_fs() function, exactly as Freemius' own generated
 * snippet expects — that call has to happen before anything else,
 * independent of our own PSR-4 autoloading. This class only ever *reads*
 * that already-bootstrapped instance, and is safe to call even if the SDK
 * failed to load (everything degrades to "not pro" / "no license").
 *
 * Free vs Pro is a feature split, not a quantity cap: the Free tier manages
 * an unlimited number of members, courses, projects and publications by
 * hand, with no customization. Pro adds CSV/Web import, automatic
 * publication sync (ORCID/Scholar/IRIS/CrossRef), full customization
 * (Appearance, Roles & Classes, archive page text, academic year settings)
 * and the Avada/Elementor integrations. See the "Licensing (Freemius)"
 * section in CLAUDE.md for the full module list and the reasoning behind
 * this split (wordpress.org's guidelines forbid quantity caps unlockable
 * via a license check).
 */
class Freemius {

    /**
     * Returns the bootstrapped \Freemius instance, or null if the SDK is
     * missing/failed to load.
     */
    public static function instance(): ?\Freemius {
        if ( ! function_exists( 'academiccrew_fs' ) ) {
            return null;
        }
        $fs = academiccrew_fs();
        return $fs instanceof \Freemius ? $fs : null;
    }

    /**
     * True only when a valid premium license/plan is active. Always false
     * if the SDK is unavailable — the plugin then behaves as pure Free tier.
     */
    public static function is_pro(): bool {
        $fs = self::instance();
        return null !== $fs && $fs->can_use_premium_code();
    }

    /** URL to the Freemius pricing/upgrade page for this install. */
    public static function pricing_url(): string {
        $fs = self::instance();
        return null !== $fs ? $fs->get_upgrade_url() : 'https://flowygo.com/progetto/academiccrew/';
    }
}