<?php
/**
 * Request-scoped diagnostic metadata used by structured log records.
 *
 * @package admin-optimizer
 */

namespace Yipresser\AdminOptimizer\Support;

// Exit if accessed directly.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Captures request-scoped diagnostic metadata.
 */
final class AO_Request_Context {
	private static ?string $request_id = null;

	/**
	 * Get a stable, per-request random identifier, generated once and
	 * memoized for the life of the request.
	 *
	 * @return string
	 */
	public static function request_id(): string {
		if ( null === self::$request_id ) {
			try {
				self::$request_id = bin2hex( random_bytes( 16 ) );
			} catch ( \Throwable $exception ) {
				self::$request_id = substr( hash( 'sha256', uniqid( '', true ) ), 0, 32 );
			}
		}
		return self::$request_id;
	}

	/**
	 * Get the current WordPress user ID, or null when there is none.
	 *
	 * @return int|null
	 */
	public static function user_id(): ?int {
		$user_id = function_exists( 'get_current_user_id' ) ? (int) get_current_user_id() : 0;
		return $user_id > 0 ? $user_id : null;
	}

	/**
	 * Get the current request's sanitized path.
	 *
	 * @param AO_Log_Sanitizer $sanitizer Sanitizer used to clean the raw request URI.
	 *
	 * @return string|null
	 */
	public static function url( AO_Log_Sanitizer $sanitizer ): ?string {
		$uri = isset( $_SERVER['REQUEST_URI'] ) ? wp_unslash( (string) $_SERVER['REQUEST_URI'] ) : ''; // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized
		return $sanitizer->request_path( $uri );
	}
}