onreza-release 1.0.0

package/dist/utils/binary-archive-extractor.d.ts

@@ -0,0 +1,19 @@
+import type { BinariesConfig, BinaryExtractionResult, BinaryPlatform } from "../types";
+/**
+ * Возвращает имя бинарника внутри архива с учётом sourceBinName.
+ * Если sourceBinName не задан, возвращает config.name.
+ */
+export declare function getSourceBinaryName(config: BinariesConfig, platform: BinaryPlatform): string;
+/**
+ * Извлекает бинарник из tar.gz архива во временную директорию.
+ *
+ * @param config - Конфигурация бинарной дистрибуции
+ * @param platform - Целевая платформа
+ * @param tempBaseDir - Базовая директория для временных файлов
+ * @returns Результат извлечения с путём к бинарнику и временной директории
+ */
+export declare function extractBinaryFromArchive(config: BinariesConfig, platform: BinaryPlatform, tempBaseDir: string): Promise<BinaryExtractionResult>;
+/**
+ * Удаляет временную директорию.
+ */
+export declare function cleanupTempDir(tempDir: string): Promise<void>;

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

@@ -0,0 +1,24 @@
+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;
+/**
+ * Генерирует платформенный пакет.
+ * Поддерживает два формата входных данных:
+ * - "directory": бинарники в директориях (dist/name-platform/name)
+ * - "tar.gz": бинарники в tar.gz архивах (dist/name-platform.tar.gz)
+ */
+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,113 @@
+import type { BinariesConfig, 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 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
+ */
+export declare function platformToNodeValues(platform: BinaryPlatform): {
+    platform: string;
+    arch: string;
+};
+/**
+ * Возвращает ключ источника для платформы с учётом platformMap.
+ * Если platformMap не задан или платформа не найдена, возвращает платформу как есть.
+ */
+export declare function getSourceKey(config: BinariesConfig, platform: BinaryPlatform): string;
+/**
+ * Дефолтный шаблон имени архива
+ */
+export declare const DEFAULT_ARCHIVE_NAME_TEMPLATE = "{{name}}-{{platform}}.tar.gz";
+/**
+ * Возвращает имя архива для платформы с учётом шаблона.
+ */
+export declare function getArchiveName(config: BinariesConfig, platform: BinaryPlatform): string;
+/**
+ * Возвращает путь к tar.gz архиву для указанной платформы.
+ */
+export declare function getArchivePath(config: BinariesConfig, platform: BinaryPlatform): string;
+/**
+ * Проверяет существование tar.gz архива для платформы.
+ *
+ * @returns true если архив существует, false если не найден (ENOENT)
+ * @throws Error при других ошибках доступа
+ */
+export declare function validateArchiveExists(config: BinariesConfig, platform: BinaryPlatform): Promise<boolean>;
+/**
+ * Универсальная проверка существования источника бинарника.
+ * Поддерживает как директории, так и tar.gz архивы.
+ *
+ * @returns true если источник существует, false если не найден
+ * @throws Error при других ошибках доступа
+ */
+export declare function validateBinarySourceExists(config: BinariesConfig, platform: BinaryPlatform): Promise<boolean>;
+/**
+ * Универсальная валидация наличия источников бинарников для всех платформ.
+ * Поддерживает как директории, так и tar.gz архивы.
+ *
+ * @returns Массив отсутствующих платформ
+ */
+export declare function validateAllBinarySources(config: BinariesConfig): Promise<BinaryPlatform[]>;
+/**
+ * Возвращает путь к источнику бинарника с учётом формата входных данных.
+ * Для directory возвращает путь к директории платформы.
+ * Для tar.gz возвращает путь к архиву.
+ */
+export declare function getBinarySourcePath(config: BinariesConfig, platform: BinaryPlatform): 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/changelog.d.ts

@@ -0,0 +1,14 @@
+import type { ChangelogConfig, ChangelogGenerateOptions, ConventionalCommit } from "../types";
+/**
+ * Генерирует CHANGELOG для версии
+ */
+export declare function generateChangelog(options: ChangelogGenerateOptions, config: ChangelogConfig, packageName?: string): string;
+/**
+ * Обновляет CHANGELOG файл, добавляя новую версию в начало
+ */
+export declare function updateChangelogFile(changelogPath: string, newEntry: string): Promise<void>;
+/**
+ * Генерирует CHANGELOG текст для GitVerse Release
+ * (компактный формат без markdown заголовков, но с полной информацией)
+ */
+export declare function generateReleaseNotes(commits: ConventionalCommit[], config: ChangelogConfig, repoUrl?: string, packageName?: string): string;

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

@@ -0,0 +1,5 @@
+import type { GenerateCommitlintOptions, ReleaseConfig } from "../types";
+/**
+ * Генерирует commitlint конфиг из release конфига
+ */
+export declare function generateCommitlint(config: Required<ReleaseConfig>, options?: GenerateCommitlintOptions): Promise<void>;

package/dist/utils/git.d.ts

@@ -0,0 +1,101 @@
+import type { GitRepoInfo } from "../types";
+/**
+ * Выполняет команду shell
+ */
+export declare function executeCommand(command: string): Promise<string>;
+/**
+ * Выполняет beforeCommit hook
+ * Возвращает true если хук выполнился успешно
+ * Возвращает false если хук упал с ошибкой
+ */
+export declare function runBeforeCommitHook(command: string): Promise<boolean>;
+/**
+ * Выполняет git команду
+ * Экспортируется для тестирования (позволяет мокать через spyOn)
+ */
+export declare function gitCommand(command: string): Promise<string>;
+/**
+ * Получает информацию о Git репозитории
+ *
+ * Приоритет источников данных:
+ * 1. Переменные окружения GitVerse Actions (для CI/CD)
+ * 2. Git remote URL (для локального использования)
+ */
+export declare function getRepoInfo(): Promise<GitRepoInfo>;
+/**
+ * Получает последний тег с указанным префиксом
+ */
+export declare function getLatestTag(prefix: string): Promise<string | null>;
+/**
+ * Получает список коммитов с момента последнего тега
+ */
+export declare function getCommitsSinceTag(tagPrefix: string, path?: string): Promise<string[]>;
+/**
+ * Получает текущую версию из package.json
+ */
+export declare function getCurrentVersion(packagePath: string): Promise<string>;
+/**
+ * Получает информацию из package.json (name и version)
+ */
+export declare function getPackageInfo(packagePath: string): Promise<{
+    name: string;
+    version: string;
+}>;
+/**
+ * Обновляет версию в package.json
+ */
+export declare function updatePackageVersion(packagePath: string, newVersion: string): Promise<void>;
+/**
+ * Создает git коммит
+ */
+export declare function createCommit(message: string, files: string[]): Promise<void>;
+/**
+ * Создает git тег
+ */
+export declare function createTag(tag: string, message: string): Promise<void>;
+/**
+ * Опции для push операции
+ */
+export interface PushOptions {
+    /** Тег для пуша (опционально) */
+    tag?: string;
+    /** Использовать токен для push через HTTPS */
+    useToken?: boolean;
+    /** Токен для авторизации */
+    token?: string;
+    /** Информация о репозитории */
+    repoInfo?: GitRepoInfo;
+}
+/**
+ * Выполняет git команду с очисткой токенов из ошибок
+ * Используется для команд с токенами в URL
+ * Экспортируется для тестирования
+ */
+export declare function gitCommandSilent(command: string): Promise<void>;
+/**
+ * Пушит изменения и теги в remote
+ */
+export declare function pushChanges(options?: PushOptions): Promise<void>;
+/**
+ * Проверяет, что рабочая директория чистая
+ *
+ * Формат git status --porcelain: "XY PATH"
+ * X = status in staging area (index)
+ * Y = status in working tree
+ *
+ * Staged изменения (X != ' ') допустимы - они войдут в коммит релиза
+ * Unstaged изменения (Y != ' ') запрещены - нужно закоммитить или stash
+ */
+export declare function isWorkingTreeClean(): Promise<boolean>;
+/**
+ * Добавляет все измененные файлы в staging area
+ * Используется после успешного выполнения beforeCommit хука
+ */
+export declare function addChangedFiles(): Promise<void>;
+/**
+ * Проверяет, что тег существует.
+ *
+ * @returns true если тег существует, false если тег не найден
+ * @throws Error при критических ошибках git (повреждённый репозиторий, git не найден)
+ */
+export declare function tagExists(tag: string): Promise<boolean>;

package/dist/utils/parser.d.ts

@@ -0,0 +1,36 @@
+import type { ConventionalCommit } from "../types";
+/**
+ * Парсит сырой коммит из git log в структуру ConventionalCommit
+ */
+export declare function parseCommit(rawCommit: string): ConventionalCommit | null;
+/**
+ * Парсит массив сырых коммитов
+ */
+export declare function parseCommits(rawCommits: string[]): ConventionalCommit[];
+/**
+ * Группирует коммиты по типам
+ */
+export declare function groupCommitsByType(commits: ConventionalCommit[]): Record<string, ConventionalCommit[]>;
+/**
+ * Фильтрует коммиты по scope
+ */
+export declare function filterCommitsByScope(commits: ConventionalCommit[], scope: string): ConventionalCommit[];
+/**
+ * Фильтрует коммиты для пакета с учётом режима monorepo
+ *
+ * В monorepo режиме: включает коммиты со scope пакета + коммиты без scope (общие)
+ * В single-package режиме: включает все коммиты (scope используется для категоризации, не для выбора пакета)
+ */
+export declare function filterCommitsForPackage(commits: ConventionalCommit[], packageName: string, isMonorepo: boolean): ConventionalCommit[];
+/**
+ * Проверяет, есть ли breaking changes
+ */
+export declare function hasBreakingChanges(commits: ConventionalCommit[]): boolean;
+/**
+ * Проверяет, есть ли новые features
+ */
+export declare function hasFeatures(commits: ConventionalCommit[]): boolean;
+/**
+ * Проверяет, есть ли bug fixes
+ */
+export declare function hasFixes(commits: ConventionalCommit[]): boolean;

package/dist/utils/retry.d.ts

@@ -0,0 +1,39 @@
+import type { RetryConfig } from "../types";
+/**
+ * Опции для retry функции
+ */
+export interface RetryOptions {
+    /**
+     * Максимальное количество попыток
+     */
+    maxAttempts: number;
+    /**
+     * Начальная задержка (мс)
+     */
+    initialDelay: number;
+    /**
+     * Максимальная задержка (мс)
+     */
+    maxDelay: number;
+    /**
+     * Название операции для логирования
+     */
+    operationName?: string;
+}
+/**
+ * Проверяет, является ли ошибка временной (можно retry)
+ */
+export declare function isRetriableError(error: unknown): boolean;
+/**
+ * Выполняет функцию с retry механизмом и экспоненциальным backoff
+ *
+ * @param fn - Асинхронная функция для выполнения
+ * @param options - Опции retry
+ * @returns Результат выполнения функции
+ * @throws Последняя ошибка после всех попыток
+ */
+export declare function retry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
+/**
+ * Создаёт функцию retry с предустановленными настройками из конфига
+ */
+export declare function createRetryFunction(config: RetryConfig): <T>(fn: () => Promise<T>, operationName?: string) => Promise<T>;

package/dist/utils/version.d.ts

@@ -0,0 +1,18 @@
+import type { BumpType, ConventionalCommit, VersionBump } from "../types";
+/**
+ * Определяет тип изменения версии на основе коммитов
+ */
+export declare function determineBumpType(commits: ConventionalCommit[], currentVersion?: string, preMajorMode?: string): BumpType | null;
+/**
+ * Увеличивает версию согласно типу изменения
+ */
+export declare function bumpVersion(currentVersion: string, bumpType: BumpType, prereleasePrefix?: string): string;
+/**
+ * Вычисляет bump версии на основе коммитов
+ */
+export declare function calculateVersionBump(currentVersion: string, commits: ConventionalCommit[], forceVersion?: string, prerelease?: string, preMajorMode?: string): VersionBump;
+/**
+ * Сравнивает две версии
+ * Возвращает: -1 если a < b, 0 если a === b, 1 если a > b
+ */
+export declare function compareVersions(a: string, b: string): number;

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "onreza-release",
+  "version": "1.0.0",
+  "description": "Conventional Commits release automation tool with GitVerse and GitHub support",
+  "keywords": [
+    "release",
+    "conventional-commits",
+    "changelog",
+    "versioning",
+    "semantic-release",
+    "monorepo",
+    "gitverse",
+    "github",
+    "bun",
+    "onreza"
+  ],
+  "homepage": "https://gitverse.ru/onreza/release-tool#readme",
+  "bugs": {
+    "url": "https://gitverse.ru/onreza/release-tool/tasktracker"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitverse.ru/onreza/release-tool.git"
+  },
+  "license": "MIT",
+  "author": "ONREZA <support@onreza.ru>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./cli": {
+      "import": "./dist/cli.js",
+      "types": "./dist/cli.d.ts"
+    }
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "onreza-release": "./dist/cli.js"
+  },
+  "files": ["dist", "schema.json", "README.md"],
+  "scripts": {
+    "build": "bun build.ts",
+    "dev": "bun build.ts --watch",
+    "lint": "biome check",
+    "lint:fix": "biome check --write",
+    "test": "bun test",
+    "test:coverage": "bun test --coverage",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@onreza/gitverse-sdk": ">=0.0.0",
+    "jsonc-parser": "^3.3.1",
+    "tar": "^7.5.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.11",
+    "@types/bun": "1.3.6",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}