@bgord/tools 0.12.3 → 0.12.4

package/dist/index.d.ts

@@ -48,4 +48,5 @@ export * from "./timezone.vo";
 export * from "./ts-utils";
 export * from "./visually-unambiguous-characters-generator.service";
 export * from "./week.vo";
+export * from "./week-iso-id.vo";
 export * from "./z-score.service";

package/dist/index.js

@@ -48,4 +48,5 @@ export * from "./timezone.vo";
 export * from "./ts-utils";
 export * from "./visually-unambiguous-characters-generator.service";
 export * from "./week.vo";
+export * from "./week-iso-id.vo";
 export * from "./z-score.service";

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

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

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

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

@@ -0,0 +1,15 @@
+import { getISOWeeksInYear } from "date-fns";
+import { z } from "zod/v4";
+export const WeekIsoId = z
+    .string()
+    .regex(/^\d{4}-W\d{2}$/)
+    .refine((value) => {
+    const [yearPart, weekPart] = value.split("-W");
+    const year = Number(yearPart);
+    const week = Number(weekPart);
+    if (!(Number.isInteger(year) && Number.isInteger(week)) || week < 1)
+        return false;
+    // Does this ISO week-year actually have that many weeks?
+    const weeksInYear = getISOWeeksInYear(new Date(Date.UTC(year, 0, 4)));
+    return week <= weeksInYear;
+}, { message: "week-iso-id.invalid" });

package/dist/week.vo.d.ts

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

package/dist/week.vo.js

@@ -1,6 +1,7 @@
 import { endOfISOWeek, getISOWeek, getISOWeekYear, setISOWeek, startOfISOWeek } from "date-fns";
 import { DateRange } from "./date-range.vo";
 import { Timestamp } from "./timestamp.vo";
+import { WeekIsoId } from "./week-iso-id.vo";
 export class Week extends DateRange {
     constructor(start, end) {
         super(start, end);
@@ -19,7 +20,7 @@ export class Week extends DateRange {
         return Week.fromTimestamp(now);
     }
     static fromIsoId(isoId) {
-        const [yearPart, weekPart] = isoId.split("-W");
+        const [yearPart, weekPart] = WeekIsoId.parse(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.

package/package.json

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

package/readme.md

@@ -73,6 +73,7 @@ src/
 ├── timezone.vo.ts
 ├── ts-utils.ts
 ├── visually-unambiguous-characters-generator.service.ts
+├── week-iso-id.vo.ts
 ├── week.vo.ts
 └── z-score.service.ts
 ```

package/src/index.ts

@@ -48,4 +48,5 @@ export * from "./timezone.vo";
 export * from "./ts-utils";
 export * from "./visually-unambiguous-characters-generator.service";
 export * from "./week.vo";
+export * from "./week-iso-id.vo";
 export * from "./z-score.service";

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

@@ -0,0 +1,24 @@
+import { getISOWeeksInYear } from "date-fns";
+import { z } from "zod/v4";
+
+export const WeekIsoId = z
+  .string()
+  .regex(/^\d{4}-W\d{2}$/)
+  .refine(
+    (value) => {
+      const [yearPart, weekPart] = value.split("-W");
+
+      const year = Number(yearPart);
+      const week = Number(weekPart);
+
+      if (!(Number.isInteger(year) && Number.isInteger(week)) || week < 1) return false;
+
+      // Does this ISO week-year actually have that many weeks?
+      const weeksInYear = getISOWeeksInYear(new Date(Date.UTC(year, 0, 4)));
+
+      return week <= weeksInYear;
+    },
+    { message: "week-iso-id.invalid" },
+  );
+
+export type WeekIsoIdType = z.infer<typeof WeekIsoId>;

package/src/week.vo.ts

@@ -1,13 +1,14 @@
 import { endOfISOWeek, getISOWeek, getISOWeekYear, setISOWeek, startOfISOWeek } from "date-fns";
 import { DateRange } from "./date-range.vo";
 import { Timestamp, TimestampType } from "./timestamp.vo";
+import { WeekIsoId, WeekIsoIdType } from "./week-iso-id.vo";
 
 export class Week extends DateRange {
   constructor(start: TimestampType, end: TimestampType) {
     super(start, end);
   }
 
-  toIsoId(): string {
+  toIsoId(): WeekIsoIdType {
     const year = getISOWeekYear(this.getStart());
     const week = getISOWeek(this.getStart()).toString().padStart(2, "0");
 
@@ -25,8 +26,8 @@ export class Week extends DateRange {
     return Week.fromTimestamp(now);
   }
 
-  static fromIsoId(isoId: string): Week {
-    const [yearPart, weekPart] = isoId.split("-W");
+  static fromIsoId(isoId: WeekIsoIdType): Week {
+    const [yearPart, weekPart] = WeekIsoId.parse(isoId).split("-W");
 
     const year = Number(yearPart);
     const week = Number(weekPart);