@bgord/tools 0.12.1 → 0.12.3

package/dist/date-range.vo.d.ts

@@ -0,0 +1,11 @@
+import { TimestampType } from "./timestamp.vo";
+export declare class DateRange {
+    private readonly start;
+    private readonly end;
+    constructor(start: TimestampType, end: TimestampType);
+    getStart(): TimestampType;
+    getEnd(): TimestampType;
+    toRange(): [TimestampType, TimestampType];
+    contains(timestamp: TimestampType): boolean;
+    equals(other: DateRange): boolean;
+}

package/dist/date-range.vo.js

@@ -0,0 +1,25 @@
+export class DateRange {
+    start;
+    end;
+    constructor(start, end) {
+        this.start = start;
+        this.end = end;
+        if (start > end)
+            throw new Error("Invalid date range");
+    }
+    getStart() {
+        return this.start;
+    }
+    getEnd() {
+        return this.end;
+    }
+    toRange() {
+        return [this.start, this.end];
+    }
+    contains(timestamp) {
+        return timestamp >= this.start && timestamp <= this.end;
+    }
+    equals(other) {
+        return this.start === other.start && this.end === other.end;
+    }
+}

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from "./build-version.vo";
 export * from "./clock.vo";
 export * from "./date-calculator.service";
 export * from "./date-formatter.service";
+export * from "./date-range.vo";
 export * from "./dates-of-the-week.vo";
 export * from "./dll.service";
 export * from "./email-mask.service";
@@ -46,4 +47,5 @@ export * from "./timestamp.vo";
 export * from "./timezone.vo";
 export * from "./ts-utils";
 export * from "./visually-unambiguous-characters-generator.service";
+export * from "./week.vo";
 export * from "./z-score.service";

package/dist/index.js

@@ -3,6 +3,7 @@ export * from "./build-version.vo";
 export * from "./clock.vo";
 export * from "./date-calculator.service";
 export * from "./date-formatter.service";
+export * from "./date-range.vo";
 export * from "./dates-of-the-week.vo";
 export * from "./dll.service";
 export * from "./email-mask.service";
@@ -46,4 +47,5 @@ export * from "./timestamp.vo";
 export * from "./timezone.vo";
 export * from "./ts-utils";
 export * from "./visually-unambiguous-characters-generator.service";
+export * from "./week.vo";
 export * from "./z-score.service";

package/dist/timestamp.vo.d.ts

@@ -1,3 +1,3 @@
 import { z } from "zod/v4";
-export declare const Timestamp: z.core.$ZodBranded<z.ZodDefault<z.ZodNumber>, "Timestamp">;
+export declare const Timestamp: z.core.$ZodBranded<z.ZodNumber, "Timestamp">;
 export type TimestampType = z.infer<typeof Timestamp>;

package/dist/timestamp.vo.js

@@ -1,7 +1,2 @@
 import { z } from "zod/v4";
-export const Timestamp = z
-    .number()
-    .int()
-    .gte(0)
-    .default(() => Date.now())
-    .brand("Timestamp");
+export const Timestamp = z.number().int().gte(0).brand("Timestamp");

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/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/z-score.service.ts"],"version":"5.8.3"}
+{"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.vo.ts","../src/z-score.service.ts"],"version":"5.8.3"}

package/dist/week.vo.d.ts

@@ -0,0 +1,9 @@
+import { DateRange } from "./date-range.vo";
+import { TimestampType } from "./timestamp.vo";
+export declare class Week extends DateRange {
+    constructor(start: TimestampType, end: TimestampType);
+    toIsoId(): string;
+    static fromTimestamp(timestamp: TimestampType): Week;
+    static fromNow(now?: TimestampType): Week;
+    static fromIsoId(isoId: string): Week;
+}

package/dist/week.vo.js

