<?php
/**
 * Table name resolver.
 *
 * @package HostKhata
 */

namespace HostKhata\Database;

defined( 'ABSPATH' ) || exit;

use InvalidArgumentException;

/**
 * Resolves short table keys to full, prefixed table names.
 *
 * Only keys defined in {@see Schema::keys()} are accepted, which keeps table
 * names that end up in SQL strings under the plugin's control.
 *
 * @since 0.1.0
 */
final class Tables {

	/**
	 * Returns the full table name for a key.
	 *
	 * @since 0.1.0
	 *
	 * @param string $key Short table key, e.g. `customers`.
	 * @return string
	 *
	 * @throws InvalidArgumentException For an unknown key.
	 */
	public static function name( string $key ): string {
		if ( ! in_array( $key, Schema::keys(), true ) ) {
			throw new InvalidArgumentException( 'Unknown HostKhata table key.' ); // phpcs:ignore WordPress.Security.EscapeOutput.ExceptionNotEscaped
		}

		return $GLOBALS['wpdb']->prefix . 'hostkhata_' . $key;
	}

	/**
	 * Returns every table name, keyed by short key.
	 *
	 * @since 0.1.0
	 *
	 * @return array<string, string>
	 */
	public static function all(): array {
		$tables = array();

		foreach ( Schema::keys() as $key ) {
			$tables[ $key ] = self::name( $key );
		}

		return $tables;
	}
}