<commit_before><?php
/**
 * EventStore.php
 *
 * @copyright 2013 <NAME>, III
 * @license   http://www.opensource.org/licenses/mit-license.html  MIT License
 */

namespace Momento;

use Countable;

/**
 * Stores {@link Event}s as {@link StoredEvent}s
 *
 * @author <NAME>, III <<EMAIL>>
 */
interface EventStore extends Countable
{
    /**
     * Find all the {@link StoredEvent}s between two given ids
     *
     * @param int $lowStoredEventId  the lower bound id
     * @param int $highStoredEventId the higher bound id
     *
     * @return StoredEvent[]
     */
    public function allStoredEventsBetween($lowStoredEventId, $highStoredEventId);

    /**
     * Find all the {@link StoredEvent}s after a given id
     *
     * @param int $storedEventId the pivot id
     *
     * @return StoredEvent[]
     */
    public function allStoredEventsSince($storedEventId);

    /**
     * Append a {@link Event}
     *
     * @param Event $event the event to append
     *
     * @return StoredEvent
     */
    public function append(Event $event);

    /**
     * Remove a stored event by id
     *
     * @param int $storedEventId the stored event id to remove
     *
     * @return StoredEvent the removed event
     */
    public function remove($storedEventId);
}<commit_msg>Update remove() signature and comments<commit_after><?php
/**
 * EventStore.php
 *
 * @copyright 2013 <NAME>, III
 * @license   http://www.opensource.org/licenses/mit-license.html  MIT License
 */

namespace Momento;

use Countable;
use RuntimeException;

/**
 * Stores {@link Event}s as {@link StoredEvent}s
 *
 * @author <NAME>, III <<EMAIL>>
 */
interface EventStore extends Countable
{
    /**
     * Find all the {@link StoredEvent}s between two given ids
     *
     * @param int $lowStoredEventId  the lower bound id
     * @param int $highStoredEventId the higher bound id
     *
     * @return StoredEvent[]
     */
    public function allStoredEventsBetween($lowStoredEventId, $highStoredEventId);

    /**
     * Find all the {@link StoredEvent}s after a given id
     *
     * @param int $storedEventId the pivot id
     *
     * @return StoredEvent[]
     */
    public function allStoredEventsSince($storedEventId);

    /**
     * Append an event
     *
     * @param  Event $event the event to append
     * @throws RuntimeException - when the event cannot be appended
     * @return StoredEvent
     */
    public function append(Event $event);

    /**
     * Remove a stored event
     *
     * @param  StoredEvent $storedEvent the stored event to remove
     * @throws RuntimeException - when the event cannot be removed
     * @return void
     */
    public function remove(StoredEvent $storedEvent);
}
{'fraction_non_alphanumeric': 0.10580836108028117, 'fraction_numerical': 0.0029596744358120607, 'mean_word_length': 2.688949522510232, 'pattern_counts': {'":': 0, '<': 13, '<?xml version=': 0, '>': 11, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7218382', 'n_tokens_mistral': 817, 'n_tokens_neox': 798, 'n_words': 252}