@bgord/tools 0.13.0 → 0.13.2

package/dist/directory-path-absolute.vo.d.ts

@@ -1,3 +1,3 @@
 import { z } from "zod/v4";
-export declare const DirectoryPathAbsoluteSchema: z.core.$ZodBranded<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodTransform<string, string>>, "directory_path_absolute_">;
+export declare const DirectoryPathAbsoluteSchema: z.core.$ZodBranded<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodTransform<string, string>>, "directory_path_absolute">;
 export type DirectoryPathAbsoluteType = z.infer<typeof DirectoryPathAbsoluteSchema>;

package/dist/directory-path-absolute.vo.js

@@ -14,4 +14,4 @@ export const DirectoryPathAbsoluteSchema = z
     const segments = value.slice(1).split("/");
     return segments.every((segment) => segment.length > 0 && /^[A-Za-z0-9._-]+$/.test(segment) && segment !== "." && segment !== "..");
 }, "abs_dir_bad_segments")
-    .brand("directory_path_absolute_");
+    .brand("directory_path_absolute");

package/dist/file-path-absolute-schema.vo.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 import { Filename } from "./filename.vo";
 export declare const FilePathAbsoluteSchema: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodTransform<string, string>>, z.ZodTransform<{
-    directory: string & z.core.$brand<"directory_path_absolute_">;
+    directory: string & z.core.$brand<"directory_path_absolute">;
     filename: Filename;
 }, string>>;

package/dist/index.d.ts

@@ -25,13 +25,14 @@ 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";
@@ -40,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";
@@ -62,4 +65,6 @@ 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/dist/index.js

@@ -25,13 +25,14 @@ 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";
@@ -40,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";
@@ -62,4 +65,6 @@ 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/dist/minute.vo.d.ts

@@ -1,9 +1,10 @@
+import type { TimestampType } from "./timestamp.vo";
 export declare class Minute {
     private readonly value;
     static readonly ZERO: Minute;
     static readonly MAX: Minute;
     constructor(candidate: number);
-    static fromUtcTimestamp(timestamp: number): Minute;
+    static fromUtcTimestamp(timestamp: TimestampType): Minute;
     get(): {
         raw: number;
         formatted: string;

package/dist/money.vo.js

@@ -2,8 +2,8 @@ import { z } from "zod/v4";
 import { RoundToNearest } from "./rounding.service";
 export const MoneyAmount = z
     .number()
-    .int({ message: "money.amount.invalid " })
-    .min(0, { message: "money.amount.invalid " })
+    .int({ message: "money.amount.invalid" })
+    .min(0, { message: "money.amount.invalid" })
     .brand("MoneyAmount");
 export const MoneyMultiplicationFactor = z
     .number()
@@ -40,8 +40,6 @@ export class Money {
         return new Money(MoneyAmount.parse(result), this.rounding);
     }
     divide(factor) {
-        if (factor === 0)
-            throw new Error("Cannot divide by zero");
         const result = this.rounding.round(this.amount / factor);
         return new Money(MoneyAmount.parse(result), this.rounding);
     }

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

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

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

@@ -0,0 +1,15 @@
+import { z } from "zod/v4";
+export const MonthIsoId = z
+    .string()
+    .regex(/^\d{4}-\d{2}$/)
+    .refine((value) => {
+    const [y, m] = value.split("-");
+    const year = Number(y);
+    const month = Number(m);
+    return (y.length === 4 &&
+        m.length === 2 &&
+        Number.isInteger(year) &&
+        Number.isInteger(month) &&
+        month >= 1 &&
+        month <= 12);
+}, { message: "month-iso-id.invalid" });

package/dist/month.vo.d.ts

@@ -0,0 +1,9 @@
+import { DateRange } from "./date-range.vo";
+import { type MonthIsoIdType } from "./month-iso-id.vo";
+import { type TimestampType } from "./timestamp.vo";
+export declare class Month extends DateRange {
+    toIsoId(): MonthIsoIdType;
+    static fromTimestamp(timestamp: TimestampType): Month;
+    static fromNow(now: TimestampType): Month;
+    static fromIsoId(iso: MonthIsoIdType): Month;
+}

package/dist/month.vo.js

@@ -0,0 +1,22 @@
+import { endOfMonth, startOfMonth } from "date-fns";
+import { DateRange } from "./date-range.vo";
+import { MonthIsoId } from "./month-iso-id.vo";
+import { Timestamp } from "./timestamp.vo";
+export class Month extends DateRange {
+    toIsoId() {
+        return new Date(this.getStart()).toISOString().slice(0, 7);
+    }
+    static fromTimestamp(timestamp) {
+        const start = Timestamp.parse(startOfMonth(timestamp).getTime());
+        const end = Timestamp.parse(endOfMonth(timestamp).getTime());
+        return new Month(start, end);
+    }
+    static fromNow(now) {
+        return Month.fromTimestamp(now);
+    }
+    static fromIsoId(iso) {
+        const [year, month] = MonthIsoId.parse(iso).split("-").map(Number);
+        const reference = new Date(Date.UTC(year, month - 1, 1));
+        return Month.fromTimestamp(Timestamp.parse(reference.getTime()));
+    }
+}

package/dist/package-version.vo.js

@@ -17,11 +17,6 @@ export const PackageVersionValue = z
             Number.isInteger(Number(patch)))) {
             return false;
         }
