create-nexwire 4.2.5 → 4.4.0

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

@@ -0,0 +1,67 @@
+import { eq } from "drizzle-orm";
+import { db } from "@/framework/facade.js";
+
+/**
+ * Why: Returns every {{controller}} row for list screens.
+ * When: Called by the controller's index() handler.
+ * Where: GET /{{controller}} route.
+ *
+ * TODO: import your model and query it, for example:
+ *   import { {{tableVariable}} } from "@/modules/{{module}}/database/models/{{controller}}.js";
+ *   return db.select().from({{tableVariable}});
+ */
+export const {{ServiceName}} = {  
+  /**
+  * Why: CRUD service for {{controller}}.
+  * When: Consumed directly by the controller as `{{ServiceName}}.list()`, etc.
+  * Where: Wired into the module's controller handlers.
+  */
+  list: async () => {
+    void db;
+    return [];
+  },
+
+  /**
+   * Why: Returns one {{controller}} row by primary key.
+   * When: Called by the controller's show/update/destroy handlers.
+   * Where: Reused across GET/PUT/DELETE /{{controller}}/{id} routes.
+   *
+   * TODO: query the model by id and return the row, or null when missing.
+   */
+  findOne: async (_id: number) => {
+    return null;
+  },
+
+  /**
+   * Why: Persists a new {{controller}} row.
+   * When: Called by the controller's store() handler.
+   * Where: POST /{{controller}} route.
+   *
+   * TODO: insert the validated payload and return the created row.
+   */
+  create: async (_data: Record<string, unknown>) => {
+    return null;
+  },
+
+  /**
+   * Why: Applies a partial change to one {{controller}} row.
+   * When: Called by the controller's update() handler.
+   * Where: PUT/PATCH /{{controller}}/{id} route.
+   *
+   * TODO: update by id, refresh updatedAt, and return the row, or null when missing.
+   */
+  update: async (_id: number, _data: Record<string, unknown>) => {
+    return null;
+  },
+
+  /**
+   * Why: Removes one {{controller}} row.
+   * When: Called by the controller's destroy() handler.
+   * Where: DELETE /{{controller}}/{id} route.
+   *
+   * TODO: delete by id and return the removed row, or null when missing.
+   */
+  remove: async (_id: number) => {
+    return null;
+  },
+};

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

@@ -0,0 +1,65 @@
+import { eq } from "drizzle-orm";
+import { db } from "@/framework/facade.js";
+import { {{tableVariable}} } from "@/modules/{{module}}/database/models/{{controller}}.js";
+
+export const {{ServiceName}} = {
+  /**
+   * Why: Returns every {{controller}} row for list screens.
+   * When: Called by the controller's index() handler.
+   * Where: GET /{{controller}} route.
+   */
+  list: async () => {
+    return db.select().from({{tableVariable}});
+  },
+
+  /**
+   * Why: Returns one {{controller}} row by primary key.
+   * When: Called by the controller's show/update/destroy handlers.
+   * Where: Reused across GET/PUT/DELETE /{{controller}}/{id} routes.
+   */
+  findOne: async (id: number) => {
+    const [row] = await db
+      .select()
+      .from({{tableVariable}})
+      .where(eq({{tableVariable}}.id, id))
+      .limit(1);
+    return row ?? null;
+  },
+
+  /**
+   * Why: Persists a new {{controller}} row.
+   * When: Called by the controller's store() handler.
+   * Where: POST /{{controller}} route.
+   */
+  create: async (data: Record<string, unknown>) => {
+    const [row] = await db.insert({{tableVariable}}).values(data).returning();
+    return row;
+  },
+
+  /**
+   * Why: Applies a partial change to one {{controller}} row.
+   * When: Called by the controller's update() handler.
+   * Where: PUT/PATCH /{{controller}}/{id} route.
+   */
+  update: async (id: number, data: Record<string, unknown>) => {
+    const [row] = await db
+      .update({{tableVariable}})
+      .set(data)
+      .where(eq({{tableVariable}}.id, id))
+      .returning();
+    return row ?? null;
+  },
+
+  /**
+   * Why: Removes one {{controller}} row.
+   * When: Called by the controller's destroy() handler.
+   * Where: DELETE /{{controller}}/{id} route.
+   */
+  remove: async (id: number) => {
+    const [row] = await db
+      .delete({{tableVariable}})
+      .where(eq({{tableVariable}}.id, id))
+      .returning();
+    return row ?? null;
+  },
+};

