onreza-release 1.0.1 → 2.1.0

package/dist/providers/detector.d.ts

@@ -0,0 +1,71 @@
+import type { GitPlatform, ProviderRepoInfo } from "./types";
+/**
+ * Определяет Git платформу по URL репозитория
+ *
+ * @param remoteUrl - URL репозитория (HTTPS, SSH, SCP-like)
+ * @returns Платформа или null если не удалось определить
+ *
+ * @example
+ * detectPlatform("https://github.com/owner/repo.git") // "github"
+ * detectPlatform("git@gitverse.ru:owner/repo.git") // "gitverse"
+ * detectPlatform("https://gitlab.company.com/owner/repo") // "gitlab"
+ */
+export declare function detectPlatform(remoteUrl: string): GitPlatform | null;
+/**
+ * Парсит URL репозитория и извлекает owner, repo, host
+ *
+ * @param url - URL репозитория
+ * @returns Информация о репозитории или null если не удалось распарсить
+ *
+ * @example
+ * parseRepoUrl("https://github.com/owner/repo.git")
+ * // { owner: "owner", repo: "repo", host: "github.com" }
+ *
+ * parseRepoUrl("git@gitverse.ru:owner/repo.git")
+ * // { owner: "owner", repo: "repo", host: "gitverse.ru" }
+ */
+export declare function parseRepoUrl(url: string): ProviderRepoInfo | null;
+/**
+ * Проверяет, запущен ли скрипт в CI окружении определённой платформы
+ */
+export interface CiEnvironment {
+    /** Платформа CI */
+    platform: GitPlatform;
+    /** Owner/repo из переменных окружения */
+    repository?: string;
+    /** Текущая ветка */
+    branch?: string;
+}
+/**
+ * Определяет CI окружение по переменным окружения
+ *
+ * @returns Информация о CI окружении или null
+ */
+export declare function detectCiEnvironment(): CiEnvironment | null;
+/**
+ * Определяет платформу автоматически
+ *
+ * Приоритет:
+ * 1. CI переменные окружения
+ * 2. Git remote URL
+ *
+ * @param remoteUrl - URL репозитория (опционально)
+ * @returns Платформа или null
+ */
+export declare function detectPlatformAuto(remoteUrl?: string): GitPlatform | null;
+/**
+ * Возвращает базовый URL для платформы
+ *
+ * @param platform - Платформа
+ * @param host - Хост (опционально, для self-hosted)
+ * @returns Базовый URL
+ */
+export declare function getPlatformBaseUrl(platform: GitPlatform, host?: string): string;
+/**
+ * Возвращает API URL для платформы
+ *
+ * @param platform - Платформа
+ * @param host - Хост (опционально, для self-hosted)
+ * @returns API URL
+ */
+export declare function getPlatformApiUrl(platform: GitPlatform, host?: string): string;

package/dist/providers/github.d.ts

@@ -0,0 +1,53 @@
+import type { AssetLimits, CreateReleaseOptions, CreateReleaseResult, GitPlatform, ProviderRepoInfo, ReleaseProvider, RetryFunction, TokenValidationResult, UploadAssetResult } from "./types";
+/**
+ * GitHub Release Provider
+ *
+ * Реализует ReleaseProvider для GitHub платформы.
+ * Использует GitHub REST API напрямую через fetch.
+ */
+export declare class GitHubReleaseProvider implements ReleaseProvider {
+    private repoInfo;
+    private retryFn?;
+    private token;
+    private apiBaseUrl;
+    readonly platform: GitPlatform;
+    readonly assetLimits: AssetLimits;
+    constructor(token: string, repoInfo: ProviderRepoInfo, retryFn?: RetryFunction);
+    /**
+     * Выполняет API запрос к GitHub
+     */
+    private apiRequest;
+    /**
+     * Проверяет валидность токена через API
+     */
+    validateToken(): Promise<TokenValidationResult>;
+    /**
+     * Создает релиз на GitHub
+     */
+    createRelease(tag: string, name: string, body: string, options?: CreateReleaseOptions): Promise<CreateReleaseResult>;
+    /**
+     * Проверяет существование релиза по тегу
+     *
+     * @throws Error если произошла ошибка отличная от 404 (сетевая, авторизация и т.д.)
+     */
+    releaseExists(tag: string): Promise<boolean>;
+    /**
+     * Получает информацию о релизе по тегу
+     *
+     * @returns null если релиз не найден (404)
+     * @throws Error если произошла ошибка отличная от 404
+     */
+    getRelease(tag: string): Promise<CreateReleaseResult | null>;
+    /**
+     * Загружает файл как asset к релизу
+     */
+    uploadAsset(releaseId: number | string, filePath: string, assetName: string): Promise<UploadAssetResult>;
+    /**
+     * Определяет Content-Type по имени файла
+     */
+    private getContentType;
+    /**
+     * Возвращает информацию о репозитории
+     */
+    get repositoryInfo(): ProviderRepoInfo;
+}

