datapilot-cli/scripts/postinstall.js

Enterprise-grade streaming multi-format data analysis with comprehensive statistical insights and intelligent relationship detection - supports CSV, JSON, Excel, TSV, Parquet - memory-efficient, cross-platform

#!/usr/bin/env node
/**
 * Post-install script
 * Shows helpful information after installation
 */

const os = require('os');
const path = require('path');
const fs = require('fs');

// Set executable permissions on the CLI binary
try {
  const binPath = path.join(__dirname, '..', 'dist', 'cli', 'index.js');
  if (fs.existsSync(binPath)) {
    fs.chmodSync(binPath, 0o755);
  }
} catch (error) {
  // Ignore permission errors - some systems might not allow this
}

console.log('\n🎉 DataPilot installed successfully!\n');

// Platform-specific instructions
const platform = os.platform();
const isWindows = platform === 'win32';

// Windows-specific prominent warnings
if (isWindows) {
  console.log('🚨 WINDOWS USERS - IMPORTANT SETUP REQUIRED:');
  console.log('═══════════════════════════════════════════════════════════');
  console.log('⚠️  The "datapilot" command may not work immediately on Windows');
  console.log('⚠️  due to PATH configuration issues. Here are your options:\n');
  
  console.log('🟢 OPTION 1 - Use npx (Recommended, no setup needed):');
  console.log('   npx datapilot-cli --version');
  console.log('   npx datapilot-cli all data.csv\n');
  
  console.log('🟡 OPTION 2 - Add to PATH (One-time setup):');
  try {
    const { execSync } = require('child_process');
    const npmPrefix = execSync('npm config get prefix', { encoding: 'utf8' }).trim();
    console.log(`   1. Add this to your PATH: ${npmPrefix}`);
    console.log('   2. Restart PowerShell/Command Prompt');
    console.log('   3. Then run: datapilot --version\n');
  } catch (error) {
    console.log('   1. Run: npm config get prefix');
    console.log('   2. Add the returned path to your PATH environment variable');
    console.log('   3. Restart PowerShell/Command Prompt\n');
  }
  
  console.log('🟠 OPTION 3 - Use full path:');
  try {
    const { execSync } = require('child_process');
    const npmPrefix = execSync('npm config get prefix', { encoding: 'utf8' }).trim();
    console.log(`   ${npmPrefix}\\datapilot --version\n`);
  } catch (error) {
    console.log('   Find your npm prefix and use: [npm-prefix]\\datapilot\n');
  }
  
  console.log('═══════════════════════════════════════════════════════════\n');
}

console.log('📚 Quick Start:');
if (isWindows) {
  console.log('  npx datapilot-cli --version       # Check version (recommended for Windows)');
  console.log('  npx datapilot-cli --help          # Show all commands');
  console.log('  npx datapilot-cli overview data.csv # Quick file overview');
  console.log('  npx datapilot-cli all data.csv    # Complete analysis (all 6 sections)\n');
} else {
  console.log('  datapilot --version              # Check version');
  console.log('  datapilot --help                 # Show all commands');
  console.log('  datapilot overview data.csv      # Quick file overview');
  console.log('  datapilot all data.csv           # Complete analysis (all 6 sections)\n');
}

// PATH troubleshooting for non-Windows platforms
if (!isWindows) {
  console.log('🔧 If "datapilot: command not found":');
  console.log('  - Use npx instead: npx datapilot-cli --version');
  console.log('  - Or check PATH: npm config get prefix');
  console.log('  - Add npm global bin to your PATH environment variable\n');
}

// Proxy configuration help
if (process.env.HTTP_PROXY || process.env.HTTPS_PROXY) {
  console.log('🔒 Proxy Configuration Detected');
  console.log('  DataPilot will respect your proxy settings automatically.\n');
}

// Large file note
console.log('💾 Working with Large Files:');
console.log('  DataPilot uses streaming to handle files of any size efficiently.');
console.log('  For files over 1GB, memory will be managed automatically.\n');

// Configuration note
console.log('⚙️  Configuration:');
console.log('  Create a .datapilotrc file for custom settings.');
console.log('  See: https://github.com/Mrassimo/datapilot#configuration\n');

console.log('📖 Full documentation: https://github.com/Mrassimo/datapilot');
console.log('🐛 Report issues: https://github.com/Mrassimo/datapilot/issues\n');