@gzl10/ts-helpers 4.2.1

package/dist/esm/chunk-ZFVYLUTT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/async.ts"],"sourcesContent":["/**\n * Asynchronous utilities and operations\n * Consolidated from core/async module\n */\n\n/* eslint-disable no-await-in-loop */\n\nimport { TsHelpersError, TsHelpersErrorCode } from './errors'\n\n// =============================================================================\n// DELAY UTILITIES\n// =============================================================================\n\n/**\n * Creates an asynchronous delay for the specified number of milliseconds\n *\n * Pauses async execution without blocking the event loop. Uses Promise with setTimeout\n * internally to schedule resumption after the specified delay.\n *\n * Common use cases:\n * - Rate limiting API calls\n * - Retry delays with exponential backoff\n * - Animation/transition timing\n * - Polling intervals\n * - Debouncing operations\n *\n * @param ms - Milliseconds to sleep (delay duration)\n * @returns Promise that resolves after the specified delay\n *\n * @example\n * ```typescript\n * // Basic delay\n * console.log('Starting...')\n * await sleep(2000)  // Wait 2 seconds\n * console.log('Done!')\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Rate-limited API calls\n * async function fetchAllUsers(userIds: string[]): Promise<User[]> {\n *   const users: User[] = []\n *\n *   for (const id of userIds) {\n *     const user = await api.getUser(id)\n *     users.push(user)\n *\n *     // Rate limit: 100ms between requests (max 10 req/sec)\n *     await sleep(100)\n *   }\n *\n *   return users\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Exponential backoff retry\n * async function fetchWithRetry(url: string, maxRetries = 3): Promise<Response> {\n *   let lastError: Error | null = null\n *\n *   for (let attempt = 0; attempt < maxRetries; attempt++) {\n *     try {\n *       return await fetch(url)\n *     } catch (error) {\n *       lastError = error as Error\n *       const delay = Math.pow(2, attempt) * 1000  // 1s, 2s, 4s\n *       console.log(`Retry ${attempt + 1}/${maxRetries} in ${delay}ms`)\n *       await sleep(delay)\n *     }\n *   }\n *\n *   throw lastError\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Polling with timeout\n * async function pollUntilReady(\n *   checkFn: () => Promise<boolean>,\n *   timeoutMs = 30000\n * ): Promise<boolean> {\n *   const startTime = Date.now()\n *\n *   while (Date.now() - startTime < timeoutMs) {\n *     if (await checkFn()) {\n *       return true\n *     }\n *     await sleep(1000)  // Poll every second\n *   }\n *\n *   throw new Error('Timeout waiting for ready state')\n * }\n *\n * // Usage: Wait for service to be ready\n * await pollUntilReady(async () => {\n *   const response = await fetch('/health')\n *   return response.ok\n * })\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Animated progress bar\n * async function animateProgress(element: HTMLElement): Promise<void> {\n *   for (let i = 0; i <= 100; i += 5) {\n *     element.style.width = `${i}%`\n *     await sleep(50)  // 50ms per step = 1 second total\n *   }\n * }\n * ```\n *\n * @see {@link wait} for alias with same functionality\n * @see {@link runBatch} for controlled concurrent execution\n */\nexport const sleep = (ms: number): Promise<void> => {\n  return new Promise(resolve => setTimeout(resolve, ms))\n}\n\n/**\n * Simple alias for sleep - Pauses execution for specified milliseconds\n *\n * Identical to {@link sleep}, provided for semantic clarity in code.\n * Use `wait` when the context emphasizes waiting for a condition or event.\n *\n * @param ms - Milliseconds to wait\n * @returns Promise that resolves after the specified delay\n *\n * @example\n * ```typescript\n * // Semantically clearer in some contexts\n * await wait(1000)  // Wait 1 second before continuing\n *\n * // vs sleep (implies intentional delay)\n * await sleep(1000)  // Sleep for 1 second\n * ```\n *\n * @see {@link sleep} for full documentation and examples\n */\nexport const wait = (ms: number): Promise<void> => sleep(ms)\n\n// =============================================================================\n// BATCH PROCESSING\n// =============================================================================\n\n/**\n * Executes an array of Promises in batches to control concurrency\n *\n * Processes promises in sequential batches, waiting for each batch to complete before\n * starting the next. Prevents overwhelming systems with too many concurrent requests.\n *\n * Algorithm:\n * 1. Divide promises into batches of size `batchSize`\n * 2. Execute each batch with Promise.all (parallel within batch)\n * 3. Wait for batch completion before starting next batch\n * 4. Collect and return all results in original order\n *\n * Use cases:\n * - Rate-limited API calls (respect API quotas)\n * - Database bulk operations (avoid connection pool exhaustion)\n * - File system operations (prevent file descriptor limits)\n * - Memory-intensive operations (control memory usage)\n *\n * @param jobs - Array of Promises to execute\n * @param batchSize - Number of promises to execute concurrently per batch (default: 50)\n * @returns Promise resolving to array of all results in original order\n *\n * @example\n * ```typescript\n * // Basic batch processing\n * const urls = ['url1', 'url2', ..., 'url100']  // 100 URLs\n * const fetchPromises = urls.map(url => fetch(url))\n *\n * // Execute 10 at a time instead of all 100 simultaneously\n * const responses = await runBatch(fetchPromises, 10)\n * // Batch 1: urls 0-9 (parallel)\n * // Batch 2: urls 10-19 (parallel) - starts after batch 1 completes\n * // ... 10 batches total\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Bulk user data fetch respecting API rate limits\n * async function fetchUsersInBatches(userIds: string[]): Promise<User[]> {\n *   console.log(`Fetching ${userIds.length} users in batches of 20...`)\n *\n *   const fetchPromises = userIds.map(id =>\n *     fetch(`/api/users/${id}`).then(res => res.json())\n *   )\n *\n *   const users = await runBatch(fetchPromises, 20)\n *\n *   console.log(`✅ Fetched ${users.length} users`)\n *   return users\n * }\n *\n * // Fetches 1000 users: 50 batches of 20, not 1000 simultaneous requests\n * const allUsers = await fetchUsersInBatches(userIdArray)\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Database bulk insert with connection pool limits\n * async function bulkInsertUsers(users: User[]): Promise<void> {\n *   // Database pool has 10 connections, use batch size of 5 for safety\n *   const insertPromises = users.map(user =>\n *     db.query('INSERT INTO users VALUES ($1, $2)', [user.name, user.email])\n *   )\n *\n *   await runBatch(insertPromises, 5)\n *   console.log(`✅ Inserted ${users.length} users`)\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Image processing pipeline\n * async function processImages(imagePaths: string[]): Promise<Buffer[]> {\n *   console.log(`Processing ${imagePaths.length} images...`)\n *\n *   const processingPromises = imagePaths.map(async path => {\n *     const img = await loadImage(path)\n *     const resized = await resize(img, { width: 800, height: 600 })\n *     const compressed = await compress(resized, { quality: 80 })\n *     return compressed\n *   })\n *\n *   // Process 3 images at a time to avoid memory exhaustion\n *   const processed = await runBatch(processingPromises, 3)\n *\n *   console.log(`✅ Processed ${processed.length} images`)\n *   return processed\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Parallel file uploads with progress tracking\n * async function uploadFilesWithProgress(\n *   files: File[]\n * ): Promise<UploadResult[]> {\n *   let completed = 0\n *\n *   const uploadPromises = files.map(async file => {\n *     const result = await uploadToS3(file)\n *     completed++\n *     console.log(`Progress: ${completed}/${files.length} (${((completed/files.length)*100).toFixed(1)}%)`)\n *     return result\n *   })\n *\n *   // Upload 5 files at a time\n *   return await runBatch(uploadPromises, 5)\n * }\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Scraping with politeness delay\n * async function scrapeWebsites(urls: string[]): Promise<ScrapedData[]> {\n *   const scrapePromises = urls.map(async url => {\n *     const html = await fetch(url).then(r => r.text())\n *     const data = parseHTML(html)\n *\n *     // Polite delay between requests in same batch\n *     await sleep(200)\n *\n *     return data\n *   })\n *\n *   // Only 3 concurrent requests to avoid overwhelming target server\n *   return await runBatch(scrapePromises, 3)\n * }\n * ```\n *\n * @see {@link sleep} for adding delays between operations\n * @see {@link handleOperation} for dynamic operation execution\n */\nexport async function runBatch<T>(jobs: Promise<T>[], batchSize: number = 50): Promise<T[]> {\n  if (batchSize <= 0) {\n    throw new TsHelpersError('Batch size must be greater than 0', {\n      code: TsHelpersErrorCode.INVALID_OPERATION,\n      data: { batchSize },\n    })\n  }\n\n  const results: T[] = []\n  const batches = Math.ceil(jobs.length / batchSize)\n\n  for (let i = 0; i < batches; i++) {\n    const batchStart = i * batchSize\n    const batchEnd = batchStart + batchSize\n    const batch = jobs.slice(batchStart, batchEnd)\n\n    const batchResults = await Promise.all(batch.map(job => job))\n    results.push(...batchResults)\n  }\n\n  return results\n}\n\n// =============================================================================\n// DYNAMIC OPERATION UTILITIES\n// =============================================================================\n\n/**\n * Dynamically executes an operation on a target object by name\n *\n * Invokes methods on objects using string-based operation names. Supports nested\n * method access using 'parent/child' slash notation for organized operation namespacing.\n *\n * Features:\n * - Dynamic method invocation by string name\n * - Nested method access with '/' separator (e.g., 'api/getUser')\n * - Automatic error handling with descriptive messages\n * - Type-safe return value with generics\n *\n * Use cases:\n * - Dynamic API route handlers\n * - Plugin architectures with string-based commands\n * - RPC (Remote Procedure Call) implementations\n * - Command pattern implementations\n * - Configuration-driven operations\n *\n * @param target - Object containing methods to execute\n * @param operation - Method name or 'parent/child' path to execute\n * @param args - Arguments to pass to the operation\n * @returns Promise resolving to operation result\n * @throws {TsHelpersError} If operation doesn't exist on target\n *\n * @example\n * ```typescript\n * // Basic operation execution\n * const api = {\n *   getUser: async (id: string) => ({ id, name: 'John' }),\n *   createUser: async (data: any) => ({ id: '123', ...data })\n * }\n *\n * const user = await handleOperation<User>(api, 'getUser', 'user-123')\n * // { id: 'user-123', name: 'John' }\n * ```\n *\n * @example\n * ```typescript\n * // Nested operations with slash notation\n * const service = {\n *   users: {\n *     list: async () => [{ id: '1' }, { id: '2' }],\n *     create: async (data: any) => ({ id: 'new', ...data }),\n *     delete: async (id: string) => ({ success: true })\n *   },\n *   posts: {\n *     list: async () => [{ id: 'post-1' }],\n *     create: async (data: any) => ({ id: 'new-post', ...data })\n *   }\n * }\n *\n * // Execute nested operation\n * const users = await handleOperation(service, 'users/list')\n * const newUser = await handleOperation(service, 'users/create', { name: 'Alice' })\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Dynamic API router\n * interface ApiRequest {\n *   operation: string\n *   params: any[]\n * }\n *\n * const apiHandlers = {\n *   user: {\n *     get: async (id: string) => db.users.findById(id),\n *     create: async (data: UserInput) => db.users.create(data),\n *     update: async (id: string, data: Partial<UserInput>) =>\n *       db.users.update(id, data),\n *     delete: async (id: string) => db.users.delete(id)\n *   },\n *   product: {\n *     search: async (query: string) => db.products.search(query),\n *     list: async (page: number) => db.products.list(page)\n *   }\n * }\n *\n * async function handleApiRequest(req: ApiRequest): Promise<any> {\n *   try {\n *     return await handleOperation(\n *       apiHandlers,\n *       req.operation,\n *       ...req.params\n *     )\n *   } catch (error) {\n *     console.error(`Failed to execute ${req.operation}:`, error)\n *     throw error\n *   }\n * }\n *\n * // Usage\n * await handleApiRequest({ operation: 'user/get', params: ['user-123'] })\n * await handleApiRequest({ operation: 'product/search', params: ['laptop'] })\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: Plugin system with dynamic commands\n * interface Plugin {\n *   name: string\n *   commands: Record<string, (...args: any[]) => Promise<any>>\n * }\n *\n * class PluginManager {\n *   private plugins: Map<string, Plugin> = new Map()\n *\n *   register(plugin: Plugin): void {\n *     this.plugins.set(plugin.name, plugin)\n *   }\n *\n *   async executeCommand(\n *     pluginName: string,\n *     command: string,\n *     ...args: any[]\n *   ): Promise<any> {\n *     const plugin = this.plugins.get(pluginName)\n *     if (!plugin) throw new Error(`Plugin ${pluginName} not found`)\n *\n *     return handleOperation(plugin.commands, command, ...args)\n *   }\n * }\n *\n * // Register plugins\n * const manager = new PluginManager()\n * manager.register({\n *   name: 'fileOps',\n *   commands: {\n *     read: async (path: string) => fs.readFile(path, 'utf-8'),\n *     write: async (path: string, content: string) =>\n *       fs.writeFile(path, content)\n *   }\n * })\n *\n * // Execute plugin commands dynamically\n * await manager.executeCommand('fileOps', 'read', './config.json')\n * ```\n *\n * @example\n * ```typescript\n * // Real-world: RPC-style service calls\n * const rpcService = {\n *   math: {\n *     add: async (a: number, b: number) => a + b,\n *     multiply: async (a: number, b: number) => a * b\n *   },\n *   string: {\n *     reverse: async (s: string) => s.split('').reverse().join(''),\n *     uppercase: async (s: string) => s.toUpperCase()\n *   }\n * }\n *\n * async function rpcCall(method: string, ...params: any[]): Promise<any> {\n *   console.log(`RPC Call: ${method}(${params.join(', ')})`)\n *   const result = await handleOperation(rpcService, method, ...params)\n *   console.log(`RPC Result: ${result}`)\n *   return result\n * }\n *\n * await rpcCall('math/add', 5, 3)           // RPC Result: 8\n * await rpcCall('string/reverse', 'hello')  // RPC Result: olleh\n * ```\n *\n * @example\n * ```typescript\n * // Error handling\n * try {\n *   await handleOperation(api, 'nonexistent/method')\n * } catch (error) {\n *   console.error(error.message)\n *   // \"Operation [nonexistent/method] does not exist\"\n *   console.error(error.code)\n *   // TsHelpersErrorCode.INVALID_OPERATION\n * }\n * ```\n *\n * @see {@link TsHelpersError} for error structure\n * @see {@link TsHelpersErrorCode} for error codes\n */\nexport function handleOperation<T>(\n  target: Record<string, any>,\n  operation: string,\n  ...args: any[]\n): Promise<T> {\n  if (operation.includes('/')) {\n    const [parentOp, childOp] = operation.split('/')\n\n    if (!target[parentOp] || !target[parentOp][childOp]) {\n      throw new TsHelpersError(`Operation [${operation}] does not exist`, {\n        code: TsHelpersErrorCode.INVALID_OPERATION,\n        data: { operation, parentOp, childOp },\n      })\n    }\n\n    return target[parentOp][childOp](...args)\n  }\n\n  if (!target[operation]) {\n    throw new TsHelpersError(`Operation [${operation}] does not exist`, {\n      code: TsHelpersErrorCode.INVALID_OPERATION,\n      data: { operation },\n    })\n  }\n\n  return target[operation](...args)\n}\n"],"mappings":";;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoHO,IAAM,QAAQ,CAAC,OAA8B;AAClD,SAAO,IAAI,QAAQ,aAAW,WAAW,SAAS,EAAE,CAAC;AACvD;AAsBO,IAAM,OAAO,CAAC,OAA8B,MAAM,EAAE;AA0I3D,eAAsB,SAAY,MAAoB,YAAoB,IAAkB;AAC1F,MAAI,aAAa,GAAG;AAClB,UAAM,IAAI,eAAe,qCAAqC;AAAA,MAC5D;AAAA,MACA,MAAM,EAAE,UAAU;AAAA,IACpB,CAAC;AAAA,EACH;AAEA,QAAM,UAAe,CAAC;AACtB,QAAM,UAAU,KAAK,KAAK,KAAK,SAAS,SAAS;AAEjD,WAAS,IAAI,GAAG,IAAI,SAAS,KAAK;AAChC,UAAM,aAAa,IAAI;AACvB,UAAM,WAAW,aAAa;AAC9B,UAAM,QAAQ,KAAK,MAAM,YAAY,QAAQ;AAE7C,UAAM,eAAe,MAAM,QAAQ,IAAI,MAAM,IAAI,SAAO,GAAG,CAAC;AAC5D,YAAQ,KAAK,GAAG,YAAY;AAAA,EAC9B;AAEA,SAAO;AACT;AA0LO,SAAS,gBACd,QACA,cACG,MACS;AACZ,MAAI,UAAU,SAAS,GAAG,GAAG;AAC3B,UAAM,CAAC,UAAU,OAAO,IAAI,UAAU,MAAM,GAAG;AAE/C,QAAI,CAAC,OAAO,QAAQ,KAAK,CAAC,OAAO,QAAQ,EAAE,OAAO,GAAG;AACnD,YAAM,IAAI,eAAe,cAAc,SAAS,oBAAoB;AAAA,QAClE;AAAA,QACA,MAAM,EAAE,WAAW,UAAU,QAAQ;AAAA,MACvC,CAAC;AAAA,IACH;AAEA,WAAO,OAAO,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;AAAA,EAC1C;AAEA,MAAI,CAAC,OAAO,SAAS,GAAG;AACtB,UAAM,IAAI,eAAe,cAAc,SAAS,oBAAoB;AAAA,MAClE;AAAA,MACA,MAAM,EAAE,UAAU;AAAA,IACpB,CAAC;AAAA,EACH;AAEA,SAAO,OAAO,SAAS,EAAE,GAAG,IAAI;AAClC;","names":[]}