package/dist/providers/gitverse.d.ts

@@ -0,0 +1,48 @@
+import type { AssetLimits, CreateReleaseOptions, CreateReleaseResult, GitPlatform, ProviderRepoInfo, ReleaseProvider, RetryFunction, TokenValidationResult, UploadAssetResult } from "./types";
+/**
+ * GitVerse Release Provider
+ *
+ * Реализует ReleaseProvider для GitVerse платформы.
+ */
+export declare class GitVerseReleaseProvider implements ReleaseProvider {
+    private client;
+    private repoInfo;
+    private retryFn?;
+    private token;
+    readonly platform: GitPlatform;
+    readonly assetLimits: AssetLimits;
+    constructor(token: string, repoInfo: ProviderRepoInfo, retryFn?: RetryFunction);
+    /**
+     * Проверяет валидность токена через API
+     */
+    validateToken(): Promise<TokenValidationResult>;
+    /**
+     * Создает релиз на GitVerse
+     */
+    createRelease(tag: string, name: string, body: string, options?: CreateReleaseOptions): Promise<CreateReleaseResult>;
+    /**
+     * Проверяет существование релиза по тегу
+     *
+     * @throws Error если произошла ошибка отличная от 404 (сетевая, авторизация и т.д.)
+     */
+    releaseExists(tag: string): Promise<boolean>;
+    /**
+     * Получает информацию о релизе по тегу
+     *
+     * @returns null если релиз не найден (404)
+     * @throws Error если произошла ошибка отличная от 404
+     */
+    getRelease(tag: string): Promise<CreateReleaseResult | null>;
+    /**
+     * Загружает файл как asset к релизу
+     */
+    uploadAsset(releaseId: number | string, filePath: string, assetName: string): Promise<UploadAssetResult>;
+    /**
+     * Формирует URL релиза
+     */
+    private getReleaseUrl;
+    /**
+     * Возвращает информацию о репозитории
+     */
+    get repositoryInfo(): ProviderRepoInfo;
+}

package/dist/providers/index.d.ts

@@ -0,0 +1,67 @@
+import type { GitPlatform, ProviderRepoInfo, ReleaseProvider, RetryFunction } from "./types";
+/**
+ * Опции для создания провайдера релизов
+ */
+export interface CreateReleaseProviderOptions {
+    /** Информация о репозитории */
+    repoInfo: ProviderRepoInfo;
+    /** Платформа (если не указана, будет определена автоматически) */
+    platform?: GitPlatform | "auto";
+    /** Токен авторизации (если не указан, будет получен из env) */
+    token?: string;
+    /** Retry функция (опционально) */
+    retryFn?: RetryFunction;
+}
+/**
+ * Результат создания провайдера
+ */
+export interface CreateReleaseProviderResult {
+    /** Провайдер релизов */
+    provider: ReleaseProvider;
+    /** Источник токена */
+    tokenSource: string;
+    /** Определённая платформа */
+    platform: GitPlatform;
+}
+/**
+ * Создаёт провайдер релизов для указанной платформы
+ *
+ * Автоматически определяет платформу по URL репозитория или CI окружению,
+ * получает токен из переменных окружения и создаёт соответствующий провайдер.
+ *
+ * @example
+ * ```ts
+ * const { provider } = createReleaseProvider({
+ *   repoInfo: { owner: "user", repo: "project", host: "github.com" },
+ * });
+ *
+ * const release = await provider.createRelease("v1.0.0", "Release 1.0.0", "Changelog");
+ * ```
+ */
+export declare function createReleaseProvider(options: CreateReleaseProviderOptions): CreateReleaseProviderResult;
+/**
+ * Проверяет доступность токена для платформы
+ *
+ * @param platform - Git платформа
+ * @returns true если токен найден
+ */
+export declare function hasToken(platform: GitPlatform): boolean;
+/**
+ * Валидирует токен для платформы
+ *
+ * @param platform - Git платформа
+ * @param repoInfo - Информация о репозитории
+ * @returns Результат валидации
+ */
+export declare function validateToken(platform: GitPlatform, repoInfo: ProviderRepoInfo): Promise<{
+    valid: boolean;
+    username?: string;
+    error?: string;
+}>;
+export { detectCiEnvironment, detectPlatform, detectPlatformAuto } from "./detector";
+export { GitHubReleaseProvider } from "./github";
+export { GitVerseReleaseProvider } from "./gitverse";
+export { formatFileSize, getAssetLimits, PLATFORM_ASSET_LIMITS, validateAsset, validateAssetBatch } from "./limits";
+export { getSupportedEnvVars, getToken, getTokenNotFoundError, isCI } from "./tokens";
+export type { AssetLimits, CreateReleaseOptions, CreateReleaseResult, GitPlatform, ProviderRepoInfo, ReleaseProvider, RetryFunction, TokenValidationResult, UploadAssetResult, } from "./types";
+export { createProviderRepoInfo } from "./types";

