<?php
/**
 * ArrayFunnel global helper functions.
 *
 * @package ArrayFunnel
 */

defined( 'ABSPATH' ) || exit;

if ( ! function_exists( 'arrayfunnel_generate_token' ) ) {
	/**
	 * Generate a cryptographically secure recovery token.
	 *
	 * @param int $length Token length in hexadecimal characters. Must be even.
	 */
	function arrayfunnel_generate_token( int $length = 32 ): string {
		$length = max( 16, $length - ( $length % 2 ) );

		return bin2hex( random_bytes( $length / 2 ) );
	}
}

if ( ! function_exists( 'arrayfunnel_log' ) ) {
	/**
	 * Write a message to the WooCommerce log when WP_DEBUG is enabled.
	 *
	 * @param string $message Log message.
	 * @param string $level   Log level. One of the PSR-3 levels WooCommerce supports.
	 */
	function arrayfunnel_log( string $message, string $level = 'info' ): void {
		if ( ! defined( 'WP_DEBUG' ) || ! WP_DEBUG || ! function_exists( 'wc_get_logger' ) ) {
			return;
		}

		$allowed = array( 'emergency', 'alert', 'critical', 'error', 'warning', 'notice', 'info', 'debug' );
		if ( ! in_array( $level, $allowed, true ) ) {
			$level = 'info';
		}

		wc_get_logger()->log( $level, $message, array( 'source' => 'arrayfunnel' ) );
	}
}