forgestack-os-cli 0.1.0 → 0.1.1

package/src/generators/common.ts

@@ -1,377 +0,0 @@
-import path from 'path';
-import fs from 'fs-extra';
-import { StackConfig } from '../types';
-
-export async function generateCommon(config: StackConfig, targetDir: string) {
-    // Generate root package.json
-    const rootPackageJson = {
-        name: config.projectName,
-        version: '0.1.0',
-        private: true,
-        workspaces: ['frontend', 'backend'],
-        scripts: {
-            dev: 'npm run dev --workspace=frontend & npm run dev --workspace=backend',
-            'dev:frontend': 'npm run dev --workspace=frontend',
-            'dev:backend': 'npm run dev --workspace=backend',
-            build: 'npm run build --workspaces',
-            test: 'npm run test --workspaces',
-        },
-        author: 'Generated by ForgeStack OS',
-        license: 'MIT',
-    };
-
-    await fs.writeJSON(path.join(targetDir, 'package.json'), rootPackageJson, { spaces: 2 });
-
-    // Generate .gitignore
-    const gitignore = `# Dependencies
-node_modules/
-.pnp
-.pnp.js
-
-# Testing
-coverage/
-
-# Production
-build/
-dist/
-.next/
-out/
-
-# Environment
-.env
-.env.local
-.env.*.local
-
-# Logs
-logs/
-*.log
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# OS
-.DS_Store
-Thumbs.db
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-
-# Database
-*.db
-*.sqlite
-prisma/migrations/
-
-# Docker
-docker-compose.override.yml
-`;
-
-    await fs.writeFile(path.join(targetDir, '.gitignore'), gitignore);
-
-    // Generate README.md
-    const readme = generateReadme(config);
-    await fs.writeFile(path.join(targetDir, 'README.md'), readme);
-
-    // Generate .env.example
-    const envExample = generateEnvExample(config);
-    await fs.writeFile(path.join(targetDir, '.env.example'), envExample);
-}
-
-function generateReadme(config: StackConfig): string {
-    return `# ${config.projectName}
-
-Generated by **ForgeStack OS** - One platform. Any stack. Production-ready.
-
-## Stack
-
-- **Frontend:** ${config.frontend}
-- **Backend:** ${config.backend}
-- **Auth:** ${config.auth}
-- **Database:** ${config.database}
-- **API Style:** ${config.apiStyle}
-- **Docker:** ${config.docker ? 'Yes' : 'No'}
-- **Multi-Tenant:** ${config.multiTenant ? 'Yes' : 'No'}
-
-## Getting Started
-
-### Prerequisites
-
-- Node.js 18+ (or Bun if using Bun backend)
-${config.backend === 'go-fiber' ? '- Go 1.21+' : ''}
-${config.docker ? '- Docker and Docker Compose' : ''}
-${config.database === 'postgresql' ? '- PostgreSQL (or use Docker)' : ''}
-${config.database === 'mongodb' ? '- MongoDB (or use Docker)' : ''}
-
-### Installation
-
-\`\`\`bash
-# Install dependencies
-npm install
-
-# Copy environment variables
-cp .env.example .env
-
-# Update .env with your configuration
-\`\`\`
-
-### Database Setup
-
-${getDatabaseSetupInstructions(config)}
-
-### Development
-
-\`\`\`bash
-# Run both frontend and backend
-npm run dev
-
-# Or run separately
-npm run dev:frontend
-npm run dev:backend
-\`\`\`
-
-${config.docker ? `### Docker
-
-\`\`\`bash
-# Start all services
-docker-compose up
-
-# Start in detached mode
-docker-compose up -d
-
-# Stop services
-docker-compose down
-\`\`\`
-` : ''}
-
-## Project Structure
-
-\`\`\`
-${config.projectName}/
-├── frontend/          # ${config.frontend} application
-├── backend/           # ${config.backend} server
-${config.docker ? '├── docker/            # Docker configuration' : ''}
-├── .env.example       # Environment variables template
-└── README.md          # This file
-\`\`\`
-
-## Authentication
-
-${getAuthInstructions(config)}
-
-${config.multiTenant ? `## Multi-Tenancy
-
-This application is configured with multi-tenancy support. Each request is automatically scoped to a tenant based on:
-
-${getTenantScopingInfo(config)}
-
-All database queries include tenant isolation to ensure data security.
-` : ''}
-
-## Built With
-
-- [ForgeStack OS](https://github.com/halloffame12/forgestack-os) - The meta-platform that generated this project
-- Created by [Sumit Chauhan](https://github.com/halloffame12)
-
-## License
-
-MIT
-`;
-}
-
-function getDatabaseSetupInstructions(config: StackConfig): string {
-    switch (config.database) {
-        case 'postgresql':
-            return `\`\`\`bash
-# Using Docker
-docker-compose up -d postgres
-
-# Or install PostgreSQL locally and create a database
-createdb ${config.projectName}
-
-# Run migrations
-cd backend
-npx prisma migrate dev
-\`\`\``;
-
-        case 'mongodb':
-            return `\`\`\`bash
-# Using Docker
-docker-compose up -d mongodb
-
-# Or install MongoDB locally
-# No migrations needed - Mongoose handles schema
-\`\`\``;
-
-        case 'mysql':
-            return `\`\`\`bash
-# Using Docker
-docker-compose up -d mysql
-
-# Or install MySQL locally and create a database
-mysql -u root -p -e "CREATE DATABASE ${config.projectName};"
-
-# Run migrations
-cd backend
-npx prisma migrate dev
-\`\`\``;
-
-        case 'sqlite':
-            return `\`\`\`bash
-# SQLite is file-based, no setup needed
-# Database file will be created automatically
-cd backend
-npx prisma migrate dev
-\`\`\``;
-
-        case 'supabase-db':
-            return `\`\`\`bash
-# Create a Supabase project at https://supabase.com
-# Copy your connection string to .env
-# Run migrations through Supabase dashboard or CLI
-\`\`\``;
-
-        default:
-            return 'See backend/README.md for database setup instructions.';
-    }
-}
-
-function getAuthInstructions(config: StackConfig): string {
-    switch (config.auth) {
-        case 'jwt':
-            return `This project uses built-in JWT authentication. Users can register and login through the API endpoints:
-
-- \`POST /api/auth/register\` - Create a new account
-- \`POST /api/auth/login\` - Login and receive JWT token
-- Include the token in requests: \`Authorization: Bearer <token>\``;
-
-        case 'clerk':
-            return `This project uses Clerk for authentication. 
-
-1. Create a Clerk account at https://clerk.com
-2. Create a new application
-3. Copy your API keys to \`.env\`
-4. Configure allowed redirect URLs in Clerk dashboard`;
-
-        case 'supabase':
-            return `This project uses Supabase Auth.
-
-1. Create a Supabase project at https://supabase.com
-2. Copy your project URL and anon key to \`.env\`
-3. Configure auth providers in Supabase dashboard`;
-
-        case 'authjs':
-            return `This project uses Auth.js (NextAuth).
-
-1. Configure providers in \`backend/src/auth/config.ts\`
-2. Add provider credentials to \`.env\`
-3. See https://authjs.dev for provider setup guides`;
-
-        case 'firebase':
-            return `This project uses Firebase Auth.
-
-1. Create a Firebase project at https://firebase.google.com
-2. Enable authentication methods
-3. Copy your config to \`.env\``;
-
-        default:
-            return 'See documentation for authentication setup.';
-    }
-}
-
-function getTenantScopingInfo(config: StackConfig): string {
-    switch (config.auth) {
-        case 'clerk':
-            return '- Clerk organization ID is used as tenant ID\n- Organization membership determines access';
-        case 'supabase':
-            return '- Supabase user metadata contains tenant_id\n- Row Level Security (RLS) policies enforce isolation';
-        case 'jwt':
-            return '- JWT token contains tenant_id claim\n- Middleware extracts and validates tenant context';
-        default:
-            return '- Authentication provider includes tenant information\n- Middleware enforces tenant isolation';
-    }
-}
-
-function generateEnvExample(config: StackConfig): string {
-    let env = `# Database
-DATABASE_URL="${getDatabaseUrl(config)}"
-
-# Server
-PORT=3000
-NODE_ENV=development
-
-`;
-
-    // Auth-specific variables
-    switch (config.auth) {
-        case 'jwt':
-            env += `# JWT Authentication
-JWT_SECRET=your-super-secret-jwt-key-change-this
-JWT_EXPIRES_IN=7d
-`;
-            break;
-
-        case 'clerk':
-            env += `# Clerk Authentication
-CLERK_PUBLISHABLE_KEY=pk_test_xxxxx
-CLERK_SECRET_KEY=sk_test_xxxxx
-NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_xxxxx
-`;
-            break;
-
-        case 'supabase':
-            env += `# Supabase
-SUPABASE_URL=https://xxxxx.supabase.co
-SUPABASE_ANON_KEY=xxxxx
-SUPABASE_SERVICE_ROLE_KEY=xxxxx
-NEXT_PUBLIC_SUPABASE_URL=https://xxxxx.supabase.co
-NEXT_PUBLIC_SUPABASE_ANON_KEY=xxxxx
-`;
-            break;
-
-        case 'authjs':
-            env += `# Auth.js
-NEXTAUTH_URL=http://localhost:3000
-NEXTAUTH_SECRET=your-secret-key-change-this
-GOOGLE_CLIENT_ID=xxxxx
-GOOGLE_CLIENT_SECRET=xxxxx
-`;
-            break;
-
-        case 'firebase':
-            env += `# Firebase
-FIREBASE_API_KEY=xxxxx
-FIREBASE_AUTH_DOMAIN=xxxxx.firebaseapp.com
-FIREBASE_PROJECT_ID=xxxxx
-NEXT_PUBLIC_FIREBASE_API_KEY=xxxxx
-NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=xxxxx.firebaseapp.com
-NEXT_PUBLIC_FIREBASE_PROJECT_ID=xxxxx
-`;
-            break;
-    }
-
-    // Frontend URL
-    env += `\n# Frontend
-FRONTEND_URL=http://localhost:5173
-`;
-
-    return env;
-}
-
-function getDatabaseUrl(config: StackConfig): string {
-    switch (config.database) {
-        case 'postgresql':
-            return 'postgresql://user:password@localhost:5432/dbname';
-        case 'mongodb':
-            return 'mongodb://localhost:27017/dbname';
-        case 'mysql':
-            return 'mysql://user:password@localhost:3306/dbname';
-        case 'sqlite':
-            return 'file:./dev.db';
-        case 'supabase-db':
-            return 'postgresql://postgres:password@db.xxxxx.supabase.co:5432/postgres';
-        default:
-            return 'your-database-connection-string';
-    }
-}