package/fastify/src/framework/maker-cli/stubs/test/unit.ts.stub

@@ -0,0 +1,22 @@
+import { describe, expect, it } from "vitest";
+
+describe("{{module}}.{{name}}", () => {
+  it("should return true for basic assertion", () => {
+    expect(true).toBe(true);
+  });
+
+  it("should handle string operations", () => {
+    const name = "{{module}}";
+    expect(name).toBe("{{module}}");
+    expect(name.length).toBeGreaterThan(0);
+  });
+
+  it("should handle array operations", () => {
+    const items = ["item1", "item2", "item3"];
+    expect(items).toHaveLength(3);
+    expect(items).toContain("item1");
+  });
+
+  // Add your test cases below
+});
+

package/fastify/src/framework/maker-cli/stubs/type/name.ts.stub

@@ -0,0 +1,22 @@
+/**
+ * Why: Shared TypeScript types for the {{module}} module.
+ * When: Needed by controllers, services, or helpers that must agree on a shape.
+ * Where: src/modules/{{module}}/types/{{name}}.ts
+ */
+
+/** Why: Base shape for every {{name}} record. When: Used as a constraint or return type. Where: This file. */
+export interface {{Name}}Record {
+  id: number;
+}
+
+/** Why: Result shape for a single-item response. When: Returned by show-style handlers. Where: This file. */
+export interface {{Name}}Result {
+  message: string;
+  data: {{Name}}Record;
+}
+
+/** Why: Result shape for list responses. When: Returned by index-style handlers. Where: This file. */
+export interface {{Name}}ListResult {
+  message: string;
+  data: {{Name}}Record[];
+}

package/fastify/src/framework/maker-cli/utils/env-config.mjs

