Модуль интеграций 2.0 для Medusa: стабильный релиз с историей изменений

Модуль интеграций мы представили в конце июля. За четыре месяца его скачали с npm почти 12 000 раз, и сейчас через него управляют настройками плагинов в Medusa Admin больше 60 магазинов в продакшене из России и СНГ, Европы, Северной Америки, Бразилии и Индии.

Разработчики сообщества подключили через модуль больше 50 собственных интеграций, среди них Mercado Pago, Razorpay, Shiprocket, Melhor Envio, Klaviyo, Meilisearch, Twilio, WhatsApp, Ozon, СДЭК и Яндекс Пэй. А в одном из магазинов через модуль настраивается сразу 18 провайдеров!

В каталоге опубликовано уже 12 плагинов на модуле для платежей, доставки, ERP, аналитики и маркетплейсов. Два из них, Meta Commerce и Product Feeds, выпустили сторонние разработчики. Все опубликованные решения собраны в каталоге.

Сегодня модуль выходит из беты в стабильной версии 2.0.

Как работает модуль, смотрите в демо:

История изменений настроек

Когда настройки меняют в Admin, а не в коде, у изменений больше нет истории коммитов. После сбоя оплаты или доставки первым возникает вопрос, кто и что поменял. Теперь на него отвечает сам модуль.

Он записывает каждое изменение настроек с автором, временем и значениями полей до и после. Значения секретов в историю не попадают. Для них сохраняется только событие.

Как это выглядит в Admin, смотрите в демо:

Страница История изменений показывает правки по всем интеграциям. В ней есть поиск по автору, интеграции и изменённому полю, фильтры и сортировка, а ссылкой на отфильтрованный список можно поделиться.

Запись открывается в боковой панели со значениями «было → стало» и кнопкой Скопировать как JSON.

История хранится бессрочно и остаётся после удаления интеграции. Что именно записывает модуль, описано в документации, а работа с историей в Admin разобрана в руководстве для администратора.

Что ещё вошло в релиз

• Поиск на языке Admin – интеграцию можно найти по названию и описанию на языке интерфейса, а не только по идентификатору.
• Новые категории – к платежам, доставке, ERP и остальным добавились налоги, подписки, отзывы и панель администратора.
• Подсказки авторам провайдеров – при запуске модуль предупреждает о параметре, который похож на учётные данные, но не помечен как секрет, и о двух провайдерах с одинаковым идентификатором.
• Версия формата у секретов – она оставляет место для внешнего хранилища секретов и ротации ключей в следующих релизах 2.x без новой мажорной версии. Уже сохранённые секреты модуль читает как раньше.
• Новая документация – справочники по Admin API, воркфлоу, сервису, событиям и моделям данных, руководства для администраторов и схемы работы модуля собраны в документации.

Почему сразу 2.0

Модуль переходит с 0.3 сразу на 2.0 и получает тот же мажорный номер, что Medusa v2 и наши интеграции платежей и доставки. Все интеграции Gorgo, выпущенные сегодня, требуют @gorgo/medusa-integration@^2.0.0, поэтому по номеру версии видно, что работает вместе.

Как обновиться

Обновите модуль вместе с интеграциями Gorgo, которые использует проект, и выполните миграции:

Настройки и секреты, сохранённые в 0.3, модуль читает как раньше. Совместимые версии всех интеграций и шаги для проектов с собственным кодом поверх модуля перечислены в руководстве по обновлению.

Что дальше

Мы продолжаем разрабатывать новые интеграции и сопровождать уже выпущенные. Каждую ночь прогоняем тесты, каждый день проверяем совместимость с новыми версиями Medusa, а критичные ошибки исправляем отдельным патч-релизом. Как это устроено, описано на странице сопровождения.

Модуль интеграций 2.0 уже доступен в npm. Если вы пишете плагин для Medusa, начните с руководства по созданию провайдера.

Присоединяйтесь к обсуждению в Telegram-сообществе Medusa. Issues и pull request'ы ждём в репозитории на GitHub.