@next-vibe/checker 1.0.11 → 1.0.13

package/src/app/api/[locale]/system/check/typecheck/definition.ts

@@ -0,0 +1,369 @@
+/**
+ * Run TypeScript type checking Endpoint Definition
+ * Production-ready endpoint for run typescript type checking
+ */
+
+import { z } from "zod";
+
+import { createEndpoint } from "@/app/api/[locale]/system/unified-interface/shared/endpoints/definition/create";
+import {
+  objectField,
+  requestDataField,
+  responseArrayField,
+  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";
+
+const { POST } = createEndpoint({
+  method: Methods.POST,
+  path: ["system", "check", "typecheck"],
+  title: "app.api.system.check.typecheck.title",
+  description: "app.api.system.check.typecheck.description",
+  category: "app.api.system.check.typecheck.category",
+  tags: ["app.api.system.check.typecheck.tag"],
+  icon: "check-circle",
+  allowedRoles: [
+    UserRole.ADMIN,
+    UserRole.WEB_OFF,
+    UserRole.PRODUCTION_OFF,
+    UserRole.AI_TOOL_OFF,
+    UserRole.MCP_OFF,
+    UserRole.CLI_AUTH_BYPASS,
+  ],
+  aliases: ["typecheck", "tc"],
+  cli: {
+    firstCliArgKey: "path",
+  },
+
+  fields: objectField(
+    {
+      type: WidgetType.CONTAINER,
+      title: "app.api.system.check.typecheck.container.title",
+      description: "app.api.system.check.typecheck.container.description",
+      layoutType: LayoutType.GRID,
+      columns: 12,
+    },
+    { request: "data", response: true },
+    {
+      // === REQUEST FIELDS ===
+      path: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.TEXT,
+          label: "app.api.system.check.typecheck.fields.path.label",
+          description: "app.api.system.check.typecheck.fields.path.description",
+          placeholder: "app.api.system.check.typecheck.fields.path.placeholder",
+          columns: 6,
+        },
+        z.string().optional(),
+      ),
+
+      disableFilter: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.check.typecheck.fields.disableFilter.label",
+          description:
+            "app.api.system.check.typecheck.fields.disableFilter.description",
+          columns: 4,
+        },
+        z.boolean().default(false),
+      ),
+
+      createConfig: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.check.typecheck.fields.createConfig.label",
+          description:
+            "app.api.system.check.typecheck.fields.createConfig.description",
+          columns: 4,
+        },
+        z.boolean().default(false),
+      ),
+
+      timeout: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.NUMBER,
+          label: "app.api.system.check.typecheck.fields.timeout.label",
+          description:
+            "app.api.system.check.typecheck.fields.timeout.description",
+          columns: 4,
+        },
+        z.coerce.number().min(1).max(3600).default(900),
+      ),
+
+      limit: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.NUMBER,
+          label: "app.api.system.check.typecheck.fields.limit.label",
+          description:
+            "app.api.system.check.typecheck.fields.limit.description",
+          columns: 4,
+        },
+        z.coerce.number().min(1).optional().default(200),
+      ),
+
+      page: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.NUMBER,
+          label: "app.api.system.check.typecheck.fields.page.label",
+          description: "app.api.system.check.typecheck.fields.page.description",
+          columns: 4,
+        },
+        z.coerce.number().min(1).optional().default(1),
+      ),
+
+      maxFilesInSummary: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.NUMBER,
+          label:
+            "app.api.system.check.typecheck.fields.maxFilesInSummary.label",
+          description:
+            "app.api.system.check.typecheck.fields.maxFilesInSummary.description",
+          columns: 4,
+        },
+        z.coerce.number().min(1).default(50),
+      ),
+
+      skipSorting: requestDataField(
+        {
+          type: WidgetType.FORM_FIELD,
+          fieldType: FieldDataType.BOOLEAN,
+          label: "app.api.system.check.typecheck.fields.skipSorting.label",
+          description:
+            "app.api.system.check.typecheck.fields.skipSorting.description",
+          columns: 3,
+        },
+        z.boolean().default(false),
+      ),
+
+      // === RESPONSE FIELDS ===
+      issues: objectField(
+        {
+          type: WidgetType.CODE_QUALITY_LIST,
+          groupBy: "file",
+          sortBy: "severity",
+          showSummary: true,
+          layoutType: LayoutType.GRID,
+          columns: 1,
+        },
+        { response: true },
+        {
+          items: responseArrayField(
+            {
+              type: WidgetType.CONTAINER,
+              title: "app.api.system.check.typecheck.response.issues.title",
+              description:
+                "app.api.system.check.typecheck.response.issues.emptyState.description",
+              layoutType: LayoutType.GRID,
+              columns: 12,
+            },
+            objectField(
+              {
+                type: WidgetType.CONTAINER,
+                title: "app.api.system.check.typecheck.response.issues.title",
+                description:
+                  "app.api.system.check.typecheck.response.issues.emptyState.description",
+                layoutType: LayoutType.GRID,
+                columns: 12,
+              },
+              { response: true },
+              {
+                file: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.typecheck.response.issues.title",
+                  },
+                  z.string(),
+                ),
+                line: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.typecheck.response.issues.title",
+                  },
+                  z.coerce.number().optional(),
+                ),
+                column: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.typecheck.response.issues.title",
+                  },
+                  z.coerce.number().optional(),
+                ),
+                rule: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.typecheck.response.issues.title",
+                  },
+                  z.string().optional(),
+                ),
+                code: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.typecheck.response.issues.title",
+                  },
+                  z.string().optional(),
+                ),
+                severity: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.typecheck.response.issues.title",
+                  },
+                  z.enum(["error", "warning", "info"]),
+                ),
+                message: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content: "app.api.system.check.typecheck.response.success",
+                  },
+                  z.string(),
+                ),
+                type: responseField(
+                  {
+                    type: WidgetType.TEXT,
+                    content:
+                      "app.api.system.check.typecheck.response.issues.title",
+                  },
+                  z.enum(["oxlint", "lint", "type"]),
+                ),
+              },
+            ),
+          ),
+
+          files: responseField(
+            {
+              type: WidgetType.CODE_QUALITY_FILES,
+            },
+            z.array(
+              z.object({
+                file: z.string(),
+                errors: z.number(),
+                warnings: z.number(),
+                total: z.number(),
+              }),
+            ),
+          ),
+
+          summary: responseField(
+            {
+              type: WidgetType.CODE_QUALITY_SUMMARY,
+            },
+            z.object({
+              totalIssues: z.number(),
+              totalFiles: z.number(),
+              totalErrors: z.number(),
+              displayedIssues: z.number(),
+              displayedFiles: z.number(),
+              truncatedMessage: z.string().optional(),
+              currentPage: z.number(),
+              totalPages: z.number(),
+            }),
+          ),
+        },
+      ),
+    },
+  ),
+
+  errorTypes: {
+    [EndpointErrorTypes.VALIDATION_FAILED]: {
+      title: "app.api.system.check.typecheck.errors.validation.title",
+      description:
+        "app.api.system.check.typecheck.errors.validation.description",
+    },
+    [EndpointErrorTypes.NETWORK_ERROR]: {
+      title: "app.api.system.check.typecheck.errors.internal.title",
+      description: "app.api.system.check.typecheck.errors.internal.description",
+    },
+    [EndpointErrorTypes.UNAUTHORIZED]: {
+      title: "app.api.system.check.typecheck.errors.unauthorized.title",
+      description:
+        "app.api.system.check.typecheck.errors.unauthorized.description",
+    },
+    [EndpointErrorTypes.FORBIDDEN]: {
+      title: "app.api.system.check.typecheck.errors.forbidden.title",
+      description:
+        "app.api.system.check.typecheck.errors.forbidden.description",
+    },
+    [EndpointErrorTypes.NOT_FOUND]: {
+      title: "app.api.system.check.typecheck.errors.notFound.title",
+      description: "app.api.system.check.typecheck.errors.notFound.description",
+    },
+    [EndpointErrorTypes.SERVER_ERROR]: {
+      title: "app.api.system.check.typecheck.errors.server.title",
+      description: "app.api.system.check.typecheck.errors.server.description",
+    },
+    [EndpointErrorTypes.UNKNOWN_ERROR]: {
+      title: "app.api.system.check.typecheck.errors.unknown.title",
+      description: "app.api.system.check.typecheck.errors.unknown.description",
+    },
+    [EndpointErrorTypes.UNSAVED_CHANGES]: {
+      title: "app.api.system.check.typecheck.errors.unsaved.title",
+      description: "app.api.system.check.typecheck.errors.unsaved.description",
+    },
+    [EndpointErrorTypes.CONFLICT]: {
+      title: "app.api.system.check.typecheck.errors.conflict.title",
+      description: "app.api.system.check.typecheck.errors.conflict.description",
+    },
+  },
+
+  successTypes: {
+    title: "app.api.system.check.typecheck.success.title",
+    description: "app.api.system.check.typecheck.success.description",
+  },
+
+  examples: {
+    requests: {
+      default: {
+        limit: 100,
+        page: 1,
+        maxFilesInSummary: 50,
+      },
+    },
+    responses: {
+      default: {
+        issues: {
+          items: [],
+          files: [],
+          summary: {
+            totalIssues: 0,
+            totalFiles: 0,
+            totalErrors: 0,
+            displayedIssues: 0,
+            displayedFiles: 0,
+            currentPage: 1,
+            totalPages: 1,
+          },
+        },
+      },
+    },
+  },
+});
+
+export type TypecheckRequestInput = typeof POST.types.RequestInput;
+export type TypecheckRequestOutput = typeof POST.types.RequestOutput;
+export type TypecheckResponseInput = typeof POST.types.ResponseInput;
+export type TypecheckResponseOutput = typeof POST.types.ResponseOutput;
+
+export type TypecheckIssue = TypecheckResponseOutput["issues"]["items"][number];
+
+const endpoints = { POST };
+export default endpoints;

