@next-vibe/checker 1.0.52 → 3.0.0

package/src/app/api/[locale]/system/generators/route-handlers/definition.ts

@@ -1,178 +0,0 @@
-/**
- * Dynamic Route Handlers Generator Definition
- * Generates route-handlers.ts with dynamic imports and flat path structure
- */
-
-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,
-  Methods,
-  WidgetType,
-} from "@/app/api/[locale]/system/unified-interface/shared/types/enums";
-import { UserRole } from "@/app/api/[locale]/user/user-roles/enum";
-
-const { POST } = createEndpoint({
-  method: Methods.POST,
-  path: ["system", "generators", "route-handlers"],
-  title: "app.api.system.generators.route-handlers.post.title" as const,
-  description: "app.api.system.generators.route-handlers.post.description" as const,
-  category: "app.api.system.generators.category" as const,
-  tags: ["app.api.system.generators.route-handlers.post.title" as const],
-  icon: "file-code",
-  allowedRoles: [
-    UserRole.ADMIN,
-    UserRole.WEB_OFF,
-    UserRole.AI_TOOL_OFF,
-    UserRole.MCP_OFF,
-    UserRole.PRODUCTION_OFF,
-  ] as const,
-
-  fields: objectField(
-    {
-      type: WidgetType.FORM_FIELD,
-      fieldType: FieldDataType.TEXT,
-      label: "app.api.system.generators.route-handlers.post.container.title" as const,
-      columns: 12,
-    },
-    { request: "data", response: true },
-    {
-      // === REQUEST FIELDS ===
-      outputFile: requestDataField(
-        {
-          type: WidgetType.FORM_FIELD,
-          fieldType: FieldDataType.TEXT,
-          label: "app.api.system.generators.route-handlers.post.fields.outputFile.label" as const,
-          description:
-            "app.api.system.generators.route-handlers.post.fields.outputFile.description" as const,
-          columns: 12,
-        },
-        z.string().default("src/app/api/[locale]/system/generated/route-handlers.ts"),
-      ),
-
-      dryRun: requestDataField(
-        {
-          type: WidgetType.FORM_FIELD,
-          fieldType: FieldDataType.BOOLEAN,
-          label: "app.api.system.generators.route-handlers.post.fields.dryRun.label" as const,
-          description:
-            "app.api.system.generators.route-handlers.post.fields.dryRun.description" as const,
-          columns: 6,
-        },
-        z.boolean().optional().default(false),
-      ),
-
-      // === RESPONSE FIELDS ===
-      success: responseField(
-        {
-          type: WidgetType.TEXT,
-          content: "app.api.system.generators.route-handlers.post.fields.success.title" as const,
-        },
-        z.boolean(),
-      ),
-      message: responseField(
-        {
-          type: WidgetType.TEXT,
-          content: "app.api.system.generators.route-handlers.post.fields.message.title" as const,
-        },
-        z.string(),
-      ),
-      routesFound: responseField(
-        {
-          type: WidgetType.TEXT,
-          content:
-            "app.api.system.generators.route-handlers.post.fields.routesFound.title" as const,
-        },
-        z.coerce.number(),
-      ),
-      duration: responseField(
-        {
-          type: WidgetType.TEXT,
-          content: "app.api.system.generators.route-handlers.post.fields.duration.title" as const,
-        },
-        z.coerce.number(),
-      ),
-    },
-  ),
-
-  // === EXAMPLES ===
-  examples: {
-    requests: {
-      default: {
-        outputFile: "src/app/api/[locale]/system/generated/route-handlers.ts",
-        dryRun: false,
-      },
-    },
-    responses: {
-      default: {
-        success: true,
-        message: "Generated dynamic route handlers with 152 routes in 150ms",
-        routesFound: 152,
-        duration: 150,
-      },
-    },
-  },
-
-  errorTypes: {
-    [EndpointErrorTypes.VALIDATION_FAILED]: {
-      title: "app.api.system.generators.route-handlers.post.errors.validation.title" as const,
-      description:
-        "app.api.system.generators.route-handlers.post.errors.validation.description" as const,
-    },
-    [EndpointErrorTypes.NETWORK_ERROR]: {
-      title: "app.api.system.generators.route-handlers.post.errors.server.title" as const,
-      description:
-        "app.api.system.generators.route-handlers.post.errors.server.description" as const,
-    },
-    [EndpointErrorTypes.UNAUTHORIZED]: {
-      title: "app.api.system.generators.route-handlers.post.errors.server.title" as const,
-      description:
-        "app.api.system.generators.route-handlers.post.errors.server.description" as const,
-    },
-    [EndpointErrorTypes.FORBIDDEN]: {
-      title: "app.api.system.generators.route-handlers.post.errors.server.title" as const,
-      description:
-        "app.api.system.generators.route-handlers.post.errors.server.description" as const,
-    },
-    [EndpointErrorTypes.NOT_FOUND]: {
-      title: "app.api.system.generators.route-handlers.post.errors.server.title" as const,
-      description:
-        "app.api.system.generators.route-handlers.post.errors.server.description" as const,
-    },
-    [EndpointErrorTypes.SERVER_ERROR]: {
-      title: "app.api.system.generators.route-handlers.post.errors.server.title" as const,
-      description:
-        "app.api.system.generators.route-handlers.post.errors.server.description" as const,
-    },
-    [EndpointErrorTypes.UNKNOWN_ERROR]: {
-      title: "app.api.system.generators.route-handlers.post.errors.server.title" as const,
-      description:
-        "app.api.system.generators.route-handlers.post.errors.server.description" as const,
-    },
-    [EndpointErrorTypes.UNSAVED_CHANGES]: {
-      title: "app.api.system.generators.route-handlers.post.errors.server.title" as const,
-      description:
-        "app.api.system.generators.route-handlers.post.errors.server.description" as const,
-    },
-    [EndpointErrorTypes.CONFLICT]: {
-      title: "app.api.system.generators.route-handlers.post.errors.server.title" as const,
-      description:
-        "app.api.system.generators.route-handlers.post.errors.server.description" as const,
-    },
-  },
-
-  successTypes: {
-    title: "app.api.system.generators.route-handlers.post.success.title" as const,
-    description: "app.api.system.generators.route-handlers.post.success.description" as const,
-  },
-});
-
-const routeHandlersDynamicGeneratorEndpoints = { POST };
-export default routeHandlersDynamicGeneratorEndpoints;

