@next-vibe/checker 1.0.11 → 1.0.13

package/src/app/api/[locale]/system/unified-interface/cli/setup/uninstall/repository.ts

@@ -0,0 +1,209 @@
+/**
+ * Setup Uninstall Repository
+ * Business logic for CLI global uninstallation
+ * Following migration guide: Repository-only logic pattern
+ */
+
+import "server-only";
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import path 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 { parseError } from "next-vibe/shared/utils";
+
+import type { CountryLanguage } from "@/i18n/core/config";
+import { simpleT } from "@/i18n/core/shared";
+
+import type { JwtPayloadType } from "../../../../../user/auth/types";
+import type {
+  UninstallRequestOutput,
+  UninstallResponseOutput,
+} from "./definition";
+
+/**
+ * Setup Uninstall Repository Interface
+ */
+export interface SetupUninstallRepository {
+  uninstallCli(
+    data: UninstallRequestOutput,
+    user: JwtPayloadType,
+    locale: CountryLanguage,
+  ): Promise<ResponseType<UninstallResponseOutput>>;
+}
+
+/**
+ * Setup Uninstall Repository Implementation
+ */
+class SetupUninstallRepositoryImpl implements SetupUninstallRepository {
+  async uninstallCli(
+    data: UninstallRequestOutput,
+    user: JwtPayloadType,
+    locale: CountryLanguage,
+  ): Promise<ResponseType<UninstallResponseOutput>> {
+    const { t } = simpleT(locale);
+
+    // Validate user permissions for CLI uninstallation
+    if (!user?.id) {
+      return fail({
+        message:
+          "app.api.system.unifiedInterface.cli.setup.uninstall.post.errors.unauthorized.title",
+        errorType: ErrorResponseTypes.UNAUTHORIZED,
+        messageParams: {
+          error: t(
+            "app.api.system.unifiedInterface.cli.setup.uninstall.post.errors.unauthorized.description",
+          ),
+        },
+      });
+    }
+
+    try {
+      // Check current status
+      const status = await this.checkInstallationStatus();
+
+      if (!status.installed) {
+        return success({
+          success: true,
+          installed: false,
+          message: t(
+            "app.api.system.unifiedInterface.cli.setup.uninstall.post.description",
+          ),
+        });
+      }
+
+      // Uninstall using npm unlink
+      // eslint-disable-next-line i18next/no-literal-string
+      const output = await this.runCommand("npm", ["unlink", "-g"], {
+        cwd: process.cwd(),
+        verbose: data.verbose,
+      });
+
+      // Verify uninstallation
+      const newStatus = await this.checkInstallationStatus();
+
+      return success({
+        success: !newStatus.installed,
+        installed: newStatus.installed,
+        message: newStatus.installed
+          ? t(
+              "app.api.system.unifiedInterface.cli.setup.uninstall.post.errors.server.description",
+            )
+          : t(
+              "app.api.system.unifiedInterface.cli.setup.uninstall.post.success.description",
+            ),
+        output: data.verbose ? output : undefined,
+      });
+    } catch (error) {
+      const parsedError = parseError(error);
+      return fail({
+        message:
+          "app.api.system.unifiedInterface.cli.setup.uninstall.post.errors.server.title",
+        errorType: ErrorResponseTypes.INTERNAL_ERROR,
+        messageParams: {
+          error: parsedError.message,
+        },
+      });
+    }
+  }
+
+  private async checkInstallationStatus(): Promise<{
+    installed: boolean;
+    version?: string;
+    path?: string;
+  }> {
+    try {
+      // Try to run 'which vibe' or 'where vibe' to find the installation
+      const command = process.platform === "win32" ? "where" : "which";
+      const output = await this.runCommand(command, ["vibe"], {
+        verbose: false,
+        ignoreErrors: true,
+      });
+
+      if (output) {
+        // Get version
+        let version: string | undefined;
+        try {
+          const packageJsonPath = path.join(process.cwd(), "package.json");
+          if (existsSync(packageJsonPath)) {
+            const packageJson = JSON.parse(
+              await readFile(packageJsonPath, "utf8"),
+            ) as { version?: string };
+            version = packageJson.version;
+          }
+        } catch {
+          // Ignore version detection errors
+        }
+
+        return {
+          installed: true,
+          version,
+          path: output.trim(),
+        };
+      }
+
+      return { installed: false };
+    } catch {
+      return { installed: false };
+    }
+  }
+
+  private async runCommand(
+    command: string,
+    args: string[],
+    options: {
+      cwd?: string;
+      verbose?: boolean;
+      ignoreErrors?: boolean;
+    } = {},
+  ): Promise<string> {
+    return await new Promise((resolve, reject) => {
+      const childProcess = spawn(command, args, {
+        cwd: options.cwd || process.cwd(),
+        stdio: options.verbose ? "inherit" : "pipe",
+        shell: false,
+        env: { NODE_ENV: "development" },
+      });
+
+      let output = "";
+      let errorOutput = "";
+
+      if (!options.verbose) {
+        childProcess.stdout?.on("data", (data: Buffer) => {
+          output += data.toString();
+        });
+
+        childProcess.stderr?.on("data", (data: Buffer) => {
+          errorOutput += data.toString();
+        });
+      }
+
+      childProcess.on("close", (code: number | null) => {
+        if (code === 0 || options.ignoreErrors) {
+          resolve(output);
+        } else {
+          reject(new Error(errorOutput || output || String(code)));
+        }
+      });
+
+      childProcess.on("error", (error: Error) => {
+        if (!options.ignoreErrors) {
+          reject(error);
+        } else {
+          resolve(String());
+        }
+      });
+    });
+  }
+}
+
+/**
+ * Default repository instance
+ */
+export const setupUninstallRepository = new SetupUninstallRepositoryImpl();