-        if (!(Number.isInteger(Number(major)) &&
-            Number.isInteger(Number(minor)) &&
-            Number.isInteger(Number(patch)))) {
-            return false;
-        }
         return true;
     }
     catch (_error) {

package/dist/pagination.service.js

@@ -21,14 +21,7 @@ export class Pagination {
         const nextPage = currentPage < lastPage ? Page.parse(currentPage + 1) : undefined;
         return {
             result: config.result,
-            meta: {
-                exhausted,
-                currentPage,
-                previousPage,
-                nextPage,
-                lastPage,
-                total: config.total,
-            },
+            meta: { exhausted, currentPage, previousPage, nextPage, lastPage, total: config.total },
         };
     }
     static isExhausted(config) {

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

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

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

@@ -0,0 +1,10 @@
+import { z } from "zod/v4";
+export const QuarterIsoId = z
+    .string()
+    .regex(/^\d{4}-Q[1-4]$/)
+    .refine((value) => {
+    const [y, q] = value.split("-Q");
+    const year = Number(y);
+    const quarter = Number(q);
+    return (y.length === 4 && Number.isInteger(year) && Number.isInteger(quarter) && quarter >= 1 && quarter <= 4);
+}, { message: "quarter-iso-id.invalid" });

package/dist/quarter.vo.d.ts

@@ -0,0 +1,9 @@
+import { DateRange } from "./date-range.vo";
+import { type QuarterIsoIdType } from "./quarter-iso-id.vo";
+import { type TimestampType } from "./timestamp.vo";
+export declare class Quarter extends DateRange {
+    toIsoId(): QuarterIsoIdType;
+    static fromTimestamp(timestamp: TimestampType): Quarter;
+    static fromNow(now: TimestampType): Quarter;
+    static fromIsoId(isoId: QuarterIsoIdType): Quarter;
+}

package/dist/quarter.vo.js

@@ -0,0 +1,24 @@
+import { endOfQuarter, getQuarter, getYear, setQuarter, startOfQuarter } from "date-fns";
+import { DateRange } from "./date-range.vo";
+import { QuarterIsoId } from "./quarter-iso-id.vo";
+import { Timestamp } from "./timestamp.vo";
+export class Quarter extends DateRange {
+    toIsoId() {
+        const year = getYear(this.getStart());
+        const quarter = getQuarter(this.getStart());
+        return `${year}-Q${quarter}`;
+    }
+    static fromTimestamp(timestamp) {
+        const start = Timestamp.parse(startOfQuarter(timestamp).getTime());
+        const end = Timestamp.parse(endOfQuarter(timestamp).getTime());
+        return new Quarter(start, end);
+    }
+    static fromNow(now) {
+        return Quarter.fromTimestamp(now);
+    }
+    static fromIsoId(isoId) {
+        const [year, quarter] = QuarterIsoId.parse(isoId).split("-Q").map(Number);
+        const reference = setQuarter(new Date(Date.UTC(year, 0, 1)), quarter);
+        return Quarter.fromTimestamp(Timestamp.parse(reference.getTime()));
+    }
+}

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;

package/dist/tsconfig.tsbuildinfo

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

package/dist/weekday.vo.d.ts

@@ -24,10 +24,7 @@ export declare class Weekday {
         formatted: string;
     };
     equals(another: Weekday): boolean;
-    isAfter(another: Weekday): boolean;
-    isBefore(another: Weekday): boolean;
     toIsoNumber(): number;
-    isWeekend(): boolean;
     isMonday(): boolean;
     isTuesday(): boolean;
     isWednesday(): boolean;

package/dist/weekday.vo.js

@@ -52,18 +52,9 @@ export class Weekday {
     equals(another) {
         return this.value === another.get().raw;
     }
-    isAfter(another) {
-        return this.value > another.get().raw;
-    }
-    isBefore(another) {
-        return this.value < another.get().raw;
-    }
     toIsoNumber() {
         return this.value === 0 ? 7 : this.value;
     }
-    isWeekend() {
-        return this.value === 0 || this.value === 6;
-    }
     isMonday() {
         return this.value === 1;
     }

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/tools",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "type": "module",
   "license": "MIT",
   "author": "Bartosz Gordon",
@@ -27,19 +27,19 @@
     "@types/bun": "1.2.22",
     "@types/mime-types": "3.0.1",
     "cspell": "9.2.1",
-    "knip": "5.63.1",
-    "lefthook": "1.13.0",
+    "knip": "5.64.0",
+    "lefthook": "1.13.2",
     "only-allow": "1.2.1",
     "shellcheck": "4.1.0",
     "typescript": "5.9.2",
-    "zod": "4.1.8"
+    "zod": "4.1.11"
   },
   "dependencies": {
     "date-fns": "4.1.0",
     "mime-types": "3.0.1"
   },
   "peerDependencies": {
-    "zod": "4.1.8"
+    "zod": "4.1.11"
   },
   "sideEffects": false
 }

package/readme.md

@@ -51,13 +51,14 @@ src/
 ├── 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
@@ -66,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
@@ -88,6 +91,8 @@ src/
 ├── 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/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/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

@@ -25,13 +25,14 @@ 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";
@@ -40,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";
@@ -62,4 +65,6 @@ 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/min-max-scaler.service.ts

@@ -1,14 +1,10 @@
 import { type RoundingStrategy, RoundToDecimal } from "./rounding.service";
 
 type MinMaxScalerValueType = number;
-
 type MinMaxScalerConfigType = {
   min: MinMaxScalerValueType;
   max: MinMaxScalerValueType;
-  bound?: {
-    lower: MinMaxScalerValueType;
-    upper: MinMaxScalerValueType;
-  };
+  bound?: { lower: MinMaxScalerValueType; upper: MinMaxScalerValueType };
   rounding?: RoundingStrategy;
 };
 

package/src/minute.vo.ts

@@ -1,3 +1,5 @@
+import type { TimestampType } from "./timestamp.vo";
+
 export class Minute {
   private readonly value: number;
 
@@ -13,7 +15,7 @@ export class Minute {
     this.value = candidate;
   }
 
-  static fromUtcTimestamp(timestamp: number): Minute {
+  static fromUtcTimestamp(timestamp: TimestampType): Minute {
     const minutes = new Date(timestamp).getUTCMinutes();
     return new Minute(minutes);
   }

package/src/money.vo.ts

@@ -3,8 +3,8 @@ import { type RoundingStrategy, RoundToNearest } from "./rounding.service";
 
 export const MoneyAmount = z
   .number()
-  .int({ message: "money.amount.invalid " })
-  .min(0, { message: "money.amount.invalid " })
+  .int({ message: "money.amount.invalid" })
+  .min(0, { message: "money.amount.invalid" })
   .brand("MoneyAmount");
 
 export type MoneyAmountType = z.infer<typeof MoneyAmount>;
@@ -61,8 +61,6 @@ export class Money {
   }
 
   divide(factor: MoneyDivisionFactorType) {
-    if (factor === 0) throw new Error("Cannot divide by zero");
-
     const result = this.rounding.round(this.amount / factor);
 
     return new Money(MoneyAmount.parse(result), this.rounding);

package/src/month-iso-id.vo.ts

@@ -0,0 +1,25 @@
+import { z } from "zod/v4";
+
+export const MonthIsoId = z
+  .string()
+  .regex(/^\d{4}-\d{2}$/)
+  .refine(
+    (value) => {
+      const [y, m] = value.split("-");
+
+      const year = Number(y);
+      const month = Number(m);
+
+      return (
+        y.length === 4 &&
+        m.length === 2 &&
+        Number.isInteger(year) &&
+        Number.isInteger(month) &&
+        month >= 1 &&
+        month <= 12
+      );
+    },
+    { message: "month-iso-id.invalid" },
+  );
+
+export type MonthIsoIdType = z.infer<typeof MonthIsoId>;

package/src/month.vo.ts

@@ -0,0 +1,26 @@
+import { endOfMonth, startOfMonth } from "date-fns";
+import { DateRange } from "./date-range.vo";
+import { MonthIsoId, type MonthIsoIdType } from "./month-iso-id.vo";
+import { Timestamp, type TimestampType } from "./timestamp.vo";
+
+export class Month extends DateRange {
+  toIsoId(): MonthIsoIdType {
+    return new Date(this.getStart()).toISOString().slice(0, 7) as MonthIsoIdType;
+  }
+
+  static fromTimestamp(timestamp: TimestampType): Month {
+    const start = Timestamp.parse(startOfMonth(timestamp).getTime());
+    const end = Timestamp.parse(endOfMonth(timestamp).getTime());
+    return new Month(start, end);
+  }
+
+  static fromNow(now: TimestampType): Month {
+    return Month.fromTimestamp(now);
+  }
+
+  static fromIsoId(iso: MonthIsoIdType): Month {
+    const [year, month] = MonthIsoId.parse(iso).split("-").map(Number);
+    const reference = new Date(Date.UTC(year, month - 1, 1));
+    return Month.fromTimestamp(Timestamp.parse(reference.getTime()));
+  }
+}

package/src/object-key.vo.ts

@@ -13,5 +13,4 @@ export const ObjectKey = z
     "obj_key_bad_segments",
   )
   .brand("object_key");
-
 export type ObjectKeyType = z.infer<typeof ObjectKey>;

package/src/package-version.vo.ts

@@ -1,9 +1,7 @@
 import { z } from "zod/v4";
 
 type MajorType = number;
-
 type MinorType = number;
-
 type PatchType = number;
 
 export const PackageVersionValue = z
@@ -30,16 +28,6 @@ export const PackageVersionValue = z
           return false;
         }
 
-        if (
-          !(
-            Number.isInteger(Number(major)) &&
-            Number.isInteger(Number(minor)) &&
-            Number.isInteger(Number(patch))
-          )
-        ) {
-          return false;
-        }
-
         return true;
       } catch (_error) {
         return false;

package/src/pagination.service.ts

@@ -1,11 +1,9 @@
 import { z } from "zod/v4";
 
 const Take = z.number().int().gte(0);
-
 type TakeType = z.infer<typeof Take>;
 
 const Skip = z.number().int().gte(0);
-
 type SkipType = z.infer<typeof Skip>;
 
 const Page = z.coerce
@@ -13,30 +11,14 @@ const Page = z.coerce
   .int()
   .transform((value) => (value <= 0 ? 1 : value))
   .default(1);
-
 export type PageType = z.infer<typeof Page>;
 
-export type PaginationType = {
-  values: { take: TakeType; skip: SkipType };
-  page: PageType;
-};
-
+export type PaginationType = { values: { take: TakeType; skip: SkipType }; page: PageType };
 export type PaginationValuesType = Record<string, unknown>;
-
 export type TotalType = number;
-
 export type ExhaustedType = boolean;
-
-export type PaginationExhaustedConfig = {
-  total: TotalType;
-  pagination: PaginationType;
-};
-
-export type PaginationPrepareConfigType<T> = {
-  total: TotalType;
-  pagination: PaginationType;
-  result: T[];
-};
+export type PaginationExhaustedConfig = { total: TotalType; pagination: PaginationType };
+export type PaginationPrepareConfigType<T> = { total: TotalType; pagination: PaginationType; result: T[] };
 
 export class Pagination {
   static parse(values: PaginationValuesType, _take: TakeType): PaginationType {
@@ -59,14 +41,7 @@ export class Pagination {
 
     return {
       result: config.result,
-      meta: {
-        exhausted,
-        currentPage,
-        previousPage,
-        nextPage,
-        lastPage,
-        total: config.total,
-      },
+      meta: { exhausted, currentPage, previousPage, nextPage, lastPage, total: config.total },
     };
   }
 

package/src/quarter-iso-id.vo.ts

@@ -0,0 +1,18 @@
+import { z } from "zod/v4";
+
+export const QuarterIsoId = z
+  .string()
+  .regex(/^\d{4}-Q[1-4]$/)
+  .refine(
+    (value) => {
+      const [y, q] = value.split("-Q");
+      const year = Number(y);
+      const quarter = Number(q);
+
+      return (
+        y.length === 4 && Number.isInteger(year) && Number.isInteger(quarter) && quarter >= 1 && quarter <= 4
+      );
+    },
+    { message: "quarter-iso-id.invalid" },
+  );
+export type QuarterIsoIdType = z.infer<typeof QuarterIsoId>;

package/src/quarter.vo.ts

@@ -0,0 +1,28 @@
+import { endOfQuarter, getQuarter, getYear, setQuarter, startOfQuarter } from "date-fns";
+import { DateRange } from "./date-range.vo";
+import { QuarterIsoId, type QuarterIsoIdType } from "./quarter-iso-id.vo";
+import { Timestamp, type TimestampType } from "./timestamp.vo";
+
+export class Quarter extends DateRange {
+  toIsoId(): QuarterIsoIdType {
+    const year = getYear(this.getStart());
+    const quarter = getQuarter(this.getStart());
+    return `${year}-Q${quarter}` as QuarterIsoIdType;
+  }
+
+  static fromTimestamp(timestamp: TimestampType): Quarter {
+    const start = Timestamp.parse(startOfQuarter(timestamp).getTime());
+    const end = Timestamp.parse(endOfQuarter(timestamp).getTime());
+    return new Quarter(start, end);
+  }
+
+  static fromNow(now: TimestampType): Quarter {
+    return Quarter.fromTimestamp(now);
+  }
+
+  static fromIsoId(isoId: QuarterIsoIdType): Quarter {
+    const [year, quarter] = QuarterIsoId.parse(isoId).split("-Q").map(Number);
+    const reference = setQuarter(new Date(Date.UTC(year, 0, 1)), quarter);
+    return Quarter.fromTimestamp(Timestamp.parse(reference.getTime()));
+  }
+}

package/src/reordering.service.ts

@@ -2,15 +2,12 @@ import { z } from "zod/v4";
 import { DoublyLinkedList, Node } from "./dll.service";
 
 export const ReorderingItemPositionValue = z.number().int().min(0);
-
 export type ReorderingItemPositionValueType = z.infer<typeof ReorderingItemPositionValue>;
 
 export const ReorderingCorrelationId = z.string().min(1);
-
 export type ReorderingCorrelationIdType = z.infer<typeof ReorderingCorrelationId>;
 
 export const ReorderingItemId = z.uuid();
-
 export type ReorderingItemIdType = z.infer<typeof ReorderingItemId>;
 
 export const Reordering = z.object({
@@ -21,9 +18,7 @@ export const Reordering = z.object({
 
 export type ReorderingType = z.infer<typeof Reordering>;
 
-export type WithReorderingPositionValue<T> = T & {
-  position: ReorderingItemPositionValueType;
-};
+export type WithReorderingPositionValue<T> = T & { position: ReorderingItemPositionValueType };
 
 export class ReorderingPosition {
   readonly value: ReorderingItemPositionValueType;

package/src/revision.vo.ts

@@ -2,12 +2,10 @@ import { z } from "zod/v4";
 import type { ETag, WeakETag } from "./etags.vo";
 
 export const RevisionValue = z.number().int().min(0);
-
 export type RevisionValueType = z.infer<typeof RevisionValue>;
 
 export class Revision {
   readonly value: RevisionValueType;
-
   static initial: RevisionValueType = 0;
 
   constructor(value: unknown) {

package/src/simple-linear-regression.service.ts

@@ -2,9 +2,7 @@ import { type RoundingStrategy, RoundToNearest } from "./rounding.service";
 import { Sum } from "./sum.service";
 
 export type SLRPairType = { x: number; y: number };
-
 export type SLRParamsType = { a: number; b: number };
-
 export type SLRPredictionType = number;
 
 export class SimpleLinearRegression {

package/src/size.vo.ts

@@ -9,7 +9,6 @@ export enum SizeUnit {
 }
 
 export const SizeValue = z.number().positive().brand("SizeValue");
-
 type SizeValueType = z.infer<typeof SizeValue>;
 
 type SizeConfigType = { unit: SizeUnit; value: number };

package/src/stepper.service.ts

@@ -1,5 +1,4 @@
 type StepType = number;
-
 type StepperConfigType = { total: StepType };
 
 export class Stepper {

package/src/stopwatch.service.ts

@@ -3,7 +3,7 @@ import type { Falsy } from "./ts-utils";
 
 enum StopwatchState {
   started = "started",
-  stopped = "finished",
+  stopped = "stopped",
 }
 
 export type StopwatchResultType = { durationMs: TimestampType };

package/src/streak-calculator.service.ts

@@ -1,12 +1,7 @@
 import { format, isAfter, isEqual, subDays } from "date-fns";
 
 type DateType = string;
-
-export type StreakType = {
-  cutoff: DateType;
-  dates: DateType[];
-  streak: number;
-};
+export type StreakType = { cutoff: DateType; dates: DateType[]; streak: number };
 
 export class StreakCalculator {
   private readonly cutoff: DateType;

package/src/time-zone-offset-value.vo.ts

@@ -7,5 +7,4 @@ export const TimeZoneOffsetValue = z
   .transform((value) => Number(value))
   .transform((value) => (Number.isNaN(value) ? 0 : value))
   .brand("TimeZoneOffsetValue");
-
 export type TimeZoneOffsetValueType = z.infer<typeof TimeZoneOffsetValue>;

package/src/timestamp.vo.ts

@@ -1,5 +1,4 @@
 import { z } from "zod/v4";
 
 export const Timestamp = z.number().int().gte(0).brand("Timestamp");
-
 export type TimestampType = z.infer<typeof Timestamp>;

package/src/timezone.vo.ts

@@ -17,5 +17,4 @@ export const Timezone = z
     { message: "timezone.invalid" },
   )
   .brand("Timezone");
-
 export type TimezoneType = z.infer<typeof Timezone>;

package/src/ts-utils.ts

@@ -1,5 +1,3 @@
 export type Constructor<T> = new (...args: any[]) => T;
-
 export type Falsy<T> = T | null | undefined;
-
 export type Nullable<T> = T | null;

package/src/visually-unambiguous-characters-generator.service.ts

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

package/src/week-iso-id.vo.ts

@@ -20,5 +20,4 @@ export const WeekIsoId = z
     },
     { message: "week-iso-id.invalid" },
   );
-
 export type WeekIsoIdType = z.infer<typeof WeekIsoId>;

package/src/weekday.vo.ts

@@ -64,22 +64,10 @@ export class Weekday {
     return this.value === another.get().raw;
   }
 
-  isAfter(another: Weekday): boolean {
-    return this.value > another.get().raw;
-  }
-
-  isBefore(another: Weekday): boolean {
-    return this.value < another.get().raw;
-  }
-
   toIsoNumber(): number {
     return this.value === 0 ? 7 : this.value;
   }
 
-  isWeekend(): boolean {
-    return this.value === 0 || this.value === 6;
-  }
-
   isMonday(): boolean {
     return this.value === 1;
   }

package/src/year-iso-id.vo.ts

@@ -0,0 +1,13 @@
+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" },
+  );
+export type YearIsoIdType = z.infer<typeof YearIsoId>;

package/src/year.vo.ts

@@ -0,0 +1,36 @@
+import { endOfYear, getYear, startOfYear } from "date-fns";
+import { DateRange } from "./date-range.vo";
+import { Timestamp, type TimestampType } from "./timestamp.vo";
+import { YearIsoId, type YearIsoIdType } from "./year-iso-id.vo";
+
+export class Year extends DateRange {
+  toIsoId(): YearIsoIdType {
+    return String(getYear(this.getStart())) as YearIsoIdType;
+  }
+
+  isLeapYear(): boolean {
+    const year = getYear(this.getStart());
+    return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+  }
+
+  static fromTimestamp(timestamp: TimestampType): Year {
+    const start = Timestamp.parse(startOfYear(timestamp).getTime());
+    const end = Timestamp.parse(endOfYear(timestamp).getTime());
+    return new Year(start, end);
+  }
+
+  static fromNow(now: TimestampType): Year {
+    return Year.fromTimestamp(now);
+  }
+
+  static fromNumber(value: number): Year {
+    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: YearIsoIdType): Year {
+    return Year.fromNumber(Number(YearIsoId.parse(isoId)));
+  }
+}

package/dist/leap-year-checker.service.d.ts

@@ -1,4 +0,0 @@
-export declare class LeapYearChecker {
-    static isLeapYear(year: number): boolean;
-    static isCurrentYearLeapYear(): boolean;
-}

package/dist/leap-year-checker.service.js

@@ -1,9 +0,0 @@
-export class LeapYearChecker {
-    static isLeapYear(year) {
-        return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
-    }
-    static isCurrentYearLeapYear() {
-        const year = new Date().getFullYear();
-        return LeapYearChecker.isLeapYear(year);
-    }
-}

package/src/leap-year-checker.service.ts

@@ -1,11 +0,0 @@
-export class LeapYearChecker {
-  static isLeapYear(year: number): boolean {
-    return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
-  }
-
-  static isCurrentYearLeapYear(): boolean {
-    const year = new Date().getFullYear();
-
-    return LeapYearChecker.isLeapYear(year);
-  }
-}