package/src/app/api/[locale]/system/check/typecheck/enum.ts

@@ -0,0 +1,37 @@
+/**
+ * Typecheck Enums
+ * Enums for TypeScript type checking functionality
+ */
+
+import { createEnumOptions } from "@/app/api/[locale]/system/unified-interface/shared/field/enum";
+
+/**
+ * Typecheck Status
+ */
+export const { enum: TypecheckStatus, options: TypecheckStatusOptions } =
+  createEnumOptions({
+    PASSED: "app.api.system.check.typecheck.status.passed" as const,
+    FAILED: "app.api.system.check.typecheck.status.failed" as const,
+    RUNNING: "app.api.system.check.typecheck.status.running" as const,
+    SKIPPED: "app.api.system.check.typecheck.status.skipped" as const,
+  });
+
+/**
+ * Typecheck Severity
+ */
+export const { enum: TypecheckSeverity, options: TypecheckSeverityOptions } =
+  createEnumOptions({
+    ERROR: "app.api.system.check.typecheck.severity.error" as const,
+    WARNING: "app.api.system.check.typecheck.severity.warning" as const,
+    INFO: "app.api.system.check.typecheck.severity.info" as const,
+  });
+
+/**
+ * Typecheck Mode
+ */
+export const { enum: TypecheckMode, options: TypecheckModeOptions } =
+  createEnumOptions({
+    FULL: "app.api.system.check.typecheck.mode.full" as const,
+    INCREMENTAL: "app.api.system.check.typecheck.mode.incremental" as const,
+    WATCH: "app.api.system.check.typecheck.mode.watch" as const,
+  });

