<?php

namespace StoreSuit;

defined( 'ABSPATH' ) || exit;
// phpcs:disable WordPress.Security.EscapeOutput.ExceptionNotEscaped -- Messages are returned as JSON by Admin::ajax() and shown with textContent; HTML output escapes them where printed.
/**
 * Asks the store owner for a review of StoreRuler only at a happy moment (0.62.1, owner: "when we have a sign the user is
 * satisfied, ask for a review"). A happy moment is real success in the store, read from its own records: completed orders,
 * a sale won back by a cart reminder, days the register was closed. Nothing is asked while something is wrong (failed
 * emails this week), in the first two weeks, or again after "Not again". The ask lives on StoreRuler's home page only, never
 * as a site-wide notice, and it has no reward: a review is the owner's own opinion. It switches on once StoreRuler is listed
 * on WordPress.org (STORERULER_WPORG_LISTED or the storesuit_review_prompt filter); until then there is no page to review on.
 */
final class ReviewPrompt {
    public const URL = 'https://wordpress.org/support/plugin/storeruler/reviews/#new-post';

    private const STATE = 'storesuit_review_prompt';

    private const FIRST_SEEN = 'storesuit_first_seen';

    private const SIGNAL = 'storesuit_review_signal';

    private const LATER_DAYS = 30;

    private const MIN_AGE_DAYS = 14;

    public static function enabled() : bool {
        return (bool) apply_filters( 'storesuit_review_prompt', defined( 'STORERULER_WPORG_LISTED' ) && constant( 'STORERULER_WPORG_LISTED' ) );
    }

    /** The ask for the home page, or null. Only the site owner (manage_options) is asked. */
    public static function read() : ?array {
        if ( !self::enabled() || !current_user_can( 'manage_options' ) ) {
            return null;
        }
        $state = (array) get_option( self::STATE, array() );
        if ( in_array( $state['state'] ?? '', array('rated', 'never'), true ) || (int) ($state['until'] ?? 0) > time() ) {
            return null;
        }
        $first = (int) get_option( self::FIRST_SEEN, 0 );
        if ( !$first ) {
            update_option( self::FIRST_SEEN, time(), false );
            return null;
        }
        if ( $first > time() - self::MIN_AGE_DAYS * DAY_IN_SECONDS ) {
            return null;
        }
        // Something went wrong this week (an email could not be sent): not a happy moment. Read fresh, not from the cache.
        global $wpdb;
        if ( (int) $wpdb->get_var( $wpdb->prepare(
            'SELECT COUNT(*) FROM %i WHERE status=%s AND created>=%s',
            MailLog::table(),
            'failed',
            gmdate( 'Y-m-d H:i:s', time() - 7 * DAY_IN_SECONDS )
        ) ) ) {
            return null;
        }
        $signal = get_transient( self::SIGNAL );
        if ( !is_array( $signal ) ) {
            $signal = self::signal();
            set_transient( self::SIGNAL, $signal, 12 * HOUR_IN_SECONDS );
        }
        if ( empty( $signal['key'] ) ) {
            return null;
        }
        return array(
            'signal' => $signal['key'],
            'count'  => (int) $signal['count'],
            'text'   => self::text( $signal['key'], (int) $signal['count'] ),
            'url'    => self::URL,
        );
    }

    /** "rated" (the review page was opened), "later" (ask again in 30 days) or "never". */
    public static function respond( array $data ) : array {
        Store::require_cap( 'manage_options' );
        $answer = Store::text( $data, 'answer' );
        if ( !in_array( $answer, array('rated', 'later', 'never'), true ) ) {
            throw new \InvalidArgumentException(I18n::t( 'Choose an answer.' ));
        }
        update_option( self::STATE, array(
            'state' => $answer,
            'until' => ( $answer === 'later' ? time() + self::LATER_DAYS * DAY_IN_SECONDS : 0 ),
            'at'    => time(),
            'actor' => get_current_user_id(),
        ), false );
        return array(
            'saved' => true,
        );
    }

    /** The strongest sign of success in the last 30 days, or none while something is wrong. */
    private static function signal() : array {
        global $wpdb;
        $since = gmdate( 'Y-m-d H:i:s', time() - 30 * DAY_IN_SECONDS );
        // Reminder times are stored in UTC.
        // Order dates and register days are the site's local time (no date filter in between).
        $local = ( new \DateTimeImmutable('now', wp_timezone()) )->modify( '-30 days' );
        if ( get_option( 'storesuit_order_index_ready' ) === '1' ) {
            $done = (int) $wpdb->get_var( $wpdb->prepare(
                'SELECT COUNT(*) FROM %i WHERE status=%s AND created_at>=%s',
                OrderIndex::table(),
                'completed',
                $local->format( 'Y-m-d H:i:s' )
            ) );
            if ( $done >= 20 ) {
                return array(
                    'key'   => 'orders',
                    'count' => $done,
                );
            }
        }
        return array();
    }

    private static function text( string $key, int $count ) : string {
        if ( $key === 'recovered' ) {
            return ( $count === 1 ? I18n::t( 'A cart reminder won back a sale in the last 30 days.' ) : I18n::format( 'Cart reminders won back %s sales in the last 30 days.', number_format_i18n( $count ) ) );
        }
        if ( $key === 'register' ) {
            return I18n::format( 'You closed the register with StoreRuler on %s of the last 30 days.', number_format_i18n( $count ) );
        }
        // The store's own success, not a claim about StoreRuler: every order completed in the last 30 days counts (guideline 9).
        return I18n::format( 'You completed %s orders in the last 30 days.', number_format_i18n( $count ) );
    }

}