@bgord/tools 1.2.19 → 1.2.21

package/src/dll.service.ts

@@ -1,177 +0,0 @@
-export class Node<T> {
-  data: T;
-  prev: Node<T> | null = null;
-  next: Node<T> | null = null;
-
-  constructor(data: Node<T>["data"]) {
-    this.data = data;
-  }
-
-  forward(n: number): Node<T> | null {
-    let currentNode: Node<T> | null = this;
-    let steps = n;
-
-    while (steps > 0 && currentNode) {
-      currentNode = currentNode.next;
-      steps -= 1;
-    }
-
-    return currentNode;
-  }
-
-  backward(n: number): Node<T> | null {
-    let currentNode: Node<T> | null = this;
-    let steps = n;
-
-    while (steps > 0 && currentNode) {
-      currentNode = currentNode.prev;
-      steps -= 1;
-    }
-
-    return currentNode;
-  }
-}
-
-export class DoublyLinkedList<T> {
-  static EMPTY_SIZE = 0;
-  private size = DoublyLinkedList.EMPTY_SIZE;
-  private head: Node<T> | null = null;
-  private tail: Node<T> | null = null;
-
-  getSize(): DoublyLinkedList<T>["size"] {
-    return this.size;
-  }
-
-  isEmpty(): boolean {
-    return this.size === 0;
-  }
-
-  getHead(): DoublyLinkedList<T>["head"] {
-    return this.head;
-  }
-
-  getTail(): DoublyLinkedList<T>["tail"] {
-    return this.tail;
-  }
-
-  append(node: Node<T>): void {
-    if (this.tail === null) {
-      this.head = node;
-      this.tail = node;
-    } else {
-      this.tail.next = node;
-      node.prev = this.tail;
-      this.tail = node;
-    }
-    this.size += 1;
-  }
-
-  prepend(node: Node<T>): void {
-    if (this.head === null) {
-      this.head = node;
-      this.tail = node;
-    } else {
-      node.next = this.head;
-      this.head.prev = node;
-      this.head = node;
-    }
-    this.size += 1;
-  }
-
-  clear(): void {
-    this.size = 0;
-    this.head = null;
-    this.tail = null;
-  }
-
-  remove(node: Node<T>): void {
-    if (node.prev) {
-      node.prev.next = node.next;
-    } else {
-      this.head = node.next;
-    }
-
-    if (node.next) {
-      node.next.prev = node.prev;
-    } else {
-      this.tail = node.prev;
-    }
-
-    this.size -= 1;
-    node.prev = null;
-    node.next = null;
-  }
-
-  insertAfter(node: Node<T>, target: Node<T>): void {
-    if (target === this.tail) {
-      this.append(node);
-      return;
-    }
-
-    const nextNode = target.next!;
-    this.size += 1;
-
-    node.prev = target;
-    node.next = nextNode;
-
-    nextNode.prev = node;
-
-    target.next = node;
-  }
-
-  insertBefore(node: Node<T>, target: Node<T>): void {
-    if (target === this.head) {
-      this.prepend(node);
-      return;
-    }
-
-    const prevNode = target.prev!;
-    this.size += 1;
-
-    node.next = target;
-    node.prev = prevNode;
-
-    prevNode.next = node;
-
-    target.prev = node;
-  }
-
-  find(callback: (node: Node<T>) => boolean): Node<T> | null {
-    let current = this.head;
-    while (current) {
-      if (callback(current)) return current;
-      current = current.next;
-    }
-    return null;
-  }
-
-  reverse(): void {
-    [this.head, this.tail] = [this.tail, this.head];
-
-    for (const node of this) {
-      const originalNext = node.next;
-      node.next = node.prev;
-      node.prev = originalNext;
-    }
-  }
-
-  toArray(): Node<T>[] {
-    return Array.from(this);
-  }
-
-  static fromArray<T>(array: T[]): DoublyLinkedList<T> {
-    const dll = new DoublyLinkedList<T>();
-    for (const item of array) {
-      dll.append(new Node<T>(item));
-    }
-    return dll;
-  }
-
-  *[Symbol.iterator](): IterableIterator<Node<T>> {
-    let current: Node<T> | null = this.head;
-    while (current) {
-      yield current;
-      current = current.next;
-    }
-  }
-}

package/src/duration-ms.vo.ts

