@bgord/tools 0.12.15 → 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

@@ -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/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.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,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";