<?php
/**
 * NBH Performance global bootstrap helpers.
 *
 * Global functions are intentionally kept to a minimum. The REST wrapper
 * provides one consistent registration point without carrying legacy routes.
 *
 * @package NBHPerformance
 */

defined( 'ABSPATH' ) || exit;

if ( ! function_exists( 'nbh_performance_register_rest_route' ) ) {
	/**
	 * Register an NBH Performance REST route.
	 *
	 * @param string $rest_namespace REST namespace.
	 * @param string $route     Route path.
	 * @param array  $args      Route arguments.
	 * @param bool   $override  Whether to override an existing route.
	 * @return bool
	 */
	function nbh_performance_register_rest_route( $rest_namespace, $route, $args = array(), $override = false ) {
		return register_rest_route( $rest_namespace, $route, $args, $override );
	}
}


if ( ! function_exists( 'nbh_performance_validated_table_name' ) ) {
	/**
	 * Validate a known WordPress table or column identifier for WordPress 6.0+.
	 *
	 * WordPress 6.0 has no %i placeholder. All identifiers passed here are
	 * obtained from wpdb table properties or NBH-owned, prefix-based table
	 * names. A strict identifier character allowlist rejects SQL metacharacters.
	 * Values must still be passed through $wpdb->prepare() placeholders.
	 *
	 * @param string $identifier Table or column name.
	 * @return string Validated unquoted identifier; invalid identifiers fail closed.
	 */
	function nbh_performance_validated_table_name( $identifier ) {
		if ( ! is_string( $identifier ) || strlen( $identifier ) > 64 || ! preg_match( '/\A[A-Za-z0-9_]+\z/D', $identifier ) ) {
			return ''; // Deliberately produce invalid SQL rather than risk targeting a different table.
		}

		return $identifier;
	}
}