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

package/dist/bin/wizard/prompts/index.ts

@@ -0,0 +1,173 @@
+/**
+ * Prompts Index
+ *
+ * Exports all prompts and provides functions to run prompts in sequence.
+ * Supports different modes: interactive (all 9 steps), quick (all 9 steps), expert (all with extra options).
+ */
+
+import type { WizardConfig } from '../types.js'
+import { promptProjectInfo } from './project-info.js'
+import { promptTeamConfig } from './team-config.js'
+import { promptI18nConfig } from './i18n-config.js'
+import { promptBillingConfig } from './billing-config.js'
+import { promptFeaturesConfig } from './features-config.js'
+import { promptContentFeaturesConfig, getDefaultContentFeaturesConfig } from './content-features-config.js'
+import { promptAuthConfig, getDefaultAuthConfig } from './auth-config.js'
+import { promptDashboardConfig, getDefaultDashboardConfig } from './dashboard-config.js'
+import { promptDevConfig, getDefaultDevConfig } from './dev-config.js'
+// New DX improvement prompts
+import { promptDemoInstall } from './demo-install.js'
+import { promptEnvSetup, getDefaultEnvSetupAnswers, type EnvSetupAnswers } from './env-config.js'
+import { promptGitSetup, getDefaultGitSetupAnswers, type GitSetupAnswers } from './git-config.js'
+
+export {
+  promptProjectInfo,
+  promptTeamConfig,
+  promptI18nConfig,
+  promptBillingConfig,
+  promptFeaturesConfig,
+  promptContentFeaturesConfig,
+  getDefaultContentFeaturesConfig,
+  promptAuthConfig,
+  promptDashboardConfig,
+  promptDevConfig,
+  // New DX prompts
+  promptDemoInstall,
+  promptEnvSetup,
+  getDefaultEnvSetupAnswers,
+  promptGitSetup,
+  getDefaultGitSetupAnswers,
+}
+
+export type { EnvSetupAnswers, GitSetupAnswers }
+
+/**
+ * Run all prompts in sequence (interactive mode - 9 steps)
+ */
+export async function runAllPrompts(): Promise<WizardConfig> {
+  // Step 1: Project Info
+  const projectInfo = await promptProjectInfo()
+
+  // Step 2: Team Configuration
+  const teamConfig = await promptTeamConfig()
+
+  // Step 3: i18n Configuration
+  const i18nConfig = await promptI18nConfig()
+
+  // Step 4: Billing Configuration
+  const billingConfig = await promptBillingConfig()
+
+  // Step 5: Features Configuration
+  const featuresConfig = await promptFeaturesConfig()
+
+  // Step 6: Content Features Configuration
+  const contentFeaturesConfig = await promptContentFeaturesConfig('interactive', 9)
+
+  // Step 7: Authentication Configuration
+  const authConfig = await promptAuthConfig('interactive', 9)
+
+  // Step 8: Dashboard Configuration
+  const dashboardConfig = await promptDashboardConfig('interactive', 9)
+
+  // Step 9: Dev Tools Configuration
+  const devConfig = await promptDevConfig('interactive', 9)
+
+  // Combine all configurations
+  return {
+    ...projectInfo,
+    ...teamConfig,
+    ...i18nConfig,
+    ...billingConfig,
+    ...featuresConfig,
+    ...contentFeaturesConfig,
+    ...authConfig,
+    ...dashboardConfig,
+    ...devConfig,
+  }
+}
+
+/**
+ * Run quick prompts (steps 1-6) with defaults for steps 7-9
+ */
+export async function runQuickPrompts(): Promise<WizardConfig> {
+  // Step 1: Project Info
+  const projectInfo = await promptProjectInfo()
+
+  // Step 2: Team Configuration
+  const teamConfig = await promptTeamConfig()
+
+  // Step 3: i18n Configuration
+  const i18nConfig = await promptI18nConfig()
+
+  // Step 4: Billing Configuration
+  const billingConfig = await promptBillingConfig()
+
+  // Step 5: Features Configuration
+  const featuresConfig = await promptFeaturesConfig()
+
+  // Step 6: Content Features Configuration (shown in all modes)
+  const contentFeaturesConfig = await promptContentFeaturesConfig('quick', 9)
+
+  // Use defaults for steps 7-9
+  const authConfig = { auth: getDefaultAuthConfig() }
+  const dashboardConfig = { dashboard: getDefaultDashboardConfig() }
+  const devConfig = { dev: getDefaultDevConfig() }
+
+  // Combine all configurations
+  return {
+    ...projectInfo,
+    ...teamConfig,
+    ...i18nConfig,
+    ...billingConfig,
+    ...featuresConfig,
+    ...contentFeaturesConfig,
+    ...authConfig,
+    ...dashboardConfig,
+    ...devConfig,
+  }
+}
+
+/**
+ * Run all prompts with expert options (all 9 steps with advanced settings)
+ */
+export async function runExpertPrompts(): Promise<WizardConfig> {
+  // Step 1: Project Info
+  const projectInfo = await promptProjectInfo()
+
+  // Step 2: Team Configuration
+  const teamConfig = await promptTeamConfig()
+
+  // Step 3: i18n Configuration
+  const i18nConfig = await promptI18nConfig()
+
+  // Step 4: Billing Configuration
+  const billingConfig = await promptBillingConfig()
+
+  // Step 5: Features Configuration
+  const featuresConfig = await promptFeaturesConfig()
+
+  // Step 6: Content Features Configuration
+  const contentFeaturesConfig = await promptContentFeaturesConfig('expert', 9)
+
+  // Step 7: Authentication Configuration (expert mode)
+  const authConfig = await promptAuthConfig('expert', 9)
+
+  // Step 8: Dashboard Configuration (expert mode)
+  const dashboardConfig = await promptDashboardConfig('expert', 9)
+
+  // Step 9: Dev Tools Configuration (expert mode)
+  const devConfig = await promptDevConfig('expert', 9)
+
+  // Combine all configurations
+  return {
+    ...projectInfo,
+    ...teamConfig,
+    ...i18nConfig,
+    ...billingConfig,
+    ...featuresConfig,
+    ...contentFeaturesConfig,
+    ...authConfig,
+    ...dashboardConfig,
+    ...devConfig,
+  }
+}

