jtcsv 2.2.8 → 3.1.0

package/dist/src/core/transform-hooks.js

@@ -0,0 +1,348 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.predefinedHooks = exports.TransformHooks = void 0;
+const errors_1 = require("../errors");
+class TransformHooks {
+    constructor(options) {
+        this.hooks = {
+            beforeConvert: options?.hooks?.beforeConvert || [],
+            afterConvert: options?.hooks?.afterConvert || [],
+            perRow: options?.hooks?.perRow || []
+        };
+    }
+    beforeConvert(hook) {
+        if (typeof hook !== 'function') {
+            throw new errors_1.ValidationError('beforeConvert hook must be a function');
+        }
+        this.hooks.beforeConvert.push(hook);
+        return this;
+    }
+    afterConvert(hook) {
+        if (typeof hook !== 'function') {
+            throw new errors_1.ValidationError('afterConvert hook must be a function');
+        }
+        this.hooks.afterConvert.push(hook);
+        return this;
+    }
+    perRow(hook) {
+        if (typeof hook !== 'function') {
+            throw new errors_1.ValidationError('perRow hook must be a function');
+        }
+        this.hooks.perRow.push(hook);
+        return this;
+    }
+    applyBeforeConvert(data, context = {}) {
+        let result = data;
+        for (const hook of this.hooks.beforeConvert) {
+            result = hook(result, context);
+        }
+        return result;
+    }
+    async applyBeforeConvertAsync(data, context = {}) {
+        let result = data;
+        for (const hook of this.hooks.beforeConvert) {
+            if (this.isAsyncFunction(hook)) {
+                result = await hook(result, context);
+            }
+            else {
+                result = hook(result, context);
+            }
+        }
+        return result;
+    }
+    applyAfterConvert(data, context = {}) {
+        let result = data;
+        for (const hook of this.hooks.afterConvert) {
+            result = hook(result, context);
+        }
+        return result;
+    }
+    async applyAfterConvertAsync(data, context = {}) {
+        let result = data;
+        for (const hook of this.hooks.afterConvert) {
+            if (this.isAsyncFunction(hook)) {
+                result = await hook(result, context);
+            }
+            else {
+                result = hook(result, context);
+            }
+        }
+        return result;
+    }
+    applyPerRow(row, index, context = {}) {
+        let result = row;
+        for (const hook of this.hooks.perRow) {
+            result = hook(result, index, context);
+        }
+        return result;
+    }
+    async applyPerRowAsync(row, index, context = {}) {
+        let result = row;
+        for (const hook of this.hooks.perRow) {
+            if (this.isAsyncFunction(hook)) {
+                result = await hook(result, index, context);
+            }
+            else {
+                result = hook(result, index, context);
+            }
+        }
+        return result;
+    }
+    applyAll(data, context = {}) {
+        if (!Array.isArray(data)) {
+            throw new errors_1.ValidationError('Data must be an array for applyAll');
+        }
+        let processedData = this.applyBeforeConvert(data, context);
+        if (this.hooks.perRow.length > 0) {
+            processedData = processedData.map((row, index) => this.applyPerRow(row, index, context));
+        }
+        return this.applyAfterConvert(processedData, context);
+    }
+    async applyAllAsync(data, context = {}) {
+        if (!Array.isArray(data)) {
+            throw new errors_1.ValidationError('Data must be an array for applyAll');
+        }
+        let processedData = await this.applyBeforeConvertAsync(data, context);
+        if (this.hooks.perRow.length > 0) {
+            const processedRows = [];
+            for (let i = 0; i < processedData.length; i++) {
+                const processedRow = await this.applyPerRowAsync(processedData[i], i, context);
+                processedRows.push(processedRow);
+            }
+            processedData = processedRows;
+        }
+        return await this.applyAfterConvertAsync(processedData, context);
+    }
+    clone() {
+        const cloned = new TransformHooks();
+        cloned.hooks = {
+            beforeConvert: [...this.hooks.beforeConvert],
+            afterConvert: [...this.hooks.afterConvert],
+            perRow: [...this.hooks.perRow]
+        };
+        return cloned;
+    }
+    clear() {
+        this.hooks = {
+            beforeConvert: [],
+            afterConvert: [],
+            perRow: []
+        };
+    }
+    getStats() {
+        return {
+            beforeConvert: this.hooks.beforeConvert.length,
+            afterConvert: this.hooks.afterConvert.length,
+            perRow: this.hooks.perRow.length,
+            total: this.hooks.beforeConvert.length +
+                this.hooks.afterConvert.length +
+                this.hooks.perRow.length
+        };
+    }
+    isAsyncFunction(fn) {
+        return fn.constructor.name === 'AsyncFunction' ||
+            (typeof fn === 'function' && fn.constructor === (async () => { }).constructor);
+    }
+}
+exports.TransformHooks = TransformHooks;
+exports.predefinedHooks = {
+    filter(predicate) {
+        return (data) => {
+            if (Array.isArray(data)) {
+                return data.filter(predicate);
+            }
+            return data;
+        };
+    },
+    filterAsync(predicate) {
+        return async (data) => {
+            if (Array.isArray(data)) {
+                const filtered = [];
+                for (let i = 0; i < data.length; i++) {
+                    if (await predicate(data[i], i)) {
+                        filtered.push(data[i]);
+                    }
+                }
+                return filtered;
+            }
+            return data;
+        };
+    },
+    map(mapper) {
+        return (data) => {
+            if (Array.isArray(data)) {
+                return data.map(mapper);
+            }
+            return data;
+        };
+    },
+    mapAsync(mapper) {
+        return async (data) => {
+            if (Array.isArray(data)) {
+                const mapped = [];
+                for (let i = 0; i < data.length; i++) {
+                    mapped.push(await mapper(data[i], i));
+                }
+                return mapped;
+            }
+            return data;
+        };
+    },
+    sort(compareFn) {
+        return (data) => {
+            if (Array.isArray(data)) {
+                return [...data].sort(compareFn);
+            }
+            return data;
+        };
+    },
+    limit(limit) {
+        return (data) => {
+            if (Array.isArray(data)) {
+                return data.slice(0, limit);
+            }
+            return data;
+        };
+    },
+    addMetadata(metadata) {
+        return (data, context) => {
+            if (Array.isArray(data)) {
+                return data.map(item => ({
+                    ...item,
+                    _metadata: {
+                        ...metadata,
+                        timestamp: new Date().toISOString(),
+                        context
+                    }
+                }));
+            }
+            return data;
+        };
+    },
+    transformKeys(keyTransformer) {
+        return (data) => {
+            if (Array.isArray(data)) {
+                return data.map(item => {
+                    const transformed = {};
+                    for (const [key, value] of Object.entries(item)) {
+                        transformed[keyTransformer(key)] = value;
+                    }
+                    return transformed;
+                });
+            }
+            return data;
+        };
+    },
+    transformValues(valueTransformer) {
+        return (data) => {
+            if (Array.isArray(data)) {
+                return data.map(item => {
+                    const transformed = {};
+                    for (const [key, value] of Object.entries(item)) {
+                        transformed[key] = valueTransformer(value, key);
+                    }
+                    return transformed;
+                });
+            }
+            return data;
+        };
+    },
+    validate(validator, onError = console.error) {
+        return (data) => {
+            if (Array.isArray(data)) {
+                const validData = [];
+                const errors = [];
+                data.forEach((item, index) => {
+                    try {
+                        const isValid = validator(item, index);
+                        if (isValid) {
+                            validData.push(item);
+                        }
+                        else {
+                            errors.push({ index, item, reason: 'Validation failed' });
+                        }
+                    }
+                    catch (error) {
+                        errors.push({ index, item, error: error.message });
+                    }
+                });
+                if (errors.length > 0) {
+                    if (onError.length >= 2) {
+                        onError('Validation errors', errors);
+                    }
+                    else {
+                        onError(errors);
+                    }
+                }
+                return validData;
+            }
+            return data;
+        };
+    },
+    validateAsync(validator, onError = console.error) {
+        return async (data) => {
+            if (Array.isArray(data)) {
+                const validData = [];
+                const errors = [];
+                for (let i = 0; i < data.length; i++) {
+                    try {
+                        const isValid = await validator(data[i], i);
+                        if (isValid) {
+                            validData.push(data[i]);
+                        }
+                        else {
+                            errors.push({ index: i, item: data[i], reason: 'Validation failed' });
+                        }
+                    }
+                    catch (error) {
+                        errors.push({ index: i, item: data[i], error: error.message });
+                    }
+                }
+                if (errors.length > 0) {
+                    if (onError.length >= 2) {
+                        onError('Validation errors', errors);
+                    }
+                    else {
+                        onError(errors);
+                    }
+                }
+                return validData;
+            }
+            return data;
+        };
+    },
+    deduplicate(keySelector = JSON.stringify) {
+        return (data) => {
+            if (Array.isArray(data)) {
+                const seen = new Set();
+                return data.filter(item => {
+                    const key = keySelector(item);
+                    if (seen.has(key)) {
+                        return false;
+                    }
+                    seen.add(key);
+                    return true;
+                });
+            }
+            return data;
+        };
+    },
+    deduplicateAsync(keySelector = async (item) => JSON.stringify(item)) {
+        return async (data) => {
+            if (Array.isArray(data)) {
+                const seen = new Set();
+                const filtered = [];
+                for (const item of data) {
+                    const key = await keySelector(item);
+                    if (!seen.has(key)) {
+                        seen.add(key);
+                        filtered.push(item);
+                    }
+                }
+                return filtered;
+            }
+            return data;
+        };
+    }
+};
+//# sourceMappingURL=transform-hooks.js.map