package/dist/providers/limits.d.ts

@@ -0,0 +1,75 @@
+import type { AssetLimits, GitPlatform } from "./types";
+/**
+ * Лимиты assets по платформам
+ *
+ * Источники:
+ * - GitVerse: Эмпирически определённые лимиты
+ * - GitHub: https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases
+ * - GitLab: https://docs.gitlab.com/ee/user/project/releases/
+ */
+export declare const PLATFORM_ASSET_LIMITS: Record<GitPlatform, AssetLimits>;
+/**
+ * Получает лимиты для указанной платформы
+ *
+ * @param platform - Git платформа
+ */
+export declare function getAssetLimits(platform: GitPlatform): AssetLimits;
+/**
+ * Форматирует размер файла в человекочитаемый формат
+ *
+ * @param bytes - Размер в байтах
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Получает расширение файла с поддержкой составных расширений
+ *
+ * @param filePath - Путь к файлу
+ */
+export declare function getFileExtension(filePath: string): string;
+/**
+ * Проверяет допустимость расширения для платформы
+ *
+ * @param platform - Git платформа
+ * @param extension - Расширение файла (с точкой)
+ */
+export declare function isExtensionAllowed(platform: GitPlatform, extension: string): boolean;
+/**
+ * Проверяет размер файла для платформы
+ *
+ * @param platform - Git платформа
+ * @param sizeBytes - Размер в байтах
+ */
+export declare function isFileSizeAllowed(platform: GitPlatform, sizeBytes: number): boolean;
+/**
+ * Результат валидации asset
+ */
+export interface AssetValidationResult {
+    /** Валиден ли файл */
+    valid: boolean;
+    /** Сообщение об ошибке */
+    error?: string;
+    /** Размер файла */
+    sizeBytes?: number;
+}
+/**
+ * Валидирует файл для загрузки на указанную платформу
+ *
+ * @param platform - Git платформа
+ * @param filePath - Путь к файлу
+ * @param sizeBytes - Размер файла в байтах
+ */
+export declare function validateAsset(platform: GitPlatform, filePath: string, sizeBytes: number): AssetValidationResult;
+/**
+ * Валидирует пакет файлов для загрузки
+ *
+ * @param platform - Git платформа
+ * @param files - Массив { path, sizeBytes }
+ */
+export declare function validateAssetBatch(platform: GitPlatform, files: Array<{
+    path: string;
+    sizeBytes: number;
+}>): {
+    valid: boolean;
+    errors: string[];
+    totalSize: number;
+};

package/dist/providers/tokens.d.ts

@@ -0,0 +1,42 @@
+import type { GitPlatform } from "./types";
+/**
+ * Результат получения токена
+ */
+export interface TokenResult {
+    /** Токен */
+    token: string;
+    /** Имя переменной окружения, из которой получен токен */
+    source: string;
+}
+/**
+ * Получает токен для указанной платформы
+ *
+ * @param platform - Git платформа
+ * @returns Результат с токеном или null если токен не найден
+ *
+ * @example
+ * const result = getToken("github");
+ * if (result) {
+ *   console.log(`Token from ${result.source}`);
+ * }
+ */
+export declare function getToken(platform: GitPlatform): TokenResult | null;
+/**
+ * Проверяет, запущен ли скрипт в CI окружении платформы
+ *
+ * @param platform - Git платформа
+ */
+export declare function isCI(platform: GitPlatform): boolean;
+/**
+ * Генерирует сообщение об ошибке отсутствия токена
+ *
+ * @param platform - Git платформа
+ * @returns Сообщение с инструкциями
+ */
+export declare function getTokenNotFoundError(platform: GitPlatform): string;
+/**
+ * Возвращает список всех поддерживаемых переменных окружения для платформы
+ *
+ * @param platform - Git платформа
+ */
+export declare function getSupportedEnvVars(platform: GitPlatform): string[];

