create-backlist 7.3.1 → 7.4.0

package/src/generators/java.js

@@ -1,248 +1,248 @@
-import chalk from "chalk";
-import fs from "fs-extra";
-import path from "node:path";
-import axios from "axios";
-import unzipper from "unzipper";
-
-import { analyzeFrontend } from "../analyzer.js";
-import { renderAndWrite, getTemplatePath } from "./template.js";
-
-function sanitizeArtifactId(name) {
-  return String(name || "backend")
-    .toLowerCase()
-    .replace(/[^a-z0-9\-]/g, "-")
-    .replace(/-+/g, "-")
-    .replace(/^-+|-+$/g, "");
-}
-
-async function downloadInitializrZip({ groupId, artifactId, name, bootVersion, dependencies }) {
-  const params = new URLSearchParams({
-    type: "maven-project",
-    language: "java",
-    groupId,
-    artifactId,
-    name,
-    packageName: `${groupId}.${artifactId.replace(/-/g, "")}`,
-    dependencies: dependencies.join(","),
-  });
-
-  if (bootVersion) params.set("bootVersion", bootVersion);
-
-  const url = `https://start.spring.io/starter.zip?${params.toString()}`;
-
-  const res = await axios.get(url, {
-    responseType: "stream",
-    headers: { Accept: "application/zip" },
-  });
-
-  return res;
-}
-
-async function extractZipStream(stream, dest) {
-  await new Promise((resolve, reject) => {
-    const out = stream.pipe(unzipper.Extract({ path: dest }));
-    out.on("close", resolve);
-    out.on("finish", resolve);
-    out.on("error", reject);
-  });
-}
-
-async function appendApplicationProperties(projectDir, artifactId) {
-  try {
-    const propsPath = path.join(projectDir, "src", "main", "resources", "application.properties");
-    const dbProps = [
-      "",
-      "",
-      "# --- Auto-generated by create-backlist ---",
-      `spring.datasource.url=jdbc:postgresql://localhost:5432/${artifactId}`,
-      "spring.datasource.username=postgres",
-      "spring.datasource.password=password",
-      "spring.jpa.hibernate.ddl-auto=update",
-      "spring.jpa.show-sql=true",
-    ].join("\n");
-
-    await fs.appendFile(propsPath, dbProps);
-  } catch {
-    console.log(chalk.yellow("  -> Could not update application.properties (continuing)."));
-  }
-}
-
-function buildModelsFromEndpoints(endpoints) {
-  const modelsToGenerate = new Map();
-
-  (Array.isArray(endpoints) ? endpoints : []).forEach((ep) => {
-    if (!ep || !ep.controllerName || ep.controllerName === "Default") return;
-
-    if (!modelsToGenerate.has(ep.controllerName)) {
-      modelsToGenerate.set(ep.controllerName, {
-        name: ep.controllerName,
-        fields: [],
-        endpoints: [],
-      });
-    }
-
-    const m = modelsToGenerate.get(ep.controllerName);
-
-    m.endpoints.push({
-      method: ep.method,
-      route: ep.route || ep.path,
-      actionName: ep.actionName,
-    });
-
-    if (ep.schemaFields) {
-      for (const [key, type] of Object.entries(ep.schemaFields)) {
-        if (!m.fields.find((f) => f.name === key)) {
-          m.fields.push({ name: key, type });
-        }
-      }
-    }
-  });
-
-  return modelsToGenerate;
-}
-
-export async function generateJavaProject(options) {
-  const { projectDir, projectName, frontendSrcDir } = options;
-
-  const groupId = "com.backlist.generated";
-  const artifactId = sanitizeArtifactId(projectName || "backend");
-  const name = projectName || "backend";
-
-  try {
-    console.log(chalk.blue("  -> Contacting Spring Initializr to download a base Spring Boot project..."));
-
-    const deps = ["web", "data-jpa", "lombok", "postgresql"];
-    let response;
-
-    try {
-      response = await downloadInitializrZip({
-        groupId,
-        artifactId,
-        name,
-        bootVersion: "3.3.4",
-        dependencies: deps,
-      });
-    } catch {
-      console.log(chalk.yellow("    -> Initial attempt failed. Retrying with default Boot version..."));
-      try {
-        response = await downloadInitializrZip({
-          groupId,
-          artifactId,
-          name,
-          bootVersion: "",
-          dependencies: deps,
-        });
-      } catch {
-        console.log(chalk.yellow("    -> Second attempt failed. Retrying with minimal dependencies..."));
-        const fallbackDeps = ["web", "data-jpa", "lombok"];
-        response = await downloadInitializrZip({
-          groupId,
-          artifactId,
-          name,
-          bootVersion: "",
-          dependencies: fallbackDeps,
-        });
-      }
-    }
-
-    console.log(chalk.blue("  -> Unzipping the Spring Boot project..."));
-    await fs.ensureDir(projectDir);
-    await extractZipStream(response.data, projectDir);
-
-    console.log(chalk.blue("  -> Analyzing frontend for API endpoints..."));
-    const endpoints = await analyzeFrontend(frontendSrcDir);
-
-    if (!Array.isArray(endpoints) || endpoints.length === 0) {
-      console.log(chalk.yellow("  -> No endpoints found. Only base Spring project created."));
-    } else {
-      console.log(chalk.green(`  -> Found ${endpoints.length} endpoints.`));
-    }
-
-    const modelsToGenerate = buildModelsFromEndpoints(endpoints);
-
-    const javaSrcRoot = path.join(
-      projectDir,
-      "src",
-      "main",
-      "java",
-      ...groupId.split("."),
-      artifactId.replace(/-/g, "")
-    );
-
-    await fs.ensureDir(javaSrcRoot);
-
-    if (modelsToGenerate.size > 0) {
-      console.log(chalk.blue("  -> Generating Java entities, repositories, services, and controllers..."));
-
-      const entityDir = path.join(javaSrcRoot, "model");
-      const repoDir = path.join(javaSrcRoot, "repository");
-      const serviceDir = path.join(javaSrcRoot, "service");
-      const controllerDir = path.join(javaSrcRoot, "controller");
-
-      await fs.ensureDir(entityDir);
-      await fs.ensureDir(repoDir);
-      await fs.ensureDir(serviceDir);
-      await fs.ensureDir(controllerDir);
-
-      for (const model of modelsToGenerate.values()) {
-        const commonData = {
-          projectName,
-          groupId,
-          artifactId,
-          group: groupId,
-          model,
-          modelName: model.name,
-          controllerName: model.name
-        };
-
-        await renderAndWrite(
-          getTemplatePath("java-spring/partials/Entity.java.ejs"),
-          path.join(entityDir, `${model.name}.java`),
-          commonData
-        );
-
-        await renderAndWrite(
-          getTemplatePath("java-spring/partials/Repository.java.ejs"),
-          path.join(repoDir, `${model.name}Repository.java`),
-          commonData
-        );
-
-        await renderAndWrite(
-          getTemplatePath("java-spring/partials/Service.java.ejs"),
-          path.join(serviceDir, `${model.name}Service.java`),
-          commonData
-        );
-
-        await renderAndWrite(
-          getTemplatePath("java-spring/partials/Controller.java.ejs"),
-          path.join(controllerDir, `${model.name}Controller.java`),
-          commonData
-        );
-      }
-    } else {
-      console.log(chalk.yellow("  -> No models inferred. Skipping entity/controller generation."));
-    }
-
-    await appendApplicationProperties(projectDir, artifactId);
-
-    console.log(chalk.blue("  -> Generating Docker files..."));
-    await renderAndWrite(
-      getTemplatePath("java-spring/partials/Dockerfile.ejs"),
-      path.join(projectDir, "Dockerfile"),
-      { projectName, artifactId }
-    );
-    await renderAndWrite(
-      getTemplatePath("java-spring/partials/docker-compose.yml.ejs"),
-      path.join(projectDir, "docker-compose.yml"),
-      { projectName, artifactId }
-    );
-
-    console.log(chalk.green("  -> Java (Spring Boot) backend generation is complete!"));
-  } catch (error) {
-    if (error && error.response && error.response.status) {
-      console.error(chalk.red(`  -> Initializr error status: ${error.response.status}`));
-      throw new Error(`Failed to download from Spring Initializr. Status: ${error.response.status}`);
-    }
-    throw error;
-  }
-}
+import chalk from "chalk";
+import fs from "fs-extra";
+import path from "node:path";
+import axios from "axios";
+import unzipper from "unzipper";
+
+import { analyzeFrontend } from "../analyzer.js";
+import { renderAndWrite, getTemplatePath } from "./template.js";
+
+function sanitizeArtifactId(name) {
+  return String(name || "backend")
+    .toLowerCase()
+    .replace(/[^a-z0-9\-]/g, "-")
+    .replace(/-+/g, "-")
+    .replace(/^-+|-+$/g, "");
+}
+
+async function downloadInitializrZip({ groupId, artifactId, name, bootVersion, dependencies }) {
+  const params = new URLSearchParams({
+    type: "maven-project",
+    language: "java",
+    groupId,
+    artifactId,
+    name,
+    packageName: `${groupId}.${artifactId.replace(/-/g, "")}`,
+    dependencies: dependencies.join(","),
+  });
+
+  if (bootVersion) params.set("bootVersion", bootVersion);
+
+  const url = `https://start.spring.io/starter.zip?${params.toString()}`;
+
+  const res = await axios.get(url, {
+    responseType: "stream",
+    headers: { Accept: "application/zip" },
+  });
+
+  return res;
+}
+
+async function extractZipStream(stream, dest) {
+  await new Promise((resolve, reject) => {
+    const out = stream.pipe(unzipper.Extract({ path: dest }));
+    out.on("close", resolve);
+    out.on("finish", resolve);
+    out.on("error", reject);
+  });
+}
+
+async function appendApplicationProperties(projectDir, artifactId) {
+  try {
+    const propsPath = path.join(projectDir, "src", "main", "resources", "application.properties");
+    const dbProps = [
+      "",
+      "",
+      "# --- Auto-generated by create-backlist ---",
+      `spring.datasource.url=jdbc:postgresql://localhost:5432/${artifactId}`,
+      "spring.datasource.username=postgres",
+      "spring.datasource.password=password",
+      "spring.jpa.hibernate.ddl-auto=update",
+      "spring.jpa.show-sql=true",
+    ].join("\n");
+
+    await fs.appendFile(propsPath, dbProps);
+  } catch {
+    console.log(chalk.yellow("  -> Could not update application.properties (continuing)."));
+  }
+}
+
+function buildModelsFromEndpoints(endpoints) {
+  const modelsToGenerate = new Map();
+
+  (Array.isArray(endpoints) ? endpoints : []).forEach((ep) => {
+    if (!ep || !ep.controllerName || ep.controllerName === "Default") return;
+
+    if (!modelsToGenerate.has(ep.controllerName)) {
+      modelsToGenerate.set(ep.controllerName, {
+        name: ep.controllerName,
+        fields: [],
+        endpoints: [],
+      });
+    }
+
+    const m = modelsToGenerate.get(ep.controllerName);
+
+    m.endpoints.push({
+      method: ep.method,
+      route: ep.route || ep.path,
+      actionName: ep.actionName,
+    });
+
+    if (ep.schemaFields) {
+      for (const [key, type] of Object.entries(ep.schemaFields)) {
+        if (!m.fields.find((f) => f.name === key)) {
+          m.fields.push({ name: key, type });
+        }
+      }
+    }
+  });
+
+  return modelsToGenerate;
+}
+
+export async function generateJavaProject(options) {
+  const { projectDir, projectName, frontendSrcDir } = options;
+
+  const groupId = "com.backlist.generated";
+  const artifactId = sanitizeArtifactId(projectName || "backend");
+  const name = projectName || "backend";
+
+  try {
+    console.log(chalk.blue("  -> Contacting Spring Initializr to download a base Spring Boot project..."));
+
+    const deps = ["web", "data-jpa", "lombok", "postgresql"];
+    let response;
+
+    try {
+      response = await downloadInitializrZip({
+        groupId,
+        artifactId,
+        name,
+        bootVersion: "3.3.4",
+        dependencies: deps,
+      });
+    } catch {
+      console.log(chalk.yellow("    -> Initial attempt failed. Retrying with default Boot version..."));
+      try {
+        response = await downloadInitializrZip({
+          groupId,
+          artifactId,
+          name,
+          bootVersion: "",
+          dependencies: deps,
+        });
+      } catch {
+        console.log(chalk.yellow("    -> Second attempt failed. Retrying with minimal dependencies..."));
+        const fallbackDeps = ["web", "data-jpa", "lombok"];
+        response = await downloadInitializrZip({
+          groupId,
+          artifactId,
+          name,
+          bootVersion: "",
+          dependencies: fallbackDeps,
+        });
+      }
+    }
+
+    console.log(chalk.blue("  -> Unzipping the Spring Boot project..."));
+    await fs.ensureDir(projectDir);
+    await extractZipStream(response.data, projectDir);
+
+    console.log(chalk.blue("  -> Analyzing frontend for API endpoints..."));
+    const endpoints = await analyzeFrontend(frontendSrcDir);
+
+    if (!Array.isArray(endpoints) || endpoints.length === 0) {
+      console.log(chalk.yellow("  -> No endpoints found. Only base Spring project created."));
+    } else {
+      console.log(chalk.green(`  -> Found ${endpoints.length} endpoints.`));
+    }
+
+    const modelsToGenerate = buildModelsFromEndpoints(endpoints);
+
+    const javaSrcRoot = path.join(
+      projectDir,
+      "src",
+      "main",
+      "java",
+      ...groupId.split("."),
+      artifactId.replace(/-/g, "")
+    );
+
+    await fs.ensureDir(javaSrcRoot);
+
+    if (modelsToGenerate.size > 0) {
+      console.log(chalk.blue("  -> Generating Java entities, repositories, services, and controllers..."));
+
+      const entityDir = path.join(javaSrcRoot, "model");
+      const repoDir = path.join(javaSrcRoot, "repository");
+      const serviceDir = path.join(javaSrcRoot, "service");
+      const controllerDir = path.join(javaSrcRoot, "controller");
+
+      await fs.ensureDir(entityDir);
+      await fs.ensureDir(repoDir);
+      await fs.ensureDir(serviceDir);
+      await fs.ensureDir(controllerDir);
+
+      for (const model of modelsToGenerate.values()) {
+        const commonData = {
+          projectName,
+          groupId,
+          artifactId,
+          group: groupId,
+          model,
+          modelName: model.name,
+          controllerName: model.name
+        };
+
+        await renderAndWrite(
+          getTemplatePath("java-spring/partials/Entity.java.ejs"),
+          path.join(entityDir, `${model.name}.java`),
+          commonData
+        );
+
+        await renderAndWrite(
+          getTemplatePath("java-spring/partials/Repository.java.ejs"),
+          path.join(repoDir, `${model.name}Repository.java`),
+          commonData
+        );
+
+        await renderAndWrite(
+          getTemplatePath("java-spring/partials/Service.java.ejs"),
+          path.join(serviceDir, `${model.name}Service.java`),
+          commonData
+        );
+
+        await renderAndWrite(
+          getTemplatePath("java-spring/partials/Controller.java.ejs"),
+          path.join(controllerDir, `${model.name}Controller.java`),
+          commonData
+        );
+      }
+    } else {
+      console.log(chalk.yellow("  -> No models inferred. Skipping entity/controller generation."));
+    }
+
+    await appendApplicationProperties(projectDir, artifactId);
+
+    console.log(chalk.blue("  -> Generating Docker files..."));
+    await renderAndWrite(
+      getTemplatePath("java-spring/partials/Dockerfile.ejs"),
+      path.join(projectDir, "Dockerfile"),
+      { projectName, artifactId }
+    );
+    await renderAndWrite(
+      getTemplatePath("java-spring/partials/docker-compose.yml.ejs"),
+      path.join(projectDir, "docker-compose.yml"),
+      { projectName, artifactId }
+    );
+
+    console.log(chalk.green("  -> Java (Spring Boot) backend generation is complete!"));
+  } catch (error) {
+    if (error && error.response && error.response.status) {
+      console.error(chalk.red(`  -> Initializr error status: ${error.response.status}`));
+      throw new Error(`Failed to download from Spring Initializr. Status: ${error.response.status}`);
+    }
+    throw error;
+  }
+}