gitverse-release 2.0.0

package/README.md

@@ -0,0 +1,352 @@
+# @gitverse/release
+
+> =� 2B><0B870F8O @5;87>2 4;O GitVerse @5?>78B>@852 A ?>445@6:>9 Conventional Commits
+
+[![npm version](https://img.shields.io/npm/v/@gitverse/release.svg)](https://www.npmjs.com/package/@gitverse/release)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Test Coverage](https://img.shields.io/badge/coverage-99.85%25-brightgreen.svg)](./COVERAGE.md)
+
+## =� >7<>6=>AB8
+
+- > **2B><0B8G5A:>5 25@A8>=8@>20=85** =0 >A=>25 Conventional Commits
+- =� **5=5@0F8O CHANGELOG** A 3@C??8@>2:>9 ?> B8?0< :><<8B>2
+- < **=B53@0F8O A GitVerse API** 4;O A>740=8O @5;87>2
+- =� **>445@6:0 <>=>@5?>78B>@852** A =57028A8<K< 25@A8>=8@>20=85<
+- <� **2B><0B8G5A:>5 A>740=85** git B53>2 8 :><<8B>2
+- =
 ** 568< dry-run** 4;O 157>?0A=>3> B5AB8@>20=8O
+- � **81:0O :>=D83C@0F8O** G5@57 `.gitversereleaserc.json`
+
+## =� #AB0=>2:0
+
+```bash
+# ! ?><>ILN npm
+npm install -D @gitverse/release
+
+# ! ?><>ILN bun
+bun add -d @gitverse/release
+
+# ! ?><>ILN yarn
+yarn add -D @gitverse/release
+
+# ! ?><>ILN pnpm
+pnpm add -D @gitverse/release
+```
+
+## =� KAB@K9 AB0@B
+
+### 1. 07>2>5 8A?>;L7>20=85
+
+```bash
+# !>740BL @5;87 (dry-run 4;O ?@>25@:8)
+npx @gitverse/release --dry-run
+
+# !>740BL @5;87 8 >?C1;8:>20BL
+npx @gitverse/release
+```
+
+### 2. 0AB@>9:0 :>=D83C@0F88
+
+!>7409B5 `.gitversereleaserc.json` 2 :>@=5 ?@>5:B0:
+
+```json
+{
+  "git": {
+    "commitMessage": "chore(release): =� {version} [skip ci]",
+    "tagMessage": "Release {version}",
+    "push": true,
+    "commitChanges": true
+  },
+  "changelog": {
+    "types": {
+      "feat": "( Features",
+      "fix": "= Bug Fixes",
+      "perf": "� Performance",
+      "docs": "=� Documentation"
+    },
+    "showHash": true,
+    "showAuthor": true
+  },
+  "gitverse": {
+    "createRelease": true
+  }
+}
+```
+
+### 3. >102LB5 2 package.json
+
+```json
+{
+  "scripts": {
+    "release": "@gitverse/release",
+    "release:dry": "@gitverse/release --dry-run"
+  }
+}
+```
+
+## =� A?>;L7>20=85
+
+### Conventional Commits
+
+0:5B 02B><0B8G5A:8 >?@545;O5B B8? 25@A8>=8@>20=8O =0 >A=>25 :><<8B>2:
+
+```bash
+# Patch (1.0.0 � 1.0.1)
+git commit -m "fix: 8A?@02;5=0 >H81:0 20;840F88"
+
+# Minor (1.0.0 � 1.1.0)
+git commit -m "feat: 4>102;5= =>2K9 API endpoint"
+
+# Major (1.0.0 � 2.0.0)
+git commit -m "feat!: 87<5=5= D>@<0B >B25B0 API"
+# 8;8
+git commit -m "feat: =>20O DC=:F8O
+
+BREAKING CHANGE: 87<5=5= D>@<0B :>=D83C@0F88"
+```
+
+### @>3@0<<=>5 8A?>;L7>20=85
+
+```typescript
+import { release } from "@gitverse/release";
+
+// @>AB>9 @5;87
+const result = await release();
+
+console.log(result.success); // true
+console.log(result.newVersion); // "1.1.0"
+console.log(result.tag); // "v1.1.0"
+
+// ! >?F8O<8
+const result = await release(undefined, {
+  dryRun: true,
+  version: "2.0.0",
+  skipGitStatusCheck: false,
+});
+
+// ;O <>=>@5?>78B>@8O
+const result = await release("my-package", {
+  dryRun: false,
+});
+```
+
+## <� >=>@5?>78B>@88
+
+### >=D83C@0F8O 4;O <>=>@5?K
+
+```json
+{
+  "monorepo": {
+    "enabled": true,
+    "packages": [
+      {
+        "name": "core",
+        "packageName": "@myorg/core",
+        "path": "./packages/core",
+        "tagPrefix": "core@",
+        "changelog": "CHANGELOG.md"
+      },
+      {
+        "name": "ui",
+        "packageName": "@myorg/ui",
+        "path": "./packages/ui",
+        "tagPrefix": "ui@",
+        "changelog": "CHANGELOG.md"
+      }
+    ]
+  }
+}
+```
+
+### A?>;L7>20=85
+
+```bash
+#  5;87 :>=:@5B=>3> ?0:5B0
+npx @gitverse/release core
+
+# Dry-run 4;O ?0:5B0
+npx @gitverse/release ui --dry-run
+```
+
+### $8;LB@0F8O :><<8B>2 ?> scope
+
+```bash
+# ><<8BK 4;O ?0:5B0 "core"
+git commit -m "feat(core): 4>102;5=0 =>20O DC=:F8O"
+
+# ><<8BK 4;O ?0:5B0 "ui"
+git commit -m "fix(ui): 8A?@02;5= 103 2 :><?>=5=B5"
+
+# 1I85 :><<8BK (2;8ONB =0 2A5 ?0:5BK)
+git commit -m "chore: >1=>2;5=K 7028A8<>AB8"
+```
+
+## � >=D83C@0F8O
+
+### >;=K9 ?@8<5@ :>=D83C@0F88
+
+```json
+{
+  "git": {
+    "commitMessage": "chore(release): =� {version} [skip ci]",
+    "tagMessage": "Release {version}",
+    "push": true,
+    "commitChanges": true
+  },
+  "changelog": {
+    "types": {
+      "feat": "( Features",
+      "fix": "= Bug Fixes",
+      "perf": "� Performance Improvements",
+      "refactor": "{ Code Refactoring",
+      "docs": "=� Documentation",
+      "style": "=� Styles",
+      "test": " Tests",
+      "build": "=w Build System",
+      "ci": "=' CI/CD",
+      "chore": "=( Chores"
+    },
+    "showHash": true,
+    "showAuthor": true
+  },
+  "versioning": {
+    "tagPrefix": "v",
+    "prereleasePrefix": "beta",
+    "allowPrerelease": false
+  },
+  "gitverse": {
+    "createRelease": true,
+    "token": "${GITVERSE_TOKEN}"
+  },
+  "monorepo": {
+    "enabled": false,
+    "packages": []
+  }
+}
+```
+
+### 5@5<5==K5 >:@C65=8O
+
+```bash
+# GitVerse B>:5= 4;O A>740=8O @5;87>2
+export GITVERSE_TOKEN="your-token-here"
+
+# ;8 G5@57 .env D09;
+echo "GITVERSE_TOKEN=your-token" >> .env
+```
+
+## =
 ?F88 :><0=4=>9 AB@>:8
+
+```bash
+npx @gitverse/release [package] [options]
+
+@3C<5=BK:
+  package              <O ?0:5B0 4;O @5;870 (4;O <>=>@5?>78B>@852)
+
+?F88:
+  --dry-run            0?CAB8BL 157 2=5A5=8O 87<5=5=89
+  --version <version>  #:070BL :>=:@5B=CN 25@A8N
+  --skip-git-check     @>?CAB8BL ?@>25@:C G8AB>BK git
+  --help               >:070BL A?@02:C
+```
+
+## =� @8<5@K 2K2>40
+
+### 1KG=K9 @5;87
+
+```
+ Release created successfully!
+
+=� Package: my-app
+=� Version: 1.0.0 � 1.1.0
+<�  Tag: v1.1.0
+< Release: https://gitverse.ru/owner/repo/releases/tag/v1.1.0
+```
+
+### Dry-run @568<
+
+```
+=
 DRY RUN MODE - No changes will be made
+
+=� Package: my-app
+=� Version: 1.0.0 � 1.1.0
+<�  Tag: v1.1.0
+=� Commits: 3
+
+=� CHANGELOG:
+
+## [1.1.0] - 2025-01-31
+
+### ( Features
+
+- add user authentication ([abc123](https://gitverse.ru/owner/repo/commit/abc123)) by @user
+- implement dark mode ([def456](https://gitverse.ru/owner/repo/commit/def456)) by @user
+
+### = Bug Fixes
+
+- fix validation error ([ghi789](https://gitverse.ru/owner/repo/commit/ghi789)) by @user
+```
+
+## >� "5AB8@>20=85
+
+0:5B 8<55B 180+ B5AB>2 A ?>:@KB85< ~99.85%:
+
+```bash
+# 0?CAB8BL B5ABK
+bun test
+
+# ! ?>:@KB85<
+bun test:coverage
+```
+
+## > =B53@0F8O A CI/CD
+
+### GitHub Actions (.gitverse/workflows/release.yaml)
+
+```yaml
+name: Release
+
+on:
+  workflow_dispatch:
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GH_TOKEN }}
+
+      - uses: oven-sh/setup-bun@v1
+
+      - run: bun install
+
+      - name: Configure Git
+        run: |
+          git config user.name "Release Bot"
+          git config user.email "bot@example.com"
+
+      - name: Create Release
+        run: bun run release
+        env:
+          GITVERSE_TOKEN: ${{ secrets.GITVERSE_TOKEN }}
+```
+
+## =� 8F5=78O
+
+MIT � [RainyPixel](https://gitverse.ru/RainyPixel)
+
+## = !AK;:8
+
+- [GitVerse SDK](https://gitverse.ru/RainyPixel/gitverse-sdk)
+- [Conventional Commits](https://www.conventionalcommits.org/ru/v1.0.0/)
+- [Keep a Changelog](https://keepachangelog.com/ru/1.0.0/)
+- [Semantic Versioning](https://semver.org/lang/ru/)
+
+## = 0H;8 103?
+
+!>7409B5 issue =0 [GitVerse](https://gitverse.ru/RainyPixel/gitverse-sdk/issues)
+
+---
+
+!45;0=> A d 4;O GitVerse

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/cli.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env bun
+import {
+  release
+} from "./index.js";
+
+// src/cli.ts
+import { parseArgs } from "node:util";
+var HELP_TEXT = `
+gitverse-release - Release automation tool for GitVerse
+
+Usage:
+  gitverse-release [package-name] [options]
+
+Options:
+  --dry-run              Test run without making changes
+  --config <path>        Path to config file (default: .gitverereleaserc.json)
+  --package <name>       Package name to release (for monorepo)
+  --version <version>    Force specific version instead of auto-calculation
+  --prerelease [tag]     Create prerelease version (e.g., beta, alpha, rc)
+  --no-commit            Skip creating git commit
+  --no-tag               Skip creating git tag
+  --no-push              Skip pushing to remote
+  --no-release           Skip creating GitVerse Release
+  --verbose              Verbose output
+  --help                 Show this help message
+
+Examples:
+  # Auto-detect version and create release
+  gitverse-release sdk
+
+  # Force specific version
+  gitverse-release sdk --version 2.1.0
+
+  # Create prerelease
+  gitverse-release sdk --prerelease beta
+
+  # Dry run (test without changes)
+  gitverse-release sdk --dry-run
+
+  # Custom config
+  gitverse-release sdk --config ./my-config.json
+
+Environment Variables:
+  GITVERSE_TOKEN         GitVerse API token (required)
+
+Documentation:
+  https://gitverse.ru/rainypixel/gitverse-sdk
+`;
+async function main() {
+  try {
+    const { values, positionals } = parseArgs({
+      allowPositionals: true,
+      options: {
+        config: { type: "string" },
+        "dry-run": { type: "boolean" },
+        help: { type: "boolean" },
+        "no-commit": { type: "boolean" },
+        "no-push": { type: "boolean" },
+        "no-release": { type: "boolean" },
+        "no-tag": { type: "boolean" },
+        package: { type: "string" },
+        prerelease: { type: "string" },
+        verbose: { type: "boolean" },
+        version: { type: "string" }
+      }
+    });
+    if (values.help) {
+      console.log(HELP_TEXT);
+      process.exit(0);
+    }
+    const options = {
+      config: values.config,
+      dryRun: values["dry-run"],
+      noCommit: values["no-commit"],
+      noPush: values["no-push"],
+      noRelease: values["no-release"],
+      noTag: values["no-tag"],
+      package: values.package,
+      prerelease: values.prerelease,
+      verbose: values.verbose,
+      version: values.version
+    };
+    const packageName = positionals[0] || options.package;
+    const result = await release(packageName, options);
+    if (options.verbose) {
+      console.log(`
+\uD83D\uDCCA Release Result:`);
+      console.log(JSON.stringify(result, null, 2));
+    }
+    if (result.warnings.length > 0) {
+      console.log(`
+⚠️  Warnings:`);
+      for (const warning of result.warnings) {
+        console.log(`  - ${warning}`);
+      }
+    }
+    if (result.errors.length > 0) {
+      console.error(`
+❌ Errors:`);
+      for (const error of result.errors) {
+        console.error(`  - ${error}`);
+      }
+      process.exit(1);
+    }
+    if (!result.success) {
+      process.exit(1);
+    }
+    process.exit(0);
+  } catch (error) {
+    console.error(`
+❌ Fatal error:`);
+    console.error(error);
+    process.exit(1);
+  }
+}
+main();
+
+//# debugId=24A29664F6808ADA64756E2164756E21

package/dist/cli.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/cli.ts"],
+  "sourcesContent": [
+    "#!/usr/bin/env bun\n\nimport { parseArgs } from \"node:util\";\nimport { release } from \"./index\";\nimport type { CliOptions } from \"./types\";\n\nconst HELP_TEXT = `\ngitverse-release - Release automation tool for GitVerse\n\nUsage:\n  gitverse-release [package-name] [options]\n\nOptions:\n  --dry-run              Test run without making changes\n  --config <path>        Path to config file (default: .gitverereleaserc.json)\n  --package <name>       Package name to release (for monorepo)\n  --version <version>    Force specific version instead of auto-calculation\n  --prerelease [tag]     Create prerelease version (e.g., beta, alpha, rc)\n  --no-commit            Skip creating git commit\n  --no-tag               Skip creating git tag\n  --no-push              Skip pushing to remote\n  --no-release           Skip creating GitVerse Release\n  --verbose              Verbose output\n  --help                 Show this help message\n\nExamples:\n  # Auto-detect version and create release\n  gitverse-release sdk\n\n  # Force specific version\n  gitverse-release sdk --version 2.1.0\n\n  # Create prerelease\n  gitverse-release sdk --prerelease beta\n\n  # Dry run (test without changes)\n  gitverse-release sdk --dry-run\n\n  # Custom config\n  gitverse-release sdk --config ./my-config.json\n\nEnvironment Variables:\n  GITVERSE_TOKEN         GitVerse API token (required)\n\nDocumentation:\n  https://gitverse.ru/rainypixel/gitverse-sdk\n`;\n\nasync function main() {\n  try {\n    const { values, positionals } = parseArgs({\n      allowPositionals: true,\n      options: {\n        config: { type: \"string\" },\n        \"dry-run\": { type: \"boolean\" },\n        help: { type: \"boolean\" },\n        \"no-commit\": { type: \"boolean\" },\n        \"no-push\": { type: \"boolean\" },\n        \"no-release\": { type: \"boolean\" },\n        \"no-tag\": { type: \"boolean\" },\n        package: { type: \"string\" },\n        prerelease: { type: \"string\" },\n        verbose: { type: \"boolean\" },\n        version: { type: \"string\" },\n      },\n    });\n\n    // Помощь\n    if (values.help) {\n      console.log(HELP_TEXT);\n      process.exit(0);\n    }\n\n    // Собираем опции\n    const options: CliOptions = {\n      config: values.config,\n      dryRun: values[\"dry-run\"],\n      noCommit: values[\"no-commit\"],\n      noPush: values[\"no-push\"],\n      noRelease: values[\"no-release\"],\n      noTag: values[\"no-tag\"],\n      package: values.package,\n      prerelease: values.prerelease,\n      verbose: values.verbose,\n      version: values.version,\n    };\n\n    // Имя пакета может быть в позиционных аргументах или в --package\n    const packageName = positionals[0] || options.package;\n\n    // Запускаем релиз\n    const result = await release(packageName, options);\n\n    // Выводим результат\n    if (options.verbose) {\n      console.log(\"\\n📊 Release Result:\");\n      console.log(JSON.stringify(result, null, 2));\n    }\n\n    // Показываем ошибки и предупреждения\n    if (result.warnings.length > 0) {\n      console.log(\"\\n⚠️  Warnings:\");\n      for (const warning of result.warnings) {\n        console.log(`  - ${warning}`);\n      }\n    }\n\n    if (result.errors.length > 0) {\n      console.error(\"\\n❌ Errors:\");\n      for (const error of result.errors) {\n        console.error(`  - ${error}`);\n      }\n      process.exit(1);\n    }\n\n    if (!result.success) {\n      process.exit(1);\n    }\n\n    process.exit(0);\n  } catch (error) {\n    console.error(\"\\n❌ Fatal error:\");\n    console.error(error);\n    process.exit(1);\n  }\n}\n\n// Запускаем CLI\nvoid main();\n"
+  ],
+  "mappings": ";;;;;;AAEA;AAIA,IAAM,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0ClB,eAAe,IAAI,GAAG;AAAA,EACpB,IAAI;AAAA,IACF,QAAQ,QAAQ,gBAAgB,UAAU;AAAA,MACxC,kBAAkB;AAAA,MAClB,SAAS;AAAA,QACP,QAAQ,EAAE,MAAM,SAAS;AAAA,QACzB,WAAW,EAAE,MAAM,UAAU;AAAA,QAC7B,MAAM,EAAE,MAAM,UAAU;AAAA,QACxB,aAAa,EAAE,MAAM,UAAU;AAAA,QAC/B,WAAW,EAAE,MAAM,UAAU;AAAA,QAC7B,cAAc,EAAE,MAAM,UAAU;AAAA,QAChC,UAAU,EAAE,MAAM,UAAU;AAAA,QAC5B,SAAS,EAAE,MAAM,SAAS;AAAA,QAC1B,YAAY,EAAE,MAAM,SAAS;AAAA,QAC7B,SAAS,EAAE,MAAM,UAAU;AAAA,QAC3B,SAAS,EAAE,MAAM,SAAS;AAAA,MAC5B;AAAA,IACF,CAAC;AAAA,IAGD,IAAI,OAAO,MAAM;AAAA,MACf,QAAQ,IAAI,SAAS;AAAA,MACrB,QAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,IAGA,MAAM,UAAsB;AAAA,MAC1B,QAAQ,OAAO;AAAA,MACf,QAAQ,OAAO;AAAA,MACf,UAAU,OAAO;AAAA,MACjB,QAAQ,OAAO;AAAA,MACf,WAAW,OAAO;AAAA,MAClB,OAAO,OAAO;AAAA,MACd,SAAS,OAAO;AAAA,MAChB,YAAY,OAAO;AAAA,MACnB,SAAS,OAAO;AAAA,MAChB,SAAS,OAAO;AAAA,IAClB;AAAA,IAGA,MAAM,cAAc,YAAY,MAAM,QAAQ;AAAA,IAG9C,MAAM,SAAS,MAAM,QAAQ,aAAa,OAAO;AAAA,IAGjD,IAAI,QAAQ,SAAS;AAAA,MACnB,QAAQ,IAAI;AAAA,6BAAqB;AAAA,MACjC,QAAQ,IAAI,KAAK,UAAU,QAAQ,MAAM,CAAC,CAAC;AAAA,IAC7C;AAAA,IAGA,IAAI,OAAO,SAAS,SAAS,GAAG;AAAA,MAC9B,QAAQ,IAAI;AAAA,cAAgB;AAAA,MAC5B,WAAW,WAAW,OAAO,UAAU;AAAA,QACrC,QAAQ,IAAI,OAAO,SAAS;AAAA,MAC9B;AAAA,IACF;AAAA,IAEA,IAAI,OAAO,OAAO,SAAS,GAAG;AAAA,MAC5B,QAAQ,MAAM;AAAA,UAAY;AAAA,MAC1B,WAAW,SAAS,OAAO,QAAQ;AAAA,QACjC,QAAQ,MAAM,OAAO,OAAO;AAAA,MAC9B;AAAA,MACA,QAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,IAEA,IAAI,CAAC,OAAO,SAAS;AAAA,MACnB,QAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,IAEA,QAAQ,KAAK,CAAC;AAAA,IACd,OAAO,OAAO;AAAA,IACd,QAAQ,MAAM;AAAA,eAAiB;AAAA,IAC/B,QAAQ,MAAM,KAAK;AAAA,IACnB,QAAQ,KAAK,CAAC;AAAA;AAAA;AAKb,KAAK;",
+  "debugId": "24A29664F6808ADA64756E2164756E21",
+  "names": []
+}

package/dist/config.d.ts

@@ -0,0 +1,13 @@
+import type { ReleaseConfig } from "./types";
+/**
+ * Дефолтная конфигурация
+ */
+export declare const DEFAULT_CONFIG: Required<ReleaseConfig>;
+/**
+ * Загружает конфигурацию из файла
+ */
+export declare function loadConfig(configPath?: string): Promise<Required<ReleaseConfig>>;
+/**
+ * Валидирует конфигурацию
+ */
+export declare function validateConfig(config: Required<ReleaseConfig>): void;

package/dist/gitverse.d.ts

@@ -0,0 +1,28 @@
+import type { GitRepoInfo } from "./types";
+/**
+ * GitVerse API клиент для создания релизов
+ */
+export declare class GitVerseReleaseClient {
+    private client;
+    private repoInfo;
+    constructor(token: string, repoInfo: GitRepoInfo);
+    /**
+     * Создает релиз на GitVerse
+     */
+    createRelease(tag: string, name: string, body: string, options?: {
+        draft?: boolean;
+        prerelease?: boolean;
+    }): Promise<string>;
+    /**
+     * Проверяет существование релиза по тегу
+     */
+    releaseExists(tag: string): Promise<boolean>;
+    /**
+     * Получает информацию о релизе по тегу
+     */
+    getRelease(tag: string): Promise<import("gitverse-api-sdk").Release>;
+}
+/**
+ * Создает клиент для работы с GitVerse API
+ */
+export declare function createGitVerseClient(repoInfo: GitRepoInfo): GitVerseReleaseClient;

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { CliOptions, ReleaseResult } from "./types";
+/**
+ * Основная функция для создания релиза
+ */
+export declare function release(packageName?: string, options?: CliOptions): Promise<ReleaseResult>;
+export { loadConfig, validateConfig } from "./config";
+export { createGitVerseClient } from "./gitverse";
+export * from "./types";