@gjsify/devtools 0.39.0 → 0.40.0

package/lib/esm/install.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";import{DevtoolsPeerServerError as e,removeDevtoolsAddressFile as t,startDevtoolsPeerServer as n,writeDevtoolsAddressFile as r}from"./peer-transport.js";import{DevtoolsService as i}from"./devtools-service.js";import a from"@girs/glib-2.0";import{DEVTOOLS_ADDRESS_ENV as o,DEVTOOLS_ENABLE_ENV as s,DEVTOOLS_INSTANCE_ENV as c,DEVTOOLS_INTERFACE as l,devtoolsAddressFilePath as u,isDevtoolsEnabledValue as d}from"@gjsify/devtools-protocol";import f from"@girs/gio-2.0";const p=`DBUS_SESSION_BUS_ADDRESS`,m=new Set;function envEnabled(){return d(a.getenv(s))}function envValue(e){let t=a.getenv(e);return t&&t!==``?t:null}function sessionBusUsable(){if(!envValue(p))return!1;try{return f.bus_get_sync(f.BusType.SESSION,null),!0}catch{return!1}}function chooseDevtoolsTransport(e){return e.requestedAddress?{kind:`peer`,address:e.requestedAddress,reason:`requested`}:e.hasAppConnection?{kind:`session-bus`}:e.sessionBusUsable?{kind:`unregistered`}:{kind:`peer`,address:null,reason:`no-session-bus`}}function describeMissingConnection(e,t){return e?t?`[gjsify-devtools] the session bus answers but this application is not registered on it yet — call installDevtools() from the GtkApplication "startup" handler (the bus connection and object path exist only after registration).`:`[gjsify-devtools] ${p} is set (${e}) but no bus answers there — using the bus-less peer transport instead. On macOS this is the usual state: Homebrew's dbus listens on launchd, so the advertised address only works while that socket is live.`:`[gjsify-devtools] this machine has no session bus (${p} is unset) — using the bus-less peer transport instead. Point the bridge at the address below, or set ${o} on both the app and \`gjsify debug\` to pin it yourself.`}function installDevtools(e,t={}){if(!(t.enabled??envEnabled()))return null;let n=t.instance??envValue(c)??void 0,r=new i(e,{...t,instance:n});try{return exportDevtools(e,r,t,n)}catch(e){return r.unexport(),console.error(`[gjsify-devtools] devtools stayed OFF, the app is unaffected — ${describeInstallFailure(e)}`),null}}function describeInstallFailure(t){return t instanceof e||t instanceof Error?t.message:String(t)}function exportDevtools(e,i,s,c){let d=e.get_is_registered(),f=d?e.get_dbus_connection():null,h=d?e.get_dbus_object_path():null,g=envValue(p),_=!!(f&&h),v=_||sessionBusUsable(),y=chooseDevtoolsTransport({requestedAddress:s.address??envValue(o),hasAppConnection:_,sessionBusUsable:v}),b=e.get_application_id()??`unknown`,x=`${h??`/${b.replace(/\./g,`/`)}`}/devtools`;if((y.kind===`unregistered`||y.kind===`peer`&&y.reason===`no-session-bus`)&&console.error(describeMissingConnection(g,v)),y.kind===`session-bus`&&f)i.export(f,x),console.log(`[gjsify-devtools] exported ${l} at ${x} (dest ${b})`);else if(y.kind===`peer`){let o=n(i,x,y.address??void 0),s=r(u(a.get_user_runtime_dir(),b,c),o.address);i.attachPeerServer(o,s),console.log(`[gjsify-devtools] exported ${l} at ${x} (peer address ${o.address}${s?`, published to ${s}`:``})`),s&&e.connect(`shutdown`,()=>t(s))}return m.add(i),i}function uninstallDevtools(e){e.unexport(),m.delete(e)}export{chooseDevtoolsTransport,describeMissingConnection,installDevtools,uninstallDevtools};
+import"./_virtual/_rolldown/runtime.js";import{DevtoolsPeerServerError as e,removeDevtoolsAddressFile as t,startDevtoolsPeerServer as n,writeDevtoolsAddressFile as r}from"./peer-transport.js";import{DevtoolsService as i}from"./devtools-service.js";import a from"@girs/glib-2.0";import{DEVTOOLS_ADDRESS_ENV as o,DEVTOOLS_ENABLE_ENV as s,DEVTOOLS_INSTANCE_ENV as c,DEVTOOLS_INTERFACE as l,appIdToObjectPath as u,devtoolsAddressFilePath as d,isDevtoolsEnabledValue as f}from"@gjsify/devtools-protocol";import p from"@girs/gio-2.0";const m=`DBUS_SESSION_BUS_ADDRESS`,h=new Set;function envEnabled(){return f(a.getenv(s))}function envValue(e){let t=a.getenv(e);return t&&t!==``?t:null}function sessionBusUsable(){if(!envValue(m))return!1;try{return p.bus_get_sync(p.BusType.SESSION,null),!0}catch{return!1}}function chooseDevtoolsTransport(e){return e.requestedAddress?{kind:`peer`,address:e.requestedAddress,reason:`requested`}:e.hasAppConnection?{kind:`session-bus`}:e.sessionBusUsable?{kind:`unregistered`}:{kind:`peer`,address:null,reason:`no-session-bus`}}function describeMissingConnection(e,t){return e?t?`[gjsify-devtools] the session bus answers but this application is not registered on it yet — call installDevtools() from the GtkApplication "startup" handler (the bus connection and object path exist only after registration).`:`[gjsify-devtools] ${m} is set (${e}) but no bus answers there — using the bus-less peer transport instead. On macOS this is the usual state: Homebrew's dbus listens on launchd, so the advertised address only works while that socket is live.`:`[gjsify-devtools] this machine has no session bus (${m} is unset) — using the bus-less peer transport instead. Point the bridge at the address below, or set ${o} on both the app and \`gjsify debug\` to pin it yourself.`}function installDevtools(e,t={}){if(!(t.enabled??envEnabled()))return null;let n=t.instance??envValue(c)??void 0,r=new i(e,{...t,instance:n});try{return exportDevtools(e,r,t,n)}catch(e){return r.unexport(),console.error(`[gjsify-devtools] devtools stayed OFF, the app is unaffected — ${describeInstallFailure(e)}`),null}}function describeInstallFailure(t){return t instanceof e||t instanceof Error?t.message:String(t)}function exportDevtools(e,i,s,c){let f=e.get_is_registered(),p=f?e.get_dbus_connection():null,g=f?e.get_dbus_object_path():null,_=envValue(m),v=!!(p&&g),y=v||sessionBusUsable(),b=chooseDevtoolsTransport({requestedAddress:s.address??envValue(o),hasAppConnection:v,sessionBusUsable:y}),x=e.get_application_id()??`unknown`,S=`${g??u(x)}/devtools`;if((b.kind===`unregistered`||b.kind===`peer`&&b.reason===`no-session-bus`)&&console.error(describeMissingConnection(_,y)),b.kind===`session-bus`&&p)i.export(p,S),console.log(`[gjsify-devtools] exported ${l} at ${S} (dest ${x})`);else if(b.kind===`peer`){let o=n(i,S,b.address??void 0),s=r(d(a.get_user_runtime_dir(),x,c),o.address);i.attachPeerServer(o,s),console.log(`[gjsify-devtools] exported ${l} at ${S} (peer address ${o.address}${s?`, published to ${s}`:``})`),s&&e.connect(`shutdown`,()=>t(s))}return h.add(i),i}function uninstallDevtools(e){e.unexport(),h.delete(e)}export{chooseDevtoolsTransport,describeMissingConnection,installDevtools,uninstallDevtools};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/devtools",
-    "version": "0.39.0",
+    "version": "0.40.0",
     "description": "In-app DBus devtools control plane for GJS/GTK apps — inspect, screenshot, and drive a running app over org.gjsify.Devtools (gdbus or the MCP bridge)",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -43,11 +43,11 @@
         "@girs/gobject-2.0": "^4.1.0",
         "@girs/graphene-1.0": "^4.1.0",
         "@girs/gtk-4.0": "^4.1.0",
-        "@gjsify/devtools-protocol": "^0.39.0"
+        "@gjsify/devtools-protocol": "^0.40.0"
     },
     "devDependencies": {
-        "@gjsify/cli": "^0.39.0",
-        "@gjsify/unit": "^0.39.0",
+        "@gjsify/cli": "^0.40.0",
+        "@gjsify/unit": "^0.40.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },