/* 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 protocol PContent;

namespace mozilla {
namespace dom {

/**
 * Protocol used to relay chrome observer notifications related to clearing data
 * to SessionStorageManager instances in content processes. A single instance is
 * created by each content process when LocalStorage NextGen is enabled. When
 * LSNG is disabled, the notifications are instead propagated via
 * PBackgroundStorageChild. This does mean there are potentially slight ordering
 * differences in when the notification will be received and processed. It's
 * okay for this protocol to be managed by PContent rather than PBackground
 * because these notifications are both rare and to-child-only. (Legacy
 * LocalStorage was moved to PBackground from PContent because of parent-process
 * main-thread contention for the processing of "parent:" messages in a very
 * performance-sensitive context!)
 */
[ManualDealloc, ChildImpl=virtual, ParentImpl=virtual]
async protocol PSessionStorageObserver
{
  manager PContent;

parent:
  async DeleteMe();

child:
  async __delete__();

  async Observe(nsCString topic,
                nsString originAttributesPattern,
                nsCString originScope);
};

}
}