AGS v3.0 Migration Guidance

[hexatedjuice]

I'm in the middle of migrating my current configuration (v2.0) to v3.0 (following the Migration Guide in the wiki). However, I'm still running into (decorator?) issues when attempting to run my config. At first I thought I may have a stale version in my run. However I believe the error most likely originates from v2.0 syntax/features from my code.

Is there any guidance on being able to produce a better trace for debugging and migrating? Apologies if I missed any additional documentation in the wiki.

Environment: ags version 3.0.0 Arch Linux AUR aylurs-gtk-shell 3.0.0-1 gjs 1.86.0 node v25.1.0

$ ags run

(gjs:1178248): Gjs-CRITICAL **: 15:37:52.516: JS ERROR: TypeError: can't access property "dbusMethods", meta2 is undefined
installMethod@file:///run/user/1000/ags.js:1089:19 -> meta@../../../usr/share/ags/js/node_modules/gnim/dist/dbus.ts:502:22
methodAsync/<@file:///run/user/1000/ags.js:1108:31 -> ../../../usr/share/ags/js/node_modules/gnim/dist/dbus.ts:704:22
__decorateClass@file:///run/user/1000/ags.js:11:24 ->
@file:///run/user/1000/ags.js:1153:16 -> ../../../usr/share/ags/js/lib/app/dbus.ts:15:11



(gjs:1178248): Gjs-CRITICAL **: 15:37:52.516: Module file:///run/user/1000/ags.js threw an exception
error: exit status 1

[Aylur]

I think you need to update your tsconfig

{
  "compilerOptions": {
    "experimentalDecorators": false, // you can also just remove it, as its false by default
    "target": "ES2020"
  }
}

[hexatedjuice]

Thank you! This fixed the issue for me (at least the ones unrelated to my own code).