create-nexgen 1.0.4

package/template/src/modules/auth/database/models/role.ts

@@ -0,0 +1,14 @@
+import { relations } from "drizzle-orm";
+import { mysqlTable, int, varchar, timestamp } from "drizzle-orm/mysql-core";
+import { users } from "@/modules/auth/database/models/user.js";
+
+export const roles = mysqlTable("roles", {
+  id: int("id").autoincrement().primaryKey(),
+  name: varchar("name", { length: 255 }).notNull().unique(),
+  createdAt: timestamp("created_at").defaultNow().notNull(),
+  updatedAt: timestamp("updated_at").defaultNow().notNull().onUpdateNow()
+});
+
+export const rolesRelations = relations(roles, ({ many }) => ({
+  users: many(users)
+}));

package/template/src/modules/auth/database/models/user.ts

@@ -0,0 +1,46 @@
+import { relations } from "drizzle-orm";
+import { mysqlTable, int, varchar, text, timestamp, boolean } from "drizzle-orm/mysql-core";
+import { roles } from "@/modules/auth/database/models/role.js";
+
+export const users = mysqlTable("users", {
+  id: int("id").autoincrement().primaryKey(),
+  name: varchar("name", { length: 255 }).notNull(),
+  email: varchar("email", { length: 255 }).notNull().unique(),
+  password: text("password").notNull(),
+  roleId: int("role_id").references(() => roles.id, { onUpdate: "cascade", onDelete: "set null" }),
+  emailVerifiedAt: timestamp("email_verified_at"),
+  createdAt: timestamp("created_at").defaultNow().notNull(),
+  updatedAt: timestamp("updated_at").defaultNow().notNull().onUpdateNow()
+});
+
+export const emailVerificationTokens = mysqlTable("email_verification_tokens", {
+  id: int("id").autoincrement().primaryKey(),
+  email: varchar("email", { length: 255 }).notNull(),
+  token: text("token").notNull(),
+  expiresAt: timestamp("expires_at").notNull(),
+  createdAt: timestamp("created_at").defaultNow().notNull()
+});
+
+export const passwordResetTokens = mysqlTable("password_reset_tokens", {
+  id: int("id").autoincrement().primaryKey(),
+  email: varchar("email", { length: 255 }).notNull(),
+  token: text("token").notNull(),
+  expiresAt: timestamp("expires_at").notNull(),
+  createdAt: timestamp("created_at").defaultNow().notNull()
+});
+
+export const refreshTokens = mysqlTable("refresh_tokens", {
+  id: int("id").autoincrement().primaryKey(),
+  userId: int("user_id").references(() => users.id, { onUpdate: "cascade", onDelete: "set null" }),
+  jti: varchar("jti", { length: 191 }).notNull().unique(),
+  revoked: boolean("revoked").default(false),
+  expiresAt: timestamp("expires_at").notNull(),
+  createdAt: timestamp("created_at").defaultNow().notNull()
+});
+
+export const usersRelations = relations(users, ({ one }) => ({
+  role: one(roles, {
+    fields: [users.roleId],
+    references: [roles.id]
+  })
+}));

package/template/src/modules/auth/database/seeders/role.ts

@@ -0,0 +1,19 @@
+import { eq } from "drizzle-orm";
+import { db } from "@/framework/facade.js";
+import { roles } from "@/modules/auth/database/models/role.js";
+
+export default async function RoleSeeder() {
+  const rows = [
+    { name: "admin" },
+    { name: "user" }
+  ];
+
+  for (const row of rows) {
+    const existing = await db.query.roles.findFirst({ where: eq(roles.name, row.name) });
+    if (!existing) {
+      await db.insert(roles).values({ name: row.name });
+    }
+  }
+
+  console.log("Role seeder completed");
+}

package/template/src/modules/auth/database/seeders/user.ts

@@ -0,0 +1,33 @@
+import { eq } from "drizzle-orm";
+import { db, password } from "@/framework/facade.js";
+import { roles } from "@/modules/auth/database/models/role.js";
+import { users } from "@/modules/auth/database/models/user.js";
+
+export default async function UserSeeder() {
+  const adminRole = await db.query.roles.findFirst({ where: eq(roles.name, "admin") });
+  const userRole = await db.query.roles.findFirst({ where: eq(roles.name, "user") });
+
+  const rows = [
+    {
+      name: "Admin",
+      email: "admin@example.com",
+      password: await password.hashPassword("Password@123"),
+      roleId: adminRole?.id ?? null
+    },
+    {
+      name: "User One",
+      email: "user1@example.com",
+      password: await password.hashPassword("Password@123"),
+      roleId: userRole?.id ?? null
+    }
+  ];
+
+  for (const row of rows) {
+    const existing = await db.query.users.findFirst({ where: eq(users.email, row.email) });
+    if (!existing) {
+      await db.insert(users).values(row);
+    }
+  }
+
+  console.log("User seeder completed");
+}

package/template/src/modules/auth/jobs/forgetpass.ts

