@douglasneuroinformatics/libjs 0.7.1 → 1.0.0

package/dist/datetime.d.ts

@@ -1,3 +1,12 @@
+export type Duration = {
+    days: number;
+    hours: number;
+    milliseconds: number;
+    minutes: number;
+    seconds: number;
+};
+/** A map that associates time units with their corresponding values in milliseconds */
+export declare const TIME_MAP: Map<"day" | "hour" | "minute" | "second" | "millisecond", number>;
 /**
  * Returns the data in basic ISO format, e.g., yyyy-mm-dd
  * @example
@@ -25,4 +34,12 @@ export declare function yearsPassed(date: Date): number;
  * ```
  */
 export declare function sleep(seconds: number): Promise<unknown>;
+/**
+ * Parses a given duration in milliseconds into an object representing the duration in days, hours, minutes, seconds, and milliseconds.
+ *
+ * @param milliseconds - The duration in milliseconds to be parsed.
+ * @returns An object of type `Duration` representing the parsed duration.
+ * @throws Will throw an error if the input duration is negative.
+ */
+export declare function parseDuration(milliseconds: number): Duration;
 //# sourceMappingURL=datetime.d.ts.map

package/dist/datetime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../src/datetime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE9C;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,oBAE1C"}
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../src/datetime.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,QAAQ,mEAMV,CAAC;AAEZ;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE9C;AAED;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,oBAE1C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,CAY5D"}

package/dist/datetime.js

@@ -1,3 +1,11 @@
+/** A map that associates time units with their corresponding values in milliseconds */
+export const TIME_MAP = new Map([
+    ['day', 24 * 60 * 60 * 1000],
+    ['hour', 60 * 60 * 1000],
+    ['minute', 60 * 1000],
+    ['second', 1000],
+    ['millisecond', 1]
+]);
 /**
  * Returns the data in basic ISO format, e.g., yyyy-mm-dd
  * @example
@@ -31,3 +39,23 @@ export function yearsPassed(date) {
 export async function sleep(seconds) {
     return new Promise((resolve) => setTimeout(resolve, seconds * 1000));
 }
+/**
+ * Parses a given duration in milliseconds into an object representing the duration in days, hours, minutes, seconds, and milliseconds.
+ *
+ * @param milliseconds - The duration in milliseconds to be parsed.
+ * @returns An object of type `Duration` representing the parsed duration.
+ * @throws Will throw an error if the input duration is negative.
+ */
+export function parseDuration(milliseconds) {
+    if (0 > milliseconds) {
+        throw new Error(`Cannot parse negative length of time: ${milliseconds}`);
+    }
+    const duration = {};
+    let remaining = milliseconds;
+    TIME_MAP.forEach((value, unit) => {
+        const count = Math.floor(remaining / value);
+        duration[`${unit}s`] = count;
+        remaining %= value;
+    });
+    return duration;
+}

