@bgord/tools 1.3.14 → 1.3.16

package/dist/age-years.vo.js

@@ -1,11 +1,11 @@
 import * as z from "zod/v4";
 export const AgeYearsError = { Type: "age.years.type", Invalid: "age.years.invalid" };
-export const AgeYearsConstraints = { min: 1, max: 130 };
+export const AgeYearsConstraints = { min: 0, max: 130 };
 // Stryker disable all
 export const AgeYears = z
     // Stryker restore all
     .number(AgeYearsError.Type)
     .int(AgeYearsError.Type)
-    .min(1, AgeYearsError.Invalid)
+    .min(0, AgeYearsError.Invalid)
     .max(130, AgeYearsError.Invalid)
     .brand("AgeYears");

package/dist/age.vo.d.ts

@@ -18,7 +18,7 @@ export declare class Age {
         birthdate: string;
         now: Timestamp;
     }): Age;
-    get(): number;
+    get(): AgeYearsType;
     equals(other: Age): boolean;
     isOlderThan(other: Age): boolean;
     isYoungerThan(other: Age): boolean;

package/dist/age.vo.js

@@ -21,7 +21,7 @@ export class Age {
         return Age.fromValue(differenceInYears(params.now.ms, params.birthdate.ms));
     }
     static fromBirthdate(candidate) {
-        const birthdate = Timestamp.fromNumber(new Date(candidate.birthdate).getTime());
+        const birthdate = Timestamp.fromDateLike(candidate.birthdate);
         if (birthdate.isAfter(candidate.now))
             throw new Error(AgeError.FutureBirthdate);
         return Age.fromValue(differenceInYears(candidate.now.ms, birthdate.ms));

package/dist/date-range.vo.d.ts

@@ -1,3 +1,4 @@
+import type { Duration } from "./duration.service";
 import type { Timestamp } from "./timestamp.vo";
 export declare const DateRangeError: {
     Invalid: string;
@@ -8,7 +9,8 @@ export declare class DateRange {
     constructor(start: Timestamp, end: Timestamp);
     getStart(): Timestamp;
     getEnd(): Timestamp;
-    toRange(): [Timestamp, Timestamp];
+    get(): [Timestamp, Timestamp];
+    getDuration(): Duration;
     contains(timestamp: Timestamp): boolean;
     equals(other: DateRange): boolean;
     toString(): string;

package/dist/date-range.vo.js

@@ -14,9 +14,12 @@ export class DateRange {
     getEnd() {
         return this.end;
     }
-    toRange() {
+    get() {
         return [this.start, this.end];
     }
+    getDuration() {
+        return this.end.difference(this.start);
+    }
     contains(timestamp) {
         return timestamp.isAfterOrEqual(this.start) && timestamp.isBeforeOrEqual(this.end);
     }

package/dist/day.vo.d.ts

@@ -9,8 +9,8 @@ export declare class Day extends DateRange {
     static fromNow(now: Timestamp): Day;
     static fromIsoId(isoId: DayIsoIdType): Day;
     toIsoId(): DayIsoIdType;
-    previous(): Day;
     next(): Day;
+    previous(): Day;
     shift(count: IntegerType): Day;
     toString(): string;
 }

package/dist/day.vo.js

@@ -27,12 +27,12 @@ export class Day extends DateRange {
         const midday = this.getStart().add(Duration.Hours(12));
         return DayIsoId.parse(formatISO(midday.ms, { representation: "date" }));
     }
-    previous() {
-        return this.shift(Integer.parse(-1));
-    }
     next() {
         return this.shift(Integer.parse(1));
     }
+    previous() {
+        return this.shift(Integer.parse(-1));
+    }
     shift(count) {
         return Day.fromTimestamp(this.getStart().add(Duration.Days(count)));
     }

package/dist/distance.vo.d.ts

@@ -13,12 +13,11 @@ export declare class Distance {
     static fromMiles(candidate: number, rounding?: RoundingStrategy): Distance;
     get(): DistanceValueType;
     add(distance: Distance): Distance;
-    subtract(money: Distance): Distance;
+    subtract(distance: 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

@@ -25,8 +25,8 @@ export class Distance {
     add(distance) {
         return new Distance(DistanceValue.parse(this.value + distance.get()));
     }
-    subtract(money) {
-        const result = this.value - money.get();
+    subtract(distance) {
+        const result = this.value - distance.get();
         if (result < Distance.ZERO)
             throw new Error(DistanceError.SubtractResultLessThanZero);
         return new Distance(DistanceValue.parse(result));
@@ -43,11 +43,8 @@ export class Distance {
     isZero() {
         return this.value === Distance.ZERO;
     }
-    format() {
-        return this.value.toString();
-    }
     toString() {
-        return this.format();
+        return this.value.toString();
     }
     toJSON() {
         return this.value;

package/dist/duration.service.js

@@ -72,8 +72,7 @@ export class Duration {
         return Duration.Ms(this.internal - another.internal);
     }
     times(factor) {
-        const rounding = new RoundingToNearestStrategy();
-        return Duration.Ms(rounding.round(this.internal * factor));
+        return Duration.Ms(new RoundingToNearestStrategy().round(this.internal * factor));
     }
     toAbsolute() {
         return Duration.Ms(Math.abs(this.internal));

package/dist/height.vo.d.ts

@@ -11,8 +11,7 @@ export declare class Height {
     static zero(): Height;
     get(): number;
     toMillimeters(): number;
-    toCentimeters(rounding?: RoundingStrategy): number;
-    format(rounding?: RoundingStrategy): string;
+    toCentimeters(): number;
     toString(): string;
     equals(another: Height): boolean;
     greaterThan(another: Height): boolean;

package/dist/height.vo.js

@@ -1,5 +1,4 @@
 import { HeightMillimeters } from "./height-milimiters.vo";
-import { RoundingDecimalStrategy } from "./rounding-decimal.strategy";
 import { RoundingToNearestStrategy } from "./rounding-to-nearest.strategy";
 export class Height {
     millimeters;
@@ -27,19 +26,11 @@ export class Height {
     toMillimeters() {
         return this.millimeters;
     }
-    toCentimeters(rounding) {
-        const centimeters = this.millimeters / Height.MILLIMETERS_PER_CENTIMETER;
-        if (rounding)
-            return rounding.round(centimeters);
-        return centimeters;
-    }
-    format(rounding) {
-        const chosen = rounding ?? new RoundingDecimalStrategy(1);
-        const value = this.toCentimeters(chosen);
-        return `${value} cm`;
+    toCentimeters() {
+        return this.millimeters / Height.MILLIMETERS_PER_CENTIMETER;
     }
     toString() {
-        return this.format(new RoundingDecimalStrategy(1));
+        return this.millimeters.toString();
     }
     equals(another) {
         return this.millimeters === another.millimeters;

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

@@ -0,0 +1,7 @@
+import * as z from "zod/v4";
+export declare const HourValueError: {
+    Type: string;
+    Invalid: string;
+};
+export declare const HourValue: z.core.$ZodBranded<z.ZodNumber, "HourSchema", "out">;
+export type HourValueType = z.infer<typeof HourValue>;

package/dist/hour-value.vo.js

@@ -0,0 +1,10 @@
+import * as z from "zod/v4";
+export const HourValueError = { Type: "hour.value.type", Invalid: "hour.value.invalid" };
+// Stryker disable all
+export const HourValue = z
+    // Stryker restore all
+    .number(HourValueError.Type)
+    .int(HourValueError.Type)
+    .gte(0, HourValueError.Invalid)
+    .lte(23, HourValueError.Invalid)
+    .brand("HourSchema");

package/dist/hour.vo.d.ts

@@ -1,18 +1,16 @@
-import { type HourFormatter } from "./hour-format.service";
-import { type HourSchemaType } from "./hour-schema.vo";
+import { type HourValueType } from "./hour-value.vo";
 import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.vo";
 export declare class Hour {
     private readonly value;
     private constructor();
     static fromValue(candidate: number): Hour;
-    static fromValueSafe(candidate: HourSchemaType): Hour;
+    static fromValueSafe(candidate: HourValueType): Hour;
     static fromTimestamp(timestamp: Timestamp): Hour;
     static fromTimestampValue(timestamp: TimestampValueType): Hour;
     static zero(): Hour;
     static max(): Hour;
-    get(): HourSchemaType;
-    format(formatter: HourFormatter): string;
+    get(): HourValueType;
     equals(another: Hour): boolean;
     isAfter(another: Hour): boolean;
     isBefore(another: Hour): boolean;

package/dist/hour.vo.js

@@ -1,5 +1,4 @@
-import { HourFormatters } from "./hour-format.service";
-import { HourSchema } from "./hour-schema.vo";
+import { HourValue } from "./hour-value.vo";
 import { Timestamp } from "./timestamp.vo";
 export class Hour {
     value;
@@ -7,13 +6,13 @@ export class Hour {
         this.value = value;
     }
     static fromValue(candidate) {
-        return new Hour(HourSchema.parse(candidate));
+        return new Hour(HourValue.parse(candidate));
     }
     static fromValueSafe(candidate) {
         return new Hour(candidate);
     }
     static fromTimestamp(timestamp) {
-        return new Hour(HourSchema.parse(new Date(timestamp.ms).getUTCHours()));
+        return new Hour(HourValue.parse(new Date(timestamp.ms).getUTCHours()));
     }
     static fromTimestampValue(timestamp) {
         return Hour.fromTimestamp(Timestamp.fromValue(timestamp));
@@ -27,9 +26,6 @@ export class Hour {
     get() {
         return this.value;
     }
-    format(formatter) {
-        return formatter(this.value);
-    }
     equals(another) {
         return this.value === another.value;
     }
@@ -43,7 +39,7 @@ export class Hour {
         return Array.from({ length: 24 }, (_, index) => Hour.fromValue(index));
     }
     toString() {
-        return HourFormatters.TWENTY_FOUR_HOURS(this.value);
+        return this.value.toString();
     }
     toJSON() {
         return this.value;

package/dist/index.d.ts

@@ -30,8 +30,7 @@ export * from "./filename-from-string.vo";
 export * from "./height.vo";
 export * from "./height-milimiters.vo";
 export * from "./hour.vo";
-export * from "./hour-format.service";
-export * from "./hour-schema.vo";
+export * from "./hour-value.vo";
 export * from "./iban.vo";
 export * from "./iban-mask.service";
 export * from "./iban-schema.vo";
@@ -50,7 +49,7 @@ export * from "./mime-value.vo";
 export * from "./mimes";
 export * from "./min-max-scaler.service";
 export * from "./minute.vo";
-export * from "./minute-schema.vo";
+export * from "./minute-value.vo";
 export * from "./money.vo";
 export * from "./money-amount.vo";
 export * from "./month.vo";

package/dist/index.js

@@ -30,8 +30,7 @@ export * from "./filename-from-string.vo";
 export * from "./height.vo";
 export * from "./height-milimiters.vo";
 export * from "./hour.vo";
-export * from "./hour-format.service";
-export * from "./hour-schema.vo";
+export * from "./hour-value.vo";
 export * from "./iban.vo";
 export * from "./iban-mask.service";
 export * from "./iban-schema.vo";
@@ -50,7 +49,7 @@ export * from "./mime-value.vo";
 export * from "./mimes";
 export * from "./min-max-scaler.service";
 export * from "./minute.vo";
-export * from "./minute-schema.vo";
+export * from "./minute-value.vo";
 export * from "./money.vo";
 export * from "./money-amount.vo";
 export * from "./month.vo";

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

@@ -3,7 +3,4 @@ export declare const MimeValueError: {
     Type: string;
     Invalid: string;
 };
-export declare const MimeValue: z.core.$ZodBranded<z.ZodPipe<z.ZodString, z.ZodTransform<{
-    type: string;
-    subtype: string;
-}, string>>, "MimeValue", "out">;
+export declare const MimeValue: z.core.$ZodBranded<z.ZodString, "MimeValue", "out">;

package/dist/mime-value.vo.js

@@ -7,5 +7,4 @@ export const MimeValue = z
     // Stryker restore all
     .string(MimeValueError.Type)
     .regex(MIME_VALUE_CHARS_WHITELIST, MimeValueError.Invalid)
-    .transform((value) => ({ type: value.split("/")[0], subtype: value.split("/")[1] }))
     .brand("MimeValue");

package/dist/mime.vo.d.ts

@@ -1,6 +1,3 @@
-export declare const MimeError: {
-    NotAccepted: string;
-};
 export declare class Mime {
     readonly type: string;
     readonly subtype: string;

package/dist/mime.vo.js

@@ -1,5 +1,4 @@
 import { MimeValue } from "./mime-value.vo";
-export const MimeError = { NotAccepted: "mime.not.accepted" };
 export class Mime {
     type;
     subtype;
@@ -8,7 +7,8 @@ export class Mime {
         this.subtype = subtype;
     }
     static fromString(candidate) {
-        const { type, subtype } = MimeValue.parse(candidate.split(";")[0].trim());
+        const value = MimeValue.parse(candidate.split(";")[0].trim());
+        const [type, subtype] = value.split("/");
         return new Mime(type, subtype);
     }
     isSatisfiedBy(another) {

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

@@ -0,0 +1,7 @@
+import * as z from "zod/v4";
+export declare const MinuteValueError: {
+    Type: string;
+    Invalid: string;
+};
+export declare const MinuteValue: z.core.$ZodBranded<z.ZodNumber, "MinuteValue", "out">;
+export type MinuteValueType = z.infer<typeof MinuteValue>;

package/dist/minute-value.vo.js

@@ -0,0 +1,10 @@
+import * as z from "zod/v4";
+export const MinuteValueError = { Type: "minute.value.type", Invalid: "minute.value.invalid" };
+// Stryker disable all
+export const MinuteValue = z
+    // Stryker restore all
+    .number(MinuteValueError.Type)
+    .int(MinuteValueError.Type)
+    .gte(0, MinuteValueError.Invalid)
+    .lte(59, MinuteValueError.Invalid)
+    .brand("MinuteValue");

package/dist/minute.vo.d.ts

@@ -1,16 +1,16 @@
-import { type MinuteSchemaType } from "./minute-schema.vo";
+import { type MinuteValueType } from "./minute-value.vo";
 import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.vo";
 export declare class Minute {
     private readonly value;
     private constructor();
     static fromValue(candidate: number): Minute;
-    static fromValueSafe(candidate: MinuteSchemaType): Minute;
+    static fromValueSafe(candidate: MinuteValueType): Minute;
     static fromTimestamp(timestamp: Timestamp): Minute;
     static fromTimestampValue(timestamp: TimestampValueType): Minute;
     static zero(): Minute;
     static max(): Minute;
-    get(): MinuteSchemaType;
+    get(): MinuteValueType;
     equals(another: Minute): boolean;
     isBefore(another: Minute): boolean;
     isAfter(another: Minute): boolean;

package/dist/minute.vo.js

@@ -1,4 +1,4 @@
-import { MinuteSchema } from "./minute-schema.vo";
+import { MinuteValue } from "./minute-value.vo";
 import { Timestamp } from "./timestamp.vo";
 export class Minute {
     value;
@@ -6,13 +6,13 @@ export class Minute {
         this.value = value;
     }
     static fromValue(candidate) {
-        return new Minute(MinuteSchema.parse(candidate));
+        return new Minute(MinuteValue.parse(candidate));
     }
     static fromValueSafe(candidate) {
         return new Minute(candidate);
     }
     static fromTimestamp(timestamp) {
-        return new Minute(MinuteSchema.parse(new Date(timestamp.ms).getUTCMinutes()));
+        return new Minute(MinuteValue.parse(new Date(timestamp.ms).getUTCMinutes()));
     }
     static fromTimestampValue(timestamp) {
         return Minute.fromTimestamp(Timestamp.fromValue(timestamp));

package/dist/money.vo.d.ts

@@ -7,22 +7,20 @@ export declare const MoneyError: {
 };
 export declare class Money {
     private readonly amount;
-    private readonly rounding;
     private static readonly ZERO;
     private constructor();
-    static fromAmount(candidate: number, rounding?: RoundingStrategy): Money;
-    static fromAmountSafe(candidate: MoneyAmountType, rounding?: RoundingStrategy): Money;
+    static fromAmount(candidate: number): Money;
+    static fromAmountSafe(candidate: MoneyAmountType): Money;
     static zero(): Money;
     getAmount(): MoneyAmountType;
     add(money: Money): Money;
-    multiply(factor: MultiplicationFactorType): Money;
+    multiply(factor: MultiplicationFactorType, rounding?: RoundingStrategy): Money;
     subtract(money: Money): Money;
-    divide(factor: DivisionFactorType): Money;
+    divide(factor: DivisionFactorType, rounding?: RoundingStrategy): Money;
     equals(another: Money): boolean;
     isGreaterThan(another: Money): boolean;
     isLessThan(another: Money): boolean;
     isZero(): boolean;
-    format(): string;
     toString(): string;
     toJSON(): number;
 }

package/dist/money.vo.js

@@ -1,20 +1,17 @@
 import { MoneyAmount } from "./money-amount.vo";
-import { RoundingDownStrategy } from "./rounding-down.strategy";
 import { RoundingToNearestStrategy } from "./rounding-to-nearest.strategy";
 export const MoneyError = { SubtractResultLessThanZero: "money.subtract.result.less.than.zero" };
 export class Money {
     amount;
-    rounding;
     static ZERO = MoneyAmount.parse(0);
-    constructor(amount, rounding = new RoundingToNearestStrategy()) {
+    constructor(amount) {
         this.amount = amount;
-        this.rounding = rounding;
     }
-    static fromAmount(candidate, rounding) {
-        return new Money(MoneyAmount.parse(candidate), rounding);
+    static fromAmount(candidate) {
+        return new Money(MoneyAmount.parse(candidate));
     }
-    static fromAmountSafe(candidate, rounding) {
-        return new Money(candidate, rounding);
+    static fromAmountSafe(candidate) {
+        return new Money(candidate);
     }
     static zero() {
         return Money.fromAmount(0);
@@ -23,19 +20,19 @@ export class Money {
         return this.amount;
     }
     add(money) {
-        return new Money(MoneyAmount.parse(this.amount + money.getAmount()), this.rounding);
+        return new Money(MoneyAmount.parse(this.amount + money.getAmount()));
     }
-    multiply(factor) {
-        return new Money(MoneyAmount.parse(this.rounding.round(this.amount * factor)), this.rounding);
+    multiply(factor, rounding = new RoundingToNearestStrategy()) {
+        return new Money(MoneyAmount.parse(rounding.round(this.amount * factor)));
     }
     subtract(money) {
         const result = this.amount - money.getAmount();
         if (result < Money.ZERO)
             throw new Error(MoneyError.SubtractResultLessThanZero);
-        return new Money(MoneyAmount.parse(this.rounding.round(result)), this.rounding);
+        return new Money(MoneyAmount.parse(result));
     }
-    divide(factor) {
-        return new Money(MoneyAmount.parse(this.rounding.round(this.amount / factor)), this.rounding);
+    divide(factor, rounding = new RoundingToNearestStrategy()) {
+        return new Money(MoneyAmount.parse(rounding.round(this.amount / factor)));
     }
     equals(another) {
         return this.amount === another.getAmount();
@@ -49,13 +46,8 @@ export class Money {
     isZero() {
         return this.amount === Money.ZERO;
     }
-    format() {
-        const whole = new RoundingDownStrategy().round(this.amount / 100);
-        const fraction = this.amount % 100;
-        return `${whole}.${fraction.toString().padStart(2, "0")}`;
-    }
     toString() {
-        return this.format();
+        return this.amount.toString();
     }
     toJSON() {
         return this.amount;

package/dist/month.vo.js

@@ -1,4 +1,4 @@
-import { endOfMonth, format, getMonth, setMonth, startOfMonth } from "date-fns";
+import { endOfMonth, format, startOfMonth } from "date-fns";
 import { DateRange } from "./date-range.vo";
 import { Integer } from "./integer.vo";
 import { MonthIsoId } from "./month-iso-id.vo";
@@ -17,8 +17,8 @@ export class Month extends DateRange {
     }
     static fromIsoId(iso) {
         const [year, month] = MonthIsoId.parse(iso).split("-").map(Number);
-        const reference = setMonth(Date.UTC(year), month - 1).getTime();
-        return Month.fromTimestamp(Timestamp.fromNumber(reference));
+        const reference = Timestamp.fromNumber(Date.UTC(year, month - 1, 1));
+        return Month.fromTimestamp(reference);
     }
     toIsoId() {
         return MonthIsoId.parse(format(this.getStart().ms, "yyyy-MM"));
@@ -30,8 +30,8 @@ export class Month extends DateRange {
         return this.shift(Integer.parse(1));
     }
     shift(count) {
-        const shifted = setMonth(this.getStart().ms, getMonth(this.getStart().ms) + count).getTime();
-        return Month.fromTimestamp(Timestamp.fromNumber(shifted));
+        const start = new Date(this.getStart().ms);
+        return Month.fromTimestamp(Timestamp.fromNumber(Date.UTC(start.getUTCFullYear(), start.getUTCMonth() + count, 1)));
     }
     toString() {
         return this.toIsoId();

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

@@ -3,9 +3,6 @@ export declare const PackageVersionSchemaError: {
     Type: string;
     BadChars: string;
 };
-export declare const PackageVersionSchema: z.core.$ZodBranded<z.ZodPipe<z.ZodString, z.ZodTransform<{
-    major: number;
-    minor: number;
-    patch: number;
-}, string>>, "PackageVersionSchema", "out">;
+export declare const PACKAGE_VERSIONS_CHARS_WHITELIST: RegExp;
+export declare const PackageVersionSchema: z.core.$ZodBranded<z.ZodString, "PackageVersionSchema", "out">;
 export type PackageVersionSchemaType = z.infer<typeof PackageVersionSchema>;

package/dist/package-version-schema.vo.js

@@ -4,14 +4,10 @@ export const PackageVersionSchemaError = {
     BadChars: "package.version.schema.bad.chars",
 };
 // v, 1-4 digits, dot, 1-4 digits, dot, 1-4 digits - () for capturing groups
-const PACKAGE_VERSIONS_CHARS_WHITELIST = /^v([0-9]{1,4})\.([0-9]{1,4})\.([0-9]{1,4})$/;
+export const PACKAGE_VERSIONS_CHARS_WHITELIST = /^v([0-9]{1,4})\.([0-9]{1,4})\.([0-9]{1,4})$/;
 // Stryker disable all
 export const PackageVersionSchema = z
     // Stryker restore all
     .string(PackageVersionSchemaError.Type)
     .regex(PACKAGE_VERSIONS_CHARS_WHITELIST, PackageVersionSchemaError.BadChars)
-    .transform((value) => {
-    const match = PACKAGE_VERSIONS_CHARS_WHITELIST.exec(value);
-    return { major: Number(match[1]), minor: Number(match[2]), patch: Number(match[3]) };
-})
     .brand("PackageVersionSchema");

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

@@ -3,7 +3,7 @@ export declare class PackageVersion {
     private readonly major;
     private readonly minor;
     private readonly patch;
-    constructor(major: number, minor: number, patch: number);
+    private constructor();
     static fromVersionString(candidate: string): PackageVersion;
     static fromVersionStringSafe(candidate: PackageVersionSchemaType): PackageVersion;
     static fromString(candidate: string): PackageVersion;

package/dist/package-version.vo.js

@@ -1,4 +1,4 @@
-import { PackageVersionSchema } from "./package-version-schema.vo";
+import { PACKAGE_VERSIONS_CHARS_WHITELIST, PackageVersionSchema, } from "./package-version-schema.vo";
 export class PackageVersion {
     major;
     minor;
@@ -10,14 +10,15 @@ export class PackageVersion {
     }
     static fromVersionString(candidate) {
         const version = PackageVersionSchema.parse(candidate);
-        return new PackageVersion(version.major, version.minor, version.patch);
+        return PackageVersion.fromVersionStringSafe(version);
     }
     static fromVersionStringSafe(candidate) {
-        return new PackageVersion(candidate.major, candidate.minor, candidate.patch);
+        const [, major, minor, patch] = PACKAGE_VERSIONS_CHARS_WHITELIST.exec(candidate).map(Number);
+        return new PackageVersion(major, minor, patch);
     }
     static fromString(candidate) {
         const version = PackageVersionSchema.parse(`v${candidate}`);
-        return new PackageVersion(version.major, version.minor, version.patch);
+        return PackageVersion.fromVersionStringSafe(version);
     }
     compareTo(another) {
         if (this.major > another.major)

package/dist/quarter.vo.js

@@ -1,4 +1,4 @@
-import { endOfQuarter, getQuarter, getYear, setQuarter, startOfQuarter } from "date-fns";
+import { endOfQuarter, getQuarter, getYear, startOfQuarter } from "date-fns";
 import { DateRange } from "./date-range.vo";
 import { QuarterIsoId } from "./quarter-iso-id.vo";
 import { Timestamp } from "./timestamp.vo";
@@ -16,8 +16,7 @@ export class Quarter extends DateRange {
     }
     static fromIsoId(isoId) {
         const [year, quarter] = QuarterIsoId.parse(isoId).split("-Q").map(Number);
-        const reference = setQuarter(Date.UTC(year), quarter).getTime();
-        return Quarter.fromTimestamp(Timestamp.fromNumber(reference));
+        return Quarter.fromTimestamp(Timestamp.fromNumber(Date.UTC(year, (quarter - 1) * 3, 1)));
     }
     toIsoId() {
         const year = getYear(this.getStart().ms);

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/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/email.vo.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/integer-non-negative.vo.ts","../src/integer-positive.vo.ts","../src/integer.vo.ts","../src/language.vo.ts","../src/linear-regression.service.ts","../src/mean.service.ts","../src/mime-registry-entry.vo.ts","../src/mime-registry.service.ts","../src/mime-value.vo.ts","../src/mime.vo.ts","../src/mimes.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/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-decimal.strategy.ts","../src/rounding-down.strategy.ts","../src/rounding-to-nearest.strategy.ts","../src/rounding-up.strategy.ts","../src/rounding.strategy.ts","../src/size-bytes.vo.ts","../src/size.vo.ts","../src/slug.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/url-with-slash.vo.ts","../src/url-without-slash.vo.ts","../src/visually-unambiguous-characters-generator.service.ts","../src/week-iso-id.vo.ts","../src/week.vo.ts","../src/weekday-iso-id.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/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/email.vo.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-value.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/integer-non-negative.vo.ts","../src/integer-positive.vo.ts","../src/integer.vo.ts","../src/language.vo.ts","../src/linear-regression.service.ts","../src/mean.service.ts","../src/mime-registry-entry.vo.ts","../src/mime-registry.service.ts","../src/mime-value.vo.ts","../src/mime.vo.ts","../src/mimes.ts","../src/min-max-scaler.service.ts","../src/minute-value.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/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-decimal.strategy.ts","../src/rounding-down.strategy.ts","../src/rounding-to-nearest.strategy.ts","../src/rounding-up.strategy.ts","../src/rounding.strategy.ts","../src/size-bytes.vo.ts","../src/size.vo.ts","../src/slug.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/url-with-slash.vo.ts","../src/url-without-slash.vo.ts","../src/visually-unambiguous-characters-generator.service.ts","../src/week-iso-id.vo.ts","../src/week.vo.ts","../src/weekday-iso-id.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/dist/week.vo.js

@@ -1,5 +1,6 @@
-import { addWeeks, endOfISOWeek, getISOWeek, getISOWeekYear, setISOWeek, startOfISOWeek } from "date-fns";
+import { addWeeks, endOfISOWeek, getISOWeek, getISOWeekYear, startOfISOWeek } from "date-fns";
 import { DateRange } from "./date-range.vo";
+import { Duration } from "./duration.service";
 import { Integer } from "./integer.vo";
 import { Timestamp } from "./timestamp.vo";
 import { WeekIsoId } from "./week-iso-id.vo";
@@ -18,8 +19,9 @@ export class Week extends DateRange {
     static fromIsoId(isoId) {
         const [year, week] = WeekIsoId.parse(isoId).split("-W").map(Number);
         // ISO-8601 rule: Jan 4 is always in week 01 of the ISO week-year.
-        const reference = setISOWeek(Date.UTC(year, 0, 4), week).getTime();
-        return Week.fromTimestamp(Timestamp.fromNumber(reference));
+        const januaryFourth = Timestamp.fromNumber(Date.UTC(year, 0, 4));
+        const firstWeekStart = Timestamp.fromNumber(startOfISOWeek(januaryFourth.ms).getTime());
+        return Week.fromTimestamp(firstWeekStart.add(Duration.Weeks(week - 1)));
     }
     toIsoId() {
         const year = getISOWeekYear(this.getStart().ms);

package/dist/weekday-iso-id.vo.js

@@ -5,6 +5,6 @@ export const WeekdayIsoId = z
     // Stryker restore all
     .number(WeekdayIsoIdError.Type)
     .int(WeekdayIsoIdError.Type)
-    .min(0, WeekdayIsoIdError.Invalid)
-    .max(6, WeekdayIsoIdError.Invalid)
+    .min(1, WeekdayIsoIdError.Invalid)
+    .max(7, WeekdayIsoIdError.Invalid)
     .brand("WeekdayIsoId");

package/dist/weekday.vo.d.ts

@@ -1,35 +1,21 @@
 import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.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 WeekdayValueError: {
-    Invalid: string;
-};
-export declare const WeekdayFormatters: Record<WeekdayFormatterEnum, WeekdayFormatter>;
+import { type WeekdayIsoIdType } from "./weekday-iso-id.vo";
 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 fromTimestamp(timestamp: Timestamp, formatter?: WeekdayFormatter): Weekday;
+    static readonly SUNDAY: Weekday;
+    private constructor();
+    static fromTimestamp(timestamp: Timestamp): Weekday;
     static fromTimestampValue(timestamp: TimestampValueType): Weekday;
-    get(): number;
-    format(): string;
-    toString(): string;
+    static fromIsoId(iso: WeekdayIsoIdType): Weekday;
+    get(): WeekdayIsoIdType;
     equals(another: Weekday): boolean;
-    /** ISO-8601 weekday number: Monday=1 ... Sunday=7 */
-    toIsoNumber(): number;
     isMonday(): boolean;
     isTuesday(): boolean;
     isWednesday(): boolean;
@@ -37,6 +23,6 @@ export declare class Weekday {
     isFriday(): boolean;
     isSaturday(): boolean;
     isSunday(): boolean;
-    static list(formatter?: WeekdayFormatter): ReadonlyArray<Weekday>;
-    static listMondayFirst(formatter?: WeekdayFormatter): ReadonlyArray<Weekday>;
+    toJSON(): number;
+    toString(): string;
 }

package/dist/weekday.vo.js

@@ -1,96 +1,59 @@
 import { Timestamp } from "./timestamp.vo";
-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 = {}));
-export const WeekdayValueError = { Invalid: "weekday.invalid" };
-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
-};
+import { WeekdayIsoId } from "./weekday-iso-id.vo";
 export class Weekday {
-    // 0..6 (Sun..Sat)
     value;
-    // default formatter used by toString()/format() when no runtime formatter given
-    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) || candidate < 0 || candidate > 6) {
-            throw new Error(WeekdayValueError.Invalid);
-        }
-        this.value = candidate;
-        this.formatter = formatter ?? WeekdayFormatters.FULL;
-    }
-    static fromTimestamp(timestamp, formatter) {
-        const dayZeroBased = new Date(timestamp.ms).getUTCDay(); // 0..6
-        return new Weekday(dayZeroBased, formatter);
+    static MONDAY = Weekday.fromIsoId(WeekdayIsoId.parse(1));
+    static TUESDAY = Weekday.fromIsoId(WeekdayIsoId.parse(2));
+    static WEDNESDAY = Weekday.fromIsoId(WeekdayIsoId.parse(3));
+    static THURSDAY = Weekday.fromIsoId(WeekdayIsoId.parse(4));
+    static FRIDAY = Weekday.fromIsoId(WeekdayIsoId.parse(5));
+    static SATURDAY = Weekday.fromIsoId(WeekdayIsoId.parse(6));
+    static SUNDAY = Weekday.fromIsoId(WeekdayIsoId.parse(7));
+    constructor(value) {
+        this.value = value;
+    }
+    static fromTimestamp(timestamp) {
+        // UTC returns numbers from 0-6, starting from Sunday
+        const utc = new Date(timestamp.ms).getUTCDay();
+        return new Weekday(WeekdayIsoId.parse(utc === 0 ? 7 : utc));
     }
     static fromTimestampValue(timestamp) {
         return Weekday.fromTimestamp(Timestamp.fromValue(timestamp));
     }
+    static fromIsoId(iso) {
+        return new Weekday(iso);
+    }
     get() {
         return this.value;
     }
-    format() {
-        return this.formatter(this.value);
-    }
-    toString() {
-        return this.format();
-    }
     equals(another) {
         return this.value === another.value;
     }
-    /** ISO-8601 weekday number: Monday=1 ... Sunday=7 */
-    toIsoNumber() {
-        return this.value === 0 ? 7 : this.value;
-    }
     isMonday() {
-        return this.value === 1;
+        return this.equals(Weekday.MONDAY);
     }
     isTuesday() {
-        return this.value === 2;
+        return this.equals(Weekday.TUESDAY);
     }
     isWednesday() {
-        return this.value === 3;
+        return this.equals(Weekday.WEDNESDAY);
     }
     isThursday() {
-        return this.value === 4;
+        return this.equals(Weekday.THURSDAY);
     }
     isFriday() {
-        return this.value === 5;
+        return this.equals(Weekday.FRIDAY);
     }
     isSaturday() {
-        return this.value === 6;
+        return this.equals(Weekday.SATURDAY);
     }
     isSunday() {
-        return this.value === 0;
+        return this.equals(Weekday.SUNDAY);
     }
-    static list(formatter) {
-        return Array.from({ length: 7 }, (_, index) => new Weekday(index, formatter));
+    toJSON() {
+        return this.value;
     }
-    static listMondayFirst(formatter) {
-        const [Sunday, ...rest] = Weekday.list(formatter);
-        return [...rest, Sunday];
+    toString() {
+        return this.value.toString();
     }
 }

package/dist/year.vo.js

@@ -1,4 +1,4 @@
-import { addYears, endOfYear, getYear, startOfYear } from "date-fns";
+import { endOfYear, getYear, startOfYear } from "date-fns";
 import { DateRange } from "./date-range.vo";
 import { Integer } from "./integer.vo";
 import { Timestamp } from "./timestamp.vo";
@@ -19,8 +19,8 @@ export class Year extends DateRange {
         return Year.fromIsoId(YearIsoId.parse(String(candidate)));
     }
     static fromIsoId(isoId) {
-        const reference = Date.UTC(Number(isoId));
-        return Year.fromTimestamp(Timestamp.fromNumber(reference));
+        const year = Number(isoId);
+        return new Year(Timestamp.fromNumber(Date.UTC(year, 0, 1)), Timestamp.fromNumber(Date.UTC(year + 1, 0, 1) - 1));
     }
     toIsoId() {
         return YearIsoId.parse(String(getYear(this.getStart().ms)));
@@ -40,8 +40,8 @@ export class Year extends DateRange {
         return this.shift(Integer.parse(1));
     }
     shift(count) {
-        const shifted = addYears(this.getStart().ms, count).getTime();
-        return Year.fromTimestamp(Timestamp.fromNumber(shifted));
+        const year = getYear(this.getStart().ms) + count;
+        return Year.fromIsoId(YearIsoId.parse(String(year)));
     }
     toString() {
         return this.toIsoId();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/tools",
-  "version": "1.3.14",
+  "version": "1.3.16",
   "type": "module",
   "license": "MIT",
   "author": "Bartosz Gordon",
@@ -24,7 +24,7 @@
     "@commitlint/cli": "20.4.1",
     "@commitlint/config-conventional": "20.4.1",
     "@stryker-mutator/core": "9.5.1",
-    "@types/bun": "1.3.8",
+    "@types/bun": "1.3.9",
     "cspell": "9.6.4",
     "knip": "5.83.1",
     "lefthook": "2.1.0",

package/readme.md

@@ -55,8 +55,7 @@ src/
 ├── filename.vo.ts
 ├── height-milimiters.vo.ts
 ├── height.vo.ts
-├── hour-format.service.ts
-├── hour-schema.vo.ts
+├── hour-value.vo.ts
 ├── hour.vo.ts
 ├── iban-mask.service.ts
 ├── iban-schema.vo.ts
@@ -74,7 +73,7 @@ src/
 ├── mime.vo.ts
 ├── mimes.ts
 ├── min-max-scaler.service.ts
-├── minute-schema.vo.ts
+├── minute-value.vo.ts
 ├── minute.vo.ts
 ├── money-amount.vo.ts
 ├── money.vo.ts

package/dist/hour-format.service.d.ts

@@ -1,10 +0,0 @@
-export type HourFormatter = (value: number) => string;
-declare 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 declare const HourFormatters: Record<HourFormatterEnum, HourFormatter>;
-export {};

package/dist/hour-format.service.js

@@ -1,19 +0,0 @@
-var HourFormatterEnum;
-(function (HourFormatterEnum) {
-    HourFormatterEnum["TWENTY_FOUR_HOURS"] = "TWENTY_FOUR_HOURS";
-    HourFormatterEnum["TWENTY_FOUR_HOURS_WO_PADDING"] = "TWENTY_FOUR_HOURS_WO_PADDING";
-    HourFormatterEnum["AM_PM"] = "AM_PM";
-    HourFormatterEnum["TWELVE_HOURS"] = "TWELVE_HOURS";
-    HourFormatterEnum["TWELVE_HOURS_WO_PADDING"] = "TWELVE_HOURS_WO_PADDING";
-})(HourFormatterEnum || (HourFormatterEnum = {}));
-export const HourFormatters = {
-    TWENTY_FOUR_HOURS: (value) => value.toString().padStart(2, "0"),
-    TWENTY_FOUR_HOURS_WO_PADDING: (value) => value.toString(),
-    AM_PM: (value) => {
-        const suffix = value < 12 ? "a.m." : "p.m.";
-        const twelveHourValue = value % 12 || 12;
-        return `${twelveHourValue} ${suffix}`;
-    },
-    TWELVE_HOURS: (value) => (value % 12 || 12).toString().padStart(2, "0"),
-    TWELVE_HOURS_WO_PADDING: (value) => (value % 12 || 12).toString(),
-};

package/dist/hour-schema.vo.d.ts

@@ -1,7 +0,0 @@
-import * as z from "zod/v4";
-export declare const HourSchemaError: {
-    Type: string;
-    Invalid: string;
-};
-export declare const HourSchema: z.core.$ZodBranded<z.ZodNumber, "HourSchema", "out">;
-export type HourSchemaType = z.infer<typeof HourSchema>;

package/dist/hour-schema.vo.js

@@ -1,10 +0,0 @@
-import * as z from "zod/v4";
-export const HourSchemaError = { Type: "hour.schema.type", Invalid: "hour.schema.invalid" };
-// Stryker disable all
-export const HourSchema = z
-    // Stryker restore all
-    .number(HourSchemaError.Type)
-    .int(HourSchemaError.Type)
-    .gte(0, HourSchemaError.Invalid)
-    .lte(23, HourSchemaError.Invalid)
-    .brand("HourSchema");

package/dist/minute-schema.vo.d.ts

@@ -1,7 +0,0 @@
-import * as z from "zod/v4";
-export declare const MinuteSchemaError: {
-    Type: string;
-    Invalid: string;
-};
-export declare const MinuteSchema: z.core.$ZodBranded<z.ZodNumber, "MinuteSchema", "out">;
-export type MinuteSchemaType = z.infer<typeof MinuteSchema>;

package/dist/minute-schema.vo.js

@@ -1,10 +0,0 @@
-import * as z from "zod/v4";
-export const MinuteSchemaError = { Type: "minute.schema.error", Invalid: "minute.schema.invalid" };
-// Stryker disable all
-export const MinuteSchema = z
-    // Stryker restore all
-    .number(MinuteSchemaError.Type)
-    .int(MinuteSchemaError.Type)
-    .gte(0, MinuteSchemaError.Invalid)
-    .lte(59, MinuteSchemaError.Invalid)
-    .brand("MinuteSchema");