tinker-electron-debug 0.1.0

package/README.md

@@ -0,0 +1,26 @@
+# tinker-electron-debug
+
+An Electron app debugger plugin for [TINKER](https://github.com/liriliri/tinker), enabling remote debugging of in-production Electron applications.
+
+![Screenshot](https://raw.githubusercontent.com/liriliri/tinker-plugins/master/packages/tinker-electron-debug/screenshot.png)
+
+## Features
+
+- **Auto-detect** Electron apps installed on the system
+- **Launch & attach** debugger with a single click
+- **Inspect pages** — view Node.js and renderer process targets
+- **DevTools integration** — open Chrome DevTools for any target
+- **Live log output** — stream stdout/stderr in a built-in terminal
+- **Multi-session** support for debugging multiple apps simultaneously
+
+## Installation
+
+Download and install TINKER from `https://tinker.liriliri.io/`, then run `npm i -g tinker-electron-debug`.
+
+## Usage
+
+1. Select an Electron app from the app grid
+2. The app launches with debugging ports enabled
+3. Inspect Node.js or renderer process targets in the page list
+4. Click **Inspect** to open Chrome DevTools for a target
+5. View live log output in the terminal below

package/dist/preload/index.mjs

@@ -0,0 +1,379 @@
+import { contextBridge as K } from "electron";
+import l from "fs";
+import x from "path";
+import h from "process";
+import { spawn as $ } from "child_process";
+import H from "got";
+import rr from "net";
+import tr from "ws";
+function er(t) {
+  return t && t.__esModule && Object.prototype.hasOwnProperty.call(t, "default") ? t.default : t;
+}
+var y = { exports: {} }, E = { exports: {} }, A = { exports: {} }, S = { exports: {} }, b = { exports: {} };
+(function(t, r) {
+  var s = Object.prototype.toString;
+  r = function(o) {
+    return s.call(o);
+  }, t.exports = r;
+})(b, b.exports);
+var m = b.exports;
+(function(t, r) {
+  var s = m;
+  r = function(o) {
+    return s(o) === "[object Number]";
+  }, t.exports = r;
+})(S, S.exports);
+var nr = S.exports, O = { exports: {} };
+(function(t, r) {
+  var s = m;
+  r = function(o) {
+    var i = s(o);
+    return i === "[object Function]" || i === "[object GeneratorFunction]" || i === "[object AsyncFunction]";
+  }, t.exports = r;
+})(O, O.exports);
+var V = O.exports;
+(function(t, r) {
+  var s = nr, o = V, i = Math.pow(2, 53) - 1;
+  r = function(e) {
+    if (!e) return !1;
+    var n = e.length;
+    return s(n) && n >= 0 && n <= i && !o(e);
+  }, t.exports = r;
+})(A, A.exports);
+var J = A.exports, k = { exports: {} }, j = { exports: {} }, D = { exports: {} };
+(function(t, r) {
+  r = function(s) {
+    var o = typeof s;
+    return !!s && (o === "function" || o === "object");
+  }, t.exports = r;
+})(D, D.exports);
+var or = D.exports, P = { exports: {} };
+(function(t, r) {
+  var s = m;
+  Array.isArray ? r = Array.isArray : r = function(o) {
+    return s(o) === "[object Array]";
+  }, t.exports = r;
+})(P, P.exports);
+var w = P.exports, C = { exports: {} }, M = { exports: {} };
+(function(t, r) {
+  r = function(s) {
+    return s === void 0;
+  }, t.exports = r;
+})(M, M.exports);
+var I = M.exports;
+(function(t, r) {
+  var s = I;
+  r = function(o, i, e) {
+    if (s(i)) return o;
+    switch (e ?? 3) {
+      case 1:
+        return function(n) {
+          return o.call(i, n);
+        };
+      case 3:
+        return function(n, c, a) {
+          return o.call(i, n, c, a);
+        };
+      case 4:
+        return function(n, c, a, u) {
+          return o.call(i, n, c, a, u);
+        };
+    }
+    return function() {
+      return o.apply(i, arguments);
+    };
+  }, t.exports = r;
+})(C, C.exports);
+var Y = C.exports, F = { exports: {} }, N = { exports: {} }, T = { exports: {} }, U = { exports: {} };
+(function(t, r) {
+  var s = Object.prototype.hasOwnProperty;
+  r = function(o, i) {
+    return s.call(o, i);
+  }, t.exports = r;
+})(U, U.exports);
+var Z = U.exports;
+(function(t, r) {
+  var s = Z;
+  Object.keys ? r = Object.keys : r = function(o) {
+    var i = [];
+    for (var e in o)
+      s(o, e) && i.push(e);
+    return i;
+  }, t.exports = r;
+})(T, T.exports);
+var g = T.exports, L = { exports: {} }, W = { exports: {} };
+(function(t, r) {
+  var s = J, o = g, i = Y;
+  r = function(e, n, c) {
+    n = i(n, c);
+    var a, u;
+    if (s(e))
+      for (a = 0, u = e.length; a < u; a++) n(e[a], a, e);
+    else {
+      var p = o(e);
+      for (a = 0, u = p.length; a < u; a++)
+        n(e[p[a]], p[a], e);
+    }
+    return e;
+  }, t.exports = r;
+})(W, W.exports);
+var sr = W.exports;
+(function(t, r) {
+  var s = I, o = sr;
+  r = function(i, e) {
+    return function(n) {
+      return o(arguments, function(c, a) {
+        if (a !== 0) {
+          var u = i(c);
+          o(u, function(p) {
+            (!e || s(n[p])) && (n[p] = c[p]);
+          });
+        }
+      }), n;
+    };
+  }, t.exports = r;
+})(L, L.exports);
+var ir = L.exports;
+(function(t, r) {
+  var s = g, o = ir;
+  r = o(s), t.exports = r;
+})(N, N.exports);
+var ar = N.exports, _ = { exports: {} };
+(function(t, r) {
+  var s = g;
+  r = function(o, i) {
+    var e = s(i), n = e.length;
+    if (o == null) return !n;
+    o = Object(o);
+    for (var c = 0; c < n; c++) {
+      var a = e[c];
+      if (i[a] !== o[a] || !(a in o)) return !1;
+    }
+    return !0;
+  }, t.exports = r;
+})(_, _.exports);
+var cr = _.exports;
+(function(t, r) {
+  var s = ar, o = cr;
+  r = function(i) {
+    return i = s({}, i), function(e) {
+      return o(e, i);
+    };
+  }, t.exports = r;
+})(F, F.exports);
+var ur = F.exports, q = { exports: {} };
+(function(t, r) {
+  r = function(s) {
+    return s;
+  }, t.exports = r;
+})(q, q.exports);
+var pr = q.exports, z = { exports: {} }, G = { exports: {} }, R = { exports: {} };
+(function(t, r) {
+  var s = Z, o = w;
+  r = function(n, c) {
+    if (o(n)) return n;
+    if (c && s(c, n)) return [n];
+    var a = [];
+    return n.replace(i, function(u, p, f, v) {
+      a.push(f ? v.replace(e, "$1") : p || u);
+    }), a;
+  };
+  var i = /[^.[\]]+|\[(?:(-?\d+(?:\.\d+)?)|(["'])((?:(?!\2)[^\\]|\\.)*?)\2)\]|(?=(?:\.|\[\])(?:\.|\[\]|$))/g, e = /\\(\\)?/g;
+  t.exports = r;
+})(R, R.exports);
+var fr = R.exports;
+(function(t, r) {
+  var s = I, o = fr;
+  r = function(i, e) {
+    e = o(e, i);
+    var n;
+    for (n = e.shift(); !s(n); ) {
+      if (i = i[n], i == null) return;
+      n = e.shift();
+    }
+    return i;
+  }, t.exports = r;
+})(G, G.exports);
+var vr = G.exports;
+(function(t, r) {
+  var s = w, o = vr;
+  r = function(e) {
+    return s(e) ? function(n) {
+      return o(n, e);
+    } : i(e);
+  };
+  function i(e) {
+    return function(n) {
+      return n == null ? void 0 : n[e];
+    };
+  }
+  t.exports = r;
+})(z, z.exports);
+var xr = z.exports;
+(function(t, r) {
+  var s = V, o = or, i = w, e = Y, n = ur, c = pr, a = xr;
+  r = function(u, p, f) {
+    return u == null ? c : s(u) ? e(u, p, f) : o(u) && !i(u) ? n(u) : a(u);
+  }, t.exports = r;
+})(j, j.exports);
+var lr = j.exports;
+(function(t, r) {
+  var s = lr, o = g, i = J;
+  r = function(e, n, c) {
+    n = s(n, c);
+    for (var a = !i(e) && o(e), u = (a || e).length, p = Array(u), f = 0; f < u; f++) {
+      var v = a ? a[f] : f;
+      p[f] = n(e[v], v, e);
+    }
+    return p;
+  }, t.exports = r;
+})(k, k.exports);
+var dr = k.exports, B = { exports: {} };
+(function(t, r) {
+  var s = m;
+  r = function(o) {
+    return s(o) === "[object String]";
+  }, t.exports = r;
+})(B, B.exports);
+var mr = B.exports;
+(function(t, r) {
+  var s = J, o = dr, i = w, e = mr;
+  r = function(n) {
+    return n ? i(n) ? n : s(n) && !e(n) ? o(n) : [n] : [];
+  }, t.exports = r;
+})(E, E.exports);
+var wr = E.exports;
+(function(t, r) {
+  const s = wr, o = rr;
+  r = function(e, n) {
+    return e = s(e), e.push(0), e.reduce((c, a) => c.catch(() => i(a, n)), Promise.reject());
+  };
+  function i(e, n) {
+    return new Promise((c, a) => {
+      const u = o.createServer();
+      u.unref(), u.on("error", a);
+      const p = {};
+      p.port = e, n && (p.host = n), u.listen(p, () => {
+        const { port: f } = u.address();
+        u.close(() => {
+          c(f);
+        });
+      });
+    });
+  }
+  t.exports = r;
+})(y, y.exports);
+var gr = y.exports;
+const Q = /* @__PURE__ */ er(gr);
+function hr(t) {
+  return l.existsSync(
+    x.join(t, "Contents/Frameworks/Electron Framework.framework")
+  );
+}
+function yr(t) {
+  const r = x.dirname(t), s = x.join(r, "resources");
+  return l.existsSync(s) ? [
+    "electron.asar",
+    "default_app.asar",
+    "app.asar",
+    "app.asar.unpacked"
+  ].some((o) => l.existsSync(x.join(s, o))) : !1;
+}
+function Er(t) {
+  return l.existsSync(x.join(t, "../resources/electron.asar")) || l.existsSync(x.join(t, "../LICENSE.electron.txt")) || l.existsSync(x.join(t, "../chrome-sandbox"));
+}
+const d = /* @__PURE__ */ new Map();
+function Ar(t, r, s) {
+  return new Promise((o, i) => {
+    const e = new tr(t, {
+      headers: { Origin: "devtools://devtools" }
+    });
+    e.on("open", () => {
+      e.send(JSON.stringify({ id: 1, method: r, params: s }));
+    }), e.on("message", (n) => {
+      try {
+        const c = JSON.parse(n.toString());
+        c.id === 1 && (e.close(), o(c));
+      } catch {
+      }
+    }), e.on("error", i), setTimeout(() => {
+      e.terminate(), i(new Error("timeout"));
+    }, 5e3);
+  });
+}
+const Sr = {
+  isElectronApp: (t) => {
+    const r = h.platform;
+    return r === "darwin" ? hr(t) : r === "win32" ? yr(t) : Er(t);
+  },
+  launchApp: async (t, r, s, o) => {
+    var p, f;
+    const [i, e] = await Promise.all([
+      Q(0, "127.0.0.1"),
+      Q(0, "127.0.0.1")
+    ]);
+    let n = r;
+    if (h.platform === "darwin") {
+      const v = x.join(r, "Contents/MacOS");
+      if (l.existsSync(v)) {
+        const X = l.readdirSync(v);
+        X[0] && (n = x.join(v, X[0]));
+      }
+    }
+    const c = h.platform === "win32" ? x.dirname(n) : "/", a = $(
+      n,
+      [
+        `--inspect=${i}`,
+        `--remote-debugging-port=${e}`,
+        "--remote-allow-origins=devtools://devtools"
+      ],
+      { cwd: c }
+    ), u = (v) => s(v.toString());
+    return (p = a.stdout) == null || p.on("data", u), (f = a.stderr) == null || f.on("data", u), a.on("close", () => {
+      d.delete(t), o();
+    }), d.set(t, { nodePort: i, windowPort: e, kill: () => a.kill() }), { nodePort: i, windowPort: e };
+  },
+  stopApp: (t) => {
+    var r;
+    (r = d.get(t)) == null || r.kill(), d.delete(t);
+  },
+  getPages: async (t) => {
+    try {
+      return await H(`http://127.0.0.1:${t}/json`, {
+        timeout: { request: 2e3 }
+      }).json();
+    } catch {
+      return [];
+    }
+  },
+  openDevTools: async (t, r) => {
+    var c;
+    const o = (await H(
+      `http://127.0.0.1:${t}/json`,
+      { timeout: { request: 2e3 } }
+    ).json())[0];
+    if (!(o != null && o.webSocketDebuggerUrl))
+      throw new Error("No node target found");
+    const i = r.replace(/^\/devtools/, "devtools://devtools/bundled").replace(/^chrome-devtools:\/\//, "devtools://"), e = `
+      (function() {
+        const { BrowserWindow } = process.mainModule.require('electron');
+        const win = new BrowserWindow({
+          width: 1280,
+          height: 800,
+          webPreferences: { nodeIntegration: false }
+        });
+        win.loadURL(${JSON.stringify(i)});
+        win.show();
+      })()
+    `, n = await Ar(
+      o.webSocketDebuggerUrl,
+      "Runtime.evaluate",
+      { expression: e, awaitPromise: !1 }
+    );
+    if (n != null && n.exceptionDetails)
+      throw new Error(
+        ((c = n.exceptionDetails.exception) == null ? void 0 : c.description) || n.exceptionDetails.text
+      );
+  }
+};
+K.exposeInMainWorld("electronDebug", Sr);