@next-vibe/checker 1.0.11 → 1.0.12

package/src/app/api/[locale]/system/builder/repository/constants.ts

@@ -0,0 +1,125 @@
+/**
+ * Builder Constants
+ * Shared constants for the builder system
+ */
+
+import { resolve } from "node:path";
+
+import type { BuildProfile, SourcemapMode } from "../definition";
+
+// ============================================================================
+// Path Constants
+// ============================================================================
+
+/** Root directory for all path resolutions */
+export const ROOT_DIR = resolve(process.cwd());
+
+// ============================================================================
+// Size Thresholds
+// ============================================================================
+
+/** Bundle size thresholds for warnings (in bytes) */
+export const SIZE_THRESHOLDS = {
+  /** 5MB - show warning */
+  WARNING: 5 * 1024 * 1024,
+  /** 15MB - show critical warning */
+  CRITICAL: 15 * 1024 * 1024,
+} as const;
+
+// ============================================================================
+// Default Externals
+// ============================================================================
+
+/** Default external modules that cannot be bundled (native/binary dependencies) */
+export const DEFAULT_CLI_EXTERNALS = [
+  // Native crypto
+  "argon2",
+  // Database drivers
+  "pg-native",
+  "better-sqlite3",
+  // Graphics
+  "canvas",
+  // CSS processing
+  "lightningcss",
+  // OXC native bindings (all platforms)
+  "@oxc-project/oxc-darwin-arm64",
+  "@oxc-project/oxc-darwin-x64",
+  "@oxc-project/oxc-linux-arm64-gnu",
+  "@oxc-project/oxc-linux-arm64-musl",
+  "@oxc-project/oxc-linux-x64-gnu",
+  "@oxc-project/oxc-linux-x64-musl",
+  "@oxc-project/oxc-win32-arm64-msvc",
+  "@oxc-project/oxc-win32-x64-msvc",
+  "@oxc-parser/napi",
+  "@oxc-parser/napi-darwin-arm64",
+  "@oxc-parser/napi-darwin-x64",
+  "@oxc-parser/napi-linux-arm64-gnu",
+  "@oxc-parser/napi-linux-arm64-musl",
+  "@oxc-parser/napi-linux-x64-gnu",
+  "@oxc-parser/napi-linux-x64-musl",
+  "@oxc-parser/napi-win32-arm64-msvc",
+  "@oxc-parser/napi-win32-x64-msvc",
+] as const;
+
+// ============================================================================
+// Profile Defaults
+// ============================================================================
+
+/** Default settings per profile (type inlined - no separate types.ts needed) */
+export const PROFILE_DEFAULTS: Record<
+  BuildProfile,
+  {
+    minify: boolean;
+    sourcemap: boolean | SourcemapMode;
+    treeShaking: boolean;
+    analyze: boolean;
+  }
+> = {
+  development: {
+    minify: false,
+    sourcemap: "external",
+    treeShaking: false,
+    analyze: false,
+  },
+  production: {
+    minify: true,
+    sourcemap: false,
+    treeShaking: true,
+    analyze: true,
+  },
+};
+
+// ============================================================================
+// Messages
+// ============================================================================
+
+/** Builder messages */
+export const MESSAGES = {
+  BUILD_START: "Starting build...",
+  BUILD_COMPLETE: "Build completed successfully",
+  BUILD_FAILED: "Build failed",
+  DRY_RUN_MODE: "Running in dry-run mode (no files will be modified)",
+  LOADING_CONFIG: "Loading configuration",
+  USING_INLINE_CONFIG: "Using inline configuration",
+  CLEANING_FOLDERS: "Cleaning output folders",
+  COMPILING_FILES: "Compiling files",
+  BUNDLING_CLI: "Bundling CLI",
+  COPYING_FILES: "Copying additional files",
+  CREATING_PACKAGE_JSON: "Creating package.json",
+  GENERATING_REPORT: "Generating build report",
+  BUNDLE_ANALYSIS: "Bundle Analysis",
+  OPTIMIZATION_TIPS: "Optimization Tips",
+  BUILD_SUMMARY: "Build Summary",
+  RUNNING_PRE_BUILD: "Running pre-build hook",
+  RUNNING_POST_BUILD: "Running post-build hook",
+  PARALLEL_COMPILING: "Parallel compilation",
+  PARALLEL_COMPLETE: "Parallel compilation complete",
+  BUNDLE_SUCCESS: "Bundle created successfully",
+  BUNDLE_FAILED: "Bundle creation failed",
+  REPORT_GENERATED: "Build report generated",
+  SUGGESTIONS: "Suggestions",
+  TOTAL_DURATION: "Total duration",
+  FILES_BUILT: "Files built",
+  FILES_COPIED: "Files copied",
+  STEPS_COMPLETED: "Steps completed",
+} as const;

