<?php
/**
* This file is part of the League.csv library
*
* @license http://opensource.org/licenses/MIT
* @link https://github.com/thephpleague/csv/
* @version 9.1.3
* @package League.csv
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
declare(strict_types=1);

namespace League\Csv;

/**
 * Thrown when a data is not added to the Csv Document
 *
 * @package League.csv
 * @since   9.0.0
 * @author  Ignace Nyamagana Butera <nyamsprod@gmail.com>
 */
class CannotInsertRecord extends Exception
{
    /**
     * The record submitted for insertion
     *
     * @var array
     */
    protected $record;

    /**
     * Validator which did not validated the data
     *
     * @var string
     */
    protected $name = '';

    /**
     * Create an Exception from a record insertion into a stream
     *
     * @param string[] $record
     *
     * @return self
     */
    public static function triggerOnInsertion(array $record): self
    {
        $exception = new static('Unable to write record to the CSV document');
        $exception->record = $record;

        return $exception;
    }

    /**
     * Create an Exception from a Record Validation
     *
     * @param string   $name   validator name
     * @param string[] $record invalid  data
     *
     * @return self
     */
    public static function triggerOnValidation(string $name, array $record): self
    {
        $exception = new static('Record validation failed');
        $exception->name = $name;
        $exception->record = $record;

        return $exception;
    }

    /**
     * return the validator name
     *
     * @return string
     */
    public function getName(): string
    {
        return $this->name;
    }

    /**
     * return the invalid data submitted
     *
     * @return array
     */
    public function getRecord(): array
    {
        return $this->record;
    }
}
