/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* 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 nsIArray;
interface nsIProfileStartup;

[scriptable, uuid(b6adb2b8-5e3b-4fdd-b085-d58998b5c21a)]
interface nsISuiteProfileMigrator : nsISupports 
{
  /**
   * profile items to migrate. use with migrate().
   */
  const unsigned short SETTINGS         = 0x0001;
  const unsigned short COOKIES          = 0x0002;
  const unsigned short HISTORY          = 0x0004;
  const unsigned short HOMEPAGEDATA     = 0x0008;
  const unsigned short PASSWORDS        = 0x0010;
  const unsigned short BOOKMARKS        = 0x0020;
  const unsigned short OTHERDATA        = 0x0040;
  const unsigned short ACCOUNT_SETTINGS = 0x0080;
  const unsigned short ADDRESSBOOK_DATA = 0x0100;
  const unsigned short JUNKTRAINING     = 0x0200;
  const unsigned short NEWSDATA         = 0x0400;
  const unsigned short MAILDATA         = 0x0800;
  const unsigned short ALL              = 0x0FFF;

  /**
   * Copy user profile information to the current active profile.
   *
   * @param aItems   list of data items to migrate. see above for values.
   * @param aReplace replace or append current data where applicable. 
   * @param aProfile profile to migrate from, if there is more than one.
   */
  void migrate(in unsigned short aItems, in nsIProfileStartup aStartup,
               in wstring aProfile);

  /**
   * A bit field containing profile items that this migrator is able
   * to import for a specified source profile.
   *
   * @param   aProfile the profile that we are looking for available data
   *          to import
   * @param   aStarting "true" if the profile is not currently being used.
   * @returns bit field containing profile items (see above)
   */
  unsigned short getMigrateData(in wstring aProfile, in boolean aDoingStartup);


  /**
   * A bit field containing profile items that this migrator may be able
   * to import for any source profile of its type.
   */
  readonly attribute unsigned short   supportedItems;

  /**
   * Whether or not there is any data that can be imported from this
   * browser (i.e. whether or not it is installed, and there exists
   * a user profile)
   */
  readonly attribute boolean          sourceExists;

  /**
   * Whether or not the import source implementing this interface
   * has multiple user profiles configured.
   */
  readonly attribute boolean          sourceHasMultipleProfiles;

  /**
   * An enumeration of available profiles. If the import source does
   * not support profiles, this attribute is null.
   */
  readonly attribute nsIArray         sourceProfiles;
};