1 files changed, 83 insertions, 0 deletions
diff --git a/devtools/server/actors/addon/addons.js b/devtools/server/actors/addon/addons.js
new file mode 100644
index 0000000000..95a3738d61
--- /dev/null
+++ b/devtools/server/actors/addon/addons.js
@@ -0,0 +1,83 @@
+/* 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/. */
+
+"use strict";
+
+const { Actor } = require("resource://devtools/shared/protocol.js");
+const {
+  addonsSpec,
+} = require("resource://devtools/shared/specs/addon/addons.js");
+
+const { AddonManager } = ChromeUtils.importESModule(
+  "resource://gre/modules/AddonManager.sys.mjs",
+  { loadInDevToolsLoader: false }
+);
+const { FileUtils } = ChromeUtils.importESModule(
+  "resource://gre/modules/FileUtils.sys.mjs"
+);
+
+// This actor is used by DevTools as well as external tools such as webext-run
+// and the Firefox VS-Code plugin. see bug #1578108
+class AddonsActor extends Actor {
+  constructor(conn) {
+    super(conn, addonsSpec);
+  }
+
+  async installTemporaryAddon(addonPath, openDevTools) {
+    let addonFile;
+    let addon;
+    try {
+      addonFile = new FileUtils.File(addonPath);
+      addon = await AddonManager.installTemporaryAddon(addonFile);
+    } catch (error) {
+      throw new Error(`Could not install add-on at '${addonPath}': ${error}`);
+    }
+
+    Services.obs.notifyObservers(null, "devtools-installed-addon", addon.id);
+
+    // Try to open DevTools for the installed add-on.
+    // Note that it will only work on Firefox Desktop.
+    // On Android, we don't ship DevTools UI.
+    // about:debugging is only using this API when debugging its own firefox instance,
+    // so for now, there is no chance of calling this on Android.
+    if (openDevTools) {
+      // This module is typically loaded in the loader spawn by DevToolsStartup,
+      // in a distinct compartment thanks to useDistinctSystemPrincipalLoader and loadInDevToolsLoader flag.
+      // But here we want to reuse the shared module loader.
+      // We do not want to load devtools.js in the server's distinct module loader.
+      const loader = ChromeUtils.importESModule(
+        "resource://devtools/shared/loader/Loader.sys.mjs",
+        { loadInDevToolsLoader: false }
+      );
+      const {
+        gDevTools,
+        // eslint-disable-next-line mozilla/reject-some-requires
+      } = loader.require("resource://devtools/client/framework/devtools.js");
+      gDevTools.showToolboxForWebExtension(addon.id);
+    }
+
+    // TODO: once the add-on actor has been refactored to use
+    // protocol.js, we could return it directly.
+    // return new AddonTargetActor(this.conn, addon);
+
+    // Return a pseudo add-on object that a calling client can work
+    // with. Provide a flag that the client can use to detect when it
+    // gets upgraded to a real actor object.
+    return { id: addon.id, actor: false };
+  }
+
+  async uninstallAddon(addonId) {
+    const addon = await AddonManager.getAddonByID(addonId);
+
+    // We only support uninstallation of temporarily loaded add-ons at the
+    // moment.
+    if (!addon?.temporarilyInstalled) {
+      throw new Error(`Could not uninstall add-on "${addonId}"`);
+    }
+
+    await addon.uninstall();
+  }
+}
+
+exports.AddonsActor = AddonsActor;