<?php
/**
 * Security sanitization and validation of data
 *
 * @package visual-portfolio
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Class Visual_Portfolio_Security
 */
class Visual_Portfolio_Security {
	/**
	 * Visual_Portfolio_Security constructor.
	 */
	public function __construct() {
		add_filter( 'wp_kses_allowed_html', array( $this, 'wp_kses_vp_popup' ), 9, 2 );
		add_filter( 'wp_kses_allowed_html', array( $this, 'wp_kses_vp_svg' ), 9, 2 );
		add_filter( 'wp_kses_allowed_html', array( $this, 'wp_kses_vp_image' ), 9, 2 );
	}

	/**
	 * Returns allowed HTML tags and attributes for Popup.
	 *
	 * @param string|array $allowedtags - Allow Tags for current context.
	 * @param string|array $context - tags context.
	 *
	 * @return array
	 */
	public function wp_kses_vp_popup( $allowedtags, $context ) {
		if ( 'vp_popup' === $context ) {
			$kses_defaults = wp_kses_allowed_html( 'post' );

			$kses_popup = array(
				'template' => array(
					'class'  => true,
					'style'  => true,

					// Most data for the popup is saved in the data attributes.
					'data-*' => true,
				),
				'div'      => array(
					'class'  => true,
					'style'  => true,

					// Most data for the popup is saved in the data attributes.
					'data-*' => true,
				),
			);

			return array_merge( $allowedtags, $kses_defaults, $kses_popup );
		}

		return $allowedtags;
	}

	/**
	 * Returns allowed HTML tags and attributes for Svg.
	 *
	 * @param string|array $allowedtags - Allow Tags for current context.
	 * @param string|array $context - tags context.
	 *
	 * @return array
	 */
	public function wp_kses_vp_svg( $allowedtags, $context ) {
		if ( 'vp_svg' === $context ) {
			$kses_svg_attrs = array(
				'x'               => true,
				'y'               => true,
				'd'               => true,
				'r'               => true,
				'width'           => true,
				'height'          => true,
				'rx'              => true,
				'cx'              => true,
				'cy'              => true,
				'stroke'          => true,
				'stroke-width'    => true,
				'fill'            => true,
				'transform'       => true,
				'stroke-linecap'  => true,
				'stroke-linejoin' => true,
			);

			$kses_svg = array(
				'svg'    => array(
					'class'           => true,
					'aria-hidden'     => true,
					'aria-labelledby' => true,
					'role'            => true,
					'xmlns'           => true,
					'width'           => true,
					'height'          => true,
					'viewbox'         => true,
				),
				'g'      => $kses_svg_attrs,
				'path'   => $kses_svg_attrs,
				'rect'   => $kses_svg_attrs,
				'circle' => $kses_svg_attrs,
				'title'  => array(
					'title' => true,
				),
			);

			return $kses_svg;
		}

		return $allowedtags;
	}

	/**
	 * Returns allowed HTML tags and attributes for Svg.
	 *
	 * @param string|array $allowedtags - Allow Tags for current context.
	 * @param string|array $context - tags context.
	 *
	 * @return array
	 */
	public function wp_kses_vp_image( $allowedtags, $context ) {
		if ( 'vp_image' === $context ) {
			$kses_image = array(
				'noscript'   => true,
				'img'        => array(
					'alt'      => true,
					'align'    => true,
					'border'   => true,
					'class'    => true,
					'height'   => true,
					'hspace'   => true,
					'loading'  => true,
					'longdesc' => true,
					'vspace'   => true,
					'src'      => true,
					'srcset'   => true,
					'sizes'    => true,
					'usemap'   => true,
					'width'    => true,

					// Lazy loading data is saved in the data attributes.
					'data-*'   => true,
				),
				'figure'     => array(
					'align'  => true,
				),
				'figcaption' => array(
					'align'  => true,
				),
			);

			return $kses_image;
		}

		return $allowedtags;
	}

	/**
	 * Sanitize hidden attribute.
	 *
	 * @param string|bool $attribute - Unclear Hidden Attribute.
	 * @return string|bool
	 */
	public static function sanitize_hidden( $attribute ) {
		$value = false;

		if ( is_bool( $attribute ) ) {
			$value = (bool) $attribute;
		} elseif ( is_string( $attribute ) ) {
			$value = strtolower( $attribute );
			if ( in_array( $value, array( 'false', '0' ), true ) ) {
				$value = false;
			}
			if ( in_array( $value, array( 'true', '1' ), true ) ) {
				$value = true;
			}

			$value = is_bool( $value ) ? (bool) $value : sanitize_text_field( wp_unslash( $attribute ) );
		}

		return $value;
	}

