@digicroz/js-kit 1.0.4 โ 1.0.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +124 -19
- package/dist/index.cjs +100 -0
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +3 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.js +90 -1
- package/dist/index.js.map +1 -1
- package/dist/slug/index.cjs +65 -0
- package/dist/slug/index.cjs.map +1 -0
- package/dist/slug/index.d.cts +165 -0
- package/dist/slug/index.d.ts +165 -0
- package/dist/slug/index.js +57 -0
- package/dist/slug/index.js.map +1 -0
- package/dist/string/caseConversion/camelToSnake.cjs +22 -0
- package/dist/string/caseConversion/camelToSnake.cjs.map +1 -0
- package/dist/string/caseConversion/camelToSnake.d.cts +26 -0
- package/dist/string/caseConversion/camelToSnake.d.ts +26 -0
- package/dist/string/caseConversion/camelToSnake.js +19 -0
- package/dist/string/caseConversion/camelToSnake.js.map +1 -0
- package/dist/string/caseConversion/index.cjs +43 -0
- package/dist/string/caseConversion/index.cjs.map +1 -0
- package/dist/string/caseConversion/index.d.cts +2 -0
- package/dist/string/caseConversion/index.d.ts +2 -0
- package/dist/string/caseConversion/index.js +38 -0
- package/dist/string/caseConversion/index.js.map +1 -0
- package/dist/string/caseConversion/snakeToCamel.cjs +25 -0
- package/dist/string/caseConversion/snakeToCamel.cjs.map +1 -0
- package/dist/string/caseConversion/snakeToCamel.d.cts +24 -0
- package/dist/string/caseConversion/snakeToCamel.d.ts +24 -0
- package/dist/string/caseConversion/snakeToCamel.js +22 -0
- package/dist/string/caseConversion/snakeToCamel.js.map +1 -0
- package/dist/string/index.cjs +39 -0
- package/dist/string/index.cjs.map +1 -1
- package/dist/string/index.d.cts +2 -0
- package/dist/string/index.d.ts +2 -0
- package/dist/string/index.js +36 -1
- package/dist/string/index.js.map +1 -1
- package/package.json +42 -30
package/README.md
CHANGED
|
@@ -1,13 +1,29 @@
|
|
|
1
|
-
#
|
|
1
|
+
# @digicroz/js-kit
|
|
2
2
|
|
|
3
|
-
> **Modern TypeScript utility library with tree-shaking support** -
|
|
3
|
+
> **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.
|
|
4
4
|
|
|
5
|
-
[](https://www.npmjs.com/package/@digicroz/js-kit)
|
|
6
|
+
[](https://www.npmjs.com/package/@digicroz/js-kit)
|
|
7
|
+
[](https://bundlephobia.com/package/@digicroz/js-kit)
|
|
6
8
|
[](https://www.typescriptlang.org/)
|
|
9
|
+
[](https://github.com/digicroz/js-kit)
|
|
7
10
|
[](https://opensource.org/licenses/MIT)
|
|
8
11
|
[](https://webpack.js.org/guides/tree-shaking/)
|
|
9
12
|
|
|
10
|
-
|
|
13
|
+
**@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.
|
|
14
|
+
|
|
15
|
+
**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
|
|
16
|
+
|
|
17
|
+
## ๐ Why Choose @digicroz/js-kit?
|
|
18
|
+
|
|
19
|
+
- **๐ฏ Zero Dependencies** - No bloat, just pure utilities
|
|
20
|
+
- **๐ฆ Tiny Bundle Size** - Tree-shakeable ESM modules, import only what you need
|
|
21
|
+
- **๐ฏ 100% Test Coverage** - 211 comprehensive tests ensure reliability
|
|
22
|
+
- **๐ Type-Safe** - Full TypeScript support with excellent IntelliSense
|
|
23
|
+
- **โก Modern & Fast** - Built with modern JavaScript standards (ESM, CJS support)
|
|
24
|
+
- **๐ Universal** - Works in Node.js, browsers, React Native, and web workers
|
|
25
|
+
- **๐ Better than lodash** - Smaller, faster, more modern, with better TypeScript support
|
|
26
|
+
- **๐ Well Documented** - Comprehensive JSDoc comments and examples
|
|
11
27
|
|
|
12
28
|
## ๐ Environment Compatibility
|
|
13
29
|
|
|
@@ -20,7 +36,7 @@ This library is designed to work across multiple JavaScript environments:
|
|
|
20
36
|
|
|
21
37
|
- ๐ **TypeScript Support** - Full TypeScript support with type definitions
|
|
22
38
|
- ๐ฆ **Tree Shakable** - Import only what you need
|
|
23
|
-
- ๐งช **
|
|
39
|
+
- ๐งช **100% Test Coverage** - 211 tests with comprehensive coverage across all modules
|
|
24
40
|
- ๐ **Well Documented** - JSDoc comments for all functions
|
|
25
41
|
- ๐ง **Modern Build** - Built with tsup for optimal bundling
|
|
26
42
|
- ๐ก **Excellent IDE Support** - Full auto-completion and IntelliSense support
|
|
@@ -63,6 +79,10 @@ import {
|
|
|
63
79
|
convertToInt,
|
|
64
80
|
getUnixTimestamp,
|
|
65
81
|
isNodeEnvironment,
|
|
82
|
+
convertToSlug,
|
|
83
|
+
parseEnumValue,
|
|
84
|
+
toSnakeCase,
|
|
85
|
+
toCamelCase,
|
|
66
86
|
} from "@digicroz/js-kit"
|
|
67
87
|
|
|
68
88
|
// Array utilities
|
|
@@ -99,6 +119,22 @@ const timestamp = getUnixTimestamp()
|
|
|
99
119
|
// Environment utilities
|
|
100
120
|
const isNode = isNodeEnvironment()
|
|
101
121
|
// Result: true if running in Node.js
|
|
122
|
+
|
|
123
|
+
// Slug utilities
|
|
124
|
+
const slug = convertToSlug("Hello World!")
|
|
125
|
+
// Result: "hello-world"
|
|
126
|
+
|
|
127
|
+
// Enum utilities
|
|
128
|
+
const Status = ["active", "inactive"] as const
|
|
129
|
+
const status = parseEnumValue(Status, "active")
|
|
130
|
+
// Result: 'active'
|
|
131
|
+
|
|
132
|
+
// Case conversion utilities
|
|
133
|
+
const snakeCase = toSnakeCase("myVariableName")
|
|
134
|
+
// Result: "my_variable_name"
|
|
135
|
+
|
|
136
|
+
const camelCase = toCamelCase("my_variable_name")
|
|
137
|
+
// Result: "myVariableName"
|
|
102
138
|
```
|
|
103
139
|
|
|
104
140
|
### Tree-shaking Support
|
|
@@ -108,11 +144,22 @@ You can also import individual functions for optimal tree-shaking:
|
|
|
108
144
|
```typescript
|
|
109
145
|
// Universal utilities - individual imports
|
|
110
146
|
import { chunk } from "@digicroz/js-kit/array"
|
|
111
|
-
import {
|
|
147
|
+
import {
|
|
148
|
+
capitalize,
|
|
149
|
+
truncateText,
|
|
150
|
+
toSnakeCase,
|
|
151
|
+
toCamelCase,
|
|
152
|
+
} from "@digicroz/js-kit/string"
|
|
112
153
|
import { clamp, convertToInt } from "@digicroz/js-kit/number"
|
|
113
154
|
import { sleep, sleepMs } from "@digicroz/js-kit/sleep"
|
|
114
155
|
import { convertToSeconds, getUnixTimestamp } from "@digicroz/js-kit/time"
|
|
115
156
|
import { isNodeEnvironment, getEnvironment } from "@digicroz/js-kit/utils"
|
|
157
|
+
import {
|
|
158
|
+
convertToSlug,
|
|
159
|
+
isValidSlug,
|
|
160
|
+
generateUniqueSlug,
|
|
161
|
+
} from "@digicroz/js-kit/slug"
|
|
162
|
+
import { parseEnumValue, requireEnumValue } from "@digicroz/js-kit/enum"
|
|
116
163
|
|
|
117
164
|
// Universal bundle (recommended)
|
|
118
165
|
import {
|
|
@@ -128,15 +175,17 @@ import {
|
|
|
128
175
|
|
|
129
176
|
### โ
Universal Modules (Node.js + Browser + Web Workers)
|
|
130
177
|
|
|
131
|
-
| Module | Functions
|
|
132
|
-
| -------- |
|
|
133
|
-
| `array` | `chunk`
|
|
134
|
-
| `string` | `capitalize`, `capitalizeWords`, `
|
|
135
|
-
| `number` | `clamp`, `inRange`, `convertToInt`, `convertToTwoDecimalInt`, `randomNumberWithFixedLength`
|
|
136
|
-
| `
|
|
137
|
-
| `
|
|
138
|
-
| `
|
|
139
|
-
| `
|
|
178
|
+
| Module | Functions | Description |
|
|
179
|
+
| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
|
|
180
|
+
| `array` | `chunk` | Split arrays into chunks of specified size |
|
|
181
|
+
| `string` | `capitalize`, `capitalizeWords`, `randomStringWithFixedLength`, `truncateText`, `toSnakeCase`, `toCamelCase`, `objectKeysToSnakeCase`, `objectKeysToCamelCase` | String manipulation, formatting, and case conversion utilities |
|
|
182
|
+
| `number` | `clamp`, `inRange`, `convertToInt`, `convertToTwoDecimalInt`, `randomNumberWithFixedLength` | Number utilities including range operations |
|
|
183
|
+
| `slug` | `isValidSlug`, `convertToSlug`, `generateUniqueSlug`, `zodSlugValidation`, `zodSlugTransform`, `slugSchema`, `autoSlugSchema` | URL-safe slug generation and validation with Zod support |
|
|
184
|
+
| `enum` | `parseEnumValue`, `requireEnumValue` | Type-safe enum parsing and validation |
|
|
185
|
+
| `sleep` | `sleep`, `sleepMs`, `sleepSeconds`, `sleepMinutes`, `sleepUntil` | Promise-based sleep with flexible time options |
|
|
186
|
+
| `time` | `convertToSeconds`, `getUnixTimestamp`, `getUnixTimestampMs` | Time conversion and timestamp utilities |
|
|
187
|
+
| `utils` | `isNodeEnvironment`, `isBrowserEnvironment`, `isWebWorkerEnvironment`, `getEnvironment`, `assertNodeEnvironment`, `assertBrowserEnvironment` | Environment detection and assertions |
|
|
188
|
+
| `types` | `Prettify` | Utility types for TypeScript development |
|
|
140
189
|
|
|
141
190
|
## TypeScript Configuration
|
|
142
191
|
|
|
@@ -189,8 +238,10 @@ For comprehensive documentation with examples, advanced usage patterns, and best
|
|
|
189
238
|
|
|
190
239
|
- **[๐ข Array Utilities](./src/array/array.md)** - Array manipulation and chunking utilities
|
|
191
240
|
- **[๐ข Number Utilities](./src/number/number.md)** - Number clamping, conversion, and range validation
|
|
241
|
+
- **[๐ Slug Utilities](./src/slug/slug.md)** - URL-safe slug generation and validation
|
|
242
|
+
- **[๐ Enum Utilities](./src/enum/enum.md)** - Type-safe enum parsing and validation
|
|
192
243
|
- **[โฐ Sleep Utilities](./src/sleep/sleep.md)** - Advanced sleep and timing functions
|
|
193
|
-
- **[๐ String Utilities](./src/string/string.md)** - String manipulation and
|
|
244
|
+
- **[๐ String Utilities](./src/string/string.md)** - String manipulation, formatting, and case conversion
|
|
194
245
|
- **[โฐ Time Utilities](./src/time/time.md)** - Time conversion and duration utilities
|
|
195
246
|
- **[๐ Environment Utilities](./src/utils/utils.md)** - Environment detection and cross-platform utilities
|
|
196
247
|
|
|
@@ -204,9 +255,12 @@ For comprehensive documentation with examples, advanced usage patterns, and best
|
|
|
204
255
|
|
|
205
256
|
- `capitalize(str: string): string` - Capitalizes the first letter of a string
|
|
206
257
|
- `capitalizeWords(str: string): string` - Capitalizes the first letter of each word
|
|
207
|
-
- `convertCamelToNormalCapitalized(str: string): string` - Converts camelCase to Normal Capitalized format
|
|
208
258
|
- `randomStringWithFixedLength(length: number): string` - Generates a random string with fixed length
|
|
209
259
|
- `truncateText(options: TruncateTextOptions): string` - Truncates text with customizable options
|
|
260
|
+
- `toSnakeCase<T extends string>(value: T): ToSnakeCaseResult<T>` - Converts camelCase to snake_case
|
|
261
|
+
- `toCamelCase<T extends string>(str: T): ToCamelCaseResult<T>` - Converts snake_case to camelCase
|
|
262
|
+
- `objectKeysToSnakeCase<T>(obj: T): ObjectKeysToSnakeCaseResult<T>` - Recursively converts object keys to snake_case
|
|
263
|
+
- `objectKeysToCamelCase<T>(obj: T): ObjectKeysToCamelCaseResult<T>` - Recursively converts object keys to camelCase
|
|
210
264
|
|
|
211
265
|
#### Number Utilities
|
|
212
266
|
|
|
@@ -216,6 +270,21 @@ For comprehensive documentation with examples, advanced usage patterns, and best
|
|
|
216
270
|
- `convertToTwoDecimalInt(data: any): number` - Converts to number with 2 decimal places
|
|
217
271
|
- `randomNumberWithFixedLength(length: number): number` - Generates random number with fixed length
|
|
218
272
|
|
|
273
|
+
#### Slug Utilities
|
|
274
|
+
|
|
275
|
+
- `isValidSlug(slug: string): boolean` - Validates if a string is a valid URL slug
|
|
276
|
+
- `convertToSlug(text: string, options?): string` - Converts text to a URL-safe slug
|
|
277
|
+
- `generateUniqueSlug(baseText: string, existingSlugs: string[]): string` - Generates a unique slug
|
|
278
|
+
- `zodSlugValidation(message?: string)` - Zod validation for slug format
|
|
279
|
+
- `zodSlugTransform(options?)` - Zod transform that converts text to slug
|
|
280
|
+
- `slugSchema` - Pre-configured Zod schemas for slug validation
|
|
281
|
+
- `autoSlugSchema` - Pre-configured Zod schemas for automatic slug generation
|
|
282
|
+
|
|
283
|
+
#### Enum Utilities
|
|
284
|
+
|
|
285
|
+
- `parseEnumValue<T>(enumArray: T, value: string): T[number] | undefined` - Safely parses enum value
|
|
286
|
+
- `requireEnumValue<T>(enumArray: T, value: string): T[number]` - Parses enum value or throws error
|
|
287
|
+
|
|
219
288
|
#### Sleep Utilities
|
|
220
289
|
|
|
221
290
|
- `sleep(params: TSleepParams): Promise<void>` - Advanced sleep with flexible options
|
|
@@ -260,8 +329,44 @@ npm run type-check
|
|
|
260
329
|
|
|
261
330
|
# Run tests
|
|
262
331
|
npm run test
|
|
332
|
+
|
|
333
|
+
# Run tests with coverage
|
|
334
|
+
npm run test:coverage
|
|
335
|
+
|
|
336
|
+
# Run tests in watch mode
|
|
337
|
+
npm run test:watch
|
|
263
338
|
```
|
|
264
339
|
|
|
265
|
-
##
|
|
340
|
+
## ๐ค Contributing
|
|
341
|
+
|
|
342
|
+
Contributions are welcome! Please feel free to submit a Pull Request.
|
|
343
|
+
|
|
344
|
+
1. Fork the repository
|
|
345
|
+
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
|
|
346
|
+
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
|
|
347
|
+
4. Push to the branch (`git push origin feature/AmazingFeature`)
|
|
348
|
+
5. Open a Pull Request
|
|
349
|
+
|
|
350
|
+
## ๐ค Author
|
|
351
|
+
|
|
352
|
+
**Adarsh Hatkar**
|
|
353
|
+
|
|
354
|
+
- GitHub: [@AdarshHatkar](https://github.com/AdarshHatkar)
|
|
355
|
+
- Organization: [@digicroz](https://github.com/digicroz)
|
|
356
|
+
|
|
357
|
+
## ๐ Links
|
|
358
|
+
|
|
359
|
+
- [NPM Package](https://www.npmjs.com/package/@digicroz/js-kit)
|
|
360
|
+
- [GitHub Repository](https://github.com/digicroz/js-kit)
|
|
361
|
+
- [Issue Tracker](https://github.com/digicroz/js-kit/issues)
|
|
362
|
+
- [Changelog](https://github.com/digicroz/js-kit/releases)
|
|
363
|
+
|
|
364
|
+
## โญ Show Your Support
|
|
365
|
+
|
|
366
|
+
Give a โญ๏ธ if this project helped you!
|
|
367
|
+
|
|
368
|
+
## ๐ License
|
|
369
|
+
|
|
370
|
+
MIT ยฉ [Adarsh Hatkar](https://github.com/AdarshHatkar)
|
|
266
371
|
|
|
267
|
-
|
|
372
|
+
Copyright (c) 2025 Adarsh Hatkar
|
package/dist/index.cjs
CHANGED
|
@@ -49,6 +49,41 @@ function truncateText({
|
|
|
49
49
|
return text.length > maxLength ? text.substring(0, maxLength) + suffix : text;
|
|
50
50
|
}
|
|
51
51
|
|
|
52
|
+
// src/string/caseConversion/camelToSnake.ts
|
|
53
|
+
var toSnakeCase = (value) => {
|
|
54
|
+
return value.replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2").replace(/([a-z\d])([A-Z])/g, "$1_$2").toLowerCase();
|
|
55
|
+
};
|
|
56
|
+
function objectKeysToSnakeCase(obj) {
|
|
57
|
+
if (obj === null || typeof obj !== "object") return obj;
|
|
58
|
+
if (Array.isArray(obj)) {
|
|
59
|
+
return obj.map(objectKeysToSnakeCase);
|
|
60
|
+
}
|
|
61
|
+
return Object.keys(obj).reduce((acc, key) => {
|
|
62
|
+
const snakeKey = toSnakeCase(key);
|
|
63
|
+
acc[snakeKey] = objectKeysToSnakeCase(obj[key]);
|
|
64
|
+
return acc;
|
|
65
|
+
}, {});
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
// src/string/caseConversion/snakeToCamel.ts
|
|
69
|
+
var toCamelCase = (str) => {
|
|
70
|
+
return str.replace(
|
|
71
|
+
/_([a-z])/g,
|
|
72
|
+
(_, char) => char.toUpperCase()
|
|
73
|
+
);
|
|
74
|
+
};
|
|
75
|
+
function objectKeysToCamelCase(obj) {
|
|
76
|
+
if (obj === null || typeof obj !== "object") return obj;
|
|
77
|
+
if (Array.isArray(obj)) {
|
|
78
|
+
return obj.map(objectKeysToCamelCase);
|
|
79
|
+
}
|
|
80
|
+
return Object.keys(obj).reduce((acc, key) => {
|
|
81
|
+
const camelKey = toCamelCase(key);
|
|
82
|
+
acc[camelKey] = objectKeysToCamelCase(obj[key]);
|
|
83
|
+
return acc;
|
|
84
|
+
}, {});
|
|
85
|
+
}
|
|
86
|
+
|
|
52
87
|
// src/string/index.ts
|
|
53
88
|
function randomStringWithFixedLength(length) {
|
|
54
89
|
if (!Number.isInteger(length) || length <= 0) {
|
|
@@ -57,6 +92,60 @@ function randomStringWithFixedLength(length) {
|
|
|
57
92
|
return Array.from({ length }, () => Math.random().toString(36)[2]).join("");
|
|
58
93
|
}
|
|
59
94
|
|
|
95
|
+
// src/slug/index.ts
|
|
96
|
+
function isValidSlug(slug) {
|
|
97
|
+
if (!slug || typeof slug !== "string") {
|
|
98
|
+
return false;
|
|
99
|
+
}
|
|
100
|
+
const slugPattern = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
|
|
101
|
+
return slugPattern.test(slug);
|
|
102
|
+
}
|
|
103
|
+
function convertToSlug(text, options = {}) {
|
|
104
|
+
const { separator = "-" } = options;
|
|
105
|
+
if (!text || typeof text !== "string") {
|
|
106
|
+
return "";
|
|
107
|
+
}
|
|
108
|
+
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"), "");
|
|
109
|
+
}
|
|
110
|
+
function generateUniqueSlug(baseSlug, existingSlugs, options = {}) {
|
|
111
|
+
const { separator = "-" } = options;
|
|
112
|
+
if (!existingSlugs.includes(baseSlug)) {
|
|
113
|
+
return baseSlug;
|
|
114
|
+
}
|
|
115
|
+
let counter = 1;
|
|
116
|
+
let uniqueSlug = `${baseSlug}${separator}${counter}`;
|
|
117
|
+
while (existingSlugs.includes(uniqueSlug)) {
|
|
118
|
+
counter++;
|
|
119
|
+
uniqueSlug = `${baseSlug}${separator}${counter}`;
|
|
120
|
+
}
|
|
121
|
+
return uniqueSlug;
|
|
122
|
+
}
|
|
123
|
+
function zodSlugValidation(message) {
|
|
124
|
+
return (val) => isValidSlug(val);
|
|
125
|
+
}
|
|
126
|
+
function zodSlugTransform(options) {
|
|
127
|
+
return (val) => convertToSlug(val, options);
|
|
128
|
+
}
|
|
129
|
+
var slugSchema = {
|
|
130
|
+
/**
|
|
131
|
+
* Get a Zod string schema that validates slug format
|
|
132
|
+
* Requires zod to be installed: npm install zod
|
|
133
|
+
*/
|
|
134
|
+
create: (customMessage) => {
|
|
135
|
+
return {
|
|
136
|
+
_type: "slug-validator",
|
|
137
|
+
validate: zodSlugValidation(),
|
|
138
|
+
message: customMessage || "Must be a valid slug (lowercase, alphanumeric, and hyphens only, no consecutive hyphens)"
|
|
139
|
+
};
|
|
140
|
+
}
|
|
141
|
+
};
|
|
142
|
+
var autoSlugSchema = {
|
|
143
|
+
/**
|
|
144
|
+
* Get a transform function for Zod
|
|
145
|
+
*/
|
|
146
|
+
transform: (options) => zodSlugTransform(options)
|
|
147
|
+
};
|
|
148
|
+
|
|
60
149
|
// src/number/index.ts
|
|
61
150
|
function clamp(number, lower, upper) {
|
|
62
151
|
if (typeof number !== "number" || typeof lower !== "number" || typeof upper !== "number") {
|
|
@@ -297,6 +386,7 @@ var requireEnumValue = (enumArray, value) => {
|
|
|
297
386
|
exports.EnvironmentError = EnvironmentError;
|
|
298
387
|
exports.assertBrowserEnvironment = assertBrowserEnvironment;
|
|
299
388
|
exports.assertNodeEnvironment = assertNodeEnvironment;
|
|
389
|
+
exports.autoSlugSchema = autoSlugSchema;
|
|
300
390
|
exports.capitalize = capitalize;
|
|
301
391
|
exports.capitalizeWords = capitalizeWords;
|
|
302
392
|
exports.chunk = chunk;
|
|
@@ -304,7 +394,9 @@ exports.clamp = clamp;
|
|
|
304
394
|
exports.convertCamelToNormalCapitalized = convertCamelToNormalCapitalized;
|
|
305
395
|
exports.convertToInt = convertToInt;
|
|
306
396
|
exports.convertToSeconds = convertToSeconds;
|
|
397
|
+
exports.convertToSlug = convertToSlug;
|
|
307
398
|
exports.convertToTwoDecimalInt = convertToTwoDecimalInt;
|
|
399
|
+
exports.generateUniqueSlug = generateUniqueSlug;
|
|
308
400
|
exports.getEnvironment = getEnvironment;
|
|
309
401
|
exports.getFullYear = getFullYear;
|
|
310
402
|
exports.getUnixTimestamp = getUnixTimestamp;
|
|
@@ -312,7 +404,10 @@ exports.getUnixTimestampMs = getUnixTimestampMs;
|
|
|
312
404
|
exports.inRange = inRange;
|
|
313
405
|
exports.isBrowserEnvironment = isBrowserEnvironment;
|
|
314
406
|
exports.isNodeEnvironment = isNodeEnvironment;
|
|
407
|
+
exports.isValidSlug = isValidSlug;
|
|
315
408
|
exports.isWebWorkerEnvironment = isWebWorkerEnvironment;
|
|
409
|
+
exports.objectKeysToCamelCase = objectKeysToCamelCase;
|
|
410
|
+
exports.objectKeysToSnakeCase = objectKeysToSnakeCase;
|
|
316
411
|
exports.parseEnumValue = parseEnumValue;
|
|
317
412
|
exports.randomNumberWithFixedLength = randomNumberWithFixedLength;
|
|
318
413
|
exports.randomStringWithFixedLength = randomStringWithFixedLength;
|
|
@@ -322,6 +417,11 @@ exports.sleepMinutes = sleepMinutes;
|
|
|
322
417
|
exports.sleepMs = sleepMs;
|
|
323
418
|
exports.sleepSeconds = sleepSeconds;
|
|
324
419
|
exports.sleepUntil = sleepUntil;
|
|
420
|
+
exports.slugSchema = slugSchema;
|
|
421
|
+
exports.toCamelCase = toCamelCase;
|
|
422
|
+
exports.toSnakeCase = toSnakeCase;
|
|
325
423
|
exports.truncateText = truncateText;
|
|
424
|
+
exports.zodSlugTransform = zodSlugTransform;
|
|
425
|
+
exports.zodSlugValidation = zodSlugValidation;
|
|
326
426
|
//# sourceMappingURL=index.cjs.map
|
|
327
427
|
//# sourceMappingURL=index.cjs.map
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +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","../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","\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 (\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"]}
|
|
1
|
+
{"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"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
export { chunk } from './array/index.cjs';
|
|
2
2
|
export { randomStringWithFixedLength } from './string/index.cjs';
|
|
3
|
+
export { autoSlugSchema, convertToSlug, generateUniqueSlug, isValidSlug, slugSchema, zodSlugTransform, zodSlugValidation } from './slug/index.cjs';
|
|
3
4
|
export { clamp, convertToInt, convertToTwoDecimalInt, inRange, randomNumberWithFixedLength } from './number/index.cjs';
|
|
4
5
|
export { TSleepParams, TSleepReturn, sleep, sleepMinutes, sleepMs, sleepSeconds, sleepUntil } from './sleep/index.cjs';
|
|
5
6
|
export { convertToSeconds, getFullYear, getUnixTimestamp, getUnixTimestampMs } from './time/index.cjs';
|
|
@@ -8,3 +9,5 @@ export { Prettify } from './types/index.cjs';
|
|
|
8
9
|
export { parseEnumValue, requireEnumValue } from './enum/index.cjs';
|
|
9
10
|
export { capitalize, capitalizeWords, convertCamelToNormalCapitalized } from './string/capitalize.cjs';
|
|
10
11
|
export { TruncateTextOptions, truncateText } from './string/truncate.cjs';
|
|
12
|
+
export { ObjectKeysToSnakeCaseResult, ToSnakeCaseResult, objectKeysToSnakeCase, toSnakeCase } from './string/caseConversion/camelToSnake.cjs';
|
|
13
|
+
export { ObjectKeysToCamelCaseResult, ToCamelCaseResult, objectKeysToCamelCase, toCamelCase } from './string/caseConversion/snakeToCamel.cjs';
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
export { chunk } from './array/index.js';
|
|
2
2
|
export { randomStringWithFixedLength } from './string/index.js';
|
|
3
|
+
export { autoSlugSchema, convertToSlug, generateUniqueSlug, isValidSlug, slugSchema, zodSlugTransform, zodSlugValidation } from './slug/index.js';
|
|
3
4
|
export { clamp, convertToInt, convertToTwoDecimalInt, inRange, randomNumberWithFixedLength } from './number/index.js';
|
|
4
5
|
export { TSleepParams, TSleepReturn, sleep, sleepMinutes, sleepMs, sleepSeconds, sleepUntil } from './sleep/index.js';
|
|
5
6
|
export { convertToSeconds, getFullYear, getUnixTimestamp, getUnixTimestampMs } from './time/index.js';
|
|
@@ -8,3 +9,5 @@ export { Prettify } from './types/index.js';
|
|
|
8
9
|
export { parseEnumValue, requireEnumValue } from './enum/index.js';
|
|
9
10
|
export { capitalize, capitalizeWords, convertCamelToNormalCapitalized } from './string/capitalize.js';
|
|
10
11
|
export { TruncateTextOptions, truncateText } from './string/truncate.js';
|
|
12
|
+
export { ObjectKeysToSnakeCaseResult, ToSnakeCaseResult, objectKeysToSnakeCase, toSnakeCase } from './string/caseConversion/camelToSnake.js';
|
|
13
|
+
export { ObjectKeysToCamelCaseResult, ToCamelCaseResult, objectKeysToCamelCase, toCamelCase } from './string/caseConversion/snakeToCamel.js';
|