devkits-csv-json 1.0.0

package/README.md

@@ -0,0 +1,147 @@
+# devkits-csv-json
+
+> Convert between CSV and JSON formats
+
+## Installation
+
+```bash
+npm install -g devkits-csv-json
+```
+
+Or use without installation:
+
+```bash
+npx devkits-csv-json [args]
+```
+
+## Usage
+
+```bash
+# CSV to JSON
+dk-csv -j "name,age\nJohn,30\nJane,25"
+
+# JSON to CSV
+dk-csv -c '[{"name":"John","age":30}]'
+
+# From stdin (auto-detects format)
+cat data.csv | dk-csv
+cat data.json | dk-csv
+
+# Custom delimiter
+dk-csv -j "name;age\nJohn;30" -d ";"
+
+# Pretty print JSON
+dk-csv -j "name,age\nJohn,30" --pretty
+```
+
+## Output Examples
+
+### CSV to JSON
+```bash
+$ dk-csv -j "name,age\nJohn,30\nJane,25"
+
+[{"name":"John","age":30},{"name":"Jane","age":25}]
+```
+
+### JSON to CSV
+```bash
+$ dk-csv -c '[{"name":"John","age":30}]'
+
+name,age
+John,30
+```
+
+### Pretty JSON
+```bash
+$ dk-csv -j "name,age\nJohn,30" --pretty
+
+[
+  {
+    "name": "John",
+    "age": 30
+  }
+]
+```
+
+## Why @devkits/csv-json?
+
+- ✅ Fast - Instant conversion
+- ✅ Zero dependencies - Pure Node.js
+- ✅ Offline - Works without internet
+- ✅ Free - Open source (MIT)
+- ✅ CLI - Use in your terminal
+- ✅ Auto-detect from stdin
+- ✅ Custom delimiter support
+
+## Web Version
+
+Prefer a GUI? Check out the web version: **https://devkits-tools.surge.sh/tools/csv-to-json**
+
+- 84 developer tools in one PWA
+- Works offline
+- No signup required
+
+## Pro Features
+
+Upgrade to Pro for advanced features:
+
+- 📦 Batch Processing
+- 🔗 API Access (1000 req/day free)
+- ☁️ Cloud Sync
+- 🎨 Custom Themes
+- 📊 Advanced Analytics
+- 💬 Priority Support
+
+**Price:** $9 one-time payment
+**Upgrade:** https://devkits-tools.surge.sh/pro
+**Discount:** Use code `EARLYBIRD-2026` for 20% off
+
+## See Also
+
+Part of the **[DevKits Tools](https://devkits-tools.surge.sh)** collection — 80+ free developer tools:
+
+### Popular Tools
+
+| Tool | npm Package | Description |
+|------|-------------|-------------|
+| **[Base64](https://devkits-tools.surge.sh/tools/base64)** | `@devkits/base64` | Encode/decode Base64 |
+| **[JSON Formatter](https://devkits-tools.surge.sh/tools/json-formatter)** | `@devkits/json-formatter` | Format and validate JSON |
+| **[Color Converter](https://devkits-tools.surge.sh/tools/color-converter)** | `@devkits/color-converter` | HEX/RGB/HSL conversion |
+| **[UUID Generator](https://devkits-tools.surge.sh/tools/uuid-generator)** | `@devkits/uuid-generator` | Generate unique UUIDs |
+| **[Hash Generator](https://devkits-tools.surge.sh/tools/hash-generator)** | `@devkits/hash-generator` | MD5, SHA1, SHA256, SHA512 |
+| **[Regex Tester](https://devkits-tools.surge.sh/tools/regex-tester)** | `@devkits/regex-tester` | Test regex patterns |
+
+### Other DevKits Tools
+
+- **[HTML Tools](https://devkits-tools.surge.sh/tools/html-entities)** — HTML entity encode/decode
+- **[CSS Tools](https://devkits-tools.surge.sh/tools/css-minifier)** — CSS minify/format
+- **[Cron Parser](https://devkits-tools.surge.sh/tools/cron-parser)** — Parse cron expressions
+- **[Case Convert](https://devkits-tools.surge.sh/tools/text-case)** — camelCase, snake_case, etc.
+- **[Slugify](https://devkits-tools.surge.sh/tools/slug-generator)** — Create URL-friendly slugs
+- **[Lorem Ipsum](https://devkits-tools.surge.sh/tools/lorem-ipsum)** — Generate placeholder text
+- **[Password Generator](https://devkits-tools.surge.sh/tools/password-generator)** — Secure passwords
+- **[Text Counter](https://devkits-tools.surge.sh/tools/text-counter)** — Word/char counter
+
+---
+
+### More from DevKits
+
+- **[Invoicely](https://invoicely-app.surge.sh)** — Free invoice generator for freelancers
+- **[SnapOG](https://snapog.surge.sh)** — Free OG image generator with 20+ templates
+- **[API Monitor](https://api-monitor-saas.surge.sh)** — Real-time API monitoring
+
+---
+
+👉 **Explore all 80+ developer tools at [DevKits Tools](https://devkits-tools.surge.sh)**
+
+## License
+
+MIT © [DevKits Team](https://devkits-tools.surge.sh)
+
+---
+
+## 🚀 API Monitoring for Developers
+
+Build better APIs with **API Monitor SaaS** — real-time monitoring, alerting, and analytics.
+
+👉 **Early Access: $1 pre-order (50% off for life)** → https://api-monitor-saas.surge.sh?utm_source=npm&utm_medium=readme&utm_campaign=phase0

package/index.js

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+
+/**
+ * @devkits/csv-json - Convert between CSV and JSON formats
+ *
+ * Usage:
+ *   dk-csv -j 'name,age\nJohn,30'     # CSV to JSON
+ *   dk-csv -c '[{"name":"John"}]'     # JSON to CSV
+ *   cat file.csv | dk-csv -j          # File conversion
+ *
+ * Web version: https://devkits-tools.surge.sh/tools/csv-to-json
+ * Pro features: https://devkits-tools.surge.sh/pro
+ */
+
+// Parse CSV to array of objects
+function csvToJson(csv, options = {}) {
+  const { delimiter = ',', header = true } = options;
+  const lines = csv.trim().split('\n');
+
+  if (lines.length === 0) return [];
+
+  const parseLine = (line) => {
+    const result = [];
+    let current = '';
+    let inQuotes = false;
+
+    for (let i = 0; i < line.length; i++) {
+      const char = line[i];
+
+      if (char === '"') {
+        inQuotes = !inQuotes;
+      } else if (char === delimiter && !inQuotes) {
+        result.push(current.trim());
+        current = '';
+      } else {
+        current += char;
+      }
+    }
+    result.push(current.trim());
+    return result;
+  };
+
+  const headers = parseLine(lines[0]);
+  const data = [];
+
+  for (let i = header ? 1 : 0; i < lines.length; i++) {
+    const values = parseLine(lines[i]);
+    if (header) {
+      const obj = {};
+      headers.forEach((h, idx) => {
+        let value = values[idx] || '';
+        // Try to parse numbers
+        if (/^-?\d+$/.test(value)) {
+          value = parseInt(value, 10);
+        } else if (/^-?\d+\.\d+$/.test(value)) {
+          value = parseFloat(value);
+        } else if (value.toLowerCase() === 'true') {
+          value = true;
+        } else if (value.toLowerCase() === 'false') {
+          value = false;
+        }
+        obj[h] = value;
+      });
+      data.push(obj);
+    } else {
+      data.push(values);
+    }
+  }
+
+  return header ? data : { headers, data };
+}
+
+// Convert JSON array to CSV
+function jsonToCsv(data, options = {}) {
+  const { delimiter = ',', includeHeader = true } = options;
+
+  if (!Array.isArray(data) || data.length === 0) {
+    return '';
+  }
+
+  const headers = Object.keys(data[0]);
+  const lines = [];
+
+  if (includeHeader) {
+    lines.push(headers.join(delimiter));
+  }
+
+  for (const row of data) {
+    const values = headers.map(h => {
+      const value = row[h];
+      if (typeof value === 'string' && (value.includes(delimiter) || value.includes('"') || value.includes('\n'))) {
+        return `"${value.replace(/"/g, '""')}"`;
+      }
+      return value;
+    });
+    lines.push(values.join(delimiter));
+  }
+
+  return lines.join('\n');
+}
+
+function showHelp() {
+  console.log(`
+@devkits/csv-json - Convert between CSV and JSON
+
+Usage:
+  dk-csv -j 'name,age\\nJohn,30'       # CSV to JSON
+  dk-csv -c '[{"name":"John"}]'        # JSON to CSV
+  cat file.csv | dk-csv -j             # CSV file to JSON
+  cat file.json | dk-csv -c            # JSON file to CSV
+
+Options:
+  -j, --to-json <csv>     Convert CSV string to JSON
+  -c, --to-csv <json>     Convert JSON string to CSV
+  -d, --delimiter <char>  CSV delimiter (default: ,)
+  -p, --pretty            Pretty print JSON output
+  -n, --no-header         CSV has no header row
+  -h, --help              Show this help message
+
+Examples:
+  dk-csv -j "name,age\\nJohn,30\\nJane,25"
+  dk-csv -c '[{"name":"John","age":30}]'
+  cat data.csv | dk-csv -j
+  cat data.json | dk-csv -c --pretty
+
+Web version: https://devkits-tools.surge.sh/tools/csv-to-json
+Pro features: https://devkits-tools.surge.sh/pro
+`);
+}
+
+// Main entry point
+const args = process.argv.slice(2);
+
+if (!args.length || args.includes('-h') || args.includes('--help')) {
+  showHelp();
+  process.exit(0);
+}
+
+// Parse options
+let toJson = null;
+let toCsv = null;
+let delimiter = ',';
+let pretty = false;
+let noHeader = false;
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === '-j' || args[i] === '--to-json') {
+    toJson = args[++i];
+  } else if (args[i] === '-c' || args[i] === '--to-csv') {
+    toCsv = args[++i];
+  } else if (args[i] === '-d' || args[i] === '--delimiter') {
+    delimiter = args[++i];
+  } else if (args[i] === '-p' || args[i] === '--pretty') {
+    pretty = true;
+  } else if (args[i] === '-n' || args[i] === '--no-header') {
+    noHeader = true;
+  }
+}
+
+// Process input
+const processInput = (input, isCsv) => {
+  try {
+    if (isCsv) {
+      // CSV to JSON - handle escaped newlines
+      const csv = input.replace(/\\n/g, '\n');
+      const result = csvToJson(csv, { delimiter, header: !noHeader });
+      console.log(pretty ? JSON.stringify(result, null, 2) : JSON.stringify(result));
+    } else {
+      // JSON to CSV
+      const data = JSON.parse(input);
+      console.log(jsonToCsv(data, { delimiter, includeHeader: !noHeader }));
+    }
+  } catch (err) {
+    console.error(`Error: ${err.message}`);
+    process.exit(1);
+  }
+};
+
+if (toJson !== null) {
+  processInput(toJson, true);
+} else if (toCsv !== null) {
+  processInput(toCsv, false);
+} else if (!process.stdin.isTTY) {
+  let stdin = '';
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('readable', () => {
+    let chunk;
+    while ((chunk = process.stdin.read()) !== null) {
+      stdin += chunk;
+    }
+  });
+  process.stdin.on('end', () => {
+    if (stdin.trim()) {
+      // Auto-detect format
+      const trimmed = stdin.trim();
+      const isCsv = !trimmed.startsWith('[') && !trimmed.startsWith('{');
+      processInput(stdin, isCsv);
+    } else {
+      showHelp();
+    }
+  });
+} else {
+  console.error('Error: Please provide input with -j or -c flag, or pipe from stdin');
+  showHelp();
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "devkits-csv-json",
+  "version": "1.0.0",
+  "description": "Convert between CSV and JSON formats",
+  "main": "index.js",
+  "bin": {
+    "dk-csv": "./index.js",
+    "csv-json": "./index.js"
+  },
+  "scripts": {
+    "test": "node test.js"
+  },
+  "keywords": [
+    "csv",
+    "json",
+    "convert",
+    "parser",
+    "devkits",
+    "developer-tools",
+    "cli",
+    "command-line",
+    "nodejs",
+    "utility",
+    "productivity",
+    "dev-tools",
+    "free-tools"
+  ],
+  "author": "DevKits Team <devkits-auto@protonmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/devkits/tools"
+  },
+  "homepage": "https://devkits-tools.surge.sh/tools/csv-to-json",
+  "bugs": {
+    "url": "https://github.com/devkits/tools/issues"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "test.js"
+  ],
+  "dependencies": {}
+}

package/test.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+
+/**
+ * Tests for @devkits/csv-json
+ */
+
+const { execSync } = require('child_process');
+
+const tests = [
+  {
+    name: 'CSV to JSON',
+    cmd: 'node index.js -j "name,age\\nJohn,30"',
+    check: (result) => {
+      const data = JSON.parse(result);
+      return Array.isArray(data) && data[0].name === 'John' && data[0].age === 30;
+    }
+  },
+  {
+    name: 'JSON to CSV',
+    cmd: 'node index.js -c \'[{"name":"John","age":30}]\'',
+    check: (result) => result.includes('name,age') && result.includes('John,30')
+  },
+  {
+    name: 'CSV with multiple rows',
+    cmd: 'node index.js -j "name,age\\nJohn,30\\nJane,25"',
+    check: (result) => {
+      const data = JSON.parse(result);
+      return data.length === 2 && data[1].name === 'Jane';
+    }
+  },
+  {
+    name: 'Pretty JSON output',
+    cmd: 'node index.js -j "name,age\\nJohn,30" --pretty',
+    check: (result) => result.includes('{\n') || result.split('\n').length > 1
+  },
+  {
+    name: 'Custom delimiter',
+    cmd: 'node index.js -j "name;age\\nJohn;30" -d ";"',
+    check: (result) => {
+      const data = JSON.parse(result);
+      return data[0].name === 'John';
+    }
+  },
+];
+
+let passed = 0;
+let failed = 0;
+
+console.log('Running @devkits/csv-json tests...\n');
+
+for (const test of tests) {
+  try {
+    const result = execSync(test.cmd, { encoding: 'utf8' }).trim();
+    if (test.check(result)) {
+      console.log(`✅ ${test.name}`);
+      passed++;
+    } else {
+      console.log(`❌ ${test.name}`);
+      console.log(`   Got: ${result}`);
+      failed++;
+    }
+  } catch (err) {
+    console.log(`❌ ${test.name} - Error: ${err.message}`);
+    failed++;
+  }
+}
+
+console.log(`\n${passed}/${tests.length} tests passed`);
+process.exit(failed > 0 ? 1 : 0);