Admin Integration Config

Модуль интеграций для Medusa

Возможности

• No-code конфигурация в админке. Учётные данные и параметры плагинов задаются в разделе Настройки → Интеграции — без правок Copy to clipboardmedusa-config/env и передеплоя.
• Шифрование секретов на месте (at-rest). Поля с пометкой Copy to clipboardsecret шифруются (AES-256-GCM) и никогда не уходят в браузер.
• Декларативный дескриптор (Copy to clipboarddefineIntegration) для авторов плагинов: опции, секции, валидация и проверка соединения — в одном месте.
• Богатые типы опций и валидация: Copy to clipboardstring / Copy to clipboardurl / Copy to clipboardemail / Copy to clipboarduuid / Copy to clipboardnumber / Copy to clipboardboolean / Copy to clipboardenum / Copy to clipboardjson, правила на уровне опции и меж-секционные, условная видимость, read-only-поля, i18n-подписи и иконка.
• Несколько экземпляров одного провайдера (например, несколько аккаунтов).
• Проверка соединения прямо из админки.
• Типизированный резолв в рантайме: потребитель получает провалидированный расшифрованный конфиг; неполные или выключенные конфигурации не резолвятся — черновик не «протекает» в рантайм.
• Кастомные виджеты провайдера в админке.
• Анонимная телеметрия.

Что такое модуль интеграций?

Плагинам нужны настройки — ключи API, режимы, вебхуки. Обычно их держат в Copy to clipboardmedusa-config/env: это требует доступа к коду и передеплоя при каждом изменении, а секреты лежат в открытом виде. Модуль переносит настройки в админку и БД: администратор магазина заполняет форму, секреты шифруются, а плагин-потребитель читает готовый конфиг в рантайме. Автор плагина при этом лишь описывает форму настроек — UI, хранение, шифрование и валидацию берёт на себя модуль.

Подключённые плагины и провайдеры

Провайдер Категория Copy to clipboardresolve T-Kassa Copy to clipboardpayment Copy to clipboard@gorgo/medusa-payment-tkassa-v2/providers/integration-tkassa

Любой плагин может поставлять integration-провайдер — см. документацию.

💬 Поддержка и сообщество

Есть вопросы по модулю или идеи? Пишите в чат поддержки в Telegram — @gorgojs_chat

Общайтесь с другими разработчиками Medusa в Telegram — @medusajs_chat

Требования

• Medusa v2.17.2 или выше
• Node.js v20 или выше

Установка

123
yarn add @gorgo/medusa-integration
# или
npm install @gorgo/medusa-integration

Документация

Полное руководство по установке, настройке и использованию доступно на сайте документации Gorgo.

Лицензия

Распространяется на условиях лицензии MIT.