@getstrata/starter 0.1.11 → 0.1.13

package/README.md

@@ -1,6 +1,6 @@
 # create-strata
 
-Interactive starter for [Strata](https://github.com/EyK-26/strata). The wizard always asks each layer. Extras (MFA, email verification, SCIM, metrics) are toggled one by one. SQLite APIs and Postgres HTML apps use the same generator.
+Interactive starter for [Strata](https://github.com/EyK-26/strata). The wizard always asks each layer. In a terminal, lists use ↑/↓ and Enter (or a number). Extras (MFA, email verification, SCIM, metrics) are toggled one by one. SQLite APIs and Postgres HTML apps use the same generator.
 
 ## Usage
 
@@ -12,7 +12,7 @@ bunx create-strata html --frontend server-htmx --database postgres --auth cookie
 
 Layer flags: `--frontend`, `--database`, `--auth`, `--tenancy`, `--cache`, `--queue`, `--mail`, `--spa-prefix`, plus extras (`--mfa`, `--scim`, `--metrics`, ...).
 
-Pick **one** database engine. Docker Compose is optional and only includes services for the tools you selected (`--docker`, `--no-docker`, `--docker-services=postgres,redis`).
+Pick **one** database engine. Docker Compose is optional and only includes services for the tools you selected (`--docker`, `--no-docker`, `--docker-services=postgres,redis`). `--docker` with Postgres or MySQL also writes Adminer.
 
 ## What you get
 

package/dist/cli.js

@@ -84,12 +84,13 @@ var TENANCY_DRIVERS = ["none", "column", "rls"];
 var CACHE_DRIVERS = ["array", "redis"];
 var QUEUE_DRIVERS = ["sync", "redis"];
 var MAIL_DRIVERS = ["log", "smtp"];
-var DOCKER_SERVICE_NAMES = ["postgres", "mysql", "redis", "mailpit"];
+var DOCKER_SERVICE_NAMES = ["postgres", "mysql", "redis", "mailpit", "adminer"];
 var DOCKER_SERVICE_LABELS = {
   postgres: "Postgres",
   mysql: "MySQL",
   redis: "Redis",
-  mailpit: "SMTP (Mailpit)"
+  mailpit: "SMTP (Mailpit)",
+  adminer: "Adminer (database UI)"
 };
 function authUsesCookie(auth) {
   return auth === "cookie" || auth.startsWith("cookie-");
@@ -122,7 +123,13 @@ function needsRedis(layers) {
   return layers.cache === "redis" || layers.queue === "redis";
 }
 function emptyDockerServices() {
-  return { postgres: false, mysql: false, redis: false, mailpit: false };
+  return { postgres: false, mysql: false, redis: false, mailpit: false, adminer: false };
+}
+function dockerDatabaseService(database) {
+  if (database === "postgres" || database === "mysql") {
+    return database;
+  }
+  return null;
 }
 function enableDockerServices(names) {
   const services = emptyDockerServices();
@@ -151,7 +158,12 @@ function selectedDockerServices(layers) {
   if (!layers.docker.enabled) {
     return [];
   }
-  return neededDockerServices(layers).filter((name) => layers.docker.services[name]);
+  const selected = neededDockerServices(layers).filter((name) => layers.docker.services[name]);
+  const databaseService = dockerDatabaseService(layers.database);
+  if (databaseService && selected.includes(databaseService) && layers.docker.services.adminer) {
+    selected.push("adminer");
+  }
+  return selected;
 }
 function reconcileDocker(layers) {
   const selected = selectedDockerServices(layers);
@@ -168,7 +180,11 @@ function dockerLayerForNeeded(layers, enabled) {
   if (!enabled || needed.length === 0) {
     return { enabled: false, services: emptyDockerServices() };
   }
-  return { enabled: true, services: enableDockerServices(needed) };
+  const names = [...needed];
+  if (dockerDatabaseService(layers.database)) {
+    names.push("adminer");
+  }
+  return { enabled: true, services: enableDockerServices(names) };
 }
 
 // src/presets.ts
@@ -252,7 +268,7 @@ Options:
   --extras            Interactive extras list (MFA, email verification, SCIM, metrics)
   --docker            Write Docker Compose for every selected tool that needs a service
   --no-docker         Skip docker-compose.yml; use installs already on this machine
-  --docker-services   Subset: postgres, mysql, redis, mailpit (comma-separated)
+  --docker-services   Subset: postgres, mysql, redis, mailpit, adminer (comma-separated)
   --force             Replace an existing directory
   --yes, --no-interactive
   -h, --help
@@ -446,7 +462,13 @@ function applyDockerFlags(layers, flags) {
     };
   }
   if (flags.dockerServices) {
-    const selected = flags.dockerServices.filter((name) => needed.includes(name));
+    const databaseService = dockerDatabaseService(layers.database);
+    const selected = flags.dockerServices.filter((name) => {
+      if (needed.includes(name)) {
+        return true;
+      }
+      return name === "adminer" && databaseService !== null && flags.dockerServices?.includes(databaseService) === true;
+    });
     return {
       ...layers,
       docker: {
@@ -486,10 +508,36 @@ function layersFromFlags(flags) {
 }
 
 // src/prompt.ts
-import { stdin as input, stdout as output } from "process";
 import { createInterface } from "readline/promises";
+import tty2 from "tty";
 
 // src/selectPrompt.ts
+import tty from "tty";
+function hasRawMode(input) {
+  return Boolean(input.isTTY && typeof input.setRawMode === "function");
+}
+var cachedFdIo;
+function resolveSelectIo(preferred) {
+  if (preferred) {
+    return preferred;
+  }
+  const live = { input: process.stdin, output: process.stdout };
+  if (hasRawMode(live.input)) {
+    return live;
+  }
+  if (cachedFdIo && hasRawMode(cachedFdIo.input)) {
+    return cachedFdIo;
+  }
+  if (tty.isatty(0)) {
+    cachedFdIo = {
+      input: new tty.ReadStream(0),
+      output: tty.isatty(1) ? new tty.WriteStream(1) : process.stdout
+    };
+    return cachedFdIo;
+  }
+  return live;
+}
+
 class PromptCancelledError extends Error {
   constructor() {
     super("Cancelled");
@@ -829,54 +877,51 @@ function isInteractive(flags) {
   if (flags.yes || flags.noInteractive) {
     return false;
   }
-  return Boolean(input.isTTY && output.isTTY);
-}
-function canUseRawKeys() {
-  return Boolean(input.isTTY && typeof input.setRawMode === "function");
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY || tty2.isatty(0) && tty2.isatty(1));
 }
-function createReadlinePrompter() {
-  const rl = createInterface({ input, output });
-  const io = { input, output };
+function createReadlinePrompter(io) {
+  const stdio = () => resolveSelectIo(io);
+  async function askLine(message) {
+    const current = stdio();
+    const rl = createInterface({ input: current.input, output: current.output });
+    try {
+      return (await rl.question(message)).trim();
+    } finally {
+      rl.close();
+    }
+  }
   return {
     async question(message, defaultValue) {
       const suffix = defaultValue ? ` [${defaultValue}]` : "";
-      const answer = (await rl.question(`${message}${suffix}: `)).trim();
+      const answer = await askLine(`${message}${suffix}: `);
       return answer || defaultValue || "";
     },
     async confirm(message, defaultValue = false) {
-      if (canUseRawKeys()) {
-        rl.pause();
-        try {
-          return await promptConfirm(message, defaultValue, io);
-        } finally {
-          input.setRawMode?.(false);
-          rl.resume();
-        }
+      const current = stdio();
+      if (hasRawMode(current.input)) {
+        return promptConfirm(message, defaultValue, current);
       }
       const hint = defaultValue ? "Y/n" : "y/N";
-      const answer = (await rl.question(`${message} (${hint}): `)).trim().toLowerCase();
+      const answer = (await askLine(`${message} (${hint}): `)).toLowerCase();
       if (!answer) {
         return defaultValue;
       }
       return answer === "y" || answer === "yes";
     },
     async select(message, choices, defaultValue) {
-      if (canUseRawKeys()) {
-        rl.pause();
-        try {
-          return await promptSelect(message, choices, defaultValue, io);
-        } finally {
-          input.setRawMode?.(false);
-          rl.resume();
-        }
+      const current = stdio();
+      if (hasRawMode(current.input)) {
+        return promptSelect(message, choices, defaultValue, current);
       }
-      console.log(message);
+      current.output.write(`${message}
+`);
       for (const [index, choice] of choices.entries()) {
         const marker = choice.value === defaultValue ? "*" : " ";
-        console.log(`  ${index + 1}) ${marker} ${choice.label}`);
+        current.output.write(`  ${index + 1}) ${marker} ${choice.label}
+`);
       }
       const defaultIndex = choices.findIndex((choice) => choice.value === defaultValue) + 1;
-      const answer = (await rl.question(`Choose [${defaultIndex}]: `)).trim();
+      const answer = await askLine(`Choose [${defaultIndex}]: `);
       if (!answer) {
         return defaultValue;
       }
@@ -889,20 +934,16 @@ function createReadlinePrompter() {
       return match?.value ?? defaultValue;
     },
     async multiSelect(message, choices) {
-      if (canUseRawKeys()) {
-        rl.pause();
-        try {
-          return await promptMultiSelect(message, choices, io);
-        } finally {
-          input.setRawMode?.(false);
-          rl.resume();
-        }
+      const current = stdio();
+      if (hasRawMode(current.input)) {
+        return promptMultiSelect(message, choices, current);
       }
       const enabled = new Set(choices.filter((choice) => choice.enabled).map((choice) => choice.value));
-      console.log(`${message} (yes/no each)`);
+      current.output.write(`${message} (yes/no each)
+`);
       for (const choice of choices) {
         const hint = enabled.has(choice.value) ? "Y/n" : "y/N";
-        const answer = (await rl.question(`  ${choice.label} (${hint}): `)).trim().toLowerCase();
+        const answer = (await askLine(`  ${choice.label} (${hint}): `)).toLowerCase();
         if (!answer) {
           continue;
         }
@@ -915,7 +956,7 @@ function createReadlinePrompter() {
       return [...enabled];
     },
     close() {
-      rl.close();
+      return;
     }
   };
 }
@@ -1025,7 +1066,14 @@ async function promptDockerLayer(prompter, layers) {
   for (const name of needed) {
     services[name] = await prompter.confirm(`Docker Compose for ${DOCKER_SERVICE_LABELS[name]}?`, true);
   }
+  const databaseService = dockerDatabaseService(layers.database);
+  if (databaseService && services[databaseService]) {
+    services.adminer = await prompter.confirm(`Docker Compose for ${DOCKER_SERVICE_LABELS.adminer}?`, true);
+  }
   const selected = needed.filter((name) => services[name]);
+  if (services.adminer) {
+    selected.push("adminer");
+  }
   return {
     enabled: selected.length > 0,
     services
@@ -2327,6 +2375,17 @@ function renderDockerCompose(projectName, layers) {
     volumes:
       - mysqldata:/var/lib/mysql`);
   }
+  if (selectedSet.has("adminer")) {
+    const server = selectedSet.has("mysql") ? "mysql" : "postgres";
+    services.push(`  adminer:
+    image: adminer:5.4.2
+    environment:
+      ADMINER_DEFAULT_SERVER: ${server}
+    depends_on:
+      - ${server}
+    ports:
+      - "8080:8080"`);
+  }
   if (selectedSet.has("redis")) {
     services.push(`  redis:
     image: redis:7-alpine
@@ -2447,6 +2506,14 @@ function renderSupportingToolsReadme(layers) {
   if (dockerOn.length > 0) {
     const names = dockerOn.map((name) => DOCKER_SERVICE_LABELS[name]).join(", ");
     lines.push(`Docker Compose includes ${names}.`, "", "```bash", "docker compose up -d", "```", "");
+    if (dockerSet.has("adminer")) {
+      const mysql = layers.database === "mysql";
+      const system = mysql ? "MySQL" : "PostgreSQL";
+      const server = mysql ? "mysql" : "postgres";
+      const username = mysql ? "root" : "postgres";
+      const password = mysql ? "root" : "postgres";
+      lines.push(`Adminer: http://localhost:8080 (${system}, server \`${server}\`, username \`${username}\`, password \`${password}\`).`, "");
+    }
   }
   if (localOn.length > 0) {
     const names = localOn.map((name) => DOCKER_SERVICE_LABELS[name]).join(", ");
@@ -2804,13 +2871,13 @@ function renderMigrateTs(layers) {
   }
   const list = statements.map((sql) => `  \`${sql}\`,`).join(`
 `);
-  const ph2 = layers.database === "postgres";
-  const notePlaceholder = ph2 ? "$1" : "?";
+  const ph = layers.database === "postgres";
+  const notePlaceholder = ph ? "$1" : "?";
   const verifyOn = layers.extras.emailVerification && authNeedsUsers(layers.auth);
   const userColumns = verifyOn ? "name, email, password, is_admin, email_verified_at" : "name, email, password, is_admin";
-  const userPlaceholders = verifyOn ? ph2 ? "$1, $2, $3, $4, $5), ($6, $7, $8, $9, $10" : "?, ?, ?, ?, ?), (?, ?, ?, ?, ?" : ph2 ? "$1, $2, $3, $4), ($5, $6, $7, $8" : "?, ?, ?, ?), (?, ?, ?, ?";
-  const adminFlag = ph2 ? "false" : "0";
-  const adminTrue = ph2 ? "true" : "1";
+  const userPlaceholders = verifyOn ? ph ? "$1, $2, $3, $4, $5), ($6, $7, $8, $9, $10" : "?, ?, ?, ?, ?), (?, ?, ?, ?, ?" : ph ? "$1, $2, $3, $4), ($5, $6, $7, $8" : "?, ?, ?, ?), (?, ?, ?, ?";
+  const adminFlag = ph ? "false" : "0";
+  const adminTrue = ph ? "true" : "1";
   const verifiedNow = "new Date().toISOString()";
   const userValues = verifyOn ? `["Demo User", "demo@example.com", password, ${adminFlag}, ${verifiedNow}, "Admin User", "admin@example.test", password, ${adminTrue}, ${verifiedNow}]` : `["Demo User", "demo@example.com", password, ${adminFlag}, "Admin User", "admin@example.test", password, ${adminTrue}]`;
   const seedTenant = tenancyOn ? `
@@ -2819,7 +2886,7 @@ function renderMigrateTs(layers) {
   );
   if (Number(tenantCount) === 0) {
     await sql.unsafe(
-      "INSERT INTO tenant (slug, plan, region) VALUES (${ph2 ? "$1, $2, $3" : "?, ?, ?"})",
+      "INSERT INTO tenant (slug, plan, region) VALUES (${ph ? "$1, $2, $3" : "?, ?, ?"})",
       ["default", "enterprise", "eu"],
     );
   }` : "";
@@ -3825,7 +3892,7 @@ function printNextSteps(projectName, layers, compose) {
   const dockerOn = selectedDockerServices(layers);
   const neededTools = neededDockerServices(layers);
   const localOn = neededTools.filter((name) => !dockerOn.includes(name));
-  const dockerSummary = neededTools.length === 0 ? "none" : dockerOn.length > 0 ? dockerOn.join("+") : "local";
+  const dockerSummary = dockerOn.length > 0 ? dockerOn.join("+") : neededTools.length === 0 ? "none" : "local";
   console.log(`
 Created Strata app in ${projectName}/
 `);
@@ -3837,6 +3904,9 @@ Next steps:`);
   if (compose) {
     console.log("  docker compose up -d");
   }
+  if (dockerOn.includes("adminer")) {
+    console.log("  Adminer: http://localhost:8080");
+  }
   if (localOn.length > 0) {
     console.log(`  Point env at local ${localOn.join(", ")} (see README).`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getstrata/starter",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Interactive create-strata wizard. Choose each layer; one database engine.",
   "type": "module",
   "license": "MIT",