@gorgo/medusa-integration 0.0.6 → 0.1.0

package/.medusa/server/src/admin/index.js

@@ -39,27 +39,27 @@ const IntegrationIcon = ({
       }
     );
   }
-  return /* @__PURE__ */ jsxRuntime.jsx(
-    "div",
+  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: showImage ? /* @__PURE__ */ jsxRuntime.jsx(
+    "img",
     {
-      className: ui.clx(
-        "bg-ui-bg-component shadow-borders-base flex shrink-0 items-center justify-center overflow-hidden rounded-md",
-        dim
-      ),
-      children: showImage ? /* @__PURE__ */ jsxRuntime.jsx(
-        "img",
-        {
-          src,
-          alt,
-          className: "h-full w-full object-cover",
-          onError: () => setErrored(true)
-        }
-      ) : /* @__PURE__ */ jsxRuntime.jsx(icons.PuzzleSolid, { className: "text-ui-fg-subtle" })
+      src,
+      alt,
+      className: "rounded-lg object-cover border shadow-xs w-12 h-12",
+      onError: () => setErrored(true)
     }
-  );
+  ) : /* @__PURE__ */ jsxRuntime.jsx(icons.PuzzleSolid, { className: "rounded-lg object-cover border shadow-xs w-12 h-12 p-3 text-ui-fg-subtle" }) });
+};
+const CATEGORY_MODULE_PREFIX = {
+  payment: "pp",
+  fulfillment: "fp",
+  tax: "tp"
+};
+const toModuleProviderId = (providerId, category) => {
+  const prefix = category ? CATEGORY_MODULE_PREFIX[category] : void 0;
+  return prefix ? providerId.replace(/^int_/, `${prefix}_`) : providerId;
 };
 const PAGE_SIZE = 20;
-const DOCS_URL = "https://docs.gorgojs.com/ru/medusa-plugins/integration-module";
+const DOCS_URL = "https://docs.gorgojs.com/medusa-modules/integration";
 const IntegrationCell = ({ item }) => {
   const { t } = reactI18next.useTranslation();
   return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-3", children: [
@@ -67,7 +67,7 @@ const IntegrationCell = ({ item }) => {
     /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col", children: [
       /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2", children: [
         /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "small", leading: "compact", weight: "plus", children: t(item.display_name) }),
