gitverse-release 3.6.0 → 3.7.0

package/dist/types.d.ts

@@ -584,6 +584,10 @@ export interface GenerateCommitlintOptions {
  * Поддерживаемые платформы для бинарной дистрибуции
  */
 export type BinaryPlatform = "linux-x64" | "linux-arm64" | "darwin-x64" | "darwin-arm64" | "win32-x64" | "win32-arm64";
+/**
+ * Формат входных данных для бинарников
+ */
+export type BinaryInputFormat = "directory" | "tar.gz";
 /**
  * Допустимые значения для поля os в package.json
  */
@@ -622,8 +626,22 @@ 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"
      */
-    scope: string;
+    packageNameTemplate?: string;
     /**
      * Базовое имя пакетов (например: yougile)
      */
@@ -669,6 +687,31 @@ export interface BinariesConfig {
      * @default 3
      */
     retryAttempts: number;
+    /**
+     * Формат входных данных для бинарников
+     * - "directory": бинарники в директориях (dist/name-platform/name)
+     * - "tar.gz": бинарники в tar.gz архивах (dist/name-platform.tar.gz)
+     * @default "directory"
+     */
+    inputFormat?: BinaryInputFormat;
+    /**
+     * Имя бинарника внутри архива (если отличается от 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>;
 }
 /**
  * Успешный результат генерации платформенного пакета
@@ -751,6 +794,25 @@ export interface BinaryDistributionResult {
     /** Предупреждения */
     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 опции для бинарной дистрибуции
  */

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

@@ -8,7 +8,10 @@ export declare function generatePlatformPackageJson(config: BinariesConfig, plat
  */
 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>;
 /**

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

@@ -1,4 +1,4 @@
-import type { BinaryPlatform, PlatformMapping } from "../types";
+import type { BinariesConfig, BinaryPlatform, PlatformMapping } from "../types";
 /**
  * Маппинг платформ на os/cpu значения для package.json
  */
@@ -36,13 +36,19 @@ export declare function validateBinaryExists(distDir: string, name: string, plat
  */
 export declare function validateAllBinaries(distDir: string, name: string, platforms: BinaryPlatform[]): Promise<BinaryPlatform[]>;
 /**
- * Генерирует полное имя пакета для платформы
+ * Возвращает дефолтный шаблон имени пакета
  */
-export declare function getPackageName(scope: string, name: string, platform: BinaryPlatform): string;
+export declare function getDefaultPackageNameTemplate(scope?: string): string;
 /**
- * Генерирует путь к пакету в output директории
+ * Генерирует полное имя пакета для платформы.
+ * Поддерживает кастомный шаблон через packageNameTemplate.
  */
-export declare function getPackageOutputPath(outDir: string, scope: string, name: string, platform: BinaryPlatform): string;
+export declare function getPackageName(config: BinariesConfig, platform: BinaryPlatform): string;
+/**
+ * Генерирует путь к пакету в output директории.
+ * Создаёт структуру директорий на основе имени пакета.
+ */
+export declare function getPackageOutputPath(config: BinariesConfig, platform: BinaryPlatform): string;
 /**
  * Раскрывает плейсхолдеры в строке
  */
@@ -60,3 +66,40 @@ export declare function platformToNodeValues(platform: BinaryPlatform): {
     platform: string;
     arch: string;
 };
+/**
+ * Возвращает ключ источника для платформы с учётом platformMap.
+ * Если platformMap не задан или платформа не найдена, возвращает платформу как есть.
+ */
+export declare function getSourceKey(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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitverse-release",
-  "version": "3.6.0",
+  "version": "3.7.0",
   "description": "Conventional Commits release automation tool for GitVerse",
   "keywords": [
     "gitverse",
@@ -48,7 +48,8 @@
   },
   "dependencies": {
     "gitverse-api-sdk": "5.2.0",
-    "jsonc-parser": "^3.3.1"
+    "jsonc-parser": "^3.3.1",
+    "tar": "^7.5.3"
   },
   "devDependencies": {
     "@types/bun": "1.3.6",

package/schema.json

@@ -12,13 +12,13 @@
         "continueOnError": false,
         "distDir": "./dist",
         "enabled": false,
+        "inputFormat": "directory",
         "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": ""
+        "retryAttempts": 3
       },
       "description": "Binary distribution settings for publishing platform-specific npm packages",
       "properties": {
@@ -41,6 +41,12 @@
           "description": "Enable binary distribution",
           "type": "boolean"
         },
+        "inputFormat": {
+          "default": "directory",
+          "description": "Input format for binaries. 'directory' expects binaries in dist/name-platform/name, 'tar.gz' expects archives in dist/name-platform.tar.gz",
+          "enum": ["directory", "tar.gz"],
+          "type": "string"
+        },
         "mainPackage": {
           "default": "./package.json",
           "description": "Path to main package.json for updating optionalDependencies",
@@ -55,6 +61,19 @@
           "description": "Output directory for generated npm packages",
           "type": "string"
         },
+        "packageNameTemplate": {
+          "description": "Template for package names. Placeholders: {{scope}}, {{name}}, {{platform}}. Default: '{{name}}-{{platform}}' (without scope) or '@{{scope}}/{{name}}-{{platform}}' (with scope)",
+          "examples": ["{{name}}-{{platform}}", "@{{scope}}/{{name}}-{{platform}}", "{{name}}-bin-{{platform}}"],
+          "type": "string"
+        },
+        "platformMap": {
+          "additionalProperties": {
+            "enum": ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64", "win32-x64", "win32-arm64"],
+            "type": "string"
+          },
+          "description": "Mapping of source file keys to npm platforms. Keys are identifiers in archive names (e.g., 'linux-x64'), values are npm platforms",
+          "type": "object"
+        },
         "platforms": {
           "default": ["linux-x64", "linux-arm64", "darwin-x64", "darwin-arm64", "win32-x64"],
           "description": "Platforms to publish",
@@ -78,7 +97,11 @@
           "type": "integer"
         },
         "scope": {
-          "description": "npm scope for platform packages (e.g., '@rainypixel')",
+          "description": "npm scope for platform packages (e.g., '@rainypixel'). Optional - if not set, packages are published without scope",
+          "type": "string"
+        },
+        "sourceBinName": {
+          "description": "Binary name inside archive (if different from 'name'). Used only with inputFormat: 'tar.gz'",
           "type": "string"
         }
       },