@next-vibe/checker 1.0.11 → 1.0.13

package/src/app/api/[locale]/system/builder/repository/profile-service.ts

@@ -0,0 +1,79 @@
+/**
+ * Profile Service
+ * Manages build profiles and applies profile-specific settings
+ */
+
+import type { BuildConfig, BuildProfile } from "../definition";
+import { PROFILE_DEFAULTS } from "./constants";
+
+/** Profile settings type inferred from PROFILE_DEFAULTS */
+type ProfileSettings = (typeof PROFILE_DEFAULTS)[BuildProfile];
+
+// ============================================================================
+// Interface
+// ============================================================================
+
+export interface IProfileService {
+  /**
+   * Get default settings for a profile
+   */
+  getDefaults(profile: BuildProfile): ProfileSettings;
+
+  /**
+   * Apply profile-specific settings to build configuration
+   */
+  applySettings(
+    config: BuildConfig,
+    profile: BuildProfile,
+    overrides?: ProfileOverrides,
+  ): BuildConfig;
+
+  /**
+   * Get available profile names
+   */
+  getAvailableProfiles(): BuildProfile[];
+}
+
+/** Overrides that can be passed from request */
+export interface ProfileOverrides {
+  minify?: boolean;
+  foldersToClean?: string[];
+  env?: Record<string, string>;
+}
+
+// ============================================================================
+// Implementation
+// ============================================================================
+
+export class ProfileService implements IProfileService {
+  getDefaults(profile: BuildProfile): ProfileSettings {
+    return PROFILE_DEFAULTS[profile];
+  }
+
+  applySettings(
+    config: BuildConfig,
+    profile: BuildProfile,
+    overrides?: ProfileOverrides,
+  ): BuildConfig {
+    const profileOverrides = config.profiles?.[profile] || {};
+
+    // Merge profile overrides with base config
+    const mergedConfig: BuildConfig = {
+      ...config,
+      ...profileOverrides,
+      ...(overrides && {
+        foldersToClean: overrides.foldersToClean ?? config.foldersToClean,
+        env: { ...config.env, ...overrides.env },
+      }),
+    };
+
+    return mergedConfig;
+  }
+
+  getAvailableProfiles(): BuildProfile[] {
+    return ["development", "production"];
+  }
+}
+
+// Singleton instance
+export const profileService = new ProfileService();

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

@@ -0,0 +1,125 @@
+/**
+ * Report Generator Service
+ * Generates build reports
+ */
+
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+
+import type { TFunction } from "@/i18n/core/static-types";
+
+import type { BuildProfile, BuildReport, BuildStepResult } from "../definition";
+import { ROOT_DIR } from "./constants";
+import { outputFormatter } from "./output-formatter";
+
+// ============================================================================
+// Interface
+// ============================================================================
+
+export interface IReportGenerator {
+  /**
+   * Generate a JSON build report
+   */
+  generate(
+    report: BuildReport,
+    output: string[],
+    t: TFunction,
+  ): Promise<string>;
+
+  /**
+   * Append build summary to output
+   */
+  appendBuildSummary(
+    output: string[],
+    stepResults: BuildStepResult[],
+    totalDuration: number,
+    filesBuilt: string[],
+    filesCopied: string[],
+    t: TFunction,
+    profile: BuildProfile,
+  ): void;
+}
+
+// ============================================================================
+// Implementation
+// ============================================================================
+
+export class ReportGenerator implements IReportGenerator {
+  async generate(
+    report: BuildReport,
+    output: string[],
+    t: TFunction,
+  ): Promise<string> {
+    output.push(
+      outputFormatter.formatStep(
+        t("app.api.system.builder.messages.generatingReport"),
+      ),
+    );
+
+    const reportPath = resolve(ROOT_DIR, "dist", "build-report.json");
+    const reportDir = dirname(reportPath);
+
+    if (!existsSync(reportDir)) {
+      mkdirSync(reportDir, { recursive: true });
+    }
+
+    writeFileSync(reportPath, JSON.stringify(report, null, 2), "utf-8");
+
+    const relativePath = "dist/build-report.json";
+    output.push(
+      outputFormatter.formatSuccess(
+        t("app.api.system.builder.messages.reportGenerated", {
+          path: relativePath,
+        }),
+      ),
+    );
+
+    return relativePath;
+  }
+
+  appendBuildSummary(
+    output: string[],
+    stepResults: BuildStepResult[],
+    totalDuration: number,
+    filesBuilt: string[],
+    filesCopied: string[],
+    t: TFunction,
+    profile: BuildProfile,
+  ): void {
+    output.push(`\n${"─".repeat(60)}`);
+    output.push(
+      `📊 ${t("app.api.system.builder.messages.buildSummary")} [${profile.toUpperCase()}]`,
+    );
+    output.push(
+      `  ⏱  ${t("app.api.system.builder.messages.totalDuration")}: ${totalDuration}ms`,
+    );
+    output.push(
+      `  📦 ${t("app.api.system.builder.messages.filesBuilt")}: ${filesBuilt.length}`,
+    );
+    output.push(
+      `  📋 ${t("app.api.system.builder.messages.filesCopiedCount")}: ${filesCopied.length}`,
+    );
+
+    // Per-step breakdown
+    if (stepResults.length > 0) {
+      output.push(`  ${t("app.api.system.builder.messages.stepsCompleted")}:`);
+      for (const step of stepResults) {
+        let stepInfo = `    ${step.success ? "✓" : "✖"} ${step.step}: ${step.duration}ms`;
+        if (step.size !== undefined && step.size > 0) {
+          stepInfo += ` (${outputFormatter.formatBytes(step.size)})`;
+        }
+        output.push(stepInfo);
+
+        // Show step warnings
+        if (step.warnings?.length) {
+          for (const warning of step.warnings) {
+            output.push(`      ⚠ ${warning}`);
+          }
+        }
+      }
+    }
+  }
+}
+
+// Singleton instance
+export const reportGenerator = new ReportGenerator();

