@next-vibe/checker 1.0.11 → 1.0.12

package/src/app/api/[locale]/system/release-tool/repository/validation.ts

@@ -0,0 +1,288 @@
+/**
+ * Validation Service
+ * Release validation and checks
+ */
+
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+
+import type { ResponseType } from "next-vibe/shared/types/response.schema";
+import {
+  ErrorResponseTypes,
+  fail,
+  success,
+} from "next-vibe/shared/types/response.schema";
+
+import type { EndpointLogger } from "../../unified-interface/shared/logger/endpoint";
+import type { GitInfo, ReleaseConfig } from "../definition";
+import { MESSAGES } from "./constants";
+
+// ============================================================================
+// Interface
+// ============================================================================
+
+export interface IValidationService {
+  /**
+   * Validate branch configuration
+   */
+  validateBranch(
+    config: ReleaseConfig,
+    gitInfo: GitInfo,
+    logger: EndpointLogger,
+  ): ResponseType<void>;
+
+  /**
+   * Validate working directory is clean
+   */
+  validateWorkingDirectory(
+    config: ReleaseConfig,
+    gitInfo: GitInfo,
+    logger: EndpointLogger,
+  ): ResponseType<void>;
+
+  /**
+   * Verify lockfile integrity
+   */
+  verifyLockfile(
+    cwd: string,
+    packageManager: string,
+    logger: EndpointLogger,
+  ): ResponseType<void>;
+
+  /**
+   * Run all validations
+   */
+  runAll(
+    config: ReleaseConfig,
+    gitInfo: GitInfo,
+    cwd: string,
+    packageManager: string,
+    logger: EndpointLogger,
+  ): ResponseType<void>;
+
+  /**
+   * Run basic validations (without branch check - for early validation)
+   * Branch check should happen later, right before git operations
+   */
+  runBasicValidations(
+    config: ReleaseConfig,
+    cwd: string,
+    packageManager: string,
+    logger: EndpointLogger,
+  ): ResponseType<void>;
+}
+
+// ============================================================================
+// Implementation
+// ============================================================================
+
+export class ValidationService implements IValidationService {
+  /**
+   * Validate branch configuration
+   */
+  validateBranch(
+    config: ReleaseConfig,
+    gitInfo: GitInfo,
+    logger: EndpointLogger,
+  ): ResponseType<void> {
+    logger.info(MESSAGES.VALIDATION_BRANCH_CHECK);
+
+    const branchConfig = config.branch;
+    if (!branchConfig) {
+      return success();
+    }
+
+    const currentBranch = gitInfo.currentBranch;
+    if (!currentBranch) {
+      return success(); // Can't validate without branch info
+    }
+
+    const mainBranch = branchConfig.main ?? "main";
+    const isOnMain = currentBranch === mainBranch;
+    const isOnDevelop =
+      branchConfig.develop && currentBranch === branchConfig.develop;
+
+    // Check if current branch is allowed
+    if (!isOnMain && !isOnDevelop && !branchConfig.allowNonMain) {
+      logger.error(MESSAGES.VALIDATION_BRANCH_NOT_ALLOWED, {
+        currentBranch,
+        mainBranch,
+      });
+      return fail({
+        message: "app.api.system.releaseTool.git.notOnMain",
+        errorType: ErrorResponseTypes.VALIDATION_ERROR,
+        messageParams: { currentBranch, main: mainBranch },
+      });
+    }
+
+    // Check protected branches
+    if (branchConfig.protected?.includes(currentBranch)) {
+      logger.warn(`Branch ${currentBranch} is protected`);
+    }
+
+    return success();
+  }
+
+  /**
+   * Validate working directory is clean
+   */
+  validateWorkingDirectory(
+    config: ReleaseConfig,
+    gitInfo: GitInfo,
+    logger: EndpointLogger,
+  ): ResponseType<void> {
+    if (!config.requireCleanWorkingDir) {
+      return success();
+    }
+
+    if (gitInfo.hasUncommittedChanges) {
+      logger.error(MESSAGES.VALIDATION_DIRTY_WORKING_DIR);
+      return fail({
+        message: "app.api.system.releaseTool.git.uncommittedChanges",
+        errorType: ErrorResponseTypes.VALIDATION_ERROR,
+      });
+    }
+
+    return success();
+  }
+
+  /**
+   * Verify lockfile integrity
+   */
+  verifyLockfile(
+    cwd: string,
+    packageManager: string,
+    logger: EndpointLogger,
+  ): ResponseType<void> {
+    logger.info(MESSAGES.LOCKFILE_CHECKING);
+
+    const lockfileMap: Record<string, string> = {
+      npm: "package-lock.json",
+      yarn: "yarn.lock",
+      pnpm: "pnpm-lock.yaml",
+      bun: "bun.lock",
+      deno: "deno.lock",
+    };
+
+    const lockfileName = lockfileMap[packageManager];
+    if (!lockfileName) {
+      return success();
+    }
+
+    const lockfilePath = join(cwd, lockfileName);
+
+    if (!existsSync(lockfilePath)) {
+      logger.warn(MESSAGES.LOCKFILE_MISSING, { expected: lockfileName });
+      return success();
+    }
+
+    try {
+      // Verify lockfile integrity based on package manager
+      switch (packageManager) {
+        case "npm":
+          execSync("npm ci --dry-run 2>/dev/null || npm install --dry-run", {
+            cwd,
+            stdio: "pipe",
+            timeout: 60000,
+          });
+          break;
+        case "yarn":
+          execSync(
+            "yarn install --frozen-lockfile --check-files 2>/dev/null || true",
+            {
+              cwd,
+              stdio: "pipe",
+              timeout: 60000,
+            },
+          );
+          break;
+        case "pnpm":
+          execSync(
+            "pnpm install --frozen-lockfile --dry-run 2>/dev/null || true",
+            {
+              cwd,
+              stdio: "pipe",
+              timeout: 60000,
+            },
+          );
+          break;
+        case "bun":
+          // Bun doesn't have a direct frozen lockfile check, just verify file exists
+          break;
+      }
+
+      logger.info(MESSAGES.LOCKFILE_VALID);
+      return success();
+    } catch (error) {
+      logger.error(MESSAGES.LOCKFILE_INVALID, { error: String(error) });
+      return fail({
+        message: "app.api.system.releaseTool.lockfile.invalid",
+        errorType: ErrorResponseTypes.VALIDATION_ERROR,
+        messageParams: { error: String(error) },
+      });
+    }
+  }
+
+  /**
+   * Run all validations
+   */
+  runAll(
+    config: ReleaseConfig,
+    gitInfo: GitInfo,
+    cwd: string,
+    packageManager: string,
+    logger: EndpointLogger,
+  ): ResponseType<void> {
+    // Validate branch
+    const branchResult = this.validateBranch(config, gitInfo, logger);
+    if (!branchResult.success) {
+      return branchResult;
+    }
+
+    // Validate working directory
+    const workingDirResult = this.validateWorkingDirectory(
+      config,
+      gitInfo,
+      logger,
+    );
+    if (!workingDirResult.success) {
+      return workingDirResult;
+    }
+
+    // Verify lockfile if configured
+    if (config.verifyLockfile) {
+      const lockfileResult = this.verifyLockfile(cwd, packageManager, logger);
+      if (!lockfileResult.success) {
+        return lockfileResult;
+      }
+    }
+
+    logger.info(MESSAGES.VALIDATION_PASSED);
+    return success();
+  }
+
+  /**
+   * Run basic validations without branch check
+   * Branch check is deferred to right before git operations
+   */
+  runBasicValidations(
+    config: ReleaseConfig,
+    cwd: string,
+    packageManager: string,
+    logger: EndpointLogger,
+  ): ResponseType<void> {
+    // Verify lockfile if configured
+    if (config.verifyLockfile) {
+      const lockfileResult = this.verifyLockfile(cwd, packageManager, logger);
+      if (!lockfileResult.success) {
+        return lockfileResult;
+      }
+    }
+
+    logger.debug(MESSAGES.VALIDATION_PASSED);
+    return success();
+  }
+}
+
+export const validationService = new ValidationService();

