<?php

declare(strict_types=1);

namespace Beyondwords\Wordpress\Component\Post;

use Beyondwords\Wordpress\Component\Post\GenerateAudio\GenerateAudio;
use Beyondwords\Wordpress\Component\Settings\Fields\IntegrationMethod\IntegrationMethod;
use Beyondwords\Wordpress\Component\Settings\Fields\PlayerStyle\PlayerStyle;
use Beyondwords\Wordpress\Core\CoreUtils;

/**
 * BeyondWords Post Meta (Custom Field) Utilities.
 *
 * @package    Beyondwords
 * @subpackage Beyondwords/includes
 * @author     Stuart McAlpine <stu@beyondwords.io>
 * @since      3.5.0
 */
class PostMetaUtils
{
    public const WP_ERROR_FORMAT = 'WP_Error [%s] %s';

    /**
     * Get "renamed" Post Meta.
     *
     * We previously saved custom fields with a prefix of `speechkit_*` and we now
     * save them with a prefix of `beyondwords_*`.
     *
     * This method checks both prefixes, copying `speechkit_*` data to `beyondwords_*`.
     *
     * @since 3.7.0
     *
     * @param int    $postId Post ID.
     * @param string $name   Custom field name, without the prefix.
     *
     * @return string
     */
    public static function getRenamedPostMeta(int $postId, string $name): mixed
    {
        if (metadata_exists('post', $postId, 'beyondwords_' . $name)) {
            return get_post_meta($postId, 'beyondwords_' . $name, true);
        }

        if (metadata_exists('post', $postId, 'speechkit_' . $name)) {
            $value = get_post_meta($postId, 'speechkit_' . $name, true);

            // Migrate over to newer `beyondwords_*` format
            update_post_meta($postId, 'beyondwords_' . $name, $value);

            return $value;
        }

        return '';
    }

    /**
     * Get the BeyondWords metadata for a Post.
     *
     * @since 4.1.0 Append 'beyondwords_version' and 'wordpress_version'.
     */
    public static function getAllBeyondwordsMetadata(int $postId): array
    {
        global $wp_version;

        $keysToCheck = CoreUtils::getPostMetaKeys('all');

        $metadata = has_meta($postId);

        $metadata = array_filter($metadata, fn($item) => in_array($item['meta_key'], $keysToCheck));

        // Prepend the WordPress Post ID to the meta data
        // phpcs:disable WordPress.DB.SlowDBQuery
        array_push(
            $metadata,
            [
                'meta_id'    => null,
                'meta_key'   => 'beyondwords_version',
                'meta_value' => BEYONDWORDS__PLUGIN_VERSION,
            ],
            [
                'meta_id'    => null,
                'meta_key'   => 'wordpress_version',
                'meta_value' => $wp_version,
            ],
            [
                'meta_id'    => null,
                'meta_key'   => 'wordpress_post_id',
                'meta_value' => $postId,
            ],
        );
        // phpcs:enable WordPress.DB.SlowDBQuery

        return $metadata;
    }

    /**
     * Remove the BeyondWords metadata for a Post.
     *
     * @param int $postId Post ID.
     *
     * @since 4.x   Introduced.
     * @since 6.0.1 Use CoreUtils::getPostMetaKeys() to get all keys.
     */
    public static function removeAllBeyondwordsMetadata(int $postId): void
    {
        $keys = CoreUtils::getPostMetaKeys('all');

        foreach ($keys as $key) {
            delete_post_meta($postId, $key, null);
        }
    }

