jtcsv 2.2.8 → 3.1.0

package/plugins/nextjs-api/route.js

@@ -1,371 +0,0 @@
-/**
- * Next.js API Route для JTCSV
- * Готовый API endpoint для конвертации CSV/JSON в Next.js приложениях
- * 
- * @version 1.0.0
- * @date 2026-01-23
- * 
- * @usage
- * 1. Скопируйте этот файл в pages/api/convert.js
- * 2. Или импортируйте функции в существующие API routes
- */
-
-import { csvToJson, jsonToCsv } from 'jtcsv';
-
-/**
- * Конфигурация Next.js API route
- */
-export const config = {
-  api: {
-    bodyParser: {
-      sizeLimit: '50mb',  // Максимальный размер тела запроса
-      
-      // Кастомный парсер для определения формата
-      parse: (req) => {
-        const contentType = req.headers['content-type'] || '';
-        
-        if (contentType.includes('application/json')) {
-          return JSON.parse(req.body);
-        } else if (contentType.includes('text/csv') || contentType.includes('text/plain')) {
-          return req.body;
-        }
-        
-        // Пытаемся определить автоматически
-        try {
-          return JSON.parse(req.body);
-        } catch {
-          return req.body;
-        }
-      }
-    }
-  }
-};
-
-/**
- * Основной обработчик API route
- * 
- * @param {import('next').NextApiRequest} req - Next.js request object
- * @param {import('next').NextApiResponse} res - Next.js response object
- * 
- * @example
- * // Пример запроса:
- * // POST /api/convert
- * // Content-Type: application/json
- * // Body: [{ "name": "John", "age": 30 }]
- * 
- * @example
- * // Пример запроса:
- * // POST /api/convert?format=csv
- * // Content-Type: text/csv
- * // Body: name,age\nJohn,30\nJane,25
- */
-export default async function handler(req, res) {
-  // Поддерживаем только POST запросы
-  if (req.method !== 'POST') {
-    return res.status(405).json({
-      success: false,
-      error: 'Method not allowed',
-      allowed: ['POST']
-    });
-  }
-
-  const startTime = Date.now();
-  const contentType = req.headers['content-type'] || '';
-  const acceptHeader = req.headers['accept'] || 'application/json';
-  
-  try {
-    const { 
-      format, 
-      delimiter = ',',
-      includeHeaders = 'true',
-      parseNumbers = 'true',
-      parseBooleans = 'true',
-      useFastPath = 'true',
-      preventCsvInjection = 'true'
-    } = req.query;
-
-    // Определяем желаемый формат вывода
-    let outputFormat = format || (acceptHeader.includes('text/csv') ? 'csv' : 'json');
-    
-    // Определяем формат входных данных
-    let inputFormat = 'unknown';
-    
-    if (contentType.includes('application/json') || Array.isArray(req.body)) {
-      inputFormat = 'json';
-    } else if (contentType.includes('text/csv') || 
-              contentType.includes('text/plain') ||
-              (typeof req.body === 'string' && req.body.includes(','))) {
-      inputFormat = 'csv';
-    }
-
-    if (inputFormat === 'unknown') {
-      return res.status(400).json({
-        success: false,
-        error: 'Unable to determine input format',
-        code: 'UNKNOWN_FORMAT',
-        suggestions: [
-          'Set Content-Type header to application/json or text/csv',
-          'Or send JSON array/object or CSV string'
-        ]
-      });
-    }
-
-    // Опции конвертации
-    const options = {
-      delimiter,
-      includeHeaders: includeHeaders === 'true',
-      parseNumbers: parseNumbers === 'true',
-      parseBooleans: parseBooleans === 'true',
-      useFastPath: useFastPath === 'true',
-      preventCsvInjection: preventCsvInjection === 'true',
-      rfc4180Compliant: true
-    };
-
-    let result;
-    let stats = {
-      inputSize: 0,
-      outputSize: 0,
-      processingTime: 0,
-      conversion: `${inputFormat}→${outputFormat}`
-    };
-
-    // Выполняем конвертацию
-    if (inputFormat === 'json' && outputFormat === 'csv') {
-      const jsonData = Array.isArray(req.body) ? req.body : [req.body];
-      stats.inputSize = Buffer.byteLength(JSON.stringify(jsonData));
-      
-      result = await jsonToCsv(jsonData, options);
-      stats.outputSize = Buffer.byteLength(result);
-      
-      res.setHeader('Content-Type', 'text/csv; charset=utf-8');
-      res.setHeader('Content-Disposition', 'attachment; filename="data.csv"');
-      
-    } else if (inputFormat === 'csv' && outputFormat === 'json') {
-      const csvData = typeof req.body === 'string' ? req.body : String(req.body);
-      stats.inputSize = Buffer.byteLength(csvData);
-      
-      result = await csvToJson(csvData, options);
-      stats.outputSize = Buffer.byteLength(JSON.stringify(result));
-      
-      res.setHeader('Content-Type', 'application/json; charset=utf-8');
-      
-    } else {
-      // Нет необходимости в конвертации
-      result = req.body;
-      stats.conversion = 'none';
-      stats.inputSize = Buffer.byteLength(JSON.stringify(result));
-      stats.outputSize = stats.inputSize;
-    }
-
-    stats.processingTime = Date.now() - startTime;
-
-    // Формируем ответ
-    const response = {
-      success: true,
-      data: result,
-      format: outputFormat,
-      inputFormat,
-      stats,
-      options: {
-        ...options,
-        delimiter
-      }
-    };
-
-    // Если запрашивали CSV, отправляем как plain text
-    if (outputFormat === 'csv') {
-      return res.status(200).send(result);
-    }
-
-    return res.status(200).json(response);
-
-  } catch (error) {
-    console.error('Conversion error:', error);
-    
-    const errorResponse = {
-      success: false,
-      error: error.message,
-      code: error.code || 'CONVERSION_ERROR',
-      timestamp: new Date().toISOString()
-    };
-
-    // Добавляем дополнительную информацию для отладки в development
-    if (process.env.NODE_ENV === 'development') {
-      errorResponse.stack = error.stack;
-      errorResponse.details = {
-        contentType: req.headers['content-type'],
-        contentLength: req.headers['content-length'],
-        method: req.method,
-        url: req.url,
-        query: req.query
-      };
-    }
-
-    return res.status(400).json(errorResponse);
-  }
-}
-
-/**
- * Специализированный обработчик для CSV → JSON
- */
-export async function csvToJsonHandler(req, res) {
-  if (req.method !== 'POST') {
-    return res.status(405).json({
-      success: false,
-      error: 'Method not allowed',
-      allowed: ['POST']
-    });
-  }
-
-  const startTime = Date.now();
-  
-  try {
-    const csvData = req.body;
-    
-    if (!csvData || (typeof csvData !== 'string' && !Buffer.isBuffer(csvData))) {
-      return res.status(400).json({
-        success: false,
-        error: 'CSV data is required'
-      });
-    }
-
-    const {
-      delimiter = ',',
-      parseNumbers = 'true',
-      parseBooleans = 'true',
-      useFastPath = 'true'
-    } = req.query;
-
-    const result = await csvToJson(csvData, {
-      delimiter,
-      parseNumbers: parseNumbers === 'true',
-      parseBooleans: parseBooleans === 'true',
-      useFastPath: useFastPath === 'true',
-      preventCsvInjection: true,
-      rfc4180Compliant: true
-    });
-
-    return res.status(200).json({
-      success: true,
-      data: result,
-      stats: {
-        rows: result.length,
-        processingTime: Date.now() - startTime
-      }
-    });
-
-  } catch (error) {
-    return res.status(400).json({
-      success: false,
-      error: error.message
-    });
-  }
-}
-
-/**
- * Специализированный обработчик для JSON → CSV
- */
-export async function jsonToCsvHandler(req, res) {
-  if (req.method !== 'POST') {
-    return res.status(405).json({
-      success: false,
-      error: 'Method not allowed',
-      allowed: ['POST']
-    });
-  }
-
-  const startTime = Date.now();
-  
-  try {
-    const jsonData = req.body;
-    
-    if (!jsonData || (typeof jsonData !== 'object' && typeof jsonData !== 'string')) {
-      return res.status(400).json({
-        success: false,
-        error: 'JSON data is required'
-      });
-    }
-
-    const {
-      delimiter = ',',
-      includeHeaders = 'true',
-      useFastPath = 'true'
-    } = req.query;
-
-    const data = typeof jsonData === 'string' ? JSON.parse(jsonData) : jsonData;
-    const result = await jsonToCsv(data, {
-      delimiter,
-      includeHeaders: includeHeaders === 'true',
-      useFastPath: useFastPath === 'true',
-      preventCsvInjection: true,
-      rfc4180Compliant: true
-    });
-
-    res.setHeader('Content-Type', 'text/csv; charset=utf-8');
-    res.setHeader('Content-Disposition', 'attachment; filename="data.csv"');
-    
-    return res.status(200).send(result);
-
-  } catch (error) {
-    return res.status(400).json({
-      success: false,
-      error: error.message
-    });
-  }
-}
-
-/**
- * Health check endpoint
- */
-export async function healthCheckHandler(req, res) {
-  if (req.method !== 'GET') {
-    return res.status(405).json({
-      success: false,
-      error: 'Method not allowed',
-      allowed: ['GET']
-    });
-  }
-
-  return res.status(200).json({
-    service: 'jtcsv-nextjs-api',
-    status: 'healthy',
-    version: '1.0.0',
-    timestamp: new Date().toISOString(),
-    features: {
-      csvToJson: true,
-      jsonToCsv: true,
-      fastPathEngine: true,
-      csvInjectionProtection: true,
-      streaming: true,
-      ndjson: true
-    }
-  });
-}
-
-/**
- * Утилита для создания кастомных API endpoints
- */
-export function createJtcsvApiEndpoint(options = {}) {
-  const {
-    route = '/api/convert',
-    allowedMethods = ['POST'],
-    defaultFormat = 'json',
-    ...defaultOptions
-  } = options;
-
-  return async function customHandler(req, res) {
-    // Проверяем разрешенные методы
-    if (!allowedMethods.includes(req.method)) {
-      return res.status(405).json({
-        success: false,
-        error: `Method ${req.method} not allowed`,
-        allowed: allowedMethods
-      });
-    }
-
-    // Здесь можно добавить кастомную логику
-    // Пока просто используем основной handler
-    return handler(req, res);
-  };
-}
-

