ar-saas 0.1.0

package/README.md

@@ -0,0 +1,62 @@
+# ar-saas
+
+Generador de proyectos SaaS multi-tenant para startups argentinas.
+
+## Quickstart
+
+```bash
+npx ar-saas mi-proyecto
+```
+
+Seguí el asistente interactivo y en minutos tenés un proyecto listo para correr.
+
+## Qué genera
+
+**Backend** — NestJS 11 + MongoDB + JWT en cookies HttpOnly + multi-tenancy por workspace + mail con Resend + Swagger automático.
+
+**Frontend** — Next.js 15 + Tailwind CSS 4 + shadcn/ui + auth completo + refresh automático de tokens.
+
+## Módulos incluidos (free)
+
+- Auth completo: registro, login, verificación de email, reset de password
+- Multi-tenancy con aislamiento estricto por `workspaceId`
+- Mail transaccional con Resend (verificación, bienvenida, reset)
+
+## Módulos adicionales
+
+| Módulo | Descripción |
+|---|---|
+| OAuth + 2FA | Login con GitHub/Google + autenticación de dos factores |
+| Notificaciones | Notificaciones in-app + Push Web (VAPID) |
+| Invoices + Quotes | Facturación con generación de PDF |
+| CRM | Kanban + Pipeline de ventas |
+| MercadoPago | Suscripciones recurrentes con webhooks |
+
+## Opciones de deploy
+
+El CLI genera la configuración para:
+
+- **Railway** — `railway.toml` listo para usar
+- **Fly.io** — `fly.toml` con región `gru` (São Paulo)
+- **Docker** — `docker-compose.yml` con MongoDB incluido
+
+## Requisitos
+
+- Node.js 18+
+- MongoDB (o usar el Docker Compose incluido)
+- Cuenta en [Resend](https://resend.com) para emails
+
+## Variables de entorno
+
+El CLI copia `.env.example` → `.env` automáticamente. Completar al menos:
+
+```
+MONGODB_URI=
+JWT_ACCESS_SECRET=
+JWT_REFRESH_SECRET=
+RESEND_API_KEY=
+```
+
+## Licencia
+
+MIT — el código generado es tuyo, sin restricciones.

package/dist/cli.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCli = runCli;
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+const ALWAYS_INCLUDED = ['auth', 'multi-tenancy', 'mail'];
+async function runCli() {
+    console.log(chalk_1.default.bold('\n  ar-saas'));
+    console.log(chalk_1.default.gray('  Backend NestJS + Frontend Next.js listos para producción\n'));
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'projectName',
+            message: 'Nombre del proyecto:',
+            default: 'my-saas',
+            validate: (input) => {
+                if (!/^[a-z0-9][a-z0-9-]{1,}$/.test(input)) {
+                    return 'Solo letras minúsculas, números y guiones (mínimo 2 caracteres)';
+                }
+                return true;
+            },
+        },
+        {
+            type: 'list',
+            name: 'stack',
+            message: '¿Qué querés generar?',
+            choices: [
+                { name: 'Backend + Frontend', value: 'backend-frontend' },
+                { name: 'Solo Backend (NestJS)', value: 'backend' },
+                { name: 'Solo Frontend (Next.js)', value: 'frontend' },
+            ],
+        },
+        {
+            type: 'checkbox',
+            name: 'modules',
+            message: 'Módulos adicionales:',
+            choices: [
+                { name: 'OAuth GitHub/Google + 2FA', value: 'auth-advanced' },
+                { name: 'Notificaciones + Push Web', value: 'notifications' },
+                { name: 'Invoices + Quotes + PDF', value: 'invoices' },
+                { name: 'CRM + Kanban', value: 'crm' },
+                { name: 'MercadoPago suscripciones', value: 'mercadopago' },
+            ],
+            filter: (selected) => Array.from(new Set([...ALWAYS_INCLUDED, ...selected])),
+        },
+        {
+            type: 'list',
+            name: 'deployTarget',
+            message: '¿Dónde lo vas a deployar?',
+            choices: [
+                { name: 'Railway', value: 'railway' },
+                { name: 'Fly.io', value: 'flyio' },
+                { name: 'Docker', value: 'docker' },
+                { name: 'Después', value: 'later' },
+            ],
+        },
+    ]);
+    return {
+        projectName: answers.projectName,
+        stack: answers.stack,
+        modules: answers.modules,
+        deployTarget: answers.deployTarget,
+    };
+}