@@ -1,9 +0,0 @@
-import { z } from "zod/v4";
-
-export const DurationMsError = { Invalid: "duration.invalid" };
-
-// Stryker disable all
-export const DurationMs = z.number(DurationMsError.Invalid).int(DurationMsError.Invalid).brand("DurationMs");
-// Stryker restore all
-
-export type DurationMsType = z.infer<typeof DurationMs>;

package/src/duration.service.ts

@@ -1,89 +0,0 @@
-import { DurationMs, type DurationMsType } from "./duration-ms.vo";
-import type { MultiplicationFactorType } from "./multiplication-factor.vo";
-import type { RoundingStrategy } from "./rounding.strategy";
-import { RoundingDecimalStrategy } from "./rounding-decimal.strategy";
-import { RoundingToNearestStrategy } from "./rounding-to-nearest.strategy";
-
-export class Duration {
-  private static readonly rounding: RoundingStrategy = new RoundingDecimalStrategy(2);
-  private readonly internal: DurationMsType;
-
-  static readonly MIN = Duration.Ms(1);
-
-  private static readonly MS_IN_SECOND = 1_000;
-  private static readonly MS_IN_MINUTE = 60 * Duration.MS_IN_SECOND;
-  private static readonly MS_IN_HOUR = 60 * Duration.MS_IN_MINUTE;
-  private static readonly MS_IN_DAY = 24 * Duration.MS_IN_HOUR;
-  private static readonly MS_IN_WEEK = 7 * Duration.MS_IN_DAY;
-
-  private constructor(candidateMs: number) {
-    this.internal = DurationMs.parse(candidateMs);
-  }
-
-  static Weeks(value: number): Duration {
-    return new Duration(value * Duration.MS_IN_WEEK);
-  }
-
-  static Days(value: number): Duration {
-    return new Duration(value * Duration.MS_IN_DAY);
-  }
-  static Hours(value: number): Duration {
-    return new Duration(value * Duration.MS_IN_HOUR);
-  }
-  static Minutes(value: number): Duration {
-    return new Duration(value * Duration.MS_IN_MINUTE);
-  }
-  static Seconds(value: number): Duration {
-    return new Duration(value * Duration.MS_IN_SECOND);
-  }
-  static Ms(value: number): Duration {
-    return new Duration(value);
-  }
-
-  get weeks(): number {
-    return Duration.rounding.round(this.internal / Duration.MS_IN_WEEK);
-  }
-
-  get days(): number {
-    return Duration.rounding.round(this.internal / Duration.MS_IN_DAY);
-  }
-  get hours(): number {
-    return Duration.rounding.round(this.internal / Duration.MS_IN_HOUR);
-  }
-  get minutes(): number {
-    return Duration.rounding.round(this.internal / Duration.MS_IN_MINUTE);
-  }
-  get seconds(): number {
-    return Duration.rounding.round(this.internal / Duration.MS_IN_SECOND);
-  }
-  get ms(): DurationMsType {
-    return this.internal;
-  }
-
-  isLongerThan(another: Duration): boolean {
-    return this.internal > another.internal;
-  }
-  isShorterThan(another: Duration): boolean {
-    return this.internal < another.internal;
-  }
-
-  equals(other: Duration): boolean {
-    return this.internal === other.internal;
-  }
-  add(another: Duration): Duration {
-    return Duration.Ms(this.internal + another.internal);
-  }
-  subtract(another: Duration): Duration {
-    return Duration.Ms(this.internal - another.internal);
-  }
-
-  times(factor: MultiplicationFactorType): Duration {
-    const rounding = new RoundingToNearestStrategy();
-
-    return Duration.Ms(rounding.round(this.internal * factor));
-  }
-
-  toAbsolute(): Duration {
-    return Duration.Ms(Math.abs(this.internal));
-  }
-}

package/src/email-mask.service.ts

@@ -1,17 +0,0 @@
-import type { EmailType } from "./email.vo";
-
-export class EmailMask {
-  static censor(email: EmailType): string {
-    const [local, domain] = email.split("@");
-
-    if (local.length <= 2) return `${"*".repeat(local.length)}@${domain}`;
-
-    const firstCharacter = local.at(0);
-    const censoredPart = "*".repeat(local.length - 2);
-    const lastCharacter = local.at(-1);
-
-    const censoredLocal = `${firstCharacter}${censoredPart}${lastCharacter}`;
-
-    return `${censoredLocal}@${domain}`;
-  }
-}

package/src/email.vo.ts

