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

package/dist/bin/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022"],
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "./dist",
+    "rootDir": ".",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": false,
+    "sourceMap": true
+  },
+  "include": [
+    "./**/*.ts"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}

package/dist/bin/wizard/banner.ts

@@ -0,0 +1,67 @@
+/**
+ * NextSpark ASCII Banner
+ *
+ * Beautiful ASCII art banner for the CLI wizard.
+ */
+
+import chalk from 'chalk'
+
+/**
+ * NextSpark ASCII logo
+ */
+const BANNER = `
+    _   __          __  _____                  __
+   / | / /__  _  __/ /_/ ___/____  ____ ______/ /__
+  /  |/ / _ \\| |/_/ __/\\__ \\/ __ \\/ __ \`/ ___/ //_/
+ / /|  /  __/>  </ /_ ___/ / /_/ / /_/ / /  / ,<
+/_/ |_/\\___/_/|_|\\__//____/ .___/\\__,_/_/  /_/|_|
+                         /_/
+`
+
+/**
+ * Display the welcome banner
+ */
+export function showBanner(): void {
+  console.log(chalk.cyan(BANNER))
+  console.log(chalk.bold.white('  Welcome to NextSpark - The Complete SaaS Framework for Next.js'))
+  console.log(chalk.gray('  Create production-ready SaaS applications in minutes\n'))
+  console.log(chalk.gray('  ' + '='.repeat(60) + '\n'))
+}
+
+/**
+ * Display section header
+ */
+export function showSection(title: string, step: number, totalSteps: number): void {
+  console.log('')
+  console.log(chalk.cyan(`  Step ${step}/${totalSteps}: ${title}`))
+  console.log(chalk.gray('  ' + '-'.repeat(40)))
+  console.log('')
+}
+
+/**
+ * Display success message
+ */
+export function showSuccess(message: string): void {
+  console.log(chalk.green(`  ✓ ${message}`))
+}
+
+/**
+ * Display warning message
+ */
+export function showWarning(message: string): void {
+  console.log(chalk.yellow(`  ⚠ ${message}`))
+}
+
+/**
+ * Display error message
+ */
+export function showError(message: string): void {
+  console.log(chalk.red(`  ✗ ${message}`))
+}
+
+/**
+ * Display info message
+ */
+export function showInfo(message: string): void {
+  console.log(chalk.blue(`  ℹ ${message}`))
+}

package/dist/bin/wizard/generators/config-generator.ts

