create-nexwire 4.0.0 → 4.1.0

package/express/src/framework/maker-cli/stubs/controller/plain.ts.stub

@@ -1,54 +1,80 @@
 import type { Request, Response } from "express";
 import { HttpStatusCodes } from "@/framework/facade.js";
 import { validate } from "@/framework/facade.js";
-import { Create{{ClassName}}Schema, Update{{ClassName}}Schema, {{ClassName}}IdParamsSchema } from "@/modules/{{module}}/controllers/{{controller}}.schema.js";
+import { Create{{ClassName}}Schema, Update{{ClassName}}Schema, {{ClassName}}IdParamsSchema } from "@/modules/{{module}}/schemas/{{controller}}.js";
+import { {{controller}}Service } from "@/modules/{{module}}/services/{{controller}}.js";
 
 /**
- * Why: Returns collection response shape for list pages.
+ * Why: Returns every {{controller}} row for list screens.
  * When: Used by GET list endpoint.
  * Where: GET /{{controller}} route.
  */
 export const index = async (_req: Request, res: Response) => {
-  res.json({ message: "{{controller}} list fetched successfully", data: [] });
+  const data = await {{controller}}Service.list();
+
+  res.json({ message: "{{controller}} list fetched successfully", data });
 };
 
 /**
- * Why: Returns one resource by validated route id.
+ * Why: Returns one {{controller}} row by validated route id.
  * When: Used by detail screens or fetch-by-id calls.
  * Where: GET /{{controller}}/{id} route.
  */
 export const show = async (req: Request, res: Response) => {
   const params = await validate({{ClassName}}IdParamsSchema, req.params);
-  res.json({ message: "{{controller}} fetched successfully", data: { id: params.id, name: "" } });
+  const data = await {{controller}}Service.findOne(params.id);
+
+  if (!data) {
+    res.status(HttpStatusCodes.NOT_FOUND).json({ message: "{{controller}} not found" });
+    return;
+  }
+
+  res.json({ message: "{{controller}} fetched successfully", data });
 };
 
 /**
- * Why: Creates a new resource from validated request body.
+ * Why: Creates a new {{controller}} row from a validated request body.
  * When: Used by create form submissions.
  * Where: POST /{{controller}} route.
  */
 export const store = async (req: Request, res: Response) => {
-  await validate(Create{{ClassName}}Schema, req.body);
-  res.status(HttpStatusCodes.CREATED).json({ message: "{{controller}} created successfully" });
+  const body = await validate(Create{{ClassName}}Schema, req.body);
+  const data = await {{controller}}Service.create(body);
+
+  res.status(HttpStatusCodes.CREATED).json({ message: "{{controller}} created successfully", data });
 };
 
 /**
- * Why: Updates an existing resource using id + body validation.
+ * Why: Updates an existing {{controller}} row using id + body validation.
  * When: Used by edit/update form submissions.
  * Where: PUT/PATCH /{{controller}}/{id} route.
  */
 export const update = async (req: Request, res: Response) => {
-  await validate({{ClassName}}IdParamsSchema, req.params);
-  await validate(Update{{ClassName}}Schema, req.body);
-  res.json({ message: "{{controller}} updated successfully" });
+  const params = await validate({{ClassName}}IdParamsSchema, req.params);
+  const body = await validate(Update{{ClassName}}Schema, req.body);
+  const data = await {{controller}}Service.update(params.id, body);
+
+  if (!data) {
+    res.status(HttpStatusCodes.NOT_FOUND).json({ message: "{{controller}} not found" });
+    return;
+  }
+
+  res.json({ message: "{{controller}} updated successfully", data });
 };
 
 /**
- * Why: Deletes one resource by validated route id.
+ * Why: Deletes one {{controller}} row by validated route id.
  * When: Used by delete actions.
  * Where: DELETE /{{controller}}/{id} route.
  */
 export const destroy = async (req: Request, res: Response) => {
-  await validate({{ClassName}}IdParamsSchema, req.params);
-  res.json({ message: "{{controller}} deleted successfully" });
-};
+  const params = await validate({{ClassName}}IdParamsSchema, req.params);
+  const data = await {{controller}}Service.remove(params.id);
+
+  if (!data) {
+    res.status(HttpStatusCodes.NOT_FOUND).json({ message: "{{controller}} not found" });
+    return;
+  }
+
+  res.json({ message: "{{controller}} deleted successfully", data });
+};

