@bgord/tools 0.12.6 → 0.12.8

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

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

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

@@ -0,0 +1,10 @@
+import { isValid, parseISO } from "date-fns";
+import { z } from "zod/v4";
+export const DayIsoId = z
+    .string()
+    // 4-digit year, 2-digit month, 2-digit day
+    .regex(/^\d{4}-\d{2}-\d{2}$/)
+    .refine((value) => {
+    const date = parseISO(value);
+    return isValid(date) && value === date.toISOString().slice(0, 10);
+}, { message: "day-iso-id.invalid" });

package/dist/day.vo.d.ts

@@ -0,0 +1,10 @@
+import { DateRange } from "./date-range.vo";
+import { DayIsoIdType } from "./day-iso-id.vo";
+import { TimestampType } from "./timestamp.vo";
+export declare class Day extends DateRange {
+    private constructor();
+    toIsoId(): DayIsoIdType;
+    static fromTimestamp(timestamp: TimestampType): Day;
+    static fromNow(now?: TimestampType): Day;
+    static fromIsoId(isoId: DayIsoIdType): Day;
+}

package/dist/day.vo.js

@@ -0,0 +1,25 @@
+import { endOfDay, startOfDay } from "date-fns";
+import { DateRange } from "./date-range.vo";
+import { DayIsoId } from "./day-iso-id.vo";
+import { Timestamp } from "./timestamp.vo";
+export class Day extends DateRange {
+    constructor(start, end) {
+        super(start, end);
+    }
+    toIsoId() {
+        return new Date(this.getStart()).toISOString().slice(0, 10);
+    }
+    static fromTimestamp(timestamp) {
+        const start = Timestamp.parse(startOfDay(timestamp).getTime());
+        const end = Timestamp.parse(endOfDay(timestamp).getTime());
+        return new Day(start, end);
+    }
+    static fromNow(now = Timestamp.parse(Date.now())) {
+        return Day.fromTimestamp(now);
+    }
+    static fromIsoId(isoId) {
+        const [year, month, day] = DayIsoId.parse(isoId).split("-").map(Number);
+        const reference = new Date(Date.UTC(year, month - 1, day));
+        return Day.fromTimestamp(Timestamp.parse(reference.getTime()));
+    }
+}

package/dist/index.d.ts

@@ -5,6 +5,8 @@ export * from "./date-calculator.service";
 export * from "./date-formatter.service";
 export * from "./date-range.vo";
 export * from "./dates-of-the-week.vo";
+export * from "./day.vo";
+export * from "./day-iso-id.vo";
 export * from "./dll.service";
 export * from "./email-mask.service";
 export * from "./etags.vo";

package/dist/index.js

@@ -5,6 +5,8 @@ export * from "./date-calculator.service";
 export * from "./date-formatter.service";
 export * from "./date-range.vo";
 export * from "./dates-of-the-week.vo";
+export * from "./day.vo";
+export * from "./day-iso-id.vo";
 export * from "./dll.service";
 export * from "./email-mask.service";
 export * from "./etags.vo";

package/dist/time.service.d.ts

@@ -1,9 +1,10 @@
+import type { TimestampType } from "./timestamp.vo";
 interface TimeResultInterface {
     readonly days: number;
     readonly hours: number;
     readonly minutes: number;
     readonly seconds: number;
-    readonly ms: number;
+    readonly ms: TimestampType;
     isAfter(another: TimeResultInterface): boolean;
     isBefore(another: TimeResultInterface): boolean;
 }
@@ -12,8 +13,8 @@ export declare class TimeResult implements TimeResultInterface {
     readonly hours: number;
     readonly minutes: number;
     readonly seconds: number;
-    readonly ms: number;
-    constructor(days: number, hours: number, minutes: number, seconds: number, ms: number);
+    readonly ms: TimestampType;
+    constructor(days: number, hours: number, minutes: number, seconds: number, ms: TimestampType);
     isAfter(another: TimeResultInterface): boolean;
     isBefore(another: TimeResultInterface): boolean;
 }
