onreza-release 1.0.1 → 2.1.0

package/dist/types.d.ts

@@ -1,5 +1,9 @@
 /**
- * Конфигурация для gitverse-release
+ * Поддерживаемые Git платформы
+ */
+export type GitPlatform = "gitverse" | "github" | "gitlab";
+/**
+ * Конфигурация для onreza-release
  */
 export interface ReleaseConfig {
     /**
@@ -19,9 +23,9 @@ export interface ReleaseConfig {
      */
     versioning?: VersioningConfig;
     /**
-     * Настройки GitVerse Release
+     * Настройки создания Release (GitVerse, GitHub, GitLab)
      */
-    gitverse?: GitVerseConfig;
+    release?: ReleaseProviderConfig;
     /**
      * Настройки retry механизма
      */
@@ -224,6 +228,14 @@ export interface GitRepoInfo {
      * Текущая ветка
      */
     branch: string;
+    /**
+     * Git платформа (gitverse, github, gitlab)
+     */
+    platform?: GitPlatform;
+    /**
+     * Хост платформы (например: github.com, gitverse.ru)
+     */
+    host?: string;
 }
 /**
  * Conventional Commit
@@ -374,22 +386,37 @@ export interface ReleaseResult {
     warnings: string[];
 }
 /**
- * Конфигурация GitVerse Release
+ * Конфигурация Release Provider (GitVerse, GitHub, GitLab)
  */
-export interface GitVerseConfig {
+export interface ReleaseProviderConfig {
     /**
-     * Включить создание релиза через GitVerse API
-     * Требует переменную окружения GVR_TOKEN
+     * Включить создание релиза через API платформы
+     * Требует соответствующий токен:
+     * - GitVerse: GVR_TOKEN
+     * - GitHub: GITHUB_TOKEN или GH_TOKEN
+     * - GitLab: GITLAB_TOKEN или GL_TOKEN
+     * @default true
      */
     enabled: boolean;
+    /**
+     * Платформа для создания релиза
+     * - "auto": автоопределение по git remote или CI окружению
+     * - "gitverse": GitVerse
+     * - "github": GitHub
+     * - "gitlab": GitLab
+     * @default "auto"
+     */
+    platform: GitPlatform | "auto";
     /**
      * Прерывать процесс релиза при ошибке создания release (после retry)
      * Если false, ошибки логируются как warnings
+     * @default true
      */
     failOnError: boolean;
     /**
      * Проверять существование релиза перед созданием (идемпотентность)
      * Позволяет безопасно перезапускать pipeline
+     * @default true
      */
     checkExisting: boolean;
 }
@@ -508,7 +535,7 @@ export interface CommitlintGeneratorConfig {
 export interface GenerateCommitlintOptions {
     /**
      * Путь к release конфигу
-     * @default ".gitversereleaserc.json"
+     * @default ".onrezarelease.json"
      */
     configPath?: string;
     /**
@@ -596,31 +623,79 @@ export type BinaryPlatform = "linux-x64" | "linux-arm64" | "darwin-x64" | "darwi
  */
 export type BinaryInputFormat = "directory" | "tar.gz";
 /**
- * Допустимые значения для поля os в package.json
+ * Расширение исполняемого файла
  */
-export type NpmOS = "linux" | "darwin" | "win32" | "freebsd" | "openbsd" | "sunos" | "aix";
+export type BinaryExtension = "" | ".exe";
 /**
- * Допустимые значения для поля cpu в package.json
+ * Маппинг платформы на os/arch значения
  */
-export type NpmCPU = "x64" | "arm64" | "ia32" | "arm" | "mips" | "ppc64";
+export interface PlatformMapping {
+    /** Значение для os (linux, darwin, win32) */
+    os: string;
+    /** Значение для arch (x64, arm64) */
+    arch: string;
+    /** Расширение исполняемого файла */
+    extension: BinaryExtension;
+}
 /**
- * Расширение исполняемого файла
+ * Результат загрузки asset в GitVerse Release
  */
-export type BinaryExtension = "" | ".exe";
+export interface BinaryAssetUploadResult {
+    /** Платформа */
+    platform: BinaryPlatform;
+    /** Имя загруженного asset */
+    assetName: string;
+    /** URL для скачивания */
+    downloadUrl: string;
+    /** Успешно ли загружен */
+    success: boolean;
+    /** Сообщение об ошибке */
+    error?: string;
+}
 /**
- * npm scope в формате @org
+ * Провайдер дистрибуции бинарников (абстракция)
  */
-export type NpmScope = `@${string}`;
+export interface BinaryDistributionProvider {
+    /** Загружает файл и возвращает URL для скачивания */
+    uploadAsset(filePath: string, assetName: string): Promise<{
+        downloadUrl: string;
+    }>;
+}
 /**
- * Маппинг платформы на os/cpu значения для package.json
+ * Манифест с URL-ами для скачивания бинарников
  */
-export interface PlatformMapping {
-    /** Значение для поля os в package.json */
-    os: NpmOS;
-    /** Значение для поля cpu в package.json */
-    cpu: NpmCPU;
-    /** Расширение исполняемого файла */
-    extension: BinaryExtension;
+export interface BinaryManifest {
+    /** Версия */
+    version: string;
+    /** Имя бинарника */
+    binName: string;
+    /** Маппинг платформ на URL-ы для скачивания */
+    assets: Record<BinaryPlatform, string>;
+}
+/**
+ * Настройки npm пакета для бинарной дистрибуции
+ */
+export interface BinariesNpmConfig {
+    /**
+     * Генерировать postinstall скрипт и bin wrapper
+     * @default true
+     */
+    generateScripts: boolean;
+    /**
+     * Директория для postinstall скрипта
+     * @default "scripts"
+     */
+    scriptsDir: string;
+    /**
+     * Директория для bin wrapper
+     * @default "bin"
+     */
+    binDir: string;
+    /**
+     * Обновлять package.json с правильными bin и scripts.postinstall
+     * @default true
+     */
+    updatePackageJson: boolean;
 }
 /**
  * Конфигурация бинарной дистрибуции
@@ -632,25 +707,7 @@ export interface BinariesConfig {
      */
     enabled: boolean;
     /**
-     * npm scope (например: @rainypixel)
-     * Опционален — если не указан, пакеты публикуются без scope
-     */
-    scope?: string;
-    /**
-     * Шаблон имени пакета
-     * Плейсхолдеры: {{scope}}, {{name}}, {{platform}}
-     *
-     * @default "{{name}}-{{platform}}" (без scope)
-     * @default "@{{scope}}/{{name}}-{{platform}}" (со scope)
-     *
-     * @example
-     * "{{name}}-{{platform}}" → "myapp-linux-x64"
-     * "@{{scope}}/{{name}}-{{platform}}" → "@org/myapp-linux-x64"
-     * "{{name}}-bin-{{platform}}" → "myapp-bin-linux-x64"
-     */
-    packageNameTemplate?: string;
-    /**
-     * Базовое имя пакетов (например: yougile)
+     * Базовое имя бинарника (например: yougile)
      */
     name: string;
     /**
@@ -663,60 +720,32 @@ export interface BinariesConfig {
      * @default "./dist"
      */
     distDir: string;
-    /**
-     * Директория для генерации пакетов
-     * @default "./npm"
-     */
-    outDir: string;
     /**
      * Список платформ для публикации
      * @default ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64", "win32-x64"]
      */
     platforms: BinaryPlatform[];
-    /**
-     * Команда для публикации пакетов
-     * Поддерживает плейсхолдеры: {{packageDir}}, {{version}}, {{platform}}
-     * @default "npm publish --access public"
-     */
-    publishCommand: string;
-    /**
-     * Путь к основному package.json для обновления optionalDependencies
-     * @default "./package.json"
-     */
-    mainPackage: string;
-    /**
-     * Продолжать при ошибке публикации отдельной платформы
-     * @default false
-     */
-    continueOnError: boolean;
-    /**
-     * Количество попыток retry при ошибке публикации
-     * @default 3
-     */
-    retryAttempts: number;
     /**
      * Формат входных данных для бинарников
      * - "directory": бинарники в директориях (dist/name-platform/name)
      * - "tar.gz": бинарники в tar.gz архивах (dist/name-platform.tar.gz)
-     * @default "directory"
+     * @default "tar.gz"
      */
     inputFormat?: BinaryInputFormat;
     /**
      * Шаблон имени архива.
      * Плейсхолдеры: {{name}}, {{platform}}
-     * Используется только при inputFormat: "tar.gz"
      * @default "{{name}}-{{platform}}.tar.gz"
      */
     archiveNameTemplate?: string;
     /**
      * Имя бинарника внутри архива (если отличается от name)
-     * Используется только при inputFormat: "tar.gz"
      */
     sourceBinName?: string;
     /**
-     * Маппинг имён файлов/директорий источника на npm платформы
+     * Маппинг имён файлов/директорий источника на платформы
      * Ключ - идентификатор в имени файла (например: "linux-x64")
-     * Значение - npm платформа (например: "linux-x64")
+     * Значение - платформа (например: "linux-x64")
      *
      * @example
      * {
@@ -726,61 +755,46 @@ export interface BinariesConfig {
      * }
      */
     platformMap?: Record<string, BinaryPlatform>;
+    /**
+     * Количество попыток retry при ошибке загрузки
+     * @default 3
+     */
+    retryAttempts: number;
+    /**
+     * Продолжать при ошибке загрузки отдельной платформы
+     * @default false
+     */
+    continueOnError: boolean;
+    /**
+     * Настройки генерации npm пакета
+     * Генерирует postinstall скрипт который скачивает бинарник с Release
+     */
+    npm?: BinariesNpmConfig;
 }
 /**
- * Успешный результат генерации платформенного пакета
- */
-export interface BinaryPackageSuccess {
-    /** Платформа */
-    platform: BinaryPlatform;
-    /** Путь к сгенерированному пакету */
-    packageDir: string;
-    /** Полное имя пакета (например: @rainypixel/yougile-linux-x64) */
-    packageName: string;
-    /** Успешно сгенерирован */
-    success: true;
-}
-/**
- * Неуспешный результат генерации платформенного пакета
- */
-export interface BinaryPackageFailure {
-    /** Платформа */
-    platform: BinaryPlatform;
-    /** Путь к сгенерированному пакету (может отсутствовать при ошибке) */
-    packageDir: string;
-    /** Полное имя пакета */
-    packageName: string;
-    /** Не удалось сгенерировать */
-    success: false;
-    /** Сообщение об ошибке */
-    error: string;
-}
-/**
- * Результат генерации платформенного пакета (discriminated union)
- */
-export type BinaryPackageResult = BinaryPackageSuccess | BinaryPackageFailure;
-/**
- * Успешный результат публикации платформенного пакета
+ * Успешный результат загрузки asset
  */
-export interface BinaryPublishSuccess {
+export interface BinaryUploadSuccess {
     /** Платформа */
     platform: BinaryPlatform;
-    /** Полное имя пакета */
-    packageName: string;
-    /** Успешно опубликован */
+    /** Имя asset */
+    assetName: string;
+    /** URL для скачивания */
+    downloadUrl: string;
+    /** Успешно загружен */
     success: true;
     /** Количество попыток */
     attempts: number;
 }
 /**
- * Неуспешный результат публикации платформенного пакета
+ * Неуспешный результат загрузки asset
  */
-export interface BinaryPublishFailure {
+export interface BinaryUploadFailure {
     /** Платформа */
     platform: BinaryPlatform;
-    /** Полное имя пакета */
-    packageName: string;
-    /** Не удалось опубликовать */
+    /** Имя asset */
+    assetName: string;
+    /** Не удалось загрузить */
     success: false;
     /** Сообщение об ошибке */
     error: string;
@@ -788,9 +802,9 @@ export interface BinaryPublishFailure {
     attempts: number;
 }
 /**
- * Результат публикации платформенного пакета (discriminated union)
+ * Результат загрузки asset (discriminated union)
  */
-export type BinaryPublishResult = BinaryPublishSuccess | BinaryPublishFailure;
+export type BinaryUploadResult = BinaryUploadSuccess | BinaryUploadFailure;
 /**
  * Общий результат бинарной дистрибуции
  */
@@ -799,10 +813,12 @@ export interface BinaryDistributionResult {
     success: boolean;
     /** Версия */
     version: string;
-    /** Результаты генерации пакетов */
-    packages: BinaryPackageResult[];
-    /** Результаты публикации */
-    published: BinaryPublishResult[];
+    /** ID созданного релиза */
+    releaseId?: number;
+    /** URL релиза */
+    releaseUrl?: string;
+    /** Результаты загрузки assets */
+    uploads: BinaryUploadResult[];
     /** Ошибки */
     errors: string[];
     /** Предупреждения */
@@ -832,7 +848,7 @@ export type BinaryExtractionResult = BinaryExtractionSuccess | BinaryExtractionF
  */
 export interface BinaryCliOptions {
     /**
-     * Тестовый прогон (не публиковать)
+     * Тестовый прогон (не загружать)
      */
     dryRun?: boolean;
     /**
@@ -843,20 +859,40 @@ export interface BinaryCliOptions {
      * Override версии
      */
     version?: string;
-    /**
-     * Только генерация пакетов (без публикации)
-     */
-    generateOnly?: boolean;
-    /**
-     * Не обновлять основной package.json
-     */
-    skipMainPackage?: boolean;
     /**
      * Конкретные платформы для обработки
      */
     platforms?: BinaryPlatform[];
+    /**
+     * Тег релиза (по умолчанию создаётся новый релиз)
+     */
+    tag?: string;
     /**
      * Подробный вывод
      */
     verbose?: boolean;
 }
+/**
+ * Лимиты GitVerse для артефактов релиза
+ */
+export interface GitVerseAssetLimits {
+    /** Максимальный размер одного файла (100 МБ) */
+    maxFileSizeBytes: number;
+    /** Максимальное количество файлов за раз */
+    maxFilesPerUpload: number;
+    /** Максимальный совокупный размер за раз (500 МБ) */
+    maxTotalSizeBytes: number;
+    /** Допустимые расширения файлов */
+    allowedExtensions: string[];
+}
+/**
+ * Результат валидации asset
+ */
+export interface AssetValidationResult {
+    /** Валиден ли файл */
+    valid: boolean;
+    /** Сообщение об ошибке */
+    error?: string;
+    /** Размер файла */
+    sizeBytes?: number;
+}

package/dist/utils/binary-distribution-provider.d.ts

@@ -0,0 +1,50 @@
+import type { GitVerseReleaseProvider } from "../providers";
+import type { AssetValidationResult, BinaryDistributionProvider, GitVerseAssetLimits } from "../types";
+/**
+ * Лимиты GitVerse для артефактов релиза
+ */
+export declare const GITVERSE_ASSET_LIMITS: GitVerseAssetLimits;
+/**
+ * Форматирует размер файла в человекочитаемый формат
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Валидирует файл для загрузки в GitVerse Release
+ *
+ * @param filePath - Путь к файлу
+ * @returns Результат валидации
+ */
+export declare function validateAssetFile(filePath: string): Promise<AssetValidationResult>;
+/**
+ * Валидирует набор файлов для загрузки
+ *
+ * @param filePaths - Массив путей к файлам
+ * @returns Результат валидации с совокупным размером
+ */
+export declare function validateAssetBatch(filePaths: string[]): Promise<{
+    valid: boolean;
+    errors: string[];
+    totalSize: number;
+}>;
+/**
+ * GitVerse провайдер дистрибуции бинарников
+ */
+export declare class GitVerseDistributionProvider implements BinaryDistributionProvider {
+    private client;
+    private releaseId;
+    constructor(client: GitVerseReleaseProvider, releaseId: number);
+    /**
+     * Загружает файл как asset в релиз
+     *
+     * @param filePath - Путь к файлу
+     * @param assetName - Имя asset в релизе
+     * @returns URL для скачивания
+     */
+    uploadAsset(filePath: string, assetName: string): Promise<{
+        downloadUrl: string;
+    }>;
+    /**
+     * Возвращает ID релиза
+     */
+    get id(): number;
+}

package/dist/utils/binary-platforms.d.ts

@@ -1,6 +1,6 @@
 import type { BinariesConfig, BinaryPlatform, PlatformMapping } from "../types";
 /**
- * Маппинг платформ на os/cpu значения для package.json
+ * Маппинг платформ на os/arch значения
  */
 export declare const PLATFORM_MAPPINGS: Record<BinaryPlatform, PlatformMapping>;
 /**
@@ -35,30 +35,6 @@ export declare function validateBinaryExists(distDir: string, name: string, plat
  * @returns Массив отсутствующих платформ
  */
 export declare function validateAllBinaries(distDir: string, name: string, platforms: BinaryPlatform[]): Promise<BinaryPlatform[]>;
-/**
- * Возвращает дефолтный шаблон имени пакета
- */
-export declare function getDefaultPackageNameTemplate(scope?: string): string;
-/**
- * Генерирует полное имя пакета для платформы.
- * Поддерживает кастомный шаблон через packageNameTemplate.
- */
-export declare function getPackageName(config: BinariesConfig, platform: BinaryPlatform): string;
-/**
- * Генерирует путь к пакету в output директории.
- * Создаёт структуру директорий на основе имени пакета.
- */
-export declare function getPackageOutputPath(config: BinariesConfig, platform: BinaryPlatform): string;
-/**
- * Раскрывает плейсхолдеры в строке
- */
-export declare function expandPlaceholders(template: string, values: {
-    packageDir?: string;
-    version?: string;
-    platform?: string;
-    scope?: string;
-    name?: string;
-}): string;
 /**
  * Конвертирует платформу в Node.js process.platform и process.arch
  */

package/dist/utils/binary-postinstall-generator.d.ts

@@ -0,0 +1,67 @@
+import type { BinariesNpmConfig, BinaryManifest, BinaryPlatform } from "../types";
+/**
+ * Генерирует postinstall скрипт для скачивания бинарника
+ *
+ * @param manifest - Манифест с URL-ами для скачивания
+ * @returns JavaScript код postinstall скрипта
+ */
+export declare function generatePostinstallScript(manifest: BinaryManifest): string;
+/**
+ * Генерирует простой wrapper скрипт для bin/
+ *
+ * @param binName - Имя бинарника
+ * @returns JavaScript код wrapper скрипта
+ */
+export declare function generateBinWrapper(binName: string): string;
+/**
+ * Создаёт манифест для бинарной дистрибуции
+ *
+ * @param version - Версия
+ * @param binName - Имя бинарника
+ * @param assets - Маппинг платформ на URL-ы
+ * @returns Манифест
+ */
+export declare function createBinaryManifest(version: string, binName: string, assets: Partial<Record<BinaryPlatform, string>>): BinaryManifest;
+/**
+ * Генерирует package.json для мастер-пакета с postinstall
+ *
+ * @param name - Имя пакета
+ * @param version - Версия
+ * @param binName - Имя бинарника
+ * @param description - Описание пакета
+ * @returns Содержимое package.json
+ */
+export declare function generateMasterPackageJson(name: string, version: string, binName: string, description?: string): string;
+/**
+ * Опции для записи npm файлов
+ */
+export interface WriteNpmFilesOptions {
+    /** Манифест с URL-ами */
+    manifest: BinaryManifest;
+    /** Имя бинарника для wrapper */
+    binName: string;
+    /** Настройки npm */
+    npmConfig: BinariesNpmConfig;
+    /** Базовая директория проекта */
+    baseDir?: string;
+    /** Dry-run режим */
+    dryRun?: boolean;
+}
+/**
+ * Результат записи npm файлов
+ */
+export interface WriteNpmFilesResult {
+    /** Путь к postinstall скрипту */
+    postinstallPath: string;
+    /** Путь к bin wrapper */
+    binWrapperPath: string;
+    /** Был ли обновлён package.json */
+    packageJsonUpdated: boolean;
+}
+/**
+ * Записывает postinstall скрипт и bin wrapper в проект
+ *
+ * @param options - Опции записи
+ * @returns Результат записи
+ */
+export declare function writeNpmFiles(options: WriteNpmFilesOptions): Promise<WriteNpmFilesResult>;

package/dist/utils/git.d.ts

@@ -18,7 +18,7 @@ export declare function gitCommand(command: string): Promise<string>;
  * Получает информацию о Git репозитории
  *
  * Приоритет источников данных:
- * 1. Переменные окружения GitVerse Actions (для CI/CD)
+ * 1. Переменные окружения CI (GitVerse Actions, GitHub Actions, GitLab CI)
  * 2. Git remote URL (для локального использования)
  */
 export declare function getRepoInfo(): Promise<GitRepoInfo>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "onreza-release",
-  "version": "1.0.1",
+  "version": "2.1.0",
   "description": "Conventional Commits release automation tool with GitVerse and GitHub support",
   "keywords": [
     "release",
@@ -55,13 +55,13 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@onreza/gitverse-sdk": ">=0.0.0",
+    "@onreza/gitverse-sdk": ">=1.0.2",
     "jsonc-parser": "^3.3.1",
     "tar": "^7.5.3"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.3.11",
-    "@types/bun": "1.3.6",
+    "@types/bun": "1.3.8",
     "typescript": "^5.9.3"
   },
   "publishConfig": {