package/src/app/api/[locale]/system/builder/repository/error-suggester.ts

@@ -0,0 +1,75 @@
+/**
+ * Error Suggester Service
+ * Provides actionable suggestions based on error messages
+ */
+
+import type { TFunction } from "@/i18n/core/static-types";
+
+// ============================================================================
+// Interface
+// ============================================================================
+
+export interface IErrorSuggester {
+  /**
+   * Get actionable suggestions based on an error message
+   */
+  getSuggestions(errorMessage: string, t: TFunction): string[];
+}
+
+// ============================================================================
+// Implementation
+// ============================================================================
+
+export class ErrorSuggester implements IErrorSuggester {
+  getSuggestions(errorMessage: string, t: TFunction): string[] {
+    const suggestions: string[] = [];
+    const lowerError = errorMessage.toLowerCase();
+
+    if (lowerError.includes("not found") || lowerError.includes("enoent")) {
+      suggestions.push(t("app.api.system.builder.suggestions.checkFilePaths"));
+      suggestions.push(
+        t("app.api.system.builder.suggestions.runFromProjectRoot"),
+      );
+    }
+
+    if (lowerError.includes("permission") || lowerError.includes("eacces")) {
+      suggestions.push(
+        t("app.api.system.builder.suggestions.checkPermissions"),
+      );
+    }
+
+    if (lowerError.includes("module") || lowerError.includes("import")) {
+      suggestions.push(
+        t("app.api.system.builder.suggestions.checkDependencies"),
+      );
+      suggestions.push(t("app.api.system.builder.suggestions.runInstall"));
+    }
+
+    if (lowerError.includes("memory") || lowerError.includes("heap")) {
+      suggestions.push(t("app.api.system.builder.suggestions.increaseMemory"));
+      suggestions.push(t("app.api.system.builder.suggestions.useExternals"));
+    }
+
+    if (lowerError.includes("syntax") || lowerError.includes("parse")) {
+      suggestions.push(t("app.api.system.builder.suggestions.checkSyntax"));
+      suggestions.push(t("app.api.system.builder.suggestions.runTypecheck"));
+    }
+
+    if (lowerError.includes("timeout")) {
+      suggestions.push(t("app.api.system.builder.suggestions.increaseTimeout"));
+      suggestions.push(
+        t("app.api.system.builder.suggestions.checkNetworkConnection"),
+      );
+    }
+
+    if (lowerError.includes("disk") || lowerError.includes("enospc")) {
+      suggestions.push(t("app.api.system.builder.suggestions.checkDiskSpace"));
+      suggestions.push(t("app.api.system.builder.suggestions.cleanBuildCache"));
+    }
+
+    return suggestions;
+  }
+}
+
+// Singleton instance
+export const errorSuggester = new ErrorSuggester();

package/src/app/api/[locale]/system/builder/repository/file-copier.ts