package/src/app/api/[locale]/system/builder/repository/vite-compiler.ts

@@ -0,0 +1,291 @@
+/**
+ * Vite Compiler Service
+ * Compiles files using Vite
+ */
+
+import { existsSync, mkdirSync, statSync } from "node:fs";
+import { basename, dirname, resolve } 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 { OutputOptions, RollupOptions } from "rollup";
+import type { BuildOptions, InlineConfig, PluginOption } from "vite";
+import { build as viteBuild } from "vite";
+
+import type { EndpointLogger } from "@/app/api/[locale]/system/unified-interface/shared/logger/endpoint";
+
+import type { BuildProfile, FileToCompile } from "../definition";
+import { PROFILE_DEFAULTS, ROOT_DIR } from "./constants";
+import { outputFormatter } from "./output-formatter";
+
+// ============================================================================
+// Interface
+// ============================================================================
+
+export interface IViteCompiler {
+  /**
+   * Compile a single file with Vite
+   */
+  compileFile(
+    fileConfig: FileToCompile,
+    output: string[],
+    filesBuilt: string[],
+    logger: EndpointLogger,
+    dryRun?: boolean,
+    verbose?: boolean,
+    profile?: BuildProfile,
+  ): Promise<ResponseType<string[]>>;
+
+  /**
+   * Build Vite configuration for a file
+   */
+  buildViteConfig(
+    fileConfig: FileToCompile,
+    inputFilePath: string,
+    outputDir: string,
+    verbose?: boolean,
+    profile?: BuildProfile,
+  ): Promise<InlineConfig>;
+}
+
+// ============================================================================
+// Implementation
+// ============================================================================
+
+export class ViteCompiler implements IViteCompiler {
+  async compileFile(
+    fileConfig: FileToCompile,
+    output: string[],
+    filesBuilt: string[],
+    logger: EndpointLogger,
+    dryRun?: boolean,
+    verbose?: boolean,
+    profile: BuildProfile = "development",
+  ): Promise<ResponseType<string[]>> {
+    const inputFilePath = resolve(ROOT_DIR, fileConfig.input);
+    const outputDir = resolve(ROOT_DIR, dirname(fileConfig.output));
+    const compiledFiles: string[] = [];
+
+    if (!existsSync(inputFilePath)) {
+      return fail({
+        message: "app.api.system.builder.errors.inputFileNotFound",
+        messageParams: {
+          filePath: fileConfig.input,
+        },
+        errorType: ErrorResponseTypes.NOT_FOUND,
+      });
+    }
+
+    output.push(
+      outputFormatter.formatItem(
+        fileConfig.input,
+        `→ ${dirname(fileConfig.output)}/ (${fileConfig.type})`,
+      ),
+    );
+    logger.info("Compiling file", {
+      input: fileConfig.input,
+      type: fileConfig.type,
+    });
+
+    if (dryRun) {
+      // Simulate output files for dry run
+      if (fileConfig.packageConfig?.isPackage) {
+        const outputFileName =
+          basename(fileConfig.output).split(".")[0] || "index";
+        compiledFiles.push(
+          `${dirname(fileConfig.output)}/${outputFileName}.mjs`,
+          `${dirname(fileConfig.output)}/${outputFileName}.cjs`,
+        );
+      } else {
+        compiledFiles.push(fileConfig.output);
+      }
+      filesBuilt.push(...compiledFiles);
+      return success(compiledFiles);
+    }
+
+    // Ensure output directory exists
+    if (!existsSync(outputDir)) {
+      mkdirSync(outputDir, { recursive: true });
+    }
+
+    // Build Vite configuration
+    const viteConfig = await this.buildViteConfig(
+      fileConfig,
+      inputFilePath,
+      outputDir,
+      verbose,
+      profile,
+    );
+
+    // Run Vite build
+    await viteBuild(viteConfig);
+
+    // Track built files
+    if (fileConfig.packageConfig?.isPackage) {
+      const outputFileName =
+        basename(fileConfig.output).split(".")[0] || "index";
+      compiledFiles.push(
+        `${dirname(fileConfig.output)}/${outputFileName}.mjs`,
+        `${dirname(fileConfig.output)}/${outputFileName}.cjs`,
+      );
+    } else {
+      compiledFiles.push(fileConfig.output);
+    }
+
+    filesBuilt.push(...compiledFiles);
+
+    if (verbose) {
+      output.push(
+        outputFormatter.formatVerbose(`Compiled: ${compiledFiles.join(", ")}`),
+      );
+    }
+
+    logger.info("File compiled", {
+      input: fileConfig.input,
+      output: compiledFiles,
+    });
+    return success(compiledFiles);
+  }
+
+  async buildViteConfig(
+    fileConfig: FileToCompile,
+    inputFilePath: string,
+    outputDir: string,
+    verbose?: boolean,
+    profile: BuildProfile = "development",
+  ): Promise<InlineConfig> {
+    const profileSettings = PROFILE_DEFAULTS[profile];
+    const viteOpts = fileConfig.viteOptions || {};
+
+    // Extract plugins (typed as unknown[] in schema for API compatibility)
+    const pluginsOverride = viteOpts.plugins as PluginOption[] | undefined;
+
+    // Extract build options with proper typing
+    const buildOpts = (viteOpts.build || {}) as BuildOptions & {
+      rollupOptions?: RollupOptions & { output?: OutputOptions };
+    };
+    const { rollupOptions: rollupOpts = {}, ...buildOptionsOverride } =
+      buildOpts;
+    const { output: outputOverride, ...rollupOptionsOverride } = rollupOpts;
+
+    // Collect other vite options (excluding plugins and build which we handled separately)
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars -- Destructuring to exclude handled fields
+    const { plugins: _, build: __, ...otherOptions } = viteOpts;
+
+    const plugins: PluginOption[] = pluginsOverride || [];
+    const buildOptions: BuildOptions = {
+      target: "es2020",
+      outDir: outputDir,
+      minify: profileSettings.minify,
+      emptyOutDir: false,
+      cssCodeSplit: !fileConfig.inlineCss,
+      cssMinify: profileSettings.minify,
+      sourcemap: profileSettings.sourcemap !== false,
+      ...buildOptionsOverride,
+    };
+
+    const rollupOptions: RollupOptions = {};
+    const outputOptions: OutputOptions = {};
+
+    // Configure plugins based on build type
+    // Use string variables to prevent Turbopack static analysis of CLI-only packages
+    if (fileConfig.type === "react-tailwind") {
+      const tailwindPkg = "@tailwindcss/vite";
+      const tailwindcss = (await import(/* webpackIgnore: true */ tailwindPkg))
+        .default;
+      plugins.push(tailwindcss() as PluginOption);
+
+      if (fileConfig.inlineCss !== false) {
+        const cssPkg = "vite-plugin-css-injected-by-js";
+        const cssInjectedByJsPlugin = (
+          await import(/* webpackIgnore: true */ cssPkg)
+        ).default;
+        plugins.push(cssInjectedByJsPlugin() as PluginOption);
+      }
+    }
+
+    if (fileConfig.type.includes("react")) {
+      outputOptions.globals = { react: "React", "react-dom": "ReactDOM" };
+      const react = (await import("@vitejs/plugin-react")).default;
+      plugins.push(react());
+    }
+
+    // Package mode with TypeScript declarations
+    const packageConfig = fileConfig.packageConfig;
+    if (packageConfig?.isPackage) {
+      const dtsPkg = "vite-plugin-dts";
+      const dts = (await import(/* webpackIgnore: true */ dtsPkg)).default;
+      plugins.push(
+        dts({
+          include: packageConfig.dtsInclude,
+          entryRoot: packageConfig.dtsEntryRoot,
+        }) as PluginOption,
+      );
+
+      const outputFileName =
+        basename(fileConfig.output).split(".")[0] || "index";
+
+      buildOptions.lib = {
+        entry: inputFilePath,
+        formats: ["es", "cjs"],
+        fileName: (format): string =>
+          `${outputFileName}.${format === "es" ? "mjs" : "cjs"}`,
+      };
+      outputOptions.exports = "auto";
+
+      // Build externals list
+      const modulesToExternalize = [
+        ...new Set([
+          ...(fileConfig.modulesToExternalize || []),
+          ...(fileConfig.type.includes("react") && !fileConfig.bundleReact
+            ? ["react", "react-dom", "react/jsx-runtime"]
+            : []),
+        ]),
+      ];
+
+      rollupOptions.external = (id): boolean =>
+        modulesToExternalize.includes(id) || id.startsWith("node:");
+    } else {
+      // IIFE build for browser
+      outputOptions.entryFileNames = basename(fileConfig.output);
+      outputOptions.assetFileNames = "[name][extname]";
+      outputOptions.exports = "none";
+      outputOptions.format = "iife";
+      rollupOptions.input = inputFilePath;
+    }
+
+    return {
+      root: "./",
+      base: "./",
+      plugins: [...new Set(plugins)],
+      logLevel: verbose ? "info" : "warn",
+      ...otherOptions,
+      build: {
+        ...buildOptions,
+        rollupOptions: {
+          ...rollupOptions,
+          ...rollupOptionsOverride,
+          output: { ...outputOptions, ...outputOverride },
+        },
+      },
+    };
+  }
+
+  /**
+   * Get compiled file size
+   */
+  getFileSize(filePath: string): number {
+    const fullPath = resolve(ROOT_DIR, filePath);
+    if (existsSync(fullPath)) {
+      return statSync(fullPath).size;
+    }
+    return 0;
+  }
+}
+
+// Singleton instance
+export const viteCompiler = new ViteCompiler();

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

