michael@0: /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0:  * License, v. 2.0. If a copy of the MPL was not distributed with this file,
michael@0:  * You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0: 
michael@0: #include "domstubs.idl"
michael@0: 
michael@0: interface nsIURI;
michael@0: 
michael@0: /**
michael@0:  * Implemented by the contract id @mozilla.org/inter-app-communication-service;1
michael@0:  *
michael@0:  * This interface contains helpers for Inter-App Communication API [1] related
michael@0:  * purposes. A singleton service of this interface will be instantiated during
michael@0:  * the system boot-up, which plays the role of the central service receiving
michael@0:  * messages from and interacting with the content processes.
michael@0:  *
michael@0:  * [1] https://wiki.mozilla.org/WebAPI/Inter_App_Communication_Alt_proposal
michael@0:  */
michael@0: [scriptable, uuid(b3d711a4-c6a4-11e3-8fd3-738e7fbcb6d6)]
michael@0: interface nsIInterAppCommService : nsISupports
michael@0: {
michael@0:   /*
michael@0:    * Registration of a page that wants to be connected to other apps through
michael@0:    * the Inter-App Communication API.
michael@0:    *
michael@0:    * @param keyword        The connection's keyword.
michael@0:    * @param handlerPageURI The URI of the handler's page.
michael@0:    * @param manifestURI    The webapp's manifest URI.
michael@0:    * @param description    The connection's description.
michael@0:    * @param rules          The connection's rules.
michael@0:    */
michael@0:   void registerConnection(in DOMString      keyword,
michael@0:                           in nsIURI         handlerPageURI,
michael@0:                           in nsIURI         manifestURI,
michael@0:                           in DOMString      description,
michael@0:                           in jsval          rules);
michael@0: };