@@ -0,0 +1,98 @@
+/**
+ * File Copier Service
+ * Copies files and folders during build
+ */
+
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+
+import type { EndpointLogger } from "@/app/api/[locale]/system/unified-interface/shared/logger/endpoint";
+import type { TFunction } from "@/i18n/core/static-types";
+
+import type { CopyConfig } from "../definition";
+import { ROOT_DIR } from "./constants";
+import { outputFormatter } from "./output-formatter";
+
+// ============================================================================
+// Interface
+// ============================================================================
+
+export interface IFileCopier {
+  /**
+   * Copy files and folders to destinations
+   */
+  copy(
+    filesToCopy: CopyConfig[],
+    output: string[],
+    filesCopied: string[],
+    logger: EndpointLogger,
+    t: TFunction,
+    dryRun?: boolean,
+  ): Promise<void>;
+
+  /**
+   * Check if source path exists
+   */
+  sourceExists(input: string): boolean;
+}
+
+// ============================================================================
+// Implementation
+// ============================================================================
+
+export class FileCopier implements IFileCopier {
+  async copy(
+    filesToCopy: CopyConfig[],
+    output: string[],
+    filesCopied: string[],
+    logger: EndpointLogger,
+    t: TFunction,
+    dryRun?: boolean,
+  ): Promise<void> {
+    output.push(
+      outputFormatter.formatSection(
+        t("app.api.system.builder.messages.copyingAdditionalFiles"),
+      ),
+    );
+    logger.info("Copying files", { count: filesToCopy.length });
+
+    for (const fileData of filesToCopy) {
+      const srcPath = resolve(ROOT_DIR, fileData.input);
+      const destPath = resolve(ROOT_DIR, fileData.output);
+      const destDir = dirname(destPath);
+
+      if (!existsSync(srcPath)) {
+        output.push(
+          outputFormatter.formatWarning(
+            `${fileData.input} → skipped (not found)`,
+          ),
+        );
+        logger.warn("Source file not found, skipping", { src: srcPath });
+        continue;
+      }
+
+      output.push(
+        outputFormatter.formatItem(fileData.input, `→ ${fileData.output}`),
+      );
+
+      if (!dryRun) {
+        if (!existsSync(destDir)) {
+          mkdirSync(destDir, { recursive: true });
+        }
+        const fsExtraPkg = "fs-extra";
+        const { copy } = await import(/* webpackIgnore: true */ fsExtraPkg);
+        await copy(srcPath, destPath);
+      }
+
+      filesCopied.push(fileData.output);
+    }
+  }
+
+  sourceExists(input: string): boolean {
+    const srcPath = resolve(ROOT_DIR, input);
+    return existsSync(srcPath);
+  }
+}
+
+// Singleton instance
+export const fileCopier = new FileCopier();

package/src/app/api/[locale]/system/builder/repository/folder-cleaner.ts

@@ -0,0 +1,80 @@
+/**
+ * Folder Cleaner Service
+ * Cleans output folders before building
+ */
+
+import { existsSync, rmSync } from "node:fs";
+import { resolve } from "node:path";
+
+import type { EndpointLogger } from "@/app/api/[locale]/system/unified-interface/shared/logger/endpoint";
+import type { TFunction } from "@/i18n/core/static-types";
+
+import { ROOT_DIR } from "./constants";
+import { outputFormatter } from "./output-formatter";
+
+// ============================================================================
+// Interface
+// ============================================================================
+
+export interface IFolderCleaner {
+  /**
+   * Clean (delete) specified folders
+   */
+  clean(
+    folders: string[],
+    output: string[],
+    logger: EndpointLogger,
+    t: TFunction,
+    dryRun?: boolean,
+  ): Promise<void>;
+
+  /**
+   * Check if a folder exists
+   */
+  exists(folder: string): boolean;
+}
+
+// ============================================================================
+// Implementation
+// ============================================================================
+
+export class FolderCleaner implements IFolderCleaner {
+  async clean(
+    folders: string[],
+    output: string[],
+    logger: EndpointLogger,
+    t: TFunction,
+    dryRun?: boolean,
+  ): Promise<void> {
+    output.push(
+      outputFormatter.formatSection(
+        t("app.api.system.builder.messages.cleaningFolders"),
+      ),
+    );
+
+    for (const folder of folders) {
+      const folderPath = resolve(ROOT_DIR, folder);
+      const exists = existsSync(folderPath);
+
+      output.push(
+        outputFormatter.formatItem(
+          folder,
+          exists ? "✓ will be deleted" : "⊘ not found, skipping",
+        ),
+      );
+      logger.info("Cleaning folder", { folder: folderPath, exists, dryRun });
+
+      if (!dryRun && exists) {
+        rmSync(folderPath, { force: true, recursive: true });
+      }
+    }
+  }
+
+  exists(folder: string): boolean {
+    const folderPath = resolve(ROOT_DIR, folder);
+    return existsSync(folderPath);
+  }
+}
+
+// Singleton instance
+export const folderCleaner = new FolderCleaner();

