<?php
/**
 * Guest order tracking module.
 *
 * @package Rahkar\WP
 */

declare( strict_types = 1 );

namespace Rahkar\WP\Modules\OrderTracking;

use Rahkar\WP\Contracts\HasSettings;
use Rahkar\WP\Modules\BaseModule;
use Rahkar\WP\Modules\OtpAuth\LoginPage;
use Rahkar\WP\Modules\OtpAuth\OtpAuthModule;
use Rahkar\WP\Plugin;
use Rahkar\WP\Support\Manifest;
use Rahkar\WP\Support\Settings;

defined( 'ABSPATH' ) || exit;

/**
 * «پیگیری سفارش» — letting a customer without an account check their order.
 *
 * Ported out of `rahkartheme`. Two things made it a poor fit for a theme. The
 * access rules are the first: who may see an order, and the one-time code that
 * proves it, are not a design decision, and losing them on a theme switch
 * silently removes a page customers have bookmarked. The second is that the
 * theme carried a second OTP implementation to run it, beside the one the login
 * module already had — two code stores, two rate limiters, two sets of gateway
 * settings, and a shop that fixed its SMS failover in one place did not fix the
 * other.
 *
 * The admin half moved with it, because the postal tracking code and the
 * "shipped" flag are what the customer-facing timeline reads. They were never
 * really two features.
 *
 * The page's markup stayed in the theme. `rahkar_wp_track_view` lets a theme
 * return its own for each view; without one, {@see Views} renders a plain,
 * correct version so the module works on any theme.
 */
final class OrderTrackingModule extends BaseModule implements HasSettings {

	public const SLUG = 'order_tracking';

	/**
	 * Where the chosen tracking page is actually stored.
	 *
	 * Not in this module's settings row. That row is `autoload = false` by rule,
	 * and the page id is read on every storefront request — the theme asks it
	 * to decide whether to ship the tracking CSS/JS, and {@see OrderLookup}
	 * asks it to append the form. Moving it would add a query to every page view
	 * to answer "no". This option is autoloaded, predates the module, and both
	 * sides already read it; the settings field below is only a view onto it.
	 */
	public const PAGE_OPTION = 'rahkar_tracking_page_id';

	/**
	 * Every lookup here is a WooCommerce order.
	 *
	 * @var bool
	 */
	protected bool $requiresWooCommerce = true;

	/**
	 * {@inheritDoc}
	 */
	public function slug(): string {
		return self::SLUG;
	}

	/**
	 * {@inheritDoc}
	 */
	public function name(): string {
		return __( 'پیگیری سفارش', 'rahkar-toolkit' );
	}

	/**
	 * {@inheritDoc}
	 */
	public function description(): string {
		return __( 'صفحه‌ی پیگیری سفارش برای مشتری بدون حساب کاربری. با شماره موبایل یا کد سفارش شروع می‌شود و با کد یک‌بارمصرفی که به شماره‌ی ثبت‌شده روی خودِ سفارش می‌رود تأیید می‌شود — پس حدس‌زدن شماره سفارش چیزی به کسی نمی‌دهد. کد رهگیری پستی هم از صفحه‌ی سفارش وارد می‌شود و همان‌جا مرحله‌ی «ارسال شده» را جلو می‌برد.', 'rahkar-toolkit' );
	}

	/**
	 * {@inheritDoc}
	 *
	 * This module sends one-time codes, and deliberately does not own a second
	 * way of doing it. Without `otp_auth` there is no code store, no dispatcher
	 * and no rate limiter, so it says so rather than half-working.
	 */
	public function unmetRequirements(): array {
		$missing = parent::unmetRequirements();

		if ( $missing ) {
			return $missing;
		}

		if ( ! Manifest::isEnabled( OtpAuthModule::SLUG ) ) {
			$missing[] = __( 'ماژول «ورود با کد پیامکی» باید فعال باشد — کد تأیید پیگیری از همان مسیر فرستاده می‌شود.', 'rahkar-toolkit' );
		}

		return $missing;
	}

	/**
	 * {@inheritDoc}
	 *
	 * The page comes from its own option, so the field shows the real choice
	 * even for a shop that made it in the theme's settings before it moved here.
	 */
	public function defaults(): array {
		return [
			'page'            => (int) get_option( self::PAGE_OPTION, 0 ),
			'tracking_url'    => '',
			'support_contact' => '',
		];
	}