package/dist/providers/types.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Поддерживаемые Git платформы
+ */
+export type GitPlatform = "gitverse" | "github" | "gitlab";
+/**
+ * Лимиты для assets релиза (immutable)
+ */
+export interface AssetLimits {
+    /** Максимальный размер одного файла в байтах */
+    readonly maxFileSizeBytes: number;
+    /** Максимальный суммарный размер за один upload (null = без лимита) */
+    readonly maxTotalSizeBytes: number | null;
+    /** Допустимые расширения файлов (null = любые) */
+    readonly allowedExtensions: readonly string[] | null;
+    /** Максимальное количество файлов за раз */
+    readonly maxFilesPerUpload: number;
+}
+/**
+ * Результат валидации токена (discriminated union)
+ *
+ * Гарантирует, что valid=true всегда имеет username,
+ * а valid=false всегда имеет error.
+ */
+export type TokenValidationResult = {
+    readonly valid: true;
+    readonly username: string;
+} | {
+    readonly valid: false;
+    readonly error: string;
+};
+/**
+ * Опции для создания релиза
+ */
+export interface CreateReleaseOptions {
+    /** Черновик (не публиковать сразу) */
+    draft?: boolean;
+    /** Prerelease версия */
+    prerelease?: boolean;
+    /** Целевая ветка/коммит для тега (если тег ещё не создан) */
+    targetCommitish?: string;
+}
+/**
+ * Результат создания релиза
+ */
+export interface CreateReleaseResult {
+    /** ID релиза (number для GitHub/GitVerse, string для GitLab) */
+    id: number | string;
+    /** URL релиза */
+    url: string;
+    /** URL для загрузки assets (для GitHub) */
+    uploadUrl?: string;
+    /** Тег релиза */
+    tag: string;
+}
+/**
+ * Результат загрузки asset
+ */
+export interface UploadAssetResult {
+    /** ID asset */
+    id: number | string;
+    /** Имя asset */
+    name: string;
+    /** URL для скачивания */
+    downloadUrl: string;
+    /** Размер в байтах */
+    size: number;
+}
+/**
+ * Информация о репозитории для провайдера (immutable)
+ */
+export interface ProviderRepoInfo {
+    /** Владелец репозитория */
+    readonly owner: string;
+    /** Название репозитория */
+    readonly repo: string;
+    /** Хост платформы (например: github.com, gitverse.ru) */
+    readonly host: string;
+}
+/**
+ * Создаёт валидированный объект ProviderRepoInfo
+ *
+ * @throws Error если owner, repo или host пустые или невалидные
+ */
+export declare function createProviderRepoInfo(owner: string, repo: string, host: string): ProviderRepoInfo;
+/**
+ * Retry функция type
+ */
+export type RetryFunction = <T>(fn: () => Promise<T>, operationName?: string) => Promise<T>;
+/**
+ * Опции для создания провайдера
+ */
+export interface CreateProviderOptions {
+    /** Информация о репозитории */
+    repoInfo: ProviderRepoInfo;
+    /** Платформа (если не указана, будет определена автоматически) */
+    platform?: GitPlatform;
+    /** Токен авторизации */
+    token: string;
+    /** Retry функция (опционально) */
+    retryFn?: RetryFunction;
+}
+/**
+ * Универсальный интерфейс провайдера релизов
+ *
+ * Реализуется для каждой Git платформы (GitVerse, GitHub, GitLab).
+ * Предоставляет единый API для работы с релизами.
+ */
+export interface ReleaseProvider {
+    /**
+     * Название платформы
+     */
+    readonly platform: GitPlatform;
+    /**
+     * Лимиты для assets
+     */
+    readonly assetLimits: AssetLimits;
+    /**
+     * Проверяет валидность токена
+     */
+    validateToken(): Promise<TokenValidationResult>;
+    /**
+     * Создаёт релиз
+     *
+     * @param tag - Тег для релиза
+     * @param name - Название релиза
+     * @param body - Описание релиза (release notes)
+     * @param options - Дополнительные опции
+     */
+    createRelease(tag: string, name: string, body: string, options?: CreateReleaseOptions): Promise<CreateReleaseResult>;
+    /**
+     * Проверяет существование релиза по тегу
+     *
+     * @param tag - Тег для проверки
+     */
+    releaseExists(tag: string): Promise<boolean>;
+    /**
+     * Получает информацию о релизе по тегу
+     *
+     * @param tag - Тег релиза
+     * @returns Информация о релизе или null если не найден
+     */
+    getRelease(tag: string): Promise<CreateReleaseResult | null>;
+    /**
+     * Загружает файл как asset к релизу
+     *
+     * @param releaseId - ID релиза
+     * @param filePath - Путь к файлу
+     * @param assetName - Имя asset в релизе
+     */
+    uploadAsset(releaseId: number | string, filePath: string, assetName: string): Promise<UploadAssetResult>;
+}