Сделать расширение понятным для следующего разработчика
Главной сложностью было разобраться в коде до внесения изменений. Расширение состояло из крупных JavaScript-файлов, а его поведение было распределено между страницами ассистентов, фоновой частью, всплывающим окном и боковой панелью. Изменение общих данных могло затронуть сразу несколько мест.
При переходе на TypeScript я сделал эти связи явными. Сообщения, хранилище, записи памяти, ответы API и настройки провайдеров получили общие типы. Content scripts по-прежнему учитывали различия между сайтами, но обмен данными с остальными частями расширения стало проще проследить.
Такая структура позволила собирать версии для браузеров из общего исходного кода. Chrome использовал фоновый service worker; Firefox требовал другого описания фонового скрипта и своих настроек. Эти различия остались в манифестах и конфигурации сборки, без отдельных реализаций продуктовой логики.
