@bgord/tools 0.4.0 → 0.6.0

package/dist/api-key.vo.d.ts

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

package/dist/api-key.vo.js

@@ -0,0 +1,2 @@
+import { z } from "zod/v4";
+export const ApiKey = z.string().trim().length(64);

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

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

package/dist/build-version.vo.js

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

package/dist/etags.vo.d.ts

@@ -1,9 +1,9 @@
 import { z } from "zod/v4";
-declare const RevisionValueSchema: z.ZodNumber;
-type RevisionValueSchemaType = z.infer<typeof RevisionValueSchema>;
+declare const RevisionValue: z.ZodNumber;
+type RevisionValueType = z.infer<typeof RevisionValue>;
 type ETagValueType = string;
 export declare class ETag {
-    readonly revision: RevisionValueSchemaType;
+    readonly revision: RevisionValueType;
     static HEADER_NAME: string;
     static IF_MATCH_HEADER_NAME: string;
     readonly value: ETagValueType;
@@ -12,7 +12,7 @@ export declare class ETag {
 }
 export type WeakETagValueType = string;
 export declare class WeakETag {
-    readonly revision: RevisionValueSchemaType;
+    readonly revision: RevisionValueType;
     static HEADER_NAME: string;
     static IF_MATCH_HEADER_NAME: string;
     readonly value: WeakETagValueType;

package/dist/etags.vo.js

@@ -1,5 +1,5 @@
 import { z } from "zod/v4";
-const RevisionValueSchema = z.number().int().min(0);
+const RevisionValue = z.number().int().min(0);
 export class ETag {
     constructor(revision) {
         this.revision = revision;

package/dist/index.d.ts

@@ -1,15 +1,21 @@
+export * from "./api-key.vo";
+export * from "./build-version.vo";
 export * from "./date-calculator.service";
 export * from "./date-formatter.service";
 export * from "./dates-of-the-week.vo";
 export * from "./etags.vo";
+export * from "./language.vo";
 export * from "./mime.vo";
 export * from "./noop.service";
+export * from "./package-version.vo";
 export * from "./rate-limiter.service";
 export * from "./relative-date.vo";
 export * from "./rounding.service";
 export * from "./size.vo";
 export * from "./sleep.service";
 export * from "./stopwatch.service";
+export * from "./time-zone-offset-value.vo";
 export * from "./time.service";
 export * from "./timestamp.vo";
+export * from "./timezone.vo";
 export * from "./ts-utils";

package/dist/index.js

@@ -1,15 +1,21 @@
+export * from "./api-key.vo";
+export * from "./build-version.vo";
 export * from "./date-calculator.service";
 export * from "./date-formatter.service";
 export * from "./dates-of-the-week.vo";
 export * from "./etags.vo";
+export * from "./language.vo";
 export * from "./mime.vo";
 export * from "./noop.service";
+export * from "./package-version.vo";
 export * from "./rate-limiter.service";
 export * from "./relative-date.vo";
 export * from "./rounding.service";
 export * from "./size.vo";
 export * from "./sleep.service";
 export * from "./stopwatch.service";
+export * from "./time-zone-offset-value.vo";
 export * from "./time.service";
 export * from "./timestamp.vo";
+export * from "./timezone.vo";
 export * from "./ts-utils";

package/dist/language.vo.d.ts

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

package/dist/language.vo.js

@@ -0,0 +1,5 @@
+import { z } from "zod/v4";
+export const Language = z
+    .string()
+    .length(2)
+    .regex(/^[a-z]{2}$/, { message: "invalid_language" });

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

@@ -0,0 +1,20 @@
+import { z } from "zod/v4";
+type MajorType = number;
+type MinorType = number;
+type PatchType = number;
+export declare const PackageVersionValue: z.ZodPipe<z.ZodString, z.ZodTransform<{
+    major: number;
+    minor: number;
+    patch: number;
+}, string>>;
+export type PackageVersionValueType = z.infer<typeof PackageVersionValue>;
+export declare class PackageVersion {
+    readonly major: MajorType;
+    readonly minor: MinorType;
+    readonly patch: PatchType;
+    constructor(major: MajorType, minor: MinorType, patch: PatchType);
+    isGreaterThanOrEqual(another: PackageVersion): boolean;
+    static fromStringWithV(value: string): PackageVersion;
+    static fromString(value: string): PackageVersion;
+}
+export {};

package/dist/package-version.vo.js

@@ -0,0 +1,69 @@
+import { z } from "zod/v4";
+export const PackageVersionValue = z
+    .string()
+    .min(1)
+    .refine((value) => {
+    try {
+        if (!value.startsWith("v"))
+            return false;
+        const [, version] = value.split("v");
+        if (!version)
+            return false;
+        const [major, minor, patch] = version.split(".");
+        if (!(major && minor && patch))
+            return false;
+        if (!(Number.isInteger(Number(major)) &&
+            Number.isInteger(Number(minor)) &&
+            Number.isInteger(Number(patch)))) {
+            return false;
+        }
+        if (!(Number.isInteger(Number(major)) &&
+            Number.isInteger(Number(minor)) &&
+            Number.isInteger(Number(patch)))) {
+            return false;
+        }
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}, { message: "package.version.error" })
+    .transform((value) => {
+    const [, version] = value.split("v");
+    const [major, minor, patch] = version.split(".");
+    return {
+        major: Number(major),
+        minor: Number(minor),
+        patch: Number(patch),
+    };
+});
+export class PackageVersion {
+    constructor(major, minor, patch) {
+        this.major = major;
+        this.minor = minor;
+        this.patch = patch;
+    }
+    isGreaterThanOrEqual(another) {
+        if (this.major > another.major)
+            return true;
+        if (this.major < another.major)
+            return false;
+        if (this.minor > another.minor)
+            return true;
+        if (this.minor < another.minor)
+            return false;
+        if (this.patch > another.patch)
+            return true;
+        if (this.patch < another.patch)
+            return false;
+        return true;
+    }
+    static fromStringWithV(value) {
+        const version = PackageVersionValue.parse(value);
+        return new PackageVersion(version.major, version.minor, version.patch);
+    }
+    static fromString(value) {
+        const version = PackageVersionValue.parse(`v${value}`);
+        return new PackageVersion(version.major, version.minor, version.patch);
+    }
+}

package/dist/size.vo.d.ts

@@ -5,8 +5,8 @@ export declare enum SizeUnit {
     MB = "MB",
     GB = "GB"
 }
-declare const SizeValueSchema: z.ZodNumber;
-export type SizeValueType = z.infer<typeof SizeValueSchema>;
+declare const SizeValue: z.ZodNumber;
+export type SizeValueType = z.infer<typeof SizeValue>;
 type SizeConfigType = {
     unit: SizeUnit;
     value: SizeValueType;

package/dist/size.vo.js

@@ -7,11 +7,11 @@ export var SizeUnit;
     SizeUnit["MB"] = "MB";
     SizeUnit["GB"] = "GB";
 })(SizeUnit || (SizeUnit = {}));
-const SizeValueSchema = z.number().positive();
+const SizeValue = z.number().positive();
 export class Size {
     constructor(config) {
         this.unit = config.unit;
-        this.value = SizeValueSchema.parse(config.value);
+        this.value = SizeValue.parse(config.value);
         this.bytes = this.calculateBytes(config);
     }
     toString() {

package/dist/time-zone-offset-value.vo.d.ts

@@ -0,0 +1,3 @@
+import { z } from "zod/v4";
+export declare const TimeZoneOffsetValue: z.ZodPipe<z.ZodPipe<z.ZodUnion<[z.ZodString, z.ZodUndefined]>, z.ZodTransform<number, string | undefined>>, z.ZodTransform<number, number>>;
+export type TimeZoneOffsetValueType = z.infer<typeof TimeZoneOffsetValue>;

package/dist/time-zone-offset-value.vo.js

@@ -0,0 +1,7 @@
+import { z } from "zod/v4";
+export const TimeZoneOffsetValue = z
+    .string()
+    .trim()
+    .or(z.undefined())
+    .transform((value) => Number(value))
+    .transform((value) => (Number.isNaN(value) ? 0 : value));

package/dist/time.service.d.ts

@@ -7,6 +7,16 @@ interface TimeResultInterface {
     isAfter(another: TimeResultInterface): boolean;
     isBefore(another: TimeResultInterface): boolean;
 }
+export declare class TimeResult implements TimeResultInterface {
+    readonly days: number;
+    readonly hours: number;
+    readonly minutes: number;
+    readonly seconds: number;
+    readonly ms: number;
+    constructor(days: number, hours: number, minutes: number, seconds: number, ms: number);
+    isAfter(another: TimeResultInterface): boolean;
+    isBefore(another: TimeResultInterface): boolean;
+}
 export declare class Time {
     static Days(value: number): TimeResultInterface;
     static Hours(value: number): TimeResultInterface;

package/dist/time.service.js

@@ -1,6 +1,6 @@
 import { RoundToDecimal } from "./rounding.service";
 const rounding = new RoundToDecimal(2);
-class TimeResult {
+export class TimeResult {
     constructor(days, hours, minutes, seconds, ms) {
         this.days = days;
         this.hours = hours;

package/dist/timezone.vo.d.ts

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

package/dist/timezone.vo.js

@@ -0,0 +1,19 @@
+import { z } from "zod/v4";
+export const Timezone = z
+    .string()
+    .min(1)
+    .refine((value) => {
+    try {
+        // Create a dummy date and time format using the specified timezone
+        const dummyDate = new Date();
+        const formatter = new Intl.DateTimeFormat("en-US", { timeZone: value });
+        // Format the dummy date
+        formatter.format(dummyDate);
+        // If the formatting succeeds without throwing an error, the timezone is valid
+        return true;
+    }
+    catch (error) {
+        // An error occurred, indicating an invalid timezone
+        return false;
+    }
+}, { message: "timezone.invalid" });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/tools",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "type": "module",
   "license": "MIT",
   "author": "Bartosz Gordon",
@@ -30,7 +30,7 @@
   },
   "dependencies": {
     "date-fns": "4.1.0",
-    "zod": "3.25.46"
+    "zod": "3.25.51"
   },
   "sideEffects": false
 }

package/src/api-key.vo.ts

@@ -0,0 +1,4 @@
+import { z } from "zod/v4";
+
+export const ApiKey = z.string().trim().length(64);
+export type ApiKeyType = z.infer<typeof ApiKey>;

package/src/build-version.vo.ts

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

package/src/etags.vo.ts

@@ -1,8 +1,8 @@
 import { z } from "zod/v4";
 
-const RevisionValueSchema = z.number().int().min(0);
+const RevisionValue = z.number().int().min(0);
 
-type RevisionValueSchemaType = z.infer<typeof RevisionValueSchema>;
+type RevisionValueType = z.infer<typeof RevisionValue>;
 
 type ETagValueType = string;
 
@@ -13,7 +13,7 @@ export class ETag {
 
   readonly value: ETagValueType;
 
-  private constructor(readonly revision: RevisionValueSchemaType) {
+  private constructor(readonly revision: RevisionValueType) {
     this.value = revision.toString();
   }
 
@@ -36,7 +36,7 @@ export class WeakETag {
 
   readonly value: WeakETagValueType;
 
-  private constructor(readonly revision: RevisionValueSchemaType) {
+  private constructor(readonly revision: RevisionValueType) {
     this.value = `W/${revision.toString()}`;
   }
 

package/src/index.ts

@@ -1,15 +1,21 @@
+export * from "./api-key.vo";
+export * from "./build-version.vo";
 export * from "./date-calculator.service";
 export * from "./date-formatter.service";
 export * from "./dates-of-the-week.vo";
 export * from "./etags.vo";
+export * from "./language.vo";
 export * from "./mime.vo";
 export * from "./noop.service";
+export * from "./package-version.vo";
 export * from "./rate-limiter.service";
 export * from "./relative-date.vo";
 export * from "./rounding.service";
 export * from "./size.vo";
 export * from "./sleep.service";
 export * from "./stopwatch.service";
+export * from "./time-zone-offset-value.vo";
 export * from "./time.service";
 export * from "./timestamp.vo";
+export * from "./timezone.vo";
 export * from "./ts-utils";

package/src/language.vo.ts

@@ -0,0 +1,8 @@
+import { z } from "zod/v4";
+
+export const Language = z
+  .string()
+  .length(2)
+  .regex(/^[a-z]{2}$/, { message: "invalid_language" });
+
+export type LanguageType = z.infer<typeof Language>;

package/src/package-version.vo.ts

@@ -0,0 +1,92 @@
+import { z } from "zod/v4";
+
+type MajorType = number;
+type MinorType = number;
+type PatchType = number;
+
+export const PackageVersionValue = z
+  .string()
+  .min(1)
+  .refine(
+    (value) => {
+      try {
+        if (!value.startsWith("v")) return false;
+
+        const [, version] = value.split("v");
+        if (!version) return false;
+
+        const [major, minor, patch] = version.split(".");
+        if (!(major && minor && patch)) return false;
+
+        if (
+          !(
+            Number.isInteger(Number(major)) &&
+            Number.isInteger(Number(minor)) &&
+            Number.isInteger(Number(patch))
+          )
+        ) {
+          return false;
+        }
+
+        if (
+          !(
+            Number.isInteger(Number(major)) &&
+            Number.isInteger(Number(minor)) &&
+            Number.isInteger(Number(patch))
+          )
+        ) {
+          return false;
+        }
+
+        return true;
+      } catch (error) {
+        return false;
+      }
+    },
+    { message: "package.version.error" },
+  )
+  .transform((value) => {
+    const [, version] = value.split("v");
+
+    const [major, minor, patch] = (version as string).split(".");
+
+    return {
+      major: Number(major),
+      minor: Number(minor),
+      patch: Number(patch),
+    };
+  });
+export type PackageVersionValueType = z.infer<typeof PackageVersionValue>;
+
+export class PackageVersion {
+  constructor(
+    readonly major: MajorType,
+    readonly minor: MinorType,
+    readonly patch: PatchType,
+  ) {}
+
+  isGreaterThanOrEqual(another: PackageVersion) {
+    if (this.major > another.major) return true;
+    if (this.major < another.major) return false;
+
+    if (this.minor > another.minor) return true;
+    if (this.minor < another.minor) return false;
+
+    if (this.patch > another.patch) return true;
+    if (this.patch < another.patch) return false;
+
+    return true;
+  }
+
+  static fromStringWithV(value: string) {
+    const version = PackageVersionValue.parse(value);
+
+    return new PackageVersion(version.major, version.minor, version.patch);
+  }
+
+  static fromString(value: string) {
+    const version = PackageVersionValue.parse(`v${value}`);
+
+    return new PackageVersion(version.major, version.minor, version.patch);
+  }
+}

package/src/size.vo.ts

@@ -9,9 +9,9 @@ export enum SizeUnit {
   GB = "GB",
 }
 
-const SizeValueSchema = z.number().positive();
+const SizeValue = z.number().positive();
 
-export type SizeValueType = z.infer<typeof SizeValueSchema>;
+export type SizeValueType = z.infer<typeof SizeValue>;
 
 type SizeConfigType = { unit: SizeUnit; value: SizeValueType };
 
@@ -30,7 +30,7 @@ export class Size {
 
   constructor(config: SizeConfigType) {
     this.unit = config.unit;
-    this.value = SizeValueSchema.parse(config.value);
+    this.value = SizeValue.parse(config.value);
     this.bytes = this.calculateBytes(config);
   }
 

package/src/time-zone-offset-value.vo.ts

@@ -0,0 +1,10 @@
+import { z } from "zod/v4";
+
+export const TimeZoneOffsetValue = z
+  .string()
+  .trim()
+  .or(z.undefined())
+  .transform((value) => Number(value))
+  .transform((value) => (Number.isNaN(value) ? 0 : value));
+
+export type TimeZoneOffsetValueType = z.infer<typeof TimeZoneOffsetValue>;

package/src/time.service.ts

@@ -13,7 +13,7 @@ interface TimeResultInterface {
   isBefore(another: TimeResultInterface): boolean;
 }
 
-class TimeResult implements TimeResultInterface {
+export class TimeResult implements TimeResultInterface {
   constructor(
     readonly days: number,
     readonly hours: number,

package/src/timezone.vo.ts

@@ -0,0 +1,26 @@
+import { z } from "zod/v4";
+
+export const Timezone = z
+  .string()
+  .min(1)
+  .refine(
+    (value) => {
+      try {
+        // Create a dummy date and time format using the specified timezone
+        const dummyDate = new Date();
+        const formatter = new Intl.DateTimeFormat("en-US", { timeZone: value });
+
+        // Format the dummy date
+        formatter.format(dummyDate);
+
+        // If the formatting succeeds without throwing an error, the timezone is valid
+        return true;
+      } catch (error) {
+        // An error occurred, indicating an invalid timezone
+        return false;
+      }
+    },
+    { message: "timezone.invalid" },
+  );
+
+export type TimezoneType = z.infer<typeof Timezone>;