@bgord/tools 0.14.2 → 0.15.0

package/dist/sum.service.js

@@ -2,4 +2,15 @@ export class Sum {
     static of(values) {
         return values.reduce((sum, x) => sum + x, 0);
     }
+    static precise(values) {
+        let runningTotal = 0;
+        let roundingCompensation = 0;
+        for (const currentValue of values) {
+            const correctedAddend = currentValue - roundingCompensation;
+            const tentativeTotal = runningTotal + correctedAddend;
+            roundingCompensation = tentativeTotal - runningTotal - correctedAddend;
+            runningTotal = tentativeTotal;
+        }
+        return runningTotal;
+    }
 }

package/dist/time.service.js

@@ -1,4 +1,4 @@
-import { RoundToDecimal } from "./rounding.service";
+import { RoundToDecimal } from "./rounding.adapter";
 const rounding = new RoundToDecimal(2);
 export class TimeResult {
     days;

package/dist/timestamp.vo.d.ts

@@ -1,3 +1,6 @@
 import { z } from "zod/v4";
+export declare const TimestampError: {
+    readonly error: "invalid.timestamp";
+};
 export declare const Timestamp: z.core.$ZodBranded<z.ZodNumber, "Timestamp">;
 export type TimestampType = z.infer<typeof Timestamp>;

package/dist/timestamp.vo.js

@@ -1,2 +1,8 @@
 import { z } from "zod/v4";
-export const Timestamp = z.number().int().gte(0).brand("Timestamp");
+export const TimestampError = { error: "invalid.timestamp" };
+export const Timestamp = z
+    .number(TimestampError)
+    .int(TimestampError)
+    .gte(0, TimestampError)
+    .lte(Number.MAX_SAFE_INTEGER, TimestampError)
+    .brand("Timestamp");

package/dist/timezone.vo.d.ts

@@ -1,3 +1,6 @@
 import { z } from "zod/v4";
+export declare const TimezoneError: {
+    readonly error: "timezone.invalid";
+};
 export declare const Timezone: z.core.$ZodBranded<z.ZodString, "Timezone">;
 export type TimezoneType = z.infer<typeof Timezone>;

package/dist/timezone.vo.js

@@ -1,7 +1,8 @@
 import { z } from "zod/v4";
+export const TimezoneError = { error: "timezone.invalid" };
 export const Timezone = z
-    .string()
-    .min(1)
+    .string(TimezoneError)
+    .min(1, TimezoneError)
     .refine((value) => {
     try {
         const date = new Date();
@@ -12,5 +13,5 @@ export const Timezone = z
     catch (_error) {
         return false;
     }
-}, { message: "timezone.invalid" })
+}, TimezoneError)
     .brand("Timezone");

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/age.vo.ts","../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/height.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/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/month-iso-id.vo.ts","../src/month.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/quarter-iso-id.vo.ts","../src/quarter.vo.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/weight.vo.ts","../src/year-iso-id.vo.ts","../src/year.vo.ts","../src/z-score.service.ts"],"version":"5.9.2"}
+{"root":["../src/age.vo.ts","../src/api-key.vo.ts","../src/basename.vo.ts","../src/clock-format.service.ts","../src/clock.vo.ts","../src/date-calculator.service.ts","../src/date-formatter.service.ts","../src/date-range.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/height.vo.ts","../src/hour-format.service.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/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/month-iso-id.vo.ts","../src/month.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/quarter-iso-id.vo.ts","../src/quarter.vo.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.adapter.ts","../src/rounding.port.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/weight.vo.ts","../src/year-iso-id.vo.ts","../src/year.vo.ts","../src/z-score.service.ts"],"version":"5.9.3"}

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

