<?php

/**
 * Copyright 2024-2026 Simply.IN Sp. z o.o.
 *
 * NOTICE OF LICENSE
 *
 * Licensed under the EUPL-1.2 or later.
 * You may not use this work except in compliance with the Licence.
 *
 * Copy of the Licence is available at:
 * https://joinup.ec.europa.eu/software/page/eupl
 * It is bundled with this package in the file LICENSE.txt
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the Licence is distributed on an as is basis,
 * without warranties or conditions of any kind, either express or implied.
 * Check the Licence for the specific language governing permissions
 * and limitations under the License.
 *
 * @author   Simply.IN Sp. z o.o.
 * @copyright 2024-2026 Simply.IN Sp. z o.o.
 * @license   https://joinup.ec.europa.eu/software/page/eupl
 */

declare(strict_types=1);

namespace SimplyIn\BackOffice;

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

/**
 * Builds the actionable copy shown when the backend rejects an API key: names the merchant panel
 * matching the shop's selected environment and the exact domain this shop sends as its Origin —
 * both things the plugin already knows locally. Never echoes the raw backend response (translated
 * per language, unsafe to show verbatim in an admin UI) and never asks the merchant to sign
 * anything by hand — RSA registration is automatic.
 *
 * Pure and framework-free so it is unit-testable without a shop.
 */
final class ApiKeyRejectionMessage
{
    /**
     * @param string $translatedTemplate a translated string with three sprintf placeholders, in
     *                                   order: the environment label, its merchant panel URL, and
     *                                   the shop Origin
     */
    public static function build(string $translatedTemplate, Environment $environment, string $shopOrigin): string
    {
        return sprintf($translatedTemplate, $environment->label(), $environment->merchantPanelUrl(), $shopOrigin);
    }
}