package/src/app/api/[locale]/system/unified-interface/cli/setup/uninstall/route.ts

@@ -0,0 +1,24 @@
+/**
+ * Setup Uninstall Route
+ * API route for CLI global uninstallation
+ */
+
+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 uninstallEndpoints from "./definition";
+import { setupUninstallRepository } from "./repository";
+
+export const { POST, tools } = endpointsHandler({
+  endpoint: uninstallEndpoints,
+  [Methods.POST]: {
+    handler: ({ data, user, logger, locale }) => {
+      logger.info("Setup uninstall operation started", {
+        verbose: data.verbose,
+      });
+      return setupUninstallRepository.uninstallCli(data, user, locale);
+    },
+  },
+});

package/src/app/api/[locale]/system/unified-interface/cli/setup/update/definition.ts

@@ -0,0 +1,200 @@
+/**
+ * Setup Update Definition
+ * API endpoint definition for CLI update (uninstall + reinstall)
+ * Following migration guide: Files at level of usage, split god repositories
+ */
+
+import { z } from "zod";
+
+import { createEndpoint } from "@/app/api/[locale]/system/unified-interface/shared/endpoints/definition/create";
+import {
+  objectField,
+  requestDataField,
+  responseField,
+} from "@/app/api/[locale]/system/unified-interface/shared/field/utils";
+import {
+  EndpointErrorTypes,
+  FieldDataType,
+  LayoutType,
+  Methods,
+  WidgetType,
+} from "@/app/api/[locale]/system/unified-interface/shared/types/enums";
+
+import { UserRole } from "../../../../../user/user-roles/enum";
+
+/**
+ * Setup Update Endpoint Definition
+ */
+const { POST } = createEndpoint({
+  title: "app.api.system.unifiedInterface.cli.setup.update.post.title",
+  description:
+    "app.api.system.unifiedInterface.cli.setup.update.post.description",
+  icon: "wrench",
+  category: "app.api.system.unifiedInterface.cli.setup.update.post.title",
+  tags: ["app.api.system.unifiedInterface.cli.setup.update.post.title"],
+  allowedRoles: [UserRole.ADMIN],
+  aliases: ["update", "setup:update"],
+  method: Methods.POST,
+  path: ["system", "setup", "update"],
+  examples: {
+    requests: {},
+    urlPathParams: undefined,
+    responses: {},
+  },
+
+  fields: objectField(
+    {
+      type: WidgetType.CONTAINER,
+      title: "app.api.system.unifiedInterface.cli.setup.update.post.title",
+      description:
+        "app.api.system.unifiedInterface.cli.setup.update.post.description",
+      layoutType: LayoutType.GRID,
+      columns: 12,
+    },
+    { request: "data", response: true },
+    {
+      // === REQUEST FIELDS ===
+      verbose: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.unifiedInterface.cli.setup.update.post.title",
+          description:
+            "app.api.system.unifiedInterface.cli.setup.update.post.description",
+          columns: 6,
+        },
+        z.boolean().default(false),
+      ),
+
+      // === RESPONSE FIELDS ===
+      success: responseField(
+        {
+          type: WidgetType.TEXT,
+          content:
+            "app.api.system.unifiedInterface.cli.setup.update.post.success.title",
+        },
+        z.boolean(),
+      ),
+
+      installed: responseField(
+        {
+          type: WidgetType.TEXT,
+          content:
+            "app.api.system.unifiedInterface.cli.setup.update.post.title",
+        },
+        z.boolean(),
+      ),
+
+      version: responseField(
+        {
+          type: WidgetType.TEXT,
+          content:
+            "app.api.system.unifiedInterface.cli.setup.update.post.description",
+        },
+        z.string().optional(),
+      ),
+
+      path: responseField(
+        {
+          type: WidgetType.TEXT,
+          content:
+            "app.api.system.unifiedInterface.cli.setup.update.post.title",
+        },
+        z.string().optional(),
+      ),
+
+      message: responseField(
+        {
+          type: WidgetType.TEXT,
+          content:
+            "app.api.system.unifiedInterface.cli.setup.update.post.success.description",
+        },
+        z.string(),
+      ),
+
+      output: responseField(
+        {
+          type: WidgetType.TEXT,
+          content:
+            "app.api.system.unifiedInterface.cli.setup.update.post.title",
+        },
+        z.string().optional(),
+      ),
+    },
+  ),
+
+  // === ERROR HANDLING ===
+  errorTypes: {
+    [EndpointErrorTypes.VALIDATION_FAILED]: {
+      title:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.validation.title",
+      description:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.validation.description",
+    },
+    [EndpointErrorTypes.UNAUTHORIZED]: {
+      title:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.unauthorized.title",
+      description:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.unauthorized.description",
+    },
+    [EndpointErrorTypes.SERVER_ERROR]: {
+      title:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.server.title",
+      description:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.server.description",
+    },
+    [EndpointErrorTypes.NETWORK_ERROR]: {
+      title:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.network.title",
+      description:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.network.description",
+    },
+    [EndpointErrorTypes.FORBIDDEN]: {
+      title:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.forbidden.title",
+      description:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.forbidden.description",
+    },
+    [EndpointErrorTypes.NOT_FOUND]: {
+      title:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.notFound.title",
+      description:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.notFound.description",
+    },
+    [EndpointErrorTypes.UNKNOWN_ERROR]: {
+      title:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.unknown.title",
+      description:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.unknown.description",
+    },
+    [EndpointErrorTypes.UNSAVED_CHANGES]: {
+      title:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.conflict.title",
+      description:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.conflict.description",
+    },
+    [EndpointErrorTypes.CONFLICT]: {
+      title:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.conflict.title",
+      description:
+        "app.api.system.unifiedInterface.cli.setup.update.post.errors.conflict.description",
+    },
+  },
+
+  // === SUCCESS HANDLING ===
+  successTypes: {
+    title:
+      "app.api.system.unifiedInterface.cli.setup.update.post.success.title",
+    description:
+      "app.api.system.unifiedInterface.cli.setup.update.post.success.description",
+  },
+});
+
+const endpoints = { POST };
+export default endpoints;
+
+// Export types for repository usage - following migration guide pattern
+export type UpdateRequestInput = typeof POST.types.RequestInput;
+export type UpdateRequestOutput = typeof POST.types.RequestOutput;
+export type UpdateResponseInput = typeof POST.types.ResponseInput;
+export type UpdateResponseOutput = typeof POST.types.ResponseOutput;