package/src/generators/database.ts

@@ -1,165 +0,0 @@
-import path from 'path';
-import fs from 'fs-extra';
-import { StackConfig } from '../types';
-
-export async function generateDatabase(config: StackConfig, backendDir: string) {
-  switch (config.database) {
-    case 'postgresql':
-    case 'mysql':
-    case 'sqlite':
-      await generatePrisma(config, backendDir);
-      break;
-    case 'mongodb':
-      await generateMongoose(config, backendDir);
-      break;
-    case 'supabase-db':
-      await generateSupabase(config, backendDir);
-      break;
-    default:
-      throw new Error(`Unsupported database: ${config.database}`);
-  }
-}
-
-async function generatePrisma(config: StackConfig, backendDir: string) {
-  const prismaDir = path.join(backendDir, 'prisma');
-  await fs.ensureDir(prismaDir);
-
-  // Prisma schema
-  const schema = getPrismaSchema(config);
-  await fs.writeFile(path.join(prismaDir, 'schema.prisma'), schema);
-
-  // Prisma client initialization
-  const prismaClient = `import { PrismaClient } from '@prisma/client';
-
-const globalForPrisma = globalThis as unknown as {
-  prisma: PrismaClient | undefined;
-};
-
-export const prisma =
-  globalForPrisma.prisma ??
-  new PrismaClient({
-    log: process.env.NODE_ENV === 'development' ? ['query', 'error', 'warn'] : ['error'],
-  });
-
-if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma;
-
-export default prisma;
-`;
-
-  const libDir = path.join(backendDir, 'src', 'lib');
-  await fs.ensureDir(libDir);
-  await fs.writeFile(path.join(libDir, 'prisma.ts'), prismaClient);
-}
-
-function getPrismaSchema(config: StackConfig): string {
-  const datasourceProvider = config.database === 'postgresql' ? 'postgresql'
-    : config.database === 'mysql' ? 'mysql'
-      : 'sqlite';
-
-  return `generator client {
-  provider = "prisma-client-js"
-}
-
-datasource db {
-  provider = "${datasourceProvider}"
-  url      = env("DATABASE_URL")
-}
-
-${config.multiTenant ? `model Tenant {
-  id        String   @id @default(cuid())
-  name      String
-  slug      String   @unique
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-  users     User[]
-}
-
-` : ''}model User {
-  id        String   @id @default(cuid())
-  email     String   @unique
-  name      String?
-  password  String?  ${config.auth === 'jwt' ? '' : '// Only for JWT auth'}
-  ${config.multiTenant ? 'tenantId  String\n  tenant    Tenant   @relation(fields: [tenantId], references: [id])\n  ' : ''}createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-}
-`;
-}
-
-async function generateMongoose(config: StackConfig, backendDir: string) {
-  // Mongoose connection
-  const mongooseConnection = `import mongoose from 'mongoose';
-
-const MONGODB_URI = process.env.DATABASE_URL || 'mongodb://localhost:27017/${config.projectName}';
-
-let isConnected = false;
-
-export async function connectDB() {
-  if (isConnected) {
-    return;
-  }
-
-  try {
-    await mongoose.connect(MONGODB_URI);
-    isConnected = true;
-    console.log('✅ MongoDB connected');
-  } catch (error) {
-    console.error('❌ MongoDB connection error:', error);
-    process.exit(1);
-  }
-}
-
-export default mongoose;
-`;
-
-  const libDir = path.join(backendDir, 'src', 'lib');
-  await fs.ensureDir(libDir);
-  await fs.writeFile(path.join(libDir, 'mongoose.ts'), mongooseConnection);
-
-  // User model
-  const modelsDir = path.join(backendDir, 'src', 'models');
-  await fs.ensureDir(modelsDir);
-
-  const userModel = `import mongoose, { Schema, Document } from 'mongoose';
-
-export interface IUser extends Document {
-  email: string;
-  name?: string;
-  password?: string;
-  ${config.multiTenant ? 'tenantId: string;' : ''}
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-const UserSchema = new Schema<IUser>(
-  {
-    email: { type: String, required: true, unique: true },
-    name: { type: String },
-    password: { type: String },
-    ${config.multiTenant ? 'tenantId: { type: String, required: true, index: true },' : ''}
-  },
-  {
-    timestamps: true,
-  }
-);
-
-export default mongoose.model<IUser>('User', UserSchema);
-`;
-
-  await fs.writeFile(path.join(modelsDir, 'User.ts'), userModel);
-}
-
-async function generateSupabase(config: StackConfig, backendDir: string) {
-  const supabaseClient = `import { createClient } from '@supabase/supabase-js';
-
-const supabaseUrl = process.env.SUPABASE_URL!;
-const supabaseKey = process.env.SUPABASE_SERVICE_ROLE_KEY!;
-
-export const supabase = createClient(supabaseUrl, supabaseKey);
-
-export default supabase;
-`;
-
-  const libDir = path.join(backendDir, 'src', 'lib');
-  await fs.ensureDir(libDir);
-  await fs.writeFile(path.join(libDir, 'supabase.ts'), supabaseClient);
-}

