<?php
/**
 * Shared constants.
 *
 * @package Kayvandra\MarginBeacon
 */

declare(strict_types=1);

namespace Kayvandra\MarginBeacon\Support;

/**
 * Plugin-wide constants that are not define()-based.
 */
final class Constants {

	const OPTION_SCHEMA_VERSION         = 'aksmb_schema_version';
	const OPTION_SCHEMA_VERIFIED        = 'aksmb_schema_verified';
	const OPTION_ACTIVATION_GMT         = 'aksmb_activation_gmt';
	const OPTION_SETTINGS               = 'aksmb_settings';
	const OPTION_COST_SETTINGS          = 'aksmb_cost_settings';
	const OPTION_COMPATIBILITY          = 'aksmb_compatibility_state';
	const OPTION_LAST_HEALTH            = 'aksmb_last_health';
	const OPTION_ENTITLEMENT_CACHE      = 'aksmb_entitlement_cache';
	const OPTION_ENTITLEMENT_STATE      = 'aksmb_entitlement_state';
	const OPTION_CATEGORY_THRESHOLDS    = 'aksmb_category_thresholds';
	const OPTION_CATEGORY_ASSUMED_COSTS = 'aksmb_category_assumed_costs';
	const OPTION_WIZARD_STATE           = 'aksmb_cogs_wizard_state';
	const OPTION_RECENT_PREVIEW_STATE   = 'aksmb_recent_preview_state';
	const OPTION_UNINSTALL_DELETE_DATA  = 'aksmb_uninstall_delete_data';
	const OPTION_COGS_MIGRATION_STATE   = 'aksmb_cogs_migration_state';

	const META_MANUAL_COST         = '_aksmb_manual_cost';
	const META_MANUAL_COST_UPDATED = '_aksmb_manual_cost_updated_gmt';

	const SCHEDULER_GROUP = 'marginbeacon';

	const ACTION_EVALUATE_ORDER            = 'aksmb_evaluate_order';
	const ACTION_SEED_PRICE_REVISIONS      = 'aksmb_seed_price_revisions';
	const ACTION_RECONCILE_PRICE_REVISIONS = 'aksmb_reconcile_price_revisions';
	const ACTION_FULL_SCAN_BATCH           = 'aksmb_full_scan_batch';
	const ACTION_SCHEDULED_FULL_SCAN       = 'aksmb_scheduled_full_scan_run';
	const ACTION_RUN_SELECTED_PREFLIGHT    = 'aksmb_run_selected_preflight';
	const ACTION_RUN_PAIRWISE_PREFLIGHT    = 'aksmb_run_pairwise_preflight';
	const ACTION_SYNC_ACK_COUPON           = 'aksmb_sync_ack_coupon';
	const ACTION_COGS_MIGRATION_BATCH      = 'aksmb_cogs_migration_batch';

	const OPTION_SCHEDULED_SCAN  = 'aksmb_scheduled_scan';
	const OPTION_ACK_SYNC_PREFIX = 'aksmb_ack_sync_coupon_';

	const MONEY_SCALE_MAX     = 6;
	const QUANTITY_SCALE_MAX  = 4;
	const THRESHOLD_SCALE     = 10000;
	const DEFAULT_MONEY_SCALE = 6;

	const CAP_MANAGE           = 'aksmb_manage';
	const CAP_ACKNOWLEDGE      = 'aksmb_acknowledge_loss_leader';
	const CAP_VIEW_DIAGNOSTICS = 'aksmb_view_diagnostics';

	/**
	 * Pro companion plugin basename (WordPress plugin API identifier).
	 *
	 * Used only to detect installed-vs-active state through the official
	 * is_plugin_active()/get_plugins() APIs — never to infer entitlement.
	 */
	const PRO_PLUGIN_BASENAME = 'marginbeacon-pro/marginbeacon-pro.php';

	/**
	 * Default global threshold profile (percent × THRESHOLD_SCALE).
	 *
	 * @return array{critical_below:int,high_below:int,warning_below:int}
	 */
	public static function default_thresholds() {
		return array(
			'critical_below' => 0,
			'high_below'     => 30000,  // 3.0000%
			'warning_below'  => 100000, // 10.0000%
		);
	}

	/**
	 * Prevent instantiation.
	 */
	private function __construct() {}
}