package/dist/bin/wizard/prompts/project-info.ts

@@ -0,0 +1,89 @@
+/**
+ * Project Info Prompts (Step 1)
+ *
+ * Collects basic project information: name, slug, and description.
+ */
+
+import { input } from '@inquirer/prompts'
+import { showSection } from '../banner.js'
+import type { WizardConfig } from '../types.js'
+
+/**
+ * Convert a string to a URL-safe slug
+ */
+function toSlug(str: string): string {
+  return str
+    .toLowerCase()
+    .trim()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-|-$/g, '')
+}
+
+/**
+ * Validate project name
+ */
+function validateProjectName(name: string): string | true {
+  if (!name || name.trim().length === 0) {
+    return 'Project name is required'
+  }
+  if (name.trim().length < 2) {
+    return 'Project name must be at least 2 characters'
+  }
+  if (name.trim().length > 50) {
+    return 'Project name must be less than 50 characters'
+  }
+  return true
+}
+
+/**
+ * Validate slug format
+ */
+function validateSlug(slug: string): string | true {
+  if (!slug || slug.trim().length === 0) {
+    return 'Slug is required'
+  }
+  if (!/^[a-z][a-z0-9-]*$/.test(slug)) {
+    return 'Slug must start with a letter and contain only lowercase letters, numbers, and hyphens'
+  }
+  if (slug.length < 2) {
+    return 'Slug must be at least 2 characters'
+  }
+  if (slug.length > 30) {
+    return 'Slug must be less than 30 characters'
+  }
+  return true
+}
+
+/**
+ * Run project info prompts
+ */
+export async function promptProjectInfo(): Promise<Pick<WizardConfig, 'projectName' | 'projectSlug' | 'projectDescription'>> {
+  showSection('Project Information', 1, 5)
+
+  // Get project name
+  const projectName = await input({
+    message: 'What is your project name?',
+    default: 'My SaaS App',
+    validate: validateProjectName,
+  })
+
+  // Get project slug (with auto-generated default)
+  const suggestedSlug = toSlug(projectName)
+  const projectSlug = await input({
+    message: 'Project slug (used for theme folder and URLs):',
+    default: suggestedSlug,
+    validate: validateSlug,
+  })
+
+  // Get project description
+  const projectDescription = await input({
+    message: 'Short description of your project:',
+    default: 'A modern SaaS application built with NextSpark',
+  })
+
+  return {
+    projectName,
+    projectSlug,
+    projectDescription,
+  }
+}