package/src/app/api/[locale]/system/unified-interface/cli/setup/update/i18n/de/index.ts

@@ -0,0 +1,54 @@
+import type { translations as enTranslations } from "../en";
+
+export const translations: typeof enTranslations = {
+  post: {
+    title: "Aktualisieren",
+    description: "Aktualisierungs-Endpunkt",
+    form: {
+      title: "Aktualisierungskonfiguration",
+      description: "Aktualisierungsparameter konfigurieren",
+    },
+    response: {
+      title: "Antwort",
+      description: "Aktualisierungsantwortdaten",
+    },
+    errors: {
+      unauthorized: {
+        title: "Nicht autorisiert",
+        description: "Authentifizierung erforderlich",
+      },
+      validation: {
+        title: "Validierungsfehler",
+        description: "Ungültige Anfrageparameter",
+      },
+      server: {
+        title: "Serverfehler",
+        description: "Interner Serverfehler aufgetreten",
+      },
+      unknown: {
+        title: "Unbekannter Fehler",
+        description: "Ein unbekannter Fehler ist aufgetreten",
+      },
+      network: {
+        title: "Netzwerkfehler",
+        description: "Netzwerkfehler aufgetreten",
+      },
+      forbidden: {
+        title: "Verboten",
+        description: "Zugriff verboten",
+      },
+      notFound: {
+        title: "Nicht gefunden",
+        description: "Ressource nicht gefunden",
+      },
+      conflict: {
+        title: "Konflikt",
+        description: "Datenkonflikt aufgetreten",
+      },
+    },
+    success: {
+      title: "Erfolg",
+      description: "Vorgang erfolgreich abgeschlossen",
+    },
+  },
+};

