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

import { ITokenErrors } from "./ITokenErrors.sol";

interface IERC1155Freezable is ITokenErrors {
    error InsufficientUnfrozenBalance(address owner, uint256 tokenId, uint256 available, uint256 required);
    error FreezeRecordNotFound(uint256 recordId);
    error FreezeRecordNotExpired(uint256 recordId, uint48 expiresAt);

    event TokensFrozen(
        address indexed owner,
        uint256 indexed recordId,
        uint256 indexed tokenId,
        uint256 amount,
        uint48 expiresAt
    );
    event TokensThawed(address indexed owner, uint256 indexed recordId, uint256 indexed tokenId, uint256 amount);

    /**
     * @dev Freezes an amount of tokens for a given duration. Frozen tokens cannot be transferred or burned.
     */
    function freeze(
        address _owner,
        uint256 _tokenId,
        uint256 _amount,
        uint48 _freezeDuration
    ) external returns (uint256 recordId);

    /**
     * @dev Thaws tokens that have expired freeze durations.
     */
    function thaw(uint256[] memory _recordIds) external;

    /**
     * @dev Returns the number of frozen tokens in ``owner``'s account for a given tokenId.
     */
    function frozenBalanceOf(address _owner, uint256 _tokenId) external view returns (uint256 frozenBalance);

    /**
     * @dev Returns the number of unfrozen tokens in ``owner``'s account for a given tokenId.
     */
    function unfrozenBalanceOf(address _owner, uint256 _tokenId) external view returns (uint256 unfrozenBalance);

    /**
     * @dev Returns the number of frozen tokens in ``owner``'s account.
     */
    function frozenBalanceOf(address _owner) external view returns (uint256 frozenBalance);

    /**
     * @dev Returns the number of unfrozen tokens in ``owner``'s account.
     */
    function unfrozenBalanceOf(address _owner) external view returns (uint256 unfrozenBalance);
}