@ifecodes/backend-template 1.1.9 → 1.4.1

package/template/features/auth/argon2/inject.js

@@ -1,50 +1,50 @@
-export const deps = ["argon2"];
-
-export const getFiles = (language = "typescript") => {
-  const ext = language === "javascript" ? ".js" : ".ts";
-
-  const tsContent = `import argon2 from "argon2";
-
-const HASH_OPTIONS = {
-  type: argon2.argon2id,
-  memoryCost: 2 ** 16,
-  timeCost: 3,
-  parallelism: 1,
-};
-
-export const hashPassword = async (password: string): Promise<string> => {
-  return argon2.hash(password, HASH_OPTIONS);
-};
-
-export const verifyPassword = async (
-  hash: string,
-  password: string,
-): Promise<boolean> => {
-  return argon2.verify(hash, password);
-};
-`;
-
-  const jsContent = `const argon2 = require("argon2");
-
-const HASH_OPTIONS = {
-  type: argon2.argon2id,
-  memoryCost: 2 ** 16,
-  timeCost: 3,
-  parallelism: 1,
-};
-
-async function hashPassword(password) {
-  return argon2.hash(password, HASH_OPTIONS);
-}
-
-async function verifyPassword(hash, password) {
-  return argon2.verify(hash, password);
-}
-
-module.exports = { hashPassword, verifyPassword };
-`;
-
-  return {
-    [`src/utils/hash${ext}`]: language === "javascript" ? jsContent : tsContent,
-  };
-};
+export const deps = ["argon2"];
+
+export const getFiles = (language = "typescript") => {
+  const ext = language === "javascript" ? ".js" : ".ts";
+
+  const tsContent = `import argon2 from "argon2";
+
+const HASH_OPTIONS = {
+  type: argon2.argon2id,
+  memoryCost: 2 ** 16,
+  timeCost: 3,
+  parallelism: 1,
+};
+
+export const hashPassword = async (password: string): Promise<string> => {
+  return argon2.hash(password, HASH_OPTIONS);
+};
+
+export const verifyPassword = async (
+  hash: string,
+  password: string,
+): Promise<boolean> => {
+  return argon2.verify(hash, password);
+};
+`;
+
+  const jsContent = `const argon2 = require("argon2");
+
+const HASH_OPTIONS = {
+  type: argon2.argon2id,
+  memoryCost: 2 ** 16,
+  timeCost: 3,
+  parallelism: 1,
+};
+
+async function hashPassword(password) {
+  return argon2.hash(password, HASH_OPTIONS);
+}
+
+async function verifyPassword(hash, password) {
+  return argon2.verify(hash, password);
+}
+
+module.exports = { hashPassword, verifyPassword };
+`;
+
+  return {
+    [`src/utils/hash${ext}`]: language === "javascript" ? jsContent : tsContent,
+  };
+};

package/template/features/auth/base/health-openapi.ts

@@ -0,0 +1,62 @@
+// Enhanced OpenAPI spec for health endpoint when auth is enabled
+export const healthOpenApiWithMongo = {
+  get: {
+    tags: ["Health"],
+    summary: "Health check with MongoDB status",
+    description:
+      "Returns API health, runtime metrics, and MongoDB connection status.",
+    parameters: [
+      {
+        name: "verbose",
+        in: "query",
+        required: false,
+        schema: { type: "boolean" },
+        description: "Optional verbose mode for richer diagnostics.",
+      },
+    ],
+    responses: {
+      "200": {
+        description: "Healthy response",
+        content: {
+          "application/json": {
+            schema: {
+              type: "object",
+              properties: {
+                status: { type: "string", enum: ["healthy", "unhealthy"] },
+                uptime: { type: "number" },
+                timestamp: { type: "string" },
+                services: {
+                  type: "object",
+                  properties: {
+                    mongodb: {
+                      type: "string",
+                      enum: ["connected", "disconnected"],
+                    },
+                    memory: {
+                      type: "object",
+                      properties: {
+                        rss: { type: "number" },
+                        heapUsed: { type: "number" },
+                      },
+                    },
+                  },
+                },
+                failed: {
+                  type: "array",
+                  items: { type: "string" },
+                  description: "List of failed services",
+                },
+              },
+            },
+          },
+        },
+      },
+      "400": {
+        description: "Validation error",
+      },
+      "503": {
+        description: "Service unhealthy (when MongoDB is down)",
+      },
+    },
+  },
+};

package/template/features/auth/base/inject.js