package/src/app/api/[locale]/system/unified-interface/cli/setup/update/i18n/en/index.ts

@@ -0,0 +1,52 @@
+export const translations = {
+  post: {
+    title: "Update",
+    description: "Update endpoint",
+    form: {
+      title: "Update Configuration",
+      description: "Configure update parameters",
+    },
+    response: {
+      title: "Response",
+      description: "Update response data",
+    },
+    errors: {
+      unauthorized: {
+        title: "Unauthorized",
+        description: "Authentication required",
+      },
+      validation: {
+        title: "Validation Error",
+        description: "Invalid request parameters",
+      },
+      server: {
+        title: "Server Error",
+        description: "Internal server error occurred",
+      },
+      unknown: {
+        title: "Unknown Error",
+        description: "An unknown error occurred",
+      },
+      network: {
+        title: "Network Error",
+        description: "Network error occurred",
+      },
+      forbidden: {
+        title: "Forbidden",
+        description: "Access forbidden",
+      },
+      notFound: {
+        title: "Not Found",
+        description: "Resource not found",
+      },
+      conflict: {
+        title: "Conflict",
+        description: "Data conflict occurred",
+      },
+    },
+    success: {
+      title: "Success",
+      description: "Operation completed successfully",
+    },
+  },
+};

package/src/app/api/[locale]/system/unified-interface/cli/setup/update/i18n/pl/index.ts

@@ -0,0 +1,54 @@
+import type { translations as enTranslations } from "../en";
+
+export const translations: typeof enTranslations = {
+  post: {
+    title: "Aktualizuj",
+    description: "Punkt końcowy aktualizacji",
+    form: {
+      title: "Konfiguracja aktualizacji",
+      description: "Skonfiguruj parametry aktualizacji",
+    },
+    response: {
+      title: "Odpowiedź",
+      description: "Dane odpowiedzi aktualizacji",
+    },
+    errors: {
+      unauthorized: {
+        title: "Nieautoryzowany",
+        description: "Wymagana autoryzacja",
+      },
+      validation: {
+        title: "Błąd walidacji",
+        description: "Nieprawidłowe parametry żądania",
+      },
+      server: {
+        title: "Błąd serwera",
+        description: "Wystąpił wewnętrzny błąd serwera",
+      },
+      unknown: {
+        title: "Nieznany błąd",
+        description: "Wystąpił nieznany błąd",
+      },
+      network: {
+        title: "Błąd sieci",
+        description: "Wystąpił błąd sieci",
+      },
+      forbidden: {
+        title: "Zabronione",
+        description: "Dostęp zabroniony",
+      },
+      notFound: {
+        title: "Nie znaleziono",
+        description: "Zasób nie został znaleziony",
+      },
+      conflict: {
+        title: "Konflikt",
+        description: "Wystąpił konflikt danych",
+      },
+    },
+    success: {
+      title: "Sukces",
+      description: "Operacja zakończona pomyślnie",
+    },
+  },
+};

