csv-faker-generator 1.0.0 → 2.0.0

package/README.md

@@ -4,11 +4,13 @@ Generate CSV files with realistic fake data using customizable headers and data
 
 ## Features
 
-- Generate CSV files with custom column headers
-- Support for 19+ data types (UUID, names, emails, addresses, etc.)
-- Simple CLI interface
-- Programmatic API for Node.js projects
-- TypeScript support with full type definitions
+- **27+ data types**: UUID, names, emails, addresses, banking info, and more
+- **Advanced data generation**: Alphanumeric strings, pick from custom values, formula-based calculated fields
+- **Flexible number formatting**: Control decimal precision and ranges
+- **Custom delimiters**: Support for comma, semicolon, tab, pipe
+- **Simple CLI interface**: Generate CSV files from command line
+- **Programmatic API**: Use in Node.js/TypeScript projects
+- **Full TypeScript support**: Complete type definitions included
 
 ## Installation
 
@@ -16,34 +18,20 @@ Generate CSV files with realistic fake data using customizable headers and data
 npm install csv-faker-generator
 ```
 
-## Usage
+## Quick Start
 
 ### CLI Usage
 
-Generate a CSV file from the command line:
-
 ```bash
 # Basic usage
 npx csv-faker -c id:uuid,name:name,email:email -r 100 -o users.csv
 
-# Generate user data
-npx csv-faker --columns "userId:uuid,firstName:firstName,lastName:lastName,email:email,phone:phone" --rows 50 --output customers.csv
-
-# Generate company data
-npx csv-faker -c id:uuid,company:company,city:city,country:country -r 20
+# With custom delimiter
+npx csv-faker -c id:uuid,name:name,email:email --delimiter ";" -r 50 -o contacts.csv
 ```
 
-#### CLI Options
-
-- `--columns, -c` - Column definitions (format: `header:type,header:type,...`)
-- `--rows, -r` - Number of rows to generate (default: 10)
-- `--output, -o` - Output file path (default: output.csv)
-- `--help, -h` - Show help message
-
 ### Programmatic Usage
 
-Use in your Node.js/TypeScript projects:
-
 ```typescript
 import { generateCSV } from 'csv-faker-generator';
 
@@ -52,109 +40,313 @@ await generateCSV({
     { header: 'id', type: 'uuid' },
     { header: 'name', type: 'name' },
     { header: 'email', type: 'email' },
-    { header: 'address', type: 'address' },
   ],
   rows: 100,
   output: 'users.csv',
 });
 ```
 
-#### With Custom Number Ranges
+## Advanced Features
+
+### 1. Alphanumeric Type
+
+Generate alphanumeric strings with custom length and case:
 
 ```typescript
 await generateCSV({
   columns: [
-    { header: 'id', type: 'uuid' },
-    { header: 'age', type: 'number', min: 18, max: 65 },
-    { header: 'salary', type: 'number', min: 30000, max: 150000 },
+    { header: 'product_code', type: 'alphanumeric', length: 10, uppercase: true },
+    { header: 'sku', type: 'alphanumeric', length: 15 },
   ],
-  rows: 50,
-  output: 'employees.csv',
+  rows: 100,
+  output: 'products.csv',
 });
 ```
 
-## Supported Data Types
+Output:
+```csv
+product_code,sku
+PMA094QITG,nbdAIBY9Og7gDWd
+SXYBL4LJQO,gakXOrBZYw1tYFP
+```
 
-| Type | Description | Example |
-|------|-------------|---------|
-| `uuid` | UUID v4 | `550e8400-e29b-41d4-a716-446655440000` |
-| `name` | Full name | `John Doe` |
-| `firstName` | First name only | `John` |
-| `lastName` | Last name only | `Doe` |
-| `email` | Email address | `john.doe@example.com` |
-| `phone` | Phone number | `+1-234-567-8900` |
-| `address` | Street address | `123 Main St` |
-| `city` | City name | `New York` |
-| `country` | Country name | `United States` |
-| `zipCode` | Postal code | `10001` |
-| `company` | Company name | `Tech Corp` |
-| `jobTitle` | Job title | `Software Engineer` |
-| `number` | Random number | `42` |
-| `date` | ISO date string | `2024-01-15T10:30:00.000Z` |
-| `boolean` | Boolean value | `true` or `false` |
-| `url` | Website URL | `https://example.com` |
-| `ip` | IP address | `192.168.1.1` |
-| `username` | Username | `john_doe123` |
-| `password` | Password | `aB3$xYz9!qW` |
-
-## Examples
+### 2. Pick Type (Enum Values)
 
