Feature: Configuration Presets for Common Use Cases #97

// src/config.js

const PRESETS = {
  minimal: { /* ... */ },
  personal: { /* ... */ },
  community: { /* ... */ },
  private: { /* ... */ },
  federation: { /* ... */ },
  developer: { /* ... */ }
};

function loadConfig(cliOptions, configPath) {
  // 1. Start with defaults
  let config = { ...DEFAULTS };
  
  // 2. Apply preset if specified (NEW)
  const presetName = cliOptions.preset || process.env.JSS_PRESET;
  if (presetName) {
    if (!PRESETS[presetName]) {
      throw new Error(`Unknown preset: ${presetName}. Available: ${Object.keys(PRESETS).join(', ')}`);
    }
    config = { ...config, ...PRESETS[presetName] };
  }
  
  // 3. Apply config file
  if (configPath) {
    const fileConfig = JSON.parse(fs.readFileSync(configPath));
    // Handle preset in config file too
    if (fileConfig.preset && PRESETS[fileConfig.preset]) {
      config = { ...config, ...PRESETS[fileConfig.preset] };
    }
    config = { ...config, ...fileConfig };
  }
  
  // 4. Apply environment variables
  config = applyEnvOverrides(config);
  
  // 5. Apply CLI arguments (highest priority)
  config = { ...config, ...cliOptions };
  
  return config;
}

// bin/jss.js

program
  .command('start')
  .option('--preset <name>', 'Configuration preset (minimal, personal, community, private, federation, developer)')
  // ... existing options

program
  .command('presets')
  .description('List available configuration presets')
  .action(() => {
    console.log('\nAvailable presets:\n');
    console.log('  minimal     Development & testing (single user, no features)');
    console.log('  personal    Single-user production server');
    console.log('  community   Multi-user with open registration');
    console.log('  private     Multi-user with invite-only registration');
    console.log('  federation  Full ActivityPub + Nostr federation');
    console.log('  developer   All features enabled for testing');
    console.log('\nUsage: jss start --preset <name>');
    console.log('\nView preset details: jss presets --show <name>');
  });

// Example test
describe('presets', () => {
  it('should apply personal preset defaults', () => {
    const config = loadConfig({ preset: 'personal' });
    expect(config.singleUser).toBe(true);
    expect(config.idp).toBe(true);
    expect(config.port).toBe(443);
  });

  it('should allow overrides on top of preset', () => {
    const config = loadConfig({ preset: 'personal', port: 8443 });
    expect(config.port).toBe(8443);
    expect(config.singleUser).toBe(true); // from preset
  });

  it('should reject unknown preset', () => {
    expect(() => loadConfig({ preset: 'invalid' })).toThrow(/Unknown preset/);
  });
});