gitverse-release 3.5.0 → 3.6.0

package/dist/types.d.ts

@@ -30,6 +30,10 @@ export interface ReleaseConfig {
      * Настройки генерации commitlint конфига
      */
     commitlint?: CommitlintGeneratorConfig;
+    /**
+     * Настройки бинарной дистрибуции
+     */
+    binaries?: BinariesConfig;
 }
 /**
  * Конфигурация monorepo
@@ -576,3 +580,207 @@ export interface GenerateCommitlintOptions {
      */
     verbose?: boolean;
 }
+/**
+ * Поддерживаемые платформы для бинарной дистрибуции
+ */
+export type BinaryPlatform = "linux-x64" | "linux-arm64" | "darwin-x64" | "darwin-arm64" | "win32-x64" | "win32-arm64";
+/**
+ * Допустимые значения для поля os в package.json
+ */
+export type NpmOS = "linux" | "darwin" | "win32" | "freebsd" | "openbsd" | "sunos" | "aix";
+/**
+ * Допустимые значения для поля cpu в package.json
+ */
+export type NpmCPU = "x64" | "arm64" | "ia32" | "arm" | "mips" | "ppc64";
+/**
+ * Расширение исполняемого файла
+ */
+export type BinaryExtension = "" | ".exe";
+/**
+ * npm scope в формате @org
+ */
+export type NpmScope = `@${string}`;
+/**
+ * Маппинг платформы на os/cpu значения для package.json
+ */
+export interface PlatformMapping {
+    /** Значение для поля os в package.json */
+    os: NpmOS;
+    /** Значение для поля cpu в package.json */
+    cpu: NpmCPU;
+    /** Расширение исполняемого файла */
+    extension: BinaryExtension;
+}
+/**
+ * Конфигурация бинарной дистрибуции
+ */
+export interface BinariesConfig {
+    /**
+     * Включить бинарную дистрибуцию
+     * @default false
+     */
+    enabled: boolean;
+    /**
+     * npm scope (например: @rainypixel)
+     */
+    scope: string;
+    /**
+     * Базовое имя пакетов (например: yougile)
+     */
+    name: string;
+    /**
+     * Имя бинарника в $PATH
+     * @default значение name
+     */
+    binName?: string;
+    /**
+     * Директория с бинарниками (dist/yougile-linux-x64, etc.)
+     * @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;
+}
+/**
+ * Успешный результат генерации платформенного пакета
+ */
+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;
+/**
+ * Успешный результат публикации платформенного пакета
+ */
+export interface BinaryPublishSuccess {
+    /** Платформа */
+    platform: BinaryPlatform;
+    /** Полное имя пакета */
+    packageName: string;
+    /** Успешно опубликован */
+    success: true;
+    /** Количество попыток */
+    attempts: number;
+}
+/**
+ * Неуспешный результат публикации платформенного пакета
+ */
+export interface BinaryPublishFailure {
+    /** Платформа */
+    platform: BinaryPlatform;
+    /** Полное имя пакета */
+    packageName: string;
+    /** Не удалось опубликовать */
+    success: false;
+    /** Сообщение об ошибке */
+    error: string;
+    /** Количество попыток */
+    attempts: number;
+}
+/**
+ * Результат публикации платформенного пакета (discriminated union)
+ */
+export type BinaryPublishResult = BinaryPublishSuccess | BinaryPublishFailure;
+/**
+ * Общий результат бинарной дистрибуции
+ */
+export interface BinaryDistributionResult {
+    /** Успешно ли выполнена операция */
+    success: boolean;
+    /** Версия */
+    version: string;
+    /** Результаты генерации пакетов */
+    packages: BinaryPackageResult[];
+    /** Результаты публикации */
+    published: BinaryPublishResult[];
+    /** Ошибки */
+    errors: string[];
+    /** Предупреждения */
+    warnings: string[];
+}
+/**
+ * CLI опции для бинарной дистрибуции
+ */
+export interface BinaryCliOptions {
+    /**
+     * Тестовый прогон (не публиковать)
+     */
+    dryRun?: boolean;
+    /**
+     * Путь к конфиг файлу
+     */
+    config?: string;
+    /**
+     * Override версии
+     */
+    version?: string;
+    /**
+     * Только генерация пакетов (без публикации)
+     */
+    generateOnly?: boolean;
+    /**
+     * Не обновлять основной package.json
+     */
+    skipMainPackage?: boolean;
+    /**
+     * Конкретные платформы для обработки
+     */
+    platforms?: BinaryPlatform[];
+    /**
+     * Подробный вывод
+     */
+    verbose?: boolean;
+}

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

@@ -0,0 +1,21 @@
+import type { BinariesConfig, BinaryPackageResult, BinaryPlatform } from "../types";
+/**
+ * Генерирует package.json для платформенного пакета
+ */
+export declare function generatePlatformPackageJson(config: BinariesConfig, platform: BinaryPlatform, version: string): string;
+/**
+ * Генерирует README.md для платформенного пакета
+ */
+export declare function generatePlatformReadme(config: BinariesConfig, platform: BinaryPlatform, version: string): string;
+/**
+ * Генерирует платформенный пакет
+ */
+export declare function generatePlatformPackage(config: BinariesConfig, platform: BinaryPlatform, version: string, dryRun?: boolean): Promise<BinaryPackageResult>;
+/**
+ * Генерирует все платформенные пакеты
+ */
+export declare function generateAllPlatformPackages(config: BinariesConfig, version: string, platforms?: BinaryPlatform[], dryRun?: boolean): Promise<BinaryPackageResult[]>;
+/**
+ * Печатает информацию о генерации в dry-run режиме
+ */
+export declare function printGenerationDryRun(config: BinariesConfig, version: string, platforms: BinaryPlatform[]): void;

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

@@ -0,0 +1,62 @@
+import type { BinaryPlatform, PlatformMapping } from "../types";
+/**
+ * Маппинг платформ на os/cpu значения для package.json
+ */
+export declare const PLATFORM_MAPPINGS: Record<BinaryPlatform, PlatformMapping>;
+/**
+ * Все поддерживаемые платформы
+ */
+export declare const ALL_PLATFORMS: BinaryPlatform[];
+/**
+ * Проверяет, что строка является валидной платформой
+ */
+export declare function isValidPlatform(value: string): value is BinaryPlatform;
+/**
+ * Парсит список платформ из строки (comma-separated)
+ */
+export declare function parsePlatforms(value: string): BinaryPlatform[];
+/**
+ * Возвращает путь к бинарнику для указанной платформы
+ */
+export declare function getBinaryPath(distDir: string, name: string, platform: BinaryPlatform): string;
+/**
+ * Возвращает путь к директории платформы
+ */
+export declare function getPlatformDir(distDir: string, name: string, platform: BinaryPlatform): string;
+/**
+ * Проверяет существование бинарника для платформы.
+ *
+ * @returns true если файл существует, false если файл не найден (ENOENT)
+ * @throws Error при других ошибках доступа (EACCES, ELOOP, EIO и т.д.)
+ */
+export declare function validateBinaryExists(distDir: string, name: string, platform: BinaryPlatform): Promise<boolean>;
+/**
+ * Валидирует наличие бинарников для всех указанных платформ
+ * @returns Массив отсутствующих платформ
+ */
+export declare function validateAllBinaries(distDir: string, name: string, platforms: BinaryPlatform[]): Promise<BinaryPlatform[]>;
+/**
+ * Генерирует полное имя пакета для платформы
+ */
+export declare function getPackageName(scope: string, name: string, platform: BinaryPlatform): string;
+/**
+ * Генерирует путь к пакету в output директории
+ */
+export declare function getPackageOutputPath(outDir: string, scope: string, name: string, 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
+ */
+export declare function platformToNodeValues(platform: BinaryPlatform): {
+    platform: string;
+    arch: string;
+};

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

@@ -0,0 +1,53 @@
+import type { BinariesConfig, BinaryPackageResult, BinaryPlatform, BinaryPublishResult } from "../types";
+/**
+ * Вычисляет задержку с экспоненциальным backoff.
+ *
+ * Формула: delay = initialDelay * 2^attempt, ограничено maxDelay.
+ *
+ * Примеры (с дефолтными параметрами):
+ * - attempt 0: 2000ms
+ * - attempt 1: 4000ms
+ * - attempt 2: 8000ms
+ * - attempt 3: 16000ms
+ * - attempt 4+: 30000ms (max)
+ *
+ * @param attempt - Номер попытки (начиная с 0)
+ * @param initialDelay - Начальная задержка в мс (default: 2000)
+ * @param maxDelay - Максимальная задержка в мс (default: 30000)
+ * @returns Задержка в миллисекундах
+ */
+export declare function calculateDelay(attempt: number, initialDelay?: number, maxDelay?: number): number;
+/**
+ * Проверяет, можно ли повторить операцию после ошибки.
+ *
+ * Retriable ошибки (временные, имеет смысл повторить):
+ * - Сетевые ошибки: network timeout, ECONNRESET, ETIMEDOUT
+ * - Ограничения rate limit: HTTP 429, HTTP 503
+ * - Временные ошибки npm registry: registry unavailable, ETARGET
+ *
+ * Не-retriable ошибки (постоянные, повторять бессмысленно):
+ * - Ошибки авторизации (401, 403)
+ * - Невалидные данные (400)
+ * - Пакет уже существует (409)
+ * - Ошибки файловой системы
+ *
+ * @param error - Любое значение ошибки
+ * @returns true если ошибка носит временный характер и retry может помочь
+ */
+export declare function isRetriableError(error: unknown): boolean;
+/**
+ * Публикует один платформенный пакет
+ */
+export declare function publishPlatformPackage(config: BinariesConfig, platform: BinaryPlatform, version: string, dryRun?: boolean): Promise<BinaryPublishResult>;
+/**
+ * Публикует все платформенные пакеты
+ */
+export declare function publishAllPlatformPackages(config: BinariesConfig, version: string, generatedPackages: BinaryPackageResult[], dryRun?: boolean, verbose?: boolean): Promise<BinaryPublishResult[]>;
+/**
+ * Печатает информацию о публикации в dry-run режиме
+ */
+export declare function printPublishDryRun(config: BinariesConfig, generatedPackages: BinaryPackageResult[]): void;
+/**
+ * Печатает итоговую статистику публикации
+ */
+export declare function printPublishSummary(results: BinaryPublishResult[], _config: BinariesConfig): void;

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

@@ -0,0 +1,34 @@
+import type { BinariesConfig, BinaryPlatform } from "../types";
+/**
+ * Генерирует JS wrapper скрипт для bin/
+ */
+export declare function generateBinaryWrapper(config: BinariesConfig): string;
+/**
+ * Интерфейс для optionalDependencies
+ */
+export interface OptionalDependencies {
+    [key: string]: string;
+}
+/**
+ * Генерирует объект optionalDependencies для основного package.json
+ */
+export declare function generateOptionalDependencies(config: BinariesConfig, version: string, platforms?: BinaryPlatform[]): OptionalDependencies;
+/**
+ * Обновления для основного package.json
+ */
+export interface MainPackageUpdates {
+    optionalDependencies: OptionalDependencies;
+    bin?: Record<string, string>;
+}
+/**
+ * Генерирует обновления для основного package.json
+ */
+export declare function generateMainPackageUpdates(config: BinariesConfig, version: string, platforms?: BinaryPlatform[]): MainPackageUpdates;
+/**
+ * Обновляет основной package.json с optionalDependencies
+ */
+export declare function updateMainPackageJson(packagePath: string, config: BinariesConfig, version: string, platforms?: BinaryPlatform[], dryRun?: boolean): Promise<void>;
+/**
+ * Печатает информацию об обновлениях main package в dry-run режиме
+ */
+export declare function printMainPackageUpdatesDryRun(config: BinariesConfig, version: string, platforms?: BinaryPlatform[]): void;

package/dist/utils/git.d.ts

@@ -9,6 +9,11 @@ export declare function executeCommand(command: string): Promise<string>;
  * Возвращает false если хук упал с ошибкой
  */
 export declare function runBeforeCommitHook(command: string): Promise<boolean>;
+/**
+ * Выполняет git команду
+ * Экспортируется для тестирования (позволяет мокать через spyOn)
+ */
+export declare function gitCommand(command: string): Promise<string>;
 /**
  * Получает информацию о Git репозитории
  *
@@ -69,6 +74,9 @@ export declare function isWorkingTreeClean(): Promise<boolean>;
  */
 export declare function addChangedFiles(): Promise<void>;
 /**
- * Проверяет, что тег существует
+ * Проверяет, что тег существует.
+ *
+ * @returns true если тег существует, false если тег не найден
+ * @throws Error при критических ошибках git (повреждённый репозиторий, git не найден)
  */
 export declare function tagExists(tag: string): Promise<boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitverse-release",
-  "version": "3.5.0",
+  "version": "3.6.0",
   "description": "Conventional Commits release automation tool for GitVerse",
   "keywords": [
     "gitverse",
@@ -47,11 +47,11 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "gitverse-api-sdk": "4.0.2"
+    "gitverse-api-sdk": "5.2.0",
+    "jsonc-parser": "^3.3.1"
   },
   "devDependencies": {
     "@types/bun": "1.3.6",
-    "bun-plugin-dts": "^0.3.0",
     "typescript": "^5.9.3"
   },
   "publishConfig": {

package/schema.json

@@ -3,6 +3,87 @@
   "additionalProperties": false,
   "description": "Configuration file for gitverse-release tool",
   "properties": {
+    "$schema": {
+      "description": "JSON Schema reference for IDE support",
+      "type": "string"
+    },
+    "binaries": {
+      "default": {
+        "continueOnError": false,
+        "distDir": "./dist",
+        "enabled": false,
+        "mainPackage": "./package.json",
+        "name": "",
+        "outDir": "./npm",
+        "platforms": ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64", "win32-x64"],
+        "publishCommand": "npm publish --access public",
+        "retryAttempts": 3,
+        "scope": ""
+      },
+      "description": "Binary distribution settings for publishing platform-specific npm packages",
+      "properties": {
+        "binName": {
+          "description": "Binary name in $PATH. Defaults to 'name' value",
+          "type": "string"
+        },
+        "continueOnError": {
+          "default": false,
+          "description": "Continue publishing remaining packages if one fails",
+          "type": "boolean"
+        },
+        "distDir": {
+          "default": "./dist",
+          "description": "Directory containing platform-specific binaries (e.g., dist/yougile-linux-x64/yougile)",
+          "type": "string"
+        },
+        "enabled": {
+          "default": false,
+          "description": "Enable binary distribution",
+          "type": "boolean"
+        },
+        "mainPackage": {
+          "default": "./package.json",
+          "description": "Path to main package.json for updating optionalDependencies",
+          "type": "string"
+        },
+        "name": {
+          "description": "Base name for packages (e.g., 'yougile' creates @scope/yougile-linux-x64)",
+          "type": "string"
+        },
+        "outDir": {
+          "default": "./npm",
+          "description": "Output directory for generated npm packages",
+          "type": "string"
+        },
+        "platforms": {
+          "default": ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64", "win32-x64"],
+          "description": "Platforms to publish",
+          "items": {
+            "enum": ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64", "win32-x64", "win32-arm64"],
+            "type": "string"
+          },
+          "type": "array",
+          "uniqueItems": true
+        },
+        "publishCommand": {
+          "default": "npm publish --access public",
+          "description": "Command to publish packages. Supports placeholders: {{packageDir}}, {{version}}, {{platform}}, {{scope}}, {{name}}",
+          "type": "string"
+        },
+        "retryAttempts": {
+          "default": 3,
+          "description": "Number of retry attempts for publish command",
+          "maximum": 10,
+          "minimum": 1,
+          "type": "integer"
+        },
+        "scope": {
+          "description": "npm scope for platform packages (e.g., '@rainypixel')",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "changelog": {
       "default": {
         "showAuthor": true,