	/**
	 * Sanitize Boolean.
	 *
	 * @param string|bool $attribute - Unclear Boolean Attribute.
	 * @return bool
	 */
	public static function sanitize_boolean( $attribute ) {
		$value = false;

		if ( is_bool( $attribute ) ) {
			$value = (bool) $attribute;
		} elseif ( is_string( $attribute ) ) {
			$value = strtolower( $attribute );
			if ( in_array( $value, array( 'false', '0' ), true ) ) {
				$value = false;
			}
			if ( in_array( $value, array( 'true', '1' ), true ) ) {
				$value = true;
			}

			$value = (bool) wp_unslash( $value );
		}

		return $value;
	}

	/**
	 * Sanitize selector attribute.
	 *
	 * @param int|float|string $attribute - Unclear Selector Attribute.
	 * @param array            $control - Array of control parameters.
	 * @return int|float|string
	 */
	public static function sanitize_selector( $attribute, $control ) {
		/**
		 * Checking a selector for invalid options.
		 * Exclude multiple and dynamically callback selectors.
		 */
		if (
			empty( $control['value_callback'] ) &&
			! isset( $control['options'][ $attribute ] ) &&
			(
				// Additional check for bool and values 'true', 'false'.
				! is_bool( $attribute ) ||
				(
					is_bool( $attribute ) &&
					! isset( $control['options'][ $attribute ? 'true' : 'false' ] )
				)
			)
		) {
			$attribute = self::reset_control_attribute_to_default( $attribute, $control );
		}

		if ( is_numeric( $attribute ) ) {
			if ( false === strpos( $attribute, '.' ) ) {
				$attribute = intval( $attribute );
			} else {
				$attribute = (float) $attribute;
			}
		} else {
			$attribute = sanitize_text_field( wp_unslash( $attribute ) );
		}

		return $attribute;
	}

	/**
	 * Sanitize icons selector attribute.
	 *
	 * Icons selector options are usually provided as an indexed array where each
	 * option contains a `value` key, unlike regular select controls that may use
	 * associative options by key.
	 *
	 * @param int|float|string $attribute - Unclear Selector Attribute.
	 * @param array            $control - Array of control parameters.
	 * @return int|float|string
	 */
	public static function sanitize_icons_selector( $attribute, $control ) {
		$valid_options = array();

		if ( isset( $control['options'] ) && is_array( $control['options'] ) ) {
			foreach ( $control['options'] as $option_key => $option_data ) {
				if ( is_array( $option_data ) && isset( $option_data['value'] ) ) {
					$valid_options[] = (string) $option_data['value'];
				} else {
					$valid_options[] = (string) $option_key;
				}
			}
		}

		$attribute_string = is_bool( $attribute ) ? ( $attribute ? 'true' : 'false' ) : (string) $attribute;

		// Reject path traversal sequences regardless of control options state.
		if ( validate_file( $attribute_string ) !== 0 ) {
			$attribute = self::reset_control_attribute_to_default( $attribute, $control );
		}

		// Apply strict allowlist only when options are available.
		if ( ! empty( $valid_options ) && ! in_array( $attribute_string, $valid_options, true ) ) {
			$attribute = self::reset_control_attribute_to_default( $attribute, $control );
		}

		if ( is_numeric( $attribute ) ) {
			if ( false === strpos( $attribute, '.' ) ) {
				$attribute = intval( $attribute );
			} else {
				$attribute = (float) $attribute;
			}
		} else {
			$attribute = sanitize_text_field( wp_unslash( $attribute ) );
		}

		return $attribute;
	}

	/**
	 * Reset the value of the control attribute to the default value.
	 * Also check the attribute for a boolean value,
	 * And if the default value contains a string like 'true' or 'false',
	 * We reset the attribute to a boolean state
	 *
	 * @param int|float|string|bool $attribute - Attribute.
	 * @param array                 $control - Array of control parameters.
	 * @return int|float|string|bool
	 */
	public static function reset_control_attribute_to_default( $attribute, $control ) {
		if ( ! is_bool( $attribute ) ) {
			$attribute = $control['default'] ?? '';
		}

		if (
			is_bool( $attribute ) &&
			isset( $control['default'] ) &&
			'false' === $control['default']
		) {
			$attribute = false;
		}

		if (
			is_bool( $attribute ) &&
			isset( $control['default'] ) &&
			'true' === $control['default']
		) {
			$attribute = true;
		}

		return $attribute;
	}