@@ -0,0 +1,21 @@
+/**
+ * Builder Route
+ * API route for building and bundling packages for npm distribution
+ */
+
+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 builderEndpoints from "./definition";
+import { builderRepository } from "./repository";
+
+export const { POST, tools } = endpointsHandler({
+  endpoint: builderEndpoints,
+  [Methods.POST]: {
+    handler: ({ data, locale, logger }) => {
+      return builderRepository.execute(data, locale, logger);
+    },
+  },
+});

package/src/app/api/[locale]/system/builder/test-files/file1.ts

@@ -0,0 +1,2 @@
+// eslint-disable-next-line no-console, i18next/no-literal-string
+console.log("Hello from input1.ts");

package/src/app/api/[locale]/system/builder/test-files/file2.tsx

@@ -0,0 +1,10 @@
+import React, { type JSX } from "react";
+import { createRoot } from "react-dom/client";
+
+// eslint-disable-next-line i18next/no-literal-string
+const App = (): JSX.Element => <div>Hello from input2.ts</div>;
+
+const container = document.querySelector("#root");
+const root = createRoot(container!);
+
+root.render(<App />);

package/src/app/api/[locale]/system/builder/test-files/file3.tsx

@@ -0,0 +1,16 @@
+import "./test3.css";
+
+import type { JSX } from "react";
+import React from "react";
+import { createRoot } from "react-dom/client";
+import { Div } from "next-vibe-ui/ui/div";
+
+const App = (): JSX.Element => (
+  // eslint-disable-next-line i18next/no-literal-string
+  <Div className="p-5 m-5 w-100">Hello from input3.ts</Div>
+);
+
+const container = document.querySelector("#root");
+const root = createRoot(container!);
+
+root.render(<App />);

