jtcsv 2.1.0 → 2.1.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jtcsv",
-  "version": "2.1.0",
-  "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",
@@ -9,7 +9,7 @@
   "bin": {
     "jtcsv": "bin/jtcsv.js"
   },
-    "exports": {
+  "exports": {
     ".": {
       "require": "./index.js",
       "import": "./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": {
@@ -56,7 +86,7 @@
     "test:plugins": "jest __tests__/plugin-system.test.js",
     "test:fastpath": "jest __tests__/fast-path-engine.test.js",
     "test:ndjson": "jest __tests__/ndjson-parser.test.js",
-        "test:performance": "jest __tests__/*.test.js --testNamePattern=\"Производительность|производительность\"",
+    "test:performance": "jest __tests__/*.test.js --testNamePattern=\"Производительность|производительность\"",
     "test:express": "cd plugins/express-middleware && npm test",
     "test:fastify": "cd plugins/fastify-plugin && npm test",
     "test:nextjs": "cd plugins/nextjs-api && npm test",
@@ -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",
@@ -118,7 +148,7 @@
     "gui",
     "tool",
     "utility",
-        "plugin-system",
+    "plugin-system",
     "ndjson",
     "fast-path",
     "optimization",
@@ -155,8 +185,7 @@
     "stream-csv-to-json.js",
     "json-save.js",
     "index.d.ts",
-        "bin/",
-    "cli-tui.js",
+    "bin/",
     "dist/",
     "src/",
     "examples/",
@@ -169,25 +198,27 @@
     "@rollup/plugin-commonjs": "^25.0.0",
     "@rollup/plugin-node-resolve": "^15.0.0",
     "@rollup/plugin-terser": "^0.4.0",
+    "@size-limit/preset-small-lib": "12.0.0",
     "eslint": "8.57.1",
     "jest": "^29.0.0",
     "rollup": "^4.0.0",
-    "size-limit": "^8.0.0"
-  },
-  "optionalDependencies": {
-    "blessed": "^0.1.81",
-    "blessed-contrib": "^4.11.0",
-    "exceljs": "^4.4.0"
+    "size-limit": "12.0.0"
   },
   "type": "commonjs",
   "size-limit": [
     {
       "path": "dist/jtcsv.umd.js",
-      "limit": "35 KB"
+      "limit": "60 KB",
+      "ignore": [
+        "url"
+      ]
     },
     {
       "path": "dist/jtcsv.esm.js",
-      "limit": "30 KB"
+      "limit": "55 KB",
+      "ignore": [
+        "url"
+      ]
     }
   ],
   "browserslist": [
@@ -196,6 +227,3 @@
     "maintained node versions"
   ]
 }
-
-
-

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>
+```

package/plugins/nuxt/index.js

@@ -0,0 +1,21 @@
+const { defineNuxtModule, addPlugin, addImports, createResolver } = require('@nuxt/kit');
+
+module.exports = defineNuxtModule({
+  meta: {
+    name: '@jtcsv/nuxt',
+    configKey: 'jtcsv'
+  },
+  defaults: {
+    autoimport: true
+  },
+  setup(options) {
+    const resolver = createResolver(__dirname);
+    addPlugin(resolver.resolve('runtime/plugin'));
+
+    if (options.autoimport !== false) {
+      addImports([
+        { name: 'useJtcsv', from: resolver.resolve('runtime/composables/useJtcsv') }
+      ]);
+    }
+  }
+});

package/plugins/nuxt/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@jtcsv/nuxt",
+  "version": "1.0.0",
+  "description": "Nuxt module for JTCSV (auto-imported composable)",
+  "main": "index.js",
+  "keywords": [
+    "nuxt",
+    "module",
+    "csv",
+    "json",
+    "converter",
+    "jtcsv"
+  ],
+  "author": "Ruslan Fomenko",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Linol-Hamelton/jtcsv.git",
+    "directory": "plugins/nuxt"
+  },
+  "bugs": {
+    "url": "https://github.com/Linol-Hamelton/jtcsv/issues"
+  },
+  "homepage": "https://github.com/Linol-Hamelton/jtcsv/tree/main/plugins/nuxt#readme",
+  "peerDependencies": {
+    "@nuxt/kit": "^3.0.0",
+    "jtcsv": "^2.1.3",
+    "nuxt": "^3.0.0"
+  },
+  "files": [
+    "index.js",
+    "README.md",
+    "runtime/"
+  ]
+}

package/plugins/nuxt/runtime/composables/useJtcsv.js

@@ -0,0 +1,6 @@
+import { useNuxtApp } from '#app';
+
+export const useJtcsv = () => {
+  const { $jtcsv } = useNuxtApp();
+  return $jtcsv;
+};

package/plugins/nuxt/runtime/plugin.js

@@ -0,0 +1,6 @@
+import { defineNuxtPlugin } from '#app';
+import * as jtcsv from 'jtcsv';
+
+export default defineNuxtPlugin((nuxtApp) => {
+  nuxtApp.provide('jtcsv', jtcsv);
+});