@@ -1,172 +1,174 @@
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-// Read all module files
-const modulesDir = path.join(__dirname, "../modules");
-const modelsDir = path.join(__dirname, "../models");
-const utilsDir = path.join(__dirname, "../utils");
-
-const readDirFiles = (dir, prefix = "", language = "typescript") => {
-  const files = {};
-  const items = fs.readdirSync(dir);
-  const ext = language === "javascript" ? ".js" : ".ts";
-
-  for (const item of items) {
-    const fullPath = path.join(dir, item);
-    const isDir = fs.statSync(fullPath).isDirectory();
-    const desiredName = item.replace(/\.ts$|\.js$/, ext);
-    const chosenPath = isDir
-      ? fullPath
-      : fs.existsSync(path.join(dir, desiredName))
-      ? path.join(dir, desiredName)
-      : fullPath;
-
-    const relativePath = path.join(prefix, path.basename(desiredName));
-
-    if (isDir) {
-      Object.assign(files, readDirFiles(chosenPath, relativePath, language));
-    } else {
-      const content = fs.readFileSync(chosenPath, "utf8");
-      files[relativePath] = content;
-    }
-  }
-
-  return files;
-};
-
-const getDbContent = (language) => {
-  const tsContent = `import mongoose from "mongoose";
-import { ENV } from "./env";
-import { logger } from "@/utils";
-
-export const connectDB = async () => {
-  try {
-    await mongoose.connect(ENV.MONGO_URI);
-    logger.log("db", "MongoDB connected");
-  } catch (error) {
-    logger.error("db", "MongoDB connection failed", error);
-    process.exit(1);
-  }
-};
-`;
-
-  if (language === "javascript") {
-    return `const mongoose = require("mongoose");
-const { ENV } = require("./env");
-const { logger } = require("../utils");
-
-async function connectDB() {
-  try {
-    await mongoose.connect(ENV.MONGO_URI);
-    logger.log("db", "MongoDB connected");
-  } catch (error) {
-    logger.error("db", "MongoDB connection failed", error);
-    process.exit(1);
-  }
-}
-
-module.exports = { connectDB };
-`;
-  }
-
-  return tsContent;
-};
-
-const getHealthControllerContent = (language) => {
-  const tsContent = `import { Request, Response } from "express";
-import mongoose from "mongoose";
-const { logger } = require("../../../utils");
-
-export const healthCheck = async (_req: Request, res: Response) => {
-  const mongoState = mongoose.connection.readyState;
-  const healthy = mongoState === 1;
-
-  const failed: string[] = [];
-  if (mongoState !== 1) failed.push("mongodb");
-
-  logger.info("Health", healthy ? "healthy" : "unhealthy");
-
-  return res.status(healthy ? 200 : 503).json({
-    status: healthy ? "healthy" : "unhealthy",
-    uptime: process.uptime(),
-    timestamp: new Date().toISOString(),
-    services: {
-      mongodb: mongoState === 1 ? "connected" : "disconnected",
-      memory: {
-        rss: process.memoryUsage().rss,
-        heapUsed: process.memoryUsage().heapUsed,
-      },
-    },
-    failed,
-  });
-};
-`;
-
-  if (language === "javascript") {
-    return `const mongoose = require("mongoose");
-const { logger } = require("../../../utils");
-
-async function healthCheck(_req, res) {
-  const mongoState = mongoose.connection.readyState;
-  const healthy = mongoState === 1;
-
-  const failed = [];
-  if (mongoState !== 1) failed.push("mongodb");
-
-  logger.info("Health", healthy ? "healthy" : "unhealthy");
-
-  return res.status(healthy ? 200 : 503).json({
-    status: healthy ? "healthy" : "unhealthy",
-    uptime: process.uptime(),
-    timestamp: new Date().toISOString(),
-    services: {
-      mongodb: mongoState === 1 ? "connected" : "disconnected",
-      memory: {
-        rss: process.memoryUsage().rss,
-        heapUsed: process.memoryUsage().heapUsed,
-      },
-    },
-    failed,
-  });
-}
-
-module.exports = { healthCheck };
-`;
-  }
-
-  return tsContent;
-};
-
-export const getFiles = (language = "typescript") => {
-  const ext = language === "javascript" ? ".js" : ".ts";
-  const moduleFiles = readDirFiles(modulesDir, "src/modules/v1/auth", language);
-  const modelFiles = readDirFiles(modelsDir, "src/models", language);
-  const utilFiles = readDirFiles(utilsDir, "src/utils", language);
-
-  return {
-    ...moduleFiles,
-    ...modelFiles,
-    ...utilFiles,
-    [`src/config/db${ext}`]: getDbContent(language),
-    [`src/modules/v1/health/health.controller${ext}`]: getHealthControllerContent(language),
-  };
-};
-
-// For backward compatibility
-export const files = getFiles("typescript");
-
-export const imports = `import { authRoutes } from "./auth";`;
-
-export const getImports = (language) => language === "javascript"
-  ? `const { authRoutes } = require("./auth");`
-  : `import { authRoutes } from "./auth";`;
-
-export const middleware = `router.use("/auth", authRoutes);`;
-
-export const deps = ["jsonwebtoken", "mongoose"];
-export const devDeps = ["@types/jsonwebtoken"];
-
-export const targetFile = "src/modules/v1/index.ts";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// Read all module files
+const modulesDir = path.join(__dirname, "../modules");
+const modelsDir = path.join(__dirname, "../models");
+const utilsDir = path.join(__dirname, "../utils");
+
+const readDirFiles = (dir, prefix = "", language = "typescript") => {
+  const files = {};
+  const items = fs.readdirSync(dir);
+  const ext = language === "javascript" ? ".js" : ".ts";
+
+  for (const item of items) {
+    const fullPath = path.join(dir, item);
+    const isDir = fs.statSync(fullPath).isDirectory();
+    const desiredName = item.replace(/\.ts$|\.js$/, ext);
+    const chosenPath = isDir
+      ? fullPath
+      : fs.existsSync(path.join(dir, desiredName))
+      ? path.join(dir, desiredName)
+      : fullPath;
+
+    const relativePath = path.join(prefix, path.basename(desiredName));
+
+    if (isDir) {
+      Object.assign(files, readDirFiles(chosenPath, relativePath, language));
+    } else {
+      const content = fs.readFileSync(chosenPath, "utf8");
+      files[relativePath] = content;
+    }
+  }
+
+  return files;
+};
+
+const getDbContent = (language) => {
+  const tsContent = `import mongoose from "mongoose";
+import { ENV } from "./env";
+import { logger } from "@/utils";
+
+export const connectDB = async () => {
+  try {
+    await mongoose.connect(ENV.MONGO_URI);
+    logger.log("db", "MongoDB connected");
+  } catch (error) {
+    logger.error("db", "MongoDB connection failed", error);
+    process.exit(1);
+  }
+};
+`;
+
+  if (language === "javascript") {
+    return `const mongoose = require("mongoose");
+const { ENV } = require("./env");
+const { logger } = require("../utils");
+
+async function connectDB() {
+  try {
+    await mongoose.connect(ENV.MONGO_URI);
+    logger.log("db", "MongoDB connected");
+  } catch (error) {
+    logger.error("db", "MongoDB connection failed", error);
+    process.exit(1);
+  }
+}
+
+module.exports = { connectDB };
+`;
+  }
+
+  return tsContent;
+};
+
+const getHealthControllerContent = (language) => {
+  const tsContent = `import { Request, Response } from "express";
+import mongoose from "mongoose";
+const { logger } = require("../../../utils");
+
+export const healthCheck = async (_req: Request, res: Response) => {
+  const mongoState = mongoose.connection.readyState;
+  const healthy = mongoState === 1;
+
+  const failed: string[] = [];
+  if (mongoState !== 1) failed.push("mongodb");
+
+  logger.info("Health", healthy ? "healthy" : "unhealthy");
+
+  return res.status(healthy ? 200 : 503).json({
+    status: healthy ? "healthy" : "unhealthy",
+    uptime: process.uptime(),
+    timestamp: new Date().toISOString(),
+    services: {
+      mongodb: mongoState === 1 ? "connected" : "disconnected",
+      memory: {
+        rss: process.memoryUsage().rss,
+        heapUsed: process.memoryUsage().heapUsed,
+      },
+    },
+    failed,
+  });
+};
+`;
+
+  if (language === "javascript") {
+    return `const mongoose = require("mongoose");
+const { logger } = require("../../../utils");
+
+async function healthCheck(_req, res) {
+  const mongoState = mongoose.connection.readyState;
+  const healthy = mongoState === 1;
+
+  const failed = [];
+  if (mongoState !== 1) failed.push("mongodb");
+
+  logger.info("Health", healthy ? "healthy" : "unhealthy");
+
+  return res.status(healthy ? 200 : 503).json({
+    status: healthy ? "healthy" : "unhealthy",
+    uptime: process.uptime(),
+    timestamp: new Date().toISOString(),
+    services: {
+      mongodb: mongoState === 1 ? "connected" : "disconnected",
+      memory: {
+        rss: process.memoryUsage().rss,
+        heapUsed: process.memoryUsage().heapUsed,
+      },
+    },
+    failed,
+  });
+}
+
+module.exports = { healthCheck };
+`;
+  }
+
+  return tsContent;
+};
+
+export const getFiles = (language = "typescript") => {
+  const ext = language === "javascript" ? ".js" : ".ts";
+  const moduleFiles = readDirFiles(modulesDir, "src/modules/v1/auth", language);
+  const modelFiles = readDirFiles(modelsDir, "src/models", language);
+  const utilFiles = readDirFiles(utilsDir, "src/utils", language);
+
+  return {
+    ...moduleFiles,
+    ...modelFiles,
+    ...utilFiles,
+    [`src/config/db${ext}`]: getDbContent(language),
+    [`src/modules/v1/health/health.controller${ext}`]:
+      getHealthControllerContent(language),
+  };
+};
+
+// For backward compatibility
+export const files = getFiles("typescript");
+
+export const imports = `import { authRoutes } from "./auth";`;
+
+export const getImports = (language) =>
+  language === "javascript"
+    ? `const { authRoutes } = require("./auth");`
+    : `import { authRoutes } from "./auth";`;
+
+export const middleware = `router.use("/auth", authRoutes);`;
+
+export const deps = ["jsonwebtoken", "mongoose"];
+export const devDeps = ["@types/jsonwebtoken"];
+
+export const targetFile = "src/modules/v1/index.ts";

