create-nexwire 4.2.4 → 4.3.0

package/README.md

@@ -27,22 +27,34 @@ nexwire ships that stack **already connected**. Auth reads the database. Enqueue
 
 ## Quick Start
 
-### Hono (default)
+### Choose a backend
+
+The CLI asks which backend to scaffold when you don't pass `--engine`:
 
 ```bash
 npm create nexwire@latest my-app
-cd my-app
-npm install
-npm run maker dev
 ```
 
-### Express
+```
+Choose a backend:
+❯ Hono      Hono-based HTTP layer and OpenAPI
+  Express   Express-based HTTP layer and OpenAPI
+```
+
+Arrow keys to move, `1`/`2` to jump, Enter to confirm. Press Enter to accept the default (**Hono**). Point at a specific one and the prompt is skipped:
 
 ```bash
+# Hono (default)
+npm create nexwire@latest my-app
+
+# Express
 npm create nexwire@latest my-app -- --engine=express
-cd my-app
-npm install
-npm run maker dev
+```
+
+For CI or scripts, `-y` / `--yes` skips every prompt and accepts the defaults (a project name is still required):
+
+```bash
+npm create nexwire@latest my-app -- --yes
 ```
 
 Your API is live at `http://localhost:3000`, Scalar docs at `/api-docs`, and the Vue frontend at `http://localhost:5173`.

package/express/.env

@@ -37,7 +37,7 @@ UI=true
 # Set true to enable OpenAPI / Scalar docs at /api-docs
 OPEN_API=true
 # Set false to disable Socket.IO realtime server
-SOCKET=true
+SOCKET=false
 # Set false to disable browser security headers (CSP, HSTS, X-Frame)
 SECURITY_HEADERS=true
 

package/express/.vscode/extensions.json

@@ -0,0 +1,6 @@
+{
+  "recommendations": [
+    "biomejs.biome",
+    "editorconfig.editorconfig"
+  ]
+}

package/express/.vscode/settings.json

@@ -1,26 +1,37 @@
-{
-  "editor.defaultFormatter": "biomejs.biome",
-  "[typescript]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[typescriptreact]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[javascript]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[javascriptreact]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[json]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "[jsonc]": {
-    "editor.defaultFormatter": "biomejs.biome"
-  },
-  "editor.codeActionsOnSave": {
-    "source.organizeImports.biome": "explicit",
-    "source.fixAll.biome": "explicit"
-  },
-  "files.eol": "\n"
-}
+{
+  "editor.defaultFormatter": "biomejs.biome",
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascript]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[json]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[vue]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[css]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "[scss]": {
+    "editor.defaultFormatter": "biomejs.biome"
+  },
+  "editor.codeActionsOnSave": {
+    "source.organizeImports.biome": "explicit",
+    "source.fixAll.biome": "explicit"
+  },
+  "files.eol": "\n",
+  "files.trimTrailingWhitespace": true,
+  "files.insertFinalNewline": true
+}

package/express/biome.json