    /**
     * Check if a Post should have BeyondWords content (a Content entity in BeyondWords).
     *
     * @since 6.0.0 Introduced.
     *
     * @param int $postId Post ID.
     *
     * @return bool True if the post should have BeyondWords content, false otherwise.
     */
    public static function hasContent(int $postId): bool
    {
        $contentId         = PostMetaUtils::getContentId($postId);
        $integrationMethod = get_post_meta($postId, 'beyondwords_integration_method', true);

        // If the integration method is not set, we assume REST API for legacy compatibility.
        if (empty($integrationMethod)) {
            $integrationMethod = IntegrationMethod::REST_API;
        }

        if (IntegrationMethod::REST_API === $integrationMethod && ! empty($contentId)) {
            return true;
        }

        // Get the project ID for the post (do not use the plugin setting).
        $projectId = PostMetaUtils::getProjectId($postId, true);

        if (IntegrationMethod::CLIENT_SIDE === $integrationMethod && ! empty($projectId)) {
            return true;
        }

        return false;
    }

    /**
     * Get the Content ID for a WordPress Post.
     *
     * Over time there have been various approaches to storing the Content ID.
     * This function tries each approach in reverse-date order.
     *
     * @since 3.0.0
     * @since 3.5.0 Moved from Core\Utils to Component\Post\PostUtils
     * @since 4.0.0 Renamed to getContentId() & prioritise beyondwords_content_id
     * @since 5.0.0 Remove beyondwords_content_id filter.
     * @since 6.0.0 Add fallback parameter to allow falling back to Post ID.
     *
     * @param int  $postId Post ID.
     * @param bool $fallback If true, will fall back to the Post ID if no Content ID is found.
     *
     * @return string|false Content ID, or false
     */
    public static function getContentId(int $postId, bool $fallback = false): string|int|false
    {
        $contentId = get_post_meta($postId, 'beyondwords_content_id', true);
        if (! empty($contentId)) {
            return $contentId;
        }

        $podcastId = PostMetaUtils::getPodcastId($postId);
        if (! empty($podcastId)) {
            return $podcastId;
        }

        if ($fallback) {
            return (string) $postId;
        }

        return false;
    }

    /**
     * Get the (legacy) Podcast ID for a WordPress Post.
     *
     * Over time there have been various approaches to storing the Podcast ID.
     * This function tries each approach in reverse-date order.
     *
     * @since 3.0.0
     * @since 3.5.0 Moved from Core\Utils to Component\Post\PostUtils
     * @since 4.0.0 Allow string values for UUIDs stored >= v4.x
     *
     * @param int $postId Post ID.
     *
     * @return int|false Podcast ID, or false
     */
    public static function getPodcastId(int $postId): string|int|false
    {
        // Check for "Podcast ID" custom field (number, or string for > 4.x)
        $podcastId = PostMetaUtils::getRenamedPostMeta($postId, 'podcast_id');

        if ($podcastId) {
            return $podcastId;
        }

        // It may also be found by parsing post_meta._speechkit_link
        $speechkit_link = get_post_meta($postId, '_speechkit_link', true);
        // Player URL can be either /a/[ID] or /e/[ID] or /m/[ID]
        preg_match('/\/[aem]\/(\d+)/', (string)$speechkit_link, $matches);
        if ($matches) {
            return intval($matches[1]);
        }

        // It may also be found by parsing post_meta.speechkit_response
        $speechkit_response = self::getHttpResponseBodyFromPostMeta($postId, 'speechkit_response');
        preg_match('/"podcast_id":(")?(\d+)(?(1)\1|)/', (string)$speechkit_response, $matches);
        // $matches[2] is the Podcast ID (response.podcast_id)
        if ($matches && $matches[2]) {
            return intval($matches[2]);
        }

        /**
         * It may also be found by parsing post_meta.speechkit_info
         *
         * NOTE: This has been copied verbatim from the existing iframe player check
         *       at Speechkit_Public::iframe_player_embed_html(), in case it is
         *       needed for posts which were created a very long time ago.
         *       I cannot write unit tests for this to pass, they always fail for me,
         *       so there are currently no tests for it.
         **/
        $article = get_post_meta($postId, 'speechkit_info', true);
        if (empty($article) || ! isset($article['share_url'])) {
            // This is exactly the same if/else statement that we have at
            // Speechkit_Public::iframe_player_embed_html(), but there is
            // nothing for us to to do here.
        } else {
            // This is the part that we need...
            $url = $article['share_url'];

            // Player URL can be either /a/[ID] or /e/[ID] or /m/[ID]
            preg_match('/\/[aem]\/(\d+)/', (string)$url, $matches);
            if ($matches) {
                return intval($matches[1]);
            }
        }

        // todo throw ContentIdNotFoundException???

        return false;
    }

