placeholder IDLs (eventually to go into libmsg)

network/protocol/nntp/public/nsIMsgNewsArticleList.idl

@@ -0,0 +1,30 @@
+
+/* this interface is basically for the old ListNewsGroupState class
+ * (the implementation of this class probably wants to also implement
+ * or contain ChangeListener so that it can react to OnAnnouncerGoingAway()
+ * to destroy the DBView)
+ */
+[object, uuid({E628ED19-9452-11d2-B7EA-00805F05FFA5})]
+interface nsIMsgNewsArticleList {
+
+/* These calls are used by libnet to determine which articles it ought to
+     get in a big newsgroup. */
+  /* the nsIUnknown will probably hold a ListNewsGroupState
+   * this stuff might really belong on the XOVER stuff, but I'm not sure
+   * -alecf */
+
+
+  void InitAddArticleKeyToGroup();
+  void AddArticleKeyToGroup(in long found_id);
+  void FinishAddArticleKeyToGroup();
+  void GetRangeOfArtsToDownload(in long first_message,
+                                in long last_message,
+                                in long total_messages,
+                                out long real_first_message,
+                                out long real_last_message,
+                                out long real_total_messages);
+  
+  void AddToKnownArticles(in long first_message, in long last_message);
+  
+};
+

network/protocol/nntp/public/nsIMsgNewsHost.idl

@@ -0,0 +1,71 @@
+[object, uuid(2F5041B0-939E-11d2-B7EA-00805F05FFA5)]
+interface nsIMsgHostNews {
+
+  attribute boolean supportsExtensions;
+  void AddExtension(in string extension);
+  boolean QueryExtension(in string extension);
+
+  attribute boolean postingAllowed;
+  attribute boolean pushAuth;
+  attribute long lastUpdatedTime;
+
+  /* libnet callbacks for Dredd NNTP extensions
+   * please document if you know how these work
+   */
+  void AddPropertyForGet(in string name, in string value);
+  void AddSearchableGroup(in string groupname);
+  void AddProfileGroup(in string responseText);
+  /* going away */
+  void AddSubscribedNewsgroup(in string url);
+
+  /* In response to an NNTP GROUP command, the server said
+   * the group doesn't exist
+   */
+  void GroupNotFound(in string group, in boolean opening);
+  
+  /* Tell the subscribe pane about a new newsgroup we noticed. */
+  /* XXX should xactive flags be a long? */
+  void AddNewNewsgroup(in string groupname,
+                       in long first, in long last,
+                       in string flags, in boolean xactiveFlags);
+
+  /* formerly GetNewsRCCount() */
+  /* After displaying a list of newsgroups, we need the NNTP module to go and
+     run "GROUP" commands for the ones for which we don't know the unread
+     article count.  This function returns a count of how many groups we think
+     we're going to need this for (so we can display progress in a reasonable
+     way).
+  */
+  long GetNumGroupsNeedingCounts();
+  
+  /* formerly GetNewsRCGroup() */
+  /* Gets the name of the next group that we want to get article counts for.
+     MSG_DisplaySubscribedGroup() should get called with this group before
+     this call happens again. */
+  string GetFirstGroupNeedingCounts();
+  
+  /* In response to a "news://host/" URL; this is called once for each group
+     that was returned by MSG_GetNewsRCGroup(), after the NNTP GROUP
+     command has been run.  It's also called whenever we actually visit the
+     group (the user clicks on the newsgroup line), in case the data has
+     changed since the initial passthrough.  The "nowvisiting" parameter
+     is TRUE in the latter case, FALSE otherwise. */
+  void DisplaySubscribedGroup(in string groupname,
+                              in long first_message, in long last_message,
+                              in long total_messages,
+                              in boolean visit_now);
+
+  string GetFirstGroupNeedingExtraInfo();
+
+  
+  /* News servers work better if you ask for message numbers instead of IDs.
+     So, the NNTP module asks us what the group and number of an ID is with
+     this.  If we don't know, we return 0 for both.   If the pane is not a
+     thead or message pane, this routine will fail.
+  */
+  void GetNewsGroupAndNumberOfID(in string message_id,
+                                 out string groupname,
+                                 out long message_number);
+  
+};
+

network/protocol/nntp/public/nsIMsgNewsgroup.idl

@@ -0,0 +1,15 @@
+
+[object, uuid(E628ED10-9452-11d2-B7EA-00805F05FFA5)]
+interface nsINetNewsgroup {
+  
+  attribute string prettyName;
+  
+  attribute string password;
+  attribute string username;
+
+  attribute boolean needsExtraInfo;
+  
+  
+};
+
+

network/protocol/nntp/public/nsIMsgXOVERParser.idl

@@ -0,0 +1,25 @@
+[object, uuid(E628ED19-9452-11d2-B7EA-00805F05FFA5)]
+interface nsIMsgListNewsgroupState  {
+
+  /* The NNTP module of netlib calls these to feed XOVER data to the message
+     library, in response to a news:group.name URL having been opened.
+     If MSG_FinishXOVER() returns a message ID, that message will be loaded
+     next (used for selecting the first unread message in a group after
+     listing that group.)
+
+     depricated:
+     The "out" arguments are (if non-NULL) a file descriptor to write the XOVER
+     line to, followed by a "\n".  This is used by the XOVER-caching code.
+  */
+  /* the XOVER Sink should maintain the ListNewsGroupState */
+  void Init(in string hostname, in string groupname,
+            in long first_message, in long last_message,
+            in long oldest_message, in long newest_message);
+  
+  void Process(in string line);
+  void ProcessNonXOVER(in string line);
+  void Reset();
+  void Finish(in long status);
+  void ClearState();
+  
+};