-        item.provider_id && /* @__PURE__ */ jsxRuntime.jsx(ui.Badge, { size: "2xsmall", color: "grey", children: item.provider_id })
+        item.provider_id && /* @__PURE__ */ jsxRuntime.jsx(ui.Badge, { size: "2xsmall", color: "grey", children: toModuleProviderId(item.provider_id, item.category) })
       ] }),
       item.version && /* @__PURE__ */ jsxRuntime.jsxs(ui.Text, { size: "xsmall", leading: "compact", className: "text-ui-fg-subtle", children: [
         t("integration.meta.version", { version: item.version }),
@@ -2205,7 +2205,7 @@ const EditPage = () => {
             /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex flex-col gap-y-1", children: [
               /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-x-2", children: [
                 /* @__PURE__ */ jsxRuntime.jsx(ui.Heading, { children: t(descriptor.displayName) }),
-                provider_id && /* @__PURE__ */ jsxRuntime.jsx(ui.Badge, { size: "2xsmall", color: "grey", children: provider_id })
+                provider_id && /* @__PURE__ */ jsxRuntime.jsx(ui.Badge, { size: "2xsmall", color: "grey", children: toModuleProviderId(provider_id, descriptor.category) })
               ] }),
               version && /* @__PURE__ */ jsxRuntime.jsxs(ui.Text, { size: "xsmall", leading: "compact", className: "text-ui-fg-subtle", children: [
                 t("integration.meta.version", { version }),
@@ -2300,7 +2300,7 @@ const IntegrationBreadcrumb = ({ params }) => {
 const handle$1 = {
   breadcrumb: ({ params }) => /* @__PURE__ */ jsxRuntime.jsx(IntegrationBreadcrumb, { params })
 };
-const PUBLISH_URL = "https://docs.gorgojs.com/integrations";
+const PUBLISH_URL = "https://docs.gorgojs.com/medusa-modules/integration";
 const API_URL = "https://gorgojs.com";
 const InstallModal = ({ item, onOpenChange }) => {
   const { t } = reactI18next.useTranslation();
@@ -2312,8 +2312,12 @@ const InstallModal = ({ item, onOpenChange }) => {
     /* @__PURE__ */ jsxRuntime.jsx(ui.Drawer.Body, { className: "flex flex-1 flex-col gap-y-4 overflow-auto", children: item && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
       /* @__PURE__ */ jsxRuntime.jsx(ui.Text, { size: "small", className: "text-ui-fg-subtle", children: t("integration.browse.install_addToConfig") }),
       /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "bg-ui-bg-subtle flex items-center justify-between gap-x-2 rounded-md px-3 py-2", children: [
-        /* @__PURE__ */ jsxRuntime.jsx("code", { className: "txt-compact-small text-ui-fg-subtle", children: `npm i ${item.npm}` }),
-        /* @__PURE__ */ jsxRuntime.jsx(ui.Copy, { content: `npm i ${item.npm}` })
+        /* @__PURE__ */ jsxRuntime.jsx("code", { className: "txt-compact-small text-ui-fg-subtle", children: `yarn add @gorgo/medusa-integration ${item.npm}@beta` }),
+        /* @__PURE__ */ jsxRuntime.jsx(ui.Copy, { content: `yarn add @gorgo/medusa-integration ${item.npm}@beta` })
+      ] }),
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "bg-ui-bg-subtle flex items-center justify-between gap-x-2 rounded-md px-3 py-2", children: [
+        /* @__PURE__ */ jsxRuntime.jsx("code", { className: "txt-compact-small text-ui-fg-subtle", children: `npm install @gorgo/medusa-integration ${item.npm}@beta` }),
+        /* @__PURE__ */ jsxRuntime.jsx(ui.Copy, { content: `npm install @gorgo/medusa-integration ${item.npm}@beta` })
       ] }),
       item.configSnippet && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "bg-ui-bg-subtle flex flex-col gap-y-2 rounded-md px-3 py-2", children: [
         /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center justify-between gap-x-2", children: [

package/.medusa/server/src/admin/index.mjs

@@ -1,4 +1,4 @@
-import { jsx, jsxs, Fragment } from "react/jsx-runtime";
+import { jsx, Fragment, jsxs } from "react/jsx-runtime";
 import { defineRouteConfig } from "@medusajs/admin-sdk";
 import { PuzzleSolid, CogSixTooth, Trash, Spinner, EllipsisHorizontal, PencilSquare, Plus } from "@medusajs/icons";
 import { clx, createDataTableColumnHelper, usePrompt, toast, Text, Badge, useDataTable, Container, Heading, Button, DataTable, Tabs, StatusBadge, Label, Input, Select, Switch, Textarea, Drawer, DropdownMenu, IconButton, Copy } from "@medusajs/ui";
@@ -35,27 +35,27 @@ const IntegrationIcon = ({
       }
     );
   }
-  return /* @__PURE__ */ jsx(
-    "div",
+  return /* @__PURE__ */ jsx(Fragment, { children: showImage ? /* @__PURE__ */ jsx(
+    "img",
     {
-      className: clx(
-        "bg-ui-bg-component shadow-borders-base flex shrink-0 items-center justify-center overflow-hidden rounded-md",
-        dim
-      ),
-      children: showImage ? /* @__PURE__ */ jsx(
-        "img",
-        {
-          src,
-          alt,
-          className: "h-full w-full object-cover",
-          onError: () => setErrored(true)
-        }
-      ) : /* @__PURE__ */ jsx(PuzzleSolid, { className: "text-ui-fg-subtle" })
+      src,
+      alt,
+      className: "rounded-lg object-cover border shadow-xs w-12 h-12",
+      onError: () => setErrored(true)
     }
-  );
+  ) : /* @__PURE__ */ jsx(PuzzleSolid, { className: "rounded-lg object-cover border shadow-xs w-12 h-12 p-3 text-ui-fg-subtle" }) });
+};
+const CATEGORY_MODULE_PREFIX = {
+  payment: "pp",
+  fulfillment: "fp",
+  tax: "tp"
+};
+const toModuleProviderId = (providerId, category) => {
+  const prefix = category ? CATEGORY_MODULE_PREFIX[category] : void 0;
+  return prefix ? providerId.replace(/^int_/, `${prefix}_`) : providerId;
 };
 const PAGE_SIZE = 20;
-const DOCS_URL = "https://docs.gorgojs.com/ru/medusa-plugins/integration-module";
+const DOCS_URL = "https://docs.gorgojs.com/medusa-modules/integration";
 const IntegrationCell = ({ item }) => {
   const { t } = useTranslation();
   return /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-3", children: [
@@ -63,7 +63,7 @@ const IntegrationCell = ({ item }) => {
     /* @__PURE__ */ jsxs("div", { className: "flex flex-col", children: [
       /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2", children: [
         /* @__PURE__ */ jsx(Text, { size: "small", leading: "compact", weight: "plus", children: t(item.display_name) }),
-        item.provider_id && /* @__PURE__ */ jsx(Badge, { size: "2xsmall", color: "grey", children: item.provider_id })
+        item.provider_id && /* @__PURE__ */ jsx(Badge, { size: "2xsmall", color: "grey", children: toModuleProviderId(item.provider_id, item.category) })
       ] }),
       item.version && /* @__PURE__ */ jsxs(Text, { size: "xsmall", leading: "compact", className: "text-ui-fg-subtle", children: [
         t("integration.meta.version", { version: item.version }),
@@ -2201,7 +2201,7 @@ const EditPage = () => {
             /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-y-1", children: [
               /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-x-2", children: [
                 /* @__PURE__ */ jsx(Heading, { children: t(descriptor.displayName) }),
-                provider_id && /* @__PURE__ */ jsx(Badge, { size: "2xsmall", color: "grey", children: provider_id })
+                provider_id && /* @__PURE__ */ jsx(Badge, { size: "2xsmall", color: "grey", children: toModuleProviderId(provider_id, descriptor.category) })
               ] }),
               version && /* @__PURE__ */ jsxs(Text, { size: "xsmall", leading: "compact", className: "text-ui-fg-subtle", children: [
                 t("integration.meta.version", { version }),
@@ -2296,7 +2296,7 @@ const IntegrationBreadcrumb = ({ params }) => {
 const handle$1 = {
   breadcrumb: ({ params }) => /* @__PURE__ */ jsx(IntegrationBreadcrumb, { params })
 };
-const PUBLISH_URL = "https://docs.gorgojs.com/integrations";
+const PUBLISH_URL = "https://docs.gorgojs.com/medusa-modules/integration";
 const API_URL = "https://gorgojs.com";
 const InstallModal = ({ item, onOpenChange }) => {
   const { t } = useTranslation();
@@ -2308,8 +2308,12 @@ const InstallModal = ({ item, onOpenChange }) => {
     /* @__PURE__ */ jsx(Drawer.Body, { className: "flex flex-1 flex-col gap-y-4 overflow-auto", children: item && /* @__PURE__ */ jsxs(Fragment, { children: [
       /* @__PURE__ */ jsx(Text, { size: "small", className: "text-ui-fg-subtle", children: t("integration.browse.install_addToConfig") }),
       /* @__PURE__ */ jsxs("div", { className: "bg-ui-bg-subtle flex items-center justify-between gap-x-2 rounded-md px-3 py-2", children: [
-        /* @__PURE__ */ jsx("code", { className: "txt-compact-small text-ui-fg-subtle", children: `npm i ${item.npm}` }),
-        /* @__PURE__ */ jsx(Copy, { content: `npm i ${item.npm}` })
+        /* @__PURE__ */ jsx("code", { className: "txt-compact-small text-ui-fg-subtle", children: `yarn add @gorgo/medusa-integration ${item.npm}@beta` }),
+        /* @__PURE__ */ jsx(Copy, { content: `yarn add @gorgo/medusa-integration ${item.npm}@beta` })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { className: "bg-ui-bg-subtle flex items-center justify-between gap-x-2 rounded-md px-3 py-2", children: [
+        /* @__PURE__ */ jsx("code", { className: "txt-compact-small text-ui-fg-subtle", children: `npm install @gorgo/medusa-integration ${item.npm}@beta` }),
+        /* @__PURE__ */ jsx(Copy, { content: `npm install @gorgo/medusa-integration ${item.npm}@beta` })
       ] }),
       item.configSnippet && /* @__PURE__ */ jsxs("div", { className: "bg-ui-bg-subtle flex flex-col gap-y-2 rounded-md px-3 py-2", children: [
         /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between gap-x-2", children: [

package/README.md

@@ -7,7 +7,7 @@ Integration Module for Medusa
   <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>
+  <a href="https://github.com/gorgojs/medusa-integrations/blob/HEAD/packages/modules/integration/README-ru.md">Читать README на русском ↗</a>
 </p>
 
 <br/>
@@ -16,8 +16,8 @@ Integration Module for Medusa
   <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 href="https://github.com/gorgojs/medusa-integrations/actions/workflows/update-medusa-version.yml">
+    <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/gorgojs/medusa-integrations/main/.badges/medusa-integration.json&logo=checkmarx" alt="Medusa" />
   </a>
 </p>
 
@@ -79,7 +79,3 @@ 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/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@gorgo/medusa-integration",
-  "version": "0.0.6",
+  "version": "0.1.0",
   "description": "Integration module for Medusa",
   "author": {
     "name": "Gorgo",
     "url": "https://gorgojs.com"
   },
-  "license": "MIT",
   "files": [
     ".medusa/server"
   ],
@@ -47,7 +46,7 @@
     "test:unit": "TEST_TYPE=unit NODE_OPTIONS=--experimental-vm-modules jest --silent --runInBand --forceExit"
   },
   "dependencies": {
-    "@gorgo/telemetry": "^1.0.0"
+    "@gorgo/telemetry": "^1.3.0"
   },
   "devDependencies": {
     "@medusajs/admin-sdk": "^2.17.2",

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License Copyright (c) 2025 Gorgo
-
-Permission is hereby granted, free
-of charge, to any person obtaining a copy of this software and associated
-documentation files (the "Software"), to deal in the Software without
-restriction, including without limitation the rights to use, copy, modify, merge,
-publish, distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to the
-following conditions:
-
-The above copyright notice and this permission notice
-(including the next paragraph) shall be included in all copies or substantial
-portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
-ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
-EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
-OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.

package/README.ru.md

@@ -1,85 +0,0 @@
-<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).