package/src/app/api/[locale]/system/builder/repository/index.ts

@@ -0,0 +1,2 @@
+export type { BuildConfig } from "../definition";
+export { buildExecutor as builderRepository } from "./build-executor";

package/src/app/api/[locale]/system/builder/repository/npm-package-generator.ts

@@ -0,0 +1,146 @@
+/**
+ * NPM Package Generator Service
+ * Generates package.json for npm distribution
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+
+import type { EndpointLogger } from "@/app/api/[locale]/system/unified-interface/shared/logger/endpoint";
+import type { TFunction } from "@/i18n/core/static-types";
+
+import type { NpmPackageConfig, PackageExportCondition } from "../definition";
+import { ROOT_DIR } from "./constants";
+import { outputFormatter } from "./output-formatter";
+
+// ============================================================================
+// Generated Package.json Type
+// ============================================================================
+
+/** Generated package.json structure - type-safe */
+interface GeneratedPackageJson {
+  name: string;
+  version: string;
+  description: string;
+  type: "module" | "commonjs";
+  license?: string;
+  keywords?: string[];
+  repository?: string | { type: string; url: string };
+  bin?: Record<string, string>;
+  main?: string;
+  module?: string;
+  types?: string;
+  exports?: Record<string, PackageExportCondition>;
+  files?: string[];
+  dependencies?: Record<string, string>;
+  peerDependencies?: Record<string, string>;
+}
+
+// ============================================================================
+// Interface
+// ============================================================================
+
+export interface INpmPackageGenerator {
+  /**
+   * Generate package.json for npm distribution
+   */
+  generate(
+    config: NpmPackageConfig,
+    output: string[],
+    filesCopied: string[],
+    logger: EndpointLogger,
+    t: TFunction,
+    dryRun?: boolean,
+  ): Promise<string>;
+
+  /**
+   * Get version from main package.json
+   */
+  getMainPackageVersion(): Promise<string>;
+}
+
+// ============================================================================
+// Implementation
+// ============================================================================
+
+export class NpmPackageGenerator implements INpmPackageGenerator {
+  async generate(
+    config: NpmPackageConfig,
+    output: string[],
+    filesCopied: string[],
+    logger: EndpointLogger,
+    t: TFunction,
+    dryRun?: boolean,
+  ): Promise<string> {
+    output.push(
+      outputFormatter.formatSection(
+        t("app.api.system.builder.messages.creatingPackageJson"),
+      ),
+    );
+    logger.info("Generating npm package.json", { name: config.name });
+
+    // Read version from main package.json if not provided
+    let version = config.version;
+    if (!version) {
+      version = await this.getMainPackageVersion();
+    }
+
+    const packageJson: GeneratedPackageJson = {
+      name: config.name,
+      version,
+      description: config.description ?? "",
+      type: "module",
+      ...(config.license && { license: config.license }),
+      ...(config.keywords &&
+        config.keywords.length > 0 && { keywords: config.keywords }),
+      ...(config.repository && { repository: config.repository }),
+      ...(config.bin && { bin: config.bin }),
+      ...(config.main && { main: config.main }),
+      ...(config.module && { module: config.module }),
+      ...(config.types && { types: config.types }),
+      ...(config.exports && { exports: config.exports }),
+      ...(config.files && config.files.length > 0 && { files: config.files }),
+      ...(config.dependencies &&
+        Object.keys(config.dependencies).length > 0 && {
+          dependencies: config.dependencies,
+        }),
+      ...(config.peerDependencies &&
+        Object.keys(config.peerDependencies).length > 0 && {
+          peerDependencies: config.peerDependencies,
+        }),
+    };
+
+    const packageJsonContent = JSON.stringify(packageJson, null, 2);
+    const outputPath = "dist/package.json";
+    const fullOutputPath = resolve(ROOT_DIR, outputPath);
+
+    output.push(outputFormatter.formatItem("package.json", `→ ${outputPath}`));
+
+    if (!dryRun) {
+      const outputDir = dirname(fullOutputPath);
+      if (!existsSync(outputDir)) {
+        mkdirSync(outputDir, { recursive: true });
+      }
+      writeFileSync(fullOutputPath, packageJsonContent, "utf-8");
+    }
+
+    filesCopied.push(outputPath);
+    logger.info("Package.json generated", { path: outputPath });
+
+    return packageJsonContent;
+  }
+
+  async getMainPackageVersion(): Promise<string> {
+    try {
+      const packageJsonPath = resolve(ROOT_DIR, "package.json");
+      const content = readFileSync(packageJsonPath, "utf-8");
+      const mainPackageJson = JSON.parse(content) as { version?: string };
+      return mainPackageJson.version || "0.0.0";
+    } catch {
+      return "0.0.0";
+    }
+  }
+}
+
+// Singleton instance
+export const npmPackageGenerator = new NpmPackageGenerator();