	/**
	 * Sanitize number attribute.
	 *
	 * @param string|int|float $attribute - Unclear Number Attribute.
	 * @return int|float
	 */
	public static function sanitize_number( $attribute ) {
		$attribute = preg_replace( '/[^0-9.-]/', '', (string) wp_unslash( $attribute ) );

		// We should keep an empty string, because we allow resetting certain attributes.
		if ( '' === $attribute ) {
			$attribute = '';
		} elseif ( false === strpos( $attribute, '.' ) ) {
			$attribute = intval( $attribute );
		} else {
			$attribute = (float) $attribute;
		}

		return $attribute;
	}

	/**
	 * Sanitize Element Selector.
	 *
	 * @param array $attribute - Unclear Element Selector Attribute.
	 * @return array
	 */
	public static function sanitize_elements_selector( $attribute ) {
		$key = 'layout_elements';
		if ( ! empty( $attribute ) && is_array( $attribute ) ) {
			$controls                      = Visual_Portfolio_Controls::get_registered_array();
			$hight_level_allowed_locations = array_keys( $controls[ $key ]['locations'] );
			foreach ( $attribute as $locations_key => $locations ) {
				if (
					false !== array_search( $locations_key, $hight_level_allowed_locations, true ) &&
					! empty( $locations ) &&
					is_array( $locations )
				) {

					$low_level_allowed_locations = array( 'elements' );

					if (
						isset( $controls[ $key ]['locations'][ $locations_key ]['align'] ) &&
						! empty( $controls[ $key ]['locations'][ $locations_key ]['align'] )
					) {
						$low_level_allowed_locations = array_merge(
							$low_level_allowed_locations,
							array( 'align' )
						);
						$allowed_align_protocol      = $controls[ $key ]['locations'][ $locations_key ]['align'];
					}

					foreach ( $locations as $location_key => $location ) {
						if (
							false !== array_search( $location_key, $low_level_allowed_locations, true )
						) {
							if (
								'align' === $location_key &&
								isset( $allowed_align_protocol ) &&
								false !== array_search( $location, $allowed_align_protocol, true )
							) {
								$attribute[ $locations_key ][ $location_key ] = sanitize_text_field( wp_unslash( $location ) );
							} elseif (
								'elements' === $location_key &&
								is_array( $location )
							) {
								foreach ( $location as $item_key => $item ) {
									if (
										false !== array_search( $locations_key, $controls[ $key ]['options'][ $item ]['allowed_locations'], true ) &&
										isset( $controls[ $key ]['options'][ $item ]['allowed_locations'] )
									) {
										$attribute[ $locations_key ][ $location_key ][ $item_key ] = sanitize_text_field( wp_unslash( $item ) );
									} else {
										unset( $attribute[ $locations_key ][ $location_key ][ $item_key ] );
									}
								}
							} else {
								unset( $attribute[ $locations_key ][ $location_key ] );
							}
						} else {
							unset( $attribute[ $locations_key ][ $location_key ] );
						}
					}
				} else {
					unset( $attribute[ $locations_key ] );
				}
			}
		} else {
			$attribute = array();
		}

		return $attribute;
	}

	/**
	 * Sanitize Gallery.
	 *
	 * @param array $attribute - Unclear Gallery Attribute.
	 * @return array
	 */
	public static function sanitize_gallery( $attribute ) {
		if ( isset( $attribute ) && ! empty( $attribute ) ) {
			foreach ( $attribute as $key => $gallery_item ) {
				if ( isset( $gallery_item ) && ! empty( $gallery_item ) ) {
					foreach ( $gallery_item as $attribute_key => $media_attribute ) {
						switch ( $attribute_key ) {
							case 'imgUrl':
							case 'imgThumbnailUrl':
							case 'video_url':
							case 'author_url':
							case 'post_url':
							case 'url':
								$attribute[ $key ][ $attribute_key ] = esc_url_raw( wp_unslash( $media_attribute ) );
								break;
							case 'hover_image_focal_point':
							case 'focalPoint':
								if ( isset( $media_attribute ) && ! empty( $media_attribute ) ) {
									foreach ( $media_attribute as $focal_key => $focal_point ) {
										$attribute[ $key ][ $attribute_key ][ $focal_key ] = self::sanitize_number( $focal_point );
									}
								} else {
									$attribute[ $key ][ $attribute_key ] = null;
								}
								break;
							case 'id':
							case 'custom_popup_image':
							case 'hover_image':
								$attribute[ $key ][ $attribute_key ] = self::sanitize_number( $media_attribute );
								break;
							case 'categories':
								if ( isset( $media_attribute ) && ! empty( $media_attribute ) ) {
									foreach ( $media_attribute as $category_key => $category ) {
										$attribute[ $key ][ $attribute_key ][ $category_key ] = sanitize_text_field( wp_unslash( $category ) );
									}
								} else {
									$attribute[ $key ][ $attribute_key ] = null;
								}
								break;
							case 'alt':
								$attribute[ $key ][ $attribute_key ] = sanitize_text_field( wp_unslash( $media_attribute ) );
								break;
							case 'title':
							case 'description':
								$attribute[ $key ][ $attribute_key ] = wp_kses_post( wp_unslash( $media_attribute ) );
								break;
							case 'author':
							case 'format':
							case 'deep_link_pid':
							default:
								$attribute[ $key ][ $attribute_key ] = sanitize_text_field( wp_unslash( $media_attribute ) );
								break;
						}
					}
				}
			}
		} else {
			$attribute = array();
		}
		return $attribute;
	}

