@gzl10/ts-helpers 4.2.1

package/dist/node-esm/chunk-XAEYT23H.js

@@ -0,0 +1,164 @@
+import {
+  __export
+} from "./chunk-PZ5AY32C.js";
+
+// src/node/validation-crypto.ts
+var validation_crypto_exports = {};
+__export(validation_crypto_exports, {
+  escapeShellCommand: () => escapeShellCommand,
+  generateNonce: () => generateNonce,
+  generateSecureToken: () => generateSecureToken,
+  hashString: () => hashString,
+  isSecureUrl: () => isSecureUrl,
+  isValidBase64: () => isValidBase64,
+  isValidJWTFormat: () => isValidJWTFormat,
+  removeDangerousChars: () => removeDangerousChars,
+  sanitizeHtml: () => sanitizeHtml,
+  validatePassword: () => validatePassword
+});
+import { createHash, randomBytes } from "crypto";
+var validatePassword = (password, criteria = {}) => {
+  const {
+    minLength = 8,
+    requireUppercase = true,
+    requireLowercase = true,
+    requireNumbers = true,
+    requireSpecialChars = true,
+    maxLength = 128,
+    forbiddenPatterns = []
+  } = criteria;
+  const errors = [];
+  let score = 0;
+  if (password.length < minLength) {
+    errors.push(`La contrase\xF1a debe tener al menos ${minLength} caracteres`);
+  } else {
+    score += 20;
+  }
+  if (password.length > maxLength) {
+    errors.push(`La contrase\xF1a no puede tener m\xE1s de ${maxLength} caracteres`);
+  }
+  if (requireUppercase && !/[A-Z]/.test(password)) {
+    errors.push("La contrase\xF1a debe contener al menos una letra may\xFAscula");
+  } else if (/[A-Z]/.test(password)) {
+    score += 15;
+  }
+  if (requireLowercase && !/[a-z]/.test(password)) {
+    errors.push("La contrase\xF1a debe contener al menos una letra min\xFAscula");
+  } else if (/[a-z]/.test(password)) {
+    score += 15;
+  }
+  if (requireNumbers && !/\d/.test(password)) {
+    errors.push("La contrase\xF1a debe contener al menos un n\xFAmero");
+  } else if (/\d/.test(password)) {
+    score += 15;
+  }
+  if (requireSpecialChars && !/[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]/.test(password)) {
+    errors.push("La contrase\xF1a debe contener al menos un caracter especial");
+  } else if (/[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]/.test(password)) {
+    score += 15;
+  }
+  for (const pattern of forbiddenPatterns) {
+    if (password.toLowerCase().includes(pattern.toLowerCase())) {
+      errors.push(`La contrase\xF1a no puede contener: ${pattern}`);
+    }
+  }
+  if (password.length >= 12) score += 10;
+  if (password.length >= 16) score += 10;
+  if (/(.)\\1{2,}/.test(password)) score -= 10;
+  if (/123|abc|qwe/i.test(password)) score -= 15;
+  score = Math.max(0, Math.min(100, score));
+  let strength;
+  if (score < 30) strength = "weak";
+  else if (score < 60) strength = "fair";
+  else if (score < 80) strength = "good";
+  else strength = "strong";
+  return {
+    isValid: errors.length === 0,
+    errors,
+    strength,
+    score
+  };
+};
+var sanitizeHtml = (html) => {
+  if (!html) return "";
+  let sanitized = html.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, "").replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, "");
+  sanitized = sanitized.replace(/ on\w+="[^"]*"/gi, "");
+  sanitized = sanitized.replace(/ on\w+='[^']*'/gi, "");
+  sanitized = sanitized.replace(/javascript:/gi, "");
+  sanitized = sanitized.replace(/<iframe\b[^<]*(?:(?!<\/iframe>)<[^<]*)*<\/iframe>/gi, "");
+  sanitized = sanitized.replace(/<object\b[^<]*(?:(?!<\/object>)<[^<]*)*<\/object>/gi, "");
+  sanitized = sanitized.replace(/<embed\b[^>]*>/gi, "");
+  return sanitized.trim();
+};
+var isValidJWTFormat = (token) => {
+  if (!token || typeof token !== "string") return false;
+  const parts = token.split(".");
+  if (parts.length !== 3) return false;
+  try {
+    for (const part of parts) {
+      if (!part || !/^[A-Za-z0-9_-]+$/.test(part)) return false;
+      atob(part.replace(/-/g, "+").replace(/_/g, "/"));
+    }
+    return true;
+  } catch {
+    return false;
+  }
+};
+var hashString = (input, salt = "") => {
+  return createHash("sha256").update(input + salt).digest("hex");
+};
+var generateSecureToken = (length = 32) => {
+  return randomBytes(length).toString("hex");
+};
+var isValidBase64 = (input) => {
+  if (!input || typeof input !== "string") return false;
+  if (!/^[A-Za-z0-9+/]*={0,2}$/.test(input)) return false;
+  try {
+    const decoded = atob(input);
+    const reencoded = btoa(decoded);
+    return reencoded === input;
+  } catch {
+    return false;
+  }
+};
+var escapeShellCommand = (input) => {
+  if (!input) return "";
+  return input.replace(/\\/g, "\\\\").replace(/'/g, "\\'").replace(/"/g, '\\"').replace(/;/g, "\\;").replace(/&/g, "\\&").replace(/\|/g, "\\|").replace(/`/g, "\\`").replace(/\$/g, "\\$").replace(/\(/g, "\\(").replace(/\)/g, "\\)").replace(/</g, "\\\\<").replace(/>/g, "\\\\>");
+};
+var isSecureUrl = (url) => {
+  if (!url || typeof url !== "string") return false;
+  try {
+    const parsed = new URL(url);
+    return parsed.protocol === "https:" || parsed.protocol === "http:" && (parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1");
+  } catch {
+    return false;
+  }
+};
+var removeDangerousChars = (input, replacement = "") => {
+  if (!input) return "";
+  return input.replace(/[<>]/g, replacement).replace(/['"]/g, replacement).replace(/[&]/g, replacement).replace(/[\\x00-\\x1f\\x7f]/g, replacement);
+};
+var generateNonce = (length = 32) => {
+  const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+  let result = "";
+  const bytes = randomBytes(length);
+  for (let i = 0; i < length; i++) {
+    result += chars[bytes[i] % chars.length];
+  }
+  return result;
+};
+
+export {
+  validatePassword,
+  sanitizeHtml,
+  isValidJWTFormat,
+  hashString,
+  generateSecureToken,
+  isValidBase64,
+  escapeShellCommand,
+  isSecureUrl,
+  removeDangerousChars,
+  generateNonce,
+  validation_crypto_exports
+};
+//# sourceMappingURL=chunk-XAEYT23H.js.map

package/dist/node-esm/chunk-XAEYT23H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/node/validation-crypto.ts"],"sourcesContent":["/**\n * Node.js-specific validation utilities with crypto support\n * Uses Node.js crypto module for secure operations\n */\n\n/* eslint-disable complexity */\n\nimport { createHash, randomBytes } from 'crypto'\n\n// =============================================================================\n// PASSWORD VALIDATION (Node.js with crypto)\n// =============================================================================\n\nexport interface PasswordCriteria {\n  minLength?: number\n  requireUppercase?: boolean\n  requireLowercase?: boolean\n  requireNumbers?: boolean\n  requireSpecialChars?: boolean\n  maxLength?: number\n  forbiddenPatterns?: string[]\n}\n\nexport interface PasswordValidationResult {\n  isValid: boolean\n  errors: string[]\n  strength: 'weak' | 'fair' | 'good' | 'strong'\n  score: number // 0-100\n}\n\nexport const validatePassword = (\n  password: string,\n  criteria: PasswordCriteria = {}\n): PasswordValidationResult => {\n  const {\n    minLength = 8,\n    requireUppercase = true,\n    requireLowercase = true,\n    requireNumbers = true,\n    requireSpecialChars = true,\n    maxLength = 128,\n    forbiddenPatterns = [],\n  } = criteria\n\n  const errors: string[] = []\n  let score = 0\n\n  if (password.length < minLength) {\n    errors.push(`La contraseña debe tener al menos ${minLength} caracteres`)\n  } else {\n    score += 20\n  }\n\n  if (password.length > maxLength) {\n    errors.push(`La contraseña no puede tener más de ${maxLength} caracteres`)\n  }\n\n  if (requireUppercase && !/[A-Z]/.test(password)) {\n    errors.push('La contraseña debe contener al menos una letra mayúscula')\n  } else if (/[A-Z]/.test(password)) {\n    score += 15\n  }\n\n  if (requireLowercase && !/[a-z]/.test(password)) {\n    errors.push('La contraseña debe contener al menos una letra minúscula')\n  } else if (/[a-z]/.test(password)) {\n    score += 15\n  }\n\n  if (requireNumbers && !/\\d/.test(password)) {\n    errors.push('La contraseña debe contener al menos un número')\n  } else if (/\\d/.test(password)) {\n    score += 15\n  }\n\n  if (requireSpecialChars && !/[!@#$%^&*()_+\\-=[\\]{};':\"\\\\|,.<>/?]/.test(password)) {\n    errors.push('La contraseña debe contener al menos un caracter especial')\n  } else if (/[!@#$%^&*()_+\\-=[\\]{};':\"\\\\|,.<>/?]/.test(password)) {\n    score += 15\n  }\n\n  for (const pattern of forbiddenPatterns) {\n    if (password.toLowerCase().includes(pattern.toLowerCase())) {\n      errors.push(`La contraseña no puede contener: ${pattern}`)\n    }\n  }\n\n  if (password.length >= 12) score += 10\n  if (password.length >= 16) score += 10\n\n  if (/(.)\\\\1{2,}/.test(password)) score -= 10\n  if (/123|abc|qwe/i.test(password)) score -= 15\n\n  score = Math.max(0, Math.min(100, score))\n\n  let strength: 'weak' | 'fair' | 'good' | 'strong'\n  if (score < 30) strength = 'weak'\n  else if (score < 60) strength = 'fair'\n  else if (score < 80) strength = 'good'\n  else strength = 'strong'\n\n  return {\n    isValid: errors.length === 0,\n    errors,\n    strength,\n    score,\n  }\n}\n\n// =============================================================================\n// SECURITY FUNCTIONS (Node.js crypto)\n// =============================================================================\n\nexport const sanitizeHtml = (html: string): string => {\n  if (!html) return ''\n\n  let sanitized = html\n    .replace(/<script\\b[^<]*(?:(?!<\\/script>)<[^<]*)*<\\/script>/gi, '')\n    .replace(/<style\\b[^<]*(?:(?!<\\/style>)<[^<]*)*<\\/style>/gi, '')\n\n  sanitized = sanitized.replace(/ on\\w+=\"[^\"]*\"/gi, '')\n  sanitized = sanitized.replace(/ on\\w+='[^']*'/gi, '')\n  sanitized = sanitized.replace(/javascript:/gi, '')\n  sanitized = sanitized.replace(/<iframe\\b[^<]*(?:(?!<\\/iframe>)<[^<]*)*<\\/iframe>/gi, '')\n  sanitized = sanitized.replace(/<object\\b[^<]*(?:(?!<\\/object>)<[^<]*)*<\\/object>/gi, '')\n  sanitized = sanitized.replace(/<embed\\b[^>]*>/gi, '')\n\n  return sanitized.trim()\n}\n\nexport const isValidJWTFormat = (token: string): boolean => {\n  if (!token || typeof token !== 'string') return false\n\n  const parts = token.split('.')\n  if (parts.length !== 3) return false\n\n  try {\n    for (const part of parts) {\n      if (!part || !/^[A-Za-z0-9_-]+$/.test(part)) return false\n      atob(part.replace(/-/g, '+').replace(/_/g, '/'))\n    }\n    return true\n  } catch {\n    return false\n  }\n}\n\nexport const hashString = (input: string, salt = ''): string => {\n  return createHash('sha256')\n    .update(input + salt)\n    .digest('hex')\n}\n\nexport const generateSecureToken = (length = 32): string => {\n  return randomBytes(length).toString('hex')\n}\n\nexport const isValidBase64 = (input: string): boolean => {\n  if (!input || typeof input !== 'string') return false\n\n  if (!/^[A-Za-z0-9+/]*={0,2}$/.test(input)) return false\n\n  try {\n    const decoded = atob(input)\n    const reencoded = btoa(decoded)\n    return reencoded === input\n  } catch {\n    return false\n  }\n}\n\nexport const escapeShellCommand = (input: string): string => {\n  if (!input) return ''\n\n  return input\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/'/g, \"\\\\'\")\n    .replace(/\"/g, '\\\\\"')\n    .replace(/;/g, '\\\\;')\n    .replace(/&/g, '\\\\&')\n    .replace(/\\|/g, '\\\\|')\n    .replace(/`/g, '\\\\`')\n    .replace(/\\$/g, '\\\\$')\n    .replace(/\\(/g, '\\\\(')\n    .replace(/\\)/g, '\\\\)')\n    .replace(/</g, '\\\\\\\\<')\n    .replace(/>/g, '\\\\\\\\>')\n}\n\nexport const isSecureUrl = (url: string): boolean => {\n  if (!url || typeof url !== 'string') return false\n\n  try {\n    const parsed = new URL(url)\n    return (\n      parsed.protocol === 'https:' ||\n      (parsed.protocol === 'http:' &&\n        (parsed.hostname === 'localhost' || parsed.hostname === '127.0.0.1'))\n    )\n  } catch {\n    return false\n  }\n}\n\nexport const removeDangerousChars = (input: string, replacement = ''): string => {\n  if (!input) return ''\n\n  return input\n    .replace(/[<>]/g, replacement)\n    .replace(/['\"]/g, replacement)\n    .replace(/[&]/g, replacement)\n    .replace(/[\\\\x00-\\\\x1f\\\\x7f]/g, replacement)\n}\n\nexport const generateNonce = (length = 32): string => {\n  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'\n  let result = ''\n\n  const bytes = randomBytes(length)\n  for (let i = 0; i < length; i++) {\n    result += chars[bytes[i] % chars.length]\n  }\n\n  return result\n}\n"],"mappings":"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","names":[]}

package/dist/node-esm/csv.js

@@ -0,0 +1,63 @@
+import {
+  isNode
+} from "./chunk-64TBXJQS.js";
+import "./chunk-PZ5AY32C.js";
+
+// src/csv.ts
+import Papa from "papaparse";
+async function exportCSV(data, filePath, options) {
+  if (data == null) {
+    throw new TypeError("Data cannot be null or undefined");
+  }
+  if (!Array.isArray(data)) {
+    throw new TypeError("Data must be an array");
+  }
+  if (data.length === 0) {
+    throw new Error("Data array cannot be empty");
+  }
+  if (!filePath || typeof filePath !== "string" || filePath.trim() === "") {
+    throw new TypeError("File path must be a non-empty string");
+  }
+  const csvText = Papa.unparse(data, {
+    delimiter: ";",
+    header: true,
+    ...options
+  });
+  if (isNode()) {
+    const fs = await import("fs/promises");
+    await fs.writeFile(filePath, `\uFEFF${csvText}`, { encoding: "utf-8" });
+  } else {
+    const blob = new Blob([`\uFEFF${csvText}`], { type: "text/csv;charset=utf-8" });
+    const url = URL.createObjectURL(blob);
+    const link = document.createElement("a");
+    link.href = url;
+    link.download = filePath.split("/").pop() || "data.csv";
+    document.body.appendChild(link);
+    link.click();
+    document.body.removeChild(link);
+    URL.revokeObjectURL(url);
+  }
+}
+async function importCSV(filePath, options) {
+  if (!filePath || typeof filePath !== "string" || filePath.trim() === "") {
+    throw new TypeError("File path must be a non-empty string");
+  }
+  if (isNode()) {
+    const fs = await import("fs/promises");
+    const content = await fs.readFile(filePath, { encoding: "utf-8" });
+    const parseResult = Papa.parse(content, {
+      header: true,
+      delimiter: ";",
+      skipEmptyLines: true,
+      ...options
+    });
+    return parseResult.data || [];
+  } else {
+    throw new Error("CSV import not supported in browser. Use readFileAsText() with a File object.");
+  }
+}
+export {
+  exportCSV,
+  importCSV
+};
+//# sourceMappingURL=csv.js.map

package/dist/node-esm/csv.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/csv.ts"],"sourcesContent":["/**\n * CSV Import/Export utilities\n *\n * Provides reliable CSV operations for both Node.js and Browser environments using PapaParse.\n * Features:\n * - UTF-8 BOM encoding for Excel compatibility\n * - Semicolon delimiter by default (European standard)\n * - Automatic header detection\n * - Dual-mode: filesystem (Node.js) vs download trigger (Browser)\n *\n * @module csv\n */\n\nimport Papa from 'papaparse'\nimport { isNode } from './environment'\n\n/**\n * Exports data as CSV file with UTF-8 BOM encoding\n *\n * Works in both Node.js (writes to filesystem) and Browser (triggers download).\n * Uses PapaParse library for reliable CSV generation with proper escaping and formatting.\n *\n * Features:\n * - UTF-8 BOM prepended (\\\\ufeff) for Excel compatibility\n * - Semicolon delimiter by default (European/Spanish standard)\n * - Automatic header row from object keys\n * - Custom delimiters and options via PapaParse config\n *\n * Environment behavior:\n * - **Node.js**: Writes file to filesystem at specified path\n * - **Browser**: Triggers automatic download with filename extracted from path\n *\n * @param data - Array of objects or array of arrays to export as CSV\n * @param filePath - File path (Node.js) or download filename (Browser)\n * @param options - PapaParse unparse options (optional)\n * @param options.delimiter - Column separator (default: ';' semicolon)\n * @param options.header - Include header row (default: true)\n * @param options.quotes - Quote all fields (default: false)\n * @param options.newline - Line ending (default: '\\\\r\\\\n')\n * @returns Promise that resolves when export completes\n *\n * @example\n * ```typescript\n * // Basic export - Array of objects\n * const users = [\n *   { name: 'Alice', age: 30, city: 'Madrid' },\n *   { name: 'Bob', age: 25, city: 'Barcelona' },\n *   { name: 'Carlos', age: 35, city: 'Valencia' }\n * ]\n *\n * // Node.js - Write to file\n * await exportCSV(users, './reports/users.csv')\n * // Creates: ./reports/users.csv with BOM and semicolon delimiter\n *\n * // Browser - Trigger download\n * await exportCSV(users, 'users.csv')\n * // Downloads: users.csv to browser's download folder\n *\n * // Custom delimiter (comma for international)\n * await exportCSV(users, 'users_intl.csv', { delimiter: ',' })\n * ```\n *\n * @example\n * ```typescript\n * // Array of arrays (no header auto-detection)\n * const matrix = [\n *   ['Name', 'Age', 'City'],       // Header row\n *   ['Alice', 30, 'Madrid'],\n *   ['Bob', 25, 'Barcelona']\n * ]\n * await exportCSV(matrix, 'matrix.csv')\n *\n * // Without header row\n * const data = [['A1', 'B1'], ['A2', 'B2']]\n * await exportCSV(data, 'no_header.csv', { header: false })\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Export sales report\n * async function exportSalesReport(sales: Sale[]) {\n *   const reportData = sales.map(sale => ({\n *     Fecha: formatDate(sale.date),\n *     Cliente: sale.customerName,\n *     Producto: sale.productName,\n *     Cantidad: sale.quantity,\n *     Total: `${sale.total.toFixed(2)}€`\n *   }))\n *\n *   const filename = `ventas_${new Date().toISOString().split('T')[0]}.csv`\n *   await exportCSV(reportData, filename)\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Custom PapaParse options\n * await exportCSV(data, 'quotes.csv', {\n *   delimiter: ',',\n *   quotes: true,        // Quote all fields\n *   quoteChar: '\"',\n *   escapeChar: '\"',\n *   newline: '\\\\n'       // Unix line endings\n * })\n * ```\n *\n * @throws {Error} If file write fails in Node.js\n * @see {@link importCSV} for importing CSV files\n * @see {@link https://www.papaparse.com/docs#unparse PapaParse Unparse Documentation}\n */\nexport async function exportCSV(data: any[], filePath: string, options?: any): Promise<void> {\n  // ✅ Input validation\n  if (data == null) {\n    throw new TypeError('Data cannot be null or undefined')\n  }\n\n  if (!Array.isArray(data)) {\n    throw new TypeError('Data must be an array')\n  }\n\n  if (data.length === 0) {\n    throw new Error('Data array cannot be empty')\n  }\n\n  if (!filePath || typeof filePath !== 'string' || filePath.trim() === '') {\n    throw new TypeError('File path must be a non-empty string')\n  }\n\n  const csvText = Papa.unparse(data, {\n    delimiter: ';',\n    header: true,\n    ...options,\n  })\n\n  if (isNode()) {\n    const fs = await import('fs/promises')\n    await fs.writeFile(filePath, `\\ufeff${csvText}`, { encoding: 'utf-8' })\n  } else {\n    const blob = new Blob([`\\ufeff${csvText}`], { type: 'text/csv;charset=utf-8' })\n    const url = URL.createObjectURL(blob)\n    const link = document.createElement('a')\n    link.href = url\n    link.download = filePath.split('/').pop() || 'data.csv'\n    document.body.appendChild(link)\n    link.click()\n    document.body.removeChild(link)\n    URL.revokeObjectURL(url)\n  }\n}\n\n/**\n * Imports CSV file and parses it to array of objects\n *\n * Reads CSV file from filesystem (Node.js only) and parses using PapaParse.\n * Automatically detects headers and converts rows to objects.\n *\n * Features:\n * - Automatic header detection from first row\n * - Semicolon delimiter by default (European standard)\n * - Empty line skipping\n * - Type inference for numbers and booleans\n * - UTF-8 BOM handling\n *\n * ⚠️ BROWSER LIMITATION: File reading from filesystem is not supported in browsers\n * for security reasons. For browser file uploads, use `readFileAsText()` with a File object\n * obtained from an input[type=\"file\"] element.\n *\n * @param filePath - Path to CSV file (Node.js only)\n * @param options - PapaParse parse options (optional)\n * @param options.delimiter - Column separator (default: ';' semicolon)\n * @param options.header - Parse first row as headers (default: true)\n * @param options.skipEmptyLines - Skip empty rows (default: true)\n * @param options.dynamicTyping - Convert numeric/boolean values (default: false)\n * @returns Promise<Array<Object>> Array of objects with keys from header row\n *\n * @example\n * ```typescript\n * // Basic import - Node.js only\n * const users = await importCSV('./data/users.csv')\n * // Returns: [\n * //   { name: 'Alice', age: '30', city: 'Madrid' },\n * //   { name: 'Bob', age: '25', city: 'Barcelona' }\n * // ]\n *\n * // Custom delimiter (comma)\n * const intlData = await importCSV('./data/users_intl.csv', {\n *   delimiter: ','\n * })\n *\n * // With type conversion\n * const typed = await importCSV('./data/sales.csv', {\n *   dynamicTyping: true  // Converts '123' → 123, 'true' → true\n * })\n * // Returns: { quantity: 10, total: 299.99, active: true }\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Import and process sales data\n * async function importSalesReport(filePath: string) {\n *   try {\n *     const sales = await importCSV(filePath, {\n *       delimiter: ';',\n *       dynamicTyping: true,\n *       skipEmptyLines: true\n *     })\n *\n *     // Process imported data\n *     const totalSales = sales.reduce((sum, sale) =>\n *       sum + (sale.total || 0), 0\n *     )\n *\n *     console.log(`Imported ${sales.length} sales, total: €${totalSales}`)\n *     return sales\n *   } catch (error) {\n *     console.error('Failed to import CSV:', error)\n *     throw error\n *   }\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Browser alternative using File API\n * // HTML: <input type=\"file\" id=\"csvFile\" accept=\".csv\">\n *\n * document.getElementById('csvFile').addEventListener('change', async (e) => {\n *   const file = e.target.files[0]\n *\n *   // Read file content\n *   const content = await readFileAsText(file)\n *\n *   // Parse with PapaParse\n *   const parsed = Papa.parse(content, {\n *     header: true,\n *     delimiter: ';',\n *     skipEmptyLines: true\n *   })\n *\n *   const data = parsed.data\n *   console.log('Imported data:', data)\n * })\n * ```\n *\n * @example\n * ```typescript\n * // Handle parsing errors\n * const result = await importCSV('./malformed.csv')\n *   .catch(error => {\n *     if (error.message.includes('not supported in browser')) {\n *       console.error('Use File API for browser uploads')\n *     } else if (error.code === 'ENOENT') {\n *       console.error('File not found')\n *     } else {\n *       console.error('CSV parsing failed:', error)\n *     }\n *     return []  // Return empty array as fallback\n *   })\n * ```\n *\n * @throws {Error} 'CSV import not supported in browser' when called in browser environment\n * @throws {Error} File system errors (ENOENT, EACCES, etc.) in Node.js\n * @see {@link exportCSV} for exporting CSV files\n * @see {@link readFileAsText} for browser file reading\n * @see {@link https://www.papaparse.com/docs#parse PapaParse Parse Documentation}\n */\nexport async function importCSV(filePath: string, options?: any): Promise<any[]> {\n  // ✅ Input validation\n  if (!filePath || typeof filePath !== 'string' || filePath.trim() === '') {\n    throw new TypeError('File path must be a non-empty string')\n  }\n\n  if (isNode()) {\n    const fs = await import('fs/promises')\n    const content = await fs.readFile(filePath, { encoding: 'utf-8' })\n    const parseResult = Papa.parse(content, {\n      header: true,\n      delimiter: ';',\n      skipEmptyLines: true,\n      ...options,\n    }) as any\n    return parseResult.data || []\n  } else {\n    throw new Error('CSV import not supported in browser. Use readFileAsText() with a File object.')\n  }\n}\n"],"mappings":";;;;;;AAaA,OAAO,UAAU;AAiGjB,eAAsB,UAAU,MAAa,UAAkB,SAA8B;AAE3F,MAAI,QAAQ,MAAM;AAChB,UAAM,IAAI,UAAU,kCAAkC;AAAA,EACxD;AAEA,MAAI,CAAC,MAAM,QAAQ,IAAI,GAAG;AACxB,UAAM,IAAI,UAAU,uBAAuB;AAAA,EAC7C;AAEA,MAAI,KAAK,WAAW,GAAG;AACrB,UAAM,IAAI,MAAM,4BAA4B;AAAA,EAC9C;AAEA,MAAI,CAAC,YAAY,OAAO,aAAa,YAAY,SAAS,KAAK,MAAM,IAAI;AACvE,UAAM,IAAI,UAAU,sCAAsC;AAAA,EAC5D;AAEA,QAAM,UAAU,KAAK,QAAQ,MAAM;AAAA,IACjC,WAAW;AAAA,IACX,QAAQ;AAAA,IACR,GAAG;AAAA,EACL,CAAC;AAED,MAAI,OAAO,GAAG;AACZ,UAAM,KAAK,MAAM,OAAO,aAAa;AACrC,UAAM,GAAG,UAAU,UAAU,SAAS,OAAO,IAAI,EAAE,UAAU,QAAQ,CAAC;AAAA,EACxE,OAAO;AACL,UAAM,OAAO,IAAI,KAAK,CAAC,SAAS,OAAO,EAAE,GAAG,EAAE,MAAM,yBAAyB,CAAC;AAC9E,UAAM,MAAM,IAAI,gBAAgB,IAAI;AACpC,UAAM,OAAO,SAAS,cAAc,GAAG;AACvC,SAAK,OAAO;AACZ,SAAK,WAAW,SAAS,MAAM,GAAG,EAAE,IAAI,KAAK;AAC7C,aAAS,KAAK,YAAY,IAAI;AAC9B,SAAK,MAAM;AACX,aAAS,KAAK,YAAY,IAAI;AAC9B,QAAI,gBAAgB,GAAG;AAAA,EACzB;AACF;AAsHA,eAAsB,UAAU,UAAkB,SAA+B;AAE/E,MAAI,CAAC,YAAY,OAAO,aAAa,YAAY,SAAS,KAAK,MAAM,IAAI;AACvE,UAAM,IAAI,UAAU,sCAAsC;AAAA,EAC5D;AAEA,MAAI,OAAO,GAAG;AACZ,UAAM,KAAK,MAAM,OAAO,aAAa;AACrC,UAAM,UAAU,MAAM,GAAG,SAAS,UAAU,EAAE,UAAU,QAAQ,CAAC;AACjE,UAAM,cAAc,KAAK,MAAM,SAAS;AAAA,MACtC,QAAQ;AAAA,MACR,WAAW;AAAA,MACX,gBAAgB;AAAA,MAChB,GAAG;AAAA,IACL,CAAC;AACD,WAAO,YAAY,QAAQ,CAAC;AAAA,EAC9B,OAAO;AACL,UAAM,IAAI,MAAM,+EAA+E;AAAA,EACjG;AACF;","names":[]}

package/dist/node-esm/data.js

@@ -0,0 +1,32 @@
+import {
+  detectFileExtension,
+  detectFormatFromFilename,
+  detectUniversalFormat,
+  exportData,
+  exportTree,
+  exportTxt,
+  importData,
+  importTree,
+  importTxt,
+  readFileAsText,
+  validateCSVData,
+  validateExportData
+} from "./chunk-KBHE3K2F.js";
+import "./chunk-75XNTC34.js";
+import "./chunk-64TBXJQS.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  detectFileExtension,
+  detectFormatFromFilename,
+  detectUniversalFormat,
+  exportData,
+  exportTree,
+  exportTxt,
+  importData,
+  importTree,
+  importTxt,
+  readFileAsText,
+  validateCSVData,
+  validateExportData
+};
+//# sourceMappingURL=data.js.map

package/dist/node-esm/data.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/node-esm/dates.js

@@ -0,0 +1,78 @@
+import {
+  addDays,
+  addMonths,
+  addNowDays,
+  addNowMonths,
+  addNowSeconds,
+  addNowYears,
+  addSeconds,
+  addYears,
+  areDatesEqualWithTolerance,
+  dayOfWeek,
+  diffBusinessDays,
+  diffDays,
+  diffMilliSeconds,
+  diffMonths,
+  diffYears,
+  excelToDate,
+  format,
+  formatForMysql,
+  formatNow,
+  fromNow,
+  getFirstDayOfYear,
+  getFirstWorkdayAfterMonths,
+  getFirstWorkdayOfMonth,
+  getLastDayOfYear,
+  getLastWorkdayOfMonth,
+  isDateTime,
+  isEqualsDateTimeByDay,
+  isExpired,
+  isNew,
+  isWeekday,
+  longString,
+  now,
+  toDate,
+  toDateFromString,
+  toISO,
+  weekOfYear
+} from "./chunk-3YOF7NPT.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  addDays,
+  addMonths,
+  addNowDays,
+  addNowMonths,
+  addNowSeconds,
+  addNowYears,
+  addSeconds,
+  addYears,
+  areDatesEqualWithTolerance,
+  dayOfWeek,
+  diffBusinessDays,
+  diffDays,
+  diffMilliSeconds,
+  diffMonths,
+  diffYears,
+  excelToDate,
+  format,
+  formatForMysql,
+  formatNow,
+  fromNow,
+  getFirstDayOfYear,
+  getFirstWorkdayAfterMonths,
+  getFirstWorkdayOfMonth,
+  getLastDayOfYear,
+  getLastWorkdayOfMonth,
+  isDateTime,
+  isEqualsDateTimeByDay,
+  isExpired,
+  isNew,
+  isWeekday,
+  longString,
+  now,
+  toDate,
+  toDateFromString,
+  toISO,
+  weekOfYear
+};
+//# sourceMappingURL=dates.js.map

package/dist/node-esm/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/node-esm/environment.js

@@ -0,0 +1,34 @@
+import {
+  detectHostname,
+  detectProtocol,
+  getEnvironmentInfo,
+  isBrowser,
+  isBrowserEnvironment,
+  isDevelopment,
+  isLocalhost,
+  isNode,
+  isNodeEnvironment,
+  isNonProduction,
+  isPrivateIP,
+  isProduction,
+  isTest,
+  parseEnvValue
+} from "./chunk-64TBXJQS.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  detectHostname,
+  detectProtocol,
+  getEnvironmentInfo,
+  isBrowser,
+  isBrowserEnvironment,
+  isDevelopment,
+  isLocalhost,
+  isNode,
+  isNodeEnvironment,
+  isNonProduction,
+  isPrivateIP,
+  isProduction,
+  isTest,
+  parseEnvValue
+};
+//# sourceMappingURL=environment.js.map

package/dist/node-esm/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/node-esm/errors.js

@@ -0,0 +1,18 @@
+import {
+  DataError,
+  TsHelpersError,
+  TsHelpersErrorCode,
+  createCryptoError,
+  createMathError,
+  createValidationError
+} from "./chunk-75XNTC34.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  DataError,
+  TsHelpersError,
+  TsHelpersErrorCode,
+  createCryptoError,
+  createMathError,
+  createValidationError
+};
+//# sourceMappingURL=errors.js.map

package/dist/node-esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}