jtcsv 2.1.1 → 2.1.3

package/README.md

@@ -4,15 +4,16 @@
 
 [![npm version](https://img.shields.io/npm/v/jtcsvps://www.npmjs.com/package/jtcsv)jtcsv
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Zero Dependencies](https://img.shields.io/badge/dependencies-zero-brightgreen.svg)](https://www.npmjs.com/package/jtcsv
+[![Zero-Deps Core](https://img.shields.io/badge/core-zero%20deps-brightgreen.svg)](https://www.npmjs.com/package/jtcsv
 
 A lightweight, efficient, and secure library for converting between JSON and CSV formats with full browser support, Web Workers for large files, and streaming capabilities.
+Zero-deps core with optional add-ons (TUI, Excel) for advanced workflows.
 
 ## ✨ Features
 
 ### 🚀 Core Features
 - **Bidirectional Conversion**: JSON ↔ CSV with full type preservation
-- **Zero Dependencies**: Pure JavaScript/TypeScript, no external dependencies
+- **Zero-Deps Core**: Pure JavaScript/TypeScript core with optional add-ons
 - **TypeScript Support**: Full type definitions included
 - **Security First**: Built-in CSV injection protection
 - **RFC 4180 Compliant**: Proper CSV formatting and escaping
@@ -37,6 +38,14 @@ A lightweight, efficient, and secure library for converting between JSON and CSV
 - **Multiple Formats**: CSV, TSV, Excel-compatible output
 - **Error Handling**: Comprehensive error reporting and recovery
 
+### 🔌 Framework Integrations (Optional)
+- **NestJS**: `@jtcsv/nestjs`
+- **Remix**: `@jtcsv/remix`
+- **Nuxt**: `@jtcsv/nuxt`
+- **SvelteKit**: `@jtcsv/sveltekit`
+- **Hono**: `@jtcsv/hono`
+- **tRPC**: `@jtcsv/trpc`
+
 ## 📦 Installation
 
 ### Node.js
@@ -44,6 +53,15 @@ A lightweight, efficient, and secure library for converting between JSON and CSV
 npm install jtcsv
 ```
 
+### Optional add-ons
+```bash
+# Terminal UI
+npm install @jtcsv/tui
+
+# Excel plugin
+npm install @jtcsv/excel exceljs
+```
+
 ### Browser (CDN)
 ```html
 <!-- UMD version (global jtcsv variable) -->

package/bin/jtcsv.js

@@ -47,7 +47,7 @@ ${color('MAIN COMMANDS:', 'bright')}
   ${color('stream', 'yellow')}         Streaming conversion for large files
   ${color('batch', 'yellow')}          Batch process multiple files
   ${color('preprocess', 'magenta')}    Preprocess JSON with deep unwrapping
-  ${color('tui', 'magenta')}           Launch Terminal User Interface
+  ${color('tui', 'magenta')}           Launch Terminal User Interface (@jtcsv/tui)
   ${color('help', 'blue')}             Show this help message
   ${color('version', 'blue')}          Show version information
 
@@ -1038,34 +1038,17 @@ function parseOptions(args) {
 
 async function launchTUI() {
   try {
-    // Check if blessed is installed
-    require.resolve('blessed');
-    
     console.log(color('Launching Terminal User Interface...', 'cyan'));
     console.log(color('Press Ctrl+Q to exit', 'dim'));
-    
-    // Check if TUI file exists and has content
-    const tuiPath = path.join(__dirname, '../cli-tui.js');
-    const stats = await fs.promises.stat(tuiPath);
-    
-    if (stats.size < 100) {
-      console.log(color('⚠️  TUI interface is not fully implemented yet', 'yellow'));
-      console.log(color('   Basic TUI will be started...', 'dim'));
-      
-      // Start basic TUI
-      await startBasicTUI();
-    } else {
-      // Import and launch full TUI
-      const JtcsvTUI = require('../cli-tui.js');
-      const tui = new JtcsvTUI();
-      tui.start();
-    }
-    
+
+    const JtcsvTUI = require('@jtcsv/tui');
+    const tui = new JtcsvTUI();
+    tui.start();
   } catch (error) {
     if (error.code === 'MODULE_NOT_FOUND') {
-      console.error(color('Error: blessed is required for TUI interface', 'red'));
+      console.error(color('Error: @jtcsv/tui is not installed', 'red'));
       console.log(color('Install it with:', 'dim'));
-      console.log(color('  npm install blessed blessed-contrib', 'cyan'));
+      console.log(color('  npm install @jtcsv/tui', 'cyan'));
       console.log(color('\nOr use the CLI interface instead:', 'dim'));
       console.log(color('  jtcsv help', 'cyan'));
     } else {

package/examples/simple-usage.js

@@ -238,8 +238,8 @@ try {
   console.log('  examples/plugin-excel-exporter.js');
 } catch (error) {
   console.log('⚠️  Полная интеграция требует дополнительных зависимостей');
-  console.log('Установите exceljs для демонстрации Excel плагина:');
-  console.log('  npm install exceljs --save-optional');
+  console.log('Установите @jtcsv/excel и exceljs для демонстрации Excel плагина:');
+  console.log('  npm install @jtcsv/excel exceljs');
 }
 
 // ============================================================================
@@ -277,4 +277,3 @@ console.log('✨  JTCSV 2.1.0 - Next Generation JSON/CSV Converter  ✨');
 console.log('✨'.repeat(30));
 
 
-

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jtcsv",
-  "version": "2.1.1",
-  "description": "Complete JSON↔CSV and CSV↔JSON converter for Node.js and Browser with streaming, security, Web Workers, TypeScript support, and Plugin System - Zero dependencies",
+  "version": "2.1.3",
+  "description": "Complete JSON<->CSV and CSV<->JSON converter for Node.js and Browser with streaming, security, Web Workers, TypeScript support, and optional ecosystem (zero-deps core)",
   "main": "index.js",
   "browser": "dist/jtcsv.umd.js",
   "module": "dist/jtcsv.esm.js",
@@ -46,6 +46,36 @@
       "require": "./plugins/nextjs-api/route.js",
       "import": "./plugins/nextjs-api/route.js",
       "default": "./plugins/nextjs-api/route.js"
+    },
+    "./nestjs": {
+      "require": "./plugins/nestjs/index.js",
+      "import": "./plugins/nestjs/index.js",
+      "default": "./plugins/nestjs/index.js"
+    },
+    "./remix": {
+      "require": "./plugins/remix/index.js",
+      "import": "./plugins/remix/index.js",
+      "default": "./plugins/remix/index.js"
+    },
+    "./nuxt": {
+      "require": "./plugins/nuxt/index.js",
+      "import": "./plugins/nuxt/index.js",
+      "default": "./plugins/nuxt/index.js"
+    },
+    "./sveltekit": {
+      "require": "./plugins/sveltekit/index.js",
+      "import": "./plugins/sveltekit/index.js",
+      "default": "./plugins/sveltekit/index.js"
+    },
+    "./hono": {
+      "require": "./plugins/hono/index.js",
+      "import": "./plugins/hono/index.js",
+      "default": "./plugins/hono/index.js"
+    },
+    "./trpc": {
+      "require": "./plugins/trpc/index.js",
+      "import": "./plugins/trpc/index.js",
+      "default": "./plugins/trpc/index.js"
     }
   },
   "scripts": {
@@ -65,7 +95,7 @@
     "lint:plugins": "eslint plugins/",
     "security-check": "npm audit",
     "prepublishOnly": "npm test && npm run build && eslint index.js json-to-csv.js csv-to-json.js errors.js stream-json-to-csv.js stream-csv-to-json.js json-save.js src/browser src/engines src/formats src/core",
-    "tui": "node cli-tui.js",
+    "tui": "node packages/jtcsv-tui/bin/jtcsv-tui.js",
     "cli": "node bin/jtcsv.js",
     "build": "rollup -c rollup.config.mjs",
     "build:watch": "rollup -c rollup.config.mjs -w",
@@ -156,7 +186,6 @@
     "json-save.js",
     "index.d.ts",
     "bin/",
-    "cli-tui.js",
     "dist/",
     "src/",
     "examples/",
@@ -175,14 +204,6 @@
     "rollup": "^4.0.0",
     "size-limit": "12.0.0"
   },
-  "optionalDependencies": {
-    "blessed": "^0.1.81",
-    "blessed-contrib": "4.11.0",
-    "exceljs": "^4.4.0"
-  },
-  "overrides": {
-    "xml2js": "0.6.2"
-  },
   "type": "commonjs",
   "size-limit": [
     {
@@ -204,10 +225,5 @@
     "defaults",
     "not IE 11",
     "maintained node versions"
-  ],
-  "dependencies": {
-    "csv-parser": "3.2.0",
-    "json2csv": "6.0.0-alpha.2",
-    "papaparse": "5.5.3"
-  }
+  ]
 }

package/plugins/README.md

@@ -78,6 +78,152 @@ export default function Converter() {
 
 [📚 Документация](./nextjs-api/README.md)
 
+### 4. NestJS Integration (@jtcsv/nestjs)
+
+**NestJS interceptors and decorators for CSV upload/download.**
+
+```bash
+npm install @jtcsv/nestjs jtcsv
+```
+
+```typescript
+import { CsvParserInterceptor, CsvDownloadDecorator } from 'jtcsv/nestjs';
+
+@Controller('data')
+export class DataController {
+  @Post('upload')
+  @CsvParserInterceptor({ delimiter: ',' })
+  uploadCsv(@Body() jsonData: any[]) {
+    return { parsed: jsonData };
+  }
+
+  @Get('export')
+  @CsvDownloadDecorator({ filename: 'export.csv' })
+  exportData() {
+    return [{ id: 1, name: 'John' }];
+  }
+}
+```
+
+[📚 Документация](./nestjs/README.md)
+
+### 5. Remix Integration (@jtcsv/remix)
+
+**Helpers for form-data parsing and CSV downloads in Remix.**
+
+```bash
+npm install @jtcsv/remix jtcsv
+```
+
+```typescript
+import { parseFormData, generateCsvResponse } from 'jtcsv/remix';
+
+export async function action({ request }) {
+  const rows = await parseFormData(request, { delimiter: ',' });
+  return { parsed: rows };
+}
+
+export async function loader() {
+  return generateCsvResponse([{ id: 1, name: 'John' }], 'export.csv');
+}
+```
+
+[📚 Документация](./remix/README.md)
+
+### 6. Nuxt Integration (@jtcsv/nuxt)
+
+**Nuxt module with auto-imported composable.**
+
+```bash
+npm install @jtcsv/nuxt jtcsv
+```
+
+```typescript
+export default defineNuxtConfig({
+  modules: ['@jtcsv/nuxt'],
+  jtcsv: { autoimport: true }
+});
+```
+
+```vue
+<script setup>
+const { csvToJson, jsonToCsv } = useJtcsv();
+</script>
+```
+
+[📚 Документация](./nuxt/README.md)
+
+### 7. SvelteKit Integration (@jtcsv/sveltekit)
+
+**Request helpers for SvelteKit actions/endpoints.**
+
+```bash
+npm install @jtcsv/sveltekit jtcsv
+```
+
+```typescript
+import { parseCsv, generateCsv } from 'jtcsv/sveltekit';
+
+export const actions = {
+  upload: async ({ request }) => {
+    const rows = await parseCsv(request, { delimiter: ',' });
+    return { rows };
+  }
+};
+
+export async function GET() {
+  return generateCsv([{ id: 1 }], 'export.csv');
+}
+```
+
+[📚 Документация](./sveltekit/README.md)
+
+### 8. Hono Integration (@jtcsv/hono)
+
+**Minimal middleware for CSV parsing with Hono.**
+
+```bash
+npm install @jtcsv/hono jtcsv
+```
+
+```typescript
+import { Hono } from 'hono';
+import { csvMiddleware, createCsvResponse } from 'jtcsv/hono';
+
+const app = new Hono()
+  .use('/upload', csvMiddleware())
+  .post('/upload', (c) => c.json({ rows: c.get('csv') }))
+  .get('/export', (c) => {
+    const { csv, headers } = createCsvResponse([{ id: 1 }], 'export.csv');
+    return c.text(csv, 200, headers);
+  });
+```
+
+[📚 Документация](./hono/README.md)
+
+### 9. tRPC Integration (@jtcsv/trpc)
+
+**Middleware helper for CSV input parsing in tRPC procedures.**
+
+```bash
+npm install @jtcsv/trpc jtcsv
+```
+
+```typescript
+import { initTRPC } from '@trpc/server';
+import { z } from 'zod';
+import { createCsvProcedure } from 'jtcsv/trpc';
+
+const t = initTRPC.create();
+
+export const router = t.router({
+  parseCsv: createCsvProcedure(t, z.string())
+    .mutation(async ({ input }) => ({ parsed: input }))
+});
+```
+
+[📚 Документация](./trpc/README.md)
+
 ## 🎯 Особенности
 
 ### Единый API
@@ -369,5 +515,3 @@ node api-convert.js
 ---
 
 **JTCSV Плагины** - делаем работу с CSV/JSON проще в любом фреймворке! 🚀
-
-

package/plugins/hono/README.md

@@ -0,0 +1,25 @@
+# @jtcsv/hono
+
+Hono middleware for JTCSV.
+
+## Install
+```bash
+npm install @jtcsv/hono jtcsv
+```
+
+## Usage
+```typescript
+import { Hono } from 'hono';
+import { csvMiddleware, createCsvResponse } from 'jtcsv/hono';
+
+const app = new Hono()
+  .use('/upload', csvMiddleware({ delimiter: ',' }))
+  .post('/upload', (c) => {
+    const rows = c.get('csv');
+    return c.json({ rows });
+  })
+  .get('/export', (c) => {
+    const { csv, headers } = createCsvResponse([{ id: 1 }], 'export.csv');
+    return c.text(csv, 200, headers);
+  });
+```

package/plugins/hono/index.d.ts

@@ -0,0 +1,12 @@
+import type { CsvToJsonOptions, JsonToCsvOptions } from 'jtcsv';
+import type { Context } from 'hono';
+
+export function csvMiddleware(
+  options?: CsvToJsonOptions
+): (c: Context, next: () => Promise<void>) => Promise<void>;
+
+export function createCsvResponse(
+  data: unknown[] | Record<string, unknown>,
+  filename?: string,
+  options?: JsonToCsvOptions
+): { csv: string; headers: Record<string, string> };

package/plugins/hono/index.js

@@ -0,0 +1,36 @@
+const jtcsv = require('jtcsv');
+
+function normalizeFilename(filename) {
+  if (!filename || typeof filename !== 'string') {
+    return 'export.csv';
+  }
+  return filename.includes('.') ? filename : `${filename}.csv`;
+}
+
+function csvMiddleware(options = {}) {
+  return async (c, next) => {
+    const csvText = await c.req.text();
+    const rows = jtcsv.csvToJson(csvText, options);
+    c.set('csv', rows);
+    await next();
+  };
+}
+
+function createCsvResponse(data, filename = 'export.csv', options = {}) {
+  const safeName = normalizeFilename(filename);
+  const rows = Array.isArray(data) ? data : [data];
+  const csv = jtcsv.jsonToCsv(rows, options);
+
+  return {
+    csv,
+    headers: {
+      'Content-Type': 'text/csv; charset=utf-8',
+      'Content-Disposition': `attachment; filename="${safeName}"`
+    }
+  };
+}
+
+module.exports = {
+  csvMiddleware,
+  createCsvResponse
+};

package/plugins/hono/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@jtcsv/hono",
+  "version": "1.0.0",
+  "description": "Hono middleware for JTCSV",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "keywords": [
+    "hono",
+    "csv",
+    "json",
+    "converter",
+    "jtcsv",
+    "middleware"
+  ],
+  "author": "Ruslan Fomenko",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Linol-Hamelton/jtcsv.git",
+    "directory": "plugins/hono"
+  },
+  "bugs": {
+    "url": "https://github.com/Linol-Hamelton/jtcsv/issues"
+  },
+  "homepage": "https://github.com/Linol-Hamelton/jtcsv/tree/main/plugins/hono#readme",
+  "peerDependencies": {
+    "hono": "^4.0.0",
+    "jtcsv": "^2.1.3"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "README.md"
+  ]
+}

package/plugins/nestjs/README.md

@@ -0,0 +1,33 @@
+# @jtcsv/nestjs
+
+NestJS interceptors and decorators for JTCSV.
+
+## Install
+```bash
+npm install @jtcsv/nestjs jtcsv
+```
+
+## Usage
+```typescript
+import { CsvParserInterceptor, CsvDownloadDecorator } from 'jtcsv/nestjs';
+import { Body, Controller, Get, Post } from '@nestjs/common';
+
+@Controller('data')
+export class DataController {
+  @Post('upload')
+  @CsvParserInterceptor({ delimiter: ',' })
+  uploadCsv(@Body() jsonData: any[]) {
+    return { parsed: jsonData };
+  }
+
+  @Get('export')
+  @CsvDownloadDecorator({ filename: 'export.csv' })
+  exportData() {
+    return [{ id: 1, name: 'John' }];
+  }
+}
+```
+
+## Notes
+- `CsvParserInterceptor` expects CSV text in the request body.
+- `CsvDownloadDecorator` converts the handler result to CSV and sets download headers.

package/plugins/nestjs/index.d.ts

@@ -0,0 +1,25 @@
+import type { Type } from '@nestjs/common';
+import type { NestInterceptor } from '@nestjs/common';
+import type { CsvToJsonOptions, JsonToCsvOptions } from 'jtcsv';
+
+export interface CsvParserOptions extends CsvToJsonOptions {}
+
+export interface CsvDownloadOptions extends JsonToCsvOptions {
+  filename?: string;
+}
+
+export function createCsvParserInterceptor(
+  options?: CsvParserOptions
+): Type<NestInterceptor>;
+
+export function createCsvDownloadInterceptor(
+  options?: CsvDownloadOptions
+): Type<NestInterceptor>;
+
+export function CsvParserInterceptor(
+  options?: CsvParserOptions
+): MethodDecorator & ClassDecorator;
+
+export function CsvDownloadDecorator(
+  options?: CsvDownloadOptions
+): MethodDecorator & ClassDecorator;

package/plugins/nestjs/index.js

@@ -0,0 +1,77 @@
+const { Injectable, UseInterceptors } = require('@nestjs/common');
+const { map } = require('rxjs/operators');
+const jtcsv = require('jtcsv');
+
+function normalizeFilename(filename) {
+  if (!filename || typeof filename !== 'string') {
+    return 'export.csv';
+  }
+  return filename.includes('.') ? filename : `${filename}.csv`;
+}
+
+function createCsvParserInterceptor(options = {}) {
+  class CsvParserInterceptorImpl {
+    intercept(context, next) {
+      const req = context.switchToHttp().getRequest();
+      const body = req && req.body;
+
+      if (typeof body === 'string' || Buffer.isBuffer(body)) {
+        const csv = Buffer.isBuffer(body) ? body.toString('utf8') : body;
+        req.body = jtcsv.csvToJson(csv, options);
+      }
+
+      return next.handle();
+    }
+  }
+
+  Injectable()(CsvParserInterceptorImpl);
+  return CsvParserInterceptorImpl;
+}
+
+function createCsvDownloadInterceptor(options = {}) {
+  class CsvDownloadInterceptorImpl {
+    intercept(context, next) {
+      const res = context.switchToHttp().getResponse();
+      const filename = normalizeFilename(options.filename);
+      const csvOptions = { ...options };
+      delete csvOptions.filename;
+
+      return next.handle().pipe(
+        map(data => {
+          const rows = Array.isArray(data) ? data : [data];
+          const csv = jtcsv.jsonToCsv(rows, csvOptions);
+
+          if (res && typeof res.setHeader === 'function') {
+            res.setHeader('Content-Type', 'text/csv; charset=utf-8');
+            res.setHeader(
+              'Content-Disposition',
+              `attachment; filename="${filename}"`
+            );
+          }
+
+          return csv;
+        })
+      );
+    }
+  }
+
+  Injectable()(CsvDownloadInterceptorImpl);
+  return CsvDownloadInterceptorImpl;
+}
+
+function CsvParserInterceptor(options = {}) {
+  const Interceptor = createCsvParserInterceptor(options);
+  return UseInterceptors(new Interceptor());
+}
+
+function CsvDownloadDecorator(options = {}) {
+  const Interceptor = createCsvDownloadInterceptor(options);
+  return UseInterceptors(new Interceptor());
+}
+
+module.exports = {
+  CsvParserInterceptor,
+  CsvDownloadDecorator,
+  createCsvParserInterceptor,
+  createCsvDownloadInterceptor
+};

package/plugins/nestjs/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@jtcsv/nestjs",
+  "version": "1.0.0",
+  "description": "NestJS interceptors and decorators for JTCSV",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "keywords": [
+    "nestjs",
+    "csv",
+    "json",
+    "converter",
+    "jtcsv",
+    "interceptor",
+    "decorator"
+  ],
+  "author": "Ruslan Fomenko",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Linol-Hamelton/jtcsv.git",
+    "directory": "plugins/nestjs"
+  },
+  "bugs": {
+    "url": "https://github.com/Linol-Hamelton/jtcsv/issues"
+  },
+  "homepage": "https://github.com/Linol-Hamelton/jtcsv/tree/main/plugins/nestjs#readme",
+  "peerDependencies": {
+    "@nestjs/common": "^9.0.0 || ^10.0.0",
+    "jtcsv": "^2.1.3",
+    "rxjs": "^7.0.0"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "README.md"
+  ]
+}

package/plugins/nuxt/README.md

@@ -0,0 +1,25 @@
+# @jtcsv/nuxt
+
+Nuxt module for JTCSV.
+
+## Install
+```bash
+npm install @jtcsv/nuxt jtcsv
+```
+
+## Setup
+```typescript
+export default defineNuxtConfig({
+  modules: ['@jtcsv/nuxt'],
+  jtcsv: {
+    autoimport: true
+  }
+});
+```
+
+## Usage
+```vue
+<script setup>
+const { csvToJson, jsonToCsv } = useJtcsv();
+</script>
+```