	/**
	 * Sanitize Attributes.
	 *
	 * @param array $attributes - Attributes.
	 * @return array
	 */
	public static function sanitize_attributes( $attributes = array() ) {
		if ( ! empty( $attributes ) ) {
			$controls = Visual_Portfolio_Controls::get_registered_array();
			foreach ( $attributes as $key => $attribute ) {
				if ( 0 === strpos( $key, 'vp_' ) ) {
					$key                = preg_replace( '/^vp_/', '', $key );
					$mode               = 'preview';
					$attributes[ $key ] = $attribute;
					unset( $attributes[ 'vp_' . $key ] );
				}
				$sanitize_callback = $controls[ $key ]['sanitize_callback'] ?? false;
				if ( $sanitize_callback ) {
					$finding_class = is_string( $sanitize_callback ) && strripos( $sanitize_callback, '::' );

					if ( false === $finding_class && is_callable( array( __CLASS__, $sanitize_callback ) ) ) {
						$attributes[ $key ] = call_user_func( array( __CLASS__, $sanitize_callback ), $attribute );
					} else {
						$attributes[ $key ] = call_user_func( $sanitize_callback, $attribute );
					}
				} else {
					$type = $controls[ $key ]['type'] ?? false;
					switch ( $type ) {
						case 'hidden':
						case 'checkbox':
							$attributes[ $key ] = self::sanitize_hidden( $attribute );
							break;
						case 'icons_selector':
							// Layer 2: Validate against allowed options (same as 'select' type).
							$attributes[ $key ] = self::sanitize_icons_selector( $attributes[ $key ], $controls[ $key ] );
							break;
						case 'text':
						case 'radio':
						case 'align':
						case 'buttons':
							$attributes[ $key ] = sanitize_text_field( wp_unslash( $attribute ) );
							break;
						case 'textarea':
							$attributes[ $key ] = sanitize_textarea_field( wp_unslash( $attribute ) );
							break;
						case 'aspect_ratio':
							$attributes[ $key ] = preg_replace( '/[^0-9:]/', '', wp_unslash( $attribute ) );
							break;
						case 'number':
						case 'range':
							$attributes[ $key ] = self::sanitize_number( $attribute );
							break;
						case 'tiles_selector':
							$attributes[ $key ] = preg_replace( '/[^0-9.,|]/', '', wp_unslash( $attribute ) );
							break;
						case 'select':
							$multiple = isset( $controls[ $key ]['multiple'] ) && ! empty( $controls[ $key ]['multiple'] ) ? $controls[ $key ]['multiple'] : false;

							if ( $multiple ) {
								$attributes[ $key ] = $attributes[ $key ] ?? $controls[ $key ]['default'] ?? array();

								if ( is_array( $attributes[ $key ] ) && ! empty( $attributes[ $key ] ) ) {
									foreach ( $attributes[ $key ] as $attribute_key => $value ) {
										$attributes[ $key ][ $attribute_key ] = self::sanitize_selector( $value, $controls[ $key ] );
									}
								}
							} else {
								$attributes[ $key ] = self::sanitize_selector( $attributes[ $key ], $controls[ $key ] );
							}
							break;
						case 'elements_selector':
							$attributes[ $key ] = self::sanitize_elements_selector( $attribute );
							break;
						case 'code_editor':
							// Clear CSS. Maybe there will be an SVG validation error.
							$attributes[ $key ] = preg_replace( '#</?\w+#', '', wp_unslash( $attribute ) );
							break;
						case 'sortable':
							if ( is_array( $attribute ) && ! empty( $attribute ) ) {
								foreach ( $attribute as $attribute_key => $value ) {
									$attributes[ $key ][ $attribute_key ] = sanitize_text_field( wp_unslash( $value ) );
								}
							} else {
								$attributes[ $key ] = array();
							}
							break;
						case 'gallery':
							$attributes[ $key ] = self::sanitize_gallery( $attribute );
							break;
						case false:
							if ( 'block_id' === $key ) {
								$attributes[ $key ] = preg_replace( '/[^a-zA-Z0-9_-]/', '', wp_unslash( $attribute ) );
							} else {
								$attributes[ $key ] = sanitize_text_field( wp_unslash( $attribute ) );
							}
							break;
						default:
							$attributes[ $key ] = sanitize_text_field( wp_unslash( $attribute ) );
							break;
					}

					// fix bool values.
					if ( 'false' === $attributes[ $key ] ) {
						$attributes[ $key ] = false;
					}
					if ( 'true' === $attributes[ $key ] ) {
						$attributes[ $key ] = true;
					}
				}
			}

			if ( isset( $mode ) && 'preview' === $mode ) {
				foreach ( $attributes as $key => $attribute ) {
					$attributes[ 'vp_' . $key ] = $attribute;
					unset( $attributes[ $key ] );
				}
			}
		}
		return $attributes;
	}