@@ -1,6 +1,5 @@
 import { Random } from "./random.service";
 export class VisuallyUnambiguousCharactersGenerator {
-    // prettier-ignore
     static chars = [
         "a",
         "b",

package/dist/weight.vo.d.ts

@@ -1,4 +1,4 @@
-import { type RoundingStrategy } from "./rounding.service";
+import type { RoundingPort } from "./rounding.port";
 export declare enum WeightUnit {
     kg = "kg",
     lb = "lb"
@@ -14,9 +14,9 @@ export declare class Weight {
     static fromGrams(grams: number): Weight;
     static zero(): Weight;
     toGrams(): number;
-    toKilograms(rounding?: RoundingStrategy): number;
-    toPounds(rounding?: RoundingStrategy): number;
-    format(unit: WeightUnit, rounding?: RoundingStrategy): string;
+    toKilograms(rounding?: RoundingPort): number;
+    toPounds(rounding?: RoundingPort): number;
+    format(unit: WeightUnit, rounding?: RoundingPort): string;
     add(other: Weight): Weight;
     subtract(other: Weight): Weight;
     multiply(factor: number): Weight;

package/dist/weight.vo.js

@@ -1,5 +1,5 @@
 import { z } from "zod/v4";
-import { RoundToDecimal } from "./rounding.service";
+import { RoundToDecimal } from "./rounding.adapter";
 const FiniteNumericValue = z.number().refine(Number.isFinite, { message: "Expected a finite number" });
 const NonNegativeNumericValue = FiniteNumericValue.min(0, { message: "Must be greater than or equal to 0" });
 const PositiveNumericValue = FiniteNumericValue.gt(0, { message: "Must be greater than 0" });

package/dist/z-score.service.d.ts

@@ -1,8 +1,9 @@
-import { type RoundingStrategy } from "./rounding.service";
+import type { RoundingPort } from "./rounding.port";
+export declare const ZScoreMinValuesError: "zscore.min.values";
 export declare class ZScore {
     private readonly rounding;
     private readonly mean;
     private readonly standardDeviation;
-    constructor(values: number[], rounding?: RoundingStrategy);
+    constructor(values: number[], rounding?: RoundingPort);
     calculate(value: number): number;
 }

package/dist/z-score.service.js

@@ -1,6 +1,7 @@
 import { Mean } from "./mean.service";
 import { PopulationStandardDeviation } from "./population-standard-deviation.service";
-import { RoundToDecimal } from "./rounding.service";
+import { RoundToDecimal } from "./rounding.adapter";
+export const ZScoreMinValuesError = "zscore.min.values";
 export class ZScore {
     rounding;
     mean;
@@ -8,7 +9,7 @@ export class ZScore {
     constructor(values, rounding = new RoundToDecimal(2)) {
         this.rounding = rounding;
         if (values.length < 2)
-            throw new Error("At least two values are needed");
+            throw new Error(ZScoreMinValuesError);
         this.mean = Mean.calculate(values);
         this.standardDeviation = PopulationStandardDeviation.calculate(values);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/tools",
-  "version": "0.14.2",
+  "version": "0.15.0",
   "type": "module",
   "license": "MIT",
   "author": "Bartosz Gordon",
@@ -21,7 +21,7 @@
     "preinstall": "bunx only-allow bun"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.2.4",
+    "@biomejs/biome": "2.2.5",
     "@commitlint/cli": "20.1.0",
     "@commitlint/config-conventional": "20.0.0",
     "@types/bun": "1.2.23",
@@ -31,7 +31,7 @@
     "lefthook": "1.13.6",
     "only-allow": "1.2.1",
     "shellcheck": "4.1.0",
-    "typescript": "5.9.2",
+    "typescript": "5.9.3",
     "zod": "4.1.11"
   },
   "dependencies": {

package/readme.md

@@ -27,11 +27,11 @@ src/
 ├── age.vo.ts
 ├── api-key.vo.ts
 ├── basename.vo.ts
+├── clock-format.service.ts
 ├── clock.vo.ts
 ├── date-calculator.service.ts
 ├── date-formatter.service.ts
 ├── date-range.vo.ts
-├── dates-of-the-week.vo.ts
 ├── day-iso-id.vo.ts
 ├── day.vo.ts
 ├── directory-path-absolute.vo.ts
@@ -48,6 +48,7 @@ src/
 ├── filename-suffix.vo.ts
 ├── filename.vo.ts
 ├── height.vo.ts
+├── hour-format.service.ts
 ├── hour.vo.ts
 ├── iban-mask.service.ts
 ├── iban.vo.ts
@@ -76,7 +77,8 @@ src/
 ├── relative-date.vo.ts
 ├── reordering.service.ts
 ├── revision.vo.ts
-├── rounding.service.ts
+├── rounding.adapter.ts
+├── rounding.port.ts
 ├── simple-linear-regression.service.ts
 ├── size.vo.ts
 ├── stepper.service.ts

package/src/age.vo.ts

@@ -2,7 +2,9 @@ import { differenceInYears } from "date-fns";
 import { z } from "zod/v4";
 import type { TimestampType } from "./timestamp.vo";
 
-export const AgeValueError = { error: "invalid.age" };
+export const AgeValueError = { error: "invalid.age" } as const;
+export const InvalidBirthdateInFutureError = "invalid.birthdate_in_future" as const;
+export const InvalidBirthdateError = "invalid.birthdate" as const;
 
 export class Age {
   static readonly MIN = 1;
@@ -25,41 +27,43 @@ export class Age {
     return this.value === other.value ? 0 : this.value < other.value ? -1 : 1;
   }
 
-  equals(another: Age): boolean {
-    return this.compare(another) === 0;
+  equals(other: Age): boolean {
+    return this.value === other.value;
   }
 
-  isOlderThan(another: Age): boolean {
-    return this.compare(another) === 1;
+  isOlderThan(other: Age): boolean {
+    return this.value > other.value;
   }
 
-  isYoungerThan(another: Age): boolean {
-    return this.compare(another) === -1;
+  isYoungerThan(other: Age): boolean {
+    return this.value < other.value;
   }
 
-  isAdult(minAge: Age): boolean {
-    return this.equals(minAge) || this.isOlderThan(minAge);
+  isAdult(minimumAge: Age): boolean {
+    return this.value >= minimumAge.value;
   }
 
   static fromValue(candidate: number): Age {
     return new Age(Age.AgeValue.parse(candidate));
   }
 
-  static fromBirthdateTimestamp(params: { birthdate: TimestampType; now: TimestampType }): Age {
-    if (params.birthdate > params.now) throw new Error("invalid.birthdate_in_future");
-
-    const years = differenceInYears(new Date(params.now), new Date(params.birthdate));
-
-    return Age.fromValue(years);
+  static fromBirthdateEpochMs(params: { birthdate: TimestampType; now: TimestampType }): Age {
+    if (params.birthdate > params.now) throw new Error(InvalidBirthdateInFutureError);
+    return Age.fromValue(differenceInYears(params.now, params.birthdate));
   }
 
   static fromBirthdate(params: { birthdate: string; now: TimestampType }): Age {
-    const birthdate = new Date(params.birthdate).getTime();
+    const birthdateMs = new Date(params.birthdate).getTime();
 
-    if (birthdate > params.now) throw new Error("invalid.birthdate_in_future");
+    if (birthdateMs > params.now) throw new Error(InvalidBirthdateInFutureError);
+    return Age.fromValue(differenceInYears(params.now, birthdateMs));
+  }
 
-    const years = differenceInYears(new Date(params.now), new Date(birthdate));
+  toJSON(): number {
+    return this.get();
+  }
 
-    return Age.fromValue(years);
+  toString(): string {
+    return String(this.value);
   }
 }

package/src/api-key.vo.ts

@@ -1,4 +1,12 @@
 import { z } from "zod/v4";
 
-export const ApiKey = z.string().trim().length(64).brand("ApiKey");
+export const ApiKeyError = { error: "invalid.api.key" };
+
+export const ApiKey = z
+  .string(ApiKeyError)
+  .trim()
+  .length(64, ApiKeyError)
+  .regex(/^[0-9a-f]{64}$/i, ApiKeyError)
+  .brand("ApiKey");
+
 export type ApiKeyType = z.infer<typeof ApiKey>;

package/src/clock-format.service.ts

@@ -0,0 +1,15 @@
+import type { Hour } from "./hour.vo";
+import { HourFormatters } from "./hour-format.service";
+import type { Minute } from "./minute.vo";
+
+export type ClockFormatter = (hour: Hour, minute: Minute) => string;
+
+enum ClockFormatterEnum {
+  TWENTY_FOUR_HOURS = "TWENTY_FOUR_HOURS",
+  TWELVE_HOURS = "TWELVE_HOURS",
+}
+
+export const ClockFormatters: Record<ClockFormatterEnum, ClockFormatter> = {
+  TWENTY_FOUR_HOURS: (hour, minute) => `${hour.toString()}:${minute.toString()}`,
+  TWELVE_HOURS: (hour, minute) => `${hour.format(HourFormatters.TWELVE_HOURS)}:${minute.toString()}`,
+} as const;

package/src/clock.vo.ts

@@ -1,21 +1,8 @@
-import { Hour, HourFormatters } from "./hour.vo";
+import { type ClockFormatter, ClockFormatters } from "./clock-format.service";
+import { Hour } from "./hour.vo";
 import { Minute } from "./minute.vo";
 import type { TimestampType } from "./timestamp.vo";
 
-export type ClockFormatter = (hour: Hour, minute: Minute) => string;
-
-enum ClockFormatterEnum {
-  TWENTY_FOUR_HOURS = "TWENTY_FOUR_HOURS",
-  TWELVE_HOURS = "TWELVE_HOURS",
-}
-
-export const ClockFormatters: Record<ClockFormatterEnum, ClockFormatter> = {
-  TWENTY_FOUR_HOURS: (hour, minute) => `${hour.get().formatted}:${minute.get().formatted}`,
-
-  TWELVE_HOURS: (hour, minute) =>
-    `${hour.get(HourFormatters.TWELVE_HOURS).formatted}:${minute.get().formatted}`,
-} as const;
-
 export class Clock {
   private readonly formatter: ClockFormatter;
 
@@ -27,48 +14,42 @@ export class Clock {
     this.formatter = (formatter as ClockFormatter) ?? ClockFormatters.TWENTY_FOUR_HOURS;
   }
 
-  static fromUtcTimestamp(timestamp: TimestampType, formatter?: ClockFormatter) {
-    const hour = Hour.fromUtcTimestamp(timestamp);
-    const minute = Minute.fromUtcTimestamp(timestamp);
+  static fromEpochMs(timestamp: TimestampType, formatter?: ClockFormatter): Clock {
+    const hour = Hour.fromEpochMs(timestamp);
+    const minute = Minute.fromEpochMs(timestamp);
     return new Clock(hour, minute, formatter);
   }
 
-  get(formatter?: ClockFormatter) {
-    const format = formatter ?? this.formatter;
+  get(): { hour: number; minute: number } {
+    return { hour: this.hour.get(), minute: this.minute.get() };
+  }
+
+  format(formatter?: ClockFormatter): string {
+    const chosen = formatter ?? this.formatter;
+    return chosen(this.hour, this.minute);
+  }
 
-    return {
-      raw: { hour: this.hour.get().raw, minute: this.minute.get().raw },
-      formatted: format(this.hour, this.minute),
-    };
+  toString(): string {
+    return this.format();
   }
 
   equals(another: Clock): boolean {
-    return (
-      this.hour.get().raw === another.get().raw.hour && this.minute.get().raw === another.get().raw.minute
-    );
+    return this.hour.get() === another.hour.get() && this.minute.get() === another.minute.get();
   }
 
   isAfter(another: Clock): boolean {
-    if (this.hour.get().raw > another.hour.get().raw) {
-      return true;
-    }
+    const thisHour = this.hour.get();
+    const otherHour = another.hour.get();
 
-    if (this.hour.get().raw === another.hour.get().raw && this.minute.get().raw > another.minute.get().raw) {
-      return true;
-    }
-
-    return false;
+    if (thisHour !== otherHour) return thisHour > otherHour;
+    return this.minute.get() > another.minute.get();
   }
 
   isBefore(another: Clock): boolean {
-    if (this.hour.get().raw < another.hour.get().raw) {
-      return true;
-    }
-
-    if (this.hour.get().raw === another.hour.get().raw && this.minute.get().raw < another.minute.get().raw) {
-      return true;
-    }
+    const thisHour = this.hour.get();
+    const otherHour = another.hour.get();
 
-    return false;
+    if (thisHour !== otherHour) return thisHour < otherHour;
+    return this.minute.get() < another.minute.get();
   }
 }

package/src/height.vo.ts

@@ -1,5 +1,6 @@
 import { z } from "zod/v4";
-import { type RoundingStrategy, RoundToDecimal, RoundToNearest } from "./rounding.service";
+import { RoundToDecimal, RoundToNearest } from "./rounding.adapter";
+import type { RoundingPort } from "./rounding.port";
 
 const FiniteNumericValue = z.number().refine(Number.isFinite, { message: "Expected a finite number" });
 const NonNegativeNumericValue = FiniteNumericValue.min(0, { message: "Must be greater than or equal to 0" });
@@ -22,7 +23,7 @@ export class Height {
 
   private constructor(private readonly millimeters: number) {}
 
-  static fromCentimeters(centimeters: number, rounding: RoundingStrategy = new RoundToNearest()): Height {
+  static fromCentimeters(centimeters: number, rounding: RoundingPort = new RoundToNearest()): Height {
     NonNegativeNumericValue.parse(centimeters);
     const mmFloat = centimeters * Height.MILLIMETERS_PER_CENTIMETER;
     const mmRounded = rounding.round(mmFloat);
@@ -30,7 +31,7 @@ export class Height {
     return new Height(mmRounded);
   }
 
-  static fromFeetInches(feet: number, inches = 0, rounding: RoundingStrategy = new RoundToNearest()): Height {
+  static fromFeetInches(feet: number, inches = 0, rounding: RoundingPort = new RoundToNearest()): Height {
     NonNegativeNumericValue.parse(feet);
     NonNegativeNumericValue.parse(inches);
     const totalInches = feet * Height.INCHES_PER_FOOT + inches;
@@ -40,7 +41,7 @@ export class Height {
     return new Height(mmRounded);
   }
 
-  static fromMillimeters(millimeters: number, rounding: RoundingStrategy = new RoundToNearest()): Height {
+  static fromMillimeters(millimeters: number, rounding: RoundingPort = new RoundToNearest()): Height {
     NonNegativeNumericValue.parse(millimeters);
     const mmRounded = rounding.round(millimeters);
     NonNegativeIntegerMillimeters.parse(mmRounded);
@@ -55,12 +56,12 @@ export class Height {
     return this.millimeters;
   }
 
-  toCentimeters(rounding?: RoundingStrategy): number {
+  toCentimeters(rounding?: RoundingPort): number {
     const cm = this.millimeters / Height.MILLIMETERS_PER_CENTIMETER;
     return rounding ? rounding.round(cm) : cm;
   }
 
-  toFeetInches(rounding: RoundingStrategy = new RoundToNearest()): {
+  toFeetInches(rounding: RoundingPort = new RoundToNearest()): {
     feet: number;
     inches: number;
   } {
@@ -74,16 +75,16 @@ export class Height {
     return { feet, inches };
   }
 
-  format(unit: HeightUnit, roundingStrategy?: RoundingStrategy): string {
+  format(unit: HeightUnit, rounding?: RoundingPort): string {
     return {
       [HeightUnit.cm]: () => {
-        const rounding = roundingStrategy ?? new RoundToDecimal(1);
+        const chosen = rounding ?? new RoundToDecimal(1);
 
-        return `${this.toCentimeters(rounding)} cm`;
+        return `${this.toCentimeters(chosen)} cm`;
       },
       [HeightUnit.ft_in]: () => {
-        const rounding = roundingStrategy ?? new RoundToNearest();
-        const { feet, inches } = this.toFeetInches(rounding);
+        const chosen = rounding ?? new RoundToNearest();
+        const { feet, inches } = this.toFeetInches(chosen);
 
         return `${feet}′${inches}″`;
       },

package/src/hour-format.service.ts

@@ -0,0 +1,21 @@
+export type HourFormatter = (value: number) => string;
+
+enum HourFormatterEnum {
+  TWENTY_FOUR_HOURS = "TWENTY_FOUR_HOURS",
+  TWENTY_FOUR_HOURS_WO_PADDING = "TWENTY_FOUR_HOURS_WO_PADDING",
+  AM_PM = "AM_PM",
+  TWELVE_HOURS = "TWELVE_HOURS",
+  TWELVE_HOURS_WO_PADDING = "TWELVE_HOURS_WO_PADDING",
+}
+
+export const HourFormatters: Record<HourFormatterEnum, HourFormatter> = {
+  TWENTY_FOUR_HOURS: (value) => value.toString().padStart(2, "0"),
+  TWENTY_FOUR_HOURS_WO_PADDING: (value) => value.toString(),
+  AM_PM: (value) => {
+    const twelveHourValue = value % 12 || 12;
+    const suffix = value < 12 ? "a.m." : "p.m.";
+    return `${twelveHourValue} ${suffix}`;
+  },
+  TWELVE_HOURS: (value) => (value % 12 || 12).toString().padStart(2, "0"),
+  TWELVE_HOURS_WO_PADDING: (value) => (value % 12 || 12).toString(),
+} as const;

package/src/hour.vo.ts

@@ -1,73 +1,50 @@
+import { type HourFormatter, HourFormatters } from "./hour-format.service";
 import type { TimestampType } from "./timestamp.vo";
 
-export type HourFormatter = (value: Hour["value"]) => string;
-
-export enum HourFormatterEnum {
-  TWENTY_FOUR_HOURS = "TWENTY_FOUR_HOURS",
-  TWENTY_FOUR_HOURS_WO_PADDING = "TWENTY_FOUR_HOURS_WO_PADDING",
-  AM_PM = "AM_PM",
-  TWELVE_HOURS = "TWELVE_HOURS",
-  TWELVE_HOURS_WO_PADDING = "TWELVE_HOURS_WO_PADDING",
-}
-
-export const HourFormatters: Record<HourFormatterEnum, HourFormatter> = {
-  TWENTY_FOUR_HOURS: (value) => value.toString().padStart(2, "0"),
-
-  TWENTY_FOUR_HOURS_WO_PADDING: (value) => value.toString(),
-
-  AM_PM: (value) => {
-    const twelveHour = value % 12 || 12;
-    return `${twelveHour.toString()} ${value < 12 ? "a.m." : "p.m."}`;
-  },
-
-  TWELVE_HOURS: (value) => (value % 12 || 12).toString().padStart(2, "0"),
-
-  TWELVE_HOURS_WO_PADDING: (value) => (value % 12 || 12).toString(),
-} as const;
+export const HourValueError = "invalid.hour" as const;
 
 export class Hour {
   private readonly value: number;
 
-  private readonly formatter: HourFormatter;
-
   static readonly ZERO = new Hour(0);
-
   static readonly MAX = new Hour(23);
 
-  constructor(candidate: number, formatter?: HourFormatter) {
-    if (!Number.isInteger(candidate)) throw new Error("Invalid hour");
-    if (candidate < 0) throw new Error("Invalid hour");
-    if (candidate >= 24) throw new Error("Invalid hour");
-
+  constructor(candidate: number) {
+    if (!Number.isInteger(candidate) || candidate < 0 || candidate >= 24) {
+      throw new Error(HourValueError);
+    }
     this.value = candidate;
-    this.formatter = (formatter as HourFormatter) ?? HourFormatters.TWENTY_FOUR_HOURS;
   }
 
-  get(formatter?: HourFormatter) {
-    const format = formatter ?? this.formatter;
+  static fromEpochMs(timestamp: TimestampType): Hour {
+    return new Hour(new Date(timestamp).getUTCHours());
+  }
 
-    return { raw: this.value, formatted: format(this.value) };
+  get(): number {
+    return this.value;
   }
 
-  equals(another: Hour): boolean {
-    return this.value === another.get().raw;
+  toString(): string {
+    return HourFormatters.TWENTY_FOUR_HOURS(this.value);
   }
 
-  isAfter(another: Hour): boolean {
-    return this.value > another.get().raw;
+  format(formatter: HourFormatter): string {
+    return formatter(this.value);
   }
 
-  isBefore(another: Hour): boolean {
-    return this.value < another.get().raw;
+  equals(another: Hour): boolean {
+    return this.value === another.value;
   }
 
-  static fromUtcTimestamp(timestamp: TimestampType, formatter?: HourFormatter): Hour {
-    const hours = new Date(timestamp).getUTCHours();
+  isAfter(another: Hour): boolean {
+    return this.value > another.value;
+  }
 
-    return new Hour(hours, formatter);
+  isBefore(another: Hour): boolean {
+    return this.value < another.value;
   }
 
-  static list(formatter?: HourFormatter) {
-    return Array.from({ length: 24 }).map((_, index) => new Hour(index, formatter));
+  static list(): readonly Hour[] {
+    return Array.from({ length: 24 }, (_, index) => new Hour(index));
   }
 }

package/src/iban-mask.service.ts

@@ -6,10 +6,15 @@ export class IbanMask {
   static censor(iban: IBAN): IbanMaskedType {
     const value = iban.format();
 
-    const start = value.slice(0, 4);
-    const middle = value.slice(5, -5).replace(/\d/g, "*");
+    const FIRST_SPACE_INDEX = 4;
+    const LAST_SPACE_START_INDEX = value.length - 5;
+
+    const start = value.slice(0, FIRST_SPACE_INDEX);
+    const middle = value.slice(FIRST_SPACE_INDEX + 1, LAST_SPACE_START_INDEX);
     const end = value.slice(-4);
 
-    return `${start} ${middle} ${end}`;
+    const maskedMiddle = middle.replace(/[A-Z0-9]/g, "*");
+
+    return `${start} ${maskedMiddle} ${end}`;
   }
 }