1 files changed, 47 insertions, 0 deletions
diff --git a/comm/calendar/base/public/calISchedulingSupport.idl b/comm/calendar/base/public/calISchedulingSupport.idl
new file mode 100644
index 0000000000..123ca35192
--- /dev/null
+++ b/comm/calendar/base/public/calISchedulingSupport.idl
@@ -0,0 +1,47 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#include "nsISupports.idl"
+interface calIItemBase;
+interface calIAttendee;
+
+/**
+ * Accesses scheduling specific information of calendar items.
+ * Implementation by providers is optional.
+ */
+[scriptable, uuid(9221e243-c97e-4c5f-9e00-5d7d3521bb44)]
+interface calISchedulingSupport : nsISupports
+{
+    /**
+     * Tests whether the passed item corresponds to an invitation, e.g.
+     * the CUA or server has placed it in the calendar.
+     *
+     * @param aItem     Item to be tested.
+     * @return          Whether the passed item corresponds to an invitation.
+     */
+    boolean isInvitation(in calIItemBase aItem);
+
+    /**
+     * Gets the invited attendee if the passed item corresponds to
+     * an invitation. UI code will use that attendee to modify e.g. PARTSTAT.
+     * If isInvitation returns true, getInvitedAttendee must return
+     * an attendee. If isInvitation is false, getInvitedAttendee may return
+     * an attendee in case the organizer (and owner of the calendar) has
+     * invited himself.
+     *
+     * @param aItem     Invitation item.
+     * @return          Attendee object, or null.
+     */
+    calIAttendee getInvitedAttendee(in calIItemBase aItem);
+
+    /**
+     * Checks whether the provider keeps track of sending out the proper
+     * iTIP/iMIP message for a particular item.
+     *
+     * @param aMethod a iTIP method
+     * @param aItem an item that has been modified/deleted etc.
+     * @return true, if the provider keeps track of sending out passed message
+     */
+    boolean canNotify(in AUTF8String aMethod, in calIItemBase aItem);
+};