create-solostack 1.0.0

package/src/generators/database.js

@@ -0,0 +1,365 @@
+import path from 'path';
+import { writeFile, ensureDir } from '../utils/files.js';
+
+/**
+ * Generates Prisma database configuration
+ * @param {string} projectPath - Path where the project is located
+ * @param {string} database - Database type (currently only PostgreSQL supported)
+ */
+export async function generateDatabase(projectPath, database) {
+  // Create prisma directory
+  await ensureDir(path.join(projectPath, 'prisma'));
+
+  // Generate schema.prisma
+  const schemaPrisma = `generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+model User {
+  id                String         @id @default(cuid())
+  email             String         @unique
+  name              String?
+  emailVerified     DateTime?
+  image             String?
+  password          String?        // For email/password auth
+  role              Role           @default(USER)
+  stripeCustomerId  String?        @unique
+  subscription      Subscription?
+  createdAt         DateTime       @default(now())
+  updatedAt         DateTime       @updatedAt
+  
+  accounts          Account[]
+  sessions          Session[]
+  payments          Payment[]
+}
+
+model Account {
+  userId            String
+  type              String
+  provider          String
+  providerAccountId String
+  refresh_token     String?        @db.Text
+  access_token      String?        @db.Text
+  expires_at        Int?
+  token_type        String?
+  scope             String?
+  id_token          String?        @db.Text
+  session_state     String?
+  
+  user              User           @relation(fields: [userId], references: [id], onDelete: Cascade)
+  
+  @@unique([provider, providerAccountId])
+  @@index([userId])
+}
+
+model Session {
+  sessionToken String   @unique
+  userId       String
+  expires      DateTime
+  user         User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  
+  @@index([userId])
+}
+
+model VerificationToken {
+  identifier String
+  token      String   @unique
+  expires    DateTime
+  
+  @@unique([identifier, token])
+}
+
+model Subscription {
+  id                   String              @id @default(cuid())
+  userId               String              @unique
+  user                 User                @relation(fields: [userId], references: [id], onDelete: Cascade)
+  stripeSubscriptionId String              @unique
+  stripePriceId        String
+  status               SubscriptionStatus
+  currentPeriodStart   DateTime
+  currentPeriodEnd     DateTime
+  cancelAtPeriodEnd    Boolean             @default(false)
+  createdAt            DateTime            @default(now())
+  updatedAt            DateTime            @updatedAt
+}
+
+model Payment {
+  id               String   @id @default(cuid())
+  userId           String
+  user             User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  stripePaymentId  String   @unique
+  amount           Int      // In cents
+  currency         String   @default("usd")
+  status           String
+  createdAt        DateTime @default(now())
+  
+  @@index([userId])
+}
+
+model StripeEvent {
+  id               String   @id @default(cuid())
+  eventId          String   @unique  // Stripe event ID
+  type             String             // Event type (e.g., "checkout.session.completed")
+  processed        Boolean  @default(false)
+  createdAt        DateTime @default(now())
+  
+  @@index([eventId])
+  @@index([processed])
+}
+
+enum Role {
+  USER
+  ADMIN
+}
+
+enum SubscriptionStatus {
+  ACTIVE
+  CANCELED
+  PAST_DUE
+  TRIALING
+  INCOMPLETE
+}
+`;
+
+  await writeFile(path.join(projectPath, 'prisma/schema.prisma'), schemaPrisma);
+
+  // Generate database client
+  const dbClient = `import { PrismaClient } from '@prisma/client';
+
+const globalForPrisma = globalThis as unknown as {
+  prisma: PrismaClient | undefined;
+};
+
+export const db = globalForPrisma.prisma ?? new PrismaClient();
+
+if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = db;
+`;
+
+  await writeFile(path.join(projectPath, 'src/lib/db.ts'), dbClient);
+
+  // Generate seed script
+  const seedScript = `import { PrismaClient } from '@prisma/client';
+import bcrypt from 'bcryptjs';
+
+const prisma = new PrismaClient();
+
+async function main() {
+  console.log('🌱 Seeding database...');
+
+  // Create a test user
+  const hashedPassword = await bcrypt.hash('password123', 10);
+  
+  const user = await prisma.user.upsert({
+    where: { email: 'test@example.com' },
+    update: {},
+    create: {
+      email: 'test@example.com',
+      name: 'Test User',
+      password: hashedPassword,
+      emailVerified: new Date(),
+    },
+  });
+
+  console.log('✅ Created test user:', user.email);
+
+  // Create an admin user
+  const admin = await prisma.user.upsert({
+    where: { email: 'admin@example.com' },
+    update: {},
+    create: {
+      email: 'admin@example.com',
+      name: 'Admin User',
+      password: hashedPassword,
+      emailVerified: new Date(),
+      role: 'ADMIN',
+    },
+  });
+
+  console.log('✅ Created admin user:', admin.email);
+
+  console.log('🎉 Seeding complete!');
+}
+
+main()
+  .catch((e) => {
+    console.error('❌ Seeding failed:', e);
+    process.exit(1);
+  })
+  .finally(async () => {
+    await prisma.$disconnect();
+  });
+`;
+
+  await writeFile(path.join(projectPath, 'prisma/seed.ts'), seedScript);
+
+  // Generate database migration guide
+  const dbGuide = `# Database Setup Guide
+
+## Initial Setup
+
+### 1. Set up your PostgreSQL database
+
+**Option A: Local PostgreSQL**
+\`\`\`bash
+# Install PostgreSQL (if not already installed)
+# macOS
+brew install postgresql
+brew services start postgresql
+
+# Ubuntu/Debian
+sudo apt-get install postgresql
+sudo service postgresql start
+
+# Windows
+# Download from https://www.postgresql.org/download/windows/
+\`\`\`
+
+Create a database:
+\`\`\`bash
+psql postgres
+CREATE DATABASE your_database_name;
+CREATE USER your_user WITH PASSWORD 'your_password';
+GRANT ALL PRIVILEGES ON DATABASE your_database_name TO your_user;
+\\q
+\`\`\`
+
+**Option B: Cloud Database (Recommended for Production)**
+- [Neon](https://neon.tech) - Free tier with PostgreSQL
+- [Supabase](https://supabase.com) - Free tier with PostgreSQL
+- [Railway](https://railway.app) - Easy PostgreSQL deployment
+- [Vercel Postgres](https://vercel.com/storage/postgres) - Serverless PostgreSQL
+
+### 2. Update your .env file
+
+\`\`\`env
+DATABASE_URL="postgresql://user:password@localhost:5432/dbname"
+# Or for cloud:
+# DATABASE_URL="postgresql://user:password@host:5432/dbname?sslmode=require"
+\`\`\`
+
+### 3. Push the schema to your database
+
+\`\`\`bash
+npm run db:push
+\`\`\`
+
+This command:
+- Creates all tables based on your schema
+- Sets up indexes for performance
+- Applies constraints and relationships
+
+### 4. Seed the database (optional)
+
+\`\`\`bash
+npm run db:seed
+\`\`\`
+
+This creates:
+- Test user: test@example.com (password: password123)
+- Admin user: admin@example.com (password: password123)
+
+## Making Schema Changes
+
+### 1. Edit prisma/schema.prisma
+
+Add or modify models as needed.
+
+### 2. Apply changes
+
+**For development:**
+\`\`\`bash
+npm run db:push
+\`\`\`
+
+**For production (with migrations):**
+\`\`\`bash
+npx prisma migrate dev --name your_migration_name
+\`\`\`
+
+This creates a migration file in \`prisma/migrations/\`.
+
+### 3. Apply migrations to production
+
+\`\`\`bash
+npx prisma migrate deploy
+\`\`\`
+
+## Prisma Studio
+
+Inspect and edit your database with a visual interface:
+
+\`\`\`bash
+npm run db:studio
+\`\`\`
+
+Opens at http://localhost:5555
+
+## Common Commands
+
+\`\`\`bash
+# Generate Prisma Client after schema changes
+npx prisma generate
+
+# Format schema file
+npx prisma format
+
+# Check if database is in sync with schema
+npx prisma db pull
+
+# Reset database (⚠️ deletes all data)
+npx prisma migrate reset
+
+# View database structure
+npx prisma db pull
+\`\`\`
+
+## Backup & Restore
+
+### Backup
+\`\`\`bash
+pg_dump -U your_user -d your_database > backup.sql
+\`\`\`
+
+### Restore
+\`\`\`bash
+psql -U your_user -d your_database < backup.sql
+\`\`\`
+
+## Troubleshooting
+
+### Connection Issues
+- Verify DATABASE_URL is correct
+- Check if PostgreSQL is running
+- Ensure database exists
+- Check firewall settings for remote connections
+
+### Migration Conflicts
+\`\`\`bash
+# Reset migrations (development only)
+npx prisma migrate reset
+
+# Mark migration as applied without running
+npx prisma migrate resolve --applied migration_name
+\`\`\`
+
+### Performance
+- Add indexes for frequently queried fields
+- Use \`@@index\` in your schema
+- Monitor with \`EXPLAIN ANALYZE\` in PostgreSQL
+
+## Best Practices
+
+1. **Always backup before major migrations**
+2. **Test migrations on staging first**
+3. **Use migrations (not db push) in production**
+4. **Keep DATABASE_URL in .env, never commit it**
+5. **Use connection pooling for serverless (e.g., Prisma Data Proxy)**
+`;
+
+  await writeFile(path.join(projectPath, 'prisma/DATABASE_GUIDE.md'), dbGuide);
+}