1 files changed, 100 insertions, 0 deletions
diff --git a/devtools/client/debugger/src/utils/dbg.js b/devtools/client/debugger/src/utils/dbg.js
new file mode 100644
index 0000000000..0d7dff72e1
--- /dev/null
+++ b/devtools/client/debugger/src/utils/dbg.js
@@ -0,0 +1,100 @@
+/* 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/>. */
+
+import { prefs, asyncStore, features } from "./prefs";
+import { getDocument } from "./editor/source-documents";
+import { wasmOffsetToLine } from "./wasm";
+
+function getThreadFront(dbg) {
+  return dbg.targetCommand.targetFront.threadFront;
+}
+
+function findSource(dbg, url) {
+  const sources = dbg.selectors.getSourceList();
+  return sources.find(s => (s.url || "").includes(url));
+}
+
+function findSources(dbg, url) {
+  const sources = dbg.selectors.getSourceList();
+  return sources.filter(s => (s.url || "").includes(url));
+}
+
+function evaluate(dbg, expression) {
+  return dbg.client.evaluate(expression);
+}
+
+function bindSelectors(obj) {
+  return Object.keys(obj.selectors).reduce((bound, selector) => {
+    bound[selector] = (a, b, c) =>
+      obj.selectors[selector](obj.store.getState(), a, b, c);
+    return bound;
+  }, {});
+}
+
+function getCM() {
+  const cm = document.querySelector(".CodeMirror");
+  return cm?.CodeMirror;
+}
+
+function formatMappedLocation(mappedLocation) {
+  const { location, generatedLocation } = mappedLocation;
+  return {
+    original: `(${location.line}, ${location.column})`,
+    generated: `(${generatedLocation.line}, ${generatedLocation.column})`,
+  };
+}
+
+function formatMappedLocations(locations) {
+  return console.table(locations.map(loc => formatMappedLocation(loc)));
+}
+
+function formatSelectedColumnBreakpoints(dbg) {
+  const positions = dbg.selectors.getBreakpointPositionsForSource(
+    dbg.selectors.getSelectedSource().id
+  );
+
+  return formatMappedLocations(positions);
+}
+
+function getDocumentForUrl(dbg, url) {
+  const source = findSource(dbg, url);
+  return getDocument(source.id);
+}
+
+const diff = (a, b) => Object.keys(a).filter(key => !Object.is(a[key], b[key]));
+
+export function setupHelper(obj) {
+  const selectors = bindSelectors(obj);
+  const dbg = {
+    ...obj,
+    selectors,
+    prefs,
+    asyncStore,
+    features,
+    getCM,
+
+    // Expose this to tests as they don't have access to debugger's browser loader require
+    // and so can't load utils/wasm.js
+    wasmOffsetToLine: (sourceId, offset) => wasmOffsetToLine(sourceId, offset),
+
+    helpers: {
+      findSource: url => findSource(dbg, url),
+      findSources: url => findSources(dbg, url),
+      evaluate: expression => evaluate(dbg, expression),
+      dumpThread: () => getThreadFront(dbg).dumpThread(),
+      getDocument: url => getDocumentForUrl(dbg, url),
+    },
+    formatters: {
+      mappedLocations: locations => formatMappedLocations(locations),
+      mappedLocation: location => formatMappedLocation(location),
+      selectedColumnBreakpoints: () => formatSelectedColumnBreakpoints(dbg),
+    },
+    _telemetry: {
+      events: {},
+    },
+    diff,
+  };
+
+  window.dbg = dbg;
+}