@@ -0,0 +1,29 @@
+import { endOfISOWeek, getISOWeek, getISOWeekYear, setISOWeek, startOfISOWeek } from "date-fns";
+import { DateRange } from "./date-range.vo";
+import { Timestamp } from "./timestamp.vo";
+export class Week extends DateRange {
+    constructor(start, end) {
+        super(start, end);
+    }
+    toIsoId() {
+        const year = getISOWeekYear(this.getStart());
+        const week = getISOWeek(this.getStart()).toString().padStart(2, "0");
+        return `${year}-W${week}`;
+    }
+    static fromTimestamp(timestamp) {
+        const start = Timestamp.parse(startOfISOWeek(timestamp).getTime());
+        const end = Timestamp.parse(endOfISOWeek(timestamp).getTime());
+        return new Week(start, end);
+    }
+    static fromNow(now = Timestamp.parse(Date.now())) {
+        return Week.fromTimestamp(now);
+    }
+    static fromIsoId(isoId) {
+        const [yearPart, weekPart] = isoId.split("-W");
+        const year = Number(yearPart);
+        const week = Number(weekPart);
+        // ISO-8601 rule: Jan 4 is always in week 01 of the ISO week-year.
+        const reference = setISOWeek(new Date(Date.UTC(year, 0, 4)), week);
+        return Week.fromTimestamp(Timestamp.parse(reference.getTime()));
+    }
+}

package/package.json

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

package/readme.md

@@ -29,6 +29,7 @@ src/
 ├── clock.vo.ts
 ├── date-calculator.service.ts
 ├── date-formatter.service.ts
+├── date-range.vo.ts
 ├── dates-of-the-week.vo.ts
 ├── dll.service.ts
 ├── email-mask.service.ts
@@ -72,6 +73,7 @@ src/
 ├── timezone.vo.ts
 ├── ts-utils.ts
 ├── visually-unambiguous-characters-generator.service.ts
+├── week.vo.ts
 └── z-score.service.ts
 ```
 

package/src/date-range.vo.ts

@@ -0,0 +1,30 @@
+import { TimestampType } from "./timestamp.vo";
+
+export class DateRange {
+  constructor(
+    private readonly start: TimestampType,
+    private readonly end: TimestampType,
+  ) {
+    if (start > end) throw new Error("Invalid date range");
+  }
+
+  getStart(): TimestampType {
+    return this.start;
+  }
+
+  getEnd(): TimestampType {
+    return this.end;
+  }
+
+  toRange(): [TimestampType, TimestampType] {
+    return [this.start, this.end];
+  }
+
+  contains(timestamp: TimestampType): boolean {
+    return timestamp >= this.start && timestamp <= this.end;
+  }
+
+  equals(other: DateRange): boolean {
+    return this.start === other.start && this.end === other.end;
+  }
+}

package/src/index.ts

@@ -3,6 +3,7 @@ export * from "./build-version.vo";
 export * from "./clock.vo";
 export * from "./date-calculator.service";
 export * from "./date-formatter.service";
+export * from "./date-range.vo";
 export * from "./dates-of-the-week.vo";
 export * from "./dll.service";
 export * from "./email-mask.service";
@@ -46,4 +47,5 @@ export * from "./timestamp.vo";
 export * from "./timezone.vo";
 export * from "./ts-utils";
 export * from "./visually-unambiguous-characters-generator.service";
+export * from "./week.vo";
 export * from "./z-score.service";

package/src/timestamp.vo.ts

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

package/src/week.vo.ts

@@ -0,0 +1,39 @@
+import { endOfISOWeek, getISOWeek, getISOWeekYear, setISOWeek, startOfISOWeek } from "date-fns";
+import { DateRange } from "./date-range.vo";
+import { Timestamp, TimestampType } from "./timestamp.vo";
+
+export class Week extends DateRange {
+  constructor(start: TimestampType, end: TimestampType) {
+    super(start, end);
+  }
+
+  toIsoId(): string {
+    const year = getISOWeekYear(this.getStart());
+    const week = getISOWeek(this.getStart()).toString().padStart(2, "0");
+
+    return `${year}-W${week}`;
+  }
+
+  static fromTimestamp(timestamp: TimestampType): Week {
+    const start = Timestamp.parse(startOfISOWeek(timestamp).getTime());
+    const end = Timestamp.parse(endOfISOWeek(timestamp).getTime());
+
+    return new Week(start, end);
+  }
+
+  static fromNow(now: TimestampType = Timestamp.parse(Date.now())): Week {
+    return Week.fromTimestamp(now);
+  }
+
+  static fromIsoId(isoId: string): Week {
+    const [yearPart, weekPart] = isoId.split("-W");
+
+    const year = Number(yearPart);
+    const week = Number(weekPart);
+
+    // ISO-8601 rule: Jan 4 is always in week 01 of the ISO week-year.
+    const reference = setISOWeek(new Date(Date.UTC(year, 0, 4)), week);
+
+    return Week.fromTimestamp(Timestamp.parse(reference.getTime()));
+  }
+}