@@ -1,9 +0,0 @@
-import { z } from "zod/v4";
-
-export const EmailError = { Invalid: "email.invalid" };
-
-// Stryker disable all
-export const Email = z.email(EmailError.Invalid).brand("Email");
-// Stryker restore all
-
-export type EmailType = z.infer<typeof Email>;

package/src/etags.vo.ts

@@ -1,47 +0,0 @@
-import { RevisionValue, type RevisionValueType } from "./revision-value.vo";
-
-type ETagValueType = string;
-
-export class ETag {
-  static HEADER_NAME = "ETag";
-
-  static IF_MATCH_HEADER_NAME = "if-match";
-
-  readonly value: ETagValueType;
-
-  private constructor(readonly revision: RevisionValueType) {
-    this.value = revision.toString();
-  }
-
-  static fromHeader(value?: ETagValueType): ETag | null {
-    const candidate = Number(value);
-
-    if (Number.isNaN(candidate)) return null;
-    return new ETag(RevisionValue.parse(candidate));
-  }
-}
-
-export type WeakETagValueType = string;
-
-export const WeakETagError = { Invalid: "weak.etag.invalid" };
-
-export class WeakETag {
-  static HEADER_NAME = "ETag";
-
-  static IF_MATCH_HEADER_NAME = "if-match";
-
-  readonly value: WeakETagValueType;
-
-  private constructor(readonly revision: RevisionValueType) {
-    this.value = `W/${revision.toString()}`;
-  }
-
-  static fromHeader(value?: WeakETagValueType): WeakETag | null {
-    if (!value?.startsWith("W/")) throw new Error(WeakETagError.Invalid);
-
-    const candidate = Number(value.split("W/")[1]);
-
-    if (Number.isNaN(candidate)) return null;
-    return new WeakETag(RevisionValue.parse(candidate));
-  }
-}

package/src/extension.vo.ts

@@ -1,27 +0,0 @@
-import { z } from "zod/v4";
-
-export const ExtensionError = {
-  Type: "extension.type",
-  Empty: "extension.empty",
-  TooLong: "extension.too.long",
-  BadChars: "extension.bad.chars",
-};
-
-// Lowercase letters and digits allowed
-const EXTENSION_WHITELIST = /^[a-z0-9]+$/;
-
-const LEADING_DOT_FILE = /^\./;
-
-// Stryker disable all
-export const Extension = z
-  // Stryker restore all
-  .string(ExtensionError.Type)
-  .toLowerCase()
-  .min(2, ExtensionError.Empty)
-  .max(16, ExtensionError.TooLong)
-  // Transform ".png" -> "png"
-  .transform((value) => value.replace(LEADING_DOT_FILE, ""))
-  .refine((value) => EXTENSION_WHITELIST.test(value), ExtensionError.BadChars)
-  .brand("Extension");
-
-export type ExtensionType = z.infer<typeof Extension>;

package/src/feature-flag-value.vo.ts

@@ -1,12 +0,0 @@
-import { z } from "zod/v4";
-
-export const FeatureFlagValueError = { Invalid: "feature.flag.value.invalid" };
-
-export enum FeatureFlagEnum {
-  yes = "yes",
-  no = "no",
-}
-
-export const FeatureFlagValue = z.enum(FeatureFlagEnum, FeatureFlagValueError.Invalid);
-
-export type FeatureFlagValueType = z.infer<typeof FeatureFlagValue>;

package/src/feature-flag.vo.ts

@@ -1,11 +0,0 @@
-import { FeatureFlagEnum, type FeatureFlagValueType } from "./feature-flag-value.vo";
-
-export class FeatureFlag {
-  static isEnabled(flag: FeatureFlagValueType): boolean {
-    return flag === FeatureFlagEnum.yes;
-  }
-
-  static isDisabled(flag: FeatureFlagValueType): boolean {
-    return flag === FeatureFlagEnum.no;
-  }
-}

package/src/file-path-absolute-schema.vo.ts

