@bgord/tools 0.12.15 → 0.12.17

package/dist/file-path-absolute-schema.vo.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod/v4";
+import { Filename } from "./filename.vo";
+export declare const FilePathAbsoluteSchema: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodTransform<string, string>>, z.ZodTransform<{
+    directory: string & z.core.$brand<"absolute_directory_path">;
+    filename: Filename;
+}, string>>;

package/dist/file-path-absolute-schema.vo.js

@@ -0,0 +1,19 @@
+import { z } from "zod/v4";
+import { DirectoryPathAbsoluteSchema } from "./directory-path-absolute.vo";
+import { Filename } from "./filename.vo";
+export const FilePathAbsoluteSchema = z
+    .string()
+    .trim()
+    .refine((value) => value.startsWith("/"), "abs_file_path_must_start_with_slash")
+    .refine((value) => !value.includes("\\"), "abs_file_path_backslash_forbidden")
+    .transform((value) => value.replace(/\/{2,}/g, "/")) // collapse //
+    .transform((value) => (value !== "/" && value.endsWith("/") ? value.slice(0, -1) : value)) // keep "/" as-is
+    .refine((value) => value !== "/", "abs_file_path_missing_filename")
+    .transform((normalized) => {
+    const lastSlashIndex = normalized.lastIndexOf("/");
+    const directoryCandidate = lastSlashIndex === 0 ? "/" : normalized.slice(0, lastSlashIndex);
+    const filenameCandidate = normalized.slice(lastSlashIndex + 1);
+    const directory = DirectoryPathAbsoluteSchema.parse(directoryCandidate);
+    const filename = Filename.fromString(filenameCandidate);
+    return { directory, filename };
+});

package/dist/file-path-relative-schema.vo.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod/v4";
+import { Filename } from "./filename.vo";
+export declare const FilePathRelativeSchema: z.ZodPipe<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodTransform<string, string>>, z.ZodTransform<{
+    directory: string & z.core.$brand<"relative_directory_path">;
+    filename: Filename;
+}, string>>;

package/dist/file-path-relative-schema.vo.js

@@ -0,0 +1,19 @@
+import { z } from "zod/v4";
+import { DirectoryPathRelativeSchema } from "./directory-path-relative.vo";
+import { Filename } from "./filename.vo";
+export const FilePathRelativeSchema = z
+    .string()
+    .trim()
+    .refine((value) => !value.startsWith("/"), "rel_file_path_must_not_start_with_slash")
+    .refine((value) => !value.includes("\\"), "rel_file_path_backslash_forbidden")
+    .transform((value) => value.replace(/\/{2,}/g, "/")) // collapse //
+    .transform((value) => value.replace(/^\/+|\/+$/g, "")) // trim leading/trailing slashes
+    .refine((value) => value.includes("/"), "rel_file_path_requires_directory")
+    .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 };
+});

package/dist/file-path.vo.d.ts