package/src/app/api/[locale]/system/check/typecheck/i18n/de/index.ts

@@ -0,0 +1,159 @@
+import type { translations as enTranslations } from "../en";
+
+export const translations: typeof enTranslations = {
+  // Main endpoint properties
+  title: "TypeScript-Typprüfung",
+  description:
+    "TypeScript-Typprüfung für angegebene Dateien oder Verzeichnisse ausführen",
+  category: "Systemprüfungen",
+  tag: "typprüfung",
+
+  // Enum translations
+  status: {
+    passed: "Bestanden",
+    failed: "Fehlgeschlagen",
+    running: "Läuft",
+    skipped: "Übersprungen",
+  },
+  severity: {
+    error: "Fehler",
+    warning: "Warnung",
+    info: "Info",
+  },
+  mode: {
+    full: "Vollständig",
+    incremental: "Inkrementell",
+    watch: "Überwachen",
+  },
+
+  // Container
+  container: {
+    title: "TypeScript-Typprüfung Konfiguration",
+    description:
+      "Parameter für die Ausführung der TypeScript-Typprüfung konfigurieren",
+  },
+
+  // Request fields
+  fields: {
+    path: {
+      label: "Pfad",
+      description:
+        "Datei- oder Verzeichnispfad zur Prüfung (optional, Standard ist aktuelles Verzeichnis)",
+      placeholder: "src/components",
+    },
+    verbose: {
+      label: "Ausführlich",
+      description:
+        "Detaillierte Ausgabe mit zusätzlichen Informationen aktivieren",
+    },
+    disableFilter: {
+      label: "Filter deaktivieren",
+      description:
+        "Filterung deaktivieren und alle TypeScript-Probleme anzeigen",
+    },
+    createConfig: {
+      label: "Konfiguration erstellen",
+      description: "Konfigurationsdatei automatisch erstellen, falls vorhanden",
+    },
+    timeout: {
+      label: "Timeout (Sekunden)",
+      description: "Maximale Ausführungszeit in Sekunden",
+    },
+    limit: {
+      label: "Limit",
+      description: "Maximale Anzahl anzuzeigender Probleme",
+    },
+    page: {
+      label: "Seite",
+      description: "Seitenzahl für Paginierung",
+    },
+    maxFilesInSummary: {
+      label: "Max. Dateien in Zusammenfassung",
+      description: "Maximale Anzahl von Dateien in der Zusammenfassung",
+    },
+    skipSorting: {
+      label: "Sortierung überspringen",
+      description: "Sortierung von Problemen überspringen (für Leistung)",
+    },
+  },
+
+  // Response fields
+  response: {
+    issues: {
+      title: "Probleme",
+      emptyState: {
+        description: "Keine Probleme gefunden",
+      },
+    },
+    success: "TypeScript-Typprüfung erfolgreich abgeschlossen",
+    successMessage: "TypeScript-Typprüfung erfolgreich abgeschlossen",
+    issue: {
+      title: "TypeScript-Problem",
+      description: "Einzelnes TypeScript-Typprüfungsproblem",
+      file: "Dateipfad, in dem das Problem gefunden wurde",
+      line: "Zeilennummer des Problems",
+      column: "Spaltennummer des Problems",
+      code: "TypeScript-Fehlercode",
+      severity: "Schweregrad des Problems",
+      type: "Problemtyp",
+      message: "Problembeschreibung",
+    },
+  },
+
+  // Error messages
+  errors: {
+    validation: {
+      title: "Validierungsfehler",
+      description: "Ungültige Anfrageparameter bereitgestellt",
+    },
+    internal: {
+      title: "Interner Fehler",
+      description:
+        "Ein interner Serverfehler ist während der Typprüfung aufgetreten",
+    },
+    unauthorized: {
+      title: "Nicht autorisiert",
+      description:
+        "Authentifizierung erforderlich für den Zugriff auf diesen Endpunkt",
+    },
+    forbidden: {
+      title: "Verboten",
+      description: "Zugriff auf diesen Endpunkt ist verboten",
+    },
+    notFound: {
+      title: "Nicht gefunden",
+      description: "Die angegebene Ressource wurde nicht gefunden",
+    },
+    server: {
+      title: "Serverfehler",
+      description: "Interner Serverfehler aufgetreten",
+    },
+    unknown: {
+      title: "Unbekannter Fehler",
+      description: "Ein unbekannter Fehler ist aufgetreten",
+    },
+    unsaved: {
+      title: "Ungespeicherte Änderungen",
+      description:
+        "Es gibt ungespeicherte Änderungen, die behandelt werden müssen",
+    },
+    conflict: {
+      title: "Konflikt",
+      description: "Ein Datenkonflikt ist aufgetreten",
+    },
+    noTsFiles: {
+      title: "Keine TypeScript-Dateien gefunden",
+      message: "Keine TypeScript-Dateien im angegebenen Pfad gefunden",
+    },
+    invalidCommand: {
+      title: "Ungültiger Befehl",
+      message: "Der TypeScript-Prüfbefehl ist ungültig oder fehlt",
+    },
+  },
+
+  // Success messages
+  success: {
+    title: "Typprüfung abgeschlossen",
+    description: "TypeScript-Typprüfung erfolgreich abgeschlossen",
+  },
+};