package/src/generators/docker.ts

@@ -1,185 +0,0 @@
-import path from 'path';
-import fs from 'fs-extra';
-import { StackConfig } from '../types';
-
-export async function generateDocker(config: StackConfig, targetDir: string) {
-  const dockerDir = path.join(targetDir, 'docker');
-  await fs.ensureDir(dockerDir);
-
-  // Frontend Dockerfile
-  const frontendDockerfile = `FROM node:20-alpine AS builder
-
-WORKDIR /app
-
-COPY package*.json ./
-RUN npm install
-
-COPY . .
-RUN npm run build
-
-FROM nginx:alpine
-
-COPY --from=builder /app/dist /usr/share/nginx/html
-COPY docker/nginx.conf /etc/nginx/conf.d/default.conf
-
-EXPOSE 80
-
-CMD ["nginx", "-g", "daemon off;"]
-`;
-
-  await fs.writeFile(path.join(dockerDir, 'frontend.Dockerfile'), frontendDockerfile);
-
-  // Backend Dockerfile
-  const backendDockerfile = `FROM node:20-alpine
-
-WORKDIR /app
-
-COPY package*.json ./
-RUN npm install --only=production
-
-COPY . .
-RUN npm run build
-
-EXPOSE 3000
-
-CMD ["node", "dist/index.js"]
-`;
-
-  await fs.writeFile(path.join(dockerDir, 'backend.Dockerfile'), backendDockerfile);
-
-  // Nginx config for frontend
-  const nginxConf = `server {
-    listen 80;
-    server_name localhost;
-    root /usr/share/nginx/html;
-    index index.html;
-
-    location / {
-        try_files $uri $uri/ /index.html;
-    }
-
-    location /api {
-        proxy_pass http://backend:3000;
-        proxy_http_version 1.1;
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection 'upgrade';
-        proxy_set_header Host $host;
-        proxy_cache_bypass $http_upgrade;
-    }
-}
-`;
-
-  await fs.writeFile(path.join(dockerDir, 'nginx.conf'), nginxConf);
-
-  // Docker Compose
-  const dockerCompose = getDockerCompose(config);
-  await fs.writeFile(path.join(targetDir, 'docker-compose.yml'), dockerCompose);
-
-  // .dockerignore
-  const dockerignore = `node_modules
-npm-debug.log
-.env
-.env.local
-.git
-.gitignore
-README.md
-.vscode
-.idea
-dist
-build
-coverage
-`;
-
-  await fs.writeFile(path.join(targetDir, '.dockerignore'), dockerignore);
-}
-
-function getDockerCompose(config: StackConfig): string {
-  let services = `version: '3.8'
-
-services:
-  frontend:
-    build:
-      context: ./frontend
-      dockerfile: ../docker/frontend.Dockerfile
-    ports:
-      - "80:80"
-    depends_on:
-      - backend
-    environment:
-      - VITE_API_URL=http://localhost:3000/api
-
-  backend:
-    build:
-      context: ./backend
-      dockerfile: ../docker/backend.Dockerfile
-    ports:
-      - "3000:3000"
-    environment:
-      - NODE_ENV=production
-      - PORT=3000
-      - DATABASE_URL=${config.database === 'postgresql' ? `postgresql://postgres:postgres@postgres:5432/${config.projectName}` : config.database === 'mongodb' ? `mongodb://mongo:mongo@mongodb:27017/${config.projectName}` : config.database === 'mysql' ? `mysql://root:mysql@mysql:3306/${config.projectName}` : '${DATABASE_URL}'}
-      - JWT_SECRET=\${JWT_SECRET}
-    depends_on:
-`;
-
-  // Add database service
-  if (config.database === 'postgresql') {
-    services += `      - postgres
-
-  postgres:
-    image: postgres:16-alpine
-    ports:
-      - "5432:5432"
-    environment:
-      - POSTGRES_USER=postgres
-      - POSTGRES_PASSWORD=postgres
-      - POSTGRES_DB=${config.projectName}
-    volumes:
-      - postgres_data:/var/lib/postgresql/data
-
-volumes:
-  postgres_data:
-`;
-  } else if (config.database === 'mongodb') {
-    services += `      - mongodb
-
-  mongodb:
-    image: mongo:7
-    ports:
-      - "27017:27017"
-    environment:
-      - MONGO_INITDB_ROOT_USERNAME=mongo
-      - MONGO_INITDB_ROOT_PASSWORD=mongo
-      - MONGO_INITDB_DATABASE=${config.projectName}
-    volumes:
-      - mongodb_data:/data/db
-
-volumes:
-  mongodb_data:
-`;
-  } else if (config.database === 'mysql') {
-    services += `      - mysql
-
-  mysql:
-    image: mysql:8
-    ports:
-      - "3306:3306"
-    environment:
-      - MYSQL_ROOT_PASSWORD=mysql
-      - MYSQL_DATABASE=${config.projectName}
-    volumes:
-      - mysql_data:/var/lib/mysql
-
-volumes:
-  mysql_data:
-`;
-  } else {
-    services += `      # Add your database service here
-
-volumes:
-  data:
-`;
-  }
-
-  return services;
-}