package/dist/generator.js

@@ -0,0 +1,242 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generate = generate;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const TEMPLATES_DIR = path_1.default.join(__dirname, '..', 'templates');
+const TEXT_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.json', '.md', '.txt',
+    '.env', '.example',
+    '.yml', '.yaml',
+    '.toml', '.ini',
+    '.html', '.css',
+    '.gitignore', '.npmignore', '.eslintrc',
+    '.prettierrc', '.editorconfig',
+    'Dockerfile', 'Makefile', 'Procfile',
+]);
+const SKIP_DIRS = new Set(['.git', 'node_modules', 'dist', '.next', '.turbo', 'build']);
+const PRO_MODULES = new Set(['auth-advanced', 'notifications', 'invoices', 'crm', 'mercadopago']);
+async function generate(config) {
+    const projectDir = path_1.default.join(process.cwd(), config.projectName);
+    const spinner = (0, ora_1.default)();
+    console.log();
+    if (fs_1.default.existsSync(projectDir)) {
+        console.error(chalk_1.default.red(`✖ El directorio "${config.projectName}" ya existe`));
+        process.exit(1);
+    }
+    spinner.start(`Creando ${chalk_1.default.cyan(config.projectName)}...`);
+    fs_1.default.mkdirSync(projectDir, { recursive: true });
+    const hasBackend = config.stack === 'backend' || config.stack === 'backend-frontend';
+    const hasFrontend = config.stack === 'frontend' || config.stack === 'backend-frontend';
+    const hasValidPro = [...config.modules].some((m) => PRO_MODULES.has(m));
+    if (hasBackend) {
+        spinner.text = 'Copiando backend...';
+        const src = path_1.default.join(TEMPLATES_DIR, 'backend');
+        const dest = path_1.default.join(projectDir, 'backend');
+        if (!fs_1.default.existsSync(src) || fs_1.default.readdirSync(src).length === 0) {
+            spinner.warn(chalk_1.default.yellow('Templates de backend vacíos — ejecutá npm run sync-templates antes de publicar'));
+            fs_1.default.mkdirSync(dest, { recursive: true });
+        }
+        else {
+            await fs_extra_1.default.copy(src, dest);
+            processDir(dest, config, hasValidPro);
+        }
+    }
+    if (hasFrontend) {
+        spinner.text = 'Copiando frontend...';
+        const src = path_1.default.join(TEMPLATES_DIR, 'frontend');
+        const dest = path_1.default.join(projectDir, 'frontend');
+        if (!fs_1.default.existsSync(src) || fs_1.default.readdirSync(src).length === 0) {
+            spinner.warn(chalk_1.default.yellow('Templates de frontend vacíos — ejecutá npm run sync-templates antes de publicar'));
+            fs_1.default.mkdirSync(dest, { recursive: true });
+        }
+        else {
+            await fs_extra_1.default.copy(src, dest);
+            processDir(dest, config, hasValidPro);
+        }
+    }
+    spinner.text = 'Generando configuración de deploy...';
+    generateDeployConfig(projectDir, config);
+    spinner.text = 'Configurando variables de entorno...';
+    setupEnvFiles(projectDir, config);
+    spinner.succeed(chalk_1.default.green(`Proyecto ${chalk_1.default.bold(config.projectName)} creado`));
+    printNextSteps(config);
+}
+function processDir(dir, config, hasValidPro) {
+    for (const file of collectTextFiles(dir)) {
+        try {
+            let content = fs_1.default.readFileSync(file, 'utf-8');
+            content = applyNameReplacements(content, config.projectName);
+            content = applyProModuleHandling(content, hasValidPro);
+            fs_1.default.writeFileSync(file, content, 'utf-8');
+        }
+        catch {
+            // skip unreadable or binary files
+        }
+    }
+}
+function collectTextFiles(dir) {
+    const result = [];
+    for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+        const fullPath = path_1.default.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (!SKIP_DIRS.has(entry.name)) {
+                result.push(...collectTextFiles(fullPath));
+            }
+        }
+        else {
+            const ext = path_1.default.extname(entry.name);
+            if (TEXT_EXTENSIONS.has(ext) || TEXT_EXTENSIONS.has(entry.name) || entry.name.startsWith('.')) {
+                result.push(fullPath);
+            }
+        }
+    }
+    return result;
+}
+function applyNameReplacements(content, projectName) {
+    return content
+        .replace(/create-saas-ar-backend/g, `${projectName}-backend`)
+        .replace(/create-saas-ar-frontend/g, `${projectName}-frontend`)
+        .replace(/create-saas-ar/g, projectName);
+}
+function applyProModuleHandling(content, hasValidPro) {
+    if (hasValidPro) {
+        // Uncomment PRO code: remove the "// [PRO] " prefix
+        return content.replace(/^(\s*)\/\/ \[PRO\] /gm, '$1');
+    }
+    // Add explanatory placeholder for PRO lines
+    return content.replace(/^(\s*)\/\/ \[PRO\] (.+)$/gm, '$1// [PRO MODULE] $2 — requiere licencia PRO: https://ar-saas.dev');
+}
+function generateDeployConfig(projectDir, config) {
+    if (config.deployTarget === 'later')
+        return;
+    if (config.deployTarget === 'docker') {
+        fs_1.default.writeFileSync(path_1.default.join(projectDir, 'docker-compose.yml'), buildDockerCompose(config), 'utf-8');
+    }
+    if (config.deployTarget === 'railway') {
+        fs_1.default.writeFileSync(path_1.default.join(projectDir, 'railway.toml'), buildRailwayConfig(), 'utf-8');
+    }
+    if (config.deployTarget === 'flyio') {
+        fs_1.default.writeFileSync(path_1.default.join(projectDir, 'fly.toml'), buildFlyConfig(config), 'utf-8');
+    }
+}
+function buildDockerCompose(config) {
+    const hasBackend = config.stack === 'backend' || config.stack === 'backend-frontend';
+    const hasFrontend = config.stack === 'frontend' || config.stack === 'backend-frontend';
+    const services = [];
+    if (hasBackend) {
+        services.push(`  backend:
+    build: ./backend
+    ports:
+      - "3000:3000"
+    env_file:
+      - ./backend/.env
+    depends_on:
+      - mongodb
+    restart: unless-stopped
+
+  mongodb:
+    image: mongo:7
+    ports:
+      - "27017:27017"
+    volumes:
+      - mongodb_data:/data/db
+    restart: unless-stopped`);
+    }
+    if (hasFrontend) {
+        services.push(`  frontend:
+    build: ./frontend
+    ports:
+      - "3001:3000"
+    env_file:
+      - ./frontend/.env.local
+    environment:
+      - NEXT_PUBLIC_API_URL=http://backend:3000
+    ${hasBackend ? 'depends_on:\n      - backend\n    ' : ''}restart: unless-stopped`);
+    }
+    const volumes = hasBackend ? '\nvolumes:\n  mongodb_data:' : '';
+    return `version: '3.8'
+
+services:
+${services.join('\n\n')}
+${volumes}
+`;
+}
+function buildRailwayConfig() {
+    return `[build]
+builder = "nixpacks"
+
+[deploy]
+startCommand = "npm run start:prod"
+healthcheckPath = "/api/health"
+healthcheckTimeout = 30
+restartPolicyType = "on_failure"
+`;
+}
+function buildFlyConfig(config) {
+    return `app = "${config.projectName}"
+primary_region = "gru"
+
+[build]
+
+[http_service]
+  internal_port = 3000
+  force_https = true
+  auto_stop_machines = true
+  auto_start_machines = true
+  min_machines_running = 0
+
+[[vm]]
+  memory = "256mb"
+  cpu_kind = "shared"
+  cpus = 1
+`;
+}
+function setupEnvFiles(projectDir, config) {
+    const hasBackend = config.stack === 'backend' || config.stack === 'backend-frontend';
+    const hasFrontend = config.stack === 'frontend' || config.stack === 'backend-frontend';
+    if (hasBackend) {
+        const example = path_1.default.join(projectDir, 'backend', '.env.example');
+        const dest = path_1.default.join(projectDir, 'backend', '.env');
+        if (fs_1.default.existsSync(example) && !fs_1.default.existsSync(dest)) {
+            fs_extra_1.default.copySync(example, dest);
+        }
+    }
+    if (hasFrontend) {
+        const example = path_1.default.join(projectDir, 'frontend', '.env.local.example');
+        const dest = path_1.default.join(projectDir, 'frontend', '.env.local');
+        if (fs_1.default.existsSync(example) && !fs_1.default.existsSync(dest)) {
+            fs_extra_1.default.copySync(example, dest);
+        }
+    }
+}
+function printNextSteps(config) {
+    const hasBackend = config.stack === 'backend' || config.stack === 'backend-frontend';
+    const hasFrontend = config.stack === 'frontend' || config.stack === 'backend-frontend';
+    console.log();
+    console.log(chalk_1.default.bold('Próximos pasos:'));
+    if (hasBackend) {
+        console.log();
+        console.log(chalk_1.default.cyan(`  cd ${config.projectName}/backend`));
+        console.log(chalk_1.default.gray('  # Completar las variables en .env'));
+        console.log(chalk_1.default.cyan('  npm install'));
+        console.log(chalk_1.default.cyan('  npm run start:dev'));
+    }
+    if (hasFrontend) {
+        console.log();
+        console.log(chalk_1.default.cyan(`  cd ${config.projectName}/frontend`));
+        console.log(chalk_1.default.gray('  # Completar .env.local con la URL del backend'));
+        console.log(chalk_1.default.cyan('  npm install'));
+        console.log(chalk_1.default.cyan('  npm run dev'));
+    }
+    console.log();
+    console.log(chalk_1.default.gray('  Documentación: https://ar-saas.dev/docs'));
+    console.log();
+}