package/src/app/api/[locale]/system/generators/route-handlers/i18n/de/index.ts

@@ -1,48 +0,0 @@
-export const translations = {
-  post: {
-    title: "Route Handlers Generator",
-    description: "Generate route-handlers.ts with dynamic imports",
-    container: {
-      title: "Route Handlers Generator Configuration",
-    },
-    fields: {
-      outputFile: {
-        label: "Output File",
-        description: "Path to the output route-handlers.ts file",
-        title: "Output File",
-      },
-      dryRun: {
-        label: "Dry Run",
-        description: "Preview changes without writing files",
-        title: "Dry Run",
-      },
-      success: {
-        title: "Success",
-      },
-      message: {
-        title: "Message",
-      },
-      routesFound: {
-        title: "Routes Found",
-      },
-      duration: {
-        title: "Duration (ms)",
-      },
-    },
-    errors: {
-      validation: {
-        title: "Validation Error",
-        description: "Invalid request parameters",
-      },
-      server: {
-        title: "Server Error",
-        description: "Internal server error occurred",
-      },
-    },
-    success: {
-      title: "Success",
-      description: "Route handlers generator completed successfully",
-      generated: "Route handlers file generated successfully",
-    },
-  },
-};

package/src/app/api/[locale]/system/generators/route-handlers/i18n/en/index.ts

