/*
 * BEGIN FLOCK GPL
 *
 * Copyright Flock Inc. 2005-2009
 * http://flock.com
 *
 * This file may be used under the terms of the
 * GNU General Public License Version 2 or later (the "GPL"),
 * http://www.gnu.org/licenses/gpl.html
 *
 * Software distributed under the License is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
 * for the specific language governing rights and limitations under the
 * License.
 *
 * END FLOCK GPL
 */

#include "nsISupports.idl"

[scriptable, uuid(3cbf1140-8e6e-40b9-8a9e-3db5ea3a6f66)]
interface flockIMediaWebpageAPI: nsISupports
{
  void open();

  /**
   * Open a feed the mediabar
   *  aTitle: the title of the stream to be displayed
   *  aURL: the URL of a media feed (media RSS or other) to open.
   *        If null, the mediabar just opens.
   */
  void openFeed(in AString aTitle, in AString aURL);

  /**
   * Open someone's media in the mediabar
   *  aTitle: the title of the stream to be displayed
   *  aURL: the URL of a media feed (media RSS or other) to open.
   *        If null, the mediabar just opens.
   */
  void openPerson(in AString aService,
                  in AString aAccountId,
                  in AString aTitle);

  /**
   * Favorite the URL of a given media stream.
   */
  void favoriteMedia(in AString aURL);
};