	/**
	 * Get allowed parameters configuration
	 */
	private static function get_allowed_params_config() {
		return array(
			'align'                       => 'string',
			'anchor'                      => 'string',
			'block_id'                    => 'string',
			'className'                   => 'string',
			// Modern attributes.
			'queryType'                   => array( 'string', '' ),
			'baseQuery'                   => array( 'array', array() ),
			'postsQuery'                  => array( 'array', array() ),
			'imagesQuery'                 => array( 'array', array() ),
			// Legacy attributes.
			'content_source'              => array( 'string', '' ),
			'custom_css'                  => array( 'string', '' ),
			'image_categories'            => array( 'array', array() ),
			'images'                      => array( 'array', array() ),
			'images_descriptions_source'  => array( 'string', 'custom' ),
			'images_order_by'             => array( 'string', 'default' ),
			'images_order_direction'      => array( 'string', 'asc' ),
			'images_titles_source'        => array( 'string', 'custom' ),
			'items_count'                 => array( 'number', 6 ),
			'post_types_set'              => array( 'array', array( 'post' ) ),
			'posts_avoid_duplicate_posts' => array( 'boolean', false ),
			'posts_custom_query'          => array( 'string', '' ),
			'posts_excluded_ids'          => array( 'array', array() ),
			'posts_ids'                   => array( 'array', array() ),
			'posts_offset'                => 'number',
			'posts_order_by'              => array( 'string', 'post_date' ),
			'posts_order_direction'       => array( 'string', 'desc' ),
			'posts_source'                => array( 'string', 'portfolio' ),
			'posts_taxonomies'            => array( 'array', array() ),
			'posts_taxonomies_relation'   => array( 'string', 'or' ),
			'preview_image_example'       => array( 'string', '' ),
			'setup_wizard'                => array( 'string', '' ),
			'sort'                        => array( 'string', 'dropdown' ),
			'stretch'                     => array( 'boolean', false ),
		);
	}

	/**
	 * Validate and filter parameters for calculate_max_pages function with type checking.
	 *
	 * @param array $params - Raw input parameters that may contain invalid keys or wrong types.
	 * @return array
	 */
	public static function validate_calculate_max_pages_params( $params ) {
		$allowed_params  = self::get_allowed_params_config();
		$filtered_params = array();

		foreach ( $params as $key => $value ) {
			if ( ! isset( $allowed_params[ $key ] ) ) {
				continue;
			}

			$config  = $allowed_params[ $key ];
			$type    = is_array( $config ) ? $config[0] : $config;
			$default = is_array( $config ) && isset( $config[1] ) ? $config[1] : null;

			switch ( $type ) {
				case 'string':
					$validated_value = is_scalar( $value ) ? (string) $value : $default;
					break;
				case 'number':
					$validated_value = is_numeric( $value ) ? ( is_float( $value ) ? (float) $value : (int) $value ) : $default;
					break;
				case 'boolean':
					$validated_value = is_bool( $value ) ? $value : ( is_numeric( $value ) ? (bool) $value : $default );
					break;
				case 'array':
					$validated_value = is_array( $value ) ? $value : (
						is_string( $value ) && strpos( $value, '[' ) === 0 ?
							( json_decode( $value, true ) ? json_decode( $value, true ) : $default ) :
							( null !== $default ? $default : array() )
					);
					break;
				default:
					$validated_value = $default;
					break;
			}

			if ( null !== $validated_value || null !== $default ) {
				$filtered_params[ $key ] = $validated_value;
			}
		}

		return $filtered_params;
	}
}
new Visual_Portfolio_Security();
