abw-react-starter 1.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,175 @@
+# 🚀 abw-react-starter
+
+CLI to quickly bootstrap a fullstack project with:
+
+* ⚙️ **Strapi (Backend)**
+* ⚡ **Next.js (Frontend)**
+* ☁️ **Heroku deployment (optional)**
+* 🪣 **AWS S3 upload support (optional)**
+
+---
+
+## 📦 Installation
+
+### Option 1: Use without installing (recommended)
+
+```bash
+npx abw-react-starter create my-app
+```
+
+### Option 2: Install globally
+
+```bash
+npm install -g abw-react-starter
+```
+
+Then:
+
+```bash
+abw-react-starter create my-app
+```
+
+---
+
+## 🚀 Usage
+
+### Create a new project
+
+```bash
+abw-react-starter create my-app
+```
+
+or simply:
+
+```bash
+abw-react-starter my-app
+```
+
+---
+
+## ⚙️ What it does
+
+* Creates a full project structure:
+
+  * `/backend` → Strapi (TypeScript)
+  * `/frontend` → Next.js
+* Initializes Git repositories
+* Configures environment variables
+* Optionally sets up:
+
+  * AWS S3 uploads
+  * Heroku deployment (backend + frontend)
+
+---
+
+## ☁️ Deployment
+
+During setup, you will be asked:
+
+* Whether to deploy to Heroku
+* App names for backend and frontend
+* Login (if not authenticated)
+
+### Or deploy later:
+
+```bash
+abw-react-starter publish my-app
+```
+
+---
+
+## 🪣 AWS S3 Support
+
+If enabled, the CLI will:
+
+* Install S3 upload provider
+* Configure:
+
+  * `plugins.ts`
+  * `middlewares.ts`
+* Ask for:
+
+  * Bucket name
+  * Region
+  * Access keys
+* Automatically configure Heroku env variables
+
+---
+
+## 🔐 Requirements
+
+Make sure you have installed:
+
+* Node.js (>= 18)
+* npm
+* Git
+* Heroku CLI
+
+---
+
+## 🧪 Local Development
+
+### Backend
+
+```bash
+cd backend
+npm run develop
+```
+
+### Frontend
+
+```bash
+cd frontend
+npm run dev
+```
+
+---
+
+## 📁 Project Structure
+
+```
+my-app/
+├── backend/     # Strapi API
+├── frontend/    # Next.js app
+└── .abw-starter.json
+```
+
+---
+
+## 🔄 Updating
+
+If installed globally:
+
+```bash
+npm update -g abw-react-starter
+```
+
+---
+
+## 🐛 Troubleshooting
+
+### Heroku app name already taken
+
+The CLI will automatically:
+
+1. Try your chosen name
+2. Try a random suffix
+3. Fallback to Heroku-generated name
+
+---
+
+### Not logged into Heroku
+
+The CLI will prompt you to login automatically.
+
+---
+
+## 📄 License
+
+MIT
+
+---
+
+## 👨‍💻 Author
+
+Built with ❤️ by ABWorks

package/bin/create.js

@@ -18,6 +18,10 @@ function randHex(bytes = 16) {
   return crypto.randomBytes(bytes).toString("hex");
 }
 
+function randSuffix(size = 6) {
+  return crypto.randomBytes(size).toString("hex").slice(0, size);
+}
+
 async function run(cmd, args, opts = {}) {
   const p = execa(cmd, args, {
     stdio: "inherit",
@@ -43,6 +47,63 @@ async function assertCmdExists(cmd, args = ["--version"]) {
   }
 }
 
+function looksLikeHerokuNameTakenError(err) {
+  const msg = String(err?.stderr || err?.shortMessage || err?.message || "").toLowerCase();
+  return msg.includes("name") && (msg.includes("taken") || msg.includes("already exists"));
+}
+
+async function getHerokuAppInfo(appName, cwd) {
+  const raw = await runCapture("heroku", ["apps:info", "-a", appName, "--json"], { cwd });
+  return JSON.parse(raw || "{}");
+}
+
+async function createHerokuAppWithFallback({ cwd, requestedName, region, label }) {
+  const attempts = [];
+
+  if (requestedName) {
+    attempts.push(requestedName);
+    attempts.push(`${requestedName}-${randSuffix(4)}`);
+    attempts.push(`${requestedName}-${randSuffix(6)}`);
+  }
+
+  for (const candidate of attempts) {
+    try {
+      console.log(`\n=== ${label}: tentar criar app Heroku "${candidate}" ===\n`);
+      await run("heroku", ["create", candidate, "--region", region], { cwd });
+      return candidate;
+    } catch (err) {
+      if (looksLikeHerokuNameTakenError(err)) {
+        console.log(`⚠️ Nome já ocupado: ${candidate}`);
+        continue;
+      }
+      throw err;
+    }
+  }
+
+  console.log(`\n=== ${label}: a criar app Heroku com nome automático ===\n`);
+  await run("heroku", ["create", "--region", region], { cwd });
+
+  const whoRaw = await runCapture("heroku", ["apps", "--json"], { cwd });
+  const apps = JSON.parse(whoRaw || "[]");
+
+  if (!Array.isArray(apps) || apps.length === 0) {
+    throw new Error(`Não consegui descobrir o nome final da app Heroku (${label}).`);
+  }
+
+  apps.sort((a, b) => {
+    const da = new Date(a?.created_at || 0).getTime();
+    const db = new Date(b?.created_at || 0).getTime();
+    return db - da;
+  });
+
+  const latest = apps[0]?.name;
+  if (!latest) {
+    throw new Error(`Não consegui descobrir o nome final da app Heroku (${label}).`);
+  }
+
+  return latest;
+}
+
 /* =========================
    Heroku Login (melhorado)
 ========================= */
@@ -176,6 +237,11 @@ async function configureBackendS3(projectDir, aws) {
           },
         },
       },