-### Example 1: User Database
+Select values from predefined arrays:
 
-```bash
-npx csv-faker -c userId:uuid,username:username,email:email,password:password,createdAt:date -r 1000 -o users.csv
+```typescript
+await generateCSV({
+  columns: [
+    { header: 'product', type: 'name' },
+    { header: 'tax_rate', type: 'pick', values: [0, 7, 19] },
+    { header: 'status', type: 'pick', values: ['active', 'pending', 'inactive'] },
+    { header: 'unit', type: 'pick', values: ['g', 'kg', 'Stück', 'Meter'] },
+  ],
+  rows: 100,
+  output: 'products.csv',
+});
+```
+
+### 3. Formula Type (Calculated Fields)
+
+Create calculated fields based on other columns:
+
+```typescript
+await generateCSV({
+  columns: [
+    { header: 'product', type: 'company' },
+    { header: 'netto', type: 'number', min: 10, max: 200, decimals: 2 },
+    { header: 'tax', type: 'pick', values: [0, 7, 19] },
+    {
+      header: 'brutto',
+      type: 'formula',
+      formula: (row) => {
+        const netto = row.netto;
+        const tax = row.tax;
+        return parseFloat((netto * (1 + tax / 100)).toFixed(2));
+      },
+    },
+  ],
+  rows: 100,
+  output: 'invoices.csv',
+});
+```
+
+Output:
+```csv
+product,netto,tax,brutto
+Reichert LLC,120.39,19,143.26
+Becker LLC,132.14,7,141.39
+```
+
+### 4. Decimal Precision
+
+Control decimal places for number types:
+
+```typescript
+await generateCSV({
+  columns: [
+    { header: 'price', type: 'number', min: 10, max: 200, decimals: 2 },
+    { header: 'weight', type: 'number', min: 0.1, max: 99.9, decimals: 1 },
+    { header: 'quantity', type: 'number', min: 1, max: 1000, decimals: 0 }, // integers
+  ],
+  rows: 100,
+  output: 'products.csv',
+});
+```
+
+### 5. Custom Delimiters
+
+Generate CSV files with different delimiters:
+
+```typescript
+// Semicolon-separated
+await generateCSV({
+  columns: [{ header: 'id', type: 'uuid' }, { header: 'name', type: 'name' }],
+  rows: 100,
+  delimiter: ';',
+  output: 'contacts.csv',
+});
+
+// Tab-separated (TSV)
+await generateCSV({
+  columns: [{ header: 'id', type: 'uuid' }, { header: 'name', type: 'name' }],
+  rows: 100,
+  delimiter: '\t',
+  output: 'data.tsv',
+});
 ```
 
-### Example 2: E-commerce Orders
+## Complete Example: E-commerce Articles
+
+This example demonstrates all advanced features together:
 
 ```typescript
 import { generateCSV } from 'csv-faker-generator';
 
 await generateCSV({
   columns: [
-    { header: 'orderId', type: 'uuid' },
-    { header: 'customerName', type: 'name' },
-    { header: 'email', type: 'email' },
-    { header: 'amount', type: 'number', min: 10, max: 500 },
-    { header: 'orderDate', type: 'date' },
-    { header: 'city', type: 'city' },
-    { header: 'country', type: 'country' },
+    { header: 'Artikelnummer*', type: 'alphanumeric', length: 15 },
+    { header: 'Bezeichnung*', type: 'company' },
+    { header: 'Beschreibung', type: 'company' },
+    { header: 'Verkaufspreis netto in €', type: 'number', min: 10, max: 200, decimals: 2 },
+    { header: 'Steuersatz', type: 'pick', values: [0, 7, 19] },
+    {
+      header: 'Verkaufspreis brutto in €',
+      type: 'formula',
+      formula: (row) => {
+        const netto = row['Verkaufspreis netto in €'];
+        const tax = row['Steuersatz'];
+        return parseFloat((netto * (1 + tax / 100)).toFixed(2));
+      },
+    },
+    { header: 'Einkaufspreis netto in €', type: 'number', min: 5, max: 100, decimals: 2 },
+    { header: 'Einheit', type: 'pick', values: ['Stück', 'kg', 'g', 'Meter', 'Liter'] },
+    { header: 'Bestand', type: 'number', min: 0, max: 1000, decimals: 0 },
+    { header: 'Kategorie', type: 'pick', values: ['Electronics', 'Food', 'Clothing', 'Books'] },
   ],
-  rows: 500,
-  output: 'orders.csv',
+  rows: 100,
+  output: 'articles.csv',
 });
 ```
 
-### Example 3: Employee Directory
+## CLI Reference
+
+### Options
+
+- `--columns, -c` - Column definitions (format: `header:type,header:type,...`)
+- `--rows, -r` - Number of rows to generate (default: 10)
+- `--output, -o` - Output file path (default: output.csv)
+- `--delimiter, -d` - Field delimiter (default: `,`) [options: `,` `;` `|` `\t`]
+- `--help, -h` - Show help message
+
+### Examples
 
 ```bash