package/dist/src/core/transform-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-hooks.js","sourceRoot":"","sources":["../../../src/core/transform-hooks.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * Transform Hooks System\r\n * Система хуков для трансформации данных перед/после конвертации\r\n * \r\n * @version 2.0.0\r\n * @date 2026-01-29\r\n */\r\n\r\nimport { ValidationError } from '../errors';\r\n\r\nexport interface HookContext {\r\n  [key: string]: any;\r\n}\r\n\r\nexport type HookFunction<T = any, R = any> = (data: T, context?: HookContext) => R;\r\nexport type PerRowHookFunction<T = any, R = any> = (row: T, index: number, context?: HookContext) => R;\r\nexport type AsyncHookFunction<T = any, R = any> = (data: T, context?: HookContext) => Promise<R>;\r\nexport type AsyncPerRowHookFunction<T = any, R = any> = (row: T, index: number, context?: HookContext) => Promise<R>;\r\n\r\nexport interface TransformHooksOptions {\r\n  hooks?: {\r\n    beforeConvert?: Array<HookFunction | AsyncHookFunction>;\r\n    afterConvert?: Array<HookFunction | AsyncHookFunction>;\r\n    perRow?: Array<PerRowHookFunction | AsyncPerRowHookFunction>;\r\n  };\r\n}\r\n\r\nexport class TransformHooks {\r\n  private hooks: {\r\n    beforeConvert: Array<HookFunction | AsyncHookFunction>;\r\n    afterConvert: Array<HookFunction | AsyncHookFunction>;\r\n    perRow: Array<PerRowHookFunction | AsyncPerRowHookFunction>;\r\n  };\r\n\r\n  constructor(options?: TransformHooksOptions) {\r\n    this.hooks = {\r\n      beforeConvert: options?.hooks?.beforeConvert || [],\r\n      afterConvert: options?.hooks?.afterConvert || [],\r\n      perRow: options?.hooks?.perRow || []\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Регистрирует хук beforeConvert\r\n   * @param hook - Функция хука\r\n   * @returns this для цепочки вызовов\r\n   */\r\n  beforeConvert(hook: HookFunction | AsyncHookFunction): this {\r\n    if (typeof hook !== 'function') {\r\n      throw new ValidationError('beforeConvert hook must be a function');\r\n    }\r\n    this.hooks.beforeConvert.push(hook);\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Регистрирует хук afterConvert\r\n   * @param hook - Функция хука\r\n   * @returns this для цепочки вызовов\r\n   */\r\n  afterConvert(hook: HookFunction | AsyncHookFunction): this {\r\n    if (typeof hook !== 'function') {\r\n      throw new ValidationError('afterConvert hook must be a function');\r\n    }\r\n    this.hooks.afterConvert.push(hook);\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Регистрирует per-row хук\r\n   * @param hook - Функция хука\r\n   * @returns this для цепочки вызовов\r\n   */\r\n  perRow(hook: PerRowHookFunction | AsyncPerRowHookFunction): this {\r\n    if (typeof hook !== 'function') {\r\n      throw new ValidationError('perRow hook must be a function');\r\n    }\r\n    this.hooks.perRow.push(hook);\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Применяет beforeConvert хуки\r\n   * @param data - Входные данные\r\n   * @param context - Контекст выполнения\r\n   * @returns Трансформированные данные\r\n   */\r\n  applyBeforeConvert<T = any, R = any>(data: T, context: HookContext = {}): R {\r\n    let result: any = data;\r\n    for (const hook of this.hooks.beforeConvert) {\r\n      result = hook(result, context);\r\n    }\r\n    return result as R;\r\n  }\r\n\r\n  /**\r\n   * Применяет beforeConvert хуки асинхронно\r\n   * @param data - Входные данные\r\n   * @param context - Контекст выполнения\r\n   * @returns Promise с трансформированными данными\r\n   */\r\n  async applyBeforeConvertAsync<T = any, R = any>(data: T, context: HookContext = {}): Promise<R> {\r\n    let result: any = data;\r\n    for (const hook of this.hooks.beforeConvert) {\r\n      if (this.isAsyncFunction(hook)) {\r\n        result = await (hook as AsyncHookFunction)(result, context);\r\n      } else {\r\n        result = (hook as HookFunction)(result, context);\r\n      }\r\n    }\r\n    return result as R;\r\n  }\r\n\r\n  /**\r\n   * Применяет afterConvert хуки\r\n   * @param data - Выходные данные\r\n   * @param context - Контекст выполнения\r\n   * @returns Трансформированные данные\r\n   */\r\n  applyAfterConvert<T = any, R = any>(data: T, context: HookContext = {}): R {\r\n    let result: any = data;\r\n    for (const hook of this.hooks.afterConvert) {\r\n      result = hook(result, context);\r\n    }\r\n    return result as R;\r\n  }\r\n\r\n  /**\r\n   * Применяет afterConvert хуки асинхронно\r\n   * @param data - Выходные данные\r\n   * @param context - Контекст выполнения\r\n   * @returns Promise с трансформированными данными\r\n   */\r\n  async applyAfterConvertAsync<T = any, R = any>(data: T, context: HookContext = {}): Promise<R> {\r\n    let result: any = data;\r\n    for (const hook of this.hooks.afterConvert) {\r\n      if (this.isAsyncFunction(hook)) {\r\n        result = await (hook as AsyncHookFunction)(result, context);\r\n      } else {\r\n        result = (hook as HookFunction)(result, context);\r\n      }\r\n    }\r\n    return result as R;\r\n  }\r\n\r\n  /**\r\n   * Применяет per-row хуки\r\n   * @param row - Строка данных\r\n   * @param index - Индекс строки\r\n   * @param context - Контекст выполнения\r\n   * @returns Трансформированная строка\r\n   */\r\n  applyPerRow<T = any, R = any>(row: T, index: number, context: HookContext = {}): R {\r\n    let result: any = row;\r\n    for (const hook of this.hooks.perRow) {\r\n      result = hook(result, index, context);\r\n    }\r\n    return result as R;\r\n  }\r\n\r\n  /**\r\n   * Применяет per-row хуки асинхронно\r\n   * @param row - Строка данных\r\n   * @param index - Индекс строки\r\n   * @param context - Контекст выполнения\r\n   * @returns Promise с трансформированной строкой\r\n   */\r\n  async applyPerRowAsync<T = any, R = any>(row: T, index: number, context: HookContext = {}): Promise<R> {\r\n    let result: any = row;\r\n    for (const hook of this.hooks.perRow) {\r\n      if (this.isAsyncFunction(hook)) {\r\n        result = await (hook as AsyncPerRowHookFunction)(result, index, context);\r\n      } else {\r\n        result = (hook as PerRowHookFunction)(result, index, context);\r\n      }\r\n    }\r\n    return result as R;\r\n  }\r\n\r\n  /**\r\n   * Применяет все хуки к массиву данных\r\n   * @param data - Массив данных\r\n   * @param context - Контекст выполнения\r\n   * @returns Трансформированный массив\r\n   */\r\n  applyAll<T = any, R = any>(data: T[], context: HookContext = {}): R[] {\r\n    if (!Array.isArray(data)) {\r\n      throw new ValidationError('Data must be an array for applyAll');\r\n    }\r\n\r\n    // Применяем beforeConvert хуки\r\n    let processedData: any[] = this.applyBeforeConvert(data, context);\r\n\r\n    // Применяем per-row хуки к каждой строке\r\n    if (this.hooks.perRow.length > 0) {\r\n      processedData = processedData.map((row: any, index: number) => \r\n        this.applyPerRow(row, index, context)\r\n      );\r\n    }\r\n\r\n    // Применяем afterConvert хуки\r\n    return this.applyAfterConvert(processedData, context) as R[];\r\n  }\r\n\r\n  /**\r\n   * Применяет все хуки к массиву данных асинхронно\r\n   * @param data - Массив данных\r\n   * @param context - Контекст выполнения\r\n   * @returns Promise с трансформированным массивом\r\n   */\r\n  async applyAllAsync<T = any, R = any>(data: T[], context: HookContext = {}): Promise<R[]> {\r\n    if (!Array.isArray(data)) {\r\n      throw new ValidationError('Data must be an array for applyAll');\r\n    }\r\n\r\n    // Применяем beforeConvert хуки асинхронно\r\n    let processedData = await this.applyBeforeConvertAsync(data, context);\r\n\r\n    // Применяем per-row хуки асинхронно к каждой строке\r\n    if (this.hooks.perRow.length > 0) {\r\n      const processedRows: any[] = [];\r\n      for (let i = 0; i < processedData.length; i++) {\r\n        const processedRow = await this.applyPerRowAsync(processedData[i], i, context);\r\n        processedRows.push(processedRow);\r\n      }\r\n      processedData = processedRows;\r\n    }\r\n\r\n    // Применяем afterConvert хуки асинхронно\r\n    return await this.applyAfterConvertAsync(processedData, context) as R[];\r\n  }\r\n\r\n  /**\r\n   * Создает копию системы хуков\r\n   * @returns Новая копия\r\n   */\r\n  clone(): TransformHooks {\r\n    const cloned = new TransformHooks();\r\n    cloned.hooks = {\r\n      beforeConvert: [...this.hooks.beforeConvert],\r\n      afterConvert: [...this.hooks.afterConvert],\r\n      perRow: [...this.hooks.perRow]\r\n    };\r\n    return cloned;\r\n  }\r\n\r\n  /**\r\n   * Очищает все хуки\r\n   */\r\n  clear(): void {\r\n    this.hooks = {\r\n      beforeConvert: [],\r\n      afterConvert: [],\r\n      perRow: []\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Возвращает статистику по хукам\r\n   * @returns Статистика\r\n   */\r\n  getStats(): { beforeConvert: number; afterConvert: number; perRow: number; total: number } {\r\n    return {\r\n      beforeConvert: this.hooks.beforeConvert.length,\r\n      afterConvert: this.hooks.afterConvert.length,\r\n      perRow: this.hooks.perRow.length,\r\n      total: this.hooks.beforeConvert.length + \r\n             this.hooks.afterConvert.length + \r\n             this.hooks.perRow.length\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Проверяет, является ли функция асинхронной\r\n   * @private\r\n   */\r\n  private isAsyncFunction(fn: any): boolean {\r\n    return fn.constructor.name === 'AsyncFunction' || \r\n           (typeof fn === 'function' && fn.constructor === (async () => {}).constructor);\r\n  }\r\n}\r\n\r\n/**\r\n * Предопределенные хуки\r\n */\r\nexport const predefinedHooks = {\r\n  /**\r\n   * Хук для фильтрации данных\r\n   * @param predicate - Функция-предикат\r\n   * @returns Хук фильтрации\r\n   */\r\n  filter<T>(predicate: (item: T, index: number) => boolean): HookFunction<T[], T[]> {\r\n    return (data: T[]) => {\r\n      if (Array.isArray(data)) {\r\n        return data.filter(predicate);\r\n      }\r\n      return data;\r\n    };\r\n  },\r\n\r\n  /**\r\n   * Асинхронный хук для фильтрации данных\r\n   * @param predicate - Асинхронная функция-предикат\r\n   * @returns Асинхронный хук фильтрации\r\n   */\r\n  filterAsync<T>(predicate: (item: T, index: number) => Promise<boolean>): AsyncHookFunction<T[], T[]> {\r\n    return async (data: T[]) => {\r\n      if (Array.isArray(data)) {\r\n        const filtered: T[] = [];\r\n        for (let i = 0; i < data.length; i++) {\r\n          if (await predicate(data[i], i)) {\r\n            filtered.push(data[i]);\r\n          }\r\n        }\r\n        return filtered;\r\n      }\r\n      return data;\r\n    };\r\n  },\r\n\r\n  /**\r\n   * Хук для маппинга данных\r\n   * @param mapper - Функция-маппер\r\n   * @returns Хук маппинга\r\n   */\r\n  map<T, R>(mapper: (item: T, index: number) => R): HookFunction<T[], R[]> {\r\n    return (data: T[]) => {\r\n      if (Array.isArray(data)) {\r\n        return data.map(mapper);\r\n      }\r\n      return data as any;\r\n    };\r\n  },\r\n\r\n  /**\r\n   * Асинхронный хук для маппинга данных\r\n   * @param mapper - Асинхронная функция-маппер\r\n   * @returns Асинхронный хук маппинга\r\n   */\r\n  mapAsync<T, R>(mapper: (item: T, index: number) => Promise<R>): AsyncHookFunction<T[], R[]> {\r\n    return async (data: T[]) => {\r\n      if (Array.isArray(data)) {\r\n        const mapped: R[] = [];\r\n        for (let i = 0; i < data.length; i++) {\r\n          mapped.push(await mapper(data[i], i));\r\n        }\r\n        return mapped;\r\n      }\r\n      return data as any;\r\n    };\r\n  },\r\n\r\n  /**\r\n   * Хук для сортировки данных\r\n   * @param compareFn - Функция сравнения\r\n   * @returns Хук сортировки\r\n   */\r\n  sort<T>(compareFn?: (a: T, b: T) => number): HookFunction<T[], T[]> {\r\n    return (data: T[]) => {\r\n      if (Array.isArray(data)) {\r\n        return [...data].sort(compareFn);\r\n      }\r\n      return data;\r\n    };\r\n  },\r\n\r\n  /**\r\n   * Хук для ограничения количества записей\r\n   * @param limit - Максимальное количество записей\r\n   * @returns Хук ограничения\r\n   */\r\n  limit<T>(limit: number): HookFunction<T[], T[]> {\r\n    return (data: T[]) => {\r\n      if (Array.isArray(data)) {\r\n        return data.slice(0, limit);\r\n      }\r\n      return data;\r\n    };\r\n  },\r\n\r\n  /**\r\n   * Хук для добавления метаданных\r\n   * @param metadata - Метаданные для добавления\r\n   * @returns Хук добавления метаданных\r\n   */\r\n  addMetadata<T extends Record<string, any>>(metadata: Record<string, any>): HookFunction<T[], Array<T & { _metadata: any }>> {\r\n    return (data: T[], context?: HookContext) => {\r\n      if (Array.isArray(data)) {\r\n        return data.map(item => ({\r\n          ...item,\r\n          _metadata: {\r\n            ...metadata,\r\n            timestamp: new Date().toISOString(),\r\n            context\r\n          }\r\n        })) as Array<T & { _metadata: any }>;\r\n      }\r\n      return data as any;\r\n    };\r\n  },\r\n\r\n  /**\r\n   * Хук для преобразования ключей\r\n   * @param keyTransformer - Функция преобразования ключей\r\n   * @returns Хук преобразования ключей\r\n   */\r\n  transformKeys<T extends Record<string, any>>(keyTransformer: (key: string) => string): HookFunction<T[], Array<Record<string, any>>> {\r\n    return (data: T[]) => {\r\n      if (Array.isArray(data)) {\r\n        return data.map(item => {\r\n          const transformed: Record<string, any> = {};\r\n          for (const [key, value] of Object.entries(item)) {\r\n            transformed[keyTransformer(key)] = value;\r\n          }\r\n          return transformed;\r\n        });\r\n      }\r\n      return data;\r\n    };\r\n  },\r\n\r\n  /**\r\n   * Хук для преобразования значений\r\n   * @param valueTransformer - Функция преобразования значений\r\n   * @returns Хук преобразования значений\r\n   */\r\n  transformValues<T extends Record<string, any>>(valueTransformer: (value: any, key: string) => any): HookFunction<T[], Array<Record<string, any>>> {\r\n    return (data: T[]) => {\r\n      if (Array.isArray(data)) {\r\n        return data.map(item => {\r\n          const transformed: Record<string, any> = {};\r\n          for (const [key, value] of Object.entries(item)) {\r\n            transformed[key] = valueTransformer(value, key);\r\n          }\r\n          return transformed;\r\n        });\r\n      }\r\n      return data;\r\n    };\r\n  },\r\n\r\n  /**\r\n   * Хук для валидации данных\r\n   * @param validator - Функция валидации\r\n   * @param onError - Обработчик ошибки\r\n   * @returns Хук валидации\r\n   */\r\n  validate<T>(validator: (item: T, index: number) => boolean, onError: (errors: any[] | string, details?: any[]) => void = console.error): HookFunction<T[], T[]> {\n    return (data: T[]) => {\n      if (Array.isArray(data)) {\n        const validData: T[] = [];\n        const errors: any[] = [];\n\r\n        data.forEach((item, index) => {\r\n          try {\r\n            const isValid = validator(item, index);\r\n            if (isValid) {\r\n              validData.push(item);\r\n            } else {\r\n              errors.push({ index, item, reason: 'Validation failed' });\r\n            }\r\n          } catch (error: any) {\r\n            errors.push({ index, item, error: error.message });\r\n          }\r\n        });\r\n\r\n        if (errors.length > 0) {\n          if (onError.length >= 2) {\n            onError('Validation errors', errors);\n          } else {\n            onError(errors);\n          }\n        }\n\r\n        return validData;\r\n      }\r\n      return data;\r\n    };\r\n  },\r\n\r\n  /**\r\n   * Асинхронный хук для валидации данных\r\n   * @param validator - Асинхронная функция валидации\r\n   * @param onError - Обработчик ошибки\r\n   * @returns Асинхронный хук валидации\r\n   */\r\n  validateAsync<T>(validator: (item: T, index: number) => Promise<boolean>, onError: (errors: any[] | string, details?: any[]) => void = console.error): AsyncHookFunction<T[], T[]> {\n    return async (data: T[]) => {\r\n      if (Array.isArray(data)) {\r\n        const validData: T[] = [];\r\n        const errors: any[] = [];\r\n\r\n        for (let i = 0; i < data.length; i++) {\r\n          try {\r\n            const isValid = await validator(data[i], i);\r\n            if (isValid) {\r\n              validData.push(data[i]);\r\n            } else {\r\n              errors.push({ index: i, item: data[i], reason: 'Validation failed' });\r\n            }\r\n          } catch (error: any) {\r\n            errors.push({ index: i, item: data[i], error: error.message });\r\n          }\r\n        }\r\n\r\n        if (errors.length > 0) {\n          if (onError.length >= 2) {\n            onError('Validation errors', errors);\n          } else {\n            onError(errors);\n          }\n        }\n\r\n        return validData;\r\n      }\r\n      return data;\r\n    };\r\n  },\r\n\r\n  /**\r\n   * Хук для дедупликации данных\r\n   * @param keySelector - Функция выбора ключа\r\n   * @returns Хук дедупликации\r\n   */\r\n  deduplicate<T>(keySelector: (item: T) => string = JSON.stringify): HookFunction<T[], T[]> {\r\n    return (data: T[]) => {\r\n      if (Array.isArray(data)) {\r\n        const seen = new Set<string>();\r\n        return data.filter(item => {\r\n          const key = keySelector(item);\r\n          if (seen.has(key)) {\r\n            return false;\r\n          }\r\n          seen.add(key);\r\n          return true;\r\n        });\r\n      }\r\n      return data;\r\n    };\r\n  },\r\n\r\n  /**\r\n   * Асинхронный хук для дедупликации данных\r\n   * @param keySelector - Асинхронная функция выбора ключа\r\n   * @returns Асинхронный хук дедупликации\r\n   */\r\n  deduplicateAsync<T>(keySelector: (item: T) => Promise<string> = async (item) => JSON.stringify(item)): AsyncHookFunction<T[], T[]> {\r\n    return async (data: T[]) => {\r\n      if (Array.isArray(data)) {\r\n        const seen = new Set<string>();\r\n        const filtered: T[] = [];\r\n        \r\n        for (const item of data) {\r\n          const key = await keySelector(item);\r\n          if (!seen.has(key)) {\r\n            seen.add(key);\r\n            filtered.push(item);\r\n          }\r\n        }\r\n        \r\n        return filtered;\r\n      }\r\n      return data;\r\n    };\r\n  }\r\n};\r\n"]}

package/dist/src/engines/fast-path-engine-new.js

@@ -0,0 +1,262 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class FastPathEngine {
+    constructor() {
+        this.compilers = new Map();
+        this.stats = {
+            simpleParserCount: 0,
+            quoteAwareParserCount: 0,
+            standardParserCount: 0,
+            cacheHits: 0,
+            cacheMisses: 0
+        };
+    }
+    analyzeStructure(sample, options = {}) {
+        const delimiter = options.delimiter || this._detectDelimiter(sample);
+        const lines = sample.split('\n').slice(0, 10);
+        let hasQuotes = false;
+        let hasNewlinesInFields = false;
+        let hasEscapedQuotes = false;
+        let maxFields = 0;
+        let totalFields = 0;
+        for (const line of lines) {
+            if (line.includes('"')) {
+                hasQuotes = true;
+                if (line.includes('""')) {
+                    hasEscapedQuotes = true;
+                }
+            }
+            const quoteCount = (line.match(/"/g) || []).length;
+            if (quoteCount % 2 !== 0) {
+                hasNewlinesInFields = true;
+            }
+            const fieldCount = line.split(delimiter).length;
+            totalFields += fieldCount;
+            if (fieldCount > maxFields) {
+                maxFields = fieldCount;
+            }
+        }
+        const avgFieldsPerLine = totalFields / lines.length;
+        const fieldConsistency = maxFields === avgFieldsPerLine;
+        return {
+            delimiter,
+            hasQuotes,
+            hasEscapedQuotes,
+            hasNewlinesInFields,
+            fieldConsistency,
+            avgFieldsPerLine,
+            maxFields,
+            recommendedEngine: this._selectEngine(hasQuotes, hasNewlinesInFields, fieldConsistency)
+        };
+    }
+    _detectDelimiter(sample) {
+        const candidates = [',', ';', '\t', '|'];
+        const firstLine = sample.split('\n')[0];
+        let bestDelimiter = ',';
+        let bestScore = 0;
+        for (const delimiter of candidates) {
+            const fields = firstLine.split(delimiter);
+            const score = fields.length;
+            const avgLength = fields.reduce((sum, field) => sum + field.length, 0) / fields.length;
+            const variance = fields.reduce((sum, field) => sum + Math.pow(field.length - avgLength, 2), 0) / fields.length;
+            const finalScore = score / (variance + 1);
+            if (finalScore > bestScore) {
+                bestScore = finalScore;
+                bestDelimiter = delimiter;
+            }
+        }
+        return bestDelimiter;
+    }
+    _selectEngine(hasQuotes, hasNewlinesInFields, fieldConsistency) {
+        if (!hasQuotes && !hasNewlinesInFields && fieldConsistency) {
+            return 'SIMPLE';
+        }
+        if (hasQuotes && !hasNewlinesInFields) {
+            return 'QUOTE_AWARE';
+        }
+        return 'STANDARD';
+    }
+    compileParser(structure) {
+        const cacheKey = JSON.stringify(structure);
+        if (this.compilers.has(cacheKey)) {
+            this.stats.cacheHits++;
+            return this.compilers.get(cacheKey);
+        }
+        this.stats.cacheMisses++;
+        let parser;
+        switch (structure.recommendedEngine) {
+            case 'SIMPLE':
+                parser = this._createSimpleParser(structure);
+                this.stats.simpleParserCount++;
+                break;
+            case 'QUOTE_AWARE':
+                parser = this._createQuoteAwareParser(structure);
+                this.stats.quoteAwareParserCount++;
+                break;
+            default:
+                parser = this._createStandardParser(structure);
+                this.stats.standardParserCount++;
+        }
+        this.compilers.set(cacheKey, parser);
+        return parser;
+    }
+    _createSimpleParser(structure) {
+        const { delimiter } = structure;
+        return (csv) => {
+            const rows = [];
+            const lines = csv.split('\n');
+            for (const line of lines) {
+                if (line.trim() === '') {
+                    continue;
+                }
+                const fields = line.split(delimiter).map(field => field.trim());
+                if (fields.length > 0 && fields.some(field => field !== '')) {
+                    rows.push(fields);
+                }
+            }
+            return rows;
+        };
+    }
+    _createQuoteAwareParser(structure) {
+        const { delimiter, hasEscapedQuotes } = structure;
+        return (csv) => {
+            const rows = [];
+            let currentRow = [];
+            let currentField = '';
+            let insideQuotes = false;
+            let i = 0;
+            while (i < csv.length) {
+                const char = csv[i];
+                const nextChar = csv[i + 1];
+                if (char === '"') {
+                    if (insideQuotes) {
+                        if (nextChar === '"' && hasEscapedQuotes) {
+                            currentField += '"';
+                            i += 2;
+                        }
+                        else {
+                            insideQuotes = false;
+                            i++;
+                        }
+                    }
+                    else {
+                        insideQuotes = true;
+                        i++;
+                    }
+                }
+                else if (char === delimiter && !insideQuotes) {
+                    currentRow.push(currentField);
+                    currentField = '';
+                    i++;
+                }
+                else if ((char === '\n' || (char === '\r' && nextChar === '\n')) && !insideQuotes) {
+                    currentRow.push(currentField);
+                    if (currentRow.length > 0 && currentRow.some(field => field !== '')) {
+                        rows.push(currentRow);
+                    }
+                    currentRow = [];
+                    currentField = '';
+                    i += (char === '\r' && nextChar === '\n') ? 2 : 1;
+                }
+                else {
+                    currentField += char;
+                    i++;
+                }
+            }
+            if (currentField !== '' || currentRow.length > 0) {
+                currentRow.push(currentField);
+                if (currentRow.length > 0 && currentRow.some(field => field !== '')) {
+                    rows.push(currentRow);
+                }
+            }
+            return rows;
+        };
+    }
+    _createStandardParser(structure) {
+        const { delimiter } = structure;
+        return (csv) => {
+            const rows = [];
+            const lines = csv.split('\n');
+            let insideQuotes = false;
+            let currentLine = '';
+            for (const line of lines) {
+                const quoteCount = (line.match(/"/g) || []).length;
+                if (insideQuotes) {
+                    currentLine += '\n' + line;
+                    if (quoteCount % 2 !== 0) {
+                        insideQuotes = false;
+                        rows.push(this._parseLineWithQuotes(currentLine, delimiter));
+                        currentLine = '';
+                    }
+                }
+                else {
+                    if (quoteCount % 2 !== 0) {
+                        insideQuotes = true;
+                        currentLine = line;
+                    }
+                    else {
+                        rows.push(this._parseLineWithQuotes(line, delimiter));
+                    }
+                }
+            }
+            return rows;
+        };
+    }
+    _parseLineWithQuotes(line, delimiter) {
+        const fields = [];
+        let currentField = '';
+        let insideQuotes = false;
+        let i = 0;
+        while (i < line.length) {
+            const char = line[i];
+            const nextChar = line[i + 1];
+            if (char === '"') {
+                if (insideQuotes && nextChar === '"') {
+                    currentField += '"';
+                    i += 2;
+                }
+                else {
+                    insideQuotes = !insideQuotes;
+                    i++;
+                }
+            }
+            else if (char === delimiter && !insideQuotes) {
+                fields.push(currentField);
+                currentField = '';
+                i++;
+            }
+            else {
+                currentField += char;
+                i++;
+            }
+        }
+        fields.push(currentField);
+        return fields;
+    }
+    parse(csv, options = {}) {
+        const sampleSize = Math.min(1000, csv.length);
+        const sample = csv.substring(0, sampleSize);
+        const structure = this.analyzeStructure(sample, options);
+        const parser = this.compileParser(structure);
+        return parser(csv);
+    }
+    getStats() {
+        return {
+            ...this.stats,
+            totalParsers: this.compilers.size,
+            hitRate: this.stats.cacheHits / (this.stats.cacheHits + this.stats.cacheMisses) || 0
+        };
+    }
+    reset() {
+        this.compilers.clear();
+        this.stats = {
+            simpleParserCount: 0,
+            quoteAwareParserCount: 0,
+            standardParserCount: 0,
+            cacheHits: 0,
+            cacheMisses: 0
+        };
+    }
+}
+exports.default = FastPathEngine;
+//# sourceMappingURL=fast-path-engine-new.js.map