@@ -24,6 +25,7 @@ export declare class Time {
     static Seconds(value: number): TimeResultInterface;
     static Ms(value: number): TimeResultInterface;
     static Now(now?: number): {
+        value: TimestampType;
         Minus(time: TimeResultInterface): TimeResultInterface;
         Add(time: TimeResultInterface): TimeResultInterface;
     };

package/dist/time.service.js

@@ -22,22 +22,23 @@ export class TimeResult {
 }
 export class Time {
     static Days(value) {
-        return new TimeResult(value, value * 24, value * 24 * 60, value * 24 * 60 * 60, value * 24 * 60 * 60 * 1000);
+        return new TimeResult(value, value * 24, value * 24 * 60, value * 24 * 60 * 60, (value * 24 * 60 * 60 * 1000));
     }
     static Hours(value) {
-        return new TimeResult(rounding.round(value / 24), value, value * 60, value * 60 * 60, value * 60 * 60 * 1000);
+        return new TimeResult(rounding.round(value / 24), value, value * 60, value * 60 * 60, (value * 60 * 60 * 1000));
     }
     static Minutes(value) {
-        return new TimeResult(rounding.round(value / 60 / 24), rounding.round(value / 60), value, value * 60, value * 60 * 1000);
+        return new TimeResult(rounding.round(value / 60 / 24), rounding.round(value / 60), value, value * 60, (value * 60 * 1000));
     }
     static Seconds(value) {
-        return new TimeResult(rounding.round(value / 60 / 60 / 24), rounding.round(value / 60 / 60), rounding.round(value / 60), value, value * 1000);
+        return new TimeResult(rounding.round(value / 60 / 60 / 24), rounding.round(value / 60 / 60), rounding.round(value / 60), value, (value * 1000));
     }
     static Ms(value) {
         return new TimeResult(rounding.round(value / 1000 / 60 / 60 / 24), rounding.round(value / 1000 / 60 / 60), rounding.round(value / 1000 / 60), rounding.round(value / 1000), value);
     }
     static Now(now = Date.now()) {
         return {
+            value: now,
             Minus(time) {
                 return Time.Ms(now - time.ms);
             },

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/api-key.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/dll.service.ts","../src/email-mask.service.ts","../src/etags.vo.ts","../src/feature-flag.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/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/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/dll.service.ts","../src/email-mask.service.ts","../src/etags.vo.ts","../src/feature-flag.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/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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/tools",
-  "version": "0.12.6",
+  "version": "0.12.8",
   "type": "module",
   "license": "MIT",
   "author": "Bartosz Gordon",

package/readme.md

@@ -31,6 +31,8 @@ src/
 ├── date-formatter.service.ts
 ├── date-range.vo.ts
 ├── dates-of-the-week.vo.ts
+├── day-iso-id.vo.ts
+├── day.vo.ts
 ├── dll.service.ts
 ├── email-mask.service.ts
 ├── etags.vo.ts

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

@@ -0,0 +1,16 @@
+import { isValid, parseISO } from "date-fns";
+import { z } from "zod/v4";
+
+export const DayIsoId = z
+  .string()
+  // 4-digit year, 2-digit month, 2-digit day
+  .regex(/^\d{4}-\d{2}-\d{2}$/)
+  .refine(
+    (value) => {
+      const date = parseISO(value);
+      return isValid(date) && value === date.toISOString().slice(0, 10);
+    },
+    { message: "day-iso-id.invalid" },
+  );
+
+export type DayIsoIdType = z.infer<typeof DayIsoId>;

package/src/day.vo.ts

@@ -0,0 +1,31 @@
+import { endOfDay, startOfDay } from "date-fns";
+import { DateRange } from "./date-range.vo";
+import { DayIsoId, DayIsoIdType } from "./day-iso-id.vo";
+import { Timestamp, TimestampType } from "./timestamp.vo";
+
+export class Day extends DateRange {
+  private constructor(start: TimestampType, end: TimestampType) {
+    super(start, end);
+  }
+
+  toIsoId(): DayIsoIdType {
+    return new Date(this.getStart()).toISOString().slice(0, 10) as DayIsoIdType;
+  }
+
+  static fromTimestamp(timestamp: TimestampType): Day {
+    const start = Timestamp.parse(startOfDay(timestamp).getTime());
+    const end = Timestamp.parse(endOfDay(timestamp).getTime());
+    return new Day(start, end);
+  }
+
+  static fromNow(now: TimestampType = Timestamp.parse(Date.now())): Day {
+    return Day.fromTimestamp(now);
+  }
+
+  static fromIsoId(isoId: DayIsoIdType): Day {
+    const [year, month, day] = DayIsoId.parse(isoId).split("-").map(Number);
+
+    const reference = new Date(Date.UTC(year, month - 1, day));
+    return Day.fromTimestamp(Timestamp.parse(reference.getTime()));
+  }
+}

package/src/index.ts

@@ -5,6 +5,8 @@ export * from "./date-calculator.service";
 export * from "./date-formatter.service";
 export * from "./date-range.vo";
 export * from "./dates-of-the-week.vo";
+export * from "./day.vo";
+export * from "./day-iso-id.vo";
 export * from "./dll.service";
 export * from "./email-mask.service";
 export * from "./etags.vo";

package/src/time.service.ts

@@ -1,4 +1,5 @@
 import { RoundToDecimal } from "./rounding.service";
+import type { TimestampType } from "./timestamp.vo";
 
 const rounding = new RoundToDecimal(2);
 
@@ -7,7 +8,7 @@ interface TimeResultInterface {
   readonly hours: number;
   readonly minutes: number;
   readonly seconds: number;
-  readonly ms: number;
+  readonly ms: TimestampType;
 
   isAfter(another: TimeResultInterface): boolean;
   isBefore(another: TimeResultInterface): boolean;
@@ -19,7 +20,7 @@ export class TimeResult implements TimeResultInterface {
     readonly hours: number,
     readonly minutes: number,
     readonly seconds: number,
-    readonly ms: number,
+    readonly ms: TimestampType,
   ) {}
 
   isAfter(another: TimeResultInterface): boolean {
@@ -38,7 +39,7 @@ export class Time {
       value * 24,
       value * 24 * 60,
       value * 24 * 60 * 60,
-      value * 24 * 60 * 60 * 1000,
+      (value * 24 * 60 * 60 * 1000) as TimestampType,
     );
   }
 
@@ -48,7 +49,7 @@ export class Time {
       value,
       value * 60,
       value * 60 * 60,
-      value * 60 * 60 * 1000,
+      (value * 60 * 60 * 1000) as TimestampType,
     );
   }
 
@@ -58,7 +59,7 @@ export class Time {
       rounding.round(value / 60),
       value,
       value * 60,
-      value * 60 * 1000,
+      (value * 60 * 1000) as TimestampType,
     );
   }
 
@@ -68,7 +69,7 @@ export class Time {
       rounding.round(value / 60 / 60),
       rounding.round(value / 60),
       value,
-      value * 1000,
+      (value * 1000) as TimestampType,
     );
   }
 
@@ -78,12 +79,14 @@ export class Time {
       rounding.round(value / 1000 / 60 / 60),
       rounding.round(value / 1000 / 60),
       rounding.round(value / 1000),
-      value,
+      value as TimestampType,
     );
   }
 
   static Now(now = Date.now()) {
     return {
+      value: now as TimestampType,
+
       Minus(time: TimeResultInterface): TimeResultInterface {
         return Time.Ms(now - time.ms);
       },