@bgord/tools 0.17.2 → 1.0.1

package/dist/height.vo.d.ts

@@ -1,36 +1,19 @@
 import type { RoundingPort } from "./rounding.port";
-export declare enum HeightUnit {
-    cm = "cm",
-    ft_in = "ft_in"
-}
 export declare class Height {
     private readonly millimeters;
     private static readonly MILLIMETERS_PER_CENTIMETER;
-    private static readonly MILLIMETERS_PER_INCH;
-    private static readonly INCHES_PER_FOOT;
     private constructor();
     static fromCentimeters(centimeters: number, rounding?: RoundingPort): Height;
-    static fromFeetInches(feet: number, inches?: number, rounding?: RoundingPort): Height;
-    static fromMillimeters(millimeters: number, rounding?: RoundingPort): Height;
+    static fromMillimeters(millimeters: number): Height;
     static zero(): Height;
     get(): number;
     toMillimeters(): number;
     toCentimeters(rounding?: RoundingPort): number;
-    toFeetInches(rounding?: RoundingPort): {
-        feet: number;
-        inches: number;
-    };
-    format(unit: HeightUnit, rounding?: RoundingPort): string;
+    format(rounding?: RoundingPort): string;
     toString(): string;
     equals(another: Height): boolean;
-    compare(another: Height): -1 | 0 | 1;
     greaterThan(another: Height): boolean;
     lessThan(another: Height): boolean;
     isZero(): boolean;
-    toJSON(): {
-        mm: number;
-    };
-    static fromJSON(input: {
-        mm: number;
-    }): Height;
+    toJSON(): number;
 }

package/dist/height.vo.js

@@ -1,47 +1,17 @@
-import { z } from "zod/v4";
+import { HeightMillimeters } from "./height-milimiters.vo";
 import { RoundToDecimal, RoundToNearest } from "./rounding.adapter";