@@ -0,0 +1,18 @@
+import { mail, shouldQueue } from "@/framework/facade.js";
+
+shouldQueue("user:forget-password", "mail", async (job) => {
+  const { email, name, resetUrl } = job.data;
+
+  await mail.sendMail({
+    to: email,
+    subject: "Reset Your Password",
+    html: `
+      <p>Hello ${name},</p>
+      <p>Click the link below to reset your password:</p>
+      <p><a href="${resetUrl}">${resetUrl}</a></p>
+      <p>This link will expire in 15 minutes.</p>
+    `
+  });
+
+  return { ok: true, resetUrl };
+});

package/template/src/modules/auth/jobs/registeruser.ts

@@ -0,0 +1,31 @@
+import { dispatchEvent, mail, shouldQueue } from "@/framework/facade.js";
+import { DateTime as Datetime } from "luxon";
+
+shouldQueue("user:signup", "mail", async (job) => {
+  const { email, name, password, userId } = job.data;
+
+  await mail.sendMail({
+    to: email,
+    subject: "Account Creation",
+    html: `
+      <p>Hello ${name},</p>
+      <p>Your account was created successfully.</p>
+      <p>Email: ${email}</p>
+      <p>Password: ${password}</p>
+    `
+  });
+
+  await dispatchEvent(
+    "admin.user.registered",
+    { userId, name, email, createdAt: Datetime.now() },
+    { broadcast: { roles: ["admin"] } }
+  );
+
+  await dispatchEvent(
+    "user.registered",
+    { message: "Welcome! Your account has been created." },
+    { broadcast: { users: [userId] } }
+  );
+
+  return { ok: true, userId };
+});

package/template/src/modules/auth/jobs/verifyemail.ts

@@ -0,0 +1,18 @@
+import { mail, shouldQueue } from "@/framework/facade.js";
+
+shouldQueue("user:verify-email", "mail", async (job) => {
+  const { email, name, verifyUrl } = job.data;
+
+  await mail.sendMail({
+    to: email,
+    subject: "Verify Your Email",
+    html: `
+      <p>Hello ${name},</p>
+      <p>Thanks for registering. Please verify your email by clicking the link below:</p>
+      <p><a href="${verifyUrl}">${verifyUrl}</a></p>
+      <p>This link will expire in 24 hours.</p>
+    `
+  });
+
+  return { ok: true, verifyUrl };
+});

package/template/src/modules/auth/routes/api.ts

@@ -0,0 +1,151 @@
+import { createRoute, createRouter, HttpStatusCodes, jsonContent, z } from "@/framework/facade.js";
+import { authMiddleware } from "@/middlewares/auth-middleware.js";
+import {
+  forgotPassword,
+  login,
+  logout,
+  logoutAllDevices,
+  me,
+  refreshToken,
+  register,
+  resetPassword,
+  verifyEmail
+} from "@/modules/auth/controllers/auth.controller.js";
+import {
+  AuthResponseSchema,
+  ForgotPasswordSchema,
+  LoginSchema,
+  MessageSchema,
+  RefreshTokenSchema,
+  RegisterSchema,
+  ResetPasswordSchema,
+  VerifyEmailSchema,
+  UserSchema
+} from "@/modules/auth/controllers/auth.schema.js";
+
+const registerRoute = createRoute({
+  path: "/register",
+  method: "post",
+  tags: ["Auth"],
+  description: "Register a new user",
+  request: {
+    body: jsonContent(RegisterSchema, "Register payload")
+  },
+  responses: {
+    [HttpStatusCodes.CREATED]: jsonContent(AuthResponseSchema, "Registered")
+  }
+});
+
+const loginRoute = createRoute({
+  path: "/login",
+  method: "post",
+  tags: ["Auth"],
+  description: "Login user",
+  request: {
+    body: jsonContent(LoginSchema, "Login payload")
+  },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(AuthResponseSchema, "Logged in")
+  }
+});
+
+const meRoute = createRoute({
+  path: "/me",
+  method: "get",
+  tags: ["Auth"],
+  description: "Get authenticated user",
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(
+      z.object({ message: z.string(), data: UserSchema }),
+      "Authenticated user"
+    )
+  }
+});
+
+const logoutRoute = createRoute({
+  path: "/logout",
+  method: "post",
+  tags: ["Auth"],
+  description: "Logout user from current device",
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(MessageSchema, "Logged out")
+  }
+});
+
+const logoutAllDevicesRoute = createRoute({
+  path: "/logout-all",
+  method: "post",
+  tags: ["Auth"],
+  description: "Logout user from all devices",
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(MessageSchema, "Logged out from all devices")
+  }
+});
+
+const forgotPasswordRoute = createRoute({
+  path: "/forgot-password",
+  method: "post",
+  tags: ["Auth"],
+  description: "Send reset password email",
+  request: {
+    body: jsonContent(ForgotPasswordSchema, "Forgot password payload")
+  },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(MessageSchema, "Reset email sent")
+  }
+});
+
+const resetPasswordRoute = createRoute({
+  path: "/reset-password",
+  method: "post",
+  tags: ["Auth"],
+  description: "Reset password using token",
+  request: {
+    body: jsonContent(ResetPasswordSchema, "Reset password payload")
+  },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(MessageSchema, "Password reset")
+  }
+});
+
+const refreshTokenRoute = createRoute({
+  path: "/refresh-token",
+  method: "post",
+  tags: ["Auth"],
+  description: "Refresh access token",
+  request: {
+    body: jsonContent(RefreshTokenSchema, "Refresh token payload")
+  },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(AuthResponseSchema, "Token refreshed")
+  }
+});
+
+const verifyEmailRoute = createRoute({
+  path: "/verify-email",
+  method: "post",
+  tags: ["Auth"],
+  description: "Verify user email using token",
+  request: {
+    body: jsonContent(VerifyEmailSchema, "Verify email payload")
+  },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(MessageSchema, "Email verified")
+  }
+});
+
+const publicRoute = createRouter()
+  .api(registerRoute, register)
+  .api(loginRoute, login)
+  .api(forgotPasswordRoute, forgotPassword)
+  .api(resetPasswordRoute, resetPassword)
+  .api(verifyEmailRoute, verifyEmail)
+  .api(refreshTokenRoute, refreshToken);
+
+const protectedRoute = createRouter()
+  .group(authMiddleware)
+  .api(meRoute, me)
+  .api(logoutRoute, logout)
+  .api(logoutAllDevicesRoute, logoutAllDevices);
+
+export default createRouter().route("/", publicRoute).route("/", protectedRoute);