@@ -0,0 +1,341 @@
+/**
+ * Config Generator
+ *
+ * Generates and updates configuration files based on wizard responses.
+ */
+
+import fs from 'fs-extra'
+import path from 'path'
+import type { WizardConfig } from '../types.js'
+
+/**
+ * Get the target themes directory in the user's project
+ */
+function getTargetThemesDir(): string {
+  return path.resolve(process.cwd(), 'contents', 'themes')
+}
+
+/**
+ * Update authentication config based on wizard responses
+ * Note: Only email/password and Google OAuth are currently supported
+ */
+export async function updateAuthConfig(config: WizardConfig): Promise<void> {
+  const authConfigPath = path.join(
+    getTargetThemesDir(),
+    config.projectSlug,
+    'config',
+    'auth.config.ts'
+  )
+
+  if (!await fs.pathExists(authConfigPath)) {
+    return
+  }
+
+  let content = await fs.readFile(authConfigPath, 'utf-8')
+
+  // Update email/password enabled
+  content = content.replace(
+    /(emailPassword:\s*{[^}]*enabled:\s*)(?:true|false)/gs,
+    `$1${config.auth.emailPassword}`
+  )
+
+  // Update Google OAuth enabled
+  content = content.replace(
+    /(google:\s*{[^}]*enabled:\s*)(?:true|false)/gs,
+    `$1${config.auth.googleOAuth}`
+  )
+
+  // Update email verification
+  content = content.replace(
+    /(emailVerification:\s*)(?:true|false)/g,
+    `$1${config.auth.emailVerification}`
+  )
+
+  await fs.writeFile(authConfigPath, content, 'utf-8')
+}
+
+/**
+ * Update dashboard UI config based on wizard responses
+ */
+export async function updateDashboardUIConfig(config: WizardConfig): Promise<void> {
+  const dashboardConfigPath = path.join(
+    getTargetThemesDir(),
+    config.projectSlug,
+    'config',
+    'dashboard.config.ts'
+  )
+
+  if (!await fs.pathExists(dashboardConfigPath)) {
+    return
+  }
+
+  let content = await fs.readFile(dashboardConfigPath, 'utf-8')
+
+  // Update search enabled
+  content = content.replace(
+    /(search:\s*{[^}]*enabled:\s*)(?:true|false)/gs,
+    `$1${config.dashboard.search}`
+  )
+
+  // Update notifications enabled
+  content = content.replace(
+    /(notifications:\s*{[^}]*enabled:\s*)(?:true|false)/gs,
+    `$1${config.dashboard.notifications}`
+  )
+
+  // Update theme toggle enabled
+  content = content.replace(
+    /(themeToggle:\s*{[^}]*enabled:\s*)(?:true|false)/gs,
+    `$1${config.dashboard.themeToggle}`
+  )
+
+  // Update support enabled
+  content = content.replace(
+    /(support:\s*{[^}]*enabled:\s*)(?:true|false)/gs,
+    `$1${config.dashboard.support}`
+  )
+
+  // Update quickCreate enabled
+  content = content.replace(
+    /(quickCreate:\s*{[^}]*enabled:\s*)(?:true|false)/gs,
+    `$1${config.dashboard.quickCreate}`
+  )
+
+  // Update adminAccess enabled (mapped from wizard's superadminAccess)
+  content = content.replace(
+    /(adminAccess:\s*{[^}]*enabled:\s*)(?:true|false)/gs,
+    `$1${config.dashboard.superadminAccess}`
+  )
+
+  // Update devtoolsAccess enabled
+  content = content.replace(
+    /(devtoolsAccess:\s*{[^}]*enabled:\s*)(?:true|false)/gs,
+    `$1${config.dashboard.devtoolsAccess}`
+  )
+
+  // Update sidebar collapsed default
+  content = content.replace(
+    /(defaultCollapsed:\s*)(?:true|false)/g,
+    `$1${config.dashboard.sidebarCollapsed}`
+  )
+
+  await fs.writeFile(dashboardConfigPath, content, 'utf-8')
+}
+
+/**
+ * Update dev tools config based on wizard responses
+ */
+export async function updateDevToolsConfig(config: WizardConfig): Promise<void> {
+  const devConfigPath = path.join(
+    getTargetThemesDir(),
+    config.projectSlug,
+    'config',
+    'dev.config.ts'
+  )
+
+  if (!await fs.pathExists(devConfigPath)) {
+    return
+  }
+
+  let content = await fs.readFile(devConfigPath, 'utf-8')
+
+  // Update dev keyring enabled
+  content = content.replace(
+    /(devKeyring:\s*{[^}]*enabled:\s*)(?:true|false)/gs,
+    `$1${config.dev.devKeyring}`
+  )
+
+  // Update debug mode enabled
+  content = content.replace(
+    /(debugMode:\s*)(?:true|false)/g,
+    `$1${config.dev.debugMode}`
+  )
+
+  await fs.writeFile(devConfigPath, content, 'utf-8')
+}
+
+/**
+ * Generate permissions config based on team roles
+ */
+export async function updatePermissionsConfig(config: WizardConfig): Promise<void> {
+  const permissionsConfigPath = path.join(
+    getTargetThemesDir(),
+    config.projectSlug,
+    'config',
+    'permissions.config.ts'
+  )
+
+  if (!await fs.pathExists(permissionsConfigPath)) {
+    return
+  }
+
+  let content = await fs.readFile(permissionsConfigPath, 'utf-8')
+
+  // Update role arrays in permissions based on selected roles
+  const availableRoles = config.teamRoles
+
+  // Build regex pattern to match role arrays
+  // This updates roles: ['owner', 'admin', 'member', 'viewer'] patterns
+  const roleArrayPattern = /roles:\s*\[(.*?)\]/g
+
+  content = content.replace(roleArrayPattern, (match, rolesStr) => {
+    // Parse current roles
+    const currentRoles = rolesStr
+      .split(',')
+      .map((r: string) => r.trim().replace(/['"]/g, ''))
+      .filter((r: string) => r.length > 0)
+
+    // Filter to only include available roles
+    const filteredRoles = currentRoles.filter((r: string) => availableRoles.includes(r))
+
+    // If no roles remain, keep at least owner
+    if (filteredRoles.length === 0) {
+      filteredRoles.push('owner')
+    }
+
+    return `roles: [${filteredRoles.map((r: string) => `'${r}'`).join(', ')}]`
+  })
+
+  await fs.writeFile(permissionsConfigPath, content, 'utf-8')
+}
+
+/**
+ * Update dashboard config with feature flags
+ */
+export async function updateDashboardConfig(config: WizardConfig): Promise<void> {
+  const dashboardConfigPath = path.join(
+    getTargetThemesDir(),
+    config.projectSlug,
+    'config',
+    'dashboard.config.ts'
+  )
+
+  if (!await fs.pathExists(dashboardConfigPath)) {
+    return
+  }
+
+  let content = await fs.readFile(dashboardConfigPath, 'utf-8')
+
+  // Update analytics visibility
+  if (!config.features.analytics) {
+    // Comment out analytics-related navigation items or set enabled: false
+    content = content.replace(
+      /(id:\s*['"]analytics['"].*?enabled:\s*)true/gs,
+      '$1false'
+    )
+  }
+
+  // Update billing visibility
+  if (!config.features.billing) {
+    content = content.replace(
+      /(id:\s*['"]billing['"].*?enabled:\s*)true/gs,
+      '$1false'
+    )
+  }
+
+  // Update teams visibility based on team mode
+  if (config.teamMode === 'single-user') {
+    content = content.replace(
+      /(id:\s*['"]team['"].*?enabled:\s*)true/gs,
+      '$1false'
+    )
+    content = content.replace(
+      /(id:\s*['"]members['"].*?enabled:\s*)true/gs,
+      '$1false'
+    )
+  }
+
+  await fs.writeFile(dashboardConfigPath, content, 'utf-8')
+}
+
+/**
+ * Generate .env.example file with project-specific values
+ */
+export async function generateEnvExample(config: WizardConfig): Promise<void> {
+  const envExamplePath = path.resolve(process.cwd(), '.env.example')
+
+  // Build OAuth section based on enabled providers
+  let oauthSection = ''
+  if (config.auth.googleOAuth) {
+    oauthSection = `# =============================================================================
+# OAUTH PROVIDERS
+# =============================================================================
+GOOGLE_CLIENT_ID="your-google-client-id"
+GOOGLE_CLIENT_SECRET="your-google-client-secret"
+`
+  } else {
+    oauthSection = `# =============================================================================
+# OAUTH (Optional - enable in auth.config.ts)
+# =============================================================================
+# GOOGLE_CLIENT_ID=""
+# GOOGLE_CLIENT_SECRET=""
+`
+  }
+
+  const envContent = `# NextSpark Environment Configuration
+# Generated for: ${config.projectName}
+
+# =============================================================================
+# DATABASE
+# =============================================================================
+DATABASE_URL="postgresql://user:password@localhost:5432/database"
+
+# =============================================================================
+# AUTHENTICATION (better-auth)
+# =============================================================================
+# Generate with: openssl rand -base64 32
+BETTER_AUTH_SECRET="your-secret-key-here"
+
+# =============================================================================
+# THEME
+# =============================================================================
+NEXT_PUBLIC_ACTIVE_THEME="${config.projectSlug}"
+
+# =============================================================================
+# APPLICATION
+# =============================================================================
+NEXT_PUBLIC_APP_URL="http://localhost:3000"
+NODE_ENV="development"
+
+${config.features.billing ? `# =============================================================================
+# STRIPE (Billing)
+# =============================================================================
+STRIPE_SECRET_KEY="sk_test_..."
+STRIPE_WEBHOOK_SECRET="whsec_..."
+NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY="pk_test_..."
+` : '# Billing is disabled - no Stripe configuration needed'}
+
+# =============================================================================
+# EMAIL (Resend)
+# =============================================================================
+RESEND_API_KEY="re_..."
+
+${oauthSection}`
+
+  // Only create if it doesn't exist
+  if (!await fs.pathExists(envExamplePath)) {
+    await fs.writeFile(envExamplePath, envContent, 'utf-8')
+  }
+}
+
+/**
+ * Update README.md with project-specific information
+ */
+export async function updateReadme(config: WizardConfig): Promise<void> {
+  const readmePath = path.join(getTargetThemesDir(), config.projectSlug, 'README.md')
+
+  if (!await fs.pathExists(readmePath)) {
+    return
+  }
+
+  let content = await fs.readFile(readmePath, 'utf-8')
+
+  // Update title and description
+  content = content.replace(/# Starter Theme/g, `# ${config.projectName}`)
+  content = content.replace(
+    /Minimal starter theme for NextSpark/g,
+    config.projectDescription
+  )
+
+  await fs.writeFile(readmePath, content, 'utf-8')
+}

package/dist/bin/wizard/generators/content-features-generator.ts

@@ -0,0 +1,111 @@
+/**
+ * Content Features Generator
+ *
+ * Copies optional entities and blocks based on content feature selections:
+ * - Pages: Copies pages entity (hero block already in starter)
+ * - Blog: Copies posts entity + post-content block
+ */
+
+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/content-features-generator.js, go up to reach packages/core/templates
+ */
+function getTemplatesDir(): string {
+  return path.resolve(__dirname, '../../../../templates')
+}
+
+/**
+ * Get the features directory path
+ */
+function getFeaturesDir(): string {
+  return path.join(getTemplatesDir(), 'features')
+}
+
+/**
+ * Get the target theme directory in the user's project
+ */
+function getTargetThemeDir(projectSlug: string): string {
+  return path.resolve(process.cwd(), 'contents', 'themes', projectSlug)
+}
+
+/**
+ * Copy pages feature (entity only, hero block already in starter)
+ */
+async function copyPagesFeature(config: WizardConfig): Promise<void> {
+  const featuresDir = getFeaturesDir()
+  const targetThemeDir = getTargetThemeDir(config.projectSlug)
+
+  const sourcePagesEntity = path.join(featuresDir, 'pages', 'entities', 'pages')
+  const targetEntitiesDir = path.join(targetThemeDir, 'entities', 'pages')
+
+  // Check if source exists
+  if (!await fs.pathExists(sourcePagesEntity)) {
+    console.warn(`Warning: Pages entity not found at: ${sourcePagesEntity}`)
+    return
+  }
+
+  // Copy pages entity
+  await fs.copy(sourcePagesEntity, targetEntitiesDir)
+}
+
+/**
+ * Copy blog feature (posts entity + post-content block)
+ */
+async function copyBlogFeature(config: WizardConfig): Promise<void> {
+  const featuresDir = getFeaturesDir()
+  const targetThemeDir = getTargetThemeDir(config.projectSlug)
+
+  // Copy posts entity
+  const sourcePostsEntity = path.join(featuresDir, 'blog', 'entities', 'posts')
+  const targetPostsEntity = path.join(targetThemeDir, 'entities', 'posts')
+
+  if (await fs.pathExists(sourcePostsEntity)) {
+    await fs.copy(sourcePostsEntity, targetPostsEntity)
+  } else {
+    console.warn(`Warning: Posts entity not found at: ${sourcePostsEntity}`)
+  }
+
+  // Copy post-content block
+  const sourcePostContentBlock = path.join(featuresDir, 'blog', 'blocks', 'post-content')
+  const targetPostContentBlock = path.join(targetThemeDir, 'blocks', 'post-content')
+
+  if (await fs.pathExists(sourcePostContentBlock)) {
+    await fs.copy(sourcePostContentBlock, targetPostContentBlock)
+  } else {
+    console.warn(`Warning: Post-content block not found at: ${sourcePostContentBlock}`)
+  }
+}
+
+/**
+ * Copy content features based on wizard configuration
+ *
+ * Combinations:
+ * - Neither: No additional entities/blocks copied
+ * - Pages only: pages entity copied (hero already in starter)
+ * - Blog only: posts entity + post-content block copied
+ * - Both: pages entity + posts entity + post-content block copied
+ */
+export async function copyContentFeatures(config: WizardConfig): Promise<void> {
+  // Skip if no content features are enabled
+  if (!config.contentFeatures.pages && !config.contentFeatures.blog) {
+    return
+  }
+
+  // Copy pages feature if enabled
+  if (config.contentFeatures.pages) {
+    await copyPagesFeature(config)
+  }
+
+  // Copy blog feature if enabled
+  if (config.contentFeatures.blog) {
+    await copyBlogFeature(config)
+  }
+}