create-nexwire 4.0.0

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

@@ -0,0 +1,18 @@
+import { group } from "@/framework/facade.js";
+import { downloadGenerated, downloadGeneratedExcel, downloadGeneratedPdf, fire, fireBroadcast, fireQueued, fireQueuedBroadcast, generateDownload, generateExcelDownload, generatePdfDownload, importExcel, queueCommand, upload } from "@/modules/{{module}}/controllers/{{module}}.controller.js";
+
+export default group()
+  .post("/event", fire)
+  .post("/queue/command", queueCommand)
+  .post("/event/queued", fireQueued)
+  .post("/event/queued-broadcast", fireQueuedBroadcast)
+  .post("/event/broadcast", fireBroadcast)
+  .post("/upload", upload)
+  .post("/import/excel", importExcel)
+  .post("/download/generate", generateDownload)
+  .get("/download/:token", downloadGenerated)
+  .post("/download/excel/generate", generateExcelDownload)
+  .get("/download/excel/:token", downloadGeneratedExcel)
+  .post("/download/pdf/generate", generatePdfDownload)
+  .get("/download/pdf/:requestId", downloadGeneratedPdf);
+

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

@@ -0,0 +1,42 @@
+import { z } from "@/framework/facade.js";
+
+export const ExampleEventSchema = z.object({
+  message: z.string(),
+  waitSeconds: z.number().optional()
+});
+
+export const UploadResponseSchema = z.object({
+  message: z.string(),
+  path: z.string(),
+  url: z.string()
+});
+
+export const DownloadTokenSchema = z.object({
+  message: z.string(),
+  token: z.string(),
+  downloadUrl: z.string()
+});
+
+export const ExcelDownloadRequestSchema = z.object({
+  title: z.string().min(2).max(100).default("Example Report")
+});
+
+export const QueueCommandRequestSchema = z.object({
+  message: z.string(),
+  waitSeconds: z.number().optional()
+});
+
+export const PdfGenerateRequestSchema = z.object({
+  title: z.string().min(2).max(100).default("Example PDF Report"),
+  rows: z.number().int().min(50).max(20000).default(1000),
+  chunkSize: z.number().int().min(50).max(1000).default(250)
+});
+
+export const PdfGenerateAcceptedSchema = z.object({
+  message: z.string(),
+  requestId: z.string(),
+  mode: z.enum(["queued", "inline"]),
+  statusUrl: z.string(),
+  downloadUrl: z.string()
+});
+

package/express/src/framework/maker-cli/stubs/example/schema.ts.stub

@@ -0,0 +1,42 @@
+import { z } from "zod";
+
+export const ExampleEventSchema = z.object({
+  message: z.string(),
+  waitSeconds: z.number().optional()
+});
+
+export const UploadResponseSchema = z.object({
+  message: z.string(),
+  path: z.string(),
+  url: z.string()
+});
+
+export const DownloadTokenSchema = z.object({
+  message: z.string(),
+  token: z.string(),
+  downloadUrl: z.string()
+});
+
+export const ExcelDownloadRequestSchema = z.object({
+  title: z.string().min(2).max(100).default("Example Report")
+});
+
+export const QueueCommandRequestSchema = z.object({
+  message: z.string(),
+  waitSeconds: z.number().optional()
+});
+
+export const PdfGenerateRequestSchema = z.object({
+  title: z.string().min(2).max(100).default("Example PDF Report"),
+  rows: z.number().int().min(50).max(20000).default(1000),
+  chunkSize: z.number().int().min(50).max(1000).default(250)
+});
+
+export const PdfGenerateAcceptedSchema = z.object({
+  message: z.string(),
+  requestId: z.string(),
+  mode: z.enum(["queued", "inline"]),
+  statusUrl: z.string(),
+  downloadUrl: z.string()
+});
+

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