    /**
     * Get the BeyondWords preview token for a WordPress Post.
     *
     * The preview token allows us to play audio that has a future scheduled
     * publish date, so we can preview the audio in WordPress admin before it
     * is published.
     *
     * The token is supplied by the BeyondWords REST API whenever audio content
     * is created/updated, and stored in a WordPress custom field.
     *
     * @since 4.5.0
     *
     * @param int $postId Post ID.
     *
     * @return string Preview token
     */
    public static function getPreviewToken(int $postId): string|false
    {
        $previewToken = get_post_meta($postId, 'beyondwords_preview_token', true);

        return $previewToken ?: false;
    }

    /**
     * Get the 'Generate Audio' value for a Post.
     *
     * @since 3.0.0
     * @since 3.5.0 Moved from Core\Utils to Component\Post\PostUtils
     * @since 6.0.0 Add Magic Embed support.
     *
     * @param int $postId Post ID.
     */
    public static function hasGenerateAudio(int $postId): bool
    {
        $generateAudio = PostMetaUtils::getRenamedPostMeta($postId, 'generate_audio');

        // Checkbox was checked.
        if ($generateAudio === '1') {
            return true;
        }

        // Checkbox was unchecked.
        if ($generateAudio === '0') {
            return false;
        }

        return GenerateAudio::shouldPreselectGenerateAudio($postId);
    }

    /**
     * Get the Project ID for a WordPress Post.
     *
     * It is possible to change the BeyondWords project ID in the plugin settings,
     * so the current Project ID setting will not necessarily be correct for all
     * historic Posts. Because of this, we attempt to retrive the correct Project ID
     * from various custom fields, then fall-back to the plugin setting.
     *
     * @since 3.0.0
     * @since 3.5.0 Moved from Core\Utils to Component\Post\PostUtils
     * @since 4.0.0 Apply beyondwords_project_id filter
     * @since 5.0.0 Remove beyondwords_project_id filter.
     * @since 6.0.0 Support Magic Embed and add strict mode.
     *
     * @param int  $postId Post ID.
     * @param bool $strict Strict mode, which only checks the custom field. Defaults to false.
     *
     * @return int|false Project ID, or false
     */
    public static function getProjectId(int $postId, bool $strict = false): int|string|false
    {
        // If strict is true, we only check the custom field and do not fall back to the plugin setting.
        if ($strict) {
            return PostMetaUtils::getRenamedPostMeta($postId, 'project_id');
        }

        // Check the post custom field.
        $postMeta = intval(PostMetaUtils::getRenamedPostMeta($postId, 'project_id'));

        if (! empty($postMeta)) {
            return $postMeta;
        }

        // Parse post_meta.speechkit_response, if available.
        $speechkit_response = self::getHttpResponseBodyFromPostMeta($postId, 'speechkit_response');

        preg_match('/"project_id":(")?(\d+)(?(1)\1|)/', (string)$speechkit_response, $matches);

        // $matches[2] is the Project ID (response.project_id)
        if ($matches && $matches[2]) {
            return intval($matches[2]);
        }

        // Check the plugin setting.
        $setting = get_option('beyondwords_project_id');

        if ($setting) {
            return intval($setting);
        }

        // todo throw ProjectIdNotFoundException?

        return false;
    }

