@bgord/tools 0.12.25 → 0.13.0

package/src/weekday.vo.ts

@@ -0,0 +1,113 @@
+import type { TimestampType } from "./timestamp.vo";
+
+export type WeekdayFormatter = (value: Weekday["value"]) => string;
+
+export enum WeekdayFormatterEnum {
+  FULL = "FULL", // "Sunday"
+  SHORT = "SHORT", // "Sun"
+  ISO_NUMBER = "ISO_NUMBER", // Monday=1 ... Sunday=7
+  ZERO_BASED_NUMBER = "ZERO_BASED_NUMBER", // Sunday=0 ... Saturday=6 (JS)
+}
+
+const FULL_NAMES: readonly string[] = [
+  "Sunday",
+  "Monday",
+  "Tuesday",
+  "Wednesday",
+  "Thursday",
+  "Friday",
+  "Saturday",
+] as const;
+
+const SHORT_NAMES: readonly string[] = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"] as const;
+
+export const WeekdayFormatters: Record<WeekdayFormatterEnum, WeekdayFormatter> = {
+  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
+} as const;
+
+export class Weekday {
+  private readonly value: number;
+
+  private readonly formatter: WeekdayFormatter;
+
+  static readonly SUNDAY = new Weekday(0);
+  static readonly MONDAY = new Weekday(1);
+  static readonly TUESDAY = new Weekday(2);
+  static readonly WEDNESDAY = new Weekday(3);
+  static readonly THURSDAY = new Weekday(4);
+  static readonly FRIDAY = new Weekday(5);
+  static readonly SATURDAY = new Weekday(6);
+
+  constructor(candidate: number, formatter?: WeekdayFormatter) {
+    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 as WeekdayFormatter) ?? WeekdayFormatters.FULL;
+  }
+
+  static fromUtcTimestamp(timestamp: TimestampType, formatter?: WeekdayFormatter): Weekday {
+    const day = new Date(timestamp).getUTCDay(); // 0..6
+    return new Weekday(day, formatter);
+  }
+
+  get(formatter?: WeekdayFormatter) {
+    const format = formatter ?? this.formatter;
+    return { raw: this.value, formatted: format(this.value) };
+  }
+
+  equals(another: Weekday): boolean {
+    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;
+  }
+  isTuesday(): boolean {
+    return this.value === 2;
+  }
+  isWednesday(): boolean {
+    return this.value === 3;
+  }
+  isThursday(): boolean {
+    return this.value === 4;
+  }
+  isFriday(): boolean {
+    return this.value === 5;
+  }
+  isSaturday(): boolean {
+    return this.value === 6;
+  }
+  isSunday(): boolean {
+    return this.value === 0;
+  }
+
+  static list(formatter?: WeekdayFormatter): Weekday[] {
+    return Array.from({ length: 7 }).map((_, index) => new Weekday(index, formatter));
+  }
+
+  static listMondayFirst(formatter?: WeekdayFormatter): Weekday[] {
+    const days = Weekday.list(formatter);
+    return [...days.slice(1), days[0]];
+  }
+}

package/src/z-score.service.ts

@@ -10,9 +10,7 @@ export class ZScore {
     values: number[],
     private readonly rounding: RoundingStrategy = new RoundToDecimal(2),
   ) {
-    if (values.length < 2) {
-      throw new Error("At least two values are needed");
-    }
+    if (values.length < 2) throw new Error("At least two values are needed");
 
     this.mean = Mean.calculate(values);
     this.standardDeviation = PopulationStandardDeviation.calculate(values);

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

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

package/dist/build-version.vo.js

@@ -1,2 +0,0 @@
-import { z } from "zod/v4";
-export const BuildVersion = z.string().min(1).max(8).brand("BuildVersion");

package/dist/filter.vo.d.ts

@@ -1,17 +0,0 @@
-import type { z } from "zod/v4";
-export type DefaultFilterSchemaType = z.ZodRawShape;
-export type FilterValuesType = Record<string, unknown>;
-export type FilterSchemaType<T extends DefaultFilterSchemaType> = z.ZodObject<T>;
-export type FilterParseConfigType<T extends DefaultFilterSchemaType> = {
-    schema: FilterSchemaType<T>;
-    values: FilterValuesType;
-};
-export declare class Filter<T extends DefaultFilterSchemaType> {
-    private readonly schema;
-    constructor(schema: FilterSchemaType<T>);
-    parse(values: FilterValuesType): z.core.$InferObjectOutput<T, {}> | undefined;
-    default(): z.core.$InferObjectOutput<T, {}> | undefined;
-    static parse<T extends DefaultFilterSchemaType>(config: FilterParseConfigType<T>): z.core.$InferObjectOutput<T, {}> | undefined;
-    static default<T extends DefaultFilterSchemaType>(config: Omit<FilterParseConfigType<T>, "values">): z.core.$InferObjectOutput<T, {}> | undefined;
-    private static _parse;
-}

package/dist/filter.vo.js

@@ -1,22 +0,0 @@
-export class Filter {
-    schema;
-    constructor(schema) {
-        this.schema = schema;
-    }
-    parse(values) {
-        return Filter._parse({ schema: this.schema, values });
-    }
-    default() {
-        return this.parse({});
-    }
-    static parse(config) {
-        return Filter._parse(config);
-    }
-    static default(config) {
-        return Filter._parse({ schema: config.schema, values: {} });
-    }
-    static _parse(config) {
-        const result = config.schema.safeParse(config.values);
-        return result.success ? result.data : undefined;
-    }
-}

package/src/build-version.vo.ts

@@ -1,5 +0,0 @@
-import { z } from "zod/v4";
-
-export const BuildVersion = z.string().min(1).max(8).brand("BuildVersion");
-
-export type BuildVersionType = z.infer<typeof BuildVersion>;

package/src/filter.vo.ts

@@ -1,38 +0,0 @@
-import type { z } from "zod/v4";
-
-export type DefaultFilterSchemaType = z.ZodRawShape;
-
-export type FilterValuesType = Record<string, unknown>;
-
-export type FilterSchemaType<T extends DefaultFilterSchemaType> = z.ZodObject<T>;
-
-export type FilterParseConfigType<T extends DefaultFilterSchemaType> = {
-  schema: FilterSchemaType<T>;
-  values: FilterValuesType;
-};
-
-export class Filter<T extends DefaultFilterSchemaType> {
-  constructor(private readonly schema: FilterSchemaType<T>) {}
-
-  parse(values: FilterValuesType) {
-    return Filter._parse({ schema: this.schema, values });
-  }
-
-  default() {
-    return this.parse({});
-  }
-
-  static parse<T extends DefaultFilterSchemaType>(config: FilterParseConfigType<T>) {
-    return Filter._parse(config);
-  }
-
-  static default<T extends DefaultFilterSchemaType>(config: Omit<FilterParseConfigType<T>, "values">) {
-    return Filter._parse({ schema: config.schema, values: {} });
-  }
-
-  private static _parse<T extends DefaultFilterSchemaType>(config: FilterParseConfigType<T>) {
-    const result = config.schema.safeParse(config.values);
-
-    return result.success ? result.data : undefined;
-  }
-}