package/template/src/modules/auth/routes/role.ts

@@ -0,0 +1,39 @@
+import { createRoute, createRouter, HttpStatusCodes, jsonContent, z } from "@/framework/facade.js";
+import { authMiddleware } from "@/middlewares/auth-middleware.js";
+import { requireRole } from "@/middlewares/role-middleware.js";
+import { index, show } from "@/modules/auth/controllers/role.controller.js";
+import { IdParamsSchema, RoleSchema } from "@/modules/auth/controllers/auth.schema.js";
+
+const indexRoute = createRoute({
+  path: "/role",
+  method: "get",
+  tags: ["Role"],
+  description: "List all roles",
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(
+      z.object({ message: z.string(), data: z.array(RoleSchema) }),
+      "Role list"
+    )
+  }
+});
+
+const showRoute = createRoute({
+  path: "/role/{id}",
+  method: "get",
+  tags: ["Role"],
+  description: "Show one role",
+  request: {
+    params: IdParamsSchema
+  },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(
+      z.object({ message: z.string(), data: RoleSchema.nullable() }),
+      "Role item"
+    )
+  }
+});
+
+export default createRouter()
+  .group(authMiddleware)
+  .api(indexRoute, [requireRole("admin")], index)
+  .api(showRoute, [requireRole("admin")], show);

package/template/src/modules/welcome/controllers/welcome.controller.ts

@@ -0,0 +1,14 @@
+import type { Handler } from "hono";
+import { cache } from "@/framework/facade.js";
+
+// Why: Provides a stable starter endpoint for health/demo responses.
+// When: Used when clients need a quick read-only payload without auth.
+// Where: Mounted at the welcome module root route.
+export const index: Handler = async (c) => {
+  const data = await cache.remember("welcome:index", 60, async () => [
+    { id: 1, title: "nexgen framework ready" },
+    { id: 2, title: "modules are auto-discovered" }
+  ]);
+
+  return c.json({ message: "Success", data });
+};

package/template/src/modules/welcome/controllers/welcome.schema.ts

@@ -0,0 +1,6 @@
+import { z } from "@hono/zod-openapi";
+
+export const WelcomeSchema = z.object({
+  id: z.number(),
+  title: z.string()
+});

package/template/src/modules/welcome/database/models/welcome.ts

@@ -0,0 +1,6 @@
+import { mysqlTable, int, varchar } from "drizzle-orm/mysql-core";
+
+export const welcomes = mysqlTable("welcomes", {
+  id: int("id").autoincrement().primaryKey(),
+  title: varchar("title", { length: 255 }).notNull()
+});

package/template/src/modules/welcome/routes/api.ts

@@ -0,0 +1,20 @@
+import { createRoute, createRouter, HttpStatusCodes, jsonContent, z } from "@/framework/facade.js";
+import { index } from "@/modules/welcome/controllers/welcome.controller.js";
+import { WelcomeSchema } from "@/modules/welcome/controllers/welcome.schema.js";
+
+const indexRoute = createRoute({
+  path: "/",
+  method: "get",
+  tags: ["Welcome"],
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent(
+      z.object({
+        message: z.string(),
+        data: z.array(WelcomeSchema)
+      }),
+      "Welcome list"
+    )
+  }
+});
+
+export default createRouter().api(indexRoute, index);

package/template/src/resources/index.html

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="icon" type="image/x-icon" href="../admin/src/assets/images/favicon/favicon.ico" />
+    <title>NEXGEN</title>
+  </head>
+
+  <body>
+    <div id="modal-show"></div>
+    <div id="toast-show"></div>
+    <div id="app"></div>
+    <script type="module" src="/src/main.ts"></script>
+  </body>
+</html>

package/template/src/resources/src/App.vue

@@ -0,0 +1,5 @@
+<template>
+  <router-view />
+</template>
+
+<script setup lang="ts"></script>