+      actionOptions: {
+        upload: {},
+        uploadStream: {},
+        delete: {},
+      },
     },
   },
 });
@@ -255,26 +321,54 @@ async function createFrontendLocal(projectDir, nodeVersion) {
 async function deployBackendHeroku({ projectDir, backendApp, region }) {
   const beDir = path.join(projectDir, "backend");
 
-  await run("heroku", ["create", backendApp, "--region", region], { cwd: beDir });
-  await run("heroku", ["git:remote", "-a", backendApp], { cwd: beDir });
-  await run("heroku", ["addons:create", "heroku-postgresql", "-a", backendApp], { cwd: beDir });
+  const finalBackendApp = await createHerokuAppWithFallback({
+    cwd: beDir,
+    requestedName: backendApp,
+    region,
+    label: "BACKEND",
+  });
+
+  await run("heroku", ["git:remote", "-a", finalBackendApp], { cwd: beDir });
+  await run("heroku", ["addons:create", "heroku-postgresql", "-a", finalBackendApp], { cwd: beDir });
 
   const envPath = path.join(beDir, ".env");
 
   if (await fs.pathExists(envPath)) {
     const env = await fs.readFile(envPath, "utf8");
-    const get = (k) => env.match(new RegExp(`${k}=(.*)`))?.[1]?.trim();
-
-    await run("heroku", ["config:set", `AWS_BUCKET=${get("AWS_BUCKET")}`, "-a", backendApp], { cwd: beDir });
-    await run("heroku", ["config:set", `AWS_REGION=${get("AWS_REGION")}`, "-a", backendApp], { cwd: beDir });
-    await run("heroku", ["config:set", `AWS_ACCESS_KEY_ID=${get("AWS_ACCESS_KEY_ID")}`, "-a", backendApp], { cwd: beDir });
-    await run("heroku", ["config:set", `AWS_ACCESS_SECRET=${get("AWS_ACCESS_SECRET")}`, "-a", backendApp], { cwd: beDir });
+    const get = (k) => env.match(new RegExp(`^${k}=(.*)$`, "m"))?.[1]?.trim();
+
+    const awsBucket = get("AWS_BUCKET");
+    const awsRegion = get("AWS_REGION");
+    const awsAccessKeyId = get("AWS_ACCESS_KEY_ID");
+    const awsAccessSecret = get("AWS_ACCESS_SECRET");
+
+    if (awsBucket) {
+      await run("heroku", ["config:set", `AWS_BUCKET=${awsBucket}`, "-a", finalBackendApp], { cwd: beDir });
+    }
+    if (awsRegion) {
+      await run("heroku", ["config:set", `AWS_REGION=${awsRegion}`, "-a", finalBackendApp], { cwd: beDir });
+    }
+    if (awsAccessKeyId) {
+      await run("heroku", ["config:set", `AWS_ACCESS_KEY_ID=${awsAccessKeyId}`, "-a", finalBackendApp], { cwd: beDir });
+    }
+    if (awsAccessSecret) {
+      await run("heroku", ["config:set", `AWS_ACCESS_SECRET=${awsAccessSecret}`, "-a", finalBackendApp], { cwd: beDir });
+    }
   }
 
   await run("git", ["push", "heroku", "main"], { cwd: beDir });
 
-  const info = JSON.parse(await runCapture("heroku", ["apps:info", "-a", backendApp, "--json"]));
-  return ensureNoTrailingSlash(info?.app?.web_url);
+  const info = await getHerokuAppInfo(finalBackendApp, beDir);
+  const backendWebUrl = ensureNoTrailingSlash(info?.app?.web_url);
+
+  if (!backendWebUrl) {
+    throw new Error("Não consegui obter web_url do backend no Heroku.");
+  }
+
+  return {
+    backendApp: finalBackendApp,
+    backendWebUrl,
+  };
 }
 
 /* =========================
@@ -284,17 +378,32 @@ async function deployBackendHeroku({ projectDir, backendApp, region }) {
 async function deployFrontendHeroku({ projectDir, frontendApp, region, backendWebUrl }) {
   const feDir = path.join(projectDir, "frontend");
 
-  await run("heroku", ["create", frontendApp, "--region", region], { cwd: feDir });
-  await run("heroku", ["git:remote", "-a", frontendApp], { cwd: feDir });
+  const finalFrontendApp = await createHerokuAppWithFallback({
+    cwd: feDir,
+    requestedName: frontendApp,
+    region,
+    label: "FRONTEND",
+  });
 
-  await run("heroku", ["config:set", `NEXT_PUBLIC_STRAPI_URL=${backendWebUrl}`, "-a", frontendApp], {
+  await run("heroku", ["git:remote", "-a", finalFrontendApp], { cwd: feDir });
+
+  await run("heroku", ["config:set", `NEXT_PUBLIC_STRAPI_URL=${backendWebUrl}`, "-a", finalFrontendApp], {
     cwd: feDir,
   });
 
   await run("git", ["push", "heroku", "main"], { cwd: feDir });
 
-  const info = JSON.parse(await runCapture("heroku", ["apps:info", "-a", frontendApp, "--json"]));
-  return ensureNoTrailingSlash(info?.app?.web_url);
+  const info = await getHerokuAppInfo(finalFrontendApp, feDir);
+  const frontendWebUrl = ensureNoTrailingSlash(info?.app?.web_url);
+
+  if (!frontendWebUrl) {
+    throw new Error("Não consegui obter web_url do frontend no Heroku.");
+  }
+
+  return {
+    frontendApp: finalFrontendApp,
+    frontendWebUrl,
+  };
 }
 
 /* =========================
@@ -385,29 +494,38 @@ async function doPublish(projectDirArg) {
   if (!canPublish) return;
 
   const manifest = await readManifest(projectDir);
+  if (!manifest) {
+    throw new Error(
+      `Não encontrei ${MANIFEST_NAME} em ${projectDir}. Cria o projeto com "abw-react-starter create <dir>" primeiro.`
+    );
+  }
 
-  const backendWebUrl = await deployBackendHeroku({
+  const backendResult = await deployBackendHeroku({
     projectDir,
     backendApp: manifest.backendApp,
     region: manifest.region,
   });
 
-  const frontendWebUrl = await deployFrontendHeroku({
+  const frontendResult = await deployFrontendHeroku({
     projectDir,
     frontendApp: manifest.frontendApp,
     region: manifest.region,
-    backendWebUrl,
+    backendWebUrl: backendResult.backendWebUrl,
   });
 
   await writeManifest(projectDir, {
     ...manifest,
-    backendUrl: backendWebUrl,
-    frontendUrl: frontendWebUrl,
+    backendApp: backendResult.backendApp,
+    frontendApp: frontendResult.frontendApp,
+    backendUrl: backendResult.backendWebUrl,
+    frontendUrl: frontendResult.frontendWebUrl,
   });
 
   console.log("\n✅ Tudo pronto!");
-  console.log("Backend:", backendWebUrl);
-  console.log("Frontend:", frontendWebUrl);
+  console.log("Backend app:", backendResult.backendApp);
+  console.log("Backend:", backendResult.backendWebUrl);
+  console.log("Frontend app:", frontendResult.frontendApp);
+  console.log("Frontend:", frontendResult.frontendWebUrl);
 }
 
 /* =========================

package/package.json

@@ -1,13 +1,18 @@
 {
   "name": "abw-react-starter",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "CLI para criar projetos Strapi + Next + Heroku",
   "bin": {
     "abw-react-starter": "./bin/create.js"
   },
   "type": "module",
   "scripts": {},
-  "keywords": ["cli", "strapi", "nextjs", "heroku"],
+  "keywords": [
+    "cli",
+    "strapi",
+    "nextjs",
+    "heroku"
+  ],
   "author": "ABWorks",
   "license": "MIT",
   "dependencies": {
@@ -16,4 +21,4 @@
     "fs-extra": "^11.0.0",
     "execa": "^8.0.0"
   }
-}
+}