@nextsparkjs/core 0.1.0-beta.1 → 0.1.0-beta.3

package/dist/bin/wizard/generators/theme-renamer.ts

@@ -0,0 +1,419 @@
+/**
+ * Theme Renamer Generator
+ *
+ * Copies the starter theme to a new name and updates all references.
+ */
+
+import fs from 'fs-extra'
+import path from 'path'
+import { fileURLToPath } from 'url'
+import type { WizardConfig } from '../types.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+/**
+ * Get the templates directory path
+ * From bin/dist/wizard/generators/theme-renamer.js, go up to reach packages/core/templates
+ */
+function getTemplatesDir(): string {
+  // When compiled: bin/dist/wizard/generators/theme-renamer.js
+  // Templates at: templates/contents/themes/starter
+  return path.resolve(__dirname, '../../../../templates')
+}
+
+/**
+ * Get the target themes directory in the user's project
+ */
+function getTargetThemesDir(): string {
+  return path.resolve(process.cwd(), 'contents', 'themes')
+}
+
+/**
+ * Copy starter theme to new location with new name
+ */
+export async function copyStarterTheme(config: WizardConfig): Promise<void> {
+  const templatesDir = getTemplatesDir()
+  const starterThemePath = path.join(templatesDir, 'contents', 'themes', 'starter')
+  const targetThemesDir = getTargetThemesDir()
+  const newThemePath = path.join(targetThemesDir, config.projectSlug)
+
+  // Check if starter theme exists
+  if (!await fs.pathExists(starterThemePath)) {
+    throw new Error(`Starter theme not found at: ${starterThemePath}`)
+  }
+
+  // Check if target theme already exists
+  if (await fs.pathExists(newThemePath)) {
+    throw new Error(`Theme already exists at: ${newThemePath}. Please choose a different name or remove the existing theme.`)
+  }
+
+  // Ensure themes directory exists
+  await fs.ensureDir(targetThemesDir)
+
+  // Copy the entire starter theme
+  await fs.copy(starterThemePath, newThemePath)
+}
+
+/**
+ * Update theme.config.ts with new name and display name
+ */
+export async function updateThemeConfig(config: WizardConfig): Promise<void> {
+  const themeConfigPath = path.join(getTargetThemesDir(), config.projectSlug, 'config', 'theme.config.ts')
+
+  if (!await fs.pathExists(themeConfigPath)) {
+    throw new Error(`theme.config.ts not found at: ${themeConfigPath}`)
+  }
+
+  let content = await fs.readFile(themeConfigPath, 'utf-8')
+
+  // Update name
+  content = content.replace(
+    /name:\s*['"]starter['"]/g,
+    `name: '${config.projectSlug}'`
+  )
+
+  // Update displayName
+  content = content.replace(
+    /displayName:\s*['"]Starter['"]/g,
+    `displayName: '${config.projectName}'`
+  )
+
+  // Update description
+  content = content.replace(
+    /description:\s*['"]Minimal starter theme for NextSpark['"]/g,
+    `description: '${config.projectDescription}'`
+  )
+
+  // Update variable name
+  content = content.replace(
+    /export const starterThemeConfig/g,
+    `export const ${toCamelCase(config.projectSlug)}ThemeConfig`
+  )
+
+  // Update default export reference (if it exists)
+  content = content.replace(
+    /export default starterThemeConfig/g,
+    `export default ${toCamelCase(config.projectSlug)}ThemeConfig`
+  )
+
+  await fs.writeFile(themeConfigPath, content, 'utf-8')
+}
+
+/**
+ * Update dev.config.ts with new email domain
+ */
+export async function updateDevConfig(config: WizardConfig): Promise<void> {
+  const devConfigPath = path.join(getTargetThemesDir(), config.projectSlug, 'config', 'dev.config.ts')
+
+  if (!await fs.pathExists(devConfigPath)) {
+    // dev.config.ts is optional, skip if not found
+    return
+  }
+
+  let content = await fs.readFile(devConfigPath, 'utf-8')
+
+  // Replace @starter.dev with @{slug}.dev
+  content = content.replace(/@starter\.dev/g, `@${config.projectSlug}.dev`)
+
+  // Update comments referencing "Starter"
+  content = content.replace(/STARTER THEME/g, `${config.projectName.toUpperCase()}`)
+  content = content.replace(/Starter Theme/g, config.projectName)
+  content = content.replace(/Starter Team/g, `${config.projectName} Team`)
+
+  await fs.writeFile(devConfigPath, content, 'utf-8')
+}
+
+/**
+ * Update app.config.ts with project settings
+ */
+export async function updateAppConfig(config: WizardConfig): Promise<void> {
+  const appConfigPath = path.join(getTargetThemesDir(), config.projectSlug, 'config', 'app.config.ts')
+
+  if (!await fs.pathExists(appConfigPath)) {
+    throw new Error(`app.config.ts not found at: ${appConfigPath}`)
+  }
+
+  let content = await fs.readFile(appConfigPath, 'utf-8')
+
+  // Update app name
+  content = content.replace(
+    /name:\s*['"]Starter['"]/g,
+    `name: '${config.projectName}'`
+  )
+
+  // Update team mode
+  content = content.replace(
+    /mode:\s*['"]multi-tenant['"]\s*as\s*const/g,
+    `mode: '${config.teamMode}' as const`
+  )
+
+  // Update supported locales
+  const localesArray = config.supportedLocales.map(l => `'${l}'`).join(', ')
+  content = content.replace(
+    /supportedLocales:\s*\[.*?\]/g,
+    `supportedLocales: [${localesArray}]`
+  )
+
+  // Update default locale
+  content = content.replace(
+    /defaultLocale:\s*['"]en['"]\s*as\s*const/g,
+    `defaultLocale: '${config.defaultLocale}' as const`
+  )
+
+  // Update docs label
+  content = content.replace(
+    /label:\s*['"]Starter['"]/g,
+    `label: '${config.projectName}'`
+  )
+
+  await fs.writeFile(appConfigPath, content, 'utf-8')
+}
+
+/**
+ * Update app.config.ts with selected team roles
+ */
+export async function updateRolesConfig(config: WizardConfig): Promise<void> {
+  const appConfigPath = path.join(getTargetThemesDir(), config.projectSlug, 'config', 'app.config.ts')
+
+  if (!await fs.pathExists(appConfigPath)) {
+    return
+  }
+
+  let content = await fs.readFile(appConfigPath, 'utf-8')
+
+  // Update availableTeamRoles if it exists
+  const rolesArray = config.teamRoles.map(r => `'${r}'`).join(', ')
+  content = content.replace(
+    /availableTeamRoles:\s*\[.*?\]/g,
+    `availableTeamRoles: [${rolesArray}]`
+  )
+
+  await fs.writeFile(appConfigPath, content, 'utf-8')
+}
+
+/**
+ * Update billing.config.ts with billing settings and generate plans
+ */
+export async function updateBillingConfig(config: WizardConfig): Promise<void> {
+  const billingConfigPath = path.join(getTargetThemesDir(), config.projectSlug, 'config', 'billing.config.ts')
+
+  if (!await fs.pathExists(billingConfigPath)) {
+    // billing.config.ts is optional, skip if not found
+    return
+  }
+
+  let content = await fs.readFile(billingConfigPath, 'utf-8')
+
+  // Update currency
+  content = content.replace(
+    /currency:\s*['"]usd['"]/g,
+    `currency: '${config.currency}'`
+  )
+
+  // Generate plans based on billing model
+  const plansContent = generateBillingPlans(config.billingModel, config.currency)
+
+  // Replace the plans array
+  content = content.replace(
+    /plans:\s*\[[\s\S]*?\],\s*\n\s*\/\/ ===+\s*\n\s*\/\/ ACTION MAPPINGS/,
+    `plans: ${plansContent},
+
+  // ===========================================
+  // ACTION MAPPINGS`
+  )
+
+  await fs.writeFile(billingConfigPath, content, 'utf-8')
+}
+
+/**
+ * Generate billing plans based on the selected billing model
+ */
+function generateBillingPlans(billingModel: string, currency: string): string {
+  if (billingModel === 'free') {
+    return '[]'
+  }
+
+  const currencySymbol = currency === 'eur' ? '€' : currency === 'gbp' ? '£' : '$'
+
+  if (billingModel === 'freemium') {
+    // Free + Pro plans
+    return `[
+    // Free Plan
+    {
+      slug: 'free',
+      name: 'billing.plans.free.name',
+      description: 'billing.plans.free.description',
+      type: 'free',
+      visibility: 'public',
+      price: { monthly: 0, yearly: 0 },
+      trialDays: 0,
+      features: ['basic_analytics'],
+      limits: {
+        team_members: 3,
+        tasks: 50,
+        api_calls: 1000,
+        storage_gb: 1,
+      },
+      stripePriceIdMonthly: null,
+      stripePriceIdYearly: null,
+    },
+    // Pro Plan - ${currencySymbol}29/month
+    {
+      slug: 'pro',
+      name: 'billing.plans.pro.name',
+      description: 'billing.plans.pro.description',
+      type: 'paid',
+      visibility: 'public',
+      price: {
+        monthly: 2900,  // ${currencySymbol}29.00
+        yearly: 29000,  // ${currencySymbol}290.00 (16% savings)
+      },
+      trialDays: 14,
+      features: [
+        'basic_analytics',
+        'advanced_analytics',
+        'api_access',
+        'priority_support',
+      ],
+      limits: {
+        team_members: 15,
+        tasks: 1000,
+        api_calls: 100000,
+        storage_gb: 50,
+      },
+      stripePriceIdMonthly: 'price_pro_monthly',
+      stripePriceIdYearly: 'price_pro_yearly',
+    },
+  ]`
+  }
+
+  // paid model: Starter + Pro + Business
+  return `[
+    // Starter Plan - ${currencySymbol}15/month
+    {
+      slug: 'starter',
+      name: 'billing.plans.starter.name',
+      description: 'billing.plans.starter.description',
+      type: 'paid',
+      visibility: 'public',
+      price: {
+        monthly: 1500,  // ${currencySymbol}15.00
+        yearly: 14400,  // ${currencySymbol}144.00 (20% savings)
+      },
+      trialDays: 7,
+      features: [
+        'basic_analytics',
+        'api_access',
+      ],
+      limits: {
+        team_members: 5,
+        tasks: 200,
+        api_calls: 10000,
+        storage_gb: 10,
+      },
+      stripePriceIdMonthly: 'price_starter_monthly',
+      stripePriceIdYearly: 'price_starter_yearly',
+    },
+    // Pro Plan - ${currencySymbol}29/month
+    {
+      slug: 'pro',
+      name: 'billing.plans.pro.name',
+      description: 'billing.plans.pro.description',
+      type: 'paid',
+      visibility: 'public',
+      price: {
+        monthly: 2900,  // ${currencySymbol}29.00
+        yearly: 29000,  // ${currencySymbol}290.00 (16% savings)
+      },
+      trialDays: 14,
+      features: [
+        'basic_analytics',
+        'advanced_analytics',
+        'api_access',
+        'priority_support',
+      ],
+      limits: {
+        team_members: 15,
+        tasks: 1000,
+        api_calls: 100000,
+        storage_gb: 50,
+      },
+      stripePriceIdMonthly: 'price_pro_monthly',
+      stripePriceIdYearly: 'price_pro_yearly',
+    },
+    // Business Plan - ${currencySymbol}79/month
+    {
+      slug: 'business',
+      name: 'billing.plans.business.name',
+      description: 'billing.plans.business.description',
+      type: 'paid',
+      visibility: 'public',
+      price: {
+        monthly: 7900,  // ${currencySymbol}79.00
+        yearly: 79000,  // ${currencySymbol}790.00 (16% savings)
+      },
+      trialDays: 14,
+      features: [
+        'basic_analytics',
+        'advanced_analytics',
+        'api_access',
+        'sso',
+        'audit_logs',
+        'priority_support',
+        'dedicated_support',
+      ],
+      limits: {
+        team_members: 50,
+        tasks: 5000,
+        api_calls: 500000,
+        storage_gb: 200,
+      },
+      stripePriceIdMonthly: 'price_business_monthly',
+      stripePriceIdYearly: 'price_business_yearly',
+    },
+  ]`
+}
+
+/**
+ * Update SQL migration files with new email domain
+ */
+export async function updateMigrations(config: WizardConfig): Promise<void> {
+  const migrationsDir = path.join(getTargetThemesDir(), config.projectSlug, 'migrations')
+
+  if (!await fs.pathExists(migrationsDir)) {
+    return
+  }
+
+  const files = await fs.readdir(migrationsDir)
+  const sqlFiles = files.filter(f => f.endsWith('.sql'))
+
+  for (const file of sqlFiles) {
+    const filePath = path.join(migrationsDir, file)
+    let content = await fs.readFile(filePath, 'utf-8')
+
+    // Replace @starter.dev with @{slug}.dev
+    content = content.replace(/@starter\.dev/g, `@${config.projectSlug}.dev`)
+
+    // Update comments
+    content = content.replace(/Starter Theme/g, config.projectName)
+    content = content.replace(/starter theme/g, config.projectSlug)
+
+    await fs.writeFile(filePath, content, 'utf-8')
+  }
+}
+
+/**
+ * Convert string to camelCase
+ */
+function toCamelCase(str: string): string {
+  return str
+    .split('-')
+    .map((word, index) => {
+      if (index === 0) {
+        return word.toLowerCase()
+      }
+      return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()
+    })
+    .join('')
+}

package/dist/bin/wizard/index.ts

@@ -0,0 +1,288 @@
+/**
+ * NextSpark Wizard Orchestrator
+ *
+ * Main wizard entry point that runs all prompts in sequence
+ * and generates the project based on user responses.
+ */
+
+import chalk from 'chalk'
+import ora from 'ora'
+import { confirm } from '@inquirer/prompts'
+import { showBanner, showSection, showSuccess, showError, showInfo, showWarning } from './banner.js'
+import { runAllPrompts, runQuickPrompts, runExpertPrompts } from './prompts/index.js'
+import { generateProject } from './generators/index.js'
+import { getPreset, applyPreset, PRESET_DESCRIPTIONS } from './presets.js'
+import type { WizardConfig, CLIOptions } from './types.js'
+import { promptProjectInfo } from './prompts/project-info.js'
+// DX Improvements
+import { promptDemoInstall } from './prompts/demo-install.js'
+import { installDemoTheme } from './generators/demo-installer.js'
+import { showConfigPreview } from './preview.js'
+
+/**
+ * Run the complete wizard with mode support
+ */
+export async function runWizard(options: CLIOptions = { mode: 'interactive' }): Promise<void> {
+  // Show welcome banner
+  showBanner()
+
+  // Show mode indicator
+  showModeIndicator(options)
+
+  try {
+    // Demo Theme Installation (optional, before wizard)
+    if (!options.preset && options.mode !== 'quick') {
+      const wantsDemo = await promptDemoInstall()
+      if (wantsDemo) {
+        const installed = await installDemoTheme()
+        if (installed) {
+          console.log('')
+          showInfo('Demo theme installed. Now let\'s configure your custom project.')
+          console.log('')
+        }
+      }
+    }
+
+    let config: WizardConfig
+
+    if (options.preset) {
+      // Preset mode: get project info then apply preset
+      config = await runPresetMode(options.preset)
+    } else {
+      // Run prompts based on mode
+      switch (options.mode) {
+        case 'quick':
+          config = await runQuickPrompts()
+          break
+        case 'expert':
+          config = await runExpertPrompts()
+          break
+        case 'interactive':
+        default:
+          config = await runAllPrompts()
+          break
+      }
+    }
+
+    // Show summary before generating
+    showConfigSummary(config)
+
+    // Show interactive preview of files to be created
+    showConfigPreview(config)
+
+    // Ask for confirmation before proceeding
+    console.log('')
+    const proceed = await confirm({
+      message: 'Proceed with project generation?',
+      default: true,
+    })
+
+    if (!proceed) {
+      console.log('')
+      showInfo('Project generation cancelled. No changes were made.')
+      process.exit(0)
+    }
+
+    // Generate the project
+    console.log('')
+    const spinner = ora({
+      text: 'Generating your NextSpark project...',
+      prefixText: '  ',
+    }).start()
+
+    try {
+      await generateProject(config)
+      spinner.succeed('Project generated successfully!')
+    } catch (error) {
+      spinner.fail('Failed to generate project')
+      throw error
+    }
+
+    // Show next steps
+    showNextSteps(config)
+  } catch (error) {
+    if (error instanceof Error) {
+      if (error.message.includes('User force closed')) {
+        console.log('')
+        showInfo('Wizard cancelled. No changes were made.')
+        process.exit(0)
+      }
+      showError(error.message)
+    }
+    process.exit(1)
+  }
+}
+
+/**
+ * Show mode indicator at the start
+ */
+function showModeIndicator(options: CLIOptions): void {
+  if (options.preset) {
+    showInfo(`Using preset: ${chalk.cyan(options.preset)} - ${PRESET_DESCRIPTIONS[options.preset]}`)
+    console.log('')
+  } else if (options.mode === 'quick') {
+    showInfo('Quick mode: Running essential prompts only (steps 1-5)')
+    console.log('')
+  } else if (options.mode === 'expert') {
+    showInfo('Expert mode: Running all prompts with advanced options')
+    console.log('')
+  }
+}
+
+/**
+ * Run preset mode: only project info, then apply preset defaults
+ */
+async function runPresetMode(presetName: CLIOptions['preset']): Promise<WizardConfig> {
+  if (!presetName) {
+    throw new Error('Preset name is required for preset mode')
+  }
+
+  showSection('Project Information', 1, 1)
+  showInfo('Using preset defaults. Only project information is required.')
+  console.log('')
+
+  // Get project info from user
+  const projectInfo = await promptProjectInfo()
+
+  // Apply preset to project info
+  const config = applyPreset(projectInfo, presetName)
+
+  return config
+}
+
+/**
+ * Display configuration summary before generating
+ */
+function showConfigSummary(config: WizardConfig): void {
+  console.log('')
+  console.log(chalk.cyan('  ' + '='.repeat(60)))
+  console.log(chalk.bold.white('  Configuration Summary'))
+  console.log(chalk.cyan('  ' + '='.repeat(60)))
+  console.log('')
+
+  console.log(chalk.white('  Project:'))
+  console.log(chalk.gray(`    Name: ${chalk.white(config.projectName)}`))
+  console.log(chalk.gray(`    Slug: ${chalk.white(config.projectSlug)}`))
+  console.log(chalk.gray(`    Description: ${chalk.white(config.projectDescription)}`))
+  console.log('')
+
+  console.log(chalk.white('  Team Mode:'))
+  console.log(chalk.gray(`    Mode: ${chalk.white(config.teamMode)}`))
+  console.log(chalk.gray(`    Roles: ${chalk.white(config.teamRoles.join(', '))}`))
+  console.log('')
+
+  console.log(chalk.white('  Internationalization:'))
+  console.log(chalk.gray(`    Default: ${chalk.white(config.defaultLocale)}`))
+  console.log(chalk.gray(`    Languages: ${chalk.white(config.supportedLocales.join(', '))}`))
+  console.log('')
+
+  console.log(chalk.white('  Billing:'))
+  console.log(chalk.gray(`    Model: ${chalk.white(config.billingModel)}`))
+  console.log(chalk.gray(`    Currency: ${chalk.white(config.currency.toUpperCase())}`))
+  console.log('')
+
+  console.log(chalk.white('  Features:'))
+  const enabledFeatures = Object.entries(config.features)
+    .filter(([_, enabled]) => enabled)
+    .map(([feature]) => feature)
+  console.log(chalk.gray(`    Enabled: ${chalk.white(enabledFeatures.join(', ') || 'None')}`))
+  console.log('')
+
+  console.log(chalk.white('  Authentication:'))
+  const enabledAuth = Object.entries(config.auth)
+    .filter(([_, enabled]) => enabled)
+    .map(([method]) => formatAuthMethod(method))
+  console.log(chalk.gray(`    Methods: ${chalk.white(enabledAuth.join(', ') || 'None')}`))
+  console.log('')
+
+  console.log(chalk.white('  Dashboard:'))
+  const enabledDashboard = Object.entries(config.dashboard)
+    .filter(([_, enabled]) => enabled)
+    .map(([feature]) => formatDashboardFeature(feature))
+  console.log(chalk.gray(`    Features: ${chalk.white(enabledDashboard.join(', ') || 'None')}`))
+  console.log('')
+
+  console.log(chalk.white('  Dev Tools:'))
+  const enabledDevTools = Object.entries(config.dev)
+    .filter(([_, enabled]) => enabled)
+    .map(([tool]) => formatDevTool(tool))
+  console.log(chalk.gray(`    Enabled: ${chalk.white(enabledDevTools.join(', ') || 'None')}`))
+}
+
+/**
+ * Format authentication method name for display
+ */
+function formatAuthMethod(method: string): string {
+  const mapping: Record<string, string> = {
+    emailPassword: 'Email/Password',
+    googleOAuth: 'Google',
+    emailVerification: 'Email Verification',
+  }
+  return mapping[method] || method
+}
+
+/**
+ * Format dashboard feature name for display
+ */
+function formatDashboardFeature(feature: string): string {
+  const mapping: Record<string, string> = {
+    search: 'Search',
+    notifications: 'Notifications',
+    themeToggle: 'Theme Toggle',
+    sidebarCollapsed: 'Sidebar Collapsed',
+  }
+  return mapping[feature] || feature
+}
+
+/**
+ * Format dev tool name for display
+ */
+function formatDevTool(tool: string): string {
+  const mapping: Record<string, string> = {
+    devKeyring: 'Dev Keyring',
+    debugMode: 'Debug Mode',
+  }
+  return mapping[tool] || tool
+}
+
+/**
+ * Display next steps after successful generation
+ */
+function showNextSteps(config: WizardConfig): void {
+  console.log('')
+  console.log(chalk.cyan('  ' + '='.repeat(60)))
+  console.log(chalk.bold.green('  ✨ NextSpark project created successfully!'))
+  console.log(chalk.cyan('  ' + '='.repeat(60)))
+  console.log('')
+
+  console.log(chalk.bold.white('  Next steps:'))
+  console.log('')
+
+  console.log(chalk.white('  1. Install dependencies:'))
+  console.log(chalk.cyan('     pnpm install'))
+  console.log('')
+
+  console.log(chalk.white('  2. Set up your environment:'))
+  console.log(chalk.gray('     Copy .env.example to .env and configure:'))
+  console.log(chalk.yellow('     - DATABASE_URL'))
+  console.log(chalk.yellow('     - BETTER_AUTH_SECRET'))
+  console.log(chalk.yellow(`     - NEXT_PUBLIC_ACTIVE_THEME=${config.projectSlug}`))
+  console.log('')
+
+  console.log(chalk.white('  3. Generate registries:'))
+  console.log(chalk.cyan('     pnpm build:registries'))
+  console.log('')
+
+  console.log(chalk.white('  4. Run database migrations:'))
+  console.log(chalk.cyan('     pnpm db:migrate'))
+  console.log('')
+
+  console.log(chalk.white('  5. Start the development server:'))
+  console.log(chalk.cyan('     pnpm dev'))
+  console.log('')
+
+  console.log(chalk.gray('  ' + '-'.repeat(60)))
+  console.log(chalk.gray(`  Your theme is located at: ${chalk.white(`contents/themes/${config.projectSlug}/`)}`))
+  console.log(chalk.gray('  Documentation: https://nextspark.dev/docs'))
+  console.log('')
+}