@@ -0,0 +1,25 @@
+import { DateTime } from "luxon";
+import { dispatchEvent, shouldQueue } from "@/framework/facade.js";
+
+/**
+ * event: Event name this worker listens to.
+ * queue: Queue name where jobs are consumed from.
+ * handler: Async processor that receives `job.data`.
+ */
+shouldQueue("{{module}}.{{name}}", "default", async job => {
+  console.log("{{module}}.{{name}}", job.data);
+
+  /**
+   * dispatchEvent name: Event id to publish to listeners.
+   * payload: Data sent to queue/broadcast consumers.
+   * queue: Optional queue target for async event consumers.
+   * broadcast: Optional realtime fanout (all/users/roles/rooms).
+   */
+  // await dispatchEvent("{{module}}.{{name}}.finished", {
+  //   ...job.data,
+  //   processedAt: DateTime.now(),
+  // });
+
+  return { ok: true, processedAt: DateTime.now().toISO() };
+});
+

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

@@ -0,0 +1,14 @@
+import type { NextFunction, Request, Response } from "express";
+import { db } from "@/framework/facade.js";
+
+/**
+ * Why: Runs before route handlers to enforce cross-cutting rules for {{name}}.
+ * When: Attach to a route group or a specific route.
+ * Where: Add it to a group: group({{camel}}Middleware), or per route:
+ *        .api(route, [{{camel}}Middleware], handler)
+ * How: res.locals.auth is populated when authMiddleware ran first; db gives
+ *      typed access to your module models. Call next() to continue.
+ */
+export function {{camel}}Middleware(req: Request, res: Response, next: NextFunction) {
+  return next();
+}

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

@@ -0,0 +1,9 @@
+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()
+});
+

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

@@ -0,0 +1,9 @@
+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()
+});
+

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

@@ -0,0 +1,9 @@
+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()
+});
+

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

@@ -0,0 +1,77 @@
+import { and, count, desc, eq, sql } from "drizzle-orm";
+import type { Request, Response } from "express";
+import { db } from "@/framework/facade.js";
+import { notifications } from "@/modules/auth/database/models/notifications.js";
+
+type AuthRequest = Request & { auth: { id: number } };
+
+export const list = async (req: AuthRequest, res: Response) => {
+  const userId = req.auth.id;
+  const page = Math.max(1, Number(req.query.page) || 1);
+  const perPage = Math.min(50, Math.max(1, Number(req.query.perPage) || 20));
+
+  const unread = await db.select({ count: count() }).from(notifications)
+    .where(and(eq(notifications.userId, userId), sql`${notifications.readAt} IS NULL`));
+  const total = await db.select({ count: count() }).from(notifications)
+    .where(eq(notifications.userId, userId));
+  const rows = await db.select().from(notifications)
+    .where(eq(notifications.userId, userId))
+    .orderBy(desc(notifications.createdAt))
+    .limit(perPage)
+    .offset((page - 1) * perPage);
+
+  res.json({
+    data: rows.map(normalize),
+    total: total[0].count,
+    unread: unread[0].count,
+    page,
+    perPage
+  });
+};
+
+export const unreadCount = async (req: AuthRequest, res: Response) => {
+  const userId = req.auth.id;
+  const rows = await db.select({ count: count() }).from(notifications)
+    .where(and(eq(notifications.userId, userId), sql`${notifications.readAt} IS NULL`));
+  res.json({ count: rows[0].count });
+};
+
+export const markRead = async (req: AuthRequest, res: Response) => {
+  const id = Number(req.params.id);
+  await db.update(notifications)
+    .set({ readAt: sql`now()` })
+    .where(and(eq(notifications.id, id), eq(notifications.userId, req.auth.id)));
+  res.json({ ok: true });
+};
+
+export const markAllRead = async (req: AuthRequest, res: Response) => {
+  await db.update(notifications)
+    .set({ readAt: sql`now()` })
+    .where(and(eq(notifications.userId, req.auth.id), sql`${notifications.readAt} IS NULL`));
+  res.json({ ok: true });
+};
+
+export const remove = async (req: AuthRequest, res: Response) => {
+  const id = Number(req.params.id);
+  await db.delete(notifications)
+    .where(and(eq(notifications.id, id), eq(notifications.userId, req.auth.id)));
+  res.json({ ok: true });
+};
+
+function normalize(row: typeof notifications.$inferSelect) {
+  let parsed: unknown = null;
+  if (row.data) {
+    try { parsed = JSON.parse(row.data); } catch {}
+  }
+  return {
+    id: row.id,
+    userId: row.userId,
+    type: row.type,
+    title: row.title,
+    body: row.body,
+    data: parsed,
+    link: row.link,
+    readAt: row.readAt?.toISOString() || null,
+    createdAt: row.createdAt.toISOString(),
+  };
+}

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