@@ -1,66 +1,99 @@
-{
-  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
-  "vcs": {
-    "enabled": true,
-    "clientKind": "git",
-    "useIgnoreFile": true
-  },
-  "formatter": {
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 140,
-    "bracketSameLine": true
-  },
-  "linter": {
-    "rules": {
-      "preset": "recommended",
-      "correctness": {
-        "noUnusedVariables": "off",
-        "useVueValidTemplateRoot": "off",
-        "noUnusedImports": "off"
-      },
-      "complexity": {
-        "noUselessEscapeInRegex": "off"
-      },
-      "style": {
-        "noNonNullAssertion": "off",
-        "useVueMultiWordComponentNames": "off",
-        "useImportType": "off"
-      },
-      "suspicious": {
-        "noEmptyBlockStatements": "off",
-        "noExplicitAny": "off",
-        "noRedeclare": "off",
-        "noAssignInExpressions": "off",
-        "useIterableCallbackReturn": "off"
-      }
-    }
-  },
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "double",
-      "semicolons": "always",
-      "trailingCommas": "none"
-    }
-  },
-  "overrides": [
-    {
-      "includes": ["**/*.{js,mjs,cjs,ts,tsx,vue}"],
-      "javascript": {
-        "globals": ["exports", "location"]
-      }
-    }
-  ],
-  "assist": {
-    "actions": {
-      "source": {
-        "organizeImports": {
-          "level": "on",
-          "options": {
-            "groups": [":NODE:", ":PACKAGE:", ":ALIAS:", ":PATH:"]
-          }
-        }
-      }
-    }
-  }
-}
+{
+  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "html": {
+    "experimentalFullSupportEnabled": true,
+    "formatter": {
+      "enabled": true
+    }
+  },
+  "formatter": {
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 140,
+    "bracketSameLine": false
+  },
+  "files": {
+    "includes": [
+      "**",
+      "!**/node_modules"
+    ]
+  },
+  "linter": {
+    "rules": {
+      "preset": "recommended",
+      "a11y": {
+        "noLabelWithoutControl": "off",
+        "useButtonType": "off",
+        "useSemanticElements": "off",
+        "noStaticElementInteractions": "off",
+        "useKeyWithClickEvents": "off",
+        "useValidAnchor": "off",
+        "useAnchorContent": "off",
+        "noDistractingElements": "off"
+      },
+      "correctness": {
+        "noUnusedVariables": "off",
+        "useVueValidTemplateRoot": "off",
+        "noUnusedImports": "off"
+      },
+      "complexity": {
+        "noUselessEscapeInRegex": "off",
+        "noImportantStyles": "off"
+      },
+      "style": {
+        "noNonNullAssertion": "off",
+        "useVueMultiWordComponentNames": "off",
+        "useImportType": "off"
+      },
+      "suspicious": {
+        "noEmptyBlockStatements": "off",
+        "noExplicitAny": "off",
+        "noRedeclare": "off",
+        "noAssignInExpressions": "off",
+        "useIterableCallbackReturn": "off"
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "semicolons": "always",
+      "trailingCommas": "none"
+    }
+  },
+  "overrides": [
+    {
+      "includes": [
+        "**/*.{js,mjs,cjs,ts,tsx,vue}"
+      ],
+      "javascript": {
+        "globals": [
+          "exports",
+          "location"
+        ]
+      }
+    }
+  ],
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": {
+          "level": "on",
+          "options": {
+            "groups": [
+              ":NODE:",
+              ":PACKAGE:",
+              ":ALIAS:",
+              ":PATH:"
+            ]
+          }
+        }
+      }
+    }
+  }
+}

package/express/package.json

@@ -1,16 +1,17 @@
 {
   "name": "nexwire-express",
-  "private": true,
-  "type": "module",
   "version": "1.0.0",
+  "private": true,
   "bin": {
     "maker": "./src/framework/maker-cli/index.mjs"
   },
+  "type": "module",
   "scripts": {
     "build": "npm run build:all",
     "build:all": "npm run build:backend && npm run build:ui",
     "build:backend": "tsc -p tsconfig.json && tsc-alias -p tsconfig.json",
-    "build:ui": "node src/framework/maker-cli/runtime/build-ui.mjs",
+    "build:ui": "npm run typecheck:ui && node src/framework/maker-cli/runtime/build-ui.mjs",
+    "typecheck:ui": "vue-tsc --noEmit -p src/resources/tsconfig.json",
     "dev": "node src/framework/maker-cli/index.mjs dev",
     "backend": "node src/framework/maker-cli/index.mjs serve --src",
     "ui": "node src/framework/maker-cli/index.mjs ui:dev",
@@ -37,8 +38,8 @@
     "@scalar/express-api-reference": "^0.10.19",
     "@socket.io/admin-ui": "^0.5.1",
     "@socket.io/redis-adapter": "^8.3.0",
-    "@unhead/vue": "^3.4.3",
     "@types/multer": "^2.2.0",
+    "@unhead/vue": "^3.4.3",
     "@vitejs/plugin-vue": "^6.0.10",
     "@vuepic/vue-datepicker": "^14.0.0",
     "@vueuse/core": "^14.4.0",
@@ -64,7 +65,7 @@
     "jsonwebtoken": "^9.0.2",
     "lodash-es": "^4.18.1",
     "luxon": "^3.7.2",
-    "maildev": "^3.0.0",
+    "maildev": "^2.2.1",
     "morgan": "^1.10.0",
     "multer": "^2.5.0",
     "mysql2": "^3.23.3",
@@ -82,6 +83,24 @@
     "vue-select": "^4.0.0-beta.6",
     "zod": "^4.6.7"
   },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.7",
+    "@types/bootstrap": "^5.2.11",
+    "@types/cookie-parser": "^1.4.7",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.6",
+    "@types/jsonwebtoken": "^9.0.7",
+    "@types/lodash-es": "^4.17.12",
+    "@types/morgan": "^1.9.9",
+    "@types/node": "^25.9.9",
+    "@vitest/coverage-v8": "^5.0.5",
+    "drizzle-kit": "^0.31.11",
+    "tsc-alias": "^1.9.9",
+    "tsx": "^4.23.15",
+    "typescript": "^6.0.3",
+    "vitest": "^5.0.5",
+    "vue-tsc": "^3.3.13"
+  },
   "overrides": {
     "@esbuild-kit/core-utils": {
       "esbuild": "^0.25.12"
@@ -100,34 +119,17 @@
       "bcryptjs": "^3.0.3"
     }
   },
