@eliasrrosa/tutorhub-public-assets 0.7.3 → 0.7.5

package/dist/domain/entities/ISO8601Time.d.ts

@@ -19,7 +19,32 @@ export declare class ISO8601Time implements ITime {
      * Throws if format is invalid.
      * Accepted formats: HH:MM:SS, HH:MM, HH:MM:SS(+|-)HH:MM, HH:MM:SS.sssZ and HH:MM:SSZ.
      */
-    constructor(value?: string);
+    constructor(value?: string | Date, opts?: {
+        /**
+         * If `value` is of type `Date`, set this to `true`
+         * so that hours, minutes and seconds are extracted
+         * considering UTC.
+         */
+        useUtc?: boolean;
+    });
+    private normalizeValue;
+    /**
+     * Returns a string like HH:MM:SS from a js Date
+     */
+    static fromJsDateTime: (dateTime: Date, opts?: {
+        /**
+         * Set this to `true` so that hours, minutes and seconds are extracted
+         * considering UTC.
+         */
+        useUtc?: boolean;
+    }) => string;
+    fromJsDateTime: (dateTime: Date, opts?: {
+        /**
+         * Set this to `true` so that hours, minutes and seconds are extracted
+         * considering UTC.
+         */
+        useUtc?: boolean;
+    }) => string;
     private validateFormatOrThrow;
     getTimeString(opts?: {
         format?: "HH:MM" | "HH:MM:SS" | "HH:MM:SS(+|-)HH:MM";

package/dist/domain/entities/ISO8601Time.js

@@ -17,10 +17,11 @@ class ISO8601Time {
      * Throws if format is invalid.
      * Accepted formats: HH:MM:SS, HH:MM, HH:MM:SS(+|-)HH:MM, HH:MM:SS.sssZ and HH:MM:SSZ.
      */
-    constructor(value) {
+    constructor(value, opts) {
         this.timeValidator = new ISO8601TimeValidator_1.ISO8601TimeValidator();
         this.timezoneConverter = new ISO8601TimezoneConverter_1.ISO8601TimezoneConverter();
         this.timezoneParser = new ISO8601TimezoneParser_1.ISO8601TimezoneParser();
+        this.fromJsDateTime = ISO8601Time.fromJsDateTime;
         this.getNowTimeString = ISO8601Time.getNow;
         this.getTimezone = () => {
             return new ISO8601Timezone_1.ISO8601Timezone(this.originalTimeString);
@@ -60,9 +61,18 @@ class ISO8601Time {
                 : timezone;
             return new ISO8601Time(`${this.getHoursString()}:${this.getMinutesString()}:${this.getSecondsString()}${newTimezone}`);
         };
-        this.originalTimeString = value ? value : this.getNowTimeString();
+        this.originalTimeString = this.normalizeValue(value, opts === null || opts === void 0 ? void 0 : opts.useUtc);
         this.validateFormatOrThrow();
     }
+    normalizeValue(value, useUtc) {
+        return value == undefined
+            ? this.getNowTimeString()
+            : typeof value == "string"
+                ? value
+                : this.fromJsDateTime(value, {
+                    useUtc: useUtc,
+                });
+    }
     validateFormatOrThrow() {
         if (!this.timeValidator.formatIsValid(this.originalTimeString))
             throw new Error("Time format must be ISO8601.");
@@ -110,3 +120,20 @@ class ISO8601Time {
     }
 }
 exports.ISO8601Time = ISO8601Time;
+/**
+ * Returns a string like HH:MM:SS from a js Date
+ */
+ISO8601Time.fromJsDateTime = (dateTime, opts) => {
+    const toStringAndPadStart = (x) => x.toString().padStart(2, "0");
+    const hours = (opts === null || opts === void 0 ? void 0 : opts.useUtc) ? dateTime.getUTCHours() : dateTime.getHours();
+    const hoursString = toStringAndPadStart(hours);
+    const minutes = (opts === null || opts === void 0 ? void 0 : opts.useUtc)
+        ? dateTime.getUTCMinutes()
+        : dateTime.getMinutes();
+    const minutesString = toStringAndPadStart(minutes);
+    const seconds = (opts === null || opts === void 0 ? void 0 : opts.useUtc)
+        ? dateTime.getUTCSeconds()
+        : dateTime.getSeconds();
+    const secondsString = toStringAndPadStart(seconds);
+    return `${hoursString}:${minutesString}:${secondsString}`;
+};

package/dist/domain/entities/ISO8601Time.test.js

@@ -233,4 +233,19 @@ describe("ISO8601Time", () => {
             expect(time.getTimeInMinutes()).toEqual(90);
         });
     });
+    describe("ISO8601Time.fromJsDateTime()", () => {
+        afterEach(() => jest.useRealTimers());
+        it("Should return the expected time according to local time", () => {
+            jest.useFakeTimers().setSystemTime(new Date("2025-01-01T12:00:00-03:00"));
+            const dateTime = new Date("2025-01-01T12:00:00-03:00");
+            const time = ISO8601Time_1.ISO8601Time.fromJsDateTime(dateTime);
+            expect(time).toEqual("12:00:00");
+        });
+        it("Should return the expected time according to utc given parameter", () => {
+            jest.useFakeTimers().setSystemTime(new Date("2025-01-01T12:00:00-03:00"));
+            const dateTime = new Date("2025-01-01T12:00:00Z");
+            const time = ISO8601Time_1.ISO8601Time.fromJsDateTime(dateTime, { useUtc: true });
+            expect(time).toEqual("12:00:00");
+        });
+    });
 });

package/dist/index.cjs

@@ -436,15 +436,16 @@ var ISO8601TimezoneConverter = class {
 };
 
 // src/domain/entities/ISO8601Time.ts
-var ISO8601Time = class _ISO8601Time {
+var _ISO8601Time = class _ISO8601Time {
   /**
    * Throws if format is invalid.
    * Accepted formats: HH:MM:SS, HH:MM, HH:MM:SS(+|-)HH:MM, HH:MM:SS.sssZ and HH:MM:SSZ.
    */
-  constructor(value) {
+  constructor(value, opts) {
     this.timeValidator = new ISO8601TimeValidator();
     this.timezoneConverter = new ISO8601TimezoneConverter();
     this.timezoneParser = new ISO8601TimezoneParser();
+    this.fromJsDateTime = _ISO8601Time.fromJsDateTime;
     this.getNowTimeString = _ISO8601Time.getNow;
     this.getTimezone = () => {
       return new ISO8601Timezone(this.originalTimeString);
@@ -486,9 +487,14 @@ var ISO8601Time = class _ISO8601Time {
         `${this.getHoursString()}:${this.getMinutesString()}:${this.getSecondsString()}${newTimezone}`
       );
     };
-    this.originalTimeString = value ? value : this.getNowTimeString();
+    this.originalTimeString = this.normalizeValue(value, opts == null ? void 0 : opts.useUtc);
     this.validateFormatOrThrow();
   }
+  normalizeValue(value, useUtc) {
+    return value == void 0 ? this.getNowTimeString() : typeof value == "string" ? value : this.fromJsDateTime(value, {
+      useUtc
+    });
+  }
   validateFormatOrThrow() {
     if (!this.timeValidator.formatIsValid(this.originalTimeString))
       throw new Error("Time format must be ISO8601.");
@@ -538,6 +544,20 @@ var ISO8601Time = class _ISO8601Time {
     );
   }
 };
+/**
+ * Returns a string like HH:MM:SS from a js Date
+ */
+_ISO8601Time.fromJsDateTime = (dateTime, opts) => {
+  const toStringAndPadStart = (x) => x.toString().padStart(2, "0");
+  const hours = (opts == null ? void 0 : opts.useUtc) ? dateTime.getUTCHours() : dateTime.getHours();
+  const hoursString = toStringAndPadStart(hours);
+  const minutes = (opts == null ? void 0 : opts.useUtc) ? dateTime.getUTCMinutes() : dateTime.getMinutes();
+  const minutesString = toStringAndPadStart(minutes);
+  const seconds = (opts == null ? void 0 : opts.useUtc) ? dateTime.getUTCSeconds() : dateTime.getSeconds();
+  const secondsString = toStringAndPadStart(seconds);
+  return `${hoursString}:${minutesString}:${secondsString}`;
+};
+var ISO8601Time = _ISO8601Time;
 
 // src/infrastructure/restful/requests/forms/ClassCreationForm.ts
 var import_zod2 = require("zod");

package/dist/index.js

@@ -398,15 +398,16 @@ var ISO8601TimezoneConverter = class {
 };
 
 // src/domain/entities/ISO8601Time.ts
-var ISO8601Time = class _ISO8601Time {
+var _ISO8601Time = class _ISO8601Time {
   /**
    * Throws if format is invalid.
    * Accepted formats: HH:MM:SS, HH:MM, HH:MM:SS(+|-)HH:MM, HH:MM:SS.sssZ and HH:MM:SSZ.
    */
-  constructor(value) {
+  constructor(value, opts) {
     this.timeValidator = new ISO8601TimeValidator();
     this.timezoneConverter = new ISO8601TimezoneConverter();
     this.timezoneParser = new ISO8601TimezoneParser();
+    this.fromJsDateTime = _ISO8601Time.fromJsDateTime;
     this.getNowTimeString = _ISO8601Time.getNow;
     this.getTimezone = () => {
       return new ISO8601Timezone(this.originalTimeString);
@@ -448,9 +449,14 @@ var ISO8601Time = class _ISO8601Time {
         `${this.getHoursString()}:${this.getMinutesString()}:${this.getSecondsString()}${newTimezone}`
       );
     };
-    this.originalTimeString = value ? value : this.getNowTimeString();
+    this.originalTimeString = this.normalizeValue(value, opts == null ? void 0 : opts.useUtc);
     this.validateFormatOrThrow();
   }
+  normalizeValue(value, useUtc) {
+    return value == void 0 ? this.getNowTimeString() : typeof value == "string" ? value : this.fromJsDateTime(value, {
+      useUtc
+    });
+  }
   validateFormatOrThrow() {
     if (!this.timeValidator.formatIsValid(this.originalTimeString))
       throw new Error("Time format must be ISO8601.");
@@ -500,6 +506,20 @@ var ISO8601Time = class _ISO8601Time {
     );
   }
 };
+/**
+ * Returns a string like HH:MM:SS from a js Date
+ */
+_ISO8601Time.fromJsDateTime = (dateTime, opts) => {
+  const toStringAndPadStart = (x) => x.toString().padStart(2, "0");
+  const hours = (opts == null ? void 0 : opts.useUtc) ? dateTime.getUTCHours() : dateTime.getHours();
+  const hoursString = toStringAndPadStart(hours);
+  const minutes = (opts == null ? void 0 : opts.useUtc) ? dateTime.getUTCMinutes() : dateTime.getMinutes();
+  const minutesString = toStringAndPadStart(minutes);
+  const seconds = (opts == null ? void 0 : opts.useUtc) ? dateTime.getUTCSeconds() : dateTime.getSeconds();
+  const secondsString = toStringAndPadStart(seconds);
+  return `${hoursString}:${minutesString}:${secondsString}`;
+};
+var ISO8601Time = _ISO8601Time;
 
 // src/infrastructure/restful/requests/forms/ClassCreationForm.ts
 import { z as z2 } from "zod";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eliasrrosa/tutorhub-public-assets",
-  "version": "0.7.3",
+  "version": "0.7.5",
   "description": "Assets, mainly interfaces, to be shared among different Tutorhub apps.",
   "type": "module",
   "main": "./dist/index.cjs",