@bgord/tools 0.9.2 → 0.9.3

package/dist/etags.vo.d.ts

@@ -1,5 +1,5 @@
 import { z } from "zod/v4";
-declare const RevisionValue: z.core.$ZodBranded<z.ZodNumber, "RevisionValue">;
+export declare const RevisionValue: z.core.$ZodBranded<z.ZodNumber, "RevisionValue">;
 type RevisionValueType = z.infer<typeof RevisionValue>;
 type ETagValueType = string;
 export declare class ETag {

package/dist/etags.vo.js

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

package/dist/filter.vo.d.ts

@@ -9,9 +9,9 @@ export type FilterParseConfigType<T extends DefaultFilterSchemaType> = {
 export declare class Filter<T extends DefaultFilterSchemaType> {
     private readonly schema;
     constructor(schema: FilterSchemaType<T>);
-    parse(values: FilterValuesType): z.core.$InferObjectOutput<T, Record<string, unknown>> | undefined;
-    default(): z.core.$InferObjectOutput<T, Record<string, unknown>> | undefined;
-    static parse<T extends DefaultFilterSchemaType>(config: FilterParseConfigType<T>): z.core.$InferObjectOutput<T, Record<string, unknown>> | undefined;
-    static default<T extends DefaultFilterSchemaType>(config: Omit<FilterParseConfigType<T>, "values">): z.core.$InferObjectOutput<T, Record<string, unknown>> | undefined;
+    parse(values: FilterValuesType): z.core.$InferObjectOutput<T, {}> | undefined;
+    default(): z.core.$InferObjectOutput<T, {}> | undefined;
+    static parse<T extends DefaultFilterSchemaType>(config: FilterParseConfigType<T>): z.core.$InferObjectOutput<T, {}> | undefined;
+    static default<T extends DefaultFilterSchemaType>(config: Omit<FilterParseConfigType<T>, "values">): z.core.$InferObjectOutput<T, {}> | undefined;
     private static _parse;
 }

package/dist/iban-mask.service.d.ts

@@ -0,0 +1,6 @@
+import { IBAN } from "./iban.vo";
+type IbanMaskedType = string;
+export declare class IbanMask {
+    static censor(iban: IBAN): IbanMaskedType;
+}
+export {};

package/dist/iban-mask.service.js

@@ -0,0 +1,9 @@
+export class IbanMask {
+    static censor(iban) {
+        const value = iban.format();
+        const start = value.slice(0, 4);
+        const middle = value.slice(5, -5).replace(/\d/g, "*");
+        const end = value.slice(-4);
+        return `${start} ${middle} ${end}`;
+    }
+}

package/dist/iban.vo.js

@@ -3,10 +3,10 @@ import { z } from "zod/v4";
 const IBAN_REGEX = /^[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}$/;
 const IBANValueSchema = z
     .string()
-    .transform((val) => val.replace(/\s+/g, "").toUpperCase())
-    .refine((iban) => IBAN_REGEX.test(iban), {
-    message: "invalid.iban.format",
-});
+    .trim()
+    .toUpperCase()
+    .transform((val) => val.replace(/\s+/g, ""))
+    .refine((iban) => IBAN_REGEX.test(iban), { message: "invalid.iban.format" });
 export class IBAN {
     value;
     constructor(value) {

package/dist/index.d.ts

@@ -11,12 +11,13 @@ export * from "./feature-flag.vo";
 export * from "./filter.vo";
 export * from "./hour.vo";
 export * from "./iban.vo";
+export * from "./iban-mask.service";
 export * from "./image.vo";
 export * from "./language.vo";
 export * from "./leap-year-checker.service";
 export * from "./mean.service";
-export * from "./mime-types.vo";
 export * from "./mime.vo";
+export * from "./mime-types.vo";
 export * from "./min-max-scaler.service";
 export * from "./minute.vo";
 export * from "./money.vo";
@@ -34,14 +35,13 @@ export * from "./revision.vo";
 export * from "./rounding.service";
 export * from "./simple-linear-regression.service";
 export * from "./size.vo";
-export * from "./sleep.service";
 export * from "./stepper.service";
 export * from "./stopwatch.service";
 export * from "./streak-calculator.service";
 export * from "./sum.service";
 export * from "./thousands-separator.service";
-export * from "./time-zone-offset-value.vo";
 export * from "./time.service";
+export * from "./time-zone-offset-value.vo";
 export * from "./timestamp.vo";
 export * from "./timezone.vo";
 export * from "./ts-utils";

package/dist/index.js

@@ -11,12 +11,13 @@ export * from "./feature-flag.vo";
 export * from "./filter.vo";
 export * from "./hour.vo";
 export * from "./iban.vo";
+export * from "./iban-mask.service";
 export * from "./image.vo";
 export * from "./language.vo";
 export * from "./leap-year-checker.service";
 export * from "./mean.service";
-export * from "./mime-types.vo";
 export * from "./mime.vo";
+export * from "./mime-types.vo";
 export * from "./min-max-scaler.service";
 export * from "./minute.vo";
 export * from "./money.vo";
@@ -34,14 +35,13 @@ export * from "./revision.vo";
 export * from "./rounding.service";
 export * from "./simple-linear-regression.service";
 export * from "./size.vo";
-export * from "./sleep.service";
 export * from "./stepper.service";
 export * from "./stopwatch.service";
 export * from "./streak-calculator.service";
 export * from "./sum.service";
 export * from "./thousands-separator.service";
-export * from "./time-zone-offset-value.vo";
 export * from "./time.service";
+export * from "./time-zone-offset-value.vo";
 export * from "./timestamp.vo";
 export * from "./timezone.vo";
 export * from "./ts-utils";

package/dist/package-version.vo.js

@@ -24,7 +24,7 @@ export const PackageVersionValue = z
         }
         return true;
     }
-    catch (error) {
+    catch (_error) {
         return false;
     }
 }, { message: "package.version.error" })

package/dist/pagination.service.d.ts

@@ -1,9 +1,9 @@
 import { z } from "zod/v4";
-declare const Take: z.core.$ZodBranded<z.ZodNumber, "Take">;
+declare const Take: z.ZodNumber;
 type TakeType = z.infer<typeof Take>;
-declare const Skip: z.core.$ZodBranded<z.ZodNumber, "Skip">;
+declare const Skip: z.ZodNumber;
 type SkipType = z.infer<typeof Skip>;
-declare const Page: z.core.$ZodBranded<z.ZodDefault<z.ZodPipe<z.ZodCoercedNumber<unknown>, z.ZodTransform<number, number>>>, "Page">;
+declare const Page: z.ZodDefault<z.ZodPipe<z.ZodCoercedNumber<unknown>, z.ZodTransform<number, number>>>;
 export type PageType = z.infer<typeof Page>;
 export type PaginationType = {
     values: {

package/dist/pagination.service.js

@@ -1,12 +1,11 @@
 import { z } from "zod/v4";
-const Take = z.number().int().gte(0).brand("Take");
-const Skip = z.number().int().gte(0).brand("Skip");
+const Take = z.number().int().gte(0);
+const Skip = z.number().int().gte(0);
 const Page = z.coerce
     .number()
     .int()
     .transform((value) => (value <= 0 ? 1 : value))
-    .default(1)
-    .brand("Page");
+    .default(1);
 export class Pagination {
     static parse(values, _take) {
         const page = Page.parse(values.page);

package/dist/reordering.service.d.ts

@@ -1,14 +1,14 @@
 import { z } from "zod/v4";
-export declare const ReorderingItemPositionValue: z.core.$ZodBranded<z.ZodNumber, "ReorderingItemPositionValue">;
+export declare const ReorderingItemPositionValue: z.ZodNumber;
 export type ReorderingItemPositionValueType = z.infer<typeof ReorderingItemPositionValue>;
-export declare const ReorderingCorrelationId: z.core.$ZodBranded<z.ZodString, "ReorderingCorrelationId">;
+export declare const ReorderingCorrelationId: z.ZodString;
 export type ReorderingCorrelationIdType = z.infer<typeof ReorderingCorrelationId>;
-export declare const ReorderingItemId: z.core.$ZodBranded<z.ZodUUID, "ReorderingItemId">;
+export declare const ReorderingItemId: z.ZodUUID;
 export type ReorderingItemIdType = z.infer<typeof ReorderingItemId>;
 export declare const Reordering: z.ZodObject<{
-    correlationId: z.core.$ZodBranded<z.ZodString, "ReorderingCorrelationId">;
-    id: z.core.$ZodBranded<z.ZodUUID, "ReorderingItemId">;
-    position: z.core.$ZodBranded<z.ZodNumber, "ReorderingItemPositionValue">;
+    correlationId: z.ZodString;
+    id: z.ZodUUID;
+    position: z.ZodNumber;
 }, z.core.$strip>;
 export type ReorderingType = z.infer<typeof Reordering>;
 export type WithReorderingPositionValue<T> = T & {
@@ -47,7 +47,7 @@ export declare class ReorderingCalculator {
     delete(id: ReorderingItem["id"]): void;
     transfer(transfer: ReorderingTransfer): ReturnType<ReorderingCalculator["read"]>;
     read(): {
-        ids: (string & z.core.$brand<"ReorderingItemId">)[];
+        ids: string[];
         items: ReorderingItem[];
     };
     private recalculate;

package/dist/reordering.service.js

@@ -1,8 +1,8 @@
 import { z } from "zod/v4";
 import { DoublyLinkedList, Node } from "./dll.service";
-export const ReorderingItemPositionValue = z.number().int().min(0).brand("ReorderingItemPositionValue");
-export const ReorderingCorrelationId = z.string().min(1).brand("ReorderingCorrelationId");
-export const ReorderingItemId = z.uuid().brand("ReorderingItemId");
+export const ReorderingItemPositionValue = z.number().int().min(0);
+export const ReorderingCorrelationId = z.string().min(1);
+export const ReorderingItemId = z.uuid();
 export const Reordering = z.object({
     correlationId: ReorderingCorrelationId,
     id: ReorderingItemId,

package/dist/revision.vo.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 import { ETag, WeakETag } from "./etags.vo";
-export declare const RevisionValue: z.core.$ZodBranded<z.ZodNumber, "RevisionValue">;
+declare const RevisionValue: z.core.$ZodBranded<z.ZodNumber, "RevisionValue">;
 export type RevisionValueType = z.infer<typeof RevisionValue>;
 export declare class Revision {
     readonly value: RevisionValueType;
@@ -18,3 +18,4 @@ export declare class RevisionMismatchError extends Error {
 export declare class InvalidRevisionError extends Error {
     constructor();
 }
+export {};

package/dist/revision.vo.js

@@ -1,5 +1,5 @@
 import { z } from "zod/v4";
-export const RevisionValue = z.number().int().min(0).brand("RevisionValue");
+const RevisionValue = z.number().int().min(0).brand("RevisionValue");
 export class Revision {
     value;
     static initial = RevisionValue.parse(0);

package/dist/size.vo.d.ts

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

package/dist/size.vo.js

@@ -7,7 +7,7 @@ export var SizeUnit;
     SizeUnit["MB"] = "MB";
     SizeUnit["GB"] = "GB";
 })(SizeUnit || (SizeUnit = {}));
-const SizeValue = z.number().positive().brand("SizeValue");
+export const SizeValue = z.number().positive().brand("SizeValue");
 export class Size {
     unit;
     value;

package/dist/timezone.vo.js

@@ -12,7 +12,7 @@ export const Timezone = z
         // If the formatting succeeds without throwing an error, the timezone is valid
         return true;
     }
-    catch (error) {
+    catch (_error) {
         // An error occurred, indicating an invalid timezone
         return false;
     }

package/dist/tsconfig.tsbuildinfo

@@ -0,0 +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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/tools",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "type": "module",
   "license": "MIT",
   "author": "Bartosz Gordon",
@@ -12,25 +12,28 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "files": ["dist", "src"],
+  "files": [
+    "dist",
+    "src"
+  ],
   "scripts": {
     "build": "rm -rf dist/ && tsc --build",
     "preinstall": "bunx only-allow bun"
   },
   "devDependencies": {
-    "@biomejs/biome": "1.9.4",
+    "@biomejs/biome": "2.0.0",
     "@commitlint/cli": "19.8.1",
     "@commitlint/config-conventional": "19.8.1",
     "@types/bun": "1.2.16",
-    "cspell": "9.0.2",
-    "lefthook": "1.11.13",
+    "cspell": "9.1.1",
+    "lefthook": "1.11.14",
     "only-allow": "1.2.1",
     "shellcheck": "3.1.0",
     "typescript": "5.8.3"
   },
   "dependencies": {
     "date-fns": "4.1.0",
-    "zod": "3.25.64"
+    "zod": "3.25.67"
   },
   "sideEffects": false
 }

package/src/etags.vo.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 
-const RevisionValue = z.number().int().min(0).brand("RevisionValue");
+export const RevisionValue = z.number().int().min(0).brand("RevisionValue");
 
 type RevisionValueType = z.infer<typeof RevisionValue>;
 

package/src/iban-mask.service.ts

@@ -0,0 +1,15 @@
+import { IBAN } from "./iban.vo";
+
+type IbanMaskedType = string;
+
+export class IbanMask {
+  static censor(iban: IBAN): IbanMaskedType {
+    const value = iban.format();
+
+    const start = value.slice(0, 4);
+    const middle = value.slice(5, -5).replace(/\d/g, "*");
+    const end = value.slice(-4);
+
+    return `${start} ${middle} ${end}`;
+  }
+}

package/src/iban.vo.ts

@@ -5,10 +5,10 @@ const IBAN_REGEX = /^[A-Z]{2}[0-9]{2}[A-Z0-9]{11,30}$/;
 
 const IBANValueSchema = z
   .string()
-  .transform((val) => val.replace(/\s+/g, "").toUpperCase())
-  .refine((iban) => IBAN_REGEX.test(iban), {
-    message: "invalid.iban.format",
-  });
+  .trim()
+  .toUpperCase()
+  .transform((val) => val.replace(/\s+/g, ""))
+  .refine((iban) => IBAN_REGEX.test(iban), { message: "invalid.iban.format" });
 
 type IBANValueType = z.infer<typeof IBANValueSchema>;
 

package/src/index.ts

@@ -11,12 +11,13 @@ export * from "./feature-flag.vo";
 export * from "./filter.vo";
 export * from "./hour.vo";
 export * from "./iban.vo";
+export * from "./iban-mask.service";
 export * from "./image.vo";
 export * from "./language.vo";
 export * from "./leap-year-checker.service";
 export * from "./mean.service";
-export * from "./mime-types.vo";
 export * from "./mime.vo";
+export * from "./mime-types.vo";
 export * from "./min-max-scaler.service";
 export * from "./minute.vo";
 export * from "./money.vo";
@@ -34,14 +35,13 @@ export * from "./revision.vo";
 export * from "./rounding.service";
 export * from "./simple-linear-regression.service";
 export * from "./size.vo";
-export * from "./sleep.service";
 export * from "./stepper.service";
 export * from "./stopwatch.service";
 export * from "./streak-calculator.service";
 export * from "./sum.service";
 export * from "./thousands-separator.service";
-export * from "./time-zone-offset-value.vo";
 export * from "./time.service";
+export * from "./time-zone-offset-value.vo";
 export * from "./timestamp.vo";
 export * from "./timezone.vo";
 export * from "./ts-utils";

package/src/mean.service.ts

@@ -1,4 +1,4 @@
-import { RoundToDecimal, RoundingStrategy } from "./rounding.service";
+import { RoundingStrategy, RoundToDecimal } from "./rounding.service";
 import { Sum } from "./sum.service";
 
 export class Mean {

package/src/min-max-scaler.service.ts

@@ -1,4 +1,4 @@
-import { RoundToDecimal, RoundingStrategy } from "./rounding.service";
+import { RoundingStrategy, RoundToDecimal } from "./rounding.service";
 
 type MinMaxScalerValueType = number;
 

package/src/money.vo.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 
-import { RoundToNearest, RoundingStrategy } from "./rounding.service";
+import { RoundingStrategy, RoundToNearest } from "./rounding.service";
 
 export const MoneyAmount = z
   .number()

package/src/package-version.vo.ts

@@ -41,7 +41,7 @@ export const PackageVersionValue = z
         }
 
         return true;
-      } catch (error) {
+      } catch (_error) {
         return false;
       }
     },

package/src/pagination.service.ts

@@ -1,10 +1,10 @@
 import { z } from "zod/v4";
 
-const Take = z.number().int().gte(0).brand("Take");
+const Take = z.number().int().gte(0);
 
 type TakeType = z.infer<typeof Take>;
 
-const Skip = z.number().int().gte(0).brand("Skip");
+const Skip = z.number().int().gte(0);
 
 type SkipType = z.infer<typeof Skip>;
 
@@ -12,8 +12,7 @@ const Page = z.coerce
   .number()
   .int()
   .transform((value) => (value <= 0 ? 1 : value))
-  .default(1)
-  .brand("Page");
+  .default(1);
 
 export type PageType = z.infer<typeof Page>;
 

package/src/percentage.service.ts

@@ -1,4 +1,4 @@
-import { RoundToNearest, RoundingStrategy } from "./rounding.service";
+import { RoundingStrategy, RoundToNearest } from "./rounding.service";
 
 export class Percentage {
   static of(

package/src/population-standard-deviation.service.ts

@@ -1,5 +1,5 @@
 import { Mean } from "./mean.service";
-import { RoundToDecimal, RoundingStrategy } from "./rounding.service";
+import { RoundingStrategy, RoundToDecimal } from "./rounding.service";
 import { Sum } from "./sum.service";
 
 export class PopulationStandardDeviation {

package/src/reordering.service.ts

@@ -2,15 +2,15 @@ import { z } from "zod/v4";
 
 import { DoublyLinkedList, Node } from "./dll.service";
 
-export const ReorderingItemPositionValue = z.number().int().min(0).brand("ReorderingItemPositionValue");
+export const ReorderingItemPositionValue = z.number().int().min(0);
 
 export type ReorderingItemPositionValueType = z.infer<typeof ReorderingItemPositionValue>;
 
-export const ReorderingCorrelationId = z.string().min(1).brand("ReorderingCorrelationId");
+export const ReorderingCorrelationId = z.string().min(1);
 
 export type ReorderingCorrelationIdType = z.infer<typeof ReorderingCorrelationId>;
 
-export const ReorderingItemId = z.uuid().brand("ReorderingItemId");
+export const ReorderingItemId = z.uuid();
 
 export type ReorderingItemIdType = z.infer<typeof ReorderingItemId>;
 

package/src/revision.vo.ts

@@ -2,7 +2,7 @@ import { z } from "zod/v4";
 
 import { ETag, WeakETag } from "./etags.vo";
 
-export const RevisionValue = z.number().int().min(0).brand("RevisionValue");
+const RevisionValue = z.number().int().min(0).brand("RevisionValue");
 
 export type RevisionValueType = z.infer<typeof RevisionValue>;
 

package/src/simple-linear-regression.service.ts

@@ -1,4 +1,4 @@
-import { RoundToNearest, RoundingStrategy } from "./rounding.service";
+import { RoundingStrategy, RoundToNearest } from "./rounding.service";
 import { Sum } from "./sum.service";
 
 export type SLRPairType = { x: number; y: number };

package/src/size.vo.ts

@@ -9,7 +9,7 @@ export enum SizeUnit {
   GB = "GB",
 }
 
-const SizeValue = z.number().positive().brand("SizeValue");
+export const SizeValue = z.number().positive().brand("SizeValue");
 
 type SizeValueType = z.infer<typeof SizeValue>;
 

package/src/timezone.vo.ts

@@ -15,7 +15,7 @@ export const Timezone = z
 
         // If the formatting succeeds without throwing an error, the timezone is valid
         return true;
-      } catch (error) {
+      } catch (_error) {
         // An error occurred, indicating an invalid timezone
         return false;
       }

package/src/z-score.service.ts

@@ -1,6 +1,6 @@
 import { Mean } from "./mean.service";
 import { PopulationStandardDeviation } from "./population-standard-deviation.service";
-import { RoundToDecimal, RoundingStrategy } from "./rounding.service";
+import { RoundingStrategy, RoundToDecimal } from "./rounding.service";
 
 export class ZScore {
   private readonly mean: number;

package/dist/sleep.service.d.ts

@@ -1,3 +0,0 @@
-export declare function sleep(config: {
-    ms: number;
-}): Promise<unknown>;

package/dist/sleep.service.js

@@ -1,3 +0,0 @@
-export function sleep(config) {
-    return new Promise((resolve) => setTimeout(resolve, config.ms));
-}

package/src/sleep.service.ts

@@ -1,3 +0,0 @@
-export function sleep(config: { ms: number }) {
-  return new Promise((resolve) => setTimeout(resolve, config.ms));
-}