package/express/src/framework/maker-cli/stubs/controller/standalone.ts.stub

@@ -0,0 +1,47 @@
+import type { Request, Response } from "express";
+import { HttpStatusCodes } from "@/framework/facade.js";
+
+/**
+ * Why: Returns collection response shape for list pages.
+ * When: Used by GET list endpoint.
+ * Where: GET /{{controller}} route.
+ */
+export const index = async (_req: Request, res: Response) => {
+  res.json({ message: "{{controller}} list fetched successfully", data: [] });
+};
+
+/**
+ * Why: Returns one resource by validated route id.
+ * When: Used by detail screens or fetch-by-id calls.
+ * Where: GET /{{controller}}/{id} route.
+ */
+export const show = async (req: Request, res: Response) => {
+  res.json({ message: "{{controller}} fetched successfully", data: { id: req.params.id, name: "" } });
+};
+
+/**
+ * Why: Creates a new resource from validated request body.
+ * When: Used by create form submissions.
+ * Where: POST /{{controller}} route.
+ */
+export const store = async (_req: Request, res: Response) => {
+  res.status(HttpStatusCodes.CREATED).json({ message: "{{controller}} created successfully" });
+};
+
+/**
+ * Why: Updates an existing resource using id + body validation.
+ * When: Used by edit/update form submissions.
+ * Where: PUT/PATCH /{{controller}}/{id} route.
+ */
+export const update = async (_req: Request, res: Response) => {
+  res.json({ message: "{{controller}} updated successfully" });
+};
+
+/**
+ * Why: Deletes one resource by validated route id.
+ * When: Used by delete actions.
+ * Where: DELETE /{{controller}}/{id} route.
+ */
+export const destroy = async (_req: Request, res: Response) => {
+  res.json({ message: "{{controller}} deleted successfully" });
+};

package/express/src/framework/maker-cli/stubs/facade/name.ts.stub

@@ -0,0 +1,12 @@
+/**
+ * Public API for the {{module}} module.
+ *
+ * Other modules import from this file, never from controllers/ or services/ directly.
+ * Re-export the pieces they are allowed to depend on:
+ *
+ * export { list, findOne } from "./services/{{controller}}.js";
+ *
+ * Rule: a facade must never import another module's facade.
+ */
+
+export {};

package/express/src/framework/maker-cli/stubs/helper/name.ts.stub

@@ -0,0 +1,14 @@
+/**
+ * Why: Reusable {{name}} logic that does not belong to a controller or service.
+ * When: Called by controllers, services, jobs, or other helpers.
+ * Where: src/modules/{{module}}/helpers/{{name}}.ts
+ */
+
+/**
+ * Why: Placeholder shared helper.
+ * When: Replace this with real logic and rename it.
+ * Where: Anywhere inside the {{module}} module.
+ */
+export function {{name}}Helper<T>(value: T): T {
+  return value;
+}

package/express/src/framework/maker-cli/stubs/middleware/name.local.ts.stub

@@ -0,0 +1,15 @@
+import type { NextFunction, Request, Response } from "express";
+
+/**
+ * Why: Route-scoped middleware for the {{module}} module.
+ * When: Attach to a route or route group inside routes/*.ts.
+ * Where: src/modules/{{module}}/middlewares/{{name}}.ts
+ *
+ * Register it in a route file:
+ *   import { {{camel}}Middleware } from "@/modules/{{module}}/middlewares/{{name}}.js";
+ *   router.get("/path", {{camel}}Middleware, handler);
+ */
+export function {{camel}}Middleware(_req: Request, _res: Response, next: NextFunction) {
+  // Guard the route here, then continue the chain.
+  return next();
+}

package/express/src/framework/maker-cli/stubs/model/name.mysql.ts.stub

