@bgord/tools 0.12.26 → 0.13.0

package/dist/clock.vo.d.ts

@@ -1,5 +1,6 @@
-import { type Hour } from "./hour.vo";
-import type { Minute } from "./minute.vo";
+import { Hour } from "./hour.vo";
+import { Minute } from "./minute.vo";
+import type { TimestampType } from "./timestamp.vo";
 export type ClockFormatter = (hour: Hour, minute: Minute) => string;
 declare enum ClockFormatterEnum {
     TWENTY_FOUR_HOURS = "TWENTY_FOUR_HOURS",
@@ -11,6 +12,7 @@ export declare class Clock {
     private readonly minute;
     private readonly formatter;
     constructor(hour: Hour, minute: Minute, formatter?: ClockFormatter);
+    static fromUtcTimestamp(timestamp: TimestampType, formatter?: ClockFormatter): Clock;
     get(formatter?: ClockFormatter): {
         raw: {
             hour: number;

package/dist/clock.vo.js

@@ -1,4 +1,5 @@
-import { HourFormatters } from "./hour.vo";
+import { Hour, HourFormatters } from "./hour.vo";
+import { Minute } from "./minute.vo";
 var ClockFormatterEnum;
 (function (ClockFormatterEnum) {
     ClockFormatterEnum["TWENTY_FOUR_HOURS"] = "TWENTY_FOUR_HOURS";
@@ -17,6 +18,11 @@ export class Clock {
         this.minute = minute;
         this.formatter = formatter ?? ClockFormatters.TWENTY_FOUR_HOURS;
     }
+    static fromUtcTimestamp(timestamp, formatter) {
+        const hour = Hour.fromUtcTimestamp(timestamp);
+        const minute = Minute.fromUtcTimestamp(timestamp);
+        return new Clock(hour, minute, formatter);
+    }
     get(formatter) {
         const format = formatter ?? this.formatter;
         return {

package/dist/hour.vo.d.ts

@@ -1,3 +1,4 @@
+import type { TimestampType } from "./timestamp.vo";
 export type HourFormatter = (value: Hour["value"]) => string;
 export declare enum HourFormatterEnum {
     TWENTY_FOUR_HOURS = "TWENTY_FOUR_HOURS",
@@ -20,5 +21,6 @@ export declare class Hour {
     equals(another: Hour): boolean;
     isAfter(another: Hour): boolean;
     isBefore(another: Hour): boolean;
+    static fromUtcTimestamp(timestamp: TimestampType, formatter?: HourFormatter): Hour;
     static list(formatter?: HourFormatter): Hour[];
 }

package/dist/hour.vo.js

@@ -10,12 +10,11 @@ export const HourFormatters = {
     TWENTY_FOUR_HOURS: (value) => value.toString().padStart(2, "0"),
     TWENTY_FOUR_HOURS_WO_PADDING: (value) => value.toString(),
     AM_PM: (value) => {
-        if (value < 12)
-            return `${value.toString()} a.m.`;
-        return `${value.toString()} p.m.`;
+        const twelveHour = value % 12 || 12;
+        return `${twelveHour.toString()} ${value < 12 ? "a.m." : "p.m."}`;
     },
-    TWELVE_HOURS: (value) => (value % 12).toString().padStart(2, "0"),
-    TWELVE_HOURS_WO_PADDING: (value) => (value % 12).toString(),
+    TWELVE_HOURS: (value) => (value % 12 || 12).toString().padStart(2, "0"),
+    TWELVE_HOURS_WO_PADDING: (value) => (value % 12 || 12).toString(),
 };
 export class Hour {
     value;
@@ -23,15 +22,12 @@ export class Hour {
     static ZERO = new Hour(0);
     static MAX = new Hour(23);
     constructor(candidate, formatter) {
-        if (!Number.isInteger(candidate)) {
+        if (!Number.isInteger(candidate))
             throw new Error("Invalid hour");
-        }
-        if (candidate < 0) {
+        if (candidate < 0)
             throw new Error("Invalid hour");
-        }
-        if (candidate >= 24) {
+        if (candidate >= 24)
             throw new Error("Invalid hour");
-        }
         this.value = candidate;
         this.formatter = formatter ?? HourFormatters.TWENTY_FOUR_HOURS;
     }
@@ -48,6 +44,10 @@ export class Hour {
     isBefore(another) {
         return this.value < another.get().raw;
     }
+    static fromUtcTimestamp(timestamp, formatter) {
+        const hours = new Date(timestamp).getUTCHours();
+        return new Hour(hours, formatter);
+    }
     static list(formatter) {
         return Array.from({ length: 24 }).map((_, index) => new Hour(index, formatter));
     }

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 export * from "./api-key.vo";
 export * from "./basename.vo";
-export * from "./build-version.vo";
 export * from "./clock.vo";
 export * from "./date-calculator.service";
 export * from "./date-formatter.service";
@@ -21,7 +20,6 @@ export * from "./file-path-relative-schema.vo";
 export * from "./filename.vo";
 export * from "./filename-from-string.vo";
 export * from "./filename-suffix.vo";
-export * from "./filter.vo";
 export * from "./hour.vo";
 export * from "./iban.vo";
 export * from "./iban-mask.service";
@@ -63,4 +61,5 @@ export * from "./ts-utils";
 export * from "./visually-unambiguous-characters-generator.service";
 export * from "./week.vo";
 export * from "./week-iso-id.vo";
+export * from "./weekday.vo";
 export * from "./z-score.service";

package/dist/index.js

@@ -1,6 +1,5 @@
 export * from "./api-key.vo";
 export * from "./basename.vo";
-export * from "./build-version.vo";
 export * from "./clock.vo";
 export * from "./date-calculator.service";
 export * from "./date-formatter.service";
@@ -21,7 +20,6 @@ export * from "./file-path-relative-schema.vo";
 export * from "./filename.vo";
 export * from "./filename-from-string.vo";
 export * from "./filename-suffix.vo";
-export * from "./filter.vo";
 export * from "./hour.vo";
 export * from "./iban.vo";
 export * from "./iban-mask.service";
@@ -63,4 +61,5 @@ export * from "./ts-utils";
 export * from "./visually-unambiguous-characters-generator.service";
 export * from "./week.vo";
 export * from "./week-iso-id.vo";
+export * from "./weekday.vo";
 export * from "./z-score.service";

package/dist/mean.service.js

@@ -2,9 +2,8 @@ import { RoundToDecimal } from "./rounding.service";
 import { Sum } from "./sum.service";
 export class Mean {
     static calculate(values, rounding = new RoundToDecimal(2)) {
-        if (values.length === 0) {
+        if (values.length === 0)
             throw new Error("Values should not be empty");
-        }
         const mean = Sum.of(values) / values.length;
         return rounding.round(mean);
     }

package/dist/mime.vo.js

@@ -6,12 +6,10 @@ export class Mime {
     subtype;
     constructor(value) {
         const [type, subtype] = value.split("/");
-        if (typeof type !== "string" || type.length === 0) {
+        if (typeof type !== "string" || type.length === 0)
             throw new InvalidMimeError();
-        }
-        if (typeof subtype !== "string" || subtype.length === 0) {
+        if (typeof subtype !== "string" || subtype.length === 0)
             throw new InvalidMimeError();
-        }
         this.raw = value;
         this.type = type;
         this.subtype = subtype;

package/dist/min-max-scaler.service.js

@@ -9,12 +9,10 @@ export class MinMaxScaler {
         const rounding = config.rounding ?? new RoundToDecimal(2);
         const lower = config.bound?.lower ?? 0;
         const upper = config.bound?.upper ?? 1;
-        if (config.max - config.min < 0) {
+        if (config.max - config.min < 0)
             throw new Error("Invalid MinMaxScaler min-max config");
-        }
-        if (upper - lower <= 0) {
+        if (upper - lower <= 0)
             throw new Error("Invalid MinMaxScaler bound config");
-        }
         this.rounding = rounding;
         this.min = config.min;
         this.max = config.max;
@@ -23,9 +21,8 @@ export class MinMaxScaler {
     }
     scale(value) {
         const { min, max, lower, upper } = this;
-        if (value < min || value > max) {
+        if (value < min || value > max)
             throw new Error("Value out of min/max range");
-        }
         if (min === max)
             return {
                 original: value,
@@ -43,9 +40,8 @@ export class MinMaxScaler {
     }
     descale(scaled) {
         const { min, max, lower, upper } = this;
-        if (scaled < lower || scaled > upper) {
+        if (scaled < lower || scaled > upper)
             throw new Error("Scaled value out of bounds");
-        }
         const result = ((scaled - lower) / (upper - lower)) * (max - min) + min;
         return {
             original: this.rounding.round(result),
@@ -55,9 +51,8 @@ export class MinMaxScaler {
         };
     }
     static getMinMax(values) {
-        if (values.length === 0) {
+        if (values.length === 0)
             throw new Error("An empty array supplied");
-        }
         return { min: Math.min(...values), max: Math.max(...values) };
     }
 }

package/dist/minute.vo.d.ts

@@ -3,6 +3,7 @@ export declare class Minute {
     static readonly ZERO: Minute;
     static readonly MAX: Minute;
     constructor(candidate: number);
+    static fromUtcTimestamp(timestamp: number): Minute;
     get(): {
         raw: number;
         formatted: string;

package/dist/minute.vo.js

@@ -3,22 +3,20 @@ export class Minute {
     static ZERO = new Minute(0);
     static MAX = new Minute(59);
     constructor(candidate) {
-        if (!Number.isInteger(candidate)) {
+        if (!Number.isInteger(candidate))
             throw new Error("Invalid minute");
-        }
-        if (candidate < 0) {
+        if (candidate < 0)
             throw new Error("Invalid minute");
-        }
-        if (candidate >= 60) {
+        if (candidate >= 60)
             throw new Error("Invalid minute");
-        }
         this.value = candidate;
     }
+    static fromUtcTimestamp(timestamp) {
+        const minutes = new Date(timestamp).getUTCMinutes();
+        return new Minute(minutes);
+    }
     get() {
-        return {
-            raw: this.value,
-            formatted: this.value.toString().padStart(2, "0"),
-        };
+        return { raw: this.value, formatted: this.value.toString().padStart(2, "0") };
     }
     equals(another) {
         return this.value === another.get().raw;

package/dist/money.vo.js

@@ -35,15 +35,13 @@ export class Money {
     }
     subtract(money) {
         const result = this.rounding.round(this.amount - money.getAmount());
-        if (result < Money.ZERO) {
+        if (result < Money.ZERO)
             throw new Error("Less than zero");
-        }
         return new Money(MoneyAmount.parse(result), this.rounding);
     }
     divide(factor) {
-        if (factor === 0) {
+        if (factor === 0)
             throw new Error("Cannot divide by zero");
-        }
         const result = this.rounding.round(this.amount / factor);
         return new Money(MoneyAmount.parse(result), this.rounding);
     }

package/dist/outlier-detector.service.js

@@ -3,9 +3,8 @@ export class OutlierDetector {
     zScore;
     threshold;
     constructor(values, threshold) {
-        if (values.length < 2) {
+        if (values.length < 2)
             throw new Error("At least two values are needed");
-        }
         this.zScore = new ZScore(values);
         this.threshold = Math.abs(threshold);
     }

package/dist/percentage.service.js

@@ -1,9 +1,8 @@
 import { RoundToNearest } from "./rounding.service";
 export class Percentage {
     static of(numerator, denominator, rounding = new RoundToNearest()) {
-        if (denominator === 0) {
+        if (denominator === 0)
             throw new Error("Invalid denominator");
-        }
         if (numerator === 0)
             return 0;
         return rounding.round((numerator / denominator) * 100);

package/dist/population-standard-deviation.service.js

@@ -3,9 +3,8 @@ import { RoundToDecimal } from "./rounding.service";
 import { Sum } from "./sum.service";
 export class PopulationStandardDeviation {
     static calculate(values, rounding = new RoundToDecimal(2)) {
-        if (values.length < 2) {
+        if (values.length < 2)
             throw new Error("At least two values are needed");
-        }
         const mean = Mean.calculate(values);
         const n = values.length;
         const squaredDifferences = values.map((value) => (value - mean) ** 2);

package/dist/random.service.js

@@ -2,18 +2,14 @@ export class Random {
     static generate(config) {
         const min = config?.min ?? 0;
         const max = config?.max ?? 1;
-        if (!Number.isInteger(min)) {
+        if (!Number.isInteger(min))
             throw new Error("Minimum value is not an integer");
-        }
-        if (!Number.isInteger(max)) {
+        if (!Number.isInteger(max))
             throw new Error("Maximum value is not an integer");
-        }
-        if (min === max) {
+        if (min === max)
             throw new Error("Minimum and maximum values cannot be equal");
-        }
-        if (min > max) {
+        if (min > max)
             throw new Error("Minimum value cannot be greater than maximum value");
-        }
         return Math.floor(Math.random() * (max - min + 1)) + min;
     }
 }

package/dist/reordering.service.js

@@ -73,21 +73,18 @@ export class ReorderingCalculator {
     }
     delete(id) {
         const item = this.dll.find((x) => x.data.eq(id));
-        if (!item) {
+        if (!item)
             throw new Error("Cannot find Item");
-        }
         this.dll.remove(item);
         this.recalculate();
     }
     transfer(transfer) {
         const current = this.dll.find((node) => node.data.eq(transfer.id));
         const target = this.dll.find((node) => node.data.position.eq(transfer.to));
-        if (!current) {
+        if (!current)
             throw new Error("Cannot find current Item");
-        }
-        if (!target) {
+        if (!target)
             throw new Error("Cannot find target Item");
-        }
         const direction = transfer.getDirection(current.data.position);
         if (direction === ReorderingTransferDirection.noop)
             return this.read();

package/dist/revision.vo.js

@@ -20,15 +20,13 @@ export class Revision {
         return new Revision(this.value + 1);
     }
     static fromETag(etag) {
-        if (!etag) {
+        if (!etag)
             throw new InvalidRevisionError();
-        }
         return new Revision(etag.revision);
     }
     static fromWeakETag(weakEtag) {
-        if (!weakEtag) {
+        if (!weakEtag)
             throw new InvalidRevisionError();
-        }
         return new Revision(weakEtag.revision);
     }
 }

package/dist/simple-linear-regression.service.js

@@ -9,33 +9,27 @@ export class SimpleLinearRegression {
     }
     static fromPairs(pairs, rounding) {
         const n = pairs.length;
-        if (n < 2) {
+        if (n < 2)
             throw new Error("At least two pairs needed");
-        }
         const x = pairs.map((pair) => pair.x);
         const y = pairs.map((pair) => pair.y);
         const xx = x.map((x) => x ** 2);
         const xy = pairs.map((pair) => pair.x * pair.y);
         const sX = Sum.of(x);
-        if (sX >= Number.MAX_SAFE_INTEGER) {
+        if (sX >= Number.MAX_SAFE_INTEGER)
             throw new Error("Sum of x values is too big");
-        }
         const sY = Sum.of(y);
-        if (sY >= Number.MAX_SAFE_INTEGER) {
+        if (sY >= Number.MAX_SAFE_INTEGER)
             throw new Error("Sum of y values is too big");
-        }
         const sSX = Sum.of(xx);
-        if (sSX >= Number.MAX_SAFE_INTEGER) {
+        if (sSX >= Number.MAX_SAFE_INTEGER)
             throw new Error("Sum of x squared values is too big");
-        }
         const sXY = Sum.of(xy);
-        if (sXY >= Number.MAX_SAFE_INTEGER) {
+        if (sXY >= Number.MAX_SAFE_INTEGER)
             throw new Error("Sum of x times y values is too big");
-        }
         const bDenominator = sSX - sX ** 2 / n;
-        if (bDenominator === 0) {
+        if (bDenominator === 0)
             throw new Error("Unable to create the model");
-        }
         const b = (sXY - (sX * sY) / n) / bDenominator;
         const a = (sY - b * sX) / n;
         return new SimpleLinearRegression({ a, b }, rounding);

package/dist/stepper.service.js

@@ -3,12 +3,10 @@ export class Stepper {
     current = Stepper.DEFAULT_CURRENT;
     total;
     constructor(config) {
-        if (!Number.isInteger(config.total)) {
+        if (!Number.isInteger(config.total))
             throw new Error("Total value is not an integer");
-        }
-        if (config.total <= Stepper.DEFAULT_CURRENT) {
+        if (config.total <= Stepper.DEFAULT_CURRENT)
             throw new Error("Total value should be greater than one");
-        }
         this.total = config.total;
     }
     continue() {

package/dist/stopwatch.service.js

@@ -12,9 +12,8 @@ export class Stopwatch {
         this.startMs = startMs;
     }
     stop() {
-        if (this.state === StopwatchState.stopped) {
+        if (this.state === StopwatchState.stopped)
             throw new Error("Stopwatch is already stopped");
-        }
         this.state = StopwatchState.stopped;
         this.stopMs = Timestamp.parse(Date.now());
         return { durationMs: Timestamp.parse(this.stopMs - this.startMs) };

package/dist/timezone.vo.js

@@ -4,16 +4,12 @@ export const Timezone = z
     .min(1)
     .refine((value) => {
     try {
-        // Create a dummy date and time format using the specified timezone
-        const dummyDate = new Date();
+        const date = new Date();
         const formatter = new Intl.DateTimeFormat("en-US", { timeZone: value });
-        // Format the dummy date
-        formatter.format(dummyDate);
-        // If the formatting succeeds without throwing an error, the timezone is valid
+        formatter.format(date);
         return true;
     }
     catch (_error) {
-        // An error occurred, indicating an invalid timezone
         return false;
     }
 }, { message: "timezone.invalid" })

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/api-key.vo.ts","../src/basename.vo.ts","../src/build-version.vo.ts","../src/clock.vo.ts","../src/date-calculator.service.ts","../src/date-formatter.service.ts","../src/date-range.vo.ts","../src/dates-of-the-week.vo.ts","../src/day-iso-id.vo.ts","../src/day.vo.ts","../src/directory-path-absolute.vo.ts","../src/directory-path-relative.vo.ts","../src/dll.service.ts","../src/email-mask.service.ts","../src/etags.vo.ts","../src/extension.vo.ts","../src/feature-flag.vo.ts","../src/file-path-absolute-schema.vo.ts","../src/file-path-relative-schema.vo.ts","../src/file-path.vo.ts","../src/filename-from-string.vo.ts","../src/filename-suffix.vo.ts","../src/filename.vo.ts","../src/filter.vo.ts","../src/hour.vo.ts","../src/iban-mask.service.ts","../src/iban.vo.ts","../src/image.vo.ts","../src/index.ts","../src/language.vo.ts","../src/leap-year-checker.service.ts","../src/mean.service.ts","../src/mime-types.vo.ts","../src/mime.vo.ts","../src/min-max-scaler.service.ts","../src/minute.vo.ts","../src/money.vo.ts","../src/noop.service.ts","../src/notification-template.vo.ts","../src/object-key.vo.ts","../src/outlier-detector.service.ts","../src/package-version.vo.ts","../src/pagination.service.ts","../src/percentage.service.ts","../src/population-standard-deviation.service.ts","../src/random.service.ts","../src/rate-limiter.service.ts","../src/relative-date.vo.ts","../src/reordering.service.ts","../src/revision.vo.ts","../src/rounding.service.ts","../src/simple-linear-regression.service.ts","../src/size.vo.ts","../src/stepper.service.ts","../src/stopwatch.service.ts","../src/streak-calculator.service.ts","../src/sum.service.ts","../src/thousands-separator.service.ts","../src/time-zone-offset-value.vo.ts","../src/time.service.ts","../src/timestamp.vo.ts","../src/timezone.vo.ts","../src/ts-utils.ts","../src/visually-unambiguous-characters-generator.service.ts","../src/week-iso-id.vo.ts","../src/week.vo.ts","../src/z-score.service.ts"],"version":"5.9.2"}
+{"root":["../src/api-key.vo.ts","../src/basename.vo.ts","../src/clock.vo.ts","../src/date-calculator.service.ts","../src/date-formatter.service.ts","../src/date-range.vo.ts","../src/dates-of-the-week.vo.ts","../src/day-iso-id.vo.ts","../src/day.vo.ts","../src/directory-path-absolute.vo.ts","../src/directory-path-relative.vo.ts","../src/dll.service.ts","../src/email-mask.service.ts","../src/etags.vo.ts","../src/extension.vo.ts","../src/feature-flag.vo.ts","../src/file-path-absolute-schema.vo.ts","../src/file-path-relative-schema.vo.ts","../src/file-path.vo.ts","../src/filename-from-string.vo.ts","../src/filename-suffix.vo.ts","../src/filename.vo.ts","../src/hour.vo.ts","../src/iban-mask.service.ts","../src/iban.vo.ts","../src/image.vo.ts","../src/index.ts","../src/language.vo.ts","../src/leap-year-checker.service.ts","../src/mean.service.ts","../src/mime-types.vo.ts","../src/mime.vo.ts","../src/min-max-scaler.service.ts","../src/minute.vo.ts","../src/money.vo.ts","../src/noop.service.ts","../src/notification-template.vo.ts","../src/object-key.vo.ts","../src/outlier-detector.service.ts","../src/package-version.vo.ts","../src/pagination.service.ts","../src/percentage.service.ts","../src/population-standard-deviation.service.ts","../src/random.service.ts","../src/rate-limiter.service.ts","../src/relative-date.vo.ts","../src/reordering.service.ts","../src/revision.vo.ts","../src/rounding.service.ts","../src/simple-linear-regression.service.ts","../src/size.vo.ts","../src/stepper.service.ts","../src/stopwatch.service.ts","../src/streak-calculator.service.ts","../src/sum.service.ts","../src/thousands-separator.service.ts","../src/time-zone-offset-value.vo.ts","../src/time.service.ts","../src/timestamp.vo.ts","../src/timezone.vo.ts","../src/ts-utils.ts","../src/visually-unambiguous-characters-generator.service.ts","../src/week-iso-id.vo.ts","../src/week.vo.ts","../src/weekday.vo.ts","../src/z-score.service.ts"],"version":"5.9.2"}

package/dist/visually-unambiguous-characters-generator.service.js

@@ -26,10 +26,7 @@ export class VisuallyUnambiguousCharactersGenerator {
     ];
     static generate(length = 1) {
         return Array.from({ length })
-            .map(() => VisuallyUnambiguousCharactersGenerator.chars[Random.generate({
-            min: 0,
-            max: VisuallyUnambiguousCharactersGenerator.chars.length - 1,
-        })])
+            .map(() => VisuallyUnambiguousCharactersGenerator.chars[Random.generate({ min: 0, max: VisuallyUnambiguousCharactersGenerator.chars.length - 1 })])
             .join("");
     }
 }

package/dist/weekday.vo.d.ts

@@ -0,0 +1,40 @@
+import type { TimestampType } from "./timestamp.vo";
+export type WeekdayFormatter = (value: Weekday["value"]) => string;
+export declare enum WeekdayFormatterEnum {
+    FULL = "FULL",// "Sunday"
+    SHORT = "SHORT",// "Sun"
+    ISO_NUMBER = "ISO_NUMBER",// Monday=1 ... Sunday=7
+    ZERO_BASED_NUMBER = "ZERO_BASED_NUMBER"
+}
+export declare const WeekdayFormatters: Record<WeekdayFormatterEnum, WeekdayFormatter>;
+export declare class Weekday {
+    private readonly value;
+    private readonly formatter;
+    static readonly SUNDAY: Weekday;
+    static readonly MONDAY: Weekday;
+    static readonly TUESDAY: Weekday;
+    static readonly WEDNESDAY: Weekday;
+    static readonly THURSDAY: Weekday;
+    static readonly FRIDAY: Weekday;
+    static readonly SATURDAY: Weekday;
+    constructor(candidate: number, formatter?: WeekdayFormatter);
+    static fromUtcTimestamp(timestamp: TimestampType, formatter?: WeekdayFormatter): Weekday;
+    get(formatter?: WeekdayFormatter): {
+        raw: number;
+        formatted: string;
+    };
+    equals(another: Weekday): boolean;
+    isAfter(another: Weekday): boolean;
+    isBefore(another: Weekday): boolean;
+    toIsoNumber(): number;
+    isWeekend(): boolean;
+    isMonday(): boolean;
+    isTuesday(): boolean;
+    isWednesday(): boolean;
+    isThursday(): boolean;
+    isFriday(): boolean;
+    isSaturday(): boolean;
+    isSunday(): boolean;
+    static list(formatter?: WeekdayFormatter): Weekday[];
+    static listMondayFirst(formatter?: WeekdayFormatter): Weekday[];
+}

package/dist/weekday.vo.js

@@ -0,0 +1,95 @@
+export var WeekdayFormatterEnum;
+(function (WeekdayFormatterEnum) {
+    WeekdayFormatterEnum["FULL"] = "FULL";
+    WeekdayFormatterEnum["SHORT"] = "SHORT";
+    WeekdayFormatterEnum["ISO_NUMBER"] = "ISO_NUMBER";
+    WeekdayFormatterEnum["ZERO_BASED_NUMBER"] = "ZERO_BASED_NUMBER";
+})(WeekdayFormatterEnum || (WeekdayFormatterEnum = {}));
+const FULL_NAMES = [
+    "Sunday",
+    "Monday",
+    "Tuesday",
+    "Wednesday",
+    "Thursday",
+    "Friday",
+    "Saturday",
+];
+const SHORT_NAMES = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+export const WeekdayFormatters = {
+    FULL: (value) => FULL_NAMES[value],
+    SHORT: (value) => SHORT_NAMES[value],
+    ISO_NUMBER: (value) => (value === 0 ? 7 : value).toString(), // ISO-8601: Mon=1..Sun=7
+    ZERO_BASED_NUMBER: (value) => value.toString(), // JS getUTCDay(): Sun=0..Sat=6
+};
+export class Weekday {
+    value;
+    formatter;
+    static SUNDAY = new Weekday(0);
+    static MONDAY = new Weekday(1);
+    static TUESDAY = new Weekday(2);
+    static WEDNESDAY = new Weekday(3);
+    static THURSDAY = new Weekday(4);
+    static FRIDAY = new Weekday(5);
+    static SATURDAY = new Weekday(6);
+    constructor(candidate, formatter) {
+        if (!Number.isInteger(candidate))
+            throw new Error("Invalid weekday");
+        if (candidate < 0)
+            throw new Error("Invalid weekday");
+        if (candidate > 6)
+            throw new Error("Invalid weekday");
+        this.value = candidate;
+        this.formatter = formatter ?? WeekdayFormatters.FULL;
+    }
+    static fromUtcTimestamp(timestamp, formatter) {
+        const day = new Date(timestamp).getUTCDay(); // 0..6
+        return new Weekday(day, formatter);
+    }
+    get(formatter) {
+        const format = formatter ?? this.formatter;
+        return { raw: this.value, formatted: format(this.value) };
+    }
+    equals(another) {
+        return this.value === another.get().raw;
+    }
+    isAfter(another) {
+        return this.value > another.get().raw;
+    }
+    isBefore(another) {
+        return this.value < another.get().raw;
+    }
+    toIsoNumber() {
+        return this.value === 0 ? 7 : this.value;
+    }
+    isWeekend() {
+        return this.value === 0 || this.value === 6;
+    }
+    isMonday() {
+        return this.value === 1;
+    }
+    isTuesday() {
+        return this.value === 2;
+    }
+    isWednesday() {
+        return this.value === 3;
+    }
+    isThursday() {
+        return this.value === 4;
+    }
+    isFriday() {
+        return this.value === 5;
+    }
+    isSaturday() {
+        return this.value === 6;
+    }
+    isSunday() {
+        return this.value === 0;
+    }
+    static list(formatter) {
+        return Array.from({ length: 7 }).map((_, index) => new Weekday(index, formatter));
+    }
+    static listMondayFirst(formatter) {
+        const days = Weekday.list(formatter);
+        return [...days.slice(1), days[0]];
+    }
+}

package/dist/z-score.service.js

@@ -7,9 +7,8 @@ export class ZScore {
     standardDeviation;
     constructor(values, rounding = new RoundToDecimal(2)) {
         this.rounding = rounding;
-        if (values.length < 2) {
+        if (values.length < 2)
             throw new Error("At least two values are needed");
-        }
         this.mean = Mean.calculate(values);
         this.standardDeviation = PopulationStandardDeviation.calculate(values);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/tools",
-  "version": "0.12.26",
+  "version": "0.13.0",
   "type": "module",
   "license": "MIT",
   "author": "Bartosz Gordon",