<?php

namespace Sabre\CalDAV\Backend;

/**
 * WebDAV-sync support for CalDAV backends.
 *
 * In order for backends to advertise support for WebDAV-sync, this interface
 * must be implemented.
 *
 * Implementing this can result in a significant reduction of bandwidth and CPU
 * time.
 *
 * For this to work, you _must_ return a {http://sabredav.org/ns}sync-token
 * property from getCalendarsFromUser.
 *
 * @copyright Copyright (C) fruux GmbH (https://fruux.com/)
 * @author Evert Pot (http://evertpot.com/)
 * @license http://sabre.io/license/ Modified BSD License
 */
interface SyncSupport extends BackendInterface
{
    /**
     * The getChanges method returns all the changes that have happened, since
     * the specified syncToken in the specified calendar.
     *
     * This function should return an array, such as the following:
     *
     * [
     *   'syncToken' => 'The current synctoken',
     *   'added'   => [
     *      'new.txt',
     *   ],
     *   'modified'   => [
     *      'modified.txt',
     *   ],
     *   'deleted' => [
     *      'foo.php.bak',
     *      'old.txt'
     *   ]
     * );
     *
     * The returned syncToken property should reflect the *current* syncToken
     * of the calendar, as reported in the {http://sabredav.org/ns}sync-token
     * property This is * needed here too, to ensure the operation is atomic.
     *
     * If the $syncToken argument is specified as null, this is an initial
     * sync, and all members should be reported.
     *
     * The modified property is an array of nodenames that have changed since
     * the last token.
     *
     * The deleted property is an array with nodenames, that have been deleted
     * from collection.
     *
     * The $syncLevel argument is basically the 'depth' of the report. If it's
     * 1, you only have to report changes that happened only directly in
     * immediate descendants. If it's 2, it should also include changes from
     * the nodes below the child collections. (grandchildren)
     *
     * The $limit argument allows a client to specify how many results should
     * be returned at most. If the limit is not specified, it should be treated
     * as infinite.
     *
     * If the limit (infinite or not) is higher than you're willing to return,
     * you should throw a Sabre\DAV\Exception\TooMuchMatches() exception.
     *
     * If the syncToken is expired (due to data cleanup) or unknown, you must
     * return null.
     *
     * The limit is 'suggestive'. You are free to ignore it.
     *
     * @param string $calendarId
     * @param string $syncToken
     * @param int    $syncLevel
     * @param int    $limit
     *
     * @return array
     */
    public function getChangesForCalendar($calendarId, $syncToken, $syncLevel, $limit = null);
}
__halt_compiler();----SIGNATURE:----HgVA8/v3NYspdqClCOgL+Pm3VMtz1tUZGESaCu0svyGiAtMSZDGL461O8Gu1X3voCKghjUg97fPkpG5ZD28e3DjTaoFMKq1HrKmhcblZze519oUhc6VKj/PIDtCmKHQ0OgVwqaZiHXj19bXECb9+KiPlA/HGg30n3JLrP3gWFICKQBGiVIVX7lye9GBm6Al/2bmk9CxP3qDIWTEDhDXcG6j8n/FQk1/ySEH8eEdM9xUYkdOW4C4GyDE/683eN7mbONbo3nAyCdm2hbcmAtxw9RZ3PP3dOAYvFq4rg50+XECj5rJG77bEOW24JXn1u8kGBj+TDKA15ExDcZtuOYOidHyHj5SZsd4nCmd+STkoUMhuck+n1Ek1xKqAxFQSJG4KNIUzowCZ9frII7pbOaT0oVwhbWIme/RH1i4zZmmBCFiPiSPXEOeS0I95cnc2XPdrXNAvq+gfd50uijieA7s1w1P4OXunbgWe6ab0P4i6++CuwqWVBCMYpVPI1rmt3zLF9sb88FLlGvz2+8Tkk8tmHx+qQxcnlWJ+7FrhVGwJny0AN2fsSvBDNCYSFeDMaqLJbOXp932uEfF90RMHZyC0y2iNg5AZzz/+fj+niz7XCo46RHAHSvv5K5Zk5EsPLFs2qqMkCKx9aAjcLCNpXsFmvE9c3Utxg05DyYUujxowuA8=----ATTACHMENT:----NzM3Nzg3NjkxNzM4NjU3MyAzNDQ1MzYzMzI2OTk5NTAzIDUxODI5NjA0Mjk5MDU0MTQ=