package/src/app/api/[locale]/system/builder/test-files/folderToCopy/fileInFolder.ts

@@ -0,0 +1,2 @@
+// eslint-disable-next-line no-console, i18next/no-literal-string
+console.log("Hello from fileInFolder.ts");

package/src/app/api/[locale]/system/builder/test-files/test-config.ts

@@ -0,0 +1,38 @@
+import type { BuildConfig } from "../repository/types";
+
+export const testDir = "./test-files";
+export const distDir = `${testDir}/dist`;
+export const copyDir = `${testDir}/dist/copy`;
+
+const buildConfig: BuildConfig = {
+  foldersToClean: [distDir],
+  filesToCompile: [
+    {
+      input: `${testDir}/file1.ts`,
+      output: `${distDir}/output1.js`,
+      type: "vanilla",
+    },
+    {
+      input: `${testDir}/file2.tsx`,
+      output: `${distDir}/output2.js`,
+      type: "react",
+    },
+    {
+      input: `${testDir}/file3.tsx`,
+      output: `${distDir}/output3.js`,
+      type: "react-tailwind",
+    },
+  ],
+  filesOrFoldersToCopy: [
+    {
+      input: `${testDir}/file1.ts`,
+      output: `${copyDir}/file1.ts`,
+    },
+    {
+      input: `${testDir}/folderToCopy`,
+      output: `${copyDir}/folderToCopy`,
+    },
+  ],
+};
+
+export default buildConfig;

