create-projx 1.6.1 → 1.6.3

package/README.md

@@ -7,6 +7,8 @@
 
 **Go from blank folder to production-ready project in 30 seconds.** Backend-only API, AI/ML app, mobile, full-stack, infra setup — pick what you need and get it wired with auth, database, Docker, CI/CD, hooks, and tests. All optional. All yours.
 
+![projx demo](.github/demo.gif)
+
 ```bash
 npx create-projx my-app
 ```
@@ -156,6 +158,16 @@ npx create-projx add frontend mobile
 
 Copies the new component directories, regenerates shared files (docker-compose, CI, pre-commit hooks) to include them, and installs dependencies.
 
+#### Multiple instances of the same type
+
+Need a second backend service alongside an existing one (e.g. an SMTP listener next to your CRUD API)? Use `--name <dir>`:
+
+```bash
+npx create-projx add fastify --name email-ingestor
+```
+
+Creates `email-ingestor/` with the fastify scaffold and a `.projx-component` marker. Each instance gets its own job in `.github/workflows/ci.yml`, its own section in `.githooks/pre-commit`, and its own install step in `setup.sh`. `update` keeps every instance refreshed on every run.
+
 ### Update Scaffolding
 
 When templates improve, update your project:
@@ -211,6 +223,7 @@ To opt back in to updates for a skipped file, use `npx create-projx unpin <file>
 npx create-projx <name> [options]
 npx create-projx init
 npx create-projx add <components...>
+npx create-projx add <type> --name <dir>
 npx create-projx update
 npx create-projx diff
 npx create-projx pin <patterns...>
@@ -221,6 +234,7 @@ npx create-projx gen entity <name> [--ai | --backend]
 npx create-projx sync [--url <url>]
 
 --components <list>    Comma-separated: fastapi,fastify,frontend,mobile,e2e,infra
+--name <dir>           Custom directory for `add <type>` (multi-instance)
 --ai                   Target fastapi (AI/ML) for gen entity
 --backend              Target fastify (API backend) for gen entity
 --no-git               Skip git init
@@ -289,7 +303,7 @@ Override with `--ai` (fastapi) or `--backend` (fastify).
 | `frontend`                | `src/types/<name>.ts` — TypeScript interface + Create/Update variants                        |
 | `mobile`                  | `lib/entities/<name>/model.dart` — Dart class with fromJson/toJson/copyWith                  |
 
-**Tests included**: every `gen entity` writes a working integration test file alongside the model — 11 tests for FastAPI (extending `BaseEntityApiTest`), 11 tests for Fastify (via `describeCrudEntity`). Both run against a real database (Postgres for Fastify, SQLite-in-memory for FastAPI today). New entities ship green from day one — no scrambling to bolt on tests at go-live.
+**Tests included**: every `gen entity` writes a working integration test file alongside the model — 11 tests for FastAPI (extending `BaseEntityApiTest`), 11 tests for Fastify (via `describeCrudEntity`). Both run against a real database (Postgres). New entities ship green from day one — no scrambling to bolt on tests at go-live.
 
 No migrations — run `alembic revision --autogenerate` or `prisma migrate dev` (via your package manager) when ready.
 
@@ -371,8 +385,8 @@ The CLI lives in `cli/`. Templates are the root-level component directories (`fa
 
 ```bash
 cd cli
-npm test        # run tests
-npm run build   # build CLI
+pnpm test       # run tests
+pnpm build      # build CLI
 ```
 
 ## Try it now

package/dist/{baseline-5XAJJ457.js → baseline-RXPDDEDD.js}