@@ -1,48 +0,0 @@
-export const translations = {
-  post: {
-    title: "Route Handlers Generator",
-    description: "Generate route-handlers.ts with dynamic imports",
-    container: {
-      title: "Route Handlers Generator Configuration",
-    },
-    fields: {
-      outputFile: {
-        label: "Output File",
-        description: "Path to the output route-handlers.ts file",
-        title: "Output File",
-      },
-      dryRun: {
-        label: "Dry Run",
-        description: "Preview changes without writing files",
-        title: "Dry Run",
-      },
-      success: {
-        title: "Success",
-      },
-      message: {
-        title: "Message",
-      },
-      routesFound: {
-        title: "Routes Found",
-      },
-      duration: {
-        title: "Duration (ms)",
-      },
-    },
-    errors: {
-      validation: {
-        title: "Validation Error",
-        description: "Invalid request parameters",
-      },
-      server: {
-        title: "Server Error",
-        description: "Internal server error occurred",
-      },
-    },
-    success: {
-      title: "Success",
-      description: "Route handlers generator completed successfully",
-      generated: "Route handlers file generated successfully",
-    },
-  },
-};

package/src/app/api/[locale]/system/generators/route-handlers/i18n/pl/index.ts

@@ -1,50 +0,0 @@
-import type { translations as enTranslations } from "../en";
-
-export const translations: typeof enTranslations = {
-  post: {
-    title: "Route Handlers Generator",
-    description: "Generate route-handlers.ts with dynamic imports",
-    container: {
-      title: "Route Handlers Generator Configuration",
-    },
-    fields: {
-      outputFile: {
-        label: "Output File",
-        description: "Path to the output route-handlers.ts file",
-        title: "Output File",
-      },
-      dryRun: {
-        label: "Dry Run",
-        description: "Preview changes without writing files",
-        title: "Dry Run",
-      },
-      success: {
-        title: "Success",
-      },
-      message: {
-        title: "Message",
-      },
-      routesFound: {
-        title: "Routes Found",
-      },
-      duration: {
-        title: "Duration (ms)",
-      },
-    },
-    errors: {
-      validation: {
-        title: "Validation Error",
-        description: "Invalid request parameters",
-      },
-      server: {
-        title: "Server Error",
-        description: "Internal server error occurred",
-      },
-    },
-    success: {
-      title: "Success",
-      description: "Route handlers generator completed successfully",
-      generated: "Route handlers file generated successfully",
-    },
-  },
-};

package/src/app/api/[locale]/system/generators/route-handlers/repository.ts