	/**
	 * {@inheritDoc}
	 */
	public function settingsSchema(): array {
		return [
			'page'            => [
				'type'    => 'select',
				'label'   => __( 'صفحه پیگیری سفارش', 'rahkar-toolkit' ),
				'options' => $this->pageChoices(),
				'help'    => __( 'برگه‌ای که فرم پیگیری سفارش در آن نمایش داده می‌شود. کافی است یک برگه‌ی خالی بسازید و اینجا انتخابش کنید؛ فرم به‌طور خودکار به محتوای آن افزوده می‌شود. بهتر است نامک این برگه را tracking بگذارید.', 'rahkar-toolkit' ),
				'default' => 0,
			],
			'tracking_url'    => [
				'type'    => 'text',
				'label'   => __( 'لینک رهگیری مرسوله پستی', 'rahkar-toolkit' ),
				'help'    => __( 'الگوی لینک پیگیری روی سایت شرکت پستی یا باربری، با {code} به‌جای کد رهگیری. مثال: https://tracking.post.ir/?id={code}. اگر خالی بماند، کد رهگیری فقط به‌صورت متن نمایش داده می‌شود.', 'rahkar-toolkit' ),
				'default' => '',
			],
			'support_contact' => [
				'type'    => 'text',
				'label'   => __( 'شماره تماس پشتیبانی', 'rahkar-toolkit' ),
				'help'    => __( 'وقتی سفارشی برای شماره وارد‌شده پیدا نشود، همین شماره به مشتری نشان داده می‌شود. اگر خالی بماند، چیزی نشان داده نمی‌شود.', 'rahkar-toolkit' ),
				'default' => '',
			],
		];
	}

	/**
	 * {@inheritDoc}
	 */
	public function settingsSections(): array {
		return [];
	}

	/**
	 * Published pages, for the page picker. Settings screen only.
	 *
	 * @return array<int, string>
	 */
	private function pageChoices(): array {
		$choices = [ 0 => __( '— غیرفعال —', 'rahkar-toolkit' ) ];

		// WooCommerce's shop, cart, checkout and account pages, and the front
		// and posts pages, already have a job; the form appended to one of them
		// would sit under a checkout or a product grid. Same list the login page
		// picker uses — this module requires otp_auth, so it is always there.
		$reserved = LoginPage::reservedPageIds();

		foreach ( get_pages( [ 'post_status' => 'publish' ] ) ?: [] as $page ) {
			if ( ! in_array( (int) $page->ID, $reserved, true ) ) {
				$choices[ (int) $page->ID ] = $page->post_title;
			}
		}

		return $choices;
	}

	/**
	 * Divert the page out of the settings row and into {@see self::PAGE_OPTION}.
	 *
	 * Runs on the row's own pre-update filter, so the generic settings save
	 * needs no special case: whatever it writes, the page never lands in the
	 * non-autoloaded row, and there is one stored value rather than two that
	 * can disagree.
	 *
	 * @param mixed $value Settings payload about to be written.
	 *
	 * @return mixed
	 */
	public static function storePage( mixed $value ): mixed {
		if ( ! is_array( $value ) || ! array_key_exists( 'page', $value ) ) {
			return $value;
		}

		update_option( self::PAGE_OPTION, max( 0, (int) $value['page'] ), true );
		unset( $value['page'] );

		return $value;
	}

	/**
	 * {@inheritDoc}
	 */
	public function register(): void {
		add_action(
			'rest_api_init',
			static fn() => Plugin::make( TrackEndpoint::class )->registerRoutes()
		);

		if ( ! is_admin() ) {
			return;
		}

		add_filter( 'pre_update_option_' . Settings::PREFIX . self::SLUG, [ self::class, 'storePage' ] );

		add_action(
			'woocommerce_admin_order_data_after_order_details',
			static fn( $order ) => Plugin::make( FulfilmentFields::class )->render( $order )
		);

		add_action(
			'woocommerce_process_shop_order_meta',
			static fn( $orderId ) => Plugin::make( FulfilmentFields::class )->save( $orderId )
		);
	}
}