onreza-release 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,862 @@
+/**
+ * Конфигурация для gitverse-release
+ */
+export interface ReleaseConfig {
+    /**
+     * Настройки для monorepo
+     */
+    monorepo?: MonorepoConfig;
+    /**
+     * Настройки генерации CHANGELOG
+     */
+    changelog?: ChangelogConfig;
+    /**
+     * Настройки Git операций
+     */
+    git?: GitConfig;
+    /**
+     * Настройки версионирования
+     */
+    versioning?: VersioningConfig;
+    /**
+     * Настройки GitVerse Release
+     */
+    gitverse?: GitVerseConfig;
+    /**
+     * Настройки retry механизма
+     */
+    retry?: RetryConfig;
+    /**
+     * Настройки генерации commitlint конфига
+     */
+    commitlint?: CommitlintGeneratorConfig;
+    /**
+     * Настройки бинарной дистрибуции
+     */
+    binaries?: BinariesConfig;
+}
+/**
+ * Конфигурация monorepo
+ */
+export interface MonorepoConfig {
+    /**
+     * Включен ли режим monorepo
+     */
+    enabled: boolean;
+    /**
+     * Список пакетов в monorepo
+     */
+    packages: PackageConfig[];
+}
+/**
+ * Конфигурация отдельного пакета в monorepo
+ */
+export interface PackageConfig {
+    /**
+     * Короткое имя пакета (для CLI)
+     */
+    name: string;
+    /**
+     * Путь к директории пакета
+     */
+    path: string;
+    /**
+     * Название пакета в package.json
+     */
+    packageName: string;
+    /**
+     * Префикс для git тега (например: "sdk-v")
+     */
+    tagPrefix: string;
+    /**
+     * Путь к CHANGELOG файлу
+     */
+    changelog: string;
+}
+/**
+ * Конфигурация CHANGELOG
+ */
+export interface ChangelogConfig {
+    /**
+     * Mapping типов коммитов на заголовки секций
+     */
+    types: Record<string, string>;
+    /**
+     * Показывать ли автора коммита
+     */
+    showAuthor: boolean;
+    /**
+     * Показывать ли хеш коммита
+     */
+    showHash: boolean;
+}
+/**
+ * Конфигурация Git операций
+ */
+export interface GitConfig {
+    /**
+     * Команда для выполнения перед коммитом (например: "bun run format")
+     */
+    beforeCommit?: string;
+    /**
+     * Создавать ли коммит с изменениями
+     */
+    commitChanges: boolean;
+    /**
+     * Шаблон сообщения коммита (поддерживает {{package}} и {{version}})
+     */
+    commitMessage: string;
+    /**
+     * Шаблон сообщения для тега (поддерживает {{package}} и {{version}})
+     */
+    tagMessage: string;
+    /**
+     * Пушить ли изменения в remote
+     */
+    push: boolean;
+    /**
+     * Использовать GVR_TOKEN для git push через HTTPS.
+     * Полезно для CI/CD когда нужно пушить в protected branches.
+     * Токен должен иметь права на запись в репозиторий.
+     * @default false
+     */
+    useTokenForPush?: boolean;
+}
+/**
+ * Конфигурация версионирования
+ */
+export interface VersioningConfig {
+    /**
+     * Разрешены ли prerelease версии
+     */
+    allowPrerelease: boolean;
+    /**
+     * Префикс для prerelease версий (beta, alpha, rc)
+     */
+    prereleasePrefix: string;
+    /**
+     * Префикс для git тега (например: "v", "sdk-v", "release-v")
+     */
+    tagPrefix: string;
+    /**
+     * Pre-major режим для BREAKING CHANGES
+     *
+     * Контролирует поведение BREAKING CHANGE в коммитах:
+     * - "auto" (default): версии < 1.0.0 → minor bump, >= 1.0.0 → major bump
+     * - "enabled": всегда minor bump (полезно для experimental проектов)
+     * - "disabled": всегда major bump (стандартный semver)
+     * - "<version>": minor bump пока версия < указанной (например "2.0.0")
+     *
+     * @default "auto"
+     * @example
+     * "auto"     // 0.5.0 + BREAKING → 0.6.0, затем 1.0.0 + BREAKING → 2.0.0
+     * "enabled"  // 1.5.0 + BREAKING → 1.6.0 (всегда minor)
+     * "2.0.0"    // 1.5.0 + BREAKING → 1.6.0, затем 2.0.0 + BREAKING → 3.0.0
+     */
+    preMajorMode?: string;
+}
+/**
+ * CLI опции
+ */
+export interface CliOptions {
+    /**
+     * Тестовый прогон (не создавать коммиты/теги/релизы)
+     */
+    dryRun?: boolean;
+    /**
+     * Путь к конфиг файлу
+     */
+    config?: string;
+    /**
+     * Имя пакета для релиза (для monorepo)
+     */
+    package?: string;
+    /**
+     * Принудительная версия
+     */
+    version?: string;
+    /**
+     * Создать prerelease версию
+     */
+    prerelease?: string | boolean;
+    /**
+     * Не создавать коммит
+     */
+    noCommit?: boolean;
+    /**
+     * Не создавать тег
+     */
+    noTag?: boolean;
+    /**
+     * Не пушить в remote
+     */
+    noPush?: boolean;
+    /**
+     * Не создавать GitVerse Release
+     */
+    noRelease?: boolean;
+    /**
+     * Подробный вывод
+     */
+    verbose?: boolean;
+}
+/**
+ * Информация о Git репозитории
+ */
+export interface GitRepoInfo {
+    /**
+     * Owner/repo (например: "rainypixel/gitverse-sdk")
+     */
+    fullName: string;
+    /**
+     * Владелец репозитория
+     */
+    owner: string;
+    /**
+     * Название репозитория
+     */
+    repo: string;
+    /**
+     * URL репозитория
+     */
+    url: string;
+    /**
+     * Текущая ветка
+     */
+    branch: string;
+}
+/**
+ * Conventional Commit
+ */
+export interface ConventionalCommit {
+    /**
+     * Тип коммита (feat, fix, etc)
+     */
+    type: string;
+    /**
+     * Scope (опционально)
+     */
+    scope?: string;
+    /**
+     * Описание коммита
+     */
+    subject: string;
+    /**
+     * Тело коммита (опционально)
+     */
+    body?: string;
+    /**
+     * Footer (опционально)
+     */
+    footer?: string;
+    /**
+     * Breaking change
+     */
+    breaking: boolean;
+    /**
+     * Hash коммита
+     */
+    hash: string;
+    /**
+     * Короткий hash
+     */
+    shortHash: string;
+    /**
+     * Автор коммита
+     */
+    author: string;
+    /**
+     * Email автора
+     */
+    email: string;
+    /**
+     * Дата коммита
+     */
+    date: Date;
+    /**
+     * Исходное сообщение коммита
+     */
+    raw: string;
+}
+/**
+ * Тип изменения версии
+ */
+export type BumpType = "major" | "minor" | "patch" | "prerelease";
+/**
+ * Результат анализа версии
+ */
+export interface VersionBump {
+    /**
+     * Текущая версия
+     */
+    currentVersion: string;
+    /**
+     * Новая версия
+     */
+    newVersion: string;
+    /**
+     * Тип изменения
+     */
+    bumpType: BumpType;
+    /**
+     * Коммиты для релиза
+     */
+    commits: ConventionalCommit[];
+    /**
+     * Есть ли breaking changes
+     */
+    hasBreaking: boolean;
+    /**
+     * Есть ли новые features
+     */
+    hasFeatures: boolean;
+    /**
+     * Есть ли bug fixes
+     */
+    hasFixes: boolean;
+}
+/**
+ * Опции для генерации CHANGELOG
+ */
+export interface ChangelogGenerateOptions {
+    /**
+     * Версия релиза
+     */
+    version: string;
+    /**
+     * Коммиты для включения
+     */
+    commits: ConventionalCommit[];
+    /**
+     * Дата релиза
+     */
+    date?: Date;
+    /**
+     * URL репозитория для ссылок
+     */
+    repoUrl?: string;
+}
+/**
+ * Результат создания релиза
+ */
+export interface ReleaseResult {
+    /**
+     * Успешно ли выполнен релиз
+     */
+    success: boolean;
+    /**
+     * Название пакета
+     */
+    packageName: string;
+    /**
+     * Старая версия
+     */
+    oldVersion: string;
+    /**
+     * Новая версия
+     */
+    newVersion: string;
+    /**
+     * Созданный тег
+     */
+    tag?: string;
+    /**
+     * URL релиза на GitVerse
+     */
+    releaseUrl?: string;
+    /**
+     * Сообщения об ошибках
+     */
+    errors: string[];
+    /**
+     * Предупреждения
+     */
+    warnings: string[];
+}
+/**
+ * Конфигурация GitVerse Release
+ */
+export interface GitVerseConfig {
+    /**
+     * Включить создание релиза через GitVerse API
+     * Требует переменную окружения GVR_TOKEN
+     */
+    enabled: boolean;
+    /**
+     * Прерывать процесс релиза при ошибке создания release (после retry)
+     * Если false, ошибки логируются как warnings
+     */
+    failOnError: boolean;
+    /**
+     * Проверять существование релиза перед созданием (идемпотентность)
+     * Позволяет безопасно перезапускать pipeline
+     */
+    checkExisting: boolean;
+}
+/**
+ * Конфигурация retry механизма
+ */
+export interface RetryConfig {
+    /**
+     * Включить retry с экспоненциальным backoff
+     */
+    enabled: boolean;
+    /**
+     * Максимальное количество попыток
+     */
+    maxAttempts: number;
+    /**
+     * Начальная задержка между попытками (мс)
+     */
+    initialDelay: number;
+    /**
+     * Максимальная задержка между попытками (мс)
+     * Ограничивает рост экспоненциального backoff
+     */
+    maxDelay: number;
+    /**
+     * Список операций для retry
+     */
+    operations: RetryOperation[];
+}
+/**
+ * Типы операций для retry
+ */
+export type RetryOperation = "push" | "createRelease";
+/**
+ * Допустимые значения для регистра subject
+ */
+export type SubjectCaseValue = "lower-case" | "upper-case" | "camel-case" | "kebab-case" | "pascal-case" | "sentence-case" | "snake-case" | "start-case";
+/**
+ * Уровень правила commitlint
+ * 0 = disabled, 1 = warning, 2 = error
+ */
+export type CommitlintRuleLevel = 0 | 1 | 2;
+/**
+ * Конфигурация для генерации commitlint конфига
+ */
+export interface CommitlintGeneratorConfig {
+    /**
+     * Путь для вывода commitlint конфига
+     * @default "commitlint.config.ts"
+     */
+    output: string;
+    /**
+     * Формат выходного файла
+     * @default "ts"
+     */
+    format: "ts" | "js" | "json";
+    /**
+     * Дополнительные scopes помимо package names
+     * @default ["deps", "ci", "docs"]
+     */
+    scopes: string[];
+    /**
+     * Требовать обязательный scope
+     * @default false
+     */
+    scopeRequired: boolean;
+    /**
+     * Максимальная длина header
+     * @default 100
+     */
+    headerMaxLength: number;
+    /**
+     * Минимальная длина header
+     * @default null (disabled)
+     */
+    headerMinLength: number | null;
+    /**
+     * Регистр subject
+     * @default null (disabled - не ограничивать)
+     */
+    subjectCase: SubjectCaseValue | null;
+    /**
+     * Запретить точку в конце subject
+     * @default false
+     */
+    subjectFullStop: boolean;
+    /**
+     * Максимальная длина строки body
+     * @default null (disabled)
+     */
+    bodyMaxLineLength: number | null;
+    /**
+     * Максимальная длина строки footer
+     * @default null (disabled)
+     */
+    footerMaxLineLength: number | null;
+    /**
+     * Правила которые будут warning (level 1) вместо error (level 2)
+     * @default ["header-max-length"]
+     */
+    warningRules: string[];
+    /**
+     * Строгий режим - все правила error, subject-case: lower-case
+     * @default false
+     */
+    strictMode: boolean;
+    /**
+     * Добавлять комментарии в сгенерированный файл
+     * @default true
+     */
+    comments: boolean;
+}
+/**
+ * Опции для генерации commitlint конфига (CLI)
+ */
+export interface GenerateCommitlintOptions {
+    /**
+     * Путь к release конфигу
+     * @default ".gitversereleaserc.json"
+     */
+    configPath?: string;
+    /**
+     * Путь для вывода commitlint конфига
+     * @default "commitlint.config.ts"
+     */
+    output?: string;
+    /**
+     * Формат выходного файла
+     * @default "ts"
+     */
+    format?: "ts" | "js" | "json";
+    /**
+     * Дополнительные scopes помимо package names
+     * @default ["deps", "ci", "docs"]
+     */
+    scopes?: string[];
+    /**
+     * Требовать обязательный scope
+     * @default false
+     */
+    scopeRequired?: boolean;
+    /**
+     * Максимальная длина header
+     * @default 100
+     */
+    headerMaxLength?: number;
+    /**
+     * Минимальная длина header
+     * @default null (disabled)
+     */
+    headerMinLength?: number | null;
+    /**
+     * Регистр subject
+     * @default null (disabled - не ограничивать)
+     */
+    subjectCase?: SubjectCaseValue | null;
+    /**
+     * Запретить точку в конце subject
+     * @default false
+     */
+    subjectFullStop?: boolean;
+    /**
+     * Максимальная длина строки body
+     * @default null (disabled)
+     */
+    bodyMaxLineLength?: number | null;
+    /**
+     * Максимальная длина строки footer
+     * @default null (disabled)
+     */
+    footerMaxLineLength?: number | null;
+    /**
+     * Правила которые будут warning (level 1) вместо error (level 2)
+     * @default ["header-max-length"]
+     */
+    warningRules?: string[];
+    /**
+     * Строгий режим - все правила error, subject-case: lower-case
+     * @default false
+     */
+    strictMode?: boolean;
+    /**
+     * Добавлять комментарии в сгенерированный файл
+     * @default true
+     */
+    comments?: boolean;
+    /**
+     * Dry-run режим (preview без записи)
+     * @default false
+     */
+    dryRun?: boolean;
+    /**
+     * Подробный вывод
+     * @default false
+     */
+    verbose?: boolean;
+}
+/**
+ * Поддерживаемые платформы для бинарной дистрибуции
+ */
+export type BinaryPlatform = "linux-x64" | "linux-arm64" | "darwin-x64" | "darwin-arm64" | "win32-x64" | "win32-arm64";
+/**
+ * Формат входных данных для бинарников
+ */
+export type BinaryInputFormat = "directory" | "tar.gz";
+/**
+ * Допустимые значения для поля 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
+     */
+    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)
+     */
+    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;
+    /**
+     * Формат входных данных для бинарников
+     * - "directory": бинарники в директориях (dist/name-platform/name)
+     * - "tar.gz": бинарники в tar.gz архивах (dist/name-platform.tar.gz)
+     * @default "directory"
+     */
+    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")
+     *
+     * @example
+     * {
+     *   "linux-x64": "linux-x64",
+     *   "darwin-arm64": "darwin-arm64",
+     *   "windows-x64": "win32-x64"
+     * }
+     */
+    platformMap?: Record<string, BinaryPlatform>;
+}
+/**
+ * Успешный результат генерации платформенного пакета
+ */
+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[];
+}
+/**
+ * Успешный результат извлечения бинарника из архива
+ */
+export interface BinaryExtractionSuccess {
+    success: true;
+    binaryPath: string;
+    tempDir: string;
+}
+/**
+ * Неуспешный результат извлечения бинарника из архива
+ */
+export interface BinaryExtractionFailure {
+    success: false;
+    error: string;
+}
+/**
+ * Результат извлечения бинарника из архива (discriminated union)
+ */
+export type BinaryExtractionResult = BinaryExtractionSuccess | BinaryExtractionFailure;
+/**
+ * CLI опции для бинарной дистрибуции
+ */
+export interface BinaryCliOptions {
+    /**
+     * Тестовый прогон (не публиковать)
+     */
+    dryRun?: boolean;
+    /**
+     * Путь к конфиг файлу
+     */
+    config?: string;
+    /**
+     * Override версии
+     */
+    version?: string;
+    /**
+     * Только генерация пакетов (без публикации)
+     */
+    generateOnly?: boolean;
+    /**
+     * Не обновлять основной package.json
+     */
+    skipMainPackage?: boolean;
+    /**
+     * Конкретные платформы для обработки
+     */
+    platforms?: BinaryPlatform[];
+    /**
+     * Подробный вывод
+     */
+    verbose?: boolean;
+}