package/dist/datetime.test.js

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { sleep, toBasicISOString, yearsPassed } from './datetime.js';
+import { parseDuration, sleep, toBasicISOString, yearsPassed } from './datetime.js';
 describe('toBasicISOString', () => {
     it('should return a string of the format yyyy-mm-dd', () => {
         expect(toBasicISOString(new Date(2000, 0, 1))).toBe('2000-01-01');
@@ -25,3 +25,83 @@ describe('sleep', () => {
         expect(end - start).toBeGreaterThanOrEqual(200);
     });
 });
+describe('parseDuration', () => {
+    it('should fail to parse a negative duration', () => {
+        expect(() => parseDuration(-1)).toThrow('Cannot parse negative length of time: -1');
+    });
+    it('should parse a duration of zero', () => {
+        expect(parseDuration(0)).toEqual({
+            days: 0,
+            hours: 0,
+            milliseconds: 0,
+            minutes: 0,
+            seconds: 0
+        });
+    });
+    it('should parse a duration less than a second', () => {
+        expect(parseDuration(50)).toEqual({
+            days: 0,
+            hours: 0,
+            milliseconds: 50,
+            minutes: 0,
+            seconds: 0
+        });
+        expect(parseDuration(500)).toEqual({
+            days: 0,
+            hours: 0,
+            milliseconds: 500,
+            minutes: 0,
+            seconds: 0
+        });
+    });
+    it('should parse a duration less than one minute but more than one second', () => {
+        expect(parseDuration(11_100)).toEqual({
+            days: 0,
+            hours: 0,
+            milliseconds: 100,
+            minutes: 0,
+            seconds: 11
+        });
+    });
+    it('should parse a duration less than one hour but more than one minute', () => {
+        expect(parseDuration(60_000)).toEqual({
+            days: 0,
+            hours: 0,
+            milliseconds: 0,
+            minutes: 1,
+            seconds: 0
+        });
+        expect(parseDuration(62_500)).toEqual({
+            days: 0,
+            hours: 0,
+            milliseconds: 500,
+            minutes: 1,
+            seconds: 2
+        });
+    });
+    it('should parse a duration less than one day but more than one hour', () => {
+        expect(parseDuration(3_600_000)).toEqual({
+            days: 0,
+            hours: 1,
+            milliseconds: 0,
+            minutes: 0,
+            seconds: 0
+        });
+    });
+    it('should parse a duration greater than one day', () => {
+        expect(parseDuration(86_400_000)).toEqual({
+            days: 1,
+            hours: 0,
+            milliseconds: 0,
+            minutes: 0,
+            seconds: 0
+        });
+        expect(parseDuration(4_351_505_030)).toEqual({
+            days: 50,
+            hours: 8,
+            milliseconds: 30,
+            minutes: 45,
+            seconds: 5
+        });
+    });
+});

package/dist/json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAeA,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,WASjD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,WAKhD"}
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AA6BA,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,WAejD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,WAOhD"}

package/dist/json.js

@@ -1,9 +1,9 @@
 import { isPlainObject } from './object.js';
-function isSerializedSet(value) {
+function isSerializedObject(value, name) {
     if (!isPlainObject(value)) {
         return false;
     }
-    return Boolean(value.__isSerializedType && value.__deserializedType === 'Set');
+    return Boolean(value.__isSerializedType && value.__deserializedType === name);
 }
 export function replacer(_, value) {
     if (value instanceof Set) {
@@ -13,11 +13,21 @@ export function replacer(_, value) {
             value: Array.from(value)
         };
     }
+    else if (value instanceof Date) {
+        return {
+            __deserializedType: 'Date',
+            __isSerializedType: true,
+            value: value.toJSON()
+        };
+    }
     return value;
 }
 export function reviver(_, value) {
-    if (isSerializedSet(value)) {
+    if (isSerializedObject(value, 'Set')) {
         return new Set(value.value);
     }
+    else if (isSerializedObject(value, 'Date')) {
+        return new Date(value.value);
+    }
     return value;
 }

package/dist/json.test.js

@@ -9,13 +9,21 @@ describe('replacer', () => {
             value: [1, 2, 3]
         });
     });
-    it('should return the value if it is not a Set', () => {
+    it('should serialize a Date', () => {
+        const date = new Date();
+        expect(replacer('', date)).toEqual({
+            __deserializedType: 'Date',
+            __isSerializedType: true,
+            value: date.toJSON()
+        });
+    });
+    it('should return the value if it is not a Set or a Date', () => {
         const obj = { a: 1 };
         expect(replacer('', obj)).toBe(obj);
     });
 });
 describe('reviver', () => {
-    it('should deserialize a serialized set', () => {
+    it('should deserialize a serialized Set', () => {
         const serializedSet = {
             __deserializedType: 'Set',
             __isSerializedType: true,
@@ -24,11 +32,20 @@ describe('reviver', () => {
         const deserializedSet = new Set([1, 2, 3]);
         expect(reviver('', serializedSet)).toEqual(deserializedSet);
     });
+    it('should deserialize a serialized Date', () => {
+        const date = new Date();
+        const serializedDate = {
+            __deserializedType: 'Date',
+            __isSerializedType: true,
+            value: date.toJSON()
+        };
+        expect(reviver('', serializedDate)).toEqual(date);
+    });
     it('should return the value if it is not a plain object', () => {
         const obj = new Date();
         expect(reviver('', obj)).toBe(obj);
     });
-    it('should return the value if it is a plain object but not a serialized set', () => {
+    it('should return the value if it is a plain object but not a serialized Set or Date', () => {
         const obj = { a: 1 };
         expect(reviver('', obj)).toBe(obj);
     });

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@douglasneuroinformatics/libjs",
   "type": "module",
-  "version": "0.7.1",
-  "packageManager": "pnpm@9.3.0",
+  "version": "1.0.0",
+  "packageManager": "pnpm@9.11.0",
   "description": "A collection of utility functions and types for Node.js and the browser",
   "author": "Joshua Unrau",
   "license": "Apache-2.0",