package/dist/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("./cli");
+const generator_1 = require("./generator");
+async function main() {
+    const config = await (0, cli_1.runCli)();
+    await (0, generator_1.generate)(config);
+}
+main().catch((error) => {
+    console.error(error.message);
+    process.exit(1);
+});

package/dist/license.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateLicense = validateLicense;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const CACHE_DIR = path_1.default.join(os_1.default.homedir(), '.ar-saas');
+const CACHE_FILE = path_1.default.join(CACHE_DIR, 'license');
+const LICENSE_API = 'https://api.create-saas-ar.dev/licenses/validate';
+const LICENSE_REGEX = /^CSAR-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/;
+async function validateLicense(license) {
+    const normalized = license.trim().toUpperCase();
+    if (!LICENSE_REGEX.test(normalized)) {
+        return {
+            valid: false,
+            error: 'Formato inválido. La licencia debe tener el formato CSAR-XXXX-XXXX-XXXX',
+        };
+    }
+    const cached = readCache();
+    if (cached === normalized) {
+        return { valid: true };
+    }
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 5000);
+        const response = await fetch(LICENSE_API, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ license: normalized }),
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        if (!response.ok) {
+            return { valid: false, error: 'Licencia inválida o expirada' };
+        }
+        const data = (await response.json());
+        if (data.valid) {
+            writeCache(normalized);
+            return { valid: true };
+        }
+        return { valid: false, error: 'Licencia inválida o expirada' };
+    }
+    catch {
+        // Fail open: si la API no está disponible, aceptar la licencia
+        writeCache(normalized);
+        return { valid: true };
+    }
+}
+function readCache() {
+    try {
+        if (fs_1.default.existsSync(CACHE_FILE)) {
+            return fs_1.default.readFileSync(CACHE_FILE, 'utf-8').trim();
+        }
+    }
+    catch {
+        // ignore
+    }
+    return null;
+}
+function writeCache(license) {
+    try {
+        fs_1.default.mkdirSync(CACHE_DIR, { recursive: true });
+        fs_1.default.writeFileSync(CACHE_FILE, license, 'utf-8');
+    }
+    catch {
+        // ignore — no bloquear al usuario si no se puede escribir la caché
+    }
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "ar-saas",
+  "version": "0.1.0",
+  "description": "Generador de proyectos SaaS multi-tenant para startups argentinas",
+  "main": "dist/index.js",
+  "bin": {
+    "ar-saas": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "templates/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "sync-templates": "tsx scripts/sync-templates.ts",
+    "prepublishOnly": "npm run sync-templates && npm run build"
+  },
+  "keywords": [
+    "saas",
+    "nestjs",
+    "nextjs",
+    "argentina",
+    "cli",
+    "generator",
+    "multi-tenant"
+  ],
+  "author": "ignacio.becher@gmail.com",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "4.1.2",
+    "fs-extra": "^11.2.0",
+    "inquirer": "8.2.6",
+    "ora": "5.4.1"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.0",
+    "@types/inquirer": "^8.2.12",
+    "@types/node": "^20.0.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.0"
+  }
+}

