<?php

  namespace Sabre\CalDAV;
  use Sabre\DAV;

  /**
   * Calendar interface
   *
   * Implement this interface to allow a node to be recognized as an calendar.
   *

   * @copyright Copyright (C) 2007-2014 fruux GmbH (https://fruux.com/).
   * @author Evert Pot (http://evertpot.com/)
   * @license http://sabre.io/license/ Modified BSD License

   */

  interface ICalendar extends DAV\ICollection {

  
      /**
       * Performs a calendar-query on the contents of this calendar.
       *
       * The calendar-query is defined in RFC4791 : CalDAV. Using the
       * calendar-query it is possible for a client to request a specific set of
       * object, based on contents of iCalendar properties, date-ranges and
       * iCalendar component types (VTODO, VEVENT).
       *
       * This method should just return a list of (relative) urls that match this
       * query.
       *
       * The list of filters are specified as an array. The exact array is

       * documented by \Sabre\CalDAV\CalendarQueryParser.

       *
       * @param array $filters
       * @return array
       */
      public function calendarQuery(array $filters);
  
  }