package/src/app/api/[locale]/system/unified-interface/cli/setup/update/repository.ts

@@ -0,0 +1,113 @@
+/**
+ * Setup Update Repository
+ * Business logic for CLI update (uninstall + reinstall)
+ * Following migration guide: Repository-only logic pattern
+ */
+
+import "server-only";
+
+import type { ResponseType } from "next-vibe/shared/types/response.schema";
+import {
+  ErrorResponseTypes,
+  fail,
+  success,
+} from "next-vibe/shared/types/response.schema";
+import { parseError } from "next-vibe/shared/utils";
+
+import type { CountryLanguage } from "@/i18n/core/config";
+import { simpleT } from "@/i18n/core/shared";
+
+import type { JwtPayloadType } from "../../../../../user/auth/types";
+import { setupInstallRepository } from "../install/repository";
+import { setupUninstallRepository } from "../uninstall/repository";
+import type { UpdateRequestOutput, UpdateResponseOutput } from "./definition";
+
+/**
+ * Setup Update Repository Interface
+ */
+export interface SetupUpdateRepository {
+  updateCli(
+    data: UpdateRequestOutput,
+    user: JwtPayloadType,
+    locale: CountryLanguage,
+  ): Promise<ResponseType<UpdateResponseOutput>>;
+}
+
+/**
+ * Setup Update Repository Implementation
+ * Uses other repositories to perform uninstall + install
+ */
+class SetupUpdateRepositoryImpl implements SetupUpdateRepository {
+  async updateCli(
+    data: UpdateRequestOutput,
+    user: JwtPayloadType,
+    locale: CountryLanguage,
+  ): Promise<ResponseType<UpdateResponseOutput>> {
+    const { t } = simpleT(locale);
+
+    try {
+      // First uninstall existing CLI
+      const uninstallResult = await setupUninstallRepository.uninstallCli(
+        { verbose: data.verbose },
+        user,
+        locale,
+      );
+
+      if (!uninstallResult.success) {
+        return fail({
+          message:
+            "app.api.system.unifiedInterface.cli.setup.update.post.errors.server.title",
+          errorType: ErrorResponseTypes.INTERNAL_ERROR,
+          messageParams: {
+            error: t(
+              "app.api.system.unifiedInterface.cli.setup.update.post.errors.server.description",
+            ),
+          },
+          cause: uninstallResult,
+        });
+      }
+
+      // Then install CLI with force
+      const installResult = await setupInstallRepository.installCli(
+        { force: true, verbose: data.verbose },
+        user,
+        locale,
+      );
+
+      if (installResult.success && installResult.data) {
+        return success({
+          success: true,
+          installed: true,
+          version: installResult.data.version,
+          path: installResult.data.path,
+          message: t(
+            "app.api.system.unifiedInterface.cli.setup.update.post.success.description",
+          ),
+          output: installResult.data.output,
+        });
+      }
+      return success({
+        success: false,
+        installed: false,
+        message: t(
+          "app.api.system.unifiedInterface.cli.setup.update.post.errors.server.description",
+        ),
+      });
+    } catch (err) {
+      const parsedError = parseError(err);
+      return fail({
+        message:
+          "app.api.system.unifiedInterface.cli.setup.update.post.errors.server.title",
+        errorType: ErrorResponseTypes.INTERNAL_ERROR,
+        messageParams: {
+          error: parsedError.message,
+        },
+      });
+    }
+  }
+}
+
+/**
+ * Default repository instance
+ */
+export const setupUpdateRepository = new SetupUpdateRepositoryImpl();