@bgord/tools 0.12.26 → 0.13.1

package/dist/stepper.service.js

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

package/dist/stopwatch.service.js

@@ -2,7 +2,7 @@ import { Timestamp } from "./timestamp.vo";
 var StopwatchState;
 (function (StopwatchState) {
     StopwatchState["started"] = "started";
-    StopwatchState["stopped"] = "finished";
+    StopwatchState["stopped"] = "stopped";
 })(StopwatchState || (StopwatchState = {}));
 export class Stopwatch {
     startMs;
@@ -12,9 +12,8 @@ export class Stopwatch {
         this.startMs = startMs;
     }
     stop() {
-        if (this.state === StopwatchState.stopped) {
+        if (this.state === StopwatchState.stopped)
             throw new Error("Stopwatch is already stopped");
-        }
         this.state = StopwatchState.stopped;
         this.stopMs = Timestamp.parse(Date.now());
         return { durationMs: Timestamp.parse(this.stopMs - this.startMs) };

package/dist/timezone.vo.js

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

package/dist/tsconfig.tsbuildinfo

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

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

@@ -1,5 +1,6 @@
 import { Random } from "./random.service";
 export class VisuallyUnambiguousCharactersGenerator {
+    // prettier-ignore
     static chars = [
         "a",
         "b",
@@ -26,10 +27,7 @@ export class VisuallyUnambiguousCharactersGenerator {
     ];
     static generate(length = 1) {
         return Array.from({ length })
-            .map(() => VisuallyUnambiguousCharactersGenerator.chars[Random.generate({
-            min: 0,
-            max: VisuallyUnambiguousCharactersGenerator.chars.length - 1,
-        })])
+            .map(() => VisuallyUnambiguousCharactersGenerator.chars[Random.generate({ min: 0, max: VisuallyUnambiguousCharactersGenerator.chars.length - 1 })])
             .join("");
     }
 }

package/dist/weekday.vo.d.ts

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

package/dist/weekday.vo.js

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

package/dist/year-iso-id.vo.d.ts

@@ -0,0 +1,3 @@
+import { z } from "zod/v4";
+export declare const YearIsoId: z.ZodString;
+export type YearIsoIdType = z.infer<typeof YearIsoId>;

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

@@ -0,0 +1,8 @@
+import { z } from "zod/v4";
+export const YearIsoId = z
+    .string()
+    .regex(/^\d{4}$/)
+    .refine((value) => {
+    const year = Number(value);
+    return value.length === 4 && Number.isInteger(year);
+}, { message: "year-iso-id.invalid" });

package/dist/year.vo.d.ts

@@ -0,0 +1,11 @@
+import { DateRange } from "./date-range.vo";
+import { type TimestampType } from "./timestamp.vo";
+import { type YearIsoIdType } from "./year-iso-id.vo";
+export declare class Year extends DateRange {
+    toIsoId(): YearIsoIdType;
+    isLeapYear(): boolean;
+    static fromTimestamp(timestamp: TimestampType): Year;
+    static fromNow(now: TimestampType): Year;
+    static fromNumber(value: number): Year;
+    static fromIsoId(isoId: YearIsoIdType): Year;
+}

package/dist/year.vo.js

@@ -0,0 +1,32 @@
+import { endOfYear, getYear, startOfYear } from "date-fns";
+import { DateRange } from "./date-range.vo";
+import { Timestamp } from "./timestamp.vo";
+import { YearIsoId } from "./year-iso-id.vo";
+export class Year extends DateRange {
+    toIsoId() {
+        return String(getYear(this.getStart()));
+    }
+    isLeapYear() {
+        const year = getYear(this.getStart());
+        return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+    }
+    static fromTimestamp(timestamp) {
+        const start = Timestamp.parse(startOfYear(timestamp).getTime());
+        const end = Timestamp.parse(endOfYear(timestamp).getTime());
+        return new Year(start, end);
+    }
+    static fromNow(now) {
+        return Year.fromTimestamp(now);
+    }
+    static fromNumber(value) {
+        if (!Number.isInteger(value))
+            throw new Error("year.invalid_integer");
+        if (value < 0 || value > 9999)
+            throw new Error("year.out_of_range");
+        const reference = Timestamp.parse(Date.UTC(value, 0, 1, 0, 0, 0, 0));
+        return Year.fromTimestamp(reference);
+    }
+    static fromIsoId(isoId) {
+        return Year.fromNumber(Number(YearIsoId.parse(isoId)));
+    }
+}

package/dist/z-score.service.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/tools",
-  "version": "0.12.26",
+  "version": "0.13.1",
   "type": "module",
   "license": "MIT",
   "author": "Bartosz Gordon",
@@ -32,14 +32,14 @@
     "only-allow": "1.2.1",
     "shellcheck": "4.1.0",
     "typescript": "5.9.2",
-    "zod": "4.1.8"
+    "zod": "4.1.9"
   },
   "dependencies": {
     "date-fns": "4.1.0",
     "mime-types": "3.0.1"
   },
   "peerDependencies": {
-    "zod": "4.1.8"
+    "zod": "4.1.9"
   },
   "sideEffects": false
 }

package/readme.md

@@ -26,7 +26,6 @@ Run the tests
 src/
 ├── api-key.vo.ts
 ├── basename.vo.ts
-├── build-version.vo.ts
 ├── clock.vo.ts
 ├── date-calculator.service.ts
 ├── date-formatter.service.ts
@@ -47,19 +46,19 @@ src/
 ├── filename-from-string.vo.ts
 ├── filename-suffix.vo.ts
 ├── filename.vo.ts
-├── filter.vo.ts
 ├── hour.vo.ts
 ├── iban-mask.service.ts
 ├── iban.vo.ts
 ├── image.vo.ts
 ├── language.vo.ts
-├── leap-year-checker.service.ts
 ├── mean.service.ts
 ├── mime-types.vo.ts
 ├── mime.vo.ts
 ├── min-max-scaler.service.ts
 ├── minute.vo.ts
 ├── money.vo.ts
+├── month-iso-id.vo.ts
+├── month.vo.ts
 ├── noop.service.ts
 ├── notification-template.vo.ts
 ├── object-key.vo.ts
@@ -68,6 +67,8 @@ src/
 ├── pagination.service.ts
 ├── percentage.service.ts
 ├── population-standard-deviation.service.ts
+├── quarter-iso-id.vo.ts
+├── quarter.vo.ts
 ├── random.service.ts
 ├── rate-limiter.service.ts
 ├── relative-date.vo.ts
@@ -89,6 +90,9 @@ src/
 ├── visually-unambiguous-characters-generator.service.ts
 ├── week-iso-id.vo.ts
 ├── week.vo.ts
+├── weekday.vo.ts
+├── year-iso-id.vo.ts
+├── year.vo.ts
 └── z-score.service.ts
 ```
 

package/src/api-key.vo.ts

@@ -1,5 +1,4 @@
 import { z } from "zod/v4";
 
 export const ApiKey = z.string().trim().length(64).brand("ApiKey");
-
 export type ApiKeyType = z.infer<typeof ApiKey>;

package/src/basename.vo.ts

@@ -15,5 +15,4 @@ export const BasenameSchema = z
   .refine((s) => !s.endsWith("."), "basename_trailing_dot_forbidden")
   .regex(/^[A-Za-z0-9._-]+$/, "basename_bad_chars")
   .brand("basename");
-
 export type BasenameType = z.infer<typeof BasenameSchema>;

package/src/clock.vo.ts

@@ -1,5 +1,6 @@
-import { type Hour, HourFormatters } from "./hour.vo";
-import type { Minute } from "./minute.vo";
+import { Hour, HourFormatters } from "./hour.vo";
+import { Minute } from "./minute.vo";
+import type { TimestampType } from "./timestamp.vo";
 
 export type ClockFormatter = (hour: Hour, minute: Minute) => string;
 
@@ -26,6 +27,12 @@ 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);
+    return new Clock(hour, minute, formatter);
+  }
+
   get(formatter?: ClockFormatter) {
     const format = formatter ?? this.formatter;
 

package/src/date-calculator.service.ts

@@ -1,10 +1,7 @@
 import { Time } from "./time.service";
 import type { TimestampType } from "./timestamp.vo";
 
-type GetStartOfDayTsInTzConfigType = {
-  now: TimestampType;
-  timeZoneOffsetMs: number;
-};
+type GetStartOfDayTsInTzConfigType = { now: TimestampType; timeZoneOffsetMs: number };
 
 export class DateCalculator {
   static getStartOfDayTsInTz(config: GetStartOfDayTsInTzConfigType) {

package/src/date-formatter.service.ts

@@ -1,7 +1,6 @@
 import { format, formatDistanceToNow } from "date-fns";
 
 type FormattedDateType = string;
-
 type DateFormattersInputType = Parameters<typeof format>[0];
 
 export class DateFormatters {

package/src/directory-path-absolute.vo.ts

@@ -17,6 +17,6 @@ export const DirectoryPathAbsoluteSchema = z
         segment.length > 0 && /^[A-Za-z0-9._-]+$/.test(segment) && segment !== "." && segment !== "..",
     );
   }, "abs_dir_bad_segments")
-  .brand("directory_path_absolute_");
+  .brand("directory_path_absolute");
 
 export type DirectoryPathAbsoluteType = z.infer<typeof DirectoryPathAbsoluteSchema>;

package/src/dll.service.ts

@@ -1,8 +1,6 @@
 export class Node<T> {
   data: T;
-
   prev: Node<T> | null = null;
-
   next: Node<T> | null = null;
 
   constructor(data: Node<T>["data"]) {
@@ -39,11 +37,8 @@ export class Node<T> {
 
 export class DoublyLinkedList<T> {
   static EMPTY_SIZE = 0;
-
   private size = DoublyLinkedList.EMPTY_SIZE;
-
   private head: Node<T> | null = null;
-
   private tail: Node<T> | null = null;
 
   getSize(): DoublyLinkedList<T>["size"] {

package/src/email-mask.service.ts

@@ -1,7 +1,6 @@
 import { z } from "zod/v4";
 
 export const Email = z.email().brand("Email");
-
 export type EmailType = z.infer<typeof Email>;
 
 type EmailMaskedType = string;

package/src/etags.vo.ts

@@ -1,7 +1,6 @@
 import { z } from "zod/v4";
 
 const RevisionValue = z.number().int().min(0);
-
 type RevisionValueType = z.infer<typeof RevisionValue>;
 
 type ETagValueType = string;

package/src/extension.vo.ts

@@ -13,5 +13,4 @@ export const ExtensionSchema = z
       .regex(/^[a-z0-9]+$/, "extension_bad_chars"),
   )
   .brand("extension");
-
 export type ExtensionType = z.infer<typeof ExtensionSchema>;

package/src/feature-flag.vo.ts

@@ -4,8 +4,8 @@ export enum FeatureFlagEnum {
   yes = "yes",
   no = "no",
 }
-export const FeatureFlagValue = z.enum(FeatureFlagEnum);
 
+export const FeatureFlagValue = z.enum(FeatureFlagEnum);
 export type FeatureFlagValueType = z.infer<typeof FeatureFlagValue>;
 
 export class FeatureFlag {

package/src/filename-from-string.vo.ts

@@ -16,5 +16,4 @@ export const FilenameFromStringSchema = z
     const extension = ExtensionSchema.parse(string.slice(index + 1));
     return { basename: base, extension: extension };
   });
-
 export type FilenameFromString = z.infer<typeof FilenameFromStringSchema>;

package/src/filename-suffix.vo.ts

@@ -6,5 +6,4 @@ export const FilenameSuffixSchema = z
   .transform((value) => value.replace(/[^A-Za-z0-9_-]/g, ""))
   .pipe(z.string().max(32, "suffix_too_long"))
   .brand("basename_suffix");
-
 export type FilenameSuffixSchemaType = z.infer<typeof FilenameSuffixSchema>;

package/src/hour.vo.ts

@@ -1,3 +1,5 @@
+import type { TimestampType } from "./timestamp.vo";
+
 export type HourFormatter = (value: Hour["value"]) => string;
 
 export enum HourFormatterEnum {
@@ -14,13 +16,13 @@ export const HourFormatters: Record<HourFormatterEnum, HourFormatter> = {
   TWENTY_FOUR_HOURS_WO_PADDING: (value) => value.toString(),
 
   AM_PM: (value) => {
-    if (value < 12) return `${value.toString()} a.m.`;
-    return `${value.toString()} p.m.`;
+    const twelveHour = value % 12 || 12;
+    return `${twelveHour.toString()} ${value < 12 ? "a.m." : "p.m."}`;
   },
 
-  TWELVE_HOURS: (value) => (value % 12).toString().padStart(2, "0"),
+  TWELVE_HOURS: (value) => (value % 12 || 12).toString().padStart(2, "0"),
 
-  TWELVE_HOURS_WO_PADDING: (value) => (value % 12).toString(),
+  TWELVE_HOURS_WO_PADDING: (value) => (value % 12 || 12).toString(),
 } as const;
 
 export class Hour {
@@ -33,15 +35,9 @@ export class Hour {
   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");
-    }
+    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");
 
     this.value = candidate;
     this.formatter = (formatter as HourFormatter) ?? HourFormatters.TWENTY_FOUR_HOURS;
@@ -65,6 +61,12 @@ export class Hour {
     return this.value < another.get().raw;
   }
 
+  static fromUtcTimestamp(timestamp: TimestampType, formatter?: HourFormatter): Hour {
+    const hours = new Date(timestamp).getUTCHours();
+
+    return new Hour(hours, formatter);
+  }
+
   static list(formatter?: HourFormatter) {
     return Array.from({ length: 24 }).map((_, index) => new Hour(index, formatter));
   }

package/src/image.vo.ts

@@ -1,9 +1,7 @@
 import { z } from "zod/v4";
 
 export const Width = z.number().int().positive().max(10000).brand("Width");
-
 export type WidthType = z.infer<typeof Width>;
 
 export const Height = z.number().int().positive().max(10000).brand("Height");
-
 export type HeightType = z.infer<typeof Height>;

package/src/index.ts

@@ -1,6 +1,5 @@
 export * from "./api-key.vo";
 export * from "./basename.vo";
-export * from "./build-version.vo";
 export * from "./clock.vo";
 export * from "./date-calculator.service";
 export * from "./date-formatter.service";
@@ -21,19 +20,19 @@ export * from "./file-path-relative-schema.vo";
 export * from "./filename.vo";
 export * from "./filename-from-string.vo";
 export * from "./filename-suffix.vo";
-export * from "./filter.vo";
 export * from "./hour.vo";
 export * from "./iban.vo";
 export * from "./iban-mask.service";
 export * from "./image.vo";
 export * from "./language.vo";
-export * from "./leap-year-checker.service";
 export * from "./mean.service";
 export * from "./mime.vo";
 export * from "./mime-types.vo";
 export * from "./min-max-scaler.service";
 export * from "./minute.vo";
 export * from "./money.vo";
+export * from "./month.vo";
+export * from "./month-iso-id.vo";
 export * from "./noop.service";
 export * from "./notification-template.vo";
 export * from "./object-key.vo";
@@ -42,6 +41,8 @@ export * from "./package-version.vo";
 export * from "./pagination.service";
 export * from "./percentage.service";
 export * from "./population-standard-deviation.service";
+export * from "./quarter.vo";
+export * from "./quarter-iso-id.vo";
 export * from "./random.service";
 export * from "./rate-limiter.service";
 export * from "./relative-date.vo";
@@ -63,4 +64,7 @@ export * from "./ts-utils";
 export * from "./visually-unambiguous-characters-generator.service";
 export * from "./week.vo";
 export * from "./week-iso-id.vo";
+export * from "./weekday.vo";
+export * from "./year.vo";
+export * from "./year-iso-id.vo";
 export * from "./z-score.service";

package/src/language.vo.ts

@@ -4,5 +4,4 @@ export const Language = z
   .string()
   .length(2)
   .regex(/^[a-z]{2}$/, { message: "invalid_language" });
-
 export type LanguageType = z.infer<typeof Language>;

package/src/mean.service.ts

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