@gjsify/devtools-protocol 0.38.1 → 0.40.0

package/lib/esm/index.js

@@ -1 +1 @@
-import{DEVTOOLS_INTERFACE as e}from"./constants.js";import{errResponse as t,okResponse as n}from"./envelope.js";import{DevtoolsError as r,formatDbusErrorMessage as i,parseDbusErrorMessage as a,toErrorPayload as o}from"./errors.js";import{GENERIC_METHODS as s}from"./methods.js";import"./transport.js";import{MethodRegistry as c}from"./registry.js";import{DEVTOOLS_ADDRESS_DIR as l,DEVTOOLS_ADDRESS_ENV as u,DEVTOOLS_ENABLE_ENV as d,DEVTOOLS_INSTANCE_ENV as f,devtoolsAddressFilePath as p,isDevtoolsEnabledValue as m,resolveBusAddress as h,sanitizeInstanceId as g}from"./routing.js";import"./types.js";export{l as DEVTOOLS_ADDRESS_DIR,u as DEVTOOLS_ADDRESS_ENV,d as DEVTOOLS_ENABLE_ENV,f as DEVTOOLS_INSTANCE_ENV,e as DEVTOOLS_INTERFACE,r as DevtoolsError,s as GENERIC_METHODS,c as MethodRegistry,p as devtoolsAddressFilePath,t as errResponse,i as formatDbusErrorMessage,m as isDevtoolsEnabledValue,n as okResponse,a as parseDbusErrorMessage,h as resolveBusAddress,g as sanitizeInstanceId,o as toErrorPayload};
+import{DEVTOOLS_INTERFACE as e}from"./constants.js";import{errResponse as t,okResponse as n}from"./envelope.js";import{DevtoolsError as r,formatDbusErrorMessage as i,parseDbusErrorMessage as a,toErrorPayload as o}from"./errors.js";import{GENERIC_METHODS as s}from"./methods.js";import"./transport.js";import{MethodRegistry as c}from"./registry.js";import{DEVTOOLS_ADDRESS_DIR as l,DEVTOOLS_ADDRESS_ENV as u,DEVTOOLS_ENABLE_ENV as d,DEVTOOLS_INSTANCE_ENV as f,appIdToObjectPath as p,devtoolsAddressFilePath as m,isDevtoolsEnabledValue as h,resolveBusAddress as g,sanitizeInstanceId as _}from"./routing.js";import"./types.js";export{l as DEVTOOLS_ADDRESS_DIR,u as DEVTOOLS_ADDRESS_ENV,d as DEVTOOLS_ENABLE_ENV,f as DEVTOOLS_INSTANCE_ENV,e as DEVTOOLS_INTERFACE,r as DevtoolsError,s as GENERIC_METHODS,c as MethodRegistry,p as appIdToObjectPath,m as devtoolsAddressFilePath,t as errResponse,i as formatDbusErrorMessage,h as isDevtoolsEnabledValue,n as okResponse,a as parseDbusErrorMessage,g as resolveBusAddress,_ as sanitizeInstanceId,o as toErrorPayload};

package/lib/esm/routing.js