package/plugins/nuxt/README.md

@@ -1,24 +0,0 @@
-# @jtcsv/nuxt
-
-Nuxt module that injects `jtcsv` into the Nuxt app and provides a `useJtcsv` composable.
-
-## Install
-```bash
-npm install @jtcsv/nuxt jtcsv
-```
-
-## Nuxt config
-```typescript
-export default defineNuxtConfig({
-  modules: ['@jtcsv/nuxt'],
-  jtcsv: { autoimport: true }
-});
-```
-
-## Usage
-```vue
-<script setup>
-const jtcsv = useJtcsv();
-const csv = jtcsv.jsonToCsv([{ id: 1 }]);
-</script>
-```

package/plugins/nuxt/index.js

@@ -1,21 +0,0 @@
-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

@@ -1,35 +0,0 @@
-{
-  "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

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

package/plugins/nuxt/runtime/plugin.js

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

package/plugins/remix/README.md

@@ -1,26 +0,0 @@
-# @jtcsv/remix
-
-Remix helpers for CSV form uploads and CSV responses.
-
-## Install
-```bash
-npm install @jtcsv/remix jtcsv
-```
-
-## Usage
-```javascript
-import { parseFormData, generateCsvResponse } from '@jtcsv/remix';
-
-export async function action({ request }) {
-  const rows = await parseFormData(request, { fieldName: 'file', delimiter: ',' });
-  return { rows };
-}
-
-export async function loader() {
-  return generateCsvResponse([{ id: 1 }], 'export.csv');
-}
-```
-
-## Exports
-- parseFormData
-- generateCsvResponse

package/plugins/remix/index.d.ts

@@ -1,16 +0,0 @@
-import type { CsvToJsonOptions, JsonToCsvOptions } from 'jtcsv';
-
-export interface RemixCsvParseOptions extends CsvToJsonOptions {
-  fieldName?: string;
-}
-
-export function parseFormData(
-  request: Request,
-  options?: RemixCsvParseOptions
-): Promise<unknown[]>;
-
-export function generateCsvResponse(
-  data: unknown[] | Record<string, unknown>,
-  filename?: string,
-  options?: JsonToCsvOptions
-): Response;

package/plugins/remix/index.js

@@ -1,62 +0,0 @@
-const jtcsv = require('jtcsv');
-
-function normalizeFilename(filename) {
-  if (!filename || typeof filename !== 'string') {
-    return 'export.csv';
-  }
-  return filename.includes('.') ? filename : `${filename}.csv`;
-}
-
-async function extractCsvText(formData, fieldName) {
-  if (formData.has(fieldName)) {
-    const value = formData.get(fieldName);
-    if (value && typeof value.text === 'function') {
-      return await value.text();
-    }
-    if (value != null) {
-      return String(value);
-    }
-  }
-
-  for (const value of formData.values()) {
-    if (value && typeof value.text === 'function') {
-      return await value.text();
-    }
-  }
-
-  return null;
-}
-
-async function parseFormData(request, options = {}) {
-  if (!request || typeof request.formData !== 'function') {
-    throw new Error('parseFormData expects a Remix Request with formData()');
-  }
-
-  const { fieldName = 'file', ...csvOptions } = options;
-  const formData = await request.formData();
-  const csvText = await extractCsvText(formData, fieldName);
-
-  if (!csvText) {
-    throw new Error('No CSV file or field found in form data');
-  }
-
-  return jtcsv.csvToJson(csvText, csvOptions);
-}
-
-function generateCsvResponse(data, filename = 'export.csv', options = {}) {
-  const safeName = normalizeFilename(filename);
-  const rows = Array.isArray(data) ? data : [data];
-  const csv = jtcsv.jsonToCsv(rows, options);
-
-  return new Response(csv, {
-    headers: {
-      'Content-Type': 'text/csv; charset=utf-8',
-      'Content-Disposition': `attachment; filename="${safeName}"`
-    }
-  });
-}
-
-module.exports = {
-  parseFormData,
-  generateCsvResponse
-};

package/plugins/remix/package.json

@@ -1,35 +0,0 @@
-{
-  "name": "@jtcsv/remix",
-  "version": "1.0.0",
-  "description": "Remix helpers for JTCSV (form-data parsing and CSV responses)",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "keywords": [
-    "remix",
-    "csv",
-    "json",
-    "converter",
-    "jtcsv",
-    "formdata",
-    "response"
-  ],
-  "author": "Ruslan Fomenko",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Linol-Hamelton/jtcsv.git",
-    "directory": "plugins/remix"
-  },
-  "bugs": {
-    "url": "https://github.com/Linol-Hamelton/jtcsv/issues"
-  },
-  "homepage": "https://github.com/Linol-Hamelton/jtcsv/tree/main/plugins/remix#readme",
-  "peerDependencies": {
-    "jtcsv": "^2.1.3"
-  },
-  "files": [
-    "index.js",
-    "index.d.ts",
-    "README.md"
-  ]
-}

package/plugins/sveltekit/README.md

@@ -1,28 +0,0 @@
-# @jtcsv/sveltekit
-
-Helpers for parsing CSV requests and returning CSV responses in SvelteKit.
-
-## Install
-```bash
-npm install @jtcsv/sveltekit jtcsv
-```
-
-## Usage
-```javascript
-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');
-}
-```
-
-## Exports
-- parseCsv
-- generateCsv

package/plugins/sveltekit/index.d.ts

@@ -1,17 +0,0 @@
-import type { CsvToJsonOptions, JsonToCsvOptions } from 'jtcsv';
-
-export interface SvelteKitCsvParseOptions extends CsvToJsonOptions {
-  fieldName?: string;
-  formData?: boolean;
-}
-
-export function parseCsv(
-  request: Request,
-  options?: SvelteKitCsvParseOptions
-): Promise<unknown[]>;
-
-export function generateCsv(
-  data: unknown[] | Record<string, unknown>,
-  filename?: string,
-  options?: JsonToCsvOptions
-): Response;