@alextheman/utility 1.24.0 → 2.0.0
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/dist/index.cjs +22 -72
- package/dist/index.d.cts +7 -15
- package/dist/index.d.ts +7 -15
- package/dist/index.js +22 -70
- package/package.json +5 -5
package/dist/index.cjs
CHANGED
|
@@ -41,26 +41,6 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
|
|
|
41
41
|
));
|
|
42
42
|
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
43
43
|
var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
|
|
44
|
-
var __async = (__this, __arguments, generator) => {
|
|
45
|
-
return new Promise((resolve, reject) => {
|
|
46
|
-
var fulfilled = (value) => {
|
|
47
|
-
try {
|
|
48
|
-
step(generator.next(value));
|
|
49
|
-
} catch (e) {
|
|
50
|
-
reject(e);
|
|
51
|
-
}
|
|
52
|
-
};
|
|
53
|
-
var rejected = (value) => {
|
|
54
|
-
try {
|
|
55
|
-
step(generator.throw(value));
|
|
56
|
-
} catch (e) {
|
|
57
|
-
reject(e);
|
|
58
|
-
}
|
|
59
|
-
};
|
|
60
|
-
var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
|
|
61
|
-
step((generator = generator.apply(__this, __arguments)).next());
|
|
62
|
-
});
|
|
63
|
-
};
|
|
64
44
|
|
|
65
45
|
// src/index.ts
|
|
66
46
|
var index_exports = {};
|
|
@@ -70,7 +50,6 @@ __export(index_exports, {
|
|
|
70
50
|
appendSemicolon: () => appendSemicolon_default,
|
|
71
51
|
convertFileToBase64: () => convertFileToBase64_default,
|
|
72
52
|
fillArray: () => fillArray_default,
|
|
73
|
-
fillArrayAsync: () => fillArrayAsync_default,
|
|
74
53
|
formatDateAndTime: () => formatDateAndTime_default,
|
|
75
54
|
getRandomNumber: () => getRandomNumber_default,
|
|
76
55
|
httpErrorCodeLookup: () => httpErrorCodeLookup,
|
|
@@ -85,7 +64,6 @@ __export(index_exports, {
|
|
|
85
64
|
randomiseArray: () => randomiseArray_default,
|
|
86
65
|
range: () => range_default,
|
|
87
66
|
truncate: () => truncate_default,
|
|
88
|
-
validateUUID: () => validateUUID_default,
|
|
89
67
|
wait: () => wait_default
|
|
90
68
|
});
|
|
91
69
|
module.exports = __toCommonJS(index_exports);
|
|
@@ -145,18 +123,6 @@ function fillArray(callback, length = 1) {
|
|
|
145
123
|
}
|
|
146
124
|
var fillArray_default = fillArray;
|
|
147
125
|
|
|
148
|
-
// src/functions/fillArrayAsync.ts
|
|
149
|
-
function fillArrayAsync(callback, length = 1) {
|
|
150
|
-
return __async(this, null, function* () {
|
|
151
|
-
return Promise.all(
|
|
152
|
-
new Array(length).fill(null).map((_, index) => __async(null, null, function* () {
|
|
153
|
-
return yield callback(index);
|
|
154
|
-
}))
|
|
155
|
-
);
|
|
156
|
-
});
|
|
157
|
-
}
|
|
158
|
-
var fillArrayAsync_default = fillArrayAsync;
|
|
159
|
-
|
|
160
126
|
// src/functions/isSameDate.ts
|
|
161
127
|
function isSameDate(firstDate, secondDate) {
|
|
162
128
|
return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth() && firstDate.getFullYear() === secondDate.getFullYear();
|
|
@@ -289,8 +255,28 @@ function truncate(stringToTruncate, maxLength = 5) {
|
|
|
289
255
|
}
|
|
290
256
|
var truncate_default = truncate;
|
|
291
257
|
|
|
292
|
-
// src/functions/
|
|
293
|
-
|
|
258
|
+
// src/functions/wait.ts
|
|
259
|
+
function wait(seconds) {
|
|
260
|
+
return new Promise((resolve, _) => {
|
|
261
|
+
setTimeout(() => {
|
|
262
|
+
resolve();
|
|
263
|
+
}, seconds * 1e3);
|
|
264
|
+
});
|
|
265
|
+
}
|
|
266
|
+
var wait_default = wait;
|
|
267
|
+
|
|
268
|
+
// src/functions/taggedTemplate/interpolateObjects.ts
|
|
269
|
+
function interpolateObjects(strings, ...values) {
|
|
270
|
+
let result = "";
|
|
271
|
+
for (let i = 0; i < strings.length; i++) {
|
|
272
|
+
result += strings[i];
|
|
273
|
+
if (i !== strings.length - 1) {
|
|
274
|
+
result += values[i] && typeof values[i] === "object" ? JSON.stringify(values[i]) : values[i];
|
|
275
|
+
}
|
|
276
|
+
}
|
|
277
|
+
return result;
|
|
278
|
+
}
|
|
279
|
+
var interpolateObjects_default = interpolateObjects;
|
|
294
280
|
|
|
295
281
|
// src/types/APIError.ts
|
|
296
282
|
var httpErrorCodeLookup = {
|
|
@@ -347,40 +333,6 @@ function parseUUID(UUID) {
|
|
|
347
333
|
return uuidSchema.parse(UUID);
|
|
348
334
|
}
|
|
349
335
|
var UUID_default = parseUUID;
|
|
350
|
-
|
|
351
|
-
// src/functions/validateUUID.ts
|
|
352
|
-
function validateUUID(UUID, error = new APIError_default(400, "INVALID_UUID")) {
|
|
353
|
-
const uuidSchema2 = import_zod4.default.uuid();
|
|
354
|
-
const parsedUUID = uuidSchema2.safeParse(UUID);
|
|
355
|
-
if (!parsedUUID.success) {
|
|
356
|
-
throw error;
|
|
357
|
-
}
|
|
358
|
-
return parsedUUID.data;
|
|
359
|
-
}
|
|
360
|
-
var validateUUID_default = validateUUID;
|
|
361
|
-
|
|
362
|
-
// src/functions/wait.ts
|
|
363
|
-
function wait(seconds) {
|
|
364
|
-
return new Promise((resolve, _) => {
|
|
365
|
-
setTimeout(() => {
|
|
366
|
-
resolve();
|
|
367
|
-
}, seconds * 1e3);
|
|
368
|
-
});
|
|
369
|
-
}
|
|
370
|
-
var wait_default = wait;
|
|
371
|
-
|
|
372
|
-
// src/functions/taggedTemplate/interpolateObjects.ts
|
|
373
|
-
function interpolateObjects(strings, ...values) {
|
|
374
|
-
let result = "";
|
|
375
|
-
for (let i = 0; i < strings.length; i++) {
|
|
376
|
-
result += strings[i];
|
|
377
|
-
if (i !== strings.length - 1) {
|
|
378
|
-
result += values[i] && typeof values[i] === "object" ? JSON.stringify(values[i]) : values[i];
|
|
379
|
-
}
|
|
380
|
-
}
|
|
381
|
-
return result;
|
|
382
|
-
}
|
|
383
|
-
var interpolateObjects_default = interpolateObjects;
|
|
384
336
|
// Annotate the CommonJS export names for ESM import in node:
|
|
385
337
|
0 && (module.exports = {
|
|
386
338
|
APIError,
|
|
@@ -388,7 +340,6 @@ var interpolateObjects_default = interpolateObjects;
|
|
|
388
340
|
appendSemicolon,
|
|
389
341
|
convertFileToBase64,
|
|
390
342
|
fillArray,
|
|
391
|
-
fillArrayAsync,
|
|
392
343
|
formatDateAndTime,
|
|
393
344
|
getRandomNumber,
|
|
394
345
|
httpErrorCodeLookup,
|
|
@@ -403,6 +354,5 @@ var interpolateObjects_default = interpolateObjects;
|
|
|
403
354
|
randomiseArray,
|
|
404
355
|
range,
|
|
405
356
|
truncate,
|
|
406
|
-
validateUUID,
|
|
407
357
|
wait
|
|
408
358
|
});
|
package/dist/index.d.cts
CHANGED
|
@@ -8,11 +8,6 @@ declare function convertFileToBase64(file: File): Promise<string>;
|
|
|
8
8
|
|
|
9
9
|
declare function fillArray<T>(callback: (index: number) => T | Promise<T>, length?: number): T[] | Promise<T[]>;
|
|
10
10
|
|
|
11
|
-
/**
|
|
12
|
-
* @deprecated The functionality of fillArrayAsync has been combined with fillArray, so fillArray should now be used instead.
|
|
13
|
-
*/
|
|
14
|
-
declare function fillArrayAsync<T>(callback: (index: number) => Promise<T>, length?: number): Promise<T[]>;
|
|
15
|
-
|
|
16
11
|
declare function formatDateAndTime(inputDate: Date): string;
|
|
17
12
|
|
|
18
13
|
declare function getRandomNumber(lowerBound: number, upperBound: number): number;
|
|
@@ -31,6 +26,10 @@ declare function range(start: number, stop: number, step?: number): number[];
|
|
|
31
26
|
|
|
32
27
|
declare function truncate(stringToTruncate: string, maxLength?: number): string;
|
|
33
28
|
|
|
29
|
+
declare function wait(seconds: number): Promise<void>;
|
|
30
|
+
|
|
31
|
+
declare function interpolateObjects(strings: TemplateStringsArray, ...values: unknown[]): string;
|
|
32
|
+
|
|
34
33
|
type HTTPErrorCodes = 400 | 401 | 403 | 404 | 418 | 500;
|
|
35
34
|
declare const httpErrorCodeLookup: Record<HTTPErrorCodes, string>;
|
|
36
35
|
declare class APIError extends Error {
|
|
@@ -55,15 +54,8 @@ declare const uuidSchema: z.core.$ZodBranded<z.ZodUUID, "UUID">;
|
|
|
55
54
|
type UUID = z.infer<typeof uuidSchema>;
|
|
56
55
|
declare function parseUUID(UUID: unknown): UUID;
|
|
57
56
|
|
|
58
|
-
type
|
|
57
|
+
type DisallowUndefined<T> = undefined extends T ? ["Error: Generic type cannot include undefined"] : T;
|
|
59
58
|
|
|
60
|
-
|
|
61
|
-
* @deprecated validateUUID() is deprecated in favour of parseUUID()
|
|
62
|
-
*/
|
|
63
|
-
declare function validateUUID(UUID: string, error?: Error | APIError): string;
|
|
64
|
-
|
|
65
|
-
declare function wait(seconds: number): Promise<void>;
|
|
66
|
-
|
|
67
|
-
declare function interpolateObjects(strings: TemplateStringsArray, ...values: unknown[]): string;
|
|
59
|
+
type NonUndefined<T> = T extends undefined ? never : T;
|
|
68
60
|
|
|
69
|
-
export { APIError, type Email, type Env, type HTTPErrorCodes, type NonUndefined, type UUID, addDaysToDate, appendSemicolon, convertFileToBase64, fillArray,
|
|
61
|
+
export { APIError, type DisallowUndefined, type Email, type Env, type HTTPErrorCodes, type NonUndefined, type UUID, addDaysToDate, appendSemicolon, convertFileToBase64, fillArray, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isSameDate, omitProperties, parseEmail, parseEnv, parseUUID, randomiseArray, range, truncate, wait };
|
package/dist/index.d.ts
CHANGED
|
@@ -8,11 +8,6 @@ declare function convertFileToBase64(file: File): Promise<string>;
|
|
|
8
8
|
|
|
9
9
|
declare function fillArray<T>(callback: (index: number) => T | Promise<T>, length?: number): T[] | Promise<T[]>;
|
|
10
10
|
|
|
11
|
-
/**
|
|
12
|
-
* @deprecated The functionality of fillArrayAsync has been combined with fillArray, so fillArray should now be used instead.
|
|
13
|
-
*/
|
|
14
|
-
declare function fillArrayAsync<T>(callback: (index: number) => Promise<T>, length?: number): Promise<T[]>;
|
|
15
|
-
|
|
16
11
|
declare function formatDateAndTime(inputDate: Date): string;
|
|
17
12
|
|
|
18
13
|
declare function getRandomNumber(lowerBound: number, upperBound: number): number;
|
|
@@ -31,6 +26,10 @@ declare function range(start: number, stop: number, step?: number): number[];
|
|
|
31
26
|
|
|
32
27
|
declare function truncate(stringToTruncate: string, maxLength?: number): string;
|
|
33
28
|
|
|
29
|
+
declare function wait(seconds: number): Promise<void>;
|
|
30
|
+
|
|
31
|
+
declare function interpolateObjects(strings: TemplateStringsArray, ...values: unknown[]): string;
|
|
32
|
+
|
|
34
33
|
type HTTPErrorCodes = 400 | 401 | 403 | 404 | 418 | 500;
|
|
35
34
|
declare const httpErrorCodeLookup: Record<HTTPErrorCodes, string>;
|
|
36
35
|
declare class APIError extends Error {
|
|
@@ -55,15 +54,8 @@ declare const uuidSchema: z.core.$ZodBranded<z.ZodUUID, "UUID">;
|
|
|
55
54
|
type UUID = z.infer<typeof uuidSchema>;
|
|
56
55
|
declare function parseUUID(UUID: unknown): UUID;
|
|
57
56
|
|
|
58
|
-
type
|
|
57
|
+
type DisallowUndefined<T> = undefined extends T ? ["Error: Generic type cannot include undefined"] : T;
|
|
59
58
|
|
|
60
|
-
|
|
61
|
-
* @deprecated validateUUID() is deprecated in favour of parseUUID()
|
|
62
|
-
*/
|
|
63
|
-
declare function validateUUID(UUID: string, error?: Error | APIError): string;
|
|
64
|
-
|
|
65
|
-
declare function wait(seconds: number): Promise<void>;
|
|
66
|
-
|
|
67
|
-
declare function interpolateObjects(strings: TemplateStringsArray, ...values: unknown[]): string;
|
|
59
|
+
type NonUndefined<T> = T extends undefined ? never : T;
|
|
68
60
|
|
|
69
|
-
export { APIError, type Email, type Env, type HTTPErrorCodes, type NonUndefined, type UUID, addDaysToDate, appendSemicolon, convertFileToBase64, fillArray,
|
|
61
|
+
export { APIError, type DisallowUndefined, type Email, type Env, type HTTPErrorCodes, type NonUndefined, type UUID, addDaysToDate, appendSemicolon, convertFileToBase64, fillArray, formatDateAndTime, getRandomNumber, httpErrorCodeLookup, interpolateObjects, isLeapYear, isMonthlyMultiple, isSameDate, omitProperties, parseEmail, parseEnv, parseUUID, randomiseArray, range, truncate, wait };
|
package/dist/index.js
CHANGED
|
@@ -15,26 +15,6 @@ var __spreadValues = (a, b) => {
|
|
|
15
15
|
return a;
|
|
16
16
|
};
|
|
17
17
|
var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
|
|
18
|
-
var __async = (__this, __arguments, generator) => {
|
|
19
|
-
return new Promise((resolve, reject) => {
|
|
20
|
-
var fulfilled = (value) => {
|
|
21
|
-
try {
|
|
22
|
-
step(generator.next(value));
|
|
23
|
-
} catch (e) {
|
|
24
|
-
reject(e);
|
|
25
|
-
}
|
|
26
|
-
};
|
|
27
|
-
var rejected = (value) => {
|
|
28
|
-
try {
|
|
29
|
-
step(generator.throw(value));
|
|
30
|
-
} catch (e) {
|
|
31
|
-
reject(e);
|
|
32
|
-
}
|
|
33
|
-
};
|
|
34
|
-
var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
|
|
35
|
-
step((generator = generator.apply(__this, __arguments)).next());
|
|
36
|
-
});
|
|
37
|
-
};
|
|
38
18
|
|
|
39
19
|
// src/functions/addDaysToDate.ts
|
|
40
20
|
function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement = 1) {
|
|
@@ -91,18 +71,6 @@ function fillArray(callback, length = 1) {
|
|
|
91
71
|
}
|
|
92
72
|
var fillArray_default = fillArray;
|
|
93
73
|
|
|
94
|
-
// src/functions/fillArrayAsync.ts
|
|
95
|
-
function fillArrayAsync(callback, length = 1) {
|
|
96
|
-
return __async(this, null, function* () {
|
|
97
|
-
return Promise.all(
|
|
98
|
-
new Array(length).fill(null).map((_, index) => __async(null, null, function* () {
|
|
99
|
-
return yield callback(index);
|
|
100
|
-
}))
|
|
101
|
-
);
|
|
102
|
-
});
|
|
103
|
-
}
|
|
104
|
-
var fillArrayAsync_default = fillArrayAsync;
|
|
105
|
-
|
|
106
74
|
// src/functions/isSameDate.ts
|
|
107
75
|
function isSameDate(firstDate, secondDate) {
|
|
108
76
|
return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth() && firstDate.getFullYear() === secondDate.getFullYear();
|
|
@@ -235,8 +203,28 @@ function truncate(stringToTruncate, maxLength = 5) {
|
|
|
235
203
|
}
|
|
236
204
|
var truncate_default = truncate;
|
|
237
205
|
|
|
238
|
-
// src/functions/
|
|
239
|
-
|
|
206
|
+
// src/functions/wait.ts
|
|
207
|
+
function wait(seconds) {
|
|
208
|
+
return new Promise((resolve, _) => {
|
|
209
|
+
setTimeout(() => {
|
|
210
|
+
resolve();
|
|
211
|
+
}, seconds * 1e3);
|
|
212
|
+
});
|
|
213
|
+
}
|
|
214
|
+
var wait_default = wait;
|
|
215
|
+
|
|
216
|
+
// src/functions/taggedTemplate/interpolateObjects.ts
|
|
217
|
+
function interpolateObjects(strings, ...values) {
|
|
218
|
+
let result = "";
|
|
219
|
+
for (let i = 0; i < strings.length; i++) {
|
|
220
|
+
result += strings[i];
|
|
221
|
+
if (i !== strings.length - 1) {
|
|
222
|
+
result += values[i] && typeof values[i] === "object" ? JSON.stringify(values[i]) : values[i];
|
|
223
|
+
}
|
|
224
|
+
}
|
|
225
|
+
return result;
|
|
226
|
+
}
|
|
227
|
+
var interpolateObjects_default = interpolateObjects;
|
|
240
228
|
|
|
241
229
|
// src/types/APIError.ts
|
|
242
230
|
var httpErrorCodeLookup = {
|
|
@@ -293,47 +281,12 @@ function parseUUID(UUID) {
|
|
|
293
281
|
return uuidSchema.parse(UUID);
|
|
294
282
|
}
|
|
295
283
|
var UUID_default = parseUUID;
|
|
296
|
-
|
|
297
|
-
// src/functions/validateUUID.ts
|
|
298
|
-
function validateUUID(UUID, error = new APIError_default(400, "INVALID_UUID")) {
|
|
299
|
-
const uuidSchema2 = z4.uuid();
|
|
300
|
-
const parsedUUID = uuidSchema2.safeParse(UUID);
|
|
301
|
-
if (!parsedUUID.success) {
|
|
302
|
-
throw error;
|
|
303
|
-
}
|
|
304
|
-
return parsedUUID.data;
|
|
305
|
-
}
|
|
306
|
-
var validateUUID_default = validateUUID;
|
|
307
|
-
|
|
308
|
-
// src/functions/wait.ts
|
|
309
|
-
function wait(seconds) {
|
|
310
|
-
return new Promise((resolve, _) => {
|
|
311
|
-
setTimeout(() => {
|
|
312
|
-
resolve();
|
|
313
|
-
}, seconds * 1e3);
|
|
314
|
-
});
|
|
315
|
-
}
|
|
316
|
-
var wait_default = wait;
|
|
317
|
-
|
|
318
|
-
// src/functions/taggedTemplate/interpolateObjects.ts
|
|
319
|
-
function interpolateObjects(strings, ...values) {
|
|
320
|
-
let result = "";
|
|
321
|
-
for (let i = 0; i < strings.length; i++) {
|
|
322
|
-
result += strings[i];
|
|
323
|
-
if (i !== strings.length - 1) {
|
|
324
|
-
result += values[i] && typeof values[i] === "object" ? JSON.stringify(values[i]) : values[i];
|
|
325
|
-
}
|
|
326
|
-
}
|
|
327
|
-
return result;
|
|
328
|
-
}
|
|
329
|
-
var interpolateObjects_default = interpolateObjects;
|
|
330
284
|
export {
|
|
331
285
|
APIError_default as APIError,
|
|
332
286
|
addDaysToDate_default as addDaysToDate,
|
|
333
287
|
appendSemicolon_default as appendSemicolon,
|
|
334
288
|
convertFileToBase64_default as convertFileToBase64,
|
|
335
289
|
fillArray_default as fillArray,
|
|
336
|
-
fillArrayAsync_default as fillArrayAsync,
|
|
337
290
|
formatDateAndTime_default as formatDateAndTime,
|
|
338
291
|
getRandomNumber_default as getRandomNumber,
|
|
339
292
|
httpErrorCodeLookup,
|
|
@@ -348,6 +301,5 @@ export {
|
|
|
348
301
|
randomiseArray_default as randomiseArray,
|
|
349
302
|
range_default as range,
|
|
350
303
|
truncate_default as truncate,
|
|
351
|
-
validateUUID_default as validateUUID,
|
|
352
304
|
wait_default as wait
|
|
353
305
|
};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@alextheman/utility",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "2.0.0",
|
|
4
4
|
"description": "Helpful utility functions",
|
|
5
5
|
"license": "ISC",
|
|
6
6
|
"author": "alextheman",
|
|
@@ -37,9 +37,9 @@
|
|
|
37
37
|
},
|
|
38
38
|
"devDependencies": {
|
|
39
39
|
"@alextheman/eslint-plugin": "^1.14.2",
|
|
40
|
-
"@eslint/js": "^9.
|
|
41
|
-
"@types/node": "^24.
|
|
42
|
-
"eslint": "^9.
|
|
40
|
+
"@eslint/js": "^9.38.0",
|
|
41
|
+
"@types/node": "^24.8.1",
|
|
42
|
+
"eslint": "^9.38.0",
|
|
43
43
|
"eslint-import-resolver-typescript": "^4.4.4",
|
|
44
44
|
"eslint-plugin-import": "^2.32.0",
|
|
45
45
|
"globals": "^16.4.0",
|
|
@@ -48,7 +48,7 @@
|
|
|
48
48
|
"prettier": "^3.6.2",
|
|
49
49
|
"tsup": "^8.5.0",
|
|
50
50
|
"typescript": "^5.9.3",
|
|
51
|
-
"typescript-eslint": "^8.46.
|
|
51
|
+
"typescript-eslint": "^8.46.1",
|
|
52
52
|
"vite-tsconfig-paths": "^5.1.4",
|
|
53
53
|
"vitest": "^3.2.4"
|
|
54
54
|
}
|