fwinit 1.0.0

package/README.md

@@ -0,0 +1,87 @@
+# fwinit
+
+CLI para crear proyectos desde templates. Instalás una vez y scaffoldás proyectos con un comando.
+
+## Instalación
+
+```bash
+npm install -g fwinit
+# o
+bun add -g fwinit
+```
+
+## Uso
+
+### Modo directo
+
+```bash
+fwinit fastify mi-api
+fwinit aspnet mi-app
+fwinit react-native mi-mobile
+```
+
+### Modo interactivo
+
+```bash
+fwinit
+```
+
+Te pregunta qué template usar y el nombre del proyecto.
+
+### Ver templates disponibles
+
+```bash
+fwinit list
+```
+
+### Help
+
+```bash
+fwinit --help
+```
+
+## Templates disponibles
+
+| Template | Descripción | Runtime |
+|----------|-------------|---------|
+| `aspnet` | API REST con ASP.NET Core, Clean Architecture y C# | dotnet |
+| `express` | API REST con Express, Prisma, TypeScript y Bun | bun |
+| `fastify` | API REST con Fastify, Prisma, TypeScript y Bun | bun |
+| `nodejs` | API con Node.js puro, Prisma, TypeScript y tsx | node |
+| `react-native` | App móvil con React Native, Expo y TypeScript | node |
+
+## Qué hace
+
+1. Descarga el ZIP del repositorio de templates desde GitHub
+2. Extrae el template seleccionado
+3. Lo copia al directorio del proyecto
+4. Limpia los lock files (cada proyecto instala los suyos)
+5. Te muestra los próximos pasos (install y dev)
+
+## Desarrollo
+
+```bash
+bun install
+bun run build        # build a dist/
+bun run dev          # watch mode
+bun run start        # ejecutar desde dist/
+bun run typecheck    # type check
+```
+
+### Probar localmente
+
+```bash
+node dist/index.js list
+node dist/index.js fastify mi-api
+```
+
+### Link global para desarrollo
+
+```bash
+bun link
+# ahora `fwinit` está disponible en todo el sistema
+```
+
+## Licencia
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,247 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import ora from "ora";
+import chalk from "chalk";
+
+// src/templates.ts
+var TEMPLATES = [
+  {
+    name: "ASP.NET",
+    alias: ["aspnet", "dotnet", "csharp"],
+    description: "API REST con ASP.NET Core, Clean Architecture y C#",
+    folder: "ASPNET"
+  },
+  {
+    name: "Express",
+    alias: ["express"],
+    description: "API REST con Express, Prisma, TypeScript y Bun",
+    folder: "EXPRESS"
+  },
+  {
+    name: "Fastify",
+    alias: ["fastify"],
+    description: "API REST con Fastify, Prisma, TypeScript y Bun",
+    folder: "FASTIFY"
+  },
+  {
+    name: "Node.js Vanilla",
+    alias: ["nodejs", "vanilla", "node"],
+    description: "API con Node.js puro, Prisma, TypeScript y tsx",
+    folder: "NODEJS-VANILLA"
+  },
+  {
+    name: "React Native",
+    alias: ["react-native", "rn", "expo"],
+    description: "App m\xF3vil con React Native, Expo y TypeScript",
+    folder: "REACT-NATIVE"
+  }
+];
+function findTemplate(input) {
+  const normalized = input.toLowerCase().trim();
+  return TEMPLATES.find(
+    (t) => t.folder.toLowerCase() === normalized || t.alias.includes(normalized)
+  );
+}
+
+// src/downloader.ts
+import AdmZip from "adm-zip";
+import { mkdir, rm, cp, readdir } from "fs/promises";
+import { join } from "path";
+import { tmpdir } from "os";
+import { randomBytes } from "crypto";
+var GITHUB_REPO = "orlandotellez/fwinit";
+var GITHUB_BRANCH = "main";
+async function downloadAndExtract(templateFolder) {
+  const url = `https://github.com/${GITHUB_REPO}/archive/refs/heads/${GITHUB_BRANCH}.zip`;
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(
+      `Failed to download template: ${response.statusText}`
+    );
+  }
+  const buffer = Buffer.from(await response.arrayBuffer());
+  const zip = new AdmZip(buffer);
+  const tempId = randomBytes(8).toString("hex");
+  const tempDir = join(tmpdir(), `fwinit-${tempId}`);
+  await mkdir(tempDir, { recursive: true });
+  zip.extractAllTo(tempDir, true);
+  const repoRoot = join(tempDir, `fwinit-${GITHUB_BRANCH}`);
+  const templatePath = join(repoRoot, "templates", templateFolder);
+  try {
+    await readdir(templatePath);
+  } catch {
+    await rm(tempDir, { recursive: true, force: true });
+    throw new Error(
+      `Template "${templateFolder}" not found in repository`
+    );
+  }
+  return { tempDir, templatePath };
+}
+async function copyTemplate(source, destination) {
+  await cp(source, destination, { recursive: true });
+  await cleanTemplate(destination);
+}
+async function cleanTemplate(dir) {
+  const lockFiles = [
+    "bun.lock",
+    "pnpm-lock.yaml",
+    "package-lock.json",
+    "yarn.lock"
+  ];
+  for (const file of lockFiles) {
+    const path = join(dir, file);
+    try {
+      await rm(path, { force: true });
+    } catch {
+    }
+  }
+}
+async function cleanup(tempDir) {
+  await rm(tempDir, { recursive: true, force: true });
+}
+
+// src/prompts.ts
+import inquirer from "inquirer";
+async function selectTemplate() {
+  const { template } = await inquirer.prompt([
+    {
+      type: "list",
+      name: "template",
+      message: "What project do you want to create?",
+      choices: TEMPLATES.map((t) => ({
+        name: `${t.name} \u2014 ${t.description}`,
+        value: t
+      }))
+    }
+  ]);
+  return template;
+}
+async function askProjectName() {
+  const { name } = await inquirer.prompt([
+    {
+      type: "input",
+      name: "name",
+      message: "Project name:",
+      validate: (input) => {
+        if (!input.trim()) return "Name cannot be empty";
+        if (!/^[a-zA-Z0-9_-]+$/.test(input)) {
+          return "Only letters, numbers, hyphens and underscores";
+        }
+        return true;
+      }
+    }
+  ]);
+  return name.trim();
+}
+
+// src/utils.ts
+import { existsSync } from "fs";
+import { resolve } from "path";
+function getProjectPath(name) {
+  return resolve(process.cwd(), name);
+}
+function projectExists(name) {
+  return existsSync(getProjectPath(name));
+}
+function printSuccess(projectName, templateName, postInit) {
+  const installCmd = postInit?.install || "npm install";
+  const devCmd = postInit?.dev || "npm run dev";
+  console.log(`
+\x1B[32m\u2714\x1B[0m Template downloaded
+\x1B[32m\u2714\x1B[0m Project created in ./${projectName}
+
+\x1B[1mNext steps:\x1B[0m
+
+  \x1B[36mcd ${projectName}\x1B[0m
+  \x1B[36m${installCmd}\x1B[0m
+  \x1B[36m${devCmd}\x1B[0m
+`);
+}
+
+// src/index.ts
+var program = new Command();
+program.name("fwinit").description("CLI to create projects from templates").version("1.0.0");
+program.command("list").description("Show available templates").action(() => {
+  console.log(
+    chalk.bold("\nAvailable templates:\n")
+  );
+  TEMPLATES.forEach((t) => {
+    console.log(
+      `  ${chalk.cyan(t.folder.toLowerCase())} \u2014 ${t.description}`
+    );
+  });
+  console.log();
+});
+program.argument("[template]", "Template to use").argument("[project-name]", "Project name").action(
+  async (templateArg, projectNameArg) => {
+    try {
+      let template = templateArg ? findTemplate(templateArg) : void 0;
+      let projectName = projectNameArg;
+      if (templateArg && !template) {
+        console.error(
+          chalk.red(
+            `
+\u2716 Template "${templateArg}" not found.
+`
+          )
+        );
+        console.log("Available templates:");
+        TEMPLATES.forEach(
+          (t) => console.log(`  - ${t.folder.toLowerCase()}`)
+        );
+        process.exit(1);
+      }
+      if (!template) {
+        template = await selectTemplate();
+      }
+      if (!projectName) {
+        projectName = await askProjectName();
+      }
+      if (projectExists(projectName)) {
+        console.error(
+          chalk.red(
+            `
+\u2716 Directory "${projectName}" already exists.`
+          )
+        );
+        process.exit(1);
+      }
+      const spinner = ora(
+        `Downloading ${template.name} template...`
+      ).start();
+      const { tempDir, templatePath } = await downloadAndExtract(template.folder);
+      spinner.text = "Creating project...";
+      await copyTemplate(
+        templatePath,
+        getProjectPath(projectName)
+      );
+      await cleanup(tempDir);
+      spinner.succeed("Template downloaded");
+      let postInit;
+      try {
+        const { readFile } = await import("fs/promises");
+        const { join: join2 } = await import("path");
+        const tj = JSON.parse(
+          await readFile(
+            join2(getProjectPath(projectName), "template.json"),
+            "utf-8"
+          )
+        );
+        postInit = tj.postInit;
+      } catch {
+      }
+      printSuccess(projectName, template.name, postInit);
+    } catch (error) {
+      console.error(
+        chalk.red(
+          `
+\u2716 Error: ${error.message}`
+        )
+      );
+      process.exit(1);
+    }
+  }
+);
+program.parse();

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "fwinit",
+  "version": "1.0.0",
+  "description": "CLI para crear proyectos desde templates",
+  "type": "module",
+  "bin": {
+    "fwinit": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "dev": "tsup src/index.ts --format esm --watch",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "chmod +x dist/index.js"
+  },
+  "dependencies": {
+    "adm-zip": "^0.5.16",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "inquirer": "^12.4.2",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "@types/adm-zip": "^0.5.7",
+    "@types/node": "^22.13.10",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.2"
+  },
+  "keywords": [
+    "cli",
+    "templates",
+    "scaffolding",
+    "framework",
+    "boilerplate"
+  ],
+  "author": "Orlando Téllez",
+  "license": "MIT"
+}