+  "engines": {
+    "bun": ">=1.3",
+    "node": ">=22.12.0",
+    "pnpm": ">=11",
+    "yarn": ">=4"
+  },
   "allowScripts": {
     "@parcel/watcher": true,
     "esbuild": true,
     "msgpackr-extract": true,
     "redis-commander": true,
     "vue-demi": true
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^2.5.7",
-    "@types/bootstrap": "^5.2.11",
-    "@types/cookie-parser": "^1.4.7",
-    "@types/cors": "^2.8.17",
-    "@types/express": "^5.0.6",
-    "@types/jsonwebtoken": "^9.0.7",
-    "@types/lodash-es": "^4.17.12",
-    "@types/morgan": "^1.9.9",
-    "@types/node": "^25.9.9",
-    "@vitest/coverage-v8": "^5.0.5",
-    "drizzle-kit": "^0.31.11",
-    "tsc-alias": "^1.9.9",
-    "tsx": "^4.23.15",
-    "typescript": "^6.0.3",
-    "vitest": "^5.0.5"
-  },
-  "engines": {
-    "node": ">=22.12.0",
-    "bun": ">=1.3",
-    "pnpm": ">=11",
-    "yarn": ">=4"
   }
-}
+}

package/express/src/config/database.ts

@@ -1,29 +1,48 @@
-import { env } from "@/env.js";
-
-/**
- * Why: Database connection settings for Drizzle.
- * When: Database bootstrap and dialect detection.
- * Where: src/config/database.ts.
- * How: The connection URL contains credentials, so it stays in .env
- *      (`DATABASE_URL`). Dialect is derived from the URL prefix.
- */
-export const databaseConfig = {
-  url: env.DATABASE_URL
-};
-
-export type DatabaseConfig = typeof databaseConfig;
-
-/**
- * Why: Maps a connection URL to its Drizzle dialect.
- * When: Selecting the pool driver and dialect-specific branching.
- * Where: Framework database connection helpers.
- * How: Matches the URL prefix; anything that isn't mysql/postgres is sqlite.
- */
-export function detectDialectFrom(url: string): "sqlite" | "mysql" | "postgresql" {
-  const value = url.toLowerCase();
-  if (value.startsWith("mysql")) return "mysql";
-  if (value.startsWith("postgres")) return "postgresql";
-  return "sqlite";
-}
-
-export const databaseDialect = detectDialectFrom(databaseConfig.url);
+import { env } from "@/env.js";
+
+/**
+ * Why: Database connection settings.
+ * When: Database bootstrap and dialect detection.
+ * Where: src/config/database.ts.
+ * How: Only DATABASE_URL is required. Pool settings use generic,
+ *      provider-agnostic defaults.
+ */
+
+const rawUrl = env.DATABASE_URL;
+
+export const databaseConfig = {
+  // If it's sqlite, convert "sqlite:./db.sqlite" to "file:./db.sqlite"
+  url: rawUrl.startsWith("sqlite:") ? `file:${rawUrl.slice("sqlite:".length)}` : rawUrl,
+
+  /** Generic, sensible pool defaults for any provider */
+  pool: {
+    max: 10,
+    idleTimeout: 20000, // ms
+    connectTimeout: 10000, // ms
+    keepAlive: true
+  },
+
+  /**
+   * Default to true. If a provider (like a pooler) doesn't support it,
+   * they usually indicate this in the connection string or require the user
+   * to handle it at the driver level.
+   */
+  prepare: true,
+
+  /**
+   * Require TLS for MySQL and PostgreSQL connections. Set this to true, or
+   * append `?sslmode=require` to DATABASE_URL if your provider documents that.
+   */
+  ssl: false
+};
+
+export type DatabaseConfig = typeof databaseConfig;
+
+export function detectDialectFrom(url: string): "sqlite" | "mysql" | "postgresql" {
+  const value = url.toLowerCase();
+  if (value.startsWith("mysql")) return "mysql";
+  if (value.startsWith("postgres")) return "postgresql";
+  return "sqlite";
+}
+
+export const databaseDialect = detectDialectFrom(rawUrl);

