@bgord/tools 0.3.1 → 0.5.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/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 PackageVersionSchema: z.ZodPipe<z.ZodString, z.ZodTransform<{
+    major: number;
+    minor: number;
+    patch: number;
+}, string>>;
+export type PackageVersionSchemaType = z.infer<typeof PackageVersionSchema>;
+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 PackageVersionSchema = 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 = PackageVersionSchema.parse(value);
+        return new PackageVersion(version.major, version.minor, version.patch);
+    }
+    static fromString(value) {
+        const version = PackageVersionSchema.parse(`v${value}`);
+        return new PackageVersion(version.major, version.minor, version.patch);
+    }
+}

package/dist/size.vo.d.ts

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

package/dist/stopwatch.service.d.ts

@@ -1,5 +1,5 @@
 import type { TimestampType } from "./timestamp.vo";
-type StopwatchResultType = {
+export type StopwatchResultType = {
     durationMs: TimestampType;
 };
 export declare class Stopwatch {
@@ -8,4 +8,3 @@ export declare class Stopwatch {
     private stopMs;
     stop(): StopwatchResultType;
 }
-export {};

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.3.1",
+  "version": "0.5.0",
   "type": "module",
   "license": "MIT",
   "author": "Bartosz Gordon",

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/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 PackageVersionSchema = 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 PackageVersionSchemaType = z.infer<typeof PackageVersionSchema>;
+
+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 = PackageVersionSchema.parse(value);
+
+    return new PackageVersion(version.major, version.minor, version.patch);
+  }
+
+  static fromString(value: string) {
+    const version = PackageVersionSchema.parse(`v${value}`);
+
+    return new PackageVersion(version.major, version.minor, version.patch);
+  }
+}

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>;