@@ -1,9 +1,10 @@
-import { relations } from "drizzle-orm";
-import { int, mysqlTable, timestamp } from "drizzle-orm/mysql-core";
-
-export const {{tableVariable}} = mysqlTable("{{tableName}}", {
-  id: int("id").autoincrement().primaryKey(),
-  createdAt: timestamp("created_at").defaultNow().notNull(),
-  updatedAt: timestamp("updated_at").defaultNow().notNull()
-});
+import { relations } from "drizzle-orm";
+import { int, mysqlTable, timestamp, varchar } from "drizzle-orm/mysql-core";
+
+export const {{tableVariable}} = mysqlTable("{{tableName}}", {
+  id: int("id").autoincrement().primaryKey(),
+  name: varchar("name", { length: 255 }).notNull(),
+  createdAt: timestamp("created_at").defaultNow().notNull(),
+  updatedAt: timestamp("updated_at").defaultNow().notNull()
+});
 

package/express/src/framework/maker-cli/stubs/model/name.postgresql.ts.stub

@@ -1,9 +1,10 @@
-import { relations } from "drizzle-orm";
-import { pgTable, serial, timestamp } from "drizzle-orm/pg-core";
-
-export const {{tableVariable}} = pgTable("{{tableName}}", {
-  id: serial("id").primaryKey(),
-  createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
-  updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull()
-});
+import { relations } from "drizzle-orm";
+import { pgTable, serial, text, timestamp } from "drizzle-orm/pg-core";
+
+export const {{tableVariable}} = pgTable("{{tableName}}", {
+  id: serial("id").primaryKey(),
+  name: text("name").notNull(),
+  createdAt: timestamp("created_at", { withTimezone: true }).defaultNow().notNull(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow().notNull()
+});
 

package/express/src/framework/maker-cli/stubs/model/name.sqlite.ts.stub

@@ -1,9 +1,10 @@
-import { relations } from "drizzle-orm";
-import { integer, sqliteTable } from "drizzle-orm/sqlite-core";
-
-export const {{tableVariable}} = sqliteTable("{{tableName}}", {
-  id: integer("id").primaryKey({ autoIncrement: true }),
-  createdAt: integer("created_at", { mode: "timestamp" }).$defaultFn(() => new Date()).notNull(),
-  updatedAt: integer("updated_at", { mode: "timestamp" }).$defaultFn(() => new Date()).notNull()
-});
+import { relations } from "drizzle-orm";
+import { integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
+
+export const {{tableVariable}} = sqliteTable("{{tableName}}", {
+  id: integer("id").primaryKey({ autoIncrement: true }),
+  name: text("name").notNull(),
+  createdAt: integer("created_at", { mode: "timestamp" }).$defaultFn(() => new Date()).notNull(),
+  updatedAt: integer("updated_at", { mode: "timestamp" }).$defaultFn(() => new Date()).notNull()
+});
 

package/express/src/framework/maker-cli/stubs/notification/route.api.ts.stub

@@ -1,50 +1,50 @@
-import { createRoute, createRouter, HttpStatusCodes, jsonContent, z } from "@/framework/facade.js";
-import { authMiddleware } from "@/middlewares/auth-middleware.js";
-import { list, markAllRead, markRead, remove, unreadCount } from "../controllers/{{module}}.controller.js";
-import { PaginatedNotificationsSchema, UnreadCountSchema } from "../controllers/{{module}}.schema.js";
-
-const listRoute = createRoute({
-  path: "/",
-  method: "get",
-  tags: ["Notifications"],
-  responses: { [HttpStatusCodes.OK]: jsonContent(PaginatedNotificationsSchema, "Paginated notifications") },
-});
-
-const unreadCountRoute = createRoute({
-  path: "/unread-count",
-  method: "get",
-  tags: ["Notifications"],
-  responses: { [HttpStatusCodes.OK]: jsonContent(UnreadCountSchema, "Unread count") },
-});
-
-const markReadRoute = createRoute({
-  path: "/{id}/read",
-  method: "patch",
-  tags: ["Notifications"],
-  request: { params: z.object({ id: z.coerce.number() }) },
-  responses: { [HttpStatusCodes.OK]: jsonContent(z.object({ ok: z.boolean() }), "Marked as read") },
-});
-
-const markAllReadRoute = createRoute({
-  path: "/read-all",
-  method: "patch",
-  tags: ["Notifications"],
-  responses: { [HttpStatusCodes.OK]: jsonContent(z.object({ ok: z.boolean() }), "All marked as read") },
-});
-
-const deleteRoute = createRoute({
-  path: "/{id}",
-  method: "delete",
-  tags: ["Notifications"],
-  request: { params: z.object({ id: z.coerce.number() }) },
-  responses: { [HttpStatusCodes.OK]: jsonContent(z.object({ ok: z.boolean() }), "Deleted") },
-});
-
-export default createRouter()
-  .group(authMiddleware)
-  .api(listRoute, list)
-  .api(unreadCountRoute, unreadCount)
-  .api(markReadRoute, markRead)
-  .api(markAllReadRoute, markAllRead)
-  .api(deleteRoute, remove);
-
+import { createRoute, createRouter, HttpStatusCodes, jsonContent, z } from "@/framework/facade.js";
+import { authMiddleware } from "@/middlewares/auth-middleware.js";
+import { list, markAllRead, markRead, remove, unreadCount } from "../controllers/{{module}}.js";
+import { PaginatedNotificationsSchema, UnreadCountSchema } from "../schemas/{{module}}.js";
+
+const listRoute = createRoute({
+  path: "/",
+  method: "get",
+  tags: ["Notifications"],
+  responses: { [HttpStatusCodes.OK]: jsonContent(PaginatedNotificationsSchema, "Paginated notifications") },
+});
+
+const unreadCountRoute = createRoute({
+  path: "/unread-count",
+  method: "get",
+  tags: ["Notifications"],
+  responses: { [HttpStatusCodes.OK]: jsonContent(UnreadCountSchema, "Unread count") },
+});
+
+const markReadRoute = createRoute({
+  path: "/{id}/read",
+  method: "patch",
+  tags: ["Notifications"],
+  request: { params: z.object({ id: z.coerce.number() }) },
+  responses: { [HttpStatusCodes.OK]: jsonContent(z.object({ ok: z.boolean() }), "Marked as read") },
+});
+
+const markAllReadRoute = createRoute({
+  path: "/read-all",
+  method: "patch",
+  tags: ["Notifications"],
+  responses: { [HttpStatusCodes.OK]: jsonContent(z.object({ ok: z.boolean() }), "All marked as read") },
+});
+
+const deleteRoute = createRoute({
+  path: "/{id}",
+  method: "delete",
+  tags: ["Notifications"],
+  request: { params: z.object({ id: z.coerce.number() }) },
+  responses: { [HttpStatusCodes.OK]: jsonContent(z.object({ ok: z.boolean() }), "Deleted") },
+});
+
+export default createRouter()
+  .group(authMiddleware)
+  .api(listRoute, list)
+  .api(unreadCountRoute, unreadCount)
+  .api(markReadRoute, markRead)
+  .api(markAllReadRoute, markAllRead)
+  .api(deleteRoute, remove);
+

package/express/src/framework/maker-cli/stubs/notification/route.plain.ts.stub

@@ -1,12 +1,12 @@
-import { group } from "@/framework/facade.js";
-import { authMiddleware } from "@/middlewares/auth-middleware.js";
-import { list, unreadCount, markRead, markAllRead, remove } from "../controllers/{{module}}.controller.js";
-
-export default group()
-  .use(authMiddleware)
-  .get("/", list)
-  .get("/unread-count", unreadCount)
-  .patch("/:id/read", markRead)
-  .patch("/read-all", markAllRead)
-  .delete("/:id", remove);
+import { group } from "@/framework/facade.js";
+import { authMiddleware } from "@/middlewares/auth-middleware.js";
+import { list, unreadCount, markRead, markAllRead, remove } from "../controllers/{{module}}.js";
+
+export default group()
+  .use(authMiddleware)
+  .get("/", list)
+  .get("/unread-count", unreadCount)
+  .patch("/:id/read", markRead)
+  .patch("/read-all", markAllRead)
+  .delete("/:id", remove);
 

package/express/src/framework/maker-cli/stubs/route/api.ts.stub

@@ -1,80 +1,94 @@
-import { createRoute, group, HttpStatusCodes, jsonContent } from "@/framework/facade.js";
-import { requireRole } from "@/middlewares/role-middleware.js";
-import { destroy, index, show, store, update } from "@/modules/{{module}}/controllers/{{controller}}.controller.js";
-import {
-  Create{{ClassName}}Schema,
-  {{ClassName}}IdParamsSchema,
-  {{ClassName}}ListResponseSchema,
-  {{ClassName}}MessageSchema,
-  {{ClassName}}ResponseSchema,
-  Update{{ClassName}}Schema
-} from "@/modules/{{module}}/controllers/{{controller}}.schema.js";
-
-const indexRoute = createRoute({
-  path: "/",
-  method: "get",
-  tags: ["{{ModuleClass}}"],
-  responses: {
-    [HttpStatusCodes.OK]: jsonContent({{ClassName}}ListResponseSchema, "{{module}} list")
-  }
-});
-
-const showRoute = createRoute({
-  path: "/{id}",
-  method: "get",
-  tags: ["{{ModuleClass}}"],
-  request: {
-    params: {{ClassName}}IdParamsSchema
-  },
-  responses: {
-    [HttpStatusCodes.OK]: jsonContent({{ClassName}}ResponseSchema, "{{module}} item"),
-    [HttpStatusCodes.NOT_FOUND]: jsonContent({{ClassName}}MessageSchema, "Not found")
-  }
-});
-
-const storeRoute = createRoute({
-  path: "/",
-  method: "post",
-  tags: ["{{ModuleClass}}"],
-  request: {
-    body: jsonContent(Create{{ClassName}}Schema, "Create {{module}} payload")
-  },
-  responses: {
-    [HttpStatusCodes.CREATED]: jsonContent({{ClassName}}MessageSchema, "Created")
-  }
-});
-
-const updateRoute = createRoute({
-  path: "/{id}",
-  method: "put",
-  tags: ["{{ModuleClass}}"],
-  request: {
-    params: {{ClassName}}IdParamsSchema,
-    body: jsonContent(Update{{ClassName}}Schema, "Update {{module}} payload")
-  },
-  responses: {
-    [HttpStatusCodes.OK]: jsonContent({{ClassName}}MessageSchema, "Updated"),
-    [HttpStatusCodes.NOT_FOUND]: jsonContent({{ClassName}}MessageSchema, "Not found")
-  }
-});
-
-const destroyRoute = createRoute({
-  path: "/{id}",
-  method: "delete",
-  tags: ["{{ModuleClass}}"],
-  request: {
-    params: {{ClassName}}IdParamsSchema
-  },
-  responses: {
-    [HttpStatusCodes.OK]: jsonContent({{ClassName}}MessageSchema, "Deleted"),
-    [HttpStatusCodes.NOT_FOUND]: jsonContent({{ClassName}}MessageSchema, "Not found")
-  }
-});
-
-export default group()
-  .api(indexRoute, index)
-  .api(showRoute, show)
-  .api(storeRoute, store)
-  .api(updateRoute, update)
-  .api(destroyRoute, destroy);
+import { createRoute, group, HttpStatusCodes, jsonContent } from "@/framework/facade.js";
+import { authMiddleware } from "@/middlewares/auth-middleware.js";
+import { requireRole } from "@/middlewares/role-middleware.js";
+import { destroy, index, show, store, update } from "@/modules/{{module}}/controllers/{{controller}}.js";
+import {
+  Create{{ClassName}}Schema,
+  {{ClassName}}IdParamsSchema,
+  {{ClassName}}ListResponseSchema,
+  {{ClassName}}MessageSchema,
+  {{ClassName}}ResponseSchema,
+  Update{{ClassName}}Schema
+} from "@/modules/{{module}}/schemas/{{controller}}.js";
+
+const indexRoute = createRoute({
+  path: "/",
+  method: "get",
+  tags: ["{{ModuleClass}}"],
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent({{ClassName}}ListResponseSchema, "{{module}} list")
+  }
+});
+
+const showRoute = createRoute({
+  path: "/{id}",
+  method: "get",
+  tags: ["{{ModuleClass}}"],
+  request: {
+    params: {{ClassName}}IdParamsSchema
+  },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent({{ClassName}}ResponseSchema, "{{module}} item"),
+    [HttpStatusCodes.NOT_FOUND]: jsonContent({{ClassName}}MessageSchema, "Not found")
+  }
+});
+
+const storeRoute = createRoute({
+  path: "/",
+  method: "post",
+  tags: ["{{ModuleClass}}"],
+  request: {
+    body: jsonContent(Create{{ClassName}}Schema, "Create {{module}} payload")
+  },
+  responses: {
+    [HttpStatusCodes.CREATED]: jsonContent({{ClassName}}MessageSchema, "Created")
+  }
+});
+
+const updateRoute = createRoute({
+  path: "/{id}",
+  method: "put",
+  tags: ["{{ModuleClass}}"],
+  request: {
+    params: {{ClassName}}IdParamsSchema,
+    body: jsonContent(Update{{ClassName}}Schema, "Update {{module}} payload")
+  },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent({{ClassName}}MessageSchema, "Updated"),
+    [HttpStatusCodes.NOT_FOUND]: jsonContent({{ClassName}}MessageSchema, "Not found")
+  }
+});
+
+const destroyRoute = createRoute({
+  path: "/{id}",
+  method: "delete",
+  tags: ["{{ModuleClass}}"],
+  request: {
+    params: {{ClassName}}IdParamsSchema
+  },
+  responses: {
+    [HttpStatusCodes.OK]: jsonContent({{ClassName}}MessageSchema, "Deleted"),
+    [HttpStatusCodes.NOT_FOUND]: jsonContent({{ClassName}}MessageSchema, "Not found")
+  }
+});
+
+export default group()
+  .api(indexRoute, index)
+  .api(showRoute, show)
+  .api(storeRoute, store)
+  .api(updateRoute, update)
+  .api(destroyRoute, destroy);
+
+// Gate the whole group (authMiddleware resolves the session once for every route):
+//   export default group(authMiddleware).api(indexRoute, index) ...
+//
+// Or gate a single route by role. requireRole reads the role authMiddleware set,
+// so authMiddleware must run first:
+//   group().api(destroyRoute, [authMiddleware, requireRole("admin")], destroy)
+//
+// Or group all authMiddleware and set single requireRole middleware
+// so authMiddleware must run on all chain and requireRole single on per route:
+//   group(authMiddleware).api(destroyRoute, [requireRole("admin")], destroy)
+//
+// Delete the imports above when you do not need them.
 