-const NonFiniteNumberError = { error: "number.non_finite" };
-const NumberNegativeError = { error: "number.negative" };
-const MillimetersIntegerNonNegativeError = { error: "millimeters.integer_non_negative" };
-const IntegerNonNegativeError = { error: "integer.non_negative" };
-const HeightFiniteNumber = z.number(NonFiniteNumberError).refine(Number.isFinite, NonFiniteNumberError);
-const HeightNonNegativeQuantity = HeightFiniteNumber.min(0, NumberNegativeError);
-const HeightCanonicalMillimeters = HeightFiniteNumber.int(MillimetersIntegerNonNegativeError).min(0, MillimetersIntegerNonNegativeError);
-const HeightRoundedWholeInches = HeightFiniteNumber.int(IntegerNonNegativeError).min(0, IntegerNonNegativeError);
-export var HeightUnit;
-(function (HeightUnit) {
-    HeightUnit["cm"] = "cm";
-    HeightUnit["ft_in"] = "ft_in";
-})(HeightUnit || (HeightUnit = {}));
 export class Height {
     millimeters;
     static MILLIMETERS_PER_CENTIMETER = 10;
-    static MILLIMETERS_PER_INCH = 25.4;
-    static INCHES_PER_FOOT = 12;
     constructor(millimeters) {
         this.millimeters = millimeters;
     }
     static fromCentimeters(centimeters, rounding = new RoundToNearest()) {
-        const validatedCentimeters = HeightNonNegativeQuantity.parse(centimeters);
-        const millimetersFloat = validatedCentimeters * Height.MILLIMETERS_PER_CENTIMETER;
-        const millimetersRounded = rounding.round(millimetersFloat);
-        const validatedMillimeters = HeightCanonicalMillimeters.parse(millimetersRounded);
-        return new Height(validatedMillimeters);
+        const millimeters = rounding.round(centimeters * Height.MILLIMETERS_PER_CENTIMETER);
+        return new Height(HeightMillimeters.parse(millimeters));
     }
-    static fromFeetInches(feet, inches = 0, rounding = new RoundToNearest()) {
-        const validatedFeet = HeightNonNegativeQuantity.parse(feet);
-        const validatedInches = HeightNonNegativeQuantity.parse(inches);
-        const totalInches = validatedFeet * Height.INCHES_PER_FOOT + validatedInches;
-        const millimetersFloat = totalInches * Height.MILLIMETERS_PER_INCH;
-        const millimetersRounded = rounding.round(millimetersFloat);
-        const validatedMillimeters = HeightCanonicalMillimeters.parse(millimetersRounded);
-        return new Height(validatedMillimeters);
-    }
-    static fromMillimeters(millimeters, rounding = new RoundToNearest()) {
-        const validatedMillimetersInput = HeightNonNegativeQuantity.parse(millimeters);
-        const millimetersRounded = rounding.round(validatedMillimetersInput);
-        const validatedMillimeters = HeightCanonicalMillimeters.parse(millimetersRounded);
-        return new Height(validatedMillimeters);
+    static fromMillimeters(millimeters) {
+        return new Height(HeightMillimeters.parse(millimeters));
     }
     static zero() {
         return new Height(0);
@@ -58,35 +28,17 @@ export class Height {
             return rounding.round(centimeters);
         return centimeters;
     }
-    toFeetInches(rounding = new RoundToNearest()) {
-        const totalInchesFloat = this.millimeters / Height.MILLIMETERS_PER_INCH;
-        const totalInchesRounded = rounding.round(totalInchesFloat);
-        const totalWholeInches = HeightRoundedWholeInches.parse(totalInchesRounded);
-        const feet = Math.floor(totalWholeInches / Height.INCHES_PER_FOOT);
-        const inches = totalWholeInches % Height.INCHES_PER_FOOT;
-        return { feet, inches };
-    }
-    format(unit, rounding) {
-        if (unit === HeightUnit.cm) {
-            const chosen = rounding ?? new RoundToDecimal(1);
-            const value = this.toCentimeters(chosen);
-            return `${value} cm`;
-        }
-        const chosen = rounding ?? new RoundToNearest();
-        const parts = this.toFeetInches(chosen);
-        return `${parts.feet}′${parts.inches}″`;
+    format(rounding) {
+        const chosen = rounding ?? new RoundToDecimal(1);
+        const value = this.toCentimeters(chosen);
+        return `${value} cm`;
     }
     toString() {
-        return this.format(HeightUnit.cm, new RoundToDecimal(1));
+        return this.format(new RoundToDecimal(1));
     }
     equals(another) {
         return this.millimeters === another.millimeters;
     }
-    compare(another) {
-        if (this.equals(another))
-            return 0;
-        return this.millimeters < another.millimeters ? -1 : 1;
-    }
     greaterThan(another) {
         return this.millimeters > another.millimeters;
     }
@@ -97,9 +49,6 @@ export class Height {
         return this.millimeters === 0;
     }
     toJSON() {
-        return { mm: this.millimeters };
-    }
-    static fromJSON(input) {
-        return Height.fromMillimeters(input.mm);
+        return this.millimeters;
     }
 }

package/dist/hour-format.service.js

@@ -10,8 +10,8 @@ export const HourFormatters = {
     TWENTY_FOUR_HOURS: (value) => value.toString().padStart(2, "0"),
     TWENTY_FOUR_HOURS_WO_PADDING: (value) => value.toString(),
     AM_PM: (value) => {
-        const twelveHourValue = value % 12 || 12;
         const suffix = value < 12 ? "a.m." : "p.m.";
+        const twelveHourValue = value % 12 || 12;
         return `${twelveHourValue} ${suffix}`;
     },
     TWELVE_HOURS: (value) => (value % 12 || 12).toString().padStart(2, "0"),

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

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

package/dist/hour-schema.vo.js

@@ -0,0 +1,8 @@
+import { z } from "zod/v4";
+export const HourSchemaError = { Type: "hour.schema.error", Invalid: "hour.schema.invalid" };
+export const HourSchema = z
+    .number(HourSchemaError.Type)
+    .int(HourSchemaError.Type)
+    .gte(0, HourSchemaError.Invalid)
+    .lte(23, HourSchemaError.Invalid)
+    .brand("HourSchema");

package/dist/hour.vo.d.ts

@@ -1,17 +1,18 @@
 import { type HourFormatter } from "./hour-format.service";
+import { type HourSchemaType } from "./hour-schema.vo";
 import type { TimestampType } from "./timestamp.vo";
-export declare const HourValueError: "invalid.hour";
 export declare class Hour {
     private readonly value;
     static readonly ZERO: Hour;
     static readonly MAX: Hour;
     constructor(candidate: number);
     static fromEpochMs(timestamp: TimestampType): Hour;
-    get(): number;
-    toString(): string;
+    get(): HourSchemaType;
     format(formatter: HourFormatter): string;
     equals(another: Hour): boolean;
     isAfter(another: Hour): boolean;
     isBefore(another: Hour): boolean;
     static list(): readonly Hour[];
+    toString(): string;
+    toJSON(): number;
 }

package/dist/hour.vo.js

@@ -1,14 +1,11 @@
 import { HourFormatters } from "./hour-format.service";
-export const HourValueError = "invalid.hour";
+import { HourSchema } from "./hour-schema.vo";
 export class Hour {
     value;
     static ZERO = new Hour(0);
     static MAX = new Hour(23);
     constructor(candidate) {
-        if (!Number.isInteger(candidate) || candidate < 0 || candidate >= 24) {
-            throw new Error(HourValueError);
-        }
-        this.value = candidate;
+        this.value = HourSchema.parse(candidate);
     }
     static fromEpochMs(timestamp) {
         return new Hour(new Date(timestamp).getUTCHours());
@@ -16,9 +13,6 @@ export class Hour {
     get() {
         return this.value;
     }
-    toString() {
-        return HourFormatters.TWENTY_FOUR_HOURS(this.value);
-    }
     format(formatter) {
         return formatter(this.value);
     }
@@ -34,4 +28,10 @@ export class Hour {
     static list() {
         return Array.from({ length: 24 }, (_, index) => new Hour(index));
     }
+    toString() {
+        return HourFormatters.TWENTY_FOUR_HOURS(this.value);
+    }
+    toJSON() {
+        return this.value;
+    }
 }

package/dist/iban-mask.service.d.ts

@@ -1,6 +1,4 @@
 import type { IBAN } from "./iban.vo";
-type IbanMaskedType = string;
 export declare class IbanMask {
-    static censor(iban: IBAN): IbanMaskedType;
+    static censor(iban: IBAN): string;
 }
-export {};

package/dist/iban-mask.service.js

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

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

@@ -0,0 +1,7 @@
+import { z } from "zod/v4";
+export declare const IbanSchemaError: {
+    readonly Type: "iban.schema.type";
+    readonly Invalid: "iban.schema.invalid";
+};
+export declare const IbanSchema: z.core.$ZodBranded<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, "IbanSchema">;
+export type IbanSchemaType = z.infer<typeof IbanSchema>;

package/dist/iban-schema.vo.js

@@ -0,0 +1,10 @@
+import { z } from "zod/v4";
+export const IbanSchemaError = { Type: "iban.schema.type", Invalid: "iban.schema.invalid" };
+// Two letters for country code, two digits, 11–30 uppercase letters or digits
+const IBAN_CHARS_WHITELIST = /^[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}$/;
+export const IbanSchema = z
+    .string(IbanSchemaError.Type)
+    .toUpperCase()
+    .transform((value) => value.replaceAll(" ", ""))
+    .refine((value) => IBAN_CHARS_WHITELIST.test(value), IbanSchemaError.Invalid)
+    .brand("IbanSchema");

package/dist/iban.vo.d.ts

@@ -1,15 +1,9 @@
-import { z } from "zod/v4";
-export declare const IBANError: {
-    readonly error: "invalid.iban.format";
-};
-export declare const IBANValue: z.core.$ZodBranded<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, "IBAN">;
-export type IBANValueType = z.infer<typeof IBANValue>;
-export type IBANCountryCode = string;
+import { type IbanSchemaType } from "./iban-schema.vo";
 export declare class IBAN {
     private readonly value;
-    constructor(value: string);
-    toString(): IBANValueType;
+    constructor(candidate: string);
+    toString(): IbanSchemaType;
     format(): string;
-    get countryCode(): IBANCountryCode;
+    get countryCode(): string;
     equals(other: IBAN): boolean;
 }

package/dist/iban.vo.js

@@ -1,23 +1,16 @@
-import { z } from "zod/v4";
-export const IBANError = { error: "invalid.iban.format" };
-// 2-letter country code + 2 digits + 11–30 alphanumerics (overall 15–34 chars)
-const IBAN_REGEX = /^[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}$/;
-export const IBANValue = z
-    .string(IBANError)
-    .trim()
-    .toUpperCase()
-    .transform((val) => val.replace(/\s+/g, ""))
-    .refine((iban) => IBAN_REGEX.test(iban), IBANError)
-    .brand("IBAN");
+import { IbanSchema } from "./iban-schema.vo";
 export class IBAN {
     value;
-    constructor(value) {
-        this.value = IBANValue.parse(value);
+    constructor(candidate) {
+        this.value = IbanSchema.parse(candidate);
     }
     toString() {
         return this.value;
     }
     format() {
+        // (.{4}) - capture any four characters
+        // (?=.) - positive lookahead, at least one more character after the match
+        // "$1 " - replace each match with the group and a space
         return this.value.replace(/(.{4})(?=.)/g, "$1 ");
     }
     get countryCode() {

package/dist/image.vo.d.ts

@@ -1,11 +1,13 @@
 import { z } from "zod/v4";
 export declare const ImageWidthError: {
-    readonly error: "invalid.image.width";
+    readonly Type: "image.width.type";
+    readonly Length: "image.width.length";
 };
 export declare const ImageHeightError: {
-    readonly error: "invalid.image.height";
+    readonly Type: "image.height.type";
+    readonly Length: "image.height.length";
 };
-export declare const ImageWidth: z.core.$ZodBranded<z.ZodNumber, "image-width">;
+export declare const ImageWidth: z.core.$ZodBranded<z.ZodNumber, "ImageWidth">;
 export type ImageWidthType = z.infer<typeof ImageWidth>;
-export declare const ImageHeight: z.core.$ZodBranded<z.ZodNumber, "image-height">;
+export declare const ImageHeight: z.core.$ZodBranded<z.ZodNumber, "ImageHeight">;
 export type ImageHeightType = z.infer<typeof ImageHeight>;

package/dist/image.vo.js

@@ -1,15 +1,16 @@
 import { z } from "zod/v4";
-export const ImageWidthError = { error: "invalid.image.width" };
-export const ImageHeightError = { error: "invalid.image.height" };
+export const ImageWidthError = { Type: "image.width.type", Length: "image.width.length" };
+export const ImageHeightError = { Type: "image.height.type", Length: "image.height.length" };
+const IMAGE_DIMENSIONS_CONSTRAINTS = { min: 1, max: 10_000 };
 export const ImageWidth = z
-    .number(ImageWidthError)
-    .int(ImageWidthError)
-    .positive(ImageWidthError)
-    .max(10_000, ImageWidthError)
-    .brand("image-width");
+    .number(ImageWidthError.Type)
+    .int(ImageWidthError.Type)
+    .min(IMAGE_DIMENSIONS_CONSTRAINTS.min, ImageWidthError.Length)
+    .max(IMAGE_DIMENSIONS_CONSTRAINTS.max, ImageWidthError.Length)
+    .brand("ImageWidth");
 export const ImageHeight = z
-    .number(ImageHeightError)
-    .int(ImageHeightError)
-    .positive(ImageHeightError)
-    .max(10_000, ImageHeightError)
-    .brand("image-height");
+    .number(ImageHeightError.Type)
+    .int(ImageHeightError.Type)
+    .min(IMAGE_DIMENSIONS_CONSTRAINTS.min, ImageHeightError.Length)
+    .max(IMAGE_DIMENSIONS_CONSTRAINTS.max, ImageHeightError.Length)
+    .brand("ImageHeight");

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 export * from "./age.vo";
+export * from "./age-years.vo";
 export * from "./api-key.vo";
 export * from "./basename.vo";
 export * from "./clock.vo";
+export * from "./clock-format.service";
 export * from "./date-calculator.service";
 export * from "./date-formatter.service";
 export * from "./date-range.vo";
@@ -9,12 +11,15 @@ export * from "./day.vo";
 export * from "./day-iso-id.vo";
 export * from "./directory-path-absolute.vo";
 export * from "./directory-path-relative.vo";
+export * from "./division-factor.vo";
 export * from "./dll.service";
 export * from "./duration.service";
+export * from "./duration-ms.vo";
 export * from "./email-mask.service";
 export * from "./etags.vo";
 export * from "./extension.vo";
 export * from "./feature-flag.vo";
+export * from "./feature-flag-value.vo";
 export * from "./file-path.vo";
 export * from "./file-path-absolute-schema.vo";
 export * from "./file-path-relative-schema.vo";
@@ -22,25 +27,39 @@ export * from "./filename.vo";
 export * from "./filename-from-string.vo";
 export * from "./filename-suffix.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 "./iban.vo";
 export * from "./iban-mask.service";
+export * from "./iban-schema.vo";
 export * from "./image.vo";
+export * from "./index";
 export * from "./language.vo";
+export * from "./linear-regression.service";
 export * from "./mean.service";
 export * from "./mime.vo";
 export * from "./mime-types.vo";
+export * from "./mime-value.vo";
 export * from "./min-max-scaler.service";
 export * from "./minute.vo";
+export * from "./minute-schema.vo";
 export * from "./money.vo";
+export * from "./money-amount.vo";
 export * from "./month.vo";
 export * from "./month-iso-id.vo";
+export * from "./multiplication-factor.vo";
 export * from "./noop.service";
 export * from "./notification-template.vo";
 export * from "./object-key.vo";
 export * from "./outlier-detector.service";
 export * from "./package-version.vo";
+export * from "./package-version-schema.vo";
 export * from "./pagination.service";
+export * from "./pagination-page.vo";
+export * from "./pagination-skip.vo";
+export * from "./pagination-take.vo";
 export * from "./percentage.service";
 export * from "./population-standard-deviation.service";
 export * from "./quarter.vo";
@@ -49,15 +68,17 @@ export * from "./random.service";
 export * from "./rate-limiter.service";
 export * from "./relative-date.vo";
 export * from "./reordering.service";
+export * from "./reordering-item-position-value.vo";
 export * from "./revision.vo";
+export * from "./revision-value.vo";
 export * from "./rounding.adapter";
 export * from "./rounding.port";
-export * from "./simple-linear-regression.service";
 export * from "./size.vo";
+export * from "./size-bytes.vo";
 export * from "./stopwatch.service";
-export * from "./streak-calculator.service";
 export * from "./sum.service";
 export * from "./thousands-separator.service";
+export * from "./time.service";
 export * from "./time-zone-offset-value.vo";
 export * from "./timestamp.vo";
 export * from "./timezone.vo";
@@ -67,6 +88,7 @@ export * from "./week.vo";
 export * from "./week-iso-id.vo";
 export * from "./weekday.vo";
 export * from "./weight.vo";
+export * from "./weight-grams.vo";
 export * from "./year.vo";
 export * from "./year-iso-id.vo";
 export * from "./z-score.service";

package/dist/index.js

@@ -1,7 +1,9 @@
 export * from "./age.vo";
+export * from "./age-years.vo";
 export * from "./api-key.vo";
 export * from "./basename.vo";
 export * from "./clock.vo";
+export * from "./clock-format.service";
 export * from "./date-calculator.service";
 export * from "./date-formatter.service";
 export * from "./date-range.vo";
@@ -9,12 +11,15 @@ export * from "./day.vo";
 export * from "./day-iso-id.vo";
 export * from "./directory-path-absolute.vo";
 export * from "./directory-path-relative.vo";
+export * from "./division-factor.vo";
 export * from "./dll.service";
 export * from "./duration.service";
+export * from "./duration-ms.vo";
 export * from "./email-mask.service";
 export * from "./etags.vo";
 export * from "./extension.vo";
 export * from "./feature-flag.vo";
+export * from "./feature-flag-value.vo";
 export * from "./file-path.vo";
 export * from "./file-path-absolute-schema.vo";
 export * from "./file-path-relative-schema.vo";
@@ -22,25 +27,39 @@ export * from "./filename.vo";
 export * from "./filename-from-string.vo";
 export * from "./filename-suffix.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 "./iban.vo";
 export * from "./iban-mask.service";
+export * from "./iban-schema.vo";
 export * from "./image.vo";
+export * from "./index";
 export * from "./language.vo";
+export * from "./linear-regression.service";
 export * from "./mean.service";
 export * from "./mime.vo";
 export * from "./mime-types.vo";
+export * from "./mime-value.vo";
 export * from "./min-max-scaler.service";
 export * from "./minute.vo";
+export * from "./minute-schema.vo";
 export * from "./money.vo";
+export * from "./money-amount.vo";
 export * from "./month.vo";
 export * from "./month-iso-id.vo";
+export * from "./multiplication-factor.vo";
 export * from "./noop.service";
 export * from "./notification-template.vo";
 export * from "./object-key.vo";
 export * from "./outlier-detector.service";
 export * from "./package-version.vo";
+export * from "./package-version-schema.vo";
 export * from "./pagination.service";
+export * from "./pagination-page.vo";
+export * from "./pagination-skip.vo";
+export * from "./pagination-take.vo";
 export * from "./percentage.service";
 export * from "./population-standard-deviation.service";
 export * from "./quarter.vo";
@@ -49,15 +68,17 @@ export * from "./random.service";
 export * from "./rate-limiter.service";
 export * from "./relative-date.vo";
 export * from "./reordering.service";
+export * from "./reordering-item-position-value.vo";
 export * from "./revision.vo";
+export * from "./revision-value.vo";
 export * from "./rounding.adapter";
 export * from "./rounding.port";
-export * from "./simple-linear-regression.service";
 export * from "./size.vo";
+export * from "./size-bytes.vo";
 export * from "./stopwatch.service";
-export * from "./streak-calculator.service";
 export * from "./sum.service";
 export * from "./thousands-separator.service";
+export * from "./time.service";
 export * from "./time-zone-offset-value.vo";
 export * from "./timestamp.vo";
 export * from "./timezone.vo";
@@ -67,6 +88,7 @@ export * from "./week.vo";
 export * from "./week-iso-id.vo";
 export * from "./weekday.vo";
 export * from "./weight.vo";
+export * from "./weight-grams.vo";
 export * from "./year.vo";
 export * from "./year-iso-id.vo";
 export * from "./z-score.service";

package/dist/language.vo.d.ts

@@ -1,6 +1,7 @@
 import { z } from "zod/v4";
 export declare const LanguageError: {
-    readonly error: "invalid.language";
+    readonly Type: "language.type";
+    readonly BadChars: "language.bad.chars";
 };
 export declare const Language: z.ZodString;
 export type LanguageType = z.infer<typeof Language>;

package/dist/language.vo.js

@@ -1,6 +1,8 @@
 import { z } from "zod/v4";
-export const LanguageError = { error: "invalid.language" };
+export const LanguageError = { Type: "language.type", BadChars: "language.bad.chars" };
+// Two lowercase letters
+const LANGUAGE_CHARS_WHITELIST = /^[a-z]{2}$/;
 export const Language = z
-    .string(LanguageError)
-    .length(2, LanguageError)
-    .regex(/^[a-z]{2}$/, LanguageError);
+    .string(LanguageError.Type)
+    .toLowerCase()
+    .regex(LANGUAGE_CHARS_WHITELIST, LanguageError.BadChars);

package/dist/linear-regression.service.d.ts

@@ -0,0 +1,27 @@
+import type { RoundingPort } from "./rounding.port";
+export type LinearRegressionPairType = {
+    x: number;
+    y: number;
+};
+export type LinearRegressionParamsType = {
+    a: number;
+    b: number;
+};
+export type LinearRegressionPredictionType = number;
+export declare const LinearRegressionError: {
+    readonly MinPairs: "linear.regression.min.pairs";
+    readonly SumXTooBig: "linear.regression.sum.x.too.big";
+    readonly SumYTooBig: "linear.regression.sum.y.too.big";
+    readonly SumXSquaredTooBig: "linear.regression.sum.x.squared.too.big";
+    readonly SumXTimesYTooBig: "linear.regression.sum.x.times.y.too.big";
+    readonly ModelCreation: "linear.regression.model.creation";
+};
+export declare class LinearRegression {
+    private static readonly DEFAULT_ROUNDING;
+    private readonly params;
+    private readonly rounding;
+    constructor(params: LinearRegressionParamsType, rounding?: RoundingPort);
+    static fromPairs(pairs: LinearRegressionPairType[], rounding?: RoundingPort): LinearRegression;
+    predict(x: LinearRegressionPairType["x"], rounding?: RoundingPort): LinearRegressionPredictionType;
+    inspect(): LinearRegression["params"];
+}