<?php

namespace StoreSuit;

defined( 'ABSPATH' ) || exit;
/**
 * Settings → License (owner's request of 20 Oct 2026): one tab says which plan the store has, until when, what renews or
 * ends, and holds every license task, so the owner finds it without asking support: change the billing period, renew,
 * turn the renewal off, move to a higher or a lower plan, update the card and see invoices, move the license to another
 * site, check it again, ask for help.
 * - Freemius stays the source of truth and makes every change. The buttons open its pricing page (it knows the current
 *   license, so a new billing period changes this license instead of selling a second one), its checkout (on Freemius's
 *   hosted page, FreemiusScreens), its customer portal, or post its own account-page and activation requests with their
 *   nonces, which Freemius checks. StoreRuler stores nothing here.
 * - What the store may do is still Licensing::mode(); the panel only shows it, with the end of the grace period.
 * - The free build has no license: the tab says Free has no time limit and links StoreRuler Pro's page.
 * - facts() reads Freemius into plain values and present() turns them into the panel, so a test can show any license.
 *   The storesuit_license_facts filter changes what the panel shows (support, screenshots), never what the store may do.
 */
final class LicensePanel {
    /** Freemius's customer portal: the buyer's card, invoices, subscriptions and downloads, signed in by email. */
    public const PORTAL = 'https://users.freemius.com/';

    /** The License tab's data. Shop managers see the license; changing it asks a site administrator (manage_options). */
    public static function read() : array {
        Store::require_cap( 'manage_woocommerce' );
        // The free build has no license to activate (Freemius activates keys in StoreRuler Pro only): someone who bought a plan
        // downloads StoreRuler Pro from the purchase email or Freemius's customer portal and enters the key there.
        $out = array(
            'build'   => 'free',
            'state'   => 'free',
            'version' => STORESUIT_VERSION,
            'pro_url' => ProPage::url(),
            'portal'  => self::PORTAL,
            'admin'   => current_user_can( 'manage_options' ),
            'actions' => array(),
        );
        return $out;
    }

    /**
     * "Finish activation" (license-panel.js): a key waiting for Freemius's email goes to Freemius again (Licensing). 'done'
     * says whether the license is active now; otherwise 'error' carries Freemius's own reason, or nothing while it waits.
     */
    public static function finish() : array {
        Store::require_cap( 'manage_options' );
        $out = array(
            'done'  => false,
            'error' => '',
        );
        return $out;
    }

    /** A Freemius date (UTC, 'Y-m-d H:i:s') as a timestamp; 0 when there is none. */
    private static function stamp( $value ) : int {
        if ( !is_string( $value ) || $value === '' ) {
            return 0;
        }
        $time = strtotime( $value . ' UTC' );
        return ( $time ? (int) $time : 0 );
    }

    private static function day( int $time ) : string {
        return ( $time ? wp_date( (string) get_option( 'date_format' ), $time ) : '' );
    }

}