@@ -1 +1 @@
-import"./_virtual/_rolldown/runtime.js";function sanitizeInstanceId(e){let t=e.toLowerCase().replace(/[^a-z0-9]/g,``);return/^[a-z]/.test(t)?t:`i${t||`0`}`}function resolveBusAddress(e,t){let n=`/${e.replace(/\./g,`/`)}`,r=t&&t!=="default"?sanitizeInstanceId(t):`default`;return r==="default"?{busName:e,objectPath:`${n}/devtools`,instance:`default`}:{busName:`${e}.${r}`,objectPath:`${n}/${r}/devtools`,instance:r}}const e=`GJSIFY_DEVTOOLS`,t=`GJSIFY_DEVTOOLS_INSTANCE`,n=`GJSIFY_DEVTOOLS_ADDRESS`;function isDevtoolsEnabledValue(e){if(e==null)return!1;let t=e.toLowerCase();return t!==``&&t!==`0`&&t!==`false`}const r=`gjsify-devtools`;function devtoolsAddressFilePath(e,t,n){let{busName:i}=resolveBusAddress(t,n);return`${e}/${r}/${i}.address`}export{r as DEVTOOLS_ADDRESS_DIR,n as DEVTOOLS_ADDRESS_ENV,e as DEVTOOLS_ENABLE_ENV,t as DEVTOOLS_INSTANCE_ENV,devtoolsAddressFilePath,isDevtoolsEnabledValue,resolveBusAddress,sanitizeInstanceId};
+import"./_virtual/_rolldown/runtime.js";function sanitizeInstanceId(e){let t=e.toLowerCase().replace(/[^a-z0-9]/g,``);return/^[a-z]/.test(t)?t:`i${t||`0`}`}function appIdToObjectPath(e){return`/${e.replace(/\./g,`/`).replace(/-/g,`_`)}`}function resolveBusAddress(e,t){let n=appIdToObjectPath(e),r=t&&t!=="default"?sanitizeInstanceId(t):`default`;return r==="default"?{busName:e,objectPath:`${n}/devtools`,instance:`default`}:{busName:`${e}.${r}`,objectPath:`${n}/${r}/devtools`,instance:r}}const e=`GJSIFY_DEVTOOLS`,t=`GJSIFY_DEVTOOLS_INSTANCE`,n=`GJSIFY_DEVTOOLS_ADDRESS`;function isDevtoolsEnabledValue(e){if(e==null)return!1;let t=e.toLowerCase();return t!==``&&t!==`0`&&t!==`false`}const r=`gjsify-devtools`;function devtoolsAddressFilePath(e,t,n){let{busName:i}=resolveBusAddress(t,n);return`${e}/${r}/${i}.address`}export{r as DEVTOOLS_ADDRESS_DIR,n as DEVTOOLS_ADDRESS_ENV,e as DEVTOOLS_ENABLE_ENV,t as DEVTOOLS_INSTANCE_ENV,appIdToObjectPath,devtoolsAddressFilePath,isDevtoolsEnabledValue,resolveBusAddress,sanitizeInstanceId};

package/lib/types/routing.d.ts

@@ -9,15 +9,29 @@ export interface BusAddress {
     objectPath: string;
     instance: string;
 }
+/**
+ * An application id as `Gio.Application` itself spells it as an object path: dots become
+ * slashes, HYPHENS BECOME UNDERSCORES (gio `gapplicationimpl-dbus.c`,
+ * `application_path_from_appid`).
+ *
+ * The hyphen half is not cosmetic. `-` is not a legal D-Bus object-path character —
+ * measured on gjs 1.88.1, `GLib.Variant.is_object_path('/gjsify/examples/canvas2d-fireworks')`
+ * is `false`, and exporting there does NOT throw: it logs one
+ * `g_dbus_interface_skeleton_export: assertion 'g_variant_is_object_path (object_path)'
+ * failed` and exports nothing. Every `gjsify.examples.*-*` showcase carries such an id, so
+ * a dots-only derivation aimed the bus-less export and the bridge's prediction at a path
+ * that can never exist, silently, while the app itself sat at the underscore one.
+ */
+export declare function appIdToObjectPath(appId: string): string;
 /**
  * Resolve an instance label to its DBus bus name + devtools object path, given the app's
  * base id. The default instance keeps the bare base; a named instance gets a
  * `.<segment>` bus-name suffix and a `/<segment>` path segment, so the bridge dials the
  * right process when several run side by side.
  *
- * Mirrors `Gio.Application`'s own path derivation (id dots → slashes, leading slash) plus
- * a `/devtools` leaf. The in-app adapter should prefer the authoritative
- * `app.get_dbus_object_path() + '/devtools'`; this only lets the bridge PREDICT it.
+ * Path derivation is {@link appIdToObjectPath} plus a `/devtools` leaf. The in-app adapter
+ * should prefer the authoritative `app.get_dbus_object_path() + '/devtools'`; this only
+ * lets the bridge PREDICT it.
  *
  * - `("org.example.App")` → `org.example.App` @ `/org/example/App/devtools`
  * - `("org.example.App", "host")` → `org.example.App.host` @ `/org/example/App/host/devtools`

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/devtools-protocol",
-    "version": "0.38.1",
+    "version": "0.40.0",
     "description": "Transport-agnostic devtools contract (methods, JSON envelope, method-kinds, transport interface) shared by every gjsify devtools adapter and the MCP bridge",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -35,8 +35,8 @@
     ],
     "dependencies": {},
     "devDependencies": {
-        "@gjsify/cli": "^0.38.1",
-        "@gjsify/unit": "^0.38.1",
+        "@gjsify/cli": "^0.40.0",
+        "@gjsify/unit": "^0.40.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },