@rynt/sdk 0.9.53

package/README.md

@@ -0,0 +1,122 @@
+# @rynt/sdk
+
+Официальный SDK для **Rynt Launcher**: UI-кит, типы, runtime расширений и API хоста.
+
+**Документация:** [https://docs.rynt.space](https://docs.rynt.space)  
+**Сборка расширений:** [`@rynt/extension-build`](https://www.npmjs.com/package/@rynt/extension-build)  
+**Создать проект:** [`@rynt/create-extension`](https://www.npmjs.com/package/@rynt/create-extension)
+
+---
+
+## Установка
+
+```bash
+npm install @rynt/sdk
+# peer: vue ^3.5, vue-router ^4.6 (router опционален)
+```
+
+Для **авторов расширений** обычно ставят SDK вместе с пресетом Vite:
+
+```bash
+npm install -D @rynt/sdk @rynt/extension-build vite vue @vitejs/plugin-vue typescript vue-tsc
+```
+
+Быстрый старт проекта — [create-extension](https://www.npmjs.com/package/@rynt/create-extension) или [Hello World в документации](https://docs.rynt.space/get-started/hello-world).
+
+---
+
+## Экспорты
+
+| Subpath | Назначение |
+|---------|------------|
+| **`@rynt/sdk`** | UI-компоненты, типы сущностей, утилиты |
+| **`@rynt/sdk/extension`** | `defineRyntExtension`, реестры, `useModel`, лоадеры, entity-виджеты |
+| **`@rynt/sdk/extension-marketplace`** | HTTP-клиент и типы REST каталога расширений |
+| **`@rynt/sdk/extension-expose-map`** | Module augmentation для `useExtensionExpose` |
+| **`@rynt/sdk/extension-registry-payload-map`** | Module augmentation для типов реестров |
+| **`@rynt/sdk/extension/registries`** | Низкоуровневый доступ к реестрам |
+| **`@rynt/sdk/session`** | Токен сессии для API |
+| **`@rynt/sdk/host`** | API хоста лаунчера (модели, загрузка расширений) |
+| **`@rynt/sdk/tiptap`** | TipTap-типы, согласованные с редактором лаунчера |
+
+Подробный обзор: [SDK в документации](https://docs.rynt.space/sdk/).
+
+---
+
+## Пример: расширение
+
+```ts
+import { markRaw } from 'vue';
+import {
+  defineRyntExtension,
+  resolvedNavigationPath,
+} from '@rynt/sdk/extension';
+
+import HelloPage from './HelloPage.vue';
+
+const EXTENSION_ID = '@acme/hello-world';
+
+export default defineRyntExtension((ctx) => {
+  const routePath = resolvedNavigationPath(EXTENSION_ID, 'hello');
+
+  ctx.registerRegistryEntry({
+    registryId: 'core.page',
+    key: 'hello',
+    value: {
+      path: 'hello',
+      title: 'Hello',
+      component: markRaw(HelloPage),
+      resolvedRoutePath: routePath,
+    },
+  });
+
+  ctx.registerRegistryEntry({
+    registryId: 'core.nav',
+    key: 'hello',
+    value: {
+      link: routePath,
+      label: 'Hello',
+      icon: 'home',
+    },
+  });
+});
+```
+
+Сборка и манифест — в [`@rynt/extension-build`](https://www.npmjs.com/package/@rynt/extension-build).
+
+---
+
+## UI в расширении
+
+Компоненты из корневого пакета подключаются через host-shim при сборке (см. extension-build):
+
+```vue
+<script setup lang="ts">
+import { Button, Block, Text } from '@rynt/sdk';
+</script>
+```
+
+Справочник компонентов: [UI-кит](https://docs.rynt.space/sdk/ui/).
+
+---
+
+## Типизация между расширениями
+
+Для `useExtensionExpose` и кастомных реестров используйте module augmentation — [типизация контрактов](https://docs.rynt.space/extensions/typing-contracts).
+
+---
+
+## Требования
+
+- **Node.js** ≥ 20 (для CLI и современного tooling)
+- **Rynt Launcher** с поддержкой **Extension API `1`** (`extensionApi: "1"` в манифесте)
+- **Vue 3.5+** в runtime лаунчера (в бандл расширения Vue не дублируется — один экземпляр с хоста)
+
+---
+
+## См. также
+
+- [Документация](https://docs.rynt.space)
+- [Расширения: обзор](https://docs.rynt.space/extensions/)
+- [Dev-режим (hot reload)](https://docs.rynt.space/extensions/dev-workflow)
+- [Маркетплейс](https://docs.rynt.space/marketplace/)

package/REGISTRIES.md

@@ -0,0 +1,189 @@
+# Реестры расширений
+
+Единая модель: расширения и хост кладут значения под строковым **`registryId`** и ключом **`key`**. У каждой записи в store хранятся **`extensionId`** (кто записал) и опционально **`order`**.
+
+## `extensionId` и хост
+
+- **`extensionId`** всегда **строка** (нет `null`).
+- Записи **самого лаунчера** (код, импортирующий `@rynt/sdk` напрямую, без бандла расширения) получают **`extensionId === 'rynt'`** — константа **`HOST_EXTENSION_ID`** в `packages/sdk/src/registries/extension-scope.ts`.
+- Записи **расширения** получают **`id` манифеста** (например `@rynt/quilt-loader`) из **`ryntExtensionViteConfig({ manifest })`** / собранного **`dist/manifest.json`**.
+
+Откуда берётся id при записи **без параметра** в `register`:
+
+1. **В процессе `setup`** хост оборачивает вызов в `pushExtensionScope(manifest.id)` / `popExtensionScope` — см. `packages/sdk/src/extensions/host.ts`.
+2. **`ctx.registerRegistryEntry`** дополнительно оборачивает запись в `withExtensionScope(ctx.extensionId, …)` — см. `packages/sdk/src/extensions/context.ts`.
+3. **Собранное расширение** импортирует `@rynt/sdk/plugin` (и при необходимости `@rynt/sdk/registries`) через **хост-шимы** из `@rynt/extension-build`: в бандл запекается **`__RYNT_EXTENSION_ID__`** из **`manifest.id`** в Vite-пресете (`ryntExtensionViteConfig`), и каждый вызов метода `use*Registry()` оборачивается в `pushExtensionScope` / `popExtensionScope` с этим id. Подробнее — [packages/extension-build/README.md](../extension-build/README.md).
+
+Публичное API одного реестра — **`ExtensionRegistryApi<T>`** в `packages/sdk/src/registries/extension-registry-api.ts`:
+
+- **`register(key, value, order?)`** — без аргумента `extensionId`; внутри используется **`getCurrentExtensionId()`**.
+- **`get`**, **`has`**, **`keys`**, **`keyValuePairs()`**, **`getMeta`**, **`getAll`**, **`entries()`**, **`delete(key)`**.
+
+Строка **`RegistryRow<T>`** для UI: `registryKey`, `extensionId`, `order?`, **`value: T`**.
+
+---
+
+## Где живут «лаунчерные» реестры (SDK)
+
+Реестры, которые связывают расширения с **конкретным UI и сервисами клиента** (маршруты, меню, слоты интерфейса, лоадеры, провайдеры модов), объявляются **только в `@rynt/sdk`**, в `packages/sdk/src/registries/builtins/`. Строковый **`registryId`** задаётся один раз литералом в **`defineExtensionRegistry<T>('…')`** в соответствующем файле.
+
+| `registryId`       | Тип значения (payload)        | Назначение                                                                         |
+| ------------------ | ----------------------------- | ---------------------------------------------------------------------------------- |
+| `core.page`        | `CorePageItem`                | Маршрут + компонент страницы (`path`, `title?`, `component`, `resolvedRoutePath`). |
+| `core.nav`         | `CoreNavItem`                 | Пункт меню: `link`, `label`, `icon`, `badgeCount?`.                                |
+| `core.sidebar`     | `CoreSidebarItem`             | `placement`: `strip` \| `footer`, `component`.                                     |
+| `core.shell`       | `Component` (Vue)             | Оверлей: сам компонент как значение записи.                                        |
+| `core.userStrip`   | `Component` (Vue)             | То же для действий в строке пользователя.                                          |
+| `core.loader`      | `BaseLoader`                  | Лоадеры Minecraft (ключ = `loader.id`).                                            |
+| `core.modProvider` | `ModMarketplaceProvider`      | Провайдеры маркетплейса модов.                                                     |
+| `core.fileEditor`  | `FileEditorProvider`          | Редактор файлов в IDE сборки.                                                      |
+| `core.theme`       | `ThemeDefinition`             | Темы оформления.                                                                   |
+| `core.accountProvider` | `IAuthProvider`           | Провайдеры входа (ключ = `provider.id`).                                           |
+| `core.inviteHandler` | `InviteHandlerRegistration` | UI/accept инвайтов (ключ = `invite.type`).                                         |
+
+Плюс **визуальные слоты** (`core.buildCardActions`, `core.feedBeforeContent`, `core.modManageActions`, …) — полный перечень с props и примерами:
+
+**[Справочник `core.*` в launcher-docs](../launcher-docs/docs/extensions/core-registries.md)**
+
+Сводная карта типов — `packages/sdk/src/extensions/registries/registry-value-map.ts`.
+
+Из пакета экспортируются **`useExtensionPageRegistry`**, **`useLoaderRegistry`**, **`useModProviderRegistry`** и т.д.
+
+При старте хост расширений вызывает **`ensureCoreExtensionRegistries()`** (в т.ч. из **`initializeRyntExtensions`**) — подтягиваются side-effect объявлений builtin-модулей.
+
+**Встроенные записи хоста** (ванильные лоадеры, Modrinth/CurseForge в маркетплейсе) регистрируются в **`registerBuiltinRegistryEntries`** клиента после **`resetExtensionRegistries`**; при этом scope по умолчанию — **`rynt`**, записи помечаются как лаунчерные.
+
+---
+
+## Как использует клиент (лаунчер)
+
+1. Импорт из **`@rynt/sdk`**: **`useExtension*Registry`**, при необходимости **`RegistryRow`**, **`CorePageItem`**, …
+2. Во Vue — чтение в **`computed`**: **`useXRegistry().entries()`** (или `getAll()` / `keyValuePairs()`), чтобы трекать реактивный store.
+3. В шаблоне: ключ `entry.extensionId` + `entry.registryKey`, данные — **`entry.value`**.
+4. Маршруты страниц — **`syncExtensionRoutes`** / `attachExtensionRoutes` в `packages/sdk/src/extensions/router-bridge.ts` (реестр **`core.page`**).
+5. Запись от имени приложения — тот же **`register(key, value, order?)`** на **`use*Registry()`** (scope = **`rynt`**).
+
+---
+
+## Как использует расширение
+
+Два равноправных способа (оба дают корректный **`extensionId`** при условии актуального **`manifest.id`** и сборки через **`@rynt/extension-build`**):
+
+### 1. Через контекст `setup`
+
+```ts
+defineRyntExtension((ctx) => {
+  ctx.registerRegistryEntry({
+    registryId: 'core.page',
+    key: 'main',
+    value: {
+      /* CorePageItem */
+    },
+    order: 10,
+  });
+});
+```
+
+### 2. Через `use*Registry()` из `@rynt/sdk/plugin`
+
+Удобно, когда нужен тот же API, что у хоста, или регистрация вне явной передачи `ctx`:
+
+```ts
+import { defineRyntExtension, useLoaderRegistry } from '@rynt/sdk/plugin';
+
+defineRyntExtension(() => {
+  const loader = new MyLoader();
+  useLoaderRegistry().register(loader.id, loader);
+});
+```
+
+Для экрана с пунктом в меню обычно две записи: **`core.page`** и **`core.nav`**. Путь в hash-router — **`resolvedNavigationPath(extensionId, slug)`** (для `link` в nav можно взять `ctx.extensionId` или константу, совпадающую с **`manifest.id`** расширения).
+
+Импорты: **`@rynt/sdk/plugin`** — `defineRyntExtension`, `resolvedNavigationPath`, `use*Registry`, `defineExtensionRegistry`, `getExtensionRegistry`, `markModMarketplaceProvider`, …
+
+---
+
+## Маркетплейс модов и обёртка `registerModMarketplaceProvider`
+
+Хелпер **`registerModMarketplaceProvider(provider)`** в `packages/sdk/src/shared/mods/mod-marketplace-registry.ts` внутри вызывает **`useModProviderRegistry().register(...)`** и тем же правилом scope получает **`rynt`** или id расширения.
+
+---
+
+## Класс `loaderRegistry` (`@rynt/sdk/minecraft-loader`)
+
+**`loaderRegistry.register(loader)`** делегирует в **`useLoaderRegistry().register(loader.id, loader)`**. Используйте его, когда удобнее импортировать **`@rynt/sdk/minecraft-loader`**, а не реестр напрямую.
+
+Опциональное поле **`modsProviderLoaderIds`** на **`BaseLoader`** задаёт id для фильтрации в маркетплейсах модов (CurseForge, Modrinth, кастомные провайдеры), если registry **`id`** не совпадает с именами на площадках. Резолв: **`resolveModsProviderLoaderIds(loaderId, providerId)`**.
+
+---
+
+## Свой `registryId`
+
+Уникальная строка (часто префикс расширения + имя слота) и тип **`T`**.
+
+1. **Через `ctx.registerRegistryEntry`** с нужным `registryId`.
+2. **Use-функция** — как в SDK:
+
+   ```ts
+   import { defineExtensionRegistry } from '@rynt/sdk/plugin';
+
+   type MySlotItem = { component: Component; label: string };
+
+   export const useStoredItemRegistry = defineExtensionRegistry<MySlotItem>(
+     '@rynt/my-pack.stored-item',
+   );
+   ```
+
+   Запись из **`setup`**: либо **`ctx.registerRegistryEntry`**, либо **`useStoredItemRegistry().register(key, value, order?)`** (после импорта из плагина — с корректным scope в бандле расширения).
+
+**Манифест** (`contributes.rynt`): **`declaresRegistries`**, **`extendsRegistries`** (с `keys`) — см. `packages/sdk/src/extensions/registries/manifest-rynt.ts` и [docs/marketplace/02-manifest-contract.md](../../docs/marketplace/02-manifest-contract.md).
+
+**Расширение чужого реестра:** `getExtensionRegistry(registryId)` из **`@rynt/sdk/plugin`** / **`@rynt/sdk/registries`** — тот же `register`/`get`/`entries`, что у use-реестра. Тип строки реестра задаётся явным дженериком **`getExtensionRegistry<MyRow>(id)`** или через **`ExtensionRegistryPayloadMap`** (см. ниже), чтобы не импортировать типы из пакета владельца. В манифесте укажите **`extensionDependencies`**, чтобы `setup` шёл после расширения, которое объявляет реестр и записи по умолчанию.
+
+---
+
+## Публичный API расширения (`defineExpose` / `useExtensionExpose`)
+
+Расширение может опубликовать объект, который **читают другие расширения** по **`manifest.id`** поставщика (тот же id, что в **`defineExtensionRegistry`** / scope).
+
+**Запись expose (два равноправных способа):**
+
+1. В **`setup`**: **`ctx.defineExpose(value)`** — сразу кладёт значение в хранилище.
+2. **Результат `setup`**: вернуть **`{ expose: value }`** (или `Promise<…>` с таким полем). После завершения **`setup`** хост применяет `expose` и **перезаписывает** то, что успели задать через **`ctx.defineExpose`**, если использовались оба варианта.
+
+**Чтение у потребителя:** **`getExtensionExpose(id)`** (императивно) или **`useExtensionExpose(id)`** (Vue **`computed`**, реагирует на появление/смену expose — см. **`extensionExposeRevision`** в рантайме).
+
+Типизация: в пакете-поставщике объявляют интерфейс и дополняют карту **`ExtensionExposeMap`** (пустой интерфейс в **`@rynt/sdk/extension-expose-map`**, отдельный subpath пакета **`@rynt/sdk`**). Зависимый пакет импортирует модуль с **`declare module`** (или re-export «контрактного» entry), после чего **`useExtensionExpose('@rynt/…')`** выводит тип без `as`.
+
+Исходники: **`packages/sdk/src/extensions/extension-expose.ts`**, **`packages/sdk/src/extensions/host.ts`** (вызов после `setup`), **`packages/sdk/src/extensions/context.ts`** (**`defineExpose`**).
+
+---
+
+## Типизация значений чужих реестров (`ExtensionRegistryPayloadMap`)
+
+По аналогии с **`ExtensionExposeMap`**: в SDK есть пустой интерфейс **`ExtensionRegistryPayloadMap`** (**`@rynt/sdk/extension-registry-payload-map`**). **Владелец** реестра (тот, кто задаёт **`registryId`** в **`declaresRegistries`** и контракт строки `T`) добавляет в свой пакет файл вида:
+
+```ts
+import type { MyRow } from './types';
+
+declare module '@rynt/sdk/extension-registry-payload-map' {
+  interface ExtensionRegistryPayloadMap {
+    '@rynt/my-pack.my-registry': MyRow;
+  }
+}
+```
+
+и подключает его **side-effect** из entry, который и так импортируют потребители (например **`import './registry-payload-map'`** в **`index.ts`** субмодуля **`./message-types`**).
+
+После этого зависимое расширение пишет **`getExtensionRegistry(MY_REGISTRY_ID)`** без дженерика — тип **`ExtensionRegistryApi<MyRow>`** выводится, если **`MY_REGISTRY_ID`** имеет литеральный тип (константа **`as const`** из пакета владельца). Для **`core.*`** по-прежнему действует **`BuiltinRegistryValueMap`**; приоритет у встроенной карты, если id совпал бы с расширенной (на практике **`core.*`** и id расширений не пересекаются).
+
+Если augmentation не подключён (или аргумент распался до широкого **`string`**), остаётся явный вызов **`getExtensionRegistry<MyRow>(registryId)`** или импорт типа из пакета владельца.
+
+---
+
+## Удалённые / устаревшие API
+
+- **`registerHostRegistryItem`**, **`registerExtensionRegistryItem`** (публично), **`forExtension`**, **`registerFromExtension`** — заменены единым **`register`** + scope.
+- Отдельный литерал **`extensionId: null`** для «хоста» — заменён на строку **`'rynt'`**.
+
+Дополнительно для авторов: **[packages/extension-build/README.md](../extension-build/README.md)**, обзор **[docs/extensions.md](../../docs/extensions.md)**.

package/env.d.ts

@@ -0,0 +1,11 @@
+/** Инструментальный файл типизации без vite-бандла SDK-пакета. Пути приложений задаём только через aliases типового режима typecheck. */
+interface ImportMetaEnv {
+  readonly VITE_PACKAGE_VERSION?: string;
+  readonly MODE?: string;
+  readonly DEV?: boolean;
+  readonly PROD?: boolean;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}

package/host-shims.d.ts

@@ -0,0 +1,30 @@
+/**
+ * При изолированном typecheck SDK пакеты `@/models/*` не монтируются (остаются в хосте).
+ * `any` на границе хост ↔ SDK сохраняет реальную типизацию в клиентском проекте.
+ */
+
+declare module '@/models' {
+  export function useLauncherModel(): any;
+  export function useLocalBuildsModel(): any;
+  export function useUserModel(): any;
+}
+
+declare module '@/models/user' {
+  export function useUserModel(): any;
+}
+
+declare module '@/models/projectServers' {
+  export function useServersModel(): any;
+}
+
+declare module '@/models/accounts/types' {
+  export interface Account {
+    readonly id?: string;
+    readonly profile?: {
+      readonly skinUrl?: string | null;
+      readonly skinSha1?: string | null;
+      readonly [key: string]: unknown;
+    };
+    readonly [key: string]: unknown;
+  }
+}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@rynt/sdk",
+  "version": "0.9.53",
+  "description": "Rynt Launcher SDK — UI kit, extension runtime, and host APIs",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    },
+    "./extension": {
+      "types": "./src/extensions/index.ts",
+      "default": "./src/extensions/index.ts"
+    },
+    "./extension-expose-map": {
+      "types": "./src/extensions/extension-expose-map.ts",
+      "default": "./src/extensions/extension-expose-map.ts"
+    },
+    "./extension-registry-payload-map": {
+      "types": "./src/extensions/registries/extension-registry-payload-map.ts",
+      "default": "./src/extensions/registries/extension-registry-payload-map.ts"
+    },
+    "./extension/registries": {
+      "types": "./src/extensions/registries/index.ts",
+      "default": "./src/extensions/registries/index.ts"
+    },
+    "./host": {
+      "types": "./src/host/index.ts",
+      "default": "./src/host/index.ts"
+    },
+    "./session": {
+      "types": "./src/extensions/session.ts",
+      "default": "./src/extensions/session.ts"
+    },
+    "./tiptap": {
+      "types": "./src/tiptap/index.ts",
+      "default": "./src/tiptap/index.ts"
+    },
+    "./extension-marketplace": {
+      "types": "./src/extension-marketplace/index.ts",
+      "default": "./src/extension-marketplace/index.ts"
+    }
+  },
+  "dependencies": {
+    "@tiptap/core": "^3.20.4",
+    "@tiptap/extension-image": "^3.20.4",
+    "@tiptap/extension-link": "^3.20.4",
+    "@tiptap/extension-text-style": "^3.20.4",
+    "@tiptap/pm": "^3.20.4",
+    "@tiptap/starter-kit": "^3.20.4",
+    "@tiptap/vue-3": "^3.20.4",
+    "@vueuse/core": "^10.11.1",
+    "axios": "^1.7.9",
+    "clsx": "^2.1.1",
+    "echarts": "^6.1.0",
+    "lodash-es": "^4.17.21",
+    "marked": "^17.0.1",
+    "semver": "^7.7.1",
+    "tailwind-merge": "^3.2.0",
+    "vue-advanced-cropper": "^2.8.9",
+    "zod": "^3.23.8"
+  },
+  "peerDependencies": {
+    "vue": "^3.5.0",
+    "vue-router": "^4.6.0"
+  },
+  "peerDependenciesMeta": {
+    "vue-router": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/lodash-es": "^4.17.12",
+    "@types/semver": "^7.7.0",
+    "@vue/tsconfig": "^0.7.0",
+    "typescript": "~5.7.2",
+    "vue": "^3.5.13",
+    "vue-router": "^4.6.4",
+    "vue-tsc": "^2.2.0"
+  },
+  "scripts": {
+    "typecheck": "vue-tsc -p tsconfig.json --noEmit"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "ISC"
+}

package/src/extension-marketplace/api-types.ts

@@ -0,0 +1,141 @@
+import type {
+  RegistryDeclaration,
+  RegistryExtensionContribution,
+} from '../extensions/registries/manifest-rynt';
+
+export type { RegistryDeclaration, RegistryExtensionContribution };
+
+export interface MarketplaceSlotQuery {
+  registryId: string;
+  key: string;
+}
+
+export interface MarketplaceExtensionSummary {
+  id: string;
+  name: string;
+  version: string;
+  /** Короткое описание из манифеста. */
+  description?: string;
+  iconUrl?: string;
+  authorName?: string;
+  downloadUrl: string;
+  artifactSha256?: string;
+}
+
+export type MarketplaceSlotLookupResult =
+  | { kind: 'none' }
+  | { kind: 'one'; extension: MarketplaceExtensionSummary }
+  | { kind: 'many'; extensions: MarketplaceExtensionSummary[] };
+
+export interface MarketplaceExtensionDetail extends MarketplaceExtensionSummary {
+  manifest: Record<string, unknown>;
+  /** Rich-описание (TipTap HTML), хранится на сервере. */
+  listingDescriptionHtml?: string;
+  extensionDependencies?: Record<string, string>;
+  author?: { userId: string; displayName?: string };
+  publishedAt: string;
+  declaresRegistries: RegistryDeclaration[];
+  extendsRegistries: RegistryExtensionContribution[];
+}
+
+export interface MarketplaceSearchQuery {
+  q?: string;
+  registryId?: string;
+  limit?: number;
+  offset?: number;
+}
+
+export interface MarketplaceSearchResponse {
+  items: MarketplaceExtensionSummary[];
+  total: number;
+}
+
+export interface PublishExtensionRequest {
+  manifest: Record<string, unknown>;
+  downloadUrl: string;
+  artifactSha256?: string;
+}
+
+export interface PublishExtensionResponse {
+  id: string;
+  version: string;
+  publishedAt: string;
+}
+
+export type SubmissionStatus = 'draft' | 'pending' | 'approved' | 'rejected';
+
+export interface ExtensionArtifactUploadResult {
+  artifactId: string;
+  s3Key: string;
+  sizeBytes: number;
+  downloadUrl: string;
+}
+
+export interface ExtensionListingMeta {
+  iconUrl?: string;
+  authorName?: string;
+  listingDescriptionHtml?: string;
+}
+
+export interface UpdateExtensionListingRequest {
+  listingDescriptionHtml?: string;
+}
+
+export interface ExtensionSubmission extends ExtensionListingMeta {
+  id: string;
+  extensionId: string;
+  version: string;
+  manifest: Record<string, unknown>;
+  artifactId: string;
+  status: SubmissionStatus;
+  authorUserId: string;
+  reviewerUserId?: string;
+  reviewNote?: string;
+  rejectionReason?: string;
+  submittedAt?: string;
+  reviewedAt?: string;
+  createdAt: string;
+  updatedAt: string;
+  s3Key?: string;
+  sizeBytes?: number;
+  downloadUrl?: string;
+}
+
+export interface CreateSubmissionRequest {
+  artifactId: string;
+  manifest: Record<string, unknown>;
+}
+
+export interface RejectSubmissionRequest {
+  reason?: string;
+  reviewNote?: string;
+}
+
+export interface ApproveSubmissionRequest {
+  reviewNote?: string;
+}
+
+export type MarketplaceApiErrorCode =
+  | 'VALIDATION_ERROR'
+  | 'SLOT_ALREADY_CLAIMED'
+  | 'REGISTRY_ALREADY_DECLARED'
+  | 'DUPLICATE_VERSION'
+  | 'VERSION_NOT_NEWER'
+  | 'SUBMISSION_ALREADY_PENDING'
+  | 'UNAUTHORIZED'
+  | 'NOT_FOUND';
+
+/** Опубликованное расширение (latest) автора — для флоу обновления. */
+export interface DeveloperPublishedExtension extends ExtensionListingMeta {
+  id: string;
+  version: string;
+  name: string;
+  description?: string;
+  publishedAt: string;
+}
+
+export interface MarketplaceApiError {
+  code: MarketplaceApiErrorCode;
+  message: string;
+  details?: Record<string, unknown>;
+}