package/template/features/auth/bcrypt/inject.js

@@ -1,40 +1,40 @@
-export const deps = ["bcrypt"];
-
-export const devDeps = ["@types/bcrypt"];
-
-export const getFiles = (language = "typescript") => {
-  const ext = language === "javascript" ? ".js" : ".ts";
-
-  const tsContent = `import bcrypt from "bcrypt";
-
-export const hashPassword = async (password: string): Promise<string> => {
-  const salt = await bcrypt.genSalt(10);
-  return bcrypt.hash(password, salt);
-};
-
-export const verifyPassword = async (
-  hash: string,
-  password: string,
-): Promise<boolean> => {
-  return bcrypt.compare(password, hash);
-};
-`;
-
-  const jsContent = `const bcrypt = require("bcrypt");
-
-async function hashPassword(password) {
-  const salt = await bcrypt.genSalt(10);
-  return bcrypt.hash(password, salt);
-}
-
-async function verifyPassword(hash, password) {
-  return bcrypt.compare(password, hash);
-}
-
-module.exports = { hashPassword, verifyPassword };
-`;
-
-  return {
-    [`src/utils/hash${ext}`]: language === "javascript" ? jsContent : tsContent,
-  };
-};
+export const deps = ["bcrypt"];
+
+export const devDeps = ["@types/bcrypt"];
+
+export const getFiles = (language = "typescript") => {
+  const ext = language === "javascript" ? ".js" : ".ts";
+
+  const tsContent = `import bcrypt from "bcrypt";
+
+export const hashPassword = async (password: string): Promise<string> => {
+  const salt = await bcrypt.genSalt(10);
+  return bcrypt.hash(password, salt);
+};
+
+export const verifyPassword = async (
+  hash: string,
+  password: string,
+): Promise<boolean> => {
+  return bcrypt.compare(password, hash);
+};
+`;
+
+  const jsContent = `const bcrypt = require("bcrypt");
+
+async function hashPassword(password) {
+  const salt = await bcrypt.genSalt(10);
+  return bcrypt.hash(password, salt);
+}
+
+async function verifyPassword(hash, password) {
+  return bcrypt.compare(password, hash);
+}
+
+module.exports = { hashPassword, verifyPassword };
+`;
+
+  return {
+    [`src/utils/hash${ext}`]: language === "javascript" ? jsContent : tsContent,
+  };
+};

package/template/features/auth/models/index.ts

@@ -1 +1 @@
-export { UserModel, IUser } from "./user.model";
+export { UserModel, IUser } from "./user.model";

package/template/features/auth/models/user.model.js

@@ -1,24 +1,24 @@
-const mongoose = require("mongoose");
-
-const userSchema = new mongoose.Schema(
-  {
-    email: {
-      type: String,
-      required: true,
-      unique: true,
-    },
-    password: {
-      type: String,
-      required: true,
-    },
-    fullName: {
-      type: String,
-      required: true,
-    },
-  },
-  { timestamps: true },
-);
-
-const UserModel = mongoose.model("User", userSchema);
-
-module.exports = { UserModel };
+const mongoose = require("mongoose");
+
+const userSchema = new mongoose.Schema(
+  {
+    email: {
+      type: String,
+      required: true,
+      unique: true,
+    },
+    password: {
+      type: String,
+      required: true,
+    },
+    fullName: {
+      type: String,
+      required: true,
+    },
+  },
+  { timestamps: true }
+);
+
+const UserModel = mongoose.model("User", userSchema);
+
+module.exports = { UserModel };