-npx csv-faker -c id:uuid,firstName:firstName,lastName:lastName,email:email,phone:phone,jobTitle:jobTitle,company:company -r 200 -o employees.csv
-```
+# Generate users
+npx csv-faker -c id:uuid,name:name,email:email -r 100 -o users.csv
 
-## API Reference
+# Generate with semicolon delimiter
+npx csv-faker -c id:uuid,name:name,email:email --delimiter ";" -r 50 -o contacts.csv
 
-### `generateCSV(options: GenerateOptions): Promise<void>`
+# Generate customer data
+npx csv-faker -c customer_number:number,title:title,firstname:firstName,lastname:lastName,email:email,iban:iban,bic:bic -r 200 -o customers.csv
+```
 
-Generates a CSV file with fake data.
+**Note**: Advanced features like `alphanumeric` with length, `pick` with values, and `formula` require programmatic usage. CLI only supports basic data types.
 
-**Parameters:**
-- `options.columns`: Array of column definitions
-- `options.rows`: Number of rows to generate
-- `options.output`: Output file path
+## Supported Data Types
+
+| Type | Description | Example | CLI | Programmatic |
+|------|-------------|---------|-----|--------------|
+| `uuid` | UUID v4 | `550e8400-e29b-...` | ✓ | ✓ |
+| `name` | Full name | `John Doe` | ✓ | ✓ |
+| `firstName` | First name | `John` | ✓ | ✓ |
+| `lastName` | Last name | `Doe` | ✓ | ✓ |
+| `title` | Person prefix | `Mr.`, `Mrs.`, `Dr.` | ✓ | ✓ |
+| `email` | Email address | `john.doe@example.com` | ✓ | ✓ |
+| `phone` | Phone number | `+1-234-567-8900` | ✓ | ✓ |
+| `address` | Street address | `123 Main St` | ✓ | ✓ |
+| `secondaryAddress` | Apt/Suite | `Apt. 4B` | ✓ | ✓ |
+| `city` | City name | `New York` | ✓ | ✓ |
+| `country` | Country name | `United States` | ✓ | ✓ |
+| `zipCode` | Postal code | `10001` | ✓ | ✓ |
+| `company` | Company name | `Tech Corp` | ✓ | ✓ |
+| `jobTitle` | Job title | `Software Engineer` | ✓ | ✓ |
+| `number` | Random number | `42` | ✓ | ✓ |
+| `date` | ISO date | `2024-01-15T10:30:00.000Z` | ✓ | ✓ |
+| `boolean` | Boolean | `true` / `false` | ✓ | ✓ |
+| `url` | Website URL | `https://example.com` | ✓ | ✓ |
+| `ip` | IP address | `192.168.1.1` | ✓ | ✓ |
+| `username` | Username | `john_doe123` | ✓ | ✓ |
+| `password` | Password | `aB3$xYz9!qW` | ✓ | ✓ |
+| `iban` | IBAN | `DE89370400440532013000` | ✓ | ✓ |
+| `bic` | BIC/SWIFT | `COBADEFFXXX` | ✓ | ✓ |
+| `bankName` | Bank name | `Deutsche Bank` | ✓ | ✓ |
+| `alphanumeric` | Alphanumeric string | `aB3xYz9qW` | ✓* | ✓ |
+| `pick` | Pick from array | Custom values | ✓* | ✓ |
+| `formula` | Calculated value | Based on other fields | ✗ | ✓ |
+
+*CLI supports the type but not advanced options (length, uppercase, values, etc.)
+
+## TypeScript API
+
+### Types
 