    /**
     * Get the Body Voice ID for a WordPress Post.
     *
     * We do not filter this, because the Block Editor directly accesses this
     * custom field, bypassing any filters we add here.
     *
     * @since 4.0.0
     *
     * @param int $postId Post ID.
     *
     * @return int|false Body Voice ID, or false
     */
    public static function getBodyVoiceId(int $postId): int|string|false
    {
        $voiceId = get_post_meta($postId, 'beyondwords_body_voice_id', true);

        return $voiceId ?: false;
    }

    /**
     * Get the Title Voice ID for a WordPress Post.
     *
     * We do not filter this, because the Block Editor directly accesses this
     * custom field, bypassing any filters we add here.
     *
     * @since 4.0.0
     *
     * @param int $postId Post ID.
     *
     * @return int|false Title Voice ID, or false
     */
    public static function getTitleVoiceId(int $postId): int|string|false
    {
        $voiceId = get_post_meta($postId, 'beyondwords_title_voice_id', true);

        return $voiceId ?: false;
    }

    /**
     * Get the Summary Voice ID for a WordPress Post.
     *
     * We do not filter this, because the Block Editor directly accesses this
     * custom field, bypassing any filters we add here.
     *
     * @since 4.0.0
     *
     * @param int $postId Post ID.
     *
     * @return int|false Summary Voice ID, or false
     */
    public static function getSummaryVoiceId(int $postId): int|string|false
    {
        $voiceId = get_post_meta($postId, 'beyondwords_summary_voice_id', true);

        return $voiceId ?: false;
    }

    /**
     * Get the player style for a post.
     *
     * Defaults to the plugin setting if the custom field doesn't exist.
     *
     * @since 4.1.0
     *
     * @param int $postId Post ID.
     *
     * @return string Player style.
     */
    public static function getPlayerStyle(int $postId): string
    {
        $playerStyle = get_post_meta($postId, 'beyondwords_player_style', true);

        // Prefer custom field
        if ($playerStyle) {
            return $playerStyle;
        }

        // Fall back to plugin setting
        return get_option('beyondwords_player_style', PlayerStyle::STANDARD);
    }

    /**
     * Get the "Error Message" value for a WordPress Post.
     *
     * Supports data saved with the `beyondwords_*` prefix and the legacy `speechkit_*` prefix.
     *
     * @since 3.7.0
     *
     * @param int $postId Post ID.
     *
     * @return string
     */
    public static function getErrorMessage(int $postId): string|false
    {
        return PostMetaUtils::getRenamedPostMeta($postId, 'error_message');
    }

    /**
     * Get the "Disabled" value for a WordPress Post.
     *
     * Supports data saved with the `beyondwords_*` prefix and the legacy `speechkit_*` prefix.
     *
     * @since 3.7.0
     *
     * @param int $postId Post ID.
     */
    public static function getDisabled(int $postId): bool
    {
        return (bool) PostMetaUtils::getRenamedPostMeta($postId, 'disabled');
    }

    /**
     * Get HTTP response body from post meta.
     *
     * The data may have been saved as a WordPress HTTP response array. If it was,
     * then return the 'body' key of the HTTP response instead of the raw post meta.
     *
     * The data may also have been saved as a WordPress WP_Error instance. If it was,
     * then return a string containing the WP_Error code and message.
     *
     * @since 3.0.3
     * @since 3.5.0 Moved from Core\Utils to Component\Post\PostUtils
     * @since 3.6.1 Handle responses saved as object of class WP_Error
     *
     * @param int    $postId   Post ID.
     * @param string $metaName Post Meta name.
     *
     * @return string
     */
    public static function getHttpResponseBodyFromPostMeta(int $postId, string $metaName): array|string|false
    {
        $postMeta = get_post_meta($postId, $metaName, true);

        if (is_array($postMeta)) {
            return (string)wp_remote_retrieve_body($postMeta);
        }

        if (is_wp_error($postMeta)) {
            return sprintf(PostMetaUtils::WP_ERROR_FORMAT, $postMeta::get_error_code(), $postMeta::get_error_message());
        }

        return (string)$postMeta;
    }
}