@@ -1,8 +1,6 @@
 import {
   BASELINE_REF,
   applyTemplate,
-  buildDisplayNames,
-  buildPathsUpper,
   collectAllFiles,
   detectPackageNameOverrides,
   getBaselineRef,
@@ -10,13 +8,11 @@ import {
   matchesSkip,
   saveBaselineRef,
   writeTemplateToDir
-} from "./chunk-TNI4XBVS.js";
-import "./chunk-FTHX7ILT.js";
+} from "./chunk-OBYYB6PR.js";
+import "./chunk-LYPPFXGK.js";
 export {
   BASELINE_REF,
   applyTemplate,
-  buildDisplayNames,
-  buildPathsUpper,
   collectAllFiles,
   detectPackageNameOverrides,
   getBaselineRef,

package/dist/{chunk-FTHX7ILT.js → chunk-LYPPFXGK.js}

@@ -19,13 +19,57 @@ var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn", "bun"];
 function pmCommands(pm) {
   switch (pm) {
     case "npm":
-      return { name: "npm", install: "npm install", ci: "npm ci", run: "npm run", exec: "npx", dlx: "npx", lockfile: "package-lock.json", prismaExec: "npx prisma", runDev: "npm run dev" };
+      return {
+        name: "npm",
+        install: "npm install",
+        ci: "npm ci",
+        run: "npm run",
+        exec: "npx",
+        dlx: "npx",
+        lockfile: "package-lock.json",
+        prismaExec: "npx prisma",
+        runDev: "npm run dev",
+        audit: "npm audit --omit=dev"
+      };
     case "pnpm":
-      return { name: "pnpm", install: "pnpm install", ci: "pnpm install --frozen-lockfile", run: "pnpm", exec: "pnpm exec", dlx: "pnpm dlx", lockfile: "pnpm-lock.yaml", prismaExec: "pnpm prisma", runDev: "pnpm dev" };
+      return {
+        name: "pnpm",
+        install: "pnpm install",
+        ci: "pnpm install --frozen-lockfile",
+        run: "pnpm",
+        exec: "pnpm exec",
+        dlx: "pnpm dlx",
+        lockfile: "pnpm-lock.yaml",
+        prismaExec: "pnpm prisma",
+        runDev: "pnpm dev",
+        audit: "pnpm audit --prod"
+      };
     case "yarn":
-      return { name: "yarn", install: "yarn", ci: "yarn --frozen-lockfile", run: "yarn", exec: "yarn", dlx: "yarn dlx", lockfile: "yarn.lock", prismaExec: "yarn prisma", runDev: "yarn dev" };
+      return {
+        name: "yarn",
+        install: "yarn",
+        ci: "yarn --frozen-lockfile",
+        run: "yarn",
+        exec: "yarn",
+        dlx: "yarn dlx",
+        lockfile: "yarn.lock",
+        prismaExec: "yarn prisma",
+        runDev: "yarn dev",
+        audit: "yarn npm audit --environment production"
+      };
     case "bun":
-      return { name: "bun", install: "bun install", ci: "bun install --frozen-lockfile", run: "bun run", exec: "bunx", dlx: "bunx", lockfile: "bun.lockb", prismaExec: "bunx prisma", runDev: "bun run dev" };
+      return {
+        name: "bun",
+        install: "bun install",
+        ci: "bun install --frozen-lockfile",
+        run: "bun run",
+        exec: "bunx",
+        dlx: "bunx",
+        lockfile: "bun.lockb",
+        prismaExec: "bunx prisma",
+        runDev: "bun run dev",
+        audit: "bun audit --prod"
+      };
   }
 }
 function detectPackageManager(cwd) {
@@ -78,17 +122,13 @@ async function downloadRepo(localPath) {
   const dest = join(tmpdir(), `projx-${Date.now()}`);
   await mkdir(dest, { recursive: true });
   if (hasCommand("git")) {
-    execSync(
-      `git clone --depth 1 ${REPO_URL}.git "${dest}/repo"`,
-      { stdio: "pipe" }
-    );
+    execSync(`git clone --depth 1 ${REPO_URL}.git "${dest}/repo"`, {
+      stdio: "pipe"
+    });
     return join(dest, "repo");
   }
   const tarUrl = `${REPO_URL}/archive/refs/heads/main.tar.gz`;
-  execSync(
-    `curl -sL "${tarUrl}" | tar xz -C "${dest}"`,
-    { stdio: "pipe" }
-  );
+  execSync(`curl -sL "${tarUrl}" | tar xz -C "${dest}"`, { stdio: "pipe" });
   const entries = await readdir(dest);
   const extracted = entries.find((e) => e.startsWith("projx-"));
   if (!extracted) throw new Error("Failed to extract repo archive.");
@@ -293,7 +333,9 @@ async function discoverComponentPaths(cwd, components) {
 async function discoverComponentsFromMarkers(cwd) {
   const components = [];
   const paths = {};
-  if (!existsSync(cwd)) return { components, paths };
+  const instances = [];
+  if (!existsSync(cwd))
+    return { components, paths, instances };
   const entries = await readdir(cwd, { withFileTypes: true });
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
@@ -301,6 +343,7 @@ async function discoverComponentsFromMarkers(cwd) {
     if (entry.name.startsWith(".")) continue;
     const marker = await readComponentMarker(join(cwd, entry.name));
     if (!marker) continue;
+    instances.push({ type: marker.component, path: entry.name });
     if (!components.includes(marker.component)) {
       components.push(marker.component);
       paths[marker.component] = entry.name;
@@ -309,33 +352,82 @@ async function discoverComponentsFromMarkers(cwd) {
   for (const c of components) {
     if (!paths[c]) paths[c] = c;
   }
-  return { components, paths };
+  return { components, paths, instances };
 }
 function render(template, vars) {
+  const lines = template.split("\n");
+  return renderLines(lines, vars).replace(/\n{3,}/g, "\n\n");
+}
+function evalExpr(expr, vars) {
   const components = vars.components;
   const projectName = vars.projectName;
-  const lines = template.split("\n");
+  const pmName = vars.pm?.name ?? "npm";
+  const argNames = ["components", "projectName", "pm"];
+  const argValues = [components, projectName, pmName];
+  for (const [k, v] of Object.entries(vars)) {
+    if (k === "components" || k === "projectName" || k === "pm") continue;
+    if (!/^[a-zA-Z_$][\w$]*$/.test(k)) continue;
+    argNames.push(k);
+    argValues.push(v);
+  }
+  const fn = new Function(...argNames, `return ${expr}`);
+  return fn(...argValues);
+}
+function findBlockEnd(lines, startIdx) {
+  let depth = 1;
+  for (let i = startIdx + 1; i < lines.length; i++) {
+    const line = lines[i];
+    if (/^<%\s*(if|for)\s*\(.+?\)\s*\{?\s*%>$/.test(line)) depth++;
+    else if (/^<%\s*\}\s*else\s+if\s*\((.+?)\)\s*\{?\s*%>$/.test(line)) {
+    } else if (/^<%\s*\}\s*else\s*\{?\s*%>$/.test(line)) {
+    } else if (/^<%\s*\}?\s*%>$/.test(line)) {
+      depth--;
+      if (depth === 0) return i;
+    }
+  }
+  throw new Error("Unmatched template block");
+}
+function renderLines(lines, vars) {
   const output = [];
   const stack = [];
-  for (const line of lines) {
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const forMatch = line.match(
+      /^<%\s*for\s*\(\s*(?:const|let)\s+(\w+)\s+of\s+(.+?)\s*\)\s*\{?\s*%>$/
+    );
+    if (forMatch) {
+      const varName = forMatch[1];
+      const iterExpr = forMatch[2];
+      const end = findBlockEnd(lines, i);
+      const bodyLines = lines.slice(i + 1, end);
+      if (stack.length === 0 || stack.every((v) => v.active)) {
+        const iterable = evalExpr(iterExpr, vars);
+        if (Array.isArray(iterable)) {
+          for (const item of iterable) {
+            const sub = renderLines(bodyLines, { ...vars, [varName]: item });
+            if (sub) output.push(sub);
+          }
+        }
+      }
+      i = end;
+      continue;
+    }
     const ifMatch = line.match(/^<%\s*if\s*\((.+?)\)\s*\{?\s*%>$/);
     if (ifMatch) {
-      const pmName = vars.pm?.name ?? "npm";
-      const fn = new Function("components", "projectName", "pm", `return ${ifMatch[1]}`);
-      const result = fn(components, projectName, pmName);
+      const result = Boolean(evalExpr(ifMatch[1], vars));
       stack.push({ active: result, matched: result });
       continue;
     }
-    const elseIfMatch = line.match(/^<%\s*\}\s*else\s+if\s*\((.+?)\)\s*\{?\s*%>$/);
+    const elseIfMatch = line.match(
+      /^<%\s*\}\s*else\s+if\s*\((.+?)\)\s*\{?\s*%>$/
+    );
     if (elseIfMatch) {
       if (stack.length > 0) {
         const top = stack[stack.length - 1];
         if (top.matched) {
           top.active = false;
         } else {
-          const pmN = vars.pm?.name ?? "npm";
-          const fn = new Function("components", "projectName", "pm", `return ${elseIfMatch[1]}`);
-          const result = fn(components, projectName, pmN);
+          const result = Boolean(evalExpr(elseIfMatch[1], vars));
           top.active = result;
           if (result) top.matched = true;
         }
@@ -354,20 +446,33 @@ function render(template, vars) {
       continue;
     }
     if (stack.length > 0 && stack.some((v) => !v.active)) continue;
-    const replaced = line.replace(
-      /<%=\s*([\w.]+)\s*%>/g,
-      (_, expr) => {
-        const parts = expr.split(".");
-        let val = vars;
-        for (const p of parts) {
-          val = val?.[p];
-        }
-        return String(val ?? "");
+    const replaced = line.replace(/<%=\s*([\w.]+)\s*%>/g, (_, expr) => {
+      const parts = expr.split(".");
+      let val = vars;
+      for (const p of parts) {
+        val = val?.[p];
       }
-    );
+      return String(val ?? "");
+    });
     output.push(replaced);
   }
-  return output.join("\n").replace(/\n{3,}/g, "\n\n");
+  return output.join("\n");
+}
+async function renderEjsInDir(dir, vars) {
+  if (!existsSync(dir)) return;
+  const entries = await readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      await renderEjsInDir(full, vars);
+    } else if (entry.name.endsWith(".ejs")) {
+      const content = await readFile(full, "utf-8");
+      const rendered = render(content, vars);
+      const out = full.slice(0, -".ejs".length);
+      await writeFile(out, rendered);
+      await rm(full);
+    }
+  }
 }
 function detectProjectName(cwd, components, componentPaths) {
   for (const component of components) {
@@ -420,5 +525,6 @@ export {
   discoverComponentPaths,
   discoverComponentsFromMarkers,
   render,
+  renderEjsInDir,
   detectProjectName
 };