create-nexwire 4.1.1 → 4.2.0

package/express/src/framework/maker-cli/runtime/index.mjs

@@ -1,104 +1,120 @@
-import { clearViteCache, runRuntime, runTest, runTestCoverage, runTestUI, runTestWatch, runUi, runVite } from "./core.mjs";
-
-/** Register runtime commands (dev, serve, queue, schedule, UI tools) on the CLI program. */
-export function registerRuntimeCommands(program, rawArgs) {
-  program
-    .command("dev")
-    .description("Start API + Vue 3 UI plus optional workers/tools")
-    .option("--view <tools>", "Comma-separated UI tools to launch (redis,maildev,studio)")
-    .option("--viewer <tools>", "Alias for --view (npm expands --view to --viewer)")
-    .option("--with <tools>", "Alias for --view")
-    .option("--with-redis-view", "Launch Redis Commander")
-    .option("--with-maildev", "Launch MailDev")
-    .option("--with-db-studio", "Launch Drizzle Studio")
-    .allowUnknownOption(true)
-    .action(async () => runRuntime("dev", rawArgs));
-  program
-    .command("serve")
-    .description("Start HTTP server (dist first if built, else src)")
-    .option("--prod", "Run production build")
-    .option("--runtime <name>", "Runtime: node or bun", "node")
-    .option("--watch", "Watch for file changes (src mode)")
-    .option("--src", "Force source mode even if dist exists")
-    .allowUnknownOption(true)
-    .action(async () => runRuntime("serve", rawArgs));
-  program
-    .command("queue:work")
-    .description("Start queue worker (dist first if built, else src)")
-    .option("--queue <name>", "Queue name", "default")
-    .option("--prod", "Run production build")
-    .option("--runtime <name>", "Runtime: node or bun", "node")
-    .option("--src", "Force source mode even if dist exists")
-    .allowUnknownOption(true)
-    .action(async () => runRuntime("queue:work", rawArgs));
-  program
-    .command("queue:clear")
-    .description("Clear all queue keys")
-    .allowUnknownOption(true)
-    .action(async () => runRuntime("queue:clear", rawArgs));
-  program
-    .command("schedule:work")
-    .description("Start scheduler worker (dist first if built, else src)")
-    .option("--prod", "Run production build")
-    .option("--runtime <name>", "Runtime: node or bun", "node")
-    .option("--src", "Force source mode even if dist exists")
-    .allowUnknownOption(true)
-    .action(async () => runRuntime("schedule:work", rawArgs));
-  program
-    .command("maildev:view")
-    .description("Start MailDev SMTP and web UI")
-    .allowUnknownOption(true)
-    .action(async () => runUi("maildev:view"));
-  program
-    .command("redis:view")
-    .description("Start Redis Commander UI")
-    .allowUnknownOption(true)
-    .action(async () => runUi("redis:view"));
-  program
-    .command("ui:dev")
-    .description("Start Vue 3 UI from src/resources")
-    .allowUnknownOption(true)
-    .action(async () => runVite("src/resources/vite.config.ts"));
-  program
-    .command("admin:dev")
-    .description("Start admin UI dev server")
-    .allowUnknownOption(true)
-    .action(async () => runVite("src/resources/vite.config.ts"));
-  program
-    .command("vite:cache:clear")
-    .description("Clear Vite cache folders (cross-platform)")
-    .allowUnknownOption(true)
-    .action(async () => clearViteCache());
-  program
-    .command("test")
-    .description("Run Vitest backend tests")
-    .allowUnknownOption(true)
-    .action(async () => {
-      const args = process.argv.slice(3);
-      await runTest(args);
-    });
-  program
-    .command("test:watch")
-    .description("Run Vitest backend tests in watch mode")
-    .allowUnknownOption(true)
-    .action(async () => {
-      const args = process.argv.slice(3);
-      await runTestWatch(args);
-    });
-  program
-    .command("test:coverage")
-    .description("Run Vitest backend tests with code coverage")
-    .allowUnknownOption(true)
-    .action(async () => {
-      const args = process.argv.slice(3);
-      await runTestCoverage(args);
-    });
-  program
-    .command("test:ui")
-    .description("Run Vitest backend tests in UI mode")
-    .allowUnknownOption(true)
-    .action(async () => {
-      const args = process.argv.slice(3);
-      await runTestUI(args);
-    });
-}
+import { clearViteCache, runRuntime, runTest, runTestCoverage, runTestUI, runTestWatch, runUi, runVite } from "./core.mjs";
+import { initProjectCommands, PROJECT_COMMANDS_PATH } from "../utils/project-commands.mjs";
+
+/** Register runtime commands (dev, serve, queue, schedule, UI tools) on the CLI program. */
+export function registerRuntimeCommands(program, rawArgs) {
+  program
+    .command("dev")
+    .description("Start API + Vue 3 UI plus optional workers/tools")
+    .option("--view <tools>", "Comma-separated UI tools to launch (redis,maildev,studio)")
+    .option("--viewer <tools>", "Alias for --view (npm expands --view to --viewer)")
+    .option("--with <tools>", "Alias for --view")
+    .option("--with-redis-view", "Launch Redis Commander")
+    .option("--with-maildev", "Launch MailDev")
+    .option("--with-db-studio", "Launch Drizzle Studio")
+    .allowUnknownOption(true)
+    .action(async () => runRuntime("dev", rawArgs));
+  program
+    .command("serve")
+    .description("Start HTTP server (dist first if built, else src)")
+    .option("--prod", "Run production build")
+    .option("--runtime <name>", "Runtime: node or bun", "node")
+    .option("--watch", "Watch for file changes (src mode)")
+    .option("--src", "Force source mode even if dist exists")
+    .allowUnknownOption(true)
+    .action(async () => runRuntime("serve", rawArgs));
+  program
+    .command("queue:work")
+    .description("Start queue worker (dist first if built, else src)")
+    .option("--queue <name>", "Queue name", "default")
+    .option("--prod", "Run production build")
+    .option("--runtime <name>", "Runtime: node or bun", "node")
+    .option("--src", "Force source mode even if dist exists")
+    .allowUnknownOption(true)
+    .action(async () => runRuntime("queue:work", rawArgs));
+  program
+    .command("queue:clear")
+    .description("Clear all queue keys")
+    .allowUnknownOption(true)
+    .action(async () => runRuntime("queue:clear", rawArgs));
+  program
+    .command("schedule:work")
+    .description("Start scheduler worker (dist first if built, else src)")
+    .option("--prod", "Run production build")
+    .option("--runtime <name>", "Runtime: node or bun", "node")
+    .option("--src", "Force source mode even if dist exists")
+    .allowUnknownOption(true)
+    .action(async () => runRuntime("schedule:work", rawArgs));
+  program
+    .command("maildev:view")
+    .description("Start MailDev SMTP and web UI")
+    .allowUnknownOption(true)
+    .action(async () => runUi("maildev:view"));
+  program
+    .command("redis:view")
+    .description("Start Redis Commander UI")
+    .allowUnknownOption(true)
+    .action(async () => runUi("redis:view"));
+  program
+    .command("ui:dev")
+    .description("Start Vue 3 UI from src/resources")
+    .allowUnknownOption(true)
+    .action(async () => runVite("src/resources/vite.config.ts"));
+  program
+    .command("admin:dev")
+    .description("Start admin UI dev server")
+    .allowUnknownOption(true)
+    .action(async () => runVite("src/resources/vite.config.ts"));
+  program
+    .command("vite:cache:clear")
+    .description("Clear Vite cache folders (cross-platform)")
+    .allowUnknownOption(true)
+    .action(async () => clearViteCache());
+  program
+    .command("maker:init")
+    .description(`Create ${PROJECT_COMMANDS_PATH} for your own commands`)
+    .option("--force", "Overwrite an existing file")
+    .allowUnknownOption(true)
+    .action(async (options) => {
+      const { created, overwritten } = await initProjectCommands(process.cwd(), { force: Boolean(options?.force) });
+      // created = written into a new file; overwritten = replaced under --force.
+      // Neither means the file was already there and was left alone.
+      console.log(
+        created || overwritten
+          ? `Add your commands to ${PROJECT_COMMANDS_PATH}, then run: maker --help`
+          : `${PROJECT_COMMANDS_PATH} already exists and was left alone. Edit it to add commands, or re-run with --force to replace it.`
+      );
+    });
+  program
+    .command("test")
+    .description("Run Vitest backend tests")
+    .allowUnknownOption(true)
+    .action(async () => {
+      const args = process.argv.slice(3);
+      await runTest(args);
+    });
+  program
+    .command("test:watch")
+    .description("Run Vitest backend tests in watch mode")
+    .allowUnknownOption(true)
+    .action(async () => {
+      const args = process.argv.slice(3);
+      await runTestWatch(args);
+    });
+  program
+    .command("test:coverage")
+    .description("Run Vitest backend tests with code coverage")
+    .allowUnknownOption(true)
+    .action(async () => {
+      const args = process.argv.slice(3);
+      await runTestCoverage(args);
+    });
+  program
+    .command("test:ui")
+    .description("Run Vitest backend tests in UI mode")
+    .allowUnknownOption(true)
+    .action(async () => {
+      const args = process.argv.slice(3);
+      await runTestUI(args);
+    });
+}

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