-**ColumnDefinition:**
 ```typescript
+type DataType =
+  | 'uuid' | 'name' | 'firstName' | 'lastName' | 'title'
+  | 'email' | 'phone' | 'address' | 'secondaryAddress'
+  | 'city' | 'country' | 'zipCode' | 'company' | 'jobTitle'
+  | 'number' | 'date' | 'boolean' | 'url' | 'ip'
+  | 'username' | 'password' | 'iban' | 'bic' | 'bankName'
+  | 'alphanumeric' | 'pick' | 'formula';
+
 interface ColumnDefinition {
   header: string;
   type: DataType;
-  min?: number;  // For 'number' type
-  max?: number;  // For 'number' type
+  min?: number;              // For 'number' type
+  max?: number;              // For 'number' type
+  length?: number;           // For 'alphanumeric' type
+  uppercase?: boolean;       // For 'alphanumeric' type
+  values?: any[];            // For 'pick' type
+  formula?: (row: Record<string, any>) => any; // For 'formula' type
+  decimals?: number;         // For 'number' type
 }
+
+interface GenerateOptions {
+  columns: ColumnDefinition[];
+  rows: number;
+  output: string;
+  delimiter?: string;        // Default: ','
+}
+
+function generateCSV(options: GenerateOptions): Promise<void>;
+```
+
+## More Examples
+
+### Example 1: User Database
+
+```typescript
+await generateCSV({
+  columns: [
+    { header: 'userId', type: 'uuid' },
+    { header: 'username', type: 'username' },
+    { header: 'email', type: 'email' },
+    { header: 'password', type: 'password' },
+    { header: 'createdAt', type: 'date' },
+  ],
+  rows: 1000,
+  output: 'users.csv',
+});
 ```
 
-### `parseColumnString(columnStr: string): ColumnDefinition`
+### Example 2: Banking Data
+
+```typescript
+await generateCSV({
+  columns: [
+    { header: 'accountId', type: 'uuid' },
+    { header: 'accountOwner', type: 'name' },
+    { header: 'iban', type: 'iban' },
+    { header: 'bic', type: 'bic' },
+    { header: 'bankName', type: 'bankName' },
+    { header: 'balance', type: 'number', min: 0, max: 100000, decimals: 2 },
+  ],
+  rows: 500,
+  output: 'accounts.csv',
+});
+```
+
+### Example 3: Inventory System
+
+```typescript
+await generateCSV({
+  columns: [
+    { header: 'SKU', type: 'alphanumeric', length: 12, uppercase: true },
+    { header: 'Product', type: 'company' },
+    { header: 'Category', type: 'pick', values: ['Electronics', 'Furniture', 'Clothing', 'Food'] },
+    { header: 'Price', type: 'number', min: 5, max: 500, decimals: 2 },
+    { header: 'Stock', type: 'number', min: 0, max: 1000, decimals: 0 },
+    { header: 'Status', type: 'pick', values: ['In Stock', 'Low Stock', 'Out of Stock'] },
+  ],
+  rows: 200,
+  output: 'inventory.csv',
+});
+```
+
+## Future Features (Roadmap)
+
+Based on community feedback, we're considering:
+
+- Locale support for region-specific data
+- Templates/presets for common use cases
+- Row dependencies and conditional values
+- Related dataset generation (parent-child relationships)
+- More business data types (VAT numbers, tax IDs, etc.)
 