package/express/src/framework/maker-cli/stubs/route/plain.ts.stub

@@ -1,11 +1,24 @@
-import { group } from "@/framework/facade.js";
-import { requireRole } from "@/middlewares/role-middleware.js";
-import { index, show, store, update, destroy } from "@/modules/{{module}}/controllers/{{controller}}.controller.js";
-
-export default group()
-  .get("/", index)
-  .get("/:id", show)
-  .post("/", store)
-  .put("/:id", update)
-  .delete("/:id", destroy);
+import { group } from "@/framework/facade.js";
+import { authMiddleware } from "@/middlewares/auth-middleware.js";
+import { requireRole } from "@/middlewares/role-middleware.js";
+import { index, show, store, update, destroy } from "@/modules/{{module}}/controllers/{{controller}}.js";
 
+export default group()
+  .get("/", index)
+  .get("/:id", show)
+  .post("/", store)
+  .put("/:id", update)
+  .delete("/:id", destroy);
+
+// Gate the whole group (authMiddleware resolves the session once for every route):
+//   export default group(authMiddleware).api(indexRoute, index) ...
+//
+// Or gate a single route by role. requireRole reads the role authMiddleware set,
+// so authMiddleware must run first:
+//   group().api(destroyRoute, [authMiddleware, requireRole("admin")], destroy)
+//
+// Or group all authMiddleware and set single requireRole middleware
+// so authMiddleware must run on all chain and requireRole single on per route:
+//   group(authMiddleware).api(destroyRoute, [requireRole("admin")], destroy)
+//
+// Delete the imports above when you do not need them.