package/dist/bin/wizard/prompts/team-config.ts

@@ -0,0 +1,88 @@
+/**
+ * Team Configuration Prompts (Step 2)
+ *
+ * Collects team mode and role configuration.
+ */
+
+import { select, checkbox } from '@inquirer/prompts'
+import { showSection, showInfo } from '../banner.js'
+import type { WizardConfig, TeamMode } from '../types.js'
+import { DEFAULT_ROLES } from '../types.js'
+
+/**
+ * Team mode options with descriptions
+ */
+const TEAM_MODE_OPTIONS = [
+  {
+    name: 'Multi-tenant (Multiple teams, team switching)',
+    value: 'multi-tenant' as TeamMode,
+    description: 'Users can create and join multiple teams. Perfect for CRM, project management, or collaboration tools.',
+  },
+  {
+    name: 'Single-tenant (One organization, no switching)',
+    value: 'single-tenant' as TeamMode,
+    description: 'All users belong to one organization. Ideal for internal tools or company-specific applications.',
+  },
+  {
+    name: 'Single-user (Personal app, no teams)',
+    value: 'single-user' as TeamMode,
+    description: 'Individual user accounts without team features. Perfect for personal dashboards or blogs.',
+  },
+]
+
+/**
+ * Role options with descriptions
+ */
+const ROLE_OPTIONS = [
+  { name: 'Owner (Full control, can delete team)', value: 'owner', checked: true },
+  { name: 'Admin (Can manage members and settings)', value: 'admin', checked: true },
+  { name: 'Member (Standard access)', value: 'member', checked: true },
+  { name: 'Viewer (Read-only access)', value: 'viewer', checked: true },
+]
+
+/**
+ * Run team configuration prompts
+ */
+export async function promptTeamConfig(): Promise<Pick<WizardConfig, 'teamMode' | 'teamRoles'>> {
+  showSection('Team Configuration', 2, 5)
+
+  // Select team mode
+  const teamMode = await select({
+    message: 'What team mode do you need?',
+    choices: TEAM_MODE_OPTIONS,
+    default: 'multi-tenant',
+  })
+
+  // Show info about selected mode
+  const selectedOption = TEAM_MODE_OPTIONS.find(o => o.value === teamMode)
+  if (selectedOption) {
+    showInfo(selectedOption.description)
+  }
+
+  // Only ask for roles if not single-user mode
+  let teamRoles: string[] = DEFAULT_ROLES
+
+  if (teamMode !== 'single-user') {
+    console.log('')
+    teamRoles = await checkbox({
+      message: 'Which roles do you want to include?',
+      choices: ROLE_OPTIONS,
+      required: true,
+    })
+
+    // Ensure owner is always included
+    if (!teamRoles.includes('owner')) {
+      teamRoles = ['owner', ...teamRoles]
+      showInfo('Owner role is required and has been added automatically.')
+    }
+
+    // Show info about custom roles
+    console.log('')
+    showInfo('You can add custom roles later by editing app.config.ts')
+  }
+
+  return {
+    teamMode,
+    teamRoles,
+  }
+}