@@ -7,6 +7,7 @@ export declare class FilePathRelative {
     private constructor();
     static fromParts(directoryCandidate: string, filename: Filename): FilePathRelative;
     static fromPartsSafe(directory: DirectoryPathRelativeType, filename: Filename): FilePathRelative;
+    static fromString(pathCandidate: string): FilePathRelative;
     get(): string;
     getDirectory(): DirectoryPathRelativeType;
     getFilename(): Filename;
@@ -20,6 +21,7 @@ export declare class FilePathAbsolute {
     private constructor();
     static fromParts(directoryCandidate: string, filename: Filename): FilePathAbsolute;
     static fromPartsSafe(directory: DirectoryPathAbsoluteType, filename: Filename): FilePathAbsolute;
+    static fromString(pathCandidate: string): FilePathAbsolute;
     get(): string;
     getDirectory(): DirectoryPathAbsoluteType;
     getFilename(): Filename;

package/dist/file-path.vo.js

@@ -1,5 +1,7 @@
 import { DirectoryPathAbsoluteSchema } from "./directory-path-absolute.vo";
 import { DirectoryPathRelativeSchema } from "./directory-path-relative.vo";
+import { FilePathAbsoluteSchema } from "./file-path-absolute-schema.vo";
+import { FilePathRelativeSchema } from "./file-path-relative-schema.vo";
 export class FilePathRelative {
     directory;
     filename;
@@ -14,6 +16,10 @@ export class FilePathRelative {
     static fromPartsSafe(directory, filename) {
         return new FilePathRelative(directory, filename);
     }
+    static fromString(pathCandidate) {
+        const { directory, filename } = FilePathRelativeSchema.parse(pathCandidate);
+        return new FilePathRelative(directory, filename);
+    }
     get() {
         return `${this.directory}/${this.filename.get()}`;
     }
@@ -47,6 +53,10 @@ export class FilePathAbsolute {
     static fromPartsSafe(directory, filename) {
         return new FilePathAbsolute(directory, filename);
     }
+    static fromString(pathCandidate) {
+        const { directory, filename } = FilePathAbsoluteSchema.parse(pathCandidate);
+        return new FilePathAbsolute(directory, filename);
+    }
     get() {
         if (this.directory === "/")
             return `/${this.filename.get()}`;

package/dist/index.d.ts

@@ -16,6 +16,8 @@ export * from "./etags.vo";
 export * from "./extension.vo";
 export * from "./feature-flag.vo";
 export * from "./file-path.vo";
+export * from "./file-path-absolute-schema.vo";
+export * from "./file-path-relative-schema.vo";
 export * from "./filename.vo";
 export * from "./filename-from-string.vo";
 export * from "./filename-suffix.vo";

package/dist/index.js

@@ -16,6 +16,8 @@ export * from "./etags.vo";
 export * from "./extension.vo";
 export * from "./feature-flag.vo";
 export * from "./file-path.vo";
+export * from "./file-path-absolute-schema.vo";
+export * from "./file-path-relative-schema.vo";
 export * from "./filename.vo";
 export * from "./filename-from-string.vo";
 export * from "./filename-suffix.vo";

package/dist/mime.vo.d.ts

@@ -7,6 +7,7 @@ export declare class Mime {
     readonly type: MimeTypeType;
     readonly subtype: MimeSubtypeType;
     constructor(value: MimeRawType);
+    static fromExtension(extension: ExtensionType): Mime;
     isSatisfiedBy(another: Mime): boolean;
     toExtension(): ExtensionType;
 }

package/dist/mime.vo.js

@@ -1,3 +1,4 @@
+import * as mime from "mime-types";
 import { ExtensionSchema } from "./extension.vo";
 export class Mime {
     raw;
@@ -15,6 +16,9 @@ export class Mime {
         this.type = type;
         this.subtype = subtype;
     }
+    static fromExtension(extension) {
+        return new Mime(String(mime.contentType(extension)));
+    }
     isSatisfiedBy(another) {
         if (this.raw === another.raw)
             return true;
@@ -24,7 +28,7 @@ export class Mime {
         return this.subtype === another.subtype || this.subtype === "*";
     }
     toExtension() {
-        return ExtensionSchema.parse(this.subtype);
+        return ExtensionSchema.parse(mime.extension(this.raw));
     }
 }
 export class InvalidMimeError extends Error {

package/dist/size.vo.d.ts

@@ -19,6 +19,10 @@ export declare class Size {
     private static readonly MB_MULTIPLIER;
     private static readonly GB_MULTIPLIER;
     constructor(config: SizeConfigType);
+    static fromBytes(candidate: number): Size;
+    static fromKb(candidate: number): Size;
+    static fromMB(candidate: number): Size;
+    static fromGB(candidate: number): Size;
     toString(): string;
     toBytes(): SizeValueType;
     isGreaterThan(another: Size): boolean;

package/dist/size.vo.js

@@ -20,6 +20,22 @@ export class Size {
         this.value = SizeValue.parse(config.value);
         this.bytes = this.calculateBytes();
     }
+    static fromBytes(candidate) {
+        const value = SizeValue.parse(candidate);
+        return new Size({ value, unit: SizeUnit.b });
+    }
+    static fromKb(candidate) {
+        const value = SizeValue.parse(candidate);
+        return new Size({ value, unit: SizeUnit.kB });
+    }
+    static fromMB(candidate) {
+        const value = SizeValue.parse(candidate);
+        return new Size({ value, unit: SizeUnit.MB });
+    }
+    static fromGB(candidate) {
+        const value = SizeValue.parse(candidate);
+        return new Size({ value, unit: SizeUnit.GB });
+    }
     toString() {
         return `${this.value} ${this.unit}`;
     }

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/api-key.vo.ts","../src/basename.vo.ts","../src/build-version.vo.ts","../src/clock.vo.ts","../src/date-calculator.service.ts","../src/date-formatter.service.ts","../src/date-range.vo.ts","../src/dates-of-the-week.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/dll.service.ts","../src/email-mask.service.ts","../src/etags.vo.ts","../src/extension.vo.ts","../src/feature-flag.vo.ts","../src/file-path.vo.ts","../src/filename-from-string.vo.ts","../src/filename-suffix.vo.ts","../src/filename.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/notification-template.vo.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/week-iso-id.vo.ts","../src/week.vo.ts","../src/z-score.service.ts"],"version":"5.9.2"}
+{"root":["../src/api-key.vo.ts","../src/basename.vo.ts","../src/build-version.vo.ts","../src/clock.vo.ts","../src/date-calculator.service.ts","../src/date-formatter.service.ts","../src/date-range.vo.ts","../src/dates-of-the-week.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/dll.service.ts","../src/email-mask.service.ts","../src/etags.vo.ts","../src/extension.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-from-string.vo.ts","../src/filename-suffix.vo.ts","../src/filename.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/notification-template.vo.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/week-iso-id.vo.ts","../src/week.vo.ts","../src/z-score.service.ts"],"version":"5.9.2"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bgord/tools",
-  "version": "0.12.15",
+  "version": "0.12.17",
   "type": "module",
   "license": "MIT",
   "author": "Bartosz Gordon",
@@ -24,20 +24,22 @@
     "@biomejs/biome": "2.2.2",
     "@commitlint/cli": "19.8.1",
     "@commitlint/config-conventional": "19.8.1",
-    "@types/bun": "1.2.20",
+    "@types/bun": "1.2.21",
+    "@types/mime-types": "^3.0.1",
     "cspell": "9.2.0",
     "knip": "5.63.0",
     "lefthook": "1.12.3",
     "only-allow": "1.2.1",
     "shellcheck": "4.1.0",
     "typescript": "5.9.2",
-    "zod": "4.1.1"
+    "zod": "4.1.3"
   },
   "dependencies": {
-    "date-fns": "4.1.0"
+    "date-fns": "4.1.0",
+    "mime-types": "^3.0.1"
   },
   "peerDependencies": {
-    "zod": "4.1.1"
+    "zod": "4.1.3"
   },
   "sideEffects": false
 }

package/readme.md

@@ -41,6 +41,8 @@ src/
 ├── etags.vo.ts
 ├── extension.vo.ts
 ├── feature-flag.vo.ts
+├── file-path-absolute-schema.vo.ts
+├── file-path-relative-schema.vo.ts
 ├── file-path.vo.ts
 ├── filename-from-string.vo.ts
 ├── filename-suffix.vo.ts

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

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+import { DirectoryPathAbsoluteSchema } from "./directory-path-absolute.vo";
+import { Filename } from "./filename.vo";
+
+export const FilePathAbsoluteSchema = z
+  .string()
+  .trim()
+  .refine((value) => value.startsWith("/"), "abs_file_path_must_start_with_slash")
+  .refine((value) => !value.includes("\\"), "abs_file_path_backslash_forbidden")
+  .transform((value) => value.replace(/\/{2,}/g, "/")) // collapse //
+  .transform((value) => (value !== "/" && value.endsWith("/") ? value.slice(0, -1) : value)) // keep "/" as-is
+  .refine((value) => value !== "/", "abs_file_path_missing_filename")
+  .transform((normalized) => {
+    const lastSlashIndex = normalized.lastIndexOf("/");
+    const directoryCandidate = lastSlashIndex === 0 ? "/" : normalized.slice(0, lastSlashIndex);
+    const filenameCandidate = normalized.slice(lastSlashIndex + 1);
+
+    const directory = DirectoryPathAbsoluteSchema.parse(directoryCandidate);
+    const filename = Filename.fromString(filenameCandidate);
+
+    return { directory, filename };
+  });

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

@@ -0,0 +1,22 @@
+import { z } from "zod/v4";
+import { DirectoryPathRelativeSchema } from "./directory-path-relative.vo";
+import { Filename } from "./filename.vo";
+
+export const FilePathRelativeSchema = z
+  .string()
+  .trim()
+  .refine((value) => !value.startsWith("/"), "rel_file_path_must_not_start_with_slash")
+  .refine((value) => !value.includes("\\"), "rel_file_path_backslash_forbidden")
+  .transform((value) => value.replace(/\/{2,}/g, "/")) // collapse //
+  .transform((value) => value.replace(/^\/+|\/+$/g, "")) // trim leading/trailing slashes
+  .refine((value) => value.includes("/"), "rel_file_path_requires_directory")
+  .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 };
+  });

package/src/file-path.vo.ts

@@ -1,5 +1,7 @@
 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 {
@@ -17,6 +19,11 @@ export class FilePathRelative {
     return new FilePathRelative(directory, filename);
   }
 
+  static fromString(pathCandidate: string): FilePathRelative {
+    const { directory, filename } = FilePathRelativeSchema.parse(pathCandidate);
+    return new FilePathRelative(directory, filename);
+  }
+
   get() {
     return `${this.directory}/${this.filename.get()}`;
   }
@@ -57,6 +64,11 @@ export class FilePathAbsolute {
     return new FilePathAbsolute(directory, filename);
   }
 
+  static fromString(pathCandidate: string): FilePathAbsolute {
+    const { directory, filename } = FilePathAbsoluteSchema.parse(pathCandidate);
+    return new FilePathAbsolute(directory, filename);
+  }
+
   get() {
     if (this.directory === ("/" as DirectoryPathAbsoluteType)) return `/${this.filename.get()}`;
     return `${this.directory}/${this.filename.get()}`;

package/src/index.ts

@@ -16,6 +16,8 @@ export * from "./etags.vo";
 export * from "./extension.vo";
 export * from "./feature-flag.vo";
 export * from "./file-path.vo";
+export * from "./file-path-absolute-schema.vo";
+export * from "./file-path-relative-schema.vo";
 export * from "./filename.vo";
 export * from "./filename-from-string.vo";
 export * from "./filename-suffix.vo";

package/src/mime.vo.ts

@@ -1,3 +1,4 @@
+import * as mime from "mime-types";
 import { ExtensionSchema, type ExtensionType } from "./extension.vo";
 
 export type MimeRawType = string;
@@ -27,6 +28,10 @@ export class Mime {
     this.subtype = subtype;
   }
 
+  static fromExtension(extension: ExtensionType): Mime {
+    return new Mime(String(mime.contentType(extension)));
+  }
+
   isSatisfiedBy(another: Mime): boolean {
     if (this.raw === another.raw) return true;
 
@@ -37,7 +42,7 @@ export class Mime {
   }
 
   toExtension(): ExtensionType {
-    return ExtensionSchema.parse(this.subtype);
+    return ExtensionSchema.parse(mime.extension(this.raw));
   }
 }
 

package/src/size.vo.ts

@@ -33,6 +33,26 @@ export class Size {
     this.bytes = this.calculateBytes();
   }
 
+  static fromBytes(candidate: number): Size {
+    const value = SizeValue.parse(candidate);
+    return new Size({ value, unit: SizeUnit.b });
+  }
+
+  static fromKb(candidate: number): Size {
+    const value = SizeValue.parse(candidate);
+    return new Size({ value, unit: SizeUnit.kB });
+  }
+
+  static fromMB(candidate: number): Size {
+    const value = SizeValue.parse(candidate);
+    return new Size({ value, unit: SizeUnit.MB });
+  }
+
+  static fromGB(candidate: number): Size {
+    const value = SizeValue.parse(candidate);
+    return new Size({ value, unit: SizeUnit.GB });
+  }
+
   toString(): string {
     return `${this.value} ${this.unit}`;
   }