@@ -0,0 +1,13 @@
+import { shouldQueue } from "@/framework/queue/queue.js";
+import { logger } from "@/framework/support/logger.js";
+import { mail } from "@/framework/support/mail.js";
+
+shouldQueue("{{module}}:mail", "mail", async (job) => {
+  const { to, subject, html } = job.data;
+
+  await mail.sendMail({ to, subject, html });
+  logger.info("Notification mail sent", { to, subject });
+
+  return { ok: true };
+});
+

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

@@ -0,0 +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);
+

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

@@ -0,0 +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);
+

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

@@ -0,0 +1,26 @@
+import { z } from "@/framework/facade.js";
+
+export const NotificationSchema = z.object({
+  id: z.number(),
+  userId: z.number(),
+  type: z.string(),
+  title: z.string(),
+  body: z.string().nullable(),
+  data: z.any().nullable(),
+  link: z.string().nullable(),
+  readAt: z.string().nullable(),
+  createdAt: z.string(),
+});
+
+export const UnreadCountSchema = z.object({
+  count: z.number(),
+});
+
+export const PaginatedNotificationsSchema = z.object({
+  data: z.array(NotificationSchema),
+  total: z.number(),
+  unread: z.number(),
+  page: z.number(),
+  perPage: z.number(),
+});
+

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

@@ -0,0 +1,26 @@
+import { z } from "zod";
+
+export const NotificationSchema = z.object({
+  id: z.number(),
+  userId: z.number(),
+  type: z.string(),
+  title: z.string(),
+  body: z.string().nullable(),
+  data: z.any().nullable(),
+  link: z.string().nullable(),
+  readAt: z.string().nullable(),
+  createdAt: z.string(),
+});
+
+export const UnreadCountSchema = z.object({
+  count: z.number(),
+});
+
+export const PaginatedNotificationsSchema = z.object({
+  data: z.array(NotificationSchema),
+  total: z.number(),
+  unread: z.number(),
+  page: z.number(),
+  perPage: z.number(),
+});
+

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

@@ -0,0 +1,80 @@
+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);
+

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

@@ -0,0 +1,11 @@
+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);
+

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

@@ -0,0 +1,36 @@
+import { DateTime } from "luxon";
+import { defineSchedule, dispatchEvent } from "@/framework/facade.js";
+
+/**
+ * name: Unique schedule id used as the distributed lock key.
+ * expression: Cron expression that controls when the task runs.
+ * timezone: IANA timezone for cron evaluation (example: "UTC").
+ * runOnInit: Runs once immediately when scheduler starts.
+ * enabled: Enables or disables this schedule without deleting code.
+ * ttlMs: Lock TTL in milliseconds to avoid duplicate execution.
+ */
+defineSchedule({
+  name: "{{module}}:{{name}}",
+  expression: "0 * * * * *",
+  // timezone: "UTC",
+  // runOnInit: false,
+  // enabled: true,
+  // ttlMs: 120000,
+  handler: async () => {
+    /**
+     * dispatchEvent name: Event id to publish to listeners.
+     * payload: Data sent to queue/broadcast consumers.
+     * queue: Optional queue target for async event consumers.
+     * broadcast: Optional realtime fanout (all/users/roles/rooms).
+     */
+    // await dispatchEvent("{{module}}.{{name}}", {
+    //   origin: "scheduler",
+    //   createdAt: DateTime.now()
+    // }, {
+    //   queue: "default"
+    // });
+
+    DateTime.now().toISO();
+  }
+});
+

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

@@ -0,0 +1,20 @@
+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");
+}
+

package/express/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/express/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/express/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;
+}