@bgord/tools 1.2.9 → 1.2.11

package/dist/day.vo.d.ts

@@ -1,5 +1,6 @@
 import { DateRange } from "./date-range.vo";
 import { type DayIsoIdType } from "./day-iso-id.vo";
+import { type IntegerType } from "./integer.vo";
 import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.vo";
 export declare class Day extends DateRange {
@@ -10,6 +11,6 @@ export declare class Day extends DateRange {
     toIsoId(): DayIsoIdType;
     previous(): Day;
     next(): Day;
-    shift(count: number): Day;
+    shift(count: IntegerType): Day;
     toString(): string;
 }

package/dist/day.vo.js

@@ -2,6 +2,7 @@ import { formatISO } from "date-fns";
 import { DateRange } from "./date-range.vo";
 import { DayIsoId } from "./day-iso-id.vo";
 import { Duration } from "./duration.service";
+import { Integer } from "./integer.vo";
 import { Timestamp } from "./timestamp.vo";
 export class Day extends DateRange {
     static fromTimestamp(timestamp) {
@@ -27,10 +28,10 @@ export class Day extends DateRange {
         return DayIsoId.parse(formatISO(midday.ms, { representation: "date" }));
     }
     previous() {
-        return this.shift(-1);
+        return this.shift(Integer.parse(-1));
     }
     next() {
-        return this.shift(1);
+        return this.shift(Integer.parse(1));
     }
     shift(count) {
         return Day.fromTimestamp(this.getStart().add(Duration.Days(count)));

package/dist/index.d.ts

@@ -39,6 +39,8 @@ export * from "./iban-mask.service";
 export * from "./iban-schema.vo";
 export * from "./image.vo";
 export * from "./index";
+export * from "./integer.vo";
+export * from "./integer-positive.vo";
 export * from "./language.vo";
 export * from "./linear-regression.service";
 export * from "./mean.service";

package/dist/index.js

@@ -39,6 +39,8 @@ export * from "./iban-mask.service";
 export * from "./iban-schema.vo";
 export * from "./image.vo";
 export * from "./index";
+export * from "./integer.vo";
+export * from "./integer-positive.vo";
 export * from "./language.vo";
 export * from "./linear-regression.service";
 export * from "./mean.service";

package/dist/integer-positive.vo.d.ts

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

package/dist/integer-positive.vo.js

@@ -0,0 +1,7 @@
+import { z } from "zod/v4";
+export const IntegerPositiveError = { Type: "integer.positive.type", Invalid: "integer.positive.invalid" };
+export const IntegerPositive = z
+    .number(IntegerPositiveError.Type)
+    .int(IntegerPositiveError.Type)
+    .min(1, IntegerPositiveError.Invalid)
+    .brand("IntegerPositive");

package/dist/integer.vo.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod/v4";
+export declare const IntegerError: {
+    Type: string;
+};
+export declare const Integer: z.core.$ZodBranded<z.ZodNumber, "Integer">;
+export type IntegerType = z.infer<typeof Integer>;

package/dist/integer.vo.js

@@ -0,0 +1,3 @@
+import { z } from "zod/v4";
+export const IntegerError = { Type: "integer.type" };
+export const Integer = z.number(IntegerError.Type).int(IntegerError.Type).brand("Integer");

package/dist/month.vo.d.ts

@@ -1,4 +1,5 @@
 import { DateRange } from "./date-range.vo";
+import { type IntegerType } from "./integer.vo";
 import { type MonthIsoIdType } from "./month-iso-id.vo";
 import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.vo";
@@ -10,6 +11,6 @@ export declare class Month extends DateRange {
     toIsoId(): MonthIsoIdType;
     previous(): Month;
     next(): Month;
-    shift(count: number): Month;
+    shift(count: IntegerType): Month;
     toString(): string;
 }

package/dist/month.vo.js

@@ -1,5 +1,6 @@
 import { endOfMonth, format, getMonth, setMonth, startOfMonth } from "date-fns";
 import { DateRange } from "./date-range.vo";
+import { Integer } from "./integer.vo";
 import { MonthIsoId } from "./month-iso-id.vo";
 import { Timestamp } from "./timestamp.vo";
 export class Month extends DateRange {
@@ -23,10 +24,10 @@ export class Month extends DateRange {
         return MonthIsoId.parse(format(this.getStart().ms, "yyyy-MM"));
     }
     previous() {
-        return this.shift(-1);
+        return this.shift(Integer.parse(-1));
     }
     next() {
-        return this.shift(1);
+        return this.shift(Integer.parse(1));
     }
     shift(count) {
         const shifted = setMonth(this.getStart().ms, getMonth(this.getStart().ms) + count).getTime();

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/age-years.vo.ts","../src/age.vo.ts","../src/api-key.vo.ts","../src/basename.vo.ts","../src/clock-format.service.ts","../src/clock.vo.ts","../src/date-calculator.service.ts","../src/date-formatter.service.ts","../src/date-range.vo.ts","../src/day-iso-id.vo.ts","../src/day.vo.ts","../src/directory-path-absolute.vo.ts","../src/directory-path-relative.vo.ts","../src/distance-value.vo.ts","../src/distance.vo.ts","../src/division-factor.vo.ts","../src/dll.service.ts","../src/duration-ms.vo.ts","../src/duration.service.ts","../src/email-mask.service.ts","../src/email.vo.ts","../src/etags.vo.ts","../src/extension.vo.ts","../src/feature-flag-value.vo.ts","../src/feature-flag.vo.ts","../src/file-path-absolute-schema.vo.ts","../src/file-path-relative-schema.vo.ts","../src/file-path.vo.ts","../src/filename-affix.vo.ts","../src/filename-from-string.vo.ts","../src/filename.vo.ts","../src/height-milimiters.vo.ts","../src/height.vo.ts","../src/hour-format.service.ts","../src/hour-schema.vo.ts","../src/hour.vo.ts","../src/iban-mask.service.ts","../src/iban-schema.vo.ts","../src/iban.vo.ts","../src/image.vo.ts","../src/index.ts","../src/language.vo.ts","../src/linear-regression.service.ts","../src/mean.service.ts","../src/mime-types.vo.ts","../src/mime-value.vo.ts","../src/mime.vo.ts","../src/min-max-scaler.service.ts","../src/minute-schema.vo.ts","../src/minute.vo.ts","../src/money-amount.vo.ts","../src/money.vo.ts","../src/month-iso-id.vo.ts","../src/month.vo.ts","../src/multiplication-factor.vo.ts","../src/noop.service.ts","../src/notification-template.vo.ts","../src/object-key.vo.ts","../src/outlier-detector.service.ts","../src/package-version-schema.vo.ts","../src/package-version.vo.ts","../src/pagination-page.vo.ts","../src/pagination-skip.vo.ts","../src/pagination-take.vo.ts","../src/pagination.service.ts","../src/percentage.service.ts","../src/population-standard-deviation.service.ts","../src/quarter-iso-id.vo.ts","../src/quarter.vo.ts","../src/random.service.ts","../src/rate-limiter.service.ts","../src/relative-date.vo.ts","../src/reordering-item-position-value.vo.ts","../src/reordering.service.ts","../src/revision-value.vo.ts","../src/revision.vo.ts","../src/rounding-decimal.strategy.ts","../src/rounding-down.strategy.ts","../src/rounding-to-nearest.strategy.ts","../src/rounding-up.strategy.ts","../src/rounding.strategy.ts","../src/size-bytes.vo.ts","../src/size.vo.ts","../src/slug.service.ts","../src/sum.service.ts","../src/thousands-separator.service.ts","../src/time-zone-offset-value.vo.ts","../src/timestamp-value.vo.ts","../src/timestamp.vo.ts","../src/timezone.vo.ts","../src/ts-utils.ts","../src/url-with-slash.vo.ts","../src/url-without-slash.vo.ts","../src/visually-unambiguous-characters-generator.service.ts","../src/week-iso-id.vo.ts","../src/week.vo.ts","../src/weekday.vo.ts","../src/weight-grams.vo.ts","../src/weight.vo.ts","../src/year-iso-id.vo.ts","../src/year.vo.ts","../src/z-score.service.ts"],"version":"5.9.3"}
+{"root":["../src/age-years.vo.ts","../src/age.vo.ts","../src/api-key.vo.ts","../src/basename.vo.ts","../src/clock-format.service.ts","../src/clock.vo.ts","../src/date-calculator.service.ts","../src/date-formatter.service.ts","../src/date-range.vo.ts","../src/day-iso-id.vo.ts","../src/day.vo.ts","../src/directory-path-absolute.vo.ts","../src/directory-path-relative.vo.ts","../src/distance-value.vo.ts","../src/distance.vo.ts","../src/division-factor.vo.ts","../src/dll.service.ts","../src/duration-ms.vo.ts","../src/duration.service.ts","../src/email-mask.service.ts","../src/email.vo.ts","../src/etags.vo.ts","../src/extension.vo.ts","../src/feature-flag-value.vo.ts","../src/feature-flag.vo.ts","../src/file-path-absolute-schema.vo.ts","../src/file-path-relative-schema.vo.ts","../src/file-path.vo.ts","../src/filename-affix.vo.ts","../src/filename-from-string.vo.ts","../src/filename.vo.ts","../src/height-milimiters.vo.ts","../src/height.vo.ts","../src/hour-format.service.ts","../src/hour-schema.vo.ts","../src/hour.vo.ts","../src/iban-mask.service.ts","../src/iban-schema.vo.ts","../src/iban.vo.ts","../src/image.vo.ts","../src/index.ts","../src/integer-positive.vo.ts","../src/integer.vo.ts","../src/language.vo.ts","../src/linear-regression.service.ts","../src/mean.service.ts","../src/mime-types.vo.ts","../src/mime-value.vo.ts","../src/mime.vo.ts","../src/min-max-scaler.service.ts","../src/minute-schema.vo.ts","../src/minute.vo.ts","../src/money-amount.vo.ts","../src/money.vo.ts","../src/month-iso-id.vo.ts","../src/month.vo.ts","../src/multiplication-factor.vo.ts","../src/noop.service.ts","../src/notification-template.vo.ts","../src/object-key.vo.ts","../src/outlier-detector.service.ts","../src/package-version-schema.vo.ts","../src/package-version.vo.ts","../src/pagination-page.vo.ts","../src/pagination-skip.vo.ts","../src/pagination-take.vo.ts","../src/pagination.service.ts","../src/percentage.service.ts","../src/population-standard-deviation.service.ts","../src/quarter-iso-id.vo.ts","../src/quarter.vo.ts","../src/random.service.ts","../src/rate-limiter.service.ts","../src/relative-date.vo.ts","../src/reordering-item-position-value.vo.ts","../src/reordering.service.ts","../src/revision-value.vo.ts","../src/revision.vo.ts","../src/rounding-decimal.strategy.ts","../src/rounding-down.strategy.ts","../src/rounding-to-nearest.strategy.ts","../src/rounding-up.strategy.ts","../src/rounding.strategy.ts","../src/size-bytes.vo.ts","../src/size.vo.ts","../src/slug.service.ts","../src/sum.service.ts","../src/thousands-separator.service.ts","../src/time-zone-offset-value.vo.ts","../src/timestamp-value.vo.ts","../src/timestamp.vo.ts","../src/timezone.vo.ts","../src/ts-utils.ts","../src/url-with-slash.vo.ts","../src/url-without-slash.vo.ts","../src/visually-unambiguous-characters-generator.service.ts","../src/week-iso-id.vo.ts","../src/week.vo.ts","../src/weekday.vo.ts","../src/weight-grams.vo.ts","../src/weight.vo.ts","../src/year-iso-id.vo.ts","../src/year.vo.ts","../src/z-score.service.ts"],"version":"5.9.3"}

package/dist/week.vo.d.ts

@@ -1,4 +1,5 @@
 import { DateRange } from "./date-range.vo";
+import { type IntegerType } from "./integer.vo";
 import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.vo";
 import { type WeekIsoIdType } from "./week-iso-id.vo";
@@ -10,6 +11,6 @@ export declare class Week extends DateRange {
     toIsoId(): WeekIsoIdType;
     previous(): Week;
     next(): Week;
-    shift(count: number): Week;
+    shift(count: IntegerType): Week;
     toString(): string;
 }

package/dist/week.vo.js

@@ -1,5 +1,6 @@
 import { addWeeks, endOfISOWeek, getISOWeek, getISOWeekYear, setISOWeek, startOfISOWeek } from "date-fns";
 import { DateRange } from "./date-range.vo";
+import { Integer } from "./integer.vo";
 import { Timestamp } from "./timestamp.vo";
 import { WeekIsoId } from "./week-iso-id.vo";
 export class Week extends DateRange {
@@ -26,10 +27,10 @@ export class Week extends DateRange {
         return WeekIsoId.parse(`${year}-W${String(week).padStart(2, "0")}`);
     }
     previous() {
-        return this.shift(-1);
+        return this.shift(Integer.parse(-1));
     }
     next() {
-        return this.shift(1);
+        return this.shift(Integer.parse(1));
     }
     shift(count) {
         const shifted = addWeeks(this.getStart().ms, count).getTime();

package/dist/weight.vo.js

@@ -16,7 +16,7 @@ export class Weight {
         return new Weight(WeightGrams.parse(grams), rounding);
     }
     static zero() {
-        return new Weight(0);
+        return new Weight(WeightGrams.parse(0));
     }
     get() {
         return this.grams;
@@ -29,11 +29,11 @@ export class Weight {
         return `${this.grams} g`;
     }
     add(other) {
-        return new Weight(this.grams + other.grams);
+        return new Weight(WeightGrams.parse(this.grams + other.grams));
     }
     subtract(other) {
         const result = this.grams - other.grams;
-        return new Weight(result < 0 ? 0 : result);
+        return new Weight(WeightGrams.parse(result < 0 ? 0 : result));
     }
     multiply(factor) {
         const grams = this.rounding.round(this.grams * factor);

package/dist/year.vo.d.ts

@@ -1,4 +1,5 @@
 import { DateRange } from "./date-range.vo";
+import { type IntegerType } from "./integer.vo";
 import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.vo";
 import { type YearIsoIdType } from "./year-iso-id.vo";
@@ -12,6 +13,6 @@ export declare class Year extends DateRange {
     isLeapYear(): boolean;
     previous(): Year;
     next(): Year;
-    shift(count: number): Year;
+    shift(count: IntegerType): Year;
     toString(): string;
 }

package/dist/year.vo.js

@@ -1,5 +1,6 @@
 import { addYears, endOfYear, getYear, startOfYear } from "date-fns";
 import { DateRange } from "./date-range.vo";
+import { Integer } from "./integer.vo";
 import { Timestamp } from "./timestamp.vo";
 import { YearIsoId } from "./year-iso-id.vo";
 export class Year extends DateRange {
@@ -29,10 +30,10 @@ export class Year extends DateRange {
         return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
     }
     previous() {
-        return this.shift(-1);
+        return this.shift(Integer.parse(-1));
     }
     next() {
-        return this.shift(1);
+        return this.shift(Integer.parse(1));
     }
     shift(count) {
         const shifted = addYears(this.getStart().ms, count).getTime();

package/package.json

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

package/readme.md

@@ -64,6 +64,8 @@ src/
 ├── iban-schema.vo.ts
 ├── iban.vo.ts
 ├── image.vo.ts
+├── integer-positive.vo.ts
+├── integer.vo.ts
 ├── language.vo.ts
 ├── linear-regression.service.ts
 ├── mean.service.ts

package/src/day.vo.ts

@@ -2,6 +2,7 @@ import { formatISO } from "date-fns";
 import { DateRange } from "./date-range.vo";
 import { DayIsoId, type DayIsoIdType } from "./day-iso-id.vo";
 import { Duration } from "./duration.service";
+import { Integer, type IntegerType } from "./integer.vo";
 import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.vo";
 
@@ -41,14 +42,14 @@ export class Day extends DateRange {
   }
 
   previous(): Day {
-    return this.shift(-1);
+    return this.shift(Integer.parse(-1));
   }
 
   next(): Day {
-    return this.shift(1);
+    return this.shift(Integer.parse(1));
   }
 
-  shift(count: number): Day {
+  shift(count: IntegerType): Day {
     return Day.fromTimestamp(this.getStart().add(Duration.Days(count)));
   }
 

package/src/index.ts

@@ -39,6 +39,8 @@ export * from "./iban-mask.service";
 export * from "./iban-schema.vo";
 export * from "./image.vo";
 export * from "./index";
+export * from "./integer.vo";
+export * from "./integer-positive.vo";
 export * from "./language.vo";
 export * from "./linear-regression.service";
 export * from "./mean.service";

package/src/integer-positive.vo.ts

@@ -0,0 +1,11 @@
+import { z } from "zod/v4";
+
+export const IntegerPositiveError = { Type: "integer.positive.type", Invalid: "integer.positive.invalid" };
+
+export const IntegerPositive = z
+  .number(IntegerPositiveError.Type)
+  .int(IntegerPositiveError.Type)
+  .min(1, IntegerPositiveError.Invalid)
+  .brand("IntegerPositive");
+
+export type IntegerPositiveType = z.infer<typeof IntegerPositive>;

package/src/integer.vo.ts

@@ -0,0 +1,7 @@
+import { z } from "zod/v4";
+
+export const IntegerError = { Type: "integer.type" };
+
+export const Integer = z.number(IntegerError.Type).int(IntegerError.Type).brand("Integer");
+
+export type IntegerType = z.infer<typeof Integer>;

package/src/month.vo.ts

@@ -1,5 +1,6 @@
 import { endOfMonth, format, getMonth, setMonth, startOfMonth } from "date-fns";
 import { DateRange } from "./date-range.vo";
+import { Integer, type IntegerType } from "./integer.vo";
 import { MonthIsoId, type MonthIsoIdType } from "./month-iso-id.vo";
 import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.vo";
@@ -33,14 +34,14 @@ export class Month extends DateRange {
   }
 
   previous(): Month {
-    return this.shift(-1);
+    return this.shift(Integer.parse(-1));
   }
 
   next(): Month {
-    return this.shift(1);
+    return this.shift(Integer.parse(1));
   }
 
-  shift(count: number): Month {
+  shift(count: IntegerType): Month {
     const shifted = setMonth(this.getStart().ms, getMonth(this.getStart().ms) + count).getTime();
 
     return Month.fromTimestamp(Timestamp.fromNumber(shifted));

package/src/week.vo.ts

@@ -1,5 +1,6 @@
 import { addWeeks, endOfISOWeek, getISOWeek, getISOWeekYear, setISOWeek, startOfISOWeek } from "date-fns";
 import { DateRange } from "./date-range.vo";
+import { Integer, type IntegerType } from "./integer.vo";
 import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.vo";
 import { WeekIsoId, type WeekIsoIdType } from "./week-iso-id.vo";
@@ -37,14 +38,14 @@ export class Week extends DateRange {
   }
 
   previous(): Week {
-    return this.shift(-1);
+    return this.shift(Integer.parse(-1));
   }
 
   next(): Week {
-    return this.shift(1);
+    return this.shift(Integer.parse(1));
   }
 
-  shift(count: number): Week {
+  shift(count: IntegerType): Week {
     const shifted = addWeeks(this.getStart().ms, count).getTime();
 
     return Week.fromTimestamp(Timestamp.fromNumber(shifted));

package/src/weight.vo.ts

@@ -2,13 +2,13 @@ import type { DivisionFactorType } from "./division-factor.vo";
 import type { MultiplicationFactorType } from "./multiplication-factor.vo";
 import type { RoundingStrategy } from "./rounding.strategy";
 import { RoundingToNearestStrategy } from "./rounding-to-nearest.strategy";
-import { WeightGrams } from "./weight-grams.vo";
+import { WeightGrams, type WeightGramsType } from "./weight-grams.vo";
 
 export class Weight {
   private static readonly GRAMS_PER_KILOGRAM = 1_000;
 
   private constructor(
-    private readonly grams: number,
+    private readonly grams: WeightGramsType,
     private readonly rounding: RoundingStrategy = new RoundingToNearestStrategy(),
   ) {}
 
@@ -26,7 +26,7 @@ export class Weight {
   }
 
   static zero(): Weight {
-    return new Weight(0);
+    return new Weight(WeightGrams.parse(0));
   }
 
   get(): number {
@@ -44,13 +44,13 @@ export class Weight {
   }
 
   add(other: Weight): Weight {
-    return new Weight(this.grams + other.grams);
+    return new Weight(WeightGrams.parse(this.grams + other.grams));
   }
 
   subtract(other: Weight): Weight {
     const result = this.grams - other.grams;
 
-    return new Weight(result < 0 ? 0 : result);
+    return new Weight(WeightGrams.parse(result < 0 ? 0 : result));
   }
 
   multiply(factor: MultiplicationFactorType): Weight {

package/src/year.vo.ts

@@ -1,5 +1,6 @@
 import { addYears, endOfYear, getYear, startOfYear } from "date-fns";
 import { DateRange } from "./date-range.vo";
+import { Integer, type IntegerType } from "./integer.vo";
 import { Timestamp } from "./timestamp.vo";
 import type { TimestampValueType } from "./timestamp-value.vo";
 import { YearIsoId, type YearIsoIdType } from "./year-iso-id.vo";
@@ -41,14 +42,14 @@ export class Year extends DateRange {
   }
 
   previous(): Year {
-    return this.shift(-1);
+    return this.shift(Integer.parse(-1));
   }
 
   next(): Year {
-    return this.shift(1);
+    return this.shift(Integer.parse(1));
   }
 
-  shift(count: number): Year {
+  shift(count: IntegerType): Year {
     const shifted = addYears(this.getStart().ms, count).getTime();
 
     return Year.fromTimestamp(Timestamp.fromNumber(shifted));