cafe-utility 9.8.0 → 9.10.0

package/index.d.ts

@@ -59,6 +59,7 @@ declare function asBoolean(bool: any): boolean;
 declare function asDate(date: any): Date;
 declare function asNullableString(string: any): string | null;
 declare function asId(value: any): number;
+declare function asTime(value: any): string;
 declare function asArray(value: any): unknown[];
 declare function asObject(value: any): Record<string, unknown>;
 declare function represent(value: any): string;
@@ -254,6 +255,7 @@ declare function filterObjectValues<T>(object: CafeObject<T>, predicate: (value:
 declare function mapObject<T, K>(object: CafeObject<T>, mapper: (value: T) => K): CafeObject<K>;
 declare function rethrow<T>(asyncFn: () => Promise<T>, throwable: Error): Promise<T>;
 declare function setSomeOnObject(object: CafeObject, key: string, value: unknown): void;
+declare function setSomeDeep(target: CafeObject, targetPath: string, source: CafeObject, sourcePath: string): void;
 declare function flip(object: Record<string, Indexable>): CafeObject;
 declare function getAllPermutations(object: CafeObject<unknown[]>): CafeObject[];
 declare function countTruthyValues(object: CafeObject): number;
@@ -441,6 +443,7 @@ export declare const Objects: {
     filterValues: typeof filterObjectValues;
     rethrow: typeof rethrow;
     setSomeOnObject: typeof setSomeOnObject;
+    setSomeDeep: typeof setSomeDeep;
     flip: typeof flip;
     getAllPermutations: typeof getAllPermutations;
     countTruthyValues: typeof countTruthyValues;
@@ -481,6 +484,7 @@ export declare const Types: {
     asDate: typeof asDate;
     asNullableString: typeof asNullableString;
     asId: typeof asId;
+    asTime: typeof asTime;
     asArray: typeof asArray;
     asObject: typeof asObject;
 };

package/index.js

@@ -459,6 +459,22 @@ function asId(value) {
     return typeof value === 'string' ? parseInt(value, 10) : value
 }
 
+function asTime(value) {
+    if (!isString(value)) {
+        throw new TypeError('Expected time, got: ' + value)
+    }
+    const parts = value.split(':')
+    if (parts.length !== 2) {
+        throw new TypeError('Expected time, got: ' + value)
+    }
+    const hours = parseInt(parts[0], 10)
+    const minutes = parseInt(parts[1], 10)
+    if (!isNumber(hours) || !isNumber(minutes) || hours < 0 || hours > 23 || minutes < 0 || minutes > 59) {
+        throw new TypeError('Expected time, got: ' + value)
+    }
+    return `${String(hours).padStart(2, '0')}:${String(minutes).padStart(2, '0')}`
+}
+
 function asArray(value) {
     if (!Array.isArray(value)) {
         throw new TypeError('Expected array, got: ' + value)
@@ -1692,6 +1708,14 @@ function setSomeOnObject(object, key, value) {
     }
 }
 
+function setSomeDeep(target, targetPath, source, sourcePath) {
+    const value = getDeep(source, sourcePath)
+    if (typeof value === 'undefined' || value === null) {
+        return
+    }
+    setDeep(target, targetPath, value)
+}
+
 function flip(object) {
     const result = {}
     for (const [key, value] of Object.entries(object)) {
@@ -2410,6 +2434,7 @@ exports.Objects = {
     filterValues: filterObjectValues,
     rethrow,
     setSomeOnObject,
+    setSomeDeep,
     flip,
     getAllPermutations,
     countTruthyValues,
@@ -2452,6 +2477,7 @@ exports.Types = {
     asDate,
     asNullableString,
     asId,
+    asTime,
     asArray,
     asObject
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "cafe-utility",
-    "version": "9.8.0",
+    "version": "9.10.0",
     "description": "",
     "main": "index.js",
     "exports": {