@@ -1,34 +0,0 @@
-import { z } from "zod/v4";
-import { DirectoryPathAbsoluteSchema } from "./directory-path-absolute.vo";
-import { Filename } from "./filename.vo";
-
-export const FilePathAbsoluteSchemaError = {
-  Type: "file.path.absolute.type",
-  LeadingSlash: "file.path.absolute.leading.slash",
-  TrailingSlash: "file.path.absolute.trailing.slash",
-  BackslashForbidden: "file.path.absolute.backslash.forbidden",
-  Empty: "file.path.absolute.empty",
-};
-
-// Stryker disable all
-export const FilePathAbsoluteSchema = z
-  // Stryker restore all
-  .string(FilePathAbsoluteSchemaError.Type)
-  .min(1, FilePathAbsoluteSchemaError.Empty)
-  .refine((value) => value.startsWith("/"), FilePathAbsoluteSchemaError.LeadingSlash)
-  .refine((value) => !value.endsWith("/"), FilePathAbsoluteSchemaError.TrailingSlash)
-  .refine((value) => !value.includes("\\"), FilePathAbsoluteSchemaError.BackslashForbidden)
-  .transform((normalized) => {
-    const index = normalized.lastIndexOf("/");
-
-    const directoryCandidate = index === 0 ? "/" : normalized.slice(0, index);
-    const filenameCandidate = normalized.slice(index + 1);
-
-    const directory = DirectoryPathAbsoluteSchema.parse(directoryCandidate);
-    const filename = Filename.fromString(filenameCandidate);
-
-    return { directory, filename };
-  })
-  .brand("FilePathAbsoluteSchema");
-
-export type FilePathAbsoluteType = z.infer<typeof FilePathAbsoluteSchema>;

package/src/file-path-relative-schema.vo.ts

@@ -1,34 +0,0 @@
-import { z } from "zod/v4";
-import { DirectoryPathRelativeSchema } from "./directory-path-relative.vo";
-import { Filename } from "./filename.vo";
-
-export const FilePathRelativeSchemaError = {
-  Type: "file.path.relative.type",
-  LeadingSlash: "file.path.relative.leading.slash",
-  BackslashForbidden: "file.path.relative.backslash.forbidden",
-  RequiresDirectory: "file.path.relative.requires.directory",
-  Empty: "file.path.relative.empty",
-};
-
-// Stryker disable all
-export const FilePathRelativeSchema = z
-  // Stryker restore all
-  .string(FilePathRelativeSchemaError.Type)
-  .min(1, FilePathRelativeSchemaError.Empty)
-  .refine((value) => !value.startsWith("/"), FilePathRelativeSchemaError.LeadingSlash)
-  .refine((value) => !value.includes("\\"), FilePathRelativeSchemaError.BackslashForbidden)
-  .refine((value) => value.includes("/"), FilePathRelativeSchemaError.RequiresDirectory)
-  .transform((normalized) => {
-    const lastSlashIndex = normalized.lastIndexOf("/");
-
-    const directoryCandidate = normalized.slice(0, lastSlashIndex);
-    const filenameCandidate = normalized.slice(lastSlashIndex + 1);
-
-    const directory = DirectoryPathRelativeSchema.parse(directoryCandidate);
-    const filename = Filename.fromString(filenameCandidate);
-
-    return { directory, filename };
-  })
-  .brand("FilePathRelativeSchema");
-
-export type FilePathRelativeType = z.infer<typeof FilePathRelativeSchema>;

package/src/file-path.vo.ts

