// SPDX-License-Identifier: UNLICENSED
pragma solidity ^0.8.24;

import "./RulesEngineClient.sol";

/**
 * @title Rules Engine Client ERC721
 * @dev Abstract contract containing modifiers and functions for integrating ERC721 token operations with the Rules Engine.
 *      This contract provides policy checks for `safeMint`, `transferFrom`, and `safeTransferFrom` operations, both before and after execution.
 * @notice This contract is intended to be inherited and implemented by ERC721 token contracts requiring Rules Engine integration.
 * @author @mpetersoCode55, @ShaneDuncan602, @TJ-Everett, @VoR0220
 */
abstract contract RulesEngineClientERC721 is RulesEngineClient {
    /**
     * @notice Modifier for checking policies before executing the `safeMint` function.
     * @dev Calls the `_checkPoliciesERC721SafeMint` function to evaluate policies.
     * @param to The receiving address.
     */
    modifier checksPoliciesERC721SafeMintBefore(address to) {
        _checkPoliciesERC721SafeMint(to);
        _;
    }

    /**
     * @notice Modifier for checking policies after executing the `safeMint` function.
     * @dev Calls the `_checkPoliciesERC721SafeMint` function to evaluate policies.
     * @param to The receiving address.
     */
    modifier checksPoliciesERC721SafeMintAfter(address to) {
        _;
        _checkPoliciesERC721SafeMint(to);
    }

    /**
     * @notice Modifier for checking policies before executing the `safeTransferFrom` function.
     * @dev Calls the `_checkPoliciesERC721SafeTransferFrom` function to evaluate policies.
     * @param from The sending address.
     * @param to The receiving address.
     * @param tokenId The token identifier.
     * @param data Generic data to pass along with the transfer.
     */
    modifier checksPoliciesERC721SafeTransferFromBefore(
        address from,
        address to,
        uint256 tokenId,
        bytes memory data
    ) {
        _checkPoliciesERC721SafeTransferFrom(from, to, tokenId, data);
        _;
    }

    /**
     * @notice Modifier for checking policies after executing the `safeTransferFrom` function.
     * @dev Calls the `_checkPoliciesERC721SafeTransferFrom` function to evaluate policies.
     * @param from The sending address.
     * @param to The receiving address.
     * @param tokenId The token identifier.
     * @param data Generic data to pass along with the transfer.
     */
    modifier checksPoliciesERC721SafeTransferFromAfter(
        address from,
        address to,
        uint256 tokenId,
        bytes memory data
    ) {
        _;
        _checkPoliciesERC721SafeTransferFrom(from, to, tokenId, data);
    }

    /**
     * @notice Modifier for checking policies before executing the `transferFrom` function.
     * @dev Calls the `_checkPoliciesERC721TransferFrom` function to evaluate policies.
     * @param from The sending address.
     * @param to The receiving address.
     * @param tokenId The token identifier.
     */
    modifier checksPoliciesERC721TransferFromBefore(
        address from,
        address to,
        uint256 tokenId
    ) {
        _checkPoliciesERC721TransferFrom(from, to, tokenId);
        _;
    }

    /**
     * @notice Modifier for checking policies after executing the `transferFrom` function.
     * @dev Calls the `_checkPoliciesERC721TransferFrom` function to evaluate policies.
     * @param from The sending address.
     * @param to The receiving address.
     * @param tokenId The token identifier.
     */
    modifier checksPoliciesERC721TransferFromAfter(
        address from,
        address to,
        uint256 tokenId
    ) {
        _;
        _checkPoliciesERC721TransferFrom(from, to, tokenId);
    }

    /**
     * @notice Calls the Rules Engine to evaluate policies for an ERC721 `safeMint` operation.
     * @dev Encodes the parameters and invokes the `_invokeRulesEngine` function.
     * @param _to The receiving address.
     */
    function _checkPoliciesERC721SafeMint(address _to) internal {
        bytes memory encoded = abi.encodeWithSelector(msg.sig, _to, msg.sender);
        _invokeRulesEngine(encoded);
    }

    /**
     * @notice Calls the Rules Engine to evaluate policies for an ERC721 `safeTransferFrom` operation.
     * @dev Encodes the parameters and invokes the `_invokeRulesEngine` function.
     * @param _from The sending address.
     * @param _to The receiving address.
     * @param _tokenId The token identifier.
     * @param _data Generic data to pass along with the transfer.
     */
    function _checkPoliciesERC721SafeTransferFrom(address _from, address _to, uint256 _tokenId, bytes memory _data) internal {
        bytes memory encoded = abi.encodeWithSelector(msg.sig, _from, _to, _tokenId, _data, msg.sender);
        _invokeRulesEngine(encoded);
    }

    /**
     * @notice Calls the Rules Engine to evaluate policies for an ERC721 `transferFrom` operation.
     * @dev Encodes the parameters and invokes the `_invokeRulesEngine` function.
     * @param _from The sending address.
     * @param _to The receiving address.
     * @param _tokenId The token identifier.
     */
    function _checkPoliciesERC721TransferFrom(address _from, address _to, uint256 _tokenId) internal {
        bytes memory encoded = abi.encodeWithSelector(msg.sig, _from, _to, _tokenId, msg.sender);
        _invokeRulesEngine(encoded);
    }
}