-Parses a column string (e.g., "id:uuid") into a ColumnDefinition object.
+See [issues](https://github.com/yourusername/csv-faker-generator/issues) for discussions and requests.
 
 ## License
 
@@ -164,6 +356,6 @@ MIT
 
 Contributions are welcome! Please feel free to submit a Pull Request.
 
-## Issues
+## Issues & Support
 
 Found a bug or have a feature request? Please open an issue on [GitHub](https://github.com/yourusername/csv-faker-generator/issues).

package/dist/cli.js

@@ -14,23 +14,30 @@ Options:
   --columns, -c    Column definitions (format: header:type,header:type,...)
   --rows, -r       Number of rows to generate (default: 10)
   --output, -o     Output file path (default: output.csv)
+  --delimiter, -d  Field delimiter (default: ,) [options: , ; | \\t]
   --help, -h       Show this help message
 
 Data Types:
-  uuid, name, firstName, lastName, email, phone, address, city,
-  country, zipCode, company, jobTitle, number, date, boolean,
-  url, ip, username, password
+  uuid, name, firstName, lastName, title, email, phone, address,
+  secondaryAddress, city, country, zipCode, company, jobTitle,
+  number, date, boolean, url, ip, username, password, iban, bic,
+  bankName, alphanumeric, pick
+
+  Note: Advanced features (alphanumeric length, pick values, formula)
+  require programmatic usage. See README for examples.
 
 Examples:
   csv-faker -c id:uuid,name:name,email:email -r 100 -o users.csv
   csv-faker -c userId:uuid,firstName:firstName,lastName:lastName,email:email,address:address -r 50
   csv-faker --columns "id:uuid,company:company,city:city" --rows 20 --output companies.csv
+  csv-faker -c id:uuid,name:name,email:email --delimiter ";" -r 50 -o contacts.csv
 `);
 }
 function parseArgs() {
     let columnsStr = '';
     let rows = 10;
     let output = 'output.csv';
+    let delimiter = ',';
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
         if (arg === '--help' || arg === '-h') {
@@ -50,6 +57,13 @@ function parseArgs() {
         else if (arg === '--output' || arg === '-o') {
             output = args[++i];
         }
+        else if (arg === '--delimiter' || arg === '-d') {
+            delimiter = args[++i];
+            // Handle common escape sequences
+            if (delimiter === '\\t') {
+                delimiter = '\t';
+            }
+        }
     }
     if (!columnsStr) {
         console.error('Error: --columns is required\n');
@@ -57,7 +71,7 @@ function parseArgs() {
         process.exit(1);
     }
     const columns = columnsStr.split(',').map(index_1.parseColumnString);
-    return { columns, rows, output };
+    return { columns, rows, output, delimiter };
 }
 async function main() {
     try {

package/dist/index.d.ts

@@ -1,14 +1,20 @@
-export type DataType = 'uuid' | 'name' | 'firstName' | 'lastName' | 'title' | 'email' | 'phone' | 'address' | 'secondaryAddress' | 'city' | 'country' | 'zipCode' | 'company' | 'jobTitle' | 'number' | 'date' | 'boolean' | 'url' | 'ip' | 'username' | 'password' | 'iban' | 'bic' | 'bankName';
+export type DataType = 'uuid' | 'name' | 'firstName' | 'lastName' | 'title' | 'email' | 'phone' | 'address' | 'secondaryAddress' | 'city' | 'country' | 'zipCode' | 'company' | 'jobTitle' | 'number' | 'date' | 'boolean' | 'url' | 'ip' | 'username' | 'password' | 'iban' | 'bic' | 'bankName' | 'alphanumeric' | 'pick' | 'formula';
 export interface ColumnDefinition {
     header: string;
     type: DataType;
     min?: number;
     max?: number;
+    length?: number;
+    uppercase?: boolean;
+    values?: any[];
+    formula?: (row: Record<string, any>) => any;
+    decimals?: number;
 }
 export interface GenerateOptions {
     columns: ColumnDefinition[];
     rows: number;
     output: string;
+    delimiter?: string;
 }
 export declare function generateCSV(options: GenerateOptions): Promise<void>;
 export declare function parseColumnString(columnStr: string): ColumnDefinition;

package/dist/index.js

@@ -4,7 +4,8 @@ exports.generateCSV = generateCSV;
 exports.parseColumnString = parseColumnString;
 const faker_1 = require("@faker-js/faker");
 const csv_writer_1 = require("csv-writer");
-function generateValue(type, min, max) {
+function generateValue(column, row) {
+    const { type, min, max, length, uppercase, values, decimals } = column;
     switch (type) {
         case 'uuid':
             return faker_1.faker.string.uuid();
@@ -34,8 +35,14 @@ function generateValue(type, min, max) {
             return faker_1.faker.company.name();
         case 'jobTitle':
             return faker_1.faker.person.jobTitle();
-        case 'number':
-            return faker_1.faker.number.int({ min: min || 1, max: max || 1000 });
+        case 'number': {
+            const num = faker_1.faker.number.int({ min: min || 1, max: max || 1000 });
+            if (decimals !== undefined) {
+                const float = faker_1.faker.number.float({ min: min || 1, max: max || 1000, fractionDigits: decimals });
+                return parseFloat(float.toFixed(decimals));
+            }
+            return num;
+        }
         case 'date':
             return faker_1.faker.date.recent().toISOString();
         case 'boolean':
@@ -54,24 +61,54 @@ function generateValue(type, min, max) {
             return faker_1.faker.finance.bic();
         case 'bankName':
             return faker_1.faker.company.name() + ' Bank';
+        case 'alphanumeric': {
+            const len = length || 10;
+            let result = faker_1.faker.string.alphanumeric(len);
+            if (uppercase) {
+                result = result.toUpperCase();
+            }
+            return result;
+        }
+        case 'pick': {
+            if (!values || values.length === 0) {
+                throw new Error('pick type requires values array');
+            }
+            return faker_1.faker.helpers.arrayElement(values);
+        }
+        case 'formula': {
+            if (!column.formula || !row) {
+                throw new Error('formula type requires formula function and row context');
+            }
+            return column.formula(row);
+        }
         default:
             return faker_1.faker.lorem.word();
     }
 }
 async function generateCSV(options) {
-    const { columns, rows, output } = options;
+    const { columns, rows, output, delimiter = ',' } = options;
     const csvWriter = (0, csv_writer_1.createObjectCsvWriter)({
         path: output,
         header: columns.map((col) => ({
             id: col.header,
             title: col.header,
         })),
+        fieldDelimiter: delimiter,
     });
     const records = [];
     for (let i = 0; i < rows; i++) {
         const record = {};
+        // First pass: generate non-formula columns
+        for (const column of columns) {
+            if (column.type !== 'formula') {
+                record[column.header] = generateValue(column, record);
+            }
+        }
+        // Second pass: generate formula columns (they can reference other columns)
         for (const column of columns) {
-            record[column.header] = generateValue(column.type, column.min, column.max);
+            if (column.type === 'formula') {
+                record[column.header] = generateValue(column, record);
+            }
         }
         records.push(record);
     }
@@ -89,7 +126,7 @@ function parseColumnString(columnStr) {
         'uuid', 'name', 'firstName', 'lastName', 'title', 'email', 'phone',
         'address', 'secondaryAddress', 'city', 'country', 'zipCode', 'company', 'jobTitle',
         'number', 'date', 'boolean', 'url', 'ip', 'username', 'password',
-        'iban', 'bic', 'bankName'
+        'iban', 'bic', 'bankName', 'alphanumeric', 'pick'
     ];
     if (!validTypes.includes(type)) {
         throw new Error(`Invalid data type: ${type}. Valid types: ${validTypes.join(', ')}`);

package/dist/test-advanced.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-advanced.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+async function testAdvancedFeatures() {
+    console.log('Testing Advanced Features...\n');
+    // Test 1: Alphanumeric with length and uppercase
+    console.log('Test 1: Alphanumeric type with custom length and uppercase...');
+    await (0, index_1.generateCSV)({
+        columns: [
+            { header: 'product_code', type: 'alphanumeric', length: 10, uppercase: true },
+            { header: 'sku', type: 'alphanumeric', length: 15 },
+            { header: 'name', type: 'name' },
+        ],
+        rows: 5,
+        output: 'test-alphanumeric.csv',
+    });
+    // Test 2: Pick type for enum values
+    console.log('\nTest 2: Pick type for predefined values...');
+    await (0, index_1.generateCSV)({
+        columns: [
+            { header: 'product', type: 'name' },
+            { header: 'tax_rate', type: 'pick', values: [0, 7, 19] },
+            { header: 'status', type: 'pick', values: ['active', 'pending', 'inactive'] },
+            { header: 'unit', type: 'pick', values: ['g', 'kg', 'Stück', 'Meter'] },
+        ],
+        rows: 5,
+        output: 'test-pick.csv',
+    });
+    // Test 3: Formula fields (calculated values)
+    console.log('\nTest 3: Formula type for calculated fields...');
+    await (0, index_1.generateCSV)({
+        columns: [
+            { header: 'product', type: 'company' },
+            { header: 'netto', type: 'number', min: 10, max: 200, decimals: 2 },
+            { header: 'tax', type: 'pick', values: [0, 7, 19] },
+            {
+                header: 'brutto',
+                type: 'formula',
+                formula: (row) => {
+                    const netto = row.netto;
+                    const tax = row.tax;
+                    return parseFloat((netto * (1 + tax / 100)).toFixed(2));
+                },
+            },
+        ],
+        rows: 5,
+        output: 'test-formula.csv',
+    });
+    // Test 4: Custom delimiter (semicolon)
+    console.log('\nTest 4: Custom delimiter (semicolon)...');
+    await (0, index_1.generateCSV)({
+        columns: [
+            { header: 'id', type: 'uuid' },
+            { header: 'name', type: 'name' },
+            { header: 'email', type: 'email' },
+        ],
+        rows: 5,
+        delimiter: ';',
+        output: 'test-semicolon.csv',
+    });
+    // Test 5: Number with decimal precision
+    console.log('\nTest 5: Number type with decimal precision...');
+    await (0, index_1.generateCSV)({
+        columns: [
+            { header: 'price', type: 'number', min: 10, max: 200, decimals: 2 },
+            { header: 'weight', type: 'number', min: 0.1, max: 99.9, decimals: 1 },
+            { header: 'quantity', type: 'number', min: 1, max: 1000, decimals: 0 },
+        ],
+        rows: 5,
+        output: 'test-decimals.csv',
+    });
+    // Test 6: Complete E-commerce Article Example
+    console.log('\nTest 6: Complete e-commerce article example (the dogfooding use case)...');
+    await (0, index_1.generateCSV)({
+        columns: [
+            { header: 'Artikelnummer*', type: 'alphanumeric', length: 15 },
+            { header: 'Bezeichnung*', type: 'company' },
+            { header: 'Beschreibung', type: 'company' },
+            { header: 'Verkaufspreis netto in €', type: 'number', min: 10, max: 200, decimals: 2 },
+            { header: 'Steuersatz', type: 'pick', values: [0, 7, 19] },
+            {
+                header: 'Verkaufspreis brutto in €',
+                type: 'formula',
+                formula: (row) => {
+                    const netto = row['Verkaufspreis netto in €'];
+                    const tax = row['Steuersatz'];
+                    return parseFloat((netto * (1 + tax / 100)).toFixed(2));
+                },
+            },
+            { header: 'Einkaufspreis netto in €', type: 'number', min: 5, max: 100, decimals: 2 },
+            { header: 'Einheit', type: 'pick', values: ['Stück', 'kg', 'g', 'Meter', 'Liter'] },
+            { header: 'Bestand', type: 'number', min: 0, max: 1000, decimals: 0 },
+            { header: 'Kategorie', type: 'pick', values: ['Electronics', 'Food', 'Clothing', 'Books'] },
+        ],
+        rows: 10,
+        output: 'test-articles-complete.csv',
+    });
+    console.log('\n✓ All advanced feature tests completed successfully!');
+    console.log('\nGenerated files:');
+    console.log('  - test-alphanumeric.csv (alphanumeric with length/uppercase)');
+    console.log('  - test-pick.csv (pick from predefined values)');
+    console.log('  - test-formula.csv (calculated fields)');
+    console.log('  - test-semicolon.csv (custom delimiter)');
+    console.log('  - test-decimals.csv (decimal precision)');
+    console.log('  - test-articles-complete.csv (complete e-commerce example)');
+}
+testAdvancedFeatures().catch((error) => {
+    console.error('Error running advanced tests:', error);
+    process.exit(1);
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "csv-faker-generator",
-  "version": "1.0.0",
-  "description": "Generate CSV files with fake data using custom headers (UUID, names, emails, addresses, etc.)",
+  "version": "2.0.0",
+  "description": "Generate CSV files with fake data: 27+ data types, alphanumeric strings, pick from custom values, formula fields, decimal precision, custom delimiters. Perfect for testing and prototyping.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
@@ -27,7 +27,17 @@
     "generator",
     "uuid",
     "csv-generator",
-    "mock-data"
+    "mock-data",
+    "alphanumeric",
+    "formula",
+    "calculated-fields",
+    "enum",
+    "pick",
+    "delimiter",
+    "test-data",
+    "prototyping",
+    "iban",
+    "banking"
   ],
   "author": "Manoj Kengudelu",
   "license": "MIT",