package/dist/bin/wizard/types.ts

@@ -0,0 +1,150 @@
+/**
+ * NextSpark Wizard Types
+ *
+ * Shared type definitions for the wizard prompts and generators.
+ */
+
+/**
+ * Team mode options for the project
+ */
+export type TeamMode = 'multi-tenant' | 'single-tenant' | 'single-user'
+
+/**
+ * Billing model options
+ */
+export type BillingModel = 'free' | 'freemium' | 'paid'
+
+/**
+ * CLI execution modes
+ */
+export type WizardMode = 'interactive' | 'quick' | 'expert'
+
+/**
+ * Available presets
+ */
+export type PresetName = 'saas' | 'blog' | 'crm'
+
+/**
+ * Available feature flags
+ */
+export interface FeatureFlags {
+  analytics: boolean
+  teams: boolean
+  billing: boolean
+  api: boolean
+  docs: boolean
+}
+
+/**
+ * Authentication configuration (Step 7)
+ * Note: Only email/password and Google OAuth are currently supported
+ */
+export interface AuthConfig {
+  emailPassword: boolean
+  googleOAuth: boolean
+  emailVerification: boolean
+}
+
+/**
+ * Dashboard configuration (Step 8)
+ */
+export interface DashboardConfig {
+  search: boolean
+  notifications: boolean
+  themeToggle: boolean
+  support: boolean
+  quickCreate: boolean
+  superadminAccess: boolean
+  devtoolsAccess: boolean
+  sidebarCollapsed: boolean
+}
+
+/**
+ * Content features configuration (Step 6)
+ * Optional content types: Pages with Page Builder and Blog
+ */
+export interface ContentFeaturesConfig {
+  pages: boolean  // Enable pages with page builder
+  blog: boolean   // Enable blog with posts
+}
+
+/**
+ * Development tools configuration (Step 9)
+ */
+export interface DevConfig {
+  devKeyring: boolean
+  debugMode: boolean
+}
+
+/**
+ * CLI options parsed from command line arguments
+ */
+export interface CLIOptions {
+  mode: WizardMode
+  preset?: PresetName
+}
+
+/**
+ * Complete wizard configuration collected from all prompts
+ */
+export interface WizardConfig {
+  // Step 1: Project Info
+  projectName: string
+  projectSlug: string
+  projectDescription: string
+
+  // Step 2: Team Configuration
+  teamMode: TeamMode
+  teamRoles: string[]
+
+  // Step 3: Internationalization
+  defaultLocale: string
+  supportedLocales: string[]
+
+  // Step 4: Billing Configuration
+  billingModel: BillingModel
+  currency: string
+
+  // Step 5: Features
+  features: FeatureFlags
+
+  // Step 6: Content Features
+  contentFeatures: ContentFeaturesConfig
+
+  // Step 7: Authentication
+  auth: AuthConfig
+
+  // Step 8: Dashboard
+  dashboard: DashboardConfig
+
+  // Step 9: Dev Tools
+  dev: DevConfig
+}
+
+/**
+ * Supported locales with their display names
+ */
+export const AVAILABLE_LOCALES: Record<string, string> = {
+  en: 'English',
+  es: 'Spanish',
+  fr: 'French',
+  de: 'German',
+  it: 'Italian',
+  pt: 'Portuguese',
+}
+
+/**
+ * Default roles available in the system
+ */
+export const DEFAULT_ROLES = ['owner', 'admin', 'member', 'viewer']
+
+/**
+ * Currency options
+ */
+export const CURRENCIES = [
+  { value: 'usd', label: 'USD - US Dollar' },
+  { value: 'eur', label: 'EUR - Euro' },
+  { value: 'gbp', label: 'GBP - British Pound' },
+  { value: 'cad', label: 'CAD - Canadian Dollar' },
+  { value: 'aud', label: 'AUD - Australian Dollar' },
+]