package/src/app/api/[locale]/system/builder/repository/output-formatter.ts

@@ -0,0 +1,104 @@
+/**
+ * Output Formatter Service
+ * Formats console output for build operations
+ */
+
+import { SIZE_THRESHOLDS } from "./constants";
+
+// ============================================================================
+// Interface
+// ============================================================================
+
+export interface IOutputFormatter {
+  /** Format a header with decorative lines */
+  formatHeader(text: string): string;
+
+  /** Format a section title */
+  formatSection(text: string): string;
+
+  /** Format a step description */
+  formatStep(text: string): string;
+
+  /** Format an item with name and detail */
+  formatItem(name: string, detail: string): string;
+
+  /** Format a success message */
+  formatSuccess(text: string): string;
+
+  /** Format a warning message */
+  formatWarning(text: string): string;
+
+  /** Format an error message */
+  formatError(text: string): string;
+
+  /** Format verbose/debug output */
+  formatVerbose(text: string): string;
+
+  /** Format bytes to human readable string */
+  formatBytes(bytes: number): string;
+
+  /** Get size indicator based on thresholds */
+  getSizeIndicator(size: number): string;
+}
+
+// ============================================================================
+// Implementation
+// ============================================================================
+
+export class OutputFormatter implements IOutputFormatter {
+  formatHeader(text: string): string {
+    const line = "═".repeat(60);
+    return `\n${line}\n  ${text}\n${line}`;
+  }
+
+  formatSection(text: string): string {
+    return `\n▸ ${text}`;
+  }
+
+  formatStep(text: string): string {
+    return `  ${text}`;
+  }
+
+  formatItem(name: string, detail: string): string {
+    return `    ${name} ${detail}`;
+  }
+
+  formatSuccess(text: string): string {
+    return `\n  ${text}`;
+  }
+
+  formatWarning(text: string): string {
+    return `  ⚠ ${text}`;
+  }
+
+  formatError(text: string): string {
+    return `\n  ✖ ${text}`;
+  }
+
+  formatVerbose(text: string): string {
+    return `    ┊ ${text}`;
+  }
+
+  formatBytes(bytes: number): string {
+    if (bytes === 0) {
+      return "0 B";
+    }
+    const k = 1024;
+    const sizes = ["B", "KB", "MB", "GB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;
+  }
+
+  getSizeIndicator(size: number): string {
+    if (size > SIZE_THRESHOLDS.CRITICAL) {
+      return "⚠️";
+    }
+    if (size > SIZE_THRESHOLDS.WARNING) {
+      return "⚡";
+    }
+    return "✓";
+  }
+}
+
+// Singleton instance
+export const outputFormatter = new OutputFormatter();