@@ -1,267 +0,0 @@
-/**
- * Route Handlers Generator Repository
- * Generates route-handlers.ts with dynamic imports and flat path structure
- */
-
-import "server-only";
-
-import { join } from "node:path";
-
-import type { ResponseType as BaseResponseType } 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/parse-error";
-
-import type { EndpointLogger } from "@/app/api/[locale]/system/unified-interface/shared/logger/endpoint";
-import {
-  formatCount,
-  formatDuration,
-  formatGenerator,
-} from "@/app/api/[locale]/system/unified-interface/shared/logger/formatters";
-import type { ApiSection } from "@/app/api/[locale]/system/unified-interface/shared/types/endpoint";
-import { PATH_SEPARATOR } from "@/app/api/[locale]/system/unified-interface/shared/utils/path";
-
-import {
-  extractPathKey,
-  findFilesRecursively,
-  generateAbsoluteImportPath,
-  generateFileHeader,
-  writeGeneratedFile,
-} from "../shared/utils";
-
-// Type definitions
-interface RouteHandlersRequestType {
-  outputFile: string;
-  dryRun: boolean;
-}
-
-interface RouteHandlersResponseType {
-  success: boolean;
-  message: string;
-  routesFound: number;
-  duration: number;
-  outputFile?: string;
-}
-
-/**
- * Route Handlers Generator Repository Interface
- */
-interface RouteHandlersGeneratorRepository {
-  generateRouteHandlers(
-    data: RouteHandlersRequestType,
-    logger: EndpointLogger,
-  ): Promise<BaseResponseType<RouteHandlersResponseType>>;
-}
-
-/**
- * Route Handlers Generator Repository Implementation
- */
-class RouteHandlersGeneratorRepositoryImpl implements RouteHandlersGeneratorRepository {
-  async generateRouteHandlers(
-    data: RouteHandlersRequestType,
-    logger: EndpointLogger,
-  ): Promise<BaseResponseType<RouteHandlersResponseType>> {
-    const startTime = Date.now();
-
-    try {
-      const outputFile = data.outputFile;
-      logger.debug("Starting route handlers generation", {
-        outputFile,
-      });
-
-      // Discover route files
-      // eslint-disable-next-line i18next/no-literal-string
-      const apiCorePath = ["src", "app", "api", "[locale]"];
-      const startDir = join(process.cwd(), ...apiCorePath);
-
-      logger.debug("Discovering route files");
-      const routeFiles = findFilesRecursively(startDir, "route.ts");
-
-      logger.debug(`Found ${routeFiles.length} route files`);
-
-      // Generate content
-      const content = await this.generateContent(routeFiles);
-
-      // Write file
-      await writeGeneratedFile(outputFile, content, data.dryRun);
-
-      const duration = Date.now() - startTime;
-
-      logger.info(
-        formatGenerator(
-          `Generated route handlers file with ${formatCount(routeFiles.length, "route")} in ${formatDuration(duration)}`,
-          "🔗",
-        ),
-      );
-
-      return success({
-        success: true,
-        message: "app.api.system.generators.endpoints.success.generated",
-        routesFound: routeFiles.length,
-        duration,
-        outputFile: data.dryRun ? undefined : outputFile,
-      });
-    } catch (error) {
-      const duration = Date.now() - startTime;
-      logger.error("Route handlers generation failed", {
-        error: parseError(error),
-        duration,
-      });
-
-      return fail({
-        message: "app.api.system.generators.endpoints.post.errors.server.title",
-        errorType: ErrorResponseTypes.INTERNAL_ERROR,
-        messageParams: {
-          duration,
-        },
-      });
-    }
-  }
-
-  /**
-   * Extract HTTP methods from definition file (async)
-   * We extract from definition instead of route because route files have server-only dependencies
-   */
-  private async extractMethodsFromDefinition(routeFile: string): Promise<string[]> {
-    const definitionPath = routeFile.replace("/route.ts", "/definition.ts");
-    try {
-      const definition = (await import(definitionPath)) as {
-        default?: ApiSection;
-      };
-      const defaultExport = definition.default;
-
-      if (!defaultExport) {
-        return [];
-      }
-
-      // Get all HTTP methods from the definition
-      const methods = Object.keys(defaultExport).filter((key) =>
-        ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"].includes(key),
-      );
-      return methods;
-    } catch {
-      return [];
-    }
-  }
-
-  /**
-   * Extract aliases from definition file (async)
-   */
-  private async extractAliasesFromDefinition(
-    routeFile: string,
-  ): Promise<Array<{ alias: string; method: string }>> {
-    const definitionPath = routeFile.replace("/route.ts", "/definition.ts");
-    try {
-      const definition = (await import(definitionPath)) as {
-        default?: Record<string, { aliases?: string[] }>;
-      };
-      const defaultExport = definition.default;
-
-      if (!defaultExport) {
-        return [];
-      }
-
-      const aliasesWithMethods: Array<{ alias: string; method: string }> = [];
-
-      // Get aliases from each method
-      for (const method of Object.keys(defaultExport)) {
-        const methodDef = defaultExport[method];
-        if (methodDef?.aliases && Array.isArray(methodDef.aliases)) {
-          for (const alias of methodDef.aliases) {
-            aliasesWithMethods.push({ alias, method });
-          }
-        }
-      }
-
-      return aliasesWithMethods;
-    } catch {
-      // Definition file doesn't exist or can't be loaded
-    }
-    return [];
-  }
-
-  /**
-   * Generate route handlers content with dynamic imports and real aliases from definitions
-   * Main paths include method suffix (e.g., "core/agent/ai-stream/POST")
-   * Aliases also include method from their definition
-   */
-  private async generateContent(routeFiles: string[]): Promise<string> {
-    const pathMap: Record<string, { importPath: string; method: string }> = {};
-    const allPaths: string[] = [];
-
-    // Build path map with method suffixes and aliases (deduplicate)
-    for (const routeFile of routeFiles) {
-      const { path } = extractPathKey(routeFile);
-      const importPath = generateAbsoluteImportPath(routeFile, "route");
-
-      // Get methods for this route from definition file
-      const methods = await this.extractMethodsFromDefinition(routeFile);
-
-      // Add main path with method suffix for each method (e.g., "v1_core_agent_ai-stream_POST")
-      for (const method of methods) {
-        const pathWithMethod = `${path}${PATH_SEPARATOR}${method}`;
-        if (!pathMap[pathWithMethod]) {
-          pathMap[pathWithMethod] = { importPath, method };
-          allPaths.push(pathWithMethod);
-        }
-      }
-
-      // Extract and add real aliases from definition file (with their method)
-      const definitionAliases = await this.extractAliasesFromDefinition(routeFile);
-      for (const { alias, method } of definitionAliases) {
-        // Only add if not already present (first wins)
-        if (!pathMap[alias]) {
-          pathMap[alias] = { importPath, method };
-          allPaths.push(alias);
-        }
-      }
-    }
-
-    // Sort paths for consistent output
-    allPaths.sort();
-
-    // Generate getRouteHandler function cases with type-safe loading
-    const cases: string[] = [];
-    for (const path of allPaths) {
-      const { importPath } = pathMap[path];
-      // Return the handler - all handlers conform to GenericHandlerBase structurally
-      // The type assertion is safe because all handlers accept the same props shape
-      // eslint-disable-next-line i18next/no-literal-string
-      cases.push(`    case "${path}":
-      return (await import("${importPath}")).tools.${pathMap[path].method} as GenericHandlerBase;`);
-    }
-
-    // eslint-disable-next-line i18next/no-literal-string
-    const autoGenTitle = "AUTO-GENERATED FILE - DO NOT EDIT";
-    const generatorName = "generators/route-handlers";
-    const header = generateFileHeader(autoGenTitle, generatorName, {
-      "Routes found": routeFiles.length,
-      "Total paths (with aliases)": allPaths.length,
-    });
-
-    // eslint-disable-next-line i18next/no-literal-string
-    return `${header}
-
-import type { GenericHandlerBase } from "../unified-interface/shared/endpoints/route/handler";
-
-/* eslint-disable prettier/prettier */
-/* eslint-disable i18next/no-literal-string */
-
-/**
- * Dynamically import route handler by path
- * @param path - The route path (e.g., "core/agent/chat/threads")
- * @returns The route module or null if not found
- */
-export async function getRouteHandler(
-  path: string,
-): Promise<GenericHandlerBase | null> {
-  switch (path) {
-${cases.join("\n")}
-    default:
-      return null;
-  }
-}
-`;
-  }
-}
-
-export const routeHandlersGeneratorRepository = new RouteHandlersGeneratorRepositoryImpl();

package/src/app/api/[locale]/system/generators/route-handlers/route.ts

@@ -1,14 +0,0 @@
-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 definitions from "./definition";
-import { routeHandlersGeneratorRepository } from "./repository";
-
-export const { POST, tools } = endpointsHandler({
-  endpoint: definitions,
-  [Methods.POST]: {
-    handler: async (props) => {
-      return await routeHandlersGeneratorRepository.generateRouteHandlers(props.data, props.logger);
-    },
-  },
-});