@gorgo/medusa-integration 0.0.3 → 0.0.5

package/README.md

@@ -2,17 +2,28 @@
 Integration Module for Medusa
 </h1>
 
+<p align="center">
+  <a href="https://docs.gorgojs.com/integrations/integration">Documentation</a>
+  <br/>
+  A Medusa module that lets plugins declare their settings and store admins configure them right in the Admin — no <code>medusa-config</code> edits, no redeploys, secrets encrypted at rest.
+  <br/>
+  <a href="https://github.com/gorgojs/medusa-integrations/blob/HEAD/packages/modules/integration/README.ru.md">Читать README на русском ↗</a>
+</p>
+
 <br/>
 
 <p align="center">
   <a href="https://medusajs.com">
     <img src="https://img.shields.io/badge/Medusa-^2.17.2-blue?logo=medusa" alt="Medusa" />
   </a>
+  <a href="https://medusajs.com">
+    <img src="https://img.shields.io/badge/Tested_with_Medusa-v2.17.2-green?logo=checkmarx" alt="Medusa" />
+  </a>
 </p>
 
 <p align="center">
   <a href="https://t.me/gorgojs_chat">
-    <img src="https://img.shields.io/badge/Telegram-Support_Chat-0088cc?logo=telegram&style=social" alt="Telegram Support Chat" />
+    <img src="https://img.shields.io/badge/Telegram-Support_Chat-0088cc?logo=telegram&style=social" alt="Support Chat on Telegram" />
   </a>
 </p>
 
@@ -22,9 +33,33 @@ Integration Module for Medusa
   </a>
 </p>
 
