@eliasrrosa/tutorhub-public-assets 0.7.4 → 0.7.6

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

@@ -6,7 +6,15 @@ export declare class ISO8601Date implements IDate {
     /**Accepts YYYY-MM-DD date format. All other characters after this will be disconsidered.
      * Disconsiders timezones.
      */
-    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;
     private throwIfFormatIsNotValid;
     getDay: () => string;
     getMonth: () => string;

package/dist/domain/entities/ISO8601Date.js

@@ -6,7 +6,7 @@ class ISO8601Date {
     /**Accepts YYYY-MM-DD date format. All other characters after this will be disconsidered.
      * Disconsiders timezones.
      */
-    constructor(value) {
+    constructor(value, opts) {
         this.validator = new ISO8601DateValidator_1.ISO8601DateValidator();
         this.getDay = () => {
             this.throwIfFormatIsNotValid();
@@ -52,14 +52,21 @@ class ISO8601Date {
             const targetDate = date || this;
             return targetDate.toUtcJsDateTime().getUTCDay();
         };
-        const normalizedValue = value
-            ? this.validator.match(value)
-            : this.getToday();
+        const normalizedValue = this.normalizeValue(value, opts === null || opts === void 0 ? void 0 : opts.useUtc);
         if (!normalizedValue)
             throw new Error("Date format is invalid.");
         this.value = normalizedValue;
         this.throwIfFormatIsNotValid();
     }
+    normalizeValue(value, useUtc) {
+        return typeof value == "string"
+            ? this.validator.match(value)
+            : value instanceof Date
+                ? this.jsDateTimeToDate(value, {
+                    useUtc: useUtc,
+                }).value
+                : this.getToday();
+    }
     throwIfFormatIsNotValid() {
         if (!this.validator.formatIsValid(this.value)) {
             throw new Error("Date format must be YYYY-MM-DD.");

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

@@ -38,6 +38,13 @@ describe("ISO8601Date", () => {
             };
             expect(validateFormat).not.toThrow();
         });
+        it("Should be able to be constructed using js Date", () => {
+            const jsDate = new Date("2025-01-01T00:00:00Z");
+            const date = new ISO8601Date_1.ISO8601Date(jsDate, {
+                useUtc: true
+            });
+            expect(date.value).toEqual("2025-01-01");
+        });
     });
     describe("ISO8601Date.getDay()", () => {
         it("Should return the day if format is valid.", () => {

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

@@ -95,7 +95,7 @@ var _ISO8601Date = class _ISO8601Date {
   /**Accepts YYYY-MM-DD date format. All other characters after this will be disconsidered.
    * Disconsiders timezones.
    */
-  constructor(value) {
+  constructor(value, opts) {
     this.validator = new ISO8601DateValidator();
     this.getDay = () => {
       this.throwIfFormatIsNotValid();
@@ -151,11 +151,16 @@ var _ISO8601Date = class _ISO8601Date {
       const targetDate = date || this;
       return targetDate.toUtcJsDateTime().getUTCDay();
     };
-    const normalizedValue = value ? this.validator.match(value) : this.getToday();
+    const normalizedValue = this.normalizeValue(value, opts == null ? void 0 : opts.useUtc);
     if (!normalizedValue) throw new Error("Date format is invalid.");
     this.value = normalizedValue;
     this.throwIfFormatIsNotValid();
   }
+  normalizeValue(value, useUtc) {
+    return typeof value == "string" ? this.validator.match(value) : value instanceof Date ? this.jsDateTimeToDate(value, {
+      useUtc
+    }).value : this.getToday();
+  }
   throwIfFormatIsNotValid() {
     if (!this.validator.formatIsValid(this.value)) {
       throw new Error("Date format must be YYYY-MM-DD.");
@@ -436,15 +441,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 +492,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 +549,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

@@ -57,7 +57,7 @@ var _ISO8601Date = class _ISO8601Date {
   /**Accepts YYYY-MM-DD date format. All other characters after this will be disconsidered.
    * Disconsiders timezones.
    */
-  constructor(value) {
+  constructor(value, opts) {
     this.validator = new ISO8601DateValidator();
     this.getDay = () => {
       this.throwIfFormatIsNotValid();
@@ -113,11 +113,16 @@ var _ISO8601Date = class _ISO8601Date {
       const targetDate = date || this;
       return targetDate.toUtcJsDateTime().getUTCDay();
     };
-    const normalizedValue = value ? this.validator.match(value) : this.getToday();
+    const normalizedValue = this.normalizeValue(value, opts == null ? void 0 : opts.useUtc);
     if (!normalizedValue) throw new Error("Date format is invalid.");
     this.value = normalizedValue;
     this.throwIfFormatIsNotValid();
   }
+  normalizeValue(value, useUtc) {
+    return typeof value == "string" ? this.validator.match(value) : value instanceof Date ? this.jsDateTimeToDate(value, {
+      useUtc
+    }).value : this.getToday();
+  }
   throwIfFormatIsNotValid() {
     if (!this.validator.formatIsValid(this.value)) {
       throw new Error("Date format must be YYYY-MM-DD.");
@@ -398,15 +403,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 +454,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 +511,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.4",
+  "version": "0.7.6",
   "description": "Assets, mainly interfaces, to be shared among different Tutorhub apps.",
   "type": "module",
   "main": "./dist/index.cjs",