@@ -0,0 +1,44 @@
+import { spawnSync } from "node:child_process";
+
+/** Read CLI-relevant values from the TS config via a one-shot tsx eval.
+ *  Keeps the dev runner's defaults (queues, maildev ports, redis-view port)
+ *  driven by src/config instead of hardcoded/duplicated values. Falls back to
+ *  the previous defaults when the config cannot be loaded. */
+export function readCliConfig() {
+  const script = [
+    "import { queueConfig, mailConfig, redisConfig } from './src/config/index.ts';",
+    "process.stdout.write(JSON.stringify({",
+    "  queues: queueConfig.queues,",
+    "  maildev: mailConfig.maildev,",
+    "  commanderPort: redisConfig.commanderPort,",
+    "  redisEnabled: redisConfig.enabled",
+    "}));"
+  ].join("");
+  const result = spawnSync(process.execPath, ["--import", "tsx", "--input-type=module", "--eval", script], {
+    cwd: process.cwd(),
+    encoding: "utf8",
+    timeout: 30000,
+    windowsHide: true,
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+
+  if (result.status !== 0 || !result.stdout) {
+    return {
+      queues: ["default", "mail", "maintenance"],
+      maildev: { smtpPort: 1089, webPort: 1080 },
+      commanderPort: 1369,
+      redisEnabled: true
+    };
+  }
+
+  try {
+    return JSON.parse(result.stdout);
+  } catch {
+    return {
+      queues: ["default", "mail", "maintenance"],
+      maildev: { smtpPort: 1089, webPort: 1080 },
+      commanderPort: 1369,
+      redisEnabled: true
+    };
+  }
+}

package/fastify/src/framework/maker-cli/utils/env-db.mjs

@@ -0,0 +1,61 @@
+const DEFAULT_DATABASE_URL = "sqlite:./src/storage/database/nexwire.sqlite";
+
+/** Detect current DB dialect from DATABASE_URL (sqlite/mysql/postgresql). Falls back to sqlite. */
+export function detectDialect() {
+  const url = String(process.env.DATABASE_URL || DEFAULT_DATABASE_URL).toLowerCase();
+  if (url.startsWith("mysql") || url.startsWith("mariadb")) return "mysql";
+  if (url.startsWith("postgres") || url.startsWith("postgresql")) return "postgresql";
+  return "sqlite";
+}
+
+/** Return the raw DATABASE_URL string or the default sqlite fallback. */
+export function databaseUrl() {
+  return String(process.env.DATABASE_URL || DEFAULT_DATABASE_URL);
+}
+
+/** Parse DATABASE_URL into a URL object. Returns null if invalid. */
+export function parsedDatabaseUrl() {
+  try {
+    return new URL(databaseUrl());
+  } catch {
+    return null;
+  }
+}
+
+/** Extract the database name from the pathname of a parsed DATABASE_URL. */
+export function databaseNameFromUrl(url) {
+  const pathname = String(url?.pathname || "").replace(/^\/+/, "");
+  return pathname ? decodeURIComponent(pathname) : "";
+}
+
+/** Check if OPEN_API env is enabled (defaults to true). */
+export function openApiEnabled() {
+  const value = String(process.env.OPEN_API ?? "true")
+    .trim()
+    .toLowerCase();
+  return value !== "false" && value !== "0" && value !== "no";
+}
+
+/** Check if REDIS env is enabled (defaults to false). Matches Zod transform in env.ts. */
+export function redisEnabled() {
+  const value = String(process.env.REDIS ?? "false")
+    .trim()
+    .toLowerCase();
+  return value !== "false" && value !== "0";
+}
+
+/** Detect DB dialect for deploy context (uses raw DATABASE_URL or explicit URL). */
+export function detectDeployDatabase(urlOverride) {
+  const url = String(urlOverride || process.env.DATABASE_URL || "").toLowerCase();
+  if (url.startsWith("mysql") || url.startsWith("mariadb")) return "mysql";
+  if (url.startsWith("postgres") || url.startsWith("postgresql")) return "postgres";
+  return "sqlite";
+}
+
+/** Convert a sqlite:// URL to a filesystem path. */
+export function sqlitePathFromUrl(url) {
+  if (url.startsWith("sqlite:///")) return url.replace("sqlite:///", "/");
+  if (url.startsWith("sqlite://")) return url.replace("sqlite://", "");
+  if (url.startsWith("sqlite:")) return url.replace("sqlite:", "");
+  return url;
+}

package/fastify/src/framework/maker-cli/utils/file-ops.mjs

@@ -0,0 +1,30 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+
+/** Write a file only if it does not already exist. Returns true if created. */
+export async function writeFileIfMissing(filePath, content) {
+  try {
+    await fs.access(filePath);
+    console.log(`Skipped existing: ${path.relative(process.cwd(), filePath)}`);
+    return false;
+  } catch {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, content);
+    console.log(`Created: ${path.relative(process.cwd(), filePath)}`);
+    return true;
+  }
+}
+
+/** Write a file, overwriting if it exists. */
+export async function writeFileAlways(filePath, content) {
+  await fs.mkdir(path.dirname(filePath), { recursive: true });
+  await fs.writeFile(filePath, content);
+  console.log(`Updated: ${path.relative(process.cwd(), filePath)}`);
+}
+
+/** Write multiple files under a root directory using writeFileAlways. */
+export async function writeFiles(root, files) {
+  for (const [relativePath, content] of Object.entries(files)) {
+    await writeFileAlways(path.join(root, relativePath), content);
+  }
+}

package/fastify/src/framework/maker-cli/utils/flags.mjs

@@ -0,0 +1,14 @@
+/** Check if a specific flag name exists in the flags array. */
+export function hasFlag(flags, name) {
+  return flags.includes(name);
+}
+
+/** Extract the value of a --key=value flag from the flags array. Returns fallback if not found. */
+export function getOption(flags = [], name, fallback = "") {
+  const item = flags.find((flag) => flag.startsWith(`${name}=`));
+  return item ? item.slice(name.length + 1) : fallback;
+}
+
+export function stripWorkflowFlags(flags = []) {
+  return flags.filter((flag) => !["--server-only", "--app-only", "--refresh", "--dry-run"].includes(flag) && !flag.startsWith("--config="));
+}