@wneng/create-keel 0.3.6 → 0.4.0

package/dist/index.js

@@ -1,12 +1,23 @@
 #!/usr/bin/env node
 
 // src/version.ts
-var SCAFFOLDER_VERSION = "0.3.6";
+var SCAFFOLDER_VERSION = "0.4.0";
 
 // src/schema/options.ts
 import Ajv from "ajv";
 import addFormats from "ajv-formats";
 import { parse as parseYaml } from "yaml";
+
+// src/database/kinds.ts
+var DATABASE_KINDS = ["none", "mysql", "postgres", "elasticsearch"];
+var DATABASE_KIND_LABELS = {
+  none: "No database",
+  mysql: "MySQL 8 / MariaDB",
+  postgres: "PostgreSQL 14+",
+  elasticsearch: "Elasticsearch 8"
+};
+
+// src/schema/options.ts
 var BACKEND_LANGUAGES = ["node", "python", "go", "java", "none"];
 var FRONTEND_FRAMEWORKS = ["react", "vue", "none"];
 var AGENT_KINDS = ["rust-desktop", "none"];
@@ -35,7 +46,8 @@ var OPTIONS_FIELD_ORDER = [
   "integrations",
   "ci",
   "roles",
-  "multiApp"
+  "multiApp",
+  "database"
 ];
 var OPTIONS_SCHEMA = {
   $schema: "http://json-schema.org/draft-07/schema#",
@@ -58,7 +70,8 @@ var OPTIONS_SCHEMA = {
     "integrations",
     "ci",
     "roles",
-    "multiApp"
+    "multiApp",
+    "database"
   ],
   properties: {
     projectName: {
@@ -82,7 +95,20 @@ var OPTIONS_SCHEMA = {
       items: { type: "string", enum: [...ROLE_KINDS] },
       uniqueItems: true
     },
-    multiApp: { type: "boolean" }
+    multiApp: { type: "boolean" },
+    database: { type: "string", enum: [...DATABASE_KINDS] }
+  },
+  // Cross-axis constraint: `backend === 'none'` requires `database === 'none'`.
+  // A non-'none' database without a backend would be a contradiction (no
+  // server to host the migrations / driver). Encoded as if/then so AJV
+  // reports a precise error path on violation.
+  if: {
+    properties: { backend: { const: "none" } },
+    required: ["backend"]
+  },
+  then: {
+    properties: { database: { const: "none" } },
+    required: ["database"]
   }
 };
 var ajv = new Ajv({ allErrors: true, strict: true });
@@ -425,6 +451,7 @@ function parseCreateArgs(args) {
   let license;
   let gitLfs;
   let integrations;
+  let database;
   function takeEnum(flag, next, enumValues) {
     if (next === void 0 || next.startsWith("--")) {
       throw new UserInputError(
@@ -516,6 +543,11 @@ function parseCreateArgs(args) {
         i += 1;
         break;
       }
+      case "--database": {
+        database = takeEnum("--database", args[i + 1], DATABASE_KINDS);
+        i += 1;
+        break;
+      }
       case "--engineering-standards": {
         const next = args[i + 1];
         if (next === void 0 || next.startsWith("--")) {
@@ -612,6 +644,12 @@ function parseCreateArgs(args) {
       "\u9879\u76EE\u540D\u5E94\u5339\u914D ^[a-z0-9][a-z0-9-]{0,62}$\uFF0C\u4F8B\u5982\uFF1Amy-app"
     );
   }
+  if (backend === "none" && database !== void 0 && database !== "none") {
+    throw new UserInputError(
+      `--database ${database} is incompatible with --backend none`,
+      "\u6570\u636E\u5E93\u9700\u8981\u540E\u7AEF\u5BBF\u4E3B\uFF1B\u8BF7\u9009\u62E9\u4E00\u4E2A\u540E\u7AEF\u6216\u5C06 --database \u8BBE\u4E3A none"
+    );
+  }
   const flags = {
     yes,
     force,
@@ -634,7 +672,8 @@ function parseCreateArgs(args) {
     ...ai !== void 0 ? { ai } : {},
     ...license !== void 0 ? { license } : {},
     ...gitLfs !== void 0 ? { gitLfs } : {},
-    ...integrations !== void 0 ? { integrations } : {}
+    ...integrations !== void 0 ? { integrations } : {},
+    ...database !== void 0 ? { database } : {}
   };
   if (sampleFeature && dryRun) {
     throw new UserInputError(
@@ -722,6 +761,7 @@ function helpText() {
     "  --contract <kind>  " + CONTRACT_KINDS.join("|"),
     "  --ai <kind>        " + AI_TOOLS.join("|"),
     "  --license <kind>   " + LICENSE_KINDS.join("|"),
+    "  --database <kind>  " + DATABASE_KINDS.join("|") + " (requires backend != none)",
     "  --gitLfs           Enable Git LFS in the generated project",
     "  --integrations     Enable docs/06-\u96C6\u6210\u5BF9\u63A5/ at create time",
     "  -h, --help         Show this help",
@@ -775,7 +815,8 @@ var OPTION_DEFAULTS = {
   integrations: false,
   ci: "gitee",
   roles: [],
-  multiApp: false
+  multiApp: false,
+  database: "none"
 };
 function buildDefaultOptions(projectName) {
   return { projectName, ...OPTION_DEFAULTS };
@@ -811,7 +852,8 @@ var PARTIAL_OPTIONS_SCHEMA = {
       items: { type: "string", enum: [...ROLE_KINDS] },
       uniqueItems: true
     },
-    multiApp: { type: "boolean" }
+    multiApp: { type: "boolean" },
+    database: { type: "string", enum: [...DATABASE_KINDS] }
   }
 };
 var ajv2 = new Ajv2({ allErrors: true, strict: true });
@@ -936,6 +978,25 @@ async function promptForOptions(input) {
     report,
     "backend"
   );
+  let database;
+  if (backend === "none") {
+    database = "none";
+    report("database", database, true);
+  } else if (pre.database !== void 0) {
+    database = pre.database;
+    report("database", database, false);
+  } else {
+    const dbChoices = DATABASE_KINDS.map((k) => ({
+      value: k,
+      name: `${k.padEnd(14)} ${DATABASE_KIND_LABELS[k]}`
+    }));
+    database = await p.select(
+      "\u6570\u636E\u5E93",
+      dbChoices,
+      OPTION_DEFAULTS.database
+    );
+    report("database", database, false);
+  }
   const frontend = await chooseAxis(
     p,
     pre.frontend,
@@ -1059,7 +1120,8 @@ async function promptForOptions(input) {
     integrations,
     ci,
     roles,
-    multiApp: OPTION_DEFAULTS.multiApp
+    multiApp: OPTION_DEFAULTS.multiApp,
+    database
   };
 }
 async function chooseAxis(prompter, prefilled, question, domain, def, report, axisName) {
@@ -1110,7 +1172,8 @@ var APPLIES_WHEN_SCHEMA = {
     gitLfs: { type: "boolean" },
     integrations: { type: "boolean" },
     ci: { type: "string", enum: [...CI_PLATFORMS] },
-    role: { type: "string", enum: [...ROLE_KINDS] }
+    role: { type: "string", enum: [...ROLE_KINDS] },
+    database: { type: "string", enum: [...DATABASE_KINDS] }
   }
 };
 var MANIFEST_SCHEMA = {
@@ -1577,6 +1640,12 @@ function collectIssues3() {
   }));
 }
 function assertMetadata(value) {
+  if (value !== null && typeof value === "object" && "options" in value && typeof value.options === "object" && value.options !== null) {
+    const opts = value.options;
+    if (!("database" in opts)) {
+      opts.database = "none";
+    }
+  }
   if (!validateFn3(value)) {
     throw new MetadataValidationError(collectIssues3());
   }
@@ -1877,6 +1946,106 @@ import { accessSync as accessSync2 } from "node:fs";
 import * as path6 from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
+// src/database/matrix.ts
+var MATRIX = Object.freeze({
+  // ---- node -------------------------------------------------------------
+  "node+mysql": {
+    fragmentName: "db-node-knex-mysql",
+    migrationTool: "knex",
+    driverDeps: [
+      { name: "knex", version: "3.1.0" },
+      { name: "mysql2", version: "3.11.3" }
+    ]
+  },
+  "node+postgres": {
+    fragmentName: "db-node-knex-postgres",
+    migrationTool: "knex",
+    driverDeps: [
+      { name: "knex", version: "3.1.0" },
+      { name: "pg", version: "8.13.0" }
+    ]
+  },
+  "node+elasticsearch": {
+    fragmentName: "db-node-elasticsearch",
+    migrationTool: "es-template-applier",
+    driverDeps: [{ name: "@elastic/elasticsearch", version: "8.15.0" }]
+  },
+  // ---- java -------------------------------------------------------------
+  "java+mysql": {
+    fragmentName: "db-java-flyway-mysql",
+    migrationTool: "flyway",
+    driverDeps: [
+      { name: "flyway-core", version: "10.20.0" },
+      { name: "flyway-mysql", version: "10.20.0" },
+      { name: "mysql-connector-j", version: "9.1.0" }
+    ]
+  },
+  "java+postgres": {
+    fragmentName: "db-java-flyway-postgres",
+    migrationTool: "flyway",
+    driverDeps: [
+      { name: "flyway-core", version: "10.20.0" },
+      { name: "flyway-database-postgresql", version: "10.20.0" },
+      { name: "postgresql", version: "42.7.4" }
+    ]
+  },
+  "java+elasticsearch": {
+    fragmentName: "db-java-elasticsearch",
+    migrationTool: "es-template-applier",
+    driverDeps: [{ name: "spring-data-elasticsearch", version: "5.3.5" }]
+  },
+  // ---- python -----------------------------------------------------------
+  "python+mysql": {
+    fragmentName: "db-python-alembic-mysql",
+    migrationTool: "alembic",
+    driverDeps: [
+      { name: "alembic", version: "1.13.3" },
+      { name: "pymysql", version: "1.1.1" }
+    ]
+  },
+  "python+postgres": {
+    fragmentName: "db-python-alembic-postgres",
+    migrationTool: "alembic",
+    driverDeps: [
+      { name: "alembic", version: "1.13.3" },
+      { name: "psycopg", version: "3.2.3" }
+    ]
+  },
+  "python+elasticsearch": {
+    fragmentName: "db-python-elasticsearch",
+    migrationTool: "es-template-applier",
+    driverDeps: [{ name: "elasticsearch", version: "8.15.1" }]
+  },
+  // ---- go ---------------------------------------------------------------
+  "go+mysql": {
+    fragmentName: "db-go-migrate-mysql",
+    migrationTool: "golang-migrate",
+    driverDeps: [
+      { name: "github.com/golang-migrate/migrate/v4", version: "4.18.1" },
+      { name: "github.com/go-sql-driver/mysql", version: "1.8.1" }
+    ]
+  },
+  "go+postgres": {
+    fragmentName: "db-go-migrate-postgres",
+    migrationTool: "golang-migrate",
+    driverDeps: [
+      { name: "github.com/golang-migrate/migrate/v4", version: "4.18.1" },
+      { name: "github.com/jackc/pgx/v5", version: "5.7.1" }
+    ]
+  },
+  "go+elasticsearch": {
+    fragmentName: "db-go-elasticsearch",
+    migrationTool: "es-template-applier",
+    driverDeps: [{ name: "github.com/elastic/go-elasticsearch/v8", version: "8.15.0" }]
+  }
+});
+function lookupMatrix(backend, database) {
+  if (database === "none") return null;
+  if (backend === "none") return null;
+  const key = `${backend}+${database}`;
+  return MATRIX[key] ?? null;
+}
+
 // src/standards/stack-detector.ts
 function backendManifest(opt) {
   switch (opt) {
@@ -1939,8 +2108,10 @@ var SEED_DEPS_GO_SERVER = [
   { name: "github.com/gin-gonic/gin", version: "1.10.0", policy: "minor" }
 ];
 var SEED_DEPS_PYTHON_SERVER = [
-  { name: "fastapi", version: "0.111.1", policy: "minor" },
-  { name: "pydantic", version: "2.8.2", policy: "minor" }
+  { name: "fastapi", version: "0.115.5", policy: "minor" },
+  { name: "uvicorn", version: "0.32.0", policy: "minor" },
+  { name: "pydantic", version: "2.9.2", policy: "minor" },
+  { name: "pydantic-settings", version: "2.6.1", policy: "minor" }
 ];
 var SEED_DEPS_REACT_WEB = [
   { name: "react", version: "18.3.1", policy: "minor" },
@@ -2028,7 +2199,28 @@ function detectRuntimeManifests(options) {
     miniappManifest(options.miniapp),
     agentManifest(options.agent)
   ];
-  return detectors.filter((m) => m !== null).map((m) => ({ ...m, dependencies: seedDeps(options, m.env) }));
+  return detectors.filter((m) => m !== null).map((m) => {
+    const baseDeps = seedDeps(options, m.env);
+    if (m.env === "server") {
+      const matrix = lookupMatrix(options.backend, options.database);
+      if (matrix !== null) {
+        const dbDeps = matrix.driverDeps.map((d) => ({
+          name: d.name,
+          version: d.version,
+          policy: "minor"
+        }));
+        return {
+          ...m,
+          dependencies: [...baseDeps, ...dbDeps],
+          database: {
+            kind: options.database,
+            migrationTool: matrix.migrationTool
+          }
+        };
+      }
+    }
+    return { ...m, dependencies: baseDeps };
+  });
 }
 
 // src/standards/plan.ts
@@ -2338,7 +2530,8 @@ async function resolveOptions(input) {
     ...flags.license !== void 0 ? { license: flags.license } : {},
     ...flags.gitLfs !== void 0 ? { gitLfs: flags.gitLfs } : {},
     ...flags.integrations !== void 0 ? { integrations: flags.integrations } : {},
-    ...flags.multiApp !== void 0 ? { multiApp: flags.multiApp } : {}
+    ...flags.multiApp !== void 0 ? { multiApp: flags.multiApp } : {},
+    ...flags.database !== void 0 ? { database: flags.database } : {}
   };
   if (flags.yes) {
     const full = { ...buildDefaultOptions(projectName), ...merged };