@@ -1,6 +1,6 @@
 import type { Request, Response } from "express";
 import { HttpStatusCodes } from "@/framework/facade.js";
-import { {{controller}}Service } from "@/modules/{{module}}/services/{{controller}}.js";
+import { {{ServiceName}} } from "@/modules/{{module}}/services/{{controller}}.js";
 
 /**
  * Why: Returns every {{controller}} row for list screens.
@@ -8,7 +8,7 @@ import { {{controller}}Service } from "@/modules/{{module}}/services/{{controlle
  * Where: GET /{{controller}} route.
  */
 export const index = async (_req: Request, res: Response) => {
-  const data = await {{controller}}Service.list();
+  const data = await {{ServiceName}}.list();
 
   res.json({ message: "{{controller}} list fetched successfully", data });
 };
@@ -19,7 +19,7 @@ export const index = async (_req: Request, res: Response) => {
  * Where: GET /{{controller}}/{id} route.
  */
 export const show = async (req: Request, res: Response) => {
-  const data = await {{controller}}Service.findOne(Number(req.params.id));
+  const data = await {{ServiceName}}.findOne(Number(req.params.id));
 
   if (!data) {
     res.status(HttpStatusCodes.NOT_FOUND).json({ message: "{{controller}} not found" });
@@ -35,7 +35,7 @@ export const show = async (req: Request, res: Response) => {
  * Where: POST /{{controller}} route.
  */
 export const store = async (req: Request, res: Response) => {
-  const data = await {{controller}}Service.create(req.body);
+  const data = await {{ServiceName}}.create(req.body);
 
   res.status(HttpStatusCodes.CREATED).json({ message: "{{controller}} created successfully", data });
 };
@@ -46,7 +46,7 @@ export const store = async (req: Request, res: Response) => {
  * Where: PUT/PATCH /{{controller}}/{id} route.
  */
 export const update = async (req: Request, res: Response) => {
-  const data = await {{controller}}Service.update(Number(req.params.id), req.body);
+  const data = await {{ServiceName}}.update(Number(req.params.id), req.body);
 
   if (!data) {
     res.status(HttpStatusCodes.NOT_FOUND).json({ message: "{{controller}} not found" });
@@ -62,7 +62,7 @@ export const update = async (req: Request, res: Response) => {
  * Where: DELETE /{{controller}}/{id} route.
  */
 export const destroy = async (req: Request, res: Response) => {
-  const data = await {{controller}}Service.remove(Number(req.params.id));
+  const data = await {{ServiceName}}.remove(Number(req.params.id));
 
   if (!data) {
     res.status(HttpStatusCodes.NOT_FOUND).json({ message: "{{controller}} not found" });

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

@@ -2,7 +2,7 @@ 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}}/schemas/{{controller}}.js";
-import { {{controller}}Service } from "@/modules/{{module}}/services/{{controller}}.js";
+import { {{ServiceName}} } from "@/modules/{{module}}/services/{{controller}}.js";
 
 /**
  * Why: Returns every {{controller}} row for list screens.
@@ -10,7 +10,7 @@ import { {{controller}}Service } from "@/modules/{{module}}/services/{{controlle
  * Where: GET /{{controller}} route.
  */
 export const index = async (_req: Request, res: Response) => {
-  const data = await {{controller}}Service.list();
+  const data = await {{ServiceName}}.list();
 
   res.json({ message: "{{controller}} list fetched successfully", data });
 };
@@ -22,7 +22,7 @@ export const index = async (_req: Request, res: Response) => {
  */
 export const show = async (req: Request, res: Response) => {
   const params = await validate({{ClassName}}IdParamsSchema, req.params);
-  const data = await {{controller}}Service.findOne(params.id);
+  const data = await {{ServiceName}}.findOne(params.id);
 
   if (!data) {
     res.status(HttpStatusCodes.NOT_FOUND).json({ message: "{{controller}} not found" });
@@ -39,7 +39,7 @@ export const show = async (req: Request, res: Response) => {
  */
 export const store = async (req: Request, res: Response) => {
   const body = await validate(Create{{ClassName}}Schema, req.body);
-  const data = await {{controller}}Service.create(body);
+  const data = await {{ServiceName}}.create(body);
 
   res.status(HttpStatusCodes.CREATED).json({ message: "{{controller}} created successfully", data });
 };
@@ -52,7 +52,7 @@ export const store = async (req: Request, res: Response) => {
 export const update = async (req: Request, res: Response) => {
   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);
+  const data = await {{ServiceName}}.update(params.id, body);
 
   if (!data) {
     res.status(HttpStatusCodes.NOT_FOUND).json({ message: "{{controller}} not found" });
@@ -69,7 +69,7 @@ export const update = async (req: Request, res: Response) => {
  */
 export const destroy = async (req: Request, res: Response) => {
   const params = await validate({{ClassName}}IdParamsSchema, req.params);
-  const data = await {{controller}}Service.remove(params.id);
+  const data = await {{ServiceName}}.remove(params.id);
 
   if (!data) {
     res.status(HttpStatusCodes.NOT_FOUND).json({ message: "{{controller}} not found" });

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

@@ -9,6 +9,6 @@
  * When: Replace this with real logic and rename it.
  * Where: Anywhere inside the {{module}} module.
  */
-export function {{name}}Helper<T>(value: T): T {
+export function {{Name}}Helper<T>(value: T): T {
   return value;
 }

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

@@ -1,20 +1,18 @@
-import { db } from "@/framework/facade.js";
-import { {{tableVariable}} } from "@/modules/{{module}}/database/models/{{name}}.js";
-
-export const table = {{tableVariable}};
-
-export default async function {{ClassName}}Seeder() {
-  const rows = [
-    // Add your seed data here
-    // Example:
-    // { name: "{{ClassName}} 1", description: "This is the first {{name}}" },
-    // { name: "{{ClassName}} 2", description: "This is the second {{name}}" }
-  ];
-
-  for (const row of rows) {
-    await db.insert({{tableVariable}}).values(row);
-  }
-
-  console.log("{{ClassName}} seeder completed");
-}
+import { db } from "@/framework/facade.js";
+import { {{tableVariable}} } from "@/modules/{{module}}/database/models/{{name}}.js";
+
+export const table = {{tableVariable}};
+
+export default async function {{ClassName}}Seeder() {
+  const rows = [
+    // Add your seed data here
+    // Example:
+    // { name: "{{ClassName}} 1", description: "This is the first {{name}}" },
+    // { name: "{{ClassName}} 2", description: "This is the second {{name}}" }
+  ];
+
+  for (const row of rows) await db.insert({{tableVariable}}).values(row);
+
+  console.log("{{ClassName}}: " + rows.length + " row(s) prepared");
+}
 

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

@@ -0,0 +1,22 @@
+/**
+ * Standalone seeder for "{{name}}" — no model of that name exists in module
+ * "{{module}}", so nothing was imported for you. Uncomment the two lines below,
+ * point them at the table you want, then add your rows.
+ *
+ * Run with: bun maker module:seed {{module}}
+ */
+
+import { db } from "@/framework/facade.js";
+// import { {{tableVariable}} } from "@/modules/{{module}}/database/models/{{name}}.js";
+// export const table = {{tableVariable}};
+
+export default async function {{ClassName}}Seeder() {
+  const rows: Record<string, unknown>[] = [
+    // { name: "{{ClassName}} 1" },
+    // { name: "{{ClassName}} 2" }
+  ];
+
+  // for (const row of rows) await db.insert({{tableVariable}}).values(row);
+
+  console.log("{{ClassName}}: " + rows.length + " row(s) ready");
+}

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

@@ -10,10 +10,10 @@ import { db } from "@/framework/facade.js";
  *   import { {{tableVariable}} } from "@/modules/{{module}}/database/models/{{controller}}.js";
  *   return db.select().from({{tableVariable}});
  */
-export const {{controller}}Service = {  
+export const {{ServiceName}} = {  
   /**
   * Why: CRUD service for {{controller}}.
-  * When: Consumed directly by the controller as `{{controller}}Service.list()`, etc.
+  * When: Consumed directly by the controller as `{{ServiceName}}.list()`, etc.
   * Where: Wired into the module's controller handlers.
   */
   list: async () => {

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

@@ -2,7 +2,7 @@ import { eq } from "drizzle-orm";
 import { db } from "@/framework/facade.js";
 import { {{tableVariable}} } from "@/modules/{{module}}/database/models/{{controller}}.js";
 
-export const {{controller}}Service = {
+export const {{ServiceName}} = {
   /**
    * Why: Returns every {{controller}} row for list screens.
    * When: Called by the controller's index() handler.