twenty-import-csv 1.0.0

package/src/reporter.ts

@@ -0,0 +1,131 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as cliProgress from 'cli-progress';
+import { LoadResult } from './load';
+
+export interface ProgressBar {
+  update: (value: number, options?: any) => void;
+  stop: () => void;
+}
+
+export function showProgress(total: number): ProgressBar {
+  const progressBar = new cliProgress.SingleBar({
+    format: '📤 Importing |{bar}| {percentage}% | {value}/{total} records | Batch: {batch}',
+    barCompleteChar: '\u2588',
+    barIncompleteChar: '\u2591',
+    hideCursor: true
+  }, cliProgress.Presets.shades_grey);
+
+  progressBar.start(total, 0, { batch: '0/0' });
+  
+  return progressBar;
+}
+
+export function generateReport(result: LoadResult, objectType: string): Promise<void> {
+  return new Promise((resolve) => {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, -5);
+    const reportFile = `import-report-${objectType}-${timestamp}.json`;
+    
+    const report = {
+      timestamp: new Date().toISOString(),
+      objectType: objectType,
+      summary: {
+        total: result.success + result.errors,
+        success: result.success,
+        errors: result.errors,
+        successRate: ((result.success / (result.success + result.errors)) * 100).toFixed(2) + '%'
+      },
+      errors: result.errorLog
+    };
+
+    fs.writeFileSync(reportFile, JSON.stringify(report, null, 2), 'utf8');
+    console.log(`\n📊 Report saved to ${reportFile}`);
+    
+    // Save error log if there are errors
+    if (result.errors > 0) {
+      const errorLogFile = `import-errors-${timestamp}.log`;
+      fs.writeFileSync(errorLogFile, result.errorLog.join('\n'), 'utf8');
+      console.log(`📄 Error log saved to ${errorLogFile}`);
+    }
+
+    // Show summary
+    console.log('\n📋 Import Summary:');
+    console.log(`   Total records: ${result.success + result.errors}`);
+    console.log(`   ✅ Successful: ${result.success}`);
+    console.log(`   ❌ Errors: ${result.errors}`);
+    console.log(`   📈 Success rate: ${((result.success / (result.success + result.errors)) * 100).toFixed(2)}%`);
+    
+    resolve();
+  });
+}
+
+export function showPreview(data: any[], objectType: string, limit: number = 5): void {
+  console.log(`\n👀 Preview - First ${limit} records for ${objectType}:`);
+  
+  const preview = data.slice(0, limit).map((record, index) => ({
+    '#': index + 1,
+    ...record
+  }));
+
+  console.table(preview);
+  
+  if (data.length > limit) {
+    console.log(`... and ${data.length - limit} more records`);
+  }
+}
+
+export function validateOptions(options: any): { valid: boolean; errors: string[] } {
+  const errors: string[] = [];
+
+  if (!options.file) {
+    errors.push('CSV file is required (--file)');
+  }
+  
+  if (!options.object) {
+    errors.push('Object type is required (--object)');
+  }
+  
+  if (!options.twentyUrl) {
+    errors.push('Twenty URL is required (--twenty-url)');
+  }
+  
+  if (!options.twentyKey) {
+    errors.push('Twenty API key is required (--twenty-key)');
+  }
+
+  if (options.file && !fs.existsSync(options.file)) {
+    errors.push(`CSV file not found: ${options.file}`);
+  }
+
+  const validObjects = ['people', 'companies', 'opportunities', 'tasks', 'notes'];
+  if (options.object && !validObjects.includes(options.object.toLowerCase())) {
+    errors.push(`Invalid object type. Valid options: ${validObjects.join(', ')}`);
+  }
+
+  return {
+    valid: errors.length === 0,
+    errors
+  };
+}
+
+export function formatFileSize(bytes: number): string {
+  const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+  if (bytes === 0) return '0 Bytes';
+  
+  const i = Math.floor(Math.log(bytes) / Math.log(1024));
+  return Math.round(bytes / Math.pow(1024, i) * 100) / 100 + ' ' + sizes[i];
+}
+
+export function formatDuration(ms: number): string {
+  const seconds = Math.floor(ms / 1000);
+  const minutes = Math.floor(seconds / 60);
+  const hours = Math.floor(minutes / 60);
+  
+  if (hours > 0) {
+    return `${hours}h ${minutes % 60}m ${seconds % 60}s`;
+  } else if (minutes > 0) {
+    return `${minutes}m ${seconds % 60}s`;
+  } else {
+    return `${seconds}s`;
+  }
+}

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}