1/* This Source Code Form is subject to the terms of the Mozilla Public
2 * License, v. 2.0. If a copy of the MPL was not distributed with this
3 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
4
5#include "nsISupports.idl"
6
7interface calIDateTime;
8
9[scriptable, uuid(2414729b-37dc-456e-ba72-f9c33891e6ee)]
10interface calIDeletedItems : nsISupports
11{
12    /**
13     * Clean the database of all deleted items older than an internal threshold.
14     */
15    void flush();
16
17    /**
18     * Gets the time the item with given id was deleted at. If passed, the
19     * search will be restricted to a certain calendar
20     *
21     * @param aId       The ID of the item to search for.
22     * @param aCalId    The calendar id to restrict the search to.
23     * @return          The date/time the item was deleted, or null if not found.
24     */
25    calIDateTime getDeletedDate(in AUTF8String aId, [optional] in AUTF8String aCalId);
26};
27