+## Features
+
+- **No-code configuration in the Admin.** Plugin credentials and settings are managed under Settings → Integrations — no `medusa-config`/env edits and no redeploys.
+- **Encrypted secrets at rest.** Fields marked `secret` are encrypted (AES-256-GCM) and never reach the browser.
+- **Declarative descriptor** (`defineIntegration`) for plugin authors: options, sections, validation, and a connection test in one place.
+- **Rich option types & validation:** `string` / `url` / `email` / `uuid` / `number` / `boolean` / `enum` / `json`, per-option and cross-section rules, conditional visibility, read-only fields, i18n labels, and an icon.
+- **Multiple instances** of the same provider (e.g. several accounts).
+- **Connection test** from the Admin.
+- **Typed runtime resolve:** consumers read a validated, decrypted config; incomplete or disabled configs never resolve, so drafts don't leak into runtime.
+- **Custom admin widgets** per provider.
+- **Anonymous telemetry.**
+
+## What is the integration module?
+
+Plugins need settings — API keys, modes, webhooks. Usually these live in `medusa-config`/env, which requires code access and a redeploy for every change, with secrets kept in plain text. This module moves settings into the **Admin and the database**: a store admin fills in a form, secrets are encrypted, and the consuming plugin reads the ready config at runtime. Plugin authors only **describe** the settings form — the module handles the UI, storage, encryption, and validation.
+
+## Integrated plugins & providers
+
+| Provider | Category | `resolve` |
+|---|---|---|
+| [T-Kassa](https://docs.gorgojs.com/integrations/t-kassa) | `payment` | `@gorgo/medusa-payment-tkassa-v2/providers/integration-tkassa` |
+
+Any plugin can ship an integration provider — see the [documentation](https://docs.gorgojs.com/integrations/integration).
+
 ## 💬  Support & Community
 
-Got questions or ideas about the plugin? Join the Telegram support chat — [@gorgojs_chat](https://t.me/gorgojs_chat)
+Got questions or ideas about the module? Join the Telegram support chat — [@gorgojs_chat](https://t.me/gorgojs_chat)
 
 Connect with other Medusa developers on Telegram — [@medusajs_chat](https://t.me/medusajs_chat)
 
@@ -41,6 +76,10 @@ yarn add @gorgo/medusa-integration
 npm install @gorgo/medusa-integration
 ```
 
+## Documentation
+
+The complete installation, configuration, and usage guide is available on the [Gorgo documentation website](https://docs.gorgojs.com/integrations/integration).
+
 ## License
 
 Licensed under the [MIT License](LICENSE).

package/README.ru.md

@@ -0,0 +1,85 @@
+<h1 align="center">
+Модуль интеграций для Medusa
+</h1>
+
+<p align="center">
+  <a href="https://docs.gorgojs.ru/integrations/integration">Документация</a>
+  <br/>
+  Модуль Medusa, который позволяет плагинам описывать свои настройки, а администраторам магазина — конфигурировать их прямо в админке: без правок <code>medusa-config</code> и передеплоя, с шифрованием секретов.
+  <br/>
+  <a href="https://github.com/gorgojs/medusa-integrations/blob/HEAD/packages/modules/integration/README.md">Read README in English ↗</a>
+</p>
+
+<br>
+
+<p align="center">
+  <a href="https://medusajs.com">
+    <img src="https://img.shields.io/badge/Medusa-^2.17.2-blue?logo=medusa" alt="Medusa" />
+  </a>
+  <a href="https://medusajs.com">
+    <img src="https://img.shields.io/badge/Протестировано_с_Medusa-v2.17.2-green?logo=checkmarx" alt="Medusa" />
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://t.me/gorgojs_chat">
+    <img src="https://img.shields.io/badge/Telegram-Чат_поддержки-0088cc?logo=telegram&style=social" alt="Чат поддержки в Telegram" />
+  </a>
+</p>
+
+<p align="center">
+  <a href="https://t.me/medusajs_chat">
+    <img src="https://img.shields.io/badge/Telegram-Чат_dev--сообщества_Medusa.js-0088cc?logo=telegram&style=social" alt="Чат сообщества разработчиков Medusa.js в Telegram" />
+  </a>
+</p>
+
+## Возможности
+
+- **No-code конфигурация в админке.** Учётные данные и параметры плагинов задаются в разделе Настройки → Интеграции — без правок `medusa-config`/env и передеплоя.
+- **Шифрование секретов на месте (at-rest).** Поля с пометкой `secret` шифруются (AES-256-GCM) и никогда не уходят в браузер.
+- **Декларативный дескриптор** (`defineIntegration`) для авторов плагинов: опции, секции, валидация и проверка соединения — в одном месте.
+- **Богатые типы опций и валидация:** `string` / `url` / `email` / `uuid` / `number` / `boolean` / `enum` / `json`, правила на уровне опции и меж-секционные, условная видимость, read-only-поля, i18n-подписи и иконка.
+- **Несколько экземпляров** одного провайдера (например, несколько аккаунтов).
+- **Проверка соединения** прямо из админки.
+- **Типизированный резолв в рантайме:** потребитель получает провалидированный расшифрованный конфиг; неполные или выключенные конфигурации не резолвятся — черновик не «протекает» в рантайм.
+- **Кастомные виджеты** провайдера в админке.
+- **Анонимная телеметрия.**
+
+## Что такое модуль интеграций?
+
+Плагинам нужны настройки — ключи API, режимы, вебхуки. Обычно их держат в `medusa-config`/env: это требует доступа к коду и передеплоя при каждом изменении, а секреты лежат в открытом виде. Модуль переносит настройки в **админку и БД**: администратор магазина заполняет форму, секреты шифруются, а плагин-потребитель читает готовый конфиг в рантайме. Автор плагина при этом лишь **описывает** форму настроек — UI, хранение, шифрование и валидацию берёт на себя модуль.
+
+## Подключённые плагины и провайдеры
+
+| Провайдер | Категория | `resolve` |
+|---|---|---|
+| [T-Kassa](https://docs.gorgojs.ru/integrations/t-kassa) | `payment` | `@gorgo/medusa-payment-tkassa-v2/providers/integration-tkassa` |
+
+Любой плагин может поставлять integration-провайдер — см. [документацию](https://docs.gorgojs.ru/integrations/integration).
+
+## 💬  Поддержка и сообщество
+
+Есть вопросы по модулю или идеи? Пишите в чат поддержки в Telegram — [@gorgojs_chat](https://t.me/gorgojs_chat)
+
+Общайтесь с другими разработчиками Medusa в Telegram — [@medusajs_chat](https://t.me/medusajs_chat)
+
+## Требования
+
+- Medusa v2.17.2 или выше
+- Node.js v20 или выше
+
+## Установка
+
+```bash
+yarn add @gorgo/medusa-integration
+# или
+npm install @gorgo/medusa-integration
+```
+
+## Документация
+
+Полное руководство по установке, настройке и использованию доступно на [сайте документации Gorgo](https://docs.gorgojs.ru/integrations/integration).
+
+## Лицензия
+
+Распространяется на условиях [лицензии MIT](LICENSE).

package/package.json

@@ -1,15 +1,19 @@
 {
   "name": "@gorgo/medusa-integration",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Integration module for Medusa",
+  "author": {
+    "name": "Gorgo",
+    "url": "https://gorgojs.com"
+  },
   "license": "MIT",
   "files": [
     ".medusa/server"
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/gorgojs/medusa-plugins",
-    "directory": "packages/medusa-integration"
+    "url": "https://github.com/gorgojs/medusa-integrations",
+    "directory": "packages/modules/integration"
   },
   "exports": {
     ".": {