package/templates/backend/.env.example

@@ -0,0 +1,67 @@
+# =========================================
+# create-saas-ar Backend
+# Variables de entorno
+# =========================================
+# Copiá este archivo a .env y completá los valores
+# =========================================
+
+# ===== Aplicación =====
+# Entorno: development | production | test
+NODE_ENV=development
+
+# Puerto donde corre el servidor
+PORT=3000
+
+# Prefijo para todas las rutas de la API
+API_PREFIX=api
+
+# ===== MongoDB =====
+# URI de conexión a MongoDB
+# Desarrollo local: mongodb://localhost:27017/saas-ar
+# Atlas: mongodb+srv://user:pass@cluster.xxx.mongodb.net/saas-ar
+# Con replica set (para transacciones): mongodb://localhost:27017/saas-ar?replicaSet=rs0
+MONGODB_URI=mongodb://localhost:27017/saas-ar
+
+# ===== JWT =====
+# Secreto para firmar access tokens (usar openssl rand -hex 64 para generar)
+JWT_ACCESS_SECRET=cambiar-por-secreto-seguro
+
+# Duración del access token (formato: 15m, 1h, 7d)
+JWT_ACCESS_EXPIRES_IN=15m
+
+# Secreto para firmar refresh tokens
+JWT_REFRESH_SECRET=cambiar-por-secreto-seguro
+
+# Duración del refresh token (formato: 15m, 1h, 7d)
+JWT_REFRESH_EXPIRES_IN=7d
+
+# ===== Email (Resend) =====
+# API Key de Resend (https://resend.com/api-keys)
+RESEND_API_KEY=re_cambiar_por_api_key
+
+# Email remitente (debe estar verificado en Resend)
+RESEND_FROM_EMAIL=noreply@tuapp.com
+
+# Nombre del remitente que ve el destinatario
+RESEND_FROM_NAME="Tu App"
+
+# ===== App URL =====
+# URL del frontend (para links en emails de verificación, reset, etc)
+APP_URL=http://localhost:5173
+
+# ===== Swagger =====
+# Habilitar documentación Swagger en /api/docs (solo development)
+SWAGGER_ENABLED=true
+
+# ===== CORS =====
+# Orígenes permitidos (separados por coma)
+CORS_ORIGINS=http://localhost:3001
+
+# ===== Rate Limiting =====
+# Cantidad máxima de requests por ventana de tiempo
+THROTTLE_TTL=60
+THROTTLE_LIMIT=100
+
+# ===== Cookies =====
+# Secreto para firmar cookies (usar openssl rand -hex 32 para generar)
+COOKIE_SECRET=cambiar-por-secreto-seguro

package/templates/backend/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all"
+}