@bgord/tools 1.1.17 → 1.1.20

package/dist/age.vo.d.ts

@@ -1,3 +1,4 @@
+import { type AgeYearsType } from "./age-years.vo";
 import { Timestamp } from "./timestamp.vo";
 export declare const AgeError: {
     readonly FutureBirthdate: "age.future.birthdate";
@@ -8,6 +9,7 @@ export declare class Age {
     static readonly MAX: number;
     private constructor();
     static fromValue(candidate: number): Age;
+    static fromValueSafe(candidate: AgeYearsType): Age;
     static fromBirthdateTimestamp(params: {
         birthdate: Timestamp;
         now: Timestamp;

package/dist/age.vo.js

@@ -12,6 +12,9 @@ export class Age {
     static fromValue(candidate) {
         return new Age(AgeYears.parse(candidate));
     }
+    static fromValueSafe(candidate) {
+        return new Age(candidate);
+    }
     static fromBirthdateTimestamp(params) {
         if (params.birthdate.isAfter(params.now))
             throw new Error(AgeError.FutureBirthdate);

package/dist/distance-value.vo.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod/v4";
+export declare const DistanceValueError: {
+    Type: string;
+    Invalid: string;
+};
+export declare const DistanceValue: z.core.$ZodBranded<z.ZodNumber, "DistanceValue">;
+export type DistanceValueType = z.infer<typeof DistanceValue>;

package/dist/distance-value.vo.js

@@ -0,0 +1,7 @@
+import { z } from "zod/v4";
+export const DistanceValueError = { Type: "distance.value.type", Invalid: "distance.value.invalid" };
+export const DistanceValue = z
+    .number(DistanceValueError.Type)
+    .int(DistanceValueError.Type)
+    .min(0, DistanceValueError.Invalid)
+    .brand("DistanceValue");

package/dist/distance.vo.d.ts

@@ -0,0 +1,24 @@
+import { type DistanceValueType } from "./distance-value.vo";
+import type { RoundingPort } from "./rounding.port";
+export declare const DistanceError: {
+    readonly SubtractResultLessThanZero: "distance.subtract.result.less.than.zero";
+};
+export declare class Distance {
+    private readonly value;
+    private static readonly ZERO;
+    private constructor();
+    static fromMeters(candidate: number): Distance;
+    static fromMetersSafe(candidate: DistanceValueType): Distance;
+    static fromKilometers(candidate: number, rounding?: RoundingPort): Distance;
+    static fromMiles(candidate: number, rounding?: RoundingPort): Distance;
+    get(): DistanceValueType;
+    add(distance: Distance): Distance;
+    subtract(money: Distance): Distance;
+    equals(another: Distance): boolean;
+    isLongerThan(another: Distance): boolean;
+    isShorterThan(another: Distance): boolean;
+    isZero(): boolean;
+    format(): string;
+    toString(): string;
+    toJSON(): number;
+}

package/dist/distance.vo.js

@@ -0,0 +1,57 @@
+import { DistanceValue } from "./distance-value.vo";
+import { RoundToNearest } from "./rounding.adapter";
+export const DistanceError = {
+    SubtractResultLessThanZero: "distance.subtract.result.less.than.zero",
+};
+export class Distance {
+    value;
+    static ZERO = DistanceValue.parse(0);
+    constructor(value) {
+        this.value = value;
+    }
+    static fromMeters(candidate) {
+        return new Distance(DistanceValue.parse(candidate));
+    }
+    static fromMetersSafe(candidate) {
+        return new Distance(candidate);
+    }
+    static fromKilometers(candidate, rounding = new RoundToNearest()) {
+        return new Distance(DistanceValue.parse(rounding.round(candidate * 1000)));
+    }
+    static fromMiles(candidate, rounding = new RoundToNearest()) {
+        return new Distance(DistanceValue.parse(rounding.round(candidate * 1_609.344)));
+    }
+    get() {
+        return this.value;
+    }
+    add(distance) {
+        return new Distance(DistanceValue.parse(this.value + distance.get()));
+    }
+    subtract(money) {
+        const result = this.value - money.get();
+        if (result < Distance.ZERO)
+            throw new Error(DistanceError.SubtractResultLessThanZero);
+        return new Distance(DistanceValue.parse(result));
+    }
+    equals(another) {
+        return this.value === another.get();
+    }
+    isLongerThan(another) {
+        return this.value > another.get();
+    }
+    isShorterThan(another) {
+        return this.value < another.get();
+    }
+    isZero() {
+        return this.value === Distance.ZERO;
+    }
+    format() {
+        return this.value.toString();
+    }
+    toString() {
+        return this.format();
+    }
+    toJSON() {
+        return this.value;
+    }
+}

package/dist/height-milimiters.vo.d.ts

@@ -4,3 +4,4 @@ export declare const HeightMillimetersError: {
     readonly Invalid: "height.millimeters.invalid";
 };
 export declare const HeightMillimeters: z.core.$ZodBranded<z.ZodNumber, "HeightMillimeters">;
+export type HeightMillimetersType = z.infer<typeof HeightMillimeters>;

package/dist/height.vo.d.ts

@@ -1,10 +1,13 @@
+import { type HeightMillimetersType } from "./height-milimiters.vo";
 import type { RoundingPort } from "./rounding.port";
 export declare class Height {
     private readonly millimeters;
+    private static readonly ZERO;
     private static readonly MILLIMETERS_PER_CENTIMETER;
     private constructor();
-    static fromCentimeters(centimeters: number, rounding?: RoundingPort): Height;
     static fromMillimeters(millimeters: number): Height;
+    static fromMillimetersSafe(millimeters: HeightMillimetersType): Height;
+    static fromCentimeters(centimeters: number, rounding?: RoundingPort): Height;
     static zero(): Height;
     get(): number;
     toMillimeters(): number;

package/dist/height.vo.js

@@ -2,19 +2,23 @@ import { HeightMillimeters } from "./height-milimiters.vo";
 import { RoundToDecimal, RoundToNearest } from "./rounding.adapter";
 export class Height {
     millimeters;
+    static ZERO = HeightMillimeters.parse(0);
     static MILLIMETERS_PER_CENTIMETER = 10;
     constructor(millimeters) {
         this.millimeters = millimeters;
     }
-    static fromCentimeters(centimeters, rounding = new RoundToNearest()) {
-        const millimeters = rounding.round(centimeters * Height.MILLIMETERS_PER_CENTIMETER);
+    static fromMillimeters(millimeters) {
         return new Height(HeightMillimeters.parse(millimeters));
     }
-    static fromMillimeters(millimeters) {
+    static fromMillimetersSafe(millimeters) {
+        return new Height(millimeters);
+    }
+    static fromCentimeters(centimeters, rounding = new RoundToNearest()) {
+        const millimeters = rounding.round(centimeters * Height.MILLIMETERS_PER_CENTIMETER);
         return new Height(HeightMillimeters.parse(millimeters));
     }
     static zero() {
-        return new Height(0);
+        return Height.fromMillimetersSafe(Height.ZERO);
     }
     get() {
         return this.millimeters;

package/dist/hour.vo.d.ts

@@ -4,11 +4,13 @@ import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.vo";
 export declare class Hour {
     private readonly value;
-    static readonly ZERO: Hour;
-    static readonly MAX: Hour;
-    constructor(candidate: number);
+    private constructor();
+    static fromValue(candidate: number): Hour;
+    static fromValueSafe(candidate: HourSchemaType): Hour;
     static fromTimestamp(timestamp: Timestamp): Hour;
     static fromTimestampValue(timestamp: TimestampValueType): Hour;
+    static zero(): Hour;
+    static max(): Hour;
     get(): HourSchemaType;
     format(formatter: HourFormatter): string;
     equals(another: Hour): boolean;

package/dist/hour.vo.js

@@ -3,17 +3,27 @@ import { HourSchema } from "./hour-schema.vo";
 import { Timestamp } from "./timestamp.vo";
 export class Hour {
     value;
-    static ZERO = new Hour(0);
-    static MAX = new Hour(23);
-    constructor(candidate) {
-        this.value = HourSchema.parse(candidate);
+    constructor(value) {
+        this.value = value;
+    }
+    static fromValue(candidate) {
+        return new Hour(HourSchema.parse(candidate));
+    }
+    static fromValueSafe(candidate) {
+        return new Hour(candidate);
     }
     static fromTimestamp(timestamp) {
-        return new Hour(new Date(timestamp.ms).getUTCHours());
+        return new Hour(HourSchema.parse(new Date(timestamp.ms).getUTCHours()));
     }
     static fromTimestampValue(timestamp) {
         return Hour.fromTimestamp(Timestamp.fromValue(timestamp));
     }
+    static zero() {
+        return Hour.fromValue(0);
+    }
+    static max() {
+        return Hour.fromValue(23);
+    }
     get() {
         return this.value;
     }
@@ -30,7 +40,7 @@ export class Hour {
         return this.value < another.value;
     }
     static list() {
-        return Array.from({ length: 24 }, (_, index) => new Hour(index));
+        return Array.from({ length: 24 }, (_, index) => Hour.fromValue(index));
     }
     toString() {
         return HourFormatters.TWENTY_FOUR_HOURS(this.value);

package/dist/index.d.ts

@@ -11,6 +11,8 @@ export * from "./day.vo";
 export * from "./day-iso-id.vo";
 export * from "./directory-path-absolute.vo";
 export * from "./directory-path-relative.vo";
+export * from "./distance.vo";
+export * from "./distance-value.vo";
 export * from "./division-factor.vo";
 export * from "./dll.service";
 export * from "./duration.service";

package/dist/index.js

@@ -11,6 +11,8 @@ export * from "./day.vo";
 export * from "./day-iso-id.vo";
 export * from "./directory-path-absolute.vo";
 export * from "./directory-path-relative.vo";
+export * from "./distance.vo";
+export * from "./distance-value.vo";
 export * from "./division-factor.vo";
 export * from "./dll.service";
 export * from "./duration.service";

package/dist/minute.vo.d.ts

@@ -3,11 +3,13 @@ import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.vo";
 export declare class Minute {
     private readonly value;
-    static readonly ZERO: Minute;
-    static readonly MAX: Minute;
-    constructor(candidate: number);
+    private constructor();
+    static fromValue(candidate: number): Minute;
+    static fromValueSafe(candidate: MinuteSchemaType): Minute;
     static fromTimestamp(timestamp: Timestamp): Minute;
     static fromTimestampValue(timestamp: TimestampValueType): Minute;
+    static zero(): Minute;
+    static max(): Minute;
     get(): MinuteSchemaType;
     equals(another: Minute): boolean;
     isAfter(another: Minute): boolean;

package/dist/minute.vo.js

@@ -2,17 +2,27 @@ import { MinuteSchema } from "./minute-schema.vo";
 import { Timestamp } from "./timestamp.vo";
 export class Minute {
     value;
-    static ZERO = new Minute(0);
-    static MAX = new Minute(59);
-    constructor(candidate) {
-        this.value = MinuteSchema.parse(candidate);
+    constructor(value) {
+        this.value = value;
+    }
+    static fromValue(candidate) {
+        return new Minute(MinuteSchema.parse(candidate));
+    }
+    static fromValueSafe(candidate) {
+        return new Minute(candidate);
     }
     static fromTimestamp(timestamp) {
-        return new Minute(new Date(timestamp.ms).getUTCMinutes());
+        return new Minute(MinuteSchema.parse(new Date(timestamp.ms).getUTCMinutes()));
     }
     static fromTimestampValue(timestamp) {
         return Minute.fromTimestamp(Timestamp.fromValue(timestamp));
     }
+    static zero() {
+        return Minute.fromValue(0);
+    }
+    static max() {
+        return Minute.fromValue(59);
+    }
     get() {
         return this.value;
     }
@@ -26,7 +36,7 @@ export class Minute {
         return this.value < another.value;
     }
     static list() {
-        return Array.from({ length: 60 }, (_, index) => new Minute(index));
+        return Array.from({ length: 60 }, (_, index) => Minute.fromValue(index));
     }
     toString() {
         return this.value.toString().padStart(2, "0");

package/dist/money.vo.d.ts

@@ -6,11 +6,13 @@ export declare const MoneyError: {
     readonly SubtractResultLessThanZero: "money.subtract.result.less.than.zero";
 };
 export declare class Money {
-    private static readonly ZERO;
-    private static readonly DEFAULT_ROUNDING;
     private readonly amount;
     private readonly rounding;
-    constructor(value?: number, rounding?: RoundingPort);
+    private static readonly ZERO;
+    private constructor();
+    static fromAmount(candidate: number, rounding?: RoundingPort): Money;
+    static fromAmountSafe(candidate: MoneyAmountType, rounding?: RoundingPort): Money;
+    static zero(): Money;
     getAmount(): MoneyAmountType;
     add(money: Money): Money;
     multiply(factor: MultiplicationFactorType): Money;

package/dist/money.vo.js

@@ -2,34 +2,39 @@ import { MoneyAmount } from "./money-amount.vo";
 import { RoundDown, RoundToNearest } from "./rounding.adapter";
 export const MoneyError = { SubtractResultLessThanZero: "money.subtract.result.less.than.zero" };
 export class Money {
-    static ZERO = 0;
-    static DEFAULT_ROUNDING = new RoundToNearest();
     amount;
     rounding;
-    constructor(value = Money.ZERO, rounding) {
-        this.amount = MoneyAmount.parse(value);
-        this.rounding = rounding ?? Money.DEFAULT_ROUNDING;
+    static ZERO = MoneyAmount.parse(0);
+    constructor(amount, rounding = new RoundToNearest()) {
+        this.amount = amount;
+        this.rounding = rounding;
+    }
+    static fromAmount(candidate, rounding) {
+        return new Money(MoneyAmount.parse(candidate), rounding);
+    }
+    static fromAmountSafe(candidate, rounding) {
+        return new Money(candidate, rounding);
+    }
+    static zero() {
+        return Money.fromAmount(0);
     }
     getAmount() {
         return this.amount;
     }
     add(money) {
-        const result = this.amount + money.getAmount();
-        return new Money(MoneyAmount.parse(result), this.rounding);
+        return new Money(MoneyAmount.parse(this.amount + money.getAmount()), this.rounding);
     }
     multiply(factor) {
-        const result = this.rounding.round(this.amount * factor);
-        return new Money(MoneyAmount.parse(result), this.rounding);
+        return new Money(MoneyAmount.parse(this.rounding.round(this.amount * factor)), this.rounding);
     }
     subtract(money) {
         const result = this.amount - money.getAmount();
         if (result < Money.ZERO)
             throw new Error(MoneyError.SubtractResultLessThanZero);
-        return new Money(MoneyAmount.parse(result), this.rounding);
+        return new Money(MoneyAmount.parse(this.rounding.round(result)), this.rounding);
     }
     divide(factor) {
-        const result = this.rounding.round(this.amount / factor);
-        return new Money(MoneyAmount.parse(result), this.rounding);
+        return new Money(MoneyAmount.parse(this.rounding.round(this.amount / factor)), this.rounding);
     }
     equals(another) {
         return this.amount === another.getAmount();

package/dist/package-version.vo.d.ts

@@ -1,9 +1,11 @@
+import { type PackageVersionSchemaType } from "./package-version-schema.vo";
 export declare class PackageVersion {
     private readonly major;
     private readonly minor;
     private readonly patch;
     constructor(major: number, minor: number, patch: number);
-    static fromStringWithV(candidate: string): PackageVersion;
+    static fromVersionString(candidate: string): PackageVersion;
+    static fromVersionStringSafe(candidate: PackageVersionSchemaType): PackageVersion;
     static fromString(candidate: string): PackageVersion;
     isGreaterThanOrEqual(another: PackageVersion): boolean;
     toString(): string;

package/dist/package-version.vo.js

@@ -8,10 +8,13 @@ export class PackageVersion {
         this.minor = minor;
         this.patch = patch;
     }
-    static fromStringWithV(candidate) {
+    static fromVersionString(candidate) {
         const version = PackageVersionSchema.parse(candidate);
         return new PackageVersion(version.major, version.minor, version.patch);
     }
+    static fromVersionStringSafe(candidate) {
+        return new PackageVersion(candidate.major, candidate.minor, candidate.patch);
+    }
     static fromString(candidate) {
         const version = PackageVersionSchema.parse(`v${candidate}`);
         return new PackageVersion(version.major, version.minor, version.patch);

package/dist/size.vo.d.ts

@@ -17,7 +17,7 @@ export declare class Size {
     private static readonly GB_MULTIPLIER;
     private static readonly CONVERT_ROUND;
     private static readonly FORMAT_ROUND;
-    constructor(config: SizeConfigType);
+    private constructor();
     static fromBytes(value: SizeConfigType["value"]): Size;
     static fromKb(value: SizeConfigType["value"]): Size;
     static fromMB(value: SizeConfigType["value"]): Size;

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/age-years.vo.ts","../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/division-factor.vo.ts","../src/dll.service.ts","../src/duration-ms.vo.ts","../src/duration.service.ts","../src/email-mask.service.ts","../src/etags.vo.ts","../src/extension.vo.ts","../src/feature-flag-value.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-affix.vo.ts","../src/filename-from-string.vo.ts","../src/filename.vo.ts","../src/height-milimiters.vo.ts","../src/height.vo.ts","../src/hour-format.service.ts","../src/hour-schema.vo.ts","../src/hour.vo.ts","../src/iban-mask.service.ts","../src/iban-schema.vo.ts","../src/iban.vo.ts","../src/image.vo.ts","../src/index.ts","../src/language.vo.ts","../src/linear-regression.service.ts","../src/mean.service.ts","../src/mime-types.vo.ts","../src/mime-value.vo.ts","../src/mime.vo.ts","../src/min-max-scaler.service.ts","../src/minute-schema.vo.ts","../src/minute.vo.ts","../src/money-amount.vo.ts","../src/money.vo.ts","../src/month-iso-id.vo.ts","../src/month.vo.ts","../src/multiplication-factor.vo.ts","../src/noop.service.ts","../src/notification-template.vo.ts","../src/object-key.vo.ts","../src/outlier-detector.service.ts","../src/package-version-schema.vo.ts","../src/package-version.vo.ts","../src/pagination-page.vo.ts","../src/pagination-skip.vo.ts","../src/pagination-take.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-item-position-value.vo.ts","../src/reordering.service.ts","../src/revision-value.vo.ts","../src/revision.vo.ts","../src/rounding.adapter.ts","../src/rounding.port.ts","../src/size-bytes.vo.ts","../src/size.vo.ts","../src/slug.service.ts","../src/stopwatch.service.ts","../src/sum.service.ts","../src/thousands-separator.service.ts","../src/time-zone-offset-value.vo.ts","../src/timestamp-value.vo.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-grams.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"}
+{"root":["../src/age-years.vo.ts","../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/distance-value.vo.ts","../src/distance.vo.ts","../src/division-factor.vo.ts","../src/dll.service.ts","../src/duration-ms.vo.ts","../src/duration.service.ts","../src/email-mask.service.ts","../src/etags.vo.ts","../src/extension.vo.ts","../src/feature-flag-value.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-affix.vo.ts","../src/filename-from-string.vo.ts","../src/filename.vo.ts","../src/height-milimiters.vo.ts","../src/height.vo.ts","../src/hour-format.service.ts","../src/hour-schema.vo.ts","../src/hour.vo.ts","../src/iban-mask.service.ts","../src/iban-schema.vo.ts","../src/iban.vo.ts","../src/image.vo.ts","../src/index.ts","../src/language.vo.ts","../src/linear-regression.service.ts","../src/mean.service.ts","../src/mime-types.vo.ts","../src/mime-value.vo.ts","../src/mime.vo.ts","../src/min-max-scaler.service.ts","../src/minute-schema.vo.ts","../src/minute.vo.ts","../src/money-amount.vo.ts","../src/money.vo.ts","../src/month-iso-id.vo.ts","../src/month.vo.ts","../src/multiplication-factor.vo.ts","../src/noop.service.ts","../src/notification-template.vo.ts","../src/object-key.vo.ts","../src/outlier-detector.service.ts","../src/package-version-schema.vo.ts","../src/package-version.vo.ts","../src/pagination-page.vo.ts","../src/pagination-skip.vo.ts","../src/pagination-take.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-item-position-value.vo.ts","../src/reordering.service.ts","../src/revision-value.vo.ts","../src/revision.vo.ts","../src/rounding.adapter.ts","../src/rounding.port.ts","../src/size-bytes.vo.ts","../src/size.vo.ts","../src/slug.service.ts","../src/stopwatch.service.ts","../src/sum.service.ts","../src/thousands-separator.service.ts","../src/time-zone-offset-value.vo.ts","../src/timestamp-value.vo.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-grams.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/tools",
-  "version": "1.1.17",
+  "version": "1.1.20",
   "type": "module",
   "license": "MIT",
   "author": "Bartosz Gordon",
@@ -27,8 +27,8 @@
     "@types/bun": "1.3.4",
     "@types/mime-types": "3.0.1",
     "cspell": "9.4.0",
-    "knip": "5.73.0",
-    "lefthook": "2.0.9",
+    "knip": "5.73.4",
+    "lefthook": "2.0.11",
     "only-allow": "1.2.2",
     "shellcheck": "4.1.0",
     "typescript": "5.9.3",

package/readme.md

@@ -37,6 +37,8 @@ src/
 ├── day.vo.ts
 ├── directory-path-absolute.vo.ts
 ├── directory-path-relative.vo.ts
+├── distance-value.vo.ts
+├── distance.vo.ts
 ├── division-factor.vo.ts
 ├── dll.service.ts
 ├── duration-ms.vo.ts

package/src/age.vo.ts

@@ -14,6 +14,10 @@ export class Age {
     return new Age(AgeYears.parse(candidate));
   }
 
+  static fromValueSafe(candidate: AgeYearsType): Age {
+    return new Age(candidate);
+  }
+
   static fromBirthdateTimestamp(params: { birthdate: Timestamp; now: Timestamp }): Age {
     if (params.birthdate.isAfter(params.now)) throw new Error(AgeError.FutureBirthdate);
     return Age.fromValue(differenceInYears(params.now.ms, params.birthdate.ms));

package/src/distance-value.vo.ts

@@ -0,0 +1,11 @@
+import { z } from "zod/v4";
+
+export const DistanceValueError = { Type: "distance.value.type", Invalid: "distance.value.invalid" };
+
+export const DistanceValue = z
+  .number(DistanceValueError.Type)
+  .int(DistanceValueError.Type)
+  .min(0, DistanceValueError.Invalid)
+  .brand("DistanceValue");
+
+export type DistanceValueType = z.infer<typeof DistanceValue>;

package/src/distance.vo.ts

@@ -0,0 +1,72 @@
+import { DistanceValue, type DistanceValueType } from "./distance-value.vo";
+import { RoundToNearest } from "./rounding.adapter";
+import type { RoundingPort } from "./rounding.port";
+
+export const DistanceError = {
+  SubtractResultLessThanZero: "distance.subtract.result.less.than.zero",
+} as const;
+
+export class Distance {
+  private static readonly ZERO = DistanceValue.parse(0);
+
+  private constructor(private readonly value: DistanceValueType) {}
+
+  static fromMeters(candidate: number): Distance {
+    return new Distance(DistanceValue.parse(candidate));
+  }
+
+  static fromMetersSafe(candidate: DistanceValueType): Distance {
+    return new Distance(candidate);
+  }
+
+  static fromKilometers(candidate: number, rounding: RoundingPort = new RoundToNearest()): Distance {
+    return new Distance(DistanceValue.parse(rounding.round(candidate * 1000)));
+  }
+
+  static fromMiles(candidate: number, rounding: RoundingPort = new RoundToNearest()): Distance {
+    return new Distance(DistanceValue.parse(rounding.round(candidate * 1_609.344)));
+  }
+
+  get(): DistanceValueType {
+    return this.value;
+  }
+
+  add(distance: Distance): Distance {
+    return new Distance(DistanceValue.parse(this.value + distance.get()));
+  }
+
+  subtract(money: Distance): Distance {
+    const result = this.value - money.get();
+
+    if (result < Distance.ZERO) throw new Error(DistanceError.SubtractResultLessThanZero);
+    return new Distance(DistanceValue.parse(result));
+  }
+
+  equals(another: Distance): boolean {
+    return this.value === another.get();
+  }
+
+  isLongerThan(another: Distance): boolean {
+    return this.value > another.get();
+  }
+
+  isShorterThan(another: Distance): boolean {
+    return this.value < another.get();
+  }
+
+  isZero(): boolean {
+    return this.value === Distance.ZERO;
+  }
+
+  format(): string {
+    return this.value.toString();
+  }
+
+  toString(): string {
+    return this.format();
+  }
+
+  toJSON(): number {
+    return this.value;
+  }
+}

package/src/height-milimiters.vo.ts

@@ -10,3 +10,5 @@ export const HeightMillimeters = z
   .int(HeightMillimetersError.Type)
   .min(0, HeightMillimetersError.Invalid)
   .brand("HeightMillimeters");
+
+export type HeightMillimetersType = z.infer<typeof HeightMillimeters>;

package/src/height.vo.ts

@@ -1,24 +1,30 @@
-import { HeightMillimeters } from "./height-milimiters.vo";
+import { HeightMillimeters, type HeightMillimetersType } from "./height-milimiters.vo";
 import { RoundToDecimal, RoundToNearest } from "./rounding.adapter";
 import type { RoundingPort } from "./rounding.port";
 
 export class Height {
-  private static readonly MILLIMETERS_PER_CENTIMETER = 10;
+  private static readonly ZERO = HeightMillimeters.parse(0);
 
-  private constructor(private readonly millimeters: number) {}
+  private static readonly MILLIMETERS_PER_CENTIMETER = 10;
 
-  static fromCentimeters(centimeters: number, rounding: RoundingPort = new RoundToNearest()): Height {
-    const millimeters = rounding.round(centimeters * Height.MILLIMETERS_PER_CENTIMETER);
+  private constructor(private readonly millimeters: HeightMillimetersType) {}
 
+  static fromMillimeters(millimeters: number): Height {
     return new Height(HeightMillimeters.parse(millimeters));
   }
 
-  static fromMillimeters(millimeters: number): Height {
+  static fromMillimetersSafe(millimeters: HeightMillimetersType): Height {
+    return new Height(millimeters);
+  }
+
+  static fromCentimeters(centimeters: number, rounding: RoundingPort = new RoundToNearest()): Height {
+    const millimeters = rounding.round(centimeters * Height.MILLIMETERS_PER_CENTIMETER);
+
     return new Height(HeightMillimeters.parse(millimeters));
   }
 
   static zero(): Height {
-    return new Height(0);
+    return Height.fromMillimetersSafe(Height.ZERO);
   }
 
   get(): number {

package/src/hour.vo.ts

@@ -4,23 +4,32 @@ import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.vo";
 
 export class Hour {
-  private readonly value: HourSchemaType;
+  private constructor(private readonly value: HourSchemaType) {}
 
-  static readonly ZERO = new Hour(0);
-  static readonly MAX = new Hour(23);
+  static fromValue(candidate: number): Hour {
+    return new Hour(HourSchema.parse(candidate));
+  }
 
-  constructor(candidate: number) {
-    this.value = HourSchema.parse(candidate);
+  static fromValueSafe(candidate: HourSchemaType) {
+    return new Hour(candidate);
   }
 
   static fromTimestamp(timestamp: Timestamp): Hour {
-    return new Hour(new Date(timestamp.ms).getUTCHours());
+    return new Hour(HourSchema.parse(new Date(timestamp.ms).getUTCHours()));
   }
 
   static fromTimestampValue(timestamp: TimestampValueType): Hour {
     return Hour.fromTimestamp(Timestamp.fromValue(timestamp));
   }
 
+  static zero(): Hour {
+    return Hour.fromValue(0);
+  }
+
+  static max(): Hour {
+    return Hour.fromValue(23);
+  }
+
   get(): HourSchemaType {
     return this.value;
   }
@@ -42,7 +51,7 @@ export class Hour {
   }
 
   static list(): readonly Hour[] {
-    return Array.from({ length: 24 }, (_, index) => new Hour(index));
+    return Array.from({ length: 24 }, (_, index) => Hour.fromValue(index));
   }
 
   toString(): string {

package/src/index.ts

@@ -11,6 +11,8 @@ export * from "./day.vo";
 export * from "./day-iso-id.vo";
 export * from "./directory-path-absolute.vo";
 export * from "./directory-path-relative.vo";
+export * from "./distance.vo";
+export * from "./distance-value.vo";
 export * from "./division-factor.vo";
 export * from "./dll.service";
 export * from "./duration.service";

package/src/minute.vo.ts

@@ -3,23 +3,32 @@ import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.vo";
 
 export class Minute {
-  private readonly value: MinuteSchemaType;
+  private constructor(private readonly value: MinuteSchemaType) {}
 
-  static readonly ZERO = new Minute(0);
-  static readonly MAX = new Minute(59);
+  static fromValue(candidate: number): Minute {
+    return new Minute(MinuteSchema.parse(candidate));
+  }
 
-  constructor(candidate: number) {
-    this.value = MinuteSchema.parse(candidate);
+  static fromValueSafe(candidate: MinuteSchemaType) {
+    return new Minute(candidate);
   }
 
   static fromTimestamp(timestamp: Timestamp): Minute {
-    return new Minute(new Date(timestamp.ms).getUTCMinutes());
+    return new Minute(MinuteSchema.parse(new Date(timestamp.ms).getUTCMinutes()));
   }
 
   static fromTimestampValue(timestamp: TimestampValueType): Minute {
     return Minute.fromTimestamp(Timestamp.fromValue(timestamp));
   }
 
+  static zero(): Minute {
+    return Minute.fromValue(0);
+  }
+
+  static max(): Minute {
+    return Minute.fromValue(59);
+  }
+
   get(): MinuteSchemaType {
     return this.value;
   }
@@ -37,7 +46,7 @@ export class Minute {
   }
 
   static list(): readonly Minute[] {
-    return Array.from({ length: 60 }, (_, index) => new Minute(index));
+    return Array.from({ length: 60 }, (_, index) => Minute.fromValue(index));
   }
 
   toString(): string {

package/src/money.vo.ts

@@ -7,15 +7,23 @@ import type { RoundingPort } from "./rounding.port";
 export const MoneyError = { SubtractResultLessThanZero: "money.subtract.result.less.than.zero" } as const;
 
 export class Money {
-  private static readonly ZERO = 0;
-  private static readonly DEFAULT_ROUNDING: RoundingPort = new RoundToNearest();
+  private static readonly ZERO = MoneyAmount.parse(0);
 
-  private readonly amount: MoneyAmountType;
-  private readonly rounding: RoundingPort;
+  private constructor(
+    private readonly amount: MoneyAmountType,
+    private readonly rounding: RoundingPort = new RoundToNearest(),
+  ) {}
 
-  constructor(value: number = Money.ZERO, rounding?: RoundingPort) {
-    this.amount = MoneyAmount.parse(value);
-    this.rounding = rounding ?? Money.DEFAULT_ROUNDING;
+  static fromAmount(candidate: number, rounding?: RoundingPort): Money {
+    return new Money(MoneyAmount.parse(candidate), rounding);
+  }
+
+  static fromAmountSafe(candidate: MoneyAmountType, rounding?: RoundingPort): Money {
+    return new Money(candidate, rounding);
+  }
+
+  static zero(): Money {
+    return Money.fromAmount(0);
   }
 
   getAmount(): MoneyAmountType {
@@ -23,28 +31,22 @@ export class Money {
   }
 
   add(money: Money): Money {
-    const result = this.amount + money.getAmount();
-
-    return new Money(MoneyAmount.parse(result), this.rounding);
+    return new Money(MoneyAmount.parse(this.amount + money.getAmount()), this.rounding);
   }
 
   multiply(factor: MultiplicationFactorType): Money {
-    const result = this.rounding.round(this.amount * factor);
-
-    return new Money(MoneyAmount.parse(result), this.rounding);
+    return new Money(MoneyAmount.parse(this.rounding.round(this.amount * factor)), this.rounding);
   }
 
   subtract(money: Money): Money {
     const result = this.amount - money.getAmount();
 
     if (result < Money.ZERO) throw new Error(MoneyError.SubtractResultLessThanZero);
-    return new Money(MoneyAmount.parse(result), this.rounding);
+    return new Money(MoneyAmount.parse(this.rounding.round(result)), this.rounding);
   }
 
   divide(factor: DivisionFactorType): Money {
-    const result = this.rounding.round(this.amount / factor);
-
-    return new Money(MoneyAmount.parse(result), this.rounding);
+    return new Money(MoneyAmount.parse(this.rounding.round(this.amount / factor)), this.rounding);
   }
 
   equals(another: Money): boolean {

package/src/package-version.vo.ts

@@ -1,4 +1,4 @@
-import { PackageVersionSchema } from "./package-version-schema.vo";
+import { PackageVersionSchema, type PackageVersionSchemaType } from "./package-version-schema.vo";
 
 export class PackageVersion {
   constructor(
@@ -7,12 +7,16 @@ export class PackageVersion {
     private readonly patch: number,
   ) {}
 
-  static fromStringWithV(candidate: string): PackageVersion {
+  static fromVersionString(candidate: string): PackageVersion {
     const version = PackageVersionSchema.parse(candidate);
 
     return new PackageVersion(version.major, version.minor, version.patch);
   }
 
+  static fromVersionStringSafe(candidate: PackageVersionSchemaType): PackageVersion {
+    return new PackageVersion(candidate.major, candidate.minor, candidate.patch);
+  }
+
   static fromString(candidate: string): PackageVersion {
     const version = PackageVersionSchema.parse(`v${candidate}`);
 

package/src/size.vo.ts

@@ -21,7 +21,7 @@ export class Size {
   private static readonly CONVERT_ROUND = new RoundUp();
   private static readonly FORMAT_ROUND = new RoundToDecimal(2);
 
-  constructor(config: SizeConfigType) {
+  private constructor(config: SizeConfigType) {
     this.unit = config.unit;
     this.bytes = this.calculateBytes(config.value, config.unit);
   }