@bgord/tools 0.12.14 → 0.12.16

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

@@ -1,29 +1,31 @@
 import { type DirectoryPathAbsoluteType } from "./directory-path-absolute.vo";
 import { type DirectoryPathRelativeType } from "./directory-path-relative.vo";
 import type { Filename } from "./filename.vo";
-export declare class RelativeFilePath {
+export declare class FilePathRelative {
     private readonly directory;
     private readonly filename;
     private constructor();
-    static fromParts(directoryCandidate: string, filename: Filename): RelativeFilePath;
-    static fromPartsSafe(directory: DirectoryPathRelativeType, filename: Filename): RelativeFilePath;
+    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;
-    withDirectoryRelative(newDirectory: DirectoryPathRelativeType): RelativeFilePath;
-    withFilename(newFilename: Filename): RelativeFilePath;
-    toAbsolute(newDirectory: DirectoryPathAbsoluteType): AbsoluteFilePath;
+    withDirectoryRelative(newDirectory: DirectoryPathRelativeType): FilePathRelative;
+    withFilename(newFilename: Filename): FilePathRelative;
+    toAbsolute(newDirectory: DirectoryPathAbsoluteType): FilePathAbsolute;
 }
-export declare class AbsoluteFilePath {
+export declare class FilePathAbsolute {
     private readonly directory;
     private readonly filename;
     private constructor();
-    static fromParts(directoryCandidate: string, filename: Filename): AbsoluteFilePath;
-    static fromPartsSafe(directory: DirectoryPathAbsoluteType, filename: Filename): AbsoluteFilePath;
+    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;
-    withDirectoryAbsolute(newDirectory: DirectoryPathAbsoluteType): AbsoluteFilePath;
-    withFilename(newFilename: Filename): AbsoluteFilePath;
-    toRelative(newDirectory: DirectoryPathRelativeType): RelativeFilePath;
+    withDirectoryAbsolute(newDirectory: DirectoryPathAbsoluteType): FilePathAbsolute;
+    withFilename(newFilename: Filename): FilePathAbsolute;
+    toRelative(newDirectory: DirectoryPathRelativeType): FilePathRelative;
 }

package/dist/file-path.vo.js

@@ -1,6 +1,8 @@
 import { DirectoryPathAbsoluteSchema } from "./directory-path-absolute.vo";
 import { DirectoryPathRelativeSchema } from "./directory-path-relative.vo";
-export class RelativeFilePath {
+import { FilePathAbsoluteSchema } from "./file-path-absolute-schema.vo";
+import { FilePathRelativeSchema } from "./file-path-relative-schema.vo";
+export class FilePathRelative {
     directory;
     filename;
     constructor(directory, filename) {
@@ -9,10 +11,14 @@ export class RelativeFilePath {
     }
     static fromParts(directoryCandidate, filename) {
         const directory = DirectoryPathRelativeSchema.parse(directoryCandidate);
-        return new RelativeFilePath(directory, filename);
+        return new FilePathRelative(directory, filename);
     }
     static fromPartsSafe(directory, filename) {
-        return new RelativeFilePath(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()}`;
@@ -24,16 +30,16 @@ export class RelativeFilePath {
         return this.filename;
     }
     withDirectoryRelative(newDirectory) {
-        return new RelativeFilePath(newDirectory, this.filename);
+        return new FilePathRelative(newDirectory, this.filename);
     }
     withFilename(newFilename) {
-        return new RelativeFilePath(this.directory, newFilename);
+        return new FilePathRelative(this.directory, newFilename);
     }
     toAbsolute(newDirectory) {
-        return AbsoluteFilePath.fromPartsSafe(newDirectory, this.filename);
+        return FilePathAbsolute.fromPartsSafe(newDirectory, this.filename);
     }
 }
-export class AbsoluteFilePath {
+export class FilePathAbsolute {
     directory;
     filename;
     constructor(directory, filename) {
@@ -42,10 +48,14 @@ export class AbsoluteFilePath {
     }
     static fromParts(directoryCandidate, filename) {
         const directory = DirectoryPathAbsoluteSchema.parse(directoryCandidate);
-        return new AbsoluteFilePath(directory, filename);
+        return new FilePathAbsolute(directory, filename);
     }
     static fromPartsSafe(directory, filename) {
-        return new AbsoluteFilePath(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 === "/")
@@ -59,12 +69,12 @@ export class AbsoluteFilePath {
         return this.filename;
     }
     withDirectoryAbsolute(newDirectory) {
-        return new AbsoluteFilePath(newDirectory, this.filename);
+        return new FilePathAbsolute(newDirectory, this.filename);
     }
     withFilename(newFilename) {
-        return new AbsoluteFilePath(this.directory, newFilename);
+        return new FilePathAbsolute(this.directory, newFilename);
     }
     toRelative(newDirectory) {
-        return RelativeFilePath.fromPartsSafe(newDirectory, this.filename);
+        return FilePathRelative.fromPartsSafe(newDirectory, this.filename);
     }
 }

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

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,8 +1,10 @@
 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 RelativeFilePath {
+export class FilePathRelative {
   private constructor(
     private readonly directory: DirectoryPathRelativeType,
     private readonly filename: Filename,
@@ -10,11 +12,16 @@ export class RelativeFilePath {
 
   static fromParts(directoryCandidate: string, filename: Filename) {
     const directory = DirectoryPathRelativeSchema.parse(directoryCandidate);
-    return new RelativeFilePath(directory, filename);
+    return new FilePathRelative(directory, filename);
   }
 
   static fromPartsSafe(directory: DirectoryPathRelativeType, filename: Filename) {
-    return new RelativeFilePath(directory, filename);
+    return new FilePathRelative(directory, filename);
+  }
+
+  static fromString(pathCandidate: string): FilePathRelative {
+    const { directory, filename } = FilePathRelativeSchema.parse(pathCandidate);
+    return new FilePathRelative(directory, filename);
   }
 
   get() {
@@ -29,20 +36,20 @@ export class RelativeFilePath {
     return this.filename;
   }
 
-  withDirectoryRelative(newDirectory: DirectoryPathRelativeType): RelativeFilePath {
-    return new RelativeFilePath(newDirectory, this.filename);
+  withDirectoryRelative(newDirectory: DirectoryPathRelativeType): FilePathRelative {
+    return new FilePathRelative(newDirectory, this.filename);
   }
 
-  withFilename(newFilename: Filename): RelativeFilePath {
-    return new RelativeFilePath(this.directory, newFilename);
+  withFilename(newFilename: Filename): FilePathRelative {
+    return new FilePathRelative(this.directory, newFilename);
   }
 
-  toAbsolute(newDirectory: DirectoryPathAbsoluteType): AbsoluteFilePath {
-    return AbsoluteFilePath.fromPartsSafe(newDirectory, this.filename);
+  toAbsolute(newDirectory: DirectoryPathAbsoluteType): FilePathAbsolute {
+    return FilePathAbsolute.fromPartsSafe(newDirectory, this.filename);
   }
 }
 
-export class AbsoluteFilePath {
+export class FilePathAbsolute {
   private constructor(
     private readonly directory: DirectoryPathAbsoluteType,
     private readonly filename: Filename,
@@ -50,11 +57,16 @@ export class AbsoluteFilePath {
 
   static fromParts(directoryCandidate: string, filename: Filename) {
     const directory = DirectoryPathAbsoluteSchema.parse(directoryCandidate);
-    return new AbsoluteFilePath(directory, filename);
+    return new FilePathAbsolute(directory, filename);
   }
 
   static fromPartsSafe(directory: DirectoryPathAbsoluteType, filename: Filename) {
-    return new AbsoluteFilePath(directory, filename);
+    return new FilePathAbsolute(directory, filename);
+  }
+
+  static fromString(pathCandidate: string): FilePathAbsolute {
+    const { directory, filename } = FilePathAbsoluteSchema.parse(pathCandidate);
+    return new FilePathAbsolute(directory, filename);
   }
 
   get() {
@@ -70,15 +82,15 @@ export class AbsoluteFilePath {
     return this.filename;
   }
 
-  withDirectoryAbsolute(newDirectory: DirectoryPathAbsoluteType): AbsoluteFilePath {
-    return new AbsoluteFilePath(newDirectory, this.filename);
+  withDirectoryAbsolute(newDirectory: DirectoryPathAbsoluteType): FilePathAbsolute {
+    return new FilePathAbsolute(newDirectory, this.filename);
   }
 
-  withFilename(newFilename: Filename): AbsoluteFilePath {
-    return new AbsoluteFilePath(this.directory, newFilename);
+  withFilename(newFilename: Filename): FilePathAbsolute {
+    return new FilePathAbsolute(this.directory, newFilename);
   }
 
-  toRelative(newDirectory: DirectoryPathRelativeType): RelativeFilePath {
-    return RelativeFilePath.fromPartsSafe(newDirectory, this.filename);
+  toRelative(newDirectory: DirectoryPathRelativeType): FilePathRelative {
+    return FilePathRelative.fromPartsSafe(newDirectory, this.filename);
   }
 }

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