@gzl10/ts-helpers 4.2.1 → 4.2.2

package/README.md

@@ -4,230 +4,96 @@
 [![Pipeline Status](https://gitlab.gzl10.com/oss/ts-helpers/badges/main/pipeline.svg)](https://gitlab.gzl10.com/oss/ts-helpers/-/pipelines)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-**Librería universal de utilidades TypeScript certificada para todos los
-entornos JavaScript modernos.**
+Universal TypeScript utility library for modern JavaScript environments.
 
-🚀 **v4.1.0** - NUEVAS FUNCIONES: Manejo avanzado de configuración, parsing de
-env vars y manipulación de objetos anidados.
+## Features
 
-## 🌍 CERTIFICACIÓN UNIVERSAL v4.0.6
+- **Flat API**: Direct access to 150+ functions without nesting
+- **Universal**: Works in Node.js, browsers, Web Workers, and all bundlers
+- **Tree-shakeable**: Import only what you need for minimal bundles
+- **TypeScript-first**: Full type inference and strict mode
+- **Spanish validation**: NIF, NIE, CIF, IBAN, phone numbers, and more
 
-**@gzl10/ts-helpers** está **oficialmente certificada** como librería universal
-compatible con **todos los entornos JavaScript modernos**:
-
-### 🎯 Compatibilidad Total
-
-- ✅ **Navegadores modernos** (Chrome, Firefox, Safari, Edge)
-- ✅ **Node.js** (v18+) con funcionalidades completas
-- ✅ **Web Workers** y **Service Workers**
-- ✅ **Bundlers** (Webpack, Vite, Rollup, Parcel)
-- ✅ **Frameworks** (React, Vue, Angular, Svelte)
-
-### 🏗️ Builds Multi-Environment
-
-- **Universal Build**: 65.5KB CJS, 6.7KB ESM (crypto-free, browser-safe)
-- **Node.js Build**: 97.9KB CJS, 7.5KB ESM (crypto completo + operaciones de
-  archivo)
-- **Browser Build**: 7.4KB ESM (Web Crypto API + fallbacks seguros)
-
-### 🔒 Environment Guards
-
-- Detección automática de entorno (Node.js/Browser/Worker)
-- Fallbacks seguros para APIs no disponibles
-- Exports condicionales automáticos según entorno
-
-## ✨ Características v4.1.0
-
-### 🆕 Novedades v4.1.0
-
-- **⚙️ Configuración Avanzada**: Parsing de env vars, acceso a objetos anidados
-  con dot notation
-- **🔍 Path Matching**: Wildcards para configuración, routing y permisos
-  (`features.*`)
-- **🔄 Conversión Env Vars**: Transformación bidireccional env keys ↔ dot
-  notation paths
-- **✅ Validación Paths**: Validación robusta de paths en dot notation
-
-### v4.0.x Foundation
-
-- **🎯 API Plana Revolucionaria**: Acceso directo (`g.validateNIF()` vs
-  `g.validation.validators.validateNIF()`)
-- **⚡ Performance Extrema**: Build 70-90% más rápido (~40ms vs ~45s), bundle
-  69% menor (603KB→185KB)
-- **🌲 Tree-shaking Optimizado**: Importaciones específicas por módulo
-  preservadas
-- **📦 Arquitectura Consolidada**: 15 módulos exportados por dominio
-- **🔧 Tooling Moderno**: pnpm + changeset + vitest + tsup
-- **🌐 Environment Detection**: Detección avanzada Node.js/Browser con soporte
-  proxy
-- **🇪🇸 Validación Española**: 150+ funciones - NIF, NIE, CIF, teléfonos, IBAN
-- **📊 Manejo de Datos**: CSV, JSON, Tree con detección automática de formato
-- **📁 Detección Universal**: 80+ formatos con categorización inteligente
-- **✅ Testing Compatible**: Exports optimizados para Vitest y bundlers modernos
-- **📚 Documentación JSDoc 100%**: 80+ funciones con ejemplos profesionales y
-  casos de uso reales
-
-## Instalación
+## Installation
 
 ```bash
-# Con pnpm (recomendado)
 pnpm add @gzl10/ts-helpers
-
-# Con npm
+# or
 npm install @gzl10/ts-helpers
 ```
 
-## Uso
+## Usage
 
-### API Plana v4.0.0 (Recomendado)
+### Flat API (Recommended)
 
 ```typescript
 import g from '@gzl10/ts-helpers'
 
-// 🚀 API completamente plana - sin anidación
-g.validateNIF('12345678Z') // ✅ Validación española
-g.generateSpanishNIF() // ✅ Generadores
-g.toCamelCase('hello-world') // ✅ String manipulation
-g.calculateNPV([-1000, 300, 400]) // ✅ Matemáticas financieras
-g.sleep(1000) // ✅ Operaciones async
-g.exportData(data, 'file.csv') // ✅ Import/export datos
-g.deepEqual(obj1, obj2) // ✅ Comparación objetos
-g.formatNow('DD/MM/YYYY') // ✅ Fechas con dayjs
-
-// 🆕 v4.1.0 - Configuración y env vars
-g.parseEnvValue('true') // true (boolean)
-g.parseEnvValue('[1,2,3]') // [1,2,3] (array)
+// Validation
+g.validateNIF('12345678Z')
+g.generateSpanishNIF()
+
+// Strings
+g.toCamelCase('hello-world')
+g.sanitizeString('<script>alert("xss")</script>')
+
+// Math & Finance
+g.calculateNPV(0.1, [-1000, 300, 400, 500])
+g.calculateIRR([-1000, 300, 400, 500])
+
+// Async
+g.sleep(1000)
+g.runBatch(items, processFn, { concurrency: 5 })
+
+// Data
+g.exportData(data, 'file.csv')
+g.detectUniversalFormat('report.xlsx')
+
+// Objects
+g.deepEqual(obj1, obj2)
 g.setDeepValue(config, 'database.host', 'localhost')
-g.getDeepValue(config, 'database.port', 5432)
-g.matchPathPattern('features.auth', 'features.*') // true
-g.isValidDotNotationPath('db.host') // true
-g.envKeyToPath('NX_FEATURES_AUTH') // 'features.auth'
-g.pathToEnvKey('features.auth') // 'NX_FEATURES_AUTH'
-
-// 🆕 Detección de entorno mejorada (v4.2.0)
-g.isDevelopment() // true solo en development (excluye test)
-g.isTest() // true en tests (Vitest/Jest)
-g.isProduction() // true en producción
-g.isNonProduction() // true en dev, test, undefined
-g.detectProtocol(req) // 'https' con soporte proxy
-g.isLocalhost('localhost') // true
-console.log(g.isNode) // true en Node.js
-
-// Detección universal de formatos (80+ tipos)
-g.detectFileExtension('report.xlsx') // 'xlsx'
-g.detectUniversalFormat('presentation.pptx')
-// { extension: 'pptx', category: 'presentation', mimeType: '...', isText: false }
+
+// Dates
+g.formatNow('DD/MM/YYYY')
+g.addDays(new Date(), 7)
+
+// Environment
+g.isDevelopment()
+g.isProduction()
+g.detectProtocol(req)
 ```
 
-### Importaciones Específicas (Tree-shaking)
+### Tree-shaking Imports
 
 ```typescript
-// 🌲 Para bundles mínimos - importa solo lo que necesitas
 import { validateNIF, generateSpanishNIF } from '@gzl10/ts-helpers/validation'
 import { exportData, importData } from '@gzl10/ts-helpers/data'
-import { parseEnvValue } from '@gzl10/ts-helpers/environment'
-import { setDeepValue, getDeepValue } from '@gzl10/ts-helpers/objects'
-import {
-  matchPathPattern,
-  envKeyToPath,
-  pathToEnvKey,
-} from '@gzl10/ts-helpers/strings'
-import { isValidDotNotationPath } from '@gzl10/ts-helpers/validation'
 import { toCamelCase, sanitizeString } from '@gzl10/ts-helpers/strings'
 import { sleep, runBatch } from '@gzl10/ts-helpers/async'
 import { calculateNPV, calculateIRR } from '@gzl10/ts-helpers/math'
 import { formatNow, addDays } from '@gzl10/ts-helpers/dates'
-import { deepEqual, updateArrayElementsBy } from '@gzl10/ts-helpers/objects'
-import {
-  isDevelopment,
-  isTest,
-  isProduction,
-  isNonProduction,
-  detectProtocol,
-} from '@gzl10/ts-helpers/environment'
-import {
-  detectFileExtension,
-  detectUniversalFormat,
-} from '@gzl10/ts-helpers/data'
-```
-
-## 🔄 Migración
-
-### 🆕 v4.2.0 - Detección de entorno mejorada
-
-**⚠️ BREAKING CHANGE**: `isDevelopment()` ahora retorna `false` en entorno
-`test`
-
-```typescript
-// ❌ Antes (v4.1.0)
-if (isDevelopment()) {
-  // Se ejecutaba en dev Y test
-  enableDebugMode()
-}
-
-// ✅ Ahora (v4.2.0) - Opciones según necesidad
-if (isDevelopment()) {
-  // Solo en development (excluye test)
-  enableHotReload()
-}
-
-if (isTest()) {
-  // Solo en tests
-  mockExternalAPIs()
-}
-
-if (isNonProduction()) {
-  // En dev, test y undefined (comportamiento anterior de isDevelopment)
-  enableDebugMode()
-}
-```
-
-### 🔄 Migración desde v3.x
-
-**BREAKING CHANGES v4.0.0**
-
-```typescript
-// ❌ v3.x - API anidada redundante
-g.validation.validators.validateNIF('12345678Z')
-g.primitives.string.toCamelCase('hello-world')
-g.core.async.sleep(1000)
-
-// ✅ v4.0.0 - API plana directa
-g.validateNIF('12345678Z')
-g.toCamelCase('hello-world')
-g.sleep(1000)
-```
-
-**Dependencias Eliminadas**
-
-Las re-exportaciones fueron eliminadas. Instala por separado si las necesitas:
-
-```bash
-npm install lodash axios dayjs numeral qs ms
+import { deepEqual, setDeepValue } from '@gzl10/ts-helpers/objects'
+import { isDevelopment, isProduction } from '@gzl10/ts-helpers/environment'
 ```
 
-## 📚 Documentación
+## Documentation
 
-- **[USAGE-GUIDE.md](USAGE-GUIDE.md)** - 📖 Guía técnica completa con 150+
-  funciones
-- **[CHANGELOG.md](CHANGELOG.md)** - 📝 Historial de cambios detallado
-- **[GitLab Issues](https://gitlab.gzl10.com/oss/ts-helpers/-/issues)** - 🐛
-  Reportar bugs
+- **[USAGE-GUIDE.md](USAGE-GUIDE.md)** - Complete API reference
+- **[CHANGELOG.md](CHANGELOG.md)** - Version history
 
-## 🛠️ Desarrollo
+## Development
 
 ```bash
-pnpm install              # Instalar dependencias
-pnpm run build            # Build (~40ms)
-pnpm test                 # 600+ tests
-pnpm run quality          # lint + format + build
-pnpm release:prepare      # Changeset
+pnpm install
+pnpm build
+pnpm test
+pnpm lint
 ```
 
-## ☕ Support
+## Support
 
 <a href="https://www.buymeacoffee.com/gzl10g" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>
 
-## 📄 Licencia
+## License
 
 MIT © [Gonzalo Díez](mailto:gonzalo@gzl10.com)

package/dist/types/environment-detection.d.ts

@@ -96,7 +96,7 @@ declare const getCryptoCapabilities: () => {
     webCrypto: boolean;
     nodeCrypto: boolean;
     fallbackOnly: boolean;
-    environment: "node" | "browser" | "worker" | "unknown";
+    environment: "browser" | "node" | "unknown" | "worker";
 };
 
 export { getCryptoCapabilities, getEnvironmentType, isBrowserEnv, isNodeCryptoAvailable, isNodeEnv, isWebCryptoAvailable, isWorkerEnvironment };

package/dist/types/index.d.ts

@@ -26,7 +26,7 @@ declare const g: {
         webCrypto: boolean;
         nodeCrypto: boolean;
         fallbackOnly: boolean;
-        environment: "node" | "browser" | "worker" | "unknown";
+        environment: "browser" | "node" | "unknown" | "worker";
     };
     isNodeEnvironment(): boolean;
     isBrowserEnvironment(): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gzl10/ts-helpers",
-  "version": "4.2.1",
+  "version": "4.2.2",
   "description": "Librería de utilidades TypeScript con herramientas especializadas para desarrollo web, validación española, manejo de datos y operaciones asíncronas.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -149,12 +149,15 @@
     "./package.json": "./package.json",
     "./dist/*": "./dist/*"
   },
-  "author": "Gonzalo Díez<gonzalo@gzl10.com>",
+  "author": {
+    "name": "Gonzalo Díez",
+    "email": "gonzalo@gzl10.com"
+  },
   "repository": {
     "type": "git",
     "url": "https://gitlab.gzl10.com/oss/ts-helpers.git"
   },
-  "homepage": "https://gitlab.gzl10.com/oss/ts-helpers",
+  "homepage": "https://www.gzl10.com",
   "bugs": {
     "url": "https://gitlab.gzl10.com/oss/ts-helpers/-/issues"
   },