package/src/app/api/[locale]/system/builder/test-files/test-delete-config.ts

@@ -0,0 +1,8 @@
+import type { BuildConfig } from "../repository/types";
+import { distDir } from "./test-config";
+
+const buildConfig: BuildConfig = {
+  foldersToClean: [distDir],
+};
+
+export default buildConfig;

package/src/app/api/[locale]/system/builder/test-files/test-project/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "builder-test-project",
+  "version": "1.0.0",
+  "description": "Test project for builder system",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "vite": "^5.0.0"
+  }
+}

package/src/app/api/[locale]/system/builder/test-files/test-project/src/constants.ts

@@ -0,0 +1,6 @@
+/**
+ * Project constants
+ */
+
+export const VERSION = "1.0.0";
+export const PROJECT_NAME = "builder-test-project";

package/src/app/api/[locale]/system/builder/test-files/test-project/src/greet.ts

@@ -0,0 +1,18 @@
+/**
+ * Greeting module
+ */
+
+export interface GreetOptions {
+  name: string;
+  formal?: boolean;
+}
+
+export function greet(options: GreetOptions): string {
+  const { name, formal = false } = options;
+
+  if (formal) {
+    return `Good day, ${name}. How may I assist you?`;
+  }
+
+  return `Hello, ${name}!`;
+}

package/src/app/api/[locale]/system/builder/test-files/test-project/src/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Test Project Entry Point
+ */
+
+export { greet, type GreetOptions } from "./greet";
+export { calculate, type CalculateOptions } from "./utils/calculate";
+export { VERSION } from "./constants";

package/src/app/api/[locale]/system/builder/test-files/test-project/src/utils/calculate.ts

@@ -0,0 +1,27 @@
+/**
+ * Calculation utilities
+ */
+
+export interface CalculateOptions {
+  a: number;
+  b: number;
+  operation: "add" | "subtract" | "multiply" | "divide";
+}
+
+export function calculate(options: CalculateOptions): number {
+  const { a, b, operation } = options;
+
+  switch (operation) {
+    case "add":
+      return a + b;
+    case "subtract":
+      return a - b;
+    case "multiply":
+      return a * b;
+    case "divide":
+      if (b === 0) {
+        throw new Error("Cannot divide by zero");
+      }
+      return a / b;
+  }
+}