@@ -1,100 +0,0 @@
-import { DirectoryPathAbsoluteSchema, type DirectoryPathAbsoluteType } from "./directory-path-absolute.vo";
-import { DirectoryPathRelativeSchema, type DirectoryPathRelativeType } from "./directory-path-relative.vo";
-import { FilePathAbsoluteSchema } from "./file-path-absolute-schema.vo";
-import { FilePathRelativeSchema } from "./file-path-relative-schema.vo";
-import type { Filename } from "./filename.vo";
-
-export class FilePathRelative {
-  private constructor(
-    private readonly directory: DirectoryPathRelativeType,
-    private readonly filename: Filename,
-  ) {}
-
-  static fromParts(directoryCandidate: string, filename: Filename): FilePathRelative {
-    const directory = DirectoryPathRelativeSchema.parse(directoryCandidate);
-
-    return new FilePathRelative(directory, filename);
-  }
-
-  static fromPartsSafe(directory: DirectoryPathRelativeType, filename: Filename): FilePathRelative {
-    return new FilePathRelative(directory, filename);
-  }
-
-  static fromString(candidate: string): FilePathRelative {
-    const schema = FilePathRelativeSchema.parse(candidate);
-
-    return new FilePathRelative(schema.directory, schema.filename);
-  }
-
-  get(): string {
-    return `${this.directory}/${this.filename.get()}`;
-  }
-
-  getDirectory(): DirectoryPathRelativeType {
-    return this.directory;
-  }
-
-  getFilename(): Filename {
-    return this.filename;
-  }
-
-  withDirectory(newDirectory: DirectoryPathRelativeType): FilePathRelative {
-    return new FilePathRelative(newDirectory, this.filename);
-  }
-
-  withFilename(newFilename: Filename): FilePathRelative {
-    return new FilePathRelative(this.directory, newFilename);
-  }
-
-  toAbsolute(newDirectory: DirectoryPathAbsoluteType): FilePathAbsolute {
-    return FilePathAbsolute.fromPartsSafe(newDirectory, this.filename);
-  }
-}
-
-export class FilePathAbsolute {
-  private constructor(
-    private readonly directory: DirectoryPathAbsoluteType,
-    private readonly filename: Filename,
-  ) {}
-
-  static fromParts(directoryCandidate: string, filename: Filename): FilePathAbsolute {
-    const directory = DirectoryPathAbsoluteSchema.parse(directoryCandidate);
-
-    return new FilePathAbsolute(directory, filename);
-  }
-
-  static fromPartsSafe(directory: DirectoryPathAbsoluteType, filename: Filename): FilePathAbsolute {
-    return new FilePathAbsolute(directory, filename);
-  }
-
-  static fromString(candidate: string): FilePathAbsolute {
-    const schema = FilePathAbsoluteSchema.parse(candidate);
-
-    return new FilePathAbsolute(schema.directory, schema.filename);
-  }
-
-  get(): string {
-    if (this.directory === "/") return `/${this.filename.get()}`;
-    return `${this.directory}/${this.filename.get()}`;
-  }
-
-  getDirectory(): DirectoryPathAbsoluteType {
-    return this.directory;
-  }
-
-  getFilename(): Filename {
-    return this.filename;
-  }
-
-  withDirectory(newDirectory: DirectoryPathAbsoluteType): FilePathAbsolute {
-    return new FilePathAbsolute(newDirectory, this.filename);
-  }
-
-  withFilename(newFilename: Filename): FilePathAbsolute {
-    return new FilePathAbsolute(this.directory, newFilename);
-  }
-
-  toRelative(newDirectory: DirectoryPathRelativeType): FilePathRelative {
-    return FilePathRelative.fromPartsSafe(newDirectory, this.filename);
-  }
-}

package/src/filename-affix.vo.ts

@@ -1,27 +0,0 @@
-import { z } from "zod/v4";
-
-export enum FilenameAffixStrategy {
-  prefix = "prefix",
-  suffix = "suffix",
-}
-
-export const FilenameAffixError = {
-  Type: "affix.type",
-  Empty: "affix.empty",
-  TooLong: "affix.too.long",
-  BadChars: "affix.bad.chars",
-};
-
-// Letters, digits, underscores, and hyphens allowed
-const FILENAME_AFFIX_WHITELIST = /^[a-zA-Z0-9_-]+$/;
-
-// Stryker disable all
-export const FilenameAffix = z
-  // Stryker restore all
-  .string(FilenameAffixError.Type)
-  .min(1, FilenameAffixError.Empty)
-  .max(32, FilenameAffixError.TooLong)
-  .regex(FILENAME_AFFIX_WHITELIST, FilenameAffixError.BadChars)
-  .brand("FilenameAffix");
-
-export type FilenameAffixType = z.infer<typeof FilenameAffix>;

package/src/filename-from-string.vo.ts

@@ -1,27 +0,0 @@
-import { z } from "zod/v4";
-import { Basename } from "./basename.vo";
-import { Extension } from "./extension.vo";
-
-export const FilenameFromStringError = {
-  Type: "filename.from.string.type",
-  Invalid: "filename.from.string.invalid",
-};
-
-// .+ at least one character, advances to the last dot
-// .
-// .+ at least one character
-const DOT_WITH_SIDES = /^.+\..+$/;
-
-export const FilenameFromString = z
-  .string(FilenameFromStringError.Type)
-  .regex(DOT_WITH_SIDES, FilenameFromStringError.Invalid)
-  .transform((value) => {
-    const index = value.lastIndexOf(".");
-
-    const basename = Basename.parse(value.slice(0, index));
-    const extension = Extension.parse(value.slice(index + 1));
-
-    return { basename, extension };
-  });
-
-export type FilenameFromStringType = z.infer<typeof FilenameFromString>;