package/express/src/config/index.ts

@@ -1,83 +1,83 @@
-import { type AppConfig, appConfig } from "./app.js";
-import { type AuthConfig, authConfig } from "./auth.js";
-import { type CacheConfig, cacheConfig } from "./cache.js";
-import { type CookieConfig, cookieConfig } from "./cookie.js";
-import { type CorsConfig, corsConfig } from "./cors.js";
-import { type DatabaseConfig, databaseConfig } from "./database.js";
-import { type JwtConfig, jwtConfig } from "./jwt.js";
-import { type LoggingConfig, loggingConfig } from "./logging.js";
-import { type MailConfig, mailConfig } from "./mail.js";
-import { type OpenApiConfig, openApiConfig } from "./openapi.js";
-import { type QueueConfig, queueConfig } from "./queue.js";
-import { type RateLimitConfig, rateLimitConfig } from "./rateLimit.js";
-import { type RealtimeConfig, realtimeConfig } from "./realtime.js";
-import { type RedisConfig, redisConfig } from "./redis.js";
-import { type SecurityConfig, securityConfig } from "./security.js";
-import { type SessionConfig, sessionConfig } from "./session.js";
-import { type StorageConfig, storageConfig } from "./storage.js";
-
-export { appConfig } from "./app.js";
-export { authConfig } from "./auth.js";
-export { cacheConfig } from "./cache.js";
-export { cookieConfig } from "./cookie.js";
-export { corsConfig } from "./cors.js";
-export { databaseConfig } from "./database.js";
-export { jwtConfig } from "./jwt.js";
-export { loggingConfig } from "./logging.js";
-export { mailConfig } from "./mail.js";
-export { openApiConfig } from "./openapi.js";
-export { queueConfig } from "./queue.js";
-export { rateLimitConfig } from "./rateLimit.js";
-export { realtimeConfig } from "./realtime.js";
-export { redisConfig } from "./redis.js";
-export { securityConfig } from "./security.js";
-export { sessionConfig } from "./session.js";
-export { storageConfig } from "./storage.js";
-
-/**
- * Why: Single import point for every config domain.
- * When: Application code needs configuration values.
- * Where: Imported as `import { config } from "@/config/index.js"`.
- * How: Aggregates per-domain config objects; individual files remain the
- *      place to edit each setting.
- */
-export const config = {
-  app: appConfig,
-  auth: authConfig,
-  cache: cacheConfig,
-  cookie: cookieConfig,
-  cors: corsConfig,
-  database: databaseConfig,
-  jwt: jwtConfig,
-  logging: loggingConfig,
-  mail: mailConfig,
-  openApi: openApiConfig,
-  queue: queueConfig,
-  rateLimit: rateLimitConfig,
-  realtime: realtimeConfig,
-  redis: redisConfig,
-  session: sessionConfig,
-  security: securityConfig,
-  storage: storageConfig
-} as const;
-
-export type Config = typeof config;
-export type {
-  AppConfig,
-  AuthConfig,
-  CacheConfig,
-  CookieConfig,
-  CorsConfig,
-  DatabaseConfig,
-  JwtConfig,
-  LoggingConfig,
-  MailConfig,
-  OpenApiConfig,
-  QueueConfig,
-  RateLimitConfig,
-  RealtimeConfig,
-  RedisConfig,
-  SecurityConfig,
-  SessionConfig,
-  StorageConfig
-};
+import { type AppConfig, appConfig } from "./app.js";
+import { type AuthConfig, authConfig } from "./auth.js";
+import { type CacheConfig, cacheConfig } from "./cache.js";
+import { type CookieConfig, cookieConfig } from "./cookie.js";
+import { type CorsConfig, corsConfig } from "./cors.js";
+import { type DatabaseConfig, databaseConfig } from "./database.js";
+import { type JwtConfig, jwtConfig } from "./jwt.js";
+import { type LoggingConfig, loggingConfig } from "./logging.js";
+import { type MailConfig, mailConfig } from "./mail.js";
+import { type OpenApiConfig, openApiConfig } from "./openapi.js";
+import { type QueueConfig, queueConfig } from "./queue.js";
+import { type RateLimitConfig, rateLimitConfig } from "./rateLimit.js";
+import { type RealtimeConfig, realtimeConfig } from "./realtime.js";
+import { type RedisConfig, redisConfig } from "./redis.js";
+import { type SecurityConfig, securityConfig } from "./security.js";
+import { type SessionConfig, sessionConfig } from "./session.js";
+import { type StorageConfig, storageConfig } from "./storage.js";
+
+export { appConfig } from "./app.js";
+export { authConfig } from "./auth.js";
+export { cacheConfig } from "./cache.js";
+export { cookieConfig } from "./cookie.js";
+export { corsConfig } from "./cors.js";
+export { databaseConfig, databaseDialect, detectDialectFrom } from "./database.js";
+export { jwtConfig } from "./jwt.js";
+export { loggingConfig } from "./logging.js";
+export { mailConfig } from "./mail.js";
+export { openApiConfig } from "./openapi.js";
+export { queueConfig } from "./queue.js";
+export { rateLimitConfig } from "./rateLimit.js";
+export { realtimeConfig } from "./realtime.js";
+export { redisConfig } from "./redis.js";
+export { securityConfig } from "./security.js";
+export { sessionConfig } from "./session.js";
+export { storageConfig } from "./storage.js";
+
+/**
+ * Why: Single import point for every config domain.
+ * When: Application code needs configuration values.
+ * Where: Imported as `import { config } from "@/config/index.js"`.
+ * How: Aggregates per-domain config objects; individual files remain the
+ *      place to edit each setting.
+ */
+export const config = {
+  app: appConfig,
+  auth: authConfig,
+  cache: cacheConfig,
+  cookie: cookieConfig,
+  cors: corsConfig,
+  database: databaseConfig,
+  jwt: jwtConfig,
+  logging: loggingConfig,
+  mail: mailConfig,
+  openApi: openApiConfig,
+  queue: queueConfig,
+  rateLimit: rateLimitConfig,
+  realtime: realtimeConfig,
+  redis: redisConfig,
+  session: sessionConfig,
+  security: securityConfig,
+  storage: storageConfig
+} as const;
+
+export type Config = typeof config;
+export type {
+  AppConfig,
+  AuthConfig,
+  CacheConfig,
+  CookieConfig,
+  CorsConfig,
+  DatabaseConfig,
+  JwtConfig,
+  LoggingConfig,
+  MailConfig,
+  OpenApiConfig,
+  QueueConfig,
+  RateLimitConfig,
+  RealtimeConfig,
+  RedisConfig,
+  SecurityConfig,
+  SessionConfig,
+  StorageConfig
+};