@digicroz/js-kit 1.0.2 → 1.0.6

package/README.md

@@ -1,13 +1,29 @@
-# DXKit JS Kit
+# @digicroz/js-kit
 
-> **Modern TypeScript utility library with tree-shaking support** - Comprehensive collection of array, string, number, sleep, and time utilities for JavaScript and TypeScript projects.
+> **Modern TypeScript utility library with tree-shaking support** - Lightweight, fully-typed utilities for arrays, strings, numbers, slugs, enums, sleep, time, and environment detection. A modern alternative to lodash with zero dependencies and 100% test coverage.
 
-[![npm version](https://badge.fury.io/js/@digicroz/js-kit.svg)](https://www.npmjs.com/package/@digicroz/js-kit)
+[![npm version](https://img.shields.io/npm/v/@digicroz/js-kit.svg)](https://www.npmjs.com/package/@digicroz/js-kit)
+[![npm downloads](https://img.shields.io/npm/dm/@digicroz/js-kit.svg)](https://www.npmjs.com/package/@digicroz/js-kit)
+[![Bundle Size](https://img.shields.io/bundlephobia/minzip/@digicroz/js-kit)](https://bundlephobia.com/package/@digicroz/js-kit)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+[![Test Coverage](https://img.shields.io/badge/Coverage-100%25-brightgreen.svg)](https://github.com/digicroz/js-kit)
 [![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 [![Tree Shakable](https://img.shields.io/badge/Tree--Shakable-✓-brightgreen.svg)](https://webpack.js.org/guides/tree-shaking/)
 
-A collection of JavaScript/TypeScript utility functions for modern development.
+**@digicroz/js-kit** is a modern, lightweight TypeScript utility library designed for developers who need reliable, type-safe helper functions without the bloat. Perfect for React, Vue, Angular, Node.js, and any JavaScript/TypeScript project.
+
+**Keywords**: typescript utilities, javascript helpers, lodash alternative, tree-shakeable utils, zero dependencies, array utils, string utils, slug generator, enum utilities, case conversion, sleep promises, time utilities, environment detection
+
+## 🌟 Why Choose @digicroz/js-kit?
+
+- **🎯 Zero Dependencies** - No bloat, just pure utilities
+- **📦 Tiny Bundle Size** - Tree-shakeable ESM modules, import only what you need
+- **💯 100% Test Coverage** - 211 comprehensive tests ensure reliability
+- **🔒 Type-Safe** - Full TypeScript support with excellent IntelliSense
+- **⚡ Modern & Fast** - Built with modern JavaScript standards (ESM, CJS support)
+- **🌐 Universal** - Works in Node.js, browsers, React Native, and web workers
+- **🆚 Better than lodash** - Smaller, faster, more modern, with better TypeScript support
+- **📝 Well Documented** - Comprehensive JSDoc comments and examples
 
 ## 🌐 Environment Compatibility
 
@@ -20,7 +36,7 @@ This library is designed to work across multiple JavaScript environments:
 
 - 🚀 **TypeScript Support** - Full TypeScript support with type definitions
 - 📦 **Tree Shakable** - Import only what you need
-- 🧪 **Well Tested** - Comprehensive test coverage
+- 🧪 **100% Test Coverage** - 211 tests with comprehensive coverage across all modules
 - 📖 **Well Documented** - JSDoc comments for all functions
 - 🔧 **Modern Build** - Built with tsup for optimal bundling
 - 💡 **Excellent IDE Support** - Full auto-completion and IntelliSense support
@@ -63,6 +79,10 @@ import {
   convertToInt,
   getUnixTimestamp,
   isNodeEnvironment,
+  convertToSlug,
+  parseEnumValue,
+  toSnakeCase,
+  toCamelCase,
 } from "@digicroz/js-kit"
 
 // Array utilities
@@ -99,6 +119,22 @@ const timestamp = getUnixTimestamp()
 // Environment utilities
 const isNode = isNodeEnvironment()
 // Result: true if running in Node.js
+
+// Slug utilities
+const slug = convertToSlug("Hello World!")
+// Result: "hello-world"
+
+// Enum utilities
+const Status = ["active", "inactive"] as const
+const status = parseEnumValue(Status, "active")
+// Result: 'active'
+
+// Case conversion utilities
+const snakeCase = toSnakeCase("myVariableName")
+// Result: "my_variable_name"
+
+const camelCase = toCamelCase("my_variable_name")
+// Result: "myVariableName"
 ```
 
 ### Tree-shaking Support
@@ -108,11 +144,22 @@ You can also import individual functions for optimal tree-shaking:
 ```typescript
 // Universal utilities - individual imports
 import { chunk } from "@digicroz/js-kit/array"
-import { capitalize, truncateText } from "@digicroz/js-kit/string"
+import {
+  capitalize,
+  truncateText,
+  toSnakeCase,
+  toCamelCase,
+} from "@digicroz/js-kit/string"
 import { clamp, convertToInt } from "@digicroz/js-kit/number"
 import { sleep, sleepMs } from "@digicroz/js-kit/sleep"
 import { convertToSeconds, getUnixTimestamp } from "@digicroz/js-kit/time"
 import { isNodeEnvironment, getEnvironment } from "@digicroz/js-kit/utils"
+import {
+  convertToSlug,
+  isValidSlug,
+  generateUniqueSlug,
+} from "@digicroz/js-kit/slug"
+import { parseEnumValue, requireEnumValue } from "@digicroz/js-kit/enum"
 
 // Universal bundle (recommended)
 import {
@@ -128,15 +175,17 @@ import {
 
 ### ✅ Universal Modules (Node.js + Browser + Web Workers)
 
-| Module   | Functions                                                                                                                                    | Description                                    |
-| -------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
-| `array`  | `chunk`                                                                                                                                      | Split arrays into chunks of specified size     |
-| `string` | `capitalize`, `capitalizeWords`, `convertCamelToNormalCapitalized`, `randomStringWithFixedLength`, `truncateText`                            | String manipulation and formatting utilities   |
-| `number` | `clamp`, `inRange`, `convertToInt`, `convertToTwoDecimalInt`, `randomNumberWithFixedLength`                                                  | Number utilities including range operations    |
-| `sleep`  | `sleep`, `sleepMs`, `sleepSeconds`, `sleepMinutes`, `sleepUntil`                                                                             | Promise-based sleep with flexible time options |
-| `time`   | `convertToSeconds`, `getUnixTimestamp`, `getUnixTimestampMs`                                                                                 | Time conversion and timestamp utilities        |
-| `utils`  | `isNodeEnvironment`, `isBrowserEnvironment`, `isWebWorkerEnvironment`, `getEnvironment`, `assertNodeEnvironment`, `assertBrowserEnvironment` | Environment detection and assertions           |
-| `types`  | `Prettify`                                                                                                                                   | Utility types for TypeScript development       |
+| Module   | Functions                                                                                                                                                      | Description                                                    |
+| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
+| `array`  | `chunk`                                                                                                                                                        | Split arrays into chunks of specified size                     |
+| `string` | `capitalize`, `capitalizeWords`, `randomStringWithFixedLength`, `truncateText`, `toSnakeCase`, `toCamelCase`, `objectKeysToSnakeCase`, `objectKeysToCamelCase` | String manipulation, formatting, and case conversion utilities |
+| `number` | `clamp`, `inRange`, `convertToInt`, `convertToTwoDecimalInt`, `randomNumberWithFixedLength`                                                                    | Number utilities including range operations                    |
+| `slug`   | `isValidSlug`, `convertToSlug`, `generateUniqueSlug`, `zodSlugValidation`, `zodSlugTransform`, `slugSchema`, `autoSlugSchema`                                  | URL-safe slug generation and validation with Zod support       |
+| `enum`   | `parseEnumValue`, `requireEnumValue`                                                                                                                           | Type-safe enum parsing and validation                          |
+| `sleep`  | `sleep`, `sleepMs`, `sleepSeconds`, `sleepMinutes`, `sleepUntil`                                                                                               | Promise-based sleep with flexible time options                 |
+| `time`   | `convertToSeconds`, `getUnixTimestamp`, `getUnixTimestampMs`                                                                                                   | Time conversion and timestamp utilities                        |
+| `utils`  | `isNodeEnvironment`, `isBrowserEnvironment`, `isWebWorkerEnvironment`, `getEnvironment`, `assertNodeEnvironment`, `assertBrowserEnvironment`                   | Environment detection and assertions                           |
+| `types`  | `Prettify`                                                                                                                                                     | Utility types for TypeScript development                       |
 
 ## TypeScript Configuration
 
@@ -189,8 +238,10 @@ For comprehensive documentation with examples, advanced usage patterns, and best
 
 - **[🔢 Array Utilities](./src/array/array.md)** - Array manipulation and chunking utilities
 - **[🔢 Number Utilities](./src/number/number.md)** - Number clamping, conversion, and range validation
+- **[🔗 Slug Utilities](./src/slug/slug.md)** - URL-safe slug generation and validation
+- **[📋 Enum Utilities](./src/enum/enum.md)** - Type-safe enum parsing and validation
 - **[⏰ Sleep Utilities](./src/sleep/sleep.md)** - Advanced sleep and timing functions
-- **[📝 String Utilities](./src/string/string.md)** - String manipulation and formatting
+- **[📝 String Utilities](./src/string/string.md)** - String manipulation, formatting, and case conversion
 - **[⏰ Time Utilities](./src/time/time.md)** - Time conversion and duration utilities
 - **[🌐 Environment Utilities](./src/utils/utils.md)** - Environment detection and cross-platform utilities
 
@@ -204,9 +255,12 @@ For comprehensive documentation with examples, advanced usage patterns, and best
 
 - `capitalize(str: string): string` - Capitalizes the first letter of a string
 - `capitalizeWords(str: string): string` - Capitalizes the first letter of each word
-- `convertCamelToNormalCapitalized(str: string): string` - Converts camelCase to Normal Capitalized format
 - `randomStringWithFixedLength(length: number): string` - Generates a random string with fixed length
 - `truncateText(options: TruncateTextOptions): string` - Truncates text with customizable options
+- `toSnakeCase<T extends string>(value: T): ToSnakeCaseResult<T>` - Converts camelCase to snake_case
+- `toCamelCase<T extends string>(str: T): ToCamelCaseResult<T>` - Converts snake_case to camelCase
+- `objectKeysToSnakeCase<T>(obj: T): ObjectKeysToSnakeCaseResult<T>` - Recursively converts object keys to snake_case
+- `objectKeysToCamelCase<T>(obj: T): ObjectKeysToCamelCaseResult<T>` - Recursively converts object keys to camelCase
 
 #### Number Utilities
 
@@ -216,6 +270,21 @@ For comprehensive documentation with examples, advanced usage patterns, and best
 - `convertToTwoDecimalInt(data: any): number` - Converts to number with 2 decimal places
 - `randomNumberWithFixedLength(length: number): number` - Generates random number with fixed length
 
+#### Slug Utilities
+
+- `isValidSlug(slug: string): boolean` - Validates if a string is a valid URL slug
+- `convertToSlug(text: string, options?): string` - Converts text to a URL-safe slug
+- `generateUniqueSlug(baseText: string, existingSlugs: string[]): string` - Generates a unique slug
+- `zodSlugValidation(message?: string)` - Zod validation for slug format
+- `zodSlugTransform(options?)` - Zod transform that converts text to slug
+- `slugSchema` - Pre-configured Zod schemas for slug validation
+- `autoSlugSchema` - Pre-configured Zod schemas for automatic slug generation
+
+#### Enum Utilities
+
+- `parseEnumValue<T>(enumArray: T, value: string): T[number] | undefined` - Safely parses enum value
+- `requireEnumValue<T>(enumArray: T, value: string): T[number]` - Parses enum value or throws error
+
 #### Sleep Utilities
 
 - `sleep(params: TSleepParams): Promise<void>` - Advanced sleep with flexible options
@@ -260,8 +329,44 @@ npm run type-check
 
 # Run tests
 npm run test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Run tests in watch mode
+npm run test:watch
 ```
 
-## License
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## 👤 Author
+
+**Adarsh Hatkar**
+
+- GitHub: [@AdarshHatkar](https://github.com/AdarshHatkar)
+- Organization: [@digicroz](https://github.com/digicroz)
+
+## 🔗 Links
+
+- [NPM Package](https://www.npmjs.com/package/@digicroz/js-kit)
+- [GitHub Repository](https://github.com/digicroz/js-kit)
+- [Issue Tracker](https://github.com/digicroz/js-kit/issues)
+- [Changelog](https://github.com/digicroz/js-kit/releases)
+
+## ⭐ Show Your Support
+
+Give a ⭐️ if this project helped you!
+
+## 📄 License
+
+MIT © [Adarsh Hatkar](https://github.com/AdarshHatkar)
 
-MIT
+Copyright (c) 2025 Adarsh Hatkar

package/dist/enum/index.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+// src/enum/index.ts
+var parseEnumValue = (enumArray, value) => {
+  return enumArray.includes(value) ? value : void 0;
+};
+var requireEnumValue = (enumArray, value) => {
+  if (!enumArray.includes(value)) {
+    throw new Error(`Invalid enum value: ${value}`);
+  }
+  return value;
+};
+
+exports.parseEnumValue = parseEnumValue;
+exports.requireEnumValue = requireEnumValue;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/enum/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/enum/index.ts"],"names":[],"mappings":";;;AAaO,IAAM,cAAA,GAAiB,CAC5B,SAAA,EACA,KAAA,KAC0B;AAC1B,EAAA,OAAO,SAAA,CAAU,QAAA,CAAS,KAAkB,CAAA,GACvC,KAAA,GACD,MAAA;AACN;AAEO,IAAM,gBAAA,GAAmB,CAC9B,SAAA,EACA,KAAA,KACc;AACd,EAAA,IAAI,CAAC,SAAA,CAAU,QAAA,CAAS,KAAkB,CAAA,EAAG;AAC3C,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oBAAA,EAAuB,KAAK,CAAA,CAAE,CAAA;AAAA;AAEhD,EAAA,OAAO,KAAA;AACT","file":"index.cjs","sourcesContent":["/**\r\n * Helper function for enum filtering\r\n * Checks if a search value exists in an enum array and returns it with proper typing\r\n * @param enumArray - Array of enum values to search in\r\n * @param searchValue - Value to search for\r\n * @returns The typed enum value if found, undefined otherwise\r\n * @example\r\n * ```ts\r\n * const Status = ['active', 'inactive', 'pending'] as const;\r\n * const result = parseEnumValue(Status, 'active'); // 'active'\r\n * const invalid = parseEnumValue(Status, 'unknown'); // undefined\r\n * ```\r\n */\r\nexport const parseEnumValue = <T extends readonly string[]>(\r\n  enumArray: T,\r\n  value: string\r\n): T[number] | undefined => {\r\n  return enumArray.includes(value as T[number])\r\n    ? (value as T[number])\r\n    : undefined\r\n}\r\n\r\nexport const requireEnumValue = <T extends readonly string[]>(\r\n  enumArray: T,\r\n  value: string\r\n): T[number] => {\r\n  if (!enumArray.includes(value as T[number])) {\r\n    throw new Error(`Invalid enum value: ${value}`)\r\n  }\r\n  return value as T[number]\r\n}\r\n"]}

package/dist/enum/index.d.cts

@@ -0,0 +1,17 @@
+/**
+ * Helper function for enum filtering
+ * Checks if a search value exists in an enum array and returns it with proper typing
+ * @param enumArray - Array of enum values to search in
+ * @param searchValue - Value to search for
+ * @returns The typed enum value if found, undefined otherwise
+ * @example
+ * ```ts
+ * const Status = ['active', 'inactive', 'pending'] as const;
+ * const result = parseEnumValue(Status, 'active'); // 'active'
+ * const invalid = parseEnumValue(Status, 'unknown'); // undefined
+ * ```
+ */
+declare const parseEnumValue: <T extends readonly string[]>(enumArray: T, value: string) => T[number] | undefined;
+declare const requireEnumValue: <T extends readonly string[]>(enumArray: T, value: string) => T[number];
+
+export { parseEnumValue, requireEnumValue };

package/dist/enum/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Helper function for enum filtering
+ * Checks if a search value exists in an enum array and returns it with proper typing
+ * @param enumArray - Array of enum values to search in
+ * @param searchValue - Value to search for
+ * @returns The typed enum value if found, undefined otherwise
+ * @example
+ * ```ts
+ * const Status = ['active', 'inactive', 'pending'] as const;
+ * const result = parseEnumValue(Status, 'active'); // 'active'
+ * const invalid = parseEnumValue(Status, 'unknown'); // undefined
+ * ```
+ */
+declare const parseEnumValue: <T extends readonly string[]>(enumArray: T, value: string) => T[number] | undefined;
+declare const requireEnumValue: <T extends readonly string[]>(enumArray: T, value: string) => T[number];
+
+export { parseEnumValue, requireEnumValue };

package/dist/enum/index.js

@@ -0,0 +1,14 @@
+// src/enum/index.ts
+var parseEnumValue = (enumArray, value) => {
+  return enumArray.includes(value) ? value : void 0;
+};
+var requireEnumValue = (enumArray, value) => {
+  if (!enumArray.includes(value)) {
+    throw new Error(`Invalid enum value: ${value}`);
+  }
+  return value;
+};
+
+export { parseEnumValue, requireEnumValue };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/enum/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/enum/index.ts"],"names":[],"mappings":";AAaO,IAAM,cAAA,GAAiB,CAC5B,SAAA,EACA,KAAA,KAC0B;AAC1B,EAAA,OAAO,SAAA,CAAU,QAAA,CAAS,KAAkB,CAAA,GACvC,KAAA,GACD,MAAA;AACN;AAEO,IAAM,gBAAA,GAAmB,CAC9B,SAAA,EACA,KAAA,KACc;AACd,EAAA,IAAI,CAAC,SAAA,CAAU,QAAA,CAAS,KAAkB,CAAA,EAAG;AAC3C,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,oBAAA,EAAuB,KAAK,CAAA,CAAE,CAAA;AAAA;AAEhD,EAAA,OAAO,KAAA;AACT","file":"index.js","sourcesContent":["/**\r\n * Helper function for enum filtering\r\n * Checks if a search value exists in an enum array and returns it with proper typing\r\n * @param enumArray - Array of enum values to search in\r\n * @param searchValue - Value to search for\r\n * @returns The typed enum value if found, undefined otherwise\r\n * @example\r\n * ```ts\r\n * const Status = ['active', 'inactive', 'pending'] as const;\r\n * const result = parseEnumValue(Status, 'active'); // 'active'\r\n * const invalid = parseEnumValue(Status, 'unknown'); // undefined\r\n * ```\r\n */\r\nexport const parseEnumValue = <T extends readonly string[]>(\r\n  enumArray: T,\r\n  value: string\r\n): T[number] | undefined => {\r\n  return enumArray.includes(value as T[number])\r\n    ? (value as T[number])\r\n    : undefined\r\n}\r\n\r\nexport const requireEnumValue = <T extends readonly string[]>(\r\n  enumArray: T,\r\n  value: string\r\n): T[number] => {\r\n  if (!enumArray.includes(value as T[number])) {\r\n    throw new Error(`Invalid enum value: ${value}`)\r\n  }\r\n  return value as T[number]\r\n}\r\n"]}

package/dist/index.cjs

@@ -49,6 +49,41 @@ function truncateText({
   return text.length > maxLength ? text.substring(0, maxLength) + suffix : text;
 }
 
+// src/string/caseConversion/camelToSnake.ts
+var toSnakeCase = (value) => {
+  return value.replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2").replace(/([a-z\d])([A-Z])/g, "$1_$2").toLowerCase();
+};
+function objectKeysToSnakeCase(obj) {
+  if (obj === null || typeof obj !== "object") return obj;
+  if (Array.isArray(obj)) {
+    return obj.map(objectKeysToSnakeCase);
+  }
+  return Object.keys(obj).reduce((acc, key) => {
+    const snakeKey = toSnakeCase(key);
+    acc[snakeKey] = objectKeysToSnakeCase(obj[key]);
+    return acc;
+  }, {});
+}
+
+// src/string/caseConversion/snakeToCamel.ts
+var toCamelCase = (str) => {
+  return str.replace(
+    /_([a-z])/g,
+    (_, char) => char.toUpperCase()
+  );
+};
+function objectKeysToCamelCase(obj) {
+  if (obj === null || typeof obj !== "object") return obj;
+  if (Array.isArray(obj)) {
+    return obj.map(objectKeysToCamelCase);
+  }
+  return Object.keys(obj).reduce((acc, key) => {
+    const camelKey = toCamelCase(key);
+    acc[camelKey] = objectKeysToCamelCase(obj[key]);
+    return acc;
+  }, {});
+}
+
 // src/string/index.ts
 function randomStringWithFixedLength(length) {
   if (!Number.isInteger(length) || length <= 0) {
@@ -57,6 +92,60 @@ function randomStringWithFixedLength(length) {
   return Array.from({ length }, () => Math.random().toString(36)[2]).join("");
 }
 
+// src/slug/index.ts
+function isValidSlug(slug) {
+  if (!slug || typeof slug !== "string") {
+    return false;
+  }
+  const slugPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+  return slugPattern.test(slug);
+}
+function convertToSlug(text, options = {}) {
+  const { separator = "-" } = options;
+  if (!text || typeof text !== "string") {
+    return "";
+  }
+  return text.toString().toLowerCase().trim().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[\s_]+/g, separator).replace(new RegExp(`[^a-z0-9${separator}]`, "g"), "").replace(new RegExp(`${separator}+`, "g"), separator).replace(new RegExp(`^${separator}+|${separator}+$`, "g"), "");
+}
+function generateUniqueSlug(baseSlug, existingSlugs, options = {}) {
+  const { separator = "-" } = options;
+  if (!existingSlugs.includes(baseSlug)) {
+    return baseSlug;
+  }
+  let counter = 1;
+  let uniqueSlug = `${baseSlug}${separator}${counter}`;
+  while (existingSlugs.includes(uniqueSlug)) {
+    counter++;
+    uniqueSlug = `${baseSlug}${separator}${counter}`;
+  }
+  return uniqueSlug;
+}
+function zodSlugValidation(message) {
+  return (val) => isValidSlug(val);
+}
+function zodSlugTransform(options) {
+  return (val) => convertToSlug(val, options);
+}
+var slugSchema = {
+  /**
+   * Get a Zod string schema that validates slug format
+   * Requires zod to be installed: npm install zod
+   */
+  create: (customMessage) => {
+    return {
+      _type: "slug-validator",
+      validate: zodSlugValidation(),
+      message: customMessage || "Must be a valid slug (lowercase, alphanumeric, and hyphens only, no consecutive hyphens)"
+    };
+  }
+};
+var autoSlugSchema = {
+  /**
+   * Get a transform function for Zod
+   */
+  transform: (options) => zodSlugTransform(options)
+};
+
 // src/number/index.ts
 function clamp(number, lower, upper) {
   if (typeof number !== "number" || typeof lower !== "number" || typeof upper !== "number") {
@@ -283,9 +372,21 @@ function assertBrowserEnvironment() {
   }
 }
 
+// src/enum/index.ts
+var parseEnumValue = (enumArray, value) => {
+  return enumArray.includes(value) ? value : void 0;
+};
+var requireEnumValue = (enumArray, value) => {
+  if (!enumArray.includes(value)) {
+    throw new Error(`Invalid enum value: ${value}`);
+  }
+  return value;
+};
+
 exports.EnvironmentError = EnvironmentError;
 exports.assertBrowserEnvironment = assertBrowserEnvironment;
 exports.assertNodeEnvironment = assertNodeEnvironment;
+exports.autoSlugSchema = autoSlugSchema;
 exports.capitalize = capitalize;
 exports.capitalizeWords = capitalizeWords;
 exports.chunk = chunk;
@@ -293,7 +394,9 @@ exports.clamp = clamp;
 exports.convertCamelToNormalCapitalized = convertCamelToNormalCapitalized;
 exports.convertToInt = convertToInt;
 exports.convertToSeconds = convertToSeconds;
+exports.convertToSlug = convertToSlug;
 exports.convertToTwoDecimalInt = convertToTwoDecimalInt;
+exports.generateUniqueSlug = generateUniqueSlug;
 exports.getEnvironment = getEnvironment;
 exports.getFullYear = getFullYear;
 exports.getUnixTimestamp = getUnixTimestamp;
@@ -301,14 +404,24 @@ exports.getUnixTimestampMs = getUnixTimestampMs;
 exports.inRange = inRange;
 exports.isBrowserEnvironment = isBrowserEnvironment;
 exports.isNodeEnvironment = isNodeEnvironment;
+exports.isValidSlug = isValidSlug;
 exports.isWebWorkerEnvironment = isWebWorkerEnvironment;
+exports.objectKeysToCamelCase = objectKeysToCamelCase;
+exports.objectKeysToSnakeCase = objectKeysToSnakeCase;
+exports.parseEnumValue = parseEnumValue;
 exports.randomNumberWithFixedLength = randomNumberWithFixedLength;
 exports.randomStringWithFixedLength = randomStringWithFixedLength;
+exports.requireEnumValue = requireEnumValue;
 exports.sleep = sleep;
 exports.sleepMinutes = sleepMinutes;
 exports.sleepMs = sleepMs;
 exports.sleepSeconds = sleepSeconds;
 exports.sleepUntil = sleepUntil;
+exports.slugSchema = slugSchema;
+exports.toCamelCase = toCamelCase;
+exports.toSnakeCase = toSnakeCase;
 exports.truncateText = truncateText;
+exports.zodSlugTransform = zodSlugTransform;
+exports.zodSlugValidation = zodSlugValidation;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/array/index.ts","../src/string/capitalize.ts","../src/string/truncate.ts","../src/string/index.ts","../src/number/index.ts","../src/sleep/index.ts","../src/time/index.ts","../src/utils/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * Splits an array into chunks of a specified size\r\n * @param array - The array to chunk\r\n * @param size - The size of each chunk\r\n * @returns An array of chunks\r\n */\r\nexport function chunk<T>(array: T[], size: number): T[][] {\r\n  if (size <= 0) {\r\n    throw new Error('Chunk size must be greater than 0');\r\n  }\r\n  \r\n  if (array.length === 0) {\r\n    return [];\r\n  }\r\n  \r\n  const chunks: T[][] = [];\r\n  for (let i = 0; i < array.length; i += size) {\r\n    chunks.push(array.slice(i, i + size));\r\n  }\r\n  \r\n  return chunks;\r\n}\r\n","/**\r\n * Capitalizes the first letter of a string\r\n * @param str - The string to capitalize\r\n * @returns The capitalized string\r\n */\r\nexport function capitalize(str: string): string {\r\n  if (typeof str !== 'string') {\r\n    throw new Error('Input must be a string');\r\n  }\r\n  \r\n  if (str.length === 0) {\r\n    return str;\r\n  }\r\n  \r\n  return str.charAt(0).toUpperCase() + str.slice(1);\r\n}\r\n\r\n/**\r\n * Capitalizes the first letter of each word in a string\r\n * @param str - The string to capitalize\r\n * @returns The string with each word capitalized\r\n */\r\nexport function capitalizeWords(str: string): string {\r\n  if (typeof str !== 'string') {\r\n    throw new Error('Input must be a string');\r\n  }\r\n  \r\n  return str.replace(/\\b\\w/g, (char) => char.toUpperCase());\r\n}\r\n\r\nexport function convertCamelToNormalCapitalized(\r\n    camelCaseString: string\r\n): string {\r\n    // Split the camelCase string into words\r\n    const words = camelCaseString\r\n        .replace(/([a-z])([A-Z])/g, \"$1 $2\")\r\n        .split(/[\\s_]+/);\r\n\r\n    // Capitalize each word\r\n    const capitalizedWords = words.map(\r\n        (word) => word.charAt(0).toUpperCase() + word.slice(1)\r\n    );\r\n\r\n    // Join the capitalized words to form the normal capitalized string\r\n    const normalCapitalizedString = capitalizedWords.join(\" \");\r\n\r\n    return normalCapitalizedString;\r\n}","\r\nexport type TruncateTextOptions = {\r\n  text: string;\r\n  maxLength?: number;\r\n  suffix?: string;\r\n};\r\n\r\nexport function truncateText({\r\n  text,\r\n  maxLength = 10,\r\n  suffix = '...',\r\n}: TruncateTextOptions): string {\r\n  return text.length > maxLength\r\n    ? text.substring(0, maxLength) + suffix\r\n    : text;\r\n}\r\n","\r\nexport * from './capitalize';\r\nexport * from './truncate';\r\n\r\nexport function randomStringWithFixedLength(length: number): string {\r\n    if (!Number.isInteger(length) || length <= 0) {\r\n        throw new Error(\"Length must be a positive integer.\");\r\n    }\r\n\r\n    return Array.from({ length }, () => Math.random().toString(36)[2]).join(\"\");\r\n}","/**\r\n * Clamps a number within the inclusive lower and upper bounds\r\n * @param number - The number to clamp\r\n * @param lower - The lower bound\r\n * @param upper - The upper bound\r\n * @returns The clamped number\r\n */\r\nexport function clamp(number: number, lower: number, upper: number): number {\r\n  if (typeof number !== 'number' || typeof lower !== 'number' || typeof upper !== 'number') {\r\n    throw new Error('All arguments must be numbers');\r\n  }\r\n  \r\n  if (lower > upper) {\r\n    throw new Error('Lower bound must be less than or equal to upper bound');\r\n  }\r\n  \r\n  return Math.min(Math.max(number, lower), upper);\r\n}\r\n\r\n/**\r\n * Checks if a number is within the inclusive range\r\n * @param number - The number to check\r\n * @param lower - The lower bound\r\n * @param upper - The upper bound\r\n * @returns True if the number is within the range\r\n */\r\nexport function inRange(number: number, lower: number, upper: number): boolean {\r\n  if (typeof number !== 'number' || typeof lower !== 'number' || typeof upper !== 'number') {\r\n    throw new Error('All arguments must be numbers');\r\n  }\r\n  \r\n  if (lower > upper) {\r\n    throw new Error('Lower bound must be less than or equal to upper bound');\r\n  }\r\n  \r\n  return number >= lower && number <= upper;\r\n}\r\n\r\n\r\nexport const convertToInt = (data: any): number => {\r\n    if (isNaN(data)) {\r\n        throw new Error('Invalid input: not a number');\r\n    }\r\n    if (data === null || data === undefined) {\r\n        throw new Error('Invalid input: null or undefined');\r\n    }\r\n\r\n    if (typeof data === 'number') {\r\n        data = data + '';\r\n    }\r\n\r\n    return +parseInt(data);\r\n};\r\n\r\nexport const convertToTwoDecimalInt = (data: any): number => {\r\n    if (isNaN(data)) {\r\n        throw new Error('Invalid input: not a number');\r\n    }\r\n    if (data === null || data === undefined) {\r\n        throw new Error('Invalid input: null or undefined');\r\n    }\r\n\r\n    if (typeof data === 'number') {\r\n        data = data + '';\r\n    }\r\n    return +parseFloat(data).toFixed(2);\r\n};\r\n\r\nexport const randomNumberWithFixedLength = (length: number): number => {\r\n    if (length <= 0 || !Number.isInteger(length)) {\r\n        throw new Error('Length must be a positive integer.');\r\n    }\r\n    return Math.floor(\r\n        Math.pow(10, length - 1) +\r\n        Math.random() * (9 * Math.pow(10, length - 1))\r\n    );\r\n};\r\n","type TSleepParams ={\r\n    milliseconds?: number;\r\n    seconds?: number;\r\n    minutes?: number;\r\n    until?: {\r\n        unixTimestamp?: number;\r\n    };\r\n    random?:{\r\n        milliseconds?: {\r\n            min: number;\r\n            max: number;\r\n        }\r\n        seconds?: {\r\n            min: number;\r\n            max: number;\r\n        }\r\n        minutes?: {\r\n            min: number;\r\n            max: number;\r\n        }\r\n    }\r\n}\r\n\r\ntype TSleepReturn = Promise<void>;\r\n\r\n/**\r\n * Sleep function that supports various delay options\r\n * @param params - Sleep parameters including fixed delays, random delays, or until timestamp\r\n * @returns Promise that resolves after the specified delay\r\n * @throws Error if invalid parameters are provided\r\n */\r\nexport const sleep = (params: TSleepParams): TSleepReturn => {\r\n    return new Promise((resolve, reject) => {\r\n        let delayMs = 0;\r\n\r\n        try {\r\n            // Validate input parameters\r\n            if (!params || Object.keys(params).length === 0) {\r\n                throw new Error('Sleep parameters cannot be empty');\r\n            }\r\n\r\n            // Handle sleeping until a specific timestamp\r\n            if (params.until?.unixTimestamp) {\r\n                const now = Date.now();\r\n                const targetTime = params.until.unixTimestamp * 1000; // Convert to milliseconds\r\n                delayMs = Math.max(0, targetTime - now);\r\n                \r\n                // If the timestamp is in the past, resolve immediately\r\n                if (delayMs === 0) {\r\n                    resolve();\r\n                    return;\r\n                }\r\n            }\r\n            // Handle random delays\r\n            else if (params.random) {\r\n                if (params.random.milliseconds) {\r\n                    const { min, max } = params.random.milliseconds;\r\n                    if (min < 0 || max < 0 || min > max) {\r\n                        throw new Error('Invalid random milliseconds range');\r\n                    }\r\n                    delayMs = Math.random() * (max - min) + min;\r\n                } else if (params.random.seconds) {\r\n                    const { min, max } = params.random.seconds;\r\n                    if (min < 0 || max < 0 || min > max) {\r\n                        throw new Error('Invalid random seconds range');\r\n                    }\r\n                    delayMs = (Math.random() * (max - min) + min) * 1000;\r\n                } else if (params.random.minutes) {\r\n                    const { min, max } = params.random.minutes;\r\n                    if (min < 0 || max < 0 || min > max) {\r\n                        throw new Error('Invalid random minutes range');\r\n                    }\r\n                    delayMs = (Math.random() * (max - min) + min) * 60 * 1000;\r\n                } else {\r\n                    throw new Error('Random delay type must be specified (milliseconds, seconds, or minutes)');\r\n                }\r\n            }\r\n            // Handle fixed delays\r\n            else {\r\n                if (params.milliseconds !== undefined) {\r\n                    if (params.milliseconds < 0) {\r\n                        throw new Error('Milliseconds cannot be negative');\r\n                    }\r\n                    delayMs += params.milliseconds;\r\n                }\r\n                if (params.seconds !== undefined) {\r\n                    if (params.seconds < 0) {\r\n                        throw new Error('Seconds cannot be negative');\r\n                    }\r\n                    delayMs += params.seconds * 1000;\r\n                }\r\n                if (params.minutes !== undefined) {\r\n                    if (params.minutes < 0) {\r\n                        throw new Error('Minutes cannot be negative');\r\n                    }\r\n                    delayMs += params.minutes * 60 * 1000;\r\n                }\r\n\r\n                // If no valid delay was specified\r\n                if (delayMs === 0 && !params.milliseconds && !params.seconds && !params.minutes) {\r\n                    throw new Error('At least one delay parameter must be specified');\r\n                }\r\n            }\r\n\r\n            // Ensure delay is not too large (prevent potential issues)\r\n            const MAX_DELAY = 2147483647; // Maximum value for setTimeout\r\n            if (delayMs > MAX_DELAY) {\r\n                throw new Error(`Delay too large. Maximum delay is ${MAX_DELAY}ms`);\r\n            }\r\n\r\n            setTimeout(resolve, Math.floor(delayMs));\r\n        } catch (error) {\r\n            reject(error);\r\n        }\r\n    });\r\n};\r\n\r\n/**\r\n * Convenience function to sleep for a specific number of milliseconds\r\n * @param ms - Number of milliseconds to sleep\r\n * @returns Promise that resolves after the specified delay\r\n */\r\nexport const sleepMs = (ms: number): TSleepReturn => {\r\n    return sleep({ milliseconds: ms });\r\n};\r\n\r\n/**\r\n * Convenience function to sleep for a specific number of seconds\r\n * @param seconds - Number of seconds to sleep\r\n * @returns Promise that resolves after the specified delay\r\n */\r\nexport const sleepSeconds = (seconds: number): TSleepReturn => {\r\n    return sleep({ seconds });\r\n};\r\n\r\n/**\r\n * Convenience function to sleep for a specific number of minutes\r\n * @param minutes - Number of minutes to sleep\r\n * @returns Promise that resolves after the specified delay\r\n */\r\nexport const sleepMinutes = (minutes: number): TSleepReturn => {\r\n    return sleep({ minutes });\r\n};\r\n\r\n/**\r\n * Convenience function to sleep until a specific Unix timestamp\r\n * @param unixTimestamp - Unix timestamp (in seconds) to sleep until\r\n * @returns Promise that resolves at the specified timestamp\r\n */\r\nexport const sleepUntil = (unixTimestamp: number): TSleepReturn => {\r\n    return sleep({ until: { unixTimestamp } });\r\n};\r\n\r\n// Export the type definitions for consumers\r\nexport type { TSleepParams, TSleepReturn };","/**\r\n * Converts various time units to total seconds\r\n * @param options - Object containing optional time units\r\n * @param options.seconds - Number of seconds (default: 0)\r\n * @param options.minutes - Number of minutes (default: 0)\r\n * @param options.hours - Number of hours (default: 0)\r\n * @param options.days - Number of days (default: 0)\r\n * @param options.months - Number of months (default: 0, assumes 30 days per month)\r\n * @param options.years - Number of years (default: 0, assumes 365 days per year)\r\n * @returns Total time in seconds\r\n */\r\nexport function convertToSeconds(\r\n  options: {\r\n    seconds?: number\r\n    minutes?: number\r\n    hours?: number\r\n    days?: number\r\n    months?: number\r\n    years?: number\r\n  } = {}\r\n): number {\r\n  const {\r\n    seconds = 0,\r\n    minutes = 0,\r\n    hours = 0,\r\n    days = 0,\r\n    months = 0,\r\n    years = 0,\r\n  } = options\r\n\r\n  // Time conversion constants\r\n  const SECONDS_PER_MINUTE = 60\r\n  const SECONDS_PER_HOUR = 60 * 60\r\n  const SECONDS_PER_DAY = 60 * 60 * 24\r\n  const SECONDS_PER_MONTH = 60 * 60 * 24 * 30 // Assuming 30 days per month\r\n  const SECONDS_PER_YEAR = 60 * 60 * 24 * 365 // Assuming 365 days per year\r\n\r\n  return (\r\n    seconds +\r\n    minutes * SECONDS_PER_MINUTE +\r\n    hours * SECONDS_PER_HOUR +\r\n    days * SECONDS_PER_DAY +\r\n    months * SECONDS_PER_MONTH +\r\n    years * SECONDS_PER_YEAR\r\n  )\r\n}\r\n\r\n/**\r\n * Gets Unix timestamp in milliseconds\r\n * @param date - Optional Date object, date string, or timestamp. If not provided, uses current date\r\n * @returns Unix timestamp in milliseconds\r\n */\r\nexport const getUnixTimestampMs = (date?: Date | string | number): number => {\r\n  if (date === undefined) {\r\n    return Date.now()\r\n  }\r\n\r\n  if (typeof date === \"number\") {\r\n    const testDate = new Date(date)\r\n    if (isNaN(testDate.getTime())) {\r\n      throw new Error(\"Invalid timestamp provided\")\r\n    }\r\n\r\n    // Timestamps should be positive and not too far in the future\r\n    const now = Date.now()\r\n    const hundredYearsFromNow = now + 100 * 365 * 24 * 60 * 60 * 1000 // 100 years\r\n\r\n    if (date < 0 || date > hundredYearsFromNow) {\r\n      throw new Error(\"Timestamp is outside valid range\")\r\n    }\r\n\r\n    return date\r\n  }\r\n\r\n  const dateObj = new Date(date)\r\n\r\n  if (isNaN(dateObj.getTime())) {\r\n    throw new Error(\"Invalid date provided\")\r\n  }\r\n\r\n  return dateObj.getTime()\r\n}\r\n\r\n/**\r\n * Gets Unix timestamp in seconds\r\n * @param date - Optional Date object, date string, or timestamp. If not provided, uses current date\r\n * @returns Unix timestamp in seconds\r\n */\r\nexport const getUnixTimestamp = (date?: Date | string | number): number => {\r\n  return Math.floor(getUnixTimestampMs(date) / 1000)\r\n}\r\n\r\n/**\r\n * Gets the full year from a Date object or the current date\r\n * @param date - Optional Date object. If not provided, uses current date\r\n * @returns The full year (4 digits)\r\n */\r\nexport const getFullYear = (date?: Date): number => {\r\n  const targetDate = date || new Date()\r\n  return targetDate.getFullYear()\r\n}\r\n","/**\r\n * Environment detection utilities\r\n */\r\n\r\n/**\r\n * Determines if the current environment is Node.js\r\n * @returns true if running in Node.js, false otherwise\r\n */\r\nexport function isNodeEnvironment(): boolean {\r\n  return typeof process !== 'undefined' && \r\n         process.versions != null && \r\n         process.versions.node != null;\r\n}\r\n\r\n/**\r\n * Determines if the current environment is a browser\r\n * @returns true if running in a browser, false otherwise\r\n */\r\nexport function isBrowserEnvironment(): boolean {\r\n  return typeof window !== 'undefined' && \r\n         typeof document !== 'undefined';\r\n}\r\n\r\n/**\r\n * Determines if the current environment is a web worker\r\n * @returns true if running in a web worker, false otherwise\r\n */\r\nexport function isWebWorkerEnvironment(): boolean {\r\n  return typeof (globalThis as any).importScripts === 'function' && \r\n         typeof window === 'undefined';\r\n}\r\n\r\n/**\r\n * Gets the current runtime environment\r\n * @returns 'node' | 'browser' | 'webworker' | 'unknown'\r\n */\r\nexport function getEnvironment(): 'node' | 'browser' | 'webworker' | 'unknown' {\r\n  if (isNodeEnvironment()) return 'node';\r\n  if (isBrowserEnvironment()) return 'browser';\r\n  if (isWebWorkerEnvironment()) return 'webworker';\r\n  return 'unknown';\r\n}\r\n\r\n/**\r\n * Error thrown when functionality is not supported in the current environment\r\n */\r\nexport class EnvironmentError extends Error {\r\n  constructor(\r\n    message: string,\r\n    public readonly requiredEnvironment: string,\r\n    public readonly currentEnvironment: string\r\n  ) {\r\n    super(message);\r\n    this.name = 'EnvironmentError';\r\n  }\r\n}\r\n\r\n/**\r\n * Asserts that the current environment is Node.js\r\n * @throws {EnvironmentError} if not running in Node.js\r\n */\r\nexport function assertNodeEnvironment(): void {\r\n  if (!isNodeEnvironment()) {\r\n    throw new EnvironmentError(\r\n      'This functionality requires Node.js environment',\r\n      'node',\r\n      getEnvironment()\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Asserts that the current environment is a browser\r\n * @throws {EnvironmentError} if not running in a browser\r\n */\r\nexport function assertBrowserEnvironment(): void {\r\n  if (!isBrowserEnvironment()) {\r\n    throw new EnvironmentError(\r\n      'This functionality requires browser environment',\r\n      'browser',\r\n      getEnvironment()\r\n    );\r\n  }\r\n}\r\n"]}
+{"version":3,"sources":["../src/array/index.ts","../src/string/capitalize.ts","../src/string/truncate.ts","../src/string/caseConversion/camelToSnake.ts","../src/string/caseConversion/snakeToCamel.ts","../src/string/index.ts","../src/slug/index.ts","../src/number/index.ts","../src/sleep/index.ts","../src/time/index.ts","../src/utils/index.ts","../src/enum/index.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * Splits an array into chunks of a specified size\r\n * @param array - The array to chunk\r\n * @param size - The size of each chunk\r\n * @returns An array of chunks\r\n */\r\nexport function chunk<T>(array: T[], size: number): T[][] {\r\n  if (size <= 0) {\r\n    throw new Error('Chunk size must be greater than 0');\r\n  }\r\n  \r\n  if (array.length === 0) {\r\n    return [];\r\n  }\r\n  \r\n  const chunks: T[][] = [];\r\n  for (let i = 0; i < array.length; i += size) {\r\n    chunks.push(array.slice(i, i + size));\r\n  }\r\n  \r\n  return chunks;\r\n}\r\n","/**\r\n * Capitalizes the first letter of a string\r\n * @param str - The string to capitalize\r\n * @returns The capitalized string\r\n */\r\nexport function capitalize(str: string): string {\r\n  if (typeof str !== 'string') {\r\n    throw new Error('Input must be a string');\r\n  }\r\n  \r\n  if (str.length === 0) {\r\n    return str;\r\n  }\r\n  \r\n  return str.charAt(0).toUpperCase() + str.slice(1);\r\n}\r\n\r\n/**\r\n * Capitalizes the first letter of each word in a string\r\n * @param str - The string to capitalize\r\n * @returns The string with each word capitalized\r\n */\r\nexport function capitalizeWords(str: string): string {\r\n  if (typeof str !== 'string') {\r\n    throw new Error('Input must be a string');\r\n  }\r\n  \r\n  return str.replace(/\\b\\w/g, (char) => char.toUpperCase());\r\n}\r\n\r\nexport function convertCamelToNormalCapitalized(\r\n    camelCaseString: string\r\n): string {\r\n    // Split the camelCase string into words\r\n    const words = camelCaseString\r\n        .replace(/([a-z])([A-Z])/g, \"$1 $2\")\r\n        .split(/[\\s_]+/);\r\n\r\n    // Capitalize each word\r\n    const capitalizedWords = words.map(\r\n        (word) => word.charAt(0).toUpperCase() + word.slice(1)\r\n    );\r\n\r\n    // Join the capitalized words to form the normal capitalized string\r\n    const normalCapitalizedString = capitalizedWords.join(\" \");\r\n\r\n    return normalCapitalizedString;\r\n}","\r\nexport type TruncateTextOptions = {\r\n  text: string;\r\n  maxLength?: number;\r\n  suffix?: string;\r\n};\r\n\r\nexport function truncateText({\r\n  text,\r\n  maxLength = 10,\r\n  suffix = '...',\r\n}: TruncateTextOptions): string {\r\n  return text.length > maxLength\r\n    ? text.substring(0, maxLength) + suffix\r\n    : text;\r\n}\r\n","/* eslint-disable @typescript-eslint/no-explicit-any */\r\n// camelCase → snake_case (string)\r\ntype CamelToSnake<S extends string> = S extends `${infer T}${infer U}`\r\n  ? U extends Uncapitalize<U>\r\n    ? `${Lowercase<T>}${CamelToSnake<U>}`\r\n    : `${Lowercase<T>}_${CamelToSnake<U>}`\r\n  : S\r\n\r\nexport type ToSnakeCaseResult<T extends string> = CamelToSnake<T>\r\n// object keys\r\nexport type ObjectKeysToSnakeCaseResult<T> = {\r\n  [K in keyof T as CamelToSnake<\r\n    Extract<K, string>\r\n  >]: T[K] extends readonly any[]\r\n    ? ObjectKeysToSnakeCaseResult<T[K][number]>[]\r\n    : T[K] extends object\r\n    ? ObjectKeysToSnakeCaseResult<T[K]>\r\n    : T[K]\r\n}\r\n\r\n/**\r\n * Converts a camelCase string to snake_case\r\n * Handles leading uppercase letters correctly\r\n *\r\n * @example\r\n * toSnakeCase('myVariable') // 'my_variable'\r\n * toSnakeCase('MyVariable') // 'my_variable'\r\n * toSnakeCase('XMLParser') // 'xml_parser'\r\n */\r\nexport const toSnakeCase = <T extends string>(\r\n  value: T\r\n): ToSnakeCaseResult<T> => {\r\n  return value\r\n    .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1_$2\") // Handle consecutive caps like XMLParser\r\n    .replace(/([a-z\\d])([A-Z])/g, \"$1_$2\") // Handle normal camelCase\r\n    .toLowerCase() as ToSnakeCaseResult<T>\r\n}\r\n\r\n/**\r\n * Converts all keys in an object from camelCase to snake_case recursively\r\n * Handles nested objects and arrays\r\n *\r\n * @example\r\n * objectKeysToSnakeCase({ firstName: 'John', userInfo: { phoneNumber: '123' } })\r\n * // { first_name: 'John', user_info: { phone_number: '123' } }\r\n */\r\nexport function objectKeysToSnakeCase<T extends Record<string, any>>(\r\n  obj: T\r\n): ObjectKeysToSnakeCaseResult<T> {\r\n  if (obj === null || typeof obj !== \"object\") return obj as any\r\n\r\n  if (Array.isArray(obj)) {\r\n    return obj.map(objectKeysToSnakeCase) as any\r\n  }\r\n\r\n  return Object.keys(obj).reduce((acc, key) => {\r\n    const snakeKey = toSnakeCase(key)\r\n    acc[snakeKey] = objectKeysToSnakeCase(obj[key])\r\n    return acc\r\n  }, {} as any)\r\n}\r\n","/* eslint-disable @typescript-eslint/no-explicit-any */\r\n// Convert snake_case string to camelCase\r\ntype SnakeToCamel<S extends string> = S extends `${infer T}_${infer U}`\r\n  ? `${T}${Capitalize<SnakeToCamel<U>>}`\r\n  : S\r\n\r\nexport type ToCamelCaseResult<T extends string> = SnakeToCamel<T>\r\n\r\n// Convert object keys recursively\r\nexport type ObjectKeysToCamelCaseResult<T> = {\r\n  [K in keyof T as SnakeToCamel<\r\n    Extract<K, string>\r\n  >]: T[K] extends readonly any[]\r\n    ? ObjectKeysToCamelCaseResult<T[K][number]>[]\r\n    : T[K] extends object\r\n    ? ObjectKeysToCamelCaseResult<T[K]>\r\n    : T[K]\r\n}\r\n\r\n/**\r\n * Converts a snake_case string to camelCase\r\n *\r\n * @example\r\n * toCamelCase('my_variable') // 'myVariable'\r\n * toCamelCase('user_first_name') // 'userFirstName'\r\n */\r\nexport const toCamelCase = <T extends string>(str: T): ToCamelCaseResult<T> => {\r\n  return str.replace(/_([a-z])/g, (_, char) =>\r\n    char.toUpperCase()\r\n  ) as ToCamelCaseResult<T>\r\n}\r\n\r\n/**\r\n * Converts all keys in an object from snake_case to camelCase recursively\r\n * Handles nested objects and arrays\r\n *\r\n * @example\r\n * objectKeysToCamelCase({ first_name: 'John', user_info: { phone_number: '123' } })\r\n * // { firstName: 'John', userInfo: { phoneNumber: '123' } }\r\n */\r\nexport function objectKeysToCamelCase<T extends Record<string, any>>(\r\n  obj: T\r\n): ObjectKeysToCamelCaseResult<T> {\r\n  if (obj === null || typeof obj !== \"object\") return obj as any\r\n\r\n  if (Array.isArray(obj)) {\r\n    return obj.map(objectKeysToCamelCase) as any\r\n  }\r\n\r\n  return Object.keys(obj).reduce((acc, key) => {\r\n    const camelKey = toCamelCase(key)\r\n    acc[camelKey] = objectKeysToCamelCase(obj[key])\r\n    return acc\r\n  }, {} as any)\r\n}\r\n","export * from \"./capitalize\"\r\nexport * from \"./truncate\"\r\nexport * from \"./caseConversion\"\r\n\r\nexport function randomStringWithFixedLength(length: number): string {\r\n  if (!Number.isInteger(length) || length <= 0) {\r\n    throw new Error(\"Length must be a positive integer.\")\r\n  }\r\n\r\n  return Array.from({ length }, () => Math.random().toString(36)[2]).join(\"\")\r\n}\r\n","/**\r\n * Checks if a string is a valid slug\r\n * A valid slug contains only lowercase alphanumeric characters and hyphens,\r\n * with no consecutive hyphens and no leading/trailing hyphens\r\n * \r\n * @param slug - The string to validate\r\n * @returns True if the string is a valid slug, false otherwise\r\n * \r\n * @example\r\n * ```ts\r\n * isValidSlug('hello-world') // true\r\n * isValidSlug('hello--world') // false (consecutive hyphens)\r\n * isValidSlug('Hello-World') // false (uppercase)\r\n * isValidSlug('-hello-world') // false (leading hyphen)\r\n * isValidSlug('hello_world') // false (underscore not allowed)\r\n * ```\r\n */\r\nexport function isValidSlug(slug: string): boolean {\r\n  if (!slug || typeof slug !== 'string') {\r\n    return false;\r\n  }\r\n\r\n  // Check if slug matches the pattern:\r\n  // - starts with alphanumeric\r\n  // - ends with alphanumeric\r\n  // - contains only lowercase alphanumeric and single hyphens\r\n  const slugPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;\r\n  \r\n  return slugPattern.test(slug);\r\n}\r\n\r\n/**\r\n * Converts a string to a URL-safe slug\r\n * - Converts to lowercase\r\n * - Removes special characters\r\n * - Replaces spaces and underscores with hyphens\r\n * - Removes consecutive hyphens\r\n * - Trims leading and trailing hyphens\r\n * \r\n * @param text - The string to convert to a slug\r\n * @param options - Optional configuration\r\n * @param options.separator - Character to use as separator (default: '-')\r\n * @returns A URL-safe slug\r\n * \r\n * @example\r\n * ```ts\r\n * convertToSlug('Hello World') // 'hello-world'\r\n * convertToSlug('Hello  World!!!') // 'hello-world'\r\n * convertToSlug('Hello_World') // 'hello-world'\r\n * convertToSlug('  Hello World  ') // 'hello-world'\r\n * convertToSlug('Hello---World') // 'hello-world'\r\n * convertToSlug('Café & Restaurant') // 'cafe-restaurant'\r\n * convertToSlug('Product #123') // 'product-123'\r\n * ```\r\n */\r\nexport function convertToSlug(\r\n  text: string,\r\n  options: { separator?: string } = {}\r\n): string {\r\n  const { separator = '-' } = options;\r\n\r\n  if (!text || typeof text !== 'string') {\r\n    return '';\r\n  }\r\n\r\n  return text\r\n    .toString()\r\n    .toLowerCase()\r\n    .trim()\r\n    // Remove accents and diacritics\r\n    .normalize('NFD')\r\n    .replace(/[\\u0300-\\u036f]/g, '')\r\n    // Replace spaces, underscores, and other common separators with separator\r\n    .replace(/[\\s_]+/g, separator)\r\n    // Remove all non-alphanumeric characters except the separator\r\n    .replace(new RegExp(`[^a-z0-9${separator}]`, 'g'), '')\r\n    // Replace multiple consecutive separators with single separator\r\n    .replace(new RegExp(`${separator}+`, 'g'), separator)\r\n    // Remove leading and trailing separators\r\n    .replace(new RegExp(`^${separator}+|${separator}+$`, 'g'), '');\r\n}\r\n\r\n/**\r\n * Generates a unique slug by appending a number if the slug already exists\r\n * \r\n * @param baseSlug - The base slug to make unique\r\n * @param existingSlugs - Array of existing slugs to check against\r\n * @param options - Optional configuration\r\n * @param options.separator - Character to use before the number (default: '-')\r\n * @returns A unique slug\r\n * \r\n * @example\r\n * ```ts\r\n * generateUniqueSlug('hello-world', ['hello-world']) // 'hello-world-1'\r\n * generateUniqueSlug('hello-world', ['hello-world', 'hello-world-1']) // 'hello-world-2'\r\n * generateUniqueSlug('hello-world', []) // 'hello-world'\r\n * ```\r\n */\r\nexport function generateUniqueSlug(\r\n  baseSlug: string,\r\n  existingSlugs: string[],\r\n  options: { separator?: string } = {}\r\n): string {\r\n  const { separator = '-' } = options;\r\n\r\n  if (!existingSlugs.includes(baseSlug)) {\r\n    return baseSlug;\r\n  }\r\n\r\n  let counter = 1;\r\n  let uniqueSlug = `${baseSlug}${separator}${counter}`;\r\n\r\n  while (existingSlugs.includes(uniqueSlug)) {\r\n    counter++;\r\n    uniqueSlug = `${baseSlug}${separator}${counter}`;\r\n  }\r\n\r\n  return uniqueSlug;\r\n}\r\n\r\n/**\r\n * Creates a Zod refinement function for slug validation\r\n * Use with z.string().refine() or z.string().superRefine()\r\n * \r\n * @param message - Custom error message (optional)\r\n * @returns Refinement function for Zod\r\n * \r\n * @example\r\n * ```ts\r\n * import { z } from 'zod';\r\n * import { zodSlugValidation } from '@digicroz/js-kit';\r\n * \r\n * const schema = z.object({\r\n *   slug: z.string().refine(zodSlugValidation(), {\r\n *     message: 'Invalid slug format'\r\n *   })\r\n * });\r\n * ```\r\n */\r\nexport function zodSlugValidation(message?: string) {\r\n  return (val: string) => isValidSlug(val);\r\n}\r\n\r\n/**\r\n * Creates a Zod transform function that converts strings to slugs\r\n * Use with z.string().transform()\r\n * \r\n * @param options - Optional configuration\r\n * @param options.separator - Character to use as separator (default: '-')\r\n * @returns Transform function for Zod\r\n * \r\n * @example\r\n * ```ts\r\n * import { z } from 'zod';\r\n * import { zodSlugTransform } from '@digicroz/js-kit';\r\n * \r\n * const schema = z.object({\r\n *   title: z.string(),\r\n *   slug: z.string().transform(zodSlugTransform())\r\n * });\r\n * \r\n * schema.parse({ title: 'Hello', slug: 'Hello World!!!' })\r\n * // { title: 'Hello', slug: 'hello-world' }\r\n * ```\r\n */\r\nexport function zodSlugTransform(options?: { separator?: string }) {\r\n  return (val: string) => convertToSlug(val, options);\r\n}\r\n\r\n/**\r\n * Pre-configured Zod schema for slug validation\r\n * Validates that the string is a valid slug format\r\n * \r\n * @example\r\n * ```ts\r\n * import { z } from 'zod';\r\n * import { slugSchema } from '@digicroz/js-kit';\r\n * \r\n * const postSchema = z.object({\r\n *   slug: slugSchema\r\n * });\r\n * \r\n * postSchema.parse({ slug: 'hello-world' }); // ✓ Valid\r\n * postSchema.parse({ slug: 'Hello World' }); // ✗ Invalid\r\n * ```\r\n */\r\nexport const slugSchema = {\r\n  /**\r\n   * Get a Zod string schema that validates slug format\r\n   * Requires zod to be installed: npm install zod\r\n   */\r\n  create: (customMessage?: string) => {\r\n    // Dynamic import to avoid making zod a required dependency\r\n    return {\r\n      _type: 'slug-validator' as const,\r\n      validate: zodSlugValidation(customMessage),\r\n      message: customMessage || 'Must be a valid slug (lowercase, alphanumeric, and hyphens only, no consecutive hyphens)'\r\n    };\r\n  }\r\n};\r\n\r\n/**\r\n * Pre-configured Zod schema that auto-converts strings to slugs\r\n * Automatically transforms any string input into a valid slug\r\n * \r\n * @example\r\n * ```ts\r\n * import { z } from 'zod';\r\n * import { autoSlugSchema } from '@digicroz/js-kit';\r\n * \r\n * const postSchema = z.object({\r\n *   title: z.string(),\r\n *   slug: z.string().transform(autoSlugSchema.transform())\r\n * });\r\n * \r\n * postSchema.parse({ title: 'My Post', slug: 'Hello World!!!' })\r\n * // { title: 'My Post', slug: 'hello-world' }\r\n * ```\r\n */\r\nexport const autoSlugSchema = {\r\n  /**\r\n   * Get a transform function for Zod\r\n   */\r\n  transform: (options?: { separator?: string }) => zodSlugTransform(options)\r\n};\r\n","/**\r\n * Clamps a number within the inclusive lower and upper bounds\r\n * @param number - The number to clamp\r\n * @param lower - The lower bound\r\n * @param upper - The upper bound\r\n * @returns The clamped number\r\n */\r\nexport function clamp(number: number, lower: number, upper: number): number {\r\n  if (typeof number !== 'number' || typeof lower !== 'number' || typeof upper !== 'number') {\r\n    throw new Error('All arguments must be numbers');\r\n  }\r\n  \r\n  if (lower > upper) {\r\n    throw new Error('Lower bound must be less than or equal to upper bound');\r\n  }\r\n  \r\n  return Math.min(Math.max(number, lower), upper);\r\n}\r\n\r\n/**\r\n * Checks if a number is within the inclusive range\r\n * @param number - The number to check\r\n * @param lower - The lower bound\r\n * @param upper - The upper bound\r\n * @returns True if the number is within the range\r\n */\r\nexport function inRange(number: number, lower: number, upper: number): boolean {\r\n  if (typeof number !== 'number' || typeof lower !== 'number' || typeof upper !== 'number') {\r\n    throw new Error('All arguments must be numbers');\r\n  }\r\n  \r\n  if (lower > upper) {\r\n    throw new Error('Lower bound must be less than or equal to upper bound');\r\n  }\r\n  \r\n  return number >= lower && number <= upper;\r\n}\r\n\r\n\r\nexport const convertToInt = (data: any): number => {\r\n    if (isNaN(data)) {\r\n        throw new Error('Invalid input: not a number');\r\n    }\r\n    if (data === null || data === undefined) {\r\n        throw new Error('Invalid input: null or undefined');\r\n    }\r\n\r\n    if (typeof data === 'number') {\r\n        data = data + '';\r\n    }\r\n\r\n    return +parseInt(data);\r\n};\r\n\r\nexport const convertToTwoDecimalInt = (data: any): number => {\r\n    if (isNaN(data)) {\r\n        throw new Error('Invalid input: not a number');\r\n    }\r\n    if (data === null || data === undefined) {\r\n        throw new Error('Invalid input: null or undefined');\r\n    }\r\n\r\n    if (typeof data === 'number') {\r\n        data = data + '';\r\n    }\r\n    return +parseFloat(data).toFixed(2);\r\n};\r\n\r\nexport const randomNumberWithFixedLength = (length: number): number => {\r\n    if (length <= 0 || !Number.isInteger(length)) {\r\n        throw new Error('Length must be a positive integer.');\r\n    }\r\n    return Math.floor(\r\n        Math.pow(10, length - 1) +\r\n        Math.random() * (9 * Math.pow(10, length - 1))\r\n    );\r\n};\r\n","type TSleepParams ={\r\n    milliseconds?: number;\r\n    seconds?: number;\r\n    minutes?: number;\r\n    until?: {\r\n        unixTimestamp?: number;\r\n    };\r\n    random?:{\r\n        milliseconds?: {\r\n            min: number;\r\n            max: number;\r\n        }\r\n        seconds?: {\r\n            min: number;\r\n            max: number;\r\n        }\r\n        minutes?: {\r\n            min: number;\r\n            max: number;\r\n        }\r\n    }\r\n}\r\n\r\ntype TSleepReturn = Promise<void>;\r\n\r\n/**\r\n * Sleep function that supports various delay options\r\n * @param params - Sleep parameters including fixed delays, random delays, or until timestamp\r\n * @returns Promise that resolves after the specified delay\r\n * @throws Error if invalid parameters are provided\r\n */\r\nexport const sleep = (params: TSleepParams): TSleepReturn => {\r\n    return new Promise((resolve, reject) => {\r\n        let delayMs = 0;\r\n\r\n        try {\r\n            // Validate input parameters\r\n            if (!params || Object.keys(params).length === 0) {\r\n                throw new Error('Sleep parameters cannot be empty');\r\n            }\r\n\r\n            // Handle sleeping until a specific timestamp\r\n            if (params.until?.unixTimestamp) {\r\n                const now = Date.now();\r\n                const targetTime = params.until.unixTimestamp * 1000; // Convert to milliseconds\r\n                delayMs = Math.max(0, targetTime - now);\r\n                \r\n                // If the timestamp is in the past, resolve immediately\r\n                if (delayMs === 0) {\r\n                    resolve();\r\n                    return;\r\n                }\r\n            }\r\n            // Handle random delays\r\n            else if (params.random) {\r\n                if (params.random.milliseconds) {\r\n                    const { min, max } = params.random.milliseconds;\r\n                    if (min < 0 || max < 0 || min > max) {\r\n                        throw new Error('Invalid random milliseconds range');\r\n                    }\r\n                    delayMs = Math.random() * (max - min) + min;\r\n                } else if (params.random.seconds) {\r\n                    const { min, max } = params.random.seconds;\r\n                    if (min < 0 || max < 0 || min > max) {\r\n                        throw new Error('Invalid random seconds range');\r\n                    }\r\n                    delayMs = (Math.random() * (max - min) + min) * 1000;\r\n                } else if (params.random.minutes) {\r\n                    const { min, max } = params.random.minutes;\r\n                    if (min < 0 || max < 0 || min > max) {\r\n                        throw new Error('Invalid random minutes range');\r\n                    }\r\n                    delayMs = (Math.random() * (max - min) + min) * 60 * 1000;\r\n                } else {\r\n                    throw new Error('Random delay type must be specified (milliseconds, seconds, or minutes)');\r\n                }\r\n            }\r\n            // Handle fixed delays\r\n            else {\r\n                if (params.milliseconds !== undefined) {\r\n                    if (params.milliseconds < 0) {\r\n                        throw new Error('Milliseconds cannot be negative');\r\n                    }\r\n                    delayMs += params.milliseconds;\r\n                }\r\n                if (params.seconds !== undefined) {\r\n                    if (params.seconds < 0) {\r\n                        throw new Error('Seconds cannot be negative');\r\n                    }\r\n                    delayMs += params.seconds * 1000;\r\n                }\r\n                if (params.minutes !== undefined) {\r\n                    if (params.minutes < 0) {\r\n                        throw new Error('Minutes cannot be negative');\r\n                    }\r\n                    delayMs += params.minutes * 60 * 1000;\r\n                }\r\n\r\n                // If no valid delay was specified\r\n                if (delayMs === 0 && !params.milliseconds && !params.seconds && !params.minutes) {\r\n                    throw new Error('At least one delay parameter must be specified');\r\n                }\r\n            }\r\n\r\n            // Ensure delay is not too large (prevent potential issues)\r\n            const MAX_DELAY = 2147483647; // Maximum value for setTimeout\r\n            if (delayMs > MAX_DELAY) {\r\n                throw new Error(`Delay too large. Maximum delay is ${MAX_DELAY}ms`);\r\n            }\r\n\r\n            setTimeout(resolve, Math.floor(delayMs));\r\n        } catch (error) {\r\n            reject(error);\r\n        }\r\n    });\r\n};\r\n\r\n/**\r\n * Convenience function to sleep for a specific number of milliseconds\r\n * @param ms - Number of milliseconds to sleep\r\n * @returns Promise that resolves after the specified delay\r\n */\r\nexport const sleepMs = (ms: number): TSleepReturn => {\r\n    return sleep({ milliseconds: ms });\r\n};\r\n\r\n/**\r\n * Convenience function to sleep for a specific number of seconds\r\n * @param seconds - Number of seconds to sleep\r\n * @returns Promise that resolves after the specified delay\r\n */\r\nexport const sleepSeconds = (seconds: number): TSleepReturn => {\r\n    return sleep({ seconds });\r\n};\r\n\r\n/**\r\n * Convenience function to sleep for a specific number of minutes\r\n * @param minutes - Number of minutes to sleep\r\n * @returns Promise that resolves after the specified delay\r\n */\r\nexport const sleepMinutes = (minutes: number): TSleepReturn => {\r\n    return sleep({ minutes });\r\n};\r\n\r\n/**\r\n * Convenience function to sleep until a specific Unix timestamp\r\n * @param unixTimestamp - Unix timestamp (in seconds) to sleep until\r\n * @returns Promise that resolves at the specified timestamp\r\n */\r\nexport const sleepUntil = (unixTimestamp: number): TSleepReturn => {\r\n    return sleep({ until: { unixTimestamp } });\r\n};\r\n\r\n// Export the type definitions for consumers\r\nexport type { TSleepParams, TSleepReturn };","/**\r\n * Converts various time units to total seconds\r\n * @param options - Object containing optional time units\r\n * @param options.seconds - Number of seconds (default: 0)\r\n * @param options.minutes - Number of minutes (default: 0)\r\n * @param options.hours - Number of hours (default: 0)\r\n * @param options.days - Number of days (default: 0)\r\n * @param options.months - Number of months (default: 0, assumes 30 days per month)\r\n * @param options.years - Number of years (default: 0, assumes 365 days per year)\r\n * @returns Total time in seconds\r\n */\r\nexport function convertToSeconds(\r\n  options: {\r\n    seconds?: number\r\n    minutes?: number\r\n    hours?: number\r\n    days?: number\r\n    months?: number\r\n    years?: number\r\n  } = {}\r\n): number {\r\n  const {\r\n    seconds = 0,\r\n    minutes = 0,\r\n    hours = 0,\r\n    days = 0,\r\n    months = 0,\r\n    years = 0,\r\n  } = options\r\n\r\n  // Time conversion constants\r\n  const SECONDS_PER_MINUTE = 60\r\n  const SECONDS_PER_HOUR = 60 * 60\r\n  const SECONDS_PER_DAY = 60 * 60 * 24\r\n  const SECONDS_PER_MONTH = 60 * 60 * 24 * 30 // Assuming 30 days per month\r\n  const SECONDS_PER_YEAR = 60 * 60 * 24 * 365 // Assuming 365 days per year\r\n\r\n  return (\r\n    seconds +\r\n    minutes * SECONDS_PER_MINUTE +\r\n    hours * SECONDS_PER_HOUR +\r\n    days * SECONDS_PER_DAY +\r\n    months * SECONDS_PER_MONTH +\r\n    years * SECONDS_PER_YEAR\r\n  )\r\n}\r\n\r\n/**\r\n * Gets Unix timestamp in milliseconds\r\n * @param date - Optional Date object, date string, or timestamp. If not provided, uses current date\r\n * @returns Unix timestamp in milliseconds\r\n */\r\nexport const getUnixTimestampMs = (date?: Date | string | number): number => {\r\n  if (date === undefined) {\r\n    return Date.now()\r\n  }\r\n\r\n  if (typeof date === \"number\") {\r\n    const testDate = new Date(date)\r\n    if (isNaN(testDate.getTime())) {\r\n      throw new Error(\"Invalid timestamp provided\")\r\n    }\r\n\r\n    // Timestamps should be positive and not too far in the future\r\n    const now = Date.now()\r\n    const hundredYearsFromNow = now + 100 * 365 * 24 * 60 * 60 * 1000 // 100 years\r\n\r\n    if (date < 0 || date > hundredYearsFromNow) {\r\n      throw new Error(\"Timestamp is outside valid range\")\r\n    }\r\n\r\n    return date\r\n  }\r\n\r\n  const dateObj = new Date(date)\r\n\r\n  if (isNaN(dateObj.getTime())) {\r\n    throw new Error(\"Invalid date provided\")\r\n  }\r\n\r\n  return dateObj.getTime()\r\n}\r\n\r\n/**\r\n * Gets Unix timestamp in seconds\r\n * @param date - Optional Date object, date string, or timestamp. If not provided, uses current date\r\n * @returns Unix timestamp in seconds\r\n */\r\nexport const getUnixTimestamp = (date?: Date | string | number): number => {\r\n  return Math.floor(getUnixTimestampMs(date) / 1000)\r\n}\r\n\r\n/**\r\n * Gets the full year from a Date object or the current date\r\n * @param date - Optional Date object. If not provided, uses current date\r\n * @returns The full year (4 digits)\r\n */\r\nexport const getFullYear = (date?: Date): number => {\r\n  const targetDate = date || new Date()\r\n  return targetDate.getFullYear()\r\n}\r\n","/**\r\n * Environment detection utilities\r\n */\r\n\r\n/**\r\n * Determines if the current environment is Node.js\r\n * @returns true if running in Node.js, false otherwise\r\n */\r\nexport function isNodeEnvironment(): boolean {\r\n  return (\r\n    typeof process !== \"undefined\" &&\r\n    process.versions != null &&\r\n    process.versions.node != null\r\n  );\r\n}\r\n\r\n/**\r\n * Determines if the current environment is a browser\r\n * @returns true if running in a browser, false otherwise\r\n */\r\nexport function isBrowserEnvironment(): boolean {\r\n  return typeof window !== \"undefined\" && typeof document !== \"undefined\";\r\n}\r\n\r\n/**\r\n * Determines if the current environment is a web worker\r\n * @returns true if running in a web worker, false otherwise\r\n */\r\nexport function isWebWorkerEnvironment(): boolean {\r\n  return (\r\n    typeof (globalThis as any).importScripts === \"function\" &&\r\n    typeof window === \"undefined\"\r\n  );\r\n}\r\n\r\n/**\r\n * Gets the current runtime environment\r\n * @returns 'node' | 'browser' | 'webworker' | 'unknown'\r\n */\r\nexport function getEnvironment(): \"node\" | \"browser\" | \"webworker\" | \"unknown\" {\r\n  if (isNodeEnvironment()) return \"node\";\r\n  if (isBrowserEnvironment()) return \"browser\";\r\n  if (isWebWorkerEnvironment()) return \"webworker\";\r\n  return \"unknown\";\r\n}\r\n\r\n/**\r\n * Error thrown when functionality is not supported in the current environment\r\n */\r\nexport class EnvironmentError extends Error {\r\n  constructor(\r\n    message: string,\r\n    public readonly requiredEnvironment: string,\r\n    public readonly currentEnvironment: string\r\n  ) {\r\n    super(message);\r\n    this.name = \"EnvironmentError\";\r\n  }\r\n}\r\n\r\n/**\r\n * Asserts that the current environment is Node.js\r\n * @throws {EnvironmentError} if not running in Node.js\r\n */\r\nexport function assertNodeEnvironment(): void {\r\n  if (!isNodeEnvironment()) {\r\n    throw new EnvironmentError(\r\n      \"This functionality requires Node.js environment\",\r\n      \"node\",\r\n      getEnvironment()\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Asserts that the current environment is a browser\r\n * @throws {EnvironmentError} if not running in a browser\r\n */\r\nexport function assertBrowserEnvironment(): void {\r\n  if (!isBrowserEnvironment()) {\r\n    throw new EnvironmentError(\r\n      \"This functionality requires browser environment\",\r\n      \"browser\",\r\n      getEnvironment()\r\n    );\r\n  }\r\n}\r\n","/**\r\n * Helper function for enum filtering\r\n * Checks if a search value exists in an enum array and returns it with proper typing\r\n * @param enumArray - Array of enum values to search in\r\n * @param searchValue - Value to search for\r\n * @returns The typed enum value if found, undefined otherwise\r\n * @example\r\n * ```ts\r\n * const Status = ['active', 'inactive', 'pending'] as const;\r\n * const result = parseEnumValue(Status, 'active'); // 'active'\r\n * const invalid = parseEnumValue(Status, 'unknown'); // undefined\r\n * ```\r\n */\r\nexport const parseEnumValue = <T extends readonly string[]>(\r\n  enumArray: T,\r\n  value: string\r\n): T[number] | undefined => {\r\n  return enumArray.includes(value as T[number])\r\n    ? (value as T[number])\r\n    : undefined\r\n}\r\n\r\nexport const requireEnumValue = <T extends readonly string[]>(\r\n  enumArray: T,\r\n  value: string\r\n): T[number] => {\r\n  if (!enumArray.includes(value as T[number])) {\r\n    throw new Error(`Invalid enum value: ${value}`)\r\n  }\r\n  return value as T[number]\r\n}\r\n"]}