<?php
/**
 * What a destination tells the sender about a file it could not write.
 *
 * @package Shiftora\Api\Support
 */

declare(strict_types=1);

namespace Shiftora\Api\Support;

use Shiftora\Migration\FileRefusedException;

// Prevent direct file access.
if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * An exception message carries absolute paths, so the sender gets a short reason code and a fixed
 * sentence instead, and the detail goes to the server log. `refused` is the one the sender skips; every
 * other reason fails the file, as before.
 */
final class WriteFailure {

	/** What a sender is told when the destination refuses a path by rule; the sender recognises it and skips the file. */
	public const REFUSED_MESSAGE = 'This file is not allowed here.';

	/** What the sender is told for each reason. */
	public const MESSAGES = [
		'refused'   => self::REFUSED_MESSAGE,
		'integrity' => 'The file did not match its hash.',
		'encoding'  => 'The file data could not be read.',
		'offset'    => 'The transfer is out of step. Restart this file.',
		'write'     => 'The file could not be written.',
	];

	public static function reason( \Throwable $e ): string {
		$message = $e->getMessage();

		return match ( true ) {
			$e instanceof FileRefusedException => 'refused',
			str_contains( $message, 'integrity check' ) => 'integrity',
			str_contains( $message, 'Base64' ) || str_contains( $message, 'Gzip' ) => 'encoding',
			str_contains( $message, 'Transfer offset' ) || str_contains( $message, 'Transfer state' ) => 'offset',
			default => 'write',
		};
	}

	public static function message( string $reason ): string {
		return self::MESSAGES[ $reason ] ?? self::MESSAGES['write'];
	}
}