package/dist/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-C3D7YZVE.js";
+import "./chunk-NSBPE2FW.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/esm/dates.js.map

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

package/dist/esm/environment-detection.js

@@ -0,0 +1,21 @@
+import {
+  getCryptoCapabilities,
+  getEnvironmentType,
+  isBrowserEnv,
+  isNodeCryptoAvailable,
+  isNodeEnv,
+  isWebCryptoAvailable,
+  isWorkerEnvironment
+} from "./chunk-BDOBKBKA.js";
+import "./chunk-EBLSTOEC.js";
+import "./chunk-NSBPE2FW.js";
+export {
+  getCryptoCapabilities,
+  getEnvironmentType,
+  isBrowserEnv,
+  isNodeCryptoAvailable,
+  isNodeEnv,
+  isWebCryptoAvailable,
+  isWorkerEnvironment
+};
+//# sourceMappingURL=environment-detection.js.map

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

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

package/dist/esm/environment.js

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

package/dist/esm/environment.js.map

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

package/dist/esm/errors.js

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

package/dist/esm/errors.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,380 @@
+import {
+  generateAlphaNumericString,
+  generateAlphaString,
+  generateComplexString,
+  generateEmail,
+  generateHexColor,
+  generatePassword,
+  generateRandomInteger,
+  generateSpanishCIF,
+  generateSpanishIBAN,
+  generateSpanishNIE,
+  generateSpanishNIF,
+  generateSpanishPostalCode,
+  generateUsername,
+  generateUsernameFromEmail,
+  isValidCIF,
+  isValidEmail,
+  isValidJSON,
+  isValidNIE,
+  isValidNIF,
+  isValidSpanishIBAN,
+  isValidSpanishPhone,
+  isValidSpanishPostalCode,
+  isValidURL,
+  validateNIF,
+  validation_core_exports
+} from "./chunk-CZL6C2EI.js";
+import {
+  environment_detection_exports,
+  getCryptoCapabilities,
+  getEnvironmentType,
+  isBrowserEnv,
+  isNodeCryptoAvailable,
+  isNodeEnv,
+  isWebCryptoAvailable,
+  isWorkerEnvironment
+} from "./chunk-BDOBKBKA.js";
+import {
+  detectHostname,
+  detectProtocol,
+  environment_exports,
+  getEnvironmentInfo,
+  isBrowser,
+  isBrowserEnvironment,
+  isDevelopment,
+  isLocalhost,
+  isNode,
+  isNodeEnvironment,
+  isNonProduction,
+  isPrivateIP,
+  isProduction,
+  isTest,
+  parseEnvValue
+} from "./chunk-EBLSTOEC.js";
+import {
+  capitalizeEachWord,
+  capitalizeFirst,
+  cleanJsonChars,
+  contains,
+  countOccurrences,
+  endsWith,
+  ensureEndsWith,
+  ensureStartsWith,
+  envKeyToPath,
+  escapeHtmlChars,
+  isEmail,
+  isEmpty,
+  matchPathPattern,
+  padEnd,
+  padStart,
+  pathToEnvKey,
+  removeAccents,
+  repeatString,
+  replaceAllOccurrences,
+  reverseString,
+  sanitizeString,
+  startsWith,
+  strings_exports,
+  stripFromEnd,
+  stripFromStart,
+  toCamelCase,
+  toKebabCase,
+  toLowerCase,
+  toPascalCase,
+  toSnakeCase,
+  toUpperCase,
+  toUrlSlug,
+  trim,
+  trimEnd,
+  trimStart,
+  truncateString,
+  unescapeHtmlChars,
+  unescapeUnicode
+} from "./chunk-WJA4JDMZ.js";
+import {
+  calculateDifferences,
+  comparator,
+  deepEqual,
+  deleteArrayElementsBy,
+  formatToReadableString,
+  generateCrcHash,
+  getDeepValue,
+  getShallowProperties,
+  hasSameType,
+  objects_exports,
+  setDeepValue,
+  updateArrayElementById,
+  updateArrayElementsBy
+} from "./chunk-WG7ILCUB.js";
+import {
+  addDays,
+  addMonths,
+  addNowDays,
+  addNowMonths,
+  addNowSeconds,
+  addNowYears,
+  addSeconds,
+  addYears,
+  areDatesEqualWithTolerance,
+  dates_exports,
+  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-C3D7YZVE.js";
+import {
+  calculateAggregations,
+  calculateAnnuityPayment,
+  calculateCorrelation,
+  calculateEuclideanDistance,
+  calculateFutureValue,
+  calculateHistogram,
+  calculateIQR,
+  calculateIRR,
+  calculateManhattanDistance,
+  calculateMedian,
+  calculateMode,
+  calculateNPV,
+  calculatePercentile,
+  calculatePresentValue,
+  calculateQuartiles,
+  calculateStandardDeviation,
+  calculateTrendSlope,
+  calculateVariance,
+  detectOutliers,
+  math_exports,
+  normalizeToRange,
+  scaleToRange,
+  simpleKMeans
+} from "./chunk-4O7ZPIJN.js";
+import {
+  isNumericValue,
+  number_exports,
+  roundToDecimals
+} from "./chunk-SLQVNPTH.js";
+import {
+  async_exports,
+  handleOperation,
+  runBatch,
+  sleep,
+  wait
+} from "./chunk-ZFVYLUTT.js";
+import "./chunk-75XNTC34.js";
+import "./chunk-NSBPE2FW.js";
+
+// src/universal/index.ts
+var g = {
+  // Core validation functions (no crypto)
+  ...validation_core_exports,
+  // String functions
+  ...strings_exports,
+  // Object/Array functions
+  ...objects_exports,
+  // Date functions
+  ...dates_exports,
+  // Math functions
+  ...math_exports,
+  // Async functions
+  ...async_exports,
+  // Number utilities
+  ...number_exports,
+  // Environment utilities (original)
+  ...environment_exports,
+  // Enhanced environment detection
+  ...environment_detection_exports
+};
+var universal_default = g;
+export {
+  addDays,
+  addMonths,
+  addNowDays,
+  addNowMonths,
+  addNowSeconds,
+  addNowYears,
+  addSeconds,
+  addYears,
+  areDatesEqualWithTolerance,
+  async_exports as async,
+  calculateAggregations,
+  calculateAnnuityPayment,
+  calculateCorrelation,
+  calculateDifferences,
+  calculateEuclideanDistance,
+  calculateFutureValue,
+  calculateHistogram,
+  calculateIQR,
+  calculateIRR,
+  calculateManhattanDistance,
+  calculateMedian,
+  calculateMode,
+  calculateNPV,
+  calculatePercentile,
+  calculatePresentValue,
+  calculateQuartiles,
+  calculateStandardDeviation,
+  calculateTrendSlope,
+  calculateVariance,
+  capitalizeEachWord,
+  capitalizeFirst,
+  cleanJsonChars,
+  comparator,
+  contains,
+  countOccurrences,
+  dates_exports as dates,
+  dayOfWeek,
+  deepEqual,
+  universal_default as default,
+  deleteArrayElementsBy,
+  detectHostname,
+  detectOutliers,
+  detectProtocol,
+  diffBusinessDays,
+  diffDays,
+  diffMilliSeconds,
+  diffMonths,
+  diffYears,
+  endsWith,
+  ensureEndsWith,
+  ensureStartsWith,
+  envKeyToPath,
+  environment_exports as environment,
+  escapeHtmlChars,
+  excelToDate,
+  format,
+  formatForMysql,
+  formatNow,
+  formatToReadableString,
+  fromNow,
+  generateAlphaNumericString,
+  generateAlphaString,
+  generateComplexString,
+  generateCrcHash,
+  generateEmail,
+  generateHexColor,
+  generatePassword,
+  generateRandomInteger,
+  generateSpanishCIF,
+  generateSpanishIBAN,
+  generateSpanishNIE,
+  generateSpanishNIF,
+  generateSpanishPostalCode,
+  generateUsername,
+  generateUsernameFromEmail,
+  getCryptoCapabilities,
+  getDeepValue,
+  getEnvironmentInfo,
+  getEnvironmentType,
+  getFirstDayOfYear,
+  getFirstWorkdayAfterMonths,
+  getFirstWorkdayOfMonth,
+  getLastDayOfYear,
+  getLastWorkdayOfMonth,
+  getShallowProperties,
+  handleOperation,
+  hasSameType,
+  isBrowser,
+  isBrowserEnv,
+  isBrowserEnvironment,
+  isDateTime,
+  isDevelopment,
+  isEmail,
+  isEmpty,
+  isEqualsDateTimeByDay,
+  isExpired,
+  isLocalhost,
+  isNew,
+  isNode,
+  isNodeCryptoAvailable,
+  isNodeEnv,
+  isNodeEnvironment,
+  isNonProduction,
+  isNumericValue,
+  isPrivateIP,
+  isProduction,
+  isTest,
+  isValidCIF,
+  isValidEmail,
+  isValidJSON,
+  isValidNIE,
+  isValidNIF,
+  isValidSpanishIBAN,
+  isValidSpanishPhone,
+  isValidSpanishPostalCode,
+  isValidURL,
+  isWebCryptoAvailable,
+  isWeekday,
+  isWorkerEnvironment,
+  longString,
+  matchPathPattern,
+  math_exports as math,
+  normalizeToRange,
+  now,
+  number_exports as number,
+  objects_exports as objects,
+  padEnd,
+  padStart,
+  parseEnvValue,
+  pathToEnvKey,
+  removeAccents,
+  repeatString,
+  replaceAllOccurrences,
+  reverseString,
+  roundToDecimals,
+  runBatch,
+  sanitizeString,
+  scaleToRange,
+  setDeepValue,
+  simpleKMeans,
+  sleep,
+  startsWith,
+  strings_exports as strings,
+  stripFromEnd,
+  stripFromStart,
+  toCamelCase,
+  toDate,
+  toDateFromString,
+  toISO,
+  toKebabCase,
+  toLowerCase,
+  toPascalCase,
+  toSnakeCase,
+  toUpperCase,
+  toUrlSlug,
+  trim,
+  trimEnd,
+  trimStart,
+  truncateString,
+  unescapeHtmlChars,
+  unescapeUnicode,
+  updateArrayElementById,
+  updateArrayElementsBy,
+  validateNIF,
+  validation_core_exports as validation,
+  wait,
+  weekOfYear
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/universal/index.ts"],"sourcesContent":["/**\n * Universal exports - Safe for all environments\n * No crypto dependencies - browser and Node.js compatible\n */\n\n// Import universal modules (safe for all environments)\nimport * as validationCore from './validation-core'\nimport * as environmentDetection from './environment-detection'\nimport * as stringFunctions from '../strings'\nimport * as objectFunctions from '../objects'\nimport * as dateFunctions from '../dates'\nimport * as mathFunctions from '../math'\nimport * as asyncFunctions from '../async'\nimport * as environmentModule from '../environment'\nimport * as numberModule from '../number'\n\n// NOTE: data, csv, json, tree modules are NOT included in universal build\n// because they have Node.js dependencies (fs/promises, path)\n// These are available in Node.js specific builds\n\n// Create flat API object - universal functions only (safe for browser)\nconst g = {\n  // Core validation functions (no crypto)\n  ...validationCore,\n\n  // String functions\n  ...stringFunctions,\n\n  // Object/Array functions\n  ...objectFunctions,\n\n  // Date functions\n  ...dateFunctions,\n\n  // Math functions\n  ...mathFunctions,\n\n  // Async functions\n  ...asyncFunctions,\n\n  // Number utilities\n  ...numberModule,\n\n  // Environment utilities (original)\n  ...environmentModule,\n\n  // Enhanced environment detection\n  ...environmentDetection,\n}\n\n// Export both default and named exports\nexport default g\n\n// Named exports for specific imports\nexport {\n  validationCore as validation,\n  stringFunctions as strings,\n  objectFunctions as objects,\n  dateFunctions as dates,\n  mathFunctions as math,\n  asyncFunctions as async,\n  environmentModule as environment,\n  numberModule as number,\n}\n\n// Re-export individual functions for tree-shaking\nexport * from './validation-core'\nexport * from './environment-detection'\nexport * from '../strings'\nexport * from '../objects'\nexport * from '../dates'\nexport * from '../math'\nexport * from '../async'\nexport * from '../environment'\nexport * from '../number'\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBA,IAAM,IAAI;AAAA;AAAA,EAER,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AAAA;AAAA,EAGH,GAAG;AACL;AAGA,IAAO,oBAAQ;","names":[]}

package/dist/esm/math.js

@@ -0,0 +1,51 @@
+import {
+  calculateAggregations,
+  calculateAnnuityPayment,
+  calculateCorrelation,
+  calculateEuclideanDistance,
+  calculateFutureValue,
+  calculateHistogram,
+  calculateIQR,
+  calculateIRR,
+  calculateManhattanDistance,
+  calculateMedian,
+  calculateMode,
+  calculateNPV,
+  calculatePercentile,
+  calculatePresentValue,
+  calculateQuartiles,
+  calculateStandardDeviation,
+  calculateTrendSlope,
+  calculateVariance,
+  detectOutliers,
+  normalizeToRange,
+  scaleToRange,
+  simpleKMeans
+} from "./chunk-4O7ZPIJN.js";
+import "./chunk-SLQVNPTH.js";
+import "./chunk-NSBPE2FW.js";
+export {
+  calculateAggregations,
+  calculateAnnuityPayment,
+  calculateCorrelation,
+  calculateEuclideanDistance,
+  calculateFutureValue,
+  calculateHistogram,
+  calculateIQR,
+  calculateIRR,
+  calculateManhattanDistance,
+  calculateMedian,
+  calculateMode,
+  calculateNPV,
+  calculatePercentile,
+  calculatePresentValue,
+  calculateQuartiles,
+  calculateStandardDeviation,
+  calculateTrendSlope,
+  calculateVariance,
+  detectOutliers,
+  normalizeToRange,
+  scaleToRange,
+  simpleKMeans
+};
+//# sourceMappingURL=math.js.map

package/dist/esm/math.js.map

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

package/dist/esm/number.js

@@ -0,0 +1,10 @@
+import {
+  isNumericValue,
+  roundToDecimals
+} from "./chunk-SLQVNPTH.js";
+import "./chunk-NSBPE2FW.js";
+export {
+  isNumericValue,
+  roundToDecimals
+};
+//# sourceMappingURL=number.js.map

package/dist/esm/number.js.map

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

package/dist/esm/objects.js

@@ -0,0 +1,31 @@
+import {
+  calculateDifferences,
+  comparator,
+  deepEqual,
+  deleteArrayElementsBy,
+  formatToReadableString,
+  generateCrcHash,
+  getDeepValue,
+  getShallowProperties,
+  hasSameType,
+  setDeepValue,
+  updateArrayElementById,
+  updateArrayElementsBy
+} from "./chunk-WG7ILCUB.js";
+import "./chunk-C3D7YZVE.js";
+import "./chunk-NSBPE2FW.js";
+export {
+  calculateDifferences,
+  comparator,
+  deepEqual,
+  deleteArrayElementsBy,
+  formatToReadableString,
+  generateCrcHash,
+  getDeepValue,
+  getShallowProperties,
+  hasSameType,
+  setDeepValue,
+  updateArrayElementById,
+  updateArrayElementsBy
+};
+//# sourceMappingURL=objects.js.map

package/dist/esm/objects.js.map

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