package/src/app/api/[locale]/system/release-tool/repository/version-service.ts

@@ -0,0 +1,297 @@
+/**
+ * Version Service
+ * Version management and semantic versioning operations
+ */
+
+import { execSync } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+
+import type { EndpointLogger } from "../../unified-interface/shared/logger/endpoint";
+import type {
+  PackageJson,
+  ReleaseConfig,
+  ReleaseOptions,
+  ReleasePackage,
+  VersionIncrement,
+  VersionInfo,
+} from "../definition";
+import { MESSAGES } from "./constants";
+
+// ============================================================================
+// Interface
+// ============================================================================
+
+export interface IVersionService {
+  /**
+   * Get the last version from git tags
+   */
+  getLastVersionFromGitTag(
+    tagPrefix: string,
+    mainPackagePath: string,
+    logger: EndpointLogger,
+  ): string;
+
+  /**
+   * Bump version based on increment type
+   */
+  bumpVersion(
+    currentVersion: string,
+    increment: VersionIncrement,
+    prereleaseId?: string,
+  ): string;
+
+  /**
+   * Compare two version strings
+   */
+  compareVersions(a: string, b: string): number;
+
+  /**
+   * Get version info for a package
+   */
+  getVersionInfo(
+    logger: EndpointLogger,
+    pkg: ReleasePackage,
+    packageJson: PackageJson,
+    config: ReleaseConfig,
+    releaseConfig: ReleaseOptions,
+    requestedIncrement?: VersionIncrement,
+    prereleaseId?: string,
+  ): VersionInfo;
+
+  /**
+   * Update version in files using version bumper config
+   */
+  updateVariableStringValue(
+    logger: EndpointLogger,
+    newVersion: string,
+    releaseConfig: ReleaseOptions,
+  ): void;
+}
+
+// ============================================================================
+// Implementation
+// ============================================================================
+
+export class VersionService implements IVersionService {
+  getLastVersionFromGitTag(
+    tagPrefix: string,
+    mainPackagePath: string,
+    logger: EndpointLogger,
+  ): string {
+    try {
+      const tagsExist =
+        execSync("git tag", { cwd: mainPackagePath }).toString().trim().length >
+        0;
+
+      if (!tagsExist) {
+        logger.debug(MESSAGES.GIT_NO_TAGS);
+        return "0.0.0";
+      }
+
+      const lastGitTag = execSync(
+        `git describe --tags --abbrev=0 --match="${tagPrefix}*"`,
+        { cwd: mainPackagePath },
+      )
+        .toString()
+        .trim();
+
+      return lastGitTag.replace(tagPrefix, "");
+    } catch {
+      logger.debug(MESSAGES.GIT_NO_TAGS);
+      return "0.0.0";
+    }
+  }
+
+  private parseVersionString(v: string): {
+    main: number[];
+    pre: string | null;
+  } {
+    const [main, pre] = v.split("-");
+    return {
+      main: (main ?? "0.0.0").split(".").map(Number),
+      pre: pre ?? null,
+    };
+  }
+
+  compareVersions(a: string, b: string): number {
+    const va = this.parseVersionString(a);
+    const vb = this.parseVersionString(b);
+
+    // Compare main version parts
+    for (let i = 0; i < 3; i++) {
+      const diff = (va.main[i] ?? 0) - (vb.main[i] ?? 0);
+      if (diff !== 0) {
+        return diff;
+      }
+    }
+
+    // If main versions are equal, compare prerelease
+    if (va.pre === null && vb.pre === null) {
+      return 0;
+    }
+    if (va.pre === null) {
+      return 1;
+    } // Release > prerelease
+    if (vb.pre === null) {
+      return -1;
+    }
+
+    return va.pre.localeCompare(vb.pre);
+  }
+
+  bumpVersion(
+    currentVersion: string,
+    increment: VersionIncrement,
+    prereleaseId?: string,
+  ): string {
+    // Parse current version
+    const [mainPart, prePart] = currentVersion.split("-");
+    const parts = (mainPart ?? "0.0.0").split(".").map(Number);
+    const [major = 0, minor = 0, patch = 0] = parts;
+
+    const id = prereleaseId ?? "alpha";
+
+    switch (increment) {
+      case "major":
+        return `${major + 1}.0.0`;
+
+      case "minor":
+        return `${major}.${minor + 1}.0`;
+
+      case "patch":
+        return `${major}.${minor}.${patch + 1}`;
+
+      case "premajor":
+        return `${major + 1}.0.0-${id}.0`;
+
+      case "preminor":
+        return `${major}.${minor + 1}.0-${id}.0`;
+
+      case "prepatch":
+        return `${major}.${minor}.${patch + 1}-${id}.0`;
+
+      case "prerelease": {
+        if (prePart) {
+          // Already a prerelease, bump the prerelease number
+          const preMatch = prePart.match(/^(.+)\.(\d+)$/);
+          if (preMatch) {
+            const preId = preMatch[1];
+            const preNum = parseInt(preMatch[2] ?? "0", 10);
+            return `${mainPart}-${preId}.${preNum + 1}`;
+          }
+          return `${mainPart}-${id}.0`;
+        }
+        // Not a prerelease, make it one
+        return `${major}.${minor}.${patch + 1}-${id}.0`;
+      }
+
+      default:
+        return `${major}.${minor}.${patch + 1}`;
+    }
+  }
+
+  getVersionInfo(
+    logger: EndpointLogger,
+    pkg: ReleasePackage,
+    packageJson: PackageJson,
+    config: ReleaseConfig,
+    releaseConfig: ReleaseOptions,
+    requestedIncrement?: VersionIncrement,
+    prereleaseId?: string,
+  ): VersionInfo {
+    const tagPrefix = releaseConfig.tagPrefix ?? "v";
+    const currentGitVersion = this.getLastVersionFromGitTag(
+      tagPrefix,
+      pkg.directory,
+      logger,
+    );
+
+    // Priority: globalVersion > releaseConfig.version > package.json version
+    const currentVersion =
+      config.globalVersion ?? releaseConfig.version ?? packageJson.version;
+
+    const lastTag = `${tagPrefix}${currentGitVersion}`;
+
+    let finalVersion: string;
+
+    if (requestedIncrement) {
+      // User specified an increment - bump from whichever is newer: git tag or configured version
+      const baseVersion =
+        this.compareVersions(currentVersion, currentGitVersion) > 0
+          ? currentVersion
+          : currentGitVersion;
+      finalVersion = this.bumpVersion(
+        baseVersion,
+        requestedIncrement,
+        prereleaseId ?? releaseConfig.prereleaseId,
+      );
+    } else if (this.compareVersions(currentVersion, currentGitVersion) > 0) {
+      // Config version is newer than git version
+      finalVersion = currentVersion;
+    } else {
+      // Default to patch bump
+      finalVersion = this.bumpVersion(currentGitVersion, "patch");
+    }
+
+    const newTag = `${tagPrefix}${finalVersion}`;
+
+    return { newVersion: finalVersion, lastTag, newTag };
+  }
+
+  updateVariableStringValue(
+    logger: EndpointLogger,
+    newVersion: string,
+    releaseConfig: ReleaseOptions,
+  ): void {
+    if (!releaseConfig.versionBumper) {
+      return;
+    }
+
+    for (const fileInfo of releaseConfig.versionBumper) {
+      if (!existsSync(fileInfo.filePath)) {
+        logger.warn(`Version bumper file not found: ${fileInfo.filePath}`);
+        continue;
+      }
+
+      const fileContent = readFileSync(fileInfo.filePath, "utf8");
+      let updatedContent = fileContent;
+
+      const isPhpFile = fileInfo.filePath.toLowerCase().endsWith(".php");
+      const isJsonFile = fileInfo.filePath.toLowerCase().endsWith(".json");
+
+      if (isPhpFile) {
+        const phpDefineRegex = new RegExp(
+          `(define\\s*\\(\\s*["']${fileInfo.varName}["']\\s*,\\s*["'])([^"']*)(["'])`,
+          "g",
+        );
+        updatedContent = fileContent.replace(
+          phpDefineRegex,
+          `$1${newVersion}$3`,
+        );
+      } else if (isJsonFile) {
+        const jsonRegex = new RegExp(
+          `("${fileInfo.varName}"\\s*:\\s*")([^"]*)(")`,
+          "g",
+        );
+        updatedContent = fileContent.replace(jsonRegex, `$1${newVersion}$3`);
+      } else {
+        const constRegex = new RegExp(
+          `(const\\s+${fileInfo.varName}\\s*=\\s*["'])([^"']*)(["'])`,
+          "g",
+        );
+        updatedContent = fileContent.replace(constRegex, `$1${newVersion}$3`);
+      }
+
+      if (updatedContent !== fileContent) {
+        writeFileSync(fileInfo.filePath, updatedContent);
+        logger.debug(MESSAGES.VERSION_FILE_UPDATED, {
+          filePath: fileInfo.filePath,
+          newVersion,
+        });
+      }
+    }
+  }
+}
+
+// Singleton instance
+export const versionService = new VersionService();

package/src/app/api/[locale]/system/release-tool/route.ts

@@ -0,0 +1,21 @@
+/**
+ * Release Tool Route
+ * API route for managing package releases
+ */
+
+import "server-only";
+
+import { endpointsHandler } from "@/app/api/[locale]/system/unified-interface/shared/endpoints/route/multi";
+import { Methods } from "@/app/api/[locale]/system/unified-interface/shared/types/enums";
+
+import releaseToolEndpoints from "./definition";
+import { releaseToolRepository } from "./repository";
+
+export const { POST, tools } = endpointsHandler({
+  endpoint: releaseToolEndpoints,
+  [Methods.POST]: {
+    handler: ({ data, locale, logger }) => {
+      return releaseToolRepository.execute(data, locale, logger);
+    },
+  },
+});